squadrant 0.13.5 → 0.14.0

package/dist/squadrantd.js

@@ -33,7 +33,9 @@ function assembleDaemonSnapshot(input, now) {
         ageMs: input.lastSweepAt == null ? null : now - input.lastSweepAt,
         cadenceMs: input.sweepCadenceMs
       },
-      log: input.log
+      log: input.log,
+      telegram: input.telegram,
+      lifecycleSources: input.lifecycleSources
     },
     tier1: input.health,
     tier2: {
@@ -45,7 +47,8 @@ function assembleDaemonSnapshot(input, now) {
           lastAckedSeq: p.lastAckedSeq,
           behind: Math.max(0, p.mailbox.maxSeq - p.lastAckedSeq)
         },
-        store: { byState: p.storeByState, corruptCount: p.corruptCount }
+        store: { byState: p.storeByState, corruptCount: p.corruptCount },
+        deferral: p.deferral ?? { maxDeferCount: 0, stuck: false }
       })),
       results: input.results
     }
@@ -1128,18 +1131,21 @@ async function* readFromCursor(opts) {
 }
 async function mailboxStats(stateRoot, project) {
   const file = logPath(stateRoot, project);
+  const rotated = await listRotatedOldestFirst(stateRoot, project);
   let sizeBytes = 0;
-  try {
-    sizeBytes = (await fs7.stat(file)).size;
-  } catch (e) {
-    if (e.code !== "ENOENT")
-      throw e;
+  for (const f of [file, ...rotated]) {
+    try {
+      sizeBytes += (await fs7.stat(f)).size;
+    } catch (e) {
+      if (e.code !== "ENOENT")
+        throw e;
+    }
   }
-  const rotated = await listRotatedOldestFirst(stateRoot, project);
+  const oldestFile = rotated[0] ?? file;
   return {
     maxSeq: await readMaxSeq(stateRoot, project),
     sizeBytes,
-    oldestEntryAgeMs: await oldestEntryAgeMs(file),
+    oldestEntryAgeMs: await oldestEntryAgeMs(oldestFile),
     rotationCount: rotated.length
   };
 }
@@ -1412,13 +1418,14 @@ function projectHealth(input) {
   for (const c of crews) {
     if (TERMINAL.has(c.state))
       continue;
+    const undelivered = c.mode === "interactive" && !c.firstTurnConfirmedAt && c.heartbeatBudgetMs != null && now - c.lastHeartbeat > c.heartbeatBudgetMs;
     out.push({
       kind: "crew",
       project,
       ref: c.name ?? c.id.slice(0, 8),
       state: classifyHealth(c.lastHeartbeat, now, CREW_STALE_MS, CREW_GONE_MS),
       lastSeenMs: c.lastHeartbeat,
-      detail: c.state
+      detail: undelivered ? `undelivered (${c.state})` : c.state
     });
   }
   return out;
@@ -1638,6 +1645,7 @@ function buildContext(opts) {
     opencodeBridge: null,
     cmuxEventsBridge: null,
     telegramBridge: void 0,
+    lifecycleSources: opts.lifecycleSources ?? [],
     broadcast: () => {
     },
     schedulePromotion: () => {
@@ -1969,6 +1977,14 @@ var CaptainDelivery = class {
       return { deferred: true };
     }
   }
+  /** Read-only. Never mutates — safe to poll from the snapshot assembler every tick. */
+  stats() {
+    let maxDeferCount = 0;
+    for (const c of this.deferCounts.values())
+      if (c > maxDeferCount)
+        maxDeferCount = c;
+    return { maxDeferCount, stuck: maxDeferCount >= this.opts.maxDefers };
+  }
 };
 
 // packages/core/dist/daemon/delivery-loop.js
@@ -2008,11 +2024,12 @@ function createDelivery(ctx, daemonCmux) {
     }
   };
   if (!daemonCmux) {
-    return { defaultNotify, deliveryTick: void 0 };
+    return { defaultNotify, deliveryTick: void 0, deliveryStats: () => void 0 };
   }
   const cmux2 = daemonCmux;
   const cfg = loadConfig();
   const deliveries = /* @__PURE__ */ new Map();
+  const deliveryStats = (project) => deliveries.get(project)?.stats();
   const sessionStartMs = Date.now();
   let delivering = false;
   const deliveryCore = async () => {
@@ -2095,7 +2112,7 @@ function createDelivery(ctx, daemonCmux) {
       delivering = false;
     }
   };
-  return { defaultNotify, deliveryTick };
+  return { defaultNotify, deliveryTick, deliveryStats };
 }
 
 // packages/core/dist/daemon/gates.js
@@ -2275,7 +2292,7 @@ function startDaemon(ctx, opts, pkgVersion) {
   const { stateRoot, store, log, isPidAlive, resultsDir, taskTimeoutMs, inFlightHeadlessIds, activeHeadlessKills, broadcast, cancelPromotionsFor } = ctx;
   const { daemonCmux } = ctx;
   const probes = createProbes(ctx);
-  const { defaultNotify, deliveryTick: initialDeliveryTick } = createDelivery(ctx, daemonCmux);
+  const { defaultNotify, deliveryTick: initialDeliveryTick, deliveryStats } = createDelivery(ctx, daemonCmux);
   const baseNotify = opts.notify ?? defaultNotify;
   const notify = ctx.telegramBridge ? async (args) => {
     await baseNotify(args);
@@ -2349,7 +2366,8 @@ function startDaemon(ctx, opts, pkgVersion) {
         mailbox: await mailboxStats(stateRoot, project),
         lastAckedSeq: cursor?.lastAckedSeq ?? 0,
         storeByState: storeStats.byState,
-        corruptCount: storeStats.corruptCount
+        corruptCount: storeStats.corruptCount,
+        deferral: deliveryStats(project)
       };
     }));
     return {
@@ -2360,6 +2378,8 @@ function startDaemon(ctx, opts, pkgVersion) {
       lastSweepAt: ctx.lastSweepAt.value,
       sweepCadenceMs: opts.sweepMs ?? 3e4,
       log: gatherLogStats(logPath2, now, SNAPSHOT_LOG_WINDOW_MS),
+      telegram: ctx.telegramBridge ? { configured: true, ...ctx.telegramBridge.health() } : { configured: false, polling: false, lastSuccessfulPollAt: null, lastError: null, lastErrorAt: null },
+      lifecycleSources: ctx.lifecycleSources.map((s) => ({ name: s.name, ...s.health?.() ?? { active: true, error: null } })),
       health: buildHealth(),
       projects,
       results: gatherResults(resultsDir)
@@ -2978,6 +2998,9 @@ function createTelegramBridge(opts) {
   const configRoot = opts.configRoot ?? path9.join(os3.homedir(), ".config", "squadrant");
   const pollMs = cfg.pollMs ?? 1e3;
   let running = false;
+  let lastSuccessfulPollAt = null;
+  let lastError = null;
+  let lastErrorAt = null;
   function persistOffset(next) {
     const s = loadState(stateRoot);
     s.offset = next;
@@ -3276,7 +3299,10 @@ function createTelegramBridge(opts) {
           await handleUpdate(u);
           persistOffset(u.update_id + 1);
         }
+        lastSuccessfulPollAt = Date.now();
       } catch (e) {
+        lastError = e.message;
+        lastErrorAt = Date.now();
         log(`telegram inbound poll failed: ${e.message}`);
       }
       if (running)
@@ -3297,6 +3323,9 @@ function createTelegramBridge(opts) {
       void deliverOutbound(project, ev).catch((e) => {
         log(`telegram outbound failed project=${project}: ${e.message}`);
       });
+    },
+    health() {
+      return { polling: running, lastSuccessfulPollAt, lastError, lastErrorAt };
     }
   };
 }
@@ -3568,17 +3597,24 @@ var CodexAppServerSource = class {
   deps;
   /** taskId → last reported snapshot (for snapshot() liveness floor). */
   cache = /* @__PURE__ */ new Map();
+  active = false;
   start(deps) {
     this.deps = deps;
+    this.active = true;
   }
   stop() {
     this.deps = void 0;
     this.cache.clear();
+    this.active = false;
   }
   /** Returns the last-reported snapshot for a known crew (liveness floor). */
   snapshot(taskId) {
     return this.cache.get(taskId);
   }
+  /** Read-only source health (B4). Purely push-driven — never errors on its own. */
+  health() {
+    return { active: this.active, error: null };
+  }
   /**
    * Feed a ControlEvent from CodexInteractiveDriver into this source.
    * The daemon wires: emit = (ev) => { source.observe(ev); handle(ev); }
@@ -4950,6 +4986,8 @@ var CmuxStoreSource = class {
   debounceTimer;
   /** taskId → last reported snapshot (for snapshot() liveness floor). */
   cache = /* @__PURE__ */ new Map();
+  active = false;
+  lastError = null;
   constructor(opts = {}) {
     this.stateDir = opts.stateDir ?? process.env.CMUX_AGENT_HOOK_STATE_DIR ?? join15(homedir10(), ".cmuxterm");
     this.debounceMs = opts.debounceMs ?? 50;
@@ -4965,10 +5003,13 @@ var CmuxStoreSource = class {
   }
   start(deps) {
     this.deps = deps;
+    this.active = true;
+    this.lastError = null;
     this.scan();
     try {
       this.stopWatcher = this.watchDir(this.stateDir, () => this.scheduleDebounced());
     } catch (e) {
+      this.lastError = e.message;
       this.log(`cmux-store: failed to watch ${this.stateDir}: ${e.message}`);
     }
   }
@@ -4981,11 +5022,16 @@ var CmuxStoreSource = class {
     this.stopWatcher = void 0;
     this.deps = void 0;
     this.cache.clear();
+    this.active = false;
   }
   /** Returns the last-reported snapshot for a known crew (liveness floor). */
   snapshot(taskId) {
     return this.cache.get(taskId);
   }
+  /** Read-only source health (B4 — dashboard visibility into which sources are up). */
+  health() {
+    return { active: this.active, error: this.lastError };
+  }
   // ── private ─────────────────────────────────────────────────────────────────
   scheduleDebounced() {
     if (this.debounceTimer !== void 0) {
@@ -5172,6 +5218,7 @@ var NativeHookSource = class {
   deps;
   /** taskId → last-reported snapshot, for snapshot() liveness floor. */
   cache = /* @__PURE__ */ new Map();
+  active = false;
   constructor(opts = {}) {
     this.hookInstall = opts.hookInstall ?? {};
     this.log = opts.log ?? (() => {
@@ -5179,15 +5226,21 @@ var NativeHookSource = class {
   }
   start(deps) {
     this.deps = deps;
+    this.active = true;
   }
   stop() {
     this.deps = void 0;
     this.cache.clear();
+    this.active = false;
   }
   /** Returns the last-reported snapshot for a known crew (liveness floor poll). */
   snapshot(taskId) {
     return this.cache.get(taskId);
   }
+  /** Read-only source health (B4). Purely push-driven — never errors on its own. */
+  health() {
+    return { active: this.active, error: null };
+  }
   /**
    * Install squadrant-owned hooks into ~/.claude/settings.json.
    * Idempotent — safe to call on every project init or crew spawn.
@@ -5359,6 +5412,7 @@ function startSquadrantd(opts = {}) {
   ctx.codexDriver = codexDriver;
   ctx.opencodeBridge = opencodeBridge;
   ctx.cmuxEventsBridge = cmuxEventsBridge;
+  ctx.lifecycleSources = [cmuxStoreSource, nativeHookSource, codexAppServerSource];
   const tgCfg = loadConfig().telegram;
   ctx.telegramBridge = opts.telegramBridge ?? (tgCfg && !process.env.VITEST ? buildTelegramBridge(tgCfg, stateRoot, log) : void 0);
   ctx.daemonCmux = opts.daemonCmux ?? (opts.makeDaemonCmux ?? (() => new DaemonCmux(createCmuxDriver())))();