Repository navigation
NHI-Blast 0.3.0 — public beta
Pre-releaseNHI-Blast 0.3.0 — public beta
Offline, evidence-labelled analysis of GitHub Actions → AWS OIDC authority: which roles and
credentials are potentially reachable from a hypothetical compromised entrypoint, which
credentials survive revocation (R / E / Z), and a safe rotation order. Local-first Python 3.12+
CLI; no network calls, no execution of scanned content, no credential values stored or printed.
This is a beta pre-release. Verified locally on Windows 11 and by the CI matrix on Ubuntu
and Windows runners (Python 3.12, 3.13 and 3.14); macOS is untested. No independent human
security audit has been performed. Severity labels order findings; they are not verdicts.
Highlights
- Report schema 1.1 (
nhi-blast-report/1.1, additive — 1.0 reports still load): recorded
analysis context (analyzer identity, effective configuration, limits, scenarios, digests) and
explicit completeness for nineteen input families. No score, no "complete" badge. nhi-blast diff BASE HEADandnhi-blast baseline accept|prune: new / changed /
unchanged / resolved / not-observed findings. "Resolved" is claimed only when analyzer,
inputs and completeness are comparable; otherwise the report says "not observed" with reasons.nhi-blast whatif REPORT --plan PLAN: offline containment modelling (disable entrypoint,
remove trust, revoke sessions, rotate) with a Markdown playbook. Refuses to run when the saved
report cannot be replayed exactly. Nothing is executed.- Corrected AWS condition semantics: unknown keys are Unknown, never Absent;
IfExists/Null
no longer produce definite results for keys the analyzer has no information about; numeric,
date, IP, binary and boolean operators evaluated. Results can be broader than 0.2.0 where a
block was wrongly FALSE. - Session lifetime provenance: requested duration bounded by the role maximum and the
one-hour role-chaining limit; the flat 3600 s default is gone. Session policies are recorded,
not evaluated. - New report identity: light and dark themes with a System/Light/Dark switcher, embedded
Host Grotesk + Instrument Sans (SIL OFL 1.1), an Analysis completeness panel, scope-aware
empty states, and Motion micro-interactions with a Motion Off control. Essential values render
independently of decorative animation. - Hardened artifact IO: sensitive-field minimization (kind + length only), staged writes with
rollback/cleanup, actual-open identity tracking, explicit errors for denied output directories,
host paths excluded from serialized metadata.
See the changelog and
release notes
for the full record, including what is not included (diff/what-if HTML, GitHub Action,
GitHub context import, session policy evaluation, public-corpus benchmark, macOS verification).
Downloads
| Asset | Purpose |
|---|---|
nhi_blast-0.3.0-py3-none-any.whl |
Python wheel (Python 3.12+) |
nhi_blast-0.3.0.tar.gz |
Source distribution |
nhi-blast-windows-x64.exe |
Standalone Windows x64 executable (no Python needed; unsigned) |
SHA256SUMS |
SHA-256 digests of the wheel, sdist and executable |
nhi-blast-windows-x64.exe.sha256 |
Standalone checksum record for the executable |
sbom.cdx.json |
CycloneDX 1.6 software bill of materials |
LICENSE, NOTICE, THIRD_PARTY_NOTICES.md |
Licence and embedded-component notices (also embedded in the executable) |
There is no PyPI/TestPyPI publication for this version; install from the assets below.
Install
Python wheel (with the optional HCL extra and pinned runtime dependencies):
pip install "nhi_blast-0.3.0-py3-none-any.whl[hcl]" -c requirements.lock
nhi-blast version
requirements.lock is in the source distribution and the repository at tag v0.3.0.
Windows executable: download nhi-blast-windows-x64.exe and run it directly:
nhi-blast-windows-x64.exe version
nhi-blast-windows-x64.exe scan path\to\repo --simulate-compromise action:owner/action@ref
The executable is unsigned and carries LICENSE, NOTICE and THIRD_PARTY_NOTICES.md embedded.
Verify
sha256sum -c SHA256SUMS
See docs/verify-release.md
for the full verification guide. The wheel and sdist carry GitHub build attestations from the
release workflow. The Windows executable is built locally from the tagged source with the locked
toolchain; it is covered by SHA256SUMS and its own .sha256 record, not by a build attestation.
Quickstart
nhi-blast scan tests/fixtures/fx07-incident \
--simulate-compromise action:tj-actions/changed-files@v45 \
--format json --format sarif --format html --fail-on high
Licence
MIT. Published releases 0.1.0, 0.1.1 and 0.2.0 keep their original terms. Embedded fonts are
SIL OFL 1.1; the vendored Motion runtime is MIT. See THIRD_PARTY_NOTICES.md.