iron · doctor · auditpulse

A clean diagnostic, or a precise reason it isn't clean.

Iron is metalmind's self-check. Eight subsystem probes, each printing pass or the exact path to the broken file. One command tells you whether the rest of the library can do its job.

§ metalmind doctormetalmind pulse

Every subsystem, one verdict.

--deep adds live probes: watcher state, the loopback endpoint, per-host stamps, and the supersede and code-ref integrity checks over your own vault.

$ metalmind doctorpulse · 1.2s · 6 / 8 ok
✓
watcher - service loaded + active
✓
recall-http - 127.0.0.1:17317 reachable
✓
global-claude-md - stamp present
✓
vault-claude-md - stamp present
✓
codex-agents-md - sentinel block
✓
cursor-recall-skill - installed
⚠
supersede-integrity - pointers resolve
old-plan: superseded_by 'gone' does not resolve
✗
code-refs-integrity - refs resolve
auth-decision: coreapi#LegacyGuard missing
01

No mystery failures

Every red row prints the file path, the exact failed assertion, and the doc page that explains the fix. No "something went wrong."

02

Recall audit

doctorpulse --recall-audit replays your opt-in recall log and classifies past queries as ok, weak-hit, or zero-hit - the queries that came back empty are your best /save candidates.

03

CI-friendly

Exit code 0 only on full green. Wire doctorpulse --deep into a pre-commit hook or your team's CI to fail fast on a broken vault.

When something feels off, run iron first.