owlrunkit 0.20.0 → 0.21.0

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

@@ -0,0 +1,91 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/delivery-lifecycle-v1.schema.json",
+  "title": "OwlCoda RunKit Delivery Lifecycle V1",
+  "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": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/stageName" }] },
+    "blockingStage": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/stageName" }] },
+    "blockingExternalGateIds": { "$ref": "#/$defs/strings" },
+    "stages": {
+      "type": "array",
+      "minItems": 6,
+      "maxItems": 6,
+      "prefixItems": [
+        { "$ref": "#/$defs/sourceStage" },
+        { "$ref": "#/$defs/integrationStage" },
+        { "$ref": "#/$defs/materializationStage" },
+        { "$ref": "#/$defs/deploymentStage" },
+        { "$ref": "#/$defs/liveReadbackStage" },
+        { "$ref": "#/$defs/productAcceptanceStage" }
+      ],
+      "items": false
+    },
+    "authorizationGranted": { "const": false }
+  },
+  "allOf": [
+    { "if": { "properties": { "currentStage": { "const": "product_accepted" } }, "required": ["currentStage"] }, "then": { "properties": { "lifecycleStatus": { "const": "completed" }, "nextRequiredStage": { "type": "null" }, "blockingStage": { "type": "null" }, "blockingExternalGateIds": { "maxItems": 0 } } } }
+  ],
+  "examples": [
+    {
+      "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
+    }
+  ],
+  "$defs": {
+    "text": { "type": "string", "minLength": 1 },
+    "nullableText": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/text" }] },
+    "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" }] },
+    "stageName": { "enum": ["source", "integration", "materialization", "deployment", "live_readback", "product_acceptance"] },
+    "strings": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/text" } },
+    "stageBase": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stage", "status", "recordId", "ownerAgentId", "summary", "evidenceRefs", "externalGateIds", "occurredAt", "truthRef"],
+      "properties": {
+        "stage": { "$ref": "#/$defs/stageName" },
+        "status": { "type": "string", "minLength": 1 },
+        "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" }
+      }
+    },
+    "sourceStage": { "allOf": [{ "$ref": "#/$defs/stageBase" }, { "properties": { "stage": { "const": "source" }, "status": { "enum": ["pending", "accepted", "rejected"] } } }] },
+    "integrationStage": { "allOf": [{ "$ref": "#/$defs/stageBase" }, { "properties": { "stage": { "const": "integration" }, "status": { "enum": ["pending", "integrated", "rejected"] } } }] },
+    "materializationStage": { "allOf": [{ "$ref": "#/$defs/stageBase" }, { "properties": { "stage": { "const": "materialization" }, "status": { "enum": ["pending", "materialized", "failed"] } } }] },
+    "deploymentStage": { "allOf": [{ "$ref": "#/$defs/stageBase" }, { "properties": { "stage": { "const": "deployment" }, "status": { "enum": ["pending", "deployed", "failed", "rolled_back"] } } }] },
+    "liveReadbackStage": { "allOf": [{ "$ref": "#/$defs/stageBase" }, { "properties": { "stage": { "const": "live_readback" }, "status": { "enum": ["pending", "passed", "failed"] } } }] },
+    "productAcceptanceStage": { "allOf": [{ "$ref": "#/$defs/stageBase" }, { "properties": { "stage": { "const": "product_acceptance" }, "status": { "enum": ["pending", "accepted", "rejected", "deferred"] } } }] }
+  }
+}

package/scripts/runkit-contract/schemas/external-gate-v1.schema.json

@@ -0,0 +1,68 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/external-gate-v1.schema.json",
+  "title": "OwlCoda RunKit External Gate V1",
+  "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/id" },
+    "title": { "$ref": "#/$defs/text" },
+    "requiredFor": { "$ref": "#/$defs/stage" },
+    "gateStatus": { "enum": ["pending", "passed", "blocked", "deferred"] },
+    "blocking": { "type": "boolean" },
+    "ownerAgentId": { "$ref": "#/$defs/id" },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["adapterId", "ref", "sha256"],
+      "properties": {
+        "adapterId": { "$ref": "#/$defs/id" },
+        "ref": { "$ref": "#/$defs/text" },
+        "sha256": { "$ref": "#/$defs/sha256" }
+      }
+    },
+    "summary": { "$ref": "#/$defs/text" },
+    "evidenceRefs": { "$ref": "#/$defs/nonemptyStrings" },
+    "occurredAt": { "$ref": "#/$defs/timestamp" },
+    "truthRefs": { "$ref": "#/$defs/nonemptyStrings" },
+    "authorizationGranted": { "const": false }
+  },
+  "allOf": [
+    { "if": { "properties": { "gateStatus": { "const": "passed" } }, "required": ["gateStatus"] }, "then": { "properties": { "blocking": { "const": false } } }, "else": { "properties": { "blocking": { "const": true } } } }
+  ],
+  "examples": [
+    {
+      "schemaVersion": "OwlCodaRunKitExternalGateV1",
+      "gateId": "packaging-l1",
+      "title": "Packaging cross-family L1",
+      "requiredFor": "source",
+      "gateStatus": "pending",
+      "blocking": true,
+      "ownerAgentId": "reviewer",
+      "source": {
+        "adapterId": "product-contract-v1",
+        "ref": "docs/PRODUCT_CONTRACT.md",
+        "sha256": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+      },
+      "summary": "External acceptance remains pending.",
+      "evidenceRefs": ["artifact:product-contract"],
+      "occurredAt": "2026-08-13T00:03:00.000Z",
+      "truthRefs": ["project/events/external-gate-packaging-pending.json"],
+      "authorizationGranted": 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}$" },
+    "stage": { "enum": ["source", "integration", "materialization", "deployment", "live_readback", "product_acceptance"] },
+    "nonemptyStrings": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/text" } }
+  }
+}

package/scripts/runkit-contract/schemas/fleet-skill-upgrade-plan-v1.schema.json

@@ -0,0 +1,140 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/fleet-skill-upgrade-plan-v1.schema.json",
+  "title": "OwlCoda RunKit Fleet Skill Upgrade Plan V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "status", "expectedCore", "sharedSkill", "discovery", "affectedProjects", "blockers", "commands", "authorizationGranted"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitFleetSkillUpgradePlanV1" },
+    "status": { "enum": ["ready", "blocked"] },
+    "expectedCore": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["contractVersion", "coreVersion", "coreManifestSha256", "coreSourceRef"],
+      "properties": {
+        "contractVersion": { "const": "0.2" },
+        "coreVersion": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$" },
+        "coreManifestSha256": { "$ref": "#/$defs/sha256" },
+        "coreSourceRef": { "type": "string", "pattern": "^artifact:sha256:[a-f0-9]{64}$" }
+      }
+    },
+    "sharedSkill": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["targetRoot", "status", "installedSkillVersion", "installedConfigCoreVersion", "issues"],
+      "properties": {
+        "targetRoot": { "type": "string", "minLength": 1 },
+        "status": { "enum": ["missing", "unmanaged", "drifted", "version_mismatch", "valid"] },
+        "installedSkillVersion": { "type": ["string", "null"] },
+        "installedConfigCoreVersion": { "type": ["string", "null"] },
+        "issues": { "$ref": "#/$defs/strings" }
+      }
+    },
+    "discovery": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["source", "complete", "workspaceCount", "unreachableRoots"],
+          "properties": {
+            "source": { "type": "string", "minLength": 1 },
+            "complete": { "type": "boolean" },
+            "workspaceCount": { "type": "integer", "minimum": 0 },
+            "unreachableRoots": { "$ref": "#/$defs/strings" }
+          }
+        }
+      ]
+    },
+    "affectedProjects": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["workspaceRoot", "configPath", "configCoreVersion", "activeRunIds", "activeLeaseIds", "upgradeSafe"],
+        "properties": {
+          "workspaceRoot": { "type": "string", "minLength": 1 },
+          "configPath": { "type": "string", "minLength": 1 },
+          "configCoreVersion": { "type": ["string", "null"] },
+          "activeRunIds": { "$ref": "#/$defs/strings" },
+          "activeLeaseIds": { "$ref": "#/$defs/strings" },
+          "upgradeSafe": { "type": "boolean" }
+        }
+      }
+    },
+    "blockers": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["code"],
+        "properties": {
+          "code": { "type": "string", "minLength": 1 },
+          "workspaceRoot": { "type": "string", "minLength": 1 },
+          "artifactId": { "type": "string", "minLength": 1 },
+          "detail": { "type": "string", "minLength": 1 }
+        },
+        "additionalProperties": false
+      }
+    },
+    "commands": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["dryRun", "install", "rollback"],
+      "properties": {
+        "dryRun": { "type": "string", "minLength": 1 },
+        "install": { "type": "string", "minLength": 1 },
+        "rollback": { "type": "string", "minLength": 1 }
+      }
+    },
+    "authorizationGranted": { "const": false }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "status": { "const": "ready" } }, "required": ["status"] },
+      "then": { "properties": { "blockers": { "maxItems": 0 } } },
+      "else": { "properties": { "blockers": { "minItems": 1 } } }
+    }
+  ],
+  "examples": [
+    {
+      "schemaVersion": "OwlCodaRunKitFleetSkillUpgradePlanV1",
+      "status": "blocked",
+      "expectedCore": {
+        "contractVersion": "0.2",
+        "coreVersion": "0.21.0",
+        "coreManifestSha256": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+        "coreSourceRef": "artifact:sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+      },
+      "sharedSkill": {
+        "targetRoot": "/opt/codex/skills/owlcoda-runkit",
+        "status": "version_mismatch",
+        "installedSkillVersion": "0.20.0",
+        "installedConfigCoreVersion": "0.20.0",
+        "issues": ["installed_skill_core_version_mismatch"]
+      },
+      "discovery": { "source": "fleet_registry", "complete": true, "workspaceCount": 1, "unreachableRoots": [] },
+      "affectedProjects": [
+        {
+          "workspaceRoot": "/projects/example",
+          "configPath": "/projects/example/.owlcoda/runkit/config.json",
+          "configCoreVersion": "0.20.0",
+          "activeRunIds": ["active-run"],
+          "activeLeaseIds": [],
+          "upgradeSafe": false
+        }
+      ],
+      "blockers": [{ "code": "active_execution", "workspaceRoot": "/projects/example", "artifactId": "active-run" }],
+      "commands": {
+        "dryRun": "npx --no-install owlrunkit fleet skill-plan ...",
+        "install": "node install-codex-skill.mjs install ...",
+        "rollback": "node install-codex-skill.mjs restore ..."
+      },
+      "authorizationGranted": false
+    }
+  ],
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "strings": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+  }
+}

package/scripts/runkit-contract/schemas/inspect-compact-v1.schema.json

@@ -0,0 +1,93 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/inspect-compact-v1.schema.json",
+  "title": "OwlCoda RunKit Inspect Compact V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion", "status", "exitCode", "projectTruthHash", "progress",
+    "dominantGap", "ownerAgentId", "nextAction", "warningSummary", "execution",
+    "authorityBoundary", "authorizationGranted"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitInspectCompactV1" },
+    "status": { "const": "inspected_compact" },
+    "exitCode": { "enum": [0, 2] },
+    "projectTruthHash": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/hash" }] },
+    "progress": {
+      "type": "object", "additionalProperties": false,
+      "required": ["overall", "completedWorkItems", "totalWorkItems"],
+      "properties": {
+        "overall": { "$ref": "#/$defs/nullableText" },
+        "completedWorkItems": { "$ref": "#/$defs/nullableCount" },
+        "totalWorkItems": { "$ref": "#/$defs/nullableCount" }
+      }
+    },
+    "dominantGap": {
+      "type": "object", "additionalProperties": false,
+      "required": ["code", "reason"],
+      "properties": {
+        "code": { "$ref": "#/$defs/text" },
+        "reason": { "$ref": "#/$defs/nullableText" }
+      }
+    },
+    "ownerAgentId": { "$ref": "#/$defs/nullableText" },
+    "nextAction": { "$ref": "#/$defs/text" },
+    "warningSummary": {
+      "type": "object", "additionalProperties": false,
+      "required": ["count", "groups"],
+      "properties": {
+        "count": { "type": "integer", "minimum": 0 },
+        "groups": {
+          "type": "array",
+          "items": {
+            "type": "object", "additionalProperties": false,
+            "required": ["code", "count", "blocking"],
+            "properties": {
+              "code": { "$ref": "#/$defs/text" },
+              "count": { "type": "integer", "minimum": 1 },
+              "blocking": { "type": "boolean" }
+            }
+          }
+        }
+      }
+    },
+    "execution": {
+      "type": "object", "additionalProperties": false,
+      "required": ["state", "openCount", "activeLeaseCount"],
+      "properties": {
+        "state": { "$ref": "#/$defs/text" },
+        "openCount": { "type": "integer", "minimum": 0 },
+        "activeLeaseCount": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "authorityBoundary": { "$ref": "#/$defs/authorityBoundary" },
+    "authorizationGranted": { "const": false }
+  },
+  "$defs": {
+    "text": { "type": "string", "minLength": 1 },
+    "nullableText": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/text" }] },
+    "nullableCount": { "oneOf": [{ "type": "null" }, { "type": "integer", "minimum": 0 }] },
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "authorityBoundary": {
+      "type": "object", "additionalProperties": false,
+      "required": ["git", "release", "deployment", "production", "business"],
+      "properties": {
+        "git": { "const": false }, "release": { "const": false },
+        "deployment": { "const": false }, "production": { "const": false },
+        "business": { "const": false }
+      }
+    }
+  },
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitInspectCompactV1", "status": "inspected_compact",
+    "exitCode": 0, "projectTruthHash": null,
+    "progress": { "overall": null, "completedWorkItems": null, "totalWorkItems": null },
+    "dominantGap": { "code": "plan_new_execution", "reason": null },
+    "ownerAgentId": null, "nextAction": "plan_new_execution",
+    "warningSummary": { "count": 0, "groups": [] },
+    "execution": { "state": "no_active_execution", "openCount": 0, "activeLeaseCount": 0 },
+    "authorityBoundary": { "git": false, "release": false, "deployment": false, "production": false, "business": false },
+    "authorizationGranted": false
+  }]
+}

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 } } }
+  }
+}