Reference
=========

Technical reference documentation for the Babylon simulation engine.

Data Models
-----------

.. toctree::
   :maxdepth: 1

   data-models

Complete specification of data structures, entity collections, constrained
types, and graph structure.

Mathematical Formulas
---------------------

.. toctree::
   :maxdepth: 1

   formulas

All simulation formulas: imperial rent, survival calculus, consciousness
drift, solidarity transmission, and dynamic balance.

Simulation Systems
------------------

.. toctree::
   :maxdepth: 1

   systems

API reference for the seven core simulation systems (ImperialRent, Solidarity,
Consciousness, Survival, Contradiction, Territory, Struggle).

Event System
------------

.. toctree::
   :maxdepth: 1

   events

Complete reference for the typed event system: 11 EventTypes, 13 event classes,
event lifecycle, and factory methods for testing.

Configuration
-------------

.. toctree::
   :maxdepth: 1

   configuration

Configuration system documentation, environment variables, and GameDefines
parameter tables.

Topology System
---------------

.. toctree::
   :maxdepth: 1

   topology

Percolation theory metrics, TopologyMonitor observer, and resilience testing.

Design System
-------------

.. toctree::
   :maxdepth: 1

   design-system

Visual design tokens: color palette, typography, styling constants, and
texture specifications for Bunker Constructivism aesthetic.

Documentation System
--------------------

.. toctree::
   :maxdepth: 1

   documentation

Build commands, Sphinx extensions, LaTeX configuration, and PDF theme
specifications. Meta-reference for the documentation engine itself.

AI & RAG
--------

.. toctree::
   :maxdepth: 1

   ai-prompting
   context-window-api

Prompt templates, API usage patterns, and context window management API.

Error Handling
--------------

.. toctree::
   :maxdepth: 1

   error-codes

Error code taxonomy and error handling conventions.

CI/CD Workflow
--------------

.. toctree::
   :maxdepth: 1

   ci-workflow

GitHub Actions workflows, branch protection rules, and the Benevolent
Dictator governance model.