@hoangsonw/forge 0.1.1 → 0.1.2-nightly.20260425

package/README.md

@@ -4,14 +4,16 @@
 
 # Forge
 
-**A local-first, multi-agent, programmable software-engineering runtime.**
+**A local-first, plan-first, multi-agent, and programmable software-engineering runtime.**
 
 *Not an assistant. A runtime.* Forge brings its own scheduler, sandbox,
 permission system, state machine, agentic loop, memory layers, and
 plugin ecosystem. You pick the model. You approve the actions. Everything
 is inspectable, replayable, and yours.
 
-**[Install](docs/INSTALL.md) · [Dev setup](docs/SETUP.md) · [Architecture](docs/ARCHITECTURE.md) · [Wiki Page](index.html) · [License](LICENSE)**
+<img src="images/logo.jpeg" alt="Forge logo" width="50%" />
+
+**[Install](https://github.com/hoangsonww/Forge-Agentic-Coding-CLI/blob/master/docs/INSTALL.md) · [Dev setup](https://github.com/hoangsonww/Forge-Agentic-Coding-CLI/blob/master/docs/SETUP.md) · [Architecture](https://github.com/hoangsonww/Forge-Agentic-Coding-CLI/blob/master/docs/ARCHITECTURE.md) · [Releases & versioning](https://github.com/hoangsonww/Forge-Agentic-Coding-CLI/blob/master/RELEASES.md) · [Demo walkthrough](DEMO.md) · [Wiki Page](https://hoangsonww.github.io/Forge-Agentic-Coding-CLI/) · [NPM Package](https://www.npmjs.com/package/@hoangsonw/forge) · [License](LICENSE)**
 
 </div>
 
@@ -42,25 +44,25 @@ is inspectable, replayable, and yours.
 
 ## At a glance
 
-Forge is a local-first, multi-agent, programmable software-engineering runtime. Unlike Claude Code or OpenAI Codex, Forge is local-first infrastructure, not a hosted assistant. It brings its own scheduler, sandbox, permission system, state machine, agentic loop, memory layers, and plugin ecosystem. You pick & host the model. You approve the actions. Everything is inspectable, replayable, and yours.
+Forge is a local-first, plan-first, multi-agent, and programmable software-engineering runtime. Unlike Claude Code or OpenAI Codex, Forge is local-first infrastructure, not a hosted assistant. It brings its own scheduler, sandbox, permission system, state machine, agentic loop, memory layers, and plugin ecosystem. You pick & host the model. You approve the actions. Everything is inspectable, replayable, and yours.
 
 <div align="center">
 
-| | value | reproducer |
-|---|---|---|
-| ⚡ **`forge doctor` cold-start** | **173 ms** | `time node bin/forge.js doctor --no-banner` |
-| ⚡ **`forge --help` cold-start** | **238 ms** | `time node bin/forge.js --help` |
-| 📦 **UI shell · zero CDN** | **89 KB** uncompressed | `wc -c src/ui/public/app.js` |
-| 🌐 **Provider probe timeout** | **1.5 s** | `src/models/openai.ts#isAvailable` |
-| 🔌 **Model providers** (auto-detected) | **6** | ollama · lmstudio · vllm · llama.cpp · openai-compat · anthropic |
-| 🧠 **Model families** classified | **41** | Llama / Qwen / DeepSeek / Gemma / Phi / Mistral / Codestral / … |
-| 🤖 **Built-in agents** | **6** | planner · architect · executor · reviewer · debugger · memory |
-| 🛠 **Tools** available to agents | **18** | read · write · edit · grep · glob · run_command · git · web · … |
-| 💬 **CLI subcommands · slash commands** | **24 · 55** | `forge --help` · `/help` in REPL |
-| 🎛 **Modes** | **9** | fast · balanced · heavy · plan · execute · audit · debug · architect · offline-safe |
-| ✅ **Tests** | **249 / 43 files** · 100% passing · ~3.3 s wall-clock | `npx vitest run` |
-| 🐳 **CI jobs · release stages** | **9 · 6** | [`.github/workflows/`](.github/workflows) |
-| 📦 **Container image** | ~355 MB · multi-arch · non-root · HEALTHCHECK | `docker pull ghcr.io/hoangsonw/forge-agentic-coding-cli:latest` |
+|                                         | value                                                 | reproducer                                                                          |
+|-----------------------------------------|-------------------------------------------------------|-------------------------------------------------------------------------------------|
+| ⚡ **`forge doctor` cold-start**         | **173 ms**                                            | `time node bin/forge.js doctor --no-banner`                                         |
+| ⚡ **`forge --help` cold-start**         | **238 ms**                                            | `time node bin/forge.js --help`                                                     |
+| 📦 **UI shell · zero CDN**              | **90 KB** uncompressed                                | `wc -c src/ui/public/app.js`                                                        |
+| 🌐 **Provider probe timeout**           | **1.5 s**                                             | `src/models/openai.ts#isAvailable`                                                  |
+| 🔌 **Model providers** (auto-detected)  | **6**                                                 | ollama · lmstudio · vllm · llama.cpp · openai-compat · anthropic                    |
+| 🧠 **Model families** classified        | **41**                                                | Llama / Qwen / DeepSeek / Gemma / Phi / Mistral / Codestral / …                     |
+| 🤖 **Built-in agents**                  | **6**                                                 | planner · architect · executor · reviewer · debugger · memory                       |
+| 🛠 **Tools** available to agents        | **18**                                                | read · write · edit · grep · glob · run_command · git · web · …                     |
+| 💬 **CLI subcommands · slash commands** | **24 · 55**                                           | `forge --help` · `/help` in REPL                                                    |
+| 🎛 **Modes**                            | **9**                                                 | fast · balanced · heavy · plan · execute · audit · debug · architect · offline-safe |
+| ✅ **Tests**                             | **548 / 97 files** · 100% passing · ~5.5 s wall-clock | `npx vitest run`                                                                    |
+| 🐳 **CI jobs · release stages**         | **9 · 6**                                             | [`.github/workflows/`](.github/workflows)                                           |
+| 📦 **Container image**                  | ~355 MB · multi-arch · non-root · HEALTHCHECK         | `docker pull ghcr.io/hoangsonw/forge-agentic-coding-cli:latest`                     |
 
 </div>
 
@@ -70,7 +72,7 @@ Forge is a local-first, multi-agent, programmable software-engineering runtime.
 ![Node.js](https://img.shields.io/badge/Node.js%2020+-339933?style=for-the-badge&logo=node.js&logoColor=white)
 ![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?style=for-the-badge&logo=javascript&logoColor=black)
 ![HTML5](https://img.shields.io/badge/HTML5-E34F26?style=for-the-badge&logo=html5&logoColor=white)
-![CSS3](https://img.shields.io/badge/CSS3-1572B6?style=for-the-badge&logo=css3&logoColor=white)
+![CSS3](https://img.shields.io/badge/CSS3-1572B6?style=for-the-badge&logo=css&logoColor=white)
 ![Bash](https://img.shields.io/badge/Bash-4EAA25?style=for-the-badge&logo=gnubash&logoColor=white)
 ![YAML](https://img.shields.io/badge/YAML-CB171E?style=for-the-badge&logo=yaml&logoColor=white)
 ![JSON](https://img.shields.io/badge/JSON-000000?style=for-the-badge&logo=json&logoColor=white)
@@ -84,76 +86,74 @@ Forge is a local-first, multi-agent, programmable software-engineering runtime.
 ![ts-node](https://img.shields.io/badge/ts--node-3178C6?style=for-the-badge&logo=tsnode&logoColor=white)
 ![Commander](https://img.shields.io/badge/Commander.js-333?style=for-the-badge)
 ![Zod](https://img.shields.io/badge/Zod-3068B7?style=for-the-badge&logo=zod&logoColor=white)
-![Chalk](https://img.shields.io/badge/Chalk-FF6B6B?style=for-the-badge)
-![Ora](https://img.shields.io/badge/Ora-55ACEE?style=for-the-badge)
-![Prompts](https://img.shields.io/badge/Prompts-9b59b6?style=for-the-badge)
-![Undici](https://img.shields.io/badge/undici-1f6feb?style=for-the-badge)
-![ws](https://img.shields.io/badge/ws-010101?style=for-the-badge&logo=socket.io&logoColor=white)
+![Chalk](https://img.shields.io/badge/Chalk-FF6B6B?style=for-the-badge&logo=chakraui&logoColor=white)
+![Ora](https://img.shields.io/badge/Ora-55ACEE?style=for-the-badge&logo=quora&logoColor=white)
+![Prompts](https://img.shields.io/badge/Prompts-9b59b6?style=for-the-badge&logo=probot&logoColor=white)
+![Undici](https://img.shields.io/badge/undici-1f6feb?style=for-the-badge&logo=unjs&logoColor=white)
 ![dotenv](https://img.shields.io/badge/dotenv-ECD53F?style=for-the-badge&logo=dotenv&logoColor=black)
-![semver](https://img.shields.io/badge/semver-CB3837?style=for-the-badge)
+![semver](https://img.shields.io/badge/semver-CB3837?style=for-the-badge&logo=semver&logoColor=white)
 ![SQLite](https://img.shields.io/badge/SQLite-003B57?style=for-the-badge&logo=sqlite&logoColor=white)
-![better-sqlite3](https://img.shields.io/badge/better--sqlite3-044a64?style=for-the-badge)
+![better-sqlite3](https://img.shields.io/badge/better--sqlite3-044a64?style=for-the-badge&logo=sqlite&logoColor=white)
 ![FTS5](https://img.shields.io/badge/SQLite%20FTS5-003B57?style=for-the-badge&logo=sqlite&logoColor=white)
-![JSONL](https://img.shields.io/badge/JSONL-000?style=for-the-badge)
+![JSONL](https://img.shields.io/badge/JSONL-000?style=for-the-badge&logo=json&logoColor=white)
 ![WebSockets](https://img.shields.io/badge/WebSockets-010101?style=for-the-badge&logo=socket.io&logoColor=white)
-![REST](https://img.shields.io/badge/REST-25A162?style=for-the-badge)
-![HTTP](https://img.shields.io/badge/HTTP%2F2-005cc5?style=for-the-badge)
-![POSIX](https://img.shields.io/badge/POSIX-3776AB?style=for-the-badge)
-![XDG](https://img.shields.io/badge/XDG%20Base%20Dir-5E2BFF?style=for-the-badge)
-![MCP](https://img.shields.io/badge/Model%20Context%20Protocol-444?style=for-the-badge)
+![REST](https://img.shields.io/badge/REST-25A162?style=for-the-badge&logo=resend&logoColor=white)
+![HTTP](https://img.shields.io/badge/HTTP%2F2-005cc5?style=for-the-badge&logo=htop&logoColor=white)
+![POSIX](https://img.shields.io/badge/POSIX-3776AB?style=for-the-badge&logo=posit&logoColor=white)
+![XDG](https://img.shields.io/badge/XDG%20Base%20Dir-5E2BFF?style=for-the-badge&logo=archlinux&logoColor=white)
+![MCP](https://img.shields.io/badge/Model%20Context%20Protocol-MCP-123?style=for-the-badge&logo=modelcontextprotocol&logoColor=white)
 ![OAuth2](https://img.shields.io/badge/OAuth%202.0%20%2B%20PKCE-0e8a16?style=for-the-badge&logo=auth0&logoColor=white)
 ![Ed25519](https://img.shields.io/badge/Ed25519-7C3AED?style=for-the-badge)
 ![SHA-256](https://img.shields.io/badge/SHA--256-444?style=for-the-badge)
 ![AES-GCM](https://img.shields.io/badge/AES--GCM-004E8C?style=for-the-badge)
-![DPAPI](https://img.shields.io/badge/DPAPI-0078D4?style=for-the-badge&logo=windows&logoColor=white)
-![libsecret](https://img.shields.io/badge/libsecret-4A90E2?style=for-the-badge)
+![DPAPI](https://img.shields.io/badge/DPAPI-0078D4?style=for-the-badge&logo=dpd&logoColor=white)
+![libsecret](https://img.shields.io/badge/libsecret-4A90E2?style=for-the-badge&logo=linux&logoColor=white)
 ![macOS Keychain](https://img.shields.io/badge/macOS%20Keychain-000?style=for-the-badge&logo=apple&logoColor=white)
 ![Docker](https://img.shields.io/badge/Docker-2496ED?style=for-the-badge&logo=docker&logoColor=white)
 ![Compose](https://img.shields.io/badge/Docker%20Compose-2496ED?style=for-the-badge&logo=docker&logoColor=white)
 ![Podman](https://img.shields.io/badge/Podman-892CA0?style=for-the-badge&logo=podman&logoColor=white)
 ![Buildx](https://img.shields.io/badge/Buildx-2496ED?style=for-the-badge&logo=docker&logoColor=white)
 ![QEMU](https://img.shields.io/badge/QEMU-FF6600?style=for-the-badge&logo=qemu&logoColor=white)
-![tini](https://img.shields.io/badge/tini-444?style=for-the-badge)
-![OCI](https://img.shields.io/badge/OCI%20Image-262261?style=for-the-badge)
-![ripgrep](https://img.shields.io/badge/ripgrep-333?style=for-the-badge)
+![tini](https://img.shields.io/badge/tini-444?style=for-the-badge&logo=tina&logoColor=white)
+![OCI](https://img.shields.io/badge/OCI%20Image-262261?style=for-the-badge&logo=gnusocial&logoColor=white)
+![ripgrep](https://img.shields.io/badge/ripgrep-333?style=for-the-badge&logo=greptimedb&logoColor=white)
 ![GitHub Actions](https://img.shields.io/badge/GitHub%20Actions-2088FF?style=for-the-badge&logo=githubactions&logoColor=white)
 ![GHCR](https://img.shields.io/badge/GHCR-181717?style=for-the-badge&logo=github&logoColor=white)
 ![npm Provenance](https://img.shields.io/badge/npm%20Provenance-CB3837?style=for-the-badge&logo=npm&logoColor=white)
-![Sigstore](https://img.shields.io/badge/Sigstore-2B3A67?style=for-the-badge)
+![Sigstore](https://img.shields.io/badge/Sigstore-2B3A67?style=for-the-badge&logo=simkl&logoColor=white)
 ![Dependabot](https://img.shields.io/badge/Dependabot-025E8C?style=for-the-badge&logo=dependabot&logoColor=white)
 ![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-FA6673?style=for-the-badge&logo=conventionalcommits&logoColor=white)
 ![SemVer](https://img.shields.io/badge/SemVer-3F4551?style=for-the-badge&logo=semver&logoColor=white)
 ![Ollama](https://img.shields.io/badge/Ollama-000000?style=for-the-badge&logo=ollama&logoColor=white)
-![LM Studio](https://img.shields.io/badge/LM%20Studio-4A90E2?style=for-the-badge&logoColor=white)
-![vLLM](https://img.shields.io/badge/vLLM-FA5C00?style=for-the-badge&logoColor=white)
-![llama.cpp](https://img.shields.io/badge/llama.cpp-FFCE00?style=for-the-badge&logoColor=black)
+![LM Studio](https://img.shields.io/badge/LM%20Studio-4A90E2?style=for-the-badge&logo=notebooklm&logoColor=white)
+![vLLM](https://img.shields.io/badge/vLLM-FA5C00?style=for-the-badge&logo=vlcmediaplayer&logoColor=white)
+![llama.cpp](https://img.shields.io/badge/llama.cpp-FFCE00?style=for-the-badge&logo=lada&logoColor=black)
 ![Anthropic](https://img.shields.io/badge/Anthropic-D4A27F?style=for-the-badge&logo=anthropic&logoColor=black)
-![OpenAI](https://img.shields.io/badge/OpenAI--compat-412991?style=for-the-badge&logo=openai&logoColor=white)
-![Azure OpenAI](https://img.shields.io/badge/Azure%20OpenAI-0078D4?style=for-the-badge&logo=microsoftazure&logoColor=white)
-![Groq](https://img.shields.io/badge/Groq-F55036?style=for-the-badge)
-![Together AI](https://img.shields.io/badge/Together%20AI-0F6FFF?style=for-the-badge)
-![LocalAI](https://img.shields.io/badge/LocalAI-2a9d8f?style=for-the-badge)
-![Fireworks](https://img.shields.io/badge/Fireworks-6B2CE7?style=for-the-badge)
+![OpenAI](https://img.shields.io/badge/OpenAI--compat-412991?style=for-the-badge&logo=openaigym&logoColor=white)
+![Azure OpenAI](https://img.shields.io/badge/Azure%20OpenAI-0078D4?style=for-the-badge&logo=bazel&logoColor=white)
+![Groq](https://img.shields.io/badge/Groq-F55036?style=for-the-badge&logo=grocy&logoColor=white)
+![Together AI](https://img.shields.io/badge/Together%20AI-0F6FFF?style=for-the-badge&logo=tether&logoColor=white)
+![LocalAI](https://img.shields.io/badge/LocalAI-2a9d8f?style=for-the-badge&logo=local&logoColor=white)
+![Fireworks](https://img.shields.io/badge/Fireworks-6B2CE7?style=for-the-badge&logo=cloudflareworkers&logoColor=white)
 ![Llama](https://img.shields.io/badge/Llama-0467DF?style=for-the-badge&logo=meta&logoColor=white)
 ![Qwen](https://img.shields.io/badge/Qwen-615CED?style=for-the-badge&logo=alibabacloud&logoColor=white)
-![DeepSeek](https://img.shields.io/badge/DeepSeek-1E40AF?style=for-the-badge)
+![DeepSeek](https://img.shields.io/badge/DeepSeek-1E40AF?style=for-the-badge&logo=deepl&logoColor=white)
 ![Gemma](https://img.shields.io/badge/Gemma-4285F4?style=for-the-badge&logo=google&logoColor=white)
-![Phi](https://img.shields.io/badge/Phi-00A4EF?style=for-the-badge&logo=microsoft&logoColor=white)
+![Phi](https://img.shields.io/badge/Phi-00A4EF?style=for-the-badge&logo=delphi&logoColor=white)
 ![Mistral](https://img.shields.io/badge/Mistral-FF7000?style=for-the-badge&logo=mistralai&logoColor=white)
-![Codestral](https://img.shields.io/badge/Codestral-FF7000?style=for-the-badge)
+![Codestral](https://img.shields.io/badge/Codestral-FF7000?style=for-the-badge&logo=astral&logoColor=white)
 ![CodeLlama](https://img.shields.io/badge/CodeLlama-0467DF?style=for-the-badge&logo=meta&logoColor=white)
 ![StarCoder](https://img.shields.io/badge/StarCoder-FFD21E?style=for-the-badge&logo=huggingface&logoColor=black)
-![Granite](https://img.shields.io/badge/Granite-054ADA?style=for-the-badge&logo=ibm&logoColor=white)
+![Granite](https://img.shields.io/badge/Granite-054ADA?style=for-the-badge&logo=graphite&logoColor=white)
 ![Command R](https://img.shields.io/badge/Command%20R+-39594D?style=for-the-badge&logo=cohere&logoColor=white)
 ![macOS](https://img.shields.io/badge/macOS-000?style=for-the-badge&logo=apple&logoColor=white)
 ![Linux](https://img.shields.io/badge/Linux-FCC624?style=for-the-badge&logo=linux&logoColor=black)
-![Windows](https://img.shields.io/badge/Windows-0078D6?style=for-the-badge&logo=windows&logoColor=white)
-![WSL2](https://img.shields.io/badge/WSL2-0078D4?style=for-the-badge&logo=windows&logoColor=white)
-![linux/amd64](https://img.shields.io/badge/linux%2Famd64-444?style=for-the-badge)
-![linux/arm64](https://img.shields.io/badge/linux%2Farm64-444?style=for-the-badge)
+![Windows](https://img.shields.io/badge/Windows-0078D6?style=for-the-badge&logo=windsurf&logoColor=white)
+![linux/amd64](https://img.shields.io/badge/linux%2Famd64-444?style=for-the-badge&logo=linux&logoColor=white)
+![linux/arm64](https://img.shields.io/badge/linux%2Farm64-444?style=for-the-badge&logo=linux&logoColor=white)
 ![Git](https://img.shields.io/badge/Git-F05032?style=for-the-badge&logo=git&logoColor=white)
 ![GitHub](https://img.shields.io/badge/GitHub-181717?style=for-the-badge&logo=github&logoColor=white)
-![VS Code](https://img.shields.io/badge/VS%20Code-007ACC?style=for-the-badge&logo=visualstudiocode&logoColor=white)
+![VS Code](https://img.shields.io/badge/VS%20Code-007ACC?style=for-the-badge&logo=task&logoColor=white)
 ![EditorConfig](https://img.shields.io/badge/EditorConfig-E0EFEF?style=for-the-badge&logo=editorconfig&logoColor=000)
 
 ---
@@ -237,9 +237,38 @@ docker compose -f docker/docker-compose.yml up -d
 # open http://127.0.0.1:7823
 ```
 
-**Requirements:** Node ≥ 20 *and/or* Docker ≥ 25. At least one LLM source
-(local runtime or API key). See [`docs/INSTALL.md`](docs/INSTALL.md) for
-per-OS notes.
+### System requirements
+
+| | Minimum | Notes |
+|---|---|---|
+| **Node.js** | **≥ 20** (22 tested) | Enforced via `package.json#engines`. Not needed if you use Docker. |
+| **OS** | macOS · Linux · Windows (WSL recommended) | `better-sqlite3` ships prebuilds for darwin-x64, darwin-arm64, linux-x64, linux-arm64, win32-x64 — no compile step. |
+| **Disk** | ~150 MB for `node_modules`; state under `~/.forge` grows with history | Override via `FORGE_HOME`. |
+| **RAM** | Forge ~100 MB; your local model consumes its own RAM/VRAM | `forge doctor` cold-starts in ~170 ms. |
+| **Docker** (alt path) | ≥ 25 | Multi-arch (amd64, arm64) image on GHCR. Zero host Node needed. |
+| **At least one model source** | Ollama · LM Studio · vLLM · llama.cpp · Anthropic · OpenAI-compatible | `forge doctor` tells you which are reachable. |
+
+**Runtime npm dependencies** (13, zero optional): `@modelcontextprotocol/sdk`, `better-sqlite3` (native, prebuilt), `chalk`, `cli-table3`, `commander`, `dotenv`, `ora`, `prompts`, `semver`, `undici`, `ws`, `yaml`, `zod`. No Python, Rust, or Go toolchain.
+
+**Recommended** (not required): `ripgrep` (fast `grep` tool path), `git` (diff/status tools + project-root detection), `$EDITOR` (used when you pick "Edit" on a plan).
+
+See [`docs/INSTALL.md`](docs/INSTALL.md) for per-OS notes and [`docs/SETUP.md`](docs/SETUP.md) for contributor setup.
+
+### See it running
+
+Three surfaces, one runtime.
+
+**REPL (Interactive Terminal) Mode**
+
+https://github.com/user-attachments/assets/eb592bbf-62a1-4d74-a540-7e066ebe56a4
+
+**CLI (Headless, One-shot run) Mode**
+
+https://github.com/user-attachments/assets/bc3b3204-fd87-436f-9467-604535edb4e2
+
+**Web UI Dashboard**
+
+https://github.com/user-attachments/assets/218cd64f-40fe-4836-9c62-c7a08538056b
 
 ---
 
@@ -498,6 +527,42 @@ warns once, never refuses to route.
 Unknown models are accepted too — Forge rates them as generic executors
 rather than refusing to route.
 
+### Model size & capability notes
+
+The agentic loop is cheap for the runtime but expensive for the *model*.
+Every step is a multi-turn tool-use conversation that returns strict JSON.
+Small models struggle with this in recognisable ways — please pick the
+right tool for the job.
+
+| Work you want to do | Safe local floor | What fails below the floor |
+|---|---|---|
+| Pure chat ("explain closures") | any 3B instruct (phi-3:mini, gemma-3:2b) | fine — conversation fast-path bypasses tool use entirely |
+| Summarize a file, explain a snippet | 7B instruct (qwen2.5:7b, llama3.1:8b) | summary is a line of "I read the file" instead of content |
+| Single-file edits / small features | **7B+ code specialist** (deepseek-coder:6.7b, qwen2.5-coder:7b) | picks wrong tool (run_command to write files), splits "create empty + edit" patterns, escalates to ask_user on tool errors |
+| Multi-file refactors, new features | 14B+ code specialist or a hosted frontier model | plan quality drops; step IDs get inconsistent; validation retries exhausted |
+| Architecture-level changes | hosted (Claude Opus/Sonnet, GPT-4 class) realistically | budgets blow out; changes go off-plan |
+
+Forge ships with defences so a small model fails *loudly* instead of
+silently corrupting files: the executor prompt spells out step-type →
+tool mappings, `ask_user` rejects empty/too-short questions as
+non-retryable, `edit_file` handles "create empty then fill" gracefully,
+parent directories auto-create, provider warm-up is explicit, and the
+router streams prose without `jsonMode` for narrator/conversation
+paths. The result is that a small model will often tell you it can't
+finish a task; it will rarely write the wrong code into a file.
+
+If in doubt: configure a code specialist for the `code` role, keep
+something lighter for `fast`, and set `ANTHROPIC_API_KEY` or
+`OPENAI_API_KEY` as a fallback — the router uses the hosted provider
+automatically when the local one fails or trips its circuit breaker.
+
+```bash
+forge config set models.code    deepseek-coder:6.7b
+forge config set models.planner qwen2.5:7b
+forge config set models.fast    phi3:mini
+export ANTHROPIC_API_KEY=sk-…   # optional fallback
+```
+
 ---
 
 ## Safety model (not optional)
@@ -569,6 +634,8 @@ Each mode is an **enforceable budget** — not a hint to the model. See
 
 ## CLI reference
 
+> **▶ See each surface in action** in [DEMO.md](DEMO.md) — REPL walkthrough, `forge run` one-shots, and the web dashboard.
+
 24 subcommands. Full surface:
 
 ```
@@ -580,7 +647,7 @@ forge execute "<prompt>"       # auto-approve + execute
 forge resume [taskId]          # resume any prior task (any status)
 forge status                   # runtime state
 forge doctor                   # health check + role→model mapping
-forge task list|search         # task history (SQLite-indexed)
+forge task list|search|delete  # task history (SQLite-indexed); delete prompts (or -y)
 forge session list|replay <id> # session JSONL inspection
 forge model list               # probe all providers
 forge config get|set|path      # configuration
@@ -594,7 +661,7 @@ forge cost                     # USD spend ledger
 forge ui start                 # local dashboard at :7823
 forge bundle {pack|unpack}     # offline bundles
 forge container up|down        # compose wrapper
-forge update [--check|--force] # self-update
+forge update [--check|--force] # self-update (REPL also checks on start, cache-gated)
 forge migrate                  # DB migrations
 forge changelog                # local changelog view
 forge dev                      # dev helpers
@@ -699,6 +766,8 @@ API key auth. Tokens stored in the OS keychain.
 Single hardened image (non-root, HEALTHCHECK, OCI labels, ~355 MB) that
 serves both CLI and UI.
 
+> [▶ Dashboard demo](images/UI.mp4) — `forge ui start` driving a full task end-to-end (plan approval, streamed model output, follow-up thread). More in [DEMO.md](DEMO.md).
+
 ```bash
 # Pull (multi-arch: linux/amd64 + linux/arm64):
 docker pull ghcr.io/hoangsonw/forge-agentic-coding-cli:latest
@@ -779,6 +848,9 @@ Workflows: [`.github/workflows/ci.yml`](.github/workflows/ci.yml),
 [`.github/workflows/release.yml`](.github/workflows/release.yml),
 [`.github/workflows/nightly.yml`](.github/workflows/nightly.yml).
 
+Full versioning & release playbook (SemVer policy, channels, signing,
+hotfix flow, rollback, built-in updater): **[`RELEASES.md`](RELEASES.md)**.
+
 ---
 
 ## Architecture map
@@ -858,10 +930,10 @@ xychart-beta
 ## Development
 
 ```bash
-git clone https://github.com/hoangsonw/Forge-Agentic-Coding-CLI && cd forge
+git clone https://github.com/hoangsonww/Forge-Agentic-Coding-CLI && cd forge
 npm install
 npm run build             # tsc + copy-assets
-npm test                  # 249 tests across 43 files; all must pass
+npm test                  # 548 tests across 97 files; all must pass
 ./bin/forge.js doctor
 ```
 

package/bin/README.md

@@ -0,0 +1,118 @@
+# `bin/`
+
+The thin shim that becomes the `forge` command on `$PATH` when you
+install the npm package.
+
+## What's here
+
+```
+bin/
+├── README.md   ← you are here
+└── forge.js    ← the only file that matters; ~30 lines
+```
+
+`bin/forge.js` is a Node shebang script. It does one thing: locate the
+compiled CLI (or fall back to `ts-node` for dev) and forward `argv`.
+
+## How `forge` becomes a command
+
+`package.json` declares the binary:
+
+```jsonc
+"bin": {
+  "forge": "bin/forge.js"
+}
+```
+
+When you `npm install -g @hoangsonw/forge`, npm:
+1. Reads the `bin` field.
+2. Creates a symlink named `forge` in your global `$PATH` (e.g.
+   `/usr/local/bin/forge` or `~/.npm-global/bin/forge`).
+3. Points it at the installed copy of `bin/forge.js`.
+
+From then on, typing `forge` on the shell runs this shim, which loads
+the compiled CLI from `dist/`.
+
+## Resolution path at runtime
+
+```mermaid
+flowchart TD
+  classDef step fill:#1e1b4b,stroke:#a78bfa,color:#ede9fe,rx:4,ry:4
+  classDef ok fill:#14532d,stroke:#86efac,color:#dcfce7,rx:4,ry:4
+  classDef fail fill:#7f1d1d,stroke:#fca5a5,color:#fee2e2,rx:4,ry:4
+
+  START["forge <args>"]:::step
+  START --> Q{"exists ../dist/cli/index.js?"}:::step
+  Q -->|yes — installed| D["require('dist/cli/index.js')<br/>normal path"]:::ok
+  Q -->|no — dev checkout| T["try require('ts-node/register')<br/>+ require('src/cli/index.ts')"]:::step
+  T -->|ts-node present| TOK["runs via ts-node"]:::ok
+  T -->|not installed| ERR["print helpful error, exit 1<br/>→ 'run npm run build'"]:::fail
+```
+
+Why both paths?
+
+- **Installed (`dist/` exists)**: fast cold start (~170 ms for
+  `forge doctor`), no ts-node overhead, no TypeScript dependency.
+- **Dev (`dist/` missing)**: lets contributors iterate on `src/*.ts`
+  without running `npm run build` between every change.
+
+## Invocation styles
+
+Three ways to run Forge locally during dev:
+
+| Command | When to use |
+|---|---|
+| `forge ...` | You installed globally (`npm i -g` or `npm link`). Normal user experience. |
+| `./bin/forge.js ...` | From inside a repo checkout. No install needed; uses the shim directly. |
+| `node bin/forge.js ...` | Same as above, explicit. Useful for shell aliases that need `node` flags (e.g., `--inspect`). |
+
+All three resolve to the same entry point. Pick whatever is ergonomic.
+
+## Dev loop cheat sheet
+
+```bash
+# Compile once, then use the installed binary.
+npm run build && forge doctor
+
+# Dev fallback — skip the build; ts-node compiles on the fly.
+./bin/forge.js doctor
+
+# Debug with the Node inspector.
+node --inspect-brk bin/forge.js run "hello"
+
+# Re-link after a clean:
+npm run relink   # unlinks, builds, links
+```
+
+## Node version
+
+The shim only requires a working `node` on `$PATH`. Forge itself needs
+**Node 20+** (`engines.node` in `package.json`). If an older Node is
+first on `$PATH`, the CLI exits early with a version check message —
+not the shim's responsibility.
+
+## Platform notes
+
+- **Unix (macOS / Linux)**: shebang works directly; the file has the
+  executable bit set (`chmod +x bin/forge.js`).
+- **Windows**: npm creates a `.cmd` wrapper alongside the `forge`
+  symlink when installing globally. If you run
+  `node bin/forge.js ...` on Windows, it works identically; the shim
+  doesn't touch paths as strings.
+
+## Troubleshooting
+
+| Symptom | Likely cause | Fix |
+|---|---|---|
+| `forge: command not found` | Global bin dir not on `$PATH`. | `npm bin -g` → add that dir to `$PATH`. |
+| `Cannot find module '.../dist/cli/index.js'` | Fresh clone, no build yet. | `npm run build` or install `ts-node`. |
+| `Compiled output not found and ts-node is unavailable.` | Dev fallback exhausted. | The shim's own error — run the build. |
+| Changes to `src/*.ts` don't take effect | You're running the compiled `dist/`, which is stale. | `npm run build` (or use `./bin/forge.js` to force the ts-node path). |
+| `forge` runs an old version after upgrade | Old symlink on `$PATH` ahead of the new one. | `which -a forge` → remove / replace the stale entry. |
+
+## Scope
+
+**This directory is stable.** The shim contract — "find the CLI, forward
+argv, fail helpfully" — hasn't changed and isn't expected to. If you're
+looking for the actual CLI implementation, it lives in
+[`src/cli/`](../src/cli/); the compiled output ends up in `dist/cli/`.

package/bin/forge.js

@@ -5,6 +5,8 @@
  * This shim locates the compiled CLI and forwards argv.
  * In production (installed via npm), dist/ is shipped.
  * In development, we fall back to ts-node on src/cli/index.ts.
+ *
+ * @author Son Nguyen <hoangson091104@gmail.com>
  */
 'use strict';
 

package/dist/agents/architect.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Architect agent — produces a system-level design document (not a plan).
+ * Use this explicitly via `--mode architect` when the task is "how should we
+ * structure X". No file edits; the output is prose/diagram text the user
+ * can decide to feed back in as an approved plan seed.
+ *
+ * @author Son Nguyen <hoangson091104@gmail.com>
+ */
 import { Agent } from './base';
 export interface ArchitectureOutput {
     goal: string;

package/dist/agents/architect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"architect.d.ts","sourceRoot":"","sources":["../../src/agents/architect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAe,MAAM,QAAQ,CAAC;AA+B5C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACpF,SAAS,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACrE,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAWD,eAAO,MAAM,cAAc,EAAE,KAiC5B,CAAC"}
+{"version":3,"file":"architect.d.ts","sourceRoot":"","sources":["../../src/agents/architect.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,EAAe,MAAM,QAAQ,CAAC;AAwB5C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACpF,SAAS,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACrE,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAWD,eAAO,MAAM,cAAc,EAAE,KAiC5B,CAAC"}

package/dist/agents/architect.js

@@ -1,4 +1,12 @@
 "use strict";
+/**
+ * Architect agent — produces a system-level design document (not a plan).
+ * Use this explicitly via `--mode architect` when the task is "how should we
+ * structure X". No file edits; the output is prose/diagram text the user
+ * can decide to feed back in as an approved plan seed.
+ *
+ * @author Son Nguyen <hoangson091104@gmail.com>
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.architectAgent = void 0;
 const router_1 = require("../models/router");
@@ -6,12 +14,6 @@ const assembler_1 = require("../prompts/assembler");
 const loader_1 = require("../config/loader");
 const retrieval_1 = require("../memory/retrieval");
 const logger_1 = require("../logging/logger");
-/**
- * Architect agent — produces a system-level design document (not a plan).
- * Use this explicitly via `--mode architect` when the task is "how should we
- * structure X". No file edits; the output is prose/diagram text the user
- * can decide to feed back in as an approved plan seed.
- */
 const architectSchema = `You are an Architect. You do NOT modify files — you only produce a design document.
 
 Output STRICT JSON:

package/dist/agents/architect.js.map

@@ -1 +1 @@
-{"version":3,"file":"architect.js","sourceRoot":"","sources":["../../src/agents/architect.ts"],"names":[],"mappings":";;;AACA,6CAA6C;AAC7C,oDAA0D;AAC1D,6CAAmF;AACnF,mDAA+C;AAC/C,8CAAwC;AAExC;;;;;GAKG;AAEH,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;EAetB,CAAC;AAYH,MAAM,KAAK,GAAG,CAAC,OAAe,EAA6B,EAAE;IAC3D,MAAM,KAAK,GAAG,kCAAkC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/D,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAuB,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEW,QAAA,cAAc,GAAU;IACnC,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,wDAAwD;IACrE,KAAK,CAAC,GAAG,CAAC,GAAG;QACX,MAAM,SAAS,GAAG,IAAA,oBAAQ,EAAC;YACzB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,KAAK,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,EAAE;YACzD,WAAW,EAAE,EAAE;YACf,YAAY,EAAE,EAAE;SACjB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,8BAAkB,EAAC;YAChC,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,KAAK,EAAE,cAAc,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE;YACrC,WAAW,EAAE,GAAG,CAAC,IAAI,CAAC,WAAW;YACjC,kBAAkB,EAAE,IAAA,+BAAsB,GAAE;YAC5C,mBAAmB,EAAE,IAAA,gCAAuB,EAAC,GAAG,CAAC,WAAW,CAAC;YAC7D,aAAa,EAAE,SAAS,CAAC,MAAM;YAC/B,kBAAkB,EAAE,GAAG,eAAe,iBAAiB,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,EAAE;SACvG,CAAC,CAAC;QACH,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAA,kBAAS,EAAC,WAAW,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE;gBAC3E,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,GAAG;gBAChB,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,MAAM;aAClB,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACvC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC;QAC3F,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,YAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACnD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"architect.js","sourceRoot":"","sources":["../../src/agents/architect.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAGH,6CAA6C;AAC7C,oDAA0D;AAC1D,6CAAmF;AACnF,mDAA+C;AAC/C,8CAAwC;AAExC,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;EAetB,CAAC;AAYH,MAAM,KAAK,GAAG,CAAC,OAAe,EAA6B,EAAE;IAC3D,MAAM,KAAK,GAAG,kCAAkC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/D,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAuB,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEW,QAAA,cAAc,GAAU;IACnC,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,wDAAwD;IACrE,KAAK,CAAC,GAAG,CAAC,GAAG;QACX,MAAM,SAAS,GAAG,IAAA,oBAAQ,EAAC;YACzB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,KAAK,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,EAAE;YACzD,WAAW,EAAE,EAAE;YACf,YAAY,EAAE,EAAE;SACjB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,8BAAkB,EAAC;YAChC,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,KAAK,EAAE,cAAc,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE;YACrC,WAAW,EAAE,GAAG,CAAC,IAAI,CAAC,WAAW;YACjC,kBAAkB,EAAE,IAAA,+BAAsB,GAAE;YAC5C,mBAAmB,EAAE,IAAA,gCAAuB,EAAC,GAAG,CAAC,WAAW,CAAC;YAC7D,aAAa,EAAE,SAAS,CAAC,MAAM;YAC/B,kBAAkB,EAAE,GAAG,eAAe,iBAAiB,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,EAAE;SACvG,CAAC,CAAC;QACH,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAA,kBAAS,EAAC,WAAW,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE;gBAC3E,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,GAAG;gBAChB,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,MAAM;aAClB,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACvC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC;QAC3F,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,YAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACnD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/agents/base.d.ts

@@ -1,3 +1,8 @@
+/**
+ * This file defines the base interfaces for agents in the system. An agent is a component that can execute tasks based on a given context. The Agent interface specifies the structure that all agents must follow, including a name, description, and a run method that takes an execution context and returns a result.
+ *
+ * @author Son Nguyen <hoangson091104@gmail.com>
+ */
 import { Mode, Task } from '../types';
 import { AssembledPrompt } from '../types';
 export interface AgentExecutionContext {

package/dist/agents/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/agents/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,GAAG,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/agents/base.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,GAAG,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB"}

package/dist/agents/base.js

@@ -1,3 +1,8 @@
 "use strict";
+/**
+ * This file defines the base interfaces for agents in the system. An agent is a component that can execute tasks based on a given context. The Agent interface specifies the structure that all agents must follow, including a name, description, and a run method that takes an execution context and returns a result.
+ *
+ * @author Son Nguyen <hoangson091104@gmail.com>
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=base.js.map

package/dist/agents/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/agents/base.ts"],"names":[],"mappings":""}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/agents/base.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/agents/debugger.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Debugger agent — performs root-cause analysis on failures. Use this when you have a failure message and want to understand why it happened and how to fix it. The output includes the most likely root cause, a list of hypotheses, a suggested fix, and a confidence level.
+ *
+ * @author Son Nguyen <hoangson091104@gmail.com>
+ */
 import { Agent } from './base';
 export interface DebugDiagnosis {
     rootCause: string;

package/dist/agents/debugger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"debugger.d.ts","sourceRoot":"","sources":["../../src/agents/debugger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAe,MAAM,QAAQ,CAAC;AAM5C,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AA0BD,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,eAAO,MAAM,QAAQ,GACnB,OAAO,aAAa,EACpB,MAAM,OAAO,UAAU,EAAE,IAAI,KAC5B,OAAO,CAAC,cAAc,CAuDxB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,KAM3B,CAAC"}
+{"version":3,"file":"debugger.d.ts","sourceRoot":"","sources":["../../src/agents/debugger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAe,MAAM,QAAQ,CAAC;AAM5C,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AA0BD,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,eAAO,MAAM,QAAQ,GACnB,OAAO,aAAa,EACpB,MAAM,OAAO,UAAU,EAAE,IAAI,KAC5B,OAAO,CAAC,cAAc,CAuDxB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,KAM3B,CAAC"}

package/dist/agents/debugger.js

@@ -1,4 +1,9 @@
 "use strict";
+/**
+ * Debugger agent — performs root-cause analysis on failures. Use this when you have a failure message and want to understand why it happened and how to fix it. The output includes the most likely root cause, a list of hypotheses, a suggested fix, and a confidence level.
+ *
+ * @author Son Nguyen <hoangson091104@gmail.com>
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.debuggerAgent = exports.diagnose = void 0;
 const router_1 = require("../models/router");

package/dist/agents/debugger.js.map

@@ -1 +1 @@
-{"version":3,"file":"debugger.js","sourceRoot":"","sources":["../../src/agents/debugger.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"debugger.js","sourceRoot":"","sources":["../../src/agents/debugger.ts"],"names":[],"mappings":"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"}

package/dist/agents/executor.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Executor agent — executes a single plan step via iterative tool use. This is the core of the system's ability to carry out complex, multi-step plans that require reasoning and adaptation. The agent receives a step description and a catalog of tools, and can call tools in a loop until it determines the step is complete. The output includes a summary of what was done, the results of each tool call, and any files changed.
+ *
+ * @author Son Nguyen <hoangson091104@gmail.com>
+ */
 import { Agent } from './base';
 import { PlanStep, ToolResult } from '../types';
 import { PermissionFlags } from '../permissions/manager';

package/dist/agents/executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/agents/executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAe,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAgB,QAAQ,EAAe,UAAU,EAAE,MAAM,UAAU,CAAC;AAK3E,OAAO,EAAqB,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAO5E,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,SAAS,EAAE,OAAO,CAAC;CACpB;AA8FD,eAAO,MAAM,aAAa,EAAE,KAS3B,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,UAAU,EAAE,IAAI,CAAC;IAC9B,KAAK,EAAE,eAAe,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/F;AAED,eAAO,MAAM,OAAO,GAAU,QAAQ,aAAa,KAAG,OAAO,CAAC,kBAAkB,CA2R/E,CAAC;AAmDF,eAAO,MAAM,2BAA2B,YAza7B,MAAM,KACd;IACD,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CAqa2C,CAAC;AAC5D,eAAO,MAAM,wBAAwB,UA5YJ;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;CAC7B,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAwY8B,CAAC"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/agents/executor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAe,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAgB,QAAQ,EAAe,UAAU,EAAE,MAAM,UAAU,CAAC;AAK3E,OAAO,EAAqB,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAO5E,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,SAAS,EAAE,OAAO,CAAC;CACpB;AA0GD,eAAO,MAAM,aAAa,EAAE,KAS3B,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,UAAU,EAAE,IAAI,CAAC;IAC9B,KAAK,EAAE,eAAe,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/F;AAED,eAAO,MAAM,OAAO,GAAU,QAAQ,aAAa,KAAG,OAAO,CAAC,kBAAkB,CA2R/E,CAAC;AAmDF,eAAO,MAAM,2BAA2B,YAza7B,MAAM,KACd;IACD,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CAqa2C,CAAC;AAC5D,eAAO,MAAM,wBAAwB,UA5YJ;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;CAC7B,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAwY8B,CAAC"}