Przejdź do treści

Emergency Signal v1

Source schema: doc/schemas/emergency-signal.v1.schema.json

Machine-readable schema for one emergency-ingest fact entering the crisis evaluation pipeline. This contract models a reporting signal, not an activation decision. It stays below emergency-activation.v1 and above raw connector telemetry.

Governing Basis

Project Lineage

Fields

Field Required Shape Description
schema/v yes const: 1 Schema version.
signal/id yes string Stable identifier of the emergency signal.
source/node-id yes string Canonical identity of the reporting node.
source/type yes enum: sensorium, operator, peer_report, oracle Source class of the emergency signal.
observed/at yes string Timestamp when the signal was observed or emitted.
trigger/class yes enum: TC1, TC2, TC3, TC4, TC5 Emergency trigger class from EMERGENCY-ACTIVATION-CRITERIA.
description yes string Human-readable summary of the observed condition.
evidence/ref yes string Reference to auditable evidence backing the signal.
confidence/class yes enum: C0, C1, C2, C3, C4 Credibility class of the observed signal.
corroborating/signal-refs yes array References to other signals that corroborate the current one.
tc5/active yes boolean Whether degraded-trust mode is active for this signal.
metadata/geo-hint no string Optional coarse location hint.
metadata/affected-scope yes enum: node, federation, inter-federation Operational scope affected by the reported condition.
metadata/urgency yes enum: immediate, hours, days Expected time pressure of the condition.
notes no string Optional human-readable notes.

Conditional Rules

Rule 1

When:

{
  "properties": {
    "trigger/class": {
      "const": "TC5"
    }
  },
  "required": [
    "trigger/class"
  ]
}

Then:

{
  "properties": {
    "tc5/active": {
      "const": true
    }
  }
}

Rule 2

When:

{
  "properties": {
    "tc5/active": {
      "const": true
    }
  },
  "required": [
    "tc5/active"
  ]
}

Then:

{
  "properties": {
    "trigger/class": {
      "const": "TC5"
    }
  }
}

Field Semantics

schema/v

  • Required: yes
  • Shape: const: 1

Schema version.

signal/id

  • Required: yes
  • Shape: string

Stable identifier of the emergency signal.

source/node-id

  • Required: yes
  • Shape: string

Canonical identity of the reporting node.

source/type

  • Required: yes
  • Shape: enum: sensorium, operator, peer_report, oracle

Source class of the emergency signal.

observed/at

  • Required: yes
  • Shape: string

Timestamp when the signal was observed or emitted.

trigger/class

  • Required: yes
  • Shape: enum: TC1, TC2, TC3, TC4, TC5

Emergency trigger class from EMERGENCY-ACTIVATION-CRITERIA.

description

  • Required: yes
  • Shape: string

Human-readable summary of the observed condition.

evidence/ref

  • Required: yes
  • Shape: string

Reference to auditable evidence backing the signal.

confidence/class

  • Required: yes
  • Shape: enum: C0, C1, C2, C3, C4

Credibility class of the observed signal.

corroborating/signal-refs

  • Required: yes
  • Shape: array

References to other signals that corroborate the current one.

tc5/active

  • Required: yes
  • Shape: boolean

Whether degraded-trust mode is active for this signal.

metadata/geo-hint

  • Required: no
  • Shape: string

Optional coarse location hint.

metadata/affected-scope

  • Required: yes
  • Shape: enum: node, federation, inter-federation

Operational scope affected by the reported condition.

metadata/urgency

  • Required: yes
  • Shape: enum: immediate, hours, days

Expected time pressure of the condition.

notes

  • Required: no
  • Shape: string

Optional human-readable notes.