owlrunkit 0.13.0

package/scripts/runkit-contract/schemas/closeout-receipt-v2.schema.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/closeout-receipt-v2.json",
+  "title": "OwlCoda RunKit Accepted Closeout Payload V2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["runId", "decision", "authorizationGranted", "verification"],
+  "properties": {
+    "runId": { "type": "string", "minLength": 1 },
+    "decision": { "const": "accepted" },
+    "authorizationGranted": { "const": false },
+    "verification": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["contractVersion", "gateDecision", "gateInputSha256", "activeReceiptSha256", "sourceFingerprint", "verificationContextFingerprint", "selectedProfileIds", "leaseState", "releasedLeaseIds"],
+      "properties": {
+        "contractVersion": { "const": "0.2" },
+        "gateDecision": { "const": "accepted_passed" },
+        "gateInputSha256": { "$ref": "#/$defs/sha256" },
+        "activeReceiptSha256": { "$ref": "#/$defs/sha256" },
+        "sourceFingerprint": { "$ref": "#/$defs/sha256" },
+        "verificationContextFingerprint": { "$ref": "#/$defs/sha256" },
+        "selectedProfileIds": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "leaseState": { "const": "released" },
+        "releasedLeaseIds": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        }
+      }
+    }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+  }
+}

package/scripts/runkit-contract/schemas/core-artifact-v2.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/core-artifact-v2.json",
+  "title": "OwlCoda RunKit Core Artifact V2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "core", "producer", "payload", "extensions"],
+  "properties": {
+    "schemaVersion": { "const": "RunKitCoreArtifactV2" },
+    "core": { "$ref": "engine-pin-v2.schema.json" },
+    "producer": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["adapterKind", "adapterVersion"],
+      "properties": {
+        "adapterKind": { "type": "string", "minLength": 1 },
+        "adapterVersion": { "type": "string", "minLength": 1 }
+      }
+    },
+    "payload": { "type": "object" },
+    "extensions": { "type": "object", "propertyNames": { "pattern": "^[^.]+\\..+" } }
+  }
+}

package/scripts/runkit-contract/schemas/core-artifact.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/core-artifact-v1.json",
+  "title": "OwlCoda RunKit Core Artifact V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "core", "producer", "payload", "extensions"],
+  "properties": {
+    "schemaVersion": { "const": "RunKitCoreArtifactV1" },
+    "core": { "$ref": "engine-pin.schema.json" },
+    "producer": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["adapterKind", "adapterVersion"],
+      "properties": {
+        "adapterKind": { "type": "string", "minLength": 1 },
+        "adapterVersion": { "type": "string", "minLength": 1 }
+      }
+    },
+    "payload": { "type": "object" },
+    "extensions": { "type": "object", "propertyNames": { "pattern": "^[^.]+\\..+" } }
+  }
+}

package/scripts/runkit-contract/schemas/coverage-adopt-request-v1.schema.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/coverage-adopt-request-v1.json",
+  "title": "OwlCoda RunKit Coverage Adopt Request V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "coverageId", "sources"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitCoverageAdoptRequestV1" },
+    "coverageId": { "type": "string", "minLength": 1 },
+    "sources": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "gateInputPath",
+          "gateInputSha256",
+          "commandBindings",
+          "dependencyBindings"
+        ],
+        "properties": {
+          "gateInputPath": { "type": "string", "minLength": 1 },
+          "gateInputSha256": { "$ref": "#/$defs/sha256" },
+          "commandBindings": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["receiptCommandId", "profileId", "commandId"],
+              "properties": {
+                "receiptCommandId": { "type": "string", "minLength": 1 },
+                "profileId": { "type": "string", "minLength": 1 },
+                "commandId": { "type": "string", "minLength": 1 }
+              }
+            }
+          },
+          "dependencyBindings": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["dependencyId", "source"],
+              "properties": {
+                "dependencyId": { "type": "string", "minLength": 1 },
+                "source": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["kind", "identity"],
+                  "properties": {
+                    "kind": { "enum": ["lockfile", "fixture", "material_input"] },
+                    "identity": { "type": "string", "minLength": 1 }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+  }
+}

package/scripts/runkit-contract/schemas/engine-pin-v2.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/engine-pin-v2.json",
+  "title": "OwlCoda RunKit Engine Pin V2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion", "coreVersion", "coreManifestSha256", "coreSourceRef"],
+  "properties": {
+    "contractVersion": { "const": "0.2" },
+    "coreVersion": { "type": "string", "minLength": 1 },
+    "coreManifestSha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "coreSourceRef": { "type": "string", "minLength": 1 }
+  }
+}

package/scripts/runkit-contract/schemas/engine-pin.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/engine-pin-v1.json",
+  "title": "OwlCoda RunKit Engine Pin V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion", "coreVersion", "coreManifestSha256", "coreSourceRef"],
+  "properties": {
+    "contractVersion": { "const": "0.1" },
+    "coreVersion": { "type": "string", "minLength": 1 },
+    "coreManifestSha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "coreSourceRef": { "type": "string", "minLength": 1 }
+  }
+}

package/scripts/runkit-contract/schemas/evidence-coverage-index-v1.schema.json

@@ -0,0 +1,131 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/evidence-coverage-index-v1.json",
+  "title": "OwlCoda RunKit Evidence Coverage Index V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "coverageId",
+    "runId",
+    "generatedFrom",
+    "entries",
+    "authorizationGranted"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitEvidenceCoverageIndexV1" },
+    "coverageId": { "type": "string", "minLength": 1 },
+    "runId": { "type": "string", "minLength": 1 },
+    "generatedFrom": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "gateInputPath",
+          "gateInputSha256",
+          "commandBindings",
+          "dependencyBindings",
+          "activeReceiptSha256",
+          "sourceRunId"
+        ],
+        "properties": {
+          "gateInputPath": { "type": "string", "minLength": 1 },
+          "gateInputSha256": { "$ref": "#/$defs/sha256" },
+          "commandBindings": { "$ref": "#/$defs/commandBindings" },
+          "dependencyBindings": { "$ref": "#/$defs/dependencyBindings" },
+          "activeReceiptSha256": { "$ref": "#/$defs/sha256" },
+          "sourceRunId": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "entries": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "receiptId",
+          "receiptSha256",
+          "status",
+          "sourceFiles",
+          "dependencySha256",
+          "verificationContextFingerprint",
+          "profileIds",
+          "commandIds"
+        ],
+        "properties": {
+          "receiptId": { "type": "string", "minLength": 1 },
+          "receiptSha256": { "$ref": "#/$defs/sha256" },
+          "status": {
+            "enum": [
+              "passed",
+              "ready_for_verification",
+              "shadow_validated",
+              "invalidated_by_concurrent_write"
+            ]
+          },
+          "sourceFiles": { "$ref": "#/$defs/fileMap" },
+          "dependencySha256": { "$ref": "#/$defs/hashMap" },
+          "verificationContextFingerprint": { "$ref": "#/$defs/sha256" },
+          "profileIds": {
+            "type": "array",
+            "items": { "type": "string", "minLength": 1 },
+            "uniqueItems": true
+          },
+          "commandIds": {
+            "type": "array",
+            "items": { "type": "string", "minLength": 1 },
+            "uniqueItems": true
+          }
+        }
+      }
+    },
+    "authorizationGranted": { "const": false }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "commandBindings": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["receiptCommandId", "profileId", "commandId"],
+        "properties": {
+          "receiptCommandId": { "type": "string", "minLength": 1 },
+          "profileId": { "type": "string", "minLength": 1 },
+          "commandId": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "dependencyBindings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["dependencyId", "source"],
+        "properties": {
+          "dependencyId": { "type": "string", "minLength": 1 },
+          "source": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["kind", "identity"],
+            "properties": {
+              "kind": { "enum": ["lockfile", "fixture", "material_input"] },
+              "identity": { "type": "string", "minLength": 1 }
+            }
+          }
+        }
+      }
+    },
+    "fileMap": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/$defs/sha256" }
+    },
+    "hashMap": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/$defs/sha256" }
+    }
+  }
+}

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

@@ -0,0 +1,131 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/finalize-request-v1.json",
+  "title": "OwlCoda RunKit Finalize Request V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "receiptId", "deliveryPacketPath", "verificationContext", "snapshotPaths"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitFinalizeRequestV1" },
+    "receiptId": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$" },
+    "deliveryPacketPath": { "type": "string", "minLength": 1 },
+    "verificationContext": { "$ref": "verification-context-v1.schema.json" },
+    "snapshotPaths": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "supersedesReceiptSha256": { "$ref": "#/$defs/sha256" },
+    "reusedCommandReceipts": {
+      "type": "array",
+      "items": { "$ref": "verification-receipt-v2.schema.json#/$defs/commandReceipt" }
+    },
+    "repairControl": {
+      "$ref": "#/$defs/repairControl"
+    }
+  },
+  "allOf": [
+    {
+      "anyOf": [
+        {
+          "properties": {
+            "snapshotPaths": { "minItems": 1 }
+          }
+        },
+        {
+          "required": ["reusedCommandReceipts"],
+          "properties": {
+            "reusedCommandReceipts": { "minItems": 1 }
+          }
+        }
+      ]
+    },
+    {
+      "if": {
+        "required": ["supersedesReceiptSha256"]
+      },
+      "then": {
+        "required": ["repairControl"]
+      }
+    },
+    {
+      "if": {
+        "required": ["repairControl"]
+      },
+      "then": {
+        "required": ["supersedesReceiptSha256"]
+      }
+    },
+    {
+      "if": {
+        "required": ["reusedCommandReceipts"],
+        "properties": {
+          "reusedCommandReceipts": { "minItems": 1 }
+        }
+      },
+      "then": {
+        "required": ["supersedesReceiptSha256", "repairControl"]
+      }
+    }
+  ],
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "repairControl": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "repairPlanPath",
+        "repairPlanSha256",
+        "parentBindingMode",
+        "goalContractSha256",
+        "risk",
+        "profilesSha256",
+        "executableBindings"
+      ],
+      "properties": {
+        "repairPlanPath": { "type": "string", "minLength": 1 },
+        "repairPlanSha256": { "$ref": "#/$defs/sha256" },
+        "parentBindingMode": { "const": "receipt" },
+        "goalContractSha256": { "$ref": "#/$defs/sha256" },
+        "risk": { "$ref": "#/$defs/risk" },
+        "profilesSha256": { "$ref": "#/$defs/sha256" },
+        "executableBindings": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/$defs/executableBinding" }
+        }
+      }
+    },
+    "risk": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["riskMode", "riskCategories"],
+      "properties": {
+        "riskMode": { "enum": ["lightweight", "standard", "full"] },
+        "riskCategories": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "backtest",
+              "funds",
+              "migration",
+              "production",
+              "release"
+            ]
+          }
+        }
+      }
+    },
+    "executableBinding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["commandId", "executable", "sha256"],
+      "properties": {
+        "commandId": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$" },
+        "executable": { "type": "string", "minLength": 1 },
+        "sha256": { "$ref": "#/$defs/sha256" }
+      }
+    }
+  }
+}

package/scripts/runkit-contract/schemas/profiles.schema.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/profiles-v1.json",
+  "title": "OwlCoda RunKit Profiles V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "profiles"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitProfilesV1" },
+    "profiles": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "paths"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "paths": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+          "role": { "enum": ["primary", "supporting"] },
+          "primary": { "type": "boolean" },
+          "requiresProfileIds": {
+            "type": "array",
+            "items": { "type": "string", "minLength": 1 },
+            "uniqueItems": true
+          },
+          "commands": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["id", "cwd", "executable", "argv"],
+              "properties": {
+                "id": { "type": "string", "minLength": 1 },
+                "cwd": { "type": "string", "minLength": 1 },
+                "executable": { "type": "string", "minLength": 1 },
+                "argv": {
+                  "type": "array",
+                  "items": { "type": "string", "minLength": 1 }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/project-config-v2.json",
+  "title": "OwlCoda RunKit Project Config V2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "core", "authorizationPolicy"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitConfigV2" },
+    "core": { "$ref": "engine-pin-v2.schema.json" },
+    "authorizationPolicy": { "const": "external_explicit_authority_required" }
+  }
+}

package/scripts/runkit-contract/schemas/project-config.schema.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/project-config-v1.json",
+  "title": "OwlCoda RunKit Project Config V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "core", "authorizationPolicy"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitConfigV1" },
+    "core": { "$ref": "engine-pin.schema.json" },
+    "authorizationPolicy": { "const": "external_explicit_authority_required" }
+  }
+}

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

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/ready-for-commit-v1.json",
+  "title": "OwlCoda RunKit Ready For Commit Request V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "deliveryPacketPath", "verificationGateInputPath", "roots"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitReadyForCommitRequestV1" },
+    "deliveryPacketPath": { "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 }
+        }
+      }
+    }
+  }
+}

package/scripts/runkit-contract/schemas/replayable-evidence-v1.schema.json

@@ -0,0 +1,82 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/replayable-evidence-v1.json",
+  "title": "OwlCoda RunKit Replayable Evidence V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "cwd", "launcher", "toolVersions", "materialInputs", "outputArtifacts"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitReplayableEvidenceV1" },
+    "kind": { "enum": ["shell", "automation"] },
+    "cwd": { "type": "string", "minLength": 1 },
+    "launcher": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["executable", "version"],
+      "properties": {
+        "executable": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "minLength": 1 }
+      }
+    },
+    "argv": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "automationManifestSha256": { "$ref": "#/$defs/sha256" },
+    "toolVersions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["name", "version"],
+        "properties": {
+          "name": { "type": "string", "minLength": 1 },
+          "version": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "materialInputs": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/idHash" }
+    },
+    "outputArtifacts": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/pathHash" }
+    }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "kind": { "const": "shell" } } },
+      "then": { "required": ["argv"] }
+    },
+    {
+      "if": { "properties": { "kind": { "const": "automation" } } },
+      "then": {
+        "required": ["automationManifestSha256"],
+        "properties": { "outputArtifacts": { "minItems": 1 } }
+      }
+    }
+  ],
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "idHash": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "sha256"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "sha256": { "$ref": "#/$defs/sha256" }
+      }
+    },
+    "pathHash": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "sha256"],
+      "properties": {
+        "path": { "type": "string", "minLength": 1 },
+        "sha256": { "$ref": "#/$defs/sha256" }
+      }
+    }
+  }
+}