Skip to content

fix(ci,docs): repair root-shape drift and the CONTRIBUTING code fences - #86

Merged
hyperpolymath merged 3 commits into
mainfrom
fix/ci-and-docs
Sep 18, 2026
Merged

hyperpolymath merged 3 commits into
mainfrom
fix/ci-and-docs

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 🔧 CodeRabbit CI Fix: Fix failing Rust CI and Dogfood validation checks #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 repairs the unbalanced code fences in .github/CONTRIBUTING.md — the setup block was missing its opening fence (so the shell instructions rendered as prose and later sections rendered as code), and the final block was never closed. 2 lines added, no content changed. Same defect as the template source, fixed there in rsr-template-repo#154.

Also materialises 20 raw template placeholders ({{FORGE}}, {{OWNER}}, {{REPO}}, {{MAIN_BRANCH}}) — this minted copy never had them substituted, so the clone line literally read https://{{FORGE}}/{{OWNER}}/{{REPO}}.git.

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.

The setup block was missing its opening fence, so the shell instructions
rendered as prose and everything between the stray fences below rendered as
code. The commit-message template at the end of the file was never closed
either, leaving the file inside a fence.

Adds the missing opener and closer. 2 insertions, 0 deletions — no content
changes. Same defect as the template source it was minted from.
This minted copy still carried the raw template tokens, so the clone line read
`https://{{FORGE}}/{{OWNER}}/{{REPO}}.git`. Replaced with this repository's own
values; no unsubstituted tokens remain.
The estate-wide .well-known migration moved the site bundle to www/.well-known/,
creating a tracked www/ directory at the repository root. This repository's
root allowlist was not updated by the migration, so scripts/check-root-shape.sh
— which estate-rules.yml runs as a required step — now fails with:

    FAIL: 1 root entries are not on the allowlist:
      - www/  (directory)

Entry copied verbatim from rsr-template-repo, which allowlists www/ for exactly
this reason (issue #53). One added line; no files moved.
@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: b4b4c663-0c26-4c46-a514-ea91d6e8b62e

📥 Commits

Reviewing files that changed from the base of the PR and between 7619703 and 450adfa.

📒 Files selected for processing (2)
  • .github/CONTRIBUTING.md
  • .machine_readable/root-allow.txt
 _____________________________
< Here comes the bug bouncer. >
 -----------------------------
  \
   \   (\__/)
       (•ㅅ•)
       /   づ

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.

@hyperpolymath
hyperpolymath merged commit 2def022 into main Sep 18, 2026
1 of 21 checks passed
@sonarqubecloud

Copy link
Copy Markdown

@hyperpolymath
hyperpolymath deleted the fix/ci-and-docs 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