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

package/dist/site/capability-registry.json

@@ -15,7 +15,7 @@
       "maturity": "stable",
       "counts": {
         "manualCount": 4,
-        "pageCount": 15,
+        "pageCount": 17,
         "cliCommandCount": 9,
         "nodeApiCount": 0,
         "workflowCount": 0,
@@ -50,8 +50,8 @@
       "counts": {
         "manualCount": 7,
         "pageCount": 8,
-        "cliCommandCount": 26,
-        "nodeApiCount": 16,
+        "cliCommandCount": 27,
+        "nodeApiCount": 21,
         "workflowCount": 4,
         "actionCount": 3
       },
@@ -85,10 +85,10 @@
       ],
       "maturity": "stable",
       "counts": {
-        "manualCount": 5,
-        "pageCount": 18,
-        "cliCommandCount": 9,
-        "nodeApiCount": 9,
+        "manualCount": 6,
+        "pageCount": 19,
+        "cliCommandCount": 10,
+        "nodeApiCount": 15,
         "workflowCount": 4,
         "actionCount": 2
       },
@@ -97,7 +97,8 @@
         "docs/controller-evidence.md",
         "docs/release-candidate.md",
         "docs/lifecycle-protocol.md",
-        "docs/reusable-build-surface.md"
+        "docs/reusable-build-surface.md",
+        "docs/v4-adopter-delivery.md"
       ],
       "factSources": [
         "page-registry.json",
@@ -123,7 +124,7 @@
         "manualCount": 2,
         "pageCount": 2,
         "cliCommandCount": 37,
-        "nodeApiCount": 9,
+        "nodeApiCount": 11,
         "workflowCount": 0,
         "actionCount": 0
       },
@@ -252,20 +253,22 @@
       ],
       "maturity": "stable",
       "counts": {
-        "manualCount": 9,
-        "pageCount": 15,
-        "cliCommandCount": 12,
-        "nodeApiCount": 11,
+        "manualCount": 11,
+        "pageCount": 17,
+        "cliCommandCount": 13,
+        "nodeApiCount": 16,
         "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 +298,7 @@
         "pageCount": 11,
         "cliCommandCount": 0,
         "nodeApiCount": 2,
-        "workflowCount": 42,
+        "workflowCount": 47,
         "actionCount": 1
       },
       "manuals": [

package/dist/site/cli-registry.json

@@ -5,6 +5,51 @@
   "npmPackage": "@kungfu-tech/buildchain",
   "commandSource": "bin/internal/command-registry.mjs plus bin/buildchain.mjs help enumeration",
   "commands": [
+    {
+      "id": "adopter-delivery",
+      "source": "bin/buildchain.mjs",
+      "usage": "buildchain adopter-delivery run --input <json-or-path> [--output <path>]",
+      "paths": [
+        "adopter-delivery",
+        "adopter-delivery archive",
+        "adopter-delivery bootstrap",
+        "adopter-delivery run",
+        "adopter-delivery verify"
+      ],
+      "syntaxes": [
+        "buildchain adopter-delivery",
+        "buildchain adopter-delivery archive --input <json-or-path> [--output <path>]",
+        "buildchain adopter-delivery bootstrap --input <json-or-path> [--output <path>]",
+        "buildchain adopter-delivery run --input <json-or-path> [--output <path>]",
+        "buildchain adopter-delivery verify --input <json-or-path> --readback <json-or-path> [--output <path>]"
+      ],
+      "options": [
+        "--input",
+        "--output",
+        "--readback"
+      ],
+      "aliases": [],
+      "helpCommands": [
+        "buildchain adopter-delivery --help",
+        "buildchain adopter-delivery archive --help",
+        "buildchain adopter-delivery bootstrap --help",
+        "buildchain adopter-delivery run --help",
+        "buildchain adopter-delivery verify --help"
+      ],
+      "purpose": "Run public protocol-neutral adopter delivery, exact readback, N-1 bootstrap, and published archive checks.",
+      "capabilityGroup": "reusable-build",
+      "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": "architecture",
       "source": "bin/buildchain.mjs",
@@ -239,11 +284,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 +304,7 @@
         "--artifact",
         "--cwd",
         "--fact",
+        "--fact-root",
         "--json",
         "--legacy-kungfu-buildinfo",
         "--module",
@@ -259,11 +313,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 +2591,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",
@@ -3490,6 +3589,7 @@
         "release-tail compat",
         "release-tail init",
         "release-tail plan",
+        "release-tail rehearse",
         "release-tail status",
         "release-tail verify"
       ],
@@ -3498,11 +3598,16 @@
         "buildchain release-tail <status|verify> [--state <path>] [--output <path>]",
         "buildchain release-tail compat --hooks-json <json-or-path> [--output <path>]",
         "buildchain release-tail init --declaration <json-or-path> [--state <path>]",
-        "buildchain release-tail plan --declaration <json-or-path> [--output <path>]"
+        "buildchain release-tail plan --declaration <json-or-path> [--output <path>]",
+        "buildchain release-tail rehearse --capsule <absolute-path> --candidate-root <absolute-path> --mode <simulate|replay> --state <absolute-path> --evidence <absolute-path>"
       ],
       "options": [
+        "--candidate-root",
+        "--capsule",
         "--declaration",
+        "--evidence",
         "--hooks-json",
+        "--mode",
         "--output",
         "--state"
       ],
@@ -3512,6 +3617,7 @@
         "buildchain release-tail compat --help",
         "buildchain release-tail init --help",
         "buildchain release-tail plan --help",
+        "buildchain release-tail rehearse --help",
         "buildchain release-tail status --help",
         "buildchain release-tail verify --help"
       ],
@@ -3666,6 +3772,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",