randomayzer/agents/antigravity/inbox/TASK-2026-08-21-08-prisma-integration-harness.md

Task 08: Prisma Integration Test Harness

Assigned to: Antigravity (Implementation Orchestrator)
Priority: MEDIUM (production storage driver coverage)
Date: 2026-08-21
Base SHA: 2da8b01b1b5491b0db491492ec039271d7855ead

Scope

1. Implement integration test suite for PrismaGiveawayRepository and PrismaUserRepository against PostgreSQL:
   • Atomic state transitions: createAndLockSnapshot (atomic seed + snapshot lock, single lock invariant, concurrent lock attempts with exactly 1 winner).
   • Atomic draw finalization: saveDrawResultAndAudit (transition SNAPSHOT_LOCKED -> DRAWN, P2002 duplicate prevention).
   • Atomic snapshot unlock: unlockSnapshot (transition SNAPSHOT_LOCKED -> READY, reset seed to null).
   • State guard: saveParticipants requires READY.
   • Ownership constraint: onDelete: Restrict on Giveaway.organizerId.
   • Pagination & counts: getParticipantsPaginated.
   • Record factual eligibleCount behavior under Prisma.
2. Separate test configuration & script in package.json:
   • npm test remains 100% executable without database (unit tests with memory repository).
   • npm run test:integration executes integration tests against DATABASE_URL.
   • If DATABASE_URL is not set or PostgreSQL is unreachable, fail-closed with explicit error/skip instructions rather than silent pseudo-green.
3. CI workflow update (.github/workflows/ci.yml):
   • Add integration test job against real postgres service with prisma migrate deploy (to verify actual Prisma migrations) and STORAGE_DRIVER=prisma.
4. Verification evidence & report in agents/antigravity/done/TASK-2026-08-21-08-prisma-integration-harness.md.