omnilane 0.8.3 → 0.9.1

package/CHANGELOG.md

@@ -6,6 +6,68 @@ semantic version tags.
 
 ## [Unreleased]
 
+## [0.9.1] - 2026-07-19
+
+### Fixed
+
+- `configure set` no longer deletes hand-written comments from
+  `routing.local.yaml`: it now rewrites only its own stamp header and the lane
+  being replaced, so user comments survive a set.
+
+### Added
+
+- Browser-backed UI tests honor `OMNILANE_TEST_REQUIRE_BROWSER=1`, which turns
+  a persistent Chrome/Playwright launch failure into a real failure instead of
+  a skip — for hosts known to have a working Chrome.
+
+## [0.9.0] - 2026-07-19
+
+### Added
+
+- `omnilane completion fish` prints a Fish completion script
+  (`completions/omnilane.fish`): static command, option, and enum completion for
+  every public command, including the direct-API vendors and `jobs cancel`/`rm`.
+  Load it with `omnilane completion fish | source`. Dynamic lane-name and job-id
+  completion remain Bash/Zsh-only for now.
+- Five OpenAI-compatible direct-API vendors — `deepseek`, `zai` (GLM),
+  `mistral`, `groq`, and `cerebras` — join `openrouter` as CLI-free inference
+  lanes (curl + a `<VENDOR>_API_KEY`, advise mode only). A single vendor registry
+  in `lib/common.sh` (endpoint, key env, and default model per vendor) now drives
+  every vendor-name check in `dispatch.sh` and `jobs.sh`, so adding another
+  OpenAI-compatible vendor is a one-line registry entry plus a thin runner
+  wrapper. `configure` lists them with suggested models. See
+  `docs/model-capabilities-2026-07.md` for the July 2026 model/benchmark snapshot
+  behind the routing defaults.
+- `omnilane doctor` now reports vendor-CLI availability: which of codex, claude,
+  grok, gemini (the `agy` CLI), kimi, qwen, and opencode are reachable, plus
+  the direct-API vendors openrouter, deepseek, zai, mistral, groq, and cerebras
+  (curl + each `<VENDOR>_API_KEY`). Shown in human and `--json` output;
+  the probe mirrors the runners' `*_BIN` overrides and `local.sh` in an isolated
+  subshell. It is a `PASS`/`WARN` check and never fails the report.
+- MCP server read-only introspection tools: `explain`, `validate`, `dry_run`,
+  `jobs_list`, `jobs_stats`, `jobs_audit`, and `doctor` join the existing
+  `route`, `list_lanes`, `jobs_status`, and `jobs_result`, so the MCP surface
+  mirrors the CLI's full offline read-only surface. All refuse provider calls and
+  create no job state; `dry_run` requires an explicit `workdir` only when `mode`
+  is `work`. `jobs_stats`/`jobs_audit` accept an optional `last` and `json`.
+- `configure set|get|unset|list|diff` non-interactive subcommands: script or
+  inspect `routing.local.yaml` without a tty. `set` validates the lane, refuses
+  unsafe specs, and rolls back on a structural FAIL; `diff` shows how local
+  overrides change the effective table versus the defaults. The interactive menu
+  is unchanged.
+- `jobs list` and `jobs stats` filters: `--lane` and `--vendor` (and, for
+  `list`, `--status running|done`) narrow the output in both human and `--json`
+  modes. `list` scans all jobs for up to 20 matches; `stats` filters within its
+  `--last` sample and recomputes the success rate and lane/vendor aggregates.
+  Invalid filter values exit 2; unfiltered behavior is unchanged.
+- `jobs cancel ID`: stop a running background job. Signals the worker's process
+  group (SIGTERM, then SIGKILL after a grace period) so the vendor CLI child
+  dies too, and leaves a terminal exit recorded — 143 on graceful stop, 137 if
+  force-killed. Idempotent on already-finished, dead, or never-backgrounded jobs.
+- `jobs rm ID`: delete one job's stored directory (task, output, exit, metadata).
+  Refuses a job whose worker is still alive — cancel it first — complementing
+  `jobs prune`, which only bulk-deletes completed jobs by count or age.
+
 ## [0.8.3] - 2026-07-18
 
 ### Added
@@ -259,7 +321,9 @@ semantic version tags.
 - Initial shared routing table, cross-vendor dispatcher, runners, installer,
   and baseline lint fixes.
 
-[Unreleased]: https://github.com/Seraphim0916/omnilane/compare/v0.8.3...HEAD
+[Unreleased]: https://github.com/Seraphim0916/omnilane/compare/v0.9.1...HEAD
+[0.9.1]: https://github.com/Seraphim0916/omnilane/compare/v0.9.0...v0.9.1
+[0.9.0]: https://github.com/Seraphim0916/omnilane/compare/v0.8.3...v0.9.0
 [0.8.3]: https://github.com/Seraphim0916/omnilane/compare/v0.8.2...v0.8.3
 [0.8.2]: https://github.com/Seraphim0916/omnilane/compare/v0.8.1...v0.8.2
 

package/README.ja.md

@@ -21,105 +21,56 @@
 
 ---
 
-## v0.8.3 の新機能
-
-- **MCP サーバー** — `omnilane mcp` は依存ゼロの stdio MCP サーバーを起動し、
-  MCP 対応ホスト(Claude Code、Codex、Gemini CLI、Cursor、OpenCode など)が
-  スキルなしで omnilane を発見・呼び出しできます:ツールは `route`、
-  `jobs_status`、`jobs_result`、`list_lanes`。`route` は読み取り専用の
-  advise がデフォルトで、work モードには明示的な workdir が必須です。
+## 👋 はじめての方へ
 
-## v0.8.2 の新機能
+すでに AI コーディングアシスタント——**Claude Code、Codex、Cursor、Gemini
+CLI** など——を使っていますよね。どれも一度に一つの AI モデルとやり取りし、
+「どのタスクにどのモデルが最適か」の判断はあなた任せです。
 
-- **`openrouter` vendor** — `curl` と `OPENROUTER_API_KEY` だけで
-  OpenRouter API に直接ディスパッチ。どの omnilane インストールからでも
-  数百のホスト型モデルに到達でき、コーディングエージェント CLI の追加は
-  不要。advise/consult 専用(ファイル編集不可、work モードは明確に
-  エラーで案内)、モデル slug は必須。例:
-  `dispatch.sh --vendor openrouter --model anthropic/claude-sonnet-5 consult "..."`
-- **`opencode` vendor** — マルチプロバイダ集約 CLI OpenCode 経由の
-  ヘッドレスディスパッチ(`opencode run`)。advise モードは組み込みの
-  読み取り専用 `plan` エージェントを使用し、work モードは `--auto`。
-  デフォルトの `coding-overflow` チェーンの最終フォールバックに追加。
-
-## v0.8.1 の新機能
-
-- **Claude Code プラグインがルーティングリマインダーを自動読み込み** —
-  プラグインに `SessionStart` フック(`hooks/hooks.json`)を同梱。
-  セッション開始時(`startup|resume|clear`)にルーティングリマインダーを
-  自動注入するため、`~/.claude/CLAUDE.md` を編集せずプラグインの
-  インストールだけで有効になります。他の CLI は引き続き `install.sh` の
-  指示ファイル方式です。
+**omnilane がその判断を代行します。** 一つひとつの作業を、それに最も強い(そして最も安い)
+モデルへ自動で振り分けます——難しいコーディングはトップコーダーへ、ちょっとした確認は
+速くて安いモデルへ、長い文書は大コンテキストモデルへ——すべてあなたが既に契約している
+サブスクと API キーで。組み込みのデフォルトのまま使うも、小さな設定ファイルを一つ調整するも
+自由。新しく面倒を見る対象は増えず(既存ツールの裏で動きます)、`./install.sh --uninstall`
+できれいに削除できます。
 
-## v0.8.0 の新機能
+**[⬇ 60 秒クイックスタートへ](#-60-秒クイックスタート)**
 
-- **2 つの新ディスパッチベンダー** — `kimi`(Moonshot Kimi Code CLI)と
-  `qwen`(Alibaba Qwen Code CLI)が統一 runner 契約で加わりました:
-  advise は読み取り専用、work は自動承認、API キー環境変数を除去して
-  CLI 自身のサブスクリプションログインを使用、空出力は明示的な失敗。
-  `--vendor kimi|qwen` で直接指名できます。
-- **coding-overflow にフォールバックチェーン** — クォータ逃し弁が
-  grok → kimi → qwen → `off` の順にフォールバックし、3 ベンダーの
-  いずれか 1 つで動作します。runner はフェイクバイナリで契約テスト済み。
-  実モデルでの報告を歓迎します。
+## v0.9.1 の新機能
 
-## v0.7.1 の新機能
+- **修正**: `configure set` が `routing.local.yaml` の手書きコメントを削除しなく
+  なりました。書き換えるのは自身のスタンプ行と置き換え対象のレーンだけです。
 
-- **ルーティング表を更新(2026-07 モデルデータ)** — hardest-coding の第一候補を
-  GPT-5.6 Sol **max** に変更。Artificial Analysis Coding Agent Index v1.1 で
-  Sol (max) が 80 点の現行最高を記録し、旧「xhigh が max を上回る」スナップ
-  ショットを置き換えました。
-- **Claude バックアップを強化** — hardest-coding と hard-judgment の
-  Claude Opus 4.8 バックアップを **xhigh** に変更。難しいタスクと長時間作業には
-  extra effort を推奨する Anthropic 公式ガイダンスに従います。
+## v0.9.0 の新機能
 
-## v0.7.0 の新機能
+- **OpenAI 互換の direct-API ベンダーを 5 つ追加** — `deepseek`、`zai`(GLM)、
+  `mistral`、`groq`、`cerebras` が `openrouter` と同じく CLI 不要のレーンに
+  (curl と `<VENDOR>_API_KEY` だけ)。`lib/common.sh` のレジストリに 1 行で
+  追加でき、モデル能力の比較は [`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md) を参照。
+- **Fish シェル補完** — `omnilane completion fish | source`。
 
-- **ディスパッチを事前にプレビュー** — `--dry-run` は解決済みの実行計画
-  (vendor、モデル、モード、タイムアウト、副作用判定)を表示し、モデル呼び出しも
-  ジョブ状態の作成も行いません。
-- **バージョン付き JSON で自動化** — `--list`/`--explain`/`--validate` と
-  `jobs list|status|result|stats` に `--json` エンベロープを追加。読み取り専用の
-  `jobs wait`、`jobs audit`、決定的マニフェスト付きのオフライン
-  `omnilane release-audit` も利用できます。
-- **ローカルジョブを一気通貫で操作** — `jobs tail` で出力を覗き、`jobs retry` で
-  完了ジョブを fail-closed に再実行、`prune --older-than` で古いジョブを整理。
-  `--help` が全コマンドを網羅します。
-- **インストールと補完を安全に** — `install.sh --check`/`--dry-run` は書き込みなしで
-  ドリフトを報告し、`omnilane completion bash|zsh` が安全なタブ補完を提供。
-  macOS 標準 Bash 3.2 のクラッシュを 5 件修正しました。
-
-## v0.6.0 の新機能
-
-- **ルーティングをオフラインで説明・検証** — `--explain` で各フォールバック
-  候補を確認し、`--validate` で実効ルーティング表全体を検査できます。
-  プロバイダー呼び出しやジョブ状態の作成は行いません。
-- **ローカル状態を機械可読データで観測** — 有界な `jobs.sh stats` 集計と
-  `omnilane doctor --json` により、タスクや結果本文を漏らさず自動化できます。
-- **Live Board で二つのジョブを比較** — 読み込み済みジョブをメモリ内だけの
-  参照スナップショットとして固定し、モデル経路と公開結果を並べて比較できます。
-- **ロック回復時のノイズを削減** — 所有者ファイルが確認と読み取りの間に
-  消えた場合も、誤解を招く欠落ファイル診断を出さず fail-closed を維持します。
+## ⚡ 60 秒クイックスタート
 
-## v0.5.1 の新機能
+**一番早い方法——npm でインストール:**
 
-- **Git 管理外で Codex work を利用** — 通常のディレクトリを引き続きサポートし、
-  Omnilane は `git init` を要求も自動実行もしません。
-- **非 Git の停止を安全に処理** — 全体上限が未設定なら、解決済みの呼び出し単位
-  ウォッチドッグを process group ヒューズとして使い、明示設定の優先順位と終了
-  コードの意味は維持します。
-- **表示バージョンを信頼可能に** — `VERSION` が `omnilane --version` と二つの
-  plugin manifest を統一し、CI が変更履歴と五言語 README の一致を検査します。
+```bash
+npm i -g omnilane                                    # CLI をインストール
+omnilane route hardest-coding "auth トークン更新テストの不安定さを修正"
+omnilane doctor                                      # 使える AI CLI / キーを確認
+omnilane ui start                                    # 任意:ブラウザでジョブをライブ表示
+```
 
-## ⚡ 60 秒クイックスタート
+**またはリポジトリを clone**(ルーティングテーブルとカスタマイズ用スキルが手に入る):
 
 ```bash
 git clone https://github.com/Seraphim0916/omnilane && cd omnilane
 ./install.sh          # CLI を検出、スキルを接続、あなたの言語で対話
 omnilane route hardest-coding "auth トークン更新テストの不安定さを修正"
-omnilane ui start     # 任意:ブラウザでジョブをライブ表示
 ```
 
+> はじめての方は、まず `omnilane doctor` を実行してください。omnilane が今どのモデル CLI と
+> API キーに接続できるかがわかり、実際に何が動くか把握できます。
+
 ## 🧭 仕組み
 
 omnilane は、**どの** agentic CLI のメインループでも、サブタスクをレーンに
@@ -148,6 +99,8 @@ flowchart LR
   指定ベンダーに固定し、フォールバックしません。
 - **`skills/omnilane/SKILL.md`** — 四つのハーネス共通のスキル:
   自分のモデルを特定し、自分のレーンは自前で実行、残りはディスパッチ。
+- **`omnilane mcp`** — 同じルーティングを MCP stdio サーバーとして提供。
+  スキルではなく MCP で統合するホスト向け。
 
 <div align="center">
 
@@ -301,10 +254,13 @@ MCP 対応ホストがスキルの導入やルーティングリマインダー
 }
 ```
 
-サーバーは `route`、`jobs_status`、`jobs_result`、`list_lanes` を公開します。
+サーバーは `route` に加えて、読み取り専用の照会ツール `list_lanes`、`explain`、`validate`、`dry_run`、`jobs_list`、`jobs_status`、`jobs_result`、`jobs_stats`、`jobs_audit`、`doctor` を公開します。
 `route` のデフォルトは読み取り専用の `advise` モードで、`work` を選ぶ呼び
 出しには明示的な `workdir` が必須です。
 
+実行時に必要なのは Node.js のみ(npm パッケージは不要)。npm 派なら
+`npm install -g omnilane` で MCP サーバーごと CLI をインストールできます。
+
 ## ⚙️ カスタマイズ
 
 三層、すべて任意:
@@ -329,6 +285,8 @@ scripts/dispatch.sh --list     # 実効テーブル(フォールバック解決
 ```
 eval "$(omnilane completion bash)"             # 現在の Bash で補完を有効化
 source <(omnilane completion zsh)               # 現在の Zsh で補完を有効化
+omnilane completion fish | source              # 現在の Fish で補完を有効化
+omnilane mcp                                   # MCP stdio サーバー(Node.js が必要)
 omnilane release-audit [--target VERSION] [--json] # オフライン・読み取り専用のリリースゲート
 omnilane ui start                              # ローカル Live UI を起動または再利用し、URL を表示
 omnilane ui status                             # Live UI の稼働状態を表示
@@ -342,11 +300,15 @@ dispatch.sh [--json] --list [--json]
 dispatch.sh [--json] --explain LANE [--json]       # 候補ごとの決定理由をオフライン表示
 dispatch.sh [--json] --validate [--json]           # プロバイダーを呼ばず実効ルーティングを検証
 jobs.sh [--json] {list | status ID | result ID}    # JSON は本文を返さずメタデータのみ
+jobs.sh [--json] list [--lane L] [--vendor V] [--status running|done]  # 一覧を絞り込み
 jobs.sh wait ID [--timeout N]                     # ジョブ終了値。124 はタイムアウト、125 はワーカー消失
-jobs.sh [--json] stats [--last N]                  # ローカル成功率とルーティング集計
+jobs.sh cancel ID                                 # 実行中ジョブを停止:グループに SIGTERM、その後 SIGKILL
+jobs.sh rm ID                                     # 完了/停止ジョブを1件削除(実行中は拒否)
+jobs.sh [--json] stats [--last N] [--lane L] [--vendor V]  # ローカル成功率とルーティング集計
 jobs.sh audit [--last N] [--json]                  # 読み取り専用のジョブ整合性・プライバシー検査
 jobs.sh prune [--keep N] [--apply]                # 既定はプレビューのみ。完了ジョブだけを対象
 configure.sh                                        # 対話式レーンメニュー
+configure.sh set|get|unset|list|diff LANE [SPEC]    # routing.local.yaml を非対話で編集/確認
 ```
 
 終了コード:`2` 使い方エラー(無効なベンダー、または指定ベンダーがレーンに
@@ -417,13 +379,111 @@ configure.sh                                        # 対話式レーンメニ
   制限し、監視対象の process group を終了します。Omnilane は `git init` を自動実行せず、
   リポジトリの作成も要求しません。
 
+## 📜 リリース履歴
+
+<details>
+<summary>過去のリリース(v0.8.3 以前)</summary>
+
+## v0.8.3 の新機能
+
+- **MCP サーバー** — `omnilane mcp` は依存ゼロの stdio MCP サーバーを起動し、
+  MCP 対応ホスト(Claude Code、Codex、Gemini CLI、Cursor、OpenCode など)が
+  スキルなしで omnilane を発見・呼び出しできます:ツールは `route`、
+  `jobs_status`、`jobs_result`、`list_lanes`。`route` は読み取り専用の
+  advise がデフォルトで、work モードには明示的な workdir が必須です。
+
+## v0.8.2 の新機能
+
+- **`openrouter` vendor** — `curl` と `OPENROUTER_API_KEY` だけで
+  OpenRouter API に直接ディスパッチ。どの omnilane インストールからでも
+  数百のホスト型モデルに到達でき、コーディングエージェント CLI の追加は
+  不要。advise/consult 専用(ファイル編集不可、work モードは明確に
+  エラーで案内)、モデル slug は必須。例:
+  `dispatch.sh --vendor openrouter --model anthropic/claude-sonnet-5 consult "..."`
+- **`opencode` vendor** — マルチプロバイダ集約 CLI OpenCode 経由の
+  ヘッドレスディスパッチ(`opencode run`)。advise モードは組み込みの
+  読み取り専用 `plan` エージェントを使用し、work モードは `--auto`。
+  デフォルトの `coding-overflow` チェーンの最終フォールバックに追加。
+
+## v0.8.1 の新機能
+
+- **Claude Code プラグインがルーティングリマインダーを自動読み込み** —
+  プラグインに `SessionStart` フック(`hooks/hooks.json`)を同梱。
+  セッション開始時(`startup|resume|clear`)にルーティングリマインダーを
+  自動注入するため、`~/.claude/CLAUDE.md` を編集せずプラグインの
+  インストールだけで有効になります。他の CLI は引き続き `install.sh` の
+  指示ファイル方式です。
+
+## v0.8.0 の新機能
+
+- **2 つの新ディスパッチベンダー** — `kimi`(Moonshot Kimi Code CLI)と
+  `qwen`(Alibaba Qwen Code CLI)が統一 runner 契約で加わりました:
+  advise は読み取り専用、work は自動承認、API キー環境変数を除去して
+  CLI 自身のサブスクリプションログインを使用、空出力は明示的な失敗。
+  `--vendor kimi|qwen` で直接指名できます。
+- **coding-overflow にフォールバックチェーン** — クォータ逃し弁が
+  grok → kimi → qwen → `off` の順にフォールバックし、3 ベンダーの
+  いずれか 1 つで動作します。runner はフェイクバイナリで契約テスト済み。
+  実モデルでの報告を歓迎します。
+
+## v0.7.1 の新機能
+
+- **ルーティング表を更新(2026-07 モデルデータ)** — hardest-coding の第一候補を
+  GPT-5.6 Sol **max** に変更。Artificial Analysis Coding Agent Index v1.1 で
+  Sol (max) が 80 点の現行最高を記録し、旧「xhigh が max を上回る」スナップ
+  ショットを置き換えました。
+- **Claude バックアップを強化** — hardest-coding と hard-judgment の
+  Claude Opus 4.8 バックアップを **xhigh** に変更。難しいタスクと長時間作業には
+  extra effort を推奨する Anthropic 公式ガイダンスに従います。
+
+## v0.7.0 の新機能
+
+- **ディスパッチを事前にプレビュー** — `--dry-run` は解決済みの実行計画
+  (vendor、モデル、モード、タイムアウト、副作用判定)を表示し、モデル呼び出しも
+  ジョブ状態の作成も行いません。
+- **バージョン付き JSON で自動化** — `--list`/`--explain`/`--validate` と
+  `jobs list|status|result|stats` に `--json` エンベロープを追加。読み取り専用の
+  `jobs wait`、`jobs audit`、決定的マニフェスト付きのオフライン
+  `omnilane release-audit` も利用できます。
+- **ローカルジョブを一気通貫で操作** — `jobs tail` で出力を覗き、`jobs retry` で
+  完了ジョブを fail-closed に再実行、`prune --older-than` で古いジョブを整理。
+  `--help` が全コマンドを網羅します。
+- **インストールと補完を安全に** — `install.sh --check`/`--dry-run` は書き込みなしで
+  ドリフトを報告し、`omnilane completion bash|zsh` が安全なタブ補完を提供。
+  macOS 標準 Bash 3.2 のクラッシュを 5 件修正しました。
+
+## v0.6.0 の新機能
+
+- **ルーティングをオフラインで説明・検証** — `--explain` で各フォールバック
+  候補を確認し、`--validate` で実効ルーティング表全体を検査できます。
+  プロバイダー呼び出しやジョブ状態の作成は行いません。
+- **ローカル状態を機械可読データで観測** — 有界な `jobs.sh stats` 集計と
+  `omnilane doctor --json` により、タスクや結果本文を漏らさず自動化できます。
+- **Live Board で二つのジョブを比較** — 読み込み済みジョブをメモリ内だけの
+  参照スナップショットとして固定し、モデル経路と公開結果を並べて比較できます。
+- **ロック回復時のノイズを削減** — 所有者ファイルが確認と読み取りの間に
+  消えた場合も、誤解を招く欠落ファイル診断を出さず fail-closed を維持します。
+
+## v0.5.1 の新機能
+
+- **Git 管理外で Codex work を利用** — 通常のディレクトリを引き続きサポートし、
+  Omnilane は `git init` を要求も自動実行もしません。
+- **非 Git の停止を安全に処理** — 全体上限が未設定なら、解決済みの呼び出し単位
+  ウォッチドッグを process group ヒューズとして使い、明示設定の優先順位と終了
+  コードの意味は維持します。
+- **表示バージョンを信頼可能に** — `VERSION` が `omnilane --version` と二つの
+  plugin manifest を統一し、CI が変更履歴と五言語 README の一致を検査します。
+
+</details>
+
 ## 🌱 ステータス
 
-v0.8.3 は 8 つのディスパッチベンダーを備えます——4 つのハーネスネイティブ
+omnilane は 13 のディスパッチベンダーを備えます——4 つのハーネスネイティブ
 (codex、claude、grok、gemini)、3 つの集約/オーバーフロー CLI(kimi、qwen、
-opencode)、そして CLI 不要の `openrouter` 直接 API ベンダー——すべて統一
-runner 契約と契約テスト付き。Claude Code の `SessionStart` 自動リマインダー
-も同梱。kimi、qwen、opencode、openrouter の runner はフェイクバイナリで
+opencode)、そして CLI 不要の OpenAI 互換 direct-API ベンダー 6 つ(openrouter、
+deepseek、zai、mistral、groq、cerebras)——すべて統一 runner 契約と契約テスト
+付き。Claude Code の `SessionStart` 自動リマインダーと MCP stdio サーバー
+(`omnilane mcp`)も同梱。direct-API と集約系の runner はフェイクバイナリで
 契約テスト済みです。実モデルでの報告を歓迎します。Grok/Antigravity の
 コマンドシェル挙動は CLI バージョンで変わる可能性があります。issue と PR を
 歓迎します。