@bongos/core 1.21.140 → 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/goals.js

@@ -30,6 +30,16 @@
     return res.data;
   }
 
+  const isOpenGoal = (g) => !!g && g.status === 'open';
+
+  // goal id -> how many claimable tasks it holds. The server counts (?group=goal
+  // returns counts and no rows), so this card never downloads the feed itself.
+  function claimableByGoal(byGoal) {
+    const counts = new Map();
+    for (const [k, n] of Object.entries(byGoal || {})) counts.set(String(k), Number(n) || 0);
+    return counts;
+  }
+
   let host = null;
   let myId = null;
   const sameId = (a, b) => a != null && b != null && String(a) === String(b);
@@ -55,7 +65,14 @@
     return `<span class="goal-badge ${cls}">${escapeHtml(status)}</span>`;
   }
 
-  function row(detail) {
+  // task 1004755: the claimable count rides under each open goal, so the card
+  // leads with the builder's open goals and shows the work waiting in each.
+  function claimableLine(n) {
+    if (!n) return '<span class="goal-mine__work card-foot">Nothing claimable right now</span>';
+    return `<span class="goal-mine__work card-foot">${n} task${n === 1 ? '' : 's'} you can claim</span>`;
+  }
+
+  function row(detail, counts) {
     const g = detail.goal;
     const crit = Array.isArray(detail.criteria) ? detail.criteria : [];
     const sat = crit.filter((c) => c.satisfied).length;
@@ -68,7 +85,7 @@
         <a class="goal-mine__link" href="${href}" title="Open ${escapeHtml(g.title || 'goal')}"
            style="flex:1;display:flex;align-items:center;gap:12px;min-width:0;color:inherit;text-decoration:none;">
           <span class="goal-mine__ring">${ring(sat, crit.length, achieved)}</span>
-          <span class="goal-mine__title">${escapeHtml(g.title || 'Untitled goal')}</span>
+          <span class="goal-mine__title" style="display:flex;flex-direction:column;min-width:0;">${escapeHtml(g.title || 'Untitled goal')}${claimableLine((counts && counts.get(String(g.id))) || 0)}</span>
           <span class="goal-mine__meta"><span class="goal-mine__ver">${escapeHtml(g.version_id || '')}</span>${statusBadge(g.status)}</span>
         </a>
       </li>`;
@@ -77,21 +94,21 @@
   // task 2184 (Home rule: a summary card never lists more than 5 rows): cap the
   // joined-goals list; the overflow count rides the "All goals" foot link.
   const MAX_HOME_ROWS = 5;
-  function render(joined) {
+  function render(joined, counts) {
     const body = host.querySelector('#goals-body');
     if (!joined.length) {
-      body.innerHTML = '<p class="goal-empty">You haven’t joined any goals yet. <a href="/goals">Browse goals →</a></p>';
+      body.innerHTML = '<p class="goal-empty">You haven’t joined any open goals. <a href="/goals">Browse goals →</a></p>';
       return;
     }
     const shown = joined.slice(0, MAX_HOME_ROWS);
     const more = joined.length - shown.length;
-    body.innerHTML = `<ul class="goal-mine-list">${shown.map(row).join('')}</ul>` +
+    body.innerHTML = `<ul class="goal-mine-list">${shown.map((d) => row(d, counts)).join('')}</ul>` +
       `<p class="goal-mine__foot card-foot"><a href="/goals">${more > 0 ? `All ${joined.length} goals →` : 'All goals →'}</a></p>`;
   }
 
   const SKELETON =
     '<h2 id="goals-h" class="scroll__h">Goals</h2>' +
-    '<p class="scroll__lede">The shared goals you’ve joined. Browse, join, and leave goals — and read their criteria — on the <a href="/goals">Goals page</a>.</p>' +
+    '<p class="scroll__lede">The open goals you’ve joined, and the work you can claim in each. Browse, join, and leave goals — and read their criteria — on the <a href="/goals">Goals page</a>.</p>' +
     '<div id="goals-body"><div class="profile__placeholder">Loading your goals…</div></div>';
 
   async function load() {
@@ -107,12 +124,18 @@
       // paint. boot() no longer mounts widgets for a signed-out visitor; this
       // keeps the widget itself harmless if it is ever mounted without a session
       // (an expired cookie mid-visit), where the honest answer is to say nothing.
+      // Started now, awaited after the goal reads, so the two run side by side.
+      const feedP = getJSON(`${API}/tasks/claimable?group=goal`, { softAuth: true }).catch(() => null);
       const gres = await getJSON(`${API}/goals`, { softAuth: true });
-      const candidates = (gres.goals || []).filter((g) => g.status !== 'archived');
+      // task 1004755: OPEN goals only. An achieved goal has no work left in it, and
+      // listing it here (it took slots in the five-row cap) pushed the goals with
+      // work waiting off the card.
+      const candidates = (gres.goals || []).filter(isOpenGoal);
       const details = (await Promise.all(candidates.map((g) =>
         getJSON(`${API}/goals/${encodeURIComponent(g.id)}`).catch(() => null)))).filter(Boolean);
       const joined = details.filter((d) => (d.members || []).some((m) => sameId(m.builder_id, myId)));
-      render(joined);
+      const feed = await feedP;
+      render(joined, claimableByGoal(feed && feed.by_goal));
     } catch (err) {
       const body = host.querySelector('#goals-body');
       // Signed out is not a failure — it is simply nothing to show. Only a real

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); }