Jadpo is experimental and not ready for production. These docs follow the compiler's main branch as of 4 Nov 2026. What's built · Install 0.2.0
jadpo
Reference: Tooling

Tooling · rule

protocol.mismatch

On this page

A registry's OpenAPI document differs from the registry protocol.

Area 14, Tooling; not declinable; the next step is usually the agent's.

Why Jadpo refuses it

The jadpo tool is built against the registry protocol's table, so a registry whose requests, answers or failures differ from it can't serve jadpo package add or jadpo package publish. jadpo package protocol <document> compares the document with the table, and lists each difference under the request it is in.

What it looks like

shell
printf '{"openapi":"3.1.0"}' > main.jsonjadpo package protocol main.json
output
error: `main.json` differs from the registry protocol  reason: The `jadpo` tool is built against the registry protocol's table, so a registry that differs from it can't serve `jadpo package add` or `jadpo package publish`.  next: Change the routes each line below names, then run this again (agent)  rule: protocol.mismatch  help: https://jadpo.dev/docs/errors/protocol.mismatchdocument  has no pathsDiffers from the registry protocol: 1 difference, main.json

(agent) at the end of the next: line means your coding agent can make the fix itself.

How to fix it

If the registry application should follow the protocol, change the routes each line names, then write the document again and check it:

shell
jadpo checkjadpo package protocol build/openapi/main.json

The check passes once the document matches the table, and the run exits 0.

Markdown for agents: /docs/errors/protocol.mismatch.md.Built from Jadpo main at 0e6fe62.