@bongos/core 1.24.9 → 1.24.11

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/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.css

@@ -60,6 +60,18 @@
   border-top: var(--line) solid var(--rule-soft);
 }
 .ps-cat--off { opacity: 0.6; }
+
+/* Pay terms (task 1004990): one wrapping line per term, the category list's shape. */
+.ps-pays { margin: 10px 0 0; padding: 0; list-style: none; }
+.ps-pay {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 8px;
+  padding: 8px 0;
+  border-top: var(--line) solid var(--rule-soft);
+}
+.ps-pay__note { flex: 1 1 200px; min-width: 0; }
 .ps-cat__slug {
   font-size: 11px;
   color: var(--ink-soft);

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/project-settings.js

@@ -198,6 +198,44 @@
       </div>`;
   }
 
+  // Pay terms (task 1004990, ADR 0385 decision 3): the project's standing pay, in
+  // its own words. One line per term plus a blank one to add; picking "remove"
+  // drops a line. Every box starts EMPTY on a new line — Bongos suggests no amount.
+  // The history under it is the audit trail: who changed the terms, and when.
+  function payTermLineHtml(types, t) {
+    const opts = [`<option value="">${t ? 'remove' : 'add a term…'}</option>`]
+      .concat(types.map((o) => `<option value="${escapeHtml(o.type)}" ${t && t.pay_type === o.type ? 'selected' : ''}>${escapeHtml(o.label)}</option>`));
+    const val = (f) => escapeHtml(t && t[f] != null ? String(t[f]) : '');
+    return `
+      <li class="ps-pay">
+        <select class="ps-pay__type" aria-label="Kind of pay">${opts.join('')}</select>
+        <input type="text" class="ps-pay__amount" maxlength="64" value="${val('amount')}" placeholder="amount, as you state it" aria-label="Amount">
+        <input type="text" class="ps-pay__unit" maxlength="32" value="${val('unit')}" placeholder="unit" aria-label="Unit">
+        <input type="text" class="ps-pay__note" maxlength="500" value="${val('note')}" placeholder="note" aria-label="Note">
+      </li>`;
+  }
+
+  function payTermsBodyHtml(row) {
+    const v = row.value || {};
+    const types = Array.isArray(v.types) ? v.types : [];
+    const terms = Array.isArray(v.terms) ? v.terms : [];
+    const lines = terms.map((t) => payTermLineHtml(types, t));
+    if (terms.length < (v.max || 10)) lines.push(payTermLineHtml(types, null));
+    const selfManaged = terms.some((t) => t.pay_type === 'self_managed')
+      ? `<p class="ps-sibling">${escapeHtml(String(v.self_managed_label || ''))}</p>` : '';
+    const history = (Array.isArray(v.history) ? v.history : []).map((h) => `
+        <li>${escapeHtml(h.set_by_login ? '@' + h.set_by_login : 'builder ' + h.set_by)} set
+          ${escapeHtml(String(h.terms.length))} term${h.terms.length === 1 ? '' : 's'}
+          on ${escapeHtml(new Date(h.set_at).toLocaleString())}</li>`).join('');
+    return `
+      <ul class="ps-pays">${lines.join('')}</ul>
+      ${selfManaged}
+      <div class="ps-controls">
+        <button type="button" class="btn" id="ps-pay-save">Save pay terms</button>
+      </div>
+      ${history ? `<details class="ps-sibling"><summary>Who changed the pay terms</summary><ul>${history}</ul></details>` : ''}`;
+  }
+
   // ---- render + wire -------------------------------------------------------
 
   let rows = [];
@@ -209,6 +247,7 @@
       if (row.key === 'tweak_round_cap' && row.editable) return rowHtml(row, tweakCapBodyHtml(row));
       if (row.key === 'rot_timer' && row.editable) return rowHtml(row, rotBodyHtml(row));
       if (row.key === 'work_categories' && row.editable) return rowHtml(row, catsBodyHtml(row));
+      if (row.key === 'pay_terms' && row.editable) return rowHtml(row, payTermsBodyHtml(row));
       return rowHtml(row, '');
     }).join('')}</ul>`;
     wire();
@@ -219,10 +258,33 @@
   // reply, arriving first, can repaint a value nobody asked for.
   function setBusy(on) {
     const mount = $('ps-rows');
-    mount.querySelectorAll('input, button').forEach((el) => { el.disabled = on; });
+    mount.querySelectorAll('input, button, select').forEach((el) => { el.disabled = on; });
   }
 
   function wire() {
+    const paySave = $('ps-pay-save');
+    if (paySave) {
+      paySave.addEventListener('click', async () => {
+        // Only what was typed is sent; an empty box stays empty (null), never filled.
+        const terms = [];
+        document.querySelectorAll('.ps-pay').forEach((li) => {
+          const type = li.querySelector('.ps-pay__type').value;
+          if (!type) return;
+          const text = (cls) => { const s = String(li.querySelector(cls).value || '').trim(); return s || null; };
+          terms.push({ pay_type: type, amount: text('.ps-pay__amount'), unit: text('.ps-pay__unit'), note: text('.ps-pay__note') });
+        });
+        setBusy(true);
+        try {
+          await sendJson('PATCH', '/project-settings/pay-terms', { terms });
+          toast(terms.length ? 'Pay terms saved.' : 'Pay terms cleared.');
+          await load();
+        } catch (err) {
+          toast(err.message || 'Could not save the pay terms.');
+          setBusy(false);
+        }
+      });
+    }
+
     const shipSave = $('ps-ship-save');
     if (shipSave) {
       shipSave.addEventListener('click', async () => {

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/task.js

@@ -484,8 +484,29 @@
     return `<section class="rec-sec" id="task-sessions"><p class="rec-sec__h">Session log${count}</p>${blocks.join('')}</section>`;
   }
 
+  // The task's pay terms as the project stated them (task 1004990). Amounts are the
+  // project's text, shown verbatim — never a figure Bongos computed or suggested,
+  // and never a balance. A missing amount reads "not stated". A self-managed term
+  // carries the server's label saying Bongos moves and guarantees none of it.
+  // Terms that come from the project's standing policy say so. Nothing to show
+  // (none stated anywhere) draws nothing.
+  function payTermsHtml(view) {
+    if (!view || !Array.isArray(view.terms) || !view.terms.length) return '';
+    const lines = view.terms.map((term) => {
+      const amount = term.amount
+        ? `${escapeHtml(term.amount)}${term.unit ? ' ' + escapeHtml(term.unit) : ''}`
+        : '<em>amount not stated</em>';
+      return `<li><strong>${escapeHtml(term.type_label || term.pay_type)}</strong> — ${amount}`
+        + (term.note ? `<br>${escapeHtml(term.note)}` : '')
+        + (term.label ? `<br><em>${escapeHtml(term.label)}</em>` : '')
+        + '</li>';
+    }).join('');
+    const from = view.source === 'project' ? ' <em>this project’s standing terms</em>' : '';
+    return `<section class="rec-sec" id="task-pay"><p class="rec-sec__h">Pay${from}</p><ul>${lines}</ul></section>`;
+  }
+
   function renderTask(t, lastClaim, viewer, goal, extras) {
-    const { grade = null, sessionLogs = null, claims = null, goalsList = null } = extras || {};
+    const { grade = null, sessionLogs = null, claims = null, goalsList = null, payTerms = null } = extras || {};
     document.title = `#${t.id} — ${t.title || 'Task'} — ${document.title.split(' — ').pop()}`;
     const sub = $('#task-sub');
     if (sub) sub.textContent = `Task ${t.id}`;
@@ -631,6 +652,10 @@
       ['Priority', t.priority == null ? null : 'P' + t.priority],
     ]));
     parts.push(lifecycleRail(t, creditVal));
+    // What the task pays, in the PROJECT's words (task 1004990, ADR 0385 D3), drawn
+    // beside the Claim button so a builder reads it before claiming.
+    const pay = payTermsHtml(payTerms);
+    if (pay) parts.push(pay);
     // A slot a MODULE may fill (task 1004301): the module's public/task-widget.js is
     // injected just before this script and writes into it on `otb:task-shown` below. The
     // page itself names no module and draws nothing here — with none enabled it stays
@@ -1086,10 +1111,18 @@
         if (ri && typeof ri.blob_base === 'string') repoBlobBase = ri.blob_base;
         if (ri && typeof ri.tree_base === 'string') repoTreeBase = ri.tree_base;
       } catch (_) { /* links degrade to the original href */ }
+      // task 1004990: the task's pay terms, in the project's words. Best-effort: an
+      // older server without the read draws no pay section rather than no page.
+      let payTerms = null;
+      try {
+        const pt = await getJSON(`${API}/pay-terms?task_ids=${encodeURIComponent(d.task.id)}`, { softAuth: true });
+        payTerms = (pt && pt.pay_terms && pt.pay_terms[String(d.task.id)]) || null;
+      } catch (_) { /* no pay section */ }
       renderTask(d.task, d.last_claim || null, viewer, goal, {
         grade: d.grade || null,
         sessionLogs: Array.isArray(d.session_logs) ? d.session_logs : null,
         claims: Array.isArray(d.claims) ? d.claims : null,
+        payTerms,
         goalsList,
       });
     } catch (err) {

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>