codebase-des-system

You write deterministic test scenarios by defining a JSON schema with map setup, entities, scheduled actions, and assertions. The DES interpreter executes this scenario JSON turn-by-turn against the GameState to validate transitions and reproduce behaviors using a fixed seed.

Yes, you can run DES scenarios as cargo tests. The Skill provides public APIs including run_scenario for single execution and run_parallel for concurrent execution, allowing scenario JSON files to validate game state transitions within your standard Rust test suite.

You debug failing AI behavior by using the DES interpreter to run headless turn-by-turn scenarios with mock settings and scheduled actions. The run_with_render API provides rendering callbacks for visual debugging while validating deterministic state transitions.

Scenario inheritance is a JSON schema feature that allows test scenarios to extend base configurations, sharing map setup, variables, and mock settings. It enables deterministic test execution by reusing defined game states and scheduled actions across multiple scenario validations.

Yes, the DES supports testing environmental events like storms and combat. The deterministic test execution engine lists supported actions and checks specifically for reproducing combat, storms, and environment interactions via scheduled action timing and assertions.

The best way to execute multiple scenarios concurrently is the run_parallel API. It runs deterministic DES scenario JSON files simultaneously, validating game state transitions and assertions for headless turn-by-turn testing of game mechanics at scale.