From 30abefe74744a56d49a9613ae01e5a13b50c617e Mon Sep 17 00:00:00 2001 From: Hare Date: Mon, 27 Apr 2026 17:17:00 +0900 Subject: [PATCH] =?UTF-8?q?manifest=E8=AA=AD=E3=81=BF=E8=BE=BC=E3=81=BF?= =?UTF-8?q?=E7=B5=8C=E8=B7=AF=E3=81=AE=E6=95=B4=E7=90=86=E3=83=81=E3=82=B1?= =?UTF-8?q?=E3=83=83=E3=83=88=E4=BD=9C=E6=88=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- TODO.md | 1 + tickets/pod-cli-manifest-flags.md | 52 +++++++++++++++++++++++++++++++ 2 files changed, 53 insertions(+) create mode 100644 tickets/pod-cli-manifest-flags.md diff --git a/TODO.md b/TODO.md index c1f0731b..438d1d45 100644 --- a/TODO.md +++ b/TODO.md @@ -2,6 +2,7 @@ - [ ] ツール設計 - [ ] Bash ツール (Permission 層と統合) → [tickets/bash-tool.md](tickets/bash-tool.md) - [ ] パーミッション: パターンベースのツール実行制御 → [tickets/permission-extension-point.md](tickets/permission-extension-point.md) +- [ ] Pod CLI: マニフェスト関連フラグの整理 → [tickets/pod-cli-manifest-flags.md](tickets/pod-cli-manifest-flags.md) - [ ] Pod オーケストレーション - [ ] 動的 Scope 変更 → [tickets/dynamic-scope.md](tickets/dynamic-scope.md) - [ ] ネイティブ GUI クライアント MVP → [tickets/native-gui-mvp.md](tickets/native-gui-mvp.md) diff --git a/tickets/pod-cli-manifest-flags.md b/tickets/pod-cli-manifest-flags.md new file mode 100644 index 00000000..7fcc2de2 --- /dev/null +++ b/tickets/pod-cli-manifest-flags.md @@ -0,0 +1,52 @@ +# 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 ` フラグは削除し、代わりに `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 ` の新設 + +カスケードを一切回さず、指定ファイル 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= pod` で user manifest のパスを上書きして起動できる +- `pod --manifest ` が単一ファイル mode で起動し、user / project / overlay 層は読まれない +- `--manifest` を `--project` / `--overlay` と併用しようとすると clap が拒否する +- `INSOMNIA_USER_MANIFEST` がセットされた状態で `--manifest` を使おうとするとエラーになる +- 既存の `pod --overlay ` 起動（`start_pod.local.fish` 経由）が引き続き動く