ticket.software-delivery.evidence-record

Append ordered native Git, test, PR, check, merge, release, build, migration, rollout, deployment, blocker, or recovery evidence.

Append one trusted, normalized delivery evidence record.

Overview

Property	Value
Workflow type	Linear
Library	App-tickets
Version	1.0

Input Schema

Field	Type	Required	Default	Description
organization_uuid	string	Yes	—	—
delivery_uuid	string	Yes	—	—
sequence	integer	Yes	—	—
idempotency_key	string	Yes	—	—
kind	string	Yes	—	What this record is evidence OF. One of: session, runner, workspace, skill, git, test, publication, pull_request, check, approval, merge, release, package, image, build, migration, rollout, deployment, blocker, recovery. A coding session's command output -- the policy's required_commands, lint and test runs alike -- is kind test with the command name in role; there is no command_results kind. Use blocker for a condition that stopped the lane and recovery for what cleared it.
source_type	string	Yes	—	Which system produced the record: agent, runner, provider, platform, human.
role	string	No	—	Which instance of the kind this is, so several records of one kind stay distinguishable: the command name for test evidence (ruff, test, diff_check), the check name for check evidence, the reviewer identity for approval, the blocker code for blocker. Free text, 128 chars.
source_uuid	string	No	—	—
native_ref	string	No	—	—
conclusion	string	No	—	How it came out: success, failure, neutral, skipped, timed_out, cancelled, pending. Free text, 64 chars; the gate reads it, so use these words.
head_oid	string	No	—	—
merge_oid	string	No	—	—
observed_at	datetime	No	—	—
actor_type	string	No	—	—
actor_uuid	string	No	—	—
data	json	No	—	—

Output Schema

Field	Type	Required	Default	Description
delivery	dict	No	—	—
evidence	dict	No	—	—
created	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.
kind	string	No	—	Input field preserved in workflow state.
source_type	string	No	—	Input field preserved in workflow state.
role	string	No	—	Input field preserved in workflow state.
source_uuid	string	No	—	Input field preserved in workflow state.
native_ref	string	No	—	Input field preserved in workflow state.
conclusion	string	No	—	Input field preserved in workflow state.
head_oid	string	No	—	Input field preserved in workflow state.
merge_oid	string	No	—	Input field preserved in workflow state.
observed_at	datetime	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.
data	json	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

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.software-delivery.evidence-record",
  "initial_data": {
    "organization_uuid": "value",
    "delivery_uuid": "value",
    "sequence": 123,
    "idempotency_key": "value"
  }
}