Peer Status v1¶
Source schema: doc/schemas/peer-status.v1.schema.json
Operator-facing local read model for one peer's transport temperature, lifecycle, and quality-governor state.
Governing Basis¶
doc/project/40-proposals/014-node-transport-and-discovery-mvp.mddoc/project/50-requirements/requirements-006-node-networking-mvp.md
Project Lineage¶
Requirements¶
Stories¶
Fields¶
| Field | Required | Shape | Description |
|---|---|---|---|
schema |
yes |
const: peer-status.v1 |
|
node_id |
yes |
string | |
display_name |
yes |
string | null | |
selected_endpoint_url |
yes |
string | null | |
temperature |
yes |
enum: cold, warm, hot, blocked |
|
lifecycle |
yes |
enum: idle, dialing, connected, cooldown, blocked |
|
quality_status |
yes |
enum: healthy, degraded, capability_limited, cooling_down, benchlisted, blocked |
|
score |
yes |
integer | |
supported_capabilities |
yes |
array | |
missing_capabilities |
yes |
array | Currently missing capabilities according to the latest known transcript or verification result. |
capability_missing_count |
yes |
integer | Current count of missing capabilities; it is not a lifetime accumulator. |
failure_count |
yes |
integer | Current consecutive transport failure count since the last successful session establishment or quality unblock. |
replay_incidents |
yes |
integer | |
cooldown_remaining_ms |
yes |
integer | null | |
blocked_remaining_ms |
yes |
integer | null | |
last_failure_reason |
yes |
string | null | |
| ## Field Semantics |
schema¶
- Required:
yes - Shape: const:
peer-status.v1
node_id¶
- Required:
yes - Shape: string
display_name¶
- Required:
yes - Shape: string | null
selected_endpoint_url¶
- Required:
yes - Shape: string | null
temperature¶
- Required:
yes - Shape: enum:
cold,warm,hot,blocked
lifecycle¶
- Required:
yes - Shape: enum:
idle,dialing,connected,cooldown,blocked
quality_status¶
- Required:
yes - Shape: enum:
healthy,degraded,capability_limited,cooling_down,benchlisted,blocked
score¶
- Required:
yes - Shape: integer
supported_capabilities¶
- Required:
yes - Shape: array
missing_capabilities¶
- Required:
yes - Shape: array
Currently missing capabilities according to the latest known transcript or verification result.
capability_missing_count¶
- Required:
yes - Shape: integer
Current count of missing capabilities; it is not a lifetime accumulator.
failure_count¶
- Required:
yes - Shape: integer
Current consecutive transport failure count since the last successful session establishment or quality unblock.
replay_incidents¶
- Required:
yes - Shape: integer
cooldown_remaining_ms¶
- Required:
yes - Shape: integer | null
blocked_remaining_ms¶
- Required:
yes - Shape: integer | null
last_failure_reason¶
- Required:
yes - Shape: string | null