# Substrate Physics Canon

Operator-maintainable canon for the substrate physics layer — phase regime, action basis, retrieval envelope, product adapters, and the minimal learning slice.

These documents are the **source of truth** in-repo. Public download copies live at `apps/landing/public/downloads/substrate-physics/` (same filenames).

## Canon index

| Doc | Title | Sprint | Status |
|-----|-------|--------|--------|
| [01](./01-phase-regime-state-machine-v0.1.md) | Phase-Regime State Machine v0.1 | 61 | Live |
| [05](./05-learning-registry-v0.1-minimal-slice.md) | Learning Registry — effectiveness loop v0.2 (§6.19 deferred) | 66 | Live |
| [06](./06-smartpeers-review-substrate-v0.1.md) | SmartPeers Review Substrate adapter | 64 | Live (v0.1 wedge) |
| [08](./08-action-basis-integrity-protocol-v0.1.md) | Action-Basis Integrity Protocol | 62 | Live |
| [09](./09-retrieval-integrity-envelope-v0.1.md) | Retrieval Integrity Envelope | 63 | Live |

## Code alignment

See **[IMPLEMENTATION_MAP.md](./IMPLEMENTATION_MAP.md)** for equation → service, phase → enum, and receipt binding → table mappings.

## Related runtime packages

- `@substrate/physics` — pure phase classifier, policy engine, basis scorer
- `packages/substrate-service` — evaluate orchestration, persistence, observability views
- `packages/tracescript-conformance-suite` — ISF + SP fixtures that prove physics paths

## Broader narrative

Phase-regime vocabulary also appears in the TraceScript whitepaper (§12 Phase-Regime Control) and Substrate Integrity Monitor whitepaper (§14 Substrate Phase-Regime Control) under `apps/landing/public/downloads/`.