create-pmos 0.87.0 → 0.89.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.87.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@6a237b2
+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-07T16:37:01Z"}
+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-07T16:37:01Z"}
+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-07T16:37:01Z"}
+generated: {by: process:create-pmos, at: "2026-10-07T17:12:14Z"}
 status: stable
 ---
 

package/workspace/guide/layout.md

@@ -50,16 +50,16 @@ 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** (started by the workspace itself, for example by a schedule or the day run). **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 that waits on you, is always shown. 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. 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.
 - 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/guide/people.md

@@ -1,7 +1,7 @@
 ---
 type: Guide
 title: "People: the people you work with in a repository, their interactions, tone, notes and shared work"
-timestamp: 2026-10-06
+timestamp: 2026-10-07
 ---
 
 # People
@@ -37,16 +37,18 @@ A sighting of a new handle adds the person. A sighting with the full name of a p
 
 ## The list
 
-Type in **Find a person** to search names, handles and initiatives. **All**, **Team** and **External** filter the list. **Latest**, **Most** and **Name** sort it by the last interaction, the number of interactions or the name. Press a person to open their page beside the list.
+People has the same two-card layout as the Agenda. The title says how many people there are. **All**, **Team** and **External** at the top right filter the list. The left card holds the list. Type in **Find a person** to search names, handles and initiatives. **Latest**, **Most** and **Name** sort it by the last interaction, the number of interactions or the name. Each row shows initials, the name, the role and organisation, and the tone as a coloured dot (a ? means you have not confirmed it). Press a person to open their page in the right card. Each card scrolls by itself.
 
 ## A person's page
 
+The top of the page shows the person's name and role, a **Confirm** button when a tone is waiting, and a **⋯** menu. Three tiles under it give the number of interactions, the tone and the shared work.
+
 - **Interactions.** Newest first. Each line shows the date, the kind (Mail, Chat, Meeting, 1:1, Jira, Doc, Call or Mention), the line, and where it came from with its pointer and tone.
-- **Tone.** The mix of tones (warm, neutral, cautious, tense) and a proposed overall tone: the most frequent tone of the latest 10 interactions. When two tones are tied, the latest one wins. Press **Confirm** to keep the proposal, **Set another** to choose a different tone, or **Change** to clear your choice. Tone describes the exchanges, not the person.
+- **Tone.** The mix of tones (warm, neutral, cautious, tense) and a proposed overall tone: the most frequent tone of the latest 10 interactions. When two tones are tied, the latest one wins. Press **Confirm** (at the top or here) to keep the proposal, **Set another** to choose a different tone, or **Change** to clear your choice. Tone describes the exchanges, not the person.
 - **Shared work.** The initiatives your interactions name, the plan items the person owns (with **Blocked** when the item is blocked), and the coming meetings that name them when calendar names are on. Nothing here is typed by hand.
-- **Notes.** Type a note and press **Add note**. Press **Remove** to remove one. Only you can add or remove a note. No command writes one.
+- **Notes.** Type a note and press the **+** button (**Add note**). Press the **×** next to a note to remove it. Only you can add or remove a note. No command writes one.
 - **Identity and sources.** The person's handles, how many interactions each source gave, where People found them, and the file the person lives in.
-- **Remove from People.** Takes the person out. Later sightings of their handles stay out.
+- **Remove from People.** In the **⋯** menu. Takes the person out. Later sightings of their handles stay out.
 
 ## Ways in from other places
 

package/workspace/guide/today.md

@@ -16,6 +16,8 @@ Above the cards, Today shows the day in two columns.
 
 Press **Prepare my day** to start the day. It runs from the brief to the delivery of each agent job, and you do not press anything else until a draft is ready for you. The page [Guide: Today and the proactive engine](proactive-engine.md) describes each step.
 
+The bar at the top of the day is one line. It shows the greeting, the date and how many goals are unfinished. While **Prepare my day** runs, it also shows the four steps (Read, Sort, Agents work, You approve) as a small progress bar; press a step to see its detail. When nothing runs, it says when the day was last prepared. **Sources** and **Check now** are icon buttons in the bar.
+
 If the morning-brief session stops before it submits a brief, the Read step says so and gives the reason. **Prepare my day** is then ready again, so press it to try once more. If the session says that its folder is not there, open the repository again from its current folder first.
 
 Each agent job runs in its own session, so you can open any job and follow or steer it. The workspace types the job's prompt into the session when the agent is ready to read, and presses Enter for you. When you approve or revise a job and its session is still open, the workspace uses that same session again. Prepare again works the same way: when the morning-brief session is still open and has finished its read, or has printed nothing for two minutes, the workspace types the read into that session and runs it again.

package/workspace/lib/session-origin.js

@@ -6,17 +6,22 @@
  * be done to them. Pure: the server passes in the rows and the clock, so the rules are testable without a server.
  *
  * Next step, Hand to agent, a skill draft and an alignment are NOT automatic: the PM pressed those, and often talks on.
+ * Any other origin is automatic.
  */
 'use strict';
 
-const AUTOMATIC_EXACT = Object.freeze(['day-task', 'day-check', 'my-work-read', 'docs:sync', 'docs:check']);
-const AUTOMATIC_PREFIX = Object.freeze(['schedule:']);
+// The rule is "if the PM did not trigger it, it is automatic", so the list names what the PM DID trigger and everything
+// else with an origin is automatic. A new background job is then hidden and cleaned up without anyone remembering to list it.
+// Manual: a session opened with no origin, a Next step or Hand to agent press, a skill draft, an alignment, and the Whisper
+// and final-pass setup shells (the PM pressed those and watches them install).
+const MANUAL_EXACT = Object.freeze(['next-step', 'plan-item', 'notes-whisper-setup', 'notes-final-setup']);
+const MANUAL_PREFIX = Object.freeze(['skill-draft:', 'align:']);
 
-/** True when the workspace, not the PM, started a session with this origin. */
+/** True when the PM did not trigger a session with this origin: a schedule, the day run, a doc sync, a note's passes, Jira. */
 function isAutomatic(origin) {
   const o = String(origin || '');
   if (!o) return false;
-  return AUTOMATIC_EXACT.includes(o) || AUTOMATIC_PREFIX.some((p) => o.startsWith(p));
+  return !(MANUAL_EXACT.includes(o) || MANUAL_PREFIX.some((p) => o.startsWith(p)));
 }
 
 const DEFAULT_POLICY = Object.freeze({ finish: true, idleMinutes: 60 });
@@ -57,9 +62,10 @@ function decide(s, policy, now) {
     return age >= FINISH_GRACE_MS ? 'remove' : null;
   }
   if (!policy.idleMinutes) return null;
-  // waiting on a person is not idle: the session is asking something
-  if (s.shown === 'needs' || s.shown === 'blocked') return null;
+  // A call waiting for permission is a real ask. 'needs' (the agent's turn is over) is NOT: a finished agent always reads
+  // 'needs you', so exempting it would keep every finished job for ever. The idle clock still gives a late question time.
+  if (s.shown === 'blocked') return null;
   return age >= policy.idleMinutes * 60 * 1000 ? 'end' : null;
 }
 
-module.exports = { isAutomatic, normalizePolicy, decide, endedCleanly, DEFAULT_POLICY, FINISH_GRACE_MS, AUTOMATIC_EXACT, AUTOMATIC_PREFIX };
+module.exports = { isAutomatic, normalizePolicy, decide, endedCleanly, DEFAULT_POLICY, FINISH_GRACE_MS, MANUAL_EXACT, MANUAL_PREFIX };

package/workspace/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pmos-workspace",
-  "version": "0.87.0",
+  "version": "0.89.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pmos-workspace",
-      "version": "0.87.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.87.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; },
 };