claude-code-conductor 2.70.0__tar.gz → 2.71.1__tar.gz

{claude_code_conductor-2.70.0 → claude_code_conductor-2.71.1}/.claude/CLAUDE.md

@@ -82,5 +82,6 @@ C3 は、業務アプリケーション開発で製品としての品質を保
 - **`isolation: worktree`** / **`permissionMode`** / **`tools` 制限** など agent フロントマターの一部キーは Claude Code 仕様。adapter 側では読み替え不能なものは無視される（OpenCode adapter は全 agent に `bash/read/edit/write/websearch` を一律付与する）
 
 - **自律モード**: autonomous-mode は Claude Code 専用。Codex / Cursor / OpenCode では自律宣言は常に無効＝HITL で動作する（モード行の検証は `mode_line.py`・Bash 経由に依存し、他プラットフォームで安全に再現できないため。検証できない → HITL の fail-closed 原則がそのまま正しい挙動になる）。adapter 生成物にも autonomous-mode skill は写像されない。
+- **`.claude/rules/` の自動ロード**は Claude Code の機能。OpenCode では adapter が `AGENTS.md` に rules を埋め込む。**Codex / Cursor の生成物には rules は写像されない**（規律を効かせたい場合は各プラットフォームの規約ファイルへ手動転記する）
 
 レポート（`.claude/reports/`）・state（`.claude/state/`）・memory（`.claude/agent-memory/`）のファイル名と書き込み先は全プラットフォーム共通。adapter 生成物の詳細は `c3 init --platform codex|cursor|opencode` で出力される `AGENTS.md` / `.cursor/rules/c3-core.mdc` / `.opencode/agents/` を参照。

{claude_code_conductor-2.70.0 → claude_code_conductor-2.71.1}/.claude/docs/config-policy.md

@@ -191,7 +191,7 @@ src/c3/migrations/                     SQLite schema migration SQL ファイル
 | 1 | `.claude/hooks/*.py` | ○ | ○ | Claude Code lifecycle hook の実体。配布先で動作する。v2.20.0 で `hooks/schema.sql` を削除し SQLite スキーマは `src/c3/migrations/` に移管 |
 | 2 | `.claude/agents/*.md` | ○ | ○ | ペルソナ定義。配布先で読まれる |
 | 3 | `.claude/skills/*/` | ○ | ○ | オーケストレーション/ユーティリティ skill 定義（`scripts/` / `templates/` 等サブディレクトリ含む）|
-| 4 | `.claude/rules/*.md` | ○ | ○ | C3 配布デフォルトルール（常時注入対象）。**配布元では 0 件**（`.claude/rules/` 直下に `.md` は無く `promoted/` のみ）。利用先が `/setup` で `coding-standards.md` を生成した時点でこのカテゴリが成立する |
+| 4 | `.claude/rules/*.md` | ○ | ○ | C3 配布デフォルトルール（常時注入対象）。配布元は `judgment-principles.md` の 1 件（ほかは `promoted/` のみ）。利用先ではこれに `/setup` 生成の `coding-standards.md` 等が加わる |
 | 5 | `.claude/rules/promoted/*` | ○ | ×（`index.md` は INIT_ONLY） | プロジェクト固有昇格ルール。配布元の `promoted/index.md` は空雛形のみ配布。利用先で `/promote-pattern` が追記する **ユーザー所有領域**。`index.md` は `INIT_ONLY_PATTERNS` で上書きから保護される。昇格ルール本体（`YYYYMMDD-{id}.md`）は template 側に存在しないため `_walk_diff` の走査対象にならず元から無事 |
 | 6 | `.claude/docs/*.md` | △（一部のみ） | ○ | 利用先向けリファレンス。配布対象は `autonomous-mode-onboarding.md` / `config-policy.md`（本ドキュメント）/ `nul-boundary.md` / `parallel-agents-setup.md` / `platform-adapters.md` / `settings.json.md` の 6 ファイル。配布元固有の設計メモ等は `_excludes.py` で個別除外。`taxonomy.md` は tracked（GitHub 公開）だが EXCLUDE 対象のため wheel 非配布（詳細は §7 落とし穴 2 参照）。 |
 | 7 | `.claude/CLAUDE.md` | ○ | ○ | 配布先で常時注入される共通ルール |

claude_code_conductor-2.71.1/.claude/rules/judgment-principles.md

@@ -0,0 +1,21 @@
+# 判定・検証の判断原則
+
+判定・検証を行う際に守る 3 つの規律。要素は原文の逐語を保持する。
+
+## 1. 安全側に倒す
+
+「現状 0 hit だから実装しない」判断はせず、安全側に倒す。
+
+実例: 2026-08-06 のユーザー裁定で、根拠不足のまま省略した判断 2 件を是正し、件数を見ずに沈黙していた判断をさらに 2 件検出した。
+
+## 2. 到達可能性の判定
+
+到達可能性は「参照 0 件」でなく「発火しうる経路が無い」で判定する（削除・影響判定の規約）。当たるべき経路＝動的ロード / subprocess / 名前写像 / 設定 JSON 登録・monkeypatch 対象の導出タイミング（呼び出し時か import 時か）・ローカル skip テストは「実行されていない」前提で判定・探索ツールの射程を明示する（gitignored 配下は rg で 0 件・grep -rn でヒットし、真偽が道具で反転する）。
+
+実例: 2026-08-13 に同型の誤判定が実働で再演し、CI 5 構成全赤を招いた。
+
+## 3. 機械走査の 3 点申告
+
+機械走査を名乗るときは 3 点を申告する: (a) 走査対象の形式を全部数えて申告（表行・引用ブロック・見出し・本文） (b) 版順の根拠を明示（ファイル名順とは限らない） (c) 検証が測っている性質を書く（「バイト一致」は書き写しの正確さであって拾う版の正しさではない）。
+
+実例: 2026-08-07 の集約・移設作業で「畳む」工程の取り落としを 3 回連続で実測した。

{claude_code_conductor-2.70.0 → claude_code_conductor-2.71.1}/.claude/skills/dev-workflow/SKILL.md

@@ -456,6 +456,8 @@ c3 run .claude/skills/dev-workflow/scripts/record_agent_outcome.py \
 
 上流修正の連鎖を経て C-3 に戻ってきた場合、毎回自動再走はしない。AskUserQuestion で再監査の要否を確認する（このブロックに副作用ツールを混在させない）:
 
+是正起因の欠陥が連続している場合は E-3 の『是正ループの打切条件』を参照する（前提を疑う打切）。
+
 ```json
 {
   "questions": [{
@@ -1121,6 +1123,9 @@ AskUserQuestion でフィードバックを確認し、対象 reviewer（CR／SR
 2. **保守性指摘の許容条件**: 保守性向上を理由に是正を許容する場合、将来の運用コスト（PR diff 量の増加・触る箇所数）を許容理由に明記する
 3. **先送りルール**: トレードオフで先送りする場合は「トリガー付き起票」のみ許す。具体的な再対応条件を明示する
 4. **機構コスト**: 共通化・新規機構の導入は、その機構自体の保守コストも天秤に載せて判定する
+5. **実行で確かめられる指摘は試作・実データで裏取りしてから翻訳する**: 指摘の真偽・方向が実行で確かめられる場合（組み合わせロジック・件数の主張・走査結果）、対応表や差し戻し指示へ翻訳する前に試作を実データに当てる。自分の是正案も裏取りの対象に含める。読解だけの裁定は「正しいものを欠陥と呼ぶ」「欠陥を正しいと呼ぶ」を同時に起こした実績がある（2026-08-06）
+
+**是正ループの打切条件（E 周回・計画監査サイクル共通）:** 是正が新たな欠陥を生む周回が同一スライス内の監査・レビュー周回で 3 連続したら、周回を重ねず前提そのものを疑う。打切の信号は周回数ではなく「**前提が一度も疑われていない**こと」。前提転換の例: 機械条件による自動判定をやめ、人間への 1 問確認に縮退する（低頻度イベントの例外処理は機械条件で厳密化するより人間の 1 問ゲートに寄せる方が欠陥面が小さい・2026-08-13 実測）。自律運転中に本信号が立った場合は「情報不足の質問」の関所としてユーザーへ停止確認する
 
 ---
 

{claude_code_conductor-2.70.0 → claude_code_conductor-2.71.1}/.claude/skills/dev-workflow/references/reachability-map.md

@@ -5,6 +5,7 @@
 ## 到達経路一覧
 
 表の列構成: 経路（配置方法）、実パス（ファイルパスまたは「—」）、届く role（対象読み手）、条件（前提・性質）
+本表の到達可否は Claude Code を前提とする。OpenCode adapter は `.claude/rules/` **直下**の `.md` と `.claude/CLAUDE.md` を `AGENTS.md` に埋め込む（サブディレクトリと skills は別経路）。Codex / Cursor への到達は `.claude/CLAUDE.md` の Platform Compatibility を参照
 
 | 経路 | 実パス | 届く role | 条件 |
 |---|---|---|---|
@@ -22,6 +23,7 @@
 | plan-design-guidelines.md | .claude/skills/dev-workflow/references/plan-design-guidelines.md | planner（C-2） | フェーズ C 計画作成時に参照・守るべき規約 |
 | record-protocol.md | .claude/skills/dev-workflow/references/record-protocol.md | 親 Claude のみ（記録対象 role である developer/tester/architect/planner の agent 定義からは参照されない） | 各ゲートの record bash ブロック exec 時に Read 指示される。機械適用・帰属判定共通規定含む |
 | c3-omission-declaration.md | .claude/skills/dev-workflow/references/c3-omission-declaration.md | C-2・C-3 担当者 | C-2・C-3 到達時に Read 指示される。C-2 で C-3省略宣言の生成ルール・C-3 ステップ 0 の帰属判定共通規定 |
+| judgment-principles.md | .claude/rules/judgment-principles.md | 全 role | 判定・検証の規律 3 件（rules 再帰自動ロード） |
 
 ## 置き場所デシジョン（3 手順）
 

{claude_code_conductor-2.70.0 → claude_code_conductor-2.71.1}/CHANGELOG.md

@@ -1,5 +1,71 @@
 # Changelog
 
+## [2.71.1] - 2026-08-14
+
+### 修正
+
+- **`c3 ask` の Windows 非対話判定が機能せず無限ハングする欠陥を修正した**（v2.71.0
+  「既知の問題」の解消）。`sys.stdin.isatty()` が Windows で stdin を NUL / `/dev/null` へ
+  リダイレクトした場合にも True を誤返却し、`--response` 未指定で exit 1 にならず
+  `msvcrt.getwch()`（実コンソール直読み）で無限ハングしていた。判定を
+  `stdin_is_interactive_console()`（Windows は GetConsoleMode で実コンソール接続を判定・
+  POSIX は従来どおり `isatty()`）へ置換し、入口ゲートと対話パス直前の二重ゲートを
+  同一判定へ統一した
+- 判定ヘルパーを共有モジュール `src/c3/_terminal.py` へ移設し、関数全体を一箇所集約で
+  fail-closed 化した（想定外例外でも非対話扱い＝exit 1 契約を維持・KeyboardInterrupt /
+  SystemExit は伝播。`question.py` 側は re-export でシーム維持）
+- `_read_key` の POSIX 分岐に空読み EOF ガードを追加した（EOF 時のビジーループを解消し
+  既存の exit 1 経路へ接続）
+- `docs/cli-reference.md` の v2.71 既知問題注記を修正後の実挙動へ更新した
+
+### 内部
+
+- `tests/test_cli_ask.py` に回帰・凍結テスト計 17 件を追加した（修正前状態での赤化実証・
+  内部依存注入による fail-closed 凍結・Windows 限定 subprocess+timeout 統合テストを含む。
+  フルスイート 3322 緑・CI 全緑 run 31755508514）
+
+## [2.71.0] - 2026-08-14
+
+### 追加
+
+- **判定・検証の判断原則を `.claude/rules/judgment-principles.md` として新設した**（配布物・
+  rules 再帰自動ロードで全 role のコンテキストへ常時注入）。3 規律: ①「現状 0 hit だから
+  実装しない」判断はせず安全側に倒す ②到達可能性は「参照 0 件」でなく「発火しうる経路が
+  無い」で判定する（当たるべき経路＝動的ロード / subprocess / 名前写像 / 設定 JSON 登録・
+  monkeypatch 対象の導出タイミング・ローカル skip テスト・探索ツールの射程明示）
+  ③機械走査を名乗るときの 3 点申告（走査対象形式の全数・版順の根拠・検証が測る性質）。
+  実在検査は reachability-map への行追加により既存テスト（`test_reachability_map.py`）が担保
+- **dev-workflow フェーズ E-3「裁定の判断基準」に第 5 項を追加した**: 実行で確かめられる
+  指摘（組み合わせロジック・件数の主張・走査結果）は試作・実データで裏取りしてから
+  差し戻しへ翻訳する。自分の是正案も裏取りの対象に含める
+- **E-3 に「是正ループの打切条件」を追加した**（E 周回・計画監査サイクル共通）: 是正が
+  新たな欠陥を生む周回が同一スライス内で 3 連続したら、周回を重ねず前提そのものを疑う。
+  打切の信号は周回数ではなく「前提が一度も疑われていない」こと。自律運転中は「情報不足の
+  質問」の関所としてユーザーへ停止確認する。C-3 ステップ 5 からも参照
+- **`docs/cli-reference.md` に未文書化だった CLI 仕様 14 件を追記した**: `c3 init --target` /
+  `--git` / `--no-git` と TTY 同意プロンプト、`c3 update --target` / `--yes` と付随処理 4 点
+  （breaking changes 表示・MAJOR 承認・deletions 削除・checkpoint 更新）、`c3 doctor --quiet`、
+  `c3 tier stats --role`、`c3 recall --target`、`c3 metrics` の入力検証と上限、`c3 ask` の
+  exit code 表、`c3 plan waves` の exit 2、環境変数 `C3_DB_PATH` / `NO_COLOR`、サブコマンド
+  未指定・不正名と argparse 引数検証の exit 2
+
+### 修正
+
+- reachability-map（到達可能性マップ）に表の前提注記を追加した（Claude Code 前提・
+  OpenCode adapter は `.claude/rules/` 直下と `.claude/CLAUDE.md` のみ埋め込む・Codex /
+  Cursor への到達は Platform Compatibility を参照）
+- `.claude/CLAUDE.md` の Platform Compatibility に「Codex / Cursor の生成物には rules は
+  写像されない」の限界告知を追加した
+- `.claude/docs/config-policy.md` の配布判断マトリクス カテゴリ #4（rules）の「配布元では
+  0 件」を実態（`judgment-principles.md` 1 件）へ更新した
+
+### 既知の問題
+
+- `c3 ask` は Windows で stdin を NUL / `/dev/null` へリダイレクトした場合に非対話判定
+  （`sys.stdin.isatty()`）が誤判定となり、`--response` 未指定だと exit 1 にならず対話待ちで
+  ハングする（E-0 実行検証の実測で発見・`docs/cli-reference.md` に注記済み）。非対話実行では
+  常に `--response` を指定すること。コード修正は別スライスで対応予定
+
 ## [2.70.0] - 2026-08-13
 
 ### 追加

{claude_code_conductor-2.70.0 → claude_code_conductor-2.71.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: claude-code-conductor
-Version: 2.70.0
+Version: 2.71.1
 Summary: Multi-agent orchestration framework for Claude Code with Codex/Cursor adapters (C3)
 Project-URL: Homepage, https://github.com/satoh-y-0323/claude-code-conductor
 Project-URL: Repository, https://github.com/satoh-y-0323/claude-code-conductor

{claude_code_conductor-2.70.0 → claude_code_conductor-2.71.1}/src/c3/__init__.py

@@ -1,3 +1,3 @@
 """Claude Code Conductor (C3) - multi-agent orchestration framework for Claude Code."""
 
-__version__ = "2.70.0"
+__version__ = "2.71.1"

claude_code_conductor-2.71.1/src/c3/_terminal.py

@@ -0,0 +1,118 @@
+"""Shared terminal helpers for c3 CLI subcommands.
+
+Used by cli_doctor.py, cli_tier.py, cli_ask.py, question.py, and future
+cli_*.py to keep terminal-facing logic in one place:
+
+- ``supports_color`` / ``strip_ansi`` / ``sanitize_terminal_text``: ANSI
+  color support detection, escape-sequence stripping, and sanitization of
+  untrusted text before printing.
+- ``stdin_is_interactive_console``: console-attachment detection for stdin
+  (whether an interactive console is really attached, as opposed to a NUL /
+  pipe / file redirection).
+"""
+
+from __future__ import annotations
+
+import os
+import re
+import sys
+
+
+# CSI sequences with final byte 'm' (color / SGR). Other escape sequences
+# (e.g. \033c reset, OSC \033]0;...\007 title) are not handled by _strip_ansi
+# and would skew column-width calculations if they appeared in cell text.
+_CSI_M_RE = re.compile(r"\033\[[0-9;]*m")
+
+# Control characters disallowed when printing untrusted text to the terminal.
+# Allow newline (\n), tab (\t), carriage return (\r) but strip any other
+# C0 control or escape character (\x1b) so that ANSI/title-injection cannot
+# happen via DB-stored values such as ``current_step`` / ``error_message``.
+# Also strip the Unicode line/paragraph separators U+2028 / U+2029 so they
+# match the init-session SR L-2 sanitization spec (removes U+2028 / U+2029).
+# NEL (U+0085) is intentionally NOT included per that spec.
+_DISALLOWED_CONTROL_RE = re.compile("[\x00-\x08\x0b\x0c\x0e-\x1f\x7f" + chr(0x2028) + chr(0x2029) + "]")
+
+
+def supports_color() -> bool:
+    """Return True if stdout supports ANSI color sequences.
+
+    Honors the NO_COLOR environment variable (https://no-color.org/) and
+    requires stdout to be a TTY.
+    """
+    if os.environ.get("NO_COLOR"):
+        return False
+    if not sys.stdout.isatty():
+        return False
+    return True
+
+
+def strip_ansi(s: str) -> str:
+    """Remove ANSI CSI 'm' (SGR / color) sequences for visible-width calc.
+
+    Note: handles only ``\\033[...m`` style sequences. Other escape sequences
+    such as cursor movement (``\\033[H``), screen clear (``\\033[2J``), or
+    OSC title-set are intentionally not stripped here because the cells we
+    measure should never contain them.
+    """
+    return _CSI_M_RE.sub("", s)
+
+
+def sanitize_terminal_text(s: str) -> str:
+    """Strip control / escape characters from untrusted text before printing.
+
+    Used for DB-sourced strings (``current_step`` / ``error_message``) so
+    they cannot inject ANSI escape sequences (title, cursor, screen clear)
+    into the terminal. Newlines / tabs / carriage returns are preserved.
+    The Unicode line/paragraph separators U+2028 / U+2029 are also stripped
+    (init-session SR L-2 sanitization spec); NEL (U+0085) is out of scope.
+    """
+    if not s:
+        return s
+    return _DISALLOWED_CONTROL_RE.sub("", s)
+
+
+def stdin_is_interactive_console() -> bool:
+    """Return True only when stdin is attached to a real interactive console.
+
+    Windows の CRT ``_isatty()``（``sys.stdin.isatty()`` の内部実装）は対象ハンドルが
+    ``FILE_TYPE_CHAR`` かどうかしか見ておらず、NUL デバイス（``subprocess.DEVNULL`` /
+    ``NUL`` リダイレクト）もコンソールと同じ ``FILE_TYPE_CHAR`` に分類されるため
+    誤って True を返す（実測: debug-analysis-20260814-011032.md）。
+    Windows では ``GetConsoleMode``（実コンソールハンドルに対してのみ成功する
+    Win32 API）で実際のコンソール接続を確認し、NUL・パイプ・ファイルいずれの
+    リダイレクトも False として扱う。POSIX は ``isatty()`` が ``/dev/null`` に
+    対して標準どおり正しく False を返すためそのまま使う。
+
+    関数全体を ``except Exception`` で包み、内部でどの分岐がどの例外型を投げても
+    送出せず False を返す (fail-closed)。POSIX 分岐の ``sys.stdin.isatty()`` は
+    ``sys.stdin`` が None のケース (pythonw.exe / PyInstaller --windowed など) で
+    ``AttributeError`` を投げうるが、これを呼び出し元へ伝播させると
+    ``c3 ask`` の「exit 1」契約が破れる (SR-R-001 / CR-E-001)。呼び出し位置ごとに
+    try/except を足すのではなく、ここ一箇所へ集約して将来の呼び出し箇所追加にも
+    自動的に効かせる。``KeyboardInterrupt`` / ``SystemExit`` は ``BaseException``
+    直属で ``Exception`` を継承しないため握り潰さない (Ctrl-C は従来どおり伝播)。
+    """
+    try:
+        if os.name == "nt":
+            return _windows_console_attached()
+        return sys.stdin.isatty()
+    except Exception:
+        return False
+
+
+def _windows_console_attached() -> bool:
+    try:
+        import ctypes
+        import msvcrt
+        from ctypes import wintypes
+
+        handle = msvcrt.get_osfhandle(0)
+        kernel32 = ctypes.windll.kernel32
+        kernel32.GetConsoleMode.argtypes = [wintypes.HANDLE, ctypes.POINTER(wintypes.DWORD)]
+        kernel32.GetConsoleMode.restype = wintypes.BOOL
+        mode = wintypes.DWORD()
+        return bool(kernel32.GetConsoleMode(wintypes.HANDLE(handle), ctypes.byref(mode)))
+    except Exception:
+        # 判定不能ならすべて非対話扱いに倒す (fail-closed)。answer_questions() 経由の
+        # 呼び出し位置も含め、想定外の例外型で対話ゲートを突破させない。
+        return False

{claude_code_conductor-2.70.0 → claude_code_conductor-2.71.1}/src/c3/cli_ask.py

@@ -7,6 +7,7 @@ import json
 import sys
 from pathlib import Path
 
+from c3._terminal import stdin_is_interactive_console
 from c3.question import answer_questions, load_questions
 
 
@@ -47,9 +48,16 @@ def register(subparsers: argparse._SubParsersAction) -> None:
 
 
 def handle(args: argparse.Namespace) -> int:
-    if args.response is None and not sys.stdin.isatty():
-        print("c3 ask: --response is required in non-interactive mode", file=sys.stderr)
-        return 1
+    if args.response is None:
+        # 判定関数が想定外の例外を出しても traceback で落とさず「非対話」へ倒す
+        # (fail-closed)。--response 未指定時の exit 1 契約を例外型に依存させない。
+        try:
+            interactive = stdin_is_interactive_console()
+        except Exception:
+            interactive = False
+        if not interactive:
+            print("c3 ask: --response is required in non-interactive mode", file=sys.stderr)
+            return 1
 
     try:
         if args.file is not None:

{claude_code_conductor-2.70.0 → claude_code_conductor-2.71.1}/src/c3/question.py

@@ -13,6 +13,12 @@ from dataclasses import dataclass
 from pathlib import Path
 from typing import Any
 
+# stdin_is_interactive_console() は共有ターミナルヘルパー _terminal.py が正本
+# (CR-R-003)。ここでの import は question.py 内部の呼び出し元 (answer_questions /
+# _raw_keyboard_supported) が使うと同時に、``question.stdin_is_interactive_console``
+# という従来の参照名を後方互換で維持する re-export を兼ねる。
+from c3._terminal import stdin_is_interactive_console
+
 
 @dataclass(frozen=True)
 class Option:
@@ -63,7 +69,7 @@ def answer_questions(
         if current_response is not None:
             selected = _select_from_response(question, current_response)
         else:
-            use_interactive = sys.stdin.isatty() if interactive is None else interactive
+            use_interactive = stdin_is_interactive_console() if interactive is None else interactive
             selected = _select_interactively(question) if use_interactive else _select_default(question)
         answers.append(_answer_payload(question, selected))
     return {"answers": answers}
@@ -383,7 +389,16 @@ def _clear_screen() -> None:
 
 
 def _raw_keyboard_supported() -> bool:
-    return os.name in ("nt", "posix")
+    # OS が raw keyboard API を持つかではなく、今この stdin に実コンソールが
+    # 接続されているかを見る。旧実装（os.name in ("nt", "posix")）は事実上
+    # 常に True を返し、NUL/パイプ/ファイルへのリダイレクト時でも
+    # _select_with_line_input() の安全網（input() → EOFError）を恒久的に
+    # 迂回させ msvcrt.getwch() の無限ブロックを招いていた
+    # （debug-analysis-20260814-011032.md 欠陥B）。
+    # answer_questions() の外側ゲートと同じ判定をここでも呼ぶのは、interactive=True を
+    # 明示指定して外側ゲートを迂回する呼び出し元にも安全網を効かせるための意図的な
+    # 再検証であり、単純な重複ではない（削除・簡略化しないこと）。
+    return stdin_is_interactive_console()
 
 
 def _read_key() -> str:
@@ -410,6 +425,11 @@ def _read_key() -> str:
     try:
         tty.setraw(fd)
         ch = sys.stdin.read(1)
+        if ch == "":
+            # EOF（read が空文字列）。空文字列を返すと _select_interactively() の
+            # ループが再描画しながら回り続け CPU ビジーループになるため、
+            # EOFError を送出して呼び出し元（cli_ask.handle の except EOFError）へ委ねる。
+            raise EOFError("stdin reached EOF while reading a key")
         if ch == "\x1b":
             nxt = sys.stdin.read(2)
             return {"[A": "up", "[B": "down", "[C": "right", "[D": "left"}.get(nxt, "escape")