owlrunkit 0.19.2 → 0.21.0

package/scripts/runkit-contract/schemas/candidate-transfer-packet-v1.schema.json

@@ -0,0 +1,98 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/candidate-transfer-packet-v1.schema.json",
+  "title": "OwlCoda RunKit Candidate Transfer Packet V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion", "packetId", "projectBinding", "gateId", "workItemId",
+    "candidateId", "candidateSha256", "baseSha", "head", "branch", "worktree",
+    "dirtyManifestSha256", "patchBundleRef", "snapshotRef", "reconstructionRefs",
+    "protectedArtifacts", "previousOwner", "nextOwner", "lifecycle", "handoffAck",
+    "verificationStatus", "authorityBoundary", "authorizationGranted"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitCandidateTransferPacketV1" },
+    "packetId": { "$ref": "#/$defs/id" },
+    "projectBinding": { "$ref": "#/$defs/projectBinding" },
+    "gateId": { "$ref": "#/$defs/id" },
+    "workItemId": { "$ref": "#/$defs/id" },
+    "candidateId": { "$ref": "#/$defs/id" },
+    "candidateSha256": { "$ref": "#/$defs/sha256Ref" },
+    "baseSha": { "$ref": "#/$defs/gitRef" },
+    "head": { "$ref": "#/$defs/gitRef" },
+    "branch": { "$ref": "#/$defs/text" },
+    "worktree": { "$ref": "#/$defs/absolutePath" },
+    "dirtyManifestSha256": { "$ref": "#/$defs/sha256Ref" },
+    "patchBundleRef": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/artifactSha256Ref" }] },
+    "snapshotRef": { "$ref": "#/$defs/artifactSha256Ref" },
+    "reconstructionRefs": { "$ref": "#/$defs/nonemptyStrings" },
+    "protectedArtifacts": { "$ref": "#/$defs/strings" },
+    "previousOwner": { "$ref": "#/$defs/id" },
+    "nextOwner": { "$ref": "#/$defs/id" },
+    "lifecycle": { "enum": ["candidate_active", "transfer_requested", "packet_generated", "new_owner_validation", "handoff_ack", "old_writer_release"] },
+    "handoffAck": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "agent", "occurredAt", "evidenceRefs"],
+      "properties": {
+        "status": { "enum": ["pending", "accepted", "rejected"] },
+        "agent": { "$ref": "#/$defs/nullableText" },
+        "occurredAt": { "$ref": "#/$defs/nullableIsoUtc" },
+        "evidenceRefs": { "$ref": "#/$defs/strings" }
+      }
+    },
+    "verificationStatus": { "enum": ["source_candidate_unverified", "source_candidate_verified", "accepted", "rework_required"] },
+    "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" }] },
+    "nullableIsoUtc": { "oneOf": [{ "type": "null" }, { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$" }] },
+    "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}$" },
+    "artifactSha256Ref": { "type": "string", "pattern": "^artifact: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]:[\\\\/]|\\\\\\\\)" },
+    "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": { "lifecycle": { "enum": ["handoff_ack", "old_writer_release"] } },
+      "required": ["lifecycle"]
+    },
+    "then": {
+      "properties": {
+        "handoffAck": {
+          "properties": {
+            "status": { "const": "accepted" },
+            "agent": { "$ref": "#/$defs/text" },
+            "occurredAt": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$" },
+            "evidenceRefs": { "minItems": 1 }
+          }
+        }
+      }
+    }
+  }],
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitCandidateTransferPacketV1", "packetId": "transfer-packet-001",
+    "projectBinding": { "projectId": "team-phase1", "projectTruthHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" },
+    "gateId": "ready", "workItemId": "work-1", "candidateId": "candidate-001",
+    "candidateSha256": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
+    "baseSha": "git:2222222222222222222222222222222222222222", "head": "git:3333333333333333333333333333333333333333",
+    "branch": "codex/team-a", "worktree": "/workspace/team-a",
+    "dirtyManifestSha256": "sha256:4444444444444444444444444444444444444444444444444444444444444444",
+    "patchBundleRef": "artifact:sha256:5555555555555555555555555555555555555555555555555555555555555555",
+    "snapshotRef": "artifact:sha256:6666666666666666666666666666666666666666666666666666666666666666",
+    "reconstructionRefs": ["git:2222222222222222222222222222222222222222"], "protectedArtifacts": ["docs/contract.md"],
+    "previousOwner": "agent-a", "nextOwner": "agent-b", "lifecycle": "handoff_ack",
+    "handoffAck": { "status": "accepted", "agent": "agent-b", "occurredAt": "2026-08-13T08:00:00.000Z", "evidenceRefs": ["receipt:transfer-001"] },
+    "verificationStatus": "source_candidate_unverified",
+    "authorityBoundary": { "agentDispatch": false, "git": false, "release": false, "deployment": false, "production": false, "business": false, "automation": false, "money": false },
+    "authorizationGranted": false
+  }]
+}

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-acceptance-packet-v2.schema.json

@@ -0,0 +1,109 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/team-acceptance-packet-v2.schema.json",
+  "title": "OwlCoda RunKit Team Acceptance Packet V2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion", "packetId", "projectBinding", "gateId", "workItemId",
+    "candidateId", "taskPacketSha256", "implementation", "verification",
+    "secondOrderRisk", "independenceStatus", "acceptanceLevel",
+    "candidateIdentityBefore", "candidateIdentityAfter", "freshAdversarialFamilies",
+    "coverageLedger", "protectedArtifactReadback", "productionWriteCount", "findings",
+    "verdict", "allowedNextGate", "remainingAcceptanceLevels",
+    "authorityBoundary", "authorizationGranted"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitTeamAcceptancePacketV2" },
+    "packetId": { "$ref": "#/$defs/id" },
+    "projectBinding": { "$ref": "#/$defs/projectBinding" },
+    "gateId": { "$ref": "#/$defs/id" },
+    "workItemId": { "$ref": "#/$defs/id" },
+    "candidateId": { "$ref": "#/$defs/id" },
+    "taskPacketSha256": { "$ref": "#/$defs/sha256Ref" },
+    "implementation": { "$ref": "#/$defs/modelIdentity" },
+    "verification": { "$ref": "#/$defs/modelIdentity" },
+    "secondOrderRisk": { "enum": ["low", "medium", "high"] },
+    "independenceStatus": { "enum": ["independent", "same_family_not_independent", "control_tower"] },
+    "acceptanceLevel": { "enum": ["L0", "L1", "L2", "L3"] },
+    "candidateIdentityBefore": { "$ref": "#/$defs/sha256Ref" },
+    "candidateIdentityAfter": { "$ref": "#/$defs/sha256Ref" },
+    "freshAdversarialFamilies": { "$ref": "#/$defs/strings" },
+    "coverageLedger": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["evidenceReused", "checksRunFresh", "coveredChecksNotRepeated", "receiptInvalidations", "deferredTransitionGates"],
+      "properties": {
+        "evidenceReused": { "$ref": "#/$defs/strings" },
+        "checksRunFresh": { "$ref": "#/$defs/strings" },
+        "coveredChecksNotRepeated": { "$ref": "#/$defs/strings" },
+        "receiptInvalidations": { "$ref": "#/$defs/strings" },
+        "deferredTransitionGates": { "$ref": "#/$defs/strings" }
+      }
+    },
+    "protectedArtifactReadback": { "$ref": "#/$defs/strings" },
+    "productionWriteCount": { "type": "integer", "minimum": 0 },
+    "findings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["severity", "code", "message", "evidenceRefs"],
+        "properties": {
+          "severity": { "enum": ["critical", "important", "minor", "note"] },
+          "code": { "$ref": "#/$defs/id" },
+          "message": { "$ref": "#/$defs/text" },
+          "evidenceRefs": { "$ref": "#/$defs/strings" }
+        }
+      }
+    },
+    "verdict": { "enum": ["ACCEPT", "REWORK", "BLOCKED"] },
+    "allowedNextGate": { "$ref": "#/$defs/nullableText" },
+    "remainingAcceptanceLevels": { "type": "array", "uniqueItems": true, "items": { "enum": ["L0", "L1", "L2", "L3"] } },
+    "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" } },
+    "sha256Ref": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "projectBinding": { "type": "object", "additionalProperties": false, "required": ["projectId", "projectTruthHash"], "properties": { "projectId": { "$ref": "#/$defs/id" }, "projectTruthHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } },
+    "modelIdentity": { "type": "object", "additionalProperties": false, "required": ["agent", "modelFamily", "modelVersion"], "properties": { "agent": { "$ref": "#/$defs/id" }, "modelFamily": { "$ref": "#/$defs/text" }, "modelVersion": { "$ref": "#/$defs/text" } } },
+    "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": {
+        "verdict": { "const": "ACCEPT" },
+        "acceptanceLevel": { "enum": ["L1", "L2", "L3"] }
+      },
+      "required": ["verdict", "acceptanceLevel"]
+    },
+    "then": {
+      "properties": {
+        "freshAdversarialFamilies": { "minItems": 1 },
+        "coverageLedger": { "properties": { "checksRunFresh": { "minItems": 1 } } }
+      }
+    }
+  }],
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitTeamAcceptancePacketV2",
+    "packetId": "acceptance-packet-001",
+    "projectBinding": { "projectId": "team-phase1", "projectTruthHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" },
+    "gateId": "ready", "workItemId": "work-1", "candidateId": "candidate-001",
+    "taskPacketSha256": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
+    "implementation": { "agent": "agent-a", "modelFamily": "provider:family-a", "modelVersion": "model-a-1" },
+    "verification": { "agent": "agent-b", "modelFamily": "provider:family-b", "modelVersion": "model-b-1" },
+    "secondOrderRisk": "medium", "independenceStatus": "independent", "acceptanceLevel": "L1",
+    "candidateIdentityBefore": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
+    "candidateIdentityAfter": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
+    "freshAdversarialFamilies": ["authority boundary"],
+    "coverageLedger": { "evidenceReused": ["receipt:quick-001"], "checksRunFresh": ["authority boundary"], "coveredChecksNotRepeated": [], "receiptInvalidations": [], "deferredTransitionGates": ["L2 package consumer"] },
+    "protectedArtifactReadback": ["docs/contract.md: unchanged"], "productionWriteCount": 0,
+    "findings": [], "verdict": "ACCEPT", "allowedNextGate": "L2 package consumer", "remainingAcceptanceLevels": ["L2", "L3"],
+    "authorityBoundary": { "agentDispatch": false, "git": false, "release": false, "deployment": false, "production": false, "business": false, "automation": false, "money": false },
+    "authorizationGranted": false
+  }]
+}