Generated from
registry/support/v1.jsonbyscripts/generate_reference_docs.py. Do not edit this page directly.
Release 0.18.0 has alpha maturity. Production readiness is false.
A target profile states the intended support boundary. Maturity and readiness state what is available now. Gates and blockers state what must pass before release.
generated/compatibility-surface.json is the checked inventory that the ADR 0053 decision 7 exit criteria require for the blessed_core profile: CLI command paths and parameters from blessed_core packages, /api/v1 methods and paths plus /health, phlo.__all__, the covered entry-point groups and the entry points that blessed_core packages declare in them, hook event types and the envelope version, and the configuration and run-evidence schema versions. It excludes surfaces that decision 2 does not cover, such as legacy HTTP families, non-blessed_core packages, and underscore-prefixed names.
The file does not record every covered detail. HTTP schemas, status codes and authorisation actions, the CLI JSON envelope and exit status, plugin base classes, capability specifications, service.yaml, project layout, and the support manifest shape remain governed by their decision 2 sources of truth, so an unchanged inventory does not show that those are unchanged.
Run make docs-reference-generate to regenerate it with the other references. make docs-reference-check, which make check and the CI Python lane run, fails when the file is stale. Review a diff to this file as a change to a covered surface under ADR 0053 decision 4; during the decision 6 feature freeze, an addition also needs the recorded exception that decision 6 requires.
- Release maturity:
alpha. The schema permitsalphaandsupported.supportedis permitted only together with production readinesstrue. In a production-ready release,blessed_corecomponents with target statussupportedmay also report current maturitysupported. - Production readiness:
false.trueis permitted only when every required gate (security,run_evidence,maintenance,upgrade_restore,golden_path) ispassedand everyblessed_coregate component ispassedornot_required(ADR 0053). A gate component isnot_requiredonly when no gate applies to it, and it still needs checked evidence. - Production status:
blocked. It isblockeduntil those gates pass, thenrequired_before_releasewhile production readiness isfalse, andpassedonce production readiness istrue. - Artifact pinning:
not_yet_published. The schema permitsnot_yet_publishedandpublished;publishedrecords that the release set's artifacts are published and pinned by the release BOM (ADR 0050). - Release version: a
current_release.versionat or above1.0.0is rejected unless production readiness istrue. Following PEP 440 ordering, pre-releases and dev releases of 1.0.0, such as1.0.0rc1, sort below1.0.0and are permitted.1.0.0.post1and pre-releases of later versions, such as1.1.0rc1, are not.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,run_evidence,upgrade_restore,golden_path. - Blockers:
security,run_evidence,upgrade_restore,golden_path.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,run_evidence,upgrade_restore,golden_path. - Blockers:
security,run_evidence,upgrade_restore,golden_path.
- Target profile:
blessed_core; target status:required. - Current maturity:
planned; readiness:blocked. - Applicable gates:
golden_path. - Blockers:
golden_path.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,run_evidence,maintenance,upgrade_restore,golden_path. - Blockers:
security,run_evidence,maintenance,upgrade_restore,golden_path.
- Target profile:
blessed_core; target status:required. - Current maturity:
planned; readiness:blocked. - Applicable gates:
security,maintenance,upgrade_restore,golden_path. - Blockers:
security,maintenance,upgrade_restore,golden_path.
- Target profile:
blessed_core; target status:required. - Current maturity:
blocked; readiness:blocked. - Applicable gates:
security,golden_path. - Blockers:
security,golden_path.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,run_evidence,maintenance,upgrade_restore,golden_path. - Blockers:
security,run_evidence,maintenance,upgrade_restore,golden_path.
- Target profile:
blessed_core; target status:required. - Current maturity:
planned; readiness:blocked. - Applicable gates:
security,run_evidence,golden_path. - Blockers:
security,run_evidence,golden_path.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,run_evidence,upgrade_restore,golden_path. - Blockers:
security,run_evidence,upgrade_restore,golden_path.
- Target profile:
blessed_core; target status:required. - Current maturity:
blocked; readiness:blocked. - Applicable gates:
security. - Blockers:
security.
- Target profile:
blessed_core; target status:required. - Current maturity:
planned; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path. - Blockers:
security,upgrade_restore,golden_path.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,maintenance. - Blockers:
security,upgrade_restore,golden_path,maintenance.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
optional; target status:supported. - Current maturity:
alpha; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
optional; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,run_evidence,maintenance. - Blockers:
security,upgrade_restore,golden_path,run_evidence,maintenance.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
optional; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path. - Blockers:
security,upgrade_restore,golden_path.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,run_evidence,maintenance. - Blockers:
security,upgrade_restore,golden_path,run_evidence,maintenance.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,run_evidence. - Blockers:
security,upgrade_restore,golden_path,run_evidence.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,run_evidence. - Blockers:
security,upgrade_restore,golden_path,run_evidence.
- Target profile:
optional; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
optional; target status:supported. - Current maturity:
alpha; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,run_evidence,maintenance. - Blockers:
security,upgrade_restore,golden_path,run_evidence,maintenance.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
optional; target status:supported. - Current maturity:
alpha; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
optional; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,maintenance. - Blockers:
security,upgrade_restore,golden_path,maintenance.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,run_evidence,maintenance. - Blockers:
security,upgrade_restore,golden_path,run_evidence,maintenance.
- Target profile:
optional; target status:supported. - Current maturity:
alpha; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,run_evidence. - Blockers:
security,upgrade_restore,golden_path,run_evidence.
- Target profile:
outside_v1; target status:development_only. - Current maturity:
development_only; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,run_evidence. - Blockers:
security,upgrade_restore,golden_path,run_evidence.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
optional; target status:supported. - Current maturity:
alpha; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,run_evidence. - Blockers:
security,upgrade_restore,golden_path,run_evidence.
- Target profile:
outside_v1; target status:development_only. - Current maturity:
development_only; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,run_evidence,maintenance. - Blockers:
security,upgrade_restore,golden_path,run_evidence,maintenance.
- Target profile:
optional; target status:supported. - Current maturity:
alpha; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
optional; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
optional; target status:supported. - Current maturity:
alpha; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
outside_v1; target status:development_only. - Current maturity:
development_only; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
optional; target status:supported. - Current maturity:
alpha; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
outside_v1; target status:development_only. - Current maturity:
development_only; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,run_evidence,maintenance. - Blockers:
security,upgrade_restore,golden_path,run_evidence,maintenance.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
optional; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
optional; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
optional; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,run_evidence,maintenance. - Blockers:
security,upgrade_restore,golden_path,run_evidence,maintenance.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,run_evidence,maintenance. - Blockers:
security,upgrade_restore,golden_path,run_evidence,maintenance.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,run_evidence,maintenance. - Blockers:
security,upgrade_restore,golden_path,run_evidence,maintenance.
- Target profile:
optional; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
optional; target status:supported. - Current maturity:
alpha; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
optional; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
optional; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,maintenance. - Blockers:
security,upgrade_restore,golden_path,maintenance.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,maintenance. - Blockers:
security,upgrade_restore,golden_path,maintenance.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,maintenance. - Blockers:
security,upgrade_restore,golden_path,maintenance.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,run_evidence,maintenance. - Blockers:
security,upgrade_restore,golden_path,run_evidence,maintenance.
- Target profile:
optional; target status:supported. - Current maturity:
alpha; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,run_evidence,maintenance. - Blockers:
security,upgrade_restore,golden_path,run_evidence,maintenance.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
outside_v1; target status:development_only. - Current maturity:
development_only; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,run_evidence,maintenance. - Blockers:
security,upgrade_restore,golden_path,run_evidence,maintenance.
- Target profile:
optional; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
optional; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,run_evidence,maintenance. - Blockers:
security,upgrade_restore,golden_path,run_evidence,maintenance.
- Target profile:
optional; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,maintenance. - Blockers:
security,upgrade_restore,golden_path,maintenance.
- Target profile:
optional; target status:supported. - Current maturity:
alpha; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
optional; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
optional; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
outside_v1; target status:preview. - Current maturity:
preview; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
optional; target status:supported. - Current maturity:
alpha; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
optional; target status:supported. - Current maturity:
alpha; readiness:not gated. - Applicable gates: none.
- Blockers: none.
- Target profile:
blessed_core; target status:supported. - Current maturity:
alpha; readiness:blocked. - Applicable gates:
security,upgrade_restore,golden_path,run_evidence,maintenance. - Blockers:
security,upgrade_restore,golden_path,run_evidence,maintenance.