Skip to main content

Module fixed_tick

Module fixed_tick 

Expand description

Deterministic Fixed-Tick Multi-Agent Simulation Engine.

Provides a strictly reproducible, zero-float-drift fixed-step simulation kernel. Designed for:

  • Multi-agent RTS and simulation worlds
  • POET step-by-step document and macro automation
  • Attestable distributed simulation replay across native and WASM

Rules (AGENTS.md):

  • Zero heap inside hot tick evaluation loops (Tier 1 hot-path).
  • Fixed-point / integer arithmetic for coordinates and resource tallies.
  • Seeded deterministic PRNG (PCG / xorshift).
  • Strict command ordering: (target_tick, sequence, actor_did).
  • Typed accepted / rejected receipts for all submitted intents.

Structs§

AgentState
Compact entity state in fixed-point space (millimeter coordinates).
FixedTickWorld
Fixed-capacity multi-agent simulation world kernel (Zero Heap hot path).
FixedVec2
2D vector in fixed-point millimeter space.
SimulationCommand
Simulation command intent submitted by an agent or user.

Enums§

CommandPayload
Strongly typed command payload.
CommandReceipt
Deterministic receipt issued for every executed command.
RejectionReason
Reason for rejecting a proposed command.

Constants§

MAX_COMMANDS_PER_TICK
MAX_ENTITIES
Default capacity constants.
SIMULATION_TICK_MS
SIMULATION_TICK_RATE_HZ
Simulation frequency (20 Hz = 50ms per tick).

Type Aliases§

CommandReceiptStatus
Alias for RejectionReason.
EntityState
Ergonomic alias for AgentState.
SimCommand
Ergonomic alias for SimulationCommand.
WorldState
Ergonomic alias for FixedTickWorld.