@bongos/core 1.20.45 → 1.20.47

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

@@ -97,6 +97,15 @@
     return `<span class="ov-fact">upkeep <b>${escapeHtml(status)}</b></span>`;
   }
 
+  // A module installed from the store links the how-to its version shipped with
+  // (task 1004366). The server sets store_howto only for a published key@version,
+  // and only to a /builders/modules?howto= path, so anything else is dropped.
+  function howtoFact(m) {
+    const href = m.store_howto;
+    if (typeof href !== 'string' || !href.startsWith('/builders/modules?howto=')) return '';
+    return `<a class="ov-fact mod-howto" href="${escapeHtml(href)}">how-to</a>`;
+  }
+
   // The lines the row's details disclosure opens onto: the facts the payload
   // carries that the card never rendered — what the module contributes, the
   // core it needs, who maintains it and what it hands off to.
@@ -143,7 +152,7 @@
         <div class="ov-row__main">
           <span class="ov-row__title">${escapeHtml(m.title || m.key)}<span class="ov-mono">${escapeHtml(m.key)}</span></span>
           ${desc ? `<p class="ov-row__sub mod-row__desc">${escapeHtml(desc)}</p>` : ''}
-          <div class="ov-row__facts">${provenancePill(m)}${attributionFacts(m)}${upkeepFact(m)}</div>
+          <div class="ov-row__facts">${provenancePill(m)}${attributionFacts(m)}${upkeepFact(m)}${howtoFact(m)}</div>
           ${lines ? `<details class="mod-more"${openKeys.has(m.key) ? ' open' : ''}><summary aria-label="Details for ${escapeHtml(m.title || m.key)}"></summary>${lines}</details>` : ''}
         </div>
         <div class="ov-row__right mod-row__right">${rightHtml(m)}</div>
@@ -320,5 +329,88 @@
     }
   }
 
-  load();
+  // ---- one store version's how-to (task 1004366, ADR 0347) ----
+  //
+  // ?howto=<key>&version=<X.Y.Z> opens the HOWTO.md that version shipped with in
+  // place of the catalog. A query, not a #/ route: the hall's hash namespace is
+  // frozen to the idea and blocker overlays.
+
+  // The author wrote this file, so a link in it may point anywhere. Only an absolute
+  // http(s) link, a mailto: or an in-page #anchor becomes an <a>; a relative path
+  // means nothing outside the author's repo, so it renders as its text.
+  function howtoLinkHref(href) {
+    return /^(https?:\/\/|mailto:|#)/i.test(String(href || '')) ? href : null;
+  }
+
+  // The same rule the manifest schema enforces on howto.artifactUrl (an https link on
+  // claude.ai), checked again here because this page writes it into an href.
+  function isClaudeArtifactUrl(u) {
+    try {
+      const url = new URL(String(u));
+      return url.protocol === 'https:' && (url.hostname === 'claude.ai' || url.hostname.endsWith('.claude.ai'));
+    } catch (_) { return false; }
+  }
+
+  function howtoFail(message) {
+    const doc = $('#howto-doc');
+    if (doc) { doc.removeAttribute('aria-busy'); doc.innerHTML = kit.emptyStateHtml(message); }
+    const print = $('#howto-print');
+    if (print) print.hidden = true;
+  }
+
+  async function loadHowto(key, version) {
+    const catalog = $('#core-scroll');
+    if (catalog) catalog.hidden = true;
+    const sub = $('#modules-sub');
+    if (sub) sub.hidden = true;
+    // A how-to is a document, so the page opts into the reading room (room.css
+    // scopes its column width and article sizes to body.room).
+    document.body.classList.add('room');
+    const view = $('#howto-view');
+    if (view) view.hidden = false;
+    const print = $('#howto-print');
+    if (print) print.addEventListener('click', () => window.print());
+
+    const res = await api.request('GET', `${API}/store/modules/${encodeURIComponent(key)}/versions/${encodeURIComponent(version)}/howto`);
+    if (res.status === 401) { window.location.assign(`${API}/auth/web/start`); return; }
+    const body = res.data || {};
+    if (!res.ok) {
+      const err = body.error || {};
+      howtoFail((typeof err === 'object' && err.message) || body.message || `Could not load the how-to (${res.status}).`);
+      return;
+    }
+    const title = String(body.title || key);
+    document.title = `${title} ${body.version} — how-to`;
+    const h = $('#howto-h');
+    if (h) h.textContent = `${title} — how to use it`;
+    const meta = $('#howto-meta');
+    if (meta) {
+      meta.innerHTML = `<span class="ov-mono">${escapeHtml(key)}</span> · version <span class="ov-mono">${escapeHtml(String(body.version))}</span>`
+        + (body.delisted ? ' · <span class="fact-pill fact-pill--warn">delisted</span>' : '');
+    }
+    const extra = $('#howto-extra');
+    if (extra && body.artifact_url && isClaudeArtifactUrl(body.artifact_url)) {
+      extra.href = body.artifact_url;
+      extra.hidden = false;
+    }
+    const doc = $('#howto-doc');
+    if (doc) {
+      // HTML comments are the scaffold's writing prompts (ADR 0347 D2); they are
+      // not part of the how-to, so they are removed rather than shown as text.
+      const md = String(body.markdown || '').replace(/<!--[\s\S]*?-->/g, '');
+      doc.innerHTML = window.OTBMdReader.parseMarkdown(md, howtoLinkHref).html;
+      doc.removeAttribute('aria-busy');
+    }
+  }
+
+  const params = new URLSearchParams(window.location.search);
+  const howtoKey = params.get('howto');
+  if (howtoKey) {
+    loadHowto(howtoKey, params.get('version') || '').catch((err) => {
+      console.error('[modules] how-to failed to load', err);
+      howtoFail('Could not load the how-to. Return to the modules list and try again.');
+    });
+  } else {
+    load();
+  }
 })();

package/modules/hall-ui/public/style.css

@@ -2876,16 +2876,87 @@ main [id] { scroll-margin-top: calc(var(--topbar-h) + 16px); }
 }
 .bulk-toolbar__clear:hover { color: var(--ink); }
 
+/* ---- shared by the Tasks board AND the goal board's cards (task 1003141) ----
+   These three used to live in work.css, which goals.html borrowed whole. They
+   are single-class rules no other sheet restates, so moving them earlier in the
+   cascade changes nothing — checked by computed style on both pages. */
+
+/* Filtered-count line under the filter bar — the label voice, with the number
+   itself stepping up to ink so the count reads before the words. */
+.claim-count-line {
+  margin: 0 0 12px;
+  font-family: var(--label-face);
+  font-size: var(--label-size);
+  letter-spacing: var(--label-space);
+  text-transform: var(--label-case);
+  color: var(--ink-faint);
+}
+
+.wip__release {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-height: 30px;
+  padding: 0 14px;
+  background: none;
+  border: var(--line) solid var(--rule);
+  color: var(--ink-soft);
+  border-radius: var(--radius-pill);
+  font-size: 13px;
+  text-transform: lowercase;
+  cursor: pointer;
+  transition: background 150ms, color 150ms, border-color 150ms;
+}
+.wip__release:hover:not(:disabled) {
+  background: var(--danger-weak);
+  color: var(--danger);
+  border-color: color-mix(in srgb, var(--danger) 40%, transparent);
+}
+.wip__release:disabled { opacity: 0.55; cursor: default; }
+
+.wip__select {
+  appearance: none;
+  -webkit-appearance: none;
+  position: relative;
+  width: 24px;
+  height: 24px;
+  margin: 0;
+  cursor: pointer;
+}
+.wip__select::before {
+  content: "";
+  position: absolute;
+  left: 5px;
+  top: 5px;
+  width: 14px;
+  height: 14px;
+  border: var(--line) solid var(--rule);
+  border-radius: 3px;
+}
+.wip__select:checked::before { background: var(--accent); border-color: var(--accent); }
+.wip__select:checked::after {
+  content: "";
+  position: absolute;
+  left: 9px;
+  top: 8px;
+  width: 4px;
+  height: 8px;
+  border: solid var(--accent-on);
+  border-width: 0 1.5px 1.5px 0;
+  transform: rotate(42deg);
+}
+
 /* The shell's .app-content already ends in 108px of bottom air at desktop
    width, which is what clears the bar — but at 768 it drops to 48px for the
    phone, and there the bar is TALLER (its actions wrap to their own row). So
-   the phone width buys the room back, scoped to this page: goals.html loads
-   this sheet too and has no bulk toolbar to clear. */
+   the phone width buys the room back, scoped to the two pages that carry the
+   toolbar (the goal board gained the full one in task 1003141). */
 @media (max-width: 768px) {
   /* At the drawer breakpoint the sidebar leaves the flow, so the bar spans. */
   .bulk-toolbar { left: 0; padding: 10px 14px; gap: 10px; }
   .bulk-toolbar__actions { margin-left: 0; width: 100%; }
-  body[data-page="work"] .app-content { padding-bottom: 200px; }
+  body[data-page="work"] .app-content,
+  body[data-page="goals"] .app-content { padding-bottom: 200px; }
 }
 
 .task__credits { display: flex; flex-direction: column; align-items: flex-end; gap: 2px; padding-top: 2px; }

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

@@ -14,7 +14,9 @@
    verification state, which DESIGN.md §Reuse names as the one sanctioned
    exception to the Fifteen Rule.
 
-   goals.html LOADS THIS SHEET TOO — a change here lands on both pages. */
+   goals.html NO LONGER LOADS THIS SHEET (task 1003141): what the goal board's
+   cards borrowed from it — .claim-count-line, .wip__release, .wip__select — now
+   lives in style.css, so this sheet is the board's alone. */
 
 /* `.page-head--board` MOVED to style.css (task 1003305) when the ideas composer
    became its third consumer: a modifier on the shell's own .page-head is shell
@@ -35,17 +37,6 @@
 .wip-builder { color: var(--ink); font-weight: 500; }
 .wip-builder small { color: var(--ink-soft); font-weight: 400; }
 
-/* Filtered-count line under the filter bar — the label voice, with the number
-   itself stepping up to ink so the count reads before the words. */
-.claim-count-line {
-  margin: 0 0 12px;
-  font-family: var(--label-face);
-  font-size: var(--label-size);
-  letter-spacing: var(--label-space);
-  text-transform: var(--label-case);
-  color: var(--ink-faint);
-}
-
 .backlog-count {
   font-family: var(--font-mono);
   font-size: 11px;
@@ -67,27 +58,6 @@
 
 /* In-flight table: release action on the viewer's own claims. */
 .wip__action { text-align: right; white-space: nowrap; }
-.wip__release {
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  min-height: 30px;
-  padding: 0 14px;
-  background: none;
-  border: var(--line) solid var(--rule);
-  color: var(--ink-soft);
-  border-radius: var(--radius-pill);
-  font-size: 13px;
-  text-transform: lowercase;
-  cursor: pointer;
-  transition: background 150ms, color 150ms, border-color 150ms;
-}
-.wip__release:hover:not(:disabled) {
-  background: var(--danger-weak);
-  color: var(--danger);
-  border-color: color-mix(in srgb, var(--danger) 40%, transparent);
-}
-.wip__release:disabled { opacity: 0.55; cursor: default; }
 .wip__mine-none { color: var(--ink-faint); }
 .wip__row--mine { background: var(--accent-tint); }
 
@@ -121,7 +91,7 @@
 .history__when { color: var(--ink-soft); font-size: 12.5px; white-space: nowrap; font-variant-numeric: tabular-nums; }
 
 
-/* ---- task 1759: multi-select checkbox (the toolbar itself is in style.css) ----
+/* ---- task 1759: multi-select (the toolbar AND the checkbox are in style.css) ----
    Re-cut for the 24px floor and the world (task 1003304). The floating dark
    pill is gone: it painted an INVERTED surface (background: var(--ink)) with
    three rgba(255,255,255,…) literals on top, which was correct only for as long
@@ -130,38 +100,6 @@
    content column instead, inset by the rail, so it never has to invert. */
 
 .wip__select-cell { width: 1%; text-align: center; }
-.wip__select {
-  appearance: none;
-  -webkit-appearance: none;
-  position: relative;
-  width: 24px;
-  height: 24px;
-  margin: 0;
-  cursor: pointer;
-}
-.wip__select::before {
-  content: "";
-  position: absolute;
-  left: 5px;
-  top: 5px;
-  width: 14px;
-  height: 14px;
-  border: var(--line) solid var(--rule);
-  border-radius: 3px;
-}
-.wip__select:checked::before { background: var(--accent); border-color: var(--accent); }
-.wip__select:checked::after {
-  content: "";
-  position: absolute;
-  left: 9px;
-  top: 8px;
-  width: 4px;
-  height: 8px;
-  border: solid var(--accent-on);
-  border-width: 0 1.5px 1.5px 0;
-  transform: rotate(42deg);
-}
-
 /* ---- "Only mine" lens (the board's tab-wide filter; goal board's To-do bar
    borrows the same class) --------------------------------------------------
    Deliberately QUIETER than the filter bar below it: a checkbox in the label

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

@@ -189,7 +189,8 @@
 <script src="/builders/work-summary.js" defer></script>
 <script src="/builders/task-detail.js?v=2026-07-03-taskdetail" defer></script>
 <script src="/builders/brand-apply.js?v=2026-06-19-r56" defer></script>
-<script src="/builders/work.js?v=2026-09-26-claimaction1" defer></script>
+<script src="/builders/bulk-toolbar.js" defer></script>
+<script src="/builders/work.js?v=2026-09-30-bulktoolbar" defer></script>
 <script src="/builders/copy-on-click.js?v=2026-06-01-copy-1" defer></script>
 </body>
 </html>

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

@@ -187,9 +187,9 @@
   // The hall's ONE claim/release action (task 1003458). Everything this board
   // used to hand-roll four times — the POST, the refusal sentence, the
   // stale-view refresh, the all-or-nothing batch report — lives in
-  // claim-action.js now; doClaim/doRelease/doBulkClaim/doBulkRelease below keep
-  // only what is genuinely this page: button text, the re-entrancy guard, the
-  // confirm() wording and the selection. friendlyBatchReason is injected rather
+  // claim-action.js now; doClaim/doRelease below keep only what is
+  // genuinely this page: button text and the re-entrancy guard (the bulk
+  // toolbar is bulk-toolbar.js, built from this same action). friendlyBatchReason is injected rather
   // than imported there, so claim-action.js stays dependency-free.
   // refreshLive is a hoisted declaration; toast and API are already bound above.
   const claimAction = makeClaimAction({
@@ -291,18 +291,6 @@
   // String(claim_id) -> task_id for the viewer's OWN in-flight claims (release
   // is only ever offered on those rows to begin with — see renderInFlight).
   const selection = { claim: new Set(), release: new Map() };
-  // Last server dry-run (POST /claims/batch/validate) result, keyed by the
-  // sorted selected-id set so an unrelated re-render doesn't refire it.
-  const validateCache = { key: '', parallelSafe: null, byId: new Map() };
-  let validateDebounce = null;
-  // Per-task dependency edges for the "can these be sequenced?" cycle check —
-  // fetched lazily via GET /tasks/:id (task-detail.js's call) since the
-  // claimable feed doesn't carry dependencies[] per row. Stable for a ready
-  // task within one page session, so caching by id is safe.
-  const depsCache = new Map(); // task_id -> [dependency task_id, ...]
-  const sequentialCache = { key: '', order: null };
-  let sequentialDebounce = null;
-
   // task 1756: two tasks can't run in parallel if their touches[] overlap — exact
   // path match or a directory-prefix either way (mirrors the server's touchesOverlap
   // / the goals-page conflict estimate). Empty touches never conflict.
@@ -700,207 +688,18 @@
     }
   }
 
-  function selectedClaimIds() { return [...selection.claim].map(Number); }
-  function selectionKey(ids) { return ids.slice().sort((a, b) => a - b).join(','); }
-
-  async function scheduleValidate(key, ids) {
-    if (validateDebounce) clearTimeout(validateDebounce);
-    validateDebounce = setTimeout(async () => {
-      // The dry run lives in claim-action.js with the rest of the claim path; it
-      // is best-effort there, so a failure lands as parallelSafe:false with an
-      // empty map rather than a throw — Parallel stays disabled with a generic
-      // title instead of copying a prompt for tasks nobody verified. The
-      // debounce, the cache key and the re-render stay here: page furniture.
-      const out = await claimAction.validateMany(ids);
-      validateCache.key = key;
-      validateCache.parallelSafe = out.parallelSafe;
-      validateCache.byId = out.byId;
-      renderBulkToolbar();
-    }, 350);
-  }
-
-  async function fetchDeps(taskId) {
-    if (depsCache.has(taskId)) return depsCache.get(taskId);
-    let deps = [];
-    try {
-      const d = await getJSON(`${API}/tasks/${encodeURIComponent(taskId)}`, { softAuth: true });
-      if (d && d.task && Array.isArray(d.task.dependencies)) {
-        deps = d.task.dependencies.map((x) => Number(x.id)).filter((x) => Number.isFinite(x));
-      }
-    } catch (_) { /* treat as no known dependencies */ }
-    depsCache.set(taskId, deps);
-    return deps;
-  }
-
-  // Kahn's algorithm restricted to edges BETWEEN the selected ids (an
-  // out-of-selection dependency doesn't block sequencing the selection
-  // itself). Returns the topological order, or null if the restricted graph
-  // has a cycle (can't be sequenced).
-  function topoOrder(ids, edgesByTask) {
-    const remaining = new Set(ids);
-    const order = [];
-    let progressed = true;
-    while (remaining.size && progressed) {
-      progressed = false;
-      for (const id of Array.from(remaining)) {
-        const deps = (edgesByTask.get(id) || []).filter((d) => remaining.has(d));
-        if (deps.length === 0) {
-          order.push(id);
-          remaining.delete(id);
-          progressed = true;
-        }
-      }
-    }
-    return remaining.size ? null : order;
-  }
-
-  function scheduleSequentialCheck(key, ids) {
-    if (sequentialDebounce) clearTimeout(sequentialDebounce);
-    sequentialDebounce = setTimeout(async () => {
-      const edgesByTask = new Map();
-      await Promise.all(ids.map(async (id) => { edgesByTask.set(id, await fetchDeps(id)); }));
-      sequentialCache.key = key;
-      sequentialCache.order = topoOrder(ids, edgesByTask);
-      renderBulkToolbar();
-    }, 350);
-  }
-
-  function renderBulkToolbar() {
-    const bar = $('#bulk-toolbar');
-    if (!bar) return;
-    if (selectionTotal() === 0) { bar.hidden = true; return; }
-    bar.hidden = false;
-
-    const countEl = $('#bulk-count');
-    if (countEl) {
-      const parts = [];
-      if (selection.claim.size) parts.push(`${selection.claim.size} to claim`);
-      if (selection.release.size) parts.push(`${selection.release.size} to release`);
-      countEl.textContent = parts.join(' · ');
-    }
-
-    const claimBtn = $('#bulk-claim-btn');
-    if (claimBtn) {
-      claimBtn.disabled = selection.claim.size === 0;
-      claimBtn.textContent = selection.claim.size > 1 ? `Bulk claim (${selection.claim.size})` : 'Bulk claim';
-    }
-    const releaseBtn = $('#bulk-release-btn');
-    if (releaseBtn) {
-      releaseBtn.disabled = selection.release.size === 0;
-      releaseBtn.textContent = selection.release.size > 1 ? `Bulk release (${selection.release.size})` : 'Bulk release';
-    }
-
-    const parallelBtn = $('#bulk-parallel-btn');
-    if (parallelBtn) {
-      if (selection.claim.size < 2) {
-        parallelBtn.disabled = true;
-        parallelBtn.title = 'Select at least 2 waiting tasks to copy a parallel-session prompt.';
-      } else {
-        const ids = selectedClaimIds();
-        const key = selectionKey(ids);
-        if (validateCache.key === key && validateCache.parallelSafe != null) {
-          parallelBtn.disabled = !validateCache.parallelSafe;
-          if (!validateCache.parallelSafe) {
-            const bad = [...validateCache.byId.values()].filter((r) => !r.valid);
-            const detail = bad.map((r) => `#${r.task_id}: ${(r.reasons || []).map(friendlyBatchReason).join(', ')}`).join(' · ');
-            parallelBtn.title = detail || 'Selected tasks conflict and cannot run in parallel.';
-          } else {
-            parallelBtn.title = '';
-          }
-        } else {
-          parallelBtn.disabled = true;
-          parallelBtn.title = 'Checking for conflicts…';
-          scheduleValidate(key, ids);
-        }
-      }
-    }
-
-    const sequentialBtn = $('#bulk-sequential-btn');
-    if (sequentialBtn) {
-      if (selection.claim.size < 2) {
-        sequentialBtn.disabled = true;
-        sequentialBtn.title = 'Select at least 2 waiting tasks to copy a sequential prompt.';
-      } else {
-        const ids = selectedClaimIds();
-        const key = selectionKey(ids);
-        if (sequentialCache.key === key) {
-          sequentialBtn.disabled = sequentialCache.order == null;
-          sequentialBtn.title = sequentialCache.order == null
-            ? 'These tasks depend on each other in a cycle and cannot be ordered.'
-            : '';
-        } else {
-          sequentialBtn.disabled = true;
-          sequentialBtn.title = 'Checking dependency order…';
-          scheduleSequentialCheck(key, ids);
-        }
-      }
-    }
-  }
-
-  function clearSelection() {
-    selection.claim.clear();
-    selection.release.clear();
-    renderClaimable();
-    renderInFlight();
-    renderBulkToolbar();
-  }
-
-  function buildBulkParallelPrompt(tasks) {
-    const hallBase = location.hostname.startsWith('builders.') ? location.origin : `${location.origin}/builders`;
-    const lines = [
-      `I want to work on ${tasks.length} Bongos tasks IN PARALLEL — open ${tasks.length} separate Claude Code sessions, each in its own worktree, one per task below, so they can run at the same time without touching each other's files.`,
-      '',
-    ];
-    tasks.forEach((t, i) => {
-      lines.push(`Session ${i + 1} — task ${t.id} (${t.title}) — ${hallBase}#/task/${t.id}`);
-      lines.push(`Claim it with /builder-claim ${t.id}, follow its acceptance criteria, stay within touches[], ship via /builder-ship when done.`);
-      lines.push('');
-    });
-    return lines.join('\n').trim();
-  }
-
-  function buildBulkSequentialPrompt(tasks) {
-    const hallBase = location.hostname.startsWith('builders.') ? location.origin : `${location.origin}/builders`;
-    const lines = [
-      `I want to work on ${tasks.length} Bongos tasks IN ORDER, one after another in this same session — claim, build, and ship each before moving to the next.`,
-      '',
-    ];
-    tasks.forEach((t, i) => {
-      lines.push(`${i + 1}. Task ${t.id} (${t.title}) — ${hallBase}#/task/${t.id}`);
-    });
-    lines.push('');
-    lines.push('For each: /builder-claim <id>, follow its acceptance criteria, stay within touches[], /builder-ship <id> before starting the next.');
-    return lines.join('\n');
-  }
-
-  async function doBulkClaim() {
-    const ids = selectedClaimIds();
-    if (!ids.length) return;
-    const btn = $('#bulk-claim-btn');
-    if (btn) { btn.disabled = true; btn.textContent = 'Claiming…'; }
-    try {
-      const out = await claimAction.claimMany(ids);
-      if (out.ok) selection.claim.clear();
-    } finally {
-      renderBulkToolbar();
-    }
-  }
-
-  async function doBulkRelease() {
-    const entries = [...selection.release.entries()]; // [claimId, taskId]
-    if (!entries.length) return;
-    const label = entries.length === 1 ? `#${entries[0][1]}` : `${entries.length} tasks`;
-    const pronoun = entries.length === 1 ? 'It returns' : 'They return';
-    if (!window.confirm(`Release ${label}? ${pronoun} to the queue and no ${curLabel()} are earned.`)) return;
-    const btn = $('#bulk-release-btn');
-    if (btn) { btn.disabled = true; btn.textContent = 'Releasing…'; }
-    try {
-      const out = await claimAction.releaseMany(entries);
-      if (out.ok) selection.release.clear();
-    } finally {
-      renderBulkToolbar();
-    }
-  }
+  // The toolbar itself (render, bulk claim/release, the two prompts) is the
+  // hall's shared one — bulk-toolbar.js. This page keeps the selection and how
+  // Clear repaints its own cards.
+  const bulk = window.OTBBulkToolbar.makeBulkToolbar({
+    ids: { bar: 'bulk-toolbar', count: 'bulk-count', claim: 'bulk-claim-btn', release: 'bulk-release-btn', parallel: 'bulk-parallel-btn', sequential: 'bulk-sequential-btn', clear: 'bulk-clear-btn' },
+    selection,
+    findTask: (id) => taskState.all.find((t) => Number(t.id) === id),
+    claimAction, getJSON, API, copyText, toast, curLabel, describeReason: friendlyBatchReason,
+    onClear: () => { renderClaimable(); renderInFlight(); },
+  });
+  function renderBulkToolbar() { bulk.render(); }
+  function clearSelection() { bulk.clearSelection(); }
 
   async function doClaim(taskId, btn) {
     const key = `claim:${taskId}`;
@@ -1373,26 +1172,8 @@
       doRelease(rel.dataset.claimId, rel.dataset.taskId, rel);
     });
 
-    // task 1759: the bottom bulk-action toolbar.
-    $('#bulk-claim-btn')?.addEventListener('click', doBulkClaim);
-    $('#bulk-release-btn')?.addEventListener('click', doBulkRelease);
-    $('#bulk-clear-btn')?.addEventListener('click', clearSelection);
-    $('#bulk-parallel-btn')?.addEventListener('click', async () => {
-      const ids = selectedClaimIds();
-      const tasks = ids.map((id) => taskState.all.find((t) => Number(t.id) === id)).filter(Boolean);
-      if (tasks.length < 2) return;
-      const ok = await copyText(buildBulkParallelPrompt(tasks));
-      toast(ok ? `Parallel-session prompt for ${tasks.length} tasks copied.` : 'Could not copy to the clipboard.');
-    });
-    $('#bulk-sequential-btn')?.addEventListener('click', async () => {
-      const ids = selectedClaimIds();
-      const key = selectionKey(ids);
-      if (sequentialCache.key !== key || sequentialCache.order == null) return;
-      const tasks = sequentialCache.order.map((id) => taskState.all.find((t) => Number(t.id) === id)).filter(Boolean);
-      if (tasks.length < 2) return;
-      const ok = await copyText(buildBulkSequentialPrompt(tasks));
-      toast(ok ? `Sequential prompt for ${tasks.length} tasks copied.` : 'Could not copy to the clipboard.');
-    });
+    // task 1759: the bottom bulk-action toolbar (shared: bulk-toolbar.js).
+    bulk.wire();
   }
 
   document.addEventListener('DOMContentLoaded', () => {

package/modules/hall-ui/records/catalog.md

@@ -8,3 +8,5 @@
 - **The island index is the map's keyboard and phone path.** The scene is a hover surface: SVG `<g>`s with mouse listeners, **no focusable element**, and at 390px thirty islands in 360px with nothing under them. `drawIndex` renders every node of the current view as a dense `.ov-row` under a `kit-collapse` (`#ab-index`) whose title is a disclosure button (`aria-expanded`/`aria-controls`) laying the SAME `detailHTML` inline; hovering a row lights the island, and **the index opens itself under 640px (`matchMedia`), where the list is the read.**
 
 Also gone, and the one rule in that list: `.ab-caption` takes the lede's `--measure`, never a fresh `90ch`. **Gotcha:** `gen-atlas.js` run from the MAIN checkout walks `.claude/worktrees/*` and emits thousands of context nodes — run it from a worktree, or copy a worktree's `atlas.json` over, before previewing the atlas there.
+
+**A store version's how-to is a view of the Modules page, not a new page (task 1004366).** `/builders/modules?howto=<key>&version=<X.Y.Z>` hides the catalog and shows that version's `HOWTO.md` in the reading room's article card: the page adds `body.room` so `room.css`'s sizes apply, and the markdown goes through `md-reader.js` (author-written, so every byte is escaped; only absolute http(s), mailto and #anchor links become links). A query, not a `#/` route — the hash namespace is frozen to the idea and blocker overlays. "Save as PDF" is `window.print()` with an `@media print` block in `modules.css` that keeps only the document and prints in the system ink (`CanvasText`), because a literal colour is the token tier's. Harness fixture: `store__modules__howto.json`.

package/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@bongos/core",
-  "version": "1.20.45",
+  "version": "1.20.47",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@bongos/core",
-      "version": "1.20.45",
+      "version": "1.20.47",
       "license": "AGPL-3.0-or-later",
       "dependencies": {
         "express": "^4.21.2",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bongos/core",
-  "version": "1.20.45",
+  "version": "1.20.47",
   "description": "Cloud Bongos — the AI-first build platform core (GDS + platform surfaces + module system), installed as a versioned dependency (ADR 0108).",
   "license": "AGPL-3.0-or-later",
   "main": "src/platform-server.js",

package/release-notes.json

@@ -8383,5 +8383,17 @@
       "id": "1004473",
       "text": "The Builders Hall now has a Commands page listing every slash command and every terminal command, with what each does, when to use it and what it costs, including the ones hidden from Claude's menu."
     }
+  ],
+  "1.20.46": [
+    {
+      "id": "1004366",
+      "text": "Every store module version now has a readable how-to page in the hall, with a Save as PDF button and an optional link to a Claude page."
+    }
+  ],
+  "1.20.47": [
+    {
+      "id": "1003141",
+      "text": "The Goals page now has the same bulk actions as the Tasks board: claim several tasks, release your own, or copy a prompt to work them in parallel or in order. Both pages now share one toolbar, so they stay in step."
+    }
   ]
 }