squadrant 0.14.1 → 0.14.3

package/dist/index.js

@@ -1601,11 +1601,11 @@ var init_session_freshness = __esm({
 });
 
 // packages/core/dist/crew-protocol.js
-function isTurnAccepted(preSendScreen, afterScreen, config) {
-  if (config?.splashMarker) {
-    return !afterScreen.includes(config.splashMarker);
-  }
-  return afterScreen !== preSendScreen;
+function normalizeForSplashMatch(text) {
+  return text.toLowerCase().replace(/…/g, "...").replace(/\s+/g, " ").trim();
+}
+function screenHasSplashMarker(screen, marker) {
+  return normalizeForSplashMatch(screen).includes(normalizeForSplashMatch(marker));
 }
 function buildCompletionProtocol(taskId, project) {
   return [
@@ -2186,15 +2186,16 @@ async function dispatchToSibling(opts) {
   if (!toCfg) {
     throw new Error(`target project '${opts.toProject}' not found in config`);
   }
-  if (!fromCfg.group || !toCfg.group || fromCfg.group !== toCfg.group) {
-    throw new Error(`cannot dispatch: '${opts.toProject}' (group: ${toCfg.group ?? "none"}) is not in the same group as '${opts.fromProject}' (group: ${fromCfg.group ?? "none"})`);
-  }
+  const sameGroup = !!fromCfg?.group && !!toCfg.group && fromCfg.group === toCfg.group;
   if (toCfg.acceptDelegations === false) {
     throw new Error(`cannot dispatch to '${opts.toProject}': project has acceptDelegations set to false`);
   }
   const sockPath = opts.sockPath ?? DEFAULT_SOCK_PATH2;
   const alive = await isCaptainAlive(opts.toProject, sockPath);
   if (!alive) {
+    if (!sameGroup) {
+      throw new Error(`cannot dispatch to '${opts.toProject}': captain is not running and cross-group dispatch does not auto-boot it. Use 'squadrant ping ${opts.toProject} "<msg>"' or start it manually with 'squadrant launch ${opts.toProject}', then retry.`);
+    }
     if (opts.bootCaptain) {
       await opts.bootCaptain(opts.toProject);
     }
@@ -2643,10 +2644,16 @@ ${buildCompletionProtocol(rec.id, input.project)}`, preLaunchScreen);
     const opencodeResult = await deps.sendFirstTurn(pane2, `${firstTurnTask}
 
 ${buildCompletionProtocol(rec.id, input.project)}`, preLaunchScreen, {
-      // #235: confirm-on-delivery — sendFirstTurnWhenReady polls until "Ask
-      // anything…" leaves the screen, re-sending every ~3s to cover slow boots
+      // #235: confirm-on-delivery — sendFirstTurnWhenReady polls until the idle
+      // splash leaves the screen, re-sending every ~3s to cover slow boots
       // without duplicating the task. See crew-pane.ts SPLASH_MAX_CHECKS/EVERY_N.
-      splashMarker: "Ask anything\u2026"
+      // #499: match a stable substring ("ask anything", case/whitespace/ellipsis
+      // -insensitive via screenHasSplashMarker) rather than the exact wording —
+      // opencode's real placeholder rotates through example prompts and uses
+      // three ASCII dots ("Ask anything...") or a longer command hint ("Ask
+      // anything, / for commands, @ for context..."), never the literal
+      // "Ask anything…" (U+2026) this used to hardcode, which never matched.
+      splashMarker: "Ask anything"
     });
     if (!opencodeResult.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.
@@ -4146,6 +4153,21 @@ async function confirmedSendToPane(runtime, pane, message) {
   }
   return { delivered: false };
 }
+async function resendCrewFirstTurn(runtime, captainName, project, name, message) {
+  const captain = await runtime.status(captainName);
+  if (!captain)
+    return { delivered: false };
+  const surfaces = await runtime.listSurfaces(captain.id);
+  const want = titleFor(project, name);
+  const pane = surfaces.find((s) => s.title === want);
+  if (!pane)
+    return { delivered: false };
+  const screen = await runtime.readPaneScreen(pane) ?? "";
+  if (!hasCCInputBox(screen) || classifyStartupSurface(screen) !== "idle") {
+    return { delivered: false };
+  }
+  return confirmedSendToPane(runtime, pane, message);
+}
 async function sendFirstTurnWhenReady(runtime, pane, task, preLaunchScreen, acceptanceConfig) {
   await new Promise((r) => setTimeout(r, SEND_FIRST_TURN_FLOOR_MS));
   const maxPolls = Math.floor((SEND_FIRST_TURN_TIMEOUT_MS - SEND_FIRST_TURN_FLOOR_MS) / POLL_INTERVAL_MS);
@@ -4153,7 +4175,7 @@ async function sendFirstTurnWhenReady(runtime, pane, task, preLaunchScreen, acce
   let stable = false;
   for (let i = 0; i < maxPolls && !stable; i++) {
     const screen = await runtime.readPaneScreen(pane) ?? "";
-    const ready = acceptanceConfig?.splashMarker ? true : hasCCInputBox(screen) && classifyStartupSurface(screen) === "idle";
+    const ready = acceptanceConfig?.splashMarker ? screenHasSplashMarker(screen, acceptanceConfig.splashMarker) : hasCCInputBox(screen) && classifyStartupSurface(screen) === "idle";
     if (screen.length > 0 && screen === previousScreen && screen !== preLaunchScreen && ready) {
       stable = true;
     } else {
@@ -4163,11 +4185,14 @@ async function sendFirstTurnWhenReady(runtime, pane, task, preLaunchScreen, acce
   }
   const preSendScreen = await runtime.readPaneScreen(pane) ?? "";
   if (acceptanceConfig?.splashMarker) {
+    let sawSplash = screenHasSplashMarker(preSendScreen, acceptanceConfig.splashMarker);
     await runtime.sendToPane(pane, task);
     for (let check2 = 0; check2 < SPLASH_MAX_CHECKS; check2++) {
       await new Promise((r) => setTimeout(r, POST_SEND_CHECK_MS));
       const afterScreen = await runtime.readPaneScreen(pane) ?? "";
-      if (isTurnAccepted(preSendScreen, afterScreen, acceptanceConfig)) {
+      if (screenHasSplashMarker(afterScreen, acceptanceConfig.splashMarker)) {
+        sawSplash = true;
+      } else if (sawSplash) {
         return { delivered: true };
       }
       if ((check2 + 1) % SPLASH_RESEND_EVERY_N === 0 && check2 < SPLASH_MAX_CHECKS - 1) {
@@ -4251,6 +4276,7 @@ __export(dist_exports, {
   isInsideCmux: () => isInsideCmux,
   listProjectCrews: () => listProjectCrews,
   mapSubToLifecycle: () => mapSubToLifecycle,
+  resendCrewFirstTurn: () => resendCrewFirstTurn,
   resolveCaptainWorkspace: () => resolveCaptainWorkspace,
   sendFirstTurnWhenReady: () => sendFirstTurnWhenReady
 });
@@ -5713,7 +5739,7 @@ var init_sse_bridge = __esm({
         const fetchImpl = this.deps.fetchImpl ?? fetch;
         const sleep2 = this.deps.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
         const reconnectMs = this.deps.reconnectMs ?? 500;
-        const maxBoot = this.deps.maxBootAttempts ?? 60;
+        const maxBoot = this.deps.maxBootAttempts ?? 240;
         const url = `http://127.0.0.1:${port}/event`;
         let booted = false;
         let bootAttempts = 0;
@@ -6335,7 +6361,7 @@ var init_dist4 = __esm({
 // packages/cli/src/index.ts
 init_dist();
 init_dist2();
-import { Command as Command29 } from "commander";
+import { Command as Command31 } from "commander";
 import { readFileSync as readFileSync13, existsSync as existsSync12, writeFileSync as writeFileSync10 } from "fs";
 import { fileURLToPath as fileURLToPath6 } from "url";
 import { dirname as dirname7, join as join26 } from "path";
@@ -8571,7 +8597,11 @@ function collect(snap) {
     env.vaults.hub.state,
     ...env.vaults.spokes.map((s) => s.state),
     env.config.parseable.state,
-    env.config.sessions.state,
+    // Template-hash drift (env.config.sessions.state) is demoted to soft/info:
+    // projects registered but idle/never-launched legitimately sit on older
+    // template versions, so drift alone is not actionable trouble. Its own
+    // status still renders in the Environment tab; it just no longer rolls up
+    // into envT/overall/masterClass.
     ...env.config.projectPaths.map((p) => p.state)
   ];
   const daemonStates = [];
@@ -8591,7 +8621,8 @@ function collect(snap) {
         undelivered++;
     }
     for (const p of snap.daemon.tier2.projects) {
-      if (p.delivery.behind > 0)
+      const captain = snap.daemon.tier1.find((c) => c.kind === "captain" && c.project === p.project);
+      if (captain?.state === "alive" && p.delivery.behind > 0)
         projStates.push("stale");
       if (p.store.corruptCount > 0)
         projStates.push("gone");
@@ -10642,49 +10673,85 @@ var healCommand = new Command23("heal").description("Targeted, idempotent remedi
 );
 
 // packages/cli/src/commands/group.ts
+import { Command as Command25 } from "commander";
+import chalk25 from "chalk";
+
+// packages/cli/src/commands/dispatch.ts
 init_dist();
 init_dist2();
-init_dist2();
 import { Command as Command24 } from "commander";
 import { execSync as execSync13 } from "child_process";
 import chalk24 from "chalk";
-var groupCommand = new Command24("group").description("Cross-project intra-group operations (Phase 1: dispatch)").addCommand(
-  new Command24("dispatch").description("Dispatch a task to a sibling project in the same group").argument("<to-project>", "Target project name (must be in the same group)").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 relay to boot (default: 120)", (v) => parseInt(v, 10) * 1e3).action(async (toProject, task, opts) => {
-    const fromProject = resolveCurrentProject(loadConfig());
-    if (!fromProject) {
-      console.error(chalk24.red("Could not determine current project from cwd. Run from inside a registered project directory."));
-      process.exit(1);
-    }
-    try {
-      const result = await dispatchToSibling({
-        fromProject,
-        toProject,
-        task,
-        provider: opts.provider,
-        mode: opts.mode,
-        warmupTimeoutMs: opts.warmupTimeout,
-        bootCaptain: async (project) => {
-          try {
-            execSync13(`squadrant launch ${project}`, { stdio: "ignore", timeout: 15e3 });
-          } catch {
-            throw new Error(`failed to launch captain for '${project}' \u2014 is squadrant installed?`);
-          }
-        }
-      });
-      console.log(chalk24.green(`\u2714 Dispatched to '${toProject}' (task ${result.id.slice(0, 8)})`));
-      console.log(chalk24.dim(`  originProject: ${result.originProject ?? "none"}`));
-      console.log(chalk24.dim("  You will be notified when the task settles (done/blocked/failed)."));
-    } catch (e) {
-      console.error(chalk24.red(`\u2718 ${e.message}`));
-      process.exit(1);
+async function runDispatch(toProject, task, opts) {
+  const fromProject = resolveCurrentProject(loadConfig());
+  if (!fromProject) {
+    throw new Error("Could not determine current project from cwd. Run from inside a registered project directory.");
+  }
+  return dispatchToSibling({
+    fromProject,
+    toProject,
+    task,
+    provider: opts.provider,
+    mode: opts.mode,
+    warmupTimeoutMs: opts.warmupTimeout,
+    bootCaptain: async (project) => {
+      try {
+        execSync13(`squadrant launch ${project}`, { stdio: "ignore", timeout: 15e3 });
+      } catch {
+        throw new Error(`failed to launch captain for '${project}' \u2014 is squadrant installed?`);
+      }
     }
+  });
+}
+async function dispatchAction(toProject, task, opts) {
+  try {
+    const result = await runDispatch(toProject, task, opts);
+    console.log(chalk24.green(`\u2714 Dispatched to '${toProject}' (task ${result.id.slice(0, 8)})`));
+    console.log(chalk24.dim(`  originProject: ${result.originProject ?? "none"}`));
+    console.log(chalk24.dim("  You will be notified when the task settles (done/blocked/failed)."));
+  } catch (e) {
+    console.error(chalk24.red(`\u2718 ${e.message}`));
+    process.exit(1);
+  }
+}
+var dispatchCommand = new Command24("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);
+
+// packages/cli/src/commands/group.ts
+init_dist2();
+var groupCommand = new Command25("group").description("Cross-project intra-group operations (Phase 1: dispatch)").addCommand(
+  new Command25("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) => {
+    console.error(chalk25.yellow(
+      `\u26A0 'squadrant group dispatch' is deprecated \u2014 use 'squadrant dispatch <project> "<task>"' instead.`
+    ));
+    await dispatchAction(toProject, task, opts);
   })
 );
 
+// packages/cli/src/commands/ping.ts
+init_dist();
+import { Command as Command26 } from "commander";
+import chalk26 from "chalk";
+async function runPing(project, message) {
+  const config = loadConfig();
+  const registry = buildRegistry();
+  const resolved = resolveTarget(registry, config, project, false);
+  const ref = await needRef(resolved);
+  await resolved.driver.send(ref, message);
+}
+var pingCommand = new Command26("ping").description("Fire-and-forget: deliver a message into a registered project's captain pane (no tracked task, no report-back)").argument("<project>", "Target project name (must be registered)").argument("<message>", "Message to deliver").action(async (project, message) => {
+  try {
+    await runPing(project, message);
+    console.log(chalk26.green(`\u2714 Pinged '${project}'`));
+  } catch (err) {
+    console.error(chalk26.red(err.message));
+    process.exit(1);
+  }
+});
+
 // packages/cli/src/commands/cmux.ts
 init_dist();
-import { Command as Command25 } from "commander";
-import chalk25 from "chalk";
+import { Command as Command27 } from "commander";
+import chalk27 from "chalk";
 async function runCmuxAutoconfig(opts) {
   const { json, stdout, stderr } = opts;
   let r;
@@ -10703,19 +10770,19 @@ async function runCmuxAutoconfig(opts) {
     stdout.write(`wrote cmux automation config \u2192 ${r.configPath}
 `);
   } else {
-    stdout.write(chalk25.dim(`cmux automation config already in place (${r.configPath})
+    stdout.write(chalk27.dim(`cmux automation config already in place (${r.configPath})
 `));
   }
   if (r.verdict === "reachable") {
-    stdout.write(chalk25.green("\u2714 daemon-direct delivery is reachable \u2014 cmux control socket accepts the daemon\n"));
+    stdout.write(chalk27.green("\u2714 daemon-direct delivery is reachable \u2014 cmux control socket accepts the daemon\n"));
     return 0;
   }
   if (r.needsRestart) {
     stdout.write(
-      chalk25.yellow("\u26A0 cmux is still on the old socket mode \u2014 restart cmux to enable daemon-direct delivery.\n")
+      chalk27.yellow("\u26A0 cmux is still on the old socket mode \u2014 restart cmux to enable daemon-direct delivery.\n")
     );
     if (r.promptedThisRun) {
-      stdout.write(chalk25.dim("  (one-time prompt \u2014 you won't be nagged again)\n"));
+      stdout.write(chalk27.dim("  (one-time prompt \u2014 you won't be nagged again)\n"));
     }
     return 2;
   }
@@ -10724,8 +10791,8 @@ async function runCmuxAutoconfig(opts) {
   );
   return 1;
 }
-var cmuxCommand = new Command25("cmux").description("cmux integration helpers").addCommand(
-  new Command25("autoconfig").description(
+var cmuxCommand = new Command27("cmux").description("cmux integration helpers").addCommand(
+  new Command27("autoconfig").description(
     "Write the cmux automation socket config and probe whether daemon-direct\ndelivery is reachable. Idempotent; prompts once if a cmux restart is needed."
   ).option("--json", "output machine-readable JSON (exit 0=reachable, 1=unknown, 2=restart-needed)").action(async (opts) => {
     const code = await runCmuxAutoconfig({
@@ -10741,8 +10808,8 @@ var cmuxCommand = new Command25("cmux").description("cmux integration helpers").
 init_dist();
 import fs26 from "fs";
 import path28 from "path";
-import { Command as Command26 } from "commander";
-import chalk26 from "chalk";
+import { Command as Command28 } from "commander";
+import chalk28 from "chalk";
 var VALID_EFFORTS = ["max", "balance", "low"];
 var EFFORT_MEANING = {
   max: "tokens are plentiful \u2014 bias crew spawns toward claude/opus",
@@ -10786,22 +10853,22 @@ async function notifyCaptainsOfEffort(effort, config, driver, cwd = process.cwd(
     }
   }
 }
-var effortCommand = new Command26("effort").description("Get or set the global crew tokenomics dial (max | balance | low)").argument("[value]", "effort level to set: max | balance | low").action(async (value) => {
+var effortCommand = new Command28("effort").description("Get or set the global crew tokenomics dial (max | balance | low)").argument("[value]", "effort level to set: max | balance | low").action(async (value) => {
   if (value === void 0) {
     const { effort: effort2, description } = runEffortGet();
-    console.log(chalk26.bold("Current effort:"), chalk26.cyan(effort2));
-    console.log(chalk26.dim(EFFORT_MEANING[effort2]));
+    console.log(chalk28.bold("Current effort:"), chalk28.cyan(effort2));
+    console.log(chalk28.dim(EFFORT_MEANING[effort2]));
     return;
   }
   try {
     runEffortSet(value);
   } catch (err) {
-    console.error(chalk26.red(err.message));
+    console.error(chalk28.red(err.message));
     process.exit(1);
   }
   const effort = value;
-  console.log(chalk26.green(`\u2714 effort \u2192 ${effort}`));
-  console.log(chalk26.dim(EFFORT_MEANING[effort]));
+  console.log(chalk28.green(`\u2714 effort \u2192 ${effort}`));
+  console.log(chalk28.dim(EFFORT_MEANING[effort]));
   try {
     const { createCmuxDriver: createCmuxDriver2, RuntimeRegistry: RuntimeRegistry2 } = await Promise.resolve().then(() => (init_dist3(), dist_exports));
     const config = loadConfig();
@@ -10809,7 +10876,7 @@ var effortCommand = new Command26("effort").description("Get or set the global c
     const driver = registry.global(config);
     await notifyCaptainsOfEffort(effort, config, driver);
   } catch {
-    console.log(chalk26.dim("(no running captain detected \u2014 change applies on next launch)"));
+    console.log(chalk28.dim("(no running captain detected \u2014 change applies on next launch)"));
   }
 });
 
@@ -10818,8 +10885,8 @@ init_dist();
 init_dist2();
 import { join as join24, dirname as dirname6 } from "path";
 import { emitKeypressEvents } from "readline";
-import { Command as Command27 } from "commander";
-import chalk27 from "chalk";
+import { Command as Command29 } from "commander";
+import chalk29 from "chalk";
 function defaultStateRoot() {
   return join24(dirname6(DEFAULT_CONFIG_PATH), "state");
 }
@@ -10866,11 +10933,11 @@ async function questionYesNo(prompt) {
     });
   });
 }
-var telegramCommand = new Command27("telegram").description("Two-way Telegram integration: push crew events to a topic and reply into the captain pane");
+var telegramCommand = new Command29("telegram").description("Two-way Telegram integration: push crew events to a topic and reply into the captain pane");
 telegramCommand.command("status").description("Show Telegram config and linked projects").action(() => {
   const { tokenSet, supergroupId, links } = runTelegramStatus({ config: loadConfig(), stateRoot: defaultStateRoot() });
-  console.log(`token: ${tokenSet ? chalk27.green("set") : chalk27.yellow("unset")}`);
-  console.log(`supergroup: ${supergroupId ?? chalk27.yellow("unset")}`);
+  console.log(`token: ${tokenSet ? chalk29.green("set") : chalk29.yellow("unset")}`);
+  console.log(`supergroup: ${supergroupId ?? chalk29.yellow("unset")}`);
   if (links.length === 0) {
     console.log("no projects linked");
     return;
@@ -10880,32 +10947,32 @@ telegramCommand.command("status").description("Show Telegram config and linked p
 telegramCommand.command("link").argument("<project>", "project to bind to a Telegram topic").description("Create (or reuse) a forum topic for a project and bind it").action(async (project) => {
   const cfg = loadConfig().telegram;
   if (!cfg) {
-    console.error(chalk27.red("telegram config absent \u2014 add a `telegram` block to ~/.config/squadrant/config.json"));
+    console.error(chalk29.red("telegram config absent \u2014 add a `telegram` block to ~/.config/squadrant/config.json"));
     process.exit(1);
   }
   const token = cfg.botToken ?? process.env.TELEGRAM_BOT_TOKEN;
   if (!token) {
-    console.error(chalk27.red("no botToken in config and TELEGRAM_BOT_TOKEN is unset"));
+    console.error(chalk29.red("no botToken in config and TELEGRAM_BOT_TOKEN is unset"));
     process.exit(1);
   }
   const client = createTelegramClient({ token });
   const { topicId, created } = await runTelegramLink({ project, cfg, client, stateRoot: defaultStateRoot() });
-  console.log(chalk27.green(`${created ? "linked" : "already linked"}: ${project} \u2192 topic ${topicId}`));
+  console.log(chalk29.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) => {
   if (!process.stdin.isTTY) {
-    console.error(chalk27.red("setup requires a TTY \u2014 pipe input is not supported"));
+    console.error(chalk29.red("setup requires a TTY \u2014 pipe input is not supported"));
     process.exit(1);
   }
   console.log();
-  console.log(chalk27.bold("Telegram setup") + " \u2014 connect squadrant to a Telegram bot for notifications + remote control");
+  console.log(chalk29.bold("Telegram setup") + " \u2014 connect squadrant to a Telegram bot for notifications + remote control");
   console.log();
   console.log("Before you start you need:");
   console.log("  1. A bot token from @BotFather (send /newbot)");
   console.log("  2. A forum supergroup with the bot added as an admin (Topics enabled)");
   console.log("  3. Bot privacy mode set to OFF (@BotFather \u2192 /setprivacy \u2192 Disable)");
   console.log();
-  console.log(chalk27.bold("Step 1/3 \u2014 Bot token"));
+  console.log(chalk29.bold("Step 1/3 \u2014 Bot token"));
   const existingCfg = loadConfig().telegram;
   const existingToken = existingCfg?.botToken ?? process.env.TELEGRAM_BOT_TOKEN;
   const decision = resolveSetupToken(existingToken, { resetToken: opts.resetToken ?? false });
@@ -10917,67 +10984,67 @@ telegramCommand.command("setup").description("Interactive wizard \u2014 bot toke
     try {
       botUser = await client.getMe();
       token = existingToken;
-      console.log(chalk27.green(`Using existing bot token (@${botUser.username})`));
+      console.log(chalk29.green(`Using existing bot token (@${botUser.username})`));
       console.log();
     } catch {
-      console.log(chalk27.yellow("Existing token is invalid \u2014 please enter a new one."));
+      console.log(chalk29.yellow("Existing token is invalid \u2014 please enter a new one."));
       console.log("Paste your bot token then press Enter (input is hidden):");
       token = await questionMasked();
       if (!token) {
-        console.error(chalk27.red("token required"));
+        console.error(chalk29.red("token required"));
         process.exit(1);
       }
       client = createTelegramClient({ token });
       try {
         botUser = await client.getMe();
       } catch (e) {
-        console.error(chalk27.red(`token rejected: ${e.message}`));
+        console.error(chalk29.red(`token rejected: ${e.message}`));
         process.exit(1);
       }
-      console.log(chalk27.green(`Connected as @${botUser.username}`));
+      console.log(chalk29.green(`Connected as @${botUser.username}`));
       console.log();
     }
   } else {
     console.log("Paste your bot token then press Enter (input is hidden):");
     token = await questionMasked();
     if (!token) {
-      console.error(chalk27.red("token required"));
+      console.error(chalk29.red("token required"));
       process.exit(1);
     }
     client = createTelegramClient({ token });
     try {
       botUser = await client.getMe();
     } catch (e) {
-      console.error(chalk27.red(`token rejected: ${e.message}`));
+      console.error(chalk29.red(`token rejected: ${e.message}`));
       process.exit(1);
     }
-    console.log(chalk27.green(`Connected as @${botUser.username}`));
+    console.log(chalk29.green(`Connected as @${botUser.username}`));
     console.log();
   }
-  console.log(chalk27.bold("Step 2/3 \u2014 Supergroup"));
+  console.log(chalk29.bold("Step 2/3 \u2014 Supergroup"));
   const groupDecision = resolveSetupGroup(existingCfg?.supergroupId, { redetect: opts.redetect ?? false });
   let supergroupId;
   let detectedUserId;
   if (groupDecision === "reuse") {
     supergroupId = existingCfg.supergroupId;
-    console.log(chalk27.green(`Using existing group: ${supergroupId}`));
+    console.log(chalk29.green(`Using existing group: ${supergroupId}`));
     console.log();
   } else {
     console.log("Add the bot to your forum supergroup, then send any message in it.");
-    console.log(chalk27.dim("Waiting for a message (up to 60s)\u2026"));
+    console.log(chalk29.dim("Waiting for a message (up to 60s)\u2026"));
     try {
       ({ supergroupId, userId: detectedUserId } = await detectGroupAndUser(client, { timeoutMs: 6e4 }));
     } catch {
-      console.error(chalk27.red("Timed out \u2014 no supergroup message received within 60s."));
-      console.error(chalk27.yellow("Check: bot is an admin in the group \xB7 privacy mode is OFF \xB7 Topics enabled"));
+      console.error(chalk29.red("Timed out \u2014 no supergroup message received within 60s."));
+      console.error(chalk29.yellow("Check: bot is an admin in the group \xB7 privacy mode is OFF \xB7 Topics enabled"));
       process.exit(1);
     }
-    console.log(chalk27.green(`Found group: ${supergroupId}`));
+    console.log(chalk29.green(`Found group: ${supergroupId}`));
     console.log();
   }
-  console.log(chalk27.bold("Step 3/3 \u2014 Remote control + Save"));
-  console.log(chalk27.dim("Remote control enables auto-launching captains and the General command channel"));
-  console.log(chalk27.dim("from your phone \u2014 gated to your Telegram user-id only (fail-closed)."));
+  console.log(chalk29.bold("Step 3/3 \u2014 Remote control + Save"));
+  console.log(chalk29.dim("Remote control enables auto-launching captains and the General command channel"));
+  console.log(chalk29.dim("from your phone \u2014 gated to your Telegram user-id only (fail-closed)."));
   const finalUserId = resolveSetupUserId(opts.userId, detectedUserId, defaultStateRoot());
   let users;
   let remoteControl;
@@ -10991,32 +11058,32 @@ telegramCommand.command("setup").description("Interactive wizard \u2014 bot toke
       remoteControl = true;
     }
   } else if (groupDecision === "detect") {
-    console.log(chalk27.yellow("Could not read your user-id from that message \u2014 skipping remote control."));
-    console.log(chalk27.yellow("Re-run with --user-id <id> to enable, or edit telegram.users in config manually."));
+    console.log(chalk29.yellow("Could not read your user-id from that message \u2014 skipping remote control."));
+    console.log(chalk29.yellow("Re-run with --user-id <id> to enable, or edit telegram.users in config manually."));
     printedRemoteControlState = true;
   } else {
     const existingUsers = existingCfg?.users;
     if (existingUsers && existingUsers.length > 0) {
-      console.log(chalk27.dim(`Remote control: already configured (user-id ${existingUsers[0]}). Use --user-id to update.`));
+      console.log(chalk29.dim(`Remote control: already configured (user-id ${existingUsers[0]}). Use --user-id to update.`));
     } else {
-      console.log(chalk27.dim("Remote control: off. Re-run with --user-id <id> to enable."));
+      console.log(chalk29.dim("Remote control: off. Re-run with --user-id <id> to enable."));
     }
     printedRemoteControlState = true;
   }
   writeTelegramConfig(DEFAULT_CONFIG_PATH, { token, supergroupId, users, remoteControl });
-  console.log(chalk27.green(`Wrote telegram config \u2014 token: ${maskToken(token)}  group: ${supergroupId}`));
+  console.log(chalk29.green(`Wrote telegram config \u2014 token: ${maskToken(token)}  group: ${supergroupId}`));
   if (!printedRemoteControlState) {
     if (remoteControl) {
-      console.log(chalk27.green(`Remote control: ON (allowlisted user-id ${users[0]})`));
+      console.log(chalk29.green(`Remote control: ON (allowlisted user-id ${users[0]})`));
     } else {
-      console.log(chalk27.dim("Remote control: off (default). Re-run with --user-id <id> to enable."));
+      console.log(chalk29.dim("Remote control: off (default). Re-run with --user-id <id> to enable."));
     }
   }
   try {
     await runRegisterCommands({ client });
-    console.log(chalk27.dim("Registered the /command menu."));
+    console.log(chalk29.dim("Registered the /command menu."));
   } catch (e) {
-    console.log(chalk27.yellow(`command-menu registration skipped: ${e.message}`));
+    console.log(chalk29.yellow(`command-menu registration skipped: ${e.message}`));
   }
   const topics = loadState(defaultStateRoot()).topics;
   const topicEntries = Object.entries(topics);
@@ -11025,28 +11092,28 @@ telegramCommand.command("setup").description("Interactive wizard \u2014 bot toke
       const project = key.slice(0, key.indexOf("::"));
       return `${project}\u2192${id}`;
     }).join(", ");
-    console.log(chalk27.dim(`Existing topics: ${summary} (already created \u2014 not recreated)`));
+    console.log(chalk29.dim(`Existing topics: ${summary} (already created \u2014 not recreated)`));
   } else {
-    console.log(chalk27.dim("No project topics yet \u2014 they're created on first delivery or via: squadrant telegram link <project>"));
+    console.log(chalk29.dim("No project topics yet \u2014 they're created on first delivery or via: squadrant telegram link <project>"));
   }
   runTelegramPostSetup({});
   console.log();
-  console.log(`Next: ${chalk27.cyan("squadrant telegram link <project>")}`);
+  console.log(`Next: ${chalk29.cyan("squadrant telegram link <project>")}`);
 });
 telegramCommand.command("register-commands").description("Register (or re-register) the bot's / command menu with Telegram").action(async () => {
   const cfg = loadConfig().telegram;
   if (!cfg) {
-    console.error(chalk27.red("telegram config absent \u2014 run: squadrant telegram setup"));
+    console.error(chalk29.red("telegram config absent \u2014 run: squadrant telegram setup"));
     process.exit(1);
   }
   const token = cfg.botToken ?? process.env.TELEGRAM_BOT_TOKEN;
   if (!token) {
-    console.error(chalk27.red("no botToken in config and TELEGRAM_BOT_TOKEN is unset"));
+    console.error(chalk29.red("no botToken in config and TELEGRAM_BOT_TOKEN is unset"));
     process.exit(1);
   }
   const client = createTelegramClient({ token });
   await runRegisterCommands({ client });
-  console.log(chalk27.green(`registered ${BOT_COMMANDS.length} bot commands`));
+  console.log(chalk29.green(`registered ${BOT_COMMANDS.length} bot commands`));
 });
 telegramCommand.command("notify").argument("[project]", "project to toggle").argument("[state]", "on | off | crew | cap").argument("[value]", "tier for crew (all|alert_only|done_only|none) or on|off for cap").option("--status", "list notification state for all projects").description("Live on|off (state), or crew <tier> / cap <on|off> preference (per-project config)").action(async (project, state, value, opts) => {
   const stateRoot = defaultStateRoot();
@@ -11057,7 +11124,7 @@ telegramCommand.command("notify").argument("[project]", "project to toggle").arg
       return;
     }
     for (const r of rows) {
-      console.log(`  ${r.project}: ${r.active ? chalk27.green("on") : chalk27.dim("off (muted)")}`);
+      console.log(`  ${r.project}: ${r.active ? chalk29.green("on") : chalk29.dim("off (muted)")}`);
     }
     return;
   }
@@ -11066,53 +11133,53 @@ telegramCommand.command("notify").argument("[project]", "project to toggle").arg
   const token = tgCfg?.botToken ?? process.env.TELEGRAM_BOT_TOKEN;
   if (state === "crew" || state === "cap") {
     if (value === void 0) {
-      console.error(chalk27.red(`usage: squadrant telegram notify <project> ${state} <value>`));
+      console.error(chalk29.red(`usage: squadrant telegram notify <project> ${state} <value>`));
       process.exit(1);
     }
     const resolved2 = resolveNotify(globalNotify, loadProjectOverride(project));
     const before2 = { ...resolved2, active: isNotifyActive(stateRoot, project) };
     const res = runTelegramNotifyPref({ project, dimension: state, value });
     if (!res.ok) {
-      console.error(chalk27.red(res.message));
+      console.error(chalk29.red(res.message));
       process.exit(1);
     }
-    console.log(chalk27.green(`${project} ${state} = ${value}`));
+    console.log(chalk29.green(`${project} ${state} = ${value}`));
     const after2 = state === "crew" ? { ...before2, crew: value } : { ...before2, cap: value === "on" };
     if (tgCfg && token) {
       const client = createTelegramClient({ token });
       const sent = await runNotifyConfirmation({ project, before: before2, after: after2, cfg: tgCfg, client, stateRoot });
-      if (sent) console.log(chalk27.dim(`\u2192 notified ${project} topic`));
+      if (sent) console.log(chalk29.dim(`\u2192 notified ${project} topic`));
     }
     return;
   }
   if (state !== "on" && state !== "off") {
-    console.error(chalk27.red("usage: squadrant telegram notify <project> <on|off|crew <tier>|cap <on|off>>"));
+    console.error(chalk29.red("usage: squadrant telegram notify <project> <on|off|crew <tier>|cap <on|off>>"));
     process.exit(1);
   }
   const resolved = resolveNotify(globalNotify, loadProjectOverride(project));
   const before = { ...resolved, active: isNotifyActive(stateRoot, project) };
   const after = { ...before, active: state === "on" };
   runTelegramNotifySet({ project, active: state === "on", stateRoot });
-  console.log(chalk27.green(`${project} notifications ${state === "on" ? "ON" : "OFF"}`));
+  console.log(chalk29.green(`${project} notifications ${state === "on" ? "ON" : "OFF"}`));
   if (tgCfg && token) {
     const client = createTelegramClient({ token });
     const sent = await runNotifyConfirmation({ project, before, after, cfg: tgCfg, client, stateRoot });
-    if (sent) console.log(chalk27.dim(`\u2192 notified ${project} topic`));
+    if (sent) console.log(chalk29.dim(`\u2192 notified ${project} topic`));
   }
 });
 telegramCommand.command("send").argument("<project>", "project whose topic receives the message").argument("[message...]", "message text (omit to read from stdin)").description("Send a message to a project's linked Telegram topic").action(async (project, messageParts) => {
   const cfg = loadConfig().telegram;
   if (!cfg) {
-    console.error(chalk27.red("telegram config absent \u2014 add a `telegram` block to ~/.config/squadrant/config.json"));
+    console.error(chalk29.red("telegram config absent \u2014 add a `telegram` block to ~/.config/squadrant/config.json"));
     process.exit(1);
   }
   const token = cfg.botToken ?? process.env.TELEGRAM_BOT_TOKEN;
   if (!token) {
-    console.error(chalk27.red("no botToken in config and TELEGRAM_BOT_TOKEN is unset"));
+    console.error(chalk29.red("no botToken in config and TELEGRAM_BOT_TOKEN is unset"));
     process.exit(1);
   }
   if (!capAllowed(project, cfg.notify)) {
-    console.log(chalk27.dim(`${project}: captain messages muted (cap=off) \u2014 not sent`));
+    console.log(chalk29.dim(`${project}: captain messages muted (cap=off) \u2014 not sent`));
     return;
   }
   let message;
@@ -11125,19 +11192,19 @@ telegramCommand.command("send").argument("<project>", "project whose topic recei
     for await (const line of rl) lines.push(line);
     message = lines.join("\n").trimEnd();
     if (!message) {
-      console.error(chalk27.red("no message provided (stdin was empty)"));
+      console.error(chalk29.red("no message provided (stdin was empty)"));
       process.exit(1);
     }
   } else {
-    console.error(chalk27.red("message required \u2014 pass as argument or pipe via stdin"));
+    console.error(chalk29.red("message required \u2014 pass as argument or pipe via stdin"));
     process.exit(1);
   }
   const client = createTelegramClient({ token });
   try {
     const { chatId, topicId } = await runTelegramSend({ project, message, cfg, client, stateRoot: defaultStateRoot() });
-    console.log(chalk27.green(`sent to group ${chatId} topic ${topicId}`));
+    console.log(chalk29.green(`sent to group ${chatId} topic ${topicId}`));
   } catch (e) {
-    console.error(chalk27.red(e.message));
+    console.error(chalk29.red(e.message));
     process.exit(1);
   }
 });
@@ -11145,7 +11212,7 @@ telegramCommand.command("send").argument("<project>", "project whose topic recei
 // packages/cli/src/commands/hooks.ts
 init_dist2();
 init_dist4();
-import { Command as Command28 } from "commander";
+import { Command as Command30 } from "commander";
 import { join as join25 } from "path";
 import { homedir as homedir17 } from "os";
 var SOCK4 = join25(homedir17(), ".config", "squadrant", "squadrant.sock");
@@ -11174,7 +11241,7 @@ function mapHookSub(sub, payload, taskId) {
   }
 }
 function hooksCommand() {
-  const hooks = new Command28("hooks").description("(internal) receive lifecycle hook events from agent processes");
+  const hooks = new Command30("hooks").description("(internal) receive lifecycle hook events from agent processes");
   hooks.command("claude <sub>", { hidden: true }).description("internal: bridge a NativeHookSource claude hook to squadrantd").action(async (sub) => {
     const taskId = process.env.SQUADRANT_CREW_TASK_ID;
     const project = process.env.SQUADRANT_CREW_PROJECT;
@@ -11243,7 +11310,7 @@ if (process.argv[2] !== "config") {
 if (!process.env.SQUADRANT_DAEMON_SKIP) {
   ensureDaemon();
 }
-var program = new Command29();
+var program = new Command31();
 program.name("squadrant").description("Multi-project orchestration for your coding agents (Claude, Codex, opencode, Gemini)").version(pkg.version);
 program.addCommand(doctorCommand);
 program.addCommand(initCommand);
@@ -11267,6 +11334,8 @@ program.addCommand(codexChatSmokeCommand);
 program.addCommand(configCommand);
 program.addCommand(healCommand);
 program.addCommand(groupCommand);
+program.addCommand(pingCommand);
+program.addCommand(dispatchCommand);
 program.addCommand(cmuxCommand);
 program.addCommand(effortCommand);
 program.addCommand(telegramCommand);