owlrunkit 0.19.2 → 0.21.0

package/scripts/runkit-contract/schemas/team-project-status-v4.schema.json

@@ -0,0 +1,208 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/team-project-status-v4.schema.json",
+  "title": "OwlCoda RunKit Team Project Status V4",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion", "status", "projectId", "objective", "overall", "counts",
+    "milestones", "workstreams", "workItems", "agents", "readyQueue",
+    "criticalWorkItems", "openDecisions", "resolvedDecisions",
+    "deferredVerifications", "openDeferredVerificationIds", "integrationGates",
+    "dataCandidates", "sourceDeliveries", "warnings", "externalGates",
+    "deliveryLifecycle", "projectTruthHash", "authorizationGranted",
+    "deliveryDisposition", "headline", "dominantGap", "nextAction",
+    "nextActorId", "exitCode"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitTeamProjectStatusV4" },
+    "status": { "const": "team_project_status" },
+    "projectId": { "$ref": "#/$defs/text" },
+    "objective": { "$ref": "#/$defs/text" },
+    "overall": { "enum": ["planned", "active", "active_with_blockers", "completed"] },
+    "counts": { "type": "object" },
+    "milestones": { "type": "array", "items": { "type": "object" } },
+    "workstreams": { "type": "array", "items": { "type": "object" } },
+    "workItems": { "type": "array", "items": { "type": "object" } },
+    "agents": { "type": "array", "items": { "type": "object" } },
+    "readyQueue": { "$ref": "#/$defs/strings" },
+    "criticalWorkItems": { "$ref": "#/$defs/strings" },
+    "openDecisions": { "type": "array", "items": { "type": "object" } },
+    "resolvedDecisions": { "type": "array", "items": { "type": "object" } },
+    "deferredVerifications": { "type": "array", "items": { "type": "object" } },
+    "openDeferredVerificationIds": { "$ref": "#/$defs/strings" },
+    "integrationGates": { "type": "array", "items": { "type": "object" } },
+    "dataCandidates": { "type": "array", "items": { "type": "object" } },
+    "sourceDeliveries": { "type": "array", "items": { "type": "object" } },
+    "warnings": { "type": "array", "items": { "type": "object" } },
+    "externalGates": { "type": "array", "items": { "$ref": "#/$defs/externalGate" } },
+    "deliveryLifecycle": { "$ref": "#/$defs/deliveryLifecycle" },
+    "projectTruthHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "authorizationGranted": { "const": false },
+    "deliveryDisposition": {
+      "enum": [
+        "work_ledger_incomplete", "work_ledger_complete", "source_accepted",
+        "integrated", "materialized", "deployed", "live_readback_passed", "product_accepted"
+      ]
+    },
+    "headline": { "$ref": "#/$defs/text" },
+    "dominantGap": { "$ref": "#/$defs/dominantGap" },
+    "nextAction": { "$ref": "#/$defs/nullableText" },
+    "nextActorId": { "$ref": "#/$defs/nullableText" },
+    "exitCode": { "const": 0 }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "deliveryDisposition": { "const": "product_accepted" } }, "required": ["deliveryDisposition"] },
+      "then": {
+        "properties": {
+          "dominantGap": { "properties": { "kind": { "const": "none" } } },
+          "nextAction": { "type": "null" },
+          "nextActorId": { "type": "null" }
+        }
+      }
+    }
+  ],
+  "examples": [
+    {
+      "schemaVersion": "OwlCodaRunKitTeamProjectStatusV4",
+      "status": "team_project_status",
+      "projectId": "delivery-wave",
+      "objective": "Preserve delivery truth after source completion",
+      "overall": "completed",
+      "counts": {},
+      "milestones": [],
+      "workstreams": [],
+      "workItems": [],
+      "agents": [],
+      "readyQueue": [],
+      "criticalWorkItems": [],
+      "openDecisions": [],
+      "resolvedDecisions": [],
+      "deferredVerifications": [],
+      "openDeferredVerificationIds": [],
+      "integrationGates": [],
+      "dataCandidates": [],
+      "sourceDeliveries": [],
+      "warnings": [],
+      "externalGates": [],
+      "deliveryLifecycle": {
+        "schemaVersion": "OwlCodaRunKitDeliveryLifecycleV1",
+        "lifecycleStatus": "in_progress",
+        "currentStage": "work_ledger_complete",
+        "nextRequiredStage": "source",
+        "blockingStage": null,
+        "blockingExternalGateIds": [],
+        "stages": [
+          { "stage": "source", "status": "pending", "recordId": null, "ownerAgentId": null, "summary": null, "evidenceRefs": [], "externalGateIds": [], "occurredAt": null, "truthRef": null },
+          { "stage": "integration", "status": "pending", "recordId": null, "ownerAgentId": null, "summary": null, "evidenceRefs": [], "externalGateIds": [], "occurredAt": null, "truthRef": null },
+          { "stage": "materialization", "status": "pending", "recordId": null, "ownerAgentId": null, "summary": null, "evidenceRefs": [], "externalGateIds": [], "occurredAt": null, "truthRef": null },
+          { "stage": "deployment", "status": "pending", "recordId": null, "ownerAgentId": null, "summary": null, "evidenceRefs": [], "externalGateIds": [], "occurredAt": null, "truthRef": null },
+          { "stage": "live_readback", "status": "pending", "recordId": null, "ownerAgentId": null, "summary": null, "evidenceRefs": [], "externalGateIds": [], "occurredAt": null, "truthRef": null },
+          { "stage": "product_acceptance", "status": "pending", "recordId": null, "ownerAgentId": null, "summary": null, "evidenceRefs": [], "externalGateIds": [], "occurredAt": null, "truthRef": null }
+        ],
+        "authorizationGranted": false
+      },
+      "projectTruthHash": "0000000000000000000000000000000000000000000000000000000000000000",
+      "authorizationGranted": false,
+      "deliveryDisposition": "work_ledger_complete",
+      "headline": "Dominant gap: delivery stage source; next: Record delivery stage source.",
+      "dominantGap": {
+        "kind": "delivery_stage",
+        "id": "source",
+        "title": "Delivery stage source",
+        "workItemId": null,
+        "agentId": null,
+        "reason": "Delivery stage source has no evidence-bound record.",
+        "truthRefs": ["project/definition.json"]
+      },
+      "nextAction": "Record delivery stage source.",
+      "nextActorId": null,
+      "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" }] },
+    "timestamp": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$" },
+    "nullableTimestamp": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/timestamp" }] },
+    "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": { "$ref": "#/$defs/timestamp" },
+        "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": { "$ref": "#/$defs/nullableTimestamp" },
+        "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 }
+      }
+    },
+    "dominantGap": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "id", "title", "workItemId", "agentId", "reason", "truthRefs"],
+      "properties": {
+        "kind": { "enum": ["decision", "failed_work", "work_item", "deferred_verification", "integration_gate", "release_authority", "external_gate", "delivery_stage", "none"] },
+        "id": { "$ref": "#/$defs/nullableText" },
+        "title": { "$ref": "#/$defs/nullableText" },
+        "workItemId": { "$ref": "#/$defs/nullableText" },
+        "agentId": { "$ref": "#/$defs/nullableText" },
+        "reason": { "$ref": "#/$defs/nullableText" },
+        "truthRefs": { "$ref": "#/$defs/strings" }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,121 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/team-recommendation-v1.schema.json",
+  "title": "OwlCoda RunKit Team Recommendation V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion", "status", "project", "recommendedMode", "continuity",
+    "coordination", "assurance", "reasonCodes", "rejectedLighterModes", "lanes",
+    "pathConflicts", "acceptanceGaps", "ownerTransitions", "estimatedOverhead",
+    "nextCommand", "dispatch", "authorityBoundary", "authorizationGranted", "exitCode"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitTeamRecommendationV1" },
+    "status": { "const": "team_delivery_recommended" },
+    "project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["present", "projectId", "projectTruthHash", "overall"],
+      "properties": {
+        "present": { "type": "boolean" },
+        "projectId": { "$ref": "#/$defs/nullableText" },
+        "projectTruthHash": { "oneOf": [{ "type": "null" }, { "type": "string", "pattern": "^[a-f0-9]{64}$" }] },
+        "overall": { "$ref": "#/$defs/nullableText" }
+      }
+    },
+    "recommendedMode": { "enum": ["off", "team"] },
+    "continuity": { "enum": ["none", "project_driver"] },
+    "coordination": { "enum": ["none", "project_driver_team"] },
+    "assurance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["changed", "selection", "reason"],
+      "properties": {
+        "changed": { "const": false },
+        "selection": { "const": "unchanged" },
+        "reason": { "const": "team_delivery_does_not_select_assurance" }
+      }
+    },
+    "reasonCodes": { "$ref": "#/$defs/strings" },
+    "rejectedLighterModes": {
+      "type": "array",
+      "items": {
+        "type": "object", "additionalProperties": false,
+        "required": ["mode", "reasonCodes"],
+        "properties": { "mode": { "const": "off" }, "reasonCodes": { "$ref": "#/$defs/nonemptyStrings" } }
+      }
+    },
+    "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" } },
+    "estimatedOverhead": {
+      "type": "object", "additionalProperties": false,
+      "required": ["additionalOperatorSteps", "potentialPortablePackets"],
+      "properties": {
+        "additionalOperatorSteps": { "type": "integer", "minimum": 0 },
+        "potentialPortablePackets": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "nextCommand": { "$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": "OwlCodaRunKitTeamRecommendationV1", "status": "team_delivery_recommended",
+    "project": { "present": false, "projectId": null, "projectTruthHash": null, "overall": null },
+    "recommendedMode": "off", "continuity": "none", "coordination": "none",
+    "assurance": { "changed": false, "selection": "unchanged", "reason": "team_delivery_does_not_select_assurance" },
+    "reasonCodes": ["project_driver_not_initialized"], "rejectedLighterModes": [], "lanes": [],
+    "pathConflicts": [], "acceptanceGaps": [], "ownerTransitions": [],
+    "estimatedOverhead": { "additionalOperatorSteps": 0, "potentialPortablePackets": 0 },
+    "nextCommand": 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-task-packet-v2.schema.json

@@ -0,0 +1,228 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/team-task-packet-v2.schema.json",
+  "title": "OwlCoda RunKit Team Task Packet V2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion", "packetId", "projectBinding", "gateId", "observableSuccess",
+    "workItem", "actor", "risk", "acceptance", "entry", "scope", "evidence",
+    "verificationCadence", "handoff", "escalationBudget", "stop",
+    "authorityBoundary", "authorizationGranted"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitTeamTaskPacketV2" },
+    "packetId": { "$ref": "#/$defs/id" },
+    "projectBinding": { "$ref": "#/$defs/projectBinding" },
+    "gateId": { "$ref": "#/$defs/id" },
+    "observableSuccess": { "$ref": "#/$defs/text" },
+    "workItem": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["workItemId", "title", "dependencies", "ownedPaths"],
+      "properties": {
+        "workItemId": { "$ref": "#/$defs/id" },
+        "title": { "$ref": "#/$defs/text" },
+        "dependencies": { "$ref": "#/$defs/strings" },
+        "ownedPaths": { "$ref": "#/$defs/nonemptyStrings" }
+      }
+    },
+    "actor": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["executingAgent", "modelFamily", "modelVersion", "role"],
+      "properties": {
+        "executingAgent": { "$ref": "#/$defs/id" },
+        "modelFamily": { "$ref": "#/$defs/text" },
+        "modelVersion": { "$ref": "#/$defs/text" },
+        "role": { "$ref": "#/$defs/text" }
+      }
+    },
+    "risk": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "productJudgment", "semanticAmbiguity", "contextDepth", "surfaceWidth",
+        "determinism", "secondOrderRisk", "authoritySpan"
+      ],
+      "properties": {
+        "productJudgment": { "enum": ["low", "medium", "high"] },
+        "semanticAmbiguity": { "enum": ["low", "medium", "high"] },
+        "contextDepth": { "enum": ["local", "cross-module", "product-wide"] },
+        "surfaceWidth": { "enum": ["narrow", "multi-module", "product-wide"] },
+        "determinism": { "enum": ["deterministic", "mixed", "exploratory"] },
+        "secondOrderRisk": { "enum": ["low", "medium", "high"] },
+        "authoritySpan": { "enum": ["source-only", "integration", "runtime", "production"] }
+      }
+    },
+    "acceptance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "requiredLevel", "implementationModelFamily", "implementationModelVersion",
+        "verificationModelFamily", "verificationModelVersion", "sameFamilyAllowed",
+        "freshAdversarialFamilies"
+      ],
+      "properties": {
+        "requiredLevel": { "$ref": "#/$defs/acceptanceLevel" },
+        "implementationModelFamily": { "$ref": "#/$defs/text" },
+        "implementationModelVersion": { "$ref": "#/$defs/text" },
+        "verificationModelFamily": { "$ref": "#/$defs/text" },
+        "verificationModelVersion": { "$ref": "#/$defs/text" },
+        "sameFamilyAllowed": { "type": "boolean" },
+        "freshAdversarialFamilies": { "$ref": "#/$defs/strings" }
+      }
+    },
+    "entry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "worktreeMode", "worktree", "branch", "baseSha", "candidateIdentity",
+        "dirtyStateManifest", "soleWriter", "upstreamAcceptedPackets"
+      ],
+      "properties": {
+        "worktreeMode": { "enum": ["new_clean_worktree", "existing_dirty_candidate"] },
+        "worktree": { "$ref": "#/$defs/absolutePath" },
+        "branch": { "$ref": "#/$defs/text" },
+        "baseSha": { "$ref": "#/$defs/gitRef" },
+        "candidateIdentity": { "$ref": "#/$defs/sha256Ref" },
+        "dirtyStateManifest": { "$ref": "#/$defs/sha256Ref" },
+        "soleWriter": { "$ref": "#/$defs/id" },
+        "upstreamAcceptedPackets": { "$ref": "#/$defs/strings" }
+      }
+    },
+    "scope": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["allowedChangedPaths", "prohibitedPathsAndActions", "protectedArtifactsAndAuthority"],
+      "properties": {
+        "allowedChangedPaths": { "$ref": "#/$defs/nonemptyStrings" },
+        "prohibitedPathsAndActions": { "$ref": "#/$defs/strings" },
+        "protectedArtifactsAndAuthority": { "$ref": "#/$defs/strings" }
+      }
+    },
+    "evidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["positiveEvidence", "negativeAndSecondOrderTests", "deliveryPacketFields"],
+      "properties": {
+        "positiveEvidence": { "$ref": "#/$defs/strings" },
+        "negativeAndSecondOrderTests": { "$ref": "#/$defs/strings" },
+        "deliveryPacketFields": { "$ref": "#/$defs/strings" }
+      }
+    },
+    "verificationCadence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "microBatchId", "closureHypothesis", "includedChanges", "implementationSmoke",
+        "frozenCandidateFocusedGate", "candidateCloseoutChecks", "independentAdversarialDelta",
+        "deferredTransitionGates", "trustedReceipts", "receiptInvalidationTriggers"
+      ],
+      "properties": {
+        "microBatchId": { "$ref": "#/$defs/id" },
+        "closureHypothesis": { "$ref": "#/$defs/text" },
+        "includedChanges": { "$ref": "#/$defs/strings" },
+        "implementationSmoke": { "$ref": "#/$defs/strings" },
+        "frozenCandidateFocusedGate": { "$ref": "#/$defs/strings" },
+        "candidateCloseoutChecks": { "$ref": "#/$defs/strings" },
+        "independentAdversarialDelta": { "$ref": "#/$defs/strings" },
+        "deferredTransitionGates": { "$ref": "#/$defs/strings" },
+        "trustedReceipts": { "$ref": "#/$defs/strings" },
+        "receiptInvalidationTriggers": { "$ref": "#/$defs/strings" }
+      }
+    },
+    "handoff": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["required", "nextOwner"],
+      "properties": {
+        "required": { "type": "boolean" },
+        "nextOwner": { "$ref": "#/$defs/nullableText" }
+      }
+    },
+    "escalationBudget": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["implementationAttempts", "narrowRework", "harnessFailure", "controllerIntervention", "semanticEscape"],
+      "properties": {
+        "implementationAttempts": { "type": "integer", "minimum": 1 },
+        "narrowRework": { "type": "integer", "minimum": 0 },
+        "harnessFailure": { "type": "integer", "minimum": 0 },
+        "controllerIntervention": { "type": "integer", "minimum": 0 },
+        "semanticEscape": { "const": 0 }
+      }
+    },
+    "stop": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["exactStopPoint", "nextGateProhibited"],
+      "properties": {
+        "exactStopPoint": { "$ref": "#/$defs/text" },
+        "nextGateProhibited": { "$ref": "#/$defs/nullableText" }
+      }
+    },
+    "authorityBoundary": { "$ref": "#/$defs/authorityBoundary" },
+    "authorizationGranted": { "const": false }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$" },
+    "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" } },
+    "sha256Ref": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "gitRef": { "type": "string", "pattern": "^git:[a-f0-9]{40}([a-f0-9]{24})?$" },
+    "absolutePath": { "type": "string", "pattern": "^(?:/|[A-Za-z]:[\\\\/]|\\\\\\\\)" },
+    "acceptanceLevel": { "enum": ["L0", "L1", "L2", "L3"] },
+    "projectBinding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["projectId", "projectTruthHash"],
+      "properties": {
+        "projectId": { "$ref": "#/$defs/id" },
+        "projectTruthHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+      }
+    },
+    "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 }
+      }
+    }
+  },
+  "allOf": [{
+    "if": {
+      "properties": { "risk": { "properties": { "secondOrderRisk": { "enum": ["medium", "high"] } } } },
+      "required": ["risk"]
+    },
+    "then": {
+      "properties": { "acceptance": { "properties": { "sameFamilyAllowed": { "const": false } } } }
+    }
+  }],
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitTeamTaskPacketV2",
+    "packetId": "task-packet-001",
+    "projectBinding": { "projectId": "team-phase1", "projectTruthHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" },
+    "gateId": "ready",
+    "observableSuccess": "One source candidate is ready for independent acceptance.",
+    "workItem": { "workItemId": "work-1", "title": "Implement Team Delivery", "dependencies": [], "ownedPaths": ["scripts/runkit-contract/**"] },
+    "actor": { "executingAgent": "agent-a", "modelFamily": "provider:family-a", "modelVersion": "model-a-1", "role": "implementation" },
+    "risk": { "productJudgment": "medium", "semanticAmbiguity": "medium", "contextDepth": "cross-module", "surfaceWidth": "narrow", "determinism": "deterministic", "secondOrderRisk": "medium", "authoritySpan": "source-only" },
+    "acceptance": { "requiredLevel": "L1", "implementationModelFamily": "provider:family-a", "implementationModelVersion": "model-a-1", "verificationModelFamily": "provider:family-b", "verificationModelVersion": "model-b-1", "sameFamilyAllowed": false, "freshAdversarialFamilies": ["authority boundary"] },
+    "entry": { "worktreeMode": "new_clean_worktree", "worktree": "/workspace/team-a", "branch": "codex/team-a", "baseSha": "git:1111111111111111111111111111111111111111", "candidateIdentity": "sha256:2222222222222222222222222222222222222222222222222222222222222222", "dirtyStateManifest": "sha256:3333333333333333333333333333333333333333333333333333333333333333", "soleWriter": "agent-a", "upstreamAcceptedPackets": [] },
+    "scope": { "allowedChangedPaths": ["scripts/runkit-contract/**"], "prohibitedPathsAndActions": ["git push", "deploy"], "protectedArtifactsAndAuthority": ["release", "production"] },
+    "evidence": { "positiveEvidence": ["focused contract tests"], "negativeAndSecondOrderTests": ["authority boundary"], "deliveryPacketFields": ["candidate identity"] },
+    "verificationCadence": { "microBatchId": "team-contract", "closureHypothesis": "Portable contracts retain project truth.", "includedChanges": ["TeamTaskPacketV2"], "implementationSmoke": ["focused test"], "frozenCandidateFocusedGate": ["runtime validation"], "candidateCloseoutChecks": ["schema parity"], "independentAdversarialDelta": ["authority boundary"], "deferredTransitionGates": ["L2 package consumer"], "trustedReceipts": [], "receiptInvalidationTriggers": ["project truth drift"] },
+    "handoff": { "required": true, "nextOwner": "control-tower" },
+    "escalationBudget": { "implementationAttempts": 2, "narrowRework": 1, "harnessFailure": 1, "controllerIntervention": 1, "semanticEscape": 0 },
+    "stop": { "exactStopPoint": "Source candidate ready for independent acceptance.", "nextGateProhibited": "release" },
+    "authorityBoundary": { "agentDispatch": false, "git": false, "release": false, "deployment": false, "production": false, "business": false, "automation": false, "money": false },
+    "authorizationGranted": false
+  }]
+}