lane_list

Category: jobs_lanes
Access: read
Audience: advanced (ordinary users do not normally call this directly)

Purpose

Lists lanes the caller may see, optionally narrowed by quorum, project, or execution standing. Call it to survey coordinated streams before moving, reviewing, or merging them.

Arguments

Optional: limit, project, quorum_id, state.

limit.
project.
quorum_id.
state.

Result

JSON object with lanes (entries carrying lane_id, quorum_id, project, state, review_state, merge_state, assignee, task_id, result_commit, created and changed stamps) and count.

Boundaries

Project scope AND parent-quorum participation filter silently; inaccessible lanes are omitted with no marker (conductor and star principals see all). Operates only inside the caller's profile boundary.

Lifecycle / side effects

Read-only. No standing changes and no history is recorded.

Errors

Unknown state values match nothing (empty result, no error). Unknown arguments are rejected. Limit is clamped to 1..100.

Example

{
  "limit": 20,
  "quorum_id": "<uuid>"
}

Result shape:

{
  "count": 1,
  "lanes": [
    {
      "assignee": "worker-1",
      "lane_id": "<uuid>",
      "project": "shared-ops",
      "quorum_id": "<uuid>",
      "state": "open"
    }
  ]
}