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

• doc/normative/50-constitutional-ops/EMERGENCY-ACTIVATION-CRITERIA.md
• doc/project/20-memos/emergency-signal-v1-invariants.md

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.