squadrant 0.19.1 → 0.19.3

package/dist/index.js

@@ -86,22 +86,22 @@ var init_config_io = __esm({
 import path2 from "path";
 import os from "os";
 import chalk from "chalk";
-function isThinkingLevel(v) {
-  return THINKING_LEVELS.includes(v);
+function isThinkingLevel(v2) {
+  return THINKING_LEVELS.includes(v2);
 }
-function parseThinkingLevel(v) {
-  if (!isThinkingLevel(v)) {
-    throw new Error(`Invalid --thinking value '${v}'. Valid values: ${THINKING_LEVELS.join(", ")}`);
+function parseThinkingLevel(v2) {
+  if (!isThinkingLevel(v2)) {
+    throw new Error(`Invalid --thinking value '${v2}'. Valid values: ${THINKING_LEVELS.join(", ")}`);
   }
-  return v;
+  return v2;
 }
 function resolveControlChannelMode(cfg, agent) {
-  const v = cfg?.[agent];
-  return v && CONTROL_CHANNEL_MODES.has(v) ? v : "off";
+  const v2 = cfg?.[agent];
+  return v2 && CONTROL_CHANNEL_MODES.has(v2) ? v2 : "off";
 }
 function resolveCaptainChannelMode(defaults) {
-  const v = defaults?.captainChannel;
-  return v && CONTROL_CHANNEL_MODES.has(v) ? v : "off";
+  const v2 = defaults?.captainChannel;
+  return v2 && CONTROL_CHANNEL_MODES.has(v2) ? v2 : "off";
 }
 function getDefaultConfig() {
   return {
@@ -219,8 +219,8 @@ function deepMerge(base, patch) {
   if (patch === null || typeof patch !== "object" || Array.isArray(patch))
     return patch ?? base;
   const out = { ...base };
-  for (const [k, v] of Object.entries(patch)) {
-    out[k] = deepMerge(out[k], v);
+  for (const [k, v2] of Object.entries(patch)) {
+    out[k] = deepMerge(out[k], v2);
   }
   return out;
 }
@@ -730,7 +730,7 @@ function isCacheStale(state, now, intervalMs = CHECK_INTERVAL_MS, failureInterva
   return now - state.lastChecked >= (state.lastCheckFailed ? failureIntervalMs : intervalMs);
 }
 function isNewerVersion(latest, current) {
-  const parse2 = (v) => v.trim().replace(/^v/, "").split("-")[0].split(".").map((n) => Number(n) || 0);
+  const parse2 = (v2) => v2.trim().replace(/^v/, "").split("-")[0].split(".").map((n) => Number(n) || 0);
   const [la = 0, lb = 0, lc = 0] = parse2(latest);
   const [ca = 0, cb = 0, cc = 0] = parse2(current);
   if (la !== ca)
@@ -1111,8 +1111,8 @@ var init_runtime_sync = __esm({
 });
 
 // packages/shared/dist/lib/tool-compat.js
-function parseSemVer(v) {
-  const m = v.match(/(\d+)\.(\d+)\.(\d+)/);
+function parseSemVer(v2) {
+  const m = v2.match(/(\d+)\.(\d+)\.(\d+)/);
   if (!m)
     return null;
   return [parseInt(m[1], 10), parseInt(m[2], 10), parseInt(m[3], 10)];
@@ -2523,12 +2523,12 @@ function isDaemonSocketLive(sockPath, timeoutMs = 500) {
       return;
     }
     const conn = createConnection(sockPath);
-    const finish = (v) => {
+    const finish = (v2) => {
       try {
         conn.destroy();
       } catch {
       }
-      resolve4(v);
+      resolve4(v2);
     };
     const timer = setTimeout(() => finish(false), timeoutMs);
     conn.on("connect", () => {
@@ -3194,17 +3194,20 @@ function getDaemonPid(target) {
 function forceKickstartAndVerify(target, opts = {}) {
   const pollAttempts = opts.pollAttempts ?? 15;
   const pollDelayMs = opts.pollDelayMs ?? 300;
-  const kickstartRetries = opts.kickstartRetries ?? 5;
+  const kickstartRetries = opts.kickstartRetries ?? 10;
   const kickstartRetryDelayMs = opts.kickstartRetryDelayMs ?? 300;
   const pidBefore = getDaemonPid(target);
+  let kickstartError = null;
   for (let i = 0; i < kickstartRetries; i++) {
     try {
       execFileSync3("launchctl", ["kickstart", "-k", target], { stdio: "ignore" });
+      kickstartError = null;
       break;
     } catch (e) {
-      if (i === kickstartRetries - 1)
-        throw e;
-      Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, kickstartRetryDelayMs);
+      kickstartError = e;
+      if (i < kickstartRetries - 1) {
+        Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, kickstartRetryDelayMs);
+      }
     }
   }
   let pidAfter = null;
@@ -3216,7 +3219,16 @@ function forceKickstartAndVerify(target, opts = {}) {
       Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, pollDelayMs);
     }
   }
-  return { target, pidBefore, pidAfter, restarted: pidAfter !== null && pidAfter !== pidBefore };
+  const restarted = pidAfter !== null && pidAfter !== pidBefore;
+  if (kickstartError && !restarted)
+    throw kickstartError;
+  return {
+    target,
+    pidBefore,
+    pidAfter,
+    restarted,
+    ...kickstartError ? { note: "kickstart -k refused; daemon restarted by bootstrap" } : {}
+  };
 }
 function isOperatorInitiatedCommand(topLevelArg) {
   return topLevelArg !== void 0 && OPERATOR_INITIATED_COMMANDS.has(topLevelArg);
@@ -4125,6 +4137,38 @@ import fs9 from "fs";
 import os4 from "os";
 import path9 from "path";
 import { randomUUID as randomUUID3 } from "crypto";
+function ensureSocksDir(dir = CC_SOCKS_DIR) {
+  fs9.mkdirSync(dir, { recursive: true, mode: 448 });
+  if ((fs9.statSync(dir).mode & 511) !== 448)
+    fs9.chmodSync(dir, 448);
+}
+async function pollFirstTurnConfirmedAt(getTaskRecord, project, id) {
+  const deadline = Date.now() + FIRST_TURN_HOOK_CONFIRM_WINDOW_MS;
+  for (; ; ) {
+    const rec = await getTaskRecord(project, id).catch(() => void 0);
+    if (rec?.firstTurnConfirmedAt)
+      return true;
+    if (Date.now() >= deadline)
+      return false;
+    await new Promise((r) => setTimeout(r, FIRST_TURN_HOOK_POLL_INTERVAL_MS));
+  }
+}
+function firstTrueOrBothFalse(a, b) {
+  return new Promise((resolve4) => {
+    let settledFalseCount = 0;
+    const onSettle = (ok2) => {
+      if (ok2) {
+        resolve4(true);
+        return;
+      }
+      settledFalseCount++;
+      if (settledFalseCount === 2)
+        resolve4(false);
+    };
+    a.then(onSettle, () => onSettle(false));
+    b.then(onSettle, () => onSettle(false));
+  });
+}
 async function listCrewPanes(runtime, workspaceId, project) {
   const surfaces = await runtime.listSurfaces(workspaceId);
   return surfaces.filter((s) => s.title && isCrewTitle(project, s.title));
@@ -4235,7 +4279,7 @@ async function runCrewSpawn(input, config, deps) {
     deps.onModelResolved?.({ agentName, model: crewModel });
   }
   if (agentName === "claude") {
-    fs9.mkdirSync(CC_SOCKS_DIR, { recursive: true });
+    ensureSocksDir();
     const messagingSocketPath = path9.join(CC_SOCKS_DIR, `squadrant-${randomUUID3()}.sock`);
     const rec = await deps.dispatchCrew({
       provider: "claude",
@@ -4281,10 +4325,12 @@ async function runCrewSpawn(input, config, deps) {
       fs9.writeFileSync(spillFile, claudeFirstTurn, "utf8");
       claudeFirstTurn = `Full task is at ${spillFile} \u2014 cat it and follow it exactly.`;
     }
-    const claudeResult = await deps.sendFirstTurn(pane2, `${claudeFirstTurn}
+    const sendPromise = deps.sendFirstTurn(pane2, `${claudeFirstTurn}
 
 ${buildCompletionProtocol(rec.id, input.project)}`, preLaunchScreen);
-    if (!claudeResult.delivered) {
+    const scrapeDelivered = sendPromise.then((r) => r.delivered).catch(() => false);
+    const delivered = hooksInstalled && deps.getTaskRecord ? await firstTrueOrBothFalse(scrapeDelivered, pollFirstTurnConfirmedAt(deps.getTaskRecord, input.project, rec.id)) : await scrapeDelivered;
+    if (!delivered) {
       process.stderr.write(`\u26A0\uFE0F  First turn not delivered for crew '${name}' \u2014 use 'squadrant crew send ${input.project} ${name}' to re-send the task.
 `);
     } else if (!hooksInstalled) {
@@ -4395,6 +4441,10 @@ async function runCrewSend(project, name, message, runtime, workspaceId, deps, o
     const heldForMin = Math.round((Date.now() - task.operatorHold.since) / 6e4);
     throw new Error(`Crew '${name}' is under operator takeover (held ${heldForMin}m${task.operatorHold.note ? `: ${task.operatorHold.note}` : ""}). The operator is working in that tab \u2014 sending a message disrupts their conversation. Ask them to run 'squadrant crew handback ${project} ${name}', or pass --force if they told you to.`);
   }
+  const isAttentionState = task?.state === "blocked" || task?.state === "awaiting-input" || task?.state === "review";
+  if (task && !isAttentionState && task.firstTurnConfirmedAt && task.task === message) {
+    throw new Error(`Crew '${name}' already confirmed receipt of this task \u2014 its first turn was delivered and is not being re-sent to avoid running it twice. If you have new instructions, send different text.`);
+  }
   let reopened = false;
   try {
     if (task) {
@@ -4561,7 +4611,7 @@ async function runCrewList(project, runtime, workspaceId) {
     surfaceId: c.surfaceId
   }));
 }
-var CC_SOCKS_DIR, FIRST_TURN_INLINE_MAX_BYTES, TEMPLATES_DIR, STATE_ROOT, CLOSE_LOOKUP_RETRIES, CLOSE_LOOKUP_RETRY_DELAY_MS;
+var CC_SOCKS_DIR, FIRST_TURN_INLINE_MAX_BYTES, TEMPLATES_DIR, STATE_ROOT, FIRST_TURN_HOOK_CONFIRM_WINDOW_MS, FIRST_TURN_HOOK_POLL_INTERVAL_MS, CLOSE_LOOKUP_RETRIES, CLOSE_LOOKUP_RETRY_DELAY_MS;
 var init_crew_spawn = __esm({
   "packages/core/dist/crew-spawn.js"() {
     init_control_channel();
@@ -4573,6 +4623,8 @@ var init_crew_spawn = __esm({
     FIRST_TURN_INLINE_MAX_BYTES = 1200;
     TEMPLATES_DIR = path9.join(os4.homedir(), ".config", "squadrant", "templates");
     STATE_ROOT = path9.join(os4.homedir(), ".config", "squadrant", "state");
+    FIRST_TURN_HOOK_CONFIRM_WINDOW_MS = 1e5;
+    FIRST_TURN_HOOK_POLL_INTERVAL_MS = 2e3;
     CLOSE_LOOKUP_RETRIES = 3;
     CLOSE_LOOKUP_RETRY_DELAY_MS = 150;
   }
@@ -4742,9 +4794,9 @@ function createDelivery(ctx, daemonCmux, isSurfaceAlive) {
   const lastDeferred = /* @__PURE__ */ new Map();
   const inFlightDelivery = () => {
     let worst2 = null;
-    for (const [project, v] of lastDeferred) {
-      if (!worst2 || v.deferCount > worst2.deferCount)
-        worst2 = { project, ...v };
+    for (const [project, v2] of lastDeferred) {
+      if (!worst2 || v2.deferCount > worst2.deferCount)
+        worst2 = { project, ...v2 };
     }
     return worst2;
   };
@@ -7108,6 +7160,326 @@ var init_lifecycle_source = __esm({
   }
 });
 
+// packages/core/dist/events/fact.js
+function stampFact(raw, id) {
+  return { ...raw, ...id };
+}
+var init_fact = __esm({
+  "packages/core/dist/events/fact.js"() {
+  }
+});
+
+// packages/core/dist/events/log.js
+var FactLog;
+var init_log = __esm({
+  "packages/core/dist/events/log.js"() {
+    FactLog = class {
+      capacity;
+      buffers = /* @__PURE__ */ new Map();
+      constructor(opts = {}) {
+        this.capacity = opts.capacity ?? 256;
+      }
+      push(fact) {
+        let buf = this.buffers.get(fact.taskId);
+        if (!buf) {
+          buf = [];
+          this.buffers.set(fact.taskId, buf);
+        }
+        buf.push(fact);
+        while (buf.length > this.capacity)
+          buf.shift();
+      }
+      /** Oldest-first snapshot. A fresh array; later pushes never grow it. */
+      recent(taskId) {
+        return [...this.buffers.get(taskId) ?? []];
+      }
+      /** Newline-delimited JSON, one fact per line, oldest first. */
+      serialize(taskId) {
+        return this.recent(taskId).map((f) => JSON.stringify(f)).join("\n") + "\n";
+      }
+      /** Release a finished crew's buffer. */
+      drop(taskId) {
+        this.buffers.delete(taskId);
+      }
+    };
+  }
+});
+
+// packages/core/dist/events/invariant.js
+function freshTrace() {
+  return {
+    depth: 0,
+    oldestOpenAt: null,
+    stallReported: false,
+    unknownSeen: 0,
+    liveness: /* @__PURE__ */ new Map()
+  };
+}
+function checkFact(trace, fact, opts) {
+  const out = [];
+  if (fact.origin === "inferred" && TERMINALISING.has(fact.kind)) {
+    out.push(v("I4", `inferred fact "${fact.kind}" from ${fact.source} cannot terminalise alone`, fact));
+  }
+  switch (fact.kind) {
+    case "tool.opened":
+      if (trace.depth === 0) {
+        trace.oldestOpenAt = fact.at;
+        trace.stallReported = false;
+      }
+      trace.depth += 1;
+      break;
+    case "tool.closed":
+      if (trace.depth === 0) {
+        out.push(v("I1", `tool.closed from ${fact.source} with no open tool`, fact));
+      } else {
+        trace.depth -= 1;
+        if (trace.depth === 0) {
+          trace.oldestOpenAt = null;
+          trace.stallReported = false;
+        }
+      }
+      break;
+    case "turn.ended":
+      if (trace.depth > 0) {
+        out.push(v("I2", `turn.ended with ${trace.depth} tool call(s) still open`, fact));
+        trace.depth = 0;
+        trace.oldestOpenAt = null;
+        trace.stallReported = false;
+      }
+      break;
+    case "unknown":
+      trace.unknownSeen += 1;
+      out.push(v("I5", `unrecognised frame "${fact.name}" from ${fact.source}`, fact));
+      break;
+    case "process.observed": {
+      const prior = [...trace.liveness.entries()].find(([src, s]) => src !== fact.source && s.alive !== fact.alive && fact.at - s.at <= (opts.disagreeWindowMs ?? -1));
+      if (prior) {
+        out.push(v("I6", `liveness disagreement: ${prior[0]} said alive=${prior[1].alive}, ${fact.source} says alive=${fact.alive}`, fact));
+      }
+      trace.liveness.set(fact.source, { alive: fact.alive, at: fact.at });
+      break;
+    }
+    default:
+      break;
+  }
+  if (opts.stallBudgetMs !== void 0 && trace.depth > 0 && trace.oldestOpenAt !== null && !trace.stallReported && fact.at - trace.oldestOpenAt > opts.stallBudgetMs) {
+    trace.stallReported = true;
+    out.push(v("I3", `tool open for ${fact.at - trace.oldestOpenAt}ms, past the stall budget`, fact));
+  }
+  return out;
+}
+var v, TERMINALISING;
+var init_invariant = __esm({
+  "packages/core/dist/events/invariant.js"() {
+    v = (code, message, f) => ({ code, message, taskId: f.taskId, at: f.at });
+    TERMINALISING = /* @__PURE__ */ new Set(["session.ended"]);
+  }
+});
+
+// packages/core/dist/events/to-control-event.js
+function toControlEvent(fact) {
+  if (fact.origin === "inferred" && TERMINALISING2.has(fact.kind))
+    return [];
+  switch (fact.kind) {
+    case "turn.ended":
+      return [{ type: "task.turn.completed", id: fact.taskId, turnId: fact.turnId ?? fact.source }];
+    case "permission.requested":
+      return [{
+        type: "task.approval.requested",
+        id: fact.taskId,
+        requestId: fact.requestId,
+        question: fact.question,
+        kind: fact.tool
+      }];
+    case "input.requested":
+      return [{
+        type: "task.input.requested",
+        id: fact.taskId,
+        requestId: fact.requestId,
+        question: fact.question
+      }];
+    case "session.ended":
+      return [{ type: "task.session.ended", id: fact.taskId }];
+    case "session.started":
+      return [{
+        type: "task.started",
+        id: fact.taskId,
+        ...fact.pid === void 0 ? {} : { pid: fact.pid },
+        ...fact.sessionId === void 0 ? {} : { sessionId: fact.sessionId }
+      }];
+    case "prompt.submitted":
+      return [{ type: "task.first-turn.confirmed", id: fact.taskId }];
+    // Liveness-only. The facade still feeds these to reduceLifecycle; they
+    // simply carry no ControlEvent of their own.
+    case "tool.opened":
+    case "tool.closed":
+    case "activity":
+    case "process.observed":
+    case "unknown":
+      return [];
+  }
+}
+var TERMINALISING2;
+var init_to_control_event = __esm({
+  "packages/core/dist/events/to-control-event.js"() {
+    TERMINALISING2 = /* @__PURE__ */ new Set(["session.ended"]);
+  }
+});
+
+// packages/core/dist/events/conformance.js
+function assert(cond, msg) {
+  if (!cond)
+    throw new Error(`conformance: ${msg}`);
+}
+function runAdapterConformance(adapter, samples) {
+  const call = (raw) => adapter.translate(raw);
+  return [
+    {
+      name: `${adapter.name}: never throws on garbage`,
+      run: () => {
+        for (const g of GARBAGE) {
+          try {
+            call(g);
+          } catch (e) {
+            throw new Error(`threw on ${JSON.stringify(g)}: ${String(e)}`);
+          }
+        }
+      }
+    },
+    {
+      name: `${adapter.name}: never returns null or undefined`,
+      run: () => {
+        for (const g of [...GARBAGE, ...samples]) {
+          const out = call(g);
+          assert(Array.isArray(out), `returned a non-array for ${JSON.stringify(g)}`);
+        }
+      }
+    },
+    {
+      name: `${adapter.name}: an unrecognised frame yields unknown, not an empty array`,
+      run: () => {
+        const out = call({ type: "definitely-not-a-real-event-name" });
+        assert(out.length > 0, "silently dropped an unrecognised frame (the #542 shape)");
+        assert(out.every((f) => f.kind === "unknown"), "an unrecognised frame must translate to kind 'unknown'");
+      }
+    },
+    {
+      name: `${adapter.name}: recognises its own samples`,
+      run: () => {
+        for (const s of samples) {
+          const out = call(s);
+          assert(out.length > 0, `produced nothing for its own sample ${JSON.stringify(s)}`);
+          assert(out.some((f) => f.kind !== "unknown"), `failed to recognise its own sample ${JSON.stringify(s)}`);
+        }
+      }
+    },
+    {
+      name: `${adapter.name}: declares a constant origin`,
+      run: () => {
+        assert(adapter.origin === "agent" || adapter.origin === "scan" || adapter.origin === "inferred", `invalid origin "${String(adapter.origin)}"`);
+      }
+    }
+  ];
+}
+var GARBAGE;
+var init_conformance = __esm({
+  "packages/core/dist/events/conformance.js"() {
+    GARBAGE = [
+      null,
+      void 0,
+      0,
+      "",
+      "not json",
+      [],
+      {},
+      { type: 42 },
+      { type: "definitely-not-a-real-event-name" }
+    ];
+  }
+});
+
+// packages/core/dist/events/source.js
+function createEventsSource(opts) {
+  const now = opts.now ?? (() => Date.now());
+  const log = new FactLog({ capacity: opts.capacity });
+  const adapters = new Map(opts.adapters.map((a) => [a.name, a]));
+  const traces = /* @__PURE__ */ new Map();
+  const seqs = /* @__PURE__ */ new Map();
+  let deps;
+  const traceFor = (taskId) => {
+    let t = traces.get(taskId);
+    if (!t) {
+      t = freshTrace();
+      traces.set(taskId, t);
+    }
+    return t;
+  };
+  const nextSeq = (taskId) => {
+    const n = seqs.get(taskId) ?? 0;
+    seqs.set(taskId, n + 1);
+    return n;
+  };
+  return {
+    name: "events",
+    start(d) {
+      deps = d;
+    },
+    stop() {
+      deps = void 0;
+    },
+    health() {
+      return { active: deps !== void 0, error: null };
+    },
+    recent(taskId) {
+      return log.recent(taskId);
+    },
+    dump(taskId) {
+      return log.serialize(taskId);
+    },
+    ingest(source, raw, hint) {
+      const adapter = adapters.get(source);
+      if (!adapter || !deps)
+        return;
+      const rec = deps.resolve(hint);
+      if (!rec)
+        return;
+      const taskId = rec.id;
+      const at = now();
+      let produced;
+      try {
+        const out = adapter.translate(raw);
+        produced = Array.isArray(out) ? out : [{ kind: "unknown", name: `${source} returned non-array` }];
+      } catch (e) {
+        opts.log?.(`events: adapter ${source} threw: ${String(e)}`);
+        produced = [{ kind: "unknown", name: `${source} threw` }];
+      }
+      for (const rawFact of produced) {
+        const fact = stampFact(rawFact, {
+          seq: nextSeq(taskId),
+          taskId,
+          at,
+          source,
+          origin: adapter.origin
+        });
+        log.push(fact);
+        for (const v2 of checkFact(traceFor(taskId), fact, opts.check ?? {})) {
+          opts.onViolation(v2);
+        }
+        for (const ev of toControlEvent(fact))
+          opts.emit(ev);
+      }
+    }
+  };
+}
+var init_source = __esm({
+  "packages/core/dist/events/source.js"() {
+    init_fact();
+    init_log();
+    init_invariant();
+    init_to_control_event();
+  }
+});
+
 // packages/core/dist/index.js
 var dist_exports2 = {};
 __export(dist_exports2, {
@@ -7122,6 +7494,7 @@ __export(dist_exports2, {
   DEFAULT_TASK_TIMEOUT_MS: () => DEFAULT_TASK_TIMEOUT_MS,
   DeferDelivery: () => DeferDelivery,
   FIRST_TURN_INLINE_MAX_BYTES: () => FIRST_TURN_INLINE_MAX_BYTES,
+  FactLog: () => FactLog,
   GROUP_DISPATCH_WARMUP_POLL_MS: () => GROUP_DISPATCH_WARMUP_POLL_MS,
   GROUP_DISPATCH_WARMUP_TIMEOUT_MS: () => GROUP_DISPATCH_WARMUP_TIMEOUT_MS,
   IDLE_DEBOUNCE_MS: () => IDLE_DEBOUNCE_MS,
@@ -7151,6 +7524,7 @@ __export(dist_exports2, {
   capAllowed: () => capAllowed,
   capOutput: () => capOutput,
   captainSocketPath: () => captainSocketPath,
+  checkFact: () => checkFact,
   classifyHealth: () => classifyHealth,
   closeWorkItem: () => closeWorkItem,
   computeTemplateHash: () => computeTemplateHash,
@@ -7163,6 +7537,7 @@ __export(dist_exports2, {
   createDirectCrewPaneReader: () => createDirectCrewPaneReader,
   createDirectSurfaceLivenessProbe: () => createDirectSurfaceLivenessProbe,
   createEnsureCaptainAlive: () => createEnsureCaptainAlive,
+  createEventsSource: () => createEventsSource,
   createInteractiveProbe: () => createInteractiveProbe,
   createIsCaptainAlive: () => createIsCaptainAlive,
   createLaunch: () => createLaunch,
@@ -7194,6 +7569,7 @@ __export(dist_exports2, {
   encodeFrame: () => encodeFrame,
   encodeMsg: () => encodeMsg,
   ensureDaemon: () => ensureDaemon,
+  ensureSocksDir: () => ensureSocksDir,
   evaluateStall: () => evaluateStall,
   exitMarkerPath: () => exitMarkerPath,
   fallsBackToPane: () => fallsBackToPane,
@@ -7205,6 +7581,7 @@ __export(dist_exports2, {
   formatInbound: () => formatInbound,
   formatInboundReceipt: () => formatInboundReceipt,
   formatLifecycle: () => formatLifecycle,
+  freshTrace: () => freshTrace,
   getDaemonPid: () => getDaemonPid,
   healCmdFor: () => healCmdFor,
   isAuthorized: () => isAuthorized,
@@ -7261,6 +7638,7 @@ __export(dist_exports2, {
   resolveSetupUserId: () => resolveSetupUserId,
   restartDaemonIfRunning: () => restartDaemonIfRunning,
   rotateIfNeeded: () => rotateIfNeeded,
+  runAdapterConformance: () => runAdapterConformance,
   runCrewAnswer: () => runCrewAnswer,
   runCrewClose: () => runCrewClose,
   runCrewList: () => runCrewList,
@@ -7295,12 +7673,14 @@ __export(dist_exports2, {
   sideNameFromTitle: () => sideNameFromTitle,
   sideNextAutoName: () => sideNextAutoName,
   sideTitleFor: () => sideTitleFor,
+  stampFact: () => stampFact,
   startDaemon: () => startDaemon,
   startServer: () => startServer,
   stripBotMention: () => stripBotMention,
   surfaceVerdict: () => surfaceVerdict,
   timeoutGate: () => timeoutGate,
   titleFor: () => titleFor,
+  toControlEvent: () => toControlEvent,
   topicKey: () => topicKey,
   topicName: () => topicName,
   tryAcquireDaemonLock: () => tryAcquireDaemonLock,
@@ -7347,6 +7727,12 @@ var init_dist2 = __esm({
     init_crew_spawn();
     init_crew_answer();
     init_lifecycle_source();
+    init_fact();
+    init_log();
+    init_invariant();
+    init_to_control_event();
+    init_conformance();
+    init_source();
     init_control_channel();
     init_captain_channel();
   }
@@ -10308,9 +10694,9 @@ ${directive}` : directive;
 function withTimeout(p, ms, msg) {
   return new Promise((resolve4, reject) => {
     const t = setTimeout(() => reject(new Error(msg)), ms);
-    p.then((v) => {
+    p.then((v2) => {
       clearTimeout(t);
-      resolve4(v);
+      resolve4(v2);
     }, (e) => {
       clearTimeout(t);
       reject(e);
@@ -10544,9 +10930,10 @@ var init_driver = __esm({
 });
 
 // packages/agents/dist/opencode/sse-bridge.js
-var OpencodeSseBridge;
+var IGNORED_FRAME, OpencodeSseBridge;
 var init_sse_bridge = __esm({
   "packages/agents/dist/opencode/sse-bridge.js"() {
+    IGNORED_FRAME = /^(message|storage|file|lsp|installation)\./;
     OpencodeSseBridge = class {
       controllers = /* @__PURE__ */ new Map();
       /** taskId → the crew's opencode server port (for permission-reply POSTs). */
@@ -10683,6 +11070,10 @@ var init_sse_bridge = __esm({
           return;
         }
         if (json?.type === "session.idle") {
+          if (this.deps.ingest) {
+            this.deps.ingest(json, taskId);
+            return;
+          }
           this.deps.emit({
             type: "task.turn.completed",
             id: taskId,
@@ -10692,6 +11083,10 @@ var init_sse_bridge = __esm({
           const p = json.properties;
           if (p?.id && p?.sessionID) {
             this.pendingPermByTask.set(taskId, { permID: p.id, sessionID: p.sessionID });
+            if (this.deps.ingest) {
+              this.deps.ingest(json, taskId);
+              return;
+            }
             const tool = p.permission ?? "a tool";
             const cmd = Array.isArray(p.patterns) && p.patterns.length ? `: ${p.patterns.join(" ")}` : "";
             this.deps.emit({
@@ -10701,11 +11096,24 @@ var init_sse_bridge = __esm({
               question: `opencode requests permission to run ${tool}${cmd}`,
               kind: tool
             });
+          } else if (this.deps.ingest) {
+            this.deps.ingest(json, taskId);
           }
         } else if (json?.type === "permission.replied") {
           this.pendingPermByTask.delete(taskId);
+          this.deps.ingest?.(json, taskId);
+        } else if (!IGNORED_FRAME.test(json?.type ?? "")) {
+          this.deps.ingest?.(json, taskId);
         }
       }
+      /** Test seam: exercise handleLine without an SSE stream. */
+      handleLineForTest(rawLine, taskId) {
+        this.handleLine(taskId, rawLine);
+      }
+      /** Test seam: read pendingPermByTask without exposing it publicly. */
+      pendingPermForTest(taskId) {
+        return this.pendingPermByTask.get(taskId);
+      }
     };
   }
 });
@@ -11705,77 +12113,6 @@ var init_receipt_listener = __esm({
   }
 });
 
-// packages/agents/dist/opencode/control-source.js
-function toSnapshot2(ev) {
-  const now = Date.now();
-  switch (ev.type) {
-    // A permission was answered on the bus and the turn resumed.
-    case "task.started":
-      return { taskId: ev.id, state: "running", alive: true, origin: "agent", at: now };
-    // session.idle — the turn finished. Liveness, NOT completion (anti-#2576).
-    case "task.turn.completed":
-      return { taskId: ev.id, state: "idle", alive: true, origin: "agent", at: now };
-    // permission.asked — opencode STATES it is gated. No guessing from pixels.
-    case "task.approval.requested":
-      return {
-        taskId: ev.id,
-        state: "needsInput",
-        alive: true,
-        origin: "agent",
-        at: now,
-        detail: { note: ev.question, reason: ev.kind }
-      };
-    // Terminal (task.done/blocked/cancelled) and notify-only events are ignored:
-    // terminal state comes exclusively from `squadrant crew signal`.
-    default:
-      return null;
-  }
-}
-var OpencodeControlSource;
-var init_control_source = __esm({
-  "packages/agents/dist/opencode/control-source.js"() {
-    OpencodeControlSource = class {
-      name = "opencode-control";
-      deps;
-      active = false;
-      cache = /* @__PURE__ */ new Map();
-      start(deps) {
-        this.deps = deps;
-        this.active = true;
-      }
-      stop() {
-        this.deps = void 0;
-        this.active = false;
-        this.cache.clear();
-      }
-      /** Push-only source — no fallible startup of its own. */
-      health() {
-        return { active: this.active, error: null };
-      }
-      /** Liveness floor: origin must be "scan" and must not assert needsInput. */
-      snapshot(taskId) {
-        const s = this.cache.get(taskId);
-        if (!s)
-          return void 0;
-        return { ...s, origin: "scan", state: s.state === "needsInput" ? "running" : s.state };
-      }
-      /**
-       * Feed one ControlEvent from OpencodeSseBridge into the port.
-       * Wired in squadrantd.ts as: emit = (ev) => { source.observe(ev); …existing… }
-       */
-      observe(ev) {
-        if (!this.deps)
-          return;
-        const snap = toSnapshot2(ev);
-        if (!snap)
-          return;
-        this.cache.set(snap.taskId, snap);
-        this.deps.report(snap);
-      }
-    };
-  }
-});
-
 // packages/agents/dist/opencode/http-channel.js
 var OpencodeHttpChannel;
 var init_http_channel = __esm({
@@ -11887,6 +12224,47 @@ var init_http_channel = __esm({
   }
 });
 
+// packages/agents/dist/opencode/fact-adapter.js
+function createOpencodeFactAdapter(deps) {
+  return {
+    name: "opencode-sse",
+    origin: "agent",
+    translate(raw) {
+      const f = typeof raw === "object" && raw !== null ? raw : {};
+      const type = typeof f.type === "string" ? f.type : void 0;
+      if (type === void 0)
+        return [{ kind: "unknown", name: "non-object" }];
+      const p = f.properties ?? {};
+      if (type === "session.idle") {
+        return [{
+          kind: "turn.ended",
+          turnId: typeof p.sessionID === "string" ? p.sessionID : void 0
+        }];
+      }
+      if (type === "permission.asked") {
+        if (typeof p.id !== "string" || typeof p.sessionID !== "string") {
+          return [{ kind: "unknown", name: "permission.asked:incomplete" }];
+        }
+        const tool = typeof p.permission === "string" ? p.permission : "a tool";
+        const cmd = Array.isArray(p.patterns) && p.patterns.length ? `: ${p.patterns.join(" ")}` : "";
+        return [{
+          kind: "permission.requested",
+          question: `opencode requests permission to run ${tool}${cmd}`,
+          requestId: deps.nextRequestId(),
+          tool
+        }];
+      }
+      if (type === "permission.replied")
+        return [{ kind: "activity" }];
+      return [{ kind: "unknown", name: type }];
+    }
+  };
+}
+var init_fact_adapter = __esm({
+  "packages/agents/dist/opencode/fact-adapter.js"() {
+  }
+});
+
 // packages/agents/dist/index.js
 var dist_exports4 = {};
 __export(dist_exports4, {
@@ -11901,7 +12279,6 @@ __export(dist_exports4, {
   HEADLESS_ERROR_TAIL: () => HEADLESS_ERROR_TAIL,
   MARKER_END: () => MARKER_END,
   MARKER_START: () => MARKER_START,
-  OpencodeControlSource: () => OpencodeControlSource,
   OpencodeHttpChannel: () => OpencodeHttpChannel,
   OpencodeSseBridge: () => OpencodeSseBridge,
   ProjectionRegistry: () => ProjectionRegistry,
@@ -11921,6 +12298,7 @@ __export(dist_exports4, {
   createGeminiEmitter: () => createGeminiEmitter,
   createOpencodeDriver: () => createOpencodeDriver,
   createOpencodeEmitter: () => createOpencodeEmitter,
+  createOpencodeFactAdapter: () => createOpencodeFactAdapter,
   decideCaptainMemoryWrite: () => decideCaptainMemoryWrite,
   deriveTranscriptPath: () => deriveTranscriptPath,
   detectTrailingQuestion: () => detectTrailingQuestion2,
@@ -11963,8 +12341,8 @@ var init_dist4 = __esm({
     init_receipt_listener();
     init_peer_wire();
     init_registry8();
-    init_control_source();
     init_http_channel();
+    init_fact_adapter();
   }
 });
 
@@ -13963,6 +14341,10 @@ async function runCrewSpawn2(input) {
     emitEvent: async (p, event) => {
       await squadrantdCall({ kind: "event", project: p, event });
     },
+    // #745: check the daemon's hook-confirmed state before reporting a false
+    // "first turn not delivered" — swallow errors (offline/unreachable daemon)
+    // so this optional check never itself breaks the spawn.
+    getTaskRecord: async (p, id) => await squadrantdCall(buildStatusRequest(p, id)).catch(() => void 0),
     onRouted: (route) => console.log(
       chalk10.dim(
         `routed: tier=${route.tier} \u2192 ${route.agent}${route.model ? `/${route.model}` : ""} (rule: "${route.matchedRule}")`
@@ -14941,12 +15323,12 @@ function donut(t) {
   const C = 2 * Math.PI * r;
   let acc = 0;
   const segs = DONUT_ORDER.map((k) => {
-    const v = t[k];
-    if (v <= 0)
+    const v2 = t[k];
+    if (v2 <= 0)
       return "";
-    const len = t.total ? v / t.total * C : 0;
+    const len = t.total ? v2 / t.total * C : 0;
     const rot = t.total ? acc / t.total * 360 : 0;
-    acc += v;
+    acc += v2;
     return `<circle class="seg s-${k}" cx="${cx}" cy="${cy}" r="${r}" fill="none" stroke-width="${w}" stroke-dasharray="${len.toFixed(2)} ${(C - len).toFixed(2)}" transform="rotate(${(rot - 90).toFixed(2)} ${cx} ${cy})"></circle>`;
   }).join("");
   const track = `<circle class="donut-track" cx="${cx}" cy="${cy}" r="${r}" fill="none" stroke-width="${w}"></circle>`;
@@ -15250,7 +15632,7 @@ function renderLiveGrid(snap, now) {
     const headerLabels = STATE_ORDER.map((s) => `${STATE_LABEL[s]}`);
     out.push(`<div class="live-header" data-live-header="">`);
     out.push(headerLabels.map((l) => {
-      const raw = Object.entries(STATE_LABEL).find(([, v]) => v === l)[0];
+      const raw = Object.entries(STATE_LABEL).find(([, v2]) => v2 === l)[0];
       const c = stateCounts[raw];
       const cls = c === 0 ? "zero" : "";
       return `<span class="live-stat ${cls}"><span class="pdot ${STATE_CLS[raw]}"></span>${c} ${l}</span>`;
@@ -15802,7 +16184,7 @@ async function runDashboardWeb(input) {
   console.log(chalk14.green(`\u2714 Squadrant system dashboard \u2192 http://127.0.0.1:${handle.port}`));
   console.log(chalk14.dim(`  polling the daemon every ${input.interval}s \xB7 localhost only \xB7 read-only \xB7 Ctrl-C to stop`));
 }
-var dashboardCommand = new Command13("dashboard").description("Live status grid of all projects (derived from daemon task state)").option("--once", "Print one snapshot and exit (used by --pane's refresh loop)").option("--pane", "Open a refreshing sidebar pane in the current cmux workspace").option("--web", "Serve the live system-health web dashboard on 127.0.0.1 (HTTP + SSE)").option("--port <port>", "Port for --web (default 7878)", (v) => parseInt(v, 10), 7878).option("--direction <dir>", "Pane split direction (right|left|up|down)", "right").option("--interval <seconds>", "Daemon poll interval for --web (default 5); refresh interval for --pane (default 10)", (v) => parseInt(v, 10)).action(async (opts) => {
+var dashboardCommand = new Command13("dashboard").description("Live status grid of all projects (derived from daemon task state)").option("--once", "Print one snapshot and exit (used by --pane's refresh loop)").option("--pane", "Open a refreshing sidebar pane in the current cmux workspace").option("--web", "Serve the live system-health web dashboard on 127.0.0.1 (HTTP + SSE)").option("--port <port>", "Port for --web (default 7878)", (v2) => parseInt(v2, 10), 7878).option("--direction <dir>", "Pane split direction (right|left|up|down)", "right").option("--interval <seconds>", "Daemon poll interval for --web (default 5); refresh interval for --pane (default 10)", (v2) => parseInt(v2, 10)).action(async (opts) => {
   try {
     if (opts.web) {
       await runDashboardWeb({ port: opts.port, interval: opts.interval ?? 5 });
@@ -16022,7 +16404,7 @@ var launchCommand = new Command14("launch").description(
         agentCmdFactory: (forceFresh) => {
           const captainChannelEnabled = shouldWireCaptainChannel(agentName, config);
           if (captainChannelEnabled) {
-            fs21.mkdirSync(CC_SOCKS_DIR, { recursive: true });
+            ensureSocksDir();
           }
           return buildAgentCmd(
             agentName,
@@ -16733,11 +17115,11 @@ import chalk22 from "chalk";
 import fs23 from "fs";
 import path28 from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
-function parseScope(v) {
-  if (v !== "user" && v !== "project") {
+function parseScope(v2) {
+  if (v2 !== "user" && v2 !== "project") {
     throw new Error("--scope must be 'user' or 'project'");
   }
-  return v;
+  return v2;
 }
 function findPackageRoot3() {
   let dir = path28.dirname(fileURLToPath4(import.meta.url));
@@ -17185,8 +17567,10 @@ async function runHealDaemon(opts) {
   const { stdout, stderr } = opts;
   stdout.write("restarting squadrantd via launchd kickstart...\n");
   try {
-    opts.ensureDaemon();
-    stdout.write(chalk24.green("\u2714 daemon kickstart complete\n"));
+    const result = opts.ensureDaemon();
+    const noteSuffix = result?.note ? ` (${result.note})` : "";
+    stdout.write(chalk24.green(`\u2714 daemon kickstart complete${noteSuffix}
+`));
     return 0;
   } catch (e) {
     stderr.write(`heal daemon failed: ${e.message}
@@ -17389,12 +17773,12 @@ async function dispatchAction(toProject, task, opts) {
     process.exit(1);
   }
 }
-var dispatchCommand = new Command25("dispatch").description("Dispatch a task to any registered project (tracked, reports back on settle)").argument("<project>", "Target project name").argument("<task>", "Task description to dispatch").option("--provider <p>", "claude|opencode|codex", "claude").option("--mode <m>", "headless|interactive", "headless").option("--warmup-timeout <s>", "seconds to wait for target captain to boot (same-group only; default: 120)", (v) => parseInt(v, 10) * 1e3).action(dispatchAction);
+var dispatchCommand = new Command25("dispatch").description("Dispatch a task to any registered project (tracked, reports back on settle)").argument("<project>", "Target project name").argument("<task>", "Task description to dispatch").option("--provider <p>", "claude|opencode|codex", "claude").option("--mode <m>", "headless|interactive", "headless").option("--warmup-timeout <s>", "seconds to wait for target captain to boot (same-group only; default: 120)", (v2) => parseInt(v2, 10) * 1e3).action(dispatchAction);
 
 // packages/cli/src/commands/group.ts
 init_dist2();
 var groupCommand = new Command26("group").description("Cross-project intra-group operations (Phase 1: dispatch)").addCommand(
-  new Command26("dispatch").description("[DEPRECATED \u2014 use 'squadrant dispatch'] Dispatch a task to a sibling project in the same group").argument("<to-project>", "Target project name").argument("<task>", "Task description to dispatch").option("--provider <p>", "claude|opencode|codex", "claude").option("--mode <m>", "headless|interactive", "headless").option("--warmup-timeout <s>", "seconds to wait for target captain to boot (default: 120)", (v) => parseInt(v, 10) * 1e3).action(async (toProject, task, opts) => {
+  new Command26("dispatch").description("[DEPRECATED \u2014 use 'squadrant dispatch'] Dispatch a task to a sibling project in the same group").argument("<to-project>", "Target project name").argument("<task>", "Task description to dispatch").option("--provider <p>", "claude|opencode|codex", "claude").option("--mode <m>", "headless|interactive", "headless").option("--warmup-timeout <s>", "seconds to wait for target captain to boot (default: 120)", (v2) => parseInt(v2, 10) * 1e3).action(async (toProject, task, opts) => {
     console.error(chalk26.yellow(
       `\u26A0 'squadrant group dispatch' is deprecated \u2014 use 'squadrant dispatch <project> "<task>"' instead.`
     ));
@@ -17448,6 +17832,7 @@ function registerSenderIdentity(socketPath2) {
 }
 async function sharedReceiptListener() {
   if (shared) return shared;
+  ensureSocksDir();
   const socketPath2 = `${CC_SOCKS_DIR}/squadrantd-${process.pid}.sock`;
   const listener = new ClaudeReceiptListener({
     socketPath: socketPath2,
@@ -18070,7 +18455,7 @@ telegramCommand.command("link").argument("<project>", "project to bind to a Tele
   const { topicId, created } = await runTelegramLink({ project, cfg, client, stateRoot: defaultStateRoot() });
   console.log(chalk32.green(`${created ? "linked" : "already linked"}: ${project} \u2192 topic ${topicId}`));
 });
-telegramCommand.command("setup").description("Interactive wizard \u2014 bot token, validate, auto-detect supergroup, write config").option("--reset-token", "force re-entry of the bot token even if one already exists").option("--redetect", "force group re-detection even when a supergroup is already configured").option("--user-id <id>", "allowlist user-id \u2014 enables remote control on a re-run without getUpdates detection", (v) => parseInt(v, 10)).action(async (opts) => {
+telegramCommand.command("setup").description("Interactive wizard \u2014 bot token, validate, auto-detect supergroup, write config").option("--reset-token", "force re-entry of the bot token even if one already exists").option("--redetect", "force group re-detection even when a supergroup is already configured").option("--user-id <id>", "allowlist user-id \u2014 enables remote control on a re-run without getUpdates detection", (v2) => parseInt(v2, 10)).action(async (opts) => {
   if (!process.stdin.isTTY) {
     console.error(chalk32.red("setup requires a TTY \u2014 pipe input is not supported"));
     process.exit(1);
@@ -18580,7 +18965,7 @@ function printTree(items) {
 function printFlat(items) {
   for (const item of items) printItem(item, 0);
 }
-var startCmd = new Command33("start").description("Start a new work item").argument("<title>", "what you're doing").option("--project <name>", "project this work belongs to (defaults to the current registered project)").option("--parent <id>", "id of the wave/parent item this nests under").option("--tag <tag>", "attach a tag (repeatable)", (v, prev) => [...prev, v], []).action((title, opts) => {
+var startCmd = new Command33("start").description("Start a new work item").argument("<title>", "what you're doing").option("--project <name>", "project this work belongs to (defaults to the current registered project)").option("--parent <id>", "id of the wave/parent item this nests under").option("--tag <tag>", "attach a tag (repeatable)", (v2, prev) => [...prev, v2], []).action((title, opts) => {
   const config = loadConfig();
   const store = createWorkStore();
   purgeExpiredWorkItems(store);
@@ -18902,7 +19287,7 @@ function queryClaudeMem(dbPath, project) {
       createdAt: r.created_at
     }));
     const candidates = [summaryRow?.created_at, ...decisionRows.map((r) => r.created_at)].filter(
-      (v) => !!v
+      (v2) => !!v2
     );
     const oldestCreatedAt = candidates.length > 0 ? candidates.reduce((a, b) => a < b ? a : b) : null;
     return {