How bhangun/gamelan works
Gamelan is a multi-tenant workflow engine with client and CLI entry points, workflow definition and run management, node execution, executor discovery, and runtime recovery. The README documents workflow, executor, Kafka, gRPC, SDK, plugin, and agent-context capabilities; the tree provides exact implementation paths for many, but not all, of these. Edges are limited to README-documented relationships or source-index/excerpt evidence, so unsampled runtime wiring is omitted.
Main entry points: WorkflowDefinition.java Workflow definitions · WorkflowExecutionEngine.java Workflow execution · WorkflowRunId.java Workflow runs · GrpcClientManager.java Gamelan CLI
Components 20
Clients
- Gamelan CLI
ui/gamelan-cli/src/main/java/tech/kayys/gamelan/cli/GrpcClientManager.java - Client SDK
framework/gamelan-sdk-client-core/src/main/java/tech/kayys/gamelan/sdk/client/WorkflowRunClient.java - gRPC executor service
runtime/gamelan-runtime-distributed/src/main/java/tech/kayys/gamelan/runtime/grpc/ExecutorServiceImpl.java
Workflow lifecycle
- Workflow definitions
framework/gamelan-engine-spi/src/main/java/tech/kayys/gamelan/engine/workflow/WorkflowDefinition.java - Definition service
runtime/gamelan-engine/src/main/java/tech/kayys/gamelan/workflow/WorkflowDefinitionService.java - Workflow runs
framework/gamelan-engine-spi/src/main/java/tech/kayys/gamelan/engine/workflow/WorkflowRunId.java - Run manager
framework/gamelan-engine-spi/src/main/java/tech/kayys/gamelan/engine/workflow/WorkflowRunManager.java - Run repository
framework/gamelan-engine-spi/src/main/java/tech/kayys/gamelan/engine/repository/WorkflowRunRepository.java
Execution runtime
- Workflow execution
runtime/gamelan-engine/src/main/java/tech/kayys/gamelan/workflow/WorkflowExecutionEngine.java - Node dispatch
framework/gamelan-engine-core/src/main/java/tech/kayys/gamelan/core/execution/DefaultWorkflowEngine.java - DAG scheduling
framework/gamelan-dag/src/main/java/tech/kayys/gamelan/dag/DefaultDagSchedulerService.java - Run recovery
runtime/gamelan-engine/src/main/java/tech/kayys/gamelan/workflow/WorkflowRecoveryService.java - Engine context
framework/gamelan-engine-core/src/main/java/tech/kayys/gamelan/core/engine/DefaultEngineContext.java
Extensions
- Executor registry
runtime/gamelan-executor-registry/src/main/java/tech/kayys/gamelan/registry/ExecutorRegistryService.java - Kafka integration
runtime/protocol/gamelan-protocol-kafka/src/main/java/tech/kayys/gamelan/kafka/EventProjectionService.java - Plugin service
framework/gamelan-plugin-spi/src/main/java/tech/kayys/gamelan/plugin/impl/DefaultPluginService.java - Agent context store
framework/gamelan-engine-core/src/main/java/tech/kayys/gamelan/core/agent/context/FileAgentContextStore.java - Consul discovery
runtime/plugins/gamelan-plugin-consul/src/main/java/tech/kayys/gamelan/plugin/consul/ConsulServiceDiscoveryPlugin.java
Other components
- Workflow operator
- Workflow executor
Connections 18
- Workflow operator → Gamelan CLI: manages workflows
- Workflow operator → Client SDK: uses clients
- Gamelan CLI → gRPC executor service: connects via gRPC
- Workflow operator → Workflow definitions: creates definitions
- Workflow definitions → Workflow runs: starts runs from
- Workflow operator → Workflow runs: creates and controls
- Workflow definitions → Definition service: managed by
- Run manager → Run repository: uses repository
- Workflow runs → Workflow execution: executes
- Workflow execution → Node dispatch: dispatches nodes
- Workflow execution → DAG scheduling: schedules DAGs
- Run recovery → Run repository: scans active runs
runtime/gamelan-engine/src/main/java/tech/kayys/gamelan/workflow/WorkflowRecoveryService.java - Engine context → Plugin service: loads and starts
framework/gamelan-engine-core/src/main/java/tech/kayys/gamelan/core/engine/DefaultEngineContext.java - Node dispatch → Workflow executor: dispatches work
framework/gamelan-engine-core/src/main/java/tech/kayys/gamelan/core/execution/DefaultWorkflowEngine.java - Workflow executor → gRPC executor service: registers remotely
- Executor registry → Workflow executor: selects executors
- Kafka integration → Workflow operator: notifies status
- Consul discovery → Executor registry: discovers services