Task 04: Prove model-mismatch recovery

Acceptance

Desktop E2E proves profile selection, task continuation, one warning, and warning persistence after reload.
Mobile E2E proves the same outcome through touch input without horizontal overflow.
Public documentation explains executor authority, optional configuration copying, and the unchanged saved profile model.

TDD scenarios

RED: Update the existing profile-picker E2E to require a selectable host mismatch.
RED: Add a task-launch scenario with an executor catalog that omits the requested model.
RED: Add reload and mobile scenarios for the persisted warning.
GREEN: Complete missing fixtures and selectors without weakening the runtime assertions.
GREEN: Update the public agent-profile and executor documentation.
REFACTOR: Share desktop and mobile model-mismatch setup helpers.

Verification

cd apps/web && pnpm e2e:run tests/settings/no-silent-model-fallback.spec.ts tests/session/model-mismatch-warning.spec.ts
cd apps/web && pnpm e2e:run --project mobile-chrome --no-build tests/settings/mobile-no-silent-model-fallback.spec.ts tests/session/mobile-model-mismatch-warning.spec.ts
node --test scripts/validate-public-docs.test.mjs
node scripts/validate-public-docs.mjs
git diff --check

Files likely touched

apps/web/e2e/tests/settings/no-silent-model-fallback.spec.ts
apps/web/e2e/tests/settings/mobile-no-silent-model-fallback.spec.ts
apps/web/e2e/tests/session/model-mismatch-warning.spec.ts
apps/web/e2e/tests/session/mobile-model-mismatch-warning.spec.ts
apps/web/e2e/tests/session/model-mismatch-warning-helpers.ts
apps/web/e2e/helpers/api-client.ts
docs/public/agents-and-profiles.md
docs/public/executors.md

Dependencies

Task 03 completes runtime, persistence, and frontend behavior.

Parallelism

Sequential after Task 03. This task validates the complete user flow.

Inputs

The completed model-decision and warning flow.
Existing no-silent-model-fallback E2E files.
The mock agent model catalog.
The public executor documentation.

Output contract

Report exact E2E commands, reload evidence, mobile geometry, public pages, failures, and final package status.

Risks

The host and executor catalogs need a deterministic mismatch fixture.
Worker-scoped profiles and tasks require cleanup after each scenario.
A warning visible before reload does not prove persistence.

Results

Desktop and mobile E2E proved task continuation, one warning, saved-profile preservation, and warning visibility after reload without horizontal overflow. Public documentation validation passed with 61 tests and 41 published pages.

2.9 KiB Raw Blame History