create-pmos 0.238.0 → 0.240.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.238.0",
+  "version": "0.240.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@96d9fef
+kernel-source: pmos@c7f4eb5
 assembled: 2026-10-14
 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-14T12:11:14Z"}
+generated: {by: process:create-pmos, at: "2026-10-14T12:42:25Z"}
 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-14T12:11:14Z"}
+generated: {by: process:create-pmos, at: "2026-10-14T12:42:25Z"}
 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-14T12:11:14Z"}
+generated: {by: process:create-pmos, at: "2026-10-14T12:42:25Z"}
 status: stable
 ---
 

package/workspace/guide/briefing.md

@@ -1,13 +1,13 @@
 ---
 type: Guide
 title: "The Briefing: today's brief"
-description: "The Briefing page of the console (/): the headline cards, Today, Needs you, Portfolio pulse, and what Done, Not yet and Drop do to an item."
+description: "The Briefing page of the console (/): The brief, the headline cards, Today, Needs you, Mentions, Portfolio pulse, and what Done, Not yet and Drop do to an item."
 timestamp: 2026-10-14
 ---
 
 # The Briefing: today's brief
 
-The Briefing is the first page of the console at `/`. It has two columns. The left column holds the greeting, the headline cards and Needs you. The right column holds Today and Portfolio pulse. It holds no calendar. The full calendar is the Calendar tab.
+The Briefing is the first page of the console at `/`. It has two columns. The left column holds the greeting, The brief, the headline cards, Needs you and Mentions. The right column holds Today and Portfolio pulse. It holds no calendar. The full calendar is the Calendar tab.
 
 Review is in the Work page, in its Review lens. Handled, What I could stop and Data you can lean on are in Reports, under Drafts.
 
@@ -35,6 +35,20 @@ Overdue cards come first, the most late first. The signal engine's cards come ne
 
 Above the cards, the greeting names the part of the day, for example "Good morning, Wawan". The name is the first word of the git user name on the computer where PMOS runs. When git holds no name, the greeting has none. The part of the day follows the clock. There is no button to change it. When the clock moves to a new part, the line under the greeting and the order of the cards change after you stop using the page for a minute.
 
+## The brief
+
+The brief is one paragraph under the greeting, above the headline cards. Read it to know the day in a few seconds. It says, in this order:
+
+1. The one decision that the day turns on. When no row is a decision that only you can make, it names the first row of Needs you.
+2. How many things need you, how many are overdue, and the oldest overdue item.
+3. Who waits for your reply to a mention.
+4. How many meetings are left today, and the next meeting that still has a to-do before it.
+5. Which initiatives are off track or at risk, and how many are on track.
+
+Each number and each title comes from a row on the page. The count of things that need you is the same as the count of Needs you. Press a title to go to its row. The line at the right of the title says when PMOS wrote the paragraph and which sections it read. When a section changes, for example when you mark an item done, the paragraph changes too. In the evening the paragraph says what is still open and how many meetings you held.
+
+PMOS writes the paragraph from the rows on the page. It does not call a model and it does not write a record.
+
 ## Today
 
 Today starts with one line: the meeting that is on now or next, how many meetings are left, and how many of them are prepped, with a small ring. **Open calendar** opens the calendar. Under it, Today lists the meetings of the day, in time order. Each row shows:
@@ -73,6 +87,20 @@ Press a row to open it in place. A row of your own item has three actions. Each
 
 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**.
 
+## Mentions
+
+Mentions lists the places where someone mentioned you today: Slack, Jira, Confluence and mail. The list comes from today's morning brief. When there is no morning brief for today, Mentions says so.
+
+The section is quiet. It shows one line that names who waits for your reply, for example "Priya in Slack and Dara in Jira are waiting on your reply." The header says how many need a reply. Press **Show all** to open the list. A tab for each source filters the list. Each row shows the person, the text they wrote, the source and the place, the time, and **needs your reply** or **for your information**. Each row has these actions:
+
+- **Open in Slack** (or Jira, Confluence, Mail) opens the mention in a new tab. A mention with no link has no such button.
+- **Add to Work** adds an item to your Work list, for example "Reply to Dara (Jira) by today".
+- **Mark read** removes the row from the list. Press **Undo** in the notice to bring it back.
+
+A mention that is already a row of Needs you does not show again in Mentions. That row in Needs you has a **mentioned you** tag.
+
+PMOS does not reply, react or post in Slack, Jira, Confluence or mail.
+
 ## Portfolio pulse
 
 Portfolio pulse says how many initiatives need attention, then shows one bar for the status of the initiatives and one row for each initiative. An initiative shows when it has a promised date, or when PMOS holds a read of its Jira epic. A row from a Jira epic shows "3 of 8 done" and a bar. "Done" counts the tickets under the epic that are done in Jira. A row with blocked tickets says **Blocked**. The Jira read is the last Jira status check; the opened row says its date. When no initiative has a promised date or a Jira read, the pulse says so. **All initiatives** at the bottom opens the Initiatives page. Press a row to open it in place. It shows why the initiative has that status, the promised date against the forecast, and the Jira progress when PMOS holds it. The page does not change.
@@ -85,6 +113,6 @@ An item has its actions in one place only. On the Briefing, Today and Portfolio
 
 ## On a phone
 
-At 400 pixels wide the Briefing is one column (greeting, cards, Needs you, Today, Portfolio pulse) with no sideways scroll. Each button in an opened row is 44 pixels high.
+At 400 pixels wide the Briefing is one column (greeting, The brief, cards, Needs you, Mentions, Today, Portfolio pulse) with no sideways scroll. Each button in an opened row is 44 pixels high.
 
 On a phone, every console page has the same top. The page title has Record at its right. The sunrise line is under it, then the tool buttons in one row. The five tabs share the width, and each tab shows an icon over its name, so Initiatives and Reports are always on screen. A count shows at the top right of its tab's icon. A person in a row shows as a small round letter, and you can tap anywhere in the 44-pixel square around it. A line that has a sentence and a due date wraps like normal text.

package/workspace/guide/document-sheet.md

@@ -2,13 +2,15 @@
 type: Guide
 title: "The document sheet"
 description: "How to read a document as rich text with its outline, edit it, review the agent's proposals section by section, read the edit log, keep its Confluence and Google Doc copies in step, see the documents around it, and clear a stale document."
-timestamp: 2026-10-12
+timestamp: 2026-10-14
 ---
 
 # The document sheet
 
 Open a document in Initiatives › Documents, in an initiative's Docs, or from Reports. The document opens in a sheet on the right. On a phone, it opens from the bottom. The segment under the title has six modes.
 
+To make the sheet wider, select **Half**, **3/4** or **Whole** beside Close; **Normal** goes back to the standard width. The sheet keeps your choice in this browser and opens at that size next time. On a phone the sheet always fills the screen, so the sizes do not show.
+
 ## Read
 
 Read shows the document as formatted text: headings, bold, links, tables, checklists and callouts. The front matter shows as properties at the top.

package/workspace/lib/route-modules.js

@@ -49,7 +49,8 @@ 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-brief-page',    // console3 Briefing as the brief: Today agenda, Needs you and Mentions (read-only; writes go through routes-pm-items)
+  'routes-mentions',      // console3 Briefing Mentions: the PM's read marks (page press only)
   'routes-phone-day',     // phone companion: the agent's finished drafts, the evening recap and tomorrow at a glance (read-only)
   '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)

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

@@ -17,8 +17,15 @@
  *           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 }.
+ *   mentions  the items of today's morning brief (<runtime>/briefs/<date>.json) that say `mention: true`: someone named the PM in Slack, Jira,
+ *           Confluence or mail (initiative c3-brief-summary-mentions). Newest first: { id, source, who, where, text, at, reply, link, initiative,
+ *           in_needs, need_key, read }. text is the item's quote, else its ask, else its title. at is the time of the author's last message in the item's thread.
+ *           reply is the item's reply_needed. in_needs: a worth-asking item, which Needs you shows as its row need_key ("ask:<id>"). A mention whose ledger copy
+ *           (brief:<id>) is done or dropped is left out. read: the PM marked it read (<runtime>/mentions/read.jsonl). A field the item lacks is absent.
+ *           mentions is null when there is no brief for today.
  * 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. */
+ * has it. A deferred item ('Not yet') is left out until its defer date or time. Writes go through the existing pm-items routes; a mention's
+ * read mark goes through POST /api/mentions/read (routes-mentions.js). */
 const path = require('path');
 const pmItems = require('./pm-items.js');
 const { repoScript } = require('./repo-script.js');
@@ -129,13 +136,53 @@ function needsOf(items, events, cards, now, deps = {}) {
   return [...late, ...dueToday, ...offline, ...decisions];
 }
 
+const MENTION_ID = /^[0-9a-f]{12}$/;
+const httpsUrl = (v) => { const t = String(v || ''); try { return new URL(t).protocol === 'https:' && t.length <= 500 ? t : null; } catch { return null; } };
+
+/** The read marks: the last line for each id wins. */
+function readMarks(lines) {
+  const m = new Map();
+  for (const l of lines || []) if (l && MENTION_ID.test(String(l.id || '')) && typeof l.read === 'boolean') m.set(l.id, l.read);
+  return m;
+}
+
+/** The mentions of today's brief. itemLines: the PM's ledger (pm-items items.jsonl lines); reads: readMarks(). Pure. */
+function mentionsOf(brief, itemLines, reads, todayIso) {
+  if (!brief || brief.date !== todayIso) return null;
+  const folded = pmItems.fold(itemLines || []);
+  const done = new Set(folded.filter((i) => i.done).map((i) => i.id));
+  const live = new Set(folded.map((i) => i.id));
+  const dropped = new Set((itemLines || []).filter((l) => l && l.id && !live.has(l.id)).map((l) => l.id));
+  const seen = new Set(); const out = [];
+  for (const [list, ask] of [[brief.priorities, false], [brief.worth_asking, true]]) {
+    for (const x of Array.isArray(list) ? list : []) {
+      if (!x || !x.mention || !MENTION_ID.test(String(x.id || '')) || seen.has(x.id)) continue;
+      seen.add(x.id);
+      const key = 'brief:' + x.id;
+      if (done.has(key) || dropped.has(key)) continue;
+      const thread = Array.isArray(x.thread) ? x.thread : [];
+      const mine = thread.filter((m) => m && m.at && !Number.isNaN(Date.parse(m.at)) && (!x.who || m.who === x.who));
+      const row = { id: x.id, source: x.source, text: clip(x.quote || x.ask || x.title, 280), reply: x.reply_needed === true, in_needs: ask || !!x.worth_asking, read: reads && reads.get(x.id) === true };
+      if (x.who) row.who = clip(x.who, 120);
+      if (x.where) row.where = clip(x.where, 120);
+      row.at = mine.length ? new Date(mine[mine.length - 1].at).toISOString() : null;
+      const link = httpsUrl(x.link); if (link) row.link = link;
+      if (x.initiative_id) row.initiative = x.initiative_id;
+      if (row.in_needs) row.need_key = 'ask:' + x.id;   // the Needs you row it is (briefing-real.js askNeed)
+      out.push(row);
+    }
+  }
+  return out.sort((a, b) => (b.at ? Date.parse(b.at) : 0) - (a.at ? Date.parse(a.at) : 0));
+}
+
 /** 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) };
+  const body = { ok: true, date: localDate(now), today: todayAgenda(events, items, now, deps.notes || {}), needs: needsOf(items, events, deps.cards || [], now, deps),
+    mentions: mentionsOf(deps.brief || null, deps.itemLines || [], readMarks(deps.readLines), localDate(now)) };
   if (deps.decisionsError) body.decisions_error = deps.decisionsError;
   return { status: 200, body };
 }
@@ -164,7 +211,8 @@ function firstName(cwd) {
 
 module.exports = {
   prefixes: ['/api/brief-page'],
-  build, todayAgenda, needsOf, evidenceFor, deferred, firstName, notesAdapter,
+  MENTION_ID,
+  build, todayAgenda, needsOf, evidenceFor, deferred, firstName, notesAdapter, mentionsOf, readMarks,
   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; }
@@ -174,7 +222,10 @@ module.exports = {
     try {
       const dir = ctx.runtimeDir;
       const events = dir ? require('./calendar-events.js').readAll(dir, { now: now.getTime() }) : [];
-      const items = dir ? pmItems.fold(pmItems.readLines(path.join(dir, 'pm-items', 'items.jsonl'))) : [];
+      const itemLines = dir ? pmItems.readLines(path.join(dir, 'pm-items', 'items.jsonl')) : [];
+      const items = pmItems.fold(itemLines);
+      let brief = null; try { brief = dir ? JSON.parse(require('fs').readFileSync(path.join(dir, 'briefs', localDate(now) + '.json'), 'utf8')) : null; } catch { brief = null; }
+      const readLines = dir ? pmItems.readLines(path.join(dir, 'mentions', 'read.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;
@@ -185,7 +236,7 @@ module.exports = {
         const facts = await require('./facts-async.js').readFactsAsync(root, { today: iso });
         cards = require(repoScript('signals/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) : {} });
+      const out = build({ now: now.toISOString() }, { events, items, itemLines, brief, readLines, cards, decisionsError, notes: dir ? notesAdapter(dir) : {} });
       if (out.body && out.body.ok) out.body.me = firstName(path.resolve(__dirname, '..', '..'));
       ctx.json(res, out.body, out.status);
     } catch (e) {

package/workspace/lib/routes-mentions.js

@@ -0,0 +1,37 @@
+'use strict';
+/* routes-mentions.js — POST /api/mentions/read { id, read } → { ok }   (initiative c3-brief-summary-mentions)
+ *
+ * The PM marked a mention of today's brief read on the Briefing (read: false undoes it). One appended line in <runtime>/mentions/read.jsonl:
+ * { id, read, at }. GET /api/brief-page reads the file back (routes-brief-page.js readMarks: the last line for an id wins).
+ * The page press only (pm-guard requirePagePress). Nothing is sent to Slack, Jira, Confluence or mail. */
+const path = require('path');
+const guard = require('./pm-guard.js');
+const pmItems = require('./pm-items.js');
+const { MENTION_ID } = require('./routes-brief-page.js');
+
+/** The check of a body: null when it is good, else the reason. Pure. */
+function badBody(b) {
+  if (!b || !MENTION_ID.test(String(b.id || ''))) return 'id must be a mention id (12 hex characters)';
+  if (typeof b.read !== 'boolean') return 'read must be true or false';
+  return null;
+}
+
+module.exports = {
+  prefixes: ['/api/mentions'],
+  badBody,
+  handle: async (req, res, url, ctx) => {
+    if (url.pathname !== '/api/mentions/read') return false;
+    if (req.method !== 'POST') { ctx.json(res, { ok: false, error: 'POST only' }, 405); return true; }
+    const got = await ctx.readJson(req);
+    if (!got.ok) { ctx.json(res, { ok: false, error: 'invalid JSON body' }, 400); return true; }
+    const b = got.body || {};
+    const g = guard.requirePagePress(req, b);
+    if (!g.ok) { ctx.json(res, { ok: false, error: g.error }, g.status); return true; }
+    const err = badBody(b);
+    if (err) { ctx.json(res, { ok: false, error: err }, 400); return true; }
+    if (!ctx.runtimeDir) { ctx.json(res, { ok: false, error: 'no runtime folder' }, 500); return true; }
+    pmItems.appendEvent(path.join(ctx.runtimeDir, 'mentions', 'read.jsonl'), { id: b.id, read: b.read }, new Date());
+    ctx.json(res, { ok: true });
+    return true;
+  },
+};

package/workspace/package-lock.json

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

package/workspace/package.json

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

package/workspace/public/pm/briefing-deck.js

@@ -364,6 +364,7 @@ function draw(S) {
   if (bare && (!d || !d.ok || d.scope !== S.ctx.scope || !(d.cards || []).length)) { S.root.replaceChildren(); S.root.hidden = true; S.flip = null; return; }
   if (bare) S.root.hidden = false;
   const kids = bare ? [] : [stance(S)];
+  if (!bare && S.ctx && S.ctx.afterStance) kids.push(S.ctx.afterStance);   // a node the page keeps under the greeting (console3: The brief)
   if (!d) kids.push(el('p', { class: 'dim mono', style: small, role: 'status' }, 'Reading the repository'));
   else if (!d.ok) kids.push(el('p', { class: 'dim mono', style: small, role: 'status', 'data-bf': 'error' }, 'The briefing could not be read: ' + d.error));
   else {

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

@@ -0,0 +1,136 @@
+/* pm/c3-brief-mentions.js — the Briefing's "Mentions" (initiative c3-brief-summary-mentions).
+ *
+ * Everything today's brief marks as a mention of the PM (Slack, Jira, Confluence, mail), from GET /api/brief-page `mentions`
+ * (routes-brief-page.js mentionsOf). Quiet by default: one line that names who waits on a reply. "Show all" opens the list, with a tab for
+ * each source that has a mention. A row: the person, the quoted text, the source and place, the time, "needs your reply" or "for your
+ * information", the initiative. Its actions:
+ *   Open in <source>   the mention's own https link, in a new tab (no link, no button)
+ *   Add to Work        POST /api/pm-items/add { line: "Reply to <who> (<source>) by today" }   (a reply) or "Read <who>'s note (<source>)"
+ *   Mark read          POST /api/mentions/read { id, read: true }; Undo sends read: false
+ * A mention that is a worth-asking item (in_needs) is not listed: Needs you shows it (its row is need_key), and that row carries a "mentioned you" tag
+ * (tagNeeds, called after every Needs you redraw). Nothing here replies, reacts or posts in Slack, Jira, Confluence or mail. */
+import { el } from './dom.js';
+import { c3ic } from './pm-work-view.js';
+import { pmPost } from './http.js';
+import { toast } from './c3-toast.js';
+import { onBriefPage, loadBriefPage } from './c3-brief-data.js';
+import { button, tabs, SEL, ensureComponentsCss } from './primitives.js';
+import { ensureSprite } from './icons.js';
+import { srcName, waitingMentions } from './c3-brief-summary.js';
+
+const p2 = (n) => String(n).padStart(2, '0');
+const first = (s) => String(s || '').trim().split(/\s+/)[0];
+const ICON = { slack: 'reply', jira: 'org', confluence: 'doc', mail: 'mail' };
+const ORDER = ['slack', 'jira', 'confluence', 'mail'];
+const post = (p, b) => pmPost(p, b).catch((e) => ({ ok: false, error: String((e && e.message) || e) }));
+
+/** When, said the way the Briefing says times: "09:15" today, "yesterday 17:05" before. */
+function whenOf(iso, now = new Date()) {
+  if (!iso) return null;
+  const d = new Date(iso); const hm = p2(d.getHours()) + ':' + p2(d.getMinutes());
+  const day = (x) => x.getFullYear() * 400 + x.getMonth() * 32 + x.getDate();
+  if (day(d) === day(now)) return hm;
+  const y = new Date(now); y.setDate(y.getDate() - 1);
+  return day(d) === day(y) ? 'yesterday ' + hm : d.getDate() + '/' + (d.getMonth() + 1) + ' ' + hm;
+}
+
+/** The closed line: who waits on a reply, then how many are for information. Pure. */
+export function waitingLine(shown) {
+  const w = waitingMentions(shown); const rest = shown.length - w.length;
+  if (!w.length) return shown.length + (shown.length === 1 ? ' mention, for your information.' : ' mentions, all for your information.');
+  const names = w.map((m) => (m.who ? first(m.who) : 'Someone') + ' in ' + srcName(m.source));
+  const said = names.length < 2 ? names[0] : names.slice(0, -1).join(', ') + ' and ' + names[names.length - 1];
+  return said + (w.length === 1 ? ' is' : ' are') + ' waiting on your reply.' + (rest ? ' ' + rest + (rest === 1 ? ' more is' : ' more are') + ' for your information.' : '');
+}
+
+export function mentionsSection(S) {
+  ensureComponentsCss(); ensureSprite();
+  const st = { open: false, tab: 'all', local: new Map(), list: null };
+  const count = el('span', { class: 'bdg g' }, '0');
+  const right = el('span', { class: 'chips2' });
+  const body = el('div', { 'data-mentions-body': '' });
+  const box = el('section', { class: 'card sect', 'data-c3pg': 'mentions', 'aria-label': 'Mentions' },
+    el('div', { class: 'sh2' }, el('h2', null, c3ic('reply', 'sm'), 'Mentions ', count), right), body);
+  box.hidden = true;
+
+  const all = () => (st.list || []).map((m) => (st.local.has(m.id) ? { ...m, read: st.local.get(m.id) } : m));
+  const shown = () => all().filter((m) => !m.in_needs && !m.read);
+
+  const markRead = (m, read) => post('/api/mentions/read', { id: m.id, read }).then((r) => {
+    if (!r || r.ok === false) { toast('That did not go through' + (r && r.error ? ': ' + r.error : '.')); return false; }
+    st.local.set(m.id, read); draw(); if (S.briefRedraw) S.briefRedraw(); return true;
+  });
+  const addToWork = (m) => {
+    const who = m.who ? first(m.who) : 'the sender';
+    const line = m.reply ? 'Reply to ' + who + ' (' + srcName(m.source) + ') by today' : 'Read ' + who + '\'s note (' + srcName(m.source) + ')';
+    return post('/api/pm-items/add', { line }).then((r) => {
+      if (!r || r.ok === false) { toast('That did not go through' + (r && r.error ? ': ' + r.error : '.')); return; }
+      toast('Added to Work: ' + line.replace(/ by today$/, ''));
+      if (S.workChanged) S.workChanged();
+    });
+  };
+
+  const rowOf = (m) => {
+    const when = whenOf(m.at);
+    const chips = [m.reply ? el('span', { class: 'tag warn', 'data-mention-reply': '' }, 'needs your reply') : el('span', { class: 'tag', 'data-mention-fyi': '' }, 'for your information'),
+      el('span', { class: 'chip2', 'data-mention-where': '' }, srcName(m.source) + (m.where ? ' · ' + m.where : '')),
+      when ? el('span', { class: 'chip2' }, c3ic('clock', 'sm'), when) : null,
+      m.initiative ? el('span', { class: 'chip2' }, c3ic('init', 'sm'), m.initiative) : null];
+    const acts = el('div', { class: 'mn-acts' },
+      m.link ? el('a', { class: 'chip2 mn-open', href: m.link, target: '_blank', rel: 'noopener noreferrer', 'data-mention-open': m.id }, c3ic('out', 'sm'), 'Open in ' + srcName(m.source)) : null,
+      button({ label: 'Add to Work', variant: 'ghost', size: 'sm', icon: 'plus', attrs: { 'data-mention-work': m.id }, onClick: () => addToWork(m) }),
+      button({ label: 'Mark read', variant: 'ghost', size: 'sm', icon: 'check', attrs: { 'data-mention-read': m.id },
+        onClick: () => markRead(m, true).then((done) => { if (done) toast('Marked read', () => markRead(m, false)); }) }));
+    return el('li', { class: 'nrow mn-row', 'data-mention': m.id, 'data-source': m.source },
+      el('span', { class: 'ki' + (m.reply ? ' hot' : '') }, c3ic(ICON[m.source] || 'reply')),
+      el('div', { class: 'nb' }, el('span', { class: 'tt' }, m.who || srcName(m.source)), el('div', { class: 'mn-q' }, '"' + m.text + '"'),
+        el('div', { class: 'chips' }, ...chips.filter(Boolean)), acts),
+      el('span'));
+  };
+
+  const toggle = button({ label: 'Show all', variant: 'ghost', size: 'sm', attrs: { 'data-mentions-toggle': '', 'aria-expanded': 'false' }, onClick: () => { st.open = !st.open; draw(); } });
+  function draw() {
+    if (!st.list) { box.hidden = st.list === undefined; body.replaceChildren(el('p', { class: 'dim c3s2', 'data-mentions-state': 'none' }, 'PMOS has no brief for today, so no mentions were read.')); count.textContent = '0'; right.replaceChildren(); return; }
+    box.hidden = false;
+    const list = shown(); const wait = waitingMentions(list);
+    count.textContent = String(list.length);
+    toggle.querySelector(SEL.btnLabel).textContent = st.open ? 'Hide' : 'Show all';
+    toggle.setAttribute('aria-expanded', String(st.open));
+    right.replaceChildren(...(wait.length ? [el('span', { class: 'tag warn', 'data-mentions-wait': String(wait.length) }, wait.length + (wait.length === 1 ? ' needs a reply' : ' need a reply'))] : []), ...(list.length ? [toggle] : []));
+    if (!list.length) { body.replaceChildren(el('p', { class: 'dim c3s2', 'data-mentions-state': 'empty' }, 'No one has mentioned you today.')); return; }
+    if (!st.open) { body.replaceChildren(el('p', { class: 'mn-line', 'data-mentions-line': '' }, waitingLine(list))); return; }
+    const srcs = ORDER.filter((k) => list.some((m) => m.source === k)).concat([...new Set(list.map((m) => m.source))].filter((k) => !ORDER.includes(k)));
+    if (st.tab !== 'all' && !srcs.includes(st.tab)) st.tab = 'all';
+    const bar = tabs({ ariaLabel: 'Mentions by source', value: st.tab, attrs: { class: 'mn-tabs', 'data-mentions-tabs': '' },
+      items: ['all', ...srcs].map((k) => ({ id: k, label: k === 'all' ? 'All' : srcName(k), count: k === 'all' ? list.length : list.filter((m) => m.source === k).length })),
+      onChange: (k) => {   // the list draws again; keep the focus on the chosen tab
+        const had = bar.contains(document.activeElement); st.tab = k; draw();
+        const now = had && body.querySelector('[data-mentions-tabs] [data-tab="' + k + '"]'); if (now) now.focus();
+      } });
+    const rows = list.filter((m) => st.tab === 'all' || m.source === st.tab).sort((a, b) => (b.reply - a.reply) || ((b.at ? Date.parse(b.at) : 0) - (a.at ? Date.parse(a.at) : 0)));
+    body.replaceChildren(bar, el('ul', { class: 'list', role: 'list', 'data-mentions-list': '' }, ...rows.map(rowOf)));
+  }
+
+  /* Needs you shows a worth-asking mention as its need_key row: tag it, first among its chips so the quiet layout keeps it */
+  S.tagNeeds = (host) => {
+    const by = new Map(all().filter((m) => m.in_needs && m.need_key).map((m) => [m.need_key, m]));
+    if (!by.size) return;
+    (host || document).querySelectorAll('[data-needs-row]').forEach((row) => {
+      const m = by.get(row.dataset.needsRow); const chips = row.querySelector('.nb > .chips');
+      if (!m || !chips || chips.querySelector('[data-mentioned-you]')) return;
+      chips.prepend(el('span', { class: 'tag', 'data-mentioned-you': '', title: (m.who ? m.who + ' mentioned you' : 'You were mentioned') + ' in ' + srcName(m.source) }, 'mentioned you'));
+    });
+  };
+
+  st.list = undefined;
+  onBriefPage((j) => {
+    st.list = j && j.ok !== false ? (Array.isArray(j.mentions) ? j.mentions : null) : null;
+    st.local.clear();
+    draw();
+    if (S.tagNeeds) S.tagNeeds(S.needsBox);
+    if (S.briefRedraw) S.briefRedraw();
+  });
+  S.mentionsNow = () => (st.list === undefined ? null : st.list ? all() : null);
+  S.reloadMentions = () => loadBriefPage();
+  return box;
+}

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

@@ -133,6 +133,23 @@ export function needsSection(S) {
     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();
+    if (S.tagNeeds) S.tagNeeds(box);          // Mentions (c3-brief-mentions.js): the "mentioned you" tag on a worth-asking row
+    if (S.briefRedraw) S.briefRedraw();      // The brief (c3-brief-summary.js) says what this section holds
+  };
+  /* What The brief reads of this section: the rows on the page now, with what each row's data says. null until both reads came back. */
+  const meta = new Map();
+  S.needsSnapshot = () => {
+    if (!last || !page || page.ok === false) return null;
+    const rowsIn = (host) => [...host.querySelectorAll('.nrow[data-needs-row]')];
+    const decisions = [...rowsIn(list), ...rowsIn(extra)].map((r) => {
+      const k = r.dataset.needsRow; const m = meta.get(k) || {}; const tt = r.querySelector('.tt');
+      return { key: k, headline: tt ? tt.textContent : '', time: m.time || null, decide: !!m.decide, overdue: !!m.overdue, days_late: m.days_late || 0 };
+    });
+    const own0 = rowsIn(own).map((r) => {
+      const k = r.dataset.needsRow; const d = (page.needs || []).find((x) => x.key === k) || {}; const tt = r.querySelector('.tt');
+      return { key: k, headline: tt ? tt.textContent : (d.headline || ''), kind: r.dataset.kind || d.kind, days_late: d.days_late || 0 };
+    });
+    return { decisions, own: own0, agentN: agent.children.length };
   };
   const ctx = { changed: recount };
 
@@ -157,6 +174,12 @@ export function needsSection(S) {
     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.')))] : []));
+    meta.clear();
+    /* a decision only the PM can make: an engine card, or an assigned item marked Decide; an assigned item past its date is overdue */
+    (needs || decide.map((c, i) => fromCard({ key: c.key || String(i), card: c }, i))).forEach((n) => {
+      const late = /^(\d+) days? overdue$/.exec(String(n.dueText || ''));
+      meta.set(n.key, { time: n.time || null, decide: !!n.view || /^decide$/i.test(String(n.kind || '')), overdue: n.kind === 'Overdue', days_late: late ? Number(late[1]) : 0 });
+    });
     if (needs) {
       sumState.quick = needs.filter((n) => n.quick).length;
       list.replaceChildren(...needs.slice(0, 5).map((n, i) => needRow(n, i, ctx)));

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

@@ -84,6 +84,7 @@ export function pulse(S) {
     rows = rows.filter(shown);
     if (!rows.length) { body.replaceChildren(note('No initiative has a promised date or a Jira epic read yet, so there is nothing to show.'), ...(noPlan ? [el('p', { class: 'dim mono c3s2' }, noPlan + ' initiatives have no plan date.')] : [])); return; }
     const pr = rows.map(pulseRow);
+    S.pulseRows = pr; if (S.briefRedraw) S.briefRedraw();   // The brief (c3-brief-summary.js) names the rows off track or at risk
     const need = pr.filter((r) => r.cls === 'bad' || r.cls === 'warn').length;
     attn.textContent = need + ' need attention'; foot.hidden = false;
     const by = new Map(); pr.forEach((r) => { const k = r.word.replace(/ \+.*/, ''); const o = by.get(k) || { n: 0, cls: r.cls }; o.n += 1; by.set(k, o); });

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

@@ -0,0 +1,139 @@
+/* pm/c3-brief-summary.js — "The brief": one paragraph under the greeting that says the day at a glance (initiative c3-brief-summary-mentions).
+ *
+ *   composeBrief(input)   → { parts, sources }   PURE. parts is a list of { t } text and { t, go: { kind, key } } links, in reading order:
+ *                           1. "The day turns on one call": the first decision only the PM can make; without one, "First up": the top row
+ *                              ("Still open from today" in Reflect)
+ *                           2. how many things need the PM, how many are overdue, and the oldest
+ *                           3. who waits on a reply to a mention
+ *                           4. how many meetings are left and which one still has a to-do before it ("You held N meetings today." in Reflect)
+ *                           5. which initiatives are off track or at risk
+ *                           A sentence whose read has not come back (null input) is left out. Nothing is invented: every number and title
+ *                           comes from a row the Briefing shows below.
+ *   summarySection(S)     → the card. It composes again when a read comes back, when Needs you changes (S.needsChanged) and when the part of
+ *                           the day changes (S.briefLens). A link goes to its row on the page through S.briefGo({ kind, key }).
+ *
+ * input: { lens, decisions: [{ key, headline, time, decide, overdue, days_late }] | null   (the rows above the PM's own in Needs you; decide: a
+ *          decision only the PM can make, overdue: an assigned item past its date),
+ *           own: [{ key, headline, kind, days_late }] | null, agentN,
+ *          mentions: [mention] | null, agenda: [meeting] | null, pulse: [{ id, title, cls, word }] | null }
+ * No model call and no write. */
+import { el } from './dom.js';
+import { c3ic } from './pm-work-view.js';
+
+const p2 = (n) => String(n).padStart(2, '0');
+const hm = (iso) => { const d = new Date(iso); return p2(d.getHours()) + ':' + p2(d.getMinutes()); };
+const plural = (n, w) => n + ' ' + w + (n === 1 ? '' : 's');
+const first = (s) => String(s || '').trim().split(/\s+/)[0];
+const SRC = { slack: 'Slack', jira: 'Jira', confluence: 'Confluence', mail: 'Mail', figma: 'Figma', github: 'GitHub', drive: 'Drive', calendar: 'Calendar', wispr: 'Wispr Flow', website: 'Website', derived: 'PMOS' };
+export const srcName = (s) => SRC[s] || String(s || 'a source');
+/** a list said as a person says it: "a", "a and b", "a, b and c" */
+const andList = (xs) => (xs.length < 2 ? xs.join('') : xs.slice(0, -1).join(', ') + ' and ' + xs[xs.length - 1]);
+
+/** The mentions that wait on the PM's reply: not read, not already a Needs you row. */
+export const waitingMentions = (ms) => (ms || []).filter((m) => m && m.reply && !m.read && !m.in_needs);
+
+export function composeBrief(input) {
+  const x = input || {};
+  const reflect = x.lens === 'Reflect';
+  const out = []; const sources = [];
+  const t = (s) => out.push({ t: s });
+  const link = (s, kind, key) => out.push({ t: s, go: { kind, key } });
+
+  // 1 and 2: Needs you
+  if (x.decisions && x.own) {
+    sources.push('Needs you');
+    const dec = x.decisions.find((d) => d.decide);
+    const d0 = dec || x.own[0] || x.decisions[0];   // a decision only the PM can make, else the top row of Needs you
+    if (d0) {
+      t(reflect ? 'Still open from today: ' : dec ? 'The day turns on one call: ' : 'First up: '); link(d0.headline, 'need', d0.key);
+      t((d0.time ? (/overdue/.test(d0.time) ? ', ' + d0.time : ', due ' + d0.time) : d0.days_late > 0 ? ', ' + plural(d0.days_late, 'day') + ' late' : '') + '. ');
+    }
+    const agentN = Number(x.agentN) || 0;
+    const total = x.decisions.length + x.own.length + agentN;
+    const late = [...x.own.filter((r) => r.kind === 'overdue'), ...x.decisions.filter((d) => d.overdue)];
+    if (!total) t('Nothing needs you right now. ');
+    else {
+      const parts = [plural(x.decisions.length, 'decision'), x.own.length + ' of your own'];
+      if (agentN) parts.push(agentN + ' from the agent');
+      t(plural(total, 'thing') + (total === 1 ? ' needs' : ' need') + ' you (' + parts.join(', ') + ')');
+      if (late.length) {
+        const o = late.slice().sort((a, b) => (b.days_late || 0) - (a.days_late || 0))[0];
+        t(', and ' + late.length + (late.length === 1 ? ' is' : ' are') + ' overdue, the oldest ');
+        link(o.headline, 'need', o.key);
+        t(o.days_late > 0 ? ' (' + plural(o.days_late, 'day') + ' late)' : '');
+      }
+      t('. ');
+    }
+  }
+  // 3: mentions that wait on a reply
+  if (x.mentions) {
+    sources.push('Mentions');
+    const w = waitingMentions(x.mentions);
+    if (w.length) {
+      const who = w.map((m) => (m.who ? first(m.who) + ' in ' : 'someone in ') + srcName(m.source));
+      if (w.length === 1) t(who[0].charAt(0).toUpperCase() + who[0].slice(1) + ' is waiting on your reply to a mention. ');
+      else t(w.length + ' people are waiting on your reply to a mention (' + andList(who) + '). ');
+    }
+  }
+  // 4: the meetings
+  if (x.agenda) {
+    sources.push('Calendar');
+    const all = x.agenda; const left = all.filter((m) => m.state !== 'past');
+    if (reflect) t(all.length ? 'You held ' + plural(all.length - left.length, 'meeting') + ' today' + (left.length ? ', and ' + left.length + ' ' + (left.length === 1 ? 'is' : 'are') + ' still ahead' : '') + '. ' : 'You had no meetings today. ');
+    else if (!all.length) t('No meetings today. ');
+    else if (!left.length) t('No meetings are left today. ');
+    else {
+      const todo = left.filter((m) => (m.before || []).length);
+      t(plural(left.length, 'meeting') + (left.length === 1 ? ' is' : ' are') + ' left today');
+      if (!todo.length) t(', and nothing is left to do before ' + (left.length === 1 ? 'it' : 'them') + '. ');
+      else {
+        t(todo.length === left.length && left.length > 1 ? '; every one has a to-do before it, starting with ' : '; ');
+        link(todo[0].title, 'meet', todo[0].id);
+        t(' at ' + hm(todo[0].start) + (todo.length === left.length && left.length > 1 ? '. ' : ' still has a to-do before it. '));
+      }
+    }
+  }
+  // 5: the initiatives
+  if (x.pulse && x.pulse.length) {
+    sources.push('Initiatives');
+    const bad = x.pulse.filter((r) => r.cls === 'bad'); const warn = x.pulse.filter((r) => r.cls === 'warn'); const ok = x.pulse.filter((r) => r.cls === 'ok').length;
+    const flagged = [...bad, ...warn];
+    if (!flagged.length) t(ok ? (ok === 1 ? 'The one initiative with a plan is on track.' : 'All ' + ok + ' initiatives with a plan are on track.') : '');
+    else {
+      t('Across the portfolio, ');
+      flagged.slice(0, 3).forEach((r, i) => {
+        if (i) t(i === Math.min(flagged.length, 3) - 1 ? ' and ' : ', ');
+        link(r.title, 'init', r.id);
+        t(' is ' + String(r.word || (r.cls === 'bad' ? 'off track' : 'at risk')).toLowerCase());
+      });
+      if (flagged.length > 3) t(', and ' + (flagged.length - 3) + ' more need attention');
+      t(ok ? '; ' + ok + (ok === 1 ? ' is' : ' are') + ' on track.' : '.');
+    }
+  }
+  // tidy: one space between sentences, none at the end
+  const parts = out.filter((p) => p.t);
+  if (parts.length) parts[parts.length - 1] = { ...parts[parts.length - 1], t: parts[parts.length - 1].t.replace(/\s+$/, '') };
+  return { parts, sources };
+}
+
+export function summarySection(S) {
+  const when = el('span', { class: 'mono dim brief-when', 'data-brief-when': '' });
+  const body = el('p', { class: 'brief-sum', 'data-brief-sum': '' }, 'Reading the day.');
+  const box = el('section', { class: 'card sect sum-card', 'data-c3pg': 'summary', 'aria-label': 'The brief' },
+    el('div', { class: 'sh2' }, el('h2', null, c3ic('spark', 'sm'), 'The brief'), when), body);
+  let queued = false;
+  const draw = () => {
+    queued = false;
+    const input = S.briefInput ? S.briefInput() : {};
+    const { parts, sources } = composeBrief(input);
+    if (!parts.length) { body.replaceChildren(sources.length ? 'Nothing to say yet: no decision, item, meeting or initiative needs you.' : 'Reading the day.'); when.textContent = ''; return; }
+    body.replaceChildren(...parts.map((p) => (p.go
+      ? el('a', { class: 'brief-lk', href: '#', 'data-brief-go': p.go.kind + ':' + p.go.key, onclick: (e) => { e.preventDefault(); if (S.briefGo) S.briefGo(p.go); } }, p.t)
+      : document.createTextNode(p.t))));
+    const d = new Date();
+    when.textContent = 'As of ' + p2(d.getHours()) + ':' + p2(d.getMinutes()) + ' · ' + sources.join(', ');
+  };
+  S.briefRedraw = () => { if (queued) return; queued = true; Promise.resolve().then(draw); };
+  S.briefRedraw();
+  return box;
+}

package/workspace/public/pm/c3-demo-brief-page.js

@@ -2,8 +2,10 @@
  * GET /api/brief-page (lib/routes-brief-page.js), for the demo day (Thu 8 Oct 2026, 08:12), with the demo's own people and initiatives.
  * Today is the five meetings of the demo calendar (c3-demo-data.js MEET). Needs you gets two items that are overdue, one due today, and two outside-PMOS items
  * (one with evidence: a meeting with Dara is booked today). Decisions are the demo briefing's own needs (c3-demo-data.js NEEDS), not repeated here.
- * Writes: the pm-items routes the rows call (done, notyet, remove, reopen, undo) are answered in memory, and every one is kept in window.__c3demoWrites
- * ({ path, body }) so a test can see what the page asked to write. Real mode never loads this file. */
+ * Mentions (initiative c3-brief-summary-mentions): five mentions of the demo morning; Sam's Slack message is also the Needs you row i15, so it is not
+ * listed and that row carries the "mentioned you" tag.
+ * Writes: the pm-items routes the rows call (done, notyet, remove, reopen, undo, add) and POST /api/mentions/read are answered in memory, and every one
+ * is kept in window.__c3demoWrites ({ path, body }) so a test can see what the page asked to write. Real mode never loads this file. */
 const iso = (h, m) => new Date(2026, 9, 8, h, m).toISOString();
 const TODAY = [
   { id: 'm1', title: 'Standup', start: iso(9, 30), end: iso(10, 0), people: ['Dara', 'Lee', 'Sam'], initiative: 'Checkout v2', prepared: [], before: [] },
@@ -25,7 +27,14 @@ const NEEDS = [
     evidence: { text: 'a meeting with Dara is booked Thu 14:00', event_id: 'm4' } },
 ];
 
-let gone = {};
+const MENTIONS = [
+  { id: 'd3m000000001', source: 'slack', who: 'Priya Nair', where: '#checkout-v2', text: 'Can you confirm the revised date before the 10:30 update? Leadership will ask.', at: iso(7, 58), reply: true, link: 'https://localhost/demo/slack/checkout-v2', initiative: 'Checkout v2', in_needs: false, read: false },
+  { id: 'd3m000000002', source: 'jira', who: 'Dara Okafor', where: 'CHK-214 Flow 4 estimate', text: 'Which of the four flows do we cut if we hold 24 Oct? I need this before sprint planning.', at: iso(8, 4), reply: true, initiative: 'Checkout v2', in_needs: false, read: false },
+  { id: 'd3m000000003', source: 'confluence', who: 'Marta Silva', where: 'Returns interview guide', text: 'I moved the support questions to the end, no change to the scope.', at: iso(7, 20), reply: false, initiative: 'Returns experience', in_needs: false, read: false },
+  { id: 'd3m000000004', source: 'mail', who: 'Lee Park', where: 'Pricing page feedback', text: 'Copying you so the copy notes are in one thread.', at: new Date(2026, 9, 7, 17, 5).toISOString(), reply: false, in_needs: false, read: false },
+  { id: 'd3m000000005', source: 'slack', who: 'Sam', where: '#search', text: 'Ok to ship the logging change today?', at: iso(7, 45), reply: true, in_needs: true, need_key: 'i15', read: false },
+];
+let gone = {}; const readMarks = {};
 export function installBriefPage() {
   if (window.__c3demoBriefPage) return; window.__c3demoBriefPage = true;
   window.__c3demoWrites = [];
@@ -37,7 +46,14 @@ export function installBriefPage() {
       const u = new URL(raw, location.origin);
       const method = String((init && init.method) || (input && input.method) || 'GET').toUpperCase();
       if (u.origin === location.origin) {
-        if (method === 'GET' && u.pathname === '/api/brief-page') return Promise.resolve(json({ ok: true, date: '2026-10-08', me: 'Wawan', today: TODAY.map((m) => ({ ...m, minutes: (Date.parse(m.end) - Date.parse(m.start)) / 60000, state: Date.parse(m.end) <= Date.now() ? 'past' : 'later' })).map((m, i, a) => ({ ...m, state: m.state === 'past' ? 'past' : (a.findIndex((x) => x.state !== 'past' && Date.parse(x.start) > Date.now()) === i ? 'next' : 'later') })), needs: NEEDS.filter((n) => !gone[n.id]) }));
+        if (method === 'GET' && u.pathname === '/api/brief-page') return Promise.resolve(json({ ok: true, date: '2026-10-08', me: 'Wawan', today: TODAY.map((m) => ({ ...m, minutes: (Date.parse(m.end) - Date.parse(m.start)) / 60000, state: Date.parse(m.end) <= Date.now() ? 'past' : 'later' })).map((m, i, a) => ({ ...m, state: m.state === 'past' ? 'past' : (a.findIndex((x) => x.state !== 'past' && Date.parse(x.start) > Date.now()) === i ? 'next' : 'later') })), needs: NEEDS.filter((n) => !gone[n.id]), mentions: MENTIONS.map((x) => ({ ...x, read: !!readMarks[x.id] })) }));
+        if (method !== 'GET' && (u.pathname === '/api/mentions/read' || u.pathname === '/api/pm-items/add')) {
+          let b = {}; try { b = init && init.body ? JSON.parse(init.body) : {}; } catch { b = {}; }
+          window.__c3demoWrites.push({ path: u.pathname, body: b });
+          if (u.pathname === '/api/pm-items/add') return prev(input, init);   // recorded, then answered by the demo's own Work store
+          readMarks[b.id] = b.read === true;
+          return Promise.resolve(json({ ok: true }));
+        }
         const m = /^\/api\/pm-items\/(done|notyet|remove|reopen|undo)$/.exec(u.pathname);
         if (method !== 'GET' && m) {
           let b = {}; try { b = init && init.body ? JSON.parse(init.body) : {}; } catch { b = {}; }

package/workspace/public/pm/c3-doc-sheet.js

@@ -49,6 +49,12 @@ import { mountSlide } from './slide-confirm.js';
 import { parseMd, toMd, canonMd, diffMd, toDom, fromDom, wordCounts, safeHref } from './c3-md.js';
 import { ensureReportCss, formatOf, formatView, outlineLabels, downloadsOf, printPdf, copyKindFor } from './c3-doc-formats.js';
 
+/* the sheet's width (initiative c3-doc-sheet-size): Normal (780px), Half, 3/4 or Whole window, as the session, meeting and studio sheets */
+const DOC_SIZE_KEY = 'pmos.workspace.c3.doc-size';
+export const DOC_SIZES = [['normal', 'Normal', 'Normal'], ['half', 'Half', 'Half of the window'], ['three-quarters', '3/4', 'Three-quarters of the window'], ['whole', 'Whole', 'Whole window']];
+export const docSizeOf = (v) => (DOC_SIZES.some((x) => x[0] === v) ? v : 'normal');
+const docSizeStore = { get() { try { return localStorage.getItem(DOC_SIZE_KEY); } catch { return null; } }, set(v) { try { localStorage.setItem(DOC_SIZE_KEY, v); } catch { /* no storage */ } } };
+
 /* ── pure: sections, round trip, word diff ── */
 
 /** Split a markdown text into sections at its headings. Each section keeps the exact text it came from, so joinDoc(splitDoc(t)) === t. */
@@ -1198,7 +1204,17 @@ export function openDocSheet({ ws, doc, mode = 'read', prompt = '', relations, o
   }
 
   document.addEventListener('selectionchange', keepRange);
-  ui = openSheet({ title: doc.name, icon: 'doc', dw: true, actions: toolsNode, body: el('div', { class: 'dpn' }), onClose: () => { S.closed = true; document.removeEventListener('selectionchange', keepRange); if (S.changed && onChanged) onChanged(); } });
+  // the size control of the session and meeting sheets (Normal, Half, 3/4, Whole), remembered in this browser
+  let size = docSizeOf(docSizeStore.get());
+  const sizeBtns = DOC_SIZES.map(([k, label, tip]) => button({ label, variant: 'ghost', attrs: { 'aria-pressed': String(k === size), 'data-doc-size': k, title: tip, 'aria-label': tip },
+    onClick: () => setSize(k) }));
+  const sizeSeg = el('div', { class: 'seg ds-size', role: 'group', 'aria-label': 'Size', 'data-doc': 'size' }, ...sizeBtns);
+  function setSize(k) {
+    size = k; docSizeStore.set(k);
+    DOC_SIZES.forEach(([x]) => ui.sheet.classList.toggle('tsz-' + x, x === k));
+    sizeBtns.forEach((b) => b.setAttribute('aria-pressed', String(b.getAttribute('data-doc-size') === k)));
+  }
+  ui = openSheet({ title: doc.name, icon: 'doc', dw: true, cls: 'tsz-' + size, actions: [sizeSeg, toolsNode].filter(Boolean), body: el('div', { class: 'dpn' }), onClose: () => { S.closed = true; document.removeEventListener('selectionchange', keepRange); if (S.changed && onChanged) onChanged(); } });
   S.open = (d) => { ui.close(); if (S.openOther) S.openOther(d); else openDocSheet({ ws, doc: d, library, openGraph }); };
   ui.setOpener = (fn) => { S.openOther = fn; };
   draw();

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

@@ -20,6 +20,8 @@ import { needsSection, needsCount } from './c3-brief-needs.js';
 import { scanSection } from './c3-scan.js';
 import { reportFoundSection } from './c3-report-store.js';
 import { pulse } from './c3-brief-pulse.js';
+import { summarySection } from './c3-brief-summary.js';
+import { mentionsSection } from './c3-brief-mentions.js';
 import { loadBriefPage, onBriefPage } from './c3-brief-data.js';
 import { createDock } from './c3-dock.js';
 import { reviewSection, footLine, rowApi, BX, toast, setNeedsTitle, hooks as briefHooks } from './c3-brief.js';
@@ -285,16 +287,44 @@ function briefTab(pane) {
     if (S.why) whyMark();
   });
   S.needsBox = needsSection(S);
-  left.append(deckHost, scanSection(S), reportFoundSection(S), S.needsBox);   // the Horizon scan card sits above Needs you, and shows only on a day a scan ran
+  const summary = summarySection(S);
+  S.briefInput = briefInput;
+  S.briefGo = briefGo;
+  left.append(deckHost, scanSection(S), reportFoundSection(S), S.needsBox, mentionsSection(S));   // the Horizon scan card sits above Needs you, and shows only on a day a scan ran
   right.append(todaySection(), pulse(S));
   pane.append(el('div', { class: 'brief' }, el('div', { class: 'bcols' }, left, right), ftHost));
-  mountBriefing(deckHost, { noTicker: true, onLens: lensChanged });
+  mountBriefing(deckHost, { noTicker: true, onLens: lensChanged, afterStance: summary });
+  onBriefPage((j) => { S.briefPage = j; if (S.briefRedraw) S.briefRedraw(); });
   loadBriefPage();
 }
 
+/* What The brief composes from (c3-brief-summary.js composeBrief): the rows Needs you shows, the mentions, today's meetings and the pulse rows.
+ * A read that has not come back is null, so its sentence is left out. */
+function briefInput() {
+  const n = S.needsSnapshot ? S.needsSnapshot() : null;
+  const p = S.briefPage && S.briefPage.ok !== false ? S.briefPage : null;
+  return { lens: S.briefLens || null, decisions: n ? n.decisions : null, own: n ? n.own : null, agentN: n ? n.agentN : 0,
+    mentions: S.mentionsNow ? S.mentionsNow() : null, agenda: p ? (p.today || []) : null, pulse: S.pulseRows || null };
+}
+
+/* A link in The brief goes to its row: a Needs you row opens (goTarget), a meeting or an initiative row is scrolled to and focused. */
+function briefGo(g) {
+  if (!g) return;
+  if (g.kind === 'need') { goTarget({ need: g.key }); return; }
+  const pane = S.panes && S.panes.brief; if (!pane) return;
+  const q = (v) => String(v).replace(/["\\]/g, '');
+  const row = g.kind === 'meet' ? pane.querySelector('[data-today-row="' + q(g.key) + '"]') : g.kind === 'init' ? pane.querySelector('[data-pulse-row="' + q(g.key) + '"]') : null;
+  if (!row) return;
+  row.scrollIntoView({ block: 'center', behavior: matchMedia('(prefers-reduced-motion: reduce)').matches ? 'auto' : 'smooth' });
+  const target = g.kind === 'init' ? row.querySelector('[data-c3pg-prow]') : row;
+  if (target && !target.hasAttribute('tabindex') && !target.matches('button,a')) target.setAttribute('tabindex', '-1');
+  try { (target || row).focus({ preventScroll: true }); } catch { /* gone */ }
+}
+
 /* The clock's part of the day: Reflect names Needs you "Carries over" (the mockup's vBrief, line 1470). */
 function lensChanged(l) {
   setNeedsTitle(S.needsBox, l === 'Reflect');
+  S.briefLens = l; if (S.briefRedraw) S.briefRedraw();
 }
 
 /* ── global: where a notification goes, the person sheet, the palette and the keys ── */

package/workspace/public/pm/console3.css

@@ -2393,9 +2393,29 @@
 .c3 .cal3-msize{flex:none}
 .c3 .cal3-msize button{padding:4px 8px}
 .c3.ph .cal3-msize{display:none}
+.c3 .ds-size{flex:none}
+.c3 .ds-size button{padding:4px 8px}
+.c3.ph .ds-size{display:none}
+@media (min-width:761px){
+  .c3 .sheet.dw.tsz-half,.c3 .sheet.dw.dwx.tsz-half{width:50vw}
+  .c3 .sheet.dw.tsz-three-quarters,.c3 .sheet.dw.dwx.tsz-three-quarters{width:75vw}
+  .c3 .sheet.dw.tsz-whole,.c3 .sheet.dw.dwx.tsz-whole{width:calc(100vw - 24px)}
+}
 .c3 .cal3-mcols{display:grid;gap:var(--sp-4);grid-template-columns:minmax(0,1fr);align-items:start}
 .c3 .cal3-mcol{display:grid;gap:var(--sp-3);min-width:0;align-content:start}
 @media (min-width:761px){.c3:not(.ph) .sheet.cal3-ms:not(.tsz-normal) .cal3-mcols:not(.one){grid-template-columns:minmax(0,1.2fr) minmax(0,1fr)}}
 .c3 .cal3-mnote-b{display:grid;gap:4px;padding:var(--sp-2) var(--sp-3);border:1px solid var(--border);border-radius:8px;background:var(--muted);min-width:0;overflow-wrap:anywhere}
 .c3 .cal3-mnote-b p{margin:0;font-size:var(--fs-2)}
 .c3 .cal3-src{display:flex;flex-wrap:wrap;gap:6px;align-items:center}
+/* The brief and Mentions on the Briefing (c3-brief-summary-mentions) */
+.c3 .sum-card .sh2{justify-content:space-between}
+.c3 .brief-when{font-size:var(--fs-1)}
+.c3 .brief-sum{margin:0;font-size:var(--fs-4);line-height:1.6;color:var(--foreground);max-width:72ch}
+.c3 .brief-lk{color:inherit;font-weight:600;text-decoration:underline;text-decoration-color:var(--ring);text-underline-offset:3px}
+@media (hover:hover){.c3 .brief-lk:hover{text-decoration-color:var(--acc)}}
+.c3 .brief-lk:focus-visible{outline:2px solid var(--ring);outline-offset:2px;border-radius:6px}
+.c3 [data-c3pg="mentions"] .mn-line{margin:0;font-size:var(--fs-3);line-height:1.5;color:var(--muted-foreground)}
+.c3 [data-c3pg="mentions"] .mn-q{font-size:var(--fs-3);line-height:1.5;color:var(--foreground);overflow-wrap:anywhere}
+.c3 [data-c3pg="mentions"] .mn-acts{display:flex;flex-wrap:wrap;gap:var(--sp-2);margin-top:4px}
+.c3 [data-c3pg="mentions"] .mn-tabs{flex-wrap:wrap;margin-bottom:var(--sp-2)}
+.c3 [data-c3pg="mentions"] .sh2{justify-content:space-between}

package/workspace/test-files.json

@@ -30,6 +30,7 @@
     "work-focus.test.js",
     "work-evidence.test.js",
     "brief-page.test.js",
+    "c3-brief-summary.test.js",
     "work-assigned.test.js",
     "briefing-real-data.test.js",
     "calendar-events.test.js",
@@ -180,6 +181,7 @@
     "work-focus.test.js": 1,
     "work-evidence.test.js": 1,
     "brief-page.test.js": 1,
+    "c3-brief-summary.test.js": 1,
     "work-assigned.test.js": 1,
     "briefing-real-data.test.js": 1,
     "calendar-events.test.js": 1,

package/workspace/test-lists/c3-doc-sheet-size.json

@@ -0,0 +1,6 @@
+{
+  "_comment": "Initiative c3-doc-sheet-size: the document sheet opens at Normal, Half, 3/4 or Whole window, remembered in this browser.",
+  "modules": [],
+  "panels": ["pm-c3-doc-sheet-size-test.js"],
+  "seconds": { "pm-c3-doc-sheet-size-test.js": 30 }
+}