owlrunkit 0.17.2 → 0.18.1

package/scripts/runkit-contract/schemas/profile-reconcile-plan-v1.schema.json

@@ -0,0 +1,105 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/profile-reconcile-plan-v1.json",
+  "title": "OwlCoda RunKit Profiles Reconcile Plan V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "status", "valid", "exitCode", "dryRun", "writesPerformed", "detectionSha256", "currentProfilesSha256", "issueCodes", "authorizationGranted"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitProfilesReconcilePlanV1" },
+    "status": { "enum": ["profiles_reconcile_ready", "profiles_already_current", "profiles_reconcile_blocked"] },
+    "valid": { "type": "boolean" },
+    "exitCode": { "enum": [0, 2] },
+    "dryRun": { "type": "boolean" },
+    "writesPerformed": { "const": 0 },
+    "reconcileSha256": { "$ref": "#/$defs/hash" },
+    "detectionSha256": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/hash" }] },
+    "currentProfilesSha256": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/hash" }] },
+    "proposedProfilesSha256": { "$ref": "#/$defs/hash" },
+    "addedProfileIds": { "$ref": "#/$defs/strings" },
+    "updatedProfiles": { "type": "array", "items": { "$ref": "#/$defs/update" } },
+    "proposedProfiles": { "$ref": "#/$defs/profiles" },
+    "issueCodes": { "$ref": "#/$defs/strings" },
+    "authorizationGranted": { "const": false }
+  },
+  "$defs": {
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "strings": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "update": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["profileId", "addedPaths", "addedCommandIds", "updatedCommandIds"],
+      "properties": {
+        "profileId": { "type": "string", "minLength": 1 },
+        "addedPaths": { "$ref": "#/$defs/strings" },
+        "addedCommandIds": { "$ref": "#/$defs/strings" },
+        "updatedCommandIds": { "$ref": "#/$defs/strings" }
+      }
+    },
+    "command": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "cwd", "executable", "argv"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "cwd": { "type": "string", "minLength": 1 },
+        "executable": { "oneOf": [{ "type": "null" }, { "type": "string", "minLength": 1 }] },
+        "argv": { "type": "array", "minItems": 1, "items": { "type": "string" } }
+      }
+    },
+    "profile": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "paths", "role", "primary", "requiresProfileIds", "commands"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "paths": { "$ref": "#/$defs/strings" },
+        "role": { "enum": ["primary", "supporting"] },
+        "primary": { "type": "boolean" },
+        "requiresProfileIds": { "$ref": "#/$defs/strings" },
+        "commands": { "type": "array", "items": { "$ref": "#/$defs/command" } }
+      }
+    },
+    "profiles": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "profiles"],
+      "properties": {
+        "schemaVersion": { "const": "OwlCodaRunKitProfilesV1" },
+        "profiles": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/profile" } }
+      }
+    }
+  },
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitProfilesReconcilePlanV1",
+    "status": "profiles_reconcile_ready",
+    "valid": true,
+    "exitCode": 0,
+    "dryRun": true,
+    "writesPerformed": 0,
+    "reconcileSha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "detectionSha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+    "currentProfilesSha256": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+    "proposedProfilesSha256": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
+    "addedProfileIds": [],
+    "updatedProfiles": [{
+      "profileId": "node-quality",
+      "addedPaths": ["package.json"],
+      "addedCommandIds": ["npm-test"],
+      "updatedCommandIds": []
+    }],
+    "proposedProfiles": {
+      "schemaVersion": "OwlCodaRunKitProfilesV1",
+      "profiles": [{
+        "id": "node-quality",
+        "paths": ["package.json"],
+        "role": "primary",
+        "primary": true,
+        "requiresProfileIds": [],
+        "commands": [{ "id": "npm-test", "cwd": ".", "executable": "/usr/bin/node", "argv": ["/usr/lib/npm-cli.js", "run", "test"] }]
+      }]
+    },
+    "issueCodes": [],
+    "authorizationGranted": false
+  }]
+}

package/scripts/runkit-contract/schemas/profile-reconcile-receipt-v1.schema.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/profile-reconcile-receipt-v1.json",
+  "title": "OwlCoda RunKit Profiles Reconcile Receipt V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "status", "exitCode", "writesPerformed", "dryRun", "reconcileSha256", "detectionSha256", "beforeProfilesSha256", "appliedProfilesSha256", "addedProfileIds", "updatedProfiles", "receiptPath", "issueCodes", "authorizationGranted"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitProfilesReconcileReceiptV1" },
+    "status": { "const": "profiles_reconciled" },
+    "exitCode": { "const": 0 },
+    "writesPerformed": { "const": 2 },
+    "dryRun": { "const": false },
+    "reconcileSha256": { "$ref": "#/$defs/hash" },
+    "detectionSha256": { "$ref": "#/$defs/hash" },
+    "beforeProfilesSha256": { "$ref": "#/$defs/hash" },
+    "appliedProfilesSha256": { "$ref": "#/$defs/hash" },
+    "addedProfileIds": { "$ref": "#/$defs/strings" },
+    "updatedProfiles": { "type": "array", "items": { "$ref": "#/$defs/update" } },
+    "receiptPath": { "type": "string", "pattern": "^\\.owlcoda/runkit/profile-reconcile-receipts/[a-f0-9]{64}\\.json$" },
+    "issueCodes": { "$ref": "#/$defs/strings" },
+    "authorizationGranted": { "const": false }
+  },
+  "$defs": {
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "strings": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "update": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["profileId", "addedPaths", "addedCommandIds", "updatedCommandIds"],
+      "properties": {
+        "profileId": { "type": "string", "minLength": 1 },
+        "addedPaths": { "$ref": "#/$defs/strings" },
+        "addedCommandIds": { "$ref": "#/$defs/strings" },
+        "updatedCommandIds": { "$ref": "#/$defs/strings" }
+      }
+    }
+  },
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitProfilesReconcileReceiptV1",
+    "status": "profiles_reconciled",
+    "exitCode": 0,
+    "writesPerformed": 2,
+    "dryRun": false,
+    "reconcileSha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "detectionSha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+    "beforeProfilesSha256": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+    "appliedProfilesSha256": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
+    "addedProfileIds": [],
+    "updatedProfiles": [{
+      "profileId": "node-quality",
+      "addedPaths": ["package.json"],
+      "addedCommandIds": ["npm-test"],
+      "updatedCommandIds": []
+    }],
+    "receiptPath": ".owlcoda/runkit/profile-reconcile-receipts/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json",
+    "issueCodes": [],
+    "authorizationGranted": false
+  }]
+}

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

@@ -8,7 +8,7 @@
   "properties": {
     "schemaVersion": { "const": "OwlCodaRunKitTeamProjectEventV1" },
     "eventId": { "$ref": "#/$defs/id" },
-    "type": { "enum": ["agent_assigned", "checkpoint_recorded", "handoff_recorded", "decision_opened", "decision_resolved", "integration_gate_passed", "data_candidate_recorded"] },
+    "type": { "enum": ["agent_assigned", "checkpoint_recorded", "handoff_recorded", "decision_opened", "decision_resolved", "integration_gate_passed", "verification_deferred", "verification_closed", "data_candidate_recorded"] },
     "occurredAt": { "type": "string", "minLength": 24 },
     "assignmentId": { "$ref": "#/$defs/id" },
     "supersedesAssignmentId": { "$ref": "#/$defs/id" },
@@ -35,6 +35,12 @@
     "resolution": { "type": "string", "minLength": 1 },
     "rationale": { "type": "string", "minLength": 1 },
     "gateId": { "$ref": "#/$defs/id" },
+    "verificationId": { "$ref": "#/$defs/id" },
+    "checkIds": { "$ref": "#/$defs/ids" },
+    "reason": { "type": "string", "minLength": 1 },
+    "dueGateId": { "$ref": "#/$defs/id" },
+    "disposition": { "enum": ["verified", "no_longer_required"] },
+    "decisionIds": { "$ref": "#/$defs/ids" },
     "candidateId": { "$ref": "#/$defs/id" },
     "sourceRef": { "type": "string", "minLength": 1 },
     "rights": { "type": "string", "minLength": 1 },
@@ -76,6 +82,14 @@
       "if": { "properties": { "type": { "const": "integration_gate_passed" } }, "required": ["type"] },
       "then": { "required": ["gateId", "summary", "evidenceRefs"] }
     },
+    {
+      "if": { "properties": { "type": { "const": "verification_deferred" } }, "required": ["type"] },
+      "then": { "required": ["verificationId", "workItemId", "ownerAgentId", "checkIds", "reason", "dueGateId"] }
+    },
+    {
+      "if": { "properties": { "type": { "const": "verification_closed" } }, "required": ["type"] },
+      "then": { "required": ["verificationId", "disposition", "summary", "evidenceRefs", "decisionIds"] }
+    },
     {
       "if": { "properties": { "type": { "const": "data_candidate_recorded" } }, "required": ["type"] },
       "then": { "required": ["candidateId", "sourceRef", "rights", "inputRef", "outputRef", "decisionRef", "verificationRefs", "outcomeRef", "version"] }
@@ -83,6 +97,7 @@
   ],
   "$defs": {
     "id": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$" },
+    "ids": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
     "strings": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
   },
   "examples": [{

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

@@ -4,7 +4,7 @@
   "title": "OwlCoda RunKit Team Project Status V1",
   "type": "object",
   "additionalProperties": false,
-  "required": ["schemaVersion", "status", "projectId", "objective", "overall", "counts", "milestones", "workstreams", "workItems", "agents", "readyQueue", "criticalWorkItems", "openDecisions", "resolvedDecisions", "integrationGates", "dataCandidates", "projectTruthHash", "authorizationGranted", "exitCode"],
+  "required": ["schemaVersion", "status", "projectId", "objective", "overall", "counts", "milestones", "workstreams", "workItems", "agents", "readyQueue", "criticalWorkItems", "openDecisions", "resolvedDecisions", "deferredVerifications", "openDeferredVerificationIds", "integrationGates", "dataCandidates", "projectTruthHash", "authorizationGranted", "headline", "dominantGap", "nextAction", "nextActorId", "exitCode"],
   "properties": {
     "schemaVersion": { "const": "OwlCodaRunKitTeamProjectStatusV1" },
     "status": { "const": "team_project_status" },
@@ -20,10 +20,29 @@
     "criticalWorkItems": { "type": "array", "items": { "type": "string" } },
     "openDecisions": { "type": "array", "items": { "type": "object" } },
     "resolvedDecisions": { "type": "array", "items": { "type": "object" } },
+    "deferredVerifications": { "type": "array", "items": { "type": "object" } },
+    "openDeferredVerificationIds": { "type": "array", "items": { "type": "string" } },
     "integrationGates": { "type": "array", "items": { "type": "object" } },
     "dataCandidates": { "type": "array", "items": { "type": "object" } },
     "projectTruthHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
     "authorizationGranted": { "const": false },
+    "headline": { "type": "string", "minLength": 1 },
+    "dominantGap": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "id", "title", "workItemId", "agentId", "reason", "truthRefs"],
+      "properties": {
+        "kind": { "enum": ["decision", "failed_work", "work_item", "deferred_verification", "integration_gate", "none"] },
+        "id": { "type": ["string", "null"] },
+        "title": { "type": ["string", "null"] },
+        "workItemId": { "type": ["string", "null"] },
+        "agentId": { "type": ["string", "null"] },
+        "reason": { "type": ["string", "null"] },
+        "truthRefs": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+      }
+    },
+    "nextAction": { "type": ["string", "null"] },
+    "nextActorId": { "type": ["string", "null"] },
     "exitCode": { "const": 0 }
   },
   "examples": [{
@@ -41,10 +60,24 @@
     "criticalWorkItems": [],
     "openDecisions": [],
     "resolvedDecisions": [],
+    "deferredVerifications": [],
+    "openDeferredVerificationIds": [],
     "integrationGates": [],
     "dataCandidates": [],
     "projectTruthHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
     "authorizationGranted": false,
+    "headline": "Dominant gap: none; owner: unassigned; blocker: none; next: none.",
+    "dominantGap": {
+      "kind": "none",
+      "id": null,
+      "title": null,
+      "workItemId": null,
+      "agentId": null,
+      "reason": null,
+      "truthRefs": ["project/definition.json"]
+    },
+    "nextAction": null,
+    "nextActorId": null,
     "exitCode": 0
   }]
 }

package/scripts/runkit-contract/schemas/team-project-successor-receipt-v1.schema.json

@@ -0,0 +1,204 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/team-project-successor-receipt-v1.schema.json",
+  "title": "OwlCoda RunKit Team Project Successor Receipt V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "status",
+    "transitionId",
+    "phase",
+    "occurredAt",
+    "reason",
+    "requestSha256",
+    "receiptPath",
+    "from",
+    "to",
+    "archive",
+    "repositoryActions",
+    "authorizationGranted",
+    "receiptSha256"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitTeamProjectSuccessorReceiptV1" },
+    "status": { "const": "team_project_successor" },
+    "transitionId": { "$ref": "#/$defs/id" },
+    "phase": { "enum": ["prepared", "archived", "active_installed", "completed"] },
+    "occurredAt": { "type": "string", "format": "date-time" },
+    "reason": { "type": "string", "minLength": 1 },
+    "requestSha256": { "$ref": "#/$defs/hash" },
+    "receiptPath": { "type": "string", "minLength": 1 },
+    "from": { "$ref": "#/$defs/projectFrom" },
+    "to": { "$ref": "#/$defs/projectTo" },
+    "archive": { "$ref": "#/$defs/archive" },
+    "repositoryActions": { "$ref": "#/$defs/actions" },
+    "authorizationGranted": { "const": false },
+    "receiptSha256": { "$ref": "#/$defs/hash" }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"
+    },
+    "hash": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "definition": {
+      "type": "object"
+    },
+    "projectFrom": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "projectId",
+        "definition",
+        "definitionRawSha256",
+        "definitionCanonicalSha256",
+        "projectTruthHash",
+        "eventCount"
+      ],
+      "properties": {
+        "projectId": { "$ref": "#/$defs/id" },
+        "definition": { "$ref": "#/$defs/definition" },
+        "definitionRawSha256": { "$ref": "#/$defs/hash" },
+        "definitionCanonicalSha256": { "$ref": "#/$defs/hash" },
+        "projectTruthHash": { "$ref": "#/$defs/hash" },
+        "eventCount": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "projectTo": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "projectId",
+        "definitionSourcePath",
+        "definitionSourceSha256",
+        "definition",
+        "definitionRawSha256",
+        "definitionCanonicalSha256",
+        "projectTruthHash",
+        "eventCount"
+      ],
+      "properties": {
+        "projectId": { "$ref": "#/$defs/id" },
+        "definitionSourcePath": { "type": "string", "minLength": 1 },
+        "definitionSourceSha256": { "$ref": "#/$defs/hash" },
+        "definition": { "$ref": "#/$defs/definition" },
+        "definitionRawSha256": { "$ref": "#/$defs/hash" },
+        "definitionCanonicalSha256": { "$ref": "#/$defs/hash" },
+        "projectTruthHash": { "$ref": "#/$defs/hash" },
+        "eventCount": { "const": 0 }
+      }
+    },
+    "archiveFile": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "byteLength", "sha256"],
+      "properties": {
+        "path": { "type": "string", "minLength": 1 },
+        "byteLength": { "type": "integer", "minimum": 0 },
+        "sha256": { "$ref": "#/$defs/hash" }
+      }
+    },
+    "archive": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "manifestAlgorithm", "manifestSha256", "directories", "files", "sealPolicy"],
+      "properties": {
+        "path": { "type": "string", "minLength": 1 },
+        "manifestAlgorithm": { "const": "sha256-canonical-json-v1" },
+        "manifestSha256": { "$ref": "#/$defs/hash" },
+        "directories": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "files": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/$defs/archiveFile" }
+        },
+        "sealPolicy": { "$ref": "#/$defs/sealPolicy" }
+      }
+    },
+    "sealPolicy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["policy", "regularFileMode", "directoryMode"],
+      "properties": {
+        "policy": { "const": "posix-owner-write-denied-v1" },
+        "regularFileMode": { "const": "0444" },
+        "directoryMode": { "const": "0555" }
+      }
+    },
+    "actions": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["staged", "committed", "pushed", "tagged", "published", "deployed"],
+      "properties": {
+        "staged": { "const": false },
+        "committed": { "const": false },
+        "pushed": { "const": false },
+        "tagged": { "const": false },
+        "published": { "const": false },
+        "deployed": { "const": false }
+      }
+    }
+  },
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitTeamProjectSuccessorReceiptV1",
+    "status": "team_project_successor",
+    "transitionId": "transition-001",
+    "phase": "completed",
+    "occurredAt": "2026-08-09T08:00:00.000Z",
+    "reason": "Begin the next bounded project.",
+    "requestSha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "receiptPath": ".owlcoda/runkit/project-successor-transitions/transition-001.json",
+    "from": {
+      "projectId": "project-old",
+      "definition": {},
+      "definitionRawSha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+      "definitionCanonicalSha256": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+      "projectTruthHash": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
+      "eventCount": 3
+    },
+    "to": {
+      "projectId": "project-new",
+      "definitionSourcePath": "/workspace/next-project.json",
+      "definitionSourceSha256": "eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
+      "definition": {},
+      "definitionRawSha256": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
+      "definitionCanonicalSha256": "1111111111111111111111111111111111111111111111111111111111111111",
+      "projectTruthHash": "2222222222222222222222222222222222222222222222222222222222222222",
+      "eventCount": 0
+    },
+    "archive": {
+      "path": ".owlcoda/runkit/project-archives/project-old-dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd-4444444444444444444444444444444444444444444444444444444444444444",
+      "manifestAlgorithm": "sha256-canonical-json-v1",
+      "manifestSha256": "4444444444444444444444444444444444444444444444444444444444444444",
+      "directories": ["events"],
+      "files": [{
+        "path": "definition.json",
+        "byteLength": 512,
+        "sha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
+      }],
+      "sealPolicy": {
+        "policy": "posix-owner-write-denied-v1",
+        "regularFileMode": "0444",
+        "directoryMode": "0555"
+      }
+    },
+    "repositoryActions": {
+      "staged": false,
+      "committed": false,
+      "pushed": false,
+      "tagged": false,
+      "published": false,
+      "deployed": false
+    },
+    "authorizationGranted": false,
+    "receiptSha256": "5555555555555555555555555555555555555555555555555555555555555555"
+  }]
+}

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

@@ -0,0 +1,136 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/usage-mode-recommendation-v1.json",
+  "title": "OwlCoda RunKit Usage Mode Recommendation V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "status",
+    "requestedMode",
+    "recommendedMode",
+    "continuity",
+    "assurance",
+    "triggerReasons",
+    "rejectedLighterModes",
+    "estimatedOverhead",
+    "nextCommand",
+    "downgrade",
+    "authorityBoundary",
+    "authorizationGranted"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitUsageModeRecommendationV1" },
+    "status": { "enum": ["mode_recommended", "mode_status"] },
+    "requestedMode": { "enum": ["auto", "off", "light", "managed", "formal"] },
+    "recommendedMode": { "enum": ["off", "light", "managed", "formal"] },
+    "continuity": { "enum": ["none", "project_driver"] },
+    "assurance": { "enum": ["none", "quick", "formal"] },
+    "triggerReasons": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "rejectedLighterModes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["mode", "reasonCodes"],
+        "properties": {
+          "mode": { "enum": ["off", "light", "managed"] },
+          "reasonCodes": {
+            "type": "array",
+            "minItems": 1,
+            "uniqueItems": true,
+            "items": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    },
+    "estimatedOverhead": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["additionalSteps", "evidenceArtifacts"],
+      "properties": {
+        "additionalSteps": { "type": "integer", "minimum": 0 },
+        "evidenceArtifacts": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "nextCommand": {
+      "oneOf": [
+        { "type": "null" },
+        { "type": "string", "minLength": 1 }
+      ]
+    },
+    "downgrade": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["allowed", "reasonCodes"],
+      "properties": {
+        "allowed": { "type": "boolean" },
+        "reasonCodes": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "authorityBoundary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["authorizationGranted", "git", "release", "deployment", "production", "business"],
+      "properties": {
+        "authorizationGranted": { "const": false },
+        "git": { "const": false },
+        "release": { "const": false },
+        "deployment": { "const": false },
+        "production": { "const": false },
+        "business": { "const": false }
+      }
+    },
+    "authorizationGranted": { "const": false },
+    "preferenceSource": { "const": "default_auto" },
+    "persistedPreference": { "type": "null" }
+  },
+  "examples": [
+    {
+      "schemaVersion": "OwlCodaRunKitUsageModeRecommendationV1",
+      "status": "mode_recommended",
+      "requestedMode": "auto",
+      "recommendedMode": "managed",
+      "continuity": "project_driver",
+      "assurance": "quick",
+      "triggerReasons": ["cross_session_continuity", "single_bounded_verification"],
+      "rejectedLighterModes": [
+        {
+          "mode": "off",
+          "reasonCodes": ["cross_session_continuity", "single_bounded_verification"]
+        },
+        {
+          "mode": "light",
+          "reasonCodes": ["cross_session_continuity", "single_bounded_verification"]
+        }
+      ],
+      "estimatedOverhead": {
+        "additionalSteps": 3,
+        "evidenceArtifacts": 2
+      },
+      "nextCommand": "owlrunkit project status --workspace '.'",
+      "downgrade": {
+        "allowed": true,
+        "reasonCodes": []
+      },
+      "authorityBoundary": {
+        "authorizationGranted": false,
+        "git": false,
+        "release": false,
+        "deployment": false,
+        "production": false,
+        "business": false
+      },
+      "authorizationGranted": false
+    }
+  ]
+}