Engineering Reference · Go Source
Olympus Internals
Honest, code-grounded documentation of every subsystem. Each page covers what the component actually does today, how it is wired, and where it diverges from the Dark Forge spec.
Components
Subsystem index
flowchart TD
subgraph TUI["Shell — BubbleTea"]
Input["Keyboard / slash commands"]
end
subgraph Bridge["DFGAdapter — TUI bridge"]
Registry["CommandRegistry"]
EventBus["EventBus"]
end
subgraph Core["Zeus — control plane"]
Zeus["Zeus\norchestrator"]
Hermes["Hermes\nprovider router"]
Compress["Compression\nsidecar"]
History["Conversation\nhistory"]
end
subgraph Loop["Dark Forge loop — loopdriver"]
Phases["Phases 1–5\nPreflight → Merge"]
SM["StateMachine\ncapacity gating"]
DG["DispatchGates\nvalidation"]
end
subgraph Providers["Provider layer"]
Ollama["Ollama local"]
Cloud["Cloud providers"]
end
Input --> Bridge
Bridge --> Zeus
Zeus --> Hermes
Zeus --> Compress
Zeus --> History
Hermes --> Ollama
Hermes --> Cloud
Zeus -.->|zeusLLMInvoker| Phases
Phases -.->|disconnected| SM
Phases -.->|disconnected| DG
style TUI fill:#1e2430,color:#D8DEE9,stroke:#4C566A
style Bridge fill:#2e2535,color:#D8DEE9,stroke:#8b6fc7
style Core fill:#1a2535,color:#D8DEE9,stroke:#5E81AC
style Loop fill:#2a2020,color:#D8DEE9,stroke:#BF616A
style Providers fill:#1a2e20,color:#D8DEE9,stroke:#A3BE8C
Dashed lines indicate connections that exist in spec or code but are not yet wired into the live runtime.
The internal/orchestrator/ package tree is a temporary namespace that will be dissolved —
Zeus is the orchestrator; there is not a second one
(issue #64).
| Component | Role | Status | Page |
|---|---|---|---|
| Zeus | Smart LLM client with history, compression, and provider routing | Live | zeus-internals → |
| Hermes | Capability-aware provider waterfall with complexity scoring | Live | hermes → |
| DFGAdapter | TUI-to-Zeus bridge: command registry, event bus, streaming | Live (to be absorbed into Zeus — issue #62) | dfgadapter → |
| loopdriver | 8-phase Dark Forge agentic loop (phases 1–5 implemented) | Partial | loopdriver → |
| StateMachine | Capacity-aware phase gate: Green / Orange / Red tiers | Implemented, disconnected | statemachine → |
| DispatchGates | Pre-dispatch validation: coverage, TL delegation, batch sizing | Implemented, disconnected | dispatch-gates → |
Roadmap
Planned components (not yet implemented)
| Name | Role | Tracking |
|---|---|---|
| Athena | Structured multi-step reasoning engine | Planned |
| Hephaestus | Code generation with diff output and auto-apply | Planned |
| Mnemosyne | Persistent cross-session memory | Planned |
| Aegis | Security guardrails and prompt sanitisation | Planned |
| dfg binary | CLI used by Dark Forge phase specs for governance operations | Referenced in specs, not implemented |