@bongos/core 1.24.34 → 1.24.36

package/docs/recipes/ui-look-before-you-ship.md

@@ -34,7 +34,7 @@ The stub runs the page through the **instance's real transforms** — the apex-o
 ```
 node modules/ui-design/kit/render.js --page /projects
 node modules/ui-design/kit/render.js --page /                       # MSYS_NO_PATHCONV=1 in Git Bash, or the kit reads the mangled root back
-node modules/ui-design/kit/render.js --page /builders/ranks --surface hall-ui
+node modules/ui-design/kit/render.js --page /builders/primer --surface hall-ui
 node modules/ui-design/kit/render.js --page /projects --only in-map,card --modes dark --sizes 390
 node modules/ui-design/kit/render.js --page / --style expedition        # the same page under a look from the style library
 ```
@@ -81,7 +81,7 @@ Then a state's own `expect` (a band open, a dialog present, a field's value, a c
 
 Actions: `click`, `focus`, `press`, `fill`, `wait`, `clickAt x y`, `clickIfVisible`, `dispatchClick`, `check`, `back`, `forward`. Expectations: `expanded`, `dialog`, `visible[]`, `hidden[]`, `open`, `closed`, `activeId`, `activeText`, `expandedIds[]`, `param{}`, `attr[[sel,name,value]]`, `text[[sel,value]]`, `href[[sel,value]]`, `count[[sel,n]]`, `value[[sel,v]]`, `hasClass[[sel,class,bool]]`, `checked`, `noOverflow`, `top[[sel,px]]` (an element's viewport top — assert it closed, open a band, assert it again: the proof an overlay did not push the page). The kit validates the file before it opens a browser and names every problem.
 
-The worked examples: `modules/public-landing/public/projects.states.json` (the hub's thirteen), `modules/public-landing/public/index.states.json` (the landing's four), `modules/hall-ui/public/ranks.states.json` (a second surface under its own prefix — it renders **red**, deliberately: the hall predates the 24px floor and Ranks has no `<h1>`, and the states file declares the shell's un-fixtured feeds rather than hiding the findings; idea 1000863 carries them).
+The worked examples: `modules/public-landing/public/projects.states.json` (the hub's thirteen), `modules/public-landing/public/index.states.json` (the landing's four), `modules/hall-ui/public/primer.states.json` (a second surface under its own prefix, with a redirected deep link as one of its states; the Ranks page's file that used to be cited here went with that page in task 1005046).
 
 ## 3. Probe — the interaction contract, as PASS/FAIL lines
 

package/modules/design-styles/skills/style/SKILL.md

@@ -48,7 +48,7 @@ Read the world first, then look at what the library already has, then ask.
 
    ```
    node modules/ui-design/kit/render.js --page / --style <name>
-   node modules/ui-design/kit/render.js --page /builders/ranks --surface hall-ui --style <name>
+   node modules/ui-design/kit/render.js --page /builders/primer --surface hall-ui --style <name>
    ```
 
    The hall's page is worth the second render because it carries the light tier and the fixed status vocabulary a look must not repaint.
@@ -85,7 +85,7 @@ node modules/ui-design/kit/contrast.js --pack <name>                     # the p
 node --test --test-reporter=tap tests/ui_design_styles.mjs               # the world / hub / hall suites under the pack
 node modules/ui-design/kit/check-mock.js --file modules/ui-design/styles/<name>/mock.html --pack <name>
 node modules/ui-design/kit/render.js --page / --style <name>             # every state x width x mode, audited
-node modules/ui-design/kit/render.js --page /builders/ranks --surface hall-ui --style <name>
+node modules/ui-design/kit/render.js --page /builders/primer --surface hall-ui --style <name>
 ```
 
 Each round: run, read the **named failing pair** the suite prints, make one change, show the owner the shots. Common failures and their one right fix:

package/modules/hall-ui/public/ai-studio.html

@@ -88,8 +88,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>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/tweak-editor-lib.js?v=2026-09-28-tw23"></script>
 <script src="/builders/studio-lib.js?v=2026-10-09-day"></script>

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

@@ -91,8 +91,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/atlas.js?v=2026-09-02-index" defer></script>

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

@@ -60,8 +60,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>
 <!-- the branding pack's currency label, loaded BEFORE blockers.js. -->

package/modules/hall-ui/public/board-room.html

@@ -62,8 +62,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/builders.js

@@ -148,19 +148,20 @@
   // Coerce any rank that isn't one of the four live ranks (archon/metic/thetes/
   // xenos — #692 / ADR 0034) to the entry rank. Reserved values still on the
   // citizen/divine ladder would otherwise render as a dashed "unknown" plaque
-  // while /builders/ranks shows them as xenos. Applied to the
+  // while the hall elsewhere shows them as xenos. Applied to the
   // builder-facing standing surfaces — the welcome panel, the profile Standing
   // badge, and the public Roll — so they agree. NOT applied to the Archon-only
   // roster below, which intentionally shows the true stored rank so an Archon
-  // can spot and fix a stray value. Mirrors the RANK_LADDER coercion in ranks.js.
+  // can spot and fix a stray value. hall-render.js's "Where you stand" card
+  // (task 1005046, from the retired Ranks page) coerces through this too.
   function normalizeRank(rank) {
     return RANK_ORDER[rank] ? rank : 'xenos';
   }
 
   // Short one-line summary of what each rank unlocks. Kept terse — the hall's
   // job is the daily action surface, not the full permissions reference (that
-  // lives at /builders/ranks). Sourced from docs/canonical-permissions.md.
-  // Used by the rank-badge hover tooltip (opts.tip) and mirrored in ranks.js.
+  // is the Primer's rank-ladder chapter). Sourced from docs/canonical-permissions.md.
+  // Used by the rank-badge hover tooltip (opts.tip).
 
   // Monotonic counter for unique tooltip ids (aria-describedby). Re-renders
   // replace innerHTML so duplicates would otherwise collide.
@@ -798,9 +799,10 @@
   // removed. work.js carries the equivalent rendering for that page.
 
   // (task 2174: the red-team bounty rate card — V3.R65 #284 — left Standing for
-  // /drachmae. It is a published reward SCHEDULE, i.e. reference material that
+  // the reference. It is a published reward SCHEDULE, i.e. reference material that
   // reads the same for every builder, not part of anyone's personal standing.
-  // drachmae.js now fetches /public/bounty-table and renders it there.)
+  // primer-live.js fetches /public/bounty-table and renders it in the Primer's
+  // credits chapter since task 1005046 folded the Economy page into it.)
 
   // ---- idea-inbox triage cue (task 1471) -----------------------------------
 

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

@@ -107,8 +107,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" defer></script>
-<script src="/builders/craft-mode.js?v=2026-10-30-market-watch" defer></script>
-<script src="/builders/shell.js?v=2026-11-04-one-market-watch" defer></script>
+<script src="/builders/craft-mode.js?v=2026-11-04-reading-room" defer></script>
+<script src="/builders/shell.js?v=2026-11-04-reading-room" defer></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/gov-living.js?v=2026-10-09-positions1" defer></script>
 <script src="/builders/gov-feeds.js?v=2026-10-09-living3" defer></script>

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

@@ -161,8 +161,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>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/collab-lib.js?v=2026-09-24-archive"></script>
 <script src="/builders/collab.js?v=2026-09-24-archive"></script>

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

@@ -53,8 +53,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/copy-desk.html

@@ -179,8 +179,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>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/hall-kit.js"></script>
 <script src="/builders/copy-desk.js?v=2026-09-01-redesign"></script>

package/modules/hall-ui/public/craft-mode.js

@@ -103,7 +103,7 @@
   var MODE_TABS = {
     building: ['home', 'roadmap', 'goals', 'goal-map', 'work', 'blockers', 'thinking', 'studio',
       'standing',
-      'primer', 'ranks', 'economy', 'commands', 'diagrams', 'atlas', 'modules', 'apidocs', 'market-watch'],
+      'primer', 'commands', 'atlas', 'modules', 'apidocs', 'market-watch'],
     artistry: ['studio', 'goals', 'thinking'],
     ideating: ['goal-map', 'thinking', 'goals', 'market-watch'],
     governing: ['city', 'blockers', 'board-room',

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

@@ -80,8 +80,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>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/hall-kit.js"></script>
 <!-- the shared ask card the move is drawn with (task 1004829) -->

package/modules/hall-ui/public/diagram-viewer.css

@@ -1,6 +1,6 @@
 /* diagram-viewer.css — pannable / zoomable canvas for the onboarding diagrams
    (task 1059; rebuilt into the chrome world by task 1003306). Replaces the
-   static PNG click-to-zoom lightbox on /builders/diagrams and the primer: each
+   static PNG click-to-zoom lightbox in the primer: each
    diagram's vector SVG loads inline into a canvas you DRAG to pan and SCROLL to
    zoom (Figma-style), with a toolbar and a fullscreen mode.
 

package/modules/hall-ui/public/diagram-viewer.js

@@ -1,13 +1,13 @@
 // diagram-viewer.js — pannable / zoomable canvas for the onboarding diagrams
-// (task 1059). Replaces the static PNG click-to-zoom lightbox on
-// /builders/diagrams and the Citizen's Primer. Each diagram's vector SVG is
+// (task 1059). Replaces the static PNG click-to-zoom lightbox in the Citizen's
+// Primer, which shows all five since task 1005046 folded the Diagrams page into it. Each diagram's vector SVG is
 // loaded inline and shown in a canvas you DRAG to pan and SCROLL to zoom
 // (Figma-style), with a toolbar (− / zoom% / + / Fit / Fullscreen),
 // double-click-to-zoom, pinch on touch, and keyboard control. No dependencies,
 // no build step.
 //
 // Progressive enhancement: it upgrades the same images the old lightbox did
-// (figure.diagram img, figure.primer-figure img). Each diagram's vector .svg
+// (figure.primer-figure img). Each diagram's vector .svg
 // URL is derived from the <img> .png src; if the SVG can't be fetched the PNG
 // is left in place (static, exactly as before — graceful degradation). primer.js
 // injects its figures asynchronously, so a MutationObserver upgrades late
@@ -16,7 +16,7 @@
 (() => {
   'use strict';
 
-  const SELECTOR = 'figure.diagram img, figure.primer-figure img';
+  const SELECTOR = 'figure.primer-figure img';
   const MIN_SCALE = 0.1;
   const MAX_SCALE = 8;
   const ZOOM_STEP = 1.25; // button / keyboard zoom factor
@@ -63,7 +63,7 @@
 
     // Namespace the SVG's ids. mermaid-cli emits id="my-svg" PLUS #my-svg style
     // selectors PLUS url(#my-svg_...) arrowhead markers for EVERY diagram, so
-    // multiple inline diagrams on one page (the diagrams index has five) would
+    // multiple inline diagrams on one page (the primer has five) would
     // collide. One token rewrite keeps the id, its styles, and its marker refs
     // mutually consistent while making them unique. ("my-svg" never appears in
     // the diagrams' label text, so this is safe.)

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

@@ -59,8 +59,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>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/hall-kit.js"></script>
 <script src="/builders/fleet-costs.js"></script>

package/modules/hall-ui/public/founding-mark.js

@@ -4,8 +4,9 @@
 // genesis, numbered in join order; the project owner is "founder". The server works
 // that out (modules/onboarding/founding-builders.js, GET /api/bongos/founding/builders);
 // this file only shows it, in the hall's own badge grammar: a pill the height and type
-// of .rank-badge, with a seed dot in the accent. Four surfaces read it — the roster,
-// the profile, the ranks page and the founding wall on Home — and each one renders
+// of .rank-badge, with a seed dot in the accent. Three surfaces read it — the roster,
+// the profile and the founding wall on Home (the ranks page's ledger went with that
+// page, task 1005046) — and each one renders
 // exactly as before when the list is empty, which it is on every project that was
 // never founded (the blend rule: founding is a mode the hall wears, never a re-skin).
 //

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

@@ -66,8 +66,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/goal-map.html

@@ -139,8 +139,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>
 <script src="/builders/palette.js" defer></script>
 
 <script src="/builders/idea-objects.js?v=2026-09-27-split"></script>

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

@@ -243,8 +243,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>
 <!-- task 1004727: the ONE karma vote control every task/idea list renders -->

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

@@ -156,8 +156,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/hall-render.js

@@ -49,6 +49,66 @@
   };
   let rankTipSeq = 0;
 
+  // "Where you stand" (task 1005046): the personal half of the retired Ranks
+  // page, now a card on Accomplishments. The ladder itself — every rank and what
+  // it unlocks — is the Primer's rank-ladder chapter, written once; this card
+  // says only what is true for the VIEWER: their rank, what it is, the rank
+  // above, and how they reach it. Moved from ranks.js with the page.
+  const RANK_TITLE = {
+    xenos: 'The newcomer',
+    thetes: 'The proven builder',
+    metic: 'The trusted builder',
+    archon: 'The steward',
+  };
+  const RANK_BLURB = {
+    xenos: 'A newcomer with a deliberately small surface: onboarding, safe starter tasks, and your own standing.',
+    thetes: 'A builder who has shipped their first work — the day-to-day surfaces are open.',
+    metic: 'A trusted builder: triage, reviews, planning sessions, and security reporting are open.',
+    archon: 'The steward of the whole system — approvals, the roster, budgets, and the Archon pages.',
+  };
+  // How a builder rises FROM their current rank. NB: these strings contain
+  // markup (<strong>) and are injected via innerHTML without escaping, which is
+  // safe only because they are author-controlled constants. Never source them
+  // from server or user data without switching the render site to escapeHtml.
+  const RISE_FROM = {
+    xenos:
+      `Claim and ship the newcomer-friendly tasks an Archon has opened to newcomers. Each clean ship earns ${curLabel()}; each ratified idea earns karma. On your <strong>third</strong> clean ship you are promoted automatically to <strong>Thetes</strong>, out of the newcomer sandbox with the whole queue open to you. No fee, no application; the third ship does it.`,
+    thetes:
+      'You have the run of the queue. Promotion to <strong>Metic</strong> (triage, blockers, planning, the shaping of work) is granted by a standing Archon alone, to a builder whose judgement has earned the project’s trust. Keep shipping; rank is granted, never bought.',
+    metic:
+      'The <strong>Archon</strong> rank is granted rarely, by a standing Archon alone, to a Metic who has shaped the project’s direction and earned its deepest trust. There is no checklist, only the weight of what you have built.',
+    archon:
+      'You hold the highest rank. There is no rank above it, only the care of everything below.',
+  };
+  // The rank one rung up, read off the injected tier map rather than a second
+  // copy of the ladder (tests/rank_tier_single_source.mjs).
+  function nextRank(rank) {
+    const want = (RANK_ORDER[rank] || 0) + 1;
+    return Object.keys(RANK_ORDER).find((r) => RANK_ORDER[r] === want) || null;
+  }
+  // Intentionally not on the factory's return object: renderProfile is its one
+  // caller, so it repaints whenever the band does, from the same /me payload.
+  function renderRankStanding(builder) {
+    const host = document.getElementById('rank-standing-body');
+    if (!host) return;
+    const rank = normalizeRank(builder && builder.rank);
+    const next = nextRank(rank);
+    // At the top there is no rung to name; RISE_FROM says so in its own words,
+    // so the line is left out rather than said twice.
+    const nextLine = next
+      ? `<p class="ranks-standing__next">The rank above yours is ${renderRankBadge(next)}.</p>`
+      : '';
+    host.innerHTML = `
+      <div class="ranks-standing">
+        <div class="ranks-standing__badge">${renderRankBadge(rank)}</div>
+        <p class="ranks-standing__title">${escapeHtml(RANK_TITLE[rank] || rankLabel(rank))}</p>
+        <p class="ranks-standing__blurb">${escapeHtml(RANK_BLURB[rank] || '')}</p>
+        ${nextLine}
+      </div>
+      <p class="ranks-rise__body">${RISE_FROM[rank] || RISE_FROM.xenos}</p>
+      <p class="card-foot"><a href="/primer#the-rank-ladder">Every rank and what it unlocks, in the Primer →</a></p>`;
+  }
+
   function renderRankBadge(rank, opts = {}) {
     const label = escapeHtml(rankLabel(rank));
     const ariaLabel = rank ? `Rank: ${rankLabel(rank)}` : 'Rank not yet recorded';
@@ -75,7 +135,7 @@
     const items = RANK_UNLOCKS[rank].map((u) => `<li>${escapeHtml(u)}</li>`).join('');
     return `<span class="rank-badge-wrap">` +
       `<span class="rank-badge ${variant} rank-badge--tipped" aria-hidden="true">${label}</span>` +
-      `<a class="rank-badge-stretch" href="/ranks" ` +
+      `<a class="rank-badge-stretch" href="/primer#the-rank-ladder" ` +
         `aria-describedby="${tipId}" ` +
         `aria-label="${escapeHtml(ariaLabel)} — see all standings"></a>` +
       `<span class="rank-tip" id="${tipId}" role="tooltip">` +
@@ -618,6 +678,7 @@
     // hover it widens left to show the name while .hall-standing__more drops down.
     const standingChip = document.getElementById('hall-standing');
     if (standingChip && !ctx.newcomerGated) standingChip.hidden = false;
+    renderRankStanding(builder);
     renderSystemNotices({ rebaseTasks, need, actionNeeds, cost });
   }
 

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

@@ -16,7 +16,8 @@
 // by question": the Profile card is the band, and every other Standing widget
 // declares the `group` that answers its question. Achievements folded in from the
 // retired #achievements hash view; the security-bounty rate card moved off Standing
-// to /drachmae (a reward schedule is reference material, not personal standing).
+// to the reference (a reward schedule is not personal standing) — the Primer's
+// credits chapter since task 1005046, which folded the Economy page into it.
 //
 // Each widget owns its skeleton markup. mount(host) stamps that skeleton into the
 // registry-made <section>; builders.js then wires data to the same element ids it
@@ -176,6 +177,15 @@
 
   /* -- Progress — how the output has changed over time -- */
 
+  // 4c. Where you stand (task 1005046) — the viewer's rank, the rank above it
+  // and how they reach it, moved here from the retired Ranks page. Filled by
+  // hall-render.js renderRankStanding from the same /me payload as the band;
+  // the ladder itself is the Primer's rank-ladder chapter.
+  w('rank-scroll', 'Where you stand', 48,
+    '<h2 id="rank-standing-h" class="scroll__h">Where you stand</h2>' +
+    '<div id="rank-standing-body"><div class="hall-loading" role="status">Loading…</div></div>',
+    { view: 'standing', group: 'progress', labelledby: 'rank-standing-h' });
+
   // 5. CURVE — the builder's development curve (V3.R72 #291, C5).
   w('analytics-scroll', 'Progress', 50,
     '<h2 id="curve-h" class="scroll__h">Progress</h2>' +

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

@@ -52,8 +52,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>
 <script src="/builders/palette.js" defer></script>
 <!-- task-detail.js still owns the #/idea/N and #/blocker/N overlay, so a ref
      written inside an idea's own prose keeps resolving from this page. -->

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

@@ -227,8 +227,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>
 <script src="/builders/palette.js" defer></script>
 <!-- task 1004727: the ONE karma vote control every task/idea list renders -->
 <script src="/builders/vote-control.js"></script>

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

@@ -122,8 +122,8 @@
      before the craft picker so the two never stack. Home only. -->
 <script src="/builders/welcome-boot.js?v=2026-10-23-city1" defer></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab" defer></script>
-<script src="/builders/craft-mode.js?v=2026-10-30-market-watch" defer></script>
-<script src="/builders/shell.js?v=2026-11-04-one-market-watch" defer></script>
+<script src="/builders/craft-mode.js?v=2026-11-04-reading-room" defer></script>
+<script src="/builders/shell.js?v=2026-11-04-reading-room" defer></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 2166: the shared component kit (window.OTBKit) — pager/ledger/rail.
@@ -137,7 +137,7 @@
      immediately before the builders.js tag below — that anchor is load-bearing
      (serve-internal.js injectModuleHallWidgets). -->
 <script src="/builders/founding-mark.js?v=2026-09-30-founding" defer></script>
-<script src="/builders/hall-widgets.js?v=2026-09-30-founding" defer></script>
+<script src="/builders/hall-widgets.js?v=2026-11-04-reading-room" defer></script>
 <!-- The genesis home (task 1004423): a Home banner card that renders only in founding mode. -->
 <script src="/builders/genesis-home.js?v=2026-10-01-genesis" defer></script>
 <!-- task 1005054: the project city — the drawing (pure) and the widget — in the
@@ -160,7 +160,7 @@
      window.OTBHallRender(ctx) once during its own setup. The module
      hall-widget tags the server injects still anchor on builders.js's tag
      below (it matches by filename), so they land between the two. -->
-<script src="/builders/hall-render.js?v=2026-10-09-positions1" defer></script>
+<script src="/builders/hall-render.js?v=2026-11-04-reading-room-2" defer></script>
 <!-- task 1002802 (P06): the profile-completion nudge slice. Exposes
      window.OTBProfileNudge; goal-inbox.js's mount() calls it once it has
      created the #attention-profile div, so load order is not load-bearing. -->

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

@@ -73,8 +73,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-09-living3"></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>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/hall-kit.js"></script>
 <script src="/builders/market-watch-lib.js"></script>

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

@@ -42,8 +42,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/market-watch.html

@@ -187,8 +187,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-09-living3"></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>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/hall-kit.js"></script>
 <script src="/builders/market-watch-lib.js"></script>

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

@@ -127,8 +127,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/brand-apply.js"></script>

package/modules/hall-ui/public/my-agents.html

@@ -83,8 +83,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/gov-living.js?v=2026-10-10-real1"></script>

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

@@ -54,6 +54,7 @@
   //   government → government.js makeTabs ids (two rooms since ADR 0266)
   //   settings   → settings.js RAIL_GROUPS
   //   my-agents  → my-agents.js ANCHORS (the agent settings left Settings, task 1005044)
+  //   primer     → primer.md's h2 slugs + primer-live.js SECTIONS (task 1005046)
   var SECTIONS = [
     { parent: 'Accomplishments', gate: 'nav-standing', items: [
       { label: 'Work', href: '/#accomplishments-work' },
@@ -82,6 +83,20 @@
       { label: 'Skill voices', href: '/my-agents#skills' },
       { label: 'What it knows', href: '/my-agents#knows' },
     ] },
+    // task 1005046: the Primer is the one reading room, so the rank ladder, the
+    // economy and the diagrams that had pages of their own are its chapters
+    // now. Each row is a chapter's h2 slug (md-reader.js slugify over
+    // docs/onboarding/primer.md) or one of the credits chapter's live sections
+    // (primer-live.js SECTIONS); 'Economy' rides the label so the word a
+    // builder used to type still finds the place.
+    { parent: 'Primer', gate: 'nav-primer', items: [
+      { label: 'Task lifecycle', href: '/primer#the-claim-ship-lifecycle' },
+      { label: 'Rank ladder', href: '/primer#the-rank-ladder' },
+      { label: 'Credits and karma (Economy)', href: '/primer#credits-and-karma' },
+      { label: 'Treasury', href: '/primer#the-treasury' },
+      { label: 'Security bounty rates', href: '/primer#security-bounty-rates' },
+      { label: 'Versions', href: '/primer#how-versions-organise-the-work' },
+    ] },
     { parent: 'Settings', gate: 'shell-user', items: [
       { label: 'Account', href: '/settings#account' },
       { label: 'Access', href: '/settings#access' },