create-pmos 0.99.0 → 0.100.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.99.0",
+  "version": "0.100.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@206cc37
+kernel-source: pmos@42d0a34
 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-08T00:18:17Z"}
+generated: {by: process:create-pmos, at: "2026-10-08T00:23:24Z"}
 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-08T00:18:17Z"}
+generated: {by: process:create-pmos, at: "2026-10-08T00:23:24Z"}
 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-08T00:18:17Z"}
+generated: {by: process:create-pmos, at: "2026-10-08T00:23:24Z"}
 status: stable
 ---
 

package/workspace/guide/layout.md

@@ -39,7 +39,7 @@ Settings holds settings only, in eight sections. On a wide screen they are cards
 - **Updates**: the version of the workspace app and the version of the kit in the current repository. Press **Check for updates** at the top of the page to compare them with the latest published version of PMOS. This is the only time the workspace asks the internet for a version, and it asks only when you press. When a newer version is available, one button shows: **Update to** and the version. It updates every part that is older, in this order:
   - **The kit** in the current repository, when it is older. This does what `npx create-pmos@latest --update` does in a terminal. It changes only the kit's own files under `pmos/` (skills, scripts, templates and guides). Your records in `state/`, `planning/` and `okf/product/` do not change. The last lines of the output show under the button. The changed files are under `pmos/`, which Sync treats as records, so Sync (or automatic sync) sends them with your other records. To read them first, look at `git diff pmos/` before you sync.
   - **The workspace app**, when it is older. This does what `pmos upgrade` does in a terminal. The button asks you first. The workspace stops, installs the new version and starts again, and the page reloads when the new version starts. The reloaded page runs the new version's code: each start gives the page files a new address, so neither the browser nor the Online address's tunnel can keep the old ones. You do not need a terminal or a hard refresh. Sessions keep running in tmux. It works on the computer that runs the workspace and at its Online address, because the page comes back there after the restart. It also works on a phone or public address that signs in with a token set in `PMOS_TOKEN`, which the workspace keeps. When the workspace made its own token at start, the token changes on the restart, so the page refuses and says where to press it. When the workspace runs from a PMOS checkout, update it with `git pull` instead.
-  - **Testing an update before it is published.** Set `PMOS_UPDATE_SOURCE` to a built create-pmos package on the same computer: its folder, or the `.tgz` that `npm pack` makes. Then **Check for updates** reads that package's version and does not ask npm, and both updates install that package. The Updates card names the package it checks. A checkout may update the app this way. When the path is wrong, the card says why and does not fall back to npm. Unset the variable, or set it to `npm`, to use the registry again.
+  - **Testing an update before it is published.** In a PMOS checkout, run `bash scripts/build-local-package.sh`. It builds the package that a publish would build, in `~/.pmos-local-package`, with a version newer than the published one, and prints the command that starts the workspace on it. That command sets `PMOS_UPDATE_SOURCE` to the package on the same computer: its folder, or the `.tgz` that `npm pack` makes. Then **Check for updates** reads that package's version and does not ask npm, and both updates install that package. The Updates card names the package it checks. A checkout may update the app this way. When the path is wrong, the card says why and does not fall back to npm. Unset the variable, or set it to `npm`, to use the registry again.
 
   A new screen or a renamed menu comes with the workspace app, not with the kit.
 

package/workspace/guide/today.md

@@ -100,6 +100,8 @@ When the job is a reply or a review, you can finish it in the card. Write your a
 
 A meeting that needs prep is a row of **Needs you**, with the verb **Prepare**. Its detail shows the prep, how many steps are ready, the free time before the meeting, and the steps before it. A step that reads a source shows what the source says under it. A step that asks for your view, such as **Write your recommendation**, has a box for your note. The note is saved when you leave the box. It stays with the meeting on this computer and is not sent. A step that the brief already marked done stays checked.
 
+When a meeting ends, its detail stays as it was. A line at the top says **ended** and the time it ended. The prep and the steps stay, in a quieter box, so you can still read what you prepared. The meeting leaves **Needs you**, and its notes show under it.
+
 When you finish or put off a job or a meeting, mark it:
 
 | Press | What it does |

package/workspace/lib/kit-update.js

@@ -17,7 +17,7 @@
  *   app          npx -y create-pmos@<version> workspace --reinstall <repo> (what `pmos upgrade` runs)
  * LOCAL SOURCE. PMOS_UPDATE_SOURCE names a built create-pmos package on this computer: its folder (with package.json, bin/
  * and payload/ or workspace/) or its .tgz from `npm pack`. The check then reads that package's version instead of asking
- * the registry, and the update runs `npx -y <that path> ...` in place of `npx -y create-pmos@<version> ...`. Nothing
+ * the registry, and the update runs `npx -y --package=<that path> -- create-pmos ...` in place of `npx -y create-pmos@<version> ...`. Nothing
  * reaches the network, so an update can be tried before it is published. Unset means npm (the default).
  * The version is the one the check found, so what is installed is what the PM was shown, not whatever `latest` is a
  * minute later. The app upgrade stops this server (create-pmos runs `pmos stop`), so it runs DETACHED, writes its output
@@ -108,8 +108,13 @@ function source(env = process.env) {
   return { kind: 'local', path: p, version: m[1] };
 }
 
-/** What npx installs: the registry package at a version, or the local path. */
-const specOf = (src, version) => (src && src.kind === 'local' ? src.path : `${PKG_NAME}@${version}`);
+/**
+ * The npx arguments that run create-pmos: the registry package at a version, or the local path. A bare path is not
+ * enough: npx would try to run it as a command, so a local package goes in with --package.
+ */
+const npxArgs = (src, version, rest) => (src && src.kind === 'local'
+  ? ['-y', `--package=${src.path}`, '--', PKG_NAME, ...rest]
+  : ['-y', `${PKG_NAME}@${version}`, ...rest]);
 
 function status({ root, appVersion, appDir, env }) {
   const src = source(env);
@@ -175,7 +180,7 @@ async function updateKit(root, { version, exec = cp.execFile, source: src = sour
   if (!validVersion(version)) return { ok: false, error: 'Check for updates first' };
   if (src.kind === 'local' && src.error) return { ok: false, error: src.error };
   if (!readKit(root).present) return { ok: false, error: 'This repository has no PMOS kit folder (pmos/KIT-VERSION)' };
-  const r = await run(exec, NPX, ['-y', specOf(src, version), '--update', String(root)], { timeout: UPDATE_TIMEOUT_MS, cwd: String(root) });
+  const r = await run(exec, NPX, npxArgs(src, version, ['--update', String(root)]), { timeout: UPDATE_TIMEOUT_MS, cwd: String(root) });
   const output = tail(r.stdout + (r.stderr ? '\n' + r.stderr : ''));
   if (r.err && notServedYet(r.stdout + r.stderr, version)) return { ok: false, error: notServedYetError(version), output };
   const bad = why(r, 'The kit update');
@@ -221,7 +226,7 @@ function upgradeApp(root, { version, logFile, spawn = cp.spawn, env = updateEnv(
     fd = fs.openSync(logFile, 'w');
     fs.writeSync(fd, `${new Date().toISOString()} clearing npm cache…\n`);
     fs.writeSync(fd, `${new Date().toISOString()} ${NPM} cache clean --force\n`);
-    fs.writeSync(fd, `${new Date().toISOString()} ${NPX} -y ${specOf(src, version)} workspace --reinstall ${root}\n`);
+    fs.writeSync(fd, `${new Date().toISOString()} ${NPX} ${npxArgs(src, version, ['workspace', '--reinstall', String(root)]).join(' ')}\n`);
   } catch (e) { return { ok: false, error: `Could not write the log file: ${e.message}` }; }
   try {
     // Clear npm cache synchronously before spawning the update, so npx downloads the fresh version
@@ -230,7 +235,7 @@ function upgradeApp(root, { version, logFile, spawn = cp.spawn, env = updateEnv(
     try { fs.appendFileSync(logFile, `Note: cache clear had an issue, but continuing: ${e.message}\n`); } catch { /* silent */ }
   }
   try {
-    const child = spawn(NPX, ['-y', specOf(src, version), 'workspace', '--reinstall', String(root)],
+    const child = spawn(NPX, npxArgs(src, version, ['workspace', '--reinstall', String(root)]),
       { cwd: String(root), env, detached: true, stdio: ['ignore', fd, fd], windowsHide: true, shell: IS_WIN });
     // A child that could not start writes nothing itself: say why in the log, which the page names when it gives up.
     if (child && typeof child.on === 'function') {
@@ -245,4 +250,4 @@ function upgradeApp(root, { version, logFile, spawn = cp.spawn, env = updateEnv(
   }
 }
 
-module.exports = { PKG_NAME, cmpVer, notServedYet, validVersion, source, specOf, readKit, fromCheckout, status, compare, latest, updateKit, updateEnv, upgradeApp, whereFrom };
+module.exports = { PKG_NAME, cmpVer, notServedYet, validVersion, source, npxArgs, readKit, fromCheckout, status, compare, latest, updateKit, updateEnv, upgradeApp, whereFrom };

package/workspace/package-lock.json

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

package/workspace/package.json

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

package/workspace/public/pm/components.css

@@ -3583,6 +3583,9 @@
 .td-day__mark[data-day-mark-state="done"] { border-color: var(--foreground); }
 .td-day__ready { display: flex; flex-wrap: wrap; align-items: center; gap: 6px 12px; font-size: 12px; }
 .td-day__prep { display: grid; gap: 8px; padding: 10px 12px; border: 1px solid var(--border); background: var(--background); }
+.td-day__ended { margin: 0; padding: 8px 12px; border-left: 2px solid var(--foreground); background: var(--muted); font-size: 14px; }
+/* an ended meeting keeps its prep, quieter: the steps stay readable, the past is not a call to act */
+.td-day__detail:has(.td-day__ended) .td-day__prep { background: var(--muted); }
 .td-day__fold { border-top: 1px solid var(--border); padding-top: 6px; }
 .td-day__fold > summary { cursor: pointer; font-size: 12px; color: var(--muted-foreground); }
 .td-day__fold[open] > summary { margin-bottom: 6px; }

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

@@ -366,6 +366,7 @@ export const COPY = {
     from: (who, where) => (who && where ? `${who} in ${where}` : who || where || ''),
     howTitle: (d, n) => `How to do it · ${d} of ${n}`,
     beforeTitle: (at) => `Before ${at}`,
+    endedAt: (at) => `This meeting ended at ${at}. Its prep and steps stay below.`,
     more: 'More context',
     moreMeeting: (during, after) => `In the meeting (${during}) · After (${after})`,
     readOnly: 'Read only. Nothing is sent before you press a button that says so.',

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

@@ -176,10 +176,12 @@ function model(d, view) {
     const ended = Number.isFinite(f) && f <= now;
     // a meeting needs prep when the brief gave a prep line or Before steps (the explainer's contradiction: Before steps
     // with no prep line read "Nothing to prepare" while the Agenda counted them as prep left)
-    const needsPrep = !ended && (!!e.prep || before.length > 0);
+    // the prep stays with the meeting once it ends (the PM, 2026-10-07): hadPrep keeps the detail, needsPrep drives the lists
+    const hadPrep = !!e.prep || before.length > 0;
+    const needsPrep = !ended && hadPrep;
     const st = mark && mark.state;
     const group = !needsPrep ? null : st === 'done' || st === 'dismissed' ? 'done' : st === 'snoozed' ? 'later' : 'needs';
-    return { ...e, id: e.id || 'ev-' + i, s, f, time: hhmm(e.start), ended, mark, before, needsPrep, group };
+    return { ...e, id: e.id || 'ev-' + i, s, f, time: hhmm(e.start), ended, mark, before, hadPrep, needsPrep, group };
   }).sort((a, b) => a.s - b.s);
   const settings = (d && d.settings) || null;
   const scopes = (settings && settings.scopes) || {};
@@ -845,17 +847,17 @@ function prepBlock(ctx, e) {
   const d = steps.filter((x) => x.done).length; const total = steps.length;
   const left = total - d;
   const free = freeBefore(m, e);
-  const fit = !total ? null : !left ? A.fit.ok : free >= left * 15 ? A.fit.time(left, free) : A.fit.short(left, free);
+  const fit = !total || e.ended ? null : !left ? A.fit.ok : free >= left * 15 ? A.fit.time(left, free) : A.fit.short(left, free);
   const open = !e.mark || !e.mark.state;
   const link = Array.isArray(e.links) ? e.links.find((l) => isUrl(l.url)) : null;
   return el('div', { class: 'td-day__prep', 'data-day': 'prep' },
-    el('div', { class: 'td-day__jobtop' }, verbChip('prepare'), dueChip(m, e.mark, e.s, true)),
+    el('div', { class: 'td-day__jobtop' }, verbChip('prepare'), e.ended ? null : dueChip(m, e.mark, e.s, true)),
     e.prep ? el('p', { class: 'td-day__todo', 'data-day': 'todo' }, e.prep) : null,
     markBanner(ctx, e.id, e.mark, true),
     total ? el('div', { class: 'td-day__ready', 'data-day': 'readiness' }, meter({ done: d, total, label: A.readiness(d, total) }), fit ? el('span', { class: 'td-day__dim' }, fit) : null) : null,
     total ? el('div', { class: 'td-day__phase' }, el('h4', null, A.beforeTitle(e.time)), stepChecks(ctx, e.id, steps, { refs, mark: e.mark })) : null,
     refsBlock(refs, steps),
-    open && link && left ? el('div', { class: 'td-day__acts', 'data-day': 'cta' }, primaryLink((link.label || link.url) + ' ↗', link.url, { 'data-day-link': 'prep' })) : null,
+    open && link && left && !e.ended ? el('div', { class: 'td-day__acts', 'data-day': 'cta' }, primaryLink((link.label || link.url) + ' ↗', link.url, { 'data-day-link': 'prep' })) : null,
     marksBar(ctx, { id: e.id, title: e.title, kind: 'event', start: e.s, strong: total > 0 && !left }));
 }
 
@@ -896,10 +898,11 @@ function eventDetail(ctx, e) {
       onClick: async () => { if (await addGoal(ctx, e.title, ini ? ini.id : null)) toast({ text: D.goalAdded }); } })) : null];
   return [
     dhead(D.kind.meeting, e.title),
-    el('p', { class: 'td-day__dim td-day__mono' }, `${e.time}${e.end ? '–' + hhmm(e.end) : ''}${e.with ? ' · ' + e.with : ''}${e.ended ? ' · ' + D.ended : ''}`),
+    e.ended ? el('p', { class: 'td-day__ended', 'data-day': 'ended', role: 'status' }, pill(D.pill.ended, ''), ' ', A.endedAt(hhmm(e.end || e.f))) : null,
+    el('p', { class: 'td-day__dim td-day__mono' }, `${e.time}${e.end ? '–' + hhmm(e.end) : ''}${e.with ? ' · ' + e.with : ''}`),
     e.with ? peopleLinks(ctx.ws, e.with, { 'data-day': 'people' }) : null,
     e.purpose ? el('p', null, el('b', null, D.purpose + ': '), e.purpose) : null,
-    e.needsPrep ? prepBlock(ctx, e) : null,
+    e.hadPrep ? prepBlock(ctx, e) : null,
     ini ? el('div', { class: 'td-day__ini', 'data-day': 'initiative' }, el('span', null, D.initiative + ': ', el('b', { class: 'td-day__mono' }, ini.id), ini.why ? el('span', { class: 'td-day__dim' }, ' (' + D.suggested(ini.why) + ')') : null),
       ctx.openIni ? button({ label: D.openInitiative, size: 'sm', variant: 'ghost', attrs: { 'data-day-act': 'open-initiative' }, onClick: () => ctx.openIni(ini.id) }) : null) : null,
     tie,
@@ -907,10 +910,11 @@ function eventDetail(ctx, e) {
     after,
     notesBlock(e, { ws: ctx.ws, initiative: ini }),
     // with prep, the Before steps are the checklist above; During, After and the mail fold away (PRD D2)
-    !e.ended && e.needsPrep && ((steps.during || []).length || (steps.after || []).length || mailBlock)
+    // once it ends, the plan stays where it was; the mail moves up into the notes above, so it is not shown twice
+    e.hadPrep && ((steps.during || []).length || (steps.after || []).length || (!e.ended && mailBlock))
       ? el('details', { class: 'td-day__fold', 'data-day': 'more' }, el('summary', null, A.moreMeeting((steps.during || []).length, (steps.after || []).length)),
-        list(D.phases.during, (steps.during || []).map(stepItem)), list(D.phases.after, (steps.after || []).map(stepItem)), mailBlock) : null,
-    !e.ended && !e.needsPrep ? [list(D.phases.during, (steps.during || []).map(stepItem)), list(D.phases.after, (steps.after || []).map(stepItem)), mailBlock] : null,
+        list(D.phases.during, (steps.during || []).map(stepItem)), list(D.phases.after, (steps.after || []).map(stepItem)), e.ended ? null : mailBlock) : null,
+    !e.hadPrep ? [list(D.phases.during, (steps.during || []).map(stepItem)), list(D.phases.after, (steps.after || []).map(stepItem)), e.ended ? null : mailBlock] : null,
     Array.isArray(e.links) && e.links.length ? el('div', { class: 'td-day__acts', 'data-day': 'links' }, ...e.links.map((l) => extLink((l.label || l.url) + ' ↗', l.url))) : null,
   ];
 }