# ARL vocabulary (v1)

Stable IRIs for the AI Readiness Level open standard. Every wire
field of the four-axis Claim model, ARL-S Session, signed
Evaluation, and Ed25519 Attestation maps to a globally
unambiguous IRI under
`https://arl.transaction.science/vocab/v1#` (prefix `arl:` by
convention).

| File | Format | What |
|------|--------|------|
| [`v1.jsonld`](v1.jsonld) | JSON-LD `@context` | Term → IRI mapping. Adds typed RDF semantics to any ARL claim / session / evaluation JSON without changing its wire form. |
| [`v1.ttl`](v1.ttl) | Turtle (RDF) | Classes, enumerations, properties — the canonical semantic definition. Covers the four axes (validation depth / convergence class A–E / energy profile / security class S0–S4) and the ARL-S isolation tiers (0–3). |
| [`v1.shapes.ttl`](v1.shapes.ttl) | SHACL Core | Shape graph — validates `Claim`, `Session`, `Evaluation`, `Attestation` locally before the document crosses a tool boundary. SHACL Core only; consumable by any conformant validator (pyshacl, Apache Jena, jouleclaw-shacl). |

## How it composes

The vocabulary subclasses W3C PROV-O where the alignment is exact:

- `arl:Evaluation ⊑ prov:Activity`
- `arl:Issuer / Holder` align with `prov:Agent` conceptually

A claim, session, or evaluation that carries
`@context: "https://arl.transaction.science/vocab/v1.jsonld"`
expands into typed RDF triples readable by any JSON-LD parser or
SPARQL store. The wire form is unchanged: existing ARL consumers
that ignore `@context` keep working.

The pattern mirrors `jouleclaw/vocab/v1` — see also the JouleClaw
vocab landing page for the third-generation-interop framing.

## Versioning

A future major bump publishes under `vocab/v2#`. v1 IRIs remain
resolvable forever per the open-standards "names are final" rule.

## Licence

CC-BY-4.0 (consistent with the ARL specification text).