Skip to content

Architecture Decision Records

Each file records one decision: its context, the decision, and its consequences. See ADR 0001 for the process, and ../design.md for the readable overview.

ADR Decision Status
0001 Record architecture decisions Accepted
0002 let is the only binding form Accepted
0003 Strong static typing; dynamic typing only through tagged values Accepted
0004 The strongest guarantee is always the default Accepted
0005 Parameters carry ownership, access and modifiability modifiers Accepted
0006 Contracts, refinement types, and module state as exported symbols Accepted
0007 Metaprogramming from day one, expanded to a fixed point Accepted
0008 Operators are defined only through metaprograms Accepted
0009 User-defined generics, checked concepts with laws, and adapters Accepted
0010 Modules export interfaces; imports name them; proofs carry certificates Accepted
0011 Compiler in C++ on MLIR, verifying with interval analysis then Z3 Accepted
0012 Three ways to license float reassociation and FMA Accepted
0013 Auto-vectorise as much as possible; keep vec<T, k> for explicit control Accepted
0014 Concurrent by default: collectives, task graphs, futures; collectives proved to match Accepted
0015 Device placement: compiler cost model, explicit, or overridable Accepted
0016 Stream delineation on Apple Silicon is the flagship demo Accepted
0017 Build with Bazel; depend on LLVM/MLIR and Z3 as Bazel modules Accepted
0018 Three Pia dialects over upstream MLIR, with smt for solving Accepted
0019 Grammar disambiguation rules: contracts before bodies, layout, adjacency Accepted
0020 Decide affine aliasing and dependence goals with MLIR's Presburger library Accepted
0021 A language server, pia-lsp, with a VS Code client first Proposed
0022 Hygiene and name lookup: no shadowing, renamed quote binders, qualified names, ADL Accepted