How nodealchemy/powernode-platform works
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: agents Agent management · chat Agent chat · llm_proxy_client.rb LLM routing · approvals Approval queue
Components 22
Operator experience
- Agent chat
frontend/src/features/ai/chat
AI orchestration
- Agent management
frontend/src/features/ai/agents - Agent teams
frontend/src/features/ai/agent-teams - Agent cards
frontend/src/features/ai/agent-cards - LLM routing
worker/app/services/llm_proxy_client.rb - A2A tasks
frontend/src/features/ai/a2a-tasks - MCP integration
frontend/src/features/ai
Governance and knowledge
- Approval queue
frontend/src/features/ai/approvals - Autonomy controls
frontend/src/features/ai/autonomy - AI audit
frontend/src/features/ai/audit - RAG and knowledge
server/app/services/ai/data_sources
Infrastructure operations
- CI/CD pipelines
frontend/src/features/devops/pipelines/hooks/usePipelines.ts - Pipeline API
frontend/src/services/devopsPipelinesApi.ts - Pipeline controller
server/app/controllers/api/v1/devops/pipelines_controller.rb - Swarm services
frontend/src/features/devops/swarm/hooks/useSwarmServices.ts - Swarm API client
frontend/src/features/devops/swarm/services/swarmApi.ts - Fleet substrate
extensions/system - Storage providers
server/app/controllers/api/v1/storage_providers_controller.rb
Execution runtime
- Pipeline execution
worker/app/jobs/devops/pipeline_execution_job.rb - Worker runtime
worker/config/application.rb - LLM providers
Other components
- Operator
Connections 23
- Operator → Agent chat: describes work
README.md - Agent chat → Agent management: request agents
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
README.md - Agent management → Agent cards: publish capabilities
README.md - Agent management → MCP integration: use tool actions
README.md - Agent management → Approval queue: submit consequential actions
README.md - Operator → Autonomy controls: configure guardrails
README.md - Approval queue → Operator: request review
README.md - Agent management → AI audit: record activity
- Agent management → RAG and knowledge: retrieve knowledge
README.md - Operator → CI/CD pipelines: manage pipelines
- CI/CD pipelines → Pipeline API: calls API
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
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
README.md