create-pmos 0.146.0 → 0.147.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.146.0",
+  "version": "0.147.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@ec68387
+kernel-source: pmos@1f1a8b3
 assembled: 2026-10-12
 mode: vendor

package/payload/planning/evals/eval-calibration.md

@@ -2,7 +2,7 @@
 type: Reference
 title: "Eval calibration log"
 description: "Append-only record of every PM override of an evaluator verdict."
-generated: {by: process:create-pmos, at: "2026-10-12T02:35:41Z"}
+generated: {by: process:create-pmos, at: "2026-10-12T02:42:43Z"}
 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-12T02:35:41Z"}
+generated: {by: process:create-pmos, at: "2026-10-12T02:42:43Z"}
 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-12T02:35:41Z"}
+generated: {by: process:create-pmos, at: "2026-10-12T02:42:43Z"}
 status: stable
 ---
 

package/workspace/c3-sessions-panel-test.js

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+'use strict';
+/* c3-sessions-panel-test.js — the console3 Sessions panel (Agent surfaces): ending a session and opening one (initiative sessions-panel-end-and-open).
+ *
+ * Starts a real server with its own state directory. Before it starts, a session record is written whose process does not exist and
+ * whose file still says it runs: the server restores it as exited, and GET /api/runs must say it ended (it read "starting · 4 d" before).
+ * Then one live shell is started, and the page checks: the live row reads the server's state, not "starting"; Open the session draws the
+ * session's real terminal in a sheet on /c3.html and the address does not change; End asks first, Keep it keeps it, End ends it.
+ */
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+const { WebSocket } = require('ws');
+const { findBrowser } = require('./lib/find-browser');
+const T = require('./test-run').configure({ name: 'c3-sessions-panel' });
+
+const BASE = T.BASE;
+const results = [];
+const ok = (name, cond, extra = '') => { results.push({ name, cond: !!cond }); console.log(`${cond ? '✓' : '✗'} ${name}${!cond && extra !== '' ? ' — ' + extra : ''}`); };
+let srv = null; let browser = null;
+const finish = async (code) => {
+  if (browser) await browser.close().catch(() => {});
+  if (srv) { try { srv.kill('SIGKILL'); } catch { /* gone */ } }
+  T.killTmux();
+  const bad = results.filter((x) => !x.cond).length;
+  console.log(`\n${results.length - bad}/${results.length} c3-sessions-panel assertions passed`);
+  process.exit(code !== undefined ? code : (bad ? 1 : 0));
+};
+process.on('unhandledRejection', (e) => { console.error(e); finish(1); });
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+async function until(fn, ms = 8000) { const end = Date.now() + ms; while (Date.now() < end) { const v = await fn(); if (v) return v; await sleep(150); } return null; }
+async function waitFor(page, fn, arg, ms = 15000) { try { await page.waitForFunction(fn, arg, { timeout: ms }); return true; } catch { return false; } }
+const get = (p) => fetch(BASE + p).then((r) => r.json());
+
+function startShell(name) {
+  return new Promise((resolve) => {
+    const ws = new WebSocket(`ws://${T.HOST}:${T.PORT}`); const inbox = [];
+    ws.on('message', (raw) => { try { inbox.push(JSON.parse(raw)); } catch { /* ignore */ } });
+    ws.on('error', () => resolve(null));
+    ws.on('open', async () => {
+      ws.send(JSON.stringify({ t: 'new', agent: 'shell', name }));
+      const m = await until(() => inbox.find((x) => x.t === 'created' || x.t === 'error'), 8000);
+      ws.close(); resolve(m && m.t === 'created' ? m.id : null);
+    });
+  });
+}
+
+(async () => {
+  const exe = findBrowser();
+  if (!exe) { console.log('✗ no Chrome/Chromium on this machine — the c3-sessions-panel suite cannot run'); return finish(1); }
+  let chromium;
+  try { ({ chromium } = require('playwright-core')); } catch { console.log('✗ playwright-core is not installed — the c3-sessions-panel suite cannot run'); return finish(1); }
+
+  /* a record left by a server that stopped: the file says it runs, its process is gone (no tmux session by that name) */
+  const sessDir = path.join(T.STATE_DIR, 'sessions');
+  fs.mkdirSync(sessDir, { recursive: true });
+  const created = new Date(Date.now() - 4 * 864e5).toISOString();
+  fs.writeFileSync(path.join(sessDir, 'sess-900.json'), JSON.stringify({ id: 'sess-900', name: 'stale claude', agent: 'shell', state: 'working', created, tmux: 'pmos-gone-900', origin: 'manual', cwd: path.resolve(__dirname, '..'), root: path.resolve(__dirname, '..') }));
+  fs.writeFileSync(path.join(sessDir, 'sess-900.scrollback'), '');
+
+  srv = spawn(process.execPath, [path.join(__dirname, 'server.js')], { cwd: __dirname, stdio: 'ignore', env: T.env({ PMOS_WS_PORT: String(T.PORT) }) });
+  await T.waitForServer(BASE);
+
+  /* ── A: /api/runs believes the server, not a stale file ── */
+  const r0 = await get('/api/runs');
+  const inGroup = (r, g, id) => ((r.groups && r.groups[g]) || []).some((s) => s.id === id);
+  ok('A1 a session whose process is gone is not listed as started by me', r0.ok && !inGroup(r0, 'startedByMe', 'sess-900'), JSON.stringify(r0.groups && r0.groups.startedByMe));
+  ok('A2 it is listed in Past', inGroup(r0, 'past', 'sess-900'));
+
+  const id = await startShell('panel shell');
+  ok('A3 a live shell starts', !!id);
+  const r1 = await until(async () => { const r = await get('/api/runs'); return inGroup(r, 'startedByMe', id) ? r : null; });
+  const row = r1 && r1.groups.startedByMe.find((s) => s.id === id);
+  ok('A4 the live shell is started by me and carries the server state', !!row && typeof row.label === 'string' && row.label.length > 0, JSON.stringify(row));
+
+  browser = await chromium.launch({ executablePath: exe });
+  const page = await (await browser.newContext({ viewport: { width: 1440, height: 1000 } })).newPage();
+  const errors = [];
+  page.on('pageerror', (e) => errors.push(String(e && e.message || e)));
+
+  /* ── B: the panel ── */
+  await page.goto(BASE + '/c3.html');
+  ok('B1 the header has the Sessions button', await waitFor(page, () => !!document.querySelector('[data-c3pg="agent-button"]'), null, 45000));
+  await page.click('[data-c3pg="agent-button"]');
+  const sel = `[data-c3t="mine"] [data-run="${id}"]`;
+  ok('B2 the live shell has a row under Started by me', await waitFor(page, (s) => !!document.querySelector(s), sel));
+  const sub = await page.evaluate((s) => (document.querySelector(s + ' .chips') || {}).textContent || '', sel);
+  ok('B3 the row does not say starting', !!sub && !/^starting/.test(sub.trim()), sub);
+  await page.click(sel + ' .nb');
+  ok('B3b a plain session draws no empty "Starting" card', await page.evaluate((s) => !document.querySelector(s + ' [data-run-host]'), sel));
+  ok('B4 the open row has End the session', await waitFor(page, (i) => !!document.querySelector(`[data-end-session="${i}"]`), id));
+
+  /* ── C: Open the session stays on this page ── */
+  const url0 = page.url();
+  await page.click(`[data-blank-panel="${id}"] [data-open-session]`);
+  ok('C1 the session opens in a terminal sheet', await waitFor(page, (i) => !!document.querySelector(`[data-c3-session-term="${i}"] .xterm`), id));
+  ok('C2 the page stays on console3', page.url() === url0, page.url());
+  await sleep(800);
+  await page.click(`[data-c3-session-term="${id}"] .xterm`);
+  await page.keyboard.type('echo c3-typed-$((40+2))\n');
+  ok('C2b what is typed in the sheet reaches the shell', !!(await until(async () => /c3-typed-42/.test((await get('/api/sessions/transcript?id=' + id + '&max=4000')).text || ''), 8000)));
+  await page.keyboard.press('Escape');
+  await sleep(300);
+  ok('C3 Esc in the terminal goes to the shell, not the sheet', await page.evaluate((i) => !!document.querySelector(`[data-c3-session-term="${i}"]`), id));
+  await page.click('[data-shell="sheet"] [aria-label="Close"]');
+  ok('C4 the close button closes the terminal sheet', await waitFor(page, () => !document.querySelector('[data-c3-session-term]')));
+  ok('C5 closing the sheet leaves the session running', await until(async () => ((await get('/api/sessions')).sessions || []).some((s) => s.id === id && s.state !== 'exited')));
+
+  /* ── D: End asks first, then ends ── */
+  await page.click('[data-c3pg="agent-button"]');
+  ok('D0 the panel opens again', await waitFor(page, (s) => !!document.querySelector(s), sel));
+  if (!(await page.isVisible(`[data-end-session="${id}"]`).catch(() => false))) await page.click(sel + ' .nb');
+  await page.click(`[data-end-session="${id}"]`);
+  ok('D1 End asks first', await waitFor(page, (i) => !!document.querySelector(`[data-end-confirm="${i}"]`), id));
+  await page.click(`[data-end-confirm="${id}"] button:not([data-end-yes])`);
+  ok('D2 Keep it keeps the session', await waitFor(page, (i) => !document.querySelector(`[data-end-confirm="${i}"]`), id) && ((await get('/api/sessions')).sessions || []).some((s) => s.id === id));
+  await page.click(`[data-end-session="${id}"]`);
+  await page.click(`[data-end-yes="${id}"]`);
+  const gone = async () => !((await get('/api/sessions')).sessions || []).some((s) => s.id === id);
+  if (!(await until(gone, 6000)) && await page.$(`[data-end-session="${id}"]`)) { await page.click(`[data-end-session="${id}"]`); await page.click(`[data-end-yes="${id}"]`); }   // "asked it to end": the second press removes it
+  ok('D3 End ends the session', !!(await until(gone, 8000)));
+  ok('D4 its row leaves Started by me', await waitFor(page, (s) => !document.querySelector(s), sel));
+
+  ok('E1 the page threw no error', errors.length === 0, errors.join(' | '));
+  return finish();
+})().catch((e) => { console.error(e); finish(1); });

package/workspace/guide/console-calendar.md

@@ -1,7 +1,7 @@
 ---
 type: Guide
 title: "Guide: the Calendar tab of the console page"
-description: "The Calendar tab of the console page (/c3.html): Calendar and Notes, the five zooms, the layer chips, the markers, the context of a meeting, free time, the tidy-up suggestions and the empty states."
+description: "The Calendar tab of the console page (/c3.html): Calendar and Notes, the five zooms, the highlights, the layer chips, the markers, the context of a meeting, free time, the tidy-up suggestions and the empty states."
 timestamp: 2026-10-12
 ---
 
@@ -47,12 +47,27 @@ The chips under the zoom bar are the layers. Each chip shows the number of items
 
 All layers and Free time are on at the start. Tidy-up is off.
 
+On Month, Quarter and Year there is one more chip, **Routine**. It shows the number of routine items in the range: report drafts, reports that go out daily or weekly, recurring meetings, stand-ups, 1:1s and due items on track. These items are counted, not listed. Press **Routine** to show every item as a marker, and press it again to go back to the highlights.
+
+## Highlights
+
+Every zoom starts with a short summary above the grid, for example "October highlights". It names what matters in the range:
+
+- the releases, and the milestones that are on track
+- the key meetings, on Day, Week and Month only. A meeting is key when it is not routine. Month names the two biggest.
+- the reports that go out
+- **Watch:** the milestones and releases that are late or at risk, and the due items that are late
+
+Press a name to open the item in the detail column. When nothing significant falls in the range, the summary says so.
+
 ## The grid
 
 - **Day** shows the timeline of the day. The markers of the day are in a strip above it.
 - **Week** shows a timeline for each day. Each day name has the hours of meetings of that day and a small bar. The bar has three parts: time tied to a promise or a decision, routine time, and the rest of a 6 hour day. The markers of each day are in a strip under the day name. Press a day name to open that day.
-- **Month** shows a cell for each day. A cell shows the number of meetings and up to three markers. "+2" is a button. It opens the day with the other markers. Press the day number to open the day.
-- **Quarter** shows a row for each week. **Year** shows a card for each month. Each shows the number of meetings and dated items, and the most important markers. A "+N" button opens the week or the month that holds the rest.
+- **Month** shows a cell for each day. A cell shows the highlight of the day in one sentence, for example "SSO general release ships." Under it, a quiet line counts the rest, for example "1 due · 2 routine". Press that line or the day number to open the day. A line under the grid says what is counted and not named. With **Routine** on, a cell shows the number of meetings and up to three markers instead, and "+2" opens the day with the other markers.
+- **Quarter** shows a column for each month. **Year** shows a column for each quarter, with a button for each of its three months. Each column shows its highlight and a quiet line, for example "24 meetings · 3 due · 9 routine". Quarter and Year are stricter than Month: they name only milestones, releases, reports that go out and late items. Press a column's title to open that month or quarter. With **Routine** on, a column shows its markers instead.
+
+Titles wrap onto more lines. They are never cut.
 
 A marker has a symbol and a short title. A red edge means late or at risk of missing. An amber edge means at risk.
 

package/workspace/guide/console3-sessions.md

@@ -0,0 +1,35 @@
+---
+type: Guide
+title: "Sessions in console3: open, read and end your sessions"
+description: "How the Sessions panel in console3 groups your sessions, how to open a session's terminal without leaving console3, and how to end a session."
+timestamp: 2026-10-12
+---
+
+# Sessions in console3: open, read and end your sessions
+
+Press **Sessions** in the console3 header to open the panel. It shows your sessions in four groups: **On a card**, **Started by me**, **Past (7 days)** and **Automatic**.
+
+## Read a row
+
+Each row under **Started by me** shows the state of the session, how long ago it started, and its tree. The state comes from the workspace server, for example `working` or `quiet`.
+
+If the server finds that the process of a session stopped (for example, after a restart), the session moves to **Past**.
+
+## Open a session
+
+1. Press the row to open it.
+2. Press **Open the session**.
+
+The terminal of the session opens in a panel on the same page. You can type in it. When the terminal has focus, Esc and Tab go to the terminal. To close the panel, press its close button. The session continues to run.
+
+The **Open the session** link in the sessions dock opens the same panel.
+
+## End a session
+
+1. Press the row to open it.
+2. Press **End the session**.
+3. Press **End** to confirm, or press **Keep it** to cancel.
+
+When you end a session, its process stops and the session is removed. Any pending change stays a proposal. If the process does not stop immediately, press **End** again to remove it.
+
+A session that is on a card has the same **End the session** control below its card.

package/workspace/guide/index.md

@@ -69,4 +69,5 @@ On a desktop the workspace is one frame. [Layout](layout.md) explains each part.
 - [Integrated work](integrated-work.md): how `pmos verify-work` turns a merged commit into Done, and what "Done · your call · not merged" means.
 - [Report slides](report-slides.md): how the Reports page shows a report as the PM-OS biweekly slides, Present and Print / PDF, and how your notes become the words on the slides.
 - [Reports: dashboards of reports](reports-dashboards.md): the console Reports page, its dashboards at portfolio, board and initiative scope, how to edit and share one as a draft, and the Drafts tab.
+- [Sessions in console3](console3-sessions.md): the Sessions panel, how to open the terminal of a session on the same page, and how to end a session.
 - [Settings in console3](settings.md): how to open Settings, what each section holds, the scope tags, the environment notes, and where the settings are kept.

package/workspace/lib/calendar-layers.js

@@ -36,6 +36,9 @@ const SUGGEST_DAYS = 7;
 const WINDOW_MS = 48 * 3600000;
 const PER_KIND = { decision: 6, action: 6, moved: 8, prepared: 8, todo: 8 };
 const LIGHT_VIEWS = ['quarter', 'year'];
+/* a report cadence that recurs more often than monthly is routine: the Calendar counts it instead of naming it (calendar-highlights) */
+const ROUTINE_CADENCE = /\b(daily|weekly|bi-?weekly|fortnightly|stand-?up)\b/i;
+const routineCadence = (c) => ROUTINE_CADENCE.test(String(c || ''));
 
 const pad = (n) => String(n).padStart(2, '0');
 const isDay = (s) => typeof s === 'string' && /^\d{4}-\d{2}-\d{2}/.test(s) && !Number.isNaN(Date.parse(s.slice(0, 10) + 'T00:00:00Z'));
@@ -130,7 +133,7 @@ function layersFrom(dated, range, today) {
       const date = r.issued && isDay(r.issued.at) ? day10(r.issued.at) : day10(r.slot);
       n++;
       put('reports', { id: `report:${r.cadence}:${day10(r.slot)}`, date, kind: 'report', layer: 'reports', title: `${r.cadence} report${r.issued ? '' : ' (not issued)'}`,
-        tone: r.issued ? 'ok' : null, ref: { type: 'report', id: `${r.cadence}/${day10(r.slot)}` } });
+        tone: r.issued ? 'ok' : null, cadence: r.cadence, routine: routineCadence(r.cadence), ref: { type: 'report', id: `${r.cadence}/${day10(r.slot)}` } });
     }
     for (const s of d.reportSchedules || []) {
       if (!s || !s.id) continue;
@@ -138,7 +141,7 @@ function layersFrom(dated, range, today) {
         if (!isDay(dt)) continue;
         n++;
         put('reports', { id: `report-sched:${s.id}:${day10(dt)}`, date: day10(dt), kind: 'report', layer: 'reports', title: `${str(s.name) || s.cadence || s.id} (scheduled)`, tone: null,
-          ref: { type: 'report', id: s.cadence || s.id } });
+          ...(s.cadence ? { cadence: s.cadence } : {}), routine: routineCadence(s.cadence) || routineCadence(s.name), ref: { type: 'report', id: s.cadence || s.id } });
       }
     }
     if (!n) why('reports', 'no report file and no report schedule gives an issue date');

package/workspace/lib/routes-runs.js

@@ -23,7 +23,10 @@ const { appendOutbox } = require(repoScript('outbox.js'));
 const prefixes = ['/api/runs'];
 const RUN_RE = /^sess-\d+$/;
 
-function sessionsOf(sessDir) {
+// `live` (optional): the server's own session list (ctx.sessionList()), by id. The meta file on disk is not rewritten when a
+// restart finds a session's process gone, so a file can still say it runs days later. When the list is given it decides:
+// a session it calls exited, or does not hold at all, has ended. Its presented state and label ride along for the panel.
+function sessionsOf(sessDir, live) {
   let names = [];
   try { names = fs.readdirSync(sessDir).filter((n) => /^sess-\d+\.json$/.test(n)); } catch { return []; }
   const out = [];
@@ -31,9 +34,12 @@ function sessionsOf(sessDir) {
     let meta; let st;
     try { const f = path.join(sessDir, n); meta = JSON.parse(fs.readFileSync(f, 'utf8')); st = fs.statSync(f); } catch { continue; }
     if (!meta || !meta.id) continue;
-    const exited = meta.state === 'exited';
+    const row = live ? live.get(meta.id) : null;
+    const exited = meta.state === 'exited' || (live ? !row || row.state === 'exited' : false);
+    const exitedAt = Date.parse(meta.exitedAt);
     out.push({ id: meta.id, plan_item: meta.plan_item || null, name: meta.name || meta.id, origin: meta.origin || 'manual', cardId: meta.plan_item || null,
-      startedAt: meta.created || null, endedAt: exited ? st.mtimeMs : null });
+      startedAt: meta.created || null, endedAt: exited ? (Number.isFinite(exitedAt) ? exitedAt : st.mtimeMs) : null,
+      shown: row ? row.shown || null : null, label: row ? row.label || null : null });
   }
   return out;
 }
@@ -61,7 +67,9 @@ function lastAtOf(lines) {
 }
 
 function view(ctx, now = Date.now()) {
-  const sessions = sessionsOf(ctx.sessDir || path.join(ctx.runtimeDir, 'sessions'));
+  let live = null;
+  if (typeof ctx.sessionList === 'function') { try { live = new Map(ctx.sessionList().map((r) => [r.id, r])); } catch { live = null; } }
+  const sessions = sessionsOf(ctx.sessDir || path.join(ctx.runtimeDir, 'sessions'), live);
   const answers = runAnswers.readAnswers(runAnswers.answersFile(ctx.runtimeDir));
   const groups = groupSessions(sessions, now);
   const cards = {};

package/workspace/package-lock.json

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

package/workspace/package.json

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

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

@@ -63,7 +63,7 @@ const setVar = (node, name, value) => { node.style.setProperty('--cal3-' + name,
 /* ── the page's own state on the instance: which layers are on, whether free time shows, what is selected ─────────── */
 
 function state(r) {
-  const st = r.page || (r.page = { on: new Set(LAYERS.map((l) => l[0]).filter((id) => !(r.ctx && r.ctx.overlay && mem.hide.includes(id)))), free: true, tidy: false, sel: null });
+  const st = r.page || (r.page = { on: new Set(LAYERS.map((l) => l[0]).filter((id) => !(r.ctx && r.ctx.overlay && mem.hide.includes(id)))), free: true, tidy: false, routine: false, sel: null });
   if (r.sel) { st.sel = { type: 'event', id: r.sel }; r.sel = null; }   // a meeting chosen on the Briefing (openDay)
   if (r.pendingMode) { st.mode = r.pendingMode; r.pendingMode = null; }   // a note opened before the page drew (the Record chip)
   if (!st.mode) st.mode = 'cal';
@@ -146,7 +146,7 @@ export function drawCalendarPage(host, r, h) {
 
   const body = el('div', { class: 'calbody' + (r.anim && !r.loading ? ' ' + r.anim : '') },
     el('div', { class: 'cal3-wrap' },
-      el('div', { class: 'cal3-main' }, empty, grid),
+      el('div', { class: 'cal3-main' }, empty, empty ? null : highlights(ui, range), grid),
       el('div', { class: 'cal3-side' }, detail(ui), st.tidy ? tidyList(ui) : null, st.free ? freeList(ui, range) : null, lanes(ui, range))));
   return pageBar(chips(ui, range), body);
 }
@@ -186,7 +186,8 @@ function chips(ui, range) {
     }, el('i', { class: 'cal3-sw cal3-sw-' + id }))),
     el('span', { class: 'cal3-sep', 'aria-hidden': 'true' }),
     chip('free', 'Free time', freeN, st.free, () => { st.free = !st.free; }, c3ic('clock', 'sm')),
-    chip('tidy', 'Tidy-up', tidyCount(M, ui.d), st.tidy, () => { st.tidy = !st.tidy; }, c3ic('spark', 'sm')));
+    chip('tidy', 'Tidy-up', tidyCount(M, ui.d), st.tidy, () => { st.tidy = !st.tidy; }, c3ic('spark', 'sm')),
+    WIDE.includes(M.view) ? chip('routine', 'Routine', routineCount(ui, range), st.routine, () => { st.routine = !st.routine; }, c3ic('report', 'sm')) : null);
 }
 /* the number of suggestions in the range: the server's total (the list may be capped), or null when it sent none */
 const tidyCount = (M, d) => (M.tidy ? Math.max(0, (typeof d.tidy_total === 'number' ? d.tidy_total : M.tidy.length) - (d.tidy.length - M.tidy.length)) : null);   // less the ones the PM dismissed
@@ -332,7 +333,123 @@ function freeBlock(ui, date, b, Y) {
   return n;
 }
 
-/* ── Month: a cell per day with the meeting count, up to three markers and +N, and the free count ───────────────── */
+/* ── significance (initiative calendar-highlights) ───────────────────────────────────────────────────────────────
+ * Month, Quarter and Year show what matters and fold the rest into a count. Routine: a report date that recurs more often
+ * than monthly (the server's `routine` flag, or a daily, weekly or bi-weekly cadence), a meeting that repeats in the range,
+ * a stand-up or a 1:1, and a meeting tied to nothing. A due item that is on track is counted, not named. Key at Day, Week and
+ * Month: milestones, releases, reports that go out, late or at-risk due items, and meetings tied to a promise or a decision.
+ * Quarter and Year are one step stricter: milestones, releases, reports that go out, and late items; meetings are counted.
+ * The Routine chip (Month, Quarter, Year) brings back every item as markers. */
+const WIDE = ['month', 'quarter', 'year'];
+const FREQUENT = /\b(daily|weekly|bi-?weekly|fortnightly|stand-?up)\b/i;
+const normT = (t) => String(t || '').toLowerCase().replace(/[^\p{L}\p{N}]+/gu, ' ').trim();
+const isDue = (m) => m.kind === 'due' || m.kind === 'own';
+const routineMark = (m) => m.kind === 'report' && (m.routine === true || (m.routine !== false && (FREQUENT.test(String(m.cadence || '')) || FREQUENT.test(String(m.title || '')) || /\bdraft\b/i.test(String(m.title || '')))));
+const quietDue = (m) => isDue(m) && m.tone !== 'bad' && m.tone !== 'warn';
+const keyMark = (m) => !routineMark(m) && !quietDue(m);
+const landMark = (m) => m.kind === 'milestone' || m.kind === 'release' || (m.kind === 'report' && !routineMark(m)) || (isDue(m) && m.tone === 'bad');
+const shortDay = (h, date) => h.dayLabel(date).replace(/^\S+ /, '');
+
+/* the meetings of the range, each marked key or routine; a title seen more than once in the range is a recurring meeting */
+function meetingsKeyed(ui) {
+  const { M } = ui;
+  if (!M._keyed) {
+    const seen = new Map(); for (const m of M.meetings) { const k = normT(m.e.title); seen.set(k, (seen.get(k) || 0) + 1); }
+    const now = nowIso();
+    M._keyed = M.meetings.map((m) => {
+      const t = m.e.title || '';
+      const routine = m.e.routine === true || seen.get(normT(t)) > 1 || /stand-?up|\b1\s*[:/-]\s*1\b|one[- ]on[- ]one/i.test(t) || !evState(ui, m, now).tied;
+      return { ...m, key: m.e.key === true || !routine };
+    });
+  }
+  return M._keyed;
+}
+const meetingsIn = (ui, a, b) => (ui.st.on.has('meetings') ? meetingsKeyed(ui).filter((m) => m.date >= a && m.date <= b) : []);
+
+/* the number of folded items in the range, for the Routine chip */
+function routineCount(ui, range) {
+  const wide = ui.M.view !== 'month';
+  const marks = marksIn(ui.M, ui.st, range.start, range.end).filter((m) => (wide ? !landMark(m) : !keyMark(m))).length;
+  return marks + meetingsIn(ui, range.start, range.end).filter((m) => wide || !m.key).length;
+}
+
+/* a name inside a highlight: a link-styled button that selects the item, so its detail opens beside the grid */
+function nameBtn(ui, sel, label, attrs) {
+  return button({ label, variant: 'ghost', attrs: { class: 'cal3-sl', ...attrs }, onClick: () => ui.select(sel, null) });
+}
+const markName = (ui, m, label) => nameBtn(ui, { type: 'marker', id: m.id }, label || m.title, { 'data-cal3-mk': m.id, 'data-cal3-layer': m.layer, 'data-cal3-kind': m.kind, title: kindOf(m)[0] + ': ' + m.title + ', ' + ui.h.dayLabel(m.date) });
+const meetName = (ui, m) => nameBtn(ui, { type: 'event', id: m.e.id }, m.e.title || m.e.id, { 'data-cal3-hl-ev': m.e.id, title: (m.e.title || m.e.id) + ', ' + ui.h.dayLabel(m.date) });
+
+/* join nodes as "a, b and c", with "N more" for what is past max */
+function joinList(nodes, max) {
+  const a = nodes.slice(0, max); if (nodes.length > max) a.push(String(nodes.length - max) + ' more');
+  const out = [];
+  a.forEach((n, i) => { if (i) out.push(i === a.length - 1 ? ' and ' : ', '); out.push(n); });
+  return out;
+}
+
+/* the highlight of a span as a list of text and name nodes; [] when nothing in it is significant.
+ * mode 'cell' is the short form of a Month day; 'top' is the range summary and a Quarter or Year column. */
+function highlightOf(ui, a, b, mode) {
+  const { h, M } = ui; const cell = mode === 'cell'; const wide = M.view === 'quarter' || M.view === 'year';
+  const marks = marksIn(M, ui.st, a, b); const meets = wide ? [] : meetingsIn(ui, a, b).filter((m) => m.key);
+  const on = (date) => (cell ? '' : ' on ' + shortDay(h, date));
+  const rel = marks.filter((m) => m.kind === 'release'); const ms = marks.filter((m) => m.kind === 'milestone' && (!m.tone || m.tone === 'ok'));
+  const rep = marks.filter((m) => m.kind === 'report' && !routineMark(m));
+  const lateMs = marks.filter((m) => m.kind === 'milestone' && (m.tone === 'bad' || m.tone === 'warn'));
+  const riskRel = rel.filter((m) => m.tone === 'bad' || m.tone === 'warn');
+  const lateDue = marks.filter((m) => isDue(m) && m.tone === 'bad'); const riskDue = wide ? [] : marks.filter((m) => isDue(m) && m.tone === 'warn');
+  const out = []; const sent = (...k) => { if (out.length) out.push(' '); out.push(...k); };
+  const dated = (list, max) => joinList(list.map((m) => el('span', null, markName(ui, m), on(m.date))), max);
+  if (rel.length) sent(...(cell ? [...joinList(rel.map((m) => markName(ui, m)), 2), rel.length === 1 ? ' ships.' : ' ship.'] : [plural(rel.length, 'release') + ': ', ...dated(rel, 3), '.']));
+  if (ms.length) sent(ms.length === 1 ? 'Milestone: ' : plural(ms.length, 'milestone') + ': ', ...dated(ms, 3), '.');
+  if (meets.length) {
+    if (cell || M.view === 'day') sent(...joinList(meets.map((m) => el('span', null, meetName(ui, m), h.timeOf(m.e.at) !== null ? ' at ' + h.hhmm(h.timeOf(m.e.at)) : '')), cell ? 2 : 4), '.');
+    else {
+      const big = meets.slice().sort((x, y) => hoursOf(y, h) - hoursOf(x, h) || String(x.e.at).localeCompare(String(y.e.at))).slice(0, 2).sort((x, y) => String(x.e.at).localeCompare(String(y.e.at)));
+      sent(plural(meets.length, 'key meeting') + (meets.length > big.length ? ', the biggest ' : ': '), ...joinList(big.map((m) => el('span', null, meetName(ui, m), ' on ' + shortDay(h, m.date))), 2), '.');
+    }
+  }
+  if (rep.length) sent(...(cell || rep.length <= 2 ? [...joinList(rep.map((m) => markName(ui, m, m.title.replace(/ goes out$/, ''))), 2), rep.length === 1 ? ' goes out.' : ' go out.'] : [rep.length + ' reports go out.']));
+  const watch = [];
+  for (const m of lateMs) watch.push(el('span', null, markName(ui, m, m.title.replace(/\s*\(late\)$/, '')), m.tone === 'bad' ? ' is late' : ' is at risk', cell ? '' : ' (' + shortDay(h, m.date) + ')'));
+  for (const m of riskRel) watch.push(el('span', null, markName(ui, m), m.tone === 'bad' ? ' is late' : ' is at risk'));
+  if (lateDue.length) watch.push(cell || lateDue.length <= 2 ? el('span', null, ...joinList(lateDue.map((m) => markName(ui, m)), 2), lateDue.length === 1 ? ' is late' : ' are late') : plural(lateDue.length, 'due item') + ' are late');
+  if (riskDue.length) watch.push(cell || riskDue.length <= 2 ? el('span', null, ...joinList(riskDue.map((m) => markName(ui, m)), 2), ' due soon') : plural(riskDue.length, 'due item') + ' due soon');
+  if (watch.length) sent(el('b', { class: 'cal3-watch' }, 'Watch:'), ' ', ...joinList(watch, 4), '.');
+  return out;
+}
+
+/* the range summary above the grid, at every zoom */
+function highlights(ui, range) {
+  const { h, M } = ui;
+  const MF = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'];
+  const mo = Number(range.start.slice(5, 7));
+  const label = M.view === 'day' ? h.dayLabel(range.start) : M.view === 'week' ? 'Week of ' + h.dayLabel(range.start) : M.view === 'month' ? MF[mo - 1] : M.view === 'quarter' ? 'Q' + (Math.floor((mo - 1) / 3) + 1) : range.start.slice(0, 4);
+  const body = highlightOf(ui, range.start, range.end, 'top');
+  return el('div', { class: 'cal3-sum', 'data-cal3': 'highlights' },
+    el('span', { class: 'cal3-sum-h' }, label + ' highlights'),
+    el('p', null, ...(body.length ? body : ['Nothing significant. Only routine items fall in this range.'])));
+}
+
+/* the quiet line of a span: what is counted and not named; pressing it opens the span */
+function quietLine(ui, a, b, view, opts) {
+  const wide = opts && opts.wide;
+  const marks = marksIn(ui.M, ui.st, a, b); const meets = meetingsIn(ui, a, b);
+  const due = marks.filter((m) => isDue(m) && (wide ? m.tone !== 'bad' : quietDue(m)));
+  const rt = marks.filter(routineMark).length + (wide ? 0 : meets.filter((m) => !m.key).length);
+  const nMeet = wide ? meets.length : 0;
+  const parts = [nMeet ? plural(nMeet, 'meeting') : null, due.length ? due.length + ' due' : null, rt ? rt + ' routine' : null].filter(Boolean);
+  if (!parts.length) return null;
+  const mo = Number(a.slice(5, 7));
+  const where = view === 'day' ? ui.h.dayLabel(a) : view === 'week' ? 'the week of ' + ui.h.dayLabel(a) : view === 'quarter' ? 'Q' + (Math.floor((mo - 1) / 3) + 1) + ' ' + a.slice(0, 4) : ui.h.MN[mo - 1] + ' ' + a.slice(0, 4);
+  const names = [...new Set([...due.map((m) => m.title), ...marks.filter(routineMark).map((m) => m.title)])];
+  const tip = parts.join(', ') + (names.length ? ': ' + names.slice(0, 8).join(', ') + (names.length > 8 ? ' and more' : '') : '') + '. Open ' + where;
+  return button({ label: parts.join(' · '), variant: 'ghost', size: 'sm', attrs: { class: 'cal3-more cal3-rt', 'data-cal3-quiet': a, title: tip, 'aria-label': tip },
+    onClick: () => ui.h.go(ui.host, ui.r, { view, date: a, anim: 'zi' }) });
+}
+
+/* ── Month: a cell per day. Its highlight in a sentence and a quiet line; with Routine on, the meeting count and every marker ── */
 
 function monthGrid(ui) {
   const { M, st, h, d } = ui;
@@ -342,38 +459,58 @@ function monthGrid(ui) {
   for (let i = 0; i < off; i++) g.appendChild(el('div', { class: 'cal3-mc out', 'aria-hidden': 'true' }));
   for (const c of days) {
     const wd = h.dowOf(c.start); const n = st.on.has('meetings') ? M.meetingsOf(c).length : 0;
-    g.appendChild(el('div', { class: 'cal3-mc' + (wd === 0 || wd === 6 ? ' we' : '') + (c.start === d.today ? ' today' : ''), 'data-cal3-date': c.start },
+    const hl = st.routine ? [] : highlightOf(ui, c.start, c.start, 'cell');
+    g.appendChild(el('div', { class: 'cal3-mc' + (wd === 0 || wd === 6 ? ' we' : '') + (c.start === d.today ? ' today' : '') + (hl.length ? ' key' : ''), 'data-cal3-date': c.start },
       button({ label: String(Number(c.start.slice(8))), variant: 'ghost', size: 'sm', attrs: { class: 'cal3-dn', 'data-cal3-day': c.start, 'aria-label': 'Open ' + h.dayLabel(c.start) + (n ? ', ' + plural(n, 'meeting') : ''), title: 'Open ' + h.dayLabel(c.start) }, onClick: () => h.go(ui.host, ui.r, { view: 'day', date: c.start, anim: 'zi' }) }),
-      n ? el('span', { class: 'cal3-cnt' }, plural(n, 'meeting')) : null,
-      ...markRow(ui, c.start, c.start, 3, true, 'day')));
+      ...(st.routine
+        ? [n ? el('span', { class: 'cal3-cnt' }, plural(n, 'meeting')) : null, ...markRow(ui, c.start, c.start, 3, true, 'day')]
+        : [hl.length ? el('p', { class: 'cal3-hl', 'data-cal3-hl': c.start }, ...hl) : null, quietLine(ui, c.start, c.start, 'day')])));
   }
-  return el('section', { class: 'card cal3-grid', 'data-cv': 'grid' }, g);
+  return el('section', { class: 'card cal3-grid', 'data-cv': 'grid' }, g, foldNote(ui));
+}
+
+/* the line under a Month, Quarter or Year grid that says what is counted and not named */
+function foldNote(ui) {
+  if (ui.st.routine) return null;
+  return el('p', { class: 'dim cal3-fold', 'data-cal3': 'fold-note' }, (ui.M.view === 'month'
+    ? 'Report drafts, recurring meetings, stand-ups, 1:1s and due items on track are counted under each day, not listed.'
+    : 'Meetings, due items that are not late, and routine items are counted under each highlight, not listed. Open a month for its key meetings.')
+    + ' Turn on Routine to show everything.');
 }
 
-/* ── Quarter: a row per week; Year: a card per month. Counts, and the markers of the most important kinds ────────── */
+/* ── Quarter: a column per month; Year: a column per quarter. Each has its highlight and its quiet line ──────────── */
 
-function spanCounts(ui, c) {
-  const { M, st } = ui;
-  const n = st.on.has('meetings') ? M.meetingsOf(c).length : 0;
-  return el('div', { class: 'cal3-counts' },
-    st.on.has('meetings') ? el('span', { class: 'tag' }, plural(n, 'meeting')) : null,
-    el('span', { class: 'tag' }, plural(marksIn(M, st, c.start, c.end).length, 'dated item')));
+const monthEnd = (start) => { const y = Number(start.slice(0, 4)); const m = Number(start.slice(5, 7)); const last = new Date(y, m, 0).getDate(); return start.slice(0, 8) + String(last).padStart(2, '0'); };
+const monthStart = (y, m) => y + '-' + String(m).padStart(2, '0') + '-01';
+
+function spanColumn(ui, a, b, head, now, extra, view) {
+  const hl = ui.st.routine ? null : highlightOf(ui, a, b, 'top');
+  return el('div', { class: 'cal3-ym cal3-col' + (now ? ' now' : ''), 'data-cal3-span': a }, head,
+    ui.st.routine ? el('div', { class: 'cal3-qmk' }, ...markRow(ui, a, b, 12, false, view))
+      : el('p', { class: 'cal3-hl' + (hl.length ? '' : ' dim'), 'data-cal3-hl': a }, ...(hl.length ? hl : ['Nothing significant.'])),
+    extra || null, ui.st.routine ? null : quietLine(ui, a, b, view, { wide: true }));
 }
 
 function quarterRows(ui) {
-  const { M, h, d } = ui;
-  const rows = M.cells.map((c) => el('div', { class: 'cal3-qrow' + (c.start <= d.today && d.today <= c.end ? ' now' : ''), 'data-cal3-week': c.start },
-    button({ label: 'Week of ' + h.dayLabel(c.start), variant: 'ghost', size: 'sm', attrs: { class: 'cal3-dbtn', title: 'Open the week of ' + h.dayLabel(c.start) }, onClick: () => h.go(ui.host, ui.r, { view: 'week', date: c.start, anim: 'zi' }) }),
-    spanCounts(ui, c), el('div', { class: 'cal3-qmk' }, ...markRow(ui, c.start, c.end, 4, false, 'week'))));
-  return el('section', { class: 'card cal3-grid', 'data-cv': 'grid' }, el('div', { class: 'cal3-quarter', 'data-cal3': 'quarter' }, ...rows));
+  const { h, d } = ui; const range = d.range || { start: d.today, end: d.today };
+  const y = Number(range.start.slice(0, 4)); const m0 = Number(range.start.slice(5, 7));
+  const cols = [0, 1, 2].map((i) => {
+    const a = monthStart(y, m0 + i); const b = monthEnd(a);
+    const head = button({ label: h.MN[m0 + i - 1] + ' ' + y, variant: 'ghost', size: 'sm', attrs: { class: 'cal3-dbtn', 'data-cal3-month': a.slice(0, 7), title: 'Open ' + h.MN[m0 + i - 1] + ' ' + y }, onClick: () => h.go(ui.host, ui.r, { view: 'month', date: a, anim: 'zi' }) });
+    return spanColumn(ui, a, b, head, a <= d.today && d.today <= b, null, 'month');
+  });
+  return el('section', { class: 'card cal3-grid', 'data-cv': 'grid' }, el('div', { class: 'cal3-cols cal3-cols-3', 'data-cal3': 'quarter' }, ...cols), foldNote(ui));
 }
 
 function yearCards(ui) {
-  const { M, h, d } = ui;
-  const cards = M.cells.map((c) => el('div', { class: 'cal3-ym' + (c.start <= d.today && d.today <= c.end ? ' now' : ''), 'data-cal3-month': c.start.slice(0, 7) },
-    button({ label: h.MN[Number(c.start.slice(5, 7)) - 1] + ' ' + c.start.slice(0, 4), variant: 'ghost', size: 'sm', attrs: { class: 'cal3-dbtn', title: 'Open the month' }, onClick: () => h.go(ui.host, ui.r, { view: 'month', date: c.start, anim: 'zi' }) }),
-    spanCounts(ui, c), el('div', { class: 'cal3-qmk' }, ...markRow(ui, c.start, c.end, 3, false, 'month'))));
-  return el('section', { class: 'card cal3-grid', 'data-cv': 'grid' }, el('div', { class: 'cal3-year', 'data-cal3': 'year' }, ...cards));
+  const { h, d } = ui; const range = d.range || { start: d.today, end: d.today }; const y = Number(range.start.slice(0, 4));
+  const cols = [0, 1, 2, 3].map((q) => {
+    const a = monthStart(y, q * 3 + 1); const b = monthEnd(monthStart(y, q * 3 + 3));
+    const head = button({ label: 'Q' + (q + 1) + ' ' + y + ' · ' + h.MN[q * 3] + ' to ' + h.MN[q * 3 + 2], variant: 'ghost', size: 'sm', attrs: { class: 'cal3-dbtn', 'data-cal3-quarter': 'Q' + (q + 1), title: 'Open Q' + (q + 1) + ' ' + y }, onClick: () => h.go(ui.host, ui.r, { view: 'quarter', date: a, anim: 'zi' }) });
+    const months = el('div', { class: 'cal3-mlinks' }, ...[1, 2, 3].map((k) => { const s = monthStart(y, q * 3 + k); return button({ label: h.MN[q * 3 + k - 1], variant: 'ghost', size: 'sm', attrs: { class: 'cal3-more', 'data-cal3-month': s.slice(0, 7), title: 'Open ' + h.MN[q * 3 + k - 1] + ' ' + y }, onClick: () => h.go(ui.host, ui.r, { view: 'month', date: s, anim: 'zi' }) }); }));
+    return spanColumn(ui, a, b, head, a <= d.today && d.today <= b, months, 'quarter');
+  });
+  return el('section', { class: 'card cal3-grid', 'data-cv': 'grid' }, el('div', { class: 'cal3-cols cal3-cols-4', 'data-cal3': 'year' }, ...cols), foldNote(ui));
 }
 
 /* ── the detail column ────────────────────────────────────────────────────────────────────────────────────────────── */

package/workspace/public/pm/c3-demo-cal4.js

@@ -39,12 +39,12 @@ const DATED = [
   ['2026-10-13', 'own', 'mine', 'Share returns insights with sales', null, item('item-demo017'), 'returns'],
   ['2026-11-16', 'own', 'mine', 'Write the Q1 discovery plan', null, item('item-demo020'), null],
 ];
-/* the weekly status to leadership is a report date every Friday */
-for (let d = '2026-09-04'; d <= '2026-12-25'; d = addDays(d, 7)) DATED.push([d, 'report', 'reports', 'Weekly status to leadership', null, { type: 'report', id: 'leadership-weekly' }, null]);
+/* the weekly status to leadership is a report date every Friday: routine, so Month, Quarter and Year count it (calendar-highlights) */
+for (let d = '2026-09-04'; d <= '2026-12-25'; d = addDays(d, 7)) DATED.push([d, 'report', 'reports', 'Weekly status to leadership', null, { type: 'report', id: 'leadership-weekly' }, null, { cadence: 'weekly', routine: true }]);
 
 function layersIn(start, end) {
   return DATED.filter((x) => x[0] >= start && x[0] <= end).sort((a, b) => (a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0))
-    .map(([date, kind, layer, title, tone, ref, initiative], i) => ({ id: 'dated-' + date + '-' + i, date, kind, layer, title, tone, ref, ...(initiative ? { initiative } : {}) }));
+    .map(([date, kind, layer, title, tone, ref, initiative, extra], i) => ({ id: 'dated-' + date + '-' + i, date, kind, layer, title, tone, ref, ...(initiative ? { initiative } : {}), ...(extra || {}) }));
 }
 
 /* the suggested uses of a free block, from the demo's work items; a block past the first of a day gets none */

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

@@ -104,7 +104,8 @@ export function createDock(opts) {
       el('div', { class: 'chips2' }, el('b', { style: 'font-size:var(--fs-3)' }, s.name), el('span', { class: 'chips2 dim mono', style: 'font-size:var(--fs-1)' }, c3ic(PI[s.agent] || 'term', 'sm'), (PN[s.agent] || s.agent) + ' · ' + ((t && t.branch) || 'no branch'))),
       el('div', { class: 'dim mono', style: 'font-size:var(--fs-1)' }, facts),
       s.shown === 'needs' ? el('div', { class: 'fold a' }, c3ic('alert', 'sm'), 'needs you') : null,
-      el('a', { class: 'chip2 lk', href: '/', 'data-c3pg': 'dock-open-session', title: TIPS.terminalOpen, 'aria-label': 'Open the session ' + s.name + ' in the main app' }, ic('term', 'sm'), 'Open the session'),
+      el('a', { class: 'chip2 lk', href: '/', 'data-c3pg': 'dock-open-session', title: TIPS.terminalOpen, 'aria-label': 'Open the session ' + s.name,
+        onclick: (e) => { if (e.metaKey || e.ctrlKey || e.shiftKey || e.button > 0) return; e.preventDefault(); import('./c3-session-term.js').then((m) => m.openSessionTerm({ id: s.id, name: s.name })); } }, ic('term', 'sm'), 'Open the session'),
       term,
       el('div', { class: 'form' },
         el('input', { type: 'text', readonly: true, 'data-off': '', placeholder: s.shown === 'needs' ? 'Your answer' : 'Message', 'aria-label': 'Message', title: MORE, 'data-c3pg': 'dock-msg' }),

package/workspace/public/pm/c3-session-term.js

@@ -0,0 +1,44 @@
+/* pm/c3-session-term.js — a session's real terminal inside console3, in a sheet, so "Open the session" no longer leaves /c3.html.
+ *   openSessionTerm({ id, name })
+ * The terminal is tab-term.js's own (the one the main app draws): the same socket, attach, resize and input. Closing the sheet detaches the
+ * pane and leaves the session running, as closing a tab in the main app does. xterm and its addons are the main app's vendored globals,
+ * loaded here on the first open because /c3.html does not load them up front. */
+import { el } from './dom.js';
+import { openSheet } from './c3-sheet.js';
+import { toast } from './c3-toast.js';
+import { pmGet } from './http.js';
+
+const VENDOR = ['/vendor/xterm.js', '/vendor/addon-fit.js', '/vendor/addon-web-links.js'];
+let vendor = null;
+
+function script(src) {
+  return new Promise((resolve) => {
+    if (document.querySelector('script[src="' + src + '"]')) { resolve(true); return; }
+    const s = document.createElement('script');
+    s.src = src; s.onload = () => resolve(true); s.onerror = () => resolve(false);
+    document.head.append(s);
+  });
+}
+function loadVendor() {
+  if (typeof window.Terminal === 'function') return Promise.resolve(true);
+  if (!vendor) {
+    if (!document.querySelector('link[href="/vendor/xterm.css"]')) document.head.append(el('link', { rel: 'stylesheet', href: '/vendor/xterm.css' }));
+    // the addons read window.Terminal when they run, so xterm goes first
+    vendor = script(VENDOR[0]).then((ok) => (ok ? Promise.all(VENDOR.slice(1).map(script)).then(() => true) : false));
+  }
+  return vendor;
+}
+
+export async function openSessionTerm({ id, name } = {}) {
+  if (!id) return null;
+  if (!name) { const r = await pmGet('/api/sessions').catch(() => null); const x = r && Array.isArray(r.sessions) ? r.sessions.find((y) => y.id === id) : null; name = x ? x.name : id; }
+  const [ok, term] = await Promise.all([loadVendor(), import('./tab-term.js').catch(() => null)]);
+  if (!ok || !term) { toast({ text: 'The terminal could not be loaded on this page.', tone: 'error' }); return null; }
+  const tab = { id: 'c3-session:' + id, kind: 'term', sessionId: id, spawn: false, sess: id };
+  const host = el('div', { class: 'c3t-term', 'data-c3-session-term': id });
+  // Esc and Tab belong to the shell while the terminal has focus (Esc interrupts an agent); the close button and a press outside still close
+  const sheet = openSheet({ title: name || id, icon: 'term', wide: true, body: host, onClose: () => term.disposeTerm(tab), passKeys: (e) => host.contains(e.target) });
+  term.mountTerm(host, tab);
+  requestAnimationFrame(() => { term.refitVisible(); term.focusTerm(tab); });
+  return sheet;
+}

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

@@ -1,7 +1,7 @@
 /* pm/c3-sheet.js — the console3 sheet, as a primitive (console3.html: bsHtml line 2502, the .sheet rules 143 to 145, 180, 496 to 502,
  * the Esc handler 2536 and the phone drag 2538 to 2540).
  *
- *   openSheet({ title, icon, body, wide, dw, scrim, onClose }) -> { close, root, sheet, body }
+ *   openSheet({ title, icon, body, wide, dw, scrim, onClose, passKeys }) -> { close, root, sheet, body }   passKeys(e): true leaves that key to the page
  *   closeSheet()                                          closes the open sheet, if any
  *
  * On a desktop window the sheet is the right-hand panel (340px; `wide` 600px; `dw` the document sheet, up to 780px) over a
@@ -50,7 +50,7 @@ export function closeSheet() {
   if (typeof c.onClose === 'function') { try { c.onClose(); } catch { /* the caller reports its own errors */ } }
 }
 
-export function openSheet({ title = '', icon = 'doc', body, wide = false, dw = false, scrim = true, onClose } = {}) {
+export function openSheet({ title = '', icon = 'doc', body, wide = false, dw = false, scrim = true, onClose, passKeys } = {}) {
   closeSheet();
   ensureC3Css();
   const opener = document.activeElement && document.activeElement !== document.body ? document.activeElement : null;
@@ -91,6 +91,7 @@ export function openSheet({ title = '', icon = 'doc', body, wide = false, dw = f
   sheet.addEventListener('pointercancel', () => { if (drag) { drag = null; sheet.classList.remove('dragging'); sheet.style.transform = ''; } });
 
   const onKey = (e) => {
+    if (typeof passKeys === 'function' && passKeys(e)) return;   // a terminal in the sheet owns Esc and Tab while it has focus
     if (e.key === 'Escape') { e.stopPropagation(); e.preventDefault(); close(); return; }
     if (e.key !== 'Tab') return;
     const items = [...sheet.querySelectorAll(FOCUSABLE)].filter((n) => n.offsetWidth > 0 || n.offsetHeight > 0 || n === document.activeElement);

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

@@ -424,7 +424,8 @@ function dock() {
     onCount: (live, need) => { S.termBdg.textContent = String(need); S.termBdg.hidden = need === 0; import('./c3-terminal-icons.js').then((m) => { const t = m.TIPS.agentHeader(need); S.termBtn.title = t; S.termBtn.setAttribute('aria-label', t); }); },   // the badge counts runs that need you, never running ones
   });
   S.dockEl = S.dock.side; S.rail = S.dock.rail;
-  window.addEventListener('pmos:open-session', () => location.assign('/'));
+  // a session opens in its own terminal sheet on this page (c3-session-term.js), not in the main app
+  window.addEventListener('pmos:open-session', (e) => { const id = e.detail && e.detail.id; if (!id) { location.assign('/'); return; } import('./c3-session-term.js').then((m) => m.openSessionTerm({ id, name: e.detail.name })); });
   return [S.dock.side, S.dock.rail];
 }
 /* The mockup opens the dock on the Briefing and folds it to a rail on the other tabs (console3.html line 2017). */

package/workspace/public/pm/c3-terminal-data.js

@@ -7,7 +7,7 @@
  * needsYou(runs) is the one count for the needs-you badge: a run that asks, holds a permission, needs the terminal or did not start. */
 import { pmGet, pmPost } from './http.js';
 
-export const WHY_PROMPT = 'Sending a prompt to a session is not available on this page: no safe route sends one. The session\'s terminal is in the main app.';
+export const WHY_PROMPT = 'Sending a prompt to a session is not available on this page: no safe route sends one. To type to the session, press Open the session.';
 
 const real = {
   demo: false, canPrompt: false, why: WHY_PROMPT,

package/workspace/public/pm/c3-terminal-icons.js

@@ -15,7 +15,7 @@ export const TIPS = {
   agentHeader: (n) => (n ? 'Agent surfaces: ' + n + (n === 1 ? ' session needs you' : ' sessions need you') : 'Agent surfaces: sessions, results to accept, questions for you'),
   agentDock: 'Agent surfaces: the full page of sessions that need you',
   terminalRail: 'Sessions dock (Ctrl J): the terminals of your branches',
-  terminalOpen: 'Open the session: its real terminal, in the main app',
+  terminalOpen: 'Open the session: its real terminal, on this page',
 };
 
 const NS = 'http://www.w3.org/2000/svg';

package/workspace/public/pm/console3.css

@@ -628,10 +628,32 @@
 .c3 .cal3-counts{display:flex;gap:4px;flex-wrap:wrap}
 .c3 .cal3-year{display:grid;grid-template-columns:repeat(auto-fill,minmax(200px,1fr));gap:8px}
 .c3 .cal3-ym{border:1px solid var(--border);border-radius:8px;padding:8px;display:grid;gap:6px;align-content:start;min-width:0}
+/* calendar-highlights: the range summary above the grid, a highlight per Month day, per Quarter month and per Year quarter */
+.c3 .cal3-sum{display:grid;gap:4px;margin:0 0 12px;padding:8px 12px;border-left:3px solid var(--acc);border-radius:8px;background:var(--muted)}
+.c3 .cal3-sum-h{font:var(--fs-1) var(--mono);color:var(--muted-foreground);text-transform:uppercase;letter-spacing:.06em}
+.c3 .cal3-sum p{margin:0;font-size:var(--fs-3);line-height:1.55;color:var(--foreground)}
+.c3 .cal3-hl{margin:2px 2px 0;font-size:var(--fs-1);line-height:1.45;color:var(--foreground);overflow-wrap:anywhere}
+.c3 .cal3-col .cal3-hl{font-size:var(--fs-2);line-height:1.55}
+.c3 .cal3 button.cal3-sl{display:inline;height:auto;min-height:0;padding:0;border:0;background:none;font:inherit;font-weight:600;line-height:inherit;color:inherit;white-space:normal;text-align:left;cursor:pointer;text-decoration:underline;text-decoration-color:var(--border);text-underline-offset:3px}
+@media (hover:hover){.c3 .cal3 button.cal3-sl:hover{text-decoration-color:currentColor}}
+.c3 .cal3 button.cal3-sl:focus-visible{outline:2px solid var(--ring);outline-offset:2px}
+.c3 .cal3-watch{color:var(--destructive)}
+.c3 .cal3 button.cal3-more.cal3-rt{justify-content:flex-start;margin-top:auto;text-align:left}
+.c3 .cal3-cols{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:8px}
+.c3 .cal3-cols.cal3-cols-4{grid-template-columns:repeat(4,minmax(0,1fr))}
+.c3 .cal3-col{padding:10px;gap:8px;min-height:160px}
+.c3 .cal3-mlinks{display:flex;gap:4px;flex-wrap:wrap}
+.c3 .cal3-fold{margin:8px 4px 0;font-size:var(--fs-2)}
+/* titles wrap instead of being cut, in Month, Quarter and Year */
+.c3 .cal3-mc button.cal3-mk,.c3 .cal3-qmk button.cal3-mk{white-space:normal;align-items:flex-start}
+.c3 .cal3-mc button.cal3-mk>span,.c3 .cal3-qmk button.cal3-mk>span{align-items:flex-start;overflow:visible}
+.c3 .cal3-mc .cal3-mk .cal3-mk-t,.c3 .cal3-qmk .cal3-mk .cal3-mk-t{overflow:visible;text-overflow:clip;overflow-wrap:anywhere}
 @container (max-width:640px){
   .c3 .cal3-mk.compact .cal3-mk-t{display:none}
   .c3 .cal3-mc{min-height:64px;padding:2px}
   .c3 .cal3-qrow{grid-template-columns:minmax(0,1fr)}
+  .c3 .cal3-cols,.c3 .cal3-cols.cal3-cols-4{grid-template-columns:minmax(0,1fr)}
+  .c3 .cal3-col{min-height:0}
 }
 /* the detail column */
 .c3 .cal3-dt{display:flex;align-items:center;gap:8px}
@@ -1628,6 +1650,8 @@
 .c3 .c3t-sw[aria-checked="true"] i{background:var(--acc)}.c3 .c3t-sw[aria-checked="true"] i::after{transform:translateX(16px)}
 .c3 .c3t-sw:focus-visible{outline:2px solid var(--ring);outline-offset:2px}
 .c3 .c3t-panel{display:grid;gap:var(--sp-2);border:1px solid var(--border);border-radius:10px;padding:var(--sp-3)}
+/* a session's terminal in a sheet (c3-session-term.js) */
+.c3 .c3t-term{height:calc(100vh - 150px);min-height:240px;display:flex;flex-direction:column}
 .c3 .c3t-panel .feed{display:flex;flex-direction:column;gap:var(--sp-2);max-height:220px;overflow:auto}
 .c3 .c3t-panel .m{padding:6px 12px;border-radius:12px;max-width:88%;overflow-wrap:anywhere}
 .c3 .c3t-panel .m.me{align-self:flex-end;background:var(--acc);color:var(--on-accent)}.c3 .c3t-panel .m.bot{background:var(--muted)}

package/workspace/public/pm/run-card.js

@@ -12,6 +12,7 @@
  * would send a prompt to the session (a suggestion, a revision, the free line, the mic) is drawn disabled with the reason: ctx.src.canPrompt.
  * Per-run UI state (the open tray, the Revise chips, the flipped face) lives in `UI`, outside the render, so a poll never closes it. */
 import { el } from './dom.js';
+import { button } from './primitives.js';
 import { ic } from './c3-terminal-icons.js';
 import { ensureC3Css } from './pm-work-view.js';
 import { attachSwipe } from './c3-swipe.js';
@@ -100,7 +101,9 @@ function pausedBox(ctx, card) {
     el('div', { class: 'prog', 'aria-hidden': 'true' }, el('i', { class: 'd' }), el('i', { class: 'd' }), el('i'), el('i')), el('div', { class: 'c3t-tray' }, openBtn(ctx)));
 }
 export function openBtn(ctx) {
-  return el('button', { type: 'button', class: 'pill c3t-open', 'data-open-session': '', title: 'Open the session: its real terminal, in the main app', onclick: () => ctx.openSession && ctx.openSession(ctx.id) }, ic('term', 'sm'), 'Open the session');
+  const b = button({ label: 'Open the session', onClick: () => ctx.openSession && ctx.openSession(ctx.id), attrs: { class: 'pill c3t-open', 'data-open-session': '', title: 'Open the session: its real terminal, on this page' } });
+  b.prepend(ic('term', 'sm'));
+  return b;
 }
 
 /* ── the next moves, the sub-chips, the tray, the voice line ── */

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

@@ -13,6 +13,8 @@ import { mountRunCard, disposeRunCard, openBtn, uiFor } from './run-card.js';
 import { source, needsYou } from './c3-terminal-data.js';
 import { attachExpand, makeXp } from './c3-expand.js';
 import { toast } from './c3-toast.js';
+import { pmPost } from './http.js';
+import { button } from './primitives.js';
 
 const live = new WeakMap();
 const DOT = { working: 'w', queued: 'w', asking: 'n', permission: 'n', attention: 'n', not_started: 'n', failed: 'b', quiet: '', paused: 'n', done: '' };
@@ -20,6 +22,10 @@ const DOT = { working: 'w', queued: 'w', asking: 'n', permission: 'n', attention
 const ago = (iso) => { const m = Math.max(0, Math.round((Date.now() - Date.parse(iso)) / 60000)); return Number.isFinite(m) ? (m < 1 ? 'just now' : m < 60 ? m + ' min' : m < 1440 ? Math.round(m / 60) + ' h' : Math.round(m / 1440) + ' d') : ''; };
 const when = (iso) => { const d = new Date(iso); return Number.isFinite(+d) ? d.toLocaleDateString('en-GB', { weekday: 'short', day: 'numeric', month: 'short' }) : ''; };
 const stateWord = (c) => (c.permissions && c.permissions.length ? 'waiting for your allow or deny' : ({ asking: 'asking you', permission: 'waiting for your allow or deny', working: 'working', queued: 'starting', quiet: 'quiet', failed: 'failed', done: 'result ready', attention: 'needs the terminal', not_started: 'not started', paused: 'paused', degraded: 'plain text only' })[c.state] || c.state);
+/* A run with no reply lines (a plain terminal session) folds to 'queued', which read as "starting" for days. The server's own state of the
+ * session (GET /api/runs carries it as `label`) says what it is doing instead. */
+const plain = (s, c) => (!c || (c.state === 'queued' && !(c.steps || []).length && !(c.permissions || []).length)) && !!s.label;
+const liveWord = (s, c) => (plain(s, c) ? s.label : stateWord(c || { state: 'working' }));
 function outcomeOf(card, meta) {
   if (meta && meta.out) return meta.out;
   if (!card) return 'ended';
@@ -64,10 +70,37 @@ function blankPanel(st, s, card) {
   return el('div', { class: 'c3t-panel', 'data-blank-panel': s.id },
     can ? el('div', { class: 'feed' }, chat.map((m) => el('div', { class: 'm ' + m[0] }, m[1]))) : null,
     can ? el('div', { class: 'c3t-tray' }, ["Review this week's slips", 'Draft the monthly report'].map((t, i) => el('button', { type: 'button', class: 'pill' + (i ? '' : ' rec'), onclick: () => say(t) }, t))) : null,
-    el('div', { class: 'c3t-tray' }, input, openBtn({ id: s.id, openSession: st.openSession })),
+    el('div', { class: 'c3t-tray' }, input, openBtn({ id: s.id, openSession: st.openSession }), endBtn(st, s)),
+    st.confirm === s.id ? endConfirm(st, s) : null,
     can ? null : dim(st.src.why));
 }
 
+/* End: the route the dock's End uses, POST /api/session/remove (it ends the process and removes the session). Asked first, as the dock asks. */
+/* a primitives.js button with the console3 pill look (as c3-swipe.js's confirm): the icon goes before the label */
+function pill(label, icon, onClick, attrs) {
+  const b = button({ label, onClick, attrs: { ...attrs, class: 'pill' + (attrs && attrs.class ? ' ' + attrs.class : '') } });
+  if (icon) b.prepend(ic(icon, 'sm'));
+  return b;
+}
+function endBtn(st, s) {
+  return pill('End the session', 'stop', () => { st.confirm = st.confirm === s.id ? null : s.id; st.redraw(); },
+    { 'data-end-session': s.id, 'aria-expanded': String(st.confirm === s.id), title: 'End the session' });
+}
+function endConfirm(st, s) {
+  return el('div', { class: 'c3t-tray', role: 'group', 'aria-label': 'End this session?', 'data-end-confirm': s.id },
+    dim('End it? Any pending change stays a proposal.'),
+    pill('End', 'stop', () => endSession(st, s), { class: 'rec', 'data-end-yes': s.id }),
+    pill('Keep it', null, () => { st.confirm = null; st.redraw(); }, {}));
+}
+async function endSession(st, s) {
+  st.confirm = null;
+  if (st.src.demo) { toast('In the real workspace this ends the session.'); st.redraw(); return; }
+  const r = await pmPost('/api/session/remove', { id: s.id });
+  if (r && r.ok) toast({ text: r.removed === false ? 'Asked it to end. Press End again to remove it.' : 'Ended. Any pending change stays a proposal.', timeout: 4200 });
+  else toast({ text: 'Not ended: ' + ((r && r.error) || 'the workspace server did not answer'), tone: 'error' });
+  st.last = ''; st.redraw(); st.refresh();
+}
+
 function tlBody(st, s, card, meta) {
   const tl = st.data.demo && st.data.demo.timeline;
   const kids = [];
@@ -92,13 +125,14 @@ function draw(host, st) {
   /* On a card: each run is its card */
   const on = g.onCard || [];
   root.append(section('spark', 'On a card', on.length, null, on.length
-    ? el('div', { class: 'c3t-cards', 'data-c3t': 'on-card' }, on.map((s) => cardHost(st, s, cards[s.id] || { state: 'working', title: 'Working', nextMoves: [], claims: [], steps: [] })))
+    ? el('div', { class: 'c3t-cards', 'data-c3t': 'on-card' }, on.map((s) => el('div', null, cardHost(st, s, cards[s.id] || { state: 'working', title: 'Working', nextMoves: [], claims: [], steps: [] }),
+      el('div', { class: 'c3t-tray' }, endBtn(st, s)), st.confirm === s.id ? endConfirm(st, s) : null)))
     : none('None running. A result appears on its card.')));
   /* Started by me */
   const mine = g.startedByMe || [];
   const add = el('a', { class: 'chip2 lk c3t-new', href: '/', title: 'Start a session in the main app. A session starts over the terminal connection; this page has no route for it.' }, ic('plus', 'sm'), 'New');
   root.append(section('term', 'Started by me', mine.length, add, mine.length
-    ? el('ul', { class: 'list', 'data-c3t': 'mine' }, mine.map((s) => { const c = cards[s.id]; return row(st, s, c, { sub: stateWord(c || { state: 'working' }) + ' · ' + ago(s.startedAt) + ' · main tree', body: [cardHost(st, s, c || { state: 'working', title: 'Working', nextMoves: [], claims: [], steps: [] }), blankPanel(st, s, c)] }); }))
+    ? el('ul', { class: 'list', 'data-c3t': 'mine' }, mine.map((s) => { const c = cards[s.id]; return row(st, s, c, { sub: liveWord(s, c) + ' · ' + ago(s.startedAt) + ' · main tree', body: [plain(s, c) ? null : cardHost(st, s, c || { state: 'working', title: 'Working', nextMoves: [], claims: [], steps: [] }), blankPanel(st, s, c)].filter(Boolean) }); }))
     : none('None. Start one in the main app.')));
   /* Past */
   const past = g.past || [];
@@ -120,7 +154,9 @@ export function mountSessions(host, ctx = {}) {
   disposeSessions(host);
   if (ctx && ctx.FIXTURE) return;
   ensureC3Css();
-  const st = { src: source(), data: null, showAuto: false, last: '', gone: false, timer: null, refresh: null, redraw: null, open: new Set(), openSession: (id) => { try { window.dispatchEvent(new CustomEvent('pmos:open-session', { detail: { id } })); } catch { /* no event */ } } };
+  const st = { src: source(), data: null, showAuto: false, last: '', gone: false, timer: null, refresh: null, redraw: null, open: new Set(), confirm: null,
+    openSession: (id) => { const r = st.data && st.data.groups ? [].concat(...Object.values(st.data.groups).filter(Array.isArray)).find((x) => x.id === id) : null;
+      import('./c3-session-term.js').then((m) => m.openSessionTerm({ id, name: r ? r.name : id })); } };
   if (st.src.demo) st.openSession = () => toast('In the real workspace this opens the CLI session.');
   st.redraw = () => draw(host, st);
   const busy = () => host.contains(document.activeElement) && ['INPUT', 'TEXTAREA'].includes(document.activeElement.tagName);

package/workspace/test-files.json

@@ -136,6 +136,7 @@
     "pm-portfolio-inline-test.js",
     "pm-brief-page-test.js",
     "c3-settings-test.js",
+    "c3-sessions-panel-test.js",
     "c3-updates-test.js"
   ],
   "ui": [
@@ -269,6 +270,7 @@
     "pm-portfolio-inline-test.js": 15,
     "settings-store.test.js": 1,
     "c3-settings-test.js": 25,
+    "c3-sessions-panel-test.js": 20,
     "c3-updates-test.js": 20
   },
   "_comment_seconds": "Measured wall time of each suite run alone (4-CPU sandbox, 2026-10-05). Only the ORDER uses it: the slowest suites start first, and --shard deals suites to the least-loaded shard so the shards finish together. A wrong or missing number never skips a suite; a missing one counts as 10."