create-pmos 0.46.0 → 0.48.0

package/workspace/public/pm/view-memory.js

@@ -0,0 +1,122 @@
+/* pm/view-memory.js — the Memory view, drawn from planning/design/cockpit-mockup/ViewMemory.dc.html.
+ *
+ * PRD workspace-cockpit-nav, Run 3 (R4). The board is a header with the actions on the right, a row of badges, the notes as
+ * cards and a closing note. The notes and every action are the view's existing list (modes-live.js `memoryLive`): this module
+ * draws it into a host, moves its action bar into the header and restyles its rows as cards. No node is removed, so every
+ * `data-r9` hook and every live behaviour stays as it was. Only the frame is new.
+ *
+ * The badges are read off the list once it is drawn, so they come from the same GET /api/memory as the notes and never
+ * disagree with them. The board's "used by N sessions" and the note kinds (preference, standard, lesson, fact) have no backing
+ * in this app, so they are not drawn. In the fixture the prototype's list is drawn under the header, unchanged, and the badges
+ * are not read.
+ */
+import { el } from './dom.js';
+
+const BTN = 'font:500 12.5px var(--sans);background:transparent;color:var(--foreground);border:1px solid var(--input);border-radius:8px;padding:0 12px;height:30px;min-height:30px;display:inline-grid;place-items:center;cursor:pointer;flex:none';
+const BTNP = 'font:500 12.5px var(--sans);background:var(--foreground);color:var(--background);border:0;border-radius:8px;padding:0 12px;height:30px;min-height:30px;display:inline-grid;place-items:center;cursor:pointer;flex:none';
+const SMALL = 'font:500 11.5px var(--sans);background:transparent;color:var(--muted-foreground);border:1px solid var(--border);border-radius:6px;padding:0 9px;height:24px;min-height:24px;display:inline-grid;place-items:center;cursor:pointer';
+const BADGE = 'font:500 11px var(--sans);border:1px solid var(--border);border-radius:999px;padding:0 8px;line-height:18px;white-space:nowrap;display:inline-block';
+const TONE = {
+  s: ';border-color:transparent;background:color-mix(in oklab, var(--success) 16%, transparent);color:var(--success)',
+  w: ';border-color:transparent;background:color-mix(in oklab, var(--warning) 16%, transparent);color:var(--warning)',
+  d: ';border-color:transparent;background:color-mix(in oklab, var(--destructive) 18%, transparent);color:var(--destructive)',
+};
+const ENTRY = 'display:flex;flex-direction:column;gap:6px;width:100%;box-sizing:border-box;text-align:left;border:1px solid var(--border);border-radius:10px;padding:12px 14px;background:var(--background);min-height:0';
+const LBL = 'font:500 10px var(--mono);letter-spacing:.1em;text-transform:uppercase;color:var(--muted-foreground);padding:8px 0 0';
+const NOTE = 'color:var(--muted-foreground);font-size:13px;line-height:1.5';
+
+const badge = (text, tone, key) => el('span', { style: BADGE + (tone ? TONE[tone] : ''), 'data-board-badge': key }, String(text));
+
+/** The badges row. It is read off the list this module just drew, so the badges and the notes always come from the same read
+ * of GET /api/memory and agree after every action. Before that read succeeds the list states its own status, so no badge is
+ * drawn. Nothing is shown that the read does not hold. */
+function badges(list) {
+  if (!list.querySelector('[data-r9="usage-memory"]')) return null;
+  const wire = list.querySelector('[data-r9="wire"]');
+  const appr = list.querySelector('[data-r9="approval"]');
+  const wired = !!wire && /wired \u2713/.test(wire.textContent || '');
+  const n = list.querySelectorAll('[data-r9="entry"]').length;
+  const pending = list.querySelectorAll('[data-r9="pending"]').length;
+  const approval = !!appr && /approval on/.test(appr.textContent || '');
+  return el('div', { 'data-board-part': 'badges', style: 'display:flex;gap:6px;flex-wrap:wrap' },
+    wired ? badge('wired into CLAUDE.md', 's', 'wired') : badge('not wired into CLAUDE.md', 'w', 'wired'),
+    badge(n + (n === 1 ? ' note' : ' notes'), null, 'count'),
+    badge('memory.jsonl \u00b7 append-only', null, 'ledger'),
+    pending ? badge(pending + ' waiting for you', 'w', 'pending') : null,
+    badge('agent notes ' + (approval ? 'wait for your approval' : 'apply at once'), null, 'approval'));
+}
+
+/** Restyle the existing list in place: its bar goes into the header, its rows become cards. Nothing is removed. */
+function restyle(list, actions) {
+  const bar = list.querySelector('[data-r9="memory-bar"]');
+  // the list's wrapper, when it drew one (a failed or pending read returns its parts unwrapped)
+  const first = list.firstElementChild;
+  const wrap = first && bar && first !== bar && first.contains(bar) ? first : null;
+  if (bar) {
+    bar.setAttribute('style', 'display:flex;gap:8px;flex-wrap:wrap;align-items:center;justify-content:flex-end');
+    for (const b of bar.querySelectorAll('button')) {
+      const k = b.getAttribute('data-r9');
+      b.setAttribute('style', k === 'add' ? BTNP : BTN);
+    }
+    // the board's order: the secondary actions first, the primary action last
+    const add = bar.querySelector('[data-r9="add"]');
+    if (add) bar.appendChild(add);
+    actions.appendChild(bar);
+  }
+  if (wrap) {
+    wrap.setAttribute('style', 'display:flex;flex-direction:column;gap:10px');
+    // the list's closing line has no hook; give it the board's note style
+    for (const k of wrap.children) if (!k.hasAttribute('data-r9')) k.setAttribute('style', NOTE);
+  }
+  for (const row of list.querySelectorAll('[data-r9="entry"],[data-r9="elsewhere"],[data-r9="pending"]')) {
+    row.setAttribute('style', ENTRY);
+    row.setAttribute('data-board-card', row.getAttribute('data-r9'));
+    const [text, meta, btns] = row.children;
+    if (text) text.setAttribute('style', 'display:block;font-size:13px;line-height:1.5;color:var(--foreground)');
+    if (meta) meta.setAttribute('style', 'display:block;font:11px var(--mono);color:var(--muted-foreground)');
+    if (btns) {
+      btns.setAttribute('style', 'display:flex;gap:6px;flex-wrap:wrap');
+      for (const b of btns.querySelectorAll('button')) b.setAttribute('style', SMALL);
+    }
+  }
+  for (const lab of list.querySelectorAll('[data-r9^="usage-"],[data-r9$="-label"]')) {
+    const tone = lab.getAttribute('data-r9') === 'blocked-label' ? ';color:var(--destructive)' : '';
+    lab.setAttribute('style', LBL + tone);
+  }
+  for (const note of list.querySelectorAll('[data-r9="empty"],[data-r9="blocked"]')) note.setAttribute('style', NOTE);
+  const memNote = list.querySelector('[data-r9="note"]');
+  if (memNote) memNote.setAttribute('style', NOTE + ';color:var(--destructive)');
+}
+
+export function renderBoard(inner, ctx) {
+  const { FIXTURE, state } = ctx;
+  const repo = state.product || null;
+
+  const actions = el('div', { 'data-board-part': 'toolbar', style: 'display:flex;gap:8px;flex-wrap:wrap;align-items:center' });
+  const header = el('div', { 'data-board-part': 'header', style: 'display:flex;justify-content:space-between;align-items:flex-end;gap:12px;flex-wrap:wrap' },
+    el('div', null,
+      el('div', { 'data-board-title': '', style: 'font:600 22px var(--sans);line-height:1.45' }, 'Memory'),
+      el('div', { 'data-board-subtitle': '', style: 'color:var(--muted-foreground)' },
+        'Curated notes agents read before they work in ' + (repo || 'this repository'))),
+    actions);
+
+  const list = el('div', { 'data-board-section': 'notes', style: 'display:flex;flex-direction:column;gap:10px;max-width:900px' });
+  ctx.renderMode(list);
+
+  let part = null; let foot = null;
+  if (FIXTURE) part = el('div', { 'data-board-part': 'badges', style: NOTE }, 'The repository memory is not read in the fixture.');
+  else {
+    // read the badges and the approval setting before the bar moves into the header
+    part = badges(list);
+    const appr = list.querySelector('[data-r9="approval"]');
+    if (part) {
+      foot = el('div', { 'data-board-part': 'note', style: NOTE }, appr && /approval on/.test(appr.textContent || '')
+        ? 'You add notes here, and agents propose them. A note an agent proposes waits here until you approve it.'
+        : 'You add notes here, and agents add them too. Turn approval on to keep an agent\u2019s note pending until you approve it.');
+    }
+    restyle(list, actions);
+  }
+
+  inner.appendChild(el('div', { 'data-board': 'memory', style: 'display:flex;flex-direction:column;gap:14px;padding:4px 6px;font-size:13px;line-height:1.5;color:var(--foreground)' },
+    header, part, list, foot));
+}

package/workspace/public/pm/view-portfolio.js

@@ -0,0 +1,153 @@
+/* pm/view-portfolio.js — the All repos view, drawn from planning/design/cockpit-mockup/ViewPortfolio.dc.html.
+ *
+ * PRD workspace-cockpit-nav, Run 3 (R4). The board is a header, a row of counts, one table row per registered repository
+ * and a note. Below it this module places the view's existing list (modes-live.js `portfolioList`: the report bar, the
+ * coverage lines and the initiatives by domain), unchanged, so every `data-r4` / `data-r15` hook and every live behaviour
+ * stays as it was. Only the frame is new.
+ *
+ * Every number comes from GET /api/portfolio, the same read the list uses: a repository's initiatives are the rows the
+ * server returns for it. The board's "Need you" count and column have no cross-repository backing in this app, so they are
+ * not drawn and the note says so. "Last activity" has no backing either; the column shows when each repository's board was
+ * read instead, under that name. Nothing on this board is invented.
+ */
+import { el } from './dom.js';
+import { repoTuples, selectRepo, onAddProduct } from './panel-repos.js';
+import { repoRow } from './fixture.js';
+
+const TTL = 15000;
+let read = null;   // { state: 'loading' | 'ok' | 'error', data, error, at }
+
+/** The board's own read of /api/portfolio: one fetch at a time, read again after 15 seconds, like the list's. */
+function portfolio(setState) {
+  const fresh = read && (read.state === 'loading' || Date.now() - read.at < TTL);
+  if (fresh) return read;
+  const prev = read;
+  read = { state: 'loading', data: prev ? prev.data : null, at: prev ? prev.at : 0 };
+  fetch('/api/portfolio').then((r) => r.json()).then(
+    (data) => { read = { state: data && data.ok === false ? 'error' : 'ok', data, error: data && data.error, at: Date.now() }; setState({}); },
+    (e) => { read = { state: 'error', data: null, error: (e && e.message) || String(e), at: Date.now() }; setState({}); },
+  );
+  return read;
+}
+
+const LBL = 'font:500 10px var(--mono);letter-spacing:.1em;text-transform:uppercase;color:var(--muted-foreground)';
+const BTN = 'font:500 12.5px var(--sans);background:transparent;color:var(--foreground);border:1px solid var(--input);border-radius:8px;padding:0 12px;height:30px;display:inline-grid;place-items:center;cursor:pointer;flex:none';
+const BADGE = 'font:500 11px var(--sans);border:1px solid var(--border);border-radius:999px;padding:0 8px;line-height:18px;white-space:nowrap;display:inline-block';
+const TONE = {
+  w: ';border-color:transparent;background:color-mix(in oklab, var(--warning) 16%, transparent);color:var(--warning)',
+  d: ';border-color:transparent;background:color-mix(in oklab, var(--destructive) 18%, transparent);color:var(--destructive)',
+};
+const TH = 'font:500 10px var(--mono);letter-spacing:.1em;text-transform:uppercase;color:var(--muted-foreground);text-align:left;padding:10px 14px;border-bottom:1px solid var(--border);font-weight:500';
+const TD = 'padding:12px 14px;border-bottom:1px solid var(--border);font-size:13px';
+const NOTE = 'color:var(--muted-foreground);font-size:13px;line-height:1.45';
+
+const badge = (text, tone) => el('span', { style: BADGE + (tone ? TONE[tone] : '') }, String(text));
+
+function stat(label, value, color, key) {
+  return el('div', { 'data-board-stat': key, style: 'flex:1 1 0;min-width:0;border:1px solid var(--border);background:var(--card);border-radius:10px;padding:12px 14px' },
+    el('div', { style: 'color:var(--muted-foreground)' }, label),
+    el('div', { 'data-board-value': key, style: 'font:600 26px var(--sans);line-height:1.45' + (color ? ';color:' + color : '') }, String(value)));
+}
+
+/** Per repository: its rows, counted the way the board's columns say. A row with no derived board has no stage. */
+function countsOf(name, rows) {
+  const mine = rows.filter((x) => x.repo === name);
+  return {
+    all: mine.length,
+    progress: mine.filter((x) => !x.accepted && x.stage).length,
+    blocked: mine.filter((x) => x.blocked === true).length,
+    accepted: mine.filter((x) => x.accepted === true).length,
+  };
+}
+
+/** What the "Board read" cell says: fresh with the time, stale, pending, or not read with the reason. */
+function readCell(rp) {
+  const t = String(rp.as_of || '').slice(11, 16);
+  if (rp.error) return el('span', { style: 'color:var(--destructive)', title: String(rp.error) }, 'not read');
+  if (rp.pending) return el('span', { style: 'color:var(--warning)' }, 'pending');
+  if (rp.stale) return el('span', { style: 'color:var(--warning)' }, 'stale' + (t ? ' · ' + t : ''));
+  return el('span', { style: 'color:var(--muted-foreground)' }, 'fresh' + (t ? ' · ' + t : ''));
+}
+
+function table(pf, ctx) {
+  const rows = pf.rows || [];
+  const kinds = new Map();
+  try { for (const t of repoTuples()) kinds.set(t[0], repoRow(t).kindLabel); } catch { /* no rail yet: kind stays empty */ }
+  const open = (name) => { selectRepo(name); ctx.setState({}); };
+  const head = ['Repository', 'Kind', 'Initiatives', 'In progress', 'Blocked', 'Accepted', 'Board read', ''];
+  const body = (pf.repos || []).map((rp) => {
+    const c = countsOf(rp.name, rows);
+    const staged = !rp.error && !rp.pending;
+    return el('tr', { 'data-board-repo': rp.name, onClick: () => open(rp.name), style: 'cursor:pointer', hover: 'background:var(--accent)', title: 'open the initiatives of ' + rp.name },
+      el('td', { style: TD }, el('b', null, rp.name), rp.domain ? el('span', { style: 'color:var(--muted-foreground);margin-left:6px' }, rp.domain) : null),
+      el('td', { style: TD }, kinds.get(rp.name) ? badge(kinds.get(rp.name)) : el('span', { style: 'color:var(--muted-foreground)' }, '—')),
+      el('td', { style: TD, 'data-board-col': 'initiatives' }, rp.error ? '—' : String(c.all)),
+      // a board that is not derived yet has no stages: say nothing rather than a confident zero
+      el('td', { style: TD, 'data-board-col': 'progress' }, staged ? String(c.progress) : '—'),
+      el('td', { style: TD, 'data-board-col': 'blocked' }, staged ? (c.blocked ? badge(c.blocked, 'd') : '0') : '—'),
+      el('td', { style: TD, 'data-board-col': 'accepted' }, staged ? String(c.accepted) : '—'),
+      el('td', { style: TD, 'data-board-col': 'read' }, readCell(rp)),
+      el('td', { style: TD + ';text-align:right' }, el('button', { style: BTN, hover: 'background:var(--accent)', 'data-board-action': 'open-repo',
+        onClick: (e) => { e.stopPropagation(); open(rp.name); } }, 'Open')));
+  });
+  return el('div', { 'data-board-section': 'repos', style: 'border:1px solid var(--border);border-radius:10px;overflow:hidden;overflow-x:auto' },
+    el('table', { style: 'width:100%;border-collapse:collapse' },
+      el('thead', null, el('tr', null, head.map((h) => el('th', { style: TH }, h)))),
+      el('tbody', null, body.length ? body
+        : el('tr', null, el('td', { colspan: String(head.length), style: TD + ';color:var(--muted-foreground)' }, 'No repository is registered. Add one to see it here.')))));
+}
+
+export function renderBoard(inner, ctx) {
+  const { FIXTURE, setState } = ctx;
+  const r = FIXTURE ? null : portfolio(setState);
+  const pf = (r && r.data) || null;
+  const rows = (pf && pf.rows) || [];
+
+  const addRepo = () => {
+    // the rail's add tile opens the same thing; when the Add repository view exists, open it there instead
+    import('./panel-cockpit.js').then((m) => { if (m.VIEWS && m.VIEWS.addrepo) ctx.openView('addrepo'); else onAddProduct(); })
+      .catch(() => onAddProduct());
+  };
+
+  const header = el('div', { 'data-board-part': 'header', style: 'display:flex;justify-content:space-between;align-items:flex-end;gap:12px;flex-wrap:wrap' },
+    el('div', null,
+      el('div', { 'data-board-title': '', style: 'font:600 22px var(--sans);line-height:1.45' }, 'All repos'),
+      el('div', { style: 'color:var(--muted-foreground)' }, 'Every registered repository, side by side')),
+    el('button', { style: BTN, hover: 'background:var(--accent)', 'data-board-action': 'add-repo', onClick: addRepo }, '+ Add repository'));
+
+  let summary = null; let reposPart = null;
+  if (FIXTURE) {
+    reposPart = el('div', { 'data-board-section': 'repos', style: NOTE }, 'The portfolio is not read in the fixture.');
+  } else if (!pf && r.state === 'error') {
+    reposPart = el('div', { 'data-board-section': 'repos', style: NOTE + ';color:var(--destructive)' }, 'The repositories could not be read: ' + (r.error || 'error') + '.');
+  } else if (!pf) {
+    reposPart = el('div', { 'data-board-section': 'repos', style: NOTE }, 'Reading the repositories …');
+  } else {
+    const blocked = rows.filter((x) => x.blocked === true).length;
+    // in flight = known not accepted; a row whose board is not derived yet is counted apart, never as in flight
+    const unknown = rows.filter((x) => x.accepted === null || x.accepted === undefined).length;
+    const unread = (pf.repos || []).filter((x) => x.error || x.pending).length;
+    summary = el('div', { 'data-board-part': 'summary', style: 'display:flex;gap:14px;flex-wrap:wrap' },
+      stat('Repositories', (pf.repos || []).length, null, 'repos'),
+      stat('Initiatives in flight', rows.filter((x) => x.accepted === false).length, null, 'inflight'),
+      stat('Blocked by a gate', blocked, blocked ? 'var(--destructive)' : null, 'blocked'));
+    if (unknown || unread) {
+      summary = [summary, el('div', { 'data-board-part': 'unread', style: NOTE + ';margin-top:-8px' },
+        (unread ? unread + (unread === 1 ? ' repository is' : ' repositories are') + ' not fully read. ' : '')
+        + (unknown ? unknown + (unknown === 1 ? ' initiative has' : ' initiatives have') + ' no derived stage yet and ' + (unknown === 1 ? 'is' : 'are') + ' not counted above.' : ''))];
+    }
+    reposPart = table(pf, ctx);
+  }
+
+  const note = el('div', { 'data-board-part': 'note', style: NOTE },
+    'Click a row to open that repository\'s initiative list. Counts come from each repository\'s own records. What needs you is not read across repositories here; see Today.');
+
+  // the existing list, kept whole: the report bar, coverage and the initiatives by domain
+  const list = el('div', { 'data-board-section': 'initiatives', style: 'border:1px solid var(--border);border-radius:10px;overflow:hidden;display:flex;flex-direction:column' });
+  ctx.renderMode(list);
+
+  inner.appendChild(el('div', { 'data-board': 'portfolio', style: 'display:flex;flex-direction:column;gap:16px;padding:4px 6px;font-size:13px;line-height:1.45;color:var(--foreground)' },
+    header, summary, reposPart, note,
+    el('div', { style: LBL + ';margin-top:6px' }, 'Initiatives by domain'),
+    list));
+}

package/workspace/public/pm/view-reports.js

@@ -0,0 +1,190 @@
+/* pm/view-reports.js — the Reports view tab, drawn from planning/design/cockpit-mockup/ViewReports.dc.html.
+ *
+ * PRD workspace-cockpit-nav, Run 3 (R5, done-criterion 2). Reports is a new view with no list mode. The board is a header, a row
+ * of five report cards (Daily, Weekly, Bi-weekly, Monthly, Special), a History table and a closing note.
+ *
+ * Every value comes from a read the server already serves:
+ *   - History is the report files in the repository: the `notes` trees of GET /api/library under a reports folder
+ *     (`pmos/state/reports`, `planning/reports`, `reports`). The report skills (report-daily … report-special) write their drafts
+ *     there, one file per period. The kind is the sub-folder, the period is the file's date. Definitions are not reports, so
+ *     they are counted, not listed. A row opens the file as a document tab.
+ *   - A card's schedule is the repository's report schedule in GET /api/schedules?all=1. With one, "Generate" runs it now
+ *     through POST /api/schedules/run (the Scheduled view's "run now"). With none, the card says so and "Set up" opens the
+ *     Scheduled view, where the report schedules and the special report are set up.
+ * The board's "Generated" and "State" columns ("draft, not sent", "marked sent by you") have no backing in this app, so they
+ * are not drawn. In the fixture nothing is read, and the board says so.
+ */
+import { el } from './dom.js';
+
+const BTN = 'font:500 12.5px var(--sans);background:transparent;color:var(--foreground);border:1px solid var(--input);border-radius:8px;padding:0 12px;height:30px;min-height:30px;display:inline-grid;place-items:center;cursor:pointer;flex:none;white-space:nowrap';
+const BTNP = 'font:500 12.5px var(--sans);background:var(--foreground);color:var(--background);border:0;border-radius:8px;padding:0 12px;height:30px;min-height:30px;display:inline-grid;place-items:center;cursor:pointer;flex:none;white-space:nowrap';
+const BADGE = 'font:500 11px var(--sans);border:1px solid var(--border);border-radius:999px;padding:0 8px;line-height:18px;white-space:nowrap;display:inline-block';
+const CARD = 'border:1px solid var(--border);background:var(--background);border-radius:10px;padding:12px 14px;display:flex;flex-direction:column;gap:6px;flex:1 1 0;min-width:150px;box-sizing:border-box';
+const TH = 'font:500 10px var(--mono);letter-spacing:.1em;text-transform:uppercase;color:var(--muted-foreground);text-align:left;padding:10px 14px;border-bottom:1px solid var(--border)';
+const TD = 'padding:11px 14px;border-bottom:1px solid var(--border);font-size:13px;vertical-align:middle';
+const NOTE = 'color:var(--muted-foreground);font-size:13px;line-height:1.5';
+
+/** The five cards. `skill` is the report skill the card runs; `covers` is what that skill says it covers. */
+export const REPORT_KINDS = [
+  { key: 'daily', label: 'Daily', skill: 'report-daily', covers: 'Since the previous daily draft' },
+  { key: 'weekly', label: 'Weekly', skill: 'report-weekly', covers: 'The last 7 days' },
+  { key: 'biweekly', label: 'Bi-weekly', skill: 'report-biweekly', covers: 'The last 14 days' },
+  { key: 'monthly', label: 'Monthly', skill: 'report-monthly', covers: 'The previous calendar month' },
+  { key: 'special', label: 'Special', skill: 'report-special', covers: 'One-off, you say what it is for' },
+];
+const KIND_OF_DIR = { daily: 'daily', weekly: 'weekly', biweekly: 'biweekly', 'bi-weekly': 'biweekly', monthly: 'monthly', special: 'special' };
+const REPORT_DIR = /^(?:pmos\/state\/reports|planning\/reports|reports)$/;
+
+/* ── reads: one per key, read again after 15 seconds, never in a loop ─────────────────────────── */
+const reads = new Map();      // key -> { state: 'loading'|'ok'|'error', data, error, at }
+function read(ctx, key, url) {
+  const hit = reads.get(key);
+  if (hit && (hit.state === 'loading' || Date.now() - hit.at < 15000)) return hit;
+  const next = { state: hit ? hit.state : 'loading', data: hit ? hit.data : null, error: hit ? hit.error : null, at: Date.now() };
+  reads.set(key, next);
+  fetch(url).then((r) => r.json()).then(
+    (d) => { reads.set(key, { state: d && d.ok === false ? 'error' : 'ok', data: d, error: d && d.error, at: Date.now() }); },
+    (e) => { reads.set(key, { state: 'error', data: null, error: (e && e.message) || String(e), at: Date.now() }); },
+  ).finally(() => ctx.setState({}));
+  return next;
+}
+
+let dataMod = null; let dataTried = false;   // the data layer, imported once for wsOf()
+let note = null;    // { tone: 'ok'|'bad', text } — what the last button did
+
+/** Every report file under the repository's report folders, newest first. Definitions are counted apart. */
+export function reportFiles(notes) {
+  const rows = []; let definitions = 0;
+  const walk = (node, base) => {
+    for (const d of node.docs || []) {
+      const rel = String(d.path || '');
+      const under = rel.slice(base.length + 1).split('/');
+      const sub = under.length > 1 ? under[0] : '';
+      if (sub === 'definitions') { definitions++; continue; }
+      const stem = String(d.name || rel.split('/').pop()).replace(/\.[^.]+$/, '');
+      const date = /^\d{4}-\d{2}-\d{2}/.exec(stem);
+      rows.push({ path: rel, name: d.name || stem, kind: KIND_OF_DIR[sub.toLowerCase()] || null, folder: sub || base, period: date ? date[0] : null, stem });
+    }
+    for (const s of node.dirs || []) walk(s, base);
+  };
+  for (const t of notes || []) if (REPORT_DIR.test(String(t.path || ''))) walk(t, String(t.path));
+  rows.sort((a, b) => String(b.period || '').localeCompare(String(a.period || '')) || a.path.localeCompare(b.path));
+  return { rows, definitions };
+}
+
+const kindLabel = (k) => { const r = REPORT_KINDS.find((x) => x.key === k); return r ? r.label + ' report' : 'Report'; };
+const when = (s) => {
+  if (!s) return '';
+  if (s.cadence === 'once') return 'once ' + (s.date || '') + ' ' + (s.time || '');
+  const c = String(s.cadence || '');
+  const on = c === 'weekly' || c === 'bi-weekly' || c === 'biweekly' ? s.day : c === 'monthly' && s.dayOfMonth ? 'day ' + s.dayOfMonth : null;
+  return [c, on, s.time].filter(Boolean).join(' ');
+};
+
+async function generate(ctx, s, label) {
+  note = { tone: 'ok', text: 'starting the ' + label.toLowerCase() + ' report …' }; ctx.setState({});
+  let out;
+  try {
+    out = await fetch('/api/schedules/run', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ id: s.id }) }).then((r) => r.json());
+  } catch (e) { out = { ok: false, error: (e && e.message) || String(e) }; }
+  const r = out && out.result;
+  if (!out || out.ok === false) note = { tone: 'bad', text: (out && out.error) || 'the server did not answer. Nothing was started.' };
+  else if (r && r.ok === false) note = { tone: 'bad', text: 'Not started: ' + (r.reason || 'the server gave no reason') };
+  else if (r && r.sessionId) {
+    note = { tone: 'ok', text: label + ' report started as a session. It is open in the tabs. The draft is filed in this repository.' };
+    try { const ini = await import('./panel-initiatives.js'); ini.openTerm(null, { id: r.sessionId, name: s.name || label + ' report', st: 'working', profile: null }); } catch { /* the note says where it went */ }
+  } else note = { tone: 'ok', text: label + ' report ran. The result is in Needs you.' };
+  reads.delete('schedules');
+  ctx.setState({});
+}
+
+async function openReport(ws, rel) {
+  const ini = await import('./panel-initiatives.js');
+  ini.openDoc(null, rel, 'FILE', ws ? { ws, branch: null, linked: true } : null);
+}
+
+function card(ctx, k, sched, ws) {
+  const parts = [el('b', { 'data-board-card-title': '' }, k.label), el('div', { style: 'color:var(--muted-foreground)' }, k.covers)];
+  let btn;
+  if (k.key === 'special') {
+    parts.push(el('div', { 'data-board-card-sched': '', style: 'font:11.5px var(--mono);color:var(--muted-foreground)' }, 'set up in Scheduled'));
+    btn = el('button', { 'data-board-action': 'describe', style: BTN + ';align-self:flex-start', hover: 'background:var(--accent)', title: 'opens the Scheduled view, where you describe a special report and when it runs', onClick: () => ctx.openView('scheduled') }, 'Describe it');
+  } else if (sched === undefined) {
+    parts.push(el('div', { 'data-board-card-sched': '', style: 'font:11.5px var(--mono);color:var(--muted-foreground)' }, ws ? 'reading the schedules …' : 'no repository selected'));
+  } else if (sched) {
+    parts.push(el('div', { 'data-board-card-sched': '', style: 'font:11.5px var(--mono);color:var(--muted-foreground)' }, 'scheduled · ' + when(sched)));
+    btn = el('button', { 'data-board-action': 'generate', style: BTNP + ';align-self:flex-start', title: 'runs this repository\'s ' + k.skill + ' schedule now', onClick: () => generate(ctx, sched, k.label) }, 'Generate');
+  } else {
+    parts.push(el('div', { 'data-board-card-sched': '', style: 'font:11.5px var(--mono);color:var(--muted-foreground)' }, 'not scheduled here'));
+    btn = el('button', { 'data-board-action': 'setup', style: BTN + ';align-self:flex-start', hover: 'background:var(--accent)', title: 'opens the Scheduled view, where the report schedules are set up', onClick: () => ctx.openView('scheduled') }, 'Set up');
+  }
+  if (btn) parts.push(btn);
+  return el('div', { 'data-board-card': k.key, style: CARD }, parts);
+}
+
+export function renderBoard(inner, ctx) {
+  const { FIXTURE } = ctx;
+  const repo = (ctx.tab && ctx.tab.repo) || ctx.repo || null;
+  let ws = null;
+  if (!FIXTURE) {
+    // the data layer maps the repository to its workspace id; it is imported once, and the board redraws when it is there
+    if (!dataTried) { dataTried = true; import('./data.js').then((m) => { dataMod = m; ctx.setState({}); }).catch(() => {}); }
+    if (dataMod && dataMod.wsOf) ws = dataMod.wsOf(repo);
+    if (!ws && ctx.state && ctx.state.product === repo) ws = ctx.state.wsId || null;
+  }
+
+  // the report schedules for this repository, per skill: undefined = not read yet, null = none
+  const schedOf = {};
+  let lib = null;
+  if (!FIXTURE && ws) {
+    const s = read(ctx, 'schedules', '/api/schedules?all=1');
+    const list = s.state === 'ok' && s.data && Array.isArray(s.data.schedules) ? s.data.schedules : null;
+    for (const k of REPORT_KINDS) schedOf[k.key] = list ? (list.find((x) => x.ws === ws && (x.skill === k.skill || x.task === k.skill)) || null) : undefined;
+    lib = read(ctx, 'library:' + ws, '/api/library?ws=' + encodeURIComponent(ws));
+  }
+
+  const header = el('div', { 'data-board-part': 'header' },
+    el('div', { 'data-board-title': '', style: 'font:600 22px var(--sans);line-height:1.45' }, 'Reports'),
+    el('div', { 'data-board-subtitle': '', style: 'color:var(--muted-foreground)' },
+      'A skill reads the ledgers in a session and writes a draft. Nothing is sent from here.'));
+
+  const cards = el('div', { 'data-board-part': 'cards', style: 'display:flex;gap:12px;flex-wrap:wrap' },
+    REPORT_KINDS.map((k) => (FIXTURE
+      ? el('div', { 'data-board-card': k.key, style: CARD }, el('b', null, k.label), el('div', { style: 'color:var(--muted-foreground)' }, k.covers))
+      : card(ctx, k, schedOf[k.key], ws))));
+
+  const noteEl = note ? el('div', { 'data-board-part': 'run-note', style: NOTE + (note.tone === 'bad' ? ';color:var(--destructive)' : '') }, note.text) : null;
+
+  // History
+  let body; let count = null;
+  if (FIXTURE) body = el('div', { 'data-board-empty': '', style: NOTE + ';padding:14px' }, 'No reports are read here yet. The fixture reads no repository.');
+  else if (!ws) body = el('div', { 'data-board-empty': '', style: NOTE + ';padding:14px' }, 'Select a repository to see its reports.');
+  else if (!lib || (lib.state === 'loading' && !lib.data)) body = el('div', { style: NOTE + ';padding:14px' }, 'Reading the reports …');
+  else if (lib.state === 'error') body = el('div', { style: NOTE + ';padding:14px;color:var(--destructive)' }, 'The reports could not be read: ' + (lib.error || 'error'));
+  else {
+    const { rows, definitions } = reportFiles(lib.data && lib.data.notes);
+    count = { n: rows.length, definitions };
+    if (!rows.length) {
+      body = el('div', { 'data-board-empty': '', style: NOTE + ';padding:14px' },
+        'No report has been written in this repository yet. A report skill files its draft under pmos/state/reports/ or planning/reports/.');
+    } else {
+      body = el('table', { style: 'width:100%;border-collapse:collapse' },
+        el('thead', null, el('tr', null, ['Report', 'Period', 'File', ''].map((h) => el('th', { style: TH }, h)))),
+        el('tbody', null, rows.map((r) => el('tr', { 'data-board-report': r.path },
+          el('td', { style: TD }, el('b', null, kindLabel(r.kind))),
+          el('td', { style: TD }, r.period || el('span', { style: 'color:var(--muted-foreground)' }, 'no date in the name')),
+          el('td', { style: TD + ';font:12px var(--mono);color:var(--muted-foreground);overflow-wrap:anywhere' }, r.path),
+          el('td', { style: TD + ';text-align:right' }, el('button', { 'data-board-action': 'open', style: BTN, hover: 'background:var(--accent)', onClick: () => openReport(ws, r.path) }, 'Open'))))));
+    }
+  }
+  const historyHead = el('div', { style: 'display:flex;align-items:center;gap:10px' },
+    el('div', { style: 'font-weight:600' }, 'History'),
+    count ? el('span', { 'data-board-badge': 'count', style: BADGE }, count.n + (count.n === 1 ? ' report' : ' reports')) : null,
+    count && count.definitions ? el('span', { 'data-board-badge': 'definitions', style: BADGE }, count.definitions + (count.definitions === 1 ? ' definition' : ' definitions')) : null);
+  const history = el('div', { 'data-board-section': 'history', style: 'border:1px solid var(--border);border-radius:10px;overflow:hidden;background:var(--background)' }, body);
+
+  inner.appendChild(el('div', { 'data-board': 'reports', style: 'display:flex;flex-direction:column;gap:16px;padding:4px 6px;font-size:13px;line-height:1.45;color:var(--foreground)' },
+    header, cards, noteEl, historyHead, history,
+    el('div', { 'data-board-part': 'note', style: NOTE }, 'A report opens as a document tab. PMOS does not send reports, and it cannot see what you sent elsewhere.')));
+}
+