Skip to content

Commit 06b196e

Browse files
committed
chore: fill derivable placeholders, drop false ARCHITECTURE, surface the rest
Estate top-up pass. Three separate things, none of which invents a value. FILLED — every token with a single mechanical answer: OWNER, REPO, FORGE, PROJECT, PACKAGE_NAME, PROJECT_NAME, AUTHOR, AUTHOR_EMAIL, CONDUCT_EMAIL, AUTHOR_FIRST/LAST/INITIALS, CURRENT_YEAR, CURRENT_DATE, DATE, MAIN_BRANCH. Identity comes from the git remote, dates from the clock, project name from the README H1 where there is one. Deliberately NOT filled, because more than one defensible answer exists and a confident wrong value is worse than a visible gap: SECURITY_EMAIL (two competing addresses are in use across the estate), RESPONSE_TIME, CONDUCT_TEAM (which substitutes into "a {{CONDUCT_TEAM}} member", not English), WEBSITE, PROJECT_DESCRIPTION, LANG_STACK. DELETED — ARCHITECTURE.md, where it is byte-identical to the 346-copy estate boilerplate (blob 607e3d8). Those 33 lines describe a src/ tests/ docs/ scripts/ config/ tree that this repo does not have, so the file is not merely uninformative, it is wrong. Genuinely written ARCHITECTURE files are matched by hash and left alone. No file beats a confidently false one. CODEOWNERS — rewritten to the solo form mandated by hyperpolymath/standards CODEOWNERS-POLICY.adoc Rule 1, which forbids a catch-all line where the only owner is the sole maintainer. The estate's own templates/CODEOWNERS contradicts that policy; the policy is versioned, dated and resolves standards#55, so it wins. Files naming a genuine co-owner are Rule 2 and are untouched. Note @hyperpolymath and @metadatastician are the same person, so a file naming the other account is a copy artifact that silently routed review requests to the wrong account. SURFACED — REQUIRES_INITIALISATION.md, and a priority action in 0-AI-MANIFEST.a2ml. Tokens that need a decision no script can make are left visibly unfilled rather than faked or quietly deleted. The marker says what each one is, which files it belongs in, why it was not done already, and that it must be deleted only once the work is genuinely finished.
1 parent 0d70706 commit 06b196e

14 files changed

Lines changed: 399 additions & 96 deletions

‎.github/CODEOWNERS‎

Lines changed: 3 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,4 @@
11
# SPDX-License-Identifier: MPL-2.0
2-
# CODEOWNERS - Define code review assignments
3-
# See: https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
4-
#
5-
# Replace hyperpolymath with your GitHub username or team
6-
7-
# Default owners for everything
8-
* @hyperpolymath
9-
10-
# Security-sensitive files require explicit review
11-
SECURITY.md @hyperpolymath
12-
.github/workflows/ @hyperpolymath
13-
Trustfile.a2ml @hyperpolymath
14-
.machine_readable/ @hyperpolymath
2+
# Solo-maintained hyperpolymath repo: no owner lines by policy.
3+
# See hyperpolymath/standards CODEOWNERS-POLICY.adoc (Rule 1).
4+
# Sole-maintainer review is moot; SPDX headers carry attribution.

‎.github/CODE_OF_CONDUCT.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ Replace all values:
88
Patch Bridge - Your project name
99
hyperpolymath - GitHub/GitLab username or org
1010
patch-bridge - Repository name
11-
{{CONDUCT_EMAIL}} - Email for conduct reports
11+
j.d.a.jewell@open.ac.uk - Email for conduct reports
1212
{{CONDUCT_TEAM}} - Name of conduct team/committee
1313
{{RESPONSE_TIME}} - Initial response SLA (e.g., 48 hours)
1414
2026 - Current year
@@ -136,7 +136,7 @@ If you experience or witness unacceptable behaviour, or have any other concerns,
136136

137137
| Method | Details | Best For |
138138
|--------|---------|----------|
139-
| **Email** | {{CONDUCT_EMAIL}} | Detailed reports, sensitive matters |
139+
| **Email** | j.d.a.jewell@open.ac.uk | Detailed reports, sensitive matters |
140140
| **Private Message** | Contact any maintainer directly | Quick questions, minor issues |
141141
| **Anonymous Form** | [Link to form if available] | When you need anonymity |
142142

@@ -231,7 +231,7 @@ For contributors with elevated access (Perimeter 2 or 1):
231231
If you believe an enforcement decision was made in error:
232232

233233
1. **Wait 7 days** after the decision (cooling-off period)
234-
2. **Email** {{CONDUCT_EMAIL}} with subject line "Appeal: [Original Report ID]"
234+
2. **Email** j.d.a.jewell@open.ac.uk with subject line "Appeal: [Original Report ID]"
235235
3. **Explain** why you believe the decision should be reconsidered
236236
4. **Provide** any new information not previously available
237237

@@ -310,8 +310,8 @@ We thank these communities for their leadership in creating welcoming spaces.
310310

311311
If you have questions about this Code of Conduct:
312312

313-
- Open a [Discussion](https://{{FORGE}}/hyperpolymath/patch-bridge/discussions) (for general questions)
314-
- Email {{CONDUCT_EMAIL}} (for private questions)
313+
- Open a [Discussion](https://github.com/hyperpolymath/patch-bridge/discussions) (for general questions)
314+
- Email j.d.a.jewell@open.ac.uk (for private questions)
315315
- Contact any maintainer directly
316316

317317
---

‎.github/CONTRIBUTING.md‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# Clone the repository
2-
git clone https://{{FORGE}}/hyperpolymath/patch-bridge.git
2+
git clone https://github.com/hyperpolymath/patch-bridge.git
33
cd patch-bridge
44

55
# Using Nix (recommended for reproducibility)
@@ -58,7 +58,7 @@ patch-bridge/
5858
5959
**Before reporting**:
6060
1. Search existing issues
61-
2. Check if it's already fixed in `{{MAIN_BRANCH}}`
61+
2. Check if it's already fixed in `main`
6262
3. Determine which perimeter the bug affects
6363
6464
**When reporting**:
@@ -91,10 +91,10 @@ Use the [feature request template](.github/ISSUE_TEMPLATE/feature_request.md) an
9191
9292
Look for issues labelled:
9393
94-
- [`good first issue`](https://{{FORGE}}/hyperpolymath/patch-bridge/labels/good%20first%20issue) — Simple Perimeter 3 tasks
95-
- [`help wanted`](https://{{FORGE}}/hyperpolymath/patch-bridge/labels/help%20wanted) — Community help needed
96-
- [`documentation`](https://{{FORGE}}/hyperpolymath/patch-bridge/labels/documentation) — Docs improvements
97-
- [`perimeter-3`](https://{{FORGE}}/hyperpolymath/patch-bridge/labels/perimeter-3) — Community sandbox scope
94+
- [`good first issue`](https://github.com/hyperpolymath/patch-bridge/labels/good%20first%20issue) — Simple Perimeter 3 tasks
95+
- [`help wanted`](https://github.com/hyperpolymath/patch-bridge/labels/help%20wanted) — Community help needed
96+
- [`documentation`](https://github.com/hyperpolymath/patch-bridge/labels/documentation) — Docs improvements
97+
- [`perimeter-3`](https://github.com/hyperpolymath/patch-bridge/labels/perimeter-3) — Community sandbox scope
9898
9999
---
100100

‎.well-known/security.txt‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,6 @@ Contact: mailto:{{SECURITY_EMAIL}}
66
Expires: 2026-12-31T23:59:59.000Z
77
Encryption: {{PGP_KEY_URL}}
88
Preferred-Languages: en
9-
Canonical: https://{{FORGE}}/hyperpolymath/patch-bridge/.well-known/security.txt
10-
Policy: https://{{FORGE}}/hyperpolymath/patch-bridge/blob/main/SECURITY.md
9+
Canonical: https://github.com/hyperpolymath/patch-bridge/.well-known/security.txt
10+
Policy: https://github.com/hyperpolymath/patch-bridge/blob/main/SECURITY.md
1111
Hiring: https://{{WEBSITE}}/careers

‎0-AI-MANIFEST.a2ml‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,3 +44,20 @@ Canonical project metadata belongs under `.machine_readable/`.
4444
1. Read this file.
4545
2. Read `.machine_readable/STATE.a2ml` and `.machine_readable/6a2/STATE.a2ml`.
4646
3. Check the current audit report before modifying claims or release posture.
47+
48+
<!-- BEGIN requires-initialisation -->
49+
50+
## PRIORITY ACTION — this repository is not fully initialised
51+
52+
35 substitution token(s) still have no value. **Read
53+
`REQUIRES_INITIALISATION.md` in the repository root before doing anything
54+
else here** — it lists every outstanding token, what it means, and which
55+
files it belongs in.
56+
57+
Do not fabricate values for them, and do not delete the sections that
58+
contain them to quiet a gate. They are unfilled because they need a
59+
decision, not because they were overlooked. Resolve what you legitimately
60+
can, leave the rest, and delete `REQUIRES_INITIALISATION.md` only when
61+
nothing outstanding remains.
62+
63+
<!-- END requires-initialisation -->

‎ARCHITECTURE.md‎

Lines changed: 0 additions & 47 deletions
This file was deleted.

‎QUICKSTART-MAINTAINER.adoc‎

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
// SPDX-License-Identifier: CC-BY-SA-4.0
22
// Template: QUICKSTART-MAINTAINER.adoc — packaging, deploying, and maintaining
3-
// Replace rsr-template-repo, {{PACKAGE_NAME}}, {{DEPS}} with actuals
3+
// Replace rsr-template-repo, patch-bridge, {{DEPS}} with actuals
44
= rsr-template-repo — Quick Start for Platform Maintainers
55
:toc:
66
:toclevels: 2
@@ -65,10 +65,10 @@ Files installed:
6565
| `$PREFIX/bin/`
6666
| Executables
6767

68-
| `$PREFIX/share/{{PACKAGE_NAME}}/`
68+
| `$PREFIX/share/patch-bridge/`
6969
| Data files, assets
7070

71-
| `$PREFIX/share/doc/{{PACKAGE_NAME}}/`
71+
| `$PREFIX/share/doc/patch-bridge/`
7272
| Documentation
7373

7474
| `$PREFIX/share/applications/`
@@ -80,9 +80,9 @@ Files installed:
8080

8181
== Configuration
8282

83-
Default config location: `$XDG_CONFIG_HOME/{{PACKAGE_NAME}}/config.toml`
83+
Default config location: `$XDG_CONFIG_HOME/patch-bridge/config.toml`
8484

85-
Fallback: `$HOME/.config/{{PACKAGE_NAME}}/config.toml`
85+
Fallback: `$HOME/.config/patch-bridge/config.toml`
8686

8787
== Health Checks
8888

@@ -102,7 +102,7 @@ just build-release
102102
just install --prefix=/usr/local
103103
----
104104

105-
Or via OPSM: `opsm update {{PACKAGE_NAME}}`
105+
Or via OPSM: `opsm update patch-bridge`
106106

107107
== Security Notes
108108

@@ -117,8 +117,8 @@ For deploying multiple instances (e.g., different users or tenants):
117117

118118
[source,bash]
119119
----
120-
just install --prefix=/opt/{{PACKAGE_NAME}}-instance1 --config=/etc/{{PACKAGE_NAME}}/instance1.toml
121-
just install --prefix=/opt/{{PACKAGE_NAME}}-instance2 --config=/etc/{{PACKAGE_NAME}}/instance2.toml
120+
just install --prefix=/opt/patch-bridge-instance1 --config=/etc/patch-bridge/instance1.toml
121+
just install --prefix=/opt/patch-bridge-instance2 --config=/etc/patch-bridge/instance2.toml
122122
----
123123

124124
Each instance has isolated config, data, and logs.

0 commit comments

Comments
 (0)