GeoPolity — SP2 homage (full-world tick)

name: GeoPolity SP2 Homage overview: Build an original, open-source SuperPower 2–inspired full-world geopolitics sim (~200 AI countries, provinces, wars, treaties) as a new Novolis.Geopolitics package family plus a thin Spectre dogfood UI — no SP2 extract, SDK, or assets. todos:

• id: scaffold-repo

content: "Scaffold novolis-geopolitics: Core, Simulation, Unit tests, GeoPolity Spectre app, README/IP note, nuget.config (nuget.org + GPR only)" status: completed

• id: core-model

content: "Implement WorldState: polities, provinces, adjacency, ownership, relations, treaties, wars, military domains, events" status: completed

• id: world-seed

content: Add embedded ~200-country / ~1k-province seed JSON + loader + attribution (public-domain derived, not SP2) status: completed

• id: tick-pipelines

content: "Day/month Advance pipelines: budget, combat on contested edges, treaty rules, relation drift" status: completed

• id: ai-controllers

content: Seeded AI agendas for all polities (war/peace/alliance/build) with deterministic heuristics status: completed

• id: geopolity-bridge

content: Spectre Live UI + --headless --years N report; speed keys; register solution status: completed

• id: tests-smoke

content: Unit tests for ownership/war/treaty invariants + 50-year headless smoke status: completed

• id: platform-map

content: "When packable: regen Platform slnx map; publish path via CI/GPR (no local feed)" status: completed isProject: false

Locked decisions

• Homage only: no SuperPower 2 install path, SDK, GDB, textures, or string tables. Inspiration is pillar-level (countries, regions, military, diplomacy, economy), not parity.
• MVP loop: full-world day/month tick with ~200 AI polities; thin Spectre Live + --headless report (NearSolPolity pattern), not a Raylib globe.
• Package family: new orthogonal repo `d:\novolis\novolis-geopolitics` — not under Novolis.Simulation.* (spatial stack) and not inside Economy (diplomacy/combat are explicitly out of Economy Core boundary).
• Economy coupling: MVP uses lightweight polity scalars (treasury, tax, military budget, stability). Do not run EconomySimulation.AdvanceAsync for all 200 nations. Optional later bridge: player nation ↔ Novolis.Economy.*.
• World data: embed original seed JSON (~200 countries, ~800–1200 provinces, adjacency, starting armies/GDP priors). Generate once from public-domain Natural Earth (or equivalent) offline; commit only the compact Novolis seed + attribution — never SP2 DATABASE.GDB.

Architecture

flowchart TB
  subgraph pkgs [novolis-geopolitics]
    Core[Novolis.Geopolitics.Core]
    Sim[Novolis.Geopolitics.Simulation]
    Core --> Sim
  end
  subgraph app [dogfood GeoPolity]
    Seed[WorldSeed JSON]
    Bridge[Spectre Live / headless]
    Seed --> Bridge
    Sim --> Bridge
  end
  Bridge -->|"pulse N days"| Sim

Turn model (MVP):

1. Day tick: relation drift, mobilization/attrition, war front resolution on contested edges, treaty expiry checks, event log append.
2. Month tick: budget (tax in → military/civ out), research/tech level +1 progress (simple), AI agenda (war / peace / alliance / build).
3. AI: deterministic seeded heuristics per polity (power ratio, neighbor threat, alliance obligations) — no ML.

Package layout

Register packable projects in Platform slnx via `d:\novolis\novolis-governance\build\Generate-Platform-Slnx.ps1` when ready to publish 2026.1.* to GPR. Until first publish, dogfood may use ProjectReference only through Platform slnx / local ProjectRef mode — never sibling hacks in committed consumer csproj for cross-repo; for brand-new unpublished packages, keep the dogfood app in the same repo initially or develop against Platform ProjectRef mode after map regen.

Pragmatic MVP wiring: put Core + Simulation + tests + dogfood host all under novolis-geopolitics for the first shippable loop (same-repo ProjectReference is fine). Add a thin pointer app under dogfooding later once packages hit GPR — optional follow-up.

Dogfood UI

Path: `d:\novolis\novolis-geopolitics\apps\GeoPolity` (Spectre.Console Live).

Mirror `NearSolPolity/Program.cs`:

• Live: year/day, active wars, top-10 power, last N events, speed keys
• --headless --years 50: print war count, ownership churn, insolvency, treaty totals
• No Inter/purple SaaS chrome — mono tables fine for this debug bridge

MVP feature slice (pillars)

IP / open source

• Original C# under Novolis license; seed data attributed as derived from public geo sources.
• README states spiritual homage, not affiliated with GolemLabs / THQ Nordic / SuperPower.
• Do not unpack or vendor D:\Steam\steamapps\common\SuperPower 2\Extras\SDK.

Verification

• Unit tests green for Core + Simulation
• Headless 50-year run exits 0 with bounded event log
• pwsh -File d:\novolis\novolis-governance\scripts\verify-nuget-only.ps1 (and project-ref checks) once packages are wired for publish — no local feeds