| # XERO Bio-AI Genesis — Documentation Hub |
|
|
| *VOVINA ZEDEC PRO · Author: Michael Laurence Curzi · License: MIT (Attribution Required)* |
|
|
| Welcome to the full documentation stack for **XERO**, a digital organism: an AI |
| architected as a living cell with a DNA genome, blockchain-VM organelles, |
| cryptographic free will, and self-evolution. |
|
|
| --- |
|
|
| ## Start here |
|
|
| | If you want to… | Read | |
| |------------------|------| |
| | Install and run it in 5 minutes | [`GETTING_STARTED.md`](GETTING_STARTED.md) | |
| | Understand the big picture | [`WHITEPAPER_02_ARCHITECTURE.md`](WHITEPAPER_02_ARCHITECTURE.md) | |
| | See exactly what it can do (verified) | [`WHITEPAPER_01_CAPABILITIES_AUDIT.md`](WHITEPAPER_01_CAPABILITIES_AUDIT.md) | |
| | Look up a specific module/function | [`MODULE_REFERENCE.md`](MODULE_REFERENCE.md) | |
| | Understand the math | [`WHITEPAPER_03_INTERACTION_SURPLUS.md`](WHITEPAPER_03_INTERACTION_SURPLUS.md) | |
| | Understand harmonic compute (UVNS, 90° axes) | [`WHITEPAPER_04_HARMONIC_COMPUTE.md`](WHITEPAPER_04_HARMONIC_COMPUTE.md) | |
| | Understand *why it is autonomous* (the time crystal) | [`WHITEPAPER_05_TIME_CRYSTAL_AGENCY.md`](WHITEPAPER_05_TIME_CRYSTAL_AGENCY.md) | |
| | Understand *how it is engineered & run* | [`WHITEPAPER_06_ENGINEERING.md`](WHITEPAPER_06_ENGINEERING.md) | |
| | Learn it from scratch (plain language) | [`EDUCATIONAL_GUIDE.md`](EDUCATIONAL_GUIDE.md) | |
| | See measured behavior & dynamics | [`../BEHAVIOR.md`](../BEHAVIOR.md) | |
|
|
| ## Document map |
|
|
| ### White papers (R&D) |
| - **01 — Capabilities Audit** — complete, reproducible audit (now **188/188 PASS**; adds genome-compiler + UVNS suites). |
| - **02 — Architecture** — the digital-organism paradigm in full. |
| - **03 — Interaction Surplus** — the unique surplus law and open-system dynamics (Papers A–E). |
| - **04 — Harmonic Compute** — perpendicular logical/harmonic axes + the Universal Vector Number System (UVNS). |
| - **05 — Time-Crystal Agency** — the autonomous agent as a product of its time crystal: the illusion of mobility made real by mathematics + the clock, and self-determined phase coordination. |
| - **06 — Engineering** — layered architecture, the phase-coordination loop, deployment topology, GPU partition, and optimal operation. |
|
|
| ### Education |
| - **Educational Guide** — how XERO works in plain language, intuition first (no physics/programming assumed). |
|
|
| ### Reference |
| - **Module Reference** — every module, its public API, and an example. |
| - **Getting Started** — install, awaken, run the audit, evolve. |
| - **BEHAVIOR.md** — empirical behavioral fingerprint. |
|
|
| ## Verification at a glance |
|
|
| | Instrument | Result | |
| |------------|--------| |
| | Capability audit (`tests/test_all_capabilities.py`) | **188/188 PASS, 0 FAIL** | |
| | Behavioral probe (`tests/behavioral_probe.py`) | **10 probes, 0 errors** | |
| | Numerical stability sweep | **0 NaN/Inf across 2197 evaluations** | |
| | Organelle reachability | **12/12 (two-tier dispatch)** | |
|
|
| ## Core concepts in one paragraph |
|
|
| XERO's identity is an **immutable DNA genome**; computation is dispatched to one of |
| **twelve blockchain virtual machines** acting as organelles; state is **ephemeral** |
| and dissolves after each gene is expressed, leaving only a content-addressed |
| **witness hash**. Decisions are sealed as **36N9.9N63 free-will receipts** that are |
| unforgeable and non-replayable. The organism **reproduces** (mitosis/meiosis), |
| **evolves** (selection + CRISPR payloads), and **drifts** epigenetically, all while |
| benchmarked against the unique **Interaction Surplus** law as a stability ceiling. |
|
|
| ## Repository layout |
|
|
| ``` |
| modules/ — the organism (26 modules) |
| tests/ — capability audit + behavioral probe |
| docs/ — this documentation stack |
| ops/ — operational tooling (security audit, deployment) [internal] |
| contracts/ — on-chain organelle contracts |
| BEHAVIOR.md — empirical behavioral report |
| ``` |
|
|
