Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions .github/CODE_OF_CONDUCT.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,9 @@ Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
TEMPLATE INSTRUCTIONS (delete this block before publishing)
============================================================================
Replace all {{PLACEHOLDER}} values:
rsr-template-repo - Your project name
CoprocessorRuntime.jl - Your project name
hyperpolymath - GitHub/GitLab username or org
rsr-template-repo - Repository name
CoprocessorRuntime.jl - Repository name
j.d.a.jewell@open.ac.uk - Email for conduct reports
Jonathan D.A. Jewell - Name of conduct team/committee
7 days - Initial response SLA (e.g., 48 hours)
Expand All @@ -26,7 +26,7 @@ Review and customise:

## Our Pledge

We as members, contributors, and leaders pledge to make participation in rsr-template-repo a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, colour, religion, or sexual identity and orientation.
We as members, contributors, and leaders pledge to make participation in CoprocessorRuntime.jl a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, colour, religion, or sexual identity and orientation.

We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.

Expand Down Expand Up @@ -321,7 +321,7 @@ We thank these communities for their leadership in creating welcoming spaces.

If you have questions about this Code of Conduct:

- Open a [Discussion](https://github.com/hyperpolymath/rsr-template-repo/discussions) (for general questions)
- Open a [Discussion](https://github.com/hyperpolymath/CoprocessorRuntime.jl/discussions) (for general questions)
- Email j.d.a.jewell@open.ac.uk (for private questions)
- Contact any maintainer directly

Expand Down
16 changes: 8 additions & 8 deletions .github/CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,15 +4,15 @@ Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
-->
```
# Clone the repository
git clone https://github.com/hyperpolymath/rsr-template-repo.git
cd rsr-template-repo
git clone https://github.com/hyperpolymath/CoprocessorRuntime.jl.git
cd CoprocessorRuntime.jl

# Using Guix (recommended for reproducibility)
guix shell -D -f build/guix.scm

# Or using toolbox/distrobox
toolbox create rsr-template-repo-dev
toolbox enter rsr-template-repo-dev
toolbox create CoprocessorRuntime.jl-dev
toolbox enter CoprocessorRuntime.jl-dev
# Install dependencies manually

# Verify setup
Expand Down Expand Up @@ -72,10 +72,10 @@ Use the [feature request template](.github/ISSUE_TEMPLATE/feature_request.md) an

Look for issues labelled:

- [`good first issue`](https://github.com/hyperpolymath/rsr-template-repo/labels/good%20first%20issue) — Simple Perimeter 3 tasks
- [`help wanted`](https://github.com/hyperpolymath/rsr-template-repo/labels/help%20wanted) — Community help needed
- [`documentation`](https://github.com/hyperpolymath/rsr-template-repo/labels/documentation) — Docs improvements
- [`perimeter-3`](https://github.com/hyperpolymath/rsr-template-repo/labels/perimeter-3) — Community sandbox scope
- [`good first issue`](https://github.com/hyperpolymath/CoprocessorRuntime.jl/labels/good%20first%20issue) — Simple Perimeter 3 tasks
- [`help wanted`](https://github.com/hyperpolymath/CoprocessorRuntime.jl/labels/help%20wanted) — Community help needed
- [`documentation`](https://github.com/hyperpolymath/CoprocessorRuntime.jl/labels/documentation) — Docs improvements
- [`perimeter-3`](https://github.com/hyperpolymath/CoprocessorRuntime.jl/labels/perimeter-3) — Community sandbox scope

---

Expand Down
16 changes: 8 additions & 8 deletions .github/SECURITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ We take security seriously. We appreciate your efforts to responsibly disclose v

The preferred method for reporting security vulnerabilities is through GitHub's Security Advisory feature:

1. Navigate to [Report a Vulnerability](https://github.com/hyperpolymath/rsr-template-repo/security/advisories/new)
1. Navigate to [Report a Vulnerability](https://github.com/hyperpolymath/CoprocessorRuntime.jl/security/advisories/new)
2. Click **"Report a vulnerability"**
3. Complete the form with as much detail as possible
4. Submit — we'll receive a private notification
Expand Down Expand Up @@ -187,7 +187,7 @@ If we cannot reach agreement on disclosure timing, we default to 90 days from yo

The following are within scope for security research:

- This repository (`hyperpolymath/rsr-template-repo`) and all its code
- This repository (`hyperpolymath/CoprocessorRuntime.jl`) and all its code
- Official releases and packages published from this repository
- Documentation that could lead to security issues
- Build and deployment configurations in this repository
Expand Down Expand Up @@ -306,7 +306,7 @@ Recognition includes:
To stay informed about security updates:

- **Watch this repository**: Click "Watch" → "Custom" → Select "Security alerts"
- **GitHub Security Advisories**: Published at [Security Advisories](https://github.com/hyperpolymath/rsr-template-repo/security/advisories)
- **GitHub Security Advisories**: Published at [Security Advisories](https://github.com/hyperpolymath/CoprocessorRuntime.jl/security/advisories)
- **Release notes**: Security fixes noted in [CHANGELOG](../CHANGELOG.md)

### Update Policy
Expand All @@ -332,7 +332,7 @@ To stay informed about security updates:

## Security Best Practices

When using rsr-template-repo, we recommend:
When using CoprocessorRuntime.jl, we recommend:

### General

Expand All @@ -354,7 +354,7 @@ When using rsr-template-repo, we recommend:

## Additional Resources

- [Security Advisories](https://github.com/hyperpolymath/rsr-template-repo/security/advisories)
- [Security Advisories](https://github.com/hyperpolymath/CoprocessorRuntime.jl/security/advisories)
- [Changelog](../CHANGELOG.md)
- [Contributing Guidelines](CONTRIBUTING.md)
- [CVE Database](https://cve.mitre.org/)
Expand All @@ -366,8 +366,8 @@ When using rsr-template-repo, we recommend:

| Purpose | Contact |
|---------|---------|
| **Security issues** | [Report via GitHub](https://github.com/hyperpolymath/rsr-template-repo/security/advisories/new) or j.d.a.jewell@open.ac.uk |
| **General questions** | [GitHub Discussions](https://github.com/hyperpolymath/rsr-template-repo/discussions) |
| **Security issues** | [Report via GitHub](https://github.com/hyperpolymath/CoprocessorRuntime.jl/security/advisories/new) or j.d.a.jewell@open.ac.uk |
| **General questions** | [GitHub Discussions](https://github.com/hyperpolymath/CoprocessorRuntime.jl/discussions) |
| **Other enquiries** | See [README](../README.adoc) for contact information |

---
Expand All @@ -382,7 +382,7 @@ This security policy may be updated from time to time. Significant changes will

---

*Thank you for helping keep rsr-template-repo and its users safe.* 🛡️
*Thank you for helping keep CoprocessorRuntime.jl and its users safe.* 🛡️

---

Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/sonarqube.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
# SonarQube Cloud (SonarCloud) static analysis. Analysis scope + exclusions live
# in sonar-project.properties. Requires the SONAR_TOKEN repository secret
# (Settings -> Secrets and variables -> Actions) and a SonarCloud project:
# https://sonarcloud.io/project/overview?id=hyperpolymath_rsr-template-repo
# https://sonarcloud.io/project/overview?id=hyperpolymath_CoprocessorRuntime.jl
# Mirrors the boj-server arrangement.
#
# WHY THE TOKEN GUARD (added 2026-07-28)
Expand Down
1 change: 0 additions & 1 deletion .machine_readable/ai/AI.a2ml
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,6 @@
# AI Assistant Instructions

## Repository Focus
- `rsr-template-repo` is treated as a Rhodium Standard Repository; obey the Rhodium policies and keep `.machine_readable/` authoritative.
- All machine-readable content lives under `.machine_readable/` — state files (a2ml), bot directives, and contractiles.
- Prefer to keep generated files out of source control, and regenerate them with the documented commands before committing.

Expand Down
34 changes: 23 additions & 11 deletions .machine_readable/arrival-pack/README.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -10,27 +10,32 @@ the repo's own machine-readable truth.

[source]
----
a2ml (descriptiles) extract.sh arrival-pack.ncl CLAUDE.md
CLADE/ECOSYSTEM/ ──▶ (a2ml → JSON, ──▶ (Nickel projection ──▶ region between
AGENTIC/STATE/ANCHOR the thin reader) = the engine) BEGIN/END markers
<repo>_chora.deed extract.sh arrival-pack.ncl CLAUDE.md
(incl. its (anchor (deed → JSON, (Nickel projection region between
(golden-path))) ──▶ the thin reader) ──▶ = the engine) ──▶ BEGIN/END markers
----

Two halves of the generated region:

* *Estate-common* — identical in every repo; the Manifesto doctrine + format-family
orientation + canon pointers + language policy. Pinned to a Manifesto SHA once
orientation + canon pointers + language policy + the proof guidance (which
prover for which obligation; moved in from hand-authored text on 2026-11-15
so a wording fix reaches every repo by regenerating). Pinned to a Manifesto SHA once
the wording is ratified (today: `DRAFT-unratified`).
* *Repo-specific* — projected from this repo's a2ml: identity, IS / IS-NOT,
* *Repo-specific* — projected from this repo's deed: identity, IS / IS-NOT,
position, constraints, golden path, state.

The a2ml files remain the single source of truth. CLAUDE.md is a *view*. Content
The repo deed (`<repo>_chora.deed`) is the single source of truth; it took
over the former CLADE / ECOSYSTEM / AGENTIC / STATE records (rsr-template-repo#209), and
`extract.sh` reads it through `scripts/deed-field.sh`. The golden path
comes from its `(anchor (golden-path))` clause. CLAUDE.md is a *view*. Content
outside the `ARRIVAL-PACK:BEGIN/END` markers is hand-authorable and preserved.

== Files

[cols="1,3"]
|===
| `extract.sh` | a2ml reader → deterministic `claude-md-data.json` (build artifact, git-ignored)
| `extract.sh` | deed reader → deterministic `claude-md-data.json` (build artifact, git-ignored)
| `arrival-pack.ncl` | Nickel projection engine → the region string (`nickel export --format raw`)
| `generate.sh` | orchestrator: extract → render → splice (Hunt-tier, writes CLAUDE.md)
| `verify.sh` | drift check: regenerate + byte-compare committed region (Yard-tier)
Expand All @@ -41,15 +46,22 @@ outside the `ARRIVAL-PACK:BEGIN/END` markers is hand-authorable and preserved.

[source,console]
----
just claude-md # (re)generate CLAUDE.md from a2ml
just claude-md # (re)generate CLAUDE.md from the repo deed
just validate-claude-md # fail if the committed region drifted / was hand-edited
----

== Status / TODO

* Estate-common doctrine is a *DRAFT* in the agent's words — owner to ratify into
his voice, then pin to a `hyperpolymath/manifesto` commit SHA.
* `ECOSYSTEM.what-this-is-not` is empty here, so IS-NOT renders as "not yet
declared". Populating it is the boundary-erosion fix (the `lith` lesson).
* `ANCHOR.a2ml` currently encodes semantic-authority + golden-path; the
* IS-NOT comes from the deed's `(ecosystem :not (…))`. When that list is empty,
IS-NOT renders as "not yet declared" and the deed should gain the list (the
boundary-erosion fix, the `lith` lesson).
* A repo's `(anchor (implementation-policy …))` renders as one "Anchor
override" line in the repo-specific part: what `:forbidden` lists, and any
language `:allowed` lists that the estate policy denies. An allowed language
the estate does not deny is no override and is not listed. The line is
hidden when there is neither. Controls:
`tests/workflows/arrival_pack_anchor_override_test.sh`.
* The `(anchor)` clause currently encodes semantic-authority + golden-path; the
recognised-drift / re-anchor-ledger aspect is a pending standards change.
Loading
Loading