coderouter-cli 2.1.0__py3-none-any.whl → 2.2.0__py3-none-any.whl

coderouter/state/request_log.py

@@ -0,0 +1,178 @@
+"""Request journal for replay analysis (v2.0-K Replay framework).
+
+Records per-request metadata (provider, model, profile, token counts,
+latency, cost, stop_reason) as append-only JSONL.  The request/response
+body is NOT recorded (privacy + size).
+
+Architecture
+============
+
+Implements ``logging.Handler`` and captures ``cache-observed`` events
+(one per successful request, carrying token counts + cost) paired with
+timing data computed from ``try-provider`` → ``provider-ok`` deltas.
+
+The engine emits these events in sequence::
+
+    try-provider  → provider (name), stream (bool)
+    provider-ok   → provider (name), stream (bool)
+    cache-observed→ provider, input_tokens, output_tokens, cost_usd, ...
+
+The handler captures ``cache-observed`` as the authoritative "request
+completed" signal (it fires exactly once per successful response and
+carries the richest payload).
+
+File rotation
+=============
+
+Same single-backup rotation as :class:`AuditLogHandler`: when the
+active file exceeds ``max_bytes``, rename to ``.1`` and start fresh.
+"""
+
+from __future__ import annotations
+
+import json
+import logging
+from datetime import UTC, datetime
+from pathlib import Path
+
+# Events to capture for the request journal.
+_JOURNAL_EVENTS: frozenset[str] = frozenset({"cache-observed"})
+
+
+class RequestLogHandler(logging.Handler):
+    """Append-only JSONL handler for request metadata.
+
+    Each line records one successful request's metadata (provider,
+    tokens, cost, streaming flag).  Failed requests are not recorded
+    — only requests that produced a response.
+    """
+
+    def __init__(
+        self,
+        log_path: str | Path,
+        *,
+        max_bytes: int = 52_428_800,  # 50 MiB default
+    ) -> None:
+        super().__init__(level=logging.DEBUG)
+        self._log_path = Path(log_path)
+        self._max_bytes = max_bytes
+        self._log_path.parent.mkdir(parents=True, exist_ok=True)
+        self._file = open(self._log_path, "a", encoding="utf-8")  # noqa: SIM115
+
+    def emit(self, record: logging.LogRecord) -> None:
+        """Write a journal line for cache-observed events."""
+        if record.msg not in _JOURNAL_EVENTS:
+            return
+        try:
+            self.acquire()
+            try:
+                line = self._format_line(record)
+                self._file.write(line)
+                self._file.flush()
+                self._maybe_rotate()
+            finally:
+                self.release()
+        except Exception:
+            self.handleError(record)
+
+    def close(self) -> None:
+        """Flush and close the underlying file."""
+        self.acquire()
+        try:
+            if self._file and not self._file.closed:
+                self._file.flush()
+                self._file.close()
+        finally:
+            self.release()
+        super().close()
+
+    # ------------------------------------------------------------------
+    # Internals
+    # ------------------------------------------------------------------
+
+    def _format_line(self, record: logging.LogRecord) -> str:
+        """Build a journal JSONL line from a cache-observed log record."""
+        payload: dict[str, object] = {
+            "ts": datetime.now(UTC).isoformat(),
+            "provider": getattr(record, "provider", None),
+            "input_tokens": getattr(record, "input_tokens", 0),
+            "output_tokens": getattr(record, "output_tokens", 0),
+            "cost_usd": getattr(record, "cost_usd", 0.0),
+            "cost_savings_usd": getattr(record, "cost_savings_usd", 0.0),
+            "streaming": getattr(record, "streaming", False),
+            "cache_read_input_tokens": getattr(record, "cache_read_input_tokens", 0),
+            "cache_creation_input_tokens": getattr(record, "cache_creation_input_tokens", 0),
+            "outcome": getattr(record, "outcome", "unknown"),
+        }
+        return json.dumps(payload, default=str) + "\n"
+
+    def _maybe_rotate(self) -> None:
+        """Rotate if the current file exceeds max_bytes."""
+        try:
+            size = self._file.tell()
+            if size < self._max_bytes:
+                return
+            self._file.close()
+            backup = self._log_path.with_suffix(".jsonl.1")
+            if backup.exists():
+                backup.unlink()
+            self._log_path.rename(backup)
+            self._file = open(self._log_path, "a", encoding="utf-8")  # noqa: SIM115
+        except OSError:
+            if self._file.closed:
+                self._file = open(self._log_path, "a", encoding="utf-8")  # noqa: SIM115
+
+
+def read_request_log(
+    log_path: str | Path,
+    *,
+    tail: int | None = None,
+    provider_filter: str | None = None,
+    since: str | None = None,
+) -> list[dict[str, object]]:
+    """Read and filter request journal entries.
+
+    Parameters:
+
+    - ``tail`` — return only the last N entries.
+    - ``provider_filter`` — only entries matching this provider name
+      (exact, case-insensitive).
+    - ``since`` — only entries with ``ts >= since`` (ISO 8601 prefix).
+
+    Returns a list of parsed dicts, oldest first.
+    """
+    path = Path(log_path)
+    if not path.exists():
+        return []
+
+    entries: list[dict[str, object]] = []
+    with open(path, encoding="utf-8") as f:
+        for line in f:
+            line = line.strip()
+            if not line:
+                continue
+            try:
+                entry = json.loads(line)
+            except json.JSONDecodeError:
+                continue
+
+            if provider_filter and str(entry.get("provider", "")).lower() != provider_filter.lower():
+                continue
+
+            if since:
+                ts = str(entry.get("ts", ""))
+                if ts < since:
+                    continue
+
+            entries.append(entry)
+
+    if tail is not None and tail > 0:
+        entries = entries[-tail:]
+
+    return entries
+
+
+__all__ = [
+    "RequestLogHandler",
+    "read_request_log",
+]

coderouter/state/store.py

@@ -0,0 +1,212 @@
+"""Persistent KV store backed by sqlite3 (v2.0-K).
+
+Provides durable cross-restart storage for operational metadata:
+budget totals, backend health state, self-healing exclusions, and
+metrics counters.
+
+Design choices
+==============
+
+- **sqlite3 stdlib** — zero new dependencies, matching the 5-deps
+  invariant.  WAL mode for concurrent readers + single writer.
+- **Namespace-scoped keys** — each subsystem (budget, health, metrics,
+  self_healing) gets its own namespace, so ``store.get("budget",
+  "totals")`` won't collide with ``store.get("health", "totals")``.
+- **JSON values** — all values are serialized as JSON strings. This
+  keeps the schema trivial (one table) while letting subsystems store
+  arbitrary structured data.
+- **Thread-safe** — sqlite3 in WAL mode + ``check_same_thread=False``
+  is safe for the multi-thread (asyncio + thread pool) pattern
+  CodeRouter uses.
+- **Graceful degradation** — if the database can't be opened or
+  written, errors are logged but never raised to callers. State
+  persistence is a best-effort enhancement, not a correctness
+  requirement.
+
+Schema::
+
+    CREATE TABLE IF NOT EXISTS kv (
+        namespace TEXT NOT NULL,
+        key       TEXT NOT NULL,
+        value     TEXT NOT NULL,
+        updated_at TEXT NOT NULL,
+        PRIMARY KEY (namespace, key)
+    );
+"""
+
+from __future__ import annotations
+
+import contextlib
+import json
+import sqlite3
+import threading
+from datetime import UTC, datetime
+from pathlib import Path
+
+from coderouter.logging import get_logger
+
+logger = get_logger(__name__)
+
+
+class StateStore:
+    """Persistent KV store for operational metadata.
+
+    Public API:
+
+    - :meth:`get(namespace, key)` — retrieve a JSON-decoded value,
+      or None if not found.
+    - :meth:`put(namespace, key, value)` — upsert a JSON-encoded value.
+    - :meth:`delete(namespace, key)` — remove a key.
+    - :meth:`get_all(namespace)` — retrieve all key-value pairs in a
+      namespace as a dict.
+    - :meth:`clear(namespace)` — remove all keys in a namespace.
+    - :meth:`close()` — close the database connection.
+    """
+
+    def __init__(self, db_path: str | Path) -> None:
+        self._db_path = Path(db_path)
+        self._lock = threading.Lock()
+        self._conn: sqlite3.Connection | None = None
+        self._init_db()
+
+    def _init_db(self) -> None:
+        """Create the database and table if they don't exist."""
+        try:
+            self._db_path.parent.mkdir(parents=True, exist_ok=True)
+            conn = sqlite3.connect(
+                str(self._db_path),
+                check_same_thread=False,
+                timeout=5.0,
+            )
+            conn.execute("PRAGMA journal_mode=WAL")
+            conn.execute("PRAGMA synchronous=NORMAL")
+            conn.execute(
+                """
+                CREATE TABLE IF NOT EXISTS kv (
+                    namespace TEXT NOT NULL,
+                    key       TEXT NOT NULL,
+                    value     TEXT NOT NULL,
+                    updated_at TEXT NOT NULL,
+                    PRIMARY KEY (namespace, key)
+                )
+                """
+            )
+            conn.commit()
+            self._conn = conn
+        except (OSError, sqlite3.Error) as exc:
+            logger.warning(
+                "state-store-init-failed",
+                extra={"error": str(exc), "db_path": str(self._db_path)},
+            )
+            self._conn = None
+
+    # ------------------------------------------------------------------
+    # Public API
+    # ------------------------------------------------------------------
+
+    def get(self, namespace: str, key: str) -> object | None:
+        """Retrieve a value by namespace+key, or None if not found."""
+        if self._conn is None:
+            return None
+        try:
+            with self._lock:
+                row = self._conn.execute(
+                    "SELECT value FROM kv WHERE namespace = ? AND key = ?",
+                    (namespace, key),
+                ).fetchone()
+            if row is None:
+                return None
+            return json.loads(row[0])
+        except (sqlite3.Error, json.JSONDecodeError) as exc:
+            logger.warning(
+                "state-store-get-failed",
+                extra={"namespace": namespace, "key": key, "error": str(exc)},
+            )
+            return None
+
+    def put(self, namespace: str, key: str, value: object) -> None:
+        """Upsert a value (JSON-serialized)."""
+        if self._conn is None:
+            return
+        try:
+            now = datetime.now(UTC).isoformat()
+            value_json = json.dumps(value, default=str)
+            with self._lock:
+                self._conn.execute(
+                    """
+                    INSERT INTO kv (namespace, key, value, updated_at)
+                    VALUES (?, ?, ?, ?)
+                    ON CONFLICT(namespace, key)
+                    DO UPDATE SET value = excluded.value,
+                                  updated_at = excluded.updated_at
+                    """,
+                    (namespace, key, value_json, now),
+                )
+                self._conn.commit()
+        except (sqlite3.Error, TypeError) as exc:
+            logger.warning(
+                "state-store-put-failed",
+                extra={"namespace": namespace, "key": key, "error": str(exc)},
+            )
+
+    def delete(self, namespace: str, key: str) -> None:
+        """Remove a key from the store."""
+        if self._conn is None:
+            return
+        try:
+            with self._lock:
+                self._conn.execute(
+                    "DELETE FROM kv WHERE namespace = ? AND key = ?",
+                    (namespace, key),
+                )
+                self._conn.commit()
+        except sqlite3.Error as exc:
+            logger.warning(
+                "state-store-delete-failed",
+                extra={"namespace": namespace, "key": key, "error": str(exc)},
+            )
+
+    def get_all(self, namespace: str) -> dict[str, object]:
+        """Return all key-value pairs in a namespace."""
+        if self._conn is None:
+            return {}
+        try:
+            with self._lock:
+                rows = self._conn.execute(
+                    "SELECT key, value FROM kv WHERE namespace = ?",
+                    (namespace,),
+                ).fetchall()
+            return {row[0]: json.loads(row[1]) for row in rows}
+        except (sqlite3.Error, json.JSONDecodeError) as exc:
+            logger.warning(
+                "state-store-get-all-failed",
+                extra={"namespace": namespace, "error": str(exc)},
+            )
+            return {}
+
+    def clear(self, namespace: str) -> None:
+        """Remove all keys in a namespace."""
+        if self._conn is None:
+            return
+        try:
+            with self._lock:
+                self._conn.execute(
+                    "DELETE FROM kv WHERE namespace = ?",
+                    (namespace,),
+                )
+                self._conn.commit()
+        except sqlite3.Error as exc:
+            logger.warning(
+                "state-store-clear-failed",
+                extra={"namespace": namespace, "error": str(exc)},
+            )
+
+    def close(self) -> None:
+        """Close the database connection."""
+        if self._conn is not None:
+            with contextlib.suppress(sqlite3.Error):
+                self._conn.close()
+            self._conn = None
+
+
+__all__ = ["StateStore"]

coderouter/translation/tool_repair.py

@@ -41,7 +41,7 @@ import re
 import uuid
 from typing import Any
 
-__all__ = ["repair_tool_calls_in_text"]
+__all__ = ["deduplicate_tool_calls", "repair_tool_calls_in_text"]
 
 
 # ------------------------------------------------------------------
@@ -233,4 +233,45 @@ def repair_tool_calls_in_text(
     cleaned = re.sub(r"[ \t]+\n", "\n", cleaned)
     cleaned = re.sub(r"\n{3,}", "\n\n", cleaned).strip()
 
+    # v2.2: deduplicate tool calls within the same response.
+    # Small models sometimes output the same tool-call JSON 2-3 times
+    # in a single turn. We keep the first occurrence only.
+    extracted = deduplicate_tool_calls(extracted)
+
     return cleaned, extracted
+
+
+# ------------------------------------------------------------------
+# Deduplication (v2.2)
+# ------------------------------------------------------------------
+
+
+def deduplicate_tool_calls(tool_calls: list[dict[str, Any]]) -> list[dict[str, Any]]:
+    """Remove duplicate tool calls sharing the same (name, arguments).
+
+    Preserves order — the first occurrence wins. Each entry is expected
+    to be in OpenAI tool_calls shape (``{"function": {"name": ...,
+    "arguments": ...}, ...}``). Entries that lack the expected
+    structure are kept unconditionally (conservative fallback).
+
+    This is separate from L3 tool-loop detection (which operates across
+    turns in the conversation history). Deduplication operates within a
+    single assistant response where the model outputted the same JSON
+    tool-call block multiple times.
+    """
+    if len(tool_calls) <= 1:
+        return tool_calls
+
+    seen: set[tuple[str, str]] = set()
+    deduped: list[dict[str, Any]] = []
+    for tc in tool_calls:
+        func = tc.get("function")
+        if not isinstance(func, dict):
+            # Not in expected shape — keep unconditionally.
+            deduped.append(tc)
+            continue
+        key = (func.get("name", ""), func.get("arguments", ""))
+        if key not in seen:
+            seen.add(key)
+            deduped.append(tc)
+    return deduped

coderouter_cli-2.2.0.dist-info/METADATA

@@ -0,0 +1,243 @@
+Metadata-Version: 2.4
+Name: coderouter-cli
+Version: 2.2.0
+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
+Project-URL: Issues, https://github.com/zephel01/CodeRouter/issues
+Project-URL: Changelog, https://github.com/zephel01/CodeRouter/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://github.com/zephel01/CodeRouter#documentation
+Author-email: zephel01 <zephel01@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: claude,claude-code,fallback,llm,local-first,nvidia-nim,ollama,openai,openrouter,router
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Networking
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.9.0
+Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: uvicorn[standard]>=0.32.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.13.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.32.0; extra == 'dev'
+Requires-Dist: pytest>=8.3.0; extra == 'dev'
+Requires-Dist: ruamel-yaml>=0.18.6; extra == 'dev'
+Requires-Dist: ruff>=0.7.0; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0.12; extra == 'dev'
+Provides-Extra: doctor
+Requires-Dist: ruamel-yaml>=0.18.6; extra == 'doctor'
+Description-Content-Type: text/markdown
+
+<h1 align="center">CodeRouter</h1>
+
+<p align="center">
+  <strong>ローカル LLM で Claude Code を動かすと壊れる問題、<br>ルーター 1 つで直します。</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/zephel01/CodeRouter/actions/workflows/ci.yml"><img src="https://github.com/zephel01/CodeRouter/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI"></a>
+  <a href=""><img src="https://img.shields.io/badge/version-2.2.0-blue" alt="version"></a>
+  <a href=""><img src="https://img.shields.io/badge/python-3.12%2B-blue" alt="python"></a>
+  <a href=""><img src="https://img.shields.io/badge/deps-5-brightgreen" alt="deps"></a>
+  <a href=""><img src="https://img.shields.io/badge/license-MIT-yellow" alt="license"></a>
+</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>
+</p>
+
+---
+
+## 何ができるか — 30 秒で
+
+```
+あなたのエージェント (Claude Code / gemini-cli / codex)
+        │
+        ▼
+  ┌─ CodeRouter ─┐
+  │  翻訳 + 修復  │──→  ① ローカル (Ollama — 無料・最速)
+  │  ガード + 監視 │──→  ② 無料クラウド (OpenRouter / NIM)
+  │  自動フォールバック │──→  ③ 有料 (Claude — opt-in 時のみ)
+  └──────────────┘
+```
+
+**やってくれること:**
+
+- ローカルモデルが壊した tool calling を Claude Code に届く前に修復する
+- 1 つ目が落ちたら自動で次のプロバイダに切り替える
+- 有料 API は明示的に許可したときだけ使う (デフォルトは無料のみ)
+- 8 時間回しても止まらないように 6 種類のガードで守る
+- 何がおかしいか `coderouter doctor` コマンド一発で診断する
+
+---
+
+## インストール (3 行)
+
+```bash
+# 1. サンプル設定を置く
+mkdir -p ~/.coderouter
+curl -fsSL https://raw.githubusercontent.com/zephel01/CodeRouter/main/examples/providers.yaml \
+  > ~/.coderouter/providers.yaml
+
+# 2. 起動 (Python 3.12+)
+uvx --from coderouter-cli coderouter serve --port 8088
+```
+
+恒久インストールしたい場合: `uv tool install coderouter-cli`
+
+---
+
+## Claude Code で使う
+
+```bash
+# ターミナル 1
+coderouter serve --port 8088
+
+# ターミナル 2
+ANTHROPIC_BASE_URL=http://localhost:8088 ANTHROPIC_AUTH_TOKEN=dummy claude
+```
+
+これだけ。Claude Code はいつも通り動きますが、裏ではローカルの Ollama が答えています。
+
+---
+
+## 自分に必要？
+
+| あなたの状況 | CodeRouter は？ |
+|---|---|
+| Claude Code + ローカル Ollama で tool calling が壊れる | **必須** — wire 変換 + tool 修復 |
+| Claude Code + ローカルで長時間回すと止まる | **便利** — 6 系統ガード + self-healing |
+| codex / gemini-cli + Ollama 直繋ぎで動いてる | オプション — フォールバックが欲しいなら |
+| Claude API を直接叩いてて問題ない | 不要 |
+
+詳細は → [要否判定ガイド](./docs/when-do-i-need-coderouter.md)
+
+---
+
+## 主な機能
+
+### 接続と修復
+
+| 機能 | 何をしてくれるか |
+|---|---|
+| **Wire 翻訳** | Claude Code (Anthropic形式) ↔ Ollama (OpenAI形式) を自動変換 |
+| **Tool-call 修復** | ローカルモデルがテキストで吐いた JSON を正しい tool_use ブロックに復元 |
+| **3 層フォールバック** | ローカル → 無料クラウド → 有料の順に自動切替 |
+| **出力フィルタ** | `<think>` タグ漏れ、stop marker 漏れを自動除去 |
+
+### 長時間運用ガード
+
+| ガード | 何から守るか |
+|---|---|
+| **Context Budget** | メッセージが溜まりすぎて context window 溢れ → 自動 trim |
+| **Drift Detection** | モデルの応答品質が徐々に劣化 → 別 provider に切替 or KV cache flush |
+| **Self-healing** | backend が落ちた → 自動除外 + restart + 回復 probe で自動復帰 |
+| **Tool Loop Guard** | 同じツールを無限に呼び続ける → 検知して停止 |
+| **Memory Pressure** | GPU メモリ不足を検知 → 軽量モデルに切替 |
+| **Mid-stream Guard** | 応答途中で落ちた → 溜まったテキストを安全に返却 |
+
+### 診断と可視化
+
+| 機能 | 何がわかるか |
+|---|---|
+| **`coderouter doctor`** | プロバイダの問題を 6 プローブで即診断 + 修正パッチ出力 |
+| **`/dashboard`** | ブラウザで今何が起きてるかリアルタイム確認 |
+| **`coderouter audit`** | guard 発火履歴を検索 |
+| **`coderouter replay`** | provider 切替の効果を統計比較 (A/B 分析) |
+| **Continuous Probe** | idle 時も定期的に backend を監視 |
+
+---
+
+## 設定例 (最小)
+
+```yaml
+# ~/.coderouter/providers.yaml
+default_profile: claude-code
+
+profiles:
+  - name: claude-code
+    providers: [ollama-local, openrouter-free]
+
+providers:
+  - name: ollama-local
+    kind: openai_compat
+    base_url: http://localhost:11434/v1
+    model: qwen3-coder:7b
+
+  - name: openrouter-free
+    kind: openai_compat
+    base_url: https://openrouter.ai/api/v1
+    model: qwen/qwen3-coder:free
+    api_key_env: OPENROUTER_API_KEY
+```
+
+もっと詳しい設定 → [利用ガイド](./docs/usage-guide.md) · [設計詳細](./docs/architecture.md)
+
+---
+
+## ドキュメント
+
+| やりたいこと | ドキュメント |
+|---|---|
+| すぐ動かす | [Quickstart](./docs/quickstart.md) |
+| 使いこなす | [利用ガイド](./docs/usage-guide.md) |
+| 無料で回す | [無料枠ガイド](./docs/free-tier-guide.md) |
+| 詰まった | [トラブルシューティング](./docs/troubleshooting.md) |
+| 設計を知りたい | [アーキテクチャ詳細](./docs/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)
+
+---
+
+## トラブルシューティング (早見表)
+
+**まず**: `coderouter doctor --check-model <provider名>` を走らせてください。大体これで原因がわかります。
+
+| 症状 | 原因 | 詳細 |
+|---|---|---|
+| 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-追加) |
+
+`http://localhost:8088/dashboard` を開いておくと、ほとんどの問題が見て 10 秒でわかります。
+
+---
+
+## 技術スペック
+
+- **ランタイム依存**: `fastapi` / `uvicorn` / `httpx` / `pydantic` / `pyyaml` の 5 個のみ
+- **テスト**: 964 本 (41 sub-release 連続で依存追加なし)
+- **対応 OS**: macOS (Apple Silicon 推奨) / Linux / Windows WSL2
+- **対応 backend**: Ollama / llama.cpp / LM Studio / vLLM / MLX-LM / OpenRouter / NVIDIA NIM / Anthropic API
+- **ライセンス**: MIT
+
+---
+
+## エコシステム
+
+CodeRouter は backend ルーター層として独立して動きます。`OPENAI_BASE_URL` を CodeRouter に向けるだけで、他プロジェクトを無改造で吸収:
+
+- **[Voice Bridge](https://github.com/zephel01/voice-bridge)** — リアルタイム音声翻訳 + AI 音声チャット。CodeRouter 経由でローカル LLM のフォールバックを効かせると、ずんだもんが沈黙しなくなる
+
+---
+
+## Security
+
+シークレットは環境変数に置きます。[`docs/security.md`](./docs/security.md) に完全な方針と報告手順があります。
+
+## License
+
+MIT