create-pmos 0.186.0 → 0.188.0

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

@@ -1969,7 +1969,8 @@ function readLifecycle(w) {
   for (const r of readLedger(w, 'lifecycle.jsonl')) {
     if (!r || typeof r.initiative_id !== 'string') continue;
     if (r.state !== 'active' && !STOPPED_STATES.includes(r.state)) continue;
-    latest.set(r.initiative_id, { state: r.state, reason: r.reason || '', pm: r.pm || '', at: r.at || '' });
+    // `back` (c3-initiative-lifecycle): the day an on-hold initiative comes back to the PM, when the hold named one.
+    latest.set(r.initiative_id, { state: r.state, reason: r.reason || '', pm: r.pm || '', at: r.at || '', ...(r.state === 'on-hold' && /^\d{4}-\d{2}-\d{2}$/.test(r.back || '') ? { back: r.back } : {}) });
   }
   return latest;
 }
@@ -4134,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);
@@ -8648,6 +8666,10 @@ async function handleRequest(req, res) {
     if (body.state !== 'active' && !STOPPED_STATES.includes(body.state)) {
       return json(res, { ok: false, error: `state must be one of ${STOPPED_STATES.concat('active').join(', ')}` }, 400);
     }
+    // A hold may name the day it comes back to the PM (c3-initiative-lifecycle). Only on-hold carries it.
+    if (body.back != null && (body.state !== 'on-hold' || !/^\d{4}-\d{2}-\d{2}$/.test(String(body.back)))) {
+      return json(res, { ok: false, error: 'back is a day (YYYY-MM-DD) and only goes with on-hold' }, 400);
+    }
     const w = getWs(body.ws);
     if (!w) return json(res, { ok: false, error: 'no workspace' }, 400);
     const known = new Set(initiativeIndex(w.root).initiatives.map((x) => x.id));
@@ -8662,7 +8684,7 @@ async function handleRequest(req, res) {
       grant = m.grant_id;
     }
     const at = nowISO();
-    const recs = ids.map((x) => ({ initiative_id: x, state: body.state, reason, pm: 'wawan', by: g.actor.by, via: g.actor.via, at, ...(grant ? { grant } : {}) }));
+    const recs = ids.map((x) => ({ initiative_id: x, state: body.state, reason, ...(body.back ? { back: String(body.back) } : {}), pm: 'wawan', by: g.actor.by, via: g.actor.via, at, ...(grant ? { grant } : {}) }));
     const rec = recs[0];
     // The ledger the ENGINE reads for this repository's layout (scripts/workflow-state.js#layout): a repository
     // with planning/initiatives/ keeps its ledgers in planning/runs/, a kit in pmos/state/. Writing anywhere else

package/workspace/test-lists/c3-ini-life.json

@@ -0,0 +1,9 @@
+{
+  "_comment": "c3-initiative-lifecycle: On hold, Cancelled, merge and archive on the console3 Initiatives page, and the two-row board header, in demo mode (browser).",
+  "panels": [
+    "c3-ini-life-test.js"
+  ],
+  "seconds": {
+    "c3-ini-life-test.js": 30
+  }
+}