Port ask_user_question TUI to termflow

The Rich-markup renderers were always the real UI here -- prompt_toolkit
just wrapped their ANSI output. They now return raw ANSI strings, gain a
left-panel header renderer, and QuestionTUI drives everything with a
plain read_key loop per the headless-widget recipe (injectable
key_source/output/size/use_alt_screen). The inactivity timeout rides the
resize-poll heartbeat instead of a background asyncio task; Tab-peek
drops out of the alt screen and waits for a key. QuestionUIState, the
models, the handler, and the async picker seam are untouched. Old
prompt_toolkit key-event tests replaced by scripted full-journey drives
(fit-by-construction asserted on every painted line).

Author: mpfaffenberger

code_puppy/tools/ask_user_question/__init__.py

@@ -1,8 +1,8 @@
 """Ask User Question tool for code-puppy.
 
 This tool allows agents to ask users interactive multiple-choice questions
-through a terminal TUI interface. Uses prompt_toolkit for the split-panel
-UI similar to the /colors command.
+through a terminal TUI interface. Termflow split-panel UI: question
+headers on the left, the current question and its options on the right.
 """
 
 from .handler import ask_user_question

code_puppy/tools/ask_user_question/renderers.py

@@ -10,7 +10,6 @@
 import shutil
 from typing import TYPE_CHECKING
 
-from prompt_toolkit.formatted_text import ANSI
 from rich.console import Console
 from rich.markup import escape as rich_escape
 
@@ -23,6 +22,7 @@
     BORDER_DOUBLE,
     CHECK_MARK,
     CURSOR_POINTER,
+    CURSOR_TRIANGLE,
     HELP_BORDER_WIDTH,
     MAX_READABLE_WIDTH,
     OTHER_OPTION_DESCRIPTION,
@@ -42,7 +42,7 @@ def render_question_panel(
     state: QuestionUIState,
     colors: RichColors | None = None,
     available_width: int | None = None,
-) -> ANSI:
+) -> str:
     """Render the right panel with the current question.
 
     Wraps the inner renderer in a guard so a Rich markup error in user-supplied
@@ -62,14 +62,14 @@ def render_question_panel(
             f"[render error: {type(exc).__name__}: {exc}]",
             markup=False,
         )
-        return ANSI(buffer.getvalue())
+        return buffer.getvalue()
 
 
 def _render_question_panel_unsafe(
     state: QuestionUIState,
     colors: RichColors | None,
     available_width: int | None,
-) -> ANSI:
+) -> str:
     """Actual rendering implementation. Caller wraps this in a guard."""
     if colors is None:
         colors = get_rich_colors()
@@ -191,10 +191,10 @@ def _render_question_panel_unsafe(
         remaining = state.get_time_remaining()
         console.print()
         console.print(
-            f"{pad}[{colors.timeout_warning}]⚠ Timeout in {remaining}s - press any key to continue[/{colors.timeout_warning}]"
+            f"{pad}[{colors.timeout_warning}] Timeout in {remaining}s - press any key to continue[/{colors.timeout_warning}]"
         )
 
-    return ANSI(buffer.getvalue())
+    return buffer.getvalue()
 
 
 # Help overlay shortcut data: (section_name, [(primary_key, alt_key_or_None, description), ...])
@@ -234,7 +234,7 @@ def _render_question_panel_unsafe(
 
 def _render_help_overlay(
     console: Console, buffer: io.StringIO, colors: RichColors
-) -> ANSI:
+) -> str:
     """Render the help overlay using data-driven approach."""
     pad = PANEL_CONTENT_PADDING
     border = colors.help_border
@@ -270,7 +270,64 @@ def _render_help_overlay(
     )
     console.print(border_line)
 
-    return ANSI(buffer.getvalue())
+    return buffer.getvalue()
+
+
+def render_header_panel(
+    state: QuestionUIState,
+    colors: RichColors | None = None,
+    width: int = 30,
+) -> str:
+    """Render the left panel: question headers with progress checkmarks."""
+    if colors is None:
+        colors = get_rich_colors()
+    buffer = io.StringIO()
+    console = Console(
+        file=buffer,
+        force_terminal=True,
+        width=max(width, 10),
+        legacy_windows=False,
+        color_system="truecolor",
+        no_color=False,
+    )
+    pad = PANEL_CONTENT_PADDING
+    console.print(f"{pad}[{colors.header}]Questions[/{colors.header}]")
+    console.print()
+    for i, question in enumerate(state.questions):
+        is_current = i == state.current_question_index
+        is_answered = state.is_question_answered(i)
+        cursor = f"{CURSOR_TRIANGLE} " if is_current else "  "
+        status = f"{CHECK_MARK} " if is_answered else "  "
+        header = rich_escape(question.header)
+        if is_answered:
+            style = colors.selected
+        elif is_current:
+            style = colors.cursor
+        else:
+            style = colors.description
+        if style:
+            console.print(f"{pad}{cursor}[{style}]{status}{header}[/{style}]")
+        else:
+            console.print(f"{pad}{cursor}{status}{header}")
+    console.print()
+    console.print(
+        f"{pad}[{colors.help_key}]{ARROW_LEFT}{ARROW_RIGHT}[/{colors.help_key}]"
+        f"[{colors.description}] Switch question[/{colors.description}]"
+    )
+    console.print(
+        f"{pad}[{colors.help_key}]{ARROW_UP}{ARROW_DOWN}[/{colors.help_key}]"
+        f"[{colors.description}] Navigate options[/{colors.description}]"
+    )
+    console.print()
+    console.print(
+        f"{pad}[{colors.help_key}]Ctrl+S[/{colors.help_key}]"
+        f"[{colors.description}] Submit[/{colors.description}]"
+    )
+    console.print(
+        f"{pad}[{colors.help_key}]Tab[/{colors.help_key}]"
+        f"[{colors.description}] Peek behind[/{colors.description}]"
+    )
+    return buffer.getvalue()
 
 
 def _render_option(

code_puppy/tools/ask_user_question/terminal_ui.py

@@ -1,6 +1,6 @@
 """Terminal UI for ask_user_question tool.
 
-Uses prompt_toolkit for a split-panel TUI similar to the /colors command.
+Termflow split-panel TUI (state machine here, event loop in tui_loop).
 Left panel (20%): Question headers/tabs
 Right panel (80%): Current question with options
 
@@ -320,8 +320,8 @@ async def interactive_question_picker(
     state.timeout_seconds = timeout_seconds
     set_awaiting_user_input(True)
 
-    # Suspend the agent-runtime key listener so prompt_toolkit owns stdin:
-    # racing readers swallow ~half the keystrokes. Use the REFCOUNTED variant —
+    # Suspend the agent-runtime key listener so the widget owns stdin:
+    # racing readers swallow ~half the keystrokes. Use the REFCOUNTED variant --
     # tui_loop nests suspended_run_ui() here, and a raw resume would wake the
     # listener while an outer suspension still held stdin. Local import for standalone callers.
     from code_puppy.agents._key_listeners import suspended_key_listener
@@ -330,7 +330,7 @@ async def interactive_question_picker(
         with suspended_key_listener():
             from .tui_loop import run_question_tui
 
-            # prompt_toolkit manages alt screen via full_screen=True
+            # The widget manages raw mode + alt screen itself.
             return await run_question_tui(state)
     finally:
         set_awaiting_user_input(False)