autonomous-flow-daemon 1.0.0 → 1.1.0

package/README.ko.md

@@ -6,7 +6,16 @@
 <p align="center"><strong>AI가 스스로 고치는 개발 환경. 복구까지 단 0.2초.</strong></p>
 
 <p align="center">
-  <img src="https://img.shields.io/badge/version-1.0.0-blue?style=flat-square" alt="version" />
+  <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" />
@@ -35,6 +44,30 @@
 
 ---
 
+## 🚀 제로-간섭 약속 (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%+ 가벼운 파일 뼈대를 제공해 토큰 비용 절감 |
+
+---
+
 ## 🚀 명령어 한 줄로 끝나는 경험
 
 > **"더 이상의 설정 삽질은 없습니다. 완전한 방어 환경을 구축하세요."**
@@ -52,15 +85,15 @@ bun link && afd start
 이게 전부입니다. 나머지는 `afd`가 알아서 처리합니다:
 
 - **자동 훅(Hook) 주입** — Claude Code의 `PreToolUse` 훅을 자동으로 설치합니다. 더 이상 `.json` 파일을 직접 수정하며 고생하지 마세요.
-- **초고속 실시간 감시** — `.claude/`, `CLAUDE.md`, `.cursorrules` 등 핵심 파일을 10ms 단위로 모니터링합니다.
+- **초고속 실시간 감시** — `.claude/`, `CLAUDE.md`, `.cursorrules`, `.claudeignore`, `.gitignore` 핵심 파일을 10ms 단위로 모니터링합니다.
 - **배경 자율 치유** — 파일이 삭제되거나 손상되면 **S.E.A.M 사이클**이 조용히 복구합니다. 사용자가 눈치채기도 전에 모든 상황은 종료됩니다.
 
 ```
 $ afd start
-  🛡️ afd 데몬 시작 (pid 4812, port 52413)
+  🛡️ 데몬 시작 (pid 4812, port 52413)
+  🛡️ 스마트 탐색 중: AI 컨텍스트 대상 7개 감시 시작
+  Targets: .claude/, CLAUDE.md, .cursorrules, .claudeignore, .gitignore, mcp-config.json, .mcp.json
   ✅ .claude/hooks.json에 감시 훅 주입 완료
-  👀 감시 중: .claude/, CLAUDE.md, .cursorrules
-  ✨ 준비되었습니다.
 ```
 
 > `afd start`를 치고 나면 그냥 잊어버리세요. 그것이 우리가 추구하는 최고의 UX입니다.
@@ -92,19 +125,40 @@ graph LR
 
 > **최종 성적표:** 파일 삭제 감지부터 복구 완료까지 **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 미만으로 스캔하여, 발견된 파일을 자동으로 감시 목록에 추가합니다.
+
 ---
 
-## 🛠️ Magic 5 — 핵심 명령어
+## 🛠️ 명령어
 
-복잡한 건 빼고, 꼭 필요한 5가지만 담았습니다.
+복잡한 건 빼고, 꼭 필요한 것만 담았습니다.
 
 | 명령어 | 역할 | 핵심 지능 |
 |:-------|:-----|:----------|
-| `afd start` | **시동** | 백그라운드 데몬 가동 및 자동 훅 주입 |
+| `afd start` | **시동** | 스마트 탐색 + 데몬 가동 + 자동 훅 주입 |
 | `afd fix` | **수술** | 현재 프로젝트 진단 및 새로운 항체 학습 |
-| `afd score` | **대시보드** | 프로젝트 건강 점수 및 치유 통계 확인 |
+| `afd score` | **대시보드** | 다국어 건강 검진 리포트 & 가치 분석 |
 | `afd sync` | **전파** | 학습된 항체를 백신 파일로 추출 (팀 공유용) |
-| `afd stop` | **종료** | 데몬을 안전하게 끄고 프로세스 정리 |
+| `afd lang` | **언어** | 표시 언어 전환 (`afd lang ko` / `afd lang en`) |
+| `afd stop` | **종료** | 근무 요약 리포트 + 안전한 종료 |
 
 ---
 
@@ -112,30 +166,33 @@ graph LR
 
 ```
 ┌──────────────────────────────────────────────┐
-│  afd score — 프로젝트 건강 검진 리포트            │
+│  afd score — 프로젝트 건강 검진              │
 ├──────────────────────────────────────────────┤
-│  에코시스템    : Claude Code                  │
+│  에코시스템   : Claude Code                  │
 ├──────────────────────────────────────────────┤
-│  가동 시간     : 1시간 23분                    │
-│  감지된 이벤트 : 156건                         │
-│  보호 중인 파일: 8개                          │
+│  가동 시간    : 1h 23m                       │
+│  이벤트       : 156                          │
+│  감지된 파일  : 8                            │
 ├──────────────────────────────────────────────┤
-│  면역 시스템 상태 (Immune System)               │
+│  면역 시스템                                 │
 │  ──────────────────────────────              │
-│  보유 항체     : 7개                          │
-│  방어 레벨     : 철통 보안 (Fortified)          │
-│  자동 치유     : 3건 (백그라운드 처리)           │
-│  최근 치유     : IMM-003 (.claudeignore 복구)   │
+│  항체 수      : 7                            │
+│  방어 레벨    : 철통 방어                    │
+│  자동 치유    : 3건 백그라운드 치유됨        │
 ├──────────────────────────────────────────────┤
-│  억제 안전장치 (Safety)                        │
+│  📈 전달된 가치                              │
 │  ──────────────────────────────              │
-│  대규모 이벤트 무시: 2건 (git checkout 등)      │
-│  의도적 삭제 허용  : 0건 (Dormant 전환)         │
+│  절약한 토큰  : ~2.9K                        │
+│  아낀 시간    : ~40 min                      │
+│  절감 비용    : ~$0.01                       │
 ├──────────────────────────────────────────────┤
-│  Hologram 절약   : 토큰 소모량 84% 감소         │
+│  🗣️ 면역 체계 이상 무. 오늘도 한 건         │
+│     해결했습니다 💪                          │
 └──────────────────────────────────────────────┘
 ```
 
+> `afd lang en` 을 실행하면 대시보드의 모든 레이블이 영어로 전환됩니다.
+
 ---
 
 ## 💎 고도로 설계된 안전 장치
@@ -145,12 +202,13 @@ graph LR
 `afd`는 바보처럼 무조건 되살리지 않습니다. 사용자의 **진짜 의도**를 읽습니다:
 
 ```bash
-$rm .claudeignore      # 1차 삭제: "실수인가 보군." -> 즉시 복구$ rm .claudeignore      # 60초 내 재삭제: "진짜 지우고 싶구나?" 
-  🛡️ [afd] 사용자 의도 확인. 항체 IMM-001 휴면 전환. 삭제를 존중합니다.
+$ rm .claudeignore      # 1차 삭제: "실수인가 보군." → 즉시 복구
+$ rm .claudeignore      # 30초 내 재삭제: "진짜 지우고 싶구나?"
+  🫡 [afd] 사용자 의도 확인. 항체 IMM-001 휴면 전환. 삭제를 존중합니다.
 ```
 
 - **실수 방어:** 한 번의 삭제는 0.2초 만에 즉시 복구합니다.
-- **의도 존중:** 1분 내에 같은 파일을 또 지우면 사용자의 확고한 의지로 판단해 복구를 멈춥니다.
+- **의도 존중:** 30초 내에 같은 파일을 또 지우면 사용자의 확고한 의지로 판단해 복구를 멈춥니다.
 - **Git 쇼크 방지:** `git checkout`처럼 수많은 파일이 한꺼번에 바뀌는 상황(1초 내 3개 이상)은 '대규모 이벤트'로 자동 인식하여 과도한 치유 동작을 멈춥니다.
 
 ### 백신 네트워크 (팀 전파)
@@ -188,12 +246,6 @@ Claude Code MCP 설정(`~/.claude/mcp.json` 또는 프로젝트 `.mcp.json`)에
 }
 ```
 
-또는 포함된 매니페스트를 바로 복사하세요:
-
-```bash
-cp mcp-config.json .mcp.json
-```
-
 ### 수동 실행
 
 ```bash
@@ -210,9 +262,14 @@ afd start   # 백그라운드 데몬 시작 및 훅 자동 주입
 
 ## 🛠️ 기술 스택
 
-- **Runtime**: **Bun** — 초고속 실행 속도와 네이티브 SQLite 지원.
-- **Database**: **SQLite (WAL)** — 읽기 0.29ms의 압도적 성능과 크래시 안전성.
-- **Patching**: **RFC 6902 JSON-Patch** — 파일의 미세한 변화를 가장 정교하게 복원하는 기술.
+| 계층 | 기술 | 선택 이유 |
+|:-----|:-----|:----------|
+| 런타임 | **Bun** | 네이티브 TypeScript, 초고속 SQLite, 단일 바이너리 |
+| 데이터베이스 | **Bun SQLite (WAL)** | 읽기 0.29ms, 쓰기 24ms, 크래시 안전 |
+| 파일 감시 | **Chokidar** | 크로스플랫폼, 실전 검증된 와처 |
+| 패칭 | **RFC 6902 JSON-Patch** | 결정론적이고 조합 가능한 파일 변이 |
+| CLI | **Commander.js** | 표준적이고 예측 가능한 커맨드 파싱 |
+| 다국어 | **자체 i18n 엔진** | 외부 의존성 없이 0.01ms로 언어 전환 |
 
 ---
 

package/README.md

@@ -6,7 +6,20 @@
 <p align="center"><strong>Self-healing AI development environments in < 270ms.</strong></p>
 
 <p align="center">
-  <img src="https://img.shields.io/badge/version-1.0.0-blue?style=flat-square" alt="version" />
+  <a href="https://github.com/dotoricode/autonomous-flow-daemon">
+    <img src="demo.gif" width="850" alt="afd demo" style="border-radius: 12px; box-shadow: 0 20px 40px rgba(0,0,0,0.4);">
+  </a>
+  <br>
+  <br>
+  <b>🛡️ Immortal Context Flow:</b> 
+  <em>"afd restores critical config files with <b>near-zero latency</b>, ensuring your AI workflow remains unbroken and cost-efficient."</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" />
@@ -35,6 +48,30 @@ With `afd`, the daemon noticed in 10ms, restored the file in 184ms, and logged i
 
 ---
 
+## 🚀 Zero-Interference Promise
+
+We built `afd` to protect your flow, not to slow it down.
+
+* **No Performance Hit:** Running as a native background daemon via Bun, `afd` consumes **< 0.1% CPU** and **~40MB RAM**.
+* **Seamless Recovery:** With **sub-millisecond healing**, files are restored before Claude Code can even register a missing context error.
+* **Non-Invasive:** `afd` observes file system events from the OS layer. It never intercepts or modifies Claude Code's internal execution or API calls.
+
+---
+
+## ✨ Key Features (v1.1.0)
+
+| Feature | What it does |
+|:--------|:-------------|
+| **🛡️ S.E.A.M Auto-Heal** | Detects file deletion and restores it in < 270ms — before your AI agent notices |
+| **🔍 Smart Discovery** | Automatically scans for AI-context files (`.claude/`, `.cursorrules`, `.mcp.json`, etc.) — zero config required |
+| **🏥 Boastful Doctor** | Real-time value tracking: saved tokens, time, and cost — with witty feedback after every heal |
+| **🌐 Auto-Localization** | Seamlessly switches between Korean and English based on your system locale. Or set it: `afd lang ko` |
+| **🧬 Double-Tap Heuristic** | Distinguishes accidents from intent — delete once, afd heals it; delete again within 30s, afd respects your decision |
+| **💉 Vaccine Network** | Export learned antibodies via `afd sync` for cross-project, cross-team immunity |
+| **📊 Hologram Extraction** | Serves 80%+ lighter file skeletons to AI agents, slashing token costs |
+
+---
+
 ## The One-Command Experience
 
 > **Zero-Config. Total Protection.**
@@ -52,15 +89,15 @@ bun link && afd start
 That's it. One command. `afd` takes over from here:
 
 - **Auto-Injection** — Installs `PreToolUse` hooks into Claude Code silently. No manual config editing.
-- **Sense (Watcher)** — 10ms real-time monitoring of critical configs: `.claude/`, `CLAUDE.md`, `.cursorrules`.
+- **Sense (Watcher)** — 10ms real-time monitoring of critical configs: `.claude/`, `CLAUDE.md`, `.cursorrules`, `.claudeignore`, `.gitignore`.
 - **Auto-Heal** — Silent background repair of missing or corrupted files using the **S.E.A.M cycle**. You won't even notice it happened.
 
 ```
 $ afd start
-  afd daemon started (pid 4812, port 52413)
+  🛡️ Daemon started (pid 4812, port 52413)
+  🛡️ Smart Discovery: Watching 7 AI-context targets
+  Targets: .claude/, CLAUDE.md, .cursorrules, .claudeignore, .gitignore, mcp-config.json, .mcp.json
   Hook injected into .claude/hooks.json
-  Watching: .claude/, CLAUDE.md, .cursorrules
-  Ready.
 ```
 
 > You type `afd start`. Then you forget about it. That's the entire UX.
@@ -92,28 +129,50 @@ graph LR
 
 > Full cycle: **< 270ms** from file deletion to full recovery.
 
+### Watch Targets
+
+These files are monitored in real-time. Immune files (IMM-*) are automatically restored on deletion:
+
+| Target | Type | Antibody | Auto-Restore |
+|:-------|:-----|:---------|:-------------|
+| `.claude/` | Directory | IMM-002 (`hooks.json`) | ✅ |
+| `CLAUDE.md` | File | IMM-003 | ✅ |
+| `.claudeignore` | File | IMM-001 | ✅ |
+| `.cursorrules` | File | — | Event logging only |
+| `.gitignore` | File | — | Event logging only |
+| `mcp-config.json` | File | — | 🔍 Smart Discovery |
+| `.mcp.json` | File | — | 🔍 Smart Discovery |
+| `.ai/` | Directory | — | 🔍 Smart Discovery |
+| `.windsurfrules` | File | — | 🔍 Smart Discovery |
+
+> Antibodies are **auto-seeded on startup** with each file's current content, and **refreshed on every change** — so restores always reflect the latest version.
+>
+> 🔍 **Smart Discovery** scans for 12+ known AI-config patterns at startup (< 0.1ms) and adds any found files to the active watch list automatically.
+
 ---
 
-## The Magic 5 Commands
+## Commands
 
 Everything you need. Nothing you don't.
 
 | Command | Essence | Intelligence Inside |
 |:--------|:--------|:--------------------|
-| `afd start` | **Ignite** | Daemon spawn + Hook injection |
+| `afd start` | **Ignite** | Daemon spawn + Smart Discovery + Hook injection |
 | `afd fix` | **Diagnose** | Symptom detection & Antibody learning |
-| `afd score` | **Vitals** | Health dashboard & Auto-heal stats |
+| `afd score` | **Vitals** | Localized health dashboard & Value metrics |
 | `afd sync` | **Federate** | Vaccine payload export for cross-project immunity |
-| `afd stop` | **Quarantine** | Graceful shutdown & cleanup |
+| `afd lang` | **Localize** | Switch display language (`afd lang ko` / `afd lang en`) |
+| `afd stop` | **Quarantine** | Shift summary & Graceful shutdown |
 
 ### Quick Reference
 
 ```bash
 afd start      # Start daemon, inject hooks, begin watching
 afd fix        # Scan for issues, auto-patch, learn antibodies
-afd score      # Full diagnostic dashboard
+afd score      # Full diagnostic dashboard (localized)
 afd sync       # Export antibodies to .afd/global-vaccine-payload.json
-afd stop       # Graceful shutdown
+afd lang ko    # Switch to Korean / afd lang en for English
+afd stop       # Shift summary + graceful shutdown
 ```
 
 ---
@@ -134,19 +193,21 @@ afd stop       # Graceful shutdown
 │  ──────────────────────────────              │
 │  Antibodies   : 7                            │
 │  Level        : Fortified                    │
-│  Auto-healed  : 3 background events         │
-│  Last heal    : IMM-003 (12m ago)            │
+│  Auto-healed  : 3 background events          │
 ├──────────────────────────────────────────────┤
-│  Suppression Safety                          │
+│  📈 Value Delivered                          │
 │  ──────────────────────────────              │
-│  Mass events skipped  : 2                    │
-│  Dormant transitions  : 0                    │
-│  Active first-taps    : 1                    │
+│  Tokens saved : ~2.9K                        │
+│  Time saved   : ~40 min                      │
+│  Cost saved   : ~$0.01                       │
 ├──────────────────────────────────────────────┤
-│  Hologram Budget : 84% token savings         │
+│  🗣️ The immune system holds. Another day,   │
+│     another heal. 💪                         │
 └──────────────────────────────────────────────┘
 ```
 
+> The dashboard is fully localized. Run `afd lang ko` and every label switches to Korean.
+
 ---
 
 ## Advanced Intelligence
@@ -157,15 +218,15 @@ afd stop       # Graceful shutdown
 
 ```
 $ rm .claudeignore            # First tap → afd heals it silently
-$ rm .claudeignore            # Second tap within 60s → "You meant it."
-  [afd] Antibody IMM-001 set to dormant. Delete honored.
+$ rm .claudeignore            # Second tap within 30s → "You meant it."
+  [afd] 🫡 Antibody IMM-001 retired. Double-tap detected. Standing down.
 ```
 
 | Scenario | Response |
 |:---------|:---------|
 | Single delete (accident) | Auto-heal + record first tap |
-| Re-delete within 60s (intent) | Antibody goes dormant, deletion respected |
-| Re-delete after 60s | Fresh first tap, heals again |
+| Re-delete within 30s (intent) | Antibody goes dormant, deletion respected |
+| Re-delete after 30s | Fresh first tap, heals again |
 | 3+ deletes in 1s (git checkout) | Mass-event detected, all suppression paused |
 
 ### Vaccine Network (Team Federation)
@@ -223,12 +284,6 @@ Add to your Claude Code MCP config (`~/.claude/mcp.json` or project-level `.mcp.
 }
 ```
 
-Or copy the included manifest directly:
-
-```bash
-cp mcp-config.json .mcp.json
-```
-
 ### Manual
 
 ```bash
@@ -252,6 +307,7 @@ Once registered, Claude Code will display the live status line:
 | Watching | **Chokidar** | Cross-platform, battle-tested file watcher |
 | Patching | **RFC 6902 JSON-Patch** | Deterministic, composable file mutations |
 | CLI | **Commander.js** | Standard, zero-surprise command parsing |
+| i18n | **Built-in engine** | Zero-dependency locale switching in 0.01ms |
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autonomous-flow-daemon",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Zero-config immunity for AI coding workflows. Self-heals broken configs in < 270ms.",
   "type": "module",
   "bin": {

package/src/adapters/index.ts

@@ -1,5 +1,6 @@
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
 import { join, dirname } from "path";
+import { resolveHookCommand } from "../platform";
 
 export interface HarnessSchema {
   configFiles: string[];
@@ -48,7 +49,7 @@ export const ClaudeCodeAdapter: EcosystemAdapter = {
   },
   injectHooks(cwd: string): { injected: boolean; message: string } {
     const hooksPath = join(cwd, ".claude", "hooks.json");
-    const hookCommand = "bun run " + join(cwd, "src", "cli.ts").replace(/\\/g, "/") + " diagnose --format a2a --auto-heal";
+    const hookCommand = resolveHookCommand();
 
     const newHook: HookEntry = {
       id: AFD_HOOK_MARKER,

package/src/cli.ts

@@ -6,17 +6,19 @@ import { scoreCommand } from "./commands/score";
 import { fixCommand } from "./commands/fix";
 import { syncCommand } from "./commands/sync";
 import { diagnoseCommand } from "./commands/diagnose";
+import { langCommand } from "./commands/lang";
 
 const program = new Command();
 
 program
   .name("afd")
   .description("Autonomous Flow Daemon - The Immune System for AI Workflows")
-  .version("1.0.0");
+  .version("1.1.0");
 
 program
   .command("start")
   .description("Start the afd daemon (background file watcher)")
+  .option("--mcp", "Run in MCP stdio mode (for Claude Code tool integration)")
   .action(startCommand);
 
 program
@@ -46,4 +48,10 @@ program
   .option("--auto-heal", "Auto-apply patches for known antibodies")
   .action(diagnoseCommand);
 
+program
+  .command("lang [language]")
+  .description("Show or change display language (en, ko)")
+  .option("--list", "Show all supported languages")
+  .action(langCommand);
+
 program.parse();

package/src/commands/lang.ts

@@ -0,0 +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() }));
+}