Skip to content

docs: add interactive AgentPool runtime architecture diagram - #401

Closed
Million-mo wants to merge 1 commit into
refactor/394-max-text-charsfrom
refactor/396-arch-diagram
Closed

docs: add interactive AgentPool runtime architecture diagram#401
Million-mo wants to merge 1 commit into
refactor/394-max-text-charsfrom
refactor/396-arch-diagram

Conversation

@Million-mo

@Million-mo Million-mo commented Aug 28, 2026

Copy link
Copy Markdown
Collaborator

What

Adds a self-contained interactive architecture diagram to the docs site, generated with the Archify skill against the live source tree.

Diagram content

12 components mapped from src/wolfharness_server/ and src/wolfharness/orchestrator/:

  • Protocol layer (ACP / AG-UI / OpenCode / MCP) — 4 adapters sharing one AgentPool
  • Orchestration spine — SessionPool → SessionController → RunHandle (RunLoop · HookAwareTurn) → Native Agent
  • Capability stack — MCP · Skills · Hooks · Subagent
  • EventBus — session-scoped pub/sub with replay
  • AgentPool hub — manifest + shared services

Built-in interactions: theme toggle, node search, focused routes, role lens, 3 curated views (main request path / event flow / hub), PNG/SVG/WebM export.

Changes

File Change
docs/explanation/agentpool-runtime-architecture.html New — 713KB self-contained HTML (inline SVG/JS, no external deps)
mkdocs.yml +1 nav line under Reference → Architecture
changelog/unreleased/2026-08-28-interactive-runtime-architecture-diagram.md Changelog entry

Verification

  • zensical build succeeds; HTML passes through verbatim (SHA-256 identical in docs/ and site/)
  • Nav link resolves to ./explanation/agentpool-runtime-architecture.html (HTTP 200)
  • No Jinja template mangling (zero {{ / {% artifacts in built output)
  • Pre-commit hooks pass (yaml check, commitizen, large file check)

Deploy

No workflow changes needed — .github/workflows/documentation.yml already globs docs/** and deploys via GitHub Pages on merge to main.

@Million-mo
Million-mo changed the base branch from main to refactor/394-max-text-chars August 28, 2026 08:24
Base automatically changed from refactor/394-max-text-chars to refactor/382-framework-only August 28, 2026 08:33
Self-contained HTML diagram generated with Archify, mapped from the
live source tree. Covers protocol adapters (ACP/AG-UI/OpenCode/MCP),
SessionPool → SessionController → RunHandle orchestration, native
agent + capability stack, session-scoped EventBus, and AgentPool hub.

Linked from Reference → Architecture in docs nav; deploys via the
existing GitHub Pages workflow on push to main.
@Million-mo
Million-mo force-pushed the refactor/396-arch-diagram branch from eb36dcd to f844b62 Compare August 28, 2026 08:34
@Million-mo
Million-mo changed the base branch from refactor/382-framework-only to refactor/394-max-text-chars August 28, 2026 08:36
@Million-mo Million-mo closed this Aug 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant