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

# Handoff conformance

> How to run the Handoff compatibility suite against your own deployment.

Conformance is the compatibility suite for Handoff. It checks the wire
contract and the observable behavior of a deployment, so an implementation can
prove what it supports without relying on a marketing claim.

## The current level

Level 1 contains 26 cases: C-1 through C-16, plus C-6b and C-18 through C-26.
C-17 is the only Level 2 case. It requires the optional `continuation`
extension and is intentionally not implemented by the current reference
server because it would require encrypted storage for `resume_payload`.

The reference server passes all 26 Level 1 cases. A deployed service exposes
its supported level from `GET /meta`; use the runner below to check another
deployment.

## What the runner checks

The suite includes negative profiles so a broken or incomplete deployment is
visible. It also checks the case map before running, so a missing or extra case
stops the run instead of silently changing the total.

## Run it against your own deployment

```sh theme={null}
handoff-conformance --base-url https://your-deployment.example.com/v1 \
                    --profile your-profile.yaml
```

The runner takes a base URL and does not care what is listening there. The
profile supplies credentials for the principal aliases the cases name and the
small set of below-HTTP checks required by the suite. A case whose requirement
is missing fails; it is never silently skipped.

Against a local checkout, the whole loop is one script that creates a
disposable database per run:

```sh theme={null}
cd handoff/core
dev/run-conformance.sh
dev/run-conformance.sh --case C-8
```

A clean store per run matters: fixture requests can remain pending, and a
reused `dedupe_key` would make a required `201` look like a `200` from an
earlier run.

## Independent implementations

You can read the protocol and implement it yourself. The suite exists so you
can check the observable contract without asking the reference server to vouch
for you.