Internals

Every page in the engine’s docs/internals/ directory.

• Architecture — Two layers with one contract: never lose a completed write, never serve a torn one.
• Benchmarking — Six benchmarks, six jobs. All build and drive the real release server over its real HTTP path (or the engine directly, where the question is about the engine); none estimates…
• Dependencies — Traza’s standing budget is stated in CONTRIBUTING: no new dependency without a written justification covering why the standard library cannot reasonably do the job and what the…
• Invariants — These are load-bearing and easy to break without noticing. Every one of them is already the reason some piece of code looks the way it does. Read this before changing the engine.
• Module map — What each file in src/ is responsible for, and where to start looking for a given change.
• Testing — A test that has never failed is a claim, not evidence.