Footers: one verb per Enter, settled in the standard

Five words had grown for one key — select, pick, open, choose, commit —
so CLAUDE.md now fixes the Enter verb by action (open pushes a screen,
select picks a value or action row, set commits a value picker) and the
outliers come along: the purge and discipline pickers say select, the
record card's action rows say select, "Esc keep current" and the three
"type filter"s were typos against existing rules (housekeeping H-008).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Jean-Pierre MartineauandClaude Fable 5 committed 2026-07-29 23:13:55 -04:00
1 parent 4aef3e7b82
commit 0add80a821
7 files changed
+12 -7

No files matched your search

+5
View File
@@ -86,6 +86,11 @@ Relative ages: `format_ago` for prose ("now", "5m ago", "never" — never "now a
- Esc verb by surface: `Esc back` leaves a screen · `Esc close` dismisses a read-only
floating view · `Esc cancel` abandons a prompt/dialog · `Esc keep` leaves a value
picker unchanged · `Esc quit` only at the main menu.
- Enter verb by action: `Enter open` when the row pushes a screen or dialog ·
`Enter select` when it picks a value or action row · `Enter set` in a value picker.
A more specific committing verb (`Enter adopt path`, `Enter add`) is fine; a synonym
of the generic three (`pick`, `choose`, `commit`) is not. The filter atom is always
`type to filter`.
- Key notation: `↑↓ move` (include the verb), `^R`/`^End` for Ctrl chords, `⌫` for
backspace, `⇧` for shift.
+1 -1
View File
@@ -180,7 +180,7 @@ class TraceTool(Tool):
sort=ContactsSort.from_name(
"traced", TRACE_SORT_COLUMNS, TRACE_SORT_OPENS_ASCENDING
),
footer_hint="↑↓ move · ^←→↑↓ sort · type filter · Enter select · Esc back",
footer_hint="↑↓ move · ^←→↑↓ sort · type to filter · Enter select · Esc back",
show_traced=True,
)
chosen = await ctx.ui.session.run_screen(picker)
+1 -1
View File
@@ -95,7 +95,7 @@ TRACE_SORT_OPENS_ASCENDING: dict[str, bool] = {
_SORT_ACTIVE = "bold #22d3ee"
#: The default footer: navigation, the Ctrl+arrow sort, filtering, then Esc last.
_HINT = "↑↓ move · ^←→↑↓ sort · type filter · Enter open · Esc back"
_HINT = "↑↓ move · ^←→↑↓ sort · type to filter · Enter open · Esc back"
@dataclass
+1 -1
View File
@@ -261,7 +261,7 @@ async def _purge_stale(ctx: "AppContext", self_key: str) -> int:
f"Purge stale contacts — {len(contacts)} known",
items,
prompt="Remove contacts you haven't heard from in the chosen span.",
footer_hint="↑↓ move · Enter pick · Esc back",
footer_hint="↑↓ move · Enter select · Esc back",
filterable=False,
wrap=False,
)
+1 -1
View File
@@ -292,7 +292,7 @@ def _done_row(message: QueuedMessage) -> Text:
#: The recipient picker's footer: the shared contact-list grammar with a committing Enter,
#: Esc cancelling the queueing step it sits in.
_PICK_HINT = "↑↓ move · ^←→↑↓ sort · type filter · Enter select · Esc cancel"
_PICK_HINT = "↑↓ move · ^←→↑↓ sort · type to filter · Enter select · Esc cancel"
class CourierRecipientScreen(ContactListScreen):
+2 -2
View File
@@ -191,7 +191,7 @@ class RecordDialog(Screen):
"""
super().__init__()
self.title = f"Record — {category.title} #{rank}"
self.footer_hint = "↑↓ move · PgUp/PgDn scroll · Enter commit · Esc back"
self.footer_hint = "↑↓ move · PgUp/PgDn scroll · Enter select · Esc back"
self._record = record
self._category = category
self._resolve = resolve
@@ -714,7 +714,7 @@ async def open_records(ctx: "AppContext") -> dict:
SelectScreen(
"Delete a discipline's records",
rows,
footer_hint="↑↓ move · Enter pick · Esc back",
footer_hint="↑↓ move · Enter select · Esc back",
filterable=False,
wrap=False,
)
+1 -1
View File
@@ -1927,7 +1927,7 @@ async def _open_session(
SelectScreen(
f"Probe results — {target_label}",
result_items,
footer_hint="↑↓ move · Enter adopt path · Esc keep current",
footer_hint="↑↓ move · Enter adopt path · Esc keep",
wrap=False,
hscroll=True, # ranked rows carry whole specs — let ←→ read the tail
)