Specifications
A specification describes what a slice of work must do and the contracts it must satisfy, precisely enough that implementation is mechanical. It is not a proposal and not a decision record.
| Document | Question it answers | Mutability |
|---|---|---|
ROADMAP.md | what ships in which phase, and the exit criteria | living |
| spec (here) | what exactly must exist, with which interfaces and acceptance checks | living until the phase closes |
| ADR | why a choice was made, and what it costs | immutable once accepted |
| RFC | a design that needs discussion before it is decided | frozen at decision |
A spec that changes an architectural decision needs a superseding ADR in the same pull request. A spec that adds scope beyond the phase it belongs to needs an RFC first.
Format
Every spec carries:
- Status -
Draft,Approved,Implemented,Superseded by NNNN - Scope and Out of scope - the boundary is the useful part
- Decisions - what this spec fixes, each with the alternative it rejected
- Interfaces - types, functions, files, CLI surface, config keys, error cases
- Acceptance - checks that prove it works, runnable by someone who did not write it
- Open questions - what is deliberately deferred, and to where
Rules
- A spec describes behaviour that can be verified. "It feels right" is not acceptance.
- Examples in a spec are normative only when marked as such; otherwise they illustrate.
- An interface change lands in the spec before it lands in code, in the same pull request.
- Numbers (sizes, latencies, limits) are either measured or marked as a target. Never invented.
- When implementation teaches something the spec got wrong, the spec is corrected in the same pull request that learns it.
Index
| # | Spec | Phase | Status |
|---|---|---|---|
| - | What Auro takes from Tauri | evidence | living |
| 0001 | Foundation: workspace, runtime seam, commands, state, dev loop | 0 | Implemented |
| 0002 | Auro.toml schema, merge rules, validation | 0 | Implemented |
| 0004 | Hot reload: save-to-visible with preserved state, measurability, mechanism under revision | 1, 3 | Draft - opt-in hot mode integrated; Linux 368 ms median (target met), Windows 813 ms (above), macOS 509.5 ms on a shared CI runner (boundary) |
| 0005 | Toolkit seam: setup hook, app-owned root, no framework toolkit | 1 | Implemented |
| 0006 | Lifecycle events: ready, window open/close, exiting | 1 | Implemented |
| 0007 | Typed application events: sender, main-thread pump, handlers | 1 | Implemented |
| 0008 | Command schemas: input/output metadata on the handler | 1 | Implemented |
| 0009 | Window manager: open/close/focus by configured label | 1 | Implemented |
| 0010 | Bundling: map [bundle] to tauri-bundler, host formats, auro bundle | 2 | Implemented (Linux, Windows and macOS verified) |
| 0011 | Signing keys, artifact hashes, platform signing config | 2 | Implemented |
| 0012 | Signed update manifests: format, verify, CLI | 2 | Implemented (v2; 0013 stage, 0028 deltas/rollout) |
| 0013 | Updater runtime: check, download, verify and stage | 2 | Implemented (full/delta; 0014/0025 apply) |
| 0014 | AppImage apply: atomic replacement and rollback receipt | 2 | Implemented (Linux only) |
| 0015 | Single instance: advisory lock, argument forwarding | 2 | Implemented (opt-in activation helper) |
| 0016 | Capability manifests and enforcement | 2 | Implemented (host wiring pending) |
| 0017 | Autostart service | 2 | Implemented |
| 0018 | Notifications service | 2 | Implemented |
| 0019 | Keychain service | 2 | Implemented |
| 0020 | Global shortcuts service | 2 | Implemented (pressed callbacks) |
| 0021 | Tray service | 2 | Implemented (icons, menus and click callbacks) |
| 0022 | Deep links: scheme registration, parsing and queue | 2 | Implemented (initial and forwarded wiring) |
| 0023 | Keyboard activation for Button | 2 | Implemented (AccessKit/IME pending) |
| 0024 | Alpha release: version, publish order, facade features, scaffold | 2 | Draft (alpha candidate; publication pending) |
| 0025 | Windows installer execution and macOS .app replacement | 2 | Implemented (.dmg and macOS elevation separate) |
| 0026 | Update journal and restart helper | 2 | Implemented (helper applies, relaunches, reconciles) |
| 0027 | Linux .deb/.rpm package apply | 2 | Implemented (elevation in 0029) |
| 0028 | Binary deltas and deterministic staged rollout | 2 | Implemented |
| 0029 | Linux package elevation through pkexec | 2 | Implemented |
| 0030 | Linux package rollback with an explicit older artifact | 2 | Implemented (manual policy) |
| 0031 | macOS .pkg apply through installer/osascript | 2 | Implemented in tree (runtime unverified) |
| 0032 | macOS notarization submission and stapling | 2 | Implemented in tree (credentials/runtime unverified) |
| 0033 | Update journal trust boundary: fail-closed ownership/mode/ACL checks | 2 | Implemented (Unix tested; Windows compile-verified, runtime unverified) |