Skip to content

v0.8.0

Choose a tag to compare

@github-actions github-actions released this 11 Nov 21:39
· 91 commits to main since this release
Immutable release. Only release title and notes can be modified.
v0.8.0
0be6b03

Gate flags: breaking, migration

Products run as named instances that depend on
each other through declared contracts (ADR 0043, ADR 0044). The environment
runtime runs the built-in executors, delivers sealed secrets (ADR 0045), and
issues and rotates workload certificates with peer grants from dependency
bindings (ADR 0046). Operators sign in through host identity on a Unix socket
(ADR 0047), unsubscribed instances are removed by an approved plan
(ADR 0049), and a channel head can be removed on its own. The server
serves web console
v0.3.1
at /ui/. The release candidate v0.8.0-rc.1 published its signed
hosts, SBOM and attestations. Since then only the sekai-keys dependency
moved to the sekai-chisei v2.0.0 tag, with identical code (#1189). Full operator
notes: docs/releases/0.8.0.md.

What's Changed

  • chore(keys): pin sekai-keys to the sekai-chisei v2.0.0 tag (#1189)
  • chore(release): prepare v0.8.0-rc.1 with console v0.3.1 (#1179)
  • ci: retry apt installs on runner DNS failures (#1185)
  • feat(catalog)!: remove a product's head from one channel (#1177)
  • feat(catalog): promote returns the release digest and accepts an expected head (#1176)
  • feat(http): operation results tolerate unknown fields so responses can grow (#1175)
  • feat(identity)!: remove the replaced identity issuer once no workload depends on it (#1171)
  • feat(identity)!: host trust bundles carry issuers an approved rotation plan proves (#1170)
  • feat(identity)!: wait for every instance to take up the next issuer (#1169)
  • feat(identity)!: add the next identity issuer to every trust bundle (#1168)
  • feat(status)!: show workload certificates near expiry and report renewals (#1167)
  • refactor(keys): ship the key-provider adapters and customer-key release as a library crate (#1166)
  • feat(executor): renew restart-reload certificates with a rolling restart (#1165)
  • feat(planner)!: peer grants from dependency bindings in the dependency document (#1164)
  • feat(host-applier): renew host workload certificates without approval (#1163)
  • feat(runtime): renew workload certificates on the runtime without approval (#1162)
  • feat(executor): refuse identity plans in an environment without a separate runtime (#1161)
  • refactor(apply)!: the catalog lease is the only environment execution claim (#1160)
  • feat(executor)!: issue workload certificates at apply and deliver them to the target (#1159)
  • refactor(reconcile)!: drop the reconcile tick fence (#1157)
  • refactor(ha)!: spoke standby leases and receipts in the operational store (#1156)
  • feat(executor)!: environment identity issuer created by an approved step (#1155)
  • refactor(canary): fence promotion locks with the generic lease (#1150)
  • docs(decisions): accept ADR 0046 workload identity and peer policy (#1154)
  • feat(planner)!: remove unsubscribed instances of built-in executors by an approved plan (#1153)
  • refactor(trust)!: one trust-roots type and one approval envelope for every signed format (#1152)
  • feat(cli)!: remote apply returns per-step outcomes (#1149)
  • feat(secrets)!: recover sealed values with an offline recovery key (#1148)
  • feat(trust)!: a production profile refuses file signing keys (#1147)
  • docs(adr): secrets generated by the runtime on first install (ADR 0050) (#1145)
  • fix(executor): runtime completions write the environment under its lease (#1144)
  • docs(adr): remove instances of built-in executors by an approved plan (ADR 0049) (#1143)
  • feat(trust): a hardware signing key per artifact family (#1142)
  • refactor(trust)!: route every signing site through ContentSigner, one key per family (#1141)
  • feat(executor)!: approved re-wrap of sealed values for new runtimes (#1140)
  • feat(runtime): open sealed values with a hardware-backed sealing key (#1134)
  • feat(runtime)!: run host removal steps on a built-in runtime (#1133)
  • feat(executor)!: write sealed secrets to host targets through the runtime's applier (#1131)
  • feat(runtime)!: run host releases through the runtime's local applier (#1129)
  • feat(runtime)!: write sealed secrets to helm targets from the environment runtime (#1126)
  • feat(runtime)!: run the built-in executors in the environment runtime (#1124)
  • docs(adr): the environment runtime runs the built-in executors (#1120)
  • feat(executor)!: record a structured cause for failed and rolled back attempts (#1118)
  • refactor: route single-file state writes through atomic_state (#1117)
  • feat(cli)!: set, list and delete sealed secrets and plan their changes (#1116)
  • feat(cli)!: show deployment attempt history with failure detail (#1115)
  • feat(executor)!: report out-of-band target changes as drift without acting (#1114)
  • feat(catalog)!: admit overlays against a signed release config schema (#1113)
  • feat(ops)!: support bundle carries workload state for in-cluster releases (#1107)
  • feat(feedback)!: post captured observations to opt-in webhooks (#1106)
  • contract(feedback)!: publish observation schema and evidence type (#1105)
  • contract(feedback)!: export operation_id, observed_at_ms, and scope (#1104)
  • feat(executor)!: verify sealed steps against a runtime-local approval policy (#1103)
  • feat(executor)!: runtime sealing keys and client recipient pins (#1099)
  • feat(planner)!: bind a dependent instance to one provider of a shared contract (#1098)
  • docs(decisions): close renewal, issuer and server-host gaps in ADR 0046 (#1069)
  • docs(decisions): accept ADR 0043 and ADR 0044 (#1056)
  • docs(decisions): accept ADR 0045 sealed secrets (#1053)
  • docs(decisions): harden ADR 0045 against a compromised server (#1046)
  • feat(executor)!: derive deploy names from the product instance (#1045)
  • feat(planner)!: key an environment's deployed releases by instance (#1044)
  • feat(cli): allow a hosts-only bundle for self-upgrade (#1043)
  • feat(catalog): refuse a train whose members do not satisfy each other's requirements (#1042)
  • feat(cli): show dependency holds and providers in status (#1041)
  • feat(executor): dependency document for dependents, re-rendered when providers change (#1040)
  • feat(planner): refuse plans that leave an installed dependent unsatisfied (#1039)
  • feat(planner): hold unmet required contracts on reconcile (#1038)
  • feat(planner): order plans by declared contract dependencies (#1037)
  • feat(planner): satisfy requirements from deployed releases (#1036)
  • feat(ops)!: host identity on a Unix socket (#1035)
  • feat(catalog): compatibility profile v2 with optional requirements and 0.y matching (#1033)
  • docs(decisions): ADR 0047 host identity as the default operator sign-in (#1032)
  • feat(ops): qualify hub HA with a two-replica drill (#1030)
  • docs(release): family releases dispatch from main and cut -rc.N first (#1029)
  • ci(release): dispatch binaries from main and accept -rc.N (#1027)
  • docs(decisions): ADR 0046 workload identity and peer policy from dependency bindings (#1024)
  • perf(apply): skip 2h lease heartbeats and prune catalog history (#1026)
  • docs(decisions): ADR 0045 sealed secrets delivered by the environment runtime (#1021)
  • perf(catalog): migrate each PG tenant schema once per stamp (#1022)
  • fix(cli)!: send declared deploy inputs with remote publish (#1018)
  • docs(decisions): ADR 0043 product dependencies and ADR 0044 instances and bindings (#1012)
  • feat(cli): load client config so a server host finds its server (#1002)
  • chore: expose shared agent skills to Claude Code (#1001)

Upgrade

  • Web console: ui/console.pin moves from v0.2.0 to v0.3.1. The console reads the new instance, drift, history, identity and apply-step fields when the server returns them, and still requires tenkai.http.v1 on /healthz.
  • Install 0.8.0 hosts from the GitHub Release after verifying SHA256SUMS and the attestation, or with install.sh. tenkaictl --version reports tenkaictl 0.8.0. Upgrade every server, runtime and host applier before using any new manifest, step or secret feature below; older binaries refuse those shapes and fail closed.
  • Store migration (#1044): the SQLite operational store moves from schema 13 to 14, keyed by instance. The first 0.8.0 start writes a verified pre-migration copy beside the store, or refuses to start. Older binaries refuse the migrated store. Postgres hubs run additive tenant DDL (stamp 3, #1099) once per tenant schema.
  • Instances (#1044, #1045): existing records stay the default instance of their product. env subscribe --instance and HTTP instance are optional and default to the product. Unlabeled pre-upgrade objects belong to the default instance.
  • Unsubscribe (#1153): env unsubscribe needs --version (expected_version) while a release is recorded for the instance, and the next approved plan removes a non-host instance. Helm removals need Helm 3.13 or later.
  • Manifests: declare [deploy.identity] (#1159) or [config] (#1113) only after every server and runtime runs 0.8.0. Older servers refuse them.
  • Sealed secrets (#1099, #1103, #1116, #1131, #1148): set TENKAI_RUNTIME_APPROVAL_POLICY on each runtime before the first tenkaictl secret set, and set the first sealed value only after every server is upgraded. Host targets need the applier spool on tmpfs and swap off or encrypted.
  • Workload identity (#1155, #1159, #1164, #1168 to #1171): the server sends issuer, rotation and peer-grant plans only to runtimes that advertise the matching capability; older runtimes stay idle on them. After upgrade the first plan re-renders certificate holders once. Until it runs, rollbacks and restarts of a caller of a certified provider are refused.
  • Host identity (#1035): install writes host-grants.toml, creates the tenkai-viewer, tenkai-operator and tenkai-admin groups and the /run/tenkai socket directory. TCP still requires a bearer or assertion.
  • Spoke standby (#1156): tenkaictl spoke-standby promote takes --environment, --state is the restored SQLite store, and every member passes the same --lease-dir. spoke-standby.json is no longer read.
  • Reconcile fence (#1157): replicas no longer use tenkai_reconcile_tick_claims. Drop the table once every replica runs 0.8.0.
  • Feedback (#1104 to #1106): TENKAI_FEEDBACK_PROVIDER_REGISTRATION must attest evidence_type=tenkai.feedback_observation;schema=tenkai.feedback_observation.v1@1.0.0. Keep feedback.observation@1.0.0 on the plane until no older replica remains.
  • HTTP clients (#1175): operation results accept unknown fields. A client from before 0.8.0 still refuses a result field it does not know.
  • Rust API: every ! change above alters public library types or signatures; see each pull request's Breaking section. Wire formats stay additive unless noted.
  • Rollback to 0.7.1: stop the server, restore the pre-migration copy of the store, and start 0.7.1. Changes made after the upgrade are lost. Runtimes and appliers roll back with their server.