375 lines
8.6 KiB
JSON
375 lines
8.6 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"$id": "https://thinkloom.app/schemas/provenance/1.0/composition-operation.schema.json",
|
|
"title": "Composition operation",
|
|
"description": "Immutable composition-specific insertion, deletion, replacement, movement, paste, transcription, AI acceptance, or restoration operation; it does not overload edit transactions or assertions.",
|
|
"type": "object",
|
|
"properties": {
|
|
"schema_version": {
|
|
"const": "1.0"
|
|
},
|
|
"operation_id": {
|
|
"type": "string",
|
|
"pattern": "^operation_[0-9A-HJKMNP-TV-Z]{26}$"
|
|
},
|
|
"project_id": {
|
|
"type": "string",
|
|
"pattern": "^project_[0-9A-HJKMNP-TV-Z]{26}$"
|
|
},
|
|
"operation_kind": {
|
|
"enum": [
|
|
"insert",
|
|
"delete",
|
|
"replace",
|
|
"move",
|
|
"paste",
|
|
"transcription",
|
|
"ai_acceptance",
|
|
"restoration"
|
|
]
|
|
},
|
|
"client_action_id": {
|
|
"type": "string",
|
|
"minLength": 8,
|
|
"maxLength": 200
|
|
},
|
|
"base_revision_id": {
|
|
"type": "string",
|
|
"pattern": "^revision_[0-9A-HJKMNP-TV-Z]{26}$"
|
|
},
|
|
"result_revision_id": {
|
|
"type": "string",
|
|
"pattern": "^revision_[0-9A-HJKMNP-TV-Z]{26}$"
|
|
},
|
|
"operation_sequence": {
|
|
"type": "integer",
|
|
"minimum": 1
|
|
},
|
|
"source_range": {
|
|
"anyOf": [
|
|
{
|
|
"$ref": "https://thinkloom.app/schemas/provenance/1.0/text-fragment-reference.schema.json"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"destination_coordinate_system": {
|
|
"enum": [
|
|
"utf8_byte",
|
|
"unicode_scalar",
|
|
"utf16_code_unit",
|
|
"editor_position"
|
|
]
|
|
},
|
|
"destination_start": {
|
|
"anyOf": [
|
|
{
|
|
"type": "integer",
|
|
"minimum": 0
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"inserted_content_sha256": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string",
|
|
"pattern": "^sha256:[a-f0-9]{64}$"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"deleted_content_sha256": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string",
|
|
"pattern": "^sha256:[a-f0-9]{64}$"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"source_record_ids": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string",
|
|
"pattern": "^[a-z][a-z0-9_]*_[0-9A-HJKMNP-TV-Z]{26}$"
|
|
},
|
|
"uniqueItems": true
|
|
},
|
|
"invocation_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string",
|
|
"pattern": "^invocation_[0-9A-HJKMNP-TV-Z]{26}$"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"disposition_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string",
|
|
"pattern": "^disposition_[0-9A-HJKMNP-TV-Z]{26}$"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"recorded_origin_kind": {
|
|
"enum": [
|
|
"recorded_direct_human_input",
|
|
"human_expressive_input_via_transcription",
|
|
"accepted_ai_output",
|
|
"imported_or_pasted",
|
|
"system_restoration",
|
|
"unattested"
|
|
]
|
|
},
|
|
"actor_identity_status": {
|
|
"enum": [
|
|
"verified",
|
|
"self_declared",
|
|
"unknown",
|
|
"not_applicable"
|
|
]
|
|
},
|
|
"transformation_relationships": {
|
|
"type": "array",
|
|
"items": {
|
|
"enum": [
|
|
"inserted",
|
|
"deleted",
|
|
"replaced",
|
|
"moved",
|
|
"pasted_from_external",
|
|
"transcribed_from_human_speech",
|
|
"generated_by_ai",
|
|
"modified_by_human",
|
|
"restored_from_revision",
|
|
"derived_from"
|
|
]
|
|
},
|
|
"minItems": 1,
|
|
"uniqueItems": true
|
|
},
|
|
"lineage_reference_ids": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string",
|
|
"pattern": "^[a-z][a-z0-9_]*_[0-9A-HJKMNP-TV-Z]{26}$"
|
|
},
|
|
"minItems": 1,
|
|
"uniqueItems": true
|
|
},
|
|
"recorded_at": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$"
|
|
}
|
|
},
|
|
"required": [
|
|
"schema_version",
|
|
"operation_id",
|
|
"project_id",
|
|
"operation_kind",
|
|
"client_action_id",
|
|
"base_revision_id",
|
|
"result_revision_id",
|
|
"operation_sequence",
|
|
"source_range",
|
|
"destination_coordinate_system",
|
|
"destination_start",
|
|
"inserted_content_sha256",
|
|
"deleted_content_sha256",
|
|
"source_record_ids",
|
|
"invocation_id",
|
|
"disposition_id",
|
|
"recorded_origin_kind",
|
|
"actor_identity_status",
|
|
"transformation_relationships",
|
|
"lineage_reference_ids",
|
|
"recorded_at"
|
|
],
|
|
"additionalProperties": false,
|
|
"allOf": [
|
|
{
|
|
"if": {
|
|
"properties": {
|
|
"operation_kind": {
|
|
"const": "paste"
|
|
}
|
|
},
|
|
"required": [
|
|
"operation_kind"
|
|
]
|
|
},
|
|
"then": {
|
|
"properties": {
|
|
"recorded_origin_kind": {
|
|
"const": "imported_or_pasted"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
{
|
|
"if": {
|
|
"properties": {
|
|
"operation_kind": {
|
|
"const": "transcription"
|
|
}
|
|
},
|
|
"required": [
|
|
"operation_kind"
|
|
]
|
|
},
|
|
"then": {
|
|
"properties": {
|
|
"recorded_origin_kind": {
|
|
"const": "human_expressive_input_via_transcription"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
{
|
|
"if": {
|
|
"properties": {
|
|
"operation_kind": {
|
|
"const": "ai_acceptance"
|
|
}
|
|
},
|
|
"required": [
|
|
"operation_kind"
|
|
]
|
|
},
|
|
"then": {
|
|
"properties": {
|
|
"recorded_origin_kind": {
|
|
"const": "accepted_ai_output"
|
|
},
|
|
"invocation_id": {
|
|
"type": "string",
|
|
"pattern": "^invocation_[0-9A-HJKMNP-TV-Z]{26}$"
|
|
},
|
|
"disposition_id": {
|
|
"type": "string",
|
|
"pattern": "^disposition_[0-9A-HJKMNP-TV-Z]{26}$"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
{
|
|
"if": {
|
|
"properties": {
|
|
"operation_kind": {
|
|
"const": "restoration"
|
|
}
|
|
},
|
|
"required": [
|
|
"operation_kind"
|
|
]
|
|
},
|
|
"then": {
|
|
"properties": {
|
|
"recorded_origin_kind": {
|
|
"const": "system_restoration"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
{
|
|
"if": {
|
|
"properties": {
|
|
"operation_kind": {
|
|
"const": "delete"
|
|
}
|
|
},
|
|
"required": [
|
|
"operation_kind"
|
|
]
|
|
},
|
|
"then": {
|
|
"properties": {
|
|
"source_range": {
|
|
"$ref": "https://thinkloom.app/schemas/provenance/1.0/text-fragment-reference.schema.json"
|
|
},
|
|
"inserted_content_sha256": {
|
|
"type": "null"
|
|
},
|
|
"deleted_content_sha256": {
|
|
"type": "string",
|
|
"pattern": "^sha256:[a-f0-9]{64}$"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
{
|
|
"if": {
|
|
"properties": {
|
|
"operation_kind": {
|
|
"enum": [
|
|
"insert",
|
|
"paste",
|
|
"transcription",
|
|
"ai_acceptance",
|
|
"restoration"
|
|
]
|
|
}
|
|
},
|
|
"required": [
|
|
"operation_kind"
|
|
]
|
|
},
|
|
"then": {
|
|
"properties": {
|
|
"inserted_content_sha256": {
|
|
"type": "string",
|
|
"pattern": "^sha256:[a-f0-9]{64}$"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
],
|
|
"examples": [
|
|
{
|
|
"schema_version": "1.0",
|
|
"operation_id": "operation_01J0000000000000000000000X",
|
|
"project_id": "project_01J00000000000000000000001",
|
|
"operation_kind": "insert",
|
|
"client_action_id": "client-action-composition-0001",
|
|
"base_revision_id": "revision_01J0000000000000000000000A",
|
|
"result_revision_id": "revision_01J0000000000000000000000B",
|
|
"operation_sequence": 1,
|
|
"source_range": null,
|
|
"destination_coordinate_system": "unicode_scalar",
|
|
"destination_start": 0,
|
|
"inserted_content_sha256": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
|
|
"deleted_content_sha256": null,
|
|
"source_record_ids": [
|
|
"turn_01J00000000000000000000007"
|
|
],
|
|
"invocation_id": null,
|
|
"disposition_id": null,
|
|
"recorded_origin_kind": "recorded_direct_human_input",
|
|
"actor_identity_status": "self_declared",
|
|
"transformation_relationships": [
|
|
"inserted"
|
|
],
|
|
"lineage_reference_ids": [
|
|
"turn_01J00000000000000000000007"
|
|
],
|
|
"recorded_at": "2026-07-17T18:42:10.123Z"
|
|
}
|
|
]
|
|
}
|