All Projects

Open Operational State

A vendor-neutral specification and tooling ecosystem for machine-readable operational health and status of web services. Includes schema definitions, conformance tooling, validators, interoperability guidance, CLI tooling, and reference implementations.

Active — open source

Problem

Modern services expose operational health information inconsistently across status pages, APIs, monitoring systems, and infrastructure tooling. Existing approaches are primarily human-readable and lack a standardized interoperability model for machine-readable operational state.

Solution

Designed a vendor-neutral operational state specification with supporting schema definitions, validation tooling, conformance models, interoperability guidance, and reference implementations. Built an accompanying tooling ecosystem including validators, CLI utilities, fixtures, and automated conformance workflows.

Role

Principal architect and specification author

Technologies

TypeScriptNode.jsCLI ToolingHTTP StandardsJSON SchemaGitHub Actions

Impact

  • Published vendor-neutral specification and interoperability model for operational state reporting
  • Built schema definitions, validation tooling, fixtures, and automated conformance workflows
  • Designed interoperability approach for representing operational state consistently across systems and vendors
  • Established foundation for ecosystem tooling, adapters, and machine-readable operational integrations
  • Open-sourced governance, tooling, and reference implementations through public GitHub repositories