create-pmos 0.207.0 → 0.208.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.207.0",
+  "version": "0.208.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@b515557
+kernel-source: pmos@709d321
 assembled: 2026-10-14
 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-14T01:10:19Z"}
+generated: {by: process:create-pmos, at: "2026-10-14T01:38:03Z"}
 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-14T01:10:19Z"}
+generated: {by: process:create-pmos, at: "2026-10-14T01:38:03Z"}
 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-14T01:10:19Z"}
+generated: {by: process:create-pmos, at: "2026-10-14T01:38:03Z"}
 status: stable
 ---
 

package/workspace/guide/my-work.md

@@ -98,7 +98,9 @@ An item goes to the first view that fits these rules, in this order. Parked is S
 
 ### Let the agent draft an item
 
-Open an assigned item that shows **Agent can:**. The case file shows **What the agent will do**.
+Open an item that shows **Agent can:**. The case file shows **What the agent will do**.
+
+The offer is on Jira and WBS items with a suggestion, and on each item the morning brief suggests for you (for example a Slack reply or an email). On a brief item the offer is the reply or the note that the item asks for, and the draft goes back to the place the item came from, only when you post it.
 
 1. To change the instruction, select **Change what the agent does** and type a new one.
 2. Select **Let the agent draft this** and hold to confirm. This adds one job to today's day run, with the instruction.

package/workspace/lib/day-run.js

@@ -15,6 +15,7 @@
  *   newRun(date, now) · readRun(raw, date)
  *   addTasks(run, brief)                       agent priorities (kind approve|auto) → waiting tasks
  *   addBriefed(run, spec)                      one task the PM briefed in My work (initiative my-work, PRD R5)
+ *   withdraw(run, taskId)                      a failed task taken out, so its item can be briefed again
  *   addSend(run, spec, now)                    the PM's own text, written in the card, to post as written (today-act-prepare)
  *   toStart(run, limit)                        the tasks to start now, each with its mode (do | revise | send)
  *   started · deliver · decide · sent · fail · stop · sessionEnded · sessionStalled
@@ -283,6 +284,18 @@ function stop(run, taskId, reason, now) {
   });
 }
 
+/** Take a failed task out of the run (c3-work-agent amendment 10): the PM stopped the agent on a brief item, so the item
+ *  offers the draft again and a new press adds the task anew. */
+function withdraw(run, taskId) {
+  if (!run) return { ok: false, error: 'no day run today' };
+  const t = findTask(run, taskId);
+  if (!t) return { ok: false, error: `no task ${taskId} in today's run` };
+  if (t.status !== 'failed') return { ok: false, error: `task ${taskId} is ${t.status} — only a stopped or failed task can be taken out` };
+  const next = clone(run);
+  next.tasks = next.tasks.filter((x) => x.id !== taskId);
+  return { ok: true, run: next };
+}
+
 /** A session ended. A task it was working on without delivering, or sending without reporting, has failed. */
 function sessionEnded(run, sessionId, now) {
   if (!run) return { ok: false, error: 'no day run today' };
@@ -400,5 +413,5 @@ function checkDone(run, { found = 0, resolved = 0 } = {}, now) {
 }
 
 module.exports = { MAX_PARALLEL, MAX_REVISIONS, MAX_CHECK_LOG, MAX_INTERVAL_MIN, STATUSES, KINDS, ACTIONS, TASK_RE,
-  newRun, readRun, findTask, modeOf, addTasks, addBriefed, addSend, toStart, started, deliver, decide, sent, fail, stop, sessionEnded, sessionStalled, stage, intervalMin,
+  newRun, readRun, findTask, modeOf, addTasks, addBriefed, addSend, toStart, started, deliver, decide, sent, fail, stop, withdraw, sessionEnded, sessionStalled, stage, intervalMin,
   checkDue, checkStarted, checkDone };

package/workspace/lib/routes-my-work.js

@@ -28,6 +28,7 @@ const myWork = require('./my-work.js');
 const boardFold = require('./board-fold.js');
 const offloop = require('./offloop.js');
 const dayRun = require('./day-run.js');
+const assigned = require('./work-assigned.js');
 const { localDate } = require('./brief.js');
 
 const dirOf = (ctx) => path.join(ctx.runtimeDir, 'my-work');
@@ -121,6 +122,9 @@ async function handle(req, res, url, ctx) {
     return true;
   }
 
+  const bm = BRIEF_ITEM.exec(String((body && body.item) || ''));
+  if (bm && p !== '/api/my-work/refresh') { briefPress(ctx, res, p.slice('/api/my-work/'.length), body, bm[1], now); return true; }
+
   if (p === '/api/my-work/decide' || p === '/api/my-work/stop') { taskPress(ctx, res, p.slice('/api/my-work/'.length), body, now); return true; }
 
   // act
@@ -196,4 +200,44 @@ function taskPress(ctx, res, verb, body, now) {
   ctx.json(res, { ok: true, item: after });
 }
 
+/* ── the agent on an item the morning brief suggests for the PM (c3-work-agent amendment 10) ──────────────────────
+ * Item `brief:<id>`; its task is `t-<id>` in today's day run, added as Your day's "Have the agent draft it" adds it. */
+const BRIEF_ITEM = /^brief:([0-9a-f]{12})$/;
+
+function briefPress(ctx, res, verb, body, id, now) {
+  const today = localDate(now);
+  let brief = null; try { brief = JSON.parse(fs.readFileSync(path.join(ctx.runtimeDir, 'briefs', today + '.json'), 'utf8')); } catch { brief = null; }
+  const x = brief && brief.date === today ? [...(brief.priorities || []), ...(brief.items || [])].find((y) => y && y.id === id) : null;
+  if (!x || x.owner !== 'pm') { ctx.json(res, { ok: false, error: 'no item of yours with that id in today\'s brief' }, 404); return; }
+  const taskId = 't-' + id;
+  const after = (task) => ctx.json(res, { ok: true, item: { id: 'brief:' + id, agent: assigned.briefAgent(x, ctx.readDayRun ? ctx.readDayRun(today) : null) }, task: task || null });
+  if (verb === 'act') {
+    if (body.action !== 'brief') { ctx.json(res, { ok: false, error: 'a brief item takes only action brief here — mark it done or set it aside from Work' }, 400); return; }
+    // the offer as shown ("Draft your reply: …") is not a change: the task then gets the full ask, written for the agent
+    const own = typeof body.instruction === 'string' && body.instruction.trim() !== assigned.briefSuggest(x) ? body.instruction.trim().slice(0, 500) : '';
+    const b = ctx.myWorkBrief(assigned.briefDraftSpec(x, own), String(body.ws || ''));
+    if (!b.ok) { ctx.json(res, { ok: false, error: b.error }, b.status || 500); return; }
+    after(b.task); return;
+  }
+  const run = ctx.readDayRun ? ctx.readDayRun(today) : null;
+  const t = run ? dayRun.findTask(run, taskId) : null;
+  if (!t) { ctx.json(res, { ok: false, error: 'no agent works on this item — let the agent draft it first' }, 409); return; }
+  let next = null;
+  if (verb === 'decide') {
+    const r = dayRun.decide(run, taskId, { action: body.action, note: body.note }, now);
+    if (!r.ok) { ctx.json(res, { ok: false, error: r.error }, 400); return; }
+    next = ctx.startDayTasks ? ctx.startDayTasks(r.run, now) : r.run;
+  } else {
+    // stop: only a task that has not delivered; its session ends and the task leaves the run, so the item offers the draft again
+    if (t.status !== 'waiting' && t.status !== 'working' && t.status !== 'failed') { ctx.json(res, { ok: false, error: `the agent's task is ${t.status} — there is nothing to stop` }, 409); return; }
+    if (t.session_id && t.status === 'working' && ctx.endSession) { try { ctx.endSession(t.session_id); } catch { /* the session already ended */ } }
+    const f = t.status === 'failed' ? { ok: true, run } : dayRun.stop(run, taskId, 'You stopped it.', now);
+    const w = f.ok ? dayRun.withdraw(f.run, taskId) : f;
+    if (!w.ok) { ctx.json(res, { ok: false, error: w.error }, 409); return; }
+    next = w.run;
+  }
+  if (!ctx.writeDayRun || !ctx.writeDayRun(next)) { ctx.json(res, { ok: false, error: 'could not save — nothing changed' }, 500); return; }
+  after(dayRun.findTask(next, taskId));
+}
+
 module.exports = { prefixes: ['/api/my-work'], handle, listFor, listForAsync };

package/workspace/lib/routes-pm-items.js

@@ -116,19 +116,23 @@ function readBrief(ctx, now) {
   if (!ctx.runtimeDir) return null;
   try { return JSON.parse(fs.readFileSync(path.join(ctx.runtimeDir, 'briefs', require('./brief.js').localDate(now.getTime()) + '.json'), 'utf8')); } catch { return null; }
 }
-function assignedFrom(myWork, brief, now) {
+// today's day run, for the agent state of a brief item (c3-work-agent amendment 10). Best effort: no run, no task.
+function readRun(ctx, now) {
+  try { return typeof ctx.readDayRun === 'function' ? ctx.readDayRun(require('./brief.js').localDate(now.getTime())) : null; } catch { return null; }
+}
+function assignedFrom(myWork, brief, now, run) {
   const todayIso = require('./brief.js').localDate(now.getTime());
-  return [...assigned.fromMyWork(myWork && myWork.ok ? myWork.items : []), ...assigned.fromBrief(brief, todayIso)];
+  return [...assigned.fromMyWork(myWork && myWork.ok ? myWork.items : []), ...assigned.fromBrief(brief, todayIso, run)];
 }
 async function assignedAsync(ctx, now) {
   let mw = null;
   try { mw = await require('./routes-my-work.js').listForAsync(ctx, now.getTime()); } catch { mw = null; }
-  return assignedFrom(mw, readBrief(ctx, now), now);
+  return assignedFrom(mw, readBrief(ctx, now), now, readRun(ctx, now));
 }
 function assignedSync(ctx, now) {
   let mw = null;
   try { mw = require('./routes-my-work.js').listFor(ctx, now.getTime()); } catch { mw = null; }
-  return assignedFrom(mw, readBrief(ctx, now), now);
+  return assignedFrom(mw, readBrief(ctx, now), now, readRun(ctx, now));
 }
 const VIRTUAL_ID = /^(jira:|wbs:|brief:)/;
 

package/workspace/lib/work-assigned.js

@@ -14,7 +14,7 @@
 
 const TIER_PRIORITY = { P1: 'P1', P2: 'P2', P3: 'P3' };
 const AGENT = 'an agent';
-const SHOWN = ['origin', 'key', 'url', 'status', 'suggest', 'why', 'my_work_state', 'repo', 'initiative', 'agent'];
+const SHOWN = ['origin', 'key', 'url', 'status', 'suggest', 'why', 'my_work_state', 'repo', 'initiative', 'agent', 'place'];
 
 /* The agent on a my-work item (initiative c3-work-agent): its state, read from lib/my-work.js stateOf.
  *   suggest  nothing started (the suggestion, when there is one, is the offer)   queued · working · sending · failed  the day task
@@ -56,7 +56,33 @@ function fromMyWork(items) {
   return out;
 }
 
-function fromBrief(brief, todayIso) {
+/* An item the morning brief suggests for the PM (amendment 10): the agent drafts it on the PM's press, as Your day's "Have the
+ * agent draft it" does. Its task in today's day run is `t-<brief item id>`; the state is read from that task. */
+const BRIEF_VERB = { reply: 'reply', review: 'review notes', decide: 'answer', 'sign-off': 'sign-off comment', read: 'summary', do: 'draft' };
+const briefVerb = (x) => BRIEF_VERB[x.verb] || (x.reply_needed ? 'reply' : 'draft');
+const briefWhat = (x) => String(x.todo || x.how || x.ask || x.title || '').trim();
+/** The offer shown on the item: "Draft your reply: …". */
+function briefSuggest(x) { return `Draft your ${briefVerb(x)}: ${briefWhat(x)}`.slice(0, 300); }
+/** What lib/day-run.js addBriefed takes for brief item `x`; `instruction` is the PM's changed ask, or empty for the offer. */
+function briefDraftSpec(x, instruction) {
+  const ask = String(instruction || '').trim() || `Draft the PM's ${briefVerb(x)} for this item: ${briefWhat(x)}`;
+  return { id: 't-' + x.id, item_id: x.id, title: x.title, source: x.source, link: x.link || null,
+    instruction: `${ask}${/[.!?]$/.test(ask) ? '' : '.'} Draft only. Send nothing: the PM approves it first.`,
+    context: { from: x.who || null, where: x.where || null, about: x.about || null, ask: x.ask || null, how: x.how || null, why_now: x.why_now || null } };
+}
+const BRIEF_STATE = { waiting: 'queued', working: 'working', sending: 'sending', failed: 'failed', review: 'ready', done: 'ready', sent: 'sent' };
+function briefAgent(x, run) {
+  const t = run && Array.isArray(run.tasks) ? run.tasks.find((y) => y && y.id === 't-' + x.id) || null : null;
+  const base = { suggest: briefSuggest(x), instruction: null, draft: null, sent: null, error: null, session: null, asks: null, revisions: 0, started_at: null, decided_at: null };
+  if (!t) return { state: 'suggest', ...base };
+  return { ...base, state: BRIEF_STATE[t.status] || 'queued', instruction: t.instruction || null,
+    draft: t.draft ? { summary: t.draft.summary || null, body: t.draft.body || null } : null,
+    sent: t.sent ? { link: t.sent.link || null, at: t.sent.at || null } : null, error: t.error || null,
+    session: t.stalled_session ? String(t.stalled_session) : null, asks: t.asks || null, revisions: Array.isArray(t.revisions) ? t.revisions.length : 0,
+    started_at: t.started_at || null, decided_at: (t.decided && t.decided.at) || null };
+}
+
+function fromBrief(brief, todayIso, run = null) {
   if (!brief || brief.date !== todayIso) return [];
   const list = [...(Array.isArray(brief.priorities) ? brief.priorities : []), ...(Array.isArray(brief.items) ? brief.items : [])];
   const seen = new Set();
@@ -65,7 +91,8 @@ function fromBrief(brief, todayIso) {
     if (!x || !x.id || !x.title || x.owner !== 'pm' || x.worth_asking || seen.has(x.id)) continue;
     seen.add(x.id);
     out.push({ id: 'brief:' + x.id, title: String(x.title), source: 'brief', origin: 'brief', suggested: true, flagged: true,
-      due: null, priority: null, waiting_on: null, job: null, why: x.why_now || null, initiative: x.initiative_id || null });
+      due: null, priority: null, waiting_on: null, job: null, why: x.why_now || null, initiative: x.initiative_id || null,
+      place: x.source || null, agent: briefAgent(x, run && run.date === todayIso ? run : null) });
   }
   return out;
 }
@@ -77,7 +104,7 @@ function addable(virtuals, itemLines) {
 }
 
 function createdEvent(v) {
-  const { id, source, agent, ...fields } = v;   // the agent state is read on every list, never stored
+  const { id, source, agent, place, ...fields } = v;   // the agent state (and a brief item's place) is read on every list, never stored
   return { event: 'created', id, fields, source };
 }
 
@@ -90,4 +117,4 @@ function overlay(item, byId) {
   return out;
 }
 
-module.exports = { fromMyWork, fromBrief, addable, createdEvent, overlay, agentOf, AGENT };
+module.exports = { fromMyWork, fromBrief, addable, createdEvent, overlay, agentOf, briefAgent, briefSuggest, briefDraftSpec, AGENT };

package/workspace/package-lock.json

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

package/workspace/package.json

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

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

@@ -696,7 +696,7 @@ function startRun(inst, item, intent) {
 }
 
 
-/* ── the agent on a Jira or WBS item (initiative c3-work-agent, planning/prd/c3-work-agent-prd.md) ───────────────────
+/* ── the agent on a Jira, WBS or morning-brief item (initiative c3-work-agent, planning/prd/c3-work-agent-prd.md) ────────
  * item.agent = { state: suggest|queued|working|ready|sending|sent|failed, suggest, instruction, draft: { summary, body }, sent, error, … }
  * from lib/work-assigned.js. The suggestion is an option the PM picks; the day task does the work; nothing goes outward
  * until the PM holds Post (POST /api/my-work/decide approve). Stop ends a task that has not delivered (POST /api/my-work/stop). */
@@ -704,7 +704,9 @@ const AGENT_BUSY = ['queued', 'working', 'sending'];
 const AGENT_POLL_MS = 15000;
 const hhmm = (iso) => { const d = new Date(iso); return Number.isNaN(d.getTime()) ? '' : String(d.getHours()).padStart(2, '0') + ':' + String(d.getMinutes()).padStart(2, '0'); };
 const minsAgo = (iso) => { const t = Date.parse(iso); if (!Number.isFinite(t)) return ''; const m = Math.max(0, Math.round((Date.now() - t) / 60000)); return m < 1 ? 'just now' : m < 60 ? m + ' min ago' : Math.floor(m / 60) + ' h ago'; };
-const whereOf = (item) => (item.origin === 'jira' ? 'Jira' : 'its source');
+// where a post goes: Jira for a ticket; for an item the morning brief suggests, the place it came from (amendment 10)
+const PLACE = { mail: 'email', slack: 'Slack', jira: 'Jira', confluence: 'Confluence', github: 'GitHub', drive: 'Drive', figma: 'Figma', calendar: 'the calendar', wispr: 'Wispr' };
+const whereOf = (item) => (item.origin === 'jira' ? 'Jira' : PLACE[item.place] || '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: (asks) => (asks ? 'Agent: needs you' : 'Agent stopped'),
@@ -747,7 +749,7 @@ async function agentPress(inst, path, body, text) {
 }
 
 function agentCase(inst, item, L) {
-  const a = item.agent; const w = whereOf(item); const k = item.key || item.title;
+  const a = item.agent; const w = whereOf(item); const k = item.key || (item.origin === 'brief' ? w : item.title);
   const o = (id, l, f, run, extra) => ({ id, l, rec: 0, fx: f, run, ...(extra || {}) });
   const own = L.opts.slice(0, 2).map((x) => ({ ...x, rec: 0 }));
   const ask = () => inst.asks.get(item.id) || a.instruction || a.suggest || '';

package/workspace/server.js

@@ -8474,11 +8474,8 @@ async function handleRequest(req, res) {
     const x = brief ? [...(brief.priorities || []), ...(brief.worth_asking || [])].find((y) => y.id === String(body.item || '')) : null;
     if (!x) return json(res, { ok: false, error: 'no item with that id in today\'s brief' }, 404);
     if (x.owner !== 'pm') return json(res, { ok: false, error: 'the agent already does this job: approve or revise its draft' }, 409);
-    const verb = { reply: 'reply', review: 'review notes', decide: 'answer', 'sign-off': 'sign-off comment', read: 'summary', do: 'draft' }[x.verb] || (x.reply_needed ? 'reply' : 'draft');
-    const spec = { id: 't-' + x.id, item_id: x.id, title: x.title, source: x.source, link: x.link || null,
-      instruction: `Draft the PM's ${verb} for this item: ${x.todo || x.how || x.ask || x.title}. Draft only. Send nothing: the PM approves it first.`,
-      context: { from: x.who || null, where: x.where || null, about: x.about || null, ask: x.ask || null, how: x.how || null, why_now: x.why_now || null } };
-    const r = myWorkBrief(spec, body.ws);
+    // the same ask as Work's "Let the agent draft this" on this item (lib/work-assigned.js, c3-work-agent amendment 10)
+    const r = myWorkBrief(require('./lib/work-assigned.js').briefDraftSpec(x, ''), body.ws);
     if (!r.ok) return json(res, { ok: false, error: r.error }, r.status || 400);
     return json(res, { ok: true, task: r.task });
   }