lane_set_state

Category: jobs_lanes
Access: write
Audience: administrative (ordinary users do not normally call this directly)

Purpose

Moves one lane along its execution axis. Call it when coordination must advance a Lane stream (the coordinated-work layer between agreed Quorum and executable Jobs) and record that move durably.

Arguments

Required: lane_id, state.

lane_id.
state. Note: open, in_progress, done, failed, or cancelled. Legal moves: open to in_progress; in_progress to done or failed; any non-terminal standing to cancelled; terminal standings are immutable.

Result

JSON object with lane_id and state (the new execution standing).

Boundaries

Requires the conductor role (manual conductor path; the future pump writer shares the same move validator). The caller must also satisfy parent-quorum visibility. Operates only inside the caller's profile boundary.

Lifecycle / side effects

Moves execution standing under a guarded compare-and-hold and records an audit/history event. Review and merge standings are untouched.

Errors

Missing conductor role is denied. Missing, malformed, inaccessible, or badly named target standing reads as unknown_lane with no oracle. Illegal moves are rejected as illegal lane transition, including races where the standing moved underneath.

Example

{
  "lane_id": "<uuid>",
  "state": "in_progress"
}

Result shape:

{
  "lane_id": "<uuid>",
  "state": "in_progress"
}