Skip to content

Instantly share code, notes, and snippets.

@odiseusme
odiseusme / spec.md
Last active May 15, 2026 20:03
Ergo Node Doctor — spec draft v0.3

Ergo Node Doctor — Spec

Status: Draft v0.4 (offline rule correction) Date: 2026-05-15 Phase: Specify

Changelog

  • v0.4 — Corrected offline classification rule: process-absent is now required (not just API + log-quiet). Prevents misclassifying long legitimate recoveries as dead nodes.
  • v0.3 — Broadened from Rust-only to any Ergo node implementation via an adapter pattern. Added bottleneck classification as a Core Behavior (round-1 reviewer flag, restored). Noted peer-address anomaly tracking as v1.1+ (surfaced during early adopter conversations). Added explicit roadmap. v1 ships with the Rust adapter; Scala adapter in v1.1.
  • v0.2 — Local-agent architecture, state classifier with precedence, diagnostic bundle, replay mode, CLI access, security defaults.