owlrunkit 0.15.0 → 0.16.0

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

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/assurance-route-v1.json",
+  "title": "OwlCoda RunKit Assurance Route V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "status", "lane", "riskMode", "reasonCodes", "nextCommand", "authorizationGranted"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitAssuranceRouteV1" },
+    "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": ["owlrunkit quick-verify", "owlrunkit formal start"] }] },
+    "authorizationGranted": { "const": false }
+  },
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitAssuranceRouteV1",
+    "status": "routed",
+    "lane": "quick",
+    "riskMode": "lightweight",
+    "reasonCodes": ["single_bounded_verification"],
+    "nextCommand": "owlrunkit quick-verify",
+    "authorizationGranted": false
+  }]
+}

package/scripts/runkit-contract/schemas/core-successor-batch-receipt-v1.schema.json

@@ -0,0 +1,126 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/core-successor-batch-receipt-v1.json",
+  "title": "OwlCoda RunKit Core Successor Batch Receipt V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "receiptId", "attemptNumber", "receiptBasePath", "priorAttemptReceiptPath", "priorAttemptReceiptSha256", "planId", "planSha256", "ownerAuthorityId", "ownerAuthoritySha256", "ownerAuthoritySignerKeyId", "ownerAuthorityTrustStoreSha256", "fromCore", "fromCoreMode", "fromCoreSetSha256", "fleetCoreBindings", "toCore", "fleetManifestSha256", "sourceCandidateSha256", "status", "migrationAttempted", "migratedCount", "projectCount", "orphanRecovery", "orphanSuccessReceiptCount", "projects", "projectSuccessReceipts", "repositoryActions", "authorizationGranted", "receiptSha256"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitCoreSuccessorBatchReceiptV1" },
+    "receiptId": { "type": "string", "minLength": 1 },
+    "attemptNumber": { "type": "integer", "minimum": 1 },
+    "receiptBasePath": { "type": "string", "minLength": 1 },
+    "priorAttemptReceiptPath": { "oneOf": [{ "type": "null" }, { "type": "string", "minLength": 1 }] },
+    "priorAttemptReceiptSha256": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/hash" }] },
+    "planId": { "type": "string", "minLength": 1 },
+    "planSha256": { "$ref": "#/$defs/hash" },
+    "ownerAuthorityId": { "type": "string", "minLength": 1 },
+    "ownerAuthoritySha256": { "$ref": "#/$defs/hash" },
+    "ownerAuthoritySignerKeyId": { "type": "string", "minLength": 1 },
+    "ownerAuthorityTrustStoreSha256": { "$ref": "#/$defs/hash" },
+    "fromCore": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/core" }] },
+    "fromCoreMode": { "enum": ["uniform", "per_project"] },
+    "fromCoreSetSha256": { "$ref": "#/$defs/hash" },
+    "fleetCoreBindings": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/coreBinding" } },
+    "toCore": { "$ref": "#/$defs/core" },
+    "fleetManifestSha256": { "$ref": "#/$defs/hash" },
+    "sourceCandidateSha256": { "$ref": "#/$defs/hash" },
+    "status": { "enum": ["applied", "blocked_preflight", "partial_failure"] },
+    "migrationAttempted": { "type": "boolean" },
+    "migratedCount": { "type": "integer", "minimum": 0 },
+    "projectCount": { "type": "integer", "minimum": 1 },
+    "orphanRecovery": { "type": "boolean" },
+    "orphanSuccessReceiptCount": { "type": "integer", "minimum": 0 },
+    "projects": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/project" } },
+    "projectSuccessReceipts": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/projectSuccessReceipt" } },
+    "repositoryActions": { "$ref": "#/$defs/actions" },
+    "authorizationGranted": { "const": false },
+    "receiptSha256": { "$ref": "#/$defs/hash" }
+  },
+  "$defs": {
+    "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "core": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["contractVersion", "coreVersion", "coreManifestSha256", "coreSourceRef"],
+      "properties": {
+        "contractVersion": { "type": "string", "minLength": 1 },
+        "coreVersion": { "type": "string", "minLength": 1 },
+        "coreManifestSha256": { "$ref": "#/$defs/hash" },
+        "coreSourceRef": { "type": "string", "minLength": 1 }
+      }
+    },
+    "project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["workspaceRoot", "fromCore", "status", "issueCodes", "migrationAttempted"],
+      "properties": {
+        "workspaceRoot": { "type": "string", "minLength": 1 },
+        "fromCore": { "$ref": "#/$defs/core" },
+        "status": { "enum": ["safe", "unsafe", "core_drift", "already_migrated", "migrated", "skipped_as_already_migrated", "migration_failed", "not_attempted_after_failure"] },
+        "issueCodes": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+        "migrationAttempted": { "type": "boolean" },
+        "migrationStatus": { "enum": ["upgraded", "initialized"] },
+        "migrationReceipt": { "oneOf": [{ "type": "null" }, { "type": "string", "minLength": 1 }] },
+        "migrationReceiptSha256": { "$ref": "#/$defs/hash" },
+        "projectSuccessReceiptPath": { "type": "string", "minLength": 1 },
+        "projectSuccessReceiptSha256": { "$ref": "#/$defs/hash" }
+      }
+    },
+    "projectSuccessReceipt": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["workspaceRoot", "receiptBasePath", "receiptPath", "receiptSha256"],
+      "properties": {
+        "workspaceRoot": { "type": "string", "minLength": 1 },
+        "receiptBasePath": { "type": "string", "minLength": 1 },
+        "receiptPath": { "type": "string", "minLength": 1 },
+        "receiptSha256": { "$ref": "#/$defs/hash" }
+      }
+    },
+    "coreBinding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["workspaceRoot", "fromCore"],
+      "properties": { "workspaceRoot": { "type": "string", "minLength": 1 }, "fromCore": { "$ref": "#/$defs/core" } }
+    },
+    "actions": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stage", "commit", "push", "publish", "deploy"],
+      "properties": { "stage": { "const": false }, "commit": { "const": false }, "push": { "const": false }, "publish": { "const": false }, "deploy": { "const": false } }
+    }
+  },
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitCoreSuccessorBatchReceiptV1",
+    "receiptId": "apply-001",
+    "attemptNumber": 1,
+    "receiptBasePath": ".owlcoda/runkit/core-successors/successor-001/apply-receipts/apply-001.json",
+    "priorAttemptReceiptPath": null,
+    "priorAttemptReceiptSha256": null,
+    "planId": "successor-001",
+    "planSha256": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "ownerAuthorityId": "owner-001",
+    "ownerAuthoritySha256": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+    "ownerAuthoritySignerKeyId": "owner-key-001",
+    "ownerAuthorityTrustStoreSha256": "sha256:abababababababababababababababababababababababababababababababab",
+    "fromCore": { "contractVersion": "0.2", "coreVersion": "0.15.1", "coreManifestSha256": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc", "coreSourceRef": "artifact:sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc" },
+    "fromCoreMode": "uniform",
+    "fromCoreSetSha256": "sha256:4444444444444444444444444444444444444444444444444444444444444444",
+    "fleetCoreBindings": [{ "workspaceRoot": "/fleet/project", "fromCore": { "contractVersion": "0.2", "coreVersion": "0.15.1", "coreManifestSha256": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc", "coreSourceRef": "artifact:sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc" } }],
+    "toCore": { "contractVersion": "0.2", "coreVersion": "0.16.0", "coreManifestSha256": "sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd", "coreSourceRef": "artifact:sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd" },
+    "fleetManifestSha256": "sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
+    "sourceCandidateSha256": "sha256:ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
+    "status": "applied",
+    "migrationAttempted": true,
+    "migratedCount": 1,
+    "projectCount": 1,
+    "orphanRecovery": false,
+    "orphanSuccessReceiptCount": 0,
+    "projects": [{ "workspaceRoot": "/fleet/project", "fromCore": { "contractVersion": "0.2", "coreVersion": "0.15.1", "coreManifestSha256": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc", "coreSourceRef": "artifact:sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc" }, "status": "migrated", "issueCodes": [], "migrationAttempted": true, "migrationStatus": "upgraded", "migrationReceipt": ".owlcoda/runkit/config-migration-receipts/upgrade.json", "migrationReceiptSha256": "sha256:1212121212121212121212121212121212121212121212121212121212121212", "projectSuccessReceiptPath": ".owlcoda/runkit/core-successors/successor-001/apply-receipts/apply-001-project-success/apply-001-project.json", "projectSuccessReceiptSha256": "sha256:1313131313131313131313131313131313131313131313131313131313131313" }],
+    "projectSuccessReceipts": [{ "workspaceRoot": "/fleet/project", "receiptBasePath": ".owlcoda/runkit/core-successors/successor-001/apply-receipts/apply-001.json", "receiptPath": ".owlcoda/runkit/core-successors/successor-001/apply-receipts/apply-001-project-success/apply-001-project.json", "receiptSha256": "sha256:1313131313131313131313131313131313131313131313131313131313131313" }],
+    "repositoryActions": { "stage": false, "commit": false, "push": false, "publish": false, "deploy": false },
+    "authorizationGranted": false,
+    "receiptSha256": "sha256:1111111111111111111111111111111111111111111111111111111111111111"
+  }]
+}

package/scripts/runkit-contract/schemas/core-successor-plan-v1.schema.json

@@ -0,0 +1,155 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/core-successor-plan-v1.json",
+  "title": "OwlCoda RunKit Core Successor Plan V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "planId", "status", "fromCore", "fromCoreMode", "fromCoreSetSha256", "fleetCoreBindings", "toCore", "sourceCandidate", "fleetDiscoveryRequest", "fleetDiscovery", "migrationContract", "repositoryActions", "authorizationGranted", "planSha256"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitCoreSuccessorPlanV1" },
+    "planId": { "type": "string", "minLength": 1 },
+    "status": { "const": "frozen" },
+    "fromCore": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/core" }] },
+    "fromCoreMode": { "enum": ["uniform", "per_project"] },
+    "fromCoreSetSha256": { "$ref": "#/$defs/hash" },
+    "fleetCoreBindings": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/coreBinding" } },
+    "toCore": { "$ref": "#/$defs/core" },
+    "sourceCandidate": { "$ref": "#/$defs/source" },
+    "fleetDiscoveryRequest": { "$ref": "#/$defs/fleetRequest" },
+    "fleetDiscovery": { "$ref": "#/$defs/discovery" },
+    "migrationContract": { "$ref": "#/$defs/migration" },
+    "repositoryActions": { "$ref": "#/$defs/actions" },
+    "authorizationGranted": { "const": false },
+    "planSha256": { "$ref": "#/$defs/hash" }
+  },
+  "$defs": {
+    "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "core": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["contractVersion", "coreVersion", "coreManifestSha256", "coreSourceRef"],
+      "properties": {
+        "contractVersion": { "type": "string", "minLength": 1 },
+        "coreVersion": { "type": "string", "minLength": 1 },
+        "coreManifestSha256": { "$ref": "#/$defs/hash" },
+        "coreSourceRef": { "type": "string", "pattern": "^artifact:sha256:[a-f0-9]{64}$" }
+      }
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["candidatePath", "candidateSha256", "sourceFingerprint", "pathClosure", "materializationProof"],
+      "properties": {
+        "candidatePath": { "type": "string", "minLength": 1 },
+        "candidateSha256": { "$ref": "#/$defs/hash" },
+        "sourceFingerprint": { "type": "string", "pattern": "^(?:sha256:)?[a-f0-9]{64}$" },
+        "deliveryPacketPath": { "type": "string", "minLength": 1 },
+        "pathClosure": { "$ref": "#/$defs/pathClosure" },
+        "materializationProof": { "$ref": "#/$defs/materializationProof" }
+      }
+    },
+    "coreBinding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["workspaceRoot", "fromCore"],
+      "properties": {
+        "workspaceRoot": { "type": "string", "minLength": 1 },
+        "fromCore": { "$ref": "#/$defs/core" }
+      }
+    },
+    "pathClosure": {
+      "type": "object",
+      "required": ["schemaVersion", "status", "exitCode", "includedPaths", "issueCodes", "closureSha256", "authorizationGranted"],
+      "properties": {
+        "schemaVersion": { "const": "OwlCodaRunKitSourceCandidatePathClosureV1" },
+        "status": { "const": "valid" },
+        "exitCode": { "const": 0 },
+        "includedPaths": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+        "includedDirtyPaths": { "type": "array", "items": { "type": "string" } },
+        "candidateCoveredPaths": { "type": "array", "items": { "type": "string" } },
+        "uncoveredDirtyPaths": { "type": "array", "maxItems": 0, "items": { "type": "string" } },
+        "issueCodes": { "type": "array", "maxItems": 0, "items": { "type": "string" } },
+        "candidateSha256": { "$ref": "#/$defs/hash" },
+        "payloadSha256": { "$ref": "#/$defs/hash" },
+        "closureSha256": { "$ref": "#/$defs/hash" },
+        "authorizationGranted": { "const": false }
+      }
+    },
+    "materializationProof": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["candidateSha256", "payloadSha256", "materializedCore", "matchesToCore"],
+      "properties": {
+        "candidateSha256": { "$ref": "#/$defs/hash" },
+        "payloadSha256": { "$ref": "#/$defs/hash" },
+        "materializedCore": { "$ref": "#/$defs/core" },
+        "matchesToCore": { "const": true }
+      }
+    },
+    "fleetRequest": {
+      "type": "object",
+      "properties": {
+        "workspaceRoots": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+        "fleetRoots": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+        "fleetManifestPath": { "type": "string", "minLength": 1 }
+      }
+    },
+    "discovery": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "source", "coverageRoots", "unreachableRoots", "workspaceRoots", "complete", "frozenManifestSha256", "authorizationGranted"],
+      "properties": {
+        "schemaVersion": { "const": "OwlCodaRunKitFleetDiscoveryV1" },
+        "source": { "type": "string", "minLength": 1 },
+        "manifestPath": { "type": "string", "minLength": 1 },
+        "coverageRoots": { "type": "array", "items": { "type": "string" } },
+        "unreachableRoots": { "type": "array", "items": { "type": "string" } },
+        "workspaceRoots": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+        "complete": { "const": true },
+        "frozenManifestSha256": { "$ref": "#/$defs/hash" },
+        "authorizationGranted": { "const": false }
+      }
+    },
+    "migration": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["completeFleetRequired", "globalPreflightBeforeWrites", "ownerMigrationAuthorityRequired", "migrationScope", "projectOrder"],
+      "properties": {
+        "completeFleetRequired": { "const": true },
+        "globalPreflightBeforeWrites": { "const": true },
+        "ownerMigrationAuthorityRequired": { "const": true },
+        "migrationScope": { "const": "project_runkit_config_and_local_migration_receipt_only" },
+        "projectOrder": { "const": "canonical_workspace_root" }
+      }
+    },
+    "actions": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stage", "commit", "push", "publish", "deploy"],
+      "properties": { "stage": { "const": false }, "commit": { "const": false }, "push": { "const": false }, "publish": { "const": false }, "deploy": { "const": false } }
+    }
+  },
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitCoreSuccessorPlanV1",
+    "planId": "successor-001",
+    "status": "frozen",
+    "fromCore": { "contractVersion": "0.2", "coreVersion": "0.15.1", "coreManifestSha256": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "coreSourceRef": "artifact:sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" },
+    "fromCoreMode": "uniform",
+    "fromCoreSetSha256": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
+    "fleetCoreBindings": [{ "workspaceRoot": "/fleet/project", "fromCore": { "contractVersion": "0.2", "coreVersion": "0.15.1", "coreManifestSha256": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "coreSourceRef": "artifact:sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" } }],
+    "toCore": { "contractVersion": "0.2", "coreVersion": "0.16.0", "coreManifestSha256": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb", "coreSourceRef": "artifact:sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb" },
+    "sourceCandidate": {
+      "candidatePath": ".owlcoda/runkit/source.json",
+      "candidateSha256": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+      "sourceFingerprint": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
+      "pathClosure": { "schemaVersion": "OwlCodaRunKitSourceCandidatePathClosureV1", "status": "valid", "exitCode": 0, "includedPaths": ["scripts/runkit-contract/**"], "issueCodes": [], "closureSha256": "sha256:2222222222222222222222222222222222222222222222222222222222222222", "authorizationGranted": false },
+      "materializationProof": { "candidateSha256": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc", "payloadSha256": "sha256:3333333333333333333333333333333333333333333333333333333333333333", "materializedCore": { "contractVersion": "0.2", "coreVersion": "0.16.0", "coreManifestSha256": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb", "coreSourceRef": "artifact:sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb" }, "matchesToCore": true }
+    },
+    "fleetDiscoveryRequest": { "fleetRoots": ["/fleet"] },
+    "fleetDiscovery": { "schemaVersion": "OwlCodaRunKitFleetDiscoveryV1", "source": "fleet_roots", "coverageRoots": ["/fleet"], "unreachableRoots": [], "workspaceRoots": ["/fleet/project"], "complete": true, "frozenManifestSha256": "sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee", "authorizationGranted": false },
+    "migrationContract": { "completeFleetRequired": true, "globalPreflightBeforeWrites": true, "ownerMigrationAuthorityRequired": true, "migrationScope": "project_runkit_config_and_local_migration_receipt_only", "projectOrder": "canonical_workspace_root" },
+    "repositoryActions": { "stage": false, "commit": false, "push": false, "publish": false, "deploy": false },
+    "authorizationGranted": false,
+    "planSha256": "sha256:ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff"
+  }]
+}

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

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/core-successor-project-success-receipt-v1.json",
+  "title": "OwlCoda RunKit Core Successor Project Success Receipt V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "receiptId", "attemptNumber", "priorAttemptReceiptSha256", "workspaceRoot", "fromCore", "toCore", "planSha256", "ownerAuthoritySha256", "fleetManifestSha256", "migrationStatus", "migrationReceiptPath", "migrationReceiptSha256", "postConfigSha256", "repositoryActions", "authorizationGranted", "receiptSha256"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitCoreSuccessorProjectSuccessReceiptV1" },
+    "receiptId": { "type": "string", "minLength": 1 },
+    "attemptNumber": { "type": "integer", "minimum": 1 },
+    "priorAttemptReceiptSha256": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/hash" }] },
+    "workspaceRoot": { "type": "string", "minLength": 1 },
+    "fromCore": { "$ref": "#/$defs/core" },
+    "toCore": { "$ref": "#/$defs/core" },
+    "planSha256": { "$ref": "#/$defs/hash" },
+    "ownerAuthoritySha256": { "$ref": "#/$defs/hash" },
+    "fleetManifestSha256": { "$ref": "#/$defs/hash" },
+    "migrationStatus": { "enum": ["upgraded", "initialized"] },
+    "migrationReceiptPath": { "type": "string", "minLength": 1 },
+    "migrationReceiptSha256": { "$ref": "#/$defs/hash" },
+    "postConfigSha256": { "$ref": "#/$defs/hash" },
+    "repositoryActions": { "$ref": "#/$defs/actions" },
+    "authorizationGranted": { "const": false },
+    "receiptSha256": { "$ref": "#/$defs/hash" }
+  },
+  "$defs": {
+    "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "core": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["contractVersion", "coreVersion", "coreManifestSha256", "coreSourceRef"],
+      "properties": {
+        "contractVersion": { "type": "string", "minLength": 1 },
+        "coreVersion": { "type": "string", "minLength": 1 },
+        "coreManifestSha256": { "$ref": "#/$defs/hash" },
+        "coreSourceRef": { "type": "string", "minLength": 1 }
+      }
+    },
+    "actions": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stage", "commit", "push", "publish", "deploy"],
+      "properties": {
+        "stage": { "const": false },
+        "commit": { "const": false },
+        "push": { "const": false },
+        "publish": { "const": false },
+        "deploy": { "const": false }
+      }
+    }
+  },
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitCoreSuccessorProjectSuccessReceiptV1",
+    "receiptId": "apply-001",
+    "attemptNumber": 1,
+    "priorAttemptReceiptSha256": null,
+    "workspaceRoot": "/fleet/project",
+    "fromCore": { "contractVersion": "0.2", "coreVersion": "0.15.1", "coreManifestSha256": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "coreSourceRef": "artifact:sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" },
+    "toCore": { "contractVersion": "0.2", "coreVersion": "0.16.0", "coreManifestSha256": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb", "coreSourceRef": "artifact:sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb" },
+    "planSha256": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+    "ownerAuthoritySha256": "sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
+    "fleetManifestSha256": "sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
+    "migrationStatus": "upgraded",
+    "migrationReceiptPath": ".owlcoda/runkit/config-migration-receipts/upgrade.json",
+    "migrationReceiptSha256": "sha256:ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
+    "postConfigSha256": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
+    "repositoryActions": { "stage": false, "commit": false, "push": false, "publish": false, "deploy": false },
+    "authorizationGranted": false,
+    "receiptSha256": "sha256:2222222222222222222222222222222222222222222222222222222222222222"
+  }]
+}

package/scripts/runkit-contract/schemas/deployment-execute-request-v1.schema.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/deployment-execute-request-v1.json",
+  "title": "OwlCoda RunKit Deployment Execute Request V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "executeRunId", "executeGoal", "prepareReceiptSha256", "target", "ownerAuthority", "ownerDecision", "ownerDecisionSnapshot", "workItemId", "profileId", "resourcePreflight", "deploy", "destructive"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitDeploymentExecuteRequestV1" },
+    "executeRunId": { "$ref": "#/$defs/id" },
+    "executeGoal": { "$ref": "#/$defs/descriptor" },
+    "prepareReceiptSha256": { "$ref": "#/$defs/hash" },
+    "target": { "$ref": "#/$defs/target" },
+    "ownerAuthority": { "$ref": "#/$defs/descriptor" },
+    "ownerDecision": { "$ref": "#/$defs/descriptor" },
+    "ownerDecisionSnapshot": { "$ref": "#/$defs/descriptor" },
+    "workItemId": { "$ref": "#/$defs/id" },
+    "profileId": { "$ref": "#/$defs/id" },
+    "resourcePreflight": { "$ref": "#/$defs/descriptor" },
+    "deploy": { "const": true },
+    "destructive": { "type": "boolean" }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$" },
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "descriptor": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "sha256"],
+      "properties": { "path": { "type": "string", "minLength": 1 }, "sha256": { "$ref": "#/$defs/hash" } }
+    },
+    "target": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "targetId", "environment", "host", "port", "user", "hostKeySha256", "machineIdentitySha256"],
+      "properties": {
+        "schemaVersion": { "const": "OwlCodaRunKitRemoteTargetV1" },
+        "targetId": { "$ref": "#/$defs/id" },
+        "environment": { "$ref": "#/$defs/id" },
+        "host": { "type": "string", "minLength": 1 },
+        "port": { "type": "integer", "minimum": 1, "maximum": 65535 },
+        "user": { "type": "string", "pattern": "^[A-Za-z_][A-Za-z0-9._-]*$" },
+        "hostKeySha256": { "$ref": "#/$defs/hash" },
+        "machineIdentitySha256": { "$ref": "#/$defs/hash" }
+      }
+    }
+  },
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitDeploymentExecuteRequestV1",
+    "executeRunId": "deployment-execute-001",
+    "executeGoal": { "path": ".owlcoda/runkit/executions/deployment-execute-001/goal-contract.json", "sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" },
+    "prepareReceiptSha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+    "target": { "schemaVersion": "OwlCodaRunKitRemoteTargetV1", "targetId": "vm-production-01", "environment": "production", "host": "deploy.example.invalid", "port": 22, "user": "deploy", "hostKeySha256": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc", "machineIdentitySha256": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd" },
+    "ownerAuthority": { "path": "authorities/deployment-execute-001.json", "sha256": "eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee" },
+    "ownerDecision": { "path": "authorities/owner-deployment-decision-001.json", "sha256": "1111111111111111111111111111111111111111111111111111111111111111" },
+    "ownerDecisionSnapshot": { "path": ".owlcoda/runkit/deployments/deployment-execute-001/owner-decision-snapshot.json", "sha256": "2222222222222222222222222222222222222222222222222222222222222222" },
+    "workItemId": "deployment-execute",
+    "profileId": "deployment",
+    "resourcePreflight": { "path": ".owlcoda/runkit/executions/deployment-execute-001/resource-preflights/deployment.json", "sha256": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff" },
+    "deploy": true,
+    "destructive": false
+  }]
+}