create-pmos 0.142.0 → 0.143.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.142.0",
+  "version": "0.143.0",
   "description": "Scaffold the PMOS portable kit — run the PMOS product-management workflow (initiative → lane-fit spec → contract → build → three gates, with work-type lanes for features, research, maintenance, incidents, and content) entirely inside your own repo, with all state as git-versioned files. Includes `workflow-sweep`, which audits the state every board derives from and separates real defects from work you simply have not done. `create-pmos workspace` also installs + launches the local Terminal Workspace GUI. No database, no network, no telemetry.",
   "license": "MIT",
   "bin": {

package/payload/KIT-VERSION

@@ -1,3 +1,3 @@
-kernel-source: pmos@69e497b
+kernel-source: pmos@7aa3b30
 assembled: 2026-10-12
 mode: vendor

package/payload/planning/evals/eval-calibration.md

@@ -2,7 +2,7 @@
 type: Reference
 title: "Eval calibration log"
 description: "Append-only record of every PM override of an evaluator verdict."
-generated: {by: process:create-pmos, at: "2026-10-12T01:34:35Z"}
+generated: {by: process:create-pmos, at: "2026-10-12T01:40:01Z"}
 status: stable
 ---
 

package/payload/planning/okrs/health-budgets.md

@@ -2,7 +2,7 @@
 type: Reference
 title: "Health budgets"
 description: "Closed registry of health-budget anchors (D59), edited only by the PM."
-generated: {by: process:create-pmos, at: "2026-10-12T01:34:35Z"}
+generated: {by: process:create-pmos, at: "2026-10-12T01:40:01Z"}
 status: stable
 ---
 

package/payload/state/discoveries.md

@@ -2,7 +2,7 @@
 type: Reference
 title: "Discoveries and friction log"
 description: "Append-only record of what runs discovered and where the process rubbed."
-generated: {by: process:create-pmos, at: "2026-10-12T01:34:35Z"}
+generated: {by: process:create-pmos, at: "2026-10-12T01:40:01Z"}
 status: stable
 ---
 

package/workspace/c3-initiatives-test.js

@@ -61,12 +61,12 @@ const { harness } = require('./c3-ini-harness');
   ok('S1 the settings sheet offers no Build template while Build and deliver is off', await st(() => document.querySelector('[data-ini-offer="fix"]').disabled && document.querySelector('[data-ini-offer="product"]').disabled));
   await page.click('[data-ini="build"]');
   await until(() => st(() => !!document.querySelector('[data-ini="jira-key"]')));
-  await page.fill('[data-ini="jira-key"]', 'off');
+  await page.fill('[data-ini="jira-key"]', 'off, mov');
   ok('S2 turning it on offers the Build templates and asks for the Jira key', await st(() => !document.querySelector('[data-ini-offer="fix"]').disabled && document.querySelector('[data-ini-offer="fix"]').checked));
   await page.click('[data-ini="settings-save"]');
   await until(() => store(() => window.__c3boards.boards.find((b) => b.id === 'office').build === true));
-  const off = await store(() => { const b = window.__c3boards.boards.find((x) => x.id === 'office'); return { build: b.build, jira: b.jira, offer: b.offer }; });
-  ok('S3 Save posts buildDeliver: Office move mirrors Jira OFF and offers the Build templates', off.build === true && off.jira === 'OFF' && off.offer.includes('fix'), JSON.stringify(off));
+  const off = await store(() => { const b = window.__c3boards.boards.find((x) => x.id === 'office'); return { build: b.build, jira: b.jira, projects: (b.jiraProjects || []).join(), offer: b.offer }; });
+  ok('S3 Save posts buildDeliver: Office move mirrors Jira OFF and MOV (two Jira projects) and offers the Build templates', off.build === true && off.jira === 'OFF' && off.projects === 'OFF,MOV' && off.offer.includes('fix'), JSON.stringify(off));
   const s4 = await until(async () => { const t = await toast(); return /Build and deliver on, mirroring Jira OFF/.test(t) && t; });
   ok('S4 a toast says what changed', !!s4, await toast());
   await until(() => st(() => !!document.querySelector('[data-ini-tab="sprints"]')));
@@ -144,6 +144,19 @@ const { harness } = require('./c3-ini-harness');
   ok('W4 the initiative now runs Research only and moved to Plan; other initiatives keep theirs', r07.stage === 'Plan' && r07.wf === 'Discover,Plan,Evaluate'
     && await store(() => !window.__c3boards.rows.find((r) => r.id === 'IDPF-12').template), JSON.stringify(r07));
 
+  /* ── Jira epics of an initiative (jira-epic-items) ── */
+  await page.click('[data-ini="jira-epics"]');
+  await until(() => st(() => !!document.querySelector('[data-ini="epics-input"]')));
+  await page.fill('[data-ini="epics-input"]', 'IDPF-900, XX-1');
+  await page.click('[data-ini="epics-save"]');
+  const epErr = await until(() => st(() => { const e = document.querySelector('[data-ini="epics-form"] [data-ini="error"]'); return e && e.textContent; }));
+  ok('E1 an epic outside the board\'s Jira projects is refused, and the sheet says why', /XX-1 is not in a Jira project of IDPF/.test(epErr || ''), epErr);
+  await page.fill('[data-ini="epics-input"]', 'idpf-900, idpf-901');
+  await page.click('[data-ini="epics-save"]');
+  await until(() => store(() => (window.__c3boards.rows.find((r) => r.id === 'IDPF-07').epics || []).length === 2));
+  const epChip = await until(() => st(() => { const c = document.querySelector('[data-ini="jira-epics"]'); return c && /Jira epics IDPF-900, IDPF-901/.test(c.textContent) && c.textContent; }));
+  ok('E2 the epics are saved upper-cased, and the initiative header names them', !!epChip, epChip);
+
   /* ── phone width ── */
   await page.setViewportSize({ width: 400, height: 860 });
   for (const loc of ['', 'board:idpf:summary', 'ini:idpf:IDPF-12:overview']) {

package/workspace/guide/initiative-boards.md

@@ -14,7 +14,7 @@ The Initiatives tab of the console page (`/c3.html`) has these levels: **Portfol
 The Portfolio shows one row per board. A board is a product folder, for example IDPF. Each row shows:
 
 - the board name and its health: On track, Needs attention or Off track
-- the owner, and **Build and deliver** with the Jira project key, or "PMOS tasks only"
+- the owner, and **Build and deliver** with the Jira project keys, or "PMOS tasks only"
 - the initiatives per category: Discover, Plan, Do and Learn
 - the next release
 
@@ -39,7 +39,7 @@ The tabs are **Summary**, **Initiatives**, **Triage**, **Backlog**, **Board**, *
 
 Press the gear in the board header to open the board settings.
 
-- **Build and deliver**: turn it on to mirror a Jira project. Type the Jira project key. With it off, every item is a PMOS task and the Build workflows are not available.
+- **Build and deliver**: turn it on to mirror Jira. Type one or more Jira project keys, separated by commas, for example `IDPF, LB`. A board can map several Jira projects. With it off, every item is a PMOS task and the Build workflows are not available.
 - **Workflows this board offers**: the templates that a new initiative on this board can use.
 - **Default for new initiatives and accepted asks**: the template that a new initiative or an accepted ask starts on.
 

package/workspace/guide/jira.md

@@ -2,7 +2,7 @@
 type: Guide
 title: "Jira: tickets drafted from the PRD, and their status"
 description: "How to draft Jira tickets from a PRD in your ticket template, push the ones that are ready, and see their status, sprint and progress on the initiative's Jira tickets tab."
-timestamp: 2026-10-11
+timestamp: 2026-10-12
 ---
 
 # Jira: tickets drafted from the PRD, and their status
@@ -110,6 +110,20 @@ pmos jira query [<initiative>]
 pmos jira sync <initiative> --from <file|-> [--query "<jql>"] [--dry-run]
 ```
 
+## Link an initiative to its Jira epics
+
+Your team may already plan in Jira, with an epic for each piece of work. Then link the initiative to its epics. You do not have to draft or push tickets.
+
+1. Open the initiative. On a board with **Build and deliver** on, press **Link Jira epics** in the initiative header.
+2. Type the epic keys, separated by commas, for example `IDPF-2685, LB-120`. Each epic must be in one of the board's Jira projects.
+3. Press **Save epics**.
+
+The **Jira status check** then reads each epic and the issues under it. The initiative's **Jira items**, **Breakdown** and **Timeline** show them, and the board's **Backlog**, **Board** and **Timeline** too. They are read-only: change them in Jira.
+
+An initiative record that names an epic in its frontmatter (`jira: IDPF-2685`) is linked to it until you save epics on the page. Save an empty list to unlink.
+
+An initiative whose tickets PMOS pushed keeps the tickets it pushed. The epic link is for initiatives with no pushed ticket.
+
 ## When the PRD changes
 
 Each time the tab opens, PMOS compares every ticket with its item in the PRD:

package/workspace/lib/engine/boards.js

@@ -83,6 +83,13 @@ const templateBuilds = (k) => !!INI_TEMPLATES[k] && INI_TEMPLATES[k].stages.some
 /** A board's Build and deliver settings, with the defaults of a board that never set them: buildDeliver is true when the
  * ledger line does not carry it (the stage-records thread reads the same field the same way), every template the board may run is offered, and new initiatives start with
  * the board's own template. */
+const JIRA_KEY_RE = /^[A-Za-z][A-Za-z0-9_]*-\d+$/;
+const JIRA_PROJECT_RE = /^[A-Za-z][A-Za-z0-9_]{0,19}$/;
+/** The Jira projects a board mirrors: the ledger's `jira` (one key, or a list of keys), else the keys in its tracker label. */
+function jiraProjectsOf(b) {
+  const raw = Array.isArray(b.jira) ? b.jira : typeof b.jira === 'string' && b.jira ? [b.jira] : String((/^Jira · (.+)$/.exec(b.tracker || '') || [])[1] || '').split(/[,\s]+/);
+  return [...new Set(raw.filter((k) => typeof k === 'string' && JIRA_PROJECT_RE.test(k.trim())).map((k) => k.trim().toUpperCase()))];
+}
 function boardSettings(board) {
   const b = board || {};
   const build = typeof b.buildDeliver === 'boolean' ? b.buildDeliver : true;
@@ -92,8 +99,8 @@ function boardSettings(board) {
   const tpl = INI_TEMPLATES[b.template] ? b.template : 'product';
   let defTpl = typeof b.defTpl === 'string' && offer.includes(b.defTpl) ? b.defTpl : (offer.includes(tpl) ? tpl : offer[0]);
   if (!defTpl) defTpl = 'simple';
-  const jira = build ? (typeof b.jira === 'string' && b.jira ? b.jira : (/^Jira · (.+)$/.exec(b.tracker || '') || [])[1] || null) : null;
-  return { build, jira, offer, defTpl };
+  const projects = build ? jiraProjectsOf(b) : [];
+  return { build, jira: projects[0] || null, jiraProjects: projects, offer, defTpl };
 }
 
 /* The PMOS-self board: the nine stage names of scripts/nine-stages.js, read-only, each in its category. */
@@ -139,7 +146,7 @@ const TOOLS = Object.freeze({
 
 const STATUSES = Object.freeze(['on track', 'at risk', 'late', 'done']);
 const VIEWS = Object.freeze(['now', 'mine', 'risk', 'noowner', 'all']);
-const KINDS = new Set(['board', 'workflow', 'move', 'assign', 'ask', 'ask-accept', 'ask-decline', 'ask-more', 'ini-workflow', 'task', 'task-update']);
+const KINDS = new Set(['board', 'workflow', 'move', 'assign', 'ask', 'ask-accept', 'ask-decline', 'ask-more', 'ini-workflow', 'task', 'task-update', 'ini-epics']);
 const TASK_STATES = Object.freeze(['To do', 'In progress', 'In review', 'Done']);
 
 const copyStages = (stages) => stages.map((s) => ({ name: s.name, cat: s.cat, hint: s.hint || '' }));
@@ -166,6 +173,7 @@ function fold(events) {
   const stages = new Map();        // key(board, id) → stage name (the last move)
   const iniWorkflows = new Map();  // key(board, id) → { template, stages } (the initiative's own workflow)
   const tasks = new Map();         // task id → { id, board, initiative, title, epic, owner, state, start, due, at, by, history }
+  const epics = new Map();         // initiative id → the Jira epic keys the PM linked to it (the last ini-epics line wins)
   const list = [];
   for (let e of Array.isArray(events) ? events : []) {
     if (typeof e === 'string') { try { e = JSON.parse(e); } catch { continue; } }
@@ -232,13 +240,15 @@ function fold(events) {
       if (typeof e.start === 'string') t.start = e.start;
       if (typeof e.due === 'string') t.due = e.due;
       t.history.push({ at: e.at || null, by: e.by || null, state: e.state || null, start: e.start || null, due: e.due || null, why: e.why || '' });
+    } else if (e.kind === 'ini-epics' && typeof e.id === 'string' && Array.isArray(e.epics)) {
+      epics.set(e.id, e.epics.filter((k) => typeof k === 'string' && JIRA_KEY_RE.test(k)).map((k) => k.toUpperCase()));
     } else if (e.kind === 'ask-decline' && typeof e.ask === 'string' && asks.has(e.ask)) {
       const a = asks.get(e.ask);
       if (a.state !== 'open') continue;
       Object.assign(a, { state: 'declined', why: e.why || '', closedAt: e.at || null });
     }
   }
-  return { boards, moves, assigns, asks, stages, iniWorkflows, tasks, events: list };
+  return { boards, moves, assigns, asks, stages, iniWorkflows, tasks, epics, events: list };
 }
 
 /** The stages an initiative runs on a board: its own workflow when one is recorded, else the board's. */
@@ -537,6 +547,6 @@ module.exports = {
   CATEGORIES, WORKFLOW_TEMPLATES, TOOLS, SELF_LADDER, READING_CAT, STATUSES, VIEWS, SORTS,
   templateWorkflow, isTemplateEdited, fold, readingOf, deriveStage, stageOf, catOf, moveWarnings, cardWarnings,
   applyWorkflowEdit, filterRows, health, counts, sprintsOf, key,
-  INI_TEMPLATES, TASK_STATES, isBuildStage, templateBuilds, boardSettings, workflowOf, templateOf, applyIniWorkflow, taskOf, shiftDay,
+  INI_TEMPLATES, TASK_STATES, isBuildStage, templateBuilds, boardSettings, jiraProjectsOf, JIRA_KEY_RE, JIRA_PROJECT_RE, workflowOf, templateOf, applyIniWorkflow, taskOf, shiftDay,
   ITEM_PROGRESS, itemStatus, taskItem, rollupItems,
 };

package/workspace/lib/jira-status.js

@@ -6,7 +6,8 @@
  * This module reads that file and writes a snapshot the initiative's Jira tickets tab shows. It writes nothing else:
  * no plan item, no record, no ledger line (D88: the Breakdown is the handoff checklist, not a copy of Jira).
  *
- *   queryFor(root, initiative)          → { linked, query }     the JQL for the tickets this initiative pushed
+ *   queryFor(root, initiative)          → { linked, mode, query } the JQL for the tickets this initiative pushed, or, when it
+ *                                         pushed none, for its Jira epics and their children (mode 'epic', jira-epic-items)
  *   linkedInitiatives(root)             → [{ initiative, query }]
  *   normalize(raw)                      → { issues, skipped } | { error }
  *   sync(root, initiative, raw, opts)   → the snapshot, written to <state>/tracker/jira/<initiative>.md
@@ -35,11 +36,15 @@ const nowIso = (now) => new Date(now == null ? Date.now() : now).toISOString().r
 function queryFor(root, initiative) {
   if (!jiraTickets.recordFm(root, initiative)) return { ok: false, error: `no initiative ${initiative} in this repository` };
   const keys = [...jiraTickets.pushedTickets(root, initiative).tickets.keys()];
-  if (!keys.length) return { ok: true, initiative, linked: false, keys: [], query: null };
-  return { ok: true, initiative, linked: true, keys, query: `key in (${keys.join(', ')}) ORDER BY key` };
+  if (keys.length) return { ok: true, initiative, linked: true, mode: 'pushed', keys, query: `key in (${keys.join(', ')}) ORDER BY key` };
+  // EPIC MODE (jira-epic-items): no ticket pushed, but the initiative has Jira epics. Read each epic and its children.
+  const epics = jiraTickets.epicKeysOf(root, initiative);
+  if (epics.length) return { ok: true, initiative, linked: true, mode: 'epic', keys: epics, epics, query: `key in (${epics.join(', ')}) OR parent in (${epics.join(', ')}) ORDER BY key` };
+  return { ok: true, initiative, linked: false, keys: [], query: null };
 }
 function linkedInitiatives(root) {
-  return jiraTickets.draftedInitiatives(root).map((id) => queryFor(root, id)).filter((q) => q.ok);
+  const ids = [...new Set([...jiraTickets.draftedInitiatives(root), ...jiraTickets.epicInitiatives(root)])].sort();
+  return ids.map((id) => queryFor(root, id)).filter((q) => q.ok);
 }
 
 // ── reading a saved search result ──────────────────────────────────────────────────────────────────
@@ -147,6 +152,15 @@ function urlOf(x, key) {
   return `${u.origin}/browse/${key}`;
 }
 /** One issue of either shape → a reading, or null when it has no key or no summary. */
+/** The issue type's name and the parent's key, when the search returned them: { type?, parent? }. */
+function typeParent(t, p) {
+  const out = {};
+  const type = clip(nameOf(t), 40);
+  if (type) out.type = type;
+  const pk = oneLine(p && typeof p === 'object' ? p.key : p).toUpperCase();
+  if (KEY_RE.test(pk)) out.parent = pk;
+  return out;
+}
 function normalizeIssue(x) {
   if (!x || typeof x !== 'object') return null;
   const key = oneLine(x.key).toUpperCase();
@@ -160,7 +174,8 @@ function normalizeIssue(x) {
     const flagged = flaggedIn(f) || /block|impediment|on hold/i.test(status);
     return { key, summary, status, category: categoryOf(status, st.statusCategory), sprint: sprintIn(f), subtasks: subtasksOf(f.subtasks), fixVersion: fixVersionsOf(f.fixVersions),
       points: pointsIn(f), resolved: dayOf(f.resolutiondate || f.resolved),
-      flagged, reason: flagged ? (flaggedIn(f) ? 'Flagged in Jira' : `Status: ${status}`) : null, url: urlOf(x, key) };
+      flagged, reason: flagged ? (flaggedIn(f) ? 'Flagged in Jira' : `Status: ${status}`) : null, url: urlOf(x, key),
+      ...typeParent(f.issuetype, f.parent) };
   }
   // The flat shape: what the skill tells the agent to write when it is unsure of the connector's shape.
   const summary = clip(oneLine(x.summary || x.title), 250);
@@ -170,7 +185,7 @@ function normalizeIssue(x) {
   return { key, summary, status, category: categoryOf(status, x.category), sprint: sprintOf(x.sprint), subtasks: subtasksOf(x.subtasks), fixVersion: fixVersionsOf(x.fixVersions != null ? x.fixVersions : x.fixVersion),
     points: pointsIn(x), resolved: dayOf(x.resolved || x.resolutiondate),
     flagged, reason: flagged ? clip(oneLine(x.reason || x.flag_reason || (x.flagged === true ? 'Flagged in Jira' : `Status: ${status}`)), 160) : null,
-    url: urlOf(x, key) };
+    url: urlOf(x, key), ...typeParent(x.type != null ? x.type : x.issuetype, x.parent) };
 }
 function normalize(raw) {
   const list = issuesList(raw);
@@ -223,13 +238,18 @@ function sync(root, initiative, raw, { query, dryRun = false, now } = {}) {
   const n = normalize(raw);
   if (n.error) return { ok: false, error: n.error };
   const pushed = jiraTickets.pushedTickets(root, initiative).tickets;
-  if (!pushed.size) return { ok: false, error: `${initiative} has no ticket in Jira yet — push its tickets first` };
+  const epics = pushed.size ? [] : jiraTickets.epicKeysOf(root, initiative);
+  if (!pushed.size && !epics.length) return { ok: false, error: `${initiative} has no ticket in Jira yet — push its tickets first, or link its Jira epic` };
   const prev = readSnapshot(root, initiative);
-  const got = new Map(n.issues.filter((i) => pushed.has(i.key)).map((i) => [i.key, i]));
+  // Pushed mode keeps the pushed keys. Epic mode keeps the epics and the issues under them; an issue the search returned
+  // with no parent field is kept, since the search was scoped to the epics; one under another parent is ignored.
+  const keep = pushed.size ? (i) => pushed.has(i.key) : (i) => epics.includes(i.key) || !i.parent || epics.includes(i.parent);
+  const got = new Map(n.issues.filter(keep).map((i) => [i.key, i]));
   const ignored = n.issues.length - got.size;
   const ids = new Map([...pushed].map(([k, v]) => [k, v.id]));
   const readings = []; const changes = []; const missing = [];
-  for (const key of pushed.keys()) {
+  const expected = pushed.size ? [...pushed.keys()] : [...new Set([...epics, ...got.keys(), ...(prev ? [...prev.tickets.keys()].filter((k) => { const r = prev.tickets.get(k); return epics.includes(k) || !r.parent || epics.includes(r.parent); }) : [])])];
+  for (const key of expected) {
     const r = got.get(key);
     const was = prev ? prev.tickets.get(key) : null;
     if (!r) {

package/workspace/lib/jira-tickets.js

@@ -42,6 +42,7 @@ const crypto = require('crypto');
 const planItems = require('./plan-items.js');
 const planTree = require('./plan-tree.js');
 const consoleState = require('./console-state');
+const { repoScript } = require('./repo-script.js');
 
 const KEY_RE = /^[A-Za-z][A-Za-z0-9_]*-\d+$/;
 const KEY_IN = /\b([A-Z][A-Z0-9_]+-\d+)\b/;
@@ -354,8 +355,10 @@ function missingOf(t) {
 }
 
 // ── J3 · draft ─────────────────────────────────────────────────────────────────────────────────────
+/** The Jira epic a record names: `jira_issue_key`, else `jira_epic`, else `jira`, when the value is a Jira key. */
 function anchorOf(rfm) {
-  return isStr(rfm.jira_issue_key) && KEY_RE.test(rfm.jira_issue_key.trim()) ? rfm.jira_issue_key.trim().toUpperCase() : null;
+  for (const k of ['jira_issue_key', 'jira_epic', 'jira']) if (rfm && isStr(rfm[k]) && KEY_RE.test(rfm[k].trim())) return rfm[k].trim().toUpperCase();
+  return null;
 }
 function draft(root, initiative, { dryRun = false, now } = {}) {
   const st = items(root, initiative);
@@ -653,6 +656,31 @@ function pushedTickets(root, initiative) {
   for (const t of d.tickets) if (t.jira) tickets.set(t.jira, { id: t.id, summary: t.summary });
   return { epic: KEY_RE.test(d.fm.epic || '') ? String(d.fm.epic).toUpperCase() : null, tickets };
 }
+/** The Jira epics the PM linked on the initiative page: the boards ledger's `ini-epics` lines (lib/routes-boards.js),
+ * folded by scripts/boards.js. Map initiative id → keys; an initiative the PM never linked is absent. */
+function linkedEpics(root) {
+  const base = mainRoot(root);
+  for (const rel of [['pmos', 'state'], ['state'], ['.pmos']]) {
+    let text;
+    try { text = fs.readFileSync(path.join(base, ...rel, 'boards.jsonl'), 'utf8'); } catch { continue; }
+    try { return require(repoScript('boards.js')).fold(text.split('\n').filter(Boolean)).epics || new Map(); } catch { return new Map(); }
+  }
+  return new Map();
+}
+/** The Jira epics of an initiative: the ones the PM linked on the page, else the one its record names (anchorOf). */
+function epicKeysOf(root, initiative, linked = linkedEpics(root)) {
+  if (linked.has(initiative)) return linked.get(initiative);
+  const a = anchorOf(recordFm(root, initiative) || {});
+  return a ? [a] : [];
+}
+/** Every initiative with a Jira epic, linked on the page or named by its record, whether or not it has a ticket draft. */
+function epicInitiatives(root) {
+  const linked = linkedEpics(root);
+  let names = [];
+  try { names = fs.readdirSync(engine().layout(mainRoot(root)).initiatives).filter((n) => n.endsWith('.md')).map((n) => n.slice(0, -3)); } catch { names = []; }
+  const ids = new Set([...names, ...linked.keys()].filter((id) => planItems.INIT_RE.test(id)));
+  return [...ids].filter((id) => epicKeysOf(root, id, linked).length && recordFm(root, id)).sort();
+}
 /** Every initiative with a ticket draft in this repository. */
 function draftedInitiatives(root) {
   let names = [];
@@ -663,6 +691,6 @@ function draftedInitiatives(root) {
 module.exports = {
   TYPES, PRIORITIES, ESTIMATES, SECTIONS, REQUIRED,
   items, itemsInPrd, itemsInFile, fromItem, draft, view, edit, resolvePrd, setEpic, approve, pushPlan, record,
-  readDraft, parseDraft, pushedTickets, draftedInitiatives, missingOf, contentHash, describe,
+  readDraft, parseDraft, pushedTickets, draftedInitiatives, epicInitiatives, epicKeysOf, linkedEpics, anchorOf, missingOf, contentHash, describe,
   draftPath, draftRel, jiraDir, relOf, recordFm, prdOf,
 };

package/workspace/lib/routes-boards.js

@@ -19,8 +19,9 @@
  *   POST /api/boards/asks/accept   { ws, board, ask, title, lane, anchor, intent?, id? } → { ok, initiative, stage }
  *   POST /api/boards/asks/decline  { ws, board, ask, why }                               → { ok }
  *   POST /api/boards/asks/more     { ws, board, ask, note? }                             → { ok }
- *   POST /api/boards/settings      { ws, board, buildDeliver?, jira?, offer?, defTpl? }       → { ok, board }
+ *   POST /api/boards/settings      { ws, board, buildDeliver?, jira?, offer?, defTpl? }       → { ok, board }   jira: one key or a list
  *   POST /api/boards/ini-workflow  { ws, board, id, template?, stages, moveTo? }         → { ok, row, moved }
+ *   POST /api/boards/ini-epics     { ws, board, id, epics: [Jira key] }                  → { ok, row }   the Jira epics of an initiative ([] unlinks)
  *   POST /api/boards/tasks/add     { ws, board, initiative, title, type?, epic?, start?, due?, owner? } → { ok, item }
  *   POST /api/boards/tasks/state   { ws, board, task, state }                            → { ok, item }
  *   POST /api/boards/tasks/reschedule { ws, board, task, days }                          → { ok, item }
@@ -116,8 +117,8 @@ function boardsOf(ctx, w, folded) {
     return {
       ws: w.id, id: b0.id, name: typeof led.name === 'string' && led.name ? led.name : b0.name, domain: 'domain' in led ? led.domain : b0.domain,
       kind: b0.kind, template, templateEdited: selfBoard ? false : B.isTemplateEdited(template, workflow), workflow, self: selfBoard,
-      tracker: led.tracker || (set.jira ? `Jira · ${set.jira}` : null), sprints: !!led.sprints || (set.build && !!set.jira),
-      build: set.build, buildDeliver: set.build, jira: set.jira, offer: set.offer, defTpl: set.defTpl,
+      tracker: set.jiraProjects.length ? `Jira · ${set.jiraProjects.join(', ')}` : led.tracker || null, sprints: !!led.sprints || (set.build && !!set.jira),
+      build: set.build, buildDeliver: set.build, jira: set.jira, jiraProjects: set.jiraProjects, offer: set.offer, defTpl: set.defTpl,
     };
   });
 }
@@ -201,12 +202,19 @@ function baseRows(w) {
       reading: B.readingOf(r.nine_stages, { accepted: !!rec.accepted }),
       lifecycle: rec.stopped ? rec.stopped.state : null,
       hasSpec, record: relRec || null, domainFolder: dm ? dm[1] : null,
+      recordEpic: jiraTickets.anchorOf(fm),
     });
   }
   rowCache.set(w.root, { key: cacheKey, rows });
   return { ok: true, rows };
 }
 
+/** The Jira epics of an initiative: the ones the PM linked on the page (the ledger), else the epic its record names. */
+function epicsOf(base, folded) {
+  if (folded && folded.epics && folded.epics.has(base.id)) return { epics: folded.epics.get(base.id), epicsFrom: 'pmos' };
+  return base.recordEpic ? { epics: [base.recordEpic], epicsFrom: 'record' } : { epics: [], epicsFrom: null };
+}
+
 /** The PRD row of one base row on one board. */
 function boardRow(board, base, folded) {
   const s = B.stageOf(board, base.id, base.reading, folded);
@@ -217,6 +225,7 @@ function boardRow(board, base, folded) {
     horizon: base.horizon, status: base.status, start: base.start, end: base.end, progress: base.progress, warnings: [],
     rank: base.rank, health: base.health, updated: base.updated, reading: base.reading, stageSource: s.source, lifecycle: base.lifecycle,
     template: B.templateOf(board, base.id, folded), workflow: wf.map((x) => ({ name: x.name, cat: x.cat })),
+    ...epicsOf(base, folded),
   };
   const w = [];
   if (s.source === 'move') {
@@ -272,9 +281,9 @@ function itemsOf(w, fr, board, rows) {
       let d = null;
       let snap = null;
       try { d = jiraTickets.readDraft(w.root, row.id); } catch { d = null; }
-      if (!d) continue;
       try { snap = jiraStatus.readSnapshot(w.root, row.id); } catch { snap = null; }
       const reading = (k) => (snap && snap.tickets && snap.tickets.get ? snap.tickets.get(k) : null) || null;
+      if (!d) { epicItems(row, board, snap, jiraKeys, out); continue; }
       const epicKey = /^[A-Za-z][A-Za-z0-9_]*-\d+$/.test(String((d.fm && d.fm.epic) || '')) ? String(d.fm.epic).toUpperCase() : null;
       if (epicKey) {
         const rd = reading(epicKey);
@@ -294,6 +303,22 @@ function itemsOf(w, fr, board, rows) {
   return B.rollupItems(out);
 }
 
+/** The Jira items of an initiative PMOS pushed nothing for: its linked epics and the issues under them, from the last
+ * read of the Jira status check (lib/jira-status.js, epic mode). An issue under no linked epic hangs under the first. */
+function epicItems(row, board, snap, seen, out) {
+  if (!snap || !snap.tickets || !snap.tickets.size || !(row.epics || []).length) return;
+  const epics = row.epics.filter((k) => snap.tickets.has(k));
+  const first = epics[0] || null;
+  const item = (r, kind, epic) => ({ uid: r.key, key: r.key, kind, src: 'jira', title: r.summary || r.key, status: B.itemStatus(r.status, r.category), blocked: !!r.flagged, owner: null, ini: row.id, epic, start: null, end: null, ref: null, board: board.id });
+  for (const k of epics) { if (!seen.has(k)) { out.push(item(snap.tickets.get(k), 'Epic', null)); seen.add(k); } }
+  for (const r of snap.tickets.values()) {
+    if (seen.has(r.key) || (r.parent && !row.epics.includes(r.parent)) || (!r.parent && r.type === 'Epic')) continue;   // a reading of an epic no longer linked
+    const kind = ['Story', 'Task', 'Bug'].find((t) => t.toLowerCase() === String(r.type || '').toLowerCase()) || 'Task';
+    out.push(item(r, kind, r.parent && epics.includes(r.parent) ? r.parent : first));
+    seen.add(r.key);
+  }
+}
+
 // ── HTTP ──────────────────────────────────────────────────────────────────────────────────────────
 function wsOf(ctx, wsParam) {
   const w = ctx.getWs(wsParam || null);
@@ -415,8 +440,8 @@ const READS = {
   '/api/boards/items': (ctx, res, url) => {
     const r = boardRead(ctx, res, url);
     if (!r) return;
-    ctx.json(res, { ok: true, ws: r.w.id, board: r.board.id, build: r.board.build, jira: r.board.jira, items: itemsOf(r.w, r.fr, r.board, r.rows),
-      initiatives: r.rows.map((x) => ({ id: x.id, title: x.title, stage: x.stage, cat: x.cat, status: x.status, owner: x.owner, horizon: x.horizon, start: x.start, end: x.end, progress: x.progress, template: x.template })) });
+    ctx.json(res, { ok: true, ws: r.w.id, board: r.board.id, build: r.board.build, jira: r.board.jira, jiraProjects: r.board.jiraProjects, items: itemsOf(r.w, r.fr, r.board, r.rows),
+      initiatives: r.rows.map((x) => ({ id: x.id, title: x.title, stage: x.stage, cat: x.cat, status: x.status, owner: x.owner, horizon: x.horizon, start: x.start, end: x.end, progress: x.progress, template: x.template, epics: x.epics })) });
   },
   '/api/boards/sprints': (ctx, res, url) => {
     const r = boardRead(ctx, res, url);
@@ -461,10 +486,12 @@ function settingsOf(body, board) {
   const v = {};
   const bd = body.buildDeliver != null ? body.buildDeliver : body.build;
   if (bd != null) { if (typeof bd !== 'boolean') return { error: 'buildDeliver is true or false' }; v.buildDeliver = bd; }
-  if (body.jira != null && body.jira !== '') {
-    if (typeof body.jira !== 'string' || !/^[A-Za-z][A-Za-z0-9_]{0,19}$/.test(body.jira.trim())) return { error: 'jira is a Jira project key: a letter, then letters, digits or _ (at most 20)' };
-    v.jira = body.jira.trim().toUpperCase();
-  } else if (body.jira === '') v.jira = null;
+  if (body.jira != null && body.jira !== '' && !(Array.isArray(body.jira) && !body.jira.length)) {
+    const list = Array.isArray(body.jira) ? body.jira : typeof body.jira === 'string' ? body.jira.split(/[,\s]+/).filter(Boolean) : null;
+    if (!list || list.length > 10 || list.some((k) => typeof k !== 'string' || !B.JIRA_PROJECT_RE.test(k.trim()))) return { error: 'jira is one or more Jira project keys (at most 10), each a letter, then letters, digits or _ (at most 20)' };
+    const keys = [...new Set(list.map((k) => k.trim().toUpperCase()))];
+    v.jira = keys.length === 1 ? keys[0] : keys;
+  } else if (body.jira === '' || Array.isArray(body.jira)) v.jira = null;
   const build = 'buildDeliver' in v ? v.buildDeliver : board ? board.build : true;
   if (body.offer != null) {
     if (!Array.isArray(body.offer) || !body.offer.length || body.offer.some((k) => !B.INI_TEMPLATES[k])) return { error: `offer is a list of templates: ${Object.keys(B.INI_TEMPLATES).join(', ')}` };
@@ -501,7 +528,7 @@ const WRITES = {
     if (set.error) return fail(ctx, res, 400, set.error);
     const ev = { kind: 'board', op: 'create', board: id, name, domain: body.domain ? String(body.domain).trim() : null, template: body.template, workflow, sprints: false, tracker: null };
     for (const k of ['buildDeliver', 'jira', 'offer', 'defTpl']) if (k in set.value) ev[k] = set.value[k];
-    if (ev.buildDeliver !== false && ev.jira) { ev.tracker = `Jira · ${ev.jira}`; ev.sprints = true; }
+    if (ev.buildDeliver !== false && ev.jira) { ev.tracker = `Jira · ${[].concat(ev.jira).join(', ')}`; ev.sprints = true; }
     append(p.file, g.actor, ev);
     const board = boardsOf(ctx, p.w, B.fold(readLedger(ctx, p.w))).find((b) => b.id === id);
     ctx.json(res, { ok: true, board });
@@ -613,9 +640,9 @@ const WRITES = {
     if (!p.file) return fail(ctx, res, 409, NO_STATE);
     const ev = { kind: 'board', op: 'settings', board: p.board.id, ...set.value };
     const build = 'buildDeliver' in set.value ? set.value.buildDeliver : p.board.build;
-    const jira = 'jira' in set.value ? set.value.jira : p.board.jira;
-    ev.tracker = build && jira ? `Jira · ${jira}` : null;
-    ev.sprints = !!(build && jira);
+    const jira = 'jira' in set.value ? (set.value.jira ? [].concat(set.value.jira) : []) : p.board.jiraProjects;
+    ev.tracker = build && jira.length ? `Jira · ${jira.join(', ')}` : null;
+    ev.sprints = !!(build && jira.length);
     append(p.file, g.actor, ev);
     const board = boardsOf(ctx, p.w, B.fold(readLedger(ctx, p.w))).find((b) => b.id === p.board.id);
     ctx.json(res, { ok: true, board });
@@ -639,6 +666,26 @@ const WRITES = {
     const row = boardRow(p.board, b0, B.fold(readLedger(ctx, p.w)));
     ctx.json(res, { ok: true, row, moved: ed.moved });
   },
+  '/api/boards/ini-epics': (ctx, res, body, g) => {
+    const p = postFrame(ctx, res, body);
+    if (!p) return;
+    if (typeof body.id !== 'string' || !body.id) return fail(ctx, res, 400, 'id is required');
+    if (!p.board.build) return fail(ctx, res, 409, `${p.board.name} has Build and deliver off, so it mirrors no Jira`);
+    const list = Array.isArray(body.epics) ? body.epics : typeof body.epics === 'string' ? body.epics.split(/[,\s]+/).filter(Boolean) : null;
+    if (!list || list.length > 20 || list.some((k) => typeof k !== 'string' || !B.JIRA_KEY_RE.test(k.trim()))) return fail(ctx, res, 400, 'epics is a list of Jira keys (at most 20), each like IDPF-2685');
+    const epics = [...new Set(list.map((k) => k.trim().toUpperCase()))];
+    const projects = p.board.jiraProjects || [];
+    const off = projects.length ? epics.filter((k) => !projects.includes(k.split('-')[0])) : [];
+    if (off.length) return fail(ctx, res, 400, `${off.join(', ')} ${off.length === 1 ? 'is' : 'are'} not in a Jira project of ${p.board.name} (${projects.join(', ')})`);
+    if (!p.file) return fail(ctx, res, 409, NO_STATE);
+    const base = needRows(ctx, res, p.w);
+    if (!base) return;
+    const b0 = base.find((r) => r.id === body.id);
+    if (!b0 || boardIdOf(b0, p.fr.boards, p.fr.folded, p.w) !== p.board.id) return fail(ctx, res, 404, `no initiative ${body.id} on this board`);
+    append(p.file, g.actor, { kind: 'ini-epics', board: p.board.id, id: body.id, epics });
+    const row = boardRow(p.board, b0, B.fold(readLedger(ctx, p.w)));
+    ctx.json(res, { ok: true, row });
+  },
   '/api/boards/tasks/add': (ctx, res, body, g) => {
     const p = postFrame(ctx, res, body);
     if (!p) return;

package/workspace/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pmos-workspace",
-  "version": "0.142.0",
+  "version": "0.143.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pmos-workspace",
-      "version": "0.142.0",
+      "version": "0.143.0",
       "license": "MIT",
       "dependencies": {
         "@xterm/addon-fit": "^0.11.0",

package/workspace/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmos-workspace",
-  "version": "0.142.0",
+  "version": "0.143.0",
   "private": true,
   "description": "PMOS Terminal Workspace — local companion hosting real PTYs beside the library and gates (D62)",
   "license": "MIT",

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) + '"]');

package/workspace/skills/jira-sync.skill

@@ -1,7 +1,7 @@
 ---
 name: jira-sync
 label: "Jira status check"
-description: "Read, read-only, the status, sprint and subtasks of the Jira tickets each initiative pushed, and save them in PMOS for the initiative's Jira tickets tab. It writes nothing to Jira."
+description: "Read, read-only, the status, sprint and subtasks of the Jira tickets each initiative pushed, or of its Jira epics and the issues under them, and save them in PMOS for the initiative's Jira tickets tab. It writes nothing to Jira."
 run: agent
 agent: claude
 output:
@@ -15,15 +15,17 @@ output:
 Rules that always hold:
 1. READ-ONLY on Jira. Use only the Jira search tool. Never create, edit, transition, assign, comment on, link, close or delete an issue. Never write to Confluence or to any other source.
 2. THE ONLY WRITE is `pmos jira sync`, and `pmos people record` once at the end (step 5). Never edit a repository file. Never run `pmos item`. Never write a ledger by hand. Never commit; the PM's Sync carries the files.
-3. LIGHT ON CONTENT. Ask Jira only for these fields: summary, status, the sprint field, subtasks, the Flagged field, the story points field, the resolution date, and the display names of the assignee and the reporter. Never ask for or copy a description, a comment, an attachment, an email address, any other detail of a person, or a token.
+3. LIGHT ON CONTENT. Ask Jira only for these fields: summary, status, the issue type, the parent, the sprint field, subtasks, the Flagged field, the story points field, the resolution date, and the display names of the assignee and the reporter. Never ask for or copy a description, a comment, an attachment, an email address, any other detail of a person, or a token.
 4. TEMPORARY FILES OUTSIDE THE REPOSITORY. Save each search result in this session's scratch folder, never in the repository, and delete it after the sync.
 5. NOTHING INVENTED. Give `pmos jira sync` exactly what Jira returned. If Jira cannot be reached, list the initiative under "Not reached" and write nothing for it.
 
 Procedure:
-1. If the task names one initiative ("This check: initiative …"), check that one only: run `pmos jira query <initiative>`. Otherwise run `pmos jira query`: each line is an initiative id, a tab and the Jira search (JQL) to run for it. If no initiative has a ticket in Jira, say so in one line and stop.
+1. If the task names one initiative ("This check: initiative …"), check that one only: run `pmos jira query <initiative>`. Otherwise run `pmos jira query`: each line is an initiative id, a tab and the Jira search (JQL) to run for it. An initiative PMOS pushed no ticket for, but which is linked to Jira epics, gets a search for those epics and the issues under them. If no initiative has a ticket or an epic in Jira, say so in one line and stop.
 2. For each initiative, run its search with the Jira search tool and the fields in rule 3. The sprint is usually a custom field named "Sprint" (often `customfield_10020`); ask for it by name. Story points are also a custom field, named "Story Points" or "Story point estimate" (often `customfield_10016`); ask for it by name. Fetch every page.
 3. Save the result as JSON in the scratch folder, for example `<scratch>/jira-<initiative>.json`, as a list with one object per issue:
-   `{"key", "summary", "status", "category", "sprint", "subtasks", "points", "resolved", "flagged", "reason", "url"}`
+   `{"key", "summary", "status", "category", "type", "parent", "sprint", "subtasks", "points", "resolved", "flagged", "reason", "url"}`
+   - `type`: the issue type's name, for example `Epic`, `Story`, `Task` or `Bug`.
+   - `parent`: the parent issue's key (the epic of a story), or `null`.
    - `category`: the status category, `new`, `indeterminate` or `done`.
    - `sprint`: `{"id": "42", "name": "Sprint 42", "state": "active", "start": "2026-10-01", "end": "2026-10-14"}` for the active sprint, `"future"` for a planned one, or `null` when the issue is in the backlog. Copy `id`, `start`, `end` and `completed` (a closed sprint's completion date) from Jira's sprint field; leave out any that Jira does not give.
    - `points`: the story points as a number, or `null` when none are set.