create-pmos 0.494.0 → 0.495.0

package/workspace/lib/report-pyramid.js

@@ -1,22 +1,25 @@
 '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)          → the report's parts, read back from the draft's markdown (pure) | null when it is not a cadence draft
- *   deckOf(markdown, look?)      → { slides: [{ kind, title, …, source, n }], look } | null      (pure)
+ *   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 PM's headline note, else the drafted headline as a sentence about who is off plan
- *   answer      the governing thought, up to three supports (one per initiative, off plan first) and the ask beside them
+ *   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.
+ *   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
@@ -24,8 +27,9 @@
  * (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 one style block it takes the first font family and the most used dark colour (white text on
- * it passes 4.5:1) as the accent. No saved design: the standard PMOS look (Nunito, navy).
+ * 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({
@@ -44,6 +48,7 @@ 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));
@@ -63,6 +68,40 @@ function fromShort(s, today) {
 }
 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) {
@@ -133,8 +172,9 @@ function timelineOf(lines) {
 }
 
 /** The parts of a cadence draft (lib/report-draft.js render), or null when the markdown is not one. */
-function readDraft(markdown) {
+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);
@@ -153,11 +193,20 @@ function readDraft(markdown) {
   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), to: win[2], since: win[3] || '' } : null,
+    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') || []),
@@ -219,52 +268,80 @@ function timelineTitle(rows, 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) {
-  const d = readDraft(markdown);
+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 at ${d.window.to.replace('T', ' ').replace(/:00Z$/, ' UTC').replace(/Z$/, ' UTC')}` : '';
+  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 = measures.map((b) => `${b.measure.anchor} as of ${short(b.measure.as_of)} (${b.measure.source})`);
+  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: d.headlineNote || shortAnswer(d),
-    sub: [d.slot ? short(d.slot) + ' ' + d.slot.slice(0, 4) : '', d.window ? `window ${short(d.window.from)} to ${short(d.window.to)}${d.window.since ? ', ' + d.window.since : ''}` : ''].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: longAnswer(d), supports: order.slice(0, 3).map(supportOf), ask,
+    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 = !d.blocks.length ? 'No initiative was active in this window'
-    : !off.length ? (d.blocks.length === 1 ? `${d.blocks[0].title} is on plan and needs no comment` : `All ${num(d.blocks.length)} initiatives are on plan; no row needs a comment`)
-      : `${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` : ''}`;
+  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(' ') : '',
   }));
-  for (let i = 0; i < Math.max(rows.length, 1); i += ROWS_PER_SLIDE) {
-    slides.push({ kind: 'scorecard', title: i ? scTitle + ' (continued)' : scTitle, rows: rows.slice(i, i + ROWS_PER_SLIDE), kr: measures.length ? anchor : null,
-      source: ['Source: initiative blocks', ...krSrc].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]));
-    const days = tl.flatMap((r) => r.spans.flatMap((s) => [s.start, s.due])).concat(overdue.map((o) => o.due), d.today ? [d.today] : []).filter(Boolean).sort();
+    // 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: timelineTitle(tl, overdue), from: days[0], to: days[days.length - 1], today: d.today,
-      rows: tl.slice(0, 6).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,
+      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) : ''}`,
     });
@@ -276,7 +353,7 @@ function deckOf(markdown, look) {
   const nr = d.notReached;
   slides.push({
     kind: 'sources',
-    title: `Every number comes from ${num(d.reached.length)} source${d.reached.length === 1 ? '' : 's'}${nr.length ? `; ${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: 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; });
@@ -360,14 +437,14 @@ 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:64px;font-weight:800;line-height:1.1;margin:16px 0;max-width:1000px">${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>`;
+      + `<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 = `<div style="display:flex;gap:42px;flex:1;min-height:0"><div style="flex:1.45">${sup}</div>${ask}</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']);
@@ -403,6 +480,21 @@ function lum(hex) {
   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);
@@ -411,11 +503,13 @@ function lookFromCss(cssText) {
   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]) => lum(k) <= 0.18 && (() => { const h = k.length === 4 ? k.slice(1).split('').map((c) => c + c).join('') : k.slice(1); const v = [0, 2, 4].map((i) => parseInt(h.slice(i, i + 2), 16)); return Math.max(...v) - Math.min(...v) >= 16; })())
-    .sort((a, b) => b[1] - a[1] || (a[0] < b[0] ? -1 : 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;
-  if (dark.length) out.accent = dark[0][0];
+  // 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. */
@@ -426,9 +520,16 @@ function lookOf(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]).join('\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 }; }
 }
 
-module.exports = { STANDARD, readDraft, deckOf, deckHtml, lookOf, lookFromCss, short, fromShort };
+/** 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-templates.js

@@ -157,11 +157,11 @@ function fold(lines) {
 }
 
 /** T1, from the setup as it is now. Once: a report with a version already keeps it. `chat` names the conversation it came from. */
-function ensureFirst(root, id, setup, { chat, refs, now } = {}) {
+function ensureFirst(root, id, setup, { chat, refs, why, now } = {}) {
   if (!ID_RE.test(String(id || ''))) return refuse(400, 'id must be a report id');
   const f = fold(readLines(root, id));
   if (f.current != null) return { ok: true, n: f.current, existing: true };
-  const line = { ev: 'version', n: 1, settings: settingsOf(setup, refs || liveRefs(root, id)), why: 'First shape, from your chat.' };
+  const line = { ev: 'version', n: 1, settings: settingsOf(setup, refs || liveRefs(root, id)), why: typeof why === 'string' && why ? why.slice(0, 200) : 'First shape, from your chat.' };
   if (typeof chat === 'string' && CHAT_RE.test(chat)) line.chat = chat;
   append(root, id, line, now);
   return { ok: true, n: 1 };
@@ -179,6 +179,36 @@ function addVersion(root, id, settings, { why, names, fill, now } = {}) {
   append(root, id, { ev: 'version', n, settings: next, why: typeof why === 'string' && why.trim() ? why.trim().slice(0, 200) : diffWords(was, next, names).join('; ').slice(0, 200) }, now);
   return { ok: true, n, settings: next };
 }
+/** The saved version (accept n, unsave null) of one store's events at a time; undefined when the store has no event at or before it. */
+function savedAt(events, t) {
+  let out;
+  for (const e of Array.isArray(events) ? events : []) {
+    const at = Date.parse((e && e.at) || '');
+    if (!Number.isFinite(at) || at > t) continue;
+    if (e.ev === 'accept') out = refN(e.n); else if (e.ev === 'unsave') out = null;
+  }
+  return out;
+}
+/** Backfill on read (live check of 0.494.0, brief 4 item 10): a T line written before TplA has no sections or look. Each such version takes the
+ * S<n> and D<n> that were saved at its time (no saved one then = the standard ones); the current version takes the ones saved now. Nothing is
+ * written. `filled` names the keys that were backfilled. Pure apart from reading the two stores' events. */
+function backfill(root, id, folded) {
+  if (!folded || !Array.isArray(folded.versions) || !folded.versions.some((v) => v.settings.structure === undefined || v.settings.design === undefined)) return folded;
+  let sEv = [], dEv = [];
+  try { sEv = require('./report-structure.js').readEvents(root, id); } catch { sEv = []; }
+  try { dEv = require('./report-design.js').readEvents(root, id); } catch { dEv = []; }
+  const live = liveRefs(root, id);
+  const versions = folded.versions.map((v) => {
+    const fill = {}; const t = Date.parse(v.at || '');
+    for (const [k, ev] of [['structure', sEv], ['design', dEv]]) {
+      if (v.settings[k] !== undefined) continue;
+      const then = Number.isFinite(t) ? savedAt(ev, t) : undefined;
+      fill[k] = v.current || !Number.isFinite(t) ? live[k] : then === undefined ? null : then;
+    }
+    return Object.keys(fill).length ? { ...v, settings: { ...v.settings, ...fill }, filled: Object.keys(fill) } : v;
+  });
+  return { ...folded, versions };
+}
 /** Go back to T<n>: that version is the current one again. Nothing is deleted. */
 function restore(root, id, n, { now } = {}) {
   const f = fold(readLines(root, id));
@@ -230,4 +260,4 @@ function followBefore(root, id, setup) { try { const was = liveRefs(root, id); e
 function followAfter(root, id, patch, was) { try { return addVersion(root, id, patch, { names: namesOf(root, id), fill: was }); } catch { return null; } }
 
 module.exports = { ID_RE, CHAT_RE, FORMAT, STANDARD_LOOK, ledgerOf, readLines, fold, settingsOf, cleanSettings, sameSettings, sectionsDiff, diffWords, settingsWords, goesWords,
-  liveRefs, namesOf, refN, ensureFirst, addVersion, restore, cyclesOf, chatOf, review, followBefore, followAfter };
+  liveRefs, namesOf, refN, ensureFirst, backfill, savedAt, addVersion, restore, cyclesOf, chatOf, review, followBefore, followAfter };

package/workspace/lib/routes-boards.js

@@ -207,10 +207,43 @@ function createAndPlace(ctx, w, boardId, input, actor, tie) {
   const stage = (ownWf || board.workflow)[0].name;
   tie({ file, board, initiative: r.id, stage });
   if (ownWf) append(file, actor, { kind: 'ini-workflow', board: board.id, id: r.id, template: tpl, stages: ownWf, moved: null });
+  const wfStart = startOnDefault(ctx, w, r.id, actor, { boardId: board.id });
   rowsLib.invalidate(w.root);
   rowCache.delete(w.root);
   if (ctx.invalidateNeedsAgg) ctx.invalidateNeedsAgg(w.id);
-  return { ok: true, initiative: { id: r.id, path: r.path }, stage, board: board.id };
+  return { ok: true, initiative: { id: r.id, path: r.path }, stage, board: board.id, ...(wfStart ? { wf: wfStart } : {}) };
+}
+
+/** Batch 24 item 3 (canvas DfA): a new initiative starts on the default workflow (Settings › Workflows, the star). It writes one ini-wf
+ * line on the initiative's board, the line a workflow switch writes, so every surface reads the workflow from it; with no `moved` the
+ * initiative stands in the first stage (Triage) and no move shows in its history. Product feature (the default when none is set, or when
+ * the default is archived) writes nothing. The workspace's own default first; a workspace that never set one reads the home workspace's
+ * (Settings opens on home), and that workflow is adopted into this workspace's library first, as a switch does. PMOS still reads the BRD
+ * and proposes a switch. Never throws: a new initiative is made even when this line cannot be written.
+ * boardId: the board the initiative is on; else its domain board (products/<domain>/) or the workspace board. → the workflow id | null */
+function startOnDefault(ctx, w, iniId, actor, { boardId = null, recordPath = null } = {}) {
+  try {
+    const file = ledgerFile(ctx, w);
+    const dir = ctx.stateDirFor ? ctx.stateDirFor(w) : null;
+    if (!file || !dir || isSelf(ctx, w)) return null;
+    let lib = WS.library(dir), from = null;
+    if (!lib.defaultId) {
+      const home = ctx.getWs ? ctx.getWs(null) : null;
+      const hd = home && home.id !== w.id && ctx.stateDirFor ? ctx.stateDirFor(home) : null;
+      const hl = hd ? WS.library(hd) : null;
+      if (hl && hl.defaultId) { lib = hl; from = home; }
+    }
+    const def = WF.defaultOf(lib);
+    if (def.id === WF.PRODUCT_FEATURE_ID) return null;
+    const fr = frameFor(ctx, w);
+    const dm = recordPath ? /^products\/([^/]+)\//.exec(recordPath) : null;
+    const bid = boardId || (dm && fr.boards.some((b) => b.id === dm[1] && b.kind === 'domain') ? dm[1] : w.id);
+    const board = fr.boards.find((b) => b.id === bid);
+    if (!board || board.self) return null;
+    if (from && !WS.library(dir).byId.has(def.id)) { const a = WS.adopt(dir, def, actor, from.id); if (!a.ok) return null; }
+    append(file, actor, { kind: 'ini-wf', board: board.id, id: iniId, wf: def.id, why: 'the default workflow for new initiatives', start: true });
+    return def.id;
+  } catch { return null; }
 }
 
 // ── boards of a workspace ─────────────────────────────────────────────────────────────────────────
@@ -1784,4 +1817,4 @@ function meetingBoards(ctx) {
   return { list, detail };
 }
 
-module.exports = { prefixes: ['/api/boards'], handle, tasksOfIni, postFrame, needRows, itemsOf, readLedger, foldOf, epicsOf, rowsOfBoard, invalidateRows: (w) => { rowsLib.invalidate(w.root); rowCache.delete(w.root); }, move, switchWorkflow, taskState, taskAdd, taskEdit, writeAs, taskDelete, taskRestore, initiativeWorkflow, seedInitiative, stageTasks, boardIndex, appendScanAsk, scanDeclineSignal, createAndPlace, ledgerFile, append, frameFor, boardIdOf, meetingBoards, boardsOf, baseRows, boardRow, taskSpanOf, workflowRowOf, foldOf, portfolio, SELF_REFUSAL, NO_STATE };
+module.exports = { prefixes: ['/api/boards'], handle, tasksOfIni, postFrame, needRows, itemsOf, readLedger, foldOf, epicsOf, rowsOfBoard, invalidateRows: (w) => { rowsLib.invalidate(w.root); rowCache.delete(w.root); }, move, switchWorkflow, taskState, taskAdd, taskEdit, writeAs, taskDelete, taskRestore, initiativeWorkflow, seedInitiative, stageTasks, boardIndex, appendScanAsk, scanDeclineSignal, createAndPlace, startOnDefault, ledgerFile, append, frameFor, boardIdOf, meetingBoards, boardsOf, baseRows, boardRow, taskSpanOf, workflowRowOf, foldOf, portfolio, SELF_REFUSAL, NO_STATE };

package/workspace/lib/routes-brief-page.js

@@ -241,7 +241,8 @@ const nameCache = new Map();   // cwd -> { key, name }
 function gitConfigKey(cwd) {
   const os = require('os');
   const home = os.homedir();
-  const files = [path.join(home, '.gitconfig'), path.join(process.env.XDG_CONFIG_HOME || path.join(home, '.config'), 'git', 'config'), path.join(cwd, '.git', 'config')];
+  const files = [path.join(home, '.gitconfig'), path.join(process.env.XDG_CONFIG_HOME || path.join(home, '.config'), 'git', 'config')];
+  if (cwd) files.push(path.join(cwd, '.git', 'config'));   // a caller with no folder (routes-mentions answer in a test) reads the global config only
   if (process.env.GIT_CONFIG_GLOBAL) files.push(process.env.GIT_CONFIG_GLOBAL);
   return files.map((f) => { try { const st = fs.statSync(f); return st.size + ':' + st.mtimeMs; } catch { return '-'; } }).join('|');
 }

package/workspace/lib/routes-initiatives.js

@@ -666,6 +666,7 @@ async function handle(req, res, url, ctx) {
     const { ws: _ws, ...input } = body;
     const r = writer.createInitiative(w.root, input, { actor: g.actor });
     if (!r.ok) { ctx.json(res, { ok: false, status: r.status, error: r.error, field: r.field }, r.status); return true; }
+    require('./routes-boards.js').startOnDefault(ctx, w, r.id, g.actor, { recordPath: r.path });   // batch 24 item 3: the default workflow
     rowsLib.invalidate(w.root);
     if (ctx.invalidateNeedsAgg) ctx.invalidateNeedsAgg(w.id);
     ctx.json(res, { ok: true, id: r.id, path: r.path, written: r.written, sig: sigOf(w.root) });

package/workspace/lib/routes-report-design.js

@@ -482,7 +482,7 @@ async function handle(req, res, url, ctx) {
       // The finished slides of a cadence draft (canvas RsA): the Pyramid deck in the report's saved look, else the standard PMOS look.
       const d = reportDoc(w, text(url.searchParams.get('path'))); if (d.error) return send(d.error);
       let md; try { md = fs.readFileSync(d.c.md, 'utf8'); } catch { return send(bad(404, 'no such report document')); }
-      const deck = RP.deckOf(md, RP.lookOf(w.root, d.c.cadence));
+      const deck = RP.deckOf(md, RP.lookOf(w.root, d.c.cadence), { data: RP.dataOf(d.c.md) });
       if (!deck) return send(bad(404, 'this document is not a cadence draft, so it has no Pyramid deck'));
       return sendHtml(res, D.sanitize(RP.deckHtml(deck)));
     }

package/workspace/lib/routes-report-flow.js

@@ -18,7 +18,8 @@
  *   POST /api/report-flow/ask      { ws, id, text, path? }           → { ok, session, path, passed | started }   a change for the report's own session
  *                                     Without a path the change goes to the report's latest draft; an issued latest cycle (or path) is refused
  *                                     409, as an issued report is frozen. The session always gets the file and its slot, and "do not draft a new
- *                                     slot", so a change edits the draft that exists (report-building brief 1).
+ *                                     slot", so a change edits the draft that exists (report-building brief 1). A change to the words edits only
+ *                                     the named notes and keeps every caveat; it redrafts only when the PM asks for fresh numbers (brief 4).
  *
  * THE REPORT'S OWN SESSION. Each template drafts in a session of its own, never in the PM's chat (the agreed note). A report with a saved
  * structure drafts in the session its schedule starts (lib/routes-report-structure.js draftNow, origin schedule:<id>). A change the PM asks for
@@ -62,7 +63,12 @@ function draftingOf(ctx, w, id) { try { return typeof ctx.structureDraftState ==
 function stateOf(ctx, w, id, now = Date.now()) {
   const root = w.root, s = setupOf(root, id);
   const cycles = cyclesOf(root, id);
-  const f = RT.fold(RT.readLines(root, id));
+  // a report set up before the template flow, with a saved look or sections, gets its T1 now (brief 4 item 10): its template is what is saved
+  const live0 = RT.liveRefs(root, id);
+  if (s && s.status !== 'removed' && (live0.design != null || live0.structure != null) && RT.fold(RT.readLines(root, id)).current == null) {
+    try { RT.ensureFirst(root, id, s, { refs: live0, why: 'The template as it was set up, with its saved look and sections.' }); } catch { /* shown with no versions */ }
+  }
+  const f = RT.backfill(root, id, RT.fold(RT.readLines(root, id)));
   const counts = RT.cyclesOf(f, cycles.filter((c) => c.issued_at).map((c) => ({ at: c.issued_at })));
   const names = RT.namesOf(root, id), live = RT.liveRefs(root, id);
   const sess = readSession(root, id);
@@ -143,7 +149,8 @@ const slotOfRel = (rel) => { const m = /(\d{4}-\d{2}-\d{2})\.md$/.exec(String(re
 /** The line that names the draft a change is for: its file, its slot, and the rule that no new slot is drafted. */
 function draftWords(id, rel) {
   const slot = slotOfRel(rel);
-  return rel && slot ? `The draft: ${rel} (slot ${slot}). Change that file in place. Do not draft a new slot: run \`pmos report draft ${id} ${slot} --redraft\` only, never \`pmos report draft ${id}\` without the slot.` : '';
+  return rel && slot ? `The draft: ${rel} (slot ${slot}). Change that file in place: edit only the note or notes the change is about, and keep every caveat. `
+    + `Do not redraft for a change to the words. Only when the PM asks for fresh numbers, run \`pmos report draft ${id} ${slot} --redraft\`; never \`pmos report draft ${id}\` without the slot, and do not draft a new slot.` : '';
 }
 /** The words the report's session gets for one change. */
 function askPrompt(skill, id, rel, change) {
@@ -246,7 +253,7 @@ async function handle(req, res, url, ctx) {
     return v.ok ? send({ status: 200, body: { ok: true, n: v.n, state: stateOf(ctx, w, id) } }) : fail(v);
   }
   if (sub === 'restore') {
-    const f = RT.fold(RT.readLines(w.root, id)), v = f.versions.find((x) => x.n === +body.n);
+    const f = RT.backfill(w.root, id, RT.fold(RT.readLines(w.root, id))), v = f.versions.find((x) => x.n === +body.n);
     if (!v) return send(bad(404, 'no such template version'));
     const a = apply(w.root, id, v.settings, opts);
     if (!a.ok) return fail(a);

package/workspace/lib/routes-report-setups.js

@@ -276,7 +276,7 @@ async function tick(ctx, now = new Date()) {
 function exportAnswer(ctx, res, w, url) {
   const rel = text(url.searchParams.get('path'));
   const fmt = text(url.searchParams.get('fmt'));
-  if (fmt === 'pdf') return bad(400, 'PDF is printed by the browser. Use Print in the document.');
+  if (fmt === 'pdf') return bad(400, 'PDF is printed by the browser, so there is no PDF file to download here. Open the report, press Download › PDF, and choose Save as PDF in the print window: you get the same slides, one on each page.');
   if (!Object.prototype.hasOwnProperty.call(RX.FORMATS, fmt)) return bad(400, `fmt must be one of ${Object.keys(RX.FORMATS).join(', ')}`);
   if (!RC.isReportPath(rel)) return bad(400, 'path must be a report document: <state>/reports/<cadence>/<slot>.md');
   const abs = path.resolve(w.root);
@@ -289,7 +289,8 @@ function exportAnswer(ctx, res, w, url) {
     md = fs.readFileSync(real, 'utf8');
   } catch { return bad(404, 'no such document'); }
   const cyc = /(?:^|\/)reports\/([a-z][a-z0-9-]{0,39})\/\d{4}-\d{2}-\d{2}\.md$/.exec(rel);
-  const out = RX.exportOf(md, fmt, { look: fmt === 'pptx' && cyc ? require('./report-pyramid.js').lookOf(abs, cyc[1]) : null });
+  const RPy = require('./report-pyramid.js');
+  const out = RX.exportOf(md, fmt, fmt === 'pptx' && cyc ? { look: RPy.lookOf(abs, cyc[1]), data: RPy.dataOf(full) } : {});
   if (!out.ok) return bad(500, out.error);
   return { status: 200, file: out };
 }

package/workspace/lib/routes-workflows.js

@@ -6,6 +6,7 @@
  *   POST /api/workflows/save    { ws, wf, moveRemoved? }   → { ok, workflow, moved } | 409 { ok:false, error, inUse }
  *   POST /api/workflows/copy    { ws, id, name? }          → { ok, workflow }
  *   POST /api/workflows/archive { ws, id, archived }       → { ok } | 409 { inUse }
+ *   POST /api/workflows/default { ws, id }                 → { ok, id }   the star: the workflow a new initiative starts on (batch 24 item 3, DfA)
  *   POST /api/workflows/draft   { ws, draft | null, note? } → { ok, draft }   (the page relays the chat's draft; the agent writes through `pmos workflow draft`)
  *   GET  /api/workflows/proposals                → { ok, items }   Claude's ✦: move the initiatives of a replaced workflow (batch 20 item 3, lib/wf-bridge.js)
  *   POST /api/workflows/bridge  { ws, id, from, map }       → { ok, workflow }   the bridge saved with the new workflow (WmB, Settings)
@@ -68,7 +69,7 @@ async function handle(req, res, url, ctx) {
   if (!read.ok) return send(bad(400, 'the body is not JSON'));
   const body = read.body;
   if (!isObj(body)) return send(bad(400, 'the body must be a JSON object'));
-  if (req.headers && req.headers['x-pmos-session']) return send(bad(403, 'an agent session cannot save, copy or archive a workflow. It drafts one with `pmos workflow draft`, and the PM presses Create'));
+  if (req.headers && req.headers['x-pmos-session']) return send(bad(403, 'an agent session cannot save, copy, archive or star a workflow. It drafts one with `pmos workflow draft`, and the PM presses Create'));
   const g = guard.requirePagePress(req, body);
   if (!g.ok) return send(bad(g.status, g.error));
   const w = wsOf(ctx, typeof body.ws === 'string' ? body.ws : null);
@@ -101,6 +102,10 @@ async function handle(req, res, url, ctx) {
     const r = WS.archive(dir, body.id, body.archived, g.actor, { inUse });
     return send(r.ok ? { body: { ok: true } } : bad(r.status || 400, r.error, r.inUse ? { inUse: r.inUse } : null));
   }
+  if (p === '/api/workflows/default') {
+    const r = WS.setDefault(dir, body.id, g.actor);
+    return send(r.ok ? { body: { ok: true, id: r.id } } : bad(r.status || 400, r.error));
+  }
   if (p === '/api/workflows/bridge' || p === '/api/workflows/switch-all' || p === '/api/workflows/switch-all/undo') {
     if (p !== '/api/workflows/switch-all/undo' && (typeof body.id !== 'string' || !body.id || typeof body.from !== 'string' || !body.from)) return send(bad(400, 'id (the new workflow) and from (the one it replaces) are required'));
     const r = p === '/api/workflows/bridge' ? Bridge.saveBridge(ctx, w, body, g.actor) : p === '/api/workflows/switch-all' ? Bridge.switchAll(ctx, w, body, g) : Bridge.undoAll(ctx, w, body, g);

package/workspace/lib/workflow-cli.js

@@ -105,8 +105,8 @@ async function run(argv, { say = (s) => console.log(s), cwd = process.cwd(), isT
 
   if (verb === 'list') {
     const all = WF.list(WS.library(stateDir));
-    if (json) { say(JSON.stringify({ ok: true, workflows: all.map((w) => ({ id: w.id, name: w.name, stages: w.stages.length, archived: !!w.archived })) })); return 0; }
-    for (const w of all) say(`${w.id} · ${w.name} · ${w.stages.length} stage${w.stages.length === 1 ? '' : 's'}${w.archived ? ' · archived' : ''}`);
+    if (json) { say(JSON.stringify({ ok: true, workflows: all.map((w) => ({ id: w.id, name: w.name, stages: w.stages.length, archived: !!w.archived, default: !!w.default })) })); return 0; }
+    for (const w of all) say(`${w.id} · ${w.name} · ${w.stages.length} stage${w.stages.length === 1 ? '' : 's'}${w.archived ? ' · archived' : ''}${w.default ? ' · default for new initiatives' : ''}`);
     return 0;
   }
   if (verb === 'show') {

package/workspace/lib/workflows-store.js

@@ -6,6 +6,7 @@
  *   copy(stateDir, id, name, actor)                     → { ok, workflow }
  *   adopt(stateDir, wf, actor, fromWs)                  → { ok, workflow }   another workspace's workflow written into this library
  *   archive(stateDir, id, archived, actor, { inUse })   → { ok }
+ *   setDefault(stateDir, id, actor)                     → { ok, id }          the workflow a new initiative starts on (one wf-default line)
  *   saveDraft(stateDir, { draft, note }, actor)         → { ok, draft }       (the chat's draft; null clears it)
  *   readDraft(stateDir)                                 → { draft, note, at } | null
  *   judge(stateDir, { board, id, stage, runs, why, cite, undo }, actor) → { ok }   one stage-judge line in boards.jsonl
@@ -89,9 +90,22 @@ function archive(stateDir, id, archived, actor, { inUse = [] } = {}) {
   if (!lib.byId.has(id)) return { ok: false, status: 404, error: 'That workflow could not be found. It may have been removed.' };
   if (archived && inUse.length) return { ok: false, status: 409, error: `${inUse.length} ${inUse.length === 1 ? 'initiative runs' : 'initiatives run'} this workflow. Move ${inUse.length === 1 ? 'it' : 'them'} to another workflow first.`, inUse };
   append(fileOf(stateDir), actor, { kind: 'wf-archive', id, archived: !!archived });
+  // Archiving the default puts Product feature back as the default, so a later Restore does not bring the old default back silently
+  if (archived && lib.defaultId === id) append(fileOf(stateDir), actor, { kind: 'wf-default', id: W.PRODUCT_FEATURE_ID });
   return { ok: true };
 }
 
+/** The default workflow for new initiatives in this workspace (batch 24 item 3, canvas DfA). Product feature can be the default. */
+function setDefault(stateDir, id, actor) {
+  if (!stateDir) return { ok: false, status: 409, error: NO_STATE };
+  const lib = library(stateDir);
+  const wf = typeof id === 'string' && id ? lib.byId.get(id) : null;
+  if (!wf) return { ok: false, status: 404, error: 'That workflow could not be found. It may have been removed.' };
+  if (wf.archived) return { ok: false, status: 409, error: `${wf.name} is archived. Restore it first.` };
+  append(fileOf(stateDir), actor, { kind: 'wf-default', id });
+  return { ok: true, id };
+}
+
 /** The chat's draft. It is checked like a save (so the Viewer never shows a draft Create would refuse); null clears it. */
 function saveDraft(stateDir, { draft, note } = {}, actor) {
   if (!stateDir) return { ok: false, status: 409, error: NO_STATE };
@@ -116,4 +130,4 @@ function judge(stateDir, { board, id, stage, runs, why, cite, undo } = {}, actor
   return { ok: true };
 }
 
-module.exports = { FILE, library, save, copy, adopt, archive, saveDraft, readDraft, judge, fileOf };
+module.exports = { FILE, library, save, copy, adopt, archive, setDefault, saveDraft, readDraft, judge, fileOf };