create-pmos 0.179.0 → 0.180.0

package/workspace/lib/report-export.js

@@ -0,0 +1,347 @@
+'use strict';
+/* report-export.js — a report document as a file on this machine: .docx, .pptx, .xlsx or .csv (initiative report-workspace, PRD section 6).
+ *
+ *   exportOf(markdown, fmt)    → { ok, fmt, name, mime, buffer } | { ok: false, error }     fmt: docx | pptx | xlsx | csv
+ *   parseReport(markdown)      → { title, subtitle, blocks: [{ t: 'h', level, text } | { t: 'p', text } | { t: 'li', text } | { t: 'table', rows }] }
+ *   sectionsOf(report)         → [{ heading, blocks }]      the blocks under each level-2 heading
+ *   docx(report) · pptx(report) · xlsx(report) · csv(report)   → Buffer (csv: string)
+ *   zip(entries) · unzip(buffer)   → Buffer · [{ name, data }]      a minimal zip writer and reader
+ *
+ * NO DEPENDENCY, NO NETWORK. The Office files are ZIP packages of small XML parts, built here from the report's markdown.
+ * `zip` writes stored or deflated entries (node's zlib), a CRC-32, and the central directory; `unzip` reads them back so a test
+ * can open what was written. The files carry the report's words and tables only: no macro, no link to the outside, no embedded
+ * object. Nothing is uploaded; the route that serves the file (lib/routes-report-setups.js) writes it to the response.
+ *
+ * WHAT THE MARKDOWN BECOMES. The frontmatter gives the title. A level-2 heading starts a section; a level-3 heading is a
+ * sub-heading in it. A pipe table becomes rows. A `- ` line is a bullet, any other line a paragraph. A note marker, the slide data
+ * comment and any other HTML comment are dropped: they are for PMOS, not for the reader.
+ *   .docx  headings, paragraphs and bullets      .pptx  a title slide, then one slide per section (title and bullets)
+ *   .xlsx  one sheet: a table is its rows; otherwise one row for each line, with its section beside it      .csv  the same rows
+ */
+const zlib = require('zlib');
+
+// ── the zip ────────────────────────────────────────────────────────────────────────────────────────
+const CRC_TABLE = (() => {
+  const t = new Int32Array(256);
+  for (let n = 0; n < 256; n++) { let c = n; for (let k = 0; k < 8; k++) c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1; t[n] = c; }
+  return t;
+})();
+function crc32(buf) {
+  let c = -1;
+  for (let i = 0; i < buf.length; i++) c = CRC_TABLE[(c ^ buf[i]) & 0xff] ^ (c >>> 8);
+  return (c ^ -1) >>> 0;
+}
+const DOS_TIME = 0;
+const DOS_DATE = (46 << 9) | (10 << 5) | 12;   // 2026-10-12: a fixed stamp, so the same report gives the same bytes
+
+/** entries: [{ name, data: string | Buffer }]. An entry is deflated when that makes it smaller, else stored. */
+function zip(entries) {
+  const locals = []; const central = [];
+  let offset = 0;
+  for (const e of entries) {
+    const name = Buffer.from(String(e.name), 'utf8');
+    const raw = Buffer.isBuffer(e.data) ? e.data : Buffer.from(String(e.data), 'utf8');
+    const deflated = zlib.deflateRawSync(raw);
+    const useDeflate = deflated.length < raw.length;
+    const body = useDeflate ? deflated : raw;
+    const method = useDeflate ? 8 : 0;
+    const crc = crc32(raw);
+    const lh = Buffer.alloc(30);
+    lh.writeUInt32LE(0x04034b50, 0); lh.writeUInt16LE(20, 4); lh.writeUInt16LE(0x0800, 6); lh.writeUInt16LE(method, 8);
+    lh.writeUInt16LE(DOS_TIME, 10); lh.writeUInt16LE(DOS_DATE, 12); lh.writeUInt32LE(crc, 14);
+    lh.writeUInt32LE(body.length, 18); lh.writeUInt32LE(raw.length, 22); lh.writeUInt16LE(name.length, 26); lh.writeUInt16LE(0, 28);
+    locals.push(lh, name, body);
+    const ch = Buffer.alloc(46);
+    ch.writeUInt32LE(0x02014b50, 0); ch.writeUInt16LE(20, 4); ch.writeUInt16LE(20, 6); ch.writeUInt16LE(0x0800, 8); ch.writeUInt16LE(method, 10);
+    ch.writeUInt16LE(DOS_TIME, 12); ch.writeUInt16LE(DOS_DATE, 14); ch.writeUInt32LE(crc, 16);
+    ch.writeUInt32LE(body.length, 20); ch.writeUInt32LE(raw.length, 24); ch.writeUInt16LE(name.length, 28);
+    ch.writeUInt16LE(0, 30); ch.writeUInt16LE(0, 32); ch.writeUInt16LE(0, 34); ch.writeUInt16LE(0, 36); ch.writeUInt32LE(0, 38); ch.writeUInt32LE(offset, 42);
+    central.push(ch, name);
+    offset += lh.length + name.length + body.length;
+  }
+  const cd = Buffer.concat(central);
+  const end = Buffer.alloc(22);
+  end.writeUInt32LE(0x06054b50, 0); end.writeUInt16LE(0, 4); end.writeUInt16LE(0, 6);
+  end.writeUInt16LE(entries.length, 8); end.writeUInt16LE(entries.length, 10); end.writeUInt32LE(cd.length, 12); end.writeUInt32LE(offset, 16); end.writeUInt16LE(0, 20);
+  return Buffer.concat([...locals, cd, end]);
+}
+
+/** Read the entries of a zip this module (or any plain zip) wrote. Throws on a damaged archive or a bad CRC. */
+function unzip(buf) {
+  let eocd = -1;
+  for (let i = buf.length - 22; i >= 0 && i >= buf.length - 65557; i--) if (buf.readUInt32LE(i) === 0x06054b50) { eocd = i; break; }
+  if (eocd < 0) throw new Error('not a zip: no end record');
+  const count = buf.readUInt16LE(eocd + 10);
+  let p = buf.readUInt32LE(eocd + 16);
+  const out = [];
+  for (let n = 0; n < count; n++) {
+    if (buf.readUInt32LE(p) !== 0x02014b50) throw new Error('not a zip: bad central directory');
+    const method = buf.readUInt16LE(p + 10); const crc = buf.readUInt32LE(p + 16); const csize = buf.readUInt32LE(p + 20);
+    const nlen = buf.readUInt16LE(p + 28); const xlen = buf.readUInt16LE(p + 30); const clen = buf.readUInt16LE(p + 32); const lho = buf.readUInt32LE(p + 42);
+    const name = buf.toString('utf8', p + 46, p + 46 + nlen);
+    if (buf.readUInt32LE(lho) !== 0x04034b50) throw new Error('not a zip: bad local header for ' + name);
+    const start = lho + 30 + buf.readUInt16LE(lho + 26) + buf.readUInt16LE(lho + 28);
+    const body = buf.subarray(start, start + csize);
+    const data = method === 8 ? zlib.inflateRawSync(body) : Buffer.from(body);
+    if (crc32(data) !== crc) throw new Error('bad CRC for ' + name);
+    out.push({ name, data });
+    p += 46 + nlen + xlen + clen;
+  }
+  return out;
+}
+
+// ── the markdown ───────────────────────────────────────────────────────────────────────────────────
+const xml = (s) => String(s == null ? '' : s).replace(/[\u0000-\u0008\u000b\u000c\u000e-\u001f]/g, '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+/** Plain words: no emphasis marks, no code ticks, a link as its text. */
+const plain = (s) => String(s == null ? '' : s).replace(/\*\*([^*]+)\*\*/g, '$1').replace(/__([^_]+)__/g, '$1').replace(/`([^`]*)`/g, '$1')
+  .replace(/!?\[([^\]]*)\]\(([^)]*)\)/g, (m, t, u) => (t || u)).replace(/\\\|/g, '|').replace(/\s+/g, ' ').trim();
+
+function frontmatterOf(text) {
+  const m = /^---\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)/.exec(text);
+  const map = {};
+  if (!m) return { map, body: text };
+  for (const line of m[1].split(/\r?\n/)) { const kv = /^([A-Za-z_][\w-]*):\s*(.*?)\s*$/.exec(line); if (kv) map[kv[1]] = kv[2].replace(/^["']|["']$/g, ''); }
+  return { map, body: text.slice(m[0].length) };
+}
+
+function parseReport(markdown) {
+  const { map, body } = frontmatterOf(String(markdown == null ? '' : markdown).replace(/\r\n?/g, '\n'));
+  const clean = body.replace(/<!--[\s\S]*?-->/g, '');
+  const blocks = [];
+  let table = null;
+  const flush = () => { if (table) { blocks.push({ t: 'table', rows: table }); table = null; } };
+  for (const raw of clean.split('\n')) {
+    const line = raw.replace(/\s+$/, '');
+    if (!line.trim()) { flush(); continue; }
+    if (/^\s*\|/.test(line)) {
+      const cells = line.trim().replace(/^\||\|$/g, '').split(/(?<!\\)\|/).map((c) => plain(c));
+      if (cells.every((c) => /^:?-{2,}:?$/.test(c))) continue;       // the separator row
+      (table || (table = [])).push(cells);
+      continue;
+    }
+    flush();
+    const h = /^(#{1,3})\s+(.*)$/.exec(line);
+    if (h) { blocks.push({ t: 'h', level: h[1].length, text: plain(h[2]) }); continue; }
+    const li = /^\s*(?:[-*+]|\d+[.)])\s+(.*)$/.exec(line);
+    if (li) { const t = plain(li[1]); if (t) blocks.push({ t: 'li', text: t }); continue; }
+    const p = plain(line);
+    if (p) blocks.push({ t: 'p', text: p });
+  }
+  flush();
+  const first = blocks.find((b) => b.t === 'h' && b.level === 1);
+  const title = plain(map.title || (first && first.text) || 'Report');
+  const rest = first ? blocks.filter((b) => b !== first) : blocks;
+  return { title, subtitle: map.slot ? String(map.slot) : '', blocks: rest };
+}
+
+/** The blocks under each level-2 heading; blocks before the first one go under the title. */
+function sectionsOf(report) {
+  const out = [];
+  let cur = null;
+  for (const b of report.blocks) {
+    if (b.t === 'h' && b.level === 2) { cur = { heading: b.text, blocks: [] }; out.push(cur); continue; }
+    if (!cur) { cur = { heading: report.title, blocks: [] }; out.push(cur); }
+    cur.blocks.push(b);
+  }
+  return out;
+}
+
+// ── .docx ──────────────────────────────────────────────────────────────────────────────────────────
+const NS_W = 'http://schemas.openxmlformats.org/wordprocessingml/2006/main';
+const NS_R = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships';
+const NS_PKG_REL = 'http://schemas.openxmlformats.org/package/2006/relationships';
+const NS_CT = 'http://schemas.openxmlformats.org/package/2006/content-types';
+const DECL = '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n';
+
+function docx(report) {
+  const para = (text, { style, bold, size, indent, hanging } = {}) => {
+    const ppr = (style ? `<w:pStyle w:val="${style}"/>` : '') + (indent ? `<w:ind w:left="${indent}" w:hanging="${hanging || 0}"/>` : '');
+    const rpr = (bold ? '<w:b/>' : '') + (size ? `<w:sz w:val="${size}"/>` : '');
+    return `<w:p>${ppr ? `<w:pPr>${ppr}</w:pPr>` : ''}<w:r>${rpr ? `<w:rPr>${rpr}</w:rPr>` : ''}<w:t xml:space="preserve">${xml(text)}</w:t></w:r></w:p>`;
+  };
+  const cell = (text, head) => `<w:tc><w:tcPr><w:tcW w:w="0" w:type="auto"/></w:tcPr>${para(text, { bold: head })}</w:tc>`;
+  const table = (rows) => `<w:tbl><w:tblPr><w:tblStyle w:val="TableGrid"/><w:tblW w:w="0" w:type="auto"/><w:tblBorders>`
+    + ['top', 'left', 'bottom', 'right', 'insideH', 'insideV'].map((s) => `<w:${s} w:val="single" w:sz="4" w:space="0" w:color="999999"/>`).join('')
+    + `</w:tblBorders></w:tblPr>${rows.map((r, i) => `<w:tr>${r.map((c) => cell(c, i === 0)).join('')}</w:tr>`).join('')}</w:tbl>${para('')}`;
+  const body = [para(report.title, { style: 'Title' })];
+  if (report.subtitle) body.push(para(report.subtitle, { style: 'Subtitle' }));
+  for (const b of report.blocks) {
+    if (b.t === 'h') body.push(para(b.text, { style: 'Heading' + Math.min(3, b.level) }));
+    else if (b.t === 'li') body.push(para('• ' + b.text, { indent: 540, hanging: 270 }));
+    else if (b.t === 'table') body.push(table(b.rows.length ? b.rows : [['']]));
+    else body.push(para(b.text));
+  }
+  const document = `${DECL}<w:document xmlns:w="${NS_W}" xmlns:r="${NS_R}"><w:body>${body.join('')}<w:sectPr><w:pgSz w:w="11906" w:h="16838"/><w:pgMar w:top="1134" w:right="1134" w:bottom="1134" w:left="1134" w:header="567" w:footer="567" w:gutter="0"/></w:sectPr></w:body></w:document>`;
+  const style = (id, name, size, bold, extra = '') => `<w:style w:type="paragraph" w:styleId="${id}"><w:name w:val="${name}"/><w:basedOn w:val="Normal"/><w:next w:val="Normal"/><w:qFormat/><w:pPr><w:spacing w:before="240" w:after="80"/>${extra}</w:pPr><w:rPr>${bold ? '<w:b/>' : ''}<w:sz w:val="${size}"/></w:rPr></w:style>`;
+  const styles = `${DECL}<w:styles xmlns:w="${NS_W}"><w:docDefaults><w:rPrDefault><w:rPr><w:rFonts w:ascii="Calibri" w:hAnsi="Calibri" w:cs="Calibri"/><w:sz w:val="22"/></w:rPr></w:rPrDefault><w:pPrDefault><w:pPr><w:spacing w:after="100"/></w:pPr></w:pPrDefault></w:docDefaults>`
+    + '<w:style w:type="paragraph" w:default="1" w:styleId="Normal"><w:name w:val="Normal"/><w:qFormat/></w:style>'
+    + style('Title', 'Title', 44, true) + style('Subtitle', 'Subtitle', 26, false)
+    + style('Heading1', 'heading 1', 32, true) + style('Heading2', 'heading 2', 28, true) + style('Heading3', 'heading 3', 24, true)
+    + '<w:style w:type="table" w:styleId="TableGrid"><w:name w:val="Table Grid"/><w:tblPr><w:tblBorders><w:top w:val="single" w:sz="4" w:space="0" w:color="auto"/><w:left w:val="single" w:sz="4" w:space="0" w:color="auto"/><w:bottom w:val="single" w:sz="4" w:space="0" w:color="auto"/><w:right w:val="single" w:sz="4" w:space="0" w:color="auto"/><w:insideH w:val="single" w:sz="4" w:space="0" w:color="auto"/><w:insideV w:val="single" w:sz="4" w:space="0" w:color="auto"/></w:tblBorders></w:tblPr></w:style>'
+    + '</w:styles>';
+  return zip([
+    { name: '[Content_Types].xml', data: `${DECL}<Types xmlns="${NS_CT}"><Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/><Default Extension="xml" ContentType="application/xml"/><Override PartName="/word/document.xml" ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml"/><Override PartName="/word/styles.xml" ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.styles+xml"/><Override PartName="/docProps/core.xml" ContentType="application/vnd.openxmlformats-package.core-properties+xml"/></Types>` },
+    { name: '_rels/.rels', data: `${DECL}<Relationships xmlns="${NS_PKG_REL}"><Relationship Id="rId1" Type="${NS_R}/officeDocument" Target="word/document.xml"/><Relationship Id="rId2" Type="http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties" Target="docProps/core.xml"/></Relationships>` },
+    { name: 'docProps/core.xml', data: coreProps(report.title) },
+    { name: 'word/document.xml', data: document },
+    { name: 'word/styles.xml', data: styles },
+    { name: 'word/_rels/document.xml.rels', data: `${DECL}<Relationships xmlns="${NS_PKG_REL}"><Relationship Id="rId1" Type="${NS_R}/styles" Target="styles.xml"/></Relationships>` },
+  ]);
+}
+function coreProps(title) {
+  return `${DECL}<cp:coreProperties xmlns:cp="http://schemas.openxmlformats.org/package/2006/metadata/core-properties" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><dc:title>${xml(title)}</dc:title><dc:creator>PMOS</dc:creator></cp:coreProperties>`;
+}
+
+// ── .pptx ──────────────────────────────────────────────────────────────────────────────────────────
+const NS_A = 'http://schemas.openxmlformats.org/drawingml/2006/main';
+const NS_P = 'http://schemas.openxmlformats.org/presentationml/2006/main';
+const EMU_W = 12192000; const EMU_H = 6858000;       // 16:9
+const PER_SLIDE = 9;
+
+/** The lines a section puts on slides: bullets and paragraphs as they are, a table row as "a | b | c", a sub-heading as a bold-less line. */
+function slideLines(blocks) {
+  const out = [];
+  for (const b of blocks) {
+    if (b.t === 'table') for (const r of b.rows) out.push(r.join(' | '));
+    else if (b.t === 'h') out.push(b.text);
+    else out.push(b.text);
+  }
+  return out;
+}
+
+function pptx(report) {
+  const slides = [];   // { title, lines, kind }
+  slides.push({ kind: 'title', title: report.title, lines: report.subtitle ? [report.subtitle] : [] });
+  for (const s of sectionsOf(report)) {
+    const lines = slideLines(s.blocks);
+    if (!lines.length) { slides.push({ kind: 'body', title: s.heading, lines: [] }); continue; }
+    for (let i = 0; i < lines.length; i += PER_SLIDE) slides.push({ kind: 'body', title: i ? s.heading + ' (continued)' : s.heading, lines: lines.slice(i, i + PER_SLIDE) });
+  }
+  const sp = (id, name, ph, x, y, cx, cy, paras) => `<p:sp><p:nvSpPr><p:cNvPr id="${id}" name="${name}"/><p:cNvSpPr><a:spLocks noGrp="1"/></p:cNvSpPr><p:nvPr><p:ph type="${ph}"${ph === 'body' ? ' idx="1"' : ''}/></p:nvPr></p:nvSpPr><p:spPr><a:xfrm><a:off x="${x}" y="${y}"/><a:ext cx="${cx}" cy="${cy}"/></a:xfrm></p:spPr><p:txBody><a:bodyPr/><a:lstStyle/>${paras}</p:txBody></p:sp>`;
+  const run = (t, sz, b) => `<a:r><a:rPr lang="en-GB" sz="${sz}"${b ? ' b="1"' : ''} dirty="0"/><a:t>${xml(t)}</a:t></a:r>`;
+  const slideXml = (s) => {
+    const title = sp(2, 'Title', s.kind === 'title' ? 'ctrTitle' : 'title', s.kind === 'title' ? 914400 : 609600, s.kind === 'title' ? 2286000 : 365760, s.kind === 'title' ? 10363200 : 10972800, s.kind === 'title' ? 1371600 : 914400,
+      `<a:p>${run(s.title, s.kind === 'title' ? 4400 : 3200, true)}</a:p>`);
+    const bodyParas = s.lines.map((l) => (s.kind === 'title' ? `<a:p>${run(l, 2400, false)}</a:p>` : `<a:p><a:pPr marL="285750" indent="-285750"><a:buFont typeface="Arial"/><a:buChar char="&#8226;"/></a:pPr>${run(l, 1800, false)}</a:p>`)).join('');
+    const body = s.lines.length ? sp(3, 'Content', s.kind === 'title' ? 'subTitle' : 'body', s.kind === 'title' ? 914400 : 609600, s.kind === 'title' ? 3810000 : 1371600, s.kind === 'title' ? 10363200 : 10972800, s.kind === 'title' ? 914400 : 4846320, bodyParas) : '';
+    return `${DECL}<p:sld xmlns:a="${NS_A}" xmlns:r="${NS_R}" xmlns:p="${NS_P}"><p:cSld><p:spTree><p:nvGrpSpPr><p:cNvPr id="1" name=""/><p:cNvGrpSpPr/><p:nvPr/></p:nvGrpSpPr><p:grpSpPr><a:xfrm><a:off x="0" y="0"/><a:ext cx="0" cy="0"/><a:chOff x="0" y="0"/><a:chExt cx="0" cy="0"/></a:xfrm></p:grpSpPr>${title}${body}</p:spTree></p:cSld><p:clrMapOvr><a:masterClrMapping/></p:clrMapOvr></p:sld>`;
+  };
+  const layoutXml = `${DECL}<p:sldLayout xmlns:a="${NS_A}" xmlns:r="${NS_R}" xmlns:p="${NS_P}" type="obj" preserve="1"><p:cSld name="Title and Content"><p:spTree><p:nvGrpSpPr><p:cNvPr id="1" name=""/><p:cNvGrpSpPr/><p:nvPr/></p:nvGrpSpPr><p:grpSpPr><a:xfrm><a:off x="0" y="0"/><a:ext cx="0" cy="0"/><a:chOff x="0" y="0"/><a:chExt cx="0" cy="0"/></a:xfrm></p:grpSpPr>`
+    + sp(2, 'Title 1', 'title', 609600, 365760, 10972800, 914400, '<a:p><a:endParaRPr lang="en-GB"/></a:p>')
+    + sp(3, 'Content Placeholder 2', 'body', 609600, 1371600, 10972800, 4846320, '<a:p><a:endParaRPr lang="en-GB"/></a:p>')
+    + '</p:spTree></p:cSld><p:clrMapOvr><a:masterClrMapping/></p:clrMapOvr></p:sldLayout>';
+  const masterXml = `${DECL}<p:sldMaster xmlns:a="${NS_A}" xmlns:r="${NS_R}" xmlns:p="${NS_P}"><p:cSld><p:bg><p:bgRef idx="1001"><a:schemeClr val="bg1"/></p:bgRef></p:bg><p:spTree><p:nvGrpSpPr><p:cNvPr id="1" name=""/><p:cNvGrpSpPr/><p:nvPr/></p:nvGrpSpPr><p:grpSpPr><a:xfrm><a:off x="0" y="0"/><a:ext cx="0" cy="0"/><a:chOff x="0" y="0"/><a:chExt cx="0" cy="0"/></a:xfrm></p:grpSpPr>`
+    + sp(2, 'Title Placeholder 1', 'title', 609600, 365760, 10972800, 914400, '<a:p><a:endParaRPr lang="en-GB"/></a:p>')
+    + sp(3, 'Text Placeholder 2', 'body', 609600, 1371600, 10972800, 4846320, '<a:p><a:endParaRPr lang="en-GB"/></a:p>')
+    + '</p:spTree></p:cSld><p:clrMap bg1="lt1" tx1="dk1" bg2="lt2" tx2="dk2" accent1="accent1" accent2="accent2" accent3="accent3" accent4="accent4" accent5="accent5" accent6="accent6" hlink="hlink" folHlink="folHlink"/>'
+    + '<p:sldLayoutIdLst><p:sldLayoutId id="2147483649" r:id="rId1"/></p:sldLayoutIdLst><p:txStyles><p:titleStyle><a:lvl1pPr algn="l"><a:defRPr sz="3200" b="1"><a:solidFill><a:schemeClr val="tx1"/></a:solidFill><a:latin typeface="+mj-lt"/></a:defRPr></a:lvl1pPr></p:titleStyle>'
+    + '<p:bodyStyle><a:lvl1pPr marL="285750" indent="-285750"><a:defRPr sz="1800"><a:solidFill><a:schemeClr val="tx1"/></a:solidFill><a:latin typeface="+mn-lt"/></a:defRPr></a:lvl1pPr></p:bodyStyle><p:otherStyle><a:defPPr><a:defRPr lang="en-GB"/></a:defPPr></p:otherStyle></p:txStyles></p:sldMaster>';
+  const themeXml = `${DECL}<a:theme xmlns:a="${NS_A}" name="PMOS"><a:themeElements><a:clrScheme name="PMOS"><a:dk1><a:srgbClr val="1F2328"/></a:dk1><a:lt1><a:srgbClr val="FFFFFF"/></a:lt1><a:dk2><a:srgbClr val="44546A"/></a:dk2><a:lt2><a:srgbClr val="E7E6E6"/></a:lt2><a:accent1><a:srgbClr val="2F5FD0"/></a:accent1><a:accent2><a:srgbClr val="7A8CA5"/></a:accent2><a:accent3><a:srgbClr val="2E8B57"/></a:accent3><a:accent4><a:srgbClr val="C58A00"/></a:accent4><a:accent5><a:srgbClr val="B3412F"/></a:accent5><a:accent6><a:srgbClr val="6B5BB0"/></a:accent6><a:hlink><a:srgbClr val="2F5FD0"/></a:hlink><a:folHlink><a:srgbClr val="6B5BB0"/></a:folHlink></a:clrScheme>`
+    + '<a:fontScheme name="PMOS"><a:majorFont><a:latin typeface="Calibri"/><a:ea typeface=""/><a:cs typeface=""/></a:majorFont><a:minorFont><a:latin typeface="Calibri"/><a:ea typeface=""/><a:cs typeface=""/></a:minorFont></a:fontScheme>'
+    + '<a:fmtScheme name="PMOS"><a:fillStyleLst><a:solidFill><a:schemeClr val="phClr"/></a:solidFill><a:solidFill><a:schemeClr val="phClr"/></a:solidFill><a:solidFill><a:schemeClr val="phClr"/></a:solidFill></a:fillStyleLst>'
+    + '<a:lnStyleLst><a:ln w="9525"><a:solidFill><a:schemeClr val="phClr"/></a:solidFill></a:ln><a:ln w="19050"><a:solidFill><a:schemeClr val="phClr"/></a:solidFill></a:ln><a:ln w="28575"><a:solidFill><a:schemeClr val="phClr"/></a:solidFill></a:ln></a:lnStyleLst>'
+    + '<a:effectStyleLst><a:effectStyle><a:effectLst/></a:effectStyle><a:effectStyle><a:effectLst/></a:effectStyle><a:effectStyle><a:effectLst/></a:effectStyle></a:effectStyleLst>'
+    + '<a:bgFillStyleLst><a:solidFill><a:schemeClr val="phClr"/></a:solidFill><a:solidFill><a:schemeClr val="phClr"/></a:solidFill><a:solidFill><a:schemeClr val="phClr"/></a:solidFill></a:bgFillStyleLst></a:fmtScheme></a:themeElements></a:theme>';
+  const n = slides.length;
+  const presXml = `${DECL}<p:presentation xmlns:a="${NS_A}" xmlns:r="${NS_R}" xmlns:p="${NS_P}"><p:sldMasterIdLst><p:sldMasterId id="2147483648" r:id="rId1"/></p:sldMasterIdLst><p:sldIdLst>`
+    + slides.map((s, i) => `<p:sldId id="${256 + i}" r:id="rId${i + 2}"/>`).join('') + `</p:sldIdLst><p:sldSz cx="${EMU_W}" cy="${EMU_H}"/><p:notesSz cx="6858000" cy="9144000"/></p:presentation>`;
+  const rel = (id, type, target) => `<Relationship Id="${id}" Type="${NS_R}/${type}" Target="${target}"/>`;
+  const entries = [
+    { name: '[Content_Types].xml', data: `${DECL}<Types xmlns="${NS_CT}"><Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/><Default Extension="xml" ContentType="application/xml"/><Override PartName="/ppt/presentation.xml" ContentType="application/vnd.openxmlformats-officedocument.presentationml.presentation.main+xml"/><Override PartName="/ppt/slideMasters/slideMaster1.xml" ContentType="application/vnd.openxmlformats-officedocument.presentationml.slideMaster+xml"/><Override PartName="/ppt/slideLayouts/slideLayout1.xml" ContentType="application/vnd.openxmlformats-officedocument.presentationml.slideLayout+xml"/><Override PartName="/ppt/theme/theme1.xml" ContentType="application/vnd.openxmlformats-officedocument.theme+xml"/><Override PartName="/docProps/core.xml" ContentType="application/vnd.openxmlformats-package.core-properties+xml"/>`
+      + slides.map((s, i) => `<Override PartName="/ppt/slides/slide${i + 1}.xml" ContentType="application/vnd.openxmlformats-officedocument.presentationml.slide+xml"/>`).join('') + '</Types>' },
+    { name: '_rels/.rels', data: `${DECL}<Relationships xmlns="${NS_PKG_REL}">${rel('rId1', 'officeDocument', 'ppt/presentation.xml')}<Relationship Id="rId2" Type="http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties" Target="docProps/core.xml"/></Relationships>` },
+    { name: 'docProps/core.xml', data: coreProps(report.title) },
+    { name: 'ppt/presentation.xml', data: presXml },
+    { name: 'ppt/_rels/presentation.xml.rels', data: `${DECL}<Relationships xmlns="${NS_PKG_REL}">${rel('rId1', 'slideMaster', 'slideMasters/slideMaster1.xml')}${slides.map((s, i) => rel('rId' + (i + 2), 'slide', `slides/slide${i + 1}.xml`)).join('')}${rel('rId' + (n + 2), 'theme', 'theme/theme1.xml')}</Relationships>` },
+    { name: 'ppt/slideMasters/slideMaster1.xml', data: masterXml },
+    { name: 'ppt/slideMasters/_rels/slideMaster1.xml.rels', data: `${DECL}<Relationships xmlns="${NS_PKG_REL}">${rel('rId1', 'slideLayout', '../slideLayouts/slideLayout1.xml')}${rel('rId2', 'theme', '../theme/theme1.xml')}</Relationships>` },
+    { name: 'ppt/slideLayouts/slideLayout1.xml', data: layoutXml },
+    { name: 'ppt/slideLayouts/_rels/slideLayout1.xml.rels', data: `${DECL}<Relationships xmlns="${NS_PKG_REL}">${rel('rId1', 'slideMaster', '../slideMasters/slideMaster1.xml')}</Relationships>` },
+    { name: 'ppt/theme/theme1.xml', data: themeXml },
+  ];
+  slides.forEach((s, i) => {
+    entries.push({ name: `ppt/slides/slide${i + 1}.xml`, data: slideXml(s) });
+    entries.push({ name: `ppt/slides/_rels/slide${i + 1}.xml.rels`, data: `${DECL}<Relationships xmlns="${NS_PKG_REL}">${rel('rId1', 'slideLayout', '../slideLayouts/slideLayout1.xml')}</Relationships>` });
+  });
+  return zip(entries);
+}
+
+// ── rows: the sheet and the CSV ─────────────────────────────────────────────────────────────────────
+/** Rows of cells. A table is its own rows (the first row is its header). Any other line is [section, line]. */
+function rowsOf(report) {
+  const rows = [];
+  let tables = 0;
+  for (const s of sectionsOf(report)) {
+    for (const b of s.blocks) {
+      if (b.t === 'table') {
+        if (tables++) rows.push([]);
+        b.rows.forEach((r) => rows.push(r));
+        rows.push([]);
+      }
+    }
+  }
+  if (tables) {
+    while (rows.length && !rows[rows.length - 1].length) rows.pop();
+    return rows;
+  }
+  rows.push(['Section', 'Line']);
+  for (const s of sectionsOf(report)) for (const b of s.blocks) {
+    if (b.t === 'h') rows.push([s.heading, b.text]);
+    else if (b.t !== 'table') rows.push([s.heading, b.text]);
+  }
+  return rows;
+}
+
+const colName = (i) => { let s = ''; for (let n = i + 1; n > 0; n = Math.floor((n - 1) / 26)) s = String.fromCharCode(65 + ((n - 1) % 26)) + s; return s; };
+const isNumber = (s) => /^-?\d+(?:\.\d+)?$/.test(s) && s.replace(/^-/, '').replace(/\.\d+$/, '').length <= 12 && !/^-?0\d/.test(s);
+
+function xlsx(report) {
+  const rows = rowsOf(report);
+  const width = rows.reduce((m, r) => Math.max(m, r.length), 1);
+  const sheetRows = rows.map((r, ri) => {
+    if (!r.length) return `<row r="${ri + 1}"/>`;
+    return `<row r="${ri + 1}">${r.map((c, ci) => {
+      const ref = colName(ci) + (ri + 1);
+      const v = String(c == null ? '' : c);
+      if (isNumber(v)) return `<c r="${ref}"><v>${v}</v></c>`;
+      return `<c r="${ref}" t="inlineStr"${ri === 0 ? ' s="1"' : ''}><is><t xml:space="preserve">${xml(v)}</t></is></c>`;
+    }).join('')}</row>`;
+  }).join('');
+  const cols = Array.from({ length: width }, (_, i) => `<col min="${i + 1}" max="${i + 1}" width="${i === width - 1 ? 60 : 28}" customWidth="1"/>`).join('');
+  const sheet = `${DECL}<worksheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main"><dimension ref="A1:${colName(width - 1)}${Math.max(1, rows.length)}"/><sheetViews><sheetView workbookViewId="0"><pane ySplit="1" topLeftCell="A2" activePane="bottomLeft" state="frozen"/></sheetView></sheetViews><sheetFormatPr defaultRowHeight="15"/><cols>${cols}</cols><sheetData>${sheetRows}</sheetData></worksheet>`;
+  const name = xml(plain(report.title).replace(/[\\/?*[\]:]/g, ' ').slice(0, 31) || 'Report');
+  return zip([
+    { name: '[Content_Types].xml', data: `${DECL}<Types xmlns="${NS_CT}"><Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/><Default Extension="xml" ContentType="application/xml"/><Override PartName="/xl/workbook.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.main+xml"/><Override PartName="/xl/worksheets/sheet1.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml"/><Override PartName="/xl/styles.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.styles+xml"/><Override PartName="/docProps/core.xml" ContentType="application/vnd.openxmlformats-package.core-properties+xml"/></Types>` },
+    { name: '_rels/.rels', data: `${DECL}<Relationships xmlns="${NS_PKG_REL}"><Relationship Id="rId1" Type="${NS_R}/officeDocument" Target="xl/workbook.xml"/><Relationship Id="rId2" Type="http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties" Target="docProps/core.xml"/></Relationships>` },
+    { name: 'docProps/core.xml', data: coreProps(report.title) },
+    { name: 'xl/workbook.xml', data: `${DECL}<workbook xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" xmlns:r="${NS_R}"><sheets><sheet name="${name}" sheetId="1" r:id="rId1"/></sheets></workbook>` },
+    { name: 'xl/_rels/workbook.xml.rels', data: `${DECL}<Relationships xmlns="${NS_PKG_REL}"><Relationship Id="rId1" Type="${NS_R}/worksheet" Target="worksheets/sheet1.xml"/><Relationship Id="rId2" Type="${NS_R}/styles" Target="styles.xml"/></Relationships>` },
+    { name: 'xl/styles.xml', data: `${DECL}<styleSheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main"><fonts count="2"><font><sz val="11"/><name val="Calibri"/></font><font><b/><sz val="11"/><name val="Calibri"/></font></fonts><fills count="2"><fill><patternFill patternType="none"/></fill><fill><patternFill patternType="gray125"/></fill></fills><borders count="1"><border><left/><right/><top/><bottom/><diagonal/></border></borders><cellStyleXfs count="1"><xf numFmtId="0" fontId="0" fillId="0" borderId="0"/></cellStyleXfs><cellXfs count="2"><xf numFmtId="0" fontId="0" fillId="0" borderId="0" xfId="0"/><xf numFmtId="0" fontId="1" fillId="0" borderId="0" xfId="0" applyFont="1"/></cellXfs><cellStyles count="1"><cellStyle name="Normal" xfId="0" builtinId="0"/></cellStyles></styleSheet>` },
+    { name: 'xl/worksheets/sheet1.xml', data: sheet },
+  ]);
+}
+
+function csv(report) {
+  const q = (c) => { const v = String(c == null ? '' : c); return /[",\r\n]/.test(v) ? '"' + v.replace(/"/g, '""') + '"' : v; };
+  return rowsOf(report).map((r) => r.map(q).join(',')).join('\r\n') + '\r\n';
+}
+
+// ── the entry point ────────────────────────────────────────────────────────────────────────────────
+const FORMATS = Object.freeze({
+  docx: Object.freeze({ mime: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' }),
+  pptx: Object.freeze({ mime: 'application/vnd.openxmlformats-officedocument.presentationml.presentation' }),
+  xlsx: Object.freeze({ mime: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' }),
+  csv: Object.freeze({ mime: 'text/csv; charset=utf-8' }),
+});
+const BUILD = { docx, pptx, xlsx, csv: (r) => Buffer.from(csv(r), 'utf8') };
+
+function exportOf(markdown, fmt) {
+  if (!Object.prototype.hasOwnProperty.call(FORMATS, fmt)) return { ok: false, error: `fmt must be one of ${Object.keys(FORMATS).join(', ')}` };
+  const report = parseReport(markdown);
+  let buffer;
+  try { buffer = BUILD[fmt](report); } catch (e) { return { ok: false, error: 'the file could not be built: ' + String((e && e.message) || e).slice(0, 160) }; }
+  const stem = plain(report.title).toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 60) || 'report';
+  return { ok: true, fmt, name: `${stem}.${fmt}`, mime: FORMATS[fmt].mime, buffer };
+}
+
+module.exports = { exportOf, parseReport, sectionsOf, rowsOf, docx, pptx, xlsx, csv, zip, unzip, crc32, FORMATS };

package/workspace/lib/report-finder.js

@@ -0,0 +1,156 @@
+'use strict';
+/* report-finder.js — the weekly look for the reports a PM already sends (initiative report-workspace, PRD section 4).
+ *
+ *   off(env)                              → true when PMOS_REPORT_FIND=off (or 0, false, no)
+ *   weekStart(ms)                         → the Monday 00:00 (local) of the week that holds `ms`
+ *   dueNow(state, now, { open })          → { ok } | { ok: false, why }       may the run start now?
+ *   nextRun(state, now, { dayEnd })       → ms | null                          when the next run starts (null: off, or no source on)
+ *   findPrompt(skill, run, ctx)           → the prompt of the run
+ *   create(deps) → { tick(opts), active() }
+ *
+ * THE RULE. Weekly means Monday 09:00 on this machine's clock, inside the working hours (lib/driver-run.js dayCheckOpen: the day-check window and
+ * the quiet hours). A run that missed 09:00 starts at the first tick inside the working hours of that Monday. A Monday the server did not run is
+ * not caught up. AT MOST ONE RUN PER WEEK: any run that started this week, whether it ended well or not, ends the week's turn. With every source
+ * off, or the finder set to Off, nothing runs. `PMOS_REPORT_FIND=off` does none of it. The run is headless and never a pane.
+ *
+ * ONE RUN FOR THE MACHINE. The PM's calendar, Slack and mail are the same whichever repository is open, so the run belongs to the HOME workspace
+ * (deps.homeId) and files its findings in that repository's report-setups.jsonl. The run reads (kind report-find, lib/headless.js) and files with
+ * `pmos report propose`; it has no tool that sends, posts or fetches the web. The server gives it PMOS_REPORT_FILE and PMOS_REPORT_RUN, which the
+ * model cannot change, so it files as the find run it is and nothing else.
+ *
+ * deps: { workspaces() → [w], isLead(w), homeId() → id | null, settings() → proactive settings, inQuiet(now, quiet) → bool, headlessOff() → bool, env,
+ *         spawn(spec) → session row, stop(session), promptFor(skillId) → skill body | null, warn(what, err) }
+ * `spawn(spec)` gets { name, ws, origin, initialInput, env, onDone }; it returns the session row ({ id, state, headless, note }).
+ */
+const RS = require('./report-setups.js');
+const driverRun = require('./driver-run.js');
+
+const flagOff = (v) => /^(off|0|false|no)$/i.test(String(v || '').trim());
+const off = (env) => flagOff((env || process.env).PMOS_REPORT_FIND);
+const SLOT = '09:00';
+const oneLine = (s, max) => String(s == null ? '' : s).replace(/\s+/g, ' ').trim().slice(0, max);
+const hhmm = (ms) => { const d = new Date(ms); return `${String(d.getHours()).padStart(2, '0')}:${String(d.getMinutes()).padStart(2, '0')}`; };
+const slotMs = (ms) => { const d = new Date(ms); const [h, m] = SLOT.split(':').map(Number); d.setHours(h, m, 0, 0); return d.getTime(); };
+
+/** The Monday 00:00 (local) of the week that holds `ms`. */
+function weekStart(ms) {
+  const d = new Date(ms);
+  d.setHours(0, 0, 0, 0);
+  d.setDate(d.getDate() - ((d.getDay() + 6) % 7));
+  return d.getTime();
+}
+const sourcesOn = (state) => RS.FINDER_SOURCES.filter((k) => state.finder.sources[k]);
+const ranThisWeek = (state, now) => state.finds.some((f) => f.start && Date.parse(f.start) >= weekStart(now));
+const isOpenRun = (state) => state.finds.some((f) => !f.end);
+
+/** May a run start now? `open` is the day-check window and quiet hours as one boolean (lib/driver-run.js dayCheckOpen). */
+function dueNow(state, now, { open = true } = {}) {
+  if (state.finder.cadence === 'off') return { ok: false, why: 'off' };
+  if (!sourcesOn(state).length) return { ok: false, why: 'no-sources' };
+  if (new Date(now).getDay() !== 1) return { ok: false, why: 'not-monday' };
+  if (now < slotMs(now)) return { ok: false, why: 'before-09' };
+  if (!open) return { ok: false, why: 'outside-working-hours' };
+  if (isOpenRun(state)) return { ok: false, why: 'running' };
+  if (ranThisWeek(state, now)) return { ok: false, why: 'done-this-week' };
+  return { ok: true };
+}
+
+/** When the next run starts, in ms, or null. A run that is due now and has not started starts at the next tick, so the answer is `now`. */
+function nextRun(state, now, { dayEnd = '18:00' } = {}) {
+  if (state.finder.cadence === 'off' || !sourcesOn(state).length) return null;
+  const done = ranThisWeek(state, now);
+  for (let k = 0; k < 15; k++) {
+    const d = new Date(now); d.setDate(d.getDate() + k);
+    const day = d.getTime();
+    if (d.getDay() !== 1) continue;
+    if (k === 0) {
+      if (done) continue;
+      if (now < slotMs(day)) return slotMs(day);
+      if (hhmm(now) < dayEnd) return now;
+      continue;
+    }
+    return slotMs(day);
+  }
+  return null;
+}
+
+/** The prompt of the run: the skill, the run id, the sources that are on, and what the run must skip. Nothing of the repository's private text. */
+function findPrompt(skill, run, { sources, setups = [], dismissed = [], now = Date.now() } = {}) {
+  const on = RS.FINDER_SOURCES.filter((k) => sources && sources[k]);
+  const offList = RS.FINDER_SOURCES.filter((k) => !(sources && sources[k]));
+  const list = (a, none) => (a.length ? a.map((x) => `- ${oneLine(x, 120)}`).join('\n') : `- ${none}`);
+  return `${skill}\n\nThis run:\n- Run: ${run}\n- Today: ${new Date(now).toISOString().slice(0, 10)}\n- Sources that are ON (read these only): ${on.join(', ') || 'none'}\n- Sources that are OFF (do not read them): ${offList.join(', ') || 'none'}\n`
+    + `- Reports already set up (do not propose them):\n${list(setups, 'none')}\n- Not a report (the PM said so; skip these patterns and names):\n${list(dismissed, 'none')}\n\n`
+    + 'File each proposal with `pmos report propose --json -`. File at most 5. Send nothing.';
+}
+
+function create(deps) {
+  const active = new Map();   // run id → { w, file, session }
+  const warn = deps.warn || (() => {});
+
+  /** The run ended (or never started): write its find-end line. */
+  function ended(run, file, r, now) {
+    const res = (r && r.result) || {};
+    const ok = !!(r && !r.timedOut && !r.stopped && r.code === 0 && res.ok && !res.isError);
+    try { RS.findEnd(file, { run, ok, error: ok ? null : (r && r.note) || 'the run failed', now }); } catch (e) { warn('report find end', e); }
+    active.delete(run);
+  }
+
+  function start(w, file, state, now) {
+    const skill = deps.promptFor('report-find');
+    const run = RS.findStart(file, { now });
+    active.set(run, { w, file, session: null });
+    if (!skill) { ended(run, file, { code: 1, note: 'the report-find skill is not installed', result: {} }, now); return; }
+    const st = RS.fold(RS.readLines(file));
+    const prompt = findPrompt(skill, run, { sources: st.finder.sources, now,
+      setups: [...st.setups.values()].map((s) => s.name),
+      dismissed: [...st.dismissed.patterns, ...[...st.dismissed.names].map((n) => `name:${n}`)] });
+    let session = null;
+    try {
+      session = deps.spawn({ name: 'Report finder', ws: w.id, origin: `report-find:${run}`, initialInput: prompt + '\r',
+        env: { PMOS_REPORT_FILE: file, PMOS_REPORT_RUN: `find:${run}` }, onDone: (r) => ended(run, file, r) });
+    } catch (e) { warn('report find', e); }
+    if (!session || session.state === 'exited' || session.headless !== 'report-find') {
+      // A start that did not become a headless run (no `claude` on the PATH, a refused model choice, a pane because headless is off) is a failed run.
+      if (session && session.headless !== 'report-find' && session.state !== 'exited' && deps.stop) { try { deps.stop(session); } catch { /* best effort */ } }
+      if (active.has(run)) ended(run, file, { code: 1, note: (session && session.note) || 'the run could not start as a background run', result: {} }, now);
+      return;
+    }
+    const cur = active.get(run);
+    if (cur) cur.session = session.id;
+  }
+
+  function tick({ now = Date.now(), env } = {}) {
+    if (off(env || deps.env)) return { off: true };
+    const summary = { closed: 0, started: 0 };
+    const settings = deps.settings();
+    const home = deps.homeId ? deps.homeId() : null;
+    for (const w of deps.workspaces()) {
+      let lead = false;
+      try { lead = !!deps.isLead(w) && (!home || w.id === home); } catch { lead = false; }
+      if (!lead) continue;
+      let file = null;
+      try { file = RS.ledgerFile(w.root); } catch { file = null; }
+      if (!file) continue;
+      try {
+        let state = RS.fold(RS.readLines(file));
+        // A run that was alive when the server stopped is over.
+        for (const f of state.finds) {
+          if (f.end || active.has(f.run)) continue;
+          RS.findEnd(file, { run: f.run, ok: false, error: 'interrupted: the workspace restarted', now });
+          summary.closed++;
+        }
+        if (deps.headlessOff()) continue;   // the finder never runs in a pane
+        if (active.size) continue;
+        state = RS.fold(RS.readLines(file));
+        const open = driverRun.dayCheckOpen(settings, now, deps.inQuiet);
+        if (dueNow(state, now, { open }).ok) { start(w, file, state, now); summary.started++; break; }
+      } catch (e) { warn('report find tick', e); }
+    }
+    return summary;
+  }
+
+  return { tick, active: () => [...active.keys()] };
+}
+
+module.exports = { create, off, weekStart, dueNow, nextRun, findPrompt, sourcesOn, SLOT };

package/workspace/lib/report-needs.js

@@ -216,4 +216,4 @@ function sig(w) {
   return [reportsOf(w.root).sig, schedulesStamp(), kill, hour].join(':');
 }
 
-module.exports = { kinds, rowsFor, sig, rowsAt, reportsOf, readSchedules, cadenceOfSkill, cadenceOfSchedule, blobSha, reportsDir, KILL_FILE, GRACE_MS };
+module.exports = { kinds, rowsFor, sig, rowsAt, reportsOf, frontmatter, readSchedules, cadenceOfSkill, cadenceOfSchedule, blobSha, reportsDir, KILL_FILE, GRACE_MS };