@bongos/core 1.21.35 → 1.21.37

package/modules/autonomy/matter-acts.js

@@ -0,0 +1,41 @@
+'use strict';
+
+// modules/autonomy/matter-acts.js — what a PASSED Automation matter carries out
+// (task 1004561, goal 1000125). When a project's decision table puts Automation
+// to a sitting, the sitting's passed matter acts here, after the close commits:
+// the switch on or off, or one goal allowed. Each act goes through the SAME db
+// function its direct route calls (POST /autonomy/fence, POST
+// /autonomy/fence/goals), so a matter can do nothing the route could not.
+// The government module only checks the act's shape and calls in through the
+// 'governor.matterAct' contribution point (a module never requires a sibling).
+
+const api = require('../../src/module-api');
+const db = require('./db');
+
+const log = api.logger('autonomy');
+const POINT = 'governor.matterAct';
+
+const why = (ctx) => `a passed Automation matter (matter ${ctx && ctx.matterId})`;
+
+async function switchFence(enabled, ctx) {
+  const row = await db.setFenceEnabled({ enabled, reason: why(ctx), builderId: ctx.decidedBy });
+  if (!row) return { done: false, reason: 'fence_uninitialised' };
+  log.info(`[gds] autonomy fence ${enabled ? 'ENABLED' : 'DISABLED'} by ${why(ctx)}, proposed by builder ${ctx.decidedBy}`);
+  return { done: true };
+}
+
+const ACTS = Object.freeze({
+  switch_on: (_action, ctx) => switchFence(true, ctx),
+  switch_off: (_action, ctx) => switchFence(false, ctx),
+  allow_goal: async (action, ctx) => {
+    await db.allowGoal({ goalId: action.goal_id, note: why(ctx), builderId: ctx.decidedBy });
+    log.info(`[gds] autonomy fence: goal ${action.goal_id} ALLOWED by ${why(ctx)}`);
+    return { done: true };
+  },
+});
+
+function contributeAutomationMatterActs() {
+  for (const [type, act] of Object.entries(ACTS)) api.contribute(POINT, { area: 'automation', type, act });
+}
+
+module.exports = { ACTS, contributeAutomationMatterActs };

package/modules/autonomy/routes/autonomy.js

@@ -108,6 +108,8 @@ const governorDocket = require('../governor-docket');
 
 module.exports = function buildAutonomyRouter() {
   governorDocket.contributeAutonomyToDocket();
+  // what a passed Automation matter carries out (task 1004561)
+  require('../matter-acts').contributeAutomationMatterActs();
   const router = express.Router();
 
   // The one Discord line for a runner idle on a setting (task 1004539). The port

package/modules/government/board.js

@@ -1370,6 +1370,9 @@ async function boardPassForIdea(ideaId) {
   });
 }
 
+// boardPassForIdea for a list, in one read (task 1004560).
+const boardPassedIdeaIds = async (ids) => new Set(await db.listPassedSubjectIds('full_idea', ids));
+
 // ── the summons: what is waiting on THIS member's vote (task 1003271) ───────
 //
 // THE PROBLEM THIS EXISTS TO FIX. Nine items sat open for two days with zero
@@ -1485,6 +1488,7 @@ module.exports = {
   maybeCloseAfterVote,
   latestRejectionForIdea,
   boardPassForIdea,
+  boardPassedIdeaIds,
   validateProposedConstitution,
   proposeAmendment,
   boardRoomView,

package/modules/government/db.js

@@ -712,6 +712,19 @@ async function getLatestPassedItem(subjectType, subjectId) {
   return rows[0] || null;
 }
 
+// Which of these subjects the board passed, in ONE read (task 1004560: the
+// Ideas-to-ratify desk asks for every open Full Idea at once).
+async function listPassedSubjectIds(subjectType, subjectIds) {
+  const ids = (subjectIds || []).map(Number).filter((n) => Number.isInteger(n) && n > 0);
+  if (!ids.length) return [];
+  const { rows } = await pool.query(
+    `SELECT DISTINCT subject_id FROM government_board_items
+      WHERE subject_type = $1 AND subject_id = ANY($2::bigint[]) AND outcome = 'passed'`,
+    [subjectType, ids],
+  );
+  return rows.map((r) => String(r.subject_id));
+}
+
 // The expiry sweep's read (R11): every OPEN item whose deadline has passed, on
 // the database clock, oldest deadline first. Served by the partial index
 // government_board_items_open_by_deadline (government_003 built it for exactly
@@ -872,6 +885,7 @@ module.exports = {
   getExpiredOpenBoardItems,
   getLatestReturnedItemWithObjection,
   getLatestPassedItem,
+  listPassedSubjectIds,
   createAmendment,
   getAmendment,
   listDecisionRules,

package/modules/government/decision-board.js

@@ -50,7 +50,9 @@ async function applyPassedDecisionRules(client, closedRow, amendment) {
 }
 
 // A passed matter: act where the building can act by itself, and build the
-// announcement. Never throws — the decision already stands.
+// announcement. Never throws — the decision already stands. Runs after the
+// close commits (People since task 1004529; Automation, Release, Review and
+// Treasury since task 1004561, through their owning modules' acts).
 async function actOnPassedMatter(closed) {
   const area = decisionRules.areaForSubjectType(closed.subject_type);
   let matter = null;
@@ -71,11 +73,30 @@ async function actOnPassedMatter(closed) {
         await db.unassignRank({ builderId: action.builder_id, rankKey: action.rank_key });
         result = { ...result, action: action.type, done: true, builder_id: String(action.builder_id), rank_key: action.rank_key };
       }
+    } else if (area !== 'people' && action && MATTER_ACTIONS[area]) {
+      // The owning module carries it out, through its direct route's own
+      // function (task 1004561). Re-validated first: the stored row was checked
+      // when opened and is immutable since, so a refusal means it was altered.
+      const v = validateMatterAction(area, action);
+      const doer = v.ok ? matterActFor(area, v.action.type) : null;
+      if (!v.ok) {
+        result = { ...result, action: action.type || null, done: false, reason: 'bad_action' };
+      } else if (!doer) {
+        result = { ...result, action: v.action.type, done: false, reason: 'not_wired' };
+      } else {
+        const out = (await doer.act(v.action, { decidedBy: matter.proposed_by, matterId: String(matter.id) })) || {};
+        result = { ...result, action: v.action.type, done: out.done === true, ...(out.reason ? { reason: String(out.reason) } : {}) };
+      }
     }
   } catch (err) {
     log.error(`[government] matter ${closed.subject_id} passed at ${area} but its act did NOT run (re-drivable from the passed item): ${err && err.message}`);
     result = { ...result, done: false, reason: 'act_failed' };
   }
+  // A refusal (already decided elsewhere, the module off) leaves the decision
+  // standing; it is said loudly here and carried as `acted: false`.
+  if (result.action && !result.done && result.reason !== 'act_failed') {
+    log.warn(`[government] matter ${closed.subject_id} passed at ${area} but its act was refused: ${result.reason || 'not done'}`);
+  }
   return {
     result,
     payload: {
@@ -153,22 +174,74 @@ async function decisionRulesView() {
 // the whole point — People decided by a council's consent sits as exactly that.
 const MATTER_TITLE_MAX = 200;
 const MATTER_DETAIL_MAX = 5000;
-const MATTER_ACTION_TYPES = Object.freeze(['assign_rank', 'unassign_rank']);
+// What a passed matter may carry out, per building (task 1004561). People acts
+// here, in this module; every other act is carried out by the module that owns
+// the building's direct route, through the same function that route calls,
+// contributed to 'governor.matterAct' as { area, type, act }. This table is only
+// the SHAPE of each act (field → kind), checked when the matter is opened and
+// again before it acts. 'id' is a positive integer, 'rank' a custom rank key,
+// 'usd' a non-negative amount or null (no limit).
+const MATTER_ACTIONS = Object.freeze({
+  people: Object.freeze({
+    assign_rank: Object.freeze({ builder_id: 'id', rank_key: 'rank' }),
+    unassign_rank: Object.freeze({ builder_id: 'id', rank_key: 'rank' }),
+  }),
+  automation: Object.freeze({
+    switch_on: Object.freeze({}),
+    switch_off: Object.freeze({}),
+    allow_goal: Object.freeze({ goal_id: 'id' }),
+  }),
+  release: Object.freeze({
+    approve_override: Object.freeze({ request_id: 'id' }),
+    approve_gate: Object.freeze({ pr: 'id' }),
+  }),
+  review: Object.freeze({
+    satisfy_criterion: Object.freeze({ criterion_id: 'id' }),
+  }),
+  treasury: Object.freeze({
+    set_budget: Object.freeze({ builder_id: 'id', monthly_usd: 'usd' }),
+  }),
+});
+const MATTER_ACT_POINT = 'governor.matterAct';
+const MAX_BUDGET_USD = 100000;
+
+function fieldValue(kind, raw) {
+  if (kind === 'id') {
+    const n = Number(raw);
+    return Number.isSafeInteger(n) && n > 0 && raw !== null && raw !== '' && typeof raw !== 'boolean' ? { ok: true, v: n } : { ok: false };
+  }
+  if (kind === 'rank') return typeof raw === 'string' && /^[a-z][a-z0-9-]*$/.test(raw) && raw.length <= 64 ? { ok: true, v: raw } : { ok: false };
+  if (kind === 'usd') {
+    if (raw === null) return { ok: true, v: null };
+    return typeof raw === 'number' && Number.isFinite(raw) && raw >= 0 && raw <= MAX_BUDGET_USD ? { ok: true, v: raw } : { ok: false };
+  }
+  return { ok: false };
+}
 
 function validateMatterAction(area, action) {
   if (action == null) return { ok: true, action: null };
-  if (area !== 'people') return { ok: false, reason: 'action_not_supported_here', expected: 'only People can act by itself today (assign_rank / unassign_rank)' };
+  const acts = MATTER_ACTIONS[area];
+  if (!acts) return { ok: false, reason: 'action_not_supported_here', expected: `a matter acts by itself only at ${Object.keys(MATTER_ACTIONS).join(', ')}` };
   if (typeof action !== 'object' || Array.isArray(action)) return { ok: false, reason: 'bad_action' };
+  const shape = acts[action.type];
+  if (!shape) return { ok: false, reason: 'bad_action', expected: Object.keys(acts) };
   for (const k of Object.keys(action)) {
-    if (!['type', 'builder_id', 'rank_key'].includes(k)) return { ok: false, reason: 'unknown_field', field: `action.${k}` };
+    if (k !== 'type' && !Object.prototype.hasOwnProperty.call(shape, k)) return { ok: false, reason: 'unknown_field', field: `action.${k}` };
   }
-  if (!MATTER_ACTION_TYPES.includes(action.type)) return { ok: false, reason: 'bad_action', expected: MATTER_ACTION_TYPES };
-  const builderId = Number(action.builder_id);
-  if (!Number.isInteger(builderId) || builderId <= 0) return { ok: false, reason: 'bad_action', field: 'action.builder_id' };
-  if (typeof action.rank_key !== 'string' || !/^[a-z][a-z0-9-]*$/.test(action.rank_key) || action.rank_key.length > 64) {
-    return { ok: false, reason: 'bad_action', field: 'action.rank_key' };
+  const out = { type: action.type };
+  for (const [k, kind] of Object.entries(shape)) {
+    if (!Object.prototype.hasOwnProperty.call(action, k)) return { ok: false, reason: 'bad_action', field: `action.${k}` };
+    const f = fieldValue(kind, action[k]);
+    if (!f.ok) return { ok: false, reason: 'bad_action', field: `action.${k}` };
+    out[k] = f.v;
   }
-  return { ok: true, action: { type: action.type, builder_id: builderId, rank_key: action.rank_key } };
+  return { ok: true, action: out };
+}
+
+// The owning module's act for (area, type), or null when that module is off.
+function matterActFor(area, type) {
+  return api.contributions(MATTER_ACT_POINT)
+    .find((c) => c && c.area === area && c.type === type && typeof c.act === 'function') || null;
 }
 
 async function openMatter({ area, title, detailMd = null, action = null, proposedBy } = {}) {
@@ -190,7 +263,10 @@ async function openMatter({ area, title, detailMd = null, action = null, propose
     };
   }
   if (!resolved.sitting) return { ok: false, reason: 'no_one_holds_this', area, what_this_means: `No one holds ${resolved.name} yet, so nothing there can be decided.` };
-  if (a.action) {
+  if (a.action && area !== 'people' && !matterActFor(area, a.action.type)) {
+    return { ok: false, reason: 'action_not_wired', area, what_this_means: `Nothing at ${resolved.name} can carry that out right now, so it would pass and do nothing. Turn on the module that owns ${resolved.name}, or file the matter without an act.` };
+  }
+  if (a.action && area === 'people') {
     const rank = await db.getRankByKey(a.action.rank_key);
     if (!rank) return { ok: false, reason: 'unknown_rank', rank_key: a.action.rank_key };
     if (rank.is_system) return { ok: false, reason: 'seeded_rank', rank_key: a.action.rank_key, expected: 'a custom rank — a seeded rank follows the builder\'s rank' };
@@ -295,6 +371,9 @@ module.exports = {
   proposeDecisionRules,
   decisionRulesView,
   validateMatterAction,
+  matterActFor,
+  MATTER_ACTIONS,
+  MATTER_ACT_POINT,
   openMatter,
   checkActAlone,
 };

package/modules/government/docket-vocab.js

@@ -101,6 +101,11 @@ const DESKS = Object.freeze([
   ['automation.switch', 'automation'], ['automation.goals', 'automation'], ['automation.runners', 'automation'],
   ['people.invite', 'people'], ['release.core', 'release'],
   ['rules.settings', 'rules'], ['rules.modules', 'rules'], ['treasury.backup', 'treasury'],
+  // the Planning desks (task 1004560): the goals in their worked order, and the
+  // ideas a ratifier may take from here
+  ['planning.order', 'planning'], ['planning.ratify', 'planning'],
+  // task 1004561: a builder's monthly spending limit, and a sign-off undone
+  ['treasury.budgets', 'treasury'], ['review.signed', 'review'],
 ].map(([key, building]) => Object.freeze({ key, building })));
 
 module.exports = {

package/modules/government/docket.js

@@ -250,8 +250,19 @@ function normalizeDeskRow(raw, { desk, building }) {
     opened_at: iso(raw.opened_at),
     ref: raw.ref && typeof raw.ref === 'object' ? { type: String(raw.ref.type), id: String(raw.ref.id) } : null,
     acts,
+    ...deskExtras(raw),
   };
 }
+// Two optional shapes a desk row may carry (task 1004560): `pips`, promises kept
+// of total drawn as squares (at most 12), and `set`, the ordered set the row sits
+// in (a version id) so the desk can reorder its rows and save the order whole.
+function deskExtras(raw) {
+  const out = {};
+  const p = raw.pips;
+  if (p && Number.isInteger(p.of) && p.of > 0 && p.of <= 12 && Number.isInteger(p.on) && p.on >= 0 && p.on <= p.of) out.pips = { on: p.on, of: p.of };
+  if (typeof raw.set === 'string' && /^[A-Za-z0-9._-]{1,64}$/.test(raw.set)) out.set = raw.set;
+  return out;
+}
 
 // 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

package/modules/government/routes/government.js

@@ -110,6 +110,7 @@ const governmentPort = {
   // is no counterpart that records an outcome, and there must never be one: an
   // outcome is written by a close, never by the module reading it.
   boardPassForIdea: board.boardPassForIdea,
+  boardPassedIdeaIds: board.boardPassedIdeaIds,
   // task 1004429 (BV2.PS04): a finished genesis stage is put to the board — the
   // genesis home (task 1004423) calls this when a stage's tasks are done. The
   // finished-tasks gate lives inside board.js; the item is an ordinary one under
@@ -789,7 +790,7 @@ module.exports = function buildGovernmentRouter() {
         proposedBy: req.builder.id,
       });
       if (!out.ok) {
-        if (out.reason === 'decided_by_gate' || out.reason === 'no_one_holds_this') {
+        if (out.reason === 'decided_by_gate' || out.reason === 'no_one_holds_this' || out.reason === 'action_not_wired') {
           return res.fail(out.reason, 409, { area: out.area, ...(out.gate ? { gate: out.gate } : {}), what_this_means: out.what_this_means });
         }
         return res.fail('invalid_matter', 400, {

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

@@ -91,9 +91,9 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-03-nav"></script>
-<script src="/builders/craft-mode.js?v=2026-10-03-nav"></script>
-<script src="/builders/shell.js?v=2026-10-03-nav"></script>
+<script src="/builders/shell-trail.js?v=2026-10-03-looks"></script>
+<script src="/builders/craft-mode.js?v=2026-10-03-looks"></script>
+<script src="/builders/shell.js?v=2026-10-03-looks"></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,9 +50,9 @@
 
 <!-- The app shell (sidebar + top bar). Dependency-free; loaded FIRST so the
      chrome exists before the page script runs. -->
-<script src="/builders/shell-trail.js?v=2026-10-03-nav"></script>
-<script src="/builders/craft-mode.js?v=2026-10-03-nav"></script>
-<script src="/builders/shell.js?v=2026-10-03-nav"></script>
+<script src="/builders/shell-trail.js?v=2026-10-03-looks"></script>
+<script src="/builders/craft-mode.js?v=2026-10-03-looks"></script>
+<script src="/builders/shell.js?v=2026-10-03-looks"></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,9 +60,9 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-03-nav"></script>
-<script src="/builders/craft-mode.js?v=2026-10-03-nav"></script>
-<script src="/builders/shell.js?v=2026-10-03-nav"></script>
+<script src="/builders/shell-trail.js?v=2026-10-03-looks"></script>
+<script src="/builders/craft-mode.js?v=2026-10-03-looks"></script>
+<script src="/builders/shell.js?v=2026-10-03-looks"></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.html

@@ -83,9 +83,9 @@
   </div>
 </div>
 
-<script src="/builders/shell-trail.js?v=2026-10-03-nav"></script>
-<script src="/builders/craft-mode.js?v=2026-10-03-nav"></script>
-<script src="/builders/shell.js?v=2026-10-03-nav"></script>
+<script src="/builders/shell-trail.js?v=2026-10-03-looks"></script>
+<script src="/builders/craft-mode.js?v=2026-10-03-looks"></script>
+<script src="/builders/shell.js?v=2026-10-03-looks"></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>

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

@@ -148,9 +148,9 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-03-nav"></script>
-<script src="/builders/craft-mode.js?v=2026-10-03-nav"></script>
-<script src="/builders/shell.js?v=2026-10-03-nav"></script>
+<script src="/builders/shell-trail.js?v=2026-10-03-looks"></script>
+<script src="/builders/craft-mode.js?v=2026-10-03-looks"></script>
+<script src="/builders/shell.js?v=2026-10-03-looks"></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,9 +54,9 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-03-nav"></script>
-<script src="/builders/craft-mode.js?v=2026-10-03-nav"></script>
-<script src="/builders/shell.js?v=2026-10-03-nav"></script>
+<script src="/builders/shell-trail.js?v=2026-10-03-looks"></script>
+<script src="/builders/craft-mode.js?v=2026-10-03-looks"></script>
+<script src="/builders/shell.js?v=2026-10-03-looks"></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,9 +177,9 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-03-nav"></script>
-<script src="/builders/craft-mode.js?v=2026-10-03-nav"></script>
-<script src="/builders/shell.js?v=2026-10-03-nav"></script>
+<script src="/builders/shell-trail.js?v=2026-10-03-looks"></script>
+<script src="/builders/craft-mode.js?v=2026-10-03-looks"></script>
+<script src="/builders/shell.js?v=2026-10-03-looks"></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/craft-mode.js

@@ -8,8 +8,9 @@
 //
 // It is a MODE the existing hall wears, never a second hall (the founding-mode
 // precedent, docs/design/project-startup-direction.md). The nav follows the mode
-// (task 1004493, MODE_TABS below); the tools and colours that follow it are their
-// own tasks (1004494 onward). Legacy mode is the hall exactly as it was.
+// (task 1004493, MODE_TABS below), and so does the look (task 1004495, LOOKS
+// below); the mode tools are their own tasks (1004496 onward). Legacy mode is the
+// hall exactly as it was.
 //
 // NO MODE is the default and the fallback: a reader who closes the picker, a
 // browser whose storage throws, a page that opts out — none of them get the
@@ -44,15 +45,15 @@
 
   // ---------- each mode's tabs (task 1004493) ----------
   // A mode shows only the nav items its craft needs, by NAV id (shell.js). ALWAYS
-  // is the owner's list of tabs no mode may hide (2026-10-01: Builders first), and
-  // every mode's list is ALWAYS plus its own. A mode with no entry here — Legacy,
+  // is the owner's list of tabs no mode may hide (2026-10-01: Builders first;
+  // 2026-10-03: Collab and Profile too), and every mode's list is ALWAYS plus its own. A mode with no entry here — Legacy,
   // or no mode at all — shows every tab, exactly as the hall did before.
   // Government lives in Governing alone, and Governing is the shortest list.
   // Hiding is cosmetic: a hidden tab's page still opens by its URL (ADR 0016).
-  var ALWAYS_TABS = ['roster'];
+  var ALWAYS_TABS = ['roster', 'collab', 'profile'];
   var MODE_TABS = {
     building: ['home', 'roadmap', 'goals', 'goal-map', 'work', 'blockers', 'thinking', 'studio',
-      'standing', 'profile', 'collab',
+      'standing',
       'primer', 'ranks', 'economy', 'commands', 'diagrams', 'atlas', 'modules', 'apidocs'],
     artistry: ['studio', 'goals', 'thinking'],
     ideating: ['goal-map', 'thinking', 'goals'],
@@ -91,6 +92,40 @@
       else head.removeAttribute('data-craft-off');
     }
   }
+  // ---------- each mode's look (task 1004495) ----------
+  // Artistry, Ideating and Governing each wear a look: the colour tokens in
+  // style.css (keyed on html[data-craft]), plus two things only this script can
+  // draw — the mode's words beside the page title, and its door's scene framed
+  // under the brand (artHtml, the picker's own art, so the two never drift).
+  // Building, Legacy and no mode have no entry here and wear nothing.
+  var LOOKS = { artistry: 'the studio · night', ideating: 'the sky', governing: 'the city' };
+  function remove(el) { if (el && el.parentNode) el.parentNode.removeChild(el); }
+  function applyLook(mode) {
+    var look = Object.prototype.hasOwnProperty.call(LOOKS, mode) ? LOOKS[mode] : null;
+    var plate = document.getElementById('craft-plate');
+    if (plate && plate.getAttribute('data-plate') !== (look ? mode : null)) { remove(plate); plate = null; }
+    var nav = document.getElementById('app-sidebar');
+    var brand = look && nav && nav.querySelector ? nav.querySelector('.app-sidebar__brand') : null;
+    if (!plate && brand && brand.parentNode) {
+      plate = document.createElement('div');
+      plate.id = 'craft-plate';
+      plate.className = 'craft-plate';
+      plate.setAttribute('data-plate', mode);
+      plate.setAttribute('aria-hidden', 'true');
+      plate.innerHTML = artHtml(mode);
+      brand.parentNode.insertBefore(plate, brand.nextSibling);
+    }
+    var mark = document.getElementById('craft-eyebrow');
+    if (!look) { remove(mark); return; }
+    var title = document.getElementById('topbar-title');
+    if (!mark && title && title.parentNode) {
+      mark = document.createElement('span');
+      mark.id = 'craft-eyebrow';
+      mark.className = 'craft-eyebrow';
+      title.parentNode.insertBefore(mark, title.nextSibling);
+    }
+    if (mark) mark.textContent = look;
+  }
   // sessionStorage: this session's mode, or that the picker was already shown.
   var MODE_KEY = 'hall-craft';
   var ASKED_KEY = 'hall-craft-asked';
@@ -138,6 +173,7 @@
     var sw = document.getElementById('craft-switch');
     if (sw) sw.classList.toggle('craft-switch--unset', !mode);
     applyNav();
+    applyLook(mode);
     try { document.dispatchEvent(new CustomEvent('otb:craft', { detail: { mode: mode } })); } catch (_) { /* old engine */ }
   }
 
@@ -344,6 +380,8 @@
     ALWAYS_TABS: ALWAYS_TABS.slice(),
     tabsFor: tabsFor,
     applyNav: applyNav,
+    LOOKS: LOOKS,
+    artHtml: artHtml,
     switchHtml: switchHtml,
     mount: mount,
     onAccess: onAccess,

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

@@ -74,9 +74,9 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-03-nav"></script>
-<script src="/builders/craft-mode.js?v=2026-10-03-nav"></script>
-<script src="/builders/shell.js?v=2026-10-03-nav"></script>
+<script src="/builders/shell-trail.js?v=2026-10-03-looks"></script>
+<script src="/builders/craft-mode.js?v=2026-10-03-looks"></script>
+<script src="/builders/shell.js?v=2026-10-03-looks"></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,9 +97,9 @@
 
 <!-- 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-trail.js?v=2026-10-03-nav"></script>
-<script src="/builders/craft-mode.js?v=2026-10-03-nav"></script>
-<script src="/builders/shell.js?v=2026-10-03-nav"></script>
+<script src="/builders/shell-trail.js?v=2026-10-03-looks"></script>
+<script src="/builders/craft-mode.js?v=2026-10-03-looks"></script>
+<script src="/builders/shell.js?v=2026-10-03-looks"></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,9 +98,9 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-03-nav"></script>
-<script src="/builders/craft-mode.js?v=2026-10-03-nav"></script>
-<script src="/builders/shell.js?v=2026-10-03-nav"></script>
+<script src="/builders/shell-trail.js?v=2026-10-03-looks"></script>
+<script src="/builders/craft-mode.js?v=2026-10-03-looks"></script>
+<script src="/builders/shell.js?v=2026-10-03-looks"></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,9 +54,9 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-03-nav"></script>
-<script src="/builders/craft-mode.js?v=2026-10-03-nav"></script>
-<script src="/builders/shell.js?v=2026-10-03-nav"></script>
+<script src="/builders/shell-trail.js?v=2026-10-03-looks"></script>
+<script src="/builders/craft-mode.js?v=2026-10-03-looks"></script>
+<script src="/builders/shell.js?v=2026-10-03-looks"></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,9 +77,9 @@
 <div id="gate-modal-root"></div>
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-03-nav"></script>
-<script src="/builders/craft-mode.js?v=2026-10-03-nav"></script>
-<script src="/builders/shell.js?v=2026-10-03-nav"></script>
+<script src="/builders/shell-trail.js?v=2026-10-03-looks"></script>
+<script src="/builders/craft-mode.js?v=2026-10-03-looks"></script>
+<script src="/builders/shell.js?v=2026-10-03-looks"></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,9 +137,9 @@
   </div>
 </div>
 
-<script src="/builders/shell-trail.js?v=2026-10-03-nav"></script>
-<script src="/builders/craft-mode.js?v=2026-10-03-nav"></script>
-<script src="/builders/shell.js?v=2026-10-03-nav"></script>
+<script src="/builders/shell-trail.js?v=2026-10-03-looks"></script>
+<script src="/builders/craft-mode.js?v=2026-10-03-looks"></script>
+<script src="/builders/shell.js?v=2026-10-03-looks"></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,9 +230,9 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-03-nav"></script>
-<script src="/builders/craft-mode.js?v=2026-10-03-nav"></script>
-<script src="/builders/shell.js?v=2026-10-03-nav"></script>
+<script src="/builders/shell-trail.js?v=2026-10-03-looks"></script>
+<script src="/builders/craft-mode.js?v=2026-10-03-looks"></script>
+<script src="/builders/shell.js?v=2026-10-03-looks"></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,9 +134,9 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-03-nav"></script>
-<script src="/builders/craft-mode.js?v=2026-10-03-nav"></script>
-<script src="/builders/shell.js?v=2026-10-03-nav"></script>
+<script src="/builders/shell-trail.js?v=2026-10-03-looks"></script>
+<script src="/builders/craft-mode.js?v=2026-10-03-looks"></script>
+<script src="/builders/shell.js?v=2026-10-03-looks"></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

@@ -50,9 +50,9 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-03-nav"></script>
-<script src="/builders/craft-mode.js?v=2026-10-03-nav"></script>
-<script src="/builders/shell.js?v=2026-10-03-nav"></script>
+<script src="/builders/shell-trail.js?v=2026-10-03-looks"></script>
+<script src="/builders/craft-mode.js?v=2026-10-03-looks"></script>
+<script src="/builders/shell.js?v=2026-10-03-looks"></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