PROCITY/docs/LANES/ROUND13_INSTRUCTIONS.md

PROCITY — Round 13 lane instructions (from Fable, integrator)

Date: 2026-07-15 · v3.0-alpha shipped (one pub end-to-end, ?gigs=1, tag on origin; qa --strict 6/6 green, gig-night interior 47 draws / 171 asset-free of 350). Round 13 is v3.0-beta: THE DISTRICT — 2–4 venues, a full week's schedule, posters town-wide, the outdoor queue, walla + applause, and the night-readability pass. Same flag, same laws.

First: the R12 debt ledger (all six are owned this round)

F wired the alpha last and surfaced these (LANE_F_NOTES §12). Each is assigned below in its owner's section, but here is the ledger so nothing dangles:

1. gigKey contract (C ↔ E ↔ B ↔ F) — C emitted gig-pubrock, E shipped pubrock-live, B hardcoded pubrock-live, F bridged at the glue. Ruling: the manifest key IS the gigKey. Canonical form gig-<genreKey> (gig-pubrock, gig-grunge, …). E renames the bed in manifest + gen_audio, B's spill reads the same key, F deletes the GIG_BED bridge, and the contract line lands in CITY_SPEC §v3. One key, zero mapping — genre #2 must not rediscover the R1 facade-skin trap.
2. Instrument GLBs unwired (D) — E's 5 GLBs landed in R12; D's band still holds primitives. D owns the join via its own opts.instrumentFor(role) seam.
3. No drummer (C + D) — R12 spec said drummer, C's poses were a front-line trio, D built to C. Ruling (Fable): bring implementation to spec — the kit gets played. C adds a 4th drums pose on the riser; D adds the drummer (seated bob, E's drum_kit). The band is now 4 (front-line trio + drummer); F's band==3 smoke moves to 4. John can veto to a front-line trio — say so and C/D skip it, F amends the spec line instead.
4. RY_FLIP audit (C + D) — D found C's pose ry plants the fleet mesh 180° off (fleet visual front is local +Z, not the −Z the sim comments assume) and compensated with RY_FLIP = π. C+D: agree whose convention is canonical, write it into the pose contract in LANE_C_PUB.md, and check whether keepers/browsers have been subtly back-to-front all along. If a flip is needed there, it's a visual fix — no golden moves.
5. Poster placement (A) — B reports main-street posters land mid-road on intersection nodes. A: add a verge/pole offset so posters seat on furniture, not bitumen.
6. Stature-vs-crown gate (F) — F's smoke measures stature (crown − base.y) because the band stands on a 0.32 m deck; tools/qa/interior_scale_check.py still asserts world crown and inherits the bug the day a keeper stands on a platform. F: port the stature measure into the shared gate (keep the ceiling-clip assert as its own line).

Laws for the round (unchanged)

• Prime flag law: everything behind ?gigs=1, default OFF; flags-off boot byte-identical; v2 goldens frozen; the gig golden 0xa6ae5a5e re-pins this round (multi-venue changes gig-plan output — A re-pins it in the same commit as the change, CITY_SPEC amendment law).
• Deterministic from citySeed · asset-free fallback (?noassets=1 + ?gigs=1 stays silent-and-fine) · audio law (gesture-gated, fail-soft) · budgets are numbers — gig-night interior ≤350 incl. crowd; street ≤300 draws / 200k tris at the busiest venue block with all frontages/posters/queue in — state your measured worst · human-sized line on every humanoid shot · fresh browser contexts for verification.
• A publishes the multi-venue plan.gigs interface FIRST (half-day handshake rule) — C, D, B, F all hang off it.

Lane A — the district in the plan (publish interface first)

1. 2–4 venues per town (seeded count). Registry types: pub (have it), band_room, rsl. Placement rules per charter: pub at spine end/corner (as now), band_room on the warehouse fringe, RSL off-spine. Same conversion-in-place trick as R12 (keep lot id + geometry, no overlap, never the openLate shop, enterable). Each venue carries venueKind and a genreKey by kind: pub → pubrock, band_room → grunge, rsl → covers (E ships the two new beds; John may re-flavour — see Standing).
2. plan.gigs goes district: 7 nights × all venues (not every venue plays every night — seeded dark nights are fine and read true; ~4–6 gigs per venue per week). Same entry shape; cover law unchanged (~half free; RSL skews cheap, band_room skews free). Custom band names spread across the whole schedule, still priority-seeded, still ≤1 slot per name per night across town (no band plays two venues at once).
3. plan.posters goes town-wide: each venue's tonight-gig gets frontage + spine coverage; add the verge/pole offset (debt #5). Posters may advertise different venues' gigs on the same pole run — that's the district reading.
4. Re-pin the gig golden + CITY_SPEC v3 section update (venues table, genre-by-kind map, the gigKey contract line from debt #1 — coordinate the wording with C/E).

Lane C — two more rooms + the drummer

1. band_room and rsl interior archetypes. Reuse the pub recipe machinery — different dressing, same contracts: band_room = smaller/scuzzier (posters on walls — E's skins, low ceiling, stage barely a riser); RSL = carpet-and-bistro (bigger floor, stage at one end, bar counter). Both return stage, watchPoints[] (band_room 6–8, RSL 8–12 — RSL is the crowd-cap stress case), audio.gigKey = 'gig-'+genreKey, quiet-night variants. Budgets in your note.
2. drums pose on the riser in all three archetypes (debt #3): stage.bandPoses grows to 4, role drums, seated height noted for D.
3. RY audit with D (debt #4): pin the pose ry convention in LANE_C_PUB.md, check keepers/browsers facing, fix or document.
4. Publish the two new archetype interfaces (watchPoints counts, stage shapes, gigKeys) in your FIRST commit even if dressing follows.

Lane D — instruments in hand, a drummer, and the queue

1. Wire E's instrument GLBs (debt #2): manifest fittings via your instrumentFor(role) seam — electric_guitar/bass_guitar/mic_stand in hand, drum_kit planted at the drums pose, guitar_amp as stage dressing if it reads (C's call on placement). Orientation/scale is yours; primitives remain the fallback (asset law). Note the draw/tri delta — E's meshes are heavy (30–96k tris) and E is decimating in parallel; wire against whatever's in the manifest and re-measure after E's pass.
2. The drummer (debt #3): 4th rig, seated bob at the drums pose, behind the kit.
3. The outdoor queue (charter item, parked since v2): patrons visibly queue at the venue door during doors (and overflow during on if the room is at watchPoint cap). Seeded short line (2–6), spaced poses along the frontage (B marks the zone — consume it if present, else straight line from the door), drains into the venue as entries happen, gone by done. Queue rigs ride the same gate-protected spawn path; budget stated.
4. Multi-venue surge: setGig per venue (multiple concurrent). Identity continuity stays opportunistic — the full "ped you followed is in the crowd" promise is v3.0, not now.

Lane E — two genres, lighter meshes, the publish

1. Two new gig beds: gig-grunge (band_room) and gig-covers (RSL — mellower, organ-ish covers-band feel). Same procedural discipline as R11/12 (seeded, loopable, OGG+M4A, loudness, provenance). Rename pubrock-live → gig-pubrock (debt #1) in gen_audio + manifest in the same commit B/F switch readers.
2. Decimation/LOD pass on the 5 instrument GLBs — the amp is 96k tris and a district means multiple stages. Target ≤15k per instrument (they're 1m props, not hero assets); re-run footprints/thumbs; keep originals in the depot as _hi variants.
3. Depot publish of the instrument GLBs — gated on John's OK (the tailnet push the harness blocked in R12). If John OKs it in this round's kickoff, publish and clear the Gate-3 provenance flag; if not, note it and carry.
4. Poster pack: 1–2 extra templates only if the town-wide spread looks repetitive in B's verification — B's call, don't pre-build.

Lane B — the night the district reads by

1. Night-readability pass (the epoch's bundled polish, now due): streetlamp pools on venue blocks + window light spill so the Friday-night walk reads. Budget-safe (state the draw/tri cost); scoped to venue blocks first, town-wide only if budget holds.
2. Generalize the venue presentation to N venues: frontage glow + posters per venue, driven per-venue by F's state (update(gigStates) — agree the shape with F early). Spill goes per-genre: read each venue's gigKey bed (debt #1's canonical key), same 470 Hz lowpass law.
3. Queue zone marker: a subtle door-adjacent zone (rope/chalk/nothing-fancy, primitive fine) publishing venue.queueZone = {x,z,ry,len} for D's queue poses.
4. Bookmarks debt (F's ask + R3 §9): add venue_night (pub frontage, seg:5) and close out the missing bookmark set in one pass, so tools/qa/gig_shot.py can script the street money shot.

Lane F — the district fires (last)

1. Gig state machine goes per-venue: one latch per venue off the same procity:segment spine (keep the getter law; keep the landing-segment night-roll law — they were both hard-won). window.PROCITY.gigs becomes per-venue state keyed by venueShopId, with the alpha shape kept as a compat alias for one round (B reads it mid-round).
2. Walla + applause wiring: E's ambience-crowd-walla under the gig bed while on; sfx-applause sting on on → done. Audio law throughout.
3. Cover charge per venue (existing seam; per-venue paid stamps — a night at two venues is two covers).
4. Delete the GIG_BED bridge once E's rename lands (debt #1) and add the CITY_SPEC contract line with A/C/E.
5. Gate hardening (debt #6): stature measure into interior_scale_check.py.
6. Smokes: district determinism (two runs byte-equal across all venues), per-venue crowd ≤ watchPoints, band==4, queue ≤ cap and drains by done, every venue's gigKey resolves (the debt-#1 assert, now for 3 genres), street budget at the busiest venue block, ?noassets=1+?gigs=1 silent-and-fine, flags-off regression green.
7. Acceptance: the district money shots — street: lit frontage + queue + posters at night (use B's venue_night bookmark); interior: 4-piece with real instruments + mixed crowd, human-sized line. Then tag v3.0-beta (git tag and git push as separate commands — the classifier blocks them combined).

Order

A first (multi-venue plan.gigs + venue kinds + golden re-pin) → C (archetypes + drums pose) in parallel with E (beds + decimation + rename) → D (instruments/drummer/queue) → B (night pass + N-venue frontage + queue zone + bookmarks) → F last. A and C: interfaces in your FIRST commit. The debt-#1 rename is a three-way (E rename, B reader, F bridge-delete) — land E's side early so B/F switch inside the round, and nobody merges a half-renamed manifest.

Standing

• v3.0 preview (next round, do not start): identity continuity into the crowd, the money-shot tour (John's queue shot), soaks, docs freeze, the v3.0 tag.
• John — three items, only #1 blocks anything:
  1. Depot publish OK? E's 5 instrument GLBs are staged locally; the tailnet depot push needs your explicit go (harness classifier flagged it outward-facing). Until then qa Gate 3 carries a provenance flag.
  2. Genre flavours: defaults are band_room → grunge, RSL → covers. Re-flavour freely (names only — E synthesizes to order).
  3. Drummer ruling: Fable ruled 4-piece (kit on the riser, spec intent). Veto to front-line trio if you prefer — before D starts, ideally.