3.0 KiB
TUI spawn の user manifest env override と scope overlay の前提ズレ
背景
pod CLI は tickets/pod-cli-manifest-flags.md で --user-manifest を廃止し、INSOMNIA_USER_MANIFEST によって user manifest のパスを上書きできるようになった。
一方、TUI の spawn dialog は Pod 起動前に user / project manifest を先読みし、既存 cascade に scope.allow があるかどうかを見て、spawn overlay に cwd scope を補完するかを判断している。現状この先読みは manifest::user_manifest_path() に依存しており、INSOMNIA_USER_MANIFEST による user manifest override と一致しない可能性がある。
Pod の最終起動自体は pod --overlay <toml> 経由で行われるため、Pod 側では INSOMNIA_USER_MANIFEST が有効になる。しかし TUI が作る overlay は、別の user manifest を前提に組まれる可能性がある。
問題
INSOMNIA_USER_MANIFEST が設定されている場合、TUI spawn dialog が作成する scope overlay が実際に Pod CLI が読む manifest cascade とズレる可能性がある。
例:
- override された user manifest には
scope.allowがあるが、通常の XDG user manifest には無い- TUI は「cascade に scope が無い」と判断して cwd scope を overlay に追加する
- 実際の Pod は override user manifest の scope と TUI overlay の cwd scope を両方読む
- 通常の XDG user manifest には
scope.allowがあるが、override された user manifest には無い- TUI は「cascade に scope がある」と判断して cwd scope を overlay に追加しない
- 実際の Pod は override user manifest を読むため、期待より scope が狭い、または空になる可能性がある
この問題は spawn 段階で manifest が必須という意味ではなく、TUI が spawn overlay を補完するために行う cascade の事前見積もりが Pod CLI の manifest 解決規則と一致していない、という問題である。
要件
本チケットでは問題の記録を目的とする。対応方針はまだ決めない。
対応時には少なくとも以下を確認する:
- TUI spawn dialog が参照する user manifest 解決規則と、Pod CLI の
INSOMNIA_USER_MANIFEST解決規則の関係 - TUI が cwd scope を overlay に補完する条件が、実際の Pod 起動時 cascade と一致しているか
INSOMNIA_USER_MANIFESTが空文字列の場合の扱い- TUI 表示上の scope origin 表示が、実際に Pod が読む manifest と矛盾しないか
完了条件
INSOMNIA_USER_MANIFEST設定時に、TUI spawn dialog の scope overlay 補完が Pod CLI の実際の manifest cascade と矛盾しない- TUI spawn dialog の表示・判断に使う user manifest 解決規則がコード上明確になっている
- 必要なテストが追加されている
範囲外
- TUI CLI フラグ全体のドキュメント整備
- Pod CLI の manifest flag 仕様変更
--projectや project manifest の env override 新設