create-pmos 0.141.0 → 0.142.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.141.0",
+  "version": "0.142.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@6f1e5e1
+kernel-source: pmos@69e497b
 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:30:00Z"}
+generated: {by: process:create-pmos, at: "2026-10-12T01:34:35Z"}
 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:30:00Z"}
+generated: {by: process:create-pmos, at: "2026-10-12T01:34:35Z"}
 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:30:00Z"}
+generated: {by: process:create-pmos, at: "2026-10-12T01:34:35Z"}
 status: stable
 ---
 

package/workspace/guide/my-work.md

@@ -1,7 +1,7 @@
 ---
 type: Guide
 title: "My work: every Jira ticket and WBS item assigned to you, ranked, briefed to an agent, approved in Agenda"
-timestamp: 2026-10-11
+timestamp: 2026-10-12
 ---
 
 # My work
@@ -69,9 +69,19 @@ Agenda shows one card, **N items need your brief**, when items wait in To brief.
 
 None of these briefs an agent or takes an item. Do that in My work.
 
-## The Work page: your own items in six views
+## The Work page: your work in six views
 
-The Work page holds the items you add for yourself. These are your own to-dos, such as "send Dana the new date". The server decides where each item shows, so one item is never in two views.
+The Work page holds all the work that is yours:
+
+- the items you add for yourself, such as "send Dana the new date";
+- every open Jira ticket and WBS item assigned to you, from the same read as My work;
+- the items today's morning brief suggests for you. They are flagged, so they are in Today.
+
+A row of assigned work shows its Jira key (a link to the ticket) or **WBS** and the repository, and the agent's suggestion when the read has one. A suggested row shows **Suggested** and the reason. An agent at work on a ticket puts it in Waiting; a ticket in progress, or with a draft ready for you, is flagged. A ticket that is done in Jira leaves the page.
+
+Every action works on these rows. The first action writes the item to your own list, with its source. **Drop** takes it off your Work page only; Jira and the Board keep it, and it does not come back.
+
+The server decides where each item shows, so one item is never in two views.
 
 The six views follow the OmniFocus style. The **Work** tab badge counts Inbox plus Today.
 

package/workspace/lib/routes-pm-items.js

@@ -47,6 +47,7 @@ const jobs = require('./jobs-to-be-done.js');
 const workFocus = require('./work-focus.js');
 const workEvidence = require('./work-evidence.js');
 const steps = require('./item-steps.js');
+const assigned = require('./work-assigned.js');
 const { repoScript } = require('./repo-script.js');
 
 const FIELDS = ['title', 'due', 'priority', 'waiting_on', 'job', 'defer', 'flagged', 'resolves', 'kind', 'person', 'evidence', 'outcome'];
@@ -77,10 +78,13 @@ function resolvesTitles(items, ctx, url) {
   } catch { return {}; }
 }
 
-function view(itemLines, jobLines, now, stepLines = [], focusLines = [], proof = null) {
+function view(itemLines, jobLines, now, stepLines = [], focusLines = [], proof = null, extra = []) {
   const today = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate()));
   const byItem = steps.foldSteps(stepLines).byItem;
-  const folded = pmItems.fold(itemLines).map((i) => ({ ...i, steps: byItem[i.id] || [] }));
+  // the work assigned to the PM and what the morning brief suggests (work-shows-assigned): the ledger's copy when it holds one, else the source's
+  const byId = new Map((extra || []).map((v) => [v.id, v]));
+  const folded = pmItems.fold(itemLines).map((i) => ({ ...assigned.overlay(i, byId), steps: byItem[i.id] || [] }))
+    .concat(assigned.addable(extra, itemLines).map((v) => ({ ...v, steps: [] })));
   const items = proof ? workEvidence.withEvidence(folded, { ...proof, now: now.getTime() }) : folded;
   const currentJobs = jobs.foldJobs(jobLines).map((j) => ({ ...j, ...jobs.progress(j.id, items) }));
   const lists = Object.fromEntries(pmItems.LISTS.map((l) => [l, []]));
@@ -106,6 +110,28 @@ function proofSources(ctx, itemLines) {
   return { events, notes };
 }
 
+// The work the PM did not type in (work-shows-assigned): open my-work items (Jira, WBS) and today's brief items for the PM.
+// Best effort: a source that cannot be read adds nothing. `myWork` is GET /api/my-work's answer, read by the caller.
+function readBrief(ctx, now) {
+  if (!ctx.runtimeDir) return null;
+  try { return JSON.parse(fs.readFileSync(path.join(ctx.runtimeDir, 'briefs', require('./brief.js').localDate(now.getTime()) + '.json'), 'utf8')); } catch { return null; }
+}
+function assignedFrom(myWork, brief, now) {
+  const todayIso = require('./brief.js').localDate(now.getTime());
+  return [...assigned.fromMyWork(myWork && myWork.ok ? myWork.items : []), ...assigned.fromBrief(brief, todayIso)];
+}
+async function assignedAsync(ctx, now) {
+  let mw = null;
+  try { mw = await require('./routes-my-work.js').listForAsync(ctx, now.getTime()); } catch { mw = null; }
+  return assignedFrom(mw, readBrief(ctx, now), now);
+}
+function assignedSync(ctx, now) {
+  let mw = null;
+  try { mw = require('./routes-my-work.js').listFor(ctx, now.getTime()); } catch { mw = null; }
+  return assignedFrom(mw, readBrief(ctx, now), now);
+}
+const VIRTUAL_ID = /^(jira:|wbs:|brief:)/;
+
 // Each operation returns { status, body, events } and writes nothing itself; the caller appends `events`.
 function checkFields(fields, allowed) {
   if (!fields || typeof fields !== 'object') return 'fields must be an object';
@@ -307,12 +333,12 @@ function prepare(ctx, now = new Date()) {
 
 module.exports = {
   prefixes: ['/api/pm-items', '/api/pm-jobs'],
-  view, resolvesTitles, flagRoute, deferItem, somedayItem, waitingItem, notYetItem, keepItem, focusEvent, doneItem, reopenItem, parkItem, unparkItem, moveItem, addStepRoute, stepWho, planSteps, addItem, editItem, removeItem, undoItem, addJob, editJob, deleteJob, checkFields, ROUTES, prepare,
+  view, resolvesTitles, assignedFrom, flagRoute, deferItem, somedayItem, waitingItem, notYetItem, keepItem, focusEvent, doneItem, reopenItem, parkItem, unparkItem, moveItem, addStepRoute, stepWho, planSteps, addItem, editItem, removeItem, undoItem, addJob, editJob, deleteJob, checkFields, ROUTES, prepare,
   handle: async (req, res, url, ctx) => {
     const p = url.pathname;
     if (p === '/api/pm-items' && req.method === 'GET') {
       const c = prepare(ctx);
-      const v = view(c.itemLines, c.jobLines, c.now, c.stepLines, c.focusLines, proofSources(ctx, c.itemLines));
+      const v = view(c.itemLines, c.jobLines, c.now, c.stepLines, c.focusLines, proofSources(ctx, c.itemLines), await assignedAsync(ctx, c.now));
       v.resolves_titles = resolvesTitles(v.items, ctx, url);
       ctx.json(res, v);
       return true;
@@ -325,6 +351,11 @@ module.exports = {
     const g = guard.requirePagePress(req, body);
     if (!g.ok) { ctx.json(res, { ok: false, error: g.error }, g.status); return true; }
     const c = prepare(ctx);
+    // the first press on assigned or suggested work puts it in the PM's ledger, with its source, before the press itself
+    if (typeof body.id === 'string' && VIRTUAL_ID.test(body.id) && !findItem(c.itemLines, body.id)) {
+      const v = assigned.addable(assignedSync(ctx, c.now), c.itemLines).find((x) => x.id === body.id);
+      if (v) { const ev = assigned.createdEvent(v); pmItems.appendEvent(itemsFile(ctx), ev, c.now); c.itemLines.push({ ...ev, at: c.now.toISOString() }); }
+    }
     const r = ROUTES[key](body, c);
     if (r.status === 200 && r.events) {
       for (const ev of r.events) {

package/workspace/lib/work-assigned.js

@@ -0,0 +1,69 @@
+'use strict';
+/* lib/work-assigned.js — the work the Work page shows that the PM did not type in (initiative work-shows-assigned).
+ *
+ *   fromMyWork(items)              → [item]   open my-work items (Jira tickets, WBS items owned by `you`) as Work items
+ *   fromBrief(brief, todayIso)     → [item]   today's brief items for the PM (owner pm, not worth_asking), flagged for Today
+ *   addable(virtuals, itemLines)   → [item]   the ones the PM's own ledger has never held (not added, not dropped)
+ *   createdEvent(v)                → event    the `created` line that puts one in the PM's ledger on its first press
+ *   overlay(item, byId)            → item     a ledger copy with the source's current status, suggestion and state
+ *
+ * PURE: no file, process or clock. A virtual item has the Work item's fields (title, due, priority, waiting_on, flagged) and
+ * says where it came from: origin jira | wbs | brief, plus key, url, status, suggest, why, my_work_state, repo. Its `source`
+ * is its origin, so a Drop is a drop (pm-items.js removalEvent), never a delete. */
+
+const TIER_PRIORITY = { P1: 'P1', P2: 'P2', P3: 'P3' };
+const AGENT = 'an agent';
+const SHOWN = ['origin', 'key', 'url', 'status', 'suggest', 'why', 'my_work_state', 'repo', 'initiative'];
+
+function fromMyWork(items) {
+  const out = [];
+  for (const x of items || []) {
+    if (!x || !x.id || !x.title || x.state === 'done' || x.category === 'done') continue;
+    const v = {
+      id: String(x.id), title: String(x.title), source: x.source === 'wbs' ? 'wbs' : 'jira', origin: x.source === 'wbs' ? 'wbs' : 'jira', assigned: true,
+      due: x.due || null, priority: TIER_PRIORITY[x.wsjf && x.wsjf.tier] || null, waiting_on: null, job: null,
+      key: x.key || null, url: x.url || null, status: x.status || null, suggest: x.suggest || null, my_work_state: x.state || null,
+      repo: x.repo || null, initiative: x.initiative || null,
+    };
+    if (x.state === 'agent') v.waiting_on = AGENT;
+    if (x.state === 'ready' || x.category === 'doing') v.flagged = true;
+    out.push(v);
+  }
+  return out;
+}
+
+function fromBrief(brief, todayIso) {
+  if (!brief || brief.date !== todayIso) return [];
+  const list = [...(Array.isArray(brief.priorities) ? brief.priorities : []), ...(Array.isArray(brief.items) ? brief.items : [])];
+  const seen = new Set();
+  const out = [];
+  for (const x of list) {
+    if (!x || !x.id || !x.title || x.owner !== 'pm' || x.worth_asking || seen.has(x.id)) continue;
+    seen.add(x.id);
+    out.push({ id: 'brief:' + x.id, title: String(x.title), source: 'brief', origin: 'brief', suggested: true, flagged: true,
+      due: null, priority: null, waiting_on: null, job: null, why: x.why_now || null, initiative: x.initiative_id || null });
+  }
+  return out;
+}
+
+/** The virtual items whose id the ledger never held: an item the PM added, pressed or dropped is the ledger's from then on. */
+function addable(virtuals, itemLines) {
+  const held = new Set((itemLines || []).filter((l) => l && l.id).map((l) => l.id));
+  return (virtuals || []).filter((v) => !held.has(v.id));
+}
+
+function createdEvent(v) {
+  const { id, source, ...fields } = v;
+  return { event: 'created', id, fields, source };
+}
+
+/** A ledger copy of an assigned item takes the source's current status, suggestion and state; the PM's own fields stay. */
+function overlay(item, byId) {
+  const v = byId && byId.get(item.id);
+  if (!v) return item;
+  const out = { ...item };
+  for (const k of SHOWN) if (v[k] !== undefined && v[k] !== null) out[k] = v[k];
+  return out;
+}
+
+module.exports = { fromMyWork, fromBrief, addable, createdEvent, overlay, AGENT };

package/workspace/package-lock.json

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

package/workspace/package.json

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

package/workspace/public/pm/pm-work-view.js

@@ -165,7 +165,7 @@ export const COPY = Object.freeze({
   outcome: 'What came out of it (optional)', notYet: 'Not yet:', laterToday: 'Later today', tomorrow: 'Tomorrow', nextWeek: 'Next week',
   looksDone: 'Looks done?', confirm: 'Confirm done', flag: 'Flag', unflag: 'Unflag', notBefore: 'Not before', someday: 'Someday', bringBack: 'Bring back',
   waitingField: 'Waiting on', waitingWho: 'Who?', stopWaiting: 'Stop waiting', flagged: 'Flagged',
-  notBeforeChip: (d) => 'Not before ' + d, advances: (t) => 'Advances team task ' + t, moved: (n) => `Moved ${n}×`,
+  notBeforeChip: (d) => 'Not before ' + d, advances: (t) => 'Advances team task ' + t, suggested: 'Suggested', agentSuggests: (t) => 'Agent: ' + t, moved: (n) => `Moved ${n}×`,
   overdue: (n) => (n === 1 ? 'Overdue since yesterday' : `${n} days overdue`), dueToday: 'Due today', dueOn: (d) => 'Due ' + d,
   waitingSince: (w, since, ago) => `Waiting for ${w}` + (since ? ` since ${since}` : '') + (ago ? ` (${ago})` : ''), repeats: (r) => 'Repeats ' + String(r).toLowerCase(),
   /* Review (PRD R7) */
@@ -793,6 +793,16 @@ function dueChip(inst, item) {
 /* The chips the Work page adds to a row: outside PMOS and the person, Not before, Flagged, how often it moved, Looks done, the team task it advances. */
 function workChips(inst, item, o = {}) {
   const today = inst.data.today; const c = [];
+  /* work the PM did not type in (work-shows-assigned): where it came from, with its link, and what the agent suggests */
+  if (item.origin === 'jira' || item.origin === 'wbs') {
+    const label = item.origin === 'jira' ? 'Jira ' + (item.key || '') : 'WBS' + (item.repo ? ' ' + item.repo : '') + (item.key ? ' ' + item.key : '');
+    const attrs = { class: 'tag', 'data-pm-origin': item.origin, title: item.status || '' };
+    c.push(item.url ? el('a', { ...attrs, href: item.url, target: '_blank', rel: 'noopener', onclick: (e) => e.stopPropagation() }, label.trim()) : el('span', attrs, label.trim()));
+    if (item.suggest) c.push(el('span', { class: 'chip2', 'data-pm-suggest': item.id }, c3ic('spark', 'sm'), COPY.agentSuggests(item.suggest)));
+  } else if (item.origin === 'brief') {
+    c.push(el('span', { class: 'tag', 'data-pm-origin': 'brief', title: item.why || '' }, c3ic('spark', 'sm'), COPY.suggested));
+    if (item.why) c.push(el('span', { class: 'chip2', 'data-pm-why': item.id }, item.why));
+  }
   if (item.kind === 'offline') c.push(el('span', { class: 'tag wk-off', 'data-pm-offline-tag': item.id }, COPY.offline), el('span', { class: 'chip2' }, c3ic('user', 'sm'), item.person || 'someone'));
   if (item.defer && item.defer > today) c.push(el('span', { class: 'tag wk-nb cal3-up', 'data-pm-notbefore': item.id }, COPY.notBeforeChip(dayLabel(item.defer))));
   if (item.flagged && !o.noFlag) c.push(el('span', { class: 'tag cal3-up', 'data-pm-flagged': item.id }, COPY.flagged));

package/workspace/server.js

@@ -7028,7 +7028,9 @@ async function handleRequest(req, res) {
     const owners = () => {
       const own = new Map();
       if (wsShape(root) !== 'pmos') return own;
-      const real = (id) => fs.existsSync(path.join(root, 'planning', 'initiatives', id + '.md'));
+      // a record lives in any of the repository's initiative folders: planning/initiatives/ here, pmos/state/initiatives/ in a kit
+      const dirs = initiativeDirs(root);
+      const real = (id) => dirs.some((d) => fs.existsSync(path.join(d, id + '.md')));
       for (const g of initiativeIndex(root).initiatives) {
         if (!real(g.id)) continue;
         for (const a of g.artifacts) { const rel = String(a.path).split(path.sep).join('/'); if (!a.shared && !own.has(rel)) own.set(rel, { id: g.id, title: g.title || g.id }); }

package/workspace/test-files.json

@@ -29,6 +29,7 @@
     "work-focus.test.js",
     "work-evidence.test.js",
     "brief-page.test.js",
+    "work-assigned.test.js",
     "calendar-events.test.js",
     "item-steps.test.js",
     "status-facts-panel.test.js",
@@ -158,6 +159,7 @@
     "work-focus.test.js": 1,
     "work-evidence.test.js": 1,
     "brief-page.test.js": 1,
+    "work-assigned.test.js": 1,
     "calendar-events.test.js": 1,
     "pm-brief-page-test.js": 30,
     "item-steps.test.js": 1,