Skip to content

Crates ​

Rust workspace, ports-and-adapters — ports are traits, impls are separate crates; the composition roots are peregrin-node, peregrin-hub, and the peregrin CLI.

cratelayerpurpose
peregrin-coredomainPeregrin domain — events, campaign/node/graph model (pure)
peregrin-templatedomainTemplate expansion for campaign params
peregrin-busportEvent-bus port — campaign events to subscribers
peregrin-configportConfig-source port
peregrin-driverportCampaign-driver port — node drivers run actions for the engine
peregrin-loaderportCampaign-loader port — sources produce campaign definitions
peregrin-remoteportNode-hub transport port
peregrin-storeportRun/event state persistence port
peregrin-config-tomladapterTOML impl of the config port
peregrin-driver-agentadapterAgent impl of the campaign driver port
peregrin-driver-counciladapterCouncil impl of the campaign driver port — one node as a voting round (ADR-0004)
peregrin-driver-gitadapterDetached worktree-at-sha impl of the campaign driver port — runs an inner driver inside a materialized worktree
peregrin-driver-github-webhookadapterGitHub webhook ingress driver — HMAC-verified push events into the engine's ingress channel
peregrin-driver-httpadapterHTTP impl of the campaign driver port
peregrin-driver-humanadapterHuman-in-the-loop impl of the campaign driver port
peregrin-driver-opsadapterOps impl of the campaign driver port — proxies bounded tamias-driver queries over tamias serve
peregrin-driver-scheduleadapterTemporal scheduling drivers — delay (fixed wait) and schedule (cron fire) over the engine's deferred-emission channel (ADR-0018)
peregrin-driver-shelladapterShell impl of the campaign driver port
peregrin-driver-sturnadaptersturn WAL-ref poller — ingress impl of the campaign driver port (sturn snap → run)
peregrin-driver-subworkflowadaptersubworkflow driver — run another campaign YAML as a nested, namespaced run with inputs/outputs mapping (ADR-0022)
peregrin-httpadapterPeregrin HTTP API — axum driving adapter the peregrin-node daemon mounts (port of apps/server)
peregrin-loader-yamladapterYAML impl of the campaign loader port
peregrin-queue-sqliteadapterSQLite QueueStore impl — the durable supersede queue behind campaign run --queue-store
peregrin-remote-httpadapterHTTP+SSE impl of the transport port
peregrin-secret-cuoraadapterCuora Secrets impl — resolves cuora://peregrin/<NAME> through the cuora CLI
peregrin-sink-github-statusadapterGitHub commit-status sink — egress driver posting ci/<campaign> verdicts
peregrin-store-jsonadapterDurable JSONL impl of the event-store port (v1 ac-store-json)
peregrin-authservicePairing + node credentials
peregrin-gitserviceExplicit detached-worktree lifecycle — create, keep-for-debug, destroy, list, cleanup
peregrin-queueserviceCampaign-level run scheduler — supersede key, latest-wins/fifo dedupe, active-run cancel
peregrin-sessionserviceSession-plane boundary — spawns sepia serve and drives it over ndjson JSON-RPC
peregrin-cliengineThe peregrin CLI — node ops over /api/*, sessions/projects/push verbs, pairing, service management, and serve
peregrin-engineengineCampaign engine — walks the event-driven node graph
peregrin-hubengineNode-API gateway — multi-node sync engine, HTTP/SSE bridges, push, auth (hypha-hub backend + peregrin kind policies)
peregrin-nodeengineThe headless node daemon — composes driver discovery, the control plane, the meta overlay, and the API
peregrin-testkittestkitPeregrin conformance suites + fixtures
xtasktooling—