create-pmos 0.493.0 → 0.495.0

package/workspace/lib/report-pyramid.js

@@ -0,0 +1,535 @@
+'use strict';
+/* report-pyramid.js — the finished slides of a cadence report: the Pyramid deck (canvas RsA + RsD, agreed by Wawan 2026-11-02, option A).
+ *
+ *   readDraft(markdown, extra?)  → the report's parts, read back from the draft's markdown (pure) | null when it is not a cadence draft
+ *   deckOf(markdown, look?, extra?) → { slides: [{ kind, title, …, source, n }], look } | null   (pure; extra.data = the cycle's <slot>.data.json)
+ *   dataOf(absDraftPath)         → the structured cycle's <slot>.data.json next to the draft, or null
+ *   deckHtml(deck)               → one HTML string: a <style> block and one <section class="pmos-slide"> per slide, 1280 x 720 each (pure)
+ *   lookOf(root, cadence)        → the look the slides use: the report's saved design D<n> (lib/report-design.js), else the standard PMOS look
+ *   STANDARD                     → the standard PMOS look
+ *
+ * THE SLIDES, in this order. Every title is a finding: reading only the titles tells the story.
+ *   title       the answer is the title: the first sentence of the PM's headline note (capped, so it fits), else a sentence about who is off plan
+ *   answer      the governing thought, the rest of the headline note's first paragraph, up to three supports (one per initiative, off plan
+ *               first) and the ask beside them
+ *   scorecard   the WBR scorecard: stage, status (shape and colour), done of total (+Δ), the KR now vs target with the gap. A comment
+ *               only on a row that is off plan (off track or at risk); a row on plan is silent. Seven rows per slide.
+ *   timeline    the dated work of the Timeline section, a due-date diamond per initiative and what is overdue, with an action title
+ *               that compares two due dates. Not drawn when nothing has a date (zero is silence).
+ *   ask         Needs your call: only when the definition names an audience AND the asks note has words. Who, by when (only when the
+ *               note says it) and the options (the note's bullet lines). Nothing is invented.
+ *   sources     Sources reached, and "What we don't know yet": each source not reached, with its reason. Read from the script's section, the
+ *               cycle's data file and the agent's "Sources:" paragraph, so the title never says "every source was reached" when one was not.
+ * Not drawn, because the draft does not read them (RsD): KR sparklines, last-quarter bars, forecast ranges.
+ *
+ * WHERE IT IS USED. One model, three outputs: the in-app slide view (GET /api/report-design/pyramid → deckHtml; premium-report-read.js shows
+ * it when the cycle has no designed render), the PDF (the browser prints the same frames, one per page) and the PowerPoint file
+ * (lib/report-export.js pptx draws the same slides with shapes). A cycle drawn to its saved design keeps that render: it is the look.
+ *
+ * THE LOOK. lookOf reads the report's saved design version through report-design.js only (the template's T lines version the same D<n>,
+ * initiative report template A). From its style it takes the first font family and, as the accent, the design's own title or primary colour
+ * (a --primary/--brand variable, else its title slide's or h1's background, then text colour); only when it names none, the most used dark
+ * colour. White text on the accent passes 4.5:1. No saved design: the standard PMOS look (Nunito, navy).
+ */
+
+const STANDARD = Object.freeze({
+  name: 'Standard PMOS look', version: null, font: 'Nunito', accent: '#24304a', ink: '#2b2a27', muted: '#6b655a', soft: '#4a4740',
+  line: '#efeae0', track: '#ece7dc', ground: '#ffffff', ask: '#f7f9fd', on: '#3f8f5f', risk: '#b8730f', off: '#b8403a', today: '#3b6fd4', unknown: '#8a8478',
+});
+
+const MONS = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+const NUM = ['no', 'one', 'two', 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine', 'ten'];
+const LEVELS = { 'Off track': 'off', 'At risk': 'at-risk', Unknown: 'unknown', 'On track': 'on' };
+const WORD = { off: 'off track', 'at-risk': 'at risk', unknown: 'unknown', on: 'on track' };
+const NOTE_RE = /<!-- pmos:note ([a-z0-9][a-z0-9._-]*) -->\n?([\s\S]*?)\n?<!-- \/pmos:note -->/g;
+const SLIDES_RE = /<!-- pmos:slides v1 (\{[\s\S]*?\}) -->/;
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+const ROWS_PER_SLIDE = 7;
+const DAY = 86400000;
+
+const str = (v) => (typeof v === 'string' ? v : '');
+const isObjP = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
+const esc = (s) => String(s == null ? '' : s).replace(/[&<>"']/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[c]));
+const cap = (s) => (s ? s[0].toUpperCase() + s.slice(1) : s);
+const num = (n) => (n >= 0 && n < NUM.length ? NUM[n] : String(n));
+const plain = (s) => str(s).replace(/\*\*([^*]+)\*\*/g, '$1').replace(/`([^`]+)`/g, '$1').replace(/\[([^\]]+)\]\([^)]*\)/g, '$1').trim();
+const ms = (ymd) => Date.parse(ymd + 'T00:00:00Z');
+/** "16 Oct" from YYYY-MM-DD (or the text as it is). */
+const short = (ymd) => { const m = /^(\d{4})-(\d{2})-(\d{2})/.exec(str(ymd)); return m ? `${+m[3]} ${MONS[+m[2] - 1]}` : str(ymd); };
+/** "10 Oct" → YYYY-MM-DD in the year that puts it on or before `today` (the draft writes short dates for carried items). */
+function fromShort(s, today) {
+  const m = /^(\d{1,2}) ([A-Z][a-z]{2})$/.exec(str(s).trim());
+  const k = m ? MONS.indexOf(m[2]) : -1;
+  if (k < 0 || !DATE_RE.test(str(today))) return null;
+  let y = +today.slice(0, 4);
+  const at = (yy) => `${yy}-${String(k + 1).padStart(2, '0')}-${String(+m[1]).padStart(2, '0')}`;
+  if (at(y) > today) y -= 1;
+  return at(y);
+}
+const join = (xs) => (xs.length < 2 ? xs.join('') : xs.slice(0, -1).join(', ') + ' and ' + xs[xs.length - 1]);
+const firstLine = (s) => plain(str(s).split('\n').map((l) => l.trim()).find((l) => l && !/^<!--/.test(l)) || '');
+/** The sentences of one paragraph. A full stop ends a sentence only before a space and a capital, a digit or a quote. */
+const sentences = (p) => str(p).split(/(?<=[.!?])\s+(?=["“'(A-Z0-9])/).map((x) => x.trim()).filter(Boolean);
+/** Cut a text at a word boundary to at most n characters, with an ellipsis when cut. */
+const clip = (t, n) => { const x = str(t).trim(); if (x.length <= n) return x; const c = x.slice(0, n - 1); const i = c.lastIndexOf(' '); return (i > n * 0.6 ? c.slice(0, i) : c).replace(/[\s,;:–—-]+$/, '') + '…'; };
+const TITLE_MAX = 120; const TITLE_FIT = 90; const LEAD_MAX = 320; const ACTION_MAX = 110;
+// the scorecard's rows fit a height: a row with a KR bullet is taller (brief 4 item 4: twelve rows ran into the key and the footer)
+const ROWS_HEIGHT = 340; const rowHeight = (r) => (r.measure && r.measure.target != null ? 80 : 48);
+/** "2 Nov 2026, 22:00 UTC" from an ISO time (or the text as it is). */
+const human = (iso) => { const m = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})/.exec(str(iso)); return m ? `${+m[3]} ${MONS[+m[2] - 1]} ${m[1]}, ${m[4]}:${m[5]} UTC` : str(iso); };
+/** The window's reason in words: the drafter writes "since the last issue" or "report_cycle_days back" (its rule's name). */
+function sinceWords(w) {
+  if (!w || !w.since) return '';
+  if (/report_cycle_days/.test(w.since)) { const d = Math.round((Date.parse(w.to) - Date.parse(w.fromAt || w.from)) / DAY); return Number.isFinite(d) && d > 0 ? `the last ${d} day${d === 1 ? '' : 's'}` : ''; }
+  return w.since.replace(/_/g, ' ');
+}
+/** The sources not reached that the agent named in a note's "Sources:" paragraph: "Not reached: Jira CLDS board (no connector), events list…". */
+function notReachedInNotes(notes) {
+  const out = [];
+  for (const v of Object.values(notes || {})) {
+    for (const para of str(v).split(/\n\s*\n/)) {
+      const t = plain(para.replace(/\s+/g, ' '));
+      if (!/^Sources\b/i.test(t)) continue;
+      const m = /\b(?:not reached|could not (?:be )?(?:read|reach)(?: these)?|unreachable)\b\s*(?:were|was)?\s*[:,-]?\s*([^.]*(?:\([^)]*\)[^.]*)*)/i.exec(t);
+      if (!m) continue;
+      for (const raw of m[1].split(/;\s*|,\s*(?![^()]*\))|\s+and\s+(?![^()]*\))/)) {
+        const x = raw.trim().replace(/^(?:and|the)\s+/i, '');
+        if (!x || /^none\b/i.test(x)) continue;
+        const p = /^(.*?)\s*\(([^)]*)\)\s*$/.exec(x);
+        out.push(p ? { source: p[1].trim(), why: p[2].trim() } : { source: x, why: '' });
+      }
+    }
+  }
+  return out.filter((x) => x.source);
+}
+
+// ── reading the draft back ──────────────────────────────────────────────────────────────────────────
+function frontmatter(md) {
+  const m = /^---\r?\n([\s\S]*?)\r?\n---\r?\n/.exec(md);
+  const out = {};
+  if (!m) return out;
+  for (const l of m[1].split(/\r?\n/)) { const k = /^([a-z_]+):\s*(.*)$/.exec(l); if (k) out[k[1]] = k[2].replace(/^"(.*)"$/, '$1'); }
+  return out;
+}
+function sectionsOf(md) {
+  const out = new Map();
+  let cur = null;
+  for (const l of md.replace(/\r\n?/g, '\n').split('\n')) {
+    const h = /^## (.+)$/.exec(l);
+    if (h) { cur = h[1].trim(); out.set(cur, []); continue; }
+    if (cur) out.get(cur).push(l);
+  }
+  return out;
+}
+const bullets = (lines) => lines.filter((l) => /^- /.test(l)).map((l) => l.slice(2).trim());
+function notesOf(md) { const o = {}; for (const m of md.matchAll(NOTE_RE)) if (!(m[1] in o)) o[m[1]] = m[2].trim(); return o; }
+function progressOf(label) {
+  const m = /^(\d+) of (\d+)(?: \(\+(\d+)\))?/.exec(str(label));
+  return m ? { done: +m[1], total: +m[2], delta: m[3] == null ? null : +m[3], label } : { done: null, total: null, delta: null, label };
+}
+function measureOf(line) {
+  const m = /^Measured: (\S+) (-?\d+(?:\.\d+)?)([^\s,]*)(?: of (-?\d+(?:\.\d+)?)[^\s,]*)?, as of (\S+) \((.+)\)$/.exec(str(line).trim());
+  return m ? { anchor: m[1], value: +m[2], unit: m[3] || '', target: m[4] == null ? null : +m[4], as_of: m[5], source: m[6] } : null;
+}
+function blocksOf(lines, notes, today) {
+  const out = [];
+  let b = null; let part = null;
+  for (const raw of lines) {
+    const l = raw.trim();
+    const h = /^### (.+) \(([^()]+)\)$/.exec(l);
+    if (h) { b = { title: h[1], id: h[2], stage: '', level: 'unknown', reason: '', progress: progressOf(''), measure: null, carried: [], coming: [], note: notes[h[2]] || '' }; out.push(b); part = null; continue; }
+    if (!b) continue;
+    if (/^Stage: /.test(l)) {
+      const bits = l.slice(7).split(' · ');
+      b.stage = bits[0] || '';
+      b.progress = progressOf(bits.length > 2 ? bits[bits.length - 1] : '');
+      const lv = /^(Off track|At risk|Unknown|On track)(?:: (.*))?$/.exec(bits.slice(1, bits.length > 2 ? -1 : undefined).join(' · '));
+      if (lv) { b.level = LEVELS[lv[1]]; b.reason = lv[2] || ''; }
+    } else if (/^Measured: /.test(l)) b.measure = measureOf(l);
+    else if (l === '**Last cycle**') part = 'last';
+    else if (/^\*\*Coming cycle\*\*/.test(l)) part = 'coming';
+    else if (/^- Overdue, carried over: /.test(l) && part === 'last') {
+      const v = l.replace(/^- Overdue, carried over: /, '');
+      if (v !== 'none') for (const x of v.split('; ')) { const m = /^(.*), due (.+)$/.exec(x); if (m) b.carried.push({ title: m[1], due: fromShort(m[2], today), dueText: m[2] }); }
+    } else if (/^- /.test(l) && part === 'coming' && l !== '- none') b.coming.push(l.slice(2));
+  }
+  return out;
+}
+function timelineOf(lines) {
+  const rows = [];
+  let cur = null;
+  for (const l of lines) {
+    if (!/^\|/.test(l) || /^\|\s*-/.test(l) || /^\| Initiative \|/.test(l)) continue;
+    const c = l.slice(1, l.endsWith('|') ? -1 : undefined).split(/(?<!\\)\|/).map((x) => x.trim().replace(/\\\|/g, '|'));
+    if (c[0]) { cur = { title: c[0], spans: [], holds: [] }; rows.push(cur); }
+    if (!cur) continue;
+    if (/^On hold/.test(c[1])) { if (DATE_RE.test(c[2])) cur.holds.push({ from: c[2], to: DATE_RE.test(c[3]) ? c[3] : null }); continue; }
+    if (c[1] === 'No activity') continue;
+    const start = DATE_RE.test(c[2]) ? c[2] : null; const due = DATE_RE.test(c[3]) ? c[3] : null;
+    if (start || due) cur.spans.push({ stage: c[1] === '-' ? '' : c[1], start: start || due, due: due || start });
+  }
+  return rows.filter((r) => r.spans.length);
+}
+
+/** The parts of a cadence draft (lib/report-draft.js render), or null when the markdown is not one. */
+function readDraft(markdown, extra) {
+  const md = str(markdown);
+  const cycleData = extra && isObjP(extra.data) ? extra.data : null;
+  const S = sectionsOf(md);
+  if (!S.has('Headline') || !S.has('Initiatives') || !S.has('Sources reached and not reached')) return null;   // the drafter's frame (report-draft.js render)
+  const fm = frontmatter(md);
+  const notes = notesOf(md);
+  let data = null;
+  const sj = SLIDES_RE.exec(md);
+  if (sj) { try { data = JSON.parse(sj[1]); } catch { data = null; } }
+  const win = /^(\S+) to (\S+)(?: \((.+)\))?$/.exec(str(fm.window));
+  const slot = DATE_RE.test(str(fm.slot)) ? fm.slot : null;
+  const today = (data && data.meta && DATE_RE.test(str(data.meta.today)) && data.meta.today) || slot || (win ? win[2].slice(0, 10) : null);
+  const head = (S.get('Headline') || []).map((l) => l.trim()).find((l) => l && !/^<!--/.test(l)) || '';
+  const h1 = /^# (.+)$/m.exec(md);
+  const needs = S.get('Needs your call') || [];
+  const aud = needs.map((l) => /^For (.+) only\.$/.exec(l.trim())).find(Boolean);
+  const src = S.get('Sources reached and not reached') || [];
+  const at = src.findIndex((l) => l.trim() === '**Not reached**');
+  const reached = bullets(at < 0 ? src : src.slice(0, at)).filter((x) => x !== 'none');
+  const notReached = (at < 0 ? [] : bullets(src.slice(at))).filter((x) => x !== 'none').map((x) => { const i = x.indexOf(': '); return i < 0 ? { source: x, why: '' } : { source: x.slice(0, i), why: x.slice(i + 2) }; });
+  // a structured report's sources live in its <slot>.data.json and in the agent's "Sources:" paragraph, not in the script's section (brief 4 item 6)
+  const seen = new Set(notReached.map((x) => x.source.toLowerCase()));
+  const more = (cycleData && Array.isArray(cycleData.sources) ? cycleData.sources : []).filter((x) => x && x.reached === false && str(x.id || x.name)).map((x) => ({ source: str(x.name || x.id), why: str(x.reason) }))
+    .concat(notReachedInNotes(notes));
+  for (const x of more) { const k = x.source.toLowerCase(); if (!seen.has(k)) { seen.add(k); notReached.push(x); } }
+  for (const x of cycleData && Array.isArray(cycleData.sources) ? cycleData.sources : []) {
+    const k = str(x && (x.name || x.id));
+    if (x && x.reached === true && k && !reached.some((r) => r.toLowerCase() === k.toLowerCase())) reached.push(k);
+  }
+  const product = data && data.meta ? str(data.meta.product) : '';
+  return {
+    title: (h1 ? h1[1] : str(fm.title)).trim(), name: (h1 ? h1[1] : str(fm.title)).replace(/\s+\d{4}-\d{2}-\d{2}$/, '').trim(),
+    cadence: str(fm.cadence), slot, product, today,
+    window: win ? { from: win[1].slice(0, 10), fromAt: win[1], to: win[2], since: win[3] || '' } : null,
+    headline: head, headlineNote: firstLine(notes['report.headline']),
+    blocks: blocksOf(S.get('Initiatives'), notes, today),
+    timeline: timelineOf(S.get('Timeline') || []),
+    milestones: data && Array.isArray(data.initiatives) ? data.initiatives.filter((x) => x && x.next_milestone).map((x) => ({ id: x.id, title: x.title, ...x.next_milestone })) : [],
+    audience: aud ? aud[1] : null, asks: aud ? str(notes['report.asks']).trim() : '',
+    reached, notReached,
+  };
+}
+
+// ── the deck ────────────────────────────────────────────────────────────────────────────────────────
+const offPlan = (b) => b.level === 'off' || b.level === 'at-risk';
+const worstWord = (bs) => (bs.some((b) => b.level === 'off') ? 'off track' : 'at risk');
+const kr = (m) => (m ? `${m.anchor} is at ${fmt(m.value)}${m.unit} of its ${fmt(m.target)}${m.unit} target` : '');
+const fmt = (v) => (v == null ? '' : String(Math.round(v * 100) / 100));
+const gapOf = (m) => (m && m.target != null ? Math.round((m.value - m.target) * 100) / 100 : null);
+const gapText = (m) => { const g = gapOf(m); if (g == null) return ''; const u = m.unit === '%' ? ' pts' : m.unit; return (g > 0 ? '+' : g < 0 ? '−' : '±') + fmt(Math.abs(g)) + u; };
+
+/** The short answer: who is off plan, in one sentence. */
+function shortAnswer(d) {
+  const n = d.blocks.length; const off = d.blocks.filter(offPlan);
+  if (!n) return 'No initiative was active in this window';
+  if (!off.length) return n === 1 ? `${d.blocks[0].title} is on plan` : `All ${num(n)} initiatives are on plan`;
+  if (off.length === 1) return `${cap(num(1))} initiative is ${worstWord(off)}: ${off[0].title}`;
+  return `${cap(num(off.length))} of ${num(n)} initiatives are off plan: ${join(off.map((b) => b.title))}`;
+}
+/** The governing thought: the short answer with the worst initiative's progress and KR. */
+function longAnswer(d) {
+  const n = d.blocks.length; const off = d.blocks.filter(offPlan);
+  if (!off.length) return shortAnswer(d);
+  const w = off[0];
+  const facts = [w.progress.total ? `${w.title} is ${w.progress.done} of ${w.progress.total} done` : '', w.measure && w.measure.target != null ? kr(w.measure) : ''].filter(Boolean);
+  const lead = off.length === 1 ? `${cap(num(1))} of ${num(n)} initiatives is ${worstWord(off)}` : `${cap(num(off.length))} of ${num(n)} initiatives are off plan`;
+  return facts.length ? `${lead}: ${facts.join(', and ')}` : `${lead}: ${join(off.map((b) => b.title))}`;
+}
+function supportOf(b) {
+  const head = `${b.title} is ${WORD[b.level]}`;
+  const p = b.progress;
+  const prog = p.total ? `${p.done} of ${p.total} done${p.delta ? `, ${p.delta} more than last report` : ''}.` : '';
+  const why = offPlan(b) ? [b.reason ? cap(b.reason) + '.' : '', b.carried.length ? `${b.carried[0].title} was due ${b.carried[0].dueText}.` : ''].filter(Boolean).join(' ') : '';
+  return { head, text: why || firstLine(b.note) || prog || cap(b.stage) };
+}
+function askOf(d) {
+  if (!d.audience || !d.asks) return null;
+  const lines = d.asks.split('\n').map((l) => l.trim()).filter((l) => l && !/^<!--/.test(l));
+  const opts = lines.filter((l) => /^([-*]|\d+[.)])\s+/.test(l)).map((l) => plain(l.replace(/^([-*]|\d+[.)])\s+/, ''))).slice(0, 3);
+  const rest = lines.filter((l) => !/^([-*]|\d+[.)])\s+/.test(l)).map(plain);
+  const by = /\bby (\d{1,2} [A-Z][a-z]{2}(?: \d{4})?|\d{4}-\d{2}-\d{2})/i.exec(d.asks);
+  return { question: rest[0] || opts[0] || '', more: rest.slice(1).join(' '), options: rest[0] ? opts : opts.slice(1), who: d.audience, by: by ? (DATE_RE.test(by[1]) ? short(by[1]) : by[1]) : null };
+}
+function timelineTitle(rows, overdue) {
+  const dated = rows.map((r) => ({ title: r.title, due: r.spans.reduce((a, s) => (s.due > a ? s.due : a), '') })).filter((r) => r.due).sort((a, b) => (a.due < b.due ? -1 : a.due > b.due ? 1 : 0));
+  let t = '';
+  if (dated.length >= 2) {
+    const last = dated[dated.length - 1]; const prev = dated[dated.length - 2];
+    const days = Math.round((ms(last.due) - ms(prev.due)) / DAY);
+    t = days ? `${last.title} lands ${short(last.due)}, ${num(days)} day${days === 1 ? '' : 's'} after ${prev.title}` : `${last.title} and ${prev.title} both land ${short(last.due)}`;
+  } else if (dated.length === 1) t = `${dated[0].title} is due ${short(dated[0].due)}`;
+  if (overdue.length) t += `${t ? ', with ' : ''}${overdue[0].title} already overdue`;
+  return cap(t);
+}
+
+/** The scorecard's action title: the verdict in one line (brief 4 item 4). The long form names who is on track too; when it would not fit on one
+ * line it is "3 of 12 off plan: X, Y and Z", with at most three names ("… and 2 more"). */
+function scorecardTitle(blocks, off, on) {
+  const n = blocks.length;
+  if (!n) return 'No initiative was active in this window';
+  if (!off.length) return n === 1 ? `${blocks[0].title} is on plan and needs no comment` : `All ${num(n)} initiatives are on plan; no row needs a comment`;
+  const long = `${off.length === 1 ? `Only ${off[0].title} is` : `${join(off.map((b) => b.title))} are`} off plan${on.length ? `; ${join(on.map((b) => b.title))} ${on.length === 1 ? 'is' : 'are'} on track and need${on.length === 1 ? 's' : ''} no comment` : ''}`;
+  if (long.length <= ACTION_MAX) return long;
+  const names = off.slice(0, 3).map((b) => b.title).concat(off.length > 3 ? [`${off.length - 3} more`] : []);
+  const short1 = `${off.length} of ${n} off plan: ${join(names)}`;
+  return short1.length <= ACTION_MAX ? short1 : `${off.length} of ${n} initiatives are off plan`;
+}
+/** The Pyramid deck of a cadence draft, or null when the markdown is not one. */
+function deckOf(markdown, look, extra) {
+  const d = readDraft(markdown, extra);
+  if (!d) return null;
+  const L = { ...STANDARD, ...(look || {}) };
+  const slides = [];
+  const frozen = d.window ? `Frozen ${human(d.window.to)}` : '';
+  // the title is the answer: the first sentence of the PM's headline note; the rest of that paragraph opens the Answer slide (brief 4 item 3)
+  const said = sentences(d.headlineNote);
+  // a long first sentence keeps its first clause as the title; the clause after it opens the lead, so nothing the PM wrote is lost
+  const cut = said[0] && said[0].length > TITLE_FIT ? /^(.{30,}?)(?:,| —| –|;)\s+(?:because |as |so |which |while |but )?(.+)$/.exec(said[0]) : null;
+  const head = cut && cut[1].length <= TITLE_FIT ? cut[1].replace(/[,;]$/, '') + '.' : said[0];
+  const rest = (cut && cut[1].length <= TITLE_FIT ? [cap(cut[2])] : []).concat(said.slice(1));
+  const titleText = clip(head || shortAnswer(d), TITLE_MAX);
+  const lead = rest.length ? clip(rest.join(' '), LEAD_MAX) : '';
+  const since = sinceWords(d.window);
+  const measures = d.blocks.filter((b) => b.measure);
+  const krSrc = [...new Set(measures.map((b) => `${b.measure.anchor} as of ${short(b.measure.as_of)} (${b.measure.source})`))];
+  const ask = askOf(d);
+
+  slides.push({
+    kind: 'title', tag: [d.name ? (/\breport$/i.test(d.name) ? d.name : `${d.name} report`) : 'Report', d.product].filter(Boolean).join(' · '),
+    title: titleText, size: titleText.length > 60 ? 48 : 64,
+    sub: [d.slot ? short(d.slot) + ' ' + d.slot.slice(0, 4) : '', d.window ? `window ${short(d.window.from)} to ${short(d.window.to)}${since ? ', ' + since : ''}` : ''].filter(Boolean).join(' · '),
+    source: frozen,
+  });
+  const order = d.blocks.filter(offPlan).concat(d.blocks.filter((b) => !offPlan(b)));
+  slides.push({
+    kind: 'answer', tag: 'The answer', title: clip(longAnswer(d), TITLE_MAX), lead, supports: order.slice(0, 3).map(supportOf), ask,
+    source: ['Source: Headline, initiative blocks', ...krSrc, ask ? 'Needs your call note' : ''].filter(Boolean).join(' · '),
+  });
+
+  const off = d.blocks.filter(offPlan); const on = d.blocks.filter((b) => b.level === 'on');
+  const scTitle = scorecardTitle(d.blocks, off, on);
+  const anchor = measures.length && measures.every((b) => b.measure.anchor === measures[0].measure.anchor) ? measures[0].measure.anchor : 'KR';
+  const rows = order.map((b) => ({
+    title: b.title, stage: b.stage, level: b.level, progress: b.progress, measure: b.measure, gap: gapText(b.measure),
+    comment: offPlan(b) ? [b.reason ? cap(b.reason) + '.' : '', firstLine(b.note)].filter(Boolean).join(' ') : '',
+  }));
+  const pages = [[]]; let used = 0;
+  for (const r of rows) {
+    const h = rowHeight(r);
+    if (pages[pages.length - 1].length && (used + h > ROWS_HEIGHT || pages[pages.length - 1].length >= ROWS_PER_SLIDE)) { pages.push([]); used = 0; }
+    pages[pages.length - 1].push(r); used += h;
+  }
+  pages.forEach((pg, i) => {
+    slides.push({ kind: 'scorecard', title: i ? clip(scTitle, ACTION_MAX - 12) + ' (continued)' : scTitle, rows: pg, kr: measures.length ? anchor : null,
+      source: ['Source: initiative blocks', ...krSrc].join(' · ') });
+  });
+
+  const overdue = d.blocks.flatMap((b) => b.carried.filter((c) => c.due).map((c) => ({ ...c, initiative: b.title })));
+  // an initiative with an overdue item but no dated span still gets its row: the overdue mark is the finding
+  const tl = d.timeline.concat(d.blocks.filter((b) => !d.timeline.some((r) => r.title === b.title) && b.carried.some((c) => c.due)).map((b) => ({ title: b.title, spans: [], holds: [] })));
+  if (tl.length) {
+    const ids = new Map(d.blocks.map((b) => [b.title, b.id]));
+    // the title speaks only of the rows the chart draws (brief 4 item 5)
+    const shown = tl.slice(0, 6);
+    const shownOverdue = overdue.filter((o) => shown.some((r) => r.title === o.initiative));
+    const days = shown.flatMap((r) => r.spans.flatMap((s) => [s.start, s.due])).concat(shownOverdue.map((o) => o.due), d.today ? [d.today] : []).filter(Boolean).sort();
+    slides.push({
+      kind: 'timeline', title: clip(timelineTitle(shown, shownOverdue), ACTION_MAX + 20), from: days[0], to: days[days.length - 1], today: d.today,
+      rows: shown.map((r) => ({ title: r.title, spans: r.spans, holds: r.holds, milestone: d.milestones.find((m) => m.id === ids.get(r.title) || m.title === r.title) || null,
+        overdue: overdue.filter((o) => o.initiative === r.title) })),
+      source: `Source: dated work items (Timeline section)${d.window ? ', frozen ' + short(d.window.to) : ''}`,
+    });
+  }
+  if (ask && ask.question) {
+    slides.push({ kind: 'ask', tag: 'Needs your call', title: ask.by && !/\bby\b/i.test(ask.question) ? `Decide by ${ask.by}: ${ask.question.replace(/\?$/, '')}` : ask.question, ask,
+      source: `Source: Needs your call note · for ${d.audience} only` });
+  }
+  const nr = d.notReached;
+  slides.push({
+    kind: 'sources',
+    title: clip(`Every number comes from ${num(d.reached.length)} source${d.reached.length === 1 ? '' : 's'}${nr.length ? `; ${nr.length > 3 ? `${num(nr.length)} sources` : join(nr.map((x) => x.source))} could not be read, so what ${nr.length === 1 ? 'it holds is' : 'they hold is'} not in this report` : '; every source was reached'}`, TITLE_MAX + 40),
+    reached: d.reached, notReached: nr, source: 'Source: Sources reached and not reached',
+  });
+  slides.forEach((s, i) => { s.n = i + 1; });
+  return { slides, look: L, name: d.title };
+}
+
+// ── the slides as HTML (1280 x 720 frames) ──────────────────────────────────────────────────────────
+const SHAPE = {
+  on: (c) => `<svg width="16" height="16" viewBox="0 0 12 12" role="img" aria-label="On track"><circle cx="6" cy="6" r="5" fill="${c.on}"/></svg>`,
+  'at-risk': (c) => `<svg width="16" height="16" viewBox="0 0 12 12" role="img" aria-label="At risk"><path d="M6 1 L11.2 10.5 H0.8 Z" fill="${c.risk}"/></svg>`,
+  off: (c) => `<svg width="16" height="16" viewBox="0 0 12 12" role="img" aria-label="Off track"><rect x="1" y="1" width="10" height="10" rx="1.5" fill="${c.off}"/></svg>`,
+  unknown: (c) => `<svg width="16" height="16" viewBox="0 0 12 12" role="img" aria-label="Unknown"><circle cx="6" cy="6" r="4.3" fill="none" stroke="${c.unknown}" stroke-width="1.6"/></svg>`,
+};
+function css(L) {
+  const f = `'${String(L.font).replace(/[^A-Za-z0-9 -]/g, '')}', Nunito, system-ui, sans-serif`;
+  return `.pmos-slide.py{width:1280px;height:720px;box-sizing:border-box;background:${L.ground};color:${L.ink};font-family:${f};position:relative;overflow:hidden;display:flex;flex-direction:column}
+.py *{box-sizing:border-box}
+.py.py-navy{background:${L.accent};color:#fff}
+.py .in{flex:1;padding:48px 67px 0;display:flex;flex-direction:column;min-height:0}
+.py .ft{height:48px;padding:0 67px;display:flex;align-items:center;gap:19px;font-size:15px;color:#8a8478;border-top:1px solid ${L.line}}
+.py .ft .s{flex:1;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.py.py-navy .ft{border-top-color:rgba(255,255,255,.14);color:#c9d3ea}
+.py .tag{font-weight:700;font-size:15px;line-height:1;letter-spacing:1.9px;text-transform:uppercase;color:${L.muted}}
+.py .ti{font-size:35px;line-height:1.22;font-weight:800;letter-spacing:-.3px;margin:13px 0 10px;max-width:1120px}
+.py .rule{height:3px;width:90px;background:${L.accent};margin:16px 0 26px}
+.py .sm{font-size:18px;color:${L.soft};line-height:1.45}
+.py .sup{display:flex;gap:19px;align-items:flex-start;padding:16px 0;border-top:1px solid ${L.line}}
+.py .sup:first-child{border-top:0}
+.py .sup .n{width:35px;height:35px;border-radius:50%;background:${L.accent};color:#fff;font-size:18px;font-weight:800;display:inline-flex;align-items:center;justify-content:center;flex:none}
+.py .sup b{display:block;font-size:22px;line-height:1.3}.py .sup span{font-size:18px;color:${L.soft}}
+.py .ask{border:3px solid ${L.accent};border-radius:16px;padding:22px 26px;background:${L.ask}}
+.py .ask.alt{border-color:#cfc8ba;background:#fff}
+.py .ask .q{font-size:22px;font-weight:800;line-height:1.3;margin:10px 0}
+.py .tb{display:grid;font-size:17px;align-items:center}
+.py .tb>div{padding:12px 10px;border-bottom:1px solid ${L.line};min-width:0}
+.py .tb .h{font-weight:800;font-size:15px;letter-spacing:1.2px;text-transform:uppercase;color:${L.muted};border-bottom:3px solid #d3ccbf}
+.py .key{display:flex;gap:29px;margin-top:22px;font-size:16px;color:${L.muted};align-items:center}
+.py .key span{display:inline-flex;gap:8px;align-items:center}
+.py .gap-neg{color:${L.off};font-weight:800}.py .gap-pos{color:${L.on};font-weight:800}.py .up{color:${L.on}}
+.py .cols{display:flex;gap:48px}.py .cols>div{flex:1;min-width:0}
+.py .miss b{display:block;font-size:21px}.py .miss .tag{color:${L.off}}`;
+}
+function footer(s) { return `<div class="ft"><span class="s">${esc(s.source)}</span><span>${s.n}</span></div>`; }
+function bar(done, total, L) {
+  const w = total ? Math.round((154 * done) / total * 10) / 10 : 0;
+  return `<svg width="154" height="22" viewBox="0 0 154 22" role="img" aria-label="${done} of ${total} done"><rect x="0" y="5" width="154" height="13" rx="6.5" fill="${L.track}"/><rect x="0" y="5" width="${w}" height="13" rx="6.5" fill="${L.accent}"/></svg>`;
+}
+function bullet(m, L) {
+  if (!m || m.target == null) return m ? `<b>${esc(fmt(m.value) + m.unit)}</b>` : '';
+  const max = Math.max(m.value, m.target, 1) * (m.unit === '%' && Math.max(m.value, m.target) <= 100 ? 100 / Math.max(m.value, m.target, 1) : 1.25);
+  const x = (v) => Math.round((240 * Math.max(0, v)) / max * 10) / 10;
+  const g = gapOf(m);
+  return `<svg width="240" height="34" viewBox="0 0 240 34" role="img" aria-label="${esc(`${fmt(m.value)}${m.unit} against a target of ${fmt(m.target)}${m.unit}`)}"><rect x="0" y="13" width="240" height="10" rx="5" fill="${L.track}"/><rect x="0" y="10" width="${x(m.value)}" height="16" rx="3" fill="${L.accent}"/><rect x="${Math.min(x(m.target), 236)}" y="3" width="4" height="29" fill="none" stroke="${L.ink}" stroke-width="2.2"/></svg>`
+    + `<div style="font-size:15px;margin-top:-2px"><b>${esc(fmt(m.value) + m.unit)}</b> of ${esc(fmt(m.target) + m.unit)}${g ? ` · <span class="${g < 0 ? 'gap-neg' : 'gap-pos'}">${esc(gapText(m))}</span>` : ''}</div>`;
+}
+function timelineSvg(s, L) {
+  const W = 1146; const left = 240; const right = W - 110; const from = ms(s.from); const to = Math.max(ms(s.to), from + DAY);
+  const x = (d) => Math.round((left + ((ms(d) - from) / (to - from)) * (right - left)) * 10) / 10;
+  const rowH = 70; const top = 44; const H = top + s.rows.length * rowH + 30;
+  const out = [];
+  const step = Math.max(1, Math.ceil((to - from) / DAY / 6));
+  for (let t = from; t <= to; t += step * DAY) { const d = new Date(t).toISOString().slice(0, 10); out.push(`<line x1="${x(d)}" y1="${top - 8}" x2="${x(d)}" y2="${H - 22}" stroke="${L.line}"/><text x="${x(d)}" y="22" font-size="15" fill="#8a8478" text-anchor="middle">${esc(short(d))}</text>`); }
+  s.rows.forEach((r, i) => {
+    const y = top + i * rowH;
+    out.push(`<text x="0" y="${y + 22}" font-size="18" font-weight="800" fill="${L.ink}">${esc(r.title.length > 24 ? r.title.slice(0, 23) + '…' : r.title)}</text>`);
+    for (const h of r.holds) out.push(`<rect x="${x(h.from)}" y="${y + 6}" width="${Math.max(4, x(h.to || s.to) - x(h.from))}" height="32" rx="6" fill="${L.track}"/>`);
+    for (const sp of r.spans) {
+      const w = Math.max(6, x(sp.due) - x(sp.start));
+      out.push(`<rect x="${x(sp.start)}" y="${y + 6}" width="${w}" height="32" rx="6" fill="${L.accent}"/>`);
+      if (sp.stage && w > 60) out.push(`<text x="${x(sp.start) + 11}" y="${y + 28}" font-size="16" fill="#fff" font-weight="700">${esc(sp.stage)}</text>`);
+    }
+    const due = r.spans.reduce((a, sp) => (sp.due > a ? sp.due : a), '');
+    const m = r.milestone && DATE_RE.test(str(r.milestone.due)) ? r.milestone.due : due;
+    if (m) out.push(`<path d="M${x(m) + 13} 0 l10 10 l-10 10 l-10 -10 z" transform="translate(0 ${y + 12})" fill="none" stroke="${L.ink}" stroke-width="2.6"/><text x="${x(m) + 30}" y="${y + 28}" font-size="16" fill="${L.muted}" font-weight="700">${esc(short(m))}</text>`);
+    r.overdue.slice(0, 1).forEach((o) => out.push(`<rect x="${x(o.due) - 7}" y="${y + 46}" width="14" height="14" rx="2.5" fill="${L.off}"/><text x="${x(o.due) + 14}" y="${y + 58}" font-size="16" fill="${L.off}" font-weight="700">${esc(`${o.title}, due ${short(o.due)}, overdue`)}</text>`));
+  });
+  if (s.today) out.push(`<line x1="${x(s.today)}" y1="${top - 12}" x2="${x(s.today)}" y2="${H - 22}" stroke="${L.today}" stroke-width="2.4" stroke-dasharray="6 5"/><text x="${x(s.today)}" y="${H - 4}" font-size="15" fill="${L.today}" font-weight="800" text-anchor="middle">Today</text>`);
+  return `<svg width="${W}" height="${H}" viewBox="0 0 ${W} ${H}" role="img" aria-label="${esc(`Timeline, ${short(s.from)} to ${short(s.to)}${s.today ? ', today is ' + short(s.today) : ''}`)}" style="display:block;font-family:inherit">${out.join('')}</svg>`;
+}
+function slideHtml(s, L) {
+  const open = (cls) => `<section class="pmos-slide py${cls ? ' ' + cls : ''}" data-title="${esc(s.title)}" data-kind="${s.kind}">`;
+  if (s.kind === 'title') {
+    return open('py-navy') + `<div class="in" style="justify-content:flex-end;padding-bottom:54px"><div class="tag" style="color:#c9d3ea">${esc(s.tag)}</div>`
+      + `<div style="font-size:${s.size || 64}px;font-weight:800;line-height:1.1;margin:16px 0;max-width:1100px">${esc(s.title)}</div><div style="font-size:22px;color:#dde4f3;max-width:900px;line-height:1.5">${esc(s.sub)}</div></div>${footer(s)}</section>`;
+  }
+  const head = (tag) => `${tag ? `<div class="tag">${esc(tag)}</div>` : ''}<h3 class="ti">${esc(s.title)}</h3><div class="rule"></div>`;
+  let body = '';
+  if (s.kind === 'answer') {
+    const sup = s.supports.map((x, i) => `<div class="sup"><span class="n">${i + 1}</span><div><b>${esc(x.head)}</b><span>${esc(x.text)}</span></div></div>`).join('');
+    const ask = s.ask && s.ask.question ? `<div style="flex:1"><div class="ask"><div class="tag" style="color:${L.accent}">Your call</div><div class="q">${esc(s.ask.question)}</div><div class="sm">For ${esc(s.ask.who)}${s.ask.by ? ` · by ${esc(s.ask.by)}` : ''}</div></div></div>` : '';
+    body = (s.lead ? `<p class="sm" style="margin:-8px 0 14px;max-width:1120px">${esc(s.lead)}</p>` : '') + `<div style="display:flex;gap:42px;flex:1;min-height:0"><div style="flex:1.45">${sup}</div>${ask}</div>`;
+  } else if (s.kind === 'scorecard') {
+    const cols = s.kr ? '220px 120px 80px 230px 270px 1fr' : '260px 140px 90px 260px 1fr';
+    const hd = ['Initiative', 'Stage', 'Status', 'Done of total'].concat(s.kr ? [`${s.kr} · now vs target`] : [], ['Why, what we do']);
+    const cells = s.rows.map((r) => [`<div style="font-weight:800">${esc(r.title)}</div>`, `<div>${esc(r.stage)}</div>`, `<div>${(SHAPE[r.level] || SHAPE.unknown)(L)}</div>`,
+      `<div style="display:flex;align-items:center;gap:12px">${r.progress.total ? `${bar(r.progress.done, r.progress.total, L)}<span style="white-space:nowrap"><b>${r.progress.done} of ${r.progress.total}</b>${r.progress.delta ? ` <span class="up">+${r.progress.delta}</span>` : ''}</span>` : `<span class="sm">${esc(r.progress.label || 'no breakdown')}</span>`}</div>`]
+      .concat(s.kr ? [`<div>${bullet(r.measure, L)}</div>`] : [], [`<div class="sm">${esc(r.comment)}</div>`]).join('')).join('');
+    const key = `<div class="key"><span>${SHAPE.on(L)} on track</span><span>${SHAPE['at-risk'](L)} at risk</span><span>${SHAPE.off(L)} off track</span>${s.kr ? `<span><svg width="42" height="13" aria-hidden="true"><rect y="1" width="42" height="10" rx="3" fill="${L.accent}"/></svg> now</span><span><svg width="13" height="19" aria-hidden="true"><rect x="2" y="2" width="5" height="15" fill="none" stroke="${L.ink}" stroke-width="2.2"/></svg> target</span><span>Gap is now minus target</span>` : ''}</div>`;
+    body = `<div class="tb" style="grid-template-columns:${cols}">${hd.map((h) => `<div class="h">${esc(h)}</div>`).join('')}${cells}</div>${key}`;
+  } else if (s.kind === 'timeline') {
+    body = timelineSvg(s, L) + `<div class="key"><span><svg width="42" height="13" aria-hidden="true"><rect width="42" height="13" rx="3" fill="${L.accent}"/></svg> work with dates</span><span><svg width="19" height="19" aria-hidden="true"><path d="M9.5 2 l7.5 7.5 l-7.5 7.5 l-7.5 -7.5 z" fill="none" stroke="${L.ink}" stroke-width="2.6"/></svg> due date</span><span><svg width="16" height="16" aria-hidden="true"><rect width="14" height="14" rx="2.5" fill="${L.off}"/></svg> overdue</span></div>`;
+  } else if (s.kind === 'ask') {
+    const a = s.ask;
+    const opts = a.options.map((o, i) => `<div class="ask${i ? ' alt' : ''}" style="flex:1"><div class="tag">Option ${'ABC'[i]}</div><div class="q">${esc(o)}</div></div>`).join('');
+    body = (opts ? `<div style="display:flex;gap:26px">${opts}</div>` : '') + (a.more ? `<p class="sm" style="margin:${opts ? '22px' : '0'} 0 0">${esc(a.more)}</p>` : '')
+      + `<div class="sm" style="display:flex;gap:45px;margin-top:29px"><span><b>Who</b> ${esc(a.who)}</span>${a.by ? `<span><b>By</b> ${esc(a.by)}</span>` : ''}</div>`;
+  } else if (s.kind === 'sources') {
+    const reached = s.reached.map((x) => `<div class="sup"><span class="sm">${esc(x)}</span></div>`).join('') || '<div class="sup"><span class="sm">None</span></div>';
+    const miss = s.notReached.map((x) => `<div class="sup"><div><b>${esc(x.source)}</b><span>${esc(cap(x.why))}${x.why ? '.' : ''}</span></div></div>`).join('');
+    body = `<div class="cols"><div><div class="tag">Reached</div>${reached}</div>${miss ? `<div class="miss"><div class="tag">What we don’t know yet</div>${miss}</div>` : ''}</div>`;
+  }
+  return open('') + `<div class="in">${head(s.tag)}${body}</div>${footer(s)}</section>`;
+}
+/** The deck as one HTML string (the viewer's frames and the PDF print). */
+function deckHtml(deck) {
+  if (!deck) return '';
+  const L = { ...STANDARD, ...(deck.look || {}) };
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8"><title>${esc(deck.name)}</title><style>${css(L)}</style></head><body>${deck.slides.map((s) => slideHtml(s, L)).join('')}</body></html>`;
+}
+
+// ── the look ────────────────────────────────────────────────────────────────────────────────────────
+function lum(hex) {
+  const h = hex.length === 4 ? hex.slice(1).split('').map((c) => c + c).join('') : hex.slice(1);
+  const ch = [0, 2, 4].map((i) => parseInt(h.slice(i, i + 2), 16) / 255).map((v) => (v <= 0.03928 ? v / 12.92 : ((v + 0.055) / 1.055) ** 2.4));
+  return 0.2126 * ch[0] + 0.7152 * ch[1] + 0.0722 * ch[2];
+}
+const hex6 = (k) => (k.length === 4 ? '#' + k.slice(1).split('').map((c) => c + c).join('') : k).toLowerCase();
+/** A colour white text can sit on (4.5:1) that is a colour, not a grey. */
+function isAccent(k) { const h = hex6(k).slice(1); const v = [0, 2, 4].map((i) => parseInt(h.slice(i, i + 2), 16)); return lum(hex6(k)) <= 0.18 && Math.max(...v) - Math.min(...v) >= 16; }
+const TITLE_SEL = /data-(?:kind|slide-id)\s*=\s*["']?title\b|\.(?:title|cover|hero)(?:-slide)?\b|(?:^|[\s,>])h1\b/i;
+const PRIMARY_VAR = /--(?:primary|brand|accent|title|main|navy|heading)[\w-]*\s*:\s*(#[0-9a-f]{6}|#[0-9a-f]{3})\b/gi;
+/** The colour a design names as its own: a --primary/--brand/--accent/--title variable, else the background (then the text colour) of its title
+ * slide or main heading. Only a colour that passes isAccent. */
+function primaryOf(t) {
+  for (const m of t.matchAll(PRIMARY_VAR)) if (isAccent(m[1])) return hex6(m[1]);
+  const rules = [...t.matchAll(/([^{}]+)\{([^{}]*)\}/g)].filter((m) => TITLE_SEL.test(m[1]));
+  for (const prop of [/(?:^|;)\s*background(?:-color)?\s*:[^;]*?(#[0-9a-f]{6}|#[0-9a-f]{3})\b/i, /(?:^|;)\s*color\s*:\s*(#[0-9a-f]{6}|#[0-9a-f]{3})\b/i]) {
+    for (const r of rules) { const c = prop.exec(r[2]); if (c && isAccent(c[1])) return hex6(c[1]); }
+  }
+  return null;
+}
+/** The font and accent a saved design's style uses, or null. Pure: css = the render's style text. */
+function lookFromCss(cssText) {
+  const t = str(cssText);
+  if (!t) return null;
+  const fm = /font-family\s*:\s*([^;}]+)/i.exec(t);
+  const font = fm ? fm[1].split(',')[0].trim().replace(/^['"]|['"]$/g, '').replace(/[^A-Za-z0-9 -]/g, '').slice(0, 60) : '';
+  const count = new Map();
+  for (const m of t.matchAll(/#([0-9a-f]{6}|[0-9a-f]{3})\b/gi)) { const k = '#' + m[1].toLowerCase(); count.set(k, (count.get(k) || 0) + 1); }
+  const dark = [...count.entries()].filter(([k]) => isAccent(k)).sort((a, b) => b[1] - a[1] || (a[0] < b[0] ? -1 : 1));
+  const out = {};
+  if (font && !/^(inherit|initial|var)/i.test(font)) out.font = font;
+  // the look's own title or primary colour first (live check of D3: navy #1f4e79, not the most used slate); the most used dark colour after it
+  const named = primaryOf(t);
+  if (named) out.accent = named;
+  else if (dark.length) out.accent = dark[0][0];
+  return Object.keys(out).length ? out : null;
+}
+/** The look of a report: its saved design D<n> (read through report-design.js), else the standard PMOS look. Never throws. */
+function lookOf(root, cadence) {
+  try {
+    const D = require('./report-design.js');
+    const st = D.stateOf(root, cadence);
+    if (!st.saved) return { ...STANDARD };
+    const n = st.saved.version;
+    const html = D.versionHtml(root, cadence, n);
+    const styles = [...str(html).matchAll(/<style[^>]*>([\s\S]*?)<\/style>/gi)].map((m) => m[1])
+      // the title slide's own inline style counts as a title rule
+      .concat([...str(html).matchAll(/<section\b[^>]*data-(?:kind|slide-id)="title"[^>]*\bstyle="([^"]*)"/gi)].map((m) => `[data-kind=title]{${m[1]}}`)).join('\n');
+    return { ...STANDARD, ...(lookFromCss(styles) || {}), name: `Look D${n}`, version: n };
+  } catch { return { ...STANDARD }; }
+}
+
+/** The cycle's numbers next to a structured draft (<slot>.data.json), or null. abs = the draft's absolute path. */
+function dataOf(abs) {
+  try { const o = JSON.parse(require('fs').readFileSync(String(abs).replace(/\.md$/, '.data.json'), 'utf8')); return isObjP(o) ? o : null; } catch { return null; }
+}
+
+module.exports = { STANDARD, readDraft, deckOf, deckHtml, lookOf, lookFromCss, dataOf, short, fromShort, sentences, clip };

package/workspace/lib/report-structure.js

@@ -20,6 +20,7 @@
  *
  * THE LINES of structure.jsonl. Every line is { ev, …, at, actor }. `actor` is the guard's actor for a press, or { by: 'pmos', via: 'job' } for a job:
  *   describe {text} · turn {text, base, job} · version {n, turn, answer, questions?, options?, from?} · accept {n, charts: [ids]} · revert {n}
+ *   unsave {} (Go back to a template version that had the standard sections: nothing is saved; lib/routes-report-flow.js restore)
  *   source {n, source} (the new source, with the version it made) · remove {n, kind, ref} · dry {run, n, ok} · check {source, ok, steps} · error {text, mode}
  *
  * FOLD. { description, log: [{ who: pm|pmos, text, at, n?, questions, options }], versions: Map n → meta, current, saved: { n, at } | null, dry: {run, n, at, ok} | null,
@@ -37,7 +38,7 @@ const crypto = require('crypto');
 const RD = require('./report-draft.js');
 const CS = require('./charts-store.js');
 
-const EVENTS = Object.freeze(['describe', 'turn', 'version', 'accept', 'revert', 'source', 'remove', 'dry', 'pull', 'check', 'error']);
+const EVENTS = Object.freeze(['describe', 'turn', 'version', 'accept', 'revert', 'unsave', 'source', 'remove', 'dry', 'pull', 'check', 'error']);
 const PMOS_KINDS = Object.freeze(['pmos-level', 'dashboard', 'chart', 'document', 'past-report']);
 const OUTSIDE_KINDS = Object.freeze(['connector', 'link', 'upload', 'person', 'chrome', 'computer']);
 const KINDS = Object.freeze([...PMOS_KINDS, ...OUTSIDE_KINDS]);
@@ -123,6 +124,9 @@ function fold(events) {
     } else if (l.ev === 'revert') {
       if (st.versions.has(l.n)) st.current = l.n;
       st.log.push({ who: 'pm', text: `Back to S${l.n}. The next turn builds on it.`, at: l.at, n: l.n });
+    } else if (l.ev === 'unsave') {
+      st.saved = null;
+      st.log.push({ who: 'pm', text: 'Back to the standard sections (a template went back).', at: l.at });
     } else if (l.ev === 'source') {
       st.log.push({ who: 'pm', text: `Added the source ${str(l.source && l.source.name) || str(l.source && l.source.id)}.`, at: l.at });
     } else if (l.ev === 'remove') {