# Total Mayhem - Classroom Puzzle Kits

Printable puzzle kits (PDF, US Letter) built from the promoted canon graph in
canon/data/ - the only content source, read-only. 14 book kits + 2 theme kits,
each ending in an answer key that cites a canon record and book:chapter:page
for every single answer.

- kits/ - the 16 PDFs (print these)
- content/ - per-kit content JSON: every puzzle item with its canon record id,
  field, transformation and refs (the audit trail)
- tools/ - dependency-free pipeline (system Python 3; poppler only for QA)
- PLAN.md - the session plan; REPORT.md - as-built report + verification
  results; OPEN_QUESTIONS.md - instructional-text inventory and judgment
  calls awaiting Ralph's review

Rebuild everything (deterministic, audits itself):

    python3 tools/build_all.py

Provenance rule: pupil-visible strings are canon-verbatim or a declared
mechanical transformation (blank / substring / letterize / Morse-NATO encode),
except the minimal instruction lines inventoried in OPEN_QUESTIONS.md.
tools/verify_kits.py re-derives every string from its cited record and fails
the build on any mismatch.