@bongos/core 1.24.7 → 1.24.9

package/docs/page-readings.json

@@ -5,7 +5,7 @@
   "adr": "0341 D3",
   "reread": "node scripts/bongos/page-reader.js --stale",
   "how": ["Generated by node scripts/bongos/page-reader.js (BV2.TW04, task 1004315; ADR 0341 D3). Do not hand-edit.","One entry per page of docs/page-inventory.json. Lines are in page order: the default state first, and a line only another state shows sits where that state shows it, with its state named.","placement: placed = a docs/copy-registry.json row renders it (file, line, string_id); shared = shell text every page of the surface carries (top bar, sidebar, footer), with its row when the registry has one; unplaced = the registry cannot place it (a rewrite becomes an engineer task, ADR 0341 D4).","text keeps {…} where the registry row has a hole, or where a value the page read from its API was filled in. A string that is only such data is counted under omitted.data, not listed.","reading_hash is over the non-shared lines (key, section, text); files_hash is over the page's inventory files. --check compares files_hash only and never opens a browser.","Rendered through the hall-preview harness (hall) and the ui-design kit stub (landing, status), at 1280x800 with the clock pinned, so a reading is the fixture world's page."],
-  "counts": {"pages":48,"lines":5464,"placed":1687,"shared":427,"unplaced":3350,"omitted_data":3732},
+  "counts": {"pages":49,"lines":5511,"placed":1700,"shared":435,"unplaced":3376,"omitted_data":3777},
   "pages": [
     {
       "id": "builders:ai-studio",
@@ -1794,12 +1794,72 @@
         {"key":"L0066","section":"What are you doing now?","text":"Ask me again next session","placement":"placed","file":"modules/hall-ui/public/craft-mode.js","line":675,"string_id":"fa86bf403775"}
       ]
     },
+    {
+      "id": "builders:market-watch-rules",
+      "surface": "builders",
+      "title": "Market Watch rules",
+      "states_read": ["in","scoring","names","propose","out"],
+      "files_hash": "5146acc85101e657",
+      "reading_hash": "8fab4258348366b7",
+      "counts": {"lines":47,"placed":13,"shared":8,"unplaced":26},
+      "omitted": {"data":45},
+      "notes": [],
+      "lines": [
+        {"key":"L0001","section":"skip link","text":"Skip to content","placement":"shared","file":"modules/hall-ui/public/shell.js","line":868,"string_id":"87cee78ca134"},
+        {"key":"L0002","section":"top bar","text":"Market Watch rules","placement":"shared","file":"modules/hall-ui/public/market-watch-rules.html","line":15,"string_id":"d069f67f3ac6"},
+        {"key":"L0003","section":"top bar","text":"Jump to…","placement":"shared","file":"modules/hall-ui/public/shell.js","line":540,"string_id":"eba610d25523"},
+        {"key":"L0004","section":"top bar","text":"Ctrl K","placement":"shared"},
+        {"key":"L0005","section":"top bar","text":"Building","placement":"shared"},
+        {"key":"L0006","section":"top bar","text":"Artistry","placement":"shared"},
+        {"key":"L0007","section":"top bar","text":"Ideating","placement":"shared"},
+        {"key":"L0008","section":"page top","text":"v3 · now","placement":"unplaced"},
+        {"key":"L0009","section":"page top","text":"in use","placement":"unplaced"},
+        {"key":"L0010","section":"page top","text":"v1","placement":"unplaced"},
+        {"key":"L0011","section":"page top","text":"v2","placement":"unplaced"},
+        {"key":"L0012","section":"page top","text":"v3","placement":"unplaced"},
+        {"key":"L0013","section":"page top","text":"v4?","placement":"unplaced"},
+        {"key":"L0014","section":"page top","text":"{…} of {…}","placement":"placed","file":"modules/hall-ui/public/sky-panel.js","line":120,"string_id":"73c1372b43d9","occurrences":2},
+        {"key":"L0015","section":"{…}","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","state":"propose","occurrences":8},
+        {"key":"L0016","section":"{…}","text":"propose a change","placement":"placed","file":"modules/hall-ui/public/market-watch-rules-lib.js","line":127,"string_id":"cc7d093fdd53","state":"propose","occurrences":4},
+        {"key":"L0017","section":"{…}","text":"change","placement":"unplaced","state":"propose"},
+        {"key":"L0018","section":"{…}","text":"add a source","placement":"unplaced","state":"propose"},
+        {"key":"L0019","section":"{…}","text":"remove one","placement":"unplaced","state":"propose"},
+        {"key":"L0020","section":"{…}","text":"why","placement":"unplaced","state":"propose"},
+        {"key":"L0021","section":"{…}","text":"one line","placement":"placed","file":"modules/hall-ui/public/market-watch-rules-lib.js","line":137,"string_id":"973f396ac861","attr":"placeholder","state":"propose"},
+        {"key":"L0022","section":"{…}","text":"send the proposal","placement":"placed","file":"modules/hall-ui/public/market-watch-rules-lib.js","line":160,"string_id":"fe17d62b8a85","state":"propose"},
+        {"key":"L0023","section":"{…}","text":"cancel","placement":"unplaced","state":"propose"},
+        {"key":"L0024","section":"{…}","text":"Open {…}","placement":"placed","file":"modules/hall-ui/public/goals.js","line":84,"string_id":"f6f68ba322be","state":"names","occurrences":3},
+        {"key":"L0025","section":"{…}","text":"+ 54 more","placement":"unplaced","state":"names"},
+        {"key":"L0026","section":"{…}","text":"HUMAN DECISION","placement":"unplaced","state":"names","occurrences":3},
+        {"key":"L0027","section":"{…}","text":"proposal from {…}","placement":"unplaced","state":"names","occurrences":3},
+        {"key":"L0028","section":"{…}","text":"Approve","placement":"unplaced","state":"names","occurrences":3},
+        {"key":"L0029","section":"{…}","text":"takes effect now","placement":"unplaced","state":"names"},
+        {"key":"L0030","section":"{…}","text":"Decline","placement":"unplaced","state":"names","occurrences":3},
+        {"key":"L0031","section":"{…}","text":"stays in history","placement":"unplaced","state":"names","occurrences":3},
+        {"key":"L0032","section":"{…}","text":"competitors","placement":"unplaced","state":"scoring"},
+        {"key":"L0033","section":"{…}","text":"partners","placement":"unplaced","state":"scoring"},
+        {"key":"L0034","section":"{…}","text":"{…} of {…}","placement":"placed","file":"modules/hall-ui/public/sky-panel.js","line":120,"string_id":"73c1372b43d9","state":"scoring"},
+        {"key":"L0035","section":"{…}","text":"becomes v4","placement":"unplaced","state":"scoring","occurrences":2},
+        {"key":"L0036","section":"cost of one run, by step","text":"cost of one run, by step","placement":"placed","file":"modules/hall-ui/public/market-watch-rules.html","line":32,"string_id":"c02d0024fe78"},
+        {"key":"L0037","section":"cost of one run, by step","text":"{…}: no run has cost anything yet, so these are $5.40 from the planning figures","placement":"unplaced"},
+        {"key":"L0038","section":"footer","text":"Sign out","placement":"shared","file":"modules/hall-ui/public/shell.js","line":516,"string_id":"1883ad7f07fc"},
+        {"key":"L0039","section":"cost of one run, by step","text":"Builders hall · this session","placement":"placed","file":"modules/hall-ui/public/craft-mode.js","line":670,"string_id":"fd1903586e8e","state":"out"},
+        {"key":"L0040","section":"What are you doing now?","text":"What are you doing now?","placement":"placed","file":"modules/hall-ui/public/craft-mode.js","line":671,"string_id":"60853319f290","state":"out"},
+        {"key":"L0041","section":"What are you doing now?","text":"Pick one. You can switch any time from the top bar.","placement":"placed","file":"modules/hall-ui/public/craft-mode.js","line":672,"string_id":"4f87d5b17b54","state":"out"},
+        {"key":"L0042","section":"What are you doing now?","text":"Building","placement":"unplaced","state":"out"},
+        {"key":"L0043","section":"What are you doing now?","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","state":"out","occurrences":3},
+        {"key":"L0044","section":"What are you doing now?","text":"Artistry","placement":"unplaced","state":"out"},
+        {"key":"L0045","section":"What are you doing now?","text":"Ideating","placement":"unplaced","state":"out"},
+        {"key":"L0046","section":"What are you doing now?","text":"Turn thoughts into ideas.","placement":"unplaced","state":"out"},
+        {"key":"L0047","section":"What are you doing now?","text":"Ask me again next session","placement":"placed","file":"modules/hall-ui/public/craft-mode.js","line":675,"string_id":"fa86bf403775","state":"out"}
+      ]
+    },
     {
       "id": "builders:modules",
       "surface": "builders",
       "title": "Modules",
       "states_read": ["browse","search-empty","lens","details","out"],
-      "files_hash": "5d13e25fdcd22d84",
+      "files_hash": "2c777359d9db9123",
       "reading_hash": "d544f93125c23b24",
       "counts": {"lines":58,"placed":26,"shared":8,"unplaced":24},
       "omitted": {"data":106},
@@ -1850,8 +1910,8 @@
         {"key":"L0043","section":"Module catalog","text":"Name","placement":"unplaced"},
         {"key":"L0044","section":"Module catalog","text":"No store module matches that {…}.","placement":"unplaced","state":"search-empty"},
         {"key":"L0045","section":"Module catalog","text":"scores","placement":"unplaced","occurrences":2},
-        {"key":"L0046","section":"Module catalog","text":"strong at {…}","placement":"placed","file":"modules/hall-ui/public/modules.js","line":349,"string_id":"e294c3429c2e","occurrences":3},
-        {"key":"L0047","section":"Module catalog","text":"weak at {…}","placement":"placed","file":"modules/hall-ui/public/modules.js","line":351,"string_id":"20318b6da94e"},
+        {"key":"L0046","section":"Module catalog","text":"strong at {…}","placement":"placed","file":"modules/hall-ui/public/modules.js","line":354,"string_id":"e294c3429c2e","occurrences":3},
+        {"key":"L0047","section":"Module catalog","text":"weak at {…}","placement":"placed","file":"modules/hall-ui/public/modules.js","line":356,"string_id":"20318b6da94e"},
         {"key":"L0048","section":"Module catalog","text":"A part is strong at 80 of 100 or more, and weak below the listing floor. Missing data never counts against a module, and a new module is not ranked.","placement":"placed","file":"modules/hall-ui/public/modules.html","line":98,"string_id":"01857ee8cbe3"},
         {"key":"L0049","section":"footer","text":"Sign out","placement":"shared","file":"modules/hall-ui/public/shell.js","line":516,"string_id":"1883ad7f07fc"},
         {"key":"L0050","section":"Module catalog","text":"Builders hall · this session","placement":"placed","file":"modules/hall-ui/public/craft-mode.js","line":670,"string_id":"fd1903586e8e"},

package/migrations/core_287_module_prices_cash_only.sql

@@ -0,0 +1,24 @@
+-- core_287_module_prices_cash_only.sql — task 1004989 (goal 1000092; ADR 0385
+-- decision 2 and its 2026-10-29 amendment).
+--
+-- Credits are a contribution meter: they are never spent, transferred or bought
+-- with, so a module cannot carry a price in credits. A credit price would make
+-- credits stored value. From now on a new price row carries cents only.
+--
+-- HISTORY STAYS READABLE. The CHECK is added NOT VALID, so Postgres enforces it
+-- on every NEW row (and on any update) but does not re-check the rows already
+-- there. A module whose newest price was set in credits keeps that row; the
+-- store reads it as "price coming" — still listed, never buyable with credits —
+-- until its author sets a cash price (the owner's ruling, 2026-10-29). Nothing
+-- is converted, deleted or rewritten. Do not VALIDATE this constraint: the old
+-- credit rows are the evidence of what each author asked, and they would fail it.
+--
+-- core_257's own CHECK (price_cents IS NOT NULL OR price_credits IS NOT NULL)
+-- still holds, so with credits refused a new row must name a cash price.
+
+ALTER TABLE store_module_prices DROP CONSTRAINT IF EXISTS store_module_prices_no_new_credit_price;
+ALTER TABLE store_module_prices
+  ADD CONSTRAINT store_module_prices_no_new_credit_price CHECK (price_credits IS NULL) NOT VALID;
+
+COMMENT ON COLUMN store_module_prices.price_credits IS
+  'Historical only. Credits cannot price a module (ADR 0385 decision 2); new rows must leave this NULL (store_module_prices_no_new_credit_price, NOT VALID so old rows stay). A newest row with only credits reads as "price coming".';

package/modules/government/decision-board.js

@@ -253,6 +253,11 @@ const MATTER_ACTIONS = Object.freeze({
   treasury: Object.freeze({
     set_budget: Object.freeze({ builder_id: 'id', monthly_usd: 'usd' }),
   }),
+  // task 1004941: a Market Watch proposal put to the Rules sitting, approved on a
+  // pass by the market-watch module's act (modules/market-watch/matter-acts.js)
+  rules: Object.freeze({
+    market_watch_proposal: Object.freeze({ proposal_id: 'id' }),
+  }),
 });
 const MATTER_ACT_POINT = 'governor.matterAct';
 const MAX_BUDGET_USD = 100000;

package/modules/government/decision-rules.js

@@ -68,6 +68,9 @@ const AREAS = Object.freeze([
       'PATCH /project-settings/ship-mode',
       'PATCH /project-settings/tweak-autopickup',
       'PATCH /work-categories/:id',
+      // task 1004941: the owner approving a Market Watch proposal (a passed
+      // matter approves it through the market_watch_proposal act instead)
+      'POST /market-watch/proposals/:id/decide',
     ]) }),
   Object.freeze({ key: 'disputes', name: 'Disputes', gate: 'security.report.adjudicate',
     today: 'whoever may judge reports', acts: Object.freeze([

package/modules/government/routes/government.js

@@ -131,6 +131,8 @@ const governmentPort = {
   // the constitution in force. And the founding band's read: per stage, what it
   // is waiting on. A pass is announced as `board.genesis_stage.passed`.
   openGenesisStageClose: board.openGenesisStageClose,
+  // task 1004941: POST /government/board/matters' own openMatter, for a module's proposal (callers gate on board.item.open)
+  openMatter: board.openMatter,
   // task 1004427 (BV2.PS13): the genesis charter + legislation choice, filed as
   // an ordinary amendment under the constitution in force — for the genesis
   // home, which renders the stages from GET /government/constitution's

package/modules/hall-ui/public/market-watch-rules-lib.js

@@ -0,0 +1,207 @@
+// market-watch-rules-lib.js — the Market Watch rules page's markup, pure (task 1004941).
+//
+// Built to docs/design/mocks/market-watch/rules.html, option C, the pipeline map: a
+// version slider (v1 to the version in use, plus the proposed next one), the five steps
+// as a row of nodes (searches → sources → names → scoring → brief), the tapped step's
+// rules in plain words with its open proposals, and the cost of one run by step.
+//
+// Every string here comes from the server's GET /market-watch/rules and much of it is
+// member-typed (reasons, names, searches), so every one goes through `esc`; nothing is
+// inserted as HTML. Node-require-safe: no document, no fetch, so a test renders the real
+// markup from a real view.
+(function (root) {
+  'use strict';
+
+  const ASK = () => (root && root.OTBAsk) || (typeof require === 'function' ? require('./hall-ask.js') : null);
+  const money = (n) => `$${(Number(n) || 0).toFixed(2)}`;
+
+  // The slider's stops: every version that was in use, then the proposed next one.
+  function stops(view) {
+    const out = (view.history || []).map((h) => ({
+      version: h.version, kind: h.status === 'active' ? 'now' : 'past', summary: h.summary, changed: h.changed || [], rules: h.rules, entry: h,
+    }));
+    if (view.next) {
+      out.push({
+        version: view.next.version,
+        kind: 'next',
+        summary: view.next.applied === 1 ? 'if you approve the proposal' : `if you approve all ${view.next.applied} proposals`,
+        changed: view.next.changed || [],
+        rules: view.next.rules,
+      });
+    }
+    return out;
+  }
+
+  function stopLabel(stop) {
+    if (!stop) return '';
+    return `v${stop.version}${stop.kind === 'now' ? ' · now' : stop.kind === 'next' ? ' · proposed' : ''}`;
+  }
+
+  function sliderHtml(view, at, esc) {
+    const s = stops(view);
+    if (!s.length) return '';
+    const i = Math.max(0, Math.min(s.length - 1, at));
+    const cur = s[i];
+    const pill = cur.kind === 'now' ? 'in use' : cur.summary || '';
+    const ticks = s.map((x) => `<span>v${esc(x.version)}${x.kind === 'next' ? '?' : ''}</span>`).join('');
+    return `<div class="mwr-time">`
+      + `<span class="mwr-mono" id="mwr-vl">${esc(stopLabel(cur))}</span>`
+      + `<input type="range" id="mwr-v" min="0" max="${s.length - 1}" value="${i}" aria-label="rules version"${s.length < 2 ? ' disabled' : ''}>`
+      + `<span class="mwr-pill${cur.kind === 'now' ? ' mwr-pill--hot' : ''}" id="mwr-vs">${esc(pill)}</span>`
+      + `</div><div class="mwr-ticks" aria-hidden="true">${ticks}</div>`;
+  }
+
+  // The five nodes. `changed` marks the steps the slider's version changed.
+  function pipelineHtml(view, { open, changed = [] }, esc) {
+    return (view.steps || []).map((s, i) => {
+      const cls = `mwr-node${changed.includes(s.key) ? ' mwr-node--changed' : ''}`;
+      const badge = s.open ? `<span class="mwr-badge" aria-label="${esc(s.open)} open proposals">${esc(s.open)}</span>` : '';
+      const node = `<button type="button" class="${cls}" data-step="${esc(s.key)}" aria-pressed="${s.key === open}">`
+        + `<span class="mwr-node__k">${esc(s.label)}</span><span class="mwr-node__v">${esc(s.value)}</span>`
+        + `<span class="mwr-node__s">${esc(s.sub)}</span>${badge}</button>`;
+      return node + (i < view.steps.length - 1 ? '<span class="mwr-arrow" aria-hidden="true">&rarr;</span>' : '');
+    }).join('');
+  }
+
+  // A step's rules, as the chosen version has them.
+  function rulesBodyHtml(step, rules, view, esc) {
+    const r = rules || {};
+    const rows = (list) => (list && list.length
+      ? `<ul class="mwr-rows">${list.map((x) => `<li class="mwr-row"><span class="mwr-grow">${esc(x)}</span></li>`).join('')}</ul>`
+      : '<p class="mwr-empty">Nothing here yet.</p>');
+    if (step === 'searches') return rows(r.search_queries);
+    if (step === 'sources') return rows(r.sources);
+    if (step === 'brief') return r.instructions ? `<pre class="mwr-pre">${esc(r.instructions)}</pre>` : '<p class="mwr-empty">No brief yet.</p>';
+    if (step === 'scoring') {
+      const kinds = Object.keys(r.rubric || {}).sort();
+      if (!kinds.length) return '<p class="mwr-empty">Nothing is scored yet.</p>';
+      return kinds.map((kind) => `<p class="mwr-sub">${esc(kind === 'competitor' ? 'competitors' : kind === 'partner' ? 'partners' : kind)}</p>`
+        + `<ul class="mwr-rows">${(r.rubric[kind] || []).map((d) => {
+          const w = Number.isInteger(d.weight) ? d.weight : 1;
+          return `<li class="mwr-row" title="${esc(d.definition || '')}"><span class="mwr-grow">${esc(d.label || d.key)}</span><span class="mwr-mono">×${esc(w)}</span></li>`;
+        }).join('')}</ul>`).join('');
+    }
+    // names: the people's list, not a rules field
+    const step3 = (view.steps || []).find((s) => s.key === 'names');
+    const top = (step3 && step3.rules && step3.rules.top) || [];
+    if (!top.length) return '<p class="mwr-empty">Nothing is watched yet.</p>';
+    const more = step3.value - top.length;
+    return `<ul class="mwr-rows">${top.map((t) => `<li class="mwr-row"><span class="mwr-grow">${esc(t.name)}</span>`
+      + `<span class="mwr-pill${t.overall != null && t.overall >= 6 ? ' mwr-pill--hot' : ''}">${t.overall == null ? '' : esc(t.overall)}${t.kind === 'competitor' ? '' : ` · ${esc(t.kind)}`}</span></li>`).join('')}`
+      + `${more > 0 ? `<li class="mwr-row mwr-faint">+ ${esc(more)} more</li>` : ''}</ul>`;
+  }
+
+  // One open proposal. A card only for a reader who can act on it (the owner decides;
+  // where the government decides, anyone who may open a matter can send it to the vote);
+  // everyone else reads it as one line.
+  function proposalHtml(p, view, esc) {
+    const d = view.decide || {};
+    const nextV = view.active ? view.active.version + 1 : 1;
+    const q = /[?]$/.test(p.summary) ? p.summary : `${p.summary}?`;
+    const where = `proposal from ${p.by || 'a member'}`;
+    if (p.at_vote) {
+      return `<li class="mwr-row mwr-prop"><span class="mwr-dot" aria-hidden="true"></span><span class="mwr-grow">${esc(q)} <span class="mwr-faint">· ${esc(p.reason)}</span></span><span class="mwr-pill">at a vote</span></li>`;
+    }
+    const opts = [];
+    if (d.viewer_may_decide) {
+      opts.push({ label: 'Approve', result: p.kind === 'rule_change' ? `becomes v${nextV}` : 'takes effect now', rec: true, attrs: { 'data-act': 'approve', 'data-id': p.id } });
+    }
+    if (d.may_put_to_vote) opts.push({ label: 'Put to a vote', result: d.who ? `decided by ${d.who}` : 'the government decides', attrs: { 'data-act': 'vote', 'data-id': p.id } });
+    if (d.viewer_may_decide) opts.push({ label: 'Decline', result: 'stays in history', attrs: { 'data-act': 'decline', 'data-id': p.id } });
+    const ask = ASK();
+    if (!opts.length || !ask) {
+      return `<li class="mwr-row mwr-prop"><span class="mwr-dot" aria-hidden="true"></span><span class="mwr-grow">${esc(q)} <span class="mwr-faint">· ${esc(p.by || 'a member')}: ${esc(p.reason)}</span></span><span class="mwr-pill">waiting</span></li>`;
+    }
+    return ask.html({ tag: 'li', where, q, said: p.reason, row: true, opts, attrs: { 'data-proposal': p.id } });
+  }
+
+  function panelHtml(view, step, stop, esc) {
+    const s = (view.steps || []).find((x) => x.key === step);
+    if (!s) return '';
+    const props = (view.proposals || []).filter((p) => p.step === step);
+    // who we watch is not versioned with the rules, so the slider does not date it
+    const viewing = stop && stop.kind !== 'now' && step !== 'names' ? `<p class="mwr-faint mwr-viewing">as of ${esc(stopLabel(stop))}</p>` : '';
+    return `<h2 class="mwr-panel__h">${esc(s.title)}</h2>${viewing}`
+      + rulesBodyHtml(step, stop ? stop.rules : null, view, esc)
+      + (props.length ? `<ul class="mwr-props">${props.map((p) => proposalHtml(p, view, esc)).join('')}</ul>` : '')
+      + `<div class="mwr-propose"><button type="button" class="mwr-btn" data-act="propose" data-step="${esc(step)}" aria-expanded="false">propose a change</button></div>`
+      + '<div class="mwr-form-slot" id="mwr-form-slot"></div>';
+  }
+
+  // The form for one step's change. Selects carry only values the server's own check
+  // accepts; the server checks again.
+  function formHtml(view, step, esc) {
+    const active = (view.history || []).find((h) => h.status === 'active');
+    const r = (active && active.rules) || {};
+    const opt = (v, label) => `<option value="${esc(v)}">${esc(label)}</option>`;
+    const reason = '<label class="mwr-field"><span>why</span><input name="reason" maxlength="500" required placeholder="one line"></label>';
+    let body = '';
+    if (step === 'searches' || step === 'sources') {
+      const list = step === 'searches' ? (r.search_queries || []) : (r.sources || []);
+      body = `<label class="mwr-field"><span>change</span><select name="op">${opt('add', step === 'searches' ? 'add a search' : 'add a source')}${list.length ? opt('remove', 'remove one') : ''}</select></label>`
+        + `<label class="mwr-field" data-for="add"><span>${step === 'searches' ? 'search for' : 'read'}</span><input name="text" maxlength="300"></label>`
+        + (list.length ? `<label class="mwr-field" data-for="remove" hidden><span>remove</span><select name="pick">${list.map((x) => opt(x, x)).join('')}</select></label>` : '');
+    } else if (step === 'names') {
+      body = `<label class="mwr-field"><span>name</span><input name="name" maxlength="200" required></label>`
+        + `<label class="mwr-field"><span>kind</span><select name="kind">${opt('competitor', 'competitor')}${opt('partner', 'partner')}${opt('topic', 'topic')}</select></label>`
+        + '<label class="mwr-field"><span>link</span><input name="url" type="url" maxlength="500" placeholder="https://"></label>'
+        + '<label class="mwr-field"><span>why watch it</span><input name="why" maxlength="500"></label>';
+    } else if (step === 'scoring') {
+      const dims = [];
+      for (const kind of Object.keys(r.rubric || {}).sort()) {
+        for (const d of r.rubric[kind] || []) dims.push(opt(`${kind}|${d.key}`, `${d.label || d.key} (${kind})`));
+      }
+      body = `<label class="mwr-field"><span>score</span><select name="dim">${dims.join('')}</select></label>`
+        + `<label class="mwr-field"><span>counts</span><select name="weight">${[0, 1, 2, 3].map((w) => opt(w, w ? `×${w}` : 'not at all')).join('')}</select></label>`;
+    } else if (step === 'brief') {
+      body = `<label class="mwr-field mwr-field--wide"><span>the brief</span><textarea name="text" rows="4" maxlength="4000">${esc(r.instructions || '')}</textarea></label>`;
+    }
+    return `<form class="mwr-form" data-step="${esc(step)}">${body}${reason}`
+      + '<div class="mwr-form__go"><button type="submit" class="mwr-btn mwr-btn--go">send the proposal</button><button type="button" class="mwr-btn" data-act="cancel">cancel</button></div></form>';
+  }
+
+  // The form's fields → the { step, change, reason } the server takes.
+  function proposalFromForm(step, f) {
+    const v = (k) => (f[k] == null ? '' : String(f[k]));
+    let change;
+    if (step === 'searches' || step === 'sources') change = v('op') === 'remove' ? { op: 'remove', text: v('pick') } : { op: 'add', text: v('text') };
+    else if (step === 'names') change = { op: 'add', name: v('name'), kind: v('kind'), url: v('url'), why: v('why') };
+    else if (step === 'scoring') {
+      const [kind, key] = v('dim').split('|');
+      change = { op: 'weight', kind, key, weight: Number(v('weight')) };
+    } else change = { op: 'set', text: v('text') };
+    return { step, change, reason: v('reason') };
+  }
+
+  function costHtml(cost, esc) {
+    if (!cost) return '';
+    const rows = cost.rows.map((r) => `<li class="mwr-row"><span class="mwr-grow">${esc(r.label)}</span><span class="mwr-mono">${esc(money(r.usd))}</span></li>`).join('');
+    const note = cost.basis === 'run'
+      ? `run ${esc(cost.run && cost.run.n != null ? cost.run.n : '')} cost ${esc(money(cost.total))}${cost.run && cost.run.cost_log_usd != null ? ` (cost log ${esc(money(cost.run.cost_log_usd))})` : ''}; the split by step is an estimate`
+      : `estimate: no run has cost anything yet, so these are ${esc(money(cost.total))} from the planning figures`;
+    return `<ul class="mwr-rows">${rows}</ul><p class="mwr-note">${note}</p>`;
+  }
+
+  const ERRORS = Object.freeze({
+    owner_only: 'Only the project owner can decide this.',
+    decided_by_sitting: 'The government decides this one. Put it to a vote.',
+    already_proposed: 'That change is already waiting.',
+    already_there: 'The rules already have that.',
+    not_there: 'The rules do not have that.',
+    no_change: 'That is how the rules already are.',
+    reason_required: 'Say why in one line.',
+    too_many_open: 'You have twenty proposals waiting. Wait for some to be decided.',
+    url_required: 'Add the link to its site.',
+    bad_url: 'That link does not look right.',
+    name_required: 'Give it a name.',
+    text_required: 'Write something first.',
+    no_longer_applies: 'The rules changed since this was proposed. Decline it and propose again.',
+    no_government: 'This project has no government; the owner decides.',
+    already_at_vote: 'It is already at a vote.',
+  });
+  const errorText = (code, fallback) => ERRORS[code] || fallback || 'That did not work. Try again.';
+
+  const lib = { stops, stopLabel, sliderHtml, pipelineHtml, rulesBodyHtml, proposalHtml, panelHtml, formHtml, proposalFromForm, costHtml, errorText };
+  if (typeof module !== 'undefined' && module.exports) module.exports = lib;
+  if (root) root.OTBMarketWatchRules = lib;
+})(typeof window !== 'undefined' ? window : null);

package/modules/hall-ui/public/market-watch-rules.css

@@ -0,0 +1,68 @@
+/* market-watch-rules.css — the Market Watch rules page (task 1004941), built to
+   docs/design/mocks/market-watch/rules.html, option C (the pipeline map), on the hall's
+   own tokens rather than the mockup's literal colours and fonts. Everything is under the
+   `mwr-` prefix; the proposal card is the hall's ask card (hall-ask.css). */
+
+.mwr { max-width: 1000px; margin: 0 auto; padding: 4px 0 48px; color: var(--ink); }
+.mwr-mono { font-family: var(--font-mono); font-size: 12.5px; }
+.mwr-faint { color: var(--ink-faint); }
+.mwr-empty { color: var(--ink-soft); margin: 8px 0; }
+
+/* the version slider */
+.mwr-time { display: flex; align-items: center; gap: 12px; margin-top: 6px; }
+.mwr-time .mwr-mono { flex: none; white-space: nowrap; }
+.mwr-time input { flex: 1; min-width: 0; height: 24px; margin: 0; accent-color: var(--accent); }
+.mwr-ticks { display: flex; justify-content: space-between; font-family: var(--font-mono); font-size: 11.5px; color: var(--ink-faint); padding: 0 4px; }
+.mwr-pill { font-size: 12px; padding: 2px 9px; border-radius: 999px; border: 1px solid var(--border); color: var(--ink-soft); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; max-width: 50%; }
+.mwr-pill--hot { background: var(--accent-tint); border-color: transparent; color: var(--accent-ink); }
+
+/* the pipeline: five steps you tap */
+.mwr-pipe { display: flex; align-items: stretch; overflow-x: auto; padding: 14px 8px 14px 2px; margin-top: 8px; scrollbar-width: thin; }
+.mwr-node { flex: none; width: 150px; border: 1px solid var(--border); border-radius: 18px; padding: 12px; background: var(--bg-card); color: var(--ink); cursor: pointer; text-align: left; position: relative; display: flex; flex-direction: column; gap: 4px; font: inherit; }
+.mwr-node:hover { border-color: var(--border-strong); }
+.mwr-node:focus-visible { outline: 2px solid var(--focus, var(--accent)); outline-offset: 3px; }
+.mwr-node__k { font-size: 12px; color: var(--ink-faint); }
+.mwr-node__v { font-size: 22px; font-weight: 300; letter-spacing: -0.02em; }
+.mwr-node__s { font-size: 12.5px; color: var(--ink-soft); }
+.mwr-node[aria-pressed="true"] { border-color: var(--ink); box-shadow: 0 0 0 1px var(--ink); }
+.mwr-node--changed { background: var(--accent-tint); }
+.mwr-badge { position: absolute; top: -7px; right: -7px; min-width: 20px; height: 20px; padding: 0 6px; border-radius: 10px; background: var(--accent); color: var(--accent-on); font-size: 11px; font-weight: 600; display: grid; place-items: center; box-sizing: border-box; }
+.mwr-arrow { flex: none; width: 28px; display: grid; place-items: center; color: var(--ink-faint); line-height: 1; }
+/* on a phone the steps stack, and the arrow between them points down */
+@media (max-width: 640px) {
+  .mwr-pipe { flex-direction: column; overflow-x: visible; padding-right: 8px; }
+  .mwr-node { width: 100%; flex-direction: row; align-items: baseline; gap: 10px; }
+  .mwr-node__v { font-size: 18px; }
+  .mwr-arrow { width: auto; height: 20px; font-size: 0; }
+  .mwr-arrow::after { content: "\2193"; font-size: 15px; line-height: 20px; }
+}
+
+/* the tapped step */
+.mwr-panel { border: 1px solid var(--border); border-radius: 20px; padding: 16px; margin-top: 8px; background: var(--bg-card); }
+.mwr-panel__h { margin: 0 0 8px; font-weight: 300; font-size: 21px; letter-spacing: -0.02em; }
+.mwr-viewing { margin: -4px 0 8px; font-size: 13px; }
+.mwr-sub { margin: 12px 0 4px; font-size: 12px; letter-spacing: 0.06em; color: var(--ink-faint); }
+.mwr-pre { white-space: pre-wrap; font-family: var(--font-mono); font-size: 12.5px; color: var(--ink-soft); margin: 0; }
+.mwr-rows { list-style: none; margin: 0; padding: 0; border-top: 1px solid var(--rule-soft, var(--border)); }
+.mwr-row { display: flex; align-items: center; gap: 12px; min-height: 46px; padding: 8px 2px; border-bottom: 1px solid var(--rule-soft, var(--border)); white-space: nowrap; overflow: hidden; }
+.mwr-grow { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; }
+.mwr-props { list-style: none; margin: 14px 0 0; padding: 0; }
+.mwr-prop .mwr-pill { flex: none; max-width: none; }
+.mwr-dot { flex: none; width: 7px; height: 7px; border-radius: 50%; background: var(--accent); }
+.mwr-propose { margin-top: 12px; }
+
+/* buttons and the proposal form */
+.mwr-btn { border: 1px solid var(--border-strong); background: transparent; color: var(--ink); border-radius: 999px; padding: 7px 14px; cursor: pointer; font: inherit; font-weight: 500; font-size: 14px; white-space: nowrap; }
+.mwr-btn:hover { background: var(--hask-chip-pick, var(--bg-frame)); }
+.mwr-btn--go { background: var(--accent); border-color: var(--accent); color: var(--accent-on); }
+.mwr-btn--go:hover { background: var(--accent); filter: brightness(1.05); }
+.mwr-form { display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 10px 12px; margin-top: 12px; }
+.mwr-field { display: flex; flex-direction: column; gap: 4px; font-size: 13px; color: var(--ink-soft); min-width: 0; }
+.mwr-field--wide { grid-column: 1 / -1; }
+.mwr-field[hidden] { display: none; }
+.mwr-field input, .mwr-field select, .mwr-field textarea { font: inherit; font-size: 14px; color: var(--ink); background: var(--bg); border: 1px solid var(--border); border-radius: 10px; padding: 8px 10px; min-width: 0; box-sizing: border-box; width: 100%; }
+.mwr-form__go { grid-column: 1 / -1; display: flex; gap: 8px; flex-wrap: wrap; }
+
+/* the cost of one run */
+.mwr-lbl { font-size: 12px; letter-spacing: 0.06em; color: var(--ink-faint); margin: 26px 0 8px; font-weight: 400; }
+.mwr-note { margin: 8px 0 0; font-size: 12.5px; color: var(--ink-faint); }

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

@@ -0,0 +1,54 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Market Watch rules — {{worldName}}</title>
+  <meta name="description" content="How the weekly market watch works, step by step, in plain words: what it searches, what it reads, who it watches, how it scores and what it writes. Propose a change with a reason.">
+  <link rel="icon" href="data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'><text x='16' y='24' font-size='24' text-anchor='middle' font-family='sans-serif'>⌂</text></svg>">
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link rel="stylesheet" href="/builders/style.css?v=2026-07-02-shell1">
+  <link rel="stylesheet" href="/builders/hall-ask.css">
+  <link rel="stylesheet" href="/builders/market-watch-rules.css">
+</head>
+<body data-page="market-watch-rules" data-page-title="Market Watch rules">
+
+<div class="app">
+  <aside class="app-sidebar" id="app-sidebar" aria-label="Primary"></aside>
+  <div class="app-scrim" id="app-scrim" hidden></div>
+  <div class="app-body">
+    <header class="app-topbar" id="app-topbar"></header>
+    <div class="app-content">
+      <!-- The page's one h1, for screen readers: no page shows its head (task 1004836). -->
+      <div class="page-head page-head--room">
+        <h1 class="page-head__h">Market Watch rules</h1>
+      </div>
+
+      <main id="hall-main" class="mwr">
+        <div id="mwr-slider"></div>
+        <div class="mwr-pipe" id="mwr-pipe" aria-label="the watch, step by step"></div>
+        <section class="mwr-panel" id="mwr-panel" aria-live="polite"><p class="mwr-empty">Loading the watch rules…</p></section>
+        <h2 class="mwr-lbl">cost of one run, by step</h2>
+        <div id="mwr-cost"></div>
+      </main>
+
+      <footer class="app-foot" id="app-foot"></footer>
+    </div>
+  </div>
+</div>
+
+<div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
+
+<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>
+<!-- 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>
+<script src="/builders/hall-ask.js"></script>
+<script src="/builders/market-watch-rules-lib.js"></script>
+<script src="/builders/market-watch-rules.js"></script>
+</body>
+</html>