omnilane 0.7.0

package/CHANGELOG.md

@@ -0,0 +1,209 @@
+# Changelog
+
+All notable user-visible changes are recorded here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and releases use
+semantic version tags.
+
+## [Unreleased]
+
+## [0.7.0] - 2026-07-17
+
+### Added
+
+- `install.sh --check` reports missing, drifted, and checkout-owned links and
+  selected routing reminders without writing. `--dry-run` previews install or
+  uninstall actions without loading machine-local routing code.
+- `omnilane completion bash|zsh` prints safe shell completion definitions for
+  public commands, routing lanes, and local job IDs without loading executable
+  machine-local routing overrides.
+- `omnilane release-audit [--json]` provides an offline, read-only release gate
+  for version metadata, tracked package contents, executable modes, rollback
+  docs, archive reproducibility, and optional annotated-tag verification.
+- `dispatch.sh --list`, `--explain`, and `--validate` accept `--json` before or
+  after the inspection command and return one versioned JSON envelope without
+  invoking a provider or creating job state.
+- `dispatch.sh --dry-run` resolves the vendor, overrides, mode, work directory,
+  per-call timeout, whole-job timeout, and expected side effects without reading
+  task stdin, invoking a provider, or creating job state.
+- `jobs.sh --json list|status|result|stats` emits versioned, machine-readable
+  local job summaries. JSON result inspection reports only body availability;
+  task, output, and stderr bodies remain private.
+- `jobs.sh wait ID [--timeout N]` waits read-only for one local background job.
+  It preserves the recorded job exit, returns 124 on wait timeout, and 125 for
+  a dead worker without a recorded exit.
+- `jobs.sh audit [--last N] [--json]` performs a bounded, read-only integrity
+  and privacy check of the local job store without printing task or result
+  content.
+- `dispatch.sh --help` / `-h` and `jobs.sh help` print full usage on stdout
+  with exit 0; misuse keeps the stderr usage error with exit 2.
+- `jobs.sh tail JOB_ID [--lines N]` peeks at the bounded end of one job's
+  public output stream, for running and completed jobs, refusing symlinked
+  output paths.
+- `jobs.sh retry JOB_ID [--background]` re-dispatches a completed job with its
+  recorded lane, vendor, mode, workdir, timeouts, and original task text;
+  metadata parsing is fail-closed and running jobs are refused.
+- `jobs.sh prune --older-than DAYS` prunes completed jobs by the timestamp
+  embedded in the job id; alone it prunes purely by age, and combined with an
+  explicit `--keep N` both conditions must hold.
+
+### Fixed
+
+- A bare `jobs.sh` invocation reports usage with exit 2 instead of crashing
+  with an unbound-variable error under macOS stock Bash 3.2.
+- An empty routing chain (`lane:` with no candidates) no longer aborts
+  `--list` mid-table under Bash 3.2; `--validate` now reports it as
+  `FAIL <lane> empty-chain` and keeps scanning later lanes.
+- `jobs.sh prune` no longer crashes under Bash 3.2 when no job is eligible.
+- The configurator's four-voter selection and the vote runner's temp-file
+  cleanup no longer hit empty-array expansions under Bash 3.2 `set -u`.
+
+## [0.6.0] - 2026-07-16
+
+### Added
+
+- `dispatch.sh --explain LANE` reports every fallback candidate and the selected
+  decision without invoking a provider or creating job state.
+- `dispatch.sh --validate` checks the effective routing table for duplicate
+  lanes, malformed candidates, unknown vendors, and machine-local reachability
+  without invoking a provider.
+- `jobs.sh stats [--last N]` summarizes local job outcomes and lane/vendor
+  distribution from bounded public metadata without reading task or result bodies.
+- `omnilane doctor --json` emits the same read-only health checks as one escaped,
+  machine-readable document while preserving the existing failure exit status.
+- The Live Board can pin one loaded job as a memory-only reference and compare
+  its route and public result with the current selection. Comparison remains
+  local, read-only, responsive, and plain-text safe.
+
+### Changed
+
+- Redesigned all five READMEs: a 60-second quickstart section, the feature
+  grid folded into How it works, and the Live UI docs promoted to a Live
+  Board section with desktop and mobile screenshots
+  (`docs/live-board.png`, `docs/live-board-mobile.png`).
+
+### Fixed
+
+- Lock-owner reads no longer leak transient missing-file diagnostics when the
+  owner file disappears between the existence check and bounded read; locking
+  behavior remains fail-closed.
+
+## [0.5.1] - 2026-07-16
+
+### Added
+
+- A root `VERSION` source of truth, `omnilane --version`, and CI regression
+  coverage that keeps both plugin manifests, the changelog, and all five README
+  headings aligned.
+
+### Fixed
+
+- Codex `work` remains available outside Git worktrees. When no whole-job
+  timeout is configured, Omnilane now reuses the resolved per-call watchdog as
+  a process-group fuse for that case (up to 999999999 seconds); expiry cleans
+  the supervised process group and returns 124. Without the bundled Perl
+  supervisor it warns and retains the existing per-call watchdog path instead
+  of blocking work.
+
+## [0.5.0] - 2026-07-15
+
+### Added
+
+- Optional `--job-timeout` and per-lane/global environment controls for one
+  aggregate deadline across lock wait, retries, voters, and rounds.
+- Preview-first `jobs prune`, read-only `omnilane doctor`, executable gate
+  fallback, and explicit dispatch usage/environment validation.
+- Bundled-Chromium behavior CI, contribution and security policies, and this
+  durable changelog.
+
+### Changed
+
+- Job prompts, results, metadata, PID files, and logs now use owner-only storage
+  with bounded control-file parsing and complete JSON escaping.
+- Installer ownership rules preserve regular wrappers and symlinks belonging to
+  other checkouts; uninstall remains successful after provider removal.
+- Empty and invalid stale locks can be recovered without stealing a live owner.
+- GitHub Actions now use read-only permissions, stale-run cancellation, and
+  verified commit SHA pins.
+
+### Fixed
+
+- Rejected job-ID traversal, symlinked job stores and job directories,
+  malformed exit/PID metadata, unbounded PID reads, ambiguous dispatch
+  positionals, and invalid timeout/retry/lock controls.
+- The whole-job supervisor forwards signals, terminates TERM-ignoring process
+  groups, preserves normal exit status, and records timeout exit `124` for
+  foreground and background jobs.
+- Cross-browser mobile focus restoration tests now wait for the observable
+  focus state instead of racing the next animation frame.
+
+### Security
+
+- Prevented terminal-control injection through rejected control values and
+  diagnostic output.
+- Kept prompts and model answers out of world-readable job artifacts and
+  prevented local state commands from following foreign symlinks.
+
+## [0.4.0] - 2026-07-15
+
+### Added
+
+- Natural-language consultation rules and an explicit multi-vendor `consult`
+  lane with no silent fallback for named targets.
+- `--vendor` selection for direct model consultation.
+- Authenticated, loopback-only Live UI with job summaries, details, SSE updates,
+  lifecycle commands, desktop/mobile behavior, and real-browser tests.
+- Per-call and per-lane watchdog overrides through `--timeout` and
+  `OMNILANE_TIMEOUT_<LANE>`.
+
+### Changed
+
+- Published the v0.4.0 guide in English, Traditional Chinese, Simplified
+  Chinese, Japanese, and Korean.
+
+## [0.3.0] - 2026-07-13
+
+### Added
+
+- Interactive configurator, global wrapper, opt-in vote panel, fallback model
+  documentation, and five-language installer guidance.
+
+### Security
+
+- Replaced routing `eval` with a literal tokenizer.
+- Made installer marker removal fail closed and uninstall byte-reversible.
+- Added untrusted-data boundaries and cleanup guarantees to vote round two.
+
+## [0.2.1] - 2026-07-13
+
+### Fixed
+
+- Corrected target-directory lock keys and ownership, fail-closed mode
+  validation, Grok empty-output handling, background job status, preserved job
+  exit codes, read-only Claude advice tools, Gemini workdir behavior, and the
+  stock-Perl watchdog fallback.
+
+## [0.2.0] - 2026-07-12
+
+### Added
+
+- Lane fallback chains, the `coding-overflow` lane, background job robustness,
+  and a Traditional Chinese README.
+
+## [0.1.0] - 2026-07-12
+
+### Added
+
+- Initial shared routing table, cross-vendor dispatcher, runners, installer,
+  and baseline lint fixes.
+
+[Unreleased]: https://github.com/Seraphim0916/omnilane/compare/v0.7.0...HEAD
+
+[0.7.0]: https://github.com/Seraphim0916/omnilane/compare/v0.6.0...v0.7.0
+[0.6.0]: https://github.com/Seraphim0916/omnilane/compare/v0.5.1...v0.6.0
+[0.5.1]: https://github.com/Seraphim0916/omnilane/compare/v0.5.0...v0.5.1
+[0.5.0]: https://github.com/Seraphim0916/omnilane/compare/v0.4.0...v0.5.0
+[0.4.0]: https://github.com/Seraphim0916/omnilane/compare/v0.3.0...v0.4.0
+[0.3.0]: https://github.com/Seraphim0916/omnilane/compare/v0.2.1...v0.3.0
+[0.2.1]: https://github.com/Seraphim0916/omnilane/compare/v0.2.0...v0.2.1
+[0.2.0]: https://github.com/Seraphim0916/omnilane/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/Seraphim0916/omnilane/releases/tag/v0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Seraphim0916
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ja.md

@@ -0,0 +1,345 @@
+<div align="center">
+
+# omnilane
+
+### ルーティングテーブルは一枚、ハーネスは全部。
+
+*メインループはもう、どのモデルを使うか迷わない。*<br/>
+すべてのサブタスクを、その作業が本当に得意なモデルへ——<br/>
+**Claude Code · Codex · Grok Build · Antigravity** を横断、いまのサブスクリプションのままで。
+
+<img src="docs/hero.ja.png" alt="omnilane が各サブタスクを Claude Code・Codex・Grok・Antigravity の最適なモデルへ振り分ける" width="820"/>
+
+[![ci](https://github.com/Seraphim0916/omnilane/actions/workflows/ci.yml/badge.svg)](https://github.com/Seraphim0916/omnilane/actions/workflows/ci.yml)
+[![license](https://img.shields.io/github/license/Seraphim0916/omnilane)](LICENSE)
+[![version](https://img.shields.io/github/v/tag/Seraphim0916/omnilane?label=version)](https://github.com/Seraphim0916/omnilane/tags)
+
+[English](README.md) · [繁體中文](README.zh-TW.md) · [简体中文](README.zh-CN.md) · **日本語** · [한국어](README.ko.md)
+
+</div>
+
+---
+
+## 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 の一致を検査します。
+
+## ⚡ 60 秒クイックスタート
+
+```bash
+git clone https://github.com/Seraphim0916/omnilane && cd omnilane
+./install.sh          # CLI を検出、スキルを接続、あなたの言語で対話
+omnilane route hardest-coding "auth トークン更新テストの不安定さを修正"
+omnilane ui start     # 任意:ブラウザでジョブをライブ表示
+```
+
+## 🧭 仕組み
+
+omnilane は、**どの** agentic CLI のメインループでも、サブタスクをレーンに
+分類し、各レーンをその作業が最も得意なベンダー CLI へヘッドレスで
+ディスパッチさせる仕組みです。既存のサブスクリプションログインをそのまま使います:
+
+```mermaid
+flowchart LR
+    M["メインループ<br/><i>任意の CLI</i>"] --> T{{"routing.yaml<br/>一枚の共有テーブル"}}
+    T -->|hardest-coding| C1["Codex — GPT-5.6 Sol"]
+    T -->|bulk-mechanical| C2["Codex — GPT-5.6 Terra"]
+    T -->|taste-final| C3["Claude — Opus 4.8"]
+    T -->|long-context| C4["Gemini — 3.1 Pro"]
+    T -->|live-search| C5["Grok — 4.5"]
+    T -->|"arbitrate(オプトイン)"| C6["vote — 1-4 モデルパネル"]
+```
+
+- **`routing.yaml`** — レーン → ベンダー+モデル+推論エフォート。
+  一つのファイルを四つのハーネスが共有します。
+- **フォールバックチェーン** — レーンには複数の候補を並べられます
+  (`codex … | claude … | off`)。実際にインストールされている最初のベンダー
+  CLI が選ばれるため、一〜二社の契約でも同じテーブルが機能します。
+- **`scripts/dispatch.sh [--vendor V] <レーン> "<タスク>"`** — テーブルを
+  解決し、該当ベンダーの CLI をヘッドレスで起動します。`--vendor` は
+  指定ベンダーに固定し、フォールバックしません。
+- **`skills/omnilane/SKILL.md`** — 四つのハーネス共通のスキル:
+  自分のモデルを特定し、自分のレーンは自前で実行、残りはディスパッチ。
+
+<div align="center">
+
+| | | |
+|:---:|:---:|:---:|
+| 🧭 **一枚のテーブル**<br/>四つのハーネスで共有 | 🪂 **フォールバックチェーン**<br/>手持ちの CLI へ自動降格 | 🗳️ **オピニオンパネル**<br/>重大な判断はマルチモデル投票 |
+| 🔒 **安全機構**<br/>ロック · ウォッチドッグ · ネスト禁止 | 🌏 **五言語対応**<br/>インストーラーが母語で対話 | ↩️ **完全可逆**<br/>`--uninstall` で全て元通り |
+
+</div>
+
+## 🛤️ レーン一覧(デフォルト。実効値は `scripts/dispatch.sh --list` で確認)
+
+| レーン | 第一候補 | バックアップ | 用途 |
+|---|---|---|---|
+| 🔥 hardest-coding | GPT-5.6 Sol (xhigh) | Claude Opus 4.8 (high) | 最難関の実装、根本原因デバッグ、正確性が要の変更 |
+| 🏗️ bulk-mechanical | GPT-5.6 Terra (max) | Claude Sonnet 5 (high) | リファクタ、移行、テスト、大規模スイープ |
+| 🧹 triage | GPT-5.6 Luna (medium) | Gemini 3.5 Flash (Low) | 大量の一次スクリーニング |
+| ⚖️ hard-judgment | GPT-5.6 Sol (max) | Claude Opus 4.8 (high) | アーキテクチャ裁定、深い推論、セカンドオピニオン |
+| ✒️ taste-final | Claude Opus 4.8 (high) | GPT-5.6 Sol (max) | 対外文章、prompt/ドキュメント推敲、スタイル最終審 |
+| 💬 consult | 明示指定したベンダー/モデル | —(フォールバックなし) | 自然言語で直接相談。`--vendor` を必ず維持 |
+| 🎨 ui-draft | GPT-5.6 Sol (xhigh) | Claude Opus 4.8 (high) | デザインシステム/参考画像がある場合の UI ドラフト |
+| 📚 long-context | Gemini 3.1 Pro (High) | Claude Opus 4.8 (high) | 100 万トークン級の長文統合——分析専用、agentic ループ禁止 |
+| ⚡ fast-agentic | Gemini 3.5 Flash (High) | GPT-5.6 Luna (high) | 高速なマルチステップ agentic ループ、マルチモーダル確認 |
+| 📡 live-search | Grok 4.5 | —(off) | リアルタイム X/ウェブ検索とソーシャル文脈 |
+| 🚰 coding-overflow | Grok 4.5 | —(off) | Codex クォータ逼迫時の中級コーディング逃し弁 |
+| 🗳️ arbitrate | off(オプトイン) | — | 内蔵オピニオンパネル(重大な判断用)——デフォルト無効。`routing.local.yaml` で有効化;投票者×ラウンドごとに 1 コール消費 |
+
+**バックアップ**はチェーンの次の候補——第一候補のベンダー CLI が未インストールの
+ときにディスパッチが降格する先です。
+
+> **Claude Fable 5 はどこ?** 意図的にデフォルト表に入れていません:Claude の
+> 最上位ティアは通常*メインループ自身*であり、ディスパッチされるワーカーでは
+> ないため(価格も Opus より上)。設定メニューのモデル一覧には載っているので、
+> 使いたければ自分でルーティングできます(例:`routing.local.yaml` に
+> `taste-final: claude claude-fable-5 high`)。
+
+### 自然言語コンサルテーション
+
+`omnilane` スキルまたは `/route` では、普通に
+**「Opus にこのアーキテクチャを厳しく検討してもらって。」** と頼めます。
+自然言語を解釈するのは Agent Skill であり、`dispatch.sh` に自由文の shell
+パーサーを追加するものではありません。
+
+- 能力だけを尋ねる質問には、該当レーンで現在最初に利用可能なモデルを回答し、
+  モデル呼び出しは行いません。
+- 一般的なベンダー名は、そのベンダー用に `consult` で設定された候補を使います。
+- Opus などの標準モデル別名はスキル表の正確なモデルファミリーに固定します。
+  明示した対象が存在しない、または CLI が使えない場合は明確に失敗し、別の
+  ベンダーやモデルファミリーへフォールバックしません。
+
+<details>
+<summary><b>👉 どのレーンを自分で実行する?メインモデルを選択</b></summary>
+
+<br/>
+
+上の表はベンダー非依存です——レーンの*最適*モデルは、誰が操縦していても
+変わりません。変わるのは、どのレーンを**自分で実行**するか(すでにそのモデル
+なので追加コールなし)、どれを**ディスパッチ**するか。CLI の `omnilane` スキルが
+該当行を自動適用します。これはその人間向けビューです。
+
+- **Claude Code · Fable 5** — 自分で実行:hard-judgment、taste-final、正確性が最重要の難修正。ディスパッチ:機械的コーディング量 → Codex、長文 → Gemini、リアルタイム検索 → Grok。
+- **Claude Code · Opus 4.8** — 自分で実行:taste-final。hard-judgment は Codex Sol へ(素の知能スコアが Opus より上)、コーディングは全て Codex レーン、長文 → Gemini、リアルタイム検索 → Grok。
+- **Codex · Sol** — 自分で実行:hardest-coding、hard-judgment、ui-draft。ディスパッチ:taste-final → Claude、長文 → Gemini、リアルタイム検索 → Grok、大量作業 → Codex Terra。
+- **Codex · Terra** — 自分で実行:bulk-mechanical。本当に最難関の部分は Sol へエスカレーション;taste → Claude、長文 → Gemini、リアルタイム検索 → Grok。
+- **Grok Build · Grok 4.5** — 自分で実行:live-search、coding-overflow(中級コーディング)。難しい作業は全て Codex/Claude/Gemini へ——先に全 API シグネチャと引用事実を検証。
+- **Antigravity · Gemini** — 自分で実行:long-context(3.1 Pro)、fast-agentic(Flash)。コーディング/判断/文章は Codex/Claude へ;リアルタイム検索 → Grok。3.1 Pro では agentic ツールループチェーンを決して受けない。
+
+</details>
+
+## 🖥️ Live Board
+
+すべてのディスパッチは——フォアグラウンドでも `--background` でも——ディスク上の
+ジョブとして記録されます。Live Board はそのジョブストアの上に載る、任意かつ
+読み取り専用のローカルワークベンチです:各モデルに何を頼み、何が返り、どう
+ルーティングされ、まだ実行中かを一目で確認できます。
+
+<div align="center">
+
+<img src="docs/live-board.png" alt="Omnilane Live Board デスクトップ表示——左にジョブ一覧、右に選択中ジョブのタスク・公開結果・モデルパス" width="820"/>
+
+<img src="docs/live-board-mobile.png" alt="Omnilane Live Board モバイル表示——検索可能なジョブ一覧とステータスフィルター" width="280"/>
+
+</div>
+
+```bash
+omnilane ui start    # サーバーを起動または再利用し、認証済み URL を表示
+omnilane ui status   # ローカルサーバーの状態を確認
+omnilane ui url      # 現在の認証済み URL を表示
+omnilane ui stop     # 正常に停止
+```
+
+デスクトップではジョブ一覧と詳細ペインを別々にスクロールでき、モバイルでは
+一覧／詳細の切り替えと戻る操作、Esc に対応します。Server-Sent Events(SSE)は
+フォーカス中の行を作り直さず更新し、短い切断では最後のスナップショットを保持して
+再接続します。読み込み済みジョブを参照として固定し、別のジョブを選ぶと、モデル
+経路と公開結果を横並びで比較できます。参照スナップショットはブラウザのメモリ内
+だけに保持され、ページを閉じると消えます。`127.0.0.1` のみにバインドし、
+ランダムトークンで保護された読み取り専用画面です。`task.txt` と公開用 `out.txt`
+のみを表示し、ワーカーや
+ベンダーの生ログは表示しません。
+
+コアルーティングに Python は不要で、この UI のみ Python 3.9 以降が必要です。
+
+## 📦 インストール
+
+前提:ルーティングしたいベンダー CLI(`codex`、`claude`、`grok`、`agy`)が
+ログイン済みで `PATH` 上にあること——**持っている分だけで OK**、
+足りないレーンは自動的に降格します。
+
+最速:`./install.sh` — 本機の CLI を検出してスキルを接続し、残りのプラグイン
+コマンドを表示、実効ルーティングを出力し、最後に対話式設定メニューを
+提案します(`--uninstall` で元に戻せます)。インストーラーはシステム言語に
+合わせて英/繁中/簡中/日/韓を自動選択(`OMNILANE_LANG=ja` で強制可)。
+さらに任意で、各 CLI の指示ファイル(`~/.claude/CLAUDE.md`、
+`~/.codex/AGENTS.md`、`~/.grok/Agents.md`、`~/.gemini/GEMINI.md`——パスは
+CLI バージョンにより異なる場合あり)へマーカー付きの可逆な
+**常駐ルーティングリマインダー**を追記できます。非対話インストールは
+`OMNILANE_HOOKS=all|none|claude,codex` を指定。手動接続:
+
+`./install.sh --check` は変更せずドリフトを検査します。インストールまたは
+`--uninstall` に `--dry-run` を加えると所有対象の操作を事前表示します。
+インストーラー所有のリンクとマーカー付きリマインダーを戻すには、
+`./install.sh --uninstall` を実行します。
+
+- **Claude Code**:プラグインとしてインストール(`/route`、`/route-jobs`
+  コマンド付き)、または `skills/omnilane` を `~/.claude/skills/` へ。
+- **Codex**:`skills/omnilane` を `~/.codex/skills/` へ配置/リンク。
+- **Grok Build**:`grok plugin install <このリポジトリ> --trust`
+- **Antigravity**:`agy plugin install <このリポジトリ>`(先に
+  `agy plugin validate` で確認)
+
+## ⚙️ カスタマイズ
+
+三層、すべて任意:
+
+1. **対話メニュー** — `scripts/configure.sh` が設定可能なレーンを表示し、レーンごとに
+   ベンダー → モデル → エフォートを選択(候補リスト+自由入力)、結果を
+   `~/.omnilane/routing.local.yaml` に書き込みます。複数ベンダーの `consult`
+   は意図的に除外されるため、変更する場合は手動編集します。
+2. **`~/.omnilane/routing.local.yaml`** — 手書きのオーバーライド。
+   書式は `routing.yaml` と同じで、ローカルが優先。
+3. **`~/.omnilane/local.sh`** — マシン固有のバイナリパス、プロキシ、認証
+   ラッパー。全ランナーが読み込み、コミットされません。
+
+確認はいつでも:
+
+```
+scripts/dispatch.sh --list     # 実効テーブル(フォールバック解決を注記)
+```
+
+## 📖 コマンドリファレンス
+
+```
+eval "$(omnilane completion bash)"             # 現在の Bash で補完を有効化
+source <(omnilane completion zsh)               # 現在の Zsh で補完を有効化
+omnilane release-audit [--target VERSION] [--json] # オフライン・読み取り専用のリリースゲート
+omnilane ui start                              # ローカル Live UI を起動または再利用し、URL を表示
+omnilane ui status                             # Live UI の稼働状態を表示
+omnilane ui url                                # 現在の認証済みローカル URL を表示
+omnilane ui stop                               # Live UI を停止
+omnilane doctor [--json]                       # ルーティングとローカル実行環境を読み取り専用で診断
+dispatch.sh [--background] [--dry-run] [--mode advise|work] [--workdir DIR]
+            [--vendor V] [--model M] [--effort E] [--timeout SEC] [--job-timeout SEC]
+            LANE "TASK"                              # "-" で stdin から読む
+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 wait ID [--timeout N]                     # ジョブ終了値。124 はタイムアウト、125 はワーカー消失
+jobs.sh [--json] stats [--last N]                  # ローカル成功率とルーティング集計
+jobs.sh audit [--last N] [--json]                  # 読み取り専用のジョブ整合性・プライバシー検査
+jobs.sh prune [--keep N] [--apply]                # 既定はプレビューのみ。完了ジョブだけを対象
+configure.sh                                        # 対話式レーンメニュー
+```
+
+終了コード:`2` 使い方エラー(無効なベンダー、または指定ベンダーがレーンに
+ない場合を含む)、`3` レーン無効(off)、`4` チェーン内に利用可能な CLI がない、
+または設定済みの指定ベンダー CLI が利用不可、`5` Round 1 の成功投票者不足、
+`6` Round 2 の反論全失敗、`86` ネストディスパッチ拒否、`87` ロック待ちタイムアウト、
+`124` ジョブ全体タイムアウト。
+それ以外はワーカー自身の終了コードを透過。
+
+## 🎭 モード
+
+- **advise(デフォルト)** — 読み取り専用ワーカー。Codex は read-only
+  サンドボックス、Claude は Read/Glob/Grep のみ、Grok は plan モード。
+- **work** — 指定した `--workdir` 内でのみファイル編集可。Codex は
+  workspace-write、Claude は編集自動承認、Gemini は accept-edits モード。
+
+## 🔒 安全機構
+
+- **ネストディスパッチ禁止** — ワーカーの再ディスパッチを拒否
+  (`OMNILANE_DEPTH` ガード、終了コード 86)。
+- **Codex 直列化ロック** — 同一ターゲットディレクトリへの codex
+  ディスパッチはキューイング。クラッシュ残留ロックは所有者 PID で検出し
+  安全に奪取。
+- **ウォッチドッグ** — 全ワーカーは `timeout`/`gtimeout`、どちらも無ければ
+  perl-alarm フォールバック下で実行(素の macOS がこのケース)。上限は
+  **CLI 呼び出しごと** に適用され、優先順位は `--timeout SECONDS` > レーン別
+  `OMNILANE_TIMEOUT_<LANE>`(例 `OMNILANE_TIMEOUT_HARD_JUDGMENT`) > グローバル
+  `OMNILANE_TIMEOUT`(既定 600 秒)。これは呼び出し単位のハングガードであり、
+  ジョブ全体の予算ではありません。リトライするベンダー(grok)や vote パネル
+  (投票者 × ラウンド)は複数回呼び出すため、総実時間はこの値の数倍になり得ます。
+- **ジョブ全体ヒューズ** — 任意の `--job-timeout SECONDS` はロック待ち、
+  リトライ、全投票者・ラウンドを一つの process group 監視下で制限します。
+  優先順位はフラグ > `OMNILANE_JOB_TIMEOUT_<LANE>` >
+  `OMNILANE_JOB_TIMEOUT` > 無効です。ただし Git worktree 外で Codex の
+  `work` を実行し、全体上限が未設定の場合だけ、解決済みの呼び出し単位
+  ウォッチドッグを自動的に全体ヒューズとして使います（監視機構の上限は
+  999999999 秒）。この自動ヒューズには同梱の Perl 監視機構が必要です。利用
+  できない場合は警告し、既存の呼び出し単位ウォッチドッグ経路で非 Git work を
+  続行します。その経路でも監視ツールがなければ、別途警告します。
+  期限切れは監視対象の process group を終了して 124 を返します。
+  大規模リポジトリの深い監査は 2–4 時間(7200–14400 秒)、呼び出し単位は
+  30 分から始めるのが目安です。ハードコードされた既定値ではありません。
+- **バックグラウンドジョブ** — `--background` ワーカーは独立した process
+  group で動き、呼び出し元の終了後も生存。kill された場合は終了コードを
+  記録し、`jobs.sh status` が `dead` を報告。
+- **ペイロード上限** — 巨大なタスクテキストは自動で頭尾トランケート。
+
+## 📊 デフォルト値と出典
+
+デフォルトのレーン割当は Artificial Analysis の 2026-07 スナップショット
+(AA サイトの生レコードと各社公式価格ページで照合済み)と公開の比較レビューに
+基づきます。これは意見であって法則ではありません——設定メニューと
+`routing.local.yaml` はそのためにあります。
+
+## ⚠️ 既知の制限
+
+- **Antigravity の print モードにおけるツール呼び出しは現行 CLI ビルドで
+  不安定**(拒否または invalid-argument)。long-context レーンの本来の用途
+  (本文をタスクに貼り込む長文統合)には影響しません。
+- **Grok に推論エフォートのつまみはありません**。effort 欄はインターフェース
+  互換のためだけに存在し、無視されます。
+- **Git 管理外でも Codex の work は利用できます。** 一部の Codex CLI は
+  Git worktree 外で停止する可能性があるため、上記の自動ヒューズがこのケースを
+  制限し、監視対象の process group を終了します。Omnilane は `git init` を自動実行せず、
+  リポジトリの作成も要求しません。
+
+## 🌱 ステータス
+
+v0.5.1 は Git 管理外でも Codex `work` を利用可能に保ち、process group の
+クリーンアップで停止を制限し、公開バージョン情報を同期します。v0.5.0 の
+インストーラー、ライフサイクル、ジョブストア、期限、診断、リリース CI の
+強化も維持します。Grok/Antigravity のコマンドシェル挙動は CLI バージョンで
+変わる可能性があります。issue と PR を歓迎します。
+
+プロジェクト文書：[コントリビューション](CONTRIBUTING.md) ·
+[セキュリティ](SECURITY.md) · [変更履歴](CHANGELOG.md)