Skip to content

NHI-Blast 0.3.0 — public beta

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 08 Nov 10:37
· 2 commits to main since this release

NHI-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 HEAD and nhi-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.