datit309 /supergraph:integration
Integration + e2e tests. Validates modules work together. Run AFTER unit tests pass.
Usage
/supergraph:integration | plan auth-login | plan auth-login task 3
Prerequisites
- Unit tests passing (
$TEST_CMDgreen) /supergraph:fixcompleted
Steps
0. Announce
"🔗 /supergraph:integration — running integration and e2e tests..."
1. Get Commands
Read from plan ## Environment Context or .supergraph-env. Missing → STOP, run /supergraph:scan first.
2. Verify Unit Tests Pass
$TEST_CMD
If unit tests FAIL → STOP: "Unit tests must pass before integration. Run /supergraph:fix first."
3. Detect Integration Setup
Check for integration configuration:
| Config | Command |
|---|---|
jest.integration.config.js |
npx jest --config jest.integration.config.js |
vitest.integration.config.ts |
npx vitest --config vitest.integration.config.ts |
pytest.ini with [integration] or -m integration |
pytest -m integration |
cypress.config.js / cypress.config.ts |
npx cypress run |
playwright.config.js / playwright.config.ts |
npx playwright test |
docker-compose.test.yml |
docker compose -f docker-compose.test.yml up --abort-on-container-exit |
*.integration.test.ts / *.integration.spec.ts pattern |
npx jest --testPathPattern="integration" |
If none found → skip: "No integration/e2e config found — skipping."
4. Run Integration Tests
Max 3 retries. On failure:
4b. Serena (optional): See serena/SKILL.md:Setup — find_referencing_symbols/get_diagnostics_for_file per failing module to surface mismatches. Skip if unavailable.
Trace failure to source module, fix, re-run.
5. Run E2E (if configured)
Max 2 retries (e2e is inherently flaky). Flaky tests: annotate with @flaky / test.slow() / @pytest.mark.flaky per framework — do not block merge on known-flaky tests.
6. Graph Validation
For CBM_PROJECT via codebase-memory-mcp (see references/codebase-memory-contract.md) — search_graph/trace_path + recipes dependencies/cross-boundary/test-gaps; fall back to Serena/filesystem if empty.
7. Update Plan Status
Pass → mark in-progress tasks Status: completed.
Fail after 3 retries → mark stuck, append failure log.
8. Report
✅ /supergraph:integration complete
- Unit: PASS | Integration: PASS|FAIL|SKIP | E2E: PASS|FAIL|SKIP
- Cross-module flows: N/M covered | Surprising connections: [list/none]
- Plan status: updated|none
- Next: /supergraph:verify → /supergraph:review
Rules
- Unit tests MUST pass BEFORE running integration
- Integration failures take priority over e2e (fix foundation first)
- Max 3 retries integration, 2 retries e2e
- Never block merge on
@flaky-annotated e2e tests - Always update plan status after completion
- After integration pass →
/supergraph:verify→/supergraph:review