How evolutionairy-ai/mindlas works
Mindlas is a local, deterministic reliability instrument for long-running Claude Code sessions. Hooks capture session activity into an event ledger; four independent gauges measure deterioration and surface paired corrections. The CLI runs those corrections and exposes status and reports, while the status line presents live readings. README capabilities fill in the hook, status-line, and gauge branches where source excerpts were not sampled; their exact wiring is therefore shown only where documented.
Main entry points: cli.py Mindlas CLI · runtime Signal builders · hooks.py Hook dispatch · ledger.py Event ledger
Components 16
Session capture
- Hook dispatch
src/mindlas/vitals/hooks.py - Event capture
src/mindlas/vitals/capture.py - Event ledger
src/mindlas/vitals/ledger.py
Risk gauges
- Context Rot
src/mindlas/features/context_rot.py - Verification Debt
src/mindlas/features/verification_debt.py - Blast Radius
src/mindlas/features/blast_radius.py - Tool Failure Loop
src/mindlas/features/tool_failure_loop.py - Signal builders
src/mindlas/runtime
Corrections
- Context Repair
src/mindlas/actions/context_repair.py - Verify Gate
src/mindlas/actions/verify_gate.py - Patch Splitter
src/mindlas/actions/patch_splitter.py - Loop Stop
src/mindlas/actions/loop_stop.py
CLI and reporting
- Mindlas CLI
src/mindlas/cli.py - Status line
src/mindlas/vitals/statusline.py - Scorecard export
src/mindlas/runtime/scorecard.py
Other components
- Claude Code
Connections 22
- Claude Code → Hook dispatch: sends events
- Hook dispatch → Event capture: captures activity
- Hook dispatch → Event ledger: records events
- Event ledger → Signal builders: provides events
- Signal builders → Context Rot: builds signals
- Signal builders → Verification Debt: builds signals
- Signal builders → Blast Radius: builds signals
- Signal builders → Tool Failure Loop: builds signals
- Context Rot → Context Repair: pairs correction
- Verification Debt → Verify Gate: pairs correction
- Blast Radius → Patch Splitter: pairs correction
- Tool Failure Loop → Loop Stop: pairs correction
- Claude Code → Mindlas CLI: invokes commands
- Mindlas CLI → Context Repair: runs correction
- Mindlas CLI → Verify Gate: runs correction
- Mindlas CLI → Patch Splitter: runs correction
- Mindlas CLI → Loop Stop: runs correction
- Status line → Event ledger: reads events
- Status line → Signal builders: builds readings
- Context Repair → Scorecard export: writes report
- Verify Gate → Scorecard export: writes report
- Mindlas CLI → Scorecard export: shows report