owlrunkit 0.18.3 → 0.18.4

package/scripts/runkit-contract/schemas/assurance-route-v2.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/assurance-route-v2.json",
+  "title": "OwlCoda RunKit Assurance Route V2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "status", "lane", "riskMode", "reasonCodes", "nextCommand", "authorizationGranted"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitAssuranceRouteV2" },
+    "status": { "const": "routed" },
+    "lane": { "enum": ["none", "quick", "formal"] },
+    "riskMode": { "enum": ["lightweight", "standard", "full"] },
+    "reasonCodes": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "nextCommand": { "oneOf": [{ "type": "null" }, { "enum": ["npx --no-install owlrunkit quick-verify", "npx --no-install owlrunkit formal start"] }] },
+    "authorizationGranted": { "const": false }
+  },
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitAssuranceRouteV2",
+    "status": "routed",
+    "lane": "quick",
+    "riskMode": "lightweight",
+    "reasonCodes": ["single_bounded_verification"],
+    "nextCommand": "npx --no-install owlrunkit quick-verify",
+    "authorizationGranted": false
+  }]
+}

package/scripts/runkit-contract/schemas/profile-detection-v3.schema.json

@@ -0,0 +1,170 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/profile-detection-v3.json",
+  "title": "OwlCoda RunKit Profile Detection V3",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "status", "dryRun", "writesPerformed", "confidence", "applyStatus", "issueCodes", "proposedProfiles", "candidates", "primaryProfileId", "inputManifest", "toolBinding", "currentProfilesSha256", "detectedScripts", "detectedWorkspaces", "changedPaths", "uncoveredChangedPaths", "uncoveredSourcePaths", "primaryBlockers", "minimalSuggestedProfile", "repairCommands", "authorizationGranted", "detectionSha256"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitProfileDetectionV3" },
+    "status": { "enum": ["profiles_detected", "profiles_insufficient"] },
+    "dryRun": { "const": true },
+    "writesPerformed": { "const": 0 },
+    "confidence": { "enum": ["high", "review_required"] },
+    "applyStatus": { "enum": ["ready_to_apply", "review_required", "profiles_already_exists"] },
+    "issueCodes": { "$ref": "#/$defs/strings" },
+    "proposedProfiles": { "$ref": "#/$defs/profiles" },
+    "candidates": { "type": "array", "items": { "$ref": "#/$defs/profile" } },
+    "primaryProfileId": { "oneOf": [{ "type": "null" }, { "type": "string", "minLength": 1 }] },
+    "inputManifest": { "type": "array", "items": { "$ref": "#/$defs/input" } },
+    "toolBinding": { "$ref": "#/$defs/tool" },
+    "currentProfilesSha256": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/hash" }] },
+    "detectedScripts": { "$ref": "#/$defs/strings" },
+    "detectedWorkspaces": { "type": "array", "items": { "$ref": "#/$defs/workspace" } },
+    "changedPaths": { "$ref": "#/$defs/strings" },
+    "uncoveredChangedPaths": { "$ref": "#/$defs/strings" },
+    "uncoveredSourcePaths": { "$ref": "#/$defs/strings" },
+    "primaryBlockers": { "$ref": "#/$defs/strings" },
+    "minimalSuggestedProfile": {
+      "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/profile" }]
+    },
+    "repairCommands": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["preview", "apply"],
+      "properties": {
+        "preview": { "type": "string", "minLength": 1 },
+        "apply": { "oneOf": [{ "type": "null" }, { "type": "string", "minLength": 1 }] }
+      }
+    },
+    "authorizationGranted": { "const": false },
+    "detectionSha256": { "$ref": "#/$defs/hash" }
+  },
+  "$defs": {
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "strings": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "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" } }
+      }
+    },
+    "input": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "sha256"],
+      "properties": {
+        "path": { "type": "string", "minLength": 1 },
+        "sha256": { "$ref": "#/$defs/hash" }
+      }
+    },
+    "tool": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "confidence", "source", "packageManager", "executable", "argvPrefix", "version", "executableSha256", "launcherSha256"],
+      "properties": {
+        "status": { "enum": ["resolved", "invalid", "unavailable"] },
+        "confidence": { "enum": ["high", "review_required"] },
+        "source": { "type": "string", "minLength": 1 },
+        "packageManager": { "enum": ["npm", "pnpm", "yarn", "bun"] },
+        "executable": { "oneOf": [{ "type": "null" }, { "type": "string", "minLength": 1 }] },
+        "argvPrefix": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+        "version": { "oneOf": [{ "type": "null" }, { "type": "string", "minLength": 1 }] },
+        "executableSha256": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/hash" }] },
+        "launcherSha256": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/hash" }] }
+      }
+    },
+    "workspace": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "path", "scripts"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "path": { "type": "string", "minLength": 1 },
+        "scripts": { "$ref": "#/$defs/strings" }
+      }
+    }
+  },
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitProfileDetectionV3",
+    "status": "profiles_detected",
+    "dryRun": true,
+    "writesPerformed": 0,
+    "confidence": "high",
+    "applyStatus": "ready_to_apply",
+    "issueCodes": [],
+    "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"] }]
+      }]
+    },
+    "candidates": [{
+      "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"] }]
+    }],
+    "primaryProfileId": "node-quality",
+    "inputManifest": [{ "path": "package.json", "sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" }],
+    "toolBinding": {
+      "status": "resolved",
+      "confidence": "high",
+      "source": "project_lockfile",
+      "packageManager": "npm",
+      "executable": "/usr/bin/node",
+      "argvPrefix": ["/usr/lib/npm-cli.js"],
+      "version": "10.0.0",
+      "executableSha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+      "launcherSha256": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"
+    },
+    "currentProfilesSha256": null,
+    "detectedScripts": ["test"],
+    "detectedWorkspaces": [],
+    "changedPaths": [],
+    "uncoveredChangedPaths": [],
+    "uncoveredSourcePaths": [],
+    "primaryBlockers": [],
+    "minimalSuggestedProfile": null,
+    "repairCommands": {
+      "preview": "npx --no-install owlrunkit profiles detect --workspace . --dry-run",
+      "apply": "npx --no-install owlrunkit profiles detect --workspace . --apply"
+    },
+    "authorizationGranted": false,
+    "detectionSha256": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
+  }]
+}

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

@@ -0,0 +1,146 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/team-project-event-v3.schema.json",
+  "title": "OwlCoda RunKit Team Project Event V3",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "eventId",
+    "type",
+    "occurredAt",
+    "deliveryId",
+    "projectId",
+    "projectDefinitionSha256",
+    "assignmentId",
+    "workItemId",
+    "producerId",
+    "targetWorkspaceRef",
+    "targetHead",
+    "entrySnapshotRef",
+    "entrySnapshotSha256",
+    "deliveryPacketSha256",
+    "deliveryCandidateFingerprint",
+    "workspaceSnapshotFingerprint",
+    "overlayStatus",
+    "candidateFiles",
+    "changedPaths",
+    "toolCachePaths",
+    "dependencyEnvironmentPaths",
+    "unchangedPacketPaths",
+    "outOfScopeSourcePaths",
+    "targetSnapshot",
+    "proven",
+    "notProven",
+    "targetWritePerformed",
+    "authorizationGranted"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitTeamProjectEventV3" },
+    "eventId": { "$ref": "#/$defs/id" },
+    "type": { "const": "source_delivery_imported" },
+    "occurredAt": { "type": "string", "minLength": 24 },
+    "deliveryId": { "$ref": "#/$defs/id" },
+    "projectId": { "$ref": "#/$defs/id" },
+    "projectDefinitionSha256": { "$ref": "#/$defs/sha256Ref" },
+    "assignmentId": { "$ref": "#/$defs/id" },
+    "workItemId": { "$ref": "#/$defs/id" },
+    "producerId": { "$ref": "#/$defs/id" },
+    "targetWorkspaceRef": { "type": "string", "minLength": 1 },
+    "targetHead": { "type": "string", "pattern": "^([a-f0-9]{40}|[a-f0-9]{64})$" },
+    "entrySnapshotRef": { "type": ["string", "null"] },
+    "entrySnapshotSha256": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" },
+    "deliveryPacketSha256": { "$ref": "#/$defs/sha256Ref" },
+    "deliveryCandidateFingerprint": { "$ref": "#/$defs/sha256" },
+    "workspaceSnapshotFingerprint": { "$ref": "#/$defs/sha256Ref" },
+    "overlayStatus": { "enum": ["candidate_only", "attested", "attested_with_non_source_changes"] },
+    "candidateFiles": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path", "sha256"],
+        "properties": {
+          "path": { "type": "string", "minLength": 1 },
+          "sha256": { "$ref": "#/$defs/sha256" }
+        }
+      }
+    },
+    "changedPaths": { "$ref": "#/$defs/strings" },
+    "toolCachePaths": { "$ref": "#/$defs/strings" },
+    "dependencyEnvironmentPaths": { "$ref": "#/$defs/strings" },
+    "unchangedPacketPaths": { "$ref": "#/$defs/strings" },
+    "outOfScopeSourcePaths": { "type": "array", "maxItems": 0 },
+    "targetSnapshot": {
+      "$ref": "https://owlcoda.dev/schemas/runkit/trust/workspace-snapshot-v1.schema.json"
+    },
+    "proven": { "$ref": "#/$defs/nonEmptyStrings" },
+    "notProven": { "$ref": "#/$defs/nonEmptyStrings" },
+    "targetWritePerformed": { "const": false },
+    "authorizationGranted": { "const": false }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$" },
+    "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "sha256Ref": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "strings": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "nonEmptyStrings": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+  },
+  "examples": [
+    {
+      "schemaVersion": "OwlCodaRunKitTeamProjectEventV3",
+      "eventId": "source-delivery-delivery-1",
+      "type": "source_delivery_imported",
+      "occurredAt": "2026-08-12T08:02:00.000Z",
+      "deliveryId": "delivery-1",
+      "projectId": "external-delivery-project",
+      "projectDefinitionSha256": "sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
+      "assignmentId": "assign-1",
+      "workItemId": "source-change",
+      "producerId": "luna-max",
+      "targetWorkspaceRef": "/workspace",
+      "targetHead": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "entrySnapshotRef": null,
+      "entrySnapshotSha256": null,
+      "deliveryPacketSha256": "sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
+      "deliveryCandidateFingerprint": "c851c3894a37a00c786719b252d2884606b28f2100bfc0e70acc32853b7ea720",
+      "workspaceSnapshotFingerprint": "sha256:ef3eb2c4af62ed5bf0c3fa9e46169fcf48204cc2e9580835f8849b94007a67f0",
+      "overlayStatus": "candidate_only",
+      "candidateFiles": [
+        {
+          "path": "src/main.mjs",
+          "sha256": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"
+        }
+      ],
+      "changedPaths": [],
+      "toolCachePaths": [],
+      "dependencyEnvironmentPaths": [],
+      "unchangedPacketPaths": [],
+      "outOfScopeSourcePaths": [],
+      "targetSnapshot": {
+        "schemaVersion": "OwlCodaWorkspaceSnapshotV1",
+        "repositoryIdentity": "local:/workspace",
+        "headCommit": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+        "trackedTreeIdentity": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+        "submodules": [],
+        "dirtyOverlay": [
+          {
+            "path": "src/main.mjs",
+            "state": "modified",
+            "sha256": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"
+          }
+        ],
+        "dependencyLockfiles": [],
+        "excludedRoots": [".owlcoda/runkit"],
+        "ignoredPathsBound": false,
+        "policyVersion": "workspace-snapshot-v1",
+        "sourceFingerprint": "sha256:ef3eb2c4af62ed5bf0c3fa9e46169fcf48204cc2e9580835f8849b94007a67f0"
+      },
+      "proven": ["The candidate file hashes match the target workspace."],
+      "notProven": ["Tests and integration were not proven."],
+      "targetWritePerformed": false,
+      "authorizationGranted": false
+    }
+  ]
+}

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

@@ -0,0 +1,85 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/team-project-status-v2.schema.json",
+  "title": "OwlCoda RunKit Team Project Status V2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "status", "projectId", "objective", "overall", "counts", "milestones", "workstreams", "workItems", "agents", "readyQueue", "criticalWorkItems", "openDecisions", "resolvedDecisions", "deferredVerifications", "openDeferredVerificationIds", "integrationGates", "dataCandidates", "sourceDeliveries", "projectTruthHash", "authorizationGranted", "headline", "dominantGap", "nextAction", "nextActorId", "exitCode"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitTeamProjectStatusV2" },
+    "status": { "const": "team_project_status" },
+    "projectId": { "type": "string", "minLength": 1 },
+    "objective": { "type": "string", "minLength": 1 },
+    "overall": { "enum": ["planned", "active", "active_with_blockers", "completed"] },
+    "counts": { "type": "object" },
+    "milestones": { "type": "array", "items": { "type": "object" } },
+    "workstreams": { "type": "array", "items": { "type": "object" } },
+    "workItems": { "type": "array", "items": { "type": "object" } },
+    "agents": { "type": "array", "items": { "type": "object" } },
+    "readyQueue": { "type": "array", "items": { "type": "string" } },
+    "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" } },
+    "sourceDeliveries": { "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": [{
+    "schemaVersion": "OwlCodaRunKitTeamProjectStatusV2",
+    "status": "team_project_status",
+    "projectId": "release-0184",
+    "objective": "Import a frozen external delivery",
+    "overall": "active",
+    "counts": {},
+    "milestones": [],
+    "workstreams": [],
+    "workItems": [],
+    "agents": [],
+    "readyQueue": [],
+    "criticalWorkItems": [],
+    "openDecisions": [],
+    "resolvedDecisions": [],
+    "deferredVerifications": [],
+    "openDeferredVerificationIds": [],
+    "integrationGates": [],
+    "dataCandidates": [],
+    "sourceDeliveries": [],
+    "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/usage-mode-recommendation-v2.schema.json

@@ -0,0 +1,136 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/usage-mode-recommendation-v2.json",
+  "title": "OwlCoda RunKit Usage Mode Recommendation V2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "status",
+    "requestedMode",
+    "recommendedMode",
+    "continuity",
+    "assurance",
+    "triggerReasons",
+    "rejectedLighterModes",
+    "estimatedOverhead",
+    "nextCommand",
+    "downgrade",
+    "authorityBoundary",
+    "authorizationGranted"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitUsageModeRecommendationV2" },
+    "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": "OwlCodaRunKitUsageModeRecommendationV2",
+      "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": "npx --no-install owlrunkit project status --workspace '.'",
+      "downgrade": {
+        "allowed": true,
+        "reasonCodes": []
+      },
+      "authorityBoundary": {
+        "authorizationGranted": false,
+        "git": false,
+        "release": false,
+        "deployment": false,
+        "production": false,
+        "business": false
+      },
+      "authorizationGranted": false
+    }
+  ]
+}