PROCITY/docs/LANES/ROUND3_INSTRUCTIONS.md

# PROCITY — Round 3 lane instructions (from Fable, integrator)

Date: 2026-07-14 · Written after all six lanes finished round 2 and Lane F's first two
integration passes landed. Repo state as of these instructions: **everything committed on
`main`**, `tools/qa.sh --strict` **GREEN** (4/4 gates, selfcheck 1283/1283, manifest 0 errors).

## Where we are

v1 is **integrated and playable**: the game boots on Lane A's generated town (seed 20261990 →
"Boolarra Heads", 493 shops), Lane B streams/renders it under budget, doors enter Lane C
interiors, Lane D keepers greet at counters and peds walk the streets, Lane E's 48 facades +
manifest are live, Lane F's bridge + QA harness tie it together. What remains is **polish,
validation, and the last two integration steps** (LANE_F_NOTES §3.4/§3.5).

## Integrator decisions (so nobody blocks on them)

1. **Retail density stays at ~493 shops/core.** Lane B's facade atlas got the worst view to
   ~261 draws with citizens; no need to thin the town for v1.
2. **True closed residential ring → v2** (stays in V2_IDEAS).
3. **F finding #4 (doubled possessives) is CLOSED** — verified 0 across 2,418 shop names /
   5 seeds on current main. It predated Lane A's round-1 fix.
4. **Depot publish and the ~$2.70 MeshGod hero batch remain gated on John** — do not publish,
   do not spend. Local validation paths below unblock everything else.

## Process rules (unchanged, they matter)

- Lanes share ONE working tree. Never bare `git add .` / `git commit -a`. Stage **only your
  files by exact path** and commit immediately. Check `git status` first; touch nothing
  another lane has modified.
- Real repo path is `/Users/m3ultra/Documents/procity` (old prompts say /Users/jing — wrong).
- Update your `*-progress.md` at the end of your session; leave notes for other lanes in
  `docs/LANES/`.
- Dev server: `cd web && python3 -m http.server 8130`.
- Run `bash tools/qa.sh --strict` before you finish; leave it green.

---

## Lane A (CityGen) — on-call + one verification

Small round. Priority order:
1. **Verify F finding #5**: "some shops have storeys outside the registry type range (e.g.
   video at 2, range [1,1])". Your round-1 `cornerBoost` gate (registry max ≥ 2) may already
   have fixed it — prove it on current main across ≥5 seeds. If real, fix + add a selfcheck
   assertion; if stale, mark it closed in A-progress.
2. Confirm the committed `GOLDEN.hash` matches the current selfcheck fingerprint (`0x098eec2b`).
3. Otherwise standby: answer contract questions from F's §3.5 hours work (your `openLate` /
   `hours=[open,close]` contract is about to get its first real consumer).

## Lane B (Streetscape) — draw-budget shave + hooks

1. **F finding #3 (the one open budget item): ~334 draws at spawn with radius 3.** Your
   radius-2 auto measure is ~261. Make the compliant configuration the default at spawn
   (radius 2 auto, or more merging if you'd rather keep 3) and re-measure the worst
   continuous-walk view **with citizens at pop 140** via `window.DBG`. Target: ≤300
   everywhere, documented in LANE_B_NOTES.
2. **Confirm `scene.environment` is set** in all modes — Lane D's PBR peds go dark without it
   (F verified street mode works; check night + interior-return edge cases).
3. Support F's §3.4: when the manifest GLB upgrade lands, verify street furniture GLBs
   (benches, streetlight, food cart) place on their manifest footprints without collision
   regressions.
4. Optional polish: fresh `docs/shots/laneB/` stills of the *generated* city; wire `map` mode
   to Lane A's map.html.

## Lane C (Interiors) — GLB path visual validation

Your `glb.js` path is wired but never seen pixels. Lane E's 16 normalized GLBs exist locally
in `pipeline/_normalized/` — you don't need the depot publish.
1. Coordinate with Lane E's local-depot mode (below); flip `useGLB` on and **visually validate
   every fitting GLB in real rooms**: correct scale on footprint, base on floor, facing −Z,
   no z-fighting with primitive decor.
2. Re-run your sweep + soak with `useGLB` on: 0 throws / 0 path-fails / 0 leaks, perf still
   <50ms warm. GLB textures must dispose correctly on room exit.
3. Report any footprint/origin mismatches to Lane E by file name (they have 3 known near-miss
   assets already excluded).
4. Screenshot evidence into `docs/shots/` (a laneC dir is fine).

## Lane D (Citizens) — small support round

1. When F's §3.4 fleet upgrade lands, verify keepers upgrade from placeholder to shared GLB
   rigs and remain leak-free over enter/exit cycles (your dispose contract, F's loop).
2. Wire/document `ImpostorLayer.setExposure()` to the shell's day/night segment so mid-tier
   billboards match rigs at dusk (one paragraph + one verified call site with F).
3. Write the **chunk-streamed roster design note** (keyed `chunkKey+i`, stream with Lane B's
   chunk build/dispose) — design only, no implementation; it's the v1.5 fix for big-town
   street emptiness.

## Lane E (Assets) — local depot mode + near-misses

Publish stays gated (needs `GOD3_PW` + provenance recording — John's call).
1. **Unblock local validation**: make `core/loaders.js` (or a manifest/URL flag, e.g.
   `?localdepot=1`) resolve `depot:<file>` to the locally staged GLBs so Lanes B/C/F can
   validate before publish. Keep the placeholder-on-miss behaviour.
2. Support Lane C's visual validation — fix any origin/footprint mismatch they report
   (your normalize.py now handles hierarchies; re-run per asset).
3. Optional: manual Blender re-origin pass on the 3 near-misses (garage_shelves, radiogram,
   market_stall) if C wants more variety; otherwise leave to primitives.
4. Have the publish command + per-asset provenance list **staged and documented** so the
   moment John says go it's a 5-minute job.

## Lane F (Integration) — lead lane this round

Priority order, per your own §3 plan:
1. **§3.4 Manifest + `?noassets`**: GLB upgrades from manifest.json through B (street
   furniture) and C (`useGLB`), using E's local-depot mode; includes the **rig-fleet upgrade**
   so keepers/peds share GLB meshes (then try raising `?pop=`). Verify `?noassets=1` still
   runs 100% primitive/fallback with zero network.
2. **§3.5 Hours / closed shops**: consume Lane A's contract — `hours=[open,close]` 24h ints,
   **exactly one `openLate:true` landmark per town** (closes ≥22:00). Closed shops: door
   locked + toast, lights/sign off after close; the openLate shop is the night destination.
3. **Browser QA gates 1–4,6**: `tools/shots.py` + `tools/soak.py` against `window.DBG`
   (B's dbg.js is committed). Capture the `docs/shots/v1_tour/` set. Re-measure budgets after
   B's shave; update the gate table in LANE_F_NOTES.
4. Keep the findings table current; anything cross-lane goes through a note in `docs/LANES/`
   + a line in the target lane's instructions, not silent edits (inline seam edits marked
   `[Lane F integration]` are fine where they're your seam).

## Needs a human (John)

- **Push to origin** — main is now 10 commits ahead of origin/main (only the scaffold is pushed).
- **Depot publish go/no-go** (needs `GOD3_PW`; E will have it staged).
- **~$2.70 MeshGod hero-prop batch** go/no-go (pure polish; primitives cover everything).
- **A real pointer-lock playtest** — automation can't engage pointer lock;
  `cd web && python3 -m http.server 8130` → http://localhost:8130?seed=20261990.