@bongos/core 1.24.35 → 1.24.37

package/tests/hall_money_page.mjs

@@ -0,0 +1,272 @@
+// tests/hall_money_page.mjs — the owner's ONE money page (task 1005047, owner
+// decision 2026-11-03, idea 1001312).
+//
+// What the project spent and paid out was drawn on three pages: Project settings
+// ("Where the money went"), the Primer ("The treasury, so far", from the retired
+// Economy page) and /fleet (what each hosted project costs). They are three sections
+// of /money now. This file holds what makes that true and keeps it true:
+//
+//   * THE PAGE DRAWS ALL THREE, each only when its own read answers. money.js is
+//     RUN in a vm against the hall-preview fixtures: a section whose read refuses
+//     (a 403, or a hall without the provisioning module) stays hidden, and a page
+//     where nothing answers says so in one line instead of loading forever.
+//   * NO MONEY FIGURE IS DRAWN ON TWO HALL PAGES. Project settings and the Primer
+//     keep their knobs and their prose, read none of the three feeds, and link here.
+//   * OLD URLS LAND ON THE RIGHT SECTION. /fleet 302s to /money#hosting through the
+//     real middleware, and /money sits behind the government
+//     page floor.
+//
+// The treasury cases moved here from tests/hall_reading_room.mjs, and the fleet
+// page's wiring cases from tests/fleet_cost_view.mjs, with the code they test.
+
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import http from 'node:http';
+import path from 'node:path';
+import vm from 'node:vm';
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
+import { realOTB } from './helpers.mjs';
+
+const require = createRequire(import.meta.url);
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const HALL = path.join(ROOT, 'modules', 'hall-ui', 'public');
+const read = (f) => fs.readFileSync(path.join(HALL, f), 'utf8');
+const fixture = (name) => JSON.parse(fs.readFileSync(path.join(ROOT, 'scripts', 'hall-preview', 'fixtures', `${name}.json`), 'utf8'));
+
+const moneyHtml = read('money.html');
+const moneyJs = read('money.js');
+
+const OUTFLOW = '/api/bongos/project-account/outflow';
+const CHECKS = '/api/bongos/project-account/ledger-checks?limit=1';
+const TREASURY = '/api/bongos/public/cost-summary';
+const LEDGER = '/api/bongos/provisioning/fleet/cost-ledger';
+
+const costSummaryFixture = JSON.parse(
+  fs.readFileSync(path.join(ROOT, 'modules', 'ui-design', 'kit', 'fixtures', 'cost-summary.json'), 'utf8'),
+);
+
+// Just enough of an element for money.js: it writes a body's innerHTML and a
+// section's `hidden`, and asks a section to scroll into view.
+function fakeEl(id) {
+  return { id, hidden: true, innerHTML: '', scrolled: false, scrollIntoView() { this.scrolled = true; } };
+}
+
+// money.js in a vm. `responses` maps a URL to a payload (200), a number (that
+// status, no body) or an Error (the request threw). `page` boots it as the page.
+async function loadMoney({ responses = {}, page = false, hash = '', kit = true, branding = { currency: { label: 'drachmae' } } } = {}) {
+  const els = {};
+  for (const id of ['payouts', 'payouts-body', 'the-treasury', 'the-treasury-body', 'hosting', 'hosting-body', 'money-empty']) els[id] = fakeEl(id);
+  const warnings = [];
+  const requests = [];
+  const window = {
+    OTB: realOTB(),
+    __BRANDING__: branding,
+    location: { hash },
+    BongosClient: {
+      createClient: () => ({
+        request: async (method, url) => {
+          requests.push(url);
+          const r = responses[url];
+          if (r instanceof Error) throw r;
+          if (r === undefined) return { ok: false, status: 404, data: null };
+          if (typeof r === 'number') return { ok: false, status: r, data: null };
+          return { ok: true, status: 200, data: r };
+        },
+      }),
+    },
+  };
+  if (kit) {
+    const kitPath = path.join(HALL, 'hall-kit.js');
+    window.OTBKit = await import(`file://${kitPath.replace(/\\/g, '/')}`).then((m) => m.default);
+  }
+  const sandbox = { window, console: { warn: (...a) => warnings.push(a.join(' ')) } };
+  vm.createContext(sandbox);
+  // the hosting section draws through the real fleet-costs.js, as the page loads it
+  vm.runInContext(read('fleet-costs.js'), sandbox, { filename: 'fleet-costs.js' });
+  sandbox.document = page
+    ? { readyState: 'complete', getElementById: (id) => els[id] || null, addEventListener() {} }
+    : { readyState: 'complete', getElementById: () => null, addEventListener() {} };
+  vm.runInContext(moneyJs, sandbox, { filename: 'money.js' });
+  return { money: window.OTBMoney, els, warnings, requests };
+}
+
+const ALL = { [OUTFLOW]: fixture('project-account__outflow'), [TREASURY]: costSummaryFixture, [LEDGER]: fixture('provisioning__fleet__cost-ledger') };
+
+// ---- 1. one page, three sections, each on its own read ------------------------
+
+test('RUN: an owner finds spend and payouts, the treasury and the hosting bills on one page', async () => {
+  const t = await loadMoney({ responses: ALL, page: true });
+  await t.money.ready;
+  for (const id of ['payouts', 'the-treasury', 'hosting']) assert.equal(t.els[id].hidden, false, `#${id} is shown`);
+  assert.equal(t.els['money-empty'].hidden, true);
+  assert.match(t.els['payouts-body'].innerHTML, /Owed but not paid/);
+  assert.match(t.els['payouts-body'].innerHTML, /Money out, by month/);
+  assert.match(t.els['the-treasury-body'].innerHTML, /id="treasury-spend"/);
+  assert.match(t.els['hosting-body'].innerHTML, /example-project/);
+  assert.deepEqual([...t.requests].sort(), [CHECKS, LEDGER, OUTFLOW, TREASURY].sort(), 'the three feeds the three pages read, and nothing new');
+});
+
+test('RUN: a section whose read refuses stays hidden — never an empty panel', async () => {
+  // payout.approve refused, and no provisioning module (its route is not mounted)
+  const t = await loadMoney({ responses: { [OUTFLOW]: 403, [TREASURY]: costSummaryFixture, [LEDGER]: 404 }, page: true });
+  await t.money.ready;
+  assert.equal(t.els.payouts.hidden, true);
+  assert.equal(t.els.hosting.hidden, true, 'the hosting section shows only where the provisioning module answers, as /fleet did');
+  assert.equal(t.els['the-treasury'].hidden, false);
+  assert.ok(!t.requests.includes(CHECKS), 'no ledger check is read for a reader the outflow refused');
+});
+
+test('RUN: a page where nothing answers says so in one line instead of loading forever', async () => {
+  for (const responses of [{}, { [OUTFLOW]: new Error('down'), [TREASURY]: { daily: [], daily_credits: [] }, [LEDGER]: 403 }]) {
+    const t = await loadMoney({ responses, page: true });
+    await t.money.ready;
+    assert.equal(t.els['money-empty'].hidden, false);
+    for (const id of ['payouts', 'the-treasury', 'hosting']) assert.equal(t.els[id].hidden, true);
+  }
+});
+
+test('RUN: an old /fleet link lands on the hosting section once it is drawn', async () => {
+  const t = await loadMoney({ responses: ALL, page: true, hash: '#hosting' });
+  await t.money.ready;
+  assert.equal(t.els.hosting.scrolled, true);
+  const none = await loadMoney({ responses: {}, page: true, hash: '#hosting' });
+  await none.money.ready;
+  assert.equal(none.els.hosting.scrolled, false, 'a hidden section is not scrolled to');
+});
+
+test('the page waits for its sections: a Loading… line until one is shown', () => {
+  assert.match(moneyHtml, /<p class="hall-loading hall-loading--page hall-loading--wait" role="status">Loading…<\/p>/);
+  for (const id of ['payouts', 'the-treasury', 'hosting', 'money-empty']) {
+    assert.match(moneyHtml, new RegExp(`<section class="scroll" id="${id}" [^>]*hidden>`), `#${id} starts hidden`);
+  }
+});
+
+test('the page loads the kit and the hosting builders before its own script', () => {
+  const loaded = [...moneyHtml.matchAll(/<script[^>]+src="([^"?]+)/g)].map((m) => m[1].split('/').pop());
+  const at = (f) => loaded.indexOf(f);
+  assert.ok(at('hall-kit.js') > -1 && at('fleet-costs.js') > -1 && at('money.js') > -1);
+  assert.ok(at('hall-kit.js') < at('money.js') && at('fleet-costs.js') < at('money.js'));
+  assert.match(moneyHtml, /project-settings\.css/, 'the payout figures keep their sheet');
+});
+
+// ---- 2. the payouts section (moved from project-settings.js) --------------------
+
+test('RUN: the payouts lead with what is left after what is owed', async () => {
+  const { money } = await loadMoney();
+  const html = money.payoutsHtml(fixture('project-account__outflow'), null);
+  for (const label of ['Balance', 'Owed but not paid', 'Approved, not started', 'Left after all of that']) {
+    assert.ok(html.includes(`<span class="ps-money__label">${label}</span>`), label);
+  }
+  assert.equal(money.payoutsHtml(null, null), '');
+  assert.equal(money.payoutsHtml({ balance: null }, null), '');
+  assert.equal(money.lastTryWords({ last_outcome: 'held', last_reason: 'no_processor' }), 'Waiting — no payment processor connected yet');
+  assert.equal(money.lastTryWords({ last_outcome: 'failed', last_reason: 'some_code' }), 'Did not go through', 'an unknown code is left out, never shown as a slug');
+});
+
+// ---- 3. the treasury (moved from primer-live.js) -------------------------------
+
+test('RUN: the treasury draws from the payload, and its line ends on the total the prose states', async () => {
+  const { money } = await loadMoney();
+  const html = money.treasuryHtml(costSummaryFixture);
+  const usd = `$${Number(costSummaryFixture.total_usd).toLocaleString(undefined, { maximumFractionDigits: 0 })}`;
+  assert.ok(html.includes(`<strong>${usd}</strong>`), 'the spend total is stated');
+  assert.match(html, /id="treasury-spend"/);
+  assert.match(html, /id="treasury-earned"/);
+  assert.match(html, /Drachmae awarded, cumulative/, 'the currency word is the branding pack\'s');
+  assert.match(html, /<h3 class="ps-money__h" id="treasury-by-category">Spent, by kind<\/h3>/, 'under the section\'s h2, named apart from "Where the money went"');
+  assert.doesNotMatch(html, /NaN|Infinity/, 'a NaN in a path renders as an invisible chart with no error anywhere');
+  assert.doesNotMatch(html, /tabindex="0"/, 'no focus stop: nothing here wires a readout');
+  assert.doesNotMatch(html, /&amp;amp;|&amp;#/, 'nothing is escaped twice');
+});
+
+test('RUN: a treasury that holds nothing yet, or no chart kit, draws nothing', async () => {
+  const { money } = await loadMoney();
+  assert.equal(money.treasuryHtml(null), '');
+  assert.equal(money.treasuryHtml({ daily: [], daily_credits: [] }), '');
+  const noKit = await loadMoney({ responses: { [TREASURY]: costSummaryFixture }, page: true, kit: false });
+  await noKit.money.ready;
+  assert.equal(noKit.els['the-treasury'].hidden, true, 'without the chart kit there is nothing honest to draw');
+  assert.match(noKit.warnings.join('\n'), /OTBKit missing/);
+});
+
+test('the treasury reads the endpoint the status page draws, and draws only through the kit', () => {
+  assert.match(moneyJs, /TREASURY_URL = `\$\{API\}\/public\/cost-summary`/);
+  for (const fn of ['cumulateByDay', 'timeStepSeriesHtml', 'plotSvgHtml', 'plotValueLabelHtml', 'barSeriesHtml']) {
+    assert.match(moneyJs, new RegExp(`kit\\.${fn}\\(`), `the treasury draws through ${fn}`);
+  }
+  assert.doesNotMatch(moneyJs, /<(?:path|polyline|rect)\b[^>]*\b(?:d|points)="\$\{/, 'no hand-built SVG geometry');
+});
+
+// ---- 4. no money figure on two hall pages ---------------------------------------
+
+test('no other hall page reads the three money feeds', () => {
+  const FEEDS = [/project-account\/outflow/, /project-account\/ledger-checks/, /fleet\/cost-ledger/];
+  // fleet-costs.js is the hosting section's own drawing, loaded only by money.html.
+  const files = fs.readdirSync(HALL).filter((f) => /\.(js|html)$/.test(f) && !['money.js', 'fleet-costs.js'].includes(f));
+  for (const f of files) {
+    for (const re of FEEDS) assert.doesNotMatch(read(f), re, `${f} reads ${re} — that figure belongs on /money`);
+  }
+  // The treasury feed is also the Tasks board's credits tile (a count of credits,
+  // not money) — but no other page draws the treasury itself.
+  for (const f of ['project-settings.js', 'project-settings.html', 'primer.js', 'primer-live.js']) {
+    assert.doesNotMatch(read(f), /cost-summary|treasury-spend|Where the money went<\/h2>/, `${f} draws no money figure`);
+  }
+});
+
+test('Project settings and the Primer link to the money page instead', () => {
+  assert.match(read('project-settings.html'), /<a href="\/builders\/money">Money<\/a>/);
+  assert.doesNotMatch(read('project-settings.html'), /id="ps-money"/);
+  const md = fs.readFileSync(path.join(ROOT, 'docs', 'onboarding', 'primer.md'), 'utf8');
+  assert.match(md, /\[Money\]\(\.\.\/\.\.\/modules\/hall-ui\/public\/money\.html\)/, 'a hall-page link primer.js opens in the hall');
+  assert.doesNotMatch(read('primer-live.js'), /fillTreasury|treasuryHtml/);
+});
+
+// ---- 5. the gate, the nav and the old URL ---------------------------------------
+
+test('/money is behind the government page floor, and the nav mirrors it', () => {
+  const src = fs.readFileSync(path.join(ROOT, 'src', 'bongos', 'serve-internal.js'), 'utf8');
+  assert.match(src, /const MONEY_PAGE_RE = \/\^\\\/builders\\\/money\(\?:\\\.html\)\?\\\/\?\$\/;/);
+  assert.match(src, /\|\| MONEY_PAGE_RE\.test\(norm\)\) \{\n\s+return gdsAuth\.requireGovernmentPage\(req, res, next\);/);
+  assert.match(read('shell.js'), /\{ id: 'money', label: 'Money', icon: 'money', href: '\/money', gate: 'government', position: true \}/);
+  assert.doesNotMatch(read('shell.js'), /id: 'fleet'/, 'Fleet costs left the sidebar');
+  // the hosting section's data keeps its own wall: the route's atom, unchanged
+  const route = fs.readFileSync(path.join(ROOT, 'modules', 'provisioning', 'routes', 'provisioning.js'), 'utf8');
+  assert.match(route, /router\.get\('\/provisioning\/fleet\/cost-ledger', auth\.requireBuilder, auth\.requirePermission\('provisioning\.fleet\.manage'\)/);
+});
+
+async function withHall(fn) {
+  const express = require('express');
+  const { mountInternalSurfaces } = require('../src/bongos/serve-internal.js');
+  const app = express();
+  mountInternalSurfaces(app);
+  const server = app.listen(0, '127.0.0.1');
+  await new Promise((r) => server.once('listening', r));
+  const { port } = server.address();
+  const get = (p, host) => new Promise((resolve, reject) => {
+    http.get({ host: '127.0.0.1', port, path: p, headers: { host } }, (res) => {
+      res.resume();
+      res.on('end', () => resolve({ status: res.statusCode, location: res.headers.location || '' }));
+    }).on('error', reject);
+  });
+  try { await fn(get); } finally { server.close(); }
+}
+
+test('RUN: /fleet 302s to the money page\'s hosting section, in every form it was linked', async () => {
+  await withHall(async (get) => {
+    for (const form of ['/fleet', '/fleet/', '/fleet.html']) {
+      const r = await get(form, 'builders.127.0.0.1');
+      assert.equal(r.status, 302, `${form} is a temporary redirect, so a later re-point is never cached past`);
+      assert.equal(r.location, '/money#hosting');
+    }
+    const q = await get('/fleet?from=mail', 'builders.127.0.0.1');
+    assert.equal(q.location, '/money?from=mail#hosting', 'a query string rides along');
+  });
+});
+
+test('the states file shoots the redirected deep link too', () => {
+  const states = JSON.parse(read('money.states.json'));
+  assert.equal(states.page, '/builders/money');
+  assert.match(states.states.hosting.url, /#hosting$/);
+});

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.
@@ -319,12 +322,13 @@ test('sidebar groups read by audience, in order', () => {
   // 'deploy' (task 1003159, ADR 0293) is the SECOND archon item, beside 'government':
   // its gate is the `core.pin.move` atom, archon-floor and system:true. It sits with
   // the steering surfaces because that is what it is — the owner's third release gate.
-  // 'fleet' (task 1001949) follows it at the metic floor of `provisioning.fleet.manage`:
-  // what each hosted project costs is an operator surface, like the rest of this group.
+  // 'money' (task 1005047, owner decision 2026-11-03) follows 'project-settings' at the
+  // same government floor: the one money page — spend and payouts, the treasury and the
+  // hosting bills. It replaced 'fleet' (task 1001949), now its #hosting section.
   // 'market-watch-settings' (task 1004938) LEFT the group in task 1005045: the owner saw
   // "Market Watch" twice and had to guess which was which (owner decision 2026-11-03,
   // idea 1001310). The settings are an owner-only Settings tab on /market-watch now.
-  assert.deepEqual(nav[4].items.map((i) => i.id), ['watch', 'gate', 'sessions', 'project-settings', 'deploy', 'fleet', 'government']);
+  assert.deepEqual(nav[4].items.map((i) => i.id), ['watch', 'gate', 'sessions', 'project-settings', 'money', 'deploy', 'government']);
   // task 1005045: and no label is left twice anywhere in the sidebar, so the next pair
   // fails here instead of in front of the owner.
   const labels = [...boot().sidebarHtml.matchAll(/<a class="nav-item" [^>]*>[\s\S]*?<span class="nav-item__label">([^<]*)<\/span>/g)].map((m) => m[1]);
@@ -333,12 +337,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 +388,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) ─────────────
@@ -762,7 +780,7 @@ test('no glyph path data reads as an IP address to the release leak scan', () =>
 // block (task 1004713). These drive the real shell and the real gov-positions.js.
 
 const tick = () => new Promise((resolve) => setImmediate(resolve));
-const GOVERNING = ['board-room', 'city', 'watch', 'gate', 'sessions', 'project-settings', 'deploy', 'fleet', 'government'];
+const GOVERNING = ['board-room', 'city', 'watch', 'gate', 'sessions', 'project-settings', 'money', 'deploy', 'government'];
 const lead = (building, title) => ({ kind: 'lead', seat: 'lead:' + building, building, title });
 const block = (held) => ({ held, title: held.length ? held[0].title : null, has_position: held.length > 0 });
 

package/tests/hall_oversight_world.mjs

@@ -278,7 +278,7 @@ test('RUN: a metric its snapshots never carried is skipped, not drawn as a cliff
 
 // ---- task 1004829: the government pages read like the rebuilt Home ----------
 
-const GOV_PAGES = ['watch', 'gate', 'sessions', 'project-settings', 'deploy', 'fleet', 'government'];
+const GOV_PAGES = ['watch', 'gate', 'sessions', 'project-settings', 'money', 'deploy', 'government'];
 
 test('every government page head holds only its h1, and no script writes into it', () => {
   // No page shows its head (task 1004836). A sub-line there is a line nobody

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).
@@ -123,6 +126,9 @@ const ORACLE = {
   // its neighbours: a steering surface, metic+ per ADR 0157. Its two WRITES gate
   // independently on `project.settings.manage`, so this row is only about the shell.
   '/builders/project-settings': 'requireGovernmentPage',
+  // The one money page (task 1005047): the same floor as project-settings, whose money
+  // section it took. Its hosting section's data keeps its own atom on the route.
+  '/builders/money': 'requireGovernmentPage',
   // The deploy door (task 1003159, ADR 0293) — the NARROWEST gate in this table, on
   // the `core.pin.move` atom: archon-floor and system:true, the same key its preview
   // and its move both check. Correct for the one page whose button restarts the live
@@ -130,8 +136,6 @@ const ORACLE = {
   // its write on purpose: the preview discloses the exact core version the box serves
   // and how far behind it is, which is a vulnerability window.
   '/builders/deploy': 'requireCorePinPage',
-  // The fleet cost page (task 1001949), on the atom its one read checks.
-  '/builders/fleet': 'requireFleetPage',
 
   // Gone (task 1003444, owner call 2026-09-25 — ADR 0337 D5): the cross-project
   // directory left the hall, and /people now redirects to /roster before this
@@ -167,8 +171,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 +191,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 +355,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', () => {