From cf0b65aacf32293e10091326bd40bdcdecff635f Mon Sep 17 00:00:00 2001 From: "J.D.A. Jewell" <6759885+hyperpolymath@users.noreply.github.com> Date: Fri, 18 Sep 2026 16:05:32 +0000 Subject: [PATCH 1/3] docs(contributing): repair unbalanced code fences MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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. --- .github/CONTRIBUTING.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md index 419c49a..f51a33e 100644 --- a/.github/CONTRIBUTING.md +++ b/.github/CONTRIBUTING.md @@ -2,6 +2,7 @@ SPDX-License-Identifier: CC-BY-SA-4.0 Copyright (c) Jonathan D.A. Jewell --> +``` # Clone the repository git clone https://{{FORGE}}/{{OWNER}}/{{REPO}}.git cd {{REPO}} @@ -122,3 +123,4 @@ We follow [Conventional Commits](https://www.conventionalcommits.org/): [optional body] [optional footer] +``` From da44fa288356c8b814627bdbb25b6e6b74f95bf6 Mon Sep 17 00:00:00 2001 From: "J.D.A. Jewell" <6759885+hyperpolymath@users.noreply.github.com> Date: Fri, 18 Sep 2026 16:05:32 +0000 Subject: [PATCH 2/3] docs(contributing): materialise the template placeholders 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. --- .github/CONTRIBUTING.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md index f51a33e..347de05 100644 --- a/.github/CONTRIBUTING.md +++ b/.github/CONTRIBUTING.md @@ -4,15 +4,15 @@ Copyright (c) Jonathan D.A. Jewell --> ``` # Clone the repository -git clone https://{{FORGE}}/{{OWNER}}/{{REPO}}.git -cd {{REPO}} +git clone https://github.com/hyperpolymath/cicd-squabbler.git +cd cicd-squabbler # Using Guix (recommended for reproducibility) guix shell -D -f guix.scm # Or using toolbox/distrobox -toolbox create {{REPO}}-dev -toolbox enter {{REPO}}-dev +toolbox create cicd-squabbler-dev +toolbox enter cicd-squabbler-dev # Install dependencies manually # Verify setup @@ -22,7 +22,7 @@ just test # Run test suite ### Repository Structure ``` -{{REPO}}/ +cicd-squabbler/ ├── src/ # Source code (Perimeter 1-2) ├── lib/ # Library code (Perimeter 1-2) ├── extensions/ # Extensions (Perimeter 2) @@ -62,7 +62,7 @@ just test # Run test suite **Before reporting**: 1. Search existing issues -2. Check if it's already fixed in `{{MAIN_BRANCH}}` +2. Check if it's already fixed in `main` 3. Determine which perimeter the bug affects **When reporting**: @@ -95,10 +95,10 @@ Use the [feature request template](.github/ISSUE_TEMPLATE/feature_request.md) an Look for issues labelled: -- [`good first issue`](https://{{FORGE}}/{{OWNER}}/{{REPO}}/labels/good%20first%20issue) — Simple Perimeter 3 tasks -- [`help wanted`](https://{{FORGE}}/{{OWNER}}/{{REPO}}/labels/help%20wanted) — Community help needed -- [`documentation`](https://{{FORGE}}/{{OWNER}}/{{REPO}}/labels/documentation) — Docs improvements -- [`perimeter-3`](https://{{FORGE}}/{{OWNER}}/{{REPO}}/labels/perimeter-3) — Community sandbox scope +- [`good first issue`](https://github.com/hyperpolymath/cicd-squabbler/labels/good%20first%20issue) — Simple Perimeter 3 tasks +- [`help wanted`](https://github.com/hyperpolymath/cicd-squabbler/labels/help%20wanted) — Community help needed +- [`documentation`](https://github.com/hyperpolymath/cicd-squabbler/labels/documentation) — Docs improvements +- [`perimeter-3`](https://github.com/hyperpolymath/cicd-squabbler/labels/perimeter-3) — Community sandbox scope --- From 450adfab72f4cda02a008bb5e38746b4d79d3fa3 Mon Sep 17 00:00:00 2001 From: "J.D.A. Jewell" <6759885+hyperpolymath@users.noreply.github.com> Date: Fri, 18 Sep 2026 16:06:40 +0000 Subject: [PATCH 3/3] chore(root): allowlist the www/ site bundle MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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. --- .machine_readable/root-allow.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/.machine_readable/root-allow.txt b/.machine_readable/root-allow.txt index 20776de..edef4f3 100644 --- a/.machine_readable/root-allow.txt +++ b/.machine_readable/root-allow.txt @@ -46,6 +46,7 @@ sonar-project.properties # SonarCloud analysis config; the SonarQube scan acti .devcontainer/ # VS Code dev container spec; tool-required at root .git/ .github/ # CONTRIBUTING.md, CODE_OF_CONDUCT.md, SECURITY.md, workflows/ +www/ # site-operations bundle; canonical .well-known/ lives at www/.well-known/ (issue #53) .machine_readable/ # AI manifests, contractiles, custom-format configs .well-known/ build/ # contractile.just, setup.sh, guix.scm, .guix-channel, Containerfile