job_create

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

Purpose

Creates one durable executable job. A Job is one executable unit in Mind Quorum layering (Debate holds why, Quorum holds what was agreed, Lane carries the coordinated stream, Job is one executable unit). Call it when agreed work needs a durable unit an executor or the pump can claim.

Arguments

Required: kind.

Optional: lane_id, payload, project.

kind.
lane_id. Note: Optional. When given, the job inherits the lane-quorum project; an explicitly different project is rejected and an untagged job inherits the lane tag.
payload. Note: Opaque executor payload, carried verbatim.
project. Note: Optional. Untagged creation needs the explicit empty-string grant; star scope alone never suffices.

Result

JSON object with job_id (new UUID) and state (always queued on creation).

Boundaries

Requires the conductor role AND an explicit project grant together; star scope never confers origination and literal * is rejected as a project. Lane-bound jobs must match or inherit the lane-quorum project. Stored within the selected profile boundary only.

Lifecycle / side effects

Creates the job in queued standing and records an audit/history event through one atomic operation. No executor is assigned at creation; claim assigns the owner later.

Errors

Missing conductor role or missing explicit grant is denied with outside client scope vocabulary. Missing or overlong kind, overlong project or lane_id, unknown lane (lane not found), and project/lane mismatch are rejected. Unknown arguments are rejected. Failures create nothing.

Example

{
  "kind": "delivery",
  "payload": "{\"uri\":\"example\"}",
  "project": "shared-ops"
}

Result shape:

{
  "job_id": "<uuid>",
  "state": "queued"
}

job_id is assigned by the server; the placeholder stands for the returned UUID.