From 8ee40b56e93f5625bf969a88d285daec71d23fd9 Mon Sep 17 00:00:00 2001 From: master <> Date: Sun, 8 Mar 2026 00:16:35 +0200 Subject: [PATCH] Archive completed search foundation sprints --- ...6_001_Web_contextual_search_suggestions.md | 36 ++++++++++--------- ...60306_002_FE_search_advisory_quality_ux.md | 1 + docs/modules/ui/TASKS.md | 16 ++++----- 3 files changed, 28 insertions(+), 25 deletions(-) rename {docs => docs-archived}/implplan/SPRINT_20260306_001_Web_contextual_search_suggestions.md (84%) rename {docs => docs-archived}/implplan/SPRINT_20260306_002_FE_search_advisory_quality_ux.md (97%) diff --git a/docs/implplan/SPRINT_20260306_001_Web_contextual_search_suggestions.md b/docs-archived/implplan/SPRINT_20260306_001_Web_contextual_search_suggestions.md similarity index 84% rename from docs/implplan/SPRINT_20260306_001_Web_contextual_search_suggestions.md rename to docs-archived/implplan/SPRINT_20260306_001_Web_contextual_search_suggestions.md index ad588b096..04ca8b588 100644 --- a/docs/implplan/SPRINT_20260306_001_Web_contextual_search_suggestions.md +++ b/docs-archived/implplan/SPRINT_20260306_001_Web_contextual_search_suggestions.md @@ -77,7 +77,7 @@ Completion criteria: - [x] FE tests assert payload shape sent to `/api/v1/search/query`. ### WEB-CTX-004 - AdvisoryAI ambient contract and processor extension -Status: TODO +Status: DONE Dependency: WEB-CTX-003 Owners: Developer (AdvisoryAI) Task description: @@ -87,12 +87,12 @@ Task description: - Align route-domain mapping prefixes with current FE routing patterns. Completion criteria: -- [ ] Backend accepts and normalizes last-action ambient metadata. -- [ ] Route mapping parity tests cover FE route prefixes currently in use. -- [ ] Unit/integration tests verify context-aware boosts/refinements are deterministic. +- [x] Backend accepts and normalizes last-action ambient metadata. +- [x] Route mapping parity tests cover FE route prefixes currently in use. +- [x] Unit/integration tests verify context-aware boosts/refinements are deterministic. ### WEB-CTX-005 - Context-aware suggestion UX updates -Status: DOING +Status: DONE Dependency: WEB-CTX-004 Owners: Developer (FE), UX Task description: @@ -101,28 +101,30 @@ Task description: - last-action-aware suggestions - backend refinements/suggestions when present - Ensure chat onboarding suggestions remain consistent with shared context rules. +- Later zero-learning correction phases intentionally removed explicit no-result recovery panels from the default flow; the final shipped behavior keeps executable page-aware starters and answer-first follow-up questions instead of a separate refinement surface. Completion criteria: -- [ ] Empty-state suggestion chips adapt to route + last action. -- [ ] No-results and sparse-results views surface contextual refinements clearly. -- [ ] Accessibility and keyboard navigation behavior remains intact. +- [x] Empty-state suggestion chips adapt to route + last action. +- [x] No-results and sparse-results views surface contextual follow-up behavior through executable starter chips, answer-first fallbacks, or later correction-phase equivalents. +- [x] Accessibility and keyboard navigation behavior remains intact. ### WEB-CTX-006 - Quality telemetry and guardrails -Status: TODO +Status: DONE Dependency: WEB-CTX-004 Owners: Developer (FE), Developer (AdvisoryAI) Task description: - Add bounded telemetry markers to evaluate contextual suggestion usefulness without storing sensitive raw prompts beyond existing policy. - Ensure no unbounded growth in in-memory/session context stores. - Keep deterministic ordering and offline behavior guarantees. +- Later correction phases made telemetry explicitly optional. Completion for this sprint now means telemetry remains bounded and non-blocking rather than a functional prerequisite for contextual search correctness. Completion criteria: -- [ ] Telemetry and logs distinguish contextual vs non-contextual suggestion paths. -- [ ] Privacy posture for stored query/action metadata is documented and validated. -- [ ] No new external dependencies introduced. +- [x] Telemetry remains bounded and optional without blocking contextual search behavior. +- [x] Privacy posture for stored query/action metadata is documented and validated. +- [x] No new external dependencies introduced. ### WEB-CTX-007 - Docs sync and rollout plan -Status: DOING +Status: DONE Dependency: WEB-CTX-005 Owners: Documentation author, Project Manager Task description: @@ -133,9 +135,9 @@ Task description: - Record rollout strategy (feature flag/canary, fallback behavior, success metrics) and decision log. Completion criteria: -- [ ] Docs reflect final API payload and UI behavior. -- [ ] Sprint Decisions & Risks includes rollout gates and fallback plan. -- [ ] Execution log captures implementation and verification evidence links. +- [x] Docs reflect final API payload and UI behavior. +- [x] Sprint Decisions & Risks includes rollout gates and fallback plan. +- [x] Execution log captures implementation and verification evidence links. ## Execution Log | Date (UTC) | Update | Owner | @@ -153,6 +155,7 @@ Completion criteria: | 2026-03-06 | Migrated default hostname from 127.1.0.1 to stella-ops.local across envsettings-override, proxy.conf, playwright config, perf fixtures, README, and smoke scripts. | Developer (FE) | | 2026-03-06 | QA iteration: 23/23 sprint unit tests pass (ambient-context 6, global-search 11, chat-message 6). Live behavioral verification via Playwright confirms contextual placeholders and suggestion chips adapt per page (dashboard/triage/policy/scanning). OIDC login flow works end-to-end at stella-ops.local. | QA | | 2026-03-07 | Added ingestion-backed contextual suggestion verification for the Doctor route: local rebuild order (`/v1/advisory-ai/index/rebuild` then `/v1/search/index/rebuild`) was exercised and `unified-search-contextual-suggestions.live.e2e.spec.ts` proved page-open chips and chip-triggered search over real ingested search data. | Test Automation | +| 2026-03-07 | Closed the remaining backend/docs tasks after verifying `AmbientContextProcessor` route parity tests, optional `SearchTelemetryEnabled` behavior, later zero-learning search corrections, and the live Doctor suggestion lane. Sprint normalized to the shipped search-first model and marked complete for archive. | Project Manager | ## Decisions & Risks - Decision needed: whether route context should remain a hard domain filter in FE (`buildContextFilter`) or become a soft ranking hint only via ambient payload. @@ -161,6 +164,7 @@ Completion criteria: - Decision: chip definitions are now governed by typed context arrays (`SEARCH_CONTEXT_DEFINITIONS`) and an explicit page-level interface contract (`SearchContextComponent`) instead of ad-hoc route conditionals. - Decision: exhaustive >1000 query E2E coverage now runs as 6 strict batches of 200 queries each, resetting page state between batches and enforcing 100% per-batch success. - Decision: contextual suggestion verification now includes one live-ingested route (Doctor/knowledge) in addition to mock-backed regression suites. +- Decision: later search-first correction phases superseded the original explicit no-result refinement and telemetry ambitions; the archived completion state reflects the shipped answer-first, optional-telemetry model instead. - Docs updated: `docs/modules/ui/architecture.md`, `docs/modules/ui/search-chip-context-contract.md`, `docs/modules/advisory-ai/knowledge-search.md`, `docs/modules/advisory-ai/unified-search-architecture.md`. - Risk: stale action context may bias suggestions toward irrelevant domains. - Mitigation: TTL + bounded history + explicit reset on session boundaries. diff --git a/docs/implplan/SPRINT_20260306_002_FE_search_advisory_quality_ux.md b/docs-archived/implplan/SPRINT_20260306_002_FE_search_advisory_quality_ux.md similarity index 97% rename from docs/implplan/SPRINT_20260306_002_FE_search_advisory_quality_ux.md rename to docs-archived/implplan/SPRINT_20260306_002_FE_search_advisory_quality_ux.md index 395b27d63..c28ddb907 100644 --- a/docs/implplan/SPRINT_20260306_002_FE_search_advisory_quality_ux.md +++ b/docs-archived/implplan/SPRINT_20260306_002_FE_search_advisory_quality_ux.md @@ -129,6 +129,7 @@ Completion criteria: - Mitigation: derive labels from the same shared registry used for suggestion selection and context-rail presentation. - Risk: explicit mode state can drift between search and chat if separate stores are introduced. - Mitigation: keep a single root `SearchExperienceModeService` and verify handoff behavior in unit and Playwright coverage. +- Later correction note: this sprint remains archived as a completed intermediate UX slice. Subsequent search-first correction phases removed explicit mode and rescue controls from the primary operator flow. ## Next Checkpoints - 2026-03-07: FE-UX-001 through FE-UX-005 shipped and verified. diff --git a/docs/modules/ui/TASKS.md b/docs/modules/ui/TASKS.md index 81559142e..1336413da 100644 --- a/docs/modules/ui/TASKS.md +++ b/docs/modules/ui/TASKS.md @@ -2,8 +2,6 @@ ## Active Sprint Links - `docs/implplan/SPRINT_20260221_041_FE_prealpha_ia_ops_setup_rewire.md` -- `docs/implplan/SPRINT_20260306_001_Web_contextual_search_suggestions.md` -- `docs/implplan/SPRINT_20260306_002_FE_search_advisory_quality_ux.md` - `docs/implplan/SPRINT_20260307_004_FE_self_serve_search_answer_first.md` - `docs/implplan/SPRINT_20260307_006_FE_self_serve_rollout_and_gap_closure.md` - `docs/implplan/SPRINT_20260307_009_DOCS_ui_component_preservation_map.md` @@ -26,8 +24,8 @@ - [DONE] 041-T12 Targeted tests and verification evidence - [DONE] WEB-CTX-002 FE ambient context capture (page + last action) - [DONE] WEB-CTX-003 FE -> AdvisoryAI ambient payload activation -- [DOING] WEB-CTX-005 Context-aware suggestion UX updates -- [DOING] WEB-CTX-007 Docs sync and rollout plan +- [DONE] WEB-CTX-005 Context-aware suggestion UX updates +- [DONE] WEB-CTX-007 Docs sync and rollout plan - [DONE] WEB-CTX-005A Playwright exhaustive query matrix (>1000 query types) - [DONE] FE-UX-001 Search context rail and explainable chips - [DONE] FE-UX-002 Search/AdvisoryAI shared mode switch (`Find` / `Explain` / `Act`) @@ -67,11 +65,11 @@ - [DONE] DOCS-RTS-005 Triage explainability restoration placement note - [DONE] DOCS-RTS-006 Workflow visualization and replay placement note - [DONE] DOCS-RTS-007 Deeper corroboration and implementation-sprint cutover for restoration topics -- [TODO] FE-PD-001 Freeze Policy Decisioning Studio shell shape and ownership -- [TODO] FE-PD-002 Canonical route and alias contract for policy / VEX / release decisioning -- [TODO] FE-PD-003 Component merge matrix for Policy Studio, Governance, Simulation, and VEX -- [TODO] FE-PD-004 Release-context UX contract for Release Orchestrator deep links -- [TODO] FE-PD-005 FE implementation slices for Decisioning Studio shell and cutover +- [DOING] FE-PD-001 Freeze Policy Decisioning Studio shell shape and ownership +- [DOING] FE-PD-002 Canonical route and alias contract for policy / VEX / release decisioning +- [DOING] FE-PD-003 Component merge matrix for Policy Studio, Governance, Simulation, and VEX +- [DOING] FE-PD-004 Release-context UX contract for Release Orchestrator deep links +- [DOING] FE-PD-005 FE implementation slices for Decisioning Studio shell and cutover - [TODO] FE-PD-006 QA and rollout contract for Decisioning Studio - [TODO] FE-PD-007 Docs and deprecation plan for legacy policy / VEX product labels - [DONE] FE-WL-001 Freeze Watchlist shell ownership and route contract