@bongos/core 1.24.34 → 1.24.36

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bongos/core",
-  "version": "1.24.34",
+  "version": "1.24.36",
   "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

@@ -11167,5 +11167,17 @@
       "id": "1005068",
       "text": "The builders hall now has a generated map of every page and link, with a check that flags broken links and pages nobody can reach."
     }
+  ],
+  "1.24.35": [
+    {
+      "id": "1005069",
+      "text": "The Primer now links to the Repo Atlas and the Commands page, so every mode can find them."
+    }
+  ],
+  "1.24.36": [
+    {
+      "id": "1005046",
+      "text": "The Docs section now has one reading room instead of four pages: ranks, credits and karma, and the five diagrams all live in the Primer, each topic explained once with its picture beside it. Old links to Ranks, Economy and Dia"
+    }
   ]
 }

package/scripts/bongos/gen-hall-sitemap.js

@@ -16,7 +16,8 @@
 //   • the crafts: craft-mode.js RUN in a vm, asked tabsFor(mode) — the same answer the hall uses;
 //   • the server's page gates: serve-internal.js's *_PAGE_RE literals and their gdsAuth
 //     dispatch, the static parse tests/hall_page_gate_map.mjs established;
-//   • the links: every in-hall href in a page's HTML and in each script the page loads.
+//   • the links: every in-hall href in a page's HTML and in each script the page loads, and in
+//     the markdown a reading page fetches (CONTENT: the Primer's hall-page links, task 1005069).
 // Scripts nearly every page loads (the shell, the palette, the craft switch) are the CHROME: their
 // links are the nav, reported once, never charged to every page.
 //
@@ -58,12 +59,23 @@ const ROUTES = {
   '/board': { to: '/work', why: 'old name of the Work board, redirects' },
   '/sky': { to: '/thinking', why: 'old name, redirects' },
   '/market-watch-settings': { to: '/market-watch', why: 'now a Settings tab, redirects (task 1005045)' },
+  '/ranks': { to: '/primer', why: 'now a Primer chapter, redirects (task 1005046)' },
+  '/drachmae': { to: '/primer', why: 'now a Primer chapter, redirects (task 1005046)' },
+  '/diagrams': { to: '/primer', why: 'now a Primer chapter, redirects; its images still serve (task 1005046)' },
 };
 // Targets that leave the hall on purpose: sign-in, the hub's /account (platform-server.js;
 // settings.js points the link at the hub), the API, module assets, and any file with an extension.
 const EXTERNAL = [/^\/api\//, /^\/auth\b/, /^\/login\b/, /^\/logout\b/, /^\/signin\b/, /^\/status\b/,
   /^\/account\b/, /^\/modules\//, /^\/docs\b/, /^\/diagrams\//, /^\/healthz\b/, /^\/version\b/, /\.[a-z0-9]{2,5}$/i];
 
+// Pages whose words come from a markdown file they fetch. A link in that file to a hall page's
+// own file (../../modules/hall-ui/public/<page>.html) opens the page in the hall (primer.js,
+// task 1005069), so it is the page's link.
+const CONTENT = { '/primer': 'docs/onboarding/primer.md' };
+function mdHallLinks(md) {
+  return [...md.matchAll(/\]\((?:\.\.\/)+modules\/hall-ui\/public\/([a-z0-9-]+)\.html\)/g)].map((m) => '/' + m[1]);
+}
+
 function read(rel) { return fs.readFileSync(path.join(ROOT, rel), 'utf8'); }
 
 // ---- the pages ----
@@ -210,6 +222,7 @@ function build() {
     };
     for (const h of linksIn(p.html)) add(h, p.file);
     for (const s of p.scripts) if (!chrome.includes(s)) for (const h of linksOf(s)) add(h, s);
+    if (CONTENT[p.url]) for (const h of mdHallLinks(read(CONTENT[p.url]))) add(h, CONTENT[p.url]);
   }
   // the chrome's own links that are not nav items are checked too (the palette, the shell)
   for (const s of chrome) for (const h of linksOf(s)) resolve(h, '(every page)', s);
@@ -364,5 +377,5 @@ function main(argv) {
   return 0;
 }
 
-module.exports = { build, render, normalise, linksIn, classify, ROUTES, OUT };
+module.exports = { build, render, normalise, linksIn, classify, mdHallLinks, ROUTES, CONTENT, OUT };
 if (require.main === module) process.exit(main(process.argv.slice(2)));

package/scripts/hall-preview/server.js

@@ -479,8 +479,8 @@ app.get(/^\/([a-z-]+)$/, (req, res, next) => {
   if (!sendPage(res, `${req.params[0]}.html`)) next();
 });
 
-// What the READING ROOMS read (task 1003306): the two long-form documents and
-// the generated diagrams. All three live outside modules/hall-ui/public and are
+// What the READING ROOM reads (task 1003306): the primer document and
+// the generated diagrams. Both live outside modules/hall-ui/public and are
 // served by serve-internal.js from docs/onboarding/ — but the hall's page gate
 // sits in front of them, so in the harness every one of those fetches 302'd to
 // sign-in and the primer could only ever be previewed in its FAILURE state and
@@ -489,17 +489,12 @@ app.get(/^\/([a-z-]+)$/, (req, res, next) => {
 // canonical files prod reads.
 // NEVER hand-edit a diagram: the .svg/.png pair and assertions.json are written
 // in lockstep by scripts/bongos/gen-diagrams.js.
-// Both prefixes, and that is not belt-and-braces. The diagrams page references
-// its figures RELATIVELY (src="diagrams/01-….png"), which prod resolves under
-// /builders/diagrams because the page is served at /builders/diagrams; the
-// harness serves its pages at the root, so the same markup resolves at
-// /diagrams. Mount one and the populated page renders five broken images.
-for (const prefix of ['/builders/diagrams', '/diagrams']) {
-  app.use(prefix, express.static(path.join(ROOT, 'docs/onboarding/diagrams')));
-}
+// The Primer (the one page that shows them since task 1005046 folded the
+// Diagrams page into it) references each figure absolutely, at
+// /builders/diagrams/*, which is the one prefix mounted here.
+app.use('/builders/diagrams', express.static(path.join(ROOT, 'docs/onboarding/diagrams')));
 for (const [route, file] of [
   ['/builders/primer.md', 'docs/onboarding/primer.md'],
-  ['/builders/drachmae-and-karma.md', 'docs/onboarding/drachmae-and-karma.md'],
 ]) {
   app.get(route, (req, res, next) => {
     const abs = path.join(ROOT, file);

package/src/bongos/serve-internal.js

@@ -1048,6 +1048,28 @@ function mountInternalSurfaces(app) {
     return res.redirect(302, `${isBuildersHost(req) ? '' : '/builders'}/market-watch${qs}#settings`);
   });
 
+  // task 1005046 (owner decision 2026-11-03, idea 1001311): ONE reading room. Ranks,
+  // Economy (/drachmae) and Diagrams explained what the Primer already explained, so
+  // they are Primer chapters now, each with its diagram, and each old URL lands on the
+  // chapter that replaced it. 302 for the same reason as the two redirects above, and
+  // no gate here: the redirect discloses nothing, and the Primer's own sign-in gate
+  // applies the moment it is followed. The diagram IMAGES under /builders/diagrams/*
+  // are not matched (the regex is anchored) and still serve below.
+  const RETIRED_DOC_CHAPTER = Object.freeze({
+    ranks: 'the-rank-ladder',
+    drachmae: 'credits-and-karma',
+    diagrams: 'the-claim-ship-lifecycle',
+  });
+  const RETIRED_DOC_PAGE_RE = /^\/builders\/(ranks|drachmae|diagrams)(?:\.html)?\/?$/;
+  app.use((req, res, next) => {
+    if (isModuleSurfaceHost(req)) return next();
+    if (req.method !== 'GET' && req.method !== 'HEAD') return next();
+    const m = RETIRED_DOC_PAGE_RE.exec(path.posix.normalize(req.path));
+    if (!m) return next();
+    const qs = req.url.includes('?') ? req.url.slice(req.url.indexOf('?')) : '';
+    return res.redirect(302, `${isBuildersHost(req) ? '' : '/builders'}/primer${qs}#${RETIRED_DOC_CHAPTER[m[1]]}`);
+  });
+
   // /deploy EXISTS ONLY WHERE THE DOOR DOES (task 1004296). The owner, 2026-09-25: /deploy is
   // "only for bongos builders hall itself, not for all production ones". Every datum and
   // both acts on that page are provisioning-module routes, so a hall that does not run the
@@ -1252,7 +1274,7 @@ function mountInternalSurfaces(app) {
   // ONE tier of gate: ANY SIGNED-IN BUILDER — the Work Board, Roadmap, the Goals
   // page, the task-detail page, the Repo Atlas, Settings
   // (#748, #904, task 1293, task 1757, task 751) and, since task 1002710, the
-  // orientation reading rooms (primer, diagrams). A Xenos IS allowed; an
+  // orientation reading room (the primer; task 1005046 folded the diagrams in). A Xenos IS allowed; an
   // unauthenticated visitor is bounced into sign-in rather than served the shell.
   // Settings is in here (not gated higher) because a newcomer needs it for
   // first-time setup — CLI re-auth and choosing their craft both live there
@@ -1324,9 +1346,10 @@ function mountInternalSurfaces(app) {
   // whole gate; the governing reads it adds are gated by their own routes.
   // task 1004921 `ai-studio` (the viewer's own routes).
   const SIGNEDIN_BUILDERS_PAGE_RE =
-    /^\/builders\/(?:work|settings|atlas|modules|goals|goal-map|roadmap|copy-desk|studio|ai-studio|tweak-editor|ideas|thinking|collab|task|idea|primer(?:\.md)?|diagrams|my-agents|commands)(?:\.html)?\/?$/;
+    /^\/builders\/(?:work|settings|atlas|modules|goals|goal-map|roadmap|copy-desk|studio|ai-studio|tweak-editor|ideas|thinking|collab|task|idea|primer(?:\.md)?|my-agents|commands)(?:\.html)?\/?$/;
   // The diagram image assets under /builders/diagrams/ ride the same tier as the
-  // page that embeds them.
+  // page that embeds them — the Primer, since task 1005046 retired the Diagrams
+  // page (its URL now 302s to the Primer's first diagram, above).
   const SIGNEDIN_BUILDERS_PREFIX_RE = /^\/builders\/diagrams\//;
   const MARKET_WATCH_PAGE_RE = /^\/builders\/market-watch(?:-(?:item|rules))?(?:\.html)?\/?$/; // task 1004941: every read behind them is requireBuilder
   app.use((req, res, next) => {
@@ -1348,25 +1371,6 @@ function mountInternalSurfaces(app) {
     next();
   });
 
-  // V3.R13-followup-2 (#411): /builders/diagrams/ (with trailing slash) used to
-  // fall through to the game's catch-all because express.static can't resolve a
-  // directory request without an index. Redirect to /builders/diagrams (no slash)
-  // so the diagrams.html page actually renders. The no-slash form already works
-  // via the extensions: ['html'] resolution on buildersStatic.
-  //
-  // Implementation notes:
-  //   - REGEX route, not a string. With Express's default non-strict routing,
-  //     the string form '/builders/diagrams/' matches both '/.../diagrams' AND
-  //     '/.../diagrams/', which would cause a redirect loop. Anchoring with
-  //     ^…$ + a literal trailing slash gates the match to the with-slash form.
-  //   - Registered BEFORE the diagramsStatic wrapper below — that wrapper
-  //     mutates req.url for /builders/diagrams/* paths, which would prevent
-  //     this exact-path redirect from matching if it ran first.
-  app.get(/^\/builders\/diagrams\/$/, (req, res, next) => {
-    if (isModuleSurfaceHost(req)) return next();
-    res.redirect(301, '/builders/diagrams');
-  });
-
   // task 1965: the read-only Task Board (/board, task 751) was consolidated into
   // the Work page (/work) — the hall keeps one task-listing surface. 301 old
   // bookmarks + deep-links (the apex /builders/board and the bare subdomain
@@ -1396,7 +1400,7 @@ function mountInternalSurfaces(app) {
 
   // Onboarding diagram PNGs (V3.R76 #295) live in docs/onboarding/diagrams as the
   // single source of truth alongside their Mermaid sources. Serve them here so the
-  // builders'-hall diagrams page can embed them without duplicating the binaries.
+  // Primer can inline each in its chapter without duplicating the binaries.
   // Mounted before buildersStatic so /builders/diagrams/*.png resolves to docs/.
   const diagramsStatic = express.static(path.join(ROOT, 'docs/onboarding/diagrams'), {
     setHeaders: (res) => res.setHeader('Cache-Control', 'public, max-age=300'),
@@ -1423,19 +1427,6 @@ function mountInternalSurfaces(app) {
     res.sendFile(path.join(ROOT, 'docs/onboarding/primer.md'));
   });
 
-  // Drachmae & karma reader (task 1472) — the builder-facing "how you get paid"
-  // doc. The canonical markdown lives at docs/onboarding/drachmae-and-karma.md
-  // (single source of truth, also linked from the primer + the repo); the
-  // /builders/drachmae page (drachmae.js + md-reader.js) fetches + renders it
-  // client-side. Same static-file mount pattern as primer.md above; public
-  // like the /ranks page — economy transparency, no sign-in gate.
-  app.get('/builders/drachmae-and-karma.md', (req, res, next) => {
-    if (isModuleSurfaceHost(req)) return next();
-    res.set('Cache-Control', 'public, max-age=300');
-    res.set('Content-Type', 'text/markdown; charset=utf-8');
-    res.sendFile(path.join(ROOT, 'docs/onboarding/drachmae-and-karma.md'));
-  });
-
   // Rendered API docs (task 1918, BONGOS-V1). A self-describing OpenAPI 3.1 site
   // at /docs — cloudbongos.com/docs is the advertised canonical URL, and it works
   // on the apex of every instance (mounted in the SHARED surface, so a self-hosted
@@ -1474,7 +1465,7 @@ function mountInternalSurfaces(app) {
     if (isModuleSurfaceHost(req)) return next();
     if (req.path === '/builders' || req.path.startsWith('/builders/')) {
       // Serve HTML pages from the stamped in-memory copy (asset ?v= = content
-      // hash). Gated pages (primer, diagrams) have already passed the sign-in
+      // hash). Gated pages (the primer and the rest) have already passed the sign-in
       // gate above before reaching here. Everything else (js/css/png/json,
       // unknown paths) falls through to the on-disk static handler.
       if (req.method === 'GET' || req.method === 'HEAD') {

package/src/module-api.js

@@ -81,7 +81,7 @@ const { sleep } = require('./sleep');
 // MAJOR (see allowBoxScope below): passes the request through untouched.
 function deprecatedNoopMiddleware(_req, _res, next) { next(); }
 
-const CORE_VERSION = '1.24.34'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
+const CORE_VERSION = '1.24.36'; // 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('discord'); log.info('mounted');

package/tests/craft_mode_home.mjs

@@ -107,8 +107,12 @@ test('Home redraws itself for the craft, so it never hops from here', () => {
   assert.deepEqual(hops, []);
 });
 
-test('the nav item wins over the page name (Economy is drachmae.html)', () => {
-  const { CM } = boot({ page: 'drachmae', active: 'economy' });
+// The Economy page (drachmae.html, nav item 'economy') was this case's real example
+// until task 1005046 folded it into the Primer; the rule it pins is unchanged, so a
+// made-up pairing keeps it: the marked nav item (Tasks, Building's alone) is read
+// before the page name (Studio, which Artistry also shows).
+test('the nav item wins over the page name', () => {
+  const { CM } = boot({ page: 'studio', active: 'work' });
   assert.equal(CM.strandedBy('artistry'), true);
   assert.equal(CM.strandedBy('building'), false);
 });

package/tests/founding_builders.mjs

@@ -249,14 +249,15 @@ test('a project that was never founded keeps the wall hidden', async () => {
   assert.equal(host.hidden, true);
 });
 
-test('the profile and the ranks page read the same list, and every page loads the script first', () => {
+// task 1005046: the Ranks page, which carried a third founding ledger, folded
+// into the Primer; the founders are listed on Home's founding wall and on the
+// roster, both pinned here, so the ledger went with the page.
+test('the profile reads the same list, and every page loads the script first', () => {
   const profile = read('profile.js');
-  const ranks = read('ranks.js');
   // renderHead takes the role headline since task 1004434; the mark still follows it.
   assert.match(profile, /renderHead\(builder(?:, view)?\);\s*\n\s*renderFoundingMark\(builder\);/);
-  assert.match(ranks, /render\(builder \|\| \{\}\);\s*\n\s*renderFounding\(\);/);
-  assert.match(read('ranks.html'), /id="founding-scroll"[^>]*hidden/, 'the ranks section is hidden in the markup');
-  for (const [html, page] of [['roster.html', 'roster.js'], ['profile.html', 'profile.js'], ['ranks.html', 'ranks.js'], ['index.html', 'hall-widgets.js']]) {
+  assert.ok(!fs.existsSync(path.join(PUB, 'ranks.html')), 'the Ranks page and its founding ledger are gone');
+  for (const [html, page] of [['roster.html', 'roster.js'], ['profile.html', 'profile.js'], ['index.html', 'hall-widgets.js']]) {
     const src = read(html);
     const a = src.indexOf('/builders/founding-mark.js');
     const b = src.indexOf(`/builders/${page}`);

package/tests/founding_mode.mjs

@@ -43,7 +43,7 @@ test('active with no stage yet is the decide pre-stage, and every room sleeps',
   assert.equal(f.stage, 'decide');
   assert.equal(f.stage_number, 0);
   assert.equal(f.stage_count, 5);
-  for (const id of ['roadmap', 'goals', 'goal-map', 'work', 'board-room', 'economy', 'ranks', 'collab', 'roster']) {
+  for (const id of ['roadmap', 'goals', 'goal-map', 'work', 'board-room', 'collab', 'roster']) {
     assert.ok(id in f.asleep, `${id} sleeps while deciding`);
   }
 });
@@ -52,8 +52,11 @@ test('a room wakes once the stage that wakes it is behind', () => {
   const f = fm.shapeFoundingMode({ active: 'true', stage: 'charter' });
   for (const id of ['roadmap', 'goals', 'goal-map', 'work']) assert.ok(!(id in f.asleep), `${id} woke`);
   assert.equal(f.asleep['board-room'], 'charter');
-  assert.equal(f.asleep.economy, 'legalize');
-  assert.equal(f.asleep.ranks, 'legislation');
+  // task 1005046: Economy and Ranks were the rooms legalize and legislation woke;
+  // they are Primer chapters now, and the Primer never sleeps.
+  assert.ok(!('economy' in f.asleep) && !('ranks' in f.asleep), 'no retired Docs page is put to sleep');
+  assert.ok(!('primer' in f.asleep), 'the Primer stays awake through founding');
+  assert.deepEqual([...fm.WAKES.legalize, ...fm.WAKES.legislation], [], 'the two late stages wake no sidebar room');
   assert.equal(f.asleep.collab, 'alive', 'community wakes only when the planet is alive');
 });
 
@@ -118,7 +121,7 @@ class El {
 }
 
 function makeHall() {
-  const navIds = ['home', 'roadmap', 'goals', 'goal-map', 'work', 'board-room', 'economy', 'ranks', 'collab', 'roster', 'profile'];
+  const navIds = ['home', 'roadmap', 'goals', 'goal-map', 'work', 'board-room', 'collab', 'roster', 'profile'];
   const nav = navIds.map((id) => { const a = new El('a'); a.id = 'nav-' + id; a.className = 'nav-item'; return a; });
   const appBody = new El('div');
   const topbar = new El('header'); topbar.id = 'app-topbar';

package/tests/hall_board_world.mjs

@@ -315,7 +315,7 @@ test('the greeting reads /me only; the version tab and its progress read left Ho
 
 // Boot hall-render.js against a stub DOM and a ctx of getters (the way
 // builders.js builds it) and read what the greeting and the card actually say.
-function bootHallRender({ me, progress = null, leaderboard = [] }) {
+function bootHallRender({ me, progress = null, leaderboard = [], ctxExtra = {} }) {
   const els = new Map();
   const makeEl = () => ({
     dataset: {}, style: {}, textContent: '', hidden: false, _html: '', innerHTML: '',
@@ -354,6 +354,7 @@ function bootHallRender({ me, progress = null, leaderboard = [] }) {
     get lastMeState() { return me; }, get lastCostState() { return me.cost || null; }, get lastKarmaState() { return me.karma || null; },
     get lastNeedsState() { return me.needs || null; }, get lastRebaseState() { return me.needs_rebase_tasks || null; },
     get lastProgressState() { return progress; },
+    ...ctxExtra,
   };
   const api = windowObj.OTBHallRender(ctx);
   api.lbState.rows = leaderboard;
@@ -396,6 +397,48 @@ test('RUN: the Standing card carries the three facts, the place as "2nd of 4", a
   assert.match(withPrefs.el('home-standing-body').innerHTML, /<dt>Leaderboard place<\/dt><dd>—<\/dd>/, 'no roll yet: a dash, not a wrong place');
 });
 
+// task 1005046: "Where you stand" left the retired Ranks page for Accomplishments.
+// builders.js hands the factory its real tier MAP and its coercion; the card names
+// the viewer's rank, the rank above it read off that map, and how to reach it.
+const TIER_CTX = {
+  RANK_ORDER: { archon: 4, metic: 3, thetes: 2, xenos: 1 },
+  normalizeRank: (r) => ({ archon: 4, metic: 3, thetes: 2, xenos: 1 }[r] ? r : 'xenos'),
+};
+
+test('RUN: Where you stand names the viewer\'s rank, the one above it, and how to reach it', () => {
+  const { api, el } = bootHallRender({ me: ME, ctxExtra: TIER_CTX });
+  api.renderProfile({ ...ME.builder, rank: 'thetes' });
+  const html = el('rank-standing-body').innerHTML;
+  assert.match(html, /<div class="ranks-standing__badge"><span class="rank-badge rank-badge--thetes"/);
+  assert.match(html, /<p class="ranks-standing__title">The proven builder<\/p>/);
+  assert.match(html, /The rank above yours is <span class="rank-badge rank-badge--metic"/, 'the next rung is read off the tier map');
+  assert.match(html, /Promotion to <strong>Metic<\/strong>/, 'and the climb is the one from THIS rank');
+  assert.match(html, /<a href="\/primer#the-rank-ladder">/, 'the full ladder is one chapter of the Primer');
+  assert.doesNotMatch(html, /Loading…/, 'the skeleton is replaced');
+});
+
+test('RUN: Where you stand says so at the top, and coerces a stray rank to the entry rung', () => {
+  const top = bootHallRender({ me: ME, ctxExtra: TIER_CTX });
+  top.api.renderProfile({ ...ME.builder, rank: 'archon' });
+  const atTop = top.el('rank-standing-body').innerHTML;
+  assert.equal((atTop.match(/You hold the highest rank/g) || []).length, 1, 'said once, not twice');
+  assert.doesNotMatch(atTop, /ranks-standing__next/, 'no next rung to name');
+  const stray = bootHallRender({ me: ME, ctxExtra: TIER_CTX });
+  stray.api.renderProfile({ ...ME.builder, rank: 'strategos' });
+  const html = stray.el('rank-standing-body').innerHTML;
+  assert.match(html, /<p class="ranks-standing__title">The newcomer<\/p>/, 'a reserved rank reads as xenos, as the Standing band does');
+  assert.match(html, /The rank above yours is <span class="rank-badge rank-badge--thetes"/);
+});
+
+test('the Where you stand card is a Progress section of Accomplishments, with a Loading… line', () => {
+  const widgets = read('hall-widgets.js');
+  const at = widgets.indexOf("w('rank-scroll', 'Where you stand'");
+  assert.ok(at > -1, 'registered as a hall widget');
+  const reg = widgets.slice(at, widgets.indexOf('});', at));
+  assert.match(reg, /<div id="rank-standing-body"><div class="hall-loading" role="status">Loading…<\/div><\/div>/);
+  assert.match(reg, /view: 'standing', group: 'progress'/);
+});
+
 test('RUN: the three notices are inbox lines with a kind, a line and — where one exists — a door', () => {
   const { api, el } = bootHallRender({ me: ME });
   api.renderProfile(ME.builder);

package/tests/hall_fullscreen.mjs

@@ -276,7 +276,7 @@ test('no hall page draws its own back link; each carries the shell\'s hooks inst
   assert.match(read('tweak-editor.css'), /html:not\(\[data-fullscreen="on"\]\) \.tw-stage \.tw-back \{ display: none; \}/,
     'and shows it only in full screen, so the page never offers two');
   assert.match(read('idea.html'), /<body [^>]*data-back-fallback="\/thinking"/);
-  for (const f of ['primer.html', 'drachmae.html']) {
+  for (const f of ['primer.html']) {
     assert.match(read(f), /<a class="btn btn--ghost" data-shell-exit href="\/builders">/, `${f}: its error exit is the shell's`);
   }
   for (const f of fs.readdirSync(HALL).filter((n) => n.endsWith('.html'))) {

package/tests/hall_nav.mjs

@@ -308,8 +308,11 @@ test('sidebar groups read by audience, in order', () => {
   assert.ok(!nav.flatMap((g) => g.items).some((i) => /^\/people\b/.test(i.href)), 'no nav item points at the deleted /people');
   // task 1004473: 'commands' — every skill and CLI verb, read live — is reference
   // material that reads the same for every builder, so it joins Docs.
+  // task 1005046 (owner decision 2026-11-03, idea 1001311): ONE reading room. Ranks,
+  // Economy and Diagrams explained what the Primer explains; they are its chapters
+  // now, so Docs is the Primer and the four references that are not a document.
   assert.deepEqual(nav[3].items.map((i) => i.id),
-    ['primer', 'ranks', 'economy', 'commands', 'diagrams', 'atlas', 'modules', 'apidocs'], 'Docs = reference material');
+    ['primer', 'commands', 'atlas', 'modules', 'apidocs'], 'Docs = reference material');
   // 'government' (the Permissions tab, BV1.R113) is the group's one archon-gated item.
   // 'project-settings' joins the Government group at the metic floor (task 1003280,
   // goal 1000072) — it sits before 'government', which is the one archon-only item.
@@ -333,12 +336,26 @@ test('sidebar groups read by audience, in order', () => {
   assert.ok(!nav.flatMap((g) => g.items).some((i) => i.href === '/market-watch-settings'), 'no item points at the retired settings page');
 });
 
-test('Economy lives in Docs and points at the reward-schedule page', () => {
+// task 1005046: the three pages that left Docs left the hall. Their nav items are
+// gone, their files are gone, and each old URL 302s to the Primer chapter that
+// replaced it (tests/hall_page_gate_map.mjs pins the redirect; tests/
+// hall_reading_world.mjs pins that the chapter exists and carries its diagram).
+test('Ranks, Economy and Diagrams are Primer chapters, not pages', () => {
   const nav = parseNav(boot().sidebarHtml);
-  const economy = nav.find((g) => g.label === 'Docs').items.find((i) => i.id === 'economy');
-  assert.ok(economy, 'Docs carries an Economy entry — /drachmae had no nav entry before task 2175');
-  assert.equal(economy.href, '/drachmae');
-  assert.ok(fs.existsSync(path.join(HALL, 'drachmae.html')), 'the page it points at exists');
+  const items = nav.flatMap((g) => g.items);
+  for (const id of ['ranks', 'economy', 'diagrams']) {
+    assert.equal(items.some((i) => i.id === id), false, `the nav renders no '${id}' item`);
+    assert.doesNotMatch(SRC, new RegExp(`id: '${id}'`), `shell.js NAV declares no '${id}' item`);
+    assert.doesNotMatch(SRC, new RegExp(`\\n\\s*${id}: '<`), `and ICONS keeps no '${id}' glyph for it`);
+  }
+  for (const href of ['/ranks', '/drachmae', '/diagrams']) {
+    assert.equal(items.some((i) => i.href === href), false, `no item points at ${href}`);
+  }
+  for (const f of ['ranks.html', 'drachmae.html', 'diagrams.html']) {
+    assert.ok(!fs.existsSync(path.join(HALL, f)), `${f} left the hall`);
+  }
+  const primer = nav.find((g) => g.label === 'Docs').items.find((i) => i.id === 'primer');
+  assert.equal(primer.href, '/primer', 'the Primer is the reading room the three became');
 });
 
 test('every nav link lands on a page that exists', () => {
@@ -370,7 +387,7 @@ test('THE ARCHIVE: Ideas and Copy desk are off the nav, and both pages still exi
 
 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);
+  assert.equal(hrefResolves({ href: '/primer', external: false }), true);
 });
 
 // ── Community carries no rank flag (task 1003442, goal 1000075) ─────────────

package/tests/hall_page_gate_map.mjs

@@ -112,7 +112,10 @@ const ORACLE = {
   // gate those two rows left behind; see GONE_GATES below.)
   '/builders/primer': 'requireBuilderPage',
   '/builders/primer.md': 'requireBuilderPage',
-  '/builders/diagrams': 'requireBuilderPage',
+  // Gone (task 1005046, owner decision 2026-11-03): the Diagrams page is the Primer's
+  // chapters now, and /builders/diagrams 302s to the first of them before any gate
+  // runs. Its IMAGES are still served, on the Primer's tier, by the prefix gate.
+  '/builders/diagrams': null,
   '/builders/diagrams/02-b.png': 'requireBuilderPage',
 
   // Metic+ operator surfaces (the Governance nav group).
@@ -167,8 +170,9 @@ const ORACLE = {
   // same reason (its governed read is the same docket).
   '/builders/street': 'requireBoardVotePage',
 
-  // Deliberately UNGATED — the landing card, the rank ladder, the reward
-  // schedule and a builder's public portfolio all render for a stranger.
+  // Deliberately UNGATED — the landing card and a builder's public portfolio
+  // render for a stranger. (/ranks and /drachmae sat here too; since task 1005046
+  // they are Primer chapters, the old URLs 302 there, and GONE_PAGES holds them.)
   //
   // /roster joins them (task 1003441): it is this project’s own ledger, and its
   // one data source — GET /leaderboard — is deliberately unauthenticated,
@@ -186,8 +190,8 @@ const ORACLE = {
   // status dashboard is meant to read it too — "anyone landing on /builders or
   // the status dashboard can see what's stuck on the owner", the route's own
   // handler comment), so the page must not be gated tighter than the API it
-  // fronts — the same rule that puts /roster and /drachmae here. The nav link
-  // is still cosmetically 'signed', same as those two.
+  // fronts — the same rule that puts /roster here. The nav link is still
+  // cosmetically 'signed', same as that one.
   '/builders/blockers': null,
 
   // The bare detail slugs, gated by task 1003629 — the decision idea 1000907
@@ -350,6 +354,11 @@ const GONE_PAGES = {
   '/builders/people': 'task 1003444 — the hall has no cross-project directory; /people redirects to /roster',
   // Task 1005045 — one sidebar item for Market Watch: its settings are a tab on the page.
   '/builders/market-watch-settings': 'task 1005045 — the settings are the Settings tab on /market-watch; the old URL redirects there',
+  // Task 1005046 — one reading room: each is a Primer chapter, and the old URL 302s to it
+  // (tests/hall_reading_room.mjs runs the redirect).
+  '/builders/ranks': 'task 1005046 — the rank ladder is a Primer chapter; /ranks redirects there',
+  '/builders/drachmae': 'task 1005046 — credits and karma is a Primer chapter; /drachmae redirects there',
+  '/builders/diagrams': 'task 1005046 — each diagram sits in its Primer chapter; /diagrams redirects there',
 };
 
 test('a row that is null because the page left the hall serves no page', () => {