@kungfu-tech/buildchain 4.0.0 → 4.0.1-alpha.10

package/dist/site/schemas/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 }
+          }
+        }
+      }
+    }
+  }
+}

package/dist/site/site-manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "contract": "kungfu-buildchain-site-manifest",
-  "generatedAt": "2026-08-13T09:05:27.306Z",
-  "publishedAt": "2026-08-13T09:05:27.306Z",
+  "generatedAt": "2026-08-22T11:35:38.790Z",
+  "publishedAt": "2026-08-22T11:35:38.790Z",
   "reproducible": true,
   "timestampPolicy": "ci-injected",
   "deterministicInputs": [
@@ -19,7 +19,7 @@
     "declared Buildchain surface manifest contract"
   ],
   "sourceDateEpoch": "0",
-  "sourceRevision": "45a49dcaa0fcef59bc66481a85c39514d08972cc",
+  "sourceRevision": "cd2e0972c4836db2e99b61a18be88b13b1cc605c",
   "timestampPolicyDetails": {
     "contract": "kungfu-buildchain-surface-timestamp-policy",
     "timestampFields": [
@@ -37,7 +37,7 @@
   },
   "package": {
     "name": "@kungfu-tech/buildchain",
-    "version": "4.0.0",
+    "version": "4.0.1-alpha.10",
     "versionSource": "package.json#version"
   },
   "entrypoint": "buildchain-site.json",
@@ -53,7 +53,7 @@
       "path": "docs/MAP.md",
       "plane": "use",
       "exists": true,
-      "digest": "sha256:94a4866f5a44f97ab10ad460c4d9ff39c58aa28e231311425af2fcb857aa8c72"
+      "digest": "sha256:a04d321dbec562807cb29b748039839d097a97d2c9d2f0e76d6d22f2845055ba"
     },
     {
       "id": "getting-started",
@@ -135,6 +135,14 @@
       "exists": true,
       "digest": "sha256:6989ada03d381e68fdec55b26b76b2070fb37969826eadc0a989844a732ba557"
     },
+    {
+      "id": "next-development-transition",
+      "title": "Next-development transition",
+      "path": "docs/next-development-transition.md",
+      "plane": "verify",
+      "exists": true,
+      "digest": "sha256:c33c017ae163650b422f7ec294a05f3db8b8e99b87c55ab2d8ac3cce1726448f"
+    },
     {
       "id": "release-propagation",
       "title": "Release propagation",
@@ -229,7 +237,7 @@
       "path": "docs/cli.md",
       "plane": "use",
       "exists": true,
-      "digest": "sha256:fad47682ed909f7b16f58bb8c24c51a943eb704a0a50ab6e033d745ee16a809a"
+      "digest": "sha256:60208f0862195df44b27ada15e474ff1808dee6d492cd6303402b92fd72f06bc"
     },
     {
       "id": "cli-reference",
@@ -237,7 +245,7 @@
       "path": "docs/cli-reference.md",
       "plane": "use",
       "exists": true,
-      "digest": "sha256:0aa0c937ca4f3f239f67c10a3e656ca0934cd3618bf84639525ea1fbd685c055"
+      "digest": "sha256:ec16f350596692989cf5eade945e7bbeee157a661c6d8faa55c8249b14ef5632"
     },
     {
       "id": "node-api-reference",
@@ -245,7 +253,7 @@
       "path": "docs/node-api-reference.md",
       "plane": "use",
       "exists": true,
-      "digest": "sha256:f8200ba1fbe5779408b4a1e82a0e28a5e8f696b05f97efd2d286d3008755fdbb"
+      "digest": "sha256:da744d2071ab7871eccbf6b3049a4d8a44b21daa477598fa9327a28b7d89ae67"
     },
     {
       "id": "build-facts",
@@ -277,7 +285,7 @@
       "path": "docs/lifecycle-protocol.md",
       "plane": "use",
       "exists": true,
-      "digest": "sha256:4b7a8efe1d22751ded069f46a23490db70cda9e9e14641acab600ab781245b19"
+      "digest": "sha256:edff8787985801d060efe9c924d80ac1689f5f2305d853f645fe877bab34c207"
     },
     {
       "id": "reusable-build-surface",
@@ -285,7 +293,15 @@
       "path": "docs/reusable-build-surface.md",
       "plane": "use",
       "exists": true,
-      "digest": "sha256:54cadd6e2f168ca40d9ed66d2f9848d5d56c9d05759bf0454f5027b1df274796"
+      "digest": "sha256:fc2649d0ae4dc6a08275bc1f2509efd3e9730227eaa8157ef64daf4b9c850264"
+    },
+    {
+      "id": "v4-adopter-delivery",
+      "title": "V4 public adopter delivery",
+      "path": "docs/v4-adopter-delivery.md",
+      "plane": "verify",
+      "exists": true,
+      "digest": "sha256:c74a004657f64d29ba2a47f599223e5ab132daf2881cf0564c85c04b22a69e6e"
     },
     {
       "id": "publish-transaction",
@@ -309,7 +325,7 @@
       "path": "docs/release-tail-provider-plane.md",
       "plane": "use",
       "exists": true,
-      "digest": "sha256:80b39ba4f0a8ed723e2a03e7efff0fee1e891245f7d1bf343edc75011aded801"
+      "digest": "sha256:72dd8231f51003c8a0d6532991b908b39de02deb11300e8c63113cd3a9e5cd8e"
     },
     {
       "id": "release-governance",
@@ -319,6 +335,14 @@
       "exists": true,
       "digest": "sha256:6dfe8a9b974040fc1465b0da696519b4e97b0b901e30d852ffacda0d193810af"
     },
+    {
+      "id": "v4-compatibility-facts",
+      "title": "Buildchain v4 compatibility Facts",
+      "path": "docs/v4-compatibility-facts.md",
+      "plane": "verify",
+      "exists": true,
+      "digest": "sha256:d29c904a17aca0ca3ad4f48a826f530610d77ffca8bde76ef7e5b4c245c2ca47"
+    },
     {
       "id": "release-flow",
       "title": "Release flow",
@@ -333,7 +357,7 @@
       "path": "docs/runtime-train-validation.md",
       "plane": "verify",
       "exists": true,
-      "digest": "sha256:f0a1cdb7fe5f72fc2ed921f1aeadbd16184dda16be3727e4193fa2af250325db"
+      "digest": "sha256:7df1e85785a1bd8d87c22359d63bcd1caf3fc6c4924d04b6802584b189f75a08"
     },
     {
       "id": "versioning",
@@ -341,7 +365,7 @@
       "path": "docs/versioning.md",
       "plane": "why",
       "exists": true,
-      "digest": "sha256:7f6e377abf976e9eb9c5f0fd2baec96922ca44d9ab7dd08178608657fa858978"
+      "digest": "sha256:a2fc36e62ac3adfa0dd499972f22cad22131ccc526e11e890e2cbdc4d3a31341"
     },
     {
       "id": "web-surface-deployments",