create-pmos 0.48.0 → 0.50.0

package/workspace/server.js

@@ -76,6 +76,7 @@ const jevClaims = require('./lib/jev-claims.js');   // D80 — the bridge betwee
 const jevCategorize = require('./lib/jev-categorize.js');   // D82 — the bridge between the document categorizer and the one TypeSafe module
 const validateLib = require('./lib/validate.js');
 const liveNotes = require('./lib/live-notes.js');   // jev-live-notes — reads and appends a repository's live-notes ledger; no network
+const jevLive = require('./lib/jev-live.js');      // jev-live-notes Run 7 (D85) — the live view's one bridge to Jev, behind three gates
 const claimsLib = require('./lib/claims.js');
 const docCategory = require('./lib/doc-category.js');   // jev-doc-categorizer Run 1 — the PM-facing kind of a document, derived, local, no model
 const docCatCorrections = require('./lib/doc-category-corrections.js');   // jev-doc-categorizer Run 3 — the PM's own category, per user, outside the repository
@@ -291,6 +292,10 @@ function sessionEnv() {
   // print its environment, so the key is never handed to one, whether it came from settings or the shell.
   delete env[tsSettings.ENV_NAME];
   if (SET_GIT_OPTIONAL_LOCKS) delete env.GIT_OPTIONAL_LOCKS;
+  // prompt-model-routing Run 3 — where the cockpit mod asks for a prompt's route: this server, on loopback.
+  // An address only; the Jev key stays here (D79).
+  const routeUrl = jevRoute.routeUrl(PORT);
+  if (routeUrl) env.PMOS_ROUTE_URL = routeUrl; else delete env.PMOS_ROUTE_URL;
   return env;
 }
 
@@ -470,6 +475,12 @@ function homeWorkspace() {
   return HOME_ENABLED ? workspaces.get(wsId(SELF_ROOT)) : [...workspaces.values()][0];
 }
 function getWs(id) { return (id && workspaces.get(id)) || homeWorkspace(); }
+/** The registered workspace whose root is this path exactly, or null. Never the home workspace by default. */
+function wsByRoot(root) {
+  const want = path.resolve(String(root));
+  for (const w of workspaces.values()) if (w && path.resolve(w.root) === want) return w;
+  return null;
+}
 // R2/R3 — what the sidebar tree needs and cannot derive for itself: which REPOSITORY a registered
 // working tree belongs to, and which branch it is on. `git worktree list` names the main worktree
 // first from any of a repo's trees (git-info.worktreesAt), so index 0 is the group key: it is what
@@ -1608,8 +1619,8 @@ function annotateJev(root, node, cache, seen = new Set()) {
   if (node.category === docCategory.UNDETERMINED && typeof node.path === 'string' && /\.md$/i.test(node.path)) {
     const c = categoryInput(path.join(root, node.path));
     const l = c ? jevCategorize.lookup(cache, { fm: c.fm, text: c.text }) : null;
-    if (l && l.decided) { node.category = l.category; node.category_basis = 'jev'; node.category_why = l.sentence; if (l.ticket_kind) node.ticket_kind = l.ticket_kind; }
-    else if (l) node.category_why = l.sentence;
+    if (l && l.decided) { node.category = l.category; node.category_basis = 'jev'; node.category_why = l.sentence; if (l.ticket_kind) node.category_kind = l.ticket_kind; }
+    else if (l) { node.category_why = l.sentence; node.category_jev = 'unsure'; }
   }
   for (const k of Object.keys(node)) if (node[k] && typeof node[k] === 'object') annotateJev(root, node[k], cache, seen);
   return node;
@@ -2285,8 +2296,11 @@ function checkDueSchedules() {
   } catch {}
   return fired;
 }
-// the tick — the persistent server checks on an interval; unref'd so it never blocks exit
-try { const _tick = setInterval(() => { checkDueSchedules(); proactiveTick(); try { prepareTick({ manual: false }); } catch { /* the next tick tries again */ } }, 60000); if (_tick.unref) _tick.unref(); } catch {}
+// the tick — the persistent server checks on an interval; unref'd so it never blocks exit.
+// PMOS_TICK_MS exists for the suites (same footing as PMOS_LIVENESS_MS): proactive-prepare.test.js
+// used to wait on two real minutes of this clock. Unset, the interval is the 60 seconds it always was.
+const TICK_MS = Math.max(200, Number(process.env.PMOS_TICK_MS) || 60000);
+try { const _tick = setInterval(() => { checkDueSchedules(); proactiveTick(); try { prepareTick({ manual: false }); } catch { /* the next tick tries again */ } }, TICK_MS); if (_tick.unref) _tick.unref(); } catch {}
 
 // ── Sessions: real PTYs, owned by the server, with disk-backed scrollback + metadata. ──
 /** @type {Map<string, {id,ws,name,agent,cwd,state,note,created,pty,buf,cols,rows,clients:Set}>} */
@@ -4703,6 +4717,18 @@ function jevGateInfo(w) {
   const { cacheDir } = claimsPaths(w);
   return { switch: f.jev, status_read: f.status_read, open: g.open, missing: g.missing, sentence: g.open ? null : jevClaims.gateSentence(g.missing), ...jevClaims.status(cacheDir) };
 }
+// D85 — the live-notes add route's sender: lib/typesafe.js behind the key, consent and the switch, or none. The key goes to the engine
+// only when the sender does, and never into a response.
+function liveSender(w) {
+  const key = tsSettings.getKey(STATE);
+  const flags = { consent: tsSettings.getRepo(STATE, w.root).consent, live: liveNotes.getSwitch(STATE, w.root).live };
+  const snd = jevLive.senderFor(key, flags, jevModelOpts(w.root));
+  return { key: snd.ask ? key : null, flags, ask: snd.ask, askOpts: snd.askOpts };
+}
+// D85 — what the live-notes view needs to explain its Jev switch. Booleans and sentences only; the key never leaves the store.
+function liveJevInfo(w) {
+  return jevLive.infoFor(tsSettings.status(STATE).present, { consent: tsSettings.getRepo(STATE, w.root).consent, live: liveNotes.getSwitch(STATE, w.root).live });
+}
 // D82 — what the page needs to explain the categorize switch: which gates hold, and what the last pass did.
 const doccatRunning = new Set();
 const doccatAutoAt = new Map();    // root → time of the last automatic pass; at most one a minute
@@ -5555,11 +5581,13 @@ async function handleRequest(req, res) {
   }
   if (p === '/api/model/route' && req.method === 'POST') {
     let body = {}; try { body = JSON.parse((await readBody(req)) || '{}'); } catch { return json(res, { ok: false, error: 'invalid JSON body' }, 400); }
-    const w = getWs(body.ws); if (!w) return json(res, { ok: false, error: 'no workspace' }, 400);
+    // A terminal's cockpit mod names its repository by root; the page names a workspace by id.
+    const w = typeof body.root === 'string' ? wsByRoot(body.root) : getWs(body.ws);
+    if (!w) return json(res, { ok: false, error: 'no workspace for that repository' }, 400);
     if (typeof body.prompt !== 'string' || !body.prompt.trim() || body.prompt.length > 60000) return json(res, { ok: false, error: 'prompt must be text of up to 60000 characters' }, 400);
     const f = tsSettings.getRepo(STATE, w.root);
     const out = await jevRoute.routePrompt({ root: w.root, prompt: body.prompt, ctx: { skill: typeof body.skill === 'string' ? body.skill : undefined, source: body.source, running: true },
-      key: tsSettings.getKey(STATE), flags: { consent: f.consent, route: f.route, exclude: f.exclude } });
+      key: tsSettings.getKey(STATE), flags: { consent: f.consent, route: f.route, exclude: f.exclude }, askOpts: body.interactive === true ? jevRoute.INTERACTIVE : {} });
     if (!out.ok) return json(res, { ok: false, error: out.error }, 400);
     if (out.shadow) return json(res, { ok: true, shadow: true, id: out.id });             // shadow: logged, nothing shown, nothing applied
     return json(res, { ok: true, ws: w.id, id: out.id, tier: out.tier, model: out.model, effort: out.effort, stage: out.stage, confidence: out.confidence, why: out.why,
@@ -6566,12 +6594,14 @@ async function handleRequest(req, res) {
     return json(res, { ok: true, ws: w.id, name: w.name, ...tsSettings.getRepo(STATE, w.root), key: tsSettings.status(STATE) });
   }
   /* ── live notes (jev-live-notes, Run 2): the ranked proposals of a conversation, and the PM's accept, change or reject.
-   *    Reads the repository's ledger; the one write is a decision row. No request leaves this process, and no page is built yet. ── */
+   *    Reads the repository's ledger; the writes are ledger rows and, on close, the day's note. No request leaves this process.
+   *    The page is the cockpit's live-notes view (public/pm/view-livenotes.js, Run 6). ── */
   if (p === '/api/live-notes' && req.method === 'GET') {
     const wsq = url.searchParams.get('ws');
     const w = wsq ? workspaces.get(wsq) : homeWorkspace();     // a named workspace the server does not know is refused, never replaced by the home one
     if (!w) return json(res, { ok: false, error: 'no such workspace' }, 400);
-    const r = liveNotes.apiList({ root: w.root, session: url.searchParams.get('session') || null });
+    const r = liveNotes.apiList({ root: w.root, session: url.searchParams.get('session') || null, exclude: tsSettings.getRepo(STATE, w.root).exclude });
+    if (r.ok) r.jev = liveJevInfo(w);
     return json(res, r, r.ok ? 200 : (r.status || 400));
   }
   if (p === '/api/live-notes/decide' && req.method === 'POST') {
@@ -6580,7 +6610,39 @@ async function handleRequest(req, res) {
     catch { return json(res, { ok: false, error: 'invalid JSON body' }, 400); }
     const w = body.ws ? workspaces.get(String(body.ws)) : homeWorkspace();
     if (!w) return json(res, { ok: false, error: 'no such workspace' }, 400);
-    const r = liveNotes.apiDecide({ root: w.root, runtimeDir: STATE, session: body.session, segment: body.segment, action: body.action, initiative: body.initiative || null, relation: body.relation || null, exclude: tsSettings.getRepo(STATE, w.root).exclude });
+    const r = liveNotes.apiDecide({ root: w.root, runtimeDir: STATE, session: body.session, segment: body.segment, action: body.action, initiative: body.initiative || null, relation: body.relation || null, question: body.question == null ? null : body.question, exclude: tsSettings.getRepo(STATE, w.root).exclude });
+    return json(res, r, r.ok ? 200 : (r.status || 400));
+  }
+  /* Run 7 (D85): the per-repository switch "live notes may use Jev". Default off; it is one of three gates, with the key and consent. */
+  if (p === '/api/live-notes/switch' && req.method === 'POST') {
+    let body = {};
+    try { body = JSON.parse((await readBody(req)) || '{}'); }
+    catch { return json(res, { ok: false, error: 'invalid JSON body' }, 400); }
+    const w = body.ws ? workspaces.get(String(body.ws)) : homeWorkspace();
+    if (!w) return json(res, { ok: false, error: 'no such workspace' }, 400);
+    if (typeof body.live !== 'boolean') return json(res, { ok: false, error: 'say live: true or live: false' }, 400);
+    liveNotes.setSwitch(STATE, w.root, { live: body.live });
+    return json(res, { ok: true, ws: w.id, jev: liveJevInfo(w) });
+  }
+  /* Run 6: the live-notes view's writes — start or resume a session, add points, close. A proposal is a local word match made in
+   * this process, unless all three D85 gates hold: then `add` hands each cleaned point to Jev through lib/jev-live.js. */
+  if ((p === '/api/live-notes/session' || p === '/api/live-notes/add' || p === '/api/live-notes/close' || p === '/api/live-notes/private') && req.method === 'POST') {
+    let body = {};
+    try { body = JSON.parse((await readBody(req)) || '{}'); }
+    catch { return json(res, { ok: false, error: 'invalid JSON body' }, 400); }
+    const w = body.ws ? workspaces.get(String(body.ws)) : homeWorkspace();
+    if (!w) return json(res, { ok: false, error: 'no such workspace' }, 400);
+    const exclude = tsSettings.getRepo(STATE, w.root).exclude;
+    let r;
+    if (p === '/api/live-notes/session') r = liveNotes.apiOpen({ root: w.root, runtimeDir: STATE, session: body.session || null, anchor: body.anchor || null, exclude });
+    else if (p === '/api/live-notes/add') {
+      const snd = liveSender(w);
+      r = await liveNotes.apiAdd({ root: w.root, runtimeDir: STATE, session: body.session, text: body.text, source: body.source === 'speech' ? 'speech' : 'typed', exclude,
+        key: snd.key, flags: snd.flags, ask: snd.ask, askOpts: snd.askOpts });
+    }
+    else if (p === '/api/live-notes/private') r = liveNotes.apiMarkPrivate({ root: w.root, session: body.session });
+    else r = liveNotes.apiClose({ root: w.root, runtimeDir: STATE, session: body.session, retentionDays: liveNotes.getSwitch(STATE, w.root).retention_days, exclude });
+    if (r.ok && p !== '/api/live-notes/close') { r.jev = liveJevInfo(w); if (r.note) r.note = r.jev.note; }
     return json(res, r, r.ok ? 200 : (r.status || 400));
   }
   if (p === '/api/validate/plan' && req.method === 'POST') {

package/workspace/test-files.json

@@ -0,0 +1,180 @@
+{
+  "_comment": "The test files each npm test script runs. run-tests.js reads this file; add a new suite here and every runner, local and CI, picks it up. Every suite claims its own port, state directory and tmux socket (test-run.js or its own equivalent), which is what makes running them side by side safe.",
+  "_comment_exclusive": "Suites that write the checkout's own state (workspace/state/, the home workspace's ledgers) while they run. run-tests.js runs each of them with nothing else beside it, because suites that read the checkout as their home workspace (proactive.test.js's scan, for one) would see those writes mid-run.",
+  "exclusive": [
+    "test.js"
+  ],
+  "unit": [
+    "test.js"
+  ],
+  "modules": [
+    "proactive.test.js",
+    "focus.test.js",
+    "handoff.test.js",
+    "repo-scan.test.js",
+    "profiles.test.js",
+    "external-linking.test.js",
+    "story-artifacts.test.js",
+    "no-network.test.js",
+    "typesafe-validation.test.js",
+    "claims.test.js",
+    "status-facts-panel.test.js",
+    "jev-claims.test.js",
+    "jev-categorize.test.js",
+    "jev-status.test.js",
+    "jev-route.test.js",
+    "repo-watch.test.js",
+    "fixture-parity.test.mjs",
+    "markdown.test.mjs",
+    "start-policy.test.js",
+    "state-isolation.test.js",
+    "sync.test.js",
+    "schedule-cli.test.js",
+    "initiative-surface.test.js",
+    "guide.test.js",
+    "next-step-actions.test.js",
+    "kg.test.js",
+    "doc-category.test.js",
+    "doc-category-corrections.test.js",
+    "proactive-prepare.test.js",
+    "learn.test.js",
+    "session-flag.test.js",
+    "live-notes.test.js"
+  ],
+  "panels": [
+    "pm-shell-test.js",
+    "pm-repos-test.js",
+    "pm-initiatives-test.js",
+    "pm-detail-test.js",
+    "pm-tabs-test.js",
+    "pm-term-test.js",
+    "pm-modes-test.js",
+    "pm-r1-test.js",
+    "pm-r2-test.js",
+    "pm-r3-test.js",
+    "pm-r4-test.js",
+    "pm-r5-test.js",
+    "pm-r6-test.js",
+    "pm-r7-test.js",
+    "pm-r8-test.js",
+    "pm-r9-test.js",
+    "pm-r10-test.js",
+    "pm-r11-test.js",
+    "pm-r12-test.js",
+    "pm-r13-test.js",
+    "pm-r14-test.js",
+    "pm-r15-test.js",
+    "pm-r16-test.js",
+    "pm-r17-test.js",
+    "pm-r18-test.js",
+    "pm-r19-test.js",
+    "pm-r20-test.js",
+    "pm-r21-test.js",
+    "pm-r22-test.js",
+    "pm-r23-test.js",
+    "pm-r24-test.js",
+    "pm-r25-test.js",
+    "pm-r26-test.js",
+    "pm-doc-category-test.js",
+    "pm-r27-test.js",
+    "pm-r28-test.js",
+    "pm-r29-today-test.js",
+    "pm-r29-portfolio-test.js",
+    "pm-r29-knowledge-test.js",
+    "pm-r29-memory-test.js",
+    "pm-r29-skills-scheduled-test.js",
+    "pm-r29-validate-guide-test.js",
+    "pm-r29-reports-addrepo-test.js",
+    "pm-r29-filespad-test.js",
+    "pm-r29-newsession-alignment-test.js",
+    "pm-live-notes-test.js",
+    "pm-r30-test.js"
+  ],
+  "ui": [
+    "ui-test.js"
+  ],
+  "seconds": {
+    "test.js": 48,
+    "proactive.test.js": 4,
+    "focus.test.js": 1,
+    "handoff.test.js": 1,
+    "repo-scan.test.js": 1,
+    "profiles.test.js": 1,
+    "external-linking.test.js": 1,
+    "story-artifacts.test.js": 1,
+    "no-network.test.js": 1,
+    "typesafe-validation.test.js": 1,
+    "claims.test.js": 1,
+    "status-facts-panel.test.js": 1,
+    "jev-claims.test.js": 3,
+    "jev-categorize.test.js": 1,
+    "jev-status.test.js": 1,
+    "jev-route.test.js": 1,
+    "repo-watch.test.js": 1,
+    "fixture-parity.test.mjs": 1,
+    "markdown.test.mjs": 1,
+    "start-policy.test.js": 1,
+    "state-isolation.test.js": 4,
+    "sync.test.js": 4,
+    "schedule-cli.test.js": 3,
+    "initiative-surface.test.js": 3,
+    "guide.test.js": 1,
+    "next-step-actions.test.js": 5,
+    "kg.test.js": 1,
+    "doc-category.test.js": 1,
+    "doc-category-corrections.test.js": 1,
+    "proactive-prepare.test.js": 9,
+    "learn.test.js": 3,
+    "session-flag.test.js": 1,
+    "live-notes.test.js": 3,
+    "pm-shell-test.js": 6,
+    "pm-repos-test.js": 3,
+    "pm-initiatives-test.js": 15,
+    "pm-detail-test.js": 16,
+    "pm-tabs-test.js": 59,
+    "pm-term-test.js": 28,
+    "pm-modes-test.js": 18,
+    "pm-r1-test.js": 6,
+    "pm-r2-test.js": 3,
+    "pm-r3-test.js": 3,
+    "pm-r4-test.js": 4,
+    "pm-r5-test.js": 3,
+    "pm-r6-test.js": 2,
+    "pm-r7-test.js": 1,
+    "pm-r8-test.js": 1,
+    "pm-r9-test.js": 2,
+    "pm-r10-test.js": 1,
+    "pm-r11-test.js": 1,
+    "pm-r12-test.js": 6,
+    "pm-r13-test.js": 2,
+    "pm-r14-test.js": 7,
+    "pm-r15-test.js": 35,
+    "pm-r16-test.js": 7,
+    "pm-r17-test.js": 3,
+    "pm-r18-test.js": 4,
+    "pm-r19-test.js": 18,
+    "pm-r20-test.js": 4,
+    "pm-r21-test.js": 4,
+    "pm-r22-test.js": 32,
+    "pm-r23-test.js": 13,
+    "pm-r24-test.js": 4,
+    "pm-r25-test.js": 9,
+    "pm-r26-test.js": 9,
+    "pm-doc-category-test.js": 4,
+    "pm-r27-test.js": 26,
+    "pm-r28-test.js": 9,
+    "pm-r29-today-test.js": 4,
+    "pm-r29-portfolio-test.js": 3,
+    "pm-r29-knowledge-test.js": 3,
+    "pm-r29-memory-test.js": 4,
+    "pm-r29-skills-scheduled-test.js": 6,
+    "pm-r29-validate-guide-test.js": 20,
+    "pm-r29-reports-addrepo-test.js": 4,
+    "pm-r29-filespad-test.js": 5,
+    "pm-r29-newsession-alignment-test.js": 8,
+    "pm-live-notes-test.js": 24,
+    "pm-r30-test.js": 4,
+    "ui-test.js": 30
+  },
+  "_comment_seconds": "Measured wall time of each suite run alone (4-CPU sandbox, 2026-10-05). Only the ORDER uses it: the slowest suites start first, and --shard deals suites to the least-loaded shard so the shards finish together. A wrong or missing number never skips a suite; a missing one counts as 10."
+}