Expand description
WorkflowService - GitHub Actions compatible workflow orchestration
Discovers workflows from git repositories, subscribes to events, and runs
jobs as scheduled workloads (#527): each job’s runs_on: + resources:
route through the #525 P2 admission engine (SandboxPool::acquire) when
the job requests isolation, or stay on the existing in-process VFS/Tcl
execution path otherwise (see workflow::scheduler for the mapping).
WorkflowRunner talks to SandboxPool directly — there is no
WorkerService dependency in this crate’s workflow engine.
§Architecture
WorkflowService (RequestService)
│
├── scan_repo() → Discover .github/workflows/*.yml
├── subscribe() → Register event triggers
├── dispatch() → Manual workflow trigger
└── get_run() → Query run status
│
└── WorkflowRunner
├── JobScheduler → SandboxPool::acquire (isolated jobs) or
│ in-proc (`IN_PROC_LABELS`) — #527
└── Executes steps via VFS `/bin/` ctl calls + TclShellRe-exports§
pub use adapter::SubscriberAdapter;pub use gh_adapter::GitHubActionsAdapter;pub use scheduler::JobScheduler;pub use scheduler::Placement;
Modules§
- adapter
- Subscriber adapter pattern for bridging events to workflow dispatch.
- gh_
adapter - GitHub Actions compatible subscriber adapter.
- scheduler
- Job → scheduled workload placement (#527).
Structs§
- Job
- Job definition
- JobResources
- Resource hints a job declares for scheduling (hyprstream extension).
- Step
- Step definition
- Workflow
- GitHub Actions compatible workflow definition
- Workflow
Runner - General-purpose workflow execution engine.
- Workflow
Service - WorkflowService handles workflow orchestration
- Workflow
Subscription - Workflow subscription linking a workflow to an event trigger
Enums§
- Event
Trigger - Event trigger types for workflow configuration
- Handler
Result - Handler result actions
- Parse
Mode - Parse strictness.
Traits§
- Event
Handler - Event handler trait for testable, composable handlers.
Type Aliases§
- RunId
- Run ID
- Subscription
Id - Subscription ID
- Workflow
Id - Workflow ID