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.