Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Simple capability status

This is the compact view of Rullst’s canonical M1–M41 programme. It is derived from the root ROADMAP; that roadmap and the capability ledger retain the evidence and limitations. The labels here deliberately do not turn partial foundations into completed features. Package stability is a separate question: the maturity tiers classify every crate as Core, Extension or Experimental and state what each tier promises within 13.x.

v12 stable snapshot — 15 September 2026

Stable 12.0.0 was published from commit eb11f892. See the release record for the immutable tag and publication receipt. The v12 line reached end of life on 16 October 2026 (12.3.0 was its last release); this section keeps the record of its stable release.

The Rust CI scorecard for that commit awarded 94/100 (A) to the repository, with all fifteen non-IoT packages at A and IoT at its approved B exception. These are repository-owned audit scores constrained by test results, not a percentage of all planned functionality or an independent certification. The quality scorecard explains the scale.

The stable coverage run recorded the following local LLVM/LCOV gates before the Codecov upload:

Coverage viewStable-source measurementRequired floor
Whole repository90.3220% (79,813/88,365 lines)90%
Framework libraries90.6186% (60,014/66,227 lines across 436 files)90%

These are distinct path sets, not values to average. The public Codecov badge tracks the current branch and may change as its source and report processing change. Do not relabel an older checkpoint as the latest measurement.

The release audit links the stable platform, property, Miri, Kani, fuzzing, sanitizer and publication results. New maintenance commits must satisfy their applicable gates; the published release cannot certify future source changes.

rullst facade versus rullst-core

PackageRoleTypical user choice
rullst-coreLow-level runtime engine: HTTP server, routes, lifecycle, queue/realtime, storage/cache and the default browser-security baseline. It deliberately does not aggregate every domain crate.Use directly when a library/application wants only the runtime primitives and explicit dependencies.
rullstErgonomic umbrella facade. Cargo features re-export Core plus selected ORM, Auth, Connect, Security, AI, Mail, Capital, Studio, Nexus, Messaging and IoT APIs (and, from the 13.0.0-alpha.1 prerelease, Privacy) through one dependency. It also exposes the browser/WASM surface used by web-first applications; PWA packaging (make:pwa) is a CLI workflow, not a re-exported crate. Its maturity cannot exceed the crates selected underneath it.Use for most Rullst applications and enable only the required features.

Documentation maintenance gate

Stable v12 completed the documentation release gate: the mdBook and Rust snippets sourced from public tutorials built, local links and anchors were validated, commands/features/version examples were reconciled with the frozen manifests, and upgrade/provider boundaries were reviewed. v13 changes must keep those checks green: the Documentation workflow builds the book, checks llms.txt and validates local links and anchors, and the guides listed in rullst/src/book_doctests.rs compile as doctests. A green documentation build proves structural consistency, not that every external service or store workflow was homologated.

Canonical milestones

IDCapabilitySimple status
M1CLI and make:* generator matrix🟡 Still to implement — partial
M2Fast linkers and measured build-time improvements🟡 Still to implement — partial
M3Escape hatches, granular features, diagnostics, and ejection🟡 Still to implement — partial
M4make:resource and local error console✅ Implemented — scoped
M5mdBook, OpenAPI, and typed client generation🟡 Still to implement — partial
M6ORM parity and Turso/libSQL profile🟡 Still to implement — partial
M7Portable edge runtime, distributed data, and safe upgrades🟡 Still to implement — partial
M8Explain-and-approve index recommendations⏳ Still to implement — not started
M9Local auth, OAuth/OIDC, TOTP, passkeys, and WebAuthn🟡 Still to implement — partial
M10Mail, DTO validation, distributed rate limits, and Shield🟡 Still to implement — partial
M11Nexus, billing, and entitlements (Omni was retired in 13.0.0-alpha.3)🟡 Still to implement — partial
M12Defence-in-depth security programme🟡 Still to implement — continuous/partial
M13Audited PQC protocols and sandboxed Wasm extensions⏳ Still to implement — not started
M14HTMX-first SSR and real Leptos/Dioxus interoperability🟡 Still to implement — partial
M15Runtime queues/cache/scheduler plus brokered messaging🟡 Still to implement — local foundation and admitted standalone Redis profile; other adapters open
M16Wasm islands and #[client_component] protocol🟡 Still to implement — partial
M17Realtime, object storage, media, and packages🟡 Still to implement — partial
M18LiveView-style server-driven UI🟡 Still to implement — partial
M19Radar, agent schemas, spans, and Prometheus✅ Implemented — bounded
M20Persistent event stream and verifiable ledger semantics⏳ Still to implement — not started
M21Omni frontend protocol and mobile bridge🟡 Still to implement — partial; 13.0.0-alpha.3 replaced the Tauri shells with installable PWAs (make:pwa)
M22Human-reviewed agentic DevOps recommendations🟡 Still to implement — partial
M23Diagnostic auto-healing recommendations🟡 Still to implement — partial
M24no_std IoT frames/packet encoders, signed OTA gate, and durable-counter CAS boundary🟡 Still to implement — partial
M25Embassy-based async embedded integration⏳ Still to implement — not started
M26Guided deployment (cargo rullst deploy targets a Linux VM; the PaaS targets were removed in 13.0.0-alpha.4)🟡 Still to implement — partial
M27Kubernetes scaffolding and health/readiness probes✅ Implemented — scaffolding scope
M28Compile-time DI and Inject<T>✅ Implemented — foundation
M29Scalar playground and complete OpenAPI generation🟡 Still to implement — partial
M30Tonic/gRPC and Protobuf support⏳ Not implemented — the make:grpc generator was removed in 13.0.0-alpha.4; applications use their own tonic setup
M31Aerospace/autonomous/defence systems⏳ Separate safety-critical programme; outside the general framework suite
M32Axum/Tower escape hatches and proc-macro diagnostics✅ Implemented — bounded
M33Server-side declarative SaaS entitlements🟡 v13 prerelease foundation — typed current-state plan authorization with an authenticated SaaS consumer; the declarative #[rullst::gate]/GateGuard model remains open
M34Schema-driven TypeScript/React/Dart/Swift SDKs🟡 v13 prerelease foundation — one bounded OpenAPI 3.1 profile generates Rust codecs and a strict TypeScript client; React, Dart and Swift remain open
M35Distributed OpenTelemetry waterfall in Studio🟡 Still to implement — partial
M36Read-only explainable natural-language SQL assistant⏳ Still to implement — not started
M37Reviewable one-click error-console patch workflow🟡 v13 prerelease preview — the error page records a bounded panic context, makes no network request and hands the error to the developer’s own assistant through a copyable prompt and the recorded-context path (cargo rullst ai fix was removed in 13.0.0-alpha.4); a one-click flow and recording in the hot-reload mode remain open
M38Vendor-specific SQLite replica/synchronization profile⏳ Still to implement — not started
M39Optional self-hosted rullst-gateway load balancer⏳ Not implemented — abandoned on 8 October 2026 in favour of generated Caddy/nginx configuration; kept in the not-started count
M40rullst-labs contracts with a bring-your-own runner🟡 v13 prerelease foundation — trusted job/lease/grading contracts and a documented runner contract; the rullst-labs-runner candidate was removed from 13.0, so execution is application-owned; full offensive CTF arenas require external isolated infrastructure
M41Privacy controls and proportional age assurance🟡 v13 prerelease foundation — policy, signed evidence, asynchronous replay, SQLite and PostgreSQL adapters; combined hosted acceptance, consumer journeys and broader privacy work remain open

The labels match the milestone rows of the root roadmap: 5 implemented, 27 partial, and 8 not started inside the 40-milestone framework programme. M31 is excluded because it is a separately governed safety-critical programme. The 35 milestones without strict closure have different sizes and overlap existing published capabilities; their count does not measure remaining engineering effort or release blockers. Assigning every partial row half credit would not establish a completion percentage. The v12 stable record preserves the completed release identity; new capability work goes to v13. The safe update experience is a top v13 priority; cargo rullst upgrade and the v13 migration guide are its current tools. The 26 September delivery plan selects concrete increments from this wider programme and records their acceptance requirements.

Claims that are impossible as framework guarantees

No useful capability above is dismissed merely because it is difficult. The impossible label is reserved for absolute wording that code in this repository cannot honestly establish:

Absolute claimStatus
100% uptime or zero data loss in every deployment🚫 Impossible as a framework guarantee
Exactly-once arbitrary external side effects🚫 Impossible without destination-level idempotency/transactions
Zero latency, zero overhead, zero allocations, or universal sub-100ms builds🚫 Impossible as a universal guarantee
Total memory safety or universal panic-freedom across dependencies, FFI, generated apps, and every input🚫 Impossible to prove from this repository alone
Automatic fiscal, security, privacy, App Store, or hardware certification🚫 Requires independent authorities, environments, and evidence
Universal one-click zero-downtime deployment🚫 DNS, credentials, migrations, providers, and rollback remain operational inputs
“Best/fastest/most secure framework in the world”🚫 Not a technical property without dated, reproducible comparative evidence
Unattended production mutation that is always safe🚫 Approval, scoped authority, audit, recovery, and application policy cannot be removed

Use the quality scorecard for per-commit engineering evidence. It is intentionally separate from this functionality view.