一致テストが補完の --context の余分を比べず、--context を取らない道で補完が --context を勧めても落ちない #453

何を見つけたか

--context を受け付けない道で補完が --context を出しても、一致テストは落ちない。tests/cli/test_name_context_consistency.py の test_bash_completion_offers_context_after_path・test_bash_completion_offers_context_after_name・test_zsh_completion_offers_context は、--context の集合（CONTEXT_PATHS）の道で --context が欠けていないかだけを見る。たとえば bash の env set の分岐に --context を足すか、zsh の env set の分岐に '--context[Docker context]:context:' を足しても、全体のテストは通る。argparse は devbase env set --context x を退けるため、補完が勧めた旗で利用者のコマンドが止まる。

#435 の設計（決定 5）は「一致テストは --context の欠けと余分の両方を比べる。余分を比べる道は子の parser を持たない末端の道に限る」と決め、不変条件 I4・I6 とテスト設計にも余分の行があったが、実装（PR #449）に余分の比べ方が入らず、PR の本文にも外した理由が書かれていない。

どこで見つけたか

スプリント m10b の確定仕様化（PR #451）で、#435 の設計の決定の記録を実装と突き合わせたとき。確定仕様 docs/specifications/cli-argument-resolution.md には、実装にない決定 5 を写していない。

なぜこの変更の範囲外なのか

#435 の受け入れ条件 1〜8 は欠けの検出だけを求め（受け入れ条件 5）、余分の比べ方は設計の判断で足したものである。受け入れ条件は満たしており、確定仕様化の PR はコードを変えない。根拠: Mission（MVV 版 1）

直さないと何が起きるか

補完の写しが列挙の正本より広がっても検査で拾えない。--context を取らない道に誤って --context を足す変更が入ると、利用者が補完に従って打ったコマンドが argparse のエラー（終了コード 2）で止まる。今の補完に余分があるかは確かめていない。

受け入れ条件

2026-10-12 に足した（スプリント m8b のモード判定と要求）。#435 の設計の決定 5 を、この課題で実装へ入れる。

関連

• zsh の補完の実際の候補を確かめるテストが無く、分岐の文字列はそろっていても候補が出ない退行を拾えない #455（閉じた）— zsh を起動して補完の実際の候補を比べる道具 tests/cli/zsh_completion_harness.py と、それを使うテスト tests/cli/test_zsh_completion_run.py が入った。zsh の側の余分は、分岐の文字列ではなく実際の候補で比べられる

由来

issue #435

進行

モード: —

• 要求と受け入れ条件
• 作業場所の用意 — 2026-10-12 22:54
• 設計
• 素材の収集と出典の確定
• ドキュメント再構成
• ドキュメントレビュー
• 計画 — 2026-10-12 22:53
• 実装 — 2026-10-12 23:39
• 構造改善 — 2026-10-12 23:51
• 実装レビュー — 2026-10-13 00:09
• 完了判定 — 2026-10-12 23:42
• Pull Request — 2026-10-12 23:46
• 確定仕様化 — 2026-10-13 00:50
• 後片付け — 2026-10-13 01:00
• 配布 — 2026-10-13 01:00
• 体裁レビュー
• リリース後テスト — 2026-10-13 01:03
• 振り返り — 2026-10-13 01:03
• 棚卸し — 2026-10-13 01:20

振り返り: #472 (comment)