Canvas test harness, TypeScript IMSCC validator in CI, real-Canvas fixtures, refreshed CLAUDE.md

[daTechGuy]

Makes the Canvas-testing knowledge durable and enforces it in CI. Previously it lived in ad-hoc scripts under the gitignored output/.

What's here

1. Canvas test harness — tools/canvas-test/

• setup-canvas.sh: reproducible, resumable, idempotent dev-Canvas build pinned to exact Canvas + QTIMigrationTool commits, with the three fixes baked in (publish PORT:80; undeclared @instructure/platform-alerts dependency; QTI tool installed before first boot). fixes / smoke subcommands.
• cct.sh (+ ruby/): import a cartridge into a throwaway course and dump what Canvas actually built; reference / template build a course in Canvas and export it with Canvas's own exporter; list; cleanup (only touches courses ending (cct)). Local or over SSH.
• build-demo-cartridge.sh, and a README documenting the workflow and every pitfall.

2. Validator + fixtures in CI

• src/services/export/validateImscc.ts (TypeScript port of the Python prototype, now removed; npm run validate:imscc). Native-format rules catch the "imports cleanly but drops content" class: marker without module_meta.xml, quiz meta without native QTI, wiki_content/ page missing from the manifest (stray page), dangling references, malformed XML, bare &.
• tests/fixtures/*.imscc: a reference course and an instructor template written by Canvas's own exporter (scrubbed of instance details). tests/imscc-validator.test.ts and tests/canvas-real-fixtures.test.ts run the validator, parser and template exporter against them — locking in the behaviours that were real bugs. CI already runs the whole suite, so these guard every PR.

3. CLAUDE.md rewritten for this fork (LLM/provider layer, the two export modes and the rules that bit us, verification workflow, merge-commit-only and upstream-sync notes).

Notes

• .gitignore excepts the fixtures from *.imscc; .gitattributes pins *.sh/*.rb to LF (with core.autocrlf=true they'd break on Windows) and marks *.imscc binary. Scripts are committed executable.
• Verified locally: tsc -b, eslint (0 errors), vitest --coverage (319 pass, 1 skipped — the harness-only generator), vite build. The harness itself was exercised against the live Canvas (list, import of native + template cartridges, reference/template generation, cleanup) and setup-canvas.sh fixes/smoke were run on the existing checkout (no-op, healthy). A full from-scratch setup-canvas.sh run was not repeated.
• Not done: relaxing the branch-protection review rule (a protection change was blocked for me; see the conversation).

🤖 Generated with Claude Code

[codecov-commenter]

⚠️ Please install the to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

❌ Patch coverage is 77.53623% with 31 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
src/services/export/validateImscc.ts	77.53%	8 Missing and 23 partials ⚠️

📢 Thoughts on this report? Let us know!