@telora/daemon 0.22.289 → 0.22.293

package/dist/daemon-state/awaiting-slot.js

@@ -1,26 +1,39 @@
 // PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
 // Pinned by: packages/daemon/src/focus/awaiting-slot.test.ts,
+//   packages/daemon/src/focus/focus-activity-producers.test.ts,
 //   packages/daemon/src/focus/heartbeat-team-liveness-phases.test.ts
 // PINNED-BY-END
+/** focusId -> epoch ms the pass FIRST left it waiting in the current unbroken run of passes. */
 const awaitingSlotByPass = {
-    ready: new Set(),
-    pending: new Set(),
+    ready: new Map(),
+    pending: new Map(),
 };
-/** Replace one pass's awaiting-slot set with the focuses it left waiting this run (empty clears it). */
-export function setAwaitingSlotFocuses(pass, focusIds) {
-    awaitingSlotByPass[pass] = new Set(focusIds);
+/**
+ * Replace one pass's awaiting-slot set with the focuses it left waiting this run
+ * (empty clears it). A focus still waiting keeps the time it was first recorded,
+ * so the published `since` names when the wait began, not the latest pass.
+ */
+export function setAwaitingSlotFocuses(pass, focusIds, now = Date.now()) {
+    const prior = awaitingSlotByPass[pass];
+    awaitingSlotByPass[pass] = new Map([...focusIds].map((id) => [id, prior.get(id) ?? now]));
 }
 /** Every focus some pass left waiting for a slot (the union of both passes, deduplicated). */
 export function getAwaitingSlotFocusIds() {
-    return [...new Set([...awaitingSlotByPass.ready, ...awaitingSlotByPass.pending])];
+    return [...new Set([...awaitingSlotByPass.ready.keys(), ...awaitingSlotByPass.pending.keys()])];
 }
 /** Whether some pass left this focus waiting for a slot on its latest run. */
 export function isAwaitingSlot(focusId) {
     return awaitingSlotByPass.ready.has(focusId) || awaitingSlotByPass.pending.has(focusId);
 }
+/** When the focus's current wait for a slot began (the earlier of the two passes), or null when it is not waiting. */
+export function awaitingSlotSince(focusId) {
+    const times = [awaitingSlotByPass.ready.get(focusId), awaitingSlotByPass.pending.get(focusId)]
+        .filter((t) => t !== undefined);
+    return times.length > 0 ? Math.min(...times) : null;
+}
 /** Test-only: clear both passes' sets so state never leaks across tests. */
 export function __resetAwaitingSlotForTesting() {
-    awaitingSlotByPass.ready = new Set();
-    awaitingSlotByPass.pending = new Set();
+    awaitingSlotByPass.ready = new Map();
+    awaitingSlotByPass.pending = new Map();
 }
 //# sourceMappingURL=awaiting-slot.js.map

package/dist/daemon-state/awaiting-slot.js.map

@@ -1 +1 @@
-{"version":3,"file":"awaiting-slot.js","sourceRoot":"","sources":["../../src/daemon-state/awaiting-slot.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,8DAA8D;AAC9D,qEAAqE;AACrE,gBAAgB;AA8BhB,MAAM,kBAAkB,GAA2C;IACjE,KAAK,EAAE,IAAI,GAAG,EAAE;IAChB,OAAO,EAAE,IAAI,GAAG,EAAE;CACnB,CAAC;AAEF,wGAAwG;AACxG,MAAM,UAAU,sBAAsB,CAAC,IAAe,EAAE,QAA0B;IAChF,kBAAkB,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC/C,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,uBAAuB;IACrC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,kBAAkB,CAAC,KAAK,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACpF,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC1F,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,6BAA6B;IAC3C,kBAAkB,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;IACrC,kBAAkB,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;AACzC,CAAC"}
+{"version":3,"file":"awaiting-slot.js","sourceRoot":"","sources":["../../src/daemon-state/awaiting-slot.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,8DAA8D;AAC9D,gEAAgE;AAChE,qEAAqE;AACrE,gBAAgB;AA8BhB,gGAAgG;AAChG,MAAM,kBAAkB,GAAmD;IACzE,KAAK,EAAE,IAAI,GAAG,EAAE;IAChB,OAAO,EAAE,IAAI,GAAG,EAAE;CACnB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAe,EAAE,QAA0B,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IAC1G,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACvC,kBAAkB,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;AAC5F,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,uBAAuB;IACrC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAClG,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC1F,CAAC;AAED,sHAAsH;AACtH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,KAAK,GAAG,CAAC,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;SAC3F,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACtD,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,6BAA6B;IAC3C,kBAAkB,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;IACrC,kBAAkB,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;AACzC,CAAC"}

package/dist/daemon-state/engine-readiness.d.ts

@@ -0,0 +1,73 @@
+/**
+ * How long a not-ready engine holds its spawns before it is re-probed (and, if
+ * no re-probe runs, before one spawn is let through to try it). Five minutes:
+ * a host that was fixed (installed, logged in) resumes within one wait, and a
+ * host that was not costs one probe -- not one failed lead -- per wait.
+ */
+export declare const ENGINE_REPROBE_MS: number;
+/** The persisted record's file name, under the global state dir. */
+export declare const ENGINE_READINESS_FILE = "engine-readiness.json";
+/** What a not-ready engine lacks: its CLI binary, or its login. */
+export type EngineMissing = 'binary' | 'login';
+/** What last set an engine's readiness. */
+export type EngineReadinessSource = 'probe' | 'spawn_enoent' | 'auth_failure';
+/** One engine's readiness on this host. */
+export interface EngineReadiness {
+    engineId: string;
+    ready: boolean;
+    /** What is missing when not ready; null when ready. */
+    missing: EngineMissing | null;
+    /** Names the missing binary or login (and how to fix it); null when ready. */
+    detail: string | null;
+    source: EngineReadinessSource;
+    /** When the engine entered its current readiness, epoch ms. */
+    sinceMs: number;
+    /** When a not-ready engine is next re-probed, epoch ms; null when ready. */
+    nextProbeAtMs: number | null;
+    /** Whether the gap holds spawns on the engine (see WHICH GAPS HOLD); false when ready. */
+    holdsSpawns: boolean;
+}
+/** The persisted file's shape. */
+export interface PersistedEngineReadiness {
+    host: string;
+    updatedAt: string;
+    engines: EngineReadiness[];
+}
+/** A probe result, as backends' probeAvailability returns it. */
+export interface EngineProbeResult {
+    available: boolean;
+    detail?: string;
+    missing?: EngineMissing;
+}
+/** Record what a probe found for an engine. A not-ready engine is re-probed after ENGINE_REPROBE_MS. */
+export declare function recordEngineProbe(engineId: string, probe: EngineProbeResult, nowMs?: number): EngineReadiness;
+/**
+ * Mark an engine not ready from a failed start or a failed authentication. Its
+ * spawns are held until a re-probe finds it ready or ENGINE_REPROBE_MS elapses.
+ */
+export declare function markEngineNotReady(engineId: string, why: {
+    missing: EngineMissing;
+    detail: string;
+    source: Exclude<EngineReadinessSource, 'probe'>;
+}, nowMs?: number): EngineReadiness;
+/**
+ * The instant a not-ready engine's hold on its spawns ends, or null when it
+ * holds none: the engine is ready, unknown (never probed -- a spawn is its
+ * probe), reported without a hold, or its wait has elapsed.
+ */
+export declare function engineNotReadyUntilMs(engineId: string, nowMs?: number): number | null;
+/** True when any engine's readiness holds spawns now (the spawn gates resolve a route only then). */
+export declare function anyEngineSpawnHold(nowMs?: number): boolean;
+/** The engines whose re-probe is due: recorded not ready, with the wait elapsed. */
+export declare function enginesDueForReprobe(nowMs?: number): string[];
+/** Every engine's current readiness, in engine-id order. */
+export declare function engineReadinessSnapshot(): EngineReadiness[];
+/** Read the record the running daemon persisted, or null when there is none (or it is unreadable). */
+export declare function readPersistedEngineReadiness(): PersistedEngineReadiness | null;
+/** One engine's readiness line, as the startup log and `telora-daemon status` print it. */
+export declare function formatEngineReadinessLine(record: Pick<EngineReadiness, 'engineId' | 'ready' | 'missing' | 'detail' | 'holdsSpawns'>): string;
+/** Every engine's readiness line. */
+export declare function formatEngineReadinessLines(engines: ReadonlyArray<Pick<EngineReadiness, 'engineId' | 'ready' | 'missing' | 'detail' | 'holdsSpawns'>>): string[];
+/** Test-only: forget every record, as a daemon re-exec starts with none. */
+export declare function __resetEngineReadinessForTests(): void;
+//# sourceMappingURL=engine-readiness.d.ts.map

package/dist/daemon-state/engine-readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-readiness.d.ts","sourceRoot":"","sources":["../../src/daemon-state/engine-readiness.ts"],"names":[],"mappings":"AAmDA;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,QAAa,CAAC;AAE5C,oEAAoE;AACpE,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D,mEAAmE;AACnE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE/C,2CAA2C;AAC3C,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,cAAc,GAAG,cAAc,CAAC;AAE9E,2CAA2C;AAC3C,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,uDAAuD;IACvD,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,8EAA8E;IAC9E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,0FAA0F;IAC1F,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,kCAAkC;AAClC,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAsCD,wGAAwG;AACxG,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,GAAE,MAAmB,GAAG,eAAe,CAmBzH;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAA;CAAE,EAChG,KAAK,GAAE,MAAmB,GACzB,eAAe,CAejB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAmB,GAAG,MAAM,GAAG,IAAI,CAIjG;AAED,qGAAqG;AACrG,wBAAgB,kBAAkB,CAAC,KAAK,GAAE,MAAmB,GAAG,OAAO,CAGtE;AAED,oFAAoF;AACpF,wBAAgB,oBAAoB,CAAC,KAAK,GAAE,MAAmB,GAAG,MAAM,EAAE,CAIzE;AAED,4DAA4D;AAC5D,wBAAgB,uBAAuB,IAAI,eAAe,EAAE,CAE3D;AAED,sGAAsG;AACtG,wBAAgB,4BAA4B,IAAI,wBAAwB,GAAG,IAAI,CAU9E;AAED,2FAA2F;AAC3F,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,CAAC,GAAG,MAAM,CAK5I;AAED,qCAAqC;AACrC,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,CAAC,CAAC,GAAG,MAAM,EAAE,CAE/J;AAED,4EAA4E;AAC5E,wBAAgB,8BAA8B,IAAI,IAAI,CAErD"}

package/dist/daemon-state/engine-readiness.js

@@ -0,0 +1,191 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/daemon-state/engine-readiness.test.ts,
+//   packages/daemon/src/integration/engine-readiness-runtime.test.ts,
+//   packages/daemon/src/integration/model-reached-review-exit-effects.test.ts,
+//   packages/daemon/src/shell/unified-shell-status.test.ts, packages/daemon/src/spawn/codex-auth.test.ts,
+//   packages/daemon/src/spawn/engine-not-ready-gate.test.ts, packages/daemon/src/spawn/model-reached.test.ts
+// PINNED-BY-END
+/**
+ * Per-host engine readiness: can this host START each engine the daemon may
+ * spawn (claude, codex), and can that engine AUTHENTICATE?
+ *
+ * Readiness is HOST STATE. An engine whose binary is missing, or which is not
+ * logged in, is not a team failure, not a review and not an escalation (the
+ * standing ruling: config gaps are state, never escalations). Without this
+ * record a missing binary drew a failed lead on every poll, and nothing a human
+ * looks at said the host could not run the engine.
+ *
+ * So:
+ *  - A probe (backends/availability.ts, the backends' own probeAvailability)
+ *    seeds the record at startup and re-reads a not-ready engine.
+ *  - A failed start (ENOENT, spawn/process-spawn.ts) or a failed authentication
+ *    (a Codex 401, spawn/codex-auth.ts) marks the engine not ready.
+ *  - While an engine is not ready AND the gap holds spawns, no lead is spawned
+ *    on it (the `engine_not_ready` stop row, read by the spawn gates) until a
+ *    re-probe finds it ready or ENGINE_REPROBE_MS elapses. A re-probe that finds
+ *    it ready clears the record -- installing or logging in needs no restart.
+ *
+ * WHICH GAPS HOLD. A missing binary always does: nothing can start it. A missing
+ * login does only once a spawn has OBSERVED the authentication fail. The host
+ * probe reads the host's own login (~/.codex/auth.json, ~/.claude.json, the
+ * daemon's env) and cannot see a key the per-spawn environment supplies
+ * (spawn/spawn-environment.ts fetchBackendEnvExtras), so a probe that finds only
+ * the login missing is REPORTED -- status and the startup log say so -- but
+ * holds nothing (spawn/process-spawn.ts gateLocalModelBackendSpawn makes the
+ * same call for the same reason).
+ *
+ * The record is persisted under the global state dir so the separate
+ * `telora-daemon status` process can read what the running daemon knows.
+ *
+ * History: docs/daemon/history-team-lifecycle.md (daemon-state/engine-readiness.ts).
+ */
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { hostname } from 'node:os';
+import { join } from 'node:path';
+import { resolveGlobalStateDir } from './daemon-process.js';
+import { createLogger } from '../log/daemon-log.js';
+const log = createLogger({ module: 'engine-readiness' });
+/**
+ * How long a not-ready engine holds its spawns before it is re-probed (and, if
+ * no re-probe runs, before one spawn is let through to try it). Five minutes:
+ * a host that was fixed (installed, logged in) resumes within one wait, and a
+ * host that was not costs one probe -- not one failed lead -- per wait.
+ */
+export const ENGINE_REPROBE_MS = 5 * 60_000;
+/** The persisted record's file name, under the global state dir. */
+export const ENGINE_READINESS_FILE = 'engine-readiness.json';
+const records = new Map();
+function statePath() {
+    return join(resolveGlobalStateDir(), ENGINE_READINESS_FILE);
+}
+/** Write the record for `telora-daemon status`. Best-effort: a failed write never breaks a spawn. */
+function persist(nowMs) {
+    try {
+        const dir = resolveGlobalStateDir();
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true, mode: 0o700 });
+        const body = {
+            host: hostname(),
+            updatedAt: new Date(nowMs).toISOString(),
+            engines: [...records.values()],
+        };
+        const path = statePath();
+        const tmp = `${path}.tmp`;
+        writeFileSync(tmp, `${JSON.stringify(body, null, 2)}\n`, { mode: 0o600 });
+        renameSync(tmp, path);
+    }
+    catch (err) {
+        log.warn(`[engine] could not persist engine readiness: ${err.message}`);
+    }
+}
+function set(next, nowMs) {
+    const prev = records.get(next.engineId);
+    records.set(next.engineId, next);
+    // A change of readiness is logged as it happens; the first reading is printed
+    // by the startup report (shell/unified-shell-status.ts reportEngineReadiness).
+    if (prev && (prev.ready !== next.ready || prev.missing !== next.missing)) {
+        log.info(formatEngineReadinessLine(next));
+    }
+    persist(nowMs);
+}
+/** Record what a probe found for an engine. A not-ready engine is re-probed after ENGINE_REPROBE_MS. */
+export function recordEngineProbe(engineId, probe, nowMs = Date.now()) {
+    const prev = records.get(engineId);
+    const ready = probe.available;
+    const missing = ready ? null : (probe.missing ?? 'binary');
+    const unchanged = prev !== undefined && prev.ready === ready && prev.missing === missing;
+    // A login the probe cannot find holds spawns only when a spawn already saw it fail.
+    const holdsSpawns = !ready && (missing === 'binary' || (unchanged && prev.holdsSpawns));
+    const next = {
+        engineId,
+        ready,
+        missing,
+        detail: ready ? null : (unchanged && prev.detail ? prev.detail : (probe.detail ?? `${engineId} is not ready on ${hostname()}`)),
+        source: unchanged ? prev.source : 'probe',
+        sinceMs: unchanged ? prev.sinceMs : nowMs,
+        nextProbeAtMs: ready ? null : nowMs + ENGINE_REPROBE_MS,
+        holdsSpawns,
+    };
+    set(next, nowMs);
+    return next;
+}
+/**
+ * Mark an engine not ready from a failed start or a failed authentication. Its
+ * spawns are held until a re-probe finds it ready or ENGINE_REPROBE_MS elapses.
+ */
+export function markEngineNotReady(engineId, why, nowMs = Date.now()) {
+    const prev = records.get(engineId);
+    const unchanged = prev !== undefined && !prev.ready && prev.missing === why.missing;
+    const next = {
+        engineId,
+        ready: false,
+        missing: why.missing,
+        detail: why.detail,
+        source: why.source,
+        sinceMs: unchanged ? prev.sinceMs : nowMs,
+        nextProbeAtMs: nowMs + ENGINE_REPROBE_MS,
+        holdsSpawns: true,
+    };
+    set(next, nowMs);
+    return next;
+}
+/**
+ * The instant a not-ready engine's hold on its spawns ends, or null when it
+ * holds none: the engine is ready, unknown (never probed -- a spawn is its
+ * probe), reported without a hold, or its wait has elapsed.
+ */
+export function engineNotReadyUntilMs(engineId, nowMs = Date.now()) {
+    const record = records.get(engineId);
+    if (!record || record.ready || !record.holdsSpawns || record.nextProbeAtMs === null)
+        return null;
+    return record.nextProbeAtMs > nowMs ? record.nextProbeAtMs : null;
+}
+/** True when any engine's readiness holds spawns now (the spawn gates resolve a route only then). */
+export function anyEngineSpawnHold(nowMs = Date.now()) {
+    for (const record of records.values())
+        if (engineNotReadyUntilMs(record.engineId, nowMs) !== null)
+            return true;
+    return false;
+}
+/** The engines whose re-probe is due: recorded not ready, with the wait elapsed. */
+export function enginesDueForReprobe(nowMs = Date.now()) {
+    return [...records.values()]
+        .filter((r) => !r.ready && r.nextProbeAtMs !== null && r.nextProbeAtMs <= nowMs)
+        .map((r) => r.engineId);
+}
+/** Every engine's current readiness, in engine-id order. */
+export function engineReadinessSnapshot() {
+    return [...records.values()].sort((a, b) => a.engineId.localeCompare(b.engineId));
+}
+/** Read the record the running daemon persisted, or null when there is none (or it is unreadable). */
+export function readPersistedEngineReadiness() {
+    try {
+        const path = statePath();
+        if (!existsSync(path))
+            return null;
+        const parsed = JSON.parse(readFileSync(path, 'utf8'));
+        if (typeof parsed !== 'object' || parsed === null || !Array.isArray(parsed.engines))
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/** One engine's readiness line, as the startup log and `telora-daemon status` print it. */
+export function formatEngineReadinessLine(record) {
+    if (record.ready)
+        return `[engine] ${record.engineId}: ready (starts and authenticates on ${hostname()})`;
+    const what = record.missing === 'login' ? 'not logged in' : 'binary not found';
+    const hold = record.holdsSpawns ? 'no lead is spawned on it until it re-probes ready' : 'reported only; a per-spawn key may still authenticate it';
+    return `[engine] ${record.engineId}: NOT READY on ${hostname()} -- ${what}: ${record.detail ?? 'no detail recorded'} (${hold})`;
+}
+/** Every engine's readiness line. */
+export function formatEngineReadinessLines(engines) {
+    return [...engines].sort((a, b) => a.engineId.localeCompare(b.engineId)).map(formatEngineReadinessLine);
+}
+/** Test-only: forget every record, as a daemon re-exec starts with none. */
+export function __resetEngineReadinessForTests() {
+    records.clear();
+}
+//# sourceMappingURL=engine-readiness.js.map

package/dist/daemon-state/engine-readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-readiness.js","sourceRoot":"","sources":["../../src/daemon-state/engine-readiness.ts"],"names":[],"mappings":"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"}

package/dist/daemon-state/focus-progress-clock.d.ts

@@ -0,0 +1,34 @@
+/** Whether a delivery moving from `from` to `to` is forward progress toward done. The ONE definition. */
+export declare function isForwardDeliveryAdvance(from: string | null | undefined, to: string | null | undefined): boolean;
+/** Record a read of a focus's deliveries; stamps the clock when one advanced forward since the last status known for it. */
+export declare function observeDeliveryProgress(focusId: string, rows: readonly {
+    id: string;
+    executionStatus?: string | null;
+}[], now: number): void;
+/** Record a read of one delivery's issues; stamps the clock when an issue seen open before is now Done. */
+export declare function observeIssueProgress(focusId: string, deliveryId: string, issues: readonly {
+    id: string;
+    status: string;
+}[], now: number): void;
+/**
+ * A delivery status write LANDED at `now` (the physical writer calls this once
+ * its write resolved). Stamps the clock of the focus whose latest read listed
+ * the delivery when the move is forward from the last status known for it, and
+ * records the written status so the next read does not count the same move
+ * again at its later time.
+ */
+export declare function recordDeliveryStatusWrite(deliveryId: string, status: string, now: number): void;
+/**
+ * An issue status write LANDED at `now` (the issue status writer calls this once
+ * its write resolved). Stamps the clock of the focus whose latest read of a
+ * delivery's issues listed the issue when the write completed it, and records
+ * the written status so the next read does not count it again.
+ */
+export declare function recordIssueStatusWrite(issueId: string, status: string, now: number): void;
+/** When the focus's work last moved forward (epoch ms), or null when this process has seen no movement. */
+export declare function readFocusLastProgressAt(focusId: string): number | null;
+/** Forget a focus that is no longer active (the poll stopped listing it). */
+export declare function forgetFocusProgress(focusId: string): void;
+/** Test-only: forget every focus. */
+export declare function __resetFocusProgressClockForTests(): void;
+//# sourceMappingURL=focus-progress-clock.d.ts.map

package/dist/daemon-state/focus-progress-clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-progress-clock.d.ts","sourceRoot":"","sources":["../../src/daemon-state/focus-progress-clock.ts"],"names":[],"mappings":"AAuEA,yGAAyG;AACzG,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAIhH;AAiCD,4HAA4H;AAC5H,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,EAChE,GAAG,EAAE,MAAM,GACV,IAAI,CAUN;AAED,2GAA2G;AAC3G,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,EACjD,GAAG,EAAE,MAAM,GACV,IAAI,CASN;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAQ/F;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CASzF;AAED,2GAA2G;AAC3G,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEtE;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEzD;AAED,qCAAqC;AACrC,wBAAgB,iCAAiC,IAAI,IAAI,CAExD"}

package/dist/daemon-state/focus-progress-clock.js

@@ -0,0 +1,167 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/focus/focus-activity-progress-clock.test.ts,
+//   packages/daemon/src/focus/heartbeat-focus-activity.test.ts
+// PINNED-BY-END
+/**
+ * The per-focus PROGRESS CLOCK: when a focus's work last moved forward, by the
+ * two facts the focus activity record names -- a delivery's execution status
+ * advancing FORWARD ({@link isForwardDeliveryAdvance}: queued -> coding ->
+ * verify -> done, and verify_failed -> coding) or an issue moving to Done. The
+ * record publishes it as every entry's `lastProgressAt`
+ * (focus/focus-activity-sources.ts commonFields).
+ *
+ * Why its own clock: the live team's progress measure
+ * (completion/team-progress/team-stillness.ts) is forgotten when the team ends,
+ * so the between-sessions entries (idle, cooldown, review_parked, a pending
+ * spawn) -- exactly the ones a reader checks for churn -- would publish no
+ * progress time at all. This clock is keyed by focus, not by team: a teardown,
+ * a respawn or a session ending changes nothing here, so repeated teardowns
+ * without progress leave the time standing while the spawn-teardown streak
+ * grows beside it.
+ *
+ * TWO FEEDS, one primary:
+ *
+ *   1. The daemon's own WRITES, stamped when they land. The physical delivery
+ *      status writer (queries/deliveries/deliveries.ts updateDeliveryStatus)
+ *      calls {@link recordDeliveryStatusWrite} once its write resolves, and the
+ *      issue status writer (queries/deliveries/issues.ts updateIssueStatus)
+ *      calls {@link recordIssueStatusWrite}: the stamp is the write's own time,
+ *      not the next poll's.
+ *   2. The poll's READS, as RECOVERY (focus/focus-activity-poll-facts.ts), at
+ *      no extra query: each read of a focus's deliveries and of a delivery's
+ *      issues is compared with the last status this clock knows for the same
+ *      rows -- which a landed write has already updated, so the write is not
+ *      counted twice at the later read time. What the reads catch is movement
+ *      written ELSEWHERE (an agent closing an issue over MCP, an operator).
+ *
+ * A write names a delivery or issue, not a focus: it is attributed to the focus
+ * whose latest read listed that row. A write to a row no read has listed yet
+ * stamps nothing (the first read of it is its baseline). The FIRST read of a
+ * focus's deliveries or of a delivery's issues is a baseline, not movement -- a
+ * restart or a newly active focus publishes null until something actually
+ * moves, never the daemon's boot time dressed up as progress. Only forward
+ * edges count: a back-path (verify -> verify_failed, a re-queue) or an issue
+ * re-opened is not progress.
+ *
+ * In memory, per daemon process. Nothing is written to the database.
+ *
+ * @module daemon-state/focus-progress-clock
+ */
+import { DELIVERY_STATUS } from '@telora/daemon-core';
+/**
+ * A delivery's position on the main path toward done; a status absent here
+ * (draft, planning, paused, cancelled) is off the path, so no move into or out
+ * of it is progress. verify_failed sits with queued: its work is owed again, so
+ * a re-queue (verify_failed -> queued) is not progress and a restart
+ * (verify_failed -> coding) is. Every adjacent forward step here is a declared
+ * EXECUTION_STATUS_TRANSITIONS edge (pinned by the progress-clock test); a read
+ * may observe a multi-step jump (queued -> verify between two polls), which is
+ * forward too.
+ */
+const MAIN_PATH_RANK = new Map([
+    [DELIVERY_STATUS.QUEUED, 0],
+    [DELIVERY_STATUS.VERIFY_FAILED, 0],
+    [DELIVERY_STATUS.CODING, 1],
+    [DELIVERY_STATUS.VERIFY, 2],
+    [DELIVERY_STATUS.DONE, 3],
+]);
+/** Whether a delivery moving from `from` to `to` is forward progress toward done. The ONE definition. */
+export function isForwardDeliveryAdvance(from, to) {
+    const a = MAIN_PATH_RANK.get(from ?? '');
+    const b = MAIN_PATH_RANK.get(to ?? '');
+    return a !== undefined && b !== undefined && b > a;
+}
+/** An issue reaching one of these has moved to Done. */
+const DONE_ISSUE_STATUSES = new Set(['Done', 'Verified']);
+/** Whether an issue moving from `before` to `after` completed it. */
+function isIssueCompletion(before, after) {
+    return before !== undefined && !DONE_ISSUE_STATUSES.has(before) && DONE_ISSUE_STATUSES.has(after);
+}
+const clocks = new Map();
+function clockOf(focusId) {
+    let clock = clocks.get(focusId);
+    if (!clock) {
+        clock = { deliveryStatuses: null, issueStatuses: new Map(), lastProgressAt: null };
+        clocks.set(focusId, clock);
+    }
+    return clock;
+}
+function stamp(clock, now) {
+    clock.lastProgressAt = clock.lastProgressAt === null ? now : Math.max(clock.lastProgressAt, now);
+}
+/** Record a read of a focus's deliveries; stamps the clock when one advanced forward since the last status known for it. */
+export function observeDeliveryProgress(focusId, rows, now) {
+    const clock = clockOf(focusId);
+    const prior = clock.deliveryStatuses;
+    const next = new Map(rows.map((d) => [d.id, d.executionStatus ?? null]));
+    if (prior) {
+        const advanced = [...next].some(([id, status]) => prior.has(id) && isForwardDeliveryAdvance(prior.get(id), status));
+        if (advanced)
+            stamp(clock, now);
+    }
+    clock.deliveryStatuses = next;
+    for (const deliveryId of clock.issueStatuses.keys())
+        if (!next.has(deliveryId))
+            clock.issueStatuses.delete(deliveryId);
+}
+/** Record a read of one delivery's issues; stamps the clock when an issue seen open before is now Done. */
+export function observeIssueProgress(focusId, deliveryId, issues, now) {
+    const clock = clockOf(focusId);
+    const prior = clock.issueStatuses.get(deliveryId);
+    const next = new Map(issues.map((i) => [i.id, i.status]));
+    if (prior) {
+        const completed = [...next].some(([id, status]) => isIssueCompletion(prior.get(id), status));
+        if (completed)
+            stamp(clock, now);
+    }
+    clock.issueStatuses.set(deliveryId, next);
+}
+/**
+ * A delivery status write LANDED at `now` (the physical writer calls this once
+ * its write resolved). Stamps the clock of the focus whose latest read listed
+ * the delivery when the move is forward from the last status known for it, and
+ * records the written status so the next read does not count the same move
+ * again at its later time.
+ */
+export function recordDeliveryStatusWrite(deliveryId, status, now) {
+    for (const clock of clocks.values()) {
+        const statuses = clock.deliveryStatuses;
+        if (!statuses?.has(deliveryId))
+            continue;
+        if (isForwardDeliveryAdvance(statuses.get(deliveryId), status))
+            stamp(clock, now);
+        statuses.set(deliveryId, status);
+        return;
+    }
+}
+/**
+ * An issue status write LANDED at `now` (the issue status writer calls this once
+ * its write resolved). Stamps the clock of the focus whose latest read of a
+ * delivery's issues listed the issue when the write completed it, and records
+ * the written status so the next read does not count it again.
+ */
+export function recordIssueStatusWrite(issueId, status, now) {
+    for (const clock of clocks.values()) {
+        for (const issues of clock.issueStatuses.values()) {
+            if (!issues.has(issueId))
+                continue;
+            if (isIssueCompletion(issues.get(issueId), status))
+                stamp(clock, now);
+            issues.set(issueId, status);
+            return;
+        }
+    }
+}
+/** When the focus's work last moved forward (epoch ms), or null when this process has seen no movement. */
+export function readFocusLastProgressAt(focusId) {
+    return clocks.get(focusId)?.lastProgressAt ?? null;
+}
+/** Forget a focus that is no longer active (the poll stopped listing it). */
+export function forgetFocusProgress(focusId) {
+    clocks.delete(focusId);
+}
+/** Test-only: forget every focus. */
+export function __resetFocusProgressClockForTests() {
+    clocks.clear();
+}
+//# sourceMappingURL=focus-progress-clock.js.map

package/dist/daemon-state/focus-progress-clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-progress-clock.js","sourceRoot":"","sources":["../../src/daemon-state/focus-progress-clock.ts"],"names":[],"mappings":"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"}

package/dist/daemon-state/focus-team-state.d.ts

@@ -11,7 +11,8 @@
  * Owner of the `lifecycle` and `activity` sub-records of FocusTeamState (see
  * types/focus-team-state.ts, TEAM_STATE_OWNERS): every write of phase,
  * shutdownReason, shutdownAttribution, shuttingDownAt, lastActivityAt,
- * toolActivityCount and errorResultAt goes through a writer exported here.
+ * toolActivityCount, errorResultAt, modelReachedAt and the working delivery goes through a writer
+ * exported here.
  *
  * The ONE intentional side-table is `slotTokens`. It is deliberately NOT folded
  * onto the record because its lifecycle must OUTLIVE activeTeams membership: a
@@ -39,6 +40,26 @@ import type { ShutdownAttribution, TeamShutdownReason } from '../types/shutdown-
  * @param now     Epoch ms of the event (default Date.now()).
  */
 export declare function recordTeamActivity(focusId: string, now?: number): void;
+/**
+ * Record the delivery `team` is working, observed at `observedAt`. Bound to the
+ * team OBJECT, not its focus: an observation that resolves after its team left
+ * activeTeams (and a replacement took the focus) is dropped, never stamped on the
+ * replacement. An observation older than the one already recorded is dropped too
+ * (resolutions complete out of order).
+ */
+export declare function recordTeamWorkingDelivery(team: FocusTeamState, deliveryId: string, observedAt: number): void;
+/**
+ * Seed the delivery a team is spawned to work (spawn/team-working-delivery.ts
+ * workingDeliveryAtSpawn), before its first act. Dated at epoch 0, so any
+ * observation of the team's own acts supersedes it.
+ */
+export declare function seedTeamWorkingDelivery(team: FocusTeamState, deliveryId: string): void;
+/**
+ * Record that `team` was spawned with no delivery to work on a focus whose
+ * deliveries are all terminal (spawn/team-working-delivery.ts). A delivery its
+ * own acts later name supersedes it (the producer reads the delivery first).
+ */
+export declare function seedTeamResolvingWithoutDelivery(team: FocusTeamState): void;
 /**
  * Epoch ms of the team's last recorded agent event, or null when nothing has
  * been recorded yet (e.g. a team still initializing before its first event, or
@@ -88,6 +109,8 @@ export declare function setTeamShutdownReason(team: FocusTeamState, reason: Team
 export declare function setShutdownAttribution(team: FocusTeamState, attribution: ShutdownAttribution): void;
 /** Count one tool invocation by the pass (inspection evidence for the review-exit gate). */
 export declare function countToolActivity(team: FocusTeamState): void;
+/** Record that the session's model was reached, at the FIRST output it produced (later outputs keep that instant). */
+export declare function markModelReached(team: FocusTeamState, atMs: number): void;
 /** Record that the session emitted a terminal-error result at `atMs`. */
 export declare function stampErrorResult(team: FocusTeamState, atMs: number): void;
 /**
@@ -153,18 +176,18 @@ export declare function hasActiveTeam(focusId: string): boolean;
  */
 export declare function getActiveTeamCount(): number;
 /**
- * Build the per-focus published activity-clock map: focusId -> epoch ms of the
- * team's last recorded agent event, for every active team that has recorded at
- * least one event. This publishes the SAME in-memory clock the daemon acts on to
- * decide a team is still running (getTeamLastActivityAt / recordTeamActivity), so
- * every liveness surface can classify from the one clock the daemon trusts
- * instead of the separately-flushed agent_sessions.activity_summary.updatedAt.
+ * Build the per-focus activity-clock map: focusId -> epoch ms of the team's last
+ * recorded agent event, for every active team that has recorded at least one
+ * event -- the SAME in-memory clock the daemon acts on to decide a team is still
+ * running (getTeamLastActivityAt / recordTeamActivity). The heartbeat feeds it to
+ * the clock-divergence health check; it is no longer published as
+ * metadata.teamClocks (the focus activity record carries the clock as
+ * lastAgentEventAt on its team entries).
  *
  * Pull-model, exactly like buildTeamLivenessPhaseMap: recomputed from live activeTeams
  * each heartbeat, so a torn-down focus drops out of the map on its own. A team
  * still initializing before its first event (lastActivityAt undefined) is
- * omitted -- an absent clock reads as "fall back to activity_summary" downstream,
- * never as a frozen-since-epoch team.
+ * omitted -- an absent clock is "no event yet", never a frozen-since-epoch team.
  */
 export declare function buildTeamClockMap(): Record<string, number>;
 /**