Remediation Flight Recorder
One auditable remediation transaction: frozen pre-state, policy gate, receipts, verified post-state, rollback.
- Status
- Submitted, awaiting review
- Licence
- MIT · zero runtime dependencies
- Evidence
- 33 tests · 180,000 invariant checks
The problem
Can this fix prove what it changed, and undo itself when verification fails?
After a bad change, nobody can reconstruct what it looked like before from memory — and blast radius was estimated in a meeting rather than computed.
What it does
It runs remediation as one auditable transaction: freezes the pre-change exposure snapshot, computes direct and transitive blast radius, gates on policy and explicit named approval, binds external execution receipts, verifies the post-change state, and enters rollback when verification fails — all sealed in a SHA-256 evidence chain.
How it works
The state machine refuses out-of-order transitions: a transaction denied by policy can never be approved or executed, and approval records an explicit named approver rather than being implied. Execution stays external — the server binds the receipts your executor returns instead of touching devices. Every lifecycle event is chained with SHA-256 over canonical data, so later tampering is detectable.
Tool surface
MCP over stdio. Compatible with Claude Code, Claude Desktop and Cursor, or usable directly as a TypeScript library. No API key, account or Tenable product is required.
remediation_preflight
Seal the snapshot, compute blast radius, evaluate policy and build the rollback plan.
remediation_approve
Record an explicit named approver; approval is never implied.
remediation_record_execution
Bind external executor receipts to an approved transaction.
remediation_verify
Compare the declared post-state expectation against the supplied post-state.
remediation_record_rollback
Record a receipted rollback after failed verification.
remediation_verify_ledger
Verify the sealed evidence chain for the transaction.
What it deliberately does not do
- It never SSHes, calls an API or changes a device — execution is external and receipted.
- Denied means denied: the state machine cannot be talked past.
- Rollback requires a rollback plan built at preflight.
Provenance
Where this came from
SHPBL discovered and composed this product from capability intent across its library and CMPSBL, a sister project by the same developer. It was composed from packetchaos/navi and the SHPBL library — new software neither had before, with zero lines of upstream implementation copied. The implementation cleared an exact-file review of its release surface and received its own MIT grant over that reviewed file set. The MIT grant covers only the named files in that one repository; it does not relicense SHPBL, CMPSBL, private harvest machinery, harvested bodies or provenance maps.
SHA-256 · c8076d528fed3546b33529dc1c919659634a13761d4e8c36598f141e43ff5e5d
Submission does not imply review, approval, certification or endorsement by Tenable. No Exchange listing exists until a maintainer merges it.