create-pmos 0.49.0 → 0.50.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.49.0",
+  "version": "0.50.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@676b0dc
+kernel-source: pmos@121b0a2
 assembled: 2026-10-05
 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-05T00:43:02Z"}
+generated: {by: process:create-pmos, at: "2026-10-05T02:52:09Z"}
 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-05T00:43:02Z"}
+generated: {by: process:create-pmos, at: "2026-10-05T02:52:09Z"}
 status: stable
 ---
 

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-05T00:43:02Z"}
+generated: {by: process:create-pmos, at: "2026-10-05T02:52:09Z"}
 status: stable
 ---
 

package/workspace/package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "pmos-workspace",
-  "version": "0.49.0",
+  "version": "0.50.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {

package/workspace/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmos-workspace",
-  "version": "0.49.0",
+  "version": "0.50.0",
   "private": true,
   "description": "PMOS Terminal Workspace — local companion hosting real PTYs beside the library and gates (D62)",
   "license": "MIT",
@@ -9,15 +9,17 @@
   },
   "scripts": {
     "start": "node server.js",
-    "test": "node test.js && npm run test:modules",
-    "test:modules": "node proactive.test.js && node focus.test.js && node handoff.test.js && node repo-scan.test.js && node profiles.test.js && node external-linking.test.js && node story-artifacts.test.js && node no-network.test.js && node typesafe-validation.test.js && node claims.test.js && node status-facts-panel.test.js && node jev-claims.test.js && node jev-categorize.test.js && node jev-status.test.js && node jev-route.test.js && node repo-watch.test.js && node fixture-parity.test.mjs && node markdown.test.mjs && node start-policy.test.js && node state-isolation.test.js && node sync.test.js && node schedule-cli.test.js && node initiative-surface.test.js && node guide.test.js && node next-step-actions.test.js && node kg.test.js && node doc-category.test.js && node doc-category-corrections.test.js && node proactive-prepare.test.js && node learn.test.js && node session-flag.test.js && node live-notes.test.js",
+    "test": "node run-tests.js unit",
+    "test:modules": "node run-tests.js modules",
     "test:ui": "node ui-test.js",
     "test:parity": "node design-parity.js --board=WsA",
     "test:parity:four-panel": "node design-parity.js --states",
-    "test:all": "npm test && npm run test:panels && npm run test:ui && npm run test:parity && npm run test:offline",
+    "test:all": "node run-tests.js all && npm run test:parity && npm run test:offline",
     "doctor": "node doctor.js",
-    "test:panels": "node pm-shell-test.js && node pm-repos-test.js && node pm-initiatives-test.js && node pm-detail-test.js && node pm-tabs-test.js && node pm-term-test.js && node pm-modes-test.js && node pm-r1-test.js && node pm-r2-test.js && node pm-r3-test.js && node pm-r4-test.js && node pm-r5-test.js && node pm-r6-test.js && node pm-r7-test.js && node pm-r8-test.js && node pm-r9-test.js && node pm-r10-test.js && node pm-r11-test.js && node pm-r12-test.js && node pm-r13-test.js && node pm-r14-test.js && node pm-r15-test.js && node pm-r16-test.js && node pm-r17-test.js && node pm-r16-test.js && node pm-r18-test.js && node pm-r19-test.js && node pm-r20-test.js && node pm-r21-test.js && node pm-r22-test.js && node pm-r23-test.js && node pm-r24-test.js && node pm-r25-test.js && node pm-r26-test.js && node pm-doc-category-test.js && node pm-r27-test.js && node pm-r28-test.js && node pm-r29-today-test.js && node pm-r29-portfolio-test.js && node pm-r29-knowledge-test.js && node pm-r29-memory-test.js && node pm-r29-skills-scheduled-test.js && node pm-r29-validate-guide-test.js && node pm-r29-reports-addrepo-test.js && node pm-r29-filespad-test.js && node pm-r29-newsession-alignment-test.js && node pm-live-notes-test.js && node pm-r30-test.js",
-    "test:offline": "node offline-tarball.test.js"
+    "test:panels": "node run-tests.js panels",
+    "test:offline": "node offline-tarball.test.js",
+    "test:browser": "node run-tests.js browser",
+    "test:list-check": "node run-tests.js --check"
   },
   "engines": {
     "node": ">=18"

package/workspace/run-tests.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+'use strict';
+/* run-tests.js — run the workspace suites side by side.
+ *
+ *   node run-tests.js <group> [--jobs=N] [--shard=I/N] [--list] [--verbose]
+ *   node run-tests.js --check
+ *
+ * Groups come from test-files.json: unit (test.js + modules), modules, panels, ui, browser
+ * (panels + ui), all. The npm scripts call this file, so `npm test` and CI run the same lists.
+ *
+ * Running in parallel is safe because every suite claims its own ephemeral port, scratch state
+ * directory and private tmux socket (test-run.js, or the same three lines written out in the
+ * suite). It was checked rather than assumed: on 2026-10-05 all 48 browser suites ran four at a
+ * time with no failure that the serial run did not also show.
+ *
+ * Nothing is skipped. --shard splits a group across CI jobs; the shards partition the list (every
+ * file in exactly one shard), and --check fails when a suite on disk is in no list, so a new suite
+ * that nobody wired in is a red build rather than a suite that runs nowhere.
+ *
+ * Output: a suite's own output is buffered and printed whole when it finishes, so lines from two
+ * suites never interleave. A passing suite prints its last lines; --verbose prints all of it.
+ */
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawn } = require('child_process');
+
+const DIR = __dirname;
+const FILES = JSON.parse(fs.readFileSync(path.join(DIR, 'test-files.json'), 'utf8'));
+const GROUPS = {
+  unit: [...FILES.unit, ...FILES.modules],
+  modules: FILES.modules,
+  panels: FILES.panels,
+  ui: FILES.ui,
+  browser: [...FILES.panels, ...FILES.ui],
+  all: [...FILES.unit, ...FILES.modules, ...FILES.panels, ...FILES.ui],
+};
+// Suites that run elsewhere on purpose, so --check does not count them as unwired.
+const ELSEWHERE = {
+  'offline-tarball.test.js': 'npm run test:offline (needs a packed tarball)',
+};
+const PER_FILE_TIMEOUT_MS = 10 * 60 * 1000;
+
+const args = process.argv.slice(2);
+const flag = (name) => { const a = args.find((x) => x === `--${name}` || x.startsWith(`--${name}=`)); return a === undefined ? undefined : (a.includes('=') ? a.slice(a.indexOf('=') + 1) : true); };
+const group = args.find((a) => !a.startsWith('--'));
+
+const secs = (f) => Number((FILES.seconds || {})[f]) || 10;
+// Slowest first, so a long suite never starts last and holds the run open on its own.
+const bySlowest = (list) => list.map((f, k) => ({ f, k })).sort((a, b) => secs(b.f) - secs(a.f) || a.k - b.k).map((x) => x.f);
+
+// Deal the suites, slowest first, each to the shard with the least time so far (ties to the lower
+// shard). Deterministic, so every CI job computes the same split, and a partition by construction:
+// each suite goes to exactly one shard. --check proves the partition for every shard count it tries.
+function shardOf(list, spec) {
+  const m = /^(\d+)\/(\d+)$/.exec(String(spec));
+  if (!m) throw new Error(`--shard must look like 1/4, got "${spec}"`);
+  const i = Number(m[1]); const n = Number(m[2]);
+  if (n < 1 || i < 1 || i > n) throw new Error(`--shard ${spec}: the index must be between 1 and ${n}`);
+  const load = new Array(n).fill(0); const out = Array.from({ length: n }, () => []);
+  for (const f of bySlowest(list)) {
+    let best = 0; for (let k = 1; k < n; k++) if (load[k] < load[best]) best = k;
+    out[best].push(f); load[best] += secs(f);
+  }
+  return out[i - 1];
+}
+
+function check() {
+  const listed = new Set(GROUPS.all);
+  const problems = [];
+  const dupes = GROUPS.all.filter((f, k) => GROUPS.all.indexOf(f) !== k);
+  for (const f of new Set(dupes)) problems.push(`${f} is listed more than once in test-files.json`);
+  for (const f of listed) if (!fs.existsSync(path.join(DIR, f))) problems.push(`${f} is listed in test-files.json but does not exist`);
+  for (const f of FILES.exclusive || []) if (!listed.has(f)) problems.push(`${f} is marked exclusive but is in no test list`);
+  const onDisk = fs.readdirSync(DIR).filter((f) => f === 'test.js' || /(\.test\.(js|mjs)|-test\.js)$/.test(f));
+  for (const f of onDisk) if (!listed.has(f) && !ELSEWHERE[f]) problems.push(`${f} is a suite on disk that no test list runs. Add it to test-files.json.`);
+  for (const n of [2, 3, 4, 6, 8]) for (const g of ['unit', 'browser']) {
+    const parts = Array.from({ length: n }, (_, k) => shardOf(GROUPS[g], `${k + 1}/${n}`)).flat();
+    if (parts.length !== GROUPS[g].length || new Set(parts).size !== GROUPS[g].length) problems.push(`--shard does not partition "${g}" into ${n}`);
+  }
+  if (problems.length) { for (const p of problems) console.error(`✗ ${p}`); process.exitCode = 1; return; }
+  console.log(`✓ ${listed.size} suites listed, each once, each on disk; ${onDisk.length - Object.keys(ELSEWHERE).length} suites on disk, all listed; shards partition every group.`);
+}
+
+function runOne(file, verbose) {
+  return new Promise((resolve) => {
+    const t0 = Date.now();
+    const chunks = [];
+    const child = spawn(process.execPath, [file], { cwd: DIR, env: process.env, stdio: ['ignore', 'pipe', 'pipe'] });
+    child.stdout.on('data', (d) => chunks.push(d));
+    child.stderr.on('data', (d) => chunks.push(d));
+    let timedOut = false;
+    const timer = setTimeout(() => { timedOut = true; child.kill('SIGKILL'); }, PER_FILE_TIMEOUT_MS);
+    child.on('close', (code, signal) => {
+      clearTimeout(timer);
+      const secs = ((Date.now() - t0) / 1000).toFixed(1);
+      const out = Buffer.concat(chunks).toString('utf8').replace(/\s+$/, '');
+      const ok = code === 0 && !timedOut;
+      const why = timedOut ? `timed out after ${PER_FILE_TIMEOUT_MS / 60000} min` : (signal ? `killed by ${signal}` : `exit ${code}`);
+      const lines = out.split('\n');
+      const body = ok && !verbose ? lines.slice(-3).join('\n') : out;
+      process.stdout.write(`\n── ${ok ? 'PASS' : 'FAIL'} ${file} (${secs}s${ok ? '' : ', ' + why}) ──\n${body}\n`);
+      resolve({ file, ok, secs: Number(secs), why });
+    });
+  });
+}
+
+async function main() {
+  if (flag('check')) return check();
+  if (!group || !GROUPS[group]) {
+    console.error(`usage: node run-tests.js <${Object.keys(GROUPS).join('|')}> [--jobs=N] [--shard=I/N] [--list] [--verbose]\n       node run-tests.js --check`);
+    process.exitCode = 2; return;
+  }
+  let list = GROUPS[group];
+  const shard = flag('shard');
+  list = shard ? shardOf(list, shard) : bySlowest(list);
+  if (flag('list')) { console.log(list.join('\n')); return; }
+  const cpus = typeof os.availableParallelism === 'function' ? os.availableParallelism() : os.cpus().length;
+  // A browser suite runs a server, a tmux daemon and a Chromium of its own, and several of them assert
+  // on timing. At one per CPU they starved each other: 2 of 48 failed per run on a 4-CPU machine, a
+  // different 2 each time, all green alone. Half the CPUs for any group with browser suites in it
+  // kept every run green. --jobs or PMOS_TEST_JOBS still overrides.
+  const hasBrowser = list.some((f) => FILES.panels.includes(f) || FILES.ui.includes(f));
+  const auto = hasBrowser ? Math.max(1, Math.floor(cpus / 2)) : cpus;
+  const jobs = Math.max(1, Number(flag('jobs')) || Number(process.env.PMOS_TEST_JOBS) || auto);
+  const verbose = !!flag('verbose');
+  console.log(`run-tests: ${group}${shard ? ` shard ${shard}` : ''} — ${list.length} suites, ${jobs} at a time`);
+
+  const t0 = Date.now();
+  const results = [];
+  // An exclusive suite writes the checkout's own state, so it runs alone: first the shared suites side
+  // by side, then each exclusive one with nothing beside it.
+  const exclusive = new Set(FILES.exclusive || []);
+  const shared = list.filter((f) => !exclusive.has(f));
+  let next = 0;
+  const worker = async () => { while (next < shared.length) { const f = shared[next++]; results.push(await runOne(f, verbose)); } };
+  await Promise.all(Array.from({ length: Math.min(jobs, shared.length) }, worker));
+  for (const f of list.filter((x) => exclusive.has(x))) results.push(await runOne(f, verbose));
+
+  const failed = results.filter((r) => !r.ok);
+  const slowest = [...results].sort((a, b) => b.secs - a.secs).slice(0, 5).map((r) => `${r.file} ${r.secs}s`).join(', ');
+  console.log(`\nrun-tests: ${results.length - failed.length}/${results.length} suites passed in ${((Date.now() - t0) / 1000).toFixed(1)}s wall. Slowest: ${slowest}.`);
+  // exitCode, never process.exit(): stdout to a pipe is asynchronous, and exiting here cut the CI log
+  // off mid-suite, before the summary that names what failed.
+  if (failed.length) { console.log(`FAILED: ${failed.map((r) => `${r.file} (${r.why})`).join(', ')}`); process.exitCode = 1; }
+}
+
+main().catch((e) => { console.error(e); process.exitCode = 1; });

package/workspace/server.js

@@ -2296,8 +2296,11 @@ function checkDueSchedules() {
   } catch {}
   return fired;
 }
-// the tick — the persistent server checks on an interval; unref'd so it never blocks exit
-try { const _tick = setInterval(() => { checkDueSchedules(); proactiveTick(); try { prepareTick({ manual: false }); } catch { /* the next tick tries again */ } }, 60000); if (_tick.unref) _tick.unref(); } catch {}
+// the tick — the persistent server checks on an interval; unref'd so it never blocks exit.
+// PMOS_TICK_MS exists for the suites (same footing as PMOS_LIVENESS_MS): proactive-prepare.test.js
+// used to wait on two real minutes of this clock. Unset, the interval is the 60 seconds it always was.
+const TICK_MS = Math.max(200, Number(process.env.PMOS_TICK_MS) || 60000);
+try { const _tick = setInterval(() => { checkDueSchedules(); proactiveTick(); try { prepareTick({ manual: false }); } catch { /* the next tick tries again */ } }, TICK_MS); if (_tick.unref) _tick.unref(); } catch {}
 
 // ── Sessions: real PTYs, owned by the server, with disk-backed scrollback + metadata. ──
 /** @type {Map<string, {id,ws,name,agent,cwd,state,note,created,pty,buf,cols,rows,clients:Set}>} */

package/workspace/test-files.json

@@ -0,0 +1,180 @@
+{
+  "_comment": "The test files each npm test script runs. run-tests.js reads this file; add a new suite here and every runner, local and CI, picks it up. Every suite claims its own port, state directory and tmux socket (test-run.js or its own equivalent), which is what makes running them side by side safe.",
+  "_comment_exclusive": "Suites that write the checkout's own state (workspace/state/, the home workspace's ledgers) while they run. run-tests.js runs each of them with nothing else beside it, because suites that read the checkout as their home workspace (proactive.test.js's scan, for one) would see those writes mid-run.",
+  "exclusive": [
+    "test.js"
+  ],
+  "unit": [
+    "test.js"
+  ],
+  "modules": [
+    "proactive.test.js",
+    "focus.test.js",
+    "handoff.test.js",
+    "repo-scan.test.js",
+    "profiles.test.js",
+    "external-linking.test.js",
+    "story-artifacts.test.js",
+    "no-network.test.js",
+    "typesafe-validation.test.js",
+    "claims.test.js",
+    "status-facts-panel.test.js",
+    "jev-claims.test.js",
+    "jev-categorize.test.js",
+    "jev-status.test.js",
+    "jev-route.test.js",
+    "repo-watch.test.js",
+    "fixture-parity.test.mjs",
+    "markdown.test.mjs",
+    "start-policy.test.js",
+    "state-isolation.test.js",
+    "sync.test.js",
+    "schedule-cli.test.js",
+    "initiative-surface.test.js",
+    "guide.test.js",
+    "next-step-actions.test.js",
+    "kg.test.js",
+    "doc-category.test.js",
+    "doc-category-corrections.test.js",
+    "proactive-prepare.test.js",
+    "learn.test.js",
+    "session-flag.test.js",
+    "live-notes.test.js"
+  ],
+  "panels": [
+    "pm-shell-test.js",
+    "pm-repos-test.js",
+    "pm-initiatives-test.js",
+    "pm-detail-test.js",
+    "pm-tabs-test.js",
+    "pm-term-test.js",
+    "pm-modes-test.js",
+    "pm-r1-test.js",
+    "pm-r2-test.js",
+    "pm-r3-test.js",
+    "pm-r4-test.js",
+    "pm-r5-test.js",
+    "pm-r6-test.js",
+    "pm-r7-test.js",
+    "pm-r8-test.js",
+    "pm-r9-test.js",
+    "pm-r10-test.js",
+    "pm-r11-test.js",
+    "pm-r12-test.js",
+    "pm-r13-test.js",
+    "pm-r14-test.js",
+    "pm-r15-test.js",
+    "pm-r16-test.js",
+    "pm-r17-test.js",
+    "pm-r18-test.js",
+    "pm-r19-test.js",
+    "pm-r20-test.js",
+    "pm-r21-test.js",
+    "pm-r22-test.js",
+    "pm-r23-test.js",
+    "pm-r24-test.js",
+    "pm-r25-test.js",
+    "pm-r26-test.js",
+    "pm-doc-category-test.js",
+    "pm-r27-test.js",
+    "pm-r28-test.js",
+    "pm-r29-today-test.js",
+    "pm-r29-portfolio-test.js",
+    "pm-r29-knowledge-test.js",
+    "pm-r29-memory-test.js",
+    "pm-r29-skills-scheduled-test.js",
+    "pm-r29-validate-guide-test.js",
+    "pm-r29-reports-addrepo-test.js",
+    "pm-r29-filespad-test.js",
+    "pm-r29-newsession-alignment-test.js",
+    "pm-live-notes-test.js",
+    "pm-r30-test.js"
+  ],
+  "ui": [
+    "ui-test.js"
+  ],
+  "seconds": {
+    "test.js": 48,
+    "proactive.test.js": 4,
+    "focus.test.js": 1,
+    "handoff.test.js": 1,
+    "repo-scan.test.js": 1,
+    "profiles.test.js": 1,
+    "external-linking.test.js": 1,
+    "story-artifacts.test.js": 1,
+    "no-network.test.js": 1,
+    "typesafe-validation.test.js": 1,
+    "claims.test.js": 1,
+    "status-facts-panel.test.js": 1,
+    "jev-claims.test.js": 3,
+    "jev-categorize.test.js": 1,
+    "jev-status.test.js": 1,
+    "jev-route.test.js": 1,
+    "repo-watch.test.js": 1,
+    "fixture-parity.test.mjs": 1,
+    "markdown.test.mjs": 1,
+    "start-policy.test.js": 1,
+    "state-isolation.test.js": 4,
+    "sync.test.js": 4,
+    "schedule-cli.test.js": 3,
+    "initiative-surface.test.js": 3,
+    "guide.test.js": 1,
+    "next-step-actions.test.js": 5,
+    "kg.test.js": 1,
+    "doc-category.test.js": 1,
+    "doc-category-corrections.test.js": 1,
+    "proactive-prepare.test.js": 9,
+    "learn.test.js": 3,
+    "session-flag.test.js": 1,
+    "live-notes.test.js": 3,
+    "pm-shell-test.js": 6,
+    "pm-repos-test.js": 3,
+    "pm-initiatives-test.js": 15,
+    "pm-detail-test.js": 16,
+    "pm-tabs-test.js": 59,
+    "pm-term-test.js": 28,
+    "pm-modes-test.js": 18,
+    "pm-r1-test.js": 6,
+    "pm-r2-test.js": 3,
+    "pm-r3-test.js": 3,
+    "pm-r4-test.js": 4,
+    "pm-r5-test.js": 3,
+    "pm-r6-test.js": 2,
+    "pm-r7-test.js": 1,
+    "pm-r8-test.js": 1,
+    "pm-r9-test.js": 2,
+    "pm-r10-test.js": 1,
+    "pm-r11-test.js": 1,
+    "pm-r12-test.js": 6,
+    "pm-r13-test.js": 2,
+    "pm-r14-test.js": 7,
+    "pm-r15-test.js": 35,
+    "pm-r16-test.js": 7,
+    "pm-r17-test.js": 3,
+    "pm-r18-test.js": 4,
+    "pm-r19-test.js": 18,
+    "pm-r20-test.js": 4,
+    "pm-r21-test.js": 4,
+    "pm-r22-test.js": 32,
+    "pm-r23-test.js": 13,
+    "pm-r24-test.js": 4,
+    "pm-r25-test.js": 9,
+    "pm-r26-test.js": 9,
+    "pm-doc-category-test.js": 4,
+    "pm-r27-test.js": 26,
+    "pm-r28-test.js": 9,
+    "pm-r29-today-test.js": 4,
+    "pm-r29-portfolio-test.js": 3,
+    "pm-r29-knowledge-test.js": 3,
+    "pm-r29-memory-test.js": 4,
+    "pm-r29-skills-scheduled-test.js": 6,
+    "pm-r29-validate-guide-test.js": 20,
+    "pm-r29-reports-addrepo-test.js": 4,
+    "pm-r29-filespad-test.js": 5,
+    "pm-r29-newsession-alignment-test.js": 8,
+    "pm-live-notes-test.js": 24,
+    "pm-r30-test.js": 4,
+    "ui-test.js": 30
+  },
+  "_comment_seconds": "Measured wall time of each suite run alone (4-CPU sandbox, 2026-10-05). Only the ORDER uses it: the slowest suites start first, and --shard deals suites to the least-loaded shard so the shards finish together. A wrong or missing number never skips a suite; a missing one counts as 10."
+}