{"id":47819226,"url":"https://github.com/open-operational-state/status-spec","last_synced_at":"2026-04-03T19:02:09.543Z","repository":{"id":348788587,"uuid":"1199781751","full_name":"open-operational-state/status-spec","owner":"open-operational-state","description":"Core specification for the Open Operational State standard, including the canonical model, profiles, vocabularies, serializations, discovery, and adapters.","archived":false,"fork":false,"pushed_at":"2026-04-02T21:17:20.000Z","size":94,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-03T07:06:48.640Z","etag":null,"topics":["api-spec","interoperability","json","link-relations","observability","operational-state","service-health","service-status","specification","well-known"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/open-operational-state.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-02T17:47:18.000Z","updated_at":"2026-04-02T21:17:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/open-operational-state/status-spec","commit_stats":null,"previous_names":["open-operational-state/status-spec"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/open-operational-state/status-spec","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-operational-state%2Fstatus-spec","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-operational-state%2Fstatus-spec/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-operational-state%2Fstatus-spec/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-operational-state%2Fstatus-spec/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/open-operational-state","download_url":"https://codeload.github.com/open-operational-state/status-spec/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-operational-state%2Fstatus-spec/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31371647,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-03T17:53:18.093Z","status":"ssl_error","status_checked_at":"2026-04-03T17:53:17.617Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-spec","interoperability","json","link-relations","observability","operational-state","service-health","service-status","specification","well-known"],"created_at":"2026-04-03T19:02:08.535Z","updated_at":"2026-04-03T19:02:09.529Z","avatar_url":"https://github.com/open-operational-state.png","language":null,"readme":"# Status Spec\n\nThe technical specification for [Open Operational State](https://github.com/open-operational-state) — a vendor-neutral standard for machine-readable operational state of web services.\n\n## Overview\n\nToday, every framework and platform exposes operational state differently — Spring Boot, Kubernetes, custom health endpoints — with no shared model for what the values mean. This repository defines how web services communicate their operational condition — health, readiness, liveness, status — in a machine-readable, interoperable way. It provides a unifying semantic model for health check endpoints, readiness and liveness probes, and service status APIs, built around a six-layer extensible architecture.\n\n## Reading Guide\n\nStart here:\n\n1. **[ARCHITECTURE.md](ARCHITECTURE.md)** — the six-layer architecture that structures the entire standard\n2. **[NON_GOALS.md](NON_GOALS.md)** — what this standard explicitly is not\n3. **[PRIOR-ART.md](PRIOR-ART.md)** — influences and compatibility targets\n\nThen explore the specification documents:\n\n| Document | Layer | Description |\n|---|---|---|\n| [spec/core-model.md](spec/core-model.md) | Core Model | Stable, transport-agnostic semantics |\n| [spec/condition-vocabularies.md](spec/condition-vocabularies.md) | Core Model | Condition values per profile with ecosystem mappings |\n| [spec/profiles.md](spec/profiles.md) | Profiles | Domain-specific specializations (Liveness, Readiness, Health, Status) |\n| [spec/serializations.md](spec/serializations.md) | Serializations | Wire-level representation overview |\n| [spec/serializations/health-response.md](spec/serializations/health-response.md) | Serializations | `application/health+json` format |\n| [spec/serializations/service-status.md](spec/serializations/service-status.md) | Serializations | `application/status+json` format |\n| [spec/serializations/http-status-only.md](spec/serializations/http-status-only.md) | Serializations | Minimal HTTP-only serialization |\n| [spec/adapters.md](spec/adapters.md) | Adapters | Adapter specification framework |\n| [spec/adapters/plain-http.md](spec/adapters/plain-http.md) | Adapters | Plain HTTP status code adapter |\n| [spec/adapters/health-check-draft.md](spec/adapters/health-check-draft.md) | Adapters | draft-inadarei health check adapter |\n| [spec/discovery.md](spec/discovery.md) | Discovery | Locating operational-state resources |\n| [spec/capabilities.md](spec/capabilities.md) | Capabilities | Negotiation and feature advertisement |\n| [spec/security-considerations.md](spec/security-considerations.md) | Cross-cutting | Exposure guidance and security considerations |\n\n## Supporting Material\n\n| Directory | Purpose |\n|---|---|\n| [terminology/](terminology/) | Applied spec-level usage and context (authoritative glossary is in [governance](https://github.com/open-operational-state/governance/blob/main/GLOSSARY.md)) |\n| [design-notes/](design-notes/) | Design rationale and working notes |\n| [examples/](examples/) | Example payloads and scenarios |\n\n## Relationship to Existing Work\n\nOpen Operational State builds on prior work in machine-readable service health and status, including:\n\n- **[Health Check Response Format for HTTP APIs](https://datatracker.ietf.org/doc/draft-inadarei-api-health-check/)** (`draft-inadarei-api-health-check`) — a widely adopted format for HTTP API health checks\n- **[Service Status Resource Format for Web Services](https://datatracker.ietf.org/doc/draft-dallariva-web-service-status-json/)** (`draft-dallariva-web-service-status-json`) — a proposal for richer, structured service status resources\n\nThese approaches represent different models of expressing operational state. Concepts from both are commonly seen in production systems, such as health endpoints exposed by frameworks like [Spring Boot Actuator](https://docs.spring.io/spring-boot/reference/actuator/endpoints.html) and [readiness/liveness probes in Kubernetes](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/). This project provides a unifying architecture that allows these formats to be interpreted through a common model. See [PRIOR-ART.md](PRIOR-ART.md) for detailed analysis.\n\n## Related Repositories\n\n| Repository | Purpose |\n|---|---|\n| [governance](https://github.com/open-operational-state/governance) | Charter, governance model, authoritative glossary |\n| [status-conformance](https://github.com/open-operational-state/status-conformance) | Conformance definitions and test taxonomy |\n| [status-tooling](https://github.com/open-operational-state/status-tooling) | Vendor-neutral reference tooling |\n\n## Project Rules\n\nSee [PROJECT_RULES.md](PROJECT_RULES.md) for repo-specific constraints. This repository is **markdown only** — no code.\n\n## License\n\nThis repository is licensed under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). See [LICENSE](LICENSE).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopen-operational-state%2Fstatus-spec","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopen-operational-state%2Fstatus-spec","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopen-operational-state%2Fstatus-spec/lists"}