Skip to content

v0.4.0

Choose a tag to compare

@Sannrox Sannrox released this 04 Oct 12:02
36c20ff

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

  1. Embedded / SQLite: run tenkaictl backup first. Install 0.4.0
    community hosts from the GitHub Release after verifying SHA256SUMS and
    the attestation, or cargo build --release --locked. Opening the existing
    store migrates SCHEMA_VERSION 11 → 12. tenkaictl --version reports
    tenkaictl 0.4.0. See release binaries.
  2. tenkai-server community host: the GitHub asset is built with
    --features ui and serves the pinned console at /ui/. See
    run tenkai-server and
    sign in with Keycloak.
  3. OIDC: set TENKAI_OIDC_CONFIG to a trust TOML file. That setting is
    exclusive with TENKAI_JWT_VERIFIER_CONFIG. Tenkai verifies access tokens
    as a resource server. See
    configure server authentication.
  4. Remote HTTP clients: regenerate types from
    tenkai-http-v1.schema.json on the GitHub Release. Unset optionals are
    omitted. Rejected management bearers return 401 with
    WWW-Authenticate; authenticated callers without access still return
    403. Environment inspect adds latest_plan.digest, maintenance, and
    constraints when the store has them.
  5. 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.
  6. Tenant-mode hub: keep --features postgres, TENKAI_POSTGRES_URL,
    management credentials, and JWT or OIDC trust. Non-loopback Postgres URLs
    require verified TLS (sslmode=disable fails closed before dialing). Hub
    Postgres hosts remain
    cargo build --release --locked --features postgres --bin tenkai-server.
  7. Spoke / community: leave TENKAI_POSTGRES_URL unset. 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 feature ui; 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 unauthenticated GET /v1/auth/oidc
    (#472, #478)
  • tenkaictl env retire plus 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_VERSION 11 → 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 LICENSE so GitHub detects the crate license (#460)

Fixed

  • Hub tenant Postgres requires verified TLS off loopback (#459)
  • TENKAI_DELIVERY_ADAPTER no 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.v1 response 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 alg only, kid required,
    signature before claims, issuer and audience match, HTTPS JWKS except
    loopback
  • Hub Postgres NoTls removed 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_VERSION 11 → 12 from tagged v0.3.2
  • Additive HTTP inspect and OIDC discovery fields; contract id stays
    tenkai.http.v1
  • Community tenkai-server GitHub hosts embed the console

Out of scope for 0.4.0

  • Advertising product high_availability capability
  • Catalog service extraction
  • Identity-plane DB co-location
  • Hub Postgres --features postgres GitHub 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