/ork:cover authentication flow
/ork:cover --model=opus payment processing
/ork:cover --tier=unit,integration user service
/ork:cover --real-services checkout pipeline

SCOPE = "$ARGUMENTS"  # e.g., "authentication flow"

---

undefined

---

AskUserQuestion(
  questions=[
    {
      "question": "What test tiers should I generate?",
      "header": "Test Tiers",
      "options": [
        {"label": "Full coverage (Recommended)", "description": "Unit + Integration (real services) + E2E", "markdown": "```\nFull Coverage\n─────────────\n  Unit            Integration       E2E\n  ┌─────────┐    ┌─────────────┐  ┌──────────┐\n  │ AAA     │    │ Real DB     │  │Playwright│\n  │ Mocks   │    │ Real APIs   │  │Page obj  │\n  │ Factory │    │ Testcontain │  │A11y      │\n  └─────────┘    └─────────────┘  └──────────┘\n  3 parallel test-generator agents\n```"},
        {"label": "Unit + Integration", "description": "Skip E2E, focus on logic and service boundaries", "markdown": "```\nUnit + Integration\n──────────────────\n  Unit tests for business logic\n  Integration tests at API boundaries\n  Real services if docker-compose found\n  Skip: browser automation\n```"},
        {"label": "Unit only", "description": "Fast isolated tests for business logic", "markdown": "```\nUnit Only (~2 min)\n──────────────────\n  AAA pattern tests\n  MSW/VCR mocking\n  Factory-based data\n  Coverage gap analysis\n  Skip: real services, browser\n```"},
        {"label": "Integration only", "description": "API boundary and real-service tests", "markdown": "```\nIntegration Only\n────────────────\n  API endpoint tests (Supertest/httpx)\n  Database tests (real or in-memory)\n  Contract tests (Pact)\n  Testcontainers if available\n```"},
        {"label": "E2E only", "description": "Playwright browser tests", "markdown": "```\nE2E Only\n────────\n  Playwright page objects\n  User flow tests\n  Visual regression\n  Accessibility (axe-core)\n```"}
      ],
      "multiSelect": false
    },
    {
      "question": "Healing strategy for failing tests?",
      "header": "Failure Handling",
      "options": [
        {"label": "Auto-heal (Recommended)", "description": "Fix failing tests up to 3 iterations"},
        {"label": "Generate only", "description": "Write tests, report failures, don't fix"},
        {"label": "Strict", "description": "All tests must pass or abort"}
      ],
      "multiSelect": false
    }
  ]
)

TaskCreate(
  subject=f"Cover: {SCOPE}",
  description="Generate comprehensive test suite with real-service testing",
  activeForm=f"Generating tests for {SCOPE}"
)

---

undefined

**Real-service decision:**
- `docker-compose*.yml` found → integration tests use real services
- `testcontainers` in deps → use testcontainers for isolated service instances
- Neither found + `--real-services` flag → error: "No docker-compose or testcontainers found. Install testcontainers or remove --real-services flag."
- Neither found, no flag → integration tests use mocks (MSW/VCR)

Load real-service detection details: `Read("${CLAUDE_SKILL_DIR}/references/real-service-detection.md")`

undefined

Output coverage baseline to user immediately (progressive output).

undefined

    Focus on:
    - AAA pattern (Arrange-Act-Assert)
    - Parametrized tests for multiple inputs
    - MSW/VCR for HTTP mocking (never mock fetch directly)
    - Factory-based test data (FactoryBoy/faker-js)
    - Edge cases: empty input, errors, timeouts, boundary values
    - Target: 90%+ business logic coverage""",
    isolation="worktree",
    run_in_background=True,
    max_turns=50,
    model=MODEL_OVERRIDE
)

    Focus on:
    - API endpoint tests (Supertest/httpx)
    - Database tests with {'real DB via testcontainers/docker-compose' if real_services else 'in-memory/mocked DB'}
    - Contract tests (Pact) for service boundaries
    - Zod/Pydantic schema validation at edges
    - Fresh state per test (transaction rollback or cleanup)
    - Target: all API endpoints and service boundaries""",
    isolation="worktree",
    run_in_background=True,
    max_turns=50,
    model=MODEL_OVERRIDE
)

    Focus on:
    - Semantic locators (getByRole > getByLabel > getByTestId)
    - Page Object Model for complex pages
    - User flow tests (happy path + error paths)
    - Accessibility tests (axe-core WCAG 2.2 AA)
    - Visual regression (toHaveScreenshot)
    - No hardcoded waits (use auto-wait)""",
    isolation="worktree",
    run_in_background=True,
    max_turns=50,
    model=MODEL_OVERRIDE
)

Output each agent's results **as soon as it returns** — don't wait for all agents. This lets users see generated tests incrementally.

> **Partial results (CC 2.1.76):** If an agent is killed (timeout, context limit), its response is tagged `[PARTIAL RESULT]`. Include partial tests but flag them in Phase 4.

undefined

undefined

for iteration in range(3):
    if all_tests_pass:
        break

    # For each failing test:
    # 1. Read the test file and the source code it tests
    # 2. Analyze the failure (assertion error? import error? timeout?)
    # 3. Fix the test (not the source code — tests only)
    # 4. Re-run the fixed tests

    # Common fixes:
    # - Wrong assertions (expected value mismatch)
    # - Missing imports or setup
    # - Stale selectors in E2E tests
    # - Race conditions (add proper waits)
    # - Mock configuration errors

Coverage Report: {SCOPE}
═══════════════════════════

Baseline → After
────────────────
  Unit:        67.2% → 91.3% (+24.1%)
  Integration: 42.0% → 78.5% (+36.5%)
  E2E:          0.0% → 65.0% (+65.0%)
  Overall:     48.4% → 82.1% (+33.7%)

Tests Generated
───────────────
  Unit:        23 tests (18 pass, 5 healed)
  Integration: 12 tests (10 pass, 2 healed)
  E2E:          8 tests (8 pass)
  Total:       43 tests

Heal Iterations: 2/3

Files Created
─────────────
  tests/unit/services/test_auth.py
  tests/unit/services/test_payment.py
  tests/integration/api/test_users.py
  tests/integration/api/test_checkout.py
  tests/e2e/checkout.spec.ts
  tests/e2e/pages/CheckoutPage.ts

Real Services Used: PostgreSQL (testcontainers), Redis (docker-compose)

Remaining Gaps
──────────────
  - src/services/notification.ts (0% — no tests generated, out of scope)
  - src/utils/crypto.ts (45% — edge cases not covered)

Next Steps
──────────
  /ork:verify {SCOPE}    # Grade the implementation + tests
  /ork:commit             # Commit generated tests
  /loop 10m npm test -- --coverage  # Watch coverage while coding

undefined

---