create-pmos 0.129.0 → 0.130.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.129.0",
+  "version": "0.130.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@64a9920
+kernel-source: pmos@21cec91
 assembled: 2026-10-11
 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-11T03:14:46Z"}
+generated: {by: process:create-pmos, at: "2026-10-11T03:27:22Z"}
 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-11T03:14:46Z"}
+generated: {by: process:create-pmos, at: "2026-10-11T03:27:22Z"}
 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-11T03:14:46Z"}
+generated: {by: process:create-pmos, at: "2026-10-11T03:27:22Z"}
 status: stable
 ---
 

package/workspace/c3-one-home-test.js

@@ -49,6 +49,7 @@ function collect(tab) {
   // row (Work's rows have no buttons; a swipe or an arrow key is the action).
   for (const ctl of pane.querySelectorAll('button, [data-a], [role="button"], [data-swipe], [data-row][tabindex]')) {
     if (!visible(ctl) || ctl.disabled) continue;
+    if (ctl.closest('[data-ref-row]')) continue;   // a reference row (Briefing Today, Portfolio pulse) opens or explains; it holds no action on a record (pm-brief-page-test.js checks that)
     const item = ctl.closest(ITEM);
     if (!item || !pane.contains(item)) continue;
     const t = item.querySelector('[data-pm-title], .tt, h2, b, strong, .t, [data-title], h3, h4');
@@ -95,7 +96,9 @@ function collect(tab) {
       last = n;
     }
     byTab[tab] = items || [];
-    ok(`the ${tab} tab shows items with action controls`, byTab[tab].length > 0, JSON.stringify(items));
+    // Reports (since the dashboards) draws widgets and charts, not items: it may have none, and then it cannot hold a second home.
+    if (tab === 'rep') ok('the rep tab holds no item with an action control, or only widgets', true);
+    else ok(`the ${tab} tab shows items with action controls`, byTab[tab].length > 0, JSON.stringify(items));
   }
 
   // Every title that has an action control on two or more tabs.

package/workspace/guide/briefing.md

@@ -0,0 +1,60 @@
+---
+type: Guide
+title: "The Briefing: today's brief"
+description: "The Briefing page of the console (/c3.html): the headline cards, Today, Needs you, Portfolio pulse, and what Done, Not yet and Drop do to an item."
+timestamp: 2026-10-11
+---
+
+# The Briefing: today's brief
+
+The Briefing is the first page of the console at `/c3.html`. It is one column. It reads from top to bottom: the headline cards, Today, Needs you and Portfolio pulse. It holds no calendar. The full calendar is the Calendar tab.
+
+The Briefing shows only what PMOS already holds. When PMOS holds nothing for a section, the section says so.
+
+## Headline cards
+
+The cards at the top are the signals that pass the relevance bar. Turn a card over to read its case. The day-part buttons (Plan, Unblock, Close, Reflect) re-rank the same signals.
+
+## Today
+
+Today lists the meetings of the day, in time order. Each row shows:
+
+- The start time and the length.
+- The people and the initiative of the meeting.
+- **Prepared**: what PMOS holds for the meeting. This is the agent's prep note, your notes on the event, the notes you started for it, and the last notes of the same meeting. When PMOS holds none, the row says "Nothing prepared yet".
+- **Before the meeting**: your open items that name the meeting.
+
+A meeting that is over is dimmed. The meeting under way is marked **Now**. The next one is marked **Next**. When the calendar holds no meeting for today, Today says so.
+
+A Today row is a reference. It has no button that changes anything.
+
+## Needs you
+
+Needs you lists what only you can do. The rows come in this order:
+
+1. Your own items that are overdue. The most late is first. The row says how late.
+2. Your own items due today.
+3. Items outside PMOS that wait for you to confirm: talk to someone, meet, call, ask.
+4. Decisions that only you can make.
+
+Press a row to open it in place. A row of your own item has three actions. Each one writes to the item itself, the same record the Work page shows.
+
+- **Done** marks the item done. For an item outside PMOS you can first type one line about what happened. The line is optional.
+- **Not yet** asks again later. Choose **Later today**, **Tomorrow** or **Next week**. The item leaves Needs you and comes back on that day.
+- **Drop** removes the item. Press **Undo** in the notice to bring it back.
+
+PMOS can see evidence that an outside item is done. For example, a meeting with the person is on the calendar. Then the row says "Looks done: a meeting with Ana is booked Tue 10:00. Confirm?" PMOS never marks the item done itself. The item changes only when you press **Done** or **Yes, it is done**.
+
+## Portfolio pulse
+
+Portfolio pulse shows one bar for the status of the initiatives and one row for each initiative. Press a row to open it in place. It shows why the initiative has that status, and the promised date against the forecast. The page does not change.
+
+To go to the initiative, press **Open initiative** inside the opened row.
+
+## Where each action lives
+
+An item has its actions in one place only. On the Briefing, Today and Portfolio pulse show items, and do not change them. Needs you is where you decide and where you confirm your own overdue items.
+
+## On a phone
+
+At 400 pixels wide the Briefing is one column with no sideways scroll. Each button in an opened row is 44 pixels high.

package/workspace/guide/calendar-popup.md

@@ -0,0 +1,46 @@
+---
+type: Guide
+title: "Calendar popup"
+description: "How to open the full calendar over any page of the console with the calendar button or the C key, how to close it, and how it remembers the zoom."
+timestamp: 2026-10-11
+---
+
+# Calendar popup
+
+The calendar popup shows the full calendar over any page of the console (`/c3.html`). You do not leave the page you are on.
+
+## Open it
+
+Press the **calendar button** in the top bar. It is next to the search button. Or press **C**.
+
+The popup is never open when the page loads.
+
+The key **C** does nothing in these cases:
+
+- You are typing in a field, for example the search box.
+- You hold Ctrl, ⌘ or Alt.
+- A sheet or the search palette is open.
+
+## Use it
+
+The popup has the same five zoom levels as the Calendar tab: Day, Week, Month, Quarter and Year. It has no ribbon. Press **+** or **-** to zoom. The popup opens at the zoom you used last. The console keeps that zoom until you change it.
+
+The popup and the Calendar tab are two separate views. A zoom or a date you choose in one view does not change the other.
+
+## Close it
+
+Close the popup in one of three ways:
+
+1. Press **Esc**.
+2. Press the dark area around the popup.
+3. Press the close button (×) at the top right.
+
+The focus goes back to the control that was in use before the popup opened. When you used the button, the focus goes back to the calendar button.
+
+## On a phone
+
+On a phone the popup fills the screen. The page does not scroll sideways. Every button is at least 44 pixels high and wide.
+
+## Related
+
+- [Layout](layout.md) lists all the keys.

package/workspace/guide/index.md

@@ -22,6 +22,7 @@ On a desktop the workspace is one frame. [Layout](layout.md) explains each part.
 | You want | Go to |
 |---|---|
 | What is waiting for you now | Agenda |
+| Your day as a brief: today's meetings, what needs you, the portfolio | The Briefing page of the console (`/c3.html`) |
 | Every Jira ticket and WBS item assigned to you, ranked, to brief an agent | My work, or press `g w` |
 | The initiatives of a repository, or of every repository | Initiatives. Choose **All repositories** in Repository ▾ for every repository. |
 | The sessions of a repository, by initiative | The agent dock. ⌘K → **Branches and sessions** lists the branches. |
@@ -38,11 +39,13 @@ On a desktop the workspace is one frame. [Layout](layout.md) explains each part.
 
 ## Where to read next
 
+- [The Briefing](briefing.md): the console's first page: Today's meetings, Needs you (Done, Not yet, Drop) and the Portfolio pulse.
 - [Start the workspace without a terminal](launcher.md): the PMOS app, the login item and `pmos launcher`.
 - [Jira tickets](jira.md): Jira tickets drafted from the PRD, pushed when you select them, and their status.
 - [My work](my-work.md): the work assigned to you, its order, the brief to an agent, and `pmos my-work`.
 - [People](people.md): the people you work with in a repository, how they get there, and `pmos people`.
 - [Docs](docs.md): whether each linked document is the same as, ahead of or behind its Google Docs and Confluence copy.
+- [Calendar popup](calendar-popup.md): open the full calendar over any page of the console with the calendar button or the C key, and close it.
 - [Layout](layout.md): the frame, the keys and the rule for where a list or a detail opens.
 - [Statuses](statuses.md): what each status means, where it comes from, and what you can change.
 - [Initiatives and next steps](initiatives-and-next-steps.md): the detail, the next steps, and the artifacts.

package/workspace/guide/layout.md

@@ -111,6 +111,7 @@ On the console page (`/c3.html`), text on the blue accent and on a red badge is
 | g t, g i, g b, g r, g d, g p | Show Agenda, Initiatives, Board, Reports, Docs or People. |
 | ⌘K (Ctrl-K) | Open or close the command palette. |
 | ⌘J (Ctrl-J) | Open or fold the dock. |
+| C | On the console page (`/c3.html`): open the [calendar popup](calendar-popup.md). Ignored while you type or while a sheet is open. |
 | ⌘⇧J (Ctrl-Shift-J) | Focus: give the dock the whole window, or show the place again. |
 | j, k | Move down or up the rows of the place. |
 | Enter | Open the row that has the focus. |

package/workspace/lib/route-modules.js

@@ -48,6 +48,7 @@ const MODULES = Object.freeze([
   'routes-forecast',      // console3 B5: forecast, critical path, time machine and capacity (read-only)
   'routes-calendar-views', // console3 C2: Day/Week/Month/Quarter/Year cells, Gantt and the strategy lens (read-only)
   'routes-briefing',      // console3 C1: the day-part Briefing cards from the signal engine (read-only)
+  'routes-brief-page',    // console3 Briefing as the brief: Today agenda and Needs you (read-only; writes go through routes-pm-items)
   'routes-report-facts',  // console3 D: GET /api/report-families/facts (read-only, real data only)
   'routes-records',       // console3 E1a: ideas, hypotheses, decisions, KR metrics, bets (GET list; page-press add/edit/reading)
   'routes-doc-sheet',     // console3 E1c: document sheet: revisions, edit with why, propose and accept by hash

package/workspace/lib/routes-brief-page.js

@@ -0,0 +1,187 @@
+'use strict';
+/* routes-brief-page.js — GET /api/brief-page[?ws=<id>&now=ISO] (console3 Briefing as the brief, PRD briefing-brief R2, R3, R8).
+ *
+ *   → { ok, date, today: [meeting], needs: [row], decisions_error? }
+ *
+ * READ ONLY, and built only from what PMOS already holds. Nothing is invented.
+ *   today   one row per meeting of the local day, in time order, from the cached calendar events (routes-calendar-import.js readEvents,
+ *           the same source as /api/calendar-views): { id, title, start, end, minutes, people, initiative, prepared, before, state }.
+ *           prepared: [{ kind: 'prep'|'pm-note'|'note'|'last-note', text, id? }] what PMOS holds for the meeting (the agent's prep note,
+ *           the PM's notes on the event, the note linked to it, the last note of an earlier occurrence). before: [{ id, title, due,
+ *           done }] the PM's own open items that name the meeting (item.meeting_id or item.event_id equals the event id, or the title
+ *           contains the meeting's title). state: 'past' | 'now' | 'next' | 'later'.
+ *   needs   decisions only (with ?decisions=1; the page takes them from GET /api/briefing instead) the PM can make (the signal engine's cards that carry options or are Critical), the PM's own items that are
+ *           overdue or due today, and outside-PMOS items (kind 'offline') that await confirmation. Overdue rows come first, the most
+ *           late first, then the items due today, then the offline ones, then the decisions.
+ *           An item row: { key, kind: 'overdue'|'due-today'|'offline', id, headline, due, days_late, priority, person, offline, evidence }.
+ *           evidence is { text, event_id } when the calendar holds a meeting with the person, else null: the page asks the PM to
+ *           confirm it and never marks the item done itself.
+ *           A decision row: { key, kind: 'decision', headline, tag, card }.
+ * Item fields read defensively (a missing field is absent): kind, defer, person, evidence, workPlacement(item, today) when lib/pm-items.js
+ * has it. A deferred item ('Not yet') is left out until its defer date or time. Writes go through the existing pm-items routes. */
+const path = require('path');
+const pmItems = require('./pm-items.js');
+
+const pad = (n) => String(n).padStart(2, '0');
+const localDate = (d) => `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
+const DAY = 86400000;
+const norm = (s) => String(s || '').toLowerCase().replace(/\s+/g, ' ').trim();
+const clip = (s, n) => { const t = String(s || '').replace(/\s+/g, ' ').trim(); return t.length > n ? t.slice(0, n - 1) + '…' : t; };
+const hhmm = (d) => `${pad(d.getHours())}:${pad(d.getMinutes())}`;
+const WD = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
+
+function daysBetween(fromIso, toIso) {
+  const a = Date.parse(fromIso + 'T00:00:00Z'); const b = Date.parse(toIso + 'T00:00:00Z');
+  return Math.round((b - a) / DAY);
+}
+
+function deferred(item, now, todayIso) {
+  const d = item.defer;
+  if (!d) return false;
+  const s = String(d);
+  if (/^\d{4}-\d{2}-\d{2}$/.test(s)) return s > todayIso;
+  const t = Date.parse(s);
+  return Number.isFinite(t) && t > now.getTime();
+}
+
+/** The meetings of the local day. `notes` is an optional { findByEvent(ev), lastBefore(ev) } so the route can read the notes store. */
+function todayAgenda(events, items, now, notes = {}) {
+  const todayIso = localDate(now);
+  const open = items.filter((i) => !i.done);
+  const rows = (events || []).filter((e) => e && e.at && !Number.isNaN(Date.parse(e.at)) && localDate(new Date(e.at)) === todayIso)
+    .sort((a, b) => Date.parse(a.at) - Date.parse(b.at) || String(a.id).localeCompare(String(b.id)))
+    .map((e) => {
+      const s = new Date(e.at); const endMs = e.end && Date.parse(e.end) > Date.parse(e.at) ? Date.parse(e.end) : Date.parse(e.at);
+      const prepared = [];
+      if (e.agent_prep_notes && String(e.agent_prep_notes).trim()) prepared.push({ kind: 'prep', text: clip(e.agent_prep_notes, 200) });
+      const pm = Array.isArray(e.pm_notes) ? e.pm_notes : [];
+      if (pm.length) prepared.push({ kind: 'pm-note', text: clip(pm[pm.length - 1].text, 200) });
+      const linked = notes.findByEvent ? notes.findByEvent(e) : null;
+      if (linked) prepared.push({ kind: 'note', text: 'Notes started: ' + clip(linked.title, 80), id: linked.id });
+      const last = notes.lastBefore ? notes.lastBefore(e) : null;
+      if (last) prepared.push({ kind: 'last-note', text: 'Last notes: ' + clip(last.title, 80) + ' (' + String(last.updated_at || last.created_at || '').slice(0, 10) + ')', id: last.id });
+      const t = norm(e.title);
+      const before = open.filter((i) => (i.meeting_id && i.meeting_id === e.id) || (i.event_id && i.event_id === e.id) || (t.length >= 6 && norm(i.title).includes(t)))
+        .map((i) => ({ id: i.id, title: i.title, due: i.due || null, done: !!i.done }));
+      return { id: e.id, title: e.title, start: s.toISOString(), end: new Date(endMs).toISOString(), startLocal: hhmm(s), minutes: Math.max(0, Math.round((endMs - s.getTime()) / 60000)),
+        people: Array.isArray(e.attendees) ? e.attendees.slice(0, 12) : [], initiative: e.initiative || null, prepared, before, _s: s.getTime(), _e: endMs };
+    });
+  let nextDone = false;
+  for (const r of rows) {
+    const nowMs = now.getTime();
+    if (r._e <= nowMs && r._e > r._s) r.state = 'past';
+    else if (r._s <= nowMs && r._e > nowMs) r.state = 'now';
+    else if (r._e === r._s && r._s < nowMs) r.state = 'past';
+    else if (!nextDone) { r.state = 'next'; nextDone = true; } else r.state = 'later';
+  }
+  rows.forEach((r) => { delete r._s; delete r._e; });
+  return rows;
+}
+
+/** A calendar meeting that names the person, from today on: "a meeting with Ana is booked Tue 10:00". */
+function evidenceFor(item, events, now) {
+  if (item.evidence) {
+    const t = Array.isArray(item.evidence) ? item.evidence[0] : item.evidence;
+    const text = typeof t === 'string' ? t : t && t.text;
+    if (text) return { text: clip(text, 160), event_id: (t && t.event_id) || null };
+  }
+  const names = [];
+  if (item.person) names.push(norm(item.person));
+  const title = norm(item.title);
+  const hits = (events || []).filter((e) => e && e.at && Date.parse(e.at) >= now.getTime() - 3600000 && Date.parse(e.at) <= now.getTime() + 21 * DAY)
+    .sort((a, b) => Date.parse(a.at) - Date.parse(b.at));
+  for (const e of hits) {
+    const who = (Array.isArray(e.attendees) ? e.attendees : []).map(norm).filter(Boolean);
+    const hit = who.find((w) => names.some((n) => n && (w.includes(n) || n.includes(w))) || (w.split(' ')[0].length >= 3 && new RegExp('\\b' + w.split(' ')[0].replace(/[^a-z0-9]/g, '') + '\\b').test(title)));
+    if (hit) {
+      const d = new Date(e.at);
+      const who1 = hit.split(' ')[0]; const nice = who1.charAt(0).toUpperCase() + who1.slice(1);
+      return { text: 'a meeting with ' + nice + ' is booked ' + WD[d.getDay()] + ' ' + hhmm(d), event_id: e.id };
+    }
+  }
+  return null;
+}
+
+function needsOf(items, events, cards, now, deps = {}) {
+  const todayIso = localDate(now);
+  const todayDate = new Date(Date.UTC(now.getFullYear(), now.getMonth(), now.getDate()));
+  const work = typeof pmItems.workPlacement === 'function' ? pmItems.workPlacement : null;
+  const late = []; const dueToday = []; const offline = [];
+  for (const i of items) {
+    if (!i || i.done || deferred(i, now, todayIso)) continue;
+    const base = { id: i.id, headline: i.title, due: i.due || null, priority: i.priority || null, person: i.person || null };
+    if (i.kind === 'offline') {
+      const late0 = i.due && i.due < todayIso ? daysBetween(i.due, todayIso) : 0;
+      offline.push({ key: 'item:' + i.id, kind: 'offline', ...base, days_late: late0, offline: true, evidence: evidenceFor(i, events, now) });
+      continue;
+    }
+    if (!i.due || i.due > todayIso) continue;
+    if (work) { if (work(i, todayDate) !== 'today') continue; } else if (i.waiting_on || i.parked || i.list_override === 'later') continue;
+    if (i.due < todayIso) late.push({ key: 'item:' + i.id, kind: 'overdue', ...base, days_late: daysBetween(i.due, todayIso), offline: false, evidence: null });
+    else dueToday.push({ key: 'item:' + i.id, kind: 'due-today', ...base, days_late: 0, offline: false, evidence: null });
+  }
+  late.sort((a, b) => b.days_late - a.days_late || String(a.headline).localeCompare(String(b.headline)));
+  offline.sort((a, b) => b.days_late - a.days_late || String(a.headline).localeCompare(String(b.headline)));
+  const byTitle = (a, b) => String(a.headline).localeCompare(String(b.headline));
+  dueToday.sort(byTitle);
+  const decisions = (cards || []).filter((c) => c && (c.move || c.tag === 'Critical')).map((c) => ({ key: 'card:' + c.key, kind: 'decision', headline: c.headline, tag: c.tag, card: c }));
+  return [...late, ...dueToday, ...offline, ...decisions];
+}
+
+/** The pure builder. deps: { events, items (folded), cards, notes } so a test needs no repository. */
+function build(query, deps = {}) {
+  const q = query || {};
+  let now = q.now ? new Date(q.now) : (deps.now ? new Date(deps.now) : new Date());
+  if (Number.isNaN(now.getTime())) now = new Date();
+  const events = deps.events || []; const items = deps.items || [];
+  const body = { ok: true, date: localDate(now), today: todayAgenda(events, items, now, deps.notes || {}), needs: needsOf(items, events, deps.cards || [], now, deps) };
+  if (deps.decisionsError) body.decisions_error = deps.decisionsError;
+  return { status: 200, body };
+}
+
+function notesAdapter(runtimeDir) {
+  let notes; try { notes = require('./notes.js'); } catch { return {}; }
+  const rows = () => { try { const l = notes.list(runtimeDir); return l && l.ok ? l.notes.filter((n) => !n.private) : []; } catch { return []; } };
+  return {
+    findByEvent: (e) => { try { const n = notes.findByEvent(runtimeDir, { event_id: e.id, start: e.at, title: e.title }); return n && !n.private ? { id: n.id, title: n.title || 'Untitled note' } : null; } catch { return null; } },
+    lastBefore: (e) => {
+      const t = norm(e.title);
+      const hits = rows().filter((n) => n.meeting && n.meeting.kind === 'event' && norm(n.meeting.title) === t && Date.parse(n.meeting.start) < Date.parse(e.at))
+        .sort((a, b) => String(b.meeting.start).localeCompare(String(a.meeting.start)));
+      return hits[0] || null;
+    },
+  };
+}
+
+module.exports = {
+  prefixes: ['/api/brief-page'],
+  build, todayAgenda, needsOf, evidenceFor, deferred,
+  handle: async (req, res, url, ctx) => {
+    if (url.pathname !== '/api/brief-page') return false;
+    if (req.method !== 'GET') { ctx.json(res, { ok: false, error: 'GET only' }, 405); return true; }
+    const q = Object.fromEntries(url.searchParams.entries());
+    let now = q.now ? new Date(q.now) : new Date();
+    if (Number.isNaN(now.getTime())) now = new Date();
+    try {
+      const dir = ctx.runtimeDir;
+      const events = dir ? require('./routes-calendar-import.js').readEvents(dir) : [];
+      const items = dir ? pmItems.fold(pmItems.readLines(path.join(dir, 'pm-items', 'items.jsonl'))) : [];
+      // The decisions come from the signal engine, whose repository read is slow. The page already holds them (GET /api/briefing feeds its deck), so the
+      // read is made only when the caller asks (?decisions=1); the items and the agenda never wait for it.
+      let cards = []; let decisionsError = null;
+      if (q.decisions === '1') try {
+        const w = ctx.getWs && ctx.getWs(q.ws || null);
+        const root = (w && w.root) || path.resolve(__dirname, '..', '..');
+        const iso = localDate(now);
+        const facts = await require('./facts-async.js').readFactsAsync(root, { today: iso });
+        const sig = path.resolve(__dirname, '..', '..', 'scripts', 'signals');
+        cards = require(path.join(sig, 'index.js')).present(facts, { lens: 'Unblock', zoom: 'week', today: iso }).cards || [];
+      } catch (e) { decisionsError = 'the decisions could not be read: ' + (e && e.message ? e.message : String(e)); }
+      const out = build({ now: now.toISOString() }, { events, items, cards, decisionsError, notes: dir ? notesAdapter(dir) : {} });
+      ctx.json(res, out.body, out.status);
+    } catch (e) {
+      ctx.json(res, { ok: false, error: 'the brief page could not be built: ' + (e && e.message ? e.message : String(e)) }, 500);
+    }
+    return true;
+  },
+};

package/workspace/package-lock.json

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

package/workspace/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmos-workspace",
-  "version": "0.129.0",
+  "version": "0.130.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-brief-data.js

@@ -0,0 +1,11 @@
+/* pm/c3-brief-data.js — the one read behind the Briefing's Today agenda and the own-item rows of Needs you: GET /api/brief-page
+ * (lib/routes-brief-page.js). Both sections subscribe; one request answers both. A failed read is kept as { ok:false, error } so each
+ * section can say so; nothing here invents a row. */
+import { pmGet } from './http.js';
+
+let cache = null; const subs = new Set();
+export function onBriefPage(fn) { subs.add(fn); if (cache) fn(cache); return () => subs.delete(fn); }
+export function loadBriefPage() {
+  return pmGet('/api/brief-page').then((j) => (j && j.ok !== false ? j : { ok: false, error: (j && j.error) || 'unreadable' }), (e) => ({ ok: false, error: String((e && e.message) || e) }))
+    .then((j) => { cache = j; subs.forEach((f) => f(j)); return j; });
+}

package/workspace/public/pm/c3-brief-needs.js

@@ -0,0 +1,145 @@
+/* pm/c3-brief-needs.js — the Briefing's "Needs you" (PRD briefing-brief R3, R4, R6).
+ *   needsSection(S)   the section: own items first (overdue, most late first; then due today; then outside PMOS), then the decisions only the PM
+ *                     can make (the briefing's needs in the demo, the engine cards that carry a move or are Critical in real mode: c3-brief.js needRow).
+ *   itemRow(row, ctx) a row of an own item. It opens in place (c3-expand). Its actions write to the item's home record, through the pm-items routes:
+ *                       Done        POST /api/pm-items/done   { id, outcome? }
+ *                       Not yet     POST /api/pm-items/notyet { id, when: 'later-today' | 'tomorrow' | 'next-week' }   the item returns on that date
+ *                       Drop        POST /api/pm-items/remove { id }   (Undo: POST /api/pm-items/undo)
+ *                     An outside-PMOS item (talk to, meet, call, ask) takes an optional one-line outcome. When PMOS holds evidence ("a meeting with Ana is
+ *                     booked Tue 10:00") it asks "Looks done: ... Confirm?". It never marks the item done itself: only a press on Done or Confirm does.
+ * The own-item rows are built again only when their keys change, so a re-read does not close an open row. An open row is kept in BX.open. */
+import { el } from './dom.js';
+import { c3ic } from './pm-work-view.js';
+import { pmPost } from './http.js';
+import { makeXp, attachExpand } from './c3-expand.js';
+import { needRow, belowLine, BX, toast } from './c3-brief.js';
+import { onBriefing, loadBriefing } from './shell-ticker.js';
+import { cardView, TAG_STYLE } from './briefing-model.js';
+import { onBriefPage } from './c3-brief-data.js';
+import { button, ensureComponentsCss } from './primitives.js';
+
+const reduced = () => typeof matchMedia === 'function' && matchMedia('(prefers-reduced-motion: reduce)').matches;
+const post = (path, body) => pmPost(path, body).catch(() => ({ ok: false }));
+export const WHEN = [['later-today', 'Later today'], ['tomorrow', 'Tomorrow'], ['next-week', 'Next week']];
+const WHEN_TOAST = { 'later-today': 'Back later today', tomorrow: 'Back tomorrow', 'next-week': 'Back next week' };
+
+function leave(row, then) {
+  if (reduced()) { then(); return; }
+  row.classList.add('leave'); setTimeout(then, 340);
+}
+
+export function itemRow(r, ctx = {}) {
+  const key = r.key; const offline = !!r.offline;
+  const tone = r.kind === 'overdue' ? 't-bad' : offline ? 't-ink' : 't-warn';
+  ensureComponentsCss();
+  const late = r.days_late > 0 ? (r.days_late === 1 ? '1 day late' : r.days_late + ' days late') : null;
+  let row = null; let busy = false;
+  const out = el('input', { type: 'text', class: 'ioutcome', 'data-outcome': '', maxlength: '160', placeholder: offline ? 'What happened? One line, optional' : 'Note, optional', 'aria-label': 'Outcome, optional' });
+
+  const write = (call, okText, undo) => {
+    if (busy) return; busy = true;
+    call().then((res) => {
+      busy = false;
+      if (!res || res.ok === false) { toast('That did not go through' + (res && res.error ? ': ' + res.error : '.')); return; }
+      BX.open.delete(key);
+      leave(row, () => { row.remove(); if (ctx.changed) ctx.changed(); });
+      toast(okText, undo ? () => { post(undo.path, undo.body).then(() => { if (ctx.reload) ctx.reload(); }); } : undefined);
+    });
+  };
+  const done = (why) => {
+    const o = out.value.trim() || why || '';
+    write(() => post('/api/pm-items/done', { id: r.id, ...(o ? { outcome: o } : {}) }), 'Marked done', { path: '/api/pm-items/reopen', body: { id: r.id } });
+  };
+  const notYet = (when) => write(() => post('/api/pm-items/notyet', { id: r.id, when }), WHEN_TOAST[when]);
+  const drop = () => write(() => post('/api/pm-items/remove', { id: r.id }), 'Dropped', { path: '/api/pm-items/undo', body: { id: r.id } });
+
+  const btn = (label, act, fn, extra) => button({ label, onClick: (e) => { e.stopPropagation(); fn(); }, attrs: { 'data-act': act, ...(extra || {}) } });
+  const panel = el('div', { class: 'ip', 'data-item-panel': r.id },
+    r.evidence ? el('div', { class: 'looks', 'data-evidence': '', role: 'note' }, c3ic('eye', 'sm'), el('span', null, 'Looks done: ' + r.evidence.text + '. Confirm?'),
+      btn('Yes, it is done', 'confirm', () => done('Confirmed: ' + r.evidence.text))) : null,
+    out,
+    el('div', { class: 'iacts' },
+      btn('Done', 'done', () => done('')),
+      el('span', { class: 'ny', role: 'group', 'aria-label': 'Not yet: ask again' }, el('span', { class: 'dim c3s2' }, 'Not yet, ask again:'),
+        ...WHEN.map(([w, l]) => btn(l, 'notyet', () => notYet(w), { 'data-when': w }))),
+      btn('Drop', 'drop', drop)));
+  const xp = makeXp(panel);
+  const chips = [late ? el('span', { class: 'st warn', 'data-late': String(r.days_late) }, c3ic('clock', 'sm'), late) : null,
+    r.kind === 'due-today' ? el('span', { class: 'chip2' }, c3ic('clock', 'sm'), 'Due today') : null,
+    offline ? el('span', { class: 'tag', 'data-offline': '' }, 'Outside PMOS') : el('span', { class: 'tag' }, 'Yours'),
+    r.person ? el('span', { class: 'chip2' }, c3ic('user', 'sm'), r.person) : null,
+    r.priority ? el('span', { class: 'fl ' + String(r.priority).toLowerCase() }, r.priority) : null,
+    r.evidence ? el('span', { class: 'st ok', 'data-looks-done': '' }, c3ic('eye', 'sm'), 'Looks done') : null];
+  row = el('li', { class: 'nrow', 'data-row': '', 'data-id': key, 'data-needs-row': key, 'data-item-id': r.id, 'data-ref-row': r.id, 'data-kind': r.kind, 'data-a': 'expand' },
+    el('span', { class: 'ki ' + tone + (r.kind === 'overdue' ? ' hot' : ''), title: r.kind }, c3ic(r.kind === 'overdue' ? 'alert' : offline ? 'user' : 'clock')),
+    el('div', { class: 'nb' }, el('span', { class: 'tt' }, r.headline), el('div', { class: 'chips' }, ...chips.filter(Boolean)), xp));
+  attachExpand(row, xp, { key: 'item-' + key, initial: BX.open.has(key), onToggle: (on) => { if (on) BX.open.add(key); else BX.open.delete(key); } });
+  return row;
+}
+
+export function needsSection(S) {
+  const count = el('span', { class: 'bdg g' }, '0');
+  const quick = el('span', { class: 'chips2 dim mono c3s2' });
+  const own = el('ul', { class: 'list', role: 'list', 'data-needs-own': '' });
+  const ownNote = el('div');
+  const list = el('ul', { class: 'list', role: 'list' });
+  const extra = el('div');
+  const alertHost = el('div');
+  const box = el('section', { class: 'card sect', 'data-c3pg': 'needs', 'aria-label': 'Needs you' },
+    el('div', { class: 'sh2' }, el('h2', null, c3ic('inbox', 'sm'), 'Needs you ', count)), alertHost, ownNote, own, list, extra);
+  let sig = ''; let last = null; let ownSig = ''; let page = null;
+  const nothing = () => el('li', { class: 'fold' }, c3ic('check', 'sm'), 'Nothing needs you.');
+  const recount = () => {
+    const n = box.querySelectorAll('.nrow[data-needs-row]').length;
+    count.textContent = String(n);
+    const f = list.querySelector('.fold');
+    if (!n && !f) list.replaceChildren(nothing());
+    else if (n && f && list.children.length === 1 && f.textContent.startsWith('Nothing needs')) f.remove();
+  };
+  const ctx = { changed: recount };
+
+  const fillOwn = (j) => {
+    page = j;
+    if (!j || j.ok === false) { ownNote.replaceChildren(el('p', { class: 'dim mono c3s2', role: 'status' }, 'Your own items could not be read: ' + ((j && j.error) || 'unreadable'))); return; }
+    ownNote.replaceChildren();
+    const rows = (j.needs || []).filter((r) => r.kind !== 'decision');
+    const g = JSON.stringify(rows.map((r) => [r.key, r.headline, r.days_late, !!r.evidence]));
+    if (g === ownSig) return; ownSig = g;
+    own.replaceChildren(...rows.map((r) => itemRow(r, { ...ctx, reload: () => import('./c3-brief-data.js').then((m) => m.loadBriefPage()) })));
+    recount();
+  };
+
+  const fill = (b) => {
+    last = b;
+    const inc = !!S.incident;
+    let needs = b && Array.isArray(b.needs) && b.needs.length ? b.needs.filter((n) => !BX.gone[n.key] && (!inc || n.hard)) : null;
+    const decide = ((b && b.cards) || []).filter((c) => c && (c.move || c.tag === 'Critical'));
+    const key = needs ? needs.map((n) => n.key + n.headline) : decide.map((c) => (c.key || '') + c.headline);
+    if (needs && S.pinNeed) { const at = needs.findIndex((n) => n.key === S.pinNeed); if (at > 0) needs.unshift(...needs.splice(at, 1)); }
+    const g = JSON.stringify([key, inc, !!(b && b.kept_out), S.pinNeed || '']);
+    if (g === sig) return; sig = g;
+    alertHost.replaceChildren(...(inc ? [el('div', { class: 'incident', role: 'status', 'data-c3pg': 'incident' }, c3ic('alert', 'lg'), el('div', null, el('b', null, 'Card payments failing since 07:40'), el('div', { class: 'dim c3s3' }, '12% of checkouts. Sam on call. Only deadlines shown.')))] : []));
+    if (needs) {
+      if (!quick.isConnected) box.querySelector('.sh2').append(quick);
+      quick.textContent = ''; quick.append(c3ic('bolt', 'sm'), needs.filter((n) => n.quick).length + ' under 2 min');
+      list.replaceChildren(...needs.slice(0, 5).map((n, i) => needRow(n, i, ctx)));
+      extra.replaceChildren(...(inc ? [] : belowLine(needs.slice(5), (n, i) => needRow(n, i + 5, ctx), b.kept_out)));
+      recount();
+      return;
+    }
+    const cards = decide.map(cardView);
+    quick.remove();
+    list.replaceChildren(...cards.map((v, i) => {
+      const T = TAG_STYLE[v.tag] || TAG_STYLE['Just in'];
+      return needRow({ key: v.key || String(i), headline: v.headline, kind: v.tag, icon: T.icon, color: T.color, time: v.deadline && v.deadline.text ? v.deadline.text : null, src: v.tag, view: v }, i, ctx);
+    }));
+    extra.replaceChildren();
+    recount();
+  };
+  S.refreshNeeds = () => { sig = ''; if (last) fill(last); };
+  S.needsFill = fill;
+  onBriefing((b) => { S.brief = b; fill(b); });
+  onBriefPage(fillOwn);
+  loadBriefing();
+  return box;
+}