Skip to content

docs(specs): add TUI inline mention picker spec, relocate busy status to input separator#6652

Merged
bug-ops merged 1 commit into
mainfrom
ux-search-status-improvements-bdc0d7
Jul 22, 2026
Merged

docs(specs): add TUI inline mention picker spec, relocate busy status to input separator#6652
bug-ops merged 1 commit into
mainfrom
ux-search-status-improvements-bdc0d7

Conversation

@bug-ops

@bug-ops bug-ops commented Jul 22, 2026

Copy link
Copy Markdown
Owner

Summary

Specification-only PR for the TUI UX improvement epic: inline @ mention picker and status-line stabilization. No code changes.

New spec

  • specs/084-tui-mention-picker/spec.md [approved] — inline non-modal @ popup for files/skills/agents replacing the modal file picker:
    • word-start trigger: @ opens the popup only at position 0 or after whitespace; mid-word @ (e-mail addresses, pkg@version) stays a literal character
    • typing is never captured away from the input buffer; the popup reflects the @query span between the sigil and the cursor
    • Space closes the popup keeping the mention text as plain prose; Tab/Enter accept the selection plus a trailing space; Esc closes only the popup and retains Insert mode; Backspace past the @ dismisses
    • category tabs All/Files/Skills/Agents switched with Left/Right while open; nucleo fuzzy matching with match highlighting and an N/M counter
    • per-category accept semantics: file = bare repo-relative path, skill = plain name (no forced activation), agent = @name sigil retained so the existing dispatch_agent_command routing applies
    • race-free file-index build (placeholder row instead of the current input-loss window); skill/agent catalog delivery via a dedicated startup/hot-reload event — no per-tick MetricsSnapshot bloat, no new zeph-skills dependency in zeph-tui

Updated specs

  • specs/011-tui/spec.md — the canonical location of the transient busy spinner+verb moves from the bottom status bar to the input separator row; the bottom bar holds stable session parameters, streaming tok/s+TTFT, and transient critical hints; Spinner Rule itself unchanged
  • specs/030-tui-slash-autocomplete/spec.md — NFR-004 rewritten: non-conflict between the two inline surfaces via distinct trigger rules
  • specs/tui-reducer/spec.mdFilePicker* action set marked superseded by MentionPicker* variants (removed at implementation time; INV-R1/INV-R2 unchanged)
  • specs/UX/mention-routing.md — addendum: the TUI-side blocker for @agent mentions is resolved by spec 084; routing invariants remain binding; A2A-remote mentions stay deferred
  • specs/README.md, specs/MOC-specs.md — spec 084 registered

Coordination

Implementation is tracked separately:

Verification

@bug-ops bug-ops added the docs Documentation label Jul 22, 2026
@github-actions github-actions Bot added documentation Improvements or additions to documentation size/XL Extra large PR (500+ lines) labels Jul 22, 2026
… to input separator

Add specs/084-tui-mention-picker/spec.md (approved): inline non-modal @ popup
for files/skills/agents replacing the modal file picker — word-start trigger,
typing never captured away from the input buffer, Space closes keeping the
mention as prose, Tab/Enter accept with trailing space, Esc closes only the
popup, category tabs All/Files/Skills/Agents switched with Left/Right, nucleo
fuzzy matching, per-category accept semantics, race-free file-index build,
catalog delivery via a dedicated startup/hot-reload event.

Update related specs:
- 011-tui: canonical busy spinner+verb location moves to the input separator
  row; bottom status bar holds stable parameters, streaming metrics, and
  transient critical hints only
- 030-tui-slash-autocomplete: NFR-004 non-conflict now via distinct trigger
  rules between two inline surfaces
- tui-reducer: FilePicker* action set superseded by MentionPicker* variants
- UX/mention-routing: addendum — TUI-side blocker resolved by spec 084
- README, MOC-specs: register spec 084

Refs #6647, #6648, #6649, #6650, #6651
@bug-ops
bug-ops enabled auto-merge (squash) July 22, 2026 16:12
@bug-ops
bug-ops force-pushed the ux-search-status-improvements-bdc0d7 branch from 5452c0b to 1dbbd9e Compare July 22, 2026 16:12
@bug-ops
bug-ops merged commit af0c1af into main Jul 22, 2026
23 checks passed
@bug-ops
bug-ops deleted the ux-search-status-improvements-bdc0d7 branch July 22, 2026 16:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Documentation documentation Improvements or additions to documentation size/XL Extra large PR (500+ lines)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant