squadrant 0.9.2 → 0.11.0

package/dist/index.js

@@ -107,6 +107,66 @@ var init_config = __esm({
   }
 });
 
+// packages/shared/dist/project-config.js
+import fs2 from "fs";
+import os2 from "os";
+import path2 from "path";
+function defaultRoot() {
+  return path2.join(os2.homedir(), ".config", "squadrant");
+}
+function projectConfigPath(name, root = defaultRoot()) {
+  return path2.join(root, "projects", `${name}.json`);
+}
+function loadProjectOverride(name, root = defaultRoot()) {
+  try {
+    return JSON.parse(fs2.readFileSync(projectConfigPath(name, root), "utf-8"));
+  } catch {
+    return {};
+  }
+}
+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);
+  }
+  return out;
+}
+function saveProjectOverride(name, patch, root = defaultRoot()) {
+  const merged = deepMerge(loadProjectOverride(name, root), patch);
+  const file = projectConfigPath(name, root);
+  fs2.mkdirSync(path2.dirname(file), { recursive: true });
+  fs2.writeFileSync(file, JSON.stringify(merged, null, 2) + "\n");
+}
+function crewRank(tier) {
+  return CREW_RANK[tier];
+}
+function isQuieter(before, after) {
+  if (before.active && !after.active)
+    return { quieter: true, dim: "active" };
+  if (before.cap && !after.cap)
+    return { quieter: true, dim: "cap" };
+  if (crewRank(after.crew) < crewRank(before.crew))
+    return { quieter: true, dim: "crew" };
+  return { quieter: false, dim: null };
+}
+function resolveNotify(globalNotify, override) {
+  let n = { ...DEFAULT_NOTIFY };
+  if (globalNotify)
+    n = deepMerge(n, globalNotify);
+  if (override.telegram?.notify)
+    n = deepMerge(n, override.telegram.notify);
+  return n;
+}
+var DEFAULT_NOTIFY, CREW_RANK;
+var init_project_config = __esm({
+  "packages/shared/dist/project-config.js"() {
+    DEFAULT_NOTIFY = { active: false, cap: true, crew: "alert_only" };
+    CREW_RANK = { none: 0, done_only: 1, alert_only: 2, all: 3 };
+  }
+});
+
 // packages/shared/dist/effort.js
 function resolveEffort(config) {
   return config.defaults.effort ?? "balance";
@@ -155,22 +215,22 @@ function defaultCmuxConfigPath() {
   return join(homedir(), ".config", "cmux", "cmux.json");
 }
 function ensureSocketAutomation(opts = {}) {
-  const path26 = opts.path ?? defaultCmuxConfigPath();
-  if (!existsSync(path26)) {
-    mkdirSync(dirname(path26), { recursive: true });
-    writeFileSync(path26, MINIMAL_TEMPLATE);
-    return { path: path26, changed: true, alreadySet: false };
+  const path29 = opts.path ?? defaultCmuxConfigPath();
+  if (!existsSync(path29)) {
+    mkdirSync(dirname(path29), { recursive: true });
+    writeFileSync(path29, MINIMAL_TEMPLATE);
+    return { path: path29, changed: true, alreadySet: false };
   }
-  const text = readFileSync(path26, "utf-8");
+  const text = readFileSync(path29, "utf-8");
   const current = parse(text)?.automation?.socketControlMode;
   if (current === AUTOMATION_MODE) {
-    return { path: path26, changed: false, alreadySet: true };
+    return { path: path29, changed: false, alreadySet: true };
   }
   const edits = modify(text, [...SOCKET_CONTROL_MODE_PATH], AUTOMATION_MODE, {
     formattingOptions: { insertSpaces: true, tabSize: 2 }
   });
-  writeFileSync(path26, applyEdits(text, edits));
-  return { path: path26, changed: true, alreadySet: false };
+  writeFileSync(path29, applyEdits(text, edits));
+  return { path: path29, changed: true, alreadySet: false };
 }
 var SOCKET_CONTROL_MODE_PATH, AUTOMATION_MODE, MINIMAL_TEMPLATE;
 var init_cmux_config = __esm({
@@ -320,15 +380,15 @@ import { dirname as dirname2, join as join4 } from "path";
 function defaultStatePath() {
   return join4(homedir3(), ".config", "squadrant", "state", "cmux-autoconfig.json");
 }
-function readState(path26) {
+function readState(path29) {
   try {
-    return JSON.parse(readFileSync4(path26, "utf-8"));
+    return JSON.parse(readFileSync4(path29, "utf-8"));
   } catch {
     return {};
   }
 }
 async function ensureCmuxAutoConfig(opts = {}) {
-  const statePath = opts.statePath ?? defaultStatePath();
+  const statePath2 = opts.statePath ?? defaultStatePath();
   const ensureConfig = opts.ensureConfig ?? ensureSocketAutomation;
   const probe = opts.probe ?? probeCmuxDaemonDirect;
   const cfg = ensureConfig({ path: opts.configPath });
@@ -336,15 +396,15 @@ async function ensureCmuxAutoConfig(opts = {}) {
   const needsRestart = verdict === "denied";
   let promptedThisRun = false;
   if (needsRestart) {
-    const already = readState(statePath).promptedRestart === true;
+    const already = readState(statePath2).promptedRestart === true;
     if (!already) {
-      mkdirSync2(dirname2(statePath), { recursive: true });
-      writeFileSync3(statePath, JSON.stringify({ promptedRestart: true }));
+      mkdirSync2(dirname2(statePath2), { recursive: true });
+      writeFileSync3(statePath2, JSON.stringify({ promptedRestart: true }));
       promptedThisRun = true;
     }
   } else if (verdict === "reachable") {
-    if (existsSync4(statePath))
-      rmSync2(statePath, { force: true });
+    if (existsSync4(statePath2))
+      rmSync2(statePath2, { force: true });
   }
   return {
     configPath: cfg.path,
@@ -543,9 +603,9 @@ var init_config_version = __esm({
 
 // packages/shared/dist/lib/git-worktree.js
 import { execFileSync as execFileSync2 } from "child_process";
-import path2 from "path";
+import path3 from "path";
 function worktreePath(repoRoot, worktreeDir, project, name) {
-  return path2.resolve(repoRoot, worktreeDir, `${project}-${name}`);
+  return path3.resolve(repoRoot, worktreeDir, `${project}-${name}`);
 }
 function crewBranch(name) {
   return `crew/${name}`;
@@ -579,7 +639,7 @@ var init_git_worktree = __esm({
 });
 
 // packages/shared/dist/lib/resolve-text-input.js
-import fs2 from "fs";
+import fs3 from "fs";
 async function readAllStdin() {
   const chunks = [];
   for await (const chunk of process.stdin) {
@@ -591,7 +651,7 @@ function flagName(label) {
   return label === "task" ? "--task-file" : "--message-file";
 }
 async function resolveTextInput(opts, deps) {
-  const readFile6 = deps?.readFile ?? ((p) => fs2.readFileSync(p, "utf8"));
+  const readFile6 = deps?.readFile ?? ((p) => fs3.readFileSync(p, "utf8"));
   const readStdin3 = deps?.readStdin ?? readAllStdin;
   if (opts.filePath) {
     if (opts.filePath === "-") {
@@ -619,59 +679,59 @@ var init_resolve_text_input = __esm({
 });
 
 // packages/shared/dist/lib/runtime-sync.js
-import fs3 from "fs";
-import path3 from "path";
+import fs4 from "fs";
+import path4 from "path";
 function copyIfDifferent(src, dest) {
-  if (fs3.existsSync(dest)) {
-    if (fs3.readFileSync(src).equals(fs3.readFileSync(dest)))
+  if (fs4.existsSync(dest)) {
+    if (fs4.readFileSync(src).equals(fs4.readFileSync(dest)))
       return false;
   }
-  fs3.copyFileSync(src, dest);
+  fs4.copyFileSync(src, dest);
   return true;
 }
 function mirrorDir(src, dest) {
-  fs3.mkdirSync(dest, { recursive: true });
-  const srcEntries = fs3.readdirSync(src, { withFileTypes: true });
+  fs4.mkdirSync(dest, { recursive: true });
+  const srcEntries = fs4.readdirSync(src, { withFileTypes: true });
   const srcNames = new Set(srcEntries.map((e) => e.name));
   for (const entry of srcEntries) {
-    const srcPath = path3.join(src, entry.name);
-    const destPath = path3.join(dest, entry.name);
+    const srcPath = path4.join(src, entry.name);
+    const destPath = path4.join(dest, entry.name);
     if (entry.isDirectory()) {
       mirrorDir(srcPath, destPath);
     } else {
       copyIfDifferent(srcPath, destPath);
     }
   }
-  for (const entry of fs3.readdirSync(dest, { withFileTypes: true })) {
+  for (const entry of fs4.readdirSync(dest, { withFileTypes: true })) {
     if (!srcNames.has(entry.name)) {
-      fs3.rmSync(path3.join(dest, entry.name), { recursive: true, force: true });
+      fs4.rmSync(path4.join(dest, entry.name), { recursive: true, force: true });
     }
   }
 }
 function mirrorFlat(src, dest, match, chmod) {
-  fs3.mkdirSync(dest, { recursive: true });
-  const matched = fs3.readdirSync(src, { withFileTypes: true }).filter((e) => e.isFile() && match.test(e.name)).map((e) => e.name);
+  fs4.mkdirSync(dest, { recursive: true });
+  const matched = fs4.readdirSync(src, { withFileTypes: true }).filter((e) => e.isFile() && match.test(e.name)).map((e) => e.name);
   const matchedSet = new Set(matched);
   for (const name of matched) {
-    const destPath = path3.join(dest, name);
-    const copied = copyIfDifferent(path3.join(src, name), destPath);
+    const destPath = path4.join(dest, name);
+    const copied = copyIfDifferent(path4.join(src, name), destPath);
     if (copied && chmod !== void 0)
-      fs3.chmodSync(destPath, chmod);
+      fs4.chmodSync(destPath, chmod);
   }
-  for (const entry of fs3.readdirSync(dest, { withFileTypes: true })) {
+  for (const entry of fs4.readdirSync(dest, { withFileTypes: true })) {
     if (!matchedSet.has(entry.name)) {
-      fs3.rmSync(path3.join(dest, entry.name), { recursive: true, force: true });
+      fs4.rmSync(path4.join(dest, entry.name), { recursive: true, force: true });
     }
   }
 }
 function ensureRuntimeSynced(opts) {
   const targets = opts.targets ?? MANAGED_TARGETS;
   for (const t of targets) {
-    const srcDir = path3.join(opts.sourceRoot, t.srcRel);
+    const srcDir = path4.join(opts.sourceRoot, t.srcRel);
     try {
-      if (!fs3.existsSync(srcDir))
+      if (!fs4.existsSync(srcDir))
         continue;
-      const destDir = path3.join(opts.runtimeRoot, t.name);
+      const destDir = path4.join(opts.runtimeRoot, t.name);
       if (t.mode === "tree") {
         mirrorDir(srcDir, destDir);
       } else {
@@ -735,8 +795,8 @@ var init_tool_compat = __esm({
 });
 
 // packages/shared/dist/lib/canonical-source.js
-import fs4 from "fs";
-import path4 from "path";
+import fs5 from "fs";
+import path5 from "path";
 function parseSkill(raw) {
   const match = raw.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
   if (!match)
@@ -777,10 +837,10 @@ async function readSkills(driver, skillsDir) {
 function readRoleTemplates(opts) {
   if (!opts.pkgRoot)
     return "";
-  const reader = opts.readFile ?? ((p) => fs4.readFileSync(p, "utf-8"));
+  const reader = opts.readFile ?? ((p) => fs5.readFileSync(p, "utf-8"));
   const sections = [];
   for (const { file, heading } of ROLE_TEMPLATES) {
-    const full = path4.join(opts.pkgRoot, "templates", file);
+    const full = path5.join(opts.pkgRoot, "templates", file);
     let body = "";
     try {
       body = reader(full);
@@ -817,8 +877,8 @@ var init_canonical_source = __esm({
 
 // packages/shared/dist/lib/daily-logs.js
 import { execSync } from "child_process";
-import fs5 from "fs";
-import path5 from "path";
+import fs6 from "fs";
+import path6 from "path";
 import matter from "gray-matter";
 function iso(d) {
   return d.toISOString().slice(0, 10);
@@ -870,7 +930,7 @@ function getGitCommits(projectPath, dateStr) {
 }
 function getGitCommitsInRange(projectPath, since, until) {
   const resolved = resolveHome(projectPath);
-  if (!fs5.existsSync(path5.join(resolved, ".git")))
+  if (!fs6.existsSync(path6.join(resolved, ".git")))
     return [];
   const untilArg = until ? ` --until="${until}"` : "";
   try {
@@ -884,7 +944,7 @@ function getGitCommitsInRange(projectPath, since, until) {
 }
 function getMergedPRsInRange(projectPath, since, until) {
   const resolved = resolveHome(projectPath);
-  if (!fs5.existsSync(path5.join(resolved, ".git")))
+  if (!fs6.existsSync(path6.join(resolved, ".git")))
     return [];
   const untilArg = until ? ` --until="${until}"` : "";
   try {
@@ -924,10 +984,27 @@ var init_vault_layout = __esm({
   }
 });
 
+// packages/shared/dist/daemon-keys.js
+function isDaemonCachedKey(dottedKey) {
+  return DAEMON_CACHED_PREFIXES.some((p) => dottedKey === p || dottedKey.startsWith(p));
+}
+var DAEMON_CACHED_PREFIXES;
+var init_daemon_keys = __esm({
+  "packages/shared/dist/daemon-keys.js"() {
+    DAEMON_CACHED_PREFIXES = [
+      "telegram.",
+      "defaults.taskTimeoutMs",
+      "defaults.cmuxEventsBridge",
+      "projects."
+    ];
+  }
+});
+
 // packages/shared/dist/index.js
 var init_dist = __esm({
   "packages/shared/dist/index.js"() {
     init_config();
+    init_project_config();
     init_effort();
     init_runtime();
     init_control();
@@ -947,6 +1024,7 @@ var init_dist = __esm({
     init_canonical_source();
     init_daily_logs();
     init_vault_layout();
+    init_daemon_keys();
   }
 });
 
@@ -978,7 +1056,7 @@ var init_daemon = __esm({
 });
 
 // packages/core/dist/mailbox.js
-import { promises as fs6 } from "fs";
+import { promises as fs7 } from "fs";
 import { join as join5 } from "path";
 import { randomUUID } from "crypto";
 var init_mailbox = __esm({
@@ -1131,10 +1209,10 @@ function daemonEntryPath() {
 function xmlEscape(s) {
   return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
-function sanitizePathForPlist(path26) {
+function sanitizePathForPlist(path29) {
   const seen = /* @__PURE__ */ new Set();
   const stable = [];
-  for (const p of path26.split(":")) {
+  for (const p of path29.split(":")) {
     if (!p)
       continue;
     if (p.includes("/.claude/plugins/"))
@@ -1202,6 +1280,9 @@ function renderPlist(nodeBin, daemonEntry, pathEnv = "") {
 function programArgsBlock(nodeBin, daemonEntry) {
   return `<array><string>${xmlEscape(nodeBin)}</string><string>${xmlEscape(daemonEntry)}</string></array>`;
 }
+function kickstartArgv(target, plistChanged) {
+  return plistChanged ? ["kickstart", "-k", target] : ["kickstart", target];
+}
 function daemonLockPath() {
   return join7(homedir4(), ".config", "squadrant", "daemon.lock");
 }
@@ -1423,35 +1504,35 @@ var init_start = __esm({
 
 // packages/core/dist/session-freshness.js
 import crypto from "crypto";
-import fs7 from "fs";
-import path6 from "path";
+import fs8 from "fs";
+import path7 from "path";
 function loadSessions(sessionsPath) {
   try {
-    return JSON.parse(fs7.readFileSync(sessionsPath, "utf-8"));
+    return JSON.parse(fs8.readFileSync(sessionsPath, "utf-8"));
   } catch {
     return { workspaces: {} };
   }
 }
 function saveSessions(sessionsPath, sessions) {
-  const dir = path6.dirname(sessionsPath);
-  fs7.mkdirSync(dir, { recursive: true });
-  fs7.writeFileSync(sessionsPath, JSON.stringify(sessions, null, 2) + "\n");
+  const dir = path7.dirname(sessionsPath);
+  fs8.mkdirSync(dir, { recursive: true });
+  fs8.writeFileSync(sessionsPath, JSON.stringify(sessions, null, 2) + "\n");
 }
 function computeTemplateHash(role, templatesDir) {
   const hash = crypto.createHash("sha256");
-  const roleFile = path6.join(templatesDir, `${role}.claude.md`);
-  const legacyRoleFile = path6.join(templatesDir, `${role}.CLAUDE.md`);
-  if (fs7.existsSync(roleFile)) {
-    hash.update(fs7.readFileSync(roleFile, "utf-8"));
-  } else if (fs7.existsSync(legacyRoleFile)) {
-    hash.update(fs7.readFileSync(legacyRoleFile, "utf-8"));
+  const roleFile = path7.join(templatesDir, `${role}.claude.md`);
+  const legacyRoleFile = path7.join(templatesDir, `${role}.CLAUDE.md`);
+  if (fs8.existsSync(roleFile)) {
+    hash.update(fs8.readFileSync(roleFile, "utf-8"));
+  } else if (fs8.existsSync(legacyRoleFile)) {
+    hash.update(fs8.readFileSync(legacyRoleFile, "utf-8"));
   }
-  const pluginSkillsDir = path6.join(templatesDir, "..", "plugin", "skills");
-  if (fs7.existsSync(pluginSkillsDir)) {
-    for (const skill of fs7.readdirSync(pluginSkillsDir).sort()) {
-      const skillFile = path6.join(pluginSkillsDir, skill, "SKILL.md");
-      if (fs7.existsSync(skillFile)) {
-        hash.update(fs7.readFileSync(skillFile, "utf-8"));
+  const pluginSkillsDir = path7.join(templatesDir, "..", "plugin", "skills");
+  if (fs8.existsSync(pluginSkillsDir)) {
+    for (const skill of fs8.readdirSync(pluginSkillsDir).sort()) {
+      const skillFile = path7.join(pluginSkillsDir, skill, "SKILL.md");
+      if (fs8.existsSync(skillFile)) {
+        hash.update(fs8.readFileSync(skillFile, "utf-8"));
       }
     }
   }
@@ -1571,6 +1652,276 @@ var init_crew_lifecycle = __esm({
   }
 });
 
+// packages/core/dist/telegram/bot-commands.js
+var BOT_COMMANDS;
+var init_bot_commands = __esm({
+  "packages/core/dist/telegram/bot-commands.js"() {
+    BOT_COMMANDS = [
+      { command: "status", description: "squadrant status" },
+      { command: "projects", description: "list registered projects" },
+      { command: "crews", description: "list crews for a project" },
+      { command: "launch", description: "launch a project's captain" },
+      { command: "effort", description: "set effort: max | balance | low" },
+      { command: "spawn", description: "spawn a crew (guided)" },
+      { command: "notify", description: "notification panel for a project topic" },
+      { command: "mute", description: "mute a project's topic" },
+      { command: "unmute", description: "unmute a project's topic" },
+      { command: "help", description: "list commands" }
+    ];
+  }
+});
+
+// packages/core/dist/telegram/auth.js
+var init_auth = __esm({
+  "packages/core/dist/telegram/auth.js"() {
+  }
+});
+
+// packages/core/dist/telegram/commands.js
+var init_commands = __esm({
+  "packages/core/dist/telegram/commands.js"() {
+  }
+});
+
+// packages/core/dist/telegram/ensure-captain.js
+var init_ensure_captain = __esm({
+  "packages/core/dist/telegram/ensure-captain.js"() {
+  }
+});
+
+// packages/core/dist/telegram/format.js
+function topicName(project) {
+  return project;
+}
+function maskToken(token) {
+  if (token.length <= 4)
+    return token;
+  return "*".repeat(token.length - 4) + token.slice(-4);
+}
+var init_format = __esm({
+  "packages/core/dist/telegram/format.js"() {
+  }
+});
+
+// packages/core/dist/telegram/state.js
+import fs9 from "fs";
+import path8 from "path";
+function statePath(stateRoot) {
+  return path8.join(stateRoot, "telegram-state.json");
+}
+function topicKey(project, scope = "project") {
+  return `${project}::${scope}`;
+}
+function loadState(stateRoot) {
+  try {
+    const raw = fs9.readFileSync(statePath(stateRoot), "utf-8");
+    const data = JSON.parse(raw);
+    const result = {
+      offset: typeof data.offset === "number" ? data.offset : 0,
+      topics: data.topics ?? {},
+      notify: data.notify ?? {}
+    };
+    if (typeof data.lastUserId === "number")
+      result.lastUserId = data.lastUserId;
+    return result;
+  } catch {
+    return { offset: 0, topics: {}, notify: {} };
+  }
+}
+function saveState(stateRoot, s) {
+  fs9.mkdirSync(stateRoot, { recursive: true });
+  fs9.writeFileSync(statePath(stateRoot), JSON.stringify(s, null, 2) + "\n");
+}
+function setTopic(stateRoot, project, topicId, scope = "project") {
+  const s = loadState(stateRoot);
+  s.topics[topicKey(project, scope)] = topicId;
+  saveState(stateRoot, s);
+}
+function isNotifyActive(stateRoot, project) {
+  return loadState(stateRoot).notify[project] === true;
+}
+function setNotify(stateRoot, project, active) {
+  const s = loadState(stateRoot);
+  s.notify[project] = active;
+  saveState(stateRoot, s);
+}
+var init_state = __esm({
+  "packages/core/dist/telegram/state.js"() {
+  }
+});
+
+// packages/core/dist/telegram/client.js
+function createTelegramClient(opts) {
+  const fetchImpl = opts.fetch ?? fetch;
+  const base = `https://api.telegram.org/bot${opts.token}`;
+  async function call(method, body) {
+    const res = await fetchImpl(`${base}/${method}`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    const json = await res.json();
+    if (!res.ok || !json.ok) {
+      const code = json.error_code ?? res.status;
+      const desc = json.description ?? "unknown error";
+      throw new Error(`telegram ${method} failed (${code}): ${desc}`);
+    }
+    return json.result;
+  }
+  return {
+    async getMe() {
+      const r = await call("getMe", {});
+      return { id: r.id, username: r.username };
+    },
+    getUpdates(offset, timeoutSec = 50) {
+      return call("getUpdates", { offset, timeout: timeoutSec });
+    },
+    async sendMessage(chatId, threadId, text, replyMarkup) {
+      const body = { chat_id: chatId, text };
+      if (threadId !== void 0)
+        body.message_thread_id = threadId;
+      if (replyMarkup !== void 0)
+        body.reply_markup = replyMarkup;
+      await call("sendMessage", body);
+    },
+    async answerCallbackQuery(callbackQueryId, text) {
+      const body = { callback_query_id: callbackQueryId };
+      if (text !== void 0)
+        body.text = text;
+      await call("answerCallbackQuery", body);
+    },
+    async editMessageReplyMarkup(chatId, messageId, replyMarkup) {
+      await call("editMessageReplyMarkup", { chat_id: chatId, message_id: messageId, reply_markup: replyMarkup });
+    },
+    async createForumTopic(chatId, name) {
+      const r = await call("createForumTopic", { chat_id: chatId, name });
+      return r.message_thread_id;
+    },
+    async setMyCommands(commands) {
+      await call("setMyCommands", { commands });
+    }
+  };
+}
+var init_client = __esm({
+  "packages/core/dist/telegram/client.js"() {
+  }
+});
+
+// packages/core/dist/telegram/panels.js
+var init_panels = __esm({
+  "packages/core/dist/telegram/panels.js"() {
+  }
+});
+
+// packages/core/dist/telegram/tiers.js
+var DONE_ONLY, ALERTS;
+var init_tiers = __esm({
+  "packages/core/dist/telegram/tiers.js"() {
+    DONE_ONLY = /* @__PURE__ */ new Set(["task.done", "task.failed"]);
+    ALERTS = /* @__PURE__ */ new Set([
+      ...DONE_ONLY,
+      "task.blocked",
+      "task.approval.requested",
+      "task.input.requested",
+      "task.timeout"
+    ]);
+  }
+});
+
+// packages/core/dist/telegram/bridge.js
+import os3 from "os";
+import path9 from "path";
+var init_bridge = __esm({
+  "packages/core/dist/telegram/bridge.js"() {
+    init_dist();
+    init_auth();
+    init_commands();
+    init_format();
+    init_panels();
+    init_state();
+    init_tiers();
+  }
+});
+
+// packages/core/dist/telegram/setup.js
+import fs10 from "fs";
+function resolveSetupGroup(existingSupergroupId, opts) {
+  if (existingSupergroupId !== void 0 && !opts.redetect)
+    return "reuse";
+  return "detect";
+}
+async function detectGroupAndUser(client, opts = {}) {
+  const timeoutMs = opts.timeoutMs ?? 6e4;
+  const sleep2 = opts.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+  const deadline = Date.now() + timeoutMs;
+  let offset = 0;
+  while (Date.now() < deadline) {
+    const updates = await client.getUpdates(offset, 10);
+    for (const u of updates) {
+      if (u.update_id >= offset)
+        offset = u.update_id + 1;
+      if (u.message?.chat?.type === "supergroup") {
+        return { supergroupId: u.message.chat.id, userId: u.message.from?.id };
+      }
+    }
+    await sleep2(2e3);
+  }
+  throw new Error("Timed out waiting for the bot to receive a message in a supergroup");
+}
+function writeTelegramConfig(configPath, opts) {
+  let config;
+  let raw = null;
+  try {
+    raw = fs10.readFileSync(configPath, "utf-8");
+  } catch (err) {
+    if (err.code !== "ENOENT") {
+      throw new Error(`refusing to overwrite unreadable config at ${configPath}: ${String(err)}`);
+    }
+  }
+  if (raw !== null) {
+    try {
+      config = JSON.parse(raw);
+    } catch (err) {
+      throw new Error(`refusing to overwrite corrupt config at ${configPath}: ${String(err)}`);
+    }
+  } else {
+    config = {};
+  }
+  const prev = config.telegram && typeof config.telegram === "object" ? config.telegram : {};
+  const next = {
+    botToken: opts.token,
+    supergroupId: opts.supergroupId,
+    chats: [opts.supergroupId]
+  };
+  const users = opts.users ?? prev.users;
+  const remoteControl = opts.remoteControl ?? prev.remoteControl;
+  if (users !== void 0)
+    next.users = users;
+  if (remoteControl !== void 0)
+    next.remoteControl = remoteControl;
+  config.telegram = next;
+  fs10.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+}
+var init_setup = __esm({
+  "packages/core/dist/telegram/setup.js"() {
+  }
+});
+
+// packages/core/dist/telegram/index.js
+var init_telegram = __esm({
+  "packages/core/dist/telegram/index.js"() {
+    init_bot_commands();
+    init_auth();
+    init_commands();
+    init_ensure_captain();
+    init_format();
+    init_state();
+    init_client();
+    init_bridge();
+    init_setup();
+  }
+});
+
 // packages/core/dist/index.js
 var init_dist2 = __esm({
   "packages/core/dist/index.js"() {
@@ -1596,6 +1947,7 @@ var init_dist2 = __esm({
     init_session_freshness();
     init_crew_protocol();
     init_crew_lifecycle();
+    init_telegram();
   }
 });
 
@@ -2114,13 +2466,13 @@ var init_notifiers = __esm({
 });
 
 // packages/workspaces/dist/workspaces/obsidian.js
-import fs8 from "fs/promises";
+import fs11 from "fs/promises";
 import { existsSync as existsSync8 } from "fs";
-import path7 from "path";
+import path10 from "path";
 function resolveInRoot(root, relative) {
-  const joined = path7.resolve(root, relative);
-  const normalized = path7.resolve(root) + path7.sep;
-  if (joined !== path7.resolve(root) && !joined.startsWith(normalized)) {
+  const joined = path10.resolve(root, relative);
+  const normalized = path10.resolve(root) + path10.sep;
+  if (joined !== path10.resolve(root) && !joined.startsWith(normalized)) {
     throw new Error(`Path '${relative}' escapes workspace root`);
   }
   return joined;
@@ -2139,16 +2491,16 @@ function createObsidianDriver(scope) {
       };
     },
     async read(rel) {
-      return fs8.readFile(resolveInRoot(root, rel), "utf-8");
+      return fs11.readFile(resolveInRoot(root, rel), "utf-8");
     },
     async write(rel, content) {
       const abs = resolveInRoot(root, rel);
-      await fs8.mkdir(path7.dirname(abs), { recursive: true });
-      await fs8.writeFile(abs, content);
+      await fs11.mkdir(path10.dirname(abs), { recursive: true });
+      await fs11.writeFile(abs, content);
     },
     async exists(rel) {
       try {
-        await fs8.access(resolveInRoot(root, rel));
+        await fs11.access(resolveInRoot(root, rel));
         return true;
       } catch {
         return false;
@@ -2156,13 +2508,13 @@ function createObsidianDriver(scope) {
     },
     async list(rel) {
       try {
-        return await fs8.readdir(resolveInRoot(root, rel));
+        return await fs11.readdir(resolveInRoot(root, rel));
       } catch {
         return [];
       }
     },
     async mkdir(rel) {
-      await fs8.mkdir(resolveInRoot(root, rel), { recursive: true });
+      await fs11.mkdir(resolveInRoot(root, rel), { recursive: true });
     }
   };
 }
@@ -2831,8 +3183,8 @@ var init_registry4 = __esm({
 });
 
 // packages/agents/dist/drivers/launch-cmd.js
-import fs9 from "fs";
-import path8 from "path";
+import fs12 from "fs";
+import path11 from "path";
 function buildAgentCmd(agentName, registry, role, fresh, permissionMode, model, templatesDir) {
   const driver = registry.getDriver(agentName);
   if (driver.name === "claude") {
@@ -2848,27 +3200,27 @@ function buildAgentCmd(agentName, registry, role, fresh, permissionMode, model,
       cmd += ` --model ${model}`;
     }
     if (templatesDir) {
-      const roleFile2 = path8.join(templatesDir, `${role}.claude.md`);
-      const legacyRoleFile = path8.join(templatesDir, `${role}.CLAUDE.md`);
-      const actualRoleFile = fs9.existsSync(roleFile2) ? roleFile2 : fs9.existsSync(legacyRoleFile) ? legacyRoleFile : null;
+      const roleFile2 = path11.join(templatesDir, `${role}.claude.md`);
+      const legacyRoleFile = path11.join(templatesDir, `${role}.CLAUDE.md`);
+      const actualRoleFile = fs12.existsSync(roleFile2) ? roleFile2 : fs12.existsSync(legacyRoleFile) ? legacyRoleFile : null;
       if (actualRoleFile) {
         cmd += ` --append-system-prompt-file ${actualRoleFile}`;
       }
-      const pluginDir = path8.join(templatesDir, "..", "plugin");
-      if (fs9.existsSync(pluginDir)) {
+      const pluginDir = path11.join(templatesDir, "..", "plugin");
+      if (fs12.existsSync(pluginDir)) {
         cmd += ` --plugin-dir ${pluginDir}`;
       }
     }
     return cmd;
   }
-  const roleFile = templatesDir ? path8.join(templatesDir, `${role}.${driver.templateSuffix}.md`) : void 0;
+  const roleFile = templatesDir ? path11.join(templatesDir, `${role}.${driver.templateSuffix}.md`) : void 0;
   return driver.buildCommand({
     prompt: `You are a squadrant ${role}. Read your instructions from ${roleFile ?? role} and begin.`,
     workdir: process.cwd(),
     role,
     model,
     autoApprove: true,
-    promptFile: roleFile && fs9.existsSync(roleFile) ? roleFile : void 0
+    promptFile: roleFile && fs12.existsSync(roleFile) ? roleFile : void 0
   });
 }
 var init_launch_cmd = __esm({
@@ -2891,8 +3243,8 @@ var init_drivers = __esm({
 
 // packages/agents/dist/projection/cursor.js
 import { mkdir, readFile, writeFile } from "fs/promises";
-import path9 from "path";
-import os2 from "os";
+import path12 from "path";
+import os4 from "os";
 function renderMdc(source) {
   const skillSections = source.skills.map((s) => `## Skill: ${s.name}
 
@@ -2940,7 +3292,7 @@ function createCursorEmitter() {
       if (scope === "user") {
         return [
           {
-            path: path9.join(os2.homedir(), ".cursor/rules/squadrant-global.mdc"),
+            path: path12.join(os4.homedir(), ".cursor/rules/squadrant-global.mdc"),
             shared: false,
             format: "mdc"
           }
@@ -2950,7 +3302,7 @@ function createCursorEmitter() {
         return [];
       return [
         {
-          path: path9.join(projectRoot, ".cursor/rules/squadrant.mdc"),
+          path: path12.join(projectRoot, ".cursor/rules/squadrant.mdc"),
           shared: false,
           format: "mdc"
         }
@@ -2967,7 +3319,7 @@ function createCursorEmitter() {
           diff: buildDiff(existing, generated)
         };
       }
-      await mkdir(path9.dirname(dest.path), { recursive: true });
+      await mkdir(path12.dirname(dest.path), { recursive: true });
       await writeFile(dest.path, generated, "utf-8");
       return {
         written: true,
@@ -3018,8 +3370,8 @@ var init_marker = __esm({
 
 // packages/agents/dist/projection/codex.js
 import { mkdir as mkdir2, readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
-import path10 from "path";
-import os3 from "os";
+import path13 from "path";
+import os5 from "os";
 function renderMarkdown(source) {
   const skillSections = source.skills.map((s) => `## Skill: ${s.name}
 
@@ -3043,7 +3395,7 @@ function createCodexEmitter() {
     destinations(scope, projectRoot) {
       if (scope === "user") {
         return [{
-          path: path10.join(os3.homedir(), ".codex/AGENTS.md"),
+          path: path13.join(os5.homedir(), ".codex/AGENTS.md"),
           shared: true,
           format: "markdown"
         }];
@@ -3051,7 +3403,7 @@ function createCodexEmitter() {
       if (!projectRoot)
         return [];
       return [{
-        path: path10.join(projectRoot, "AGENTS.md"),
+        path: path13.join(projectRoot, "AGENTS.md"),
         shared: true,
         format: "markdown"
       }];
@@ -3072,7 +3424,7 @@ ${existing ?? ""}
 ${generated}`
         };
       }
-      await mkdir2(path10.dirname(dest.path), { recursive: true });
+      await mkdir2(path13.dirname(dest.path), { recursive: true });
       await writeFile2(dest.path, generated, "utf-8");
       return {
         written: true,
@@ -3090,8 +3442,8 @@ var init_codex2 = __esm({
 
 // packages/agents/dist/projection/gemini.js
 import { mkdir as mkdir3, readFile as readFile3, writeFile as writeFile3 } from "fs/promises";
-import path11 from "path";
-import os4 from "os";
+import path14 from "path";
+import os6 from "os";
 function renderMarkdown2(source) {
   const skillSections = source.skills.map((s) => `## Skill: ${s.name}
 
@@ -3115,7 +3467,7 @@ function createGeminiEmitter() {
     destinations(scope, projectRoot) {
       if (scope === "user") {
         return [{
-          path: path11.join(os4.homedir(), ".gemini/GEMINI.md"),
+          path: path14.join(os6.homedir(), ".gemini/GEMINI.md"),
           shared: true,
           format: "markdown"
         }];
@@ -3123,7 +3475,7 @@ function createGeminiEmitter() {
       if (!projectRoot)
         return [];
       return [{
-        path: path11.join(projectRoot, "GEMINI.md"),
+        path: path14.join(projectRoot, "GEMINI.md"),
         shared: true,
         format: "markdown"
       }];
@@ -3144,7 +3496,7 @@ ${existing ?? ""}
 ${generated}`
         };
       }
-      await mkdir3(path11.dirname(dest.path), { recursive: true });
+      await mkdir3(path14.dirname(dest.path), { recursive: true });
       await writeFile3(dest.path, generated, "utf-8");
       return {
         written: true,
@@ -3162,8 +3514,8 @@ var init_gemini2 = __esm({
 
 // packages/agents/dist/projection/opencode.js
 import { mkdir as mkdir4, readFile as readFile4, writeFile as writeFile4 } from "fs/promises";
-import path12 from "path";
-import os5 from "os";
+import path15 from "path";
+import os7 from "os";
 function renderMarkdown3(source) {
   const skillSections = source.skills.map((s) => `## Skill: ${s.name}
 
@@ -3187,7 +3539,7 @@ function createOpencodeEmitter() {
     destinations(scope, projectRoot) {
       if (scope === "user") {
         return [{
-          path: path12.join(os5.homedir(), ".config", "opencode", "AGENTS.md"),
+          path: path15.join(os7.homedir(), ".config", "opencode", "AGENTS.md"),
           shared: true,
           format: "markdown"
         }];
@@ -3195,7 +3547,7 @@ function createOpencodeEmitter() {
       if (!projectRoot)
         return [];
       return [{
-        path: path12.join(projectRoot, "AGENTS.md"),
+        path: path15.join(projectRoot, "AGENTS.md"),
         shared: true,
         format: "markdown"
       }];
@@ -3216,7 +3568,7 @@ ${existing ?? ""}
 ${generated}`
         };
       }
-      await mkdir4(path12.dirname(dest.path), { recursive: true });
+      await mkdir4(path15.dirname(dest.path), { recursive: true });
       await writeFile4(dest.path, generated, "utf-8");
       return {
         written: true,
@@ -4081,8 +4433,8 @@ function resolveLastAssistantText(payload) {
   const derived = deriveTranscriptPath(p?.session_id, cwd);
   if (derived)
     candidates.push(derived);
-  for (const path26 of candidates) {
-    const text = readLastAssistantText(path26);
+  for (const path29 of candidates) {
+    const text = readLastAssistantText(path29);
     if (text != null)
       return text;
   }
@@ -4481,11 +4833,11 @@ var init_dist4 = __esm({
 // packages/cli/src/index.ts
 init_dist();
 init_dist2();
-import { Command as Command27 } from "commander";
-import { readFileSync as readFileSync11, existsSync as existsSync10, writeFileSync as writeFileSync9 } from "fs";
+import { Command as Command28 } from "commander";
+import { readFileSync as readFileSync11, existsSync as existsSync11, writeFileSync as writeFileSync9 } from "fs";
 import { fileURLToPath as fileURLToPath6 } from "url";
-import { dirname as dirname6, join as join21 } from "path";
-import { homedir as homedir14 } from "os";
+import { dirname as dirname7, join as join23 } from "path";
+import { homedir as homedir15 } from "os";
 
 // packages/cli/src/commands/doctor.ts
 init_dist();
@@ -4494,9 +4846,9 @@ init_dist();
 init_dist3();
 import { Command } from "commander";
 import { execSync as execSync8 } from "child_process";
-import fs10 from "fs";
+import fs13 from "fs";
 import { stat } from "fs/promises";
-import path13 from "path";
+import path16 from "path";
 import chalk3 from "chalk";
 
 // packages/cli/src/commands/health-view.ts
@@ -4598,7 +4950,7 @@ function settingsHaveAgentTeams() {
   try {
     const home = process.env.HOME || "";
     const settings = JSON.parse(
-      fs10.readFileSync(`${home}/.claude/settings.json`, "utf-8")
+      fs13.readFileSync(`${home}/.claude/settings.json`, "utf-8")
     );
     return settings?.env?.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS === "1";
   } catch {
@@ -4609,7 +4961,7 @@ function pluginInstalled(pluginKey) {
   try {
     const home = process.env.HOME || "";
     const plugins = JSON.parse(
-      fs10.readFileSync(
+      fs13.readFileSync(
         `${home}/.claude/plugins/installed_plugins.json`,
         "utf-8"
       )
@@ -4641,7 +4993,7 @@ var doctorCommand = new Command("doctor").description("Check system health and p
   const results = [];
   results.push(check("Claude Code installed", commandExists("claude")));
   results.push(check(`Claude Code version >= ${compatManifest.tools.claude.min}`, claudeVersionOk()));
-  results.push(check("Obsidian installed", commandExists("obsidian") || fs10.existsSync("/Applications/Obsidian.app")));
+  results.push(check("Obsidian installed", commandExists("obsidian") || fs13.existsSync("/Applications/Obsidian.app")));
   results.push(check("Node.js >= 18", nodeVersionOk()));
   results.push(
     check(
@@ -4714,7 +5066,7 @@ var doctorCommand = new Command("doctor").description("Check system health and p
     const emitter = projectionRegistry.get(name);
     const [userDest] = emitter.destinations("user");
     if (!userDest) continue;
-    const dir = path13.dirname(userDest.path);
+    const dir = path16.dirname(userDest.path);
     let status;
     try {
       await stat(dir);
@@ -4727,7 +5079,7 @@ var doctorCommand = new Command("doctor").description("Check system health and p
   results.push(
     check(
       "Squadrant config exists",
-      fs10.existsSync(
+      fs13.existsSync(
         process.env.SQUADRANT_CONFIG || `${process.env.HOME}/.config/squadrant/config.json`
       )
     )
@@ -4800,39 +5152,39 @@ init_dist();
 init_dist3();
 init_dist();
 import { Command as Command2 } from "commander";
-import fs11 from "fs";
-import path14 from "path";
-import os6 from "os";
+import fs14 from "fs";
+import path17 from "path";
+import os8 from "os";
 import chalk4 from "chalk";
 function findPackageRoot() {
-  let dir = path14.dirname(new URL(import.meta.url).pathname);
+  let dir = path17.dirname(new URL(import.meta.url).pathname);
   while (dir !== "/") {
-    if (fs11.existsSync(path14.join(dir, "package.json"))) return dir;
-    dir = path14.dirname(dir);
+    if (fs14.existsSync(path17.join(dir, "package.json"))) return dir;
+    dir = path17.dirname(dir);
   }
   return process.cwd();
 }
 function copyDirRecursive(src, dest) {
-  fs11.mkdirSync(dest, { recursive: true });
-  for (const entry of fs11.readdirSync(src, { withFileTypes: true })) {
-    const srcPath = path14.join(src, entry.name);
-    const destPath = path14.join(dest, entry.name);
+  fs14.mkdirSync(dest, { recursive: true });
+  for (const entry of fs14.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path17.join(src, entry.name);
+    const destPath = path17.join(dest, entry.name);
     if (entry.isDirectory()) {
       copyDirRecursive(srcPath, destPath);
     } else {
-      fs11.copyFileSync(srcPath, destPath);
+      fs14.copyFileSync(srcPath, destPath);
     }
   }
 }
 var initCommand = new Command2("init").description("First-time setup: scaffold hub vault, scripts, and config").option("--hub <path>", "Hub vault path", "~/squadrant-hub").action((opts) => {
   const hubPath = resolveHome(opts.hub);
   const pkgRoot = findPackageRoot();
-  const configDir = path14.join(os6.homedir(), ".config", "squadrant");
+  const configDir = path17.join(os8.homedir(), ".config", "squadrant");
   console.log(chalk4.bold("\nSquadrant Init\n"));
   const registry = new WorkspaceRegistry({ obsidian: createObsidianDriver });
   try {
-    if (fs11.existsSync(DEFAULT_CONFIG_PATH)) {
-      const existing = JSON.parse(fs11.readFileSync(DEFAULT_CONFIG_PATH, "utf-8"));
+    if (fs14.existsSync(DEFAULT_CONFIG_PATH)) {
+      const existing = JSON.parse(fs14.readFileSync(DEFAULT_CONFIG_PATH, "utf-8"));
       const wsName = existing.workspace ?? "obsidian";
       registry.get(wsName);
     }
@@ -4840,7 +5192,7 @@ var initCommand = new Command2("init").description("First-time setup: scaffold h
     console.log(chalk4.red(`  \u2718 ${err.message}`));
     return;
   }
-  if (fs11.existsSync(DEFAULT_CONFIG_PATH)) {
+  if (fs14.existsSync(DEFAULT_CONFIG_PATH)) {
     console.log(chalk4.yellow("  \u26A0 Config already exists, skipping creation"));
   } else {
     const config = getDefaultConfig();
@@ -4848,37 +5200,37 @@ var initCommand = new Command2("init").description("First-time setup: scaffold h
     saveConfig(config);
     console.log(chalk4.green(`  \u2714 Config created at ${DEFAULT_CONFIG_PATH}`));
   }
-  const hubTemplate = path14.join(pkgRoot, "obsidian", "hub");
-  if (fs11.existsSync(hubPath)) {
+  const hubTemplate = path17.join(pkgRoot, "obsidian", "hub");
+  if (fs14.existsSync(hubPath)) {
     console.log(chalk4.yellow(`  \u26A0 Hub vault already exists at ${hubPath}, skipping`));
-  } else if (fs11.existsSync(hubTemplate)) {
+  } else if (fs14.existsSync(hubTemplate)) {
     copyDirRecursive(hubTemplate, hubPath);
     console.log(chalk4.green(`  \u2714 Hub vault scaffolded at ${hubPath}`));
   } else {
-    fs11.mkdirSync(hubPath, { recursive: true });
+    fs14.mkdirSync(hubPath, { recursive: true });
     console.log(chalk4.yellow(`  \u26A0 Hub template not found; created empty dir at ${hubPath}`));
   }
-  const hubDashboardSrc = path14.join(pkgRoot, "obsidian", "hub", "dashboard.md");
-  const hubDashboardDest = path14.join(hubPath, "dashboard.md");
-  if (fs11.existsSync(hubDashboardSrc)) {
-    fs11.copyFileSync(hubDashboardSrc, hubDashboardDest);
+  const hubDashboardSrc = path17.join(pkgRoot, "obsidian", "hub", "dashboard.md");
+  const hubDashboardDest = path17.join(hubPath, "dashboard.md");
+  if (fs14.existsSync(hubDashboardSrc)) {
+    fs14.copyFileSync(hubDashboardSrc, hubDashboardDest);
     console.log(chalk4.green(`  \u2714 Dashboard page refreshed at ${hubDashboardDest}`));
   }
-  const projectsDir = path14.join(hubPath, "projects");
-  fs11.mkdirSync(projectsDir, { recursive: true });
+  const projectsDir = path17.join(hubPath, "projects");
+  fs14.mkdirSync(projectsDir, { recursive: true });
   ensureRuntimeSynced({ sourceRoot: pkgRoot, runtimeRoot: configDir });
   console.log(chalk4.green(`  \u2714 Runtime assets synced to ${configDir}`));
-  const settingsPath = path14.join(os6.homedir(), ".claude", "settings.json");
+  const settingsPath = path17.join(os8.homedir(), ".claude", "settings.json");
   try {
     let settings = {};
-    if (fs11.existsSync(settingsPath)) {
-      settings = JSON.parse(fs11.readFileSync(settingsPath, "utf-8"));
+    if (fs14.existsSync(settingsPath)) {
+      settings = JSON.parse(fs14.readFileSync(settingsPath, "utf-8"));
     }
     const env = settings.env || {};
     if (env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS !== "1") {
       settings.env = { ...env, CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: "1" };
-      fs11.mkdirSync(path14.dirname(settingsPath), { recursive: true });
-      fs11.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+      fs14.mkdirSync(path17.dirname(settingsPath), { recursive: true });
+      fs14.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
       console.log(chalk4.green("  \u2714 Agent Teams enabled in ~/.claude/settings.json"));
     } else {
       console.log(chalk4.green("  \u2714 Agent Teams already enabled"));
@@ -4899,7 +5251,7 @@ var initCommand = new Command2("init").description("First-time setup: scaffold h
   console.log(chalk4.cyan(`       ${hubPath}`));
   console.log("");
   console.log("  4. Run " + chalk4.cyan("squadrant doctor") + " to verify setup\n");
-  if (!fs11.existsSync("/Applications/cmux.app")) {
+  if (!fs14.existsSync("/Applications/cmux.app")) {
     console.log(chalk4.yellow("  \u26A0 cmux not found \u2014 download from https://cmux.dev\n"));
   }
 });
@@ -4907,26 +5259,70 @@ var initCommand = new Command2("init").description("First-time setup: scaffold h
 // packages/cli/src/commands/projects.ts
 init_dist();
 import { Command as Command3 } from "commander";
-import fs12 from "fs";
-import path15 from "path";
+import fs15 from "fs";
+import path18 from "path";
 import chalk5 from "chalk";
+
+// packages/cli/src/control/restart-daemon.ts
+init_dist2();
+import { execFileSync as execFileSync6 } from "child_process";
+import { existsSync as existsSync9 } from "fs";
+import { homedir as homedir9 } from "os";
+import { join as join14 } from "path";
+var DEFAULT_SOCK_PATH = join14(homedir9(), ".config", "squadrant", "squadrant.sock");
+function defaultIsRunning() {
+  return existsSync9(DEFAULT_SOCK_PATH);
+}
+function defaultRunKickstart() {
+  const uid = process.getuid?.() ?? 0;
+  const target = `gui/${uid}/${LABEL}`;
+  if (tryAcquireDaemonLock()) {
+    try {
+      execFileSync6("launchctl", kickstartArgv(target, true), { stdio: "ignore" });
+    } finally {
+      releaseDaemonLock();
+    }
+  }
+}
+function restartDaemonIfRunning(opts) {
+  const env = opts.env ?? process.env;
+  if (env["VITEST"] || opts.noRestart) return "skipped-opt-out";
+  const isRunning = opts.isRunning ?? defaultIsRunning;
+  if (!isRunning()) return "skipped-not-running";
+  const log = opts.log ?? console.log;
+  log(`\u21BB restarting daemon to apply ${opts.reason}\u2026`);
+  const runKickstart = opts.runKickstart ?? defaultRunKickstart;
+  runKickstart();
+  return "restarted";
+}
+
+// packages/cli/src/commands/projects.ts
+function restartAfterProjectsAdd(opts) {
+  const doRestart = opts.doRestart ?? restartDaemonIfRunning;
+  const outcome = doRestart({ reason: "project registration", noRestart: opts.noRestart });
+  if (outcome === "skipped-not-running") {
+    console.log(chalk5.dim("  (daemon not running \u2014 change applies on next start)"));
+  } else if (outcome === "skipped-opt-out") {
+    console.log(chalk5.dim("  (run 'squadrant heal daemon' to apply)"));
+  }
+}
 function findPackageRoot2() {
-  let dir = path15.dirname(new URL(import.meta.url).pathname);
+  let dir = path18.dirname(new URL(import.meta.url).pathname);
   while (dir !== "/") {
-    if (fs12.existsSync(path15.join(dir, "package.json"))) return dir;
-    dir = path15.dirname(dir);
+    if (fs15.existsSync(path18.join(dir, "package.json"))) return dir;
+    dir = path18.dirname(dir);
   }
   return process.cwd();
 }
 function copyDirRecursive2(src, dest) {
-  fs12.mkdirSync(dest, { recursive: true });
-  for (const entry of fs12.readdirSync(src, { withFileTypes: true })) {
-    const srcPath = path15.join(src, entry.name);
-    const destPath = path15.join(dest, entry.name);
+  fs15.mkdirSync(dest, { recursive: true });
+  for (const entry of fs15.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path18.join(src, entry.name);
+    const destPath = path18.join(dest, entry.name);
     if (entry.isDirectory()) {
       copyDirRecursive2(srcPath, destPath);
     } else {
-      fs12.copyFileSync(srcPath, destPath);
+      fs15.copyFileSync(srcPath, destPath);
     }
   }
 }
@@ -4953,7 +5349,7 @@ var listCmd = new Command3("list").description("List registered projects").actio
   }
   console.log("");
 });
-var addCmd = new Command3("add").description("Register a project").argument("<name>", "Project name").argument("<path>", "Path to project directory").option("--captain <name>", "Captain workspace name (default: <project>-captain)").option("--spoke <path>", "Spoke vault path (default: ~/squadrant-hub/spokes/<name>)").option("--group <name>", "Project group name (siblings share context)").option("--group-role <role>", "Role within the group (auto-set to 'primary' if first in group)").action((name, projectPath, opts) => {
+var addCmd = new Command3("add").description("Register a project").argument("<name>", "Project name").argument("<path>", "Path to project directory").option("--captain <name>", "Captain workspace name (default: <project>-captain)").option("--spoke <path>", "Spoke vault path (default: ~/squadrant-hub/spokes/<name>)").option("--group <name>", "Project group name (siblings share context)").option("--group-role <role>", "Role within the group (auto-set to 'primary' if first in group)").option("--no-restart", "skip daemon restart after registration").action((name, projectPath, opts) => {
   const config = loadConfig();
   if (config.projects[name]) {
     console.log(chalk5.yellow(`
@@ -4962,7 +5358,7 @@ var addCmd = new Command3("add").description("Register a project").argument("<na
     process.exit(1);
   }
   const resolvedPath = resolveHome(projectPath);
-  if (!fs12.existsSync(path15.join(resolvedPath, ".git"))) {
+  if (!fs15.existsSync(path18.join(resolvedPath, ".git"))) {
     console.log(chalk5.yellow(`
   \u26A0 No .git found at ${resolvedPath}. Make sure this is the project root, not a parent directory.
 `));
@@ -5015,7 +5411,7 @@ var addCmd = new Command3("add").description("Register a project").argument("<na
   \u26A0 Group '${group}' already has '${primary[0]}' as primary. Overriding.`));
     }
   }
-  const spokeVault = opts.spoke ? resolveHome(opts.spoke) : path15.join(config.hubVault, "spokes", name);
+  const spokeVault = opts.spoke ? resolveHome(opts.spoke) : path18.join(config.hubVault, "spokes", name);
   const project = {
     path: resolvedPath,
     captainName,
@@ -5028,21 +5424,22 @@ var addCmd = new Command3("add").description("Register a project").argument("<na
   saveConfig(config);
   console.log(chalk5.green(`
   \u2714 Project '${name}' registered`));
+  restartAfterProjectsAdd({ noRestart: opts.restart === false });
   const pkgRoot = findPackageRoot2();
-  const spokeTemplate = path15.join(pkgRoot, "obsidian", "spoke");
-  if (fs12.existsSync(spokeVault)) {
+  const spokeTemplate = path18.join(pkgRoot, "obsidian", "spoke");
+  if (fs15.existsSync(spokeVault)) {
     console.log(chalk5.yellow(`  \u26A0 Spoke vault already exists at ${spokeVault}, skipping scaffold`));
-  } else if (fs12.existsSync(spokeTemplate)) {
+  } else if (fs15.existsSync(spokeTemplate)) {
     copyDirRecursive2(spokeTemplate, spokeVault);
-    const statusPath = path15.join(spokeVault, "status.md");
-    if (fs12.existsSync(statusPath)) {
-      const content = fs12.readFileSync(statusPath, "utf-8");
+    const statusPath = path18.join(spokeVault, "status.md");
+    if (fs15.existsSync(statusPath)) {
+      const content = fs15.readFileSync(statusPath, "utf-8");
       const updated = content.replace(/^project: unnamed/m, `project: ${name}`);
-      fs12.writeFileSync(statusPath, updated);
+      fs15.writeFileSync(statusPath, updated);
     }
     console.log(chalk5.green(`  \u2714 Spoke vault scaffolded at ${spokeVault}`));
   } else {
-    fs12.mkdirSync(spokeVault, { recursive: true });
+    fs15.mkdirSync(spokeVault, { recursive: true });
     console.log(chalk5.yellow(`  \u26A0 Spoke template not found; created empty dir at ${spokeVault}`));
   }
   console.log("");
@@ -5143,10 +5540,10 @@ init_dist4();
 init_dist();
 import { Command as Command5 } from "commander";
 import { execSync as execSync9 } from "child_process";
-import path16 from "path";
-import os7 from "os";
+import path19 from "path";
+import os9 from "os";
 import chalk7 from "chalk";
-var TEMPLATES_DIR = path16.join(os7.homedir(), ".config", "squadrant", "templates");
+var TEMPLATES_DIR = path19.join(os9.homedir(), ".config", "squadrant", "templates");
 var TASK_PROMPTS = {
   briefing: "Run your daily briefing using the squadrant:command-ops skill. Read all spoke handoffs, yesterday's logs, current status; produce a concise cross-project briefing; save to {hubVault}/daily-logs/YYYY-MM-DD.md; then exit.",
   "learnings-review": "Run a learnings review using the squadrant:command-ops skill. Scan {spokeVault}/learnings across all projects, identify cross-project patterns, propose captured-skill or fix actions, and exit when done.",
@@ -5179,7 +5576,7 @@ async function runCommandSpawn(input) {
   if (!agent) {
     throw new Error(`Unknown agent '${agentName}'. Known: claude, codex, gemini, opencode.`);
   }
-  const promptFile = path16.join(TEMPLATES_DIR, `command.${agent.templateSuffix}.md`);
+  const promptFile = path19.join(TEMPLATES_DIR, `command.${agent.templateSuffix}.md`);
   const cliCommand = agent.buildCommand({
     prompt,
     workdir: process.cwd(),
@@ -5206,9 +5603,9 @@ var commandCommand = new Command5("command").description("Spawn a one-shot Comma
 init_dist();
 init_dist();
 import { Command as Command9 } from "commander";
-import fs13 from "fs";
-import path17 from "path";
-import os8 from "os";
+import fs16 from "fs";
+import path20 from "path";
+import os10 from "os";
 import chalk9 from "chalk";
 
 // packages/cli/src/control/crew-routing.ts
@@ -5241,8 +5638,8 @@ init_dist4();
 import { Command as Command8 } from "commander";
 import { createConnection as createConnection3 } from "net";
 import { randomUUID as randomUUID3 } from "crypto";
-import { homedir as homedir10 } from "os";
-import { join as join15 } from "path";
+import { homedir as homedir11 } from "os";
+import { join as join16 } from "path";
 import { mkdirSync as mkdirSync6, writeFileSync as writeFileSync7 } from "fs";
 
 // packages/cli/src/commands/crew-output.ts
@@ -5301,11 +5698,11 @@ init_dist2();
 import { Command as Command6 } from "commander";
 import chalk8 from "chalk";
 import { createConnection as createConnection2 } from "net";
-import { homedir as homedir9 } from "os";
-import { join as join14 } from "path";
+import { homedir as homedir10 } from "os";
+import { join as join15 } from "path";
 import { createInterface } from "readline";
 function socketPath() {
-  return process.env.SQUADRANTD_SOCK ?? join14(homedir9(), ".config", "squadrant", "squadrant.sock");
+  return process.env.SQUADRANTD_SOCK ?? join15(homedir10(), ".config", "squadrant", "squadrant.sock");
 }
 function rule(width, ch = "\u2500") {
   return ch.repeat(Math.max(0, width));
@@ -5541,7 +5938,7 @@ var crewChatCommand = new Command7("chat").description("[DEPRECATED] alias for `
 });
 
 // packages/cli/src/commands/crew-control.ts
-var SOCK2 = join15(homedir10(), ".config", "squadrant", "squadrant.sock");
+var SOCK2 = join16(homedir11(), ".config", "squadrant", "squadrant.sock");
 var CODEX_FIRST_TURN_DELAY_MS = 1500;
 async function sendCodexFirstTurn(taskId, text) {
   await new Promise((r) => setTimeout(r, CODEX_FIRST_TURN_DELAY_MS));
@@ -5646,9 +6043,9 @@ function buildSignalRequest(signal, o) {
   return { kind: "event", project, event };
 }
 function defaultWriteResult(id, payload) {
-  const dir = join15(homedir10(), ".config", "squadrant", "state", "_results");
+  const dir = join16(homedir11(), ".config", "squadrant", "state", "_results");
   mkdirSync6(dir, { recursive: true });
-  const file = join15(dir, `${id}.txt`);
+  const file = join16(dir, `${id}.txt`);
   writeFileSync7(file, payload);
   return file;
 }
@@ -5749,7 +6146,7 @@ addControlPlaneCrewCommands(crewControlCommand);
 // packages/cli/src/lib/per-crew-settings.ts
 init_dist4();
 import { mkdirSync as mkdirSync7, readFileSync as readFileSync9, writeFileSync as writeFileSync8 } from "fs";
-import { join as join16 } from "path";
+import { join as join17 } from "path";
 var CREW_PERMISSION_ALLOWLIST = [
   // git — read + safe mutations (reset/clean/config intentionally excluded)
   "Bash(git status:*)",
@@ -5837,9 +6234,9 @@ function mergeCrewPermissions(settings) {
   return next;
 }
 function writePerCrewSettingsLocal(o) {
-  const dir = join16(o.projectCwd, ".claude");
+  const dir = join17(o.projectCwd, ".claude");
   mkdirSync7(dir, { recursive: true });
-  const file = join16(dir, "settings.local.json");
+  const file = join17(dir, "settings.local.json");
   let existing = {};
   try {
     const raw = readFileSync9(file, "utf-8");
@@ -5852,9 +6249,9 @@ function writePerCrewSettingsLocal(o) {
   return file;
 }
 function writePerCrewOpencodeConfig(o) {
-  const dir = join16(o.stateRoot, o.project, o.taskId);
+  const dir = join17(o.stateRoot, o.project, o.taskId);
   mkdirSync7(dir, { recursive: true });
-  const file = join16(dir, "opencode.json");
+  const file = join17(dir, "opencode.json");
   const config = {
     permission: {
       read: "allow",
@@ -5875,7 +6272,7 @@ function writePerCrewOpencodeConfig(o) {
 
 // packages/cli/src/commands/crew.ts
 init_dist2();
-var TEMPLATES_DIR2 = path17.join(os8.homedir(), ".config", "squadrant", "templates");
+var TEMPLATES_DIR2 = path20.join(os10.homedir(), ".config", "squadrant", "templates");
 async function runCrewSpawn(input) {
   const config = loadConfig();
   const proj = config.projects[input.project];
@@ -5923,8 +6320,8 @@ async function runCrewSpawn(input) {
     throw new Error(`Unknown agent '${agentName}'. Known: claude, codex, gemini, opencode.`);
   }
   if (agentName === "codex") {
-    const codexRoleFile = path17.join(TEMPLATES_DIR2, `crew.${agent.templateSuffix}.md`);
-    const roleInstructions = fs13.existsSync(codexRoleFile) ? fs13.readFileSync(codexRoleFile, "utf8") : void 0;
+    const codexRoleFile = path20.join(TEMPLATES_DIR2, `crew.${agent.templateSuffix}.md`);
+    const roleInstructions = fs16.existsSync(codexRoleFile) ? fs16.readFileSync(codexRoleFile, "utf8") : void 0;
     return runCodexInteractiveSpawn({
       project: input.project,
       task: input.task,
@@ -5937,7 +6334,7 @@ async function runCrewSpawn(input) {
       roleInstructions
     });
   }
-  const promptFile = path17.join(TEMPLATES_DIR2, `crew.${agent.templateSuffix}.md`);
+  const promptFile = path20.join(TEMPLATES_DIR2, `crew.${agent.templateSuffix}.md`);
   const interactive = agent.name === "claude" || agent.name === "opencode";
   const crewRole = config.defaults.roles?.crew;
   const configModel = crewRole && crewRole.agent === agent.name ? crewRole.model : void 0;
@@ -5994,7 +6391,7 @@ ${buildCompletionProtocol(rec.id, input.project)}`, preLaunchScreen);
     });
     const rec = await squadrantdCall(req);
     const opencodeConfigPath = writePerCrewOpencodeConfig({
-      stateRoot: path17.join(os8.homedir(), ".config", "squadrant", "state"),
+      stateRoot: path20.join(os10.homedir(), ".config", "squadrant", "state"),
       project: input.project,
       taskId: rec.id,
       // CP3 opt-in: --approval gates bash so the captain approves shell commands.
@@ -6234,11 +6631,11 @@ init_dist3();
 init_dist();
 init_dist();
 import { Command as Command10 } from "commander";
-import fs14 from "fs";
-import path18 from "path";
-import os9 from "os";
+import fs17 from "fs";
+import path21 from "path";
+import os11 from "os";
 import chalk10 from "chalk";
-var TEMPLATES_DIR3 = path18.join(os9.homedir(), ".config", "squadrant", "templates");
+var TEMPLATES_DIR3 = path21.join(os11.homedir(), ".config", "squadrant", "templates");
 var SIDE_ROLES = ["research", "debug"];
 function shellQuote2(p) {
   return "'" + p.replace(/'/g, "'\\''") + "'";
@@ -6329,7 +6726,7 @@ async function runSideSpawn(input) {
     throw new Error(`Unknown agent '${agentName}'. Known: claude, codex, gemini, opencode.`);
   }
   const sideModel = sideRole?.model;
-  const promptFile = path18.join(
+  const promptFile = path21.join(
     TEMPLATES_DIR3,
     `side.${input.role}.${agent.templateSuffix}.md`
   );
@@ -6340,7 +6737,7 @@ async function runSideSpawn(input) {
     prompt: input.topic,
     workdir: spawnCwd,
     role: "side",
-    promptFile: fs14.existsSync(promptFile) ? promptFile : void 0,
+    promptFile: fs17.existsSync(promptFile) ? promptFile : void 0,
     interactive: true,
     permissionMode: config.defaults.permissions?.crew ?? "auto",
     ...sideModel ? { model: sideModel } : {}
@@ -6397,7 +6794,7 @@ async function runSideClose(project, name) {
       project,
       name
     );
-    if (fs14.existsSync(wtPath)) {
+    if (fs17.existsSync(wtPath)) {
       try {
         removeWorktree(proj.path, wtPath);
       } catch (e) {
@@ -6485,8 +6882,8 @@ init_dist();
 init_dist3();
 import { Command as Command11 } from "commander";
 import { execSync as execSync10 } from "child_process";
-import { homedir as homedir12 } from "os";
-import { join as join18 } from "path";
+import { homedir as homedir13 } from "os";
+import { join as join19 } from "path";
 import chalk12 from "chalk";
 
 // packages/web/dist/read-status.js
@@ -6625,8 +7022,8 @@ function renderDashboard(rows, opts) {
 
 // packages/web/dist/sync-hub.js
 init_dist();
-import fs15 from "fs";
-import path19 from "path";
+import fs18 from "fs";
+import path22 from "path";
 function buildMirrorMarkdown(s) {
   const fenced = "```";
   return [
@@ -6652,15 +7049,15 @@ function buildMirrorMarkdown(s) {
 function syncHub(deps) {
   if (!deps.config.hubVault)
     return [];
-  const writeFile5 = deps.writeFile ?? ((p, c) => fs15.writeFileSync(p, c));
-  const mkdir5 = deps.mkdir ?? ((p) => fs15.mkdirSync(p, { recursive: true }));
-  const projectsDir = path19.join(resolveHome(deps.config.hubVault), "projects");
+  const writeFile5 = deps.writeFile ?? ((p, c) => fs18.writeFileSync(p, c));
+  const mkdir5 = deps.mkdir ?? ((p) => fs18.mkdirSync(p, { recursive: true }));
+  const projectsDir = path22.join(resolveHome(deps.config.hubVault), "projects");
   mkdir5(projectsDir);
   const out = [];
   for (const s of deps.statuses) {
     if (s.state === "unknown")
       continue;
-    const hubPath = path19.join(projectsDir, `${s.project}.md`);
+    const hubPath = path22.join(projectsDir, `${s.project}.md`);
     try {
       writeFile5(hubPath, buildMirrorMarkdown(s));
       out.push({ project: s.project, hubPath });
@@ -6682,9 +7079,9 @@ function mergeSnapshot(daemon, external, now) {
 // packages/web/dist/probes.js
 init_dist();
 init_dist();
-import { join as join17 } from "path";
-import { homedir as homedir11 } from "os";
-import { existsSync as existsSync9, readFileSync as readFileSync10 } from "fs";
+import { join as join18 } from "path";
+import { homedir as homedir12 } from "os";
+import { existsSync as existsSync10, readFileSync as readFileSync10 } from "fs";
 import { execFile as execFile2 } from "child_process";
 var DEFAULT_TIMEOUT_MS = 2e3;
 var AGENT_CLIS = ["claude", "codex", "gemini", "opencode"];
@@ -6720,7 +7117,7 @@ function vaultProbe(run, dir) {
       return { state: "unknown", detail: "no vault configured" };
     if (!run.pathExists(dir))
       return { state: "gone", detail: "vault directory missing" };
-    if (!run.pathExists(join17(dir, ".obsidian")))
+    if (!run.pathExists(join18(dir, ".obsidian")))
       return { state: "gone", detail: "no .obsidian/ (not a vault)" };
     return { state: "alive" };
   } catch {
@@ -6788,10 +7185,10 @@ async function runExternalProbes(run, timeoutMs = DEFAULT_TIMEOUT_MS) {
   const sessions = probeSessions(run);
   return { cmux: cmux2, agentClis, vaults, config: { parseable, projectPaths, sessions } };
 }
-var SESSIONS_PATH = join17(homedir11(), ".config", "squadrant", "sessions.json");
+var SESSIONS_PATH = join18(homedir12(), ".config", "squadrant", "sessions.json");
 function onPath(cli) {
   const dirs = (process.env.PATH ?? "").split(":").filter(Boolean);
-  return dirs.some((d) => existsSync9(join17(d, cli)));
+  return dirs.some((d) => existsSync10(join18(d, cli)));
 }
 function readSessionsHashes() {
   const raw = JSON.parse(readFileSync10(SESSIONS_PATH, "utf-8"));
@@ -6808,7 +7205,7 @@ function defaultProbeRunners() {
       }
     }),
     probeOnPath: async (cli) => onPath(cli),
-    pathExists: (p) => existsSync9(p),
+    pathExists: (p) => existsSync10(p),
     loadConfig: () => loadConfig(),
     loadSessionsHashes: () => readSessionsHashes()
   };
@@ -7461,7 +7858,7 @@ async function startWebServer(opts) {
 
 // packages/cli/src/commands/dashboard.ts
 init_dist();
-var SOCK3 = join18(homedir12(), ".config", "squadrant", "squadrant.sock");
+var SOCK3 = join19(homedir13(), ".config", "squadrant", "squadrant.sock");
 function detectCurrentWorkspace2() {
   const out = execSync10(`"${resolveCmuxBin()}" current-workspace`, { encoding: "utf-8" }).trim();
   const match = out.match(/workspace:\d+/);
@@ -7549,13 +7946,13 @@ init_dist3();
 init_dist2();
 import { Command as Command12 } from "commander";
 import { execSync as execSync11 } from "child_process";
-import fs16 from "fs";
-import path20 from "path";
-import os10 from "os";
+import fs19 from "fs";
+import path23 from "path";
+import os12 from "os";
 import chalk13 from "chalk";
 var CMUX_APP = "/Applications/cmux.app";
-var TEMPLATES_DIR4 = path20.join(os10.homedir(), ".config", "squadrant", "templates");
-var SESSIONS_PATH2 = path20.join(os10.homedir(), ".config", "squadrant", "sessions.json");
+var TEMPLATES_DIR4 = path23.join(os12.homedir(), ".config", "squadrant", "templates");
+var SESSIONS_PATH2 = path23.join(os12.homedir(), ".config", "squadrant", "sessions.json");
 function ensureCmuxReady() {
   if (isInsideCmux()) return;
   console.log(chalk13.yellow("\n  Not running inside cmux. Opening cmux app...\n"));
@@ -7662,12 +8059,12 @@ var launchCommand = new Command12("launch").description(
   }
   if (opts.all) {
     const hubPath = resolveHome(config.hubVault);
-    fs16.mkdirSync(hubPath, { recursive: true });
+    fs19.mkdirSync(hubPath, { recursive: true });
     console.log(chalk13.bold("\nLaunching all captain workspaces\n"));
     for (const [name, proj] of Object.entries(config.projects)) {
       const projPath = resolveHome(proj.path);
       const spokePath = resolveHome(proj.spokeVault);
-      if (!fs16.existsSync(spokePath)) {
+      if (!fs19.existsSync(spokePath)) {
         const spokeDriver = new WorkspaceRegistry({ obsidian: createObsidianDriver }).forProject(name, config);
         await ensureSpokeLayout(spokeDriver);
         console.log(chalk13.cyan(`  \u2714 Created spoke vault at ${spokePath}`));
@@ -7698,7 +8095,7 @@ var launchCommand = new Command12("launch").description(
     const proj = config.projects[project];
     const projPath = resolveHome(proj.path);
     const spokePath = resolveHome(proj.spokeVault);
-    if (!fs16.existsSync(spokePath)) {
+    if (!fs19.existsSync(spokePath)) {
       const spokeDriver = new WorkspaceRegistry({ obsidian: createObsidianDriver }).forProject(project, config);
       await ensureSpokeLayout(spokeDriver);
       console.log(chalk13.cyan(`  \u2714 Created spoke vault at ${spokePath}`));
@@ -7833,24 +8230,24 @@ Shutting down captain workspace for '${project}'...
 // packages/cli/src/commands/feedback.ts
 init_dist();
 import { Command as Command14 } from "commander";
-import fs17 from "fs";
-import os11 from "os";
-import path21 from "path";
+import fs20 from "fs";
+import os13 from "os";
+import path24 from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import { execSync as execSync12 } from "child_process";
 import chalk15 from "chalk";
 var REPO_URL = "https://github.com/tu11aa/squadrant";
 function readPkgVersion() {
   try {
-    const pkgPath = path21.join(path21.dirname(fileURLToPath3(import.meta.url)), "..", "package.json");
-    return JSON.parse(fs17.readFileSync(pkgPath, "utf-8")).version ?? "unknown";
+    const pkgPath = path24.join(path24.dirname(fileURLToPath3(import.meta.url)), "..", "package.json");
+    return JSON.parse(fs20.readFileSync(pkgPath, "utf-8")).version ?? "unknown";
   } catch {
     return "unknown";
   }
 }
 function readMetrics(metricsPath) {
   try {
-    return JSON.parse(fs17.readFileSync(metricsPath, "utf-8"));
+    return JSON.parse(fs20.readFileSync(metricsPath, "utf-8"));
   } catch {
     return {};
   }
@@ -7888,7 +8285,7 @@ function buildIssueUrl(metrics, squadrantVersion) {
 }
 var feedbackCommand = new Command14("feedback").description("Open a pre-filled GitHub issue for feedback or bug reports").action(() => {
   const config = loadConfig();
-  const metricsPath = config.metrics?.path || path21.join(os11.homedir(), ".config", "squadrant", "metrics.json");
+  const metricsPath = config.metrics?.path || path24.join(os13.homedir(), ".config", "squadrant", "metrics.json");
   const metrics = readMetrics(metricsPath);
   const version = readStamp(config) ?? readPkgVersion();
   const issueUrl = buildIssueUrl(metrics, version);
@@ -7910,8 +8307,8 @@ init_dist();
 init_dist();
 init_dist3();
 import { Command as Command15 } from "commander";
-import fs18 from "fs";
-import path22 from "path";
+import fs21 from "fs";
+import path25 from "path";
 import chalk16 from "chalk";
 import matter3 from "gray-matter";
 function getDateStr(yesterday) {
@@ -7920,11 +8317,11 @@ function getDateStr(yesterday) {
 async function getProjectStandup(name, project, dateStr, registry, config) {
   const workspace = registry.forProject(name, config);
   const spokeVault = resolveHome(project.spokeVault);
-  const statusFile = path22.join(spokeVault, "status.md");
+  const statusFile = path25.join(spokeVault, "status.md");
   let status = {};
-  if (fs18.existsSync(statusFile)) {
+  if (fs21.existsSync(statusFile)) {
     try {
-      status = matter3(fs18.readFileSync(statusFile, "utf-8")).data;
+      status = matter3(fs21.readFileSync(statusFile, "utf-8")).data;
     } catch {
     }
   }
@@ -8042,15 +8439,15 @@ init_dist();
 init_dist();
 init_dist3();
 import { Command as Command16 } from "commander";
-import fs19 from "fs";
-import path23 from "path";
+import fs22 from "fs";
+import path26 from "path";
 import chalk17 from "chalk";
 import matter4 from "gray-matter";
 function readStatus(spokeVault) {
-  const statusFile = path23.join(spokeVault, "status.md");
-  if (!fs19.existsSync(statusFile)) return {};
+  const statusFile = path26.join(spokeVault, "status.md");
+  if (!fs22.existsSync(statusFile)) return {};
   try {
-    return matter4(fs19.readFileSync(statusFile, "utf-8")).data;
+    return matter4(fs22.readFileSync(statusFile, "utf-8")).data;
   } catch {
     return {};
   }
@@ -8360,9 +8757,9 @@ workspaceCommand.command("read").description("Print the contents of a scope-rela
   const config = loadConfig();
   const registry = buildRegistry2();
   try {
-    const { projectTarget, path: path26 } = resolveTargetAndPath(arg1, arg2, !!opts.hub);
+    const { projectTarget, path: path29 } = resolveTargetAndPath(arg1, arg2, !!opts.hub);
     const driver = resolveDriver(registry, config, projectTarget, !!opts.hub);
-    const content = await driver.read(path26);
+    const content = await driver.read(path29);
     process.stdout.write(content);
   } catch (err) {
     console.error(chalk19.red(err.message));
@@ -8374,26 +8771,26 @@ workspaceCommand.command("write").description("Write content to a scope-relative
   const registry = buildRegistry2();
   try {
     let projectTarget;
-    let path26;
+    let path29;
     let rawContent;
     if (opts.hub) {
       if (arg3 !== void 0) {
         throw new Error("With --hub, pass only the path and content");
       }
       projectTarget = void 0;
-      path26 = arg1;
+      path29 = arg1;
       rawContent = arg2;
     } else {
       if (arg3 === void 0) {
         throw new Error("Missing content \u2014 usage: <project> <path> <content>");
       }
       projectTarget = arg1;
-      path26 = arg2;
+      path29 = arg2;
       rawContent = arg3;
     }
     const driver = resolveDriver(registry, config, projectTarget, !!opts.hub);
     const payload = rawContent === "-" ? await readStdin() : rawContent;
-    await driver.write(path26, payload);
+    await driver.write(path29, payload);
   } catch (err) {
     console.error(chalk19.red(err.message));
     process.exit(1);
@@ -8403,9 +8800,9 @@ workspaceCommand.command("list").description("List entries in a scope-relative d
   const config = loadConfig();
   const registry = buildRegistry2();
   try {
-    const { projectTarget, path: path26 } = resolveTargetAndPath(arg1, arg2, !!opts.hub);
+    const { projectTarget, path: path29 } = resolveTargetAndPath(arg1, arg2, !!opts.hub);
     const driver = resolveDriver(registry, config, projectTarget, !!opts.hub);
-    const entries = await driver.list(path26);
+    const entries = await driver.list(path29);
     for (const entry of entries) console.log(entry);
   } catch (err) {
     console.error(chalk19.red(err.message));
@@ -8416,9 +8813,9 @@ workspaceCommand.command("exists").description("Exit 0 if path exists, 1 if not"
   const config = loadConfig();
   const registry = buildRegistry2();
   try {
-    const { projectTarget, path: path26 } = resolveTargetAndPath(arg1, arg2, !!opts.hub);
+    const { projectTarget, path: path29 } = resolveTargetAndPath(arg1, arg2, !!opts.hub);
     const driver = resolveDriver(registry, config, projectTarget, !!opts.hub);
-    const ok = await driver.exists(path26);
+    const ok = await driver.exists(path29);
     process.exit(ok ? 0 : 1);
   } catch (err) {
     console.error(chalk19.red(err.message));
@@ -8429,9 +8826,9 @@ workspaceCommand.command("mkdir").description("Recursively create a scope-relati
   const config = loadConfig();
   const registry = buildRegistry2();
   try {
-    const { projectTarget, path: path26 } = resolveTargetAndPath(arg1, arg2, !!opts.hub);
+    const { projectTarget, path: path29 } = resolveTargetAndPath(arg1, arg2, !!opts.hub);
     const driver = resolveDriver(registry, config, projectTarget, !!opts.hub);
-    await driver.mkdir(path26);
+    await driver.mkdir(path29);
   } catch (err) {
     console.error(chalk19.red(err.message));
     process.exit(1);
@@ -8470,8 +8867,8 @@ init_dist3();
 init_dist();
 import { Command as Command20 } from "commander";
 import chalk21 from "chalk";
-import fs20 from "fs";
-import path24 from "path";
+import fs23 from "fs";
+import path27 from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 function parseScope(v) {
   if (v !== "user" && v !== "project") {
@@ -8480,10 +8877,10 @@ function parseScope(v) {
   return v;
 }
 function findPackageRoot3() {
-  let dir = path24.dirname(fileURLToPath4(import.meta.url));
+  let dir = path27.dirname(fileURLToPath4(import.meta.url));
   while (dir !== "/" && dir !== "") {
-    if (fs20.existsSync(path24.join(dir, "package.json"))) return dir;
-    dir = path24.dirname(dir);
+    if (fs23.existsSync(path27.join(dir, "package.json"))) return dir;
+    dir = path27.dirname(dir);
   }
   return process.cwd();
 }
@@ -8677,12 +9074,12 @@ init_dist();
 init_dist();
 init_dist();
 import { Command as Command22 } from "commander";
-import fs21 from "fs";
+import fs24 from "fs";
 import { fileURLToPath as fileURLToPath5 } from "url";
-import { dirname as dirname5, join as join19 } from "path";
+import { dirname as dirname5, join as join20 } from "path";
 import chalk22 from "chalk";
 function runConfigCheck(opts) {
-  const raw = JSON.parse(fs21.readFileSync(opts.configPath, "utf-8"));
+  const raw = JSON.parse(fs24.readFileSync(opts.configPath, "utf-8"));
   const def = getDefaultConfig();
   const items = detectDrift(raw, def);
   let working = raw;
@@ -8699,10 +9096,56 @@ function runConfigCheck(opts) {
     stamped = true;
   }
   if (opts.fix || opts.accept || stamped) {
-    fs21.writeFileSync(opts.configPath, JSON.stringify(working, null, 2) + "\n");
+    fs24.writeFileSync(opts.configPath, JSON.stringify(working, null, 2) + "\n");
   }
   return { items, applied, remaining, stamped };
 }
+function runConfigGet(key, configPath = DEFAULT_CONFIG_PATH) {
+  const config = loadConfig(configPath);
+  const parts = key.split(".");
+  let node = config;
+  for (const p of parts) {
+    if (node === null || typeof node !== "object" || !(p in node)) {
+      throw new Error(`config key not found: ${key}`);
+    }
+    node = node[p];
+  }
+  return node;
+}
+function runConfigSet(key, value, configPath = DEFAULT_CONFIG_PATH) {
+  let parsed;
+  try {
+    parsed = JSON.parse(value);
+  } catch {
+    parsed = value;
+  }
+  const config = loadConfig(configPath);
+  const parts = key.split(".");
+  let node = config;
+  for (let i = 0; i < parts.length - 1; i++) {
+    const p = parts[i];
+    if (node[p] === null || typeof node[p] !== "object") node[p] = {};
+    node = node[p];
+  }
+  node[parts[parts.length - 1]] = parsed;
+  saveConfig(config, configPath);
+}
+function printRestartOutcome(outcome) {
+  if (outcome === "skipped-not-running") {
+    console.log(chalk22.dim("(daemon not running \u2014 change applies on next start)"));
+  } else if (outcome === "skipped-opt-out") {
+    console.log(chalk22.dim("(run 'squadrant heal daemon' to apply)"));
+  }
+}
+function runConfigSetAction(opts) {
+  runConfigSet(opts.key, opts.value, opts.configPath);
+  console.log(chalk22.green(`\u2714 set ${opts.key} = ${opts.value}`));
+  if (isDaemonCachedKey(opts.key)) {
+    const doRestart = opts.doRestart ?? restartDaemonIfRunning;
+    const outcome = doRestart({ reason: `config ${opts.key}`, noRestart: opts.noRestart });
+    printRestartOutcome(outcome);
+  }
+}
 var SEV_COLOR = {
   info: chalk22.green,
   advisory: chalk22.yellow,
@@ -8724,7 +9167,7 @@ function printItems(items) {
 var configCommand = new Command22("config").description("Inspect and reconcile squadrant config");
 configCommand.command("check").description("Detect config drift vs the current default schema").option("--fix", "Apply the safe tier (add missing, remove deprecated)", false).option("--accept", "Stamp the current version without changing config (dismiss advisories)", false).option("--json", "Output drift items as JSON", false).action((opts) => {
   const pkgVersion = readPkgVersion2();
-  if (!fs21.existsSync(DEFAULT_CONFIG_PATH)) {
+  if (!fs24.existsSync(DEFAULT_CONFIG_PATH)) {
     console.log(chalk22.yellow("No config found \u2014 run `squadrant init` first."));
     return;
   }
@@ -8751,16 +9194,32 @@ ${judgment.length} item(s) need review \u2014 run the config-doctor skill, or \`
     console.log(chalk22.green("\n\u2714 Config reconciled and stamped."));
   }
 });
+configCommand.command("get").description("Read a config value by dotted key (e.g. defaults.effort)").argument("<key>", "dotted config key").action((key) => {
+  try {
+    const value = runConfigGet(key);
+    console.log(typeof value === "string" ? value : JSON.stringify(value));
+  } catch (e) {
+    console.error(chalk22.red(e.message));
+    process.exit(1);
+  }
+});
+configCommand.command("set").description("Write a config value by dotted key (e.g. defaults.effort low)").argument("<key>", "dotted config key").argument("<value>", "value (JSON-parsed when possible, else a bare string)").option("--no-restart", "skip daemon restart even if the key is daemon-cached").action((key, value, opts) => {
+  try {
+    runConfigSetAction({ key, value, noRestart: opts.restart === false });
+  } catch (e) {
+    console.error(chalk22.red(e.message));
+    process.exit(1);
+  }
+});
 function readPkgVersion2() {
-  const pkgPath = join19(dirname5(fileURLToPath5(import.meta.url)), "..", "package.json");
-  return JSON.parse(fs21.readFileSync(pkgPath, "utf-8")).version;
+  const pkgPath = join20(dirname5(fileURLToPath5(import.meta.url)), "..", "package.json");
+  return JSON.parse(fs24.readFileSync(pkgPath, "utf-8")).version;
 }
 
 // packages/cli/src/commands/heal.ts
 import { Command as Command23 } from "commander";
 import chalk23 from "chalk";
 init_dist2();
-init_dist2();
 function buildHealStatus(components) {
   if (components === null) {
     return { healthy: false, daemonUnreachable: true, components: [] };
@@ -8840,7 +9299,7 @@ var healCommand = new Command23("heal").description("Targeted, idempotent remedi
 ).addCommand(
   new Command23("daemon").description("Restart squadrantd via the idempotent launchd kickstart path").action(async () => {
     const code = await runHealDaemon({
-      ensureDaemon,
+      ensureDaemon: () => restartDaemonIfRunning({ reason: "heal", isRunning: () => true }),
       stdout: process.stdout,
       stderr: process.stderr
     });
@@ -8854,10 +9313,10 @@ init_dist2();
 import { Command as Command24 } from "commander";
 import { execSync as execSync13 } from "child_process";
 import { randomUUID as randomUUID4 } from "crypto";
-import { homedir as homedir13 } from "os";
-import { join as join20 } from "path";
+import { homedir as homedir14 } from "os";
+import { join as join21 } from "path";
 import chalk24 from "chalk";
-var SOCK4 = join20(homedir13(), ".config", "squadrant", "squadrant.sock");
+var SOCK4 = join21(homedir14(), ".config", "squadrant", "squadrant.sock");
 var WARMUP_TIMEOUT_MS = 12e4;
 var WARMUP_POLL_MS = 1e3;
 function resolveCurrentProject(config) {
@@ -9019,8 +9478,8 @@ var cmuxCommand = new Command25("cmux").description("cmux integration helpers").
 
 // packages/cli/src/commands/effort.ts
 init_dist();
-import fs22 from "fs";
-import path25 from "path";
+import fs25 from "fs";
+import path28 from "path";
 import { Command as Command26 } from "commander";
 import chalk26 from "chalk";
 var VALID_EFFORTS = ["max", "balance", "low"];
@@ -9047,9 +9506,9 @@ function runEffortSet(value, configPath = DEFAULT_CONFIG_PATH) {
 }
 function canonical(p) {
   try {
-    return fs22.realpathSync(p);
+    return fs25.realpathSync(p);
   } catch {
-    return path25.resolve(p);
+    return path28.resolve(p);
   }
 }
 async function notifyCaptainsOfEffort(effort, config, driver, cwd = process.cwd()) {
@@ -9093,20 +9552,440 @@ var effortCommand = new Command26("effort").description("Get or set the global c
   }
 });
 
+// packages/cli/src/commands/telegram.ts
+init_dist();
+init_dist2();
+import { join as join22, dirname as dirname6 } from "path";
+import { emitKeypressEvents } from "readline";
+import { Command as Command27 } from "commander";
+import chalk27 from "chalk";
+function defaultStateRoot() {
+  return join22(dirname6(DEFAULT_CONFIG_PATH), "state");
+}
+function runTelegramStatus(opts) {
+  const tg = opts.config.telegram;
+  const env = opts.env ?? process.env;
+  const tokenSet = !!(tg?.botToken ?? env.TELEGRAM_BOT_TOKEN);
+  const links = Object.entries(loadState(opts.stateRoot).topics).map(([key, topicId]) => {
+    const sep2 = key.indexOf("::");
+    return { project: key.slice(0, sep2), scope: key.slice(sep2 + 2), topicId };
+  });
+  return { tokenSet, supergroupId: tg?.supergroupId ?? null, links };
+}
+async function runTelegramSend(opts) {
+  const topicId = loadState(opts.stateRoot).topics[topicKey(opts.project)];
+  if (topicId === void 0) {
+    throw new Error(`project "${opts.project}" is not linked \u2014 run: squadrant telegram link ${opts.project}`);
+  }
+  await opts.client.sendMessage(opts.cfg.supergroupId, topicId, opts.message);
+  return { chatId: opts.cfg.supergroupId, topicId };
+}
+function runTelegramNotifySet(opts) {
+  setNotify(opts.stateRoot, opts.project, opts.active);
+}
+function runTelegramNotifyPref(args) {
+  const { project, dimension, value, root } = args;
+  if (dimension === "crew") {
+    if (!["all", "alert_only", "done_only", "none"].includes(value))
+      return { ok: false, message: "crew must be all|alert_only|done_only|none" };
+    saveProjectOverride(project, { telegram: { notify: { crew: value } } }, root);
+    return { ok: true };
+  }
+  if (value !== "on" && value !== "off") return { ok: false, message: "cap must be on|off" };
+  saveProjectOverride(project, { telegram: { notify: { cap: value === "on" } } }, root);
+  return { ok: true };
+}
+function capAllowed(project, globalNotify, root) {
+  return resolveNotify(globalNotify, loadProjectOverride(project, root)).cap;
+}
+function runTelegramNotifyStatus(opts) {
+  const s = loadState(opts.stateRoot);
+  const projects = /* @__PURE__ */ new Set();
+  for (const key of Object.keys(s.topics)) {
+    const sep2 = key.indexOf("::");
+    projects.add(sep2 === -1 ? key : key.slice(0, sep2));
+  }
+  for (const p of Object.keys(s.notify)) projects.add(p);
+  return [...projects].map((project) => ({ project, active: s.notify[project] === true }));
+}
+async function runTelegramLink(opts) {
+  const existing = loadState(opts.stateRoot).topics[topicKey(opts.project)];
+  if (existing !== void 0) return { topicId: existing, created: false };
+  const topicId = await opts.client.createForumTopic(opts.cfg.supergroupId, topicName(opts.project));
+  setTopic(opts.stateRoot, opts.project, topicId);
+  return { topicId, created: true };
+}
+async function questionMasked() {
+  return new Promise((resolve3) => {
+    emitKeypressEvents(process.stdin);
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    let answer = "";
+    const onKeypress = (_str, key) => {
+      if (key.ctrl && key.name === "c") {
+        process.stdin.removeListener("keypress", onKeypress);
+        process.stdin.setRawMode(false);
+        process.stdin.pause();
+        process.stdout.write("\n");
+        process.exit(130);
+      } else if (key.name === "return" || key.name === "enter") {
+        process.stdin.removeListener("keypress", onKeypress);
+        process.stdin.setRawMode(false);
+        process.stdin.pause();
+        process.stdout.write("\n");
+        resolve3(answer);
+      } else if (key.name === "backspace") {
+        if (answer.length > 0) {
+          answer = answer.slice(0, -1);
+          process.stdout.write("\b \b");
+        }
+      } else if (!key.ctrl && !key.meta && key.sequence) {
+        answer += key.sequence;
+        process.stdout.write("*");
+      }
+    };
+    process.stdin.on("keypress", onKeypress);
+  });
+}
+async function questionYesNo(prompt) {
+  const { createInterface: createInterface2 } = await import("readline");
+  const rl = createInterface2({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve3) => {
+    rl.question(prompt, (ans) => {
+      rl.close();
+      process.stdin.pause();
+      resolve3(/^y(es)?$/i.test(ans.trim()));
+    });
+  });
+}
+function confirmationText(project, before, after, dim) {
+  if (dim === "active") return `\u{1F515} ${project} \u2014 all notifications muted here. Unmute: squadrant telegram notify ${project} on`;
+  if (dim === "cap") return `\u{1F515} ${project} \u2014 captain messages muted here. Re-enable: squadrant telegram notify ${project} cap on`;
+  return `\u{1F515} ${project} \u2014 crew notifications now '${after.crew}' (was '${before.crew}'). Re-enable: squadrant telegram notify ${project} crew ${before.crew}`;
+}
+async function runNotifyConfirmation(opts) {
+  const { quieter, dim } = isQuieter(opts.before, opts.after);
+  if (!quieter || dim === null) return false;
+  const topicId = loadState(opts.stateRoot).topics[topicKey(opts.project)];
+  if (topicId === void 0) return false;
+  const text = confirmationText(opts.project, opts.before, opts.after, dim);
+  try {
+    await opts.client.sendMessage(opts.cfg.supergroupId, topicId, text);
+    return true;
+  } catch {
+    console.warn(`[squadrant] mute-confirmation send failed for ${opts.project} \u2014 notification preference was still saved`);
+    return false;
+  }
+}
+function resolveSetupToken(existingToken, opts) {
+  if (opts.resetToken || !existingToken) return "prompt";
+  return "try-reuse";
+}
+function resolveSetupUserId(flagUserId, detectedUserId, stateRoot) {
+  return flagUserId ?? detectedUserId ?? loadState(stateRoot).lastUserId;
+}
+async function runRegisterCommands(opts) {
+  await opts.client.setMyCommands(BOT_COMMANDS);
+}
+function runTelegramPostSetup(opts) {
+  const doRestart = opts.doRestart ?? restartDaemonIfRunning;
+  const outcome = doRestart({ reason: "telegram config" });
+  if (outcome === "skipped-not-running") {
+    console.log(chalk27.dim("(daemon not running \u2014 change applies on next start)"));
+  } else if (outcome === "skipped-opt-out") {
+    console.log(chalk27.dim("(run 'squadrant heal daemon' to apply)"));
+  }
+}
+var telegramCommand = new Command27("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")}`);
+  if (links.length === 0) {
+    console.log("no projects linked");
+    return;
+  }
+  for (const l of links) console.log(`  ${l.project} (${l.scope}) \u2192 topic ${l.topicId}`);
+});
+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"));
+    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"));
+    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}`));
+});
+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"));
+    process.exit(1);
+  }
+  console.log();
+  console.log(chalk27.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"));
+  const existingCfg = loadConfig().telegram;
+  const existingToken = existingCfg?.botToken ?? process.env.TELEGRAM_BOT_TOKEN;
+  const decision = resolveSetupToken(existingToken, { resetToken: opts.resetToken ?? false });
+  let token;
+  let client;
+  let botUser;
+  if (decision === "try-reuse") {
+    client = createTelegramClient({ token: existingToken });
+    try {
+      botUser = await client.getMe();
+      token = existingToken;
+      console.log(chalk27.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("Paste your bot token then press Enter (input is hidden):");
+      token = await questionMasked();
+      if (!token) {
+        console.error(chalk27.red("token required"));
+        process.exit(1);
+      }
+      client = createTelegramClient({ token });
+      try {
+        botUser = await client.getMe();
+      } catch (e) {
+        console.error(chalk27.red(`token rejected: ${e.message}`));
+        process.exit(1);
+      }
+      console.log(chalk27.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"));
+      process.exit(1);
+    }
+    client = createTelegramClient({ token });
+    try {
+      botUser = await client.getMe();
+    } catch (e) {
+      console.error(chalk27.red(`token rejected: ${e.message}`));
+      process.exit(1);
+    }
+    console.log(chalk27.green(`Connected as @${botUser.username}`));
+    console.log();
+  }
+  console.log(chalk27.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();
+  } 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"));
+    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"));
+      process.exit(1);
+    }
+    console.log(chalk27.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)."));
+  const finalUserId = resolveSetupUserId(opts.userId, detectedUserId, defaultStateRoot());
+  let users;
+  let remoteControl;
+  let printedRemoteControlState = false;
+  if (finalUserId !== void 0) {
+    const enable = await questionYesNo(
+      `Enable remote control for your user-id ${finalUserId}? [y/N] `
+    );
+    if (enable) {
+      users = [finalUserId];
+      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."));
+    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.`));
+    } else {
+      console.log(chalk27.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}`));
+  if (!printedRemoteControlState) {
+    if (remoteControl) {
+      console.log(chalk27.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."));
+    }
+  }
+  try {
+    await runRegisterCommands({ client });
+    console.log(chalk27.dim("Registered the /command menu."));
+  } catch (e) {
+    console.log(chalk27.yellow(`command-menu registration skipped: ${e.message}`));
+  }
+  const topics = loadState(defaultStateRoot()).topics;
+  const topicEntries = Object.entries(topics);
+  if (topicEntries.length > 0) {
+    const summary = topicEntries.map(([key, id]) => {
+      const project = key.slice(0, key.indexOf("::"));
+      return `${project}\u2192${id}`;
+    }).join(", ");
+    console.log(chalk27.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>"));
+  }
+  runTelegramPostSetup({});
+  console.log();
+  console.log(`Next: ${chalk27.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"));
+    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"));
+    process.exit(1);
+  }
+  const client = createTelegramClient({ token });
+  await runRegisterCommands({ client });
+  console.log(chalk27.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();
+  if (opts.status || !project) {
+    const rows = runTelegramNotifyStatus({ stateRoot });
+    if (rows.length === 0) {
+      console.log("no projects linked");
+      return;
+    }
+    for (const r of rows) {
+      console.log(`  ${r.project}: ${r.active ? chalk27.green("on") : chalk27.dim("off (muted)")}`);
+    }
+    return;
+  }
+  const tgCfg = loadConfig().telegram;
+  const globalNotify = tgCfg?.notify;
+  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>`));
+      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));
+      process.exit(1);
+    }
+    console.log(chalk27.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`));
+    }
+    return;
+  }
+  if (state !== "on" && state !== "off") {
+    console.error(chalk27.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"}`));
+  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`));
+  }
+});
+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"));
+    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"));
+    process.exit(1);
+  }
+  if (!capAllowed(project, cfg.notify)) {
+    console.log(chalk27.dim(`${project}: captain messages muted (cap=off) \u2014 not sent`));
+    return;
+  }
+  let message;
+  if (messageParts.length > 0) {
+    message = messageParts.join(" ");
+  } else if (!process.stdin.isTTY) {
+    const { createInterface: createInterface2 } = await import("readline");
+    const lines = [];
+    const rl = createInterface2({ input: process.stdin });
+    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)"));
+      process.exit(1);
+    }
+  } else {
+    console.error(chalk27.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}`));
+  } catch (e) {
+    console.error(chalk27.red(e.message));
+    process.exit(1);
+  }
+});
+
 // packages/cli/src/index.ts
 init_dist();
 init_dist();
 init_dist();
-var __dirname = dirname6(fileURLToPath6(import.meta.url));
-var pkg = JSON.parse(readFileSync11(join21(__dirname, "..", "package.json"), "utf-8"));
+var __dirname = dirname7(fileURLToPath6(import.meta.url));
+var pkg = JSON.parse(readFileSync11(join23(__dirname, "..", "package.json"), "utf-8"));
 ensureRuntimeSynced({
-  sourceRoot: join21(__dirname, ".."),
-  runtimeRoot: join21(homedir14(), ".config", "squadrant")
+  sourceRoot: join23(__dirname, ".."),
+  runtimeRoot: join23(homedir15(), ".config", "squadrant")
 });
 if (process.argv[2] !== "config") {
   try {
-    const cfgPath = join21(homedir14(), ".config", "squadrant", "config.json");
-    if (existsSync10(cfgPath)) {
+    const cfgPath = join23(homedir15(), ".config", "squadrant", "config.json");
+    if (existsSync11(cfgPath)) {
       const cfg = JSON.parse(readFileSync11(cfgPath, "utf-8"));
       if (needsCheck(cfg, pkg.version)) {
         const items = detectDrift(cfg, getDefaultConfig());
@@ -9130,7 +10009,7 @@ if (process.argv[2] !== "config") {
 if (!process.env.SQUADRANT_DAEMON_SKIP) {
   ensureDaemon();
 }
-var program = new Command27();
+var program = new Command28();
 program.name("squadrant").description("Multi-project orchestration for your coding agents (Claude, Codex, opencode, Gemini)").version(pkg.version);
 program.addCommand(doctorCommand);
 program.addCommand(initCommand);
@@ -9156,6 +10035,7 @@ program.addCommand(healCommand);
 program.addCommand(groupCommand);
 program.addCommand(cmuxCommand);
 program.addCommand(effortCommand);
+program.addCommand(telegramCommand);
 program.parseAsync().catch((e) => {
   process.stderr.write(`error: ${e instanceof Error ? e.message : String(e)}
 `);