create-pmos 0.153.0 → 0.155.0

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

@@ -21,6 +21,7 @@ import { el } from './dom.js';
 import { c3ic } from './pm-work-view.js';
 import { button, ensureComponentsCss } from './primitives.js';
 import { toast } from './c3-toast.js';
+import { pmPost } from './http.js';
 import { notesView, openNote, noteOfEvent, primeNotes } from './c3-notes.js';   // Calendar › Notes (initiative c3-notes-place)
 import { onNotes } from './notes-links.js';
 
@@ -36,7 +37,8 @@ const KIND = {
 };
 const RANK = { milestone: 0, release: 1, report: 2, due: 3, own: 4 };
 const TONE = { bad: 'Late or at risk of missing', warn: 'At risk', ok: 'On track' };
-const REF = { initiative: 'Open the initiative', 'plan-item': 'Open the initiative', item: 'Open in Work', release: 'Open the release', report: 'Open in Reports' };
+const REF = { initiative: 'Open the initiative', 'plan-item': 'Open the initiative', item: 'Open in Work', release: 'Open the release', report: 'Open in Reports',
+  jira: 'Open the sprint', ask: 'Open in Triage', portfolio: 'Open the Portfolio' };
 const CTXWORD = { decision: 'Decision', action: 'Action', moved: 'Moved', prepared: 'Prepared', todo: 'To prepare' };
 const NO_SUGGESTION = 'Free, nothing specific to suggest';
 /* the tidy-up suggestions (lib/calendar-tidy.js): the severity groups in order, and each rule in words */
@@ -528,6 +530,8 @@ function openRef(ui, ref, extra) {
   if (ref.type === 'initiative') { if (!h.goInitiative(ref.id)) h.openInit(host, r, ref.id, extra.title); return; }
   if (ref.type === 'plan-item' || ref.type === 'release') { const ini = extra.initiative || ref.initiative; if (!(ini && h.goInitiative(ini))) h.gotoTab('init'); return; }
   if (ref.type === 'item') { h.gotoTab('work'); return; }
+  if (ref.type === 'jira' || ref.type === 'ask') { openBoardTab(ui, ref.board, ref.type === 'jira' ? 'sprints' : 'triage'); return; }
+  if (ref.type === PORTFOLIO) { openBoardTab(ui, null); return; }
   if (ref.type === 'report') h.gotoTab('rep');
 }
 
@@ -585,7 +589,8 @@ function meetingDetail(ui, hit) {
   else if (past) body = [list(['decision', 'action'], 'What came out of it', 'out', 'No decision or action is recorded.'), list(['moved'], 'What moved after it', 'moved', 'Nothing moved within 48 hours that refers to it.')];
   else body = upcomingBody(ui, rec, items);
   const b = !past && rec && rec.brief ? rec.brief : null;
-  const iniId = typeof e.initiative === 'string' ? e.initiative : b && b.initiative ? b.initiative.id : null;
+  const lv = !past && rec ? rec.level || null : null;
+  const iniId = lv && lv.kind !== 'initiative' ? null : typeof e.initiative === 'string' && !(lv && lv.by === 'pm') ? e.initiative : b && b.initiative ? b.initiative.id : null;
   const iniTitle = iniId ? (b && b.initiative && b.initiative.id === iniId && b.initiative.title) || (((ui.d.gantt || []).find((g) => g.id === iniId) || {}).title) || iniId : null;
   const iniStatus = b && b.initiative && b.initiative.id === iniId ? b.initiative.status : (((ui.d.gantt || []).find((g) => g.id === iniId) || {}).status || null);
   const sources = b && b.sources && b.sources.length ? 'Put together from ' + listWords(b.sources) + '. Each line opens its source. ' : '';
@@ -596,6 +601,7 @@ function meetingDetail(ui, hit) {
     el('div', { class: 'chips2', 'data-cal3': 'meeting-chips' }, homeChip('Calendar'), ...peopleOf(e).map((n) => el('span', { class: 'tag', 'data-cal3': 'person' }, n)),
       iniId ? el('span', { class: 'tag', 'data-cal3': 'meeting-initiative' }, 'Initiative: ' + iniTitle) : null,
       iniStatus && STATUS_TONE[iniStatus] ? el('span', { class: 'tag cal3-tone-' + STATUS_TONE[iniStatus] }, iniStatus) : null),
+    past || !M.ctx ? null : levelRow(ui, e, lv),
     noteLink(ui, e),
     ...body,
     el('p', { class: 'dim cal3-note', 'data-cal3': past ? 'past-note' : 'sources' }, past ? 'Only what PMOS holds a record for: items created or closed within 48 hours of the meeting. Each line opens its source.' : sources + 'PMOS proposes changes. It never edits your calendar.'),
@@ -611,13 +617,106 @@ const ctxBox = (key, title, ...kids) => el('div', { class: 'cal3-ctx', 'data-cal
 const ul = (rows) => el('ul', { class: 'cal3-cl', role: 'list' }, ...rows);
 const ci = (attrs, ...kids) => el('li', { class: 'cal3-ci', ...attrs }, ...kids);
 
+/* ── what a meeting is about: the Portfolio, a board or an initiative (initiative c3-meeting-board) ──
+ * The switch says which level the card reads and why PMOS chose it (lib/calendar-layers.js levelOf). Pressing a level links every
+ * occurrence of the meeting to it (POST /api/calendar-links); Board and Initiative ask which one when there is more than one. */
+// the meeting's level, not the old initiative list's Portfolio mode (cuts.test.js keeps that mode out)
+const PORTFOLIO = 'portfolio';
+const LEVELS = [[PORTFOLIO, 'Portfolio', 'Read every board'], ['board', 'Board', 'Read one board and its sprint'], ['initiative', 'Initiative', 'Read one initiative']];
+const linkPick = new Map();   // event id → the level whose picker is open
+
+function levelRow(ui, e, lv) {
+  const open = linkPick.get(e.id) || null;
+  const seg = el('div', { class: 'seg cal3-lvseg', role: 'group', 'aria-label': 'This meeting is about', 'data-cal3': 'level' },
+    ...LEVELS.map(([k, label, title]) => { const x = button({ variant: 'ghost', attrs: { class: 'cal3-b', 'aria-pressed': String(!!lv && lv.kind === k), 'data-cal3-level': k, title },
+      onClick: () => pickLevel(ui, e, lv, k) }); x.replaceChildren(el('span', null, label)); return x; }));
+  const what = !lv ? 'Not linked yet. Pick a level and PMOS reads it before the meeting.'
+    : lv.kind === PORTFOLIO ? 'Reads every board, linked because ' + lv.why + '.'
+    : lv.kind === 'board' ? 'Reads the ' + (lv.name || lv.id) + ' board and its sprint, linked because ' + lv.why + '.'
+    : 'Reads ' + (lv.name || lv.id) + ', linked because ' + lv.why + '.';
+  const unlink = lv && lv.by === 'pm' ? el('a', { href: '#', class: 'cal3-ref', 'data-cal3': 'unlink', onClick: (ev) => { ev.preventDefault(); saveLink(ui, e, { kind: 'none' }, 'The link is removed.'); } }, 'Unlink') : null;
+  return el('div', { class: 'cal3-level', 'data-cal3-ctx': 'level', 'data-cal3-level-by': lv ? lv.by : 'none' }, seg, el('span', { class: 'dim cal3-note' }, what), unlink, open ? pickerOf(ui, e, open) : null);
+}
+
+function pickLevel(ui, e, lv, kind) {
+  if (lv && lv.kind === kind && lv.by === 'pm' && kind === PORTFOLIO) return;
+  if (kind === PORTFOLIO) { saveLink(ui, e, { kind }, 'This meeting now reads every board.'); return; }
+  const choices = choicesOf(ui, kind);
+  if (choices.length === 1) { saveLink(ui, e, linkBody(kind, choices[0]), 'This meeting now reads ' + choices[0].name + '.'); return; }
+  linkPick.set(e.id, linkPick.get(e.id) === kind ? null : kind);
+  ui.redraw();
+}
+
+const choicesOf = (ui, kind) => kind === 'board' ? (ui.d.link_boards || []).map((b) => ({ ws: b.ws, id: b.id, name: b.name }))
+  : (ui.d.gantt || []).filter((g) => g && g.id).map((g) => ({ id: g.id, name: g.title || g.id }));
+const linkBody = (kind, c) => kind === 'board' ? { kind, ws: c.ws, board: c.id, title: c.name } : { kind, initiative: c.id, title: c.name };
+
+function pickerOf(ui, e, kind) {
+  const choices = choicesOf(ui, kind);
+  if (!choices.length) return el('span', { class: 'dim cal3-note', 'data-cal3': 'level-none' }, kind === 'board' ? 'No board to link yet.' : 'No initiative to link in this range.');
+  const sel = el('select', { 'aria-label': kind === 'board' ? 'Pick the board' : 'Pick the initiative', 'data-cal3': 'level-pick',
+    onChange: () => { const c = choices[Number(sel.value)]; if (c) saveLink(ui, e, linkBody(kind, c), 'This meeting now reads ' + c.name + '.'); } },
+    el('option', { value: '' }, kind === 'board' ? 'Pick the board' : 'Pick the initiative'), ...choices.map((c, i) => el('option', { value: String(i) }, c.name)));
+  return sel;
+}
+
+async function saveLink(ui, e, body, said) {
+  linkPick.delete(e.id);
+  let r = null;
+  try { r = await pmPost('/api/calendar-links', { event: { title: e.title || e.id, series: e.series || null }, ...body }); } catch (err) { r = { ok: false, error: String((err && err.message) || err) }; }
+  if (!r || !r.ok) { toast('The link was not saved: ' + ((r && r.error) || 'no answer') + '.'); ui.redraw(); return; }
+  toast(said);
+  ui.h.go(ui.host, ui.r, {});
+}
+
+/* the sprint's days left in words: working days after today up to its end */
+function sprintLeft(h, end, today) {
+  if (!end) return '';
+  if (end < today) return 'ended ' + h.dayLabel(end);
+  let n = 0;
+  for (let t = new Date(today + 'T12:00:00Z').getTime() + 86400000; ; t += 86400000) {
+    const d = new Date(t).toISOString().slice(0, 10); if (d > end) break;
+    const w = new Date(t).getUTCDay(); if (w > 0 && w < 6) n++;
+  }
+  return (n === 0 ? 'last day' : plural(n, 'working day') + ' left') + ', ends ' + h.dayLabel(end);
+}
+
+const HEALTH = { ok: ['', 'On track'], warn: ['warn', 'Needs attention'], bad: ['bad', 'Off track'] };
+
+function boardParts(ui, b) {
+  const { h } = ui;
+  const out = [];
+  if (b.boards && b.boards.length) out.push(ctxBox('boards', [c3ic('cols', 'sm'), 'Boards'], ul(b.boards.map((x) => {
+    const [tone, word] = HEALTH[x.health] || ['', 'Not read'];
+    return ci({ 'data-cal3-board': x.id }, el('span', { class: 'tag' + (tone ? ' cal3-tone-' + tone : '') }, word), el('span', { class: 'cal3-ct' }, x.name), el('span', { class: 'dim mono cal3-at' }, x.line),
+      el('a', { href: '#', class: 'cal3-ref', title: 'Open the board: ' + x.name, onClick: (ev) => { ev.preventDefault(); openBoardTab(ui, x.id, 'summary'); } }, c3ic('out', 'sm'), 'Open the board'));
+  }))));
+  if (b.sprint) {
+    const sp = b.sprint; const c = sp.counts || { todo: 0, doing: 0, done: 0 };
+    out.push(ctxBox('sprint', [c3ic('cols', 'sm'), sp.name, el('span', { class: 'dim mono cal3-h4r' }, sprintLeft(h, sp.end, ui.d.today || ''))],
+      el('div', { class: 'cal3-bar', role: 'img', 'aria-label': c.done + ' done, ' + c.doing + ' in progress, ' + c.todo + ' to do' },
+        setVar(el('i', { class: 'd' }), 'n', c.done), setVar(el('i', { class: 'p' }), 'n', c.doing), setVar(el('i', { class: 't' }), 'n', c.todo)),
+      el('div', { class: 'chips2 dim mono cal3-counts' }, el('span', null, c.done + ' done'), el('span', null, c.doing + ' in progress'), el('span', null, c.todo + ' to do'),
+        b.next ? el('span', { 'data-cal3': 'next-sprint' }, '· ' + b.next.name + ': ' + b.next.planned + ' planned, ' + b.next.carry + ' may carry over') : null)));
+  }
+  return out;
+}
+
+/* a board's home on Initiatives: the page reads ?init= when it opens (c3-initiatives.js parseLoc) */
+function openBoardTab(ui, board, tab) {
+  try { const u = new URL(location.href); u.searchParams.set('init', board ? 'board:' + encodeURIComponent(board) + ':' + tab : ''); if (!board) u.searchParams.delete('init'); history.replaceState(history.state, '', u); } catch { /* no history */ }
+  ui.h.gotoTab('init');
+}
+
 function upcomingBody(ui, rec, items) {
   const { h } = ui;
   const b = rec && rec.brief ? rec.brief : null;
+  const lv = rec && rec.level ? rec.level : null;
   const prep = items.filter((x) => x.kind === 'prepared' || x.kind === 'todo');
   const out = [];
   if (b && b.gist && b.gist.length) out.push(el('div', { class: 'cal3-ctx cal3-gist', 'data-cal3-ctx': 'gist' }, el('h4', null, c3ic('spark', 'sm'), 'In short'), el('p', { class: 'cal3-p' }, b.gist.join(' '))));
-  if (b && b.matters && b.matters.length) out.push(ctxBox('matters', 'What matters today', ul(b.matters.map((x) => ci({ 'data-cal3-matter': x.tag },
+  if (b) out.push(...boardParts(ui, b));
+  if (b && b.matters && b.matters.length) out.push(ctxBox('matters', b.planning ? 'To settle in planning' : 'What matters today', ul(b.matters.map((x) => ci({ 'data-cal3-matter': x.tag },
     el('span', { class: 'tag cal3-tone-' + x.tone }, x.tag), el('span', { class: 'cal3-ct' }, x.text), x.meta ? el('span', { class: 'dim mono cal3-at' }, x.meta) : null,
     refLink(ui, x.ref, { initiative: x.ref.initiative, title: x.text }))))));
   if (b && b.last) {
@@ -643,11 +742,11 @@ function upcomingBody(ui, rec, items) {
     ...(b.links || []).map((l) => el('a', { class: 'chip2', href: l.url, target: '_blank', rel: 'noopener noreferrer' }, c3ic('out', 'sm'), l.label)),
     ...(b.refs || []).map((r) => r.link ? el('a', { class: 'chip2', href: r.link, target: '_blank', rel: 'noopener noreferrer' }, c3ic('out', 'sm'), r.label, r.source ? el('span', { class: 'dim' }, ' ' + r.source) : null)
       : el('span', { class: 'chip2' }, r.label, r.source ? el('span', { class: 'dim' }, ' ' + r.source) : null))));
-  const noIni = !(b && b.initiative); const noLast = !(b && b.last);
+  const noIni = !lv; const noLast = !(b && b.last);
   if (noIni || noLast) {
-    const missing = noIni && noLast ? 'No initiative is linked and there is no earlier note from this meeting.' : noIni ? 'No initiative is linked to this meeting.' : 'There is no earlier note from this meeting.';
+    const missing = noIni && noLast ? 'This meeting is not linked and there is no earlier note from it.' : noIni ? 'This meeting is not linked to the Portfolio, a board or an initiative.' : 'There is no earlier note from this meeting.';
     out.push(ctxBox('knows', 'What PMOS knows', fold('info', missing + (out.length ? '' : ' Nothing is recorded to prepare.'), { 'data-cal3': 'knows' }),
-      ul([noIni ? ci({}, el('span', { class: 'tag' }, 'Link'), el('span', { class: 'cal3-ct' }, 'Link an initiative, and its blocked, late and due items show here.')) : null,
+      ul([noIni ? ci({}, el('span', { class: 'tag' }, 'Link'), el('span', { class: 'cal3-ct' }, 'Pick Portfolio, Board or Initiative above, and what matters there shows here.')) : null,
         ci({}, el('span', { class: 'tag' }, 'Note'), el('span', { class: 'cal3-ct' }, 'Take a note in this meeting, and the next one opens with its summary and next steps.'))].filter(Boolean))));
   }
   return out;

package/workspace/public/pm/c3-demo-boards.js

@@ -584,14 +584,15 @@ function handleMore(S, method, path, p) {
     return okb({ board: { name: 'Demo board' }, releases: S.releases.filter((x) => x.board === p.board).map((x) => ({ id: x.id, name: x.name, type: 'both', initiative_ids: x.scope.slice(), deploy_at: x.date + 'T11:00:00', release_at: x.date + 'T12:00:00', accepted_at: x.status === 'Released' ? x.date + 'T12:30:00' : null, gapFlags: [], tags: { detected: [], reason: null }, summary: [], status: x.status, board: x.board })) });
   }
   if (path === '/api/docs/library') {
-    const files = [];
+    const files = []; const edges = [];   // the research informs the PRD; the rubric comes from the PRD (the document sheet's Relations graph)
     for (const r of feat(p.board)) {
-      const h = hash(r.id); const slug = r.id.toLowerCase();
+      const h = hash(r.id); const slug = r.id.toLowerCase(); const at0 = files.length;
       if (r.spec) files.push({ path: 'planning/ib/' + slug + '-prd.md', title: r.title + ' PRD', category: 'spec', date: D(-(h % 20) - 1), initiative: r.id });
       files.push({ path: 'planning/ib/' + slug + '-research.md', title: r.title + ' research', category: 'res', date: D(-(h % 50) - 5), initiative: r.id });
       if (catOfRow(S, r) === 'Do') files.push({ path: 'planning/ib/' + slug + '-rubric.md', title: r.title + ' rubric', category: 'eval', date: D(-(h % 9) - 1), initiative: r.id });
+      if (r.spec) { edges.push([at0 + 1, at0, 0]); if (files.length === at0 + 3) edges.push([at0, at0 + 2, 1]); }
     }
-    return okb({ key: 'demo', files, edges: [], kinds: [], categories: [{ key: 'spec', name: 'Specs' }, { key: 'eval', name: 'Evals' }, { key: 'res', name: 'Research & plans' }], initiatives: {} });
+    return okb({ key: 'demo', files, edges, kinds: ['informs', 'rubric from'], categories: [{ key: 'spec', name: 'Specs' }, { key: 'eval', name: 'Evals' }, { key: 'res', name: 'Research & plans' }], initiatives: {} });
   }
   return undefined;
 }

package/workspace/public/pm/c3-demo-cal4.js

@@ -90,7 +90,23 @@ const CONTEXT = {
   'm3@2026-10-06': { phase: 'past', held: false, items: [] },
   'm1@2026-10-08': { phase: 'upcoming', held: true, items: [
     { kind: 'prepared', text: 'Async summary of the 3 open tickets', ref: init('search') },
-  ] },
+  ],
+  // a meeting about a board (initiative c3-meeting-board): the title names no board, so the PM linked it
+  level: { kind: 'board', ws: D.WS_ID, id: 'idpf', name: 'IDPF', why: 'you linked it to the board', by: 'pm' },
+  brief: {
+    initiative: null,
+    gist: ['A meeting of the IDPF board.', 'IDPF Sprint 42 has 11 of 20 tickets still open, and 2 are blocked.', 'On the board: 1 initiative at risk.', '1 new ask waits in triage.'],
+    board: { ws: D.WS_ID, id: 'idpf', name: 'IDPF', health: 'warn', counts: { total: 3, open: 3, risk: 1, late: 0 }, next_release: null },
+    sprint: { name: 'IDPF Sprint 42', start: '2026-10-05', end: '2026-10-16', counts: { todo: 5, doing: 6, done: 9 }, total: 20, open: 11, blocked: 2, read_at: '2026-10-08T08:10:00' },
+    matters: [
+      { tone: 'bad', tag: 'Blocked', text: 'IDPF-1190 QA test plan for the beta: QA capacity', meta: 'In Progress · flagged in Jira', ref: { type: 'jira', id: 'IDPF-1190', board: 'idpf', ws: D.WS_ID } },
+      { tone: 'bad', tag: 'Blocked', text: 'IDPF-1204 Partner sandbox keys', meta: 'Blocked', ref: { type: 'jira', id: 'IDPF-1204', board: 'idpf', ws: D.WS_ID } },
+      { tone: 'warn', tag: 'At risk', text: 'Self-serve onboarding v2', meta: 'initiative on this board · due 2026-10-26', ref: init('IDPF-12') },
+      { tone: 'warn', tag: 'New ask', text: 'SSO for enterprise trials, from Lina Kusuma (Sales)', meta: 'waiting in triage', ref: { type: 'ask', id: 'ask-demo1', board: 'idpf', ws: D.WS_ID } },
+    ],
+    last: null, earlier: 0, purpose: null, prep: null, links: [], refs: [], planning: false,
+    sources: ['the calendar', 'the IDPF board', 'its IDPF Sprint 42 tickets from Jira'],
+  } },
   'm2@2026-10-08': { phase: 'upcoming', held: true, items: [
     { kind: 'prepared', text: 'Agenda: scope cut, blockers, next steps', ref: init('checkout') },
     { kind: 'prepared', text: 'Pre-read: the Checkout v2 PRD with 2 open comments', ref: { type: 'plan-item', id: 'checkout-prd' } },
@@ -104,6 +120,7 @@ const CONTEXT = {
     { kind: 'prepared', text: 'Three scope options with their dates', ref: init('checkout') },
     { kind: 'todo', text: 'Cut Checkout v2 to 3 core flows to hold 24 Oct?', ref: item('item-demo010') },
   ],
+  level: { kind: 'initiative', id: 'checkout', name: 'Checkout v2', why: "today's brief names the initiative", by: 'brief' },
   // the card before a meeting (initiative c3-meeting-card): what the server's briefOf puts together
   brief: {
     initiative: { id: 'checkout', title: 'Checkout v2', status: 'at risk' },
@@ -118,12 +135,35 @@ const CONTEXT = {
     earlier: 3, purpose: null, prep: null, links: [], refs: [],
     sources: ['the calendar', '3 earlier notes of this meeting', 'the checkout plan', 'your items'],
   } },
-  'm5@2026-10-08': { phase: 'upcoming', held: false, items: [] },
+  // a meeting about the Portfolio: the brief names no initiative and the PM linked it
+  'm5@2026-10-08': { phase: 'upcoming', held: false, items: [],
+    level: { kind: 'portfolio', name: 'Portfolio', why: 'you linked it to the Portfolio', by: 'pm' },
+    brief: {
+      initiative: null,
+      gist: ['A review of 5 boards.', 'Across the boards: 1 initiative late and 2 initiatives at risk.', '1 release in the next 14 days.'],
+      boards: [
+        { ws: D.WS_ID, id: 'idpf', name: 'IDPF', health: 'warn', line: '3 open initiatives · 1 at risk · 1 ask' },
+        { ws: D.WS_ID, id: 'pay', name: 'Payments', health: 'ok', line: '2 open initiatives' },
+        { ws: D.WS_ID, id: 'growth', name: 'Growth', health: 'ok', line: '2 open initiatives' },
+        { ws: D.WS_ID, id: 'office', name: 'Office move', health: 'bad', line: '2 open initiatives · 1 late · 1 at risk' },
+        { ws: D.WS_ID, id: 'hiring', name: 'Hiring Q4', health: 'ok', line: '1 open initiative' },
+      ],
+      matters: [
+        { tone: 'bad', tag: 'Late', text: 'Fit-out contractor selection', meta: 'Office move · due 2026-10-06', ref: init('OFF-01') },
+        { tone: 'warn', tag: 'At risk', text: 'Self-serve onboarding v2', meta: 'IDPF · due 2026-10-26', ref: init('IDPF-12') },
+        { tone: 'ok', tag: 'Release', text: 'Tokenisation 1.4', meta: 'Payments · 2026-10-15', ref: { type: 'release', id: 'rel-pay-14' } },
+      ],
+      last: null, earlier: 0, purpose: null, prep: null, links: [], refs: [], planning: false,
+      sources: ['the calendar', 'every board on the Portfolio'],
+    } },
 };
 
+/* the boards a meeting can be linked to (routes-calendar-views.js link_boards), as c3-demo-boards.js names them */
+const LINK_BOARDS = [['idpf', 'IDPF'], ['pay', 'Payments'], ['growth', 'Growth'], ['office', 'Office move'], ['hiring', 'Hiring Q4']].map(([id, name]) => ({ ws: D.WS_ID, id, name }));
+
 /** The answer of GET /api/calendar-views with the Calendar page's keys added. */
 export function withCalendarPage(out) {
   if (!out || !out.range) return out;
   const { start, end } = out.range;
-  return withCalendarTidy({ ...out, layers: layersIn(start, end), free: freeIn(start, end), context: CONTEXT });
+  return withCalendarTidy({ ...out, layers: layersIn(start, end), free: freeIn(start, end), context: CONTEXT, link_boards: LINK_BOARDS });
 }

package/workspace/public/pm/c3-demo-init.js

@@ -316,6 +316,22 @@ POST['/api/doc-sheet/reject'] = (b) => {
 };
 POST['/api/doc-sheet/why'] = (b) => { const R = revsOf(b.path); const r = R && R.find((x) => x.rev === Number(b.rev)); if (!r) return { ok: false, error: 'no such revision' }; if (!String(b.why || '').trim()) return { ok: false, error: 'a why is required' }; r.why_added = b.why.trim(); r.why_added_at = '2026-10-08T08:12:00.000Z'; return { ok: true, rev: r.rev }; };
 POST['/api/doc-sheet/mark-current'] = (b) => { if (!String(b.why || '').trim()) return { ok: false, error: 'a why is required' }; DEMO_EVENTS.push({ path: b.path, kind: 'marked', at: '2026-10-08T08:12:00.000Z', why: b.why.trim(), by: 'pm' }); return { ok: true, at: '2026-10-08T08:12:00.000Z' }; };
+/* the copies in other tools (GET /api/docs, lib/doc-sync.js signals; initiative c3-doc-sheet-v2): Checkout v2 PRD has a Confluence copy that is behind
+ * and a Google Doc that PMOS is ahead of; the drop-off analysis has a Confluence copy in step. Check marks them read now; sync and link are kept in memory. */
+const pOf = (id) => DFILES.find((f) => f.id === id).path;
+const COPIES = {
+  [pOf('p1')]: [{ kind: 'confluence', label: 'Confluence', target: 'acme.atlassian.net/wiki/spaces/PM/pages/48213/Checkout+v2+PRD', url: null, title: 'Checkout v2 PRD', signal: 'behind', basis: 'text', words: 'Confluence has a change PMOS does not have: Dana edited the Scope section on Thu 8 Oct.', checked_at: '2026-10-08T07:40:00.000Z', checked_by: 'agent', remote_modified_at: '2026-10-08T06:55:00.000Z', remote_modified_by: 'Dana Ruiz', linked_at: '2026-09-25T10:00:00.000Z', syncing: null, sync_failed: null },
+    { kind: 'google', label: 'Google Docs', target: 'docs.google.com/document/d/1Xc2Checkout', url: null, title: 'Checkout v2 PRD (shared with Design)', signal: 'ahead', basis: 'text', words: 'PMOS has changes the Google Doc does not have: the done criteria and the audit risk.', checked_at: '2026-10-08T07:40:00.000Z', checked_by: 'agent', remote_modified_at: '2026-10-05T16:20:00.000Z', remote_modified_by: 'Wawan', linked_at: '2026-10-01T09:00:00.000Z', syncing: null, sync_failed: null }],
+  [pOf('u1')]: [{ kind: 'confluence', label: 'Confluence', target: 'acme.atlassian.net/wiki/spaces/PM/pages/48390', url: null, title: 'Address drop-off analysis', signal: 'same', basis: 'text', words: 'Both have the same text.', checked_at: '2026-10-08T07:40:00.000Z', checked_by: 'agent', remote_modified_at: '2026-10-06T11:00:00.000Z', remote_modified_by: 'Wawan', linked_at: '2026-10-06T11:05:00.000Z', syncing: null, sync_failed: null }] };
+GET['/api/docs'] = () => ({ ok: true, docs: Object.entries(COPIES).map(([path, links]) => ({ path, title: (DFILES.find((f) => f.path === path) || {}).title || path, links: links.map((l) => ({ ...l })), attention: links.some((l) => l.signal !== 'same') })), summary: {}, open: null, session: null, connectors: {} });
+POST['/api/docs/check'] = () => { for (const L of Object.values(COPIES)) for (const l of L) { l.checked_at = '2026-10-08T08:12:00.000Z'; l.checked_by = 'agent'; } return { ok: true, session: 'demo-check' }; };
+POST['/api/docs/sync'] = (b) => { const l = (COPIES[b.path] || []).find((x) => x.kind === b.kind); if (!l) return { ok: false, error: b.path + ' has no such copy' }; if (!['pmos', 'copy'].includes(b.use)) return { ok: false, error: 'say which version to use: pmos or copy' }; l.syncing = { run: null, use: b.use, started_at: '2026-10-08T08:12:00.000Z' }; return { ok: true, session: 'demo-sync' }; };
+POST['/api/docs/link'] = (b) => {
+  if (!['google', 'confluence'].includes(b.kind) || !String(b.target || '').trim()) return { ok: false, error: 'not a Google Docs or Confluence address' };
+  const L = COPIES[b.path] || (COPIES[b.path] = []); if (L.some((x) => x.kind === b.kind)) return { ok: false, error: 'that document already has a ' + b.kind + ' copy' };
+  L.push({ kind: b.kind, label: b.kind === 'google' ? 'Google Docs' : 'Confluence', target: b.target, url: null, title: '', signal: 'unchecked', basis: null, words: 'No check has read this copy yet.', checked_at: null, checked_by: null, remote_modified_at: null, remote_modified_by: null, linked_at: '2026-10-08T08:12:00.000Z', syncing: null, sync_failed: null });
+  return { ok: true };
+};
 POST['/api/doc-sheet/change-note'] = (b) => ({ ok: true, note: 'A change note for the owners of ' + (b.downstream || []).join(', ') });
 
 /* health: the six checks (the mockup's docHealth, line 4059). Checkout v2 PRD is recomputed from its text; the others answer the fixed N of M. */

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

@@ -76,6 +76,7 @@ function postRoute(path, body) {
   try { b = body ? JSON.parse(body) : {}; } catch { b = {}; }
   if (path === '/api/pm-items/add') return { ok: true, item: { id: 'item-demo-new' + (++added), title: String(b.line || '').trim() || 'New item', due: null, priority: null, waiting_on: null, job: null, steps: [], created_at: D.NOW_ISO + 'Z' } };
   if (path === '/api/pm-items/remove') return { ok: true, undo_ms: 8000 };
+  if (path === '/api/calendar-links') return (window.__c3links = (window.__c3links || []).concat([b])), { ok: true, link: b.kind === 'none' ? null : { kind: b.kind, ws: b.ws || null, board: b.board || null, initiative: b.initiative || null, title: b.title || null, by: 'pm:wawan' } };   // nothing is saved
   /* the Work page's routes (initiative console3-work-page): each answers as the real route does; pm-work-view.js lays the press over the fixtures */
   if (path === '/api/pm-items/notyet') {
     const when = String(b.when || ''); const n = when === 'tomorrow' ? 1 : when === 'next-week' ? 7 : 0;