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)
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

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.