# V8 — Dependencies (Ariadne: The Self-Authoring Detective Universe) Status: dependency graph for V8. Date: 2026-06-04. Pairs with `V8_ARCHITECTURE.md` (§6 deployment shape) and `V8_TODOS.md`. `deps§N` references point here. V8 is an integration version: it adds **one generative core + one bridge** and reuses everything else. The dependency story is therefore mostly _internal_ — V8 depends on already-shipped Oshun systems — with a small set of new externals. --- ## 1. Internal (in-repo) dependencies — REUSED, must exist & be wired | # | V8 needs | Provided by (existing) | Used at stage | | --- | ------------------------------------------- | -------------------------------------------------------------------------------------- | ------------------------------- | | 1 | Playable detective game + case data structs | `V5/ue` `V5MindPalace`, `V5DetectiveColdCases` | compile target (8), runtime (9) | | 2 | On-disk case schema + validator | `V5/tools/cold-cases/validate-cold-cases.py`, `…/cold_cases_manifest.json` | compile (8) | | 3 | Mystery fairness scoring | `libs/yemaya/agents/.../mystery-fairness-validator.ts` | verify (3) | | 4 | Investigation balance scoring | `libs/yemaya/agents/.../investigation-mechanic-balance-analyzer.ts` | verify (3) | | 5 | Multi-agent orchestration substrate | `libs/yemaya/agents` `WorkflowBuilder`/`StateGraph`/`WorkflowExecutor` | all agent stages | | 6 | Creative agent base + specialists | `libs/yemaya/agents/src/creative` `CreativeAgent`, StoryDirector/Character/Dialogue | realize (5) | | 7 | Asset generation client | `libs/isis/client` `IsisClient.submitJob/submitBatch/submitAndWait` | assets (6) | | 8 | Asset providers (image/music/tts/3d/video) | `libs/isis/ai-providers` (Stability/Flux, Suno/Udio, ElevenLabs, Hunyuan3D/Meshy, LTX) | assets (6) | | 9 | LLM-NPC dialogue | `libs/hathor/llm-npc` `DialogueGenerator` | suspects (6/9) | | 10 | Portable agent identity (suspect minds) | V6 **Ori** (`V6/V6_features.md` §"The Ori"; `apps/v6` ori-service) | suspects (6) | | 11 | LLM provider routing | `apps/lilith/svc-ai` llm-orchestration; isis LLM providers | all agent stages | | 12 | Knowledge/grounding client | `libs/sophia` (`@sophia/client`) RAG | canon (3/4) | | 13 | Cost/budget governance | `libs/yemaya/budget-management` | cross-cutting (11) | | 14 | Human-in-the-loop review | `libs/yemaya/agents/src/hitl` | repair/escalation (3/7/11) | | 15 | Provenance / C2PA | V3 `C2PA_EVERY_EXPORT.md` pipeline | publish (9/11) | | 16 | Trust & safety scanning | V7 **Sekhmet** (`apps/v7` sekhmet-scanner) | eval/publish (7/9) | | 17 | Online services / multiplayer | `V5` online services (parties, sync) | co-op cases (9/11) | | 18 | Event bus / queues | Redis (docker infra), yemaya `queue` | pipeline transport | | 19 | Persistence + vectors | Postgres + pgvector (docker infra); Neo4j (optional profile) | canon graph (3/4) | | 20 | Object storage for assets | MinIO dev / S3 prod (docker infra) | assets (6/9) | | 21 | Localization / accessibility | V6 loc + accessibility; V7 loc | cross-cutting (11) | | 22 | Adversarial eval gate harness | V7 `ADVERSARIAL_EVAL_GATES.md` pattern | CI gates (7) | **Risk note:** items 3–6, 9 are real but #C-gap "scaffold/template" in places (`gap§1C`). V8 Phase 5–6 explicitly _promotes_ them to live before depending on them in anger. --- ## 2. New in-repo libraries/apps V8 creates | New package | Subsystem | Kind | | ----------------------------------------- | --------------------------------------- | ---------------------- | | `libs/yemaya/case-contracts` | shared IRs + V5 compile-target schema | TS types | | `libs/yemaya/case-engine` | **Clew** ground-truth + clue derivation | TS + symbolic | | `libs/yemaya/case-verifier` | **Minos** CSP/ASP + fairness gate | TS + ASP sidecar | | `libs/yemaya/canon-graph` | **Palimpsest** KG + SCORE retrieval | TS + pg/pgvector/neo4j | | `libs/yemaya/case-writers-room` | **Anansesɛm** realization DAG | TS agents | | `libs/yemaya/case-assets` | **Loom** Isis orchestration | TS | | `libs/yemaya/case-suspects` | **Ori-Detective** suspect minds | TS + V6 bridge | | `libs/yemaya/case-eval` | **Theseus** solver + judge | TS agents | | `libs/yemaya/case-director` | **Oracle** drama manager | TS | | `libs/v8/metis-detective-learning-bridge` | released-clue reasoning education | TS; no case authority | | `apps/v8/loom-service` | orchestrator BFF | Nest/TS | | `apps/v8/daedalus-compiler` | case→V5 build tool | TS/CLI | | `apps/v8/minos-asp-sidecar` | ASP/clingo solver service | container | | `V8/ue/Plugins/V8_Ariadne_CaseClient` | runtime fetch + interrogation | UE5 C++ | All new libs follow the repo "new library" rule (`project.json`, `package.json`, `tsconfig.json`, path mapping in `tsconfig.base.json`, full tests). Per `CLAUDE.md`. --- ## 3. New external dependencies | External | Why | Env var | Notes | | ------------------------------------------------------------ | --------------------------------------- | ------------------------------------------ | ------------------------------------------- | | ASP solver — `clingo` (Potassco) | Minos formal unique-solution proof | — (bundled container) | OSS; alt: TS CSP lib `@mZ1n/csp` or z3 wasm | | NVIDIA ACE (Riva ASR, Audio2Face/NIM) | runtime live interrogation, lip-sync | `OSHUN_NVIDIA_ACE_*` | UE5 plugin + cloud NIM; on-device option | | Inworld (or Convai) runtime NPC | live suspect dialogue + MetaHuman drive | `OSHUN_INWORLD_API_KEY` / `OSHUN_CONVAI_*` | "Covert Protocol" pattern (`sota§4`) | | (already have) Anthropic/OpenAI | agent LLMs | `ISIS_ANTHROPIC_API_KEY` etc | via isis/lilith providers | | (already have) Stability/Suno/ElevenLabs/Meshy/Hunyuan3D/LTX | case assets | `OSHUN_*` / `ISIS_*` | via isis | ACE/Inworld are the **only** genuinely new third-party runtime deps. Everything else is either already wired in Oshun or OSS. Fail-closed: without ACE/Inworld creds, interrogation falls back to V5's existing authored dialogue-tree path (generated offline by Anansesɛm), so V8 still produces playable cases. --- ## 4. Dependency ordering (what must land before what) ``` case-contracts ─┬─► case-engine(Clew) ─► case-verifier(Minos) ─► case-writers-room(Anansesɛm) │ ▲ ▲ │ canon-graph ─┘ (existing fairness validator as gate) ▼ (Palimpsest) case-assets(Loom)+case-suspects(Ori) │ ▼ daedalus-compiler ─► loom-service(BFF) ─► UE plugin │ case-eval(Theseus) gates publish │ case-director(Oracle) places in world ``` Cross-cutting (budget, HITL, provenance, safety, determinism, multiplayer, loc, a11y, telemetry) wire in alongside from Phase 1 and harden in Phase 11.