create-pmos 0.187.0 → 0.188.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.187.0",
+  "version": "0.188.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@74de0bc
+kernel-source: pmos@856b541
 assembled: 2026-10-13
 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-13T05:30:39Z"}
+generated: {by: process:create-pmos, at: "2026-10-13T06:02:00Z"}
 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-13T05:30:39Z"}
+generated: {by: process:create-pmos, at: "2026-10-13T06:02:00Z"}
 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-13T05:30:39Z"}
+generated: {by: process:create-pmos, at: "2026-10-13T06:02:00Z"}
 status: stable
 ---
 

package/workspace/guide/my-work.md

@@ -112,6 +112,7 @@ The row chip then shows the agent's state:
 | **Agent: draft ready** | The draft waits for you. |
 | **Agent: posting** | You approved the draft. A session posts exactly that text. |
 | **Posted to** the item | The draft went out. Select **Open what was posted** to see it. |
+| **Agent: needs you** | The agent asked you something, or waits for your OK to run a step, in its session. The case file gives the question. Select **Open the session** and answer it there: the job carries on. |
 | **Agent stopped** | The job failed or you stopped it. The case file gives the reason. Select **Try again** to run it again. |
 
 The page reads the state again every 15 seconds while an agent is queued, working or posting.

package/workspace/lib/day-run.js

@@ -243,7 +243,7 @@ function decide(run, taskId, op, now) {
     const stalled = !!t.stalled_session;
     // the PM's own text is sent again as it is: a retry never asks an agent to draft over it
     t.status = t.draft && t.draft.by === 'pm' ? 'sending' : 'waiting'; keepSession(t); t.error = null; t.decided = { action: 'retry', at };
-    if (stalled) { t.prev_session = null; delete t.stalled_session; delete t.stalled_status; }
+    if (stalled) { t.prev_session = null; delete t.stalled_session; delete t.stalled_status; delete t.asks; }
     return null;
   });
 }
@@ -303,14 +303,14 @@ function sessionEnded(run, sessionId, now) {
 function revive(t) {
   if (t.status !== 'failed' || !t.stalled_session || !t.stalled_status) return;
   t.status = t.stalled_status; t.session_id = t.stalled_session; t.error = null;
-  delete t.stalled_session; delete t.stalled_status; delete t.failed_at;
+  delete t.stalled_session; delete t.stalled_status; delete t.failed_at; delete t.asks;
 }
 
 /**
  * A task session is open but has printed nothing for a long time and delivered nothing: it waits on a question, or its
  * agent stopped without reporting. The task fails with `why`, which frees its place, and a retry starts a NEW session.
  */
-function sessionStalled(run, sessionId, why, now) {
+function sessionStalled(run, sessionId, why, now, { asks = null } = {}) {
   if (!run) return { ok: false, error: 'no day run today' };
   const next = clone(run);
   let changed = false;
@@ -318,6 +318,7 @@ function sessionStalled(run, sessionId, why, now) {
     if (!sessionId || t.session_id !== sessionId || (t.status !== 'working' && t.status !== 'sending')) continue;
     t.stalled_status = t.status; t.stalled_session = sessionId; t.session_id = null; t.prev_session = null;
     t.status = 'failed'; t.error = text(why).slice(0, 240) || 'the session stopped without a draft'; t.failed_at = iso(now); changed = true;
+    if (asks) t.asks = asks; else delete t.asks;
   }
   return { ok: true, run: next, changed };
 }

package/workspace/lib/my-work.js

@@ -195,7 +195,8 @@ function stateOf(item, presses, runs) {
   if (last.action === 'handle') return { state: 'yours', sub: null, task: null, instruction: null, decided_at: last.at };
   const t = taskOf(runs, last);
   const task = t ? { id: t.id, status: t.status, error: t.error || null, draft: t.draft ? t.draft.summary : null, body: t.draft ? t.draft.body || null : null,
-    sent: t.sent || null, started_at: t.started_at || null, revisions: Array.isArray(t.revisions) ? t.revisions.length : 0 } : null;
+    sent: t.sent || null, started_at: t.started_at || null, revisions: Array.isArray(t.revisions) ? t.revisions.length : 0,
+      session: t.stalled_session || null, asks: t.asks || null } : null;
   const base = { task, instruction: last.instruction, decided_at: last.at };
   if (!t) return { state: 'agent', sub: 'waiting', ...base };
   if (t.status === 'review') return { state: 'ready', sub: 'review', ...base };

package/workspace/lib/work-assigned.js

@@ -33,7 +33,7 @@ function agentOf(x) {
     state, suggest: x.suggest || null, instruction: x.instruction || null,
     draft: t && (t.draft || t.body) ? { summary: t.draft || null, body: t.body || null } : null,
     sent: t && t.sent ? { link: t.sent.link || null, at: t.sent.at || null } : null,
-    error: t ? t.error || null : null, revisions: t ? t.revisions || 0 : 0, started_at: t ? t.started_at || null : null, decided_at: x.decided_at || null,
+    error: t ? t.error || null : null, session: t && t.session ? String(t.session) : null, asks: t ? t.asks || null : null, revisions: t ? t.revisions || 0 : 0, started_at: t ? t.started_at || null : null, decided_at: x.decided_at || null,
   };
 }
 

package/workspace/package-lock.json

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

package/workspace/package.json

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

package/workspace/public/pm/console3.css

@@ -1583,6 +1583,7 @@
 .c3 .raw{background:var(--muted);border-radius:8px;padding:var(--sp-2) var(--sp-3);font:var(--fs-1)/1.6 var(--mono);color:var(--muted-foreground);overflow-wrap:anywhere;white-space:pre-wrap}
 .c3 .c3t-card .draft{background:var(--muted);border-radius:10px;padding:var(--sp-3);font-size:var(--fs-3);white-space:pre-wrap;overflow-wrap:anywhere}
 .c3 .c3t-tray{display:flex;gap:var(--sp-2);flex-wrap:wrap;align-items:center}
+.c3 .c3t-grow{flex:1}
 .c3 .c3t-tray input,.c3 .c3t-panel input{flex:1;min-width:120px;border:1px solid var(--border);border-radius:99px;padding:6px 12px;background:var(--card);color:var(--foreground);font:inherit;font-size:var(--fs-2)}
 .c3 .c3t-tray input[readonly],.c3 .c3t-panel input[readonly]{opacity:.6;cursor:not-allowed}
 .c3 .c3t-card .pill.rec{background:var(--acc);color:var(--on-accent);border-color:var(--acc)}
@@ -1884,6 +1885,8 @@
 .c3 .wk-agent-ask input{flex:1;min-width:0;font:inherit;font-size:var(--fs-2);padding:4px 8px;border:1px solid var(--border);background:var(--background);color:var(--foreground);border-radius:6px}
 .c3 .wk-agent-ask[hidden]{display:none}
 .c3 .wk-agent-sheet{display:grid;gap:var(--sp-3)}
+.c3 .wk-agent-st{display:inline-flex;align-items:center;gap:4px;max-width:100%;min-width:0}
+.c3 .wk-agent-tx{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .c3 .wk-agent-will{font-size:var(--fs-2)}
 .c3 .wk-agent-sum{margin:0}
 .c3 .wk-agent-body{--tc:var(--acc)}

package/workspace/public/pm/pm-work-view.js

@@ -707,14 +707,15 @@ const minsAgo = (iso) => { const t = Date.parse(iso); if (!Number.isFinite(t)) r
 const whereOf = (item) => (item.origin === 'jira' ? 'Jira' : 'its source');
 const AG = {
   can: (t) => 'Agent can: ' + t, queued: 'Agent: queued', working: (ago) => 'Agent: working' + (ago ? ' · started ' + ago : ''), ready: 'Agent: draft ready',
-  sending: 'Agent: posting', sent: (w, at) => 'Posted to ' + w + (at ? ' ' + at : ''), failed: (why) => 'Agent stopped' + (why ? ': ' + why : ''),
+  sending: 'Agent: posting', sent: (w, at) => 'Posted to ' + w + (at ? ' ' + at : ''), failed: (asks) => (asks ? 'Agent: needs you' : 'Agent stopped'),
   sitSuggest: (w) => `The agent can draft this for you. You read it here first. Nothing goes to ${w} until you post it.`,
   sitQueued: 'Queued. The agent starts as soon as a session is free. You can close this page.',
   sitWorking: 'The agent is working on it. You can close this page: the item keeps its state.',
   sitReady: (at, w) => `Draft ready${at ? ' at ' + at : ''}. Nothing went to ${w}.`,
   sitSending: (k) => `Posting to ${k}. A session does exactly the step you approved and nothing else.`,
   sitSent: (at, w) => `You posted it to ${w}${at ? ' at ' + at : ''}.`,
-  sitFailed: (why) => `The agent stopped${why ? ': ' + why : '.'} Nothing was sent.`,
+  sitFailed: (why, asks) => (asks && why ? why.charAt(0).toUpperCase() + why.slice(1) + ' Nothing was sent.' : `The agent stopped${why ? ': ' + why : '.'} Nothing was sent.`),
+  openSession: 'Open the session',
   willDo: 'What the agent will do: ', change: 'Change what the agent does', askLabel: 'What the agent will do',
   draftIt: 'Let the agent draft this', tryAgain: 'Try again', post: (k) => 'Post it to ' + k, back: 'Send it back with a note', keepDraft: 'Keep it as a draft',
   noteLabel: 'Tell the agent what to change', openDraft: 'Open the draft', draftSheet: (k) => 'Draft for ' + k, stop: 'stop',
@@ -725,14 +726,14 @@ const AG = {
 
 function agentChip(item) {
   const a = item.agent; if (!a || item.mock_row) return null;
-  const st = (cls, ic, text, spin) => el('span', { class: cls, 'data-pm-agent-state': a.state, 'data-pm-suggest': item.id }, spin ? el('span', { class: 'c3spin' }, c3ic(ic, 'sm')) : c3ic(ic, 'sm'), text);
+  const st = (cls, ic, text, spin) => el('span', { class: cls + ' wk-agent-st', 'data-pm-agent-state': a.state, 'data-pm-suggest': item.id, title: text }, spin ? el('span', { class: 'c3spin' }, c3ic(ic, 'sm')) : c3ic(ic, 'sm'), el('span', { class: 'wk-agent-tx' }, text));
   if (a.state === 'suggest') return st('chip2', 'spark', AG.can(a.instruction || a.suggest || ''));
   if (a.state === 'queued') return st('st', 'clock', AG.queued);
   if (a.state === 'working') return st('st c3strip', 'spark', AG.working(minsAgo(a.started_at)), true);
   if (a.state === 'ready') return st('st ok', 'check', AG.ready);
   if (a.state === 'sending') return st('st c3strip', 'out', AG.sending, true);
   if (a.state === 'sent') return st('st ok', 'out', AG.sent(whereOf(item), a.sent && a.sent.at ? hhmm(a.sent.at) : ''));
-  if (a.state === 'failed') return st('tag warn', 'alert', AG.failed(a.error));
+  if (a.state === 'failed') return st('tag warn', 'alert', AG.failed(a.asks));
   return null;
 }
 
@@ -755,7 +756,8 @@ function agentCase(inst, item, L) {
   const strip = (spin, ic, text) => el('div', { class: 'c3ag', 'data-pm-agent-strip': item.id }, el('div', { class: 'fold a', role: 'status' }, spin ? el('span', { class: 'c3spin' }, c3ic(ic, 'sm')) : c3ic(ic, 'sm'), ' ' + text + ' ',
     c3btn('chip2 lk', { 'data-pm-agent-stop': item.id }, [c3ic('stop', 'sm'), AG.stop], () => agentPress(inst, '/api/my-work/stop', { item: item.id }, AG.stopped))));
   if (a.state === 'suggest' || a.state === 'failed') {
-    sit = a.state === 'failed' ? AG.sitFailed(a.error) : AG.sitSuggest(w);
+    sit = a.state === 'failed' ? AG.sitFailed(a.error, a.asks) : AG.sitSuggest(w);
+    if (a.state === 'failed' && a.session) extras.push(el('div', { class: 'chips2' }, c3btn('chip2 lk', { 'data-pm-agent-session': a.session }, [c3ic('term', 'sm'), AG.openSession], () => openAgentSession(a.session, item))));
     const brief = () => agentPress(inst, '/api/my-work/act', { action: 'brief', item: item.id, instruction: ask(), ws: inst.ctx.ws }, AG.handed(w));
     const retry = () => agentPress(inst, '/api/my-work/decide', { item: item.id, action: 'retry' }, AG.retried);
     opts = [o('agent', a.state === 'failed' ? AG.tryAgain : AG.draftIt, [fx('spark', 'Drafts it here in PMOS', 'ok'), fx('lock', 'Nothing goes to ' + w, 'ok')], a.state === 'failed' ? retry : brief), ...own];
@@ -805,6 +807,10 @@ function agentCase(inst, item, L) {
   return { model, run };
 }
 
+function openAgentSession(id, item) {
+  try { window.dispatchEvent(new CustomEvent('pmos:open-session', { detail: { id, name: 'Job · ' + (item.key || item.title || '') } })); } catch { /* no event */ }
+}
+
 function openDraft(item) {
   const a = item.agent || {}; const d = a.draft || {};
   const body = el('div', { class: 'wk-agent-sheet' },

package/workspace/public/pm/run-card.js

@@ -103,6 +103,11 @@ function pausedBox(ctx, card) {
 }
 // a session that has not started may be at the CLI's trust-the-folder question, where a typed Enter would answer it
 const NOSTART = 'Open the session to see what it waits for: typing into it now could answer a question you have not read.';
+function flipBtn(ui, ctx) {
+  const b = button({ variant: 'ghost', onClick: () => { ui.flip = true; ctx.redraw(); }, attrs: { class: 'ib', 'aria-label': 'Flip to the case file', title: 'Case file' } });
+  b.replaceChildren(ic('flip', 'sm'));
+  return b;
+}
 export function openBtn(ctx) {
   const b = button({ label: 'Open the session', onClick: () => ctx.openSession && ctx.openSession(ctx.id), attrs: { class: 'pill c3t-open', 'data-open-session': '', title: 'Open the session: its real terminal, on this page' } });
   b.prepend(ic('term', 'sm'));
@@ -210,10 +215,12 @@ function draw(host, ctx) {
   else {
     kids.push(el('h3', null, done && card.result.headline ? card.result.headline : (ctx.name || card.title)));
     const strip = stripNode(card, ctx.observed); if (strip) kids.push(strip);
+    // every box but the question and the permission carries Open the session; a card with none of them gets its own below
+    let opened = false;
     if (perms.length) perms.forEach((p) => kids.push(permissionBox(ctx, p)));
     else if (card.state === 'asking' && card.ask) kids.push(questionBox(ctx, card));
-    else if (card.state === 'paused') kids.push(pausedBox(ctx, card));
-    else if (ui.hidden !== card.state + ':' + ((card.failure && card.failure.code) || '')) { const f = failBox(ctx, card, ui); if (f) kids.push(f); }
+    else if (card.state === 'paused') { kids.push(pausedBox(ctx, card)); opened = true; }
+    else if (ui.hidden !== card.state + ':' + ((card.failure && card.failure.code) || '')) { const f = failBox(ctx, card, ui); if (f) { kids.push(f); opened = true; } }
     if (card.state === 'permission' && !perms.length) kids.push(dim('Waiting for your permission. Open the session to see it.'));
     if (done) {
       kids.push(...resultNodes(card.result, { ui, redraw: ctx.redraw, fileBody: ctx.fileBody }).filter(Boolean));
@@ -225,7 +232,9 @@ function draw(host, ctx) {
     if (ui.voice) kids.push(voiceNode(ctx, ui));
     else if (ui.tray) kids.push(trayNode(ctx, card, ui));
     if (!done && !ui.tray && !ui.voice && !perms.length && card.state !== 'asking' && !['working', 'queued'].includes(card.state)) { /* a failure box carries its own moves */ }
-    if (!done && !ctx.readonly) kids.push(el('div', { class: 'c3t-tray' }, el('span', { style: 'flex:1' }), el('button', { type: 'button', class: 'ib', 'aria-label': 'Flip to the case file', title: 'Case file', onclick: () => { ui.flip = true; ctx.redraw(); } }, ic('flip', 'sm'))));
+    // a starting or working run shows Open the session on its face: a read-only card (a job PMOS started) has no case file to flip to
+    if (!done && (!ctx.readonly || (!opened && ctx.openSession && !ctx.ended))) kids.push(el('div', { class: 'c3t-tray' }, !opened && ctx.openSession && !ctx.ended ? openBtn(ctx) : null, el('span', { class: 'c3t-grow' }),
+      ctx.readonly ? null : flipBtn(ui, ctx)));
   }
   const art = el('article', { class: 'c3t-card' + (['working', 'queued'].includes(card.state) ? ' busy' : '') + (ui.flash ? ' flash' : ''), 'data-run-card': card.state || '', 'data-run-id': ctx.id, 'aria-label': ctx.name || ctx.id }, ...kids);
   host.replaceChildren(el('div', { class: 'c3 c3e' }, art));

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

@@ -39,7 +39,7 @@ function outcomeOf(card, meta) {
 function cardHost(st, s, card, extra) {
   const host = el('div', { 'data-run-host': s.id });
   const ctx = { id: s.id, name: s.name, card, observed: st.data.demo && st.data.demo.observed ? st.data.demo.observed[s.id] : null, origin: s.origin === 'manual' ? (s.cardId ? 'on a card' : 'started by you') : s.origin, src: st.src,
-    refresh: st.refresh, openSession: st.openSession, glossary: st.data.demo && st.data.demo.glossary, fileBody: st.data.demo && st.data.demo.fileBody, accepted: false, ...(extra || {}) };
+    refresh: st.refresh, openSession: st.openSession, ended: s.endedAt != null, glossary: st.data.demo && st.data.demo.glossary, fileBody: st.data.demo && st.data.demo.fileBody, accepted: false, ...(extra || {}) };
   mountRunCard(host, ctx);
   return host;
 }
@@ -172,7 +172,7 @@ function draw(host, st) {
   const running = auto.filter((s) => s.endedAt == null).length;
   const sw = el('button', { type: 'button', class: 'c3t-sw', role: 'switch', 'aria-checked': String(st.showAuto), 'aria-label': 'Show automatic sessions', 'data-sessions-auto': '', onclick: () => { st.showAuto = !st.showAuto; st.redraw(); } }, el('i'));
   root.append(section('bolt', 'Automatic', auto.length, el('span', { class: 'chips2' }, dim(auto.length + ' today' + (running ? ', ' + running + ' running' : '')), sw), st.showAuto
-    ? (auto.length ? el('ul', { class: 'list', 'data-c3t': 'auto' }, auto.map((s) => { const c = cards[s.id]; return row(st, s, c, { sub: s.origin + ' · ' + (s.endedAt == null ? 'running' : 'ended') + ' · ' + ago(s.startedAt) + ' · ' + outcomeOf(c), body: c ? [cardHost(st, s, c, { readonly: true })] : [dim('No card yet.')] }); })) : none('None.'))
+    ? (auto.length ? el('ul', { class: 'list', 'data-c3t': 'auto' }, auto.map((s) => { const c = cards[s.id]; return row(st, s, c, { sub: s.origin + ' · ' + (s.endedAt == null ? 'running' : 'ended') + ' · ' + ago(s.startedAt) + ' · ' + outcomeOf(c), body: c ? [cardHost(st, s, c, { readonly: true })] : [dim('No card yet.'), s.endedAt == null ? el('div', { class: 'c3t-tray' }, openBtn({ id: s.id, openSession: st.openSession })) : null].filter(Boolean) }); })) : none('None.'))
     : el('div', { class: 'dim', style: 'font-size:var(--fs-2)' }, 'Hidden. They run, write their result onto a card and clean up. Switch on to see them.')));
   host.append(root);
 }

package/workspace/server.js

@@ -4135,10 +4135,27 @@ function stallQuietTasks(run, now) {
     if ((t.status !== 'working' && t.status !== 'sending') || !t.session_id) continue;
     const s = sessions.get(t.session_id);
     if (!s || s.state === 'exited') continue;
-    if (now - Math.max(s.lastOutputAt || 0, Date.parse(t.started_at || 0) || 0) >= TASK_IDLE_MS) run = dayRunLib.sessionStalled(run, t.session_id, TASK_STALLED_WHY, now).run;
+    if (now - Math.max(s.lastOutputAt || 0, Date.parse(t.started_at || 0) || 0) < TASK_IDLE_MS) continue;
+    const q = taskStallReason(s);
+    run = dayRunLib.sessionStalled(run, t.session_id, q.why, now, { asks: q.asks }).run;
   }
   return run;
 }
+// Why a quiet task session is quiet, from its transcript: a tool call that waits on the PM's OK, a turn that ended with
+// a question for the PM, or (no transcript answer) only that it printed nothing. The session stays open in every case.
+function taskStallReason(s) {
+  let hx = null; try { hx = transcriptHarness(s); } catch { hx = null; }
+  const shown = sessionState.presented('quiet', hx && hx.turn);
+  const said = String(((harnessOf(s) || {}).lastWords) || '').replace(/\s+/g, ' ').trim().slice(0, 140);
+  if (shown === 'blocked') {
+    const verb = hx && hx.openCall && hx.openCall.verb ? String(hx.openCall.verb).slice(0, 60) : '';
+    return { asks: 'ok', why: `the agent waits for your OK${verb ? ' to ' + verb : ''} in its session. Open the session and answer it: the job carries on from there.` };
+  }
+  if (shown === 'needs') return { asks: 'answer', why: `the agent stopped to ask you something in its session${said ? ': "' + said + '"' : ''}. Open the session and answer it: the job carries on from there.` };
+  // no transcript at all: the agent never began its turn, which is what a CLI held at its trust-the-folder or sign-in screen looks like
+  if (hx && hx.missing && hx.missing.all && s.agent === 'claude') return { asks: 'start', why: 'the session has printed nothing for five minutes and shows no sign that it began the job: Claude Code may be waiting for you to trust the folder or to sign in. Open the session to see it.' };
+  return { asks: null, why: TASK_STALLED_WHY };
+}
 // The skill's own body is the prompt, as fireSchedule hands it over; the line after it names this run's task and mode.
 function daySkillPrompt(run, skillId, wsId) {
   const w = getWs(wsId || run.ws);