iron · doctor · auditburn iron · pulse

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

Eight probes, one verdict.

--recall-audit extends the run with a benchmark over your own vault — same harness as the published recall numbers, against your own notes.

$ metalmind doctorpulse · 1.2s · 6 / 8 ok
Vault is reachable + writable
Watcher loopback HTTP responding
MCP fallback channel registered
~/.claude/CLAUDE.md stamp present
Embedding index up to date
12 notes pending re-embed
Serena LSP backend reachable
OpenAPI shelf parses cleanly
notif-svc-v3.yaml — invalid $ref
EOD launchd agent loaded
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 spawns the recall harness against your vault — hit@1, hit@5, latency p50/p95 — so you can see whether your data is still indexed clean.

03

CI-friendly

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

When something feels off, run iron first.