create-pmos 0.150.0 → 0.152.0

package/workspace/lib/routes-notes.js

@@ -7,7 +7,7 @@
  *                                                   [{ id, t, minute, text, owner, cat, cat_by, by: 'agent', open?, check?, dropped? }];
  *                                                   an open bullet has cat null. bullets_state: { agent: 'on'|'off'|'failed',
  *                                                   reason, session, next_at_ms, minute_ms, minutes }
- *   POST /api/notes/bullet     { id, bullet, cat?, drop?, text? } → { ok, bullet, summary }   the PM's correction to one bullet (Run 8)
+ *   POST /api/notes/bullet     { id, bullet, cat?, drop?, text?, owner?, due? } → { ok, bullet, summary }   the PM's correction to one bullet (Run 8)
  *   POST /api/notes/new        { title?, meeting?, initiative? } → { ok, note, reused }   a calendar event that already has a note
  *                                                   gets that note back (reused: true), so one meeting keeps one note (Run 4)
  *   POST /api/notes/link       { id, meeting?, initiative?, from_event? } → { ok, note, kept? }   the PM's link; null unlinks (Run 4)
@@ -62,7 +62,7 @@
  *   POST /api/notes/highlight-remove { id, hid } → { ok }
  *   POST /api/notes/wispr-fetch { id }    → { ok, wispr }   the PM asks for Wispr Flow's notes now, after the automatic fetch failed or
  *                                                   found nothing; the agent session is asked at once and again every two minutes for up to 20 minutes
- *   POST /api/notes/final-edit { id, sec: 'overview'|'decision'|'action'|'question', i?, text } → { ok, final_notes }   the PM's correction
+ *   POST /api/notes/final-edit { id, sec: 'overview'|'decision'|'action'|'question', i?, text, field?: 'owner'|'due'|'why' } → { ok, final_notes }   the PM's correction
  *
  * Notes are the PM's own and live in the per-user runtime directory (ctx.runtimeDir), never in a repository, so no route here
  * writes into a registered workspace. Every POST goes through pm-guard `requirePagePress` (a body that is not an object or carries
@@ -812,7 +812,7 @@ async function handle(req, res, url, ctx) {
     const q = queueFinal(ctx, id);
     return done(q.queued ? { ok: true, queued: true } : { ok: false, status: 409, error: q.reason });
   }
-  if (p === '/api/notes/bullet') return done(notes.editBullet(dir, { id, bid: body.bullet, cat: body.cat, drop: body.drop, text: body.text }));
+  if (p === '/api/notes/bullet') return done(notes.editBullet(dir, { id, bid: body.bullet, cat: body.cat, drop: body.drop, text: body.text, owner: body.owner, due: body.due }));
   if (p === '/api/notes/line') {
     const pick = (k) => (body[k] === undefined ? undefined : body[k]);
     return done(notes.editLine(dir, { id, index: Number(body.index), cat: pick('cat'), summary: pick('summary'), tags: pick('tags'), people: pick('people'), text: pick('text') }));
@@ -963,7 +963,7 @@ async function handle(req, res, url, ctx) {
   }
   if (p === '/api/notes/highlight-remove') return done(notes.removeHighlight(dir, { id, hid: body.hid }));
   if (p === '/api/notes/wispr-fetch') return done(fetchWisprNow(ctx, id));
-  if (p === '/api/notes/final-edit') return done(notes.editFinal(dir, { id, sec: body.sec, i: body.i, text: body.text }));
+  if (p === '/api/notes/final-edit') return done(notes.editFinal(dir, { id, sec: body.sec, i: body.i, text: body.text, field: body.field }));
   // summarize-agent: the handoff file first (refused for a private note), then the PM's own agent session
   let w = null;
   if (body.ws != null) {

package/workspace/package-lock.json

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

package/workspace/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmos-workspace",
-  "version": "0.150.0",
+  "version": "0.152.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-demo-boards.js

@@ -562,7 +562,7 @@ export function handle(S, method, path, p, body) {
 
 /* ── views of other routes, for the Releases, Docs and initiative tabs (c3-ib-releases.js, c3-ib-docs.js, c3-ii-tabs.js) ──
  * These answer only a request that carries `board=` (the tabs add it; the old page never does), so the old demo fixtures keep answering
- * everything else: GET /api/releases, /api/docs/library, /api/my-work, /api/c3-init/breakdown, /api/doc and /api/doc-sheet/revisions.
+ * everything else: GET /api/releases, /api/docs/library, /api/my-work, /api/c3-init/breakdown, /api/doc and /api/doc-sheet/revisions, /proposals and /log.
  * The rows are made from the boards' featured initiatives. IDPF-07 gets no documents on purpose, so the empty state can be seen. */
 function handleMore(S, method, path, p) {
   if (method !== 'GET') return undefined;
@@ -574,6 +574,11 @@ function handleMore(S, method, path, p) {
     if (path === '/api/doc') return { status: 200, text };
     return okb({ path: p.path, revisions: [{ rev: 1, by: 'human:wawan', at: at(-3, 9) + '.000Z', why: 'First version', before_hash: '', after_hash: '' }] });
   }
+  /* the document sheet's Proposals and Edit log tabs: none yet, one first version */
+  if ((path === '/api/doc-sheet/proposals' || path === '/api/doc-sheet/log') && /^planning\/ib\//.test(p.path || '')) {
+    if (path === '/api/doc-sheet/proposals') return okb({ path: p.path, proposals: [] });
+    return okb({ path: p.path, revisions: [{ rev: 1, by: 'human:wawan', at: at(-3, 9) + '.000Z', why: 'First version', via: 'sheet', text_by: 'person', before_hash: '', after_hash: '' }], events: [] });
+  }
   if (!p.board) return undefined;
   if (path === '/api/releases') {
     return okb({ board: { name: 'Demo board' }, releases: S.releases.filter((x) => x.board === p.board).map((x) => ({ id: x.id, name: x.name, type: 'both', initiative_ids: x.scope.slice(), deploy_at: x.date + 'T11:00:00', release_at: x.date + 'T12:00:00', accepted_at: x.status === 'Released' ? x.date + 'T12:30:00' : null, gapFlags: [], tags: { detected: [], reason: null }, summary: [], status: x.status, board: x.board })) });

package/workspace/public/pm/c3-demo-init.js

@@ -266,15 +266,56 @@ POST['/api/doc-sheet/edit'] = (b) => {
 const PROPS = {};
 POST['/api/doc-sheet/propose'] = (b) => {
   const R = revsOf(b.path); if (!R) return { ok: false, error: 'could not read the document' };
-  const id = nextId('prop'); PROPS[id] = { path: b.path, prompt: b.prompt, after: b.after, hash: hashOf(b.after), before: R[R.length - 1].text };
+  const id = nextId('prop'); PROPS[id] = { path: b.path, prompt: b.prompt, after: b.after, hash: hashOf(b.after), before: R[R.length - 1].text, state: 'proposed', at: '2026-10-08T08:10:00.000Z' };
   return { ok: true, id, state: 'proposed', hash: PROPS[id].hash, diff: [], voided_hash: null };
 };
 POST['/api/doc-sheet/accept'] = (b) => {
   const p = PROPS[b.id]; if (!p || p.path !== b.path) return { ok: false, error: 'no such proposal' };
   if (b.hash !== p.hash) return { ok: false, error: 'the hash does not match the proposal the PM saw', reason: 'hash mismatch' };
-  const R = revsOf(b.path); if (R[R.length - 1].text !== p.before) return { ok: false, error: 'stale: the document changed since this proposal was made', reason: 'stale' };
-  return { ok: true, path: b.path, rev: withRev(b.path, 'claude-code/session', p.prompt, p.after) };
+  const R = revsOf(b.path); const cur = R[R.length - 1].text;
+  const names = Array.isArray(b.sections) ? b.sections : null;
+  const m = names ? demoMerge(cur, p.before, p.after, names) : cur === p.before ? { ok: true, text: p.after } : { ok: false, stale: ['the document'] };
+  if (!m.ok) return { ok: false, error: 'stale: ' + m.stale.join(', ') + ' changed since this proposal was made', reason: 'stale' };
+  p.state = 'accepted'; p.taken = names || demoChanged(p.before, p.after); p.closed_at = '2026-10-08T08:12:00.000Z';
+  const rev = withRev(b.path, 'claude-code/session', p.prompt, m.text); const r = R[R.length - 1]; r.via = 'proposal'; r.text_by = 'agent'; r.proposal = b.id; r.sections = p.taken; r.of = demoChanged(p.before, p.after).length;
+  return { ok: true, path: b.path, rev };
 };
+/* the rich document sheet (c3-doc-sheet-rich): the proposals, the edit log, reject, a reason, mark current — the routes' shapes, from the fixtures */
+const demoSecs = (t) => { const out = []; let cur = { name: 'Overview', head: '', body: '' }; for (const l of String(t).split('\n')) { const h = /^#{1,6}\s+(.*)$/.exec(l); if (h) { out.push(cur); cur = { name: h[1].trim(), head: l + '\n', body: '' }; } else cur.body += l + '\n'; } out.push(cur); return out.filter((x) => x.head || x.body.trim()); };
+const demoChanged = (a, b) => { const A = demoSecs(a); const B = demoSecs(b); return [...B.filter((x) => { const y = A.find((q) => q.name === x.name); return !y || y.body.trim() !== x.body.trim(); }).map((x) => x.name), ...A.filter((y) => !B.some((x) => x.name === y.name)).map((y) => y.name)]; };
+function demoMerge(cur, before, after, names) {
+  const C = demoSecs(cur); const A = demoSecs(before); const P = demoSecs(after);
+  const stale = names.filter((n) => { const a = A.find((x) => x.name === n); const c = C.find((x) => x.name === n); return a ? !c || c.body.trim() !== a.body.trim() : !!c; });
+  if (stale.length) return { ok: false, stale };
+  for (const n of names) { const p = P.find((x) => x.name === n); const k = C.findIndex((x) => x.name === n); if (!p) { if (k >= 0) C.splice(k, 1); } else if (k >= 0) C[k] = p; else C.push(p); }
+  return { ok: true, text: C.map((x) => x.head + x.body).join('').replace(/\n*$/, '\n') };
+}
+GET['/api/doc-sheet/proposals'] = (q) => {
+  const path = pathOf(q); const R = revsOf(path); if (!R) return { ok: false, error: 'could not read the document' };
+  const cur = demoSecs(R[R.length - 1].text);
+  return { ok: true, path, proposals: Object.entries(PROPS).filter(([, p]) => p.path === path).map(([id, p]) => {
+    const A = demoSecs(p.before); const B = demoSecs(p.after);
+    return { id, state: p.state, prompt: p.prompt, at: p.at, hash: p.hash, by: 'agent', why: p.why || null, taken: p.taken || null, of: null, closed_at: p.closed_at || null,
+      sections: demoChanged(p.before, p.after).map((name) => { const a = A.find((x) => x.name === name); const b = B.find((x) => x.name === name); const c = cur.find((x) => x.name === name);
+        return { name, kind: !a ? 'added' : !b ? 'removed' : 'changed', before: a ? a.body.trim() : '', after: b ? b.body.trim() : '', current: c ? c.body.trim() : null, stale: a ? !c || c.body.trim() !== a.body.trim() : !!c }; }) };
+  }).reverse() };
+};
+const DEMO_EVENTS = [];
+GET['/api/doc-sheet/log'] = (q) => {
+  const path = pathOf(q); const R = revsOf(path); if (!R) return { ok: false, error: 'could not read the document' };
+  const props = Object.entries(PROPS).filter(([, p]) => p.path === path).map(([id, p]) => ({ kind: 'proposed', at: p.at, id, prompt: p.prompt, by: 'agent' }));
+  return { ok: true, path, revisions: R.map(({ text, ...r }) => ({ ...r, via: r.via || 'sheet', text_by: r.text_by || (/^claude/.test(r.by) ? 'agent' : 'person'), before_hash: '', after_hash: hashOf(text) })),
+    events: [...props, ...DEMO_EVENTS.filter((e) => e.path === path)] };
+};
+POST['/api/doc-sheet/reject'] = (b) => {
+  const p = PROPS[b.id]; if (!p || p.path !== b.path) return { ok: false, error: 'no such proposal' };
+  if (typeof b.why !== 'string' || !b.why.trim()) return { ok: false, error: 'a why is required' };
+  p.state = 'rejected'; p.why = b.why.trim(); p.closed_at = '2026-10-08T08:12:00.000Z';
+  DEMO_EVENTS.push({ path: b.path, kind: 'rejected', at: p.closed_at, id: b.id, why: p.why, by: 'pm' });
+  return { ok: true, id: b.id, state: 'rejected' };
+};
+POST['/api/doc-sheet/why'] = (b) => { const R = revsOf(b.path); const r = R && R.find((x) => x.rev === Number(b.rev)); if (!r) return { ok: false, error: 'no such revision' }; if (!String(b.why || '').trim()) return { ok: false, error: 'a why is required' }; r.why_added = b.why.trim(); r.why_added_at = '2026-10-08T08:12:00.000Z'; return { ok: true, rev: r.rev }; };
+POST['/api/doc-sheet/mark-current'] = (b) => { if (!String(b.why || '').trim()) return { ok: false, error: 'a why is required' }; DEMO_EVENTS.push({ path: b.path, kind: 'marked', at: '2026-10-08T08:12:00.000Z', why: b.why.trim(), by: 'pm' }); return { ok: true, at: '2026-10-08T08:12:00.000Z' }; };
 POST['/api/doc-sheet/change-note'] = (b) => ({ ok: true, note: 'A change note for the owners of ' + (b.downstream || []).join(', ') });
 
 /* health: the six checks (the mockup's docHealth, line 4059). Checkout v2 PRD is recomputed from its text; the others answer the fixed N of M. */

package/workspace/public/pm/c3-demo-rep2.js

@@ -4,12 +4,12 @@
  * report section ([heading, text]). Its path here is planning/reports/<family>-<report>-<audience>.md; the text and the revisions are made on first
  * read from window.__c3repix (c3-demo-rep-ix.js) and kept in memory for the page's life. Routes answered, in the REAL response shapes of
  * workspace/lib/routes-doc-sheet.js and routes-doc-health.js:
- *   GET  /api/doc, /api/doc-sheet/revisions, /api/doc-sheet/at
- *   POST /api/doc-sheet/edit, /propose, /accept, /api/doc-health/check
+ *   GET  /api/doc, /api/doc-sheet/revisions, /api/doc-sheet/at, /api/doc-sheet/proposals, /api/doc-sheet/log
+ *   POST /api/doc-sheet/edit, /propose, /accept, /reject, /why, /mark-current, /api/doc-health/check
  * A path outside planning/reports/ goes on to the earlier demo wrappers untouched. Nothing is saved anywhere. */
 
 const PREFIX = 'planning/reports/';
-const DOCS = {};      // path -> { revs: [{ rev, v, by, at, why, text }] }
+const DOCS = {};      // path -> { revs: [{ rev, v, by, at, why, text }], events: [] }
 const PROPS = {};     // id -> { path, hash, before, after, prompt }
 let seq = 0;
 
@@ -29,10 +29,19 @@ function sectionsFor(path) {
 function docOf(path) {
   if (DOCS[path]) return DOCS[path];
   const s = sectionsFor(path); if (!s) return null;
-  DOCS[path] = { revs: [{ rev: 1, v: 'v1', by: 'claude-code/session', at: '2026-10-08T08:12:00.000Z', why: 'Assembled from live data.', text: md(s) }] };
+  DOCS[path] = { revs: [{ rev: 1, v: 'v1', by: 'claude-code/session', at: '2026-10-08T08:12:00.000Z', why: 'Assembled from live data.', text: md(s) }], events: [] };
   return DOCS[path];
 }
-const push = (path, by, why, text) => { const d = DOCS[path]; const rev = d.revs.length + 1; d.revs.push({ rev, v: 'v' + rev, by, at: '2026-10-08T08:12:00.000Z', why, text }); return rev; };
+const push = (path, by, why, text, extra) => { const d = DOCS[path]; const rev = d.revs.length + 1; d.revs.push({ rev, v: 'v' + rev, by, at: '2026-10-08T08:12:00.000Z', why, text, ...extra }); return rev; };
+/* the sections of a report text by heading, for the proposals' per-section view */
+const secsOf = (t) => String(t).split(/^(?=## )/m).map((s) => ({ name: (/^## (.*)/.exec(s) || ['', 'Overview'])[1].trim(), body: s.replace(/^## .*\n?/, '').trim() }));
+function propView(id, p, cur) {
+  const A = secsOf(p.before); const B = secsOf(p.after); const C = secsOf(cur);
+  const names = [...B.filter((x) => { const y = A.find((a) => a.name === x.name); return !y || y.body !== x.body; }).map((x) => x.name), ...A.filter((a) => !B.some((x) => x.name === a.name)).map((a) => a.name)];
+  return { id, state: p.state || 'proposed', prompt: p.prompt, at: '2026-10-08T08:12:00.000Z', hash: p.hash, by: 'agent', why: p.why || null, taken: null, of: null, closed_at: null,
+    sections: names.map((name) => { const a = A.find((x) => x.name === name); const b = B.find((x) => x.name === name); const c = C.find((x) => x.name === name);
+      return { name, kind: !a ? 'added' : !b ? 'removed' : 'changed', before: a ? a.body : '', after: b ? b.body : '', current: c ? c.body : null, stale: a ? !c || c.body !== a.body : !!c }; }) };
+}
 
 /* the mockup's docHealth for a report that is still a draft: Fresh passes, Complete does not (a draft), Traced passes, and the claims check. */
 function health(path) {
@@ -52,6 +61,8 @@ function get(path, q) {
   if (path === '/api/doc') return d ? new Response(d.revs[d.revs.length - 1].text, { status: 200, headers: { 'content-type': 'text/markdown; charset=utf-8' } }) : new Response('could not read the document', { status: 404 });
   if (!d) return json({ ok: false, error: 'could not read the document' });
   if (path === '/api/doc-sheet/revisions') return json({ ok: true, path: p, revisions: d.revs.map(({ text, ...r }) => ({ ...r, before_hash: '', after_hash: hashOf(text) })) });
+  if (path === '/api/doc-sheet/proposals') { const cur = d.revs[d.revs.length - 1].text; return json({ ok: true, path: p, proposals: Object.entries(PROPS).filter(([, x]) => x.path === p).map(([id, x]) => propView(id, x, cur)).reverse() }); }
+  if (path === '/api/doc-sheet/log') return json({ ok: true, path: p, revisions: d.revs.map(({ text, ...r }) => ({ ...r, via: r.via || 'sheet', text_by: r.text_by || (/^claude/.test(r.by) ? 'agent' : 'person'), before_hash: '', after_hash: hashOf(text) })), events: d.events });
   if (path === '/api/doc-sheet/at') { const r = d.revs.find((x) => x.rev === Number(q.get('rev'))); return json(r ? { ok: true, path: p, rev: r.rev, text: r.text } : { ok: false, error: 'no such revision' }); }
   return undefined;
 }
@@ -68,8 +79,18 @@ function post(path, b) {
     const p = PROPS[b.id]; if (!p || p.path !== b.path) return json({ ok: false, error: 'no such proposal' });
     if (b.hash !== p.hash) return json({ ok: false, error: 'the hash does not match the proposal the PM saw', reason: 'hash mismatch' });
     if (d.revs[d.revs.length - 1].text !== p.before) return json({ ok: false, error: 'stale: the document changed since this proposal was made', reason: 'stale' });
-    return json({ ok: true, path: b.path, rev: push(b.path, 'claude-code/session', p.prompt, p.after) });
+    let text = p.after;
+    if (Array.isArray(b.sections) && b.sections.length) { /* only the ticked sections: the rest stay as they are */
+      const C = secsOf(p.before); const P = secsOf(p.after);
+      for (const n of b.sections) { const x = P.find((y) => y.name === n); const k = C.findIndex((y) => y.name === n); if (!x) { if (k >= 0) C.splice(k, 1); } else if (k >= 0) C[k] = x; else C.push(x); }
+      text = C.map((x) => '## ' + x.name + '\n' + x.body + '\n').join('\n'); /* a report is all '## ' sections (md above) */
+    }
+    p.state = 'accepted';
+    return json({ ok: true, path: b.path, rev: push(b.path, 'claude-code/session', p.prompt, text, { via: 'proposal', text_by: 'agent', proposal: b.id }) });
   }
+  if (path === '/api/doc-sheet/reject') { const p = PROPS[b.id]; if (!p || p.path !== b.path) return json({ ok: false, error: 'no such proposal' }); p.state = 'rejected'; p.why = String(b.why || '').trim() || null; d.events.push({ kind: 'rejected', at: '2026-10-08T08:12:00.000Z', id: b.id, why: p.why, by: 'pm' }); return json({ ok: true, id: b.id, state: 'rejected' }); }
+  if (path === '/api/doc-sheet/why') { const r = d.revs.find((x) => x.rev === Number(b.rev)); if (!r) return json({ ok: false, error: 'no such revision' }); if (!String(b.why || '').trim()) return json({ ok: false, error: 'a why is required' }); r.why_added = b.why.trim(); return json({ ok: true, rev: r.rev }); }
+  if (path === '/api/doc-sheet/mark-current') { if (!String(b.why || '').trim()) return json({ ok: false, error: 'a why is required' }); d.events.push({ kind: 'marked', at: '2026-10-08T08:12:00.000Z', why: b.why.trim(), by: 'pm' }); return json({ ok: true, at: '2026-10-08T08:12:00.000Z' }); }
   return undefined;
 }