Files
kandev/docs/plans/mcp-server-explorer/task-03-prove-browser-flows.md
T
2026-08-24 11:09:03 +00:00

80 lines
2.7 KiB
Markdown

---
id: "03-prove-browser-flows"
title: "Prove browser flows"
status: done
wave: 3
depends_on: ["02-build-responsive-explorer"]
plan: "plan.md"
spec: "../../specs/platform/requirements/mcp-session-observability.md"
---
# Task 03: Prove Browser Flows
## Acceptance
- Desktop Playwright coverage opens the wide dialog, selects Kandev, and reads
at least one enabled tool description.
- Desktop coverage selects a third-party server and reads the catalog limit.
- Mobile coverage proves the full-height list-to-detail flow, Back behavior,
internal scrolling, 44px controls, and no document overflow.
## Verification
```bash
cd apps/web && pnpm e2e:run tests/chat/mcp-status.spec.ts -- --project=chromium
cd apps/web && pnpm e2e:run tests/chat/mobile-mcp-status.spec.ts -- --project=mobile-chrome
```
Write the failing Playwright assertions against a fresh production build. Use
the mock agent's real Kandev `tools/list` request for catalog evidence.
## Files likely touched
- `apps/web/e2e/tests/chat/mcp-status.spec.ts`
- `apps/web/e2e/tests/chat/mobile-mcp-status.spec.ts`
- `apps/web/e2e/helpers/api-client.ts`
- `apps/web/e2e/pages/session-page.ts`
## Dependencies
Task 02 completes the responsive explorer.
## Parallelism
Parallel-safe with Task 04 after Task 02. This task owns only E2E files and
their direct helpers.
## Inputs
- Spec explorer scenarios.
- E2E causal-wait and production-build rules.
- The mobile `mobile-chrome` Pixel 5 project.
## Output contract
Report each initial failure, final command result, screenshots or traces,
geometry assertions, files changed, blockers, and risks. Update this task and
the plan status in the same session.
## Results
Implemented desktop and mobile browser coverage with the real mock-agent
`tools/list` request. The first desktop run exposed an overly broad status-text
locator, so the assertion was scoped to the detail pane. The first mobile run
exposed the shared drawer's default 80% viewport limit. The explorer now
overrides that limit for the phone full-height surface.
Final verification:
- `pnpm e2e:run tests/chat/mcp-status.spec.ts -- --project=chromium`: 1 passed.
- `pnpm e2e:run tests/chat/mobile-mcp-status.spec.ts -- --project=mobile-chrome`:
1 passed.
- Desktop coverage opens the explorer, reads a Kandev tool description, and
explains the unavailable third-party catalog.
- Mobile coverage proves a 44px trigger and Back control, a 90%+ viewport
drawer, internal detail scrolling, and no document horizontal overflow.
Fresh, compressed, and visually inspected PR assets are available at
`apps/web/.pr-assets/mcp-status--desktop-mcp-explorer-kandev.png` and
`apps/web/.pr-assets/mobile-mcp-status--mobile-mcp-explorer-kandev.png`.