fix(tui): 引数入力プロンプトの Ctrl-C を Esc と区別し全体中止を伝搬 (PR #55 round4 major)

menu.text/confirm/path が Esc と Ctrl-C を同じ None で返し、各 actions_* が
それを _ARG_CANCEL に畳んでいたため、引数入力中の Ctrl-C がナビ規約の
「全体中止」にならずサブメニュー再表示になっていた (round2 で対応した
選択メニューと同じ問題が入力プロンプトに残存)。

- menu: _ask_with_escape を with_escape_back(bind_left=False) ベースへ変更し、
  text/confirm/path/integer が Esc=MENU_BACK / Ctrl-C=None を区別して返す
  新契約に統一 (← は入力カーソル移動用に空ける)
- actions_env/plugin/project/snapshot: 入力ヘルパの None (Ctrl-C) を
  呼び出し元まで return し、MENU_BACK (Esc) のみ _ARG_CANCEL とする。
  confirm の「not ok」判定は MENU_BACK が truthy のため is 判定を先行
- _optional_int / _optional_point: 「空入力 = None (既定動作)」と Ctrl-C の
  None が衝突するため専用番兵 _ABORT を導入し、呼び出し側で None へ変換

テスト: 入力系キャンセルを Esc=_ARG_CANCEL / Ctrl-C=None の新契約へ
パラメトライズ更新し、Ctrl-C 全体中止と MENU_BACK 伝搬の回帰テストを追加
(701→732 passed)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: takemi-ohama

lib/devbase/tui/actions_env.py

@@ -150,12 +150,13 @@ def _collect_assignment():
     """``env set`` の KEY=VALUE を収集する。
 
     形式エラー (``=`` 無し / キー名空) は ``cmd_env_set`` でも弾かれるが、TUI では
-    実行前に再入力を促す。戻り値: 入力文字列 / ``None`` (Esc・Ctrl-C 中止)。
+    実行前に再入力を促す。戻り値: 入力文字列 / ``MENU_BACK`` (Esc → サブメニューへ
+    戻る) / ``None`` (Ctrl-C → 全体中止)。
     """
     while True:
         raw = menu.text("設定する変数 (KEY=VALUE 形式)", allow_empty=False)
-        if raw is None:
-            return None
+        if raw is None or raw is menu.MENU_BACK:
+            return raw                 # None=Ctrl-C 全体中止 / MENU_BACK=Esc 戻る
         if "=" not in raw or not raw.partition("=")[0].strip():
             logger.error("形式: KEY=VALUE (キー名は必須)")
             continue
@@ -232,10 +233,14 @@ def _run_list(devbase_root: Path):
 
     reveal = menu.confirm("機密値を伏せ字にせず表示しますか (--reveal)?", default=False)
     if reveal is None:
-        return _ARG_CANCEL
+        return None                    # Ctrl-C → 全体中止
+    if reveal is menu.MENU_BACK:
+        return _ARG_CANCEL             # Esc → サブメニューへ戻る
     keys_only = menu.confirm("キー名のみ表示しますか (--keys)?", default=False)
     if keys_only is None:
-        return _ARG_CANCEL
+        return None                    # Ctrl-C → 全体中止
+    if keys_only is menu.MENU_BACK:
+        return _ARG_CANCEL             # Esc → サブメニューへ戻る
 
     if scope in ("both", "project"):
         return _run_in_project(
@@ -274,7 +279,9 @@ def _run_set(devbase_root: Path):
 
     assignment = _collect_assignment()
     if assignment is None:
-        return _ARG_CANCEL
+        return None                    # Ctrl-C → 全体中止
+    if assignment is menu.MENU_BACK:
+        return _ARG_CANCEL             # Esc → サブメニューへ戻る
 
     if scope == "project":
         return _run_in_project(
@@ -312,7 +319,9 @@ def _run_get(devbase_root: Path):
 
     key = menu.text("取得する変数名", allow_empty=False)
     if key is None:
-        return _ARG_CANCEL
+        return None                    # Ctrl-C → 全体中止
+    if key is menu.MENU_BACK:
+        return _ARG_CANCEL             # Esc → サブメニューへ戻る
 
     if scope == "project":
         return _run_in_project(
@@ -324,8 +333,8 @@ def _run_get(devbase_root: Path):
 def _run_operation(devbase_root: Path, op: str):
     """選択された env 操作の引数を収集して ``cmd_env`` へ委譲する。
 
-    戻り値: dispatch の rc (``int``) / ``_ARG_CANCEL`` (引数収集を中止 =
-    サブメニューへ戻る) / ``None`` (選択メニューで Ctrl-C → 全体中止)。
+    戻り値: dispatch の rc (``int``) / ``_ARG_CANCEL`` (Esc で引数収集を中止 =
+    サブメニューへ戻る) / ``None`` (選択・入力中の Ctrl-C → 全体中止)。
     属性は plan 2.3 の契約表 (cli.py parser と同期確認済み) に従う。
     """
     if op == "sync":
@@ -342,7 +351,9 @@ def _run_operation(devbase_root: Path, op: str):
         reset = menu.confirm(
             "既存の設定をバックアップしてやり直しますか (--reset)?", default=False)
         if reset is None:
-            return _ARG_CANCEL
+            return None                # Ctrl-C → 全体中止
+        if reset is menu.MENU_BACK:
+            return _ARG_CANCEL         # Esc → サブメニューへ戻る
         return _dispatch(devbase_root, "init", reset=reset)
 
     if op == "list":
@@ -357,13 +368,17 @@ def _run_operation(devbase_root: Path, op: str):
     if op == "delete":
         key = menu.text("削除する変数名", allow_empty=False)
         if key is None:
-            return _ARG_CANCEL
-        # 破壊的操作のため実行前に確認する (plan 3.4)。拒否 (False) / 中止 (None)
-        # は実行せずサブメニューへ戻る。
+            return None                # Ctrl-C → 全体中止
+        if key is menu.MENU_BACK:
+            return _ARG_CANCEL         # Esc → サブメニューへ戻る
+        # 破壊的操作のため実行前に確認する (plan 3.4)。拒否 (False) / Esc は実行せず
+        # サブメニューへ戻る。MENU_BACK は truthy のため is 判定を not より先に行う。
         ok = menu.confirm(f"変数 '{key}' をグローバル .env から削除しますか?",
                           default=False)
-        if not ok:
-            return _ARG_CANCEL
+        if ok is None:
+            return None                # Ctrl-C → 全体中止
+        if ok is menu.MENU_BACK or not ok:
+            return _ARG_CANCEL         # Esc / 拒否 → 実行しない
         return _dispatch(devbase_root, "delete", key=key)
 
     if op == "project":
@@ -382,7 +397,9 @@ def _run_operation(devbase_root: Path, op: str):
         dest = menu.path("出力先パス (空で既定: ./devbase-env-<タイムスタンプ>.dbenv)",
                          allow_empty=True)
         if dest is None:
-            return _ARG_CANCEL
+            return None                # Ctrl-C → 全体中止
+        if dest is menu.MENU_BACK:
+            return _ARG_CANCEL         # Esc → サブメニューへ戻る
         return _dispatch(devbase_root, "export", dest=(dest or None),
                          **_export_default_attrs())
 
@@ -392,7 +409,9 @@ def _run_operation(devbase_root: Path, op: str):
         # バックアップされる。
         source = menu.path("インポートするバンドルのパス", allow_empty=False)
         if source is None:
-            return _ARG_CANCEL
+            return None                # Ctrl-C → 全体中止
+        if source is menu.MENU_BACK:
+            return _ARG_CANCEL         # Esc → サブメニューへ戻る
         return _dispatch(devbase_root, "import", source=source,
                          **_import_default_attrs())
 

lib/devbase/tui/actions_plugin.py

@@ -172,32 +172,40 @@ def _select_repo_operation():
 def _run_operation(devbase_root: Path, op: str):
     """選択された plugin 操作の引数を収集して ``cmd_plugin`` へ委譲する。
 
-    戻り値: dispatch の rc (``int``) / ``_ARG_CANCEL`` (引数収集を中止 =
-    サブメニューへ戻る) / ``None`` (選択メニューで Ctrl-C → 全体中止)。
+    戻り値: dispatch の rc (``int``) / ``_ARG_CANCEL`` (Esc で引数収集を中止 =
+    サブメニューへ戻る) / ``None`` (選択・入力中の Ctrl-C → 全体中止)。
     破壊的な uninstall は ``menu.confirm`` で確認する (plan 3.4)。
     """
     if op == "list":
         # --available: 導入済み一覧の代わりに未導入の利用可能 plugin を表示する。
         available = menu.confirm(
             "未導入の利用可能 plugin を表示しますか (--available)?", default=False)
         if available is None:
-            return _ARG_CANCEL
+            return None                # Ctrl-C → 全体中止
+        if available is menu.MENU_BACK:
+            return _ARG_CANCEL         # Esc → サブメニューへ戻る
         return _dispatch(devbase_root, "list", available=available)
 
     if op == "install":
         source = menu.text(
             "インストールする plugin の source (名前 / URL / パス)",
             allow_empty=False)
         if source is None:
-            return _ARG_CANCEL
+            return None                # Ctrl-C → 全体中止
+        if source is menu.MENU_BACK:
+            return _ARG_CANCEL         # Esc → サブメニューへ戻る
         link = menu.confirm(
             "symlink としてインストールしますか (--link)?", default=False)
         if link is None:
-            return _ARG_CANCEL
+            return None                # Ctrl-C → 全体中止
+        if link is menu.MENU_BACK:
+            return _ARG_CANCEL         # Esc → サブメニューへ戻る
         install_all = menu.confirm(
             "リポジトリ内の全 plugin をインストールしますか (--all)?", default=False)
         if install_all is None:
-            return _ARG_CANCEL
+            return None                # Ctrl-C → 全体中止
+        if install_all is menu.MENU_BACK:
+            return _ARG_CANCEL         # Esc → サブメニューへ戻る
         return _dispatch(devbase_root, "install",
                          source=source, link=link, install_all=install_all)
 
@@ -209,8 +217,10 @@ def _run_operation(devbase_root: Path, op: str):
         if name is _ARG_CANCEL:
             return _ARG_CANCEL
         ok = menu.confirm(f"plugin '{name}' をアンインストールしますか?", default=False)
-        if not ok:                     # False (拒否) / None (中止) → 実行しない
-            return _ARG_CANCEL
+        if ok is None:
+            return None                # Ctrl-C → 全体中止
+        if ok is menu.MENU_BACK or not ok:
+            return _ARG_CANCEL         # Esc / 拒否 → 実行しない
         return _dispatch(devbase_root, "uninstall", name=name)
 
     if op == "update":
@@ -257,11 +267,15 @@ def _run_repo_operation(devbase_root: Path, op: str):
             "登録するリポジトリの URL (GitHub は owner/repo 短縮形も可)",
             allow_empty=False)
         if url is None:
-            return _ARG_CANCEL
+            return None                # Ctrl-C → 全体中止
+        if url is menu.MENU_BACK:
+            return _ARG_CANCEL         # Esc → サブメニューへ戻る
         # --name は任意 (空で URL から自動命名)。空文字は None へ変換して渡す。
         name = menu.text("カスタム名 (--name 空で自動)", allow_empty=True)
         if name is None:
-            return _ARG_CANCEL
+            return None                # Ctrl-C → 全体中止
+        if name is menu.MENU_BACK:
+            return _ARG_CANCEL         # Esc → サブメニューへ戻る
         return _dispatch(devbase_root, "repo",
                          repo_command="add", url=url, name=name or None)
 
@@ -272,13 +286,17 @@ def _run_repo_operation(devbase_root: Path, op: str):
         if name is _ARG_CANCEL:
             return _ARG_CANCEL
         ok = menu.confirm(f"リポジトリ '{name}' を削除しますか?", default=False)
-        if not ok:                     # False (拒否) / None (中止) → 実行しない
-            return _ARG_CANCEL
+        if ok is None:
+            return None                # Ctrl-C → 全体中止
+        if ok is menu.MENU_BACK or not ok:
+            return _ARG_CANCEL         # Esc / 拒否 → 実行しない
         force = menu.confirm(
             "未 commit / 未 push の変更があっても強制削除しますか (--force)?",
             default=False)
         if force is None:
-            return _ARG_CANCEL
+            return None                # Ctrl-C → 全体中止
+        if force is menu.MENU_BACK:
+            return _ARG_CANCEL         # Esc → サブメニューへ戻る
         return _dispatch(devbase_root, "repo",
                          repo_command="remove", name=name, force=force)
 

lib/devbase/tui/actions_project.py

@@ -58,10 +58,14 @@ def _select_project(rows: list[dict]):
     ("再ビルド (rebuild --no-cache)", "rebuild"),
 ]
 
-# 引数収集を Esc/Ctrl-C で中止したことを示す番兵 (= サブメニューへ戻る)。
-# dispatch の rc (int) や ``None`` (= 全体中止) と区別する。
+# 引数収集を Esc で中止したことを示す番兵 (= サブメニューへ戻る)。
+# dispatch の rc (int) や ``None`` (= Ctrl-C 全体中止) と区別する。
 _ARG_CANCEL = object()
 
+# _optional_int の Ctrl-C 番兵。「空入力 (None = 既定動作)」と衝突するため
+# ``None`` を直接返せず、専用番兵で返して呼び出し側で ``None`` (全体中止) へ変換する。
+_ABORT = object()
+
 
 def _select_action(name: str):
     """running 中プロジェクトの操作を選ぶサブメニュー。
@@ -77,15 +81,19 @@ def _select_action(name: str):
 def _optional_int(message: str, *, min_value: int = 0):
     """空入力を許す整数収集 (logs --tail 等)。
 
-    戻り値: ``int`` / ``None`` (空入力 = 既定動作) / ``_ARG_CANCEL`` (Esc・Ctrl-C 中止)。
+    戻り値: ``int`` / ``None`` (空入力 = 既定動作) / ``_ARG_CANCEL`` (Esc → サブ
+    メニューへ戻る) / ``_ABORT`` (Ctrl-C → 全体中止。空入力の ``None`` と衝突する
+    ため専用番兵で返し、呼び出し側で ``None`` へ変換する)。
     非数値・``min_value`` 未満は再入力を促す。``menu.integer`` は空入力で既定値を返す
     仕様のため、空 = None を表現したい optional な数値はこちらで扱う。``min_value`` の
     既定は 0 で、logs --tail に負数を渡して docker compose をエラーにするのを防ぐ。
     """
     while True:
         raw = menu.text(message, allow_empty=True)
         if raw is None:
-            return _ARG_CANCEL
+            return _ABORT              # Ctrl-C → 全体中止 (呼び出し側で None へ変換)
+        if raw is menu.MENU_BACK:
+            return _ARG_CANCEL         # Esc → サブメニューへ戻る
         if raw == "":
             return None
         try:
@@ -133,8 +141,8 @@ def _select_build_image(devbase_root: Path):
 def _run_operation(devbase_root: Path, name: str, op: str):
     """選択された操作の引数を収集して ``dispatch_lifecycle`` で起動する。
 
-    戻り値: dispatch の rc (``int``) / ``_ARG_CANCEL`` (引数収集を中止 = サブメニューへ
-    戻る) / ``None`` (選択メニューで Ctrl-C → 全体中止)。
+    戻り値: dispatch の rc (``int``) / ``_ARG_CANCEL`` (Esc で引数収集を中止 =
+    サブメニューへ戻る) / ``None`` (選択・入力中の Ctrl-C → 全体中止)。
     引数を要さない up/rebuild は即実行。down は破壊的のため ``menu.confirm`` で確認する。
     """
     if op in ("up", "rebuild"):
@@ -143,8 +151,10 @@ def _run_operation(devbase_root: Path, name: str, op: str):
 
     if op == "down":
         ok = menu.confirm(f"'{name}' のコンテナを停止しますか?", default=False)
-        if not ok:                     # False (拒否) / None (中止) → 実行しない
-            return _ARG_CANCEL
+        if ok is None:
+            return None                # Ctrl-C → 全体中止
+        if ok is menu.MENU_BACK or not ok:
+            return _ARG_CANCEL         # Esc / 拒否 → 実行しない
         return dispatch_lifecycle("down", name)
 
     if op == "login":
@@ -153,28 +163,38 @@ def _run_operation(devbase_root: Path, name: str, op: str):
         # min_value=1 で正の整数を保証する。cmd_login の index は文字列契約なので str 化。
         index = menu.integer("ログインするコンテナ番号", default=1, min_value=1)
         if index is None:
-            return _ARG_CANCEL
+            return None                # Ctrl-C → 全体中止
+        if index is menu.MENU_BACK:
+            return _ARG_CANCEL         # Esc → サブメニューへ戻る
         return dispatch_lifecycle("login", name, index=str(index))
 
     if op == "ps":
         all_c = menu.confirm("停止中も含め全コンテナを表示しますか (--all)?", default=False)
         if all_c is None:
-            return _ARG_CANCEL
+            return None                # Ctrl-C → 全体中止
+        if all_c is menu.MENU_BACK:
+            return _ARG_CANCEL         # Esc → サブメニューへ戻る
         return dispatch_lifecycle("ps", name, all=all_c)
 
     if op == "logs":
         follow = menu.confirm("ログを追従表示しますか (--follow)?", default=False)
         if follow is None:
-            return _ARG_CANCEL
+            return None                # Ctrl-C → 全体中止
+        if follow is menu.MENU_BACK:
+            return _ARG_CANCEL         # Esc → サブメニューへ戻る
         tail = _optional_int("末尾何行を表示しますか (空で全件)")
+        if tail is _ABORT:
+            return None                # Ctrl-C → 全体中止
         if tail is _ARG_CANCEL:
-            return _ARG_CANCEL
+            return _ARG_CANCEL         # Esc → サブメニューへ戻る
         return dispatch_lifecycle("logs", name, follow=follow, tail=tail)
 
     if op == "scale":
         new_scale = menu.integer(f"'{name}' の新しいコンテナ数", min_value=1)
         if new_scale is None:
-            return _ARG_CANCEL
+            return None                # Ctrl-C → 全体中止
+        if new_scale is menu.MENU_BACK:
+            return _ARG_CANCEL         # Esc → サブメニューへ戻る
         return dispatch_lifecycle("scale", name, new_scale=new_scale)
 
     if op == "build":