crewswarm 0.8.1-beta

package/scripts/generate-openapi.mjs

@@ -0,0 +1,334 @@
+#!/usr/bin/env node
+/**
+ * Generate complete OpenAPI spec from actual endpoint implementations
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const rootDir = path.resolve(__dirname, "..");
+
+// Read the old spec to preserve schemas
+const oldSpecPath = path.join(rootDir, "crew-cli/docs/openapi.unified.v1.json");
+const oldSpec = JSON.parse(fs.readFileSync(oldSpecPath, "utf8"));
+
+const spec = {
+  openapi: "3.1.0",
+  info: {
+    title: "crewswarm Complete API",
+    version: "2.0.0",
+    description: "Complete API specification for crewswarm Dashboard (port 4319) and crew-lead (port 5010). Includes all agent orchestration, messaging integrations, memory management, and system control endpoints."
+  },
+  servers: [
+    {
+      url: "http://127.0.0.1:4319",
+      description: "Dashboard API (primary web interface)"
+    },
+    {
+      url: "http://127.0.0.1:5010",
+      description: "crew-lead API (orchestration and chat)"
+    }
+  ],
+  tags: [
+    { name: "Core", description: "Essential system endpoints" },
+    { name: "Agents", description: "Agent management and configuration" },
+    { name: "Chat", description: "Conversational interfaces" },
+    { name: "Dispatch", description: "Task dispatch and orchestration" },
+    { name: "Projects", description: "Project and roadmap management" },
+    { name: "PM Loop", description: "Project manager autonomous loop" },
+    { name: "Build", description: "Build orchestration" },
+    { name: "Providers", description: "LLM provider configuration" },
+    { name: "Skills", description: "Skill plugin management" },
+    { name: "Memory", description: "Shared memory and brain" },
+    { name: "Messaging", description: "Telegram and WhatsApp integrations" },
+    { name: "Contacts", description: "Contact management" },
+    { name: "Settings", description: "System configuration" },
+    { name: "Services", description: "Service lifecycle management" },
+    { name: "Engines", description: "Engine passthrough and configuration" },
+    { name: "Multimodal", description: "Image and audio processing" },
+    { name: "Telemetry", description: "Usage tracking and spending" }
+  ],
+  paths: {},
+  components: oldSpec.components // Preserve existing schemas
+};
+
+// Dashboard endpoints with methods and tags
+const dashboardEndpoints = {
+  "/": { get: "Core" },
+  "/health": { get: "Core" },
+  "/api/health": { get: "Core" },
+  "/api/agents": { get: "Agents" },
+  "/api/agents-config": { get: "Agents" },
+  "/api/agents-config/create": { post: "Agents" },
+  "/api/agents-config/update": { post: "Agents" },
+  "/api/agents-config/delete": { post: "Agents" },
+  "/api/agents-config/reset-session": { post: "Agents" },
+  "/api/agents/reset-session": { post: "Agents" },
+  "/api/crew-lead/chat": { post: "Chat" },
+  "/api/crew-lead/history": { get: "Chat" },
+  "/api/crew-lead/clear": { post: "Chat" },
+  "/api/crew-lead/status": { get: "Chat" },
+  "/api/crew-lead/events": { get: "Chat" },
+  "/api/crew-lead/confirm-project": { post: "Projects" },
+  "/api/crew-lead/discard-project": { post: "Projects" },
+  "/api/dispatch": { post: "Dispatch" },
+  "/api/projects": { get: "Projects", post: "Projects" },
+  "/api/projects/update": { post: "Projects" },
+  "/api/projects/delete": { post: "Projects" },
+  "/api/pm-loop/start": { post: "PM Loop" },
+  "/api/pm-loop/stop": { post: "PM Loop" },
+  "/api/pm-loop/status": { get: "PM Loop" },
+  "/api/pm-loop/log": { get: "PM Loop" },
+  "/api/pm-loop/roadmap": { get: "PM Loop" },
+  "/api/roadmap/read": { post: "PM Loop" },
+  "/api/roadmap/write": { post: "PM Loop" },
+  "/api/roadmap/retry-failed": { post: "PM Loop" },
+  "/api/build": { post: "Build" },
+  "/api/build/stop": { post: "Build" },
+  "/api/continuous-build": { post: "Build" },
+  "/api/continuous-build/stop": { post: "Build" },
+  "/api/continuous-build/log": { get: "Build" },
+  "/api/phased-progress": { get: "Build" },
+  "/api/providers": { get: "Providers" },
+  "/api/providers/builtin": { get: "Providers" },
+  "/api/providers/builtin/save": { post: "Providers" },
+  "/api/providers/builtin/test": { post: "Providers" },
+  "/api/providers/add": { post: "Providers" },
+  "/api/providers/save": { post: "Providers" },
+  "/api/providers/test": { post: "Providers" },
+  "/api/providers/fetch-models": { post: "Providers" },
+  "/api/skills/import": { post: "Skills" },
+  "/api/memory/stats": { get: "Memory" },
+  "/api/memory/search": { post: "Memory" },
+  "/api/memory/migrate": { post: "Memory" },
+  "/api/memory/compact": { post: "Memory" },
+  "/api/telegram/config": { get: "Messaging", post: "Messaging" },
+  "/api/telegram/start": { post: "Messaging" },
+  "/api/telegram/stop": { post: "Messaging" },
+  "/api/telegram/status": { get: "Messaging" },
+  "/api/telegram/messages": { get: "Messaging" },
+  "/api/telegram/discover-topics": { get: "Messaging" },
+  "/api/telegram-sessions": { get: "Messaging" },
+  "/api/whatsapp/config": { get: "Messaging", post: "Messaging" },
+  "/api/whatsapp/start": { post: "Messaging" },
+  "/api/whatsapp/stop": { post: "Messaging" },
+  "/api/whatsapp/status": { get: "Messaging" },
+  "/api/whatsapp/messages": { get: "Messaging" },
+  "/api/contacts": { get: "Contacts" },
+  "/api/contacts/update": { post: "Contacts" },
+  "/api/contacts/delete": { post: "Contacts" },
+  "/api/contacts/send": { post: "Contacts" },
+  "/api/settings/rt-token": { get: "Settings", post: "Settings" },
+  "/api/settings/opencode-project": { get: "Settings", post: "Settings" },
+  "/api/settings/bg-consciousness": { get: "Settings", post: "Settings" },
+  "/api/settings/cursor-waves": { get: "Settings", post: "Settings" },
+  "/api/settings/claude-code": { get: "Settings", post: "Settings" },
+  "/api/settings/codex": { get: "Settings", post: "Settings" },
+  "/api/settings/gemini-cli": { get: "Settings", post: "Settings" },
+  "/api/settings/crew-cli": { get: "Settings", post: "Settings" },
+  "/api/settings/global-fallback": { get: "Settings", post: "Settings" },
+  "/api/settings/global-oc-loop": { get: "Settings", post: "Settings" },
+  "/api/settings/global-rules": { get: "Settings", post: "Settings" },
+  "/api/settings/loop-brain": { get: "Settings", post: "Settings" },
+  "/api/settings/openclaw-status": { get: "Settings" },
+  "/api/settings/passthrough-notify": { get: "Settings", post: "Settings" },
+  "/api/settings/role-defaults": { get: "Settings", post: "Settings" },
+  "/api/settings/spending-caps": { get: "Settings", post: "Settings" },
+  "/api/env": { get: "Settings" },
+  "/api/env-advanced": { get: "Settings", post: "Settings" },
+  "/api/services/status": { get: "Services" },
+  "/api/services/restart": { post: "Services" },
+  "/api/services/stop": { post: "Services" },
+  "/api/crew/start": { post: "Services" },
+  "/api/engines": { get: "Engines" },
+  "/api/engines/import": { post: "Engines" },
+  "/api/engine-passthrough": { post: "Engines" },
+  "/api/opencode-models": { get: "Engines" },
+  "/api/opencode-stats": { get: "Engines" },
+  "/api/passthrough-sessions": { get: "Engines", delete: "Engines" },
+  "/api/analyze-image": { post: "Multimodal" },
+  "/api/transcribe-audio": { post: "Multimodal" },
+  "/api/token-usage": { get: "Telemetry" },
+  "/api/dlq": { get: "Core" },
+  "/api/dlq/replay": { post: "Core" },
+  "/api/waves/config": { get: "Core", post: "Core" },
+  "/api/waves/config/reset": { post: "Core" },
+  "/api/prompts": { get: "Core", post: "Core" },
+  "/api/cmd-allowlist": { get: "Core", post: "Core", delete: "Core" },
+  "/api/cmd-approve": { post: "Core" },
+  "/api/cmd-reject": { post: "Core" },
+  "/api/enhance-prompt": { post: "Core" },
+  "/api/search-tools": { get: "Core" },
+  "/api/search-tools/save": { post: "Core" },
+  "/api/search-tools/test": { post: "Core" },
+  "/api/benchmark-tasks": { get: "Core" },
+  "/api/benchmark-run": { post: "Core" },
+  "/api/files": { get: "Core" },
+  "/api/file-content": { get: "Core" },
+  "/api/pick-folder": { get: "Core" },
+  "/api/sessions": { get: "Core" },
+  "/api/messages": { get: "Core" },
+  "/api/send": { post: "Core" },
+  "/api/rt-messages": { get: "Core" }
+};
+
+// crew-lead endpoints
+const crewLeadEndpoints = {
+  "/health": { get: "Core" },
+  "/status": { get: "Core" },
+  "/chat": { post: "Chat" },
+  "/history": { get: "Chat" },
+  "/clear": { post: "Chat" },
+  "/events": { get: "Chat" },
+  "/confirm-project": { post: "Projects" },
+  "/discard-project": { post: "Projects" },
+  "/api/dispatch": { post: "Dispatch" },
+  "/api/classify": { post: "Dispatch" },
+  "/api/chat-agent": { post: "Dispatch" },
+  "/api/agents": { get: "Agents" },
+  "/api/agents/opencode": { get: "Agents" },
+  "/api/skills": { get: "Skills", post: "Skills" },
+  "/api/skills/approve": { post: "Skills" },
+  "/api/skills/reject": { post: "Skills" },
+  "/api/crew-lead/history": { get: "Chat" },
+  "/api/engine-passthrough": { post: "Engines" },
+  "/api/opencode-event": { post: "Engines" },
+  "/api/opencode-sessions": { get: "Engines" },
+  "/api/claude-sessions": { get: "Engines" },
+  "/api/passthrough-sessions": { get: "Engines" },
+  "/api/services/health": { get: "Services" },
+  "/api/services/restart-opencode": { post: "Services" },
+  "/api/settings/bg-consciousness": { get: "Settings", post: "Settings" },
+  "/api/settings/claude-code": { get: "Settings", post: "Settings" },
+  "/api/settings/cursor-waves": { get: "Settings", post: "Settings" },
+  "/api/settings/global-fallback": { get: "Settings", post: "Settings" },
+  "/api/settings/opencode-project": { get: "Settings", post: "Settings" },
+  "/api/spending": { get: "Telemetry" },
+  "/api/spending/reset": { post: "Telemetry" },
+  "/api/telemetry": { get: "Telemetry" },
+  "/api/agent-transcripts/recent": { get: "Telemetry" },
+  "/api/background": { get: "Core" },
+  "/api/health": { get: "Core" },
+  "/allowlist-cmd": { get: "Core", post: "Core", delete: "Core" },
+  "/approve-cmd": { post: "Core" },
+  "/reject-cmd": { post: "Core" }
+};
+
+// Generate path objects
+function createPathObject(path, methods, tag) {
+  const pathObj = {};
+  const methodList = typeof methods === "string" ? [methods] : methods;
+  
+  for (const method of methodList) {
+    pathObj[method] = {
+      tags: [tag],
+      summary: `${method.toUpperCase()} ${path}`,
+      responses: {
+        "200": {
+          description: "Success",
+          content: {
+            "application/json": {
+              schema: { type: "object" }
+            }
+          }
+        }
+      }
+    };
+    
+    // Add request body for POST/PUT/PATCH
+    if (["post", "put", "patch"].includes(method)) {
+      pathObj[method].requestBody = {
+        content: {
+          "application/json": {
+            "schema": { type: "object" }
+          }
+        }
+      };
+    }
+  }
+  
+  return pathObj;
+}
+
+// Merge dashboard endpoints
+for (const [path, methodsOrObj] of Object.entries(dashboardEndpoints)) {
+  if (typeof methodsOrObj === "object" && !Array.isArray(methodsOrObj)) {
+    const methods = Object.keys(methodsOrObj);
+    const tags = Object.values(methodsOrObj);
+    spec.paths[path] = {};
+    for (let i = 0; i < methods.length; i++) {
+      spec.paths[path][methods[i]] = {
+        tags: [tags[i]],
+        summary: `${methods[i].toUpperCase()} ${path}`,
+        responses: {
+          "200": {
+            description: "Success",
+            content: {
+              "application/json": {
+                schema: { type: "object" }
+              }
+            }
+          }
+        }
+      };
+      if (["post", "put", "patch"].includes(methods[i])) {
+        spec.paths[path][methods[i]].requestBody = {
+          content: {
+            "application/json": {
+              schema: { type: "object" }
+            }
+          }
+        };
+      }
+    }
+  }
+}
+
+// Merge crew-lead endpoints
+for (const [path, methodsOrObj] of Object.entries(crewLeadEndpoints)) {
+  if (!spec.paths[path]) {
+    spec.paths[path] = {};
+  }
+  if (typeof methodsOrObj === "object" && !Array.isArray(methodsOrObj)) {
+    const methods = Object.keys(methodsOrObj);
+    const tags = Object.values(methodsOrObj);
+    for (let i = 0; i < methods.length; i++) {
+      if (!spec.paths[path][methods[i]]) {
+        spec.paths[path][methods[i]] = {
+          tags: [tags[i]],
+          summary: `${methods[i].toUpperCase()} ${path}`,
+          responses: {
+            "200": {
+              description: "Success",
+              content: {
+                "application/json": {
+                  schema: { type: "object" }
+                }
+              }
+            }
+          }
+        };
+        if (["post", "put", "patch"].includes(methods[i])) {
+          spec.paths[path][methods[i]].requestBody = {
+            content: {
+              "application/json": {
+                schema: { type: "object" }
+              }
+            }
+          };
+        }
+      }
+    }
+  }
+}
+
+// Write output
+const outputPath = path.join(rootDir, "crew-cli/docs/openapi.complete.v2.json");
+fs.writeFileSync(outputPath, JSON.stringify(spec, null, 2), "utf8");
+
+console.log(`✅ Generated complete OpenAPI spec:`);
+console.log(`   ${outputPath}`);
+console.log(`   ${Object.keys(spec.paths).length} endpoints documented`);
+console.log(`   ${spec.tags.length} tag categories`);

package/scripts/health-check.mjs

@@ -0,0 +1,229 @@
+#!/usr/bin/env node
+/**
+ * crewswarm Health Check
+ *
+ * Fast all-systems status — completes in < 10 seconds.
+ * Checks every service, CLI tool, API key, and MCP server.
+ *
+ * Usage:
+ *   node scripts/health-check.mjs                # full check
+ *   node scripts/health-check.mjs --json         # machine-readable output
+ *   node scripts/health-check.mjs --quiet        # only print failures
+ *   node scripts/health-check.mjs --no-services  # skip live service/agent/chat checks (CI static mode)
+ */
+
+import fs   from "node:fs";
+import path from "node:path";
+import os   from "node:os";
+import { execSync } from "node:child_process";
+
+const JSON_MODE    = process.argv.includes("--json");
+const QUIET_MODE   = process.argv.includes("--quiet");
+const NO_SERVICES  = process.argv.includes("--no-services"); // skip live checks for CI static mode
+const CREW_LEAD  = process.env.CREW_LEAD_URL  || "http://127.0.0.1:5010";
+const DASHBOARD  = process.env.DASHBOARD_URL  || "http://127.0.0.1:4319";
+const MCP_URL    = process.env.MCP_URL        || "http://127.0.0.1:5020";
+const CFG_PATH   = path.join(os.homedir(), ".crewswarm", "crewswarm.json");
+const SWARM_PATH = path.join(os.homedir(), ".crewswarm", "crewswarm.json");
+
+// ── Output helpers ─────────────────────────────────────────────────────────────
+const R="\x1b[0m", B="\x1b[1m", G="\x1b[32m", RE="\x1b[31m", Y="\x1b[33m", C="\x1b[36m", D="\x1b[2m";
+const results = [];
+let pass=0, fail=0, warn=0;
+
+function check(name, status, detail="") {
+  results.push({ name, status, detail });
+  if (status === "pass") { pass++; if (!QUIET_MODE) console.log(`  ${G}✓${R} ${name}${detail ? D+"  "+detail+R : ""}`); }
+  else if (status === "warn") { warn++; console.log(`  ${Y}⚠${R} ${name}${detail ? "  "+detail : ""}`); }
+  else { fail++; console.log(`  ${RE}✗${R} ${name}${detail ? "  "+detail : ""}`); }
+}
+
+function section(title) {
+  if (!QUIET_MODE) console.log(`\n${B}${C}── ${title} ──${R}`);
+}
+
+function getToken() {
+  try { return JSON.parse(fs.readFileSync(CFG_PATH, "utf8"))?.rt?.authToken || ""; } catch { return ""; }
+}
+
+function authHeaders() {
+  const t = getToken();
+  return { "content-type": "application/json", ...(t ? { authorization: `Bearer ${t}` } : {}) };
+}
+
+async function ping(url, label, opts = {}) {
+  try {
+    const res = await fetch(url, { signal: AbortSignal.timeout(opts.timeout || 10000), headers: authHeaders() });
+    return { ok: res.ok || res.status < 500, status: res.status };
+  } catch (e) {
+    return { ok: false, error: e.message };
+  }
+}
+
+function cliCheck(cmd, label) {
+  try {
+    const out = execSync(cmd, { encoding: "utf8", timeout: 10000, stdio: ["pipe", "pipe", "pipe"] }).trim();
+    return { ok: true, version: out.split("\n")[0].trim().slice(0, 60) };
+  } catch (e) {
+    return { ok: false, error: e.message.slice(0, 80) };
+  }
+}
+
+// ── Run all checks in parallel ────────────────────────────────────────────────
+async function run() {
+  if (!QUIET_MODE) {
+    console.log(`\n${B}${C}━━━ crewswarm Health Check ━━━${R}`);
+    console.log(`${D}  ${new Date().toLocaleString()}${R}`);
+  }
+
+  // ── 1. Config files ──────────────────────────────────────────────────────────
+  section("Config");
+  const hasConfig = fs.existsSync(CFG_PATH);
+  const hasSwarm  = fs.existsSync(SWARM_PATH);
+  check("~/.crewswarm/crewswarm.json", hasConfig ? "pass" : "fail", hasConfig ? "" : "run: bash install.sh");
+  check("~/.crewswarm/crewswarm.json", hasSwarm ? "pass" : "fail", hasSwarm ? "" : "run: bash install.sh");
+
+  const token = getToken();
+  check("Auth token", token ? "pass" : "fail", token ? `${token.slice(0,8)}…` : "missing rt.authToken");
+
+  // ── 2. API keys ──────────────────────────────────────────────────────────────
+  section("API Keys");
+  if (NO_SERVICES) {
+    check("API keys skipped", "pass", "--no-services mode");
+  } else {
+    let providers = {};
+    try { providers = JSON.parse(fs.readFileSync(SWARM_PATH, "utf8"))?.providers || {}; } catch {}
+    const configuredKeys = Object.entries(providers).filter(([,v]) => v?.apiKey?.length > 8);
+    if (configuredKeys.length === 0) {
+      check("API keys", "fail", "no provider keys found — open dashboard → Providers");
+    } else {
+      for (const [name, v] of configuredKeys) {
+        check(`${name} key`, "pass", `${v.apiKey.slice(0,8)}…`);
+      }
+    }
+  }
+
+  // ── 3. Services (parallel) ───────────────────────────────────────────────────
+  if (NO_SERVICES) {
+    section("Services");
+    check("services skipped", "pass", "--no-services mode");
+  } else {
+    section("Services");
+    const [crewLead, dashboard, mcpServer] = await Promise.all([
+      ping(`${CREW_LEAD}/health`, "crew-lead"),
+      ping(`${DASHBOARD}/`, "dashboard"),           // dashboard serves HTML on /
+      ping(`${MCP_URL}/health`, "mcp-server"),
+    ]);
+
+    check("crew-lead :5010", crewLead.ok ? "pass" : "fail",
+      crewLead.ok ? `HTTP ${crewLead.status}` : crewLead.error || `HTTP ${crewLead.status}`);
+    check("dashboard :4319", dashboard.ok ? "pass" : "fail",
+      dashboard.ok ? `HTTP ${dashboard.status}` : (dashboard.error || `HTTP ${dashboard.status}`) + " — run: node scripts/dashboard.mjs");
+    check("mcp-server :5020", mcpServer.ok ? "pass" : "warn",
+      mcpServer.ok ? `HTTP ${mcpServer.status}` : "not running — start: npm run mcp");
+  }
+
+  // ── 4. Agents online ─────────────────────────────────────────────────────────
+  if (!NO_SERVICES) {
+    section("Agents");
+    try {
+      const res = await fetch(`${CREW_LEAD}/api/agents`, { headers: authHeaders(), signal: AbortSignal.timeout(5000) });
+      const d = await res.json();
+      const agents = d.agents || [];
+      // crew-lead /api/agents uses liveness field; dashboard /api/agents uses online/alive/liveness
+      const online = agents.filter(a => a.online || a.alive || a.liveness === "alive");
+      const coreAgents = ["crew-coder","crew-qa","crew-pm","crew-main","crew-fixer"];
+      check(`Agents online (${online.length}/${agents.length})`,
+        online.length > 0 ? "pass" : "warn",
+        online.length === 0 ? "bridges not started — run: npm run start-crew" : online.map(a => a.id?.replace("crew-","")).join(", ").slice(0,80));
+      for (const core of coreAgents) {
+        const a = agents.find(x => x.id === core);
+        const isOnline = a?.online || a?.alive || a?.liveness === "alive";
+        check(`  ${core}`, isOnline ? "pass" : "warn", isOnline ? "" : "bridge not running");
+      }
+    } catch (e) {
+      check("Agents", "fail", `could not reach crew-lead: ${e.message}`);
+    }
+  }
+
+  // ── 5. CLI tools ─────────────────────────────────────────────────────────────
+  section("CLI Tools");
+  const [cursorCli, claudeCli, opencodeCli, nodeCli] = await Promise.all([
+    Promise.resolve(cliCheck("cursor --version 2>/dev/null || cursor-cli --version 2>/dev/null", "cursor")),
+    Promise.resolve(cliCheck("echo '' | timeout 3 claude --version 2>/dev/null || echo 'not found'", "claude")),
+    Promise.resolve(cliCheck("opencode --version 2>/dev/null || echo 'not found'", "opencode")),
+    Promise.resolve(cliCheck("node --version", "node")),
+  ]);
+
+  check("node", nodeCli.ok ? "pass" : "fail", nodeCli.version || nodeCli.error);
+  check("cursor cli", cursorCli.ok && !cursorCli.version?.includes("not found") ? "pass" : "warn",
+    cursorCli.version?.includes("not found") ? "install cursor CLI — Cursor → Settings → Install command" : (cursorCli.version || cursorCli.error));
+  check("claude code cli", claudeCli.ok && !claudeCli.version?.includes("not found") ? "pass" : "warn",
+    claudeCli.version?.includes("not found") ? "npm install -g @anthropic-ai/claude-code" : (claudeCli.version || claudeCli.error));
+  check("opencode cli", opencodeCli.ok && !opencodeCli.version?.includes("not found") ? "pass" : "warn",
+    opencodeCli.version?.includes("not found") ? "npm install -g opencode-ai" : (opencodeCli.version || opencodeCli.error));
+
+  // ── 6. MCP protocol (if server is up) ────────────────────────────────────────
+  const mcpServer = NO_SERVICES ? { ok: false } : (await ping(`${MCP_URL}/health`, "mcp-server"));
+  if (!NO_SERVICES && mcpServer.ok) {
+    section("MCP Protocol");
+    try {
+      const initRes = await fetch(`${MCP_URL}/mcp`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "initialize", params: { protocolVersion: "2024-11-05", clientInfo: { name: "health-check", version: "1.0" } } }),
+        signal: AbortSignal.timeout(4000),
+      });
+      const initData = await initRes.json();
+      check("MCP initialize", initData?.result?.serverInfo ? "pass" : "fail",
+        initData?.result?.serverInfo?.name || JSON.stringify(initData).slice(0,60));
+
+      const toolsRes = await fetch(`${MCP_URL}/mcp`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ jsonrpc: "2.0", id: 2, method: "tools/list", params: {} }),
+        signal: AbortSignal.timeout(4000),
+      });
+      const toolsData = await toolsRes.json();
+      const toolCount = toolsData?.result?.tools?.length || 0;
+      check(`MCP tools/list (${toolCount} tools)`, toolCount >= 5 ? "pass" : "warn",
+        toolsData?.result?.tools?.map(t => t.name).join(", ").slice(0, 80));
+    } catch (e) {
+      check("MCP protocol", "fail", e.message);
+    }
+  }
+
+  // ── 7. Quick crew-lead chat ───────────────────────────────────────────────────
+  section("crew-lead Chat");
+  if (NO_SERVICES) {
+    check("chat skipped", "pass", "--no-services mode");
+  } else {
+    try {
+      const start = Date.now();
+      const res = await fetch(`${CREW_LEAD}/chat`, {
+        method: "POST",
+        headers: authHeaders(),
+        body: JSON.stringify({ message: "say: HEALTH_OK", sessionId: "health-check" }),
+        signal: AbortSignal.timeout(15000),
+      });
+      const d = await res.json();
+      const elapsed = Date.now() - start;
+      const reply = d.reply || d.message || "";
+      check("crew-lead responds", reply.length > 0 ? "pass" : "fail",
+        `${Math.round(elapsed/100)/10}s — "${reply.slice(0,60)}"`);
+    } catch (e) {
+      check("crew-lead chat", "fail", e.message);
+    }
+  }
+
+  // ── Summary ───────────────────────────────────────────────────────────────────
+  console.log(`\n${B}${pass + fail + warn} checks${R}  ${G}${pass} pass${R}  ${warn > 0 ? Y : ""}${warn} warn${R}  ${fail > 0 ? RE : ""}${fail} fail${R}\n`);
+
+  if (JSON_MODE) {
+    console.log(JSON.stringify({ pass, fail, warn, results }, null, 2));
+  }
+
+  if (fail > 0) process.exit(1);
+}
+
+run().catch(e => { console.error(`[health-check] fatal: ${e.message}`); process.exit(1); });