RFC-0003: TUI UX improvements

Version: 0.1.0 | Status: normative | Phase: stable

1. Summary

[RFC-0003:C-SUM] Summary (Informative)

Define a consistent TUI navigation frame with shared header and footer.
Add list filtering and quick-jump for faster browsing.
Improve detail view readability with consistent layout and scroll position.

Since: v0.1.0

2. Specification

The TUI MUST render a persistent header and footer across all views.
The header MUST show the current view hierarchy (breadcrumb) and basic counts for the active view.
The footer MUST provide the current keymap for primary navigation, including quit and back.
Existing navigation keys MUST remain functional.

Since: v0.1.0

List views MUST support an inline filter mode that matches ID, title, or status.
Filter mode MUST be entered with a single key and exited without leaving the list view.
When a filter is active, the list MUST show only matching items and navigation MUST operate over the filtered set.
List views MUST support quick-jump to top and bottom and allow stepping through matches.

Since: v0.1.0

[RFC-0003:C-DETAIL] Detail view readability (Normative)

Detail views MUST present metadata and content sections consistently across artifact types.
Detail views MUST show scroll position to indicate where the user is within the content.
Scrolling MUST not lose the current view context or selection.

Since: v0.1.0

Changelog

v0.1.0 (2026-02-07)

Initial draft