suaveplan/openspec/archive/2026-04-27-testing-e2e-async-and-fixtures-hardening/tasks.md

Tasks — testing-e2e: async-span + apiContext fixture hardening

1. Spec authoring

• 1.1 Read openspec/specs/testing-e2e/spec.md
• 1.2 Draft proposal.md
• 1.3 Draft specs/testing-e2e/spec.md delta
• 1.4 Every requirement carries a **Verified by:** line

2. Implementation

• 2.1 Drop { browser: _browser } destructure in apiContext fixture
• 2.2 Add async-aware span lifecycle in src/observability/instrumented.ts
• 2.3 Update spec coverage gate to 100% and fix package path reference

3. Tests

• 3.1 src/fixtures/extended-test.test.ts — source-level guard added
• 3.2 src/observability/instrumented.test.ts — added 3 async-span tests
• 3.3 Every it(...) carries { timeout: 5000 }

4. Documentation

• 4.1 Sibling .md updated for extended-test.md, instrumented.md

5. Pre-archive verification (the 5-gate triple)

• 5.1 bun run check — Biome 0/0/0
• 5.2 bunx turbo lint typecheck test --filter=@suaveplan/testing-e2e — green
• 5.3 bunx turbo test:coverage --filter=@suaveplan/testing-e2e — 100/100/100/100
• 5.4 bun scripts/openspec-conformance.ts @suaveplan/testing-e2e — exit 0
• 5.5 bunx turbo build --filter=@suaveplan/testing-e2e — green

6. Pre-archive 7-row checklist

• 6.1 Generics threaded
• 6.2 No new boundary inputs
• 6.3 No new error codes
• 6.4 Strict-mode N/A
• 6.5 OTel span lifetime now asserted via observable elapsed time
• 6.6 N/A
• 6.7 No retroactive tick

7. Archive

• 7.1 Fold spec delta into openspec/specs/testing-e2e/spec.md
• 7.2 Move folder → openspec/archive/2026-04-27-testing-e2e-async-and-fixtures-hardening/