create-pmos 0.136.0 → 0.137.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.136.0",
+  "version": "0.137.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@2bbc680
+kernel-source: pmos@6693e56
 assembled: 2026-10-12
 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-12T00:52:51Z"}
+generated: {by: process:create-pmos, at: "2026-10-12T00:57:28Z"}
 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-12T00:52:51Z"}
+generated: {by: process:create-pmos, at: "2026-10-12T00:57:28Z"}
 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-12T00:52:51Z"}
+generated: {by: process:create-pmos, at: "2026-10-12T00:57:28Z"}
 status: stable
 ---
 

package/workspace/guide/data-freshness.md

@@ -1,7 +1,7 @@
 ---
 type: Guide
 title: "Data freshness: how the workspace keeps up to date, and how old each source is"
-timestamp: 2026-10-11
+timestamp: 2026-10-12
 ---
 
 # Data freshness
@@ -37,4 +37,12 @@ The events are kept in your own runtime folder on this machine, never in a repos
 
 ## Where you see it
 
-Each page shows a short **as of** line for the sources it reads. The line turns amber when a source is older than its limit, and says **never read** when nothing was read yet. Settings › Data freshness shows every source in one table: when it was read, its state, its schedule, and **Refresh**.
+Each page shows a short line under its title that says when each source was last read, for example **Initiatives read 08:02 · Calendar read 07:15 · Jira status read 06:31**. The line never says that the data is up to date, because the agents read these sources on a schedule and not live.
+
+- A source older than its limit is amber.
+- A source that was never read says **not read yet**, in amber.
+- A source whose last read failed is red and says when it was last read.
+- A watched repository is not named, because the workspace checks it every few seconds.
+- When a source is old, failed or never read, a **Refresh** button for the first of them follows the line.
+
+Settings › Data freshness shows every source in one table: when it was read, its state, its schedule, and **Refresh**.

package/workspace/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pmos-workspace",
-  "version": "0.136.0",
+  "version": "0.137.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pmos-workspace",
-      "version": "0.136.0",
+      "version": "0.137.0",
       "license": "MIT",
       "dependencies": {
         "@xterm/addon-fit": "^0.11.0",

package/workspace/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmos-workspace",
-  "version": "0.136.0",
+  "version": "0.137.0",
   "private": true,
   "description": "PMOS Terminal Workspace — local companion hosting real PTYs beside the library and gates (D62)",
   "license": "MIT",

package/workspace/public/pm/c3-shell.js

@@ -117,7 +117,7 @@ function header() {
   S.tools.append(S.gearBtn);
   S.moreBtn = ibtn('More', 'more', { 'aria-haspopup': 'menu', 'aria-expanded': 'false', 'data-c3pg': 'more', onclick: toggleMore });
   S.tools.append(el('span', { class: 'c3pg-menuwrap' }, S.moreBtn));
-  /* workspace-data-freshness R9: how old the sources are, quiet when they are up to date (freshness-line.js) */
+  /* workspace-data-freshness R9: when each source was last read, never "up to date" (freshness-line.js) */
   S.fresh = S.demo ? null : freshnessLine(S.ws);
   return el('div', { class: 'c3top' }, el('div', null, S.ttl, S.sub, S.fresh), S.tools);
 }

package/workspace/public/pm/components.css

@@ -3511,9 +3511,10 @@
 .fr-fresh__state--fresh { color: var(--foreground); }
 .fr-fresh__state--stale { color: var(--warning); }
 .fr-fresh__state--failed { color: var(--destructive); }
-.fr-fresh__state--never,
+.fr-fresh__state--never { color: var(--warning); }
 .fr-fresh__state--building,
 .fr-fresh__state--off { color: var(--muted-foreground); }
+.fr-fresh__sep { color: var(--muted-foreground); }
 .fr-fresh-table__grid {
   width: 100%;
   border-collapse: collapse;

package/workspace/public/pm/freshness-line.js

@@ -1,7 +1,9 @@
 /* pm/freshness-line.js — how old each source of the workspace is (workspace-data-freshness R9).
  *
- *   freshnessLine(ws)   → element   the console header's short line: the sources that are old or never read, else
- *                                   "Up to date"; a Refresh button for the oldest one. Updates itself every 15 s.
+ *   freshnessLine(ws)   → element   the console header's short line: when each source was last read ("Calendar read
+ *                                   07:15 · Jira status read 08:02"), the old, failed and never-read ones flagged, and
+ *                                   a Refresh button for the first of those. It never says "up to date": the sources
+ *                                   are read on a schedule, not live (pm/freshness-words.js). Updates itself every 15 s.
  *   freshnessTable(ws)  → element   Settings › Data freshness: every source, when it was read, its state, its schedule,
  *                                   Refresh, and the repository's Watch for changes switch.
  *
@@ -13,6 +15,7 @@
 import { el, setChildren } from './dom.js';
 import { pmGet, pmPost } from './http.js';
 import { button, SEL } from './primitives.js';
+import { lineItems, behindOf } from './freshness-words.js';
 
 const POLL_MS = 15000;
 const live = new Map();   // kind|ws -> { node, timer, version }
@@ -26,7 +29,7 @@ function ago(iso) {
   if (ms < 24 * 3600000) return 'today ' + hhmm(iso);
   return Math.round(ms / (24 * 3600000)) + ' d ago';
 }
-const STATE_WORD = { fresh: 'Up to date', stale: 'Old', never: 'Never read', building: 'Reading…', failed: 'Failed', off: 'Off' };
+const STATE_WORD = { fresh: 'Recent', stale: 'Old', never: 'Never read', building: 'Reading…', failed: 'Failed', off: 'Off' };
 // the colour of a state: a class in components.css (.fr-fresh__state--<state>), coloured from the tokens
 const tone = (state) => 'fr-fresh__state fr-fresh__state--' + (STATE_WORD[state] ? state : 'never');
 const label = (b, t) => { const l = b.querySelector(SEL.btnLabel); (l || b).textContent = t; };
@@ -64,20 +67,22 @@ function poll(key, ws, draw) {
   return cur.node;
 }
 
-/** The header line: quiet when everything is fresh, amber names when a source is old or never read. */
+/** The header line: when each source was last read, old, failed and never-read ones flagged. It never claims "up to date". */
 export function freshnessLine(ws) {
   return poll('line|' + ws, ws, (node, d) => {
     const n = node || el('div', { class: 'fr-fresh', 'data-c3pg': 'freshness' });
-    if (!d) { if (!node) n.textContent = ''; return n; }
-    const watched = d.sources.filter((s) => s.state !== 'off');
-    const behind = watched.filter((s) => s.state === 'stale' || s.state === 'failed' || (s.state === 'never' && s.schedule));
-    const building = watched.find((s) => s.state === 'building');
+    if (!d) { if (node) setChildren(n, [el('span', { class: tone('never') }, 'Could not read when the sources were read')]); else n.textContent = ''; return n; }
+    const items = lineItems(d.sources);
+    const behind = behindOf(items);
     const kids = [];
-    if (!behind.length) kids.push(el('span', { class: tone('fresh') }, building ? 'Reading the repository…' : 'Data up to date'));
-    for (const s of behind.slice(0, 3)) kids.push(el('span', { class: tone(s.state), title: STATE_WORD[s.state] }, s.label + ' ' + ago(s.as_of)));
+    items.forEach((it, i) => {
+      if (i) kids.push(el('span', { class: 'fr-fresh__sep', 'aria-hidden': 'true' }, '·'));
+      kids.push(el('span', { class: tone(it.state), title: it.title, 'data-fr-line': it.id }, it.text));
+    });
     if (behind.length) {
       const first = behind[0];
-      const btn = button({ label: 'Refresh ' + first.label, size: 'sm', attrs: { 'data-c3pg': 'freshness-refresh' },
+      const src = d.sources.find((s) => s.id === first.id);
+      const btn = button({ label: 'Refresh ' + (src ? src.label : first.id), size: 'sm', attrs: { 'data-c3pg': 'freshness-refresh' },
         onClick: () => refresh(d.ws, first.id, btn) });
       kids.push(btn);
     }

package/workspace/public/pm/freshness-words.js

@@ -0,0 +1,46 @@
+/* pm/freshness-words.js — the words of the header's freshness line (pm/freshness-line.js). No DOM, so a suite can import it.
+ *
+ *   lineItems(sources, now?) → [{ id, state, text, title }]   one honest phrase per source: when it was last read, or
+ *                                                             that it was never read, failed or is reading now
+ *   behindOf(items)          → [item]                         the sources to flag: old, failed or never read
+ *   whenRead(iso, now?)      → '07:15' | 'yesterday 18:02' | '3 d ago'
+ *
+ * The line never says "up to date". Calendar, Jira, My work and tracker items are read by an agent on a schedule, not
+ * live, so the line says when each was read and lets the PM judge. A watched repository is checked every few seconds,
+ * so it is named only when it is not watched as it should be.
+ */
+const H = 3600000;
+const two = (n) => String(n).padStart(2, '0');
+const hhmm = (d) => two(d.getHours()) + ':' + two(d.getMinutes());
+const dayStart = (d) => new Date(d.getFullYear(), d.getMonth(), d.getDate()).getTime();
+
+export function whenRead(iso, now = Date.now()) {
+  const t = Date.parse(iso);
+  if (!iso || Number.isNaN(t)) return '';
+  const d = new Date(t);
+  const today = dayStart(new Date(now));
+  if (t >= today) return hhmm(d);
+  if (t >= today - 24 * H) return 'yesterday ' + hhmm(d);
+  return Math.max(2, Math.round((today - dayStart(d)) / (24 * H))) + ' d ago';
+}
+
+const limitWord = (ms) => (ms >= 48 * H ? Math.round(ms / (24 * H)) + ' days' : Math.round(ms / H) + ' hours');
+
+export function lineItems(sources, now = Date.now()) {
+  const out = [];
+  for (const s of sources || []) {
+    if (!s || s.state === 'off') continue;
+    if (s.id === 'repository' && s.state === 'fresh') continue;   // watched: checked every few seconds
+    const at = whenRead(s.as_of, now);
+    let text; let title;
+    if (s.state === 'building') { text = s.label + ' reading…'; title = 'Being read now'; }
+    else if (s.state === 'never') { text = s.label + ' not read yet'; title = 'Never read on this machine'; }
+    else if (s.state === 'failed') { text = s.label + ' failed' + (at ? ', last read ' + at : ''); title = 'The last read failed'; }
+    else if (s.state === 'stale') { text = s.label + ' read ' + at; title = s.stale_after_ms ? 'Older than ' + limitWord(s.stale_after_ms) : 'Changed since it was read'; }
+    else { text = s.label + ' read ' + at; title = 'Last read ' + (s.as_of ? new Date(Date.parse(s.as_of)).toLocaleString() : ''); }
+    out.push({ id: s.id, state: s.state, text, title });
+  }
+  return out;
+}
+
+export const behindOf = (items) => items.filter((i) => i.state === 'stale' || i.state === 'failed' || i.state === 'never');