3.9 KiB
3.9 KiB
Pod CLI: マニフェスト関連フラグの整理
背景
現状の pod CLI は --user-manifest / --project / --overlay の 3 つでカスケードを制御している(crates/pod/src/main.rs)。実運用で 2 つ足りない / 1 つ過剰:
--user-manifestフラグが過剰: 個人マシンの user 設定は本来「一度設定して忘れる」性質のもので、毎回 CLI で渡し直す動機が薄い。XDG /~/.config/insomnia/manifest.tomlの自動探索 + 環境変数による上書きがあれば足りる- 環境変数連携が無い: 「user 設定を別の場所に置きたい人」が手段を持たない
- 単一ファイル起動 mode が無い: 「カスケードを一切回さず、このマニフェスト 1 枚だけで起動したい」という用途(再現性確保、CI、検証目的等)がカバーされていない。
--overlayは cascade の最上位レイヤとして追加されるだけで、user / project 層は依然として読み込まれる
--project は workspace の起点を上書きする一般的なフラグなので(manifest 探索だけでなく将来の prompts ディレクトリ等にも効く)、そのまま残す。--overlay も意味的に「cascade の最上位レイヤを差し込む」で正しいのでそのまま。
要件
--user-manifest の削除と env への置換
--user-manifest <PATH> フラグは削除し、代わりに INSOMNIA_USER_MANIFEST 環境変数で user manifest のパスを上書きできるようにする。
- env 未指定: 既存の XDG 自動探索(
manifest::user_manifest_path()) - env 指定: そのパスを user manifest として読む(ファイル不在はエラー、
with_user_manifest相当) - env が空文字列なら未指定扱い
pod/src/main.rs から user_manifest フィールドを除き、build_factory 内の分岐も env 読み取りに置き換える。
--manifest <PATH> の新設
カスケードを一切回さず、指定ファイル 1 枚だけを manifest として読み込んで Pod を起動する mode。
--project/--overlay/INSOMNIA_USER_MANIFESTのいずれとも 併用不可(clap のconflicts_with+ 環境変数の事前チェック)- 内部的には
PodFactoryの cascade 経路を通さず、PodManifest::from_toml(既存)の直接ルートで構築する - prompt loader 等 cascade 経由で組まれるものは、単一ファイル mode 用に最小構成で組み直す
既存挙動の保持
--project/--overlay: 変更なし--adopt/--callback: 変更なし(spawn 子 Pod 用、本フラグ群とは独立)- 引数なしで
podを叩くと従来通り XDG → walk-up → 起動
範囲外
--no-user-manifest/--no-project-manifestのような per-layer 無効化フラグ。--manifestで「全層無効化して 1 枚だけ」のケースはカバー出来るので、「user 層だけ無視して project 層は活かす」のような細粒度の需要が出てから別途INSOMNIA_PROJECT_ROOT等、--project側の env 連携(--project自体の責務見直しと一緒に検討すべき領域なので、本チケットでは触らない)- TUI spawn UI(
tickets/tui-pod-spawn-ui.md)の挙動変更。spawn UI が組む overlay 経路は本チケット完了後も互換のまま動く
完了条件
--user-manifestフラグが pod CLI から消えているINSOMNIA_USER_MANIFEST=<path> podで user manifest のパスを上書きして起動できるpod --manifest <path>が単一ファイル mode で起動し、user / project / overlay 層は読まれない--manifestを--project/--overlayと併用しようとすると clap が拒否するINSOMNIA_USER_MANIFESTがセットされた状態で--manifestを使おうとするとエラーになる- 既存の
pod --overlay <toml>起動(start_pod.local.fish経由)が引き続き動く