@kungfu-tech/buildchain 4.0.2-alpha.43 → 4.0.2-alpha.45

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": "c4041ba3492fb2c929523e4a81476cffc479bd9105815722808f9f9f80f71f6f",
+    "sha256": "b912e513430da3ecb1368a4e0451750d5d7d4cea9e9342eebf484904b1bed4e0",
     "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": "c4041ba3492fb2c929523e4a81476cffc479bd9105815722808f9f9f80f71f6f",
+      "sha256": "b912e513430da3ecb1368a4e0451750d5d7d4cea9e9342eebf484904b1bed4e0",
       "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.43",
+    "version": "4.0.2-alpha.45",
     "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",
@@ -333,7 +333,7 @@
       "title": "CLI and npm package",
       "path": "docs/cli.md",
       "plane": "use",
-      "digest": "sha256:cd4e6144d45f4f01b733a728695a9f22acdd7124bd4aba18c6b0146d27f57c44",
+      "digest": "sha256:fc2e0cd3f5718e05101d85f6363cefcd2336609c05dd6626b6a062b44c3a1a0d",
       "capabilityGroup": "api-cli-reference",
       "audience": [
         "agent",
@@ -362,7 +362,7 @@
       "title": "Generated Node API reference",
       "path": "docs/node-api-reference.md",
       "plane": "use",
-      "digest": "sha256:df79569e33023c30fe010a88acecb45caf769970cda1e83c5fc2657986fa9e33",
+      "digest": "sha256:48232d47023b85063e7f779f053850e38149359ea3b2a5acd5126ff81f423ff4",
       "capabilityGroup": "api-cli-reference",
       "audience": [
         "agent",

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

@@ -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",
@@ -15963,7 +16078,7 @@
       ],
       "source": {
         "path": "packages/core/paper-agent-entry.js",
-        "line": 255
+        "line": 279
       },
       "example": "import { collectPaperAgentEntry } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -15992,7 +16107,7 @@
       ],
       "source": {
         "path": "packages/core/paper-agent-entry.js",
-        "line": 95
+        "line": 101
       },
       "example": "import { createPaperAgentEntry } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -16025,7 +16140,7 @@
       ],
       "source": {
         "path": "packages/core/paper-agent-entry.js",
-        "line": 63
+        "line": 69
       },
       "example": "import { mergePaperAgentEntryInstructions } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -16049,7 +16164,7 @@
       ],
       "source": {
         "path": "packages/core/paper-agent-entry.js",
-        "line": 18
+        "line": 24
       },
       "example": "import { PAPER_AGENT_ENTRY_CONTRACT } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -16073,7 +16188,7 @@
       ],
       "source": {
         "path": "packages/core/paper-agent-entry.js",
-        "line": 19
+        "line": 25
       },
       "example": "import { PAPER_AGENT_ENTRY_SCHEMA_VERSION } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -16097,7 +16212,7 @@
       ],
       "source": {
         "path": "packages/core/paper-agent-entry.js",
-        "line": 22
+        "line": 28
       },
       "example": "import { PAPER_AGENT_ENTRY_SECTION_END } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -16121,7 +16236,7 @@
       ],
       "source": {
         "path": "packages/core/paper-agent-entry.js",
-        "line": 20
+        "line": 26
       },
       "example": "import { PAPER_AGENT_ENTRY_SECTION_START } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -16150,7 +16265,7 @@
       ],
       "source": {
         "path": "packages/core/paper-agent-entry.js",
-        "line": 152
+        "line": 176
       },
       "example": "import { paperAgentEntryFiles } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -16179,7 +16294,7 @@
       ],
       "source": {
         "path": "packages/core/paper-agent-entry.js",
-        "line": 38
+        "line": 44
       },
       "example": "import { paperAgentEntryInstructions } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -16212,7 +16327,7 @@
       ],
       "source": {
         "path": "packages/core/paper-agent-entry.js",
-        "line": 181
+        "line": 205
       },
       "example": "import { resolvePaperBuildchainSha } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -30319,7 +30434,7 @@
       "specifier": "@kungfu-tech/buildchain/paper",
       "export": "./paper",
       "target": "./packages/core/paper.js",
-      "digest": "sha256:3fc1d02f229ba0f824bd679fd8af771f9010217ce308fbaef0b017581edb2e9c",
+      "digest": "sha256:0af7b6a2b66d7b471bf6d22064558269375f6c01c4147be4d77bc00c9865d988",
       "summary": "Unified Paper work, fleet, scaffold, preflight, npm bootstrap, build, Alpha, status, and resume planning APIs.",
       "capabilityGroup": "reusable-build",
       "audience": [
@@ -31188,18 +31303,44 @@
       "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": [
     {
       "id": "cli-and-node-package",
       "path": "docs/cli.md",
-      "digest": "sha256:cd4e6144d45f4f01b733a728695a9f22acdd7124bd4aba18c6b0146d27f57c44"
+      "digest": "sha256:fc2e0cd3f5718e05101d85f6363cefcd2336609c05dd6626b6a062b44c3a1a0d"
     },
     {
       "id": "node-api-reference",
       "path": "docs/node-api-reference.md",
-      "digest": "sha256:df79569e33023c30fe010a88acecb45caf769970cda1e83c5fc2657986fa9e33"
+      "digest": "sha256:48232d47023b85063e7f779f053850e38149359ea3b2a5acd5126ff81f423ff4"
     },
     {
       "id": "build-facts",