Repository navigation
v0.3.0
Release notes: v0.3.0
Crate version: 0.3.0. Tag: v0.3.0.
Pair with release readiness. Contributor credits follow in What's Changed.
Scope
Pre-1.0 minor covering remote management lifecycle, preview environments,
governed package migrations, digest-bound catalog artifacts, fleet fairness
and release waves, same-version remediations, and the operator surfaces that
landed on main after published GitHub release
v0.2.0.
Base: tag v0.2.0 (1cddbe0, 2026-07-26). That tag is not an ancestor of
current main after the later history rewrite; these notes use the published
GitHub release as the operator baseline.
Open release-blocking issues at crate-bump time: none.
Compatibility and migration
| Surface | Impact for 0.3 |
|---|---|
| Crate version | 0.2.0 → 0.3.0 |
SQLite SCHEMA_VERSION |
Tagged v0.2.0 is 6; 0.3 opens as 11. Opening an existing community DB migrates automatically. Newer DBs fail closed |
| Runtime / auth / federated / model / plan / provider contracts | Documented *_CONTRACT_VERSION / PLAN_FORMAT_VERSION remain 1 |
| Management lifecycle | Additive tenkai.management-lifecycle.v1 (MANAGEMENT_LIFECYCLE_API_VERSION = 1) |
| HTTP runtime JSON | Unknown fields fail closed |
| Optional Postgres hub | Feature postgres; TENKAI_POSTGRES_URL; schema-per-tenant; not the community default |
| Multi-replica | --replica-count > 1 requires store shared_replica_state; durable tick fence when Postgres is configured |
high_availability capability |
Still not claimed; the flag remains fail-closed without it |
| Toolchain | rust-version = "1.96.1" |
| Defaults | Signing/approval fail closed; tenant mode / enterprise flags default off |
Operator upgrade notes
- Embedded / SQLite: run
tenkaictl backupfirst. Install 0.3.0 binaries
and open the existing.tenkai-statedatabase. The store migrates
SCHEMA_VERSION6 → 11 (provider-outbox indexing, observation-time
selection, typed hub/spoke records). Community remains single-writer. - Remote HTTP clients: requests that send unknown JSON fields now fail
closed. Development bypass flags (--allow-unsigned-development,
--allow-unapproved-development) stay embedded-only; a remote request
that carries a bypass field is rejected. - Remote catalog and plan verbs: authenticated management-lifecycle
routes cover publish, promote, subscribe, recall, plan, approve, apply,
and rollback. See management lifecycle and
ADR 0030. Runtime
tokens cannot call those operations. - Optional provider hosts: vendored Sekai/Chisei contracts moved to the
1.0 façade (#211, #213). Pin a compatible sekai-chisei revision.
Tenkai remains recoverable without the provider unless policy requires
its evidence. - Optional multi-tenant hub: enable
postgres, set
TENKAI_POSTGRES_URL, follow
postgres-tenant-store.md. Do not
co-locate IdP databases. - Multi-replica hubs: follow
multi-replica-hub-runbook.md. Prefer
one active writer plus a shared durable fence; do not share community
SQLite files.
Rollback
Previous binary plus restore of the pre-upgrade Tenkai-owned SQLite backup
(embedded) or Postgres pg_restore (hub), then re-inject tokens from the
secret store. Recovery never depends on sekai-chisei.
User-visible changes
Added
- Versioned remote management lifecycle: catalog publish / promote /
subscribe / recall and plan / approve / apply / rollback
(management lifecycle; #393–#398) - Preview environments from a content-addressed branch pin
(preview environments; #399) - Governed package migrations, including remote parity
(package migrations; #312, #358) - Digest-bound OCI artifact refs and digest-bound layers in signed offline
bundles (#386, #387) - Kubernetes server-side apply; live worker-pool replacement from
lifecycle observations (#389, #372) - Durable release waves; fleet fairness isolation; thousand-environment
workload (#293, #304, #302) - Same-version remediations; change-set closure pins; independent prompt
packages and Workshop modules (#282, #294, #296, #311) - Connectivity-class upgrades; fixed-replica Shikigami worker pools
(#297, #295) - External delivery adapters that leave operational authority with Tenkai
(#308) - Bounded recovery diagnostic bundle; allowlisted OTLP traces keyed by
operation identity (#370, #391) - Versioned machine-readable CLI results; bounded terminal outcome
inspection and export (#171, #200, #205) - Observation host binary
tenkai-worker-lifecycle-fixture
Changed
- HTTP JSON bodies reject unknown fields (#434)
- Client façade and gate evidence use the Sekai 1.0 / evaluation-projection
contracts (#211–#213) - Module splits under the 300-line threshold preserve public contracts
Fixed
- Plan index poison, retarget, no-op persistence, preview teardown, tenant
fleet join, and Postgres-in-Tokio fail-closed paths (#175–#176,
#317–#404)
Security
- JWT delivery RBAC and deploy-environment scrubbing (#268)
- Software-executor diagnostic URI userinfo redaction (#278)
- Management capability required for promotion and canary repair (#273,
#275) - Executable dependency pinning (#196)
- Fail-closed signing, plan approval, tenant non-disclosure, and capability
gates preserved - Remote management rejects development-bypass fields
Migration
- SQLite
SCHEMA_VERSION6 → 11 from taggedv0.2.0 - Additive remote management-lifecycle routes; community embedded path
remains the default
Out of scope for 0.3
- Advertising product
high_availabilitycapability - Catalog service extraction
- Identity-plane DB co-location
What's Changed
- feat(ops): GitHub verified GraphQL PR push by @Sannrox in #158
- chore(skills): add portable technical-documentation and refactor-docs by @Sannrox in #159
- feat(server): wire enterprise JWT authentication by @Sannrox in #161
- Add authenticated tenant fixture import for development by @Sannrox in #164
- Expose tenant fixture projections through read APIs by @Sannrox in #166
- feat(server): expose safe latest-plan summaries by @Sannrox in #168
- feat(cli): emit versioned machine-readable delivery results by @Sannrox in #171
- fix(server): avoid nested Tokio runtime during PostgreSQL startup by @Sannrox in #175
- Fix PostgreSQL tenant requests inside Tokio runtime by @Sannrox in #176
- feat(catalog): admit immutable release provenance by @Sannrox in #177
- fix(server): scope tenant reconcile effects by @Sannrox in #179
- docs: add Tenkai operator skill by @Sannrox in #181
- test(runtime): prove fenced delivery effects across replicas by @Sannrox in #182
- test(runtime): expose callable fenced-delivery conformance adapter by @Sannrox in #184
- fix(server): include tenant store in readiness by @Sannrox in #186
- docs(catalog): assess staged product consolidation by @Sannrox in #191
- docs(planner): assess rollout control simplification by @Sannrox in #192
- docs(ops): record embedded golden-path evidence by @Sannrox in #193
- docs: define supported operating profiles by @Sannrox in #194
- fix(security): pin executable dependencies by @Sannrox in #196
- docs(ops): distinguish Postgres hub lab from supported profiles by @Sannrox in #199
- feat(integration): export terminal deployment outcomes by @Sannrox in #200
- docs(ops): align provider-outbox availability by @Sannrox in #203
- docs(architecture): define Shikigami worker-pool ownership by @Sannrox in #204
- feat: expose bounded terminal outcome inspection by @Sannrox in #205
- refactor(integration): centralize terminal-outcome projection by @Sannrox in #210
- fix(client): migrate to Sekai 1.0 contract by @Sannrox in #211
- fix(gate): migrate to evaluation evidence projection by @Sannrox in #212
- feat(client): adopt versioned sekai facade by @Sannrox in #213
- build: add deterministic make workflows by @Sannrox in #214
- docs: clarify crate architecture seams by @Sannrox in #216
- refactor(executor): centralize verified atomic state-file writes by @Sannrox in #217
- refactor(executor): centralize staged product kind mapping by @Sannrox in #218
- refactor(plan): extract pure fleet posture module by @Sannrox in #219
- refactor(execution): centralize terminal outcome classification by @Sannrox in #220
- refactor(execution): centralize product lifecycle dispatch by @Sannrox in #222
- refactor(trust): centralize Ed25519 verification by @Sannrox in #224
- refactor(trust): complete Ed25519 verification seam by @Sannrox in #226
- refactor(trust): deepen shared signed-format primitives by @Sannrox in #227
- refactor(trust): route JWT verification through shared Ed25519 seam by @Sannrox in #228
- refactor(server): deepen tenant environment operations by @Sannrox in #229
- refactor(server): deepen runtime delivery operations by @Sannrox in #231
- refactor(canary): deepen promotion lifecycle by @Sannrox in #232
- refactor(executor): deepen fenced mutation supervision by @Sannrox in #233
- refactor(providers): deepen durable event lifecycle by @Sannrox in #234
- refactor(environment): deepen lifecycle and readback module by @Sannrox in #236
- refactor(apply): deepen plan execution attempts by @Sannrox in #237
- refactor(environment): deepen deployment observation by @Sannrox in #238
- refactor(plan): deepen release selection by @Sannrox in #239
- refactor(apply): deepen environment execution leasing by @Sannrox in #240
- refactor(runtime): deepen completion lifecycle by @Sannrox in #241
- refactor(apply): deepen release execution admission by @Sannrox in #242
- refactor(reconciler): deepen environment lifecycle by @Sannrox in #243
- refactor(server): deepen management operations by @Sannrox in #244
- refactor(catalog): deepen release publication admission by @Sannrox in #246
- refactor(apply): deepen plan step lifecycle by @Sannrox in #247
- refactor(canary): deepen attempt lifecycle by @Sannrox in #248
- refactor(apply): deepen plan start admission by @Sannrox in #249
- refactor(apply): deepen plan execution completion by @Sannrox in #250
- refactor(apply): deepen plan execution admission by @Sannrox in #252
- refactor(plan): deepen lifecycle persistence by @Sannrox in #254
- refactor(canary): deepen promotion policy lifecycle by @Sannrox in #255
- refactor(apply): deepen step outcome semantics by @Sannrox in #256
- chore(deps): refresh compatible lockfile versions by @Sannrox in #257
- refactor(providers): deepen event delivery lifecycle by @Sannrox in #258
- refactor(product): deepen kind policy by @Sannrox in #259
- test(client): prove object lifecycle parity by @Sannrox in #260
- refactor(client): deepen object lifecycle by @Sannrox in #261
- test(client): prove relation lifecycle parity by @Sannrox in #262
- refactor(client): deepen relation lifecycle by @Sannrox in #263
- refactor(client): deepen lease lifecycle by @Sannrox in #264
- refactor(client): deepen action lifecycle by @Sannrox in #265
- refactor(plan): deepen convergence by @Sannrox in #266
- fix: close lease fencing and plan admission holes by @Sannrox in #267
- fix(security): scrub deploy env and enforce JWT delivery RBAC by @Sannrox in #268
- fix(client): migrate remote actions off CreateActionType (Critical B) by @Sannrox in #269
- refactor(catalog): deepen release trust lookup by @Sannrox in #270
- refactor(canary): deepen promotion evaluation by @Sannrox in #271
- perf(canary): scope evaluate_active catalog loads by @Sannrox in #272
- fix(catalog): require Management capability for promotion by @Sannrox in #273
- fix(canary): require Management capability for attempt repair by @Sannrox in #275
- refactor(reconciler): deepen tick admission by @Sannrox in #274
- perf(reconciler): skip full environment list_kind on unchanged ticks by @Sannrox in #276
- refactor(software-executor): deepen host selection and diagnostics by @Sannrox in #277
- fix(software-executor): redact URI userinfo and kubeconfig diagnostics by @Sannrox in #278
- fix(software-executor): keep required diagnostic text after #278 by @Sannrox in #279
- feat(planner): own bounded same-version remediations by @Sannrox in #282
- feat(fleet): execute durable release waves by @Sannrox in #293
- feat(catalog): bind releases to accepted change-set closures by @Sannrox in #294
- feat(edge): reconcile fixed-replica Shikigami worker pools by @Sannrox in #295
- feat(catalog): deliver versioned prompt packages by @Sannrox in #296
- feat(runtime): reconcile upgrades across connectivity classes by @Sannrox in #297
- fix(runtime): fail closed under-replicated pools and unverified isolated archives by @Sannrox in #298
- feat(fleet): generate a deterministic thousand-environment workload by @Sannrox in #302
- feat(fleet): measure thousand-environment reconcile budgets by @Sannrox in #303
- feat(fleet): isolate failing environments without starving the fleet by @Sannrox in #304
- fix(fleet): prove fairness progress, backoff, and fail-closed restore by @Sannrox in #305
- fix(fleet): bind fairness receipts to healthy behind plans by @Sannrox in #306
- docs(profile): define portable delivery-manifest ownership by @Sannrox in #307
- feat(integration): bridge external delivery without ceding authority by @Sannrox in #308
- fix(apply): admit delivery adapters before delegation by @Sannrox in #309
- test(apply): prove adapter timeout on the apply path by @Sannrox in #310
- feat(catalog): deliver signed Workshop modules independently by @Sannrox in #311
- feat(migration): plan governed package migrations by @Sannrox in #312
- fix(fleet): compute status without inspecting every environment by @Sannrox in #314
- fix(plan): stop persisting no-op reconcile plans by @Sannrox in #317
- fix(plan): fail closed on created_at index drift by @Sannrox in #324
- docs(adr): accept remote plan listing IO residual by @Sannrox in #326
- fix(plan): index has_steps for pending work selection by @Sannrox in #327
- fix(ops): run embedded SQLite off Tokio workers by @Sannrox in #328
- fix(plan): distinguish no-op success from applied delivery by @Sannrox in #329
- fix(plan): fail closed on depressed newest created_at index by @Sannrox in #330
- test(delivery): rehearse signed stateful upgrades with executor crash recovery by @Sannrox in #339
- fix(plan): inspect latest without full-history plan decode by @Sannrox in #340
- fix(plan): decode environment plans on the blocking pool by @Sannrox in #342
- fix(reconciler): admit executable plans without decoding empty history by @Sannrox in #341
- fix(plan): fail closed on environment and status index poison by @Sannrox in #344
- fix(reconciler): admit executable plans in oldest-first batches by @Sannrox in #345
- perf(plan): check environment indexes once per reconcile tick by @Sannrox in #350
- perf(reconciler): fetch remote admission candidates once by @Sannrox in #351
- fix(plan): detect remote environment-index retarget by @Sannrox in #352
- fix(plan): require has_steps index on stored plans by @Sannrox in #353
- perf(reconciler): share remote retarget kind-list per tick by @Sannrox in #355
- docs: record remote package-migration parity (ADR 0026) by @Sannrox in #356
- feat(server): expose package-migration lifecycle over remote management by @Sannrox in #358
- fix(plan): fail closed when shared retarget snapshot is omitted by @Sannrox in #359
- test: prove one signed closure across two environments by @Sannrox in #364
- fix(tenant): stop joining fleet status by bare environment name by @Sannrox in #366
- fix(tenant): partition package-migration catalog by caller by @Sannrox in #367
- perf(plan): index shared retarget omit ids once per tick by @Sannrox in #368
- fix(server): materialize remote migration approvals off Tokio by @Sannrox in #369
- feat(cli): export a bounded recovery diagnostic bundle by @Sannrox in #370
- feat(executor): drive worker replacement from live lifecycle observations by @Sannrox in #372
- docs(storage): accept hub PostgreSQL and spoke SQLite on one port by @Sannrox in #383
- feat(catalog): bind and verify digest-bound OCI artifact refs by @Sannrox in #386
- feat(catalog): carry digest-bound layers in signed offline bundles by @Sannrox in #387
- test(ops): rehearse fifty isolated offline upgrades and rollback by @Sannrox in #388
- feat(executor): apply Kubernetes manifests with server-side apply by @Sannrox in #389
- feat(ops): emit allowlisted OTLP traces keyed by operation identity by @Sannrox in #391
- refactor(storage): drive embedded planning through typed records by @Sannrox in #392
- feat(protocol): record the versioned remote management lifecycle contract by @Sannrox in #396
- feat(server): expose remote catalog publish, promote, subscribe, and recall by @Sannrox in #397
- feat(server): expose remote plan, approve, apply, and rollback by @Sannrox in #398
- docs: claim delivery lanes on GitHub for cross-machine agents by @Sannrox in #390
- chore: reclaim stale docs, comments, and exact-copy helpers by @Sannrox in #402
- feat(environment): provision preview environments from a branch pin by @Sannrox in #399
- fix(reconciler): treat torn-down previews as terminal Current by @Sannrox in #403
- fix(plan): fail closed on expired or torn-down preview mutation by @Sannrox in #404
- fix(test): wait for mutation count before crash-recovery snapshot by @Sannrox in #405
- chore: finish leftover garbage-collect reclamations by @Sannrox in #406
- docs: separate HTTP runtime JSON from the v1 proto contract by @Sannrox in #408
- refactor: share opaque-id and schema-kind admission helpers by @Sannrox in #410
- docs: keep private environment off public PRs by @Sannrox in #411
- refactor: share unique-conflict admission and CLI approval flags by @Sannrox in #413
- refactor: share remaining exact-copy helpers after #412 by @Sannrox in #415
- chore: reclaim remaining garbage-collect marks after #415 by @Sannrox in #417
- refactor: split tenkaictl into modules under the 300-line threshold by @Sannrox in #420
- chore: reclaim leftover lane-capacity garbage-collect marks after #417 by @Sannrox in #421
- refactor: split server into modules under the 300-line threshold by @Sannrox in #425
- refactor: split postgres_tenant into modules under the 300-line threshold by @Sannrox in #423
- refactor: split client façade into modules under the 300-line threshold by @Sannrox in #427
- refactor: split package_migration into modules under the 300-line threshold by @Sannrox in #430
- docs: align product and governance docs with the live tree by @Sannrox in #431
- fix(runtime): reject unknown fields in HTTP JSON bodies by @Sannrox in #434
- refactor(storage): split storage.rs into modules under 300 lines by @Sannrox in #435
- chore: prepare 0.3.0 crate bump and release notes by @Sannrox in #437
Full Changelog: v0.2.0...v0.3.0