tui2: add onboarding flow and session parity affordances

docs/dev_control_center.md

@@ -66,7 +66,7 @@ Use these docs as inputs, but treat this file as the decision layer:
 
 1. Continue feature-development parity polish in TUI v2 with user-driven UX gaps.
 : prioritized gaps from side-by-side legacy vs v2 run:
-: guided first-run onboarding, stats/ops visibility, explicit lock/session affordances.
+: onboarding + stats/ops + lock/session affordances now landed; continue bug-driven UX polish.
 2. Raise TUI v2 critical-path coverage beyond current gate floor (target >82% for `src/seedpass/tui_v2/app.py`).
 3. Advance Nostr resilience validation with optional real-relay soak lane after deterministic suites.
 4. Execute a tagged release integrity run and attach evidence URLs in readiness checklist.
@@ -128,6 +128,11 @@ Progress update (2026-03-02):
   - added full palette command reference (`help-commands`, alias `commands`)
   - `help` now also renders in-app command reference in entry detail pane
   - focused TUI gate remains green with improved app coverage (`79.97%`)
+- Session affordance parity improved in TUI v2:
+  - added `session-status`, `lock`, and `unlock <password>` palette commands
+  - left pane now displays explicit session lock state and managed-session indicator
+  - lock state blocks open/reveal/QR workflows until unlock succeeds
+  - interaction + matrix tests extended for usage, success, and failure paths
 
 ## 6) Working Rule
 

docs/tui_v2_legacy_parity_matrix.md

@@ -51,19 +51,17 @@ Purpose: map legacy interactive workflows to Textual TUI v2 equivalents and isol
 | Export TOTP codes | Settings | `totp-export` | Implemented | |
 | Backup/reveal parent seed | Settings | `parent-seed-backup [path] [password]` | Implemented | |
 | Stats view | Settings > Stats | `stats` (palette) | Implemented | In-app dashboard in detail pane. |
+| First-run onboarding guidance | Startup path/menu guidance | Empty-vault onboarding panel + `onboarding` (alias: `welcome`) + `quickstart` | Implemented | Guided steps for first entry, inspect/reveal, and operations. |
 | Display npub | Main utility flow | `npub` (alias: `nostr-pubkey`) | Implemented | Displays active profile npub and QR payload in the sensitive panel. |
 | View archived-only list | Settings/List flow | `h` cycle archive scope or `archive-filter <active|all|archived>` | Implemented | Supports active-only/default, all, and archived-only views. |
 | Reset Nostr sync state | Settings > Nostr | `nostr-reset-sync-state` | Implemented | Added to TUI v2 palette + tests. |
 | Start fresh Nostr namespace | Settings > Nostr | `nostr-fresh-namespace` | Implemented | Added to TUI v2 palette + tests. |
 | Load managed-account session | Retrieve managed account action | `managed-load (optional: entry_id)` | Implemented | Added in TUI v2 palette + tests. |
 | Exit managed-account session | Main loop when in child profile | `managed-exit` | Implemented | Added in TUI v2 palette + tests. |
+| Session visibility | Operational/session affordance | `session-status` + left-pane session lines | Implemented | Shows lock state + managed session state. |
+| Lock vault | Operational/session affordance | `lock` | Implemented | Locks session, clears selected view, blocks reveal/open actions. |
+| Unlock vault | Operational/session affordance | `unlock <password>` | Implemented | Restores unlocked state; usage + failure paths covered in tests. |
 
 ## Prioritized Gap Queue
 
-1. Medium: guided first-run onboarding parity in TUI v2 (legacy has explicit startup path).
-2. Medium: explicit lock/session affordances and status visibility parity in TUI v2.
-
-## Suggested implementation order
-
-1. Land guided onboarding panel/flow parity improvements.
-2. Add lock/session visibility commands and test coverage.
+No active medium/high parity gaps are currently identified in this matrix.