Compatibility and Roadmap

Compatibility and Roadmap

Source of truth: docs/compatibility.md and docs/roadmap.md

Verified matrix

• Runtime: Bun 1.4.x (pinned oracle: 1.4.0) on Linux x86-64, macOS arm64, Windows x64 — per-OS CI runs the full suite on 1.4.0 and 1.4.x.
• TypeScript: 7.0.2 verified; declarations ship as direct .ts sources (no .d.ts fork).
• Validators: Zod 4.4.3 and Valibot 1.4.2 in CI; any Standard Schema v1 validator works. JSON Schema documentation in OpenAPI and Scalar is feature-detected per validator.
• Browsers: the prebuilt lugas/client/browser artifact is verified in a same-origin real-browser lane (Chrome via CDP); real browsers are not part of the per-OS CI matrix.

Known beta limitations: server core and CLI are Bun-only (the client is runtime-neutral); in-flight handler work is not cancelled on client disconnect (except SSE streams, whose cancellation is pinned — see Server-Sent Events).

Feature status

Features marked post-beta are on main after the v0.1.0-beta.1 candidate was attested; they ship in the next release candidate. See Home for the full table.

Battery	ADR	Evidence
CORS	ADR-0022	docs/reports/issues/M8-001.md
Server-Sent Events	ADR-0023	docs/reports/issues/M8-002.md
Structured logging	ADR-0024	docs/reports/issues/M8-003.md
OpenAPI 3.1 + Scalar	ADR-0025	docs/reports/issues/M8-004.md

Planned

• Drizzle ORM adapter — the last planned first-party battery: optional, application-owned Drizzle instance exposed through typed guard/service context; no hidden connections, no implicit migrations; Lugas does not become an ORM framework.

Integration defaults (as shipped)

Capability	Default
CORS	Disabled unless configured
SSE	Available per route
Access logging	Off unless configured (explicit production policy)
OpenAPI document	Explicitly enabled when configured
Scalar UI	Opt-in; production exposure is an explicit choice
Drizzle	Never initialized implicitly

Release status

v0.1.0-beta.1 is attested (tarball bound to a pinned commit, SHA256SUMS verified in a clean clone) but publication is an owner-controlled action and has not happened. A fresh release candidate through the release gate is planned to fold in the post-beta batteries.