Dominium/01_yachay/dominium

dominium

Deterministic mean-field simulator with vector agents.

_{a live mean-field run — the isometric continent, thousands of lemmings, and ψ-cluster recoloring (click for the full-res MP4). Static shot: pantallazo.png.}

Five physical layers (materia, psique, poder, oro, degradacion) sit on a dense Grid<f32>; above them lives a world of agents with six atomic actions (move, take, drop, transmit, attack, rest). Endogenous ψ↔action coupling (Phase A): the psique field and agent dynamics influence each other without operator intervention between ticks. On top of it: social contagion of vector_psi with homophily and institutional persuasion (Phase B), ψ-metrics — polarization, Moran's I, k-means (Phase C), and discrete Spawn/Kill events, CSV population loading and Monte Carlo sweeps (Phase D). Design detail in SDD.md.

Metaprogrammable Concepts: any field emitter (radiation, market, dogma) loads as JSON with id+pos+radius+mods+hack — the engine stays dumb, external AI is optional.

Install

# deterministic CLI
cargo run --release -p dominium-cli -- run --seed 42 --ticks 1000

# Llimphi app (canvas + live control panel)
cargo run --release -p dominium-app-llimphi

Compatibility

• Linux / macOS / Windows — Llimphi UI.
• Wawa — dominium-core/physics/iso/render-plan compile to WASM (zero graphical deps).
• Web — via dominium-notebook-kernel (pluma notebook kernel).

Crates

See LEEME.md. Core split: dominium-core (data + actions + Concepts + worldgen), dominium-physics (6-phase tick), dominium-sim (simulation session: world + clock + snapshot ring, frontend-agnostic), dominium-iso (30° projection + Lambert shadow), dominium-render-plan (World → Vec<Quad>), dominium-canvas-llimphi (vello backend), dominium-app-llimphi (app), dominium-cli, dominium-notebook-kernel. Beyond the engine: dominium-topology (the shape of the society, not just its averages), dominium-control (closed-loop stability), dominium-models (canonical social-physics models instantiated on the engine and validated by reproducing their published transition) and dominium-voxel (voxelizes a World for the llimphi-3d engine).

Considerations

• Inviolable rule: zero graphical deps in core/physics/iso/render-plan. Only serde and libm. Graphics live in canvas-llimphi/app-llimphi.
• Bit-for-bit deterministic given same seed and same version.
• Concepts load at runtime; they let you rewrite the domain without recompiling.
• Everything non-fixed is data: SimParams/ZWeights are serializable and live-editable from panel sliders; a scenario (params + relief + Concepts) serializes whole.