reorg(1-formats): the 8 (pointer) entries — stub + relocate - #829
Merged
Merged
Conversation
…a stub The map annotates these entries "(pointer)": the standard relocates and the old path keeps a stub. Owner ruled the stub shape: a POINTER.adoc in each old directory, with a machine-readable `moved-to` line. (canon.lock is untouched: these entries are [canon.split-candidates] only if they are slots, and none are.) RELOCATED (232 files) -> new home stub left at k9-svc 41 files -> 1-formats/k9/ k9-svc/ meta-a2ml 38 files -> 1-formats/a2ml/meta/ meta-a2ml/ agentic-a2ml 37 files -> 1-formats/a2ml/agentic/ agentic-a2ml/ state-a2ml 30 files -> 1-formats/a2ml/state/ state-a2ml/ anchor-a2ml 25 files -> 1-formats/a2ml/anchor/ anchor-a2ml/ ecosystem-a2ml 23 files -> 1-formats/a2ml/ecosystem/ ecosystem-a2ml/ neurosym-a2ml 23 files -> 1-formats/a2ml/neurosym/ neurosym-a2ml/ playbook-a2ml 15 files -> 1-formats/a2ml/playbook/ playbook-a2ml/ 183 inbound references rewritten. THE MAP IS SILENT ON TWO THINGS. Neither is decided silently here; both are resolved from this repo's own vocabulary and the resolution is recorded IN the map: 1. All seven *-a2ml dirs carried the SAME target, `1-formats/a2ml/`. Taken literally that merges seven directories into one, and 34 relative paths COLLIDE: seven README.adoc, seven .editorconfig, seven .gitattributes, seven .gitignore, seven .machine_readable/descriptiles/*.a2ml, and 28 more. docs/reorg/STREAM-PROMPTS.adoc names the seven homes normatively — "the descriptiles family becomes A2ML profiles: a2ml/state, a2ml/meta, a2ml/ecosystem, a2ml/agentic, a2ml/neurosym, a2ml/playbook, a2ml/anchor" — so each profile becomes a subdirectory and `target` records the refinement. k9-svc's target already named its own directory and is unchanged. 2. A pointer entry's `from` is NOT rewritten, unlike a plain move. The old path still EXISTS (it holds the stub), so GATE D assertions 1 and 2 keep holding and the record keeps stating where the migration started. A plain move rewrites `from` because there the old path stops existing. THE STUB is one file per old directory, no other content: SPDX + title, a relative link to the new home, and a TOML block (`moved-to`, `pointer`, `district`) whose shape is stable and greppable. Nothing in it is normative. Also fixed, same class as the last one: three re-added scorecard lines named `.machine_readable/6a2/`, a directory that has not existed since the rename to `.machine_readable/descriptiles/`. Corrected in place (playbook-a2ml ×2, state-a2ml ×3) — added lines only, so the chartered wider migration is untouched. check-canonical-names.sh rc=1 -> rc=0. GATES scripts/check-standards-map.sh PASSED, entry_count 120 scripts/check-canon-lockstep.sh 8 passed / 0 failed / 2 skipped check-canonical-names.sh rc=0 every other scripts/check-*.sh identical rc to the pristine 176d1f7 control except the two already explained
Contributor
|
Important Review skippedToo many files! This PR contains 268 files, which is 168 over the limit of 100. To get a review, reduce the PR to 100 files or fewer by splitting it into smaller PRs or changing its base branch. Upgrade to a paid plan to raise the limit. This review couldn't start because sufficient usage credits or metered capacity aren't available. Add credits or update usage-based reviews in the billing tab, then retry. ⚙️ Run configurationConfiguration used: Organization UI Review profile: ASSERTIVE Plan: Advanced Run ID: ⛔ Files ignored due to path filters (4)
📒 Files selected for processing (268)
You can disable this status message by setting the Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
|
hyperpolymath
added a commit
that referenced
this pull request
Sep 17, 2026
## What District 2 — the third district taken end-to-end, after `0-canon` (2.0.3) and `1-formats` (#827 + #829). **7 plain moves, 162 inbound references rewritten, map updated, GATE D green at `entry_count` 121.** ``` axel-protocol 110 files -> 2-protocols/axel/ 0-ai-gatekeeper-protocol 50 files -> 2-protocols/0-ai-gatekeeper/ k9-coordination-protocol 19 files -> 2-protocols/k9-coordination/ overlay-protocol 10 files -> 2-protocols/overlay/ groove-protocol 2 files -> 2-protocols/groove/ chora 2 files -> 2-protocols/chora/ avow-protocol 1 file -> 2-protocols/avow/ ``` No `(pointer)` entries in this district and no unintelligible entries — all seven are plain moves, so nothing needed a convention call. ## No version bump, and `canon.lock` is untouched None of the five `[canon.artifacts]` bytes changed (GATE A assertion 1 confirms all five hashes still match the lock), and no `[canon.split-candidates]` path pointed into any of these directories — so there is nothing to hand-edit this time. Assertion 3 confirms the spine's merged pins still agree. ## References reach further than the directory names `.hypatia-baseline.json`, `.machine_readable/REGISTRY.a2ml`, six scorecards, `.well-known/ai.txt`, `.gitignore` / `.gitleaksignore`, `.claude/CLAUDE.md`, the `Justfile`, `TOPOLOGY.adoc`, and two workflow files (`echidna-verify.yml`, `secret-scanner-reusable.yml`). The workflow edits are **path rewrites only** — no `uses:` line moved, which is what the lock keys — and `scripts/lock-selfcheck.sh` on this commit returns **SELF-CONSISTENT (rc=0)**, i.e. this commit is safe to pin to. ## One stale path fixed, same class as districts 0 and 1 Rewriting a path in `overlay-protocol.scorecard.a2ml` makes that line **added**, and the line named `.machine_readable/6a2/{META,STATE,ECOSYSTEM}.a2ml` — a directory that has not existed since the rename to `.machine_readable/descriptiles/`. Corrected in place; `check-canonical-names.sh` rc=1 → rc=0. The bare `6a2/PLAYBOOK.a2ml` in prose about sibling repos is left alone deliberately (the gate treats a line describing the deprecation as descriptive). ## Gates, run in this tree against a clean copy of `main` (`92e25e2`) | gate | result | |---|---| | `scripts/check-standards-map.sh` | **PASSED**, `entry_count = 121` | | `scripts/check-canon-lockstep.sh` | **8 passed / 0 failed / 2 skipped** | | `scripts/check-canonical-names.sh` | rc=0 | | `scripts/lock-selfcheck.sh` | **SELF-CONSISTENT** rc=0 | | every `scripts/check-*.sh` | **rc identical to the control — all of them, no exceptions to explain** | | stale-reference audit | 7 moved-away sources, **0 leftovers** (2655 files scanned) | The control was a real copy of `main`, not a linked worktree — a linked worktree makes `check-workflow-staleness.sh` report false failures, because `.git` there is a file and the script's `[ -d "$REPO_ROOT/.git" ]` fallback never runs.
hyperpolymath
added a commit
that referenced
this pull request
Sep 18, 2026
Bring main at 6054f0f (feat deed conformance lane) into PR #833. Resolved: - .gitignore, INTENT, scorecards, CRG, QUICKSTART-DEV, README, TOPOLOGY, INNERVATION, developers/index, build-registry, standards-map: took origin/main (theirs) — it reflects the 2-protocols (2-protocols/) and 3-practice reorgs that landed after PR branched at 176d1f7. - 1-formats/a2ml/*/.editorconfig etc (AA): both added identical RSR template files at same destination — kept theirs (identical to ours). - agentic/anchor/ecosystem/k9/meta/neurosym/playbook old dirs (DD): both deleted after move — removed. - 2-protocols/* (UA): added by origin/main — kept (the 7 plain moves of district 2). The 1-formats district itself (11 plain moves in 0718580/cfbb66 and 8 pointer moves in 6358451/92e25e2) is already on main via #827 and #829, so this merge is a no-op for that district except for the 2-protocols gap. After this, PR #833 is mergeable via squash (merge commits are forbidden).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
The remainder of district 1 — the 8
(pointer)entries. #827 merged at 20:08:21Z from the branch's first commit; this commit was pushed moments later, so it never reachedmain. Cherry-picked onto currentmaincleanly (15af5b0), no conflicts.1-formats/deedand1-formats/contractilesare inmain;1-formats/k9/and1-formats/a2ml/are not, and there are noPOINTER.adocstubs yet. This PR supplies them.The convention (owner ruling, 2026-09-17)
Each old path keeps ONE
POINTER.adoc— SPDX lines, title, a relative link to the new home, and a stable, greppable TOML block:Nothing in it is normative. No other content remains in the old directory.
232 files relocated, 183 references rewritten, 8 stubs.
Two things the map is silent on — resolved and recorded, not decided silently
All seven
*-a2mldirs carried the same target,1-formats/a2ml/. Taken literally that merges seven directories into one, and 34 relative paths collide: sevenREADME.adoc, seven.editorconfig, seven.gitattributes, seven.gitignore, seven.machine_readable/descriptiles/*.a2ml, and 28 more.docs/reorg/STREAM-PROMPTS.adocnames the seven homes normatively — "the descriptiles family becomes A2ML profiles: a2ml/state, a2ml/meta, a2ml/ecosystem, a2ml/agentic, a2ml/neurosym, a2ml/playbook, a2ml/anchor" — so each profile becomes a subdirectory and each record'stargetrecords the refinement.k9-svc's target already named its own directory and is unchanged.A pointer entry's
fromis NOT rewritten, unlike a plain move. The old path still exists — it holds the stub — so GATE D assertions 1 and 2 keep holding, and the record keeps stating where the migration started. A plain move rewritesfrombecause there the old path stops existing.Also here
Three re-added scorecard lines named
.machine_readable/6a2/, a directory that has not existed since the rename to.machine_readable/descriptiles/(playbook-a2ml×2,state-a2ml×3). Corrected — added lines only, so the chartered wider migration is untouched.check-canonical-names.shrc=1 → rc=0.Gates, run in this tree against current
mainscripts/check-standards-map.shentry_count = 120, 8 records annotated with the stubscripts/check-canon-lockstep.sh37cb5f67…)check-canonical-names.shscripts/check-*.sh3cdaa69control