234 lines
15 KiB
Markdown
234 lines
15 KiB
Markdown
# PROCITY — Round 7 lane instructions (from Fable, integrator)
|
||
|
||
> **⚠ SUPERSEDED by [ROUND8_INSTRUCTIONS.md](ROUND8_INSTRUCTIONS.md) (2026-07-14).** Round 7 is
|
||
> complete — roster flipped to default, `?stock=real` live, harness strict, v2.0-beta tagged
|
||
> (`4feba02`). B (weather) and A (osm parity) slipped — round 8 carries both §Lane A and §Lane B
|
||
> verbatim; everything else is historical reference only.
|
||
|
||
Date: 2026-07-14 · Written after the Fable round-6 review (`6948372`) and the **v2.0-alpha
|
||
tag**. 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 `6948372` = `v2.0-alpha`. `tools/qa.sh
|
||
--strict` GREEN **5/5** (incl. the v2 flags harness at warn level). Four v2 flags live,
|
||
default-off: `?plansrc=osm` · `?winmap=1` · `?dig=1` · `?roster=stream`. Goldens: synthetic
|
||
`0x3fa36874`, osm `0x34cfdec0`. Interior law ≤350 draws/room (worst 313, sweep asserts).
|
||
27 procity GLBs live. fal balance ~$21.36. Tags `v1.0`/`v1.1`/`v2.0-alpha` await John's push.
|
||
|
||
## Theme: the flip round + the content firehose
|
||
|
||
Round 6 built the machinery; round 7 turns two keys:
|
||
|
||
1. **`?roster=stream` becomes the DEFAULT.** D's readiness memo says it's deterministic,
|
||
leak-free, hours-aware, and composes — gated only on one optimisation (the ped sub-mesh
|
||
merge, so full density fits the draw budget). E merges, D validates, F flips.
|
||
2. **Real stock enters the dig** (the reason this system exists — V2_IDEAS #1, deferred
|
||
twice): a curated GODVERSE content pack feeds C's `stockAdapter` behind `?stock=real`,
|
||
so the crates you riffle hold *real* record sleeves instead of parody canvas.
|
||
|
||
Plus: the flags harness graduates **warn → strict**, B ships weather, A hardens osm mode.
|
||
End-of-round milestone: **`v2.0-beta`** (F tags; criteria in decision #6).
|
||
|
||
## Prime-law amendment (read carefully — the baseline moves this round)
|
||
|
||
The v2 prime law ("default boot stays v1-identical") gets its first **deliberate,
|
||
versioned** exception: when F flips the roster default, the default boot changes. Protocol
|
||
(decision #1): the flip commit and the flags-off-baseline re-pin happen in ONE F-owned
|
||
commit, with the old baseline recorded in the commit message. **Plan goldens do NOT move**
|
||
(`0x3fa36874` / `0x34cfdec0` — the plan layer is untouched by the roster). Any other lane
|
||
whose feature would move the default boot: that's still a land-blocker — the exception is
|
||
the flip only.
|
||
|
||
## Integrator decisions (so nobody blocks)
|
||
|
||
1. **Roster-flip protocol**: E1 (sub-mesh merge) → D1 (validate + full-density numbers) →
|
||
F1 (flip default; keep `?roster=v1` as the escape hatch back to the fixed roster;
|
||
re-pin the flags-off draws/tris baseline in the same commit). Order is strict — no lane
|
||
pre-empts the flip.
|
||
2. **Real-stock scope**: read-only content, NO economy backend. E builds the pack offline
|
||
from GODVERSE (`~/Documents/dealgod/GODVERSE.md` — recordgod's 185k vinyl w/ images is
|
||
the target): curate ~200–400 sleeves per record-shop archetype (+ optional small packs
|
||
for book/toy if cheap), bake into atlas textures + a JSON index (id, title, artist,
|
||
price band, atlas UV), publish atlases to the depot like any asset. C consumes behind
|
||
`?stock=real` through the existing `stockAdapter` seam. Buying stays a stub. `?noassets`
|
||
and flag-off behavior untouched. **No runtime network beyond the existing depot path;
|
||
no databases; nothing from GODVERSE checked into the repo except the built pack index
|
||
if it's small.** Parody-name law: run titles/artists through the same
|
||
no-real-trademarks screen as everything else — if the source data is real-world
|
||
metadata, parody-transform it in the pack builder (deterministic).
|
||
3. **Weather is B's round**, behind `?weather=1`: seeded per-day weather state (clear /
|
||
overcast / rain), rain particles + wet-ground response, wind sway on awnings/trees if
|
||
cheap. The sky domes for it already exist in `web/assets/gen/`. Tram loop is a stretch
|
||
goal ONLY if weather lands early (`?tram=1`, instanced, one path over B's bus_shelter
|
||
stops, no traffic sim).
|
||
4. **Harness graduates to strict** (F, after the flip lands): a red flags-harness now
|
||
fails qa.sh. New flags this round (`stock`, `weather`, `tram` if it lands) enter at
|
||
warn and graduate next round.
|
||
5. **fal**: no new spends. Broken-prop re-gen clause (≤2 attempts, logged) still stands.
|
||
6. **Tag `v2.0-beta`** (F, end of round) when: roster default-on + escape hatch verified ·
|
||
flags harness strict + green · `?stock=real` riffles real sleeves in a record shop ·
|
||
`?weather=1` rains · qa strict green. If stock OR weather slips, tag anyway with what
|
||
landed and note it — same no-hostage rule as always.
|
||
|
||
## Process rules (unchanged)
|
||
|
||
- ONE shared working tree. `git status` first; stage only your files by exact path;
|
||
options before `--`; `add` new files first; commit immediately; pin a durable lane ref.
|
||
- Leave `qa.sh --strict` GREEN. Update `<X>-progress.md`; cross-lane asks in your NOTES.
|
||
- F owns `web/index.html` + `tools/`; document call sites for F.
|
||
- `procityprogress.txt` / `settings.local.json` stay untracked.
|
||
- Repo `/Users/m3ultra/Documents/procity`; GODVERSE reference `~/Documents/dealgod`;
|
||
dev server `:8130`.
|
||
|
||
## Sequencing
|
||
|
||
```
|
||
E1 (ped sub-mesh merge) ──→ D1 (validate + density numbers) ──→ F1 (FLIP + re-pin baseline)
|
||
E2 (GODVERSE stock pack) ──→ C1 (?stock=real in the dig) ──────→ F2 (strict harness + new smokes)
|
||
B1 (?weather=1) · A1 (osm parity + 2nd town) ── parallel ──────→ F3 (tag v2.0-beta)
|
||
```
|
||
E has both feeder tasks — start E1 immediately (it gates the flip), E2 right after.
|
||
F1 lands before F2 (strict) so the baseline only re-pins once.
|
||
|
||
---
|
||
|
||
## Lane A (Citygen) — osm mode to parity + a second town
|
||
|
||
The Melbourne import works; make osm a first-class citizen, not a demo.
|
||
|
||
1. **Selfcheck parity**: parameterize the full selfcheck suite by plan source so osm plans
|
||
get the same invariant coverage as synthetic (lots/shops integrity, hours contract,
|
||
exactly-one openLate, storeys ranges, determinism, <100ms). Wire so `qa.sh` runs both
|
||
(F already pins both goldens — extend the checks behind them).
|
||
2. **A second fixture town**: extract another AU town from the thriftgod cache (different
|
||
scale/shape than inner-Melbourne — a smaller coastal or regional strip is ideal) →
|
||
`?plansrc=osm&town=<key>`. Same laws: checked-in module fixture, zero network,
|
||
deterministic, pinned golden per town (give F the hashes).
|
||
3. **Document the "add a town" recipe** in LANE_A_NOTES (fixture extraction → module →
|
||
golden pin) so future towns are mechanical.
|
||
4. Watch for: osm towns must satisfy the SAME downstream contracts (openLate exactly-one,
|
||
registry types, hours sanity) — if a real town's data fights a contract, the importer
|
||
normalizes it (and logs what it changed), the contract doesn't bend.
|
||
|
||
**Acceptance**: full selfcheck green on every (source, town); second town boots end-to-end;
|
||
recipe documented; both plan goldens unchanged, new town's golden pinned; qa green.
|
||
|
||
## Lane B (Streetscape) — weather
|
||
|
||
`?weather=1` (decision #3). Seeded, deterministic, cheap.
|
||
|
||
1. **Weather state**: seeded per (citySeed, day) — clear / overcast / rain (weights feel
|
||
AU-plausible). Expose `window.PROCITY.weather` for other lanes (D may thin crowds in
|
||
rain later; not this round).
|
||
2. **Rain**: a particle layer (instanced/points, ONE draw), audible-later, camera-following;
|
||
wet ground = roughness/darkening response on street surfaces; puddle sheen if cheap.
|
||
Sky: pick the matching dome from the existing `sky-*.jpg` set (summer storm / grey
|
||
drizzle are already in `web/assets/gen/`).
|
||
3. **Wind**: subtle sway on awnings + trees during overcast/rain if it fits the budget —
|
||
vertex-shader time offset, not per-frame CPU.
|
||
4. **Budget + composition**: worst view ≤300 draws with weather on; works with winmap
|
||
(rain outside a lit window is the money shot — screenshot it), night, and interiors
|
||
(rain audio/visual stops inside; interiors are separate scenes so mostly free).
|
||
5. **Stretch ONLY if 1–4 land early**: `?tram=1` — one instanced tram/bus on a seeded
|
||
main-street loop over your bus_shelter stops, door-stop pause at each. No traffic sim.
|
||
|
||
**Acceptance**: `?weather=1` deterministic per seed/day; rain + wet ground + matching sky
|
||
render; ≤300 draws; composes with winmap/night; flag-off identical; screenshots (incl.
|
||
rain-through-window); qa green.
|
||
|
||
## Lane C (Interiors) — real sleeves in the crates
|
||
|
||
`?stock=real` (decision #2). The stockAdapter seam you built in v1 finally eats.
|
||
|
||
1. **Define the pack contract with E** (you own the consumer side): what the JSON index +
|
||
atlases must provide per item (title/artist/price-band/atlas+UV). Put the agreed schema
|
||
in LANE_C_NOTES *first* so E builds against it — a half-day handshake beats a rework.
|
||
2. **Consume**: when `?stock=real` and the pack is available (depot or `?localdepot=1`),
|
||
record-shop bins draw sleeves from the pack (seeded pick per bin — same seed, same
|
||
crate contents) instead of parody canvas; the dig riffle shows real covers + pack
|
||
titles/prices; the pull-out card shows title/artist/price.
|
||
3. **Laws**: deterministic per shop.seed · leak-free (atlas textures dispose with the room
|
||
or share via the loader cache — prove with the soak) · ≤350 draws (atlas = the sleeves
|
||
stay batched; assert via drawSweep) · `?noassets` and flag-off untouched · fail-soft
|
||
(pack missing → parody canvas, warn once).
|
||
4. **Extend the dig soak**: `?dig=1&stock=real` enter/riffle/exit × N rooms, zero leaks,
|
||
determinism.
|
||
5. If E's pack covers book/toy too, wire those shelves as a bonus — record shops are the
|
||
acceptance bar.
|
||
|
||
**Acceptance**: riffling a bin with `?stock=real` shows real (parody-screened) sleeves with
|
||
titles/prices, deterministic + leak-free + ≤350 draws; fail-soft proven; contract doc'd;
|
||
qa green.
|
||
|
||
## Lane D (Citizens) — validate the merge, hand F the flip
|
||
|
||
1. **D1 — validate E1's merged peds** (the flip gate): rigs bind + animate (walk/idle),
|
||
silhouettes/materials intact, impostor bake clean, identity variety preserved. Then the
|
||
numbers: draws-per-near-rig before/after, worst-view draws/tris at FULL density
|
||
(`?roster=stream`, no reduced-density concession), 30-chunk soak leak-free. Write the
|
||
go/no-go into LANE_D_NOTES with the exact figures — F flips on your word (decision #1).
|
||
2. **Full-density defaults**: with the merge in, set the stream path's density/near-cap
|
||
defaults to the values your memo said full density needs — these become the shipping
|
||
defaults when F flips.
|
||
3. **Post-flip verification** (after F1 lands): default boot runs the streamed roster —
|
||
re-run your determinism + far-field-density + leak checks on a NO-FLAG boot; verify the
|
||
`?roster=v1` escape hatch actually restores the fixed roster.
|
||
4. Do NOT start rain-behavior/schedules/queues — crowds react to weather in a later round.
|
||
|
||
**Acceptance**: merged peds validated with published numbers; go/no-go memo written; after
|
||
the flip, no-flag boot passes your full check suite; escape hatch verified; qa green.
|
||
|
||
## Lane E (Assets) — the two feeders
|
||
|
||
Both critical-path. E1 gates the flip; E2 gates the stock. In that order.
|
||
|
||
1. **E1 — ped sub-mesh merge (START IMMEDIATELY).** Per-ped GLBs carry multiple
|
||
primitives/materials → multiple draws per near rig. Merge to (ideally) ONE primitive +
|
||
one atlased material per ped: gltf-transform `join`/`palette`/`instance` pipeline —
|
||
**preserving skinning (joints/weights), morphs if any, and compatibility with the shared
|
||
walk/idle clips**. Backup originals (gitignored), process all 19, verify each loads +
|
||
binds in the vendored GLTFLoader, record before/after draws+tris in AUDIT.md, hand to D.
|
||
2. **E2 — the GODVERSE stock pack.** Build `pipeline/build_stock_pack.py`: read recordgod
|
||
data from `~/Documents/dealgod` (fixture-extract like A's pattern — the pipeline reads
|
||
the local dataset at build time; NOTHING queries it at runtime), curate 200–400 sleeves
|
||
(image quality + variety), **parody-transform titles/artists deterministically** (the
|
||
no-real-trademarks law applies to metadata too), bake atlas PNG/WebPs + JSON index to
|
||
C's schema (wait for C's contract note — it's their task 1), publish atlases to the
|
||
depot, stage for `?localdepot=1`. Provenance in AUDIT.md (source dataset, count,
|
||
transform). Small packs for book spines / toy boxes only if the record pack lands early.
|
||
3. **On-call**: B may want a rain-streak sprite or puddle texture (procedural first —
|
||
generate only if truly needed, flux_local, free).
|
||
|
||
**Acceptance**: E1 — all peds single-draw (or documented floor), skinned + animating, D
|
||
signs off; E2 — pack published + staged, index validates against C's schema, parody screen
|
||
run, provenance logged; qa green (incl. your own provenance-drift gate).
|
||
|
||
## Lane F (Integration) — flip, tighten, tag
|
||
|
||
1. **F1 — the roster flip (after D1's go).** In `web/index.html`: streamed roster becomes
|
||
default; `?roster=v1` restores the fixed roster; `?roster=stream` stays accepted (now a
|
||
no-op). **Same commit**: re-pin the flags-off regression baseline (draws/tris snapshot)
|
||
to the new default boot, old values in the commit message (prime-law amendment). Plan
|
||
goldens untouched. Then boot no-flags + escape hatch and eyeball both.
|
||
2. **F2 — harness to strict (after F1).** Flags harness failures now fail qa.sh. Add
|
||
smokes for the new flags as they land: `stock=real` (enter record shop, open dig,
|
||
assert non-parody sleeve count > 0), `weather=1` (boot, assert particle layer + wet
|
||
response active, 0 errors), `tram=1` if B ships it. New flags enter at warn (decision
|
||
#4), existing four + flags-off are strict.
|
||
3. **F3 — tag `v2.0-beta`** (decision #6 criteria): summary tag message with the flip
|
||
baseline note; update flags table + runbook + F-progress. Local; John pushes (remind
|
||
him v1.0/v1.1/v2.0-alpha are also still unpushed).
|
||
4. **Marshal**: this round has two hard sequams (E1→D1→F1, E2→C1) — if a lane stalls,
|
||
flag it in F-progress early rather than at round end. The R5 lesson (silent no-show)
|
||
now has a harness for code, but not for schedule — you're the schedule harness.
|
||
|
||
**Acceptance**: default boot = streamed roster with re-pinned baseline + working escape
|
||
hatch; harness strict + green with new-flag smokes; `v2.0-beta` tagged on a green tree;
|
||
runbook/flags table current.
|
||
|
||
---
|
||
|
||
*— Fable (integrator). Two keys turn this round: the town gets permanently busier, and the
|
||
crates get real. Both have hard sequencing — respect the arrows, commit atomically, pin
|
||
your refs, leave it green.*
|