@kungfu-tech/buildchain 4.0.1-alpha.4 → 4.0.1-alpha.5

package/dist/site/public-surface-audit.json

@@ -3,11 +3,11 @@
   "contract": "kungfu-buildchain-public-surface-reverse-audit",
   "status": "passed",
   "summary": {
-    "cliCommandCount": 114,
-    "workflowCount": 71,
+    "cliCommandCount": 116,
+    "workflowCount": 72,
     "actionCount": 7,
-    "sitePageCount": 77,
-    "docCommandRefCount": 987,
+    "sitePageCount": 80,
+    "docCommandRefCount": 1025,
     "failureCount": 0
   },
   "enumerated": {
@@ -362,6 +362,11 @@
         "source": "bin/buildchain.mjs",
         "usage": "buildchain mark --event <name> [--phase <phase>] [--component <name>]"
       },
+      {
+        "id": "next-development",
+        "source": "bin/buildchain.mjs",
+        "usage": "buildchain next-development materialize --input <request.json> [--cwd <dir>]"
+      },
       {
         "id": "npm",
         "source": "bin/buildchain.mjs",
@@ -522,6 +527,11 @@
         "source": "bin/buildchain.mjs",
         "usage": "buildchain span --event <name> [--phase <phase>] [--component <name>]"
       },
+      {
+        "id": "tail-reseal",
+        "source": "bin/buildchain.mjs",
+        "usage": "buildchain tail-reseal plan --request <request.json> [--output <plan.json>]"
+      },
       {
         "id": "transaction-inspect",
         "source": "bin/buildchain.mjs",
@@ -2910,6 +2920,28 @@
         "outputs": [],
         "outputCount": 0
       },
+      {
+        "id": "v4-tail-reseal",
+        "path": ".github/workflows/v4-tail-reseal.yml",
+        "reusable": true,
+        "inputs": [
+          "artifact-retention-days",
+          "consumer-policy-receipt-json",
+          "macos-finalization-command",
+          "request-json"
+        ],
+        "inputCount": 4,
+        "secrets": [
+          "BUILDCHAIN_EVIDENCE_READ_TOKEN",
+          "BUILDCHAIN_SIGNING_TOKEN"
+        ],
+        "secretCount": 2,
+        "outputs": [
+          "release-candidate-passport-json",
+          "tail-reseal-receipt-root"
+        ],
+        "outputCount": 2
+      },
       {
         "id": "verify",
         "path": ".github/workflows/verify.yml",
@@ -3345,6 +3377,10 @@
         "id": "manual:migration-inventory",
         "category": "manual"
       },
+      {
+        "id": "manual:next-development-transition",
+        "category": "manual"
+      },
       {
         "id": "manual:node-api-reference",
         "category": "manual"
@@ -3441,6 +3477,10 @@
         "id": "manual:v4-canonical-contracts",
         "category": "manual"
       },
+      {
+        "id": "manual:v4-compatibility-facts",
+        "category": "manual"
+      },
       {
         "id": "manual:v4-delivery-warrant-read-candidate",
         "category": "manual"
@@ -3461,6 +3501,10 @@
         "id": "manual:v4-stage-capsule",
         "category": "manual"
       },
+      {
+        "id": "manual:v4-tail-reseal",
+        "category": "manual"
+      },
       {
         "id": "manual:versioning",
         "category": "manual"
@@ -3835,6 +3879,26 @@
         "path": "docs/cli-reference.md",
         "command": "buildchain facts aggregate"
       },
+      {
+        "id": "build-facts",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain facts compatibility project"
+      },
+      {
+        "id": "build-facts",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain facts compatibility query"
+      },
+      {
+        "id": "build-facts",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain facts compatibility query-template"
+      },
+      {
+        "id": "build-facts",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain facts compatibility verify"
+      },
       {
         "id": "build-facts",
         "path": "docs/cli-reference.md",
@@ -3860,6 +3924,46 @@
         "path": "docs/cli-reference.md",
         "command": "buildchain facts aggregate --help"
       },
+      {
+        "id": "build-facts",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain facts compatibility project"
+      },
+      {
+        "id": "build-facts",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain facts compatibility project"
+      },
+      {
+        "id": "build-facts",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain facts compatibility query"
+      },
+      {
+        "id": "build-facts",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain facts compatibility query"
+      },
+      {
+        "id": "build-facts",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain facts compatibility query-template"
+      },
+      {
+        "id": "build-facts",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain facts compatibility query-template"
+      },
+      {
+        "id": "build-facts",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain facts compatibility verify"
+      },
+      {
+        "id": "build-facts",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain facts compatibility verify"
+      },
       {
         "id": "build-facts",
         "path": "docs/cli-reference.md",
@@ -3895,6 +3999,26 @@
         "path": "docs/cli.md",
         "command": "buildchain facts verify --fact"
       },
+      {
+        "id": "build-facts",
+        "path": "docs/v4-compatibility-facts.md",
+        "command": "buildchain facts compatibility project"
+      },
+      {
+        "id": "build-facts",
+        "path": "docs/v4-compatibility-facts.md",
+        "command": "buildchain facts compatibility verify"
+      },
+      {
+        "id": "build-facts",
+        "path": "docs/v4-compatibility-facts.md",
+        "command": "buildchain facts compatibility query-template"
+      },
+      {
+        "id": "build-facts",
+        "path": "docs/v4-compatibility-facts.md",
+        "command": "buildchain facts compatibility query"
+      },
       {
         "id": "candidate",
         "path": "docs/cli-reference.md",
@@ -6710,6 +6834,36 @@
         "path": "README.md",
         "command": "buildchain mark --event native"
       },
+      {
+        "id": "next-development",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain next-development"
+      },
+      {
+        "id": "next-development",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain next-development materialize --input"
+      },
+      {
+        "id": "next-development",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain next-development"
+      },
+      {
+        "id": "next-development",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain next-development --help"
+      },
+      {
+        "id": "next-development",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain next-development materialize"
+      },
+      {
+        "id": "next-development",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain next-development materialize --help"
+      },
       {
         "id": "npm-dry-run",
         "path": "docs/cli-reference.md",
@@ -7965,6 +8119,86 @@
         "path": "README.md",
         "command": "buildchain span --event native"
       },
+      {
+        "id": "tail-reseal",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain tail-reseal"
+      },
+      {
+        "id": "tail-reseal",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain tail-reseal admit --request"
+      },
+      {
+        "id": "tail-reseal",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain tail-reseal plan --request"
+      },
+      {
+        "id": "tail-reseal",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain tail-reseal seal --request"
+      },
+      {
+        "id": "tail-reseal",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain tail-reseal verify-platform --request"
+      },
+      {
+        "id": "tail-reseal",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain tail-reseal"
+      },
+      {
+        "id": "tail-reseal",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain tail-reseal --help"
+      },
+      {
+        "id": "tail-reseal",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain tail-reseal admit"
+      },
+      {
+        "id": "tail-reseal",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain tail-reseal admit --help"
+      },
+      {
+        "id": "tail-reseal",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain tail-reseal plan"
+      },
+      {
+        "id": "tail-reseal",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain tail-reseal plan --help"
+      },
+      {
+        "id": "tail-reseal",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain tail-reseal seal"
+      },
+      {
+        "id": "tail-reseal",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain tail-reseal seal --help"
+      },
+      {
+        "id": "tail-reseal",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain tail-reseal verify-platform"
+      },
+      {
+        "id": "tail-reseal",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain tail-reseal verify-platform --help"
+      },
+      {
+        "id": "tail-reseal",
+        "path": "docs/v4-tail-reseal.md",
+        "command": "buildchain tail-reseal plan"
+      },
       {
         "id": "transaction-inspect",
         "path": "docs/cli-reference.md",
@@ -8416,9 +8650,9 @@
     "cliRegistryPath": "dist/site/cli-registry.json",
     "workflowRegistryPath": "dist/site/workflow-registry.json",
     "pageRegistryPath": "dist/site/page-registry.json",
-    "cliRegistryDigest": "3632f0332f9c0e270a522a4af358482833974757d77ac40a2d7e2efe6a56cb28",
-    "workflowRegistryDigest": "91b72955489bf4a98fa0c3d3b8ef245e34acb5993e3a59c26caad214b004cfde",
-    "pageRegistryDigest": "07068ff6f889aaae1bb0def76cc041b2e8c63092eebf728b245f3f9451e1ea24"
+    "cliRegistryDigest": "c240837b7885defa68e300e6b6178557824f7bd4dce8f258115b990516bf63c7",
+    "workflowRegistryDigest": "732b7a2a25f9b9b6beda4158da29240c186df7eb45a14fb12cb285423b5c9831",
+    "pageRegistryDigest": "d0893422eaf356b36a0439e573beaa4da56466293d2a47a5f7769ec82844ffb3"
   },
   "comparison": {
     "missingCliRegistry": [],

package/dist/site/publication-authority-registry.json

@@ -1191,11 +1191,16 @@
       "signals": [],
       "classified": false
     },
+    {
+      "path": ".github/workflows/v4-tail-reseal.yml",
+      "signals": [],
+      "classified": false
+    },
     {
       "path": ".github/workflows/verify.yml",
       "signals": [],
       "classified": false
     }
   ],
-  "registryDigest": "456987223fcd21bb1db29583187fcbefacf91668a1a245ed1fb186ffe95c15c3"
+  "registryDigest": "95e7d88ca3d3492b7852d715c24d3f4f2cec59f3c3fbb8665aa781d15afd6b63"
 }

package/dist/site/publication-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "contract": "kungfu-buildchain-publication-release-registry",
-  "generatedAt": "2026-08-16T00:38:02.716Z",
-  "publishedAt": "2026-08-16T00:38:02.716Z",
+  "generatedAt": "2026-08-16T06:14:57.817Z",
+  "publishedAt": "2026-08-16T06:14:57.817Z",
   "reproducible": true,
   "timestampPolicy": "ci-injected",
   "deterministicInputs": [
@@ -19,7 +19,7 @@
     "declared Buildchain surface manifest contract"
   ],
   "sourceDateEpoch": "0",
-  "sourceRevision": "e6b14caa6b3dd2af4ea2f6c480baf84006ed0131",
+  "sourceRevision": "358df2d1ab42465111896a42cde85dcca08549d5",
   "timestampPolicyDetails": {
     "contract": "kungfu-buildchain-surface-timestamp-policy",
     "timestampFields": [
@@ -32,7 +32,7 @@
   },
   "package": {
     "name": "@kungfu-tech/buildchain",
-    "version": "4.0.1-alpha.4",
+    "version": "4.0.1-alpha.5",
     "versionSource": "package.json#version"
   },
   "sourceKind": "package-site-bundle",

package/dist/site/release-provenance.json

@@ -20,6 +20,7 @@
       "./detached-artifact-signature": "./packages/core/detached-artifact-signature.js",
       "./anchored-version-material": "./packages/core/anchored-version-material.js",
       "./buildchain-contract": "./packages/core/buildchain-contract.js",
+      "./compatibility-fact-authority": "./packages/core/buildchain-compatibility-proof.js",
       "./candidate-timeline": "./packages/core/candidate-timeline.js",
       "./channel-candidate": "./packages/core/channel-candidate.js",
       "./cache-evidence": "./packages/core/cache-evidence.js",
@@ -40,6 +41,8 @@
       "./public-surface-audit": "./packages/core/public-surface-audit.js",
       "./v4-floating-consumer-policy": "./packages/core/v4-floating-consumer-policy.js",
       "./v4-runtime-ref-resume-authority": "./packages/core/v4-runtime-ref-resume-authority.js",
+      "./v4-tail-reseal": "./packages/core/v4-tail-reseal.js",
+      "./v4-tail-reseal-receipt": "./packages/core/v4-tail-reseal-receipt.js",
       "./logging": "./packages/core/logging.js",
       "./portable-dev-cache": "./packages/core/portable-dev-cache.js",
       "./publication-artifact": "./packages/core/publication-artifact.js",
@@ -57,6 +60,9 @@
       "./release-candidate": "./packages/core/release-candidate.js",
       "./release-candidate-recovery": "./packages/core/release-candidate-recovery.js",
       "./release-train": "./packages/core/release-train.js",
+      "./next-development-transition": "./packages/core/next-development-transition.js",
+      "./next-development-controller": "./packages/core/next-development-controller.js",
+      "./next-development-projection": "./packages/core/next-development-projection.js",
       "./stable-candidate-ledger": "./packages/core/stable-candidate-ledger.js",
       "./release-passport": "./packages/core/release-passport.js",
       "./release-passport-contract": "./packages/core/release-passport-contract.js",
@@ -89,6 +95,7 @@
       "./site/schemas/kfd-product-gate-input-v1.schema.json": "./dist/site/schemas/kfd-product-gate-input-v1.schema.json",
       "./site/schemas/kfd-support-projection-v1.schema.json": "./dist/site/schemas/kfd-support-projection-v1.schema.json",
       "./site/schemas/dev-delivery-authority-v2.schema.json": "./dist/site/schemas/dev-delivery-authority-v2.schema.json",
+      "./site/schemas/v4-compatibility-facts-v1.schema.json": "./dist/site/schemas/v4-compatibility-facts-v1.schema.json",
       "./site/buildchain-contract.json": "./dist/site/buildchain-contract.json",
       "./site/product-mechanism.json": "./dist/site/product-mechanism.json",
       "./site/release-provenance.json": "./dist/site/release-provenance.json",

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