create-pmos 0.142.0 → 0.144.0

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

@@ -21,6 +21,8 @@ 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 { notesView, openNote, noteOfEvent, primeNotes } from './c3-notes.js';   // Calendar › Notes (initiative c3-notes-place)
+import { onNotes } from './notes-links.js';
 
 const LAYERS = [
   ['meetings', 'Meetings'],
@@ -63,6 +65,8 @@ const setVar = (node, name, value) => { node.style.setProperty('--cal3-' + name,
 function state(r) {
   const st = r.page || (r.page = { on: new Set(LAYERS.map((l) => l[0]).filter((id) => !(r.ctx && r.ctx.overlay && mem.hide.includes(id)))), free: true, tidy: false, sel: null });
   if (r.sel) { st.sel = { type: 'event', id: r.sel }; r.sel = null; }   // a meeting chosen on the Briefing (openDay)
+  if (r.pendingMode) { st.mode = r.pendingMode; r.pendingMode = null; }   // a note opened before the page drew (the Record chip)
+  if (!st.mode) st.mode = 'cal';
   return st;
 }
 
@@ -99,10 +103,21 @@ export function drawCalendarPage(host, r, h) {
   ensureComponentsCss();   // the Tidy-up buttons are pmc-btn
   const st = state(r);
   const phone = r.root.classList.contains('ph');
+  const page = (b, ...kids) => el('div', { class: 'cal3' + (r.ctx.overlay ? ' ov' : ''), 'data-cal3': 'page', 'data-cal3-show': st.mode }, r.ctx.deck || null, b, ...kids);
+  const redraw0 = () => h.redraw(host, r);
+  const modes = r.ctx.overlay ? null : modeSeg(st, redraw0);
+  if (st.mode === 'notes' && modes) {   // Calendar › Notes: the list and the open note; the zoom and the period have nothing to step here
+    return page(el('div', { class: 'calbar' }, el('div', { class: 'lens' }, modes)), notesView({ host, r, h, st, redraw: redraw0 }));
+  }
+  if (!r.notesOff) {   // a meeting's "Open the note" needs the shared notes read; a new note redraws the open detail
+    r.notesOff = onNotes(() => { if (r.root.isConnected && st.mode === 'cal' && st.sel) h.redraw(host, r); });
+    primeNotes();
+  }
   const bar = h.bar(host, r, phone);
-  const page = (...kids) => el('div', { class: 'cal3' + (r.ctx.overlay ? ' ov' : ''), 'data-cal3': 'page' }, r.ctx.deck || null, bar, ...kids);
-  if (r.error) return page(fold('alert', 'The calendar could not be read: ' + r.error, { 'data-cv': 'error', role: 'status' }));
-  if (!r.data) return page(fold('clock', 'Reading the repository', { 'data-cv': 'loading', role: 'status' }));
+  if (modes) { const lens = bar.querySelector('.lens'); if (lens) lens.prepend(modes); }
+  const pageBar = (...kids) => page(bar, ...kids);
+  if (r.error) return pageBar(fold('alert', 'The calendar could not be read: ' + r.error, { 'data-cv': 'error', role: 'status' }));
+  if (!r.data) return pageBar(fold('clock', 'Reading the repository', { 'data-cv': 'loading', role: 'status' }));
 
   const d = r.data; const M = model(d, h);
   const redraw = (focusSel) => { h.redraw(host, r); if (focusSel) { const n = r.root.querySelector(focusSel); if (n) n.focus(); } };
@@ -133,7 +148,22 @@ export function drawCalendarPage(host, r, h) {
     el('div', { class: 'cal3-wrap' },
       el('div', { class: 'cal3-main' }, empty, grid),
       el('div', { class: 'cal3-side' }, detail(ui), st.tidy ? tidyList(ui) : null, st.free ? freeList(ui, range) : null, lanes(ui, range))));
-  return page(chips(ui, range), body);
+  return pageBar(chips(ui, range), body);
+}
+
+/* "Open the note": the note recorded for this meeting, on Calendar › Notes; nothing when no note names the meeting */
+function noteLink(ui, e) {
+  if (ui.r.ctx.overlay) return null;
+  const n = noteOfEvent(e); if (!n) return null;
+  return el('div', { class: 'cal3-ctx', 'data-cal3-ctx': 'note' }, el('h4', null, 'Notes'),
+    el('a', { href: '#', class: 'cal3-ref', 'data-cal3': 'open-note', 'data-cal3-open-note': n.id, title: 'Open the note: ' + (n.title || 'Untitled note'),
+      onClick: (ev) => { ev.preventDefault(); openNote(ui.r, n.id); ui.redraw(); } }, c3ic('notes', 'sm'), 'Open the note'));
+}
+
+/* the Calendar | Notes switch, before the zoom (the mockup the PM approved on 2026-10-12) */
+function modeSeg(st, redraw) {
+  const b = (id, icon, label) => { const x = button({ variant: 'ghost', attrs: { class: 'cal3-b', 'aria-pressed': String(st.mode === id), 'data-cal3-mode': id, title: label }, onClick: () => { if (st.mode !== id) { st.mode = id; redraw(); } } }); x.replaceChildren(c3ic(icon, 'sm'), el('span', null, label)); return x; };
+  return el('div', { class: 'seg', role: 'group', 'aria-label': 'Show', 'data-cal3': 'mode' }, b('cal', 'cal', 'Calendar'), b('notes', 'notes', 'Notes'));
 }
 
 function fold(icon, text, attrs) { return el('div', { class: 'fold', ...(attrs || {}) }, c3ic(icon, 'sm'), text); }
@@ -424,6 +454,7 @@ function meetingDetail(ui, hit) {
     el('div', { class: 'dim mono cal3-when' }, h.dayLabel(hit.date) + (s === null ? ', all day' : ' · ' + h.hhmm(s) + ' to ' + h.hhmm(f))),
     el('div', { class: 'chips2', 'data-cal3': 'meeting-chips' }, homeChip('Calendar'), ...peopleOf(e).map((n) => el('span', { class: 'tag' }, n)),
       e.initiative ? el('span', { class: 'tag' }, 'Initiative: ' + (((ui.d.gantt || []).find((g) => g.id === e.initiative) || {}).title || e.initiative)) : null),
+    noteLink(ui, e),
     ...body,
     el('p', { class: 'dim cal3-note' }, past ? 'Only what PMOS holds a record for: items created or closed within 48 hours of the meeting. Each line opens its source.' : 'PMOS proposes changes. It never edits your calendar.'),
   ];

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

@@ -211,7 +211,7 @@ const openAsks = (S, bid) => S.asks.filter((a) => a.board === bid && a.state ===
 function rowOut(S, r) {
   const wf = wfOf(S, r);
   return { id: r.id, title: r.title, lane: r.lane, stage: r.stage, cat: catIn(wf, r.stage), owner: r.owner || null, anchor: r.anchor, horizon: r.horizon, status: r.status, start: r.start, end: r.end, progress: r.progress,
-    warnings: r.warnings.slice(), template: r.template || null, workflow: wf.map((s) => ({ name: s.name, cat: s.cat })) };
+    warnings: r.warnings.slice(), template: r.template || null, workflow: wf.map((s) => ({ name: s.name, cat: s.cat })), epics: (r.epics || []).slice(), epicsFrom: r.epics ? 'pmos' : null };
 }
 function boardOut(S, b) {
   const list = S.rows.filter((r) => r.board === b.id);
@@ -219,7 +219,7 @@ function boardOut(S, b) {
   for (const r of list) byCat[catOfRow(S, r)]++;
   const rel = nextRelease(S, b.id);
   return { ws: b.ws, id: b.id, name: b.name, full: b.full, domain: b.domain, template: b.template, templateEdited: tplEdited(b), workflow: b.workflow.map((s) => ({ ...s })), self: b.self, tracker: b.tracker, sprints: b.sprints,
-    build: b.build, buildDeliver: b.build, jira: b.jira, offer: b.offer.slice(), defTpl: b.defTpl, owner: b.owner, health: b.health,
+    build: b.build, buildDeliver: b.build, jira: b.jira, jiraProjects: b.build && b.jira ? (b.jiraProjects || [b.jira]).slice() : [], offer: b.offer.slice(), defTpl: b.defTpl, owner: b.owner, health: b.health,
     counts: { total: list.length, open: list.filter(isOpen).length, byCat, risk: list.filter((r) => r.status === 'at risk').length, late: list.filter((r) => r.status === 'late').length },
     asks: openAsks(S, b.id), nextRelease: rel ? { id: rel.id, name: rel.name, at: rel.date, date: rel.date, status: rel.status } : null };
 }
@@ -396,7 +396,11 @@ export function handle(S, method, path, p, body) {
     const v = {};
     const bd = body.buildDeliver != null ? body.buildDeliver : body.build;
     if (bd != null) { if (typeof bd !== 'boolean') return fail(400, 'buildDeliver is true or false'); v.build = bd; }
-    if (body.jira != null && body.jira !== '') { const j = String(body.jira).trim(); if (!/^[A-Za-z][A-Za-z0-9_]{0,19}$/.test(j)) return fail(400, 'jira is a Jira project key: a letter, then letters, digits or _ (at most 20)'); v.jira = j.toUpperCase(); }
+    if (body.jira != null && body.jira !== '') {
+      const keys = [].concat(body.jira).join(',').split(/[,\s]+/).filter(Boolean);
+      if (!keys.length || keys.some((j) => !/^[A-Za-z][A-Za-z0-9_]{0,19}$/.test(j))) return fail(400, 'jira is one or more Jira project keys (at most 10), each a letter, then letters, digits or _ (at most 20)');
+      v.jiraProjects = [...new Set(keys.map((j) => j.toUpperCase()))]; v.jira = v.jiraProjects[0];
+    }
     const build = 'build' in v ? v.build : b.build;
     if (body.offer != null) {
       if (!Array.isArray(body.offer) || !body.offer.length || body.offer.some((k) => !INI_TEMPLATES[k])) return fail(400, 'offer is a list of templates: ' + Object.keys(INI_TEMPLATES).join(', '));
@@ -413,7 +417,8 @@ export function handle(S, method, path, p, body) {
     Object.assign(b, v);
     if (!b.build) { b.offer = b.offer.filter((k) => !templateBuilds(k)); if (!b.offer.length) b.offer = ['simple']; if (!b.offer.includes(b.defTpl)) b.defTpl = b.offer[0]; }
     if (b.build && !b.jira) b.jira = b.prefix;
-    b.tracker = b.build && b.jira ? 'Jira · ' + b.jira : null; b.sprints = !!(b.build && b.jira);
+    if (!b.jiraProjects || !b.jiraProjects.includes(b.jira)) b.jiraProjects = b.jira ? [b.jira] : [];
+    b.tracker = b.build && b.jira ? 'Jira · ' + b.jiraProjects.join(', ') : null; b.sprints = !!(b.build && b.jira);
     S.events.push({ at: at(0, 8), by: 'You', kind: 'board', op: 'settings', board: b.id, ...v });
     return okb({ board: boardOut(S, b) });
   }
@@ -441,6 +446,20 @@ export function handle(S, method, path, p, body) {
     S.events.push({ at: at(0, 8), by: 'You', kind: 'board-workflow', board: b.id, stages: b.workflow, moved: mr });
     return okb({ board: boardOut(S, b), moved });
   }
+  if (path === '/api/boards/ini-epics') {
+    if (!b.build) return fail(409, b.name + ' has Build and deliver off, so it mirrors no Jira');
+    const r = S.rows.find((x) => x.id === body.id && x.board === b.id);
+    if (!r) return fail(404, 'no initiative ' + (body.id || '') + ' on this board');
+    const keys = Array.isArray(body.epics) ? body.epics : [];
+    if (keys.length > 20 || keys.some((k) => !/^[A-Za-z][A-Za-z0-9_]*-\d+$/.test(String(k)))) return fail(400, 'epics is a list of Jira keys (at most 20), each like IDPF-2685');
+    const epics = [...new Set(keys.map((k) => String(k).toUpperCase()))];
+    const projects = b.jiraProjects && b.jiraProjects.length ? b.jiraProjects : b.jira ? [b.jira] : [];
+    const off = projects.length ? epics.filter((k) => !projects.includes(k.split('-')[0])) : [];
+    if (off.length) return fail(400, off.join(', ') + (off.length === 1 ? ' is' : ' are') + ' not in a Jira project of ' + b.name + ' (' + projects.join(', ') + ')');
+    r.epics = epics;
+    S.events.push({ at: at(0, 8), by: 'You', kind: 'ini-epics', board: b.id, id: r.id, epics });
+    return okb({ row: rowOut(S, r) });
+  }
   if (path === '/api/boards/ini-workflow') {
     if (b.self) return fail(409, 'The PMOS board follows the ladder its records derive.');
     const r = S.rows.find((x) => x.id === body.id && x.board === b.id);

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

@@ -14,7 +14,7 @@
  * Every control is a button; the drag handlers are drag events on the cards and columns (pointer handlers stay on the document). */
 import { el } from './dom.js';
 import { registerBoardTab } from './c3-initiatives.js';
-import { icon, pill, lk, ib, pbtn, note, lbl, sect, card, list, empty, stepsMini, plural, trunc, openMenu, mono } from './c3-ini-ui.js';
+import { icon, pill, lk, ib, pbtn, note, lbl, sect, card, list, empty, stepsMini, jiraLabel, plural, trunc, openMenu, mono } from './c3-ini-ui.js';
 import { STATUSES, wfOf, tplName, loadItems, dropItems, workRow, workTlRows, iniTlRow, rescheduleTask, lockedToast } from './c3-ini-work.js';
 import { timeline, tlInit, tlRange, tlStill } from './c3-ini-timeline.js';
 
@@ -67,7 +67,7 @@ function mountItems(tab) {
           others > 0 ? el('span', { class: 'dim ini-note' }, plural(others, 'more initiative has', 'more initiatives have') + ' no epics or tasks yet') : null),
         b.build
           ? el('div', { class: 'chips2', role: 'group', 'aria-label': 'Source filter', 'data-wk': 'srcs' }, lbl('SOURCE'),
-            ...[['', 'All sources'], ['jira', [icon('jira', 'sm'), 'Jira ' + (b.jira || '')]], ['pmos', 'PMOS tasks']].map(([v, l]) => pill({ 'data-wk-src': v, 'aria-pressed': String(st.src === v), onclick: () => { st.src = v; draw('[data-wk-src="' + v + '"]'); } }, ...[].concat(l))))
+            ...[['', 'All sources'], ['jira', [icon('jira', 'sm'), 'Jira ' + jiraLabel(b)]], ['pmos', 'PMOS tasks']].map(([v, l]) => pill({ 'data-wk-src': v, 'aria-pressed': String(st.src === v), onclick: () => { st.src = v; draw('[data-wk-src="' + v + '"]'); } }, ...[].concat(l))))
           : el('div', { class: 'dim ini-note', 'data-wk': 'no-jira' }, icon('info', 'sm'), ' Build and deliver is off for ' + b.name + ', so there is no Jira here: every item is a PMOS task. ', lk({ onclick: () => ctx.openBoardSettings() }, 'Board settings')),
         el('div', { class: 'dim ini-note', 'data-wk': 'count' }, plural(n, 'item') + (ne ? ' in ' + plural(ne, 'epic') : '') + (st.ini ? ' · ' + st.ini + ' only' : '') + (st.src ? ' · ' + (st.src === 'jira' ? 'Jira only' : 'PMOS only') : '') + ' · ',
           any ? lk({ 'data-wk': 'clear', onclick: () => { Object.assign(st, { q: '', ini: '', src: '', kind: '', hideDone: false }); draw(); } }, 'Clear filters') : null, any ? ' · ' : null, 'same filters on Backlog, Board and Timeline'),
@@ -178,7 +178,7 @@ function mountItems(tab) {
       requestAnimationFrame(() => { if (!dead) tlInit(host); });
       return [sect({ ic: 'cal', title: 'Timeline', count: rows.length, right: mono('press a row to open its epics') }, node,
         hidden > 0 ? el('div', { class: 'chips2' }, el('span', { class: 'dim ini-note' }, plural(hidden, 'more Now initiative', 'more Now initiatives') + ' with no epics yet'), pill({ 'data-wk': 'tl-all', onclick: () => { st.tlAll = true; draw(); } }, 'Show all')) : null,
-        b.build ? note('Release dates come from Jira ' + (b.jira || '') + ' fix versions. PMOS bars drag to reschedule; Jira bars are locked.') : note('Every bar here is a PMOS task: drag it to reschedule.'))];
+        b.build ? note('Release dates come from Jira ' + jiraLabel(b) + ' fix versions. PMOS bars drag to reschedule; Jira bars are locked.') : note('Every bar here is a PMOS task: drag it to reschedule.'))];
     }
 
     function draw(focusSel) {

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

@@ -8,7 +8,7 @@
  * its id, one with no date says "No date yet". */
 import { el } from './dom.js';
 import { registerBoardTab } from './c3-initiatives.js';
-import { icon, pbtn, lk, chip, tag, st, note, sect, card, list, empty, nrow, cols, hbs, hbr, statusChip, plural, day, daysBetween } from './c3-ini-ui.js';
+import { icon, pbtn, lk, chip, tag, st, note, sect, card, list, empty, nrow, cols, hbs, hbr, statusChip, jiraLabel, plural, day, daysBetween } from './c3-ini-ui.js';
 import { loadItems } from './c3-ini-work.js';
 
 const whenOf = (r) => String(r.release_at || r.deploy_at || r.date || '').slice(0, 10);
@@ -45,7 +45,7 @@ registerBoardTab('releases', async (host, ctx) => {
   host.replaceChildren(cols(
     [sect({ ic: 'out', title: 'Unreleased', count: up.length, attrs: { 'data-inb': 'release-next' } }, up.length ? list(up.map((r) => row(r, false))) : empty('No release planned for ' + b.name + '.', { 'data-inb': 'release-none-next' })),
       past.length ? sect({ ic: 'check', title: 'Released', count: past.length, attrs: { 'data-inb': 'release-past' } }, list(past.map((r) => row(r, true)))) : null],
-    [card({ ic: 'out', title: 'Where releases live' }, note('Releases mirror Jira ' + (b.jira || '') + ' fix versions, because this board builds and delivers. Release dates are references: their home is the Calendar.'),
+    [card({ ic: 'out', title: 'Where releases live' }, note('Releases mirror Jira ' + jiraLabel(b) + ' fix versions, because this board builds and delivers. Release dates are references: their home is the Calendar.'),
       el('div', { class: 'chips2' }, pbtn('outline', 'Open the Calendar', 'cal', { 'data-inb': 'open-calendar', onclick: () => ctx.showTab('cal') })))]));
   return () => { dead = true; };
 });

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

@@ -7,7 +7,7 @@
  * the stage-records change; when that route is not on this server yet, the card says so quietly). source 'none' says there is no tracker. */
 import { el } from './dom.js';
 import { registerBoardTab } from './c3-initiatives.js';
-import { icon, pbtn, lk, chip, tag, st, note, sect, card, list, empty, nrow, cols, hbs, hbr, kv, plural, day } from './c3-ini-ui.js';
+import { icon, pbtn, lk, chip, tag, st, note, sect, card, list, empty, nrow, cols, hbs, hbr, kv, jiraLabel, plural, day } from './c3-ini-ui.js';
 import { loadItems } from './c3-ini-work.js';
 import { recordCards } from './c3-ini-records.js';
 
@@ -22,7 +22,7 @@ registerBoardTab('sprints', async (host, ctx) => {
   const [r, items] = await Promise.all([ctx.api.get('/api/boards/sprints', { board: b.id }), loadItems(ctx)]);
   if (dead) return () => {};
   if (!r || !r.ok) { host.replaceChildren(el('div', { class: 'fold w', role: 'alert' }, icon('alert', 'sm'), 'The sprints could not be read: ' + ((r && r.error) || 'no answer') + '.')); return () => { dead = true; }; }
-  if (r.source === 'none') { host.replaceChildren(empty('Waiting for the first sync from Jira ' + (b.jira || '') + '. Sprints will be mirrored here, read-only.', { 'data-inb': 'sprints-none' })); return () => { dead = true; }; }
+  if (r.source === 'none') { host.replaceChildren(empty('Waiting for the first sync from Jira ' + jiraLabel(b) + '. Sprints will be mirrored here, read-only.', { 'data-inb': 'sprints-none' })); return () => { dead = true; }; }
   const sprints = r.sprints || [];
   const active = sprints.find((s) => s.state === 'active');
   const others = sprints.filter((s) => s !== active);
@@ -32,7 +32,7 @@ registerBoardTab('sprints', async (host, ctx) => {
     right: [el('span', { class: 'chip2', title: 'Status lives in Jira' }, icon('lock', 'sm'))], attrs: { 'data-inb-issue': i.key } });
   const t = readTime(r.readAt);
   const left = [
-    el('div', { class: 'fold', 'data-inb': 'sprints-source' }, icon('lock', 'sm'), el('b', null, 'Mirrored from Jira, read-only.'), ' ' + (t ? 'Read ' + t + ' from Jira ' + (b.jira || '') + '.' : 'Not read yet.') + ' Change sprints in Jira.'),
+    el('div', { class: 'fold', 'data-inb': 'sprints-source' }, icon('lock', 'sm'), el('b', null, 'Mirrored from Jira, read-only.'), ' ' + (t ? 'Read ' + t + ' from Jira ' + jiraLabel(b) + '.' : 'Not read yet.') + ' Change sprints in Jira.'),
     active ? sect({ ic: 'check', title: active.name + ' items', count: (active.issues || []).length, right: tag('read-only'), attrs: { 'data-inb-sprint': active.name, 'data-inb-state': 'active' } },
       (active.issues || []).length ? list(active.issues.map(issueRow)) : empty('No items in this sprint yet.', { 'data-inb': 'sprint-no-issues' }))
       : empty(sprints.length ? 'No sprint is active.' : 'Jira has no sprints for this board.', { 'data-inb': sprints.length ? 'sprints-no-active' : 'sprints-empty' }),

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

@@ -14,7 +14,7 @@
  * Every tab has an honest empty state and an error line when its read fails. */
 import { el } from './dom.js';
 import { registerInitiativeTab } from './c3-initiatives.js';
-import { icon, pbtn, lk, chip, tag, st, note, sect, card, list, empty, cols, hbs, hbr, kv, chgl, stageChip, ownerText, statusChip, plural, trunc, day, dayLong, ago, PORTFOLIO } from './c3-ini-ui.js';
+import { icon, pbtn, lk, chip, tag, st, note, sect, card, list, empty, cols, hbs, hbr, kv, chgl, stageChip, ownerText, statusChip, jiraLabel, plural, trunc, day, dayLong, ago, PORTFOLIO } from './c3-ini-ui.js';
 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';
@@ -36,6 +36,10 @@ function tab(id, build) {
   });
 }
 const mine = (ctx, items) => items.filter((w) => w.ini === ctx.row.id);
+/** Why an initiative shows no Jira item yet: no epic linked, or its epics not read yet. */
+const epicsLine = (ctx) => ((ctx.row.epics || []).length
+  ? 'No Jira item read yet for ' + ctx.row.epics.join(', ') + '. The daily Jira check reads each epic and the issues under it.'
+  : 'No Jira epic is linked to ' + ctx.row.id + ' yet. Press Link Jira epics above to choose its epics' + (jiraLabel(ctx.board) ? ' in Jira ' + jiraLabel(ctx.board) : '') + '.');
 
 /* ── Overview ── */
 async function toolCard(ctx, t, R, rels) {
@@ -48,7 +52,7 @@ async function toolCard(ctx, t, R, rels) {
     case 'tickets': {
       const tk = its.filter((w) => w.src === 'jira');
       if (!b.build) body = [note(b.name + ' has Build and deliver off, so there is no Jira. Progress comes from PMOS tasks: ' + by('Done') + ' of ' + its.length + ' done.')];
-      else if (!tk.length) body = [note('No Jira ' + (b.jira || '') + ' items linked yet.')];
+      else if (!tk.length) body = [note(epicsLine(ctx))];
       else {
         const d = tk.filter((w) => w.status === 'Done').length; const p = tk.filter((w) => /progress|review/i.test(w.status)).length; const td = tk.length - d - p;
         body = [hbs([hbr('Done', d, d / tk.length, 'ok'), hbr('In progress', p, p / tk.length, 'acc'), hbr('To do', td, td / tk.length, 'pm')]),
@@ -129,7 +133,7 @@ tab('overview', async (ctx, isDead, host) => {
         ['Owner', ownerText(r.owner)], ['Anchor', r.anchor || 'No anchor'], ['Horizon', r.horizon ? r.horizon[0].toUpperCase() + r.horizon.slice(1) : 'Not set'], ['Lane', r.lane || 'Not set']]),
       hbs([hbr('Progress', Math.round(p * 100) + '%', p, toneOf(r.status))]),
       el('div', { class: 'chips2', 'data-ini': 'board-links' }, ...['backlog', 'board', 'timeline'].map((k) => lk({ 'data-ini-boardlink': k, onclick: () => ctx.openBoard(b.id, k, { ini: r.id }) }, icon('next', 'sm'), b.name + ' ' + k[0].toUpperCase() + k.slice(1) + ', this initiative only')))),
-    card({ ic: 'bolt', title: 'Work', sub: b.build ? 'Jira ' + (b.jira || '') + ' and PMOS' : 'PMOS tasks' },
+    card({ ic: 'bolt', title: 'Work', sub: b.build ? 'Jira ' + jiraLabel(b) + ' and PMOS' : 'PMOS tasks' },
       note(plural(work.filter((w) => w.kind === 'Epic').length, 'epic') + ', ' + plural(work.filter((w) => w.kind !== 'Epic').length, 'item') + '.'), el('div', { class: 'chips2' }, lk({ onclick: () => ctx.go({ view: 'ini', board: b.id, id: r.id, tab: 'breakdown' }) }, icon('next', 'sm'), 'Open breakdown'))),
     rels.length ? card({ ic: 'out', title: 'Releases', sub: 'live in the Calendar' }, chgl(rels.map((x) => el('li', null, icon('out', 'sm'), el('span', null, (x.name || x.id) + ' · ' + day(String(x.release_at || x.deploy_at || '').slice(0, 10))), tag('Calendar'))))) : null,
   ];
@@ -196,7 +200,7 @@ tab('tickets', async (ctx, isDead) => {
   if (isDead()) return null;
   if (!R.ok) return errLine('The Jira items could not be read: ' + R.error + '.');
   const tk = mine(ctx, R.items).filter((w) => w.src === 'jira');
-  if (!tk.length) return empty('No Jira ' + (ctx.board.jira || '') + ' items are linked to ' + ctx.row.id + ' yet.', { 'data-inb': 'tk-empty' });
+  if (!tk.length) return empty(epicsLine(ctx), { 'data-inb': 'tk-empty' });
   const its = tk.filter((w) => w.kind !== 'Epic'); const n = Math.max(1, its.length);
   const c = (s) => its.filter((w) => w.status === s).length;
   return cols(

package/workspace/public/pm/c3-ini-ui.js

@@ -75,6 +75,8 @@ export function geo(node, vars) {
 }
 
 /* ── text bits ── */
+/** The Jira projects a board mirrors, for a sentence: "IDPF, LB" (a board may map several Jira projects). */
+export const jiraLabel = (b) => ((b && Array.isArray(b.jiraProjects) && b.jiraProjects.length) ? b.jiraProjects.join(', ') : (b && b.jira) || '');
 export const plural = (n, one, many) => n + ' ' + (n === 1 ? one : many || one + 's');
 export const trunc = (s, n) => { s = String(s || ''); return s.length > n ? s.slice(0, n - 1) + '…' : s; };
 export const chip = (...kids) => el('span', { class: 'chip2' }, ...kids);

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

@@ -42,7 +42,7 @@ import { ensureC3Css } from './pm-work-view.js';
 import { openSheet, closeSheet } from './c3-sheet.js';
 import { toast } from './c3-toast.js';
 import {
-  btn, geo, icon, pbtn, pill, lk, ib, chip, tag, st, note, lbl, mono, sw, plural, trunc, day, daysBetween, statusChip, healthSt, HEALTH, ownerChip, ownerText,
+  btn, geo, icon, pbtn, pill, lk, ib, chip, tag, st, note, lbl, mono, sw, jiraLabel, plural, trunc, day, daysBetween, statusChip, healthSt, HEALTH, ownerChip, ownerText,
   stageChip, stepsMini, progChip, dateChip, list, empty, sect, card, nrow, crumbs, lh, segTabs, cols, hbs, hbr, kv, chgl, chgli, openMenu, closeMenu, CATS, PORTFOLIO,
 } from './c3-ini-ui.js';
 import { TEMPLATES, BOARD_TEMPLATES, isBuildStage, templateBuilds, offered, wfOf, catOf, kindOf, tplName, TOOL_META, toolLabel, toolIcon, loadItems, dropItems, workTlRows, iniTlRow, rescheduleTask, lockedToast } from './c3-ini-work.js';
@@ -107,7 +107,7 @@ function ensureCss() {
   document.head.appendChild(l);
 }
 const warnChip = (w) => st('warn', 'alert', w, { title: 'An order rule, shown as a warning. It never blocks.', 'data-ini-warning': w });
-const buildTag = (b) => (b.build ? el('span', { class: 'tag' }, icon('jira', 'sm'), b.jira ? 'Jira · ' + b.jira : 'Jira not set') : el('span', { class: 'tag' }, 'PMOS tasks only'));
+const buildTag = (b) => (b.build ? el('span', { class: 'tag' }, icon('jira', 'sm'), jiraLabel(b) ? 'Jira · ' + jiraLabel(b) : 'Jira not set') : el('span', { class: 'tag' }, 'PMOS tasks only'));
 const errLine = (text) => el('div', { class: 'fold w', role: 'alert', 'data-ini': 'error' }, icon('alert', 'sm'), text);
 const sentenceOf = (bad, warn) => (bad.length || warn.length
   ? [bad.length ? plural(bad.length, 'board') + (bad.length === 1 ? ' is' : ' are') + ' off track' : '', warn.length ? plural(warn.length, 'board') + ' need' + (warn.length === 1 ? 's' : '') + ' attention' : ''].filter(Boolean).join(', ')
@@ -271,7 +271,7 @@ export function mountInitiatives(pane, opts) {
       const s = pick.map((i) => i.start).sort()[0]; const e = pick.map((i) => i.end).sort().pop();
       const avg = pick.reduce((n, i) => n + (Number(i.progress) || 0), 0) / pick.length;
       rows.push({ uid: 'b:' + b.id, label: b.name + ' · ' + pick.length + ' of ' + now.length, start: s, end: e, progress: avg, cls: 'grp', tone: b.health === 'bad' ? 'bad' : b.health === 'warn' ? 'warn' : 'ok',
-        open: () => openBoard(b.id, 'timeline'), tip: { t: b.name + (b.full ? ' · ' + b.full : ''), p: Math.round(avg * 100) + '%', st: HEALTH[b.health] || 'No health yet', o: b.owner || '', src: b.build ? 'Board · Jira ' + (b.jira || '') : 'Board · PMOS tasks only', hint: 'Click the row to fold the board' },
+        open: () => openBoard(b.id, 'timeline'), tip: { t: b.name + (b.full ? ' · ' + b.full : ''), p: Math.round(avg * 100) + '%', st: HEALTH[b.health] || 'No health yet', o: b.owner || '', src: b.build ? 'Board · Jira ' + jiraLabel(b) : 'Board · PMOS tasks only', hint: 'Click the row to fold the board' },
         kids: pick.map((i) => iniTlRow(ctx, i, workTlRows(ctx, r.items.filter((w) => w.ini === i.id), () => { dropItems(ctx); draw(); }), b)) });
     }
     const { from, to } = tlRange(P.today);
@@ -318,7 +318,7 @@ export function mountInitiatives(pane, opts) {
         lh('cols', b.name + (b.full ? ' · ' + b.full : ''), (HEALTH[b.health] || 'No health yet') + (risk ? ', ' + risk + ' at risk or late' : '') + (asks ? ', ' + plural(asks, 'new ask') + ' to triage' : '') + '. '
           + plural(c.total || 0, 'initiative') + (items.ok ? ', ' + plural(work.filter((w) => w.kind === 'Epic').length, 'epic') + ', ' + plural(work.filter((w) => w.kind !== 'Epic').length, 'item') : '') + '.'),
         el('div', { class: 'chips2', 'aria-label': 'Board setup', 'data-ini': 'setup' },
-          ...(b.build ? [st('ok', 'bolt', 'Build and deliver on'), chip(icon('jira', 'sm'), b.jira ? ['Jira project ', el('b', { class: 'mono' }, b.jira), ' · ' + plural(jiraN, 'item')] : 'No Jira project set'), chip('PMOS tasks ' + pmN)]
+          ...(b.build ? [st('ok', 'bolt', 'Build and deliver on'), chip(icon('jira', 'sm'), jiraLabel(b) ? [(b.jiraProjects || []).length > 1 ? 'Jira projects ' : 'Jira project ', el('b', { class: 'mono' }, jiraLabel(b)), ' · ' + plural(jiraN, 'item')] : 'No Jira project set'), chip('PMOS tasks ' + pmN)]
             : [chip(icon('x', 'sm'), 'Build and deliver off'), chip('No Jira · ' + plural(pmN, 'PMOS task'))]),
           chip(icon('flag', 'sm'), 'New initiatives start with ' + def.name), lk({ onclick: () => openBoardSettings(b), 'data-ini': 'setup-change' }, 'Change')),
         b.self ? note(SELF_WHY) : null,
@@ -356,7 +356,7 @@ export function mountInitiatives(pane, opts) {
       [card({ ic: 'flag', title: 'Where the initiatives are', sub: 'each on its own workflow' },
         hbs(CATS.map((c) => btn({ class: 'ini-hbb', 'data-ini-catgo': c, title: 'See ' + c + ' initiatives', onclick: () => goIni({ view: 'all', cat: c }) }, hbr([sw(c), ' ', c], byCat(c), byCat(c) / maxN, 'acc', { class: 'hbr ini-c', 'data-cat': c })))),
         note('Stages roll up into four categories. Press one to list its initiatives.')),
-      card({ ic: 'todo', title: 'Work items', sub: b.build ? 'Jira ' + (b.jira || '') + ' and PMOS' : 'PMOS tasks' },
+      card({ ic: 'todo', title: 'Work items', sub: b.build ? 'Jira ' + jiraLabel(b) + ' and PMOS' : 'PMOS tasks' },
         hbs(['To do', 'In progress', 'In review', 'Done'].map((s) => hbr(s, nSt(s), nSt(s) / tot, s === 'Done' ? 'ok' : s === 'To do' ? 'pm' : 'acc'))),
         el('div', { class: 'chips2' }, lk({ onclick: () => ctx.openBoard(b.id, 'board') }, 'Open the Board'), lk({ onclick: () => ctx.openBoard(b.id, 'timeline') }, 'Open the Timeline'))),
       card({ ic: 'report', title: 'At a glance' }, chgl([
@@ -381,7 +381,7 @@ export function mountInitiatives(pane, opts) {
 
   function openBoardSettings(b) {
     if (b.self) { openSheet({ title: 'Board settings · ' + b.name, icon: 'lock', body: el('div', { class: 'ini-form' }, note(SELF_WHY)) }); return; }
-    const B = { build: b.build !== false, jira: b.jira || '', offer: new Set(offered(b)), def: b.defTpl || offered(b)[0], err: '', busy: false };
+    const B = { build: b.build !== false, jira: jiraLabel(b), offer: new Set(offered(b)), def: b.defTpl || offered(b)[0], err: '', busy: false };
     const host = el('div', { class: 'ini-form', 'data-ini': 'settings-form' });
     const sh = openSheet({ title: 'Board settings · ' + b.name, icon: 'cols', body: host, wide: true });
     let usage = null;
@@ -394,11 +394,11 @@ export function mountInitiatives(pane, opts) {
       const inis = usage && usage.ok ? usage.initiatives : [];
       const jiraN = usage && usage.ok ? usage.items.filter((w) => w.src === 'jira').length : 0;
       const usingBuild = inis.filter((i) => wfOf(i, b).some(isBuildStage)).length;
-      const jira = el('input', { type: 'text', value: B.jira, 'aria-label': 'Jira project key', placeholder: 'Project key, e.g. IDPF', 'data-ini': 'jira-key', oninput: (e) => { B.jira = e.target.value; } });
+      const jira = el('input', { type: 'text', value: B.jira, 'aria-label': 'Jira project keys', placeholder: 'Project keys, e.g. IDPF, LB', 'data-ini': 'jira-key', oninput: (e) => { B.jira = e.target.value; } });
       host.replaceChildren(
         note('Settings for the board. Workflows belong to each initiative; here you choose which templates the board offers and which one new initiatives start with.'),
         checkbox(B.build, [el('b', null, 'Build and deliver'), ': this board builds a product and mirrors Jira'], { 'data-ini': 'build' }, (e) => { B.build = e.target.checked; if (B.build) Object.keys(TEMPLATES).filter(templateBuilds).forEach((k) => B.offer.add(k)); render('[data-ini="build"]'); }),
-        B.build ? el('div', { class: 'ini-field' }, lbl('JIRA PROJECT'), el('div', { class: 'form' }, jira), note('Shows Jira epics, stories, tasks and bugs next to PMOS tasks, and adds the Sprints and Releases tabs (mirrored, read-only).'))
+        B.build ? el('div', { class: 'ini-field' }, lbl('JIRA PROJECTS'), el('div', { class: 'form' }, jira), note('One or more Jira projects, separated by commas. Shows their epics, stories, tasks and bugs next to PMOS tasks, and adds the Sprints and Releases tabs (mirrored, read-only). Link each initiative to its Jira epics on the initiative page.'))
           : note('Off: Backlog, Board and Timeline show PMOS tasks only. No Sprints or Releases tab, and initiatives choose workflows without Build and Deliver.'),
         !B.build && b.build ? el('div', { class: 'fold w', role: 'alert', 'data-ini': 'build-off-warning' }, icon('alert', 'sm'), el('span', null, plural(jiraN, 'Jira item') + ' will be hidden from this board.' + (usingBuild ? ' ' + plural(usingBuild, 'initiative') + ' use Build or Deliver stages; they keep them until you edit their workflow.' : ''))) : null,
         lbl('WORKFLOWS THIS BOARD OFFERS'),
@@ -416,16 +416,16 @@ export function mountInitiatives(pane, opts) {
     }
     async function save() {
       const key = B.jira.trim();
-      if (B.build && key && !/^[A-Za-z][A-Za-z0-9_]{0,19}$/.test(key)) { B.err = 'A Jira project key is a letter, then letters, digits or _.'; render(); return; }
+      if (B.build && key && !key.split(/[,\s]+/).filter(Boolean).every((k) => /^[A-Za-z][A-Za-z0-9_]{0,19}$/.test(k))) { B.err = 'Each Jira project key is a letter, then letters, digits or _. Separate keys with a comma.'; render(); return; }
       B.busy = true; B.err = ''; render();
       const body = { board: b.id, buildDeliver: B.build, offer: [...B.offer], defTpl: B.def };
-      if (B.build && key) body.jira = key;
+      if (B.build) body.jira = key;
       const r = await apiFor(b.ws).post('/api/boards/settings', body);
       B.busy = false;
       if (!r || !r.ok) { B.err = 'The settings were not saved: ' + ((r && r.error) || 'no answer') + '.'; render(); return; }
       sh.close();
       const nb = r.board || {};
-      toast(b.name + ': Build and deliver ' + (nb.build ? 'on' + (nb.jira ? ', mirroring Jira ' + nb.jira : '') : 'off, PMOS tasks only') + '. New initiatives start with ' + (TEMPLATES[nb.defTpl] || TEMPLATES[B.def]).name + '.');
+      toast(b.name + ': Build and deliver ' + (nb.build ? 'on' + (jiraLabel(nb) ? ', mirroring Jira ' + jiraLabel(nb) : '') : 'off, PMOS tasks only') + '. New initiatives start with ' + (TEMPLATES[nb.defTpl] || TEMPLATES[B.def]).name + '.');
       refresh();
     }
     render();
@@ -445,7 +445,7 @@ export function mountInitiatives(pane, opts) {
         lbl('BOARD NAME'), el('div', { class: 'form' }, name),
         wsList.length > 1 ? el('label', { class: 'ini-field' }, lbl('WORKSPACE'), el('select', { 'data-ini': 'nb-ws', onchange: (e) => { N.ws = e.target.value; } }, ...wsList.map((w) => el('option', { value: w.id, selected: w.id === N.ws }, w.name || w.id)))) : null,
         checkbox(N.build, [el('b', null, 'Build and deliver'), ': this board builds a product and mirrors Jira'], { 'data-ini': 'nb-build' }, (e) => { N.build = e.target.checked; render('[data-ini="nb-build"]'); }),
-        N.build ? el('div', { class: 'ini-field' }, lbl('JIRA PROJECT'), el('div', { class: 'form' }, el('input', { type: 'text', value: N.jira, placeholder: 'Project key, e.g. PP', 'aria-label': 'Jira project key', 'data-ini': 'nb-jira', oninput: (e) => { N.jira = e.target.value; } })),
+        N.build ? el('div', { class: 'ini-field' }, lbl('JIRA PROJECTS'), el('div', { class: 'form' }, el('input', { type: 'text', value: N.jira, placeholder: 'Project keys, e.g. PP, PPM', 'aria-label': 'Jira project keys', 'data-ini': 'nb-jira', oninput: (e) => { N.jira = e.target.value; } })),
           note('Epics, stories, tasks and bugs from this project show next to PMOS tasks. Sprints and releases are mirrored, read-only.'))
           : note('Off: no Jira. Initiatives here use workflows without Build and Deliver, and the work is PMOS tasks. Good for a microsite run by an agency, an office move or hiring.'),
         lbl('DEFAULT WORKFLOW FOR NEW INITIATIVES'), tplSeg(allowed, N.tpl, (k) => { N.tpl = k; render('[data-ini-tpl="' + k + '"]'); }, 'Default workflow'), tplCase(N.tpl),
@@ -690,6 +690,7 @@ export function mountInitiatives(pane, opts) {
       el('div', { class: 'calbody', 'data-ini-page': row.id },
         lh('target', row.title || row.id, [row.id, bb.name, row.anchor || 'no anchor', row.owner || 'no owner', row.start || row.end ? day(row.start) + ' to ' + day(row.end) : 'no dates yet', row.horizon ? row.horizon[0].toUpperCase() + row.horizon.slice(1) : '', Math.round((Number(row.progress) || 0) * 100) + '% done'].filter(Boolean).join(' · ')),
         el('div', { class: 'chips2', 'data-ini': 'ini-chips' }, statusChip(row.status), chip(icon('bolt', 'sm'), plural(ep, 'epic') + ', ' + plural(work.length - ep, 'item')), buildTag(bb),
+          bb.build ? pill({ 'data-ini': 'jira-epics', 'aria-haspopup': 'dialog', title: 'The Jira epics of this initiative', onclick: () => openEpics(bb, row) }, icon('jira', 'sm'), (row.epics || []).length ? 'Jira epics ' + row.epics.join(', ') : 'Link Jira epics') : null,
           row.lane ? tag(row.lane) : null, el('span', { class: 'chips2', 'data-ini': 'warnings', 'aria-live': 'polite' }, ...warnings.map(warnChip))),
         stepper, bb.self ? note(SELF_WHY) : null, strip,
         segTabs(tabs, tab, (k) => go({ view: 'ini', board: bb.id, id: row.id, tab: k }), 'Initiative views', { 'data-ini': 'ini-tabs' }),
@@ -697,6 +698,34 @@ export function mountInitiatives(pane, opts) {
     if (P.focusStep) { const f = stepper.querySelector('[data-ini-step="' + CSS.escape(P.focusStep) + '"]'); P.focusStep = null; if (f) f.focus(); }
     mountTab(host, null, (INI_TAB_LIST.find((t) => t[0] === tab) || [])[1], ctxI, token);
   }
+  /* The Jira epics of an initiative: the daily Jira check reads each one and the issues under it, read-only. */
+  function openEpics(b, row) {
+    const E = { text: (row.epics || []).join(', '), err: '', busy: false };
+    const host = el('div', { class: 'ini-form', 'data-ini': 'epics-form' });
+    const sh = openSheet({ title: 'Jira epics · ' + row.id, icon: 'bolt', body: host });
+    function render() {
+      const input = el('input', { type: 'text', value: E.text, 'aria-label': 'Jira epic keys', placeholder: 'Epic keys, e.g. IDPF-2685, LB-120', 'data-ini': 'epics-input', oninput: (e) => { E.text = e.target.value; } });
+      host.replaceChildren(
+        note('The Jira epics this initiative runs on. The daily Jira check reads each epic and the issues under it, read-only, and shows them as its Jira items.' + (jiraLabel(b) ? ' ' + b.name + ' mirrors Jira ' + jiraLabel(b) + '.' : '')),
+        row.epicsFrom === 'record' ? note('Now from the initiative record (jira: ' + row.epics.join(', ') + '). Saving here takes over from it.') : null,
+        el('div', { class: 'ini-field' }, lbl('JIRA EPICS'), el('div', { class: 'form' }, input)),
+        E.err ? errLine(E.err) : null,
+        el('div', { class: 'chips2' }, pbtn('primary', E.busy ? 'Saving' : 'Save epics', null, { 'data-ini': 'epics-save', disabled: E.busy, onclick: save }), pbtn('ghost', 'Cancel', null, { onclick: () => sh.close() })));
+      input.focus();
+    }
+    async function save() {
+      const keys = E.text.split(/[,\s]+/).filter(Boolean);
+      if (!keys.every((k) => /^[A-Za-z][A-Za-z0-9_]*-\d+$/.test(k))) { E.err = 'An epic key is a project key, a dash and a number, like IDPF-2685. Separate keys with a comma.'; render(); return; }
+      E.busy = true; E.err = ''; render();
+      const r = await apiFor(b.ws).post('/api/boards/ini-epics', { board: b.id, id: row.id, epics: keys });
+      E.busy = false;
+      if (!r || !r.ok) { E.err = 'The epics were not saved: ' + ((r && r.error) || 'no answer') + '.'; render(); return; }
+      sh.close();
+      toast(keys.length ? row.id + ' runs on Jira ' + keys.map((k) => k.toUpperCase()).join(', ') + '. The next Jira check reads them.' : row.id + ' has no Jira epic now.');
+      P.ini = null; dropItems(); draw();
+    }
+    render();
+  }
   function pickTool(id) {
     if (P.loc.tab !== 'overview' || P.loc.tool !== id) { go({ ...P.loc, tab: 'overview', tool: id }); return; }
     const n = root.querySelector('[data-ini-tool-card="' + CSS.escape(id) + '"]');