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

package/dist/site/capability-registry.json

@@ -15,7 +15,7 @@
       "maturity": "stable",
       "counts": {
         "manualCount": 4,
-        "pageCount": 15,
+        "pageCount": 16,
         "cliCommandCount": 9,
         "nodeApiCount": 0,
         "workflowCount": 0,
@@ -50,8 +50,8 @@
       "counts": {
         "manualCount": 7,
         "pageCount": 8,
-        "cliCommandCount": 26,
-        "nodeApiCount": 16,
+        "cliCommandCount": 27,
+        "nodeApiCount": 18,
         "workflowCount": 4,
         "actionCount": 3
       },
@@ -252,20 +252,22 @@
       ],
       "maturity": "stable",
       "counts": {
-        "manualCount": 9,
-        "pageCount": 15,
-        "cliCommandCount": 12,
-        "nodeApiCount": 11,
+        "manualCount": 11,
+        "pageCount": 17,
+        "cliCommandCount": 13,
+        "nodeApiCount": 15,
         "workflowCount": 20,
         "actionCount": 0
       },
       "manuals": [
         "docs/github-governance-authority.md",
         "docs/release-train.md",
+        "docs/next-development-transition.md",
         "docs/infra-contract.md",
         "docs/migration-inventory.md",
         "docs/ownership.md",
         "docs/release-governance.md",
+        "docs/v4-compatibility-facts.md",
         "docs/release-flow.md",
         "docs/runtime-train-validation.md",
         "docs/versioning.md"
@@ -295,7 +297,7 @@
         "pageCount": 11,
         "cliCommandCount": 0,
         "nodeApiCount": 2,
-        "workflowCount": 42,
+        "workflowCount": 43,
         "actionCount": 1
       },
       "manuals": [

package/dist/site/cli-registry.json

@@ -239,11 +239,19 @@
       "usage": "buildchain facts module [--cwd <dir>] [--module <id>] [--module-root <path>]",
       "paths": [
         "facts aggregate",
+        "facts compatibility project",
+        "facts compatibility query",
+        "facts compatibility query-template",
+        "facts compatibility verify",
         "facts module",
         "facts verify"
       ],
       "syntaxes": [
         "buildchain facts aggregate [--cwd <dir>] [--product <id>] [--module-fact <file>]... [--artifact <path>]... [--output <file>] [--json]",
+        "buildchain facts compatibility project [--cwd <dir>] [--registry <json-or-path>] [--output <file>] [--json]",
+        "buildchain facts compatibility query --query <json-or-path> [--registry <json-or-path>] [--cwd <dir>] [--json]",
+        "buildchain facts compatibility query-template --fact-root <sha256:...> [--query-id <id>] [--registry <json-or-path>] [--cwd <dir>] [--json]",
+        "buildchain facts compatibility verify [--cwd <dir>] [--registry <json-or-path>] [--json]",
         "buildchain facts module [--cwd <dir>] [--module <id>] [--module-root <path>] [--version-source <id>] [--output <file>] [--output-path <path>]... [--legacy-kungfu-buildinfo <file>] [--json]",
         "buildchain facts verify [--cwd <dir>] --fact <file> [--json]"
       ],
@@ -251,6 +259,7 @@
         "--artifact",
         "--cwd",
         "--fact",
+        "--fact-root",
         "--json",
         "--legacy-kungfu-buildinfo",
         "--module",
@@ -259,11 +268,18 @@
         "--output",
         "--output-path",
         "--product",
+        "--query",
+        "--query-id",
+        "--registry",
         "--version-source"
       ],
       "aliases": [],
       "helpCommands": [
         "buildchain facts aggregate --help",
+        "buildchain facts compatibility project --help",
+        "buildchain facts compatibility query --help",
+        "buildchain facts compatibility query-template --help",
+        "buildchain facts compatibility verify --help",
         "buildchain facts module --help",
         "buildchain facts verify --help"
       ],
@@ -2530,6 +2546,44 @@
       "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
       "nonDuplicationRationale": "Existing command identity retained for CLI compatibility and discoverability."
     },
+    {
+      "id": "next-development",
+      "source": "bin/buildchain.mjs",
+      "usage": "buildchain next-development materialize --input <request.json> [--cwd <dir>]",
+      "paths": [
+        "next-development",
+        "next-development materialize"
+      ],
+      "syntaxes": [
+        "buildchain next-development",
+        "buildchain next-development materialize --input <request.json> [--cwd <dir>] [--write] [--output <path>] [--json]"
+      ],
+      "options": [
+        "--cwd",
+        "--input",
+        "--json",
+        "--output",
+        "--write"
+      ],
+      "aliases": [],
+      "helpCommands": [
+        "buildchain next-development --help",
+        "buildchain next-development materialize --help"
+      ],
+      "purpose": "Plan or apply one rooted declared-path next-development version transition without release or ref authority.",
+      "capabilityGroup": "governance-versioning",
+      "audience": [
+        "agent",
+        "operator"
+      ],
+      "owner": "buildchain-cli",
+      "maturity": "stable",
+      "introducedVersion": "pre-3.0.2-alpha.4",
+      "compatibilityPromise": "preserved-through-the-v3-major-line",
+      "deprecationReplacement": "",
+      "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
+      "nonDuplicationRationale": "Existing command identity retained for CLI compatibility and discoverability."
+    },
     {
       "id": "npm",
       "source": "bin/buildchain.mjs",
@@ -3666,6 +3720,58 @@
       "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
       "nonDuplicationRationale": "Existing command identity retained for CLI compatibility and discoverability."
     },
+    {
+      "id": "tail-reseal",
+      "source": "bin/buildchain.mjs",
+      "usage": "buildchain tail-reseal plan --request <request.json> [--output <plan.json>]",
+      "paths": [
+        "tail-reseal",
+        "tail-reseal admit",
+        "tail-reseal plan",
+        "tail-reseal seal",
+        "tail-reseal verify-platform"
+      ],
+      "syntaxes": [
+        "buildchain tail-reseal",
+        "buildchain tail-reseal admit --request <request.json> [--output <admission.json>]",
+        "buildchain tail-reseal plan --request <request.json> [--output <plan.json>]",
+        "buildchain tail-reseal seal --request <request.json> --plan <plan.json> --readbacks <dir> --passport <passport.json> --protected-readback-root <sha256:...> [--output <receipt.json>]",
+        "buildchain tail-reseal verify-platform --request <request.json> --platform <id> [--artifact-root <dir>] [--mode retained|resealed] [--provider-readback-root <sha256:...>] [--output <readback.json>]"
+      ],
+      "options": [
+        "--artifact-root",
+        "--mode",
+        "--output",
+        "--passport",
+        "--plan",
+        "--platform",
+        "--protected-readback-root",
+        "--provider-readback-root",
+        "--readbacks",
+        "--request"
+      ],
+      "aliases": [],
+      "helpCommands": [
+        "buildchain tail-reseal --help",
+        "buildchain tail-reseal admit --help",
+        "buildchain tail-reseal plan --help",
+        "buildchain tail-reseal seal --help",
+        "buildchain tail-reseal verify-platform --help"
+      ],
+      "purpose": "Plan, admit, byte-verify, and seal one exact retained v4 Alpha candidate signing-finalization tail.",
+      "capabilityGroup": "release-passport-trust",
+      "audience": [
+        "agent",
+        "operator"
+      ],
+      "owner": "buildchain-cli",
+      "maturity": "stable",
+      "introducedVersion": "pre-3.0.2-alpha.4",
+      "compatibilityPromise": "preserved-through-the-v3-major-line",
+      "deprecationReplacement": "",
+      "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
+      "nonDuplicationRationale": "Existing command identity retained for CLI compatibility and discoverability."
+    },
     {
       "id": "transaction-inspect",
       "source": "bin/buildchain.mjs",

package/dist/site/kfd-claims.json

@@ -14,20 +14,20 @@
   },
   "runtimeContract": {
     "contract": "kungfu-buildchain-runtime-contract-world",
-    "compatibilityDigest": "sha256:c8407195cafe42cb62ac2a4f5ff5b2c3f9b8aa65c27cc678efd46240cb3f0ecc",
+    "compatibilityDigest": "sha256:5de1c69386510b74b17eb70141b8bdd07063d62c504f91db5e84b67c6d4b64a2",
     "majorLine": "v4"
   },
   "publicSurfaceReverseAudit": {
     "contract": "kungfu-buildchain-public-surface-reverse-audit",
     "path": "dist/site/public-surface-audit.json",
     "status": "passed",
-    "sha256": "b923b56ff204e56808dbb5a2f6f3647803fdc55d2968a2c09cbad13d532188e7",
+    "sha256": "992ca2b4be3a3e80177648fee1f8c4e46a7859ad41bddf0ac54316f9d2c2752d",
     "summary": {
-      "cliCommandCount": 114,
-      "workflowCount": 71,
+      "cliCommandCount": 116,
+      "workflowCount": 72,
       "actionCount": 7,
-      "sitePageCount": 77,
-      "docCommandRefCount": 987,
+      "sitePageCount": 80,
+      "docCommandRefCount": 1025,
       "failureCount": 0
     },
     "auditBoundary": {
@@ -246,13 +246,13 @@
       "contract": "kungfu-buildchain-public-surface-reverse-audit",
       "path": "dist/site/public-surface-audit.json",
       "status": "passed",
-      "sha256": "b923b56ff204e56808dbb5a2f6f3647803fdc55d2968a2c09cbad13d532188e7",
+      "sha256": "992ca2b4be3a3e80177648fee1f8c4e46a7859ad41bddf0ac54316f9d2c2752d",
       "summary": {
-        "cliCommandCount": 114,
-        "workflowCount": 71,
+        "cliCommandCount": 116,
+        "workflowCount": 72,
         "actionCount": 7,
-        "sitePageCount": 77,
-        "docCommandRefCount": 987,
+        "sitePageCount": 80,
+        "docCommandRefCount": 1025,
         "failureCount": 0
       },
       "auditBoundary": {
@@ -596,6 +596,18 @@
           "public": true,
           "plane": "verify"
         },
+        {
+          "id": "doc:docs/next-development-transition.md",
+          "name": "Next-development transition",
+          "kind": "documentation",
+          "sourcePath": "docs/next-development-transition.md",
+          "evidencePath": "docs/next-development-transition.md",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "plane": "verify"
+        },
         {
           "id": "doc:docs/node-api-reference.md",
           "name": "Generated Node API reference",
@@ -812,6 +824,18 @@
           "public": true,
           "plane": "use"
         },
+        {
+          "id": "doc:docs/v4-compatibility-facts.md",
+          "name": "Buildchain v4 compatibility Facts",
+          "kind": "documentation",
+          "sourcePath": "docs/v4-compatibility-facts.md",
+          "evidencePath": "docs/v4-compatibility-facts.md",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "plane": "verify"
+        },
         {
           "id": "doc:docs/versioning.md",
           "name": "Versioning",
@@ -1340,6 +1364,18 @@
           "public": true,
           "packageExport": "./buildchain-contract"
         },
+        {
+          "id": "export:./compatibility-fact-authority",
+          "name": "@kungfu-tech/buildchain/compatibility-fact-authority",
+          "kind": "package-export",
+          "sourcePath": "packages/core/buildchain-compatibility-proof.js",
+          "evidencePath": "packages/core/buildchain-compatibility-proof.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./compatibility-fact-authority"
+        },
         {
           "id": "export:./candidate-timeline",
           "name": "@kungfu-tech/buildchain/candidate-timeline",
@@ -1580,6 +1616,30 @@
           "public": true,
           "packageExport": "./v4-runtime-ref-resume-authority"
         },
+        {
+          "id": "export:./v4-tail-reseal",
+          "name": "@kungfu-tech/buildchain/v4-tail-reseal",
+          "kind": "package-export",
+          "sourcePath": "packages/core/v4-tail-reseal.js",
+          "evidencePath": "packages/core/v4-tail-reseal.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./v4-tail-reseal"
+        },
+        {
+          "id": "export:./v4-tail-reseal-receipt",
+          "name": "@kungfu-tech/buildchain/v4-tail-reseal-receipt",
+          "kind": "package-export",
+          "sourcePath": "packages/core/v4-tail-reseal-receipt.js",
+          "evidencePath": "packages/core/v4-tail-reseal-receipt.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./v4-tail-reseal-receipt"
+        },
         {
           "id": "export:./logging",
           "name": "@kungfu-tech/buildchain/logging",
@@ -1784,6 +1844,42 @@
           "public": true,
           "packageExport": "./release-train"
         },
+        {
+          "id": "export:./next-development-transition",
+          "name": "@kungfu-tech/buildchain/next-development-transition",
+          "kind": "package-export",
+          "sourcePath": "packages/core/next-development-transition.js",
+          "evidencePath": "packages/core/next-development-transition.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./next-development-transition"
+        },
+        {
+          "id": "export:./next-development-controller",
+          "name": "@kungfu-tech/buildchain/next-development-controller",
+          "kind": "package-export",
+          "sourcePath": "packages/core/next-development-controller.js",
+          "evidencePath": "packages/core/next-development-controller.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./next-development-controller"
+        },
+        {
+          "id": "export:./next-development-projection",
+          "name": "@kungfu-tech/buildchain/next-development-projection",
+          "kind": "package-export",
+          "sourcePath": "packages/core/next-development-projection.js",
+          "evidencePath": "packages/core/next-development-projection.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./next-development-projection"
+        },
         {
           "id": "export:./stable-candidate-ledger",
           "name": "@kungfu-tech/buildchain/stable-candidate-ledger",
@@ -2968,6 +3064,18 @@
           "public": true,
           "reverseAuditSource": "bin/buildchain.mjs"
         },
+        {
+          "id": "cli:next-development",
+          "name": "buildchain next-development materialize --input <request.json> [--cwd <dir>]",
+          "kind": "cli-command",
+          "sourcePath": "bin/buildchain.mjs",
+          "evidencePath": "bin/buildchain.mjs",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "reverseAuditSource": "bin/buildchain.mjs"
+        },
         {
           "id": "cli:npm",
           "name": "buildchain npm",
@@ -3352,6 +3460,18 @@
           "public": true,
           "reverseAuditSource": "bin/buildchain.mjs"
         },
+        {
+          "id": "cli:tail-reseal",
+          "name": "buildchain tail-reseal plan --request <request.json> [--output <plan.json>]",
+          "kind": "cli-command",
+          "sourcePath": "bin/buildchain.mjs",
+          "evidencePath": "bin/buildchain.mjs",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "reverseAuditSource": "bin/buildchain.mjs"
+        },
         {
           "id": "cli:transaction-inspect",
           "name": "buildchain transaction inspect ...",
@@ -5492,6 +5612,25 @@
           ],
           "reverseAuditSource": ".github/workflows"
         },
+        {
+          "id": "workflow:v4-tail-reseal",
+          "name": "workflow:v4-tail-reseal",
+          "kind": "workflow",
+          "sourcePath": ".github/workflows/v4-tail-reseal.yml",
+          "evidencePath": ".github/workflows/v4-tail-reseal.yml",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "inputCount": 4,
+          "inputs": [
+            "artifact-retention-days",
+            "consumer-policy-receipt-json",
+            "macos-finalization-command",
+            "request-json"
+          ],
+          "reverseAuditSource": ".github/workflows"
+        },
         {
           "id": "workflow:verify",
           "name": "workflow:verify",
@@ -6342,6 +6481,18 @@
           "public": true,
           "reverseAuditSource": "dist/site/page-registry.json"
         },
+        {
+          "id": "site-page:manual:next-development-transition",
+          "name": "site-page:manual:next-development-transition",
+          "kind": "site-page",
+          "sourcePath": "dist/site/page-registry.json",
+          "evidencePath": "dist/site/page-registry.json",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "reverseAuditSource": "dist/site/page-registry.json"
+        },
         {
           "id": "site-page:manual:node-api-reference",
           "name": "site-page:manual:node-api-reference",
@@ -6630,6 +6781,18 @@
           "public": true,
           "reverseAuditSource": "dist/site/page-registry.json"
         },
+        {
+          "id": "site-page:manual:v4-compatibility-facts",
+          "name": "site-page:manual:v4-compatibility-facts",
+          "kind": "site-page",
+          "sourcePath": "dist/site/page-registry.json",
+          "evidencePath": "dist/site/page-registry.json",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "reverseAuditSource": "dist/site/page-registry.json"
+        },
         {
           "id": "site-page:manual:v4-delivery-warrant-read-candidate",
           "name": "site-page:manual:v4-delivery-warrant-read-candidate",
@@ -6690,6 +6853,18 @@
           "public": true,
           "reverseAuditSource": "dist/site/page-registry.json"
         },
+        {
+          "id": "site-page:manual:v4-tail-reseal",
+          "name": "site-page:manual:v4-tail-reseal",
+          "kind": "site-page",
+          "sourcePath": "dist/site/page-registry.json",
+          "evidencePath": "dist/site/page-registry.json",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "reverseAuditSource": "dist/site/page-registry.json"
+        },
         {
           "id": "site-page:manual:versioning",
           "name": "site-page:manual:versioning",
@@ -6897,6 +7072,6 @@
         }
       }
     ],
-    "publicSurfaceCount": 438
+    "publicSurfaceCount": 452
   }
 }

package/dist/site/kfd-upstream-aggregate.json

@@ -4,7 +4,7 @@
   "product": {
     "id": "kungfu-tech-buildchain",
     "name": "@kungfu-tech/buildchain",
-    "version": "4.0.1-alpha.3",
+    "version": "4.0.1-alpha.5",
     "repository": "https://github.com/kungfu-systems/buildchain"
   },
   "source": {

package/dist/site/manual-registry.json

@@ -9,7 +9,7 @@
       "title": "Buildchain documentation map",
       "path": "docs/MAP.md",
       "plane": "use",
-      "digest": "sha256:16120e34c1a178b00309887d7903c2c8acb95815326091cf46a608d375435b99",
+      "digest": "sha256:fd63caf537bdc0dc2a220688dcb89534f6f84f6223e8c45f399a7d1bb8f8faf8",
       "capabilityGroup": "getting-started",
       "audience": [
         "agent",
@@ -160,6 +160,21 @@
       "maturity": "preview",
       "order": 132
     },
+    {
+      "id": "next-development-transition",
+      "title": "Next-development transition",
+      "path": "docs/next-development-transition.md",
+      "plane": "verify",
+      "digest": "sha256:c33c017ae163650b422f7ec294a05f3db8b8e99b87c55ab2d8ac3cce1726448f",
+      "capabilityGroup": "governance-versioning",
+      "audience": [
+        "release-operator",
+        "consumer",
+        "agent"
+      ],
+      "maturity": "preview",
+      "order": 133
+    },
     {
       "id": "release-propagation",
       "title": "Release propagation",
@@ -332,7 +347,7 @@
       "title": "Generated CLI reference",
       "path": "docs/cli-reference.md",
       "plane": "use",
-      "digest": "sha256:82b5d7afa63fc4cfa29ffb813f1830b30eeee3d9b0da821f77240a9ddb25584e",
+      "digest": "sha256:157d6259dd8f884833f7065f52bff0d482878eca72623dcc607e4204692e4970",
       "capabilityGroup": "api-cli-reference",
       "audience": [
         "agent",
@@ -347,7 +362,7 @@
       "title": "Generated Node API reference",
       "path": "docs/node-api-reference.md",
       "plane": "use",
-      "digest": "sha256:8f0c42d4453003d9bff861392c890f557a54608662e1cc380ed9aaa6635df016",
+      "digest": "sha256:34a2feafe2f6183afbc0a72fa6362d39db6968c2bac187a1a1dd376d7ca50e50",
       "capabilityGroup": "api-cli-reference",
       "audience": [
         "agent",
@@ -484,6 +499,21 @@
       "maturity": "stable",
       "order": 700
     },
+    {
+      "id": "v4-compatibility-facts",
+      "title": "Buildchain v4 compatibility Facts",
+      "path": "docs/v4-compatibility-facts.md",
+      "plane": "verify",
+      "digest": "sha256:d29c904a17aca0ca3ad4f48a826f530610d77ffca8bde76ef7e5b4c245c2ca47",
+      "capabilityGroup": "governance-versioning",
+      "audience": [
+        "developer",
+        "maintainer",
+        "agent"
+      ],
+      "maturity": "preview",
+      "order": 139
+    },
     {
       "id": "release-flow",
       "title": "Release flow",
@@ -517,7 +547,7 @@
       "title": "Versioning",
       "path": "docs/versioning.md",
       "plane": "why",
-      "digest": "sha256:fa094ca11fe51b2f23b2154523414676d6f8c8fa50493c5027a469da9115a414",
+      "digest": "sha256:a2fc36e62ac3adfa0dd499972f22cad22131ccc526e11e890e2cbdc4d3a31341",
       "capabilityGroup": "governance-versioning",
       "audience": [
         "maintainer"
@@ -549,6 +579,7 @@
     "docs/reusable-build-surface.md",
     "docs/release-candidate.md",
     "docs/release-train.md",
+    "docs/next-development-transition.md",
     "docs/stable-candidate-patrol.md",
     "docs/dev-qualification-patrol.md",
     "docs/dev-alpha-candidate-patrol.md",