@kungfu-tech/buildchain 4.0.2-alpha.44 → 4.0.2-alpha.46

package/dist/site/capability-registry.json

@@ -15,7 +15,7 @@
       "maturity": "stable",
       "counts": {
         "manualCount": 4,
-        "pageCount": 21,
+        "pageCount": 22,
         "cliCommandCount": 9,
         "nodeApiCount": 0,
         "workflowCount": 0,
@@ -88,7 +88,7 @@
         "manualCount": 6,
         "pageCount": 19,
         "cliCommandCount": 10,
-        "nodeApiCount": 16,
+        "nodeApiCount": 17,
         "workflowCount": 4,
         "actionCount": 2
       },

package/dist/site/kfd-claims.json

@@ -21,12 +21,12 @@
     "contract": "kungfu-buildchain-public-surface-reverse-audit",
     "path": "dist/site/public-surface-audit.json",
     "status": "passed",
-    "sha256": "d363580f057f35f69ee607227595bb40e761731d2c22c8b27ae0f13f9a15dd10",
+    "sha256": "ec0b75ae0358792ffbf30b57463179055b6644e3370cc44ba579e4c1338cfea3",
     "summary": {
       "cliCommandCount": 117,
       "workflowCount": 114,
       "actionCount": 8,
-      "sitePageCount": 87,
+      "sitePageCount": 88,
       "docCommandRefCount": 1050,
       "failureCount": 0
     },
@@ -246,12 +246,12 @@
       "contract": "kungfu-buildchain-public-surface-reverse-audit",
       "path": "dist/site/public-surface-audit.json",
       "status": "passed",
-      "sha256": "d363580f057f35f69ee607227595bb40e761731d2c22c8b27ae0f13f9a15dd10",
+      "sha256": "ec0b75ae0358792ffbf30b57463179055b6644e3370cc44ba579e4c1338cfea3",
       "summary": {
         "cliCommandCount": 117,
         "workflowCount": 114,
         "actionCount": 8,
-        "sitePageCount": 87,
+        "sitePageCount": 88,
         "docCommandRefCount": 1050,
         "failureCount": 0
       },
@@ -2215,6 +2215,18 @@
           "participantFacing": true,
           "public": true,
           "packageExport": "./buildchain-kfd-claims"
+        },
+        {
+          "id": "export:./oci-publication",
+          "name": "@kungfu-tech/buildchain/oci-publication",
+          "kind": "package-export",
+          "sourcePath": "packages/core/oci-publication-bundle.js",
+          "evidencePath": "packages/core/oci-publication-bundle.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./oci-publication"
         }
       ],
       "siteConsumptionContracts": [
@@ -8465,6 +8477,18 @@
           "public": true,
           "reverseAuditSource": "dist/site/page-registry.json"
         },
+        {
+          "id": "site-page:manual:oci-publication",
+          "name": "site-page:manual:oci-publication",
+          "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:ownership",
           "name": "site-page:manual:ownership",
@@ -9092,6 +9116,6 @@
         }
       }
     ],
-    "publicSurfaceCount": 521
+    "publicSurfaceCount": 523
   }
 }

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

@@ -4,7 +4,7 @@
   "product": {
     "id": "kungfu-tech-buildchain",
     "name": "@kungfu-tech/buildchain",
-    "version": "4.0.2-alpha.44",
+    "version": "4.0.2-alpha.46",
     "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:aef677bb3e37882f73daf65b7052989fc549e3b40d70bc4036beb2738b608345",
+      "digest": "sha256:af7bee38e21a9ada99e1731f3576733f2897f9d19bdbf39eb2781650095ae419",
       "capabilityGroup": "getting-started",
       "audience": [
         "agent",
@@ -362,7 +362,7 @@
       "title": "Generated Node API reference",
       "path": "docs/node-api-reference.md",
       "plane": "use",
-      "digest": "sha256:df073c14c12f15c851eb4507cbeb2919add936ac3079b10f222478138720d092",
+      "digest": "sha256:69f4e87e7cbf154f4b3241269e806e7998f9a517fb8ada64f120239c49abbd78",
       "capabilityGroup": "api-cli-reference",
       "audience": [
         "agent",
@@ -462,7 +462,7 @@
       "title": "Publish transaction",
       "path": "docs/publish-transaction.md",
       "plane": "verify",
-      "digest": "sha256:635de0da30769e4e6f956748ec9758338a1ae7921bce73268c2d914ae240693d",
+      "digest": "sha256:713f4fd2b9e67cefdd394170eea49ddb92e803c2e6adac20d6f3b8b1e431b960",
       "capabilityGroup": "release-passport-trust",
       "audience": [
         "release-operator"

package/dist/site/node-api-registry.json

@@ -15331,7 +15331,7 @@
       ],
       "source": {
         "path": "packages/core/next-development-transition.js",
-        "line": 344
+        "line": 343
       },
       "example": "import { advanceNextDevelopmentTransition } from \"@kungfu-tech/buildchain/next-development-transition\";",
       "maturity": "stable",
@@ -15364,7 +15364,7 @@
       ],
       "source": {
         "path": "packages/core/next-development-transition.js",
-        "line": 305
+        "line": 304
       },
       "example": "import { bindNextDevelopmentAnchor } from \"@kungfu-tech/buildchain/next-development-transition\";",
       "maturity": "stable",
@@ -15393,7 +15393,7 @@
       ],
       "source": {
         "path": "packages/core/next-development-transition.js",
-        "line": 253
+        "line": 252
       },
       "example": "import { createNextDevelopmentTransition } from \"@kungfu-tech/buildchain/next-development-transition\";",
       "maturity": "stable",
@@ -15422,7 +15422,7 @@
       ],
       "source": {
         "path": "packages/core/next-development-transition.js",
-        "line": 472
+        "line": 471
       },
       "example": "import { materializeNextDevelopmentTransition } from \"@kungfu-tech/buildchain/next-development-transition\";",
       "maturity": "stable",
@@ -15628,7 +15628,7 @@
       ],
       "source": {
         "path": "packages/core/next-development-transition.js",
-        "line": 416
+        "line": 415
       },
       "example": "import { recordNextDevelopmentMaterialization } from \"@kungfu-tech/buildchain/next-development-transition\";",
       "maturity": "stable",
@@ -15657,7 +15657,7 @@
       ],
       "source": {
         "path": "packages/core/next-development-transition.js",
-        "line": 729
+        "line": 728
       },
       "example": "import { validateNextDevelopmentTransition } from \"@kungfu-tech/buildchain/next-development-transition\";",
       "maturity": "stable",
@@ -15666,6 +15666,121 @@
         "agent"
       ]
     },
+    {
+      "id": "packages/core/oci-publication-bundle.js#OCI_FAMILY_SCHEMA",
+      "name": "OCI_FAMILY_SCHEMA",
+      "kind": "constant",
+      "signature": "const OCI_FAMILY_SCHEMA",
+      "parameters": [],
+      "returns": "value",
+      "errors": [
+        "Import does not declare a throw contract."
+      ],
+      "sideEffects": [
+        "none-on-import"
+      ],
+      "source": {
+        "path": "packages/core/oci-publication-bundle.js",
+        "line": 6
+      },
+      "example": "import { OCI_FAMILY_SCHEMA } from \"@kungfu-tech/buildchain/oci-publication\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/oci-publication-bundle.js#ociBundleFile",
+      "name": "ociBundleFile",
+      "kind": "function",
+      "signature": "function ociBundleFile(root, relative)",
+      "parameters": [
+        {
+          "name": "root",
+          "signature": "root"
+        },
+        {
+          "name": "relative",
+          "signature": "relative"
+        }
+      ],
+      "returns": "unknown",
+      "errors": [
+        "Errors from called operations may propagate; no narrower throw contract is declared in source."
+      ],
+      "sideEffects": [
+        "none-detected-by-static-source-scan"
+      ],
+      "source": {
+        "path": "packages/core/oci-publication-bundle.js",
+        "line": 29
+      },
+      "example": "import { ociBundleFile } from \"@kungfu-tech/buildchain/oci-publication\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/oci-publication-bundle.js#sealOciPublicationBundle",
+      "name": "sealOciPublicationBundle",
+      "kind": "function",
+      "signature": "function sealOciPublicationBundle({ bundleRoot, body })",
+      "parameters": [
+        {
+          "name": "parameter1",
+          "signature": "{ bundleRoot, body }"
+        }
+      ],
+      "returns": "unknown",
+      "errors": [
+        "May throw an Error on rejected input or failed operations; follow the linked source contract."
+      ],
+      "sideEffects": [
+        "none-detected-by-static-source-scan"
+      ],
+      "source": {
+        "path": "packages/core/oci-publication-bundle.js",
+        "line": 10
+      },
+      "example": "import { sealOciPublicationBundle } from \"@kungfu-tech/buildchain/oci-publication\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/oci-publication-bundle.js#verifyOciPublicationBundle",
+      "name": "verifyOciPublicationBundle",
+      "kind": "function",
+      "signature": "function verifyOciPublicationBundle({ bundleRoot, manifest, repository, sourceSha, version, })",
+      "parameters": [
+        {
+          "name": "parameter1",
+          "signature": "{ bundleRoot, manifest, repository, sourceSha, version, }"
+        }
+      ],
+      "returns": "unknown",
+      "errors": [
+        "Errors from called operations may propagate; no narrower throw contract is declared in source."
+      ],
+      "sideEffects": [
+        "none-detected-by-static-source-scan"
+      ],
+      "source": {
+        "path": "packages/core/oci-publication-bundle.js",
+        "line": 114
+      },
+      "example": "import { verifyOciPublicationBundle } from \"@kungfu-tech/buildchain/oci-publication\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
     {
       "id": "packages/core/package-manager.js#assertPackageManager",
       "name": "assertPackageManager",
@@ -19395,11 +19510,11 @@
         "May throw an Error on rejected input or failed operations; follow the linked source contract."
       ],
       "sideEffects": [
-        "none-detected-by-static-source-scan"
+        "subprocess"
       ],
       "source": {
         "path": "packages/core/publication-sealed-bundle.js",
-        "line": 84
+        "line": 97
       },
       "example": "import { createPublicationSealedBundle } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -19423,7 +19538,7 @@
       ],
       "source": {
         "path": "packages/core/publication-sealed-bundle.js",
-        "line": 10
+        "line": 11
       },
       "example": "import { PUBLICATION_SEALED_BUNDLE_CONTRACT } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -19452,7 +19567,7 @@
       ],
       "source": {
         "path": "packages/core/publication-sealed-bundle.js",
-        "line": 133
+        "line": 189
       },
       "example": "import { verifyPublicationSealedBundle } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -30294,7 +30409,7 @@
       "specifier": "@kungfu-tech/buildchain/publication-sealed-bundle",
       "export": "./publication-sealed-bundle",
       "target": "./packages/core/publication-sealed-bundle.js",
-      "digest": "sha256:0b912deace895b3f99e7a77b77678d35a7c22a68b3d18eb31aff2995fb66a51e",
+      "digest": "sha256:c12ef1e9eaf762059c88f2d69a87a4d1560356cbbb37fb66fda5639c604caa82",
       "summary": "Build-once publication bundle manifests and exact-byte resume verification APIs.",
       "capabilityGroup": "reusable-build",
       "audience": [
@@ -30728,7 +30843,7 @@
       "specifier": "@kungfu-tech/buildchain/next-development-transition",
       "export": "./next-development-transition",
       "target": "./packages/core/next-development-transition.js",
-      "digest": "sha256:01b47222bb17fc4a36a66bce74ff11bf2d2ac17c935085aeec93684933849fee",
+      "digest": "sha256:c611357000496829a40605ba68755bb62b92d451ab452abcfce8fcd70373dd03",
       "summary": "Provider-neutral completed-Alpha preservation and rooted next-development state, version-model, idempotency, and local materialization APIs.",
       "capabilityGroup": "governance-versioning",
       "audience": [
@@ -31188,6 +31303,32 @@
       "deprecationReplacement": "",
       "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
       "nonDuplicationRationale": "Existing package subpath retained as the canonical API boundary for this capability."
+    },
+    {
+      "specifier": "@kungfu-tech/buildchain/oci-publication",
+      "export": "./oci-publication",
+      "target": "./packages/core/oci-publication-bundle.js",
+      "digest": "sha256:6783cbeb8ee699b8c4b04ac9f692cdccb4b226872f06f025e1a5e4b49d05e3f5",
+      "summary": "Sealed OCI image family verification, provenance, and smoke evidence APIs.",
+      "capabilityGroup": "reusable-build",
+      "audience": [
+        "developer",
+        "agent"
+      ],
+      "symbolCount": 4,
+      "symbolIds": [
+        "packages/core/oci-publication-bundle.js#OCI_FAMILY_SCHEMA",
+        "packages/core/oci-publication-bundle.js#ociBundleFile",
+        "packages/core/oci-publication-bundle.js#sealOciPublicationBundle",
+        "packages/core/oci-publication-bundle.js#verifyOciPublicationBundle"
+      ],
+      "owner": "buildchain-core",
+      "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 package subpath retained as the canonical API boundary for this capability."
     }
   ],
   "docs": [
@@ -31199,7 +31340,7 @@
     {
       "id": "node-api-reference",
       "path": "docs/node-api-reference.md",
-      "digest": "sha256:df073c14c12f15c851eb4507cbeb2919add936ac3079b10f222478138720d092"
+      "digest": "sha256:69f4e87e7cbf154f4b3241269e806e7998f9a517fb8ada64f120239c49abbd78"
     },
     {
       "id": "build-facts",