ticket.coding-artifact.verification-complete

Verify or reject an artifact by comparing every trusted importer observation with its frozen digest, size, object format, and OIDs.

Accept an artifact only after exact trusted import observations.

Overview

Property	Value
Workflow type	Linear
Library	App-tickets
Version	1.0

Input Schema

Field	Type	Required	Default	Description
organization_uuid	string	Yes	—	Authenticated organization scope; control-plane injected, never caller authority.
artifact_uuid	string	Yes	—	Verifying organization-scoped artifact UUID.
verifier_uuid	string	Yes	—	Exact trusted importer identity holding the lease.
lease_uuid	string	Yes	—	Exact active verification lease UUID.
manifest_sha256	string	Yes	—	Trusted importer's observed canonical-manifest SHA-256.
artifact_sha256	string	Yes	—	Trusted importer's observed Git bundle SHA-256.
size_bytes	integer	Yes	—	Trusted importer's observed compressed size from 1 through 536870912 bytes (512 MiB).
object_count	integer	Yes	—	Trusted importer's observed Git object count from 1 through 200000.
uncompressed_bytes	integer	Yes	—	Trusted importer's observed uncompressed size from 1 through 2147483648 bytes (2 GiB).
object_format	string	Yes	—	Trusted importer's observed native Git object format.
base_oid	string	Yes	—	Trusted importer's observed exact base Git OID.
head_oid	string	Yes	—	Trusted importer's observed exact head Git OID.

Output Schema

Field	Type	Required	Default	Description
artifact	dict	No	—	Provider-neutral artifact; excludes storage coordinates and credentials.
created	boolean	No	—	True only when this idempotent call created the artifact.
changed	boolean	No	—	True only when this idempotent call advanced artifact state.
claimed	boolean	No	—	True only when this call acquired the lease.
organization_uuid	string	No	—	Input field preserved in workflow state.
delivery_uuid	string	No	—	Input field preserved in workflow state.
repository_uuid	string	No	—	Input field preserved in workflow state.
work_uuid	string	No	—	Input field preserved in workflow state.
idempotency_key	string	No	—	Input field preserved in workflow state.
format	string	No	—	Input field preserved in workflow state.
object_format	string	No	—	Input field preserved in workflow state.
base_oid	string	No	—	Input field preserved in workflow state.
head_oid	string	No	—	Input field preserved in workflow state.
session_uuid	string	No	—	Input field preserved in workflow state.
execution_uuid	string	No	—	Input field preserved in workflow state.
workspace_lease_uuid	string	No	—	Input field preserved in workflow state.
expires_at	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
artifact_uuid	string	No	—	Input field preserved in workflow state.
manifest_sha256	string	No	—	Input field preserved in workflow state.
artifact_sha256	string	No	—	Input field preserved in workflow state.
size_bytes	integer	No	—	Input field preserved in workflow state.
object_count	integer	No	—	Input field preserved in workflow state.
uncompressed_bytes	integer	No	—	Input field preserved in workflow state.
verifier_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.
enabled	boolean	No	—	Input field preserved in workflow state.
reason	string	No	—	Input field preserved in workflow state.
worker_uuid	string	No	—	Input field preserved in workflow state.
deleted_object_count	integer	No	—	Input field preserved in workflow state.
deleted_bytes	integer	No	—	Input field preserved in workflow state.
retryable	boolean	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.coding-artifact.verification-complete",
  "initial_data": {
    "organization_uuid": "value",
    "artifact_uuid": "value",
    "verifier_uuid": "value",
    "lease_uuid": "value"
  }
}