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§
- Agent
State - Compact entity state in fixed-point space (millimeter coordinates).
- Fixed
Tick World - Fixed-capacity multi-agent simulation world kernel (Zero Heap hot path).
- Fixed
Vec2 - 2D vector in fixed-point millimeter space.
- Simulation
Command - Simulation command intent submitted by an agent or user.
Enums§
- Command
Payload - Strongly typed command payload.
- Command
Receipt - Deterministic receipt issued for every executed command.
- Rejection
Reason - 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§
- Command
Receipt Status - Alias for
RejectionReason. - Entity
State - Ergonomic alias for
AgentState. - SimCommand
- Ergonomic alias for
SimulationCommand. - World
State - Ergonomic alias for
FixedTickWorld.