ticket.git-delivery.publish-confirm

Record independent remote-ref readback and advance only when its Git OID exactly equals the requested local head.

Verify remote ref equality and only then mark work as published.

Overview

Property	Value
Workflow type	Linear
Library	App-tickets
Version	1.0

Input Schema

Field	Type	Required	Default	Description
organization_uuid	string	Yes	—	—
attempt_uuid	string	Yes	—	—
observed_remote_oid	string	Yes	—	—
verifier_type	string	Yes	—	—
verifier_uuid	string	Yes	—	—
evidence	json	No	—	—

Output Schema

Field	Type	Required	Default	Description
attempt	dict	No	—	—
created	boolean	No	—	—
claimed	boolean	No	—	—
changed	boolean	No	—	—
confirmed	boolean	No	—	—
organization_uuid	string	No	—	Input field preserved in workflow state.
delivery_uuid	string	No	—	Input field preserved in workflow state.
sequence	integer	No	—	Input field preserved in workflow state.
idempotency_key	string	No	—	Input field preserved in workflow state.
requested_head_oid	string	No	—	Input field preserved in workflow state.
destination_ref	string	No	—	Input field preserved in workflow state.
policy_digest	string	No	—	Input field preserved in workflow state.
binding_uuid	string	No	—	Input field preserved in workflow state.
artifact_uuid	string	No	—	Input field preserved in workflow state.
expected_remote_oid	string	No	—	Input field preserved in workflow state.
actor_type	string	No	—	Input field preserved in workflow state.
actor_uuid	string	No	—	Input field preserved in workflow state.
failed_at	string	No	—	ISO-8601 timestamp when action_fail recorded the failure
failure_reason	string	No	—	Human-readable failure reason from action_fail
failure_type	string	No	—	Engine-stamped failure category
failed_action	string	No	—	Engine-stamped action that raised
failed_at_state	string	No	—	Engine-stamped state when the workflow failed
failed_step	string	No	—	Engine-stamped step name (DAG path)
failed_layer	string	No	—	Engine-stamped layer index (DAG path)
error	string	No	—	Engine-stamped exception message
error_type	string	No	—	Engine-stamped exception class name
broker_uuid	string	No	—	Input field preserved in workflow state.
lease_uuid	string	No	—	Input field preserved in workflow state.
lease_seconds	integer	No	—	Input field preserved in workflow state.
attempt_uuid	string	No	—	Input field preserved in workflow state.
broker_binding_key	string	No	—	Input field preserved in workflow state.
broker_capabilities	list	No	—	Input field preserved in workflow state.
outcome	string	No	—	Input field preserved in workflow state.
native_push_ref	string	No	—	Input field preserved in workflow state.
provider_request_ref	string	No	—	Input field preserved in workflow state.
evidence	json	No	—	Input field preserved in workflow state.
observed_remote_oid	string	No	—	Input field preserved in workflow state.
verifier_type	string	No	—	Input field preserved in workflow state.
verifier_uuid	string	No	—	Input field preserved in workflow state.
failure_class	string	No	—	Input field preserved in workflow state.
retryable	boolean	No	—	Input field preserved in workflow state.
required_action	json	No	—	Input field preserved in workflow state.

States

State	Initial	Terminal	Success	Auto-advance	Description
initiated	Yes	No	—	execute	Accepted
executing	No	No	—	complete	Applying the mutation
completed	No	Yes	Yes	—	Done
failed	No	Yes	No	—	Failed

State Diagram

Transitions

From	Action	To	Description
initiated	execute	executing	Run the mutation
executing	complete	completed	Finalize
* (any state)	fail	failed	Catch-all failure

API Usage

POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "ticket.git-delivery.publish-confirm",
  "initial_data": {
    "organization_uuid": "value",
    "attempt_uuid": "value",
    "observed_remote_oid": "value",
    "verifier_type": "value"
  }
}