Skip to content

Terminal UX & TUI Architecture Review #3

@NikolayS

Description

@NikolayS

Expert: Terminal/TUI Engineer

Scope

Review SPEC.md's REPL (FR-2), autocomplete (FR-6, FR-19), syntax highlighting (FR-7), TUI pager (FR-8), status bar (FR-25), keybindings (FR-18), and multi-line mode (FR-21).

Deliverables

  • REPL architecture: rustyline customization depth (completer, highlighter, hinter, validator)
  • TUI pager design: ratatui integration, alternate screen management, coexistence with REPL
  • Syntax highlighting: syntect vs tree-sitter for SQL (performance, accuracy, theme support)
  • Autocomplete engine: context detection, schema metadata caching, fuzzy matching algorithm
  • Status bar: persistent rendering without interfering with REPL or pager
  • Input mode coexistence: REPL ↔ pager ↔ AI response transitions
  • Cross-platform terminal compatibility risks (Windows Terminal, ConPTY, SSH sessions)
  • Unicode/wide-character handling in table output and input

Context

Three rendering contexts must coexist: REPL, TUI pager, and status bar. This is the hardest UX integration challenge in the project.

🤖 Generated with Claude Code

Metadata

Metadata

Assignees

No one assigned

    Labels

    architectureArchitecture and design decisionsphase-0Phase 0: psql replacementphase-1Phase 1: beyond psqlspec-reviewSPEC review and analysis

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions