@bongos/core 1.19.1067 → 1.19.1069

package/modules/hall-ui/public/studio.states.json

@@ -1,5 +1,5 @@
 {
-  "_": "The Studio (artist mode), R06 of goal 1000074 (task 1003117). A calm room that surfaces the artist's real work — backlog review requests (cascade, R04) and open copy flags (R02) — one piece at a time, never a table. Against the kit's own stub the page renders its EMPTY state (no /tasks or /copy-desk feed), which is a state the floors must hold in. TO SEE IT POPULATED, point the kit at the hall-preview harness instead: `node scripts/hall-preview/server.js --port 4629 --fixture-me` then `render.js --base-in http://builders.localhost:4629 --base-out http://builders.localhost:4629`. That harness answers /tasks from fixtures/tasks.json (whose first row IS a cascade artist review), the reviewed task from fixtures/tasks__detail.json (which carries a visual_url), and the visual itself as a generated stand-in — task 1003829, where the review card's picture became the subject of the card and a broken frame stopped being reviewable. An earlier version of this note named a studio__reviews.json fixture; there is no such file and there never was.",
+  "_": "The studio home (task 1003971 / BV2.TW16), built 1:1 on docs/design/mocks/tweak-mode/Main.dc.html: the night room, the greeting and its sub-line (editable in place as a tweak of builders:studio), the tally, Resume, and three quick actions opening glass panels (the Tweak/CopyWrite Flow, the Approval queue, Artist Review Status). Behind a quiet door, the older reviews (R06 of goal 1000074, task 1003117; retired in TW14) still answer the reviews filed before Tweak Mode. Against the kit's own stub the page renders its unread states (no copy-desk feeds). TO SEE IT POPULATED, point the kit at the hall-preview harness: `node scripts/hall-preview/server.js --port 4636 --fixture-me` then `render.js --base-in http://builders.localhost:4636 --base-out http://builders.localhost:4636`. The harness answers the tally, the pages and the next page from copy-desk__tally.json, copy-desk__pages.json and copy-desk__next.json (built by the real composers), Resume's counter from copy-desk__pages__draft.json, the studio's own lines from copy-desk__pages__draft-studio.json, the claim and the draft save from its CANNED WRITES, and the older reviews from tasks.json (whose first row IS a cascade artist review).",
   "page": "/builders/studio",
   "surface": "hall-ui",
   "stub": {
@@ -25,8 +25,9 @@
     "load failed"
   ],
   "states": {
-    "focus": {
+    "home": {
       "auth": true,
+      "_": "The home: Resume, the three quick actions, the tally top right.",
       "actions": [
         [
           "wait",
@@ -35,13 +36,172 @@
       ],
       "expect": {
         "visible": [
-          "#studio-focus"
+          "#studio-greet",
+          "#st-flow",
+          "#studio-approvals",
+          "#st-status"
         ]
       }
     },
     "out": {
       "auth": false
     },
+    "flow": {
+      "auth": true,
+      "_": "The Tweak/CopyWrite Flow: the recommended page, take it, pick another.",
+      "actions": [
+        [
+          "wait",
+          700
+        ],
+        [
+          "click",
+          "#st-flow"
+        ],
+        [
+          "wait",
+          300
+        ]
+      ],
+      "expect": {
+        "visible": [
+          ".st-dialog",
+          "[data-take]"
+        ]
+      }
+    },
+    "flow-pick": {
+      "auth": true,
+      "_": "Pick another: the other pages as chips.",
+      "actions": [
+        [
+          "wait",
+          700
+        ],
+        [
+          "click",
+          "#st-flow"
+        ],
+        [
+          "wait",
+          300
+        ],
+        [
+          "click",
+          "[data-pick]"
+        ],
+        [
+          "wait",
+          200
+        ]
+      ],
+      "expect": {
+        "visible": [
+          "#st-picks"
+        ]
+      }
+    },
+    "status": {
+      "auth": true,
+      "_": "Artist Review Status: three surface lines, N of M tweaked.",
+      "actions": [
+        [
+          "wait",
+          700
+        ],
+        [
+          "click",
+          "#st-status"
+        ],
+        [
+          "wait",
+          300
+        ]
+      ],
+      "expect": {
+        "visible": [
+          ".st-surfaces"
+        ]
+      }
+    },
+    "words-offer": {
+      "auth": true,
+      "_": "A click on the studio's own words offers to take the studio page.",
+      "actions": [
+        [
+          "wait",
+          700
+        ],
+        [
+          "click",
+          "#studio-greet"
+        ],
+        [
+          "wait",
+          500
+        ]
+      ],
+      "expect": {
+        "visible": [
+          "#st-offer",
+          "#st-offer-take"
+        ]
+      }
+    },
+    "words-edit": {
+      "auth": true,
+      "_": "Taken: the lines the studio's reading lists are typed over in place, saved to its draft.",
+      "actions": [
+        [
+          "wait",
+          700
+        ],
+        [
+          "click",
+          "#studio-greet"
+        ],
+        [
+          "wait",
+          500
+        ],
+        [
+          "click",
+          "#st-offer-take"
+        ],
+        [
+          "wait",
+          700
+        ]
+      ],
+      "expect": {
+        "visible": [
+          "#st-editing"
+        ]
+      }
+    },
+    "reviews": {
+      "auth": true,
+      "_": "The quiet door: the reviews filed before Tweak Mode, one at a time.",
+      "actions": [
+        [
+          "wait",
+          700
+        ],
+        [
+          "click",
+          "#st-older"
+        ],
+        [
+          "wait",
+          900
+        ]
+      ],
+      "expect": {
+        "visible": [
+          "#studio-focus"
+        ]
+      }
+    },
     "full": {
       "auth": true,
       "_": "Full screen (task 1004327): the shell switch pressed — the room fills the window, one button brings the chrome back.",
@@ -61,7 +221,7 @@
       ],
       "expect": {
         "visible": [
-          "#studio-focus",
+          "#studio-greet",
           "#fullscreen-toggle"
         ],
         "hidden": [

package/modules/hall-ui/public/task.html

@@ -57,7 +57,7 @@
 
 <!-- The app shell (sidebar + top bar + footer). Dependency-free; runs at parse
      time so the chrome exists before the deferred page scripts execute. -->
-<script src="/builders/shell.js?v=2026-09-27-fullscreen"></script>
+<script src="/builders/shell.js?v=2026-09-28-archive"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- shared frontend toolkit (window.OTB) — loaded FIRST so task.js can pull from it. -->

package/modules/hall-ui/public/thinking.html

@@ -138,7 +138,7 @@
   </div>
 </div>
 
-<script src="/builders/shell.js?v=2026-09-27-fullscreen"></script>
+<script src="/builders/shell.js?v=2026-09-28-archive"></script>
 <script src="/builders/palette.js" defer></script>
 
 <script src="/builders/idea-objects.js?v=2026-09-27-split"></script>

package/modules/hall-ui/public/tweak-editor.html

@@ -102,7 +102,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-09-27-fullscreen"></script>
+<script src="/builders/shell.js?v=2026-09-28-archive"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-23-contrib"></script>
 <script src="/builders/tweak-editor-lib.js?v=2026-09-28-tw10"></script>

package/modules/hall-ui/public/watch.html

@@ -162,7 +162,7 @@
 
 <!-- The app shell (sidebar + top bar). Dependency-free; loaded FIRST so the
      chrome exists before the page script runs. -->
-<script src="/builders/shell.js?v=2026-09-27-fullscreen"></script>
+<script src="/builders/shell.js?v=2026-09-28-archive"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- shared frontend toolkit (window.OTB) — loaded before watch.js, which pulls from it. -->

package/modules/hall-ui/public/work.html

@@ -171,7 +171,7 @@
 
 <!-- The app shell (sidebar + top bar + footer). Dependency-free; runs at parse
      time so the chrome exists before the deferred page scripts execute. -->
-<script src="/builders/shell.js?v=2026-09-27-fullscreen"></script>
+<script src="/builders/shell.js?v=2026-09-28-archive"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- shared frontend toolkit (window.OTB) — loaded FIRST so work.js can pull from it. -->

package/modules/hall-ui/records/studio.md

@@ -0,0 +1,47 @@
+# The studio — /studio, the lofi home with Tweak Mode as its four doors (task 1003971)
+
+**BV2.TW16 (goal 1000095; [ADR 0341](../../../docs/adr/0341-the-page-is-the-unit-of-tweak-mode.md) D2, D5, D8, D11).** Built 1:1 on the owner-approved master design [`docs/design/mocks/tweak-mode/Main.dc.html`](../../../docs/design/mocks/tweak-mode/README.md) ("I like the lofi design for now"): the night room (the window with its moon, stars and city lights, the floor, the lamp and its glow, the mug and the plant), the eyebrow and the tally pill, "Good evening." and its sub-line, "click any words here to rewrite them", Resume, and three glass quick actions that open panels in place.
+
+Files: `studio.html` (the markup), `studio.css` (the artboard's inline styles, one rule per element, then the older reviews' garden in the hall's tokens), `studio-lib.js` (the pure rules, `window.OTBStudioLib`, node-require-safe) and `studio.js` (the reads, the panels, the words, and the garden). It also loads `tweak-editor-lib.js` for the page names and the draft body, and TW12's Approval queue (`approval-queue*.{js,css}`, `records/approval-queue.md`), unchanged.
+
+- **The four reads.** `GET /copy-desk/tally` (the pill: credits, pages tweaked, this week), `GET /copy-desk/next` (the Flow's recommendation and "pick another", and `resume`, the held page), `GET /copy-desk/pages` (Artist Review Status's three surface lines and the whole count), and, when a page is held, `GET /copy-desk/pages/:id/draft` for Resume's "12 of 38 lines". Signed out, none of them is asked.
+- **Resume** links to `/builders/tweak-editor?page=<held page>` (TW10). With nothing held it is not drawn, and the page's own sub-line stands.
+- **The Flow** shows the recommendation (its `why_line`); "pick another" opens the others as chips and a chip swaps the page in place; "take it" is the claim route on THAT page (ADR 0341 D5), then the editor. A refusal stays in the panel in words.
+- **The Approval queue** is TW12's component: `OTBApprovalQueue.mount({ api, apiBase, writes, onCount })`, opened from the quick action, with `onCount` feeding its detail line.
+- **Artist Review Status** is three meters (landing, builders hall, status, "N of M tweaked"), each against its own surface's page count, so studio.js sits in `tests/hall_audit.mjs` `METERS`. The landing line names the instance's own address, stamped by the server from the branding pack (`<main data-apex="{{publicOrigin}}">`).
+
+## The studio's own words are a tweak of the studio page
+
+The greeting and its sub-line are the studio page's own lines (builders:studio), so rewriting them is a round of that page (ADR 0341 D2), never a live edit. The smallest honest flow:
+
+1. A click on the words (or on the hint, which is a button for the keyboard) reads `GET /copy-desk/pages/builders:studio/draft`. If the artist already holds the studio page, the words open for editing at once.
+2. Otherwise a small glass offer says the words are the studio page itself, with "take the studio page" and "not now". Nothing is claimed until the artist says so.
+3. Taken (the claim route), each word on the page is matched to its line in the studio's reading (`matchLine`: a `{…}` hole matches any run of words, the most specific line wins, a line mostly of holes never matches, shell text never), and the matched elements become `contenteditable`, showing the reading's text, holes and all, as the editor does.
+4. Typing autosaves the WHOLE draft of the studio page (the lines typed here and any the editor saved) through `PUT /copy-desk/pages/builders:studio/draft`, debounced and on blur. A strip under the words says "The studio page is yours · N of M rewritten · saved · submit it in the editor". Submit is the editor's: one submit path, not two.
+
+The page keeps its words until the round is submitted, applied, approved and shipped like any other. A word the reading does not list (a sentence newer than the last reading) keeps its words and loses the cue.
+
+**Why the sub-line's sentence is in studio.js, not studio-lib.js.** The copy registry places a line at its `textContent` assignment. Built inside the lib it read as unplaced, and the reader's pattern tier then matched it to the generic `{…} of {…}` row (sky-panel.js). Written where studio.js assigns it, it is placed on studio.js, which is the page's own file and wins.
+
+## The older reviews stay one quiet door away
+
+The garden this page used to be (R06 of goal 1000074; retired in TW14) still answers the reviews filed before Tweak Mode, because they may hold a deploy under the strict artist gate. It sits behind a quiet line under the actions ("1 review from before Tweak Mode still waits"), shown only while a review waits, and opens in its own dialog in the hall's tokens with the focus card, the stones and the two links, unchanged. Its verdict writes are unchanged.
+
+## What it writes
+
+`WRITE_ROUTES` in studio.js, pinned in `tests/hall_studio_world.mjs`: the four verdicts on an older review, the Approval queue's approve and send-back, and TW16's two, `claim` (take a page's round) and `draft` (the studio page's whole draft). Six write sites; none writes a live string.
+
+## Where it differs from the artboard, and what forced it
+
+- **The words are the ledger's**, not the sample's: 180 credits, 6 pages tweaked, +60 this week, "2 of 75 lines", "6 of 38 pages tweaked" on the harness fixtures (built by the real composers). The artboard's are sample data (the mocks README).
+- **The recommendation order is the spec's** (asked, changed, untweaked), so the chips read Tasks, Goals, Privacy, Terms where the artboard's sample has Work, Privacy, Goals, Explore (ADR 0341 pick 8). "Tasks" is builders:work's own title.
+- **The hint is #85858c, not #6f6f76**: #6f6f76 on the room's #07080d is about 4:1, under the AA floor for 12.5px type.
+- **The panels' scrim is .94 over the light hall and .88 on a phone** (the artboard's .42 over the dark room otherwise), TW12's reason: the glass's grey words fall under AA at .42 over a light page.
+- **A quick action is at least 72px and grows**, with 10px of padding, so a long detail wraps rather than clipping.
+- **The window never slides under the words** (its left edge holds at 680px) when the hall chrome narrows the room.
+- **Resume is not drawn when nothing is held**; the artboard always draws it (sample).
+- **Not on the artboard at all:** the hall chrome view (the full-screen switch off, the default since TW20), the full-screen button top right, light mode, the phone layout (the pill across the top as three stacked figures, the window scaled whole to the top right, the desk on a floor at the bottom), the words' offer, edit strip and refusals, the older reviews' door and dialog, and the panels' loading and could-not-read lines.
+
+## The proof
+
+`studio.states.json` renders sixteen states (home, out, flow, flow-pick, status, words-offer, words-edit, reviews, full, full-back and TW12's six) against the hall-preview harness (`node scripts/hall-preview/server.js --port 4636 --fixture-me`), which answers the tally, the pages and the next page from `copy-desk__tally.json`, `copy-desk__pages.json` and `copy-desk__next.json`, the studio's own lines from `copy-desk__pages__draft-studio.json` (a new fallback ahead of the editor's catch-all), and the claim and the save from its CANNED WRITES. All clean at 1440, 390 and 320, dark and light. The studio fixture carries only the studio's PLACED lines: the page reader treats every string a page reads as data, so a fixture holding its unplaced lines would make the reading drop them. Behaviour: `tests/hall_studio_home.mjs` (the pure rules over the real composers, and the real page in a mini-DOM: the four reads, the panels, take it, and the words typed over and saved as the whole draft).

package/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@bongos/core",
-  "version": "1.19.1067",
+  "version": "1.19.1069",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@bongos/core",
-      "version": "1.19.1067",
+      "version": "1.19.1069",
       "license": "AGPL-3.0-or-later",
       "dependencies": {
         "express": "^4.21.2",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bongos/core",
-  "version": "1.19.1067",
+  "version": "1.19.1069",
   "description": "Cloud Bongos — the AI-first build platform core (GDS + platform surfaces + module system), installed as a versioned dependency (ADR 0108).",
   "license": "AGPL-3.0-or-later",
   "main": "src/platform-server.js",

package/release-notes.json

@@ -7703,5 +7703,17 @@
       "id": "1004325",
       "text": "A ship that changes a page's words no longer files an \"Artist review\" task. Those reviews came one per ship, and most were thrown away unread. Instead, the page itself shows \"changed since last tweak\" in Tweak Mode, worked out"
     }
+  ],
+  "1.19.1068": [
+    {
+      "id": "1003971",
+      "text": "The Studio is now the lofi home from the approved design: a night room with a window, moon, city lights, a lamp and a plant. Top right, your tally: credits, pages tweaked and this week. Resume takes you back into the page you"
+    }
+  ],
+  "1.19.1069": [
+    {
+      "id": "1004326",
+      "text": "The Ideas and Copy desk tabs are gone from the hall's sidebar, as you decided. Nothing was deleted: both pages still open from their old links and bookmarks, and every idea and flag is kept. New ideas are filed from Your think"
+    }
   ]
 }

package/scripts/hall-preview/server.js

@@ -135,6 +135,11 @@ const FIXTURE_FALLBACKS = [
   // the tweak editor's read (task 1004321): one page's lines and draft serve any
   // page id, since the editor shows one page. A page id carries a colon, which a
   // Windows file name cannot, so there is no per-id file to find first.
+  // The studio's own words (task 1003971): the studio reads ITS page's lines to
+  // open them for editing in place, so builders:studio answers from its own
+  // reading, not the landing page the editor fixture carries. Before the
+  // catch-all below, which it would otherwise never reach.
+  [/^copy-desk\/pages\/builders:studio\/draft$/, 'copy-desk__pages__draft-studio'],
   [/^copy-desk\/pages\/[a-z0-9-]+:[a-z0-9-]+\/draft$/, 'copy-desk__pages__draft'],
   // the Approval queue's renders (task 1004323): a round's named visuals, one
   // fixture for any task id, as the editor read above serves any page.

package/src/module-api.js

@@ -71,7 +71,7 @@ const { responsibilityFor, ROLE_RESPONSIBILITIES } = require('./role-responsibil
 // there. scripts/gds/bump-version.js still rewrites the literal below; it appends
 // the entry to that file. Look for a version's history there, not here.
 // ---------------------------------------------------------------------------
-const CORE_VERSION = '1.19.1067'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
+const CORE_VERSION = '1.19.1069'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
 
 // A namespaced logger so a module's log lines are attributable + consistent.
 // Usage: const log = api.logger('dev-box'); log.info('mounted');

package/tests/hall_audit.mjs

@@ -293,6 +293,10 @@ test('the kit is the ONLY thing in the hall that draws a bar series', () => {
   const METERS = new Set([
     'idea.js',   // .ig-score — one Full-Idea completeness gauge, banded full/part/thin
     'ideas.js',  // .fi-mrow  — the composer's per-field completeness, driven imperatively
+    // .st-surface__fill — Artist Review Status (task 1003971): each surface's
+    // pages tweaked against THAT surface's page count, three separate meters,
+    // never compared with each other (ADR 0341 D8, the artboard's 4px lines).
+    'studio.js',
   ]);
   const handRolled = [];
   for (const f of fs.readdirSync(HALL)) {

package/tests/hall_nav.mjs

@@ -258,12 +258,16 @@ test('sidebar groups read by audience, in order', () => {
   // task 1003455 (goal 1000089): 'blockers' joins the same group, after Tasks —
   // its subject is the project (what's stuck on the owner), not a person or a
   // craft, and its one data source (GET /blockers) is public like Roadmap's.
+  // task 1004326 (BV2.TW15, goal 1000095): 'ideas' and 'copy-desk' LEFT the group.
+  // Owner call 2026-09-27: both are ARCHIVED, not deleted — the pages and routes
+  // stay reachable by URL (the test below holds that), filing happens on Your
+  // thinking, and artist work lives in the Studio.
   // task 1004232 (sky part 4, goal 1000095): 'goal-map' — THE PROJECT SKY — joins
   // directly under 'goals'. The goal map that held the URL took no nav slot on
   // purpose (task 1003479, and tests/goal_map_page.mjs pinned it); the owner
   // granted the sky that slot on 2026-09-24 (ADR 0227 §11), under Goals because
   // it is the goals seen as one picture.
-  assert.deepEqual(nav[0].items.map((i) => i.id), ['home', 'roadmap', 'goals', 'goal-map', 'work', 'blockers', 'board-room', 'ideas', 'thinking', 'copy-desk', 'studio'],
+  assert.deepEqual(nav[0].items.map((i) => i.id), ['home', 'roadmap', 'goals', 'goal-map', 'work', 'blockers', 'board-room', 'thinking', 'studio'],
     'the unlabeled group is the project itself (task 1002425 order)');
   assert.deepEqual(nav[1].items.map((i) => i.id), ['standing', 'profile'], 'You = your own numbers');
   // task 1003444: 'people' LEFT the group — the owner deleted the hall's
@@ -312,6 +316,26 @@ test('every nav link lands on a page that exists', () => {
   assert.deepEqual(dead, [], 'no nav item points at a missing page');
 });
 
+// task 1004326 (BV2.TW15, goal 1000095): ARCHIVED, not deleted. The owner took
+// the Ideas board and the Copy desk off the nav on 2026-09-27 and kept both
+// pages, so old bookmarks, idea.js's "Develop it" link and the studio's
+// old-reviews dialog still land. Both halves are held here: the nav offers
+// neither (checked in the source too, because the copy-desk item was
+// module-gated and a boot without that module would never render it anyway),
+// and both page files are still served. tests/hall_page_gate_map.mjs keeps
+// their server-side gate rows.
+test('THE ARCHIVE: Ideas and Copy desk are off the nav, and both pages still exist', () => {
+  const items = parseNav(boot().sidebarHtml).flatMap((g) => g.items);
+  for (const id of ['ideas', 'copy-desk']) {
+    assert.equal(items.some((i) => i.id === id), false, `the nav no longer renders '${id}'`);
+    assert.doesNotMatch(SRC, new RegExp(`id: '${id}'`), `shell.js NAV declares no '${id}' item`);
+    assert.doesNotMatch(SRC, new RegExp(`href: '/${id}'`), `and no item points at /${id}`);
+    assert.ok(fs.existsSync(path.join(HALL, `${id}.html`)), `${id}.html is still in the hall, so /${id} still loads`);
+  }
+  assert.match(fs.readFileSync(path.join(HALL, 'studio.js'), 'utf8'), /href="\/builders\/copy-desk"/,
+    'the studio\'s old-reviews dialog still links to the copy desk');
+});
+
 test('href check actually CATCHES a dead link', () => {
   assert.equal(hrefResolves({ href: '/no-such-page', external: false }), false);
   assert.equal(hrefResolves({ href: '/drachmae', external: false }), true);

package/tests/hall_page_gate_map.mjs

@@ -56,6 +56,8 @@ const ORACLE = {
   // module's pages: copy-desk (task 1003113) and ideas (task 1002928) are open to
   // every rank by design, and collab's reads (task 1003172) are scoped to the
   // caller by the server — so for all three, sign-in IS the whole gate.
+  // task 1004326 (BV2.TW15): copy-desk and ideas are ARCHIVED — off the nav, not
+  // deleted — so both rows stay: the pages still load by URL, on this tier.
   '/builders/copy-desk': 'requireBuilderPage',
   // task 1003117 (R06 of goal 1000074): the Studio (artist mode) — open to every
   // rank like copy-desk (an artist is a craft, not a rank), so sign-in is the