create-pmos 0.88.0 → 0.89.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.88.0",
+  "version": "0.89.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@57df07b
+kernel-source: pmos@5feb40c
 assembled: 2026-10-07
 mode: vendor

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

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

package/workspace/guide/layout.md

@@ -57,9 +57,9 @@ The dock holds your terminals, documents, conversations, skills and web pages. I
 - Press **⋯** on a row to change the name, the initiative or the type of work.
 - Press **✕** on a row to end the session. The row asks "End “name”?". Press **End** or **Cancel**. When you end the last running session on its own working copy, the message offers **Remove working copy**. This removes the folder only. The branch stays. If the folder has unsaved work, the workspace keeps it and tells you why.
 - **＋ Session** at the top of the dock, or **＋** on an initiative, opens one sheet. Type a name, or leave it empty to name the session after the skill and the initiative. **For** is the initiative. **On** is where the session runs. **Automatic** uses the initiative's own working copy on `initiative/<id>` (made the first time), or the main tree when there is no initiative. You can also choose a branch that has a working copy, or **New branch…**. Then press **Blank session** (the CLI and model from Settings) or a skill. The session starts at once.
-- The icons at the top of the session list, under **＋ Session**, show the sessions as a strip on top, give the dock the whole window (Focus), and fold the dock. They stay in view when you scroll the list. On top, a select chooses the group, and each session of the group is a button. **＋** starts a session, and **✕** ends the session in front.
+- The icons at the top of the session list, under **＋ Session**, switch the sessions as a strip on top or a list at the side, set the dock size, and fold the dock. They stay in view when you scroll the list. On top, a select chooses the group, and each session of the group is a button. **＋** starts a session, and **✕** ends the session in front.
 - To make the dock wider or narrower, drag its left edge. With the edge focused, the left and right arrow keys change the width in steps. Double-click the edge to go back to the default width. The width is kept in this browser.
-- **Focus** in the dock gives the dock the whole window. The place and the detail are hidden, and the dock stays full width on every place. Press Focus again, or ⌘⇧J (Ctrl-Shift-J), to show the place again. Folding the dock also ends Focus.
+- **Dock size** opens a menu of four sizes: Normal (the default width), Half the window, Two-thirds, and Whole window (focus). Choose one to set the dock to that size. The size is remembered in this browser. Dragging the edge clears the chosen size and sets a pixel width instead. Whole window (focus) gives the dock the entire screen; the place and the detail are hidden, and the dock stays full width on every place. Press Whole window again, or ⌘⇧J (Ctrl-Shift-J), to show the place. Folding the dock also ends focus.
 - **Scratchpad** in the bar at the bottom of the dock opens and closes the scratchpad. The pad keeps one note for each terminal session, and one for the repository when no terminal is in front. **Send to terminal** types the note into the session in front and presses Enter. It is available only when a terminal is in front. **Copy** and **Clear** act on the note.
 - The same bottom bar shows the title of the tab in front and a copy button that names what it copies: **Copy document** for a document, **Copy attach command** for a terminal.
 - A document tab has one bar. The words at its start say whether the file is saved on disk or has unsaved changes. The copy button beside them shows the file's Confluence or Google Docs copy (see [Edit a document in place](#edit-a-document-in-place)). **Changes**, **Revert** and **Save** show when there are unsaved changes. **Markdown** shows the whole file as markdown in one box; press it again to go back. A file that you cannot edit has **Source** in its place. **⋯** holds the rest: the reading width (full width, or lines of 72 characters), **Normalize line breaks** (it joins hard-wrapped paragraphs into one line each in the buffer; read the result in Changes, then save) and **Hide the outline and connections**. **Run scripts** shows on the bar for an HTML page that can run its own scripts.

package/workspace/package-lock.json

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

package/workspace/package.json

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

package/workspace/public/pm/app.js

@@ -414,7 +414,7 @@ function readFrame() {
 }
 const fr = (() => {
   const s = readFrame();
-  return { dest: FRAME_DESTS.includes(s.dest) ? s.dest : 'today', scope: s.scope === 'all' ? 'all' : 'repo', params: {}, dock: {}, dockMax: false, dockW: null, syncing: false, reg: null, gAt: 0, needs: 0 };
+  return { dest: FRAME_DESTS.includes(s.dest) ? s.dest : 'today', scope: s.scope === 'all' ? 'all' : 'repo', params: {}, dock: {}, dockMax: false, dockW: null, dockSize: null, syncing: false, reg: null, gAt: 0, needs: 0 };
 })();
 function writeFrame() {
   try { localStorage.setItem(FRAME_KEY, JSON.stringify({ dest: fr.dest, scope: fr.scope })); } catch { /* private mode: the default stands */ }
@@ -444,6 +444,34 @@ function toggleFocus() {
   if (fr.dockMax) fr.dock[fr.dest] = true;
   setState({});
 }
+/* Dock size: set the dock to one of four preset sizes, or to focus mode.
+ * Normal: default width (no CSS override). Half: 50vw. Two-thirds: 66.667vw (the body spans the window).
+ * Focus: the dock takes the whole window (same as toggleFocus). */
+const DOCK_SIZE_KEY = 'pmos.workspace.pm.dock-size';
+const DOCK_SIZES = ['normal', 'half', 'two-thirds'];
+function readDockSize() {
+  if (!FRAME) return null;
+  let v = null;
+  try { v = localStorage.getItem(DOCK_SIZE_KEY) || null; } catch { v = null; }
+  return v === 'half' || v === 'two-thirds' ? v : null;
+}
+function setDockSize(next) {
+  if (!FRAME) return;
+  if (next === 'whole') {
+    if (!fr.dockMax) toggleFocus();
+    return;
+  }
+  if (!DOCK_SIZES.includes(next)) return;
+  // A preset replaces a dragged pixel width, and leaving focus returns to the size chosen here.
+  fr.dockW = null;
+  try { localStorage.removeItem(DOCK_W_KEY); } catch { /* private mode */ }
+  fr.dockSize = next === 'normal' ? null : next;
+  try { if (fr.dockSize) localStorage.setItem(DOCK_SIZE_KEY, fr.dockSize); else localStorage.removeItem(DOCK_SIZE_KEY); } catch { /* private mode */ }
+  fr.dockMax = false;
+  fr.dock[fr.dest] = true;
+  paintDockWidth();
+  setState({});
+}
 /* The dock's width, chosen with the grip (0.53.1). Kept in this browser like the dock's other per-window choices;
  * null is the default width. */
 const DOCK_W_KEY = 'pmos.workspace.pm.dock-width';
@@ -457,12 +485,21 @@ const dockWidth = {
   get: () => fr.dockW,
   set: (px) => {
     fr.dockW = Number.isFinite(px) && px > 0 ? Math.round(px) : null;
+    fr.dockSize = null;   // dragging the grip, or a double-click, replaces a preset
     try { if (fr.dockW) localStorage.setItem(DOCK_W_KEY, String(fr.dockW)); else localStorage.removeItem(DOCK_W_KEY); } catch { /* private mode */ }
+    if (!fr.dockSize) try { localStorage.removeItem(DOCK_SIZE_KEY); } catch { /* private mode */ }
     paintDockWidth();
   },
 };
 function paintDockWidth() {
-  const v = fr.dockW ? fr.dockW + 'px' : '';
+  let v = '';
+  if (fr.dockW) {
+    v = fr.dockW + 'px';
+  } else if (fr.dockSize === 'half') {
+    v = '50vw';
+  } else if (fr.dockSize === 'two-thirds') {
+    v = '66.667vw';
+  }
   if (bodyGrid.style.getPropertyValue('--fr-dock-w') !== v) {
     if (v) bodyGrid.style.setProperty('--fr-dock-w', v); else bodyGrid.style.removeProperty('--fr-dock-w');
   }
@@ -574,6 +611,7 @@ function setupFrame() {
   document.addEventListener('pointerdown', (e) => { fr.downAt = e.target; }, true);
   dockRail = createDockRail({ open: openDock, resize: dockWidth });
   fr.dockW = readDockW();
+  fr.dockSize = readDockSize();
   frDetail = el('div', { class: 'fr-detail', 'data-fr': 'detail' },
     el('div', { class: 'fr-detail__bar' }, iconButton({ icon: 'x', ariaLabel: FC.detail.close, onClick: closeDetail, attrs: { 'data-fr': 'detail-close' } })),
     hostDetail);
@@ -712,9 +750,9 @@ function frameKey(e) {
 
 /* What the suites and the phone chrome reach the frame by. */
 const frameApi = {
-  on: true, go, toggleDock, foldDock, openDock, toggleFocus, dockWidth, chooseRepo, chooseAll, openPalette, repoMenu, openBranchesSheet, closeDetail, sync: runSync,
+  on: true, go, toggleDock, foldDock, openDock, toggleFocus, setDockSize, dockWidth, chooseRepo, chooseAll, openPalette, repoMenu, openBranchesSheet, closeDetail, sync: runSync,
   get unsynced() { return !!fr.unsynced; },
-  get dest() { return fr.dest; }, get scope() { return fr.scope; }, get dockOpen() { return dockOpen(); }, get dockMax() { return !!fr.dockMax; },
+  get dest() { return fr.dest; }, get scope() { return fr.scope; }, get dockOpen() { return dockOpen(); }, get dockMax() { return !!fr.dockMax; }, get dockSize() { return fr.dockSize || 'normal'; },
   get detailOpen() { return !!state.col2; }, get syncing() { return fr.syncing; }, get needs() { return fr.needs || 0; },
 };
 

package/workspace/public/pm/components.css

@@ -652,6 +652,16 @@
   white-space: nowrap;
   cursor: pointer;
 }
+/* The shortcut hint sits at a row's end; a checked row (a menuitemradio) is marked. */
+.pmc-menu__hint {
+  margin-left: auto;
+  padding-left: 16px;
+  color: var(--muted-foreground);
+  font: 11px var(--mono);
+}
+.pmc-menu__item[aria-checked="true"] {
+  background: var(--muted);
+}
 .pmc-menu__item--danger {
   color: var(--destructive);
 }

package/workspace/public/pm/dock.js

@@ -9,8 +9,8 @@
  *   createDockRail({ open, resize })     the 44px rail: one control that opens the dock. While the dock is open the rail
  *                                         is a thin grip on the dock's left edge that resizes it (0.53.1)
  *   foldButton({ fold })                  the control in the open dock's strip that folds it back to the rail
- *   focusButton({ toggle }) / paintFocus(b, on)
- *                                         Focus: the dock takes the whole window, and Exit focus gives the page back (0.53.1)
+ *   dockSizeButton({ setSize, getState }) / paintDockSize(b, size, inFocus)
+ *                                         Dock size menu: Normal, Half, Two-thirds, Whole window (focus; 0.53.1, folded into the menu later)
  *   sessionMenuButton({ open, ws })      "＋ Session": opens the new-session sheet (dock-sessions.js): a blank
  *                                         session or a skill to start from (R10; one list since 0.55.1)
  *   sessionDefaults() / setSessionDefaults(patch)
@@ -23,7 +23,7 @@
 import { el } from './dom.js';
 import { FIXTURE } from './state.js';
 import { pmGet } from './http.js';
-import { button, iconButton } from './primitives.js';
+import { button, iconButton, menu } from './primitives.js';
 import { icon } from './icons.js';
 import { COPY } from './frame-copy.js';
 
@@ -103,19 +103,59 @@ const endDrag = () => { if (drag) { drag.g.removeAttribute('data-dragging'); dra
 window.addEventListener('pointerup', endDrag);
 window.addEventListener('pointercancel', endDrag);
 
-/* 0.55.1: icon only (the PM asked for no label): maximize-2 to focus, minimize-2 to leave; the name is the aria-label. */
-export function focusButton({ toggle } = {}) {
-  return iconButton({ icon: 'maximize-2', ariaLabel: COPY.dock.focusTitle, onClick: () => toggle && toggle(),
-    attrs: { class: 'fr-dock-focus', 'data-fr': 'dock-focus', 'aria-pressed': 'false', 'aria-keyshortcuts': 'Meta+Shift+J Control+Shift+J' } });
+/* Dock size menu: Normal, Half, Two-thirds, or Whole window (focus). It replaces the old Focus button; focus is its last row
+ * and keeps ⌘⇧J. The button shows the current size; the menu is built on each press, so it always shows the current choice. */
+const SVG_NS = 'http://www.w3.org/2000/svg';
+const SIZE_SHARE = { normal: 7, half: 9, 'two-thirds': 12 };   // width of the filled part of the glyph, out of 18
+/** A small window glyph with the dock's share filled on the right. Own SVG: the vendored sprite has no such symbol. */
+function sizeGlyph(size) {
+  const svg = icon('square');   // the primitive's own <svg> (class, size, aria-hidden); its symbol is replaced below
+  svg.replaceChildren();
+  svg.setAttribute('viewBox', '0 0 24 24');
+  svg.setAttribute('fill', 'none');
+  svg.setAttribute('stroke', 'currentColor');
+  svg.setAttribute('stroke-width', '2');
+  svg.setAttribute('data-icon', 'dock-' + size);
+  const frame = document.createElementNS(SVG_NS, 'rect');
+  for (const [k, v] of Object.entries({ x: 3, y: 5, width: 18, height: 14, rx: 2 })) frame.setAttribute(k, String(v));
+  const fill = document.createElementNS(SVG_NS, 'rect');
+  const w = SIZE_SHARE[size] || SIZE_SHARE.normal;
+  for (const [k, v] of Object.entries({ x: 21 - w, y: 5, width: w, height: 14 })) fill.setAttribute(k, String(v));
+  fill.setAttribute('fill', 'currentColor');
+  fill.setAttribute('stroke', 'none');
+  svg.append(frame, fill);
+  return svg;
 }
-/** Show the Focus control's state: pressed while the dock has the whole window. */
-export function paintFocus(b, on) {
+const sizeNode = (size, inFocus) => (inFocus ? icon('minimize-2') : sizeGlyph(size || 'normal'));
+
+export function dockSizeButton({ setSize, getState } = {}) {
+  return iconButton({ icon: 'maximize-2', ariaLabel: COPY.dock.dockSize,
+    attrs: { class: 'fr-dock-size', 'data-fr': 'dock-size', 'aria-haspopup': 'menu', 'aria-expanded': 'false', 'aria-keyshortcuts': 'Meta+Shift+J Control+Shift+J' },
+    onClick: (e) => {
+      const b = e.currentTarget;
+      const st = (getState && getState()) || {};
+      const cur = st.inFocus ? 'whole' : (st.size || 'normal');
+      const row = (id, label, hint, node) => ({
+        label, iconNode: node, hint, role: 'menuitemradio',
+        attrs: { 'data-size': id, 'aria-checked': cur === id ? 'true' : 'false' },
+        onSelect: () => setSize && setSize(id),
+      });
+      menu({ anchor: b, ariaLabel: COPY.dock.dockSizeMenu, items: [
+        row('normal', COPY.dock.sizeNormal, '', sizeGlyph('normal')),
+        row('half', COPY.dock.sizeHalf, '', sizeGlyph('half')),
+        row('two-thirds', COPY.dock.sizeTwoThirds, '', sizeGlyph('two-thirds')),
+        row('whole', COPY.dock.sizeWhole, '⌘⇧J', icon('maximize-2')),
+      ] });
+    } });
+}
+
+/** Show the button's glyph and name for the current size. */
+export function paintDockSize(b, size, inFocus) {
   if (!b) return;
-  const name = on ? 'minimize-2' : 'maximize-2';
+  const want = inFocus ? 'minimize-2' : 'dock-' + (size || 'normal');
   const cur = b.querySelector('[data-icon]');
-  if (!cur || cur.getAttribute('data-icon') !== name) b.replaceChildren(icon(name));
-  b.setAttribute('aria-pressed', on ? 'true' : 'false');
-  const label = on ? COPY.dock.unfocusTitle : COPY.dock.focusTitle;
+  if (!cur || cur.getAttribute('data-icon') !== want) b.replaceChildren(sizeNode(size, inFocus));
+  const label = inFocus ? COPY.dock.unfocusTitle : COPY.dock.dockSize;
   b.setAttribute('aria-label', label);
   b.title = label;
 }

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

@@ -62,6 +62,12 @@ export const COPY = {
     unfocus: 'Exit focus',
     focusTitle: 'Give the dock the whole window (⌘⇧J)',
     unfocusTitle: 'Show the page beside the dock again (⌘⇧J)',
+    dockSize: 'Dock size',
+    dockSizeMenu: 'Choose dock size',
+    sizeNormal: 'Normal',
+    sizeHalf: 'Half the window',
+    sizeTwoThirds: 'Two-thirds',
+    sizeWhole: 'Whole window (focus)',
     resize: 'Resize the agent dock. Drag, or use the left and right arrow keys. Double-click resets the width.',
     session: 'Session',
     sessionMenu: 'Start a session',

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

@@ -1152,11 +1152,14 @@ function frameDock() {
         open: () => (dsMod ? dsMod.openNewSessionSheet(currentProduct(), { initiative: null }) : newSession()),
       }),
       fold: dockParts ? dockParts.fold : dockMod.foldButton({ fold: () => window.pmApp.frame.foldDock() }),
-      focus: dockParts ? dockParts.focus : dockMod.focusButton({ toggle: () => window.pmApp.frame.toggleFocus() }),
+      size: dockParts ? dockParts.size : dockMod.dockSizeButton({
+        setSize: (sz) => window.pmApp.frame.setDockSize(sz),
+        getState: () => ({ size: window.pmApp.frame.dockSize, inFocus: !!window.pmApp.frame.dockMax }),
+      }),
     };
   }
-  if (isMobile()) return { session: dockParts.session, fold: null, focus: null, orient: null };
-  dockMod.paintFocus(dockParts.focus, !!window.pmApp.frame.dockMax);
+  if (isMobile()) return { session: dockParts.session, fold: null, size: null, orient: null };
+  dockMod.paintDockSize(dockParts.size, window.pmApp.frame.dockSize, !!window.pmApp.frame.dockMax);
   // the tabs-on-top / tabs-at-side switch, icon only in the frame (0.55.1); drawn per paint because its icon follows the mode
   // one element across paints, so the keyboard focus stays on it; only its icon and name follow the mode
   const v = !!state.tabsVertical;
@@ -1170,7 +1173,7 @@ function frameDock() {
   const olabel = v ? COPY.dock.topTabs : COPY.dock.sideTabs;
   dockOrient.setAttribute('aria-label', olabel);
   dockOrient.title = olabel;
-  return { session: dockParts.session, fold: dockParts.fold, focus: dockParts.focus, orient: dockOrient };
+  return { session: dockParts.session, fold: dockParts.fold, size: dockParts.size, orient: dockOrient };
 }
 
 /**
@@ -1395,7 +1398,7 @@ export function renderTabs(host) {
         newSessionOptsBtn,
         canSplit ? splitBtn : null,
         orientBtn,
-        fr ? fr.focus : null,
+        fr ? fr.size : null,
         fr ? fr.fold : null),
     ]);
   } else if (ck) {
@@ -1410,7 +1413,7 @@ export function renderTabs(host) {
     ].filter(Boolean);
     extras[0].style.marginLeft = 'auto';
     // The switch sits after `+ session`, so the strip still ends the mockup's way in the fixture, which does not draw it.
-    setChildren(tabBar, [...visTabs.map((t) => cockpitTabNode(t, act, splitTab)), ...extras, fr ? fr.session : newSessionBtn, FIXTURE ? null : orientBtn, fr ? fr.focus : null, fr ? fr.fold : null]);
+    setChildren(tabBar, [...visTabs.map((t) => cockpitTabNode(t, act, splitTab)), ...extras, fr ? fr.session : newSessionBtn, FIXTURE ? null : orientBtn, fr ? fr.size : null, fr ? fr.fold : null]);
   } else {
     tabBar.setAttribute('style', BAR_STYLE);
     newSessionBtn.setAttribute('style', CHIP_STYLE);
@@ -1437,11 +1440,11 @@ export function renderTabs(host) {
       ...dsMod.railNodes(ds, others.map((t) => dockTabRow(t, (act && act.id === t.id) || (splitTab && splitTab.id === t.id)))),
     ] : [
       ...dsMod.stripNodes(ds, others.map((t) => dockTabChip(t, (act && act.id === t.id) || (splitTab && splitTab.id === t.id)))),
-      state.splitId ? splitBtn : null, fr.orient, fr.focus, fr.fold,
+      state.splitId ? splitBtn : null, fr.orient, fr.size, fr.fold,
     ]);
   }
 
-  if (ck && ds && vertical) setChildren(dockHead, [fr.session, state.splitId ? splitBtn : null, fr.orient, fr.focus, fr.fold]);
+  if (ck && ds && vertical) setChildren(dockHead, [fr.session, state.splitId ? splitBtn : null, fr.orient, fr.size, fr.fold]);
   if (tabBar.scrollLeft !== keepX) tabBar.scrollLeft = keepX;
   if (tabBar.scrollTop !== keepY) tabBar.scrollTop = keepY;
   // When the tab in front changes, the bar scrolls just enough to show it, so a tab opened at the far end of a crowded strip or a

package/workspace/public/pm/primitives.js

@@ -354,9 +354,9 @@ export function menu({ anchor, items, ariaLabel } = {}) {
     if (it.sep) { node.appendChild(el('div', { class: 'pmc-menu__sep', role: 'separator' })); continue; }
     const b = el('button', {
       ...(it.attrs || {}),
-      type: 'button', role: 'menuitem', tabindex: '-1', class: cx('pmc-menu__item', it.danger && 'pmc-menu__item--danger'),
+      type: 'button', role: it.role || 'menuitem', tabindex: '-1', class: cx('pmc-menu__item', it.danger && 'pmc-menu__item--danger'),
       onClick: (e) => { e.stopPropagation(); close(false); if (it.onSelect) it.onSelect(); },
-    }, it.icon ? icon(it.icon) : null, el('span', null, it.label));
+    }, it.iconNode || (it.icon ? icon(it.icon) : null), el('span', null, it.label), it.hint ? el('kbd', { class: 'pmc-menu__hint' }, it.hint) : null);
     btns.push(b); node.appendChild(b);
   }
   node.addEventListener('toggle', (e) => { if (e.newState === 'closed') close(false); });