create-pmos 0.193.0 → 0.194.0

package/workspace/public/pm/c3-ib-docs.js

@@ -1,6 +1,8 @@
 /* pm/c3-ib-docs.js — the Docs tab of a board (mockup v5, 34-initiatives.js tabDocs / docList / docRow), and the doc helpers the
  * initiative's own Docs tab (c3-ii-tabs.js) shares.
  *   registerBoardTab('docs', (host, ctx) => ...)
+ * CORE  First, the board's core documents (c3-core-docs.js, GET /api/core-docs level=board): the set, its state, Draft it, Review the draft.
+ *       Then "Other documents", the list below.
  * DOCS  The documents of the board's initiatives from the Documents data: GET /api/docs/library (files { path, title, category, date,
  *       initiative }, categories). A file belongs to the board when its `initiative` is one of the board's initiatives (from
  *       loadItems, c3-ini-work.js). Graph nodes (files with `node`) are left out. A search box filters by title, path, type and
@@ -10,8 +12,9 @@
  * Nothing is invented: a board with no linked documents says so. */
 import { el } from './dom.js';
 import { registerBoardTab } from './c3-initiatives.js';
-import { icon, pbtn, lk, chip, tag, st, note, sect, list, empty, nrow, plural, day, ago, parseDay, put } from './c3-ini-ui.js';
+import { icon, pbtn, lk, chip, tag, st, note, sect, list, empty, nrow, plural, day, ago, parseDay, put, cols } from './c3-ini-ui.js';
 import { loadItems } from './c3-ini-work.js';
+import { coreDocs } from './c3-core-docs.js';
 
 const STALE_DAYS = 30;
 /** The documents of the library that belong to the ids: { ok, error, docs: [{ path, name, cat, ty, date, ini, st }] }. */
@@ -36,8 +39,9 @@ async function openDoc(ctx, d, titles) {
   } catch { ctx.toast('The document sheet could not open. The file is ' + d.path + '.'); }
 }
 
-/** The search box and the list of docs. `grouped` false draws one flat list (an initiative's own page). */
-export function renderDocs(host, ctx, docs, order, titles, grouped) {
+/** The search box and the list of docs. `grouped` false draws one flat list (an initiative's own page). `title` names the list ("Other documents"
+ *  beside the core documents; "Documents" by default). */
+export function renderDocs(host, ctx, docs, order, titles, grouped, title) {
   const results = el('div', { 'data-inb': 'docs-list' });
   const input = el('input', { type: 'text', placeholder: 'Search documents', 'aria-label': 'Search documents', 'data-inb': 'docs-search', autocomplete: 'off' });
   const count = el('span', { class: 'dim mono ini-meta', 'data-inb': 'docs-count', 'aria-live': 'polite' });
@@ -51,32 +55,38 @@ export function renderDocs(host, ctx, docs, order, titles, grouped) {
     const shown = docs.filter((d) => !q || (d.name + ' ' + d.path + ' ' + d.ty + ' ' + d.ini + ' ' + (titles.get(d.ini) || '')).toLowerCase().includes(q));
     count.textContent = q ? plural(shown.length, 'document') + ' match' + (shown.length === 1 ? 'es' : '') : plural(docs.length, 'document');
     if (!shown.length) { put(results, empty(q ? 'No document matches "' + input.value.trim() + '".' : 'No documents.', { 'data-inb': 'docs-none' })); return; }
-    if (!grouped) { put(results, sect({ ic: 'doc', title: 'Documents', count: shown.length }, list(shown.map(row)))); return; }
+    if (!grouped) { put(results, sect({ ic: 'doc', title: title || 'Documents', count: shown.length }, list(shown.map(row)))); return; }
     put(results, ...order.filter((id) => shown.some((d) => d.ini === id)).map((id) => {
       const g = shown.filter((d) => d.ini === id);
       return sect({ ic: 'init', title: id + ' ' + (titles.get(id) || ''), count: g.length, attrs: { 'data-inb-docgrp': id }, right: lk({ onclick: () => ctx.openInitiative(id, 'docs'), 'aria-label': 'Open ' + id }, 'Open initiative') }, list(g.map(row)));
     }));
   };
   input.addEventListener('input', draw);
-  put(host, el('div', { class: 'calbar' }, el('div', { class: 'form ini-grow' }, input), count), results);
+  put(host, grouped && title ? el('div', { class: 'sh2 cd-oh', 'data-inb': 'docs-title' }, el('h2', null, icon('doc', 'sm'), title, ' ', el('span', { class: 'bdg g' }, String(docs.length)))) : null,
+    el('div', { class: 'calbar' }, el('div', { class: 'form ini-grow' }, input), count), results);
   draw();
 }
 
 registerBoardTab('docs', async (host, ctx) => {
   let dead = false;
-  put(host, note('Reading the documents'));
+  const other = el('div', { class: 'cd-host', 'data-cd': 'other' }, note('Reading the documents'));
+  const cd = coreDocs({ api: ctx.api, level: 'board', board: ctx.board.id, ws: ctx.ws, today: ctx.today, toast: ctx.toast, scopeLabel: ctx.board.name, boardRow: ctx.board,
+    nav: { tab: (t) => ctx.openBoard(ctx.board.id, t), tool: () => {}, reports: () => ctx.showTab('rep') } });
+  put(host, cols([cd.left, other], cd.right));
+  const stop = () => { dead = true; cd.dispose(); };
   const items = await loadItems(ctx);
-  if (dead) return () => {};
-  if (!items.ok) { put(host, el('div', { class: 'fold w', role: 'alert' }, icon('alert', 'sm'), 'The initiatives of this board could not be read: ' + items.error + '.')); return () => {}; }
+  if (dead) return stop;
+  if (!items.ok) { put(other, el('div', { class: 'fold w', role: 'alert' }, icon('alert', 'sm'), 'The initiatives of this board could not be read: ' + items.error + '.')); return stop; }
   const titles = new Map(items.initiatives.map((r) => [r.id, r.title]));
   const lib = await loadDocs(ctx, new Set(titles.keys()));
-  if (dead) return () => {};
-  if (!lib.ok) { put(host, el('div', { class: 'fold w', role: 'alert' }, icon('alert', 'sm'), 'The documents could not be read: ' + lib.error + '.')); return () => {}; }
+  if (dead) return stop;
+  if (!lib.ok) { put(other, el('div', { class: 'fold w', role: 'alert' }, icon('alert', 'sm'), 'The documents could not be read: ' + lib.error + '.')); return stop; }
+  cd.setIniDocs({ docs: lib.docs.length, initiatives: new Set(lib.docs.map((d) => d.ini)).size });
   if (!lib.docs.length) {
-    put(host, empty(items.initiatives.length ? 'No documents are linked to the initiatives of ' + ctx.board.name + ' yet.' : ctx.board.name + ' has no initiatives, so there are no documents.', { 'data-inb': 'docs-empty' }));
-    return () => { dead = true; };
+    put(other, empty(items.initiatives.length ? 'No other documents are linked to the initiatives of ' + ctx.board.name + ' yet.' : ctx.board.name + ' has no initiatives, so there are no other documents.', { 'data-inb': 'docs-empty' }));
+    return stop;
   }
   const order = [...new Set(lib.docs.map((d) => d.ini))];
-  renderDocs(host, ctx, lib.docs, order, titles, true);
-  return () => { dead = true; };
+  renderDocs(other, ctx, lib.docs, order, titles, true, 'Other documents');
+  return stop;
 });

package/workspace/public/pm/c3-ii-tabs.js

@@ -7,7 +7,9 @@
  *              first and scrolled to. Right: Details (portfolio, board, workflow with Edit, stage, owner, anchor, horizon, lane), Progress,
  *              and links to the board's Backlog, Board and Timeline filtered to this initiative; then its releases.
  *   Breakdown  its epics and items, Jira and PMOS mixed (loadItems), and "Add a PMOS task" (POST /api/boards/tasks/add, epic optional).
- *   Docs       the documents linked to it (GET /api/docs/library), c3-ib-docs.js renderDocs.
+ *   Docs       Left: its core documents by category (Discover, Plan, Do, Learn; c3-core-docs.js, GET /api/core-docs level=initiative): the current one
+ *              lists its rows, a finished or not-yet-reached one folds to one line. Right: what this level is for, the order rules, then "Other documents"
+ *              (the documents linked to it, GET /api/docs/library, c3-ib-docs.js renderDocs).
  *   Tickets    its Jira items: the counts by status and the rows. Read-only: status and dates are Jira's. (Build and deliver only.)
  *   Timeline   epic > item on the HTML timeline, its own bar on top; PMOS bars drag to reschedule, Jira bars are locked.
  *   History    ctx.history: moves, workflow changes, assignments and the accept, with who, when, why and the order warnings.
@@ -18,6 +20,7 @@ import { icon, pbtn, lk, chip, tag, st, note, sect, card, list, empty, cols, hbs
 import { wfOf, catOf, kindOf, tplName, toolLabel, toolIcon, loadItems, dropItems, workRow, workTlRows, iniTlRow, rescheduleTask, lockedToast } from './c3-ini-work.js';
 import { recordCards, recordToolsFor, RECORD_META } from './c3-ini-records.js';
 import { loadDocs, renderDocs } from './c3-ib-docs.js';
+import { coreDocs } from './c3-core-docs.js';
 import { timeline, tlInit, tlRange, tlStill } from './c3-ini-timeline.js';
 import { driverStrip } from './c3-driver.js';
 
@@ -185,14 +188,18 @@ tab('breakdown', async (ctx, isDead, host) => {
 });
 
 /* ── Docs ── */
-tab('docs', async (ctx, isDead) => {
+registerInitiativeTab('docs', async (host, ctx) => {
+  let dead = false;
+  const other = el('div', { class: 'cd-host', 'data-cd': 'other' });
+  const cd = coreDocs({ api: ctx.api, level: 'initiative', board: ctx.board.id, id: ctx.row.id, ws: ctx.ws, today: ctx.today, toast: ctx.toast, scopeLabel: ctx.row.id,
+    nav: { tab: (t) => ctx.openBoard(ctx.board.id, t), tool: (t) => ctx.go({ view: 'ini', board: ctx.board.id, id: ctx.row.id, tab: 'overview', tool: t }), reports: () => ctx.showTab('rep') } });
+  put(host, cols(cd.left, [cd.right, other]));
   const lib = await loadDocs(ctx, new Set([ctx.row.id]));
-  if (isDead()) return null;
-  if (!lib.ok) return errLine('The documents could not be read: ' + lib.error + '.');
-  if (!lib.docs.length) return empty('No documents are linked to ' + ctx.row.id + ' yet.', { 'data-inb': 'docs-empty' });
-  const box = el('div');
-  renderDocs(box, ctx, lib.docs, [ctx.row.id], new Map([[ctx.row.id, ctx.row.title]]), false);
-  return box;
+  if (dead) return () => {};
+  if (!lib.ok) put(other, errLine('The documents could not be read: ' + lib.error + '.'));
+  else if (!lib.docs.length) put(other, empty('No other documents are linked to ' + ctx.row.id + ' yet.', { 'data-inb': 'docs-empty' }));
+  else { const box = el('div'); renderDocs(box, ctx, lib.docs, [ctx.row.id], new Map([[ctx.row.id, ctx.row.title]]), false, 'Other documents'); put(other, box); }
+  return () => { dead = true; cd.dispose(); };
 });
 
 /* ── Jira items ── */

package/workspace/public/pm/c3-initiatives.js

@@ -21,6 +21,7 @@
  *
  * URL STATE  `init=` with history.replaceState, read back on load:
  *   (none)                              Portfolio
+ *   docs                                Portfolio, Documents view (the core documents of the Portfolio)
  *   board:<board>:<tab>[:<filter>]      a board tab; <filter> is a query string (cat=Do&view=risk), each part URI-encoded
  *   ini:<board>:<id>:<tab>[:<tool>]     an initiative tab; <tool> is the tool the Overview shows first
  *
@@ -51,6 +52,7 @@ import { RECORD_META, recordToolsFor } from './c3-ini-records.js';
 import { agentSetting, loadAgentMode, MODES as AGENT_MODES } from './c3-driver.js';
 import { scanPortfolioSection, scanPointer } from './c3-scan-setup.js';
 import { lifeBanner, pageMenu, ensureLifeCss } from './c3-ini-life.js';
+import { coreDocs, segBadge } from './c3-core-docs.js';
 
 export { btn, geo };
 export { TEMPLATES, CATS };
@@ -88,12 +90,14 @@ export function parseLoc(s) {
   const p = String(s || '').split(':').map(dec);
   if (p[0] === 'board' && p[1]) return { view: 'board', board: p[1], tab: BOARD_IDS.includes(p[2]) ? p[2] : 'summary', filter: p[3] ? Object.fromEntries(new URLSearchParams(p[3])) : {} };
   if (p[0] === 'ini' && p[1] && p[2]) return { view: 'ini', board: p[1], id: p[2], tab: INI_IDS.includes(p[3]) ? p[3] : 'overview', tool: p[4] || '' };
+  if (p[0] === 'docs') return { view: 'portfolio', tab: 'docs' };
   return { view: 'portfolio' };
 }
 /** The inverse of parseLoc; '' for the Portfolio. */
 export function formatLoc(loc) {
   const e = encodeURIComponent;
-  if (!loc || loc.view === 'portfolio' || !loc.board) return '';
+  if (loc && loc.view === 'portfolio') return loc.tab === 'docs' ? 'docs' : '';
+  if (!loc || !loc.board) return '';
   if (loc.view === 'board') {
     const f = Object.entries(loc.filter || {}).filter(([, v]) => v !== '' && v != null);
     return ['board', e(loc.board), e(loc.tab || 'summary')].join(':') + (f.length ? ':' + e(new URLSearchParams(f).toString()) : '');
@@ -154,6 +158,7 @@ export function mountInitiatives(pane, opts) {
   }
   function go(loc) {
     const l = { ...(loc || { view: 'portfolio' }) };
+    if (l.view === 'portfolio') l.tab = l.tab === 'docs' ? 'docs' : 'overview';
     if (l.view === 'board') { l.tab = BOARD_IDS.includes(l.tab) ? l.tab : 'summary'; l.filter = l.filter || {}; }
     if (l.view === 'ini') { l.tab = INI_IDS.includes(l.tab) ? l.tab : 'overview'; l.tool = l.tool || ''; }
     P.loc = l; writeUrl(); draw();
@@ -161,7 +166,7 @@ export function mountInitiatives(pane, opts) {
   const openBoard = (id, tab, filter) => go({ view: 'board', board: id, tab: tab || 'summary', filter: filter || {} });
   const refresh = () => { P.boards = null; P.ini = null; dropItems(); draw(); };
   // The Briefing's Horizon scan card opens a board's Triage or settings (c3-scan.js goBoard). A page that is not built yet reads the address instead.
-  if (typeof window !== 'undefined') { if (window.__iniGo) window.removeEventListener('pmos:ini-go', window.__iniGo); window.__iniGo = (e) => { const d = (e && e.detail) || {}; if (d.board && root.isConnected) openBoard(d.board, d.tab || 'summary'); }; window.addEventListener('pmos:ini-go', window.__iniGo); }
+  if (typeof window !== 'undefined') { if (window.__iniGo) window.removeEventListener('pmos:ini-go', window.__iniGo); window.__iniGo = (e) => { const d = (e && e.detail) || {}; if (d.loc != null && root.isConnected) go(parseLoc(d.loc)); else if (d.board && root.isConnected) openBoard(d.board, d.tab || 'summary'); }; window.addEventListener('pmos:ini-go', window.__iniGo); }
   const redraw = () => draw();
 
   async function loadBoards() {
@@ -232,7 +237,26 @@ export function mountInitiatives(pane, opts) {
   }
 
   /* ════════ PORTFOLIO ════════ */
+  /** Overview | Documents, under the breadcrumb of the Portfolio. */
+  function pfTabs(cur, badge) {
+    return segTabs([['overview', 'Overview', 'cols'], ['docs', 'Documents', 'doc', badge]], cur, (k) => go(k === 'docs' ? { view: 'portfolio', tab: 'docs' } : { view: 'portfolio' }), 'Portfolio views', { 'data-ini': 'pf-tabs' });
+  }
+  const setBadge = (badge, r) => { const n = r && r.summary ? (Number(r.summary.draft) || 0) + (Number(r.summary.due) || 0) : 0; badge.textContent = String(n); badge.hidden = !n; };
+  /** The Portfolio's Documents view: its core set, the question it answers and the drafts waiting (c3-core-docs.js). */
+  function drawPortfolioDocs(boards, token) {
+    const asks = boards.reduce((n, b) => n + (Number(b.asks) || 0), 0);
+    const total = boards.reduce((n, b) => n + ((b.counts || {}).total || 0), 0);
+    const badge = segBadge(0);
+    const lhHost = el('div', { class: 'cd-host' });
+    const cd = coreDocs({ api: pageApi, level: 'portfolio', ws: opts.ws || (boards[0] && boards[0].ws) || '', today: P.today, toast, nav: { reports: () => (opts.showTab || (() => {}))('rep'), tab: () => {}, tool: () => {} },
+      onData: (r) => { setBadge(badge, r); put(lhHost, lh('doc', 'Portfolio documents', PORTFOLIO + ': the documents leadership reads to judge the bets. ' + (r.docs.filter((d) => d.st === 'draft').length ? plural(r.docs.filter((d) => d.st === 'draft').length, 'draft') + ' to review, ' : '') + r.docs.filter((d) => d.st === 'due').length + ' due.')); } });
+    P.dispose = () => cd.dispose();
+    put(root, pathCrumbs(null, null, el('div', { class: 'chips2' }, mono(plural(boards.length, 'board') + ' · ' + plural(total, 'initiative') + ' · ' + plural(asks, 'new ask')), pbtn('primary', 'New board', 'plus', { 'data-ini': 'new-board', onclick: () => openNewBoard() }))),
+      pfTabs('docs', badge),
+      el('div', { class: 'calbody', 'data-ini': 'pf-docs' }, lhHost, cols(cd.left, cd.right)));
+  }
   async function drawPortfolio(boards, token) {
+    if (P.loc.tab === 'docs') return drawPortfolioDocs(boards, token);
     const asks = boards.reduce((n, b) => n + (Number(b.asks) || 0), 0);
     const total = boards.reduce((n, b) => n + ((b.counts && b.counts.total) || 0), 0);
     const bad = boards.filter((b) => b.health === 'bad'); const warn = boards.filter((b) => b.health === 'warn');
@@ -251,9 +275,12 @@ export function mountInitiatives(pane, opts) {
         askBoards.length ? chgl(askBoards.map((b) => el('li', null, icon('inbox', 'sm'), lk({ onclick: () => openBoard(b.id, 'triage'), 'data-ini-asks': b.id }, b.name), el('span', { class: 'tag' }, plural(Number(b.asks), 'new ask')))))
           : note('No new asks on any board.')),
     ];
+    const badge = segBadge(0);
+    pageApi.get('/api/core-docs', { level: 'portfolio' }).then((r) => { if (token === P.seq) setBadge(badge, r); }, () => {});
     put(root, 
       pathCrumbs(null, null, el('div', { class: 'chips2' }, mono(plural(boards.length, 'board') + ' · ' + plural(total, 'initiative') + ' · ' + plural(asks, 'new ask')),
         pbtn('primary', 'New board', 'plus', { 'data-ini': 'new-board', onclick: () => openNewBoard() }))),
+      pfTabs('overview', badge),
       el('div', { class: 'calbody', 'data-ini': 'portfolio' },
         lh('cols', sentenceOf(bad, warn), PORTFOLIO + ': boards hold initiatives, initiatives hold epics, epics hold stories, tasks and bugs. Stages roll up into Discover, Plan, Do and Learn so boards compare.'),
         // The Horizon scan runs for the whole portfolio (c3-scan-setup.js): its section is here, with Scan now always visible. Not in demo mode.

package/workspace/server.js

@@ -2598,7 +2598,19 @@ const reportFinderTick = () => {
   const t = process.env.PMOS_REPORT_FIND_NOW ? Date.parse(process.env.PMOS_REPORT_FIND_NOW) : NaN;
   try { reportFinder.tick(Number.isFinite(t) ? { now: t } : {}); } catch (e) { warnWriteFail('report finder tick', e); }
 };
-try { const _tick = setInterval(() => { checkDueSchedules(); proactiveTick(); try { prepareTick({ manual: false }); } catch { /* the next tick tries again */ } try { dayTick(); } catch (e) { warnWriteFail('day run tick', e); } autoSync.tick().catch(() => {}); dashboardScheduleTick(); driverTick(); scanTick(); reportFinderTick(); }, TICK_MS); if (_tick.unref) _tick.unref(); } catch {}
+// core-documents: every 30 minutes inside the working hours, ONE headless run per due core document of the portfolio and of each board
+// (at most 3 at once, once per document per day, never one the PM writes). The run writes a draft with `pmos coredoc write`; nothing is sent.
+// PMOS_CORE_DOCS_NOW (a local date-time) fixes its clock for the suites.
+const coreDocsTick = () => {
+  let m; try { m = require('./lib/routes-core-docs.js'); } catch { return; }
+  const t = process.env.PMOS_CORE_DOCS_NOW ? Date.parse(process.env.PMOS_CORE_DOCS_NOW) : NaN;
+  try {
+    m.tick({ getWs, stateDirFor, workspaceList: () => [...workspaces.values()], runtimeDir: STATE, selfRoot: EMBEDDED_SELF ? SELF_ROOT : null, initiativeIndex,
+      spawnSession, stopSession: (id) => { const x = sessions.get(String(id || '')); if (x && x.child) stopHeadless(x); }, invalidateNeedsAgg,
+      proSettings, inQuiet: (now, quiet) => proactiveLib.inQuietHours(now, quiet), isLead: (w) => isPlanNeedsTree(w) }, Number.isFinite(t) ? { now: t } : {});
+  } catch (e) { warnWriteFail('core documents tick', e); }
+};
+try { const _tick = setInterval(() => { checkDueSchedules(); proactiveTick(); try { prepareTick({ manual: false }); } catch { /* the next tick tries again */ } try { dayTick(); } catch (e) { warnWriteFail('day run tick', e); } autoSync.tick().catch(() => {}); dashboardScheduleTick(); driverTick(); scanTick(); reportFinderTick(); coreDocsTick(); }, TICK_MS); if (_tick.unref) _tick.unref(); } catch {}
 
 // ── Sessions: real PTYs, owned by the server, with disk-backed scrollback + metadata. ──
 /** @type {Map<string, {id,ws,name,agent,cwd,state,note,created,pty,buf,cols,rows,clients:Set}>} */
@@ -3637,7 +3649,8 @@ function spawnSession({ name, agent, cwd, ws, origin, initialInput, profile, ini
   Object.assign(penv, itemEnv);
   // horizon-scan: the scan runs set PMOS_SCAN_FILE, PMOS_SCAN_ORIGIN and PMOS_SCAN_RUN for `pmos scan file`; the report-setup and report-find runs
   // (report-workspace) set PMOS_REPORT_FILE and PMOS_REPORT_RUN for `pmos report propose`; nothing else is added.
-  if (extraEnv && typeof extraEnv === 'object') for (const k of ['PMOS_SCAN_FILE', 'PMOS_SCAN_ORIGIN', 'PMOS_SCAN_RUN', 'PMOS_REPORT_FILE', 'PMOS_REPORT_RUN']) if (typeof extraEnv[k] === 'string') penv[k] = extraEnv[k];
+  // core-documents: a core-doc run sets PMOS_CORE_DOC_SCOPE and PMOS_CORE_DOC_KEY, the one entry `pmos coredoc write` may write.
+  if (extraEnv && typeof extraEnv === 'object') for (const k of ['PMOS_SCAN_FILE', 'PMOS_SCAN_ORIGIN', 'PMOS_SCAN_RUN', 'PMOS_REPORT_FILE', 'PMOS_REPORT_RUN', 'PMOS_CORE_DOC_SCOPE', 'PMOS_CORE_DOC_KEY']) if (typeof extraEnv[k] === 'string') penv[k] = extraEnv[k];
   const base = { id, ws: w ? w.id : wsId(SELF_ROOT), root, name: (name && String(name).trim()) || agent, agent, origin: tag,
     profile: pres.id, profileRefusal: pres.ok ? null : pres.error };
   // Hand to agent: the breakdown item this session was started for, or null. Set only by /api/plan-items/handoff/go.

package/workspace/skills/initiative-drive.skill

@@ -15,7 +15,7 @@ output:
 The prompt that starts this run names the target, the reason the run started, the stage category and what the PM already kept. Work on that target only.
 
 Rules that always hold:
-1. THE ONLY WRITE is `pmos driver propose`. You have no Write and no Edit tool. Do not change a repository file, do not commit, do not push, and do not move the initiative to another stage. Keeping a proposal is the PM's act, not yours.
+1. THE ONLY WRITES are `pmos driver propose` and `pmos coredoc write` (a draft of a core document of this initiative, nothing else). You have no Write and no Edit tool. Do not change a repository file, do not commit, do not push, and do not move the initiative to another stage. Keeping a proposal is the PM's act, not yours.
 2. SEND NOTHING. Never send, reply, forward, post, comment, react, create, transition or label anything in mail, Slack, Jira, Confluence, GitHub, Drive, Figma or any other source. Read a connector only where it is already allowed. If a tool is refused, say so in your answer and go on without it.
 3. EVERY CLAIM CARRIES A POINTER. A pointer is a Jira key, a Slack link, a meeting note path, a requirement note path or a document path. Give it with `--source label=ref`. A claim you cannot point at is not a claim: leave it out. A proposal of the kind evidence, sizing, assumption or stakeholders is refused without a pointer.
 4. NOTHING INVENTED. Write only what you read. Say "not known" and name who could tell you. A run that finds nothing new is a correct run: file nothing.
@@ -26,7 +26,7 @@ Rules that always hold:
 Procedure:
 1. Orient. Run `pmos driver status initiative <id>`. Read the initiative record (`planning/initiatives/<id>.md`, or `pmos/state/initiatives/<id>.md`) and every file it names: PRD, brief, requirement notes. Run `pmos initiative list` to see the other open initiatives.
 2. Check first for a prior rejection and a duplicate. Search `planning/out-of-scope/` for the idea (Grep on its key words). Compare the title and the intent with the other open initiatives. If you find a match, file a `note` proposal first that names the file or the initiative, quotes what it says in one line, and says why this one is the same or different. Then stop unless the match is weak.
-3. Find the stage category in the prompt. For Plan, Do and Learn, go to step 5. For Discover, do step 4.
+3. Find the stage category in the prompt. When the prompt names core documents of this stage that are due or stale, do step 8 first. For Plan, Do and Learn, go to step 5. For Discover, do step 4.
 4. Discover, in this order. Skip any step already kept.
    a. Problem statement. One paragraph: who has the problem, what it is, what it costs them. File `--what problem` with `--data "<the paragraph>"`. Give at least one source when you have one.
    b. Evidence. Every source that supports or contradicts the problem: a Jira key, a Slack thread, a meeting note, a requirement note, a document. For each one, a pointer and one line on what it says. File `--what evidence` with a JSON file: `{"items": [{"text": "<one line>", "ref": "<pointer>", "stance": "supports|contradicts"}]}` and one `--source label=ref` for each pointer. Look for contradicting evidence as hard as for supporting evidence.
@@ -43,6 +43,10 @@ Procedure:
    `pmos driver propose initiative <id> --what evidence --file /tmp/evidence.json --why "<one line: why the PM needs this>" --source "Jira DISC-12=https://…" --source "Meeting note=notes/2026-10-08.md"`
    Write the JSON or text file in the scratch folder of this session. If `pmos driver propose` refuses, read the reason, fix the proposal and file it once more. Do not work around a refusal.
 7. Finish with the output contract. Do not repeat the proposals in full.
+8. Core documents of this stage (due or stale, named in the prompt). For each one: read its sources (the record, the files it names, the Jira snapshot, the notes that name the initiative), write the document once with
+   `pmos coredoc write --scope initiative:<id> --key <key> --file - <<'PMOS_DOC'` … `PMOS_DOC` (the document on standard input; every fact with its source in brackets; "not known" where no source says), then file it:
+   `pmos driver propose initiative <id> --what doc --data '{"key":"<key>","slot":"<the slot it printed>"}' --why "<one line>"`.
+   The PM's Keep issues the draft. While a document of this stage is due, do not propose a stage move: `pmos driver propose` refuses it.
 
 Output contract — produce EXACTLY these sections in your final message:
 - Filed (the proposal ids and their kinds, or "nothing new")

package/workspace/test-lists/c3-core-docs.json

@@ -0,0 +1,9 @@
+{
+  "_comment": "c3-core-docs: the core documents of each level (Portfolio Documents, a board's Docs tab, an initiative's Docs tab), Draft it, Review the draft, Issue it, the Briefing row and 400 px, in demo mode (browser).",
+  "panels": [
+    "c3-core-docs-test.js"
+  ],
+  "seconds": {
+    "c3-core-docs-test.js": 40
+  }
+}

package/workspace/test-lists/core-documents-backend.json

@@ -0,0 +1,5 @@
+{
+  "_comment": "core-documents backend: the sets, state, store, CLI, run, tick and needs rows in process, and the core-docs routes on a real server with a stub claude.",
+  "modules": ["core-docs.test.js", "core-docs-server.test.js"],
+  "seconds": { "core-docs.test.js": 4, "core-docs-server.test.js": 12 }
+}