Skip to content
alpha 0.1.0-alpha.7 is on crates.io. Install the CLI Start here

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.

DocumentQuestion it answersMutability
ROADMAP.mdwhat ships in which phase, and the exit criterialiving
spec (here)what exactly must exist, with which interfaces and acceptance checksliving until the phase closes
ADRwhy a choice was made, and what it costsimmutable once accepted
RFCa design that needs discussion before it is decidedfrozen 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

#SpecPhaseStatus
-What Auro takes from Taurievidenceliving
0001Foundation: workspace, runtime seam, commands, state, dev loop0Implemented
0002Auro.toml schema, merge rules, validation0Implemented
0004Hot reload: save-to-visible with preserved state, measurability, mechanism under revision1, 3Draft - 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)
0005Toolkit seam: setup hook, app-owned root, no framework toolkit1Implemented
0006Lifecycle events: ready, window open/close, exiting1Implemented
0007Typed application events: sender, main-thread pump, handlers1Implemented
0008Command schemas: input/output metadata on the handler1Implemented
0009Window manager: open/close/focus by configured label1Implemented
0010Bundling: map [bundle] to tauri-bundler, host formats, auro bundle2Implemented (Linux, Windows and macOS verified)
0011Signing keys, artifact hashes, platform signing config2Implemented
0012Signed update manifests: format, verify, CLI2Implemented (v2; 0013 stage, 0028 deltas/rollout)
0013Updater runtime: check, download, verify and stage2Implemented (full/delta; 0014/0025 apply)
0014AppImage apply: atomic replacement and rollback receipt2Implemented (Linux only)
0015Single instance: advisory lock, argument forwarding2Implemented (opt-in activation helper)
0016Capability manifests and enforcement2Implemented (host wiring pending)
0017Autostart service2Implemented
0018Notifications service2Implemented
0019Keychain service2Implemented
0020Global shortcuts service2Implemented (pressed callbacks)
0021Tray service2Implemented (icons, menus and click callbacks)
0022Deep links: scheme registration, parsing and queue2Implemented (initial and forwarded wiring)
0023Keyboard activation for Button2Implemented (AccessKit/IME pending)
0024Alpha release: version, publish order, facade features, scaffold2Draft (alpha candidate; publication pending)
0025Windows installer execution and macOS .app replacement2Implemented (.dmg and macOS elevation separate)
0026Update journal and restart helper2Implemented (helper applies, relaunches, reconciles)
0027Linux .deb/.rpm package apply2Implemented (elevation in 0029)
0028Binary deltas and deterministic staged rollout2Implemented
0029Linux package elevation through pkexec2Implemented
0030Linux package rollback with an explicit older artifact2Implemented (manual policy)
0031macOS .pkg apply through installer/osascript2Implemented in tree (runtime unverified)
0032macOS notarization submission and stapling2Implemented in tree (credentials/runtime unverified)
0033Update journal trust boundary: fail-closed ownership/mode/ACL checks2Implemented (Unix tested; Windows compile-verified, runtime unverified)