owlrunkit 0.19.2 → 0.20.0

package/scripts/runkit-contract/runkit-cli.mjs

@@ -197,6 +197,14 @@ import {
   captureTargetWorkspaceSnapshotV1,
   importExternalDeliveryV1,
 } from "./project-external-delivery.mjs";
+import {
+  formatTeamDeliveryRecommendationHumanV1,
+  formatTeamDeliveryStatusHumanV1,
+  formatTeamPacketValidationHumanV1,
+  readTeamDeliveryStatusV1,
+  recommendTeamDeliveryV1,
+  validateTeamPacketFileV1,
+} from "./team-delivery.mjs";
 
 const TOP_LEVEL_HELP = `OwlRunKit ${CORE_VERSION}
 
@@ -234,10 +242,10 @@ Fleet and status
 
 Agent team projects
   npx --no-install owlrunkit project <init|assign|checkpoint|handoff|reject-and-return|reopen-upstream|transfer|work-item revise-scope|decision|verification|capture|target-snapshot|import-delivery|status|takeover|successor> [options]
-  Durable Agent work, dependencies, decisions, gates, progress, and handoffs.
+  npx --no-install owlrunkit team <recommend|status|packet validate> [options]
+  Durable project truth plus read-only Team recommendation and packet validation. No Agent dispatch.
 Core successor
   npx --no-install owlrunkit core-successor <plan|apply|resume> --workspace . [...]
-
 Other onboarding commands:
   npx --no-install owlrunkit profiles validate --workspace .; npx --no-install owlrunkit profiles impact --workspace . --changed <path>
   npx --no-install owlrunkit inspect --workspace . --json
@@ -308,6 +316,34 @@ Persisted mode preferences are not part of this release.
   npx --no-install owlrunkit mode status --workspace <directory> [--json]
 
 Reads the current mode preference source without creating project state.
+`,
+  team: `Usage:
+  npx --no-install owlrunkit team recommend --workspace <directory> [--json]
+  npx --no-install owlrunkit team status --workspace <directory> [--json]
+  npx --no-install owlrunkit team packet validate --workspace <directory>
+    --packet <packet.json> [--json]
+
+Projects existing Project Driver truth into a read-only Team Delivery view and
+validates portable Team packets. It never dispatches an Agent or grants Git,
+release, deployment, production, business, automation, or money authority.
+`,
+  "team recommend": `Usage:
+  npx --no-install owlrunkit team recommend --workspace <directory> [--json]
+
+Recommends Team coordination only when current Project Driver facts require it.
+Single ordinary lanes and uninitialized projects remain off. This is read-only.
+`,
+  "team status": `Usage:
+  npx --no-install owlrunkit team status --workspace <directory> [--json]
+
+Reads a Team Delivery projection from Project Driver. No second graph is stored.
+`,
+  "team packet validate": `Usage:
+  npx --no-install owlrunkit team packet validate --workspace <directory>
+    --packet <packet.json> [--json]
+
+Validates a TeamTaskPacketV2, TeamAcceptancePacketV2, or
+CandidateTransferPacketV1 against current project truth without writing state.
 `,
   "quick-attest": `Usage:
   npx --no-install owlrunkit quick-attest --workspace <directory> --receipt <receipt.json> [--json]
@@ -2307,6 +2343,7 @@ export async function runCli(argv = process.argv.slice(2), runtimeHooks = {}) {
       "mode",
       "profiles",
       "project",
+      "team",
     ]).has(command);
     let [action, ...nestedOptions] = nested ? optionValues : [null, ...optionValues];
     if (command === "project" && action === "work-item"
@@ -2314,6 +2351,11 @@ export async function runCli(argv = process.argv.slice(2), runtimeHooks = {}) {
       action = "work-item revise-scope";
       nestedOptions = nestedOptions.slice(1);
     }
+    if (command === "team" && action === "packet"
+      && nestedOptions[0] === "validate") {
+      action = "packet validate";
+      nestedOptions = nestedOptions.slice(1);
+    }
     const helpRequested = optionValues.includes("--help")
       || optionValues.includes("-h");
     if (helpRequested) {
@@ -2390,6 +2432,8 @@ export async function runCli(argv = process.argv.slice(2), runtimeHooks = {}) {
           ]
         : command === "mode" && action === "status"
           ? ["json"]
+        : command === "team"
+          ? ["json"]
         : command === "inspect"
         ? ["json", "verbose", "history"]
         : command === "init"
@@ -2591,6 +2635,39 @@ export async function runCli(argv = process.argv.slice(2), runtimeHooks = {}) {
       }
       throw new Error("Usage: npx --no-install owlrunkit mode <recommend|status> --workspace <directory>");
     }
+    if (command === "team") {
+      const root = workspace(options);
+      if (action === "recommend") {
+        assertOnlyOptions(options, ["workspace", "json"]);
+        const recommendation = recommendTeamDeliveryV1({ workspaceRoot: root });
+        return options.json === true
+          ? recommendation
+          : withHumanOutput(
+              recommendation,
+              formatTeamDeliveryRecommendationHumanV1(recommendation),
+            );
+      }
+      if (action === "status") {
+        assertOnlyOptions(options, ["workspace", "json"]);
+        const status = readTeamDeliveryStatusV1({ workspaceRoot: root });
+        return options.json === true
+          ? status
+          : withHumanOutput(status, formatTeamDeliveryStatusHumanV1(status));
+      }
+      if (action === "packet validate") {
+        assertOnlyOptions(options, ["workspace", "packet", "json"]);
+        const validation = validateTeamPacketFileV1({
+          workspaceRoot: root,
+          packetPath: requireOption(options, "packet"),
+        });
+        return options.json === true
+          ? validation
+          : withHumanOutput(validation, formatTeamPacketValidationHumanV1(validation));
+      }
+      throw new Error(
+        "Usage: npx --no-install owlrunkit team <recommend|status|packet validate> --workspace <directory>",
+      );
+    }
     if (command === "fleet") {
       if (action === "register-root") {
         const registered = await registerFleetCoverageRoot({
@@ -4253,7 +4330,7 @@ export async function runCli(argv = process.argv.slice(2), runtimeHooks = {}) {
       return withControlTransaction(root, () => closeout(options));
     }
     if (command === "finish") return finishExecution(options);
-    throw new Error("Usage: npx --no-install owlrunkit <bootstrap|init|doctor|adopt|mode|assurance|fleet|profiles|project|status|formal|candidate|deployment|core-successor|start|verify|repair|offline-export|offline-import|quick-verify|quick-reuse|quick-runtime-verify|quick-attest|quick-metrics|efficiency|finish|plan|inspect|lease|delivery|coverage-adopt|resume|verify-plan|resource-preflight|snapshot|visual-smoke|finalize|ready-for-commit|closeout> [options]");
+    throw new Error("Usage: npx --no-install owlrunkit <bootstrap|init|doctor|adopt|mode|team|assurance|fleet|profiles|project|status|formal|candidate|deployment|core-successor|start|verify|repair|offline-export|offline-import|quick-verify|quick-reuse|quick-runtime-verify|quick-attest|quick-metrics|efficiency|finish|plan|inspect|lease|delivery|coverage-adopt|resume|verify-plan|resource-preflight|snapshot|visual-smoke|finalize|ready-for-commit|closeout> [options]");
   } catch (error) {
     return {
       status: "invalid_input",

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

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

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

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

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

package/scripts/runkit-contract/schemas/team-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
+  }]
+}