coderouter-cli 2.9.4__tar.gz → 2.10.0__tar.gz

{coderouter_cli-2.9.4 → coderouter_cli-2.10.0}/CHANGELOG.md

@@ -9,6 +9,96 @@ are kept verbatim where the Japanese text itself is the subject).
 
 ---
 
+## [v2.10.0] — 2026-07-20 (VSCode workspace scaffolder)
+
+### Added
+
+- **`coderouter vscode-init` — one-shot VSCode workspace scaffolder.**
+  Writes `.vscode/settings.json` with `terminal.integrated.env.osx` /
+  `.linux` / `.windows` populated so a Claude Code session launched
+  from VSCode's integrated terminal auto-points at CodeRouter with no
+  manual `ANTHROPIC_BASE_URL` juggling. Optionally emits a direnv
+  `.envrc` (`--with-envrc`). The command is **idempotent** (re-running
+  with the same arguments is a no-op) and **conflict-aware**: if an
+  existing `settings.json` has different values for one of our managed
+  keys, the file is left untouched and a unified diff is printed —
+  operators re-run with `--force` to overwrite. Unrelated top-level
+  keys (`editor.fontSize`, `python.testing.pytestEnabled`, etc.) and
+  unrelated env keys inside the terminal blocks (a user's `PATH`
+  tweak) are preserved verbatim on merge. All writes are atomic
+  (temp file + `os.replace`) so a partial write cannot corrupt an
+  existing `settings.json`. Non-Claude-Code extensions (Cline / Roo
+  Code / Kilo Code / Continue.dev) are handled by a cheat sheet
+  printed at end of run plus the fuller `docs/guides/vscode.md` —
+  `vscode-init` deliberately does NOT reach into those extensions'
+  own config schemas (each ships its own release cadence, so any
+  automation would need continuous maintenance to follow). The
+  Continue.dev cheat-sheet snippet is built via `json.dumps` rather
+  than hand-formatted concatenation, so it is guaranteed to be
+  syntactically valid JSON (an early hand-formatted version leaked
+  an extra `}` from mismatched f-string / plain-string brace
+  escaping; a test round-trips the snippet through `json.loads` to
+  pin the invariant). Options: `--target PATH` (default cwd),
+  `--port PORT` (default **8088**, matching every docs / quickstart
+  example — note that `coderouter serve` alone still defaults to
+  4000, so if you serve on 4000 pass `--port 4000` here too),
+  `--profile NAME` (adds `CODEROUTER_MODE=<profile>` to the terminal
+  env for header-less profile routing), `--with-envrc` (also emit
+  `.envrc`), `--dry-run` (compute diffs but write nothing —
+  byte-identical to the write path minus the final `os.replace`),
+  and `--force` (overwrite conflicting values). Exit codes: 0 clean,
+  2 conflicts (nothing was written for the conflicting file), 1
+  hard error (unparseable JSON, missing target directory, write
+  failure). Implementation lives in `coderouter/vscode_init.py`
+  (stdlib only — no new runtime deps, keeping the strict-5-package
+  rule in `pyproject.toml` intact); the CLI wrapper
+  (`_run_vscode_init` in `coderouter/cli.py`) mirrors the existing
+  `stats` / `audit` / `replay` "thin argparse plumbing + logic in a
+  sibling module" pattern. See `tests/test_vscode_init.py` (33 cases
+  across happy paths, merge preservation, conflict detection,
+  `--force`, `--dry-run` byte parity, `.envrc`, malformed inputs,
+  JSON validity of the Continue.dev snippet, and CLI wrapper
+  plumbing) and the new `docs/guides/vscode.md` for the full Cline /
+  Roo / Continue.dev cheat sheet.
+
+### Documentation
+
+- **Launcher port ↔ `providers.yaml` mismatch, three ways to prevent
+  it.** New section
+  ["providers.yaml とのポート整合"](docs/backends/launcher.md#providersyaml-とのポート整合食い違いを構造的に防ぐ)
+  in the Launcher guide walks through the three coexisting patterns
+  — (A) hardcoded `providers.yaml` with matching Launcher port
+  (traditional), (B) v2.7.4 Launcher auto-sync
+  (`launcher-<backend>-<port>` provider names, no `providers.yaml`
+  edit needed), and (C) the recommended hybrid where
+  `option_profiles` pins the port so the Launcher UI and
+  `providers.yaml` cannot drift. Includes a copy-paste `cr-check`
+  shell function that runs `coderouter doctor --check-model <name>`
+  against every hand-declared provider before work begins so
+  operators catch a port mismatch in seconds rather than after a
+  session of quiet fallback churn. The symptom side (dashboard's
+  `unhealthy` badge + half-and-half `provider-failed` events in the
+  ring buffer while requests still succeed via fallback) is
+  documented as a new
+  [troubleshooting §1-7](docs/guides/troubleshooting.md#1-7-transport-error-all-connections-failed--ポート不一致の疑い)
+  entry, cross-linked back to the Launcher guide for the fix. Both
+  additions are Japanese-side only (English counterpart will follow
+  in a later docs-sync commit).
+
+### Fixed
+
+- **`ProviderConfig.timeout_s` upper bound raised from 600s (10 min) to
+  86400s (24h)** (#76, contributed by @firelzrd). The previous 10-minute
+  ceiling was too restrictive for long-running local model inference —
+  configurations that legitimately need multi-hour timeouts (heavy
+  reasoning models, large-context sweeps, batch operations) were being
+  rejected by the Pydantic `le=600` validator before the request could
+  even leave the router. The default (30s) and lower bound (1s) are
+  unchanged, so existing configs are unaffected; only users who were
+  hitting the ceiling gain the new headroom.
+
+---
+
 ## [v2.9.4] — 2026-07-19 (launcher device selection & bench sweep, cache-stable system prompt)
 
 ### Added

{coderouter_cli-2.9.4 → coderouter_cli-2.10.0}/PKG-INFO

@@ -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 → coderouter_cli-2.10.0}/README.md

@@ -87,6 +87,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)
+
 ---
 
 ## 自分に必要？
@@ -236,6 +238,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 → coderouter_cli-2.10.0}/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_cli-2.9.4 → coderouter_cli-2.10.0}/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