owlrunkit 0.13.0

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

@@ -0,0 +1,150 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/verification-plan-v1.json",
+  "title": "OwlCoda RunKit Verification Plan V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "runId",
+    "planId",
+    "status",
+    "drift",
+    "profileImpact",
+    "evidence",
+    "commands",
+    "acceptance",
+    "authorizationGranted",
+    "verificationContextFingerprint"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitVerificationPlanV1" },
+    "runId": { "type": "string", "minLength": 1 },
+    "planId": { "type": "string", "minLength": 1 },
+    "status": {
+      "enum": [
+        "full_profile_required",
+        "blocked_by_global_gate",
+        "verification_mapping_required",
+        "verification_required",
+        "ready_to_finalize"
+      ]
+    },
+    "verificationContextFingerprint": { "$ref": "#/$defs/sha256" },
+    "drift": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "leasedSourceDrift",
+        "declaredDependencyDrift",
+        "unrelatedDirtyTreeDrift",
+        "globalGateFailures"
+      ],
+      "properties": {
+        "leasedSourceDrift": { "$ref": "#/$defs/stringArray" },
+        "declaredDependencyDrift": { "$ref": "#/$defs/stringArray" },
+        "unrelatedDirtyTreeDrift": { "$ref": "#/$defs/stringArray" },
+        "globalGateFailures": { "$ref": "#/$defs/stringArray" }
+      }
+    },
+    "profileImpact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "decision",
+        "primaryProfileId",
+        "directProfileIds",
+        "transitiveProfileIds",
+        "supportingProfileIds",
+        "selectedProfileIds",
+        "uncoveredPaths",
+        "warnings"
+      ],
+      "properties": {
+        "decision": { "enum": ["targeted_profiles", "full_profile_required"] },
+        "primaryProfileId": { "type": ["string", "null"] },
+        "directProfileIds": { "$ref": "#/$defs/stringArray" },
+        "transitiveProfileIds": { "$ref": "#/$defs/stringArray" },
+        "supportingProfileIds": { "$ref": "#/$defs/stringArray" },
+        "selectedProfileIds": { "$ref": "#/$defs/stringArray" },
+        "uncoveredPaths": { "$ref": "#/$defs/stringArray" },
+        "warnings": { "$ref": "#/$defs/stringArray" }
+      }
+    },
+    "evidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["reusableReceiptIds", "invalidatedReceipts"],
+      "properties": {
+        "coverageIndexPath": { "type": "string", "minLength": 1 },
+        "coverageIndexSha256": { "$ref": "#/$defs/sha256" },
+        "reusableReceiptIds": { "$ref": "#/$defs/stringArray" },
+        "invalidatedReceipts": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["receiptId", "reasons"],
+            "properties": {
+              "receiptId": { "type": "string", "minLength": 1 },
+              "reasons": { "$ref": "#/$defs/stringArray" }
+            }
+          }
+        }
+      }
+    },
+    "commands": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "requiredCommandIds",
+        "reusedCommandIds",
+        "pendingCommandIds",
+        "unmappedProfileIds",
+        "pendingCommands"
+      ],
+      "properties": {
+        "requiredCommandIds": { "$ref": "#/$defs/stringArray" },
+        "reusedCommandIds": { "$ref": "#/$defs/stringArray" },
+        "pendingCommandIds": { "$ref": "#/$defs/stringArray" },
+        "unmappedProfileIds": { "$ref": "#/$defs/stringArray" },
+        "pendingCommands": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "cwd", "executable", "argv", "profileIds"],
+            "properties": {
+              "id": { "type": "string", "minLength": 1 },
+              "cwd": { "type": "string", "minLength": 1 },
+              "executable": { "type": "string", "minLength": 1 },
+              "argv": {
+                "type": "array",
+                "items": { "type": "string", "minLength": 1 }
+              },
+              "profileIds": { "$ref": "#/$defs/stringArray" }
+            }
+          }
+        }
+      }
+    },
+    "acceptance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["blocked", "reasons"],
+      "properties": {
+        "blocked": { "type": "boolean" },
+        "reasons": { "$ref": "#/$defs/stringArray" }
+      }
+    },
+    "authorizationGranted": { "const": false }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "stringArray": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 },
+      "uniqueItems": true
+    }
+  }
+}

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

@@ -0,0 +1,118 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/verification-receipt-v2.json",
+  "title": "OwlCoda RunKit Verification Receipt V2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "runId", "receiptId", "status", "sourceFingerprint", "verificationContextFingerprint", "selectedProfileIds", "commandRuns", "commandReceipts"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitVerificationReceiptV2" },
+    "runId": { "type": "string", "minLength": 1 },
+    "receiptId": { "type": "string", "minLength": 1 },
+    "status": { "enum": ["passed", "ready_for_verification", "shadow_validated", "invalidated_by_concurrent_write"] },
+    "sourceFingerprint": { "$ref": "#/$defs/sha256" },
+    "verificationContextFingerprint": { "$ref": "#/$defs/sha256" },
+    "goalContractSha256": { "$ref": "#/$defs/sha256" },
+    "risk": { "$ref": "#/$defs/risk" },
+    "selectedProfileIds": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 },
+      "uniqueItems": true
+    },
+    "commandRuns": { "type": "integer", "minimum": 0 },
+    "supersedesReceiptSha256": { "$ref": "#/$defs/sha256" },
+    "commandReceipts": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/commandReceipt" }
+    },
+    "repairControl": {
+      "$ref": "#/$defs/repairControl"
+    }
+  },
+  "allOf": [
+    {
+      "if": { "required": ["supersedesReceiptSha256"] },
+      "then": {
+        "required": ["repairControl", "goalContractSha256", "risk"]
+      }
+    },
+    {
+      "if": { "required": ["repairControl"] },
+      "then": {
+        "required": ["supersedesReceiptSha256", "goalContractSha256", "risk"]
+      }
+    }
+  ],
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "commandReceipt": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "evidence", "exitCode", "stdoutSha256", "stderrSha256"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "evidence": { "$ref": "replayable-evidence-v1.schema.json" },
+        "exitCode": { "type": "integer" },
+        "stdoutSha256": { "$ref": "#/$defs/sha256" },
+        "stderrSha256": { "$ref": "#/$defs/sha256" }
+      }
+    },
+    "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/verify-plan-request-v1.schema.json

@@ -0,0 +1,56 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/verify-plan-request-v1.json",
+  "title": "OwlCoda RunKit Verify Plan Request V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "planId",
+    "deliveryPacketPath",
+    "statusMode",
+    "dependencies",
+    "verificationContext",
+    "coverageIndexPath",
+    "coverageIndexSha256",
+    "globalGates"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitVerifyPlanRequestV1" },
+    "planId": { "type": "string", "minLength": 1 },
+    "deliveryPacketPath": { "type": "string", "minLength": 1 },
+    "statusMode": { "const": "porcelain-v1-z-untracked-all-runkit-excluded" },
+    "dependencies": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "path", "baselineSha256"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "path": { "type": "string", "minLength": 1 },
+          "baselineSha256": { "$ref": "#/$defs/sha256" }
+        }
+      }
+    },
+    "verificationContext": { "$ref": "verification-context-v1.schema.json" },
+    "coverageIndexPath": { "type": "string", "minLength": 1 },
+    "coverageIndexSha256": { "$ref": "#/$defs/sha256" },
+    "globalGates": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "status"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "status": { "enum": ["passed", "failed"] },
+          "reason": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+  }
+}

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

@@ -0,0 +1,64 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/visual-smoke-request-v1.json",
+  "title": "OwlCoda RunKit Visual Smoke Request V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "smokeId", "mode", "targetRoot", "cwd", "executable", "argv", "launcherVersion", "toolVersions", "selectedPaths", "statusMode", "verificationContext", "resultPath", "automationManifest"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitVisualSmokeRequestV1" },
+    "smokeId": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$" },
+    "mode": { "enum": ["project", "foreign_readonly"] },
+    "targetRoot": { "type": "string", "minLength": 1 },
+    "cwd": { "type": "string", "minLength": 1 },
+    "executable": { "type": "string", "minLength": 1 },
+    "argv": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+    "launcherVersion": { "type": "string", "minLength": 1 },
+    "toolVersions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["name", "version"],
+        "properties": {
+          "name": { "type": "string", "minLength": 1 },
+          "version": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "selectedPaths": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+    "statusMode": { "const": "porcelain-v1-z-untracked-all-runkit-excluded" },
+    "verificationContext": { "$ref": "verification-context-v1.schema.json" },
+    "resultPath": { "type": "string", "minLength": 1 },
+    "automationManifest": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "surface", "viewport", "assertionIds", "consolePolicy", "externalNavigationPolicy"],
+      "properties": {
+        "schemaVersion": { "const": "OwlCodaRunKitVisualAutomationManifestV1" },
+        "surface": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$" },
+        "viewport": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["width", "height"],
+          "properties": {
+            "width": { "type": "integer", "minimum": 1 },
+            "height": { "type": "integer", "minimum": 1 }
+          }
+        },
+        "assertionIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$" } },
+        "consolePolicy": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["maxErrors", "maxWarnings", "maxExceptions"],
+          "properties": {
+            "maxErrors": { "type": "integer", "minimum": 0 },
+            "maxWarnings": { "type": "integer", "minimum": 0 },
+            "maxExceptions": { "type": "integer", "minimum": 0 }
+          }
+        },
+        "externalNavigationPolicy": { "const": "deny" }
+      }
+    }
+  }
+}

package/scripts/runkit-contract/schemas/visual-smoke-result-v1.schema.json

@@ -0,0 +1,68 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/visual-smoke-result-v1.json",
+  "title": "OwlCoda RunKit Visual Smoke Result V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "status", "viewport", "assertions", "console", "navigations", "outputArtifacts"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitVisualSmokeResultV1" },
+    "status": { "enum": ["passed", "failed"] },
+    "viewport": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["width", "height"],
+      "properties": {
+        "width": { "type": "integer", "minimum": 1 },
+        "height": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "assertions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "passed"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "passed": { "type": "boolean" }
+        }
+      }
+    },
+    "console": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["errors", "warnings", "exceptions"],
+      "properties": {
+        "errors": { "type": "integer", "minimum": 0 },
+        "warnings": { "type": "integer", "minimum": 0 },
+        "exceptions": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "navigations": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["protocol", "external"],
+        "properties": {
+          "protocol": { "type": "string", "minLength": 1 },
+          "external": { "type": "boolean" }
+        }
+      }
+    },
+    "outputArtifacts": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path", "mediaType"],
+        "properties": {
+          "path": { "type": "string", "minLength": 1 },
+          "mediaType": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  }
+}