@bongos/core 1.24.35 → 1.24.36

package/modules/hall-ui/public/primer-live.js

@@ -0,0 +1,188 @@
+// primer-live.js — the two LIVE sections of the Primer's "Credits and karma"
+// chapter: the project's treasury (what it has spent, and what it has awarded
+// builders for that spend) and the published security bounty rates.
+//
+// Task 1005046 (owner decision 2026-11-03, idea 1001311): the Economy page
+// (/drachmae) folded into the Primer so credits and karma are explained once.
+// Its prose became the chapter; these two sections are the part that was never
+// prose — numbers read from the server when the reader opens the page — so they
+// moved here whole, from drachmae.js (tasks 2174 and 1003446), as a small
+// module primer.js calls rather than more lines in primer.js.
+//
+// The contract each section keeps, unchanged from the Economy page:
+//   * it reads an endpoint that already existed — /public/cost-summary (the
+//     status page's treasury chart) and /public/bounty-table — no new route;
+//   * every mark is drawn by the shared chart kit (hall-kit.js, window.OTBKit);
+//   * the currency word is the branding pack's, never a hardcoded unit;
+//   * a feed that cannot be read degrades to NOTHING — the section is removed,
+//     never left as an empty panel or an outline entry that leads nowhere.
+// What is new: each section is placed the moment the article renders, with a
+// Loading… line, so the reader sees that something is on its way.
+
+(() => {
+  'use strict';
+
+  const BOUNTY_URL = '/api/bongos/public/bounty-table';
+  // NOT a new endpoint: the same /public/cost-summary the signed-out status page
+  // draws as a cumulative line. Its `daily[]` is "the treasury chart's
+  // cumulative line"; the series was in the payload all along.
+  const TREASURY_URL = '/api/bongos/public/cost-summary';
+
+  // The two sections' addresses. Kept from the Economy page, so a link someone
+  // copied there (/drachmae#the-treasury) names the same section here.
+  const SECTIONS = {
+    treasury: { id: 'the-treasury', title: 'The treasury, so far' },
+    bounty: { id: 'security-bounty-rates', title: 'Security bounty rates' },
+  };
+
+  const esc = (s) => window.OTB.escapeHtml(s);
+  const currencyLabel = () => (window.__BRANDING__ && window.__BRANDING__.currency
+    && window.__BRANDING__.currency.label) || 'credits';
+  const caps = (s) => s.charAt(0).toUpperCase() + s.slice(1);
+
+  // A section with its heading and a Loading… line, ready to be placed. The h3
+  // carries the address from the start, so a deep link has somewhere to land
+  // even before the numbers arrive.
+  function headingHtml(kind) {
+    const def = SECTIONS[kind];
+    return `<h3 id="${esc(def.id)}">${esc(def.title)}</h3>`;
+  }
+  function placeholder(kind) {
+    const section = document.createElement('section');
+    section.className = 'primer-live';
+    section.dataset.live = kind;
+    section.setAttribute('aria-busy', 'true');
+    section.innerHTML = headingHtml(kind) + '<p class="hall-loading" role="status">Loading…</p>';
+    return section;
+  }
+
+  // Replace the Loading… line with the real body, or take the section away.
+  function settle(section, bodyHtml) {
+    if (!bodyHtml) { section.remove(); return false; }
+    section.innerHTML = headingHtml(section.dataset.live) + bodyHtml;
+    section.removeAttribute('aria-busy');
+    return true;
+  }
+
+  async function readJson(url) {
+    try {
+      const r = await fetch(url, { credentials: 'same-origin' });
+      if (!r.ok) throw new Error(`${url} → ${r.status}`);
+      return await r.json();
+    } catch (err) {
+      console.warn('[primer] live section unavailable:', err.message);
+      return null;
+    }
+  }
+
+  // ---- the security bounty rate card (task 2174) ---------------------------
+
+  function bountyHtml(payload) {
+    const rows = Array.isArray(payload && payload.table) ? payload.table : [];
+    if (!rows.length) return '';
+    const currency = payload.currency || currencyLabel();
+    return `<p>Find a flaw in the system’s own walls and report it: rewards are paid in `
+      + `${esc(currency)} by severity. These are the live numbers, read from the server `
+      + 'when you opened this page, so a tuned rate shows up here immediately.</p>'
+      + '<table><thead><tr><th>Severity</th>'
+      + `<th>${esc(caps(currency))}</th>`
+      + '<th>What counts</th></tr></thead><tbody>'
+      + rows.map((r) => {
+        // `overridden` means this project tuned the tier off its default.
+        const tuned = r.overridden ? ' <em>(tuned)</em>' : '';
+        return `<tr><td><strong>${esc(r.severity || '')}</strong></td>`
+          + `<td>${esc(String(r.drachmae ?? ''))}${tuned}</td>`
+          + `<td>${esc(r.blurb || '')}</td></tr>`;
+      }).join('')
+      + '</tbody></table>';
+  }
+
+  async function fillBounty(section) {
+    return settle(section, bountyHtml(await readJson(BOUNTY_URL)));
+  }
+
+  // ---- the treasury (task 1003446) -----------------------------------------
+
+  // One cumulative figure: the plot, the number it ends on, and the table twin
+  // that keeps it out of picture-only territory.
+  function treasuryFigure({ id, title, points, fmt, foot }) {
+    const kit = window.OTBKit;
+    if (!points.length) return '';
+    const last = points[points.length - 1];
+    const series = kit.timeStepSeriesHtml(points, { x0: points[0].x, x1: last.x, yMax: last.value });
+    const { endX, endY } = series.geometry;
+    const day = (t) => new Date(t).toISOString().slice(0, 10);
+    // Every 7th day plus the last: one row per calendar day would be a table
+    // nobody finishes reading.
+    const twinRows = points.filter((p, i) => i % 7 === 0 || i === points.length - 1);
+    return `<figure class="pchart" id="${esc(id)}">
+      <figcaption class="pchart__title">${esc(title)}</figcaption>
+      ${kit.plotSvgHtml({
+    series: series.body,
+    // No readout is wired here, so no focus stop and no dead crosshair.
+    interactive: false,
+    ariaLabel: `${title}: ${fmt(last.value)} as of ${day(last.x)}`,
+    label: kit.plotValueLabelHtml(endX, endY - 8, fmt(last.value), 'end'),
+    leftTick: day(points[0].x),
+    rightTick: day(last.x),
+  })}
+      <details class="pchart__twin">
+        <summary>Read it as a table</summary>
+        <table class="ledger pchart__table"><thead><tr><th>Day</th><th>${esc(title)}</th></tr></thead><tbody>
+        ${twinRows.map((p) => `<tr><td>${esc(day(p.x))}</td><td>${esc(fmt(p.value))}</td></tr>`).join('')}
+        </tbody></table>
+      </details>
+      <p class="pchart__foot">${esc(foot)}</p>
+    </figure>`;
+  }
+
+  function treasuryHtml(payload) {
+    const kit = window.OTBKit;
+    if (!payload || !kit) return '';
+    const currency = currencyLabel();
+    const usd = (n) => `$${Number(n || 0).toLocaleString(undefined, { maximumFractionDigits: 0 })}`;
+    const num = (n) => Number(n || 0).toLocaleString();
+    // The server already ran generate_series, so every calendar day is present
+    // and a flat run is a real flat run rather than a missing sample.
+    const spend = kit.cumulateByDay(payload.daily, { valueOf: (r) => r.amount_usd });
+    const earned = kit.cumulateByDay(payload.daily_credits, { valueOf: (r) => r.credits });
+    // Both series empty is a treasury with nothing in it yet: no section at all.
+    if (!spend.length && !earned.length) return '';
+    const figures = [
+      treasuryFigure({
+        id: 'treasury-spend', title: 'Spent, cumulative', points: spend, fmt: usd,
+        foot: 'Every recorded cost — API, infra, compute, art — added up day by day.',
+      }),
+      treasuryFigure({
+        id: 'treasury-earned', title: `${caps(currency)} awarded, cumulative`, points: earned, fmt: num,
+        foot: `What the project has awarded builders, in ${currency}, day by day.`,
+      }),
+    ].filter(Boolean).join('');
+    // Where the money went, as the kit's bar series. Categories arrive sorted
+    // biggest-first.
+    const byCategory = (payload.by_category || []).slice(0, 8);
+    const categories = byCategory.length
+      ? '<h4 id="treasury-by-category">Where it went</h4>'
+        + kit.barSeriesHtml(
+          byCategory.map((c) => ({ label: c.category, value: c.total_usd, valueLabel: usd(c.total_usd) })),
+          { list: true, ariaLabel: 'Spend by category', valueWidth: '84px' },
+        )
+      : '';
+    return '<p>These are this project’s real numbers, read from the server when you '
+      + `opened this page. It has spent <strong>${esc(usd(payload.total_usd))}</strong> `
+      + `and awarded <strong>${esc(num(payload.total_value_credits))} ${esc(currency)}</strong> `
+      + 'for the work that money bought.</p>'
+      + `<div class="pcharts">${figures}</div>`
+      + categories;
+  }
+
+  async function fillTreasury(section) {
+    if (!window.OTBKit) {
+      console.warn('[primer] OTBKit missing — the treasury section needs the chart primitive');
+      return settle(section, '');
+    }
+    return settle(section, treasuryHtml(await readJson(TREASURY_URL)));
+  }
+
+  window.OTBPrimerLive = { SECTIONS, placeholder, fillBounty, fillTreasury, bountyHtml, treasuryHtml };
+})();

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

@@ -4,14 +4,14 @@
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
   <title>Primer — {{worldName}}</title>
-  <meta name="description" content="The guide a new builder reads on day one. What {{productName}} is, how the build system works, the claim-to-ship lifecycle, the rank ladder, and {{currency}} and karma.">
+  <meta name="description" content="The guide a new builder reads on day one. What {{productName}} is, how the build system works, the claim-to-ship lifecycle, the rank ladder, {{currency}} and karma, and how versions organise the work, each with its diagram.">
   <link rel="icon" href="data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'><text x='16' y='24' font-size='24' text-anchor='middle' font-family='sans-serif'>⌂</text></svg>">
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
   <link rel="stylesheet" href="/builders/style.css?v=2026-07-02-shell1">
   <link rel="stylesheet" href="/builders/room.css">
   <link rel="stylesheet" href="/builders/primer.css?v=2026-07-02-shell1">
-  <link rel="stylesheet" href="/builders/diagram-viewer.css?v=2026-06-14-diagviewer-1">
+  <link rel="stylesheet" href="/builders/diagram-viewer.css?v=2026-11-04-reading-room">
 </head>
 <!-- `room` opts this page into the reading-room archetype's composition tokens
      (room.css). They sit on the body, never in a page :root — the branding
@@ -112,15 +112,20 @@
 
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
-<script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-11-04-one-market-watch"></script>
+<script src="/builders/craft-mode.js?v=2026-11-04-reading-room"></script>
+<script src="/builders/shell.js?v=2026-11-04-reading-room"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- the shared markdown reader (window.OTBMdReader) — primer.js renders through
      it rather than carrying a second copy of the grammar. -->
 <script src="/builders/md-reader.js" defer></script>
-<script src="/builders/primer.js?v=2026-05-29-primer-1" defer></script>
-<script src="/builders/diagram-viewer.js?v=2026-06-14-diagviewer-1" defer></script>
+<!-- The credits chapter's live sections (task 1005046, from the retired Economy
+     page): the chart kit first, then the module that draws with it, both before
+     primer.js, which places them once the article renders. -->
+<script src="/builders/hall-kit.js" defer></script>
+<script src="/builders/primer-live.js?v=2026-11-04-reading-room" defer></script>
+<script src="/builders/primer.js?v=2026-11-04-reading-room-lazy" defer></script>
+<script src="/builders/diagram-viewer.js?v=2026-11-04-reading-room" defer></script>
 <script src="/builders/copy-on-click.js?v=2026-06-01-copy-1" defer></script>
 </body>
 </html>

package/modules/hall-ui/public/primer.js

@@ -2,7 +2,9 @@
 //
 // Fetches /builders/primer.md (canonical markdown from docs/onboarding/),
 // renders it through the SHARED reader (md-reader.js / window.OTBMdReader),
-// inlines the five onboarding diagrams at matching sections, builds a TOC from
+// inlines the five onboarding diagrams in their chapters, adds the credits
+// chapter's two live sections (primer-live.js), lands a deep link once all of
+// that is in (task 1005046: the hall's one reading room), builds a TOC from
 // h2s with a scrollspy, drives a reading-progress hairline, and soft-gates the
 // footer ack button until the reader has scrolled past ~90% of the article.
 // Acking POSTs to /api/bongos/builders/me/onboarding/primer-read (same endpoint
@@ -37,17 +39,29 @@
   let repoBlobBase = null;
   let repoTreeBase = null;
 
-  // Diagrams to inline at matching h2 sections. The keys are LOWERCASED h2
-  // text (matched as substrings) — keep them tight so the wrong heading
-  // doesn't pick up the wrong picture. The image paths resolve at
-  // /builders/diagrams/* (mounted in server.js).
-  const DIAGRAM_AT_HEADING = [
-    { match: 'claim → ship lifecycle',      src: '/builders/diagrams/01-task-lifecycle.png',       alt: 'The full task lifecycle from backlog through shipped' },
-    { match: 'rank ladder',                 src: '/builders/diagrams/02-rank-ladder.png',          alt: 'The rank ladder — the ranks a builder can hold and how to rise' },
-    { match: 'drachmae and karma',          src: '/builders/diagrams/03-drachmae-karma.png',       alt: 'How the reward currency and karma differ — pay for shipped work vs. reputation signals' },
-    { match: 'get set up',                   src: '/builders/diagrams/04-architecture.png',         alt: 'The complete architecture: your machine holds the worker, the code, and your local memory, the server is the authority and production, GitHub holds the repo — and how code travels from your machine to prod' },
+  // The five onboarding diagrams, each inlined in the chapter it illustrates
+  // (task 1005046: the Diagrams page folded into this one, so this table is now
+  // the ONLY place a diagram is shown in the hall). Keyed by the chapter's h2 id
+  // — the slug md-reader.js gives it — not by a substring of its words, so a
+  // retitled chapter fails loudly in tests/hall_reading_world.mjs instead of
+  // silently losing its picture (the credits diagram did exactly that when the
+  // chapter's heading stopped matching 'drachmae and karma'). The image paths
+  // resolve at /builders/diagrams/* (serve-internal.js mounts the directory).
+  const DIAGRAM_AT_CHAPTER = [
+    { id: 'the-claim-ship-lifecycle',         src: '/builders/diagrams/01-task-lifecycle.png', alt: 'The task lifecycle from backlog to shipped, with the step where credits land' },
+    { id: 'the-rank-ladder',                  src: '/builders/diagrams/02-rank-ladder.png',    alt: 'The rank ladder: which ranks are live today and what each may do' },
+    { id: 'credits-and-karma',                src: '/builders/diagrams/03-drachmae-karma.png', alt: 'Where credits and karma come from, and where each shows up' },
+    { id: 'how-versions-organise-the-work',   src: '/builders/diagrams/05-versioning.png',     alt: 'How a planning session seeds a version\'s task pool, and how a version closes' },
+    { id: 'get-set-up-on-your-machine',       src: '/builders/diagrams/04-architecture.png',   alt: 'The complete architecture: your machine holds the worker, the code and your local memory; the server is the authority and production; GitHub holds the repo — and the path a change takes to production' },
   ];
 
+  // The chapter the two live sections close (task 1005046, moved from the
+  // retired /drachmae page): what the treasury has actually spent and paid, and
+  // the published security bounty rates. They go at the end of this chapter,
+  // ahead of the next one, as h3s — so the table of contents stays one line per
+  // chapter and a deep link (#the-treasury, #security-bounty-rates) still works.
+  const LIVE_CHAPTER_ID = 'credits-and-karma';
+
   // -----------------------------------------------------------------------
   // Tiny utilities
   // -----------------------------------------------------------------------
@@ -57,13 +71,14 @@
   const MD = window.OTBMdReader;
   const escapeHtml = (s) => window.OTB.escapeHtml(s); // task 1004876: the old fallback escaped nothing
 
-  // The shared resolver, plus the rewrites that are the primer's alone: the
-  // economy doc has an in-hall reader page (task 1472), so a link to it stays in
-  // the hall instead of bouncing the reader out to GitHub. And a link to a hall
+  // The shared resolver, plus the rewrites that are the primer's alone: a link
+  // written as a hall address (/builders/…) is a page in this hall, so it stays
+  // here instead of being dressed as a repo path on GitHub (task 1005046: the
+  // rank ladder sends the reader to their own standing). And a link to a hall
   // page's own file (../../modules/hall-ui/public/<page>.html) opens that page
   // here (task 1005069); on GitHub the same link shows the file.
-  const HALL_PAGE = /^(?:\.\.\/)+modules\/hall-ui\/public\/([a-z0-9-]+)\.html$/;
   const resolveLinkHref = (() => {
+    const HALL_PAGE = /^(?:\.\.\/)+modules\/hall-ui\/public\/([a-z0-9-]+)\.html$/;
     if (!MD) return (h) => h;
     const base = MD.makeResolveLinkHref({
       baseDir: PRIMER_DIR,
@@ -71,7 +86,7 @@
       getTreeBase: () => repoTreeBase,
     });
     return (href) => {
-      if (href === 'drachmae-and-karma.md') return '/builders/drachmae';
+      if (/^\/builders(?:[/#?]|$)/.test(String(href || ''))) return href;
       const page = HALL_PAGE.exec(href || '');
       return page ? '/builders/' + page[1] : base(href);
     };
@@ -97,19 +112,17 @@
   // -----------------------------------------------------------------------
 
   function inlineDiagrams(articleEl) {
-    const h2s = articleEl.querySelectorAll('h2');
-    for (const h of h2s) {
-      const txt = h.textContent.toLowerCase();
-      const match = DIAGRAM_AT_HEADING.find((d) => txt.includes(d.match));
-      if (!match) continue;
+    for (const d of DIAGRAM_AT_CHAPTER) {
+      const h = articleEl.querySelector(`h2[id="${d.id}"]`);
+      if (!h) continue;
       const fig = document.createElement('figure');
       fig.className = 'primer-figure';
       const img = document.createElement('img');
-      img.src = match.src;
-      img.alt = match.alt;
+      img.src = d.src;
+      img.alt = d.alt;
       img.loading = 'lazy';
       const cap = document.createElement('figcaption');
-      cap.textContent = match.alt;
+      cap.textContent = d.alt;
       fig.appendChild(img);
       fig.appendChild(cap);
       // Place the figure AFTER the h2's first paragraph so it sits inside
@@ -124,6 +137,63 @@
     }
   }
 
+  // The live sections of the credits chapter (primer-live.js). Placed at the
+  // END of that chapter — ahead of the next h2 — each with a Loading… line, and
+  // removed outright if its feed cannot be read, so the chapter never shows an
+  // empty panel or an outline entry that leads nowhere.
+  //
+  // FETCHED ON APPROACH, not on load. The Primer is the hall's most-read page
+  // and three old URLs now land on it, while most readers never scroll to the
+  // treasury; firing /public/cost-summary (a day-by-day cumulative query) and
+  // /public/bounty-table on every open would spend that on readers who never
+  // see it. So the two reads start when the reader comes within a screen of
+  // the sections — or at once when the address points at the credits chapter
+  // or either section (an old /drachmae link), so a deep link lands on their
+  // final layout. Resolves when there is nothing left to wait for before
+  // landing: after the fills on a deep link, at once otherwise.
+  const LIVE_HASHES = new Set([LIVE_CHAPTER_ID, 'the-treasury', 'security-bounty-rates']);
+  function insertLiveSections(articleEl) {
+    const live = window.OTBPrimerLive;
+    const h = articleEl.querySelector(`h2[id="${LIVE_CHAPTER_ID}"]`);
+    if (!live || !h) return Promise.resolve();
+    let next = h.nextElementSibling;
+    while (next && next.tagName !== 'H2') next = next.nextElementSibling;
+    const place = (el) => { if (next) articleEl.insertBefore(el, next); else articleEl.appendChild(el); };
+    const treasury = live.placeholder('treasury');
+    const bounty = live.placeholder('bounty');
+    place(treasury);
+    place(bounty);
+    let started = null;
+    const fill = () => {
+      if (!started) started = Promise.allSettled([live.fillTreasury(treasury), live.fillBounty(bounty)]);
+      return started;
+    };
+    let hash = '';
+    try { hash = decodeURIComponent(window.location.hash.slice(1)); } catch (_) { hash = ''; }
+    if (LIVE_HASHES.has(hash) || typeof window.IntersectionObserver !== 'function') return fill();
+    const io = new window.IntersectionObserver((entries) => {
+      if (!entries.some((e) => e.isIntersecting)) return;
+      io.disconnect();
+      fill();
+    }, { rootMargin: '100% 0px' });
+    io.observe(treasury);
+    io.observe(bounty);
+    return Promise.resolve();
+  }
+
+  // A deep link — /primer#the-rank-ladder, or an old /ranks, /drachmae or
+  // /diagrams URL that serve-internal.js 302s here — arrives before the article
+  // exists, so the browser's own jump found nothing. Once the document and its
+  // live sections are in, scroll the target into view. After the fonts: a swap
+  // after the jump moves everything above the target.
+  function landOnHash() {
+    let id = '';
+    // a malformed percent-escape in the fragment throws; there is nothing to land on
+    try { id = decodeURIComponent(window.location.hash.slice(1)); } catch (_) { return; }
+    const el = id && document.getElementById(id);
+    if (el) el.scrollIntoView({ block: 'start' });
+  }
+
   // -----------------------------------------------------------------------
   // TOC — built from h2 headings. The numeral is drawn by room.css's counter,
   // so the markup carries only the title.
@@ -430,12 +500,14 @@
     article.removeAttribute('aria-busy');
     show('article');
     inlineDiagrams(article);
+    const live = insertLiveSections(article);
     const tocSections = renderToc(headings);
     setupTocToggle();
     setupScrollspy(tocSections);
     setupProgressBar(article, onArticleProgress);
     setupAck();
     checkAlreadyAcked();
+    live.then(() => (document.fonts ? document.fonts.ready : null)).then(landOnHash);
   }
 
   if (document.readyState === 'loading') {

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

@@ -2,7 +2,9 @@
   "_": "The hall's primer through modules/ui-design/kit/render.js (task 1003306). Written with the reading-room re-skin so the room's failure state and its table of contents are MEASURED at 1440/390/320 in both modes, not just looked at.",
   "page": "/builders/primer",
   "surface": "hall-ui",
-  "stub": { "prefix": "/builders/" },
+  "stub": {
+    "prefix": "/builders/"
+  },
   "modeQuery": false,
   "_feeds": "The kit's stub carries the public-landing fixtures, not the hall's, and it serves no /builders/primer.md at all — so the room renders its SKELETON and then its FAILURE note here, which is the point: the two states before the document are the ones nobody looks at, and they have to hold the floors too. The populated document is the hall-preview harness's job: node scripts/hall-preview/server.js --port 4612 --fixture-me, then this same file with --base-in/--base-out pointed at it.",
   "ignoreRequests": [
@@ -11,7 +13,10 @@
     "/api/(gds|bongos)/goals",
     "/api/(gds|bongos)/inbox/",
     "/api/(gds|bongos)/public/repo-info",
-    "/builders/primer.md"
+    "/builders/primer.md",
+    "/api/(gds|bongos)/public/cost-summary",
+    "/api/(gds|bongos)/public/bounty-table",
+    "/builders/diagrams/"
   ],
   "ignoreConsole": [
     "/api/(gds|bongos)/",
@@ -25,14 +30,56 @@
   ],
   "_expect": "The expectations name only what is true under BOTH bases. Under the kit stub there is no primer.md, so the failure note renders; under the harness the real document does. Pinning either one would make this file pass in one place and fail in the other, which is how a states file stops being run against the harness at all.",
   "states": {
-    "in": { "auth": true, "expect": { "visible": ["#hall-main", "#primer-toc"] } },
+    "in": {
+      "auth": true,
+      "expect": {
+        "visible": [
+          "#hall-main",
+          "#primer-toc"
+        ]
+      }
+    },
     "toc-open": {
       "auth": true,
-      "actions": [["clickIfVisible", "#primer-toc-toggle"], ["wait", 250]],
+      "actions": [
+        [
+          "clickIfVisible",
+          "#primer-toc-toggle"
+        ],
+        [
+          "wait",
+          250
+        ]
+      ],
       "_": "the room's one disclosure. Below 760px the contents collapse behind this toggle; above it the toggle is not rendered at all, so clickIfVisible is the right verb and the state is a no-op at 1440.",
-      "expect": { "visible": ["#primer-toc"] }
+      "expect": {
+        "visible": [
+          "#primer-toc"
+        ]
+      }
+    },
+    "jump": {
+      "auth": true,
+      "url": "/builders/primer#credits-and-karma",
+      "actions": [
+        [
+          "wait",
+          800
+        ]
+      ],
+      "_": "where an old /drachmae link lands (task 1005046: it 302s here). Under the harness the credits chapter is in view with its diagram and the two live sections below; under the kit stub it is the failure note again, which the floors must hold in too.",
+      "expect": {
+        "visible": [
+          "#hall-main",
+          "#primer-toc"
+        ]
+      }
     },
-    "out": { "auth": false }
+    "out": {
+      "auth": false
+    }
   },
-  "reducedMotion": { "auth": true }
+  "reducedMotion": {
+    "auth": true
+  }
 }

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

@@ -207,8 +207,8 @@
      chrome exists before the page script runs. -->
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
-<script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-11-04-one-market-watch"></script>
+<script src="/builders/craft-mode.js?v=2026-11-04-reading-room"></script>
+<script src="/builders/shell.js?v=2026-11-04-reading-room"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- task 1004727: the ONE karma vote control every task/idea list renders -->

package/modules/hall-ui/public/project-settings.html

@@ -86,8 +86,8 @@
 
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
-<script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-11-04-one-market-watch"></script>
+<script src="/builders/craft-mode.js?v=2026-11-04-reading-room"></script>
+<script src="/builders/shell.js?v=2026-11-04-reading-room"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/hall-kit.js"></script>

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

@@ -43,8 +43,8 @@
 
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
-<script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-11-04-one-market-watch"></script>
+<script src="/builders/craft-mode.js?v=2026-11-04-reading-room"></script>
+<script src="/builders/shell.js?v=2026-11-04-reading-room"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- The chart kit and the timeline's series builders (task 1003447). Both MUST