@bongos/core 1.24.8 → 1.24.10

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

@@ -0,0 +1,230 @@
+// market-watch-settings.js — the owner's Market Watch settings (task 1004938, goal 1000137),
+// built to docs/design/mocks/market-watch/settings.html, option B, the fuel gauge.
+//
+// One read and three writes, all owner-only on the server (the project.settings.manage atom plus the owner seat):
+//   GET    /market-watch/settings       everything drawn here
+//   PATCH  /market-watch/settings       { enabled } | { monthly_cap_usd } | { cadence }
+//   PUT    /market-watch/settings/key   { key }   (write-only: the answer says set or not set)
+//   DELETE /market-watch/settings/key
+// Every write answers with the whole view, so the page redraws from what the server
+// stored, never from what it asked for.
+//
+// A 403 shows the owner-only panel and a 404 the "module is off" panel, so a refusal is
+// never mistaken for an empty gauge.
+(() => {
+  'use strict';
+
+  const API = '/api/bongos/market-watch/settings';
+  const client = window.BongosClient.createClient({ baseUrl: '', credentials: 'same-origin', throwOnError: false });
+  const { escapeHtml, toast } = window.OTB;
+  const $ = (id) => document.getElementById(id);
+
+  const DAY_MS = 24 * 60 * 60 * 1000;
+  const CADENCE_DAYS = { weekly: 7, biweekly: 14, monthly: 30 };
+  const CADENCE_WORDS = { weekly: 'weekly', biweekly: 'every 2 weeks', monthly: 'monthly' };
+  const REASONS = {
+    cap_reached: 'cap reached',
+    off: 'switched off',
+    no_key: 'no key',
+    spend_unreadable: 'spend unreadable',
+    error: 'error',
+    lease_lost: 'cut off',
+  };
+  const FUTURE = 2; // empty cells after the next run, as the mockup draws them
+
+  let view = null;
+  let busy = false;
+
+  const money = (n) => (Number.isInteger(n) ? `$${n}` : `$${n.toFixed(2)}`);
+  const shortDate = (iso) => {
+    const d = new Date(iso);
+    return `${d.getUTCDate()} ${d.toLocaleString('en-US', { month: 'short', timeZone: 'UTC' }).toLowerCase()}`;
+  };
+  const weekday = (iso) => new Date(iso).toLocaleString('en-US', { weekday: 'long', timeZone: 'UTC' }).toLowerCase();
+
+  function show(id) {
+    for (const s of ['mws-sealed', 'mws-off', 'mws-body']) $(s).hidden = s !== id;
+  }
+  function error(message) {
+    $('mws-error').hidden = !message;
+    $('mws-error').textContent = message || '';
+  }
+
+  async function send(method, body) {
+    let res;
+    try {
+      res = await client.request(method, API + (method === 'PUT' || method === 'DELETE' ? '/key' : ''), body === undefined ? undefined : { body });
+    } catch (_) {
+      return { ok: false, message: 'Could not reach the server.' };
+    }
+    if (res.status === 401) { window.location.assign('/api/bongos/auth/web/start'); return { ok: false }; }
+    if (res.status === 403) { show('mws-sealed'); return { ok: false }; }
+    if (res.status === 404) { show('mws-off'); return { ok: false }; }
+    if (!res.ok) {
+      const err = (res.data && res.data.error) || {};
+      return { ok: false, message: err.message && err.message !== err.code ? err.message : 'That did not save.' };
+    }
+    return { ok: true, data: res.data };
+  }
+
+  // ---- drawing ---------------------------------------------------------------------
+
+  function gauge(v, cap) {
+    const spent = v.spent_this_month_usd;
+    const run = v.run_estimate_usd || 0;
+    const p = Math.min(100, (spent / cap) * 100);
+    const n = Math.max(0, Math.min(100 - p, (run / cap) * 100));
+    $('mws-arc').setAttribute('stroke-dasharray', `${p} 100`);
+    $('mws-arc2').setAttribute('stroke-dasharray', `0 ${p} ${v.enabled ? n : 0} 100`);
+    $('mws-spent').textContent = money(spent);
+    $('mws-of').textContent = `of ${money(cap)} · ${v.month}`;
+    $('mws-ring').classList.toggle('mws-ring--off', !v.enabled);
+    let left;
+    if (!v.enabled) left = 'paused · $0 from now';
+    else if (!run) left = 'no run yet to measure';
+    else {
+      const l = Math.floor(Math.max(0, cap - spent) / run);
+      left = l > 0 ? `${l} run${l > 1 ? 's' : ''} of fuel left` : 'next run will be skipped';
+    }
+    $('mws-left').textContent = left;
+    $('mws-left').classList.toggle('mws-pill--empty', v.enabled && !!run && Math.floor(Math.max(0, cap - spent) / run) <= 0);
+    $('mws-cap-t').textContent = money(cap);
+    $('mws-hint').textContent = run
+      ? `about ${Math.floor(cap / run)} runs a month · a run costs ${v.run_estimate_basis === 'ceiling' ? 'at most' : 'about'} $${run.toFixed(2)}`
+      : 'a run’s cost shows here after the first one';
+  }
+
+  function strip(v) {
+    const ran = v.recent_runs.slice().reverse(); // oldest first, left to right
+    const cells = ran.map((r) => {
+      const skipped = r.status === 'skipped' || r.status === 'failed';
+      const why = REASONS[r.reason] || r.reason || '';
+      const label = skipped
+        ? `${shortDate(r.created_at)}: skipped${why ? `, ${why}` : ''}`
+        : `${shortDate(r.created_at)}: ${r.items_total} names watched${r.status === 'partial' ? `, stopped early${why ? ` (${why})` : ''}` : ''}`;
+      return `<li class="mws-wk ${skipped ? 'mws-wk--skip' : 'mws-wk--done'}" title="${escapeHtml(label)}" aria-label="${escapeHtml(label)}">`
+        + `<b>${skipped ? '—' : escapeHtml(String(r.items_total))}</b><span>${escapeHtml(shortDate(r.created_at))}</span></li>`;
+    });
+    if (v.enabled) {
+      const days = CADENCE_DAYS[v.cadence] || 7;
+      const next = v.next_run.due_at ? new Date(v.next_run.due_at) : new Date();
+      const nextLabel = v.next_run.state === 'soon' ? 'soon' : shortDate(next.toISOString());
+      cells.push(`<li class="mws-wk mws-wk--next" aria-label="next run: ${escapeHtml(nextLabel)}"><b>?</b><span>${escapeHtml(nextLabel)}</span></li>`);
+      for (let i = 1; i <= FUTURE; i += 1) {
+        const d = new Date(next.getTime() + i * days * DAY_MS).toISOString();
+        cells.push(`<li class="mws-wk" aria-hidden="true"><b></b><span>${escapeHtml(shortDate(d))}</span></li>`);
+      }
+    }
+    $('mws-weeks').style.setProperty('--mws-cells', String(Math.max(cells.length, 3)));
+    $('mws-weeks').innerHTML = cells.join('') || '';
+    const reasons = [...new Set(v.recent_runs.filter((r) => r.status === 'skipped' || r.status === 'failed').map((r) => REASONS[r.reason] || r.reason).filter(Boolean))];
+    const legend = [];
+    if (ran.length) legend.push('<span>number = names watched</span>');
+    if (reasons.length) legend.push(`<span class="mws-legend__skip">— = skipped, ${escapeHtml(reasons.join(', '))}</span>`);
+    if (v.enabled) legend.push('<span>dashed = next run</span>');
+    if (!ran.length) legend.unshift('<span>no runs yet</span>');
+    $('mws-legend').innerHTML = legend.join('');
+  }
+
+  function draw(v) {
+    view = v;
+    show('mws-body');
+    error('');
+    const cap = v.monthly_cap_usd;
+    $('mws-power').setAttribute('aria-pressed', String(v.enabled));
+    $('mws-power-t').textContent = v.enabled ? 'Market Watch is on' : 'Market Watch is off';
+    const slider = $('mws-cap');
+    slider.max = String(Math.max(60, Math.ceil(cap / 5) * 5));
+    slider.value = String(cap);
+    slider.setAttribute('aria-valuetext', `${money(cap)} a month`);
+    for (const b of $('mws-cad').querySelectorAll('button')) {
+      const on = b.dataset.c === v.cadence;
+      b.classList.toggle('mws-chip--on', on);
+      b.setAttribute('aria-pressed', String(on));
+    }
+    gauge(v, cap);
+    strip(v);
+    $('mws-key-state').textContent = v.key_set ? 'set' : 'not set';
+    $('mws-key-state').classList.toggle('mws-key__state--set', v.key_set);
+    $('mws-key-clear').hidden = !v.key_set;
+    $('mws-key-save').textContent = v.key_set ? 'Replace' : 'Save';
+    $('mws-key-in').disabled = !v.storage_configured;
+    $('mws-key-save').disabled = !v.storage_configured;
+    $('mws-key-note').textContent = !v.storage_configured
+      ? 'Key storage is not set up on this project yet, so a key cannot be saved.'
+      : v.enabled && !v.key_set
+        ? 'Market Watch is on but has no key, so each run will be skipped until one is set.'
+        : 'Runs use this key, so the project’s Anthropic account pays for them. It is stored encrypted and never shown again.';
+  }
+
+  async function write(method, body, done) {
+    if (busy) return;
+    busy = true;
+    const r = await send(method, body);
+    busy = false;
+    if (!r.ok) { if (r.message) error(r.message); if (view) draw(view); return; }
+    draw(r.data);
+    if (done) toast(done(r.data), { clear: true, duration: 2200 });
+  }
+
+  // ---- controls --------------------------------------------------------------------
+
+  $('mws-power').addEventListener('click', () => {
+    if (!view) return;
+    write('PATCH', { enabled: !view.enabled }, (v) => {
+      if (!v.enabled) return 'off · nothing runs';
+      return v.next_run.due_at ? `on · next run ${weekday(v.next_run.due_at)}` : 'on · next run soon';
+    });
+  });
+
+  $('mws-cap').addEventListener('input', (e) => {
+    if (!view) return;
+    const cap = Number(e.target.value);
+    e.target.setAttribute('aria-valuetext', `${money(cap)} a month`);
+    gauge(view, cap);
+  });
+  $('mws-cap').addEventListener('change', (e) => {
+    const cap = Number(e.target.value);
+    if (!view || cap === view.monthly_cap_usd) return;
+    write('PATCH', { monthly_cap_usd: cap }, (v) => `cap ${money(v.monthly_cap_usd)} a month`);
+  });
+
+  $('mws-cad').addEventListener('click', (e) => {
+    const b = e.target.closest('button[data-c]');
+    if (!b || !view || b.dataset.c === view.cadence) return;
+    write('PATCH', { cadence: b.dataset.c }, (v) => `runs ${CADENCE_WORDS[v.cadence] || v.cadence}`);
+  });
+
+  $('mws-key-save').addEventListener('click', () => {
+    const input = $('mws-key-in');
+    const key = input.value.trim();
+    if (!key) { error('Paste the key first.'); input.focus(); return; }
+    // The field is emptied before the request goes out: the key never sits in the page
+    // longer than it takes to send it.
+    input.value = '';
+    write('PUT', { key }, () => 'key saved');
+  });
+
+  // Clearing asks twice: the first press turns the button into its own question.
+  let clearArmed = null;
+  $('mws-key-clear').addEventListener('click', () => {
+    const b = $('mws-key-clear');
+    if (!clearArmed) {
+      b.textContent = 'Clear the key?';
+      clearArmed = setTimeout(() => { clearArmed = null; b.textContent = 'Clear'; }, 4000);
+      return;
+    }
+    clearTimeout(clearArmed);
+    clearArmed = null;
+    b.textContent = 'Clear';
+    write('DELETE', undefined, () => 'key cleared · runs will be skipped');
+  });
+
+  async function load() {
+    const r = await send('GET');
+    if (r.ok) draw(r.data);
+    else if (r.message) error(r.message);
+  }
+
+  document.addEventListener('DOMContentLoaded', load);
+})();

package/modules/hall-ui/public/market-watch-settings.states.json

@@ -0,0 +1,14 @@
+{
+  "_": "MARKET WATCH SETTINGS (task 1004938; design of record docs/design/mocks/market-watch/settings.html, option B, the fuel gauge) through modules/ui-design/kit/render.js. The page reads ONE owner-only route, GET /market-watch/settings, so against the kit's own stub it renders its 'module is off' state (the 404), which the floors must hold too. To look at the populated gauge run it against the hall-preview harness, whose market-watch__settings.json fixture carries the mockup's month (12.40 of 20 spent, six runs, one skipped at the cap):\n\n  node scripts/hall-preview/server.js --port 4620 --fixture-me --rank archon\n  node modules/ui-design/kit/render.js --states modules/hall-ui/public/market-watch-settings.states.json --base-in http://localhost:4620 --base-out http://localhost:4620",
+  "page": "/builders/market-watch-settings",
+  "surface": "hall-ui",
+  "stub": { "prefix": "/builders/" },
+  "modeQuery": false,
+  "ignoreRequests": ["/api/(gds|bongos)/"],
+  "ignoreConsole": ["/api/(gds|bongos)/", "\\b401\\b", "\\b403\\b", "\\b404\\b", "Unauthorized", "Forbidden", "Not Found", "load failed"],
+  "states": {
+    "gauge": { "auth": true, "actions": [["wait", 900], ["clickIfVisible", "[data-craft-close]"], ["wait", 300]], "expect": { "visible": ["#mws-body"] } },
+    "out": { "auth": false, "actions": [["wait", 600]] }
+  },
+  "reducedMotion": { "auth": true, "actions": [["wait", 800]] }
+}

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

@@ -127,8 +127,8 @@
 
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
-<script src="/builders/craft-mode.js?v=2026-10-09-living3"></script>
-<script src="/builders/shell.js?v=2026-10-25-escape"></script>
+<script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch"></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/brand-apply.js"></script>

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

@@ -342,6 +342,11 @@
     const facts = [m.is_new
       ? '<span class="fact-pill fact-pill--info" title="No real-world data yet, so it is listed but not ranked.">new</span>'
       : `<span class="ov-fact">scores <b>${escapeHtml(String(m.overall))}</b></span>`];
+    // A module that still carries only an old credit price stays listed, marked
+    // until its author sets a cash price (task 1004989): credits never buy one.
+    if (m.price && m.price.coming) {
+      facts.push('<span class="fact-pill fact-pill--info" title="Its author has been asked to set a cash price. Credits cannot buy a module.">price coming</span>');
+    }
     const sorted = sortedPartFact(m);
     if (sorted) facts.push(sorted);
     const strong = Array.isArray(m.strengths) ? m.strengths : [];

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

@@ -61,8 +61,8 @@
 
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
-<script src="/builders/craft-mode.js?v=2026-10-09-living3"></script>
-<script src="/builders/shell.js?v=2026-10-25-escape"></script>
+<script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch"></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/gov-living.js?v=2026-10-10-real1"></script>

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

@@ -112,8 +112,8 @@
 
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
-<script src="/builders/craft-mode.js?v=2026-10-09-living3"></script>
-<script src="/builders/shell.js?v=2026-10-25-escape"></script>
+<script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- the shared markdown reader (window.OTBMdReader) — primer.js renders through

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

@@ -207,8 +207,8 @@
      chrome exists before the page script runs. -->
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
-<script src="/builders/craft-mode.js?v=2026-10-09-living3"></script>
-<script src="/builders/shell.js?v=2026-10-25-escape"></script>
+<script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- task 1004727: the ONE karma vote control every task/idea list renders -->

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

@@ -71,8 +71,8 @@
 
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
-<script src="/builders/craft-mode.js?v=2026-10-09-living3"></script>
-<script src="/builders/shell.js?v=2026-10-25-escape"></script>
+<script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch"></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/hall-kit.js"></script>

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

@@ -73,8 +73,8 @@
      chrome exists before the page script runs. -->
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
-<script src="/builders/craft-mode.js?v=2026-10-09-living3"></script>
-<script src="/builders/shell.js?v=2026-10-25-escape"></script>
+<script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch"></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/founding-mark.js?v=2026-09-30-founding"></script>

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

@@ -43,8 +43,8 @@
 
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
-<script src="/builders/craft-mode.js?v=2026-10-09-living3"></script>
-<script src="/builders/shell.js?v=2026-10-25-escape"></script>
+<script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- The chart kit and the timeline's series builders (task 1003447). Both MUST

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

@@ -55,8 +55,8 @@
      chrome exists before the page script runs. -->
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
-<script src="/builders/craft-mode.js?v=2026-10-09-living3"></script>
-<script src="/builders/shell.js?v=2026-10-25-escape"></script>
+<script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- the branding pack's currency label, loaded BEFORE roster.js. -->

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

@@ -111,8 +111,8 @@
      chrome exists before the page script runs. -->
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
-<script src="/builders/craft-mode.js?v=2026-10-09-living3"></script>
-<script src="/builders/shell.js?v=2026-10-25-escape"></script>
+<script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch"></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/task-detail.js?v=2026-07-03-taskdetail"></script>

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

@@ -486,8 +486,8 @@
      chrome exists before the page scripts run. -->
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
-<script src="/builders/craft-mode.js?v=2026-10-09-living3"></script>
-<script src="/builders/shell.js?v=2026-10-25-escape"></script>
+<script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch"></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 component kit (window.OTBKit) — section rail (task 2166). -->

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

@@ -125,6 +125,7 @@
     settings: '<circle cx="9" cy="9" r="2.5"/><path d="M9 2.5v2m0 9v2M2.5 9h2m9 0h2M4.4 4.4l1.4 1.4m6.4 6.4 1.4 1.4m0-9.2-1.4 1.4M5.8 12.2l-1.4 1.4"/>',
     deploy: '<path d="M9 12V3M5.5 6.5 9 3l3.5 3.5M3 12.5v2a1 1 0 0 0 1 1h10a1 1 0 0 0 1-1v-2"/>',
     fleet: '<path d="M4 2.5h10v13l-1.7-1-1.6 1-1.7-1-1.7 1-1.6-1-1.7 1v-13Z"/><path d="M6.5 6h5M6.5 9h5M6.5 12h3"/>',
+    fuel: '<path d="M3 13a6 6 0 1 1 12 0"/><path d="M9 13l3-4"/>',
     permissions: '<circle cx="6" cy="12" r="3.5"/><path d="M8.5 9.5 15 3M12.5 5.5l2 2M10.5 7.5l1.5 1.5"/>',
     // The governor city: a pediment over columns, the Governing mode's own glyph.
     city: '<path d="M2.5 7 9 3l6.5 4M4 7.5v6.5M7 7.5v6.5M11 7.5v6.5M14 7.5v6.5M2.5 15.5h13"/>',
@@ -386,6 +387,8 @@
       // of `provisioning.fleet.manage`, the atom its page and its one read check (the
       // Deploy precedent above); dropped where the provisioning module is not enabled.
       { id: 'fleet', label: 'Fleet costs', icon: 'fleet', href: '/fleet', gate: 'government', module: 'provisioning', position: true },
+      // task 1004938: owner-only Market Watch settings; 'archon' mirrors its routes (cosmetic, ADR 0016).
+      { id: 'market-watch-settings', label: 'Market Watch', icon: 'fuel', href: '/market-watch-settings', gate: 'archon', module: 'market-watch', position: true },
       // BV1.R113: the roles-and-permissions tab (ADR 0151). The one genuinely
       // Archon-only item the 'government' gate comment anticipated — cosmetic
       // only. The wall is the `government.manage` atom checked on each of the

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

@@ -230,8 +230,8 @@
 
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
-<script src="/builders/craft-mode.js?v=2026-10-09-living3"></script>
-<script src="/builders/shell.js?v=2026-10-25-escape"></script>
+<script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
 <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>

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

@@ -218,8 +218,8 @@
 
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
-<script src="/builders/craft-mode.js?v=2026-10-09-living3"></script>
-<script src="/builders/shell.js?v=2026-10-25-escape"></script>
+<script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
 <script src="/builders/palette.js" defer></script>
 <!-- The kit, for its ONE renderer: the full-size ship-time visual figure
      (task 1003829), which the older reviews still show. -->

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

@@ -58,8 +58,8 @@
      time so the chrome exists before the deferred page scripts execute. -->
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
-<script src="/builders/craft-mode.js?v=2026-10-09-living3"></script>
-<script src="/builders/shell.js?v=2026-10-25-escape"></script>
+<script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- task-detail.js still owns the #/idea/N and #/blocker/N deep-link overlay

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

@@ -140,8 +140,8 @@
 
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
-<script src="/builders/craft-mode.js?v=2026-10-09-living3"></script>
-<script src="/builders/shell.js?v=2026-10-25-escape"></script>
+<script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch"></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/tweak-editor.html

@@ -144,8 +144,8 @@
 
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
-<script src="/builders/craft-mode.js?v=2026-10-09-living3"></script>
-<script src="/builders/shell.js?v=2026-10-25-escape"></script>
+<script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/brand-holes.js?v=2026-09-29-aqfix"></script>
 <script src="/builders/tweak-editor-lib.js?v=2026-09-29-tw27"></script>

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

@@ -165,8 +165,8 @@
      chrome exists before the page script runs. -->
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
-<script src="/builders/craft-mode.js?v=2026-10-09-living3"></script>
-<script src="/builders/shell.js?v=2026-10-25-escape"></script>
+<script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch"></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 component kit (window.OTBKit) — tabs, ledger, pager (task 2166). -->

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

@@ -173,8 +173,8 @@
      time so the chrome exists before the deferred page scripts execute. -->
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
-<script src="/builders/craft-mode.js?v=2026-10-09-living3"></script>
-<script src="/builders/shell.js?v=2026-10-25-escape"></script>
+<script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- task 1004727: the ONE karma vote control every task/idea list renders -->

package/modules/hall-ui/records/market-watch-settings.md

@@ -0,0 +1,11 @@
+# Market Watch settings, at /market-watch-settings (task 1004938)
+
+**The owner's fuel gauge for Market Watch (goal 1000137), built to `docs/design/mocks/market-watch/settings.html`, option B.** One panel: the gauge (spend this month against the monthly AI cap, with a faint arc for what the next run will use), the on/off pill, the cap slider, the cadence chips (weekly, every 2 weeks, monthly), the strip of recent runs, and the project's Anthropic key. Five things it settled:
+
+- **The routes are the wall, not the page.** `GET`/`PATCH /market-watch/settings` and `PUT`/`DELETE /market-watch/settings/key` are owner-only: the `project.settings.manage` atom, then an in-route owner-seat (Archon) check (modules/market-watch/routes/settings.js). The shell joins `SIGNEDIN_BUILDERS_PAGE_RE` and holds no data; a 403 draws the owner-only panel and a 404 (module off, so its routes are not mounted) the "turn the module on" panel. The nav item sits in Government, `archon`, `module: 'market-watch'`.
+- **The key is write-only.** The page learns `key_set` and nothing else, not the last four. The field is emptied before the request goes out; Clear asks twice by turning into its own question.
+- **The page redraws from the server's answer.** Every write returns the whole view, so the gauge never shows a value the server did not store.
+- **The strip is the run ledger, oldest left.** A ran run shows the names it watched; a skipped one is a hatched dash, with its reason in the cell's label and the legend (`cap reached`, `switched off`, `no key`, …); the dashed tile is the next run and the two after it are empty. When the watch is off the future tiles go. The seed run never shows. At 620px and below the dates stack day over month, or nine tiles overflow at 390px.
+- **Mockup colours were not kept.** The ring, chips and tiles use the hall's `--accent`, `--accent-tint`, `--accent-text`, `--rule*` and `--ok-weak`; the mock's own fonts were dropped for the pack's.
+
+Fixture: `scripts/hall-preview/fixtures/market-watch__settings.json` (the mockup's month). Tests: `tests/market_watch_settings.mjs` (403s for a Metic and a Xenos on all four routes, switching off stops the next run against `run.js`'s own gate, the key never in a response).

package/modules/market-watch/module.json

@@ -1,7 +1,7 @@
 {
   "key": "market-watch",
   "title": "Market Watch (a weekly AI watch on a project's market)",
-  "description": "A weekly AI watch on a project's competitors, partners and topics, with a sourced log per tracked item and a weekly question to members (goal 1000137). Its data model (tables, read queries and the hub seed of the 2026-10-28 research), its weekly run (an hourly poller that researches each tracked item on the project's own Anthropic key, under the monthly cap), the weekly ask card in the hall's attention inbox (task 1004940) and its rules page (the watch rules in plain words, members' proposed changes, and the owner's or the government's decision on each, task 1004941) are in. Off by default, and it cannot be turned on behind an open join door with no payer, because every run will spend the project's AI budget.",
+  "description": "A weekly AI watch on a project's competitors, partners and topics, with a sourced log per tracked item and a weekly question to members (goal 1000137). Its data model (tables, read queries and the hub seed of the 2026-10-28 research), its weekly run (an hourly poller that researches each tracked item on the project's own Anthropic key, under the monthly cap), the weekly ask card in the hall's attention inbox (task 1004940), its rules page (the watch rules in plain words, members' proposed changes, and the owner's or the government's decision on each, task 1004941) and the owner's settings (on/off, monthly cap, cadence, the project key; task 1004938) are in. Off by default, and it cannot be turned on behind an open join door with no payer, because every run will spend the project's AI budget.",
   "version": "0.4.0",
   "coreVersion": "^1.22.0",
   "category": {
@@ -15,7 +15,8 @@
     "migrations": true,
     "routes": [
       "ask",
-      "rules"
+      "rules",
+      "settings"
     ],
     "pollers": [
       "hub-seed",