docs(roadmap): register Phase W — Unified Cell Graph (UCG); W1 shipped

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Erik 2026-06-02 10:05:34 +02:00
parent f2663b7e4b
commit 07e68e0aff

View file

@ -5,6 +5,30 @@
---
## Current program: Phase W — Unified Cell Graph (UCG)
**Pivot (2026-06-02).** The render-pipeline reset stalled because the indoor "world from
below" is a cell-**membership** disagreement between the render-side `CellVisibility` and
the physics-side `ResolveCellId` — not any single draw gate (pixel-grounded evidence:
[`docs/research/2026-06-02-render-cell-membership-evidence.md`](../research/2026-06-02-render-cell-membership-evidence.md)).
We committed to a full migration onto **one retail `CObjCell` cell graph** shared by
physics + collision + render + streaming. **Supersedes** the render-only "Phase U" framing
and the abandoned A8 two-pipe (#103). Five verify-each stages on branch
`claude/thirsty-goldberg-51bb9b`:
| Stage | What | Status |
|---|---|---|
| **W1** | `ObjCell` scaffold — Core `ObjCell`/`EnvCell`/`LandCell`/`CellPortal`/`CellGraph` built alongside the legacy systems, consumed by nobody (zero behavior change). | **Shipped 2026-06-02** (`9cb1571``f2663b7`; 22 tests; Opus-reviewed) |
| W2 | One membership — player `curr_cell` via retail `find_cell_list` + `change_cell` + doorway hysteresis; collapses `ResolveCellId` + `FindCameraCell` into one answer. *First behavior-changing stage.* | Next |
| W3 | Render on the graph — PView walk + **one gate** for terrain/shells/entities. **The visible M1.5 indoor fix.** | Planned |
| W4 | Collision on the graph — physics queries the same `ObjCell`s; retire parallel `CellPhysics`. | Planned |
| W5 | Streaming → `ObjCell`s — terrain as `LandCell`; the frozen-streaming rewrite. | Planned |
W1 spec: [`docs/superpowers/specs/2026-06-02-unified-cell-graph-stage1-design.md`](../superpowers/specs/2026-06-02-unified-cell-graph-stage1-design.md) ·
W1 plan: [`docs/superpowers/plans/2026-06-02-unified-cell-graph-stage1.md`](../superpowers/plans/2026-06-02-unified-cell-graph-stage1.md).
---
## Phases already shipped
| Phase | What landed | Verification |