Code map
This section is generated from a knowledge graph of the v0.11 release line: every source file, its significant functions and classes, and how they import and call each other.
Open the interactive explorer → Pan, zoom, search by name or meaning, follow a node’s neighbours and take the guided tour inside the graph.
At a glance
Section titled “At a glance”| Count | |
|---|---|
| Files analyzed | 233 |
| Functions | 1140 |
| Classes | 18 |
| Import edges | 777 |
| Call edges | 1022 |
| Layers | 10 |
| Tour steps | 14 |
Tests, fixtures, the acceptance campaign and prose documentation were left out of the analysis; the prose docs are under Source documents instead.
Layers
Section titled “Layers”| Layer | Files | What belongs there |
|---|---|---|
| CLI Entry, Build and Project Tooling | 20 | The thin Commander dispatcher (src/cli.ts) and public package entry, plus the package/tsconfig/bunfig/Vitest configuration, esbuild build, docs-sync and doc-link scripts, and deterministic smoke harnesses (fake OMP and Command Code probes) that exercise the built uh CLI. |
| Artifact Schemas | 22 | Zod contracts for every persisted .harness artifact (project, adapter manifests and capabilities, missions, runs, runtime control, teams, queues, workflows, hive, interventions, decisions, prices, observatory) that all other layers validate against. |
| Mission Lifecycle and Artifact Store | 19 | Project initialization, mission and spec authoring (propose, check, put, templates, test scaffolds), skill and adapter registries, session templates, and the canonical .harness path builders, run-id plumbing, atomic artifact transactions and hash chains. |
| Runtime Execution and Supervision | 28 | Dispatch-prompt construction, adapter routing and capability/fleet preflight, sandboxes, the runtime process runner with its Windows guardian, and supervision, recovery, settlement, usage capture, Tool Guard arming and shadow loop watchdog over native runtime events. |
| Run Control and Team Coordination | 14 | Live-run registry and operator controls (kill, wait, steer, cancel, intervention ledger) plus multi-run orchestration: dependency-ordered queue, team worker waves with resource admission, staged workflows, cross-runtime run-all, matched-budget experiments and the shared hive knowledge store. |
| Observability, Accounting and Reporting | 17 | Read-only projections of harness state: uh status and status –json, run reports and live run digests, the Delivery Observatory snapshot, read-only MCP server, cost tables/forecasts and runtime accounting, experience store, decision receipts, notifications, OTLP export and opt-in PostHog telemetry. |
| Verification, Review and Promotion | 25 | Mission verification checks and output validation, post-checks, verdicts, independent review preparation and guards, spec-adherence and TypeSafe judges, acceptance campaigns, adversarial-QA gates, artifact schema validation with drift detection, and gated promote/land of verified work. |
| Runtime Adapters and In-Runtime Extensions | 33 | Runtime-specific execution for Hermes, Hermes proxy, Codex, OpenRouter, Pi, oh-my-pi, Claude Code, Command Code, ACP and experimental Anthropic with their capability manifests, plus in-runtime extensions: Tool Guard hooks for Claude Code, Command Code and OMP, and optional Honcho memory. |
| Mission Control TUI | 17 | OpenTUI/Solid terminal Mission Control launched by uh tui under Bun: dashboard, editor, keymap, state model, persistence, run orchestration and event streaming, screenshot pipeline and theme, plus the TUI spike entry. |
| Hermes Dashboard Plugin | 38 | Hermes dashboard plugin that shells out to the public uh CLI: FastAPI router backend (plugin_api.py), dashboard-SDK React UI bundle (mission wizard, run views, Delivery Observatory, workflow editor), esbuild config, manifests and local launcher. |
Where to go next
Section titled “Where to go next”- Guided tour: read the code in dependency order.
- Hotspots: the files everything else depends on, and the files that depend on everything.
- Architecture map: the hand-written overview this generated map complements.