<!-- reviewed: 2026-06-27 | repo-wide consistency audit | canonical facts: docs/VERIFICATION-ANALYTICAL-DATA.md -->

# File Map — the codebase, module by module

_Auto-generated by `bun scripts/gen-filemap.ts` from each module's own doc-header — **do not edit by hand**, fix the module header and re-run. 347 TypeScript modules across 12 directories. The sibling C++ engine lives in `native/src/` (see [ADR-0007](./adr/0007-native-cpp-engine-and-live-physics-2026-06-26.md))._

## `src/`

| Module | What it does |
| --- | --- |
| `alife-gallery-boot.ts` | Standalone ALife gallery boot — bundled to dist/alife-gallery.js for Docs/Spec/Lab static hosts. |
| `alife-metrics-gallery.ts` | CQM-25 canonical profile with secondary historical nine-axis comparisons for Docs and Specs. |
| `browser-globals.d.ts` | — |
| `docs-page.ts` | Entry module for docs.html — initializes mermaid and renders the inline |
| `main.ts` | Browser entrypoint: htmx activation, quality detection, engine boot, |
| `satellite-music.ts` | SATELLITE MUSIC (V102) — keeps the procedural soundtrack alive on Docs / Spec / Lab pages. |
| `specs-page.ts` | Entry module for specs.html — ALife metric gallery (shared with docs.html). |
| `types.ts` | Shared type hub for the Cosmogonic Quantum Mechalogodrom. |
| `world-diagnostics.ts` | World diagnostic snapshot types (audit #6: extracted from world.ts — type-only, no runtime). |
| `world-style.ts` | World visual-style tables (audit #6: extracted from world.ts). Module constants, no per-frame alloc. |
| `world.ts` | Composition root of the simulation: constructs every system against the |

## `src/audio/`

| Module | What it does |
| --- | --- |
| `analysis.ts` | Per-frame audio frequency analysis (CONTRACTS V2 — Quantum Wildbeyond). |
| `engine.ts` | Web Audio engine: procedural music scheduler + a data-driven 110-voice SFX synthesizer |
| `songs.ts` | Procedural soundtrack and SFX catalog data. |
| `xenomimic-audio.ts` | Bounded Xenomimic sound field. |

## `src/core/`

| Module | What it does |
| --- | --- |
| `bounded-response.ts` | Bounded streaming reads for untrusted HTTP responses; rejects before whole-body buffering. |
| `camera-framing.ts` | Pure camera-framing helpers (DOM/three-free for headless verification). |
| `engine.ts` | Owns the WebGL renderer, root scene and perspective camera |
| `frame-governor.ts` | RENDER & COMPUTE-CADENCE FRAME GOVERNOR (`src/core/frame-governor.ts`). |
| `frustum-cull.ts` | Frustum culling for off-screen entities. |
| `graphics-abstraction.ts` | Phase 2.1: Graphics Abstraction Layer |
| `host-mode.ts` | Whether same-origin Bun server APIs exist for this rendered artifact. |
| `hybrid-compute.ts` | Browser compute capability probes, routing proposals, and a CPU/WASM neural helper. |
| `math-cache.ts` | Math calculation cache for common operations. |
| `perf-monitor.ts` | Performance monitoring utilities for tracking frame times and metrics. |
| `postfx.ts` | Post-processing (CONTRACTS V11 + V60) — a guarded EffectComposer chain. |
| `quality.ts` | Quality tier ladder (CONTRACTS V3.1, PANTHEON). |
| `rng-provenance.ts` | rng-provenance.ts — a MEASURED provenance receipt for the sim's deterministic RNG substrate. |
| `seed-param.ts` | Parse a `?seed=` URL value into a uint32 seed (audit #303). Accepts hex (`0x1F`, `0X1f`) or |
| `social-scan-pool.ts` | Worker cores for the organism social field (ADR 0019). |
| `transform-feedback.ts` | Phase 5.2: Transform Feedback for Brain State Updates |
| `webgpu-detect.ts` | WebGPU detection and progressive enhancement support. |
| `wilderness-compute.ts` | Bounded, transfer-inclusive routing evidence for the non-golden ambient population only. |
| `wilderness-webgpu.ts` | Complete, batched FP32 port of the non-golden wilderness movement kernel. Core simulation and |
| `worker-pool.ts` | Phase 3.1: Web Worker Pool Manager |
| `xylos-session.ts` | Xylos runtime boundary: live browser entropy, bounded input recording and exact local replay. |

## `src/generated/`

| Module | What it does |
| --- | --- |
| `alife-svg-embed.ts` | AUTO-GENERATED by scripts/gen-alife-embed.ts — do not edit by hand. |

## `src/logging/`

| Module | What it does |
| --- | --- |
| `audit.ts` | Action audit trail. |
| `logger.ts` | Leveled logger over a single shared ring buffer. |

## `src/math/`

| Module | What it does |
| --- | --- |
| `belief-propagation.ts` | FACTOR-GRAPH BELIEF PROPAGATION — discrete sum-product message passing, ported from Eshkol's |
| `clifford-tableau.ts` | THE CLIFFORD STABILIZER TABLEAU (V100) — the apex mind's LARGE-SCALE quantum substrate. The dense |
| `curvature-aware-qng.ts` | CURVATURE-AWARE QUANTUM NATURAL GRADIENT (V94 / Super Creature 1.1) — faculty #7 from research bedrock. |
| `deterministic-statevector-rng.ts` | Deterministic classical state-vector sampler adapted from the architecture of Tsotchke's |
| `dual.ts` | DUAL NUMBERS — forward-mode automatic differentiation, ported from Eshkol's `vm_dual.c` |
| `eshkol-ad.ts` | ESHKOL AUTOMATIC DIFFERENTIATION (V2) — reverse-mode AD via Wengert tape. |
| `eshkol-qrng.ts` | ESHKOL / TSOTCHKE DETERMINISTIC STATE-VECTOR RNG ADAPTER |
| `eshkol-taylor-jet.ts` | BOUNDED ESHKOL-INSPIRED TAYLOR JETS |
| `games.ts` | Game-theory leaf for the TITAN diplomacy layer (CONTRACTS V3.3). |
| `global-workspace.ts` | GLOBAL WORKSPACE THEORY engine — faithful TypeScript port of Eshkol's consciousness-engine |
| `heap.ts` | Array-backed binary heap and a bounded top-K selector. |
| `hopfield.ts` | hopfield.ts — REAL Hopfield associative memory (leaf, exclusive owner). |
| `hyperdual.ts` | HYPER-DUAL NUMBERS — exact second-order automatic differentiation, ported from Eshkol's |
| `irrep.ts` | irrep.ts — REAL SO(3)/SU(2) irreducible-representation math (leaf, exclusive owner). |
| `izhikevich.ts` | izhikevich.ts — REAL Izhikevich spiking-neuron dynamics (leaf, exclusive owner). |
| `libirrep-symmetry.ts` | LIBIRREP SYMMETRY — Clebsch-Gordan, Wigner-D, spherical harmonics, SU(2) characters from Tsotchke libirrep. |
| `mixed-state-qgt.ts` | MIXED-STATE QUANTUM GEOMETRIC TENSOR (V94 / Super Creature 1.1) — faculty #8 from research bedrock. |
| `mps-svd.ts` | mps-svd.ts — REAL singular value decomposition + matrix-product-state bond |
| `nist-sp800-90b.ts` | nist-sp800-90b.ts — faithful NIST SP 800-90B §4.4 continuous health-test algorithms |
| `predictive-coding.ts` | predictive-coding.ts — REAL hierarchical predictive coding (leaf, exclusive owner). |
| `quantization.ts` | Quantization utilities for browser-scale simulation buffers. |
| `quantum-ad.ts` | QUANTUM-CLASSICAL AUTODIFF — differentiate a variational quantum circuit's expectation value by the |
| `quantum-coherence.ts` | QUANTUM COHERENCE RESOURCES (V90 / Super Creature 1.1) — the resource theory of coherence |
| `quantum-geometry.ts` | THE QUANTUM GEOMETRIC TENSOR (V84) — a TypeScript port of the core primitive from the Tsotchke |
| `quantum-magic.ts` | QUANTUM MAGIC — STABILIZER RÉNYI ENTROPY (Super Creature 1.1). "Magic" (non-stabilizerness) is the |
| `quantum-natural-gradient.ts` | QUANTUM NATURAL GRADIENT (V93 / Super Creature 1.1 — quantum self-optimization). Stokes, Izaac, |
| `quantum-qrng-full.ts` | QUANTUM RNG FULL (V3 MODEL) — deterministic state-vector sampler + CHSH model conformance. |
| `quantum.ts` | Minimal statevector quantum register (CONTRACTS V2 — Quantum Wildbeyond). |
| `qubit-pair-info.ts` | PAIRWISE QUANTUM MUTUAL INFORMATION — which qubits of a pure n-qubit register share information. |
| `rng-stats.ts` | rng-stats.ts — deterministic randomness-quality battery (leaf, exclusive owner). |
| `rng.ts` | Deterministic randomness (contract rule 7, Known Bug 9). |
| `scalar.ts` | Scalar math helpers shared by every sim system. |
| `schrodinger.ts` | schrodinger.ts — numerical time-dependent Schrödinger evolution (leaf, exclusive owner). |
| `so3.ts` | so3.ts — SO(3) rotation-group toolkit (leaf, exclusive owner). |
| `spatial-hash.ts` | Uniform-grid spatial hash over the XZ plane. |
| `unification.ts` | UNIFICATION + KNOWLEDGE BASE — faithful port of Eshkol's logic-programming primitive |
| `wild-entropy.ts` | Dual-Mode Wild Quantum-Chaos Entropy Substrate (`src/math/wild-entropy.ts`). |
| `zig-bridge.ts` | Zig 0.17.0 WebAssembly Kernel Bridge (`zig/src/root.zig` -> `cqm_kernels.wasm`) |
| `zig-wasm-binary.ts` | Auto-generated by `scripts/build-zig.ts` from `zig/src/root.zig`. |

## `src/memory/`

| Module | What it does |
| --- | --- |
| `store.ts` | Versioned localStorage persistence for cross-session preferences. |

## `src/server/`

| Module | What it does |
| --- | --- |
| `ai-sandbox.ts` | Read-only tool sandbox for the Copilot side-chat (CONTRACTS V9 — the LLM shell organ). |
| `copilot.ts` | Copilot LLM bridge (CONTRACTS V9 — the non-deterministic shell organ). |
| `corpus-index.ts` | Read-only corpus manifest for Copilot RAG — every .md/.html/.xml/.txt under the repo |
| `web-search.ts` | WEB SEARCH for the Copilot — unrestricted public web lookup via DuckDuckGo's Instant-Answer API. |

## `src/sim/`

| Module | What it does |
| --- | --- |
| `abomination-architecture.ts` | ABOMINATION ARCHITECTURE — sparse suspended megastructure around the dome. |
| `active-inference.ts` | ACTIVE INFERENCE (V90) — Super Creature 1.1's **free-energy core**. The Free Energy Principle (Friston |
| `ad-forager.ts` | AD-GRADIENT FORAGER — a standalone reference kernel that senses a food field by exact reverse-mode automatic |
| `ad-mlp.ts` | AD-MLP — a genuine multi-layer perceptron trained by EXACT reverse-mode automatic differentiation |
| `algorithms.ts` | The 25 sorting-field algorithms — the original 20 (port of legacy `ALGOS`, |
| `alien-flora.ts` | ALIEN FLORA — a living vegetal ecology for the dead arena floor. |
| `alphabet-pantheon-render.ts` | ALPHABET PANTHEON RENDER (V-ABC) — brings the 100 Greek+Latin archetypes to life in the dome. |
| `alphabet-pantheon.ts` | Alphabet Pantheon — 100 deterministic, genuinely-differentiated super-creature archetypes |
| `analytics.ts` | Rolling-window telemetry science (CONTRACTS V2 — analytics writer). |
| `apex-brain.ts` | APEX-BRAIN — THE ENTROPIC TESSERACT HYDRA, the brain of the final-sigma ς apex creature (the |
| `apex-cadence.ts` | APEX CADENCE — GOAL5 frame-budget helper for the 5 individuated SuperMinds. |
| `apex-consciousness-scaffold.ts` | APEX consciousness & growth scaffold — honest scaling from 100k → 5M → 1B designed parameters. |
| `apex-field-organs.ts` | APEX Field Organs — the live multi-physics sensorium (the resident-field tier, made load-bearing). |
| `apex-field-substrate.ts` | APEX Field Substrate — the field organs as GPU-resident texture stencils (the `resident-field` tier). |
| `apex-harness.ts` | APEX SCIENTIFIC HARNESS — Wave E of the APEX doctrine |
| `apex-native-backend.ts` | APEX Native Backend contract — the reference-reproducing bridge to a C/C++/GPU kernel backend. |
| `apex-novelty.ts` | APEX NOVELTY ARCHIVE — the open-endedness instrument (Wave E of the APEX doctrine, |
| `apex-offworld-score.ts` | APEX Offworld Umwelt Score — the doctrine's Experiment 2, quantified. |
| `apex-parameter-manifold.ts` | APEX Parameter Manifold — the honest, deterministic scaffolding that scales the APEX #101 brain |
| `apex-quantum-substrate.ts` | APEX Quantum Substrate — the Quantum Brain scaled to a **billion-dimensional Hilbert space**. |
| `apex-rarity.ts` | APEX SCIENTIFIC RARITY MATRIX — the "1-of-1 by combination" proof (Wave E of the APEX doctrine, |
| `apex-substrate-driver.ts` | APEX Substrate Driver — fuses the 1-billion-parameter substrate into behavioural modulation. |
| `apex-substrate-visual.ts` | APEX Substrate Visual Bridge — maps the 1-billion-parameter substrate telemetry onto shader uniforms. |
| `apex-thought-variations.ts` | APEX thought-variation catalog — 100 deterministic 1/1 alien cognitive substrates. |
| `artifacts.ts` | Artifact field (CONTRACTS V9 — "physical visual effects + artifacts that effect the world"). |
| `asteroids-physics.ts` | ASTEROIDS PHYSICS — arcade thrust/friction from Tsotchke mirrors/asteroids. |
| `atmosphere.ts` | Alien atmosphere — sky dome, breathing haze, particulate air and an aurora curtain |
| `attention-controller.ts` | GWT-4 explicit attention controller. |
| `attention-schema.ts` | AST-1: Explicit Attention Schema (model of own attention). |
| `behaviors.ts` | The 26 per-entity behavior fields, ported faithfully from the legacy entity update loop |
| `big-tree-fauna-source.ts` | Allocation-free bridge from independently owned fauna systems into the canonical Big Tree |
| `big-tree-fauna-visitors.ts` | Bounded Big Tree integration for fixed canonical-fauna systems. |
| `big-tree-sanctuary.ts` | Allocation-stable Big Tree sanctuary membership keyed by simulation-owned identity. |
| `big-tree-visitors.ts` | Species adapters for the Big Tree ecology. |
| `big-tree-zone.ts` | Pure geometry, capacity, slot reservation, and bounded visit lifecycle for the Big Tree. |
| `biome-strata.ts` | Five vertical habitat bands and a phenomenological organism physiology/memory model. |
| `bounce-impact-fx.ts` | BOUNCE IMPACT FX (V128, USER stage E — visible-hazard polish) — the ragdoll {@link CollisionBounce} |
| `brutal-god-releases.ts` | BRUTAL GOD RELEASES — NHSI Brutalism Pantheon |
| `causal-graph.ts` | CAUSAL GRAPH — Pearl do-calculus interventional engine (BRUTALISM 1/9) |
| `chaos-field.ts` | CHAOS MODE (CONTRACTS V62) — a toggled storm that turns the calm cosmos into a chaotic, |
| `classical-contrast.ts` | CLASSICAL CONTRAST — an LCG baseline compared with the project's deterministic |
| `cognition.ts` | CREATURE COGNITION (CONTRACTS V24) — the pure decision kernel that turns a creature's PERCEPTION + |
| `collision-bounce.ts` | COLLISION BOUNCE (V128, USER stage E) — the big solid bodies stop being ghosts: an organism that |
| `connectome.ts` | Connectome — the neural-net axon-web layer. Every update it rebuilds entity-to-entity |
| `consciousness-adapters.ts` | CONSCIOUSNESS ADAPTERS — deterministic entity-class adapters that feed the ten-framework |
| `consciousness-kernel.ts` | CONSCIOUSNESS KERNEL — the shared, per-entity substrate that blends TEN clashing scientific theories of |
| `consciousness-lab.ts` | CONSCIOUSNESS LAB — the offline experiment runner that turns the {@link ConsciousnessKernel}'s claims into |
| `constants.ts` | Simulation constants ported verbatim from the legacy monolith |
| `constellations.ts` | Constellation sky-web (V2). A Voronoi diagram + Delaunay triangulation over the 24 |
| `corpus-audit-receipts.ts` | CORPUS AUDIT RECEIPTS — measured census from docs/audit-2026-06-20-deep-dive/*.csv |
| `cosmic-web.ts` | Cosmic web (CONTRACTS V11 viz) — a faint, deep far-field lattice of glowing nodes joined by thin |
| `coupling-audit.ts` | COUPLING AUDIT — measuring whether the faculties actually INTERACT. |
| `creature-exterior-layers.ts` | CREATURE EXTERIOR LAYERS — Three.js physical-outside abomination meshes. |
| `creature-exterior-phenomena.ts` | CREATURE EXTERIOR PHENOMENA — 1000 deterministic wild-body behaviors for the Mechalogodrom |
| `criticality.ts` | NEURAL CRITICALITY (V93) — Super Creature 1.1's **edge-of-chaos self-organiser**. The critical-brain |
| `crystal-ecosystem.ts` | CRYSTAL ECOSYSTEM — the supplied Crystal Ecosystem V9 tree, rebuilt as one native world subsystem. |
| `dark-energy.ts` | DARK ENERGY — Cosmological constant drift engine (BRUTALISM 6/9) |
| `digital-biologics.ts` | DIGITAL BIOLOGICS — substrate-keyed lifeform birth + telemetry layer. |
| `dome-feeding.ts` | DOME FEEDING (V127, USER: "All the things in the dome eat Entities and Plants Biome … Everything goes |
| `economy.ts` | ECONOMY (CONTRACTS V13) — two competing currencies, two commodities, and a |
| `edible-resource.ts` | Deterministic pooled resources for discrete food such as Big Tree fruit and leaves. |
| `embodiment.ts` | Embodiment (Butlin AE-2: output↔input contingency) — a within-life forward BODY-MODEL. |
| `emergence-angles.ts` | EMERGENCE ANGLES — 10 canonical + extended brutal-god mechanisms for NHSI (1-7 elsewhere; 8-10 + gods here). Canonical target: 10. |
| `emergent-language.ts` | EMERGENT NON-HUMAN LANGUAGE (V94 / Super Creature 1.1) — emergence angle #4. |
| `empowerment.ts` | THE EMPOWERMENT DRIVE (V95) — Super Creature 1.1's information-theoretic AGENCY HUNGER. Where the |
| `entities.ts` | Entity lifecycle and per-frame simulation for the organism population. |
| `entity-brain.ts` | PER-ENTITY NEURAL CONTROLLER (V42) — the directive's "50–150 parameter neural network so it's alive |
| `entity-resource-head.ts` | Phase-B per-organism resource head. |
| `environment.ts` | Non-negative floor for chaos-driven intensity/opacity waves (also seals NaN → 0). O(1). |
| `eshkol-bridge.ts` | ESHKOL BRIDGE — consciousness engine substrates ported from |
| `eshkol-cognition.ts` | ESHKOL COGNITION — an Archon literally THINKS in Eshkol (executes bytecode). |
| `eshkol-vm.ts` | ESHKOL VM — a working minimal stack bytecode interpreter (leaf, exclusive owner). |
| `eshkol-workspace.ts` | ESHKOL WORKSPACE — Global Workspace Theory tick for the digital-biologics petri dish. |
| `factions.ts` | Faction archetypes (CONTRACTS V9 — "more things, not just Shoggoths and Puppeteers"). |
| `faculties-pantheon.ts` | FACULTIES PANTHEON — the canonical 100-faculty NHSI design PLUS a brutal-god layer, 144 named total. |
| `floating-monoliths.ts` | FLOATING MONOLITHS — suspended abomination-architecture adrift in the dome. |
| `foundationals.ts` | FOUNDATIONALS — a project-specific consciousness-indicator architecture for APEX's designed 1B path. |
| `gedanken-death.ts` | GEDANKEN DEATH (V127, USER) — Stephen Thaler's "Death of a Gedanken Creature" enacted on this world's |
| `generated-tsotchke-seeds.ts` | AUTO-GENERATED by scripts/harvest-tsotchke-corpus.ts |
| `genome.ts` | Digital genome (CONTRACTS V9 — A-Life genetics, after Creatures/1996 + genetic algorithms). |
| `geometry-cache.ts` | Shared geometry cache — port of legacy `GF`/`cachedGeos` (lines 230-274). |
| `glyph-brain.ts` | GLYPH-BRAIN — the 25,000-parameter brain model for each of the 100 pantheon letter creatures. |
| `glyph-exterior-geometry.ts` | GLYPH EXTERIOR GEOMETRY — impossible per-letter body shapes (deterministic, no rng). |
| `glyph-exterior-palette.ts` | GLYPH EXTERIOR PALETTE — image-inspired colour + texture identity per letter. |
| `glyph-exterior-signature.ts` | GLYPH EXTERIOR SIGNATURE — deterministic per-letter physical-outside identity. |
| `god-colossus.ts` | GOD-COLOSSUS / THE MONOLITH MEGALITH (V110 → re-architected V125 accretion → V131 FRACTAL DEITY) — |
| `godform.ts` | GOAL5 Godform / Pantheon facade — 25 Archons (1 NEO + 4 OMEGA apex + 20 ALPHA light). |
| `gold-lattice.ts` | Gold lattice (CONTRACTS V11 viz) — a sparse set of large, faint, slowly-turning GOLD wireframe |
| `graph-mind.ts` | GraphMind — the connectome's slow-thinking analytical cortex (CONTRACTS V2). |
| `growth-ramp.ts` | GROWTH RAMP (V121) — the pure math behind the live population target. Extracted from world.ts so |
| `habitat-roaming.ts` | Deterministic waypoint for one launched NHI — ADR 0016 social-contact law. |
| `holographic-memory.ts` | THE HOLOGRAPHIC MEMORY (V97) — Super Creature 1.1's COMPOSITIONAL, ANALOGICAL memory: a Vector Symbolic |
| `homebrew-eshkol.ts` | HOMEBREW-ESHKOL — build-toolchain facade for the local `.esk` catalog. |
| `instanced-entities.ts` | Instanced entity renderer (CONTRACTS V3.1, PANTHEON). |
| `integrated-information.ts` | BALANCED-CUT LINEAR ENTROPY (legacy API names: integratedInformation / phi). This computes a |
| `irrep-symmetry.ts` | LIBIRREP SYMMETRY — REAL SO(3)/SU(2) representation theory (leaf, exclusive owner). |
| `latent-substrates.ts` | Latent substrates — makes three previously-DEAD real-math modules OPERATIONAL inside the apex mind. |
| `learned-recurrence.ts` | RPT-1/2 — deterministic online learned recurrence (Butlin / Jaeger extension). |
| `leviathans.ts` | Leviathans (F-BEINGS) — a fourth order of colossal non-human intelligence beyond the shoggoths, |
| `libirrep-qec.ts` | LIBIRREP QEC — rotated planar surface code [[d², 1, d]] with a real decoder. |
| `lineage.ts` | Lineage & kinship (CONTRACTS V9 — "offspring and relations… emerging, living, raising, dying"). |
| `logo-turtle.ts` | LOGO TURTLE — morphogenesis trace from Tsotchke mirrors/logo-lab. |
| `lore.ts` | Deterministic cosmic lore (V2). sha256(seed \|\| kind \|\| index) digests index a curated |
| `mecha-blaze.ts` | MECHA BLAZE (V127, USER: "Mechalogodrom also KILLS / DESTROYS Entities … like the portal but in a |
| `mecha-fire-pillar.ts` | MECHA FIRE PILLAR (V128, USER stage B — visible-hazard polish) — a PERSISTENT flame column that |
| `mechalogodrom-brain.ts` | MECHALOGODROM-BRAIN — the center fusion abomination's 5M-parameter designed mind scaffold. |
| `mechalogodrom-dark-star.ts` | Quaternion-like rotation of a vector around an axis. |
| `mechalogodrom-satellites.ts` | Multi-layered displacement: each artifact is a slow, breathing, non-uniform knot. |
| `mechalogodrom-variant-geometry.ts` | MECHALOGODROM VARIANT SHELL GEOMETRY — ten NAMED mathematical constructions, one per bipolar |
| `mechalogodrom.ts` | THE MECHALOGODROM (V-MECHA) — the central fusion abomination. |
| `memory-orchestra.ts` | GOAL5: Multi-Store Memory Orchestra (typed, graph-linked, feedback controlled, decision system). |
| `metacognition.ts` | THE METACOGNITIVE EXECUTIVE — Super Creature 1.1's fifth pillar (V92). It does not perceive the world |
| `mind-field.ts` | MIND-FIELD — stigmergic group-cognition substrate (emergence angle #5). |
| `monolith-temple.ts` | THE MONOLITH MEGALITH (CONTRACTS V63 → rebuilt V124) — the level-100 ascension end-state made |
| `moonlab-tensor.ts` | MOONLAB TENSOR — REAL tensor-network / MPO kernels (leaf, exclusive owner). |
| `moonlab-vqe.ts` | MOONLAB VQE — a real Variational Quantum Eigensolver on the project statevector. |
| `morphic-field.ts` | MORPHIC FIELD — WIRED (V-MORPH: the apex morphic-resonance beat in world.ts). |
| `morphotypes.ts` | Morphotype generation — port of legacy lines 276-289 (`MT` build loop), |
| `mortality.ts` | MORTALITY & FINITUDE (V94 / Super Creature 1.1) — emergence angle #8. |
| `myth-ritual.ts` | MYTH & RITUAL — CULTURE-AS-COMPRESSION (V94 / Super Creature 1.1) — emergence angle #10. |
| `narrative-memory.ts` | NARRATIVE MEMORY — the concrete realization of the 10 memory orchestrations for the 5 Super Creatures. |
| `neuromodulation.ts` | NEUROMODULATION (V95) — Super Creature 1.1's neuromodulatory metalearning layer. Kenji Doya's framework |
| `nhi-big-tree-source.ts` | Narrow launched-NHI bridge into the canonical Big Tree fauna adapter. |
| `nhi-body.ts` | Alien NHI bodies (CONTRACTS V10 viz) — a dedicated, menacing, morphing form for each launched NHI |
| `nhi-launch.ts` | Pure NHI launch-toss math — camera-forward cone with random fan-out. |
| `nhi-system.ts` | NHI action orchestrator (CONTRACTS V10) — the layer that makes the {@link NhiMind} ACT on the |
| `nhi-target-effects.ts` | Pure, deterministic production effects for NHI target actions. |
| `nhi.ts` | The NHI super-mind (CONTRACTS V10 — the apex non-human intelligence). |
| `noosphere.ts` | NOOSPHERE — Collective consciousness resonance field (BRUTALISM 9/9) |
| `nqs-vmc-learning.ts` | Neural Quantum State (NQS) / Variational Monte Carlo (VMC) online learning substrate. |
| `omega-point.ts` | OMEGA POINT — Convergence telos metric (BRUTALISM 7/9) |
| `online-learning.ts` | ONLINE LEARNING — the missing Stratum-X primitive: bounded, deterministic weight adaptation. |
| `open-endedness.ts` | OPEN-ENDEDNESS INSTRUMENTATION — measuring whether the soup actually evolves. |
| `pantheon-breeding.ts` | PANTHEON BREEDING — the asexual inbred hybrid game-theory mating ritual of the 101 super |
| `pantheon.ts` | PANTHEON SOCIETY — tiered 25-Archon coordination (NEO-MIND § Archon pantheon). |
| `perceptron-baseline.ts` | PERCEPTRON BASELINE — classical learner from the Tsotchke `simple_mnist` corpus. |
| `perceptual-priority.ts` | Phase 1.3: Perceptual Priority Cascades |
| `petri-dish.ts` | PETRI DISH — primordial inorganic soup for digital biologics (GOAL5 / Super Creature genesis). |
| `phyla.ts` | Phyla — the taxonomic layer above morphotypes (CONTRACTS V3.2, PANTHEON). |
| `pimc-paths.ts` | PIMC PATHS — path-integral sampling from Tsotchke mirrors/PIMC. |
| `pinn-residual.ts` | PINN RESIDUAL — physics-informed loss from Tsotchke mirrors/PINN. |
| `plastic-weights.ts` | PLASTIC / FAST WEIGHTS — within-life self-modification (Stratum X; faculties #87 + #91). |
| `portal-death-fauna.ts` | PORTAL DEATH — BIG FAUNA (V126, USER: "everything else DIES … only Super Creatures and Pantheons |
| `portal-death.ts` | PORTAL DEATH ZONE (V126, USER) — the ascension Portal (the {@link MonolithTemple} void throat) is |
| `portal-immune-bounce.ts` | PORTAL IMMUNE BOUNCE (V126, USER: "only Super Creatures and Pantheons bounce off it … flash briefly in |
| `portal-shield.ts` | PORTAL SHIELD (V126, USER) — the IMMUNE reaction. Where {@link PortalDeath} / {@link PortalDeathFauna} |
| `predictive-metacognition.ts` | PREDICTIVE METACOGNITION — a creature that knows when to trust its own forecast. |
| `primordial-soup.ts` | PRIMORDIAL SOUP — full Tsotchke-wired digital biologics birth layer. |
| `puppet-masters.ts` | Puppet-master NPCs — AETHON, SELENE, and KRONOS orbit the arena as glowing tetrahedra and |
| `qcircuit.ts` | QuantumCircuitSystem — the cosmos's quantum "mind" (CONTRACTS V2 — Quantum Wildbeyond). |
| `qge-aliveness.ts` | QGE ALIVENESS — a quantum-geometric "aliveness" factor for the quantum-quake / QGT corpus. |
| `qge-physics.ts` | QGE PHYSICS — quantum-quake / Quantum Game Engine aliveness from |
| `quality-space.ts` | HOT-4: Sparse-Smooth Quality Space (qualia manifold proxy). |
| `quantum-deliberation.ts` | QUANTUM DELIBERATION (V98) — Super Creature 1.1's OPEN-quantum-system decision substrate: a Lindblad / |
| `quantum-lattice.ts` | Quantum lattice (CONTRACTS V11 viz) — a floating neon sacred-geometry anchor: concentric, |
| `quantum-quake-physics.ts` | QUANTUM QUAKE PHYSICS — simulated quantum geometry over Gaussian wave-packet states. |
| `quantum-reservoir.ts` | Audit #218 — honesty note: as implemented this reservoir is CLASSICAL (a leaky integrator plus a fixed |
| `quantum-rng-api.ts` | Quantum-RNG-API facade — REST wrapper semantics over the ported Eshkol QRNG core. |
| `quantum.ts` | Quantum cloud — a drifting point field whose particles wobble with a per-particle psi wave, |
| `reaction-diffusion.ts` | Gray–Scott reaction–diffusion — the living skin of the ground (CONTRACTS V2). |
| `reservoir.ts` | THE RESERVOIR — an echo-state network giving the apex mind genuine TEMPORAL, recurrent dynamics |
| `resonance-integrator.ts` | STANDING-WAVE RESONANCE INTEGRATOR (V94 / Super Creature 1.1) — the NOVEL CORE faculty #59. |
| `resonance.ts` | RESONANCE INTEGRATOR — the coupling spark (faculty #59; binding #57; phase-coupling #25). |
| `self-evolution-loop.ts` | SELF-EVOLUTION LOOP (V94 / Super Creature 1.1) — faculty #99 from SUPER-CREATURE-RESEARCH-2026-06-26.md. |
| `sentience-lab.ts` | SENTIENCE LAB - headless analytics over the consciousness indicator kernel. |
| `shoggoths.ts` | Shoggoth system — a writhing swarm of eldritch horrors (100 on desktop, 16 on mobile) that drift on lorenz-flavored currents, |
| `singularities.ts` | Cosmological singularities (CONTRACTS V7.4) — the chaos control's repertoire of real |
| `social-field.ts` | SOCIAL FIELD — the organism social neighbourhood as a structure-of-arrays kernel. |
| `spin-glass.ts` | THE SPIN-GLASS INSTINCT (V84) — a biomimetic Ising/Hopfield spin lattice ported from the Tsotchke |
| `stigmergy.ts` | STIGMERGY — Collective intelligence via pheromone lattice (BRUTALISM 8/9) |
| `strange-attractor.ts` | STRANGE ATTRACTOR — Chaos engine (BRUTALISM 3/9) |
| `successor-representation.ts` | THE PREDICTIVE MAP — Super Creature 1.1's successor-representation lookahead. Where the GOAP argmax |
| `super-body.ts` | THE SUPER CREATURE — the body (V32+). The masterful, morphing, many-eyed apex form that renders the |
| `super-creature.ts` | THE SUPER CREATURES (5 Archons / pantheon, GOAL5) + legacy spine — apex minds of the Mechalogodrom (V31+). |
| `super-evolution.ts` | SUPER-CREATURE EVOLUTION (V48) — the self-evolving power/appearance arc the directive demands: |
| `super-hunt.ts` | SUPER HUNT (V127, USER "Super Creature Hunts and Eats Entities as food and fuel … They respawn right |
| `super-mind.ts` | THE SUPER MIND — the apex creature's ~10,000-parameter composite cognition model (V45; consciousness-metrics proxies only). |
| `super-qubits.ts` | THE QUANTUM COMPUTING MIND (V75) — the apex creature's simulated-qubit cognition layer, the |
| `super-wingmen-render.ts` | Wingman-swarm RENDER layer (V47) — draws a {@link WingmanSwarm}'s 100 robots as ONE InstancedMesh |
| `super-wingmen.ts` | THE WINGMAN SWARM — the SUPER CREATURE's escort of mini-robots (V47). |
| `symbiosis.ts` | INTER-MIND SYMBIOSIS & PARASITISM (V94 / Super Creature 1.1) — emergence angle #9. |
| `temple-greeble.ts` | TEMPLE GREEBLE — the abomination-architecture detail shell for the Monolith Temple. |
| `temporal-crystal.ts` | TEMPORAL CRYSTAL — Discrete Time-Crystal oscillator (BRUTALISM 5/9) |
| `tensorcore-facade.ts` | TENSORCORE FACADE — REAL GEMM + scaled-dot-product attention (leaf, exclusive owner). |
| `terrain-deformation.ts` | Band-limited four-octave detail base; 600 ground segments resolve its 5.35-sample wavelength. |
| `terrain-profile.ts` | Shared static terrain profile. |
| `thaler-sentience.ts` | THALER SENTIENCE — a full mini "Creativity Machine" enacting Stephen Thaler's OWN consciousness test |
| `theory-of-mind.ts` | THEORY OF MIND (V94) — Super Creature 1.1's sixth pillar: SOCIAL cognition. The other five pillars model |
| `titans.ts` | TITANS (CONTRACTS V3.3) — 20 colossal roaming intelligences running a global economy and |
| `tom-pantheon.ts` | THEORY OF MIND PANTHEON — 25 deterministic organs for social cognition, wired into the apex mind as an |
| `topdown-perception.ts` | HOT-1: Genuine Top-Down Generative Perception Loop. |
| `tree-creature-brain.ts` | CRYSTAL BIG TREE CREATURE BRAIN — a deterministic, fixed-size neural controller for the peaceful |
| `tree-creature-teaching.ts` | TREE-DWELLER PEER TEACHING — a real, bounded policy-transfer mechanism between Big Tree residents. |
| `tsotchke-brain-intake.ts` | TSOTCHKE BRAIN INTAKE — the full-corpus intake for the BRAINS. |
| `tsotchke-corpus.ts` | TSOTCHKE LEGACY BINDING TABLE — 20 locally mirrored projects mapped to Cosmogonic leaves. |
| `tsotchke-deep-wire.ts` | TSOTCHKE DEEP WIRING — integration of Moonlab, libirrep, and Eshkol compiler. |
| `tsotchke-ecology-predictor-v2.ts` | Deterministic successor ecology predictor. |
| `tsotchke-ecology-predictor-v3.ts` | Deterministic causal-history ecology predictor. |
| `tsotchke-ecology-predictor.ts` | Deterministic online ecology predictor for the live simple_mnist Tsotchke lane. |
| `tsotchke-facade.ts` | TSOTCHKE CORPUS FACADE — re-exports from exclusive leaves + archetype bias tables. |
| `tsotchke-oct2026-wave.ts` | Tsotchke October 21, 2026 Full 27-Repository Stack & Flagship Zig WASM Bridge |
| `tsotchke-organism-intelligence.ts` | SHARED TSOTCHKE ORGANISM INTELLIGENCE |
| `tsotchke-registry.ts` | TSOTCHKE CORPUS REGISTRY — BINDING LEDGER PER docs/TSOTCHKE-INTEGRATION-MAP-2026-06-26.md |
| `ulg-bridge.ts` | ULG BRIDGE — REAL closure-table field + content-addressed artifact handoff. |
| `valence-steering.ts` | VALENCE-STEERS-BEHAVIOUR (V94 / Super Creature 1.1) — faculty #71, SENTIENCE #15. |
| `vegetation.ts` | Ground height sampler for attaching plants to moving/ deformed ground (user #15). |
| `viz-benchmarks.ts` | Dynamic visual benchmark shaders (25 × 25-point mega-report suite). |
| `viz3d.ts` | VIZ3D (CONTRACTS V4.2, XENOGENESIS) — floating holographic data sculptures: the in-scene |
| `vqe-drive-resolver.ts` | VARIATIONAL-QUANTUM DRIVE RESOLVER |
| `waste-ecology.ts` | XENO WASTE ECOLOGY — metabolic pollution as fertilizer + self-building alien constructs. |
| `weather.ts` | Weather system — drives wind, temperature, fog density/color, and tone-mapping exposure |
| `wilderness-chunks.ts` | STAGE 3 (per ADR 0010) — the wilderness CHUNK GRID. |
| `wilderness-population.ts` | Wilderness Population System (ADR 0010) |
| `wilderness-render.ts` | Wilderness visual layer — intentionally a NO-OP. |
| `xenomimic-brain.ts` | XENOMIMIC BRAIN — a bipolar twin mind using exact classical statevector math (NOT sentient). |
| `xenomimic-connectome.ts` | Xenomimic connectome — topology accounting only (twin + entity proximity counts for HUD). |
| `xenomimic-tether-purge.ts` | Legacy xenomimic tether destruction — the enforcement half of the tether law (owner 2026-07-13: |
| `xenomimics-render.ts` | XENOMIMIC RENDERER — ten indexed, instanced ground-horror morphs. |
| `xenomimics.ts` | XENOMIMIC POPULATION — the ground-dwelling cosmic-horror fauna (deterministic first-class citizens). |
| `xenomind.ts` | XENOMIND — Alien substrate mind (BRUTALISM 4/9) |
| `xylos-body.ts` | Xylos is an aperture surrounded by six unequal, folded Möbius membranes. Its 48 luminous foci |
| `xylos-habitat.ts` | Bounded Xylos ⇄ Gray–Scott loop. Numeric senses are not text prompts or tokens. |
| `xylos-mind.ts` | Xylos: a bounded, tokenless recurrent manifold with autonomous numeric sensing/action. |

## `src/sim/ai/`

| Module | What it does |
| --- | --- |
| `brains.ts` | The deterministic classical-AI kernel (CONTRACTS V9 — "how AI was done before the transformer"). |

## `src/ui/`

| Module | What it does |
| --- | --- |
| `access-code.ts` | ACCESS CODE — the pure, testable heart of the cryptographic access puzzle (V34). "Only the Romans |
| `access-puzzle.ts` | ACCESS PUZZLE (V34) — the wild cryptographic GUI that gates the SECOND super creature. A CIA/NSA/ |
| `algo-picker-shell.ts` | Early-mount the sorting-field list so #algo-list is never empty during WebGL boot (FOUC). |
| `audit-dock.ts` | AUDIT dock toggle (V51) — moves the audit trail OFF the crowded left column (where it squeezed |
| `boot-loader.ts` | BOOT LOADER controller (V121, USER #6) — feeds the #cqm-boot overlay REAL boot telemetry and |
| `bottom-dock.ts` | Unified bottom dock stack (V86): Docs/Spec/Lab/Access/Set, panel launcher, and toolbar |
| `brain-slots.ts` | Brain slot mini visualizers (V108, V121) — live, compact previews of the three deep minds. |
| `center-hud.ts` | CENTER HUD (V56) — unifies the inspector panels (AI · HELP · AUDIT · NEURAL · MARKET · ARCHITECT · |
| `copilot.ts` | Copilot chat panel (CONTRACTS V9 — UI shell, NOT a sim system). |
| `graphs.ts` | Canvas sparkline graphs for the telemetry panel. |
| `help-knowledge.ts` | HELP KNOWLEDGE BASE (V36) — the repo-grounded RAG behind "HELP ME NOW". A curated, DOM-free corpus |
| `help-system.ts` | HELP ME NOW (V36) — the in-world help system the directive asks for, beside DOCS / SPECS / ✦ AI. |
| `hud.ts` | Heads-up display: sector banner (`#sec`), puppet-master toast (`#nm`), the algorithm |
| `input.ts` | Input system: keyboard state, control-pad buttons (`[data-a]`), toolbar buttons |
| `market-ticker.ts` | Market Ticker (CONTRACTS V23; V71 three-section pass) — a self-building panel that makes the economy |
| `nhi-observatory.ts` | NHI Neural Observatory (CONTRACTS V15; V75 dimensional-liveness pass) — a self-building inspection |
| `observatory.ts` | Observatory — the live data-viz panel (CONTRACTS V3.5 + V4.3 multi-page XENOGENESIS + |
| `onboarding.ts` | ONBOARDING OVERLAY (V81) — a one-time, dismissible first-run hint. |
| `panel-dock.ts` | The PANEL DOCK (V33) — one self-mounting bottom-right MENU BAR that every floating inspector toggle |
| `panel-edge-toggles.ts` | PANEL EDGE TOGGLES (V98) — small side buttons that let the user hide/show the |
| `panel-shell.ts` | PANEL SHELL (V81) — shared chrome for self-mounting UI panels. |
| `panels.ts` | Telemetry panel renderer + collapsible panel toggles. |
| `pantheon-architecture-panel.ts` | ⟁ ARCHITECTURE — the Dome's super-creature architecture cycler (GOAL: "101 Super Creatures … |
| `perf-hud.ts` | STAGE 1+ — perf HUD (render / UI layer — NOT src/sim, NOT src/math). |
| `settings-panel.ts` | SETTINGS PANEL (V81) — a single place for the persistent simulation controls. |
| `super-neural-brain.ts` | Two fixed-camera views of selected PRIME Archon state and code-path measurements. This partial |
| `super-neural-data.ts` | Pure numeric provenance for the 27 PRIME Archon cards. No clock, paint state, RNG, or simulation writes. |
| `super-neural.ts` | PRIME Archon observatory: 27 source-stamped measurement cards (tabs I–III) plus IV · BRAIN, the |
| `super-panel.ts` | SUPER CREATURES (5 / pantheon) telemetry — the ⬢ ARCHITECT panel (V31+GOAL5). A self-building HUD readout that makes the |
| `superhero-hud.ts` | SUPERHERO HUD (V35) — the player-as-creature overlay the access puzzle unlocks. When ACCESS GRANTED |
| `superhero-state.ts` | SUPERHERO STATE (V35) — the pure, testable progression model behind the player-as-creature mode the |
| `temple-access.ts` | TEMPLE ACCESS (V124) — the SECOND access button: an "ultra trans-dimensional Box Window" that |
| `temple-code.ts` | TEMPLE CODE (V124) — the DOM-free, unit-tested check behind the trans-dimensional temple access box |
| `toolbar.ts` | Toolbar keyboard navigation + scroll shell. |
| `ui-columns.ts` | UI column layout (V87): groups side panels into flex stacks so boxes stay stacked, |
| `ulg-bridge.ts` | ULG BRIDGE — Universal Language Gateway web integration from Tsotchke corpus. |
| `xenomimic-panel.ts` | XENOMIMIC inspector — a live cockpit over the canonical entangled-twin ground fauna. |
| `xylos-panel.ts` | Xylos observation surface: borrowed telemetry, bounded drawing, explicit experiment controls. |

## `src/workers/`

| Module | What it does |
| --- | --- |
| `simulation-worker.ts` | Phase 3.1: Multi-Threaded Simulation & Wilderness Worker Script |
| `social-field-worker.ts` | Social-field worker: answers one range of a packed social snapshot off the main thread. |

