create-pmos 0.49.0 → 0.51.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.49.0",
+  "version": "0.51.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@4689fc3
 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-05T04:02:12Z"}
 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-05T04:02:12Z"}
 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-05T04:02:12Z"}
 status: stable
 ---
 

package/workspace/design-parity.js

@@ -201,6 +201,14 @@ const EXCLUSIONS = {
         { what: 'the height of the artifacts section', only: ['box'], design: { own: 'Artifacts', up: 1 }, app: { sel: '[data-cockpit="artifacts"]' } },
       ],
     },
+    {
+      name: 'column fold controls',
+      why: 'The PM could not fold the list and the detail away (2026-10-05, "i cannot minimize column 2 and 3"). Each column has a '
+        + '"⟨" control that folds it to the 36px strip, which opens it again. The board draws no fold control. Both float over the '
+        + 'column (the list\'s over the right end of "New initiative", the detail\'s at its top right), so nothing in the column moves.',
+      design: null,
+      app: { sel: '[data-fold]' },
+    },
     {
       name: 'tab: second line',
       why: 'A tab names its initiative and session under its title ("<initiative> · session <id>"): after a reload the PM could not '

package/workspace/guide/layout.md

@@ -2,7 +2,7 @@
 type: Guide
 title: "Guide: layout"
 description: "The three workspace columns: navigation, detail and tabs, and what each one holds."
-timestamp: 2026-10-04
+timestamp: 2026-10-05
 ---
 
 # Guide: layout
@@ -92,12 +92,20 @@ What a row in a list opens:
 
 ## Folding
 
+On a desktop screen, the list and the detail each have a `⟨` button. The list's button is at the right of `+ New initiative`. The detail's button is at its top right. Press it to fold that column to a thin strip. Press the strip to open the column again. The rail does not fold.
+
+In the older layout:
+
 - Choose the arrow in the header of the list to fold it to one line under the repositories. Choose the line to open it again.
 - Fold the navigation column to a thin strip. The list folds with it. Choose the strip to open it again.
 - Fold the detail column to its strip in the same way.
 
 The workspace remembers which columns are open and how wide the navigation column is.
 
+## Light theme
+
+In the light theme, the tabs column stays dark, because a terminal is dark in both themes. The tab strip and the bar under the tabs use light text on that dark band.
+
 ## On a phone
 
 A phone shows one panel at a time. The bottom bar moves between them.

package/workspace/package-lock.json

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

package/workspace/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmos-workspace",
-  "version": "0.49.0",
+  "version": "0.51.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/public/pm/panel-cockpit.js

@@ -446,15 +446,29 @@ export function renderWorkList(host) {
   // repository, so it has no files to list and does not offer the toggle (Files would only say it read nothing).
   const filesOn = !FIXTURE && !!state.filesOpen;
   if (filesOn) renderFiles(filesHost);
+  host.style.position = 'relative';   // anchors the fold control (foldList)
   setChildren(host, [
     el('div', { style: 'flex:none;display:flex;flex-direction:column;gap:12px' }, stateHealthBanner(), header, manageRow, switcher, FIXTURE ? null : filesToggle(), filesOn ? null : filterBox),
     // the rows take their own height and scroll only when they outgrow the column; "New initiative" sits at the bottom either way
     filesOn ? filesHost : el('div', { 'data-list': 'rows', style: 'flex:0 1 auto;min-height:0;overflow-y:auto;display:flex;flex-direction:column;gap:2px' }, groupsNodes),
     el('div', { style: 'flex:none;margin-top:auto;display:flex;flex-direction:column;gap:8px' }, el('div', { style: 'height:1px;background:var(--border)' }), addInit),
+    foldList(),
   ]);
   return host;
 }
 
+/** The list's fold control. The column folds to the 36px strip app.js draws ("initiatives ⟩"), which opens it again. It floats over
+ * the right end of the "New initiative" row (the host's 12px padding, then that 40px row), so nothing in the column moves. The
+ * board has no fold control; design-parity names it as an exclusion. */
+function foldList() {
+  return el('button', {
+    'data-fold': 'list', 'aria-label': 'hide the list', title: 'hide the list',
+    onClick: () => setState({ col1: false }),
+    style: 'position:absolute;right:12px;bottom:17px;height:30px;padding:0 8px;border-radius:6px;font-size:14px;color:var(--muted-foreground)',
+    hover: 'color:var(--foreground);background:var(--accent)',
+  }, '⟨');
+}
+
 /** The tab to show when the PM goes back to Work from a view: the last one that is not a view, else none. */
 function lastNonView() {
   const t = [...(state.tabs || [])].reverse().find((x) => x.kind !== 'view');

package/workspace/public/pm/panel-detail.js

@@ -1170,7 +1170,8 @@ const CK_SEP = () => el('div', { style: 'height:1px;background:var(--border)' })
 /** Title, summary and chips: the lane, the anchor and the flow, as pills. */
 function cockpitTitle(name, tag, pills) {
   return [
-    el('div', { style: 'font:600 17px var(--sans);overflow-wrap:anywhere' }, iv(name)),
+    // the right padding keeps a long name clear of the column's fold control (renderDetail)
+    el('div', { style: 'font:600 17px var(--sans);overflow-wrap:anywhere;padding-right:30px' }, iv(name)),
     el('div', { style: 'color:var(--muted-foreground)' }, iv(tag)),
     el('div', { style: 'display:flex;gap:6px;flex-wrap:wrap' }, pills.map((pl) => el('span', { style: CK_BADGE }, iv(pl.t)))),
   ];
@@ -1643,7 +1644,17 @@ export function renderDetail(host) {
       el('button', { 'data-focus': 'navigate', onClick: () => setState({ layoutFocus: false }), style: 'margin-left:auto;font:500 11px var(--sans);border:1px solid var(--border);border-radius:6px;padding:2px 8px', hover: 'background:var(--accent)' }, 'Navigate'));
     return setChildren(host, [bar, ...body]);
   }
-  return setChildren(host, bare ? body : [stickyHeader, ...body]);
+  /* The cockpit's initiative has no title bar, so its fold control floats at the column's top right. The column folds to the 36px
+   * strip app.js draws ("initiative ⟩"), which opens it again. Nothing in the column moves (design-parity names the control). */
+  host.style.position = bare ? 'relative' : '';
+  return setChildren(host, bare ? [...body, foldDetail] : [stickyHeader, ...body]);
 }
 
+const foldDetail = el('button', {
+  'data-fold': 'detail', 'aria-label': 'hide the detail', title: 'hide the detail',
+  onClick: () => setState({ col2: false }),
+  style: 'position:absolute;top:10px;right:10px;height:28px;padding:0 8px;border-radius:6px;font-size:14px;color:var(--muted-foreground)',
+  hover: 'color:var(--foreground);background:var(--accent)',
+}, '⟨');
+
 export default renderDetail;

package/workspace/public/pm/panel-tabs.js

@@ -335,7 +335,9 @@ const CHIP_STYLE = 'flex:none;align-self:center;font-family:var(--mono);font-siz
 const SPLIT_STYLE = 'flex:none;margin-left:auto;align-self:center;font-family:var(--mono);font-size:11px;color:oklch(0.85 0.01 214);padding:5px 12px;min-height:30px;background:oklch(1 0 0 / 6%);border:1px solid oklch(1 0 0 / 12%);white-space:nowrap';
 const CHIP_HOVER = 'border-color:oklch(0.56 0.021 213.5)';
 
-const tabBar = el('div', { 'data-tabs': 'bar', style: BAR_STYLE, onWheel: stripWheel });
+/* `data-term-chrome`: the strip and the bottom bar sit on --term-bg, which is dark in BOTH themes (D41), so they take the dark
+ * theme's tokens in light mode too (tokens.css). Without it the light theme's dark text was drawn on the dark band, unreadable. */
+const tabBar = el('div', { 'data-tabs': 'bar', 'data-term-chrome': '', style: BAR_STYLE, onWheel: stripWheel });
 
 /* ── the cockpit's tab strip (workspace-cockpit-nav Run 4, planning/design/cockpit-mockup/WsA.dc.html) ─────────────────────────
  * On a desktop the strip is the mockup's: a 44px band whose tabs sit on its floor, the tab in front a card with rounded top corners,
@@ -676,7 +678,7 @@ const colTitleLabel = iv('scratchpad');
 const copyLabel = iv('copy');
 
 const bottomBar = el('div', {
-  'data-tabs': 'bottom',
+  'data-tabs': 'bottom', 'data-term-chrome': '',
   style: 'display:flex;gap:10px;align-items:center;padding:5px 12px;border-top:1px solid oklch(1 0 0 / 10%);font-size:11px;color:oklch(0.6 0.02 213)',
 },
   el('button', {

package/workspace/public/pm/tokens.css

@@ -4,6 +4,11 @@
  * VERBATIM from the design prototype. Do not "improve" a value here: the acceptance bar for this
  * surface is a mechanical diff against that prototype, so an edit to a token is a defect.
  *
+ * One deliberate exception, asked for by the PM (2026-10-05, "some font not visible on light mode"): five LIGHT-theme text tokens
+ * are darker than the prototype's — --muted-foreground (0.56 → 0.48), --success, --warning, --info and --destructive — so that
+ * secondary text, status badges and warnings reach about 4.5:1 on the light surfaces. The dark theme, which the parity board
+ * compares, is untouched.
+ *
  * The faces are VENDORED (D62: the workspace is a local companion app that must render correctly
  * with no network at all). The prototype linked Google Fonts; a CDN font is network egress and is
  * forbidden here, so the same three IBM Plex Mono weights and the Space Grotesk variable face are
@@ -57,14 +62,27 @@
 [data-pm-theme="light"]{
   --background:oklch(1 0 0);--foreground:oklch(0.148 0.004 228.8);
   --card:oklch(1 0 0);--secondary:oklch(0.967 0.001 286.375);
-  --muted:oklch(0.963 0.002 197.1);--muted-foreground:oklch(0.56 0.021 213.5);
+  --muted:oklch(0.963 0.002 197.1);--muted-foreground:oklch(0.48 0.021 213.5);
   --accent:oklch(0.963 0.002 197.1);--border:oklch(0.925 0.005 214.3);--input:oklch(0.925 0.005 214.3);
   --ring:oklch(0.723 0.014 214.4);--sidebar:oklch(0.987 0.002 197.1);
   --brand:oklch(0.488 0.243 264.376);--brand-wash:color-mix(in oklab, oklch(0.488 0.243 264.376) 7%, transparent);
-  --success:oklch(0.52 0.14 152);--warning:oklch(0.55 0.12 72);--info:oklch(0.52 0.09 195);
-  --purple:oklch(0.5 0.2 300);--destructive:oklch(0.577 0.245 27.325);
+  --success:oklch(0.46 0.13 152);--warning:oklch(0.48 0.11 72);--info:oklch(0.47 0.09 195);
+  --purple:oklch(0.5 0.2 300);--destructive:oklch(0.5 0.21 27.325);
   --term-bg:oklch(0.148 0.004 228.8);
 }
+/* The tab strip and the bottom bar of the tabs panel sit on --term-bg, dark in BOTH themes (D41). In the light theme they take the
+   dark theme's tokens, so their text and controls stay readable. Copied from the :root block above; keep the two in step. */
+[data-pm-theme="light"] [data-term-chrome]{
+  --background:oklch(0.148 0.004 228.8);--foreground:oklch(0.987 0.002 197.1);
+  --card:oklch(0.218 0.008 223.9);--secondary:oklch(0.274 0.006 286.033);
+  --muted:oklch(0.275 0.011 216.9);--muted-foreground:oklch(0.723 0.014 214.4);
+  --accent:oklch(0.275 0.011 216.9);--border:oklch(1 0 0 / 10%);--input:oklch(1 0 0 / 15%);
+  --ring:oklch(0.56 0.021 213.5);--sidebar:oklch(0.218 0.008 223.9);
+  --brand:oklch(0.623 0.214 259.815);--brand-wash:color-mix(in oklab, oklch(0.623 0.214 259.815) 12%, transparent);
+  --success:oklch(0.76 0.17 152);--warning:oklch(0.82 0.15 82);--info:oklch(0.79 0.11 195);
+  --purple:oklch(0.72 0.15 300);--destructive:oklch(0.704 0.191 22.216);
+  color:var(--foreground);
+}
 @keyframes pmblink{0%,49%{opacity:1}50%,100%{opacity:0}}
 *{box-sizing:border-box}
 body{margin:0;background:oklch(0.148 0.004 228.8);-webkit-font-smoothing:antialiased}

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."
+}