create-pmos 0.106.0 → 0.107.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.106.0",
+  "version": "0.107.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@ed9ef84
+kernel-source: pmos@5953acb
 assembled: 2026-10-08
 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-08T01:32:06Z"}
+generated: {by: process:create-pmos, at: "2026-10-08T02:26:00Z"}
 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-08T01:32:06Z"}
+generated: {by: process:create-pmos, at: "2026-10-08T02:26:00Z"}
 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-08T01:32:06Z"}
+generated: {by: process:create-pmos, at: "2026-10-08T02:26:00Z"}
 status: stable
 ---
 

package/workspace/guide/notes.md

@@ -2,7 +2,7 @@
 type: Guide
 title: "Guide: notes"
 description: "How to take notes in a meeting: one note top to bottom, typed notes as timed lines, key points written each minute and labelled by Jev, delete a note; final notes written after Stop from the whole recording, with speakers and a quote for each item, and Wispr Flow's notes beside them; listen to your microphone and the meeting on this machine, see decisions, actions and questions caught as they are said, check them against the repository for conflicts, capture highlights during the meeting, create tasks from next steps, correct and tag lines, see what changed in your notes, replay the meeting, link a note to its meeting and its initiative, and get a summary."
-timestamp: 2026-10-07
+timestamp: 2026-10-08
 ---
 
 # Guide: notes
@@ -165,7 +165,7 @@ Under the title, a note shows two lines: **Meeting** and **Initiative**.
 
 When a note has no initiative, the summary suggests one: the open initiative that shares 3 or more words with what was said, when no other initiative shares as many. A suggestion never replaces an initiative you chose.
 
-To take notes for a calendar event, open the event's detail on the Agenda and press **Take notes**. PMOS starts to listen at once, to your microphone and to the meeting when local transcription is set up. Pick the meeting's tab or window when the browser asks. Let people know that you are taking notes. The note is linked to the event, and to the event's initiative when it has one. The note stays small at the bottom right of the workspace, with a red dot, its title and its time, on every page. Press it to open the note as a pop-up: add your notes, read the key points, and press **Stop** when the meeting ends. Press **Minimize** or Esc to make it small again. **Open in Notes** in the **⋯** menu shows it on the full screen. One note is taken at a time. If you press **Take notes** on another event while a note listens, PMOS asks first: **Keep it**, or **Stop it and start this one**. The note stays at the bottom right after a reload. When it no longer listens, press the x beside it to put it away. An event that already has a note shows its summary and **Open notes**, which opens the note in the pop-up. See [Today](today.md) and [the initiative sheet](initiatives-screen.md).
+To take notes for a calendar event, open the event's detail on the Agenda and press **Take notes**. PMOS starts to listen at once, to your microphone and to the meeting when local transcription is set up. Pick the meeting's tab or window when the browser asks. Let people know that you are taking notes. The note is linked to the event, and to the event's initiative when it has one. The note stays small at the bottom right of the workspace, with a red dot, its title and its time, on every page. Press it to open the note as a pop-up: add your notes, read the key points, and press **Stop** when the meeting ends. The pop-up stays steady while it listens: new lines are added at the end, and your place in the pop-up, the line you are typing and its cursor do not move. If the transcript is scrolled to its end, it follows the new lines. Press **Minimize** or Esc to make it small again. **Open in Notes** in the **⋯** menu shows it on the full screen. One note is taken at a time. If you press **Take notes** on another event while a note listens, PMOS asks first: **Keep it**, or **Stop it and start this one**. The note stays at the bottom right after a reload. When it no longer listens, press the x beside it to put it away. An event that already has a note shows its summary and **Open notes**, which opens the note in the pop-up. See [Today](today.md) and [the initiative sheet](initiatives-screen.md).
 
 ## Dictate into your notes
 

package/workspace/package-lock.json

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

package/workspace/package.json

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

package/workspace/public/pm/dom.js

@@ -53,9 +53,8 @@ export function el(tag, attrs, ...children) {
       else if (k === 'ref') { if (typeof v === 'function') v(node); }
       else if (k === 'value' || k === 'checked' || k === 'disabled' || k === 'selected') node[k] = v;
       else if (k === 'html') node.innerHTML = String(v);
-      else if (k.length > 2 && k[0] === 'o' && k[1] === 'n' && typeof v === 'function') {
-        node.addEventListener(k.slice(2).toLowerCase(), v);
-      } else if (v === true) node.setAttribute(k, '');
+      else if (k.length > 2 && k[0] === 'o' && k[1] === 'n' && typeof v === 'function') listen(node, k.slice(2).toLowerCase(), v);
+      else if (v === true) node.setAttribute(k, '');
       else node.setAttribute(k, String(v));
     }
   }
@@ -63,6 +62,14 @@ export function el(tag, attrs, ...children) {
   return node;
 }
 
+/** An `onX` handler of el(). The listener reads the handler from the node, so patch() can give a node it keeps the handler of
+ * the node drawn in its place: a kept button then runs what the newest draw says, not what the first draw said. */
+function listen(node, type, fn) {
+  const h = node.__pmOn || (node.__pmOn = Object.create(null));
+  if (!(type in h)) node.addEventListener(type, function (e) { const f = node.__pmOn[type]; return f ? f.call(this, e) : undefined; });
+  h[type] = fn;
+}
+
 /** {backgroundColor:'red', minHeight:'30px'} -> 'background-color:red;min-height:30px'. */
 export function style(obj) {
   if (typeof obj === 'string') return obj;
@@ -174,3 +181,63 @@ export function keepScroll(scroller) {
     scroller.removeEventListener('scroll', onScroll);
   };
 }
+
+/**
+ * Patch `live`'s children to look like `fresh`'s, keeping every node that is still there (note pop-up flicker, 2026-10-08).
+ * A view that draws itself again on every state change can draw into a detached `fresh` and patch the screen from it: what
+ * did not change stays the same element, so its scroll, focus, caret, open state and CSS animation stay; what changed is
+ * updated in place; what is new is inserted. Children are matched by tag and by their data-* attributes (so a list keyed
+ * by `data-x="3"` keeps its rows), else by position. A kept node takes the attributes, the el() handlers and the form
+ * values of the node drawn in its place. A `kept(node)` placeholder in `fresh` stands for a node the view owns and keeps
+ * itself (an editor field): that node is left where it is, or moved there, and never patched.
+ */
+export function patchChildren(live, fresh) {
+  let cur = live.firstChild;
+  for (const n of [...fresh.childNodes]) {
+    if (n.__pmKeep) {
+      const t = n.__pmKeep;
+      if (cur === t) cur = cur.nextSibling;
+      else live.insertBefore(t, cur);
+      continue;
+    }
+    if (cur && sameNode(cur, n)) { patchNode(cur, n); cur = cur.nextSibling; continue; }
+    let found = null;
+    if (n.nodeType === 1 && keyOf(n)) for (let c = cur; c; c = c.nextSibling) if (sameNode(c, n)) { found = c; break; }
+    if (found) { live.insertBefore(found, cur); patchNode(found, n); continue; }
+    live.insertBefore(n, cur);
+  }
+  while (cur) { const x = cur.nextSibling; live.removeChild(cur); cur = x; }
+  return live;
+}
+/** A placeholder for patchChildren(): `node` is the view's own, and stays as it is. Off a page, the node itself. */
+export function kept(node) {
+  if (!node || !node.isConnected) return node;
+  const p = document.createElement('pm-kept');
+  p.__pmKeep = node;
+  node.__pmOwned = true;   // never matched to, and patched into, another node drawn beside it
+  return p;
+}
+function keyOf(n) {
+  let k = '';
+  for (const a of n.attributes) if (a.name.startsWith('data-')) k += a.name + '=' + a.value + ';';
+  return k;
+}
+function sameNode(a, b) {
+  if (a.nodeType !== b.nodeType) return false;
+  if (a.nodeType !== 1) return true;
+  return a.tagName === b.tagName && !a.__pmOwned && keyOf(a) === keyOf(b);
+}
+function patchNode(a, b) {
+  if (a.nodeType !== 1) { if (a.nodeValue !== b.nodeValue) a.nodeValue = b.nodeValue; return; }
+  for (const x of [...a.attributes]) if (!b.hasAttribute(x.name)) a.removeAttribute(x.name);
+  for (const x of b.attributes) if (a.getAttribute(x.name) !== x.value) a.setAttribute(x.name, x.value);
+  const ha = a.__pmOn; const hb = b.__pmOn;
+  if (ha) for (const t in ha) if (!hb || !hb[t]) ha[t] = null;
+  if (hb) for (const t in hb) listen(a, t, hb[t]);
+  const tag = a.tagName;
+  if (tag === 'INPUT' || tag === 'TEXTAREA' || tag === 'SELECT') {
+    if (a.value !== b.value && a !== document.activeElement) a.value = b.value;
+    if (a.checked !== b.checked) a.checked = b.checked;
+  }
+  patchChildren(a, b);
+}

package/workspace/public/pm/note-dock.js

@@ -13,7 +13,7 @@
  *   openDock(id)               → shows a note in the pop-up
  *   minimize() · activeId() · forget(id)
  */
-import { el } from './dom.js';
+import { el, patchChildren } from './dom.js';
 import { button, iconButton, layer, toast, ensureComponentsCss } from './primitives.js';
 import { askConfirm } from './dialogs.js';
 import { pmPost } from './http.js';
@@ -123,6 +123,10 @@ function draw() {
   const live = !!active && !!v && liveId() === active.id;
   clearInterval(tick); tick = null;
   if (!active || !v) { host.replaceChildren(); return; }
+  // The dock draws on every state change, and a transcript line comes in every few seconds while it listens. It draws into
+  // a detached node and patches the screen from it, so only what changed is touched: the lines already shown, the field
+  // being typed in, the scroll and the red dot's pulse stay as they are, and a new line is appended (2026-10-08 flicker).
+  const fresh = el('div');
   if (live) tick = setInterval(() => { const c = host.querySelector('[data-nt-dock-clock]'); if (c) c.textContent = clockText(); }, 1000);
   if (!open) {
     const pill = button({ label: el('span', { class: 'nt-pill__txt' },
@@ -131,14 +135,20 @@ function draw() {
       live ? el('span', { class: 'nt-pill__clock', 'data-nt-dock-clock': '' }, clockText()) : null),
     variant: 'outline', attrs: { class: 'nt-pill', 'data-nt-pill': live ? 'live' : 'idle', 'aria-label': (live ? 'Notes are being taken: ' : 'Meeting note: ') + titleOf() + '. Open the note.' },
     onClick: () => openDock(active.id) });
-    host.replaceChildren(el('div', { class: 'nt-pillrow' }, pill,
+    fresh.appendChild(el('div', { class: 'nt-pillrow' }, pill,
       live ? null : iconButton({ icon: 'x', ariaLabel: 'Put the note away', onClick: close, attrs: { 'data-nt-dock-close': '' } })));
+    patchChildren(host, fresh);
     return;
   }
   // the note draws its own bar (status, Stop, Minimize and the ⋯ menu): the pop-up adds no second head (Run 7)
   const body = el('div', { class: 'nt-pop__body' });
   const pop = el('section', { class: 'nt-pop', role: 'dialog', 'aria-label': 'Meeting note', 'data-nt-pop': active.id }, body);
-  host.replaceChildren(pop);
+  fresh.appendChild(pop);
   if (!v.renderInline(body, viewCtx, active.id, { onMinimize: minimize })) body.appendChild(el('p', { class: 'nt-hint' }, 'Another note is being taken.'),
     button({ label: 'Minimize', variant: 'ghost', size: 'sm', onClick: minimize, attrs: { 'data-nt-minimize': '' } }));
+  // a transcript read to its end follows the new lines; one the PM scrolled up in stays where they left it
+  const box = host.querySelector('[data-nt-pop] [data-nt-transcript]');
+  const atEnd = !!box && box.scrollTop + box.clientHeight >= box.scrollHeight - 8;
+  patchChildren(host, fresh);
+  if (atEnd && box.isConnected) box.scrollTop = box.scrollHeight;
 }

package/workspace/public/pm/view-notes.js

@@ -39,7 +39,7 @@
  *   POST /api/notes/new · save · dictate · record · transcript · audio · label · speaker · switch · whisper-setup · private
  *        · summarize · summarize-agent · delete · line · recording-delete · link
  */
-import { el } from './dom.js';
+import { el, kept } from './dom.js';
 import { askConfirm, askText } from './dialogs.js';
 import { pmGet, pmPost } from './http.js';
 import { mdRender } from './markdown.js';
@@ -66,6 +66,10 @@ let speech = null;            // the browser recogniser: { mode: 'dictate'|'reco
 let audio = null;             // local Whisper capture: { id, state, sources, ctx, streams, started, clock, msg }
 let engine = null;            // { ws, whisper, jev, at }
 let showList = false;
+let inlineDraw = false;       // the pop-up is drawing: the fields and the player it shows are left in place (pm/note-dock.js)
+/** A node this view keeps across redraws (an editor field, the player). The pop-up patches itself (dom.js patchChildren), so
+ * there the node is a placeholder and stays where it is: a field that is typed in is never moved, and keeps its focus. */
+const own = (node) => (inlineDraw ? kept(node) : node);
 let pollTimer = null; let agentTimer = null;
 let busy = '';
 let player = null;            // the replay: { id, bytes, el, playing }, kept across redraws so playback goes on
@@ -1204,11 +1208,11 @@ function header(ctx, n, ed, opts = {}) {
   }
   if (opts.onMinimize) acts.push(button({ label: 'Minimize', variant: 'ghost', size: 'sm', onClick: opts.onMinimize, attrs: { 'data-nt-minimize': '' } }));
   if (!opts.inline) acts.push(button({ label: 'All notes', variant: 'ghost', size: 'sm', onClick: () => { showList = !showList; ctx.setState({}); if (showList) loadList(ctx); }, attrs: { 'data-nt-all': '', 'aria-expanded': showList ? 'true' : 'false' } }));
-  const more = iconButton({ icon: 'ellipsis', ariaLabel: 'More', onClick: () => moreMenu(ctx, n, opts, more), attrs: { 'data-nt-more': '' } });
+  const more = iconButton({ icon: 'ellipsis', ariaLabel: 'More', onClick: (e) => moreMenu(ctx, n, opts, (e && e.currentTarget) || more), attrs: { 'data-nt-more': '' } });
   acts.push(more);
   return el('header', { class: 'nt-header', 'data-nt-part': 'header' },
     el('div', { class: 'nt-bar' }, status, el('div', { class: 'nt-acts' }, acts)),
-    el('div', { class: 'nt-headl' }, ed.titleWrap, whenLine(ctx, n), peopleRow(n)));
+    el('div', { class: 'nt-headl' }, own(ed.titleWrap), whenLine(ctx, n), peopleRow(n)));
 }
 function listPane(ctx) {
   const rows = (list && list.notes) || [];
@@ -1421,7 +1425,7 @@ function myNotes(ctx, n, ed) {
   const t = liveMs(n);
   const parts = [el('h3', { class: 'nt-sec__h' }, 'Your notes')];
   if (items.length) parts.push(el('ul', { class: 'nt-items', 'data-nt-notelines': '' }, items));
-  if (!replaying) parts.push(el('div', { class: 'nt-addrow' }, el('span', { class: 'nt-at', 'data-nt-clock-now': '' }, t !== null ? fmtTime(t) : ''), ed.addWrap));
+  if (!replaying) parts.push(el('div', { class: 'nt-addrow' }, el('span', { class: 'nt-at', 'data-nt-clock-now': '' }, t !== null ? fmtTime(t) : ''), own(ed.addWrap)));
   else parts.push(el('p', { class: 'nt-hint' }, 'Your notes, as the meeting plays. Pause to add more.'));
   const sp = speech && speech.id === n.id ? speech : null;
   const bar = [];
@@ -1618,16 +1622,20 @@ export function renderInline(host, ctx, id, opts = {}) {
   if (!n) { loadNote(ctx, id); host.appendChild(el('p', { class: 'nt-hint' }, 'reading the note …')); return true; }
   const keep = keepFocus();
   const ed = editorFor(ctx, n);
+  inlineDraw = true;
+  try { drawInline(ctx, n, ed, host, opts); } finally { inlineDraw = false; }
+  keep();
+  return true;
+}
+function drawInline(ctx, n, ed, host, opts) {
   const wrap = el('div', { class: 'nt-wrap nt-wrap--inline', 'data-nt-part': 'inline', 'data-nt-id': n.id });
   if (banner) wrap.appendChild(el('div', { class: 'nt-banner' + (banner.tone === 'bad' ? ' nt-banner--bad' : ''), 'data-nt-banner': banner.tone, role: banner.tone === 'bad' ? 'alert' : 'status' }, banner.text));
   wrap.appendChild(header(ctx, n, ed, { inline: true, onMinimize: opts.onMinimize }));
   if (n.private) wrap.appendChild(el('p', { class: 'nt-hint', 'data-nt-private': '' }, 'This note is private: it is not recorded, and nothing from it goes to Jev or to any agent.'));
   const pl = !listening(n) ? playerFor(ctx, n) : null;
-  if (pl) wrap.appendChild(el('div', { class: 'nt-replay', 'data-nt-part': 'replay' }, el('span', { class: 'nt-sec__h' }, 'Replay'), pl.el));
+  if (pl) wrap.appendChild(el('div', { class: 'nt-replay', 'data-nt-part': 'replay' }, el('span', { class: 'nt-sec__h' }, 'Replay'), own(pl.el)));
   wrap.appendChild(el('div', { class: 'nt-body2' }, noteColumn(ctx, n, ed), transcriptColumn(ctx, n, { inline: true })));
   if (pl) queueMicrotask(paintNow);
   if (n.agent && n.agent.started && !n.agent.markdown && !agentTimer) pollAgent(ctx, n.id);
   host.appendChild(wrap);
-  keep();
-  return true;
 }

package/workspace/test-lists/meeting-notes.json

@@ -1,5 +1,5 @@
 {
-  "_comment": "meeting-notes Runs 1 to 10: the Notes engine and routes (notes.test.js), local Whisper, line labels and repository checks (notes-listen.test.js), the final pass after Stop and the Wispr Flow fetch (notes-final.test.js), Qwen3-ASR kept loaded (notes-qwen.test.js), and the Notes view in a browser (pm-notes-test.js).",
+  "_comment": "meeting-notes Runs 1 to 10: the Notes engine and routes (notes.test.js), local Whisper, line labels and repository checks (notes-listen.test.js), the final pass after Stop and the Wispr Flow fetch (notes-final.test.js), Qwen3-ASR kept loaded (notes-qwen.test.js), and the Notes view in a browser (pm-notes-test.js), plus the note pop-up patched in place while it listens (pm-note-dock-test.js).",
   "modules": [
     "notes.test.js",
     "notes-listen.test.js",
@@ -7,13 +7,15 @@
     "notes-qwen.test.js"
   ],
   "panels": [
-    "pm-notes-test.js"
+    "pm-notes-test.js",
+    "pm-note-dock-test.js"
   ],
   "seconds": {
     "notes.test.js": 12,
     "pm-notes-test.js": 40,
     "notes-listen.test.js": 10,
     "notes-final.test.js": 6,
-    "notes-qwen.test.js": 4
+    "notes-qwen.test.js": 4,
+    "pm-note-dock-test.js": 20
   }
 }