From 0add80a821d4efd274798bdac72cad5eff9f895d Mon Sep 17 00:00:00 2001 From: Jean-Pierre Martineau Date: Wed, 29 Jul 2026 23:13:55 -0400 Subject: [PATCH] Footers: one verb per Enter, settled in the standard MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- CLAUDE.md | 5 +++++ meshterm/tools/trace.py | 2 +- meshterm/ui/contactlist.py | 2 +- meshterm/ui/contacts_screen.py | 2 +- meshterm/ui/courier_screen.py | 2 +- meshterm/ui/records_screen.py | 4 ++-- meshterm/ui/trace_screen.py | 2 +- 7 files changed, 12 insertions(+), 7 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 1eca907..bf225a0 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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. diff --git a/meshterm/tools/trace.py b/meshterm/tools/trace.py index edf0c1c..5b940c6 100644 --- a/meshterm/tools/trace.py +++ b/meshterm/tools/trace.py @@ -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) diff --git a/meshterm/ui/contactlist.py b/meshterm/ui/contactlist.py index 9fbdfe8..c444512 100644 --- a/meshterm/ui/contactlist.py +++ b/meshterm/ui/contactlist.py @@ -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 diff --git a/meshterm/ui/contacts_screen.py b/meshterm/ui/contacts_screen.py index 2882435..034bdfa 100644 --- a/meshterm/ui/contacts_screen.py +++ b/meshterm/ui/contacts_screen.py @@ -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, ) diff --git a/meshterm/ui/courier_screen.py b/meshterm/ui/courier_screen.py index 7fed64e..33e5f1f 100644 --- a/meshterm/ui/courier_screen.py +++ b/meshterm/ui/courier_screen.py @@ -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): diff --git a/meshterm/ui/records_screen.py b/meshterm/ui/records_screen.py index ef556d7..29f17ff 100644 --- a/meshterm/ui/records_screen.py +++ b/meshterm/ui/records_screen.py @@ -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, ) diff --git a/meshterm/ui/trace_screen.py b/meshterm/ui/trace_screen.py index 065a97a..5a93d72 100644 --- a/meshterm/ui/trace_screen.py +++ b/meshterm/ui/trace_screen.py @@ -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 )