autonomous-flow-daemon 1.1.0 → 1.9.0

package/README.md

@@ -1,337 +1,282 @@
-<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">
-  <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" />
-</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** |
-
----
-
-## 🚀 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.**
-
-```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`, `.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
-  🛡️ 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
-```
-
-> 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.
-
-### 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.
-
----
-
-## Commands
-
-Everything you need. Nothing you don't.
-
-| Command | Essence | Intelligence Inside |
-|:--------|:--------|:--------------------|
-| `afd start` | **Ignite** | Daemon spawn + Smart Discovery + Hook injection |
-| `afd fix` | **Diagnose** | Symptom detection & Antibody learning |
-| `afd score` | **Vitals** | Localized health dashboard & Value metrics |
-| `afd sync` | **Federate** | Vaccine payload export for cross-project immunity |
-| `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 (localized)
-afd sync       # Export antibodies to .afd/global-vaccine-payload.json
-afd lang ko    # Switch to Korean / afd lang en for English
-afd stop       # Shift summary + 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          │
-├──────────────────────────────────────────────┤
-│  📈 Value Delivered                          │
-│  ──────────────────────────────              │
-│  Tokens saved : ~2.9K                        │
-│  Time saved   : ~40 min                      │
-│  Cost saved   : ~$0.01                       │
-├──────────────────────────────────────────────┤
-│  🗣️ 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
-
-### Double-Tap Heuristic (Immune Tolerance)
-
-`afd` distinguishes **accidents** from **intent**:
-
-```
-$ rm .claudeignore            # First tap → afd heals it silently
-$ 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 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)
-
-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"]
-    }
-  }
-}
-```
-
-### 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 |
-| i18n | **Built-in engine** | Zero-dependency locale switching in 0.01ms |
-
----
-
-## 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
-
+<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 Invisible Guardian for AI Agents</h3>
+<p align="center"><strong>Self-healing environments + 84% token savings. Your AI breaks things — afd fixes them in 184ms.</strong></p>
+
+<p align="center">
+  <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>
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/version-1.6.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-ko.md">한국어</a>
+</p>
+
+---
+
+## The Numbers Don't Lie
+
+| 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 events | AI goes haywire | **Mass-event suppressor** |
+| AI reads 8 large files (114KB) | **~28,600 tokens** consumed | **~4,600 tokens** (84% saved) |
+| Session token budget | Burns through context window | **~60,900 tokens saved per codebase scan** |
+
+> `< 0.1% CPU` | `~40MB RAM` | `< 270ms` full heal cycle | You never even see it happen.
+
+---
+
+## One Command to Rule Them All
+
+```bash
+npx @dotoricode/afd start
+```
+
+That's it. Daemon spawns, hooks inject, MCP registers. You're protected.
+
+```
+$ afd start
+  Daemon started (pid 4812, port 52413)
+  Smart Discovery: Watching 7 AI-context targets
+  Hook injected into .claude/hooks.json
+```
+
+---
+
+## The Problem
+
+Your AI agent is powerful but clumsy. It deletes `.claudeignore`, corrupts `hooks.json`, wipes `.cursorrules` — and you don't notice until everything is broken. You stop coding, diagnose the mess, manually restore files. **30 minutes gone. Flow destroyed.**
+
+And every time it reads your codebase? Full source files pumped straight into the context window. **Thousands of tokens burned on function bodies it never needed.**
+
+## The Solution
+
+`afd` runs as an invisible background daemon. It watches your critical files, heals corruption in 184ms, and serves AI agents compressed type skeletons instead of raw source code. Your AI gets the structure it needs at 1/16th the token cost. Accidents get fixed before you notice. Intentional deletions are respected. Zero config, zero interference.
+
+---
+
+## What's New in v1.6.0
+
+| Feature | What Changed |
+|:--------|:-------------|
+| **Tree-sitter AST Engine** | Replaced TypeScript compiler with tree-sitter — multilingual hologram support (TS/JS full, Python/Go/Rust fallback) |
+| **Real-time HUD ROI** | Status bar now shows live session token savings as you work |
+| **Event Batching** | 300ms debounce + dedup — no more event storms from rapid file changes |
+| **Hook Manager** | Multi-owner orchestration — afd coexists cleanly with other hook providers |
+
+---
+
+## Key Features
+
+| Feature | What it does |
+|:--------|:-------------|
+| **S.E.A.M Auto-Heal** | File deletion/corruption detected and restored in < 270ms |
+| **Hologram Extraction** | 70-96% lighter file skeletons served to AI agents via MCP |
+| **Smart Reader** | `afd_read` — small files raw, large files auto-compressed, line-range support |
+| **Workspace Map** | `afd://workspace-map` — full file tree + export signatures in one call |
+| **Import-Aware L1** | Only imported symbols get full signatures (85%+ savings) |
+| **Double-Tap** | Delete once = heal; delete again within 30s = respected as intent |
+| **Vaccine Network** | `afd sync` exports learned antibodies across projects |
+| **Self-Evolution** | Quarantined failures become prevention rules automatically |
+| **Mistake History** | PreToolUse hook injects past mistakes as warnings before edits |
+| **HUD Counter** | Status bar shows defense count + token savings at a glance |
+
+---
+
+## Token Savings — Real Measured Data
+
+The hologram system is afd's biggest value driver. Here's what we measured in a real session:
+
+### Session Snapshot
+
+| Metric | Value |
+|:-------|:------|
+| Hologram requests | 55 files analyzed |
+| Target files total size | ~290 KB (55 files, avg 5.3 KB each) |
+| Original token cost | ~72,500 tokens |
+| After hologram compression | ~11,600 tokens |
+| **Tokens saved** | **~60,900 tokens (84% reduction)** |
+
+### How It Scales
+
+```
+Session tokens (at ctx ~15%):  ~150,000  ████████████████
+Tokens saved by hologram:       ~60,900  ████████░░░░░░░░  (41% of session)
+```
+
+At ctx 50%+, file reads dominate the token budget. Without hologram, scanning 55 source files costs ~72.5K tokens. With hologram, **each file averages just 16% of its original footprint** — and the gap widens with every repeated read.
+
+### Three Layers of Token Optimization
+
+| Layer | Tool | Savings | How |
+|:------|:-----|:--------|:----|
+| **L0 Hologram** | `afd_hologram` | 80%+ | Strip function bodies, keep type signatures |
+| **L1 Hologram** | `afd_hologram` + `contextFile` | 85%+ | Filter to only imported symbols |
+| **Smart Reader** | `afd_read` | Auto | Files < 10KB raw, >= 10KB auto-hologram |
+| **Workspace Map** | `afd://workspace-map` | N/A | Entire project structure in one call |
+
+---
+
+<details>
+<summary><b>How S.E.A.M Works (internals)</b></summary>
+
+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** | Generates hologram (type skeleton) & runs health checks | < 5ms |
+| **Adapt** | Matches symptom to antibody, quarantines corrupted state | < 1ms |
+| **Mutate** | Applies RFC 6902 JSON-Patch to restore the file | < 25ms |
+
+> Full cycle: **< 270ms** from file deletion to full recovery.
+
+</details>
+
+---
+
+## Commands
+
+| Command | What it does |
+|:--------|:-------------|
+| `afd start` | Daemon spawn + Smart Discovery + Hook injection + MCP registration |
+| `afd stop` | Shift summary report & graceful shutdown (`--clean` to remove hooks & MCP) |
+| `afd score` | Health dashboard with evolution & hologram metrics |
+| `afd fix` | Symptom detection with hologram context & antibody learning |
+| `afd sync` | Vaccine payload export/import (`--push`, `--pull`, `--remote <url>`) |
+| `afd restart` | Stop + start in one command |
+| `afd status` | Quick health check — daemon, hooks, MCP, defenses |
+| `afd doctor` | Comprehensive health analysis with auto-fix recommendations |
+| `afd evolution` | Analyze quarantined failures & generate prevention rules |
+| `afd mcp install` | Register afd as MCP server in project + global config |
+| `afd vaccine` | List, search, install, publish community antibodies |
+| `afd lang` | Switch display language (`afd lang ko` / `afd lang en`) |
+
+---
+
+<details>
+<summary><b>Advanced Intelligence</b></summary>
+
+### Double-Tap Heuristic
+
+`afd` distinguishes **accidents** from **intent**:
+
+```
+$ rm .claudeignore            # First tap -> afd heals it silently
+$ 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 30s (intent) | Antibody goes dormant, deletion respected |
+| 3+ deletes in 1s (git checkout) | Mass-event detected, all suppression paused |
+
+### Vaccine Network
+
+```bash
+afd sync              # Export to .afd/global-vaccine-payload.json
+afd sync --push       # Push vaccines to remote
+afd sync --pull       # Pull vaccines from remote
+```
+
+The payload is sanitized (no absolute paths, no secrets) and portable.
+
+### Self-Evolution
+
+```bash
+afd evolution
+```
+
+Analyzes quarantined failures and writes prevention rules to `afd-lessons.md`. AI agents read this before editing immune-critical files — turning past failures into future prevention.
+
+</details>
+
+---
+
+## MCP Setup
+
+`afd` provides four MCP tools and one resource:
+
+| MCP Tool | Purpose |
+|:---------|:--------|
+| `afd_read` | Smart file reader — raw for small files, auto-hologram for large, optional line ranges |
+| `afd_hologram` | Token-efficient type skeleton of any TS/JS file (80%+ savings) |
+| `afd_diagnose` | Health diagnosis with symptoms and hologram context |
+| `afd_score` | Runtime stats: uptime, heals, hologram savings |
+
+| MCP Resource | Purpose |
+|:-------------|:--------|
+| `afd://workspace-map` | Full file tree with export signatures in one call |
+
+```bash
+afd mcp install    # Registers in .mcp.json + ~/.claude.json
+```
+
+---
+
+<details>
+<summary><b>Tech Stack</b></summary>
+
+| Layer | Technology | Why |
+|:------|:-----------|:----|
+| Runtime | **Bun** | Native TypeScript, fast SQLite, single binary |
+| Database | **Bun SQLite (WAL)** | 0.29ms reads, 24ms writes, crash-safe |
+| Parsing | **Tree-sitter** | Multilingual AST — TS, JS, Python, Go, Rust |
+| 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 |
+
+</details>
+
+---
+
+## Installation
+
+```bash
+# Fastest (no install)
+npx @dotoricode/afd start
+
+# With Bun (recommended for development)
+bun install
+bun link
+afd start
+```
+
+### Requirements
+
+- **Bun** >= 1.0
+- **OS**: Windows, macOS, Linux
+- **Target**: Claude Code, Cursor, Windsurf, Codex (ecosystem auto-detected)
+
+---
+
+## License
+
+MIT