@kungfu-tech/buildchain 3.0.6 → 3.0.7-alpha.1

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

@@ -0,0 +1,173 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://buildchain.kungfu.ai/contracts/publication-rehearsal-capsule-v1.schema.json",
+  "title": "Buildchain publication rehearsal capsule",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "contract",
+    "schemaVersion",
+    "root",
+    "declaration",
+    "policyRoots",
+    "passport",
+    "transaction",
+    "files",
+    "providerBindings",
+    "providerObservations",
+    "runtime"
+  ],
+  "properties": {
+    "contract": {
+      "const": "kungfu.buildchain.publication-rehearsal-capsule/v1"
+    },
+    "schemaVersion": { "const": 1 },
+    "root": { "$ref": "#/$defs/root" },
+    "declaration": {
+      "$ref": "release-tail-capabilities-v1.schema.json"
+    },
+    "policyRoots": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/root" }
+    },
+    "passport": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "root"],
+      "properties": {
+        "path": { "$ref": "#/$defs/path" },
+        "root": { "$ref": "#/$defs/root" }
+      }
+    },
+    "transaction": {
+      "type": "object",
+      "required": [
+        "schema",
+        "transactionPolicy",
+        "transactionRoot",
+        "declarationRoot",
+        "planRoot",
+        "subject",
+        "state",
+        "operationOrder",
+        "operations",
+        "observations",
+        "receipts",
+        "failure",
+        "stateRoot"
+      ]
+    },
+    "files": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["role", "path", "size", "root"],
+        "properties": {
+          "role": { "type": "string", "minLength": 1 },
+          "path": { "$ref": "#/$defs/path" },
+          "size": { "type": "integer", "minimum": 0 },
+          "root": { "$ref": "#/$defs/root" }
+        }
+      }
+    },
+    "providerBindings": {
+      "$ref": "release-tail-provider-bindings-v1.schema.json"
+    },
+    "providerObservations": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["operationId", "readbacks", "apply"],
+        "properties": {
+          "operationId": { "$ref": "#/$defs/root" },
+          "readbacks": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "$ref": "#/$defs/observation" }
+          },
+          "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 }
+            }
+          }
+        }
+      }
+    },
+    "runtime": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["platform", "declaredEnvironment", "externalEffects"],
+      "properties": {
+        "platform": { "const": "portable" },
+        "declaredEnvironment": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]*$" }
+        },
+        "externalEffects": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["capabilityId", "adapter", "kind"],
+            "properties": {
+              "capabilityId": { "type": "string", "minLength": 1 },
+              "adapter": { "type": "string", "minLength": 1 },
+              "kind": { "type": "string", "minLength": 1 }
+            }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "root": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    },
+    "path": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*//)(?!.*\\\\).+$"
+    },
+    "observation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "outcome",
+        "subjectRoot",
+        "targetRoot",
+        "evidenceRoots",
+        "providerCode"
+      ],
+      "properties": {
+        "outcome": {
+          "enum": ["observed", "absent", "transient", "conflict"]
+        },
+        "subjectRoot": {
+          "anyOf": [{ "$ref": "#/$defs/root" }, { "const": "" }]
+        },
+        "targetRoot": {
+          "anyOf": [{ "$ref": "#/$defs/root" }, { "const": "" }]
+        },
+        "evidenceRoots": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/root" }
+        },
+        "providerCode": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}

package/contracts/release-tail-capabilities-v1.schema.json

@@ -0,0 +1,199 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://buildchain.kungfu.ai/contracts/release-tail-capabilities-v1.schema.json",
+  "title": "Buildchain release-tail capability declaration",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "contract",
+    "schemaVersion",
+    "transactionPolicy",
+    "subject",
+    "capabilities"
+  ],
+  "properties": {
+    "contract": {
+      "const": "kungfu-buildchain-release-tail-capabilities"
+    },
+    "schemaVersion": {
+      "const": 1
+    },
+    "transactionPolicy": {
+      "const": "buildchain.release-tail/v1"
+    },
+    "subject": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["repository", "sourceSha", "version", "tag", "channel"],
+      "properties": {
+        "repository": { "type": "string", "minLength": 1 },
+        "sourceSha": { "type": "string", "pattern": "^[0-9a-f]{40}$" },
+        "version": { "type": "string", "minLength": 1 },
+        "tag": { "type": "string", "minLength": 1 },
+        "channel": { "enum": ["alpha", "release", "stable"] }
+      }
+    },
+    "capabilities": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/capability" }
+    }
+  },
+  "$defs": {
+    "root": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    },
+    "capability": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "executor",
+        "adapter",
+        "artifactRoles",
+        "destination",
+        "channelPolicy",
+        "activationPolicy",
+        "readbackPredicates",
+        "effect",
+        "observation",
+        "receipt",
+        "operationIdentity",
+        "idempotency",
+        "retry",
+        "evidenceRequirements"
+      ],
+      "properties": {
+        "id": {
+          "enum": [
+            "artifact.publish",
+            "signed-channel.commit",
+            "release.activate",
+            "released-evidence.synthesize"
+          ]
+        },
+        "executor": { "enum": ["buildchain-core", "provider-adapter"] },
+        "adapter": { "type": "string", "minLength": 1 },
+        "artifactRoles": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["role", "root"],
+            "properties": {
+              "role": { "type": "string", "minLength": 1 },
+              "root": { "$ref": "#/$defs/root" }
+            }
+          }
+        },
+        "destination": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "locator"],
+          "properties": {
+            "kind": { "type": "string", "minLength": 1 },
+            "locator": { "type": "string", "minLength": 1 }
+          }
+        },
+        "channelPolicy": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["channel", "tagPattern", "authorityMove"],
+          "properties": {
+            "channel": { "enum": ["alpha", "release", "stable"] },
+            "tagPattern": { "type": "string", "minLength": 1 },
+            "authorityMove": { "enum": ["none", "signed-cas", "verified-ref"] }
+          }
+        },
+        "activationPolicy": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["mode", "environment"],
+          "properties": {
+            "mode": { "enum": ["none", "receipt-set", "receipt-only"] },
+            "environment": { "enum": ["none", "shadow", "production"] }
+          }
+        },
+        "readbackPredicates": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "kind", "expected"],
+            "properties": {
+              "id": { "type": "string", "minLength": 1 },
+              "kind": { "type": "string", "minLength": 1 },
+              "expected": { "type": "string", "minLength": 1 }
+            }
+          }
+        },
+        "effect": { "$ref": "#/$defs/message" },
+        "observation": { "$ref": "#/$defs/message" },
+        "receipt": { "$ref": "#/$defs/message" },
+        "operationIdentity": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "transactionRoot",
+            "capabilityId",
+            "subjectRoot",
+            "targetRoot",
+            "attemptKey"
+          ],
+          "properties": {
+            "transactionRoot": { "$ref": "#/$defs/root" },
+            "capabilityId": {
+              "enum": [
+                "artifact.publish",
+                "signed-channel.commit",
+                "release.activate",
+                "released-evidence.synthesize"
+              ]
+            },
+            "subjectRoot": { "$ref": "#/$defs/root" },
+            "targetRoot": { "$ref": "#/$defs/root" },
+            "attemptKey": { "type": "string", "minLength": 1 }
+          }
+        },
+        "idempotency": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["scope", "duplicate"],
+          "properties": {
+            "scope": { "enum": ["operation", "subject-target"] },
+            "duplicate": {
+              "enum": ["return-observed-receipt", "readback-before-retry"]
+            }
+          }
+        },
+        "retry": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["class", "localAttempts", "exhausted"],
+          "properties": {
+            "class": { "enum": ["never", "readback", "provider-transient"] },
+            "localAttempts": { "type": "integer", "minimum": 0, "maximum": 3 },
+            "exhausted": {
+              "enum": ["blocked", "repair-required", "terminal-failure"]
+            }
+          }
+        },
+        "evidenceRequirements": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "message": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "schema"],
+      "properties": {
+        "kind": { "type": "string", "minLength": 1 },
+        "schema": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}

package/contracts/release-tail-provider-bindings-v1.schema.json

@@ -0,0 +1,56 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://buildchain.kungfu.ai/contracts/release-tail-provider-bindings-v1.schema.json",
+  "title": "Buildchain release-tail provider bindings",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema", "artifacts", "documents", "evidence"],
+  "properties": {
+    "schema": {
+      "const": "kungfu.buildchain.release-tail.provider-bindings/v1"
+    },
+    "artifacts": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path", "name"],
+        "properties": {
+          "path": { "type": "string", "minLength": 1 },
+          "name": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "documents": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "signed-channel.commit": { "$ref": "#/$defs/document" },
+        "release.activate": { "$ref": "#/$defs/document" }
+      }
+    },
+    "evidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["inputs", "output"],
+      "properties": {
+        "inputs": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "output": { "type": "string", "minLength": 1 }
+      }
+    }
+  },
+  "$defs": {
+    "document": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "method"],
+      "properties": {
+        "path": { "type": "string", "minLength": 1 },
+        "method": { "enum": ["PUT", "POST"] }
+      }
+    }
+  }
+}

package/dist/site/agent-index.json

@@ -17,6 +17,9 @@
     "artifact-schemas.json",
     "release-passport-check-manifest.json",
     "schemas/release-passport-v1.schema.json",
+    "schemas/publication-rehearsal-capsule-v1.schema.json",
+    "schemas/release-tail-capabilities-v1.schema.json",
+    "schemas/release-tail-provider-bindings-v1.schema.json",
     "schemas/kfd-agent-hub-adoption.schema.json",
     "schemas/kfd-product-gate-input-v1.schema.json",
     "schemas/kfd-support-projection-v1.schema.json",

package/dist/site/artifact-schemas.json

@@ -5,6 +5,9 @@
     "buildchain.release.json",
     "release-passport-check-manifest.json",
     "schemas/release-passport-v1.schema.json",
+    "schemas/publication-rehearsal-capsule-v1.schema.json",
+    "schemas/release-tail-capabilities-v1.schema.json",
+    "schemas/release-tail-provider-bindings-v1.schema.json",
     "schemas/kfd-agent-hub-adoption.schema.json",
     "schemas/kfd-product-gate-input-v1.schema.json",
     "schemas/kfd-support-projection-v1.schema.json",
@@ -40,6 +43,9 @@
     "artifact-schemas.json",
     "release-passport-check-manifest.json",
     "schemas/release-passport-v1.schema.json",
+    "schemas/publication-rehearsal-capsule-v1.schema.json",
+    "schemas/release-tail-capabilities-v1.schema.json",
+    "schemas/release-tail-provider-bindings-v1.schema.json",
     "schemas/kfd-agent-hub-adoption.schema.json",
     "schemas/kfd-product-gate-input-v1.schema.json",
     "schemas/kfd-support-projection-v1.schema.json",