> ## Documentation Index
> Fetch the complete documentation index at: https://docs.geval.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Example — CI merge gate

> Validate contracts, run geval check, and choose committed vs generated signals.

## What runs in CI

1. **Checkout** — Your committed `.geval/` (contract + policies) is on the runner.
2. **Signals** — Either use a **committed** `signals.json` or **generate** one in a step (LangSmith, other tools, or `cp` from a known path).
3. **`geval validate-contract`** — Fast validation without signals.
4. **`geval check`** — One or more `--contract` paths, one `--signals` path.
5. **Policy** — Fail the job on exit `2` (BLOCK); optionally treat exit `1` (REQUIRE\_APPROVAL) differently—see [GitHub Actions](/integration/github-actions).

## Committed signals (no generator)

```yaml theme={null}
- uses: actions/checkout@v4
- name: Install Geval
  run: curl -fsSL https://github.com/geval-labs/geval/releases/latest/download/geval-linux-x86_64 -o geval && chmod +x geval
- name: Check
  run: ./geval check --contract .geval/contract.yaml --signals .geval/signals.json
```

## Generated signals (e.g. LangSmith)

```yaml theme={null}
- name: Generate signals
  run: python .github/scripts/generate_signals.py > signals.json
- name: Check
  run: ./geval check --contract .geval/contract.yaml --signals signals.json
```

Only the **generator** is vendor-specific; Geval’s CLI is the same.

## Sketch with validate

```yaml theme={null}
steps:
  - uses: actions/checkout@v4
  - name: Install Geval
    run: curl -fsSL https://github.com/geval-labs/geval/releases/latest/download/geval-linux-x86_64 -o geval && chmod +x geval
  - name: Validate contract
    run: ./geval validate-contract .geval/contract.yaml
  - name: Run check
    run: ./geval check --contract .geval/contract.yaml --signals .geval/signals.json
```

## Artifact upload

Upload **`.geval/decisions/*.json`** for audit. See [Decision artifacts](/reference/decision-artifacts).

## See also

[GitHub Actions](/integration/github-actions) · [Exit codes](/integration/exit-codes)