create-pmos 0.162.0 → 0.163.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.162.0",
+  "version": "0.163.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@4dfe5a0
+kernel-source: pmos@aa95af9
 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-12T09:50:47Z"}
+generated: {by: process:create-pmos, at: "2026-10-12T10:13:23Z"}
 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-12T09:50:47Z"}
+generated: {by: process:create-pmos, at: "2026-10-12T10:13:23Z"}
 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-12T09:50:47Z"}
+generated: {by: process:create-pmos, at: "2026-10-12T10:13:23Z"}
 status: stable
 ---
 

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

@@ -110,6 +110,55 @@ function startShell(name) {
   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')));
 
+  /* ── G: the scratchpad and the size control on the terminal sheet (c3-term-pad-size) ── */
+  await page.evaluate((i) => window.dispatchEvent(new CustomEvent('pmos:open-session', { detail: { id: i } })), id);
+  const g0 = await waitFor(page, (i) => !!document.querySelector(`[data-c3-session-term="${i}"] .xterm`), id);
+  ok('G0 the terminal sheet opens for the pad checks', g0 || !!(await page.$('[data-c3-size-seg]')));
+  const sizes = await page.$$eval('[data-c3-size-seg] [data-c3-size]', (b) => b.map((x) => x.dataset.c3Size));
+  ok('G1 the size control has 4 options', sizes.join() === 'normal,half,two-thirds,whole', sizes.join());
+  const vw = await page.evaluate(() => window.innerWidth);
+  const wid = () => page.evaluate(() => document.querySelector('[data-shell="sheet"] .sheet').getBoundingClientRect().width);
+  ok('G2 Normal is the 600px sheet', Math.abs((await wid()) - 600) < 2, String(await wid()));
+  await page.click('[data-c3-size="half"]');
+  await sleep(200);
+  ok('G3 Half makes the sheet half of the window', Math.abs((await wid()) - vw / 2) < 3, (await wid()) + ' of ' + vw);
+  ok('G3b Half is shown as pressed', await page.evaluate(() => document.querySelector('[data-c3-size="half"]').getAttribute('aria-pressed') === 'true'));
+  await page.click('[data-c3-size="whole"]');
+  await sleep(200);
+  ok('G3c Whole fills the window minus the margins', Math.abs((await wid()) - (vw - 24)) < 3, String(await wid()));
+  await page.click('[data-c3-size="half"]');
+  await page.click('[data-shell="sheet"] [aria-label="Close"]');
+  await waitFor(page, () => !document.querySelector('[data-c3-session-term]'));
+  await page.evaluate((i) => window.dispatchEvent(new CustomEvent('pmos:open-session', { detail: { id: i } })), id);
+  await waitFor(page, (i) => !!document.querySelector(`[data-c3-session-term="${i}"] .xterm`), id);
+  await sleep(200);
+  ok('G4 the size choice is kept after closing and opening again', Math.abs((await wid()) - vw / 2) < 3, String(await wid()));
+  ok('G4b it is kept in localStorage', await page.evaluate(() => localStorage.getItem('pmos.workspace.c3.term-size') === 'half'));
+  const termH = await page.evaluate(() => document.querySelector('[data-c3-session-term]').getBoundingClientRect().height);
+  ok('G5 the terminal has room above the scratchpad', termH > 120 && await page.evaluate(() => { const t = document.querySelector('[data-c3-session-term]').getBoundingClientRect(); const p = document.querySelector('[data-c3-pad="box"]').getBoundingClientRect(); return t.bottom <= p.top + 1; }));
+  await page.fill('[data-c3-pad="text"]', 'echo from-the-pad-7');
+  ok('G6 typing in the pad saves it for the session', !!(await until(async () => (await get('/api/scratchpad?session=' + id)).text === 'echo from-the-pad-7', 4000)));
+  await page.click(`[data-c3-session-term="${id}"] .xterm`);
+  await page.keyboard.press('Backspace');   // the Esc in C3 left the shell's readline waiting for a meta key: this key answers it
+  await page.fill('[data-c3-pad="text"]', 'echo from-the-pad-7');
+  await page.click('[data-c3-pad="send"]');
+  await sleep(800);
+  const noEnter = !/^from-the-pad-7/m.test((await get('/api/sessions/transcript?id=' + id + '&max=4000')).text || '');
+  await page.click(`[data-c3-session-term="${id}"] .xterm`);
+  await page.keyboard.press('Enter');
+  ok('G7 Send to terminal types the text into the session, without pressing Enter', noEnter && !!(await until(async () => /^from-the-pad-7/m.test((await get('/api/sessions/transcript?id=' + id + '&max=4000')).text || ''), 8000)));
+  await page.fill('[data-c3-pad="text"]', 'flushed-on-close');
+  await page.click('[data-shell="sheet"] [aria-label="Close"]');
+  ok('G8 closing the sheet saves a pad edit at once', !!(await until(async () => (await get('/api/scratchpad?session=' + id)).text === 'flushed-on-close', 2000)));
+  await page.evaluate((i) => window.dispatchEvent(new CustomEvent('pmos:open-session', { detail: { id: i } })), id);
+  await waitFor(page, () => !!document.querySelector('[data-c3-pad="text"]'));
+  ok('G9 the pad loads its text when the terminal opens again', await waitFor(page, () => document.querySelector('[data-c3-pad="text"]').value === 'flushed-on-close'));
+  await page.click('[data-c3-pad="toggle"]');
+  ok('G10 the toggle hides the pad and the terminal gets the room', await page.evaluate(() => document.querySelector('[data-c3-pad="text"]').hidden === true && localStorage.getItem('pmos.workspace.c3.term-pad') === 'closed'));
+  await page.click('[data-c3-pad="toggle"]');
+  await page.click('[data-shell="sheet"] [aria-label="Close"]');
+  await waitFor(page, () => !document.querySelector('[data-c3-session-term]'));
+
   /* ── 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));

package/workspace/guide/console3-sessions.md

@@ -44,6 +44,18 @@ If the server finds that the process of a session stopped (for example, after a
 
 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 scratchpad
+
+Below the terminal is a scratchpad. It keeps text for this session only. The text is saved on this machine as you type, and it is there when you open the terminal again.
+
+- To send the text to the session, press **Send to terminal**. The text is typed into the terminal. Enter is not pressed, so you can read it and press Enter yourself.
+- To hide the pad, press **Scratchpad** above it. The text is kept. The terminal gets the room back. The page remembers if the pad was hidden.
+- Esc in the pad closes the panel. Esc in the terminal goes to the terminal.
+
+### The size of the terminal
+
+Four buttons in the header of the panel set its width: **Normal**, **Half**, **2/3** and **Whole**. Half is half of the window. 2/3 is two thirds of the window. Whole is the full window. The terminal fits the new size. The page remembers your choice for the next terminal you open. On a phone the panel is already full width, so the buttons are not shown.
+
 The **Open the session** link in the sessions dock opens the same panel.
 
 ## Send a message to a session

package/workspace/package-lock.json

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

package/workspace/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmos-workspace",
-  "version": "0.162.0",
+  "version": "0.163.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-session-term.js

@@ -6,7 +6,21 @@
 import { el } from './dom.js';
 import { openSheet } from './c3-sheet.js';
 import { toast } from './c3-toast.js';
-import { pmGet } from './http.js';
+import { pmGet, pmPost } from './http.js';
+import { button } from './primitives.js';
+import { c3ic } from './pm-work-view.js';
+
+/* a primitives button (keyboard, role) carrying the console3 look and children (the pattern c3-dock.js uses) */
+const c3btn = (attrs, onClick, ...kids) => { const b = button({ variant: 'ghost', attrs, onClick }); b.replaceChildren(...kids); return b; };
+const store = {
+  get(k) { try { return localStorage.getItem(k); } catch { return null; } },
+  set(k, v) { try { localStorage.setItem(k, v); } catch { /* no storage */ } },
+};
+export const SIZE_KEY = 'pmos.workspace.c3.term-size';
+export const PAD_KEY = 'pmos.workspace.c3.term-pad';
+/* the sheet widths: Normal is the 600px wide sheet; the others are classes in console3.css (desktop only) */
+export const SIZES = [['normal', 'Normal', 'Normal'], ['half', 'Half', 'Half of the window'], ['two-thirds', '2/3', 'Two-thirds of the window'], ['whole', 'Whole', 'Whole window']];
+export const sizeOf = (v) => (SIZES.some((x) => x[0] === v) ? v : 'normal');
 
 const VENDOR = ['/vendor/xterm.js', '/vendor/addon-fit.js', '/vendor/addon-web-links.js'];
 let vendor = null;
@@ -29,6 +43,43 @@ function loadVendor() {
   return vendor;
 }
 
+/* the scratchpad under the terminal: the classic app's per-session pad (panel-tabs.js), kept through /api/scratchpad */
+function makePad(id, term, tab) {
+  const url = '/api/scratchpad?session=' + encodeURIComponent(id);
+  let typed = false; let timer = null; let pending = null; let closed = false;
+  const flush = () => {
+    if (timer) { clearTimeout(timer); timer = null; }
+    if (pending === null) return;
+    const text = pending; pending = null;
+    pmPost('/api/scratchpad', { session: id, text }).catch(() => { /* the text stays in the box */ });
+  };
+  const ta = el('textarea', { class: 'c3t-pad-ta', rows: '4', placeholder: 'Scratchpad. One pad for each session. Saved on this machine.', 'aria-label': 'Scratchpad', 'data-c3-pad': 'text',
+    oninput: () => { typed = true; pending = ta.value; if (timer) clearTimeout(timer); timer = setTimeout(flush, 500); sync(); } });
+  const send = c3btn({ class: 'pill', 'data-c3-pad': 'send', title: 'Type the pad into this session. Enter is not pressed.' }, () => {
+    if (!ta.value.trim()) return;
+    if (!term.sendToTerm(tab, ta.value)) { toast({ text: 'The text was not sent. The terminal is not connected.', tone: 'error' }); return; }
+    if (typeof term.focusTerm === 'function') term.focusTerm(tab);
+  }, c3ic('out', 'sm'), 'Send to terminal');
+  const open0 = store.get(PAD_KEY) !== 'closed';
+  const box = el('div', { class: 'c3t-pad', 'data-c3-pad': 'box' });
+  const toggle = c3btn({ class: 'chip2 lk', 'data-c3-pad': 'toggle' }, () => { const on = box.dataset.open !== 'true'; store.set(PAD_KEY, on ? 'open' : 'closed'); set(on); },
+    c3ic('edit', 'sm'), 'Scratchpad');
+  function set(on) {
+    box.dataset.open = String(on);
+    toggle.setAttribute('aria-expanded', String(on));
+    toggle.title = on ? 'Hide the scratchpad. The text is kept.' : 'Show the scratchpad';
+    ta.hidden = !on;
+    requestAnimationFrame(() => term.refitVisible());
+  }
+  function sync() { send.disabled = !ta.value.trim(); }
+  box.append(el('div', { class: 'c3t-pad-h' }, toggle, send), ta);
+  set(open0); sync();
+  pmGet(url).then((r) => { if (!typed && r && typeof r.text === 'string') { ta.value = r.text; sync(); } }).catch(() => { /* an empty pad */ });
+  const onHide = () => flush();
+  window.addEventListener('pagehide', onHide);
+  return { box, ta, dispose() { if (closed) return; closed = true; window.removeEventListener('pagehide', onHide); flush(); } };
+}
+
 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; }
@@ -36,8 +87,23 @@ export async function openSessionTerm({ id, name } = {}) {
   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) });
+  const pad = makePad(id, term, tab);
+  const wrap = el('div', { class: 'c3t-tw' }, host, pad.box);
+  // the size control: Normal is the 600px sheet, the others are the classic dock's presets. Hidden on a phone, where the sheet is full width.
+  let size = sizeOf(store.get(SIZE_KEY));
+  const sizeBtns = SIZES.map(([k, label, title]) => c3btn({ 'aria-pressed': String(k === size), 'data-c3-size': k, title, 'aria-label': title }, () => setSize(k), label));
+  const seg = el('div', { class: 'seg c3t-size', role: 'group', 'aria-label': 'Terminal size', 'data-c3-size-seg': '' }, ...sizeBtns);
+  const cls = (k) => 'tsz-' + k;
+  // 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.
+  // The scratchpad is outside the terminal host, so its keys are the page's own.
+  const sheet = openSheet({ title: name || id, icon: 'term', wide: true, body: wrap, actions: seg, cls: cls(size),
+    onClose: () => { pad.dispose(); term.disposeTerm(tab); }, passKeys: (e) => host.contains(e.target) });
+  function setSize(k) {
+    sheet.sheet.classList.remove(cls(size)); size = sizeOf(k); sheet.sheet.classList.add(cls(size));
+    store.set(SIZE_KEY, size);
+    sizeBtns.forEach((b) => b.setAttribute('aria-pressed', String(b.dataset.c3Size === size)));
+    requestAnimationFrame(() => { term.refitVisible(); requestAnimationFrame(() => term.refitVisible()); });
+  }
   term.mountTerm(host, tab);
   requestAnimationFrame(() => { term.refitVisible(); term.focusTerm(tab); });
   return sheet;

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

@@ -1,7 +1,8 @@
 /* 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, passKeys }) -> { close, root, sheet, body }   passKeys(e): true leaves that key to the page
+ *   openSheet({ title, icon, body, wide, dw, scrim, onClose, passKeys, actions, cls }) -> { close, root, sheet, body }   passKeys(e): true leaves that key to the page
+ *                                                          actions: a Node or an array of Nodes placed in the header before the close button; cls: extra class names on the sheet
  *   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 +51,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, passKeys } = {}) {
+export function openSheet({ title = '', icon = 'doc', body, wide = false, dw = false, scrim = true, onClose, passKeys, actions, cls = '' } = {}) {
   closeSheet();
   ensureC3Css();
   const opener = document.activeElement && document.activeElement !== document.body ? document.activeElement : null;
@@ -60,8 +61,8 @@ export function openSheet({ title = '', icon = 'doc', body, wide = false, dw = f
   const sbb = el('div', { class: 'brief sbb' }, ...bodyNodes(body));
   const closeBtn = el('button', { type: 'button', class: 'ib sm', 'aria-label': 'Close', title: 'Close (Esc)', onclick: close }, c3ic('x', 'sm'));
   const grab = el('div', { class: 'grab' });
-  const head = el('div', { class: 'sh2' }, el('span', { class: 'chips2' }, c3ic(icon), el('b', null, title)), el('span', { class: 'chips2' }, closeBtn));
-  const sheet = el('div', { class: 'sheet bs' + (wide ? ' wide' : '') + (dw ? ' dw' : ''), role: 'dialog', 'aria-modal': String(!!scrim), 'aria-label': title, tabindex: '-1' },
+  const head = el('div', { class: 'sh2' }, el('span', { class: 'chips2' }, c3ic(icon), el('b', null, title)), el('span', { class: 'chips2' }, ...bodyNodes(actions), closeBtn));
+  const sheet = el('div', { class: 'sheet bs' + (wide ? ' wide' : '') + (dw ? ' dw' : '') + (cls ? ' ' + cls : ''), role: 'dialog', 'aria-modal': String(!!scrim), 'aria-label': title, tabindex: '-1' },
     grab, head, el('div', { class: 'sb' }, sbb));
   /* the mockup's person and playbooks sheets have no scrim (they are panels beside the page, closed by their own button or Esc): `scrim: false` */
   root.append(...(scrim ? [el('div', { class: 'scrim', onclick: close })] : []), sheet);

package/workspace/public/pm/console3.css

@@ -1660,6 +1660,22 @@
 .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}
+/* the terminal plus its scratchpad (c3-session-term.js): the terminal shrinks to make room for the pad */
+.c3 .c3t-tw{height:calc(100vh - 150px);min-height:240px;display:flex;flex-direction:column;gap:var(--sp-2);min-width:0}
+.c3 .c3t-tw .c3t-term{height:auto;flex:1 1 0;min-height:120px}
+.c3 .c3t-pad{display:grid;gap:var(--sp-2);flex:none;border-top:1px solid var(--border);padding-top:var(--sp-2)}
+.c3 .c3t-pad-h{display:flex;gap:var(--sp-2);align-items:center;justify-content:space-between}
+.c3 .c3t-pad-h .pill:disabled{opacity:.35;cursor:not-allowed}
+.c3 .c3t-pad-ta{width:100%;min-height:72px;max-height:40vh;resize:vertical;font:var(--fs-2) var(--mono);box-sizing:border-box}
+/* terminal sheet sizes, as the classic dock has them; the phone sheet is already full width */
+.c3 .c3t-size{flex:none}
+.c3 .c3t-size button{padding:4px 8px}
+.c3.ph .c3t-size{display:none}
+@media (min-width:761px){
+  .c3 .sheet.wide.tsz-half{width:50vw}
+  .c3 .sheet.wide.tsz-two-thirds{width:66.667vw}
+  .c3 .sheet.wide.tsz-whole{width:calc(100vw - 24px)}
+}
 .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)}