# Joule Code vocabulary (v1)

Stable IRIs for the Joule Code open standard — the coding cargo
class of the substrate. Covers the JWP receipt (with two-part
measured + estimated joules and honest provenance), the L0–L4
cascade tiers shared with JouleClaw, the operation taxonomy
(Edit / Refactor / Generate), and the agent-vendor enumeration
for the Agent Client Protocol binding (Claude Code / Gemini /
Codex / Generic).

Namespace: `https://joulecode.transaction.science/vocab/v1#`
(prefix `jcd:` by convention).

| File | Format | What |
|------|--------|------|
| [`v1.jsonld`](v1.jsonld) | JSON-LD `@context` | Term → IRI mapping. |
| [`v1.ttl`](v1.ttl) | Turtle (RDF) | Classes, enumerations, properties; subclasses `prov:Activity` for `Transition`, `prov:Entity` for `SourceTree`, `prov:Agent` for `Agent`. |
| [`v1.shapes.ttl`](v1.shapes.ttl) | SHACL Core | Shape graph — validates `Receipt`, `Transition`, `Agent` locally before they enter the receipt stream. SHACL Core only; consumable by any conformant validator. |

A Joule Code receipt that carries
`@context: "https://joulecode.transaction.science/vocab/v1.jsonld"`
expands into typed RDF triples for any JSON-LD or SPARQL consumer
without changing its wire form. Mirrors the pattern shipped at
`jouleclaw/vocab/v1`. Licence CC-BY-4.0 for the spec text;
reference implementation Apache-2.0.