🎨 Palette: [UX improvement] Enhance TUI interactivity and interrupt handling

[haseeb-heaven]

💡 What: Added explicit inline choices for prompts when TTY is unavailable, clarified the cancellation shortcut (Esc/Ctrl-C) in the TUI footer, and explicitly mapped \x03 (Ctrl-C) to trigger an exit in raw keyboard mode.
🎯 Why: To make the terminal interface more intuitive, provide clearer fallback prompts in headless testing environments, and prevent the application from acting as a keyboard trap when users intuitively press Ctrl-C.
📸 Before/After: N/A (Terminal UI tweaks, no visual HTML change)
♿ Accessibility: Prevents "keyboard traps" in the raw-mode terminal interface and provides better explicit guidance for cancellation and selection, improving general usability.

---

PR created automatically by Jules for task 591284406558102273 started by @haseeb-heaven

Summary by CodeRabbit

Release Notes

• New Features

  • Terminal UI selector prompts now display available options directly within the prompt text for improved clarity.
  • Default help messaging expanded to include clear cancellation instructions.

• Bug Fixes

  • Terminal UI now consistently recognizes both Escape and Ctrl-C as cancellation commands.

[google-labs-jules]

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.

---

For security, I will only act on instructions from the user who triggered this task.

[greptile-apps]

Your free trial has ended. If you'd like to continue receiving code reviews, you can add a payment method here.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 34a6f0df-9ebc-481e-a6f7-743753a4a61f

📥 Commits

Reviewing files that changed from the base of the PR and between 2a47494 and 49a17ce.

📒 Files selected for processing (2)

• .jules/palette.md
• libs/terminal_ui.py

---

📝 Walkthrough

Walkthrough

The PR improves terminal UI selection behavior by expanding help text with cancellation instructions, embedding available options directly in prompts, and unifying keyboard interrupt handling to treat both Escape and Ctrl-C identically. Design specifications document the new requirements for headless environments.

Changes

Terminal UI Selection UX

Layer / File(s)	Summary
TUI design specifications .jules/palette.md	Design documentation specifies explicit inline choice options for fallback prompts and manual interrupt-byte mapping in raw-mode keyboard handling.
Terminal UI prompt and cancellation updates libs/terminal_ui.py	Selector footer default help text expanded to document Esc/Ctrl-C cancellation; _select_option prompt interpolates available options; key handler matches both escape and Ctrl+C (\x03) for unified cancellation behavior.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Poem

🐰 The keyboard now listens with care,
Escape and Ctrl-C everywhere!
Options displayed in the prompt so clear,
Help text expanded for all to hear—
Terminal selection without any snare! ✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title directly addresses the main changes: enhanced TUI interactivity and improved interrupt handling, which align with the documented modifications to terminal UI selector behavior and cancellation key mapping.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch palette/tui-ux-improvements-591284406558102273

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}