Lift fundamentals into Economy Primitives

Policies that keep the org coherent

dotnetgovernancenovolis

name: Economy Primitives Lift overview: Lift LegalEntity, OwnershipClaim, and logistics ID structs into the root Novolis.Economy package (branded as Primitives in docs/metadata), keep PackageId Novolis.Economy to avoid consumer rename churn, update package READMEs and design docs, publish and retarget dogfood. todos:

id: move-party-claim

content: Move LegalEntity* and OwnershipClaim into Novolis.Economy; keep OwnershipEngine in Accounting status: completed

id: move-logistics-ids

content: Move TransportHubId/CorridorId/VehicleClassId into Identifiers.cs; strip from LogisticsModels status: completed

id: metadata-docs

content: Update csproj Descriptions, design/release, root + package READMEs for Primitives branding status: completed

id: test-publish-dogfood

content: Unit tests, push Economy GPR, dogfood restore/smoke, verify-nuget-only status: completed isProject: false

Locked decisions

PackageId stays `Novolis.Economy` (no .Primitives NuGet rename this pass). Brand it as the Primitives package in Description, READMEs, and design docs.
Namespace stays `Novolis.Economy` for moved types (dogfood usings keep working).
Move into root: LegalEntity / LegalEntityKind, OwnershipClaim, TransportHubId / TransportCorridorId / VehicleClassId.
Stay put: OwnershipEngine (Accounting), loan/shipment models, FacilityBinding, engines, Simulation world/phases.
NuGet-only publish + dogfood restore; no local feeds.

flowchart BT
  Prim["Novolis.Economy (Primitives)"]
  Acc[Accounting]
  Fin[Finance]
  Log[Logistics]
  Sim[Simulation]
  Acc --> Prim
  Fin --> Acc
  Fin --> Prim
  Log --> Prim
  Sim --> Prim
  Sim --> Acc
  Sim --> Fin
  Sim --> Log

1. Move types into root package

Party / claims

Move `LegalEntity.cs` → `src/Novolis.Economy/LegalEntity.cs`, namespace Novolis.Economy.
Split `OwnershipModels.cs`: move OwnershipClaim class to e.g. src/Novolis.Economy/OwnershipClaim.cs; leave OwnershipEngine in Accounting (update usings).
Delete old Simulation LegalEntity.cs; fix Simulation/Accounting references (EconomyWorld.Entities, DefaultConsequenceEngine, EnsureCivic, tests).

Logistics IDs

Append TransportHubId, TransportCorridorId, VehicleClassId to `Identifiers.cs` (same From/ToString pattern as FirmId).
Remove those structs from `LogisticsModels.cs`; keep hub/corridor/vehicle models there (they already use Novolis.Economy).

2. Package metadata (Primitives branding)

Update each packable csproj <Description> to state layer role; root especially:

Package	Description thrust
[`Novolis.Economy.csproj`](novolis-economy/src/Novolis.Economy/Novolis.Economy.csproj)	Primitives: IDs, money/qty/time, party (`LegalEntity`), ownership claims, command/event markers, RNG
Accounting	Ledgers, invoices, ownership engine (claims live in Primitives)
Finance / Markets / Production / Logistics / Population	Unchanged role; Logistics note “IDs in Primitives”
Simulation	World + phases; holds entity/claim collections, does not define those types
Agents	Unchanged

3. Docs / READMEs

`docs/design.md`: package split table — rename conceptual row to Primitives (Novolis.Economy package); document party/claim/logistics IDs; DAG note Simulation is composition only.
`docs/release.md`: short “Primitives lift” bullet.
Root `README.md` package index + intro: call out Primitives package.
Per-package READMEs under src/*/README.md — especially `Novolis.Economy/README.md`, Accounting, Logistics, Simulation — one paragraph each on what lives where after the lift.

4. Tests, publish, dogfood

dotnet test Economy unit suite (Ownership/Default, Finance, logistics scenarios).
Commit/push novolis-economy → GPR 2026.1.*.
Dogfood: restore (types stay in Novolis.Economy namespace — NearSol/Tramp should compile with package bump only); quick headless smoke if NearSol builds; verify-nuget-only.ps1; push dogfood if any ref/doc touch needed.

Out of scope

PackageId rename to Novolis.Economy.Primitives
Moving LoanStatus / shipment phase enums / FacilityBinding / C/E dump split
Creating Economy.Abstractions