create-pmos 0.179.0 → 0.180.0

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

@@ -40,8 +40,10 @@ import { c3ic } from './pm-work-view.js';
 import { openSheet } from './c3-sheet.js';
 import { say } from './c3-init-extras.js';
 import { c3btn } from './page-agent.js';
+import { button } from './primitives.js';
 import { mountSlide } from './slide-confirm.js';
 import { parseMd, toMd, canonMd, diffMd, toDom, fromDom, wordCounts, safeHref } from './c3-md.js';
+import { ensureReportCss, formatOf, formatView, outlineLabels, downloadsOf, printPdf, copyKindFor } from './c3-doc-formats.js';
 
 /* ── pure: sections, round trip, word diff ── */
 
@@ -179,7 +181,7 @@ export function composeSections(base, groups, intro, front) {
 /* ── the sheet ── */
 
 const NAMES = { fresh: 'Fresh', decisions: 'Matches decisions', data: 'Matches the data', complete: 'Complete', traced: 'Traced to a goal and tickets', readers: 'Readers have this version' };
-const STATE = { current: ['Current', 'ds-good', 'check'], stale: ['Stale', 'ds-warn', 'alert'], draft: ['Draft', 'ds-pe', 'clock'], missing: ['Missing', 'ds-bad', 'plus'] };
+const STATE = { issued: ['Issued', 'ds-good', 'check'], current: ['Current', 'ds-good', 'check'], stale: ['Stale', 'ds-warn', 'alert'], draft: ['Draft', 'ds-pe', 'clock'], missing: ['Missing', 'ds-bad', 'plus'] };
 const TABS = [['read', 'eye', 'Read'], ['edit', 'edit', 'Edit'], ['ask', 'spark', 'Proposals'], ['hist', 'clock', 'Edit log'], ['health', 'shield', 'Health'], ['links', 'init', 'Relations']];
 const MODE = { proposals: 'ask', props: 'ask', log: 'hist', history: 'hist' };
 const isDemo = () => !!window.__c3demo;
@@ -190,6 +192,8 @@ const hcls = (h) => (!h || h.total === 0 ? '' : h.passed === h.total ? 'ds-good'
 const isAgentRev = (r) => !!r && (r.text_by ? r.text_by === 'agent' : byName(r.by) === 'Agent');
 const md = (text, extra) => el('div', { class: 'ds-md' + (extra ? ' ' + extra : '') }, toDom(parseMd(text), document));
 const btn = (cls, attrs, kids, onClick) => c3btn(cls, attrs, kids, onClick);
+/* a console3 primitive button (the Issue press and the menu: the mockup's UI.btn) */
+const pb = (variant, attrs, kids, onClick) => { const b = button({ label: '', variant, size: 'sm', onClick, attrs: attrs || {} }); b.replaceChildren(...[].concat(kids).filter((k) => k != null && k !== false)); return b; };
 const headLevel = (s) => (/^(#+)/.exec(s.prefix || '') || ['', ''])[1].length;
 
 /* ── v2 (c3-doc-sheet-v2): the copies in other tools, the outline, the graph ── */
@@ -201,16 +205,19 @@ const SIG = {
   diverged: ['Both changed', 'alert', 'ds-bad', 'Both changed since they last matched.', 'both changed'],
   unchecked: ['Not checked', 'info', '', 'No check has read this copy yet.', 'not checked'],
   unreadable: ['Cannot open', 'alert', 'ds-bad', 'The last check could not open the copy.', 'cannot open'],
+  none: ['Not created', 'info', '', 'No copy exists yet.', 'not created'],
   'missing-remote': ['Not found', 'alert', 'ds-bad', 'The copy is not there any more.', 'not found'],
   'missing-repo': ['Not in PMOS', 'alert', 'ds-bad', 'This file is not in the repository any more.', 'not in PMOS'] };
 const SYNCING = ['Updating', 'clock', 'ds-acc', 'A session is updating this copy.', 'updating'];
-const KLABEL = { google: 'Google Doc', confluence: 'Confluence' };
+const KLABEL = { google: 'Google Doc', 'google-slides': 'Google Slides', 'google-sheets': 'Google Sheets', confluence: 'Confluence' };
 const sigOf = (l) => (l.syncing ? SYNCING : SIG[l.signal] || SIG.unchecked);
 const labelOf = (l) => KLABEL[l.kind] || l.label || l.kind;
 /** Which tool a pasted address names (the server checks it again): 'confluence', 'google' or null. */
 export function copyKindOf(target) {
   const t = String(target || '');
   if (/atlassian|confluence|\/wiki\/|pageId=/i.test(t)) return 'confluence';
+  if (/docs\.google\.com\/presentation|slides\.google|\/presentation\/d\//i.test(t)) return 'google-slides';
+  if (/docs\.google\.com\/spreadsheets|sheets\.google|\/spreadsheets\/d\//i.test(t)) return 'google-sheets';
   if (/google|docs\.|drive\./i.test(t)) return 'google';
   return null;
 }
@@ -244,13 +251,20 @@ const olGet = () => { try { return localStorage.getItem(OL_KEY) !== 'off'; } cat
 const olSet = (on) => { try { localStorage.setItem(OL_KEY, on ? 'on' : 'off'); } catch { /* no storage here */ } };
 const ESTATE = { ok: 'in step', drift: 'out of step', conflict: 'conflict', missing: 'missing', ahead: 'PMOS ahead' };
 
-export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, onChanged, generated, secExtra, library, openGraph }) {
+export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, onChanged, generated, secExtra, library, openGraph, report }) {
   const S = { mode: MODE[mode] || mode, prompt, text: null, err: '', revs: null, texts: {}, health: null, hAsk: false, busy: false, changed: false,
     meta: null, metaFor: null, props: null, propsErr: '', log: null, logErr: '', asking: null, closed: false, who: false, src: false, preview: {},
     pick: {}, rejFor: null, rejWhy: '', whyFor: null, whyText: '', staleWhy: null, logF: 'all', cmp: null, cmpNode: null, flashRev: null, ed: null, leave: null,
-    copies: null, copiesErr: '', syncOpen: false, linking: false, linkUrl: '', pend: {}, checkRun: null, lib: undefined, ol: olGet(), olOpen: false, olq: '', olShut: {}, cur: null };
+    copies: null, copiesErr: '', syncOpen: false, menu: false, linking: false, linkUrl: '', pend: {}, checkRun: null, lib: undefined, ol: olGet(), olOpen: false, olq: '', olShut: {}, cur: null };
   const demo = isDemo();
   const base = { ws, path: doc.path };
+  /* a report cycle (initiative report-workspace): report = { output, state: 'draft'|'issued', name, cycle, foot, onIssue(doc), onNext(doc), onState(state) }.
+   * It is a document with an output format: Read draws it as slides, a grid, a page or A4 pages, an issued one is frozen, and the copy is
+   * created by the PM's press. Everything else in the sheet is the ordinary document sheet. */
+  const R = report || null;
+  if (R) ensureReportCss();
+  const frozen = () => !!R && R.state === 'issued';
+  const fmt = () => formatOf(R && R.output);
   let ui = null;
 
   /* ── data ── */
@@ -324,11 +338,12 @@ export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, o
   const goEl = (sel) => { const n = ui && ui.body.querySelector(sel); if (n) { n.scrollIntoView({ block: 'start' }); n.classList.remove('flash'); void n.offsetWidth; n.classList.add('flash'); } };
 
   function head() {
-    const st = STATE[fresh() ? 'stale' : doc.st] || STATE.current; const h = S.health; const last = lastRev();
+    const st = STATE[R ? R.state : fresh() ? 'stale' : doc.st] || STATE.current; const h = S.health; const last = lastRev();
     return el('div', { class: 'chips2 ds-meta', 'data-doc-meta': '' },
       el('span', { class: 'chip2 ' + st[1] }, c3ic(st[2], 'sm'), st[0]), el('span', { class: 'chip2' }, doc.ty || 'Document'), doc.v ? el('span', { class: 'chip2 mono' }, doc.v) : null,
       h && h.total ? btn('chip2 lk ' + hcls(h), { 'data-doc-hchip': '' }, [c3ic('shield', 'sm'), h.passed + ' of ' + h.total + ' checks'], () => go('health')) : null,
       el('span', { class: 'chip2' }, c3ic('init', 'sm'), doc.iniName || doc.ini || 'Portfolio'), copyChips(),
+      R ? el('span', { class: 'chip2', 'data-doc-format': R.output }, c3ic(fmt().ic, 'sm'), fmt().l) : null,
       last && !generated ? btn('chip2 lk', { 'data-doc-last': '' }, [c3ic(isAgentRev(last) ? 'spark' : 'user', 'sm'), 'Last change: ', el('b', null, whoOf(last) + ','), ' ' + dayName(last.at)], () => go('hist')) : null);
   }
   function seg() {
@@ -389,10 +404,13 @@ export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, o
     const d = (j.docs || []).find((x) => x.path === doc.path);
     S.copies = d ? d.links || [] : []; S.copiesErr = ''; S.checkRun = j.session || j.open || null;
   };
+  /* a report with no copy yet still shows the copy it will make: the tool its output keeps its copy in, "not created" */
+  const copyList = () => { const L = S.copies || []; return R && !L.length && fmt().copy ? [{ kind: fmt().copy, signal: 'none', synthetic: true, title: doc.name }] : L; };
   const copyChips = () => {
     if (generated || S.copies == null) return null;
-    if (!S.copies.length) return btn('chip2 lk', { 'data-doc-copychip': '', 'aria-expanded': String(S.syncOpen) }, [c3ic('link', 'sm'), 'Link a Confluence or Google Doc copy'], () => toggleCopies());
-    return S.copies.map((l) => { const g = sigOf(l); return btn('chip2 lk ' + g[2], { 'data-doc-copychip': l.kind, 'aria-expanded': String(S.syncOpen), title: l.words || g[3] }, [c3ic(g[1], 'sm'), labelOf(l) + ': ' + g[4]], () => toggleCopies()); });
+    if (R && !fmt().copy) return btn('chip2 lk', { 'data-doc-copychip': 'pdf', 'aria-expanded': String(S.syncOpen) }, [c3ic('pdf', 'sm'), 'PDF: no live copy'], () => toggleCopies());
+    if (!copyList().length) return btn('chip2 lk', { 'data-doc-copychip': '', 'aria-expanded': String(S.syncOpen) }, [c3ic('link', 'sm'), 'Link a Confluence or Google Doc copy'], () => toggleCopies());
+    return copyList().map((l) => { const g = sigOf(l); return btn('chip2 lk ' + g[2], { 'data-doc-copychip': l.kind, 'aria-expanded': String(S.syncOpen), title: l.words || g[3] }, [c3ic(g[1], 'sm'), labelOf(l) + ': ' + g[4]], () => toggleCopies()); });
   };
   function toggleCopies() {
     S.syncOpen = !S.syncOpen;
@@ -401,23 +419,28 @@ export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, o
   }
   function copiesPanel() {
     if (!S.syncOpen || generated) return null;
-    const L = S.copies || [];
+    if (R && !fmt().copy) return el('section', { class: 'ds-sync', 'aria-label': 'Copies in other tools', 'data-doc-copies': '' }, el('div', { class: 'hd' }, el('b', null, 'Copies in other tools'),
+      btn('ds-btn', { 'aria-label': 'Close the copies', 'data-copy-close': '' }, c3ic('x', 'sm'), () => { S.syncOpen = false; draw(); })),
+    el('div', { class: 'fold' }, c3ic('info', 'sm'), 'A PDF has no live copy. Download it when you issue. Nothing goes to another tool.'));
+    const L = R ? copyList() : (S.copies || []);
     const rows = L.map((l) => {
       const g = sigOf(l); const name = labelOf(l); const pend = S.pend[l.kind];
       const acts = [btn('ds-btn', { 'data-copy-check': l.kind, disabled: !!S.checkRun, 'aria-disabled': S.checkRun ? 'true' : null }, [c3ic(S.checkRun ? 'clock' : 'undo', 'sm'), S.checkRun ? 'Checking' : 'Check now'], () => checkNow()),
         l.url ? el('a', { class: 'ds-btn', href: l.url, target: '_blank', rel: 'noopener', 'data-copy-open': l.kind }, c3ic('out', 'sm'), 'Open in ' + name) : null];
       if (!l.syncing && (l.signal === 'behind' || l.signal === 'diverged')) acts.push(btn('ds-btn ag', { 'data-copy-take': l.kind }, [c3ic('spark', 'sm'), 'Bring their change in as a proposal'], () => takeCopy(l)));
       if (!l.syncing && l.signal === 'ahead') acts.push(pend ? btn('ds-btn', { 'data-copy-undo': l.kind }, [c3ic('undo', 'sm'), 'Undo the update'], () => undoPush(l))
-        : btn('ds-btn pri', { 'data-copy-push': l.kind }, [c3ic('up', 'sm'), 'Update the ' + name + ' to this version'], () => pushCopy(l)));
+        : btn('ds-btn pri', { 'data-copy-push': l.kind }, [c3ic('up', 'sm'), R ? 'Update the ' + name + ' copy to ' + (doc.v || 'this version') : 'Update the ' + name + ' to this version'], () => pushCopy(l)));
+      if (R && !l.syncing && l.signal === 'none') acts.push(pend ? btn('ds-btn', { 'data-copy-undo': l.kind }, [c3ic('undo', 'sm'), 'Undo'], () => undoPush(l))
+        : btn('ds-btn pri', { 'data-copy-create': l.kind }, [c3ic('out', 'sm'), 'Create the ' + name + ' copy'], () => createCopy(l)));
       const changed = l.remote_modified_at ? 'changed ' + whenOf(l.remote_modified_at) + (l.remote_modified_by ? ' by ' + l.remote_modified_by : '') : '';
       return el('li', { 'data-copy': l.kind },
         el('div', { class: 'l1' }, c3ic('doc', 'sm'), el('b', null, l.title || name), el('span', { class: 'tag ' + g[2], 'data-copy-state': l.syncing ? 'syncing' : l.signal || 'unchecked' }, c3ic(g[1], 'sm'), g[0])),
         el('div', { class: 'ds-mono' }, [name, l.target, changed].filter(Boolean).join(' · ')),
-        el('p', null, l.words || g[3]),
+        el('p', null, l.words || (R && l.signal === 'none' ? 'No copy exists yet. PMOS writes to ' + name + ' only when you press Create the ' + name + ' copy.' : g[3])),
         el('div', { class: 'ds-note' }, l.checked_at ? 'Last checked ' + whenOf(l.checked_at) + (l.checked_by ? ' by ' + byName(l.checked_by) : '') + '.' : 'Not checked yet.'),
         l.syncing ? el('div', { class: 'fold', role: 'status', 'data-copy-syncing': l.kind }, c3ic('clock', 'sm'), 'A session is updating ' + (l.syncing.use === 'copy' ? 'PMOS from the ' + name : 'the ' + name + ' to this version') + (l.syncing.started_at ? '. It started ' + whenOf(l.syncing.started_at) + '.' : '.')) : null,
         l.sync_failed ? el('div', { class: 'fold w', role: 'alert', 'data-copy-failed': l.kind }, c3ic('alert', 'sm'), 'The last update did not finish' + (l.sync_failed.reason ? ': ' + l.sync_failed.reason : '.')) : null,
-        pend ? el('div', { class: 'fold', role: 'status', 'data-copy-pending': l.kind }, c3ic('clock', 'sm'), 'The update starts in five seconds. Undo stops it.') : null,
+        pend ? el('div', { class: 'fold', role: 'status', 'data-copy-pending': l.kind }, c3ic('clock', 'sm'), (R && l.signal === 'none' ? 'The copy is created in five seconds' : 'The update starts in five seconds') + '. Undo stops it.') : null,
         el('div', { class: 'ds-acts' }, acts));
     });
     const linkRow = S.linking ? el('div', { class: 'ds-whyadd ds-linkadd' },
@@ -425,11 +448,12 @@ export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, o
       btn('ds-btn pri', { 'data-copy-linkok': '' }, 'Link', () => linkCopy()), btn('ds-btn', {}, 'Cancel', () => { S.linking = false; draw(); })) : null;
     return el('section', { class: 'ds-sync', 'aria-label': 'Copies in other tools', 'data-doc-copies': '' },
       el('div', { class: 'hd' }, el('b', null, 'Copies in other tools'), el('span', { class: 'ds-acts' },
-        btn('ds-btn', { 'data-copy-link': '' }, [c3ic('link', 'sm'), L.length ? 'Link another copy' : 'Link a copy'], () => { S.linking = true; S.linkUrl = ''; draw(); const i = ui.body.querySelector('#dcopyurl'); if (i) i.focus(); }),
+        R ? null : btn('ds-btn', { 'data-copy-link': '' }, [c3ic('link', 'sm'), L.length ? 'Link another copy' : 'Link a copy'], () => { S.linking = true; S.linkUrl = ''; draw(); const i = ui.body.querySelector('#dcopyurl'); if (i) i.focus(); }),
         btn('ds-btn', { 'aria-label': 'Close the copies', 'data-copy-close': '' }, c3ic('x', 'sm'), () => { S.syncOpen = false; draw(); }))),
       S.copiesErr ? el('div', { class: 'fold w', role: 'alert' }, c3ic('alert', 'sm'), S.copiesErr) : null, linkRow,
       L.length ? el('ul', null, rows) : el('p', { class: 'ds-note', 'data-copy-none': '' }, 'This document has no copy in Confluence or Google Docs yet. Link one to see whether it is in step.'),
-      el('p', { class: 'ds-note' }, 'PMOS never overwrites this document from a copy: a change in the copy comes in as a proposal you accept by section. Updating a copy starts one agent session, and you have five seconds to undo.'));
+      el('p', { class: 'ds-note' }, R ? 'PMOS never writes to ' + fmt().app + ' on its own. Create and Update start one agent session through your own connector, and you can undo for 5 seconds. Nothing is sent to people.'
+        : 'PMOS never overwrites this document from a copy: a change in the copy comes in as a proposal you accept by section. Updating a copy starts one agent session, and you have five seconds to undo.'));
   }
   async function checkNow() {
     const r = await pmPost('/api/docs/check', { ws }).catch(() => null);
@@ -459,6 +483,18 @@ export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, o
     }, 5000);
     draw();
   }
+  function createCopy(l) {
+    const name = labelOf(l);
+    S.pend[l.kind] = setTimeout(async () => {
+      delete S.pend[l.kind];
+      const r = await pmPost('/api/docs/create-copy', { ws, path: doc.path, kind: l.kind }).catch(() => null);
+      if (!r || !r.ok) say((r && r.error) || 'The copy did not start.');
+      else say('Creating the ' + name + ' copy. A session writes it with your connector. Nothing is sent to people.');
+      await loadCopies(); drawBg();
+    }, 5000);
+    draw();
+    say('Creating the ' + name + ' copy in five seconds. Nothing is sent to people.', () => undoPush(l));
+  }
   function undoPush(l) { clearTimeout(S.pend[l.kind]); delete S.pend[l.kind]; draw(); say('Stopped. The ' + labelOf(l) + ' is not updated.'); }
   async function linkCopy() {
     const t = String(S.linkUrl || '').trim(); const kind = copyKindOf(t);
@@ -488,12 +524,12 @@ export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, o
       const on = S.cur === s.i;
       rows.push(el('li', { class: 'l' + lv + (on ? ' on' : ''), 'data-ol-i': String(s.i) },
         n && !qq ? btn('tw', { 'aria-label': (shut ? 'Show' : 'Hide') + ' the ' + plural(n, 'heading') + ' under ' + s.name, 'aria-expanded': String(!shut), 'data-ol-fold': String(s.i) }, c3ic('next', 'sm'), () => { S.olShut[s.i] = !shut; redrawOl(); }) : el('span', { class: 'tw' }),
-        btn('go', { 'data-ol-go': String(s.i), 'aria-current': on ? 'location' : null }, [el('span', null, s.name),
+        btn('go', { 'data-ol-go': String(s.i), 'aria-current': on ? 'location' : null }, [el('span', null, it.label || s.name),
           stale.has(s.name) ? el('i', { class: 'mdot w', title: 'A source changed after this section', 'data-ol-stale': '' }) : null,
           prop.has(s.name) ? el('i', { class: 'mdot p', title: 'The agent proposes a change here', 'data-ol-prop': '' }) : null], () => jumpTo(s.i))));
     });
     return el('nav', { class: 'ds-ol', 'aria-label': 'Outline', 'data-doc-outline': '' },
-      el('div', { class: 'hd' }, el('b', null, 'Outline'), el('span', { class: 'ds-mono' }, plural(items.length, 'heading'))),
+      el('div', { class: 'hd' }, el('b', null, 'Outline'), el('span', { class: 'ds-mono' }, plural(items.length, R ? fmt().word.replace(/s$/, '') : 'heading'))),
       items.length > 12 ? el('input', { type: 'text', id: 'dolq', 'data-ol-find': '', placeholder: 'Find a heading', 'aria-label': 'Find a heading', value: S.olq, onInput: (e) => { S.olq = e.target.value; redrawOl(); } }) : null,
       el('ul', null, rows.length ? rows : el('li', { class: 'none ds-note' }, 'No heading matches.')),
       stale.size || prop.size ? el('div', { class: 'key ds-note' }, stale.size ? el('span', null, el('i', { class: 'mdot w' }), 'stale') : null, prop.size ? el('span', null, el('i', { class: 'mdot p' }), 'proposal') : null) : null);
@@ -634,7 +670,7 @@ export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, o
     if (S.text == null) return S.err ? el('div', { class: 'fold w', role: 'alert' }, c3ic('alert', 'sm'), S.err) : el('div', { class: 'fold', role: 'status' }, c3ic('clock', 'sm'), 'Reading the document.');
     const secs = splitDoc(S.text);
     if (!S.text.trim()) return el('div', { class: 'fold' }, c3ic('moon', 'sm'), 'The document is empty.');
-    const items = outlineOf(secs); const olOn = items.length >= 2 && !S.src;
+    const items = R ? outlineLabels(secs, R.output) : outlineOf(secs); const olOn = items.length >= 2 && !S.src;
     if (S.cur == null && items.length) S.cur = items[0].s.i;
     const curName = (items.find((x) => x.s.i === S.cur) || items[0] || { s: { name: '' } }).s.name;
     const olCtl = olOn ? el('span', { class: 'ds-acts' },
@@ -652,23 +688,24 @@ export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, o
     const meta = S.meta || {};
     const pins = (name) => openProps().filter((p) => p.sections.some((c) => c.name === name && c.kind !== 'added'));
     const flags = {}; failing().forEach((c) => { if (c.section && c.flag) flags[c.section] = c.flag; });
-    const cells = secs.map((s) => {
+    const secCell = (s, inner, label) => {
       const fm = s.prefix === '' ? parseFront(s.text) : null;
       const body = fm ? fm.rest.trim() : s.text;
       if (!s.prefix && !body) return null;
       const r = meta[s.name]; const P = pins(s.name);
       const shown = P.find((p) => S.preview[p.id]);
       const ch = shown && shown.sections.find((c) => c.name === s.name);
-      const content = ch ? md(diffMd(ch.stale ? s.text : ch.before, ch.after), 'ds-body') : body ? md(body, 'ds-body') : headLevel(s) === 1 ? null : el('p', { class: 'ds-note' }, 'This section is empty.');
+      const content = ch ? md(diffMd(ch.stale ? s.text : ch.before, ch.after), 'ds-body') : inner ? inner : body ? md(body, 'ds-body') : headLevel(s) === 1 ? null : el('p', { class: 'ds-note' }, 'This section is empty.');
       const lvl = Math.min(3, Math.max(2, headLevel(s)));
       return el('div', { class: 'ds-sec ' + (r ? (isAgentRev(r) ? 'a' : 'h') : '') + (ch ? ' prev' : ''), 'data-dsec': s.name, 'data-dsec-i': String(s.i) },
-        s.prefix ? el('div', { class: 'ds-sec-h' }, headLevel(s) === 1 ? el('div', { class: 'ds-md' }, el('h1', null, s.name)) : el('h' + lvl, null, s.name), generated ? null : byChip(r)) : null,
+        s.prefix ? el('div', { class: 'ds-sec-h' }, label ? el('h3', null, label) : headLevel(s) === 1 ? el('div', { class: 'ds-md' }, el('h1', null, s.name)) : el('h' + lvl, null, s.name), generated ? null : byChip(r)) : null,
         P.map((p) => { const c = p.sections.find((x) => x.name === s.name); return el('div', { class: 'ds-pin', 'data-doc-pin': p.id }, el('span', null, c3ic('spark', 'sm'), (c.stale ? 'A proposal was drafted against older text here' : 'The agent proposes a change here') + ': “' + short(p.prompt) + '”'),
           el('span', { class: 'ds-acts' }, btn('ds-btn', { 'data-doc-preview': p.id }, S.preview[p.id] ? 'Show current' : 'Show change', () => { S.preview[p.id] = !S.preview[p.id]; draw(); }),
             btn('ds-btn ag', {}, 'Review', () => { S.openProp = p.id; go('ask'); }))); }),
         flags[s.name] ? el('div', { class: 'fold w', role: 'note' }, c3ic('alert', 'sm'), flags[s.name]) : null,
         content, secExtra ? secExtra(s.name) : null);
-    });
+    };
+    const cells = R && !S.src ? [formatView({ output: R.output, name: R.name || doc.name, cycle: R.cycle, foot: R.foot, secs, md: (t) => md(t, 'ds-body'), wrap: (s, inner, label) => secCell(s, inner, label) })] : secs.map((s) => secCell(s));
     const adds = openProps().flatMap((p) => p.sections.filter((c) => c.kind === 'added' && S.preview[p.id]).map((c) => el('div', { class: 'ds-sec a prev', 'data-dsec-new': c.name },
       el('div', { class: 'ds-pin' }, el('span', null, c3ic('spark', 'sm'), 'The proposal adds a section: ' + c.name)), el('div', { class: 'ds-sec-h' }, el('h2', null, c.name)), md(diffMd(null, c.after), 'ds-body'))));
     const main = [generated ? el('div', { class: 'fold', role: 'note', 'data-doc-generated': '' }, c3ic('info', 'sm'), generated.why) : null, staleBanner(), propsBlock(secs, false), cells, adds];
@@ -679,7 +716,7 @@ export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, o
 
   /* ── Edit ── */
   function startEdit() {
-    if (generated || S.text == null) { S.ed = null; return; }
+    if (generated || 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() {
@@ -777,6 +814,8 @@ export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, o
   }
   function editBody() {
     if (generated) 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();
     if (!S.ed) startEdit();
     const E = S.ed;
@@ -815,6 +854,7 @@ export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, o
 
   /* ── 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.');
     const A = S.asking;
     const ta = el('textarea', { id: 'dpr', placeholder: 'Tell the agent what to change, for example: add a one-paragraph summary at the top', 'aria-label': 'Request to the agent', 'data-doc-prompt': '', onInput: (e) => { S.prompt = e.target.value; } }, S.prompt);
     const sug = [...new Set(failing().map((c) => c.fix).filter(Boolean))];
@@ -876,8 +916,8 @@ export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, o
         md(c.kind === 'added' ? diffMd(null, c.after) : diffMd(c.stale ? c.current || '' : c.before, c.after)));
     });
     const host = el('div', { class: 'ds-slide', 'data-doc-slide': p.id });
-    if (n) mountSlide(host, { label: 'Slide to accept ' + n + ' of ' + p.sections.length, hash: p.hash, onConfirm: (h) => acceptProp(p, h) });
-    else host.append(el('div', { class: 'slt-why', role: 'note' }, c3ic('lock', 'sm'), anyStale && p.sections.every((c) => c.stale) ? 'Every section changed since this draft. Ask the agent again.' : 'Tick at least one section to accept.'));
+    if (n && !frozen()) mountSlide(host, { label: 'Slide to accept ' + n + ' of ' + p.sections.length, hash: p.hash, onConfirm: (h) => acceptProp(p, h) });
+    else host.append(el('div', { class: 'slt-why', role: 'note' }, c3ic('lock', 'sm'), frozen() ? 'Issued reports are frozen. Start the next cycle to accept a change.' : anyStale && p.sections.every((c) => c.stale) ? 'Every section changed since this draft. Ask the agent again.' : 'Tick at least one section to accept.'));
     const rej = S.rejFor === p.id
       ? el('div', { class: 'ds-whyadd' }, el('input', { type: 'text', id: 'drejwhy', 'data-doc-rejwhy': '', placeholder: 'Why are you rejecting it? Kept in the edit log.', 'aria-label': 'Why reject', value: S.rejWhy, onInput: (e) => { S.rejWhy = e.target.value; } }),
         btn('ds-btn pri', { 'data-doc-rejok': p.id }, 'Reject', () => rejectProp(p)), btn('ds-btn', {}, 'Cancel', () => { S.rejFor = null; draw(); }))
@@ -1013,15 +1053,65 @@ export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, o
       el('p', { class: 'ds-note' }, 'Health answers one question: can I trust this document without rereading it? The checks run again every time the text changes.'));
   }
 
+  /* ── a report cycle: Issue, the menu (Download, Start the next cycle) ── */
+  const toolsNode = R ? el('span', { class: 'rs-tools' }) : null;
+  const slugOf = (t) => String(t || 'report').toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+  function menuRow() {
+    const items = downloadsOf(R.output);
+    return el('div', { class: 'chips2 rs-menu', role: 'menu', 'aria-label': 'Document actions', 'data-doc-menu': '' }, el('span', { class: 'dim mono ds-mono' }, 'DOWNLOAD'),
+      items.map((it) => pb('outline', { 'data-doc-download': it.fmt, role: 'menuitem' }, [c3ic('drop', 'sm'), it.label], () => download(it))),
+      frozen() ? pb('ghost', { 'data-doc-next': '', role: 'menuitem' }, [c3ic('plus', 'sm'), 'Start the next cycle'], () => nextCycle()) : null);
+  }
+  async function download(it) {
+    S.menu = false; draw();
+    const title = R.name || doc.name; const secs = S.text != null ? splitDoc(S.text) : [];
+    if (it.fmt === 'pdf') {
+      if (!printPdf({ output: R.output, name: title, cycle: R.cycle, secs })) say('The browser blocked the print window. Allow pop-ups for this page, then press Download again.');
+      else say('The print view is open. Choose Save as PDF. Nothing is uploaded.');
+      return;
+    }
+    try {
+      const r = await fetch('/api/report-export?' + q({ ws, path: doc.path, fmt: it.fmt }));
+      if (!r.ok) { let m = ''; try { m = (await r.json()).error; } catch { /* not JSON */ } throw new Error(m || 'the workspace did not make the file'); }
+      const blob = await r.blob();
+      const cd = /filename="?([^";]+)"?/.exec(r.headers.get('content-disposition') || '');
+      const name = cd ? cd[1] : slugOf(title + ' ' + (R.cycle || '')) + '.' + it.fmt;
+      const a = document.createElement('a'); a.href = URL.createObjectURL(blob); a.download = name; document.body.appendChild(a); a.click(); a.remove();
+      setTimeout(() => URL.revokeObjectURL(a.href), 4000);
+      say('Downloaded ' + name + '. Nothing went to another tool.');
+    } catch (e) { say('The file was not made: ' + ((e && e.message) || 'no answer') + '.'); }
+  }
+  async function issue() {
+    /* Issue is the PM's act on the existing route (routes-reports.js, requirePmPress). It freezes the bytes the PM read:
+       the sha comes from the file as served, and the page refuses when that text is not the text on screen. */
+    const m = /reports\/([a-z][a-z0-9-]{0,39})\/(\d{4}-\d{2}-\d{2})\.md$/.exec(doc.path || '');
+    if (!m) { say('This document is not a report cycle, so it cannot be issued.'); return; }
+    const cur = await pmGet('/api/report/draft?' + q({ ws, cadence: m[1], slot: m[2] })).catch(() => null);
+    if (!cur || !cur.ok || !cur.exists || !cur.sha) { say((cur && cur.error) || 'The report was not issued: the file could not be read.'); return; }
+    if (S.text != null && cur.markdown != null && cur.markdown !== S.text) { await reloadAll(); say('The file changed since you opened it. Read it again, then press Issue.'); return; }
+    const r = await pmPost('/api/report/issue', { ws, cadence: m[1], slot: m[2], sha: cur.sha }).catch(() => null);
+    if (!r || !r.ok) { say((r && r.error) || 'The report was not issued.'); return; }
+    R.state = 'issued'; doc.st = 'issued'; S.changed = true; S.menu = false; if (S.mode === 'edit') { S.ed = null; S.mode = 'read'; }
+    if (R.onIssue) R.onIssue(doc);
+    await reloadAll(); say('Issued and frozen. PMOS sends nothing; share it yourself.');
+  }
+  function nextCycle() { S.menu = false; if (R.onNext) R.onNext(doc, ui); else say('The next cycle starts on its schedule. PMOS drafts it then.'); }
+  function drawTools() {
+    if (!toolsNode) return;
+    toolsNode.replaceChildren(...[R.state === 'draft' ? pb('outline', { 'data-doc-issue': '' }, [c3ic('check', 'sm'), 'Issue'], () => issue()) : null,
+      btn('ib sm', { 'aria-label': 'Download and more', title: 'Download and more', 'aria-expanded': String(S.menu), 'data-doc-more': '' }, c3ic('more', 'sm'), () => { S.menu = !S.menu; draw(); })].filter(Boolean));
+  }
+
   /* a load that finished in the background must not redraw under a hand that is typing */
   const drawBg = () => { const a = document.activeElement; if (ui && a && ui.body.contains(a) && a.closest('input,textarea,[contenteditable=true]')) { refreshTop(); return; } draw(); };
-  const top = () => el('div', { class: 'ds-top' }, head(), seg(), S.mode === 'edit' && S.ed ? toolbar() : null,
+  const top = () => el('div', { class: 'ds-top' }, head(), seg(), R && S.menu ? menuRow() : null, S.mode === 'edit' && S.ed ? toolbar() : null,
     S.leave ? el('div', { class: 'fold w', role: 'alert', 'data-doc-leave': '' }, c3ic('alert', 'sm'), 'You have unsaved changes in ' + plural(dirty().length, 'section') + '. ',
       btn('ds-btn', {}, 'Keep editing', () => { S.leave = null; drawEdit(); }), btn('ds-btn', { 'data-doc-discard': '' }, 'Discard and leave', () => { const m = S.leave; S.ed = null; S.leave = null; go(m); })) : null);
   function refreshTop() { const t = ui && ui.body.querySelector('.ds-top'); if (t) t.replaceWith(top()); }
   function draw() {
     if (!ui) return;
     if (S.mode === 'edit' && S.ed && S.ed.kind === 'rich' && S.ed.node) keepRange();
+    drawTools();
     const body = S.mode === 'read' ? readBody() : S.mode === 'edit' ? editBody() : S.mode === 'ask' ? propsBody() : S.mode === 'hist' ? logBody() : S.mode === 'health' ? healthBody() : linksBody();
     const keep = ui.body.querySelector('textarea:focus,input[type=text]:focus');
     const had = keep ? { id: keep.id, s: keep.selectionStart } : null;
@@ -1036,7 +1126,7 @@ export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, o
   }
 
   document.addEventListener('selectionchange', keepRange);
-  ui = openSheet({ title: doc.name, icon: 'doc', dw: true, body: el('div', { class: 'dpn' }), onClose: () => { S.closed = true; document.removeEventListener('selectionchange', keepRange); if (S.changed && onChanged) onChanged(); } });
+  ui = openSheet({ title: doc.name, icon: 'doc', dw: true, actions: toolsNode, body: el('div', { class: 'dpn' }), onClose: () => { S.closed = true; document.removeEventListener('selectionchange', keepRange); if (S.changed && onChanged) onChanged(); } });
   S.open = (d) => { ui.close(); if (S.openOther) S.openOther(d); else openDocSheet({ ws, doc: d, library, openGraph }); };
   ui.setOpener = (fn) => { S.openOther = fn; };
   draw();

package/workspace/public/pm/c3-quiet.js

@@ -8,7 +8,7 @@
  *     - the portfolio: the headline joins the breadcrumb, an empty triage card is not shown, the timeline folds;
  *     - empty chips ("No owner", "0 epics", ...) are not drawn;
  *     - Calendar: the layer chips sit behind one Layers button, the Detail card shows once a meeting is picked;
- *     - Work: the lenses sit beside Add work;  Reports: Share and Edit dashboard join the tab row.
+ *     - Work: the lenses sit beside Add work;  Reports: Send this as a report and Edit dashboard join the tab row.
  * Desktop only: below 601px the page keeps today's layout.
  * The views draw their own markup; this module only moves and hides it, so every press still goes to the view's own handler.
  * It runs again, debounced, whenever the views redraw (one MutationObserver on the root). */
@@ -144,7 +144,7 @@ function apply(root) {
     const add = w.querySelector(':scope > .c3add'), bar = w.querySelector(':scope > .calbar'), l = bar && bar.querySelector('[data-pm-lenses]');
     if (add && l && l.parentElement === bar) { for (const o of add.querySelectorAll('[data-pm-lenses]')) o.remove(); add.appendChild(l); bar.classList.add('qt-moved'); }
   }
-  // Reports: Share and Edit dashboard on the tab row.
+  // Reports: Send this as a report and Edit dashboard on the tab row.
   for (const r of root.querySelectorAll('[data-rp3]')) {
     const scope = r.querySelector(':scope > .calbar .rp3-scope'), acts = r.querySelector('.rp3-head > .chips2');
     if (scope && acts) { for (const o of scope.querySelectorAll('.qt-acts')) o.remove(); acts.classList.add('qt-acts'); scope.appendChild(acts); }

package/workspace/public/pm/c3-report-print.css

@@ -0,0 +1,20 @@
+/* The printable report (Download > PDF): its own window, printed by the browser. Colours are the slide tokens of
+   tokens.css (linked first), so the paper reads the same in either theme. Slides are 16:9 landscape cards (.rp-slide),
+   everything else is A4. */
+@page { size: A4; margin: 16mm; }
+.rp-print { margin: 0; font-family: var(--sans); font-size: 14px; line-height: 1.5; color: var(--slide-fg); background: var(--slide-bg); }
+.rp-print h1 { font-size: 20px; margin: 0 0 4mm; }
+.rp-print h2 { font-size: 16px; margin: 6mm 0 2mm; color: var(--slide-brand); }
+.rp-print p, .rp-print ul { margin: 0 0 3mm; }
+.rp-print table { border-collapse: collapse; width: 100%; margin: 0 0 3mm; }
+.rp-print th, .rp-print td { border: 1px solid var(--slide-border); padding: 2mm 3mm; text-align: left; font-size: 12px; }
+.rp-print th { background: var(--slide-secondary); }
+.rp-print .rp-print-m { color: var(--slide-muted); }
+.rp-print-slides { margin: 0; }
+@page slides { size: 297mm 167mm; margin: 0; }
+.rp-slide { page: slides; page-break-after: always; width: 297mm; height: 167mm; box-sizing: border-box; padding: 14mm; font-size: 20px; }
+.rp-slide h2 { margin-top: 0; font-size: 24px; }
+.rp-slide li { margin-bottom: 2mm; }
+.rp-slide table { font-size: 16px; }
+.rp-slide--title { background: var(--slide-brand); color: var(--slide-bg); }
+.rp-slide--title h2 { color: var(--slide-bg); }

package/workspace/public/pm/c3-report-setup.css

@@ -0,0 +1,62 @@
+/* pm/c3-report-setup.css — the Reports tab (Ask PMOS, Found in your work, Set up, Documents), the "Send this as a report" sheet, the Briefing card, the Settings
+ * block and the report formats of the document sheet (initiative report-workspace). The mockup's 41-reportsetup.css under real class names: .mk-rs is .rs,
+ * .mk-rs-* is .rs-*, .mk-kv is .rs-kv. Tokens only. Corners: 6px on a control or a card drawn as paper, 8px on a container, else 0.
+ * c3-report-setup.js and c3-doc-sheet.js link it once. The slide colours are the --slide-* tokens of tokens.css. */
+/* in .brief a .nrow has two columns, so the row buttons sit under the text */
+.c3 .rs .nrow > .acts { grid-column: 2; justify-content: flex-start; display: flex; gap: 6px; flex-wrap: wrap; }
+.c3 .rs, .c3 .rs > * { min-width: 0; }
+.c3 .rs .nrow .chips .chip2 { max-width: 100%; }
+.c3 .rs .form { margin: 0; }
+.c3 .rs .seg { max-width: 100%; overflow-x: auto; }
+.c3 .rs .seg button { white-space: nowrap; }
+.c3 [data-rs-finder] .nrow > .acts { grid-column: 2; justify-content: flex-start; display: flex; gap: 6px; flex-wrap: wrap; }
+.c3 [data-rs-finder] .seg { max-width: 100%; overflow-x: auto; }
+.c3 .rs .lh { grid-template-columns: auto minmax(0, 1fr); }
+.c3 .rs .lh > .chips2 { grid-column: 1 / -1; }
+.c3 .rs-kv { display: grid; grid-template-columns: max-content minmax(0, 1fr); gap: 4px 12px; margin: 0; font-size: var(--fs-2); }
+.c3 .rs-kv dt { font: var(--fs-1) var(--mono); color: var(--muted-foreground); text-transform: uppercase; letter-spacing: .06em; padding-top: 2px; }
+.c3 .rs-kv dd { margin: 0; min-width: 0; overflow-wrap: anywhere; }
+.c3 .rs-kv input[type="text"] { width: 100%; box-sizing: border-box; }
+.c3 .rs-kv ol { margin: 0; padding-left: 18px; }
+.c3 .rs-lbl { font: var(--fs-1) var(--mono); color: var(--muted-foreground); }
+.c3 .rs-help { font-size: var(--fs-2); }
+.c3 .rs-stack { display: grid; gap: var(--sp-2); }
+.c3 .rs-tools { display: inline-flex; gap: 6px; align-items: center; }
+.c3 .rs-menu { align-items: center; }
+@media (max-width: 560px) { .c3 .rs-kv { grid-template-columns: minmax(0, 1fr); } }
+
+/* Output formats: the document drawn as slides, a grid, a doc page or A4 pages. Paper colours are the slide tokens. */
+.c3 .rs-slides { display: grid; grid-template-columns: repeat(auto-fill, minmax(min(100%, 260px), 1fr)); gap: var(--sp-3); }
+.c3 .rs-slides > .ds-sec { margin-left: 0; }
+.c3 .rs-slide { aspect-ratio: 16 / 9; min-width: 0; display: grid; grid-template-rows: auto 1fr auto; gap: var(--sp-2); padding: var(--sp-3); background: var(--slide-bg); color: var(--slide-fg); border: 1px solid var(--slide-border); border-radius: 6px; font-size: var(--fs-2); overflow: hidden; }
+.c3 .rs-sh { font-weight: 600; font-size: var(--fs-3); color: var(--slide-brand); overflow-wrap: anywhere; }
+.c3 .rs-slide.title { background: var(--slide-brand); color: var(--slide-bg); }
+.c3 .rs-slide.title .rs-sh { color: var(--slide-bg); font-size: var(--fs-4); }
+.c3 .rs-slide .m, .c3 .rs-page .m { color: var(--slide-muted); margin: 0; }
+.c3 .rs-slide.title .m { color: var(--slide-border); }
+.c3 .rs-slide p, .c3 .rs-slide .ds-md { margin: 0; font-size: var(--fs-2); color: inherit; }
+.c3 .rs-slide ul, .c3 .rs-page ul { margin: 0; padding-left: 18px; display: grid; gap: 4px; }
+.c3 .rs-sf { display: flex; justify-content: space-between; font: var(--fs-1) var(--mono); color: var(--slide-foot); }
+.c3 .rs-big { display: flex; gap: var(--sp-3); flex-wrap: wrap; }
+.c3 .rs-big b { display: block; font-size: var(--fs-4); color: var(--slide-primary); }
+.c3 .rs-big span { color: var(--slide-muted); font-size: var(--fs-1); }
+.c3 .rs-sheets { display: grid; gap: var(--sp-3); }
+.c3 .rs-gridwrap { max-width: 100%; overflow-x: auto; border: 1px solid var(--slide-border); border-radius: 6px; background: var(--slide-bg); }
+.c3 .rs-grid { border-collapse: collapse; min-width: 640px; width: 100%; color: var(--slide-fg); font-size: var(--fs-2); }
+.c3 .rs-grid th, .c3 .rs-grid td { border: 1px solid var(--slide-border); padding: 4px 8px; text-align: left; }
+.c3 .rs-grid thead th, .c3 .rs-grid tbody th { background: var(--slide-secondary); color: var(--slide-muted); font: var(--fs-1) var(--mono); text-align: center; }
+.c3 .rs-grid tr.hd td { font-weight: 600; background: var(--slide-track); }
+.c3 .rs-grid td.n { text-align: right; font-family: var(--mono); }
+.c3 .rs-grid td.pos { color: var(--slide-done); }
+.c3 .rs-grid td.neg { color: var(--slide-overdue); }
+.c3 .rs-page { background: var(--slide-bg); color: var(--slide-fg); border: 1px solid var(--slide-border); border-radius: 6px; padding: var(--sp-4); display: grid; gap: var(--sp-2); align-content: start; min-width: 0; font-size: var(--fs-3); }
+.c3 .rs-page h3 { margin: 0; font-size: var(--fs-5); }
+.c3 .rs-page p { margin: 0; }
+.c3 .rs-page .ds-md { color: inherit; }
+.c3 .rs-page .ds-sec-h h3 { color: var(--slide-brand); }
+.c3 .rs-pages { display: grid; gap: var(--sp-3); grid-template-columns: repeat(auto-fit, minmax(min(100%, 280px), 1fr)); }
+.c3 .rs-page.a4 { aspect-ratio: 1 / 1.414; grid-template-rows: auto; align-content: start; position: relative; }
+.c3 .rs-pn { position: absolute; bottom: var(--sp-2); right: var(--sp-3); font: var(--fs-1) var(--mono); color: var(--slide-foot); }
+
+.c3 .rs-min0 { min-width: 0; }
+.c3 .rs-kv .chip2 + .rs-help { margin-left: 6px; }