@bongos/core 1.24.11 → 1.24.12

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

@@ -0,0 +1,129 @@
+// market-watch.js — the Market Watch home, the watchtower desk (task 1004939; design of
+// record docs/design/mocks/market-watch/home.html, option D). One read,
+// GET /market-watch/home, which every signed-in member may make. Where the module is off
+// its routes do not exist, so the page shows its quiet off state rather than an error.
+(() => {
+  'use strict';
+
+  const MW = window.OTBMarketWatch;
+  const esc = MW.esc;
+  const $ = (id) => document.getElementById(id);
+  const toast = (m) => (window.OTB && window.OTB.toast ? window.OTB.toast(m, { duration: 1800, clear: true }) : null);
+  let HOME = null;
+
+  function show(id) {
+    $('mw-loading').hidden = true;
+    for (const k of ['mw-off', 'mw-fail', 'mw-desk']) $(k).hidden = k !== id;
+  }
+  function moduleOff() {
+    const m = window.__MODULES__;
+    return !!(m && m.enabled && 'market-watch' in m.enabled && m.enabled['market-watch'] !== true);
+  }
+
+  function renderScouts(h) {
+    const weeks = h.weeks_watched;
+    $('mw-watched').innerHTML = `<i class="mw-dot" style="background:var(--accent)" aria-hidden="true"></i> <b>${weeks}</b> ${weeks === 1 ? 'week' : 'weeks'} watched`;
+    $('mw-scouts').innerHTML = h.scouts.map((s) => `<div class="mw-scout">
+      <span class="mw-scout__ic" aria-hidden="true">${MW.KIND_ICON[s.kind]}</span>
+      <span class="mw-scout__t">${MW.KIND_PLURAL[s.kind]}<br><span class="mw-scout__lv">${s.watched} watched${s.level ? ` · lvl ${s.level}` : ''}</span></span>
+      <span class="mw-badge${s.reports ? '' : ' mw-badge--none'}" title="${s.reports} with a report this week">${s.reports}</span></div>`).join('');
+    $('mw-streak').innerHTML = h.streak.length
+      ? h.streak.map((r) => `<i class="${r.ran ? '' : 'no'}" title="${r.ran ? `run ${r.n} · ${MW.fmtDay(r.date)}` : `skipped · ${MW.fmtDay(r.date)}`}"></i>`).join('')
+      : '<span class="mw-quiet">no runs yet</span>';
+    const pins = MW.pins.all();
+    $('mw-pins').hidden = !pins.length;
+    $('mw-pin-list').innerHTML = pins.map((p) => `<div class="mw-pin-row"><span aria-hidden="true">${MW.KIND_ICON[p.kind] || ''}</span><a class="mw-one" href="${MW.itemHref(p.id)}">${esc(p.name)}</a></div>`).join('');
+  }
+
+  function renderScope() {
+    $('mw-scope').innerHTML = MW.scopeSvg(HOME, $('mw-ax').value, $('mw-ay').value);
+  }
+  function initAxes(h) {
+    const opts = h.axes.map((a) => `<option value="${esc(a.key)}">${esc(a.label)}</option>`).join('');
+    $('mw-ax').innerHTML = opts;
+    $('mw-ay').innerHTML = opts;
+    // The mockup opens on open-source ethos across, contributor economy up.
+    const has = (k) => h.axes.some((a) => a.key === k);
+    $('mw-ax').value = has('open_source_ethos') ? 'open_source_ethos' : h.axes[0].key;
+    $('mw-ay').value = has('contributor_economy') ? 'contributor_economy' : (h.axes[1] || h.axes[0]).key;
+    $('mw-ax').onchange = renderScope;
+    $('mw-ay').onchange = renderScope;
+    // A dot is a picture, not a control (36 of them would be 36 undersized links); a
+    // click on one opens its file, and the picker below reaches every item by name.
+    $('mw-scope').addEventListener('click', (ev) => {
+      const blip = ev.target.closest && ev.target.closest('[data-id]');
+      if (blip) window.location.assign(MW.itemHref(blip.getAttribute('data-id')));
+    });
+    const groups = ['competitor', 'partner', 'topic'].map((k) => {
+      const mine = (h.index || []).filter((i) => i.kind === k);
+      return mine.length ? `<optgroup label="${MW.KIND_PLURAL[k]}">${mine.map((i) => `<option value="${i.id}">${esc(i.name)}</option>`).join('')}</optgroup>` : '';
+    }).join('');
+    $('mw-open').innerHTML = `<option value="">pick one…</option>${groups}`;
+    $('mw-open').onchange = () => { if ($('mw-open').value) window.location.assign(MW.itemHref($('mw-open').value)); };
+  }
+
+  function renderSweep(h) {
+    const s = MW.nextSweep(h);
+    $('mw-cd').textContent = s.big;
+    $('mw-when').textContent = s.small;
+    const b = h.budget;
+    const used = b.cap_usd > 0 ? Math.min(100, Math.round((b.spent_usd / b.cap_usd) * 100)) : 0;
+    $('mw-tank-fill').style.height = `${used}%`;
+    $('mw-tank').title = `${MW.money(b.spent_usd)} of ${MW.money(b.cap_usd)} used this month`;
+    $('mw-left').textContent = `${MW.money(b.left_usd)} left`;
+  }
+
+  function renderReports(h) {
+    const read = new Set(MW.reads.get());
+    const total = h.reports.length;
+    const count = () => h.reports.filter((r) => read.has(String(r.id))).length;
+    const bar = () => {
+      const n = count();
+      $('mw-xpn').textContent = `${n}/${total}`;
+      $('mw-xpb').style.width = total ? `${(n / total) * 100}%` : '0';
+    };
+    $('mw-reps').innerHTML = total
+      ? h.reports.map((r) => `<div class="mw-rep${read.has(String(r.id)) ? ' done' : ''}" data-id="${r.id}">
+          <span class="mw-rep__ic" aria-hidden="true">${MW.KIND_ICON[r.kind]}</span>
+          <a class="mw-rep__t" href="${MW.itemHref(r.item_id)}" title="${esc(r.takeaway)}"><b>${esc(r.item_name)}</b> · ${esc(r.takeaway)}</a>
+          <button type="button" aria-label="Mark the ${esc(r.item_name)} report read">ok</button></div>`).join('')
+      : '<p class="mw-quiet">No reports this week yet.</p>';
+    bar();
+    $('mw-reps').querySelectorAll('.mw-rep button').forEach((btn) => {
+      btn.addEventListener('click', () => {
+        const row = btn.closest('.mw-rep');
+        if (row.classList.contains('done')) return;
+        row.classList.add('done');
+        MW.reads.add(row.dataset.id);
+        read.add(row.dataset.id);
+        bar();
+        toast(count() === total ? 'All caught up — every report read' : '+1 report read');
+      });
+    });
+  }
+
+  async function load() {
+    if (moduleOff()) return show('mw-off');
+    let res;
+    try {
+      res = await fetch('/api/bongos/market-watch/home', { credentials: 'same-origin' });
+    } catch (e) {
+      return show('mw-fail');
+    }
+    if (res.status === 401) { window.location.assign(`/api/bongos/auth/web/start?return=${encodeURIComponent(window.location.pathname)}`); return; }
+    if (res.status === 404) return show('mw-off'); // the module's routes are not mounted
+    if (!res.ok) return show('mw-fail');
+    HOME = await res.json();
+    show('mw-desk');
+    renderScouts(HOME);
+    initAxes(HOME);
+    renderScope();
+    renderSweep(HOME);
+    renderReports(HOME);
+  }
+
+  $('mw-send').addEventListener('click', () => {
+    MW.openPropose('scout', {}, () => toast('Scout proposed — the government will decide'));
+  });
+  document.addEventListener('DOMContentLoaded', load);
+})();

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

@@ -0,0 +1,14 @@
+{
+  "_": "MARKET WATCH HOME, the watchtower desk (task 1004939; design of record docs/design/mocks/market-watch/home.html, option D). One read, GET /market-watch/home. Against the kit's own stub it 404s, which the page reads as the module being off, so the stub render is the quiet off state. The populated desk needs the hall-preview harness with the module reported on; its market-watch__home.json fixture was built from the committed 2026-10-28 seed through the real shapes (tests/fixtures/market-watch-seed-rows.cjs):\n\n  node scripts/hall-preview/server.js --port 4639 --fixture-me --modules-on market-watch\n  node modules/ui-design/kit/render.js --states modules/hall-ui/public/market-watch.states.json --base-in http://localhost:4639 --base-out http://localhost:4639",
+  "page": "/builders/market-watch",
+  "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": {
+    "desk": { "auth": true, "actions": [["wait", 900], ["clickIfVisible", "[data-craft-close]"], ["wait", 200]], "expect": { "visible": ["#mw-desk", "#mw-scope svg"] } },
+    "out": { "auth": false, "actions": [["wait", 600], ["clickIfVisible", "[data-craft-close]"]] }
+  },
+  "reducedMotion": { "auth": true, "actions": [["wait", 900], ["clickIfVisible", "[data-craft-close]"], ["wait", 200]] }
+}

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

@@ -128,7 +128,7 @@
 <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-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch-pages"></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

@@ -62,7 +62,7 @@
 <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-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch-pages"></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

@@ -113,7 +113,7 @@
 <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-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch-pages"></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

@@ -208,7 +208,7 @@
 <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-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch-pages"></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

@@ -72,7 +72,7 @@
 <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-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch-pages"></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

@@ -74,7 +74,7 @@
 <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-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch-pages"></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

@@ -44,7 +44,7 @@
 <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-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch-pages"></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

@@ -56,7 +56,7 @@
 <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-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch-pages"></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

@@ -112,7 +112,7 @@
 <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-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch-pages"></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

@@ -487,7 +487,7 @@
 <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-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch-pages"></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

@@ -101,6 +101,7 @@
     // the zen-garden reading of "a place an artist wants to be", so it does not
     // reuse a glyph that would read as one more docs/goals page.
     studio: '<path d="M9 15.5V8.5"/><path d="M9 8.5C9 5.5 6.5 3.5 3.5 3.5c0 3 2.5 5 5.5 5Z"/><path d="M9 10C9 7.5 11.2 5.5 14 5.5c0 2.7-2.2 4.5-5 4.5Z"/>',
+    marketwatch: '<circle cx="9" cy="9" r="6.5"/><path d="M9 9 13.6 4.4"/><path d="M9 5.2a3.8 3.8 0 1 0 3.8 3.8"/><circle cx="11.6" cy="11.2" r="0.9" fill="currentColor"/>',
     // You
     accomplishments: '<path d="M6 2.5l1.6 4.2M12 2.5l-1.6 4.2"/><circle cx="9" cy="10.8" r="4.2"/><circle cx="9" cy="10.8" r="1.8"/>',
     profile: '<rect x="2.5" y="4" width="13" height="10" rx="1.5"/><circle cx="6.3" cy="8" r="1.6"/><path d="M4.1 12c.3-1.1 1.1-1.7 2.2-1.7s1.9.6 2.2 1.7"/><path d="M10.4 7.5h3M10.4 10.3h3"/>',
@@ -280,6 +281,7 @@
       // the artist. NO module gate: it degrades to reviews alone on an instance
       // without copy-desk, rather than vanishing.
       { id: 'studio', label: 'Studio', icon: 'studio', href: '/studio', gate: 'signed' },
+      { id: 'market-watch', label: 'Market Watch', icon: 'marketwatch', href: '/market-watch', gate: 'signed', module: 'market-watch' }, // task 1004939: 'signed' is its page floor; dropped where the module is off
     ] },
     // Your own numbers. task 2174 folded Achievements into Standing and this task
     // retires its nav entry; VIEW_ALIASES still routes #achievements here, so old
@@ -428,7 +430,6 @@
   }
 
   // ---------- render ----------
-
   function renderSidebar() {
     var el = document.getElementById('app-sidebar');
     if (!el) return;
@@ -1472,7 +1473,7 @@
     // task 1004430: someone else's profile belongs to Builders, not to your own
     // Profile; probeMe hands the mark back if the id turns out to be yours.
     var otherProfile = path === '/profile' && /(^|[?&])id=/.test(window.location.search || '');
-    if (otherProfile) path = '/roster';
+    if (otherProfile) path = '/roster'; else if (/^\/market-watch-(item|rules)$/.test(path)) path = '/market-watch'; // task 1004939
     document.querySelectorAll('#app-sidebar .nav-item').forEach(function (a) {
       var target = a.getAttribute('href');
       if (target && !a.dataset.view && target === path) a.classList.add('nav-item--active');

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

@@ -231,7 +231,7 @@
 <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-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch-pages"></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

@@ -219,7 +219,7 @@
 <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-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch-pages"></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

@@ -59,7 +59,7 @@
 <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-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch-pages"></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

@@ -141,7 +141,7 @@
 <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-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch-pages"></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

@@ -145,7 +145,7 @@
 <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-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch-pages"></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

@@ -166,7 +166,7 @@
 <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-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch-pages"></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

@@ -174,7 +174,7 @@
 <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-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-market-watch"></script>
+<script src="/builders/shell.js?v=2026-10-30-market-watch-pages"></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.md

@@ -0,0 +1,40 @@
+# Market Watch — the watchtower desk (/market-watch) and the dossier (/market-watch-item) (task 1004939)
+
+Goal 1000137, "Run a business in Bongos". The designs of record are the owner's picks of 2026-10-29:
+`docs/design/mocks/market-watch/home.html` (option D) and `item.html` (option B). Both pages ride
+`market-watch.css` plus `market-watch-lib.js` (the drawing both share), and read the market-watch
+module's one route file, `modules/market-watch/routes/pages.js`.
+
+**What the desk holds.** A link to the rules page (`/market-watch-rules`, task 1004941) under the streak; three scouts (competitors, partners, topics) as levelled cards, each with the
+number of its items reported this week as the badge; the run streak; the landscape, every competitor as a
+dot on two dimensions the viewer picks from the rules' own rubric (open-source ethos across and
+contributor economy up by default, as the mock opens); the next sweep with the budget left as a tank;
+and this week's reports, one per item, competitors and partners taken in turn because they are scored on
+different scales. A report row links to the item; "ok" marks it read for this viewer only.
+
+**What the dossier holds.** The item as a card that levels up run by run (level and streak are derived in
+`modules/market-watch/db.js`), the overall line and one sparkline per rubric dimension, why it is watched,
+its known facts, and the sortable case file (found, run, type, takeaway, confidence, source), filtered by type through the kit filter bar (`?type=` in the URL). Sparklines and the dimension bars are the kit's (`OTBKit.sparklineHtml`, `barSeriesHtml`); only the landscape scope is drawn here, since the kit has no scatter plot.
+
+**Decisions a later edit must keep.**
+
+- **No page head, no ask card.** The topbar names the page. Nothing here asks the reader to decide
+  something about the project, so there is no OTBAsk; proposals go to the government, which decides on
+  the rules page (task 1004941).
+- **A dot is a picture, not a control.** Thirty-six 6–14px links failed the 24px floor and would overlap
+  at phone width. A click on a dot opens its file; the "open a case file" picker under the landscape
+  reaches every item by name, partners and topics included.
+- **Every button that changes what is watched files a proposal.** Propose a change (re-score, move
+  between partner and competitor, add a source, correct an entry), Stop tracking (a `remove_item`) and
+  "+ send a new scout" (an `add_item`), each with a one-line reason. Nothing on these pages changes an
+  item, a score or an entry. The direction of a move comes from the item on the server, never the client.
+- **Pin and "read" are the viewer's own** (localStorage `mw-pins`, `mw-read`): conveniences, not the
+  record. Pinned items list under the scouts.
+- **"sweep now" is not here.** A manual run spends the project's AI budget, so it is the settings page's
+  (task 1004938) to offer with the cap beside it.
+- **Off is quiet.** Where the default-off module is not enabled the nav item is dropped, the page shows
+  one line pointing at Modules, and it asks the server nothing; a 404 from unmounted routes reads the same.
+
+**Verified** through `modules/ui-design/kit/render.js` against the hall-preview harness
+(`--fixture-me --modules-on market-watch`), whose `market-watch__*.json` fixtures were built from the
+committed seed through the real shapes. Tests: `tests/market_watch_pages.mjs`.

package/modules/market-watch/db.js

@@ -130,14 +130,16 @@ const FOUND_IN_SQL = `
     JOIN market_watch_items i ON i.id = e.item_id
    WHERE i.project = $1 AND e.run_id IS NOT NULL AND ($2::bigint IS NULL OR e.item_id = $2)`;
 
+// `knownRuns` (here, in getItem, caseFile and scoreHistory): the numbered runs when the caller
+// already read them, so one page load reads market_watch_runs once (task 1004939).
 // listItems — the home desk: every tracked item with its latest overall score, last
 // finding, level and streak.
-async function listItems(pool, { project, kind = null, includeRemoved = false, id = null } = {}) {
+async function listItems(pool, { project, kind = null, includeRemoved = false, id = null, knownRuns = null } = {}) {
   need(project);
   const [{ rows: items }, { rows: found }, runs] = await Promise.all([
     pool.query(ITEMS_SQL, [project, kind, includeRemoved, id]),
     pool.query(FOUND_IN_SQL, [project, id]),
-    numberedRuns(pool, { project }),
+    knownRuns || numberedRuns(pool, { project }),
   ]);
   const byItem = new Map();
   for (const f of found) {
@@ -154,8 +156,8 @@ async function listItems(pool, { project, kind = null, includeRemoved = false, i
 }
 
 // getItem — one item, with removed ones included (its page still opens).
-async function getItem(pool, { project, id }) {
-  const rows = await listItems(pool, { project, includeRemoved: true, id });
+async function getItem(pool, { project, id, knownRuns = null }) {
+  const rows = await listItems(pool, { project, includeRemoved: true, id, knownRuns });
   return rows[0] || null;
 }
 
@@ -168,11 +170,11 @@ const CASE_FILE_SQL = `
    ORDER BY e.pinned DESC, e.found_on DESC, e.id DESC`;
 
 // caseFile — the item page's sortable table: found, run, type, takeaway, confidence, source.
-async function caseFile(pool, { project, itemId }) {
+async function caseFile(pool, { project, itemId, knownRuns = null }) {
   need(project);
   const [{ rows }, runs] = await Promise.all([
     pool.query(CASE_FILE_SQL, [project, itemId]),
-    numberedRuns(pool, { project }),
+    knownRuns || numberedRuns(pool, { project }),
   ]);
   const runN = new Map(runs.map((r) => [String(r.id), r.n]));
   return rows.map((e) => ({ ...e, id: Number(e.id), run: e.run_id == null ? null : runN.get(String(e.run_id)) ?? null }));
@@ -185,11 +187,11 @@ const SCORES_SQL = `
    WHERE i.project = $1 AND s.item_id = $2`;
 
 // scoreHistory — the item page's sparklines, one per dimension plus 'overall'.
-async function scoreHistory(pool, { project, itemId }) {
+async function scoreHistory(pool, { project, itemId, knownRuns = null }) {
   need(project);
   const [{ rows }, runs] = await Promise.all([
     pool.query(SCORES_SQL, [project, itemId]),
-    numberedRuns(pool, { project }),
+    knownRuns || numberedRuns(pool, { project }),
   ]);
   return sparklines(rows, runs);
 }

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), 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.",
+  "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 home and tracked-item pages (task 1004939), 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,6 +15,7 @@
     "migrations": true,
     "routes": [
       "ask",
+      "pages",
       "rules",
       "settings"
     ],