> ## Documentation Index
> Fetch the complete documentation index at: https://mcp-server-langgraph.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Testing Strategy

> Comprehensive testing strategy including unit, integration, property-based, and mutation testing

### Testing Strategy

#### Test Pyramid

```mermaid theme={null}
flowchart BT
    A["Unit Tests<br/>(CI on every push)"]
    B["Integration Tests<br/>(CI on PR)"]
    C["E2E Tests<br/>(Manual/Staging)"]

    A -.-> B
    B -.-> C

    %% ColorBrewer2 Set3 palette - each component type uniquely colored
    classDef unitStyle fill:#b3de69,stroke:#7cb342,stroke-width:2px,color:#333
    classDef integrationStyle fill:#fdb462,stroke:#e67e22,stroke-width:2px,color:#333
    classDef e2eStyle fill:#80b1d3,stroke:#3498db,stroke-width:2px,color:#333

    class A unitStyle
    class B integrationStyle
    class C e2eStyle
```

#### Test Execution

**Local Testing**:

```bash theme={null}
## Unit tests only
make test-unit

## All automated tests
make test

## With coverage
make test-coverage

## Property-based tests
make test-property

## Benchmark tests
pytest -m benchmark -v --benchmark-only

## Mutation tests (slow!)
make test-mutation
```

**CI Testing**:

```properties theme={null}
## Exact CI command
ENABLE_TRACING=false \
ENABLE_METRICS=false \
ENABLE_CONSOLE_EXPORT=false \
pytest -m unit --tb=line -q
```

#### Test Markers

* `unit`: Fast, isolated unit tests
* `integration`: Tests requiring external services
* `property`: Property-based tests with Hypothesis
* `contract`: MCP protocol compliance tests
* `regression`: Performance regression tests
* `benchmark`: Performance benchmarks
* `mutation`: Mutation testing (weekly schedule)

#### Mutation Testing

**Purpose:** Measure test effectiveness

**Schedule:** Weekly (too slow for every PR)

**Command:**

```bash theme={null}
## Local execution
make test-mutation

## Or directly
mutmut run --paths-to-mutate=src/mcp_server_langgraph/
mutmut results
mutmut html  # Open html/index.html
```

**Target Score:** 80%+ mutation kills

#### Benchmark Testing

**Purpose:** Track performance regressions

**Execution:** Every PR + weekly

**Thresholds:**

* Agent response: p95 \< 5s
* LLM call: p95 \< 10s
* Authorization: p95 \< 50ms

**Alert:** Automatic PR comment if 20%+ slower

**Baseline Tracking:**

```bash theme={null}
## Run benchmarks
pytest -m benchmark -v --benchmark-only --benchmark-autosave

## Compare against baseline
pytest -m benchmark --benchmark-compare
```

## Next Steps

<CardGroup cols={2}>
  <Card title="Workflows" icon="github" href="./workflows">
    Configure test workflows
  </Card>

  <Card title="Deployment" icon="rocket" href="./deployment">
    Deploy tested code
  </Card>

  <Card title="Back to Overview" icon="arrow-left" href="./overview">
    Return to CI/CD overview
  </Card>
</CardGroup>