Repository navigation
v0.4.0
Release notes: v0.4.0
Crate version: 0.4.0. Tag: v0.4.0.
Pair with release readiness. Contributor credits
belong on the GitHub Release generated notes.
Scope
Pre-1.0 minor on published GitHub release
v0.3.2. Operators get
the pinned web console, OIDC access-token authentication, environment
retirement, the published tenkai.http.v1 contract, and fail-closed hub
Postgres TLS.
Base: tag v0.3.2 (7733d05). Open release-blocking issues at crate-bump
time: none. Follow-up #511 stays open.
Compatibility and migration
| Surface | Impact for 0.4.0 |
|---|---|
| Crate version | 0.3.2 → 0.4.0 |
SQLite SCHEMA_VERSION |
11 → 12. Opening an existing store migrates automatically (environments.retired_at plus an active-row index). Newer DBs fail closed |
| Hub Postgres schema | Same 11 → 12 retired_at migration |
| Runtime / auth / federated / model / plan / provider contracts | Documented *_CONTRACT_VERSION / PLAN_FORMAT_VERSION remain 1 |
| HTTP contract | Id stays tenkai.http.v1. Additive inspect and OIDC discovery fields. Unset response optionals are omitted |
| Optional Postgres hub | Same feature and TENKAI_POSTGRES_URL; non-loopback hosts require verified TLS |
| Spoke / CLI embedded | Still refuse TENKAI_POSTGRES_URL (ADR 0029) |
| GitHub Release assets | Community hosts built with --features ui for linux-x86_64 and darwin-aarch64, plus tenkai-http-v1.schema.json, SHA256SUMS, and GitHub artifact attestations |
| 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. Install0.4.0
community hosts from the GitHub Release after verifyingSHA256SUMSand
the attestation, orcargo build --release --locked. Opening the existing
store migratesSCHEMA_VERSION11 → 12.tenkaictl --versionreports
tenkaictl 0.4.0. See release binaries. tenkai-servercommunity host: the GitHub asset is built with
--features uiand serves the pinned console at/ui/. See
run tenkai-server and
sign in with Keycloak.- OIDC: set
TENKAI_OIDC_CONFIGto a trust TOML file. That setting is
exclusive withTENKAI_JWT_VERIFIER_CONFIG. Tenkai verifies access tokens
as a resource server. See
configure server authentication. - Remote HTTP clients: regenerate types from
tenkai-http-v1.schema.jsonon the GitHub Release. Unset optionals are
omitted. Rejected management bearers return 401 with
WWW-Authenticate; authenticated callers without access still return
403. Environment inspect addslatest_plan.digest,maintenance, and
constraintswhen the store has them. - Environment-bound management: OIDC rules with
environment = …and
environment-scoped tokens may call reconcile and package-migration apply /
resume / rollback only for that environment. Fleet-wide reconcile stays
with unbound management credentials. - Tenant-mode hub: keep
--features postgres,TENKAI_POSTGRES_URL,
management credentials, and JWT or OIDC trust. Non-loopback Postgres URLs
require verified TLS (sslmode=disablefails closed before dialing). Hub
Postgres hosts remain
cargo build --release --locked --features postgres --bin tenkai-server. - Spoke / community: leave
TENKAI_POSTGRES_URLunset. That refuse is
unchanged.
Rollback
Previous 0.3.2 binary plus restore of the pre-upgrade Tenkai-owned SQLite
(embedded) or Postgres (hub) store, then re-inject tokens from the secret
store. A migrated 0.4.0 store is SCHEMA_VERSION 12; 0.3.2 fails closed on
newer schemas. Recovery never depends on sekai-chisei.
User-visible changes
Added
- Pinned web console at
/ui/behind Cargo featureui; community GitHub
hosts enable that feature (ADR 0031; #467, #470, #496, #501, #502) - OIDC access-token verification with claim-to-grant mapping, JWKS
discovery or static keys, and unauthenticatedGET /v1/auth/oidc
(#472, #478) tenkaictl env retireplus HTTP retire; retired environments stay out of
active list, fleet, reconcile, and runtime polling (#456, #462)- Published HTTP API contract
api/tenkai-http-v1.schema.json
(tenkai.http.v1), attached to the GitHub Release (#473) - Environment inspect includes
latest_plan.digest, maintenance windows, and
constraints (#480, #481) - GitHub artifact attestations for Release hosts, the HTTP contract, and
SHA256SUMS, with tag→commit verify before upload (#453)
Changed
- SQLite and hub Postgres
SCHEMA_VERSION11 → 12: indexed
environments.retired_at, backfilled from existing retirement evidence
(#456, #462) - Docs entry funnel, Diátaxis index, and DESIGN.md as the current
architecture explanation (#461, #484, #485, #487, #489, #494) - Apache-2.0
LICENSEso GitHub detects the crate license (#460)
Fixed
- Hub tenant Postgres requires verified TLS off loopback (#459)
TENKAI_DELIVERY_ADAPTERno longer substitutes fake delivery adapters
during apply or reconcile (#492)- Environment-bound management stays inside reconcile and package migrations
(#479) - Rejected management bearer tokens return 401 with
WWW-Authenticate
(#506) - Nested console routes resolve assets from a relative
<base>(#501) - Legacy graph import streams rows so multi-GiB stores reach
/readyz
(#507) tenkai.http.v1response optionals omit unset fields (#509)- Postgres tenant client worker reuse; static
/ui/file map; nested/ui
shell cache (#452, #508, #510)
Security
- OIDC verification fails closed: configured
algonly,kidrequired,
signature before claims, issuer and audience match, HTTPS JWKS except
loopback - Hub Postgres
NoTlsremoved for non-loopback URLs (#459) - Fake in-memory delivery adapters cannot be selected from the process
environment (#492) - Environment-bound credentials cannot call fleet-wide reconcile or act on
another environment (#479) - Release upload attests assets and refuses a moved tag (#453)
Migration
- SQLite and hub Postgres
SCHEMA_VERSION11 → 12 from taggedv0.3.2 - Additive HTTP inspect and OIDC discovery fields; contract id stays
tenkai.http.v1 - Community
tenkai-serverGitHub hosts embed the console
Out of scope for 0.4.0
- Advertising product
high_availabilitycapability - Catalog service extraction
- Identity-plane DB co-location
- Hub Postgres
--features postgresGitHub assets - #511 (export operation-bound feedback observations)
What's Changed
- perf(postgres): reuse tenant client worker by @Sannrox in #452
- fix(release): attest binaries and verify tag target by @Sannrox in #453
- feat(environment): retire environments by @Sannrox in #456
- fix(postgres): require verified TLS for non-loopback hub Postgres by @Sannrox in #459
- docs: add Apache-2.0 LICENSE so GitHub detects the crate license by @Sannrox in #460
- docs: open the README with problem, audience, comparison, and a five-minute try by @Sannrox in #461
- perf(storage): filter retired environments in SQL via an indexed retired_at column by @Sannrox in #462
- docs(decisions): ADR 0031 web console as a separate, pinned client by @Sannrox in #467
- docs(decisions): amend ADR 0031 for OIDC sign-in and existing reads by @Sannrox in #470
- feat(auth): accept OIDC access tokens with claim-to-grant mapping by @Sannrox in #472
- feat(api): publish the HTTP API contract as versioned JSON Schema by @Sannrox in #473
- feat(auth): serve an organisation display name for the console sign-in by @Sannrox in #478
- fix(auth): confine environment-bound management to reconcile and migrations by @Sannrox in #479
- feat(api): include the plan digest in environment inspect by @Sannrox in #480
- feat(api): expose maintenance windows and constraints in environment inspect by @Sannrox in #481
- docs: correct operator-doc drift before the Diátaxis restructure by @Sannrox in #484
- docs: organize the docs index by reader need and check links in validate by @Sannrox in #485
- docs: slim the root README into an entry funnel and move its content into docs/ by @Sannrox in #487
- docs: make DESIGN.md the current architecture explanation and move founding-era planning to a history page by @Sannrox in #489
- fix(apply): stop selecting fake delivery adapters from TENKAI_DELIVERY_ADAPTER by @Sannrox in #492
- docs: split server authentication setup out of the request-context reference into a how-to by @Sannrox in #494
- test: stop library tests from mutating the process environment by @Sannrox in #495
- feat(server): serve the pinned console bundle under /ui behind a ui feature by @Sannrox in #496
- fix(server): give nested console routes a relative base so assets resolve by @Sannrox in #501
- docs: tutorial for signing in to the web console through Keycloak by @Sannrox in #502
- fix(server): return 401, not 403, when a management bearer token is rejected by @Sannrox in #506
- fix(storage): stream the legacy graph import so large stores open in flat memory by @Sannrox in #507
- perf(server): serve embedded /ui files from a static map without copying by @Sannrox in #508
- fix(server): publish omit-only response optionals without null in tenkai.http.v1 by @Sannrox in #509
- perf(server): cache the nested /ui shell per depth and find in place by @Sannrox in #510
- chore: prepare 0.4.0 crate bump and release notes by @Sannrox in #513
Full Changelog: v0.3.2...v0.4.0