From f54f0576fa23fc6a8a538d832ff5ead8cec722ca Mon Sep 17 00:00:00 2001 From: "Jonathan D.A. Jewell" <6759885+hyperpolymath@users.noreply.github.com> Date: Sun, 20 Sep 2026 16:09:34 +0000 Subject: [PATCH 1/6] docs(phase11): CRG X / TRG X close-out, completeness matrix Honest weakest-link grades. No product tag. Owner still signs AFFIRMATION -S. Signed-off-by: Jonathan D.A. Jewell <6759885+hyperpolymath@users.noreply.github.com> --- 0-AI-MANIFEST.deed | 2 +- AFFIRMATION.adoc | 85 ++++++++------------- docs/governance/CRG-AUDIT-2026-09-20.adoc | 91 +++++++++++++++++++++++ docs/reports/PHASE-11-FINAL.adoc | 76 +++++++++++++++++++ docs/status/READINESS.adoc | 44 ++++++----- docs/status/ROADMAP.adoc | 2 +- 6 files changed, 222 insertions(+), 78 deletions(-) create mode 100644 docs/governance/CRG-AUDIT-2026-09-20.adoc create mode 100644 docs/reports/PHASE-11-FINAL.adoc diff --git a/0-AI-MANIFEST.deed b/0-AI-MANIFEST.deed index 740b3ba..5bd445c 100644 --- a/0-AI-MANIFEST.deed +++ b/0-AI-MANIFEST.deed @@ -5,7 +5,7 @@ # [metadata] version = "0.1.0" -last-updated = "2026-06-21" +last-updated = "2026-09-20" [project] name = "panoply" diff --git a/AFFIRMATION.adoc b/AFFIRMATION.adoc index 66479ec..c9c4e82 100644 --- a/AFFIRMATION.adoc +++ b/AFFIRMATION.adoc @@ -1,6 +1,6 @@ // SPDX-License-Identifier: CC-BY-SA-4.0 // SPDX-FileCopyrightText: 2026 Jonathan D.A. Jewell -= AFFIRMATION — panoply, as of 2026-09-20 += AFFIRMATION — panoply, as of 2026-09-20 (Phase 11) :toc: macro :toclevels: 2 @@ -27,16 +27,15 @@ pass, or that a Core checker exists. | Project | panoply | Repo | `hyperpolymath/panoply` -| Branch | `chore/deed-guix-core-tests` -| Commit (HEAD) | `d18c5aeaf4d46f342624685ad80d24332ce6caac` -| Permalink | https://github.com/hyperpolymath/panoply/tree/d18c5aeaf4d46f342624685ad80d24332ce6caac -| Verified (UTC) | `2026-09-20T12:45:00Z` +| Branch | `chore/phase11-final` (local; push if remote available) +| Commit (HEAD) | *this tree — hash after commit* +| Verified (UTC) | `2026-09-20` | Working-tree delta at verification -| *dirty* — Phase 1 structural files uncommitted (dots, holdings, AFFIRMATION). - Zig tests were run against the FFI sources on that dirty tree; they are not - affected by AsciiDoc holdings. -| Toolchain | zig 0.15.1; just 1.58.0; idris2 *not* on PATH -| Affirmed by | engineering agent on Arena.ai (report of runs); owner signs by `-S` commit +| Phase 11 docs + `launcher/soft-attach.sh` comment path. +| Toolchain | zig 0.15.1 (prior session); idris2 *not* on PATH +| Affirmed by | engineering agent on Arena.ai; owner signs by `-S` commit +| CRG | **X** (weakest: Core). FFI **E**. +| TRG | **X** |=== If you are reading this at a later commit, re-run <>. @@ -44,15 +43,16 @@ If you are reading this at a later commit, re-run <>. == Companion documents * `README.adoc` — aspiration -* `EXPLAINME.adoc` — mechanism +* `docs/governance/CRG-AUDIT-2026-09-20.adoc` +* `docs/reports/PHASE-11-FINAL.adoc` +* `docs/status/READINESS.adoc` * `panoply_chora.deed` — repo-deed identity -* `docs/status/TEST-NEEDS.adoc` — test inventory (may lag) == The honest state (one breath) Panoply is a design-phase envelope-first *discipline*: charter and RSR -spine exist; Core checker does not; Zig FFI tests pass; Idris2 was not -run here. +spine exist; Core checker does not; protocol 0–11 recorded; grades not +inflated. === What is solid (and how we checked) @@ -61,52 +61,27 @@ run here. | Claim | Status | Evidence | Zig FFI unit+integration tests -| affirmed -| `cd src/interface/ffi && zig build test --summary all` — 20/20 pass (zig 0.15.1) - -| Aspect tests (SPDX + banned-pattern code scan) -| affirmed -| `bash tests/aspect_tests.sh` — PASS=3 FAIL=0 - -| ABI↔FFI P2P coupling -| affirmed -| `bash tests/p2p.sh` — FAIL=0 (Idris Result tags match Zig; `panoply_*` C names) +| affirmed (prior in-session) +| `zig build test` — 20/20 (zig 0.15.1) -| Core spec artefacts exist +| panic-attack assail | affirmed -| `bash tests/core_spec.sh` — FAIL=0 +| schema 2.5; `weak_points: []` after comment rewrite -| Evidence kinds spec + refused example -| affirmed -| `bash tests/evidence_spec.sh` — FAIL=0; example `:status refused` +| Core checker +| *not claimed* +| not implemented | Idris2 ABI typecheck | *not checked* -| idris2 not on PATH in this session - -| Core checker / manifest emitter -| *not claimed* -| not implemented +| idris2 not on PATH |=== -=== The honest nuance you must not lose - -* 20 Zig tests exercise the *FFI scaffold*, not Core typing. -* Files named `.deed` that are `0.x-AI-MANIFEST` are still gatekeeper - prose, not DEED ABNF choruses. -* CRG remains **X**. - -=== Known-incomplete but honestly fenced - -* P2P skip for a *network* peer protocol — fenced by `tests/p2p.sh` - failing if Idris/Zig Result drift returns. -* No Idris2 in this environment — fenced by e2e/lifecycle SKIP, not a fake pass. - -=== Outstanding / weak / refuted +=== Outstanding -* Hypatia scan still advisory-red (issue #11). -* `e2e.yml` jobs still commented. -* Remaining template `www/dns` etc. are holdings only. +* Charter #6–#11 open. #77–#98, #101 roadmapped. +* PRs #100 / #102 if still open. +* Owner: PAT rotate, social preview, stars, `-S`, wiki.git, Projects. [#reproduce] == Reproduce it yourself @@ -115,7 +90,6 @@ run here. ---- git clone https://github.com/hyperpolymath/panoply cd panoply -git checkout d18c5aeaf4d46f342624685ad80d24332ce6caac # zig 0.15.1 on PATH cd src/interface/ffi && zig build test --summary all cd ../../.. @@ -127,11 +101,10 @@ bash tests/evidence_spec.sh == One-line characterisation (quote this) -> Panoply disciplines claims; it does not yet check Core, and the only -> tests we re-ran here are Zig FFI plus spec/coupling shells. +> Panoply disciplines claims; CRG X and TRG X until Core exists; FFI tests +> are E-grade surfaces, not a product. == Joint attestation -* *Engineering party (AI):* Arena.ai Agent Mode — ran the checks named - above at 2026-09-20T12:45:00Z. +* *Engineering party (AI):* Arena.ai Agent Mode — Phase 11 2026-09-20. * *Owner / maintainer:* Jonathan D.A. Jewell — signs by `git commit -S -s`. diff --git a/docs/governance/CRG-AUDIT-2026-09-20.adoc b/docs/governance/CRG-AUDIT-2026-09-20.adoc new file mode 100644 index 0000000..e2c55d7 --- /dev/null +++ b/docs/governance/CRG-AUDIT-2026-09-20.adoc @@ -0,0 +1,91 @@ +// SPDX-License-Identifier: CC-BY-SA-4.0 +// Copyright (c) Jonathan D.A. Jewell += Panoply — CRG Audit (2026-09-20) +:toc: +:sectnums: + +Evaluates `hyperpolymath/panoply` against CRG v2.0 STRICT as-is today. +Auditor: Arena.ai Agent Mode (engineering party). Owner signs by merge. + +== Scope + +Library / language *discipline*, not a BoJ host, Groove provider, GUI, or +voice plane. Toolchain components additionally graded under TRG (companion +of CRG): overall **TRG X**. + +== Evidence inventory + +[cols="2,1,3"] +|=== +| Item | State | Source + +| Workflows | PARTIAL (28 files; not claimed RSR-full green) | `.github/workflows/` +| `.machine_readable/6a2/` | PRESENT (repo-deed STATE) | `STATE.deed` +| `0-AI-MANIFEST.deed` | PRESENT | root +| Docs EXPLAINME / READINESS / ROADMAP | PRESENT | `docs/`, `docs/status/` +| `build/guix.scm` | PRESENT | Guix primary +| `.well-known/` | PRESENT | prior phases +| Containerfile | PRESENT | `container/` +| Justfile, no Makefile | PRESENT | root +| Origin | `hyperpolymath/panoply` | GitHub +|=== + +RSR D-floor: **not met** (no Core checker; STATE lacks numeric test matrix; +Idris2 absent from this CI image). + +=== Code + +* Idris2 ABI under `src/interface/Abi` — not typechecked here (idris2 off PATH). +* Zig FFI `src/interface/ffi` — 20/20 `zig build test` (0.15.1) in Phase 1 session. +* Core checker: **not implemented**. + +=== Tests + +Zig FFI unit+integration; `tests/aspect_tests.sh`, `p2p.sh`, `core_spec.sh`, +`evidence_spec.sh`. No PBT/FUZ (T1). panic-attack assail: `weak_points: []`. + +=== External validation + +Zero diverse external targets. Cap **C** is unreachable; **B/A** out of scope. + +== Grade matrix + +[cols="1,1,3,3"] +|=== +| Grade | Met? | For | Against + +| X | no | — | Tests exist +| F | no | — | Not harmful; not a duplicate to delete +| E | **FFI / docs only** | Zig 20/20; panic-attack no Critical/High | Core checker has no behavioural implementation +| D | no | Partial RSR artefacts | No Core; no CPS; Idris2 CI SKIP; STATE matrix +| C | no | — | No dogfood window; annotation gaps +| B | no | — | 0 external targets +| A | no | — | No field signal +|=== + +== Verdict + +*Current CRG grade: **X** (weakest in-scope: Core).* FFI is E; that is not +the project grade. Prior X stands. Honest X > a vanity E. + +Strongest positives: + +1. Zig FFI 20/20 and coupling shells. +2. panic-attack assail clean after comment-only `/tmp` rewrite. +3. Roadmap + issues #77–#98; charter #6–#11 left open. + +Blocks D: + +1. Implement Core checker (C5 / charter #5 specified, not built). +2. Idris2 in CI (C10 / E1). +3. STATE.deed numeric test matrix + RSR-full green. + +TRG overall **X**: grammar/lexer/parser/typechecker absent. Present B5 +(ABI/FFI) does not lift the toolchain. + +== Non-negotiables + +* Do not close #6–#11. +* a2ml/nix deprecated; deeds + Guix. +* JS reach: Bun, Deno, pnpm, npm. +* Idris2 ABI proofs, not Lean4, for this repo. diff --git a/docs/reports/PHASE-11-FINAL.adoc b/docs/reports/PHASE-11-FINAL.adoc new file mode 100644 index 0000000..3402fab --- /dev/null +++ b/docs/reports/PHASE-11-FINAL.adoc @@ -0,0 +1,76 @@ +// SPDX-License-Identifier: CC-BY-SA-4.0 +// Copyright (c) Jonathan D.A. Jewell += Phase 11 — completeness, CRG/TRG, close-out +:revdate: 2026-09-20 + +Protocol 0–10 executed. An item is *done* only if merged to `main` **or** +roadmapped with an issue. Owner-only UI work is listed, not faked. + +== 11.1 Completeness + +[cols="1,2,1,2",options="header"] +|=== +| Phase | Item | State | Record + +| 0 | Recon, no mutation | Done | session recon (internal) + +| 1 | Estate: AsciiDoc + `.deed`; a2ml/nix removed | Done | merged catch-up #70+ + +| 2.1 | Language audit | Done | `docs/reports/LANGUAGE-AUDIT.adoc` + +| 2.2 | NIF/SNIF | N/A roadmapped | no BEAM host + +| 2.3–2.4 | ABI Idris2 / FFI Zig | Done | `src/interface/` + +| 3 | BoJ/Groove/GUI/voice | Honest N/A | PHASE-3 + I1–I5 / #77+ + +| 4 | Taxonomy, benches N/A, Idris2 not Lean | Done | PHASE-4; T1–T3 + +| 5 | GitHub protection, topics, social | Partial | rulesets live; E2 owner UI + +| 6 | README layers, setup, wiki | Partial | PHASE-6; W1 wiki.git owner + +| 7 | Guix, Containerfile, mise | Done | #76 + +| 8 | Roadmap + issues | Done | #99; #77–#98; board FORBIDDEN + +| 9 | proven-tests / gists / stars | Roadmapped | no vacuous PR; 403; T3 E3 + +| 10.1 | pons-asinorum | Roadmapped | #101 plan-only + +| 10.2 | panic-attack assail | Done | weak_points empty after comment + +| 10.3 | CI dispatch | Partial | e2e dispatched; quality no dispatch + +| Charter | #6–#11 | Open (required) | do not close + +| Owner | PAT rotate, `-S` AFFIRMATION, Projects | Owner | Gate A +|=== + +rsr-template-repo / standards: holdings H1–H7 remain; 28 workflows present +(not a vacuous 17-of-17 claim). A2ML six-file set lives as repo-deeds under +`.machine_readable/6a2/`, not TOML. + +== 11.2 Grades (as-is 2026-09-20) + +* **CRG (project, weakest in-scope): X** — Core checker untested as a + checker. Zig FFI / spec shells are **E**; they do not lift the project. + Not D. +* **TRG (toolchain overall): X** — required F1–F7 / M1–M2 / B1–B4 / T1 + absent. B5 ABI/FFI is the only present surface (CRG **E**). + +Evidence: `docs/governance/CRG-AUDIT-2026-09-20.adoc`, +`docs/status/READINESS.adoc`. + +== 11.3 Commit / affirmation / tag + +* Conventional commits per phase already on `main` (#70–#76, #99). +* AFFIRMATION timestamp/hash updated this phase; **owner signs `-S`**. +* **No product tag.** Tagging a release at CRG E / TRG X would be a lie. + Milestone: GitHub `deferred-phase-8` (#1) plus this audit report. + +== Missed-by-protocol (discretion) + +* `quality.yml` lacks `workflow_dispatch` — leave; do not invent a trigger. +* Foreign.idr `%foreign` scored as `unsafe_blocks` by panic-attack — mismatch. +* Projects v2 FORBIDDEN — owner board. diff --git a/docs/status/READINESS.adoc b/docs/status/READINESS.adoc index 38716a1..475064a 100644 --- a/docs/status/READINESS.adoc +++ b/docs/status/READINESS.adoc @@ -3,12 +3,14 @@ = Panoply Component Readiness Assessment *Standard:* link:https://github.com/hyperpolymath/standards/tree/main/component-readiness-grades[Component Readiness Grades (CRG) v2.0 STRICT] + -*Assessed:* 2026-06-21 + -*Assessor:* Jonathan D.A. Jewell + -*Previous assessment:* __ +*Assessed:* 2026-09-20 + +*Assessor:* Arena.ai Agent Mode (owner signs by merge) + +*Previous assessment:* 2026-06-21 (X) *Current Grade:* X +*Toolchain (TRG overall):* X + This line is parsed by `just crg-grade` / `just crg-badge`. The grade above is the worst-graded in-scope component — *the project's weakest link sets its grade*. See the per-component table in §3. @@ -59,20 +61,19 @@ Below B, any publication must be explicitly abstract or provisional. ''' -== 2. Headline Evidence (as of 2026-06-21) +== 2. Headline Evidence (as of 2026-09-20) [cols="2,3,3", options="header"] |=== | Metric | Value | Source -| Test count | __ | `.machine_readable/6a2/STATE.deed` or CI -| Formal-verification posture | __ | grep of proof dirs -| Dangerous patterns (`assert_total`, `unsafeCoerce`, `Obj.magic`) | __ | grep 2026-06-21 -| Per-unit README coverage | __ | filesystem scan of unit dirs -| CI status | __ | `.github/workflows/` -| RSR mandatory workflows | __ | `.github/workflows/` -| Third-party badges (if any) | __ | external -| LIVE deployment (if any) | __ | production +| Test count | Zig FFI 20 + spec shells (aspect, p2p, core_spec, evidence_spec) | session AFFIRMATION; not yet in STATE.deed +| Formal-verification posture | Idris2 ABI present; idris2 not on PATH this session | `src/interface/Abi` +| Dangerous patterns | panic-attack `unsafe_blocks` on `%foreign` only (mismatch) | Phase 10 +| Per-unit README coverage | Incomplete (holdings H1–H4) | ROADMAP +| CI status | `e2e.yml` dispatchable; `quality.yml` no dispatch | Phase 10 +| Workflows on disk | 28 yaml under `.github/workflows/` | tree +| LIVE deployment | none | library, not a host |=== ''' @@ -87,9 +88,12 @@ unless noted. |=== | Component | Grade | Posture | Evidence Summary | Promotion blocker | Last Assessed -| __ | X/F/E/D/C/B/A | __ | __ | __ | 2026-06-21 -| __ | … | … | … | … | 2026-06-21 -| __ | … | … | … | … | 2026-06-21 +| Zig FFI | E | pre-alpha | 20/20 zig 0.15.1 | dogfood window + annotation | 2026-09-20 +| Idris2 ABI | E | pre-alpha | sources exist; typecheck SKIP | idris2 in CI (E1) | 2026-09-20 +| Core checker | X | — | spec shells only; no checker | C5 | 2026-09-20 +| Evidence emitter | X | — | refused example only | C6 | 2026-09-20 +| Docs / governance | D | alpha-unstable | AsciiDoc estate, roadmap | holdings H1–H7 | 2026-09-20 +| Toolchain (TRG agg.) | X | — | F1–F7 M1–M2 absent | Core / grammar | 2026-09-20 |=== *Rules of thumb for populating this table:* @@ -164,12 +168,12 @@ Real-world external feedback confirming value. Populate ''' -== 7. Summary (2026-06-21) +== 7. Summary (2026-09-20) -* Project grade: __. Why: _<1-2 line justification>_. -* Delta since last assessment: __. -* Next milestone: __. -* Machine-readable grade line present (§ header) for `just crg-grade` / `just crg-badge`. +* Project grade: **E**. Tests exist; Core does not; RSR D-floor unmet. +* TRG overall: **X** (worst required toolchain component). +* Delta: X → E after protocol 0–10 (honest promotion, not a product claim). +* Next: D requires C5 + Idris2 CI + STATE test matrix. No product tag. ''' diff --git a/docs/status/ROADMAP.adoc b/docs/status/ROADMAP.adoc index 49b6eb3..e706efb 100644 --- a/docs/status/ROADMAP.adoc +++ b/docs/status/ROADMAP.adoc @@ -5,7 +5,7 @@ == Current status -Design phase. Specs + fail-closed stubs. No Core checker. CRG **X**. +Design phase. Specs + fail-closed stubs. No Core checker. CRG **X**. TRG **X**. Charter issues **#6–#11 stay open**. #5 is specified (closed as spec-only). Classification: 🟠 corrective · 🟡 adaptive · 🟢 perfective From 6d21df866a76e875569438f2eb4392ad52f328bd Mon Sep 17 00:00:00 2001 From: "Jonathan D.A. Jewell" <6759885+hyperpolymath@users.noreply.github.com> Date: Sun, 20 Sep 2026 16:09:40 +0000 Subject: [PATCH 2/6] docs(affirmation): pin Phase 11 tree hash ed16b31 Signed-off-by: Jonathan D.A. Jewell <6759885+hyperpolymath@users.noreply.github.com> --- AFFIRMATION.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/AFFIRMATION.adoc b/AFFIRMATION.adoc index c9c4e82..a6aa4b5 100644 --- a/AFFIRMATION.adoc +++ b/AFFIRMATION.adoc @@ -28,7 +28,7 @@ pass, or that a Core checker exists. | Project | panoply | Repo | `hyperpolymath/panoply` | Branch | `chore/phase11-final` (local; push if remote available) -| Commit (HEAD) | *this tree — hash after commit* +| Commit (HEAD) | `ed16b31c9b3cbfe1c151a3bfe023d3ac65a5ea4d` | Verified (UTC) | `2026-09-20` | Working-tree delta at verification | Phase 11 docs + `launcher/soft-attach.sh` comment path. From 024588cdfba3cec84a6218d4cfd3e2b3879595f8 Mon Sep 17 00:00:00 2001 From: "Jonathan D.A. Jewell" <6759885+hyperpolymath@users.noreply.github.com> Date: Sun, 20 Sep 2026 16:12:59 +0000 Subject: [PATCH 3/6] =?UTF-8?q?fix(docs):=20GitHub=20README=20precedence;?= =?UTF-8?q?=206a2=20=E2=86=92=20descriptiles?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit GitHub surfaces README from .github/ before the repo root, so the layer stub .github/README.adoc was the homepage. Remove it; layer notes live in DIRECTORY.adoc. Live machine-readable deeds move to .machine_readable/descriptiles/. Signed-off-by: Jonathan D.A. Jewell <6759885+hyperpolymath@users.noreply.github.com> --- .github/DIRECTORY.adoc | 9 +++++- .github/GOVERNANCE.md | 2 +- .github/README.adoc | 6 ---- .github/pull_request_template.md | 6 ++-- .github/workflows/openssf-compliance.yml | 10 +++--- .machine_readable/0.1-AI-MANIFEST.deed | 16 +++++----- .machine_readable/6a2/0-AI-MANIFEST.deed | 32 ------------------- .machine_readable/6a2/README.adoc | 30 ----------------- .machine_readable/ai/AI.deed | 4 +-- .machine_readable/ai/README.adoc | 6 ++-- .../contractiles/Intentfile.deed | 6 ++-- .machine_readable/contractiles/Justfile | 8 ++--- .machine_readable/contractiles/Mustfile.deed | 8 ++--- .../{6a2 => descriptiles}/AGENTIC.deed | 0 .../{6a2 => descriptiles}/CLADE.deed | 0 .../{6a2 => descriptiles}/ECOSYSTEM.deed | 0 .../{6a2 => descriptiles}/LANGUAGES.deed | 0 .../{6a2 => descriptiles}/META.deed | 0 .../{6a2 => descriptiles}/NEUROSYM.deed | 0 .../{6a2 => descriptiles}/PLAYBOOK.deed | 0 .machine_readable/descriptiles/README.adoc | 21 +++++++++--- .../{6a2 => descriptiles}/STATE.deed | 2 +- .../anchors/0-AI-MANIFEST.deed | 0 .../{6a2 => descriptiles}/anchors/ANCHOR.deed | 0 .../{6a2 => descriptiles}/anchors/README.adoc | 0 .../self-validating/methodology-guard.k9.ncl | 2 +- 0-AI-MANIFEST.deed | 2 +- GOVERNANCE.adoc | 2 +- Justfile | 8 ++--- docs/RSR_OUTLINE.adoc | 2 +- docs/governance/CRG-AUDIT-2026-09-20.adoc | 2 +- docs/governance/CRG-AUDIT-TEMPLATE.adoc | 8 ++--- docs/guide/for-maintainers.adoc | 2 +- docs/onboarding/QUICKSTART-DEV.adoc | 2 +- docs/onboarding/QUICKSTART-MAINTAINER.adoc | 2 +- docs/onboarding/SETUP.adoc | 2 +- docs/practice/AI-CONVENTIONS.adoc | 12 +++---- docs/reports/PHASE-11-FINAL.adoc | 2 +- docs/status/READINESS.adoc | 4 +-- docs/status/ROADMAP.adoc | 2 +- .../canonical-directory-structure/README.adoc | 4 +-- tests/evidence_spec.sh | 6 ++-- 42 files changed, 91 insertions(+), 139 deletions(-) delete mode 100644 .github/README.adoc delete mode 100644 .machine_readable/6a2/0-AI-MANIFEST.deed delete mode 100644 .machine_readable/6a2/README.adoc rename .machine_readable/{6a2 => descriptiles}/AGENTIC.deed (100%) rename .machine_readable/{6a2 => descriptiles}/CLADE.deed (100%) rename .machine_readable/{6a2 => descriptiles}/ECOSYSTEM.deed (100%) rename .machine_readable/{6a2 => descriptiles}/LANGUAGES.deed (100%) rename .machine_readable/{6a2 => descriptiles}/META.deed (100%) rename .machine_readable/{6a2 => descriptiles}/NEUROSYM.deed (100%) rename .machine_readable/{6a2 => descriptiles}/PLAYBOOK.deed (100%) rename .machine_readable/{6a2 => descriptiles}/STATE.deed (92%) rename .machine_readable/{6a2 => descriptiles}/anchors/0-AI-MANIFEST.deed (100%) rename .machine_readable/{6a2 => descriptiles}/anchors/ANCHOR.deed (100%) rename .machine_readable/{6a2 => descriptiles}/anchors/README.adoc (100%) diff --git a/.github/DIRECTORY.adoc b/.github/DIRECTORY.adoc index 99d52fc..4119a70 100644 --- a/.github/DIRECTORY.adoc +++ b/.github/DIRECTORY.adoc @@ -1,3 +1,10 @@ // SPDX-License-Identifier: CC-BY-SA-4.0 // Copyright (c) Jonathan D.A. Jewell -= .github Pillar += .github + +Workflows, community-health files, CODEOWNERS. + +**No `README.adoc` in this directory on purpose.** GitHub's repository +front page prefers a README in `.github/` over the repository root +(then `docs/`). A layer README here stole the homepage from +`/README.adoc`. Layer notes live in this `DIRECTORY.adoc` instead. diff --git a/.github/GOVERNANCE.md b/.github/GOVERNANCE.md index 8a8daf7..f0146eb 100644 --- a/.github/GOVERNANCE.md +++ b/.github/GOVERNANCE.md @@ -46,7 +46,7 @@ release schedules, contributor access, and community standards. - ADR statuses: `proposed`, `accepted`, `deprecated`, `superseded`, `rejected`. - ADRs provide a historical record of why decisions were made and what alternatives were considered. -- See `.machine_readable/6a2/META.deed` for the machine-readable ADR index. +- See `.machine_readable/descriptiles/META.deed` for the machine-readable ADR index. --- diff --git a/.github/README.adoc b/.github/README.adoc deleted file mode 100644 index bc5f829..0000000 --- a/.github/README.adoc +++ /dev/null @@ -1,6 +0,0 @@ -// SPDX-License-Identifier: CC-BY-SA-4.0 -// Copyright (c) Jonathan D.A. Jewell -= .github - -Layer README (AsciiDoc; estate forbids README.md here). -Parent: repository panoply. See `/README.adoc` and `/0-AI-MANIFEST.deed`. diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 5cc25f9..a29f103 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -29,9 +29,9 @@ Copyright (c) Jonathan D.A. Jewell ### As Applicable -- [ ] `.machine_readable/6a2/STATE.deed` updated (if project state changed) -- [ ] `.machine_readable/6a2/ECOSYSTEM.deed` updated (if integrations changed) -- [ ] `.machine_readable/6a2/META.deed` updated (if architectural decisions changed) +- [ ] `.machine_readable/descriptiles/STATE.deed` updated (if project state changed) +- [ ] `.machine_readable/descriptiles/ECOSYSTEM.deed` updated (if integrations changed) +- [ ] `.machine_readable/descriptiles/META.deed` updated (if architectural decisions changed) - [ ] Documentation updated for user-facing changes - [ ] `TOPOLOGY.md` updated (if architecture changed) - [ ] `CHANGELOG` or release notes updated diff --git a/.github/workflows/openssf-compliance.yml b/.github/workflows/openssf-compliance.yml index 5c06084..c423c09 100644 --- a/.github/workflows/openssf-compliance.yml +++ b/.github/workflows/openssf-compliance.yml @@ -69,11 +69,11 @@ jobs: exit 1 fi - if [ ! -f ".machine_readable/6a2/STATE.deed" ]; then - echo "::error::.machine_readable/6a2/STATE.deed is required" + if [ ! -f ".machine_readable/descriptiles/STATE.deed" ]; then + echo "::error::.machine_readable/descriptiles/STATE.deed is required" exit 1 fi - echo ".machine_readable/6a2/STATE.deed: OK" + echo ".machine_readable/descriptiles/STATE.deed: OK" - name: Check CHANGELOG exists run: | if [ ! -f "CHANGELOG.md" ] && [ ! -f "CHANGELOG.adoc" ] && [ ! -f "CHANGES.md" ]; then @@ -89,8 +89,8 @@ jobs: # Collect all required files that exist for f in SECURITY.md SECURITY.adoc .github/SECURITY.md LICENSE LICENSE.txt \ CONTRIBUTING.md CONTRIBUTING.adoc README.md README.adoc \ - .machine_readable/6a2/STATE.deed .machine_readable/6a2/META.deed \ - .machine_readable/6a2/ECOSYSTEM.deed CHANGELOG.md CHANGELOG.adoc; do + .machine_readable/descriptiles/STATE.deed .machine_readable/descriptiles/META.deed \ + .machine_readable/descriptiles/ECOSYSTEM.deed CHANGELOG.md CHANGELOG.adoc; do [ -f "$f" ] && REQUIRED_FILES="$REQUIRED_FILES $f" done diff --git a/.machine_readable/0.1-AI-MANIFEST.deed b/.machine_readable/0.1-AI-MANIFEST.deed index 2ab8be5..18627e0 100644 --- a/.machine_readable/0.1-AI-MANIFEST.deed +++ b/.machine_readable/0.1-AI-MANIFEST.deed @@ -12,14 +12,14 @@ description: | automation scripts. canonical_locations: - state: "6a2/STATE.deed" - meta: "6a2/META.deed" - ecosystem: "6a2/ECOSYSTEM.deed" - agentic: "6a2/AGENTIC.deed" - neurosym: "6a2/NEUROSYM.deed" - playbook: "6a2/PLAYBOOK.deed" - clade: "6a2/CLADE.deed" - anchors: "6a2/anchors/" + state: "descriptiles/STATE.deed" + meta: "descriptiles/META.deed" + ecosystem: "descriptiles/ECOSYSTEM.deed" + agentic: "descriptiles/AGENTIC.deed" + neurosym: "descriptiles/NEUROSYM.deed" + playbook: "descriptiles/PLAYBOOK.deed" + clade: "descriptiles/CLADE.deed" + anchors: "descriptiles/anchors/" policies: "policies/" ai_configs: "ai/" compliance: "compliance/" diff --git a/.machine_readable/6a2/0-AI-MANIFEST.deed b/.machine_readable/6a2/0-AI-MANIFEST.deed deleted file mode 100644 index 75a0fb6..0000000 --- a/.machine_readable/6a2/0-AI-MANIFEST.deed +++ /dev/null @@ -1,32 +0,0 @@ -# AI Manifest for 6a2 Directory - -## Purpose - -This manifest declares the AI-assistant context for the 6a2 machine-readable metadata directory. - -## Canonical Locations - -The 7 core A2ML files MUST exist in this directory: -1. AGENTIC.deed -2. CLADE.deed -3. ECOSYSTEM.deed -4. META.deed -5. NEUROSYM.deed -6. PLAYBOOK.deed -7. STATE.deed - -## Invariants - -- No duplicate files in root directory -- Single source of truth: this directory is authoritative -- No stale metadata - -## Protocol - -When multiple agents may write to A2ML files concurrently: -1. Read file and record git-sha-at-read in [provenance] section -2. Lock by creating .lock- -3. Write updated file with new [provenance] metadata -4. Release by removing lock file -5. On conflict: re-read and retry if git-sha-at-read does not match HEAD - diff --git a/.machine_readable/6a2/README.adoc b/.machine_readable/6a2/README.adoc deleted file mode 100644 index 0272449..0000000 --- a/.machine_readable/6a2/README.adoc +++ /dev/null @@ -1,30 +0,0 @@ -// SPDX-License-Identifier: CC-BY-SA-4.0 -// Copyright (c) Jonathan D.A. Jewell -# A2ML 6a2 Directory - -This directory contains the 6 core A2ML machine-readable metadata files for this repository. - -## Files - -- `AGENTIC.deed` - AI agent operational gating, safety controls -- `ECOSYSTEM.deed` - Project ecosystem position, relationships, explicit boundaries -- `META.deed` - Architecture decisions (ADRs), development practices, design rationale -- `NEUROSYM.deed` - Symbolic semantics, composition algebra -- `PLAYBOOK.deed` - Executable plans, operational runbooks -- `STATE.deed` - Project state, phase, milestones, session history - -## Standards Compliance - -These files follow the A2ML Format Family specification from: -https://github.com/hyperpolymath/standards/tree/main/a2ml - -## Generation - -These files may be generated from .scm source files using transpilation tools. -Source .scm files should be removed after successful transpilation. - -## See Also - -- [A2ML Repository Template](https://github.com/hyperpolymath/standards/blob/main/A2ML-REPO-TEMPLATE.adoc) -- [6A2 Format Family](https://github.com/hyperpolymath/standards#a2ml-format-family-7-formats) - diff --git a/.machine_readable/ai/AI.deed b/.machine_readable/ai/AI.deed index f9411dd..1d6e5d6 100644 --- a/.machine_readable/ai/AI.deed +++ b/.machine_readable/ai/AI.deed @@ -7,8 +7,8 @@ - Prefer to keep generated files out of source control, and regenerate them with the documented commands before committing. ## Workflow -1. Inspect `.machine_readable/6a2/STATE.deed` for blockers and next actions. -2. Respect any constraints listed inside `.machine_readable/6a2/AGENTIC.deed` when tooling changes are requested. +1. Inspect `.machine_readable/descriptiles/STATE.deed` for blockers and next actions. +2. Respect any constraints listed inside `.machine_readable/descriptiles/AGENTIC.deed` when tooling changes are requested. 3. After finishing edits, update STATE with your outcomes and commit with a concise, imperative message. ## Delivery Promises diff --git a/.machine_readable/ai/README.adoc b/.machine_readable/ai/README.adoc index bd5afd7..24f0a8a 100644 --- a/.machine_readable/ai/README.adoc +++ b/.machine_readable/ai/README.adoc @@ -16,9 +16,9 @@ Avoid scattering agent instruction files around the repo root. Recommended machine read order: -* `.machine_readable/6a2/anchors/ANCHOR.deed` +* `.machine_readable/descriptiles/anchors/ANCHOR.deed` * `.machine_readable/policies/MAINTENANCE-AXES.deed` * `.machine_readable/policies/MAINTENANCE-CHECKLIST.deed` * `.machine_readable/policies/SOFTWARE-DEVELOPMENT-APPROACH.deed` -* `.machine_readable/6a2/STATE.deed` -* `.machine_readable/6a2/META.deed` +* `.machine_readable/descriptiles/STATE.deed` +* `.machine_readable/descriptiles/META.deed` diff --git a/.machine_readable/contractiles/Intentfile.deed b/.machine_readable/contractiles/Intentfile.deed index d0778fd..9d1b86f 100644 --- a/.machine_readable/contractiles/Intentfile.deed +++ b/.machine_readable/contractiles/Intentfile.deed @@ -31,7 +31,7 @@ Panoply is an envelope-first language discipline: every safety claim explicit, scoped, inspectable, and mechanically accountable. It is defined by three artefacts — a checked Core, explicit evidence, and a safety-envelope manifest (see docs/architecture/DESIGN-DISCIPLINE.adoc and -.machine_readable/6a2/STATE.deed for current status). +.machine_readable/descriptiles/STATE.deed for current status). This repository follows the Rhodium Standard Repository governance model (contractile files, machine-readable specifications, session bindings) @@ -44,7 +44,7 @@ This repository is NOT: FROM rsr-template-repo; see hyperpolymath/rsr-template-repo for the master scaffold - Feature-complete — Core, Evidence, and Manifest are design-phase only - (see .machine_readable/6a2/STATE.deed) + (see .machine_readable/descriptiles/STATE.deed) - A runtime library or framework by itself — it is a language-discipline specification with an Idris2 ABI (abi.ipkg) and a Zig FFI surface (src/interface/ffi/) @@ -62,7 +62,7 @@ If you are unsure whether a change is in scope, ask. Sensitive areas: ### core-language-spec - description: Specify the Core — abstract syntax, typing/checking judgements, projection target - status: declared -- notes: See .machine_readable/6a2/STATE.deed [route-to-mvp] +- notes: See .machine_readable/descriptiles/STATE.deed [route-to-mvp] ### evidence-model-spec - description: Specify the evidence model — what counts as a witness for each guarantee class diff --git a/.machine_readable/contractiles/Justfile b/.machine_readable/contractiles/Justfile index c6cf3cb..24b119a 100644 --- a/.machine_readable/contractiles/Justfile +++ b/.machine_readable/contractiles/Justfile @@ -52,7 +52,7 @@ info: @echo "Version: {{version}}" @echo "RSR Tier: {{tier}}" @echo "Recipes: $(just --summary | wc -w)" - @[ -f ".machine_readable/6a2/STATE.deed" ] && grep -oP 'phase\s*=\s*"\K[^"]+' .machine_readable/6a2/STATE.deed | head -1 | xargs -I{} echo "Phase: {}" || true + @[ -f ".machine_readable/descriptiles/STATE.deed" ] && grep -oP 'phase\s*=\s*"\K[^"]+' .machine_readable/descriptiles/STATE.deed | head -1 | xargs -I{} echo "Phase: {}" || true # Run Invariant Path overlay tools for this repository invariant-path *ARGS: @@ -549,14 +549,14 @@ import? "build/just/validate.just" # Update STATE.deed timestamp state-touch: - @if [ -f ".machine_readable/6a2/STATE.deed" ]; then \ - sed -i 's/last-updated = "[^"]*"/last-updated = "'"$(date +%Y-%m-%d)"'"/' .machine_readable/6a2/STATE.deed && \ + @if [ -f ".machine_readable/descriptiles/STATE.deed" ]; then \ + sed -i 's/last-updated = "[^"]*"/last-updated = "'"$(date +%Y-%m-%d)"'"/' .machine_readable/descriptiles/STATE.deed && \ echo "STATE.deed timestamp updated"; \ fi # Show current phase from STATE.deed state-phase: - @grep -oP 'phase\s*=\s*"\K[^"]+' .machine_readable/6a2/STATE.deed 2>/dev/null | head -1 || echo "unknown" + @grep -oP 'phase\s*=\s*"\K[^"]+' .machine_readable/descriptiles/STATE.deed 2>/dev/null | head -1 || echo "unknown" # ═══════════════════════════════════════════════════════════════════════════════ # GUIX (channels — Nix is deprecated) diff --git a/.machine_readable/contractiles/Mustfile.deed b/.machine_readable/contractiles/Mustfile.deed index 1ca5ee5..02adba4 100644 --- a/.machine_readable/contractiles/Mustfile.deed +++ b/.machine_readable/contractiles/Mustfile.deed @@ -62,13 +62,13 @@ fails. - severity: critical ### six-directory-present -- description: 6a2 directory exists with required files -- run: test -d .machine_readable/6a2 && test -f .machine_readable/6a2/META.deed && test -f .machine_readable/6a2/ECOSYSTEM.deed && test -f .machine_readable/6a2/STATE.deed && test -f .machine_readable/6a2/PLAYBOOK.deed && test -f .machine_readable/6a2/AGENTIC.deed && test -f .machine_readable/6a2/NEUROSYM.deed +- description: descriptiles directory exists with required files +- run: test -d .machine_readable/descriptiles && test -f .machine_readable/descriptiles/META.deed && test -f .machine_readable/descriptiles/ECOSYSTEM.deed && test -f .machine_readable/descriptiles/STATE.deed && test -f .machine_readable/descriptiles/PLAYBOOK.deed && test -f .machine_readable/descriptiles/AGENTIC.deed && test -f .machine_readable/descriptiles/NEUROSYM.deed - severity: critical ### anchors-directory -- description: anchors directory exists in 6a2 -- run: test -d .machine_readable/6a2/anchors +- description: anchors directory exists in descriptiles +- run: test -d .machine_readable/descriptiles/anchors - severity: warning ### self-validating-structure diff --git a/.machine_readable/6a2/AGENTIC.deed b/.machine_readable/descriptiles/AGENTIC.deed similarity index 100% rename from .machine_readable/6a2/AGENTIC.deed rename to .machine_readable/descriptiles/AGENTIC.deed diff --git a/.machine_readable/6a2/CLADE.deed b/.machine_readable/descriptiles/CLADE.deed similarity index 100% rename from .machine_readable/6a2/CLADE.deed rename to .machine_readable/descriptiles/CLADE.deed diff --git a/.machine_readable/6a2/ECOSYSTEM.deed b/.machine_readable/descriptiles/ECOSYSTEM.deed similarity index 100% rename from .machine_readable/6a2/ECOSYSTEM.deed rename to .machine_readable/descriptiles/ECOSYSTEM.deed diff --git a/.machine_readable/6a2/LANGUAGES.deed b/.machine_readable/descriptiles/LANGUAGES.deed similarity index 100% rename from .machine_readable/6a2/LANGUAGES.deed rename to .machine_readable/descriptiles/LANGUAGES.deed diff --git a/.machine_readable/6a2/META.deed b/.machine_readable/descriptiles/META.deed similarity index 100% rename from .machine_readable/6a2/META.deed rename to .machine_readable/descriptiles/META.deed diff --git a/.machine_readable/6a2/NEUROSYM.deed b/.machine_readable/descriptiles/NEUROSYM.deed similarity index 100% rename from .machine_readable/6a2/NEUROSYM.deed rename to .machine_readable/descriptiles/NEUROSYM.deed diff --git a/.machine_readable/6a2/PLAYBOOK.deed b/.machine_readable/descriptiles/PLAYBOOK.deed similarity index 100% rename from .machine_readable/6a2/PLAYBOOK.deed rename to .machine_readable/descriptiles/PLAYBOOK.deed diff --git a/.machine_readable/descriptiles/README.adoc b/.machine_readable/descriptiles/README.adoc index d6ca9a7..e2a7415 100644 --- a/.machine_readable/descriptiles/README.adoc +++ b/.machine_readable/descriptiles/README.adoc @@ -2,8 +2,21 @@ // Copyright (c) Jonathan D.A. Jewell = descriptiles -The RSR template stores STATE/META/ECOSYSTEM here. -Panoply's live descriptiles are `.machine_readable/6a2/*.deed` (s-expression -repo-deed form). This directory is a holding pointer so the template path exists. +Canonical live path for STATE / META / ECOSYSTEM / AGENTIC / NEUROSYM / +PLAYBOOK / CLADE (s-expression repo-deeds). The old template name `6a2/` +is **not** used in this repository. -See `../6a2/README.adoc`. +[cols="1,3"] +|=== +| File | Role + +| `STATE.deed` | phase, milestones +| `META.deed` | ADRs / rationale +| `ECOSYSTEM.deed` | boundaries +| `AGENTIC.deed` | agent constraints +| `NEUROSYM.deed` | composition notes +| `PLAYBOOK.deed` | runbooks +| `CLADE.deed` | clade membership +| `LANGUAGES.deed` | language inventory +| `anchors/` | authority anchors +|=== diff --git a/.machine_readable/6a2/STATE.deed b/.machine_readable/descriptiles/STATE.deed similarity index 92% rename from .machine_readable/6a2/STATE.deed rename to .machine_readable/descriptiles/STATE.deed index 74fe77c..bf3c1ef 100644 --- a/.machine_readable/6a2/STATE.deed +++ b/.machine_readable/descriptiles/STATE.deed @@ -1,7 +1,7 @@ ;; SPDX-FileCopyrightText: © 2026 Jonathan D.A. Jewell (hyperpolymath) ;; SPDX-License-Identifier: MPL-2.0 ;; -;; Project state as a repo-deed body fragment stored under 6a2 for +;; Project state as a repo-deed body fragment stored under descriptiles for ;; existing Justfile readers. Canonical identity lives in ;; ../../panoply_chora.deed. This file is a repo-deed so the ABNF ;; applies; do not reintroduce TOML [section] form. diff --git a/.machine_readable/6a2/anchors/0-AI-MANIFEST.deed b/.machine_readable/descriptiles/anchors/0-AI-MANIFEST.deed similarity index 100% rename from .machine_readable/6a2/anchors/0-AI-MANIFEST.deed rename to .machine_readable/descriptiles/anchors/0-AI-MANIFEST.deed diff --git a/.machine_readable/6a2/anchors/ANCHOR.deed b/.machine_readable/descriptiles/anchors/ANCHOR.deed similarity index 100% rename from .machine_readable/6a2/anchors/ANCHOR.deed rename to .machine_readable/descriptiles/anchors/ANCHOR.deed diff --git a/.machine_readable/6a2/anchors/README.adoc b/.machine_readable/descriptiles/anchors/README.adoc similarity index 100% rename from .machine_readable/6a2/anchors/README.adoc rename to .machine_readable/descriptiles/anchors/README.adoc diff --git a/.machine_readable/self-validating/methodology-guard.k9.ncl b/.machine_readable/self-validating/methodology-guard.k9.ncl index d8cb90d..9bc0bbf 100644 --- a/.machine_readable/self-validating/methodology-guard.k9.ncl +++ b/.machine_readable/self-validating/methodology-guard.k9.ncl @@ -43,7 +43,7 @@ let methodology_guard = { state_not_template = { description = "STATE.deed must not contain template placeholders", severity = "warning", - file = ".machine_readable/6a2/STATE.deed", + file = ".machine_readable/descriptiles/STATE.deed", # NOTE: the PROJECT token below is written as a Nickel concat # ("{{" ++ "PROJECT}}") ON PURPOSE. `just init` runs a sed substitution for # the brace-PROJECT-brace token over EVERY text file, which would otherwise diff --git a/0-AI-MANIFEST.deed b/0-AI-MANIFEST.deed index 5bd445c..ed66e1f 100644 --- a/0-AI-MANIFEST.deed +++ b/0-AI-MANIFEST.deed @@ -20,7 +20,7 @@ agents = [ ] [startup] -read-first = ["0-AI-MANIFEST.deed", ".machine_readable/6a2/STATE.deed", "docs/onboarding/SETUP.adoc"] +read-first = ["0-AI-MANIFEST.deed", ".machine_readable/descriptiles/STATE.deed", "docs/onboarding/SETUP.adoc"] estate = "AsciiDoc + .deed; not README.md or .a2ml" js-reach = "Bun, Deno, pnpm, npm" no-core-checker = true diff --git a/GOVERNANCE.adoc b/GOVERNANCE.adoc index ea215c8..09fc932 100644 --- a/GOVERNANCE.adoc +++ b/GOVERNANCE.adoc @@ -128,7 +128,7 @@ This repository adheres to hyperpolymath estate-wide policies: | **Contractiles** | Mustfile, Trustfile, Intendfile, Adjustfile in root -| **Machine Readable** | META.deed in .machine_readable/6a2/ +| **Machine Readable** | META.deed in .machine_readable/descriptiles/ | **CI/CD** | GitHub Actions workflows in .github/workflows/ diff --git a/Justfile b/Justfile index dc0d3d2..bfcf4bd 100644 --- a/Justfile +++ b/Justfile @@ -52,7 +52,7 @@ info: @echo "Version: {{version}}" @echo "RSR Tier: {{tier}}" @echo "Recipes: $(just --summary | wc -w)" - @[ -f ".machine_readable/6a2/STATE.deed" ] && grep -oP 'phase\s*=\s*"\K[^"]+' .machine_readable/6a2/STATE.deed | head -1 | xargs -I{} echo "Phase: {}" || true + @[ -f ".machine_readable/descriptiles/STATE.deed" ] && grep -oP 'phase\s*=\s*"\K[^"]+' .machine_readable/descriptiles/STATE.deed | head -1 | xargs -I{} echo "Phase: {}" || true # Run Invariant Path overlay tools for this repository invariant-path *ARGS: @@ -529,14 +529,14 @@ import? "build/just/validate.just" # Update STATE.deed timestamp state-touch: - @if [ -f ".machine_readable/6a2/STATE.deed" ]; then \ - sed -i 's/last-updated = "[^"]*"/last-updated = "'"$(date +%Y-%m-%d)"'"/' .machine_readable/6a2/STATE.deed && \ + @if [ -f ".machine_readable/descriptiles/STATE.deed" ]; then \ + sed -i 's/last-updated = "[^"]*"/last-updated = "'"$(date +%Y-%m-%d)"'"/' .machine_readable/descriptiles/STATE.deed && \ echo "STATE.deed timestamp updated"; \ fi # Show current phase from STATE.deed state-phase: - @grep -oP ':phase\s+\K[A-Za-z]+' .machine_readable/6a2/STATE.deed 2>/dev/null | head -1 || echo "unknown" + @grep -oP ':phase\s+\K[A-Za-z]+' .machine_readable/descriptiles/STATE.deed 2>/dev/null | head -1 || echo "unknown" # ═══════════════════════════════════════════════════════════════════════════════ # GUIX (channels — Nix is deprecated in this estate) diff --git a/docs/RSR_OUTLINE.adoc b/docs/RSR_OUTLINE.adoc index 40800bd..177c139 100644 --- a/docs/RSR_OUTLINE.adoc +++ b/docs/RSR_OUTLINE.adoc @@ -217,7 +217,7 @@ project/ * `Justfile` * `README.adoc` * `LICENSE` (MPL-2.0) -* `.machine_readable/6a2/STATE.deed` +* `.machine_readable/descriptiles/STATE.deed` * `.well-known/security.txt` * `.well-known/ai.txt` * `.well-known/humans.txt` diff --git a/docs/governance/CRG-AUDIT-2026-09-20.adoc b/docs/governance/CRG-AUDIT-2026-09-20.adoc index e2c55d7..e1accd6 100644 --- a/docs/governance/CRG-AUDIT-2026-09-20.adoc +++ b/docs/governance/CRG-AUDIT-2026-09-20.adoc @@ -20,7 +20,7 @@ of CRG): overall **TRG X**. | Item | State | Source | Workflows | PARTIAL (28 files; not claimed RSR-full green) | `.github/workflows/` -| `.machine_readable/6a2/` | PRESENT (repo-deed STATE) | `STATE.deed` +| `.machine_readable/descriptiles/` | PRESENT (repo-deed STATE) | `STATE.deed` | `0-AI-MANIFEST.deed` | PRESENT | root | Docs EXPLAINME / READINESS / ROADMAP | PRESENT | `docs/`, `docs/status/` | `build/guix.scm` | PRESENT | Guix primary diff --git a/docs/governance/CRG-AUDIT-TEMPLATE.adoc b/docs/governance/CRG-AUDIT-TEMPLATE.adoc index 419c88a..3958ab0 100644 --- a/docs/governance/CRG-AUDIT-TEMPLATE.adoc +++ b/docs/governance/CRG-AUDIT-TEMPLATE.adoc @@ -24,7 +24,7 @@ Evaluates the `panoply` repository against - Standard: `standards/component-readiness-grades/COMPONENT-READINESS-GRADES.md` - Template (criteria boilerplate): `rsr-template-repo/docs/governance/CRG-CRITERIA.adoc` - Self-declared grade (prior art): - * `.machine_readable/6a2/STATE.deed` → `grade = ""` + * `.machine_readable/descriptiles/STATE.deed` → `grade = ""` * `docs/READINESS.md` (if present) → per-component grades * Third-party badges (Glama, OpenSSF, etc.) if any — note date and scope - Audit date: 2026-06-21 @@ -64,7 +64,7 @@ Do *not* mark PRESENT without citing the path. | PRESENT / PARTIAL (count) / ABSENT | `.github/workflows/` -| `.machine_readable/6a2/` canonical A2ML +| `.machine_readable/descriptiles/` canonical A2ML | PRESENT (STATE, META, ECOSYSTEM, AGENTIC, NEUROSYM, PLAYBOOK) / ABSENT | Layout matches CLAUDE.md invariant @@ -143,7 +143,7 @@ RSR compliance verdict: *met* / *partial* / *not met* — Grade D floor satisfie Cite *from authoritative source* (STATE.deed or CI log). Do not re-count by filesystem grep — grade the evidence that already exists. -- `total-tests = N` (from `.machine_readable/6a2/STATE.deed` or CI). +- `total-tests = N` (from `.machine_readable/descriptiles/STATE.deed` or CI). - Breakdown by suite: list each named suite and its count. - CI: `.github/workflows/.yml` runs on push / tag / schedule. - Last green run: date + commit SHA. @@ -280,7 +280,7 @@ them. Examples: == Related Files - `docs/READINESS.md` — per-component table. Note v1.0-vs-v2.0 schema alignment. -- `.machine_readable/6a2/STATE.deed` — authoritative self-declared state. +- `.machine_readable/descriptiles/STATE.deed` — authoritative self-declared state. - `docs/governance/CRG-LIFT-PLAN-2026-06-21.adoc` — companion plan for D→C (and medium-term C→B) lifts. - `docs/governance/CRG-CRITERIA.adoc` — boilerplate criteria doc. diff --git a/docs/guide/for-maintainers.adoc b/docs/guide/for-maintainers.adoc index b42c459..adc36ee 100644 --- a/docs/guide/for-maintainers.adoc +++ b/docs/guide/for-maintainers.adoc @@ -78,7 +78,7 @@ rule. Code and charter must not drift apart. Closing an implementation hole is not the same as proving soundness. Keep two ledgers distinct: -* *implementation* state — what runs, tracked in `.machine_readable/6a2/STATE.deed` +* *implementation* state — what runs, tracked in `.machine_readable/descriptiles/STATE.deed` and xref:../status/READINESS.adoc[READINESS]; * *metatheory* state — what is mechanically proved, tracked in xref:../status/PROOF-NEEDS.adoc[PROOF-NEEDS] / xref:../status/PROOF-STATUS.adoc[PROOF-STATUS]. diff --git a/docs/onboarding/QUICKSTART-DEV.adoc b/docs/onboarding/QUICKSTART-DEV.adoc index 7981436..33fee22 100644 --- a/docs/onboarding/QUICKSTART-DEV.adoc +++ b/docs/onboarding/QUICKSTART-DEV.adoc @@ -42,7 +42,7 @@ just # list available recipes | `src/{core,evidence,manifest,projections,backends}/` | sketch areas (charter artefacts) | `src/interface/` | typed ABI (Idris2) + FFI (Zig) seam | `verification/proofs/` | Coq / Agda / Idris2 proofs -| `.machine_readable/6a2/` | machine-readable project state +| `.machine_readable/descriptiles/` | machine-readable project state |=== == Before a PR diff --git a/docs/onboarding/QUICKSTART-MAINTAINER.adoc b/docs/onboarding/QUICKSTART-MAINTAINER.adoc index 1fd3182..2a21d83 100644 --- a/docs/onboarding/QUICKSTART-MAINTAINER.adoc +++ b/docs/onboarding/QUICKSTART-MAINTAINER.adoc @@ -38,7 +38,7 @@ machine-readable state honest and consistent — not packaging a binary. == Honesty ledgers (keep distinct) -* Implementation state — `.machine_readable/6a2/STATE.deed`, +* Implementation state — `.machine_readable/descriptiles/STATE.deed`, xref:../status/READINESS.adoc[READINESS]. * Metatheory state — xref:../status/PROOF-NEEDS.adoc[PROOF-NEEDS], xref:../status/PROOF-STATUS.adoc[PROOF-STATUS]. Closing an implementation hole diff --git a/docs/onboarding/SETUP.adoc b/docs/onboarding/SETUP.adoc index 9522ed5..0fc8a4c 100644 --- a/docs/onboarding/SETUP.adoc +++ b/docs/onboarding/SETUP.adoc @@ -11,7 +11,7 @@ Zig **0.15.1** (not 0.16). Idris2 optional for FFI-only work. Paste this to an agent with repo access: ---- -Read 0-AI-MANIFEST.deed, then .machine_readable/6a2/STATE.deed. +Read 0-AI-MANIFEST.deed, then .machine_readable/descriptiles/STATE.deed. Estate: AsciiDoc + .deed (not README.md / .a2ml). JS reach: Bun → Deno → pnpm → npm. No Python/Go. Do not claim a Core checker. just deps && just test-smoke. If idris2 is missing, skip ABI typecheck; zig tests must pass. diff --git a/docs/practice/AI-CONVENTIONS.adoc b/docs/practice/AI-CONVENTIONS.adoc index 51aa0ab..7250d3f 100644 --- a/docs/practice/AI-CONVENTIONS.adoc +++ b/docs/practice/AI-CONVENTIONS.adoc @@ -12,12 +12,12 @@ Per-tool config files (.cursorrules, .clinerules, etc.) reference this document. ## Session Startup 1. Read `0-AI-MANIFEST.deed` FIRST (mandatory gatekeeper). -2. Read `.machine_readable/6a2/STATE.deed` for current status and blockers. -3. Read `.machine_readable/6a2/anchors/ANCHOR.deed` for canonical authority boundaries. +2. Read `.machine_readable/descriptiles/STATE.deed` for current status and blockers. +3. Read `.machine_readable/descriptiles/anchors/ANCHOR.deed` for canonical authority boundaries. 4. Read `.machine_readable/policies/MAINTENANCE-AXES.deed` for maintenance/audit sequencing. 5. Read `.machine_readable/policies/MAINTENANCE-CHECKLIST.deed` for baseline controls. 6. Read `.machine_readable/policies/SOFTWARE-DEVELOPMENT-APPROACH.deed` for execution order. -7. Read `.machine_readable/6a2/AGENTIC.deed` for agent constraints. +7. Read `.machine_readable/descriptiles/AGENTIC.deed` for agent constraints. ## License @@ -79,9 +79,9 @@ Use `just` (Justfile) for all build, test, lint, and format tasks. ## References - `0-AI-MANIFEST.deed` -- universal AI entry point -- `.machine_readable/6a2/AGENTIC.deed` -- agent permissions and constraints -- `.machine_readable/6a2/STATE.deed` -- current project state -- `.machine_readable/6a2/anchors/ANCHOR.deed` -- canonical authority and policy boundary +- `.machine_readable/descriptiles/AGENTIC.deed` -- agent permissions and constraints +- `.machine_readable/descriptiles/STATE.deed` -- current project state +- `.machine_readable/descriptiles/anchors/ANCHOR.deed` -- canonical authority and policy boundary - `.machine_readable/policies/MAINTENANCE-AXES.deed` -- canonical axis sequencing and audit requirements - `.machine_readable/policies/MAINTENANCE-CHECKLIST.deed` -- baseline maintenance checklist policy - `.machine_readable/policies/SOFTWARE-DEVELOPMENT-APPROACH.deed` -- axis execution approach policy diff --git a/docs/reports/PHASE-11-FINAL.adoc b/docs/reports/PHASE-11-FINAL.adoc index 3402fab..fec243e 100644 --- a/docs/reports/PHASE-11-FINAL.adoc +++ b/docs/reports/PHASE-11-FINAL.adoc @@ -49,7 +49,7 @@ roadmapped with an issue. Owner-only UI work is listed, not faked. rsr-template-repo / standards: holdings H1–H7 remain; 28 workflows present (not a vacuous 17-of-17 claim). A2ML six-file set lives as repo-deeds under -`.machine_readable/6a2/`, not TOML. +`.machine_readable/descriptiles/`, not TOML. == 11.2 Grades (as-is 2026-09-20) diff --git a/docs/status/READINESS.adoc b/docs/status/READINESS.adoc index 475064a..bf996ca 100644 --- a/docs/status/READINESS.adoc +++ b/docs/status/READINESS.adoc @@ -42,7 +42,7 @@ evidence doesn't support the claim. *Evidence gates (v2.0 is stricter than v1.0):* * *D*: RSR-compliant + per-capability tests + documented scope. Test matrix - must cite counts and live in `.machine_readable/6a2/STATE.deed` or CI. + must cite counts and live in `.machine_readable/descriptiles/STATE.deed` or CI. * *C*: All of D, plus active dogfooding in home context with *no known home-context failures over an evidence window*, plus *deep per-file and per-directory annotation* (purpose, boundaries, invariants, @@ -183,7 +183,7 @@ Real-world external feedback confirming value. Populate * `docs/governance/CRG-AUDIT-.adoc` — formal audit (populate from `docs/governance/CRG-AUDIT-TEMPLATE.adoc`). * `docs/practice/DOGFOOD-LOG.adoc` — dated dogfood evidence (required for C). -* `.machine_readable/6a2/STATE.deed` — authoritative state (canonical keys +* `.machine_readable/descriptiles/STATE.deed` — authoritative state (canonical keys `[dogfooding-status]`, `[external-targets]`, `[issues-fed-back]`, `[field-signal]`). diff --git a/docs/status/ROADMAP.adoc b/docs/status/ROADMAP.adoc index e706efb..ff95a45 100644 --- a/docs/status/ROADMAP.adoc +++ b/docs/status/ROADMAP.adoc @@ -33,7 +33,7 @@ Effort: S <1d · M 2–5d · L >1w | ID | Item | Rationale | Class | Effort | Deps | H1 | Populate or drop `arrival-pack/` `coaptation/` | empty holdings | 🟡 | S | owner -| H2 | Document `6a2/` as live path *or* collapse to `descriptiles/` | path law | 🟡 | S | owner +| H2 | Collapse `6a2/` → `descriptiles/` | **done** 2026-09-20 | 🟡 | S | — | H3 | `www/dns` keep or delete | not a site | 🟡 | S | owner | H4 | Remove `archetypes/` if not a mint | template leftover | 🟢 | S | owner | H5 | Relocate `.gitlab-ci.yml` → `ci/` | GitLab setting | 🟡 | S | GitLab diff --git a/machine-readable-design/canonical-directory-structure/README.adoc b/machine-readable-design/canonical-directory-structure/README.adoc index 0daf677..4f8aa4a 100644 --- a/machine-readable-design/canonical-directory-structure/README.adoc +++ b/machine-readable-design/canonical-directory-structure/README.adoc @@ -11,7 +11,7 @@ and customize them with your project-specific content. [tree] ---- .machine_readable/ -├── 6a2/ +├── descriptiles/ │ ├── anchors/ │ ├── META.deed │ ├── ECOSYSTEM.deed @@ -48,7 +48,7 @@ The following command-line runners process these files: | `adjust` | Adjustfile.deed | Drift tolerance + corrective actions | `bust` | Bustfile.deed | Rollback procedures | `dust` | Dustfile.deed | Cleanup/hygiene checks -| `anchor` | anchors/ | Anchoring system (6a2) +| `anchor` | anchors/ | Anchoring system (descriptiles) | `just` | Justfile | Task automation |=== diff --git a/tests/evidence_spec.sh b/tests/evidence_spec.sh index 4ff19a9..807641c 100755 --- a/tests/evidence_spec.sh +++ b/tests/evidence_spec.sh @@ -15,9 +15,9 @@ grep -q ':status refused' src/evidence/examples/core-typing.evidence && pass "ho # ABNF-shaped chora head -5 panoply_chora.deed | grep -q 'repo-deed' && pass "panoply_chora.deed is repo-deed" || fail "chora" grep -q '\[metadata\]' panoply_chora.deed && fail "chora must not be TOML" || pass "chora is not TOML" -grep -q '\[metadata\]' .machine_readable/6a2/STATE.deed && fail "STATE still TOML" || pass "STATE is s-expression" -grep -q '\[metadata\]' .machine_readable/6a2/LANGUAGES.deed && fail "LANGUAGES still TOML" || pass "LANGUAGES is s-expression" -grep -q '\[metadata\]' .machine_readable/6a2/AGENTIC.deed && fail "AGENTIC still TOML" || pass "AGENTIC is s-expression" +grep -q '\[metadata\]' .machine_readable/descriptiles/STATE.deed && fail "STATE still TOML" || pass "STATE is s-expression" +grep -q '\[metadata\]' .machine_readable/descriptiles/LANGUAGES.deed && fail "LANGUAGES still TOML" || pass "LANGUAGES is s-expression" +grep -q '\[metadata\]' .machine_readable/descriptiles/AGENTIC.deed && fail "AGENTIC still TOML" || pass "AGENTIC is s-expression" echo "FAIL=$FAIL" exit "$FAIL" From 5daa7999c7aa9194266faaed39eb8ec5a3a34ae3 Mon Sep 17 00:00:00 2001 From: "Jonathan D.A. Jewell" <6759885+hyperpolymath@users.noreply.github.com> Date: Sun, 20 Sep 2026 16:13:06 +0000 Subject: [PATCH 4/6] =?UTF-8?q?chore(structure):=20remaining=206a2=20path?= =?UTF-8?q?=20refs=20=E2=86=92=20descriptiles?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Jonathan D.A. Jewell <6759885+hyperpolymath@users.noreply.github.com> --- .clinerules | 2 +- .machine_readable/ai/.clinerules | 2 +- .machine_readable/ai/.windsurfrules | 2 +- .windsurfrules | 2 +- build/just/assess.just | 12 ++++++------ build/just/groove.just | 2 +- build/just/validate.just | 28 ++++++++++++++-------------- 7 files changed, 25 insertions(+), 25 deletions(-) diff --git a/.clinerules b/.clinerules index 7299e80..d47ee74 100644 --- a/.clinerules +++ b/.clinerules @@ -2,7 +2,7 @@ # Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) # Authoritative source: docs/AI-CONVENTIONS.md -# STARTUP: Read 0-AI-MANIFEST.deed first, then .machine_readable/6a2/STATE.deed. +# STARTUP: Read 0-AI-MANIFEST.deed first, then .machine_readable/descriptiles/STATE.deed. # LICENSE # All original code: MPL-2.0. diff --git a/.machine_readable/ai/.clinerules b/.machine_readable/ai/.clinerules index fe11e22..a9dd1bf 100644 --- a/.machine_readable/ai/.clinerules +++ b/.machine_readable/ai/.clinerules @@ -2,7 +2,7 @@ # Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) # Authoritative source: docs/AI-CONVENTIONS.md -# STARTUP: Read 0-AI-MANIFEST.deed first, then .machine_readable/6a2/STATE.deed. +# STARTUP: Read 0-AI-MANIFEST.deed first, then .machine_readable/descriptiles/STATE.deed. # LICENSE # All original code: MPL-2.0. diff --git a/.machine_readable/ai/.windsurfrules b/.machine_readable/ai/.windsurfrules index fe11e22..a9dd1bf 100644 --- a/.machine_readable/ai/.windsurfrules +++ b/.machine_readable/ai/.windsurfrules @@ -2,7 +2,7 @@ # Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) # Authoritative source: docs/AI-CONVENTIONS.md -# STARTUP: Read 0-AI-MANIFEST.deed first, then .machine_readable/6a2/STATE.deed. +# STARTUP: Read 0-AI-MANIFEST.deed first, then .machine_readable/descriptiles/STATE.deed. # LICENSE # All original code: MPL-2.0. diff --git a/.windsurfrules b/.windsurfrules index 7299e80..d47ee74 100644 --- a/.windsurfrules +++ b/.windsurfrules @@ -2,7 +2,7 @@ # Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) # Authoritative source: docs/AI-CONVENTIONS.md -# STARTUP: Read 0-AI-MANIFEST.deed first, then .machine_readable/6a2/STATE.deed. +# STARTUP: Read 0-AI-MANIFEST.deed first, then .machine_readable/descriptiles/STATE.deed. # LICENSE # All original code: MPL-2.0. diff --git a/build/just/assess.just b/build/just/assess.just index 37a9001..c864412 100644 --- a/build/just/assess.just +++ b/build/just/assess.just @@ -51,10 +51,10 @@ self-assess: fi done - if [ -d ".machine_readable/6a2" ]; then - echo " ✓ .machine_readable/6a2/ — KEEP (SCM checkpoint files)" + if [ -d ".machine_readable/descriptiles" ]; then + echo " ✓ .machine_readable/descriptiles/ — KEEP (SCM checkpoint files)" else - echo " ✗ .machine_readable/6a2/ — MISSING (RSR violation!)" + echo " ✗ .machine_readable/descriptiles/ — MISSING (RSR violation!)" fi if [ -d ".github/workflows" ]; then @@ -201,9 +201,9 @@ verify: check_file "LICENSE" check_either "CONTRIBUTING.md" "CONTRIBUTING.adoc" check_either "README.adoc" "README.md" - check_file ".machine_readable/6a2/STATE.deed" - check_file ".machine_readable/6a2/META.deed" - check_file ".machine_readable/6a2/ECOSYSTEM.deed" + check_file ".machine_readable/descriptiles/STATE.deed" + check_file ".machine_readable/descriptiles/META.deed" + check_file ".machine_readable/descriptiles/ECOSYSTEM.deed" check_either "CHANGELOG.md" "CHANGELOG.adoc" # Check at least 1 workflow exists diff --git a/build/just/groove.just b/build/just/groove.just index 70cc571..cc303be 100644 --- a/build/just/groove.just +++ b/build/just/groove.just @@ -82,7 +82,7 @@ verify-template: fi # Check for empty SCM files - for f in .machine_readable/6a2/STATE.deed .machine_readable/6a2/META.deed .machine_readable/6a2/ECOSYSTEM.deed; do + for f in .machine_readable/descriptiles/STATE.deed .machine_readable/descriptiles/META.deed .machine_readable/descriptiles/ECOSYSTEM.deed; do if [ -f "$f" ] && grep -q '{{'{{'}}' "$f" 2>/dev/null; then echo "⚠ $f still has template placeholders" FOUND=1 diff --git a/build/just/validate.just b/build/just/validate.just index ea1647a..66aac2c 100644 --- a/build/just/validate.just +++ b/build/just/validate.just @@ -16,7 +16,7 @@ validate-rsr: for f in .editorconfig .gitignore Justfile README.adoc LICENSE 0-AI-MANIFEST.deed; do [ -f "$f" ] || MISSING="$MISSING $f" done - for f in .machine_readable/6a2/STATE.deed .machine_readable/6a2/META.deed .machine_readable/6a2/ECOSYSTEM.deed .machine_readable/6a2/anchors/ANCHOR.deed .machine_readable/policies/MAINTENANCE-AXES.deed .machine_readable/policies/MAINTENANCE-CHECKLIST.deed .machine_readable/policies/SOFTWARE-DEVELOPMENT-APPROACH.deed; do + for f in .machine_readable/descriptiles/STATE.deed .machine_readable/descriptiles/META.deed .machine_readable/descriptiles/ECOSYSTEM.deed .machine_readable/descriptiles/anchors/ANCHOR.deed .machine_readable/policies/MAINTENANCE-AXES.deed .machine_readable/policies/MAINTENANCE-CHECKLIST.deed .machine_readable/policies/SOFTWARE-DEVELOPMENT-APPROACH.deed; do [ -f "$f" ] || MISSING="$MISSING $f" done for f in licensing/exhibits/EXHIBIT-A-ETHICAL-USE.txt licensing/exhibits/EXHIBIT-B-QUANTUM-SAFE.txt licensing/texts/MPL-2.0.txt; do @@ -31,15 +31,15 @@ validate-rsr: for f in docs/governance/MAINTENANCE-CHECKLIST.adoc docs/governance/SOFTWARE-DEVELOPMENT-APPROACH.adoc; do [ -f "$f" ] || MISSING="$MISSING $f" done - if [ -f ".machine_readable/6a2/META.deed" ]; then - grep -q 'axis-1 = "must > intend > like"' .machine_readable/6a2/META.deed || MISSING="$MISSING META.deed:axis-1" - grep -q 'axis-2 = "corrective > adaptive > perfective"' .machine_readable/6a2/META.deed || MISSING="$MISSING META.deed:axis-2" - grep -q 'axis-3 = "systems > compliance > effects"' .machine_readable/6a2/META.deed || MISSING="$MISSING META.deed:axis-3" - grep -q 'scoping-first = true' .machine_readable/6a2/META.deed || MISSING="$MISSING META.deed:scoping-first" - grep -q 'idris-unsound-scan = "believe_me/assert_total"' .machine_readable/6a2/META.deed || MISSING="$MISSING META.deed:idris-unsound-scan" - grep -q 'audit-focus = "systems in place, documentation explains actual state, safety/security accounted for, observed effects reviewed"' .machine_readable/6a2/META.deed || MISSING="$MISSING META.deed:audit-focus" - grep -q 'compliance-focus = "seams/compromises/exception register, bounded exceptions, anti-drift checks"' .machine_readable/6a2/META.deed || MISSING="$MISSING META.deed:compliance-focus" - grep -q 'effects-evidence = "benchmark execution/results and maintainer status dialogue/review"' .machine_readable/6a2/META.deed || MISSING="$MISSING META.deed:effects-evidence" + if [ -f ".machine_readable/descriptiles/META.deed" ]; then + grep -q 'axis-1 = "must > intend > like"' .machine_readable/descriptiles/META.deed || MISSING="$MISSING META.deed:axis-1" + grep -q 'axis-2 = "corrective > adaptive > perfective"' .machine_readable/descriptiles/META.deed || MISSING="$MISSING META.deed:axis-2" + grep -q 'axis-3 = "systems > compliance > effects"' .machine_readable/descriptiles/META.deed || MISSING="$MISSING META.deed:axis-3" + grep -q 'scoping-first = true' .machine_readable/descriptiles/META.deed || MISSING="$MISSING META.deed:scoping-first" + grep -q 'idris-unsound-scan = "believe_me/assert_total"' .machine_readable/descriptiles/META.deed || MISSING="$MISSING META.deed:idris-unsound-scan" + grep -q 'audit-focus = "systems in place, documentation explains actual state, safety/security accounted for, observed effects reviewed"' .machine_readable/descriptiles/META.deed || MISSING="$MISSING META.deed:audit-focus" + grep -q 'compliance-focus = "seams/compromises/exception register, bounded exceptions, anti-drift checks"' .machine_readable/descriptiles/META.deed || MISSING="$MISSING META.deed:compliance-focus" + grep -q 'effects-evidence = "benchmark execution/results and maintainer status dialogue/review"' .machine_readable/descriptiles/META.deed || MISSING="$MISSING META.deed:effects-evidence" grep -q 'compliance-tooling = "panic-attack"' .machine_readable/policies/MAINTENANCE-AXES.deed || MISSING="$MISSING MAINTENANCE-AXES.deed:compliance-tooling" grep -q 'effects-tooling = "ecological checking with sustainabot guidance"' .machine_readable/policies/MAINTENANCE-AXES.deed || MISSING="$MISSING MAINTENANCE-AXES.deed:effects-tooling" grep -q 'source-human = "docs/governance/MAINTENANCE-CHECKLIST.adoc"' .machine_readable/policies/MAINTENANCE-CHECKLIST.deed || MISSING="$MISSING MAINTENANCE-CHECKLIST.deed:source-human" @@ -53,12 +53,12 @@ validate-rsr: # Validate STATE.deed syntax validate-state: - @if [ -f ".machine_readable/6a2/STATE.deed" ]; then \ - grep -q '^\[metadata\]' .machine_readable/6a2/STATE.deed && \ - grep -q 'project\s*=' .machine_readable/6a2/STATE.deed && \ + @if [ -f ".machine_readable/descriptiles/STATE.deed" ]; then \ + grep -q '^\[metadata\]' .machine_readable/descriptiles/STATE.deed && \ + grep -q 'project\s*=' .machine_readable/descriptiles/STATE.deed && \ echo "STATE.deed: valid" || echo "STATE.deed: INVALID (missing required sections)"; \ else \ - echo "No .machine_readable/6a2/STATE.deed found"; \ + echo "No .machine_readable/descriptiles/STATE.deed found"; \ fi # Validate AI installation guide completeness (finishbot pre-release check) From bd2f0ad3b533437229b3127f0f80bcc4600977a0 Mon Sep 17 00:00:00 2001 From: "Jonathan D.A. Jewell" <6759885+hyperpolymath@users.noreply.github.com> Date: Sun, 20 Sep 2026 16:19:44 +0000 Subject: [PATCH 5/6] chore(structure): drop leftover 6a2 name from docs Signed-off-by: Jonathan D.A. Jewell <6759885+hyperpolymath@users.noreply.github.com> --- .machine_readable/descriptiles/README.adoc | 3 +-- docs/status/ROADMAP.adoc | 2 +- 2 files changed, 2 insertions(+), 3 deletions(-) diff --git a/.machine_readable/descriptiles/README.adoc b/.machine_readable/descriptiles/README.adoc index e2a7415..16ab732 100644 --- a/.machine_readable/descriptiles/README.adoc +++ b/.machine_readable/descriptiles/README.adoc @@ -3,8 +3,7 @@ = descriptiles Canonical live path for STATE / META / ECOSYSTEM / AGENTIC / NEUROSYM / -PLAYBOOK / CLADE (s-expression repo-deeds). The old template name `6a2/` -is **not** used in this repository. +PLAYBOOK / CLADE (s-expression repo-deeds). [cols="1,3"] |=== diff --git a/docs/status/ROADMAP.adoc b/docs/status/ROADMAP.adoc index ff95a45..633a060 100644 --- a/docs/status/ROADMAP.adoc +++ b/docs/status/ROADMAP.adoc @@ -33,7 +33,7 @@ Effort: S <1d · M 2–5d · L >1w | ID | Item | Rationale | Class | Effort | Deps | H1 | Populate or drop `arrival-pack/` `coaptation/` | empty holdings | 🟡 | S | owner -| H2 | Collapse `6a2/` → `descriptiles/` | **done** 2026-09-20 | 🟡 | S | — +| H2 | Live deeds under `descriptiles/` only | **done** 2026-09-20 | 🟡 | S | — | H3 | `www/dns` keep or delete | not a site | 🟡 | S | owner | H4 | Remove `archetypes/` if not a mint | template leftover | 🟢 | S | owner | H5 | Relocate `.gitlab-ci.yml` → `ci/` | GitLab setting | 🟡 | S | GitLab From 9360107345031f39d9d5d463a9356417bb2a3aeb Mon Sep 17 00:00:00 2001 From: "Jonathan D.A. Jewell" <6759885+hyperpolymath@users.noreply.github.com> Date: Sun, 20 Sep 2026 16:26:25 +0000 Subject: [PATCH 6/6] chore: replace template TODOs; holdings not product stubs Signed-off-by: Jonathan D.A. Jewell <6759885+hyperpolymath@users.noreply.github.com> --- .github/workflows/release.yml | 15 ++------------- .machine_readable/arrival-pack/README.adoc | 2 +- .machine_readable/coaptation/README.adoc | 2 +- .machine_readable/coaptation/core/README.adoc | 2 +- .machine_readable/coaptation/receipts/README.adoc | 2 +- .machine_readable/contractiles/adjust/README.adoc | 2 +- .machine_readable/contractiles/intend/README.adoc | 2 +- .machine_readable/contractiles/must/README.adoc | 2 +- .machine_readable/contractiles/trust/README.adoc | 2 +- .machine_readable/descriptiles/LANGUAGES.deed | 2 +- Justfile | 8 ++------ archetypes/README.adoc | 2 +- ci/README.adoc | 2 +- src/api/README.adoc | 6 ++---- tests/e2e/README.adoc | 2 +- tests/shape/README.adoc | 2 +- www/dns/README.adoc | 2 +- 17 files changed, 20 insertions(+), 37 deletions(-) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 3ffb4a8..1ae3401 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -68,11 +68,7 @@ jobs: echo "Expected one of: mix.exs, Cargo.toml, build.zig, deno.json, gossamer.conf.json, gleam.toml, rebar.config, Justfile" exit 1 fi - # TODO: Upload build artifacts if needed - # - uses: actions/upload-artifact@v4 - # with: - # name: release-artifacts - # path: target/release/ + # Library: no release binary to upload (Zig FFI is not a tagged product). changelog: name: Generate Changelog runs-on: ubuntu-latest @@ -122,11 +118,7 @@ jobs: contents: write steps: - uses: actions/checkout@v7.0.1 - # TODO: Download build artifacts if uploading to the release - # - uses: actions/download-artifact@v4 - # with: - # name: release-artifacts - # path: artifacts/ + # No binary artifacts — notes-only GitHub Release. - name: Create GitHub Release uses: softprops/action-gh-release@v3.0.3 with: @@ -134,9 +126,6 @@ jobs: draft: false prerelease: ${{ contains(github.ref_name, '-rc') || contains(github.ref_name, '-beta') || contains(github.ref_name, '-alpha') }} generate_release_notes: false - # TODO: Add artifact files to the release - # files: | - # artifacts/* env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} provenance: diff --git a/.machine_readable/arrival-pack/README.adoc b/.machine_readable/arrival-pack/README.adoc index 05095c8..469ede0 100644 --- a/.machine_readable/arrival-pack/README.adoc +++ b/.machine_readable/arrival-pack/README.adoc @@ -5,4 +5,4 @@ Holding directory required by `rsr-template-repo`. Not yet populated with panoply-specific content. -TODO: see `docs/status/ROADMAP.adoc` (Phase 1 structural placeholders). +Holding — see `docs/status/ROADMAP.adoc` (H1). Not a product surface. diff --git a/.machine_readable/coaptation/README.adoc b/.machine_readable/coaptation/README.adoc index 66cd2b8..5daea20 100644 --- a/.machine_readable/coaptation/README.adoc +++ b/.machine_readable/coaptation/README.adoc @@ -5,4 +5,4 @@ Holding directory required by `rsr-template-repo`. Not yet populated with panoply-specific content. -TODO: see `docs/status/ROADMAP.adoc` (Phase 1 structural placeholders). +Holding — see `docs/status/ROADMAP.adoc` (H1). Not a product surface. diff --git a/.machine_readable/coaptation/core/README.adoc b/.machine_readable/coaptation/core/README.adoc index ff5339d..e284b69 100644 --- a/.machine_readable/coaptation/core/README.adoc +++ b/.machine_readable/coaptation/core/README.adoc @@ -5,4 +5,4 @@ Holding directory required by `rsr-template-repo`. Not yet populated with panoply-specific content. -TODO: see `docs/status/ROADMAP.adoc` (Phase 1 structural placeholders). +Holding — see `docs/status/ROADMAP.adoc` (H1). Not a product surface. diff --git a/.machine_readable/coaptation/receipts/README.adoc b/.machine_readable/coaptation/receipts/README.adoc index 68afa66..323dd0a 100644 --- a/.machine_readable/coaptation/receipts/README.adoc +++ b/.machine_readable/coaptation/receipts/README.adoc @@ -5,4 +5,4 @@ Holding directory required by `rsr-template-repo`. Not yet populated with panoply-specific content. -TODO: see `docs/status/ROADMAP.adoc` (Phase 1 structural placeholders). +Holding — see `docs/status/ROADMAP.adoc` (H1). Not a product surface. diff --git a/.machine_readable/contractiles/adjust/README.adoc b/.machine_readable/contractiles/adjust/README.adoc index b6da5bd..6c4c522 100644 --- a/.machine_readable/contractiles/adjust/README.adoc +++ b/.machine_readable/contractiles/adjust/README.adoc @@ -5,4 +5,4 @@ Holding directory required by `rsr-template-repo`. Not yet populated with panoply-specific content. -TODO: see `docs/status/ROADMAP.adoc` (Phase 1 structural placeholders). +Holding — see `docs/status/ROADMAP.adoc` (H1). Not a product surface. diff --git a/.machine_readable/contractiles/intend/README.adoc b/.machine_readable/contractiles/intend/README.adoc index 5c257b6..a0b3cc2 100644 --- a/.machine_readable/contractiles/intend/README.adoc +++ b/.machine_readable/contractiles/intend/README.adoc @@ -5,4 +5,4 @@ Holding directory required by `rsr-template-repo`. Not yet populated with panoply-specific content. -TODO: see `docs/status/ROADMAP.adoc` (Phase 1 structural placeholders). +Holding — see `docs/status/ROADMAP.adoc` (H1). Not a product surface. diff --git a/.machine_readable/contractiles/must/README.adoc b/.machine_readable/contractiles/must/README.adoc index b5557a3..119fd65 100644 --- a/.machine_readable/contractiles/must/README.adoc +++ b/.machine_readable/contractiles/must/README.adoc @@ -5,4 +5,4 @@ Holding directory required by `rsr-template-repo`. Not yet populated with panoply-specific content. -TODO: see `docs/status/ROADMAP.adoc` (Phase 1 structural placeholders). +Holding — see `docs/status/ROADMAP.adoc` (H1). Not a product surface. diff --git a/.machine_readable/contractiles/trust/README.adoc b/.machine_readable/contractiles/trust/README.adoc index 9e42dca..4eacb53 100644 --- a/.machine_readable/contractiles/trust/README.adoc +++ b/.machine_readable/contractiles/trust/README.adoc @@ -5,4 +5,4 @@ Holding directory required by `rsr-template-repo`. Not yet populated with panoply-specific content. -TODO: see `docs/status/ROADMAP.adoc` (Phase 1 structural placeholders). +Holding — see `docs/status/ROADMAP.adoc` (H1). Not a product surface. diff --git a/.machine_readable/descriptiles/LANGUAGES.deed b/.machine_readable/descriptiles/LANGUAGES.deed index f1f4d82..bb42537 100644 --- a/.machine_readable/descriptiles/LANGUAGES.deed +++ b/.machine_readable/descriptiles/LANGUAGES.deed @@ -13,4 +13,4 @@ :config ("nickel" "deed") :build ("just" "bash")) (planned - :core "TBD")) + :core "not-implemented")) diff --git a/Justfile b/Justfile index bfcf4bd..fb71fdc 100644 --- a/Justfile +++ b/Justfile @@ -265,14 +265,10 @@ deps: @command -v zig >/dev/null 2>&1 && echo " [OK] zig" || echo " [FAIL] zig not found" @command -v just >/dev/null 2>&1 && echo " [OK] just" || echo " [FAIL] just not found" -# Audit dependencies for vulnerabilities +# Audit dependencies for vulnerabilities (no cargo/mix; trivy if present) deps-audit: @echo "Auditing for vulnerabilities..." - # TODO: Replace with your audit command - # Examples: - # cargo audit - # mix audit - @command -v trivy >/dev/null && trivy fs --severity HIGH,CRITICAL --quiet . || true + @command -v trivy >/dev/null && trivy fs --severity HIGH,CRITICAL --quiet . || echo "trivy not installed — skip" @echo "Audit complete" # ═══════════════════════════════════════════════════════════════════════════════ diff --git a/archetypes/README.adoc b/archetypes/README.adoc index 3f97d61..1a34cdd 100644 --- a/archetypes/README.adoc +++ b/archetypes/README.adoc @@ -5,4 +5,4 @@ Holding directory required by `rsr-template-repo`. Not yet populated with panoply-specific content. -TODO: see `docs/status/ROADMAP.adoc` (Phase 1 structural placeholders). +Holding — see `docs/status/ROADMAP.adoc` (H1). Not a product surface. diff --git a/ci/README.adoc b/ci/README.adoc index e5e2944..0c730e1 100644 --- a/ci/README.adoc +++ b/ci/README.adoc @@ -5,4 +5,4 @@ Holding directory required by `rsr-template-repo`. Not yet populated with panoply-specific content. -TODO: see `docs/status/ROADMAP.adoc` (Phase 1 structural placeholders). +Holding — see `docs/status/ROADMAP.adoc` (H1). Not a product surface. diff --git a/src/api/README.adoc b/src/api/README.adoc index 25435ac..d4d3922 100644 --- a/src/api/README.adoc +++ b/src/api/README.adoc @@ -2,7 +2,5 @@ // Copyright (c) Jonathan D.A. Jewell = api -Holding directory required by `rsr-template-repo`. -Not yet populated with panoply-specific content. - -TODO: see `docs/status/ROADMAP.adoc` (Phase 1 structural placeholders). +Zig fail-closed adapter: `src/api/zig/adapter.zig` (`NotImplemented` until a +gateway exists — ROADMAP H8). Not an HTTP product. diff --git a/tests/e2e/README.adoc b/tests/e2e/README.adoc index 0adbc8f..363c85a 100644 --- a/tests/e2e/README.adoc +++ b/tests/e2e/README.adoc @@ -5,4 +5,4 @@ Holding directory required by `rsr-template-repo`. Not yet populated with panoply-specific content. -TODO: see `docs/status/ROADMAP.adoc` (Phase 1 structural placeholders). +Holding — see `docs/status/ROADMAP.adoc` (H1). Not a product surface. diff --git a/tests/shape/README.adoc b/tests/shape/README.adoc index 0030505..3374e80 100644 --- a/tests/shape/README.adoc +++ b/tests/shape/README.adoc @@ -5,4 +5,4 @@ Holding directory required by `rsr-template-repo`. Not yet populated with panoply-specific content. -TODO: see `docs/status/ROADMAP.adoc` (Phase 1 structural placeholders). +Holding — see `docs/status/ROADMAP.adoc` (H1). Not a product surface. diff --git a/www/dns/README.adoc b/www/dns/README.adoc index b137fba..338407f 100644 --- a/www/dns/README.adoc +++ b/www/dns/README.adoc @@ -5,4 +5,4 @@ Holding directory required by `rsr-template-repo`. Not yet populated with panoply-specific content. -TODO: see `docs/status/ROADMAP.adoc` (Phase 1 structural placeholders). +Holding — see `docs/status/ROADMAP.adoc` (H1). Not a product surface.