create-pmos 0.51.0 → 0.53.0

package/workspace/lib/work-check-needs.js

@@ -0,0 +1,99 @@
+'use strict';
+/* work-check-needs.js — the work that waits for the PM to check it: the needs-you rows of R12 kind 4
+ * (pm-os-absorb Run 4, slice 4D).
+ *
+ *   kinds: item-review · item-no-evidence · release
+ *   rowsFor(w, { lead }) → rows       sig(w) → string      (lib/needs-providers.js folds both into /api/needs and Today)
+ *
+ * R7: Review means the maker has finished and someone else must judge; when that judge is the PM, the item is on Today.
+ * The three rows:
+ *   - item-review      an item in Review whose maker is an agent or a person other than the PM (owner `agent` or
+ *                      `person:<name>`). The PM's own item in Review waits for someone else, and a tracker item is judged
+ *                      in the tracker, so neither is a row. A proposed item is not yet kept, so it is not a row either.
+ *   - item-no-evidence an item the agent moved to Done with no evidence pointer (R7: "no evidence" reaches Today).
+ *   - release          a D65 batch whose items all passed their checks (lib/factory-join.js batches, ready). One row for
+ *                      each batch; one press mints ONE release grant for it (POST /api/board/release).
+ * Each row is for a WORK-lane initiative only (D86 point 4); a document-lane initiative has no row.
+ *
+ * A release row's initiative and batch are in its run_id (`work-check-needs:release:<initiative>:<batch>`), so the row keeps
+ * the golden's keys (fixtures/today-api/provider-rows.json) and the card reads them from there.
+ * A row's `today` is the card's payload: { kind: 4, source: 'work-check-needs', cause, evidence, act: { label, cli } }.
+ * public/pm/release-card.js draws all three kinds: the Release card, and an item card that shows the item's title. `lead` false answers []: these rows are repository-wide, and a linked
+ * worktree registered beside its main tree would count every row twice (lib/needs-providers.js).
+ *
+ * `sig(w)` names every file the rows read: plan-items and the factory join (which reads the work-item ledger), and the
+ * initiative records, plan-rules.json and the grants ledger (boardFold.sideSig).
+ */
+const crypto = require('crypto');
+const path = require('path');
+const planItems = require('./plan-items.js');
+const factoryJoin = require('./factory-join.js');
+const boardFold = require('./board-fold.js');
+
+const kinds = ['item-review', 'item-no-evidence', 'release'];
+const SOURCE = 'work-check-needs';
+
+const judgedByPm = (owner) => owner === 'agent' || /^person:/.test(String(owner || ''));
+const noun = (n) => (n === 1 ? '1 work item' : `${n} work items`);
+
+/** The ledger paths a row cites, relative to the repository: the runs directory beside plan-items.jsonl. */
+function evidencePaths(root) {
+  let plan = 'planning/runs/plan-items.jsonl';
+  try { plan = path.relative(path.resolve(root), planItems.ledgerPath(root)).split(path.sep).join('/'); } catch { /* the default stands */ }
+  const dir = path.posix.dirname(plan);
+  const factory = dir === 'planning/runs' ? 'planning/work-items.jsonl' : dir + '/work-items.jsonl';
+  return { plan, factory };
+}
+
+function rowsFor(w, { lead } = {}) {
+  if (!lead) return [];
+  const root = w.root;
+  const works = new Set(boardFold.workInitiatives(root).map((i) => i.id));
+  const ev = evidencePaths(root);
+  const rows = [];
+  const fold = planItems.readFold(root);
+  for (const id of fold.order) {
+    const it = fold.items[id];
+    if (!works.has(it.initiative) || it.proposed) continue;
+    if (it.state === 'review' && judgedByPm(it.owner)) {
+      rows.push({
+        run_id: `${SOURCE}:review:${id}`, kind: 'item-review', initiative_id: it.initiative, doc: null,
+        question: `"${it.title}" is in Review`,
+        today: { kind: 4, source: SOURCE, cause: 'An item waits in Review', evidence: ev.plan, act: { label: 'Open', cli: null } },
+      });
+    } else if (it.state === 'done' && it.noEvidence) {
+      rows.push({
+        run_id: `${SOURCE}:no-evidence:${id}`, kind: 'item-no-evidence', initiative_id: it.initiative, doc: null,
+        question: `"${it.title}" reads Done with no evidence`,
+        today: { kind: 4, source: SOURCE, cause: 'An agent item is Done with no evidence', evidence: ev.plan, act: { label: 'Open', cli: null } },
+      });
+    }
+  }
+  const join = factoryJoin.joinFactory(root);
+  const granted = boardFold.releaseGrants(root);   // a batch that was released has no row
+  for (const init of Object.keys(join.byInit || {}).sort()) {
+    if (!works.has(init)) continue;
+    for (const b of (join.byInit[init].batches || [])) {
+      if (!b || !b.ready || granted.has(`${init}:${b.id}`)) continue;
+      const n = (b.items || []).length;
+      rows.push({
+        run_id: `${SOURCE}:release:${init}:${b.id}`, kind: 'release', initiative_id: init, doc: null,
+        question: `${noun(n)} ${n === 1 ? 'is' : 'are'} ready to release`,
+        today: { kind: 4, source: SOURCE, cause: 'A factory batch is ready', evidence: ev.factory, act: { label: 'Release', cli: null } },
+      });
+    }
+  }
+  return rows;
+}
+
+function sig(w) {
+  let items = 'none';
+  try { items = planItems.ledgerSigs([{ id: w.id, root: w.root }], '')[w.id].items; } catch { items = 'unreadable'; }
+  let factory = 'none';
+  try { factory = crypto.createHash('sha1').update(JSON.stringify(factoryJoin.joinFactory(w.root).byInit || {})).digest('hex'); } catch { factory = 'unreadable'; }
+  let side = 'none';
+  try { side = boardFold.sideSig(w.root); } catch { side = 'unreadable'; }
+  return `${items}:${factory}:${side}`;
+}
+
+module.exports = { kinds, rowsFor, sig };

package/workspace/package-lock.json

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

package/workspace/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmos-workspace",
-  "version": "0.51.0",
+  "version": "0.53.0",
   "private": true,
   "description": "PMOS Terminal Workspace — local companion hosting real PTYs beside the library and gates (D62)",
   "license": "MIT",
@@ -12,13 +12,13 @@
     "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": "node run-tests.js all && npm run test:parity && npm run test:offline",
+    "test:all": "node run-tests.js all && npm run test:offline",
     "doctor": "node doctor.js",
     "test:panels": "node run-tests.js panels",
     "test:offline": "node offline-tarball.test.js",
+    "test:conformance": "node conformance-gate.js --self-test && node conformance-gate.js --base origin/main",
     "test:browser": "node run-tests.js browser",
+    "test:changed": "node run-tests.js all --changed",
     "test:list-check": "node run-tests.js --check"
   },
   "engines": {
@@ -32,7 +32,7 @@
     "playwright-core": "^1.61.1",
     "ws": "^8.18.0"
   },
-  "//devDependencies": "design-parity's pixel axis only. Kept OUT of dependencies deliberately: `create-pmos workspace` installs this package with `npm install -g`, which takes dependencies and not devDependencies, so an adopter installing a local PM tool does not also install a screenshot differ. design-parity.js requires both optionally and degrades to text+style+geometry when they are absent, so the parity check still runs — it just stops measuring pixels, and says so.",
+  "//devDependencies": "pixelmatch and pngjs have no consumer since design-parity.js was deleted (Run 3, slice 3D). They stay listed until a later chore removes them. Kept OUT of dependencies deliberately: `create-pmos workspace` installs this package with `npm install -g`, which takes dependencies and not devDependencies.",
   "devDependencies": {
     "pixelmatch": "^7.1.0",
     "pngjs": "^7.0.0"

package/workspace/public/index.html

@@ -3,6 +3,7 @@
 <head>
 <meta charset="utf-8" />
 <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
+<meta name="pmos-nonce" content="" />
 <title>PMOS workspace</title>
 <!-- The terminal's face is preloaded, not left to be discovered. An @font-face is only fetched when
      something first RENDERS in it, which for Plex Mono is about the same moment a tab constructs
@@ -59,6 +60,12 @@
      file scripts/md-newlines.js requires, loaded here as window.MdNormalize, so the one-click
      repair and the CI ratchet can never disagree about what a normalized document is. -->
 <script src="/lib/md-normalize.js"></script>
+<!-- pm-os-absorb: the words an initiative shows (R3), read from its derived ladder and never typed. The same file the
+     server and the report drafter require, loaded here as window.PMOSInitiativeDisplay. -->
+<script src="/lib/initiative-display.js"></script>
+<!-- pm-os-absorb: the dated bars of a breakdown (R20), one engine for both Timelines and the report strip, loaded here
+     as window.PMOSItemSpans. -->
+<script src="/lib/item-spans.js"></script>
 <link rel="preload" href="/vendor/ibm-plex-mono-500.woff2" as="font" type="font/woff2" crossorigin />
 </head>
 <body>
@@ -71,13 +78,15 @@
      breakpoint this is absent from the accessibility tree rather than merely invisible: a desktop
      PM must not be able to tab into a second navigation system they cannot see. -->
 
-<!-- The top bar: back · the screen's name · the ⌘K jump palette · theme. It sits ABOVE .body in
+<!-- The top bar: back · Repository · the screen's name · the ⌘K palette · Settings (the frame; the old shell shows its
+     brand and theme in place of Repository and Settings). It sits ABOVE .body in
      DOM order because it is the row above the content on screen, and putting it beside the bottom
      nav would read the app backwards. -->
 <div class="mob" id="mobShell" hidden>
   <header class="mob-bar" id="mobBar">
-    <button class="mob-back" id="mobBack" type="button" hidden aria-label="Back">‹ back</button>
-    <span class="mob-brand" id="mobBrand" aria-hidden="true">◎</span>
+    <button class="mob-back" id="mobBack" type="button" hidden aria-label="Back"><svg class="pmc-icon" width="16" height="16" aria-hidden="true" focusable="false" data-icon="chevron-left"><use href="#lucide-chevron-left"></use></svg><span>Back</span></button>
+    <span class="mob-brand" id="mobBrand" aria-hidden="true">PMOS</span>
+    <button class="mob-repo" id="mobRepo" type="button" hidden aria-haspopup="menu">Repository</button>
     <span class="mob-title" id="mobTitle"></span>
     <!-- The jump palette lives HERE, not in the control bar below. Two reasons, and the second is
          the binding one: it is not a terminal control key (every other button in the bar writes a
@@ -87,32 +96,33 @@
          palette is a jump control for every destination, so it belongs in the bar that is always
          on screen. -->
     <button class="mob-pal" id="mobPalette" type="button" aria-label="Open the jump palette (⌘K)">⌘K</button>
-    <button class="mob-theme" id="mobTheme" type="button" aria-label="Toggle theme">◐</button>
+    <button class="mob-theme" id="mobTheme" type="button" aria-label="Toggle theme"><svg class="pmc-icon" width="16" height="16" aria-hidden="true" focusable="false" data-icon="moon"><use href="#lucide-moon"></use></svg></button>
+    <button class="mob-sync" id="mobSync" type="button" hidden>Sync</button>
+    <button class="mob-set" id="mobSettings" type="button" hidden aria-current="false">Settings</button>
   </header>
 </div>
 
 <!-- The bottom block: a terminal control-key accessory bar (terminal screen only — phones have no
-     Esc/Tab/Ctrl/arrows) over the five-destination nav. The nav is a <nav> of buttons carrying
-     aria-current, NOT a tablist: the retired markup declared role="tablist" over role="tab"
-     children with no tabpanel and no aria-controls anywhere, which is a promise the DOM did not
-     keep. Selecting a destination resets it to its root; depth is pushed on top of it and #mobBack
-     pops one screen. The glyphs are the mobile prototype's own (◧ ◔ ◐ ◒ ☰). -->
+     Esc/Tab/Ctrl/arrows) over the five tabs (pm-os-absorb Run 3, slice 3A): Today · Initiatives · Board · Reports ·
+     Agent. The first four are the frame's places; Agent is the dock with its live terminals. The nav is a <nav> of
+     buttons carrying aria-current, NOT a tablist: there is no tabpanel to point at. Selecting a tab resets it to its
+     root; depth is pushed on top of it and #mobBack pops one screen. Words, not glyphs, name each tab. -->
 <div class="mobmenu" id="mobMenu" hidden>
   <div class="ctrlbar" id="ctrlBar" role="toolbar" aria-label="Terminal control keys">
     <button type="button" data-seq="esc" aria-label="Escape"><span class="lbl">esc</span></button>
     <button type="button" data-seq="tab" aria-label="Tab"><span class="lbl">tab</span></button>
     <button type="button" id="ctrlKey" aria-pressed="false" aria-label="Control modifier (one-shot)"><span class="lbl">ctrl</span></button>
-    <button type="button" data-seq="left" aria-label="Left arrow">←</button>
-    <button type="button" data-seq="up" aria-label="Up arrow">↑</button>
-    <button type="button" data-seq="down" aria-label="Down arrow">↓</button>
-    <button type="button" data-seq="right" aria-label="Right arrow">→</button>
+    <button type="button" data-seq="left" aria-label="Left arrow"><svg class="pmc-icon" width="16" height="16" aria-hidden="true" focusable="false" data-icon="arrow-left"><use href="#lucide-arrow-left"></use></svg></button>
+    <button type="button" data-seq="up" aria-label="Up arrow"><svg class="pmc-icon" width="16" height="16" aria-hidden="true" focusable="false" data-icon="arrow-up"><use href="#lucide-arrow-up"></use></svg></button>
+    <button type="button" data-seq="down" aria-label="Down arrow"><svg class="pmc-icon" width="16" height="16" aria-hidden="true" focusable="false" data-icon="arrow-down"><use href="#lucide-arrow-down"></use></svg></button>
+    <button type="button" data-seq="right" aria-label="Right arrow"><svg class="pmc-icon" width="16" height="16" aria-hidden="true" focusable="false" data-icon="arrow-right"><use href="#lucide-arrow-right"></use></svg></button>
   </div>
-  <nav class="mobnav" id="mobNav" aria-label="Sections">
-    <button type="button" class="mobnav-b" data-dest="board" aria-current="page"><span class="g" aria-hidden="true">◧</span><span class="l">board</span></button>
-    <button type="button" class="mobnav-b" data-dest="scheduled" aria-current="false"><span class="g" aria-hidden="true">◔</span><span class="l">scheduled</span></button>
-    <button type="button" class="mobnav-b" data-dest="agents" aria-current="false"><span class="g" aria-hidden="true">◐</span><span class="l">agents</span></button>
-    <button type="button" class="mobnav-b" data-dest="memory" aria-current="false"><span class="g" aria-hidden="true">◒</span><span class="l">memory</span></button>
-    <button type="button" class="mobnav-b" data-dest="more" aria-current="false"><span class="g" aria-hidden="true">☰</span><span class="l">more</span></button>
+  <nav class="mobnav" id="mobNav" aria-label="Destinations">
+    <button type="button" class="mobnav-b" data-dest="today" aria-current="page"><span class="l">Today</span><span class="mobnav-n" id="mobTodayCount" hidden></span></button>
+    <button type="button" class="mobnav-b" data-dest="initiatives" aria-current="false"><span class="l">Initiatives</span></button>
+    <button type="button" class="mobnav-b" data-dest="board" aria-current="false"><span class="l">Board</span></button>
+    <button type="button" class="mobnav-b" data-dest="reports" aria-current="false"><span class="l">Reports</span></button>
+    <button type="button" class="mobnav-b" data-dest="agent" aria-current="false"><span class="l">Agent</span></button>
   </nav>
 </div>