autonomous-flow-daemon 1.1.0 → 1.9.0

package/src/daemon/types.ts

@@ -0,0 +1,121 @@
+/**
+ * Shared types for the afd daemon modules.
+ */
+
+import type { DetectionResult } from "../adapters/index";
+import type { PatchOp } from "../core/immune";
+import type { LruStringMap } from "../core/lru-map";
+
+// ── Constants ──
+export const DOUBLE_TAP_WINDOW_MS = 30_000;
+export const MASS_EVENT_THRESHOLD = 3;
+export const MASS_EVENT_WINDOW_MS = 1_000;
+export const TAP_CLEANUP_INTERVAL_MS = 60_000;
+export const SELF_WRITE_DEBOUNCE_MS = 100;
+export const MAX_SSE_CLIENTS = 20;
+export const VALIDATOR_TIMEOUT_MS = 500;
+export const VALIDATORS_DIR = ".afd/validators";
+
+// ── Types ──
+export type ValidatorFn = (newContent: string, filePath: string) => boolean;
+
+export interface HologramStats {
+  totalRequests: number;
+  totalOriginalChars: number;
+  totalHologramChars: number;
+  sessionOriginalChars: number;
+  sessionHologramChars: number;
+}
+
+export interface MistakeEntry {
+  mistake_type: string;
+  description: string;
+  timestamp: number;
+}
+
+/** SEAM 이벤트 로그 항목 (afd://events 리소스용) */
+export interface SeamEventEntry {
+  phase: string;
+  msg: string;
+  ts: number;
+}
+
+/** 격리(quarantine) 로그 항목 (afd://quarantine 리소스용) */
+export interface QuarantineLogEntry {
+  path: string;
+  ts: number;
+}
+
+export interface DaemonState {
+  startedAt: number;
+  filesDetected: number;
+  lastEvent: string | null;
+  lastEventAt: number | null;
+  watchedFiles: Set<string>;
+  hologramStats: HologramStats;
+  ecosystems: DetectionResult[];
+  autoHealCount: number;
+  autoHealLog: { id: string; at: number; file: string; healMs: number }[];
+  recentUnlinks: number[];
+  firstTapTimestamps: Map<string, number>;
+  suppressionSkippedCount: number;
+  dormantTransitions: { antibodyId: string; at: number }[];
+  totalFileBytesSaved: number;
+  totalSavedTokens: number;
+  fileSnapshots: LruStringMap;
+  sseClients: Set<ReadableStreamDefaultController<Uint8Array>>;
+  customValidators: Map<string, ValidatorFn>;
+  mistakeCache: Map<string, MistakeEntry[]>;
+  /** v1.9.0: 실시간 SEAM 이벤트 링 버퍼 (최근 200개) */
+  seamEventLog: SeamEventEntry[];
+  /** v1.9.0: 격리 이벤트 로그 (최근 100개) */
+  quarantineLog: QuarantineLogEntry[];
+}
+
+export interface DaemonOptions {
+  mcp?: boolean;
+}
+
+export { type PatchOp, type DetectionResult };
+
+/**
+ * DaemonContext — shared dependency bag passed to all daemon modules.
+ * Created once in main() and threaded through MCP/HTTP handlers.
+ */
+export interface DaemonContext {
+  state: DaemonState;
+  db: { query: (sql: string) => { get: () => unknown }; prepare: (sql: string) => { run: (...args: unknown[]) => void; get: (...args: unknown[]) => unknown; all: () => unknown[] } };
+  ws: { root: string; afdDir: string; pidFile: string; portFile: string; dbFile: string; logFile: string; quarantineDir: string };
+
+  // Prepared statements
+  insertEvent: { run: (...args: unknown[]) => void };
+  insertAntibody: { run: (...args: unknown[]) => void };
+  listAntibodies: { all: () => unknown[] };
+  antibodyIds: { all: () => { id: string }[] };
+  countAntibodies: { get: () => { cnt: number } };
+  getDailyAll: { all: () => { date: string; requests: number; original_chars: number; hologram_chars: number }[] };
+  insertTelemetry: { run: (...args: unknown[]) => void };
+  insertMistakeHistory: { run: (...args: unknown[]) => void };
+  queryMistakesByFile: { all: (...args: unknown[]) => MistakeEntry[] };
+  deleteMistakeOverflow: { run: (...args: unknown[]) => void };
+
+  // Helper functions
+  seam: (phase: string, msg: string) => void;
+  persistHologramStats: (originalChars: number, hologramChars: number) => void;
+  persistCtxSavings: (type: 'wsmap' | 'pinpoint', originalChars: number, savedChars: number) => void;
+  safeHologram: (filePath: string, source: string) => Promise<string>;
+  getWorkspaceMap: () => string;
+  getWorkspaceMapStats: () => { totalProjectBytes: number; mapBytes: number };
+  today: () => string;
+  getCtxSavingsDaily: { all: () => { date: string; type: string; requests: number; original_chars: number; saved_chars: number }[] };
+  getCtxSavingsLifetime: { all: () => { type: string; total_requests: number; total_original_chars: number; total_saved_chars: number }[] };
+
+  // Discovery
+  discoveryTargets: string[];
+
+  // Options
+  options: DaemonOptions;
+
+  // Mutable port (set after Bun.serve)
+  port: number;
+}

package/src/daemon/workspace-map.ts

@@ -0,0 +1,104 @@
+/**
+ * Workspace Map — cached project structure with export signatures.
+ * Provides afd://workspace-map MCP resource.
+ */
+
+import { readdirSync, readFileSync, lstatSync } from "fs";
+import { join } from "path";
+
+const MAX_WALK_DEPTH = 8;
+const SKIP_DIRS = new Set(["node_modules", ".afd", ".git", "dist", "coverage"]);
+const CODE_EXTS = /\.[tj]sx?$/;
+const DOC_EXTS = /\.(ts|js|tsx|jsx|json|md)$/;
+
+/** Build a workspace map: file tree with sizes and export signatures */
+function buildWorkspaceMap(): { map: string; totalProjectBytes: number } {
+  const cwd = process.cwd();
+  const lines: string[] = [`# Workspace Map — ${cwd}`, `# Generated: ${new Date().toISOString()}`, ""];
+  let totalProjectBytes = 0;
+
+  function walk(dir: string, prefix: string, depth: number) {
+    if (depth > MAX_WALK_DEPTH) return;
+    let entries: string[];
+    try { entries = readdirSync(dir).sort(); } catch { return; }
+    for (const entry of entries) {
+      if (SKIP_DIRS.has(entry)) continue;
+      const fullPath = join(dir, entry);
+      try {
+        const lst = lstatSync(fullPath);
+        if (lst.isSymbolicLink()) continue;
+        if (lst.isDirectory()) {
+          lines.push(`${prefix}${entry}/`);
+          walk(fullPath, prefix + "  ", depth + 1);
+          continue;
+        }
+        if (!DOC_EXTS.test(entry)) continue;
+        totalProjectBytes += lst.size;
+        const sizeKB = (lst.size / 1024).toFixed(1);
+        if (CODE_EXTS.test(entry) && lst.size < 100 * 1024) {
+          try {
+            const source = readFileSync(fullPath, "utf-8");
+            const exports = source.match(/export\s+(?:async\s+)?(?:function|const|class|interface|type|enum)\s+(\w+)/g);
+            const sigs = exports ? exports.map(e => e.replace(/^export\s+(async\s+)?/, "").trim()).slice(0, 5).join(", ") : "";
+            const extra = exports && exports.length > 5 ? ` +${exports.length - 5} more` : "";
+            lines.push(`${prefix}${entry}  (${sizeKB}KB)${sigs ? `  → ${sigs}${extra}` : ""}`);
+          } catch {
+            lines.push(`${prefix}${entry}  (${sizeKB}KB)`);
+          }
+        } else {
+          lines.push(`${prefix}${entry}  (${sizeKB}KB)`);
+        }
+      } catch { /* skip */ }
+    }
+  }
+
+  walk(join(cwd, "src"), "  ", 0);
+
+  lines.push("", "# Root files");
+  for (const f of ["CLAUDE.md", "package.json", ".claudeignore", ".mcp.json"]) {
+    try {
+      const st = lstatSync(join(cwd, f));
+      totalProjectBytes += st.size;
+      lines.push(`  ${f}  (${(st.size / 1024).toFixed(1)}KB)`);
+    } catch { /* not found */ }
+  }
+
+  return { map: lines.join("\n"), totalProjectBytes };
+}
+
+/**
+ * Creates a workspace map manager with lazy caching.
+ * Returns getWorkspaceMap() and markMapDirty() functions.
+ */
+export function createWorkspaceMap() {
+  let cache = "";
+  let dirty = true;
+  let timer: ReturnType<typeof setTimeout> | null = null;
+  let lastTotalProjectBytes = 0;
+  let lastMapBytes = 0;
+
+  function get(): string {
+    if (dirty || !cache) {
+      const result = buildWorkspaceMap();
+      cache = result.map;
+      lastTotalProjectBytes = result.totalProjectBytes;
+      lastMapBytes = result.map.length;
+      dirty = false;
+    }
+    return cache;
+  }
+
+  function getLastBuildStats() {
+    return { totalProjectBytes: lastTotalProjectBytes, mapBytes: lastMapBytes };
+  }
+
+  function markDirty() {
+    dirty = true;
+    if (timer) clearTimeout(timer);
+    timer = setTimeout(() => { get(); }, 5000);
+  }
+
+  function getTimer() { return timer; }
+
+  return { get, getLastBuildStats, markDirty, getTimer };
+}

package/src/platform.ts

@@ -1,39 +1,60 @@
-import { platform } from "os";
-import type { SpawnOptions } from "child_process";
-
-export const IS_WINDOWS = platform() === "win32";
-export const IS_MACOS = platform() === "darwin";
-export const IS_LINUX = platform() === "linux";
-
-/**
- * Returns spawn options appropriate for detaching a background daemon.
- * On Windows, `shell: true` is required for `detached` to create a new console.
- */
-export function detachedSpawnOptions(
-  logFd: number,
-): SpawnOptions {
-  const base: SpawnOptions = {
-    detached: true,
-    stdio: ["ignore", logFd, logFd],
-    cwd: process.cwd(),
-    env: { ...process.env },
-  };
-
-  if (IS_WINDOWS) {
-    // Windows needs shell:true for detached to work properly
-    // and windowsHide to prevent a console flash
-    return { ...base, shell: true, windowsHide: true };
-  }
-
-  return base;
-}
-
-/**
- * Resolve the hook command for invoking afd diagnose.
- * Priority:
- *   1. Global `afd` binary (npm/bun global install)
- *   2. `bunx afd` fallback
- */
-export function resolveHookCommand(): string {
-  return "afd diagnose --format a2a --auto-heal";
-}
+import { platform } from "os";
+import type { SpawnOptions } from "child_process";
+import { execSync } from "child_process";
+
+export const IS_WINDOWS = platform() === "win32";
+export const IS_MACOS = platform() === "darwin";
+export const IS_LINUX = platform() === "linux";
+
+/**
+ * Returns spawn options appropriate for detaching a background daemon.
+ * On Windows, `shell: true` is required for `detached` to create a new console.
+ */
+export function detachedSpawnOptions(
+  logFd: number,
+): SpawnOptions {
+  const base: SpawnOptions = {
+    detached: true,
+    stdio: ["ignore", logFd, logFd],
+    cwd: process.cwd(),
+    env: { ...process.env },
+  };
+
+  if (IS_WINDOWS) {
+    // Windows needs shell:true for detached to work properly
+    // and windowsHide to prevent a console flash
+    return { ...base, shell: true, windowsHide: true };
+  }
+
+  return base;
+}
+
+const DIAGNOSE_ARGS = "diagnose --format a2a --auto-heal";
+
+/**
+ * Resolve the hook command for invoking afd diagnose.
+ * Priority:
+ *   1. Global `afd` binary (npm/bun global install)
+ *   2. `bunx afd` fallback (Bun environment)
+ *   3. `npx afd` fallback (Node environment)
+ */
+export function resolveHookCommand(): string {
+  if (isCommandAvailable("afd")) {
+    return `afd ${DIAGNOSE_ARGS}`;
+  }
+  if (isCommandAvailable("bunx")) {
+    return `bunx afd ${DIAGNOSE_ARGS}`;
+  }
+  return `npx -y afd ${DIAGNOSE_ARGS}`;
+}
+
+/** Check if a command exists on the system PATH */
+function isCommandAvailable(cmd: string): boolean {
+  try {
+    const check = IS_WINDOWS ? `where ${cmd}` : `command -v ${cmd}`;
+    execSync(check, { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}

package/src/version.ts

@@ -0,0 +1,15 @@
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+
+let version = "0.0.0-unknown";
+try {
+  const raw = readFileSync(resolve(import.meta.dirname, "..", "package.json"), "utf-8");
+  const pkg = JSON.parse(raw);
+  if (typeof pkg.version === "string" && pkg.version) {
+    version = pkg.version;
+  }
+} catch {
+  // Bundled binary or missing package.json — fallback silently
+}
+
+export const APP_VERSION: string = version;

package/README.ko.md

@@ -1,306 +0,0 @@
-<p align="center">
-  <img src="https://capsule-render.vercel.app/api?type=soft&color=auto&height=200&section=header&text=afd&fontSize=90" alt="afd" />
-</p>
-
-<h3 align="center">Autonomous Flow Daemon (afd)</h3>
-<p align="center"><strong>AI가 스스로 고치는 개발 환경. 복구까지 단 0.2초.</strong></p>
-
-<p align="center">
-  <img src="demo.gif" width="850" alt="afd demo" style="border-radius: 12px; box-shadow: 0 20px 40px rgba(0,0,0,0.4);">
-  <br>
-  <br>
-  <b>🛡️ 불멸의 컨텍스트 흐름:</b> 
-  <em>"afd는 지연 시간이 거의 없는 즉각적인 복구를 통해, AI 개발 흐름이 끊기지 않도록 보호하고 토큰 비용을 혁신적으로 절감합니다."</em>
-</p>
-
-<p align="center">
-  <img src="https://img.shields.io/badge/version-1.1.0-blue?style=flat-square" alt="version" />
-  <a href="https://www.npmjs.com/package/autonomous-flow-daemon"><img src="https://img.shields.io/npm/v/autonomous-flow-daemon?style=flat-square&logo=npm&color=cb0000" alt="npm" /></a>
-  <img src="https://img.shields.io/badge/runtime-Bun-f472b6?style=flat-square&logo=bun" alt="Bun" />
-  <img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="MIT" />
-  <img src="https://img.shields.io/badge/built%20for-Claude%20Code-7c3aed?style=flat-square" alt="Claude Code" />
-</p>
-
-<p align="center">
-  <a href="README.md">English</a>
-</p>
-
----
-
-## 왜 afd인가?
-
-> [afd] 🛡️ AI가 '.claudeignore'를 삭제했습니다 | 🩹 184ms 만에 자가 복구 완료 | 컨텍스트 보존됨.
-
-당신은 지금 몰입의 정점에 있습니다. AI 에이전트가 실수로 설정 파일을 삭제하거나, 훅 파일을 망가뜨립니다. `afd` 없이는 작업을 멈추고, 원인을 진단하고, 직접 고쳐야 합니다: **30분이 날아갑니다**.
-
-`afd`가 있다면, 데몬이 10ms 만에 이상을 감지하고, 184ms 안에 복구를 완료합니다. **당신은 아무것도 몰랐습니다.**
-
-| 상황 | afd 없을 때 | afd 있을 때 |
-|:-----|:------------|:------------|
-| AI가 `.claudeignore` 삭제 | 30분 수동 복구 | **0.2초 자동 치유** |
-| 훅 파일 손상 | 훅 재주입, 세션 재시작 | **백그라운드 자동 복구** |
-| `git checkout`으로 파일 50개 동시 변경 | AI가 폭주 | **대규모 이벤트 억제기 작동** |
-| 신규 팀원, 환경 설정 없음 | 구전으로 전달 | **`afd sync`로 즉시 백신 접종** |
-
----
-
-## 🚀 제로-간섭 약속 (Zero-Interference Promise)
-
-`afd`는 개발 흐름을 방해하는 것이 아니라, 보호하기 위해 설계되었습니다.
-
-* **성능 저하 없음:** Bun 기반의 네이티브 백그라운드 데몬으로 실행되어, **CPU 점유율 0.1% 미만**, **메모리 약 40MB**만을 사용합니다.
-* **매끄러운 복구:** **밀리초 미만(Sub-millisecond)의 복구 속도**를 통해, Claude Code가 컨텍스트 오류를 인지하기도 전에 파일을 원래대로 되돌려 놓습니다.
-* **비침습적 설계:** `afd`는 OS 계층에서 파일 시스템 이벤트만 관찰합니다. Claude Code의 내부 실행이나 API 호출을 가로채거나 수정하지 않습니다.
-
----
-
-## ✨ 주요 기능 (v1.1.0)
-
-| 기능 | 설명 |
-|:-----|:-----|
-| **🛡️ S.E.A.M 자율 치유** | 파일 삭제를 감지하고 270ms 이내에 복구 — AI 에이전트가 눈치채기도 전에 |
-| **🔍 스마트 탐색** | `.claude/`, `.cursorrules`, `.mcp.json` 등 AI 설정 파일을 자동 감지 — 설정 필요 없음 |
-| **🏥 위트 있는 닥터** | 실시간 가치 추적: 절약한 토큰, 시간, 비용을 매 치유마다 위트 있게 알려줍니다 |
-| **🌐 자동 다국어** | 시스템 언어에 따라 한국어/영어를 자동 전환. 직접 설정도 가능: `afd lang ko` |
-| **🧬 더블탭 감지** | 실수와 의도를 구분 — 한 번 지우면 복구, 30초 내 다시 지우면 삭제를 존중 |
-| **💉 백신 네트워크** | `afd sync`로 학습된 항체를 팀 전체에 전파 |
-| **📊 홀로그램 추출** | AI 에이전트에게 80%+ 가벼운 파일 뼈대를 제공해 토큰 비용 절감 |
-
----
-
-## 🚀 명령어 한 줄로 끝나는 경험
-
-> **"더 이상의 설정 삽질은 없습니다. 완전한 방어 환경을 구축하세요."**
-
-```bash
-npx @dotoricode/afd start
-```
-
-로컬에 설치하여 사용하려면:
-
-```bash
-bun link && afd start
-```
-
-이게 전부입니다. 나머지는 `afd`가 알아서 처리합니다:
-
-- **자동 훅(Hook) 주입** — Claude Code의 `PreToolUse` 훅을 자동으로 설치합니다. 더 이상 `.json` 파일을 직접 수정하며 고생하지 마세요.
-- **초고속 실시간 감시** — `.claude/`, `CLAUDE.md`, `.cursorrules`, `.claudeignore`, `.gitignore` 핵심 파일을 10ms 단위로 모니터링합니다.
-- **배경 자율 치유** — 파일이 삭제되거나 손상되면 **S.E.A.M 사이클**이 조용히 복구합니다. 사용자가 눈치채기도 전에 모든 상황은 종료됩니다.
-
-```
-$ afd start
-  🛡️ 데몬 시작 (pid 4812, port 52413)
-  🛡️ 스마트 탐색 중: AI 컨텍스트 대상 7개 감시 시작
-  Targets: .claude/, CLAUDE.md, .cursorrules, .claudeignore, .gitignore, mcp-config.json, .mcp.json
-  ✅ .claude/hooks.json에 감시 훅 주입 완료
-```
-
-> `afd start`를 치고 나면 그냥 잊어버리세요. 그것이 우리가 추구하는 최고의 UX입니다.
-
----
-
-## 🧠 지능형 치유 엔진: S.E.A.M 사이클
-
-`afd`의 핵심 로직입니다. 모든 파일 변화는 다음의 4단계를 거쳐 즉시 정제됩니다:
-
-```mermaid
-graph LR
-    S["Sense<br/><i>변경 감지</i>"] --> E["Extract<br/><i>증상 분석</i>"]
-    E --> A["Adapt<br/><i>항체 선택</i>"]
-    A --> M["Mutate<br/><i>치유/복구</i>"]
-    M -->|"자가 학습"| S
-    style S fill:#3b82f6,color:#fff,stroke:none
-    style E fill:#f59e0b,color:#fff,stroke:none
-    style A fill:#10b981,color:#fff,stroke:none
-    style M fill:#ef4444,color:#fff,stroke:none
-```
-
-| 단계 | 주요 동작 | 처리 속도 |
-|:------|:-----|:-----|
-| **Sense** | Chokidar 와처가 파일의 생성, 변경, 삭제를 즉각 감지 | < 10ms |
-| **Extract** | 면역 엔진이 내장된 3단계 건강 검진 실행 (IMM-001..003) | < 5ms |
-| **Adapt** | SQLite(WAL 모드) DB에서 최적의 복구 항체(Antibody) 매칭 | < 1ms |
-| **Mutate** | RFC 6902 JSON-Patch 기술로 원본 파일을 완벽히 복원 | < 25ms |
-
-> **최종 성적표:** 파일 삭제 감지부터 복구 완료까지 **270ms 미만**.
-
-### 감시 대상 (Watch Targets)
-
-아래 파일들이 실시간 감시됩니다. 면역 파일(IMM-*)은 삭제 시 자동으로 복구됩니다:
-
-| 대상 | 유형 | 항체 | 자동 복구 |
-|:-----|:-----|:-----|:----------|
-| `.claude/` | 디렉토리 | IMM-002 (`hooks.json`) | ✅ |
-| `CLAUDE.md` | 파일 | IMM-003 | ✅ |
-| `.claudeignore` | 파일 | IMM-001 | ✅ |
-| `.cursorrules` | 파일 | — | 이벤트 로깅만 |
-| `.gitignore` | 파일 | — | 이벤트 로깅만 |
-| `mcp-config.json` | 파일 | — | 🔍 스마트 탐색 |
-| `.mcp.json` | 파일 | — | 🔍 스마트 탐색 |
-| `.ai/` | 디렉토리 | — | 🔍 스마트 탐색 |
-| `.windsurfrules` | 파일 | — | 🔍 스마트 탐색 |
-
-> 항체는 **데몬 시작 시 자동으로 학습**되며, **파일 변경 시마다 갱신**됩니다 — 복구 시 항상 최신 내용이 반영됩니다.
->
-> 🔍 **스마트 탐색**은 시작 시 12개 이상의 AI 설정 패턴을 0.1ms 미만으로 스캔하여, 발견된 파일을 자동으로 감시 목록에 추가합니다.
-
----
-
-## 🛠️ 명령어
-
-복잡한 건 빼고, 꼭 필요한 것만 담았습니다.
-
-| 명령어 | 역할 | 핵심 지능 |
-|:-------|:-----|:----------|
-| `afd start` | **시동** | 스마트 탐색 + 데몬 가동 + 자동 훅 주입 |
-| `afd fix` | **수술** | 현재 프로젝트 진단 및 새로운 항체 학습 |
-| `afd score` | **대시보드** | 다국어 건강 검진 리포트 & 가치 분석 |
-| `afd sync` | **전파** | 학습된 항체를 백신 파일로 추출 (팀 공유용) |
-| `afd lang` | **언어** | 표시 언어 전환 (`afd lang ko` / `afd lang en`) |
-| `afd stop` | **종료** | 근무 요약 리포트 + 안전한 종료 |
-
----
-
-## 📊 실시간 대시보드: `afd score`
-
-```
-┌──────────────────────────────────────────────┐
-│  afd score — 프로젝트 건강 검진              │
-├──────────────────────────────────────────────┤
-│  에코시스템   : Claude Code                  │
-├──────────────────────────────────────────────┤
-│  가동 시간    : 1h 23m                       │
-│  이벤트       : 156                          │
-│  감지된 파일  : 8                            │
-├──────────────────────────────────────────────┤
-│  면역 시스템                                 │
-│  ──────────────────────────────              │
-│  항체 수      : 7                            │
-│  방어 레벨    : 철통 방어                    │
-│  자동 치유    : 3건 백그라운드 치유됨        │
-├──────────────────────────────────────────────┤
-│  📈 전달된 가치                              │
-│  ──────────────────────────────              │
-│  절약한 토큰  : ~2.9K                        │
-│  아낀 시간    : ~40 min                      │
-│  절감 비용    : ~$0.01                       │
-├──────────────────────────────────────────────┤
-│  🗣️ 면역 체계 이상 무. 오늘도 한 건         │
-│     해결했습니다 💪                          │
-└──────────────────────────────────────────────┘
-```
-
-> `afd lang en` 을 실행하면 대시보드의 모든 레이블이 영어로 전환됩니다.
-
----
-
-## 💎 고도로 설계된 안전 장치
-
-### Double-Tap 휴리스틱 (의도와 실수의 구분)
-
-`afd`는 바보처럼 무조건 되살리지 않습니다. 사용자의 **진짜 의도**를 읽습니다:
-
-```bash
-$ rm .claudeignore      # 1차 삭제: "실수인가 보군." → 즉시 복구
-$ rm .claudeignore      # 30초 내 재삭제: "진짜 지우고 싶구나?"
-  🫡 [afd] 사용자 의도 확인. 항체 IMM-001 휴면 전환. 삭제를 존중합니다.
-```
-
-- **실수 방어:** 한 번의 삭제는 0.2초 만에 즉시 복구합니다.
-- **의도 존중:** 30초 내에 같은 파일을 또 지우면 사용자의 확고한 의지로 판단해 복구를 멈춥니다.
-- **Git 쇼크 방지:** `git checkout`처럼 수많은 파일이 한꺼번에 바뀌는 상황(1초 내 3개 이상)은 '대규모 이벤트'로 자동 인식하여 과도한 치유 동작을 멈춥니다.
-
-### 백신 네트워크 (팀 전파)
-
-나만 똑똑해지는 게 아닙니다. 내가 발견한 해결책을 팀원 모두에게 전파하세요:
-
-```bash
-afd sync
-# → .afd/global-vaccine-payload.json 생성
-```
-이 파일은 정제되어 있어 기밀 정보가 섞이지 않습니다. 다른 프로젝트에 넣기만 하면 `afd`가 해당 프로젝트의 면역력을 즉시 이식받습니다.
-
-### Hologram 추출 (토큰 다이어트)
-
-AI 에이전트가 파일 내용을 요구할 때, `afd`는 **뼈대만 남긴 초경량 요약본**을 제공합니다. 주석과 긴 함수 본문은 걷어내고 타입 정의와 구조만 전달하여 **토큰 비용을 80% 이상 절감**합니다.
-
----
-
-## 🔌 Plugin / MCP 설정
-
-`afd`를 **Model Context Protocol (MCP) 서버**로 등록하면 Claude Code가 시작될 때 데몬이 자동으로 실행됩니다.
-
-### 자동 설정 (권장)
-
-Claude Code MCP 설정(`~/.claude/mcp.json` 또는 프로젝트 `.mcp.json`)에 추가하세요:
-
-```json
-{
-  "mcpServers": {
-    "afd": {
-      "command": "bun",
-      "args": ["run", "src/cli.ts", "start"]
-    }
-  }
-}
-```
-
-### 수동 실행
-
-```bash
-afd start   # 백그라운드 데몬 시작 및 훅 자동 주입
-```
-
-등록 후 Claude Code 상태 표시줄에서 실시간으로 확인할 수 있습니다:
-
-```
-🛡️ afd: ON | 🩹 3 Healed | last: IMM-003
-```
-
----
-
-## 🛠️ 기술 스택
-
-| 계층 | 기술 | 선택 이유 |
-|:-----|:-----|:----------|
-| 런타임 | **Bun** | 네이티브 TypeScript, 초고속 SQLite, 단일 바이너리 |
-| 데이터베이스 | **Bun SQLite (WAL)** | 읽기 0.29ms, 쓰기 24ms, 크래시 안전 |
-| 파일 감시 | **Chokidar** | 크로스플랫폼, 실전 검증된 와처 |
-| 패칭 | **RFC 6902 JSON-Patch** | 결정론적이고 조합 가능한 파일 변이 |
-| CLI | **Commander.js** | 표준적이고 예측 가능한 커맨드 파싱 |
-| 다국어 | **자체 i18n 엔진** | 외부 의존성 없이 0.01ms로 언어 전환 |
-
----
-
-## 📦 설치 및 시작하기
-
-```bash
-# Bun 사용 권장
-bun install
-bun link
-afd start
-
-# 설치 없이 바로 실행하기 (npx)
-npx @dotoricode/afd start
-```
-
-### 환경 요구 사항
-- **Bun** >= 1.0
-- **OS**: Windows, macOS, Linux 지원
-- **호환 환경**: Claude Code, Cursor 등 (생태계 자동 감지)
-
----
-
-## 🛡️ 안도감을 주는 UX
-
-`afd`의 목표는 명확합니다.
-
-> **"설정 파일 하나 날아가서 30분을 허비하는 그런 날은 이제 끝났습니다."**
-
-당신은 코드에만 집중하세요. 프로젝트 환경의 건강은 `afd`가 24시간 백그라운드에서 지켜드립니다.
-
----
-
-## 라이선스
-MIT