@bongos/core 1.21.141 → 1.21.142

package/modules/copy-desk/page-status.js

@@ -271,9 +271,57 @@ function orderedSurfaces(inventory) {
   return ids.map((id, i) => ({ id, i })).sort((a, b) => rank(a.id) - rank(b.id) || a.i - b.i).map((x) => x.id);
 }
 
+// ---------------------------------------------------------------------------
+// Pages in flight (task 1004662). The status label counts SHIPPED rounds only,
+// so a page submitted weeks ago still read "Untweaked" and the Approval queue
+// (applied rounds only) stayed empty: the artist's finished work looked lost.
+// This is every page with an open round, where it is, since when (the round's
+// last update), and whether it has sat there too long. Waiting for review is
+// the artist's own move and a draft is theirs to finish, so neither is stuck;
+// a state the reads cannot name always needs a look.
+// ---------------------------------------------------------------------------
+
+const DAY_MS = 24 * 60 * 60 * 1000;
+const IN_FLIGHT = Object.freeze({
+  draft: { word: 'Being written', stuck_after: null },
+  writing: { word: 'Being written', stuck_after: null },
+  submitted: { word: 'Submitted, waiting to be applied', stuck_after: 3 * DAY_MS },
+  applying: { word: 'Being applied', stuck_after: DAY_MS },
+  waiting_for_artist: { word: 'Waiting for your review', stuck_after: null },
+  landing: { word: 'Approved, going live', stuck_after: DAY_MS },
+  unknown: { word: 'Needs a look', stuck_after: 0 },
+});
+const IN_FLIGHT_ORDER = ['unknown', 'landing', 'applying', 'submitted', 'waiting_for_artist', 'writing', 'draft'];
+
+function inFlightFor(list, byPage, nowMs) {
+  const out = [];
+  for (const p of list) {
+    const o = p.open_round;
+    if (!o) continue;
+    const rounds = byPage.get(p.id) || [];
+    const r = rounds.find((x) => String(x.id) === o.task_id) || {};
+    const kind = IN_FLIGHT[o.state] || IN_FLIGHT.unknown;
+    const since = iso(r.updated_at || r.created_at);
+    const age = since ? nowMs - Date.parse(since) : null;
+    out.push({
+      page_id: p.id,
+      title: p.title,
+      surface: p.surface,
+      task_id: o.task_id,
+      state: o.state,
+      state_word: kind.word,
+      since,
+      stuck: kind.stuck_after != null && (kind.stuck_after === 0 || (age != null && age > kind.stuck_after)),
+      holder: o.holder,
+    });
+  }
+  const rank = (s) => { const i = IN_FLIGHT_ORDER.indexOf(s); return i === -1 ? 0 : i; };
+  return out.sort((a, b) => (b.stuck - a.stuck) || rank(a.state) - rank(b.state) || String(a.since || '').localeCompare(String(b.since || '')));
+}
+
 // GET /copy-desk/pages — every page's status, count and drift, plus the
-// per-surface rollup (Artist Review Status).
-function composePages({ inventory, readings, tasks }) {
+// per-surface rollup (Artist Review Status) and the pages in flight.
+function composePages({ inventory, readings, tasks, now = Date.now() }) {
   const byPage = indexRounds(tasks);
   const readingsOk = !!readings;
   const rIdx = readingIndex(readings);
@@ -289,6 +337,7 @@ function composePages({ inventory, readings, tasks }) {
     pages: list,
     surfaces,
     totals: { tweaked, total: list.length, line: `${tweaked} of ${list.length} pages tweaked` },
+    in_flight: inFlightFor(list, byPage, now instanceof Date ? now.getTime() : Number(now)),
   };
 }
 

package/modules/copy-desk/tests/copy_page_status.mjs

@@ -236,5 +236,42 @@ await test('no payout rows yet (TW13 unbuilt) reads 0 credits, while pages tweak
   assert.deepEqual([carol.credits, carol.this_week, carol.pages_tweaked], [0, 0, 0], 'an abandoned round is not a page tweaked');
 });
 
+// Pages in flight (task 1004662): the live case. Submitted rounds never
+// applied and approved rounds stuck before landing read "Untweaked" and never
+// reach the Approval queue, so the list is the only place they show.
+await test('in_flight: every open round, its plain state, how long, and stuck when it has sat too long', () => {
+  const NOW = new Date('2026-10-16T12:00:00.000Z');
+  const ago = (d) => new Date(NOW.getTime() - d * 86400000).toISOString();
+  const pg = (id) => ({ id, surface: id.split(':')[0], title: id, path: '/', files: [] });
+  const ids = ['landing:a', 'landing:b', 'landing:c', 'builders:d', 'builders:e', 'builders:f', 'builders:g', 'status:h'];
+  const inventory = { surfaces: [{ id: 'landing' }, { id: 'builders' }, { id: 'status' }], pages: ids.map(pg) };
+  const batch = (id) => pages.composeBatchBlock({ page_id: id, reading_hash: 'h', submitted_at: ago(9), lines: [] });
+  const round = (n, id, extra) => ({ id: String(n), source: 'page-tweak', source_ref: pages.roundSourceRef(id, 1), description: pages.roundTaskBody(pg(id), 1), ...extra });
+  const tasks = [
+    round(1, 'landing:a', { status: 'ready', description: `${pages.roundTaskBody(pg('landing:a'), 1)}\n\n${batch('landing:a')}`, updated_at: ago(9) }),
+    round(2, 'landing:b', { status: 'ready', description: `${pages.roundTaskBody(pg('landing:b'), 1)}\n\n${batch('landing:b')}`, updated_at: ago(1) }),
+    round(3, 'landing:c', { status: 'confirmed', updated_at: ago(17) }),
+    round(4, 'builders:d', { status: 'completed', grade_passed: true, updated_at: ago(20) }),
+    round(5, 'builders:e', { status: 'active', holder_id: '7', holder_login: 'me', holder_worktree: false, updated_at: ago(30) }),
+    round(6, 'builders:f', { status: 'ready', updated_at: ago(0.2) }),
+    round(7, 'builders:g', { status: 'shipped', shipped_at: ago(3), updated_at: ago(3) }),
+    round(8, 'status:h', { status: 'active', holder_id: '8', holder_worktree: true, updated_at: ago(2) }),
+  ];
+  const out = status.composePages({ inventory, readings: null, tasks, now: NOW });
+  assert.deepEqual(out.in_flight.map((f) => [f.page_id, f.state, f.state_word, f.stuck]), [
+    ['builders:f', 'unknown', 'Needs a look', true],
+    ['landing:c', 'landing', 'Approved, going live', true],
+    ['status:h', 'applying', 'Being applied', true],
+    ['landing:a', 'submitted', 'Submitted, waiting to be applied', true],
+    ['landing:b', 'submitted', 'Submitted, waiting to be applied', false],
+    ['builders:d', 'waiting_for_artist', 'Waiting for your review', false],
+    ['builders:e', 'writing', 'Being written', false],
+  ], 'a shipped round is not in flight; waiting for review and writing are never stuck');
+  assert.equal(out.in_flight[1].since, ago(17));
+  assert.equal(out.in_flight[1].task_id, '3');
+  assert.equal(out.pages.find((p) => p.id === 'landing:a').status_label, 'Untweaked', 'the status still counts only what shipped');
+  assert.deepEqual(status.composePages({ inventory, readings: null, tasks: [], now: NOW }).in_flight, []);
+});
+
 console.log(`\n${passed} passed, ${failed} failed`);
 process.exit(failed ? 1 : 0);

package/modules/government/db.js

@@ -866,6 +866,12 @@ async function applyLeadAct({ itemId, action }) {
     return { done: true, lead, ended };
   } catch (err) {
     await client.query('ROLLBACK').catch(() => {});
+    // Two appointments to an unseated building passed at once (task 1004724):
+    // both saw no Lead, and the one-Lead-in-office index refused the second.
+    // That is a refusal to say plainly, not a database error.
+    if (err && err.code === '23505' && err.constraint === 'government_leads_in_office_uniq') {
+      return { done: false, reason: 'lead_seated_meanwhile', what_this_means: 'Another appointment to this building landed first, so this one changed nothing. Propose again to replace that Lead.' };
+    }
     throw err;
   } finally {
     client.release();

package/modules/government/decision-board.js

@@ -394,7 +394,8 @@ async function openMatter({ area, title, detailMd = null, action = null, propose
 async function leadMatterRefusal(action) {
   const inOffice = (await db.listLeads()).find((l) => l.building === action.building) || null;
   if (action.type === 'remove_lead') {
-    return inOffice ? null : { ok: false, reason: 'no_lead', area: 'people', building: action.building, what_this_means: `${decisionRules.areaByKey(action.building).name} has no Lead to remove.` };
+    // task 1004724: say what to do next, not only what is missing
+    return inOffice ? null : { ok: false, reason: 'no_lead', area: 'people', building: action.building, what_this_means: `${decisionRules.areaByKey(action.building).name} has no Lead to remove; the owner holds it. To give it one, propose a Lead from its office.` };
   }
   if (!(await db.getActiveBuilder(action.builder_id))) return { ok: false, reason: 'unknown_builder', builder_id: String(action.builder_id) };
   if (inOffice && String(inOffice.builder_id) === String(action.builder_id) && inOffice.charter === action.charter) {

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

@@ -237,7 +237,10 @@
   // Charter, the tallest, takes the back corner and rises over the quarter;
   // Planning takes the centre, where nothing in front is tall enough to hide its
   // lit floor (task 1004718: behind the Charter, Planning's floor never showed).
-  const CIVIC_SLOTS = Object.freeze([['charter', 5, 5], ['rules', 7, 5], ['planning', 9, 5], ['people', 5, 7], ['treasury', 7, 7], ['release', 9, 7], ['disputes', 5, 9], ['automation', 7, 9], ['review', 9, 9]]);
+  // Task 1004724 carried the rule to every column: Rules stood behind Release and
+  // People behind Automation, so the taller one in front hid their lit floors; in
+  // each column the taller building now stands at the back.
+  const CIVIC_SLOTS = Object.freeze([['charter', 5, 5], ['release', 7, 5], ['planning', 9, 5], ['automation', 5, 7], ['treasury', 7, 7], ['rules', 9, 7], ['disputes', 5, 9], ['people', 7, 9], ['review', 9, 9]]);
   const ROOF = Object.freeze({ charter: 158, rules: 36, treasury: 66, planning: 51, people: 31, release: 72, disputes: 60, review: 53, automation: 86 });
 
   // The four prototype districts (route = the parcel road it feeds), then the

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

@@ -210,7 +210,7 @@ html[data-fullscreen="on"] .city-top { right: 184px; }
 .city-plaque[hidden] { display: none; }
 .city-plaque__tile { display: inline-flex; align-items: baseline; gap: 7px; }
 .city-plaque__figure { font-size: 22px; font-weight: 300; letter-spacing: -0.03em; line-height: 1.1; font-variant-numeric: tabular-nums; color: var(--ink); }
-.city-plaque__words { font-family: var(--label-face); font-size: 11px; letter-spacing: .12em; text-transform: uppercase; color: var(--ink-faint); }
+.city-plaque__words { font-family: var(--font-body); font-size: 11px; letter-spacing: .12em; text-transform: uppercase; color: var(--ink-faint); }
 .city-plaque__tile[data-key="you"] .city-plaque__figure { color: var(--accent-deep); }
 
 /* the card a building opens in place, in the desk line: who, one fact, its count, two doors */

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

@@ -12,9 +12,9 @@
        (tests/hall_tokens.mjs: no hall page hardcodes a web-font stylesheet).
        The prototype carried its own Google Fonts link for the same two faces. -->
   <link rel="stylesheet" href="/builders/style.css?v=2026-07-02-shell1">
-  <link rel="stylesheet" href="/builders/city.css?v=2026-10-13-glass1">
+  <link rel="stylesheet" href="/builders/city.css?v=2026-10-17-tidy">
   <!-- the ask card in the glass language, shared with the street's deck (task 1004702) -->
-  <link rel="stylesheet" href="/builders/street-deck.css?v=2026-10-13-glass1">
+  <link rel="stylesheet" href="/builders/street-deck.css?v=2026-10-17-tidy">
 </head>
 <!-- THE GOVERNOR CITY, HOME (task 1004524, goal 1000125, R02). The home view
      of docs/design/mocks/governor-city/Street.dc.html (homeView and the home
@@ -109,7 +109,7 @@
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/gov-living.js?v=2026-10-09-positions1"></script>
 <script src="/builders/gov-feeds.js?v=2026-10-09-living3"></script>
-<script src="/builders/city-draw.js?v=2026-10-09-living3"></script>
+<script src="/builders/city-draw.js?v=2026-10-17-tidy"></script>
 <!-- a building's card answers its first ask in place through the deck's own
      route (task 1004702): the desk rows (street-desk.js over the street's kit)
      and the deck's card and sender (street-deck.js) -->

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

@@ -67,6 +67,6 @@
 <script src="/builders/dom-utils.js?v=2026-06-14-domutils"></script>
 <script src="/builders/gov-living.js?v=2026-10-10-real1"></script>
 <script src="/builders/gov-positions.js?v=2026-10-09-positions1"></script>
-<script src="/builders/my-agents.js?v=2026-10-10-real1"></script>
+<script src="/builders/my-agents.js?v=2026-10-17-tidy"></script>
 </body>
 </html>

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

@@ -205,11 +205,17 @@
     // setting to your value. Offered only to a builder who may open a board item.
     const canPropose = !!(obj(me.permissions) && me.permissions[PROPOSE_ATOM] === true);
     const habits = [];
-    const proposed = obj(o.proposed) || {};
-    const habit = (key, value, law) => ({
-      key, name: nameFor(key) + ' ' + wordFor(key, value), fact: proposed[key] ? 'proposed' : 'only you, for now',
-      law, lock: { setting: key, value }, proposed: !!proposed[key], item: proposed[key] && proposed[key] !== true ? str(proposed[key]) : null,
-    });
+    // filed this visit (`proposed`, by setting), or already open on the board
+    // (`pending`, setting=value → item, pendingLaws) — so a reload keeps it
+    const filed = obj(o.proposed) || {};
+    const pending = obj(o.pending) || {};
+    const habit = (key, value, law) => {
+      const item = filed[key] || pending[key + '=' + str(value)] || null;
+      return {
+        key, name: nameFor(key) + ' ' + wordFor(key, value), fact: item ? 'proposed' : 'only you, for now',
+        law, lock: { setting: key, value }, proposed: !!item, item: item && item !== true ? str(item) : null,
+      };
+    };
     const held = (key) => !!(byKey[key] && (byKey[key].locked || byKey[key].cappedBy));
     const inter = obj(me.interaction);
     if (inter) {
@@ -271,6 +277,21 @@
 
   // The laws vote a habit files (POST /government/board/laws): one law, locking the
   // setting to the proposer's value.
+  // The habits already up for a vote (task 1004724): every OPEN laws sitting on
+  // the board (GET /government/board/items), as setting=value → its item id, so a
+  // habit proposed before a reload still reads "up for a vote".
+  function pendingLaws(room) {
+    const out = {};
+    arr(obj(room) && room.open).forEach((it) => {
+      const s = obj(it && it.subject);
+      if (!s || s.kind !== 'laws' || it.closed_at) return;
+      arr(obj(s.proposed) && s.proposed.enact).forEach((law) => arr(obj(law) && law.locks).forEach((l) => {
+        if (obj(l) && l.setting != null && Object.prototype.hasOwnProperty.call(l, 'value')) out[str(l.setting) + '=' + str(l.value)] = str(it.id);
+      }));
+    });
+    return out;
+  }
+
   function proposalFor(h, login) {
     return {
       enact: [{ text: h.law, locks: [h.lock] }],
@@ -278,7 +299,7 @@
     };
   }
 
-  const pure = { buildView, writeFor, proposalFor, SETTING, LAW_LINES, GROUPS };
+  const pure = { buildView, writeFor, proposalFor, pendingLaws, SETTING, LAW_LINES, GROUPS };
   root.OTBMyAgents = pure;
   if (typeof module !== 'undefined' && module.exports) { module.exports = pure; return; }
   if (typeof document === 'undefined' || !root.BongosClient) return;
@@ -296,7 +317,7 @@
   const LOCK = '<svg class="ma-lock__icon" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="3.5" y="7" width="9" height="6.5" rx="1.5"/><path d="M5.5 7V5.2a2.5 2.5 0 0 1 5 0V7"/></svg>';
   const TICK = '<svg class="ma-tick" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M3.5 8.5l3 3 6-7"/></svg>';
 
-  const S = { me: null, constitution: null, presets: null, skills: null, specialities: null, preview: null, proposed: {}, switched: {}, adopted: [], skillsOpen: false, readAll: false, view: null };
+  const S = { me: null, constitution: null, presets: null, skills: null, specialities: null, preview: null, proposed: {}, pending: {}, switched: {}, adopted: [], skillsOpen: false, readAll: false, view: null };
 
   function asNow() {
     try { return root.sessionStorage.getItem('hall-as') === 'nobody' || /[?&]as=nobody\b/.test(root.location.search) ? 'nobody' : null; }
@@ -305,7 +326,7 @@
   function view() {
     S.view = buildView({
       me: S.me, constitution: S.constitution, presets: S.presets, skills: S.skills, specialities: S.specialities,
-      preview: S.preview, proposed: S.proposed, switched: S.switched, adopted: S.adopted, as: asNow(), project: PROJECT, now: Date.now(),
+      preview: S.preview, proposed: S.proposed, pending: S.pending, switched: S.switched, adopted: S.adopted, as: asNow(), project: PROJECT, now: Date.now(),
     }, { GovLiving: root.GovLiving, GovPositions: root.GovPositions });
     return S.view;
   }
@@ -560,7 +581,9 @@
       const err = r && r.data && r.data.error;
       const code = err && (err.code || err);
       if (code === 'preset_in_force') { toast('Not filed: ' + p.name + ' is already in force.'); return; }
-      if (code === 'setting_already_locked') { toast('Not filed: a law of the project\'s own already holds ' + str(err.details && err.details.setting || 'that setting') + '. Repeal it first.'); return; }
+      // the setting by its row name, never its key (task 1004724)
+      const held = err.details && err.details.setting ? nameFor(str(err.details.setting)).toLowerCase() : 'that setting';
+      if (code === 'setting_already_locked') { toast('Not filed: a law of the project\'s own already holds ' + held + '. Repeal it first.'); return; }
       toast('Not filed' + (r && r.status ? ' (' + r.status + ')' : '') + '. Nothing changed.');
     }, () => toast('Not filed: no answer.'));
   }
@@ -590,9 +613,11 @@
       return;
     }
     S.me = me;
-    const [constitution, presets, skills, specialities] = await Promise.all([
+    const [constitution, presets, skills, specialities, room] = await Promise.all([
       getJSON('/government/constitution'), getJSON('/government/presets'), getJSON('/me/skill-prefs'), getJSON('/specialities'),
+      getJSON('/government/board/items'),
     ]);
+    S.pending = pendingLaws(room);
     S.presets = presets || null;
     S.constitution = constitution;
     S.skills = skills || null;

package/modules/hall-ui/public/my-agents.states.json

@@ -1,5 +1,5 @@
 {
-  "_": "MY AGENTS (task 1004685, the living-city prototype) through modules/ui-design/kit/render.js. Every row is filled from GET /me and its prefs, so the floors run against the hall-preview harness, which serves those reads and records the pref writes (scripts/hall-preview/pref-writes.js):\n\n  node scripts/hall-preview/server.js --port 4614 --fixture-me --rank archon\n  node modules/ui-design/kit/render.js --states modules/hall-ui/public/my-agents.states.json --base-in http://builders.localhost:4614 --base-out http://builders.localhost:4614\n\nAgainst the kit's own stub the reads 404 and the page shows its sign-in line. The 'nobody' state is the same page as a builder who holds no seat (?as=nobody, read by the prototype only).",
+  "_": "MY AGENTS (task 1004685, the living-city prototype) through modules/ui-design/kit/render.js. Every row is filled from GET /me and its prefs, so the floors run against the hall-preview harness, which serves those reads and records the pref writes (scripts/hall-preview/pref-writes.js):\n\n  node scripts/hall-preview/server.js --port 4614 --fixture-me --rank archon\n  node modules/ui-design/kit/render.js --states modules/hall-ui/public/my-agents.states.json --base-in http://builders.localhost:4614 --base-out http://builders.localhost:4614\n\nAgainst the kit's own stub the reads 404 and the page shows its sign-in line. The 'nobody' state is the same page as a builder who holds no seat (?as=nobody, a stand-in that can only take away, gov-positions.js).",
   "page": "/my-agents",
   "surface": "hall-ui",
   "stub": { "prefix": "/builders/" },

package/modules/hall-ui/public/settings-interaction.js

@@ -31,6 +31,8 @@
   const api = window.BongosClient.createClient({ baseUrl: '', credentials: 'same-origin', throwOnError: false });
 
   const toAuth = () => window.location.assign(`${API}/auth/web/start`);
+  // the project's laws on these fields (task 1004724): settings-law-locks.js
+  const Laws = window.OTBSettingsLaws || { lockFor: () => null, allows: () => true, lawLine: () => '', tagFor: () => '' };
 
   function render(data) {
     const wrap = $('#interaction-rows');
@@ -45,17 +47,19 @@
     // name — four independent single-selects, not one flat list of radios.
     wrap.innerHTML = fields.map((f) => {
       const chosenValue = eff[f.field];
+      const lock = Laws.lockFor(data, f.field);
       const rows = (f.values || []).map((v) => {
         const id = `interaction-${f.field}-${v.value}`;
         const chosen = v.value === chosenValue;
+        const barred = !Laws.allows(lock, v.value);
         // No "default" tag here, deliberately: interaction-prefs.js already ends
         // every default value's LABEL with "(default)", so adding the row tag the
         // wandering picker uses rendered "Non-technical (default) · DEFAULT".
         // One source for the word, and it is the label the API already ships.
         return (
-          `<label class="prow prow--pick" for="${id}">` +
+          `<label class="prow prow--pick" for="${id}"${barred ? ' aria-disabled="true"' : ''}>` +
           `<input class="pradio" type="radio" name="interaction-${escapeHtml(f.field)}" id="${id}"` +
-          ` value="${escapeHtml(v.value)}" data-field="${escapeHtml(f.field)}"${chosen ? ' checked' : ''}>` +
+          ` value="${escapeHtml(v.value)}" data-field="${escapeHtml(f.field)}"${chosen ? ' checked' : ''}${barred ? ' disabled' : ''}>` +
           '<span class="prow__main">' +
           `<span class="prow__label">${escapeHtml(v.label)}</span>` +
           '</span></label>'
@@ -65,6 +69,7 @@
         `<fieldset class="pgroup" id="interaction-field-${escapeHtml(f.field)}">` +
         `<legend class="prow__label">${escapeHtml(f.label)}</legend>` +
         `<p class="prow__desc">${escapeHtml(f.blurb || '')}</p>` +
+        (lock ? `<p class="prow__desc prow__law" data-law="${escapeHtml(String(lock.law_no || ''))}">${escapeHtml(Laws.lawLine(lock))}</p>` : '') +
         rows +
         '</fieldset>'
       );

package/modules/hall-ui/public/settings-law-locks.js

@@ -0,0 +1,53 @@
+// modules/hall-ui/public/settings-law-locks.js — the project's LAWS on the
+// /builders/settings rows (task 1004724).
+//
+// A law passed by the project's government may lock a personal setting: FIX it
+// to one value, or CAP it. The server enforces the lock (law-locks.js, task
+// 1004707) and every settings read already reports it as `law_locks` — this file
+// is only how the page SAYS so: a value the lock does not allow is a disabled
+// row tagged with the law, and the setting carries one line naming the law.
+// Shared by the "How Claude talks to you" panel (settings-interaction.js) and the
+// wandering picker (settings.js). The page decides nothing; a write the law
+// forbids is refused by the route either way (409 locked_by_law).
+//
+// PURE: no DOM, no fetch. tests/settings_law_locks.mjs requires it in node.
+
+(function (root) {
+  'use strict';
+
+  const str = (v) => (v == null ? '' : String(v));
+
+  // The lock a law puts on `setting`, from a settings read's `law_locks`, or null.
+  // Only an ENFORCED lock counts: one naming no real value locks nothing.
+  function lockFor(data, setting) {
+    const locks = data && Array.isArray(data.law_locks) ? data.law_locks : [];
+    return locks.find((l) => l && l.enforced === true && str(l.setting) === str(setting)) || null;
+  }
+
+  // May `value` still be picked under `lock`? No lock: yes.
+  function allows(lock, value) {
+    if (!lock) return true;
+    if (!Array.isArray(lock.allowed)) return true;
+    return lock.allowed.map(str).includes(str(value));
+  }
+
+  // The one line the setting carries: which law, and what it does to the row.
+  function lawLine(lock) {
+    if (!lock) return '';
+    const n = lock.law_no != null ? 'Law ' + str(lock.law_no) : 'A law';
+    const text = str(lock.law_text).trim();
+    const what = Object.prototype.hasOwnProperty.call(lock, 'value')
+      ? ' sets this for every agent in the project'
+      : ' caps this for every agent in the project';
+    return n + what + (text ? ': "' + text + '".' : '.') + ' Only a vote can change it.';
+  }
+
+  // The tag a row the lock rules out wears.
+  function tagFor(lock) {
+    return lock ? 'set by ' + (lock.law_no != null ? 'law ' + str(lock.law_no) : 'a law') : '';
+  }
+
+  const api = { lockFor, allows, lawLine, tagFor };
+  root.OTBSettingsLaws = api;
+  if (typeof module !== 'undefined' && module.exports) module.exports = api;
+}(typeof window !== 'undefined' ? window : globalThis));

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

@@ -482,7 +482,8 @@
 <!-- shared record overlay (#/idea|blocker/N) — every hall page carries it; this
      page was the one gap (task 2172). -->
 <script src="/builders/task-detail.js?v=2026-07-03-taskdetail"></script>
-<script src="/builders/settings.js?v=2026-09-26-update"></script>
+<script src="/builders/settings-law-locks.js?v=2026-10-17-laws"></script>
+<script src="/builders/settings.js?v=2026-10-17-laws"></script>
 <!-- task 1003341: the Active sessions panel. Its own file rather than more of
      settings.js, which sits close to the 1500-line size ratchet. -->
 <script src="/builders/settings-sessions.js?v=2026-08-29-sessions"></script>
@@ -490,7 +491,7 @@
 <!-- task 1002514: the interaction-profile panel ("How Claude talks to you"), on
      the same precedent and for the same reason — settings.js is against the
      1500-line ratchet, and this panel shares nothing with the rest of the page. -->
-<script src="/builders/settings-interaction.js?v=2026-09-15-interaction"></script>
+<script src="/builders/settings-interaction.js?v=2026-10-17-laws"></script>
 <script src="/builders/settings-specialities.js?v=2026-09-17-specialities"></script>
 <!-- task 1002518: the card-richness ladder. Own file on the same precedent —
      the panel grew from one switch to a rung picker with a derived default, and

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

@@ -413,12 +413,17 @@
     // One pick among four: a radio row per level (panel.css `.prow--pick`), the
     // whole row its label. A level above the rank ceiling is a disabled radio
     // that says so in the label voice rather than a dead "Rank-locked" button.
+    // a project law may fix or cap the level too (task 1004724, settings-law-locks.js)
+    const Laws = window.OTBSettingsLaws || null;
+    const lawLock = Laws ? Laws.lockFor(data, 'wandering') : null;
     wrap.innerHTML = levels.map((lv) => {
       const chosen = lv.n === eff;
-      const locked = !lv.allowed;
+      const byLaw = lv.allowed && !!lawLock && !Laws.allows(lawLock, lv.key);
+      const locked = !lv.allowed || byLaw;
       const id = `wander-${lv.n}`;
       const tags = (lv.n === def ? '<span class="prow__tag">default for your rank</span>' : '') +
-        (locked ? '<span class="prow__tag">rank-locked</span>' : '');
+        (!lv.allowed ? '<span class="prow__tag">rank-locked</span>' : '') +
+        (byLaw ? `<span class="prow__tag">${escapeHtml(Laws.tagFor(lawLock))}</span>` : '');
       return (
         `<label class="prow prow--pick" for="${id}" data-level="${lv.n}"${locked ? ' aria-disabled="true"' : ''}>` +
         `<input class="pradio" type="radio" name="wandering" id="${id}" value="${lv.n}"` +
@@ -431,9 +436,9 @@
     }).join('');
     const note = $('#wandering-note');
     if (note) {
-      note.textContent = (data && data.effective_label && data.max_key)
+      note.textContent = ((data && data.effective_label && data.max_key)
         ? `Now: ${data.effective_label}. Your rank allows up to ${data.max_key}.`
-        : '';
+        : '') + (lawLock ? ' ' + Laws.lawLine(lawLock) : '');
     }
   }
 

package/modules/hall-ui/public/street-deck.css

@@ -248,6 +248,10 @@ body[data-page="street"] .street-card { background: var(--gov-glass); border: 1p
 .office .desk-name__f { white-space: nowrap; }
 .govx-capsule { height: auto; min-height: 44px; padding: 6px 14px; display: inline-flex; flex-direction: column; align-items: flex-start; justify-content: center; gap: 1px; }
 .govx-capsule__how { font-size: 11px; font-weight: 400; color: var(--ink-faint); letter-spacing: 0.04em; }
+/* who should lead (task 1004724): one pick, one chip */
+.govx-appoint__who { min-height: 44px; max-width: 100%; min-width: 0; padding: 0 12px; border-radius: 999px; border: 1px solid var(--street-rule-strong); background: var(--bg); color: var(--ink); font: inherit; font-size: 14px; }
+.govx-appoint__who:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
+.govx-appoint__f { font-size: 13px; color: var(--ink-soft); }
 .govx-pic { margin: 0; display: flex; flex-direction: column; gap: 4px; padding: 6px 0 2px; border-top: 1px solid var(--street-rule); border-bottom: 1px solid var(--street-rule); }
 .govx-pic svg { display: block; max-width: 100%; }
 .govx-pic__cap { font-size: 12px; color: var(--ink-faint); }

package/modules/hall-ui/public/street-office.js

@@ -260,6 +260,32 @@
     };
   }
 
+  // ---------- who should lead (task 1004724) ----------
+  // The office's "who should lead": any builder who may open a board item (the
+  // perm /me reports) may propose one of the project's active people as the
+  // building's Lead. A proposal is the existing appoint_lead People matter (POST
+  // /government/board/matters); only its sitting passing seats anyone, and the
+  // server checks the perm, the person and the building again. null: not offered.
+  function appointPlan(living, key, roster, me, os) {
+    const off = officeOf(living, key);
+    const perms = me && me.permissions;
+    if (!off || !(perms && perms['board.item.open'] === true)) return null;
+    const leadId = off.lead ? off.lead.id : null;
+    const people = (roster && Array.isArray(roster.builders) ? roster.builders : [])
+      .filter((b) => b && b.id != null && (b.status == null || b.status === 'active') && str(b.id) !== leadId)
+      .map((b) => ({ id: str(b.id), name: str(b.display_name || b.github_login) }))
+      .filter((p) => p.name)
+      .sort((a, z) => a.name.localeCompare(z.name));
+    if (!people.length) return null;
+    return { building: key, name: off.name, seated: off.seated, people: people, filed: !!(os && os.leadFiled && os.leadFiled[key]) };
+  }
+  // The body of POST /government/board/matters for one proposed Lead, or null.
+  function appointBody(plan, personId) {
+    const p = plan ? plan.people.find((x) => x.id === str(personId)) : null;
+    if (!p) return null;
+    return { area: 'people', title: 'Appoint ' + p.name + ' as Lead of ' + plan.name, action: { type: 'appoint_lead', building: plan.building, builder_id: Number(p.id) } };
+  }
+
   // ---------- how strict ----------
   // GET /government/presets (task 1004715): the preset is the one the laws in
   // force amount to (none: "No preset yet"), each carries the locks a switch to
@@ -281,6 +307,7 @@
     officeOf: officeOf, worksOf: worksOf, builtFloors: builtFloors, buildPlan: buildPlan, buildsAlone: buildsAlone,
     isoPicture: isoPicture, lawBook: lawBook, injection: injection,
     treasury: treasury, strictness: strictness, usd: usd, dayWords: dayWords,
+    appointPlan: appointPlan, appointBody: appointBody,
   };
 
   // =====================================================================
@@ -292,6 +319,9 @@
   const page = (function () {
     let env = null, doc = null;
     const os = blank();
+    // the Lead appointments this visit filed, by building (task 1004724); the
+    // vote itself is the server's, on the docket
+    const leadsFiled = {};
     const deckPage = () => (root.GovDeck ? root.GovDeck.page : null);
     const living = () => { const p = deckPage(); return p ? p.living() : null; };
     const viewerId = () => { const d = env ? env.data() : null; return d && d.docket && d.docket.viewer ? str(d.docket.viewer.id) : null; };
@@ -575,6 +605,10 @@
       off.rooms.forEach((r) => row(r.name, r.proposed ? 'proposed · a vote is open' : r.line));
       worksOf(lv, key).forEach((w) => row(w.label, w.line));
       if (rows.children && rows.children.length) el.appendChild(rows);
+      // who should lead: propose a Lead, filed as a People vote (task 1004724)
+      const fd = deckPage() ? deckPage().feeds() : {};
+      const ap = appointPlan(lv, key, fd.roster, fd.me, { leadFiled: leadsFiled });
+      if (ap) el.appendChild(appointEl(ap));
       // build out: a capsule each, one tap. Only the building's holder sees them
       // (GET /government/leads answers; the server holds the same wall).
       if (off.holders && off.holders.includes(str(viewerId()))) {
@@ -597,6 +631,31 @@
         if (c.capsule && c.ask_id) { const card = askHere(c.ask_id, { building: key, change: c.capsule }); if (card) el.appendChild(card); }
       });
     }
+    function appointEl(ap) {
+      const g = h('div', 'govx-build govx-appoint');
+      g.setAttribute('role', 'group');
+      g.setAttribute('aria-label', 'who should lead');
+      g.appendChild(h('span', 'desk-choices__ask', 'who should lead'));
+      if (ap.filed) { g.appendChild(h('span', 'govx-appoint__f', 'proposed · a vote is open')); return g; }
+      const sel = h('select', 'govx-appoint__who');
+      sel.setAttribute('aria-label', 'who should lead ' + ap.name);
+      ap.people.forEach((p) => { const o = h('option', '', p.name); o.setAttribute('value', p.id); sel.appendChild(o); });
+      g.appendChild(sel);
+      g.appendChild(chip('desk-chip--choice', ap.seated ? 'propose instead' : 'put it to a vote', () => appoint(ap, sel.value)));
+      return g;
+    }
+    // One matter, one place (task 1004724): a book's in-place ask card steps
+    // aside when the floor desk below already holds that matter as a row, which
+    // acts in place too — the treasury's dry pot used to show twice.
+    function settle(govt, on) {
+      if (!govt || !on || !govt.querySelectorAll || !on.querySelector) return 0;
+      let n = 0;
+      Array.prototype.slice.call(govt.querySelectorAll('[data-ask]')).forEach((card) => {
+        const id = str(card.getAttribute('data-ask')).replace(/["\\]/g, '');
+        if (id && on.querySelector('[data-row="' + id + '"]') && card.parentNode) { card.parentNode.removeChild(card); n++; }
+      });
+      return n;
+    }
     // the live site over the drawing: a tower crane over a floor going up
     function crane(bv) {
       const layer = doc.getElementById('insideFloors');
@@ -649,6 +708,19 @@
       });
     }
     // a switch of preset (task 1004715): ONE laws vote, filed through the board
+    function appoint(ap, personId) {
+      const body = appointBody(ap, personId);
+      if (!body || !env || !env.send) return Promise.resolve();
+      return env.send({ method: 'POST', url: '/api/bongos/government/board/matters', body: body }).then((out) => {
+        if (preview(out)) { env.say('This preview stores nothing; no vote was filed.', true); return; }
+        if (!out.ok) { env.say(refusal(out), true); return; }
+        leadsFiled[ap.building] = true;
+        env.say('Put to a vote. Nobody leads ' + ap.name + ' until the vote passes.', true);
+        if (root.GovFeeds && typeof root.GovFeeds.refresh === 'function') root.GovFeeds.refresh(['docket', 'leads']);
+        if (env.load) env.load();
+        env.draw();
+      });
+    }
     function switchPreset(to) {
       const st = strictness(living(), os);
       if (!st || !env.send) return Promise.resolve();
@@ -696,7 +768,7 @@
       p.onChange(() => { if (env && env.inside && env.inside()) env.draw(); });
     }
 
-    return { mount: mount, input: input, inside: inside, buildOut: buildOut, switchPreset: switchPreset, state: os };
+    return { mount: mount, input: input, inside: inside, settle: settle, buildOut: buildOut, appoint: appoint, switchPreset: switchPreset, state: os };
   }());
 
   const api = Object.assign({ page: page }, model);

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

@@ -13,7 +13,7 @@
   <link rel="stylesheet" href="/builders/style.css?v=2026-07-02-shell1">
   <link rel="stylesheet" href="/builders/street.css?v=2026-10-09-living3">
   <link rel="stylesheet" href="/builders/street-card.css?v=2026-10-04-record1">
-  <link rel="stylesheet" href="/builders/street-deck.css?v=2026-10-13-glass1">
+  <link rel="stylesheet" href="/builders/street-deck.css?v=2026-10-17-tidy">
 </head>
 <!-- THE STREET (task 1004525, goal 1000125, R03). The street view of
      docs/design/mocks/governor-city/Street.dc.html (renderVals' street branch,
@@ -234,7 +234,7 @@
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/gov-living.js?v=2026-10-09-positions1"></script>
 <script src="/builders/gov-feeds.js?v=2026-10-09-living3"></script>
-<script src="/builders/city-draw.js?v=2026-10-09-living3"></script>
+<script src="/builders/city-draw.js?v=2026-10-17-tidy"></script>
 <script src="/builders/street-draw.js?v=2026-10-09-living3"></script>
 <script src="/builders/street-card.js?v=2026-10-04-record1"></script>
 <script src="/builders/street-inside.js?v=2026-10-09-living3"></script>
@@ -242,7 +242,7 @@
 <script src="/builders/street-desk.js?v=2026-10-04-record1"></script>
 <script src="/builders/street-amend.js?v=2026-10-02-amend1"></script>
 <script src="/builders/street-deck.js?v=2026-10-13-glass1"></script>
-<script src="/builders/street-office.js?v=2026-10-09-living3"></script>
-<script src="/builders/street.js?v=2026-10-13-glass1"></script>
+<script src="/builders/street-office.js?v=2026-10-17-tidy"></script>
+<script src="/builders/street.js?v=2026-10-17-tidy"></script>
 </body>
 </html>

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

@@ -516,7 +516,10 @@
     // the chosen floor: two blocks that take turns, so the block re-enters on every pick
     var on = $(bv.flipA ? 'insideOpenA' : 'insideOpenB'), off = $(bv.flipA ? 'insideOpenB' : 'insideOpenA');
     if (off) { off.hidden = true; clear(off); }
-    if (on) { on.hidden = false; if (!(OP && OP.inside(bv, on, $('insideGovt')))) fillDesk(on, bv); }
+    if (on) {
+      on.hidden = false;
+      if (!(OP && OP.inside(bv, on, $('insideGovt')))) { fillDesk(on, bv); if (OP && OP.settle) OP.settle($('insideGovt'), on); }
+    }
     setText('insideOnFile', bv.onFile);
     var drawers = $('insideDrawers'); clear(drawers);
     bv.drawers.forEach(function (dw) {