Skip to content

chore(root): converge the root allowlist with the AsciiDoc migration and the www/ bundle - #57

Merged
hyperpolymath merged 2 commits into
mainfrom
chore/root-shape-allowlist
Sep 18, 2026
Merged

hyperpolymath merged 2 commits into
mainfrom
chore/root-shape-allowlist

Conversation

@hyperpolymath

Copy link
Copy Markdown
Owner

scripts/check-root-shape.sh — run as a required step by estate-rules.yml — was failing on this repository. Two causes, both fixed by additions to the allowlist only:

  1. The www/ directory. The estate-wide .well-known migration moved the site bundle to www/.well-known/, creating a tracked www/ at the root. The allowlist was never updated, so the checker flagged it as drift. Entry copied verbatim from rsr-template-repo, which allowlists www/ for exactly this reason (issue chore(deps): bump the actions group with 2 updates #53).

  2. AsciiDoc files. The allowlist names CHANGELOG.md / CONTRIBUTING.md / SECURITY.md etc. while the real .adoc files sit unlisted at the root. Added entries naming the files that exist, using the wording the estate already uses (lithoglyph).

Also relocates the versioned git hooks from .githooks/ to .github/hooks/, matching the template's own layout — the directory held only the two A2ML/K9 validators that dogfood-gate.yml calls, so its references were updated in place. No stale references remain.

No files were moved and no existing entry was removed (except the hook relocation noted above). Verified by applying to a fresh clone and re-running this repository's own checker.

…and the www/ bundle

scripts/check-root-shape.sh — run as a required step by estate-rules.yml — was
failing on this repository. Two distinct causes:

1. The estate-wide .well-known migration moved the site bundle to
   www/.well-known/, creating a tracked www/ directory at the root. The
   allowlist was not updated. Entry copied verbatim from rsr-template-repo,
   which allowlists www/ for exactly this reason (issue #53).

2. The allowlist names AsciiDoc files that the repository no longer (or never
   did) contain — CHANGELOG.md and friends — while the real .adoc files sit
   unlisted at the root. Added the entries naming the files that exist, using
   the wording the estate already uses for this (lithoglyph).

No files moved and no existing entry removed: only additions.
…ub/hooks/

scripts/check-root-shape.sh flags .githooks/ as root drift — it is not on the
allowlist. The directory holds only the two A2ML/K9 validators invoked by
dogfood-gate.yml, and the estate canon keeps versioned hooks under .github/
(rsr-template-repo made the same move), so the directory is not added to the
allowlist; the hooks move instead.

Updated the two dogfood-gate invocations that call them.
@coderabbitai

coderabbitai Bot commented Sep 18, 2026

Copy link
Copy Markdown
Contributor

Review Change StackReview Change Stack

Note

Currently processing new changes in this PR. This may take a few minutes, please wait...

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Advanced

Run ID: 1aa46cdf-2248-4ea7-9676-e4c263054e80

📥 Commits

Reviewing files that changed from the base of the PR and between a84e334 and f38c8df.

📒 Files selected for processing (4)
  • .github/hooks/validate-a2ml.sh
  • .github/hooks/validate-k9.sh
  • .github/workflows/dogfood-gate.yml
  • .machine_readable/root-allow.txt
 ___________________________________________________________________________________
< Our code review squad: You're the Tank and I'm the Healer. Let's raid those bugs. >
 -----------------------------------------------------------------------------------
  \
   \   (\__/)
       (•ㅅ•)
       /   づ

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@sonarqubecloud

Copy link
Copy Markdown

@hyperpolymath
hyperpolymath merged commit 9ddf217 into main Sep 18, 2026
3 of 39 checks passed
@hyperpolymath
hyperpolymath deleted the chore/root-shape-allowlist branch September 18, 2026 16:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant