Sensorium Web Refresh Status v1

Source schema: doc/schemas/sensorium-web-refresh-status.v1.schema.json

Fields

Field	Required	Shape	Description
schema	yes	const: sensorium-web-refresh-status.v1
schema/v	yes	const: 1
operation/id	yes	ref: #/$defs/ref
source/ref	yes	ref: #/$defs/ref
source/generation-ref	yes	ref: #/$defs/ref
status	yes	enum: pending, running, terminal
outcome	yes	enum: pending, changed, no-change, refused, failed, unknown, cancelled
attempt	yes	integer
started/at	yes	string
completed/at	no	string
request/digest	yes	ref: #/$defs/digest
snapshot/id	no	ref: #/$defs/ref
snapshot/digest	no	ref: #/$defs/digest
observation/id	no	ref: #/$defs/ref
failure/code	no	enum: source-not-found, source-superseded, refresh-in-progress, cache-evidence-missing, cache-binding-mismatch, artifact-binding-mismatch, receipt-binding-mismatch, broker-unavailable, fetch-not-completed, extraction-refused, observation-rejected, storage-failed, interrupted, cancelled
failure/phase	no	enum: claim, fetch, extract, retain, observe, commit, fence, recovery, cancel
receipt/refs	no	array
retry/class	no	enum: terminal, retryable, policy-dependent

Definitions

Definition	Shape	Description
digest	string
ref	string

Conditional Rules

Rule 1

When:

{
  "properties": {
    "status": {
      "const": "terminal"
    }
  },
  "required": [
    "status"
  ]
}

Then:

{
  "required": [
    "completed/at"
  ]
}

Rule 2

When:

{
  "properties": {
    "outcome": {
      "enum": [
        "changed",
        "no-change"
      ]
    }
  },
  "required": [
    "outcome"
  ]
}

Then:

{
  "required": [
    "snapshot/id",
    "snapshot/digest",
    "observation/id"
  ]
}

Field Semantics

schema

• Required: yes
• Shape: const: sensorium-web-refresh-status.v1

schema/v

• Required: yes
• Shape: const: 1

operation/id

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

source/ref

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

source/generation-ref

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

status

• Required: yes
• Shape: enum: pending, running, terminal

outcome

• Required: yes
• Shape: enum: pending, changed, no-change, refused, failed, unknown, cancelled

attempt

• Required: yes
• Shape: integer

started/at

• Required: yes
• Shape: string

completed/at

• Required: no
• Shape: string

request/digest

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

snapshot/id

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

snapshot/digest

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

observation/id

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

failure/code

• Required: no
• Shape: enum: source-not-found, source-superseded, refresh-in-progress, cache-evidence-missing, cache-binding-mismatch, artifact-binding-mismatch, receipt-binding-mismatch, broker-unavailable, fetch-not-completed, extraction-refused, observation-rejected, storage-failed, interrupted, cancelled

failure/phase

• Required: no
• Shape: enum: claim, fetch, extract, retain, observe, commit, fence, recovery, cancel

receipt/refs

• Required: no
• Shape: array

retry/class

• Required: no
• Shape: enum: terminal, retryable, policy-dependent

Definition Semantics

$defs.digest

• Shape: string

$defs.ref

• Shape: string