Repository navigation
Batten local runtime 0.1.0a1
Pre-releaseddx:
id: batten.runtime.release.0.1.0a1
type: release-notes
activity: deploy
authoring:
home: repo
links:
- id: ADR-016
kind: informed_by
- id: CONTRACT-012
kind: informed_by
- id: US-101
kind: informed_by
Batten local runtime 0.1.0a1
Release Scope
runtime-v0.1.0a1 is the first runnable local application prerelease: an approval
desk, a visual application registry and independently packaged runtime modules.
Release date: November 2, 2026. Batten maintainers own this GitHub release.
The existing design/site and storage releases retain their own tags.
Audience and Channels
| Audience | Available capability | Channel |
|---|---|---|
| App authors | Working native-table approval app and authored TypeScript UI | Source checkout and installed app wheel |
| Host integrators | Portable contracts/runtime/table port, optional native adapter, HTTP transport and local composition | Separate wheels on GitHub Releases |
| Contributors | Exact original platform cohort, qualification receipt and repeatable tests | Repository and release assets |
Highlights
- Open the local registry to choose an app with a description and visual preview.
The Batten brand returns to the registry. - Submit and edit requests, inspect their revisions, and independently approve
or reject them through original UMF/Weft on PostgreSQL 18. - Recover a lost mutation response using its original native receipt. Restarting
retains requests and receipts; local sessions require a new login.
Required Actions Summary
Use Python 3.11 and the recorded dependency cohort for this preview. Source
assembly also uses Bun 1.4.4 and uv. Explicitly initialize a new dedicated
fabricated database before serving. Run with loopback-only stub identities;
this is a local development profile.
Dependency audit: CI pins uv 0.13.6, Bun 1.4.4 and current compatible Python
tools. UMF access 0.1.0.dev8 and codegen 0.1.0a5 are the newest published
compatible original wheels; UMF 0.10.1 publishes umf-core but no replacement
access/codegen pair. weft-sql 0.4.54 is the newest published distribution;
Weft 0.4.56 publishes a separate umf-weft package. TypeScript 7.0.2 is the
newest compiler, but @typescript-eslint/parser 8.72.1 explicitly rejects it;
Batten uses the latest compatible TypeScript 6.0.3.
Changes and Fixes
New or Improved
The release adds novirhyza-batten-contracts, novirhyza-batten-runtime,
novirhyza-batten-tables, novirhyza-batten-umf-postgres,
novirhyza-batten-asgi, novirhyza-batten-local and
novirhyza-batten-approval-desk, all at 0.1.0a1.
Core contracts, runtime and the portable table port remain independent of native
providers. Original UMF SDK wheels accompany the cohort as upstream dependencies;
Batten does not carry a replacement ORM or compiler.
The registry uses explicit host-owned app metadata and packaged fabricated
thumbnails. Apps use distinct URL prefixes and API cookie paths. Host/origin
checks protect both the registry and app routes. Safe local audit and linked
OpenTelemetry spans preserve operation identity without logging request text,
SQL or connection details.
Fixes
Identity selection waits for app initialization, preventing fast registry
navigation from selecting an identity before its handlers are ready.
A separate app-only rebuild command speeds UI and hook iteration against the
already prepared platform cohort.
Breaking Changes and Required Actions
This is the first public local-runtime package release. For anyone using the
unreleased root-page demo, / is now the registry and the app is at
/apps/approval-desk/. Refresh the browser and establish a local session again.
The app's API routes and cookie path follow its URL prefix.
No database migration accompanies this release. Startup verifies the installed
model and schema head and refuses drift; it never creates roles or migrates tables.
Migration or Rollback Guidance
Upgrade or Migration
From the release source checkout:
uv sync --frozen --all-packages
bun install --frozen-lockfile
just approval-prepare
just approval-init
just approvalOpen http://127.0.0.1:8820/. Initialization refuses an existing data directory;
retain an existing matching demo workspace and run just approval to reopen it.
Use just approval-refresh after app-only edits, then restart the host.
Model changes require an explicitly initialized matching workspace.
The release includes separate wheels, the qualified cohort and constraints,
checksums, original upstream SDK dependencies and installation instructions.
Package assembly happens before runtime startup; serving does not install packages.
Rollback or Hold Guidance
Retain the release assets and matching application data/model together. Stop the
host before changing its installed environment. Restore the previous matching
cohort and app artifacts, then reopen the retained workspace. Hold an upgrade
when model/head verification or an affected native/browser assertion fails.
Known Issues and Support
Native execution is qualified for the recorded macOS arm64, Python 3.11 and
PostgreSQL 18 local cohort. Linux CI supplies its own exact result. Platform-neutral
wheel tags alone do not establish other native profiles. Local stub identity and
local span capture do not establish production login or OTLP receiver qualification.
The strict full-corpus conformance gate retains its separate requirements. Use
project-scoped ddx work items for integration work and the recorded app evidence
to assess this release's bounded claims. No PyPI publication is included.