create-pmos 0.57.0 → 0.58.0

package/workspace/lib/pm-guard.js

@@ -54,6 +54,7 @@ const PM_ONLY_ACTS = Object.freeze([
   'bind',       // bind a session to an initiative (/api/session/initiative)
   'issue',      // Issue a report (issues.jsonl)
   'release',    // the D65 Release of a factory batch (one grant per batch)
+  'push',       // select Jira tickets for a push (D88: /api/jira/push, pmos jira approve)
 ]);
 /** What each act is, as the refusal says it: "only the PM can <phrase>". */
 const ACT_PHRASE = Object.freeze({
@@ -66,6 +67,7 @@ const ACT_PHRASE = Object.freeze({
   bind: 'bind a session to an initiative',
   issue: 'issue a report',
   release: 'release a batch',
+  push: 'select tickets to push to Jira',
 });
 /** Fields only a writer sets. A body that carries one is refused, even with the value the writer would choose. */
 const WRITER_FIELDS = Object.freeze(['v', 'eid', 'by', 'via', 'at', 'override', 'pm', 'actor', 'nonce', 'grant']);

package/workspace/lib/pmos-verbs.js

@@ -34,6 +34,9 @@ const VERBS = Object.freeze({
     help: 'pmos verify-work — mark work items integrated from the default branch (local refs only)' }),
   report: Object.freeze({ module: 'report-cli.js', run: 5, guide: 'reports.md',
     help: 'pmos report draft|issue|list … — draft and issue reports (pmos report help)' }),
+  // Not a pm-os-absorb verb (run: null): initiative jira-wbs added it through the same table.
+  jira: Object.freeze({ module: 'jira-cli.js', run: null, guide: 'jira.md',
+    help: 'pmos jira draft|show|epic|approve|pending|record|query|sync|which … — Jira tickets drafted from the PRD, and their status (pmos jira help)' }),
   // Not a pm-os-absorb verb (run: null): the workspace-launcher initiative added it through the same table.
   // Not a pm-os-absorb verb (run: null): docs-three-way-sync added it through the same table.
   docs: Object.freeze({ module: 'docs-cli.js', run: null, guide: 'docs.md',

package/workspace/lib/report-draft.js

@@ -431,12 +431,31 @@ function draftOf(root, { cadence, slot, now, health } = {}) {
   const pmosWritten = (ref) => /\.jsonl$/.test(ref) || /(^|\/)(runs|reports)\//.test(ref);
   const isEvidence = (h) => h.ev === 'moved' && h.evidence && h.evidence.kind === 'file' && isStr(h.evidence.ref) && !pmosWritten(h.evidence.ref);
   const trackerItems = fold.order.map((x) => fold.items[x]).filter((it) => it && work.has(it.initiative) && isStr(it.owner) && it.owner.startsWith('tracker:'));
+  /* The Jira status check (initiative jira-wbs, J14) writes a snapshot per initiative each time an agent read Jira. Its
+   * timestamp is a read of the tracker on its own, with no plan item: the check writes none (D88). */
+  const jiraReads = (() => {
+    const dir = path.join(path.dirname(L.initiatives), 'tracker', 'jira');
+    let names = [];
+    try { names = fs.readdirSync(dir).filter((n) => n.endsWith('.md') && !n.endsWith('-tickets.md') && work.has(n.slice(0, -3))); } catch { return []; }
+    const out = [];
+    for (const n of names) {
+      let fm = null;
+      try { fm = E.parseLeadingFrontmatter(fs.readFileSync(path.join(dir, n), 'utf8')); } catch { fm = null; }
+      if (fm && isStr(fm.timestamp)) out.push(fm.timestamp);
+    }
+    return out.sort();
+  })();
   if (trackerItems.length) {
     const seen = trackerItems.flatMap((it) => it.history.filter(isEvidence).map((h) => String(h.at))).sort();
     const lastSeen = seen.length ? seen.pop() : null;
     if (lastSeen && inWin(lastSeen)) reached.push('tracker (file evidence on tracker-owned moves in plan-items)');
     else notReached.push({ source: 'tracker', why: lastSeen ? `not refreshed since ${short(lastSeen)}` : 'no refresh with file evidence on record' });
   }
+  if (jiraReads.length) {
+    const lastRead = jiraReads[jiraReads.length - 1];
+    if (inWin(lastRead)) reached.push(`Jira (status check ${short(lastRead)})`);
+    else notReached.push({ source: 'Jira', why: `not checked since ${short(lastRead)}` });
+  }
   const fetched = lastFetch(abs);
   if (fetched) reached.push(`remote refs (last fetch ${short(fetched)}; not fetched for this draft)`);
   else notReached.push({ source: 'remote refs', why: 'never fetched; this draft reads local refs only' });

package/workspace/package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "pmos-workspace",
-  "version": "0.57.0",
+  "version": "0.58.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {

package/workspace/package.json

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

package/workspace/public/pm/components.css

@@ -1853,6 +1853,212 @@
 }
 
 
+/* the initiative sheet's Jira tickets tab (initiative jira-wbs, sheet-jira.js) */
+.in-jira {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  min-width: 0;
+}
+.in-jira-head {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: flex-end;
+  justify-content: space-between;
+  gap: 8px 16px;
+}
+.in-jira-epic {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: flex-end;
+  gap: 8px;
+  min-width: 0;
+}
+.in-jira-epic__text,
+.in-jira-count {
+  font-size: 14px;
+  font-weight: 600;
+}
+.in-jira-status-line {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 4px 12px;
+}
+.in-jira-when {
+  font-size: 12px;
+  color: var(--muted-foreground);
+}
+.in-jira-note {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 8px 12px;
+  padding: 8px 12px;
+  border: 1px solid var(--border);
+}
+.in-jira-note__text {
+  flex: 1 1 200px;
+  font-size: 14px;
+}
+.in-jira-list {
+  display: flex;
+  flex-direction: column;
+  border-top: 1px solid var(--border);
+}
+.in-jira-pick-gap {
+  display: inline-block;
+  width: 16px;
+}
+.in-jira-where,
+.in-jira-sub {
+  font-size: 12px;
+  color: var(--muted-foreground);
+  white-space: nowrap;
+}
+.in-jira-actions {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 8px;
+}
+.in-jira-detail-top {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 8px;
+}
+.in-jira-detail-top__gap {
+  flex: 1 1 auto;
+}
+.in-jira-detail {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  min-width: 0;
+}
+.in-jira-detail__title {
+  margin: 0;
+  font-size: 20px;
+  line-height: 28px;
+  font-weight: 600;
+  overflow-wrap: anywhere;
+}
+.in-jira-detail__meta {
+  font-size: 12px;
+  color: var(--muted-foreground);
+}
+.in-jira-warn {
+  margin: 0;
+  padding: 8px 12px;
+  border: 1px solid var(--warning);
+  font-size: 14px;
+}
+.in-jira-fields {
+  display: grid;
+  grid-template-columns: repeat(4, minmax(0, 1fr));
+  gap: 8px 12px;
+}
+.in-jira-box {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 4px 16px;
+  padding: 10px 12px;
+  border: 1px solid var(--border);
+}
+.in-jira-box__key {
+  font-family: var(--mono);
+  font-size: 14px;
+  font-weight: 600;
+}
+.in-jira-box__where {
+  font-size: 14px;
+}
+.in-jira-box__sub {
+  font-size: 12px;
+  color: var(--muted-foreground);
+}
+.in-jira-box__link {
+  margin-left: auto;
+  font-size: 12px;
+  color: var(--foreground);
+  text-underline-offset: 2px;
+}
+.in-jira-diff {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 10px 12px;
+  border: 1px solid var(--destructive);
+}
+.in-jira-diff__title {
+  margin: 0;
+  font-size: 14px;
+  font-weight: 600;
+}
+.in-jira-diff__sides {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 12px;
+}
+.in-jira-diff__side {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  min-width: 0;
+  font-size: 14px;
+}
+.in-jira-diff__label,
+.in-jira-diff__name,
+.in-jira-body__name {
+  margin: 0;
+  font-size: 12px;
+  font-weight: 600;
+  letter-spacing: 0.1em;
+  text-transform: uppercase;
+  color: var(--muted-foreground);
+}
+.in-jira-diff__part,
+.in-jira-body__part {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  min-width: 0;
+  overflow-wrap: anywhere;
+}
+.in-jira-body,
+.in-jira-edit {
+  display: flex;
+  flex-direction: column;
+  gap: 16px;
+  font-size: 14px;
+  line-height: 20px;
+}
+.in-jira-body__empty {
+  margin: 0;
+  color: var(--muted-foreground);
+}
+.in-jira-area {
+  min-height: 96px;
+}
+@media (max-width: 640px) {
+  .in-jira-fields {
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+  }
+  .in-jira-diff__sides {
+    grid-template-columns: 1fr;
+  }
+}
+@media (pointer: coarse) {
+  .in-jira-box__link {
+    display: inline-flex;
+    align-items: center;
+    min-height: 44px;
+  }
+}
+
+
 /* -- layouts · .fr- the frame: top bar, dock, Settings (Run 3, slice 3A) -- */
 /* The frame's root: the top bar over the body. app.js drops the cockpit's inline geometry when the frame is on. */
 .fr-root {

package/workspace/public/pm/dest-docs.js

@@ -66,7 +66,7 @@ export const COPY = Object.freeze({
   started: 'Compare started. It reads every copy and changes nothing.',
 });
 
-// Docs is not in the top bar (the bar holds at most 7 controls); ⌘K and `g d` open it.
+// Docs is in the top bar (the PM, 2026-10-06); ⌘K and `g d` open it too.
 registerCommand({ id: 'docs-open', label: 'Docs', hint: 'Is each document the same as its Google Docs and Confluence copy', cli: 'pmos docs list', run: () => openDestination('docs') });
 
 /* ── words ───────────────────────────────────────────────────────────────────────────────────────────────────────── */

package/workspace/public/pm/frame-copy.js

@@ -26,6 +26,7 @@ export const COPY = {
     initiatives: 'Initiatives',
     board: 'Board',
     reports: 'Reports',
+    docs: 'Docs',
     agent: 'Agent',
     settings: 'Settings',
   },

package/workspace/public/pm/initiative-sheet.js

@@ -3,7 +3,8 @@
  * About 70% of the width on a desktop and the whole screen on a phone. Top to bottom:
  *   line 1  the title, the horizon, the health reason (only when not on track), and a meta line: lane · anchor · id
  *   line 2  the stage stepper, then "Waiting on you: approval [Open gate ▸]" or "Waiting on agent: build [Hand to agent ▸]"
- *   tabs    Breakdown (the Run 1 pane, embedded: Tree · Board, and Timeline once Run 4 registers it), Files, History
+ *   tabs    Breakdown (the Run 1 pane, embedded: Tree · Board, and Timeline once Run 4 registers it), Files, History,
+ *           Jira tickets (sheet-jira.js, initiative jira-wbs: the tickets drafted from the PRD and their status in Jira)
  *   ⋯       horizon, check-by, lifecycle and the anchor (both PM-only: the server's guard answers), Copy CLI, Export breakdown
  * Nothing on this sheet says "plan". Everything it shows is read from GET /api/initiatives/<id>; every write goes through
  * initiatives-api.js. The Breakdown tab mounts with a tab id of the form `initiative:<slug>`, so it never meets a panel-4
@@ -17,6 +18,7 @@ import { el } from './dom.js';
 import { sheet, button, iconButton, tabs, row, badge, menu, toast, empty, field, ensureComponentsCss } from './primitives.js';
 import { icon, ensureSprite } from './icons.js';
 import { mountBreakdown, unmountBreakdown } from './panel-breakdown.js';
+import { mountJira, unmountJira } from './sheet-jira.js';
 import { openDoc } from './panel-initiatives.js';
 import { openNewSession } from './panel-newsess.js';
 import { wsOf, readDoc, saveDoc } from './data.js';
@@ -73,7 +75,7 @@ export function openSheet(repo, slug) {
   const s = sheet({
     mode: 'auto', title: slug, sub: '', body: [crumb, stepperHost, waitingHost, tabsHost, panel],
     attrs: { class: 'in-sheet', 'data-in-sheet': 'initiative', 'data-in-id': slug },
-    onClose: () => { closed = true; unmountBreakdown(panel); if (current === s) current = null; },
+    onClose: () => { closed = true; unmountBreakdown(panel); unmountJira(panel); if (current === s) current = null; },
   });
   current = s;
 
@@ -219,10 +221,11 @@ export function openSheet(repo, slug) {
   function drawTabs() {
     tabsHost.replaceChildren(tabs({
       variant: 'segmented', full: true, ariaLabel: COPY.sheet.tabs, value: tab,
-      items: [{ id: 'breakdown', label: COPY.sheet.breakdown }, { id: 'files', label: COPY.sheet.files }, { id: 'history', label: COPY.sheet.history }],
+      items: [{ id: 'breakdown', label: COPY.sheet.breakdown }, { id: 'files', label: COPY.sheet.files }, { id: 'history', label: COPY.sheet.history }, { id: 'jira', label: COPY.sheet.jira }],
       onChange: (id) => {
         if (id === tab) return;
         if (tab === 'breakdown') unmountBreakdown(panel);
+        if (tab === 'jira') unmountJira(panel);
         tab = id;
         drawTabs(); drawPanel();
         const t = tabsHost.querySelector('[data-tab="' + id + '"]');
@@ -234,6 +237,7 @@ export function openSheet(repo, slug) {
   function drawPanel() {
     if (!data) return;
     if (tab === 'breakdown') { mountBreakdown(panel, { id: tabId, ws, slug }, { embedded: true }); return; }
+    if (tab === 'jira') { mountJira(panel, { ws, slug }); return; }
     if (tab === 'files') {
       const files = data.files || [];
       panel.replaceChildren(files.length ? el('div', { class: 'in-sheet__rows', role: 'list' }, files.map((f) => row({

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

@@ -120,6 +120,7 @@ export const COPY = {
     breakdown: 'Breakdown',
     files: 'Files',
     history: 'History',
+    jira: 'Jira tickets',
     waitingYou: (act) => `Waiting on you: ${act}`,
     waitingAgent: (act) => `Waiting on agent: ${act}`,
     nothingOwed: 'Nothing is owed.',