create-pmos 0.502.0 → 0.504.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.502.0",
+  "version": "0.504.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": {
@@ -32,6 +32,44 @@
     "audit"
   ],
   "pmosChanges": [
+    {
+      "v": "0.504.0",
+      "at": "2026-11-03T05:59:07.712Z",
+      "f": 3,
+      "prs": [
+        {
+          "n": 1189,
+          "t": "The Working card ends when Claude's answer ends",
+          "s": "The Working card ends when Claude's answer ends",
+          "k": "fix"
+        }
+      ]
+    },
+    {
+      "v": "0.503.0",
+      "at": "2026-11-03T05:42:41.752Z",
+      "f": 3,
+      "prs": [
+        {
+          "n": 1186,
+          "t": "A timeline end ◇ names the initiative's own workflow, never a fixed Deliver",
+          "s": "A timeline end ◇ names the initiative's own workflow, never a fixed Deliver",
+          "k": "fix"
+        },
+        {
+          "n": 1187,
+          "t": "Working card leads with the todo or turn goal, not the raw command",
+          "s": "Working card leads with the todo or turn goal, not the raw command",
+          "k": "new"
+        },
+        {
+          "n": 1188,
+          "t": "New meeting recording view, word fix in place (batch 25 item 11)",
+          "s": "New meeting recording view, word fix in place (batch 25 item 11)",
+          "k": "new"
+        }
+      ]
+    },
     {
       "v": "0.502.0",
       "at": "2026-11-03T04:51:26.562Z",
@@ -397,32 +435,6 @@
           "k": "fix"
         }
       ]
-    },
-    {
-      "v": "0.484.0",
-      "at": "2026-11-02T02:00:11.221Z",
-      "f": 3,
-      "prs": [
-        {
-          "n": 1143,
-          "t": "Program chats get the header pill; a phone shows every PDF page (batch 22 items 17, 18)",
-          "s": "Program chats get the header pill; a phone shows every PDF page (batch 22 items 17, 18)",
-          "k": "fix"
-        }
-      ]
-    },
-    {
-      "v": "0.483.0",
-      "at": "2026-11-02T00:26:37.780Z",
-      "f": 3,
-      "prs": [
-        {
-          "n": 1144,
-          "t": "Report building flow \"A+ on Home\" (batch 22 item 14)",
-          "s": "Report building flow \"A+ on Home\" (batch 22 item 14)",
-          "k": "new"
-        }
-      ]
     }
   ]
 }

package/payload/KIT-VERSION

@@ -1,3 +1,3 @@
-kernel-source: pmos@53b3f1f6
+kernel-source: pmos@c0e7ff36
 assembled: 2026-11-03
 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-11-03T04:51:22Z"}
+generated: {by: process:create-pmos, at: "2026-11-03T05:59: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-11-03T04:51:22Z"}
+generated: {by: process:create-pmos, at: "2026-11-03T05:59: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-11-03T04:51:22Z"}
+generated: {by: process:create-pmos, at: "2026-11-03T05:59:04Z"}
 status: stable
 ---
 

package/workspace/briefing-premium-calendar-2-test.js

@@ -144,9 +144,10 @@ const json = (r, b, status = 200) => r.fulfill({ status, contentType: 'applicati
   const q = B.page;
   await until(() => q.evaluate(() => !!document.querySelector('#czViewer [data-a="maketask"]')), 15000);
   // shell A (XvAReplay): Next steps is a fold; open it so what the press says can be read
-  await q.evaluate(() => { const f = document.querySelector('#czViewer [data-czs-fold="steps"]'); if (f && f.getAttribute('aria-expanded') !== 'true') f.click(); });
-  ok('M4 each next step has Make task, and decisions and questions have none', await q.evaluate(() => document.querySelectorAll('#czViewer [data-a="maketask"]').length === 3));
-  await tap(q, '[data-a="maketask"][data-i="0"]');
+  // batch 25 item 11 (MvC): Next steps is a part of the one strip under the kept points; open it so what the press says can be read
+  await q.evaluate(() => { const f = document.querySelector('#czViewer .vzr-fold [data-a="strip"][data-k="steps"]'); if (f && f.getAttribute('aria-expanded') !== 'true') f.click(); });
+  ok('M4 each next step has Make task, and decisions and questions have none', await until(() => q.evaluate(() => document.querySelectorAll('#czViewer .vzr-panel [data-a="maketask"]').length === 3)));
+  await tap(q, '.vzr-panel [data-a="maketask"][data-i="0"]');
   const pl = await until(() => posted(B.S, '/api/plan-items')[0]);
   const ev = pl && pl.body.events && pl.body.events[0];
   ok('M4 Make task posts one planned event in the first stage with the owner', ev && ev.ev === 'planned' && ev.initiative === 'viewer' && ev.stage === 'st1' && ev.owner === 'person:Ana' && ev.title === 'Add a print view for documents' && pl.body.ws === 'w1', JSON.stringify(pl && pl.body));

package/workspace/briefing-premium-calendar-3-test.js

@@ -143,10 +143,9 @@ const json = (r, b, status = 200) => r.fulfill({ status, contentType: 'applicati
   /* R7 Replay */
   const C = await open('/premium-viewer.html?open=meeting&note=n1');
   const r = C.page;
-  // Viewer kit (XvAReplay): no tabs; the replay card sits under the summary, the kept points are the "All N kept" fold, the lines the Transcript fold
-  const unfold = async (id) => { if (await r.evaluate((k) => document.querySelector(`#czViewer [data-czs-fold="${k}"]`).getAttribute('aria-expanded') !== 'true', id)) await tap(r, `[data-czs-fold="${id}"]`); };
+  // batch 25 item 11 (MvC): no tabs; the kept points sit left, the timeline is docked, the lines are the Transcript part of the one strip
+  const unfold = async (id) => { if (await r.evaluate((k) => document.querySelector(`#czViewer .vzr-fold [data-a="strip"][data-k="${k}"]`).getAttribute('aria-expanded') !== 'true', id)) await tap(r, `.vzr-fold [data-a="strip"][data-k="${id}"]`); };
   ok('R7 a kept recording has the replay card under the summary', await until(() => r.evaluate(() => !!document.querySelector('#czViewer .vzp-card .vzp-pl') && !document.querySelector('#czViewer [role="tablist"]')), 15000));
-  await unfold('kept');
   const playing = () => r.evaluate(() => /^Pause/.test((document.querySelector('#czViewer .vzp-dt [data-a="play"]') || { getAttribute: () => '' }).getAttribute('aria-label') || ''));
   ok('R7 Replay shows the player, the strip and the kept points (MtReplay)', await until(() => r.evaluate(() => !!document.querySelector('#czViewer .vzp-dt .vzp-strip') && document.querySelectorAll('#czViewer .vzp-kr').length > 0)));
   await tap(r, '.vzp-dt [data-a="play"]');

package/workspace/changelog.json

@@ -1,4 +1,42 @@
 [
+ {
+  "v": "0.504.0",
+  "at": "2026-11-03T05:59:07.712Z",
+  "f": 3,
+  "prs": [
+   {
+    "n": 1189,
+    "t": "The Working card ends when Claude's answer ends",
+    "s": "The Working card ends when Claude's answer ends",
+    "k": "fix"
+   }
+  ]
+ },
+ {
+  "v": "0.503.0",
+  "at": "2026-11-03T05:42:41.752Z",
+  "f": 3,
+  "prs": [
+   {
+    "n": 1186,
+    "t": "A timeline end ◇ names the initiative's own workflow, never a fixed Deliver",
+    "s": "A timeline end ◇ names the initiative's own workflow, never a fixed Deliver",
+    "k": "fix"
+   },
+   {
+    "n": 1187,
+    "t": "Working card leads with the todo or turn goal, not the raw command",
+    "s": "Working card leads with the todo or turn goal, not the raw command",
+    "k": "new"
+   },
+   {
+    "n": 1188,
+    "t": "New meeting recording view, word fix in place (batch 25 item 11)",
+    "s": "New meeting recording view, word fix in place (batch 25 item 11)",
+    "k": "new"
+   }
+  ]
+ },
  {
   "v": "0.502.0",
   "at": "2026-11-03T04:51:26.562Z",

package/workspace/fixtures/premium-viewer-fixtures.js

@@ -83,14 +83,15 @@ function install(page, o = {}) {
     page.route('**/api/notes/series?*', (r) => json(r, { ok: true, series: { key: 'viewer-sync', meetings: [{ id: 'n0', at: '2026-10-15T10:00:00Z', decided: 1, steps: 3 }, { id: 'n1', at: W.NOTE.meeting.start, decided: 2, steps: 3 }] } })),
     page.route('**/api/notes/search*', (r) => json(r, { ok: true, ids: ['n4'], hits: [{ id: 'n4', snip: '…which teams use saved views for teams every week…', open: true }] })),
     page.route('**/api/meeting-points/*', (r) => {   // a correction and its Undo (the answers lib/meeting-learn.js gives)
-      const b = post(r); if (/forget$/.test(new URL(r.request().url()).pathname)) return json(r, { ok: true });
+      const b = post(r); if (/forget$/.test(new URL(r.request().url()).pathname)) { S.terms = (S.terms || []).filter((x) => x.id !== b.lesson); return json(r, { ok: true }); }
+      if (/term$/.test(new URL(r.request().url()).pathname)) { const t = { id: 't0123456789', note: b.note, heard: b.heard, means: b.means }; S.terms = (S.terms || []).concat([t]); return json(r, { ok: true, term: t, terms: S.terms }); }
       const phrase = require('../lib/meeting-learn.js').phraseOf(b.orig && b.orig.text, b.text);
       S.edits = { ...(S.edits || {}), [b.id]: { kind: b.kind, text: b.text, orig: b.orig } };
       return json(r, { ok: true, edits: S.edits, lesson: b.learn === false ? null : { id: 'l0123456789', phrase, kind: b.kind, meaning: b.text, orig: b.orig }, check: [] });
     }),
     page.route('**/api/meeting-points*', (r) => {
       if (r.request().method() === 'POST') { const b = post(r); (b.ids || []).forEach((id) => { if (b.verdict) S.points[id] = b.verdict; else delete S.points[id]; }); return json(r, { ok: true, points: S.points }); }
-      return json(r, { ok: true, points: S.points, edits: S.edits || {}, lessons: [] });
+      return json(r, { ok: true, points: S.points, edits: S.edits || {}, lessons: [], terms: S.terms || [] });
     }),
     page.route('**/api/notes/new', (r) => {
       const b = post(r), id = 'new' + (++S.made);

package/workspace/guide/briefing-premium.md

@@ -331,7 +331,7 @@ Board is the fourth place on the rail, after Chat, at `/premium-board.html`. It
 - **The view chip** in the Initiatives head says which view is shown (List, By stage or Timeline); press it to pick another.
 - **List** shows the late and at-risk initiatives first, then the board's now view, up to 100 loaded and 25 on screen at a time. A row shows the owner and lane, a status chip when it is not on track, how far through the workflow it is (and "derived" when the workflow engine placed it), a progress bar only when a record holds progress, and the planned finish only when an end date was set ("Not planned" otherwise). "Do this first" appears only when the first row is late.
 - **By stage** has one column for each stage of the board's workflow with the board's own count and its first five initiatives.
-- **List** and **Timeline** show ten tasks a page with Previous and Next; **By stage** shows six cards a column with Show more. **Timeline** draws a bar for each initiative that has dates, with the days left or over, and counts the rest. A bar runs from the earliest start to the latest due date of the initiative's breakdown items and its tasks. Every stage shows, Monitor and Evaluate too. Under a program, every initiative of the program has a row; one with no dates says **No dates** beside today. A product whose initiatives all have no dates keeps its row too, with each initiative saying **No dates**, so the product is never missing from the Board. In each group the rows run by start date, then end date, and the ones with no dates come last; the status dot still marks a late or at-risk initiative. With no dates on record it says so and draws nothing. A gap in the plan that overlaps a hold still leaves out the days outside the hold, also when the hold has no return date.
+- **List** and **Timeline** show ten tasks a page with Previous and Next; **By stage** shows six cards a column with Show more. **Timeline** draws a bar for each initiative that has dates, with the days left or over, and counts the rest. A bar runs from the earliest start to the latest due date of the initiative's breakdown items and its tasks. Every stage shows, Monitor and Evaluate too. The ◇ at the end of a bar names a dated milestone task of the initiative. When the initiative has no dated milestone task, the ◇ names the ◆ stage of the initiative's own workflow: on Product feature that is Deliver, or Evaluate after Deliver. When the workflow has no ◆ stage, the bar ends with no ◇ and no label. A bar never shows Deliver for a workflow that has no Deliver stage, and never shows Deliver next to a named milestone. Under a program, every initiative of the program has a row; one with no dates says **No dates** beside today. A product whose initiatives all have no dates keeps its row too, with each initiative saying **No dates**, so the product is never missing from the Board. In each group the rows run by start date, then end date, and the ones with no dates come last; the status dot still marks a late or at-risk initiative. With no dates on record it says so and draws nothing. A gap in the plan that overlaps a hold still leaves out the days outside the hold, also when the hold has no return date.
 - **Sprint** appears when an agent session has read Jira for the board. Otherwise it says there is none. Press it to open the sprint's facts, with the sprint as a board in a second tab: **To do**, **In progress** and **Done** columns from the last Jira read, with the dates, the days left and the points. The sprint goal is the one the Jira status check writes from the sprint's tickets, as on the console's Sprints tab, with its summary; Jira's own goal shows under it only as a reference (**In Jira: "…"**). Until the check has written one, the tab says **No goal yet**. The active and next sprints are buttons at the top. The closed sprints are behind **Past sprints**, which is shut until you press it. Press any card to open its ticket in another tab. A ticket that is on no initiative of this board shows what the sprint read holds (title, status, points and its Jira link). The board is read only: Jira owns each ticket's status and sprint, so you move tickets in Jira. Tickets with no sprint are not in this read. **Coming up** shows the next release, from the releases ledger.
 - **Open the backlog** is in the Sprint dialog and on its sprint tab. It opens the board's Jira backlog in a tab beside the dialog: the open sprints (active, then next) and then **Backlog**, the tickets in no sprint and not done. A row shows the key, title, status, points and initiative, and why a blocked ticket is blocked. **All**, **Blocked** and **Bugs** filter it (Bugs appears only when the Jira read holds the issue type). A row opens its ticket. The list holds only the tickets the board's initiatives pushed to Jira or hold under their epics, in key order: the Jira read has no rank, assignee or capacity. You move and rank tickets in Jira. With no Jira read, the tab says so.
 - **Next release** shows the next release that carries an initiative of this board, the one planned after it, and the three latest past releases (**Released** when accepted, else **Past**). It reads the release records (`releases/releases.jsonl`, written from the console's Releases view); Jira fix versions alone do not make a release. With no release planned it says so and still lists the past ones. With none at all it says "No release is on record for this board, past or planned."

package/workspace/guide/home.md

@@ -188,6 +188,7 @@ There is no My work page. The list on Home is your list:
   - **Initiative.** The Board opens with **New initiative**, in the open product.
 - **Sessions.** A session row names its agent. The coloured dot beside it is its state: blue waits on you, amber may be blocked, green is running. A session PMOS started itself (a skill or a background job) shows on Home only while it works or asks you something. Once it finishes its prompt, it leaves the list. On an initiative's page, a session that waits on you shows once, under **Needs you**, not again under **Sessions**. **Finished sessions** does not list an old run of a chat that is open again.
 - **One chat box.** Every conversation has the same box: **+** (attach a file, notes, the terminal, and **Link to an initiative** for a loose chat), **/** for commands, **@** inside an initiative, the To or In chip, the mic, and Send. A chat opens at its newest message.
+- **While Claude works.** A line at the top of the chat shows what Claude is trying to do. If Claude keeps a to-do list, the line shows the to-do in progress and how many are done, for example **2 of 5 done**. Tap the line to see the full list. If Claude has no to-do list, the line shows Claude's newest one-line status and the time since your message. The line never shows raw commands. To see the commands, tap the terminal icon.
 - **A session's terminal.** **Watch its terminal** in **+**, or a session row such as **Claude sign-in**, opens the session's terminal in the Viewer. While the session runs, it is a real terminal: type in it to answer Claude or paste a code. When the session has ended, the Viewer shows it read only and says so.
 - **Setting up your first project opens by itself** until a registered folder holds an initiative or setup has finished. The `PMOS` folder that the one-line installer makes holds no initiative yet, so a new user who opens PMOS from the Start menu or the Dock still gets the setup conversation, not an empty Home.
 - **Signing in to Claude when you set up your first project.** If the login you choose is signed in already, PMOS does not open a terminal. It tests the login at once. Otherwise PMOS runs `claude auth login`: Claude opens your browser to sign in, and the terminal under the question shows only Claude's request for a code, if it needs one. Claude's theme and trust-this-folder screens do not appear. When the sign-in ends, PMOS tests the login by itself. **The Claude login on this computer** is the login your usual terminal uses (`~/.claude.json`); PMOS no longer points it at a different file. You choose between two logins only: **The Claude login on this computer** and **A separate login just for PMOS**. The test passes for a login that works in your terminal. Claude updates its own files when it runs, and the test does not count that as a changed setup.

package/workspace/guide/notes.md

@@ -238,9 +238,29 @@ Press **Replay** beside the player (in Calendar › Notes, or on the meeting's c
 
 The page reads only records on this machine: the note, the file Focus kept for the meeting, and the screen shots.
 
+### A recorded meeting in the Viewer
+
+A meeting with a recording opens wide, in two columns. Press **Back to the side** in the header to make it narrow again: the columns then stack.
+
+- **Left:** the summary (two lines; press **Read it all** for the rest), then the kept points. Each point is one line. The icon shows its kind: a green dot is a decision, a box is a next step, a question mark is an open question. The header counts each kind. A next step said within two minutes after a decision, in the same topic, shows under that decision, with **Make a task**.
+- **Confirm:** press **✓** on a row to confirm it (press it again to undo). **Confirm N** in the header confirms every point that is left.
+- **Right:** press a row to see its evidence: the screen at that moment, the quote, and the screen captures near it. Press **▶** to play from the point. The pen opens the edit card. **Not right** moves the point to **Left out**.
+- **Under the points:** one row of parts. Press one to open it: **Left out**, **Next steps**, **Since the last one**, **Facts mentioned**, **Names and terms**, **Prep and material** and **Transcript**.
+- **Bottom:** the timeline stays in view, with the full name of each chapter and a dot for each kept point.
+
+The captures row shows every kept screen capture. It does not yet show only the shared screen: that needs Jev for Images, which PMOS does not have yet.
+
+### Fix a word that was heard wrong
+
+In the summary, a quote, **Left out** or the transcript, select the word (double-click it, or drag over up to four words). The word becomes a field. Type the right spelling and press **✓** or Enter. The word shows fixed in every place this meeting shows it, and the message says how many places. **Undo** puts it back. **Names and terms** lists the people of the invite and the words you fixed.
+
+Later notes spell the word your way: the fix goes to your agent with the notes it writes. In other meetings, the same heard words are underlined. Press one to fix it there too, with your fix already typed.
+
+The note's own files do not change. The fix shows where PMOS draws the note.
+
 ### Fix or delete a key point
 
-In a meeting's Viewer, press a decision, a question or an action to open its edit card. Change the kind or the words, then press **Save**. PMOS remembers what you meant for the next notes, unless you press **Only fix this one**.
+In a meeting's Viewer, press a decision, a question or an action, then press the pen to open its edit card. **Not right** is on the edit card too. Change the kind or the words, then press **Save**. PMOS remembers what you meant for the next notes, unless you press **Only fix this one**.
 
 To delete the point, press the trash on the edit card. The point leaves at once, with no question first. **Undo** shows for 8 seconds and puts it back. A deleted point stays deleted after a reload. It is not in **Left out** and it is not counted. A delete does not teach PMOS anything, and nothing is sent outside PMOS.
 

package/workspace/lib/meeting-terms.js

@@ -0,0 +1,53 @@
+'use strict';
+/* meeting-terms.js — a word heard wrong, fixed in place (batch 25 item 11, "Meeting recording view C": MvF, MvN).
+ *
+ * The PM selects a word in a meeting's summary, a quote or the transcript ("More engaged") and types what it is ("MoEngage"). It is kept
+ * as one of the lessons of lib/meeting-learn.js, of kind 'term': its phrase is the heard words, its meaning is the fix. So, with no new
+ * record, the agent's handoff already carries it for later notes (meeting-learn.js handoffLines: "“more engaged”: MoEngage") and its
+ * Undo is the lesson's forget. The page shows the fix in every place this note shows the words, and underlines the heard words in other
+ * notes with the fix as the guess. The note's own files are NOT rewritten: rewriting every stored copy of a word is not proven.
+ *
+ *   term(dir, { note, heard, means, now }) → { ok, term, terms } | { ok: false, status, error }
+ *   terms(dir) → [{ id, heard, means, note, at }]   the word fixes that hold now; the latest fix of the same words in a note wins
+ *   (forget: lib/meeting-learn.js forget({ lesson: <term id> }))
+ * One line of <runtime>/meeting-lessons.jsonl per fix, append-only, file mode. Nothing here sends anything. */
+const fs = require('fs');
+const path = require('path');
+const crypto = require('crypto');
+const ML = require('./meeting-learn.js');
+
+const NOTE_ID = /^[A-Za-z0-9_-]{1,80}$/;
+const MAX_WORD = 60;
+const clean = (s) => String(s == null ? '' : s).replace(/\s+/g, ' ').trim();
+/** The heard words as a lesson's phrase: lower case, the same words meeting-learn.js mentions() matches. */
+const phraseOf = (s) => (clean(s).toLowerCase().match(/[\p{L}\p{N}][\p{L}\p{N}.'-]*/gu) || []).map((w) => w.replace(/[.'-]+$/, '')).filter(Boolean).join(' ');
+
+function terms(dir) {
+  const out = [];
+  for (const l of ML.lessons(dir)) {
+    if (l.kind !== 'term' || !l.phrase || !l.meaning) continue;
+    const i = out.findIndex((x) => x.note === l.note && x.heard === l.phrase);
+    if (i >= 0) out.splice(i, 1);
+    out.push({ id: l.id, heard: l.phrase, means: l.meaning, note: l.note, at: l.at });
+  }
+  return out;
+}
+
+function term(dir, body = {}) {
+  if (!dir) return { ok: false, status: 500, error: 'no runtime folder' };
+  const note = String(body.note || '');
+  if (!NOTE_ID.test(note)) return { ok: false, status: 400, error: 'note is the id of a meeting note' };
+  const raw = clean(body.heard), means = clean(body.means);
+  if (!raw || !means) return { ok: false, status: 400, error: 'heard and means are the words before and after the fix' };
+  if (raw.length > MAX_WORD || means.length > MAX_WORD) return { ok: false, status: 400, error: 'a word fix is a name or a term of at most ' + MAX_WORD + ' characters' };
+  const heard = phraseOf(raw);
+  if (!heard) return { ok: false, status: 400, error: 'heard names no word' };
+  if (heard === means) return { ok: false, status: 400, error: 'the fix is the same as what was heard' };
+  const at = new Date(body.now || Date.now()).toISOString();
+  const id = 'l' + crypto.createHash('sha1').update('term|' + note + '|' + heard + '|' + means + '|' + at).digest('hex').slice(0, 10);
+  fs.mkdirSync(dir, { recursive: true });
+  fs.appendFileSync(path.join(dir, ML.FILE), JSON.stringify({ v: 1, t: 'lesson', id, phrase: heard, kind: 'term', meaning: means, orig: null, note, point: '', at }) + '\n');
+  return { ok: true, term: { id, heard, means, note, at }, terms: terms(dir) };
+}
+
+module.exports = { term, terms, MAX_WORD };

package/workspace/lib/routes-meeting-points.js

@@ -7,10 +7,13 @@
  *   The GET also answers { edits, lessons }: the PM's corrections to the note's points and what PMOS learned (lib/meeting-learn.js).
  *   POST /api/meeting-points/edit { note, id, kind, text, orig: { kind, text }, learn, items: [{ id, text }] } → { ok, edits, lesson, check }
  *        a corrected point (XvAReplayEdit). learn false is "Only fix this one". check: the other points of the note that use the learned words.
- *   POST /api/meeting-points/forget { lesson } → { ok }        Undo of what PMOS learned
+ *   POST /api/meeting-points/forget { lesson } → { ok }        Undo of what PMOS learned, and of a word fix (its term id)
+ *   POST /api/meeting-points/term { note, heard, means } → { ok, term, terms }   a word fixed in place, in every place the note shows it
+ *   The GET answers { terms } too: the word fixes that hold now (lib/meeting-terms.js).
  * The POSTs are page presses (lib/pm-guard.js requirePagePress). Handlers are pure over (q | body, ctx) so a test needs no server. */
 const MP = require('./meeting-points.js');
 const ML = require('./meeting-learn.js');
+const MT = require('./meeting-terms.js');
 const guard = require('./pm-guard.js');
 
 const fail = (status, error) => ({ status, body: { ok: false, error } });
@@ -18,12 +21,12 @@ const fail = (status, error) => ({ status, body: { ok: false, error } });
 function read(q, ctx) {
   if (!/^[A-Za-z0-9_-]{1,80}$/.test(String(q.note || ''))) return fail(400, 'note is the id of a meeting note');
   const note = String(q.note);
-  return { status: 200, body: { ok: true, points: MP.pointsOf(ctx.runtimeDir, note), edits: ML.editsOf(ctx.runtimeDir, note), lessons: ML.lessons(ctx.runtimeDir).filter((x) => x.phrase).slice(-30) } };
+  return { status: 200, body: { ok: true, points: MP.pointsOf(ctx.runtimeDir, note), edits: ML.editsOf(ctx.runtimeDir, note), lessons: ML.lessons(ctx.runtimeDir).filter((x) => x.phrase && x.kind !== 'term').slice(-30), terms: MT.terms(ctx.runtimeDir).slice(-200) } };
 }
 function learn(req, body, ctx, op) {
   const g = guard.requirePagePress(req, body);
   if (!g.ok) return fail(g.status, g.error);
-  const r = op === 'forget' ? ML.forget(ctx.runtimeDir, body) : ML.edit(ctx.runtimeDir, body);
+  const r = op === 'forget' ? ML.forget(ctx.runtimeDir, body) : op === 'term' ? MT.term(ctx.runtimeDir, body) : ML.edit(ctx.runtimeDir, body);
   if (!r.ok) return fail(r.status || 400, r.error);
   return { status: 200, body: r };
 }
@@ -40,7 +43,7 @@ module.exports = {
   prefixes: ['/api/meeting-points'],
   read, write, learn,
   handle: async (req, res, url, ctx) => {
-    const op = url.pathname === '/api/meeting-points/edit' ? 'edit' : url.pathname === '/api/meeting-points/forget' ? 'forget' : '';
+    const op = url.pathname === '/api/meeting-points/edit' ? 'edit' : url.pathname === '/api/meeting-points/forget' ? 'forget' : url.pathname === '/api/meeting-points/term' ? 'term' : '';
     if (op) {
       if (req.method !== 'POST') return respond(ctx, res, fail(405, 'POST only'));
       const got = await ctx.readJson(req);

package/workspace/lib/transcript-read.js

@@ -236,9 +236,20 @@ function newHarnessAcc() {
     // more. `ai-title` and `attachment` records are CLI bookkeeping and are deliberately not
     // turn-taking, and neither is a SYNTHETIC assistant record: counting one as "the assistant
     // finished speaking" is exactly how a false `needs you` would be manufactured.
-    lastRole: null };      // 'assistant' | 'user' | null
+    lastRole: null,        // 'assistant' | 'user' | null
+    msgId: null,           // the newest real model message's id: a new one closes the older messages' calls (feedHarness)
+    cmdFrom: undefined };  // the turn before a /command record, given back when the CLI answers the command itself
 }
 
+// The text of a user record, for the turn rules below: string content, or its text blocks joined.
+function userRecordText(um) {
+  if (typeof um.content === 'string') return um.content;
+  return (Array.isArray(um.content) ? um.content : []).filter((c) => c && c.type === 'text' && typeof c.text === 'string').map((c) => c.text).join('\n');
+}
+const INTERRUPTED = /^\s*\[Request interrupted by user/;
+const LOCAL_OUT = /^\s*<(local-command-stdout|local-command-stderr)>/;
+const LOCAL_IN = /^\s*<(bash-input|bash-stdout|bash-stderr)>|^\s*Caveat: The messages below/;
+
 function feedHarness(acc, raw, clean) {
   for (const line of raw.split('\n')) {
     if (!line) continue;
@@ -253,13 +264,27 @@ function feedHarness(acc, raw, clean) {
     }
     // tool_result blocks live inside `user` records; harvest the ids they resolve.
     if (r.type === 'user') {
+      if (r.isSidechain) continue;   // a subagent's own records: its calls and results never hold the main session's turn
       const um = r.message || {};
+      let result = false;
       for (const c of (Array.isArray(um.content) ? um.content : [])) {
         if (c && c.type === 'tool_result' && c.tool_use_id) {
+          result = true;
           if (!acc.openUse.delete(c.tool_use_id)) acc.resolved.add(c.tool_use_id);
         }
       }
-      acc.lastRole = 'user';       // a prompt was submitted, or a tool result landed
+      const said = result ? '' : userRecordText(um);
+      // batch 25 item 15: only a prompt or a tool result gives the model the turn. The CLI's own records after a finished
+      // answer (a meta note, a compact summary, a local command such as /model and its output, a `!` shell line) start no
+      // model turn, so counting them left the chat on "Working" for hours after Claude had answered.
+      if (result) acc.lastRole = 'user';
+      else if (INTERRUPTED.test(said)) { acc.lastRole = 'assistant'; acc.openUse.clear(); }   // Esc / Stop: the model stopped, the PM is up
+      else if (LOCAL_OUT.test(said)) { if (acc.cmdFrom !== undefined) acc.lastRole = acc.cmdFrom; acc.cmdFrom = undefined; }   // a local command answered itself
+      else if (r.isMeta || r.isCompactSummary || r.isVisibleInTranscriptOnly || LOCAL_IN.test(said)) { /* bookkeeping: not turn-taking */ }
+      else {
+        if (/<command-name>/.test(said)) acc.cmdFrom = acc.lastRole;   // /name: a prompt command takes the turn; a local one gives it back above
+        acc.lastRole = 'user';     // a prompt was submitted
+      }
       continue;
     }
     if (r.type === 'attachment') {
@@ -274,6 +299,13 @@ function feedHarness(acc, raw, clean) {
     }
     if (r.type !== 'assistant') continue;
     const m = r.message || {};
+    if (m.model && m.model !== SYNTHETIC && !r.isSidechain && m.id && m.id !== acc.msgId) {
+      // A new model message starts only once every call of the one before it has its result: the model cannot go on without
+      // them. So a call of an older message that is still unresolved is a phantom (a crash, a killed pane, a resumed chat), never
+      // a call in flight, and it must not hold the turn (batch 25 item 15: a chat showed "Working · 169:28" under its answer).
+      for (const [id, info] of acc.openUse) if (info.msg !== m.id) acc.openUse.delete(id);
+      acc.msgId = m.id;
+    }
     if (m.model && m.model !== SYNTHETIC) {
       acc.model = clean(m.model);
       acc.turns++;                                  // only real model turns count
@@ -298,7 +330,7 @@ function feedHarness(acc, raw, clean) {
         const name = clean(prettyTool(c.name));
         acc.toolCounts[name] = (acc.toolCounts[name] || 0) + 1;
         acc.toolTotal++;
-        if (c.id && !acc.resolved.delete(c.id)) acc.openUse.set(c.id, { verb: name, ts: r.timestamp || null });
+        if (c.id && !r.isSidechain && !acc.resolved.delete(c.id)) acc.openUse.set(c.id, { verb: name, ts: r.timestamp || null, msg: m.id || null });
       }
     }
   }
@@ -320,6 +352,9 @@ function harnessOf(acc) {
   // the strong `needs you` claim can be built) is UNREACHABLE for it. Not a guard that rejects
   // the phantom: a value it cannot construct. Reordering these branches silently converts a
   // corpse into "waiting on you", which is the one lie this surface must not tell.
+  // A phantom stays only while nothing came after it: once a NEWER model message exists, the session demonstrably went
+  // on past that call, so feedHarness drops it (batch 25 item 15). A crash with the call as its newest record still lands
+  // on `tool`, exactly as above.
   if (out.openCall) out.turn = 'tool';              // awaiting a tool — OR the PM's approval of one
   else if (acc.lastRole === 'assistant') out.turn = 'user';   // the model stopped; the human is up
   else if (acc.lastRole === 'user') out.turn = 'agent';       // a prompt/result landed; the model is up

package/workspace/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pmos-workspace",
-  "version": "0.502.0",
+  "version": "0.504.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pmos-workspace",
-      "version": "0.502.0",
+      "version": "0.504.0",
       "license": "MIT",
       "dependencies": {
         "@anthropic-ai/sdk": "^1.3.0",

package/workspace/package.json

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

package/workspace/premium-chat-line-test.js

@@ -99,8 +99,8 @@ const look = () => {
     if (shots) await p.screenshot({ path: `${shots}/line-390.png` });
     await p.click('#hmPl [data-pl="toggle"]');
     const s1 = await until(async () => { const v = await p.evaluate(look); return v.open ? v : null; }) || await p.evaluate(look);
-    ok('P2 a tap opens it in place: the goal, "1 of 4 points met · round 2 of 12", every point, Now and the terminal',
-      /Bring the descope-feature-parity PRD/.test(s1.line || '') && /1 of 4 points met · round 2 of 12/.test(s1.line || '') && /Ready for Dita's review/.test(s1.line || '') && /Now\s*Edit · planning\/prd\/descope-parity.md/.test(s1.line || '') && s1.term && !s1.vw, JSON.stringify(s1));
+    ok('P2 a tap opens it in place: the goal, "1 of 4 points met · round 2 of 12", every point, Now in plain words (never the raw call) and the terminal',
+      /Bring the descope-feature-parity PRD/.test(s1.line || '') && /1 of 4 points met · round 2 of 12/.test(s1.line || '') && /Ready for Dita's review/.test(s1.line || '') && /Now\s*SSO goes on the out-of-scope list/.test(s1.line || '') && !/Edit · planning/.test(s1.line || '') && s1.term && !s1.vw, JSON.stringify(s1));
     if (shots) await p.screenshot({ path: `${shots}/line-390-open.png` });
     await p.click('#hmPl [data-pl="toggle"]');
     await p.evaluate(() => { const se = document.scrollingElement; se.scrollTop = 0; });
@@ -117,7 +117,7 @@ const look = () => {
   { const st = { conv: { turn: 'agent', messages: BASE } };
     const { p, ctx, errs } = await open(390, st);
     const s0 = await until(async () => { const v = await p.evaluate(look); return v.line ? v : null; }) || await p.evaluate(look);
-    ok('P3 a session with no step list: "Working · m:ss", never an invented count', /Working · \d+:\d\d/.test(s0.line || '') && !/ of \d+ done/.test(s0.line || ''), JSON.stringify(s0));
+    ok('P3 a session with no step list: Claude\'s newest status line and the clock, never the raw call or an invented count (batch 25 item 14)', /SSO goes on the out-of-scope list; the date stays\.\s*\d+:\d\d/.test(s0.line || '') && !/Edit · planning/.test(s0.line || '') && !/ of \d+ done/.test(s0.line || ''), JSON.stringify(s0));
     st.conv = { turn: 'agent', messages: BASE, steps: [{ text: 'Read the funnel export', state: 'done' }, { text: 'Find the step that moved', state: 'now', call: 'Read · funnel.csv' }, { text: 'Write it up', state: 'next' }] };
     const s1 = await until(async () => { const v = await p.evaluate(look); return /Find the step/.test(v.line || '') ? v : null; }) || await p.evaluate(look);
     ok('P3 a session with its own steps: its step and "1 of 3 done"', /Find the step that moved/.test(s1.line || '') && /1 of 3 done/.test(s1.line || ''), JSON.stringify(s1));