Skip to content

Causal Context v1

Source schema: doc/schemas/causal-context.v1.schema.json

Portable host-derived causal metadata for one operation. It is evidence, not authority.

Governing Basis

Project Lineage

Fields

Field Required Shape Description
schema yes const: causal-context.v1
schema/v yes const: 1
context/id yes string
correlation/id yes string
operation/id yes string
parent/operation-id no string
causation/refs yes array
origin/actor-ref yes ref: #/$defs/ref
diagnostic/idempotency-digest no ref: #/$defs/sha256_digest
classification/ref no ref: #/$defs/ref
created/at yes string

Definitions

Definition Shape Description
ref string
sha256_digest string
## Field Semantics

schema

  • Required: yes
  • Shape: const: causal-context.v1

schema/v

  • Required: yes
  • Shape: const: 1

context/id

  • Required: yes
  • Shape: string

correlation/id

  • Required: yes
  • Shape: string

operation/id

  • Required: yes
  • Shape: string

parent/operation-id

  • Required: no
  • Shape: string

causation/refs

  • Required: yes
  • Shape: array

origin/actor-ref

  • Required: yes
  • Shape: ref: #/$defs/ref

diagnostic/idempotency-digest

  • Required: no
  • Shape: ref: #/$defs/sha256_digest

classification/ref

  • Required: no
  • Shape: ref: #/$defs/ref

created/at

  • Required: yes
  • Shape: string

Definition Semantics

$defs.ref

  • Shape: string

$defs.sha256_digest

  • Shape: string