create-pmos 0.60.3 → 0.61.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.60.3",
+  "version": "0.61.1",
   "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@dad3c31
+kernel-source: pmos@05e2d82
 assembled: 2026-10-06
 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-06T16:06:01Z"}
+generated: {by: process:create-pmos, at: "2026-10-06T16:49:07Z"}
 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-06T16:06:01Z"}
+generated: {by: process:create-pmos, at: "2026-10-06T16:49:07Z"}
 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-06T16:06:01Z"}
+generated: {by: process:create-pmos, at: "2026-10-06T16:49:07Z"}
 status: stable
 ---
 

package/workspace/first-paint-audit.js

@@ -23,7 +23,10 @@
 // specimen did not change.
 const SPECIMEN_A = Object.freeze({ today: 17, initiatives: 24, board: 33, reports: 14 });
 const BAR_DOCS = 1;
-const EXPECT = Object.freeze({ today: 17 + BAR_DOCS, initiatives: 24 + BAR_DOCS, board: 33 + BAR_DOCS, reports: 15 + BAR_DOCS });
+// Agenda opens on the month (the PM's Agenda mockup v5, 2026-10-06): the month adds its own controls to Today's budget,
+// at most six week rows of a week button and seven days, the two month arrows and the five lenses.
+const AGENDA_MONTH = 6 * 8 + 2 + 5;
+const EXPECT = Object.freeze({ today: 17 + BAR_DOCS + AGENDA_MONTH, initiatives: 24 + BAR_DOCS, board: 33 + BAR_DOCS, reports: 15 + BAR_DOCS });
 
 /* ── shoot.js audit(), copied verbatim (scratchpad/specimens2/shoot.js, 2026-10-05) ─────────────────────────────── */
 // runs in the page
@@ -149,4 +152,4 @@ function installCounter(page) {
   return page.addInitScript({ content: 'window.__countIn = ' + countIn.toString() + ';' });
 }
 
-module.exports = { EXPECT, SPECIMEN_A, audit, countIn, stableCount, installCounter };
+module.exports = { AGENDA_MONTH, EXPECT, SPECIMEN_A, audit, countIn, stableCount, installCounter };

package/workspace/guide/initiatives-timeline.md

@@ -2,7 +2,7 @@
 type: Guide
 title: "Initiatives › Timeline: when each initiative runs"
 description: "How to read the Timeline of Initiatives, what draws a bar, how to reorder rows, and what to do on a phone."
-timestamp: 2026-10-05
+timestamp: 2026-10-06
 ---
 
 # Initiatives › Timeline
@@ -50,7 +50,7 @@ Moving a row inside Now is a placement into Now. If the workspace asks for your
 
 ## On a phone
 
-At 390 px the chart scrolls sideways inside its own box. The page does not scroll sideways. The name of each row stays at the left edge while the months move under it. Every control on a row, the grip, the arrow and the **⋯** button, is at least 44 px high and wide.
+A phone, or a window 760 px wide or less, does not show the Timeline. There, Initiatives shows the Roadmap, or the List from the search (see [the layout guide](layout.md)). Use a wider window to see the Timeline.
 
 ## Keep the view current
 

package/workspace/guide/layout.md

@@ -1,7 +1,7 @@
 ---
 type: Guide
 title: "Guide: layout"
-description: "The frame: one top bar, the place on screen, the detail and the agent dock; the phone tabs; the keys; and the older layout."
+description: "The frame: one top bar, the place on screen, the detail and the agent dock; the phone tabs and decks; the keys; and the older layout."
 timestamp: 2026-10-06
 ---
 
@@ -91,9 +91,28 @@ A key that you type in a field, or in a terminal, goes to the field or the termi
 
 ## On a phone
 
-A phone shows one panel at a time. The tabs at the bottom are **Agenda, Initiatives, Board, Reports and Agent**. Agent shows the dock, with your terminals. Search or capture ⌘K is pinned at the top of Agenda.
+A phone shows one panel at a time. The tabs at the bottom are **Agenda, Initiatives, Board, Reports, Docs and Agent**. Agent shows the dock, with your terminals.
 
-The bar at the top has Back (when you are deeper than a tab), Repository, the name of the screen, ⌘K, Sync (when the repository is not in sync, or has not fetched in the last 10 minutes) and Settings. Settings opens over the current tab. Back returns to the tab.
+Each tab on a phone shows one thing at a time. Where a tab has a list, the list is a deck of cards: one card fills the screen, and you swipe sideways to go to the next card. The line above the deck says where you are, for example "3 of 12". The bar at the bottom of the deck has a back arrow, a progress line and a forward arrow. On a keyboard, the left and right arrow keys move between cards. When you leave a tab and come back, the deck opens at the card you left.
+
+Some tabs have a second view. The buttons next to the "3 of 12" line change the view:
+
+| Tab | The deck | The other view | Not on a phone |
+| --- | --- | --- | --- |
+| Agenda | **Cards**: one card for each thing that needs you. When your day is not prepared yet, the first card is **Prepare your day**. Press **Prepare my day** to start it, or **See the day** to open Day. | **Day**: your calendar, your goals and the jobs the agent does for the day. | The Repository / All repositories switch (use Repository in the bar). |
+| Initiatives | **Cards**: one initiative for each card, in Roadmap order. | **All**: the list of every initiative. Press one to open it. | The title, New initiative, the count line and the drag grips. |
+| Board | One item for each card, in the column you choose. Choose the initiative in the menu at the top, and the column with the column buttons. | None. | The item count. |
+| Reports | No deck. Read a report, or draft one. | None. | The title and Report schedules. |
+| Docs | **Cards**: one document that needs you for each card. | **All**: every document, in its groups. | The title. |
+| Agent | No deck. Talk to a session. | None. | The scratchpad bar when no terminal is in front. |
+
+When you open a terminal, the terminal fills the screen. The tabs at the bottom are not shown, so the output has the most space. The control keys stay at the bottom. Press Back to return to the tabs.
+
+Nothing is lost. New initiative is in the search. To move a card on the Roadmap, press its **⋯**. To set up report schedules or use the Timeline, use a desktop.
+
+The bar at the top has Back (when you are deeper than a tab), Repository, the search button, Sync (when the repository is not in sync, or has not fetched in the last 10 minutes) and Settings, which is the gear. The search button opens ⌘K, where you search and capture. At a tab, the bar shows no screen name, because the tabs at the bottom show where you are. When you open something over a tab, such as an initiative, a document or Settings, the bar shows its name. Settings opens over the current tab. Back returns to the tab.
+
+In the initiative sheet on a phone, the Breakdown shows the tree of items. It does not show the Board and Timeline switch or the list of starter items. Use the Board tab to see the items as a board.
 
 Every row has a visible ⋯ button. Every control is at least 44 pixels high. Nothing works only when you hover.
 

package/workspace/guide/today.md

@@ -30,11 +30,11 @@ An agent job can stop with its session still open, for example when the agent as
 
 Each job session is named "Job ·" and the first words of the job, so the session list stays short.
 
-**Agent results**, at the top of the left column, counts the jobs and lists each finished one with its draft summary or the reason it failed. Your goals for today come under it, above the calendar. The other things that wait for you, such as outcome checks, report drafts and sessions, are in **Also waiting for you** at the end of the left column. When the day is folded, they show under it.
+The Agenda month is at the top of the left column. **Agent results** comes under it, counts the jobs and lists each finished one with its draft summary or the reason it failed. Your goals for today come under Agent results. The day is open when you go to Agenda, also before you press **Prepare my day**. The other things that wait for you, such as outcome checks, report drafts and sessions, are in **Also waiting for you** at the end of the left column. When the day is folded, they show under it.
 
 ### The Agenda month
 
-The menu calls this page **Agenda**. At the top of the left column is the month, with today marked. Each week starts with its number, for example W41.
+The menu calls this page **Agenda**. At the top of the left column is the month, with today marked. When a day shows no meetings yet, press **Prepare my day** (or **Prepare again**): the morning-brief session reads your calendar and fills the month. Each week starts with its number, for example W41.
 
 - Press a day to see its agenda under the month. Three tiles open the agenda: the time in meetings, the meeting that matters most, and your prep.
 - Press a week number to see the agenda of that week, day by day.

package/workspace/lib/mobile-nav.js

@@ -66,15 +66,15 @@ const DETAIL_TITLE = {
   addprod: 'add repository', new: 'file new',
 };
 
-/* ── the frame's five phone tabs (pm-os-absorb Run 3, slice 3A; PRD R15) ─────────────────────────────────────────
- * Today · Initiatives · Board · Reports · Agent. The first four are the frame's destinations (a `dest` screen, drawn
- * in the frame's place, panel index 0); Agent is the dock (an `agent` screen, panel 4, the live terminals). Settings
+/* ── the frame's six phone tabs (pm-os-absorb Run 3, slice 3A; PRD R15; Docs joined at the PM's word, 2026-10-06) ──
+ * Today · Initiatives · Board · Reports · Docs · Agent, the desktop bar's order. The first five are the frame's
+ * destinations (a `dest` screen, drawn in the frame's place, panel index 0); Agent is the dock (an `agent` screen, panel 4, the live terminals). Settings
  * is not a tab: it is pushed on top of the current tab as a `dest` screen with id `settings`, so Back returns.
  * The old cockpit's list modes still map to a tab (MOBILE_DEST), for the old shell (fixture mode, ?layout=legacy). */
-const MOBILE_DESTS = ['today', 'initiatives', 'board', 'reports', 'agent'];
+const MOBILE_DESTS = ['today', 'initiatives', 'board', 'reports', 'docs', 'agent'];
 // What each tab and Settings is called. The same words as the desktop bar (public/pm/frame-copy.js COPY.nav), which
 // MOBNAV-P7 holds equal.
-const DEST_TITLE = { today: 'Agenda', initiatives: 'Initiatives', board: 'Board', reports: 'Reports', agent: 'Agent', settings: 'Settings' };
+const DEST_TITLE = { today: 'Agenda', initiatives: 'Initiatives', board: 'Board', reports: 'Reports', docs: 'Docs', agent: 'Agent', settings: 'Settings' };
 // Every old MODES key has a tab. The suite ITERATES this map, so a mode without a phone path fails.
 const MOBILE_DEST = { product: 'initiatives', scheduled: 'reports', agent: 'agent', memory: 'initiatives',
   workflow: 'initiatives', skills: 'initiatives', knowledge: 'initiatives' };
@@ -83,6 +83,7 @@ const MOBILE_ROOT = {
   initiatives: { kind: 'dest', id: 'initiatives' },
   board: { kind: 'dest', id: 'board' },
   reports: { kind: 'dest', id: 'reports' },
+  docs: { kind: 'dest', id: 'docs' },
   agent: { kind: 'agent', id: null },
 };
 // The tab every stored value of the retired five-tab nav (board · scheduled · agents · memory · more) and of the

package/workspace/package-lock.json

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

package/workspace/package.json

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

package/workspace/public/index.html

@@ -89,7 +89,7 @@
      breakpoint this is absent from the accessibility tree rather than merely invisible: a desktop
      PM must not be able to tab into a second navigation system they cannot see. -->
 
-<!-- The top bar: back · Repository · the screen's name · the ⌘K palette · Settings (the frame; the old shell shows its
+<!-- The top bar: back · Repository · the screen's name (on a pushed screen only) · search · Settings (the frame; the old shell shows its
      brand and theme in place of Repository and Settings). It sits ABOVE .body in
      DOM order because it is the row above the content on screen, and putting it beside the bottom
      nav would read the app backwards. -->
@@ -106,16 +106,27 @@
          guess at. A control the PM cannot see is the hover-only trap in another costume. The
          palette is a jump control for every destination, so it belongs in the bar that is always
          on screen. -->
-    <button class="mob-pal" id="mobPalette" type="button" aria-label="Open the jump palette (⌘K)">⌘K</button>
+    <!-- A magnifier, not the letters ⌘K: a phone has no ⌘ key. It opens the same palette as ⌘K on a desktop, where you
+         search and capture. It replaced the "Search or capture" control that was pinned above Today, so a phone screen
+         now leads with its one job and search is in one place on every tab. -->
+    <button class="mob-pal" id="mobPalette" type="button" aria-label="Search or capture" aria-keyshortcuts="Meta+K Control+K"><svg class="pmc-icon" width="16" height="16" aria-hidden="true" focusable="false" data-icon="search"><use href="#lucide-search"></use></svg></button>
     <button class="mob-theme" id="mobTheme" type="button" aria-label="Toggle theme"><svg class="pmc-icon" width="16" height="16" aria-hidden="true" focusable="false" data-icon="moon"><use href="#lucide-moon"></use></svg></button>
     <button class="mob-sync" id="mobSync" type="button" hidden>Sync</button>
-    <button class="mob-set" id="mobSettings" type="button" hidden aria-current="false">Settings</button>
+    <button class="mob-set" id="mobSettings" type="button" hidden aria-current="false" aria-label="Settings"><svg class="pmc-icon" width="18" height="18" aria-hidden="true" focusable="false" data-icon="settings"><use href="#lucide-settings"></use></svg></button>
   </header>
+  <!-- The deck head (pm/phone-deck.js): at a tab's root, which card of how many is on screen and, where the tab has a
+       second view, the switch to it (Today: Cards or Day; Initiatives and Docs: Cards or All). Shown only on a tab
+       whose place draws a deck. -->
+  <div class="mob-deck" id="mobDeck" hidden>
+    <span class="mob-deck__where" id="mobDeckWhere" aria-live="polite"></span>
+    <span class="mob-deck__views" id="mobDeckViews" role="group" aria-label="View"></span>
+  </div>
 </div>
 
 <!-- The bottom block: a terminal control-key accessory bar (terminal screen only — phones have no
-     Esc/Tab/Ctrl/arrows) over the five tabs (pm-os-absorb Run 3, slice 3A): Today · Initiatives · Board · Reports ·
-     Agent. The first four are the frame's places; Agent is the dock with its live terminals. The nav is a <nav> of
+     Esc/Tab/Ctrl/arrows), the deck's pager (a tab's root only), and the six tabs (pm-os-absorb Run 3, slice 3A):
+     Today · Initiatives · Board · Reports · Docs · Agent. The first five are the frame's places; Agent is the dock with
+     its live terminals. On a terminal the tabs are not drawn: the session takes the screen, and Back returns. The nav is a <nav> of
      buttons carrying aria-current, NOT a tablist: there is no tabpanel to point at. Selecting a tab resets it to its
      root; depth is pushed on top of it and #mobBack pops one screen. Words, not glyphs, name each tab. -->
 <div class="mobmenu" id="mobMenu" hidden>
@@ -128,11 +139,18 @@
     <button type="button" data-seq="down" aria-label="Down arrow"><svg class="pmc-icon" width="16" height="16" aria-hidden="true" focusable="false" data-icon="arrow-down"><use href="#lucide-arrow-down"></use></svg></button>
     <button type="button" data-seq="right" aria-label="Right arrow"><svg class="pmc-icon" width="16" height="16" aria-hidden="true" focusable="false" data-icon="arrow-right"><use href="#lucide-arrow-right"></use></svg></button>
   </div>
+  <!-- The deck's pager: the previous card, where this one is in the deck, the next card. A swipe does the same. -->
+  <div class="mob-pager" id="mobPager" hidden>
+    <button type="button" class="mob-pager__b" id="mobPrev" aria-label="Previous card"><svg class="pmc-icon" width="18" height="18" aria-hidden="true" focusable="false" data-icon="chevron-left"><use href="#lucide-chevron-left"></use></svg></button>
+    <span class="mob-pager__track" id="mobPagerTrack" aria-hidden="true"><span class="mob-pager__fill" id="mobPagerFill"></span></span>
+    <button type="button" class="mob-pager__b" id="mobNext" aria-label="Next card"><svg class="pmc-icon" width="18" height="18" aria-hidden="true" focusable="false" data-icon="chevron-right"><use href="#lucide-chevron-right"></use></svg></button>
+  </div>
   <nav class="mobnav" id="mobNav" aria-label="Destinations">
     <button type="button" class="mobnav-b" data-dest="today" aria-current="page"><span class="l">Agenda</span><span class="mobnav-n" id="mobTodayCount" hidden></span></button>
     <button type="button" class="mobnav-b" data-dest="initiatives" aria-current="false"><span class="l">Initiatives</span></button>
     <button type="button" class="mobnav-b" data-dest="board" aria-current="false"><span class="l">Board</span></button>
     <button type="button" class="mobnav-b" data-dest="reports" aria-current="false"><span class="l">Reports</span></button>
+    <button type="button" class="mobnav-b" data-dest="docs" aria-current="false"><span class="l">Docs</span></button>
     <button type="button" class="mobnav-b" data-dest="agent" aria-current="false"><span class="l">Agent</span></button>
   </nav>
 </div>

package/workspace/public/pm/app.js

@@ -39,7 +39,7 @@ import { isMobile, mountMobile, applyMobile } from './mobile.js';
 /* The frame's parts (Run 3, slice 3A). Small modules with no effect at import: a fixture page loads them and calls none. */
 import { createTopbar, unsyncedOf } from './topbar.js';
 import { createDockRail } from './dock.js';
-import { SEL, ensureComponentsCss, iconButton, button, menu, toast } from './primitives.js';
+import { SEL, ensureComponentsCss, iconButton, menu, toast } from './primitives.js';
 import { ensureSprite } from './icons.js';
 import { COPY as FC } from './frame-copy.js';
 import { registerCommand } from './registry.js';
@@ -543,7 +543,6 @@ if (FRAME) {
 let bar = null;
 let dockRail = null;
 let frDetail = null;
-let pin = null;
 const hostMain = el('div', { class: 'fr-main', 'data-fr': 'main' });
 const destHosts = {};
 for (const id of FRAME_DESTS) destHosts[id] = el('div', { class: 'fr-dest', 'data-fr-host': id, hidden: true });
@@ -559,7 +558,6 @@ function setupFrame() {
   frDetail = el('div', { class: 'fr-detail', 'data-fr': 'detail' },
     el('div', { class: 'fr-detail__bar' }, iconButton({ icon: 'x', ariaLabel: FC.detail.close, onClick: closeDetail, attrs: { 'data-fr': 'detail-close' } })),
     hostDetail);
-  pin = button({ label: FC.phone.pin, variant: 'outline', block: true, attrs: { class: 'fr-pin', 'data-fr': 'pin', 'aria-keyshortcuts': 'Meta+K Control+K' }, onClick: openPalette });
   root.removeAttribute('style');
   root.classList.add('fr-root');
   bodyGrid.removeAttribute('style');
@@ -570,12 +568,14 @@ function setupFrame() {
   setState({ col2: false, todayScope: fr.scope });
 }
 
-function paintMain(phone) {
+function paintMain() {
   // the state-health banner (panel-repos.js) heads every place while the runtime state is not settled: it is not
   // dismissible, and the frame has no repository panel for it to sit in
   let banner = null;
   try { banner = mods.repos && typeof mods.repos.stateHealthBanner === 'function' ? mods.repos.stateHealthBanner() : null; } catch { banner = null; }
-  const kids = [banner, phone && fr.dest === 'today' ? pin : null, ...FRAME_DESTS.map((id) => destHosts[id])];
+  // On a phone, search and capture are the top bar's search control (pm/mobile.js), not a second control above Today:
+  // a phone screen leads with its one job.
+  const kids = [banner, ...FRAME_DESTS.map((id) => destHosts[id])];
   setChildren(hostMain, kids);
   for (const id of FRAME_DESTS) destHosts[id].hidden = id !== fr.dest;
   const reg = fr.reg;
@@ -610,7 +610,7 @@ function renderFrame() {
   // its grid) and a reader of the body's fourth child still finds panel 4. A closed detail stays mounted, hidden.
   frDetail.hidden = !phone && !detail;
   setChildren(bodyGrid, phone ? [hostMain, dockRail, frDetail, hostTabs] : [hostMain, frDetail, dockRail, hostTabs]);
-  paintMain(phone);
+  paintMain();
   if (detail || phone) paint(mods.detail, 'renderDetail', hostDetail);
   paint(mods.tabs, 'renderTabs', hostTabs);
   paint(mods.cockpit, 'renderPalette', paletteHost);

package/workspace/public/pm/components.css

@@ -491,6 +491,14 @@
 .pmc-card--muted .pmc-card__title {
   color: var(--muted-foreground);
 }
+/* card in a phone deck (pm/phone-deck.js adds .ph-card only while a phone shows its Cards view): one tall target that
+ * opens it, its title at reading size */
+.pmc-card.ph-card { padding: 0; }
+.pmc-card.ph-card .pmc-card__top { flex: 1; align-items: stretch; min-height: 0; }
+.pmc-card.ph-card .pmc-card__open { display: flex; flex-direction: column; justify-content: flex-start; gap: 14px; padding: 22px 18px; min-width: 0; text-align: left; }
+.pmc-card.ph-card .pmc-card__title { font-size: 20px; line-height: 1.25; font-weight: 600; white-space: normal; overflow: visible; display: block; }
+.pmc-card.ph-card .pmc-card__meta { flex-wrap: wrap; white-space: normal; font-size: 14px; line-height: 1.5; }
+.pmc-card.ph-card .pmc-card__trail { align-self: flex-start; padding: 8px 6px 0 0; }
 .pmc-card:focus-visible,
 .pmc-card:has(.pmc-card__open:focus-visible) {
   outline: 2px solid color-mix(in oklab, var(--ring) 50%, var(--foreground));
@@ -2258,16 +2266,6 @@
 .fr-body[data-fr-dock="rail"] > .fr-dock {
   display: none !important;
 }
-/* The pinned ⌘K on a phone. .pmc-btn--block sets width: 100%, which with the side margins runs 32px past the place
- * (and .fr-main clips it). The column's stretch gives the width inside the margins. */
-.fr-pin {
-  flex: none;
-  align-self: stretch;
-  width: auto;
-  justify-content: flex-start;
-  margin: 12px 16px 0;
-  color: var(--muted-foreground);
-}
 /* Settings: one column of seven sections. */
 .fr-set {
   display: flex;
@@ -4592,6 +4590,7 @@
   font-size: 12px;
   color: var(--muted-foreground);
 }
+.lg-dock-bottom[hidden] { display: none; }
 .lg-dock-bottom__title {
   flex: 1;
   min-width: 0;

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

@@ -33,6 +33,7 @@ registerCommand({
   id: 'initiatives-new', label: COPY.newInitiative, hint: 'Add one to Later', cli: 'pmos initiative new "<title>" --anchor <kr>',
   run: () => { openDestination('initiatives'); try { window.dispatchEvent(new CustomEvent('pmos:initiatives-new')); } catch { /* no window */ } },
 });
+registerCommand({ id: 'initiatives-roadmap', label: 'Initiatives as a roadmap', hint: 'Now, Next and Later', cli: 'pmos initiative list', run: () => { try { window.localStorage.setItem('pmos.initiatives.view', 'roadmap'); } catch { /* no storage */ } openDestination('initiatives'); try { window.dispatchEvent(new CustomEvent('pmos:initiatives-view', { detail: 'roadmap' })); } catch { /* no window */ } } });
 registerCommand({
   id: 'initiatives-rescan', label: COPY.rescan, hint: COPY.rescanHint,
   run: () => { openDestination('initiatives'); try { window.dispatchEvent(new CustomEvent('pmos:initiatives-rescan')); } catch { /* no window */ } },
@@ -42,6 +43,8 @@ registerCommand({ id: 'initiatives-list', label: 'Initiatives as a list', hint:
 const BUILT_IN = ['roadmap', 'list'];
 const roots = new WeakMap();   // host -> its persistent root and what it shows
 
+const phone = () => { try { return window.matchMedia('(max-width:760px)').matches; } catch { return false; } };
+
 function savedView() { try { return window.localStorage.getItem('pmos.initiatives.view'); } catch { return null; } }
 function saveView(v) { try { window.localStorage.setItem('pmos.initiatives.view', v); } catch { /* no storage */ } }
 
@@ -96,6 +99,10 @@ function draw(host, r, ctx, repo, ws) {
     ...initiativesViews().filter((v) => !BUILT_IN.includes(v.id)).map((v) => ({ id: v.id, label: v.label || v.id })),
   ];
   if (!views.some((v) => v.id === r.view)) r.view = 'roadmap';
+  // A phone shows Roadmap or List only, and has no view switch (pm/mobile.css): its screen is one job, to see where the
+  // initiatives stand and open one. ⌘K changes between the two. Any other view falls back to Roadmap here without being
+  // saved, so the desktop keeps its choice.
+  if (phone() && !BUILT_IN.includes(r.view)) r.view = 'roadmap';
   r.key = keyOf(r, repo, ws);
 
   const head = el('div', { class: 'in-head' },

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

@@ -21,10 +21,28 @@ import { wsOf } from './data.js';
 import { state, setState, FIXTURE } from './state.js';
 import { COPY } from './today-copy.js';
 import { todayCard, acceptCard, rankNodes, scopeCtx, ensureFeed, feedOf, feedErrorOf, bannerOf, onFeed } from './today-cards.js';
-import { daySection, daySig } from './today-day.js';
+import { daySection, daySig, dayState, pressPrepare } from './today-day.js';
 
 const SHOWN = 3;   // cards drawn before "Show more": the first paint holds at most 17 controls (first-paint-today.test.js)
 let expanded = false;
+/* A phone shows Today as a deck, one card at a time (pm/phone-deck.js): every card is in it, so there is no "Show more". */
+const phone = () => { try { return window.matchMedia('(max-width:760px)').matches; } catch { return false; } };
+
+/* The phone's first card while the day is not prepared: the day's one press, and the way to the Day view. A desktop has
+ * the day section's own Prepare my day in view, so this card is drawn on a phone only. */
+function prepCard(ws) {
+  const st = dayState(ws);
+  if (!st.known || st.prepared) return null;
+  const P = COPY.prep;
+  return el('div', { class: 'td-card td-card--prep', 'data-today': 'card', 'data-today-kind': 'prep', 'data-today-id': 'prep' },
+    el('div', { class: 'td-card__top' },
+      el('div', { class: 'td-card__text' },
+        el('div', { class: 'td-card__cause', 'data-today-cause': '' }, P.cause),
+        el('div', { class: 'td-card__evidence' }, P.evidence)),
+      el('div', { class: 'td-card__acts' },
+        button({ label: st.busy ? P.busy : P.go, variant: 'primary', disabled: st.busy, attrs: { 'data-today-prep': 'go', 'data-today-act': '' }, onClick: () => pressPrepare(ws) }),
+        button({ label: P.see, variant: 'outline', attrs: { 'data-today-prep': 'day' }, onClick: () => { if (window.pmDeck) window.pmDeck.setView('today', 'day'); } }))));
+}
 
 /* ── the source for the cards the server makes itself ─────────────────────────────────────── */
 
@@ -101,9 +119,10 @@ function build(ctx0) {
   const regCtx = { all: sc.all, repos: sc.repos, setState: ctx0.setState || setState, open: (r, slug) => openInitiative(r, slug) };
   const n = todayCount(regCtx);
   const nodes = rankNodes(todayCards(regCtx));
+  const onPhone = phone();
   const ready = sc.repos.length > 0 && sc.repos.every((r) => { const ws = wsOf(r); return !ws || feedOf(ws) !== null || feedErrorOf(ws) !== null; });
   const banner = bannerOf(sc.repos);
-  nodes.forEach((node, i) => { if (!expanded && i >= SHOWN) node.hidden = true; });
+  nodes.forEach((node, i) => { if (!expanded && !onPhone && i >= SHOWN) node.hidden = true; });
 
   const head = el('div', { class: 'td-head' },
     el('h2', { class: 'td-count', 'data-today': 'count', 'aria-live': 'polite' }, countText(sc, n, ready)),
@@ -114,7 +133,7 @@ function build(ctx0) {
   const list = nodes.length
     ? el('div', { class: 'td-list', 'data-today': 'needs', role: 'list', 'aria-label': COPY.aria.list }, ...nodes)
     : el('div', { class: 'td-list', 'data-today': 'needs' }, ready && !banner.some((b) => b.source === COPY.health.todaySource) ? empty({ text: COPY.empty(nextLabel(sc.repos)), attrs: { 'data-today': 'empty' } }) : null);
-  const more = nodes.length > SHOWN
+  const more = nodes.length > SHOWN && !onPhone
     ? button({ label: expanded ? COPY.fewer : COPY.more(nodes.length - SHOWN), variant: 'ghost', attrs: { 'data-today': 'more' }, onClick: () => { expanded = !expanded; setState({}); } })
     : null;
   nodes.forEach((node) => node.setAttribute('role', 'listitem'));
@@ -122,6 +141,8 @@ function build(ctx0) {
   // joined to the cards of the first repository in scope, and its initiatives open in that repository
   const dayRepo = sc.repos.length ? sc.repos[0] : null;
   const dayWs = dayRepo ? wsOf(dayRepo) : null;
+  const prep = onPhone && !(window.pmDeck && window.pmDeck.phoneView('today') === 'day') ? prepCard(dayWs) : null;
+  if (prep) { prep.setAttribute('role', 'listitem'); const none = list.querySelector('[data-today="empty"]'); if (none) none.setAttribute('data-today-id', 'empty'); list.prepend(prep); }   // the empty note stays, as the deck's last card
   // the open day takes the list into its left column ("Also waiting for you"), so Today shows one layout; a folded day
   // leaves it below, as before
   const owed = { list, more, count: n };
@@ -130,7 +151,7 @@ function build(ctx0) {
   const here = sc.repo ? wsOf(sc.repo) : null;
   const day = daySection({ ws: dayWs, setState: ctx0.setState || setState, openIni: dayRepo ? (id) => openInitiative(dayRepo, id) : null, owed, here, all: sc.all });
   const inDay = !!(day && day.contains(list));
-  return { children: inDay ? [head, day, health] : [head, day, health, list, more], sig: JSON.stringify([sc.all, sc.repo, n, ready, expanded, banner]) + daySig(dayWs) + nodes.map((x) => x.outerHTML).join('') };
+  return { children: inDay ? [head, day, health] : [head, day, health, list, more], sig: JSON.stringify([sc.all, sc.repo, n, ready, expanded, banner, onPhone, prep ? prep.outerHTML : null]) + daySig(dayWs) + nodes.map((x) => x.outerHTML).join('') };
 }
 
 /** The key of the control that has the focus inside the board, so it can be focused again after a rebuild. */

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

@@ -111,7 +111,6 @@ export const COPY = {
   detail: { close: 'Close the detail' },
   phone: {
     back: 'Back',
-    pin: 'Search or capture',
   },
   page: {
     title: 'Settings',

package/workspace/public/pm/mobile.css

@@ -35,7 +35,7 @@
    * centred, with a hairline on each side so the phone shape is legible on a wide-ish tablet. */
   body {
     display: grid;
-    grid-template-rows: 52px minmax(0, 1fr) auto;
+    grid-template-rows: auto minmax(0, 1fr) auto;
     height: 100vh;
     max-width: 430px;
     margin: 0 auto;
@@ -155,7 +155,9 @@
     white-space: nowrap;
     font-weight: 600;
   }
-  .mob-set[aria-current="page"] { text-decoration: underline; }
+  .mob-set { justify-content: center; color: var(--muted-foreground); }
+  .mob-set[aria-current="page"] { color: var(--foreground); }
+  .mob-sync { padding: 0 10px; }
 
   /* ── the bottom block ────────────────────────────────────────────────────────────────────── */
 
@@ -199,8 +201,8 @@
   }
   .ctrlbar .lbl { font-size: 11px; letter-spacing: .04em; }
 
-  /* Five destinations, one per column, 64px tall — the prototype's bottom nav. */
-  .mobnav { display: grid; grid-template-columns: repeat(5, 1fr); min-width: 0; }
+  /* Six destinations, one per column, 64px tall — the prototype's bottom nav, with Docs (the desktop bar's order). */
+  .mobnav { display: grid; grid-template-columns: repeat(6, 1fr); min-width: 0; }
   .mobnav-b {
     display: flex;
     flex-direction: column;
@@ -217,9 +219,142 @@
   .mobnav-b[aria-current="page"] { color: var(--foreground); }
   /* The tabs are words (the frame's five tabs); the Today tab carries the count of what needs the PM. */
   .mobnav-b { font-family: var(--sans); }
-  .mobnav-b .l { font-size: 12px; }
+  .mobnav-b .l { font-size: 12px; max-width: 100%; overflow: hidden; text-overflow: ellipsis; }
   .mobnav-b[aria-current="page"] .l { text-decoration: underline; text-underline-offset: 4px; }
   .mobnav-n { font-family: var(--mono); font-size: 11px; line-height: 1; }
+
+  /* ── one job per screen, one card at a time ────────────────────────────────────────────────────
+   * A phone is not a small desktop. At a tab's root the tab's cards are a deck, one card on the screen at a time
+   * (pm/phone-deck.js), and the deck head above them says which card of how many it is. The controls that serve desk
+   * work are not drawn. Nothing below removes a capability: each hidden control is a desktop one, or the deck head's
+   * view switch, the bar's Repository menu or ⌘K (the bar's search) reaches the same act. The nodes stay in the DOM,
+   * so the renderers are the desktop's, unchanged (see pm/mobile.js, "ONE renderer, two shells").
+   *
+   *   Today        the Today cards. The count is in the deck head; the scope is the bar's Repository menu (it has
+   *                All repositories). Day, the deck head's second view, is the day section: goals, calendar, jobs.
+   *   Initiatives  the Roadmap's cards. No title, view switch, New initiative, count line, hint or drag grips: the
+   *                deck head's All is the List, ⌘K has New initiative, and a card's ⋯ moves it.
+   *   Board        the picked initiative's cards in the column on screen: Active or Mine, the initiative picker and
+   *                the column switch stay. No count, and not a second "no item" note above the column's own.
+   *   Reports      read a report, or draft one: no title (the tab names it) and no schedule set-up.
+   *   Docs         the copies that need you, one card each. All, the deck head's second view, lists every copy and
+   *                has the search.
+   *   An initiative (the sheet)  act on its next step: the stepper and the waiting line lead. The Breakdown tab shows
+   *                the Tree only (the Board tab is the board) and not the starter list, which is authoring. */
+  body > [data-pm-theme] [data-dest="today"] [data-today="scope"],
+  body > [data-pm-theme] [data-dest="today"] .td-head,
+  body:not([data-ph-view="day"]) > [data-pm-theme] [data-dest="today"] [data-today="day"],
+  body > [data-pm-theme] [data-dest="today"] [data-today="day"] [data-day="toggle"],
+  body > [data-pm-theme] [data-dest="initiatives"] .in-head,
+  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="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,
+  body[data-ph-view="cards"] > [data-pm-theme] [data-dest="docs"] .rp-docs-group__title,
+  body > [data-pm-theme] [data-dest="board"] [data-bo-empty],
+  body > [data-pm-theme] [data-dest="reports"] .rp-head__title,
+  body > [data-pm-theme] [data-dest="reports"] [data-rp-section="schedules"],
+  [data-in-sheet] .bd-head > [data-bd-view],
+  [data-in-sheet] [data-bd-starters] { display: none !important; }
+
+  /* ── the deck head and the pager (pm/phone-deck.js) ─────────────────────────────────────────── */
+
+  .mob-deck {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 10px;
+    min-height: 48px;
+    padding: 0 14px;
+    background: var(--background);
+    border-bottom: 1px solid var(--border);
+    font-family: var(--mono);
+    font-size: 11px;
+    letter-spacing: .06em;
+    text-transform: uppercase;
+    color: var(--muted-foreground);
+  }
+  .mob-deck__where { min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+  .mob-deck__views { display: inline-flex; flex: none; border: 1px solid var(--border); }
+  .mob-deck__view {
+    min-width: 44px;
+    min-height: 44px;
+    padding: 0 12px;
+    font: inherit;
+    letter-spacing: inherit;
+    text-transform: inherit;
+    color: var(--muted-foreground);
+  }
+  .mob-deck__view[aria-pressed="true"] { background: var(--foreground); color: var(--background); }
+
+  .mob-pager { display: grid; grid-template-columns: 48px minmax(0, 1fr) 48px; align-items: center; border-bottom: 1px solid var(--border); }
+  .mob-pager__b { display: grid; place-items: center; min-width: 48px; min-height: 44px; color: var(--foreground); }
+  .mob-pager__b:disabled { opacity: .3; }
+  .mob-pager__track { height: 3px; background: var(--border); }
+  .mob-pager__fill { display: block; height: 100%; width: var(--fr-deck-fill, 0); background: var(--foreground); transition: width .2s ease-out; }
+
+  /* The deck: the tab's own list, laid side by side, one card per screen width, snapping to each. The card's height is
+   * the screen between the deck head and the pager (--fr-deck-h, measured by pm/phone-deck.js). */
+  body[data-ph-view="cards"] .ph-deck {
+    display: flex !important;
+    flex-direction: row !important;
+    flex-wrap: nowrap !important;
+    gap: 0 !important;
+    margin: 0 !important;
+    padding: 0 !important;
+    overflow-x: auto;
+    overflow-y: hidden;
+    scroll-snap-type: x mandatory;
+    overscroll-behavior-x: contain;
+    scrollbar-width: none;
+  }
+  body[data-ph-view="cards"] .ph-deck::-webkit-scrollbar { display: none; }
+  /* The Roadmap's three columns and the Docs' groups hand their cards to the one deck. */
+  body[data-ph-view="cards"] .ph-deck .in-col,
+  body[data-ph-view="cards"] .ph-deck .in-list,
+  body[data-ph-view="cards"] .ph-deck .rp-docs-group,
+  body[data-ph-view="cards"] .ph-deck .rp-docs-group > [role="list"] { display: contents !important; }
+  body[data-ph-view="cards"] .ph-deck .in-col__head,
+  body[data-ph-view="cards"] .ph-deck .in-col__empty,
+  body[data-ph-view="cards"] .ph-deck .in-col > :not(.in-list),
+  body[data-ph-view="cards"] .ph-deck .in-list--dormant { display: none !important; }
+  body[data-ph-view="cards"] .ph-deck > .rp-section__empty { flex: 0 0 100%; }
+  body[data-ph-view="cards"] .ph-card {
+    flex: 0 0 100% !important;
+    width: 100% !important;
+    max-width: none !important;
+    height: var(--fr-deck-h, 60vh);
+    margin: 0 !important;
+    overflow-y: auto;
+    scroll-snap-align: start;
+    scroll-snap-stop: always;
+    display: flex !important;
+    flex-direction: column;
+    background: var(--card);
+    border: 1px solid var(--border);
+  }
+  /* A Today card: the cause leads, the evidence wraps under it, the acts sit at the bottom at full width. */
+  body[data-ph-view="cards"] .ph-card.td-card { padding: 20px 18px; }
+  body[data-ph-view="cards"] .ph-card .td-card__top { flex: 1; display: flex; flex-direction: column; justify-content: space-between; gap: 18px; }
+  body[data-ph-view="cards"] .ph-card .td-card__text { display: grid; gap: 12px; align-content: start; }
+  body[data-ph-view="cards"] .ph-card .td-card__cause { font-size: 20px; line-height: 1.3; font-weight: 600; }
+  body[data-ph-view="cards"] .ph-card .td-card__evidence { white-space: normal; overflow: visible; font-size: 14px; line-height: 1.45; }
+  body[data-ph-view="cards"] .ph-card .td-card__acts { display: grid !important; grid-template-columns: minmax(0, 1fr) auto; gap: 8px; width: 100%; margin: 0; }
+  body[data-ph-view="cards"] .ph-card .td-card__acts > :first-child { width: 100%; }
+  body[data-ph-view="cards"] .ph-card .td-card__acts > * { min-height: 48px; justify-content: center; }
+  body[data-ph-view="cards"] .ph-card.td-card--prep .td-card__acts { grid-template-columns: minmax(0, 1fr); }
+  /* An initiative or a Board item: a .pmc-card primitive, so its deck size lives in components.css (.pmc-card.ph-card). */
+  /* A copy that differs: the row's sentence and its one button. */
+  body[data-ph-view="cards"] .ph-card.rp-docs-row { padding: 6px 4px; }
+
+  /* ── the terminal takes the screen ────────────────────────────────────────────────────────────
+   * The PM's word: entering a terminal switches the whole screen to it, because it is mostly output. The tabs are not
+   * drawn there; the bar keeps Back and the session's name, and the control keys stay above the keyboard. */
+  .mobmenu[data-view="terminal"] .mobnav { display: none; }
+
 }
 
 /* `hidden` wins over every display above, in both directions of the breakpoint. Back is ABSENT at a
@@ -227,3 +362,4 @@
  * the thing this workspace refuses to ship. */
 .mob[hidden], .mobmenu[hidden], .mob-back[hidden], .mob-brand[hidden] { display: none !important; }
 .mob-repo[hidden], .mob-set[hidden], .mob-sync[hidden], .mob-theme[hidden], .mobnav-n[hidden] { display: none !important; }
+.mob-deck[hidden], .mob-pager[hidden], .mob-deck__views[hidden] { display: none !important; }

package/workspace/public/pm/mobile.js

@@ -1,9 +1,11 @@
 /* pm/mobile.js — the phone surface of the four-panel workspace (≤760px).
  *
- * Owns three things and nothing else: the top bar (back · Repository · the screen's name · the ⌘K
- * palette · Settings; the old shell shows theme in place of Repository and Settings), the five-tab
- * bottom nav (Today · Initiatives · Board · Reports · Agent, pm-os-absorb Run 3, slice 3A), and the
- * terminal control-key accessory bar that writes real PTY sequences. Its markup ships in
+ * Owns three things and nothing else: the top bar (back · Repository · the screen's name on a pushed
+ * screen · Sync while the repository is not in sync · search, which opens the ⌘K palette · Settings, a gear; the old
+ * shell shows theme in place of Repository and Settings), the six-tab bottom nav (Today · Initiatives · Board ·
+ * Reports · Docs · Agent, pm-os-absorb Run 3, slice 3A), and the terminal control-key accessory bar that writes real PTY
+ * sequences. At a tab's root it hands the screen to pm/phone-deck.js, which shows the tab's cards one at a time. On a
+ * terminal the tabs are not drawn: the session takes the screen, and Back returns. Its markup ships in
  * public/index.html; its styling in pm/mobile.css. In the frame, a tab is the frame's place (Agent is
  * the dock) and Settings is pushed over the current tab.
  *
@@ -39,6 +41,7 @@ import { state, setState, writeCount, FIXTURE } from './state.js';
 import { COPY as FC } from './frame-copy.js';
 import { ensureComponentsCss } from './primitives.js';
 import { ensureSprite, icon } from './icons.js';
+import { applyDeck, mountDeck } from './phone-deck.js';
 
 /* ── the breakpoint ─────────────────────────────────────────────────────────────────────────── */
 
@@ -318,6 +321,7 @@ export function applyMobile() {
   if (!on) {
     if (ctx) ctx.bodyGrid.removeAttribute('data-mpanel');
     if (ctrlArmed) setCtrlArmed(false);
+    applyDeck(false, null);
     return;
   }
 
@@ -333,10 +337,12 @@ export function applyMobile() {
   const act = (state.tabs || []).find((t) => t && t.id === state.active);
   if (menu) menu.dataset.view = s.kind === 'agent' ? (act && act.kind === 'term' ? 'terminal' : 'agent') : s.kind;
 
-  const title = $('mobTitle');
-  if (title) title.textContent = NAV.titleOf(s) || '';
-
   const deep = nav.stack.length > 0;
+
+  // In the frame, a tab's root is named once: by the bottom nav, which marks the current tab. The bar names a screen
+  // only when one is pushed over the tab (an initiative, a document, Settings), where Back takes the left of the bar.
+  const title = $('mobTitle');
+  if (title) title.textContent = (deep || !f) ? (NAV.titleOf(s) || '') : '';
   const back = $('mobBack');
   if (back) back.hidden = !deep;          // absent at a destination root, never present-and-inert
   const brand = $('mobBrand');
@@ -384,6 +390,9 @@ export function applyMobile() {
   for (const b of buttons) b.setAttribute('aria-current', b.dataset.dest === nav.dest ? 'page' : 'false');
 
   if (s.kind !== 'terminal' && s.kind !== 'agent' && ctrlArmed) setCtrlArmed(false);
+
+  // At a tab's root in the frame, the tab's cards are a deck, one card at a time (pm/phone-deck.js)
+  applyDeck(!!f, s);
 }
 
 /* ── the chrome's own controls ──────────────────────────────────────────────────────────────── */
@@ -524,6 +533,12 @@ export function mountMobile(context) {
   else if (MQ.addListener) MQ.addListener(onMQ);
 
   setCtrlArmed(false);
+
+  mountDeck({
+    rerender: () => setState({}),
+    apply: () => { if (isMobile() && nav) applyDeck(frameOn(), NAV.current(nav)); },
+    place: () => ctx.bodyGrid.querySelector('[data-fr="main"]'),
+  });
 }
 
 /* A small surface for the browser suite, mirroring window.pmApp. Read-only in spirit: everything

package/workspace/public/pm/panel-tabs.js

@@ -761,6 +761,9 @@ function paintBottom(act) {
     composeSend.disabled = !text.trim();
   }
   setChildren(bottomBar, compose ? [composeLine] : (act ? [bottomToggle, bottomTitle, bottomCopy] : [bottomToggle, bottomTitle]));
+  // A phone draws no scratchpad drawer: its pad is the compose line of a terminal. With no terminal in front the bar would
+  // offer a toggle that opens nothing, so on a phone it is shown for the compose line only.
+  bottomBar.hidden = isMobile() && !compose;
 }
 
 /* ── clipboard + scratchpad actions (lines 2098–2118) ───────────────────────────────────────── */

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

@@ -0,0 +1,243 @@
+/* pm/phone-deck.js — a phone tab shows its cards one at a time (initiative workspace-phone-one-job, the PM's card model).
+ *
+ * At a tab's root on a phone (≤760px), the list the tab's place already draws becomes a DECK: each card fills the screen,
+ * a swipe or the pager's arrows bring the next one, and the deck head says which card of how many is on screen. The PM's
+ * words: "I can't really focus on one thing at a time" with a list on every screen.
+ *
+ * ONE RENDERER. Nothing here draws a card. The destinations draw exactly what they draw on a desktop (pm/mobile.js, "ONE
+ * renderer, two shells"); this module marks the tab's own list as the deck's scroller and its own cards as the deck's
+ * cards, and pm/mobile.css lays them out side by side with scroll snapping. A card's buttons are the card's own buttons.
+ *
+ *   Today        the Today cards (dest-today.js); the first card prepares the day while the day is not prepared.
+ *                Second view: Day, the day section (today-day.js) with the goals, the calendar and the jobs.
+ *   Initiatives  the Roadmap's cards, Now then Next then Later. Second view: All, the List.
+ *   Board        the cards of the column on screen; the initiative picker and the column switch stay above them.
+ *   Docs         the copies that need you. Second view: All, every copy.
+ *   Reports and Agent have no deck: the report reads as a page, and Agent is the dock with its sessions.
+ *
+ * The view a tab shows (Cards or its second view) lives in memory for this page only, so a phone never changes what a
+ * desktop opens on. The card on screen is remembered by its key, so a destination that rebuilds its list (a poll, an
+ * act on the card) keeps the PM where they were, or on the card that took the place of the one they acted on.
+ */
+
+import { setDayForced } from './today-day.js';
+
+const DECKS = {
+  today: { views: [['cards', 'Cards'], ['day', 'Day']], scroller: '[data-today="needs"]', item: '[data-today-id]', key: 'data-today-id',
+    where: (i, n) => n ? `${i + 1} of ${n}` : 'Nothing needs you', second: 'Your day' },
+  initiatives: { views: [['cards', 'Cards'], ['all', 'All']], scroller: '[data-in-cols]', item: '[data-in-card], [data-in-unrecorded-card]', key: 'data-in-card',
+    where: (i, n, it) => n ? `${i + 1} of ${n}${it && it.getAttribute('data-horizon') ? ' · ' + label(it.getAttribute('data-horizon')) : ''}` : 'No initiatives', second: 'All initiatives' },
+  board: { scroller: '.bd-col--shown .bd-col__list', item: '[data-item]', key: 'data-item',
+    where: (i, n) => n ? `${i + 1} of ${n}` : 'No item here' },
+  docs: { views: [['cards', 'Cards'], ['all', 'All']], scroller: '.rp-docs-body', item: '.rp-docs-row', key: 'data-docs-doc',
+    where: (i, n) => n ? `${i + 1} of ${n} differ` : 'Every copy is the same', second: 'Every copy' },
+};
+const label = (h) => h.charAt(0).toUpperCase() + h.slice(1);
+
+const view = { today: 'cards', initiatives: 'cards', docs: 'cards' };
+const at = {};          // dest -> { key, i }: the card on screen, by its key and its place
+let live = null;        // { dest, scroller } the deck being shown
+let wasOn = false;
+let ctx = null;         // { rerender, place: () => the place panel }
+let observer = null;
+let queued = false;
+
+const $ = (id) => document.getElementById(id);
+
+/** The view a tab shows on a phone: 'cards' or its second view. Initiatives and Docs say it themselves (the List, or the
+ * All filter, however it was reached: the switch, ⌘K or the desktop's saved choice); Today's lives here. */
+export function phoneView(dest) {
+  if (dest === 'initiatives') {
+    const body = document.querySelector('[data-dest="initiatives"] [data-in-body]');
+    return body && body.getAttribute('data-in-body') === 'list' ? 'all' : 'cards';
+  }
+  if (dest === 'docs') {
+    const on = document.querySelector('[data-dest="docs"] [data-docs-filter] [aria-selected="true"]');
+    return on && on.getAttribute('data-tab') === 'all' ? 'all' : 'cards';
+  }
+  return view[dest] || 'cards';
+}
+
+/* Put the destination in the view the PM chose. Only in-memory state is touched: the desktop's saved choices (the
+ * Initiatives view in localStorage, the day's fold) are left as they are. */
+function setView(dest, v) {
+  if (phoneView(dest) === v) return;
+  view[dest] = v;
+  if (dest === 'today') setDayForced(v === 'day');
+  if (dest === 'initiatives') window.dispatchEvent(new CustomEvent('pmos:initiatives-view', { detail: v === 'all' ? 'list' : 'roadmap' }));
+  if (dest === 'docs') {
+    const tab = document.querySelector(`[data-dest="docs"] [data-docs-filter] [data-tab="${v === 'all' ? 'all' : 'needs'}"]`);
+    if (tab) tab.click();
+  }
+  if (ctx && ctx.rerender) ctx.rerender();
+  refresh();
+}
+
+function items(cfg, scroller) { return [...scroller.querySelectorAll(cfg.item)].filter((n) => !n.closest('[hidden]')); }
+function keyOf(cfg, n, k) { return (n && n.getAttribute(cfg.key)) || 'i:' + k; }
+function indexNow(scroller) { const w = scroller.clientWidth || 1; return Math.max(0, Math.round(scroller.scrollLeft / w)); }
+
+/* The head and the pager say where the PM is. Drawn from the scroller's own position, so a swipe and an arrow agree. */
+function paint(dest, cfg, scroller) {
+  const list = scroller ? items(cfg, scroller) : [];
+  const n = list.length;
+  const i = scroller ? Math.min(indexNow(scroller), Math.max(0, n - 1)) : 0;
+  const where = $('mobDeckWhere');
+  const deck = !!scroller;
+  if (where) where.textContent = deck ? cfg.where(i, n, list[i]) : (cfg.second || '');
+  const pager = $('mobPager');
+  if (pager) pager.hidden = !deck || n < 2;
+  const prev = $('mobPrev'); const next = $('mobNext'); const fill = $('mobPagerFill');
+  if (prev) prev.disabled = i <= 0;
+  if (next) next.disabled = i >= n - 1;
+  if (fill) fill.style.setProperty('--fr-deck-fill', n ? ((i + 1) / n * 100).toFixed(2) + '%' : '0');
+  list.forEach((node, k) => { const v = k === i ? 'true' : 'false'; if (node.getAttribute('data-ph-on') !== v) node.setAttribute('data-ph-on', v); });
+  if (n) at[dest] = { key: keyOf(cfg, list[i], i), i };
+}
+
+function views(dest, cfg) {
+  const box = $('mobDeckViews');
+  if (!box) return;
+  const want = (cfg.views || []).map(([id, l]) => id + ':' + l + ':' + (phoneView(dest) === id)).join('|');
+  if (box.dataset.sig === dest + want) return;
+  box.dataset.sig = dest + want;
+  box.replaceChildren(...(cfg.views || []).map(([id, l]) => {
+    const b = document.createElement('button');
+    b.type = 'button';
+    b.className = 'mob-deck__view';
+    b.textContent = l;
+    b.setAttribute('aria-pressed', phoneView(dest) === id ? 'true' : 'false');
+    b.dataset.view = id;
+    b.dataset.phViewTo = dest;
+    return b;
+  }));
+  box.hidden = !(cfg.views || []).length;
+}
+
+/* The height a card gets: the screen between the top of the deck and the pager, so a card fills it and its own text
+ * scrolls inside it when it is longer. */
+function fit(scroller) {
+  const top = scroller.getBoundingClientRect().top;
+  const menu = document.getElementById('mobMenu');
+  const bottom = menu ? menu.getBoundingClientRect().top : window.innerHeight;
+  const h = Math.max(220, Math.floor(bottom - top - 12));
+  if (scroller.style.getPropertyValue('--fr-deck-h') !== h + 'px') scroller.style.setProperty('--fr-deck-h', h + 'px');
+}
+
+function attach(dest, cfg, scroller) {
+  if (scroller.dataset.phDeck === dest) return false;
+  scroller.dataset.phDeck = dest;
+  let t = null;
+  scroller.addEventListener('scroll', () => {
+    if (t) cancelAnimationFrame(t);
+    t = requestAnimationFrame(() => { if (live && live.scroller === scroller) paint(dest, cfg, scroller); });
+  }, { passive: true });
+  return true;
+}
+
+/* Bring the remembered card back on screen after the list was drawn again. */
+function restore(dest, cfg, scroller) {
+  const list = items(cfg, scroller);
+  const was = at[dest];
+  // the first card stays first: a card that comes in at the front (the day's Prepare card, a new cause) is the one to see
+  let k = !was || was.i === 0 ? 0 : list.findIndex((n, j) => keyOf(cfg, n, j) === was.key);
+  if (k < 0) k = Math.min(was.i, Math.max(0, list.length - 1));
+  const left = k * scroller.clientWidth;
+  if (Math.abs(scroller.scrollLeft - left) > 2) scroller.scrollTo({ left, behavior: 'instant' });
+}
+
+function step(by) {
+  if (!live) return;
+  const { scroller } = live;
+  const w = scroller.clientWidth || 1;
+  scroller.scrollTo({ left: (indexNow(scroller) + by) * w, behavior: 'smooth' });
+}
+
+/* The deck's marks come off every node, so a primitive's deck size (components.css .pmc-card.ph-card) applies only
+ * while a deck is on screen. */
+function strip() {
+  for (const n of document.querySelectorAll('.ph-deck')) n.classList.remove('ph-deck');
+  for (const n of document.querySelectorAll('.ph-card')) { n.classList.remove('ph-card'); n.removeAttribute('data-ph-on'); }
+}
+
+function off() {
+  strip();
+  const shell = $('mobDeck'); if (shell) shell.hidden = true;
+  const pager = $('mobPager'); if (pager) pager.hidden = true;
+  delete document.body.dataset.phDeck;
+  delete document.body.dataset.phView;
+  live = null;
+}
+
+/**
+ * Draw the deck for the screen on show. `screen` is the reducer's current screen; `on` is false above the breakpoint.
+ * Called by pm/mobile.js at the end of every shell render, and again whenever the place's own list is drawn again.
+ */
+export function applyDeck(on, screen) {
+  // Above the breakpoint nothing here runs: the desktop's own fold applies, the marks come off once, and the place is
+  // not watched (a subtree observer on the desktop's place, terminals included, costs every render).
+  if (!on) { if (wasOn) { wasOn = false; setDayForced(null); off(); if (observer) { observer.disconnect(); observer = null; } } return; }
+  wasOn = true;
+  watch();
+  const dest = screen && screen.kind === 'dest' ? screen.id : null;
+  const cfg = dest ? DECKS[dest] : null;
+  if (!cfg) { off(); return; }
+  if (dest === 'today') setDayForced(view.today === 'day');
+  document.body.dataset.phDeck = dest;
+  document.body.dataset.phView = phoneView(dest);
+  const shell = $('mobDeck'); if (shell) shell.hidden = false;
+  views(dest, cfg);
+  const host = document.querySelector(`[data-fr-host="${dest}"]`);
+  const scroller = phoneView(dest) === 'cards' && host ? host.querySelector(cfg.scroller) : null;
+  if (!scroller) { strip(); live = null; paint(dest, cfg, null); return; }
+  scroller.classList.add('ph-deck');
+  for (const n of items(cfg, scroller)) n.classList.add('ph-card');
+  const fresh = attach(dest, cfg, scroller) || !live || live.scroller !== scroller;
+  live = { dest, scroller };
+  fit(scroller);
+  if (fresh || scroller.dataset.phCount !== String(items(cfg, scroller).length)) restore(dest, cfg, scroller);
+  scroller.dataset.phCount = String(items(cfg, scroller).length);
+  paint(dest, cfg, scroller);
+}
+
+/* A destination that draws on its own (the Roadmap's read, the Board's poll) changes the place without a shell render:
+ * draw the deck again on the next frame. Only child lists are watched, and the deck writes attributes, so it cannot
+ * wake itself. */
+function refresh() {
+  if (queued) return;
+  queued = true;
+  requestAnimationFrame(() => { queued = false; if (ctx && ctx.apply) ctx.apply(); });
+}
+
+/* The place's host is made by app.js; it is watched from the first deck on. */
+function watch() {
+  if (observer || !ctx || !ctx.place || !('MutationObserver' in window)) return;
+  const place = ctx.place();
+  if (!place) return;
+  observer = new MutationObserver(() => { if (document.body.dataset.phDeck) refresh(); });
+  observer.observe(place, { childList: true, subtree: true });
+}
+
+/** Wire the pager once, at boot. `context` is { rerender, apply, place }: apply() re-runs applyDeck with the current screen. */
+export function mountDeck(context) {
+  ctx = context || null;
+  const prev = $('mobPrev'); const next = $('mobNext');
+  // one listener for the deck's own buttons (the view switch, the pager), read from their data attributes
+  document.addEventListener('click', (e) => {
+    const t = e.target instanceof Element ? e.target.closest('#mobDeckViews [data-ph-view-to], #mobPrev, #mobNext') : null;
+    if (!t || t.disabled) return;
+    if (t.id === 'mobPrev') step(-1);
+    else if (t.id === 'mobNext') step(1);
+    else setView(t.dataset.phViewTo, t.dataset.view);
+  });
+  window.addEventListener('resize', () => { if (live) { fit(live.scroller); restore(live.dest, DECKS[live.dest], live.scroller); } });
+  document.addEventListener('keydown', (e) => {
+    if (!live || e.altKey || e.metaKey || e.ctrlKey) return;
+    const t = e.target;
+    if (t && t.closest && t.closest('input, textarea, select, [contenteditable="true"], .xterm')) return;
+    if (e.key === 'ArrowRight') { e.preventDefault(); step(1); } else if (e.key === 'ArrowLeft') { e.preventDefault(); step(-1); }
+  });
+}
+
+/* For the browser suites: where the deck is, and the view switch. */
+window.pmDeck = { phoneView, setView, live: () => (live ? { dest: live.dest, index: indexNow(live.scroller), count: items(DECKS[live.dest], live.scroller).length } : null) };

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

@@ -18,6 +18,14 @@ export const COPY = {
   /** The empty state of R12. `next` is the label of the next scheduled draft, or null when none is known. */
   empty: (next) => (next ? `Nothing needs you. Next: ${next}.` : 'Nothing needs you.'),
   reading: 'Reading what needs you.',
+  /** The first card on a phone while the day is not prepared (pm/phone-deck.js). */
+  prep: {
+    cause: 'Prepare your day',
+    evidence: 'The agent reads your calendar and your Slack, Jira and Confluence mentions, ties each one to a goal and does the jobs it can. You approve only what sends or decides.',
+    go: 'Prepare my day',
+    busy: 'Starting…',
+    see: 'See the day',
+  },
   more: (n) => `Show ${n} more`,
   fewer: 'Show fewer',
   /** The state-health notice: sources that could not be read are said here, never shown as an empty list. */

package/workspace/public/pm/today-day.js

@@ -42,7 +42,8 @@ const store = {
   get(k) { try { return localStorage.getItem(k); } catch { return null; } },
   set(k, v) { try { localStorage.setItem(k, v); } catch { /* private window: the default applies */ } },
 };
-const OPEN_KEY = 'pmos.today.day.open';
+// A new key: a fold stored by the old Today page must not hide the Agenda month.
+const OPEN_KEY = 'pmos.agenda.day.open';
 const SEEN_KEY = 'pmos.today.day.seen';
 let seen = new Set();
 try { seen = new Set(JSON.parse(store.get(SEEN_KEY) || '[]')); } catch { seen = new Set(); }
@@ -805,6 +806,21 @@ function detail(ctx) {
 
 /* ── the section ──────────────────────────────────────────────────────────────────────────────────────────────── */
 
+/* The phone's view of Today (pm/phone-deck.js): Day opens the section and Cards folds it, without touching the fold the
+ * PM chose on a desktop. null is no phone override. */
+let forced = null;
+export function setDayForced(open) { forced = open === null || open === undefined ? null : !!open; }
+
+/** Is today's day prepared, and is a press in flight? For the phone's first card on Today. */
+export function dayState(ws) {
+  const c = cache.get(ws) || {};
+  const m = model(c.data, { here: null, all: false });
+  const press = runs.get(ws);
+  return { known: !!c.data, prepared: !!m.run, busy: !!press && press.state === 'busy' };
+}
+/** Press "Prepare my day" for `ws`, the same press as the day section's own button. */
+export function pressPrepare(ws) { return prepareDay(ws); }
+
 function fold(open) {
   ui.open = open;
   store.set(OPEN_KEY, open ? 'true' : 'false');
@@ -821,7 +837,7 @@ export function daySection({ ws, setState, openIni, owed, here, all } = {}) {
   ensure(ws);
   const c = cache.get(ws) || {};
   const m = model(c.data, { here: here || null, all: !!all });
-  const open = ui.open !== null ? ui.open : !!m.run;
+  const open = forced !== null ? forced : ui.open !== null ? ui.open : true;
   if (!open) {
     return el('section', { class: 'td-day', 'data-today': 'day', 'data-open': 'false', 'aria-label': D.title },
       button({ label: D.toggle(m.needs), variant: 'ghost', iconEnd: 'chevron-right', attrs: { 'data-day': 'toggle', 'aria-expanded': 'false' }, onClick: () => fold(true) }));
@@ -848,12 +864,12 @@ export function daySection({ ws, setState, openIni, owed, here, all } = {}) {
     c.error ? el('p', { class: 'td-day__run td-day__run--failed', role: 'status', 'data-day': 'error' }, D.refused(c.error)) : null,
     m.d && m.d.legacy ? note(D.oldServer) : null,
     el('div', { class: 'td-day__cols' },
-      el('div', { class: 'td-day__left' }, summaryPanel(ctx), goalsPanel(ctx), agenda(ctx), jobsPanel(ctx), mentionsPanel(ctx), waitingPanel(owed)),
+      el('div', { class: 'td-day__left' }, agenda(ctx), summaryPanel(ctx), goalsPanel(ctx), jobsPanel(ctx), mentionsPanel(ctx), waitingPanel(owed)),
       detail(ctx)));
 }
 
 export function daySig(ws) {
   const c = cache.get(ws) || {};
-  return JSON.stringify([ui.open, ui.sel, ui.mtab, ui.openSrc, ui.showIgn, ui.showIgnDigests, [...ui.revising], [...ui.busy], c.error, runs.get(ws) || null, [...seen].length])
+  return JSON.stringify([forced, ui.open, ui.sel, ui.mtab, ui.openSrc, ui.showIgn, ui.showIgnDigests, [...ui.revising], [...ui.busy], c.error, runs.get(ws) || null, [...seen].length])
     + dataSig(c.data) + goalsSig() + agendaSig();
 }