Skip to content

Commit 7b1f610

Browse files
Deliver standalone Brotli CVE-2026-111497 inventory checker
0 parents  commit 7b1f610

38 files changed

Lines changed: 2255 additions & 0 deletions

‎.gitattributes‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
* text=auto
2+
*.py text eol=lf
3+
*.md text eol=lf
4+
*.yml text eol=lf
5+
*.png binary

‎.github/workflows/tests.yml‎

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
name: Tests
2+
on: [push, pull_request, workflow_dispatch]
3+
permissions:
4+
contents: read
5+
jobs:
6+
test:
7+
name: Python ${{ matrix.python }} on ${{ matrix.os }}
8+
runs-on: ${{ matrix.os }}
9+
timeout-minutes: 10
10+
strategy:
11+
fail-fast: false
12+
matrix:
13+
os: [ubuntu-latest, windows-latest, macos-latest]
14+
python: ['3.10', '3.14']
15+
steps:
16+
- uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
17+
with:
18+
persist-credentials: false
19+
- uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
20+
with:
21+
python-version: ${{ matrix.python }}
22+
- run: python -m unittest -v
23+
- run: python http2shell_check.py --help
24+
- run: python http2shell_check.py --inventory examples/inventory.json --format json
25+
- run: git diff --check
26+
collector:
27+
name: Optional Python metadata collector
28+
runs-on: ubuntu-latest
29+
steps:
30+
- uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
31+
with:
32+
persist-credentials: false
33+
- uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
34+
with:
35+
python-version: '3.14'
36+
- run: python collect_python.py > runtime.json
37+
- run: python http2shell_check.py --inventory runtime.json --format json

‎.gitignore‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
__pycache__/
2+
*.pyc
3+
.venv/
4+
runtime.json
5+
runtime-assessment.json
6+
report.*
7+
private/
8+
.http2shell-*
9+
CONCURRENT_SESSION_HANDOFF.md

‎AGENTS.md‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# Repository instructions
2+
3+
Read README.md, CONTRIBUTING.md, SECURITY.md and docs/SOURCES.md before changes.
4+
Keep http2shell_check.py standalone on Python 3.10+ with standard-library-only runtime and tests.
5+
6+
Scope is CVE-2026-111497 only. HTTP2Shell, Node2Shell and Brotli RCE are aliases of this decoder flaw. No network scanning, decoder imports, exploit payloads, subprocess collection, installation hooks, or automatic rule updates belong in the checker.
7+
8+
Preserve vendor/backport uncertainty, strict package identity, independent component copies, evidence origin, system/bundled distinctions, and unknown coverage. Exploitability stays not_tested. A fixed version is not verified patch state. Declared dependencies do not prove installed code. Configuration and mitigation do not override patch classification.
9+
10+
Update rules, source matrix, methodology and meaningful boundary tests together after live primary-source verification. Preserve bounded parsing, escaping, CSV safety, atomic output, protected input paths and interruption receipts. Keep real inventories, target data and secrets outside Git. Collectors read metadata only.
11+
12+
Run python -m unittest -v, CLI examples/help, and git diff --check. Tests use synthetic inputs only. Review actual rendered HTML after visual changes. Verify hosted CI on the published commit and distinguish local validation from CI and deployment.
13+
14+
The agent skill must invoke the real CLI, locate it separately after installation, and preserve authorization boundaries. CLAUDE.md is a pointer here. Respect LICENSING.md and BRAND_ASSETS.md.

‎BRAND_ASSETS.md‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
# Brand assets
2+
3+
CompleteTech LLC names, logos, and brand assets included in this repository,
4+
including `assets/logo.png` and the images in `docs/images/`, are not licensed
5+
under the AGPL-3.0 or a commercial code license.
6+
7+
They remain trademarks, service marks, or brand assets of CompleteTech LLC and
8+
may not be reused in a way that suggests endorsement, affiliation, sponsorship,
9+
or ownership without written permission.
10+
11+
Use `--brand` and `--logo` to supply your organization's own identity in reports.

‎CHANGELOG.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Changelog
2+
3+
## 1.0.0 — 2026-10-25
4+
5+
Initial offline Brotli/CVE-2026-111497 assessment across verified native, runtime, Python, Java, proxy, mesh and exact Debian source-package rules. Canonical inventory, pip-list and Node collector adapters; metadata-only Python collector; JSON/CSV/offline HTML; bounded parsing, conservative provenance, output protection and interruption handling. Embedded source snapshot dated 2026-10-25. No exploitability or deployment claims.

‎CLAUDE.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
Read and follow [AGENTS.md](AGENTS.md).

‎CONTRIBUTING.md‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# Contributing
2+
3+
Open a focused issue and pull request. Report sensitive checker flaws through [SECURITY.md](SECURITY.md). Python 3.10+ suffices; no third-party runtime or test dependencies are needed.
4+
5+
```sh
6+
python -m unittest -v
7+
python http2shell_check.py --help
8+
git diff --check
9+
```
10+
11+
Keep the single-file checker offline and source-backed. Add meaningful behavior tests for affected/fixed boundaries, identities, vendor uncertainty and output protections. Use synthetic inventories and mocks; do not run real target scans or import native decoders. Do not add tests that merely assert prose. Update CLI/schema documentation with implementation changes. Keep private assessment data out of commits.
12+
13+
## Licensing of contributions
14+
15+
By submitting a contribution, you confirm you have the right to submit it. You license it to the public under AGPL-3.0 and grant CompleteTech LLC a perpetual, worldwide, royalty-free, irrevocable license to use, modify, sublicense, and distribute it under any license, including a commercial license. You retain copyright in your contribution. See [LICENSING.md](LICENSING.md).

0 commit comments

Comments
 (0)