# nodealchemy/powernode-platform architecture

> Architecture diagram of the GitHub repository nodealchemy/powernode-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nodealchemy/powernode-platform
- Repository: https://github.com/nodealchemy/powernode-platform

## Overview

Powernode is an AI-agent infrastructure control plane: an operator describes work in chat, agents plan and execute provisioning, and a continuing control loop monitors operations while approval policies gate consequential actions. The repository also exposes agent/team management, autonomy and audit controls, LLM routing, RAG, DevOps pipelines and Swarm management. The graph combines README-described product flow with sampled frontend hooks/APIs and worker LLM code; several backend and fleet connections are documented capabilities but their implementation was not sampled, so those links are marked unverified.

Main entry points: [`frontend/src/features/ai/agents`](https://github.com/nodealchemy/powernode-platform/tree/develop/frontend/src/features/ai/agents) (Agent management), [`frontend/src/features/ai/chat`](https://github.com/nodealchemy/powernode-platform/tree/develop/frontend/src/features/ai/chat) (Agent chat), [`worker/app/services/llm_proxy_client.rb`](https://github.com/nodealchemy/powernode-platform/blob/develop/worker/app/services/llm_proxy_client.rb) (LLM routing), [`frontend/src/features/ai/approvals`](https://github.com/nodealchemy/powernode-platform/tree/develop/frontend/src/features/ai/approvals) (Approval queue)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operator["Operator experience"]
  node_chat["Agent chat"]
end

subgraph group_ai["AI orchestration"]
  node_agent_mgmt["Agent management"]
  node_teams["Agent teams"]
  node_agent_cards["Agent cards"]
  node_llm["LLM routing"]
  node_a2a["A2A tasks"]
  node_mcp["MCP integration"]
end

subgraph group_governance["Governance and knowledge"]
  node_approvals["Approval queue"]
  node_autonomy["Autonomy controls"]
  node_audit["AI audit"]
  node_rag["RAG and knowledge"]
end

subgraph group_operations["Infrastructure operations"]
  node_pipelines["CI/CD pipelines<br/>[usePipelines.ts]"]
  node_pipeline_api["Pipeline API"]
  node_pipeline_backend["Pipeline controller"]
  node_swarm["Swarm services"]
  node_swarm_api["Swarm API client<br/>[swarmApi.ts]"]
  node_substrate["Fleet substrate"]
  node_storage[("Storage providers")]
end

subgraph group_runtime["Execution runtime"]
  node_pipeline_jobs["Pipeline execution"]
  node_worker["Worker runtime<br/>[application.rb]"]
  node_provider{{"LLM providers"}}
end

node_operator(("Operator"))

node_operator -->|"describes work"| node_chat
node_chat -->|"request agents"| node_agent_mgmt
node_agent_mgmt -.->|"coordinate fleet"| node_teams
node_agent_mgmt -.->|"request completions"| node_llm
node_llm -->|"calls models"| node_provider
node_agent_mgmt -->|"coordinate via A2A"| node_a2a
node_agent_mgmt -->|"publish capabilities"| node_agent_cards
node_agent_mgmt -->|"use tool actions"| node_mcp
node_agent_mgmt -->|"submit consequential actions"| node_approvals
node_operator -->|"configure guardrails"| node_autonomy
node_approvals -->|"request review"| node_operator
node_agent_mgmt -.->|"record activity"| node_audit
node_agent_mgmt -->|"retrieve knowledge"| node_rag
node_operator -.->|"manage pipelines"| node_pipelines
node_pipelines -->|"calls API"| node_pipeline_api
node_pipeline_api -.->|"sends requests"| node_pipeline_backend
node_pipeline_backend -.->|"dispatches runs"| node_pipeline_jobs
node_pipeline_jobs -.->|"executes in"| node_worker
node_operator -.->|"manages services"| node_swarm
node_swarm -->|"calls API"| node_swarm_api
node_swarm_api -.->|"controls infrastructure"| node_substrate
node_operator -.->|"configures storage"| node_storage
node_agent_mgmt -->|"provisions infrastructure"| node_substrate

click node_chat "https://github.com/nodealchemy/powernode-platform/tree/develop/frontend/src/features/ai/chat"
click node_agent_mgmt "https://github.com/nodealchemy/powernode-platform/tree/develop/frontend/src/features/ai/agents"
click node_teams "https://github.com/nodealchemy/powernode-platform/tree/develop/frontend/src/features/ai/agent-teams"
click node_agent_cards "https://github.com/nodealchemy/powernode-platform/tree/develop/frontend/src/features/ai/agent-cards"
click node_llm "https://github.com/nodealchemy/powernode-platform/blob/develop/worker/app/services/llm_proxy_client.rb"
click node_approvals "https://github.com/nodealchemy/powernode-platform/tree/develop/frontend/src/features/ai/approvals"
click node_autonomy "https://github.com/nodealchemy/powernode-platform/tree/develop/frontend/src/features/ai/autonomy"
click node_audit "https://github.com/nodealchemy/powernode-platform/tree/develop/frontend/src/features/ai/audit"
click node_rag "https://github.com/nodealchemy/powernode-platform/tree/develop/server/app/services/ai/data_sources"
click node_a2a "https://github.com/nodealchemy/powernode-platform/tree/develop/frontend/src/features/ai/a2a-tasks"
click node_mcp "https://github.com/nodealchemy/powernode-platform/tree/develop/frontend/src/features/ai"
click node_pipelines "https://github.com/nodealchemy/powernode-platform/blob/develop/frontend/src/features/devops/pipelines/hooks/usePipelines.ts"
click node_pipeline_api "https://github.com/nodealchemy/powernode-platform/blob/develop/frontend/src/services/devopsPipelinesApi.ts"
click node_pipeline_backend "https://github.com/nodealchemy/powernode-platform/blob/develop/server/app/controllers/api/v1/devops/pipelines_controller.rb"
click node_pipeline_jobs "https://github.com/nodealchemy/powernode-platform/blob/develop/worker/app/jobs/devops/pipeline_execution_job.rb"
click node_swarm "https://github.com/nodealchemy/powernode-platform/blob/develop/frontend/src/features/devops/swarm/hooks/useSwarmServices.ts"
click node_swarm_api "https://github.com/nodealchemy/powernode-platform/blob/develop/frontend/src/features/devops/swarm/services/swarmApi.ts"
click node_substrate "https://github.com/nodealchemy/powernode-platform/tree/develop/extensions/system"
click node_worker "https://github.com/nodealchemy/powernode-platform/blob/develop/worker/config/application.rb"
click node_storage "https://github.com/nodealchemy/powernode-platform/blob/develop/server/app/controllers/api/v1/storage_providers_controller.rb"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_chat toneBlue
class node_agent_mgmt,node_teams,node_agent_cards,node_llm,node_a2a,node_mcp toneAmber
class node_approvals,node_autonomy,node_audit,node_rag toneMint
class node_pipelines,node_pipeline_api,node_pipeline_backend,node_swarm,node_swarm_api,node_substrate,node_storage toneRose
class node_pipeline_jobs,node_worker,node_provider,node_operator toneIndigo
```

## Components

### Operator experience

- [Agent chat](https://github.com/nodealchemy/powernode-platform/tree/develop/frontend/src/features/ai/chat): `frontend/src/features/ai/chat`

### AI orchestration

- [Agent management](https://github.com/nodealchemy/powernode-platform/tree/develop/frontend/src/features/ai/agents): `frontend/src/features/ai/agents`
- [Agent teams](https://github.com/nodealchemy/powernode-platform/tree/develop/frontend/src/features/ai/agent-teams): `frontend/src/features/ai/agent-teams`
- [Agent cards](https://github.com/nodealchemy/powernode-platform/tree/develop/frontend/src/features/ai/agent-cards): `frontend/src/features/ai/agent-cards`
- [LLM routing](https://github.com/nodealchemy/powernode-platform/blob/develop/worker/app/services/llm_proxy_client.rb): `worker/app/services/llm_proxy_client.rb`
- [A2A tasks](https://github.com/nodealchemy/powernode-platform/tree/develop/frontend/src/features/ai/a2a-tasks): `frontend/src/features/ai/a2a-tasks`
- [MCP integration](https://github.com/nodealchemy/powernode-platform/tree/develop/frontend/src/features/ai): `frontend/src/features/ai`

### Governance and knowledge

- [Approval queue](https://github.com/nodealchemy/powernode-platform/tree/develop/frontend/src/features/ai/approvals): `frontend/src/features/ai/approvals`
- [Autonomy controls](https://github.com/nodealchemy/powernode-platform/tree/develop/frontend/src/features/ai/autonomy): `frontend/src/features/ai/autonomy`
- [AI audit](https://github.com/nodealchemy/powernode-platform/tree/develop/frontend/src/features/ai/audit): `frontend/src/features/ai/audit`
- [RAG and knowledge](https://github.com/nodealchemy/powernode-platform/tree/develop/server/app/services/ai/data_sources): `server/app/services/ai/data_sources`

### Infrastructure operations

- [CI/CD pipelines](https://github.com/nodealchemy/powernode-platform/blob/develop/frontend/src/features/devops/pipelines/hooks/usePipelines.ts): `frontend/src/features/devops/pipelines/hooks/usePipelines.ts`
- [Pipeline API](https://github.com/nodealchemy/powernode-platform/blob/develop/frontend/src/services/devopsPipelinesApi.ts): `frontend/src/services/devopsPipelinesApi.ts`
- [Pipeline controller](https://github.com/nodealchemy/powernode-platform/blob/develop/server/app/controllers/api/v1/devops/pipelines_controller.rb): `server/app/controllers/api/v1/devops/pipelines_controller.rb`
- [Swarm services](https://github.com/nodealchemy/powernode-platform/blob/develop/frontend/src/features/devops/swarm/hooks/useSwarmServices.ts): `frontend/src/features/devops/swarm/hooks/useSwarmServices.ts`
- [Swarm API client](https://github.com/nodealchemy/powernode-platform/blob/develop/frontend/src/features/devops/swarm/services/swarmApi.ts): `frontend/src/features/devops/swarm/services/swarmApi.ts`
- [Fleet substrate](https://github.com/nodealchemy/powernode-platform/tree/develop/extensions/system): `extensions/system`
- [Storage providers](https://github.com/nodealchemy/powernode-platform/blob/develop/server/app/controllers/api/v1/storage_providers_controller.rb): `server/app/controllers/api/v1/storage_providers_controller.rb`

### Execution runtime

- [Pipeline execution](https://github.com/nodealchemy/powernode-platform/blob/develop/worker/app/jobs/devops/pipeline_execution_job.rb): `worker/app/jobs/devops/pipeline_execution_job.rb`
- [Worker runtime](https://github.com/nodealchemy/powernode-platform/blob/develop/worker/config/application.rb): `worker/config/application.rb`
- **LLM providers**

### Other components

- **Operator**

## Connections

- Operator → Agent chat: describes work (evidence: `README.md`)
- Agent chat → Agent management: request agents (evidence: `README.md`)
- Agent management → Agent teams: coordinate fleet
- Agent management → LLM routing: request completions
- LLM routing → LLM providers: calls models
- Agent management → A2A tasks: coordinate via A2A (evidence: `README.md`)
- Agent management → Agent cards: publish capabilities (evidence: `README.md`)
- Agent management → MCP integration: use tool actions (evidence: `README.md`)
- Agent management → Approval queue: submit consequential actions (evidence: `README.md`)
- Operator → Autonomy controls: configure guardrails (evidence: `README.md`)
- Approval queue → Operator: request review (evidence: `README.md`)
- Agent management → AI audit: record activity
- Agent management → RAG and knowledge: retrieve knowledge (evidence: `README.md`)
- Operator → CI/CD pipelines: manage pipelines
- CI/CD pipelines → Pipeline API: calls API (evidence: `frontend/src/features/devops/pipelines/hooks/usePipelines.ts`)
- Pipeline API → Pipeline controller: sends requests
- Pipeline controller → Pipeline execution: dispatches runs
- Pipeline execution → Worker runtime: executes in
- Operator → Swarm services: manages services
- Swarm services → Swarm API client: calls API (evidence: `frontend/src/features/devops/swarm/hooks/useSwarmServices.ts`)
- Swarm API client → Fleet substrate: controls infrastructure
- Operator → Storage providers: configures storage
- Agent management → Fleet substrate: provisions infrastructure (evidence: `README.md`)
