docs: bridge README to the TypeScript rebuild; banner the Python-era docs

The README had zero mentions of the TypeScript implementation -- on the
branch proposing to make it the main line, a reader (including PR #989's
reviewers) would find only the Python product. A bridge section near the top
now says what the rebuild is, its status (under independent review; do not
put irreplaceable secrets in it yet), and where the migration guide, the
vault/identity spec, and the cutover plan live. Deliberately a bridge, not a
rewrite: everything below it still accurately describes the Python version,
which is what install.sh installs today. Advertising the TS implementation
as the product before its review lands would be docs describing an
aspirational state -- the exact failure mode this branch has been stamping
out.

The 14 Python-era planning docs most likely to mislead (tui_v2/v3,
index0/atlas, semantic) carry a one-line legacy banner so a reader can tell
a historical record from a living document.

The full TS-first rewrite -- README, landing page, docs triage, CI scoping,
dependabot config -- is specced as a merge-day checklist under the cutover
item in TODO.md, so main never advertises a stale product in either
direction.

Co-Authored-By: Claude Opus 5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01Tkj4rzKBA3uhfgk7kqjsb8

docs/atlas_search_graph_integration_plan_2026-03-05.md

@@ -1,5 +1,7 @@
 # Atlas, Search, and Graph Integration Plan (2026-03-05)
 
+> **Legacy (Python implementation).** This document describes the Python version, which retires to `legacy/` after the TypeScript cutover ([PR #989](https://github.com/PR0M3TH3AN/SeedPass/pull/989)). The TypeScript interactive mode follows the classic v1 menus; TUI v2/v3, index0/atlas, and semantic search were not ported. Kept as historical record.
+
 Status: In Progress  
 Branch target: `beta`  
 Depends on:

docs/index0_atlas_execution_plan_2026-03-05.md

@@ -1,5 +1,7 @@
 # Index0 Atlas Execution Plan (2026-03-05)
 
+> **Legacy (Python implementation).** This document describes the Python version, which retires to `legacy/` after the TypeScript cutover ([PR #989](https://github.com/PR0M3TH3AN/SeedPass/pull/989)). The TypeScript interactive mode follows the classic v1 menus; TUI v2/v3, index0/atlas, and semantic search were not ported. Kept as historical record.
+
 Status: In Progress  
 Branch target: `beta`  
 Scope: Core index payload, Nostr sync, hierarchy navigation, future KB and agent workflows

docs/index0_phase0_spec_2026-03-05.md

@@ -1,5 +1,7 @@
 # Index0 Phase 0 Implementation Spec (2026-03-05)
 
+> **Legacy (Python implementation).** This document describes the Python version, which retires to `legacy/` after the TypeScript cutover ([PR #989](https://github.com/PR0M3TH3AN/SeedPass/pull/989)). The TypeScript interactive mode follows the classic v1 menus; TUI v2/v3, index0/atlas, and semantic search were not ported. Kept as historical record.
+
 Status: In Progress  
 Branch target: `beta`  
 Depends on: `docs/index0_atlas_execution_plan_2026-03-05.md`

docs/semantic_vector_index_plan.md

@@ -1,5 +1,7 @@
 # Semantic Vector Index Integration Plan
 
+> **Legacy (Python implementation).** This document describes the Python version, which retires to `legacy/` after the TypeScript cutover ([PR #989](https://github.com/PR0M3TH3AN/SeedPass/pull/989)). The TypeScript interactive mode follows the classic v1 menus; TUI v2/v3, index0/atlas, and semantic search were not ported. Kept as historical record.
+
 Status: In Progress (updated 2026-03-02)  
 Branch target: `beta`  
 Scope: Legacy TUI + Textual TUI v2 + CLI + API

docs/tui_v2_cutover_decision.md

@@ -1,5 +1,7 @@
 # TUI v2 Cutover Decision Memo
 
+> **Legacy (Python implementation).** This document describes the Python version, which retires to `legacy/` after the TypeScript cutover ([PR #989](https://github.com/PR0M3TH3AN/SeedPass/pull/989)). The TypeScript interactive mode follows the classic v1 menus; TUI v2/v3, index0/atlas, and semantic search were not ported. Kept as historical record.
+
 Date: March 2, 2026  
 Branch: `beta`  
 Decision owner: SeedPass maintainers

docs/tui_v2_integration_execution_plan_2026-03-02.md

@@ -1,5 +1,7 @@
 # TUI v2 Integration Execution Plan (2026-03-02)
 
+> **Legacy (Python implementation).** This document describes the Python version, which retires to `legacy/` after the TypeScript cutover ([PR #989](https://github.com/PR0M3TH3AN/SeedPass/pull/989)). The TypeScript interactive mode follows the classic v1 menus; TUI v2/v3, index0/atlas, and semantic search were not ported. Kept as historical record.
+
 Status: Proposed and ready to execute  
 Branch target: `beta`  
 Owner: TUI v2 parity track

docs/tui_v2_large_vault_validation.md

@@ -1,5 +1,7 @@
 # TUI v2 Large-Vault Validation
 
+> **Legacy (Python implementation).** This document describes the Python version, which retires to `legacy/` after the TypeScript cutover ([PR #989](https://github.com/PR0M3TH3AN/SeedPass/pull/989)). The TypeScript interactive mode follows the classic v1 menus; TUI v2/v3, index0/atlas, and semantic search were not ported. Kept as historical record.
+
 Status: Added on `beta` (March 1, 2026).
 
 This document defines a deterministic, CI-like validation pass for TUI v2 behavior at large vault sizes.

docs/tui_v2_legacy_parity_matrix.md

@@ -1,5 +1,7 @@
 # TUI v2 Legacy Parity Matrix
 
+> **Legacy (Python implementation).** This document describes the Python version, which retires to `legacy/` after the TypeScript cutover ([PR #989](https://github.com/PR0M3TH3AN/SeedPass/pull/989)). The TypeScript interactive mode follows the classic v1 menus; TUI v2/v3, index0/atlas, and semantic search were not ported. Kept as historical record.
+
 Status: In progress (2026-03-02)  
 Branch: `beta`
 

docs/tui_v2_mockup_gap_audit_2026-03-02.md

@@ -1,5 +1,7 @@
 # TUI v2 Mockup Gap Audit (2026-03-02)
 
+> **Legacy (Python implementation).** This document describes the Python version, which retires to `legacy/` after the TypeScript cutover ([PR #989](https://github.com/PR0M3TH3AN/SeedPass/pull/989)). The TypeScript interactive mode follows the classic v1 menus; TUI v2/v3, index0/atlas, and semantic search were not ported. Kept as historical record.
+
 Status: Active  
 Scope: visual and interaction parity between `UI_mockups/PNG/*.png` and current Textual TUI v2 runtime
 

docs/tui_v2_parity_backlog.md

@@ -1,5 +1,7 @@
 # TUI v2 Parity Backlog
 
+> **Legacy (Python implementation).** This document describes the Python version, which retires to `legacy/` after the TypeScript cutover ([PR #989](https://github.com/PR0M3TH3AN/SeedPass/pull/989)). The TypeScript interactive mode follows the classic v1 menus; TUI v2/v3, index0/atlas, and semantic search were not ported. Kept as historical record.
+
 Status: Active tracking on `beta` (updated 2026-03-01).
 
 This document captures parity learnings and the remaining implementation queue

docs/tui_v2_parity_checklist.md

@@ -1,5 +1,7 @@
 # TUI v2 Parity Checklist
 
+> **Legacy (Python implementation).** This document describes the Python version, which retires to `legacy/` after the TypeScript cutover ([PR #989](https://github.com/PR0M3TH3AN/SeedPass/pull/989)). The TypeScript interactive mode follows the classic v1 menus; TUI v2/v3, index0/atlas, and semantic search were not ported. Kept as historical record.
+
 Status: Parity-complete on `beta` (updated 2026-03-02).
 
 This checklist tracks readiness to switch default interactive mode from legacy TUI to `seedpass tui2`.

docs/tui_v2_plan.md

@@ -1,5 +1,7 @@
 # TUI v2 Plan (Legacy Reference)
 
+> **Legacy (Python implementation).** This document describes the Python version, which retires to `legacy/` after the TypeScript cutover ([PR #989](https://github.com/PR0M3TH3AN/SeedPass/pull/989)). The TypeScript interactive mode follows the classic v1 menus; TUI v2/v3, index0/atlas, and semantic search were not ported. Kept as historical record.
+
 > **NOTICE:** This document is now for logic reference only. 
 > TUI v2 development has been paused in favor of the **TUI v3 Scratch Rebuild** to solve monolithic file issues and layout crowding.
 > Please see **[TUI v3 Plan](tui_v3_plan.md)** for the current roadmap.

docs/tui_v2_ui_refresh_plan.md

@@ -1,5 +1,7 @@
 # TUI v2 UI Refresh Plan (Mockup-Aligned)
 
+> **Legacy (Python implementation).** This document describes the Python version, which retires to `legacy/` after the TypeScript cutover ([PR #989](https://github.com/PR0M3TH3AN/SeedPass/pull/989)). The TypeScript interactive mode follows the classic v1 menus; TUI v2/v3, index0/atlas, and semantic search were not ported. Kept as historical record.
+
 Status: Active (2026-03-02)  
 Branch target: `beta`  
 Primary references: `UI_mockups/PNG/*.png`, `UI_mockups/SeedPass_UI-Board.pdf`

docs/tui_v3_plan.md

@@ -1,5 +1,7 @@
 # TUI v3 Modular Architecture & Parity Plan
 
+> **Legacy (Python implementation).** This document describes the Python version, which retires to `legacy/` after the TypeScript cutover ([PR #989](https://github.com/PR0M3TH3AN/SeedPass/pull/989)). The TypeScript interactive mode follows the classic v1 menus; TUI v2/v3, index0/atlas, and semantic search were not ported. Kept as historical record.
+
 Last updated: 2026-03-06  
 Branch target: `beta`  
 Status: Active (Default UI / parity hardening in progress)