create-pmos 0.91.0 → 0.92.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.91.0",
+  "version": "0.92.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@0d48046
+kernel-source: pmos@cd7797a
 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:57:59Z"}
+generated: {by: process:create-pmos, at: "2026-10-07T18:14:04Z"}
 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:57:59Z"}
+generated: {by: process:create-pmos, at: "2026-10-07T18:14:04Z"}
 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:57:59Z"}
+generated: {by: process:create-pmos, at: "2026-10-07T18:14:04Z"}
 status: stable
 ---
 

package/workspace/guide/layout.md

@@ -50,7 +50,7 @@ The dock holds your terminals, documents, conversations, skills and web pages. I
 
 - Press ⌘J (Ctrl-J), or the button on the rail, to open the dock. Press ⌘J again, or the fold button in the dock, to fold it to the rail.
 - The dock never opens by itself. A tab that opens while the dock is a rail waits in the dock until you open it.
-- The dock lists the sessions of the repository by initiative. A session is in the group of the initiative it is recorded on, or of its `initiative/<id>` branch. Then come **Not linked** (no initiative) and **Automatic** (anything you did not start yourself, for example a schedule, the day run, a note's summary or bullets, or a Jira push). **Automatic** is hidden until you press **Show automatic** at the foot of the list (or beside the group select in the strip). A session in front, or one held on a permission question, is always shown. An agent that has finished and reads "needs you" is hidden like the rest. Finished automatic sessions remove themselves a minute after a clean exit, and one with no output for 60 minutes is ended and removed. A failed one stays. The setting is in `state/session-policy.json`: `finish` (true or false) and `idleMinutes` (5 or more, or 0 for off). Then **Open** lists the tabs that are not sessions, for example documents and skills. Each one shows its title, what it is (for example PRD, Document or Web page) and its branch when it is not main. **✕** on an Open row closes the tab only. A terminal keeps running.
+- The dock lists the sessions of the repository by initiative. A session is in the group of the initiative it is recorded on, or of its `initiative/<id>` branch. Then come **Not linked** (no initiative) and **Automatic** (anything you did not start yourself, for example a schedule, the day run, a note's summary or bullets, or a Jira push). **Automatic** is hidden until you press **Show automatic** at the foot of the list (or beside the group select in the strip). A session in front, or one held on a permission question, is always shown. An agent that has finished and reads "needs you" is hidden like the rest. Finished automatic sessions remove themselves a minute after a clean exit, and one with no output for 60 minutes is ended and removed. A failed one stays. When a session has been removed, its terminal tab closes too, also when the workspace was stopped for an update, so the tab does not come back as a row under **Open**. The setting is in `state/session-policy.json`: `finish` (true or false) and `idleMinutes` (5 or more, or 0 for off). Then **Open** lists the tabs that are not sessions, for example documents and skills. Each one shows its title, what it is (for example PRD, Document or Web page) and its branch when it is not main. **✕** on an Open row closes the tab only. A terminal keeps running.
 - Each session row starts with a mark for its state: ● working, ◼ quiet, ◆ needs you, ◇ maybe blocked, ○ ended. Under the name, the row shows the state when the session is not working, the type of work when one is set, and the branch when it is not main and not the initiative's own branch. Running sessions come first and ended sessions last. Press the row to bring the session to the front.
 - Press the name of a group to fold it or open it. The number beside it counts its sessions. **Automatic** is folded while none of its sessions is running, because each run leaves an ended session. The group of the session in front always stays open, and the workspace keeps your choice for each group.
 - **⋯** and **✕** show on the row in front, on the row under the pointer and on the row with the keyboard focus. On a touch screen they always show.

package/workspace/guide/today.md

@@ -117,6 +117,8 @@ The page also shows which sources were read and how many items each gave, and th
 
 Today lists only what waits for you. Each card is one thing that only you can close. When nothing waits, Today says so and names the next scheduled draft, for example "Nothing needs you. Next: biweekly draft Fri 16 Oct."
 
+A session that you did not start yourself, for example a schedule, a day task, or a note's summary, never makes a card, even when its agent has stopped and is "waiting". Only a session you started is waiting for you.
+
 Press **Today** in the top bar, or press `g` and then `t`, to open it. The number on the Today button is the number of cards in the scope you chose: the repository, or All repositories. It is the same number that Today shows at the top of the list.
 
 ## A card

package/workspace/lib/today.js

@@ -291,7 +291,8 @@ function gather(w, { stateDir = stateDirOf(w.root), sessions = [], registered }
     }
   }
   for (const s of sessions || []) {
-    if (!s || s.ws !== w.id || s.shown !== 'needs') continue;
+    // a session the PM did not start (a schedule, the day run, a note's summary) is not waiting on the PM
+    if (!s || s.ws !== w.id || s.shown !== 'needs' || s.automatic) continue;
     rows.push({ run_id: `session:${s.id}`, initiative_id: s.initiative || planItems.initiativeOf(s.plan_item) || null, kind: 'session', derived: true,
       question: 'A session is waiting for you.', doc: [s.name, s.label].filter(Boolean).join(' · ') || null });
   }

package/workspace/package-lock.json

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

package/workspace/package.json

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

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

@@ -176,7 +176,7 @@ function repoNeeds(repo) {
   const sess = Array.isArray(state.sessions) ? state.sessions : [];
   if (!sess.length) return false;
   const wss = new Set(treesOf(repo).map((x) => x.ws));
-  return sess.some((x) => x && wss.has(x.ws) && x.shown === 'needs');
+  return sess.some((x) => x && wss.has(x.ws) && x.shown === 'needs' && !x.automatic);
 }
 
 /* ── the rail ─────────────────────────────────────────────────────────────────────────────────── */

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

@@ -361,7 +361,7 @@ export function railGlyphs() {
     const rp = repoRow(t);
     const name = rp.name;
     const wss = new Set(treesOf(name).map((x) => x.ws));
-    const needs = sess.some((x) => x && wss.has(x.ws) && x.shown === 'needs');
+    const needs = sess.some((x) => x && wss.has(x.ws) && x.shown === 'needs' && !x.automatic);
     const active = product === name;
     const ini = (dataMod && dataMod.repoInitials && dataMod.repoInitials(name)) || (String(name).replace(/[^A-Za-z0-9]+/g, ' ').trim().split(' ').filter(Boolean).slice(0, 2)
       .map((w) => w[0]).join('') || String(name).slice(0, 2)).toUpperCase();

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

@@ -0,0 +1,21 @@
+/* pm/tab-gone.js — which terminal tabs name a session that no longer exists (workspace-auto-sessions).
+ *
+ * A terminal tab is stored in the browser (state.js `tabs`) with the server's session id, so a reload re-attaches to the same
+ * shell. The server now removes an automatic session when its job finishes or it sits idle, and a session can also be removed
+ * while the workspace is stopped for an update. The tab was never told: it came back on every reload as an "Open" row
+ * ("Morning brief", "Weekly report") over a pane that said nothing was attached.
+ *
+ * Pure over its two arguments. `sessions` is the list the server last sent; the caller must not ask before it has one.
+ */
+
+/** The ids of the terminal tabs whose session is not in `sessions`. A tab that has not yet been given a session id is not listed. */
+export function goneTermTabIds(tabs, sessions, { starting = () => false } = {}) {
+  const live = new Set((sessions || []).filter(Boolean).map((s) => s.id));
+  const out = [];
+  for (const t of tabs || []) {
+    if (!t || t.kind !== 'term' || !t.sessionId) continue;
+    if (t.spawn || starting(t)) continue;          // a tab that is about to start a session names none yet
+    if (!live.has(t.sessionId)) out.push(t.id);
+  }
+  return out;
+}

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

@@ -47,6 +47,7 @@
 import { el, setChildren } from './dom.js';
 import { state, setState, subscribe, FIXTURE } from './state.js';
 import * as FX from './fixture.js';
+import { goneTermTabIds } from './tab-gone.js';
 import { pageNonce } from './http.js';   // R25: a session started with an initiative binds only with the nonce
 
 /* ── the design's terminal colours ───────────────────────────────────────────────────────────
@@ -358,6 +359,20 @@ function handle(m) {
     SOCK.listed = true;
     if (m.t === 'hello' && Array.isArray(m.workspaces)) SOCK.workspaces = m.workspaces;
     if (m.t === 'hello' && m.home) SOCK.home = m.home;
+    /* A tab restored from the browser may name a session the server has since removed (an automatic one that finished or
+     * went idle). Close it: it would otherwise return on every reload as an "Open" row over an empty pane. A session the
+     * data layer still lists also keeps its tab, so a tab is never closed on the socket's word alone. */
+    const gone = goneTermTabIds(state.tabs, [...SOCK.sessions, ...(Array.isArray(state.sessions) ? state.sessions : [])], { starting: (t) => SOCK.spawning.get(t.id) });
+    if (gone.length) {
+      setState((s) => {
+        const rest = (s.tabs || []).filter((t) => !gone.includes(t.id));
+        return {
+          tabs: rest,
+          active: gone.includes(s.active) ? (rest.length ? rest[rest.length - 1].id : null) : s.active,
+          splitId: gone.includes(s.splitId) ? null : s.splitId,
+        };
+      });
+    }
     for (const rec of panes.values()) if (rec.kind === 'real') bind(rec);
     return;
   }

package/workspace/test-files.json

@@ -46,6 +46,7 @@
     "learn.test.js",
     "session-flag.test.js",
     "session-origin.test.js",
+    "tab-gone.test.js",
     "live-notes.test.js",
     "plan-items.test.js",
     "plan-tree.test.js",
@@ -150,6 +151,7 @@
     "learn.test.js": 3,
     "session-flag.test.js": 1,
     "session-origin.test.js": 1,
+    "tab-gone.test.js": 1,
     "live-notes.test.js": 3,
     "pm-shell-test.js": 6,
     "pm-repos-test.js": 3,