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

package/dist/site/schemas/release-tail-capabilities-v1.schema.json

@@ -0,0 +1,353 @@
+{
+  "$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/dist/site/schemas/release-tail-provider-bindings-v1.schema.json

@@ -0,0 +1,94 @@
+{
+  "$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/site-manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "contract": "kungfu-buildchain-site-manifest",
-  "generatedAt": "2026-08-07T01:27:51.160Z",
-  "publishedAt": "2026-08-07T01:27:51.160Z",
+  "generatedAt": "2026-08-10T07:19:05.000Z",
+  "publishedAt": "2026-08-10T07:19:05.000Z",
   "reproducible": true,
   "timestampPolicy": "ci-injected",
   "deterministicInputs": [
@@ -19,7 +19,7 @@
     "declared Buildchain surface manifest contract"
   ],
   "sourceDateEpoch": "0",
-  "sourceRevision": "4d3415855debb03bac01c4f5d11417f0d1ea42d8",
+  "sourceRevision": "3a716b38faa820c16d6f502d89ace41916e9ff87",
   "timestampPolicyDetails": {
     "contract": "kungfu-buildchain-surface-timestamp-policy",
     "timestampFields": [
@@ -37,7 +37,7 @@
   },
   "package": {
     "name": "@kungfu-tech/buildchain",
-    "version": "3.0.6",
+    "version": "3.0.7-alpha.1",
     "versionSource": "package.json#version"
   },
   "entrypoint": "buildchain-site.json",
@@ -53,7 +53,7 @@
       "path": "docs/MAP.md",
       "plane": "use",
       "exists": true,
-      "digest": "sha256:d76416d8cd04dcdb560b7d06fef287fa22d6b186a729cb92cd4cf71cebbac1e9"
+      "digest": "sha256:08cfae94c78776694736e81142e2d64480fdc3e67341b415340c03d3539531e7"
     },
     {
       "id": "getting-started",
@@ -69,7 +69,7 @@
       "path": "docs/auditable-demo.md",
       "plane": "verify",
       "exists": true,
-      "digest": "sha256:c49e734fdfe3b74d317e23a523e198f1194b2c7cd16cca87e8e3a3ffc7bf589f"
+      "digest": "sha256:43989b951667f5dd3bf352209ffe551add4f83d5d551f960aeb787b2220aa665"
     },
     {
       "id": "install",
@@ -229,7 +229,7 @@
       "path": "docs/cli-reference.md",
       "plane": "use",
       "exists": true,
-      "digest": "sha256:2365e125d38e43b68a4af277a91be7aca708a8bf785954ed4589dbd9a5d8db97"
+      "digest": "sha256:3b203848db87e68762417e768eb8a09a7e653eb30fb7cc21354e72678706b714"
     },
     {
       "id": "node-api-reference",
@@ -237,7 +237,7 @@
       "path": "docs/node-api-reference.md",
       "plane": "use",
       "exists": true,
-      "digest": "sha256:f5592359584e98ab4283d56b0262fdcf9c5da61f48033cecad1b0404aa95bd2e"
+      "digest": "sha256:ed843753964193ecb59610a54f0f23d76578228ebe6d31d1d6edce526729910c"
     },
     {
       "id": "build-facts",
@@ -269,7 +269,7 @@
       "path": "docs/lifecycle-protocol.md",
       "plane": "use",
       "exists": true,
-      "digest": "sha256:4b7a8efe1d22751ded069f46a23490db70cda9e9e14641acab600ab781245b19"
+      "digest": "sha256:9fdab92b63eae0085d460a4ec78511fbb63999a311cd7693c669705bd9897eb2"
     },
     {
       "id": "reusable-build-surface",
@@ -277,7 +277,7 @@
       "path": "docs/reusable-build-surface.md",
       "plane": "use",
       "exists": true,
-      "digest": "sha256:7bc04f658d7e298872756278c60143d8edf5dfb841d0b0d3ea62af8028735b54"
+      "digest": "sha256:4741dc7661d40e14df8203d88a709b9becb08edc4313f5ad308c7e80bf672085"
     },
     {
       "id": "publish-transaction",
@@ -287,13 +287,37 @@
       "exists": true,
       "digest": "sha256:72466943bb459f6857f23ac6f92bcf4714dcd2f535c38a9f0e34864b36404e06"
     },
+    {
+      "id": "release-tail-contract",
+      "title": "Declarative release-tail contract",
+      "path": "docs/release-tail-contract.md",
+      "plane": "verify",
+      "exists": true,
+      "digest": "sha256:1cfd927f30d71a359397a7177048b298269a8e665e67237187eb817e5d196b41"
+    },
+    {
+      "id": "release-tail-provider-plane",
+      "title": "Declarative release-tail provider plane",
+      "path": "docs/release-tail-provider-plane.md",
+      "plane": "use",
+      "exists": true,
+      "digest": "sha256:12f291124f51520b4f64c21d7fb249e89928b607a30bc00ba81eb1fc5acea5bd"
+    },
+    {
+      "id": "publication-rehearsal",
+      "title": "Publication rehearsal",
+      "path": "docs/publication-rehearsal.md",
+      "plane": "use",
+      "exists": true,
+      "digest": "sha256:b71c8be4a73078adae6efa838eeded0bfafef90f1e3873aad65d116f2481ae09"
+    },
     {
       "id": "release-governance",
       "title": "Release governance",
       "path": "docs/release-governance.md",
       "plane": "why",
       "exists": true,
-      "digest": "sha256:34fb81d1dd9f913cbed6ee76ac9f0bdb095669e55c1bee67389601fd494470cf"
+      "digest": "sha256:b37d4de1f1cf9155c0e3f42c8c20a0280a263f50173eb0cad2c5f1961954822e"
     },
     {
       "id": "release-flow",