> ## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.