autonomous-flow-daemon 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+All notable changes to **afd** are documented in this file.
+
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+Versioning follows [Semantic Versioning](https://semver.org/).
+
+---
+
+## [1.0.0] - 2026-03-31 — "The Immortal Flow"
+
+> [afd] 🛡️ AI agent deleted '.claudeignore' | 🩹 Self-healed in 184ms | Context preserved.
+
+**Zero-config immunity for your AI development flow.**
+
+### Phase 1–3: Core S.E.A.M Engine & Magic 5 Commands
+
+- Introduced the **S.E.A.M Cycle** (Scan → Evaluate → Act → Monitor) as the central execution loop
+- Implemented the **Magic 5 Commands**: `start`, `stop`, `score`, `fix`, `sync`
+- Built `src/core/db.ts`: WAL-mode SQLite for sub-100ms file event persistence
+- Built `src/core/hologram.ts`: AST-based skeleton extraction for token-efficient AI handoff
+- Built `src/core/immune.ts`: Immune tolerance heuristics — suppression logic for noisy events
+- Implemented `src/daemon/server.ts` and `src/daemon/client.ts`: Unix socket IPC for daemon ↔ CLI communication
+- Chokidar-backed file watcher with 100ms debounce in `src/daemon/server.ts`
+
+### Phase 4–5: Multilingual UI & Status Line Integration
+
+- Added bilingual terminal UI (EN/KO) with chalk-based color output
+- Integrated **Status Line** hook injection for Claude Code, Cursor, and Copilot adapters
+- Added adapter layer (`src/adapters/`) for ecosystem-specific configuration
+- Published `README.md` (English) and `README.ko.md` (Korean) with full documentation
+
+### Phase 6a–6b: Suppression Safety — Double-Tap & Mass-Event Logic
+
+- Added **Double-Tap suppression**: prevents re-triggering the same file within the cooldown window
+- Added **Mass-Event suppression**: drops bulk filesystem events (threshold: ≥ 5 files / 500ms) to prevent runaway AI calls
+- Added configurable `suppressionCooldownMs` and `massEventThreshold` / `massEventWindowMs`
+- Full E2E safety suite: 9 tests across suppression scenarios — all green
+- Published `docs/06-suppression-safety-audit.md` and `docs/05-release-audit.md`
+
+---
+
+## [0.1.0] - 2026-01-01 — Initial prototype
+
+- Project scaffold with Bun runtime
+- Basic CLI skeleton and daemon concept

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dotori
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ko.md

@@ -0,0 +1,249 @@
+<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="https://img.shields.io/badge/version-1.0.0-blue?style=flat-square" alt="version" />
+  <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`로 즉시 백신 접종** |
+
+---
+
+## 🚀 명령어 한 줄로 끝나는 경험
+
+> **"더 이상의 설정 삽질은 없습니다. 완전한 방어 환경을 구축하세요."**
+
+```bash
+npx @dotoricode/afd start
+```
+
+로컬에 설치하여 사용하려면:
+
+```bash
+bun link && afd start
+```
+
+이게 전부입니다. 나머지는 `afd`가 알아서 처리합니다:
+
+- **자동 훅(Hook) 주입** — Claude Code의 `PreToolUse` 훅을 자동으로 설치합니다. 더 이상 `.json` 파일을 직접 수정하며 고생하지 마세요.
+- **초고속 실시간 감시** — `.claude/`, `CLAUDE.md`, `.cursorrules` 등 핵심 파일을 10ms 단위로 모니터링합니다.
+- **배경 자율 치유** — 파일이 삭제되거나 손상되면 **S.E.A.M 사이클**이 조용히 복구합니다. 사용자가 눈치채기도 전에 모든 상황은 종료됩니다.
+
+```
+$ afd start
+  🛡️ afd 데몬 시작 (pid 4812, port 52413)
+  ✅ .claude/hooks.json에 감시 훅 주입 완료
+  👀 감시 중: .claude/, CLAUDE.md, .cursorrules
+  ✨ 준비되었습니다.
+```
+
+> `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 미만**.
+
+---
+
+## 🛠️ Magic 5 — 핵심 명령어
+
+복잡한 건 빼고, 꼭 필요한 5가지만 담았습니다.
+
+| 명령어 | 역할 | 핵심 지능 |
+|:-------|:-----|:----------|
+| `afd start` | **시동** | 백그라운드 데몬 가동 및 자동 훅 주입 |
+| `afd fix` | **수술** | 현재 프로젝트 진단 및 새로운 항체 학습 |
+| `afd score` | **대시보드** | 프로젝트 건강 점수 및 치유 통계 확인 |
+| `afd sync` | **전파** | 학습된 항체를 백신 파일로 추출 (팀 공유용) |
+| `afd stop` | **종료** | 데몬을 안전하게 끄고 프로세스 정리 |
+
+---
+
+## 📊 실시간 대시보드: `afd score`
+
+```
+┌──────────────────────────────────────────────┐
+│  afd score — 프로젝트 건강 검진 리포트            │
+├──────────────────────────────────────────────┤
+│  에코시스템    : Claude Code                  │
+├──────────────────────────────────────────────┤
+│  가동 시간     : 1시간 23분                    │
+│  감지된 이벤트 : 156건                         │
+│  보호 중인 파일: 8개                          │
+├──────────────────────────────────────────────┤
+│  면역 시스템 상태 (Immune System)               │
+│  ──────────────────────────────              │
+│  보유 항체     : 7개                          │
+│  방어 레벨     : 철통 보안 (Fortified)          │
+│  자동 치유     : 3건 (백그라운드 처리)           │
+│  최근 치유     : IMM-003 (.claudeignore 복구)   │
+├──────────────────────────────────────────────┤
+│  억제 안전장치 (Safety)                        │
+│  ──────────────────────────────              │
+│  대규모 이벤트 무시: 2건 (git checkout 등)      │
+│  의도적 삭제 허용  : 0건 (Dormant 전환)         │
+├──────────────────────────────────────────────┤
+│  Hologram 절약   : 토큰 소모량 84% 감소         │
+└──────────────────────────────────────────────┘
+```
+
+---
+
+## 💎 고도로 설계된 안전 장치
+
+### Double-Tap 휴리스틱 (의도와 실수의 구분)
+
+`afd`는 바보처럼 무조건 되살리지 않습니다. 사용자의 **진짜 의도**를 읽습니다:
+
+```bash
+$rm .claudeignore      # 1차 삭제: "실수인가 보군." -> 즉시 복구$ rm .claudeignore      # 60초 내 재삭제: "진짜 지우고 싶구나?" 
+  🛡️ [afd] 사용자 의도 확인. 항체 IMM-001 휴면 전환. 삭제를 존중합니다.
+```
+
+- **실수 방어:** 한 번의 삭제는 0.2초 만에 즉시 복구합니다.
+- **의도 존중:** 1분 내에 같은 파일을 또 지우면 사용자의 확고한 의지로 판단해 복구를 멈춥니다.
+- **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
+cp mcp-config.json .mcp.json
+```
+
+### 수동 실행
+
+```bash
+afd start   # 백그라운드 데몬 시작 및 훅 자동 주입
+```
+
+등록 후 Claude Code 상태 표시줄에서 실시간으로 확인할 수 있습니다:
+
+```
+🛡️ afd: ON | 🩹 3 Healed | last: IMM-003
+```
+
+---
+
+## 🛠️ 기술 스택
+
+- **Runtime**: **Bun** — 초고속 실행 속도와 네이티브 SQLite 지원.
+- **Database**: **SQLite (WAL)** — 읽기 0.29ms의 압도적 성능과 크래시 안전성.
+- **Patching**: **RFC 6902 JSON-Patch** — 파일의 미세한 변화를 가장 정교하게 복원하는 기술.
+
+---
+
+## 📦 설치 및 시작하기
+
+```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

package/README.md

@@ -0,0 +1,281 @@
+<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">The Autonomous Flow Daemon</h3>
+<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" />
+  <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.ko.md">한국어</a>
+</p>
+
+---
+
+## Why afd?
+
+> [afd] 🛡️ AI agent deleted '.claudeignore' | 🩹 Self-healed in 184ms | Context preserved.
+
+You're deep in flow. Your AI agent makes a wrong move — deletes a config, corrupts a hook file, wipes a `.cursorrules`. Without `afd`, you stop everything, diagnose the breakage, manually fix it: **30 minutes gone**.
+
+With `afd`, the daemon noticed in 10ms, restored the file in 184ms, and logged it silently. **You never even saw it happen.**
+
+| Situation | Without afd | With afd |
+|:----------|:------------|:---------|
+| AI deletes `.claudeignore` | 30 min manual fix | **0.2s auto-heal** |
+| Hook file corrupted | Re-inject hooks, restart session | **Silent background repair** |
+| `git checkout` triggers 50 file events | AI goes haywire | **Mass-event suppressor kicks in** |
+| New team member, missing context | Tribal knowledge required | **`afd sync` vaccines the setup** |
+
+---
+
+## The One-Command Experience
+
+> **Zero-Config. Total Protection.**
+
+```bash
+npx @dotoricode/afd start
+```
+
+Or install locally:
+
+```bash
+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`.
+- **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)
+  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.
+
+---
+
+## The S.E.A.M Cycle
+
+The intelligence inside `afd`. Every file event flows through four stages:
+
+```mermaid
+graph LR
+    S["Sense<br/><i>File Change Detected</i>"] --> E["Extract<br/><i>Detect Symptom</i>"]
+    E --> A["Adapt<br/><i>Select Antibody</i>"]
+    A --> M["Mutate<br/><i>Apply JSON-Patch</i>"]
+    M -->|"Learn"| 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
+```
+
+| Stage | What Happens | Speed |
+|:------|:-------------|:------|
+| **Sense** | Chokidar watcher detects `add`, `change`, `unlink` events | < 10ms |
+| **Extract** | Immune engine runs 3 built-in health checks (IMM-001..003) | < 5ms |
+| **Adapt** | Matches symptom to stored antibody in SQLite (WAL mode) | < 1ms |
+| **Mutate** | Applies RFC 6902 JSON-Patch to restore the file | < 25ms |
+
+> Full cycle: **< 270ms** from file deletion to full recovery.
+
+---
+
+## The Magic 5 Commands
+
+Everything you need. Nothing you don't.
+
+| Command | Essence | Intelligence Inside |
+|:--------|:--------|:--------------------|
+| `afd start` | **Ignite** | Daemon spawn + Hook injection |
+| `afd fix` | **Diagnose** | Symptom detection & Antibody learning |
+| `afd score` | **Vitals** | Health dashboard & Auto-heal stats |
+| `afd sync` | **Federate** | Vaccine payload export for cross-project immunity |
+| `afd stop` | **Quarantine** | Graceful shutdown & cleanup |
+
+### 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 sync       # Export antibodies to .afd/global-vaccine-payload.json
+afd stop       # Graceful shutdown
+```
+
+---
+
+## Dashboard: `afd score`
+
+```
+┌──────────────────────────────────────────────┐
+│  afd score — Daemon Diagnostics              │
+├──────────────────────────────────────────────┤
+│  Ecosystem    : Claude Code                  │
+├──────────────────────────────────────────────┤
+│  Uptime       : 1h 23m                       │
+│  Events       : 156                          │
+│  Files Found  : 8                            │
+├──────────────────────────────────────────────┤
+│  Immune System                               │
+│  ──────────────────────────────              │
+│  Antibodies   : 7                            │
+│  Level        : Fortified                    │
+│  Auto-healed  : 3 background events         │
+│  Last heal    : IMM-003 (12m ago)            │
+├──────────────────────────────────────────────┤
+│  Suppression Safety                          │
+│  ──────────────────────────────              │
+│  Mass events skipped  : 2                    │
+│  Dormant transitions  : 0                    │
+│  Active first-taps    : 1                    │
+├──────────────────────────────────────────────┤
+│  Hologram Budget : 84% token savings         │
+└──────────────────────────────────────────────┘
+```
+
+---
+
+## Advanced Intelligence
+
+### Double-Tap Heuristic (Immune Tolerance)
+
+`afd` distinguishes **accidents** from **intent**:
+
+```
+$ 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.
+```
+
+| 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 |
+| 3+ deletes in 1s (git checkout) | Mass-event detected, all suppression paused |
+
+### Vaccine Network (Team Federation)
+
+Export learned antibodies for your entire team:
+
+```bash
+afd sync
+# → .afd/global-vaccine-payload.json
+```
+
+The payload is sanitized (no absolute paths, no secrets) and portable. Drop it into any project, and `afd` inherits the immunity.
+
+### Hologram Extraction
+
+When AI agents request file context, `afd` serves **token-efficient skeletons** — stripping comments and function bodies while preserving the full type signature:
+
+```
+Original:  2,450 chars → Hologram: 380 chars (84% savings)
+```
+
+This keeps your AI agent's context window lean without losing structural understanding.
+
+---
+
+## Status Line
+
+Real-time daemon status in Claude Code's status bar:
+
+```
+🛡️ afd: OFF                              # Daemon not running
+🛡️ afd: ON                               # Running, no heals
+🛡️ afd: ON 🩹1                            # 1 auto-heal event
+🛡️ afd: ON | 🩹 3 Healed | last: IMM-003  # Detailed view
+```
+
+---
+
+## Plugin / MCP Setup
+
+`afd` can be registered as a **Model Context Protocol (MCP) server** inside Claude Code, allowing the daemon to start automatically when Claude Code launches.
+
+### Automatic (recommended)
+
+Add to your Claude Code MCP config (`~/.claude/mcp.json` or project-level `.mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "afd": {
+      "command": "bun",
+      "args": ["run", "src/cli.ts", "start"]
+    }
+  }
+}
+```
+
+Or copy the included manifest directly:
+
+```bash
+cp mcp-config.json .mcp.json
+```
+
+### Manual
+
+```bash
+afd start   # starts daemon in background, injects hooks
+```
+
+Once registered, Claude Code will display the live status line:
+
+```
+🛡️ afd: ON | 🩹 3 Healed | last: IMM-003
+```
+
+---
+
+## Tech Stack
+
+| Layer | Technology | Why |
+|:------|:-----------|:----|
+| Runtime | **Bun** | Native TypeScript, fast SQLite, single binary |
+| Database | **Bun SQLite (WAL)** | 0.29ms reads, 24ms writes, crash-safe |
+| 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 |
+
+---
+
+## Installation
+
+```bash
+# With Bun (recommended)
+bun install
+bun link
+afd start
+
+# With npx (no install)
+npx @dotoricode/afd start
+```
+
+### Requirements
+
+- **Bun** >= 1.0
+- **OS**: Windows, macOS, Linux
+- **Target**: Claude Code, Cursor (ecosystem auto-detected)
+
+---
+
+## License
+
+MIT
+

package/mcp-config.json

@@ -0,0 +1,10 @@
+{
+  "mcpServers": {
+    "afd": {
+      "command": "bun",
+      "args": ["run", "src/cli.ts", "start"],
+      "description": "Autonomous Flow Daemon — self-healing AI development environment guardian. Monitors critical config files and auto-restores them within 270ms.",
+      "env": {}
+    }
+  }
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "autonomous-flow-daemon",
+  "version": "1.0.0",
+  "description": "Zero-config immunity for AI coding workflows. Self-heals broken configs in < 270ms.",
+  "type": "module",
+  "bin": {
+    "afd": "./src/cli.ts"
+  },
+  "main": "./src/cli.ts",
+  "files": [
+    "src/**/*.ts",
+    "mcp-config.json",
+    "README.md",
+    "README.ko.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "claude-code",
+    "self-healing",
+    "mcp",
+    "bun",
+    "ai-workflow",
+    "daemon",
+    "autonomous",
+    "dev-tools"
+  ],
+  "scripts": {
+    "start": "bun run src/cli.ts start",
+    "dev": "bun run src/cli.ts",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "chokidar": "^4.0.3",
+    "commander": "^13.1.0",
+    "typescript": "^6.0.2"
+  },
+  "license": "MIT"
+}