open-standards/joule-code/vocab/v1.jsonld
David Charlot b838b86a8b joule-code: stand up the Joule Code standard (v0.1.0 draft)
Joule Code is the coding cargo class of the substrate: a coding operation —
an edit, refactor, or generated function — is a content-addressed, signed
transition over a source tree, resolved through the energy-tiered cascade
(L0 Cache → L1 Lawful → L2 Embed → L3 Model → L4 Wire, stop-at-first-close)
with a signed JWP receipt (measured + estimated µJ, honest Provenance) per
operation. The agent schema is JouleClaw; L4 frontier agents are reached over
ACP with the credential held by the vendor's own client — no protocol token,
no required contact with any single company.

Stands up the standard to the family schema:
- README, SPEC.md (RFC-2119 normative), dual licence (Apache-2.0 code /
  CC-BY-4.0 spec), ROADMAP, CONTRIBUTING, CHANGELOG.
- spec/: cargo (the coding-operation type), cascade (the tier binding),
  receipt (the JWP energy record), collab (federated, interface-level/Research).
- vocab/LEXICON.md.
- conformance/v1/: C1 content-addressing, C2 signing, C3 receipt, C4 cascade
  vectors + VERSIONS + regeneration; real Ed25519 RFC-8032 KATs, derived
  fields regenerated against the reference library.
- joule-code-rs/: lean reference library (schema, cargo, receipt, cascade,
  conformance). cargo test --workspace passes; the conformance harness runs
  11 pass / 0 fail / 7 skip (derived fields pending regeneration).

Single-endpoint operation is the v0.1 surface; federated collaboration is
specified at interface level and classified Research. Registers the standard
in the family README.

Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-06-02 14:07:00 -04:00

46 lines
2 KiB
Text

{
"@context": {
"@version": 1.1,
"jcd": "https://joulecode.transaction.science/vocab/v1#",
"xsd": "http://www.w3.org/2001/XMLSchema#",
"prov": "http://www.w3.org/ns/prov#",
"Receipt": "jcd:Receipt",
"Transition": "jcd:Transition",
"SourceTree": "jcd:SourceTree",
"Cascade": "jcd:Cascade",
"Agent": "jcd:Agent",
"Edit": "jcd:Edit",
"Refactor": "jcd:Refactor",
"Generate": "jcd:Generate",
"tier_closed": { "@id": "jcd:tierClosed", "@type": "@vocab" },
"joules_measured_uj": { "@id": "jcd:joulesMeasuredUj", "@type": "xsd:nonNegativeInteger" },
"joules_estimated_uj": { "@id": "jcd:joulesEstimatedUj","@type": "xsd:nonNegativeInteger" },
"energy_provenance": { "@id": "jcd:energyProvenance", "@type": "@vocab" },
"operation": { "@id": "jcd:operation", "@type": "@vocab" },
"source_before_hash": { "@id": "jcd:sourceBeforeHash", "@type": "xsd:string" },
"source_after_hash": { "@id": "jcd:sourceAfterHash", "@type": "xsd:string" },
"agent_id": { "@id": "jcd:agentId", "@type": "xsd:string" },
"agent_vendor": { "@id": "jcd:agentVendor", "@type": "@vocab" },
"acp_endpoint": { "@id": "jcd:acpEndpoint", "@type": "@id" },
"credential_holder": { "@id": "jcd:credentialHolder", "@type": "xsd:string" },
"closed_at": { "@id": "jcd:closedAt", "@type": "xsd:dateTime" },
"schema_id": { "@id": "jcd:schemaId", "@type": "xsd:string" },
"L0Cache": "jcd:L0Cache",
"L1Lawful": "jcd:L1Lawful",
"L2Embed": "jcd:L2Embed",
"L3Model": "jcd:L3Model",
"L4Wire": "jcd:L4Wire",
"HwShunt": "jcd:HwShunt",
"ModelBased": "jcd:ModelBased",
"Estimator": "jcd:Estimator",
"ClaudeCode": "jcd:ClaudeCode",
"Gemini": "jcd:Gemini",
"Codex": "jcd:Codex",
"Generic": "jcd:GenericAgent"
}
}