# V9 — Dependencies (Metis: A Curious Ape's Guide to Reality)

Status: dependency graph for V9. Date: 2026-06-13. Companion:
`V9_ARCHITECTURE.md` (how these compose), `V9_GAP_ANALYSIS.md` (what is real vs.
missing in each).

V9 reuses far more than it creates — the defining property of a _productization_
version. This document lists what V9 **reuses** (existing Oshun surface), what
it **creates** (net-new connective tissue), and what is **new external** (new
third-party dependencies). Internal items cite the in-repo surface; see
`V9_GAP_ANALYSIS.md` for the file-level reality of each.

---

## 1. Reuse — existing Oshun domains (the ~80%)

### 1.1 Education spine

| Domain        | Surface                                                                   | V9 use                                                                                                                                                                                           |
| ------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Metis**     | `services/metis/` (FastAPI/SQLAlchemy/Celery; 16 routers), `libs/metis/*` | Course/lesson model, source-grounded generation, **live-voice tutoring**, assessment + IRT calibration, concept graph, credentials, LMS interop, curriculum safety policy, the core-six taxonomy |
| **Mnemosyne** | `libs/mnemosyne/{core,polyglot,classical-tools,...}`                      | Spaced repetition (FSRS/SM-2), knowledge tracing (BKT/DKT), IRT/CAT, mastery, prerequisite reasoning, gamification primitives                                                                    |

### 1.2 Knowledge & science kernels

| Domain                 | Surface                                                                                                   | V9 use                                                                                                                                         |
| ---------------------- | --------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nyx**                | `libs/nyx/{ephemeris,renderer-*,catalog-*,constellations,events,observation-planner}`, `apps/nyx/*`       | The live cosmos: WebGL planetarium, real ephemeris (VSOP87/ELP), star/deep-sky catalogs, "time-travel," exoplanets — the astronomy explorables |
| **Kalika**             | `libs/kalika/{cas-engine(Rust+WASM),notebooks,quantum-mechanics,general-relativity,...}`, `apps/kalika/*` | Computed math & physics explorables: symbolic algebra, reactive notebooks, physics kernels                                                     |
| **Sophia**             | `libs/sophia/{indexing,vectordb,knowledge-graph,citation-analysis,evaluation}`                            | Grounding: hybrid retrieval, vetted-source pins, knowledge graph, citation credibility — the Aletheia G1 backbone                              |
| **Nous**               | `libs/nous/{core,llm,vision,training,safety}`                                                             | Model plane: local/sovereign inference, embeddings, vision (e.g., identify a photographed constellation), cost/privacy                         |
| **Nisaba**             | `libs/nisaba/{languages,criticism,canon,corpora,annotations,paleography}`                                 | Grounded historical personas + history-of-ideas / ancient-text lessons (25+ languages, canonical references)                                   |
| **Demeter / Airmid**   | `libs/demeter/*`, `libs/airmid/*`                                                                         | Living-world axis: botany, ecology, plant science, botanical medicine                                                                          |
| **Saraswati / Seshat** | `libs/saraswati/*`, `libs/seshat/*`                                                                       | Made-world axis: real industrial telemetry (batteries/solar/EVs), craft/materials/fabrication                                                  |

### 1.3 Generative content factory

| Domain      | Surface                                                                                            | V9 use                                                                                               |
| ----------- | -------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| **Isis**    | `libs/isis/{workflows,comfyui-nodes,ai-providers,3d-generation,ai-video}`                          | Lesson visuals, diagrams, the Chiron face, illustrative B-roll (provenance-stamped)                  |
| **Yemaya**  | `libs/yemaya/{agents,autonomous-pipelines,orchestration,quality-assurance,hitl,budget-management}` | Prometheus orchestration: HTN-planned pipelines, 76 quality validators, mid-pipeline HITL, cost caps |
| **Hathor**  | `libs/hathor/{llm-npc,narrative,domain-models}`                                                    | Chiron persona/personality + Socratic dialogue generation; myth/story for the soulful braid          |
| **Psyche**  | `DOMAINS/psyche` (avatar/voice/Conductor, Living Scenes)                                           | The embodied Chiron: real-time avatar, voice, lip-sync, turn-taking, emotion recognition             |
| **Euterpe** | `DOMAINS/euterpe` (DAW/music)                                                                      | Adaptive lesson scores and audio                                                                     |
| **Iris**    | `libs/iris/{agents-core,conversation-*,memory,mcp,model-orchestration}`                            | THE shared agent runtime + model orchestration; V9 spawns no new agent loop                          |

### 1.4 Platform, safety, governance, experience

| Domain / version                                       | Surface                                                       | V9 use                                                                                                                                        |
| ------------------------------------------------------ | ------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **V1 platform**                                        | identity, billing, BFF, Agentic AI Studio, Isis control plane | Account, subscription, the governance plane (AgentRun envelopes, budgets, kill switches, generation ledger), the seven-gate enforcement point |
| **V3**                                                 | C2PA-on-every-export, voice-clone consent registry            | Provenance + consent for personas                                                                                                             |
| **V7 (Mawu)**                                          | Sekhmet safety, creator distribution                          | Age-gating/safety floor + the Agora creator commons                                                                                           |
| **meditation**                                         | `libs/meditation/*` (8 engine libs)                           | The contemplative braid (neuroscience-of-attention ↔ a meditation session); offline-engine pattern                                            |
| **V2–V8 games**                                        | UE5.5 substrates                                              | Learn-by-playing explorables (P2/P3)                                                                                                          |
| **`apps/metis/{web,mobile,admin,api-gateway,worker}`** | existing scaffold                                             | The base for the consumer experience layer (currently instructor/admin-shaped → rebuilt consumer-first)                                       |

---

## 2. Create — net-new V9 connective tissue (the ~20%)

| New component                                                                    | What it is                                                                                                                                                                                            | Subsystem       |
| -------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- |
| **Atlas knowledge graph + wonder-resolver**                                      | Unify Metis/Sophia/Mnemosyne graphs + domain data into one navigable "map of reality"; resolve free-text wonders → concept nodes → learner-scoped prerequisite frontier; render the personal star-map | Atlas           |
| **Lesson HTN templates + "realize-the-skeleton" constraint layer**               | The Prometheus pipeline definitions and the layer that holds LLM output to the verified ground truth                                                                                                  | Prometheus      |
| **Grounding + accuracy gate (kernel-recompute)**                                 | The Aletheia verifier that binds every claim to a source and recomputes every STEM value                                                                                                              | Aletheia        |
| **Teacher-persona system + integrity-mode dialogue + cross-session memory glue** | Bind Psyche + Hathor + Metis live-voice + Mnemosyne memory into a coherent, remembering Chiron                                                                                                        | Chiron          |
| **Hephaestus explorable runtime**                                                | Kernel→browser bindings (Nyx/Kalika), the generative-widget verifier, game-bridge adapters                                                                                                            | Hephaestus      |
| **Theia wonder-director**                                                        | Answer/scaffold/thread decisions, thread continuation, the emotional arc, the science↔human braid                                                                                                     | Theia           |
| **Consumer experience layer**                                                    | The consumer-first web/mobile app: ask-a-wonder front door, lesson player, explorable canvas, personal Atlas map                                                                                      | L6 / Experience |
| **Seven-gate suite (learning-specialized)**                                      | The G1–G7 eval suites as gate suites in the platform content-release gate                                                                                                                             | Governance      |

---

## 3. New external dependencies

V9 deliberately minimizes net-new external dependencies — almost everything is
already vendored by the domains it composes.

| External                                             | Why                                                                                                                          | Notes / risk                                                                                                                                                                            |
| ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Manim (ManimCE)** + an LLM-to-Manim pipeline       | Precise, accurate math/physics explainer animation (the only path to correct on-screen equations — `V9_SOTA_RESEARCH.md` §2) | Render-reliability is the known open problem; requires the validation/self-repair loop (G5). Driven from _verified_ Kalika derivations, not free text                                   |
| **Embodied-avatar capability**                       | Chiron's face/voice                                                                                                          | Primary path is Oshun's own **Psyche**; a SaaS avatar (Synthesia/HeyGen/D-ID class) is a possible fallback, not a dependency. **Do NOT depend on OpenAI Sora** (app shut down Apr 2026) |
| **Cinematic video model (illustrative B-roll only)** | Optional decorative scenes                                                                                                   | Vendor-diversify (Veo/Runway class); never the teacher or the source of facts. Treat as swappable                                                                                       |

No new datastore, no new model provider beyond what Iris/Nous already broker, no
new identity/billing/safety system.

---

## 4. Reuse DAG (where V9 sits)

```
V1 (platform: identity, billing, Agentic AI Studio governance, Isis control plane, BFF)
├── Metis (education backend: generation, tutoring, assessment, credentials) ─┐
├── Mnemosyne (spaced repetition, knowledge tracing, mastery) ────────────────┤
├── Nyx (cosmos kernel + WebGL planetarium) ──────────────────────────────────┤
├── Kalika (math/physics CAS kernel + WASM + notebooks) ──────────────────────┤
├── Sophia (grounding/RAG/KG)  Nous (model plane)  Nisaba (texts) ────────────┤
├── Isis / Yemaya / Hathor / Psyche / Euterpe (generative content factory) ────┤
├── Iris (shared agent runtime + model orchestration) ─────────────────────────┤
├── meditation (contemplative engine libs) ───────────────────────────────────┤
│                                                                              │
│                                                              ┌───────────────▼──────────────┐
│                                                              │  V9  Metis — A Curious Ape's │
│                                                              │  Guide to Reality            │
│                                                              │  (Atlas, Prometheus,         │
│                                                              │   Aletheia, Chiron,          │
│                                                              │   Hephaestus, Theia, Agora)  │
│                                                              └───────────────┬──────────────┘
├── V3 (C2PA + consent) ───────────────────────────────────────────────────────┤ provenance/consent
├── V7 (Sekhmet safety + Mawu distribution) ────────────────────────────────────┤ safety/commons
└── V2–V8 (game substrates) ────────────────────────────────────────────────────┘ learn-by-playing (P2/P3)
```

V9 consumes the platform and the domains as services; it shares the V-series
account/entitlement graph (`V_SERIES_PLATFORM_CONSOLIDATION.md`) so learning and
play feed each other on one account. The only one-way external-liveness
dependency at P2/P3 is the game-bridge, which (like V6's Aye Bridge and V8's
Daedalus relay) requires the target realms + the Bellona cook path to be live.
