Robot Passport — Specification v1

1. What a standard is made of

A versioned schema, a runnable conformance test, and a live reference implementation. All three are here:

• schema.json (JSON Schema 2020-12)
• conformance.py — stdlib-only, anyone can run:

python3 conformance.py https://astranl.com 479
# CONFORMS: .../api/robot-passport/479 satisfies Robot Passport v1

• Live reference: /api/robot-passport/479 — checking…

2. Truth law field

honest_gaps is REQUIRED: what is not known must be declared, never invented. Tiers: T0 name-only → T1 public-enriched → T2 manufacturer-claimed → T3 evidence-verified. Provenance names the source of every fact.

3. Versioning & deprecation policy

Schema tag: astranl-robot-passport/v1. Within v1: fields are only ADDED, never removed or retyped (additive-only). Breaking changes = new major (/v2) served in parallel; v1 remains for ≥ 12 months after v2 ships, with a deprecation field announcing dates. Errors are JSON: {"ok":false,"error":"code"}.

4. Agent quickstart (60 seconds)

curl https://astranl.com/api/robot-passport/479      # read a passport
curl https://astranl.com/api/robot-route?need=inspect # route a need
curl -X POST https://astranl.com/do \
  -H 'Content-Type: application/json' \
  -d '{"intent":"","source":"your-agent"}'  # open coordination

Full map: /llms.txt · facts.json · openapi.json. Security: security.txt.