coderouter-cli 2.4.0__tar.gz → 2.5.1__tar.gz

{coderouter_cli-2.4.0 → coderouter_cli-2.5.1}/CHANGELOG.md

@@ -6,6 +6,86 @@ versioning follows [SemVer](https://semver.org/).
 
 ---
 
+## [v2.5.1] — 2026-05-22 (MLX backend + docs reorganization)
+
+Patch release: a third Launcher backend, a reorganized documentation
+tree, and a security fix.
+
+### Added
+
+- **MLX backend** for the Launcher (`launcher_gui.py` and
+  `coderouter/ingress/launcher_routes.py`): `mlx` joins `llama.cpp` and
+  `vllm`, aimed at Apple Silicon users. Launches
+  `python -m mlx_lm.server --model <m> --port <p>`. The backend
+  selectors (desktop GUI combobox / Web `<select>`) gain an `mlx`
+  option, and the binary-not-found error messages are now
+  backend-agnostic.
+
+### Changed
+
+- **`docs/` reorganized** into role-based folders — `start/`, `guides/`,
+  `backends/`, `concepts/` — with a new bilingual (JA/EN) master index
+  at `docs/README.md` including a quick "what to read" table. Internal
+  cross-links, `README.md` / `README.en.md`, and code/config path
+  references were updated to the new layout.
+- **`plan.md` restructured**: deduplicated, version ordering fixed,
+  sections compressed (1747 → 721 lines).
+
+### Security
+
+- **starlette `1.0.0` → `1.0.1`** (`uv.lock`): fixes PYSEC-2026-161,
+  which failed the `cve-audit` CI job.
+
+---
+
+## [v2.5.0] — 2026-05-22 (Launcher — llama.cpp / vllm GUI)
+
+Browser-based process manager for local inference backends, integrated
+into the existing CodeRouter web UI at `/launcher`.
+
+### Added
+
+- **`coderouter/ingress/launcher_routes.py`**: New route module providing
+  the Launcher UI and its backing API.
+
+  - `GET /launcher` — Single-page HTML UI (Tailwind CDN + inline JS,
+    same dark-theme aesthetic as `/dashboard`).
+  - `GET /api/launcher/models` — Recursively scans `launcher.model_dirs`
+    and returns discovered model files with name, path, size (GB), and
+    extension.
+  - `GET /api/launcher/option-profiles` — Returns named option presets
+    from `providers.yaml` keyed by backend (`llama.cpp`, `vllm`).
+  - `GET /api/launcher/processes` — Lists all managed processes.
+  - `POST /api/launcher/start` — Starts a backend process. Accepts name,
+    backend, model_path, port, options dict, and extra_args free-text.
+  - `POST /api/launcher/stop/{id}` — SIGTERM → SIGKILL (5 s timeout).
+  - `DELETE /api/launcher/processes/{id}` — Removes a stopped process.
+  - `GET /api/launcher/logs/{id}` — Returns last N lines from the
+    process's 200-line stdout/stderr ring buffer.
+
+- **`LauncherOptionProfile` / `LauncherConfig`** (`config/schemas.py`):
+  New Pydantic models for the `launcher:` block in `providers.yaml`.
+  Adding new CLI flags requires only a YAML edit — no code change.
+
+- **`launcher_profiles.yaml.example`**: Template with 7 llama.cpp
+  presets and 7 vllm presets. For GitHub distribution and community
+  profile contributions.
+
+- **`/dashboard` header**: Added a "Launcher" navigation link.
+
+### Design notes
+
+- **YAML-driven**: option profiles live entirely in `providers.yaml`.
+  No code changes needed to add new backend flags.
+- **Multi-process**: each launched process gets a UUID-based ID and is
+  tracked independently. llama.cpp and vllm can run side by side.
+- **Zero new dependencies**: uses `asyncio.create_subprocess_exec`
+  (stdlib only). The 5-dep invariant is maintained.
+- **In-memory registry**: does not persist across CodeRouter restarts
+  (intentional — avoids zombie GPU allocations on restart).
+
+---
+
 ## [v2.4.0] — 2026-05-15 (Goal-session awareness — P1-4/5/6)
 
 Stable release following v2.3.0a4. Promotes the Plugin SDK to stable,

{coderouter_cli-2.4.0 → coderouter_cli-2.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: coderouter-cli
-Version: 2.4.0
+Version: 2.5.1
 Summary: Local-first, free-first, fallback-built-in LLM router. Claude Code / OpenAI compatible.
 Project-URL: Homepage, https://github.com/zephel01/CodeRouter
 Project-URL: Repository, https://github.com/zephel01/CodeRouter
@@ -54,7 +54,7 @@ Description-Content-Type: text/markdown
 </p>
 
 <p align="center">
-  <a href="./README.en.md">English</a> · <strong>日本語</strong> · <a href="./docs/quickstart.md">10 分で動かす</a> · <a href="./docs/architecture.md">設計詳細</a>
+  <a href="./README.en.md">English</a> · <strong>日本語</strong> · <a href="./docs/start/quickstart.md">10 分で動かす</a> · <a href="./docs/concepts/architecture.md">設計詳細</a>
 </p>
 
 ---
@@ -121,7 +121,7 @@ ANTHROPIC_BASE_URL=http://localhost:8088 ANTHROPIC_AUTH_TOKEN=dummy claude
 | codex / gemini-cli + Ollama 直繋ぎで動いてる | オプション — フォールバックが欲しいなら |
 | Claude API を直接叩いてて問題ない | 不要 |
 
-詳細は → [要否判定ガイド](./docs/when-do-i-need-coderouter.md)
+詳細は → [要否判定ガイド](./docs/start/when-do-i-need-coderouter.md)
 
 ---
 
@@ -141,7 +141,7 @@ ANTHROPIC_BASE_URL=http://localhost:8088 ANTHROPIC_AUTH_TOKEN=dummy claude
 | ガード | 何から守るか |
 |---|---|
 | **Context Budget** | メッセージが溜まりすぎて context window 溢れ → 自動 trim |
-| **Drift Detection** | モデルの応答品質が徐々に劣化 → 別 provider に切替 or KV cache flush |
+| **Drift Detection** | モデルの応答品質が徐々に劣化 → 別 provider に切替 or KV cache flush (6 シグナル、`goal_mode` で目標達成停滞も検知) |
 | **Self-healing** | backend が落ちた → 自動除外 + restart + 回復 probe で自動復帰 |
 | **Tool Loop Guard** | 同じツールを無限に呼び続ける → 検知して停止 |
 | **Memory Pressure** | GPU メモリ不足を検知 → 軽量モデルに切替 |
@@ -154,9 +154,40 @@ ANTHROPIC_BASE_URL=http://localhost:8088 ANTHROPIC_AUTH_TOKEN=dummy claude
 | **`coderouter doctor`** | プロバイダの問題を 6 プローブで即診断 + 修正パッチ出力 |
 | **`/dashboard`** | ブラウザで今何が起きてるかリアルタイム確認 |
 | **`coderouter audit`** | guard 発火履歴を検索 |
-| **`coderouter replay`** | provider 切替の効果を統計比較 (A/B 分析) |
+| **`coderouter replay`** | provider 切替の効果を統計比較 (A/B 分析) / `--suggest-rules` でルール最適化提案 |
 | **Continuous Probe** | idle 時も定期的に backend を監視 |
 
+### Launcher — llama.cpp / vllm 起動 UI
+
+`http://localhost:8088/launcher` で開けるブラウザ UI。llama.cpp や vllm を GUI で起動・管理できます。
+
+| 機能 | 詳細 |
+|---|---|
+| **モデルスキャン** | `model_dirs` に指定したフォルダを再帰スキャンして `.gguf` / `.safetensors` をリスト化 |
+| **オプションプロファイル** | `providers.yaml` に名前付きプリセットを定義 → ドロップダウンで選択するだけ |
+| **複数プロセス管理** | llama.cpp と vllm を同時に起動し、ポートごとに独立管理 |
+| **ログビューア** | 各プロセスの stdout/stderr をブラウザ内でリアルタイム確認 |
+
+```yaml
+# providers.yaml に追記するだけで有効になる
+launcher:
+  model_dirs:
+    - ~/models
+  option_profiles:
+    llama.cpp:
+      - name: "GPU フル活用"
+        args:
+          "-ngl": 99
+          "--ctx-size": 4096
+    vllm:
+      - name: "標準"
+        args:
+          "--dtype": "auto"
+          "--max-model-len": 4096
+```
+
+詳細 → [Launcher ガイド](./docs/backends/launcher.md)
+
 ---
 
 ## 設定例 (最小)
@@ -182,7 +213,7 @@ providers:
     api_key_env: OPENROUTER_API_KEY
 ```
 
-もっと詳しい設定 → [利用ガイド](./docs/usage-guide.md) · [設計詳細](./docs/architecture.md)
+もっと詳しい設定 → [利用ガイド](./docs/guides/usage-guide.md) · [設計詳細](./docs/concepts/architecture.md)
 
 ---
 
@@ -190,14 +221,15 @@ providers:
 
 | やりたいこと | ドキュメント |
 |---|---|
-| すぐ動かす | [Quickstart](./docs/quickstart.md) |
-| 使いこなす | [利用ガイド](./docs/usage-guide.md) |
-| 無料で回す | [無料枠ガイド](./docs/free-tier-guide.md) |
-| 詰まった | [トラブルシューティング](./docs/troubleshooting.md) |
-| 設計を知りたい | [アーキテクチャ詳細](./docs/architecture.md) |
+| すぐ動かす | [Quickstart](./docs/start/quickstart.md) |
+| 使いこなす | [利用ガイド](./docs/guides/usage-guide.md) |
+| 無料で回す | [無料枠ガイド](./docs/guides/free-tier-guide.md) |
+| llama.cpp / vllm を GUI で起動 | [Launcher ガイド](./docs/backends/launcher.md) |
+| 詰まった | [トラブルシューティング](./docs/guides/troubleshooting.md) |
+| 設計を知りたい | [アーキテクチャ詳細](./docs/concepts/architecture.md) |
 | 全リリース履歴 | [CHANGELOG](./CHANGELOG.md) |
 
-English: [Quickstart](./docs/quickstart.en.md) · [Usage guide](./docs/usage-guide.en.md) · [Free-tier](./docs/free-tier-guide.en.md) · [Troubleshooting](./docs/troubleshooting.en.md)
+English: [Quickstart](./docs/start/quickstart.en.md) · [Usage guide](./docs/guides/usage-guide.en.md) · [Free-tier](./docs/guides/free-tier-guide.en.md) · [Troubleshooting](./docs/guides/troubleshooting.en.md)
 
 ---
 
@@ -207,10 +239,10 @@ English: [Quickstart](./docs/quickstart.en.md) · [Usage guide](./docs/usage-gui
 
 | 症状 | 原因 | 詳細 |
 |---|---|---|
-| 401 エラー | API キー未設定 / `.env` に `export` 忘れ | [§1](./docs/troubleshooting.md#1-起動設定で踏みやすい-5-つの罠-v162-追加) |
-| 返信が空 / 意味不明 | Ollama の `num_ctx` が 2048 に切り詰め | [§3](./docs/troubleshooting.md#3-ollama-初心者--サイレント失敗-5-症状-v07-c) |
-| `<think>` タグが漏れる | `output_filters: [strip_thinking]` を付ける | [§3](./docs/troubleshooting.md#3-ollama-初心者--サイレント失敗-5-症状-v07-c) |
-| Claude Code でツール呼び出しがおかしい | tool-call 修復が効いてない | [§4](./docs/troubleshooting.md#4-claude-code-連携で踏みやすい罠-v162-追加) |
+| 401 エラー | API キー未設定 / `.env` に `export` 忘れ | [§1](./docs/guides/troubleshooting.md#1-起動設定で踏みやすい-5-つの罠-v162-追加) |
+| 返信が空 / 意味不明 | Ollama の `num_ctx` が 2048 に切り詰め | [§3](./docs/guides/troubleshooting.md#3-ollama-初心者--サイレント失敗-5-症状-v07-c) |
+| `<think>` タグが漏れる | `output_filters: [strip_thinking]` を付ける | [§3](./docs/guides/troubleshooting.md#3-ollama-初心者--サイレント失敗-5-症状-v07-c) |
+| Claude Code でツール呼び出しがおかしい | tool-call 修復が効いてない | [§4](./docs/guides/troubleshooting.md#4-claude-code-連携で踏みやすい罠-v162-追加) |
 
 `http://localhost:8088/dashboard` を開いておくと、ほとんどの問題が見て 10 秒でわかります。
 
@@ -236,7 +268,7 @@ CodeRouter は backend ルーター層として独立して動きます。`OPENA
 
 ## Security
 
-シークレットは環境変数に置きます。[`docs/security.md`](./docs/security.md) に完全な方針と報告手順があります。
+シークレットは環境変数に置きます。[`docs/security.md`](./docs/guides/security.md) に完全な方針と報告手順があります。
 
 ## License
 

{coderouter_cli-2.4.0 → coderouter_cli-2.5.1}/README.en.md

@@ -13,7 +13,7 @@
 </p>
 
 <p align="center">
-  <strong>English</strong> · <a href="./README.md">日本語</a> · <a href="./docs/quickstart.en.md">Get started in 10 min</a> · <a href="./docs/architecture.md">Architecture</a>
+  <strong>English</strong> · <a href="./README.md">日本語</a> · <a href="./docs/start/quickstart.en.md">Get started in 10 min</a> · <a href="./docs/concepts/architecture.md">Architecture</a>
 </p>
 
 ---
@@ -80,7 +80,7 @@ That's it. Claude Code works as usual, but your local Ollama is answering behind
 | codex / gemini-cli + Ollama works fine | Optional — if you want fallback |
 | Using Claude API directly, no issues | Not needed |
 
-Full decision matrix → [Do I need CodeRouter?](./docs/when-do-i-need-coderouter.en.md)
+Full decision matrix → [Do I need CodeRouter?](./docs/start/when-do-i-need-coderouter.en.md)
 
 ---
 
@@ -100,7 +100,7 @@ Full decision matrix → [Do I need CodeRouter?](./docs/when-do-i-need-coderoute
 | Guard | What it protects against |
 |---|---|
 | **Context Budget** | Messages piling up → context window overflow. Auto-trim at 90% |
-| **Drift Detection** | Model quality degrading over time → switch provider or flush KV cache |
+| **Drift Detection** | Model quality degrading over time → switch provider or flush KV cache (6 signals incl. `goal_progress_stall`; `goal_mode` for tighter thresholds) |
 | **Self-healing** | Backend crashes → auto-exclude + restart + recovery probe → auto-restore |
 | **Tool Loop Guard** | Agent calling the same tool forever → detect and break |
 | **Memory Pressure** | GPU running out of VRAM → switch to lighter model |
@@ -113,9 +113,40 @@ Full decision matrix → [Do I need CodeRouter?](./docs/when-do-i-need-coderoute
 | **`coderouter doctor`** | 6-probe diagnosis of provider issues + copy-paste YAML patches |
 | **`/dashboard`** | Real-time browser view of what's happening |
 | **`coderouter audit`** | Search guard activation history |
-| **`coderouter replay`** | Compare providers statistically (A/B analysis) |
+| **`coderouter replay`** | Compare providers statistically (A/B analysis) / `--suggest-rules` for automated rule suggestions |
 | **Continuous Probe** | Background health monitoring even during idle |
 
+### Launcher — llama.cpp / vllm GUI
+
+Browser UI at `http://localhost:8088/launcher` for starting and managing local inference backends.
+
+| Feature | Detail |
+|---|---|
+| **Model scanner** | Recursively scans `model_dirs` for `.gguf` / `.safetensors` and lists them |
+| **Option profiles** | Name your flag presets in `providers.yaml` — select from a dropdown, no CLI needed |
+| **Multi-process** | Run llama.cpp and vllm side by side on different ports |
+| **Log viewer** | stdout/stderr of each process shown live in the browser |
+
+```yaml
+# Add to providers.yaml — no code changes needed
+launcher:
+  model_dirs:
+    - ~/models
+  option_profiles:
+    llama.cpp:
+      - name: "Full GPU"
+        args:
+          "-ngl": 99
+          "--ctx-size": 4096
+    vllm:
+      - name: "Standard"
+        args:
+          "--dtype": "auto"
+          "--max-model-len": 4096
+```
+
+Details → [Launcher guide](./docs/backends/launcher.md)
+
 ---
 
 ## Minimal Config
@@ -141,7 +172,7 @@ providers:
     api_key_env: OPENROUTER_API_KEY
 ```
 
-More detail → [Usage guide](./docs/usage-guide.en.md) · [Architecture](./docs/architecture.md)
+More detail → [Usage guide](./docs/guides/usage-guide.en.md) · [Architecture](./docs/concepts/architecture.md)
 
 ---
 
@@ -149,14 +180,15 @@ More detail → [Usage guide](./docs/usage-guide.en.md) · [Architecture](./docs
 
 | Goal | Document |
 |---|---|
-| Get running fast | [Quickstart](./docs/quickstart.en.md) |
-| Use it well | [Usage guide](./docs/usage-guide.en.md) |
-| Run for free | [Free-tier guide](./docs/free-tier-guide.en.md) |
-| Stuck? | [Troubleshooting](./docs/troubleshooting.en.md) |
-| Understand the design | [Architecture](./docs/architecture.md) |
+| Get running fast | [Quickstart](./docs/start/quickstart.en.md) |
+| Use it well | [Usage guide](./docs/guides/usage-guide.en.md) |
+| Run for free | [Free-tier guide](./docs/guides/free-tier-guide.en.md) |
+| Launch llama.cpp / vllm via GUI | [Launcher guide](./docs/backends/launcher.md) |
+| Stuck? | [Troubleshooting](./docs/guides/troubleshooting.en.md) |
+| Understand the design | [Architecture](./docs/concepts/architecture.md) |
 | Full release history | [CHANGELOG](./CHANGELOG.md) |
 
-日本語: [Quickstart](./docs/quickstart.md) · [利用ガイド](./docs/usage-guide.md) · [無料枠ガイド](./docs/free-tier-guide.md) · [トラブルシューティング](./docs/troubleshooting.md)
+日本語: [Quickstart](./docs/start/quickstart.md) · [利用ガイド](./docs/guides/usage-guide.md) · [無料枠ガイド](./docs/guides/free-tier-guide.md) · [トラブルシューティング](./docs/guides/troubleshooting.md)
 
 ---
 
@@ -166,10 +198,10 @@ More detail → [Usage guide](./docs/usage-guide.en.md) · [Architecture](./docs
 
 | Symptom | Cause | Details |
 |---|---|---|
-| 401 error | API key not set / missing `export` in `.env` | [§1](./docs/troubleshooting.en.md#1-five-startup--config-gotchas-added-in-v162) |
-| Empty / garbage replies | Ollama `num_ctx` truncated to 2048 | [§3](./docs/troubleshooting.en.md#3-ollama-beginner--5-silent-fail-symptoms-v07-c) |
-| `<think>` tags leaking | Add `output_filters: [strip_thinking]` | [§3](./docs/troubleshooting.en.md#3-ollama-beginner--5-silent-fail-symptoms-v07-c) |
-| Tool calls misbehaving in Claude Code | Tool-call repair not kicking in | [§4](./docs/troubleshooting.en.md#4-claude-code-integration-gotchas-added-in-v162) |
+| 401 error | API key not set / missing `export` in `.env` | [§1](./docs/guides/troubleshooting.en.md#1-five-startup--config-gotchas-added-in-v162) |
+| Empty / garbage replies | Ollama `num_ctx` truncated to 2048 | [§3](./docs/guides/troubleshooting.en.md#3-ollama-beginner--5-silent-fail-symptoms-v07-c) |
+| `<think>` tags leaking | Add `output_filters: [strip_thinking]` | [§3](./docs/guides/troubleshooting.en.md#3-ollama-beginner--5-silent-fail-symptoms-v07-c) |
+| Tool calls misbehaving in Claude Code | Tool-call repair not kicking in | [§4](./docs/guides/troubleshooting.en.md#4-claude-code-integration-gotchas-added-in-v162) |
 
 Open `http://localhost:8088/dashboard` while debugging — most issues become visible in 10 seconds.
 
@@ -195,7 +227,7 @@ CodeRouter runs as an independent backend router layer. Point any project's `OPE
 
 ## Security
 
-Secrets go in env vars, not config files. See [`docs/security.en.md`](./docs/security.en.md) for the full policy and reporting instructions.
+Secrets go in env vars, not config files. See [`docs/security.en.md`](./docs/guides/security.en.md) for the full policy and reporting instructions.
 
 ## License
 

{coderouter_cli-2.4.0 → coderouter_cli-2.5.1}/README.md

@@ -13,7 +13,7 @@
 </p>
 
 <p align="center">
-  <a href="./README.en.md">English</a> · <strong>日本語</strong> · <a href="./docs/quickstart.md">10 分で動かす</a> · <a href="./docs/architecture.md">設計詳細</a>
+  <a href="./README.en.md">English</a> · <strong>日本語</strong> · <a href="./docs/start/quickstart.md">10 分で動かす</a> · <a href="./docs/concepts/architecture.md">設計詳細</a>
 </p>
 
 ---
@@ -80,7 +80,7 @@ ANTHROPIC_BASE_URL=http://localhost:8088 ANTHROPIC_AUTH_TOKEN=dummy claude
 | codex / gemini-cli + Ollama 直繋ぎで動いてる | オプション — フォールバックが欲しいなら |
 | Claude API を直接叩いてて問題ない | 不要 |
 
-詳細は → [要否判定ガイド](./docs/when-do-i-need-coderouter.md)
+詳細は → [要否判定ガイド](./docs/start/when-do-i-need-coderouter.md)
 
 ---
 
@@ -100,7 +100,7 @@ ANTHROPIC_BASE_URL=http://localhost:8088 ANTHROPIC_AUTH_TOKEN=dummy claude
 | ガード | 何から守るか |
 |---|---|
 | **Context Budget** | メッセージが溜まりすぎて context window 溢れ → 自動 trim |
-| **Drift Detection** | モデルの応答品質が徐々に劣化 → 別 provider に切替 or KV cache flush |
+| **Drift Detection** | モデルの応答品質が徐々に劣化 → 別 provider に切替 or KV cache flush (6 シグナル、`goal_mode` で目標達成停滞も検知) |
 | **Self-healing** | backend が落ちた → 自動除外 + restart + 回復 probe で自動復帰 |
 | **Tool Loop Guard** | 同じツールを無限に呼び続ける → 検知して停止 |
 | **Memory Pressure** | GPU メモリ不足を検知 → 軽量モデルに切替 |
@@ -113,9 +113,40 @@ ANTHROPIC_BASE_URL=http://localhost:8088 ANTHROPIC_AUTH_TOKEN=dummy claude
 | **`coderouter doctor`** | プロバイダの問題を 6 プローブで即診断 + 修正パッチ出力 |
 | **`/dashboard`** | ブラウザで今何が起きてるかリアルタイム確認 |
 | **`coderouter audit`** | guard 発火履歴を検索 |
-| **`coderouter replay`** | provider 切替の効果を統計比較 (A/B 分析) |
+| **`coderouter replay`** | provider 切替の効果を統計比較 (A/B 分析) / `--suggest-rules` でルール最適化提案 |
 | **Continuous Probe** | idle 時も定期的に backend を監視 |
 
+### Launcher — llama.cpp / vllm 起動 UI
+
+`http://localhost:8088/launcher` で開けるブラウザ UI。llama.cpp や vllm を GUI で起動・管理できます。
+
+| 機能 | 詳細 |
+|---|---|
+| **モデルスキャン** | `model_dirs` に指定したフォルダを再帰スキャンして `.gguf` / `.safetensors` をリスト化 |
+| **オプションプロファイル** | `providers.yaml` に名前付きプリセットを定義 → ドロップダウンで選択するだけ |
+| **複数プロセス管理** | llama.cpp と vllm を同時に起動し、ポートごとに独立管理 |
+| **ログビューア** | 各プロセスの stdout/stderr をブラウザ内でリアルタイム確認 |
+
+```yaml
+# providers.yaml に追記するだけで有効になる
+launcher:
+  model_dirs:
+    - ~/models
+  option_profiles:
+    llama.cpp:
+      - name: "GPU フル活用"
+        args:
+          "-ngl": 99
+          "--ctx-size": 4096
+    vllm:
+      - name: "標準"
+        args:
+          "--dtype": "auto"
+          "--max-model-len": 4096
+```
+
+詳細 → [Launcher ガイド](./docs/backends/launcher.md)
+
 ---
 
 ## 設定例 (最小)
@@ -141,7 +172,7 @@ providers:
     api_key_env: OPENROUTER_API_KEY
 ```
 
-もっと詳しい設定 → [利用ガイド](./docs/usage-guide.md) · [設計詳細](./docs/architecture.md)
+もっと詳しい設定 → [利用ガイド](./docs/guides/usage-guide.md) · [設計詳細](./docs/concepts/architecture.md)
 
 ---
 
@@ -149,14 +180,15 @@ providers:
 
 | やりたいこと | ドキュメント |
 |---|---|
-| すぐ動かす | [Quickstart](./docs/quickstart.md) |
-| 使いこなす | [利用ガイド](./docs/usage-guide.md) |
-| 無料で回す | [無料枠ガイド](./docs/free-tier-guide.md) |
-| 詰まった | [トラブルシューティング](./docs/troubleshooting.md) |
-| 設計を知りたい | [アーキテクチャ詳細](./docs/architecture.md) |
+| すぐ動かす | [Quickstart](./docs/start/quickstart.md) |
+| 使いこなす | [利用ガイド](./docs/guides/usage-guide.md) |
+| 無料で回す | [無料枠ガイド](./docs/guides/free-tier-guide.md) |
+| llama.cpp / vllm を GUI で起動 | [Launcher ガイド](./docs/backends/launcher.md) |
+| 詰まった | [トラブルシューティング](./docs/guides/troubleshooting.md) |
+| 設計を知りたい | [アーキテクチャ詳細](./docs/concepts/architecture.md) |
 | 全リリース履歴 | [CHANGELOG](./CHANGELOG.md) |
 
-English: [Quickstart](./docs/quickstart.en.md) · [Usage guide](./docs/usage-guide.en.md) · [Free-tier](./docs/free-tier-guide.en.md) · [Troubleshooting](./docs/troubleshooting.en.md)
+English: [Quickstart](./docs/start/quickstart.en.md) · [Usage guide](./docs/guides/usage-guide.en.md) · [Free-tier](./docs/guides/free-tier-guide.en.md) · [Troubleshooting](./docs/guides/troubleshooting.en.md)
 
 ---
 
@@ -166,10 +198,10 @@ English: [Quickstart](./docs/quickstart.en.md) · [Usage guide](./docs/usage-gui
 
 | 症状 | 原因 | 詳細 |
 |---|---|---|
-| 401 エラー | API キー未設定 / `.env` に `export` 忘れ | [§1](./docs/troubleshooting.md#1-起動設定で踏みやすい-5-つの罠-v162-追加) |
-| 返信が空 / 意味不明 | Ollama の `num_ctx` が 2048 に切り詰め | [§3](./docs/troubleshooting.md#3-ollama-初心者--サイレント失敗-5-症状-v07-c) |
-| `<think>` タグが漏れる | `output_filters: [strip_thinking]` を付ける | [§3](./docs/troubleshooting.md#3-ollama-初心者--サイレント失敗-5-症状-v07-c) |
-| Claude Code でツール呼び出しがおかしい | tool-call 修復が効いてない | [§4](./docs/troubleshooting.md#4-claude-code-連携で踏みやすい罠-v162-追加) |
+| 401 エラー | API キー未設定 / `.env` に `export` 忘れ | [§1](./docs/guides/troubleshooting.md#1-起動設定で踏みやすい-5-つの罠-v162-追加) |
+| 返信が空 / 意味不明 | Ollama の `num_ctx` が 2048 に切り詰め | [§3](./docs/guides/troubleshooting.md#3-ollama-初心者--サイレント失敗-5-症状-v07-c) |
+| `<think>` タグが漏れる | `output_filters: [strip_thinking]` を付ける | [§3](./docs/guides/troubleshooting.md#3-ollama-初心者--サイレント失敗-5-症状-v07-c) |
+| Claude Code でツール呼び出しがおかしい | tool-call 修復が効いてない | [§4](./docs/guides/troubleshooting.md#4-claude-code-連携で踏みやすい罠-v162-追加) |
 
 `http://localhost:8088/dashboard` を開いておくと、ほとんどの問題が見て 10 秒でわかります。
 
@@ -195,7 +227,7 @@ CodeRouter は backend ルーター層として独立して動きます。`OPENA
 
 ## Security
 
-シークレットは環境変数に置きます。[`docs/security.md`](./docs/security.md) に完全な方針と報告手順があります。
+シークレットは環境変数に置きます。[`docs/security.md`](./docs/guides/security.md) に完全な方針と報告手順があります。
 
 ## License
 

{coderouter_cli-2.4.0 → coderouter_cli-2.5.1}/coderouter/cli.py

@@ -61,7 +61,7 @@ def _build_parser() -> argparse.ArgumentParser:
             "binding the server. Repeat to layer multiple files. By "
             "default, file values do NOT override variables already in "
             "the environment (the shell `export` wins). See "
-            "docs/troubleshooting.md §5 for 1Password / direnv / sops "
+            "docs/guides/troubleshooting.md §5 for 1Password / direnv / sops "
             "integration recipes."
         ),
     )
@@ -116,7 +116,7 @@ def _build_parser() -> argparse.ArgumentParser:
             "POSIX file mode (0600 expected), .gitignore coverage, "
             "and git-tracking state. Bare `--check-env` (no PATH) "
             "looks for `./.env` then `~/.coderouter/.env`. "
-            "See docs/troubleshooting.md §5 for the threat model."
+            "See docs/guides/troubleshooting.md §5 for the threat model."
         ),
     )
     doctor.add_argument(
@@ -699,8 +699,8 @@ def _run_replay(args: argparse.Namespace) -> int:
     if getattr(args, "suggest_rules", False):
         # P1-6: statistical rule suggestion mode.
         # Always compute a full window summary (ignores --compare / --provider).
-        from coderouter.state.suggest_rules import format_suggestions, suggest_rules
         from coderouter.state.replay import summarize_window as _sw
+        from coderouter.state.suggest_rules import format_suggestions, suggest_rules
 
         # Re-read without provider filter so we see all providers.
         all_entries = read_request_log(log_path, since=args.since)

{coderouter_cli-2.4.0 → coderouter_cli-2.5.1}/coderouter/config/capability_registry.py

@@ -109,7 +109,7 @@ class RegistryCapabilities(BaseModel):
             "harness. ``degraded`` = the model over-eagerly invokes "
             "tools/skills when given Claude Code's system prompt — e.g. "
             "Llama-3.3-70B treating small talk like ``こんにちは`` as "
-            "``Skill(hello)`` invocations (see docs/troubleshooting.md "
+            "``Skill(hello)`` invocations (see docs/guides/troubleshooting.md "
             "§4-1 for the symptom log). ``ok`` = explicitly verified "
             "clean. ``None`` = no opinion (treated as ``ok`` at the "
             "startup check)."

{coderouter_cli-2.4.0 → coderouter_cli-2.5.1}/coderouter/config/schemas.py

@@ -874,6 +874,130 @@ class AutoRouterConfig(BaseModel):
     )
 
 
+class LauncherBackendConfig(BaseModel):
+    """Per-backend binary path configuration for the Launcher.
+
+    When ``binary`` is unset, the Launcher falls back to the default
+    executable name (``llama-server`` for llama.cpp, ``python`` for vllm)
+    and relies on ``$PATH`` resolution — which works when the tool is
+    globally installed.  Set ``binary`` when:
+
+    - llama.cpp was built from source (e.g. ``~/llama.cpp/build/bin/llama-server``)
+    - vllm lives in a virtualenv (e.g. ``~/.venv/bin/python``)
+    - Multiple builds coexist and you want to pin a specific one
+
+    Tilde (``~``) and environment variables are expanded at launch time.
+
+    Example::
+
+        backends:
+          llama.cpp:
+            binary: ~/llama.cpp/build/bin/llama-server
+          vllm:
+            binary: ~/.venv/bin/python
+    """
+
+    model_config = ConfigDict(extra="forbid")
+
+    binary: str | None = Field(
+        default=None,
+        description=(
+            "Absolute or ``~``-relative path to the backend executable. "
+            "llama.cpp default: ``llama-server`` (PATH). "
+            "vllm default: ``python`` (PATH). "
+            "Expanded at launch time."
+        ),
+    )
+
+
+class LauncherOptionProfile(BaseModel):
+    """One named option preset for a launcher backend (e.g. llama.cpp / vllm).
+
+    ``args`` maps CLI flag strings to their values.  A bool value of
+    ``True`` means "include the flag without a value" (e.g. ``--no-mmap``);
+    ``False`` means "omit the flag entirely".  All other value types are
+    converted to strings and appended as ``--flag value`` pairs.
+
+    Example::
+
+        name: "GPU速度重視"
+        args:
+          "-ngl": 99
+          "--ctx-size": 4096
+          "--no-mmap": false
+    """
+
+    model_config = ConfigDict(extra="forbid")
+
+    name: str = Field(..., description="Display name shown in the Launcher UI dropdown.")
+    args: dict[str, str | int | float | bool] = Field(
+        default_factory=dict,
+        description=(
+            "CLI flag → value mapping. "
+            "bool True = flag only (no value). "
+            "bool False = omit flag. "
+            "All other types are stringified and passed as '--flag value'."
+        ),
+    )
+
+
+class LauncherConfig(BaseModel):
+    """The ``launcher:`` block in providers.yaml.
+
+    Controls the Launcher UI available at ``/launcher``.
+
+    Example::
+
+        launcher:
+          model_dirs:
+            - ~/models
+            - /data/gguf
+          option_profiles:
+            llama.cpp:
+              - name: "GPU速度重視"
+                args:
+                  "-ngl": 99
+                  "--ctx-size": 4096
+            vllm:
+              - name: "標準"
+                args:
+                  "--dtype": "auto"
+                  "--max-model-len": 4096
+    """
+
+    model_config = ConfigDict(extra="forbid")
+
+    model_dirs: list[str] = Field(
+        default_factory=list,
+        description=(
+            "Directories to scan for model files "
+            "(.gguf, .safetensors, .bin, .pt, .ggml). "
+            "Paths are expanded (~ and env vars) at scan time, not at load. "
+            "Non-existent paths are silently skipped."
+        ),
+    )
+    backends: dict[str, LauncherBackendConfig] = Field(
+        default_factory=dict,
+        description=(
+            "Per-backend binary path overrides. "
+            "Keys are backend names ('llama.cpp', 'vllm'). "
+            "When a key is absent, the default executable is used "
+            "('llama-server' / 'python') and resolved via PATH. "
+            "Useful when running a from-source build or a venv-specific binary."
+        ),
+    )
+    option_profiles: dict[str, list[LauncherOptionProfile]] = Field(
+        default_factory=dict,
+        description=(
+            "Named option presets per backend. "
+            "Keys should be backend names: 'llama.cpp', 'vllm'. "
+            "Each key maps to an ordered list of named presets. "
+            "A free-form 'extra args' field is always available in the UI "
+            "for one-off overrides without touching this config."
+        ),
+    )
+
+
 class PluginsConfig(BaseModel):
     """The ``plugins:`` block in providers.yaml (v2.3.0).
 
@@ -1082,6 +1206,17 @@ class CodeRouterConfig(BaseModel):
             "plugins (zero-cost, backward-compatible default)."
         ),
     )
+    launcher: LauncherConfig | None = Field(
+        default=None,
+        description=(
+            "Launcher configuration for the /launcher UI. "
+            "Defines model_dirs to scan and option_profiles per backend "
+            "('llama.cpp', 'vllm'). "
+            "Unset (None) = Launcher UI shows empty model list and no profiles. "
+            "The Launcher UI itself is always available at /launcher "
+            "regardless of this setting."
+        ),
+    )
 
     @model_validator(mode="after")
     def _check_default_profile_exists(self) -> CodeRouterConfig: