autonomous-flow-daemon 1.1.0 → 1.9.0

package/src/commands/start.ts

@@ -1,96 +1,155 @@
-import { resolve } from "path";
-import { spawn } from "child_process";
-import { openSync, mkdirSync } from "fs";
-import { getDaemonInfo, isDaemonAlive } from "../daemon/client";
-import { AFD_DIR, LOG_FILE, WATCH_TARGETS } from "../constants";
-import { detectEcosystem } from "../adapters/index";
-import { detachedSpawnOptions, IS_WINDOWS } from "../platform";
-import { getSystemLanguage } from "../core/locale";
-import { getMessages, t } from "../core/i18n/messages";
-import { discoverWatchTargets } from "../core/discovery";
-
-const STARTUP_POLL_INTERVAL_MS = 100;
-const STARTUP_POLL_MAX_MS = 3000;
-
-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);
-
-  mkdirSync(AFD_DIR, { recursive: true });
-
-  // ── Idempotency: check if already running ──
-  const existing = getDaemonInfo();
-  if (existing && (await isDaemonAlive(existing))) {
-    console.log(msg.DAEMON_ALREADY_RUNNING);
-    return;
-  }
-
-  // ── Spawn detached daemon with log redirection ──
-  const daemonScript = resolve(import.meta.dirname, "../daemon/server.ts");
-  const logPath = resolve(LOG_FILE);
-  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("bun", args, detachedSpawnOptions(logFd));
-
-  // Detach: allow parent to exit without killing child
-  child.unref();
-
-  // ── 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 }));
-
-    // Inject hooks into detected ecosystems
-    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}`);
-      }
-    }
-  } else {
-    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;
-}
+import { resolve } from "path";
+import { spawn } from "child_process";
+import { openSync, mkdirSync } from "fs";
+import { getDaemonInfo, isDaemonAlive } from "../daemon/client";
+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"] = [];
+
+    // 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);
+  }
+
+  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(msg.DAEMON_ALREADY_RUNNING);
+    return;
+  }
+
+  // ── Spawn detached daemon with log redirection ──
+  const daemonScript = resolve(import.meta.dirname, "../daemon/server.ts");
+  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("bun", args, detachedSpawnOptions(logFd));
+
+  // Detach: allow parent to exit without killing child
+  child.unref();
+
+  // ── 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(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;
+}

package/src/commands/stats.ts

@@ -0,0 +1,103 @@
+/**
+ * `afd stats` — Feature usage telemetry dashboard (developer-only).
+ */
+
+import { queryTelemetry, type TelemetrySummary } from "../core/telemetry";
+
+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",
+};
+
+function bar(count: number, max: number, width = 20): string {
+  const ratio = max > 0 ? Math.min(count / max, 1) : 0;
+  const filled = Math.round(ratio * width);
+  return `${C.green}${"█".repeat(filled)}${C.dim}${"░".repeat(width - filled)}${C.reset}`;
+}
+
+function sortedEntries(obj: Record<string, number>): [string, number][] {
+  return Object.entries(obj).sort((a, b) => b[1] - a[1]);
+}
+
+function renderRankedList(data: Record<string, number>, barWidth = 16): string[] {
+  const entries = sortedEntries(data);
+  if (entries.length === 0) return [`  ${C.dim}(no data)${C.reset}`];
+  const maxVal = entries[0][1];
+  const maxNameLen = Math.max(...entries.map(([n]) => n.length), 8);
+  return entries.map(([name, count]) => {
+    const pad = " ".repeat(Math.max(1, maxNameLen - name.length + 2));
+    return `  ${C.white}${name}${C.reset}${pad}${bar(count, maxVal, barWidth)} ${count}`;
+  });
+}
+
+function renderSection(title: string): string {
+  return `\n${C.bold}${C.cyan}${title}${C.reset}\n${"─".repeat(50)}`;
+}
+
+export async function statsCommand(opts: { days?: string }) {
+  const days = parseInt(opts.days ?? "7", 10) || 7;
+  const data: TelemetrySummary = queryTelemetry(days);
+
+  const out: string[] = [];
+
+  out.push(`${C.bold}📊 Feature Usage Telemetry${C.reset}  ${C.dim}(last ${days} days, ${data.totalEvents} events total)${C.reset}`);
+
+  // CLI Commands
+  out.push(renderSection("CLI Commands"));
+  out.push(...renderRankedList(data.cli));
+
+  // MCP Tools
+  out.push(renderSection("MCP Tools"));
+  out.push(...renderRankedList(data.mcp));
+
+  // S.E.A.M Cycle
+  out.push(renderSection("S.E.A.M Cycle"));
+  const seamEntries = sortedEntries(data.seam.counts);
+  if (seamEntries.length === 0) {
+    out.push(`  ${C.dim}(no data)${C.reset}`);
+  } else {
+    const maxSeam = seamEntries[0][1];
+    const maxNameLen = Math.max(...seamEntries.map(([n]) => n.length), 8);
+    for (const [action, count] of seamEntries) {
+      const pad = " ".repeat(Math.max(1, maxNameLen - action.length + 2));
+      const avg = data.seam.avgDurationMs[action];
+      const avgStr = avg != null ? `${C.dim}avg ${avg}ms${C.reset}` : "";
+      out.push(`  ${C.white}${action}${C.reset}${pad}${bar(count, maxSeam, 12)} ${count}  ${avgStr}`);
+    }
+  }
+
+  // Immune Activity + Accuracy
+  out.push(renderSection("Immune Activity"));
+  const hits = data.immune["heal_hit"] ?? 0;
+  const falsePos = data.immune["heal_false_positive"] ?? 0;
+  const passes = data.immune["heal_pass"] ?? 0;
+  const suppressions = data.immune["suppression"] ?? 0;
+  const totalJudgments = hits + falsePos + passes;
+  const accuracy = totalJudgments > 0 ? Math.round((hits + passes) / totalJudgments * 100) : null;
+  const precisionLabel = (hits + falsePos) > 0 ? `${Math.round(hits / (hits + falsePos) * 100)}%` : "—";
+
+  out.push(`  ${C.white}Hits${C.reset}       ${hits}  ${C.dim}(corruption detected & restored)${C.reset}`);
+  out.push(`  ${C.white}Passes${C.reset}     ${passes}  ${C.dim}(immune file changed, valid)${C.reset}`);
+  out.push(`  ${C.white}False +${C.reset}    ${falsePos}  ${C.dim}(restored but user overrode)${C.reset}`);
+  out.push(`  ${C.white}Suppress${C.reset}   ${suppressions}  ${C.dim}(mass event skip)${C.reset}`);
+  out.push("");
+  out.push(`  ${C.bold}Accuracy${C.reset}   ${accuracy != null ? `${C.green}${accuracy}%${C.reset}` : `${C.dim}—${C.reset}`}  ${C.dim}(correct judgments / total)${C.reset}`);
+  out.push(`  ${C.bold}Precision${C.reset}  ${(hits + falsePos) > 0 ? `${C.green}${precisionLabel}${C.reset}` : `${C.dim}—${C.reset}`}  ${C.dim}(true hits / all blocks)${C.reset}`);
+
+  // Validators
+  if (Object.keys(data.validator).length > 0) {
+    out.push(renderSection("Validator Triggers"));
+    out.push(...renderRankedList(data.validator));
+  }
+
+  // Dead features warning
+  const allCli = ["start", "stop", "restart", "status", "score", "fix", "sync", "doctor", "diagnose", "vaccine", "evolution", "mcp", "lang", "stats"];
+  const unusedCli = allCli.filter(cmd => !(cmd in data.cli));
+  if (unusedCli.length > 0 && Object.keys(data.cli).length > 0) {
+    out.push(renderSection("Unused CLI Commands"));
+    out.push(`  ${C.yellow}${unusedCli.join(", ")}${C.reset}`);
+  }
+
+  console.log(out.join("\n"));
+}

package/src/commands/status.ts

@@ -0,0 +1,157 @@
+import { existsSync, readdirSync, readFileSync } from "fs";
+import { join } from "path";
+import { getDaemonInfo, isDaemonAlive, daemonRequest } from "../daemon/client";
+import { resolveWorkspacePaths } from "../constants";
+import { getSystemLanguage } from "../core/locale";
+
+const C = {
+  reset: "\x1b[0m",
+  bold: "\x1b[1m",
+  dim: "\x1b[2m",
+  red: "\x1b[31m",
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  cyan: "\x1b[36m",
+  white: "\x1b[37m",
+};
+
+const ko = getSystemLanguage() === "ko";
+
+interface HealthData {
+  status: string;
+  pid: number;
+  workspace: string;
+  port: number;
+}
+
+interface ScoreData {
+  uptime: number;
+  immune: { antibodies: number; autoHealed: number };
+  ecosystem: { primary: string };
+  dynamicImmune?: { activeValidators: number };
+}
+
+function checkHooksInjected(): boolean {
+  const hooksPath = join(resolveWorkspacePaths().root, ".claude/hooks.json");
+  if (!existsSync(hooksPath)) return false;
+  try {
+    const content = readFileSync(hooksPath, "utf-8");
+    return content.includes("afd-auto-heal");
+  } catch {
+    return false;
+  }
+}
+
+function checkMcpRegistered(): boolean {
+  const mcpPath = join(resolveWorkspacePaths().root, ".mcp.json");
+  if (!existsSync(mcpPath)) return false;
+  try {
+    const content = readFileSync(mcpPath, "utf-8");
+    return content.includes('"afd"');
+  } catch {
+    return false;
+  }
+}
+
+function getQuarantinedFiles(): string[] {
+  const paths = resolveWorkspacePaths();
+  if (!existsSync(paths.quarantineDir)) return [];
+  try {
+    return readdirSync(paths.quarantineDir).sort().reverse();
+  } catch {
+    return [];
+  }
+}
+
+function formatUptime(seconds: number): string {
+  if (seconds < 60) return `${seconds}s`;
+  if (seconds < 3600) return `${Math.floor(seconds / 60)}m ${seconds % 60}s`;
+  const h = Math.floor(seconds / 3600);
+  const m = Math.floor((seconds % 3600) / 60);
+  return `${h}h ${m}m`;
+}
+
+function indicator(ok: boolean): string {
+  return ok ? `${C.green}●${C.reset}` : `${C.red}●${C.reset}`;
+}
+
+export async function statusCommand() {
+  const out: string[] = [];
+
+  out.push("");
+  out.push(`${C.bold}afd status${C.reset}`);
+  out.push("");
+
+  // ── 1. Daemon ──
+  const info = getDaemonInfo();
+  if (!info || !(await isDaemonAlive(info))) {
+    out.push(`  ${C.red}●${C.reset} ${C.bold}Daemon${C.reset}       ${C.red}STOPPED${C.reset}`);
+    out.push("");
+    out.push(`  ${C.dim}${ko ? "→ afd start 를 실행하세요" : "→ Run afd start to activate"}${C.reset}`);
+    out.push("");
+    console.log(out.join("\n"));
+    return;
+  }
+
+  // Fetch live data
+  let score: ScoreData | null = null;
+  try {
+    score = await daemonRequest<ScoreData>("/score");
+  } catch { /* use fallback */ }
+
+  const uptime = score ? formatUptime(score.uptime) : "?";
+  const ecosystem = score?.ecosystem.primary ?? "Unknown";
+
+  out.push(`  ${C.green}●${C.reset} ${C.bold}Daemon${C.reset}       ${C.green}ACTIVE${C.reset} ${C.dim}(pid=${info.pid} port=${info.port})${C.reset}`);
+  out.push(`  ${C.dim}  Uptime${C.reset}      ${uptime}  ${C.dim}|${C.reset}  ${ecosystem}`);
+  out.push("");
+
+  // ── 2. Connections ──
+  out.push(`  ${C.bold}${ko ? "연결 상태" : "Connections"}${C.reset}`);
+
+  const hooksOk = checkHooksInjected();
+  out.push(`  ${indicator(hooksOk)} Hook        ${hooksOk ? `${C.green}INJECTED${C.reset}` : `${C.red}MISSING${C.reset} ${C.dim}(afd start로 주입)${C.reset}`}`);
+
+  const mcpOk = checkMcpRegistered();
+  out.push(`  ${indicator(mcpOk)} MCP         ${mcpOk ? `${C.green}REGISTERED${C.reset}` : `${C.yellow}NOT SET${C.reset}`}`);
+
+  out.push("");
+
+  // ── 3. Defenses ──
+  out.push(`  ${C.bold}${ko ? "방어막" : "Defenses"}${C.reset}`);
+
+  const antibodies = score?.immune.antibodies ?? 0;
+  const healed = score?.immune.autoHealed ?? 0;
+  const validators = score?.dynamicImmune?.activeValidators ?? 0;
+
+  out.push(`  ${indicator(antibodies > 0)} ${ko ? "항체" : "Antibodies"}   ${C.bold}${antibodies}${C.reset} ${ko ? "활성" : "active"}${healed > 0 ? `  ${C.dim}(${healed}${ko ? "회 치유" : " healed"})${C.reset}` : ""}`);
+  out.push(`  ${indicator(validators > 0)} ${ko ? "검증기" : "Validators"}  ${validators > 0 ? `${C.bold}${validators}${C.reset} ${ko ? "로드됨" : "loaded"}` : `${C.dim}${ko ? "없음" : "none"}${C.reset} ${C.dim}(.afd/validators/)${C.reset}`}`);
+
+  out.push("");
+
+  // ── 4. Quarantine ──
+  const quarantined = getQuarantinedFiles();
+
+  if (quarantined.length > 0) {
+    out.push(`  ${C.yellow}⚠${C.reset}  ${C.bold}${C.yellow}${ko ? "격리 구역" : "Quarantine"}${C.reset} ${C.dim}(${quarantined.length} ${ko ? "파일" : "file"}${quarantined.length !== 1 ? "s" : ""})${C.reset}`);
+
+    const show = quarantined.slice(0, 5);
+    for (const file of show) {
+      out.push(`     ${C.dim}${file}${C.reset}`);
+    }
+    if (quarantined.length > 5) {
+      out.push(`     ${C.dim}... +${quarantined.length - 5} more${C.reset}`);
+    }
+
+    out.push("");
+    out.push(`  ${C.dim}💡 ${ko
+      ? "격리된 파일에서 코드를 구출하거나 불필요하면 삭제하세요."
+      : "Rescue code from quarantined files or delete if unneeded."}${C.reset}`);
+    out.push(`  ${C.dim}   ${ko ? "경로" : "Path"}: .afd/quarantine/${C.reset}`);
+  } else {
+    out.push(`  ${C.green}●${C.reset} ${ko ? "격리 구역" : "Quarantine"}   ${C.dim}${ko ? "비어있음 — 이상 없음" : "empty — all clear"}${C.reset}`);
+  }
+
+  out.push("");
+  console.log(out.join("\n"));
+}

package/src/commands/stop.ts

@@ -1,49 +1,68 @@
-import { getDaemonInfo, isDaemonAlive, daemonRequest } from "../daemon/client";
-import { unlinkSync } from "fs";
-import { PID_FILE, PORT_FILE } from "../constants";
-import { formatShiftSummary } from "../core/boast";
-import type { ShiftSummary } from "../core/boast";
-import { getSystemLanguage } from "../core/locale";
-import { getMessages, t } from "../core/i18n/messages";
-
-function cleanupFiles() {
-  try { unlinkSync(PID_FILE); } catch {}
-  try { unlinkSync(PORT_FILE); } catch {}
-}
-
-export async function stopCommand() {
-  const lang = getSystemLanguage();
-  const msg = getMessages(lang);
-  const info = getDaemonInfo();
-
-  if (!info) {
-    console.log(msg.DAEMON_NOT_RUNNING);
-    return;
-  }
-
-  if (await isDaemonAlive(info)) {
-    // Fetch shift summary before stopping
-    try {
-      const summary = await daemonRequest<ShiftSummary>("/shift-summary");
-      console.log(formatShiftSummary(summary, lang));
-    } catch {
-      // Non-fatal: summary is a nicety, not a requirement
-    }
-
-    try {
-      await daemonRequest("/stop");
-      console.log(t(msg.DAEMON_STOPPED, { pid: info.pid }));
-    } catch {
-      try {
-        process.kill(info.pid, "SIGTERM");
-        console.log(t(msg.DAEMON_KILLED, { pid: info.pid }));
-      } catch {
-        console.log("[afd] Daemon process already gone.");
-      }
-    }
-  } else {
-    console.log(msg.DAEMON_NOT_RESPONDING);
-  }
-
-  cleanupFiles();
-}
+import { getDaemonInfo, isDaemonAlive, daemonRequest } from "../daemon/client";
+import { unlinkSync } from "fs";
+import { resolveWorkspacePaths } from "../constants";
+import { formatShiftSummary } from "../core/boast";
+import type { ShiftSummary } from "../core/boast";
+import { getSystemLanguage } from "../core/locale";
+import { getMessages, t } from "../core/i18n/messages";
+import { detectEcosystem } from "../adapters/index";
+
+function cleanupFiles() {
+  const paths = resolveWorkspacePaths();
+  try { unlinkSync(paths.pidFile); } catch {}
+  try { unlinkSync(paths.portFile); } catch {}
+}
+
+export async function stopCommand(options?: { clean?: boolean }) {
+  const lang = getSystemLanguage();
+  const msg = getMessages(lang);
+  const info = getDaemonInfo();
+
+  if (!info) {
+    console.log(msg.DAEMON_NOT_RUNNING);
+    return;
+  }
+
+  if (await isDaemonAlive(info)) {
+    // Fetch shift summary before stopping
+    try {
+      const summary = await daemonRequest<ShiftSummary>("/shift-summary");
+      console.log(formatShiftSummary(summary, lang));
+    } catch {
+      // Non-fatal: summary is a nicety, not a requirement
+    }
+
+    try {
+      await daemonRequest("/stop");
+      console.log(t(msg.DAEMON_STOPPED, { pid: info.pid }));
+    } catch {
+      try {
+        process.kill(info.pid, "SIGTERM");
+        console.log(t(msg.DAEMON_KILLED, { pid: info.pid }));
+      } catch {
+        console.log("[afd] Daemon process already gone.");
+      }
+    }
+  } else {
+    console.log(msg.DAEMON_NOT_RESPONDING);
+  }
+
+  cleanupFiles();
+
+  // --clean: remove injected hooks and MCP registration
+  if (options?.clean) {
+    const cwd = process.cwd();
+    const ecosystems = detectEcosystem(cwd);
+    for (const { adapter } of ecosystems) {
+      if (adapter.removeHooks) {
+        const r = adapter.removeHooks(cwd);
+        if (r.removed) console.log(`[afd] ${r.message}`);
+      }
+      if (adapter.unregisterMcp) {
+        const r = adapter.unregisterMcp(cwd);
+        if (r.removed) console.log(`[afd] ${r.message}`);
+      }
+    }
+    console.log("[afd] Clean stop complete. All afd integrations removed.");
+  }
+}