Remediation Flight Recorder
One auditable remediation transaction: frozen pre-state, policy gate, receipts, verified post-state, rollback.
- Status
- Under author review before resubmission
- 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
This tool is not currently submitted to the Exchange. It is held for the author's own review before any resubmission, and nothing here implies Tenable review, approval, certification or endorsement.