Carlos Florêncio
64 lines
2.3 KiB
Markdown
64 lines
2.3 KiB
Markdown
---
|
|
id: "06-e2e-and-documentation"
|
|
title: "Prove credential policy UX and document the boundary"
|
|
status: done
|
|
wave: 4
|
|
depends_on:
|
|
- "03-managed-runtime-tools"
|
|
- "04-settings-explanation"
|
|
- "05-changes-identity-disclosure"
|
|
plan: "plan.md"
|
|
spec: "../../specs/integrations/github-authentication.md"
|
|
---
|
|
|
|
# Task 06: Prove Credential Policy UX And Document The Boundary
|
|
|
|
## Acceptance
|
|
|
|
- Desktop and mobile E2E prove policy persistence/help plus managed and runtime-selected Changes
|
|
disclosures, including keyboard/touch access, 44px targets, and no horizontal overflow.
|
|
- Public GitHub/executor/getting-started documentation separates automation method from task
|
|
credential policy and gives accurate managed-versus-inherited troubleshooting.
|
|
- E2E runs use rebuilt production backend/Vite artifacts and record exact results.
|
|
|
|
## Verification
|
|
|
|
```bash
|
|
make -C apps/backend build
|
|
cd apps && pnpm --filter @kandev/web build:vite
|
|
cd apps/web && pnpm e2e:run --project chromium tests/integrations/github-workspace-settings.spec.ts tests/git/git-credential-identity.spec.ts
|
|
cd apps/web && pnpm e2e:run --project mobile-chrome tests/integrations/mobile-github-workspace-settings.spec.ts tests/git/mobile-git-credential-identity.spec.ts
|
|
```
|
|
|
|
## Files likely touched
|
|
|
|
- `apps/web/e2e/tests/integrations/github-workspace-settings.spec.ts`
|
|
- `apps/web/e2e/tests/integrations/mobile-github-workspace-settings.spec.ts`
|
|
- `apps/web/e2e/tests/git/git-credential-identity.spec.ts`
|
|
- `apps/web/e2e/tests/git/mobile-git-credential-identity.spec.ts`
|
|
- `apps/web/e2e/pages/github-auth-settings-page.ts`
|
|
- `apps/web/e2e/helpers/api-client.ts` only if a typed snapshot seed helper is needed
|
|
- `docs/public/integrations.md`
|
|
- `docs/public/executors.md`
|
|
- `docs/public/use-kandev.md`
|
|
- this task file and `plan.md`
|
|
|
|
## Dependencies
|
|
|
|
Tasks 03, 04, and 05.
|
|
|
|
## Parallelism
|
|
|
|
Sequential. It integrates all backend/frontend behavior and owns production E2E evidence.
|
|
|
|
## Inputs
|
|
|
|
- All task-policy spec scenarios.
|
|
- Completed Task 03 runtime proof, Task 04 settings UI, and Task 05 Changes disclosure.
|
|
- Existing GitHub settings page object and `_test/task-sessions` metadata seeding.
|
|
|
|
## Output contract
|
|
|
|
Report the exact desktop/mobile E2E scenarios, build and test results, public-doc wording changes,
|
|
residual out-of-scope security limits, files changed, and update task/plan status.
|