Skip to main content

Module workflow

Module workflow 

Source
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 + TclShell

Re-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
WorkflowRunner
General-purpose workflow execution engine.
WorkflowService
WorkflowService handles workflow orchestration
WorkflowSubscription
Workflow subscription linking a workflow to an event trigger

Enums§

EventTrigger
Event trigger types for workflow configuration
HandlerResult
Handler result actions
ParseMode
Parse strictness.

Traits§

EventHandler
Event handler trait for testable, composable handlers.

Type Aliases§

RunId
Run ID
SubscriptionId
Subscription ID
WorkflowId
Workflow ID