Skip to content

v0.4.1

Choose a tag to compare

@Sannrox Sannrox released this 05 Oct 18:45
bf0f835

Release notes: v0.4.1

Crate version: 0.4.1. Tag: v0.4.1.

Pair with release readiness. Contributor credits
belong on the GitHub Release generated notes.

Scope

Pre-1.0 patch on published GitHub release
v0.4.0. Operators get
the hub tenkai-server-postgres GitHub asset, --ui-dir symlink refuse, and
bind-before-legacy-import so /healthz answers while a large store opens.

Base: tag v0.4.0 (36c20ff). Open release-blocking issues at crate-bump
time: none. Follow-up #511 stays open.

Compatibility and migration

Surface Impact for 0.4.1
Crate version 0.4.0 → 0.4.1
SQLite SCHEMA_VERSION Remains 12. No migration
Hub Postgres schema Remains 12
Runtime / auth / federated / model / plan / provider contracts Documented *_CONTRACT_VERSION / PLAN_FORMAT_VERSION remain 1
HTTP contract Id stays tenkai.http.v1
Optional Postgres hub Same feature and TENKAI_POSTGRES_URL; GitHub Release now attaches tenkai-server-postgres-<platform>
Spoke / CLI embedded Still refuse TENKAI_POSTGRES_URL (ADR 0029)
GitHub Release assets Community hosts built with --features ui plus hub tenkai-server-postgres-<platform> (--features postgres,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: install 0.4.1 community hosts from the GitHub
    Release after verifying SHA256SUMS and the attestation, or
    cargo build --release --locked. No store migration. tenkaictl --version
    reports tenkaictl 0.4.1. See release binaries.
  2. tenkai-server community host: still built with --features ui and
    serves the pinned console at /ui/. --ui-dir refuses symlinks that leave
    the console root. See
    run tenkai-server.
  3. Tenant-mode hub: this is the first published tag that attaches
    tenkai-server-postgres-<platform> (--features postgres,ui). Verify
    checksum and attestation the same way as community hosts. Keep
    TENKAI_POSTGRES_URL, management credentials, JWT or OIDC trust, and
    --tenant-mode. Non-loopback Postgres URLs still require verified TLS.
    Source build remains valid:
    cargo build --release --locked --features postgres --bin tenkai-server.
  4. Spoke / community: leave TENKAI_POSTGRES_URL unset. That refuse is
    unchanged.
  5. Large legacy stores: tenkai-server binds first and answers /healthz
    while import runs. /readyz returns 503 until the store is open. Graph
    import commits in batches and resumes after a restart.

Rollback

Previous 0.4.0 binary plus the existing Tenkai-owned SQLite (embedded) or
Postgres (hub) store. No schema change in this patch. Recovery never depends
on sekai-chisei.

User-visible changes

Added

  • GitHub Release attaches hub tenkai-server-postgres-<platform> built with
    --features postgres,ui for linux-x86_64 and darwin-aarch64, next to
    the five community --features ui hosts (#514)

Fixed

  • tenkai-server binds the listener and serves /healthz before legacy
    graph import; /readyz returns 503 until the store is open (#516)
  • Legacy graph import commits in batches and resumes after a readiness
    restart (#516)

Security

  • --ui-dir /ui file map refuses symlinks that would leave the console
    root (#515)

Migration

  • None. SCHEMA_VERSION remains 12. HTTP contract id stays tenkai.http.v1.

Out of scope for 0.4.1

  • Advertising product high_availability capability
  • Catalog service extraction
  • Identity-plane DB co-location
  • Extra platforms or crates.io
  • Rewriting docs/releases/0.4.0.md
  • #511 (export operation-bound feedback observations)

What's Changed

  • feat(ops): attach postgres,ui hub tenkai-server release asset by @Sannrox in #517
  • fix(server): refuse --ui-dir symlinks outside the console root by @Sannrox in #518
  • fix(server): bind listener before legacy store import by @Sannrox in #519
  • chore: prepare 0.4.1 crate bump and release notes by @Sannrox in #521

Full Changelog: v0.4.0...v0.4.1