SeedPass/docs/tui_v2_parity_checklist.md

TUI v2 Parity Checklist

Status: In progress on beta (updated 2026-03-01).

This checklist tracks readiness to switch default interactive mode from legacy TUI to seedpass tui2.

Scope

• Legacy baseline: current default seedpass interactive path.
• Candidate: seedpass tui2 (Textual).
• Non-goal for cutover: replacing CLI/API behavior.

Current Parity

Area	Legacy TUI	TUI v2	Notes
Entry list/search	Yes	Yes	Includes kind filter and search.
Entry detail view	Yes	Yes	Large document content preview is truncated for performance.
Archive/restore	Yes	Yes	Keyboard and command palette paths.
Document editing	Partial	Yes	Save/cancel flow in editor panel.
Graph links list	Limited	Yes	Dedicated links panel.
Link add/remove	Limited	Yes	Via command palette commands.
Neighbor traversal	No	Yes	Link cursor + open target entry.
Command discoverability	Menu-driven	Partial	Keybind hints and palette help.
Full legacy workflow coverage	Yes	Pending	Additional edge-case parity still needed.

Phase 4 Deliverables

• Feature parity checklist document.
• First UX/perf pass for large vaults.
  • paginated entry list rendering (p/n, page-* palette commands)
  • document content preview truncation in detail panel
• Error messaging and recovery flow review.
  • unified failure status messaging
  • retry shortcut (x) and palette retry command
• Cutover decision memo (seedpass default switch timing).

Risks Remaining

• Incomplete parity for legacy-only interactive operations not yet mapped into TUI v2.
• Textual runtime/version behavior can vary by environment.
• Large-vault validation is bounded to deterministic pagination/preview checks and should be expanded with full end-to-end sync workloads.

Validation Checklist Before Cutover

• Define and run deterministic parity scenarios across entry kinds.
  • src/tests/test_tui_v2_parity_scenarios.py
• Add Textual interaction tests for list/search/edit/link/pagination flows.
  • src/tests/test_tui_v2_textual_interactions.py (skips when textual is unavailable).
• Add non-UI unit tests for TUI v2 helper logic.
  • src/tests/test_tui_v2_helpers.py covers command parsing, pagination, and detail truncation.
• Verify large vault behavior with realistic data volume in CI-like environment.
  • src/tests/test_tui_v2_large_vault_validation.py
  • standard: 10,000 rows, stress: 50,000 rows (--stress)
• Confirm help text and docs match shipped keybindings and palette commands.
  • Updated seedpass tui2 --help, capabilities hints, and docs discoverability commands.