squadrant 0.9.1 → 0.10.0

package/dist/index.js

@@ -155,22 +155,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 path27 = opts.path ?? defaultCmuxConfigPath();
+  if (!existsSync(path27)) {
+    mkdirSync(dirname(path27), { recursive: true });
+    writeFileSync(path27, MINIMAL_TEMPLATE);
+    return { path: path27, changed: true, alreadySet: false };
   }
-  const text = readFileSync(path26, "utf-8");
+  const text = readFileSync(path27, "utf-8");
   const current = parse(text)?.automation?.socketControlMode;
   if (current === AUTOMATION_MODE) {
-    return { path: path26, changed: false, alreadySet: true };
+    return { path: path27, 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(path27, applyEdits(text, edits));
+  return { path: path27, changed: true, alreadySet: false };
 }
 var SOCKET_CONTROL_MODE_PATH, AUTOMATION_MODE, MINIMAL_TEMPLATE;
 var init_cmux_config = __esm({
@@ -320,15 +320,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(path27) {
   try {
-    return JSON.parse(readFileSync4(path26, "utf-8"));
+    return JSON.parse(readFileSync4(path27, "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 +336,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,
@@ -1131,10 +1131,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(path27) {
   const seen = /* @__PURE__ */ new Set();
   const stable = [];
-  for (const p of path26.split(":")) {
+  for (const p of path27.split(":")) {
     if (!p)
       continue;
     if (p.includes("/.claude/plugins/"))
@@ -1499,7 +1499,8 @@ function buildCompletionProtocol(taskId, project) {
     "COMPLETION PROTOCOL (required): When this task is fully complete, your FINAL action MUST be to run exactly:",
     `  squadrant crew signal done --task-id ${taskId} --project ${project} --message "<one-line summary>"`,
     "Run it as a discrete final step AFTER you report your results. If you are blocked or need a decision, instead run:",
-    `  squadrant crew signal blocked --task-id ${taskId} --project ${project} --question "<your question>"`
+    `  squadrant crew signal blocked --task-id ${taskId} --project ${project} --question "<your question>"`,
+    "If this task failed because of a defect in squadrant itself (not an API/infra blip, a config/user error, or an expected failure), say so in your signal done/blocked message so the captain can check tu11aa/squadrant and file it. Don't file issues from the crew."
   ].join("\n");
 }
 function shellQuote(p) {
@@ -1570,6 +1571,199 @@ var init_crew_lifecycle = __esm({
   }
 });
 
+// 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 fs8 from "fs";
+import path7 from "path";
+function statePath(stateRoot) {
+  return path7.join(stateRoot, "telegram-state.json");
+}
+function topicKey(project, scope = "project") {
+  return `${project}::${scope}`;
+}
+function loadState(stateRoot) {
+  try {
+    const raw = fs8.readFileSync(statePath(stateRoot), "utf-8");
+    const data = JSON.parse(raw);
+    return {
+      offset: typeof data.offset === "number" ? data.offset : 0,
+      topics: data.topics ?? {}
+    };
+  } catch {
+    return { offset: 0, topics: {} };
+  }
+}
+function saveState(stateRoot, s) {
+  fs8.mkdirSync(stateRoot, { recursive: true });
+  fs8.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);
+}
+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) {
+      const body = { chat_id: chatId, text };
+      if (threadId !== void 0)
+        body.message_thread_id = threadId;
+      await call("sendMessage", body);
+    },
+    async createForumTopic(chatId, name) {
+      const r = await call("createForumTopic", { chat_id: chatId, name });
+      return r.message_thread_id;
+    }
+  };
+}
+var init_client = __esm({
+  "packages/core/dist/telegram/client.js"() {
+  }
+});
+
+// packages/core/dist/telegram/bridge.js
+var init_bridge = __esm({
+  "packages/core/dist/telegram/bridge.js"() {
+    init_auth();
+    init_commands();
+    init_format();
+    init_state();
+  }
+});
+
+// packages/core/dist/telegram/setup.js
+import fs9 from "fs";
+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 = fs9.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;
+  fs9.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_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"() {
@@ -1595,6 +1789,7 @@ var init_dist2 = __esm({
     init_session_freshness();
     init_crew_protocol();
     init_crew_lifecycle();
+    init_telegram();
   }
 });
 
@@ -2113,13 +2308,13 @@ var init_notifiers = __esm({
 });
 
 // packages/workspaces/dist/workspaces/obsidian.js
-import fs8 from "fs/promises";
+import fs10 from "fs/promises";
 import { existsSync as existsSync8 } from "fs";
-import path7 from "path";
+import path8 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 = path8.resolve(root, relative);
+  const normalized = path8.resolve(root) + path8.sep;
+  if (joined !== path8.resolve(root) && !joined.startsWith(normalized)) {
     throw new Error(`Path '${relative}' escapes workspace root`);
   }
   return joined;
@@ -2138,16 +2333,16 @@ function createObsidianDriver(scope) {
       };
     },
     async read(rel) {
-      return fs8.readFile(resolveInRoot(root, rel), "utf-8");
+      return fs10.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 fs10.mkdir(path8.dirname(abs), { recursive: true });
+      await fs10.writeFile(abs, content);
     },
     async exists(rel) {
       try {
-        await fs8.access(resolveInRoot(root, rel));
+        await fs10.access(resolveInRoot(root, rel));
         return true;
       } catch {
         return false;
@@ -2155,13 +2350,13 @@ function createObsidianDriver(scope) {
     },
     async list(rel) {
       try {
-        return await fs8.readdir(resolveInRoot(root, rel));
+        return await fs10.readdir(resolveInRoot(root, rel));
       } catch {
         return [];
       }
     },
     async mkdir(rel) {
-      await fs8.mkdir(resolveInRoot(root, rel), { recursive: true });
+      await fs10.mkdir(resolveInRoot(root, rel), { recursive: true });
     }
   };
 }
@@ -2830,8 +3025,8 @@ var init_registry4 = __esm({
 });
 
 // packages/agents/dist/drivers/launch-cmd.js
-import fs9 from "fs";
-import path8 from "path";
+import fs11 from "fs";
+import path9 from "path";
 function buildAgentCmd(agentName, registry, role, fresh, permissionMode, model, templatesDir) {
   const driver = registry.getDriver(agentName);
   if (driver.name === "claude") {
@@ -2847,27 +3042,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 = path9.join(templatesDir, `${role}.claude.md`);
+      const legacyRoleFile = path9.join(templatesDir, `${role}.CLAUDE.md`);
+      const actualRoleFile = fs11.existsSync(roleFile2) ? roleFile2 : fs11.existsSync(legacyRoleFile) ? legacyRoleFile : null;
       if (actualRoleFile) {
         cmd += ` --append-system-prompt-file ${actualRoleFile}`;
       }
-      const pluginDir = path8.join(templatesDir, "..", "plugin");
-      if (fs9.existsSync(pluginDir)) {
+      const pluginDir = path9.join(templatesDir, "..", "plugin");
+      if (fs11.existsSync(pluginDir)) {
         cmd += ` --plugin-dir ${pluginDir}`;
       }
     }
     return cmd;
   }
-  const roleFile = templatesDir ? path8.join(templatesDir, `${role}.${driver.templateSuffix}.md`) : void 0;
+  const roleFile = templatesDir ? path9.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 && fs11.existsSync(roleFile) ? roleFile : void 0
   });
 }
 var init_launch_cmd = __esm({
@@ -2890,7 +3085,7 @@ var init_drivers = __esm({
 
 // packages/agents/dist/projection/cursor.js
 import { mkdir, readFile, writeFile } from "fs/promises";
-import path9 from "path";
+import path10 from "path";
 import os2 from "os";
 function renderMdc(source) {
   const skillSections = source.skills.map((s) => `## Skill: ${s.name}
@@ -2939,7 +3134,7 @@ function createCursorEmitter() {
       if (scope === "user") {
         return [
           {
-            path: path9.join(os2.homedir(), ".cursor/rules/squadrant-global.mdc"),
+            path: path10.join(os2.homedir(), ".cursor/rules/squadrant-global.mdc"),
             shared: false,
             format: "mdc"
           }
@@ -2949,7 +3144,7 @@ function createCursorEmitter() {
         return [];
       return [
         {
-          path: path9.join(projectRoot, ".cursor/rules/squadrant.mdc"),
+          path: path10.join(projectRoot, ".cursor/rules/squadrant.mdc"),
           shared: false,
           format: "mdc"
         }
@@ -2966,7 +3161,7 @@ function createCursorEmitter() {
           diff: buildDiff(existing, generated)
         };
       }
-      await mkdir(path9.dirname(dest.path), { recursive: true });
+      await mkdir(path10.dirname(dest.path), { recursive: true });
       await writeFile(dest.path, generated, "utf-8");
       return {
         written: true,
@@ -3017,7 +3212,7 @@ 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 path11 from "path";
 import os3 from "os";
 function renderMarkdown(source) {
   const skillSections = source.skills.map((s) => `## Skill: ${s.name}
@@ -3042,7 +3237,7 @@ function createCodexEmitter() {
     destinations(scope, projectRoot) {
       if (scope === "user") {
         return [{
-          path: path10.join(os3.homedir(), ".codex/AGENTS.md"),
+          path: path11.join(os3.homedir(), ".codex/AGENTS.md"),
           shared: true,
           format: "markdown"
         }];
@@ -3050,7 +3245,7 @@ function createCodexEmitter() {
       if (!projectRoot)
         return [];
       return [{
-        path: path10.join(projectRoot, "AGENTS.md"),
+        path: path11.join(projectRoot, "AGENTS.md"),
         shared: true,
         format: "markdown"
       }];
@@ -3071,7 +3266,7 @@ ${existing ?? ""}
 ${generated}`
         };
       }
-      await mkdir2(path10.dirname(dest.path), { recursive: true });
+      await mkdir2(path11.dirname(dest.path), { recursive: true });
       await writeFile2(dest.path, generated, "utf-8");
       return {
         written: true,
@@ -3089,7 +3284,7 @@ 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 path12 from "path";
 import os4 from "os";
 function renderMarkdown2(source) {
   const skillSections = source.skills.map((s) => `## Skill: ${s.name}
@@ -3114,7 +3309,7 @@ function createGeminiEmitter() {
     destinations(scope, projectRoot) {
       if (scope === "user") {
         return [{
-          path: path11.join(os4.homedir(), ".gemini/GEMINI.md"),
+          path: path12.join(os4.homedir(), ".gemini/GEMINI.md"),
           shared: true,
           format: "markdown"
         }];
@@ -3122,7 +3317,7 @@ function createGeminiEmitter() {
       if (!projectRoot)
         return [];
       return [{
-        path: path11.join(projectRoot, "GEMINI.md"),
+        path: path12.join(projectRoot, "GEMINI.md"),
         shared: true,
         format: "markdown"
       }];
@@ -3143,7 +3338,7 @@ ${existing ?? ""}
 ${generated}`
         };
       }
-      await mkdir3(path11.dirname(dest.path), { recursive: true });
+      await mkdir3(path12.dirname(dest.path), { recursive: true });
       await writeFile3(dest.path, generated, "utf-8");
       return {
         written: true,
@@ -3161,7 +3356,7 @@ 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 path13 from "path";
 import os5 from "os";
 function renderMarkdown3(source) {
   const skillSections = source.skills.map((s) => `## Skill: ${s.name}
@@ -3186,7 +3381,7 @@ function createOpencodeEmitter() {
     destinations(scope, projectRoot) {
       if (scope === "user") {
         return [{
-          path: path12.join(os5.homedir(), ".config", "opencode", "AGENTS.md"),
+          path: path13.join(os5.homedir(), ".config", "opencode", "AGENTS.md"),
           shared: true,
           format: "markdown"
         }];
@@ -3194,7 +3389,7 @@ function createOpencodeEmitter() {
       if (!projectRoot)
         return [];
       return [{
-        path: path12.join(projectRoot, "AGENTS.md"),
+        path: path13.join(projectRoot, "AGENTS.md"),
         shared: true,
         format: "markdown"
       }];
@@ -3215,7 +3410,7 @@ ${existing ?? ""}
 ${generated}`
         };
       }
-      await mkdir4(path12.dirname(dest.path), { recursive: true });
+      await mkdir4(path13.dirname(dest.path), { recursive: true });
       await writeFile4(dest.path, generated, "utf-8");
       return {
         written: true,
@@ -4080,8 +4275,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 path27 of candidates) {
+    const text = readLastAssistantText(path27);
     if (text != null)
       return text;
   }
@@ -4480,10 +4675,10 @@ var init_dist4 = __esm({
 // packages/cli/src/index.ts
 init_dist();
 init_dist2();
-import { Command as Command27 } from "commander";
+import { Command as Command28 } from "commander";
 import { readFileSync as readFileSync11, existsSync as existsSync10, writeFileSync as writeFileSync9 } from "fs";
-import { fileURLToPath as fileURLToPath5 } from "url";
-import { dirname as dirname6, join as join21 } from "path";
+import { fileURLToPath as fileURLToPath6 } from "url";
+import { dirname as dirname7, join as join22 } from "path";
 import { homedir as homedir14 } from "os";
 
 // packages/cli/src/commands/doctor.ts
@@ -4493,9 +4688,9 @@ init_dist();
 init_dist3();
 import { Command } from "commander";
 import { execSync as execSync8 } from "child_process";
-import fs10 from "fs";
+import fs12 from "fs";
 import { stat } from "fs/promises";
-import path13 from "path";
+import path14 from "path";
 import chalk3 from "chalk";
 
 // packages/cli/src/commands/health-view.ts
@@ -4597,7 +4792,7 @@ function settingsHaveAgentTeams() {
   try {
     const home = process.env.HOME || "";
     const settings = JSON.parse(
-      fs10.readFileSync(`${home}/.claude/settings.json`, "utf-8")
+      fs12.readFileSync(`${home}/.claude/settings.json`, "utf-8")
     );
     return settings?.env?.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS === "1";
   } catch {
@@ -4608,7 +4803,7 @@ function pluginInstalled(pluginKey) {
   try {
     const home = process.env.HOME || "";
     const plugins = JSON.parse(
-      fs10.readFileSync(
+      fs12.readFileSync(
         `${home}/.claude/plugins/installed_plugins.json`,
         "utf-8"
       )
@@ -4640,7 +4835,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") || fs12.existsSync("/Applications/Obsidian.app")));
   results.push(check("Node.js >= 18", nodeVersionOk()));
   results.push(
     check(
@@ -4713,7 +4908,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 = path14.dirname(userDest.path);
     let status;
     try {
       await stat(dir);
@@ -4726,7 +4921,7 @@ var doctorCommand = new Command("doctor").description("Check system health and p
   results.push(
     check(
       "Squadrant config exists",
-      fs10.existsSync(
+      fs12.existsSync(
         process.env.SQUADRANT_CONFIG || `${process.env.HOME}/.config/squadrant/config.json`
       )
     )
@@ -4799,39 +4994,39 @@ init_dist();
 init_dist3();
 init_dist();
 import { Command as Command2 } from "commander";
-import fs11 from "fs";
-import path14 from "path";
+import fs13 from "fs";
+import path15 from "path";
 import os6 from "os";
 import chalk4 from "chalk";
 function findPackageRoot() {
-  let dir = path14.dirname(new URL(import.meta.url).pathname);
+  let dir = path15.dirname(new URL(import.meta.url).pathname);
   while (dir !== "/") {
-    if (fs11.existsSync(path14.join(dir, "package.json"))) return dir;
-    dir = path14.dirname(dir);
+    if (fs13.existsSync(path15.join(dir, "package.json"))) return dir;
+    dir = path15.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);
+  fs13.mkdirSync(dest, { recursive: true });
+  for (const entry of fs13.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path15.join(src, entry.name);
+    const destPath = path15.join(dest, entry.name);
     if (entry.isDirectory()) {
       copyDirRecursive(srcPath, destPath);
     } else {
-      fs11.copyFileSync(srcPath, destPath);
+      fs13.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 = path15.join(os6.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 (fs13.existsSync(DEFAULT_CONFIG_PATH)) {
+      const existing = JSON.parse(fs13.readFileSync(DEFAULT_CONFIG_PATH, "utf-8"));
       const wsName = existing.workspace ?? "obsidian";
       registry.get(wsName);
     }
@@ -4839,7 +5034,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 (fs13.existsSync(DEFAULT_CONFIG_PATH)) {
     console.log(chalk4.yellow("  \u26A0 Config already exists, skipping creation"));
   } else {
     const config = getDefaultConfig();
@@ -4847,37 +5042,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 = path15.join(pkgRoot, "obsidian", "hub");
+  if (fs13.existsSync(hubPath)) {
     console.log(chalk4.yellow(`  \u26A0 Hub vault already exists at ${hubPath}, skipping`));
-  } else if (fs11.existsSync(hubTemplate)) {
+  } else if (fs13.existsSync(hubTemplate)) {
     copyDirRecursive(hubTemplate, hubPath);
     console.log(chalk4.green(`  \u2714 Hub vault scaffolded at ${hubPath}`));
   } else {
-    fs11.mkdirSync(hubPath, { recursive: true });
+    fs13.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 = path15.join(pkgRoot, "obsidian", "hub", "dashboard.md");
+  const hubDashboardDest = path15.join(hubPath, "dashboard.md");
+  if (fs13.existsSync(hubDashboardSrc)) {
+    fs13.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 = path15.join(hubPath, "projects");
+  fs13.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 = path15.join(os6.homedir(), ".claude", "settings.json");
   try {
     let settings = {};
-    if (fs11.existsSync(settingsPath)) {
-      settings = JSON.parse(fs11.readFileSync(settingsPath, "utf-8"));
+    if (fs13.existsSync(settingsPath)) {
+      settings = JSON.parse(fs13.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");
+      fs13.mkdirSync(path15.dirname(settingsPath), { recursive: true });
+      fs13.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"));
@@ -4898,7 +5093,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 (!fs13.existsSync("/Applications/cmux.app")) {
     console.log(chalk4.yellow("  \u26A0 cmux not found \u2014 download from https://cmux.dev\n"));
   }
 });
@@ -4906,26 +5101,26 @@ 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 fs14 from "fs";
+import path16 from "path";
 import chalk5 from "chalk";
 function findPackageRoot2() {
-  let dir = path15.dirname(new URL(import.meta.url).pathname);
+  let dir = path16.dirname(new URL(import.meta.url).pathname);
   while (dir !== "/") {
-    if (fs12.existsSync(path15.join(dir, "package.json"))) return dir;
-    dir = path15.dirname(dir);
+    if (fs14.existsSync(path16.join(dir, "package.json"))) return dir;
+    dir = path16.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);
+  fs14.mkdirSync(dest, { recursive: true });
+  for (const entry of fs14.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path16.join(src, entry.name);
+    const destPath = path16.join(dest, entry.name);
     if (entry.isDirectory()) {
       copyDirRecursive2(srcPath, destPath);
     } else {
-      fs12.copyFileSync(srcPath, destPath);
+      fs14.copyFileSync(srcPath, destPath);
     }
   }
 }
@@ -4961,7 +5156,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 (!fs14.existsSync(path16.join(resolvedPath, ".git"))) {
     console.log(chalk5.yellow(`
   \u26A0 No .git found at ${resolvedPath}. Make sure this is the project root, not a parent directory.
 `));
@@ -5014,7 +5209,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) : path16.join(config.hubVault, "spokes", name);
   const project = {
     path: resolvedPath,
     captainName,
@@ -5028,20 +5223,20 @@ var addCmd = new Command3("add").description("Register a project").argument("<na
   console.log(chalk5.green(`
   \u2714 Project '${name}' registered`));
   const pkgRoot = findPackageRoot2();
-  const spokeTemplate = path15.join(pkgRoot, "obsidian", "spoke");
-  if (fs12.existsSync(spokeVault)) {
+  const spokeTemplate = path16.join(pkgRoot, "obsidian", "spoke");
+  if (fs14.existsSync(spokeVault)) {
     console.log(chalk5.yellow(`  \u26A0 Spoke vault already exists at ${spokeVault}, skipping scaffold`));
-  } else if (fs12.existsSync(spokeTemplate)) {
+  } else if (fs14.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 = path16.join(spokeVault, "status.md");
+    if (fs14.existsSync(statusPath)) {
+      const content = fs14.readFileSync(statusPath, "utf-8");
       const updated = content.replace(/^project: unnamed/m, `project: ${name}`);
-      fs12.writeFileSync(statusPath, updated);
+      fs14.writeFileSync(statusPath, updated);
     }
     console.log(chalk5.green(`  \u2714 Spoke vault scaffolded at ${spokeVault}`));
   } else {
-    fs12.mkdirSync(spokeVault, { recursive: true });
+    fs14.mkdirSync(spokeVault, { recursive: true });
     console.log(chalk5.yellow(`  \u26A0 Spoke template not found; created empty dir at ${spokeVault}`));
   }
   console.log("");
@@ -5142,10 +5337,10 @@ init_dist4();
 init_dist();
 import { Command as Command5 } from "commander";
 import { execSync as execSync9 } from "child_process";
-import path16 from "path";
+import path17 from "path";
 import os7 from "os";
 import chalk7 from "chalk";
-var TEMPLATES_DIR = path16.join(os7.homedir(), ".config", "squadrant", "templates");
+var TEMPLATES_DIR = path17.join(os7.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.",
@@ -5178,7 +5373,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 = path17.join(TEMPLATES_DIR, `command.${agent.templateSuffix}.md`);
   const cliCommand = agent.buildCommand({
     prompt,
     workdir: process.cwd(),
@@ -5205,8 +5400,8 @@ 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 fs15 from "fs";
+import path18 from "path";
 import os8 from "os";
 import chalk9 from "chalk";
 
@@ -5874,7 +6069,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 = path18.join(os8.homedir(), ".config", "squadrant", "templates");
 async function runCrewSpawn(input) {
   const config = loadConfig();
   const proj = config.projects[input.project];
@@ -5922,8 +6117,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 = path18.join(TEMPLATES_DIR2, `crew.${agent.templateSuffix}.md`);
+    const roleInstructions = fs15.existsSync(codexRoleFile) ? fs15.readFileSync(codexRoleFile, "utf8") : void 0;
     return runCodexInteractiveSpawn({
       project: input.project,
       task: input.task,
@@ -5936,7 +6131,7 @@ async function runCrewSpawn(input) {
       roleInstructions
     });
   }
-  const promptFile = path17.join(TEMPLATES_DIR2, `crew.${agent.templateSuffix}.md`);
+  const promptFile = path18.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;
@@ -5993,7 +6188,7 @@ ${buildCompletionProtocol(rec.id, input.project)}`, preLaunchScreen);
     });
     const rec = await squadrantdCall(req);
     const opencodeConfigPath = writePerCrewOpencodeConfig({
-      stateRoot: path17.join(os8.homedir(), ".config", "squadrant", "state"),
+      stateRoot: path18.join(os8.homedir(), ".config", "squadrant", "state"),
       project: input.project,
       taskId: rec.id,
       // CP3 opt-in: --approval gates bash so the captain approves shell commands.
@@ -6233,11 +6428,11 @@ init_dist3();
 init_dist();
 init_dist();
 import { Command as Command10 } from "commander";
-import fs14 from "fs";
-import path18 from "path";
+import fs16 from "fs";
+import path19 from "path";
 import os9 from "os";
 import chalk10 from "chalk";
-var TEMPLATES_DIR3 = path18.join(os9.homedir(), ".config", "squadrant", "templates");
+var TEMPLATES_DIR3 = path19.join(os9.homedir(), ".config", "squadrant", "templates");
 var SIDE_ROLES = ["research", "debug"];
 function shellQuote2(p) {
   return "'" + p.replace(/'/g, "'\\''") + "'";
@@ -6328,7 +6523,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 = path19.join(
     TEMPLATES_DIR3,
     `side.${input.role}.${agent.templateSuffix}.md`
   );
@@ -6339,7 +6534,7 @@ async function runSideSpawn(input) {
     prompt: input.topic,
     workdir: spawnCwd,
     role: "side",
-    promptFile: fs14.existsSync(promptFile) ? promptFile : void 0,
+    promptFile: fs16.existsSync(promptFile) ? promptFile : void 0,
     interactive: true,
     permissionMode: config.defaults.permissions?.crew ?? "auto",
     ...sideModel ? { model: sideModel } : {}
@@ -6396,7 +6591,7 @@ async function runSideClose(project, name) {
       project,
       name
     );
-    if (fs14.existsSync(wtPath)) {
+    if (fs16.existsSync(wtPath)) {
       try {
         removeWorktree(proj.path, wtPath);
       } catch (e) {
@@ -6624,8 +6819,8 @@ function renderDashboard(rows, opts) {
 
 // packages/web/dist/sync-hub.js
 init_dist();
-import fs15 from "fs";
-import path19 from "path";
+import fs17 from "fs";
+import path20 from "path";
 function buildMirrorMarkdown(s) {
   const fenced = "```";
   return [
@@ -6651,15 +6846,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) => fs17.writeFileSync(p, c));
+  const mkdir5 = deps.mkdir ?? ((p) => fs17.mkdirSync(p, { recursive: true }));
+  const projectsDir = path20.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 = path20.join(projectsDir, `${s.project}.md`);
     try {
       writeFile5(hubPath, buildMirrorMarkdown(s));
       out.push({ project: s.project, hubPath });
@@ -7548,13 +7743,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 fs18 from "fs";
+import path21 from "path";
 import os10 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 = path21.join(os10.homedir(), ".config", "squadrant", "templates");
+var SESSIONS_PATH2 = path21.join(os10.homedir(), ".config", "squadrant", "sessions.json");
 function ensureCmuxReady() {
   if (isInsideCmux()) return;
   console.log(chalk13.yellow("\n  Not running inside cmux. Opening cmux app...\n"));
@@ -7661,12 +7856,12 @@ var launchCommand = new Command12("launch").description(
   }
   if (opts.all) {
     const hubPath = resolveHome(config.hubVault);
-    fs16.mkdirSync(hubPath, { recursive: true });
+    fs18.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 (!fs18.existsSync(spokePath)) {
         const spokeDriver = new WorkspaceRegistry({ obsidian: createObsidianDriver }).forProject(name, config);
         await ensureSpokeLayout(spokeDriver);
         console.log(chalk13.cyan(`  \u2714 Created spoke vault at ${spokePath}`));
@@ -7697,7 +7892,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 (!fs18.existsSync(spokePath)) {
       const spokeDriver = new WorkspaceRegistry({ obsidian: createObsidianDriver }).forProject(project, config);
       await ensureSpokeLayout(spokeDriver);
       console.log(chalk13.cyan(`  \u2714 Created spoke vault at ${spokePath}`));
@@ -7832,23 +8027,31 @@ 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 fs19 from "fs";
 import os11 from "os";
-import path21 from "path";
+import path22 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 = path22.join(path22.dirname(fileURLToPath3(import.meta.url)), "..", "package.json");
+    return JSON.parse(fs19.readFileSync(pkgPath, "utf-8")).version ?? "unknown";
+  } catch {
+    return "unknown";
+  }
+}
 function readMetrics(metricsPath) {
   try {
-    return JSON.parse(fs17.readFileSync(metricsPath, "utf-8"));
+    return JSON.parse(fs19.readFileSync(metricsPath, "utf-8"));
   } catch {
     return {};
   }
 }
-function buildIssueUrl(metrics) {
+function buildIssueUrl(metrics, squadrantVersion) {
   const nodeVersion = process.versions.node;
   const platform = process.platform;
-  const squadrantVersion = "0.1.0";
   const body = [
     "## Feedback / Bug Report",
     "",
@@ -7879,9 +8082,10 @@ function buildIssueUrl(metrics) {
 }
 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 || path22.join(os11.homedir(), ".config", "squadrant", "metrics.json");
   const metrics = readMetrics(metricsPath);
-  const issueUrl = buildIssueUrl(metrics);
+  const version = readStamp(config) ?? readPkgVersion();
+  const issueUrl = buildIssueUrl(metrics, version);
   console.log(chalk15.bold("\nOpening feedback issue in browser...\n"));
   console.log(chalk15.dim(`  URL: ${issueUrl.substring(0, 80)}...
 `));
@@ -7900,8 +8104,8 @@ init_dist();
 init_dist();
 init_dist3();
 import { Command as Command15 } from "commander";
-import fs18 from "fs";
-import path22 from "path";
+import fs20 from "fs";
+import path23 from "path";
 import chalk16 from "chalk";
 import matter3 from "gray-matter";
 function getDateStr(yesterday) {
@@ -7910,11 +8114,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 = path23.join(spokeVault, "status.md");
   let status = {};
-  if (fs18.existsSync(statusFile)) {
+  if (fs20.existsSync(statusFile)) {
     try {
-      status = matter3(fs18.readFileSync(statusFile, "utf-8")).data;
+      status = matter3(fs20.readFileSync(statusFile, "utf-8")).data;
     } catch {
     }
   }
@@ -8032,15 +8236,15 @@ init_dist();
 init_dist();
 init_dist3();
 import { Command as Command16 } from "commander";
-import fs19 from "fs";
-import path23 from "path";
+import fs21 from "fs";
+import path24 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 = path24.join(spokeVault, "status.md");
+  if (!fs21.existsSync(statusFile)) return {};
   try {
-    return matter4(fs19.readFileSync(statusFile, "utf-8")).data;
+    return matter4(fs21.readFileSync(statusFile, "utf-8")).data;
   } catch {
     return {};
   }
@@ -8350,9 +8554,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: path27 } = resolveTargetAndPath(arg1, arg2, !!opts.hub);
     const driver = resolveDriver(registry, config, projectTarget, !!opts.hub);
-    const content = await driver.read(path26);
+    const content = await driver.read(path27);
     process.stdout.write(content);
   } catch (err) {
     console.error(chalk19.red(err.message));
@@ -8364,26 +8568,26 @@ workspaceCommand.command("write").description("Write content to a scope-relative
   const registry = buildRegistry2();
   try {
     let projectTarget;
-    let path26;
+    let path27;
     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;
+      path27 = arg1;
       rawContent = arg2;
     } else {
       if (arg3 === void 0) {
         throw new Error("Missing content \u2014 usage: <project> <path> <content>");
       }
       projectTarget = arg1;
-      path26 = arg2;
+      path27 = 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(path27, payload);
   } catch (err) {
     console.error(chalk19.red(err.message));
     process.exit(1);
@@ -8393,9 +8597,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: path27 } = resolveTargetAndPath(arg1, arg2, !!opts.hub);
     const driver = resolveDriver(registry, config, projectTarget, !!opts.hub);
-    const entries = await driver.list(path26);
+    const entries = await driver.list(path27);
     for (const entry of entries) console.log(entry);
   } catch (err) {
     console.error(chalk19.red(err.message));
@@ -8406,9 +8610,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: path27 } = resolveTargetAndPath(arg1, arg2, !!opts.hub);
     const driver = resolveDriver(registry, config, projectTarget, !!opts.hub);
-    const ok = await driver.exists(path26);
+    const ok = await driver.exists(path27);
     process.exit(ok ? 0 : 1);
   } catch (err) {
     console.error(chalk19.red(err.message));
@@ -8419,9 +8623,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: path27 } = resolveTargetAndPath(arg1, arg2, !!opts.hub);
     const driver = resolveDriver(registry, config, projectTarget, !!opts.hub);
-    await driver.mkdir(path26);
+    await driver.mkdir(path27);
   } catch (err) {
     console.error(chalk19.red(err.message));
     process.exit(1);
@@ -8460,9 +8664,9 @@ init_dist3();
 init_dist();
 import { Command as Command20 } from "commander";
 import chalk21 from "chalk";
-import fs20 from "fs";
-import path24 from "path";
-import { fileURLToPath as fileURLToPath3 } from "url";
+import fs22 from "fs";
+import path25 from "path";
+import { fileURLToPath as fileURLToPath4 } from "url";
 function parseScope(v) {
   if (v !== "user" && v !== "project") {
     throw new Error("--scope must be 'user' or 'project'");
@@ -8470,10 +8674,10 @@ function parseScope(v) {
   return v;
 }
 function findPackageRoot3() {
-  let dir = path24.dirname(fileURLToPath3(import.meta.url));
+  let dir = path25.dirname(fileURLToPath4(import.meta.url));
   while (dir !== "/" && dir !== "") {
-    if (fs20.existsSync(path24.join(dir, "package.json"))) return dir;
-    dir = path24.dirname(dir);
+    if (fs22.existsSync(path25.join(dir, "package.json"))) return dir;
+    dir = path25.dirname(dir);
   }
   return process.cwd();
 }
@@ -8667,12 +8871,12 @@ init_dist();
 init_dist();
 init_dist();
 import { Command as Command22 } from "commander";
-import fs21 from "fs";
-import { fileURLToPath as fileURLToPath4 } from "url";
+import fs23 from "fs";
+import { fileURLToPath as fileURLToPath5 } from "url";
 import { dirname as dirname5, join as join19 } from "path";
 import chalk22 from "chalk";
 function runConfigCheck(opts) {
-  const raw = JSON.parse(fs21.readFileSync(opts.configPath, "utf-8"));
+  const raw = JSON.parse(fs23.readFileSync(opts.configPath, "utf-8"));
   const def = getDefaultConfig();
   const items = detectDrift(raw, def);
   let working = raw;
@@ -8689,10 +8893,40 @@ function runConfigCheck(opts) {
     stamped = true;
   }
   if (opts.fix || opts.accept || stamped) {
-    fs21.writeFileSync(opts.configPath, JSON.stringify(working, null, 2) + "\n");
+    fs23.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);
+}
 var SEV_COLOR = {
   info: chalk22.green,
   advisory: chalk22.yellow,
@@ -8713,8 +8947,8 @@ 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 = readPkgVersion();
-  if (!fs21.existsSync(DEFAULT_CONFIG_PATH)) {
+  const pkgVersion = readPkgVersion2();
+  if (!fs23.existsSync(DEFAULT_CONFIG_PATH)) {
     console.log(chalk22.yellow("No config found \u2014 run `squadrant init` first."));
     return;
   }
@@ -8741,9 +8975,27 @@ ${judgment.length} item(s) need review \u2014 run the config-doctor skill, or \`
     console.log(chalk22.green("\n\u2714 Config reconciled and stamped."));
   }
 });
-function readPkgVersion() {
-  const pkgPath = join19(dirname5(fileURLToPath4(import.meta.url)), "..", "package.json");
-  return JSON.parse(fs21.readFileSync(pkgPath, "utf-8")).version;
+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)").action((key, value) => {
+  try {
+    runConfigSet(key, value);
+    console.log(chalk22.green(`\u2714 set ${key} = ${value}`));
+  } 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(fs23.readFileSync(pkgPath, "utf-8")).version;
 }
 
 // packages/cli/src/commands/heal.ts
@@ -9009,8 +9261,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 fs24 from "fs";
+import path26 from "path";
 import { Command as Command26 } from "commander";
 import chalk26 from "chalk";
 var VALID_EFFORTS = ["max", "balance", "low"];
@@ -9037,9 +9289,9 @@ function runEffortSet(value, configPath = DEFAULT_CONFIG_PATH) {
 }
 function canonical(p) {
   try {
-    return fs22.realpathSync(p);
+    return fs24.realpathSync(p);
   } catch {
-    return path25.resolve(p);
+    return path26.resolve(p);
   }
 }
 async function notifyCaptainsOfEffort(effort, config, driver, cwd = process.cwd()) {
@@ -9083,19 +9335,232 @@ 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 join21, dirname as dirname6 } from "path";
+import { emitKeypressEvents } from "readline";
+import { Command as Command27 } from "commander";
+import chalk27 from "chalk";
+function defaultStateRoot() {
+  return join21(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 };
+}
+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()));
+    });
+  });
+}
+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").action(async () => {
+  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"));
+  console.log("Paste your bot token then press Enter (input is hidden):");
+  const token = await questionMasked();
+  if (!token) {
+    console.error(chalk27.red("token required"));
+    process.exit(1);
+  }
+  const client = createTelegramClient({ token });
+  let botUser;
+  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 Find your group"));
+  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"));
+  let supergroupId;
+  let userId;
+  try {
+    ({ supergroupId, userId } = 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)."));
+  let users;
+  let remoteControl;
+  if (userId === void 0) {
+    console.log(chalk27.yellow("Could not read your user-id from that message \u2014 skipping remote control."));
+    console.log(chalk27.yellow("Re-run setup once it's available, or edit telegram.users in config manually."));
+  } else {
+    const enable = await questionYesNo(
+      `Enable remote control for your user-id ${userId}? [y/N] `
+    );
+    if (enable) {
+      users = [userId];
+      remoteControl = true;
+    }
+  }
+  writeTelegramConfig(DEFAULT_CONFIG_PATH, { token, supergroupId, users, remoteControl });
+  console.log(chalk27.green(`Wrote telegram config \u2014 token: ${maskToken(token)}  group: ${supergroupId}`));
+  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 setup to enable later."));
+  }
+  console.log();
+  console.log(`Next: ${chalk27.cyan("squadrant telegram link <project>")}`);
+});
+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);
+  }
+  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(fileURLToPath5(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(join22(__dirname, "..", "package.json"), "utf-8"));
 ensureRuntimeSynced({
-  sourceRoot: join21(__dirname, ".."),
-  runtimeRoot: join21(homedir14(), ".config", "squadrant")
+  sourceRoot: join22(__dirname, ".."),
+  runtimeRoot: join22(homedir14(), ".config", "squadrant")
 });
 if (process.argv[2] !== "config") {
   try {
-    const cfgPath = join21(homedir14(), ".config", "squadrant", "config.json");
+    const cfgPath = join22(homedir14(), ".config", "squadrant", "config.json");
     if (existsSync10(cfgPath)) {
       const cfg = JSON.parse(readFileSync11(cfgPath, "utf-8"));
       if (needsCheck(cfg, pkg.version)) {
@@ -9120,7 +9585,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);
@@ -9146,6 +9611,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)}
 `);