Class SimulationKernel

Index

Constructors

Methods

advanceTurn applyAgentUpdates applyDrift applyPolicy applyPoliticsDeltas applySystemDeltas export getAliveAgents getAliveCount getCandidates getDepartmentSummary getFeaturedAgents getState promoteAgent toSnapshot fromSnapshot

Constructors

constructor

new SimulationKernel(
    seed: number,
    leaderId: string,
    keyPersonnel: KeyPersonnel[],
    init?: SimulationInitOverrides,
): SimulationKernel
Parameters
- seed: number
- leaderId: string
- keyPersonnel: KeyPersonnel[]
- init: SimulationInitOverrides = {}
Returns SimulationKernel
- Defined in engine/core/kernel.ts:97

Methods

advanceTurn

advanceTurn(
    nextTurn: number,
    nextTime: number,
    progressionHook?: (
        ctx: {
            agents: any[];
            rng: any;
            startTime: number;
            time: number;
            timeDelta: number;
            turn: number;
        },
    ) => void,
): SimulationState
Advance to the next turn. Runs between-turn progression.
Parameters
- nextTurn: number
- nextTime: number
- OptionalprogressionHook: (
      ctx: {
          agents: any[];
          rng: any;
          startTime: number;
          time: number;
          timeDelta: number;
          turn: number;
      },
  ) => void
Returns SimulationState
- Defined in engine/core/kernel.ts:293

applyAgentUpdates

applyAgentUpdates(
    updates: {
        agentId: string;
        career?: Partial<AgentCareer>;
        health?: Partial<AgentHealth>;
        narrativeEvent?: string;
    }[],
): void
Apply featured colonist updates from department reports.
Parameters
- updates: {
      agentId: string;
      career?: Partial<AgentCareer>;
      health?: Partial<AgentHealth>;
      narrativeEvent?: string;
  }[]
Returns void
- Defined in engine/core/kernel.ts:400

applyDrift

applyDrift(
    commanderHexaco: HexacoProfile,
    outcome: TurnOutcome | null,
    timeDelta: number,
): void
Apply personality drift to all promoted colonists.
Parameters
- commanderHexaco: HexacoProfile
- outcome: TurnOutcome | null
- timeDelta: number
Returns void
- Defined in engine/core/kernel.ts:392

applyPolicy

applyPolicy(effect: PolicyEffect): void
Apply a policy effect from the commander's decision.
Parameters
- effect: PolicyEffect
Returns void
- Defined in engine/core/kernel.ts:257

applyPoliticsDeltas

applyPoliticsDeltas(deltas: Partial<WorldPolitics>, events?: TurnEvent[]): void
Apply additive deltas to world politics.
Parameters
- deltas: Partial<WorldPolitics>
- events: TurnEvent[] = []
Returns void
- Defined in engine/core/kernel.ts:379

applySystemDeltas

applySystemDeltas(deltas: Partial<WorldMetrics>, events?: TurnEvent[]): void
Apply additive deltas to world systems (not absolute values).
Parameters
- deltas: Partial<WorldMetrics>
- events: TurnEvent[] = []
Returns void
- Defined in engine/core/kernel.ts:362

export

export(): SimulationState
Returns SimulationState
- Defined in engine/core/kernel.ts:431

getAliveAgents

getAliveAgents(): Agent[]
Returns Agent[]
- Defined in engine/core/kernel.ts:237

getAliveCount

getAliveCount(): number
Returns number
- Defined in engine/core/kernel.ts:241

getCandidates

getCandidates(dept: string, topN?: number): Agent[]
Get top N candidates for a department role, scored by trait fit.
Parameters
- dept: string
- topN: number = 5
Returns Agent[]
- Defined in engine/core/kernel.ts:323

getDepartmentSummary

getDepartmentSummary(
    dept: string,
): {
    avgBoneDensity: number;
    avgMorale: number;
    avgRadiation: number;
    count: number;
}
Parameters
- dept: string
Returns {
    avgBoneDensity: number;
    avgMorale: number;
    avgRadiation: number;
    count: number;
}
- Defined in engine/core/kernel.ts:245

getFeaturedAgents

getFeaturedAgents(): Agent[]
Returns Agent[]
- Defined in engine/core/kernel.ts:233

getState

getState(): SimulationState
Returns SimulationState
- Defined in engine/core/kernel.ts:162

promoteAgent

promoteAgent(
    agentId: string,
    dept: string,
    role: string,
    promotedBy: string,
): void
Promote a colonist to a department head role.
Parameters
- agentId: string
- dept: string
- role: string
- promotedBy: string
Returns void
- Defined in engine/core/kernel.ts:338

toSnapshot

toSnapshot(scenarioId: string): KernelSnapshot
Capture a KernelSnapshot bundle. The returned object is plain JSON-safe data: JSON.stringify(snap) + JSON.parse + SimulationKernel.fromSnapshot(parsed, scenarioId) round-trips to a new kernel in the same state. Used by WorldModel.snapshot() + fork() for mid-run counterfactuals.
Parameters
- scenarioId: string
  Scenario id the snapshot is being taken against. Stamped into the snapshot so fromSnapshot can verify the target WorldModel's scenario matches.
Returns KernelSnapshot
- Defined in engine/core/kernel.ts:175

`Static`fromSnapshot

fromSnapshot(snap: KernelSnapshot, expectedScenarioId: string): SimulationKernel
Reverse of SimulationKernel.toSnapshot. Constructs a fresh kernel positioned at the snapshot's turn, with simulation state + PRNG state + metadata fully restored. The returned kernel is indistinguishable from the one that produced the snapshot as far as subsequent advanceTurn calls are concerned.
Parameters
- snap: KernelSnapshot
  The captured snapshot.
- expectedScenarioId: string
  Scenario id the caller expects the snapshot to match. Throws when they differ; this is the gate against accidental cross-scenario forks.
Returns SimulationKernel

Throws
Error when snap.snapshotVersion !== 1 or when snap.scenarioId !== expectedScenarioId.
- Defined in engine/core/kernel.ts:202

Class SimulationKernel

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns SimulationKernel

Methods

advanceTurn

Parameters

Returns SimulationState

applyAgentUpdates

Parameters

Returns void

applyDrift

Parameters

Returns void

applyPolicy

Parameters

Returns void

applyPoliticsDeltas

Parameters

Returns void

applySystemDeltas

Parameters

Returns void

export

Returns SimulationState

getAliveAgents

Returns Agent[]

getAliveCount

Returns number

getCandidates

Parameters

Returns Agent[]

getDepartmentSummary

Parameters

Returns { avgBoneDensity: number; avgMorale: number; avgRadiation: number; count: number;}

getFeaturedAgents

Returns Agent[]

getState

Returns SimulationState

promoteAgent

Parameters

Returns void

toSnapshot

Parameters

Returns KernelSnapshot

StaticfromSnapshot

Parameters

Returns SimulationKernel

Throws

Settings

On This Page

Returns {
avgBoneDensity: number;
avgMorale: number;
avgRadiation: number;
count: number;
}

`Static`fromSnapshot