create-pmos 0.523.0 → 0.524.0

package/workspace/server.js

@@ -2732,6 +2732,8 @@ const orchGate = require('./lib/orchestrator-gate.js').create({ dir: STATE, quot
 const driver = driverRunLib.create({
   mayStart: ({ running }) => orchGate.mayStart({ running: running + orchSpawn.own() + chatWorking() }),
   started: () => orchGate.granted(),
+  // bg-queue: one background run per initiative. The Driver's own runs are left out: lib/driver.js plan never starts two on one target.
+  holder: (ini) => (bgQueue ? bgQueue.holder(ini, 'drive:') : null),
   workspaces: () => [...workspaces.values()],
   isLead: (w) => isPlanNeedsTree(w),
   stateDirFor: (w) => stateDirFor(w),
@@ -2759,7 +2761,9 @@ function chatWorking(now = Date.now()) {
   for (const s of sessions.values()) if (String(s.origin || '').startsWith('chat:') && s.state !== 'exited' && harness.deriveState(s.state, s.lastOutputAt, now).state === 'working') k++;
   return k;
 }
-const orchSpawn = require('./lib/orchestrator-spawn.js').wrap({ gate: orchGate, spawn: (spec) => spawnSession(spec), driverRunning: () => driver.active().length, pmWorking: () => chatWorking() });
+let bgQueue = null;   // lib/bg-queue.js, built below with the job ticks
+const orchSpawn = require('./lib/orchestrator-spawn.js').wrap({ gate: orchGate, spawn: (spec) => spawnSession(spec), driverRunning: () => driver.active().length, pmWorking: () => chatWorking(),
+  holder: (ini) => (bgQueue ? bgQueue.holder(ini) : null) });   // bg-queue: one background run per initiative
 // agent-orchestrator: the keep rate of the agent's items, read from every registered repository's Driver and core-document ledgers (cached a minute)
 let orchKeepCache = null;
 const orchKeepRate = () => {
@@ -2848,7 +2852,8 @@ const scanner = scanRunLib.create({
 });
 // PMOS_SCAN_NOW (a local date-time such as 2026-10-12T10:00:00) fixes the scan's clock. The suites use it so a scheduled scan does not wait for a weekday.
 const scanClock = () => { const t = process.env.PMOS_SCAN_NOW ? Date.parse(process.env.PMOS_SCAN_NOW) : NaN; return Number.isFinite(t) ? { now: t } : {}; };
-const scanTick = () => { try { scanner.tick(scanClock()); } catch (e) { warnWriteFail('scan tick', e); } };
+// idle lab (frame I4): the daily scan waits for the queue's idle turn (turn.idle). The suggest run and Scan now do not wait.
+const scanTick = (turn = {}) => { try { scanner.tick({ ...scanClock(), idle: turn.idle !== false }); } catch (e) { warnWriteFail('scan tick', e); } };
 // report-workspace: the finder is ONE weekly headless run for the machine, on Monday at 09:00 inside the working hours (lib/report-finder.js). The run
 // reads the PM's calendar, chat, mail subjects and drive through the connectors and files proposals with `pmos report propose`; it sets nothing up.
 // PMOS_REPORT_FIND=off switches it off. PMOS_REPORT_FIND_NOW (a local date-time) fixes its clock for the suites.
@@ -3254,7 +3259,43 @@ const gated = (id, fn) => () => { let g = { ok: true }; try { g = refreshRun.job
 // data-refresh-settings: the seed schedules move to Settings › Data refresh (refreshRun.settings(), once) BEFORE checkDueSchedules reads
 // schedules.json, so a schedule that is moving never fires once more from the old list on the first tick after an upgrade.
 const scheduleOwner = require('./lib/schedule-owner.js').create({ port: PORT });
-try { const _tick = setInterval(() => { try { if (!scheduleOwner.mayRun()) return; } catch { /* no lock: run as before */ } try { refreshRun.settings(); } catch { /* the refresh tick tries again */ } checkDueSchedules(); proactiveTick(); try { prepareTick({ manual: false }); } catch { /* the next tick tries again */ } try { dayTick(); } catch (e) { warnWriteFail('day run tick', e); } try { refreshRun.tick(); } catch (e) { warnWriteFail('refresh tick', e); } try { healthTick(); } catch (e) { warnWriteFail('health tick', e); } gated('sync', () => autoSync.tick().catch(() => {}))(); dashboardScheduleTick(); orchTick(); gated('driver', driverTick)(); gated('scan', scanTick)(); gated('finder', reportFinderTick)(); gated('coredocs', coreDocsTick)(); msReviewTick(); gated('propose', proposalTick)(); grillTick(); metricDraftTick(); impactTick(); metricReadTick(); forecastTick(); reportDesignTick(); reportStructureTick(); }, TICK_MS); if (_tick.unref) _tick.unref(); } catch {}
+// idle lab (frame I4): ONE queue for all background work (lib/bg-queue.js). Each minute the housekeeping runs first (the refresh settings,
+// health, the orchestrator's health and backup); then every job takes its turn in the queue's order: 2 due at a set time, 3 the Driver,
+// 4 deep drafts, 5 the idle lab and slow reads. The queue checks the off switch, the idle clock, quiet hours, the spend limit and the
+// runs-at-once limit once for every job; a job that goes runs its own tick, with its own due rules. A press by the PM never waits here.
+bgQueue = require('./lib/bg-queue.js').create({
+  stateDir: STATE,
+  idleFor: (now) => pmIdle.idleFor(now), idleLimit: pmIdle.IDLE_MS,
+  quiet: (now) => proactiveLib.inQuietHours(now, (proSettings() || {}).quiet),
+  running: () => orchSpawn.running(),
+  offOf: (id) => require('./lib/ai-guard.js').off(id, { settingsDir: STATE }),
+  spend: (now) => { const G = require('./lib/grill.js'); let cap = 10; try { const c = Number(require('./lib/settings-store.js').get(STATE, 'grill.cap')); if (Number.isFinite(c) && c >= 0) cap = c; } catch { /* the default cap */ }
+    const b = G.budgetFor(G.read(STATE), { cap, now }); return b.ok ? { atCap: false } : { atCap: true, why: `this month's spend is at the $${cap} limit in Settings › Claude's checks` }; },
+  workEnd: () => { const d = (proSettings() || {}).dayCheck; return d && d.end ? d.end : '18:00'; },
+  sessions: () => [...sessions.values()],
+  warn: (what, e) => warnWriteFail(what, e),
+});
+bgQueue.register('schedules', () => checkDueSchedules());
+bgQueue.register('proactive', () => proactiveTick());
+bgQueue.register('prepare', () => { try { prepareTick({ manual: false }); } catch { /* the next tick tries again */ } });
+bgQueue.register('day', () => { try { dayTick(); } catch (e) { warnWriteFail('day run tick', e); } });
+bgQueue.register('refresh', () => { try { refreshRun.tick(); } catch (e) { warnWriteFail('refresh tick', e); } });
+bgQueue.register('reports', () => dashboardScheduleTick());
+bgQueue.register('sync', gated('sync', () => autoSync.tick().catch(() => {})));
+bgQueue.register('driver', gated('driver', driverTick));
+bgQueue.register('finder', gated('finder', reportFinderTick));
+bgQueue.register('coredocs', gated('coredocs', coreDocsTick));
+bgQueue.register('milestones', () => msReviewTick());
+bgQueue.register('propose', gated('propose', proposalTick));
+bgQueue.register('grill', () => grillTick());
+bgQueue.register('metric-drafts', () => metricDraftTick());
+bgQueue.register('impact', () => impactTick());
+bgQueue.register('metric-reads', () => metricReadTick());
+bgQueue.register('forecast', () => forecastTick());
+bgQueue.register('report-design', () => reportDesignTick());
+bgQueue.register('report-structure', () => reportStructureTick());
+bgQueue.register('scan', (turn) => gated('scan', () => scanTick(turn))());
+try { const _tick = setInterval(() => { try { if (!scheduleOwner.mayRun()) return; } catch { /* no lock: run as before */ } try { refreshRun.settings(); } catch { /* the refresh tick tries again */ } try { healthTick(); } catch (e) { warnWriteFail('health tick', e); } orchTick(); bgQueue.tick(); }, 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}>} */
@@ -4596,7 +4637,7 @@ function spawnSession(opts) {
   try { if (s && refreshRun) refreshRun.started(s); } catch (e) { warnWriteFail('refresh log (start)', e); }
   return s;
 }
-function noteSessionEnd(s) { try { if (refreshRun) refreshRun.ended(s); } catch (e) { warnWriteFail('refresh log (end)', e); } }
+function noteSessionEnd(s) { try { if (refreshRun) refreshRun.ended(s); } catch (e) { warnWriteFail('refresh log (end)', e); } try { if (bgQueue) bgQueue.ended(s); } catch (e) { warnWriteFail('background queue (end)', e); } }   // bg-queue: the Lab's record of each background run
 function spawnSessionInner({ name, agent, cwd, ws, origin, initialInput, profile, initiative, modelAsk, planItem, workType, autoDelete, launchFlags, addDirs, onDone, scratch, extraEnv, writePaths, chatClaude, byPm, typedByPm, authLogin }) {
   const id = nextSessionId();
   /* pm-os-absorb Run 1 — every AGENT session gets a token, `<id>.<8 hex>`, in its environment as PMOS_SESSION, and
@@ -10583,7 +10624,7 @@ async function handleRequest(req, res) {
   // pm-os-absorb Runs 2–5 — the planning layer's routes, one file per run (lib/route-modules.js). Last, so none shadows a route above.
   // meeting-notes Run 1: the Notes routes keep notes in the per-user runtime directory and start the agent-summary session.
   if (req.method === 'POST' && !(req.headers && req.headers['x-pmos-session'])) orchGate.touch();   // agent-orchestrator: a page press by the PM
-  if (await routeModules.dispatch(req, res, url, { orchestrator: { gate: orchGate, running: () => orchSpawn.running(), health: orchHealth, keepRate: orchKeepRate }, proposalRuns, metricDraftRuns, metricReadRuns, metricReadHours, tellGoalAlert: goalAlertTell, json, readBody, getWs, invalidateNeedsAgg, boardCache, consoleState, stateDirFor, sessionList, initiativeIndex,
+  if (await routeModules.dispatch(req, res, url, { bgQueue, orchestrator: { gate: orchGate, running: () => orchSpawn.running(), health: orchHealth, keepRate: orchKeepRate }, proposalRuns, metricDraftRuns, metricReadRuns, metricReadHours, tellGoalAlert: goalAlertTell, json, readBody, getWs, invalidateNeedsAgg, boardCache, consoleState, stateDirFor, sessionList, initiativeIndex,
     runtimeDir: STATE, claudeSetup, registerWorkspace, pickFolder, broadcast, workspaceList: () => [...workspaces.values()], homeRoot: HOME_ENABLED ? SELF_ROOT : null, spawnSession, jevModelOpts, sendToSession, endSupersededRuns, proSettings,
     // premium-chat-session: every premium chat panel is an interactive Claude Code session the PM talks to (text as typed, `/` kept)
     chatSessions,

package/workspace/test-files.json

@@ -89,9 +89,11 @@
     "schedule-cli.test.js",
     "initiative-surface.test.js",
     "guide.test.js",
+    "moments.test.js",
     "driver.test.js",
     "driver-server.test.js",
     "scan.test.js",
+    "bg-queue.test.js",
     "scan-server.test.js",
     "report-setups.test.js",
     "report-export.test.js",

package/workspace/test-lists/first-reveal.json

@@ -0,0 +1,9 @@
+{
+  "_comment": "Onboarding build B2, Home right after setup: the search's facts, the reveal model (ticks, portrait, drafted first initiative), ✓ creating the initiative with its outcome and check date, the route (lib/first-reveal.js, lib/routes-reveal.js). A real kit folder, no Claude process.",
+  "modules": [
+    "first-reveal.test.js"
+  ],
+  "seconds": {
+    "first-reveal.test.js": 3
+  }
+}

package/workspace/test-lists/idle-lab.json

@@ -0,0 +1,9 @@
+{
+  "_comment": "Idle lab build U (2026-11-04): what the engine files and the screens read — a result needs its proof and sources, specimens stay in their folder, the compare view leaves unproven Production and Design out, the Lab is silent when empty (lib/idle-lab.js, the lab groups in lib/proposals.js). Pure parts.",
+  "modules": [
+    "idle-lab.test.js"
+  ],
+  "seconds": {
+    "idle-lab.test.js": 1
+  }
+}

package/workspace/test-lists/morning-goals.json

@@ -0,0 +1,9 @@
+{
+  "_comment": "Build brief Good morning GM1: the quarter strip's one count of goal states, the PM's quarter line ✦, the morning snapshot, goal tags and what Yes does (lib/morning-goals.js, lib/routes-morning-goals.js). Pure, node.",
+  "modules": [
+    "morning-goals.test.js"
+  ],
+  "seconds": {
+    "morning-goals.test.js": 1
+  }
+}