autonomous-flow-daemon 1.1.0 → 1.9.0

package/src/commands/fix.ts

@@ -1,138 +1,158 @@
-import { writeFileSync, mkdirSync, existsSync } from "fs";
-import { dirname } from "path";
-import { daemonRequest } from "../daemon/client";
-import type { Symptom, PatchOp, DiagnosisResult } from "../core/immune";
-
-const SEVERITY_ICON: Record<string, string> = {
-  critical: "[!]",
-  warning: "[~]",
-  info: "[i]",
-};
-
-function applyPatch(patch: PatchOp): boolean {
-  // Map JSON-Patch path to filesystem path (strip leading /)
-  const filePath = patch.path.replace(/^\//, "");
-
-  if (patch.op === "add") {
-    if (existsSync(filePath)) return false; // don't overwrite
-    const dir = dirname(filePath);
-    if (dir !== ".") mkdirSync(dir, { recursive: true });
-    writeFileSync(filePath, patch.value ?? "", "utf-8");
-    return true;
-  }
-
-  if (patch.op === "replace") {
-    const dir = dirname(filePath);
-    if (dir !== ".") mkdirSync(dir, { recursive: true });
-    writeFileSync(filePath, patch.value ?? "", "utf-8");
-    return true;
-  }
-
-  // remove, move, copy, test — not needed yet
-  return false;
-}
-
-async function learnAntibody(symptom: Symptom): Promise<void> {
-  await fetch(
-    `http://127.0.0.1:${(await getDaemonPort())}/antibodies/learn`,
-    {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        id: symptom.id,
-        patternType: symptom.patternType,
-        fileTarget: symptom.fileTarget,
-        patches: symptom.patches,
-      }),
-    }
-  );
-}
-
-async function getDaemonPort(): Promise<number> {
-  const { readFileSync } = await import("fs");
-  const { PORT_FILE } = await import("../constants");
-  return parseInt(readFileSync(PORT_FILE, "utf-8").trim(), 10);
-}
-
-export async function fixCommand() {
-  let diagnosis: DiagnosisResult;
-  try {
-    diagnosis = await daemonRequest<DiagnosisResult>("/diagnose");
-  } catch (err: unknown) {
-    const msg = err instanceof Error ? err.message : String(err);
-    console.error(`[afd fix] ${msg}`);
-    process.exit(1);
-  }
-
-  if (diagnosis.symptoms.length === 0) {
-    console.log("[afd fix] No symptoms detected. System is healthy.");
-    if (diagnosis.healthy.length > 0) {
-      console.log(`[afd fix] Passed checks: ${diagnosis.healthy.join(", ")}`);
-    }
-    return;
-  }
-
-  // Display symptoms
-  console.log(`\n[afd fix] Found ${diagnosis.symptoms.length} symptom(s):\n`);
-
-  for (const s of diagnosis.symptoms) {
-    const icon = SEVERITY_ICON[s.severity] ?? "[?]";
-    console.log(`  ${icon} ${s.id}: ${s.title} (${s.severity})`);
-    console.log(`      ${s.description}`);
-    if (s.patches.length > 0) {
-      console.log(`      Patch: ${s.patches.map(p => `${p.op} ${p.path}`).join(", ")}`);
-    }
-    console.log();
-  }
-
-  // Back-stage: dump full JSON-Patch for AI consumers
-  const allPatches = diagnosis.symptoms.flatMap(s =>
-    s.patches.map(p => ({ symptomId: s.id, ...p }))
-  );
-  console.log("[afd fix] JSON-Patch (back-stage):");
-  console.log(JSON.stringify(allPatches, null, 2));
-  console.log();
-
-  // Prompt user
-  process.stdout.write("Apply these fixes? [Y/n] ");
-  const answer = await readLine();
-
-  if (answer.toLowerCase() === "n") {
-    console.log("[afd fix] Aborted.");
-    return;
-  }
-
-  // Apply patches and learn antibodies
-  let applied = 0;
-  for (const symptom of diagnosis.symptoms) {
-    if (symptom.patches.length === 0) continue;
-    let success = true;
-    for (const patch of symptom.patches) {
-      if (!applyPatch(patch)) {
-        console.log(`  [skip] ${patch.op} ${patch.path} (already exists or unsupported)`);
-        success = false;
-      } else {
-        console.log(`  [done] ${patch.op} ${patch.path}`);
-        applied++;
-      }
-    }
-    if (success) {
-      await learnAntibody(symptom);
-      console.log(`  [immune] Learned antibody: ${symptom.id}`);
-    }
-  }
-
-  console.log(`\n[afd fix] Applied ${applied} patch(es). Immune system updated.`);
-}
-
-function readLine(): Promise<string> {
-  return new Promise((resolve) => {
-    const buf: Buffer[] = [];
-    process.stdin.setEncoding("utf-8");
-    process.stdin.resume();
-    process.stdin.once("data", (chunk: string) => {
-      process.stdin.pause();
-      resolve(chunk.toString().trim());
-    });
-  });
-}
+import { writeFileSync, mkdirSync, existsSync } from "fs";
+import { dirname } from "path";
+import { daemonRequest } from "../daemon/client";
+import type { Symptom, PatchOp, DiagnosisResult } from "../core/immune";
+
+const SEVERITY_ICON: Record<string, string> = {
+  critical: "[!]",
+  warning: "[~]",
+  info: "[i]",
+};
+
+function applyPatch(patch: PatchOp): boolean {
+  // Map JSON-Patch path to filesystem path (strip leading /)
+  const filePath = patch.path.replace(/^\//, "");
+
+  // Guard: reject path traversal attempts
+  if (filePath.includes("..") || filePath.startsWith("/") || /^[A-Za-z]:/.test(filePath)) return false;
+
+  if (patch.op === "add") {
+    if (existsSync(filePath)) return false; // don't overwrite
+    const dir = dirname(filePath);
+    if (dir !== ".") mkdirSync(dir, { recursive: true });
+    writeFileSync(filePath, patch.value ?? "", "utf-8");
+    return true;
+  }
+
+  if (patch.op === "replace") {
+    const dir = dirname(filePath);
+    if (dir !== ".") mkdirSync(dir, { recursive: true });
+    writeFileSync(filePath, patch.value ?? "", "utf-8");
+    return true;
+  }
+
+  // remove, move, copy, test — not needed yet
+  return false;
+}
+
+async function learnAntibody(symptom: Symptom): Promise<void> {
+  await fetch(
+    `http://127.0.0.1:${(await getDaemonPort())}/antibodies/learn`,
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        id: symptom.id,
+        patternType: symptom.patternType,
+        fileTarget: symptom.fileTarget,
+        patches: symptom.patches,
+      }),
+    }
+  );
+}
+
+async function getDaemonPort(): Promise<number> {
+  const { readFileSync } = await import("fs");
+  const { resolveWorkspacePaths } = await import("../constants");
+  const paths = resolveWorkspacePaths();
+  return parseInt(readFileSync(paths.portFile, "utf-8").trim(), 10);
+}
+
+export async function fixCommand() {
+  let diagnosis: DiagnosisResult;
+  try {
+    diagnosis = await daemonRequest<DiagnosisResult>("/diagnose");
+  } catch (err: unknown) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(`[afd fix] ${msg}`);
+    process.exit(1);
+  }
+
+  if (diagnosis.symptoms.length === 0) {
+    console.log("[afd fix] No symptoms detected. System is healthy.");
+    if (diagnosis.healthy.length > 0) {
+      console.log(`[afd fix] Passed checks: ${diagnosis.healthy.join(", ")}`);
+    }
+    return;
+  }
+
+  // Display symptoms
+  console.log(`\n[afd fix] Found ${diagnosis.symptoms.length} symptom(s):\n`);
+
+  for (const s of diagnosis.symptoms) {
+    const icon = SEVERITY_ICON[s.severity] ?? "[?]";
+    console.log(`  ${icon} ${s.id}: ${s.title} (${s.severity})`);
+    console.log(`      ${s.description}`);
+    if (s.patches.length > 0) {
+      console.log(`      Patch: ${s.patches.map(p => `${p.op} ${p.path}`).join(", ")}`);
+    }
+    console.log();
+  }
+
+  // Extract phase: inject hologram context for AI consumers
+  const symptomsWithHologram = diagnosis.symptoms as (Symptom & { hologram?: string })[];
+  const holograms = symptomsWithHologram.filter(s => s.hologram);
+  if (holograms.length > 0) {
+    console.log("[afd fix] Hologram Context (Extract phase — token-optimized file structures):\n");
+    for (const s of holograms) {
+      console.log(`  --- ${s.fileTarget} ---`);
+      console.log(`  Here is the structural hologram of the file to help you understand`);
+      console.log(`  its interfaces without consuming too many tokens:\n`);
+      for (const line of s.hologram!.split("\n")) {
+        console.log(`    ${line}`);
+      }
+      console.log(`\n  Now, generate the JSON-Patch based on the structure above.\n`);
+    }
+  }
+
+  // Back-stage: dump full JSON-Patch for AI consumers
+  const allPatches = diagnosis.symptoms.flatMap(s =>
+    s.patches.map(p => ({ symptomId: s.id, ...p }))
+  );
+  console.log("[afd fix] JSON-Patch (back-stage):");
+  console.log(JSON.stringify(allPatches, null, 2));
+  console.log();
+
+  // Prompt user
+  process.stdout.write("Apply these fixes? [Y/n] ");
+  const answer = await readLine();
+
+  if (answer.toLowerCase() === "n") {
+    console.log("[afd fix] Aborted.");
+    return;
+  }
+
+  // Apply patches and learn antibodies
+  let applied = 0;
+  for (const symptom of diagnosis.symptoms) {
+    if (symptom.patches.length === 0) continue;
+    let success = true;
+    for (const patch of symptom.patches) {
+      if (!applyPatch(patch)) {
+        console.log(`  [skip] ${patch.op} ${patch.path} (already exists or unsupported)`);
+        success = false;
+      } else {
+        console.log(`  [done] ${patch.op} ${patch.path}`);
+        applied++;
+      }
+    }
+    if (success) {
+      await learnAntibody(symptom);
+      console.log(`  [immune] Learned antibody: ${symptom.id}`);
+    }
+  }
+
+  console.log(`\n[afd fix] Applied ${applied} patch(es). Immune system updated.`);
+}
+
+function readLine(): Promise<string> {
+  return new Promise((resolve) => {
+    const buf: Buffer[] = [];
+    process.stdin.setEncoding("utf-8");
+    process.stdin.resume();
+    process.stdin.once("data", (chunk: string) => {
+      process.stdin.pause();
+      resolve(chunk.toString().trim());
+    });
+  });
+}

package/src/commands/hooks.ts

@@ -0,0 +1,136 @@
+import { join } from "path";
+import { resolveWorkspacePaths } from "../constants";
+import {
+  readHooksFile,
+  writeHooksFile,
+  mergeHooks,
+  getHookSummary,
+  getAfdDesiredHooks,
+  type HookOwner,
+  type ManagedHook,
+} from "../core/hook-manager";
+
+const C = {
+  reset: "\x1b[0m",
+  bold: "\x1b[1m",
+  dim: "\x1b[2m",
+  red: "\x1b[31m",
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  cyan: "\x1b[36m",
+};
+
+const OWNER_COLOR: Record<HookOwner, string> = {
+  afd: C.cyan,
+  omc: C.yellow,
+  user: C.dim,
+};
+
+function formatHookLine(hook: ManagedHook): string {
+  const color = OWNER_COLOR[hook.owner];
+  const ownerTag = `[${hook.owner}]`.padEnd(6);
+  const id = hook.id.padEnd(24);
+  const matcher = hook.matcher || "*";
+  return `  ${color}${ownerTag}${C.reset} ${C.bold}${id}${C.reset} ${C.dim}${matcher}${C.reset}`;
+}
+
+export function hooksCommand(subcommand?: string): void {
+  const hooksPath = join(resolveWorkspacePaths().root, ".claude", "hooks.json");
+
+  if (!subcommand || subcommand === "status") {
+    const summary = getHookSummary(hooksPath);
+    const total = summary.total;
+    console.log("");
+    console.log(`${C.bold}afd hooks — Hook Manager${C.reset}`);
+    console.log("");
+    console.log(`  PreToolUse (${total} hook${total !== 1 ? "s" : ""})`);
+    console.log("  " + "─".repeat(48));
+
+    const allInOrder: ManagedHook[] = [
+      ...summary.zones.afd,
+      ...summary.zones.omc,
+      ...summary.zones.user,
+    ];
+
+    if (allInOrder.length === 0) {
+      console.log(`  ${C.dim}No hooks registered${C.reset}`);
+    } else {
+      for (const hook of allInOrder) {
+        console.log(formatHookLine(hook));
+      }
+    }
+
+    console.log("");
+
+    const orderStatus = summary.orderingOk
+      ? `${C.green}OK${C.reset} ${C.dim}(afd → omc → user)${C.reset}`
+      : `${C.yellow}DISORDERED${C.reset} — run ${C.bold}afd hooks sync${C.reset} to fix`;
+    console.log(`  Ordering:  ${orderStatus}`);
+
+    if (summary.conflicts.length === 0) {
+      console.log(`  Conflicts: ${C.green}none${C.reset}`);
+    } else {
+      console.log(`  Conflicts: ${C.yellow}${summary.conflicts.length} warning(s)${C.reset}`);
+      for (const c of summary.conflicts) {
+        const prefix = c.type === "duplicate-id" ? "✗" : "⚠";
+        console.log(`    ${C.yellow}${prefix}${C.reset} ${c.type}: ${C.bold}${c.hookA.id}${C.reset} ↔ ${C.bold}${c.hookB.id}${C.reset}`);
+        console.log(`      ${C.dim}${c.resolution}${C.reset}`);
+      }
+    }
+
+    console.log("");
+    return;
+  }
+
+  if (subcommand === "sync") {
+    console.log("");
+    console.log(`${C.bold}afd hooks sync${C.reset}`);
+    console.log("");
+
+    const config = readHooksFile(hooksPath);
+    if (!config.hooks || typeof config.hooks !== "object" || Array.isArray(config.hooks)) {
+      config.hooks = {};
+    }
+    if (!config.hooks.PreToolUse) config.hooks.PreToolUse = [];
+
+    const result = mergeHooks(config.hooks.PreToolUse, getAfdDesiredHooks());
+    config.hooks.PreToolUse = result.merged;
+    writeHooksFile(hooksPath, config);
+
+    let anyChange = false;
+    if (result.changes.added.length > 0) {
+      console.log(`  Added:     ${result.changes.added.join(", ")}`);
+      anyChange = true;
+    }
+    if (result.changes.removed.length > 0) {
+      console.log(`  Removed:   ${result.changes.removed.join(", ")}`);
+      anyChange = true;
+    }
+    if (result.changes.reordered.length > 0) {
+      console.log(`  Reordered: ${result.changes.reordered.join(", ")}`);
+      anyChange = true;
+    }
+    if (!anyChange) {
+      console.log(`  ${C.green}Already in sync — no changes needed${C.reset}`);
+    }
+
+    if (result.conflicts.length > 0) {
+      console.log(`  Conflicts: ${C.yellow}${result.conflicts.length} warning(s)${C.reset}`);
+      for (const c of result.conflicts) {
+        const prefix = c.type === "duplicate-id" ? "✗" : "⚠";
+        console.log(`    ${C.yellow}${prefix}${C.reset} ${c.type}: ${C.bold}${c.hookA.id}${C.reset} ↔ ${C.bold}${c.hookB.id}${C.reset}`);
+        console.log(`      ${C.dim}${c.resolution}${C.reset}`);
+      }
+    } else {
+      console.log(`  Conflicts: ${C.green}none${C.reset}`);
+    }
+
+    console.log(`  ${C.dim}hooks.json updated.${C.reset}`);
+    console.log("");
+    return;
+  }
+
+  console.error(`Unknown subcommand: ${subcommand}`);
+  console.error("Usage: afd hooks [status|sync]");
+  process.exit(1);
+}

package/src/commands/lang.ts

@@ -1,41 +1,41 @@
-import { getSystemLanguage, getSupportedLanguages, setLanguageOverride } from "../core/locale";
-import type { SupportedLang } from "../core/locale";
-import { writeConfig, getConfigPath } from "../core/config";
-import { getMessages, t } from "../core/i18n/messages";
-
-export function langCommand(targetLang?: string, options?: { list?: boolean }) {
-  const currentLang = getSystemLanguage();
-  const msg = getMessages(currentLang);
-  const supported = getSupportedLanguages();
-
-  // afd lang --list
-  if (options?.list) {
-    console.log(msg.LANG_LIST_TITLE);
-    for (const lang of supported) {
-      const marker = lang === currentLang ? " ← current" : "";
-      console.log(`  ${lang}${marker}`);
-    }
-    return;
-  }
-
-  // afd lang (no argument) — show current
-  if (!targetLang) {
-    console.log(t(msg.LANG_CURRENT, { lang: currentLang }));
-    return;
-  }
-
-  // afd lang <en|ko> — change language
-  if (!supported.includes(targetLang as SupportedLang)) {
-    console.error(t(msg.LANG_INVALID, { lang: targetLang, supported: supported.join(", ") }));
-    process.exit(1);
-  }
-
-  const newLang = targetLang as SupportedLang;
-  writeConfig({ lang: newLang });
-  setLanguageOverride(newLang);
-
-  // Print feedback in the NEW language
-  const newMsg = getMessages(newLang);
-  console.log(t(newMsg.LANG_CHANGED, { lang: newLang }));
-  console.log(t(newMsg.LANG_SAVED, { path: getConfigPath() }));
-}
+import { getSystemLanguage, getSupportedLanguages, setLanguageOverride } from "../core/locale";
+import type { SupportedLang } from "../core/locale";
+import { writeConfig, getConfigPath } from "../core/config";
+import { getMessages, t } from "../core/i18n/messages";
+
+export function langCommand(targetLang?: string, options?: { list?: boolean }) {
+  const currentLang = getSystemLanguage();
+  const msg = getMessages(currentLang);
+  const supported = getSupportedLanguages();
+
+  // afd lang --list
+  if (options?.list) {
+    console.log(msg.LANG_LIST_TITLE);
+    for (const lang of supported) {
+      const marker = lang === currentLang ? " ← current" : "";
+      console.log(`  ${lang}${marker}`);
+    }
+    return;
+  }
+
+  // afd lang (no argument) — show current
+  if (!targetLang) {
+    console.log(t(msg.LANG_CURRENT, { lang: currentLang }));
+    return;
+  }
+
+  // afd lang <en|ko> — change language
+  if (!supported.includes(targetLang as SupportedLang)) {
+    console.error(t(msg.LANG_INVALID, { lang: targetLang, supported: supported.join(", ") }));
+    process.exit(1);
+  }
+
+  const newLang = targetLang as SupportedLang;
+  writeConfig({ lang: newLang });
+  setLanguageOverride(newLang);
+
+  // Print feedback in the NEW language
+  const newMsg = getMessages(newLang);
+  console.log(t(newMsg.LANG_CHANGED, { lang: newLang }));
+  console.log(t(newMsg.LANG_SAVED, { path: getConfigPath() }));
+}

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);
+}