Pivot Economy stack onto Novolis.Economy.Core

name: Core Economy Pivot overview: Retire PackageId Novolis.Economy; make Novolis.Economy.Core the sole economic kernel. Keep Core’s BM surface unchanged. Move ops-only types into the packages that use them. Hour ticks only advance carriage; Core’s 16-step pipeline settles at period boundaries. Migrate all economy packages, dogfooding apps, and keep Sins on Core. todos:

• id: phase0-docs-freeze

content: Document type map in design.md; freeze prim Novolis.Economy features status: completed

• id: phase1-retarget

content: Retarget Production→Agents onto Core; relocate ops-only types out of prim status: completed

• id: phase2-clock

content: "Simulation: hour ops + period-boundary EconomyEngine.Advance; Core state authority" status: completed

• id: phase3-logistics

content: Logistics schedules Core ResourceTransfers; hub↔RegionId map status: completed

• id: phase4-retire-prim

content: Delete Novolis.Economy package; update dogfood Directory.Packages; regen platform map; publish status: completed

• id: phase5-dogfood

content: NearSol/Tramp/Board cutover + 100d smoke (ProjectRef then GPR) status: completed

• id: phase6-docs

content: Design/README breaking-change notes; confirm Sins still green status: completed isProject: false

Locked decisions

• PackageId: consumers PackageReference `Novolis.Economy.Core` only — retire Novolis.Economy (no shim).
• Time: Core period is economic authority; hours only advance transfers/vehicles/fuel; call EconomyEngine.Advance at period boundaries.
• Core is read-only BM: do not enlarge Core with unused “shared primitives.” If Core does not use a type locally, it does not belong in Core — put it in Logistics / Simulation / Production / etc.
• True fold: colliding economic concepts resolve to Core (Money, party id → LegalEntityId, area → RegionId, good → ResourceId, ownership → shares). Ops vocabulary stays in ops packages.

flowchart TB
  subgraph kernel [Kernel]
    Core[Novolis.Economy.Core]
  end
  subgraph ops [Ops on Core]
    Prod[Production]
    Log[Logistics]
    Pop[Population]
    Fin[Finance]
    Acc[Accounting]
    Mkt[Markets]
    Sim[Simulation]
    Ag[Agents]
  end
  Apps[NearSol Tramp Board Sins]
  Core --> Prod
  Core --> Log
  Core --> Pop
  Core --> Fin
  Core --> Acc
  Core --> Mkt
  Prod --> Sim
  Log --> Sim
  Pop --> Sim
  Fin --> Sim
  Acc --> Sim
  Mkt --> Sim
  Sim --> Ag
  Core --> Apps
  Sim --> Apps
  Ag --> Apps

Target dependency rule

Delete project `novolis-economy/src/Novolis.Economy/` after types are relocated or replaced.

Type migration map (no orphans in Core)

Phase plan

Phase 0 — Inventory and guardrails

• Freeze new features on prim Novolis.Economy.
• Document map above in `novolis-economy/docs/design.md`.
• Confirm Sins (`novolis-apps/.../SinsOfACapitalismTycoon`) already Core-only — leave alone except if Money/API churn.

Phase 1 — Retarget packages onto Core (compile green)

For each src/Novolis.Economy.* (except Core):

1. Replace ProjectReference to Novolis.Economy with Novolis.Economy.Core.
2. Fix namespaces / type renames per map.
3. Relocate prim-only source files into the owning ops project (do not dump into Core).
4. Keep Core SPEC/README/API unchanged.

Order (leaf → root): Production, Markets, Accounting, Logistics, Finance, Population, Simulation, Agents.

Publish via merge CI after each coherent chunk (or one big PR if preferred) so GPR stays usable under ProjectRef mode for local work.

Phase 2 — Simulation clock: hours + period settle

In `EconomySimulation` / phase pipeline:

• Hold EconomyState as authority (immutable replace each period).
• Hour phases: Logistics AdvanceHour updates in-flight carriage → apply completions into Core holdings/transfers without running full 16 steps every hour.
• At PeriodHours boundary: run DefaultPeriodPipeline / EconomyEngine.Advance.
• Wages, retail sink, loans, production throttle: migrate off parallel cash ledgers onto Core cash/obligations/holdings as each phase is touched (incremental; delete duplicate ledgers when drained).

Phase 3 — Logistics on Core transfers

• Treat Core ResourceTransfer / lanes as economic carriage.
• Existing hub/corridor/vehicle engine becomes the scheduler that starts/ticks/completes Core transfers (fuel/berth/crew = ops cost → Core obligations or cash when period settles).
• NearSol dogfood keeps Astro bridge; map hubs → RegionId.

Phase 4 — Retire PackageId `Novolis.Economy`

• Remove `Novolis.Economy.csproj` from slnx.
• Update `novolis-dogfooding/Directory.Packages.props`: drop Novolis.Economy; ensure Novolis.Economy.Core.
• Update NearSol / Tramp / EconomyBoard csprojs.
• Regen platform map: Generate-Platform-Slnx.ps1.
• verify-nuget-only.ps1 + verify-project-ref-mode.ps1.
• GPR: stop publishing Novolis.Economy (delist/mark obsolete in docs; junk-version hygiene via gpr scripts if needed).

Phase 5 — Dogfood cutover

• NearSol: seed Core state + ops overlays; period report from Core insights; keep headless milestones.
• Smoke: NearSol --headless 100d under ProjectRef mode, then GPR float.
• TrampFreighter* / EconomyBoard: same dependency swap; reduce reliance on deleted prim usings.

Phase 6 — Docs and consumer guidance

• Rewrite design package-split diagram: Core kernel, no Primitives package.
• Note breaking change for any external PackageReference Include="Novolis.Economy".
• Sins remains Core-period app (already aligned with 2a).

Explicit non-goals (this pivot)

• Do not add order books, vehicles, or hour clock into Core.
• Do not rewrite Sins into NearSol.
• Do not keep a dual Money/ledger forever — Phase 2–3 delete parallels.

Done criteria

• No project references PackageId Novolis.Economy.
• Core package surface unchanged aside from zero/minimal true shared needs proven by Core compilation (expect none).
• Logistics/Simulation compile and run against Core; NearSol 100d smoke green.
• Platform map lists Core; verify scripts exit 0.
• Sins still restores/runs on Core from GPR.