lane_create

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

Purpose

Creates one coordinated work lane under an open quorum. A Lane is the coordinated stream in Mind Quorum layering (Debate holds why, Quorum holds what was agreed, Lane carries the stream, Job is one executable unit). Call it when agreed work needs a named stream that later jobs follow.

Arguments

Required: quorum_id.

Optional: assignee_client_id, base_ref, branch, depends_on, repo, task_id, worktree.

quorum_id. Note: Must name an open quorum the caller may access.
assignee_client_id. Note: Optional; when given must name a live principal.
base_ref.
branch.
depends_on. Note: Optional; when given must name a lane of the same quorum.
repo.
task_id. Note: Optional; when given must name a live task.
worktree.

Result

JSON object with lane_id (new UUID), state (always open on creation), and project (inherited from the quorum).

Boundaries

Requires the conductor role plus an explicit grant on the quorum project in the current implementation; star scope never confers it. The lane inherits the quorum project immutably (no project argument exists by design). Stored within the selected profile boundary only.

Lifecycle / side effects

Creates the lane in open standing under the named quorum and records an audit/history event in one atomic operation. Outward links are validated now, at creation.

Errors

Missing conductor role or missing explicit grant is denied. Missing, malformed, or inaccessible quorum reads as unknown_lane with no existence oracle. Non-open quorum, unknown client, missing task (task not found), cross-quorum depends_on, and overlong fields are rejected.

Example

{
  "assignee_client_id": "worker-1",
  "branch": "feat-x",
  "quorum_id": "<uuid>",
  "repo": "saphira-memory"
}

Result shape:

{
  "lane_id": "<uuid>",
  "project": "shared-ops",
  "state": "open"
}

lane_id is assigned by the server; project in the answer is the inherited quorum project.