create-pmos 0.219.0 → 0.221.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.219.0",
+  "version": "0.221.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@16fef7c
+kernel-source: pmos@a045502
 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-14T04:55:02Z"}
+generated: {by: process:create-pmos, at: "2026-10-14T05:13:19Z"}
 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-14T04:55:02Z"}
+generated: {by: process:create-pmos, at: "2026-10-14T05:13:19Z"}
 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-14T04:55:02Z"}
+generated: {by: process:create-pmos, at: "2026-10-14T05:13:19Z"}
 status: stable
 ---
 

package/workspace/c3-phone-test.js

@@ -236,6 +236,7 @@ const writes = (p) => (window.__c3demoWrites || []).filter((w) => w.path === p |
   ok('day: working hours show what the agent finished for you', await waitFor(page, () => !!document.querySelector('[data-c3ph-moment] [data-c3ph-fin="t-0000000000a1"]'), null, 8000));
   await page.click('[data-c3ph-fin-open="t-0000000000a1"]');
   ok('day: Read it opens the draft, and approving it waits for the desk', await waitFor(page, () => { const d = document.querySelector('[data-c3ph-draft="t-0000000000a1"]'); return !!d && /31 Oct/.test(d.textContent) && /on your computer/.test(d.textContent); }, null, 5000));
+  ok('day: the draft reads as a document, not raw markdown (headings, bold, a list)', await page.evaluate(() => { const m = document.querySelector('[data-c3ph-draft="t-0000000000a1"] .ds-md'); return !!m && !!m.querySelector('h1') && !!m.querySelector('h2') && !!m.querySelector('strong') && m.querySelectorAll('li').length === 2 && !/(^|\s)(#|\*\*)/.test(m.textContent); }));
   await page.close();
   page = await open(pctx, '/c3.html?demo=1&at=17:40');
   ok('day: 17:40 is the evening recap, with the evening icon', (await moment(page)) === 'recap' && await page.evaluate(() => document.querySelector('[data-c3ph-part]')?.dataset.c3phPart === 'evening'), await moment(page));

package/workspace/guide/my-work.md

@@ -121,7 +121,7 @@ The row chip then shows the agent's state:
 
 The page reads the state again every 15 seconds while an agent is queued, working or posting.
 
-When the draft is ready, the case file shows it as a document card, with its headings, lists and tables. Select **Open** to read all of it, or **Copy** to copy the text.
+When the draft is ready, the case file shows it as a document card, with its headings, lists and tables. Select **Open** to read it in the document sheet, the same sheet as your other documents: **Read**, **Edit**, **Proposals** (send it back with a note) and **Edit log** (the conversation with the agent). Select **Copy** to copy the text.
 
 Under the draft is the conversation with the agent: your ask, each draft, each note you sent back and each edit. Select **View round** on an earlier draft to read that version. The conversation stays on the item on the next days too.
 
@@ -130,7 +130,7 @@ To ask the agent for changes, type in the box under the conversation and press E
 Or choose one option:
 
 - **Post it to** the ticket posts the exact text. Nothing goes out until you hold to confirm.
-- **Edit the draft** opens the text to change. Select **Save the draft**. The card then says **Edited by you**, and **Post it to** the ticket posts exactly your text.
+- **Edit the draft** opens the draft in the document sheet's editor. Select **Save**. The card then says **Edited by you**, and **Post it to** the ticket posts exactly your text.
 - **Keep it as a draft** leaves the draft as it is.
 - **Mark it done** closes the item. Nothing is posted.
 

package/workspace/guide/phone-companion.md

@@ -2,7 +2,7 @@
 type: Guide
 title: "Guide: the phone companion"
 description: "At phone width the console shows a companion: one moment of your day, your items one at a time, Tell PMOS and Record."
-timestamp: 2026-10-13
+timestamp: 2026-10-14
 ---
 
 # Guide: the phone companion
@@ -20,7 +20,7 @@ The top card shows where you are in your day and why it is useful now. PMOS choo
 | In the meeting | A meeting is in progress | **Record this meeting?** with **Record** and **Not this one**. Recording opens focus (see below). |
 | Just ended | A meeting ended less than 20 minutes ago | **What came out of it?** If you recorded the meeting, the card shows the summary, the decisions, the actions and the open questions from its notes, the same notes as on the Notes page. While PMOS writes the notes, the card says so. If you did not record it, **Tell PMOS** puts the meeting name in the bar so you can type the result. |
 | Free time | 15 minutes or more before the next meeting | The items that fit in the time: overdue items first, then items due today, at most two. Each has **Done** and **Later today**. Under them, what the agent finished for you. |
-| Finished for you | After noon, before 17:00, with no meeting near | The drafts that the agent finished today, newest first. **Read it** shows the draft. Approve a draft, or send it back with a note, on your computer: nothing is sent from the phone. Under them, the items that fit. |
+| Finished for you | After noon, before 17:00, with no meeting near | The drafts that the agent finished today, newest first. **Read it** shows the draft as a document, with its headings, lists and tables, the same as on your computer. Approve a draft, or send it back with a note, on your computer: nothing is sent from the phone. Under them, the items that fit. |
 | Evening recap | From 17:00 | How today went: the meetings, the decisions in their notes, the items you marked done and the agent's drafts. Then what moved, what is still open, and one thing for tonight with **Done** and **Tomorrow**. |
 | End of day | From 20:00, and before 05:00 | Today in one line, the meetings of the next working day (tap one to see its brief), and how many items carry over |
 

package/workspace/lib/routes-phone-day.js

@@ -5,7 +5,7 @@
  *
  * READ ONLY, and built only from what PMOS already holds. Nothing is invented. The companion reads it for three moments:
  *   finished  working hours, "Finished for you": the agent's tasks of today's day run (goals/<date>.run.json, lib/day-run.js) that have a
- *             draft. { id, title, summary, body, at, status, link, source }; status 'review' (waits for the PM's approval at the desk),
+ *             draft. { id, title, summary, body, at, status, link, source }; body keeps its lines (markdown, at most 8000 characters); status 'review' (waits for the PM's approval at the desk),
  *             'done' (an auto task) or 'sent'. Newest first, at most 5.
  *   recap     evening: how the day went. meetings = today's meetings that have ended; decided = the decisions in the final notes of today's
  *             meetings; done = the PM's own items marked done today; finished = the agent's drafts of today. moved = at most 5 rows of
@@ -21,6 +21,8 @@ const { todayAgenda, notesAdapter } = require('./routes-brief-page.js');
 const pad = (n) => String(n).padStart(2, '0');
 const localDate = (d) => `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
 const clip = (s, n) => { const t = String(s || '').replace(/\s+/g, ' ').trim(); return t.length > n ? t.slice(0, n - 1) + '…' : t; };
+// the draft's text keeps its lines: the companion draws it as a document (markdown, c3-md.js)
+const clipDoc = (s, n) => { const t = String(s || '').replace(/\r\n?/g, '\n').replace(/\n{3,}/g, '\n\n').trim(); return t.length > n ? t.slice(0, n - 1) + '…' : t; };
 const WD = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
 const MO = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
 const FINISHED = ['review', 'done', 'sent'];
@@ -36,7 +38,7 @@ function nextWorkday(now) {
 function finishedOf(run) {
   const tasks = run && Array.isArray(run.tasks) ? run.tasks : [];
   return tasks.filter((t) => t && FINISHED.includes(t.status) && t.draft && t.draft.summary)
-    .map((t) => ({ id: t.id, title: clip(t.title, 200), summary: clip(t.draft.summary, 300), body: clip(t.draft.body, 1200), at: t.draft.at || null, status: t.status, link: t.draft.link || t.link || null, source: t.source || null }))
+    .map((t) => ({ id: t.id, title: clip(t.title, 200), summary: clip(t.draft.summary, 300), body: clipDoc(t.draft.body, 8000), at: t.draft.at || null, status: t.status, link: t.draft.link || t.link || null, source: t.source || null }))
     .sort((a, b) => String(b.at || '').localeCompare(String(a.at || '')));
 }
 

package/workspace/package-lock.json

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

package/workspace/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmos-workspace",
-  "version": "0.219.0",
+  "version": "0.221.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-phone.js

@@ -35,7 +35,7 @@ const at = (d, hh, mm) => new Date(2026, 9, d, hh, mm).toISOString();
 export const demoDay = () => ({
   ok: true, date: '2026-10-08',
   finished: [
-    { id: 't-0000000000a1', title: 'Reply to Priya on the Checkout v2 date', summary: 'A reply that moves v2 to 31 Oct and keeps beta on 30 Oct, with the reason in one line.', body: 'Hi Priya,\nCheckout v2 moves to 31 Oct: the sandbox keys arrive two days late.\nBeta stays on 30 Oct for the two partners already set up.', at: at(8, 12, 52), status: 'review', link: null, source: 'my-work' },
+    { id: 't-0000000000a1', title: 'Reply to Priya on the Checkout v2 date', summary: 'A reply that moves v2 to 31 Oct and keeps beta on 30 Oct, with the reason in one line.', body: '# Reply to Priya\n\nHi Priya,\n\n**Checkout v2 moves to 31 Oct**: the sandbox keys arrive two days late.\n\n## What stays\n\n- Beta stays on 30 Oct for the two partners already set up.\n- The `checkout_v2` flag stays off until then.', at: at(8, 12, 52), status: 'review', link: null, source: 'my-work' },
     { id: 't-0000000000a2', title: 'Weekly status for leadership', summary: 'Green on Checkout v2 with the new date; amber on Returns, where the interview slipped a week.', body: '', at: at(8, 12, 40), status: 'done', link: null, source: 'brief' },
   ],
   recap: { meetings: 5, decided: 2, done: 1, finished: 2,

package/workspace/public/pm/c3-doc-sheet.js

@@ -31,6 +31,10 @@
  *
  * Two options for a report, which is a document with no stored file yet (report-families-view.js):
  *   generated = { text, why, health }   Read shows the generated text; Edit and Proposals say why they need a stored document; Health shows `health`.
+ * An agent's draft on a Work item (initiative c3-work-agent, amendment 16) is a generated document with three more hooks:
+ *   generated.save(text, why) → { ok, error }   Edit works: Save hands the text to the caller (the reason is optional) instead of the edit route.
+ *   generated.ask(note) → { ok, error }         Proposals is the note that sends the draft back to the agent.
+ *   generated.log = [{ who, what, at, text }]   Edit log lists these turns (the conversation with the agent).
  *   secExtra(name)                      a node under each section in Read: the report's claims and where they come from.
  * Pure parts (Node-testable): splitDoc, joinDoc, changedSections, wordDiffTokens, byName, dayName, parseFront, setFront, composeSections,
  * copyKindOf, citesIn, outlineOf, hoodOf. */
@@ -738,7 +742,7 @@ export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, o
 
   /* ── Edit ── */
   function startEdit() {
-    if (generated || frozen() || S.text == null) { S.ed = null; return; }
+    if ((generated && !generated.save) || frozen() || S.text == null) { S.ed = null; return; }
     S.ed = { text: S.text, base: splitDoc(S.text), front: {}, kind: 'rich', why: '', whyBad: false, node: null, ta: null, range: null, link: false };
   }
   function edNode() {
@@ -785,7 +789,7 @@ export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, o
     const s = ui.body.querySelector('[data-doc-savesum]'); if (s) s.replaceChildren(...saveSum(ch).filter(Boolean));
   }
   function saveSum(ch) {
-    if (!ch.length) return [c3ic('info', 'sm'), 'No changes yet. Health checks the document again after you save.'];
+    if (!ch.length) return [c3ic('info', 'sm'), generated ? 'No changes yet.' : 'No changes yet. Health checks the document again after you save.'];
     const cl = [...new Set(ch.map((c) => clashOf(c.name)).filter(Boolean))];
     return [c3ic('edit', 'sm'), plural(ch.length, 'section') + ' changed: ' + ch.map((c) => c.name).join(', ') + '.',
       cl.length ? el('span', { class: 'ds-warn' }, ' ' + plural(cl.length, 'open proposal') + ' also change' + (cl.length === 1 ? 's' : '') + ' them; accepting it after your save needs a new draft.') : null];
@@ -835,7 +839,7 @@ export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, o
     drawEdit();
   }
   function editBody() {
-    if (generated) return el('div', { class: 'fold w', role: 'note', 'data-doc-nostore': 'edit' }, c3ic('lock', 'sm'), generated.why);
+    if (generated && !generated.save) return el('div', { class: 'fold w', role: 'note', 'data-doc-nostore': 'edit' }, c3ic('lock', 'sm'), generated.why);
     if (frozen()) return el('div', { class: 'ds', 'data-doc-frozen': '' }, el('div', { class: 'fold w', role: 'status' }, c3ic('lock', 'sm'), 'Issued reports are frozen. Start the next cycle to change it.'),
       el('div', { class: 'ds-acts' }, btn('ds-btn pri', { 'data-doc-next': '' }, [c3ic('plus', 'sm'), 'Start the next cycle'], () => nextCycle())));
     if (S.text == null) return readBody();
@@ -845,12 +849,12 @@ export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, o
     let area;
     if (E.kind === 'rich') { if (!E.node) E.node = edNode(); area = E.node; E.ta = null; }
     else { E.ta = E.ta || el('textarea', { class: 'ds-src', id: 'dsrc', 'aria-label': 'Markdown source', spellcheck: 'false', 'data-doc-mdsrc': '', onInput: () => { clearTimeout(E.t); E.t = setTimeout(mark, 250); } }, E.text); area = E.ta; E.node = null; }
-    const why = el('input', { type: 'text', id: 'dwhy', class: E.whyBad ? 'bad' : '', placeholder: 'Why are you changing it? Kept in the edit log.', 'aria-label': 'Why', 'data-doc-why': '', value: E.why,
+    const why = el('input', { type: 'text', id: 'dwhy', class: E.whyBad ? 'bad' : '', placeholder: generated ? 'What did you change? Optional.' : 'Why are you changing it? Kept in the edit log.', 'aria-label': 'Why', 'data-doc-why': '', value: E.why,
       onInput: (e) => { E.why = e.target.value; if (E.whyBad && E.why.trim()) { E.whyBad = false; e.target.classList.remove('bad'); const a = ui.body.querySelector('[data-doc-whybad]'); if (a) a.remove(); } } });
     const save = el('div', { class: 'ds-save' }, el('div', { class: 'sum', 'data-doc-savesum': '' }, saveSum([])), why,
       E.whyBad ? el('div', { class: 'fold w', role: 'alert', 'data-doc-whybad': '' }, c3ic('alert', 'sm'), 'Say why the document changes. The reason is kept in the edit log.') : null,
       S.err ? el('div', { class: 'fold w', role: 'alert' }, c3ic('alert', 'sm'), S.err) : null,
-      el('div', { class: 'row' }, el('span', { class: 'ds-mono' }, c3ic('user', 'sm'), ' Saved by you' + (nextV(doc.v) ? ' as ' + nextV(doc.v) : '')),
+      el('div', { class: 'row' }, el('span', { class: 'ds-mono' }, c3ic('user', 'sm'), generated ? ' Saved by you as the draft' : ' Saved by you' + (nextV(doc.v) ? ' as ' + nextV(doc.v) : '')),
         el('span', { class: 'ds-acts' }, btn('ds-btn', { 'data-doc-cancel': '' }, 'Cancel', () => { S.ed = null; S.err = ''; go('read'); }),
           btn('ds-btn pri', { 'data-doc-save': '' }, [c3ic('check', 'sm'), 'Save' + (nextV(doc.v) ? ' as ' + nextV(doc.v) : '')], () => saveDoc()))));
     return el('div', { class: 'ds', 'data-doc-edit': '' }, staleBanner(), propsBlock(secs, true), area, save);
@@ -860,6 +864,7 @@ export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, o
     const E = S.ed; if (!E || S.busy) return;
     const after = draftText(); const ch = changedSections(S.text, after);
     if (after === S.text || !ch.length) { say('Nothing changed.'); S.ed = null; S.err = ''; go('read'); return; }
+    if (generated) { await saveGenerated(after, E.why.trim()); return; }
     if (!E.why.trim()) { E.whyBad = true; E.text = after; if (E.kind === 'rich') { E.base = splitDoc(after); E.node = null; } else if (E.ta) E.ta.value = after; drawEdit(); const w = ui.body.querySelector('#dwhy'); if (w) w.focus(); return; }
     const before = S.text; S.busy = true;
     const r = await pmPost('/api/doc-sheet/edit', { ...base, text: after, why: E.why.trim() }).catch(() => null);
@@ -874,6 +879,15 @@ export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, o
     });
   }
 
+  async function saveGenerated(after, why) {
+    const E = S.ed; S.busy = true;
+    const r = await Promise.resolve(generated.save(after, why)).catch((e) => ({ ok: false, error: e && e.message }));
+    S.busy = false;
+    if (!r || !r.ok) { S.err = (r && r.error) || 'The draft was not saved.'; E.text = after; if (E.kind === 'rich') { E.base = splitDoc(after); E.node = null; } drawEdit(); return; }
+    S.text = after; generated.text = after; S.err = ''; S.ed = null; S.changed = true; go('read');
+    say(generated.saved || 'Saved as the draft.');
+  }
+
   /* ── Proposals ── */
   function askBox() {
     if (frozen()) return el('div', { class: 'fold w', role: 'status', 'data-doc-frozen': '' }, c3ic('lock', 'sm'), 'Issued reports are frozen. Start the next cycle to ask for a change.');
@@ -966,6 +980,7 @@ export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, o
     S.rejFor = null; S.rejWhy = ''; S.log = null; await loadProps(); draw(); say('Rejected. The reason is in the edit log.');
   }
   function propsBody() {
+    if (generated && generated.ask) return askGenerated();
     if (generated) return el('div', { class: 'fold w', role: 'note', 'data-doc-nostore': 'ask' }, c3ic('lock', 'sm'), generated.why);
     const op = openProps(); const closed = (S.props || []).filter((p) => p.state !== 'proposed');
     const list = S.props === null ? el('div', { class: 'fold', role: 'status' }, c3ic('clock', 'sm'), 'Reading the proposals.')
@@ -1054,7 +1069,30 @@ export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, o
     if (!j || !j.ok) { say((j && j.error) || 'The reason was not added.'); return; }
     S.whyFor = null; await loadLog(); draw(); say('Reason added. The revision itself is unchanged.');
   }
+  /* a draft on a Work item: the note sends it back to the agent, which drafts it again on the item */
+  function askGenerated() {
+    const ta = el('textarea', { id: 'dpr', placeholder: 'Tell the agent what to change', 'aria-label': 'Note to the agent', 'data-doc-prompt': '', onInput: (e) => { S.prompt = e.target.value; } }, S.prompt);
+    const send = async () => {
+      const v = String(S.prompt || '').trim(); if (!v) { say('Tell the agent what to change'); ta.focus(); return; }
+      S.busy = true; draw();
+      const r = await Promise.resolve(generated.ask(v)).catch((e) => ({ ok: false, error: e && e.message }));
+      S.busy = false;
+      if (!r || !r.ok) { S.err = (r && r.error) || 'The draft was not sent back.'; draw(); return; }
+      S.prompt = ''; S.err = ''; ui.close();
+    };
+    return el('div', { class: 'ds', 'data-doc-proposals': '' }, el('div', { class: 'ds-ask' }, el('label', { class: 'ds-h', for: 'dpr' }, c3ic('spark', 'sm'), 'Send it back to the agent'), ta,
+      el('div', { class: 'ds-acts' }, btn('ds-btn ag', { 'data-doc-ask': '', disabled: S.busy, 'aria-disabled': S.busy ? 'true' : null }, [c3ic('reply', 'sm'), 'Send to the agent'], send)),
+      S.err ? el('div', { class: 'fold w', role: 'alert' }, c3ic('alert', 'sm'), S.err) : null,
+      el('p', { class: 'ds-note', 'data-doc-ask-why': '' }, generated.askWhy || 'The agent drafts it again with your note. Nothing is sent anywhere.')));
+  }
   function logBody() {
+    if (generated && Array.isArray(generated.log)) {
+      return el('div', { class: 'ds', 'data-doc-log': '' }, el('h3', { class: 'ds-h' }, 'Conversation with the agent · ' + generated.log.length),
+        el('ul', { class: 'ds-closed hx', 'data-doc-genlog': '' }, generated.log.map((t, i) => el('li', { 'data-doc-genturn': String(i) },
+          el('span', { class: 'chip2' + (t.who === 'agent' ? ' ds-ag' : '') }, c3ic(t.who === 'agent' ? 'spark' : 'user', 'sm'), t.who === 'agent' ? 'Agent' : 'You'),
+          el('span', null, el('b', null, t.what), t.text ? el('small', null, short(t.text)) : null),
+          el('span', { class: 'w' }, t.at ? whenOf(t.at) : '')))));
+    }
     if (generated) return el('div', { class: 'fold', 'data-doc-nostore': 'hist' }, c3ic('info', 'sm'), generated.why);
     if (!S.log) return el('div', { class: 'fold', role: 'status' }, c3ic('clock', 'sm'), 'Reading the edit log.');
     const F = [['all', 'All'], ['people', 'People'], ['agent', 'Agent'], ['outside', 'Outside PMOS']];

package/workspace/public/pm/c3-phone-detail.js

@@ -7,13 +7,15 @@
  *                          Done and Later today when the row is the PM's own Work item. opts: { onDone(r), onLater(r) }
  *   openAll(rows, opts)    every row that waits, as a list; a press opens that row (openNeed). opts as openNeed.
  *   openDraft(t)           a draft the agent finished today (GET /api/phone-day finished): what it is, its summary, its text and its
- *                          link. Approving or revising it waits for the desk, where the whole draft and its sources are.
+ *                          link. The text is drawn as a document (c3-md.js, as the desk's Work sheet and the document sheet draw it):
+ *                          headings, lists, tables, bold. Approving or revising it waits for the desk, where the whole draft and its sources are.
  * Nothing here writes: the buttons call back into c3-phone.js, which owns the writes and their Undo. */
 import { el } from './dom.js';
 import { button, row } from './primitives.js';
 import { pmGet } from './http.js';
 import { c3ic } from './pm-work-view.js';
 import { openSheet, closeSheet } from './c3-sheet.js';
+import { parseMd, toDom } from './c3-md.js';
 
 const p2 = (n) => String(n).padStart(2, '0');
 const hm = (iso) => { const d = new Date(iso); return p2(d.getHours()) + ':' + p2(d.getMinutes()); };
@@ -88,7 +90,7 @@ export function openDraft(t) {
   const body = el('div', { class: 'c3ph-sheetbody', 'data-c3ph-draft': t.id },
     el('span', { class: 'c3ph-step' }, (t.status === 'review' ? 'Waits for you' : t.status === 'sent' ? 'Sent' : 'Finished').toUpperCase() + (t.at ? ' · ' + hm(t.at) : '')),
     line(t.summary),
-    ...String(t.body || '').split(/\n+/).map((x) => x.trim()).filter(Boolean).slice(0, 12).map((x) => el('div', { class: 'c3ph-prep' }, x)),
+    t.body ? el('div', { class: 'ds-md wk-agent-md c3ph-md' }, toDom(parseMd(String(t.body)), document)) : null,
     t.link ? el('div', { class: 'chips2' }, link(t.link, 'Open the source')) : null,
     line(t.status === 'review' ? 'Approve it, or send it back with a note, on your computer. Nothing is sent from the phone.' : 'Nothing more is needed from you.'));
   return openSheet({ title: t.title, icon: 'file-text', body });

package/workspace/public/pm/c3-phone.css

@@ -59,3 +59,8 @@
 .c3 .c3ph-stats b{font-size:20px;font-variant-numeric:tabular-nums}
 .c3 .c3ph-stats span{font-size:11px;color:var(--muted-foreground);line-height:1.25}
 .c3 .c3ph-pts{display:grid;gap:2px}
+/* the agent's draft in its sheet, drawn as a document (c3-md.js): its headings, lists and tables, at the phone's reading size */
+.c3 .c3ph-md{max-width:none;padding-top:8px;border-top:1px solid var(--border);font-size:var(--fs-3);line-height:1.55}
+.c3 .c3ph-md h1,.c3 .c3ph-md h2{font-size:var(--fs-4);margin:12px 0 4px}
+.c3 .c3ph-md p{margin:6px 0}
+.c3 .c3ph-md .tw{max-width:100%}

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

@@ -34,7 +34,7 @@ import { parseMd, toDom } from './c3-md.js';
 import { makeXp, attachExpand } from './c3-expand.js';
 import { attachSwipe } from './c3-swipe.js';
 import { toast } from './c3-toast.js';
-import { openSheet, closeSheet } from './c3-sheet.js';
+import { openSheet } from './c3-sheet.js';
 import { c3btn } from './page-agent.js';
 import { onBriefing, loadBriefing } from './shell-ticker.js';
 import { reviewSection } from './c3-brief.js';
@@ -729,9 +729,9 @@ const AG = {
   orDecide: 'Or decide', conv: 'Conversation with the agent', show: 'Show', hide: 'Hide', showAll: 'Show all', showLess: 'Show less', open: 'Open', copy: 'Copy', copied: 'Copied.',
   send: 'Send to the agent', replyWhat: (w) => `The agent drafts it again. ${w ? `Nothing goes to ${w} or to anyone.` : 'Nothing leaves PMOS.'}`,
   theDraft: 'the draft above', beingRedrafted: 'being redrafted',
-  round: (n) => 'Agent draft, round ' + n, yours: 'Edited by you', viewRound: (n) => 'View round ' + n, viewEdit: 'View your edit', earlier: 'earlier version',
+  round: (n) => 'Agent draft, round ' + n, yours: 'Edited by you', viewRound: (n) => 'View round ' + n, viewEdit: 'View your edit',
   noteLabel: 'Tell the agent what to change', openDraft: 'Open the draft', editDraft: 'Edit the draft', edited: 'Edited by you. Post sends your text.',
-  saveDraft: 'Save the draft', cancel: 'Cancel', savedDraft: (w) => `Saved. Post sends your text to ${w}.`, savedMine: 'Saved. The draft stays here.', bodyLabel: 'The draft',
+  savedDraft: (w) => `Saved. Post sends your text to ${w}.`, savedMine: 'Saved. The draft stays here.',
   doneIt: 'Mark it done', doneFx: 'Closes the item. Nothing is posted', doneToast: 'Done. Nothing was posted.', draftSheet: (k) => 'Draft for ' + k, stop: 'stop',
   handed: (w) => `Handed to the agent. Nothing goes to ${w} until you post it.`, stopped: 'Stopped. Nothing was kept.', kept: 'Kept as a draft. Post it when you are ready.',
   posting: 'Approved. A session posts exactly this text.', sentBack: 'Sent back with your note. The agent drafts it again.', retried: 'The agent tries again.',
@@ -903,35 +903,41 @@ function openAgentSession(id, item) {
 /* The agent's draft drawn the way a document is (c3-md.js, as the document sheet draws it): headings, lists, tables, bold. */
 const draftMd = (text) => el('div', { class: 'ds-md wk-agent-md' }, toDom(parseMd(String(text || '')), document));
 
-/* The agent's draft in a sheet. A draft that waits for the PM can be edited there (amendment 13): Save keeps the PM's text
- * as the draft, so Post sends exactly that text. */
-function openDraft(item, inst, editing, ver) {
-  const a = item.agent || {}; const d = ver ? { body: ver.body, summary: ver.kind === 'draft' ? ver.text : '' } : a.draft || {};
-  const canEdit = !!inst && a.state === 'ready' && !ver;
-  const area = el('textarea', { class: 'wk-agent-edit', rows: '18', 'aria-label': AG.bodyLabel, 'data-pm-agent-edit-in': item.id });
-  area.value = d.body || '';
-  const save = async () => {
-    const v = area.value.trim();
-    if (!v) { say({ text: 'The draft cannot be empty. Send it back with a note instead.', timeout: 3500 }); area.focus(); return; }
-    const r = await pmPost('/api/my-work/decide', { item: item.id, action: 'edit', body: v });
-    if (!r || !r.ok) { say({ text: (r && r.error) || COPY.saveError, tone: 'error' }); return; }
-    closeSheet();
-    say({ text: isMine(item) ? AG.savedMine : AG.savedDraft(whereOf(item)), timeout: 4000 });
-    await load(inst);
-  };
-  const text = editing && canEdit
-    ? el('div', { class: 'wk-agent-editbox' }, area, el('div', { class: 'chips2' },
-      button({ label: AG.saveDraft, variant: 'primary', size: 'sm', onClick: save, attrs: { 'data-pm-agent-save': item.id } }),
-      button({ label: AG.cancel, variant: 'outline', size: 'sm', onClick: () => openDraft(item, inst, false) })))
-    : el('div', { class: 'wk-agent-doc' }, draftMd(d.body || ''));
-  const body = el('div', { class: 'wk-agent-sheet' },
-    el('div', { class: 'chips' }, el('span', { class: 'tag' }, ver ? AG.earlier : a.state === 'sent' ? 'posted' : d.edited_at ? 'draft · edited by you' : 'draft'), item.key ? el('span', { class: 'chip2' }, c3ic('org', 'sm'), (item.origin === 'jira' ? 'Jira ' : '') + item.key) : null),
-    d.summary ? el('p', { class: 'dim wk-agent-sum' }, d.summary) : null,
-    text,
-    el('div', { class: 'fold' }, c3ic('info', 'sm'), ' ' + (ver ? 'This is an earlier version. The draft on the item is the newest one.' : a.state === 'sent' ? 'This is the text that was posted.' : isMine(item) ? 'This stays here in PMOS.' : 'Nothing is in ' + whereOf(item) + ' yet. Post it from the item, after you read it.')));
-  const actions = canEdit && !editing ? [c3btn('chip2 lk', { 'data-pm-agent-edit-sheet': item.id }, [c3ic('edit', 'sm'), AG.editDraft], () => openDraft(item, inst, true))] : null;
-  openSheet({ title: ver ? ver.label + (ver.at ? ' · ' + hhmm(ver.at) : '') : AG.draftSheet(item.key || item.title), icon: 'doc', body, actions });
-  if (editing && canEdit) { try { area.focus(); } catch { /* not focusable yet */ } }
+/* The agent's draft opens in the document sheet, the one every other document opens in (amendment 16): Read with its outline,
+ * Edit (Save keeps the PM's text as the draft, so Post sends exactly that text: amendment 13), Proposals (a note sends the draft
+ * back to the agent), Edit log (the conversation with the agent) and Health. An earlier version (ver) opens read-only. */
+async function openDraft(item, inst, editing, ver) {
+  const a = item.agent || {}; const d = a.draft || {};
+  const live = !!inst && a.state === 'ready' && !ver;
+  const w = whereOf(item); const mine = isMine(item);
+  const what = { ask: mine ? 'added the item' : 'asked', draft: 'drafted it', note: 'sent it back', edit: 'edited the draft', post: 'posted it' };
+  const log = turnsOf(item).map((t) => ({ who: t.who === 'agent' ? 'agent' : 'pm', what: (t.body ? t.label + ': ' : '') + (what[t.kind] || t.kind), at: t.at || null, text: t.kind === 'draft' ? t.text : t.kind === 'note' || t.kind === 'ask' ? t.text : '' }));
+  const why = ver ? 'This is an earlier version. The draft on the item is the newest one.'
+    : a.state === 'sent' ? 'This is the text that was posted. It is kept on the item, not as a file.'
+      : 'This draft is kept on the item, not as a file. ' + (mine ? 'It stays here in PMOS.' : 'Nothing is in ' + w + ' yet. Post it from the item, after you read it.');
+  const generated = { text: ver ? ver.body || '' : d.body || '', why, log, health: { passed: 0, total: 0, checks: [], err: 'Health checks run on stored documents. This draft is kept on the item.' } };
+  if (live) {
+    generated.save = async (text) => {
+      const v = String(text || '').trim();
+      if (!v) return { ok: false, error: 'The draft cannot be empty. Send it back with a note instead.' };
+      const r = await pmPost('/api/my-work/decide', { item: item.id, action: 'edit', body: v });
+      if (r && r.ok) load(inst);
+      return r || { ok: false, error: COPY.saveError };
+    };
+    generated.saved = mine ? AG.savedMine : AG.savedDraft(w);
+    generated.ask = async (note) => {
+      const r = await pmPost('/api/my-work/decide', { item: item.id, action: 'revise', note });
+      if (r && r.ok) { say({ text: AG.sentBack, timeout: 3500 }); load(inst); }
+      return r || { ok: false, error: COPY.saveError };
+    };
+    generated.askWhy = 'The agent drafts it again with your note, on the item. ' + AG.replyWhat(mine ? '' : w);
+  }
+  const title = (ver ? ver.label + (ver.at ? ' · ' + hhmm(ver.at) : '') + ' · ' : '') + (mine ? 'Draft: ' + (item.title || '') : AG.draftSheet(item.key || item.title));
+  const relations = () => el('ul', { class: 'ds-rel', 'data-pm-agent-rel': item.id }, el('li', null, c3ic(item.url ? 'out' : 'doc', 'sm'),
+    item.url ? el('a', { class: 'ds-rlk', href: item.url, target: '_blank', rel: 'noopener noreferrer' }, item.key || item.title, el('small', null, 'the item this draft is for')) : el('span', { class: 'ds-rlk' }, item.title || '', el('small', null, 'the item this draft is for'))));
+  const { openDocSheet } = await import('./c3-doc-sheet.js');
+  return openDocSheet({ ws: inst && inst.ctx ? inst.ctx.ws : '', doc: { path: '', name: title, ty: 'Draft', v: ver ? '' : (d.edited_at ? 'edited by you' : ''), st: a.state === 'sent' ? 'issued' : 'draft', ini: '', iniName: mine ? 'Work' : w },
+    mode: editing && live ? 'edit' : 'read', generated, relations });
 }
 
 /** The case file element of an item: c3-case.js plus what is Work's own (offline work, the shared actions, the steps, the agent tray, the edit fields). */