You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit e6d6c01
Browse filesBrowse the repository at this point in the historyBrowse files
Align README license wording with LICENSING.md; tighten details
Address review: AGPL option is not limited to non-commercial use, name the
--fail-on-finding triggers, note robots gating and downgrade stop, widen the
unknown row, and crop screenshots below the fix table.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
python node2shell_check.py --input websites.txt --format html --output websites-report.html
31
31
```
32
32
33
-
Python 3.10+ on Windows, macOS, or Linux. Nothing to install. Node.js is needed only to run the optional collector.
33
+
Python 3.10+ on Windows, macOS, or Linux. Nothing to install; use `python3` where `python` is not Python 3. Node.js is needed only to run the optional collector.
34
34
35
35
## The report
36
36
37
-
`--format html` produces a single offline, script-free file with your logo, summary tiles, every result with its evidence and next step, and the upstream fix table. It follows the reader's light or dark theme and prints cleanly.
37
+
`--format html` produces a single offline, script-free file with a logo, summary tiles, every result with its evidence and next step, and the upstream fix table. It follows the reader's light or dark theme and prints cleanly.
38
38
39
39
<palign="center">
40
40
<picture>
@@ -45,7 +45,7 @@ Python 3.10+ on Windows, macOS, or Linux. Nothing to install. Node.js is needed
45
45
46
46
<palign="center"><sub>Synthetic example built from reserved <code>example.*</code> domains and invented runtimes. <ahref="docs/example-report.html">View the HTML</a>.</sub></p>
47
47
48
-
Use `--logo path/to/logo.png` and `--brand "Your Company"` to brand it for your own organization. CSV and JSON remain available for spreadsheets and pipelines;`--fail-on-finding` exits 1 when a pipeline should stop.
48
+
Use `--logo path/to/logo.png` and `--brand "Your Company"` to brand it for your own organization. CSV and JSON remain available for spreadsheets and pipelines.`--fail-on-finding` exits 1 when any result is `potentially_affected` or `unsupported_runtime`; operational errors exit 2.
49
49
50
50
## What the results mean
51
51
@@ -54,7 +54,7 @@ Use `--logo path/to/logo.png` and `--brand "Your Company"` to brand it for your
54
54
| 🔴 `potentially_affected`| A plain Node.js version below its branch's fix is reported. Verify the deployed build and prioritize remediation. |
55
55
| 🟠 `unsupported_runtime`| The version is on an older, unsupported upstream line. Verify vendor support and move to a supported, patched runtime. |
56
56
| 🟢 `fixed_version_reported`| The reported version meets the fix. Not independent verification of installed patches. |
57
-
| ⚪ `unknown`| Version missing, conflicting, qualified, custom-built, pre-release, or outside this rule snapshot. |
57
+
| ⚪ `unknown`| Version missing, malformed, conflicting, vendor-qualified, custom-built, pre-release, possibly backported, or outside this rule snapshot. |
58
58
59
59
| Node.js branch | 22.x | 24.x | 26.x |
60
60
| --- | --- | --- | --- |
@@ -69,7 +69,7 @@ Thresholds come from the [Node.js October 2026 security releases](https://nodejs
69
69
70
70
-**Known version:**`--node-version` (repeatable) compares a version you obtained elsewhere. No network calls.
71
71
-**Runtime inventory:**`collect-runtime.cjs` records version and build metadata from the Node.js binary that runs the service. It never loads application code, reads environment variables, decompresses data, or opens a connection, and it cannot attest vendor patch provenance.
72
-
-**Website metadata:** reads `robots.txt`, then makes ordinary `GET`requests with verified TLS, an honest User-Agent, bounded responses, and pacing. Redirects stay on the same host or its `www` counterpart. It fetches nothing else and sends no compressed bodies, credentials, or crafted requests.
72
+
-**Website metadata:** reads `robots.txt`, then makes an ordinary `GET`request to the page if allowed, with verified TLS, an honest User-Agent, bounded responses, and pacing. Redirects stay on the same host or its `www` counterpart, and HTTPS downgrades stop. It fetches nothing else and sends no compressed bodies, credentials, or crafted requests.
73
73
74
74
Input modes can be combined in one report; each observation keeps its own evidence. Express or Next.js hints never become Node.js version evidence, and Brotli response compression does not prove request decoding.
75
75
@@ -89,7 +89,7 @@ For agents contributing to this repository, [AGENTS.md](AGENTS.md) contains the
89
89
90
90
## License
91
91
92
-
Dual licensed. It's free under [AGPL-3.0](LICENSE) for research, education, and open-source use. A commercial license is available for closed-source products and hosted services that don't publish their source; see[LICENSING.md](LICENSING.md) for details. The CompleteTech LLC name and logo are covered by neither license; see [BRAND_ASSETS.md](BRAND_ASSETS.md).
92
+
Dual licensed: [AGPL-3.0](LICENSE), including commercial use that meets its terms, or a [commercial license](LICENSING.md#commercial-license) from CompleteTech LLC for closed-source products and services that don't fit the AGPL model. See[LICENSING.md](LICENSING.md) for details. The CompleteTech LLC name and logo are covered by neither license; see [BRAND_ASSETS.md](BRAND_ASSETS.md).
0 commit comments