squadrant 0.11.1 → 0.11.3

package/README.md

@@ -129,7 +129,7 @@ Six internal packages in a one-way dependency DAG. All are private (not publishe
 - `dist/index.js` — CLI bin (`squadrant` command), entry: `packages/cli/src/index.ts`
 - `dist/squadrantd.js` — daemon process, entry: `packages/cli/src/daemon-host.ts`
 
-See the [architecture diagram](docs/diagrams/2026-06-18-cockpit-monorepo-architecture.html) for a visual overview.
+See the [architecture diagram](docs/diagrams/2026-06-18-squadrant-monorepo-architecture.html) for a visual overview.
 
 ## Architecture
 

package/dist/index.js

@@ -428,13 +428,13 @@ var init_compat_manifest = __esm({
   "packages/shared/dist/lib/compat-manifest.js"() {
     compatManifest = {
       tools: {
-        cmux: { min: "0.64.0", lastVerified: "0.64.16" },
+        cmux: { min: "0.64.0", lastVerified: "0.64.17" },
         claude: { min: "2.1.32" },
         node: { min: "18.0.0", lastVerified: "24.6.0" },
         // presence-checked; no floor enforced yet
         codex: { lastVerified: "0.139.0" },
         gemini: { lastVerified: "0.38.2" },
-        opencode: { lastVerified: "1.17.4" }
+        opencode: { lastVerified: "1.17.9" }
       }
     };
   }
@@ -4902,7 +4902,8 @@ function healthRow(c, now) {
 function printServiceHealth(rows, now = Date.now()) {
   console.log(chalk2.bold("\nService Health\n"));
   if (rows == null) {
-    console.log(`  ${chalk2.red("\u2718")} daemon unreachable \u2014 squadrant liveness is unknown (start the daemon)`);
+    console.log(`  ${chalk2.red("\u2718")} daemon unreachable \u2014 squadrant liveness is unknown`);
+    console.log(`         ${chalk2.cyan("\u2192")} ${chalk2.dim("Run: squadrant heal daemon")}`);
     return;
   }
   if (rows.length === 0) {
@@ -4983,29 +4984,61 @@ function tryGetVersion(cmd) {
     return "";
   }
 }
-function check(label, pass) {
+function check(label, pass, hint) {
   const icon = pass ? chalk3.green("\u2714 PASS") : chalk3.red("\u2718 FAIL");
   console.log(`  ${icon}  ${label}`);
+  if (!pass && hint) {
+    console.log(`         ${chalk3.cyan("\u2192")} ${chalk3.dim(hint)}`);
+  }
   return pass;
 }
 var doctorCommand = new Command("doctor").description("Check system health and prerequisites").action(async () => {
   console.log(chalk3.bold("\nSquadrant Doctor\n"));
   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") || fs13.existsSync("/Applications/Obsidian.app")));
-  results.push(check("Node.js >= 18", nodeVersionOk()));
+  results.push(check(
+    "Claude Code installed",
+    commandExists("claude"),
+    "Install from: https://claude.ai/code"
+  ));
+  results.push(check(
+    `Claude Code version >= ${compatManifest.tools.claude.min}`,
+    claudeVersionOk(),
+    `Update Claude Code to >= ${compatManifest.tools.claude.min}`
+  ));
+  results.push(check(
+    "Obsidian installed",
+    commandExists("obsidian") || fs13.existsSync("/Applications/Obsidian.app"),
+    "Install from: https://obsidian.md"
+  ));
+  results.push(check(
+    "Node.js >= 18",
+    nodeVersionOk(),
+    "Install from: https://nodejs.org"
+  ));
   results.push(
     check(
       "Agent Teams enabled (CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1)",
-      settingsHaveAgentTeams()
+      settingsHaveAgentTeams(),
+      "Run: squadrant init  (enables automatically), or add to shell profile: export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1"
     )
   );
-  results.push(check("Plugin: superpowers", pluginInstalled("superpowers@claude-plugins-official")));
+  results.push(check(
+    "Plugin: superpowers",
+    pluginInstalled("superpowers@claude-plugins-official"),
+    "In Claude Code, run: /plugin marketplace add superpowers"
+  ));
   results.push(
-    check("Plugin: claude-mem", pluginInstalled("claude-mem@thedotmack"))
+    check(
+      "Plugin: claude-mem",
+      pluginInstalled("claude-mem@thedotmack"),
+      "In Claude Code, run: /plugin marketplace add thedotmack/claude-mem"
+    )
   );
-  results.push(check("Plugin: context7", pluginInstalled("context7@claude-plugins-official")));
+  results.push(check(
+    "Plugin: context7",
+    pluginInstalled("context7@claude-plugins-official"),
+    "In Claude Code, run: /plugin marketplace add context7"
+  ));
   const config = loadConfig();
   const runtimes = new RuntimeRegistry({ cmux: createCmuxDriver() });
   const probeResults = await runtimes.probeAll();
@@ -5013,7 +5046,8 @@ var doctorCommand = new Command("doctor").description("Check system health and p
   const globalProbe = probeResults[globalRuntimeName];
   results.push(check(
     `Runtime '${globalRuntimeName}' installed`,
-    !!globalProbe?.installed
+    !!globalProbe?.installed,
+    globalRuntimeName === "cmux" ? "Install: npm install -g cmux  or download from https://cmux.dev" : void 0
   ));
   const overrides = /* @__PURE__ */ new Set();
   for (const proj of Object.values(config.projects)) {
@@ -5031,7 +5065,8 @@ var doctorCommand = new Command("doctor").description("Check system health and p
   const hubProbe = await hubDriver.probe();
   results.push(check(
     `Workspace '${config.workspace ?? "obsidian"}' \u2014 hub reachable`,
-    hubProbe.installed && hubProbe.rootExists
+    hubProbe.installed && hubProbe.rootExists,
+    "Run: squadrant init  to scaffold the hub vault"
   ));
   for (const [name] of Object.entries(config.projects)) {
     const spokeDriver = workspaces.forProject(name, config);
@@ -5081,7 +5116,8 @@ var doctorCommand = new Command("doctor").description("Check system health and p
       "Squadrant config exists",
       fs13.existsSync(
         process.env.SQUADRANT_CONFIG || `${process.env.HOME}/.config/squadrant/config.json`
-      )
+      ),
+      "Run: squadrant init"
     )
   );
   const passed = results.filter(Boolean).length;
@@ -5151,10 +5187,12 @@ ${passed === total ? chalk3.green("All checks passed") : chalk3.yellow(`${passed
 init_dist();
 init_dist3();
 init_dist();
+init_dist4();
 import { Command as Command2 } from "commander";
 import fs14 from "fs";
 import path17 from "path";
 import os8 from "os";
+import readline from "readline";
 import chalk4 from "chalk";
 function findPackageRoot() {
   let dir = path17.dirname(new URL(import.meta.url).pathname);
@@ -5176,50 +5214,82 @@ function copyDirRecursive(src, dest) {
     }
   }
 }
-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) => {
+function stepHeader(n, total, label) {
+  console.log(chalk4.bold(`
+  ${n}/${total}  ${label}`));
+}
+function promptLine(question) {
+  return new Promise((resolve3) => {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve3(answer.trim());
+    });
+  });
+}
+var initCommand = new Command2("init").description("Guided first-time setup: hub vault, agents, plugins, projects (re-run-safe)").option("--hub <path>", "Hub vault path", "~/squadrant-hub").action(async (opts) => {
   const hubPath = resolveHome(opts.hub);
   const pkgRoot = findPackageRoot();
   const configDir = path17.join(os8.homedir(), ".config", "squadrant");
+  const isTTY = process.stdin.isTTY === true;
   console.log(chalk4.bold("\nSquadrant Init\n"));
-  const registry = new WorkspaceRegistry({ obsidian: createObsidianDriver });
+  if (!isTTY) {
+    console.log("  Run these steps to get started:\n");
+    console.log(chalk4.bold("  1/5  Hub vault"));
+    console.log(chalk4.cyan(`       squadrant init --hub ${opts.hub}`));
+    console.log(chalk4.bold("\n  2/5  Agent + projection setup"));
+    console.log("       (handled automatically by: " + chalk4.cyan("squadrant init") + ")");
+    console.log(chalk4.bold("\n  3/5  Plugins \u2014 open Claude Code and run:"));
+    console.log(chalk4.cyan("       /plugin marketplace add superpowers"));
+    console.log(chalk4.cyan("       /plugin marketplace add thedotmack/claude-mem"));
+    console.log(chalk4.cyan("       /plugin marketplace add context7"));
+    console.log(chalk4.bold("\n  4/5  Register first project"));
+    console.log(chalk4.cyan("       squadrant projects add <name> <path>"));
+    console.log(chalk4.bold("\n  5/5  Telegram (optional)"));
+    console.log(chalk4.cyan("       squadrant telegram setup"));
+    console.log(chalk4.bold("\n  Then:"));
+    console.log(chalk4.cyan("       squadrant launch <projectname>\n"));
+    return;
+  }
+  const wsRegistry = new WorkspaceRegistry({ obsidian: createObsidianDriver });
   try {
     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);
+      wsRegistry.get(existing.workspace ?? "obsidian");
     }
   } catch (err) {
     console.log(chalk4.red(`  \u2718 ${err.message}`));
     return;
   }
+  stepHeader(1, 5, "Hub vault");
   if (fs14.existsSync(DEFAULT_CONFIG_PATH)) {
-    console.log(chalk4.yellow("  \u26A0 Config already exists, skipping creation"));
+    console.log(chalk4.yellow("    \u26A0 Config already exists, skipping creation"));
   } else {
     const config = getDefaultConfig();
     config.hubVault = hubPath;
     saveConfig(config);
-    console.log(chalk4.green(`  \u2714 Config created at ${DEFAULT_CONFIG_PATH}`));
+    console.log(chalk4.green(`    \u2714 Config created at ${DEFAULT_CONFIG_PATH}`));
   }
   const hubTemplate = path17.join(pkgRoot, "obsidian", "hub");
   if (fs14.existsSync(hubPath)) {
-    console.log(chalk4.yellow(`  \u26A0 Hub vault already exists at ${hubPath}, skipping`));
+    console.log(chalk4.yellow(`    \u26A0 Hub vault already exists at ${hubPath}`));
   } else if (fs14.existsSync(hubTemplate)) {
     copyDirRecursive(hubTemplate, hubPath);
-    console.log(chalk4.green(`  \u2714 Hub vault scaffolded at ${hubPath}`));
+    console.log(chalk4.green(`    \u2714 Hub vault scaffolded at ${hubPath}`));
   } else {
     fs14.mkdirSync(hubPath, { recursive: true });
-    console.log(chalk4.yellow(`  \u26A0 Hub template not found; created empty dir at ${hubPath}`));
+    console.log(chalk4.yellow(`    \u26A0 Hub template not found; created empty directory at ${hubPath}`));
   }
   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}`));
+    console.log(chalk4.green(`    \u2714 Dashboard refreshed`));
   }
-  const projectsDir = path17.join(hubPath, "projects");
-  fs14.mkdirSync(projectsDir, { recursive: true });
+  fs14.mkdirSync(path17.join(hubPath, "projects"), { recursive: true });
   ensureRuntimeSynced({ sourceRoot: pkgRoot, runtimeRoot: configDir });
-  console.log(chalk4.green(`  \u2714 Runtime assets synced to ${configDir}`));
+  console.log(chalk4.green(`    \u2714 Runtime assets synced to ${configDir}`));
+  stepHeader(2, 5, "Agent + projection setup");
   const settingsPath = path17.join(os8.homedir(), ".claude", "settings.json");
   try {
     let settings = {};
@@ -5231,29 +5301,70 @@ var initCommand = new Command2("init").description("First-time setup: scaffold h
       settings.env = { ...env, CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: "1" };
       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"));
+      console.log(chalk4.green("    \u2714 Agent Teams enabled in ~/.claude/settings.json"));
     } else {
-      console.log(chalk4.green("  \u2714 Agent Teams already enabled"));
+      console.log(chalk4.green("    \u2714 Agent Teams already enabled"));
     }
   } catch {
-    console.log(chalk4.yellow("  \u26A0 Could not update ~/.claude/settings.json"));
+    console.log(chalk4.yellow("    \u26A0 Could not update ~/.claude/settings.json"));
+    console.log(chalk4.dim("      Add manually to shell profile: export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1"));
   }
-  console.log(chalk4.bold("\nManual steps required:\n"));
-  console.log("  1. Install plugins in Claude Code:");
-  console.log(chalk4.cyan("       /plugin marketplace add thedotmack/claude-mem"));
-  console.log(chalk4.cyan("       /plugin install claude-mem"));
-  console.log("       Install context7 and superpowers from /plugin marketplace");
-  console.log("");
-  console.log("  2. Install cmux if not already installed:");
-  console.log(chalk4.cyan("       npm install -g cmux"));
-  console.log("");
-  console.log("  3. Open Obsidian and add the hub vault:");
-  console.log(chalk4.cyan(`       ${hubPath}`));
-  console.log("");
-  console.log("  4. Run " + chalk4.cyan("squadrant doctor") + " to verify setup\n");
-  if (!fs14.existsSync("/Applications/cmux.app")) {
-    console.log(chalk4.yellow("  \u26A0 cmux not found \u2014 download from https://cmux.dev\n"));
+  try {
+    const projRegistry = new ProjectionRegistry({
+      cursor: createCursorEmitter,
+      codex: createCodexEmitter,
+      gemini: createGeminiEmitter,
+      opencode: createOpencodeEmitter
+    });
+    const workspace = createObsidianDriver({ root: process.cwd() });
+    const source = await readUserLevelSource(workspace, { pkgRoot });
+    for (const name of projRegistry.list()) {
+      const emitter = projRegistry.get(name);
+      for (const dest of emitter.destinations("user")) {
+        const result = await emitter.emit(source, dest);
+        if (result.written) {
+          console.log(chalk4.green(`    \u2714 ${name} \u2192 ${dest.path}`));
+        } else {
+          console.log(chalk4.dim(`    - ${name} \u2192 ${dest.path} (unchanged)`));
+        }
+      }
+    }
+  } catch (err) {
+    console.log(chalk4.yellow(`    \u26A0 Projection emit skipped: ${err.message}`));
+  }
+  stepHeader(3, 5, "Plugins");
+  console.log("    Install these plugins inside Claude Code:\n");
+  console.log(chalk4.cyan("      /plugin marketplace add superpowers"));
+  console.log(chalk4.cyan("      /plugin marketplace add thedotmack/claude-mem"));
+  console.log(chalk4.cyan("      /plugin marketplace add context7\n"));
+  console.log(chalk4.dim("    Squadrant never auto-installs plugins \u2014 open Claude Code and run the commands above."));
+  stepHeader(4, 5, "Register first project");
+  const projectPath = await promptLine(
+    chalk4.cyan("    Absolute path to your first project (Enter to skip): ")
+  );
+  if (projectPath) {
+    const projectName = path17.basename(projectPath);
+    console.log(chalk4.bold(`
+    Run this to register it:`));
+    console.log(chalk4.cyan(`      squadrant projects add ${projectName} ${projectPath}
+`));
+  } else {
+    console.log(chalk4.dim("    Skipped. Register later with:"));
+    console.log(chalk4.cyan("      squadrant projects add <name> <path>"));
   }
+  stepHeader(5, 5, "Telegram (optional)");
+  console.log("    Get notified on your phone when crews complete tasks:");
+  console.log(chalk4.cyan("      squadrant telegram setup\n"));
+  let launchTarget = "<projectname>";
+  try {
+    const cfg = loadConfig();
+    const first = Object.keys(cfg.projects)[0];
+    if (first) launchTarget = first;
+  } catch {
+  }
+  console.log(chalk4.bold.green("\n  \u2714 You are ready!\n"));
+  console.log(`     Run: ${chalk4.cyan(`squadrant launch ${launchTarget}`)}
+`);
 });
 
 // packages/cli/src/commands/projects.ts
@@ -6226,6 +6337,9 @@ var CREW_PERMISSION_ALLOWLIST = [
   "Bash(sleep:*)",
   "Bash(printf:*)"
 ];
+function healStaleCockpitRefs(raw) {
+  return raw.replaceAll("cockpit crew _hook", "squadrant crew _hook").replaceAll(".config/cockpit", ".config/squadrant").replaceAll("cockpit-hub", "squadrant-hub");
+}
 function mergeCrewPermissions(settings) {
   const next = structuredClone(settings ?? {});
   const permissions = next.permissions ??= {};
@@ -6239,7 +6353,7 @@ function writePerCrewSettingsLocal(o) {
   const file = join17(dir, "settings.local.json");
   let existing = {};
   try {
-    const raw = readFileSync9(file, "utf-8");
+    const raw = healStaleCockpitRefs(readFileSync9(file, "utf-8"));
     existing = JSON.parse(raw);
   } catch {
   }