create-pmos 0.86.0 → 0.87.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.86.0",
+  "version": "0.87.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@f91d32d
+kernel-source: pmos@6a237b2
 assembled: 2026-10-07
 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-07T16:27:16Z"}
+generated: {by: process:create-pmos, at: "2026-10-07T16:37:01Z"}
 status: stable
 ---
 

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

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

package/payload/state/discoveries.md

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

package/workspace/guide/board.md

@@ -2,13 +2,15 @@
 type: Guide
 title: "Board: the items of every initiative"
 description: "How to read and use the Board destination, filter it, add an item, move a card, release a batch of work items, and print the same Board with pmos board."
-timestamp: 2026-10-05
+timestamp: 2026-10-07
 ---
 
 # Board: the items of every initiative
 
 The Board shows the items of all your work initiatives in one place. It has four columns: Todo, Doing, Review and Done. A card is one item. The Board is a view of the same items that the Breakdown of each initiative shows, so a card is always in the column that its row has in the Tree.
 
+The Board looks like the Agenda. The title at the top counts the items, for example "43 items in code". The filters and **Add item** sit on the right of the title. Each column heading has a status dot and a count. A column shows its first 3 cards. Press **Show 14 more** under a column to see all of its cards. An owner icon on a card shows who owns it: a robot for an agent, or "You".
+
 A document initiative has no items, so it has no card and no place in the filter.
 
 ## Open the Board
@@ -33,7 +35,7 @@ Press **Add item**, the one main button of the Board. Type a title, choose the i
 
 - **On a wide screen,** drag a card to another column. A drop on Done is held for 8 seconds, so you can press **Undo**.
 - **On a phone,** press the card to open its sheet and press a state button. A card moves in 2 taps. From another column it takes 3: first press the column name, then the card, then the state.
-- **From the menu.** Press the three dots on a card, then choose Move to a state.
+- **From the menu.** Press the three dots on a card, then choose Move to a state. Every card shows its three dots.
 
 When you move a card that an agent owns, the card reads "moved by you". The agent's own next move can change it again.
 

package/workspace/guide/docs.md

@@ -1,7 +1,7 @@
 ---
 type: Guide
 title: "Docs: every repository file by category, the files each one links to, and whether each copy in Google Docs or Confluence is the same"
-timestamp: 2026-10-06
+timestamp: 2026-10-07
 ---
 
 # Docs
@@ -14,6 +14,8 @@ Nothing syncs by itself. A copy changes only when you press a button for that co
 
 ## The list
 
+The title at the top says how many copies need you, for example "2 need you in pmos". The three views are a segmented control at the top right, each with a count. Under the title, one bar shows when the copies were last compared, a search box and the **Compare every copy again** button. The list is in one card with a small label that names the view.
+
 Docs has three views:
 
 - **Needs you** shows the copies that are not the same.
@@ -117,7 +119,7 @@ A sync never creates, moves or deletes a page or a file. When the copy's text is
 
 ## Compare
 
-PMOS cannot read Google Docs or Confluence itself. **↻** next to "Compared … ago" starts a session that reads every copy with your own connectors. The session reads only. The sentences change when it finishes.
+PMOS cannot read Google Docs or Confluence itself. **Compare every copy again** in the bar, next to "Compared … ago", starts a session that reads every copy with your own connectors. The session reads only. The sentences change when it finishes.
 
 A compare runs only when you press it. There is no schedule. An edit to a repository file changes its sentence at once, without a compare.
 

package/workspace/package-lock.json

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

package/workspace/package.json

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

package/workspace/public/pm/bd-board.js

@@ -10,10 +10,11 @@
  */
 
 import { el } from './dom.js';
-import { card, tabs, dragHandle, iconButton, empty } from './primitives.js';
+import { card, tabs, dragHandle, iconButton, empty, button, badge } from './primitives.js';
 import { COPY, STATES, shortDate, ownerLabel } from './breakdown-copy.js';
 import { stageLabel } from './bd-model.js';
 import { signalsFor, byPart } from './bd-tree.js';
+import { icon } from './icons.js';
 
 /** The width below which the Board shows one column at a time. Mirrors components.css's container query. */
 export const WIDE_BOARD = 600;
@@ -21,14 +22,25 @@ export const WIDE_BOARD = 600;
 function boardCard(ctx, id, wide) {
   const { L, A } = ctx;
   const it = L.items[id];
-  const meta = [stageLabel(L, it.stage), ownerLabel(it.owner), it.due ? COPY.due(shortDate(it.due)) : null, byPart(it)];
-  const trail = ctx.cardMenus
-    ? [iconButton({
+  const ag = !!ctx.agenda;
+  // the Board destination shows the Agenda's card: initiative and stage only, the owner as an icon; the Breakdown keeps the long meta
+  const meta = ag ? [stageLabel(L, it.stage)] : [stageLabel(L, it.stage), ownerLabel(it.owner), it.due ? COPY.due(shortDate(it.due)) : null, byPart(it)];
+
+  const ownerIcon = !ag ? null : it.owner === 'you'
+    ? badge({ text: 'You', tone: 'outline', attrs: { 'data-bd-card-owner': 'you' } })
+    : it.owner === 'agent'
+      ? el('span', { class: 'bd-card__owner-icon', 'data-bd-card-owner': 'agent' }, icon('bot'))
+      : null;
+
+  const trail = !ag && !ctx.cardMenus ? null : [
+    ownerIcon,
+    iconButton({
       icon: 'ellipsis', size: 'sm', ariaLabel: COPY.aria.more(it.title),
       onClick: (e) => { e.stopPropagation(); A.menu(e.currentTarget, id, 'board'); },
-      attrs: { 'aria-haspopup': 'menu', 'data-fk': 'more:' + id, 'data-bd-more': '' },
-    })]
-    : null;
+      attrs: { 'aria-haspopup': 'menu', 'data-fk': 'more:' + id, 'data-bd-more': '', 'data-bd-card-menu': '' },
+    }),
+  ].filter(Boolean);
+
   // Without the ⋯ button the card's menu is a right-click away, and Shift+F10 (or the ContextMenu key) for the keyboard.
   const menuKeys = ctx.cardMenus ? {} : {
     'aria-keyshortcuts': 'Shift+F10',
@@ -48,8 +60,9 @@ function boardCard(ctx, id, wide) {
   };
   return card({
     title: it.title, titleIcon: it.milestone ? 'diamond' : null, meta, signals: signalsFor(it, 'board'),
-    lead: wide ? [dragHandle({ label: COPY.aria.reorder(it.title) })] : null, trail,
+    lead: wide ? [dragHandle({ label: COPY.aria.reorder(it.title), })] : null, trail,
     muted: it.proposed, onOpen: () => A.openSheet(id),
+    center: ag,
     attrs: { class: 'bd-card', 'data-item': id, 'data-state': it.state },
     openAttrs: { 'data-fk': 'card:' + id, ...menuKeys },
   });
@@ -68,14 +81,47 @@ export function renderBoard(ctx) {
     attrs: { class: 'bd-switch', 'data-bd-switch': '' },
   });
   for (const b of sw.querySelectorAll('[data-tab]')) b.setAttribute('data-fk', 'col:' + b.getAttribute('data-tab'));
-  const cols = STATES.map((s) => el('div', { class: 'bd-col' + (s === shown ? ' bd-col--shown' : ''), 'data-col-wrap': s },
-    el('div', { class: 'bd-col__head' }, el('span', null, COPY.states[s]), el('span', { class: 'bd-col__n' }, '· ' + counts[s])),
-    s === 'done' && L.board.doneOlder > 0 ? el('div', { class: 'bd-col__older', 'data-bd-older': String(L.board.doneOlder) }, COPY.olderInTree(L.board.doneOlder)) : null,
-    // an empty column says so, so a blank area never reads as a failed load
-    !counts[s] && !(s === 'done' && L.board.doneOlder > 0) ? empty({ text: COPY.emptyColumn(COPY.states[s]), attrs: { 'data-bd-empty-col': s } }) : null,
-    // the list fills its column, so the whole column height takes a drop
-    el('div', { class: 'bd-col__list', 'data-col': s, 'aria-label': COPY.states[s] }, (L.board[s] || []).map((id) => boardCard(ctx, id, wide)))));
-  return [sw, el('div', { class: 'bd-board', 'data-bd-board': wide ? 'wide' : 'narrow' }, cols)];
+
+  const cols = STATES.map((s) => {
+    const allIds = L.board[s] || [];
+    const expanded = P.expandedCols || (P.expandedCols = new Set());
+    const isExpanded = expanded.has(s);
+    const showLimit = ctx.agenda ? 3 : Infinity;
+    const shownIds = isExpanded ? allIds : allIds.slice(0, showLimit);
+    const hasMore = allIds.length > showLimit;
+    const moreCount = allIds.length - showLimit;
+
+    const statusDot = el('span', { class: 'bd-col__dot bd-col__dot--' + s });
+    const colName = COPY.states[s];
+    const countBadge = badge({ text: String(counts[s]), tone: 'outline', attrs: { 'data-bd-col-count': s } });
+
+    const cards = shownIds.map((id) => boardCard(ctx, id, wide));
+
+    const moreButton = hasMore && !isExpanded
+      ? button({
+        label: `Show ${moreCount} more`,
+        variant: 'ghost',
+        icon: 'chevron-down',
+        size: 'sm',
+        onClick: () => {
+          expanded.add(s);
+          A.rerender();
+        },
+        attrs: { 'data-bd-col-more': s, 'data-bd-show-more': '' },
+      })
+      : null;
+
+    return el('div', { class: 'bd-col' + (s === shown ? ' bd-col--shown' : ''), 'data-col-wrap': s },
+      ctx.agenda
+        ? el('div', { class: 'bd-col__head' }, el('div', { class: 'bd-col__name' }, statusDot, el('span', null, colName)), countBadge)
+        : el('div', { class: 'bd-col__head' }, el('span', null, COPY.states[s]), el('span', { class: 'bd-col__n' }, '· ' + counts[s])),
+      s === 'done' && L.board.doneOlder > 0 ? el('div', { class: 'bd-col__older', 'data-bd-older': String(L.board.doneOlder) }, COPY.olderInTree(L.board.doneOlder)) : null,
+      // an empty column says so, so a blank area never reads as a failed load
+      !counts[s] && !(s === 'done' && L.board.doneOlder > 0) ? empty({ text: COPY.emptyColumn(COPY.states[s]), attrs: { 'data-bd-empty-col': s } }) : null,
+      // the list fills its column, so the whole column height takes a drop
+      el('div', { class: 'bd-col__list', 'data-col': s, 'aria-label': COPY.states[s] }, ...cards, moreButton));
+  });
+  return [sw, el('div', { class: 'bd-board' + (ctx.agenda ? ' bd-board--agenda' : ''), 'data-bd-board': wide ? 'wide' : 'narrow' }, cols)];
 }
 
 /**

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

@@ -16,6 +16,7 @@ export const COPY = {
   initiative: 'Initiative',
   anyInitiative: 'All initiatives',
   addItem: 'Add item',
+  title: (n, productName) => `${n} ${n === 1 ? 'item' : 'items'} in ${productName || 'code'}`,
   adding: {
     title: 'Add item',
     sub: 'The item goes to its initiative. Enter adds it.',
@@ -34,6 +35,7 @@ export const COPY = {
   stageOf: (initiative, stage) => `${initiative} · ${stage}`,
   notMerged: 'Done · your call · not merged',
   summary: (n) => (n === 1 ? '1 item' : `${n} items`),
+  showMore: (n) => `Show ${n} more`,
   release: {
     head: 'Release',
     title: (initiative) => `Release · ${initiative}`,

package/workspace/public/pm/components.css

@@ -497,6 +497,13 @@
   position: absolute;
   inset: 0;
 }
+.pmc-card--center .pmc-card__top {
+  align-items: center;
+}
+.pmc-card--center .pmc-card__trail {
+  align-items: center;
+  gap: 4px;
+}
 .pmc-card__trail {
   position: relative;
   z-index: 1;
@@ -1313,6 +1320,11 @@
   padding: 16px;
   align-items: stretch;
 }
+.bd-board--agenda {
+  flex: 1 1 auto;
+  min-height: 0;
+  overflow-y: auto;
+}
 .bd-switch {
   display: none;
 }
@@ -1339,6 +1351,32 @@
   font-variant-numeric: tabular-nums;
   letter-spacing: 0;
 }
+/* the Board destination (Agenda look): sentence-case head with a status dot and a count badge */
+.bd-board--agenda .bd-col__head {
+  align-items: center;
+  justify-content: space-between;
+  padding-bottom: 0;
+  border-bottom: 0;
+  font-size: 14px;
+  line-height: 20px;
+  letter-spacing: 0;
+  text-transform: none;
+}
+.bd-col__name {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+.bd-col__dot {
+  display: inline-block;
+  width: 8px;
+  height: 8px;
+  border-radius: 50%;
+  background: var(--muted-foreground);
+}
+.bd-col__dot--doing { background: var(--primary); }
+.bd-col__dot--review { background: var(--warning); }
+.bd-col__dot--done { background: var(--primary); }
 .bd-col__list {
   display: flex;
   flex: 1 1 auto;
@@ -1357,6 +1395,13 @@
 .bd-card {
   cursor: pointer;
 }
+.bd-card__owner-icon {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 20px;
+  height: 20px;
+}
 @container bd-pane (max-width: 599px) {
   .bd-switch {
     display: flex;
@@ -4209,7 +4254,8 @@
 
 /* -- layouts · .bo- Board (Run 4, slice 4D) -- */
 .bo-head {
-  flex-wrap: wrap;
+  display: block;
+  padding: 16px 16px 0;
 }
 .bo-head__filters {
   display: flex;
@@ -4221,46 +4267,35 @@
 .bo-head__pick {
   min-width: 160px;
 }
+
 .bo-head__end {
   display: flex;
   align-items: center;
   gap: 12px;
   margin-left: auto;
 }
-.bo-head__n {
-  color: var(--muted-foreground);
-  font-size: 12px;
-  line-height: 16px;
-  font-variant-numeric: tabular-nums;
-}
 .bo-releases {
   display: flex;
   flex-direction: column;
-  gap: 4px;
+  gap: 8px;
   margin: 16px 16px 0;
-  padding: 12px;
-  border: 1px solid var(--border);
-  border-radius: 8px;
+  padding: 0;
 }
 .bo-releases__head {
-  font-size: 12px;
-  line-height: 16px;
-  font-weight: 600;
-  letter-spacing: 0.04em;
-  text-transform: uppercase;
+  display: none;
 }
 .bo-releases__note {
-  color: var(--muted-foreground);
-  font-size: 12px;
-  line-height: 16px;
+  display: none;
 }
 .bo-rel {
   display: flex;
   align-items: center;
   justify-content: space-between;
   gap: 12px;
-  padding: 8px 0;
-  border-top: 1px solid var(--border);
+  padding: 10px 12px;
+  border: 1px solid var(--border);
+  border-radius: 8px;
+  background: var(--card);
 }
 .bo-rel--today {
   padding: 10px 12px;
@@ -4273,7 +4308,8 @@
   min-width: 0;
 }
 .bo-rel__title {
-  font-weight: 600;
+  font-size: 14px;
+  font-weight: 500;
   overflow-wrap: anywhere;
 }
 .bo-rel__meta,
@@ -5335,16 +5371,12 @@
 }
 .rp-docs-views {
   display: flex;
-  flex-wrap: wrap;
   align-items: center;
-  gap: 12px;
-  border-bottom: 1px solid var(--border);
 }
 .rp-docs-when {
   display: flex;
   align-items: center;
-  gap: 4px;
-  margin-left: auto;
+  gap: 6px;
   font-size: 12px;
   color: var(--muted-foreground);
 }
@@ -5356,10 +5388,45 @@
   color: var(--muted-foreground);
 }
 .rp-docs-row {
-  border-top: 1px solid var(--border);
+  border-radius: 8px;
 }
-.rp-docs-row:last-child {
-  border-bottom: 1px solid var(--border);
+.rp-docs-row + .rp-docs-row {
+  margin-top: 2px;
+}
+.rp-docs-head {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+.rp-docs-bar {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 8px 10px;
+  padding: 8px 12px;
+  border-radius: 8px;
+  background: var(--card);
+  box-shadow: 0 0 0 1px var(--border);
+}
+.rp-docs-bar .rp-docs-find {
+  flex: 1 1 220px;
+  max-width: none;
+}
+.rp-docs-panel {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  min-width: 0;
+  padding: 10px 12px;
+  border-radius: 8px;
+  background: var(--card);
+  box-shadow: 0 0 0 1px var(--border);
+}
+.rp-docs-panel__eyebrow {
+  font-size: 11px;
+  letter-spacing: 0.04em;
+  text-transform: uppercase;
+  color: var(--muted-foreground);
 }
 .rp-docs-dot {
   display: inline-block;

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

@@ -29,8 +29,8 @@ import { currentProduct } from './board-read.js';
 import { pmGet } from './http.js';
 import { postEvents } from './breakdown-api.js';
 import { watchSig } from './sig-watch.js';
-import { ensureComponentsCss, layer, tabs, field, button, sheet, toast, empty, menu } from './primitives.js';
-import { ensureSprite } from './icons.js';
+import { ensureComponentsCss, layer, tabs, field, button, sheet, toast, empty, menu, badge } from './primitives.js';
+import { ensureSprite, icon } from './icons.js';
 import { COPY as BD } from './breakdown-copy.js';
 import { COPY } from './board-copy.js';
 import { hold, cancel, isHeld, flush, overlay, anyHeld } from './undo-hold.js';
@@ -119,6 +119,9 @@ function focusKeyIn(P) {
 function headOf(P) {
   const out = P.out;
   const inits = (out && out.initiatives) || [];
+  const n = out ? (out.counts.todo + out.counts.doing + out.counts.review + out.counts.done) : 0;
+  const productName = currentProduct();
+
   const f = tabs({
     variant: 'segmented', ariaLabel: COPY.filter, value: P.filter === 'init' ? null : P.filter,
     items: [{ id: 'active', label: COPY.filters.active }, { id: 'mine', label: COPY.filters.mine }],
@@ -134,10 +137,13 @@ function headOf(P) {
     label: COPY.addItem, variant: 'primary', icon: 'plus', onClick: () => P.actions.openAdd(),
     attrs: { 'data-bo-add': '', 'data-fk': 'add' },
   });
-  const n = out ? (out.counts.todo + out.counts.doing + out.counts.review + out.counts.done) : 0;
+
+  const title = el('h2', { class: 'td-count', 'data-bo-count': String(n) }, COPY.title(n, productName));
+
   return [
-    el('div', { class: 'bo-head__filters' }, f, el('div', { class: 'bo-head__pick' }, pick)),
-    el('div', { class: 'bo-head__end' }, el('span', { class: 'bo-head__n', 'data-bo-count': String(n) }, COPY.summary(n)), add),
+    el('div', { class: 'td-head' },
+      title,
+      el('div', { class: 'bo-head__end' }, f, el('div', { class: 'bo-head__pick' }, pick), add)),
   ];
 }
 
@@ -148,14 +154,14 @@ function render(P) {
     P.drags.destroy();
     const L = view(P);
     P.wide = (P.root.getBoundingClientRect().width || P.lastWidth || 0) >= WIDE_BOARD;
-    // as the Breakdown's Board: a wide Board with a fine pointer draws cards without the ⋯ button (the 33-control budget)
-    P.cardMenus = !P.wide || P.coarse;
+    // Always render menu buttons; they will be hidden with CSS opacity until hover
+    P.cardMenus = true;
     setChildren(P.headEl, headOf(P));
     let kids;
     if (!P.loaded) kids = [el('div', { class: 'bd-note' }, COPY.reading)];
     else if (!L) kids = [el('div', { class: 'bd-note bd-note--error', role: 'alert' }, COPY.readFailed(P.error || ''))];
     else {
-      kids = renderBoard({ P, L, A: P.actions, wide: P.wide, cardMenus: P.cardMenus });
+      kids = renderBoard({ P, L, A: P.actions, wide: P.wide, cardMenus: true, agenda: true });
       const rel = (P.out && P.out.releases) || [];
       if (rel.length) {
         grantScopes(() => bump(P));
@@ -381,7 +387,7 @@ function createPane(host, ws) {
   const P = {
     host, ws, root, headEl, bodyEl, slug: 'board', filter: 'active', init: null, out: null, raw: null, older: 0, error: null, loaded: false,
     loading: false, again: false, boardCol: 'todo', ver: 0, renderedVer: -1, drags: dragSet(), dragging: false, rendering: false,
-    disposed: false, sheet: null, wide: false, cardMenus: true, lastWidth: 0,
+    disposed: false, sheet: null, wide: false, cardMenus: true, lastWidth: 0, expandedCols: new Set(),
     coarse: typeof matchMedia === 'function' && matchMedia('(pointer: coarse)').matches,
   };
   P.actions = makeActions(P);

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

@@ -178,7 +178,7 @@ export function mountDestination(host, ctx) {
   const ws = repo ? wsOf(repo) : null;
   if (ws !== inst.ws) {
     stopPoll(inst);
-    Object.assign(inst, { ws, loaded: false, error: null, view: null, last: '', open: null, adding: null, files: [], lib: null, libError: null, graph: null });
+    Object.assign(inst, { ws, repo, loaded: false, error: null, view: null, last: '', open: null, adding: null, files: [], lib: null, libError: null, graph: null });
     inst.openCats.clear(); inst.full.clear();
     if (ws) { ensureSprite(); refresh(inst); }
     draw(inst);
@@ -362,7 +362,7 @@ function fileLine(inst, f, q = '') {
     title: marked(f.title, q),
     meta: [ini ? el('span', { class: 'rp-docs-ini', title: ini.title }, marked(ini.short, q)) : el('span', { class: 'rp-docs-path' }, marked(f.path, q)), day(f.date)],
     lead: [el('span', { class: 'rp-docs-dot rp-docs-dot--none', 'aria-hidden': 'true' })],
-    trail: adding ? [] : [button({ label: COPY.addCopy, variant: 'outline', size: 'sm', attrs: { class: 'rp-docs-addcopy', 'data-docs-act': 'add-copy', 'data-docs-key': f.path }, onClick: start })],
+    trail: adding ? [] : [button({ label: COPY.addCopy, variant: 'outline', size: 'sm', icon: 'plus', attrs: { class: 'rp-docs-addcopy', 'data-docs-act': 'add-copy', 'data-docs-key': f.path }, onClick: start })],
     onOpen: inst.lib ? toggle : null,
     openLabel: `${f.title}: show the files it links to`,
     openAttrs: { 'aria-expanded': open ? 'true' : 'false', title: f.path, 'data-docs-file-toggle': f.path },
@@ -388,17 +388,48 @@ function fileLine(inst, f, q = '') {
 /* ── the page ────────────────────────────────────────────────────────────────────────────────────────────────────── */
 
 function header(inst) {
-  if (inst.head) return inst.head;
-  const find = field({ label: COPY.find, hideLabel: true, placeholder: COPY.find, attrs: { 'data-docs-find': '' } });
-  const q = find.control;
-  inst.findControl = q;
-  q.addEventListener('input', () => { inst.q = q.value; inst.open = null; inst.adding = null; inst.graph = null; inst.full.clear(); searchFiles(inst); draw(inst); });
-  // The field restores its last committed text on Escape; here Escape clears the search instead.
-  q.addEventListener('keydown', (e) => { if (e.key === 'Escape') { q.resetCommitted(''); inst.q = ''; inst.graph = null; searchFiles(inst); draw(inst); } });
-  inst.head = el('div', { class: 'rp-docs-top' }, el('h2', { class: 'rp-head__title' }, COPY.title), el('div', { class: 'rp-docs-find' }, find));
+  if (!inst.head) {
+    const find = field({ label: COPY.find, hideLabel: true, placeholder: COPY.find, attrs: { 'data-docs-find': '' } });
+    const q = find.control;
+    inst.findControl = q;
+    q.addEventListener('input', () => { inst.q = q.value; inst.open = null; inst.adding = null; inst.graph = null; inst.full.clear(); searchFiles(inst); draw(inst); });
+    // The field restores its last committed text on Escape; here Escape clears the search instead.
+    q.addEventListener('keydown', (e) => { if (e.key === 'Escape') { q.resetCommitted(''); inst.q = ''; inst.graph = null; searchFiles(inst); draw(inst); } });
+    inst.titleEl = el('h2', { class: 'rp-head__title' }, COPY.title);
+    inst.tabsSlot = el('div', { class: 'rp-docs-views' });
+    inst.whenEl = el('span', { class: 'rp-docs-when', 'data-docs-summary': '' });
+    inst.compareBtn = button({ label: COPY.compareAll, variant: 'primary', size: 'sm', icon: 'refresh-cw', attrs: { 'data-docs-act': 'check' }, onClick: () => compareAll(inst) });
+    inst.head = el('div', { class: 'rp-docs-head' },
+      el('div', { class: 'rp-docs-top' }, inst.titleEl, inst.tabsSlot),
+      el('div', { class: 'rp-docs-bar' }, inst.whenEl, el('div', { class: 'rp-docs-find' }, find), inst.compareBtn));
+  }
   return inst.head;
 }
 
+/** The parts of the header that follow the data: the title, the view tabs with their counts, when the copies were compared. */
+function updateHead(inst) {
+  const v = inst.view;
+  const lib = inst.lib;
+  const all = v ? v.docs.reduce((n, d) => n + d.links.length, 0) : 0;
+  const needs = v ? v.docs.reduce((n, d) => n + d.links.filter((l) => needsYou(inst, d, l)).length, 0) : 0;
+  const running = !!v && (!!(v.open || v.session) || inst.busy);
+  const repoName = inst.repo ? String(inst.repo).split('/').pop() : '';
+  inst.titleEl.textContent = needs > 0 ? COPY.needYou(needs) + (repoName ? ` in ${repoName}` : '') : COPY.title;
+  inst.tabsSlot.replaceChildren(tabs({ variant: 'segmented', items: [{ id: 'needs', label: COPY.needs, count: needs }, { id: 'copies', label: COPY.copies, count: all },
+    { id: 'files', label: COPY.files, count: lib ? lib.files.length.toLocaleString('en-US') : null }],
+  value: inst.filter, ariaLabel: 'Filter', attrs: { 'data-docs-filter': '' }, onChange: (val) => { inst.filter = val; inst.graph = null; draw(inst); } }));
+  inst.whenEl.replaceChildren(icon('refresh-cw'), el('span', null, !v ? '' : running ? COPY.comparing : (v.last ? COPY.compared(v.last.finished_at) : COPY.never)));
+  inst.compareBtn.disabled = running || !all;
+  inst.compareBtn.setAttribute('aria-label', COPY.compareAll);
+  inst.compareBtn.title = COPY.compareAll;
+}
+
+/** The body inside one card with a small label, like an Agenda panel. */
+function panel(inst, nodes) {
+  const label = inst.q.trim() ? 'Results' : inst.filter === 'files' ? COPY.files : inst.filter === 'copies' ? COPY.copies : COPY.needs;
+  return el('section', { class: 'rp-docs-panel' }, el('div', { class: 'rp-docs-panel__eyebrow' }, label), ...nodes);
+}
+
 const needsYou = (inst, d, l) => l.signal !== 'same' || !!l.syncing || inst.pending.has(keyOf(d, l));
 
 /**
@@ -467,14 +498,7 @@ function body(inst) {
   const all = v.docs.reduce((n, d) => n + d.links.length, 0);
   const needs = v.docs.reduce((n, d) => n + d.links.filter((l) => needsYou(inst, d, l)).length, 0);
   const running = !!(v.open || v.session) || inst.busy;
-  const out = [el('div', { class: 'rp-docs-views' },
-    tabs({ variant: 'line', items: [{ id: 'needs', label: COPY.needs, count: needs }, { id: 'copies', label: COPY.copies, count: all },
-      { id: 'files', label: COPY.files, count: lib ? lib.files.length.toLocaleString('en-US') : null }],
-    value: inst.filter, ariaLabel: 'Filter', attrs: { 'data-docs-filter': '' }, onChange: (val) => { inst.filter = val; inst.graph = null; draw(inst); } }),
-    el('span', { class: 'rp-docs-when', 'data-docs-summary': '' },
-      running ? COPY.comparing : (v.last ? COPY.compared(v.last.finished_at) : COPY.never),
-      button({ label: '↻', variant: 'ghost', size: 'sm', disabled: running || !all,
-        attrs: { 'data-docs-act': 'check', 'aria-label': COPY.compareAll, title: COPY.compareAll }, onClick: () => compareAll(inst) })))];
+  const out = [];
   if (inst.filter === 'files') {
     if (!lib) { out.push(el('p', { class: 'rp-section__empty' + (inst.libError ? ' rp-section__empty--bad' : '') }, inst.libError || COPY.readingFiles)); return out; }
     out.push(el('div', { class: 'rp-docs-folds' }, byCategory(allEntries(inst)).map(([k, es]) => section(inst, k, es, { foldable: true }))));
@@ -498,8 +522,9 @@ function draw(inst) {
   if (fp === inst.last && root.childNodes.length && root.contains(inst.body)) return;
   inst.last = fp;
   const head = header(inst);
+  updateHead(inst);
   if (head.parentNode !== root || inst.body.parentNode !== root) root.replaceChildren(head, inst.body);
-  if (!inst.loaded) { inst.body.replaceChildren(el('p', { class: 'rp-section__empty' }, COPY.loading)); return; }
-  if (inst.error) { inst.body.replaceChildren(el('p', { class: 'rp-section__empty rp-section__empty--bad', role: 'alert' }, inst.error)); return; }
-  inst.body.replaceChildren(...body(inst));
+  if (!inst.loaded) { inst.body.replaceChildren(panel(inst, [el('p', { class: 'rp-section__empty' }, COPY.loading)])); return; }
+  if (inst.error) { inst.body.replaceChildren(panel(inst, [el('p', { class: 'rp-section__empty rp-section__empty--bad', role: 'alert' }, inst.error)])); return; }
+  inst.body.replaceChildren(panel(inst, body(inst)));
 }

package/workspace/public/pm/mobile.css

@@ -264,7 +264,7 @@
   body > [data-pm-theme] [data-dest="initiatives"] [data-in-nowline],
   body > [data-pm-theme] [data-dest="initiatives"] [data-in-hint],
   body > [data-pm-theme] [data-dest="initiatives"] .in-grip,
-  body > [data-pm-theme] [data-dest="board"] .bo-head__n,
+  body > [data-pm-theme] [data-dest="board"] .bo-head .td-count,
   body > [data-pm-theme] [data-dest="docs"] .rp-docs-top .rp-head__title,
   body[data-ph-view="cards"] > [data-pm-theme] [data-dest="docs"] .rp-docs-top,
   body[data-ph-view="cards"] > [data-pm-theme] [data-dest="docs"] .rp-docs-views,

package/workspace/public/pm/primitives.js

@@ -274,12 +274,12 @@ export function row({ title, titleIcon, meta, signals, lead, trail, onOpen, open
   trail && trail.length ? el('span', { class: 'pmc-row__trail' }, trail) : null);
 }
 
-/** card({ title, titleIcon?, meta?, signals?, lead?, trail?, onOpen, openLabel?, attrs? }): a raised card with one open button. */
-export function card({ title, titleIcon, meta, signals, lead, trail, onOpen, openLabel, muted, attrs, openAttrs } = {}) {
+/** card({ title, titleIcon?, meta?, signals?, lead?, trail?, onOpen, openLabel?, center?, attrs? }): a raised card with one open button. */
+export function card({ title, titleIcon, meta, signals, lead, trail, onOpen, openLabel, muted, center, attrs, openAttrs } = {}) {
   // the open button holds the title and the meta line, as a row's does: one column, and one tall target on a phone
   const open = el('button', { type: 'button', class: 'pmc-card__open', 'aria-label': openLabel || null, onClick: onOpen, ...(openAttrs || {}) },
     titleLine('pmc-card__title', title, titleIcon), metaLine('pmc-card__meta', meta, signals));
-  return el('div', withClass(cx('pmc-card', muted && 'pmc-card--muted'), attrs),
+  return el('div', withClass(cx('pmc-card', muted && 'pmc-card--muted', center && 'pmc-card--center'), attrs),
     el('div', { class: 'pmc-card__top' },
       lead && lead.length ? el('span', { class: 'pmc-card__lead' }, lead) : null,
       open,