Architecture Decision Records
Each ADR records one decision: the context, the decision itself, its consequences, and the alternatives rejected.
Statuses:
Proposed— awaiting review.Accepted (owner)— accepted by the project owner; engineering review still pending (issue #44).Accepted— reviewed by the engineering team.Superseded by NNNN.
A revision or note added to an ADR has its own status line, under its heading.
Review rule: org policy requires engineering review of architecture, type-system and runtime decisions. ADRs 0001–0009, with the Revision 1 of ADRs 0001–0004, and the runtime ABI were accepted on 2026-10-08 (issue #2). Everything else that is Proposed or Accepted (owner) — whole ADRs, revisions and notes — awaits engineering review: issue #44 lists it, and is where reviews are recorded. The table says which parts of each ADR are which.
| ADR | Title | Status |
|---|---|---|
| 0001 | Language surface and syntax | Accepted |
| 0002 | Memory model: Perceus RC, no GC | Accepted; later sections Accepted (owner); a note (2026-10-15) Proposed |
| 0003 | Effect handler lowering in the C backend | Accepted; Revision 2 and a note Accepted (owner) |
| 0004 | Actor model and scheduler | Accepted; later sections and Revisions 2–5 Accepted (owner); a note (2026-10-15) and Revisions 6–8 Proposed |
| 0005 | FFI and native dependencies | Accepted; Revision 1 Accepted (owner); a note (2026-10-12) and Revision 2 Proposed |
| 0006 | Incremental analysis model | Accepted; a note (2026-11-01) Proposed |
| 0007 | Type inference and traits | Accepted |
| 0008 | Effect typing | Accepted |
| 0009 | HTML literals | Accepted |
| 0010 | Lexically scoped effect handlers | Accepted (owner) |
| 0011 | The runtime's own context switch | Accepted (owner) |
| 0012 | Bytes, builders and HTTP connections | Accepted (owner); Revisions 1 and 3 Accepted (owner); Revisions 2, 4 and 5 Proposed |
| 0013 | Numeric code: uniform values, specialised evidence | Accepted (owner) |
| 0014 | Arrays, owned extern parameters, and bigint promotion | Accepted (owner) |
| 0015 | C callbacks and bindings | Accepted (owner) |
| 0016 | User-level cleanups: defer | Accepted (owner) |
| 0017 | Multi-shot resumptions | Accepted (owner) |
| 0018 | Multi-parameter traits and higher-kinded types | Accepted (owner); Revision 1 and a note Proposed |
| 0019 | User-defined derives | Accepted (owner) |
| 0020 | Git dependencies and the lockfile | Accepted (owner); Revision 1 Proposed |
| 0021 | The name Louise and the .lse extension | Accepted (owner) |
| 0022 | Console output on a writer thread | Accepted (owner) |
| 0023 | Pipe placeholders and function captures | Accepted (owner) |
| 0024 | Errors as values | Accepted (owner) |
| 0025 | The build directory | Accepted (owner) |
| 0026 | Functors and monads in the standard library | Accepted (owner); a note Proposed |
| 0027 | <> is the Semigroup trait's method | Accepted (owner) |
| 0028 | Mailboxes under contention, and memory per actor | Proposed |
| 0029 | Stable C units | Proposed |
| 0030 | Release builds stay in one C unit (ThinLTO rejected for now) | Proposed |
| 0031 | Runtime variants: a checked runtime for tests, a fast one for release | Proposed |
| 0032 | Cross-language ThinLTO between the runtime and the program | Proposed |
| 0033 | Opaque types, so a module can protect its invariants | Proposed |
| 0034 | String interpolation through Show | Proposed |
| 0035 | Numbers: bit operations on Int, a Float's bits, and U64 | Proposed |
| 0036 | clock and random, effects the runtime handles | Proposed |
| 0037 | Early return | Proposed |
| 0038 | TLS clients (and servers, Revision 1) | Proposed; Revision 1 Proposed |
| 0039 | Tail recursion modulo cons | Proposed |
| 0040 | Perceus v2: arities in Core, sized reuse, tokens across calls, @fip | Proposed; Revision 1 Accepted (owner); Revision 2 Proposed |
| 0041 | GADTs and existential types | Proposed; Revision 1 and a note Proposed |
| 0042 | Smaller release binaries: stripped, folded, std without backtraces | Proposed |
| 0043 | A Core optimiser: simplifier, specialisation, fusion, constructed product results | Proposed; two notes Proposed |
| 0044 | Effect-row ergonomics: row aliases and the /_> marker | B Accepted (owner), implemented; C Proposed |
| 0045 | Unbox Float (and U64) | Accepted (owner); Revision 1 Proposed |
| 0046 | Cheaper calls (exact-arity direct calls; preemption on recursive-group entries) | Accepted (owner); Revision 1 Proposed |
| 0047 | Associated types | Proposed |
| 0048 | Tagged template literals and std templaters | Proposed |
| 0049 | std/file: whole-file reads and writes | Proposed |
| 0050 | std/crypto and std/base64: the SCRAM primitives | Proposed; amended by 0067 and 0071 (Proposed) |
| 0051 | @derive(MsgPack): deriving MessagePack encoders and decoders | Proposed |
| 0052 | The postgres package: wire protocol, connection actors, pool, sql effect | Proposed |
| 0053 | Streamed responses, and how a connection leaves the HTTP loop | Proposed |
| 0054 | Precompiled renderers for HTML templates | Proposed |
| 0055 | Opt-in virtual time with sockets (LOUISE_VIRTUAL_TIME) | Proposed |
| 0056 | Split giant functions into tail-call chains | Proposed |
| 0057 | std's templaters are compiled syntax for the HTML tree | Proposed |
| 0058 | Match continuations: shared occurrences and lifted arm bodies | Proposed |
| 0059 | The formatter is a pretty printer, and it has no settings | Accepted; Revisions 1–2, 4–8 Accepted (owner); Revision 3 Proposed |
| 0060 | OS signals, graceful shutdown, and supervised applications | Proposed |
| 0061 | A fast test loop: shared program, parallel tests, kept results, --watch | Proposed |
| 0062 | Parens-free functions: application by juxtaposition, currying, labelled arguments | Proposed |
| 0063 | No ML functors, for now: traits, opaque types and effects cover what they would do | Proposed |
| 0064 | Test-only code: @test import, [dev-dependencies], and the gen package (generators, fakes, shrinking property checks) | Proposed |
| 0065 | Row arguments (`async<<io | e>>`), and effects whose parameters are rows |
| 0066 | Row evidence: a run-time form for rows that carry received handlers (revises ADR 0010) | Proposed |
| 0067 | Signature verification in std: Ed25519 over the runtime's ring (amends ADR 0050) | Proposed |
| 0068 | Borrowed closures: a second, borrowed-contract closure entry (runtime ABI 10) | Proposed |
| 0069 | Record workers: single-constructor parameters and results flattened into C parameters | Proposed |
| 0070 | Dec, a fixed-point decimal for money | Proposed |
| 0071 | Authenticated encryption in std: ChaCha20-Poly1305 and HKDF-SHA-256 over the runtime's ring (amends ADR 0050) | Proposed |
| 0072 | Distribution: actors across hosts, typed on the wire (Wire, opaque Subject, a runtime transport over mTLS) | Proposed |
| 0073 | std/table: tables any actor reads without a message (ETS / persistent_term); values shared via send::share, retained under sharded read locks, tables immortal | Proposed |
| 0074 | Check only the std modules a program reaches (changes ADR 0006's model) | Proposed |
| 0075 | JSON is a package (packages/json): a hardened parser, a writer, @derive(ToJson) and path-reporting decoders | Proposed |
| 0076 | Event sourcing is a package (packages/eventsourcing): deciders, aggregates, state caches, the event store in memory and PostgreSQL, projections, sealing | Proposed |
| 0077 | Logging is a package (packages/log): levels, fields and handlers; web/access logs a request at a level from its status and path | Proposed |
| 0078 | event_store.redact gives one stored event new data in place (same position, version, kind and partition, sealed again under its own context), and state_cache.forget drops a cached state: how apps erase what a person asked to have forgotten | Proposed |
| 0079 | URLs and an HTTP client are packages (packages/url, packages/fetch): RFC 3986 parsing and resolution; one GET that checks every address of a host, refuses private ones, never follows redirects and is killed at its deadline | Proposed |
| 0080 | multipart/form-data is a package (packages/multipart): limits on every count and size, only two part headers read, file names cut to their last segment | Proposed |
| 0081 | Rate limits, retries and secret files are packages (packages/resilience, packages/throttle, packages/secrets), promoted from the apps' copies; fetch.request sends any method with a body (0079 Revision 1) | Proposed |
| 0082 | Bounded declaration-only @comptime evaluation into immutable statics | Proposed |
| 0083 | A persistent interpreter REPL is a transactional source session | Proposed |
