> **Plain-language companion:** [v0.96.0.md](v0.96.0.md)

## v0.96.0 — Defaults, Bounds & Diagnosis

**Status: Released (2026-09-09).** Derived from [ROADMAP.md](../ROADMAP.md).

> **Release theme**
> Make resource choices, enforcement limits, long-running work, errors, and
> privilege boundaries visible through stable SQL interfaces.

### Correctness

| ID | Title | Effort | Priority |
|----|-------|--------|----------|
| PP-1 | Resource-based defaults | Medium | P0 |
| PP-2 | Honest resource guarantees | Large | P0 |

### Ease of Use

| ID | Title | Effort | Priority |
|----|-------|--------|----------|
| PP-3 | Progress reporting | Medium | P0 |
| PP-4 | Stable error surface | Large | P0 |
| PP-6 | Predefined roles | Medium | P1 |

### Recommended implementation order

1. Add the resource evidence model and effective defaults.
2. Expose disk/headroom diagnostics and documented enforcement classes.
3. Expose progress from the existing refresh history lifecycle.
4. Extend machine-readable error documentation and the CI guard.
5. Install the predefined roles and map them to existing ACLs.

### Implementation Status

| ID | Title | Status |
|----|-------|--------|
| PP-1 | Resource-based defaults | ✅ Done |
| PP-2 | Honest resource guarantees | ✅ Done |
| PP-3 | Progress reporting | ✅ Done |
| PP-4 | Stable error surface | ✅ Done |
| PP-6 | Predefined roles | ✅ Done |

### Exit Criteria

- [x] Automatic choices report their resource evidence.
- [x] Every resource has a documented enforcement class and pressure behavior.
- [x] Progress reporting covers initial, full, rebuild, and repair work.
- [x] User-facing errors expose stable identifiers, SQLSTATEs, details, and hints.
- [x] Predefined roles match the existing ACL model.
- [x] Unit, integration, and light E2E release checks pass in supported CI environments.
- [x] `just check-version-sync` exits 0.
- [x] CHANGELOG.md entry written.
- [x] ROADMAP.md v0.96.0 row marked released.