@pmatrix/field-node-runtime

P-MATRIX 4.0 Field Node Runtime — State Vector exchange, peer verification, local decision and enforcement for CLI Monitor integration.

Internal dependency — automatically installed with @pmatrix/openclaw-monitor, @pmatrix/claude-code-monitor, @pmatrix/cursor-monitor, @pmatrix/gemini-cli-monitor.

Architecture

4-Stage Chain

1. Exchange — Peer-to-peer State Vector sharing via WebSocket
2. Verify — Policy digest, freshness, integrity, risk sanity
3. Decide — Posture determination (maintain/caution/restrict/reject)
4. PEP — Policy Enforcement Point (callback-only, non-executive)

State Vector (5 elements)

• risk_info — R(t) + 4-axis breakdown
• lifecycle_info — loop count, current mode
• freshness_evidence — timestamp, TTL
• integrity_evidence — SHA-256 signature
• policy_digest — sha256:<hex> policy hash

R(t) Formula

R(t) = 1 - (BASELINE + NORM + (1 - STABILITY) + META_CONTROL) / 4

stability is inverted: higher stability = more drift = higher risk

Modules

| Module | Purpose | |--------|---------| | state-vector-builder | SV construction + R(t) computation | | local-verifier | Peer SV verification | | local-decider | Posture determination | | local-pep | Callback-based policy enforcement | | audit-emitter | Append-only audit events | | peer-exchange-client | WS peer exchange | | field-guard | 4.0 activation guard | | file-adapter | IPC file adapter |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | PMATRIX_FIELD_ID | Yes (4.0) | Field identifier | | PMATRIX_FIELD_NODE_ID | Yes (4.0) | Node identifier | | PMATRIX_FIELD_WS_URL | No | WS endpoint override |

Both PMATRIX_FIELD_ID and PMATRIX_FIELD_NODE_ID must be set to activate 4.0 mode.

License

Apache-2.0 — see LICENSE