PROCITY/docs/LANES/LANE_F_INTEGRATION.md

LANE F — INTEGRATION & QA (run after A–E land)

Prompt for Opus 4.8. You are working in /Users/jing/Documents/PROCITY. Read docs/CITY_SPEC.md, then every docs/LANES/LANE_*_NOTES.md the other lanes left. You may touch any file, but prefer surgical wiring changes over rewrites — each lane's internals are its own. This lane turns five verified parts into one game.

Mission

One URL, one seed, a whole town: web/index.html?seed=N → map → walk the streets → open any door → themed interior with a keeper → back out — 60fps, no seams, no leaks.

Wiring checklist

1. Swap Lane B's fixture_plan.js for Lane A's generatePlan(seed); seed from URL param, surfaced in HUD; web/map.html linked from an in-game map key (M) using the same plan.
2. Wire procity:enterShop → Lane C buildInterior (mode switch, street scene paused not disposed, player restored on exit at the door, interior disposed on exit).
3. Wire Lane D: citizens stream with Lane B's chunks (roster per chunk key); keepers spawn from Lane C's counter places; day-segment events drive density.
4. Point Lanes B/C at Lane E's manifest.json (skin→type mapping replaces any hardcoded pools; GLB upgrades appear; primitive fallbacks still exercised via a ?noassets=1 param).
5. Hours: closed shops (CityPlan hours vs day segment) get dark windows, CLOSED plate, locked door toast. One late-night shop per town stays open (Lane A seeds it) — verify it exists.

QA gates (all must pass before calling it v1)

• Determinism: seed 1234 on two machines → identical map PNG, identical first-interior placement list.
• Soak: scripted 10-minute walk (record a waypoint path, drive the camera) crossing ≥30 chunks, entering ≥15 shops: renderer.info.memory geometries/textures return to baseline after each interior; JS heap stable; zero console errors.
• Budget: HUD numbers within CITY_SPEC limits at the busiest intersection at midday.
• Asset-free run: ?noassets=1 full playthrough — placeholder town, zero crashes.
• Selfchecks: node web/js/citygen/selfcheck.js + python3 pipeline/validate_manifest.py green; add tools/qa.sh that runs both.
• Shots: refresh all docs/shots/* reference images; add a contact-sheet docs/shots/v1_tour/ (10 beauty shots: main street noon, arcade, market square, milkbar dusk, record-shop interior, night neon, etc.) — these are the Vuntra-style devlog material.

Then write docs/V2_IDEAS.md

Park everything discovered but not built: dig.js wiring + BaseGod real-item stock, interior window shader, real-OSM plan import (thriftgod build_city() route), trams/bus loop, weather, multiplayer presence, the in-game layout editor (thriftgod E1–E4 override tables), venue district + gig system crossover with 90sDJsim.