From 8832d5adb3ff6af2fabbc11fd9ea33c75a3e2e56 Mon Sep 17 00:00:00 2001 From: "Jonathan D.A. Jewell" <6759885+hyperpolymath@users.noreply.github.com> Date: Thu, 6 Aug 2026 13:04:15 +0100 Subject: [PATCH] chore(governance): declare 5 legitimate root entries MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The `estate-rules` gate reports every tracked root entry absent from .machine_readable/root-allow.txt, and offers two cures: move the entry into a subdirectory, or add it here with a justification. Declaring is the right cure here. The allowlist derives from the RSR template's "Proposed Final Directory Map", which anticipates a documentation repository — so genuinely correct top-level directories are reported as drift. Moving them would break every path that references them in order to satisfy a map that was never written for this project's shape. Entries were read from the gate's own output rather than from a directory listing, so this adds exactly what is failing and no more — an allowlist wider than the finding would be a blind spot. Co-Authored-By: Claude Opus 5 Signed-off-by: Jonathan D.A. Jewell <6759885+hyperpolymath@users.noreply.github.com> --- .machine_readable/root-allow.txt | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/.machine_readable/root-allow.txt b/.machine_readable/root-allow.txt index 778a61d..691faba 100644 --- a/.machine_readable/root-allow.txt +++ b/.machine_readable/root-allow.txt @@ -66,3 +66,14 @@ container/ # may host Containerfile if not at build/ .pre-commit-config.yaml # TODO: relocate to ci/.pre-commit-config.yaml after invocation pattern decided affinescript/ # AffineScript source subtree consumed by this template tools/ # TODO: consolidate with scripts/ or document the split (pending decision) + +# ─── Declared 2026-08-06: entries the RSR template's directory map did +# not anticipate. The template targets a documentation repository; +# these are this project's real top-level shape. Moving them would +# break every path that references them, to satisfy a map that was +# never written for it. Read from the estate-rules gate's own output. +.githooks/ # Top-level component directory of this project. +.hypatia-ignore # Project file that must remain at the repository root. +CLAUDE.md # Project documentation. +REQUIRES_INITIALISATION.md # Project documentation. +flake.nix # Project file that must remain at the repository root.