Novolis.Economy.Simulation 2026.1.0.57

dotnet add package Novolis.Economy.Simulation --version 2026.1.0.57
                    
NuGet\Install-Package Novolis.Economy.Simulation -Version 2026.1.0.57
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Novolis.Economy.Simulation" Version="2026.1.0.57" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Novolis.Economy.Simulation" Version="2026.1.0.57" />
                    
Directory.Packages.props
<PackageReference Include="Novolis.Economy.Simulation" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Novolis.Economy.Simulation --version 2026.1.0.57
                    
#r "nuget: Novolis.Economy.Simulation, 2026.1.0.57"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Novolis.Economy.Simulation@2026.1.0.57
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Novolis.Economy.Simulation&version=2026.1.0.57
                    
Install as a Cake Addin
#tool nuget:?package=Novolis.Economy.Simulation&version=2026.1.0.57
                    
Install as a Cake Tool

Novolis

Novolis · Docs · Source

Novolis.Economy.Simulation

Composition and execution layer for economic models: EconomyWorld, clocks, ordered phases, model profiles, agents, run manifests, metrics, and stable fingerprints.

Holds operational collections for orchestration; OwnershipClaim and FirmLedger remain Accounting compatibility/input projections. Economic authority is Novolis.Economy.Core (EconomyWorld.CoreState), including positions, cash positions, claims, and Core share holdings. This layer selects and runs the period engine; Core never owns the clock or phase ordering.

EconomicRegion + AddRegion / household AddCohort living clamp; region labor pools; production slots for mfg/assembly only.

Registration is strict by default. Hosts that deliberately want game-friendly implicit Core entities, assets, or regions must pass RegistrationMode.Implicit to EconomyWorld or EconomyWorldBuilder.

SmallOpenRegionalTradeModel is the flagship operational composition. It creates bounded regional capacity, retail restocking, cohort food demand, explicit external-sector procurement/export schedules, a working-capital facility, and replayable rules-based firm/carrier actors. Its period boundary advances Core's period marker after hourly effects have already been applied; the deterministic bounded profile is the model that runs the full sixteen-step teaching pipeline.

Does not reference Novolis.Simulation.* (spatial stack).

Install

dotnet add package Novolis.Economy.Simulation

Quick start

using Novolis.Economy;
using Novolis.Economy.Production;
using Novolis.Economy.Simulation;

using Novolis.Economy.Simulation.Extensions;

var world = new EconomyWorldBuilder()
  .AddRegion(areaId, livingCapacityHouseholds: 10_000, productionSlots: 50)
  .Build();
var sim = EconomySimulation.FromModel(
  seed: 42,
  new Models.SmallOpenRegionalTradeModel());

sim.Enqueue(new SetProductionPlan(firmId, facilityId, productId, Quantity.From(50m)));
await sim.AdvanceAsync(SimulationDuration.FromHours(24));

Console.WriteLine(WorldReportFormatter.Format(world.ToReportSnapshot()));

Custom phase order (tests): new EconomySimulation(seed, world, PhasePipeline.CreateDefault()).

API

Type Role
EconomySimulation Command queue, AdvanceAsync, throughput mode
IEconomySimulation Simulation contract
SimulationModelDefinition Complete model composition surface
SmallOpenRegionalTradeModel Documented flagship open regional model
DeterministicBoundedModel Finite, replayable secondary profile
SimulationRun / SimulationRunRequest Model-owned run execution and results
SimulationRunManifest Reproducibility identity and selected rules
SimulationMetrics / SimulationSweep Run observations and parameter sweeps
EconomyWorld Firms, regions, inventory, ledgers, loans, hub book
EconomyWorldBuilder Fluent world setup (AddRegion, AddFirm, AddProduct, …)
EconomyWorldExtensions ToReportSnapshot()
PhasePipeline / DefaultPhases Ordered hourly + period-close phases
ISimulationPhase Single phase hook
SimulationPhaseOrder Phase enum ordering
CoreEconomyBridge Bind hub regions; period execution stays in the selected model
CoreInventoryBridge / CoreCashBridge Reconcile operational detail into Core authority
DefaultConsequenceEngine Post-command side effects
LegalEntity / LegalEntityKind Ops party records
CohortBudgetResetMode When cohort budgets refresh
MoneyStock Aggregate money diagnostics
WorldReportFormatter Format(WorldReportSnapshot) text report

Dogfooding / apps

Composition root for novolis-dogfooding apps/economy/ (EconomyBoard, TrampFreighterPlay).

Package Role
Novolis.Economy.Core BM kernel advanced at period boundaries
Novolis.Economy.Production Command / event types enqueued here
Novolis.Economy.Agents Tick agents before each hour
Novolis.Economy.Finance SettleFinance uses LoanEngine
Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2026.1.0.57 113 10/18/2026
2026.1.0.55 97 10/18/2026
2026.1.0.54 95 10/4/2026
2026.1.0.53 94 10/1/2026
2026.1.0.52 93 9/30/2026