Files
Metamorph/e2e
Knacky e1b51db25f fix(m6): post-review pass — cache prefix, snapshot lock, perm-before-parse, LIKE escape
Addresses spec-reviewer + code-reviewer feedback on the M6 bundle:

Critical:
- frontend/src/lib/missions.ts: add `listPrefix()` so TanStack invalidation
  catches every filtered list variant; the previous `list()` returned
  `['missions','list',{}]` and only matched the exact empty-filter cache,
  leaving filtered tables stale after create/transition/delete.
- backend/app/services/missions.py: acquire the same per-scenario
  `pg_advisory_xact_lock` key used by `set_scenario_tests` before
  snapshotting; without it a concurrent M5 reorder could freeze a torn
  snapshot under READ COMMITTED. Sorted by key to avoid deadlocks with
  another snapshotter.

Important:
- backend/app/api/missions.py: `@require_perm("mission.update",
  "mission.archive")` on the transition endpoint so users without either
  perm get 403 before the body is parsed (no shape leak via 400).
- backend/app/services/missions.py: escape `%` / `_` / `\` in user-typed
  `q` / `client` LIKE search; users can no longer trigger wildcard
  semantics by typing literal `%`. Added `escape='\\'` arg on every .like().
- backend/app/services/missions.py: filter `MissionTest.deleted_at` and
  `MissionScenario.deleted_at` in the list-item and detail counts so M7+
  soft-deletes don't drift the totals silently.

Nits:
- backend/app/api/users.py: order `/users/roster` by email for stable
  rendering + deterministic e2e selectors.
- frontend/src/pages/MissionDetailPage.tsx: distinct accent per
  transition target (cyan/orange/green/teal) matching the status legend.
- e2e/tests/m6-missions.spec.ts: switch fragile `getByRole(name=/In
  Progress/i)` to the stable `mission-transition-in_progress` data-testid.

New tests:
- test_create_mission_rejects_soft_deleted_scenario
- test_transition_perm_gate_runs_before_payload_parse
- test_search_treats_wildcards_as_literals

Suite: 106 pytest passing (was 103), 43 Playwright passing.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-13 15:14:57 +02:00
..

Metamorph e2e

End-to-end tests powered by Playwright. Each milestone in tasks/todo.md should add at least one spec file (tests/m<N>-*.spec.ts).

One-time setup

cd e2e
npm install
npm run install-browsers      # downloads chromium (uses sudo for system deps)

Running against a live stack

# 1. Bring the stack up from the repo root:
cd .. && make up

# 2. Run the tests:
cd e2e && npm test

# 3. Open the HTML report:
npm run report                 # opens playwright-report/index.html in your browser

Or from the repo root:

make e2e        # runs against the already-up stack
make e2e-report # opens the HTML report
make e2e-up     # one-shot: make up + wait healthy + run tests

Auto-spawn mode

Set PW_AUTOSTART=1 to let Playwright spawn make up itself before the run:

PW_AUTOSTART=1 npm test

Configuration

Env var Default Purpose
BASE_URL http://localhost:8080 The front nginx URL (which proxies /api/*)
PW_AUTOSTART 0 If 1, spawn make up before the tests
CI unset When set, retries=2 and parallel workers=2

Reports

  • HTML : e2e/playwright-report/index.html
  • JUnit : e2e/playwright-report/junit.xml (CI ingestion)
  • Trace : kept on first retry, opened with npx playwright show-trace …

Layout

e2e/
├── tests/
│   └── m0-smoke.spec.ts        # bootstrap milestone (current)
│   └── m<N>-*.spec.ts          # one spec per milestone, added as features land
├── playwright.config.ts
├── tsconfig.json
└── package.json