Skip to content

Latest commit

 

History

History
21 lines (17 loc) · 1.67 KB

architecture.md

File metadata and controls

21 lines (17 loc) · 1.67 KB

Architecture

The platform keeps the upstream Go module name agentflow, package boundaries and AGENTFLOW_ environment variables to reduce ongoing merge conflicts.

Directory Responsibility
cmd/agentflow API, worker or combined process
cmd/agentflow-runner Personal and pool execution machines
cmd/agentflow-mcp, cmd/agentflow-gate-mcp Public MCP and structured gate results
internal/engine SOP graph, leases, scheduling, sandbox lifecycle and delivery
internal/repo MySQL persistence, one repository per business domain
internal/httpapi HTTP/MCP handlers, one handler per business domain
internal/runtime, internal/runner Executor protocols, credentials, isolation and artifacts
internal/tracker Remote issue/PR adapters
web Embedded upstream web interface, preferences and public sign-in
migrations Explicit data migrations and optional public catalog
local Local workflows and host integrations; user guides live in docs/local/

The public edition adds account/password login and GitHub adapters. These feed the existing user, token, repository and delivery contracts; there is no separate public engine or in-memory production store. A remote repository identity beginning github: distinguishes GitHub owner/repository names from legacy tracker identities. The upstream gongfengProjectId JSON field carries this identity for compatibility.

The CLI's Classic and Portable workflow assets remain separate from each other and from platform role definitions. Sharing behavior contracts is preferable to copying runtime assets. No classic host bundle is required by a platform worker.