# Brain Module — Codex (per FVW v8 §22 Behaviour-First Codex)

**Module ID:** `oscar.brain`
**Per FVW v8 v0.10.0 §22:** C1-C9 contract items.
**Status:** Constitutional behaviour contract (extracted from runtime).

---

## C1 — Behaviour Inventory

[Extracted from runtime-inventory.md]

---

## C2 — State Machine with Transitions

[Extracted from runtime]

---

## C3 — Side Effect List

[Extracted from runtime — IDB writes, localStorage writes, DOM updates, network calls]

---

## C4 — Input Validation Contract

[Extracted from runtime]

---

## C5 — Failure Modes

[Extracted from runtime]

---

## C6 — User Simulation List

5+ representative flows. See `coverage-matrix.md` for the verification grid.

---

## C7 — Reproducibility Test

[Module-specific]

---

## C8 — Shape Matrix (per-surface × per-mode × per-chip × per-state)

Per FVW v8 §30.

| Surface | Modes | Chips | States |
|---|---|---|---|
| (template) | | | |

[Module-specific]

---

## C9 — State Shape Inventory (per v9-fvw §22 C9)

### C9.1 localStorage keys (this module)

```
[module-specific]
```

### C9.2 In-memory variables

[Module-specific]

### C9.3 IDB state

[Module-specific]

### C9.4 UI-affecting state summary

[Module-specific]

---

## END OF BRAIN CODEX