owlrunkit 0.15.0 → 0.16.0

package/scripts/runkit-contract/schemas/owner-authority-trust-v1.schema.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/owner-authority-trust-v1.json",
+  "title": "OwlCoda RunKit Owner Authority Trust V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "keys"],
+  "properties": {
+    "schemaVersion": {
+      "const": "OwlCodaRunKitOwnerAuthorityTrustV1"
+    },
+    "keys": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "keyId",
+          "algorithm",
+          "publicKeyPem",
+          "publicKeySha256",
+          "purposes",
+          "status"
+        ],
+        "properties": {
+          "keyId": { "$ref": "#/$defs/id" },
+          "algorithm": { "const": "ed25519" },
+          "publicKeyPem": {
+            "type": "string",
+            "pattern": "^-----BEGIN PUBLIC KEY-----"
+          },
+          "publicKeySha256": { "$ref": "#/$defs/hash" },
+          "purposes": {
+            "type": "array",
+            "minItems": 1,
+            "uniqueItems": true,
+            "items": { "$ref": "#/$defs/id" }
+          },
+          "status": { "const": "active" }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$"
+    },
+    "hash": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    }
+  },
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitOwnerAuthorityTrustV1",
+    "keys": [{
+      "keyId": "owner-key-001",
+      "algorithm": "ed25519",
+      "publicKeyPem": "-----BEGIN PUBLIC KEY-----\nMCowBQYDK2VwAyEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=\n-----END PUBLIC KEY-----\n",
+      "publicKeySha256": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "purposes": ["core_successor", "remote_deployment"],
+      "status": "active"
+    }]
+  }]
+}

package/scripts/runkit-contract/schemas/owner-deployment-authority-v1.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/owner-deployment-authority-v1.json",
+  "title": "OwlCoda RunKit Owner Deployment Authority V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "authorityId", "decision", "scope", "executeRunId", "prepareReceiptSha256", "targetSha256", "artifactSha256", "permissions", "authorizationGranted", "authoritySha256"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitOwnerDeploymentAuthorityV1" },
+    "authorityId": { "$ref": "#/$defs/id" },
+    "decision": { "const": "approved" },
+    "scope": { "const": "execute_exact_remote_deployment" },
+    "executeRunId": { "$ref": "#/$defs/id" },
+    "prepareReceiptSha256": { "$ref": "#/$defs/hash" },
+    "targetSha256": { "$ref": "#/$defs/hash" },
+    "artifactSha256": { "$ref": "#/$defs/hash" },
+    "permissions": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["deploy", "destructive"],
+      "properties": {
+        "deploy": { "const": true },
+        "destructive": { "type": "boolean" }
+      }
+    },
+    "authorizationGranted": { "const": false },
+    "authoritySha256": { "$ref": "#/$defs/hash" }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$" },
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+  },
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitOwnerDeploymentAuthorityV1",
+    "authorityId": "owner-deployment-execute-001",
+    "decision": "approved",
+    "scope": "execute_exact_remote_deployment",
+    "executeRunId": "deployment-execute-001",
+    "prepareReceiptSha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "targetSha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+    "artifactSha256": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+    "permissions": { "deploy": true, "destructive": false },
+    "authorizationGranted": false,
+    "authoritySha256": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
+  }]
+}

package/scripts/runkit-contract/schemas/owner-deployment-authority-v2.schema.json

@@ -0,0 +1,94 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/owner-deployment-authority-v2.json",
+  "title": "OwlCoda RunKit Owner Deployment Authority V2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "authorityId",
+    "decision",
+    "scope",
+    "executeRunId",
+    "prepareReceiptSha256",
+    "targetSha256",
+    "artifactSha256",
+    "remoteManifestFileSha256",
+    "remoteDeploymentIntentSha256",
+    "ownerDecisionId",
+    "ownerDecisionSha256",
+    "signerKeyId",
+    "signatureAlgorithm",
+    "permissions",
+    "authorizationGranted",
+    "authoritySha256",
+    "signature"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "OwlCodaRunKitOwnerDeploymentAuthorityV2"
+    },
+    "authorityId": { "$ref": "#/$defs/id" },
+    "decision": { "const": "approved" },
+    "scope": { "const": "execute_exact_remote_deployment" },
+    "executeRunId": { "$ref": "#/$defs/id" },
+    "prepareReceiptSha256": { "$ref": "#/$defs/digest" },
+    "targetSha256": { "$ref": "#/$defs/digest" },
+    "artifactSha256": { "$ref": "#/$defs/digest" },
+    "remoteManifestFileSha256": { "$ref": "#/$defs/digest" },
+    "remoteDeploymentIntentSha256": { "$ref": "#/$defs/digest" },
+    "ownerDecisionId": { "$ref": "#/$defs/id" },
+    "ownerDecisionSha256": { "$ref": "#/$defs/digest" },
+    "signerKeyId": { "$ref": "#/$defs/id" },
+    "signatureAlgorithm": { "const": "ed25519" },
+    "permissions": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["deploy", "destructive"],
+      "properties": {
+        "deploy": { "const": true },
+        "destructive": { "type": "boolean" }
+      }
+    },
+    "authorizationGranted": { "const": false },
+    "authoritySha256": { "$ref": "#/$defs/hashRef" },
+    "signature": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9+/]+={0,2}$"
+    }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$"
+    },
+    "digest": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "hashRef": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    }
+  },
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitOwnerDeploymentAuthorityV2",
+    "authorityId": "owner-deployment-execute-001",
+    "decision": "approved",
+    "scope": "execute_exact_remote_deployment",
+    "executeRunId": "deployment-execute-001",
+    "prepareReceiptSha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "targetSha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+    "artifactSha256": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+    "remoteManifestFileSha256": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
+    "remoteDeploymentIntentSha256": "eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
+    "ownerDecisionId": "owner-clean-install-001",
+    "ownerDecisionSha256": "1111111111111111111111111111111111111111111111111111111111111111",
+    "signerKeyId": "owner-key-001",
+    "signatureAlgorithm": "ed25519",
+    "permissions": { "deploy": true, "destructive": false },
+    "authorizationGranted": false,
+    "authoritySha256": "sha256:ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
+    "signature": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=="
+  }]
+}

package/scripts/runkit-contract/schemas/owner-deployment-decision-v1.schema.json

@@ -0,0 +1,102 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/owner-deployment-decision-v1.json",
+  "title": "OwlCoda RunKit Owner Deployment Decision V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "decisionId",
+    "decisionVersion",
+    "provenance",
+    "project",
+    "supersedesDecisionSha256",
+    "deploymentMode",
+    "existingProjectAssets",
+    "legacyRollbackAllowed",
+    "dataAuthority",
+    "serviceActivationAuthorized",
+    "baselineCutAuthorized",
+    "destructiveScope",
+    "decisionSha256"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitOwnerDeploymentDecisionV1" },
+    "decisionId": { "$ref": "#/$defs/id" },
+    "decisionVersion": { "type": "integer", "minimum": 1 },
+    "provenance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "sourceRef", "recordedAt"],
+      "properties": {
+        "kind": { "const": "owner_explicit" },
+        "sourceRef": { "type": "string", "minLength": 1 },
+        "recordedAt": { "type": "string", "format": "date-time" }
+      }
+    },
+    "project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["projectId", "scope"],
+      "properties": {
+        "projectId": { "$ref": "#/$defs/id" },
+        "scope": { "$ref": "#/$defs/id" }
+      }
+    },
+    "supersedesDecisionSha256": {
+      "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/hash" }]
+    },
+    "deploymentMode": { "enum": ["clean_install", "in_place_update"] },
+    "existingProjectAssets": { "enum": ["preserve", "replace", "remove"] },
+    "legacyRollbackAllowed": { "type": "boolean" },
+    "dataAuthority": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "sourceRef"],
+      "properties": {
+        "mode": {
+          "enum": ["preserve_existing", "replace_from_artifact", "initialize_new"]
+        },
+        "sourceRef": { "type": "string", "minLength": 1 }
+      }
+    },
+    "serviceActivationAuthorized": { "type": "boolean" },
+    "baselineCutAuthorized": { "type": "boolean" },
+    "destructiveScope": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 },
+      "uniqueItems": true
+    },
+    "decisionSha256": { "$ref": "#/$defs/hash" }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$"
+    },
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+  },
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitOwnerDeploymentDecisionV1",
+    "decisionId": "owner-clean-install-001",
+    "decisionVersion": 1,
+    "provenance": {
+      "kind": "owner_explicit",
+      "sourceRef": "owner:decision/clean-install-001",
+      "recordedAt": "2026-08-01T00:00:00.000Z"
+    },
+    "project": { "projectId": "owlapp", "scope": "production" },
+    "supersedesDecisionSha256": null,
+    "deploymentMode": "clean_install",
+    "existingProjectAssets": "replace",
+    "legacyRollbackAllowed": false,
+    "dataAuthority": {
+      "mode": "initialize_new",
+      "sourceRef": "owner:data-authority/clean-install-001"
+    },
+    "serviceActivationAuthorized": true,
+    "baselineCutAuthorized": true,
+    "destructiveScope": [],
+    "decisionSha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+  }]
+}

package/scripts/runkit-contract/schemas/owner-migration-authority-v1.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/owner-migration-authority-v1.json",
+  "title": "OwlCoda RunKit Owner Migration Authority V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "authorityId", "decision", "scope", "planSha256", "fromCoreSetSha256", "toCoreManifestSha256", "fleetManifestSha256", "authorizationGranted", "authoritySha256"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitOwnerMigrationAuthorityV1" },
+    "authorityId": { "type": "string", "minLength": 1 },
+    "decision": { "const": "approved" },
+    "scope": { "const": "migrate_declared_core_successor_fleet" },
+    "planSha256": { "$ref": "#/$defs/hash" },
+    "fromCoreSetSha256": { "$ref": "#/$defs/hash" },
+    "toCoreManifestSha256": { "$ref": "#/$defs/hash" },
+    "fleetManifestSha256": { "$ref": "#/$defs/hash" },
+    "authorizationGranted": { "const": false },
+    "authoritySha256": { "$ref": "#/$defs/hash" }
+  },
+  "$defs": { "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } },
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitOwnerMigrationAuthorityV1",
+    "authorityId": "owner-core-successor-001",
+    "decision": "approved",
+    "scope": "migrate_declared_core_successor_fleet",
+    "planSha256": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "fromCoreSetSha256": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+    "toCoreManifestSha256": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+    "fleetManifestSha256": "sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
+    "authorizationGranted": false,
+    "authoritySha256": "sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
+  }]
+}

package/scripts/runkit-contract/schemas/owner-migration-authority-v2.schema.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/owner-migration-authority-v2.json",
+  "title": "OwlCoda RunKit Owner Migration Authority V2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "authorityId",
+    "decision",
+    "scope",
+    "planSha256",
+    "fromCoreSetSha256",
+    "toCoreManifestSha256",
+    "fleetManifestSha256",
+    "signerKeyId",
+    "signatureAlgorithm",
+    "authorizationGranted",
+    "authoritySha256",
+    "signature"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "OwlCodaRunKitOwnerMigrationAuthorityV2"
+    },
+    "authorityId": { "$ref": "#/$defs/id" },
+    "decision": { "const": "approved" },
+    "scope": { "const": "migrate_declared_core_successor_fleet" },
+    "planSha256": { "$ref": "#/$defs/hash" },
+    "fromCoreSetSha256": { "$ref": "#/$defs/hash" },
+    "toCoreManifestSha256": { "$ref": "#/$defs/hash" },
+    "fleetManifestSha256": { "$ref": "#/$defs/hash" },
+    "signerKeyId": { "$ref": "#/$defs/id" },
+    "signatureAlgorithm": { "const": "ed25519" },
+    "authorizationGranted": { "const": false },
+    "authoritySha256": { "$ref": "#/$defs/hash" },
+    "signature": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9+/]+={0,2}$"
+    }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$"
+    },
+    "hash": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    }
+  },
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitOwnerMigrationAuthorityV2",
+    "authorityId": "owner-core-successor-001",
+    "decision": "approved",
+    "scope": "migrate_declared_core_successor_fleet",
+    "planSha256": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "fromCoreSetSha256": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+    "toCoreManifestSha256": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+    "fleetManifestSha256": "sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
+    "signerKeyId": "owner-key-001",
+    "signatureAlgorithm": "ed25519",
+    "authorizationGranted": false,
+    "authoritySha256": "sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
+    "signature": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=="
+  }]
+}

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

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/profile-apply-receipt-v1.json",
+  "title": "OwlCoda RunKit Profiles Apply Receipt V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "status", "writesPerformed", "detectionSha256", "issueCodes", "authorizationGranted"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitProfilesApplyReceiptV1" },
+    "status": { "enum": ["profiles_applied", "profiles_apply_blocked"] },
+    "writesPerformed": { "enum": [0, 2] },
+    "detectionSha256": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/hash" }] },
+    "beforeProfilesSha256": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/hash" }] },
+    "appliedProfilesSha256": { "$ref": "#/$defs/hash" },
+    "currentProfilesSha256": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/hash" }] },
+    "receiptPath": { "type": "string", "minLength": 1 },
+    "issueCodes": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "authorizationGranted": { "const": false }
+  },
+  "$defs": { "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" } },
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitProfilesApplyReceiptV1",
+    "status": "profiles_applied",
+    "writesPerformed": 2,
+    "detectionSha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "beforeProfilesSha256": null,
+    "appliedProfilesSha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+    "receiptPath": ".owlcoda/runkit/profile-apply-receipts/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json",
+    "issueCodes": [],
+    "authorizationGranted": false
+  }]
+}

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

@@ -0,0 +1,145 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/profile-detection-v2.json",
+  "title": "OwlCoda RunKit Profile Detection V2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "status", "dryRun", "writesPerformed", "confidence", "applyStatus", "issueCodes", "proposedProfiles", "candidates", "primaryProfileId", "inputManifest", "toolBinding", "currentProfilesSha256", "detectedScripts", "detectedWorkspaces", "authorizationGranted", "detectionSha256"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitProfileDetectionV2" },
+    "status": { "const": "profiles_detected" },
+    "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" } },
+    "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": "OwlCodaRunKitProfileDetectionV2",
+    "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": [],
+    "authorizationGranted": false,
+    "detectionSha256": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
+  }]
+}

package/scripts/runkit-contract/schemas/ready-for-commit-v2.schema.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/ready-for-commit-v2.json",
+  "title": "OwlCoda RunKit Ready For Commit Request V2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "verificationGateInputPath", "roots"],
+  "oneOf": [
+    {
+      "required": ["deliveryPacketPath"],
+      "not": { "required": ["sourceCandidatePath"] }
+    },
+    {
+      "required": ["sourceCandidatePath"],
+      "not": { "required": ["deliveryPacketPath"] }
+    }
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitReadyForCommitRequestV2" },
+    "deliveryPacketPath": { "type": "string", "minLength": 1 },
+    "sourceCandidatePath": { "type": "string", "minLength": 1 },
+    "verificationGateInputPath": { "type": "string", "minLength": 1 },
+    "roots": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["role", "snapshotPath"],
+        "properties": {
+          "role": { "type": "string", "minLength": 1 },
+          "snapshotPath": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  }
+}