Phase 3 — Move canonical heads and migrate projections
State: waits for consumer convergence and the I1/I2 mechanisms.
Outcome
Add kb/tags/ as the canonical head collection only after consumers can find
heads in their current locations through the resolver. Relocate the corpus and
installed projection as a breaking representation migration, not as part of
the semantic foundation patch.
Work
- Add the
kb/tags/collection contract and landing. Define its introduction quality goal, common meaning/use/boundary/route/stopping prefix, and cross-library link grammar. - Re-derive all transitional heads and participating tags. Move every head to
a direct child of
kb/tags/; Phase 2 has already required and dispositioned a head for each participating tag, includingtrace-learning. Never freeze a head count in migration code or acceptance. - Let filenames supply canonical tag identity. Remove
index_source: tag,index_key, the legacytags-README.mdhub, andindex_source: tag-indexesafter moving useful hub prose to the landing. - Update footer routing, generated augmentation, review-sweep scope, redirects,
and every path-constructing consumer. Switch
resolve_tag_headfrom legacy metadata lookup to direct canonical construction without retaining a legacy fallback. - Give every projection-sensitive head link an explicit I2 disposition.
Scaffold an empty host tag collection at
kb/tags/and project eligible Commonplace heads tocommonplace-library/kb/tags/. Resolve each within its owningkb-root; do not merge membership or marks across roots. - Supply the move map, obsolete paths, and sentinel user content to I1's ownership-aware upgrade mechanism. Do not create a tag-specific updater.
- Retire both adopted proposals and annotate prior tag ADRs forward after all source and installed fixtures pass.
Acceptance
- Every tag on an eligible artifact reaches its own root's canonical head.
- Host and projected Commonplace heads, marks, and generated listings remain independent; an explicitly selected reader root is independent as well.
- No live duplicate head identity or legacy hub identity remains.
- Every shipped head link resolves in the selected installed edition.
- Fresh and upgraded fixtures converge on
commonplace-managedpaths while preserving user additions. - Resolver, validation, ProperDocs, connect, relocation, upgrade, site-build, and full-suite checks pass in their appropriate packets.