Add TUI v2 parity checklist and large-vault pagination

This commit is contained in:
thePR0M3TH3AN committed 2026-03-01 16:17:42 -05:00
1 parent 6478987254
commit ec0d77d3e6
6 files changed
+198 -38

No files matched your search

+1
View File
@@ -24,6 +24,7 @@ This directory contains SeedPass project documentation.
- `entry_types.md`
- `entry_graph.md`
- `tui_v2_plan.md`
- `tui_v2_parity_checklist.md`
- `security.md`
- `nostr_setup.md`
- `nostr_namespace_reset.md`
+47
View File
@@ -0,0 +1,47 @@
# 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
- [x] Feature parity checklist document.
- [x] 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.
- [ ] 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.
- No dedicated Textual interaction test suite yet for pagination and graph traversal.
## Validation Checklist Before Cutover
- [ ] Define and run deterministic parity scenarios across entry kinds.
- [ ] Add Textual interaction tests for list/search/edit/link/pagination flows.
- [ ] Verify large vault behavior with realistic data volume in CI-like environment.
- [ ] Confirm help text and docs match shipped keybindings and palette commands.
+2 -2
View File
@@ -60,8 +60,8 @@ Goal: Introduce a modern, modular TUI (`seedpass tui2`) without rewriting core l
- [x] Neighbor navigation and quick traversal.
### Phase 4: Cutover readiness
- [ ] Feature parity checklist against legacy TUI.
- [ ] UX/perf pass for large vaults.
- [x] Feature parity checklist against legacy TUI.
- [x] UX/perf pass for large vaults.
- [ ] Error messaging and recovery flows.
- [ ] Decide default switch timing (`seedpass` -> `tui2`).