Skip to content
Merged
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
4 changes: 2 additions & 2 deletions .github/copilot-instructions.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
## Before Writing Code

- Read `0-AI-MANIFEST.deed` in the repo root first: it points at the repo deed.
- Repo metadata is deed (`gv-clade-index_chora.deed`, `.machine_readable/descriptiles/STATE.deed`). A2ML is retired: never create a `.a2ml` file.
- Repo metadata is deed (`chora-registry_chora.deed`, `.machine_readable/descriptiles/STATE.deed`). A2ML is retired: never create a `.a2ml` file.

## License

Expand Down Expand Up @@ -52,6 +52,6 @@

## State Files

Repo facts live in `gv-clade-index_chora.deed`; descriptiles (`STATE.deed` and
Repo facts live in `chora-registry_chora.deed`; descriptiles (`STATE.deed` and
the like) live in `.machine_readable/descriptiles/` only, never the root. Never
create a `.a2ml` file (A2ML is retired; `docs/history/A2ML-REMOVED.adoc`).
4 changes: 2 additions & 2 deletions .machine_readable/ai/.clinerules
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
# Authoritative source: docs/AI-CONVENTIONS.md

# STARTUP: Read 0-AI-MANIFEST.deed first, then gv-clade-index_chora.deed.
# STARTUP: Read 0-AI-MANIFEST.deed first, then chora-registry_chora.deed.

# LICENSE
# All original code: MPL-2.0.
Expand All @@ -11,7 +11,7 @@
# Copyright: Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>

# STATE FILES (.machine_readable/descriptiles/ ONLY)
# Repo metadata is deed (gv-clade-index_chora.deed, descriptiles/STATE.deed).
# Repo metadata is deed (chora-registry_chora.deed, descriptiles/STATE.deed).
# A2ML is retired: never create a .a2ml file.
# The .machine_readable/ directory is the single source of truth.

Expand Down
2 changes: 1 addition & 1 deletion .machine_readable/ai/.cursorrules
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
# Copyright: Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>

# STATE FILES
# Repo metadata is deed: gv-clade-index_chora.deed at the root, descriptiles
# Repo metadata is deed: chora-registry_chora.deed at the root, descriptiles
# (STATE.deed, …) in .machine_readable/descriptiles/ ONLY.
# A2ML is retired: never create a .a2ml file.

Expand Down
4 changes: 2 additions & 2 deletions .machine_readable/ai/.windsurfrules
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
# Authoritative source: docs/AI-CONVENTIONS.md

# STARTUP: Read 0-AI-MANIFEST.deed first, then gv-clade-index_chora.deed.
# STARTUP: Read 0-AI-MANIFEST.deed first, then chora-registry_chora.deed.

# LICENSE
# All original code: MPL-2.0.
Expand All @@ -11,7 +11,7 @@
# Copyright: Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>

# STATE FILES (.machine_readable/descriptiles/ ONLY)
# Repo metadata is deed (gv-clade-index_chora.deed, descriptiles/STATE.deed).
# Repo metadata is deed (chora-registry_chora.deed, descriptiles/STATE.deed).
# A2ML is retired: never create a .a2ml file.
# The .machine_readable/ directory is the single source of truth.

Expand Down
2 changes: 1 addition & 1 deletion .machine_readable/ai/README.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Avoid scattering agent instruction files around the repo root.
Recommended machine read order:

* `0-AI-MANIFEST.deed` (pointer-only front door)
* `gv-clade-index_chora.deed` (repo facts, including the `(agentic)` clause)
* `chora-registry_chora.deed` (repo facts, including the `(agentic)` clause)
* `.machine_readable/descriptiles/STATE.deed` (lifecycle status, maturity)

A2ML is retired; never add a `.a2ml` file here
Expand Down
4 changes: 2 additions & 2 deletions 0-AI-MANIFEST.deed
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
;;
;; The machine front door of gv-clade-index (the chora-registry): pointer-only
;; (A7 ruling Q15). It names where to read and carries no facts of its own.
;; Repository facts are in gv-clade-index_chora.deed and
;; Repository facts are in chora-registry_chora.deed and
;; .machine_readable/descriptiles/STATE.deed; the registry itself is
;; verisim/seed/chora-registry_praxis.deed. It replaces 0-AI-MANIFEST.a2ml,
;; retired 2026-11-14 (docs/history/A2ML-REMOVED.adoc).
Expand All @@ -13,5 +13,5 @@
:repo-uuid #uuid"a65b74d8-351a-89d9-a38d-aea470863b03"
:beholding-chora #uuid"0889b37b-defb-831f-973c-e119500db00e"
(front-doors
:machine "gv-clade-index_chora.deed"
:machine "chora-registry_chora.deed"

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Update the manifest's canonical name too

After the rename, machine consumers entering through this manifest still read :canonical-name "gv-clade-index" on line 12, while the referenced deed and registry now declare chora-registry. This leaves the machine entry point reporting two conflicting current identities for the same UUID; update the manifest's canonical name and its stale header description along with the front-door path.

Useful? React with 👍 / 👎.

:human "README.adoc"))
14 changes: 7 additions & 7 deletions Justfile
Original file line number Diff line number Diff line change
Expand Up @@ -19,9 +19,9 @@ set positional-arguments := true
import? "contractile.just"

# Project metadata — customize these
project := "gv-clade-index"
project := "chora-registry"
OWNER := "hyperpolymath"
REPO := "gv-clade-index"
REPO := "chora-registry"
version := "0.1.0"
tier := "infrastructure" # 1 | 2 | infrastructure

Expand Down Expand Up @@ -886,7 +886,7 @@ assail:

# Self-diagnostic — checks dependencies, permissions, paths
doctor:
@echo "Running diagnostics for gv-clade-index..."
@echo "Running diagnostics for chora-registry..."
@echo "Checking required tools..."
@command -v just >/dev/null 2>&1 && echo " [OK] just" || echo " [FAIL] just not found"
@command -v git >/dev/null 2>&1 && echo " [OK] git" || echo " [FAIL] git not found"
Expand All @@ -896,7 +896,7 @@ doctor:

# Auto-repair common issues
heal:
@echo "Attempting auto-repair for gv-clade-index..."
@echo "Attempting auto-repair for chora-registry..."
@echo "Fixing permissions..."
@find . -name "*.sh" -exec chmod +x {} \; 2>/dev/null || true
@echo "Cleaning stale caches..."
Expand All @@ -905,7 +905,7 @@ heal:

# Guided tour of key features
tour:
@echo "=== gv-clade-index Tour ==="
@echo "=== chora-registry Tour ==="
@echo ""
@echo "1. Project structure:"
@ls -la
Expand All @@ -920,12 +920,12 @@ tour:

# Open feedback channel with diagnostic context
help-me:
@echo "=== gv-clade-index Help ==="
@echo "=== chora-registry Help ==="
@echo "Platform: $(uname -s) $(uname -m)"
@echo "Shell: $SHELL"
@echo ""
@echo "To report an issue:"
@echo " https://github.com/hyperpolymath/gv-clade-index/issues/new"
@echo " https://github.com/hyperpolymath/chora-registry/issues/new"
@echo ""
@echo "Include the output of 'just doctor' in your report."

Expand Down
2 changes: 1 addition & 1 deletion QUICKSTART-DEV.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -102,7 +102,7 @@ If using an AI assistant, load the warmup context first:
just llm-context # Outputs role-appropriate context
----

Or read `0-AI-MANIFEST.deed` and `gv-clade-index_chora.deed` directly.
Or read `0-AI-MANIFEST.deed` and `chora-registry_chora.deed` directly.

== Get Help

Expand Down
2 changes: 1 addition & 1 deletion README.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ implementations
....
gv-clade-index/
├── 0-AI-MANIFEST.deed # AI agent entry point (pointer-only)
├── gv-clade-index_chora.deed # This repo's deed: identity, clade, agentic, ...
├── chora-registry_chora.deed # This repo's deed: identity, clade, agentic, ...
├── .machine_readable/ # descriptiles/STATE.deed (status), contractiles
├── verisim/
│ ├── config.a2ml # VeriSimDB instance config
Expand Down
18 changes: 10 additions & 8 deletions gv-clade-index_chora.deed → chora-registry_chora.deed
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
;; SPDX-License-Identifier: MPL-2.0
;; SPDX-FileCopyrightText: 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
;;
;; The repo deed of gv-clade-index, the chora-registry (one deed per repo,
;; D312). The file takes the canonical name the retired CLADE.a2ml held and
;; GitHub still uses; when the repository is renamed to chora-registry the file
;; is renamed with it and its :repo-uuid does not change (U1, U4).
;; The repo deed of chora-registry (one deed per repo, D312). The repository
;; was born hyperpolymath/gv-clade-index and renamed to chora-registry on
;; 2026-11-14; the file was renamed with it and its :repo-uuid did not change
;; (U1, U4). The id keeps its gv-clade-index minting domain for good (V9).
;;
;; Every clause below is translated field for field from a retired A2ML
;; descriptile under the mapping spec that governs its family, in standards
Expand Down Expand Up @@ -33,22 +33,24 @@
;; nothing translated (P-2a); the ledger names each field.
(repo-deed
:schema-version "1.0.0"
:canonical-name "gv-clade-index"
:canonical-name "chora-registry"
:repo-uuid #uuid"a65b74d8-351a-89d9-a38d-aea470863b03"
:beholding-chora #uuid"0889b37b-defb-831f-973c-e119500db00e"
(identity :owner "hyperpolymath" :primary-forge github :prefixed-name "gv-clade-index")
(identity :owner "hyperpolymath" :primary-forge github :prefixed-name "chora-registry")
(clade
:primary gv
:secondary (db)
:assigned "2026-03-16"
:rationale "This is a governance registry backed by a database; governance is the primary purpose")
(forges
:github "hyperpolymath/gv-clade-index"
:github "hyperpolymath/chora-registry"
:gitlab "hyperpolymath/gv-clade-index"
:bitbucket "hyperpolymath/gv-clade-index")
; [lineage] had no previous-names or instantiated-from, so neither is emitted.
; [lineage] had no previous-names or instantiated-from when translated; the
; rename of 2026-11-14 adds the earlier name.
(lineage
:type standalone
:previous-names ("gv-clade-index")
:parent ""
:born "2026-03-16")
; AGENTIC.a2ml: [metadata] version and last-updated, [agent-permissions]
Expand Down
2 changes: 1 addition & 1 deletion docs/developer/REPO-ONBOARDING.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ index.
served `uuid` (UUIDv5) is derived by `sync/export-json.sh`.
. *Set lineage* — standalone / monorepo / monorepo-child / inflated / deflated,
and when each applies.
. *Ingest* — `sync/seed-verisim.sh`. The repo declares its own identity in its chora deed (`<repo>_chora.deed`, `:repo-uuid`); a `(clade …)` clause there is an optional finding aid. Nothing here writes into the repo.
. *Ingest* — `sync/seed-verisim.sh`. The repo declares its own identity in its chora deed (`<repo>_chora.deed`, `:repo-uuid`); a `(clade …)` clause there records its placements, identity facts checked against the registry (A7 W10). Nothing here writes into the repo.
. *Verify* — clade-hygiene contractile passes and the repo appears in
`dashboard.vcl` (and not in `orphans.vcl`).

Expand Down
6 changes: 3 additions & 3 deletions docs/practice/AI-CONVENTIONS.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Per-tool config files (.cursorrules, .clinerules, etc.) reference this document.
## Session Startup

1. Read `0-AI-MANIFEST.deed` FIRST (the pointer-only front door).
2. Read `gv-clade-index_chora.deed` for repo facts, including the `(agentic)` permissions and integrity axioms.
2. Read `chora-registry_chora.deed` for repo facts, including the `(agentic)` permissions and integrity axioms.
3. Read `.machine_readable/descriptiles/STATE.deed` for the lifecycle status and maturity, and `ROADMAP.adoc` for blockers.
4. Read `docs/governance/TSDM.adoc`, `MAINTENANCE-CHECKLIST.adoc` and `SOFTWARE-DEVELOPMENT-APPROACH.adoc` for maintenance and audit sequencing.

Expand All @@ -30,7 +30,7 @@ Per-tool config files (.cursorrules, .clinerules, etc.) reference this document.

## State Files

Repo metadata is deed: `gv-clade-index_chora.deed` at the root, and descriptile
Repo metadata is deed: `chora-registry_chora.deed` at the root, and descriptile
deeds (`STATE.deed` and the like) in `.machine_readable/descriptiles/` ONLY.
A2ML is retired: NEVER create a `.a2ml` file (`docs/history/A2ML-REMOVED.adoc`).

Expand Down Expand Up @@ -73,6 +73,6 @@ Use `just` (Justfile) for all build, test, lint, and format tasks.
## References

- `0-AI-MANIFEST.deed` -- universal AI entry point (pointer-only)
- `gv-clade-index_chora.deed` -- repo facts, agent permissions and integrity axioms
- `chora-registry_chora.deed` -- repo facts, agent permissions and integrity axioms
- `.machine_readable/descriptiles/STATE.deed` -- lifecycle status and maturity
- `docs/governance/TSDM.adoc` -- axis sequencing and audit requirements
17 changes: 12 additions & 5 deletions scripts/check-registry.sh
Original file line number Diff line number Diff line change
Expand Up @@ -176,18 +176,25 @@ echo "check-registry: archive holds $(jq length "$DATA/archive.json") moved repo
if [[ -n "${GV_BASE_REPOS_JSON:-}" ]]; then
[[ -f "$GV_BASE_REPOS_JSON" ]] || fail "GV_BASE_REPOS_JSON names a missing file: $GV_BASE_REPOS_JSON"
jq empty "$GV_BASE_REPOS_JSON" 2>/dev/null || fail "GV_BASE_REPOS_JSON is not valid JSON"
# A repo is followed by its id, not its name: a rename keeps the id (U1)
# and changes `name` and `github` only. A base entry whose uuid the head no
# longer lists was removed, unless the head lists its name under another id,
# which is an id change.
removed=$(jq -r --slurpfile head "$DATA/repos.json" '
($head[0] | map(.name)) as $h
| [.[].name | select(. as $n | $h | index($n) | not)] | join(" ")' "$GV_BASE_REPOS_JSON")
($head[0] | map(.uuid)) as $ids | ($head[0] | map(.name)) as $names
| [.[] | select((.uuid as $u | $ids | index($u) | not)
and (.name as $n | $names | index($n) | not)) | .name] | join(" ")' "$GV_BASE_REPOS_JSON")
[[ -z "$removed" ]] || fail "registered repo(s) removed from the seed: $removed (ADR 0008: a registered repo is never removed; record its status instead)"
changed=$(jq -r --slurpfile head "$DATA/repos.json" '
($head[0] | map({key: .name, value: .}) | from_entries) as $h
| [.[] | . as $b | $h[$b.name] as $c
($head[0] | map({key: .uuid, value: .}) | from_entries) as $byid
| ($head[0] | map({key: .name, value: .}) | from_entries) as $byname
| [.[] | . as $b | ($byid[$b.uuid] // $byname[$b.name]) as $c
| select($c != null)
| select(($b.uuid // null) != null and $b.uuid != $c.uuid
or ($b.uuid_v8 // null) != null and $b.uuid_v8 != $c.uuid_v8)
| "\($b.name) (\($b.uuid) -> \($c.uuid))"] | join("; ")' "$GV_BASE_REPOS_JSON")
[[ -z "$changed" ]] || fail "a registered id changed: $changed (ADR 0008: an id is minted once)"
echo "check-registry: all $(jq length "$GV_BASE_REPOS_JSON") repos of the base are still registered, ids unchanged"
echo "check-registry: all $(jq length "$GV_BASE_REPOS_JSON") repos of the base are still registered (followed by id), ids unchanged"
else
echo "check-registry: NOTICE: GV_BASE_REPOS_JSON unset, so the never-removed check (section 7) did not run"
fi
Expand Down
11 changes: 10 additions & 1 deletion tests/check-registry-test.sh
Original file line number Diff line number Diff line change
Expand Up @@ -251,4 +251,13 @@ got=$(jq -r '.[] | select(.name == "zz-planted-escape-probe") | .description' "$
bash "$work/repo/scripts/check-registry.sh" >/dev/null || { echo "FAIL: [escapes] gate refused it"; exit 1; }
echo "ok: [escapes] backslashes and quotes in a description round-trip into repos.json"

echo "check-registry-test: PASS (baseline, path reuse, birth id and an unchanged base pass; 19 planted failures fire; a chora-registry mint and string escapes pass)"
# 24. A rename keeps the id (U1): a base that lists the repo under its old
# name passes, because the never-removed check follows the id.
fresh
jq --arg n "$first" 'map(if .name==$n then .name="zz-planted-old-name" | .github="hyperpolymath/zz-planted-old-name" else . end)' \
"$work/repo/worker/data/repos.json" > "$work/base-repos.json"
GV_BASE_REPOS_JSON="$work/base-repos.json" bash "$work/repo/scripts/check-registry.sh" >/dev/null \
|| { echo "FAIL: [rename] gate refused a renamed repo that kept its id"; exit 1; }
echo "ok: [rename] a repo renamed since the base, with its id unchanged, passes"

echo "check-registry-test: PASS (baseline, path reuse, birth id and an unchanged base pass; 19 planted failures fire; a chora-registry mint, string escapes and a rename pass)"
10 changes: 7 additions & 3 deletions verisim/seed/chora-registry_praxis.deed
Original file line number Diff line number Diff line change
Expand Up @@ -270,12 +270,16 @@
;; gv — Governance & Standards
;; ============================================================================

(repo :name "gv-clade-index" :owner "hyperpolymath"
;; Renamed from gv-clade-index on 2026-11-14 (the GitHub rename). The id is
;; minted once from the birth path and does not change (U1); its domain stays
;; gv-clade-index (V9).
(repo :name "chora-registry" :owner "hyperpolymath"
:uuid #uuid"a65b74d8-351a-89d9-a38d-aea470863b03" :minted-in gv-clade-index
:description "THIS REPO — clade taxonomy + VeriSimDB portal registry"
:description "THIS REPO — the register of repo identities and their classification schemes (VeriSimDB portal)"
(lineage :type standalone)
(placement :scheme clade-12 :category gv :primary #t)
(placement :scheme clade-12 :category db :rank 1))
(placement :scheme clade-12 :category db :rank 1)
(former :generation 1 :path "hyperpolymath/gv-clade-index" :until "2026-11-14"))

(repo :name "palimpsest-license" :owner "hyperpolymath"
:uuid #uuid"5a0be662-f3a0-861c-85e7-8896d839fe1c" :minted-in gv-clade-index
Expand Down
16 changes: 16 additions & 0 deletions worker/data/archive.json
Original file line number Diff line number Diff line change
Expand Up @@ -91,6 +91,22 @@
}
]
},
{
"name": "chora-registry",
"github": "hyperpolymath/chora-registry",
"uuid": "c88e9ff3-9aac-5de8-b891-19b5de64aedd",
"uuid_v8": "a65b74d8-351a-89d9-a38d-aea470863b03",
"birth": "hyperpolymath/gv-clade-index",
"generation": 2,
"former": [
{
"generation": 1,
"github": "hyperpolymath/gv-clade-index",
"until": "2026-11-14"
}
],
"retired": []
},
{
"name": "enterglide-ncc-137-k",
"github": "catachresis-colloquium/enterglide-ncc-137-k",
Expand Down
14 changes: 7 additions & 7 deletions worker/data/index.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"total_repos": 327,
"total_clades": 12,
"generated": "2026-11-12T01:20:03Z",
"generated": "2026-11-14T20:38:00Z",
"clades": [
{
"code": "fv",
Expand Down Expand Up @@ -180,7 +180,7 @@
],
"member_count": 16,
"members": [
"gv-clade-index",
"chora-registry",
"palimpsest-license",
"palimpsest-plasma",
"standards",
Expand Down Expand Up @@ -951,8 +951,8 @@
"prefixed": "rm-v3-templater",
"github": "hyperpolymath/v3-templater"
},
"gv-clade-index": {
"name": "gv-clade-index",
"chora-registry": {
"name": "chora-registry",
Comment on lines +954 to +955

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Preserve the old resolver names after the rename

Existing requests to /v1/repo/gv-clade-index now return 404 because route only evaluates index.by_name[name], and existing CLADE-gv-gv-clade-index autolinks likewise fail because /c/:binomial only searches current prefixed values. The repository's lifecycle model explicitly retains former prefixed names as aliases, so export an alias for the old canonical/binomial names and make both resolvers consult it or redirect to chora-registry.

Useful? React with 👍 / 👎.

"uuid": "c88e9ff3-9aac-5de8-b891-19b5de64aedd",
"uuid_v8": "a65b74d8-351a-89d9-a38d-aea470863b03",
"clade": "gv",
Expand All @@ -961,9 +961,9 @@
],
"lineage": "standalone",
"parent": "",
"description": "THIS REPO — clade taxonomy + VeriSimDB portal registry",
"prefixed": "gv-gv-clade-index",
"github": "hyperpolymath/gv-clade-index"
"description": "THIS REPO — the register of repo identities and their classification schemes (VeriSimDB portal)",
"prefixed": "gv-chora-registry",
"github": "hyperpolymath/chora-registry"
},
"palimpsest-license": {
"name": "palimpsest-license",
Expand Down
Loading
Loading