[blocker:mdbook-quiz] mdbook 0.5 compatibility

[padamson]

Blocked by

cognitive-engineering-lab/mdbook-quiz#61 — mdbook 0.5 support
cognitive-engineering-lab/mdbook-quiz#62 — PR: Add mdbook 0.5.x Support (waiting on review)

Category

Third-party (forked)

Book context

• Chapter: Ch 01 (MinimumCD quiz), future chapters with comprehension checks
• What we were building: Interactive quizzes for reader self-assessment
• Related code: book.toml (quiz preprocessor), src/ch01-minimumcd-quiz.toml, src/quiz/

Fork details

• Fork repo: padamson/mdbook-quiz
• Upstream PR: Add mdbook 0.5.x Support cognitive-engineering-lab/mdbook-quiz#62 (complete, waiting on maintainer review)
• Using fork via: Clone fork, fetch PR branch, build from source with depot build --release then cargo install

Build prerequisites

Building from source requires just and Depot:

brew install just
cargo install depot-js --locked

Progress

• Clone fork, fetch PR #62 branch
• Build JS assets with depot build --release
• Install with cargo install --path crates/mdbook-quiz --locked
• Re-enable [preprocessor.quiz] in book.toml
• Test Ch 01 quiz — renders and works correctly with mdbook 0.5
• Comment on upstream PR #62 with test results and flake.nix feedback
• Filed #63 for local dev setup gaps
• Offered to submit follow-up PR to reconcile flake.nix
• When upstream merges and releases, switch back to cargo install mdbook-quiz

Notes

• just install doesn't work out of the box — need to run depot build --release first (tracked in #63)
• Built without rust-editor/aquascope features (not needed for our quizzes)
• If maintainer accepts flake.nix offer, could bundle a build fix into that follow-up PR

Post-merge cleanup

• Switch cargo install from fork to crates.io
• Re-enable command -v cache check in CI workflow