feat: add semantic search modes across cli api and tuis

docs/dev_control_center.md

@@ -74,7 +74,8 @@ Use these docs as inputs, but treat this file as the decision layer:
 - Current implementation status:
   - Phase A complete (local derived index + profile-scoped manifest/records + config flag)
   - Phase B baseline complete (CLI + API surfaces + initial tests)
-  - Phase C pending (legacy TUI + TUI v2 semantic workflow integration)
+  - Phase C complete baseline (legacy + TUI v2 semantic workflows and mode toggles)
+  - Next: incremental mutation hooks + hybrid quality hardening
 
 ## 4) Recommended Next Steps (Priority Order)
 
@@ -83,9 +84,9 @@ Use these docs as inputs, but treat this file as the decision layer:
 : onboarding + stats/ops + lock/session affordances now landed; focus now is mockup-aligned UI refresh completion.
 2. Complete Phase 5 TUI v2 UI refresh queue:
 : final visual polish pass (profile tree navigation/select is now landed).
-3. Begin semantic index Phase C (legacy TUI + TUI v2 integration with status/build/search controls).
-4. Add semantic incremental update hooks on entry/link/tag mutations.
-5. Raise TUI v2 critical-path coverage beyond current gate floor (target >82% for `src/seedpass/tui_v2/app.py`).
+3. Add semantic incremental update hooks on entry/link/tag mutations.
+4. Raise TUI v2 critical-path coverage beyond current gate floor (target >82% for `src/seedpass/tui_v2/app.py`).
+5. Expand semantic hybrid quality validation and KB stress evidence capture.
 6. Advance Nostr resilience validation with optional real-relay soak lane after deterministic suites.
 
 ## 5) Next Slice Definition (Recommended Immediate Work)
@@ -163,7 +164,7 @@ Progress update (2026-03-02):
 
 Current UI refresh remaining queue:
 1. Final visual polish pass against mockups (spacing, headers, action strip clarity).
-2. Semantic indicator slot in top ribbon/action strip (for upcoming Phase C semantic integration).
+2. Tune semantic indicator wording/placement in top ribbon/action strip for readability under narrow terminals.
 
 ## 6) Working Rule
 

docs/semantic_vector_index_plan.md

@@ -118,10 +118,11 @@ Add settings + search affordances:
 Palette commands:
 
 1. `semantic-status`
-2. `semantic-build`
-3. `semantic-rebuild`
-4. `semantic-search <query>`
-5. `search-mode <keyword|hybrid|semantic>`
+2. `semantic-enable` / `semantic-disable`
+3. `semantic-build`
+4. `semantic-rebuild`
+5. `semantic-search <query>`
+6. `search-mode <keyword|hybrid|semantic>`
 
 UI surfaces:
 
@@ -150,6 +151,7 @@ Proposed endpoints:
 2. `POST /api/v1/semantic/build`
 3. `POST /api/v1/semantic/rebuild`
 4. `POST /api/v1/semantic/search`
+5. `POST /api/v1/semantic/config`
 
 Request examples:
 
@@ -247,9 +249,9 @@ Exit:
 
 ## Phase C: TUI integration
 
-1. [ ] wire legacy TUI settings/search hooks
-2. [ ] wire TUI v2 palette commands + ribbon/status indicators
-3. [ ] add hybrid search mode toggles
+1. [x] wire legacy TUI settings/search hooks
+2. [x] wire TUI v2 palette commands + ribbon/status indicators
+3. [x] add hybrid search mode toggles
 
 Exit:
 
@@ -276,7 +278,7 @@ Exit:
 
 1. Complete Phase C integration in both TUIs (`semantic-status/build/rebuild/search` + status indicator).
 2. Add incremental update hooks on entry/link/tag mutations (avoid full rebuild for small edits).
-3. Add hybrid ranking mode (`keyword|hybrid|semantic`) with explicit config + API contract.
+3. Expand hybrid ranking quality and retrieval relevance validation on KB stress datasets.
 4. Add audit logging and lock-policy tests for semantic operations in agent/API contexts.
 5. Run KB scale benchmark with semantic index enabled and record latency/memory evidence.
 
@@ -289,6 +291,7 @@ Implemented:
 3. `SemanticIndexService` in core API layer.
 4. CLI commands:
 - `seedpass semantic status|enable|disable|build|rebuild|search`
+ - `seedpass semantic config --enabled <true|false> --mode <keyword|hybrid|semantic>`
 5. API endpoints:
 - `GET /api/v1/semantic/status`
 - `POST /api/v1/semantic/build`
@@ -296,10 +299,15 @@ Implemented:
 - `POST /api/v1/semantic/search`
 - `POST /api/v1/semantic/config`
 6. Initial tests for core service/index, CLI commands, and API endpoints.
+7. Semantic search mode support:
+- profile config key `semantic_search_mode` (`keyword|hybrid|semantic`)
+- API `semantic/search` mode override
+- API `semantic/config` mode updates
+- TUI v2 `search-mode` command + ribbon mode indicator
+- legacy TUI semantic submenu mode setter
 
 Not yet implemented:
 
-1. Legacy TUI semantic controls.
-2. TUI v2 semantic palette integration/ribbon indicator.
-3. True embedding backend and vector DB adapter (current implementation is token-overlap baseline).
-4. Incremental mutation hooks and hybrid ranking mode.
+1. True embedding backend and vector DB adapter (current implementation is token-overlap baseline).
+2. Incremental mutation hooks (entry/tag/link CRUD triggers).
+3. Audit/logging policy hardening and lock-state behavior validation.

docs/tui_v2_ui_refresh_plan.md

@@ -530,7 +530,7 @@ Validation:
 
 Next recommended slice:
 
-1. Final visual alignment pass to mockups (spacing, headers, action strip hierarchy) and semantic indicator slot prep.
+1. Final visual alignment pass to mockups (spacing, headers, action strip hierarchy) and semantic indicator readability polish.
 
 ## 14) Current Status Snapshot
 
@@ -546,5 +546,5 @@ Completed:
 Remaining (active queue):
 
 1. Final alignment pass to mockup spacing/rhythm and action-strip clarity.
-2. Add semantic-state indicator slot in ribbon/action strip for upcoming semantic Phase C.
+2. Semantic-state indicator readability pass in ribbon/action strip for upcoming dense-status scenarios.
 3. Run focused TUI tests and coverage gate after each polish slice.