How nodealchemy/powernode-system works
Powernode System Extension supplies the substrate beneath the Powernode control plane: operators manage nodes and infrastructure, while the Go agent boots and reconciles those nodes into a governed fleet. The principal path runs from operator actions through the React surface and Rails APIs to platform-managed tasks and on-node execution; storage migration spans planning/approval and agent-side data movement. The README also documents module supply-chain, SD-WAN, fleet autonomy, and observability branches. Some subsystem links are documented capabilities rather than inspected call sites; those use README evidence.
Main entry points: runtime Agent Runtime · powernode-agent Powernode Agent · components System UI · StorageMigrationsPanel.tsx Migration Panel
Components 20
Operator Surface
- System UI
frontend/src/features/system/components - Migration Panel
frontend/src/features/system/components/platform/StorageMigrationsPanel.tsx - Migration API Client
frontend/src/features/system/services/api/storageMigrationsApi.ts
Control Plane
- Rails Extension
server/app - Storage Migration API
server/app/controllers/api/v1/system/platform/storage_migrations_controller.rb - Storage Migration State
server/app/models/system/storage_migration.rb - Scheduled Workers
worker/app/jobs - Module Supply Chain
server/app/services/system/module_oci_ingest_service.rb
Node Runtime
- Powernode Agent
agent/cmd/powernode-agent - Agent Runtime
agent/internal/runtime - Storage Task Handler
agent/internal/runtime/tasks/handlers/storage.go - Storage Operations
agent/internal/storage - Volume Mounting
agent/internal/mount - Boot Artifacts
initramfs
Fleet Services
- SD-WAN Manager
agent/internal/sdwan/manager.go - Fleet Autonomy
server/app/services/system/fleet - Fleet Events
server/app/models/system
Other components
- Operator
- Powernode Platform
- OCI Registry
Connections 20
- Operator → System UI: manages fleet
- System UI → Migration Panel: opens migrations
frontend/src/features/system/components/platform/StorageMigrationsPanel.tsx - Migration Panel → Migration API Client: requests actions
frontend/src/features/system/components/platform/StorageMigrationsPanel.tsx - Migration API Client → Storage Migration API: calls endpoints
frontend/src/features/system/services/api/storageMigrationsApi.ts - Storage Migration API → Storage Migration State: manages state
- Powernode Platform → Rails Extension: hosts extension
- Rails Extension → Scheduled Workers: schedules jobs
- Powernode Platform → Powernode Agent: runs nodes
- Powernode Agent → Agent Runtime: starts runtime
- Agent Runtime → Storage Task Handler: dispatches tasks
agent/internal/runtime/tasks/handlers/storage.go - Storage Task Handler → Storage Operations: applies operations
agent/internal/runtime/tasks/handlers/storage.go - Agent Runtime → Volume Mounting: reconciles volumes
agent/internal/runtime/storage_volume_client.go - Powernode Platform → Module Supply Chain: publishes modules
- Module Supply Chain → OCI Registry: stores artifacts
- Agent Runtime → OCI Registry: pulls modules
- Boot Artifacts → Powernode Agent: boots agent
- Powernode Agent → SD-WAN Manager: configures networking
- Scheduled Workers → Fleet Autonomy: reconciles fleet
- Fleet Autonomy → Fleet Events: records decisions
- Fleet Events → System UI: broadcasts updates