@kungfu-tech/buildchain 4.0.1-alpha.2 → 4.0.1-alpha.21

package/contracts/v4-adopter-delivery-v1.schema.json

@@ -0,0 +1,81 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://buildchain.kungfu-tech.com/schemas/v4-adopter-delivery-v1.schema.json",
+  "title": "Buildchain v4 adopter delivery gate input",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "contract",
+    "driverSelector",
+    "artifactProfileSelector",
+    "request",
+    "context"
+  ],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "contract": { "const": "kungfu-buildchain-v4-adopter-delivery/v1" },
+    "driverSelector": {
+      "enum": ["json-assertion", "kfd-category", "legacy-kfd"]
+    },
+    "artifactProfileSelector": { "enum": ["git-commit", "package"] },
+    "request": { "$ref": "#/$defs/request" },
+    "context": { "type": "object" }
+  },
+  "$defs": {
+    "reference": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "version"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9.-]*(/[a-z][a-z0-9.-]*)*$"
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^[1-9][0-9]*\\.[0-9]+\\.[0-9]+$"
+        }
+      }
+    },
+    "request": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion",
+        "contract",
+        "protocol",
+        "artifactProfile",
+        "project",
+        "artifact",
+        "declaration"
+      ],
+      "properties": {
+        "schemaVersion": { "const": 1 },
+        "contract": { "const": "kungfu-buildchain-adopter-delivery-request" },
+        "protocol": { "$ref": "#/$defs/reference" },
+        "artifactProfile": { "$ref": "#/$defs/reference" },
+        "project": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["instanceId", "adopterId"],
+          "properties": {
+            "instanceId": { "type": "string", "minLength": 1 },
+            "adopterId": { "type": "string", "minLength": 1 }
+          }
+        },
+        "artifact": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "coordinate", "root"],
+          "properties": {
+            "kind": { "type": "string", "minLength": 1 },
+            "coordinate": { "type": "string", "minLength": 1 },
+            "root": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
+          }
+        },
+        "declaration": { "type": "object" }
+      }
+    }
+  }
+}

package/contracts/v4-compatibility-facts-v1.schema.json

@@ -0,0 +1,230 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://buildchain.libkungfu.dev/schemas/v4-compatibility-facts-v1.schema.json",
+  "title": "Buildchain v4 compatibility Facts",
+  "description": "Closed public shapes for directional, Cut-bound compatibility Facts, explicit path queries, and rooted receipts.",
+  "oneOf": [
+    { "$ref": "#/$defs/fact" },
+    { "$ref": "#/$defs/registry" },
+    { "$ref": "#/$defs/query" },
+    { "$ref": "#/$defs/receiptEntry" }
+  ],
+  "$defs": {
+    "root": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    },
+    "entry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["root", "record"],
+      "properties": {
+        "root": { "$ref": "#/$defs/root" },
+        "record": { "type": "object" }
+      }
+    },
+    "proof": {
+      "type": "object",
+      "required": [
+        "schema",
+        "proofId",
+        "predicate",
+        "direction",
+        "operation",
+        "source",
+        "target",
+        "scope",
+        "scopeRoot",
+        "evidence",
+        "evidenceRoot",
+        "authority",
+        "authorityRoot",
+        "cut",
+        "cutRoot",
+        "proofRoot"
+      ],
+      "properties": {
+        "schema": { "const": "kungfu.buildchain.compatibility-proof/v1" },
+        "proofId": { "type": "string", "minLength": 1 },
+        "predicate": { "const": "compatible-breaking-digest" },
+        "direction": { "const": "source-to-target" },
+        "operation": { "const": "accept-contract-lock" },
+        "source": { "type": "object" },
+        "target": { "type": "object" },
+        "scope": { "type": "object" },
+        "scopeRoot": { "$ref": "#/$defs/root" },
+        "evidence": { "type": "object" },
+        "evidenceRoot": { "$ref": "#/$defs/root" },
+        "authority": { "type": "object" },
+        "authorityRoot": { "$ref": "#/$defs/root" },
+        "cut": { "type": "object" },
+        "cutRoot": { "$ref": "#/$defs/root" },
+        "proofRoot": { "$ref": "#/$defs/root" }
+      }
+    },
+    "fact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema",
+        "factId",
+        "factRoot",
+        "sourceRoot",
+        "targetRoot",
+        "predicate",
+        "relation",
+        "proof"
+      ],
+      "properties": {
+        "schema": { "const": "kungfu.buildchain.compatibility-fact/v1" },
+        "factId": { "type": "string", "minLength": 1 },
+        "factRoot": { "$ref": "#/$defs/root" },
+        "sourceRoot": { "$ref": "#/$defs/root" },
+        "targetRoot": { "$ref": "#/$defs/root" },
+        "predicate": { "$ref": "#/$defs/entry" },
+        "relation": { "$ref": "#/$defs/entry" },
+        "proof": { "$ref": "#/$defs/proof" }
+      }
+    },
+    "registry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema",
+        "rootProtocol",
+        "currentCutRoot",
+        "predicateRoots",
+        "factRoots",
+        "supersessionRoots",
+        "revocationRoots",
+        "legacyProofRoots",
+        "temporalBundleRoot",
+        "facts",
+        "legacyProofs",
+        "currentCut",
+        "temporalBundle",
+        "registryRoot"
+      ],
+      "properties": {
+        "schema": {
+          "const": "kungfu.buildchain.compatibility-fact-registry/v1"
+        },
+        "rootProtocol": { "const": "kungfu.fact-root.canonical/v2" },
+        "currentCutRoot": { "$ref": "#/$defs/root" },
+        "predicateRoots": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/root" },
+          "uniqueItems": true
+        },
+        "factRoots": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/root" },
+          "uniqueItems": true
+        },
+        "supersessionRoots": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/root" },
+          "uniqueItems": true
+        },
+        "revocationRoots": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/root" },
+          "uniqueItems": true
+        },
+        "legacyProofRoots": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/root" },
+          "uniqueItems": true
+        },
+        "temporalBundleRoot": { "$ref": "#/$defs/root" },
+        "facts": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/fact" },
+          "minItems": 1
+        },
+        "legacyProofs": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/proof" }
+        },
+        "currentCut": { "type": "object" },
+        "temporalBundle": { "type": "object" },
+        "registryRoot": { "$ref": "#/$defs/root" }
+      }
+    },
+    "query": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema",
+        "queryId",
+        "operation",
+        "predicateRoot",
+        "sourceRoot",
+        "targetRoot",
+        "cutRoot",
+        "relationPathRoots",
+        "requiredAuthorityRoot",
+        "maxDepth"
+      ],
+      "properties": {
+        "schema": { "const": "kungfu.fact.temporal-path-query/v1" },
+        "queryId": { "type": "string", "minLength": 1 },
+        "operation": { "const": "accept-contract-lock" },
+        "predicateRoot": { "$ref": "#/$defs/root" },
+        "sourceRoot": { "$ref": "#/$defs/root" },
+        "targetRoot": { "$ref": "#/$defs/root" },
+        "cutRoot": { "$ref": "#/$defs/root" },
+        "relationPathRoots": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/root" },
+          "uniqueItems": true
+        },
+        "requiredAuthorityRoot": { "$ref": "#/$defs/root" },
+        "maxDepth": { "type": "integer", "minimum": 1, "maximum": 32 }
+      }
+    },
+    "receiptEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["root", "record"],
+      "properties": {
+        "root": { "$ref": "#/$defs/root" },
+        "record": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "schema",
+            "queryRoot",
+            "status",
+            "failureCode",
+            "cutRoot",
+            "relationPathRoots",
+            "authorityProofRoots",
+            "omissionRoots"
+          ],
+          "properties": {
+            "schema": { "const": "kungfu.fact.temporal-path-receipt/v1" },
+            "queryRoot": { "$ref": "#/$defs/root" },
+            "status": { "enum": ["accepted", "rejected"] },
+            "failureCode": { "type": "string" },
+            "cutRoot": { "$ref": "#/$defs/root" },
+            "relationPathRoots": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/root" }
+            },
+            "authorityProofRoots": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/root" },
+              "uniqueItems": true
+            },
+            "omissionRoots": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/root" },
+              "uniqueItems": true
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/contracts/v4-floating-consumer-policy-receipt-v1.schema.json

@@ -47,8 +47,10 @@
         },
         "sourcePath": { "type": "string" },
         "sourceLine": { "type": "integer", "minimum": 0 },
-        "visibleSelector": { "enum": ["", "v4", "v4-alpha"] },
-        "selectorClass": { "enum": ["", "floating", "rejected"] },
+        "visibleSelector": { "enum": ["", "v4", "v4-alpha", "alpha/v4/v4.0"] },
+        "selectorClass": {
+          "enum": ["", "floating", "protected-bootstrap", "rejected"]
+        },
         "channel": { "enum": ["", "stable", "alpha"] },
         "resolvedWorkflowSha": {
           "type": "string",

package/contracts/v4-publication-rehearsal-capsule-v1.schema.json

@@ -0,0 +1,233 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://buildchain.kungfu.ai/contracts/v4-publication-rehearsal-capsule-v1.schema.json",
+  "title": "Buildchain v4 Publication Rehearsal Capsule",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "coreVersion",
+    "source",
+    "candidate",
+    "manifest",
+    "config",
+    "providerBindings",
+    "providerBindingsRoot",
+    "providerPolicy",
+    "expectedObservations",
+    "declaration",
+    "transaction",
+    "files",
+    "capsuleRoot"
+  ],
+  "properties": {
+    "schema": { "const": "buildchain-v4-publication-rehearsal-capsule/v1" },
+    "coreVersion": { "const": "buildchain.release-tail/v1" },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["repository", "revision", "root"],
+      "properties": {
+        "repository": { "type": "string", "minLength": 1 },
+        "revision": { "type": "string", "pattern": "^[0-9a-f]{40}$" },
+        "root": { "$ref": "#/$defs/root" }
+      }
+    },
+    "candidate": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["root"],
+      "properties": { "root": { "$ref": "#/$defs/root" } }
+    },
+    "manifest": { "$ref": "#/$defs/fileBinding" },
+    "config": { "$ref": "#/$defs/fileBinding" },
+    "providerBindings": { "$ref": "#/$defs/providerBindings" },
+    "providerBindingsRoot": { "$ref": "#/$defs/root" },
+    "providerPolicy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema",
+        "effectDefault",
+        "allowedCapabilityIds",
+        "allowedAdapters",
+        "root"
+      ],
+      "properties": {
+        "schema": {
+          "const": "buildchain-v4-publication-rehearsal-provider-policy/v1"
+        },
+        "effectDefault": { "const": "disabled" },
+        "allowedCapabilityIds": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "allowedAdapters": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)*$"
+          }
+        },
+        "root": { "$ref": "#/$defs/root" }
+      }
+    },
+    "expectedObservations": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["entries", "root"],
+      "properties": {
+        "entries": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/observationSequence" }
+        },
+        "root": { "$ref": "#/$defs/root" }
+      }
+    },
+    "declaration": { "$ref": "release-tail-capabilities-v1.schema.json" },
+    "transaction": { "type": "object" },
+    "files": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["role", "path", "size", "root"],
+        "properties": {
+          "role": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)*$"
+          },
+          "path": { "$ref": "#/$defs/path" },
+          "size": { "type": "integer", "minimum": 0 },
+          "root": { "$ref": "#/$defs/root" }
+        }
+      }
+    },
+    "capsuleRoot": { "$ref": "#/$defs/root" }
+  },
+  "$defs": {
+    "root": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "path": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^(?!/)(?!.*(?:^|/)\\.(?:/|$))(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*//)(?!.*\\\\)(?!.*\/$).+$"
+    },
+    "providerBindings": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schema", "artifacts", "documents", "evidence"],
+      "properties": {
+        "schema": {
+          "const": "kungfu.buildchain.release-tail.provider-bindings/v1"
+        },
+        "artifacts": {
+          "type": "object",
+          "propertyNames": {
+            "pattern": "^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)*$"
+          },
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["path", "name"],
+            "properties": {
+              "path": { "$ref": "#/$defs/path" },
+              "name": { "type": "string", "minLength": 1 }
+            }
+          }
+        },
+        "documents": {
+          "type": "object",
+          "propertyNames": {
+            "pattern": "^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)*$"
+          },
+          "additionalProperties": { "$ref": "#/$defs/providerDocument" }
+        },
+        "evidence": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["inputs", "output"],
+          "properties": {
+            "inputs": {
+              "type": "array",
+              "uniqueItems": true,
+              "items": { "$ref": "#/$defs/path" }
+            },
+            "output": { "$ref": "#/$defs/path" }
+          }
+        }
+      }
+    },
+    "providerDocument": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "method"],
+      "properties": {
+        "path": { "$ref": "#/$defs/path" },
+        "method": { "enum": ["PUT", "POST"] }
+      }
+    },
+    "fileBinding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "root"],
+      "properties": {
+        "path": { "$ref": "#/$defs/path" },
+        "root": { "$ref": "#/$defs/root" }
+      }
+    },
+    "readback": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "outcome",
+        "subjectRoot",
+        "targetRoot",
+        "evidenceRoots",
+        "providerCode"
+      ],
+      "properties": {
+        "outcome": { "enum": ["observed", "absent", "transient", "conflict"] },
+        "subjectRoot": {
+          "oneOf": [{ "$ref": "#/$defs/root" }, { "const": "" }]
+        },
+        "targetRoot": {
+          "oneOf": [{ "$ref": "#/$defs/root" }, { "const": "" }]
+        },
+        "evidenceRoots": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/root" }
+        },
+        "providerCode": { "type": "string", "minLength": 1 }
+      }
+    },
+    "observationSequence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["operationId", "readbacks", "apply"],
+      "properties": {
+        "operationId": { "$ref": "#/$defs/root" },
+        "readbacks": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/$defs/readback" }
+        },
+        "apply": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["outcome", "code", "classification"],
+          "properties": {
+            "outcome": { "enum": ["applied", "transient", "conflict"] },
+            "code": { "type": "string", "minLength": 1 },
+            "classification": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    }
+  }
+}