create-pmos 0.46.0 → 0.48.0

package/workspace/lib/proactive-cli.js

@@ -16,13 +16,14 @@
  *   pmos proactive prepare plan --initiative ID [--repo PATH]
  *   pmos proactive prepare queue --initiative ID --item ITEM --sha HASH [--repo PATH]
  *   pmos proactive prepare status | cancel ID | run
+ *   pmos proactive learn [status] | run | lessons | approve ID | reject ID | retire ID | restore TRIGGER | reset
  */
 const fs = require('fs');
 const path = require('path');
 const { execFileSync } = require('child_process');
 const { parseArgs } = require('./schedule-cli');
 
-const COMMANDS = { proactive: ['today', 'scan', 'settings', 'feedback', 'brief', 'prepare'] };
+const COMMANDS = { proactive: ['today', 'scan', 'settings', 'feedback', 'brief', 'prepare', 'learn'] };
 const BRIEF_SOURCES = ['calendar', 'wispr', 'mail', 'jira', 'confluence'];
 const onOff = (v, what) => (v === 'on' || v === 'true' ? true : v === 'off' || v === 'false' ? false : { err: `${what} takes on or off` });
 
@@ -141,6 +142,53 @@ async function run(argv, { call, say, cwd = process.cwd() }) {
     for (const e of r.entries) say(`${e.id}  ${e.status}  ${e.label}${e.reason ? ' — ' + e.reason : ''}`);
     return 0;
   }
+  if (verb === 'learn') {
+    const sub = pos[0] || 'status';
+    const rate = (x, what) => (x.rate === null ? `${what}: not enough evidence (${x.n} of ${x.min} needed)` : `${what}: ${Math.round(x.rate * 100)}% (${x.n} counted)`);
+    const decide = async (decision, past) => {
+      if (!pos[1]) return fail(`usage: pmos proactive learn ${decision} ID`);
+      const r = await call('POST', '/api/proactive/learn/lesson', { id: pos[1], decision, confirm: true });
+      if (!r || r.ok === false) return fail(`refused — ${(r && r.error) || 'the server did not answer'}. Nothing changed.`);
+      say(`${past} ${r.id}`); return 0;
+    };
+    if (sub === 'approve') return decide('approve', 'approved');
+    if (sub === 'reject') return decide('reject', 'rejected');
+    if (sub === 'retire') return decide('retire', 'retired');
+    if (sub === 'restore') {
+      if (!pos[1]) return fail('usage: pmos proactive learn restore TRIGGER');
+      const r = await call('POST', '/api/proactive/learn/restore', { kind: pos[1], confirm: true });
+      if (!r || r.ok === false) return fail(`refused — ${(r && r.error) || 'the server did not answer'}. Nothing changed.`);
+      say(`restored ${r.kind} — it comes back on Today and stays until 10 new ratings of it have arrived`); return 0;
+    }
+    if (sub === 'reset') {
+      const r = await call('POST', '/api/proactive/learn/reset', { confirm: true });
+      if (!r || r.ok === false) return fail(`refused — ${(r && r.error) || 'the server did not answer'}. Nothing changed.`);
+      say('reset — earlier feedback is ignored from now on. It is not deleted.'); return 0;
+    }
+    if (sub === 'run') {
+      const r = await call('POST', '/api/proactive/learn/run', {});
+      if (!r || r.ok === false) return fail(`refused — ${(r && r.error) || 'the server did not answer'}`);
+      say(`weekly review taken — ${r.proposed.length} lesson(s) proposed${r.snapshot.narrowed.length ? ', narrowed: ' + r.snapshot.narrowed.join(', ') : ''}`);
+      return 0;
+    }
+    const r = await call('GET', '/api/proactive/learn');
+    if (!r || r.ok === false) return fail((r && r.error) || 'the server did not answer');
+    if (sub === 'lessons') {
+      if (r.paused) { say('Learning is paused: no lesson applies.'); return 0; }
+      if (!r.approved.length) say('No approved lessons.');
+      for (const l of r.approved) say(`- ${l.text}`);
+      return 0;
+    }
+    if (sub !== 'status') return fail('usage: pmos proactive learn [status|run|lessons|approve ID|reject ID|retire ID|restore TRIGGER|reset]');
+    say(`learning ${r.paused ? 'paused' : 'on'} · ${r.evidenceCount} piece(s) of evidence${r.resetAt ? ' since ' + r.resetAt : ''}`);
+    const ro = r.rollup;
+    say(`last ${ro.days} days — ${rate(ro.hit, 'hit rate')} · ${rate(ro.asIs, 'used as is')} · ${rate(ro.corrections, 'corrections per prepared run')} · ${ro.missed} reported missed`);
+    say('watermelon check: ' + ro.watermelon.note + (ro.watermelon.reasons.length ? ' ' + ro.watermelon.reasons.join('; ') + '.' : ''));
+    for (const c of r.cells.filter((x) => x.delta)) say(`weight ${c.dim} ${c.key}: ${c.delta > 0 ? '+' : ''}${c.delta} (${c.n} events, net ${c.sum})`);
+    for (const n of r.narrowed) say(`narrowed: ${n.kind} — useful ${Math.round(n.rate * 100)}% over ${n.n} ratings in ${n.days} days (floor ${Math.round(n.floor * 100)}%). Restore with: pmos proactive learn restore ${n.kind}`);
+    for (const l of r.lessons.filter((x) => x.status === 'proposed' || x.status === 'approved')) say(`${l.id}  ${l.status}  ${l.text}`);
+    return 0;
+  }
   if (verb === 'brief') {
     const sub = pos[0] || 'show';
     if (sub === 'submit') {

package/workspace/lib/proactive.js

@@ -39,14 +39,14 @@ const clip = (s, n) => String(s == null ? '' : s).replace(/\s+/g, ' ').trim().sl
 const days = (ms) => Math.floor(ms / DAY);
 
 function cand(kind, key, p) {
-  return { id: idOf(key), key, kind, owner: OWNER[kind], initiative_id: p.initiative_id || null, ws: p.ws || null, repo: p.repo || null,
+  return { id: idOf(key), key, kind, owner: OWNER[kind], initiative_id: p.initiative_id || null, ws: p.ws || null, repo: p.repo || null, lane: p.lane || null,
     title: clip(p.title, 120), why: clip(p.why, 200), evidence: clip(p.evidence, 240), confidence: p.confidence, since: p.since == null ? null : p.since,
     open: p.open || null };
 }
 
 /**
  * @param {{now:number, settings:object, repos:Array, nextStepRuns:Array}} ctx
- *   repos[]: {name, ws, error?, initiatives:[{id,title,active,lastRun,hasRuns}], needs:[{initiative_id,question,run_id}],
+ *   repos[]: {name, ws, error?, initiatives:[{id,title,active,lane,lastRun,hasRuns}], needs:[{initiative_id,question,run_id}],
  *            returned:[{initiative_id,note,at}], schedules:[{id,name,lastStatus,lastRun}]}
  *   nextStepRuns[]: {session_id, initiative_id, ws, key, ended, reviewed, at}
  * @returns {{candidates:Array, unreadable:Array<{repo:string,error:string}>}}
@@ -61,7 +61,7 @@ function detect(ctx) {
       for (const n of r.needs || []) {
         const ini = byId.get(n.initiative_id);
         out.push(cand('needs', `needs:${r.ws}:${n.run_id || n.initiative_id + ':' + clip(n.question, 60)}`, {
-          initiative_id: n.initiative_id, ws: r.ws, repo: r.name, title: ini ? ini.title || ini.id : (n.initiative_id || 'an open item'),
+          initiative_id: n.initiative_id, ws: r.ws, repo: r.name, lane: ini ? ini.lane : null, title: ini ? ini.title || ini.id : (n.initiative_id || 'an open item'),
           why: 'An open item is waiting on you.', evidence: n.question, confidence: 0.95, since: null,
           open: n.initiative_id ? { type: 'initiative', initiative_id: n.initiative_id, ws: r.ws } : null }));
       }
@@ -71,7 +71,7 @@ function detect(ctx) {
         const ini = byId.get(x.initiative_id);
         if (ini && !ini.active) continue;
         out.push(cand('returned', `returned:${r.ws}:${x.initiative_id}:${x.at || ''}`, {
-          initiative_id: x.initiative_id, ws: r.ws, repo: r.name, title: ini ? ini.title || ini.id : x.initiative_id,
+          initiative_id: x.initiative_id, ws: r.ws, repo: r.name, lane: ini ? ini.lane : null, title: ini ? ini.title || ini.id : x.initiative_id,
           why: 'You returned this at the Acceptance Gate and it has not been accepted since.', evidence: x.note || 'returned', confidence: 0.95, since: x.at ? Date.parse(x.at) || null : null,
           open: { type: 'initiative', initiative_id: x.initiative_id, ws: r.ws } }));
       }
@@ -93,7 +93,7 @@ function detect(ctx) {
         if (idle < limit) continue;
         const d = days(idle);
         out.push(cand('stalled', `stalled:${r.ws}:${i.id}`, {
-          initiative_id: i.id, ws: r.ws, repo: r.name, title: i.title || i.id,
+          initiative_id: i.id, ws: r.ws, repo: r.name, lane: i.lane, title: i.title || i.id,
           why: `In progress, with no agent run for ${d} days.`, evidence: `last run ${new Date(i.lastRun).toISOString().slice(0, 10)}; the threshold is ${st.stalledDays || DEFAULTS.stalledDays} days`,
           confidence: Math.min(0.85, +(0.5 + 0.05 * (d - (st.stalledDays || DEFAULTS.stalledDays))).toFixed(2)), since: i.lastRun,
           open: { type: 'initiative', initiative_id: i.id, ws: r.ws } }));
@@ -112,9 +112,10 @@ function detect(ctx) {
   return { candidates: out, unreadable };
 }
 
-function rank(cands, now) {
+/** `adj` is optional (slice D4): c → {delta, why[]}. Without it the order is the fixed one, unchanged. */
+function rank(cands, now, adj) {
   const score = (c) => BASE[c.kind] + (c.since != null && now != null ? Math.min(30, Math.max(0, days(now - c.since))) : 0);
-  return cands.map((c) => ({ ...c, rank: score(c) })).sort((a, b) => b.rank - a.rank || (a.id < b.id ? -1 : 1))
+  return cands.map((c) => { const a = typeof adj === 'function' ? adj(c) : null; const d = a && a.delta ? a.delta : 0; return { ...c, rank: score(c) + d, adjust: d, adjust_why: a && a.why ? a.why.join('; ') : '' }; }).sort((a, b) => b.rank - a.rank || (a.id < b.id ? -1 : 1))
     .map((c, i) => ({ ...c, n: i + 1 }));
 }
 

package/workspace/lib/typesafe-settings.js

@@ -97,16 +97,24 @@ function getRepo(stateDir, root) {
     // jev-claim-checks (D80): also ask Jev about changed claim pairs after each check. Default OFF, separate from
     // `consent` and `watch`; a request needs all of key, consent, watch and this.
     jev: !!(r && r.jev === true),
+    // jev-doc-categorizer (D82): ask Jev to categorize documents the local rules leave undetermined. Default OFF, separate
+    // from every other switch; a request needs key, consent and this.
+    categorize: !!(r && r.categorize === true),
+    // status-from-artifacts Run 2 (D83): also send the documents tied to an initiative for two status questions
+    // (is it a stub; does a tied note contradict a requirement). Default OFF, and only read when `jev` is on too.
+    status_read: !!(r && r.status_read === true),
+    // prompt-model-routing: classify prompts with Jev to choose a model tier. Default OFF; a request needs key, consent and this.
+    route: !!(r && r.route === true),
   };
 }
 
-function setRepo(stateDir, root, { consent, exclude, watch, jev }) {
+function setRepo(stateDir, root, { consent, exclude, watch, jev, categorize, route, status_read: statusRead }) {
   const cur = read(stateDir);
   const prev = getRepo(stateDir, root);
   const ex = Array.isArray(exclude)
     ? exclude.map((x) => String(x).trim().replace(/^\/+/, '')).filter((x) => x && !x.includes('..') && x.length <= 200).slice(0, MAX_EXCLUDES)
     : prev.exclude;
-  const repos = { ...cur.repos, [root]: { consent: typeof consent === 'boolean' ? consent : prev.consent, exclude: ex, watch: typeof watch === 'boolean' ? watch : prev.watch, jev: typeof jev === 'boolean' ? jev : prev.jev } };
+  const repos = { ...cur.repos, [root]: { consent: typeof consent === 'boolean' ? consent : prev.consent, exclude: ex, watch: typeof watch === 'boolean' ? watch : prev.watch, jev: typeof jev === 'boolean' ? jev : prev.jev, categorize: typeof categorize === 'boolean' ? categorize : prev.categorize, route: typeof route === 'boolean' ? route : prev.route, status_read: typeof statusRead === 'boolean' ? statusRead : prev.status_read } };
   return write(stateDir, { key: cur.key, repos });
 }
 

package/workspace/package-lock.json

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

package/workspace/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmos-workspace",
-  "version": "0.46.0",
+  "version": "0.48.0",
   "private": true,
   "description": "PMOS Terminal Workspace — local companion hosting real PTYs beside the library and gates (D62)",
   "license": "MIT",
@@ -10,12 +10,13 @@
   "scripts": {
     "start": "node server.js",
     "test": "node test.js && npm run test:modules",
-    "test:modules": "node proactive.test.js && node focus.test.js && node handoff.test.js && node repo-scan.test.js && node profiles.test.js && node external-linking.test.js && node story-artifacts.test.js && node no-network.test.js && node typesafe-validation.test.js && node claims.test.js && node jev-claims.test.js && node repo-watch.test.js && node fixture-parity.test.mjs && node markdown.test.mjs && node start-policy.test.js && node state-isolation.test.js && node sync.test.js && node schedule-cli.test.js && node initiative-surface.test.js && node guide.test.js && node next-step-actions.test.js && node kg.test.js && node proactive-prepare.test.js && node session-flag.test.js",
+    "test:modules": "node proactive.test.js && node focus.test.js && node handoff.test.js && node repo-scan.test.js && node profiles.test.js && node external-linking.test.js && node story-artifacts.test.js && node no-network.test.js && node typesafe-validation.test.js && node claims.test.js && node status-facts-panel.test.js && node jev-claims.test.js && node jev-categorize.test.js && node jev-status.test.js && node jev-route.test.js && node repo-watch.test.js && node fixture-parity.test.mjs && node markdown.test.mjs && node start-policy.test.js && node state-isolation.test.js && node sync.test.js && node schedule-cli.test.js && node initiative-surface.test.js && node guide.test.js && node next-step-actions.test.js && node kg.test.js && node doc-category.test.js && node doc-category-corrections.test.js && node proactive-prepare.test.js && node learn.test.js && node session-flag.test.js && node live-notes.test.js",
     "test:ui": "node ui-test.js",
-    "test:parity": "node design-parity.js --states",
+    "test:parity": "node design-parity.js --board=WsA",
+    "test:parity:four-panel": "node design-parity.js --states",
     "test:all": "npm test && npm run test:panels && npm run test:ui && npm run test:parity && npm run test:offline",
     "doctor": "node doctor.js",
-    "test:panels": "node pm-shell-test.js && node pm-repos-test.js && node pm-initiatives-test.js && node pm-detail-test.js && node pm-tabs-test.js && node pm-term-test.js && node pm-modes-test.js && node pm-r1-test.js && node pm-r2-test.js && node pm-r3-test.js && node pm-r4-test.js && node pm-r5-test.js && node pm-r6-test.js && node pm-r7-test.js && node pm-r8-test.js && node pm-r9-test.js && node pm-r10-test.js && node pm-r11-test.js && node pm-r12-test.js && node pm-r13-test.js && node pm-r14-test.js && node pm-r15-test.js && node pm-r16-test.js && node pm-r17-test.js && node pm-r16-test.js && node pm-r18-test.js && node pm-r19-test.js && node pm-r20-test.js && node pm-r21-test.js && node pm-r22-test.js && node pm-r23-test.js && node pm-r24-test.js && node pm-r25-test.js",
+    "test:panels": "node pm-shell-test.js && node pm-repos-test.js && node pm-initiatives-test.js && node pm-detail-test.js && node pm-tabs-test.js && node pm-term-test.js && node pm-modes-test.js && node pm-r1-test.js && node pm-r2-test.js && node pm-r3-test.js && node pm-r4-test.js && node pm-r5-test.js && node pm-r6-test.js && node pm-r7-test.js && node pm-r8-test.js && node pm-r9-test.js && node pm-r10-test.js && node pm-r11-test.js && node pm-r12-test.js && node pm-r13-test.js && node pm-r14-test.js && node pm-r15-test.js && node pm-r16-test.js && node pm-r17-test.js && node pm-r16-test.js && node pm-r18-test.js && node pm-r19-test.js && node pm-r20-test.js && node pm-r21-test.js && node pm-r22-test.js && node pm-r23-test.js && node pm-r24-test.js && node pm-r25-test.js && node pm-r26-test.js && node pm-doc-category-test.js && node pm-r27-test.js && node pm-r28-test.js && node pm-r29-today-test.js && node pm-r29-portfolio-test.js && node pm-r29-knowledge-test.js && node pm-r29-memory-test.js && node pm-r29-skills-scheduled-test.js && node pm-r29-validate-guide-test.js && node pm-r29-reports-addrepo-test.js && node pm-r29-filespad-test.js && node pm-r29-newsession-alignment-test.js",
     "test:offline": "node offline-tarball.test.js"
   },
   "engines": {

package/workspace/public/pm/app.js

@@ -22,12 +22,17 @@
  */
 
 import { el, clear, setChildren } from './dom.js';
-import { state, setState, subscribe, flush, FIXTURE } from './state.js';
+import { state, setState, subscribe, flush, FIXTURE, LEGACY_LAYOUT_FLAG } from './state.js';
 /* The phone surface (≤760px). It owns its own chrome and decides which single panel is visible;
  * the shell's only part in it is to keep all four hosts mounted below the breakpoint and to hand
  * the module a repaint. See pm/mobile.js. */
 import { isMobile, mountMobile, applyMobile } from './mobile.js';
 
+/* The LEGACY layout is the three-column shell of column-layout: repositories with the list under them, the detail, the tabs, and
+ * a list that a mode (skills, memory …) replaces. A phone still draws it until Run 4 of workspace-cockpit-nav, and `?layout=legacy`
+ * draws it on a desktop so the suites of the panels it uses keep guarding them. It is not a setting: nothing offers it. */
+const legacyLayout = () => LEGACY_LAYOUT_FLAG || isMobile();
+
 /* ── derived labels (the prototype's two title maps, lines 1409 / 1699) ─────────────────────── */
 
 const MODE_TITLE = {
@@ -35,30 +40,38 @@ const MODE_TITLE = {
   knowledge: 'knowledge', agent: 'agents', memory: 'memory', connect: 'connections', focus: 'focus',
   portfolio: 'portfolio', guide: 'guide', validate: 'validate', today: 'today',
 };
+const modeTitle = () => MODE_TITLE[state.mode] || 'initiatives';
 const DETAIL_TITLE = {
   init: 'initiative', flow: 'workflow', sched: 'scheduled task', skill: 'skill', know: 'decision',
   agent: 'agent', mem: 'memory', prof: 'claude profile', intg: 'connection',
   addprod: 'add product', new: 'file new',
 };
 
-const modeTitle = () => MODE_TITLE[state.mode] || 'initiatives';
 const detailTitle = () => DETAIL_TITLE[(state.detail && state.detail.kind) || ''] || 'detail';
 
 /* Panels 1 and 2 are resizable: a drag handle on each right edge. The width is clamped, remembered
  * (state.js PERSIST) and reset by a double-click. Before this the columns were a fixed 210px / 280px and a
  * long repository or branch name was simply cut off. */
-const W0 = { min: 220, max: 560, def: 280 };
+const W_LEGACY = { min: 220, max: 560, def: 280 };
+/* The cockpit's list is 288px by default (the mockup's) and is resized and clamped the same way. */
+const W_COCKPIT = { min: 220, max: 560, def: 288 };
+const W0 = { get min() { return W_LEGACY.min; }, get max() { return W_LEGACY.max; }, get def() { return legacyLayout() ? W_LEGACY.def : W_COCKPIT.def; } };
 const clampW = (v, r) => (typeof v === 'number' && Number.isFinite(v) ? Math.min(r.max, Math.max(r.min, Math.round(v))) : r.def);
 const col0w = () => clampW(state.col0W, W0);
 
-/* THREE columns (column-layout): navigation, detail, tabs. Navigation is the repository list with the list of the
+/* workspace-cockpit-nav: on a desktop the body is FOUR columns — the 64px repository rail (a 65px track: the mockup draws the rail
+ * 64px wide with its 1px border outside that width, so the list starts at x=65), the list (288px), the detail (about
+ * 470px) and the tabs (the rest) — and the hosts keep the order they had. The rail is always drawn; `col1` folds the list to a 36px
+ * strip and `col2` folds the detail. The three-column shell below is what a PHONE still draws until Run 4.
+ *
+ * THREE columns (column-layout): navigation, detail, tabs. Navigation is the repository list with the list of the
  * current mode UNDER it (initiatives, or memory, skills, knowledge …). The detail opens in the second column, the
  * tabs fill the rest. The DOM still holds four hosts in the same order — repos, list, detail, tabs — and the grid
  * puts the list host under the repositories host (see placeHosts). Folded away, the navigation column is a 36px
  * rail; the list alone folds to a one-line bar under the repositories. */
-const gridCols = () =>
-  (state.col0 ? col0w() + 'px' : '36px') + ' ' +
-  (state.col2 ? 'minmax(420px,560px)' : '36px') + ' minmax(0,1fr)';
+const gridCols = (legacy, focus) => focus ? 'minmax(0,1fr) 360px' : legacy
+  ? (state.col0 ? col0w() + 'px' : '36px') + ' ' + (state.col2 ? 'minmax(420px,560px)' : '36px') + ' minmax(0,1fr)'
+  : '65px ' + (state.col1 ? col0w() + 'px' : '36px') + ' ' + (state.col2 ? 'minmax(420px,470px)' : '36px') + ' minmax(0,1fr)';
 
 /** The right-hand 7px of a column is its drag handle. It is a hit-test on the host, not an extra element:
  * the body grid is exactly four tracks and the panels repaint their own children. `key` is the state
@@ -142,43 +155,58 @@ function runningCount() {
  */
 const root = el('div', {
   'data-pm-theme': state.theme,
-  style: 'display:grid;grid-template-rows:44px minmax(0,1fr) 26px;height:100vh;overflow:hidden;background:var(--background);color:var(--foreground);font-family:var(--sans);font-size:13px;line-height:1.5',
+  style: 'display:grid;grid-template-rows:48px minmax(0,1fr) 28px;height:100vh;overflow:hidden;background:var(--background);color:var(--foreground);font-family:var(--sans);font-size:13px;line-height:1.5',
 });
 
+/* The legacy layout has no rail to hang the menu from, so its theme control stays where it was: in the top bar. */
 const themeBtn = el('button', {
   onClick: () => setState((s) => ({ theme: s.theme === 'dark' ? 'light' : 'dark' })),
-  style: 'margin-left:auto;font-size:12px;color:oklch(0.85 0.01 214);padding:5px 12px;background:oklch(1 0 0 / 6%);border:1px solid oklch(1 0 0 / 12%);min-height:30px',
-  hover: 'border-color:oklch(0.56 0.021 213.5)',
+  style: 'font-size:12px;color:var(--foreground);padding:5px 12px;border:1px solid var(--input);min-height:30px',
+  hover: 'border-color:var(--muted-foreground)',
 }, 'theme · dark');
+const crumb = el('span', { 'data-top': 'crumb', style: 'display:flex;align-items:center;gap:8px;color:var(--muted-foreground);min-width:0;overflow:hidden;white-space:nowrap' });
+const jump = el('button', {
+  onClick: () => { if (legacyLayout()) focusSearch(); else setState({ paletteOpen: true, menuOpen: false }); },
+  'data-top': 'jump', 'aria-label': 'jump to anything',
+  style: 'margin-left:auto;display:flex;align-items:center;gap:8px;box-sizing:content-box;border:1px solid var(--input);border-radius:8px;height:32px;padding:0 12px;min-width:300px;color:var(--muted-foreground);font:13px var(--sans);line-height:1.45',
+  hover: 'background:var(--accent)',
+  html: '<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><circle cx="11" cy="11" r="7"/><path d="m20 20-3.5-3.5"/></svg>Jump to anything<span style="margin-left:auto;font:11px var(--mono)">⌘K</span>',
+});
+const liveBadge = el('span', { style: 'font:500 11px var(--sans);border:1px solid transparent;border-radius:999px;padding:0 8px;line-height:18px;white-space:nowrap;background:color-mix(in oklab, var(--success) 16%, transparent);color:var(--success)' }, '● live · local');
 
 const topBar = el('div', {
-  style: 'display:flex;align-items:center;gap:12px;padding:0 12px;background:oklch(0.1 0.004 228.8);color:oklch(0.987 0.002 197.1);border-bottom:1px solid oklch(1 0 0 / 10%)',
+  'data-shell': 'top',
+  // its fill is set per layout in render(): none on the cockpit (as on the mockup), --background on the legacy shell
+  style: 'display:flex;align-items:center;gap:14px;padding:0 16px;border-bottom:1px solid var(--border);color:var(--foreground);min-width:0;line-height:1.45',
 },
-  el('span', { style: 'display:grid;place-items:center;width:24px;height:24px;background:oklch(0.488 0.243 264.376);font-size:14px;line-height:1' }, '◎'),
-  el('span', { style: 'font-weight:600;letter-spacing:.02em' }, 'PMOS'),
-  el('span', { style: 'color:oklch(0.723 0.014 214.4);font-size:12px' }, 'PM Operating System · workspace'),
-  el('span', { style: 'display:flex;gap:6px;align-items:baseline;font-family:var(--mono);font-size:11px;color:oklch(0.76 0.17 152)' },
-    el('span', { style: 'font-size:9px' }, '●'), 'LIVE · local'),
-  themeBtn,
+  el('span', { style: 'font-weight:600;font-size:15px' }, 'PMOS'),
+  crumb,
+  jump,
+  liveBadge,
 );
 
-const statusLeft = el('span', null, 'local · persistent server · 0 sessions running');
+const statusLeft = el('span', null, 'local · 0 sessions running');
 const statusBar = el('div', {
-  style: 'display:flex;align-items:center;padding:0 12px;background:oklch(0.1 0.004 228.8);color:oklch(0.6 0.02 213);font-size:11px;border-top:1px solid oklch(1 0 0 / 10%)',
+  'data-shell': 'status',
+  style: 'display:flex;align-items:center;justify-content:space-between;padding:0 14px;color:var(--muted-foreground);font:11px var(--mono);border-top:1px solid var(--border)',
 },
   statusLeft,
-  el('span', { style: 'margin-left:auto' }, 'sessions survive detach · ⌘K search · Esc closes tab'),
+  el('span', null, '⌘K jump · Esc closes tab'),
 );
+/* The rail's menu is drawn into this host, a sibling of the body so it can float over all four columns. */
+const menuHost = el('div', { 'data-shell': 'menu', style: 'display:contents' });
+const paletteHost = el('div', { id: 'pm-palette', 'data-shell': 'palette', style: 'display:contents' });
 
 /* The body grid's own geometry, in one place so the initial build and every repaint below cannot
  * disagree. The implicit ROW is stated explicitly as `minmax(0,1fr)` for the same reason the root's
  * middle track is: an auto row is floored at its items' min-content height, and one tall panel
  * would push the grid taller than the box it was given. */
-// Two rows on a desktop (repositories, then the list under them), one on a phone, where the hosts are shown one at a time.
-const BODY_GRID_STYLE = (phone) =>
-  'display:grid;grid-template-columns:' + gridCols() + ';grid-template-rows:' + (phone ? 'minmax(0,1fr)' : 'auto minmax(0,1fr)') + ';min-height:0;overflow:hidden';
+// A cockpit desktop is one row of four columns; the legacy layout is two rows (repositories, then the list under them) on a desktop
+// and one on a phone, where the hosts are shown one at a time.
+const BODY_GRID_STYLE = (legacy, phone, focus) =>
+  'display:grid;grid-template-columns:' + gridCols(legacy, focus) + ';grid-template-rows:' + (legacy && !phone ? 'auto minmax(0,1fr)' : 'minmax(0,1fr)') + ';min-height:0;overflow:hidden';
 
-const bodyGrid = el('div', { style: BODY_GRID_STYLE(false) });
+const bodyGrid = el('div', { 'data-shell': 'body', style: BODY_GRID_STYLE(false, false) });
 
 /** The collapsed 36px strip: a full-height button with a rotated vertical-rl label. */
 function makeRail(flag) {
@@ -191,9 +219,10 @@ function makeRail(flag) {
   return { btn, label };
 }
 
-const rail0 = makeRail('col0');
-const rail2 = makeRail('col2');
-/* The list under the repositories, folded: one line, not a column. */
+const rail0 = makeRail('col0');          // the phone's folded navigation strip (legacy layout)
+const rail1 = makeRail('col1');          // a desktop's folded list
+const rail2 = makeRail('col2');          // a folded detail
+/* The list under the repositories, folded: one line, not a column (legacy layout). */
 const listBar = el('button', {
   onClick: () => setState((s) => ({ col1: !s.col1 })),
   title: 'show the list',
@@ -202,8 +231,7 @@ const listBar = el('button', {
 });
 rail0.label.textContent = 'repositories ⟩';
 /* overhaul-r1 R4: in live mode the collapsed repositories rail also carries one glyph per repository
- * (panel-repos.js#railGlyphs), so a repository is selectable without expanding the panel. The
- * toggle keeps its label and stays the rest of the strip. */
+ * (panel-repos.js#railGlyphs). Only the phone's legacy layout folds the navigation column now; a desktop's rail never folds. */
 const rail0Host = el('div', {
   role: 'button', tabindex: '0', title: 'show the repositories panel',
   onClick: () => setState((s) => ({ col0: !s.col0 })),
@@ -213,27 +241,29 @@ const rail0Host = el('div', {
 });
 
 /* `min-height:0` on all four: a grid item's automatic minimum is its content, so a panel taller
- * than the viewport would otherwise stretch the row it sits in rather than scroll inside it. The
- * two that already carry `overflow-y:auto` get it for free under the spec — stated anyway, because
- * "this one is safe because of a rule elsewhere in the same line" is how the next edit breaks it. */
-const hostRepos = el('div', { style: 'background:var(--sidebar);border-right:1px solid var(--border);display:flex;flex-direction:column;min-width:0;min-height:0;overflow-y:auto' });
-const hostInits = el('div', { style: 'background:var(--sidebar);border-right:1px solid var(--border);border-top:1px solid var(--border);overflow-y:auto;min-width:0;min-height:0' });
-makeEdgeDrag(hostRepos, 'col0W', W0, col0w);
+ * than the viewport would otherwise stretch the row it sits in rather than scroll inside it. */
+const HOST_STYLE = {
+  repos: 'background:var(--sidebar);border-right:1px solid var(--border);display:flex;flex-direction:column;min-width:0;min-height:0;overflow-y:auto',
+  inits: 'background:var(--sidebar);border-right:1px solid var(--border);overflow-y:auto;min-width:0;min-height:0',
+  initsDesk: 'background:var(--sidebar);border-right:1px solid var(--border);display:flex;flex-direction:column;gap:12px;padding:12px;box-sizing:border-box;overflow:hidden;min-width:0;min-height:0',
+};
+const hostRepos = el('div', { id: 'pm-rail', style: HOST_STYLE.repos });
+const hostInits = el('div', { id: 'pm-list', style: HOST_STYLE.initsDesk });
 makeEdgeDrag(hostInits, 'col0W', W0, col0w);
-const hostDetail = el('div', { style: 'background:var(--sidebar);border-right:1px solid var(--border);overflow-y:auto;min-width:0;min-height:0;display:flex;flex-direction:column' });
-const hostTabs = el('div', { style: 'background:var(--term-bg);display:flex;flex-direction:column;min-width:0;min-height:0;overflow:hidden' });
+const hostDetail = el('div', { id: 'pm-detail', style: 'background:var(--sidebar);border-right:1px solid var(--border);overflow-y:auto;min-width:0;min-height:0;display:flex;flex-direction:column' });
+const hostTabs = el('div', { id: 'pm-tabs', style: 'background:var(--term-bg);display:flex;flex-direction:column;min-width:0;min-height:0;overflow:hidden' });
 
-setChildren(root, [topBar, bodyGrid, statusBar]);
+setChildren(root, [topBar, bodyGrid, statusBar, menuHost, paletteHost]);
 
 /* ── panel modules, loaded at boot and tolerated when absent ────────────────────────────────── */
 
-const mods = { repos: null, inits: null, detail: null, tabs: null, data: null, fixture: null };
+const mods = { repos: null, inits: null, detail: null, tabs: null, data: null, fixture: null, cockpit: null };
 
 async function loadModules() {
   const want = [
     ['repos', './panel-repos.js'], ['inits', './panel-initiatives.js'],
     ['detail', './panel-detail.js'], ['tabs', './panel-tabs.js'],
-    ['data', './data.js'], ['fixture', './fixture.js'],
+    ['data', './data.js'], ['fixture', './fixture.js'], ['cockpit', './panel-cockpit.js'],
   ];
   await Promise.all(want.map(async ([key, path]) => {
     try { mods[key] = await import(path); } catch { mods[key] = null; }
@@ -249,10 +279,7 @@ function paint(mod, name, host) {
 
 /* ── render ────────────────────────────────────────────────────────────────────────────────── */
 
-/* The rail is still ONE control that re-opens the panel, its first child is still the rotated
- * label, and its text is still exactly `repositories ⟩` — the glyphs draw their initials from a data
- * attribute (tokens.css) and name themselves through aria-label, and CSS `order` lifts them above
- * the label. A glyph click stops at the glyph: it selects, it does not expand. */
+/* The phone's folded navigation strip (legacy layout): one control that re-opens the panel, its first child the rotated label. */
 function railRepos() {
   const glyphs = mods.repos && typeof mods.repos.railGlyphs === 'function' ? mods.repos.railGlyphs() : [];
   if (!glyphs.length) {
@@ -265,15 +292,15 @@ function railRepos() {
   return rail0Host;
 }
 
-/* Where each host sits in the grid. Desktop: column 1 holds the repositories (row 1) and the list under them (row 2); the
- * detail and the tabs span both rows. The repositories block is capped so a long list of repositories cannot push the
- * list off the screen; it scrolls inside its cap. A folded column is a rail spanning both rows. On a phone the placement
- * is cleared and mobile.css decides which single host is shown. */
-function placeHosts(phone, kids) {
+/* Where each host sits in the LEGACY grid. Column 1 holds the repositories (row 1) and the list under them (row 2); the detail and the
+ * tabs span both rows. The repositories block is capped so a long list of repositories cannot push the list off the screen. A folded
+ * column is a rail spanning both rows. On a phone the placement is cleared and mobile.css decides which single host is shown. On a
+ * cockpit desktop every host has its own column and nothing is placed. */
+function placeHosts(legacy, phone, kids) {
   const cell = (el0, col, row) => { if (el0) { el0.style.gridColumn = col; el0.style.gridRow = row; } };
   const clear0 = (el0) => { el0.style.gridColumn = ''; el0.style.gridRow = ''; el0.style.maxHeight = ''; };
-  for (const h of [hostRepos, hostInits, hostDetail, hostTabs, listBar, rail0.btn, rail0Host, rail2.btn]) clear0(h);
-  if (phone) return;
+  for (const h of [hostRepos, hostInits, hostDetail, hostTabs, listBar, rail0.btn, rail0Host, rail1.btn, rail2.btn]) clear0(h);
+  if (!legacy || phone) return;
   if (state.col0) {
     cell(hostRepos, '1', '1');
     hostRepos.style.maxHeight = 'calc((100vh - 70px) * .42)';
@@ -286,44 +313,76 @@ function placeHosts(phone, kids) {
   cell(hostTabs, '3', '1 / 3');
 }
 
+let lastLegacy = null;
 function render() {
   root.setAttribute('data-pm-theme', state.theme);
-  themeBtn.textContent = state.theme === 'dark' ? 'theme · dark' : 'theme · light';
+  const phone = isMobile();
+  const legacy = legacyLayout();
+  // the mockup's body line-height is 1.45; the legacy shell's panels are drawn for 1.5
+  root.style.lineHeight = legacy ? '1.5' : '1.45';
+  // the cockpit's bars are the mockup's 48px and 28px with their 1px rule outside that height (as its rail is 64px plus its rule);
+  // the legacy shell keeps 48px and 28px rule included. A phone's stylesheet replaces the rows altogether.
+  root.style.gridTemplateRows = legacy ? '48px minmax(0,1fr) 28px' : '49px minmax(0,1fr) 29px';
+  // the cockpit's bars have no fill of their own (the root's --background shows through, as on the mockup); the legacy shell's do
+  topBar.style.background = legacy ? 'var(--background)' : '';
+  statusBar.style.background = legacy ? 'var(--background)' : '';
+  // A cockpit desktop never shows a list mode in the list: it opens as a view tab (panel-cockpit.js)
+  if (!legacy && mods.cockpit && typeof mods.cockpit.absorbMode === 'function' && mods.cockpit.absorbMode()) return;
+
   // overhaul-r1 R2.3: the active tab's line of work, when it is not the main tree
   const actTab = (state.tabs || []).find((t) => t.id === state.active);
   const br = actTab && mods.tabs && typeof mods.tabs.tabBranch === 'function' ? mods.tabs.tabBranch(actTab, true) : null;
-  statusLeft.textContent = 'local · persistent server · ' + runningCount() + ' sessions running' + (br ? ' · ⎇ ' + br : '');
+  statusLeft.textContent = 'local · ' + runningCount() + ' sessions running' + (br ? ' · ⎇ ' + br : '');
+  const parts = mods.cockpit && typeof mods.cockpit.breadcrumb === 'function' ? mods.cockpit.breadcrumb() : [];
+  setChildren(crumb, parts);
+  themeBtn.textContent = state.theme === 'dark' ? 'theme · dark' : 'theme · light';
+  if (legacy && themeBtn.parentNode !== topBar) topBar.appendChild(themeBtn);
+  if (!legacy && themeBtn.parentNode === topBar) topBar.removeChild(themeBtn);
 
-  // Panel 1's rail is a constant; panels 2 and 3 name whatever is behind them, so a PM who folded
-  // a panel away can still see what they folded.
+  // Folded strips name whatever is behind them, so a PM who folded a panel away can still see what they folded.
   listBar.textContent = '▸ ' + modeTitle();
+  rail1.label.textContent = 'initiatives ⟩';
   rail2.label.textContent = detailTitle() + ' ⟩';
 
-  const phone = isMobile();
-  bodyGrid.setAttribute('style', BODY_GRID_STYLE(phone));
-
-  // On a phone there are no rails to collapse into and no second column to fold away: the four
-  // hosts all stay mounted, one is DISPLAYED (pm/mobile.css picks it from `data-mpanel`), and the
-  // PM's desktop arrangement — col0/col1/col2 — is left exactly as they set it. Mounting all four
-  // is also what keeps a live terminal alive: a host dropped from this list would be removed from
-  // the document, and panel 4's xterm does not survive that.
-  const listShown = phone || (state.col0 && state.col1);
-  const listHost = phone || state.col1 ? hostInits : listBar;
-  const kids = phone ? [hostRepos, hostInits, hostDetail, hostTabs] : [
-    state.col0 ? hostRepos : railRepos(),
-    // with the navigation column folded away the list goes with it
-    state.col0 ? listHost : null,
-    state.col2 ? hostDetail : rail2.btn,
-    hostTabs,
-  ].filter(Boolean);
+  if (lastLegacy !== legacy) {
+    lastLegacy = legacy;
+    hostInits.setAttribute('style', legacy ? HOST_STYLE.inits + ';border-top:1px solid var(--border)' : HOST_STYLE.initsDesk);
+    // the cockpit's rail is the mockup's centred column; the legacy repositories panel draws its own rows edge to edge
+    hostRepos.style.alignItems = legacy ? '' : 'center';
+    hostRepos.style.gap = legacy ? '' : '10px';
+    hostRepos.style.padding = legacy ? '' : '12px 0';
+  }
+  const focus = !legacy && !phone && !!state.layoutFocus;
+  bodyGrid.setAttribute('style', BODY_GRID_STYLE(legacy, phone, focus));
+
+  // On a phone there are no rails to collapse into and no second column to fold away: the four hosts all stay mounted, one is
+  // DISPLAYED (pm/mobile.css picks it from `data-mpanel`), and the PM's desktop arrangement is left exactly as they set it. Mounting
+  // all four keeps a live terminal alive: a host dropped from this list would be removed from the document.
+  let kids;
+  if (phone) kids = [hostRepos, hostInits, hostDetail, hostTabs];
+  else if (legacy) {
+    const listHost = state.col1 ? hostInits : listBar;
+    kids = [state.col0 ? hostRepos : railRepos(), state.col0 ? listHost : null, state.col2 ? hostDetail : rail2.btn, hostTabs].filter(Boolean);
+  } else if (focus) kids = [hostDetail, hostTabs];   // Focus: the tabs and a 360px detail; hostTabs is never moved, only the others come and go
+  else kids = [hostRepos, state.col1 ? hostInits : rail1.btn, state.col2 ? hostDetail : rail2.btn, hostTabs];
   setChildren(bodyGrid, kids);
-  placeHosts(phone, kids);
-
-  if (phone || state.col0) paint(mods.repos, 'renderRepos', hostRepos);
-  if (listShown) paint(mods.inits, 'renderInitiatives', hostInits);
-  if (phone || state.col2) paint(mods.detail, 'renderDetail', hostDetail);
+  placeHosts(legacy, phone, kids);
+  if (focus) { hostTabs.style.gridColumn = '1'; hostTabs.style.gridRow = '1'; hostDetail.style.gridColumn = '2'; hostDetail.style.gridRow = '1'; }
+
+  if (legacy) {
+    if (phone || state.col0) paint(mods.repos, 'renderRepos', hostRepos);
+    if (phone || (state.col0 && state.col1)) paint(mods.inits, 'renderInitiatives', hostInits);
+    if (phone || state.col2) paint(mods.detail, 'renderDetail', hostDetail);
+  } else if (focus) {
+    paint(mods.detail, 'renderDetail', hostDetail);
+  } else {
+    paint(mods.cockpit, 'renderRail', hostRepos);
+    if (state.col1) paint(mods.cockpit, 'renderWorkList', hostInits);
+    if (state.col2) paint(mods.detail, 'renderDetail', hostDetail);
+  }
   paint(mods.tabs, 'renderTabs', hostTabs);
-
+  paint(mods.cockpit, 'renderMenu', menuHost);
+  paint(mods.cockpit, 'renderPalette', paletteHost);
   applyMobile();
 }
 
@@ -338,9 +397,19 @@ function focusSearch() {
 function onKeyDown(e) {
   if ((e.metaKey || e.ctrlKey) && (e.key === 'k' || e.key === 'K')) {
     e.preventDefault();
-    setState({ col1: true }, focusSearch);
+    // the cockpit's ⌘K is the palette; the legacy layout (and a phone) keep focusing the list's filter
+    if (legacyLayout()) setState({ col1: true, menuOpen: false }, focusSearch);
+    else setState({ paletteOpen: !state.paletteOpen, menuOpen: false });
+    return;
+  }
+  if ((e.metaKey || e.ctrlKey) && e.key === 'Enter' && !legacyLayout()) {
+    e.preventDefault();
+    if (mods.cockpit && typeof mods.cockpit.toggleFocus === 'function') mods.cockpit.toggleFocus();
     return;
   }
+  if (e.key === 'Escape' && state.paletteOpen) { setState({ paletteOpen: false }); return; }
+  if (e.key === 'Escape' && state.menuOpen) { setState({ menuOpen: false }); return; }
+  if (e.key === 'Escape' && state.layoutFocus) { setState({ layoutFocus: false }); return; }
   if (e.key === 'Escape' && !/INPUT|TEXTAREA/.test(e.target && e.target.tagName)) {
     // Verbatim from the prototype: Esc closes the ACTIVE tab, the last remaining tab takes over,
     // and a split pointing at the closed tab is dropped rather than left dangling.