create-pmos 0.63.1 → 0.63.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.63.1",
+  "version": "0.63.2",
   "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@4cf3dc9
+kernel-source: pmos@586dc2f
 assembled: 2026-10-06
 mode: vendor

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

@@ -2,7 +2,7 @@
 type: Reference
 title: "Eval calibration log"
 description: "Append-only record of every PM override of an evaluator verdict."
-generated: {by: process:create-pmos, at: "2026-10-06T22:58:51Z"}
+generated: {by: process:create-pmos, at: "2026-10-06T23:17:22Z"}
 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-06T22:58:51Z"}
+generated: {by: process:create-pmos, at: "2026-10-06T23:17:22Z"}
 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-06T22:58:51Z"}
+generated: {by: process:create-pmos, at: "2026-10-06T23:17:22Z"}
 status: stable
 ---
 

package/workspace/guide/layout.md

@@ -119,6 +119,8 @@ Every row has a visible ⋯ button. Every control is at least 44 pixels high. No
 
 You can have the same session open on your phone and your computer. A session has one size, so the screen you type in or tap last sets it. The other screen keeps showing the session and takes the size back as soon as you type in it.
 
+On an iPhone or an iPad, the terminal gets smaller when the keyboard opens, so the agent's prompt stays above the keyboard. Tapping the terminal does not zoom the page, and dragging at its top or bottom does not pull or reload the page. A swipe from the left edge of the screen is Safari's Back gesture and leaves the workspace. To avoid that, add the workspace to your Home Screen and open it from there.
+
 ## The older layout
 
 The address options `?layout=legacy` and `?fixture=cockpit` keep the older layouts. The rest of this page describes them. In the cockpit, the workspace has four columns: the repository rail, the list, the detail and the tabs. With `?layout=legacy` it has three columns: navigation, detail and tabs.

package/workspace/package-lock.json

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

package/workspace/package.json

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

package/workspace/public/pm/mobile.css

@@ -43,6 +43,7 @@
     border-left: 1px solid var(--border);
     border-right: 1px solid var(--border);
   }
+  html.pm-vv body { height: var(--fr-vvh, 100vh); }
 
   /* Explicit placement, never auto-placement: app.js appends its root LAST, so source order would
    * put the screen underneath the bottom nav. */
@@ -363,3 +364,19 @@
 .mob[hidden], .mobmenu[hidden], .mob-back[hidden], .mob-brand[hidden] { display: none !important; }
 .mob-repo[hidden], .mob-set[hidden], .mob-sync[hidden], .mob-theme[hidden], .mobnav-n[hidden] { display: none !important; }
 .mob-deck[hidden], .mob-pager[hidden], .mob-deck__views[hidden] { display: none !important; }
+
+/* ── a touch screen: the visible height, no page bounce, no zoom on focus ─────────────────────
+ * pm/mobile.js sets `pm-vv` and `--fr-vvh` (the visual viewport's height) on a touch screen. The
+ * page is that tall, so the soft keyboard sits under the terminal and does not cover it. Above the
+ * breakpoint (an iPad) that is app.js's root; at the breakpoint and below it is <body>, in the phone rules above.
+ * A drag at the top or bottom of the terminal does not pull the page or reload it. Every rule here
+ * needs `pm-vv`, so a desktop with a mouse is untouched. */
+html.pm-vv, html.pm-vv body { overscroll-behavior: none; }
+html.pm-vv { -webkit-text-size-adjust: 100%; text-size-adjust: 100%; }
+@media (min-width: 761px) {
+  html.pm-vv body > [data-pm-theme] { height: var(--fr-vvh, 100vh) !important; }
+}
+/* xterm types through a hidden textarea and gives it the terminal's 12.5px font. iOS zooms the
+ * page in on a focused field under 16px, which pushes the terminal off the side of the screen. The
+ * textarea is invisible, so its size changes nothing else. */
+html.pm-vv .xterm .xterm-helper-textarea { font-size: 16px !important; }

package/workspace/public/pm/mobile.js

@@ -475,13 +475,42 @@ function onChromeClick(e) {
 
 /* The terminal has to re-measure when the soft keyboard shows or hides and after a rotation, or
  * xterm keeps the row count it had and the bottom of the session is clipped. The fit itself belongs
- * to the terminal panel; this only tells it that the box changed. */
+ * to the terminal panel; this only tells it that the box changed. It calls the terminal's refit
+ * directly: a synthetic window `resize` also re-lays the card deck and the report slides. */
 function refit() {
   const t = window.pmTerm;
-  if (t && typeof t.fit === 'function') { try { t.fit(); return; } catch { /* fall through */ } }
+  if (t && typeof t.refitVisible === 'function') { try { t.refitVisible(); return; } catch { /* fall through */ } }
   window.dispatchEvent(new Event('resize'));
 }
 
+/* ── the visible height, on a touch screen ───────────────────────────────────────────────────
+ * iOS does not shrink the page when the soft keyboard opens. `100vh` stays the full screen, the
+ * keyboard covers its bottom, and that bottom is where the agent's prompt and the control keys
+ * are. Safari then scrolls the page to show the focused field, so the screen jumps. And with
+ * Safari's toolbar shown, `100vh` is already taller than what is visible.
+ *
+ * So on a touch screen the page height is the VISUAL viewport's: `--fr-vvh` on <html>, read by
+ * pm/mobile.css, with the page held at the top. A pinch zoom also changes the visual viewport, and
+ * that is not the page getting smaller, so the height is in layout pixels (height × scale). */
+const TOUCH = window.matchMedia('(hover: none) and (pointer: coarse)');
+let vvh = 0;
+
+function fitViewport() {
+  const vv = window.visualViewport;
+  const root = document.documentElement;
+  if (!vv || !TOUCH.matches) {
+    if (root.classList.contains('pm-vv')) { root.classList.remove('pm-vv'); vvh = 0; refit(); }
+    return;
+  }
+  root.classList.add('pm-vv');
+  if (window.scrollY || window.scrollX) window.scrollTo(0, 0);
+  const h = Math.round(vv.height * (vv.scale || 1));
+  if (!h || h === vvh) return;
+  vvh = h;
+  root.style.setProperty('--fr-vvh', h + 'px');
+  refit();
+}
+
 /* ── mount ──────────────────────────────────────────────────────────────────────────────────── */
 
 /**
@@ -515,10 +544,12 @@ export function mountMobile(context) {
   document.addEventListener('click', onChromeClick);
 
   if (window.visualViewport) {
-    window.visualViewport.addEventListener('resize', refit);
-    window.visualViewport.addEventListener('scroll', refit);
+    window.visualViewport.addEventListener('resize', fitViewport);
+    window.visualViewport.addEventListener('scroll', fitViewport);
   }
-  window.addEventListener('orientationchange', () => setTimeout(refit, 250));
+  if (TOUCH.addEventListener) TOUCH.addEventListener('change', fitViewport);
+  window.addEventListener('orientationchange', () => setTimeout(() => { fitViewport(); refit(); }, 250));
+  fitViewport();
 
   // Crossing the breakpoint (rotate a tablet, drag a window narrow) has to re-decide whether the
   // phone shell exists at all AND repaint the panels — a shell left mounted above 760px is a second

package/workspace/public/pm/tab-term.js

@@ -699,6 +699,18 @@ function syncSize(rec, claim) {
   if (send({ t: 'resize', id: rec.sessionId, cols, rows })) { rec.sentCols = cols; rec.sentRows = rows; }
 }
 
+/**
+ * State a grid that a refit changed, once the box stops moving. A phone's soft keyboard and a
+ * rotation move the box several times in a few hundred milliseconds, and every grid the PTY hears
+ * makes the agent redraw its whole frame. Typing still sends at once: `onData` calls syncSize
+ * before the keystroke, which states the latest grid and makes the queued call a no-op.
+ */
+const SIZE_SETTLE_MS = 120;
+function queueSize(rec) {
+  clearTimeout(rec.sizeTimer);
+  rec.sizeTimer = setTimeout(() => { rec.sizeTimer = null; syncSize(rec, true); }, SIZE_SETTLE_MS);
+}
+
 /** Write a status line into the terminal itself — once per distinct message, dimmed. */
 function note(rec, line, force) {
   if (!rec.term) return;
@@ -726,8 +738,9 @@ export function refitVisible() {
       try { rec.fit.fit(); } catch { /* a terminal mid-teardown */ }
       // …and state the resulting grid to the PTY. `fit()` only fires xterm's `onResize` when the
       // grid MOVES, so a pane that was measured before it had a session would otherwise never tell
-      // the shell how wide it is. See the `attached` handler.
-      syncSize(rec);
+      // the shell how wide it is. See the `attached` handler. A grid change the fit just queued
+      // (see queueSize) goes out when the box settles, not here.
+      if (!rec.sizeTimer) syncSize(rec);
     }
   };
   if (typeof requestAnimationFrame === 'function') requestAnimationFrame(run);
@@ -891,12 +904,12 @@ function buildReal(tab) {
   term.attachCustomKeyEventHandler((e) => !((e.metaKey || e.ctrlKey) && (e.key === 'k' || e.key === 'K')));
 
   const rec = {
-    kind: 'real', tab, host, term, fit, sessionId: null, attachedId: null, noted: null, ro: null,
+    kind: 'real', tab, host, term, fit, sessionId: null, attachedId: null, noted: null, ro: null, sizeTimer: null,
   };
   // Typing, focusing or re-sizing THIS pane takes the session's grid back from another screen, and
   // the grid goes out before the keystroke so the agent answers it at this pane's size.
   term.onData((d) => { if (rec.sessionId) { syncSize(rec, true); send({ t: 'input', id: rec.sessionId, data: d }); } });
-  term.onResize(() => syncSize(rec, true));
+  term.onResize(() => queueSize(rec));
   host.addEventListener('focusin', () => syncSize(rec, true));
   if (typeof ResizeObserver === 'function') {
     rec.ro = new ResizeObserver(() => refitVisible());
@@ -951,6 +964,7 @@ export function disposeTerm(tab) {
    * pane for the id and detaches from the orphan instead. */
   if (rec.kind !== 'real') return;
   if (rec.ro) { try { rec.ro.disconnect(); } catch { /* ignore */ } }
+  clearTimeout(rec.sizeTimer);
   if (rec.sessionId) {
     send({ t: 'detach', id: rec.sessionId });
     SOCK.attached.delete(rec.sessionId);