@bongos/core 1.20.46 → 1.20.48

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

@@ -171,7 +171,7 @@
 
 <!-- The app shell (sidebar + top bar + footer). Dependency-free; runs at parse
      time so the chrome exists before the deferred page scripts execute. -->
-<script src="/builders/shell.js?v=2026-09-30-commands"></script>
+<script src="/builders/shell.js?v=2026-09-30-founding-commands"></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 frontend toolkit (window.OTB) — loaded FIRST so work.js can pull from it. -->
@@ -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/founding-mode.md

@@ -0,0 +1,31 @@
+# Project founding mode — the band and the asleep rooms, worn by the existing hall (task 1004422)
+
+**BV2.PS03 (goal 1000121).**
+- Design of record: [`docs/design/project-startup-direction.md`](../../../docs/design/project-startup-direction.md), part 2 of the genesis table.
+- Spec: [`docs/specs/<redacted>.md`](../../../docs/specs/<redacted>.md).
+
+## The rule this record exists to keep
+
+The owner's blend rule: **genesis is a MODE the existing hall wears, never a second hall.** Founding mode follows the social-mode precedent exactly: one attribute on the document, `html[data-founding="on"]`, read from `/me`. It adds two things in this task:
+
+- **the founding band**, a strip created as the first child of `.app-body`. It sits above the sticky topbar, which is kept as it is.
+- **the asleep state on today's nav items**: dimmed, with an "at <stage>" or "when alive" tag that reads in the open rail.
+
+Nothing else changes: no new page, no new route, no new nav item. **A project that is not founding makes `applyFounding` return before it touches a single node**, and `tests/founding_mode.mjs` proves that with a proxy that records every DOM call. Switching the mode off REMOVES the band and every class and tag, so the hall is restored exactly; it does not merely hide them. It is cosmetic: an asleep room still opens, and nothing is enforced.
+
+## Where the answer comes from
+
+- `modules/onboarding/founding-mode.js` holds three `project_settings` keys (`founding.active`, `founding.stage`, `founding.started_at`) and computes which rooms sleep.
+- `asleep` is keyed by `shell.js` NAV ids, so the client never re-derives it. A test holds the two maps together.
+- It **fails closed to OFF**: an absent, unreadable or unknown stage reads as not founding. A hall wrongly stuck asleep would be the hijack; a hall wrongly awake only loses a banner.
+- `/me.founding_mode` carries the answer. Both `applyAccess` callers pass it (`shell.js` `probeMe` and `hall-render.js`).
+
+## Rendered, and the phone rule
+
+work-founding.states.json renders an ordinary hall page with a founding /me (kit fixture me-founding.json, the real shaper's output). The kit's /me honours stub.fixtures for this. At 390 and 320 the band wraps, the sentence steps aside and the stage and link stay visible, because the first render measured the band widening the page to 483px.
+
+## What is deliberately not here
+
+- The genesis home, the stage tasks and the "what's this?" destination belong to PS08 (task 1004423). The band links home until then.
+- The founding mark belongs to PS10 (task 1004424).
+- Starting founding on a new project and moving its stage is `setFoundingMode`, on the onboarding port, and PS08 drives it. Nothing in this task writes it.

package/modules/onboarding/founding-mode.js

@@ -0,0 +1,185 @@
+'use strict';
+
+// modules/onboarding/founding-mode.js — PROJECT FOUNDING MODE: is this project still
+// being founded, and which stage of genesis is it on? (task 1004422 / BV2.PS03, goal
+// 1000121; design of record docs/design/project-startup-direction.md.)
+//
+// THE BLEND RULE THIS FILE SERVES (owner, 2026-09-30). Genesis is a MODE the existing
+// builders hall wears, never a second hall. So this file answers ONE question for the
+// hall shell — founding or not, and at which stage — and the shell stamps the answer on
+// the document the way it stamps social mode (`html[data-social]`). Nothing here renders
+// anything, and a project that is not founding gets `null`, which the shell reads as OFF:
+// the hall then renders exactly as it does today.
+//
+// WHY THE ONBOARDING MODULE. Founding is the FOUNDER-side counterpart of the joiner
+// state machine this module already owns (onboarding-state.js graduates a newcomer; this
+// graduates a project). It lives in project_settings (migration core_231) through the
+// doorway's one accessor, like mingle.enabled, rather than a table of its own — one row
+// per project is the whole state, and "do not fork a second settings store" is that
+// accessor's own rule.
+//
+// FAIL POSTURE: CLOSED, i.e. OFF. An unreadable, absent, or malformed state is NOT
+// founding. The failure this guards against is the owner's no-hijack condition: a hall
+// wrongly stuck in founding mode would dim rooms that are really open. A hall wrongly
+// NOT in founding mode only loses a banner. So every doubtful read answers null.
+
+// The genesis stages, in order. 'decide' is the pre-stage the founder plans in; the
+// five after it are the stages proper (spec C4). The order IS the data: a room wakes
+// when the stage that wakes it has been left behind.
+const STAGES = Object.freeze(['decide', 'scope', 'strategize', 'charter', 'legalize', 'legislation']);
+
+// Which hall rooms each finished stage wakes (the direction doc's "How rooms wake"
+// table). Keyed by the shell's NAV item ids, so the client applies it without a second
+// mapping of its own — a surface that re-derived this could disagree with the server.
+// 'community' wakes only when the planet is ALIVE, which is when founding mode switches
+// off entirely, so during founding it is always asleep.
+const WAKES = Object.freeze({
+  scope: Object.freeze(['roadmap', 'goals', 'goal-map']),
+  strategize: Object.freeze(['work']),
+  charter: Object.freeze(['board-room']),
+  legalize: Object.freeze(['economy']),
+  legislation: Object.freeze(['ranks']),
+});
+const WAKES_WHEN_ALIVE = Object.freeze(['collab', 'roster']);
+
+// The project_settings keys. Namespaced 'founding.' like 'mingle.' and 'attention.'.
+const KEYS = Object.freeze({
+  ACTIVE: 'founding.active',
+  STAGE: 'founding.stage',
+  STARTED_AT: 'founding.started_at',
+});
+
+// The only 'on' spelling accepted, mirroring mingle's consent-gate parse: an explicit,
+// recognised yes. Anything else is off.
+function parseActive(raw) {
+  if (raw == null) return false;
+  return ['true', '1', 'on', 'yes'].includes(String(raw).trim().toLowerCase());
+}
+
+// asleepRooms(stage) — PURE. For a known stage, { navId: wakingStage } for every room
+// still asleep. A room is awake once its waking stage is BEHIND the current one.
+function asleepRooms(stage) {
+  const at = STAGES.indexOf(stage);
+  if (at < 0) return null;
+  const asleep = {};
+  for (const [wakingStage, ids] of Object.entries(WAKES)) {
+    if (STAGES.indexOf(wakingStage) >= at) for (const id of ids) asleep[id] = wakingStage;
+  }
+  for (const id of WAKES_WHEN_ALIVE) asleep[id] = 'alive';
+  return asleep;
+}
+
+// dayOf(startedAt, now) — PURE. Day 1 is the founding day. null when unreadable, so a
+// bad timestamp drops the day from the band rather than printing "day NaN".
+function dayOf(startedAt, now = new Date()) {
+  if (!startedAt) return null;
+  const t = new Date(startedAt).getTime();
+  if (!Number.isFinite(t)) return null;
+  const days = Math.floor((now.getTime() - t) / 86400000) + 1;
+  return days >= 1 ? days : 1;
+}
+
+// shapeFoundingMode(rows, now) — PURE. rows = { active, stage, startedAt } raw strings
+// (or nulls). Returns the /me payload, or null for "not founding" in any form.
+function shapeFoundingMode(rows, now = new Date()) {
+  if (!rows || !parseActive(rows.active)) return null;
+  const stage = rows.stage == null ? 'decide' : String(rows.stage).trim().toLowerCase();
+  const asleep = asleepRooms(stage);
+  if (!asleep) return null; // an unknown stage is not a stage — fail closed (OFF)
+  const index = STAGES.indexOf(stage);
+  return {
+    active: true,
+    stage,
+    // 0 while deciding, then 1..5 through the stages proper.
+    stage_number: index,
+    stage_count: STAGES.length - 1,
+    day: dayOf(rows.startedAt, now),
+    asleep,
+    // Who closing the current stage is waiting on (spec D7) — display names, at most
+    // five, from the government module's genesis-stage sitting (task 1004429). null
+    // when the stage is not sitting, nobody is left to vote, or the read is missing.
+    waiting_on: Array.isArray(rows.waitingOn) && rows.waitingOn.length
+      ? rows.waitingOn.slice(0, 5).map((n) => String(n))
+      : null,
+  };
+}
+
+// foundingModeFor(deps) — the /me read. Resolves the three rows through the doorway's
+// project-settings accessor (injectable for tests). Never throws: any read failure is
+// "not founding".
+// Three primary-key reads in parallel: the doorway's project-settings accessor is
+// single-key by design (one accessor, one table), and a founding project is a short
+// window of a project's life, so a batched read is not worth a second accessor.
+async function foundingModeFor(deps = {}) {
+  const get = deps.getSetting || require('../../src/module-api').projectSettings.get;
+  let shaped;
+  try {
+    const [active, stage, startedAt] = await Promise.all([
+      get(KEYS.ACTIVE), get(KEYS.STAGE), get(KEYS.STARTED_AT),
+    ]);
+    shaped = shapeFoundingMode({
+      active: active && active.value,
+      stage: stage && stage.value,
+      startedAt: startedAt && startedAt.value,
+    }, deps.now || new Date());
+  } catch (_) {
+    return null;
+  }
+  if (!shaped) return null;
+  // The waiting-on names come from the government module's genesis-stage read
+  // (genesisStageStatus on its port, task 1004429: one entry per stage, each with
+  // a state and, while sitting, the members still to vote under the item's own
+  // snapshot). Optional and fail-open: a missing port or a failed read leaves the
+  // band without the names, never without the mode.
+  try {
+    const waitingOnFor = deps.waitingOnFor || waitingOnFromGovernment(
+      deps.government !== undefined ? deps.government : require('../../src/module-api').resolveOptional('government'),
+    );
+    if (waitingOnFor) {
+      const names = await waitingOnFor(shaped.stage);
+      if (Array.isArray(names) && names.length) shaped.waiting_on = names.slice(0, 5).map((n) => String(n));
+    }
+  } catch (_) { /* fail open: the band shows the stage without the names */ }
+  return shaped;
+}
+
+// waitingOnFromGovernment(gov) — a stage -> [display name] reader over the government
+// port's genesisStageStatus(), or null when the port does not offer it. Only a stage
+// that is SITTING waits on anyone; not_put, passed and returned wait on nobody.
+function waitingOnFromGovernment(gov) {
+  if (!gov || typeof gov.genesisStageStatus !== 'function') return null;
+  return async (stage) => {
+    const status = await gov.genesisStageStatus();
+    const row = status && Array.isArray(status.stages) ? status.stages.find((s) => s.key === stage) : null;
+    if (!row || row.state !== 'sitting' || !Array.isArray(row.waiting_on)) return [];
+    return row.waiting_on.map((m) => m.display_name || m.github_login).filter(Boolean);
+  };
+}
+
+// setFoundingMode({ active, stage }, builderId, deps) — the write the genesis home
+// (task 1004423) drives: start founding on a new project, move the stage, and switch
+// founding off when the planet comes alive. Refuses an unknown stage rather than storing
+// a value the read would then treat as OFF. Starting stamps started_at once.
+async function setFoundingMode({ active, stage } = {}, builderId = null, deps = {}) {
+  const settings = require('../../src/module-api').projectSettings;
+  const get = deps.getSetting || settings.get;
+  const set = deps.setSetting || settings.set;
+  if (stage != null && !STAGES.includes(stage)) {
+    const err = new Error(`unknown founding stage '${stage}'`);
+    err.code = 'bad_founding_stage';
+    throw err;
+  }
+  if (active === true) {
+    const started = await get(KEYS.STARTED_AT);
+    if (!started || !started.value) await set(KEYS.STARTED_AT, (deps.now || new Date()).toISOString(), builderId);
+  }
+  if (typeof active === 'boolean') await set(KEYS.ACTIVE, active ? 'true' : 'false', builderId);
+  if (stage != null) await set(KEYS.STAGE, stage, builderId);
+  return foundingModeFor({ getSetting: get, now: deps.now });
+}
+
+module.exports = {
+  STAGES, WAKES, WAKES_WHEN_ALIVE, KEYS,
+  parseActive, asleepRooms, dayOf, shapeFoundingMode, waitingOnFromGovernment,
+  foundingModeFor, setFoundingMode,
+};

package/modules/onboarding/port.js

@@ -40,6 +40,7 @@
 
 const onboardingState = require('./onboarding-state');
 const newcomerRestock = require('./newcomer-restock');
+const foundingMode = require('./founding-mode');
 
 module.exports = {
   // --- the newcomer onboarding state machine (onboarding-state.js) ---------
@@ -53,6 +54,12 @@ module.exports = {
   markStage: (...a) => onboardingState.markStage(...a),
   broadcastGraduation: (...a) => onboardingState.broadcastGraduation(...a),
 
+  // --- project founding mode (founding-mode.js, task 1004422) ---------------
+  // me.js reads it for the hall shell (null = not founding = the hall as today);
+  // the genesis home (task 1004423) drives the write.
+  foundingModeFor: (...a) => foundingMode.foundingModeFor(...a),
+  setFoundingMode: (...a) => foundingMode.setFoundingMode(...a),
+
   // --- the evergreen newcomer-chore restock (newcomer-restock.js) ----------
   // restock the just-claimed chore's shelf (claims.js / tasks.js); the Archon
   // backstop tops every chore up (tasks.js). SOURCE_TAG is the marker the claim

package/modules/ui-design/kit/fixtures/me-founding.json

@@ -0,0 +1,24 @@
+{
+  "builder": {
+    "id": "1",
+    "github_login": "builder",
+    "display_name": "A Builder",
+    "avatar_url": "/__kit/avatar.svg",
+    "rank": "archon"
+  },
+  "founding_mode": {
+    "active": true,
+    "stage": "strategize",
+    "stage_number": 2,
+    "stage_count": 5,
+    "day": 9,
+    "asleep": {
+      "work": "strategize",
+      "board-room": "charter",
+      "economy": "legalize",
+      "ranks": "legislation",
+      "collab": "alive",
+      "roster": "alive"
+    }
+  }
+}