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

> **⚠ SUPERSEDED by [ROUND9_INSTRUCTIONS.md](ROUND9_INSTRUCTIONS.md) (2026-07-14).** Round 8 is
> complete with NO slips — weather, Katoomba, 3 stock packs, buy loop, patronage all live;
> v2.0-rc tagged (`9cc00ad`) and pushed. Historical reference only.

Date: 2026-07-14 · Written after the Fable round-7 review (`16d4f2b`) and the **v2.0-beta
tag** (`4feba02`). You are an Opus 4.8 agent assigned ONE lane (read your session prompt).
Read this file, your lane spec, your `<X>-progress.md`, and NOTES addressed to you first.

Repo state: everything committed on `main` at `16d4f2b`. `tools/qa.sh --strict` GREEN 5/5
with the flags harness **STRICT**. **The streamed roster is the DEFAULT** (`?roster=v1` is
the escape hatch; baseline re-pinned 164 draws / 66k tris; plan goldens frozen at
`0x3fa36874` synthetic / `0x34cfdec0` osm-Melbourne). `?stock=real` puts real GODVERSE
sleeves in record-shop crates and digs. John is pushing main + v1.0/v1.1/v2.0-alpha/
v2.0-beta to origin. fal balance ~$21.36.

## Theme: catch-up + the town comes alive

Round 7 turned the two big keys but **two lanes slipped**: B (weather) and A (osm parity)
have no round-7 work. Round 8 is those debts plus the "living town" tier that the flip and
the stock pack unlock:

- **A and B execute their carried tasks** — B's weather is now also a dependency for D.
- **C widens real stock** (book/toy) and gives the dig a working **buy loop v0**.
- **D makes crowds react** — weather + shop patronage (peds actually enter shops).
- **E feeds packs** and stays the asset kitchen.
- **F graduates the new smokes to strict** and tags **`v2.0-rc`**.

A slip note (this applies to everyone): a lane that can't finish its round MUST commit a
partial + write the cut line in its progress doc before the session ends. Round 7's slips
were silent again — the schedule harness (F) catches them at round end, but a one-line
"stopped at X because Y" turns a re-derive into a resume.

## Prime law (post-amendment state)

Default boot = streamed roster at the re-pinned baseline; plan goldens frozen; everything
NEW still lands behind a default-off flag; flags compose; `qa.sh --strict` green at every
commit. The flags harness is strict — if your feature leaks into the default path, qa fails
and it's yours to fix.

## Integrator decisions (so nobody blocks)

1. **B goes first on weather** (carried R7 brief, unchanged — ROUND7 §Lane B): D's crowd
   reactions consume `window.PROCITY.weather`, so B1 landing early unblocks D2. If B slips
   again, D ships patronage only (hours-based) and weather-reaction carries — do not fake a
   weather source.
2. **Buy loop v0 scope (C)**: in-memory only. Player cash starts at a seeded-per-town float
   (e.g. $40–60), HUD chip, `onBuy` deducts price + removes the sleeve from the bin +
   adds to a simple inventory list (I key). NO persistence (no localStorage — a page reload
   resets; that's fine for v0), no selling, no economy sim. Deterministic world, free-agent
   player: purchases mutate live room state only, never generation.
3. **Pack expansion (E)**: book spines + toy boxes packs, same pipeline/laws as the record
   pack (build-time extract, parody-transform, atlas + index, depot publish, provenance).
   Target ~150–250 items each; reuse C's schema (already proven); C wires shelves.
4. **Patronage v0 scope (D)**: streamed peds occasionally path to an OPEN shop's door,
   pause, "enter" (despawn with a door-swing tell or fade), re-emerge after seeded dwell.
   No interior presence (interiors stay player-only this round), no queues. Respect hours
   (closed shops get no visitors; the openLate video shop gets night traffic).
5. **Audio stays parked** (needs John's sourcing decision — flagging it: one line from John
   unlocks street ambience + door bell, the V2_IDEAS "greenfield" item).
6. **Tag `v2.0-rc`** (F, end of round) when: weather + patronage + buy-v0 + ≥1 new pack
   landed and smoke-green, stock/weather smokes graduated strict, qa strict green. Same
   no-hostage rule: tag what landed, note what slipped.

## Process rules (unchanged)

- ONE shared working tree; stage only your files by exact path; options before `--`;
  `add` new files first; pin a durable lane ref; leave qa GREEN; progress doc + NOTES.
- F owns `web/index.html` + `tools/`; document call sites for F.
- `procityprogress.txt` / `settings.local.json` stay untracked; `pipeline/_stockpack/`
  and staging dirs are gitignored — keep build output out of the repo.
- Repo `/Users/m3ultra/Documents/procity`; GODVERSE at `~/Documents/dealgod`; dev `:8130`.

## Sequencing

```
B1 (weather, carried) ──────────→ D2 (weather-reactive crowds) ─┐
E1 (book/toy packs) ──→ C2 (wire shelves) ──┐                   │
C1 (buy loop v0) ── independent ─────────────┼──→ F1 (strict graduations + new smokes)
A1 (osm parity + 2nd town, carried) ─────────┘        └──→ F2 (tag v2.0-rc)
D1 (patronage, hours-based) ── independent of B
```
B and E start immediately (both feed others). C1 and D1 need nobody.

---

## Lane A (Citygen) — carried round-7 brief, unchanged

Execute ROUND7_INSTRUCTIONS.md §Lane A verbatim. Summary: (1) selfcheck parity for osm
plans (full invariant suite runs on both sources; F pins both goldens); (2) a second
fixture town (`?plansrc=osm&town=<key>`, checked-in module, zero network, golden pinned —
pick a small coastal/regional strip for contrast with inner-Melbourne); (3) the "add a
town" recipe in LANE_A_NOTES; (4) importer normalizes real-world data to the contracts
(exactly-one openLate etc.) and logs what it changed.

This brief has now slipped twice (R7; and R4–R5 for its predecessor). If a full session
isn't available, land ANY complete subset with a cut-line note — parity alone is a fine
round.

**Acceptance**: full selfcheck green on every (source, town); second town boots end-to-end
(or a documented cut); goldens pinned; qa green.

## Lane B (Streetscape) — carried round-7 brief: weather

Execute ROUND7_INSTRUCTIONS.md §Lane B verbatim. Summary: `?weather=1` — seeded per
(citySeed, day) state (clear/overcast/rain) exposed at `window.PROCITY.weather`; rain
particles (ONE draw), wet-ground response, matching sky dome from the existing set; wind
sway if cheap; ≤300 draws worst view; composes with winmap/night (rain-through-lit-window
screenshot); flag-off identical. Tram (`?tram=1`) remains the stretch, only after weather.

**New this round**: D consumes `window.PROCITY.weather` (decision #1) — expose it early
(even while polishing visuals) and document the shape in LANE_B_NOTES: at minimum
`{ state: 'clear'|'overcast'|'rain', intensity: 0..1 }`, stable per day segment.

**Acceptance**: as ROUND7 §Lane B, plus the documented `PROCITY.weather` contract; qa green.

## Lane C (Interiors) — buy loop v0 + wire the new packs

1. **C1 — buy loop v0** (decision #2, in the dig, works with parody AND real stock):
   seeded starting cash → HUD chip (street + interior); pulling the front sleeve and
   confirming buys it: cash decreases by the sleeve's price, sleeve leaves the bin (bin
   mesh updates — your batching keeps dug bins addressable, use that), inventory list on
   I. Broke = can't buy (a "not enough cash" tell). In-memory only; reload resets.
   Leak/determinism laws: world generation unchanged (purchases are runtime state);
   dig soak extended to buy 2 items per visit — no leaks, ≤350 draws.
2. **C2 — wire book spines + toy boxes** when E1's packs land: `?stock=real` extends to
   book/toy shelves through the same stockAdapter path (static shelf stock; digging other
   shop types is NOT this round). Fail-soft per pack (record pack present but book missing
   → records real, books parody).
3. Keep the pack schema doc current if E's new packs need any field additions.

**Acceptance**: buying works end-to-end in a dig (cash/HUD/inventory/bin-update), soak
green with purchases; book+toy shelves show real stock when packs present, fail-soft
otherwise; ≤350 draws; qa green.

## Lane D (Citizens) — the crowd comes alive

1. **D1 — shop patronage v0** (decision #4, independent of B): streamed peds occasionally
   select an OPEN shop within their chunk, path to its door, pause, despawn-with-tell,
   re-emerge after a seeded dwell. Hours-aware: closed = no visitors; night = the openLate
   video shop is the only draw. Deterministic per seed+time; budget-neutral (it's the same
   peds, different paths); leak-free (despawn/respawn through your existing lifecycle).
   Behind `?patronage=0` OFF-switch — patronage is default-ON for streamed rosters (it's
   crowd behavior, not a new system; the flags-off baseline may move a hair — coordinate
   the re-pin with F if draws shift, same protocol as the flip).
2. **D2 — weather reaction** (after B1 exposes `PROCITY.weather`): rain → density drops
   (~40–60%), walk speed up slightly, more peds choose shop doors (shelter patronage);
   clear → v1 behavior. Read the contract from LANE_B_NOTES; do not import B's modules.
3. Re-run the roster soak with patronage on (leak-free over the despawn/respawn cycles).

**Acceptance**: peds visibly enter/leave open shops day-long and cluster on the video shop
at night; deterministic + leak-free + budget-neutral; rain thins and redirects the crowd
(or documented as carried if B slips); qa green.

## Lane E (Assets) — pack kitchen

1. **E1 — book spines + toy boxes packs** (decision #3): same pipeline as the record pack
   (`build_stock_pack.py` — generalize it rather than copying), build-time extract from
   the GODVERSE datasets (bookgod/toygod per GODVERSE.md), parody-transform, ~150–250
   items each, atlas + index to C's schema, depot publish + local stage, provenance in
   AUDIT.md. Book spines are TALL-thin (different atlas cell aspect) — coordinate the
   cell geometry with C before baking.
2. **E2 — pack QA**: extend your provenance-drift gate (or add a small check) to validate
   pack indexes — every entry has atlas+UV in range, price band sane, no empty titles —
   so a bad bake fails qa instead of rendering blank sleeves.
3. **On-call**: B may want a rain-streak/puddle texture (procedural first, flux_local if
   truly needed — free); D may want a door-swing tell sprite (same rule).
4. No fal spends (broken-prop clause stands). Audio assets stay parked (decision #5).

**Acceptance**: two new packs live (depot + staged), indexes validate in qa, C consumes
them; pack-QA gate green; provenance logged; qa green.

## Lane F (Integration) — graduate, marshal, tag

1. **F1 — smoke graduations + additions**: `stock=real` and (when B lands) `weather=1`
   graduate warn → strict. New smokes at warn: buy-v0 (open dig, buy 1 item, assert cash
   decreased + bin count dropped, 0 errors), patronage (advance time, assert ≥1 ped
   despawns at an open shop door over N seconds), book/toy stock (enter book shop with
   `?stock=real`, assert real spine meshes), 2nd osm town if A lands (pin its golden).
2. **F2 — patronage default-on baseline**: if D1 moves the flags-off draws/tris beyond
   tolerance, re-pin with the same one-commit protocol as the flip (old values in the
   message). Plan goldens still frozen.
3. **F3 — tag `v2.0-rc`** (decision #6 criteria; no-hostage rule). Update flags table +
   runbook; note anything carried. Remind John of unpushed refs if any remain.
4. **Marshal**: B and A are on carried briefs — check for their commits mid-round; if
   either stalls again, note it in F-progress the moment you see it, not at tag time.

**Acceptance**: graduated smokes strict + green; new smokes running at warn; baseline
re-pin (if needed) done by protocol; `v2.0-rc` tagged on a green tree; runbook current.

---

*— Fable (integrator). The machine is built and strict; this round is about the town
feeling inhabited — rain on the awnings, peds ducking into shops, and walking out of a
dig with a record you paid for. Commit atomically, pin your refs, leave it green — and if
you must stop early, say where and why.*