@hunter-harness/workflow-harness 0.3.1 → 0.4.1

package/harness/bundles/general/pi/contracts/build-profile-v3.schema.json

@@ -0,0 +1,302 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://hunter-harness.local/contracts/build-profile-v3.schema.json",
+  "title": "Hunter Harness Build Profile v3",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "commands",
+    "verificationInputs",
+    "verificationGraph"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": 3
+    },
+    "commands": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "required": [
+          "command",
+          "argvTemplate",
+          "scope",
+          "inputs",
+          "coverage",
+          "source"
+        ],
+        "properties": {
+          "command": {
+            "type": "string",
+            "minLength": 1
+          },
+          "argvTemplate": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "minItems": 1
+          },
+          "scope": {
+            "type": "string",
+            "minLength": 1
+          },
+          "inputs": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "coverage": {
+            "type": "string",
+            "minLength": 1
+          },
+          "source": {
+            "enum": [
+              "detected",
+              "user"
+            ]
+          }
+        }
+      }
+    },
+    "verificationInputs": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "array",
+        "items": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "verificationGraph": {
+      "type": "object",
+      "required": [
+        "schemaVersion",
+        "source",
+        "candidateTarget",
+        "targets"
+      ],
+      "properties": {
+        "schemaVersion": {
+          "const": 1
+        },
+        "source": {
+          "enum": [
+            "detected",
+            "user"
+          ]
+        },
+        "candidateTarget": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "targets": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "commandKey",
+              "dependsOn",
+              "requiredCoverage",
+              "candidate",
+              "requiredCapabilities"
+            ],
+            "properties": {
+              "id": {
+                "type": "string",
+                "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
+              },
+              "commandKey": {
+                "type": "string",
+                "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
+              },
+              "dependsOn": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
+                },
+                "uniqueItems": true
+              },
+              "requiredCoverage": {
+                "enum": [
+                  "incremental",
+                  "module-am",
+                  "module",
+                  "full"
+                ]
+              },
+              "argvTemplate": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "minItems": 1
+              },
+              "inputs": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "coverage": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "coverageLevel": {
+                "enum": [
+                  "incremental",
+                  "module",
+                  "module-am",
+                  "full"
+                ]
+              },
+              "candidate": {
+                "type": "boolean"
+              },
+              "requiredCapabilities": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "uniqueItems": true
+              },
+              "resourceLocks": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "uniqueItems": true
+              },
+              "estimatedDurationSeconds": {
+                "type": "number",
+                "minimum": 0
+              },
+              "requiresFrozenIdentity": {
+                "type": "boolean"
+              },
+              "reusePolicy": {
+                "enum": [
+                  "never",
+                  "identity-exact",
+                  "ledger-exact"
+                ]
+              }
+            }
+          }
+        }
+      }
+    },
+    "serviceStart": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "healthUrl",
+        "startTimeoutSec",
+        "inputFiles",
+        "source",
+        "profile",
+        "overlayPath"
+      ],
+      "properties": {
+        "argvTemplate": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "command": {
+          "type": "string",
+          "minLength": 1
+        },
+        "healthUrl": {
+          "type": "string"
+        },
+        "healthFile": {
+          "type": "string"
+        },
+        "startTimeoutSec": {
+          "type": "number",
+          "exclusiveMinimum": 0
+        },
+        "inputFiles": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "source": {
+          "enum": [
+            "detected",
+            "user"
+          ]
+        },
+        "profile": {
+          "type": "string"
+        },
+        "overlayPath": {
+          "type": "string"
+        },
+        "legacyWarning": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "reasonCode",
+            "platform",
+            "message"
+          ],
+          "properties": {
+            "reasonCode": {
+              "const": "PROFILE_MIGRATION_UNSAFE"
+            },
+            "platform": {
+              "enum": [
+                "windows",
+                "posix"
+              ]
+            },
+            "message": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        }
+      },
+      "oneOf": [
+        {
+          "required": [
+            "argvTemplate"
+          ],
+          "not": {
+            "required": [
+              "command"
+            ]
+          }
+        },
+        {
+          "required": [
+            "command",
+            "legacyWarning"
+          ],
+          "not": {
+            "required": [
+              "argvTemplate"
+            ]
+          }
+        }
+      ]
+    }
+  }
+}

package/harness/bundles/general/pi/contracts/ci-metrics.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://hunter-harness.dev/contracts/ci-metrics.schema.json",
+  "title": "Hunter Harness CI Metrics",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "runner",
+    "source",
+    "suites",
+    "passed",
+    "failed",
+    "skipped",
+    "setupErrors",
+    "durationMs",
+    "headSha"
+  ],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "runner": { "enum": ["junit", "vitest", "playwright"] },
+    "source": { "type": ["string", "null"] },
+    "suites": { "type": ["integer", "null"], "minimum": 0 },
+    "passed": { "type": ["integer", "null"], "minimum": 0 },
+    "failed": { "type": ["integer", "null"], "minimum": 0 },
+    "skipped": { "type": ["integer", "null"], "minimum": 0 },
+    "setupErrors": { "type": ["integer", "null"], "minimum": 0 },
+    "durationMs": { "type": ["integer", "null"], "minimum": 0 },
+    "headSha": {
+      "anyOf": [
+        { "type": "null" },
+        { "type": "string", "pattern": "^[0-9a-f]{40}([0-9a-f]{24})?$" }
+      ]
+    }
+  }
+}

package/harness/bundles/general/pi/contracts/doctor-capability.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://hunter-harness.local/contracts/doctor-capability.schema.json",
+  "title": "Hunter Harness Capability Probe",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "capability",
+    "status",
+    "reasonCode",
+    "observedAt",
+    "evidence"
+  ],
+  "properties": {
+    "capability": {
+      "type": "string",
+      "minLength": 1
+    },
+    "status": {
+      "enum": [
+        "AVAILABLE",
+        "UNAVAILABLE",
+        "DEGRADED",
+        "UNKNOWN"
+      ]
+    },
+    "reasonCode": {
+      "type": "string",
+      "minLength": 1
+    },
+    "observedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "evidence": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "details": {}
+  }
+}

package/harness/bundles/general/pi/contracts/external-platform-observation.schema.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://hunter-harness.local/contracts/external-platform-observation.schema.json",
+  "title": "Authoritative External Platform Observation",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "subjectIdentity",
+    "businessState",
+    "observationState",
+    "freshness",
+    "retryable",
+    "reasonCode",
+    "observedAt"
+  ],
+  "properties": {
+    "subjectIdentity": {
+      "type": "string",
+      "minLength": 1
+    },
+    "businessState": {
+      "enum": [
+        "PENDING",
+        "RUNNING",
+        "SUCCEEDED",
+        "FAILED",
+        "CANCELLED",
+        "UNKNOWN"
+      ]
+    },
+    "observationState": {
+      "enum": [
+        "PENDING",
+        "TERMINAL",
+        "UNKNOWN"
+      ]
+    },
+    "freshness": {
+      "enum": [
+        "FRESH",
+        "STALE",
+        "UNKNOWN"
+      ]
+    },
+    "retryable": {
+      "type": "boolean"
+    },
+    "reasonCode": {
+      "type": "string",
+      "minLength": 1
+    },
+    "observedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "idempotencyKey": {
+      "type": "string",
+      "minLength": 1
+    },
+    "payload": {}
+  }
+}