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

Date: 2026-07-16 · **v3.0-beta shipped** (the district, `?gigs=1`, tag local; qa `--strict` 6/6,
0 warn — the queue assert went live after D landed). Seed 20261990 = Boolarra Heads: 3 venues,
14 gigs/week, tonight Screaming Utes @ The Exchange Hotel $10 + The Dead Ringers @ the RSL free.
Round 14 is **v3.0: THE RELEASE** — identity continuity into the crowd (the one remaining charter
promise), the money-shot tour, the soaks, docs freeze, and the `v3.0` tag. **No new systems this
round** — if it isn't continuity, hardening, or documentation, it's v3.1.

## First: the R13 debt ledger (all owned this round)

R13 closed its six debts cleanly (gigKey contract landed everywhere, instruments wired, drummer
seated, RY convention fixed **at the source** — D's `buildFigure` normalisation also silently fixed
keepers/browsers/walkers that had been back-to-front whenever the GLB fleet loaded; good catch, C+D).
What carries:

1. **Alpha alias retirement (B → F, ordered).** F kept the R12 single-venue
   `window.PROCITY.gigs` shape (`.state/.on/.venueShopId/.cover/.paid`) as a one-round compat
   alias; that round is over. **B first** removes its fallback readers (`audio.js` alias→clock
   chain, `venue.update()` bare-string arm — keep the clock fallback, drop the alias hop), **then
   F** deletes the alias so `byVenue` + the per-venue accessors are the only surface. CITY_SPEC §v3
   runtime block loses the alias line in the same commit (F).
2. **Drummer sit hack (D).** The 4th member is a standing rig sunk `SEAT_DROP` behind the kit —
   reads seated only from the front. `~/Documents/mixamo-fetch/out/` holds **34 clips incl. `sit`**
   (LANE_D_NOTES wishlist #1 — **check what exists first, never re-download**). Wire the real clip,
   retire `SEAT_DROP` + the `m.seated` branch.
3. **Town-wide streetlamp pools (B) — RULING: stays venue-scoped for v3.0.** Town-wide needs
   always-on `furniture.js` changes and that fights flags-off parity in release week. Venue blocks
   read fine (F's `venue_night` shot proves it). Document as a v3.1 candidate in LANE_B_NOTES;
   no code.
4. **Poster repetition (B judges, E executes).** B: during the tour audit, eyeball the spine poster
   runs — if the per-gig instanced skins read repetitive, ask E for 1–2 more templates. E: build
   only on B's ask (R13 law, unchanged).

Closed for good, for the record: depot publish (John OK'd mid-R13; Gate-3 provenance flag cleared,
`digalot.fyi` serves the 14k instruments + `_hi` originals).

## Laws for the round (unchanged, plus release discipline)

- **Prime flag law holds through the tag**: `?gigs=1` stays **opt-in for v3.0** (Fable's default —
  John may overrule, see Standing #2). Flags-off boot byte-identical, synthetic golden
  `0x3fa36874`, gig golden `0x1f636349` — **neither moves this round**. Any diff that would move
  a golden is out of scope by definition; park it.
- Deterministic from citySeed · asset-free (`?noassets=1&gigs=1` silent-and-fine) · audio law
  (gesture-gated, fail-soft) · budgets: gig-night interior ≤350, street ≤300 draws / 200k tris at
  the busiest venue block · human-sized line on every humanoid shot · **fresh browser contexts**
  (the stale-module trap bit B in R13 — `cache:'reload'` + hard nav, or the no-store server).
- **Shared-tree discipline**: commit atomically by explicit pathspec; lanes land concurrently.
- **Release-round law: no new rng draws on any seeded stream.** Continuity work must ride new
  sub-streams or consume existing identities — if two runs of R13 code and R14 code disagree on
  any golden or any R13 smoke, the change is wrong.

## Lane D — identity continuity: the ped you followed is in the crowd (the headline)

The last charter promise, deferred at R12 and R13 ("opportunistic, not now"). Now.

1. **Continuity contract.** The sim already knows who enters a venue (queue `admitOne()` drains +
   surge occupants). Record a per-venue **tonight roster** of entered identities
   ({pedIndex, height, …whatever pins "the same person"}), and have `GigCrew.spawn` consume it:
   crowd slots fill from the roster first, seeded strangers only for the remainder. Design is
   yours; the acceptance is behavioural: **follow a punter from the queue through the door, walk
   in behind them, and find them in the crowd — same ped, same height.** Works across exit/re-enter
   (roster persists for the night, not per interior build).
2. **Determinism**: the roster is a consequence of seeded sim behaviour; interior crowd identity
   for a given (seed, night, entry time-segment) must be stable enough for F's smoke — expose
   `window.PROCITY.citizens.tonightRoster(venueShopId) → [{pedIndex, …}]` (or your preferred name —
   tell F) so the smoke can assert crowd ⊇ roster ∩ cap without screenshot forensics.
3. **The sit clip** (debt #2 above). Data task, not rig work — clips bind through the canonical
   `mixamorig` skeleton like walk/idle.
4. **Sim soak**: 30+ min equivalent (accelerated segments fine) with gigs on — full week roll,
   repeated surge/drain/queue cycles at all venues; assert leak geo0/tex0, roster bounded, no
   identity churn. Numbers in your notes.

Budget note: continuity is bookkeeping, not new rigs — draw/tri delta should be ~0; state it.

## Lane B — alias retirement + the tour audit

1. **Drop the alias readers** (debt #1 — you go first, tell F when landed).
2. **Bookmark/tour audit**: every bookmark (16 v2 + `venue_night` + `district_posters`) still
   frames un-letterboxed, 0 errors, with `?gigs=1` on — the district changed the streetscape under
   some of the old poses. Fix poses, don't touch world code.
3. **`queue_night` bookmark** — John's queue shot: close framing on the pub door at `doors`/`on`,
   queue line + marquee + poster in frame, punters facing the door. This is the release hero shot;
   F scripts it into the tour.
4. **Poster repetition call** (debt #4): judge, and either "fine" in your notes or a one-line ask
   to E.

## Lane C — venue audit + docs freeze (light round, by design)

1. **Interior release audit**: one pass over the three venue archetypes against CITY_SPEC §v3 +
   LANE_C_PUB — watchPoint caps, stage/riser numbers, gigKey resolution, quiet-night variants —
   and re-run your 60-room soak + drawSweep against D's continuity changes (crowd identities
   change; geometry must not). Fix only regressions.
2. **`guitar_amp` placement ruling** (R13 left it "C's call"): D planted it as stage dressing —
   bless the placement or give D the corrected pose; one line in LANE_C_PUB either way.
3. **Docs freeze**: LANE_C_PUB.md + LANE_C_AUDIO.md are the durable contracts — final wording
   pass, mark them v3.0-frozen.

## Lane E — provenance close-out (light round, by design)

1. **`publish.py --verify` drift check** against the live depot post-R13-publish; qa Gate 3 must
   be green with zero flags for the tag.
2. **Poster templates** only on B's ask (debt #4).
3. **Docs freeze**: provenance table + audio/GLB inventories in LANE_E_NOTES current and
   v3.0-frozen. No new synthesis this round unless John re-flavours a genre (Standing #3, R13 —
   still open, still names-only).

## Lane A — invariant sweep + CITY_SPEC freeze

1. **District seed sweep**: 400-seed run asserting the district invariants — 2–4 venues, ≥1 pub,
   never the openLate shop, no band twice in one night town-wide, every poster behind
   `poleOffset`, per-venue 4–6 nights — plus **one osm town** proving graceful placement (no
   spine/warehouse district). Promote any invariant not already in `selfcheck.js` into it.
2. **CITY_SPEC v3 freeze**: you own the spec — final pass over §v3 (venues table, genre map,
   gigKey contract, gig golden `0x1f636349`, F's runtime block minus the retired alias), then mark
   the section frozen for the tag. Coordinate the alias-line deletion with F (debt #1).

## Lane F — soaks, the tour, the tag (last)

1. **Delete the alpha alias** once B lands (debt #1) + the CITY_SPEC line (with A).
2. **Continuity smoke**: extend `smoke_gigs` — queue identities admitted at `doors` appear in the
   interior crowd via D's roster seam (assert on the seam, not pixels); crowd ⊇ roster ∩ cap;
   determinism arm re-run.
3. **Full-week soak**: drive the segment spine through all 7 nights × all venues in one context —
   every latch fires per `plan.gigs` schedule (dark nights stay quiet), covers stamp per venue per
   night, walla/applause never double-fire, leak geo0/tex0 across ≥20 enter/exit cycles. Wire it
   into qa as a non-strict extra (strict stays the 6 gates).
4. **The money-shot tour**: `tools/qa/tour_shots.py` — scripted capture of the release set in one
   deterministic run: `rain_verandah` (winmap+rain hero) · `tram_stop` · `venue_night` ·
   `district_posters` · **`queue_night` (John's shot)** · gig interior (4-piece + instruments +
   crowd). Contact sheet into `docs/shots/release_v3/`.
5. **Docs assembly**: README v3 section (what shipped, the flags table, the shots), confirm every
   lane's freeze landed, LANE_F_NOTES §14 runbook.
6. **Acceptance + tag**: `qa.sh --strict` 6/6 + continuity smoke + week soak green → tag **v3.0**.
   Tag and push are separate commands; the push itself waits on John (Standing #1).

## Order

**B first** (alias readers out — F is blocked on it for the deletion) and **D first** (continuity —
F's smoke and the tour hang off the roster seam); they're disjoint files, run in parallel. A, C, E
anytime, independent. **F last**, as always. Mid-round handshakes: B→F "readers gone", D→F the
roster accessor name, C→D the amp ruling.

## Standing

- **v3.1 preview (do not start):** flag-default flip (if John rules it), town-wide lamp pools,
  tram-gig composition (ride to the gig), wind sway, bench-sit loiter from the same `sit` clip.
- **John — three items:**
  1. **The push.** The R13 epoch (7 commits + `v3.0-beta`) and everything R14 lands are **local
     only**. F is ready to `git push origin main` + tags on your word — it's the one
     outward-facing step every lane held.
  2. **Flag default at v3.0**: Fable's call is `?gigs=1` stays **opt-in** for the tag (prime-flag
     discipline through release; flip considered at v3.1 after the soak bakes). Overrule if you
     want the district on by default at v3.0 — that becomes an F task with a full golden re-pin,
     and it goes FIRST in the round, not last.
  3. **Genre re-flavour** (carried from R13, names-only, A+E coordinated): defaults
     pubrock/grunge/covers stand unless you say otherwise — last call before the docs freeze.