squadrant 0.10.0 → 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 path27 = opts.path ?? defaultCmuxConfigPath();
-  if (!existsSync(path27)) {
-    mkdirSync(dirname(path27), { recursive: true });
-    writeFileSync(path27, MINIMAL_TEMPLATE);
-    return { path: path27, 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(path27, "utf-8");
+  const text = readFileSync(path29, "utf-8");
   const current = parse(text)?.automation?.socketControlMode;
   if (current === AUTOMATION_MODE) {
-    return { path: path27, 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(path27, applyEdits(text, edits));
-  return { path: path27, 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,9 +380,9 @@ import { dirname as dirname2, join as join4 } from "path";
 function defaultStatePath() {
   return join4(homedir3(), ".config", "squadrant", "state", "cmux-autoconfig.json");
 }
-function readState(path27) {
+function readState(path29) {
   try {
-    return JSON.parse(readFileSync4(path27, "utf-8"));
+    return JSON.parse(readFileSync4(path29, "utf-8"));
   } catch {
     return {};
   }
@@ -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(path27) {
+function sanitizePathForPlist(path29) {
   const seen = /* @__PURE__ */ new Set();
   const stable = [];
-  for (const p of path27.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,25 @@ 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"() {
@@ -1604,35 +1704,47 @@ var init_format = __esm({
 });
 
 // packages/core/dist/telegram/state.js
-import fs8 from "fs";
-import path7 from "path";
+import fs9 from "fs";
+import path8 from "path";
 function statePath(stateRoot) {
-  return path7.join(stateRoot, "telegram-state.json");
+  return path8.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 raw = fs9.readFileSync(statePath(stateRoot), "utf-8");
     const data = JSON.parse(raw);
-    return {
+    const result = {
       offset: typeof data.offset === "number" ? data.offset : 0,
-      topics: data.topics ?? {}
+      topics: data.topics ?? {},
+      notify: data.notify ?? {}
     };
+    if (typeof data.lastUserId === "number")
+      result.lastUserId = data.lastUserId;
+    return result;
   } catch {
-    return { offset: 0, topics: {} };
+    return { offset: 0, topics: {}, notify: {} };
   }
 }
 function saveState(stateRoot, s) {
-  fs8.mkdirSync(stateRoot, { recursive: true });
-  fs8.writeFileSync(statePath(stateRoot), JSON.stringify(s, null, 2) + "\n");
+  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"() {
   }
@@ -1664,15 +1776,29 @@ function createTelegramClient(opts) {
     getUpdates(offset, timeoutSec = 50) {
       return call("getUpdates", { offset, timeout: timeoutSec });
     },
-    async sendMessage(chatId, threadId, text) {
+    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 });
     }
   };
 }
@@ -1681,18 +1807,49 @@ var init_client = __esm({
   }
 });
 
+// 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 fs9 from "fs";
+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)));
@@ -1715,7 +1872,7 @@ function writeTelegramConfig(configPath, opts) {
   let config;
   let raw = null;
   try {
-    raw = fs9.readFileSync(configPath, "utf-8");
+    raw = fs10.readFileSync(configPath, "utf-8");
   } catch (err) {
     if (err.code !== "ENOENT") {
       throw new Error(`refusing to overwrite unreadable config at ${configPath}: ${String(err)}`);
@@ -1743,7 +1900,7 @@ function writeTelegramConfig(configPath, opts) {
   if (remoteControl !== void 0)
     next.remoteControl = remoteControl;
   config.telegram = next;
-  fs9.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+  fs10.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
 }
 var init_setup = __esm({
   "packages/core/dist/telegram/setup.js"() {
@@ -1753,6 +1910,7 @@ var init_setup = __esm({
 // 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();
@@ -2308,13 +2466,13 @@ var init_notifiers = __esm({
 });
 
 // packages/workspaces/dist/workspaces/obsidian.js
-import fs10 from "fs/promises";
+import fs11 from "fs/promises";
 import { existsSync as existsSync8 } from "fs";
-import path8 from "path";
+import path10 from "path";
 function resolveInRoot(root, relative) {
-  const joined = path8.resolve(root, relative);
-  const normalized = path8.resolve(root) + path8.sep;
-  if (joined !== path8.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;
@@ -2333,16 +2491,16 @@ function createObsidianDriver(scope) {
       };
     },
     async read(rel) {
-      return fs10.readFile(resolveInRoot(root, rel), "utf-8");
+      return fs11.readFile(resolveInRoot(root, rel), "utf-8");
     },
     async write(rel, content) {
       const abs = resolveInRoot(root, rel);
-      await fs10.mkdir(path8.dirname(abs), { recursive: true });
-      await fs10.writeFile(abs, content);
+      await fs11.mkdir(path10.dirname(abs), { recursive: true });
+      await fs11.writeFile(abs, content);
     },
     async exists(rel) {
       try {
-        await fs10.access(resolveInRoot(root, rel));
+        await fs11.access(resolveInRoot(root, rel));
         return true;
       } catch {
         return false;
@@ -2350,13 +2508,13 @@ function createObsidianDriver(scope) {
     },
     async list(rel) {
       try {
-        return await fs10.readdir(resolveInRoot(root, rel));
+        return await fs11.readdir(resolveInRoot(root, rel));
       } catch {
         return [];
       }
     },
     async mkdir(rel) {
-      await fs10.mkdir(resolveInRoot(root, rel), { recursive: true });
+      await fs11.mkdir(resolveInRoot(root, rel), { recursive: true });
     }
   };
 }
@@ -3025,8 +3183,8 @@ var init_registry4 = __esm({
 });
 
 // packages/agents/dist/drivers/launch-cmd.js
-import fs11 from "fs";
-import path9 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") {
@@ -3042,27 +3200,27 @@ function buildAgentCmd(agentName, registry, role, fresh, permissionMode, model,
       cmd += ` --model ${model}`;
     }
     if (templatesDir) {
-      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;
+      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 = path9.join(templatesDir, "..", "plugin");
-      if (fs11.existsSync(pluginDir)) {
+      const pluginDir = path11.join(templatesDir, "..", "plugin");
+      if (fs12.existsSync(pluginDir)) {
         cmd += ` --plugin-dir ${pluginDir}`;
       }
     }
     return cmd;
   }
-  const roleFile = templatesDir ? path9.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 && fs11.existsSync(roleFile) ? roleFile : void 0
+    promptFile: roleFile && fs12.existsSync(roleFile) ? roleFile : void 0
   });
 }
 var init_launch_cmd = __esm({
@@ -3085,8 +3243,8 @@ var init_drivers = __esm({
 
 // packages/agents/dist/projection/cursor.js
 import { mkdir, readFile, writeFile } from "fs/promises";
-import path10 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}
 
@@ -3134,7 +3292,7 @@ function createCursorEmitter() {
       if (scope === "user") {
         return [
           {
-            path: path10.join(os2.homedir(), ".cursor/rules/squadrant-global.mdc"),
+            path: path12.join(os4.homedir(), ".cursor/rules/squadrant-global.mdc"),
             shared: false,
             format: "mdc"
           }
@@ -3144,7 +3302,7 @@ function createCursorEmitter() {
         return [];
       return [
         {
-          path: path10.join(projectRoot, ".cursor/rules/squadrant.mdc"),
+          path: path12.join(projectRoot, ".cursor/rules/squadrant.mdc"),
           shared: false,
           format: "mdc"
         }
@@ -3161,7 +3319,7 @@ function createCursorEmitter() {
           diff: buildDiff(existing, generated)
         };
       }
-      await mkdir(path10.dirname(dest.path), { recursive: true });
+      await mkdir(path12.dirname(dest.path), { recursive: true });
       await writeFile(dest.path, generated, "utf-8");
       return {
         written: true,
@@ -3212,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 path11 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}
 
@@ -3237,7 +3395,7 @@ function createCodexEmitter() {
     destinations(scope, projectRoot) {
       if (scope === "user") {
         return [{
-          path: path11.join(os3.homedir(), ".codex/AGENTS.md"),
+          path: path13.join(os5.homedir(), ".codex/AGENTS.md"),
           shared: true,
           format: "markdown"
         }];
@@ -3245,7 +3403,7 @@ function createCodexEmitter() {
       if (!projectRoot)
         return [];
       return [{
-        path: path11.join(projectRoot, "AGENTS.md"),
+        path: path13.join(projectRoot, "AGENTS.md"),
         shared: true,
         format: "markdown"
       }];
@@ -3266,7 +3424,7 @@ ${existing ?? ""}
 ${generated}`
         };
       }
-      await mkdir2(path11.dirname(dest.path), { recursive: true });
+      await mkdir2(path13.dirname(dest.path), { recursive: true });
       await writeFile2(dest.path, generated, "utf-8");
       return {
         written: true,
@@ -3284,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 path12 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}
 
@@ -3309,7 +3467,7 @@ function createGeminiEmitter() {
     destinations(scope, projectRoot) {
       if (scope === "user") {
         return [{
-          path: path12.join(os4.homedir(), ".gemini/GEMINI.md"),
+          path: path14.join(os6.homedir(), ".gemini/GEMINI.md"),
           shared: true,
           format: "markdown"
         }];
@@ -3317,7 +3475,7 @@ function createGeminiEmitter() {
       if (!projectRoot)
         return [];
       return [{
-        path: path12.join(projectRoot, "GEMINI.md"),
+        path: path14.join(projectRoot, "GEMINI.md"),
         shared: true,
         format: "markdown"
       }];
@@ -3338,7 +3496,7 @@ ${existing ?? ""}
 ${generated}`
         };
       }
-      await mkdir3(path12.dirname(dest.path), { recursive: true });
+      await mkdir3(path14.dirname(dest.path), { recursive: true });
       await writeFile3(dest.path, generated, "utf-8");
       return {
         written: true,
@@ -3356,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 path13 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}
 
@@ -3381,7 +3539,7 @@ function createOpencodeEmitter() {
     destinations(scope, projectRoot) {
       if (scope === "user") {
         return [{
-          path: path13.join(os5.homedir(), ".config", "opencode", "AGENTS.md"),
+          path: path15.join(os7.homedir(), ".config", "opencode", "AGENTS.md"),
           shared: true,
           format: "markdown"
         }];
@@ -3389,7 +3547,7 @@ function createOpencodeEmitter() {
       if (!projectRoot)
         return [];
       return [{
-        path: path13.join(projectRoot, "AGENTS.md"),
+        path: path15.join(projectRoot, "AGENTS.md"),
         shared: true,
         format: "markdown"
       }];
@@ -3410,7 +3568,7 @@ ${existing ?? ""}
 ${generated}`
         };
       }
-      await mkdir4(path13.dirname(dest.path), { recursive: true });
+      await mkdir4(path15.dirname(dest.path), { recursive: true });
       await writeFile4(dest.path, generated, "utf-8");
       return {
         written: true,
@@ -4275,8 +4433,8 @@ function resolveLastAssistantText(payload) {
   const derived = deriveTranscriptPath(p?.session_id, cwd);
   if (derived)
     candidates.push(derived);
-  for (const path27 of candidates) {
-    const text = readLastAssistantText(path27);
+  for (const path29 of candidates) {
+    const text = readLastAssistantText(path29);
     if (text != null)
       return text;
   }
@@ -4676,10 +4834,10 @@ var init_dist4 = __esm({
 init_dist();
 init_dist2();
 import { Command as Command28 } from "commander";
-import { readFileSync as readFileSync11, existsSync as existsSync10, writeFileSync as writeFileSync9 } from "fs";
+import { readFileSync as readFileSync11, existsSync as existsSync11, writeFileSync as writeFileSync9 } from "fs";
 import { fileURLToPath as fileURLToPath6 } from "url";
-import { dirname as dirname7, join as join22 } 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();
@@ -4688,9 +4846,9 @@ init_dist();
 init_dist3();
 import { Command } from "commander";
 import { execSync as execSync8 } from "child_process";
-import fs12 from "fs";
+import fs13 from "fs";
 import { stat } from "fs/promises";
-import path14 from "path";
+import path16 from "path";
 import chalk3 from "chalk";
 
 // packages/cli/src/commands/health-view.ts
@@ -4792,7 +4950,7 @@ function settingsHaveAgentTeams() {
   try {
     const home = process.env.HOME || "";
     const settings = JSON.parse(
-      fs12.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 {
@@ -4803,7 +4961,7 @@ function pluginInstalled(pluginKey) {
   try {
     const home = process.env.HOME || "";
     const plugins = JSON.parse(
-      fs12.readFileSync(
+      fs13.readFileSync(
         `${home}/.claude/plugins/installed_plugins.json`,
         "utf-8"
       )
@@ -4835,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") || fs12.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(
@@ -4908,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 = path14.dirname(userDest.path);
+    const dir = path16.dirname(userDest.path);
     let status;
     try {
       await stat(dir);
@@ -4921,7 +5079,7 @@ var doctorCommand = new Command("doctor").description("Check system health and p
   results.push(
     check(
       "Squadrant config exists",
-      fs12.existsSync(
+      fs13.existsSync(
         process.env.SQUADRANT_CONFIG || `${process.env.HOME}/.config/squadrant/config.json`
       )
     )
@@ -4994,39 +5152,39 @@ init_dist();
 init_dist3();
 init_dist();
 import { Command as Command2 } from "commander";
-import fs13 from "fs";
-import path15 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 = path15.dirname(new URL(import.meta.url).pathname);
+  let dir = path17.dirname(new URL(import.meta.url).pathname);
   while (dir !== "/") {
-    if (fs13.existsSync(path15.join(dir, "package.json"))) return dir;
-    dir = path15.dirname(dir);
+    if (fs14.existsSync(path17.join(dir, "package.json"))) return dir;
+    dir = path17.dirname(dir);
   }
   return process.cwd();
 }
 function copyDirRecursive(src, dest) {
-  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);
+  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 {
-      fs13.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 = path15.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 (fs13.existsSync(DEFAULT_CONFIG_PATH)) {
-      const existing = JSON.parse(fs13.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);
     }
@@ -5034,7 +5192,7 @@ var initCommand = new Command2("init").description("First-time setup: scaffold h
     console.log(chalk4.red(`  \u2718 ${err.message}`));
     return;
   }
-  if (fs13.existsSync(DEFAULT_CONFIG_PATH)) {
+  if (fs14.existsSync(DEFAULT_CONFIG_PATH)) {
     console.log(chalk4.yellow("  \u26A0 Config already exists, skipping creation"));
   } else {
     const config = getDefaultConfig();
@@ -5042,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 = path15.join(pkgRoot, "obsidian", "hub");
-  if (fs13.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 (fs13.existsSync(hubTemplate)) {
+  } else if (fs14.existsSync(hubTemplate)) {
     copyDirRecursive(hubTemplate, hubPath);
     console.log(chalk4.green(`  \u2714 Hub vault scaffolded at ${hubPath}`));
   } else {
-    fs13.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 = path15.join(pkgRoot, "obsidian", "hub", "dashboard.md");
-  const hubDashboardDest = path15.join(hubPath, "dashboard.md");
-  if (fs13.existsSync(hubDashboardSrc)) {
-    fs13.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 = path15.join(hubPath, "projects");
-  fs13.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 = path15.join(os6.homedir(), ".claude", "settings.json");
+  const settingsPath = path17.join(os8.homedir(), ".claude", "settings.json");
   try {
     let settings = {};
-    if (fs13.existsSync(settingsPath)) {
-      settings = JSON.parse(fs13.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" };
-      fs13.mkdirSync(path15.dirname(settingsPath), { recursive: true });
-      fs13.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"));
@@ -5093,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 (!fs13.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"));
   }
 });
@@ -5101,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 fs14 from "fs";
-import path16 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 = path16.dirname(new URL(import.meta.url).pathname);
+  let dir = path18.dirname(new URL(import.meta.url).pathname);
   while (dir !== "/") {
-    if (fs14.existsSync(path16.join(dir, "package.json"))) return dir;
-    dir = path16.dirname(dir);
+    if (fs15.existsSync(path18.join(dir, "package.json"))) return dir;
+    dir = path18.dirname(dir);
   }
   return process.cwd();
 }
 function copyDirRecursive2(src, dest) {
-  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);
+  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 {
-      fs14.copyFileSync(srcPath, destPath);
+      fs15.copyFileSync(srcPath, destPath);
     }
   }
 }
@@ -5147,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(`
@@ -5156,7 +5358,7 @@ var addCmd = new Command3("add").description("Register a project").argument("<na
     process.exit(1);
   }
   const resolvedPath = resolveHome(projectPath);
-  if (!fs14.existsSync(path16.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.
 `));
@@ -5209,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) : path16.join(config.hubVault, "spokes", name);
+  const spokeVault = opts.spoke ? resolveHome(opts.spoke) : path18.join(config.hubVault, "spokes", name);
   const project = {
     path: resolvedPath,
     captainName,
@@ -5222,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 = path16.join(pkgRoot, "obsidian", "spoke");
-  if (fs14.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 (fs14.existsSync(spokeTemplate)) {
+  } else if (fs15.existsSync(spokeTemplate)) {
     copyDirRecursive2(spokeTemplate, spokeVault);
-    const statusPath = path16.join(spokeVault, "status.md");
-    if (fs14.existsSync(statusPath)) {
-      const content = fs14.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}`);
-      fs14.writeFileSync(statusPath, updated);
+      fs15.writeFileSync(statusPath, updated);
     }
     console.log(chalk5.green(`  \u2714 Spoke vault scaffolded at ${spokeVault}`));
   } else {
-    fs14.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("");
@@ -5337,10 +5540,10 @@ init_dist4();
 init_dist();
 import { Command as Command5 } from "commander";
 import { execSync as execSync9 } from "child_process";
-import path17 from "path";
-import os7 from "os";
+import path19 from "path";
+import os9 from "os";
 import chalk7 from "chalk";
-var TEMPLATES_DIR = path17.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.",
@@ -5373,7 +5576,7 @@ async function runCommandSpawn(input) {
   if (!agent) {
     throw new Error(`Unknown agent '${agentName}'. Known: claude, codex, gemini, opencode.`);
   }
-  const promptFile = path17.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(),
@@ -5400,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 fs15 from "fs";
-import path18 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
@@ -5435,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
@@ -5495,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));
@@ -5735,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));
@@ -5840,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;
 }
@@ -5943,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:*)",
@@ -6031,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");
@@ -6046,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",
@@ -6069,7 +6272,7 @@ function writePerCrewOpencodeConfig(o) {
 
 // packages/cli/src/commands/crew.ts
 init_dist2();
-var TEMPLATES_DIR2 = path18.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];
@@ -6117,8 +6320,8 @@ async function runCrewSpawn(input) {
     throw new Error(`Unknown agent '${agentName}'. Known: claude, codex, gemini, opencode.`);
   }
   if (agentName === "codex") {
-    const codexRoleFile = path18.join(TEMPLATES_DIR2, `crew.${agent.templateSuffix}.md`);
-    const roleInstructions = fs15.existsSync(codexRoleFile) ? fs15.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,
@@ -6131,7 +6334,7 @@ async function runCrewSpawn(input) {
       roleInstructions
     });
   }
-  const promptFile = path18.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;
@@ -6188,7 +6391,7 @@ ${buildCompletionProtocol(rec.id, input.project)}`, preLaunchScreen);
     });
     const rec = await squadrantdCall(req);
     const opencodeConfigPath = writePerCrewOpencodeConfig({
-      stateRoot: path18.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.
@@ -6428,11 +6631,11 @@ init_dist3();
 init_dist();
 init_dist();
 import { Command as Command10 } from "commander";
-import fs16 from "fs";
-import path19 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 = path19.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, "'\\''") + "'";
@@ -6523,7 +6726,7 @@ async function runSideSpawn(input) {
     throw new Error(`Unknown agent '${agentName}'. Known: claude, codex, gemini, opencode.`);
   }
   const sideModel = sideRole?.model;
-  const promptFile = path19.join(
+  const promptFile = path21.join(
     TEMPLATES_DIR3,
     `side.${input.role}.${agent.templateSuffix}.md`
   );
@@ -6534,7 +6737,7 @@ async function runSideSpawn(input) {
     prompt: input.topic,
     workdir: spawnCwd,
     role: "side",
-    promptFile: fs16.existsSync(promptFile) ? promptFile : void 0,
+    promptFile: fs17.existsSync(promptFile) ? promptFile : void 0,
     interactive: true,
     permissionMode: config.defaults.permissions?.crew ?? "auto",
     ...sideModel ? { model: sideModel } : {}
@@ -6591,7 +6794,7 @@ async function runSideClose(project, name) {
       project,
       name
     );
-    if (fs16.existsSync(wtPath)) {
+    if (fs17.existsSync(wtPath)) {
       try {
         removeWorktree(proj.path, wtPath);
       } catch (e) {
@@ -6679,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
@@ -6819,8 +7022,8 @@ function renderDashboard(rows, opts) {
 
 // packages/web/dist/sync-hub.js
 init_dist();
-import fs17 from "fs";
-import path20 from "path";
+import fs18 from "fs";
+import path22 from "path";
 function buildMirrorMarkdown(s) {
   const fenced = "```";
   return [
@@ -6846,15 +7049,15 @@ function buildMirrorMarkdown(s) {
 function syncHub(deps) {
   if (!deps.config.hubVault)
     return [];
-  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");
+  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 = path20.join(projectsDir, `${s.project}.md`);
+    const hubPath = path22.join(projectsDir, `${s.project}.md`);
     try {
       writeFile5(hubPath, buildMirrorMarkdown(s));
       out.push({ project: s.project, hubPath });
@@ -6876,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"];
@@ -6914,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 {
@@ -6982,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"));
@@ -7002,7 +7205,7 @@ function defaultProbeRunners() {
       }
     }),
     probeOnPath: async (cli) => onPath(cli),
-    pathExists: (p) => existsSync9(p),
+    pathExists: (p) => existsSync10(p),
     loadConfig: () => loadConfig(),
     loadSessionsHashes: () => readSessionsHashes()
   };
@@ -7655,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+/);
@@ -7743,13 +7946,13 @@ init_dist3();
 init_dist2();
 import { Command as Command12 } from "commander";
 import { execSync as execSync11 } from "child_process";
-import fs18 from "fs";
-import path21 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 = path21.join(os10.homedir(), ".config", "squadrant", "templates");
-var SESSIONS_PATH2 = path21.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"));
@@ -7856,12 +8059,12 @@ var launchCommand = new Command12("launch").description(
   }
   if (opts.all) {
     const hubPath = resolveHome(config.hubVault);
-    fs18.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 (!fs18.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}`));
@@ -7892,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 (!fs18.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}`));
@@ -8027,24 +8230,24 @@ Shutting down captain workspace for '${project}'...
 // packages/cli/src/commands/feedback.ts
 init_dist();
 import { Command as Command14 } from "commander";
-import fs19 from "fs";
-import os11 from "os";
-import path22 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 = path22.join(path22.dirname(fileURLToPath3(import.meta.url)), "..", "package.json");
-    return JSON.parse(fs19.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(fs19.readFileSync(metricsPath, "utf-8"));
+    return JSON.parse(fs20.readFileSync(metricsPath, "utf-8"));
   } catch {
     return {};
   }
@@ -8082,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 || path22.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);
@@ -8104,8 +8307,8 @@ init_dist();
 init_dist();
 init_dist3();
 import { Command as Command15 } from "commander";
-import fs20 from "fs";
-import path23 from "path";
+import fs21 from "fs";
+import path25 from "path";
 import chalk16 from "chalk";
 import matter3 from "gray-matter";
 function getDateStr(yesterday) {
@@ -8114,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 = path23.join(spokeVault, "status.md");
+  const statusFile = path25.join(spokeVault, "status.md");
   let status = {};
-  if (fs20.existsSync(statusFile)) {
+  if (fs21.existsSync(statusFile)) {
     try {
-      status = matter3(fs20.readFileSync(statusFile, "utf-8")).data;
+      status = matter3(fs21.readFileSync(statusFile, "utf-8")).data;
     } catch {
     }
   }
@@ -8236,15 +8439,15 @@ init_dist();
 init_dist();
 init_dist3();
 import { Command as Command16 } from "commander";
-import fs21 from "fs";
-import path24 from "path";
+import fs22 from "fs";
+import path26 from "path";
 import chalk17 from "chalk";
 import matter4 from "gray-matter";
 function readStatus(spokeVault) {
-  const statusFile = path24.join(spokeVault, "status.md");
-  if (!fs21.existsSync(statusFile)) return {};
+  const statusFile = path26.join(spokeVault, "status.md");
+  if (!fs22.existsSync(statusFile)) return {};
   try {
-    return matter4(fs21.readFileSync(statusFile, "utf-8")).data;
+    return matter4(fs22.readFileSync(statusFile, "utf-8")).data;
   } catch {
     return {};
   }
@@ -8554,9 +8757,9 @@ workspaceCommand.command("read").description("Print the contents of a scope-rela
   const config = loadConfig();
   const registry = buildRegistry2();
   try {
-    const { projectTarget, path: path27 } = 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(path27);
+    const content = await driver.read(path29);
     process.stdout.write(content);
   } catch (err) {
     console.error(chalk19.red(err.message));
@@ -8568,26 +8771,26 @@ workspaceCommand.command("write").description("Write content to a scope-relative
   const registry = buildRegistry2();
   try {
     let projectTarget;
-    let path27;
+    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;
-      path27 = arg1;
+      path29 = arg1;
       rawContent = arg2;
     } else {
       if (arg3 === void 0) {
         throw new Error("Missing content \u2014 usage: <project> <path> <content>");
       }
       projectTarget = arg1;
-      path27 = arg2;
+      path29 = arg2;
       rawContent = arg3;
     }
     const driver = resolveDriver(registry, config, projectTarget, !!opts.hub);
     const payload = rawContent === "-" ? await readStdin() : rawContent;
-    await driver.write(path27, payload);
+    await driver.write(path29, payload);
   } catch (err) {
     console.error(chalk19.red(err.message));
     process.exit(1);
@@ -8597,9 +8800,9 @@ workspaceCommand.command("list").description("List entries in a scope-relative d
   const config = loadConfig();
   const registry = buildRegistry2();
   try {
-    const { projectTarget, path: path27 } = 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(path27);
+    const entries = await driver.list(path29);
     for (const entry of entries) console.log(entry);
   } catch (err) {
     console.error(chalk19.red(err.message));
@@ -8610,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: path27 } = 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(path27);
+    const ok = await driver.exists(path29);
     process.exit(ok ? 0 : 1);
   } catch (err) {
     console.error(chalk19.red(err.message));
@@ -8623,9 +8826,9 @@ workspaceCommand.command("mkdir").description("Recursively create a scope-relati
   const config = loadConfig();
   const registry = buildRegistry2();
   try {
-    const { projectTarget, path: path27 } = 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(path27);
+    await driver.mkdir(path29);
   } catch (err) {
     console.error(chalk19.red(err.message));
     process.exit(1);
@@ -8664,8 +8867,8 @@ init_dist3();
 init_dist();
 import { Command as Command20 } from "commander";
 import chalk21 from "chalk";
-import fs22 from "fs";
-import path25 from "path";
+import fs23 from "fs";
+import path27 from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 function parseScope(v) {
   if (v !== "user" && v !== "project") {
@@ -8674,10 +8877,10 @@ function parseScope(v) {
   return v;
 }
 function findPackageRoot3() {
-  let dir = path25.dirname(fileURLToPath4(import.meta.url));
+  let dir = path27.dirname(fileURLToPath4(import.meta.url));
   while (dir !== "/" && dir !== "") {
-    if (fs22.existsSync(path25.join(dir, "package.json"))) return dir;
-    dir = path25.dirname(dir);
+    if (fs23.existsSync(path27.join(dir, "package.json"))) return dir;
+    dir = path27.dirname(dir);
   }
   return process.cwd();
 }
@@ -8871,12 +9074,12 @@ init_dist();
 init_dist();
 init_dist();
 import { Command as Command22 } from "commander";
-import fs23 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(fs23.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;
@@ -8893,7 +9096,7 @@ function runConfigCheck(opts) {
     stamped = true;
   }
   if (opts.fix || opts.accept || stamped) {
-    fs23.writeFileSync(opts.configPath, JSON.stringify(working, null, 2) + "\n");
+    fs24.writeFileSync(opts.configPath, JSON.stringify(working, null, 2) + "\n");
   }
   return { items, applied, remaining, stamped };
 }
@@ -8927,6 +9130,22 @@ function runConfigSet(key, value, configPath = DEFAULT_CONFIG_PATH) {
   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,
@@ -8948,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 (!fs23.existsSync(DEFAULT_CONFIG_PATH)) {
+  if (!fs24.existsSync(DEFAULT_CONFIG_PATH)) {
     console.log(chalk22.yellow("No config found \u2014 run `squadrant init` first."));
     return;
   }
@@ -8984,25 +9203,23 @@ configCommand.command("get").description("Read a config value by dotted key (e.g
     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) => {
+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 {
-    runConfigSet(key, value);
-    console.log(chalk22.green(`\u2714 set ${key} = ${value}`));
+    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(fs23.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: [] };
@@ -9082,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
     });
@@ -9096,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) {
@@ -9261,8 +9478,8 @@ var cmuxCommand = new Command25("cmux").description("cmux integration helpers").
 
 // packages/cli/src/commands/effort.ts
 init_dist();
-import fs24 from "fs";
-import path26 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"];
@@ -9289,9 +9506,9 @@ function runEffortSet(value, configPath = DEFAULT_CONFIG_PATH) {
 }
 function canonical(p) {
   try {
-    return fs24.realpathSync(p);
+    return fs25.realpathSync(p);
   } catch {
-    return path26.resolve(p);
+    return path28.resolve(p);
   }
 }
 async function notifyCaptainsOfEffort(effort, config, driver, cwd = process.cwd()) {
@@ -9338,12 +9555,12 @@ 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 { 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 join21(dirname6(DEFAULT_CONFIG_PATH), "state");
+  return join22(dirname6(DEFAULT_CONFIG_PATH), "state");
 }
 function runTelegramStatus(opts) {
   const tg = opts.config.telegram;
@@ -9363,6 +9580,34 @@ async function runTelegramSend(opts) {
   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 };
@@ -9413,6 +9658,44 @@ async function questionYesNo(prompt) {
     });
   });
 }
+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() });
@@ -9439,7 +9722,7 @@ telegramCommand.command("link").argument("<project>", "project to bind to a Tele
   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 () => {
+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);
@@ -9453,63 +9736,200 @@ telegramCommand.command("setup").description("Interactive wizard \u2014 bot toke
   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 });
+  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;
-  try {
-    botUser = await client.getMe();
-  } catch (e) {
-    console.error(chalk27.red(`token rejected: ${e.message}`));
-    process.exit(1);
+  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.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"));
+  console.log(chalk27.bold("Step 2/3 \u2014 Supergroup"));
+  const groupDecision = resolveSetupGroup(existingCfg?.supergroupId, { redetect: opts.redetect ?? false });
   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);
+  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.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;
-  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 {
+  let printedRemoteControlState = false;
+  if (finalUserId !== void 0) {
     const enable = await questionYesNo(
-      `Enable remote control for your user-id ${userId}? [y/N] `
+      `Enable remote control for your user-id ${finalUserId}? [y/N] `
     );
     if (enable) {
-      users = [userId];
+      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 (remoteControl) {
-    console.log(chalk27.green(`Remote control: ON (allowlisted user-id ${users?.[0]})`));
+  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("Remote control: off (default). Re-run setup to enable later."));
+    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) {
@@ -9521,6 +9941,10 @@ telegramCommand.command("send").argument("<project>", "project whose topic recei
     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(" ");
@@ -9553,15 +9977,15 @@ init_dist();
 init_dist();
 init_dist();
 var __dirname = dirname7(fileURLToPath6(import.meta.url));
-var pkg = JSON.parse(readFileSync11(join22(__dirname, "..", "package.json"), "utf-8"));
+var pkg = JSON.parse(readFileSync11(join23(__dirname, "..", "package.json"), "utf-8"));
 ensureRuntimeSynced({
-  sourceRoot: join22(__dirname, ".."),
-  runtimeRoot: join22(homedir14(), ".config", "squadrant")
+  sourceRoot: join23(__dirname, ".."),
+  runtimeRoot: join23(homedir15(), ".config", "squadrant")
 });
 if (process.argv[2] !== "config") {
   try {
-    const cfgPath = join22(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());