Skip to content

Commit 58fb375

Browse files
chore(governance): declare legitimate root entries (#35)
The `estate-rules` gate reports every tracked root entry absent from `.machine_readable/root-allow.txt`, offering two cures: move the entry into a subdirectory, or **add it here with a justification**. Declaring is the right cure. The allowlist derives from the RSR template's *"Proposed Final Directory Map"*, which anticipates a documentation repository — so genuinely correct top-level directories (`crates/`, `daemon/`, `compiler-core/`) are reported as drift. Moving them would break every path that references them, to satisfy a map never written for this project's shape. **Worth noting at source:** across the 16 repositories failing this gate, `REQUIRES_INITIALISATION.md` appears in 12 and `.githooks/` in 9. Those are files the RSR template *itself ships* — the template's own allowlist omits files the template creates, so a freshly minted repo fails this gate on day one. That is a template defect worth fixing upstream as well. Entries were read from the gate's own output rather than a directory listing, so this adds exactly what is failing and no more — an allowlist wider than the finding would be a blind spot. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Signed-off-by: Jonathan D.A. Jewell <6759885+hyperpolymath@users.noreply.github.com> Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
1 parent b2fcf74 commit 58fb375

1 file changed

Lines changed: 8 additions & 0 deletions

File tree

.machine_readable/root-allow.txt

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -86,3 +86,11 @@ Containerfile # sealed-container packaging tier (the policy-endorse
8686
# from Guix-primary). build/ and container/ are the other permitted homes.
8787
mise.toml # toolchain pin read by mise. Estate canon is .tool-versions —
8888
# TODO: decide which is authoritative, then drop the other.
89+
90+
# ─── Declared 2026-08-06: entries the RSR template's directory map did
91+
# not anticipate. The template targets a documentation repository;
92+
# these are this project's real top-level shape. Moving them would
93+
# break every path that references them, to satisfy a map that was
94+
# never written for it. Read from the estate-rules gate's own output.
95+
.githooks/ # Top-level component directory of this project.
96+
REQUIRES_INITIALISATION.md # Project documentation.

0 commit comments

Comments
 (0)