create-pmos 0.50.0 → 0.52.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.50.0",
+  "version": "0.52.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@121b0a2
+kernel-source: pmos@a6425d1
 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-05T02:52:09Z"}
+generated: {by: process:create-pmos, at: "2026-10-05T21:40:45Z"}
 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-05T02:52:09Z"}
+generated: {by: process:create-pmos, at: "2026-10-05T21:40:45Z"}
 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-05T02:52:09Z"}
+generated: {by: process:create-pmos, at: "2026-10-05T21:40:45Z"}
 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.50.0",
+  "version": "0.52.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {

package/workspace/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmos-workspace",
-  "version": "0.50.0",
+  "version": "0.52.0",
   "private": true,
   "description": "PMOS Terminal Workspace — local companion hosting real PTYs beside the library and gates (D62)",
   "license": "MIT",
@@ -19,6 +19,7 @@
     "test:panels": "node run-tests.js panels",
     "test:offline": "node offline-tarball.test.js",
     "test:browser": "node run-tests.js browser",
+    "test:changed": "node run-tests.js all --changed",
     "test:list-check": "node run-tests.js --check"
   },
   "engines": {

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

@@ -2,7 +2,7 @@
 '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 <group> [--jobs=N] [--shard=I/N] [--changed[=REF]] [--list] [--verbose]
  *   node run-tests.js --check
  *
  * Groups come from test-files.json: unit (test.js + modules), modules, panels, ui, browser
@@ -17,6 +17,11 @@
  * 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.
  *
+ * --changed is for the LOCAL inner loop only. It narrows the group to the suites a diff against REF
+ * (default origin/main) can reach, and runs the whole group whenever it cannot tell. CI never passes
+ * it: Workspace CI runs every suite on every PR, so a suite --changed leaves out still runs before
+ * the merge. See changedSuites() for the rule.
+ *
  * 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.
  */
@@ -65,6 +70,53 @@ function shardOf(list, spec) {
   return out[i - 1];
 }
 
+// Files every page or every suite loads. A change to one can break any suite, so --changed runs
+// the whole group. A changed file no suite can be traced to is treated the same way (see below).
+const WIDE = new Set([
+  'server.js', 'test-run.js', 'run-tests.js', 'test-files.json', 'package.json', 'package-lock.json',
+  'public/pm/app.js', 'public/pm/state.js', 'public/pm/dom.js', 'public/pm/data.js',
+  'public/pm/tokens.css', 'public/pm/fixture.js', 'public/pm/mobile.css', 'lib/find-browser.js',
+]);
+
+/* The suites in `list` that the diff against `ref` can reach. A suite is selected when its own file
+ * changed, when its source names a changed file (`panel-tabs` in pm-tabs-test.js), or when its file
+ * name carries the changed file's stem with any panel-/view-/tab- prefix removed (view-memory.js ->
+ * pm-r29-memory-test.js). It errs toward running MORE: a WIDE file, or a changed workspace file that
+ * no suite can be traced to, selects the whole list. Returns { files, suites, why }. */
+function changedSuites(list, ref) {
+  const git = (...a) => {
+    const r = require('child_process').spawnSync('git', a, { cwd: DIR, encoding: 'utf8' });
+    return r.status === 0 ? r.stdout : null;
+  };
+  const top = (git('rev-parse', '--show-toplevel') || '').trim();
+  if (!top) return { files: [], suites: list, why: 'not a git checkout, so every suite runs' };
+  const base = (git('merge-base', 'HEAD', ref) || '').trim();
+  if (!base) return { files: [], suites: list, why: `no merge base with ${ref} (fetch it first), so every suite runs` };
+  const prefix = path.relative(top, DIR).split(path.sep).join('/') + '/';
+  const names = [
+    git('diff', '--name-only', base), // committed on this branch and uncommitted changes
+    git('ls-files', '--others', '--exclude-standard', '--full-name', DIR),
+  ].join('\n').split('\n').map((f) => f.trim()).filter(Boolean);
+  const files = [...new Set(names)].filter((f) => f.startsWith(prefix)).map((f) => f.slice(prefix.length));
+  if (!files.length) return { files, suites: [], why: `nothing under workspace/ differs from ${ref}` };
+  const wide = files.filter((f) => WIDE.has(f));
+  if (wide.length) return { files, suites: list, why: `${wide.join(', ')} changed, and every suite depends on it` };
+  const source = new Map(list.map((f) => [f, fs.existsSync(path.join(DIR, f)) ? fs.readFileSync(path.join(DIR, f), 'utf8') : '']));
+  const picked = new Set();
+  const untraced = [];
+  for (const f of files) {
+    if (source.has(f)) { picked.add(f); continue; }
+    if (/^(guide|docs)\/|\.md$/.test(f)) continue; // prose: no suite asserts on it except guide.test.js, a unit suite
+    const stem = path.basename(f).replace(/\.[^.]+$/, '');
+    const key = stem.replace(/^(panel|view|tab)-/, '');
+    const hits = list.filter((s) => source.get(s).includes(stem) || s.includes(`-${key}-`) || s.includes(`-${key}.`));
+    if (!hits.length) untraced.push(f);
+    for (const h of hits) picked.add(h);
+  }
+  if (untraced.length) return { files, suites: list, why: `no suite names ${untraced.slice(0, 3).join(', ')}${untraced.length > 3 ? ' …' : ''}, so every suite runs` };
+  return { files, suites: list.filter((f) => picked.has(f)), why: `${files.length} changed file(s) reach these suites` };
+}
+
 function check() {
   const listed = new Set(GROUPS.all);
   const problems = [];
@@ -114,6 +166,14 @@ async function main() {
   let list = GROUPS[group];
   const shard = flag('shard');
   list = shard ? shardOf(list, shard) : bySlowest(list);
+  const changed = flag('changed');
+  if (changed) {
+    const ref = changed === true ? 'origin/main' : changed;
+    const pick = changedSuites(list, ref);
+    console.log(`run-tests: --changed against ${ref}: ${pick.why}. ${pick.suites.length} of ${list.length} suites run here; CI runs all ${list.length}.`);
+    list = pick.suites;
+    if (!list.length) return;
+  }
   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

package/workspace/test-files.json

@@ -131,7 +131,7 @@
     "pm-repos-test.js": 3,
     "pm-initiatives-test.js": 15,
     "pm-detail-test.js": 16,
-    "pm-tabs-test.js": 59,
+    "pm-tabs-test.js": 50,
     "pm-term-test.js": 28,
     "pm-modes-test.js": 18,
     "pm-r1-test.js": 6,