owlrunkit 0.19.2 → 0.21.0

package/scripts/runkit-contract/schemas/team-delivery-status-v1.schema.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/team-delivery-status-v1.schema.json",
+  "title": "OwlCoda RunKit Team Delivery Status V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion", "status", "graphSource", "persistedTeamGraph", "projectId",
+    "projectTruthHash", "projectOverall", "recommendation", "lanes", "pathConflicts",
+    "acceptanceGaps", "ownerTransitions", "nextAction", "dispatch",
+    "authorityBoundary", "authorizationGranted", "exitCode"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitTeamDeliveryStatusV1" },
+    "status": { "const": "team_delivery_status" },
+    "graphSource": { "const": "project_driver" },
+    "persistedTeamGraph": { "const": false },
+    "projectId": { "$ref": "#/$defs/nullableText" },
+    "projectTruthHash": { "oneOf": [{ "type": "null" }, { "type": "string", "pattern": "^[a-f0-9]{64}$" }] },
+    "projectOverall": { "type": "string", "minLength": 1 },
+    "recommendation": {
+      "type": "object", "additionalProperties": false,
+      "required": ["recommendedMode", "coordination", "reasonCodes"],
+      "properties": {
+        "recommendedMode": { "enum": ["off", "team"] },
+        "coordination": { "enum": ["none", "project_driver_team"] },
+        "reasonCodes": { "$ref": "#/$defs/strings" }
+      }
+    },
+    "lanes": { "type": "array", "items": { "$ref": "#/$defs/lane" } },
+    "pathConflicts": { "type": "array", "items": { "$ref": "#/$defs/pathConflict" } },
+    "acceptanceGaps": { "type": "array", "items": { "$ref": "#/$defs/acceptanceGap" } },
+    "ownerTransitions": { "type": "array", "items": { "$ref": "#/$defs/ownerTransition" } },
+    "nextAction": { "$ref": "#/$defs/nullableText" },
+    "dispatch": { "$ref": "#/$defs/dispatch" },
+    "authorityBoundary": { "$ref": "#/$defs/authorityBoundary" },
+    "authorizationGranted": { "const": false },
+    "exitCode": { "const": 0 }
+  },
+  "$defs": {
+    "text": { "type": "string", "minLength": 1 },
+    "nullableText": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/text" }] },
+    "strings": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/text" } },
+    "nonemptyStrings": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/text" } },
+    "lane": {
+      "type": "object", "additionalProperties": false,
+      "required": ["workItemId", "title", "status", "agentId", "dependencies", "unresolvedDependencies", "ownedPaths", "actionable", "parallelEligible", "coordinationFacts"],
+      "properties": {
+        "workItemId": { "$ref": "#/$defs/text" }, "title": { "$ref": "#/$defs/text" },
+        "status": { "$ref": "#/$defs/text" }, "agentId": { "$ref": "#/$defs/nullableText" },
+        "dependencies": { "$ref": "#/$defs/strings" }, "unresolvedDependencies": { "$ref": "#/$defs/strings" },
+        "ownedPaths": { "$ref": "#/$defs/nonemptyStrings" }, "actionable": { "type": "boolean" },
+        "parallelEligible": { "type": "boolean" }, "coordinationFacts": { "$ref": "#/$defs/strings" }
+      }
+    },
+    "pathConflict": { "type": "object", "additionalProperties": false, "required": ["leftWorkItemId", "leftPath", "rightWorkItemId", "rightPath"], "properties": { "leftWorkItemId": { "$ref": "#/$defs/text" }, "leftPath": { "$ref": "#/$defs/text" }, "rightWorkItemId": { "$ref": "#/$defs/text" }, "rightPath": { "$ref": "#/$defs/text" } } },
+    "acceptanceGap": { "type": "object", "additionalProperties": false, "required": ["workItemId", "code", "message"], "properties": { "workItemId": { "$ref": "#/$defs/text" }, "code": { "const": "verification_model_family_unbound" }, "message": { "$ref": "#/$defs/text" } } },
+    "ownerTransition": { "type": "object", "additionalProperties": false, "required": ["workItemId", "facts"], "properties": { "workItemId": { "$ref": "#/$defs/text" }, "facts": { "$ref": "#/$defs/nonemptyStrings" } } },
+    "dispatch": { "type": "object", "additionalProperties": false, "required": ["mode", "permitted", "nextCommand"], "properties": { "mode": { "const": "none" }, "permitted": { "const": false }, "nextCommand": { "type": "null" } } },
+    "authorityBoundary": { "type": "object", "additionalProperties": false, "required": ["agentDispatch", "git", "release", "deployment", "production", "business", "automation", "money"], "properties": { "agentDispatch": { "const": false }, "git": { "const": false }, "release": { "const": false }, "deployment": { "const": false }, "production": { "const": false }, "business": { "const": false }, "automation": { "const": false }, "money": { "const": false } } }
+  },
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitTeamDeliveryStatusV1", "status": "team_delivery_status",
+    "graphSource": "project_driver", "persistedTeamGraph": false, "projectId": null,
+    "projectTruthHash": null, "projectOverall": "not_initialized",
+    "recommendation": { "recommendedMode": "off", "coordination": "none", "reasonCodes": ["project_driver_not_initialized"] },
+    "lanes": [], "pathConflicts": [], "acceptanceGaps": [], "ownerTransitions": [], "nextAction": null,
+    "dispatch": { "mode": "none", "permitted": false, "nextCommand": null },
+    "authorityBoundary": { "agentDispatch": false, "git": false, "release": false, "deployment": false, "production": false, "business": false, "automation": false, "money": false },
+    "authorizationGranted": false, "exitCode": 0
+  }]
+}

package/scripts/runkit-contract/schemas/team-delivery-status-v2.schema.json

@@ -0,0 +1,219 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/team-delivery-status-v2.schema.json",
+  "title": "OwlCoda RunKit Team Delivery Status V2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion", "status", "graphSource", "persistedTeamGraph", "projectId",
+    "projectTruthHash", "projectOverall", "recommendation", "lanes", "pathConflicts",
+    "acceptanceGaps", "ownerTransitions", "externalGates", "deliveryLifecycle",
+    "unmodeledCandidateLanes", "warnings", "warningSummary", "nextAction", "dispatch",
+    "authorityBoundary", "authorizationGranted", "exitCode"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitTeamDeliveryStatusV2" },
+    "status": { "const": "team_delivery_status" },
+    "graphSource": { "const": "project_driver" },
+    "persistedTeamGraph": { "const": false },
+    "projectId": { "$ref": "#/$defs/nullableText" },
+    "projectTruthHash": { "oneOf": [{ "type": "null" }, { "type": "string", "pattern": "^[a-f0-9]{64}$" }] },
+    "projectOverall": { "$ref": "#/$defs/text" },
+    "recommendation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["recommendedMode", "coordination", "reasonCodes"],
+      "properties": {
+        "recommendedMode": { "enum": ["off", "team"] },
+        "coordination": { "enum": ["none", "project_driver_team"] },
+        "reasonCodes": { "$ref": "#/$defs/strings" }
+      }
+    },
+    "lanes": { "type": "array", "items": { "$ref": "#/$defs/lane" } },
+    "pathConflicts": { "type": "array", "items": { "$ref": "#/$defs/pathConflict" } },
+    "acceptanceGaps": { "type": "array", "items": { "$ref": "#/$defs/acceptanceGap" } },
+    "ownerTransitions": { "type": "array", "items": { "$ref": "#/$defs/ownerTransition" } },
+    "externalGates": { "type": "array", "items": { "$ref": "#/$defs/externalGate" } },
+    "deliveryLifecycle": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/deliveryLifecycle" }] },
+    "unmodeledCandidateLanes": { "type": "array", "items": { "$ref": "#/$defs/candidateLane" } },
+    "warnings": { "type": "array", "items": { "$ref": "#/$defs/warning" } },
+    "warningSummary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["count", "groups"],
+      "properties": {
+        "count": { "type": "integer", "minimum": 0 },
+        "groups": { "type": "array", "items": { "$ref": "#/$defs/warningGroup" } }
+      }
+    },
+    "nextAction": { "$ref": "#/$defs/nullableText" },
+    "dispatch": { "$ref": "#/$defs/dispatch" },
+    "authorityBoundary": { "$ref": "#/$defs/authorityBoundary" },
+    "authorizationGranted": { "const": false },
+    "exitCode": { "const": 0 }
+  },
+  "examples": [
+    {
+      "schemaVersion": "OwlCodaRunKitTeamDeliveryStatusV2",
+      "status": "team_delivery_status",
+      "graphSource": "project_driver",
+      "persistedTeamGraph": false,
+      "projectId": null,
+      "projectTruthHash": null,
+      "projectOverall": "not_initialized",
+      "recommendation": {
+        "recommendedMode": "off",
+        "coordination": "none",
+        "reasonCodes": ["project_driver_not_initialized"]
+      },
+      "lanes": [],
+      "pathConflicts": [],
+      "acceptanceGaps": [],
+      "ownerTransitions": [],
+      "externalGates": [],
+      "deliveryLifecycle": null,
+      "unmodeledCandidateLanes": [],
+      "warnings": [],
+      "warningSummary": { "count": 0, "groups": [] },
+      "nextAction": null,
+      "dispatch": { "mode": "none", "permitted": false, "nextCommand": null },
+      "authorityBoundary": {
+        "agentDispatch": false,
+        "git": false,
+        "release": false,
+        "deployment": false,
+        "production": false,
+        "business": false,
+        "automation": false,
+        "money": false
+      },
+      "authorizationGranted": false,
+      "exitCode": 0
+    }
+  ],
+  "$defs": {
+    "text": { "type": "string", "minLength": 1 },
+    "nullableText": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/text" }] },
+    "strings": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/text" } },
+    "nonemptyStrings": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/text" } },
+    "stageName": { "enum": ["source", "integration", "materialization", "deployment", "live_readback", "product_acceptance"] },
+    "nullableStage": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/stageName" }] },
+    "lane": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["workItemId", "title", "status", "agentId", "dependencies", "unresolvedDependencies", "ownedPaths", "actionable", "parallelEligible", "coordinationFacts"],
+      "properties": {
+        "workItemId": { "$ref": "#/$defs/text" },
+        "title": { "$ref": "#/$defs/text" },
+        "status": { "$ref": "#/$defs/text" },
+        "agentId": { "$ref": "#/$defs/nullableText" },
+        "dependencies": { "$ref": "#/$defs/strings" },
+        "unresolvedDependencies": { "$ref": "#/$defs/strings" },
+        "ownedPaths": { "$ref": "#/$defs/nonemptyStrings" },
+        "actionable": { "type": "boolean" },
+        "parallelEligible": { "type": "boolean" },
+        "coordinationFacts": { "$ref": "#/$defs/strings" }
+      }
+    },
+    "pathConflict": { "type": "object", "additionalProperties": false, "required": ["leftWorkItemId", "leftPath", "rightWorkItemId", "rightPath"], "properties": { "leftWorkItemId": { "$ref": "#/$defs/text" }, "leftPath": { "$ref": "#/$defs/text" }, "rightWorkItemId": { "$ref": "#/$defs/text" }, "rightPath": { "$ref": "#/$defs/text" } } },
+    "acceptanceGap": { "type": "object", "additionalProperties": false, "required": ["workItemId", "code", "message"], "properties": { "workItemId": { "$ref": "#/$defs/text" }, "code": { "const": "verification_model_family_unbound" }, "message": { "$ref": "#/$defs/text" } } },
+    "ownerTransition": { "type": "object", "additionalProperties": false, "required": ["workItemId", "facts"], "properties": { "workItemId": { "$ref": "#/$defs/text" }, "facts": { "$ref": "#/$defs/nonemptyStrings" } } },
+    "externalGate": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "gateId", "title", "requiredFor", "gateStatus", "blocking", "ownerAgentId", "source", "summary", "evidenceRefs", "occurredAt", "truthRefs", "authorizationGranted"],
+      "properties": {
+        "schemaVersion": { "const": "OwlCodaRunKitExternalGateV1" },
+        "gateId": { "$ref": "#/$defs/text" },
+        "title": { "$ref": "#/$defs/text" },
+        "requiredFor": { "$ref": "#/$defs/stageName" },
+        "gateStatus": { "enum": ["pending", "passed", "blocked", "deferred"] },
+        "blocking": { "type": "boolean" },
+        "ownerAgentId": { "$ref": "#/$defs/text" },
+        "source": { "type": "object", "additionalProperties": false, "required": ["adapterId", "ref", "sha256"], "properties": { "adapterId": { "$ref": "#/$defs/text" }, "ref": { "$ref": "#/$defs/text" }, "sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } } },
+        "summary": { "$ref": "#/$defs/text" },
+        "evidenceRefs": { "$ref": "#/$defs/nonemptyStrings" },
+        "occurredAt": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$" },
+        "truthRefs": { "$ref": "#/$defs/nonemptyStrings" },
+        "authorizationGranted": { "const": false }
+      }
+    },
+    "deliveryStage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stage", "status", "recordId", "ownerAgentId", "summary", "evidenceRefs", "externalGateIds", "occurredAt", "truthRef"],
+      "properties": {
+        "stage": { "$ref": "#/$defs/stageName" },
+        "status": { "enum": ["pending", "accepted", "rejected", "integrated", "materialized", "deployed", "failed", "rolled_back", "passed", "deferred"] },
+        "recordId": { "$ref": "#/$defs/nullableText" },
+        "ownerAgentId": { "$ref": "#/$defs/nullableText" },
+        "summary": { "$ref": "#/$defs/nullableText" },
+        "evidenceRefs": { "$ref": "#/$defs/strings" },
+        "externalGateIds": { "$ref": "#/$defs/strings" },
+        "occurredAt": { "oneOf": [{ "type": "null" }, { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$" }] },
+        "truthRef": { "$ref": "#/$defs/nullableText" }
+      }
+    },
+    "deliveryLifecycle": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "lifecycleStatus", "currentStage", "nextRequiredStage", "blockingStage", "blockingExternalGateIds", "stages", "authorizationGranted"],
+      "properties": {
+        "schemaVersion": { "const": "OwlCodaRunKitDeliveryLifecycleV1" },
+        "lifecycleStatus": { "enum": ["in_progress", "blocked", "completed"] },
+        "currentStage": { "enum": ["work_ledger_incomplete", "work_ledger_complete", "source_accepted", "integrated", "materialized", "deployed", "live_readback_passed", "product_accepted"] },
+        "nextRequiredStage": { "$ref": "#/$defs/nullableStage" },
+        "blockingStage": { "$ref": "#/$defs/nullableStage" },
+        "blockingExternalGateIds": { "$ref": "#/$defs/strings" },
+        "stages": { "type": "array", "minItems": 6, "maxItems": 6, "items": { "$ref": "#/$defs/deliveryStage" } },
+        "authorizationGranted": { "const": false }
+      }
+    },
+    "candidateLane": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["laneId", "kind", "artifactId", "status", "sourceRef", "actionable", "modeledWorkItemId", "truthRefs"],
+      "properties": {
+        "laneId": { "$ref": "#/$defs/text" },
+        "kind": { "enum": ["data_candidate", "external_gate", "target_snapshot", "source_delivery"] },
+        "artifactId": { "$ref": "#/$defs/text" },
+        "status": { "$ref": "#/$defs/text" },
+        "sourceRef": { "$ref": "#/$defs/text" },
+        "actionable": { "type": "boolean" },
+        "modeledWorkItemId": { "$ref": "#/$defs/nullableText" },
+        "truthRefs": { "$ref": "#/$defs/nonemptyStrings" }
+      }
+    },
+    "warning": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "workItemId", "message", "truthRefs", "severity", "blocking", "requiredAtGate", "recommendedAction"],
+      "properties": {
+        "code": { "const": "no_bound_verification_receipt" },
+        "workItemId": { "$ref": "#/$defs/text" },
+        "message": { "$ref": "#/$defs/text" },
+        "truthRefs": { "$ref": "#/$defs/nonemptyStrings" },
+        "severity": { "const": "warning" },
+        "blocking": { "const": false },
+        "requiredAtGate": { "const": false },
+        "recommendedAction": { "enum": ["no_retroactive_action_required", "bind_quick_or_formal_receipt_if_reusable_evidence_is_required"] }
+      }
+    },
+    "warningGroup": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "severity", "blocking", "count", "workItemIds", "requiredAtGate", "recommendedAction"],
+      "properties": {
+        "code": { "const": "no_bound_verification_receipt" },
+        "severity": { "const": "warning" },
+        "blocking": { "const": false },
+        "count": { "type": "integer", "minimum": 1 },
+        "workItemIds": { "$ref": "#/$defs/nonemptyStrings" },
+        "requiredAtGate": { "const": false },
+        "recommendedAction": { "enum": ["no_retroactive_action_required", "bind_quick_or_formal_receipt_if_reusable_evidence_is_required", "review_individual_warning_actions"] }
+      }
+    },
+    "dispatch": { "type": "object", "additionalProperties": false, "required": ["mode", "permitted", "nextCommand"], "properties": { "mode": { "const": "none" }, "permitted": { "const": false }, "nextCommand": { "type": "null" } } },
+    "authorityBoundary": { "type": "object", "additionalProperties": false, "required": ["agentDispatch", "git", "release", "deployment", "production", "business", "automation", "money"], "properties": { "agentDispatch": { "const": false }, "git": { "const": false }, "release": { "const": false }, "deployment": { "const": false }, "production": { "const": false }, "business": { "const": false }, "automation": { "const": false }, "money": { "const": false } } }
+  }
+}

package/scripts/runkit-contract/schemas/team-packet-validation-v1.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/team-packet-validation-v1.schema.json",
+  "title": "OwlCoda RunKit Team Packet Validation V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "status", "packetKind", "packetSchemaVersion", "issueCodes", "authorityBoundary", "authorizationGranted", "exitCode"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitTeamPacketValidationV1" },
+    "status": { "enum": ["team_packet_valid", "team_packet_invalid"] },
+    "packetKind": { "enum": ["task", "acceptance", "transfer", "unknown"] },
+    "packetSchemaVersion": { "oneOf": [{ "type": "null" }, { "type": "string", "minLength": 1 }] },
+    "issueCodes": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "authorityBoundary": {
+      "type": "object", "additionalProperties": false,
+      "required": ["agentDispatch", "git", "release", "deployment", "production", "business", "automation", "money"],
+      "properties": { "agentDispatch": { "const": false }, "git": { "const": false }, "release": { "const": false }, "deployment": { "const": false }, "production": { "const": false }, "business": { "const": false }, "automation": { "const": false }, "money": { "const": false } }
+    },
+    "authorizationGranted": { "const": false },
+    "exitCode": { "enum": [0, 2] }
+  },
+  "allOf": [{
+    "if": { "properties": { "status": { "const": "team_packet_valid" } }, "required": ["status"] },
+    "then": { "properties": { "issueCodes": { "maxItems": 0 }, "exitCode": { "const": 0 } } },
+    "else": { "properties": { "issueCodes": { "minItems": 1 }, "exitCode": { "const": 2 } } }
+  }],
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitTeamPacketValidationV1", "status": "team_packet_valid",
+    "packetKind": "task", "packetSchemaVersion": "OwlCodaRunKitTeamTaskPacketV2", "issueCodes": [],
+    "authorityBoundary": { "agentDispatch": false, "git": false, "release": false, "deployment": false, "production": false, "business": false, "automation": false, "money": false },
+    "authorizationGranted": false, "exitCode": 0
+  }]
+}

package/scripts/runkit-contract/schemas/team-project-event-v6.schema.json

@@ -0,0 +1,82 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/team-project-event-v6.schema.json",
+  "title": "OwlCoda RunKit Team Project Event V6",
+  "oneOf": [
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion", "eventId", "type", "occurredAt", "reconciliationId",
+        "gateId", "title", "requiredFor", "gateStatus", "ownerAgentId",
+        "sourceAdapterId", "sourceRef", "sourceSha256", "summary",
+        "evidenceRefs", "authorizationGranted"
+      ],
+      "properties": {
+        "schemaVersion": { "const": "OwlCodaRunKitTeamProjectEventV6" },
+        "eventId": { "$ref": "#/$defs/id" },
+        "type": { "const": "external_gate_reconciled" },
+        "occurredAt": { "$ref": "#/$defs/timestamp" },
+        "reconciliationId": { "$ref": "#/$defs/id" },
+        "supersedesReconciliationId": { "$ref": "#/$defs/id" },
+        "gateId": { "$ref": "#/$defs/id" },
+        "title": { "$ref": "#/$defs/text" },
+        "requiredFor": { "$ref": "#/$defs/stage" },
+        "gateStatus": { "enum": ["pending", "passed", "blocked", "deferred"] },
+        "ownerAgentId": { "$ref": "#/$defs/id" },
+        "sourceAdapterId": { "$ref": "#/$defs/id" },
+        "sourceRef": { "$ref": "#/$defs/text" },
+        "sourceSha256": { "$ref": "#/$defs/sha256" },
+        "summary": { "$ref": "#/$defs/text" },
+        "evidenceRefs": { "$ref": "#/$defs/nonemptyStrings" },
+        "authorizationGranted": { "const": false }
+      }
+    },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion", "eventId", "type", "occurredAt", "recordId",
+        "stage", "stageStatus", "ownerAgentId", "summary", "evidenceRefs",
+        "externalGateIds", "authorizationGranted"
+      ],
+      "properties": {
+        "schemaVersion": { "const": "OwlCodaRunKitTeamProjectEventV6" },
+        "eventId": { "$ref": "#/$defs/id" },
+        "type": { "const": "delivery_lifecycle_recorded" },
+        "occurredAt": { "$ref": "#/$defs/timestamp" },
+        "recordId": { "$ref": "#/$defs/id" },
+        "supersedesRecordId": { "$ref": "#/$defs/id" },
+        "stage": { "$ref": "#/$defs/stage" },
+        "stageStatus": {
+          "enum": [
+            "accepted", "rejected", "integrated", "materialized", "deployed", "failed",
+            "rolled_back", "passed", "deferred"
+          ]
+        },
+        "ownerAgentId": { "$ref": "#/$defs/id" },
+        "summary": { "$ref": "#/$defs/text" },
+        "evidenceRefs": { "$ref": "#/$defs/nonemptyStrings" },
+        "externalGateIds": { "$ref": "#/$defs/strings" },
+        "authorizationGranted": { "const": false }
+      },
+      "allOf": [
+        { "if": { "properties": { "stage": { "const": "source" } }, "required": ["stage"] }, "then": { "properties": { "stageStatus": { "enum": ["accepted", "rejected"] } } } },
+        { "if": { "properties": { "stage": { "const": "integration" } }, "required": ["stage"] }, "then": { "properties": { "stageStatus": { "enum": ["integrated", "rejected"] } } } },
+        { "if": { "properties": { "stage": { "const": "materialization" } }, "required": ["stage"] }, "then": { "properties": { "stageStatus": { "enum": ["materialized", "failed"] } } } },
+        { "if": { "properties": { "stage": { "const": "deployment" } }, "required": ["stage"] }, "then": { "properties": { "stageStatus": { "enum": ["deployed", "failed", "rolled_back"] } } } },
+        { "if": { "properties": { "stage": { "const": "live_readback" } }, "required": ["stage"] }, "then": { "properties": { "stageStatus": { "enum": ["passed", "failed"] } } } },
+        { "if": { "properties": { "stage": { "const": "product_acceptance" } }, "required": ["stage"] }, "then": { "properties": { "stageStatus": { "enum": ["accepted", "rejected", "deferred"] } } } }
+      ]
+    }
+  ],
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$" },
+    "text": { "type": "string", "minLength": 1 },
+    "timestamp": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$" },
+    "sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "stage": { "enum": ["source", "integration", "materialization", "deployment", "live_readback", "product_acceptance"] },
+    "strings": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/text" } },
+    "nonemptyStrings": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/text" } }
+  }
+}

package/scripts/runkit-contract/schemas/team-project-event-v7.schema.json

@@ -0,0 +1,80 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/team-project-event-v7.schema.json",
+  "title": "OwlCoda RunKit Team Project Event V7",
+  "oneOf": [
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion", "eventId", "type", "occurredAt", "policyId",
+        "workItemId", "ownerAgentId", "requirement", "reason",
+        "evidenceRefs", "authorizationGranted"
+      ],
+      "properties": {
+        "schemaVersion": { "const": "OwlCodaRunKitTeamProjectEventV7" },
+        "eventId": { "$ref": "#/$defs/id" },
+        "type": { "const": "work_item_evidence_requirement_set" },
+        "occurredAt": { "$ref": "#/$defs/timestamp" },
+        "policyId": { "$ref": "#/$defs/id" },
+        "supersedesPolicyId": { "$ref": "#/$defs/id" },
+        "workItemId": { "$ref": "#/$defs/id" },
+        "ownerAgentId": { "$ref": "#/$defs/id" },
+        "requirement": { "enum": ["none", "quick"] },
+        "reason": { "$ref": "#/$defs/text" },
+        "evidenceRefs": { "$ref": "#/$defs/nonemptyStrings" },
+        "authorizationGranted": { "const": false }
+      }
+    },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion", "eventId", "type", "occurredAt", "checkpointId",
+        "assignmentId", "workItemId", "state", "summary", "evidenceRefs",
+        "blockerRefs", "decisionRefs", "nextAction", "sourceFingerprint",
+        "receiptBinding", "authorizationGranted"
+      ],
+      "properties": {
+        "schemaVersion": { "const": "OwlCodaRunKitTeamProjectEventV7" },
+        "eventId": { "$ref": "#/$defs/id" },
+        "type": { "const": "checkpoint_receipt_bound" },
+        "occurredAt": { "$ref": "#/$defs/timestamp" },
+        "checkpointId": { "$ref": "#/$defs/id" },
+        "assignmentId": { "$ref": "#/$defs/id" },
+        "workItemId": { "$ref": "#/$defs/id" },
+        "state": { "enum": ["active", "waiting_dependency", "waiting_decision", "verifying", "ready_to_integrate", "completed", "failed"] },
+        "summary": { "$ref": "#/$defs/text" },
+        "completedUnits": { "type": "integer", "minimum": 0 },
+        "evidenceRefs": { "$ref": "#/$defs/strings" },
+        "blockerRefs": { "$ref": "#/$defs/strings" },
+        "decisionRefs": { "$ref": "#/$defs/strings" },
+        "nextAction": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/text" }] },
+        "sourceFingerprint": { "$ref": "#/$defs/sha256" },
+        "receiptBinding": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "receiptId", "receiptRef", "receiptSha256", "sourceFingerprint", "attestationDecision", "issueCodes"],
+          "properties": {
+            "kind": { "const": "quick" },
+            "receiptId": { "$ref": "#/$defs/id" },
+            "receiptRef": { "$ref": "#/$defs/text" },
+            "receiptSha256": { "$ref": "#/$defs/sha256" },
+            "sourceFingerprint": { "$ref": "#/$defs/sha256" },
+            "attestationDecision": { "const": "GO" },
+            "issueCodes": { "$ref": "#/$defs/strings" }
+          }
+        },
+        "authorizationGranted": { "const": false }
+      }
+    }
+  ],
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$" },
+    "text": { "type": "string", "minLength": 1 },
+    "timestamp": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$" },
+    "sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "strings": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/text" } },
+    "nonemptyStrings": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/text" } }
+  }
+}