Skip to content

Commit 17eb45d

Browse files
docs(clade): uuid follows the GitHub path; qualify the prefixed-name case (#50)
## Summary Comment-only follow-up. An earlier PR replaced "uuid is immortal" in the CLADE status comment with "uuid follows the forge path". This one makes it exact. gv-clade-index ADR 0007 (accepted 2026-11-10) derives the uuid from the GitHub path (UUIDv5 over `github.com/<owner>/<name>`): a move or rename on GitHub mints a new one, and a mirror move or a phase change never does. A2ML is retired for new content. Correcting a factually wrong comment in an existing file is an edit, not new content. ## Changes - `.machine_readable/CLADE.a2ml`: "uuid follows the forge path" → "uuid follows the GitHub path (a move or rename there mints a new one, gv-clade-index ADR 0007; a mirror move or a phase change never does)"; "A prefixed-name (clade code) change is NOT a phase change" → "A prefixed-name (clade code) change with the GitHub path unchanged is NOT a phase change". The paragraph is re-wrapped at 80 columns. No data values change. The owner approved this wording for the whole estate. It refines the wording merged earlier. ## RSR Quality Checklist ### Required - [ ] Tests pass (`just test` or equivalent): not run locally. Comment-only change, left to CI. - [ ] Code is formatted (`just fmt` or equivalent): n/a, no code - [ ] Linter is clean (no new warnings or errors): n/a, no code - [x] No banned language patterns - [x] No `unsafe` blocks without `// SAFETY:` comments - [x] No banned functions - [x] SPDX license headers present on all new/modified source files (not touched) - [x] No secrets, credentials, or `.env` files included ## Testing The diff is one comment paragraph in one file. Every line is ≤80 characters. The commit is signed. --- _Generated by [Claude Code](https://claude.ai/code/session_0136P7ZmTcNdC1jL1Vp3qW9H)_ Co-authored-by: Claude <noreply@anthropic.com>
1 parent b8ce9f0 commit 17eb45d

1 file changed

Lines changed: 7 additions & 6 deletions

File tree

‎.machine_readable/CLADE.a2ml‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -26,12 +26,13 @@ parent = "Public portfolio — will become ReScript/WASM portal"
2626
born = "2026-03-16"
2727

2828
# Lifecycle status (added by clade-status-backfill; see gv-clade-index ADR 0006).
29-
# Identity (uuid) and status are SEPARATE layers: uuid follows the forge path (a
30-
# move or rename mints a new one, gv-clade-index ADR 0007; a phase change never
31-
# does); phase is a mutable pointer. No phase is terminal (extinct -> active is
32-
# a legal "Gitassic Park" transition on the same uuid). A prefixed-name (clade
33-
# code) change is NOT a phase change — the old prefixed-name goes to aliases[],
34-
# uuid and phase are untouched.
29+
# Identity (uuid) and status are SEPARATE layers: uuid follows the GitHub path
30+
# (a move or rename there mints a new one, gv-clade-index ADR 0007; a mirror
31+
# move or a phase change never does); phase is a mutable pointer. No phase is
32+
# terminal (extinct -> active is a legal "Gitassic Park" transition on the same
33+
# uuid). A prefixed-name (clade code) change with the GitHub path unchanged is
34+
# NOT a phase change — the old prefixed-name goes to aliases[], uuid and phase
35+
# are untouched.
3536
[status]
3637
# One of: reserved incubating active dormant | merged superseded archived extinct
3738
phase = "active"

0 commit comments

Comments
 (0)