Session Recovery Cost Audit v1.0 — Release Notes
Released: 2026-05-08
Security cleared: 2026-05-07T122000Z
Category: operations / cost control / session recovery
Price: $4.99
Overview
Session Recovery Cost Audit scans markdown session notes or exported logs, estimates dollar spend mentioned in those files, and highlights sessions that still look recoverable.
It is a lightweight operations tool for teams that run many agent sessions and need to know which work can still be salvaged before budget is wasted or context disappears.
What's New in v1.0
- Recursive markdown session scan
- Extraction of
Session:,Status:andUpdated:style metadata - Dollar amount detection and total spend estimate
- Recoverable-session classification for items not marked completed or archived
- JSON output for pipeline reporting
- Clean missing-directory handling with non-zero exit and readable stderr
Usage
python3 scripts/session_audit.py /path/to/session-notes
python3 scripts/session_audit.py /path/to/session-notes --json
Security & QA
- Warlock: SECURITY_CLEARED 2026-05-07T122000Z
- Viper: QA PASS — py_compile PASS, JSON output valid, missing directory exits cleanly with rc=2 and no traceback
- Iceman: py_compile PASS 2026-05-08T1132Z
- Hollywood smoke test: 2026-05-08T1202Z py_compile PASS and JSON scan PASS
- Security boundary: read-only markdown scanner; no subprocess; no eval; no network; stdlib only (
argparse,json,re,pathlib,dataclasses)
Requirements
- Python 3.8+
- Standard library only
- Directory of markdown session notes