diff --git a/docs/implplan/SPRINT_20260310_005_FE_integrations_live_action_sweep.md b/docs/implplan/SPRINT_20260310_005_FE_integrations_live_action_sweep.md new file mode 100644 index 000000000..69f381e00 --- /dev/null +++ b/docs/implplan/SPRINT_20260310_005_FE_integrations_live_action_sweep.md @@ -0,0 +1,60 @@ +# Sprint 20260310_005 - Integrations Live Action Sweep + +## Topic & Scope +- Deep-verify the Integrations hub against the rebuilt `https://stella-ops.local` stack with real Playwright interactions, not route-only checks. +- Treat typed onboarding as part of correctness: registry and runtime-host actions must land on the correct typed onboarding routes, while generic sources must fall back to the shared onboarding hub. +- Working directory: `src/Web/StellaOps.Web`. +- Expected evidence: live Playwright sweep JSON, execution log updates, and a scoped commit. + +## Dependencies & Concurrency +- Depends on the authenticated frontdoor harness and the clean 111-route canonical sweep on the rebuilt stack. +- Safe to run in parallel with router readiness and component-revival work as long as edits stay inside `src/Web/StellaOps.Web` and this sprint file. + +## Documentation Prerequisites +- `AGENTS.md` +- `docs/qa/feature-checks/FLOW.md` +- `docs/modules/platform/architecture-overview.md` + +## Delivery Tracker + +### FE-INTEGRATIONS-LIVE-001 - Capture live integrations action evidence +Status: DONE +Dependency: none +Owners: QA, Developer +Task description: +- Add a dedicated live Playwright script for the Integrations hub that exercises the hub tabs, onboarding CTAs, typed add actions, generic add actions, and activity handoffs on the authenticated frontdoor. +- The sweep must fail when CTAs misroute, when runtime errors surface, or when the live stack serves the wrong onboarding destination for a given integration type. + +Completion criteria: +- [x] A committed live sweep script exists under `src/Web.StellaOps.Web/scripts/`. +- [x] The sweep captures fresh evidence under `src/Web.StellaOps.Web/output/playwright/`. +- [x] Any failures are diagnosed to code-level root causes before implementation changes begin. + +### FE-INTEGRATIONS-LIVE-002 - Reverify the integrations action slice +Status: DONE +Dependency: FE-INTEGRATIONS-LIVE-001 +Owners: QA +Task description: +- Run the same live integrations sweep against the rebuilt stack and confirm the action slice is behaviorally clean. + +Completion criteria: +- [x] The integrations sweep passes with zero failed actions. +- [x] The integrations sweep reports zero runtime issues. +- [x] Execution Log records the final evidence path and commit hash. + +## Execution Log +| Date (UTC) | Update | Owner | +| --- | --- | --- | +| 2026-03-10 | Sprint created after the authenticated 111-route canonical sweep came back clean, moving the next iteration from route rescue to deeper integrations action verification. | QA | +| 2026-03-10 | Added `live-integrations-action-sweep.mjs` to cover shell tabs, typed onboarding CTAs, generic onboarding fallbacks, and activity handoffs across the live Integrations family. | QA | +| 2026-03-10 | First live sweep reported one false failure: `Advisory & VEX` was present in the Integrations shell but exposed as a tabbed-nav item rather than a plain link, so the harness selector missed it. No runtime issues were present. | Developer | +| 2026-03-10 | Corrected the harness to search both `link` and `tab` roles for shell navigation and reran the exact live sweep. Final evidence is clean at `failedActionCount=0` and `runtimeIssueCount=0` in `src/Web.StellaOps.Web/output/playwright/live-integrations-action-sweep.json`. Commit hash pending local commit. | QA | + +## Decisions & Risks +- Decision: typed onboarding is part of the live integrations contract. If a type-specific list page routes to the wrong onboarding target, that is a product defect, not a cosmetic issue. +- Risk: the Integrations hub mixes typed and generic onboarding flows. The harness must assert the intended destination per integration type instead of treating all add buttons as equivalent. +- Decision: the Integrations shell uses tabbed navigation semantics. The live harness must consider both `link` and `tab` roles when verifying shell actions so accessibility-correct tabs do not register as false defects. + +## Next Checkpoints +- Capture the first integrations action sweep against the live frontdoor. +- Fix any misroutes or inert CTAs before moving on to another page family.