Archive completed search foundation sprints

This commit is contained in:
master
2026-03-08 00:16:35 +02:00
parent a6187c70b4
commit 8ee40b56e9
3 changed files with 28 additions and 25 deletions

View File

@@ -77,7 +77,7 @@ Completion criteria:
- [x] FE tests assert payload shape sent to `/api/v1/search/query`. - [x] FE tests assert payload shape sent to `/api/v1/search/query`.
### WEB-CTX-004 - AdvisoryAI ambient contract and processor extension ### WEB-CTX-004 - AdvisoryAI ambient contract and processor extension
Status: TODO Status: DONE
Dependency: WEB-CTX-003 Dependency: WEB-CTX-003
Owners: Developer (AdvisoryAI) Owners: Developer (AdvisoryAI)
Task description: Task description:
@@ -87,12 +87,12 @@ Task description:
- Align route-domain mapping prefixes with current FE routing patterns. - Align route-domain mapping prefixes with current FE routing patterns.
Completion criteria: Completion criteria:
- [ ] Backend accepts and normalizes last-action ambient metadata. - [x] Backend accepts and normalizes last-action ambient metadata.
- [ ] Route mapping parity tests cover FE route prefixes currently in use. - [x] Route mapping parity tests cover FE route prefixes currently in use.
- [ ] Unit/integration tests verify context-aware boosts/refinements are deterministic. - [x] Unit/integration tests verify context-aware boosts/refinements are deterministic.
### WEB-CTX-005 - Context-aware suggestion UX updates ### WEB-CTX-005 - Context-aware suggestion UX updates
Status: DOING Status: DONE
Dependency: WEB-CTX-004 Dependency: WEB-CTX-004
Owners: Developer (FE), UX Owners: Developer (FE), UX
Task description: Task description:
@@ -101,28 +101,30 @@ Task description:
- last-action-aware suggestions - last-action-aware suggestions
- backend refinements/suggestions when present - backend refinements/suggestions when present
- Ensure chat onboarding suggestions remain consistent with shared context rules. - 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: Completion criteria:
- [ ] Empty-state suggestion chips adapt to route + last action. - [x] Empty-state suggestion chips adapt to route + last action.
- [ ] No-results and sparse-results views surface contextual refinements clearly. - [x] No-results and sparse-results views surface contextual follow-up behavior through executable starter chips, answer-first fallbacks, or later correction-phase equivalents.
- [ ] Accessibility and keyboard navigation behavior remains intact. - [x] Accessibility and keyboard navigation behavior remains intact.
### WEB-CTX-006 - Quality telemetry and guardrails ### WEB-CTX-006 - Quality telemetry and guardrails
Status: TODO Status: DONE
Dependency: WEB-CTX-004 Dependency: WEB-CTX-004
Owners: Developer (FE), Developer (AdvisoryAI) Owners: Developer (FE), Developer (AdvisoryAI)
Task description: Task description:
- Add bounded telemetry markers to evaluate contextual suggestion usefulness without storing sensitive raw prompts beyond existing policy. - 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. - Ensure no unbounded growth in in-memory/session context stores.
- Keep deterministic ordering and offline behavior guarantees. - 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: Completion criteria:
- [ ] Telemetry and logs distinguish contextual vs non-contextual suggestion paths. - [x] Telemetry remains bounded and optional without blocking contextual search behavior.
- [ ] Privacy posture for stored query/action metadata is documented and validated. - [x] Privacy posture for stored query/action metadata is documented and validated.
- [ ] No new external dependencies introduced. - [x] No new external dependencies introduced.
### WEB-CTX-007 - Docs sync and rollout plan ### WEB-CTX-007 - Docs sync and rollout plan
Status: DOING Status: DONE
Dependency: WEB-CTX-005 Dependency: WEB-CTX-005
Owners: Documentation author, Project Manager Owners: Documentation author, Project Manager
Task description: Task description:
@@ -133,9 +135,9 @@ Task description:
- Record rollout strategy (feature flag/canary, fallback behavior, success metrics) and decision log. - Record rollout strategy (feature flag/canary, fallback behavior, success metrics) and decision log.
Completion criteria: Completion criteria:
- [ ] Docs reflect final API payload and UI behavior. - [x] Docs reflect final API payload and UI behavior.
- [ ] Sprint Decisions & Risks includes rollout gates and fallback plan. - [x] Sprint Decisions & Risks includes rollout gates and fallback plan.
- [ ] Execution log captures implementation and verification evidence links. - [x] Execution log captures implementation and verification evidence links.
## Execution Log ## Execution Log
| Date (UTC) | Update | Owner | | 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 | 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-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 | 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 ## 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. - 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: 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: 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: 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`. - 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. - Risk: stale action context may bias suggestions toward irrelevant domains.
- Mitigation: TTL + bounded history + explicit reset on session boundaries. - Mitigation: TTL + bounded history + explicit reset on session boundaries.

View File

@@ -129,6 +129,7 @@ Completion criteria:
- Mitigation: derive labels from the same shared registry used for suggestion selection and context-rail presentation. - 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. - 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. - 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 ## Next Checkpoints
- 2026-03-07: FE-UX-001 through FE-UX-005 shipped and verified. - 2026-03-07: FE-UX-001 through FE-UX-005 shipped and verified.

View File

@@ -2,8 +2,6 @@
## Active Sprint Links ## Active Sprint Links
- `docs/implplan/SPRINT_20260221_041_FE_prealpha_ia_ops_setup_rewire.md` - `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_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_006_FE_self_serve_rollout_and_gap_closure.md`
- `docs/implplan/SPRINT_20260307_009_DOCS_ui_component_preservation_map.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] 041-T12 Targeted tests and verification evidence
- [DONE] WEB-CTX-002 FE ambient context capture (page + last action) - [DONE] WEB-CTX-002 FE ambient context capture (page + last action)
- [DONE] WEB-CTX-003 FE -> AdvisoryAI ambient payload activation - [DONE] WEB-CTX-003 FE -> AdvisoryAI ambient payload activation
- [DOING] WEB-CTX-005 Context-aware suggestion UX updates - [DONE] WEB-CTX-005 Context-aware suggestion UX updates
- [DOING] WEB-CTX-007 Docs sync and rollout plan - [DONE] WEB-CTX-007 Docs sync and rollout plan
- [DONE] WEB-CTX-005A Playwright exhaustive query matrix (>1000 query types) - [DONE] WEB-CTX-005A Playwright exhaustive query matrix (>1000 query types)
- [DONE] FE-UX-001 Search context rail and explainable chips - [DONE] FE-UX-001 Search context rail and explainable chips
- [DONE] FE-UX-002 Search/AdvisoryAI shared mode switch (`Find` / `Explain` / `Act`) - [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-005 Triage explainability restoration placement note
- [DONE] DOCS-RTS-006 Workflow visualization and replay 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 - [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 - [DOING] 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 - [DOING] 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 - [DOING] 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 - [DOING] 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-005 FE implementation slices for Decisioning Studio shell and cutover
- [TODO] FE-PD-006 QA and rollout contract for Decisioning Studio - [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 - [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 - [DONE] FE-WL-001 Freeze Watchlist shell ownership and route contract