@bongos/core 1.21.19 → 1.21.21

package/modules/government/docket.js

@@ -29,6 +29,17 @@
 //
 //   { reading: 'flow', gate: …, read: async (ctx) => { figure, line, value, hot } }
 //
+//   { floor: 'release.live_month', gate: …,          // one of docket-vocab FLOORS
+//     read: async (ctx) => { count, line, lines: [[text, meta]], hot } }
+//
+//   { history: 'releases', building: 'release', gate: …,   // the record drawers
+//     read: async (ctx) => [{ id, title, at, outcome }, …] }
+//
+// A FLOOR (task 1004527) is a state rather than a queue — who sits, what the
+// month cost, what went live — read by the module that owns it, under the same
+// atom as its own route. HISTORY is what closed: rulings, amendments, releases,
+// sign-offs, payouts; the building interior files it into drawers by month.
+//
 // `ctx` is { builderId, rank, has(permission) } — `has` answers from the
 // viewer's permission set resolved ONCE for this request, server-side and
 // uncached (ADR 0016). A contribution with no recognisable gate is DROPPED, never
@@ -61,9 +72,15 @@ const db = require('./db');
 const { resolveBoardMembers } = require('./board-membership');
 const resolver = require('./resolver');
 const decisionRules = require('./decision-rules');
+const docketFloors = require('./docket-floors');
+const governmentConfig = require('./config');
 
 const log = api.logger('government');
 
+// This module's own floors are answered under the docket route's own atom (the
+// same one GET /government/constitution and the genesis stages require).
+const GOVERNMENT_GATE = Object.freeze({ permission: 'board.vote.cast' });
+
 const CONTRIBUTION_POINT = 'governor.docket';
 
 // Every source the reference design names, with the building it stands in. The
@@ -94,6 +111,13 @@ const COMING_SOURCES = Object.freeze([
     reason: 'The project has no budget or spending votes recorded yet.' }),
 ]);
 
+// Floors the design names whose engine does not exist yet. Drawn, and say why.
+const COMING_FLOORS = Object.freeze([
+  Object.freeze({ floor: 'charter.purpose', reason: 'The charter has no written purpose yet. A section for it is coming.' }),
+]);
+const MAX_FLOOR_LINES = 6;
+const MAX_HISTORY_PER_SOURCE = 60;
+
 
 // A source read that has not answered by now is reported unavailable rather than
 // holding the whole city hostage (one source calls GitHub, one the npm registry).
@@ -151,6 +175,31 @@ function normalizeMatter(raw, { source, building }) {
   };
 }
 
+// One floor as a contributor handed it → { count, line, lines, hot }. Pure.
+// Anything that is not a plain object is not a floor (→ null, read as
+// unavailable); a count is kept only as the short figure it was given.
+function normalizeFloor(raw) {
+  if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return null;
+  const str = (v, n) => (v == null ? '' : String(v).slice(0, n));
+  const count = raw.count == null || raw.count === '' ? '' : str(raw.count, 12);
+  const lines = (Array.isArray(raw.lines) ? raw.lines : [])
+    .filter((l) => Array.isArray(l) && l[0] != null && String(l[0]).trim())
+    .slice(0, MAX_FLOOR_LINES)
+    .map((l) => [str(l[0], 200), str(l[1], 40)]);
+  return { count, line: str(raw.line, 90) || null, lines, hot: raw.hot === true };
+}
+
+// One closed thing for the record → the docket's one shape. Pure. A row with no
+// title or no readable date is dropped: an undated record is not a record.
+function normalizeHistory(raw, { source, building }) {
+  if (!raw || typeof raw !== 'object' || raw.id == null || !raw.title) return null;
+  const at = iso(raw.at);
+  if (!at) return null;
+  const b = vocab.BUILDING_KEYS.includes(raw.building) ? raw.building : building;
+  if (!vocab.BUILDING_KEYS.includes(b)) return null;
+  return { id: `${source}:${raw.id}`, source, building: b, title: String(raw.title).slice(0, 200), at, outcome: raw.outcome ? String(raw.outcome).slice(0, 40) : null };
+}
+
 // Does this viewer pass this gate? Fail-closed: anything unrecognised is false.
 function gateAllows(gate, ctx) {
   if (!gate || typeof gate !== 'object') return false;
@@ -346,12 +395,16 @@ function withTimeout(promise, ms) {
 function registeredContributions() {
   const sources = new Map();
   const readings = new Map();
+  const floors = new Map();
+  const histories = new Map();
   for (const c of api.contributions(CONTRIBUTION_POINT)) {
     if (!c || typeof c !== 'object' || typeof c.read !== 'function' || !hasValidGate(c.gate)) continue;
     if (typeof c.source === 'string' && c.source) sources.set(c.source, c);
     else if (typeof c.reading === 'string' && c.reading) readings.set(c.reading, c);
+    else if (typeof c.floor === 'string' && c.floor) floors.set(c.floor, c);
+    else if (typeof c.history === 'string' && c.history && vocab.BUILDING_KEYS.includes(c.building)) histories.set(c.history, c);
   }
-  return { sources, readings };
+  return { sources, readings, floors, histories };
 }
 
 // ── the collector ────────────────────────────────────────────────────────────
@@ -362,13 +415,22 @@ function registeredContributions() {
 // `decisions` is the resolved decision-rules table (board.decisionRulesView), or
 // null when it could not be read — each building's `decision` is then null
 // rather than a guess.
-async function buildDocket({ viewer, permissions, contributions = registeredContributions(), now = Date.now(), timeoutMs = SOURCE_TIMEOUT_MS, decisions = null } = {}) {
+// `government` is what docketFor() read once for this module's own floors and
+// record (loadGovernment below); null leaves those floors `unavailable`.
+async function buildDocket({ viewer, permissions, contributions = registeredContributions(), now = Date.now(), timeoutMs = SOURCE_TIMEOUT_MS, decisions = null, government = null } = {}) {
   const held = new Set(permissions || []);
   const ctx = Object.freeze({
     builderId: String(viewer.id),
     rank: viewer.rank || null,
     has: (p) => held.has(p),
   });
+  // A per-request memo every read may use, so two floors that need the same rows
+  // share one query (task 1004527). Scoped to this call: nothing outlives it.
+  const memo = new Map();
+  const once = (key, fn) => {
+    if (!memo.has(key)) memo.set(key, Promise.resolve().then(fn));
+    return memo.get(key);
+  };
   const sources = new Map(contributions.sources);
   sources.set('board', BOARD_SOURCE); // the board is read here, never contributed
   const comingKeys = new Set(COMING_SOURCES.map((c) => c.source));
@@ -392,7 +454,7 @@ async function buildDocket({ viewer, permissions, contributions = registeredCont
     }
     if (!gateAllows(c.gate, ctx)) { row.status = 'not_yours'; return; }
     try {
-      const raw = await withTimeout(Promise.resolve(c.read(ctx, { now })), timeoutMs);
+      const raw = await withTimeout(Promise.resolve(c.read(ctx, { now, once })), timeoutMs);
       const list = (Array.isArray(raw) ? raw : []).map((m) => normalizeMatter(m, { source: decl.source, building: c.building || decl.building })).filter(Boolean);
       row.status = 'live';
       row.count = list.length;
@@ -421,7 +483,7 @@ async function buildDocket({ viewer, permissions, contributions = registeredCont
     if (!impl) return { ...base, status: 'off', reason: 'The module that holds this is not enabled here.' };
     if (!gateAllows(impl.gate, ctx)) return { ...base, status: 'not_yours' };
     try {
-      const r = await withTimeout(Promise.resolve(impl.read(ctx, { now, matters })), timeoutMs);
+      const r = await withTimeout(Promise.resolve(impl.read(ctx, { now, matters, once })), timeoutMs);
       if (!r) return { ...base, status: 'unavailable', reason: 'It could not be read just now.' };
       return {
         ...base,
@@ -437,17 +499,83 @@ async function buildDocket({ viewer, permissions, contributions = registeredCont
     }
   }));
 
+  // Floors (task 1004527): contributed, this module's own (answered from
+  // `government`, under the docket's own atom), and Ideas to ratify (from the
+  // board's matters, so it can never disagree with the pins).
+  const govAllowed = gateAllows(GOVERNMENT_GATE, ctx);
+  const comingFloors = new Map(COMING_FLOORS.map((c) => [c.floor, c.reason]));
+  const floorImpls = new Map(contributions.floors || []);
+  const boardRow = sourceStatus.find((s) => s.source === 'board');
+  const floorsP = Promise.all(vocab.FLOORS.map(async (decl) => {
+    const base = { key: decl.key, building: decl.building, status: null, count: '', line: null, lines: [], hot: false, reason: null };
+    const live = (f) => (f ? { ...base, status: 'live', ...f } : { ...base, status: 'unavailable', reason: 'It could not be read just now.' });
+    if (decl.key === 'planning.ideas') {
+      if (!boardRow || boardRow.status !== 'live') return { ...base, status: boardRow ? boardRow.status : 'unavailable', reason: boardRow ? boardRow.reason : null };
+      return live(normalizeFloor(docketFloors.ideasFloor(matters)));
+    }
+    const own = docketFloors.BUILDERS[decl.key];
+    if (own) {
+      if (!govAllowed) return { ...base, status: 'not_yours' };
+      let f = null;
+      try { f = government ? normalizeFloor(own(government)) : null; } catch (err) { log.warn({ floor: decl.key, err: err && err.message }, 'governor docket floor failed'); }
+      return live(f);
+    }
+    const impl = floorImpls.get(decl.key);
+    if (!impl) {
+      return comingFloors.has(decl.key)
+        ? { ...base, status: 'coming', reason: comingFloors.get(decl.key) }
+        : { ...base, status: 'off', reason: 'The module that holds this is not enabled here.' };
+    }
+    if (!gateAllows(impl.gate, ctx)) return { ...base, status: 'not_yours' };
+    try {
+      return live(normalizeFloor(await withTimeout(Promise.resolve(impl.read(ctx, { now, once })), timeoutMs)));
+    } catch (err) {
+      log.warn({ floor: decl.key, err: err && err.message }, 'governor docket floor failed');
+      return { ...base, status: 'unavailable', reason: err && err.message === 'timeout' ? 'It did not answer in time.' : 'It could not be read just now.' };
+    }
+  }));
+
+  // The record: what closed, from every module that keeps it, newest first.
+  const history = [];
+  const historySources = [];
+  if (govAllowed && government) {
+    history.push(...docketFloors.governmentHistory(government).map((h) => normalizeHistory(h, { source: 'government', building: h.building })).filter(Boolean));
+    historySources.push({ source: 'government', status: 'live' });
+  }
+  const historyP = Promise.all([...(contributions.histories || new Map())].map(async ([key, c]) => {
+    if (!gateAllows(c.gate, ctx)) { historySources.push({ source: key, building: c.building, status: 'not_yours' }); return; }
+    try {
+      const raw = await withTimeout(Promise.resolve(c.read(ctx, { now, once })), timeoutMs);
+      const list = (Array.isArray(raw) ? raw : []).slice(0, MAX_HISTORY_PER_SOURCE).map((h) => normalizeHistory(h, { source: key, building: c.building })).filter(Boolean);
+      history.push(...list);
+      historySources.push({ source: key, building: c.building, status: 'live' });
+    } catch (err) {
+      log.warn({ history: key, err: err && err.message }, 'governor docket history failed');
+      historySources.push({ source: key, building: c.building, status: 'unavailable' });
+    }
+  }));
+  const [floors] = await Promise.all([floorsP, historyP]);
+  history.sort((a, b) => (a.at < b.at ? 1 : a.at > b.at ? -1 : a.id < b.id ? -1 : 1));
+  historySources.sort((a, b) => (a.source < b.source ? -1 : 1));
+
   const counts = countStates(matters);
   const decisionBy = new Map((Array.isArray(decisions) ? decisions : []).filter(Boolean).map((d) => [d.area, d]));
+  const holdersBy = govAllowed && government && government.holders ? government.holders : {};
   const buildings = vocab.BUILDINGS.map((b) => {
     const here = matters.filter((m) => m.building === b.key);
     const d = decisionBy.get(b.key) || null;
+    const held = Array.isArray(holdersBy[b.key]) ? holdersBy[b.key] : null;
     return {
       key: b.key, name: b.name, group: b.group, counts: countStates(here), matter_ids: here.map((m) => m.id),
       decision: d ? {
         who: d.who, rule: d.rule, rule_words: d.rule_words, decided_by: d.decided_by,
         as_today: d.as_today, sitting: d.sitting, set_by_item_id: d.set_by_item_id,
       } : null,
+      // Who holds the seat now, as the row seats them (task 1004527): the board's
+      // members, a sitting's predicate, or the holders of the fixed gate's atom.
+      // null when it could not be resolved — never an invented seat.
+      holders: held ? held.slice(0, 12).map((h) => person({ id: h.builder_id ?? h.id, login: h.github_login ?? h.login, name: h.display_name ?? h.name })).filter(Boolean) : null,
+      holder_count: held ? held.length : null,
     };
   });
   return {
@@ -459,6 +587,9 @@ async function buildDocket({ viewer, permissions, contributions = registeredCont
     buildings,
     sources: sourceStatus,
     readings,
+    floors,
+    history,
+    history_sources: historySources,
     vocabulary: {
       buildings: vocab.BUILDINGS, rules: vocab.RULES, states: vocab.STATES,
       // The table's rule set — the matter glyphs plus vacant (no one holds it).
@@ -477,14 +608,64 @@ async function docketFor(builder) {
     log.warn({ err: err && err.message }, 'governor docket: decision rules unreadable');
     return null;
   });
-  return buildDocket({ viewer: builder, permissions, decisions });
+  const government = permissions.includes(GOVERNMENT_GATE.permission) ? await loadGovernment({ decisions }) : null;
+  return buildDocket({ viewer: builder, permissions, decisions, government });
+}
+
+// This module's own floors and record, read ONCE per request (task 1004527),
+// each piece isolated: a read that fails leaves its piece null, which the pure
+// builders in docket-floors.js turn into an `unavailable` floor.
+//   holders  per building, the people its decision-rules row seats now: the
+//            board's members (charter), a sitting's predicate, or the active
+//            holders of a rank that grants the fixed gate's atom; [] when vacant.
+async function loadGovernment({ decisions }) {
+  const safe = (p, what) => Promise.resolve().then(p).catch((err) => {
+    log.warn({ err: err && err.message, what }, 'governor docket: a government read failed');
+    return null;
+  });
+  const { board: live } = governmentConfig.loadGovernmentConfig();
+  const [members, genesis, rankRows, assignments, amendments, room] = await Promise.all([
+    safe(() => resolveBoardMembers(live), 'members'),
+    safe(() => board.genesisStageStatus(), 'genesis'),
+    safe(() => db.listRanksWithGrants(), 'ranks'),
+    safe(() => db.listAssignments(), 'assignments'),
+    safe(() => db.listAmendmentHistory(50), 'amendments'),
+    safe(() => board.boardRoomView({ closedLimit: 50 }), 'closed'),
+  ]);
+  const ranks = rankRows && assignments ? rankRows.map((r) => ({
+    rank_key: r.rank_key, label: r.label,
+    holders: assignments.filter((a) => a.rank_key === r.rank_key).length,
+  })) : null;
+  let holders = null;
+  if (Array.isArray(decisions)) {
+    holders = {};
+    await Promise.all(decisions.filter(Boolean).map(async (d) => {
+      if (d.decided_by === 'board') { holders[d.area] = members; return; }
+      if (d.decided_by === 'nobody') { holders[d.area] = []; return; }
+      if (d.decided_by === 'gate') {
+        if (!rankRows || !d.gate) { holders[d.area] = null; return; }
+        const keys = rankRows.filter((r) => (r.permissions || []).includes(d.gate)).map((r) => r.rank_key);
+        holders[d.area] = keys.length ? await safe(() => db.getActiveBuildersWithRank(keys), `holders:${d.area}`) : [];
+        return;
+      }
+      holders[d.area] = await safe(() => resolveBoardMembers({ membership: d.decided_by }), `holders:${d.area}`);
+    }));
+  }
+  return {
+    board: live, decisions, members, genesis, ranks, assignments, amendments, holders,
+    closed: room && Array.isArray(room.closed) ? room.closed : null,
+  };
 }
 
 module.exports = {
   CONTRIBUTION_POINT,
   EXPECTED_SOURCES,
   COMING_SOURCES,
+  COMING_FLOORS,
   SOURCE_TIMEOUT_MS,
+  normalizeFloor,
+  normalizeHistory,
+  loadGovernment,
   SETTLED_WINDOW_MS,
   normalizeMatter,
   gateAllows,

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

@@ -91,7 +91,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-10-01-look"></script>
+<script src="/builders/shell.js?v=2026-10-02-theme"></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

@@ -50,7 +50,7 @@
 
 <!-- The app shell (sidebar + top bar). Dependency-free; loaded FIRST so the
      chrome exists before the page script runs. -->
-<script src="/builders/shell.js?v=2026-10-01-look"></script>
+<script src="/builders/shell.js?v=2026-10-02-theme"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- shared frontend toolkit (window.OTB — rank labels, number formats) + the

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

@@ -60,7 +60,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-10-01-look"></script>
+<script src="/builders/shell.js?v=2026-10-02-theme"></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/dom-utils.js?v=2026-06-16-board"></script>

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

@@ -47,10 +47,24 @@ html:has(body[data-page="city"]) { height: 100%; }
 .city-mode { background: none; border: 1px solid var(--rule); border-radius: 999px; height: 36px; padding: 0 11px; display: flex; align-items: center; gap: 8px; cursor: pointer; color: var(--ink); font-family: var(--font-body); }
 .city-mode svg { display: block; stroke-width: 1.4; }
 
-/* the stage: the prototype's 1440 x 900 artboard, scaled to the window by
+/* THE STAGE IN THE HALL (task 1004544, the sky's mechanism from task 1004327).
+   <main class="city-main"> is the box under the hall's top bar and beside its
+   64px rail (the drawer's phone width has no rail) and, in full screen
+   (html[data-fullscreen="on"], shell.js), the whole window. `contain: layout
+   paint` makes it the containing block of every positioned layer inside, so
+   the home above and below measures from the stage instead of the window. */
+.city-main { position: fixed; top: var(--topbar-h, 56px); left: var(--sidebar-w-rail, 64px); right: 0; bottom: 0; max-width: none; margin: 0; contain: layout paint; z-index: 1; }
+html[data-fullscreen="on"] .city-main { top: 0; left: 0; }
+@media (max-width: 768px) { .city-main { left: 0; } }
+/* The full-screen switch floats top right over the stage, where the sun/moon
+   switch sits; the strip steps in by the button's width so nothing sits under it.
+   Under 640 the exit is the round button (style.css). */
+html[data-fullscreen="on"] .city-top { right: 184px; }
+@media (max-width: 640px) { html[data-fullscreen="on"] .city-top { right: 60px; } }
+
+/* the stage: the prototype's 1440 x 900 artboard, scaled to the stage by
    city.js (--city-scale) and centred, so 1440 x 900 is the prototype pixel
    for pixel */
-.city-main { position: fixed; inset: 0; z-index: 1; }
 .city-frame { position: absolute; inset: 0; overflow: hidden; }
 .city-stage { position: absolute; left: 50%; top: 50%; width: 1440px; height: 900px; transform: translate(-50%, -50%) scale(var(--city-scale, 1)); transform-origin: 50% 50%; }
 .city-zoom, .city-drift { position: absolute; left: 0; top: 0; width: 1440px; height: 900px; }

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

@@ -20,7 +20,17 @@
      /api/bongos/government/docket, task 1004523) and the open goals with their
      task rollups. The markup below is the prototype's home: the wordmark and
      the sun/moon switch in the header, the city, one button and one line.
-     Nothing else is on the page, on purpose: no hall sidebar, no top bar.
+
+     IN THE HALL (task 1004544, owner decision 2026-10-02). The city sits in
+     the hall's sidebar and top bar like every hall page, the way the sky has
+     since task 1004327, and the shell's full-screen switch
+     (data-fullscreen-switch) hides both so the city fills the window again,
+     remembered for this page. The whole home lives inside
+     <main class="city-main">, the stage under the top bar and beside the
+     rail (city.css), so what is drawn inside is unchanged and simply measures
+     from the stage instead of the window. The wordmark strip is a <div>, not
+     a <header>: the shell's top bar is the page's one <header>. There is still
+     no menu link to the city (owner: leave it off the sidebar).
 
      The drawing is city-draw.js (the prototype's iso kit, verbatim, as pure
      data); city.js reads the three feeds and turns the lists into SVG paths
@@ -34,16 +44,22 @@
      The page is gated on board.vote.cast (src/bongos/serve-internal.js), the
      same atom the docket read checks, so whoever reaches the city can read
      what it draws. -->
-<body data-page="city" class="city">
+<body data-page="city" data-page-title="The city" class="city" data-fullscreen-switch>
+
+<div class="app">
+  <aside class="app-sidebar" id="app-sidebar" aria-label="Primary"></aside>
+  <div class="app-scrim" id="app-scrim" hidden></div>
+  <div class="app-body">
+    <header class="app-topbar" id="app-topbar"></header>
 
-<header class="city-top">
-  <span class="city-mark">{{productName}}</span>
-  <button type="button" class="city-mode" id="cityMode" aria-label="Switch to light mode" title="Switch to light mode">
-    <svg width="14" height="14" viewBox="0 0 14 14" fill="none" stroke="currentColor" aria-hidden="true"><path id="cityModeIcon" d=""></path></svg>
-  </button>
-</header>
+<main id="hall-main" class="city-main">
+  <div class="city-top">
+    <span class="city-mark">{{productName}}</span>
+    <button type="button" class="city-mode" id="cityMode" aria-label="Switch to light mode" title="Switch to light mode">
+      <svg width="14" height="14" viewBox="0 0 14 14" fill="none" stroke="currentColor" aria-hidden="true"><path id="cityModeIcon" d=""></path></svg>
+    </button>
+  </div>
 
-<main class="city-main" id="cityMain">
   <div class="city-frame" id="cityFrame">
     <div class="city-stage" id="cityStage" role="img" aria-label="The governor city">
       <div class="city-zoom">
@@ -64,7 +80,11 @@
     <h1 class="city-line" id="cityLine" aria-live="polite">reading the docket</h1>
   </div>
 </main>
+  </div>
+</div>
 
+<script src="/builders/shell.js?v=2026-10-02-theme"></script>
+<script src="/builders/palette.js" defer></script>
 <script src="/builders/city-draw.js?v=2026-10-02-city1"></script>
 <script src="/builders/city.js?v=2026-10-02-city1"></script>
 </body>

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

@@ -65,6 +65,24 @@
     chosen = next;
     try { window.localStorage.setItem(THEME_KEY, next); } catch (_) { /* private mode: this page only */ }
     draw(applyTheme());
+    syncShell();
+  }
+  // IN THE HALL (task 1004544) the shell's top bar carries the hall's own theme
+  // switch beside this one. Both write the same 'hall-theme' preference and the
+  // same html[data-theme]; each repaints when the other flips it, so the two
+  // icons and the drawing's faces never disagree.
+  var painted = null;
+  function syncShell() {
+    var shell = window.OTBShell;
+    painted = effectiveTheme();
+    if (shell && typeof shell.applyTheme === 'function' && storedTheme() === painted) shell.applyTheme();
+  }
+  function watchShellTheme() {
+    if (typeof MutationObserver !== 'function') return;
+    new MutationObserver(function () {
+      var t = document.documentElement.getAttribute('data-theme');
+      if ((t === 'dark' || t === 'light') && t !== painted) { painted = t; chosen = t; draw(applyTheme()); }
+    }).observe(document.documentElement, { attributes: true, attributeFilter: ['data-theme'] });
   }
 
   // ---------- fit the 1440 x 900 artboard to the window ----------
@@ -73,7 +91,10 @@
   function fit() {
     var stage = $('cityStage');
     if (!stage) return;
-    var w = window.innerWidth || 1440, h = window.innerHeight || 900;
+    // The stage is <main class="city-main">, the box the hall's chrome leaves
+    // (task 1004544); the full-screen switch resizes it and fires a resize.
+    var main = $('hall-main');
+    var w = (main && main.clientWidth) || window.innerWidth || 1440, h = (main && main.clientHeight) || window.innerHeight || 900;
     var s = Math.min(w / 1000, h / 900);
     stage.style.setProperty('--city-scale', String(Math.round(s * 1000) / 1000));
   }
@@ -168,7 +189,9 @@
     if (media && media.addEventListener) media.addEventListener('change', function () { if (!storedTheme()) draw(applyTheme()); });
     window.addEventListener('resize', fit);
     fit();
-    draw(applyTheme());
+    painted = applyTheme();
+    draw(painted);
+    watchShellTheme();
     return load();
   }
 

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

@@ -11,7 +11,13 @@
       "auth": true,
       "_": "The home: the wordmark, the switch, the city, start governing and the one line.",
       "actions": [["wait", 900]],
-      "expect": { "visible": ["#cityStage", "#cityStart", "#cityLine", "#cityMode"], "href": [["#cityStart", "/builders/street"]] }
+      "expect": { "visible": ["#cityStage", "#cityStart", "#cityLine", "#cityMode", "#app-topbar", "#fullscreen-toggle"], "href": [["#cityStart", "/builders/street"]] }
+    },
+    "fullscreen": {
+      "auth": true,
+      "_": "In the hall since task 1004544: the shell's full-screen switch pressed, the sidebar and the top bar gone, the city filling the window and the one exit in the corner (the sky's mechanism, task 1004327).",
+      "actions": [["wait", 900], ["click", "#fullscreen-toggle"], ["wait", 500]],
+      "expect": { "visible": ["#cityStage", "#cityStart", "#cityMode", "#fullscreen-toggle"], "hidden": ["#app-sidebar", "#topbar-title"], "attr": [["#fullscreen-toggle", "aria-pressed", "true"]] }
     },
     "switched": {
       "auth": true,

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

@@ -148,7 +148,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-10-01-look"></script>
+<script src="/builders/shell.js?v=2026-10-02-theme"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-23-contrib"></script>
 <script src="/builders/collab-lib.js?v=2026-09-24-archive"></script>

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

@@ -54,7 +54,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-10-01-look"></script>
+<script src="/builders/shell.js?v=2026-10-02-theme"></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/dom-utils.js?v=2026-06-14-domutils"></script>

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

@@ -177,7 +177,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-10-01-look"></script>
+<script src="/builders/shell.js?v=2026-10-02-theme"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-23-contrib"></script>
 <script src="/builders/hall-kit.js"></script>

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

@@ -74,7 +74,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-10-01-look"></script>
+<script src="/builders/shell.js?v=2026-10-02-theme"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-16-gate"></script>
 <script src="/builders/hall-kit.js"></script>

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

@@ -97,7 +97,7 @@
 
 <!-- The app shell (sidebar + top bar + footer). Dependency-free; runs at parse
      time so the chrome exists before the deferred page scripts execute. -->
-<script src="/builders/shell.js?v=2026-10-01-look"></script>
+<script src="/builders/shell.js?v=2026-10-02-theme"></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/diagram-viewer.js?v=2026-06-14-diagviewer-1" defer></script>

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

@@ -98,7 +98,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-10-01-look"></script>
+<script src="/builders/shell.js?v=2026-10-02-theme"></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/md-reader.js?v=2026-09-02-mdreader-2"></script>

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

@@ -54,7 +54,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-10-01-look"></script>
+<script src="/builders/shell.js?v=2026-10-02-theme"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-16-gate"></script>
 <script src="/builders/hall-kit.js"></script>

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

@@ -77,7 +77,7 @@
 <div id="gate-modal-root"></div>
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-10-01-look"></script>
+<script src="/builders/shell.js?v=2026-10-02-theme"></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/dom-utils.js?v=2026-06-16-gate"></script>

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

@@ -137,7 +137,7 @@
   </div>
 </div>
 
-<script src="/builders/shell.js?v=2026-10-01-look"></script>
+<script src="/builders/shell.js?v=2026-10-02-theme"></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

@@ -230,7 +230,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-10-01-look"></script>
+<script src="/builders/shell.js?v=2026-10-02-theme"></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/dom-utils.js?v=2026-06-14-domutils"></script>

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

@@ -134,7 +134,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-10-01-look"></script>
+<script src="/builders/shell.js?v=2026-10-02-theme"></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/dom-utils.js?v=2026-06-16-gate"></script>

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

@@ -52,7 +52,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-10-01-look"></script>
+<script src="/builders/shell.js?v=2026-10-02-theme"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-23-contrib" defer></script>
 <!-- task-detail.js still owns the #/idea/N and #/blocker/N overlay, so a ref

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

@@ -225,7 +225,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-10-01-look"></script>
+<script src="/builders/shell.js?v=2026-10-02-theme"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-23-contrib"></script>
 <!-- task 1003069 (R08) — the quick-filing form's routed result links a task

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

@@ -106,7 +106,7 @@
 <script src="/builders/brand-apply.js?v=2026-06-27-r75" defer></script>
 <!-- The app shell (sidebar + top bar + view router). Dependency-free; loaded
      BEFORE builders.js so the chrome ids exist when events are wired. -->
-<script src="/builders/shell.js?v=2026-10-01-look" defer></script>
+<script src="/builders/shell.js?v=2026-10-02-theme" 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.