create-pmos 0.79.0 → 0.81.0

package/workspace/lib/routes-notes.js

@@ -61,6 +61,7 @@ const whisper = require('./notes-whisper.js');
 const notesRepo = require('./notes-repo.js');
 const notesAudio = require('./notes-audio.js');
 const notesFinal = require('./notes-final.js');
+const notesQwen = require('./notes-qwen.js');
 const notesLinks = require('./notes-links.js');
 const jevNotes = require('./jev-notes.js');
 const tsSettings = require('./typesafe-settings.js');
@@ -283,7 +284,20 @@ function vocabFor(ctx, id) {
   return text;
 }
 
-/* ── local Whisper: one transcriber for the process ───────────────────────────────────────────── */
+/* ── local transcription: one transcriber for the process ─────────────────────────────────────── */
+/* THE LIVE ENGINE (Run 10). Qwen3-ASR when it is set up (lib/notes-qwen.js: more accurate, Chinese and Indonesian too, kept
+ * loaded so each cut is quick), else whisper.cpp. ctx.notesQwenDetect and ctx.notesQwenRun replace them in the suites. */
+function qwenDetect(ctx) { return ctx.notesQwenDetect ? ctx.notesQwenDetect() : notesQwen.detect(ctx.runtimeDir); }
+function liveDetect(ctx) {
+  const q = qwenDetect(ctx);
+  if (q.ready) return { ready: true, engine: 'qwen', model: q.live, bin: null };
+  return { ...whisper.detect(ctx.runtimeDir), engine: 'whisper' };
+}
+function liveRun(ctx, args) {
+  if (args.engine !== 'qwen') return whisper.runWhisper(args);
+  if (ctx.notesQwenRun) return ctx.notesQwenRun(args);
+  return notesQwen.runQwen(notesQwen.workerFor(ctx.runtimeDir), args);
+}
 let transcriber = null; let transcriberDir = null;
 const audioErrors = new Map();   // note id → the last thing that went wrong, for the page
 function transcriberFor(ctx) {
@@ -291,6 +305,8 @@ function transcriberFor(ctx) {
   transcriberDir = ctx.runtimeDir;
   transcriber = whisper.createTranscriber({
     runtimeDir: ctx.runtimeDir,
+    detect: () => liveDetect(ctx),
+    run: (args) => liveRun(ctx, args),
     vocab: ({ id }) => vocabFor(ctx, id),
     onText: async (c) => {
       const r = notes.appendTranscript(ctx.runtimeDir, { id: c.id, text: c.text, source: c.source, t: c.t, ms: c.ms });
@@ -302,7 +318,8 @@ function transcriberFor(ctx) {
 }
 function engineInfo(ctx, w) {
   const d = whisper.detect(ctx.runtimeDir);
-  const out = { ready: d.ready, missing: d.missing, setup: d.setup, model_dir: d.model_dir, model_size: d.model_size,
+  const live = liveDetect(ctx);
+  const out = { ready: live.ready, live: live.ready ? live.engine : null, missing: d.missing, setup: d.setup, model_dir: d.model_dir, model_size: d.model_size,
     language: whisper.getLanguage(ctx.runtimeDir), languages: whisper.LANGUAGES.map(([value, label]) => ({ value, label })),
     model: whisper.getModel(ctx.runtimeDir), models: whisper.MODELS.map((m) => ({ value: m.id, label: m.label })),
     accuracy: whisper.getAccuracy(ctx.runtimeDir), accuracies: whisper.ACCURACIES.map((a) => ({ value: a.id, label: a.label })), keep_audio: notesAudio.getKeep(ctx.runtimeDir),
@@ -336,6 +353,7 @@ function finalFor(ctx) {
     runtimeDir: ctx.runtimeDir,
     ...(ctx.notesFinalRun ? { run: ctx.notesFinalRun } : {}),
     ...(ctx.notesFinalDetect ? { detect: ctx.notesFinalDetect } : {}),
+    ...(ctx.notesQwenRun ? { qwen: ctx.notesQwenRun } : {}),
     onState: (id, st) => { if (st.state !== 'done') notes.setFinalState(ctx.runtimeDir, { id, state: st }); },
     onDone: (id, final) => {
       const dir = ctx.runtimeDir;
@@ -564,7 +582,7 @@ async function handle(req, res, url, ctx) {
     if (b64.length > Math.ceil(MAX_PCM_BYTES / 3) * 4) return done({ ok: false, status: 413, error: 'that audio chunk is too long' });
     const pcm = Buffer.from(b64, 'base64');
     if (pcm.length % 2) return done({ ok: false, status: 400, error: 'the audio must be 16-bit samples' });
-    if (!whisper.detect(dir).ready) return done({ ok: false, status: 409, error: 'local transcription is not set up' });
+    if (!liveDetect(ctx).ready) return done({ ok: false, status: 409, error: 'local transcription is not set up' });
     const ms = (pcm.length / 2 / whisper.RATE) * 1000;
     const t = Math.max(0, notes.meetingMs(note.note) - ms);
     // the audio is kept for replay unless the PM switched that off (D92); a private note never reaches this line

package/workspace/package-lock.json

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

package/workspace/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmos-workspace",
-  "version": "0.79.0",
+  "version": "0.81.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

@@ -30,7 +30,7 @@
  * the shell still comes up.
  */
 
-import { el, clear, setChildren } from './dom.js';
+import { el, clear, setChildren, keepScroll } from './dom.js';
 import { state, setState, subscribe, flush, FIXTURE, LEGACY_LAYOUT_FLAG } from './state.js';
 /* The phone surface (≤760px). It owns its own chrome and decides which single panel is visible;
  * the shell's only part in it is to keep all four hosts mounted below the breakpoint and to hand
@@ -563,6 +563,8 @@ let frDetail = null;
 const hostMain = el('div', { class: 'fr-main', 'data-fr': 'main' });
 const destHosts = {};
 for (const id of FRAME_DESTS) destHosts[id] = el('div', { class: 'fr-dest', 'data-fr-host': id, hidden: true });
+// each place keeps its reading position when it redraws through a short state (dom.js keepScroll)
+for (const id of FRAME_DESTS) keepScroll(destHosts[id]);
 const frEnd = el('span', { class: 'fr-end', 'aria-hidden': 'true' });
 
 function setupFrame() {

package/workspace/public/pm/components.css

@@ -5,7 +5,9 @@
  *   primitives  `.pmc-*` — written only by primitives.js and icons.js (R28-9)
  *   layouts     `.bd-*`  — the Breakdown's own arrangement of those primitives
  * Every selector starts with `.pmc-` or `.bd-`. Colours are tokens.css variables only; there is no hex and no oklch here.
- * Radius is 0 (a dot is the one round shape). Hover rules sit inside (hover: hover). Under a coarse pointer every
+ * Radius (R27 as amended by the PM 2026-10-07): 6px on controls (buttons, inputs, selects, tabs, segmented controls,
+ * badges, menu items, checkboxes), 8px on cards, sheets, dialogs, menus, tiles and panels; a dot (50% or a pill) stays round.
+ * Buttons, tabs and segmented controls use sentence case; small non-interactive eyebrows may stay uppercase at 0.04em. Hover rules sit inside (hover: hover). Under a coarse pointer every
  * control is at least 44px and every row and card at least 48px.
  */
 
@@ -53,15 +55,13 @@
   min-height: 32px;
   padding: 0 14px;
   border: 1px solid var(--border);
-  border-radius: 0;
+  border-radius: 6px;
   background: transparent;
   color: var(--foreground);
   font-family: var(--sans);
   font-size: 12px;
   line-height: 1;
-  font-weight: 600;
-  letter-spacing: 0.1em;
-  text-transform: uppercase;
+  font-weight: 500;
   white-space: nowrap;
   cursor: pointer;
   user-select: none;
@@ -128,6 +128,7 @@
   display: none;
 }
 .pmc-field {
+  position: relative;
   display: flex;
   flex-direction: column;
   gap: 2px;
@@ -141,6 +142,8 @@
 }
 .pmc-field__label--hidden {
   position: absolute;
+  top: 0;
+  left: 0;
   width: 1px;
   height: 1px;
   overflow: hidden;
@@ -158,7 +161,7 @@
   padding: 0;
   border: 0;
   border-bottom: 1px solid var(--input);
-  border-radius: 0;
+  border-radius: 6px;
   background: transparent;
   color: var(--foreground);
   font-family: var(--sans);
@@ -218,7 +221,7 @@
   height: 16px;
   margin: 0;
   border: 1px solid var(--muted-foreground);
-  border-radius: 0;
+  border-radius: 6px;
   background: transparent;
   cursor: pointer;
 }
@@ -249,7 +252,7 @@
   font-size: 11px;
   line-height: 16px;
   font-weight: 600;
-  letter-spacing: 0.05em;
+  letter-spacing: 0.04em;
   text-transform: uppercase;
   white-space: nowrap;
   color: var(--muted-foreground);
@@ -452,7 +455,7 @@
   min-width: 0;
   min-height: 36px;
   padding: 10px 12px;
-  border-radius: 0;
+  border-radius: 8px;
   background: var(--card);
   color: var(--foreground);
   box-shadow: 0 0 0 1px color-mix(in oklab, var(--foreground) 9%, transparent),
@@ -553,14 +556,14 @@
   min-height: 26px;
   padding: 0 12px;
   border: 1px solid transparent;
-  border-radius: 0;
+  border-radius: 6px;
   background: transparent;
   color: color-mix(in oklab, var(--foreground) 68%, transparent);
   font-family: var(--sans);
   font-size: 12px;
   line-height: 1;
   font-weight: 600;
-  letter-spacing: 0.06em;
+  letter-spacing: 0.04em;
   text-transform: uppercase;
   white-space: nowrap;
   cursor: pointer;
@@ -615,7 +618,7 @@
   overflow: auto;
   padding: 4px;
   border: 0;
-  border-radius: 0;
+  border-radius: 8px;
   background: var(--card);
   color: var(--foreground);
   font-family: var(--sans);
@@ -633,7 +636,7 @@
   min-height: 32px;
   padding: 0 12px;
   border: 0;
-  border-radius: 0;
+  border-radius: 6px;
   background: transparent;
   color: var(--foreground);
   font: inherit;
@@ -663,7 +666,7 @@
   margin: 0;
   padding: 0;
   border: 0;
-  border-radius: 0;
+  border-radius: 8px;
   background: var(--card);
   color: var(--foreground);
   font-family: var(--sans);
@@ -794,7 +797,7 @@
   min-height: 44px;
   padding: 4px 4px 4px 16px;
   border: 0;
-  border-radius: 0;
+  border-radius: 8px;
   background: var(--card);
   color: var(--foreground);
   font-family: var(--sans);
@@ -936,7 +939,7 @@
   margin: 0;
   padding: 0;
   border: 0;
-  border-radius: 0;
+  border-radius: 6px;
   background: transparent;
   color: inherit;
   transform: translateY(-50%);
@@ -1084,7 +1087,7 @@
   margin-right: 10px;
   font-size: 12px;
   font-weight: 600;
-  letter-spacing: 0.08em;
+  letter-spacing: 0.04em;
   text-transform: uppercase;
 }
 .bd-entry__meta {
@@ -1200,7 +1203,7 @@
   font-size: 11px;
   line-height: 16px;
   font-weight: 600;
-  letter-spacing: 0.05em;
+  letter-spacing: 0.04em;
   text-transform: uppercase;
   color: var(--muted-foreground);
 }
@@ -1287,7 +1290,7 @@
   font-size: 12px;
   line-height: 16px;
   font-weight: 600;
-  letter-spacing: 0.06em;
+  letter-spacing: 0.04em;
   text-transform: uppercase;
 }
 .bd-col__n {
@@ -1545,10 +1548,9 @@
 .in-head__title {
   flex: 1 1 auto;
   margin: 0;
-  font-size: 16px;
-  line-height: 24px;
-  font-weight: 600;
-  letter-spacing: -0.01em;
+  font-size: 20px;
+  line-height: 28px;
+  font-weight: 500;
 }
 .in-body {
   display: flex;
@@ -1645,7 +1647,7 @@
   font-size: 12px;
   line-height: 16px;
   font-weight: 600;
-  letter-spacing: 0.06em;
+  letter-spacing: 0.04em;
   text-transform: uppercase;
   font-variant-numeric: tabular-nums;
 }
@@ -1670,7 +1672,7 @@
   font-size: 12px;
   line-height: 16px;
   font-weight: 600;
-  letter-spacing: 0.06em;
+  letter-spacing: 0.04em;
   text-transform: uppercase;
 }
 .in-col__count {
@@ -1910,7 +1912,7 @@
   font-size: 12px;
   line-height: 16px;
   font-weight: 600;
-  letter-spacing: 0.06em;
+  letter-spacing: 0.04em;
   text-transform: uppercase;
 }
 .in-starters {
@@ -2133,7 +2135,7 @@
   margin: 0;
   font-size: 12px;
   font-weight: 600;
-  letter-spacing: 0.1em;
+  letter-spacing: 0.04em;
   text-transform: uppercase;
   color: var(--muted-foreground);
 }
@@ -2266,6 +2268,8 @@
   min-width: 0;
   min-height: 0;
   overflow-y: auto;
+  /* the destination is the one thing that scrolls: a wheel at its end does not move the page and its bars */
+  overscroll-behavior: contain;
 }
 .fr-dest[hidden] {
   display: none;
@@ -2476,7 +2480,7 @@
   color: var(--muted-foreground);
   font-size: 11px;
   font-weight: 600;
-  letter-spacing: 0.1em;
+  letter-spacing: 0.04em;
   text-transform: uppercase;
   text-overflow: ellipsis;
   white-space: nowrap;
@@ -2765,7 +2769,7 @@
   color: var(--muted-foreground);
   font-size: 11px;
   font-weight: 600;
-  letter-spacing: 0.1em;
+  letter-spacing: 0.04em;
   text-transform: uppercase;
   list-style: none;
   cursor: pointer;
@@ -3007,7 +3011,7 @@
   color: var(--muted-foreground);
   font-size: 11px;
   font-weight: 600;
-  letter-spacing: 0.1em;
+  letter-spacing: 0.04em;
   text-transform: uppercase;
 }
 .fr-rail__graph {
@@ -3089,7 +3093,7 @@
   color: var(--muted-foreground);
   font-size: 11px;
   font-weight: 600;
-  letter-spacing: 0.1em;
+  letter-spacing: 0.04em;
   text-transform: uppercase;
 }
 .fr-rail__finding[data-status="stale"] .fr-rail__finding-s,
@@ -3245,7 +3249,7 @@
 .td-day__warn { color: var(--warning); }
 .td-day__mono { font-family: var(--mono); font-variant-numeric: tabular-nums; font-size: 12px; }
 .td-day__steps { display: flex; flex-wrap: wrap; gap: 2px; list-style: none; margin: 0; padding: 0; }
-.td-day__ts { gap: 6px; padding: 0 6px; letter-spacing: 0.04em; color: var(--muted-foreground); }
+.td-day__ts { border-radius: 6px; gap: 6px; padding: 0 6px; letter-spacing: 0.04em; color: var(--muted-foreground); }
 .td-day__ts[data-step-state="done"], .td-day__ts[data-step-state="now"] { color: var(--foreground); }
 .td-day__ts[data-step-state="now"] { background: var(--muted); }
 .td-day__ts[aria-current="true"] { border-color: var(--ring); }
@@ -3260,14 +3264,15 @@
 .td-day__run--failed { color: var(--destructive); }
 .td-day__note { margin: 0; font-size: 12px; line-height: 16px; color: var(--muted-foreground); }
 
-.td-day__cols { display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1.25fr); gap: 12px; align-items: start; }
-.td-day__left { display: grid; gap: 12px; min-width: 0; }
+.td-day__cols { display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1.25fr); gap: 12px; align-items: stretch; }
+.td-day__left { display: grid; gap: 12px; min-width: 0; align-content: start; }
 .td-day__panel, .td-day__detail {
   display: grid;
   gap: 8px;
   min-width: 0;
   padding: 10px 12px;
   border: 1px solid var(--border);
+  border-radius: 8px;
   background: var(--card);
 }
 .td-day__detail { position: sticky; top: 8px; max-height: calc(100vh - 16px); overflow: auto; align-content: start; }
@@ -3282,7 +3287,7 @@
   margin: 0;
   font-size: 12px;
   font-weight: 600;
-  letter-spacing: 0.06em;
+  letter-spacing: 0.04em;
   text-transform: uppercase;
   color: var(--muted-foreground);
 }
@@ -3295,7 +3300,7 @@
 .td-day__lead { min-width: 44px; font: 12px var(--mono); color: var(--muted-foreground); font-variant-numeric: tabular-nums; }
 .td-day__chips { display: inline-flex; gap: 4px; }
 .td-day__chips { align-items: center; flex-wrap: wrap; justify-content: flex-end; }
-.td-day__repo { font: inherit; font-size: 12px; color: var(--foreground); background: var(--background); border: 1px solid var(--border); border-radius: 0; padding: 2px 6px; max-width: 160px; }
+.td-day__repo { font: inherit; font-size: 12px; color: var(--foreground); background: var(--background); border: 1px solid var(--border); border-radius: 6px; padding: 2px 6px; max-width: 160px; }
 .td-day__repo:focus-visible { outline: 2px solid color-mix(in oklab, var(--ring) 50%, var(--foreground)); outline-offset: 2px; }
 .td-day__nowrow { display: flex; align-items: center; gap: 8px; padding: 0 8px; font: 11px var(--mono); color: var(--destructive); }
 .td-day__nowrow::after { content: ""; flex: 1; border-top: 2px solid var(--destructive); }
@@ -3306,7 +3311,7 @@
 
 /* the detail */
 .td-day__dhead { display: grid; gap: 4px; }
-.td-day__kind { font: 11px var(--mono); letter-spacing: 0.06em; text-transform: uppercase; color: var(--muted-foreground); }
+.td-day__kind { font: 11px var(--mono); letter-spacing: 0.04em; text-transform: uppercase; color: var(--muted-foreground); }
 .td-day__dhead h3 { margin: 0; font-size: 16px; line-height: 24px; color: var(--foreground); }
 .td-day__detail p { margin: 0; font-size: 14px; line-height: 20px; color: var(--foreground); }
 .td-day__detail p.td-day__note { font-size: 12px; line-height: 16px; color: var(--muted-foreground); }
@@ -3317,11 +3322,10 @@
   height: 28px;
   padding: 0 10px;
   border: 1px solid var(--border);
+  border-radius: 6px;
   color: var(--foreground);
   font-size: 12px;
-  font-weight: 600;
-  letter-spacing: 0.1em;
-  text-transform: uppercase;
+  font-weight: 500;
   text-decoration: none;
   white-space: nowrap;
 }
@@ -3329,7 +3333,7 @@
 @media (pointer: coarse) { .td-day__a { min-height: 44px; } }
 .td-day__phase, .td-day__rel { display: grid; gap: 4px; }
 .td-day__phase h4, .td-day__rel h4, .td-day__notes h4, .td-day__draftbox h4, .td-day__more h4 {
-  margin: 0; font-size: 11px; letter-spacing: 0.06em; text-transform: uppercase; color: var(--muted-foreground);
+  margin: 0; font-size: 11px; letter-spacing: 0.04em; text-transform: uppercase; color: var(--muted-foreground);
 }
 .td-day__chk { list-style: none; margin: 0; padding: 0; display: grid; gap: 4px; font-size: 14px; color: var(--foreground); }
 .td-day__chk li { display: grid; grid-template-columns: 16px minmax(0, 1fr); gap: 6px; }
@@ -3351,7 +3355,7 @@
 .td-day__draft { margin: 0; max-height: 220px; overflow: auto; padding: 8px 10px; white-space: pre-wrap; font: 12px/1.5 var(--mono); background: var(--muted); color: var(--foreground); }
 .td-day__revise { display: grid; gap: 6px; }
 /* act and prepare (initiative today-act-prepare): a verb first, one sentence, the steps, one button that fits, the marks */
-.td-day__verb { display: inline-block; min-width: 58px; padding: 2px 5px; border: 1px solid currentColor; font: 600 10px/1.3 var(--mono); letter-spacing: 0.05em; text-transform: uppercase; text-align: center; color: var(--foreground); white-space: nowrap; }
+.td-day__verb { display: inline-block; min-width: 58px; padding: 2px 5px; border: 1px solid currentColor; font: 600 10px/1.3 var(--mono); letter-spacing: 0.04em; text-transform: uppercase; text-align: center; color: var(--foreground); white-space: nowrap; }
 .td-day__verb[data-verb="decide"], .td-day__verb[data-verb="prepare"] { color: var(--warning); }
 .td-day__acth { margin: 0; font-size: 16px; font-weight: 600; line-height: 1.3; text-wrap: balance; }
 .td-day__todo { margin: 0; padding: 7px 10px; border-left: 3px solid var(--foreground); background: var(--muted); font-size: 14px; line-height: 1.45; color: var(--foreground); }
@@ -3459,7 +3463,7 @@
   gap: 8px;
   min-width: 0;
   padding: 10px 12px;
-  border-radius: 0;
+  border-radius: 8px;
   background: var(--card);
   color: var(--foreground);
   box-shadow: 0 0 0 1px var(--border);
@@ -3553,7 +3557,7 @@
 }
 .td-health {
   padding: 8px 12px;
-  border-radius: 0;
+  border-radius: 8px;
   background: var(--muted);
   box-shadow: inset 2px 0 0 var(--warning);
   font-size: 12px;
@@ -4011,13 +4015,13 @@
   margin: 16px 16px 0;
   padding: 12px;
   border: 1px solid var(--border);
-  border-radius: 0;
+  border-radius: 8px;
 }
 .bo-releases__head {
   font-size: 12px;
   line-height: 16px;
   font-weight: 600;
-  letter-spacing: 0.06em;
+  letter-spacing: 0.04em;
   text-transform: uppercase;
 }
 .bo-releases__note {
@@ -4036,7 +4040,7 @@
 .bo-rel--today {
   padding: 10px 12px;
   border: 1px solid var(--border);
-  border-radius: 0;
+  border-radius: 8px;
   background: var(--card);
 }
 .bo-rel__main {
@@ -4119,7 +4123,7 @@
   font-size: 11px;
   line-height: 16px;
   font-weight: 500;
-  letter-spacing: 0.1em;
+  letter-spacing: 0.04em;
   text-transform: uppercase;
   color: var(--muted-foreground);
 }
@@ -4266,7 +4270,7 @@
   font-family: var(--mono);
   font-size: 11px;
   font-weight: 500;
-  letter-spacing: 0.1em;
+  letter-spacing: 0.04em;
   text-transform: uppercase;
   color: var(--muted-foreground);
 }
@@ -5883,6 +5887,8 @@
 }
 .nt-sr {
   position: absolute;
+  top: 0;
+  left: 0;
   width: 1px;
   height: 1px;
   overflow: hidden;
@@ -5925,7 +5931,7 @@
   margin: 0;
   font-size: 11px;
   font-weight: 500;
-  letter-spacing: .06em;
+  letter-spacing: 0.04em;
   text-transform: uppercase;
   color: var(--muted-foreground);
 }
@@ -6200,7 +6206,7 @@
   gap: 2px;
   padding: 8px 12px;
   border: 1px solid var(--border);
-  border-radius: 0;
+  border-radius: 8px;
   background: var(--background);
   color: var(--foreground);
   font: inherit;
@@ -6585,10 +6591,9 @@
   color: var(--foreground);
 }
 
-/* R27: the dock draws no rounded corner. The tab strip and the scratchpad were drawn with inline radii (workspace-cockpit-nav);
-   this rule wins over them, so the strip is sharp like every other surface. A tab's colour dot is a dot and keeps its circle. */
-.lg-dock *:not([data-tab-dot]) {
-  border-radius: 0 !important;
-}
+/* R27 as amended by the PM 2026-10-07: the dock follows the same radii as every other surface (6px controls, 8px
+   containers). The tab strip and the scratchpad are drawn with inline radii (workspace-cockpit-nav); the inline radii
+   (8px tab strip, 6px controls) stay. A tab's colour dot is a dot and keeps its circle. */
+
 
 /* -- end of the layout sections: add nothing below this line -- */

package/workspace/public/pm/dest-today.js

@@ -12,7 +12,7 @@
  * The legacy Today view (view-today.js) calls mountToday on its own host, so both surfaces draw the one list.
  */
 
-import { el } from './dom.js';
+import { el, withAnchor } from './dom.js';
 import { empty, tabs, button, toast, ensureComponentsCss } from './primitives.js';
 import { registerTodaySource, todayCards, todayCount, openInitiative } from './registry.js';
 import { repoTuples } from './panel-repos.js';
@@ -200,7 +200,8 @@ export function mountToday(host, ctx) {
   if (out.sig === r.sig) return;
   const k = focusKey(r.root);
   r.sig = out.sig;
-  r.root.replaceChildren(...out.children.filter(Boolean));
+  // a card added or removed above the reader must not move what they are reading (dom.js withAnchor)
+  withAnchor(host, r.root, 'data-today-id', () => r.root.replaceChildren(...out.children.filter(Boolean)));
   refocus(r.root, k);
 }
 

package/workspace/public/pm/dom.js

@@ -114,3 +114,63 @@ export function setChildren(parent, kids) {
   });
   return parent;
 }
+
+/**
+ * Keep the reader's place across a rebuild (UI comfort, 2026-10-07: "when I scroll down into a section it pages up").
+ * Before `rebuild()` runs, the first element carrying `attr` that is still on screen in `scroller` is remembered with its
+ * offset from the scroller's top; afterwards the scroller is moved so that same element sits at that same offset. A
+ * card added or removed above the reader therefore no longer pushes what they are reading off the screen. With the
+ * scroller at its top, or no such element, it only runs `rebuild()`.
+ */
+export function withAnchor(scroller, root, attr, rebuild) {
+  let key = null;
+  let off = 0;
+  if (scroller && scroller.scrollTop > 0 && root) {
+    const top = scroller.getBoundingClientRect().top;
+    for (const n of root.querySelectorAll('[' + attr + ']')) {
+      const r = n.getBoundingClientRect();
+      if (r.height && r.bottom > top) { key = n.getAttribute(attr); off = r.top - top; break; }
+    }
+  }
+  rebuild();
+  if (key == null) return;
+  const again = [...root.querySelectorAll('[' + attr + ']')].find((n) => n.getAttribute(attr) === key);
+  if (!again) return;
+  const drift = again.getBoundingClientRect().top - scroller.getBoundingClientRect().top - off;
+  if (Math.abs(drift) >= 1) scroller.scrollTop += drift;
+}
+
+/**
+ * Give a scroller its reading position back when a rebuild took it away (UI comfort, 2026-10-07). A destination that
+ * redraws through a short state — a "Reading…" line, an emptied list — collapses the scroller, the browser clamps the
+ * offset towards the top, and when the content returns the reader is left at the top. This watches the scroller's
+ * subtree: when a change leaves the offset ABOVE where the reader last was and the content has shrunk below it, that
+ * place is held, and the next change that makes the content tall enough again returns to it. Anything the reader does
+ * (wheel, touch, a key, a click) drops what is held, so their own scrolling always wins. Returns its undo.
+ */
+export function keepScroll(scroller) {
+  let top = scroller.scrollTop;
+  let held = null;
+  let until = 0;
+  const drop = () => { held = null; };
+  const onScroll = () => { if (held == null) top = scroller.scrollTop; };
+  const intents = ['wheel', 'touchstart', 'keydown', 'pointerdown'];
+  for (const ev of intents) scroller.addEventListener(ev, drop, { passive: true, capture: true });
+  scroller.addEventListener('scroll', onScroll, { passive: true });
+  const mo = new MutationObserver(() => {
+    if (scroller.hidden || !scroller.isConnected) return;
+    const max = scroller.scrollHeight - scroller.clientHeight;
+    if (held == null) {
+      if (top > 0 && scroller.scrollTop < top - 1 && max < top) { held = top; until = Date.now() + 5000; }
+      return;
+    }
+    if (Date.now() > until) { held = null; top = scroller.scrollTop; return; }
+    if (max >= held - 1) { scroller.scrollTop = held; top = held; held = null; }
+  });
+  mo.observe(scroller, { childList: true, subtree: true, characterData: true });
+  return () => {
+    mo.disconnect();
+    for (const ev of intents) scroller.removeEventListener(ev, drop, { capture: true });
+    scroller.removeEventListener('scroll', onScroll);
+  };
+}

package/workspace/public/pm/roadmap.js

@@ -20,7 +20,7 @@
  *   env = { repo, ws, openInitiative(repo, slug), onData?(answer) }
  */
 
-import { el } from './dom.js';
+import { el, withAnchor } from './dom.js';
 import { card, iconButton, dragHandle, button, menu, empty, toast, SEL } from './primitives.js';
 import { watchSig } from './sig-watch.js';
 import { loadSortable, baseOptions, dragSet } from './bd-drag.js';
@@ -211,7 +211,7 @@ export function mountRoadmap(host, env) {
     const kids = [headLine(), el('p', { class: 'in-note in-hint', 'data-in-hint': '' }, COPY.menuHintCard)];
     if (data.flags && data.flags.length) kids.push(el('p', { class: 'in-note', 'data-in-flags': '' }, COPY.flags(data.flags.length)));
     kids.push(el('div', { class: 'in-cols', 'data-in-cols': '' }, HORIZONS.map(column)));
-    root.replaceChildren(...kids);
+    withAnchor(root.closest('.fr-dest'), root, 'data-in-card', () => root.replaceChildren(...kids));
     if (refocus) { const t = root.querySelector('[data-in-open="' + CSS.escape(refocus) + '"]'); if (t) t.focus({ preventScroll: true }); }
     bindDrag();
   }

package/workspace/public/pm/topbar.js

@@ -36,6 +36,9 @@ export function unsyncedOf(st) {
     && ((st.behind | 0) > 0 || (st.ahead | 0) > 0 || (st.dirty_records | 0) > 0 || st.remote_stale === true);
 }
 
+/** The lucide symbol each place wears in the bar (UI comfort, 2026-10-07: a word alone is slow to find; the phone's tab bar already wears these). */
+const NAV_ICON = Object.freeze({ today: 'house', mywork: 'list-checks', initiatives: 'target', board: 'square-kanban', reports: 'chart-column', docs: 'file-text', people: 'share-2', settings: 'settings' });
+
 export function createTopbar({ go, openPalette, repoMenu, sync } = {}) {
   const node = el('header', { class: 'fr-bar', 'data-shell': 'top', 'data-fr': 'bar' });
 
@@ -48,7 +51,7 @@ export function createTopbar({ go, openPalette, repoMenu, sync } = {}) {
   const links = {};
   for (const id of [...BAR_DESTS, 'settings']) {
     links[id] = button({
-      label: COPY.nav[id], variant: 'ghost', icon: id === 'settings' ? 'settings' : undefined,
+      label: COPY.nav[id], variant: 'ghost', icon: NAV_ICON[id],
       attrs: { class: 'fr-link', 'data-fr-dest': id, 'aria-current': 'false' },
       onClick: () => go && go(id),
     });