create-pmos 0.178.0 → 0.180.0

package/workspace/lib/report-cli.js

@@ -1,10 +1,14 @@
 'use strict';
 /* report-cli.js — `pmos report …`: draft a cadence report, issue it, list the reports (pm-os-absorb Run 5, PRD R22,
- * R24, R25; D86 points 2 and 3).
+ * R24, R25; D86 points 2 and 3), and the report workspace's verbs (initiative report-workspace).
  *
  *   pmos report draft <cadence> [<slot>] [--now <time>] [--redraft] [--json] [--root <dir>]
  *   pmos report issue <cadence> <slot> [--root <dir>]
  *   pmos report list [<cadence>] [--json] [--root <dir>]
+ *   pmos report propose --json <file|->        a report-setup or report-find run files its proposal or finding (agent-allowed)
+ *   pmos report definitions [--json]           the report definitions (read-only)
+ *   pmos report setups [--json]                the recurring reports (read-only)
+ *   pmos report finder <weekly|off>            the PM's: how often PMOS looks for reports you send  (also: finder source <name> <on|off>)
  *
  * `draft` is the script with no model (R22.1): lib/report-draft.js folds the ledgers since the last issue and writes
  * every number into `<state>/reports/<cadence>/<slot>.md`, with one empty note marker per block. It refuses a slot that
@@ -16,6 +20,11 @@
  * written. Then lib/issues.js appendFromCli records the path and the git blob sha, which freezes the report. Nothing
  * is sent: print the file or copy it as markdown.
  *
+ * `propose` is the ONLY write a background report run has (lib/headless.js kinds report-setup and report-find). The server starts the run with
+ * PMOS_REPORT_RUN (`setup:<ask>` or `find:<run>`) and PMOS_REPORT_FILE (the ledger), which the model cannot change: a setup run files the
+ * proposal of its own ask and nothing else; a find run files findings and nothing else. It answers `filed`, `duplicate` or `dismissed` (the PM
+ * said Not a report for that pattern). A proposal is data; only a PM press on the page sets a report up (lib/routes-report-setups.js).
+ *
  * Who writes is decided by the call path, never by an argument (lib/actor.js). The verb never calls the server.
  */
 const fs = require('fs');
@@ -25,9 +34,10 @@ const reportDraft = require('./report-draft.js');
 const issues = require('./issues.js');
 const guard = require('./pm-guard.js');
 const actorLib = require('./actor.js');
+const RS = require('./report-setups.js');
 const { parseArgs } = require('./schedule-cli');
 
-const COMMANDS = { report: ['draft', 'issue', 'list'] };
+const COMMANDS = { report: ['draft', 'issue', 'list', 'propose', 'definitions', 'setups', 'finder'] };
 const USAGE = [
   'usage: pmos report draft|issue|list — cadence reports (for example the biweekly)',
   '  pmos report draft <cadence> [<slot>] [--now <time>] [--redraft]',
@@ -37,11 +47,20 @@ const USAGE = [
   '      Freeze the draft. Only the PM can do this, at a terminal, by typing <cadence>-<slot>. Nothing is sent.',
   '  pmos report list [<cadence>]',
   '      Show the drafts and the issued reports.',
+  '  pmos report propose --json <file|->',
+  '      A report-setup or report-find run files its proposal or finding (JSON, from a file or standard input). It answers filed, duplicate',
+  '      or dismissed. A proposal is data: nothing is set up until the PM presses Set up on the Reports page.',
+  '  pmos report definitions',
+  '      Show the report definitions (read-only).',
+  '  pmos report setups',
+  '      Show the recurring reports (read-only).',
+  '  pmos report finder <weekly|off>   |   pmos report finder source <calendar|slack|mail|drive> <on|off>',
+  '      Only the PM can change how PMOS looks for the reports you send (default weekly; mail is off until you turn it on).',
   '  every command: [--json] [--root <dir>]. The cadence is the report skill id without "report-", for example biweekly.',
 ];
 const BOOL = new Set(['json', 'redraft', 'help']);
 const VALUE = new Set(['now', 'root']);
-const ALLOWED = { draft: ['json', 'redraft', 'now', 'root'], issue: ['root'], list: ['json', 'root'] };
+const ALLOWED = { draft: ['json', 'redraft', 'now', 'root'], issue: ['root'], list: ['json', 'root'], propose: ['json', 'root'], definitions: ['json', 'root'], setups: ['json', 'root'], finder: ['json', 'root'] };
 const CADENCE_RE = /^[a-z][a-z0-9-]{0,39}$/;
 const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
 
@@ -62,7 +81,7 @@ function repoRoot(cwd) {
 }
 const isDate = (s) => typeof s === 'string' && DATE_RE.test(s) && new Date(s + 'T00:00:00Z').toISOString().slice(0, 10) === s;
 
-async function run(argv, { say = (s) => console.log(s), cwd = process.cwd(), isTTY, env, ask, now } = {}) {
+async function run(argv, { say = (s) => console.log(s), cwd = process.cwd(), isTTY, env, ask, now, stdin } = {}) {
   const args = argv[0] === 'report' ? argv.slice(1) : argv.slice();
   const verb = args[0];
   const { pos, flags } = parse(args.slice(1));
@@ -110,6 +129,8 @@ async function run(argv, { say = (s) => console.log(s), cwd = process.cwd(), isT
     return 0;
   }
 
+  if (verb === 'definitions' || verb === 'setups' || verb === 'propose' || verb === 'finder') return reportWorkspace(verb, { pos, flags, root, json, say, fail, cwd, isTTY, env, stdin, now });
+
   const [cadence, slot] = pos;
   if (!cadence || !CADENCE_RE.test(cadence) || pos.length > 2) { say(`usage: pmos report ${verb} <cadence> ${verb === 'issue' ? '<slot>' : '[<slot>]'}`); return 2; }
   if (slot !== undefined && !isDate(slot)) return fail('the slot must be a date, YYYY-MM-DD', 2);
@@ -149,4 +170,68 @@ async function run(argv, { say = (s) => console.log(s), cwd = process.cwd(), isT
   return 0;
 }
 
+/** The report workspace's verbs. `propose` is the one an agent run may call; `finder` is the PM's. */
+function reportWorkspace(verb, { pos, flags, root, json, say, fail, isTTY, env, stdin, now }) {
+  const E = env === undefined ? process.env : env;
+  const stamp = now == null ? undefined : now;
+  if (verb === 'definitions') {
+    const defs = RS.definitionsOf(root);
+    if (json) { say(JSON.stringify({ ok: true, definitions: defs })); return 0; }
+    if (!defs.length) say('No report definition yet. Set one up on the Reports page, or ask PMOS there.');
+    for (const d of defs) say(`${d.id}  ${d.output || 'no output'}  ${d.audience || 'no audience'}${d.errors.length ? `  ! ${d.errors.join('; ')}` : ''}  ${d.path}`);
+    return 0;
+  }
+  if (verb === 'setups') {
+    const st = RS.stateOf(root);
+    const setups = [...st.setups.values()].map((s) => ({ id: s.id, name: s.name, audience: s.audience, source: s.source, output: s.output, schedule: s.schedule, label: RS.scheduleLabel(s.schedule), status: s.status }));
+    if (json) { say(JSON.stringify({ ok: true, setups })); return 0; }
+    if (!setups.length) say('No recurring report is set up yet.');
+    for (const s of setups) say(`${s.id}  ${s.status}  ${s.label}  ${s.output}  ${s.source}  ${s.name}`);
+    return 0;
+  }
+  const who = actorLib.fromCli({ ...(isTTY === undefined ? {} : { isTTY }), ...(env === undefined ? {} : { env }) });
+  if (verb === 'finder') {
+    // The PM's: an agent session cannot turn the finder or a source on or off.
+    if (!actorLib.isPm(who)) return fail(`only the PM can change the report finder, at an interactive terminal${actorLib.isAgent(who) && who.by !== 'agent:unknown' ? '; an agent session cannot' : ''}`);
+    const file = RS.ledgerFile(root);
+    let r;
+    if (pos[0] === 'source') {
+      if (!RS.FINDER_SOURCES.includes(pos[1]) || !['on', 'off'].includes(pos[2])) { say('usage: pmos report finder source <calendar|slack|mail|drive> <on|off>'); return 2; }
+      r = RS.setFinder(file, { sources: { [pos[1]]: pos[2] === 'on' }, by: who.by, now: stamp });
+    } else {
+      if (!RS.FINDER_CADENCES.includes(pos[0]) || pos.length !== 1) { say('usage: pmos report finder <weekly|off>'); return 2; }
+      r = RS.setFinder(file, { cadence: pos[0], by: who.by, now: stamp });
+    }
+    if (!r.ok) return fail(r.error);
+    if (json) { say(JSON.stringify({ ok: true, finder: r.finder })); return 0; }
+    say(`✓ The report finder is ${r.finder.cadence}. Sources on: ${RS.FINDER_SOURCES.filter((k) => r.finder.sources[k]).join(', ') || 'none'}.`);
+    return 0;
+  }
+  // propose
+  const run = String(E && E.PMOS_REPORT_RUN || '');
+  const m = /^(setup|find):([A-Za-z0-9._-]{1,40})$/.exec(run);
+  if (!m) return fail('pmos report propose is for a report-setup or report-find run. The PM sets a report up on the Reports page');
+  let file = E && typeof E.PMOS_REPORT_FILE === 'string' && E.PMOS_REPORT_FILE && path.basename(E.PMOS_REPORT_FILE) === RS.LEDGER ? E.PMOS_REPORT_FILE : null;
+  if (!file) file = RS.ledgerFile(root);
+  const src = pos[0];
+  if (!src) { say('usage: pmos report propose --json <file|->'); return 2; }
+  let text;
+  try { text = src === '-' ? (typeof stdin === 'string' ? stdin : fs.readFileSync(0, 'utf8')) : fs.readFileSync(path.resolve(src), 'utf8'); }
+  catch { return fail(`could not read ${src === '-' ? 'standard input' : src}`); }
+  let body;
+  try { body = JSON.parse(text); } catch { return fail('the proposal is not JSON'); }
+  if (!body || typeof body !== 'object' || Array.isArray(body)) return fail('the proposal is a JSON object');
+  const done = (result, extra = {}) => { if (json) say(JSON.stringify({ ok: true, result, ...extra })); else say(result + (extra.id ? ` ${extra.id}` : '')); return 0; };
+  if (m[1] === 'setup') {
+    const r = RS.fileProposal(file, { ask: m[2], proposal: body.proposal && typeof body.proposal === 'object' ? body.proposal : body, by: who.by, now: stamp });
+    if (!r.ok) return fail(r.error);
+    return done('filed', { ask: m[2] });
+  }
+  const r = RS.fileFinding(file, body, { run: m[2], by: who.by, now: stamp });
+  if (r.result === 'duplicate') return done('duplicate');
+  if (r.result === 'dismissed') return fail('dismissed');
+  if (!r.ok) return fail(r.error);
+  return done('filed', { id: r.id });
+}
+
 module.exports = { run, COMMANDS, USAGE };

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 };