Release notes
This documentation describes the frozen scope of the v0.0.18 experimental prerelease. Actual publication and downloadable assets are recorded in GitHub Releases.
v0.0.18 release scope and known limits
Section titled “v0.0.18 release scope and known limits”This release freezes already implemented and verified functionality. It remains an experimental prerelease, not a production-readiness claim. The v0.0.18 Release is the authority for actual publication, assets and checksums; a skipped publishing job is not release evidence.
- JSON keeps the previous implementation as its default.
json.encode/json.decodeshare thestringify/parseentry points. The float round-trip correction for1e20is included; yyjson replacement and performance exploration have ended. - Task/native async support remains the documented bounded subset. Shutdown admission and cleanup fixes do not imply a complete M:N runtime or universal network suspension.
- HTTP uses bounded socket readiness, queues and response handling, with keep-alive support and optional bounded diagnostic records. These changes do not imply that all workload acceptance has passed.
ku supervisecontrols whole-program workers, admission, queue bytes, output and cleanup. It is not one worker per HTTP request or per Task, and it is not automatically applied to ordinaryku run.
Known HTTP issue: HTTP 504 occurred historically, including a seven-request cluster. This round’s 60-second and 180-second short tests did not reproduce it. The root cause is unconfirmed, and formal 30-minute stability acceptance has not passed. It is retained as a known issue for v0.0.18 and is not a separate release blocker. The earliest three historical 504s lack enough evidence for a unique reconstruction. Do not describe the issue as repaired or long-term stability as accepted.
Deferred, not completed: complete M:N, general Task network scheduling, the complete database platform matrix, and further long-running workload acceptance belong to later versions. General value copy/release follow-up and AST analysis remain paused. No unrelated memory-limit validation is being repeated.
Process memory boundary
Section titled “Process memory boundary”| Host | ku supervise guarantee and prerequisite |
|---|---|
| Linux | cgroup v2 kernel charged memory; a writable, delegated domain root with memory and pids enabled is required. Required interfaces include memory.max, memory.swap.max, memory.oom.group, pids.max and cgroup.kill. Missing controls or permissions cause refusal before application execution. |
| Windows | Nested Job Object limits for individual workers and the worker group, measured as committed virtual memory, not RSS. Initial process commit is checked before its suspended application thread is released. Host policy can reject Job assignment. |
| macOS | This isolation mode is not supported natively and is explicitly rejected before starting the application. Use a suitably configured Linux host/VM when required; there is no automatic VM bridge. |
Worker accounting covers applicable Ku and third-party library allocations in that worker’s resource domain. Linux cgroup accounting and Windows commit are different metrics. Linux memory.max may permit transient overshoot; these mechanisms do not promise an absolute ceiling on all physical memory at every instant.
The coordinator itself has no OS memory hard limit. Its bounded admission/control reserve is an accounting policy, not a coordinator RSS limit. A single Task’s entire heap is not precisely metered; shared connection pools, caches and library allocations cannot be exactly attributed to each Task. External databases, the host/VM and build compilers lie outside the worker domain.
When an OS limit terminates a worker, the coordinator reports failure and only returns reserved capacity after confirmed cleanup. Some allocation failures can be reported before allocation, but third-party exhaustion is not guaranteed to become an ordinary Result. Database operations are never automatically retried; an exited worker does not prove rollback, and side effects may be unknown.
See the process execution contract, concurrency contract and HTTP acceptance record. Cross-platform CI and installation checks establish only their reported targets and scope, not a completed real-database matrix.
v0.0.17 · Experimental prerelease
Section titled “v0.0.17 · Experimental prerelease”Published on 2026-10-18 (America/Los_Angeles), or 2026-10-19T03:51:10Z in UTC. The release has prerelease=true and draft=false. No stable release has currently been verified.
Main changes:
- Synchronous read only borrowed parameters use
&name: T, with ordinary call arguments. Normal owned parameters retain move semantics. - The self hosted parser subset adds braced
while, with bounded nesting and statement counts. - Cross platform tests correct stdout disconnection checks. This does not add a business API.
- Archives include matching Rust dependencies for the default runner and a target TLS pack. Appropriate external toolchains are still required.
Downloads cover Windows x64, Linux x64, and macOS arm64. The seven Release assets are three platform archives, three manifests, and SHA256SUMS. See installation and the complete release notes.
Compatibility and limits
Section titled “Compatibility and limits”Ku remains experimental and is not ready for production. Version 0.0.x does not promise source or generated C/FFI ABI compatibility. Recompile the relevant native artifacts when updating. Borrowed async parameters, complete self hosting, and full native async are outside this release.
The default runner embeds only the entry source; imported modules still require their original locations. Database clients are native only. Check each driver’s real server, TLS, and session state limits. Ku’s own code still has no open source license grant.