create-pmos 0.123.0 → 0.125.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.123.0",
+  "version": "0.125.0",
   "description": "Scaffold the PMOS portable kit — run the PMOS product-management workflow (initiative → lane-fit spec → contract → build → three gates, with work-type lanes for features, research, maintenance, incidents, and content) entirely inside your own repo, with all state as git-versioned files. Includes `workflow-sweep`, which audits the state every board derives from and separates real defects from work you simply have not done. `create-pmos workspace` also installs + launches the local Terminal Workspace GUI. No database, no network, no telemetry.",
   "license": "MIT",
   "bin": {

package/payload/KIT-VERSION

@@ -1,3 +1,3 @@
-kernel-source: pmos@d13a7b9
-assembled: 2026-10-09
+kernel-source: pmos@d18afe7
+assembled: 2026-10-11
 mode: vendor

package/payload/planning/evals/eval-calibration.md

@@ -2,7 +2,7 @@
 type: Reference
 title: "Eval calibration log"
 description: "Append-only record of every PM override of an evaluator verdict."
-generated: {by: process:create-pmos, at: "2026-10-09T03:00:14Z"}
+generated: {by: process:create-pmos, at: "2026-10-11T02:26:05Z"}
 status: stable
 ---
 

package/payload/planning/okrs/health-budgets.md

@@ -2,7 +2,7 @@
 type: Reference
 title: "Health budgets"
 description: "Closed registry of health-budget anchors (D59), edited only by the PM."
-generated: {by: process:create-pmos, at: "2026-10-09T03:00:14Z"}
+generated: {by: process:create-pmos, at: "2026-10-11T02:26:05Z"}
 status: stable
 ---
 

package/payload/scripts/nine-stages.js

@@ -0,0 +1,81 @@
+'use strict';
+/*
+ * The nine stage names as a label layer over the workflow engine's derived stage (run 3).
+ *
+ * The engine derives one of six rungs (intake, spec, contract, build, eval, accepted) from the steps
+ * it found. This file names the nine stages the PM sees and says which of them each lane uses. It
+ * never decides a stage itself: a stage is `done` only when a derived signal shows it, and a stage
+ * no record can yet show is `no-signal`, not guessed.
+ *
+ * The lane sets below are a proposal for the PM to correct (see the run 3 contract in the PRD).
+ */
+
+const STAGES = ['discover', 'ideate', 'strategize', 'prioritize', 'plan', 'build', 'deliver', 'monitor', 'evaluate'];
+
+const LABELS = {
+  discover: 'Discover', ideate: 'Ideate', strategize: 'Strategize', prioritize: 'Prioritize', plan: 'Plan',
+  build: 'Build', deliver: 'Deliver', monitor: 'Monitor', evaluate: 'Evaluate',
+};
+
+// Which stages each product-code lane uses. Stages not listed read `skipped`.
+const LANE_STAGES = {
+  feature: STAGES,
+  discovery: ['discover', 'ideate', 'strategize', 'prioritize', 'evaluate'],
+  chore: ['plan', 'build', 'evaluate'],
+  incident: ['build', 'deliver', 'monitor', 'evaluate'],
+  content: ['ideate', 'plan', 'build', 'deliver'],
+  prototype: ['discover', 'ideate', 'evaluate'],
+};
+
+// Stages that have a derived signal today. Every other stage reads `no-signal` until its record exists.
+const SIGNALLED = new Set(['discover', 'plan', 'build', 'evaluate']);
+
+const RANK = { intake: 0, spec: 1, contract: 2, build: 3, eval: 4, accepted: 5 };
+
+// Stages that gain a signal only when the caller passes the records (scripts/records readAll plus optional `releases`).
+// With no records the output is exactly the older output, so the lifecycle-lens mirror stays equal.
+const RECORD_SIGNALLED = new Set(['ideate', 'strategize', 'prioritize', 'monitor', 'deliver']);
+
+// records: { initiative?, anchor?, ideas, hypotheses, decisions, bets, 'kr-metrics', releases } (every list optional).
+// The initiative id and anchor come from `derived` (id, anchor) or from records.initiative / records.anchor.
+function recordSignals(derived, records, buildDone) {
+  const id = (derived && derived.id) || records.initiative || null;
+  const anchor = (derived && derived.anchor) || records.anchor || null;
+  const mine = (list) => (list || []).filter((r) => id && r.initiative === id);
+  const kr = (records['kr-metrics'] || []).filter((m) => anchor && (m.rid === anchor || m.parent_kr === anchor || 'kr:' + m.rid === anchor));
+  return {
+    ideate: mine(records.ideas).length + mine(records.hypotheses).length > 0,
+    strategize: mine(records.decisions).length + mine(records.bets).length > 0,
+    prioritize: mine(records.bets).some((b) => ['now', 'next', 'later'].includes(b.horizon) && Number.isInteger(b.rank)),
+    monitor: !!buildDone && kr.some((m) => (m.readings || []).length > 0),
+    deliver: mine(records.releases).length > 0,
+  };
+}
+
+function nineStages(lane, derived, records) {
+  const laneSet = new Set(LANE_STAGES[lane] || STAGES);
+  const rank = RANK[derived && derived.stage] ?? 0;
+  const step = (key) => (derived && derived.steps || []).find((s) => s.key === key);
+  const done = {
+    discover: rank >= 1,
+    plan: rank >= 2,
+    build: rank >= 3 || (step('build') && step('build').status === 'done'),
+    evaluate: rank >= 4,
+  };
+  const accepted = rank >= 5;
+  const fromRecords = records && typeof records === 'object' ? recordSignals(derived, records, done.build) : null;
+  const out = [];
+  let currentSet = false;
+  for (const key of STAGES) {
+    let status;
+    if (!laneSet.has(key)) status = 'skipped';
+    else if (!SIGNALLED.has(key) && !(fromRecords && RECORD_SIGNALLED.has(key) && (key !== 'deliver' || fromRecords.deliver))) status = 'no-signal';
+    else if (done[key] || (fromRecords && fromRecords[key])) status = 'done';
+    else status = 'pending';
+    if (status === 'pending' && !currentSet) { status = 'current'; currentSet = true; }
+    out.push({ key, label: LABELS[key], status, accepted: key === 'evaluate' ? accepted : undefined });
+  }
+  return out;
+}
+
+module.exports = { STAGES, LABELS, LANE_STAGES, nineStages };

package/payload/scripts/workflow-state.js

@@ -36,6 +36,7 @@
  * Zero dependencies, stock Node. It runs in CI, in a terminal, and inside the workspace server.
  */
 
+const { nineStages } = require('./nine-stages');
 const fs = require('fs');
 const path = require('path');
 const { execFileSync } = require('child_process');
@@ -1178,6 +1179,7 @@ function computeWorkflowDerived(id, opts) {
     ok: true, id, lane, laneKnown: knownLane, legacy, in_change: inChange,
     last_activity: lastActivity, accepted: accepted.length > 0, stage, record: recRel,
     title: fm.title || id, anchor: fm.parent_kr || null, profile: 'product-code',
+    nine_stages: nineStages(effLane, { stage, steps }),
     ...facts,
     steps, blockers: blockers.map((s) => s.key), gate_failures: gateFailures.map((s) => s.rule || s.key),
     next: next ? { step: next.key, why: next.evidence, action: next.next || next.evidence } : null,

package/payload/state/discoveries.md

@@ -2,7 +2,7 @@
 type: Reference
 title: "Discoveries and friction log"
 description: "Append-only record of what runs discovered and where the process rubbed."
-generated: {by: process:create-pmos, at: "2026-10-09T03:00:14Z"}
+generated: {by: process:create-pmos, at: "2026-10-11T02:26:05Z"}
 status: stable
 ---
 

package/payload/state/log.md

@@ -2,6 +2,6 @@
 
 Newest first, ISO dates.
 
-## 2026-10-09
+## 2026-10-11
 
 - Adopted OKF v0.2 (D73).

package/workspace/c3-one-home-test.js

@@ -0,0 +1,131 @@
+#!/usr/bin/env node
+'use strict';
+/* c3-one-home-test.js — the one-home rule as a check (console3 feedback plan, section 2; initiative browser-suites-green).
+ *
+ * Rule: an item is actionable in exactly one place, its home. Anywhere else it may appear only as a count, a date marker or
+ * a reference that opens the home. This suite loads the console3 page with the demo fixture (/c3.html?demo=1), opens every
+ * tab, and collects each item that carries an action control (a button, or an element with data-a) inside that tab's pane.
+ * An item is named by its title text, so the same item drawn by two different renderers still matches. It fails when one
+ * item has an action control on more than one tab.
+ *
+ * The page breaks the rule today, and the restructure that fixes it is Phase 2 of the plan. Until then the duplicates that
+ * exist now are listed in fixtures/one-home-baseline.json: they are printed, not failed. A duplicate that is NOT in the
+ * baseline fails the suite, so the count can only go down. When a duplicate goes away, remove it from the baseline (the
+ * suite says which ones are stale). Run with --write-baseline to rewrite the file from the current page.
+ */
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+const { findBrowser } = require('./lib/find-browser');
+const T = require('./test-run').configure({ name: 'one-home' });
+
+const BASE = T.BASE;
+const BASELINE = path.join(__dirname, 'fixtures', 'one-home-baseline.json');
+const WRITE = process.argv.includes('--write-baseline');
+const TABS = ['brief', 'cal', 'work', 'init', 'rep'];
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+const results = [];
+const ok = (name, cond, extra = '') => { results.push({ name, cond: !!cond }); console.log(`${cond ? '✓' : '✗'} ${name}${!cond && extra !== '' ? ' — ' + extra : ''}`); };
+let srv = null; let browser = null;
+const finish = async (code) => {
+  if (browser) await browser.close().catch(() => {});
+  if (srv) { try { srv.kill('SIGKILL'); } catch { /* gone */ } }
+  T.killTmux();
+  const bad = results.filter((x) => !x.cond).length;
+  console.log(`\n${results.length - bad}/${results.length} one-home assertions passed`);
+  process.exit(code !== undefined ? code : (bad ? 1 : 0));
+};
+process.on('unhandledRejection', (e) => { console.error(e); finish(1); });
+
+/* Runs in the page: every item in a pane that carries an action control, named by its title. */
+function collect(tab) {
+  const pane = document.querySelector('[data-c3-pane="' + tab + '"]');
+  if (!pane) return null;
+  const norm = (s) => String(s || '').replace(/\s+/g, ' ').trim().toLowerCase();
+  const visible = (e) => !!(e.offsetWidth || e.offsetHeight || e.getClientRects().length) && !e.closest('[hidden]');
+  const ITEM = '[data-row], [data-id], [data-due-row], [data-needs-row], [data-draft-row], li, article';
+  const out = new Map();
+  // A control is a button, an element with a press action (data-a), or a row that acts by itself: a swipe row or a focusable
+  // row (Work's rows have no buttons; a swipe or an arrow key is the action).
+  for (const ctl of pane.querySelectorAll('button, [data-a], [role="button"], [data-swipe], [data-row][tabindex]')) {
+    if (!visible(ctl) || ctl.disabled) continue;
+    const item = ctl.closest(ITEM);
+    if (!item || !pane.contains(item)) continue;
+    const t = item.querySelector('[data-pm-title], .tt, h2, b, strong, .t, [data-title], h3, h4');
+    const title = norm(t ? t.textContent : (item.textContent || '').split('\n')[0]).slice(0, 80);
+    if (title.length < 4) continue;
+    const id = item.getAttribute('data-id') || item.getAttribute('data-needs-row') || item.getAttribute('data-due-row') || item.getAttribute('data-draft-row') || '';
+    const label = ctl === item ? 'row' : norm(ctl.getAttribute('aria-label') || ctl.textContent).slice(0, 40);
+    if (!out.has(title)) out.set(title, { title, id, controls: [] });
+    if (!out.get(title).controls.includes(label)) out.get(title).controls.push(label);
+  }
+  return [...out.values()];
+}
+
+(async () => {
+  const exe = findBrowser();
+  if (!exe) { console.log('✗ no Chrome/Chromium on this machine — the one-home suite cannot run'); return finish(1); }
+  let chromium;
+  try { ({ chromium } = require('playwright-core')); } catch { console.log('✗ playwright-core is not installed — the one-home suite cannot run'); return finish(1); }
+
+  srv = spawn(process.execPath, [path.join(__dirname, 'server.js')], { cwd: __dirname, stdio: 'ignore', env: T.env({ PMOS_WS_PORT: String(T.PORT) }) });
+  await T.waitForServer(BASE);
+  browser = await chromium.launch({ executablePath: exe });
+  const ctx = await browser.newContext({ viewport: { width: 1440, height: 1000 } });
+  const page = await ctx.newPage();
+  const errors = [];
+  page.on('pageerror', (e) => errors.push(String(e && e.message || e)));
+  page.on('dialog', (d) => d.dismiss().catch(() => {}));
+
+  await page.goto(BASE + '/c3.html?demo=1');
+  const up = await page.waitForSelector('[data-c3-demo="1"] [data-c3-tab="brief"]', { timeout: 30000 }).catch(() => null);
+  ok('the console3 page comes up in demo mode', !!up);
+  if (!up) return finish(1);
+
+  const byTab = {};
+  for (const tab of TABS) {
+    await page.click('[data-c3-tab="' + tab + '"]');
+    // A pane builds on first show and its views read the demo's /api answers; wait until its item count settles.
+    let last = -1; let items = null;
+    for (let i = 0; i < 20; i++) {
+      await sleep(250);
+      items = await page.evaluate(collect, tab);
+      const n = items ? items.length : -1;
+      if (n === last && n > 0) break;
+      last = n;
+    }
+    byTab[tab] = items || [];
+    ok(`the ${tab} tab shows items with action controls`, byTab[tab].length > 0, JSON.stringify(items));
+  }
+
+  // Every title that has an action control on two or more tabs.
+  const where = new Map();
+  for (const tab of TABS) for (const it of byTab[tab]) {
+    if (!where.has(it.title)) where.set(it.title, []);
+    where.get(it.title).push({ tab, controls: it.controls });
+  }
+  const dupes = [...where.entries()].filter(([, w]) => w.length > 1).map(([title, w]) => ({ title, tabs: w.map((x) => x.tab) }))
+    .sort((a, b) => a.title.localeCompare(b.title));
+
+  if (process.env.ONE_HOME_DUMP) for (const tab of TABS) console.log(tab, JSON.stringify(byTab[tab].map((i) => [i.title, i.id, i.controls.join(",")])));
+  console.log(`\none-home: ${where.size} actionable items over ${TABS.length} tabs; ${dupes.length} actionable on more than one tab`);
+  for (const d of dupes) console.log(`  · ${d.tabs.join(' + ')}  ${d.title}`);
+
+  if (WRITE) {
+    fs.writeFileSync(BASELINE, JSON.stringify({
+      _comment: 'Items the console3 page makes actionable on more than one tab today (c3-one-home-test.js). Known-failing until the Phase 2 restructure of the console3 feedback plan; the suite fails only on a duplicate that is not listed here. Remove an entry when its duplicate is gone.',
+      duplicates: dupes,
+    }, null, 2) + '\n');
+    console.log(`wrote ${path.relative(__dirname, BASELINE)} with ${dupes.length} entries`);
+  }
+  const base = fs.existsSync(BASELINE) ? JSON.parse(fs.readFileSync(BASELINE, 'utf8')).duplicates || [] : [];
+  const known = new Set(base.map((d) => d.title));
+  const fresh = dupes.filter((d) => !known.has(d.title));
+  const stale = base.filter((d) => !where.has(d.title) || where.get(d.title).length < 2);
+  ok('no item is actionable on more than one tab, other than the known duplicates in the baseline', fresh.length === 0,
+    fresh.map((d) => `${d.tabs.join('+')}: ${d.title}`).join(' | '));
+  if (stale.length) console.log(`· ${stale.length} baseline entr${stale.length === 1 ? 'y is' : 'ies are'} no longer duplicated; remove ${stale.length === 1 ? 'it' : 'them'} from the baseline: ${stale.map((d) => d.title).join(' | ')}`);
+  console.log(`· known-failing: ${dupes.length - fresh.length} duplicate(s) wait for the Phase 2 restructure`);
+  ok('the page raised no script error', errors.length === 0, errors.slice(0, 3).join(' | '));
+  return finish();
+})();

package/workspace/fixtures/initiatives-api/list.json

@@ -69,7 +69,63 @@
                 "label": "7 of 12"
               },
               "next_due": "2026-11-14",
-              "last_activity": "2026-10-04T09:00:00Z"
+              "last_activity": "2026-10-04T09:00:00Z",
+              "nine_stages": [
+                {
+                  "key": "discover",
+                  "label": "Discover",
+                  "status": "pending",
+                  "accepted": false
+                },
+                {
+                  "key": "ideate",
+                  "label": "Ideate",
+                  "status": "pending",
+                  "accepted": false
+                },
+                {
+                  "key": "strategize",
+                  "label": "Strategize",
+                  "status": "pending",
+                  "accepted": false
+                },
+                {
+                  "key": "prioritize",
+                  "label": "Prioritize",
+                  "status": "pending",
+                  "accepted": false
+                },
+                {
+                  "key": "plan",
+                  "label": "Plan",
+                  "status": "pending",
+                  "accepted": false
+                },
+                {
+                  "key": "build",
+                  "label": "Build",
+                  "status": "pending",
+                  "accepted": false
+                },
+                {
+                  "key": "deliver",
+                  "label": "Deliver",
+                  "status": "pending",
+                  "accepted": false
+                },
+                {
+                  "key": "monitor",
+                  "label": "Monitor",
+                  "status": "pending",
+                  "accepted": false
+                },
+                {
+                  "key": "evaluate",
+                  "label": "Evaluate",
+                  "status": "pending",
+                  "accepted": false
+                }
+              ]
             }
           ]
         }
@@ -124,7 +180,63 @@
                 "label": "3 of 5"
               },
               "next_due": "2026-10-20",
-              "last_activity": "2026-09-29T15:00:00Z"
+              "last_activity": "2026-09-29T15:00:00Z",
+              "nine_stages": [
+                {
+                  "key": "discover",
+                  "label": "Discover",
+                  "status": "pending",
+                  "accepted": false
+                },
+                {
+                  "key": "ideate",
+                  "label": "Ideate",
+                  "status": "pending",
+                  "accepted": false
+                },
+                {
+                  "key": "strategize",
+                  "label": "Strategize",
+                  "status": "pending",
+                  "accepted": false
+                },
+                {
+                  "key": "prioritize",
+                  "label": "Prioritize",
+                  "status": "pending",
+                  "accepted": false
+                },
+                {
+                  "key": "plan",
+                  "label": "Plan",
+                  "status": "pending",
+                  "accepted": false
+                },
+                {
+                  "key": "build",
+                  "label": "Build",
+                  "status": "pending",
+                  "accepted": false
+                },
+                {
+                  "key": "deliver",
+                  "label": "Deliver",
+                  "status": "pending",
+                  "accepted": false
+                },
+                {
+                  "key": "monitor",
+                  "label": "Monitor",
+                  "status": "pending",
+                  "accepted": false
+                },
+                {
+                  "key": "evaluate",
+                  "label": "Evaluate",
+                  "status": "pending",
+                  "accepted": false
+                }
+              ]
             },
             {
               "id": "old-import",
@@ -159,7 +271,63 @@
                 "label": "no breakdown"
               },
               "next_due": null,
-              "last_activity": "2026-07-01T10:00:00Z"
+              "last_activity": "2026-07-01T10:00:00Z",
+              "nine_stages": [
+                {
+                  "key": "discover",
+                  "label": "Discover",
+                  "status": "pending",
+                  "accepted": false
+                },
+                {
+                  "key": "ideate",
+                  "label": "Ideate",
+                  "status": "pending",
+                  "accepted": false
+                },
+                {
+                  "key": "strategize",
+                  "label": "Strategize",
+                  "status": "pending",
+                  "accepted": false
+                },
+                {
+                  "key": "prioritize",
+                  "label": "Prioritize",
+                  "status": "pending",
+                  "accepted": false
+                },
+                {
+                  "key": "plan",
+                  "label": "Plan",
+                  "status": "pending",
+                  "accepted": false
+                },
+                {
+                  "key": "build",
+                  "label": "Build",
+                  "status": "pending",
+                  "accepted": false
+                },
+                {
+                  "key": "deliver",
+                  "label": "Deliver",
+                  "status": "pending",
+                  "accepted": false
+                },
+                {
+                  "key": "monitor",
+                  "label": "Monitor",
+                  "status": "pending",
+                  "accepted": false
+                },
+                {
+                  "key": "evaluate",
+                  "label": "Evaluate",
+                  "status": "pending",
+                  "accepted": false
+                }
+              ]
             }
           ]
         }