PROCITY/docs/V7_THE_GAME.md

PROCITY v7 — THE GAME (epoch charter — RATIFIED by John, 2026-07-17)

(Ratified as drafted; the fantasy stands. R30 opens the epoch — v7.0-alpha wave 1.)

Fable (m3), 2026-07-17. From THE_FRONTIER's headline gap: the world is built, the game isn't. v7 is the smallest set of systems that makes a stranger play twice. Design principle: every system below rides machinery that ALREADY EXISTS — nothing here invents a new world layer.

The fantasy, one line

You're a crate-digger in 90s Australia: build the collection, learn the prices, work the towns — and be home in time for the gig.

The loop

Wake (save point) → plan the day (shops shut per their real hours; the gig starts at night — the clock finally matters) → dig shops, spot the gems (priced below the guide), spend scarce cash → sell the flips (keeper today; the auction tomorrow) → sleep = save, the day advances, stock rotates → the collection grows → the wantlist points at another town → travel costs a day. Repeat, richer and one gem wiser.

The systems (each with its existing foundation)

1. PERSISTENCE — the foundation stone. Save = THE DELTA ONLY: cash, owned items, town, day number, wantlist, stats. The world is never saved — it regenerates from seed (the seeded-everything law finally pays its biggest dividend: saves are tiny and can't corrupt the world). localStorage, schema-versioned, JSON export/import for moving machines. Foundation: item identity is already stable — parody items are seeded, real/mint carry skus (the R25/R26 sku fences were built for exactly this, before we knew it).
2. THE COLLECTION. Your crate, as a UI: cover, title, artist, price paid, where and what day you found it. The trophy case of the whole game. (A walkable home-room shelf is v7.x — UI first.) Foundation: the atlas indexes already carry every field the card needs.
3. THE GUIDE + THE GEM (the thrill loop). An in-game price guide — thriftgod's BIBLE concept — gives a VALUE BAND per item (imperfect, like the real 90s guide books). Shops price with seeded variance around it → a gem is an item priced under its band. Skill = spotting them. Foundation: mint() gem/price bands exist as data and drive nothing; real items have real dealgod prices; the dig card already shows asking price.
4. SELLING — where cash comes back. v7.0-alpha: sell to a keeper at the counter (below guide, always — the no-money-pump law). v7.0: GodBay — list an item, a SEEDED offline auction resolves NEXT DAY (the come-back-tomorrow hook; thriftgod's auction brain, G's lane, offline tier first per the proven tier-ladder pattern — a live tier is v7.x and rides the G3 rails).
5. THE DAY. Sleep advances the day; stock rotates per (shop, day) — seeded, so day 3 in Bendigo is the same for every player on that seed (parody/mint rotate; the real shop's real stock stays real); gigs already run a 7-night week — day % 7 plugs straight in; hours already exist — now closing time costs you something. Foundation: the segment spine, isOpen, and plan.gigs are all sitting there waiting.
6. THE WANTLIST + TRAVEL. Mark items/artists you're hunting; seeded rumors surface hints ("saw one in Castlemaine" — a keeper line, a gig-crowd mutter: D's citizens finally gossip for a reason); travel costs a day → 23 towns become a strategy map instead of a dropdown. Foundation: the selector, the pack, the personas.
7. THE FIRST FIVE MINUTES. You arrive with $50 and a want. Three toast-beats: dig, buy, sell. A real splash. (Smallest system, biggest stranger-facing payoff.)

The stages

• v7.0-alpha — THE SAVE AND THE CRATE: persistence + collection UI + sell-to-keeper + sleep/day cycle + stock rotation. ONE town plays as a complete (small) game.
• v7.0-beta — THE THRILL: the guide bands + gem variance + wantlist + rumors + travel costs a day. The 23 towns become the map.
• v7.0 — THE AUCTION: GodBay offline tier, onboarding, the tour ("day one to first gem" as the money shot), docs freeze, tag.

The laws (new ones this epoch earns)

1. The delta law: a save NEVER contains world state — only player deltas. A corrupted save can cost you your stuff, never the town.
2. The no-pump law: every sell price < the buy-side guide band, structurally. The economy gets a GATE (an agent plays N seeded days and asserts net-worth growth is bounded by finds, not arbitrage loops).
3. Game money is game money: the write-back law extends — no bridge to real money, ever, in either direction.
4. Classic stays pure: ?classic=1 boots the v2 town with NO game layer (no save, no HUD additions) — the covenant is untouched. The game layer defaults ON for normal boots (the v3.1 flip precedent) with ?game=0 as the opt-out.
5. Rotation is seeded: stock rotation draws from (citySeed, shopId, day) — deterministic, gate-checkable, same for everyone on a seed.

Lane map (first cut)

F the save core + gates (delta law, no-pump gate, save/load determinism) · B the UI surfaces (collection, wantlist, day clock, splash — hud.js territory) · C the counter sell interaction + dig-card guide hints (+ the home room, v7.x) · A the day/rotation seeding contracts (new sub-streams, goldens untouched — rotation rides runtime, not plan gen... A verifies that boundary) · E guide-band data baked into packs/atlases (mint bands, real prices) · D rumor lines through keepers/citizens · G GodBay (the auction brain, offline seeded tier) + real guide prices from dealgod.

Risks (named now, v4-style)

1. Economy balance — pumps, dumps, degenerate flips. The no-pump gate is the fence; a playtest-bot (an agent that greedily arbitrages for N days) is the adversarial verifier.
2. Save schema drift — versioned from day one, migration-or-reject, never silent.
3. Item identity across re-emits — a re-baked atlas must not orphan owned items (the sku IS the identity; E's validator grows an owned-item stability check).
4. Scope gravity — the game wants everything (housing! romance! a phone!). The stage gates are the fence: alpha ships ONE town playing well before beta touches 23.
5. v6 collision — none by design: v7-alpha is systems/UI (F/B/C-heavy); v6's spikes are clips/ultra (E/D/G-heavy). They interleave; Fable sequences the rounds.

Sequencing

v7.0-alpha can start now — it's unblocked (v6 waits on footage; the two don't collide). Recommended: R30 = v7.0-alpha wave 1 (F save core + B collection UI + C sell counter contracts first). John ratifies this charter (or amends the fantasy — it's your shop, your era, your game) and says go.