How cordum-io/cordum works
Cordum is an AI-agent control plane with an Edge compliance firewall. The principal workflow is an API or edge event entering the gateway, passing governance and safety controls, then being dispatched by the scheduler or executed as a workflow; outcomes and audit evidence are surfaced through the API and dashboard. The README documents the service stack, while source-index references and excerpts support selected internal relationships. Many subsystem details are unsampled, so their links are omitted rather than inferred.
Main entry points: gateway API Gateway · scheduler/engine.go Job Scheduler · handlers_edge_llm_ingest.go Edge Event Ingest · workflow/engine.go Workflow Engine
Components 20
Access and Edge
- API Gateway
core/controlplane/gateway - Edge Event Ingest
core/controlplane/gateway/handlers_edge_llm_ingest.go - Edge Agent
core/edge/agentd/app.go - MCP Service
core/mcp/server.go - Dashboard
dashboard/src/App.tsx
Governance and Safety
- Policy Evaluation
core/governance/evaluator/evaluator.go - Action Gates
core/policy/actiongates/pipeline.go - Safety Kernel
core/controlplane/safetykernel/kernel.go - Policy Bundles
core/controlplane/gateway/policybundles/bundles.go
Execution
- Job Scheduler
core/controlplane/scheduler/engine.go - Workflow Engine
core/workflow/engine.go - Agent Worker
sdk/runtime/worker.go - Context Engine
core/contextwindow/engine/service.go - Job Store
core/infra/store/job_store.go
Visibility and Operations
- Audit Pipeline
core/audit/consumer.go - Edge Event Store
core/edge/store.go - Evaluation Extraction
core/evals/extraction/pipeline.go - Client SDK
sdk/client/client.go
Other components
- API Client
- LLM Proxy
Connections 20
- API Client → API Gateway: submits requests
- API Gateway → Policy Evaluation: evaluates policy
- API Gateway → Job Scheduler: submits jobs
- Job Scheduler → Safety Kernel: checks safety
- Job Scheduler → Job Store: persists jobs
- Job Scheduler → Agent Worker: dispatches work
- Workflow Engine → Job Scheduler: publishes job packets
core/workflow/engine.go - API Gateway → Workflow Engine: manages workflows
- LLM Proxy → Edge Event Ingest: sends LLM events
core/controlplane/gateway/handlers_edge_llm_ingest.go - Edge Event Ingest → Edge Event Store: appends events
core/controlplane/gateway/handlers_edge_llm_ingest.go - Edge Agent → API Gateway: reports edge activity
- MCP Service → API Gateway: uses gateway handlers
- API Gateway → Action Gates: applies action gates
- API Gateway → Policy Bundles: serves policy bundles
- API Gateway → Context Engine: provides context service
- Dashboard → API Gateway: requests status
- Client SDK → API Gateway: calls API
- API Gateway → Audit Pipeline: exports audit records
- Evaluation Extraction → Job Store: queries decisions
core/evals/extraction/pipeline.go - Edge Event Ingest → Safety Kernel: classifies interactions
core/controlplane/gateway/handlers_edge_llm_ingest.go