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 |