Architecture Decision Records (ADR)

Architecture Decision Records (ADR)

This directory contains ADRs for the Vox project.

ADR	Title
001	Burn backend selection
002	Diátaxis doc architecture
003	Native training over Python
004	Codex over Arca over Turso (storage SSOT)
005	Socrates anti-hallucination (confidence SSOT)
006	Mens full-graph Candle QLoRA (qlora-rs)
007	qlora-rs 1.0.5 multi-layer training API gate
008	Mens control plane (HTTP; TLS at edge)
009	Hosted mens / BaaS (future trust model)
010	TanStack web spine (Router → Start, SSR topology)
011	Scientia publication manifest SSOT
012	Internal web IR strategy for Vox frontend emission
013	OpenClaw WS-first native interop
014	async-openai selective adoption (spike / no-go)
015	Vox Docker/OCI portability SSOT
016	Oratio streaming Whisper + constrained decode
017	Populi lease-based authoritative remote execution (design intent)
018	Populi GPU truth layering (verified vs policy labels)
019	Durable workflow journal contract v1 (interpreted runtime)
020	Populi mesh scaling transport default
021	Generated workflow durability parity
022	Orchestrator bootstrap factory + daemon boundaries
023	Optional telemetry remote upload (explicit CLI, Clavis, local spool)
024	Dashboard as local Axum-served SPA
025	Multi-Agent Lock Coherence and Lease Propagation
026	Third-Party Code Provenance Policy
027	Dual-Track UI Surfaces (Vox-Native vs React/TanStack Interop)
028	Remove stub durability/scheduling grammar (@scheduled, @durable, workflow, activity) — superseded by ADR-041 (2026-05-23)
029	Formal Intent and Tool Receipt Auditing (renumbered from 024 on 2026-05-02)
030	State machine SSOT
031	Deprecate vox-vscode
032	.vox.ui reactive modules (gates Phase D of the Svelte-mineable features plan)
033	Typed parametric fragment primitive (gates Phase F; deferred until Phase 6 primitives stabilize)
034	Candle / QLoRA stack upgrades (deferred batch; GPU CI)
035	SWC parser vs alternatives (evaluation only; no silent migration)
036	WebIR vs HIR unification (compare-both) — core+projection decision, rubric, capability wiring
037	Tauri convergence — generated desktop/mobile app shell, Capacitor retirement, Sherpa plugin port
038	AI fixture @prompt decorator
039	AI fixture @hole decorator
040	AI fixture @search decorator
041	Durable functions completion — closes ADR-028; workflow/activity/@scheduled/actor now backed by real runtime (Stable for ADR-019 subset)
042	Extract NodeRecord into vox-populi-types (L2) (filed under architecture/)
043	Quantized SafeTensors on-disk format (filed under architecture/)
044	AI fixture @subagent decorator (renumbered from a three-way 037 collision)
045	Tauri GUI replaces the Axum dashboard (renumbered from a three-way 037 collision)
046	Pareto-frontier reporting for model surfaces — scoreboard/explain mark non-dominated rows over reliability, cost, and latency; explicitly reporting-only, with the four reasons a routing change was rejected
047	iroh QUIC replaces the bespoke populi mesh transport (supersedes 008 and 020; partially supersedes 017; upholds 018)
048	Interpreter is the execution and sandbox tier (HIR interpreter isolates VoxScripts locally and on the mesh; wasm/container/microvm lanes retired)

See also: Internal Web IR implementation blueprint, WebIR operations catalog, WebIR supplemental execution map, Acceptance gates G1–G6, Internal Web IR side-by-side schema, WebIR appendix — tooling registry, WebIR K-complexity quantification, WebIR K-metric appendix, Codex vNext schema, Codex BaaS.