From 93905e6e72b3f214625221487f43529d3bd17640 Mon Sep 17 00:00:00 2001 From: "Jonathan D.A. Jewell" <6759885+hyperpolymath@users.noreply.github.com> Date: Thu, 6 Aug 2026 13:03:46 +0100 Subject: [PATCH] chore(governance): declare 1 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 | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/.machine_readable/root-allow.txt b/.machine_readable/root-allow.txt index 4f1bc0b..aa75067 100644 --- a/.machine_readable/root-allow.txt +++ b/.machine_readable/root-allow.txt @@ -70,3 +70,10 @@ design/ # surface grammar, elaboration table, vendored IR sch compiler/ # planned: parser/type-checker/elaborator/codegen (STATUS.adoc) lsp/ # planned: editor support (STATUS.adoc) LICENSES/ # REUSE texts: MPL-2.0 (code) + CC-BY-SA-4.0 (prose docs) + +# ─── 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. +REQUIRES_INITIALISATION.md # Project documentation.