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.