# Engine
The ROGUE ICE rules engine (spec: `/zero/source/design/spec.md`, "Rules"). `Engine.new({ state, emit, touch, persist })` returns one game instance bound to a state table and an emitter; `game.rules.Director` binds the live one to `Core.state()` / `Core.emit` / `Core.touch` with persistence on, and balance simulations bind private instances with no-op emitters.
An instance answers every `Core.COMMANDS` name through `g.command(name, payload)` (returns `ok, reason`), and implements: the run (starter deck, seeded 3-act map from `game.rules.Season`, reachability, act progression, win/lose by 3 losses or bankruptcy); the card match (intro/faceoff, shifts with energy, hype and forecheck, SKATE draws, line of 3 skaters, equipment, buffs, puck zone and possession, shots vs goalie composure, block, opponent intents from `Core.TEAMS` with hits reducing them, periods, intermissions, sudden-death overtime and a shootout, goal/intermission/final pause steps advanced by `continue`); post-match economy (salaries, gate, sponsors, ads, win bonus, purse); off-ice sponsor / fans / broadcast events scored by pitch / fanScore / media / cha with an on-theme streak bonus and tiered rewards; the trade desk (cards, goalies, card removal); rewards (1 of 3, rarity weighted); achievements, Prestige and unlocks via `game.rules.Meta`. It emits every `Core.EVENTS` event with the spec's payloads and calls `touch` before each one.
Extra state fields beyond the spec, for presentation: `run.payroll`, `run.deckSize`, `run.stats`, `match.payout = {salaries, gate, sponsors, ads, bonus, net}` at the final whistle, `match.won`, `match.shots`, `match.shootout`, `event.tiers` (score thresholds), `event.done/tier/rewards` (result panel; `leave` or `continue` closes it), `event.plays`, `reward.money`, `result.reason/stats/money/fans`, `meta.hasSave` and `meta.bonuses` (start money/hype bought by Prestige).
`g.decide()` returns the next `(command, payload)` a sensible GM would send (the autoplay policy); `g.boot()` loads meta and shows the title. `Engine.TUNING` holds the balance numbers the spec leaves to the rules.
# Core
The shared contract of ROGUE ICE, a hockey roguelite deckbuilder. Every part of the game requires `game.Core` and talks to the others only through it.
- **Constants**: `PALETTE`, `FONTS`, `KIND_COLOR`, `RARITY_COLOR`, `HOME` (Frostbite HC), `RINK` dimensions, `ZONE_X` (puck lane to world X), `ANCHORS` (scene entity names), `SHOTS` (named camera poses), `SETS` (where the office set sits), `PHASES`, `MATCH_STEPS`, `COMMANDS`, `EVENTS`, `RULES`, `EVENT_TYPES`, `NODE_TYPES`, `CARDS` (+ `Core.card(id)`), `GOALIES`, `TEAMS` (+ `Core.team(id)`), `SPONSORS`, `ACHIEVEMENTS`, `ART_DIRECTION`.
- **State**: `Core.state()` is the live game; `game.rules.Director` is its only writer and calls `Core.touch()` (bumps `state.version`) after each change. `Core.reset()` restores a fresh state in place.
- **Bus**: `Core.on(name, fn, tag?)`, `Core.off(name, tag)`, `Core.offAll(tag)`, `Core.emit(name, payload)`, `Core.cmd(name, payload)` (= emit `"cmd."..name`). Tagged subscriptions replace themselves, so reloaded components never double-subscribe.
- **Live positions**: `Core.live.puck`, `Core.live.skaters`, `Core.live.focus`, written by the 3D match presentation.
- **Random**: `Core.seed(n)`, `Core.random()`, `Core.randomIndex(n)`, `Core.shuffle(list)` — one seeded stream per run.
- **Helpers**: `Core.rgba(hex, a)`, `Core.rgb(hex)`, `Core.money(n)`, `Core.compact(n)`.
The full contract (state shape, who writes what) is `/zero/source/design/spec.md`.
# Meta
ROGUE ICE meta progression, used by `game.rules.Engine` (behind the `game.rules.Director` component):
- `Meta.load()` / `Meta.save(meta)` — the persisted meta record `{ prestige, lifetimePrestige, achievements = {id=true}, unlocked = {cardId=true}, runs, cups, bestAct }` plus derived `hasSave` and `bonuses`, kept in runtime_data at `rogueIce/meta` in the local player's own store (the world store for an anonymous session).
- `Meta.saveRun(run)` / `Meta.loadRun()` — the in-progress run at `rogueIce/run`, so Continue resumes it in a later session; `saveRun(nil)` clears it.
- `Meta.recompute(meta)` — unlocks every card and goalie whose `unlock = { prestige = n }` is met by lifetime Prestige or `{ achievement = id }` by an earned achievement; returns the newly unlocked ids and refreshes `meta.bonuses` (start money/hype bought by lifetime Prestige).
- `Meta.cardAvailable`, `Meta.goalieAvailable`, `Meta.achievement(id)`, `Meta.conditionMet`.