Skip to content

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.

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.

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.
  • 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.