autonomous-flow-daemon 1.0.0 → 1.6.0

package/src/commands/mcp.ts

@@ -0,0 +1,129 @@
+/**
+ * afd mcp — MCP server management
+ *
+ * Subcommands:
+ *   install  — Register afd as an MCP server in project and global Claude config
+ */
+
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
+import { join, resolve, dirname } from "path";
+import { homedir } from "os";
+import { getSystemLanguage } from "../core/locale";
+
+const msgs = {
+  en: {
+    usage: "Usage: afd mcp install",
+    unknownSub: (s: string) => `Unknown subcommand: ${s}. Use: afd mcp install`,
+    installing: "Registering afd MCP server...",
+    projectDone: (p: string) => `  [project] Registered in ${p}`,
+    projectSkip: (p: string) => `  [project] Already registered in ${p}`,
+    globalDone: (p: string) => `  [global]  Registered in ${p}`,
+    globalSkip: (p: string) => `  [global]  Already registered in ${p}`,
+    success: "afd MCP server registration complete. Restart Claude Code to activate.",
+    hintRestart: "  Hint: Run 'claude --reload-plugins' or restart the IDE to pick up the new MCP server.",
+  },
+  ko: {
+    usage: "사용법: afd mcp install",
+    unknownSub: (s: string) => `알 수 없는 하위 명령: ${s}. 사용: afd mcp install`,
+    installing: "afd MCP 서버 등록 중...",
+    projectDone: (p: string) => `  [project] ${p}에 등록 완료`,
+    projectSkip: (p: string) => `  [project] ${p}에 이미 등록됨`,
+    globalDone: (p: string) => `  [global]  ${p}에 등록 완료`,
+    globalSkip: (p: string) => `  [global]  ${p}에 이미 등록됨`,
+    success: "afd MCP 서버 등록 완료. Claude Code를 재시작하면 활성화됩니다.",
+    hintRestart: "  힌트: 'claude --reload-plugins' 또는 IDE를 재시작하여 MCP 서버를 인식시키세요.",
+  },
+};
+
+interface McpServerEntry {
+  command: string;
+  args: string[];
+  [key: string]: unknown;
+}
+
+interface McpConfig {
+  mcpServers?: Record<string, McpServerEntry>;
+  [key: string]: unknown;
+}
+
+/** The canonical MCP server definition for afd */
+function afdMcpEntry(): McpServerEntry {
+  return {
+    command: "bun",
+    args: ["run", "src/daemon/server.ts", "--mcp"],
+  };
+}
+
+/** Register afd in a JSON config file's mcpServers section */
+function registerInFile(filePath: string, entry: McpServerEntry): "done" | "skip" | "error" {
+  let config: McpConfig = {};
+  if (existsSync(filePath)) {
+    try {
+      config = JSON.parse(readFileSync(filePath, "utf-8"));
+    } catch {
+      // Preserve existing file by reading raw content for backup
+      config = {};
+    }
+  } else {
+    try {
+      mkdirSync(dirname(filePath), { recursive: true });
+    } catch { return "error"; }
+  }
+
+  const servers = (config.mcpServers ?? {}) as Record<string, McpServerEntry>;
+  const existing = servers.afd;
+
+  if (existing?.command === entry.command &&
+      JSON.stringify(existing.args) === JSON.stringify(entry.args)) {
+    return "skip";
+  }
+
+  servers.afd = entry;
+  config.mcpServers = servers;
+  try {
+    writeFileSync(filePath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+  } catch {
+    return "error";
+  }
+  return "done";
+}
+
+/** Resolve the global Claude Code settings path (cross-platform) */
+function globalClaudeConfigPath(): string {
+  return join(homedir(), ".claude.json");
+}
+
+export async function mcpCommand(subcommand?: string) {
+  const lang = getSystemLanguage();
+  const m = msgs[lang];
+
+  if (!subcommand) {
+    console.log(m.usage);
+    return;
+  }
+
+  if (subcommand !== "install") {
+    console.error(m.unknownSub(subcommand));
+    process.exit(1);
+  }
+
+  console.log(m.installing);
+
+  const entry = afdMcpEntry();
+
+  // 1. Project-level: .mcp.json
+  const projectPath = resolve(".mcp.json");
+  const projectResult = registerInFile(projectPath, entry);
+  if (projectResult === "error") console.error(`  [project] Failed to write ${projectPath}`);
+  else console.log(projectResult === "done" ? m.projectDone(projectPath) : m.projectSkip(projectPath));
+
+  // 2. Global-level: ~/.claude.json — mcpServers section
+  const globalPath = globalClaudeConfigPath();
+  const globalResult = registerInFile(globalPath, entry);
+  if (globalResult === "error") console.error(`  [global]  Failed to write ${globalPath}`);
+  else console.log(globalResult === "done" ? m.globalDone(globalPath) : m.globalSkip(globalPath));
+
+  console.log("");
+  console.log(m.success);
+  console.log(m.hintRestart);
+}

package/src/commands/restart.ts

@@ -0,0 +1,14 @@
+import { stopCommand } from "./stop";
+import { startCommand } from "./start";
+import { getSystemLanguage } from "../core/locale";
+import { getMessages } from "../core/i18n/messages";
+
+export async function restartCommand() {
+  const lang = getSystemLanguage();
+  const msg = getMessages(lang);
+
+  console.log(msg.DAEMON_RESTARTING);
+
+  await stopCommand();
+  await startCommand();
+}

package/src/commands/score.ts

@@ -1,12 +1,29 @@
 import { daemonRequest } from "../daemon/client";
+import { fmtNum, visualWidth, localizedBoast } from "../core/boast";
+import type { ShiftSummary } from "../core/boast";
+import { getSystemLanguage } from "../core/locale";
+import { getMessages, t } from "../core/i18n/messages";
 
-interface HologramScore {
+interface HologramEntry {
   requests: number;
   originalChars: number;
   hologramChars: number;
   savings: number;
 }
 
+interface HologramDailyRow {
+  date: string;
+  requests: number;
+  originalChars: number;
+  hologramChars: number;
+}
+
+interface HologramScore {
+  lifetime: HologramEntry;
+  today: HologramEntry | null;
+  daily: HologramDailyRow[];
+}
+
 interface AutoHealEntry {
   id: string;
   at: number;
@@ -28,6 +45,17 @@ interface EcosystemScore {
   primary: string;
 }
 
+interface SuppressionScore {
+  massEventsSkipped: number;
+  dormantTransitions: number;
+  activeTaps: number;
+}
+
+interface DynamicImmuneScore {
+  activeValidators: number;
+  validatorNames: string[];
+}
+
 interface ScoreData {
   uptime: number;
   filesDetected: number;
@@ -39,8 +67,27 @@ interface ScoreData {
   hologram: HologramScore;
   immune: ImmuneScore;
   ecosystem: EcosystemScore;
+  suppression: SuppressionScore;
+  dynamicImmune?: DynamicImmuneScore;
 }
 
+// ── ANSI helpers ──
+const C = {
+  reset: "\x1b[0m",
+  bold: "\x1b[1m",
+  dim: "\x1b[2m",
+  red: "\x1b[31m",
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  blue: "\x1b[34m",
+  magenta: "\x1b[35m",
+  cyan: "\x1b[36m",
+  white: "\x1b[37m",
+  bgRed: "\x1b[41m",
+  bgGreen: "\x1b[42m",
+  bgYellow: "\x1b[43m",
+};
+
 function formatUptime(seconds: number): string {
   if (seconds < 60) return `${seconds}s`;
   if (seconds < 3600) return `${Math.floor(seconds / 60)}m ${seconds % 60}s`;
@@ -49,9 +96,13 @@ function formatUptime(seconds: number): string {
   return `${h}h ${m}m`;
 }
 
-function heatBar(value: number, max: number, width = 20): string {
-  const filled = Math.min(Math.round((value / Math.max(max, 1)) * width), width);
-  return "\u2588".repeat(filled) + "\u2591".repeat(width - filled);
+function gaugeBar(value: number, max: number, width = 20): string {
+  const ratio = Math.min(value / Math.max(max, 1), 1);
+  const filled = Math.round(ratio * width);
+  const empty = width - filled;
+  const color = ratio >= 0.7 ? C.green : ratio >= 0.4 ? C.yellow : C.red;
+  const pct = Math.round(ratio * 100);
+  return `${color}${"█".repeat(filled)}${C.dim}${"░".repeat(empty)}${C.reset} ${pct}%`;
 }
 
 function formatChars(n: number): string {
@@ -60,89 +111,166 @@ function formatChars(n: number): string {
   return `${(n / 1_000_000).toFixed(1)}M`;
 }
 
-const W = 46; // inner box width
-const line = "\u2500".repeat(W);
-const row = (content: string) => `\u2502${content.padEnd(W)}\u2502`;
+const W = 52;
+const line = "─".repeat(W);
+
+function row(content: string): string {
+  // Strip ANSI for width calculation
+  const stripped = content.replace(/\x1b\[[0-9;]*m/g, "");
+  const vw = visualWidth(stripped);
+  const padSize = Math.max(0, W - vw);
+  return `│${content}${" ".repeat(padSize)}│`;
+}
+
+function section(title: string): string {
+  return row(`  ${C.bold}${C.cyan}${title}${C.reset}`);
+}
+
+function kv(label: string, value: string): string {
+  const stripped = label.replace(/\x1b\[[0-9;]*m/g, "");
+  const gap = 18 - visualWidth(stripped);
+  return row(`  ${C.dim}${label}${C.reset}${" ".repeat(Math.max(1, gap))}${value}`);
+}
+
+function guardianGrade(antibodies: number, heals: number, holoSavings: number): { grade: string; label: string; color: string } {
+  const score = Math.min(antibodies * 15, 40) + Math.min(heals * 10, 30) + Math.min(holoSavings * 0.3, 30);
+  if (score >= 80) return { grade: "A+", label: "FORTIFIED", color: C.green };
+  if (score >= 60) return { grade: "A", label: "GUARDED", color: C.green };
+  if (score >= 40) return { grade: "B", label: "LEARNING", color: C.yellow };
+  if (score >= 20) return { grade: "C", label: "EXPOSED", color: C.yellow };
+  return { grade: "D", label: "VULNERABLE", color: C.red };
+}
 
 export async function scoreCommand() {
+  const lang = getSystemLanguage();
+  const i18n = getMessages(lang);
+
   try {
     const data = await daemonRequest<ScoreData>("/score");
     const h = data.hologram;
+    const holoSav = h.lifetime.savings;
+    const grade = guardianGrade(data.immune.antibodies, data.immune.autoHealed, holoSav);
+
+    const out: string[] = [];
+
+    // ── Header ──
+    out.push(`┌${line}┐`);
+    out.push(row(`  ${C.bold}🛡️  Guardian Status${C.reset}              ${grade.color}${C.bold}[ ${grade.grade} ]${C.reset} ${grade.color}${grade.label}${C.reset}`));
+    out.push(`├${line}┤`);
 
-    console.log(`\u250C${line}\u2510`);
-    console.log(row("  afd score \u2014 Daemon Diagnostics"));
-    console.log(`\u251C${line}\u2524`);
-    console.log(row(`  Ecosystem    : ${data.ecosystem.primary}`));
+    // ── Health Gauge ──
+    const healthPct = Math.min(data.immune.antibodies * 15 + data.immune.autoHealed * 10 + holoSav * 0.3, 100);
+    out.push(row(`  ${gaugeBar(healthPct, 100, 30)}`));
+    out.push(`├${line}┤`);
+
+    // ── System Info ──
+    out.push(section(lang === "ko" ? "시스템 정보" : "System Info"));
+    out.push(kv(i18n.SCORE_ECOSYSTEM, `${C.white}${C.bold}${data.ecosystem.primary}${C.reset}`));
     if (data.ecosystem.detected.length > 1) {
       const others = data.ecosystem.detected.slice(1).map(e => e.name).join(", ");
-      console.log(row(`  Also found   : ${others}`));
-    }
-    console.log(`\u251C${line}\u2524`);
-    console.log(row(`  Uptime       : ${formatUptime(data.uptime)}`));
-    console.log(row(`  Events       : ${data.totalEvents}`));
-    console.log(row(`  Files Found  : ${data.watchedFiles.length}`));
-    console.log(`\u251C${line}\u2524`);
-    console.log(row(`  Activity  ${heatBar(data.totalEvents, 100)}`));
-
-    // Context Efficiency section
-    console.log(`\u251C${line}\u2524`);
-    console.log(row("  Context Efficiency (Hologram)"));
-    console.log(row(`  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`));
-    if (h.requests > 0) {
-      const saved = h.originalChars - h.hologramChars;
-      console.log(row(`  Requests     : ${h.requests}`));
-      console.log(row(`  Original     : ${formatChars(h.originalChars)} chars`));
-      console.log(row(`  Hologram     : ${formatChars(h.hologramChars)} chars`));
-      console.log(row(`  Saved        : ${formatChars(saved)} chars (${h.savings}%)`));
-      console.log(row(`  Efficiency   ${heatBar(h.savings, 100)}`));
-    } else {
-      console.log(row("  No hologram requests yet."));
-      console.log(row("  Use: GET /hologram?file=<path>"));
+      out.push(kv(i18n.SCORE_ALSO_FOUND, `${C.dim}${others}${C.reset}`));
     }
+    out.push(kv(i18n.SCORE_UPTIME, `${C.green}${formatUptime(data.uptime)}${C.reset}`));
+    out.push(kv(i18n.SCORE_EVENTS, `${data.totalEvents}`));
+    out.push(kv(i18n.SCORE_FILES_FOUND, `${data.watchedFiles.length}`));
 
-    // Immune System section
-    console.log(`\u251C${line}\u2524`);
-    console.log(row("  Immune System"));
-    console.log(row(`  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`));
+    // ── Immune System ──
+    out.push(`├${line}┤`);
+    out.push(section(lang === "ko" ? "면역 시스템" : "Immune System"));
     const ab = data.immune.antibodies;
     const ah = data.immune.autoHealed;
-    const immuneLevel = ab === 0 ? "Vulnerable" : ab < 3 ? "Learning" : ab < 6 ? "Guarded" : "Fortified";
-    console.log(row(`  Antibodies   : ${ab}`));
-    console.log(row(`  Level        : ${immuneLevel}`));
-    console.log(row(`  Immunity     ${heatBar(ab, 10)}`));
-    console.log(row(`  Auto-healed  : ${ah} background event${ah !== 1 ? "s" : ""}`));
+    out.push(kv(i18n.SCORE_ANTIBODIES, `${C.bold}${ab}${C.reset}`));
+    out.push(row(`  ${lang === "ko" ? "면역력" : "Immunity"}        ${gaugeBar(ab, 10, 20)}`));
+    out.push(kv(lang === "ko" ? "차단 횟수" : "Prevented", `${C.bold}${C.green}${ah}${C.reset}${C.dim} disaster${ah !== 1 ? "s" : ""}${C.reset}`));
     if (data.immune.lastAutoHeal) {
       const ago = formatUptime(Math.floor((Date.now() - data.immune.lastAutoHeal.at) / 1000));
-      console.log(row(`  Last heal    : ${data.immune.lastAutoHeal.id} (${ago} ago)`));
+      out.push(kv(lang === "ko" ? "마지막 치유" : "Last Heal", `${data.immune.lastAutoHeal.id} ${C.dim}(${ago} ago)${C.reset}`));
     }
 
-    // Watched files
-    console.log(`\u251C${line}\u2524`);
-    if (data.watchedFiles.length > 0) {
-      console.log(row("  Watched Files:"));
-      for (const f of data.watchedFiles.slice(0, 8)) {
-        console.log(row(`    ${f.substring(0, W - 6)}`));
-      }
-      if (data.watchedFiles.length > 8) {
-        console.log(row(`    ... +${data.watchedFiles.length - 8} more`));
+    // ── Dynamic Immune Synthesis ──
+    if (data.dynamicImmune && data.dynamicImmune.activeValidators > 0) {
+      out.push(`├${line}┤`);
+      out.push(section(lang === "ko" ? "진화 상태 (동적 면역)" : "Evolution (Dynamic Immune)"));
+      out.push(kv(
+        lang === "ko" ? "활성 검증기" : "Validators",
+        `${C.bold}${C.green}${data.dynamicImmune.activeValidators} Active${C.reset}`
+      ));
+      const names = data.dynamicImmune.validatorNames.slice(0, 3).join(", ");
+      const extra = data.dynamicImmune.validatorNames.length > 3
+        ? ` ${C.dim}+${data.dynamicImmune.validatorNames.length - 3} more${C.reset}`
+        : "";
+      out.push(kv(
+        lang === "ko" ? "스크립트" : "Scripts",
+        `${C.dim}${names}${C.reset}${extra}`
+      ));
+    }
+
+    // ── Hologram Efficiency ──
+    out.push(`├${line}┤`);
+    out.push(section(lang === "ko" ? "토큰 효율 (홀로그램)" : "Token Efficiency (Hologram)"));
+    const lt = h.lifetime;
+    if (lt.requests > 0) {
+      const ltSaved = lt.originalChars - lt.hologramChars;
+      out.push(kv(lang === "ko" ? "총 요청" : "Requests", `${lt.requests}`));
+      out.push(kv(lang === "ko" ? "절약된 컨텍스트" : "Saved Context", `${C.green}${formatChars(ltSaved)} chars${C.reset}`));
+      out.push(row(`  ${lang === "ko" ? "효율" : "Efficiency"}       ${gaugeBar(lt.savings, 100, 20)}`));
+      if (h.today && h.today.requests > 0) {
+        const todaySaved = h.today.originalChars - h.today.hologramChars;
+        out.push(kv(lang === "ko" ? "오늘" : "Today", `${h.today.requests} req / ${C.green}${formatChars(todaySaved)} saved${C.reset}`));
       }
     } else {
-      console.log(row("  No files detected yet."));
+      out.push(row(`  ${C.dim}${i18n.SCORE_HOLOGRAM_EMPTY}${C.reset}`));
+      out.push(row(`  ${C.dim}${i18n.SCORE_HOLOGRAM_HINT}${C.reset}`));
     }
 
-    if (data.lastEvent) {
-      const ago = data.lastEventAt
-        ? formatUptime(Math.floor((Date.now() - data.lastEventAt) / 1000)) + " ago"
-        : "unknown";
-      console.log(`\u251C${line}\u2524`);
-      console.log(row(`  Last: ${data.lastEvent.substring(0, 36)}`));
-      console.log(row(`        ${ago}`));
-    }
+    // ── Value Delivered (ROI) ──
+    try {
+      const summary = await daemonRequest<ShiftSummary>("/shift-summary");
+      out.push(`├${line}┤`);
+      out.push(section(lang === "ko" ? "전달된 가치 (ROI)" : "Value Delivered (ROI)"));
+
+      // Breakdown: Auto-Heal
+      if (summary.healTokensSaved > 0) {
+        out.push(kv(
+          lang === "ko" ? "🩹 치유 절약" : "🩹 Heal Saved",
+          `${C.dim}~${fmtNum(summary.healTokensSaved)} tok / $${summary.healCostSaved.toFixed(2)}${C.reset}`
+        ));
+      }
+
+      // Breakdown: Hologram
+      if (summary.hologramTokensSaved > 0) {
+        out.push(kv(
+          lang === "ko" ? "💎 홀로그램" : "💎 Hologram",
+          `${C.dim}~${fmtNum(summary.hologramTokensSaved)} tok / $${summary.hologramCostSaved.toFixed(2)}${C.reset}`
+        ));
+      }
+
+      // Total
+      out.push(kv(
+        lang === "ko" ? "총 절약 토큰" : "Total Tokens",
+        `${C.bold}${C.green}~${fmtNum(summary.totalTokensSaved)}${C.reset}`
+      ));
+      out.push(kv(lang === "ko" ? "절약 시간" : "Time Saved", `${C.green}~${summary.totalMinutesSaved} min${C.reset}`));
+      out.push(kv(
+        lang === "ko" ? "총 절약 비용" : "Total Cost",
+        `${C.bold}${C.green}~$${summary.totalCostSaved.toFixed(2)}${C.reset}`
+      ));
+      if (summary.suppressionsSkipped > 0) {
+        out.push(kv(lang === "ko" ? "억제 횟수" : "Suppressed", `${summary.suppressionsSkipped}`));
+      }
+    } catch { /* non-fatal */ }
+
+    // ── Boast ──
+    out.push(`├${line}┤`);
+    const boast = localizedBoast(lang);
+    const truncBoast = boast.length > W - 6 ? boast.slice(0, W - 9) + "..." : boast;
+    out.push(row(`  ${C.magenta}🗣️ ${truncBoast}${C.reset}`));
+    out.push(`└${line}┘`);
 
-    console.log(`\u2514${line}\u2518`);
+    console.log(out.join("\n"));
   } catch (err: unknown) {
     const msg = err instanceof Error ? err.message : String(err);
-    console.error(`[afd] ${msg}`);
+    console.error(`${C.red}[afd] ${msg}${C.reset}`);
     process.exit(1);
   }
 }

package/src/commands/start.ts

@@ -1,55 +1,155 @@
-import { spawn } from "child_process";
 import { resolve } from "path";
+import { spawn } from "child_process";
+import { openSync, mkdirSync } from "fs";
 import { getDaemonInfo, isDaemonAlive } from "../daemon/client";
-import { AFD_DIR } from "../constants";
-import { mkdirSync } from "fs";
+import { WATCH_TARGETS, resolveWorkspacePaths } from "../constants";
 import { detectEcosystem } from "../adapters/index";
+import type { DetectionResult } from "../adapters/index";
+import { detachedSpawnOptions, IS_WINDOWS } from "../platform";
+import { rotateLogIfNeeded } from "../core/log-rotate";
+import { getSystemLanguage } from "../core/locale";
+import { getMessages, t } from "../core/i18n/messages";
+import type { MessageDict } from "../core/i18n/messages";
+import { discoverWatchTargets } from "../core/discovery";
+
+const STARTUP_POLL_INTERVAL_MS = 100;
+const STARTUP_POLL_MAX_MS = 3000;
+
+interface SetupStep {
+  label: string;
+  newMsg: string;
+  okMsg: string;
+  skipMsg: string;
+}
+
+interface SetupResult {
+  ecosystem: string;
+  steps: { label: string; status: "new" | "ok" | "skip" }[];
+}
+
+/**
+ * One-Command Zero-Touch: detect ecosystem and provision all integration
+ * channels (hooks, MCP, statusLine) with idempotency.
+ */
+function setupEcosystem(cwd: string, msg: MessageDict): SetupResult[] {
+  const ecosystems = detectEcosystem(cwd);
+  const results: SetupResult[] = [];
+
+  for (const { adapter } of ecosystems) {
+    console.log(t(msg.SETUP_HEADER, { ecosystem: adapter.name }));
+    const steps: SetupResult["steps"] = [];
 
-export async function startCommand() {
-  mkdirSync(AFD_DIR, { recursive: true });
+    // 1. Hook injection
+    if (adapter.injectHooks) {
+      const r = adapter.injectHooks(cwd);
+      const status = r.injected ? "new" : "ok";
+      console.log(status === "new" ? msg.SETUP_HOOKS_NEW : msg.SETUP_HOOKS_OK);
+      steps.push({ label: "hooks", status });
+    }
+
+    // 2. MCP registration
+    if (adapter.registerMcp) {
+      const r = adapter.registerMcp(cwd);
+      const status = r.registered ? "new" : "ok";
+      console.log(status === "new" ? msg.SETUP_MCP_NEW : msg.SETUP_MCP_OK);
+      steps.push({ label: "mcp", status });
+    } else {
+      console.log(msg.SETUP_MCP_SKIP);
+      steps.push({ label: "mcp", status: "skip" });
+    }
+
+    // 3. StatusLine configuration
+    if (adapter.configureStatusLine) {
+      const r = adapter.configureStatusLine(cwd);
+      const status = r.configured ? "new" : "ok";
+      console.log(status === "new" ? msg.SETUP_STATUS_NEW : msg.SETUP_STATUS_OK);
+      steps.push({ label: "statusLine", status });
+    } else {
+      console.log(msg.SETUP_STATUS_SKIP);
+      steps.push({ label: "statusLine", status: "skip" });
+    }
+
+    results.push({ ecosystem: adapter.name, steps });
+  }
+
+  if (ecosystems.length > 0) {
+    console.log(msg.SETUP_DONE);
+  }
 
-  // Check if already running
+  return results;
+}
+
+export async function startCommand(options?: { mcp?: boolean }) {
+  // MCP stdio mode: run daemon in foreground with stdio transport
+  if (options?.mcp) {
+    const { main: runDaemon } = await import("../daemon/server");
+    runDaemon({ mcp: true });
+    return; // never reaches here — stdio loop blocks
+  }
+
+  const lang = getSystemLanguage();
+  const msg = getMessages(lang);
+
+  const paths = resolveWorkspacePaths();
+  mkdirSync(paths.afdDir, { recursive: true });
+
+  // ── Idempotency: check if already running ──
   const existing = getDaemonInfo();
-  if (existing && await isDaemonAlive(existing)) {
-    console.log(`[afd] Daemon already running (pid=${existing.pid}, port=${existing.port})`);
+  if (existing && (await isDaemonAlive(existing))) {
+    console.log(msg.DAEMON_ALREADY_RUNNING);
     return;
   }
 
-  // Spawn detached daemon
+  // ── Spawn detached daemon with log redirection ──
   const daemonScript = resolve(import.meta.dirname, "../daemon/server.ts");
-  const bunPath = process.execPath;
+  const logPath = paths.logFile;
+  rotateLogIfNeeded(logPath);
+  const logFd = openSync(logPath, "a"); // append mode
+
+  // On Windows, wrap in shell for proper detach; quote path for spaces
+  const args = IS_WINDOWS
+    ? ["run", `"${daemonScript}"`]
+    : ["run", daemonScript];
 
-  const child = spawn(bunPath, ["run", daemonScript], {
-    detached: true,
-    stdio: ["ignore", "ignore", "ignore"],
-    cwd: process.cwd(),
-    env: { ...process.env },
-  });
+  const child = spawn("bun", args, detachedSpawnOptions(logFd));
 
+  // Detach: allow parent to exit without killing child
   child.unref();
 
-  // Wait for daemon to write its port file (Windows needs more time)
-  await new Promise((r) => setTimeout(r, 1500));
-
-  const info = getDaemonInfo();
-  if (info && await isDaemonAlive(info)) {
-    console.log(`[afd] Daemon started (pid=${info.pid}, port=${info.port})`);
-    console.log(`[afd] Watching: .claude/, CLAUDE.md, .cursorrules`);
-
-    // Silently inject auto-heal hook and status line into detected ecosystem
-    const ecosystems = detectEcosystem(process.cwd());
-    for (const { adapter } of ecosystems) {
-      if (adapter.injectHooks) {
-        const hookResult = adapter.injectHooks(process.cwd());
-        console.log(`[afd] ${hookResult.message}`);
-      }
-      if (adapter.configureStatusLine) {
-        const slResult = adapter.configureStatusLine(process.cwd());
-        if (slResult.configured) console.log(`[afd] ${slResult.message}`);
-      }
-    }
+  // ── Poll for daemon readiness instead of fixed sleep ──
+  const info = await pollForDaemon(STARTUP_POLL_MAX_MS, STARTUP_POLL_INTERVAL_MS);
+
+  if (info) {
+    console.log(t(msg.DAEMON_STARTED, { pid: info.pid, port: info.port }));
+
+    // Smart Discovery: show what we're actually watching
+    const discovery = discoverWatchTargets(WATCH_TARGETS);
+    console.log(t(msg.DAEMON_WATCHING, { count: discovery.targets.length }));
+    console.log(`[afd] Targets: ${discovery.targets.join(", ")}`);
+    console.log(t(msg.DAEMON_LOGS, { path: logPath }));
+
+    // One-Command Zero-Touch: auto-provision all ecosystem integrations
+    setupEcosystem(process.cwd(), msg);
   } else {
-    console.error("[afd] Failed to start daemon. Check logs.");
+    console.error(t(msg.DAEMON_START_FAILED, { path: logPath }));
     process.exit(1);
   }
 }
+
+/** Poll until daemon PID/port files appear and health check passes */
+async function pollForDaemon(
+  maxMs: number,
+  intervalMs: number,
+): Promise<{ pid: number; port: number } | null> {
+  const deadline = Date.now() + maxMs;
+
+  while (Date.now() < deadline) {
+    const info = getDaemonInfo();
+    if (info && (await isDaemonAlive(info))) {
+      return info;
+    }
+    await Bun.sleep(intervalMs);
+  }
+
+  return null;
+}