Row 268 build notes (Gizmoduck)

Case 2 C2-01c, playground levels. Gitea #1773, Vikunja 464. Brief: docs/plans/2026-10-20_case2-rows.md, "C2-01c playground levels: universe-level prefixes and draft universes" (blob a6ac627c8). The ruling is agents/gosalyn/work/case2/DESIGN.md "Ruling after r11: playgrounds at three levels" (:49-88 at db1e7732a), and it wins where the two differ. Reviewer Webby, gate owner Sage. Branch gizmoduck/row268 from refactor db1e7732a. Line numbers are on this branch unless a commit is named.

mapping.mjs

kind (:71). An entry with a kind key must say "hybrid" or "draft". Before, a plain universe with kind refused as an unknown key, and kind: "draft" did the same.
A draft (:73-86) refuses books with its own message before the key check, so the cause reads plainly. It takes kind, name and playground, needs one prefix or more, and comes back as { kind: 'draft', name, books: [], playground }, frozen with the rest.
The prefix level check moved out of the per-entry loop to :127-140, after every entry is read, because it needs every entry's books. It runs after the book-holds-book, prefix-holds-prefix and listed-twice checks, so an overlap still reports as before. For each prefix and each book folder:
- equal to any book folder: library-mapping-invalid (brief, What ships, "or equal to a book folder");
- inside or holding another entry's book: library-playground-other-universe, and the message says which, with the book and its entry;
- holding its own entry's book: library-mapping-invalid. A prefix inside its own book is book level, and one that touches no book is universe level. A draft has no books, so its prefixes are either outside every book or refused as another entry's.
sources (:117-120) now refuses any entry with a kind, so a draft can't be a source either. The message changed from "not a non-hybrid universe" to "not a plain universe". mapping.test.mjs:61 on db1e7732a pinned the old words, and that line moves with it.
library-playground-outside-book is gone from packages and docs/case2.

scope.mjs

classify (:12-24) now runs two passes. The first finds a prefix in any entry, and the file is playground with that entry's id and book set to the entry's book folder that holds the prefix, or null. The second finds a book folder, and the file is canon. place (:26-32) works out type and folder from the first folder under the prefix or the book, as before. The validator keeps prefixes from overlapping, so the first pass finds at most one.

Readers on this base

reader.mjs:182 and :194 spread classify's answer into each file record, so a universe-level or draft file carries book: null. Nothing in the reader reads book.
reader.mjs:206-209. R5 fires for a canon file linking into any playground. R6 fires when the target's universe differs and isn't a source. A draft can't be a source, so a link into one gives R5 and R6. A link into the file's own universe-level prefix gives R5 only. No code change was needed. The new test covers both.
survey.mjs:66 and mirror.mjs:246 read only scope. mirror.mjs:251 calls readLibrary and checks only path.
No other package calls this classify or reads universes (git grep over packages/*/src).
C2-05a (row 216) and C2-06 (row 217) have no candidate branch on origin at the time of writing. I check again before in-review.

Tests

mapping.test.mjs: the old outside-book test splits into the other-universe refusals (inside another entry's book, holding one, a draft prefix inside a book), the mapping-invalid ones (equal to a book, own or another's, and holding its own), universe level in a plain universe and in a hybrid with books: [], and the draft shape (frozen with books: [], with books, with none or empty prefixes, an extra key, and five bad kind values). The overlap test gains a cross-entry hold and a cross-entry duplicate. The hybrid test gains a draft source. The caller-supplied fail test now uses Second World/Playground/ and sees the new code, since Elsewhere/ is valid now.
scope.test.mjs, new: one case per level (book, universe in a plain universe, universe in a hybrid, draft), .canvas under each new prefix staying unmapped, prefixes first inside a book that holds a prefix, and the reader case for R5 and R6, with book: null on the read records.
business.test.mjs: Elsewhere/Playground/ now loads, and Second World/Playground/ refuses with library-playground-other-universe through validateBusinessDocument.

Docs

packages/library/README.md: the universe keys, a line on the three levels, the refusal table and the Scope section.
docs/case2/SETUP-SHEET.md "Your playground": one line per level and the draft entry.
docs/case2/SURVEY-RUN.md:114: the new code and message.

Hash pins

git grep -E '[0-9a-f]{64}' over packages/*/tests finds no pin on any changed file.

Runs

r2 ecd9b35eb on dcd8d4dda, Sage's CLEAR sage-2449, one pass with the first red stopping it (run-268-c.sh), 2026-10-22 04:40:22Z to 04:42:17Z, 115 s. M1, M2 and M3 all killed (scope.test 2 of 3 failed, mapping.test 2 of 11, mapping.test 1 of 11), and each file's sha256 matched after the restore. Brief files 14/14, library 83/83, business 209/209. test-auth 15, test-conductor 17, test-config 31, test-discord 78, test-extension-package 18, test-foundation 44, test-land-work 86, test-queue 28 plus 156 node, test-release 14, test-task 91, with 0 failures. Node skipped 0. The scripts skipped three cases: test-queue's verify and render check (not the canonical root) and test-task's live provider cases twice (row 244). Neither test-task skip is a dead-Docker skip.
r3 aca53c4f0 on 0fa7bf421, after row 191 landed. The cherry-pick of r2 has range-diff = and stable patch-id 2942acc8e6e2b0171b96ebbf033ab5c08c0f0eac. Rerun on CLEAR sage-2461, 04:50:29Z to 04:50:38Z: brief files 14/14, library 83/83 (survey.test on 191's scripts/mosaic), business 209/209, 0 skipped. Webby approved r3 as a carry (webby-0112).
r4 c27207f6e on ce6a96ad6, after row 205 landed (sage-2466: 205's gate went first). Cherry-pick of r3 with range-diff = and the same patch-id. Rerun on CLEAR sage-2480, 05:04:50Z to 05:04:58Z: brief files 14/14, library 83/83, business 209/209, 0 skipped.
Every sweep found the worktree clean and no node process in it or in its temp dir.

6.3 KiB Raw Permalink Blame History