Skip to content

Verified dispatch path

The mechanical dispatch loop is proven end-to-end against the live repository: an approved workflow:ready issue is claimed, a deterministic worker commits to an isolated worktree, a result envelope lands on the issue, and the label sequence workflow:ready -> workflow:in-progress -> workflow:review is observed – then the fixture is reset. No model inference is involved; the proof exercises the production claim/run identity, label transitions, and result envelope through the real dispatcher.

flowchart TD
    A["workflow:ready issue<br/>(#207 fixture)"] --> B["dispatcher claim()<br/>run_id generated outside the model"]
    B --> C["workflow:ready -> workflow:in-progress"]
    C --> D["isolated linked worktree<br/>created from HEAD"]
    D --> E["deterministic worker:<br/>one marker file, one local commit"]
    E --> F["independent git verification<br/>never worker self-report"]
    F --> G["dispatcher complete()<br/>result envelope posted to the issue"]
    G --> H["workflow:in-progress -> workflow:review"]
    H --> I["fixture reset to workflow:ready<br/>harness cleanup, never approval"]
    I --> A

The proof fixture is issue #207, labeled workflow:ready + background-task + ci:dispatch-proof. Each green run leaves a claim comment, a result comment, and a reset comment on that issue.

Date Actions run Routed engine Result
2026-08-22 (inaugural) run 32557664882 dsh success – commit landed
2026-08-22 (after hermes-free joined the manifest) run 32604071869 hermes-free success – commit landed

The routing assertion is deterministic but not pinned to one engine: the proof follows whatever engine route(["background-task"]) selects from the production manifest (cheapest cost_class, deterministic engine_id tie-break). When the free-tier hermes-free entry joined the manifest, the proof tracked the route instead of failing – see PR #279.

The result envelope is complete and correlated: issue_id, run_id, runtime (ci-deterministic/<engine>-route-v1), worker_role, timestamps, model (none), cost (exact zero, no inference), artifacts (content-free marker path + commit hash + sha256), evidence (route, worktree, commit verification), and error (null).

Proven:

  • Claim/run identity is real: the dispatcher generates run_id outside the model and transitions labels against the live repository.
  • A landed commit in an isolated worktree is verified independently of the worker’s self-report.
  • The result envelope is posted to the issue by the dispatcher.
  • The label sequence is exactly ready -> in-progress -> review, and the fixture is reset administratively (never by the worker).

Not yet proven (the next step toward unattended production dispatch):

  • A model-backed worker running a real build issue end-to-end through the default path (the current default dispatch path for real build issues is not yet exercised unattended; operator approval remains the final gate).
  • Provider-failure recovery across restarts (the deterministic proof has no provider to fail).

See the dispatch contract for the full contract this loop satisfies, and current operating model for what is verified today.