# Milestone Implementation Report

> Complete every section. Use `None` where a section has no entries. Do not remove required headings.

## Milestone

**Name:**  
**Feature branch:**  
**Date:**  
**Implementation owner:**  

## Objective

State the approved outcome in concrete terms.

## Architecture Summary

Describe the approved boundaries, dependency direction, production flow, invariants, and preserved behavior.

## Production Files Changed

| File | Responsibility | Change summary |
|---|---|---|
| `path/to/file` | Owned responsibility | Concise description |

## Documentation Updated

| File | Change summary |
|---|---|
| `path/to/document` | Concise description |

## Tests Added

| Test file or suite | Behavior covered |
|---|---|
| `path/to/test` | Focused behavior, invariant, boundary, production path, or failure path |

## Verification Summary

| Verification | Result | Evidence |
|---|---|---|
| Focused PHPUnit | Pending | Tests and assertions |
| Regression PHPUnit | Pending | Tests and assertions |
| Full PHPUnit | Pending | Tests, assertions, skipped, failures |
| Pint | Pending | Final status |
| `git diff --check` | Pending | Exit status |
| Protected-file or scope checks | Pending | Compared targets and result |

## Known Limitations

- List implemented behavior that has an intentional technical limitation.
- Do not list future features as though they are partially implemented.

## Out-of-Scope Items

- List every material capability intentionally excluded from this milestone.

## Commit Status

**Status:** Not committed / Committed  
**Commit authorization:** Pending / Approved  
**Commit reference:** Not applicable / `<hash>`  

## Review Status

**Self-review:** Pending / Complete  
**External review:** Pending / In progress / Complete  
**Outstanding findings:** None / List finding identifiers  

## Approval Status

**Verdict:** Pending / APPROVE / APPROVE WITH TEST-ONLY CORRECTIONS / REJECT  
**Approved by:**  
**Approval date:**  
**Push authorization:** Pending / Approved  
**Merge authorization:** Pending / Approved