ID

R348

Status

Backlog

Bucket

tech-debt

Priority

3

Theme

docs

Created

2026-06-19

Updated

2026-06-19

Regenerate and guard the generated supported-schema-shapes migration doc against drift

docs/manual/_generated/supported-schema-shapes.adoc is a generated migration fragment (included by docs/manual/how-to/migrating-from-legacy.adoc) produced by graphitron-roadmap-tool leaf-coverage --mode=migration (LeafCoverageReport.run, migration branch). Like its sibling supported-directives.adoc (R346), its header promises "Regenerate via the verify-mode CI guard," but no such guard exists: nothing in .github/workflows, the poms, or any script runs leaf-coverage --mode=migration. The only leaf-coverage step in CI (rewrite-build.yml "Regenerate leaf-coverage report") runs leaf-coverage graphitron-rewrite with no --mode=migration, regenerating the internal inference-axis-coverage.adoc report, not this fragment. So the fragment silently drifts whenever the classified leaf set changes, and a reader migrating off legacy is shown a stale schema-shape support surface.

This is the identical gap R346 closes for supported-directives.adoc, split out because the guard has a different shape: regenerating this fragment depends on build-time leaf-coverage.jsonl trace files (populated by the leaf-coverage profile during mvn verify), so the verify diff cannot live in the SDL-only roadmap-tool verify execution R346 adds; it must run after the test phase, closer to the existing trace-consuming leaf-coverage step. Spec should reuse R346’s --verify idiom (leaf-coverage already has a --verify flag; wire it) and decide the post-test seam (a phase-bound execution after tests, or a CI step that diffs rather than only uploading). Land alongside a regenerate-once pass so the committed fragment matches current output.