exam-audit

# exam-audit — workspace health check (read-only) ## Purpose Inspect a prep workspace built by `exam-ingest` and report health issues. This is a read-only inspector. Do NOT fix anything by default; only fix after the user explicitly grants permission. Emit a concrete issue report; never silently modify or delete files. ## Activation Activate when the user suspects the workspace is broken (missing chapters, ungradable quiz items, inconsistent progress), or when the user wants a pre-review health check before studying. Do not activate to build, teach, or grade. ## Inputs - `references/wiki/` — chapter knowledge files (`chN_*.md`). - `references/quiz_bank.json` — quiz items. - `references/teaching_examples.json` — optional parallel teaching inventory; examples may remain here even when they are deliberately excluded from the gradable bank. - `references/teaching_baseline.json` — append-only retention baseline for new workspaces; it must never shrink on re-ingest and must not be hand-edited. - `references/figure_page_index.json` / `references/image_question_index.json` — regenerable three-sided visual coverage evidence (wiki / prompt / answer). - `.ingest/source_manifest.json` — source-root-relative paths, source hashes, media types, and parse status. - `.ingest/base_content_units.jsonl` / `content_units.jsonl` — deterministic extraction baseline and the compiled view after replaying validated patches. - `.ingest/base_chapter_phase_mappings.jsonl` / `chapter_phase_mappings.jso...