How intelligent-internet/zenith works
Zenith is a long-running coding-agent harness: a host orchestrator submits a mission and plan, then repeatedly advances task state, dispatching workers and validators, handling attention and replanning, and requesting terminal review before stopping. The MCP server exposes separate orchestrator, worker, and reviewer surfaces; the CLI initializes host-agent assets and project setup. The graph emphasizes the documented control loop and sampled call relationships. Some subsystems, including attention scoring and provider configuration, are indexed or documented but their runtime wiring was not fully sampled.
Main entry points: controller.py Project controller · server.py MCP surfaces · coordinator.py Mission coordinator · storage.py Project store
Components 21
User entry
- Setup CLI
zenith/src/zenith_harness/cli.py - MCP surfaces
zenith/src/zenith_harness/server.py
Mission control
- Project controller
zenith/src/zenith_harness/controller.py - Mission coordinator
zenith/src/zenith_harness/coordinator.py - Task validation
zenith/src/zenith_harness/task_validation.py - Plan patching
zenith/src/zenith_harness/task_list_patch.py - Attention analysis
zenith/src/zenith_harness/attention.py - State envelope
zenith/src/zenith_harness/envelope.py
Agent execution
- Node dispatch
zenith/src/zenith_harness/dispatcher.py - ACP runner
zenith/src/zenith_harness/acp_runner.py - Worker agent
- Validator agent
- Terminal reviewer
Project state
- Project store
zenith/src/zenith_harness/storage.py - Runtime schemas
zenith/src/zenith_harness/models.py
Prompts and providers
- Harness config
zenith/src/zenith_harness/config.py - Asset loader
zenith/src/zenith_harness/assets.py - Provider adapters
zenith/src/zenith_harness/providers.py - Bundled prompts
zenith/src/zenith_harness/bundled/prompts - Bundled skills
zenith/src/zenith_harness/bundled/skills
Other components
- Host agent
Connections 27
- Host agent → Setup CLI: initializes
README.md - Host agent → MCP surfaces: invokes tools
README.md - MCP surfaces → Project controller: routes tools
zenith/src/zenith_harness/server.py - Project controller → Mission coordinator: advances mission
zenith/src/zenith_harness/controller.py - Project controller → Project store: reads and writes
zenith/src/zenith_harness/controller.py - Project controller → Task validation: validates plans
zenith/src/zenith_harness/controller.py - Project controller → Plan patching: applies patches
zenith/src/zenith_harness/controller.py - Project controller → State envelope: builds response
zenith/src/zenith_harness/controller.py - Mission coordinator → Node dispatch: dispatches tasks
zenith/src/zenith_harness/coordinator.py - Mission coordinator → Project store: loads and saves
zenith/src/zenith_harness/coordinator.py - Mission coordinator → Attention analysis: scores gaps
zenith/src/zenith_harness/coordinator.py - Mission coordinator → Terminal reviewer: requests review
- Node dispatch → ACP runner: implemented by
zenith/src/zenith_harness/acp_runner.py - ACP runner → Worker agent: runs sessions
zenith/src/zenith_harness/acp_runner.py - ACP runner → Validator agent: runs sessions
- Worker agent → MCP surfaces: submits handoff
zenith/src/zenith_harness/server.py - Validator agent → MCP surfaces: submits verdict
zenith/src/zenith_harness/server.py - Terminal reviewer → MCP surfaces: submits review
zenith/src/zenith_harness/server.py - MCP surfaces → Project store: persists handoffs
zenith/src/zenith_harness/server.py - Project store → Runtime schemas: stores records
zenith/src/zenith_harness/storage.py - Setup CLI → Harness config: discovers settings
zenith/src/zenith_harness/cli.py - Setup CLI → Asset loader: loads assets
zenith/src/zenith_harness/cli.py - Asset loader → Harness config: uses paths
zenith/src/zenith_harness/assets.py - Harness config → Provider adapters: selects providers
zenith/src/zenith_harness/config.py - Asset loader → Bundled prompts: reads prompts
zenith/src/zenith_harness/assets.py - Asset loader → Bundled skills: loads skills
zenith/src/zenith_harness/assets.py - Project store → Bundled skills: seeds skills
zenith/src/zenith_harness/storage.py