seriesoftubes/docs/plans/pie-in-the-sky.md
Frederic Jung 9d74873edb
NOC tab and Pie Control tidied for phones: Pie Control in the NOC top row, traceroute in Routing & DDoS, government money in the bank
- NOC tab: Pie Control is a button in the top row next to "Open NOC dashboard" (only once the rocket
  company is unlocked) and replaces the Pie in the Sky card; a spat waiting for an answer keeps its card.
  The Connections button is gone (it lives in the NOC dashboard), and the traceroute moved into the
  Routing & DDoS modal as an entry that opens the unchanged traceroute modal.
- Government money (Rural Digital Pie Fund, Pitcairn grant, Ex-Im Pie Bank) is a section of the bank,
  shown with a rocket company or anything of the fund's to show. pieGovOpen, the action the toasts use,
  opens the bank there; pieTab({t:'gov'}) does too.
- Pie Control has four tabs (Traffic, Company, Launch, Dishes) in one segmented control that fits 360 px,
  styled like the HUD's speed buttons. The Founder's posts and the orbit books moved into the Company tab,
  newest three posts shown and the rest folded. A stale UI.pieTab of 'gov', 'book' or 'founder' falls back.
- Agent docs for pieGovOpen, pieTab, routingOpen and connOpen; the route fuzzer drops connOpen from the
  NOC tab on both pages to stay in lockstep with main.
- Tests: tests/noc-panel-layout.test.js, and the pie tests follow the moves.
2026-11-06 09:58:00 +01:00

7.4 KiB

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}, 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].