Problem
The required check "Registry + topology in sync" (scripts/build-registry.sh --check) fails whenever .machine_readable/REGISTRY.a2ml source_hashes drift from the file tree — which happens any time a spec file changes without someone running just registry. Because it is a required status check, the stale registry then blocks every open PR, not just the one that caused the drift.
Observed
Proposed fix (pick one)
- Pre-commit hook that runs
just registry (or registry-check) and fails/auto-stages if REGISTRY.a2ml/TOPOLOGY.md drift — catches it at commit time.
- CI auto-regen: a governance job that runs
just registry and commits the result (bot) when drift is detected, instead of just failing.
- At minimum, document in CONTRIBUTING that any
.machine_readable/** change must be followed by just registry.
Filed during the 2026-06-11 estate review/cleanup pass.
Problem
The required check "Registry + topology in sync" (
scripts/build-registry.sh --check) fails whenever.machine_readable/REGISTRY.a2mlsource_hashes drift from the file tree — which happens any time a spec file changes without someone runningjust registry. Because it is a required status check, the stale registry then blocks every open PR, not just the one that caused the drift.Observed
maincommits also failed the check. Root cause:REGISTRY.a2mlsource_hashes were stale (no structural change — just un-regenerated hashes).just registryand committing the resync (rode in on perf(hypatia-scan): cache built scanner keyed on Hypatia HEAD + shallow clone #380), but the recurrence is unaddressed.Proposed fix (pick one)
just registry(orregistry-check) and fails/auto-stages ifREGISTRY.a2ml/TOPOLOGY.mddrift — catches it at commit time.just registryand commits the result (bot) when drift is detected, instead of just failing..machine_readable/**change must be followed byjust registry.Filed during the 2026-06-11 estate review/cleanup pass.