Files
kandev/docs/plans/kubernetes-executor-status-settings-repair/task-04-responsive-e2e-docs.md
T
2026-09-02 13:50:03 +00:00

108 lines
4.7 KiB
Markdown

---
id: "04-responsive-e2e-docs"
title: "Verify responsive flows and update docs"
status: complete
wave: 4
depends_on:
- "01-refresh-status-credentials"
- "02-task-chrome-status-controls"
- "03-unify-profile-settings"
plan: "plan.md"
spec: "../../specs/kubernetes-executor/spec.md"
---
# Task 04: Verify responsive flows and update docs
## Acceptance
- Desktop and mobile E2E cover recovered sidebar/Kanban status, compact task
controls, profile-root navigation, and the one-page admin/member settings
hierarchy without horizontal overflow.
- Legacy configured-executor routes redirect to a profile while orphan recovery
remains reachable.
- Public Kubernetes/executor docs describe the final hierarchy and shared
connection blast radius; every managed E2E process is torn down.
## Verification
```bash
cd apps && pnpm install --frozen-lockfile && pnpm --filter @kandev/web build:e2e && cd web && pnpm e2e:raw --project=chromium --workers=1 --retries=0 e2e/tests/settings/kubernetes-task-environment.spec.ts e2e/tests/settings/kubernetes-executor.spec.ts && pnpm e2e:raw --project=mobile-chrome --workers=1 --retries=0 e2e/tests/settings/mobile-kubernetes-task-environment.spec.ts e2e/tests/settings/mobile-kubernetes-executor.spec.ts && pnpm run e2e:sleep-ratchet && cd ../.. && node --test scripts/validate-public-docs.test.mjs && node scripts/validate-public-docs.mjs && git diff --check
```
## Files likely touched
- `apps/web/e2e/helpers/session-capabilities.ts` or a focused Kubernetes status rewrite helper
- `apps/web/e2e/tests/settings/kubernetes-task-environment.spec.ts`
- `apps/web/e2e/tests/settings/mobile-kubernetes-task-environment.spec.ts`
- `apps/web/e2e/tests/settings/kubernetes-executor.spec.ts`
- `apps/web/e2e/tests/settings/mobile-kubernetes-executor.spec.ts`
- `docs/public/k8s.md`
- `docs/public/executors.md`
- `docs/plans/kubernetes-executor-status-settings-repair/plan.md`
- all task files in this plan for final result synchronization
## Dependencies
Tasks 01, 02, and 03.
## Parallelism
`sequential`. It verifies the integrated backend/frontend contract and updates
shared E2E artifacts already modified by the first UX repair.
## Inputs
- Spec: all new responsive/status/settings scenarios.
- Plan: E2E Tests and Public Documentation sections.
- Existing patterns: managed Playwright fixture, `routeWebSocket`,
`assertNoDocumentHorizontalOverflow`, and current Kubernetes E2E seed helpers.
## Output contract
Report exact discovery/pass counts, artifact paths, process/fixture teardown,
docs validation, files changed, blockers/risks, and mark all tasks plus
`plan.md` complete only after every command passes.
## Results
Implemented the integrated responsive coverage and public documentation for the
repaired status and settings hierarchy. Desktop coverage proves that Kanban and
sidebar Kubernetes status icons surface an exact unauthorized Pod read, recover
to the exact healthy Pod after credentials become usable, and use the healthy
tone instead of retaining the stale error. The task disclosure keeps the Pod
summary while exposing only compact Refresh and Profile settings controls; its
Refresh action joins the active status request and its gear links to the exact
profile root.
Desktop and mobile settings coverage now treats the profile root as the single
configured Kubernetes hierarchy: shared connection fields, diagnostics, active
sessions, workload, workspace, credentials, scripts, and policy all remain on
one page. It verifies unsaved connection plus workload diagnostics, direct
post-create profile navigation, configured legacy-route redirects, member
read-only parity, touch targets, contained YAML, and zero-profile orphan
recovery.
Documentation in `docs/public/k8s.md` and `docs/public/executors.md` describes
the same hierarchy, the shared connection blast radius, compact task controls,
and the exceptional orphan recovery route.
Final verification:
- Focused frontend suite: 14 files, 97 tests passed.
- Desktop managed Playwright: 4 discovered, 4 passed with one worker and zero
retries (24.5s).
- Mobile Chrome managed Playwright: 4 discovered, 4 passed with one worker and
zero retries (19.8s).
- `pnpm run typecheck`: passed.
- Focused ESLint and Prettier checks for the final route/E2E corrections:
passed.
- `pnpm run e2e:sleep-ratchet`: 16 added and 9 modified E2E files clean.
- Public docs: 61 validator tests passed and 41 published pages validated.
- `git diff --check`: clean.
The managed runner removed every process and temporary directory created by
these runs. The only workspace backend left running is the intentionally
preserved isolated seed on port 48646; the main Kandev instance on port 9998 was
not touched. Older `/tmp/kandev-e2e-*` directories from August 21-24 were
outside these runs and were preserved.