- Every 60 to 120 days while a rocket company exists (the first 90 days after the plan starts), the Founder does something daft: a post, a gasp toast and a temporary effect (99-pie-jitters.js). A once-a-game antic takes orbit billing down for 3 to 5 days (no orbit income, then a restore post); a 3 a.m. spree (orbit offers x0.6 and a 4-point orbit mood dip for 14 days); a fight with a regulator (a landing-rights spat via pieSpatStart in a country with a dish or rights, within the spat limit); a leaked launch date (insurance 8% -> 14% for 30 days); Mars next year (offers x1.5 for 14 days, a promise like the others whose slip cancels the unhappiest 2% of orbit customers). - Market jitters (S.pie.founder.jit, 0..1): each antic bumps it, it fades by 1/30 a day, and while high it lowers orbit offer odds (up to -30%) and holds orbit happiness under 100-25*jit (never low enough to cancel at renewal). The Company tab shows one line and a small meter next to the feed. - Rule O5: harm only with pieChaos(); with chaos off he only posts. Dice only with a company. - Saves: new founder fields in pieBlank, repaired in pieSanitize (pieAnticFix); old saves load calm. - Insurance button shows the current premium (pie.ins_on_p replaces pie.ins_on). Agent docs updated. - pie-balance: compute() also reruns when orbit billing goes down or comes back. - tests/pie-founder.test.js: each antic, decay, once-only billing outage, chaos off, saves, 360 px.
120 lines
7.5 KiB
Markdown
120 lines
7.5 KiB
Markdown
# Pie in the Sky (implementation spec)
|
|
|
|
Local branch `pie-in-the-sky`. Never push. Commit as `Frederic Jung <frederic@jc-ix.net>`, no attribution
|
|
trailers (CLAUDE.md). Full design doc lives in Claude Docs; this file is the contract for the code.
|
|
|
|
## What it is
|
|
|
|
The endgame for players who just became Tier 1 in a save started on this version (and sandbox from day 0):
|
|
found a rocket company, launch thousands of satellites ("pies") into shells ("crusts"), build dedicated
|
|
base stations ("pie dishes") everywhere, and connect them with your own backbone. Obscenely expensive.
|
|
Satirical tone: a cartoon Founder (no real person) who breaks every promise by a year; a press office that
|
|
calls every failure a success. All names are puns (rule N2); add each real name riffed on to `REAL_NAMES`.
|
|
|
|
## Gate (rule O1)
|
|
|
|
- `newGame()` sets `pieV:1, pie:null`. `sanitize()`: missing `pieV` -> 0, so old saves never get it.
|
|
- Unlock fires only on the transition in `checkGoals()` where `g.win&&!S.won` flips `S.won`, when `S.pieV>=1`.
|
|
- Sandbox (`gatesOpen()` / open gates): available from day 0, real prices, `book.wouldHave` shame counter.
|
|
- Losing Tier 1 (`!(S.won&&isTier1())`): everything keeps working; no new launches, dishes, factory orders.
|
|
- Never in puzzles, Architect, scenarios, weekly challenge.
|
|
|
|
## State
|
|
|
|
```
|
|
S.pieV
|
|
S.pie = null | {born, co:{name}, fac:bool, rd:{reuse:bool,heavy:bool,heavyTests:int},
|
|
pads:[{city,next,boosters:[{id,flights}]}],
|
|
crusts:{short|frozen|upper|flaky:{cohorts:[{n,day,las}], queued}},
|
|
dishes:[{id,city,ant,down}], lic:{[cc]:{state,until}}, q:[launches],
|
|
founder:{posts:[...last 20], promises, broken, due, jit, next, kid, bill, nerv, hype, leak, mars}, (antics: 60-features/99-pie-jitters.js) book:{spent,earned,wouldHave},
|
|
spat:{...active geopolitical spats}, safe:bool}
|
|
```
|
|
Pies are cohorts, never one object per satellite. `sanitize()` clamps all of it.
|
|
|
|
## Catalog (`src/game/10-catalog/70-pie.js`), all prices x `PIE_MUL` x `hwMul()`
|
|
|
|
| Item | One-off | Running |
|
|
| --- | --- | --- |
|
|
| Found company | $250M | $5M/mo |
|
|
| Pie factory | $1B | $8M/mo, 120 pies/mo |
|
|
| Pie | $0.5M (+$0.25M lasers) | - |
|
|
| Launch pad (coastal/beach city with a POP) | $400M | $2M/mo, equatorial -15% per launch |
|
|
| Falcon Punch launch | $60M, 20 pies | - |
|
|
| Reuse R&D (Falcon Punch Again) | $500M; launch $30M; booster lost $40M | - |
|
|
| Heavy R&D (Starshipping & Handling) | $3B; $100M/launch, 100 pies, first 3 test flights explode | - |
|
|
| Insurance | 8% of launch, optional | - |
|
|
| Pie dish (city with a POP) | $25M + $2M per antenna | $300k/mo |
|
|
| Landing rights | $10M-$100M per country by market size | yearly |
|
|
| LEO-IX port | $50M | $1M/mo |
|
|
| Founder launch party | $2M per launch, automatic | - |
|
|
|
|
Crusts: short 550 km / 1584 full / |lat|<=53; frozen 560 km / 520 / polar; upper 1100 km / 1200 / |lat|<=60;
|
|
flaky 340 km / 2500 / dense cities, life 3y. Life 5y otherwise. Coverage < 60% = half-baked: carries 0 under 40%, then a share growing to all of it at 60% (pieCarry). Pies wear out over the last 30% of their life, a few a day (pieAlive), not a whole launch month at once.
|
|
|
|
## Routing (rules O2-O4)
|
|
|
|
Crust > 40% = virtual hub (capacity pieCap = g x coverage x carry). Live, licensed, connected dish <-> hub edge: latency (alt up+down)/c + 2 ms.
|
|
With lasers: hub-to-hub along great circle at c (vacuum). Capacity = min(crust cap x coverage,
|
|
antennas x Gbps x rain). Orbit never beats fiber under ~3000 km. Graph grows by dishes + crusts only.
|
|
Dishes with no path to the backbone carry no transit (O3), but backhaul their own POP: all its traffic (eyeballs, customers,
|
|
circuits) goes up its dish and down at a landing dish on the backbone (bent pipe <= 1,000 km, lasers past that). Capacity =
|
|
min(cut-off dish's room after terminals, landing dish's room, crust's room); latency = the orbit path. Spats, safe mode, a
|
|
down crust, landing rights or a backhoe cut it. Must not slow `compute()` for saves without pies.
|
|
|
|
## Customers
|
|
|
|
`pizza` (homes/boats), `flywifi` (airlines, latency), `boat` (cruise). `mars` gets an orbit option only
|
|
in `pieV` saves. Remote cities (Pitcairn, Arctic) servable from orbit.
|
|
|
|
## Incidents (`rule('chaos')`, quiet 90 days after unlock)
|
|
|
|
Rapid Unscheduled Disassembly, booster falls over, solar storm (safe mode), food fight (debris, rare,
|
|
Space Roomba fix), rain fade, backhoe at the dish, astronomers (VisorSat), Founder posts at 3 a.m.,
|
|
chaos monkey snips a laser link.
|
|
|
|
## Geopolitical spats (cartoon, even-handed, countries as data, never real leaders)
|
|
|
|
Reuse the existing sanctions / sovereign-drill / China licence machinery where it fits.
|
|
- Landing rights: each country licenses separately; big markets cost most; some refuse for a while.
|
|
- Data stays home: a country requires an in-country pie dish for its customers.
|
|
- Spectrum squabble: two neighbours both want the same band; pick a side, the other closes for 180 days.
|
|
- Kill switch, please: a government wants an off switch during "national exam week"; comply (customer
|
|
mood drop) or refuse (licence suspended 90 days).
|
|
- Orbital land grab: a rival constellation's home regulator files first; your next crust costs more.
|
|
- Jamming near a border: capacity over a region drops for some days.
|
|
- Launch diplomacy: a country offers a subsidised pad if you build 3 dishes there.
|
|
- Not over my airspace: two countries each demand their traffic avoid the other's dishes.
|
|
Each spat is a notification with 2 choices; outcomes deterministic per seed.
|
|
|
|
## Government money (`60-features/99-pie-subsidies.js`, a section of the bank)
|
|
|
|
- Rural Digital Pie Fund: reverse auctions for towns only orbit reaches (a cut-off POP on backhaul, or a small town of
|
|
your terminal customers). You ask 90%, 70% or 50% of the reserve; a rival asks 40-100%; the lower ask wins and is paid
|
|
monthly for 5 years. From a 90-day deadline the town's service, averaged per month, must stay at 70%, or the award is
|
|
revoked and half of what it paid is clawed back. Counts in `book.earned`.
|
|
- Ex-Im Pie Bank: a BANKS loan (never offered by the usual banks) of half the value of the pies flying and booked, at most
|
|
20% of a full Shortcrust (O7 counts it), 1.5-2.5% over 60 months. Covenants: launch n pies in a year, keep a dish in the
|
|
lending country. A breach: the bank's penalty, +3 points, the launch deadline moved, and with chaos a spat there
|
|
(`home` or `lic`). Off the books: financing, not orbit income.
|
|
- Pitcairn: served from orbit (its POP on backhaul, or home terminals there) at 90% of its demand, latency forgiven, the UK
|
|
pays `GRANT_SKY_MO` instead of `GRANT_MO`. Counts in `book.earned`.
|
|
|
|
## Visualisation: a separate animated 3D globe
|
|
|
|
Satellites are NEVER drawn on the existing map (no cost there). The map only gets static pie dish icons
|
|
at POPs, drawn with the existing city layer. Satellites live on an animated 3D globe (orthographic
|
|
projection on a 2D canvas, no WebGL, no library) inside the Pie Control panel, rendered only while it is
|
|
open, paused when hidden, capped frame budget, fewer dots on phones. Final look is chosen from mockups.
|
|
|
|
## Rules O1-O7 (`gameplay-rules` skill + tests)
|
|
|
|
O1 gate, O2 half-baked carries nothing / capacity <= dishes, O3 disconnected dish no transit, O4 vacuum
|
|
latency, never beats fiber < 3000 km, O5 chaos + 90 quiet days, O6 rideshare <= demand,
|
|
O7 fresh Tier 1 cannot afford a full Shortcrust in year 1; full constellation never pays back < 5 years.
|
|
|
|
## Every change
|
|
|
|
Translated strings via `scripts/i18n-add.js` (0/0/0), sanitize, phones first, a seeded test
|
|
(`tests/pie-in-the-sky.test.js` and friends), perf vs `main` (`npm run perf -- --base-ref main`) must not
|
|
get worse, CHANGELOG bullet under `## [Unreleased]`.
|