[CloudCraft Integration] Add authoritative WorldOverlayModel and repair 2D overlay truth path (#2465)

[OuroborosCollective]

Summary

First vertical CloudCraft integration slice (#2465). Establishes a pure, server-authoritative WorldOverlayModel and repairs the 2D overlay truth path: LiveGameplaySnapshot -> WorldOverlayModel -> 2D adapter.

Problem

The three overlay marker layers (WorldPoiMarkerLayer, ResourceNodeMarkerLayer, CampNpcMarkerLayer) existed as source files but were never mounted in the real /2d render path. Meanwhile, uiRuntimeManifest claimed "LIVE" + realRenderPath: true for them — a fake LIVE assertion with no causality. The layers also used component-local approximate isometric transforms (hardcoded worldOriginX=460, scale=1.2) instead of the canonical isometricProjection.ts.

What changed

• WorldOverlayModel.ts — read-only presentation model derived exclusively from LiveGameplaySnapshot (POIs, resource nodes, camp NPCs, worldSurface). Deterministic stable sorting (relational compare), honest status (live/waiting/empty/stale/blocked), frozen output, real evidence counts. No Math.random, no wall-clock.
• WorldOverlayProjection.ts — canonical isometric projection using shared isometricProjection.ts (iso2), replacing component-local approximate transforms. Viewport is an explicit adapter input.
• OverlayReachabilityGuard.ts — verifies LIVE marker-layer claims via real import-graph evidence (markOverlayReachable at module-eval time). A layer is only live when its source module is actually imported by an entrypoint.
• useWorldOverlayModel.ts — reactive hook deriving the overlay model from the live snapshot.
• main.tsx — mounts the three marker layers in UIOverlayLayer (real /2d render path). They were previously unmounted.
• All three marker layers refactored to consume WorldOverlayModel + canonical projection instead of duplicate approximate transforms.
• uiRuntimeManifest.ts — notes updated to reflect the real mount path evidence.
• ResourceMarker now handles the locked status honestly (was only available/depleted).

Rules honored (from issue)

• ✅ No second truth: input is always a LiveGameplaySnapshot.
• ✅ No client authority: model is display-only.
• ✅ No Math.random() or wall-clock in the presentation model.
• ✅ Camera/viewport only as explicit adapter input.
• ✅ LIVE status backed by real import-graph reachability, not a hardcoded claim.
• ✅ Snapshot evidence present before model is considered live.
• ✅ Canonical isometric projection used instead of approximate marker transforms.

Validation

• 18 new unit tests pass: WorldOverlayModel.test.ts (10), WorldOverlayProjection.test.ts (5), OverlayReachabilityGuard.test.ts (3).
• tsc --noEmit: no new errors in touched files (pre-existing errors in other files unchanged).
• eslint: clean on touched files.
• Full client-2d suite: 187 passed (was 186 on main), 24 failed (was 25 on main) — all remaining failures are pre-existing DOM/environment (document is not defined) issues unrelated to this change; one previously-failing test now passes.

What could not be validated

• Browser runtime smoke (POI/resource markers visible in real /2d): requires a running dev server + browser session. This is tracked for [CloudCraft Integration] Prove runtime evidence and 2D/3D parity for integrated slices #2469 (runtime evidence & playtests).
• 3D parity: tracked in [CloudCraft Integration] Bring 3D snapshot and discovery parity to minimap and worldSurface #2464.

Remaining risks

• The marker layers are now mounted but their visual positioning depends on the canonical iso projection matching the actual PixiJS camera transform used by the chunk renderer. The projection uses iso2 with TILE_W=96, TILE_H=48 consistent with renderChunkScenePlanFixed.ts and LootRenderer.ts, but real-world alignment should be verified in the browser playtest ([CloudCraft Integration] Prove runtime evidence and 2D/3D parity for integrated slices #2469).

---

This PR was created by an AI agent (OpenHands) on behalf of the user.

@OuroborosCollective can click here to continue refining the PR