coderouter-cli 2.9.4__py3-none-any.whl → 2.10.0__py3-none-any.whl

coderouter/cli.py

@@ -336,6 +336,78 @@ def _build_parser() -> argparse.ArgumentParser:
         ),
     )
 
+    # v2.10-A: `coderouter vscode-init` — scaffold a VSCode workspace so
+    # Claude Code launched from the integrated terminal auto-points at
+    # CodeRouter (no manual env-var juggling). Optionally writes .envrc
+    # for direnv users. Cline / Roo / Continue are covered by the cheat
+    # sheet printed on completion and docs/guides/vscode.md — this
+    # command deliberately does NOT touch those extensions' settings
+    # (their schemas change with their own release cadence).
+    vscode_init = sub.add_parser(
+        "vscode-init",
+        help="Scaffold VSCode workspace settings for CodeRouter (v2.10-A).",
+        description=(
+            "Write .vscode/settings.json (terminal.integrated.env.*) so a "
+            "Claude Code session launched from VSCode's integrated terminal "
+            "auto-points at CodeRouter. Optionally emit a direnv .envrc. "
+            "Idempotent: safe to re-run. Conflict-aware: refuses to overwrite "
+            "differing existing values without --force."
+        ),
+    )
+    vscode_init.add_argument(
+        "--target",
+        default=".",
+        metavar="PATH",
+        help="Workspace root (default: current directory).",
+    )
+    vscode_init.add_argument(
+        "--port",
+        type=int,
+        default=None,
+        metavar="PORT",
+        help=(
+            "CodeRouter port for ANTHROPIC_BASE_URL. Defaults to 8088 "
+            "(matches every docs / quickstart example). Note that "
+            "`coderouter serve` alone defaults to 4000; if you serve on "
+            "4000, pass --port 4000 here too."
+        ),
+    )
+    vscode_init.add_argument(
+        "--profile",
+        default=None,
+        metavar="NAME",
+        help=(
+            "Preload CODEROUTER_MODE=<profile> so the VSCode terminal "
+            "routes to a non-default profile without a per-request header."
+        ),
+    )
+    vscode_init.add_argument(
+        "--with-envrc",
+        action="store_true",
+        help=(
+            "Also write .envrc (direnv). Run `direnv allow` once after "
+            "generation. Tip: keep secrets in a separate .envrc.local."
+        ),
+    )
+    vscode_init.add_argument(
+        "--dry-run",
+        action="store_true",
+        help=(
+            "Compute all changes and print unified diffs, but do not write "
+            "any files. Byte-identical to the write path minus the final "
+            "os.replace."
+        ),
+    )
+    vscode_init.add_argument(
+        "--force",
+        action="store_true",
+        help=(
+            "Overwrite existing conflicting values. Without this flag, a "
+            "conflict is reported with a diff and the file is left "
+            "untouched (exit 2)."
+        ),
+    )
+
     return parser
 
 
@@ -432,6 +504,9 @@ def main(argv: list[str] | None = None) -> int:
     if args.command == "replay":
         return _run_replay(args)
 
+    if args.command == "vscode-init":
+        return _run_vscode_init(args)
+
     print(f"unknown command: {args.command}", file=sys.stderr)
     return 2
 
@@ -765,6 +840,56 @@ def _run_replay(args: argparse.Namespace) -> int:
     return 0
 
 
+def _run_vscode_init(args: argparse.Namespace) -> int:
+    """v2.10-A: drive :func:`coderouter.vscode_init.run_vscode_init`.
+
+    Kept small and testable — the actual scaffolding logic lives in
+    :mod:`coderouter.vscode_init` so tests can exercise it without
+    argparse in the way. This wrapper's job is:
+
+    * resolve the ``--target`` argument to a real directory
+    * map ``--port`` (default None) to the module's ``DEFAULT_PORT``
+    * translate exceptions (missing target directory) to a friendly
+      stderr message + exit 1
+    * print the formatted result and propagate the module's exit code
+    """
+    from coderouter.vscode_init import (
+        DEFAULT_PORT,
+        exit_code_for,
+        format_result,
+        run_vscode_init,
+    )
+
+    target = Path(args.target).expanduser()
+    if not target.is_dir():
+        print(
+            f"vscode-init: target directory does not exist: {target}",
+            file=sys.stderr,
+        )
+        return 1
+
+    port = args.port if args.port is not None else DEFAULT_PORT
+
+    try:
+        result = run_vscode_init(
+            target,
+            port=port,
+            profile=args.profile,
+            with_envrc=args.with_envrc,
+            dry_run=args.dry_run,
+            force=args.force,
+        )
+    except FileNotFoundError as exc:
+        # Raised only when target vanishes between the pre-check above
+        # and the module's own check — unlikely in practice, but map
+        # it to the same shape as the pre-check for consistency.
+        print(f"vscode-init: {exc}", file=sys.stderr)
+        return 1
+
+    print(format_result(result, dry_run=args.dry_run, port=port))
+    return exit_code_for(result)
+
+
 def _run_check_env(arg_value: str) -> int:
     """v1.6.3: filesystem / git security checks for `.env`.
 

coderouter/config/schemas.py

@@ -394,7 +394,7 @@ class ProviderConfig(BaseModel):
         default=False,
         description="If true, only used when ALLOW_PAID=true (plan.md §2.3).",
     )
-    timeout_s: float = Field(default=30.0, ge=1.0, le=600.0)
+    timeout_s: float = Field(default=30.0, ge=1.0, le=86400.0)
 
     # v2.6 language-tax track: path to a LOCAL ``tokenizer.json`` for this
     # provider's model, used to measure the CJK over-count vs the char/4

coderouter/vscode_init.py

@@ -0,0 +1,573 @@
+"""v2.10-A: ``coderouter vscode-init`` — one-shot VSCode workspace scaffolder.
+
+Writes ``.vscode/settings.json`` with ``terminal.integrated.env.*`` so a
+Claude Code session launched from VSCode's integrated terminal
+auto-points at CodeRouter. Optionally emits a direnv ``.envrc`` in the
+same run.
+
+The design contract:
+
+* stdlib only — no new runtime deps (keeps the strict-5 rule in
+  ``pyproject.toml`` intact).
+* Never overwrite unrelated keys in an existing ``settings.json``. Only
+  ``terminal.integrated.env.osx`` / ``.linux`` / ``.windows`` are
+  touched, and inside them only the CodeRouter-managed env vars.
+* When an existing target value differs from the desired one, refuse
+  without ``--force`` and print a unified diff so the operator decides.
+* ``--dry-run`` is byte-identical to the write path minus the actual
+  ``os.replace`` at the end.
+* All writes are atomic (tmp file + ``os.replace``) so a partial write
+  cannot corrupt an existing ``settings.json``. This matters more here
+  than in most CodeRouter modules because the file we're editing is
+  workspace-critical: a broken JSON blob would silently break every
+  VSCode terminal env until a human debugged it.
+
+Files touched (opt-in per flag):
+
+* ``{target}/.vscode/settings.json`` — always
+* ``{target}/.envrc``                 — ``--with-envrc``
+
+Non-Claude-Code extensions (Cline / Roo / Kilo / Continue) are handled
+by the cheat sheet printed to stdout at end of run and the fuller
+``docs/guides/vscode.md`` — this CLI deliberately does NOT reach into
+those extensions' settings, because each ships its own config schema
+that changes with its own release cadence.
+
+CLI plumbing lives in :mod:`coderouter.cli` (``_run_vscode_init``); this
+module is import-clean so tests can exercise ``run_vscode_init``
+directly without argparse in the way.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+from dataclasses import dataclass
+from difflib import unified_diff
+from pathlib import Path
+
+# v2.10-A: The README, quickstart, and every backend guide teach 8088 as
+# the CodeRouter port. ``coderouter serve`` still defaults to 4000 (a
+# pre-README default that predates the docs unification); vscode-init
+# sides with the docs so that the settings.json it writes matches every
+# tutorial the user is likely to be reading. Operators who deviate can
+# pass ``--port`` explicitly.
+DEFAULT_PORT = 8088
+
+# Bogus token — CodeRouter's chat ingress does not validate ANTHROPIC_AUTH_TOKEN
+# (real API keys are managed on the ``providers.yaml`` side). Using a
+# fixed sentinel here means we never accidentally embed the operator's
+# real token into a workspace file.
+DEFAULT_TOKEN = "dummy"  # noqa: S105 — intentional placeholder, not a secret
+
+# VSCode reads terminal env from a separate key per host OS. Writing all
+# three means the same ``.vscode/`` folder works whether the developer
+# opens it on macOS, Linux, or WSL/Windows without a second scaffolder
+# run. The keys are stable across VSCode versions (documented public
+# API since 1.x).
+_TERMINAL_ENV_KEYS: tuple[str, ...] = (
+    "terminal.integrated.env.osx",
+    "terminal.integrated.env.linux",
+    "terminal.integrated.env.windows",
+)
+
+# Env vars this scaffolder owns inside the terminal-env blocks. Anything
+# NOT in this set that already exists under one of the terminal-env
+# keys is preserved verbatim on merge (e.g. the user's PATH tweak).
+_MANAGED_ENV_KEYS: tuple[str, ...] = (
+    "ANTHROPIC_BASE_URL",
+    "ANTHROPIC_AUTH_TOKEN",
+    "CODEROUTER_MODE",
+)
+
+
+@dataclass(frozen=True)
+class FileOutcome:
+    """The outcome of touching (or planning to touch) one file.
+
+    ``action`` values:
+
+    * ``created``   — file didn't exist, we wrote it
+    * ``updated``   — file existed, we changed it
+    * ``unchanged`` — file already had the desired content
+    * ``conflict``  — existing content differs and ``--force`` was
+                      not set; the file was NOT written
+    * ``skipped``   — hard error prevented processing (unparseable
+                      JSON, wrong type, permission denied); NOT written
+    """
+
+    path: Path
+    action: str
+    diff: str = ""
+    reason: str = ""
+
+
+@dataclass(frozen=True)
+class VSCodeInitResult:
+    outcomes: list[FileOutcome]
+
+    @property
+    def has_conflicts(self) -> bool:
+        return any(o.action == "conflict" for o in self.outcomes)
+
+    @property
+    def has_skipped(self) -> bool:
+        return any(o.action == "skipped" for o in self.outcomes)
+
+
+def run_vscode_init(
+    target: Path,
+    *,
+    port: int = DEFAULT_PORT,
+    profile: str | None = None,
+    with_envrc: bool = False,
+    dry_run: bool = False,
+    force: bool = False,
+) -> VSCodeInitResult:
+    """Scaffold VSCode workspace settings for CodeRouter.
+
+    Parameters
+    ----------
+    target:
+        Workspace root — the folder that VSCode opens. ``.vscode/`` and
+        (if ``with_envrc``) ``.envrc`` are placed under this directory.
+        Must already exist as a directory; we do not create the
+        workspace root itself.
+    port:
+        CodeRouter port for ``ANTHROPIC_BASE_URL``. Defaults to 8088
+        (docs-standard); override to match a non-default ``serve``.
+    profile:
+        Optional ``CODEROUTER_MODE`` value to preload. When set, the
+        VSCode terminal gets ``CODEROUTER_MODE=<profile>`` too.
+    with_envrc:
+        When true, also write ``.envrc`` (direnv). Idempotent and
+        conflict-aware just like ``settings.json``.
+    dry_run:
+        When true, compute all the outcomes and diffs but skip the
+        actual ``os.replace``. Guarantees byte-parity with the write
+        path — see the module docstring for the invariant.
+    force:
+        When true, existing conflicting values are overwritten. Without
+        this flag, a conflict is reported with a diff and the file is
+        left untouched.
+
+    Raises
+    ------
+    FileNotFoundError:
+        The target directory does not exist. All other issues (bad
+        JSON, permission denied, existing conflicts) are captured as
+        ``FileOutcome`` entries with the appropriate action.
+    """
+    target = Path(target).expanduser().resolve()
+    if not target.is_dir():
+        raise FileNotFoundError(f"target directory does not exist: {target}")
+
+    base_url = f"http://localhost:{port}"
+    outcomes: list[FileOutcome] = []
+
+    # 1. .vscode/settings.json (always).
+    outcomes.append(
+        _apply_settings_json(
+            target / ".vscode" / "settings.json",
+            base_url=base_url,
+            profile=profile,
+            force=force,
+            dry_run=dry_run,
+        )
+    )
+
+    # 2. .envrc (opt-in via --with-envrc).
+    if with_envrc:
+        outcomes.append(
+            _apply_envrc(
+                target / ".envrc",
+                base_url=base_url,
+                profile=profile,
+                force=force,
+                dry_run=dry_run,
+            )
+        )
+
+    return VSCodeInitResult(outcomes=outcomes)
+
+
+# ---------------------------------------------------------------------------
+# settings.json
+# ---------------------------------------------------------------------------
+
+
+def _apply_settings_json(
+    path: Path,
+    *,
+    base_url: str,
+    profile: str | None,
+    force: bool,
+    dry_run: bool,
+) -> FileOutcome:
+    desired_env: dict[str, str] = {
+        "ANTHROPIC_BASE_URL": base_url,
+        "ANTHROPIC_AUTH_TOKEN": DEFAULT_TOKEN,
+    }
+    if profile:
+        desired_env["CODEROUTER_MODE"] = profile
+
+    old_text = ""
+    if path.exists():
+        try:
+            old_text = path.read_text(encoding="utf-8")
+        except OSError as exc:
+            return FileOutcome(
+                path=path,
+                action="skipped",
+                reason=f"cannot read existing file: {exc}",
+            )
+        try:
+            existing = json.loads(old_text) if old_text.strip() else {}
+        except json.JSONDecodeError as exc:
+            return FileOutcome(
+                path=path,
+                action="skipped",
+                reason=(
+                    "existing settings.json is not valid JSON "
+                    f"({exc.msg} at line {exc.lineno}). Fix or move it "
+                    "aside and re-run."
+                ),
+            )
+        if not isinstance(existing, dict):
+            return FileOutcome(
+                path=path,
+                action="skipped",
+                reason=(
+                    "existing settings.json is not a JSON object "
+                    f"(got {type(existing).__name__}). Fix or move it "
+                    "aside and re-run."
+                ),
+            )
+    else:
+        existing = {}
+
+    merged, conflicts = _merge_terminal_env(existing, desired_env, force=force)
+
+    if conflicts and not force:
+        # Report the diff between existing and what --force WOULD write
+        # so the operator can decide whether the change is desired.
+        force_merged, _ = _merge_terminal_env(existing, desired_env, force=True)
+        diff = _json_diff(existing, force_merged, path)
+        return FileOutcome(
+            path=path,
+            action="conflict",
+            diff=diff,
+            reason=(
+                "existing settings.json has different value(s) for "
+                f"{', '.join(sorted(conflicts))}. Re-run with --force to overwrite."
+            ),
+        )
+
+    new_text = _dump_json(merged)
+    if new_text == old_text:
+        return FileOutcome(path=path, action="unchanged")
+
+    diff = _text_diff(old_text, new_text, path)
+    if not dry_run:
+        try:
+            path.parent.mkdir(parents=True, exist_ok=True)
+            _atomic_write(path, new_text)
+        except OSError as exc:
+            return FileOutcome(
+                path=path,
+                action="skipped",
+                reason=f"write failed: {exc}",
+                diff=diff,
+            )
+
+    return FileOutcome(
+        path=path,
+        action="updated" if old_text else "created",
+        diff=diff,
+    )
+
+
+def _merge_terminal_env(
+    existing: dict,
+    desired_env: dict[str, str],
+    *,
+    force: bool,
+) -> tuple[dict, set[str]]:
+    """Merge our env vars into a settings.json dict.
+
+    Preserves unrelated top-level keys (``editor.fontSize`` etc.) AND
+    unrelated env keys inside the three ``terminal.integrated.env.*``
+    blocks. When ``force`` is false, an existing conflicting value for
+    one of our managed keys is left in place and its dotted path
+    (e.g. ``terminal.integrated.env.osx.ANTHROPIC_BASE_URL``) is added
+    to the returned conflict set.
+
+    Returns
+    -------
+    merged:
+        The merged dict, safe to serialize with :func:`_dump_json`.
+    conflicts:
+        Set of dotted paths whose existing value differs from the
+        desired one and were NOT overwritten (because ``force=False``).
+    """
+    # Deep copy via json round-trip — the input dict may share nested
+    # references with the caller and we must not mutate it.
+    merged = json.loads(json.dumps(existing))
+    conflicts: set[str] = set()
+
+    for os_key in _TERMINAL_ENV_KEYS:
+        sub = merged.get(os_key)
+        if not isinstance(sub, dict):
+            # Overwrite any non-dict value at this key — VSCode would
+            # ignore it anyway. Preserve nothing since the previous
+            # value was already broken.
+            sub = {}
+
+        for env_key, env_val in desired_env.items():
+            if env_key in sub and sub[env_key] != env_val and not force:
+                conflicts.add(f"{os_key}.{env_key}")
+                # Leave sub[env_key] unchanged.
+                continue
+            sub[env_key] = env_val
+
+        merged[os_key] = sub
+
+    return merged, conflicts
+
+
+# ---------------------------------------------------------------------------
+# .envrc
+# ---------------------------------------------------------------------------
+
+
+def _apply_envrc(
+    path: Path,
+    *,
+    base_url: str,
+    profile: str | None,
+    force: bool,
+    dry_run: bool,
+) -> FileOutcome:
+    new_text = _render_envrc(base_url=base_url, profile=profile)
+    old_text = ""
+    if path.exists():
+        try:
+            old_text = path.read_text(encoding="utf-8")
+        except OSError as exc:
+            return FileOutcome(
+                path=path,
+                action="skipped",
+                reason=f"cannot read existing file: {exc}",
+            )
+
+    if new_text == old_text:
+        return FileOutcome(path=path, action="unchanged")
+
+    diff = _text_diff(old_text, new_text, path)
+
+    if old_text and not force:
+        return FileOutcome(
+            path=path,
+            action="conflict",
+            diff=diff,
+            reason=(
+                ".envrc already exists and its contents differ. "
+                "Re-run with --force to overwrite. "
+                "(Tip: keep secrets in a separate .envrc.local and "
+                "``source_env_if_exists`` from .envrc.)"
+            ),
+        )
+
+    if not dry_run:
+        try:
+            _atomic_write(path, new_text)
+        except OSError as exc:
+            return FileOutcome(
+                path=path,
+                action="skipped",
+                reason=f"write failed: {exc}",
+                diff=diff,
+            )
+
+    return FileOutcome(
+        path=path,
+        action="updated" if old_text else "created",
+        diff=diff,
+    )
+
+
+def _render_envrc(*, base_url: str, profile: str | None) -> str:
+    """Build the .envrc contents. Kept split for test targeting."""
+    lines = [
+        "# Auto-generated by `coderouter vscode-init`. Safe to edit.",
+        "# direnv will export these when you `cd` into this directory.",
+        "# Run `direnv allow` once after generation.",
+        "",
+        f'export ANTHROPIC_BASE_URL="{base_url}"',
+        f'export ANTHROPIC_AUTH_TOKEN="{DEFAULT_TOKEN}"',
+    ]
+    if profile:
+        lines.append(f'export CODEROUTER_MODE="{profile}"')
+    lines.append("")  # trailing newline
+    return "\n".join(lines)
+
+
+# ---------------------------------------------------------------------------
+# Rendering helpers
+# ---------------------------------------------------------------------------
+
+
+def format_result(result: VSCodeInitResult, *, dry_run: bool, port: int) -> str:
+    """Human-readable rendering of the outcomes for CLI stdout.
+
+    The output has three sections:
+
+    1. Per-file outcome lines (with unified diffs where relevant).
+    2. A cheat sheet for the extensions this scaffolder does NOT wire
+       (Cline / Roo / Kilo / Continue) — the user copy-pastes.
+    3. A trailing hint about the fuller ``docs/guides/vscode.md``.
+
+    ``dry_run`` toggles the "(dry-run — nothing written)" reminder.
+    """
+    lines: list[str] = []
+    marker_for = {
+        "created": "  new ",
+        "updated": " diff ",
+        "unchanged": " nop  ",
+        "conflict": "CONFLICT",
+        "skipped": " SKIP ",
+    }
+    for o in result.outcomes:
+        marker = marker_for.get(o.action, f" {o.action} ")
+        lines.append(f"[{marker}] {o.path}")
+        if o.reason:
+            lines.append(f"          → {o.reason}")
+        if o.diff and o.action in ("created", "updated", "conflict"):
+            lines.append("")
+            lines.extend(o.diff.rstrip("\n").splitlines())
+            lines.append("")
+
+    if dry_run:
+        lines.append("")
+        lines.append("(dry-run — no files were written. Re-run without --dry-run to apply.)")
+
+    lines.append("")
+    lines.append(_render_cheat_sheet(port))
+    return "\n".join(lines)
+
+
+def _render_cheat_sheet(port: int) -> str:
+    """Emit the copy-paste snippets shown after every ``vscode-init`` run.
+
+    The Continue.dev snippet is built with :func:`json.dumps` rather
+    than hand-formatted string concatenation to guarantee the output
+    is syntactically valid JSON. An earlier hand-formatted version
+    accidentally leaked an extra ``}`` from mismatched f-string /
+    plain-string brace escaping — the JSON round-trip closes that
+    class of bug and the test in ``tests/test_vscode_init.py`` pins
+    the invariant.
+    """
+    continue_snippet = _render_continue_snippet(port)
+    return (
+        "─── Other extensions (copy/paste) ─────────────────────────────\n"
+        "\n"
+        "  Cline / Roo Code / Kilo Code:\n"
+        "    API Provider: OpenAI Compatible\n"
+        f"    Base URL:     http://localhost:{port}/v1\n"
+        "    API Key:      dummy   (any non-empty value)\n"
+        "    Model ID:     anything (CodeRouter routes via default_profile)\n"
+        "\n"
+        "  Continue.dev — add to the models array in ~/.continue/config.json:\n"
+        f"{continue_snippet}\n"
+        "\n"
+        "Full guide: docs/guides/vscode.md in the CodeRouter repo.\n"
+    )
+
+
+def _render_continue_snippet(port: int) -> str:
+    """Return one indented pretty-printed JSON block for Continue.dev.
+
+    Split out from :func:`_render_cheat_sheet` so tests can
+    ``json.loads`` the exact bytes users copy-paste and verify the
+    snippet is valid.
+    """
+    model_entry: dict[str, str] = {
+        "title": "CodeRouter",
+        "provider": "openai",
+        "model": "any-id",
+        "apiBase": f"http://localhost:{port}/v1",
+        "apiKey": "dummy",
+    }
+    pretty = json.dumps(model_entry, indent=2, ensure_ascii=False)
+    # Indent every line by 4 spaces so it aligns under the "─── Other
+    # extensions" header exactly like the Cline block above.
+    return "\n".join("    " + line for line in pretty.splitlines())
+
+
+def exit_code_for(result: VSCodeInitResult) -> int:
+    """Map the outcome set to a shell exit code.
+
+    * 0 — every file is clean or a no-op.
+    * 2 — at least one conflict (needs ``--force``); nothing was
+          written for the conflicting file(s), but other files may
+          have been.
+    * 1 — a hard error prevented processing (unparseable JSON, write
+          failure). Treated as more severe than a conflict.
+    """
+    if result.has_skipped:
+        return 1
+    if result.has_conflicts:
+        return 2
+    return 0
+
+
+# ---------------------------------------------------------------------------
+# Low-level I/O helpers
+# ---------------------------------------------------------------------------
+
+
+def _dump_json(obj: object) -> str:
+    """Deterministic pretty JSON for settings.json.
+
+    ``indent=2`` matches VSCode's own formatter default, ``ensure_ascii=False``
+    keeps CJK env values (e.g. a profile name) readable in the file.
+    A trailing newline is appended so POSIX tools don't complain.
+    """
+    return json.dumps(obj, indent=2, ensure_ascii=False) + "\n"
+
+
+def _atomic_write(path: Path, text: str) -> None:
+    """Write ``text`` to ``path`` atomically (tmp + os.replace).
+
+    A partial write cannot corrupt the target file: the tmp file lives
+    on the same filesystem (same parent directory) so ``os.replace`` is
+    an atomic inode swap on POSIX. On Windows ``os.replace`` is also
+    atomic since Python 3.3.
+
+    The tmp file uses the parent + ``<name>.tmp`` pattern rather than
+    ``Path.with_suffix`` because ``.envrc`` has no stem/suffix in the
+    ``Path`` sense and ``with_suffix`` would silently misbehave.
+    """
+    tmp = path.parent / (path.name + ".tmp")
+    tmp.write_text(text, encoding="utf-8")
+    os.replace(tmp, path)
+
+
+def _text_diff(old: str, new: str, path: Path) -> str:
+    """Unified diff between two text buffers, labelled by file name."""
+    return "".join(
+        unified_diff(
+            old.splitlines(keepends=True),
+            new.splitlines(keepends=True),
+            fromfile=f"a/{path.name}",
+            tofile=f"b/{path.name}",
+            n=3,
+        )
+    )
+
+
+def _json_diff(old: dict, new: dict, path: Path) -> str:
+    """Diff between two JSON dicts, formatted as ``_dump_json`` would."""
+    old_text = _dump_json(old) if old else ""
+    new_text = _dump_json(new)
+    return _text_diff(old_text, new_text, path)

{coderouter_cli-2.9.4.dist-info → coderouter_cli-2.10.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: coderouter-cli
-Version: 2.9.4
+Version: 2.10.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
@@ -132,6 +132,8 @@ ANTHROPIC_BASE_URL=http://localhost:8088 ANTHROPIC_AUTH_TOKEN=dummy claude
 
 これだけ。Claude Code はいつも通り動きますが、裏ではローカルの Ollama が答えています。
 
+**VSCode の統合ターミナルから使う場合** は、環境変数の書き忘れを避けるため `coderouter vscode-init` が便利です。プロジェクトルートで 1 回叩くと `.vscode/settings.json` に `terminal.integrated.env.*` をマージ書き込みするので、以後 VSCode のターミナルで `claude` と打つだけで通ります。Cline / Roo Code / Continue.dev の設定コピペも含めて → [VSCode 連携ガイド](./docs/guides/vscode.md)
+
 ---
 
 ## 自分に必要？
@@ -281,6 +283,7 @@ providers:
 | 無料で回す | [無料枠ガイド](./docs/guides/free-tier-guide.md) |
 | llama.cpp / vllm を GUI で起動 | [Launcher ガイド](./docs/backends/launcher.md) |
 | 言語税を計測・回避する | [言語税ガイド](./docs/guides/language-tax.md) |
+| VSCode / Cline / Continue から使う | [VSCode 連携ガイド](./docs/guides/vscode.md) |
 | 別の PC から安全に繋ぐ | [リモートアクセスガイド](./docs/guides/remote-access.md) |
 | 詰まった | [トラブルシューティング](./docs/guides/troubleshooting.md) |
 | 設計を知りたい | [アーキテクチャ詳細](./docs/concepts/architecture.md) |

{coderouter_cli-2.9.4.dist-info → coderouter_cli-2.10.0.dist-info}/RECORD

@@ -1,6 +1,6 @@
 coderouter/__init__.py,sha256=ghdjPrLtnRzY8fyQ4CJZI1UJKADyNTLtA3G7se8H7Ns,696
 coderouter/__main__.py,sha256=-LCgxJnvgUV240HjQKv7ly-mn2NuKHpC4nCpvTHjeSU,130
-coderouter/cli.py,sha256=7zxt6riKPTpHGiDms9SVaPbe-n4ytfCrhIVtuPII-oU,30173
+coderouter/cli.py,sha256=rEo-G9fyIBXnRWmVCHxWBlfzII2CWMcFvhRJW5h2oBU,34650
 coderouter/cli_stats.py,sha256=CCjzc1G4hTRHZ2gG1XhxhDpUkJnnl3NXbcbp1T18jpg,29894
 coderouter/cost.py,sha256=32h6uzb4nxh2eA5d2Hn3kD9yJbtis6CFDAbeIy5KRkM,7431
 coderouter/doctor.py,sha256=x0OqWUMGPzYaX2poWSH2UA90sEr4Z69-gVYLXYQFCFU,85483
@@ -17,6 +17,7 @@ coderouter/logging.py,sha256=5rfi4_R4aoeeUYDc642dgs61wA0aBX7wvubyB-k3Uyo,58074
 coderouter/output_filters.py,sha256=0ry_rPiS_kC-FnHgaNVP6v7e6Al2djxzu9vBzZ8kEkE,25314
 coderouter/token_estimation.py,sha256=iz22vZEEW2P7uKLB2pYvPNpIbZGbgXRO5MtfkS_-9Sk,7531
 coderouter/token_estimation_accurate.py,sha256=GTfzrBVnvAGjeVzmzAeUdOYZvWZKLAxcxPpFiJGlzjk,4609
+coderouter/vscode_init.py,sha256=fAcxJmwGXX8u0ylW0GHGACe_Co9VL6wdAKNFw7-ulwg,19952
 coderouter/adapters/__init__.py,sha256=7dIDSZ-FE_0iSqLSDc_lK1idRdLTKcM2hP9tCJipgPI,463
 coderouter/adapters/anthropic_native.py,sha256=CT9Hitun-c3z83YHT2zZXgwZpY3_t6eRnOfAmNud2aw,23610
 coderouter/adapters/base.py,sha256=ykKMaiIVVGr23oFFXilK2iP_YhI8-CtsEiJyFXaC9bE,10396
@@ -26,7 +27,7 @@ coderouter/config/__init__.py,sha256=FODEn74fN-qZnt4INPSHswqhOlEgpL6-_onxsitSx8g
 coderouter/config/capability_registry.py,sha256=RZgzHF54dXy0CCDocRCz2ee21qXGbbgTSKTkRI9iLL4,16936
 coderouter/config/env_file.py,sha256=CoMK27fuAXm-NtoLzXb8yN2E-wDFjHQuFwiIlmgTBQw,10356
 coderouter/config/loader.py,sha256=FUEe8m4Tnmj_aul0vSctD8vKvNW-oLRoMRbTpSKqSmc,4077
-coderouter/config/schemas.py,sha256=wHaOqbehppjtL-01eLh8DNmm0A3rZXdJ-cNbBcS2yM8,120984
+coderouter/config/schemas.py,sha256=X2LeonDTTIkesbqzmmo3QYcD1dwmjGiCalMyS5X-A1o,120986
 coderouter/data/__init__.py,sha256=uNyfD9jaCvTWsBAWtaw1Fr25OSxzv3psGMfBjT1z0Cc,328
 coderouter/data/model-capabilities.yaml,sha256=S9jt6SC6-3s2-icZ_n-a14iEMnc2yB1C2R6q-N_tZWQ,19309
 coderouter/guards/__init__.py,sha256=5qliYBqygvVPneej7nx0uSjxDKsz7t8VzvrDgVBJlvU,1170
@@ -70,8 +71,8 @@ coderouter/translation/__init__.py,sha256=PYXN7XVEwpG1uC8RLy6fvnGbzEZhhrEuUapH8I
 coderouter/translation/anthropic.py,sha256=uEScq-icLn6ZXFWaxsKROv7feaq3zD0ZogjbTJ3Y7gQ,12578
 coderouter/translation/convert.py,sha256=VV4kpu4dvLmGBmJfQnCLY5ryy_AnQcV2NuwjqRtaR8Q,52633
 coderouter/translation/tool_repair.py,sha256=DGOKArM53yfVbIfiAveoul1vGq9NEKmjagf43Qh4IkM,57630
-coderouter_cli-2.9.4.dist-info/METADATA,sha256=E7EiSxxEYfkchQLvqlvdQzADFsnwbReGwi0Patjfk8I,15996
-coderouter_cli-2.9.4.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
-coderouter_cli-2.9.4.dist-info/entry_points.txt,sha256=-dnLfD1YZ2WjH2zSdNCvlO65wYltM9bsHt9Fhg3yGss,51
-coderouter_cli-2.9.4.dist-info/licenses/LICENSE,sha256=wkEzoR86jFw33jvfOHjULqmkGEfxTFMgMaJnpR8mPRw,1065
-coderouter_cli-2.9.4.dist-info/RECORD,,
+coderouter_cli-2.10.0.dist-info/METADATA,sha256=quMG0dkYOOZpkWxidZQIxREB-vHl3-U7VktyA00bE4Y,16578
+coderouter_cli-2.10.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+coderouter_cli-2.10.0.dist-info/entry_points.txt,sha256=-dnLfD1YZ2WjH2zSdNCvlO65wYltM9bsHt9Fhg3yGss,51
+coderouter_cli-2.10.0.dist-info/licenses/LICENSE,sha256=wkEzoR86jFw33jvfOHjULqmkGEfxTFMgMaJnpR8mPRw,1065
+coderouter_cli-2.10.0.dist-info/RECORD,,