@kungfu-tech/buildchain 4.0.2-alpha.26 → 4.0.2-alpha.28

package/architecture/agent-change-map.md

@@ -151,6 +151,8 @@ Safe change route: Reduce one owned responsibility behind the stable facade, run
 
 ### Current top twenty maintenance hotspots
 
+- `.github/workflows/.build.yml`
+- `.github/workflows/.publication-authority.yml`
 - `.github/workflows/bootstrap.yml`
 - `scripts/check-v4-universal-workflow-bootstrap.mjs`
 - `scripts/v4-universal-workflow-engine.mjs`

package/architecture/maintainability-debt.json

@@ -7,8 +7,8 @@
   },
   "totalExcessLedger": {
     "metric": "calibrated-full-dimensional-excess-v1",
-    "measuredExcess": 64432,
-    "current": 56371
+    "measuredExcess": 64434,
+    "current": 56373
   },
   "defaults": {
     "owner": "Buildchain architecture maintainers",
@@ -2948,7 +2948,7 @@
           "lines": 2736
         },
         "current": {
-          "lines": 1215
+          "lines": 1217
         },
         "target": {
           "lines": 600
@@ -3094,6 +3094,8 @@
     }
   },
   "hotspots": [
+    ".github/workflows/.build.yml",
+    ".github/workflows/.publication-authority.yml",
     ".github/workflows/bootstrap.yml",
     "scripts/check-v4-universal-workflow-bootstrap.mjs",
     "scripts/v4-universal-workflow-engine.mjs",
@@ -3155,7 +3157,7 @@
       "path": ".github/workflows/.release-candidate-promote.yml",
       "metric": "lines",
       "baseline": 2736,
-      "current": 1215
+      "current": 1217
     },
     {
       "domain": "sources",

package/architecture/maintainability-policy.json

@@ -25,13 +25,13 @@
     "rationale": "Wave 4 freezes both the aggregate exception inventory and every exception class at the exact protected baseline; reductions may ratchet these ceilings downward, but entries cannot be moved between classes to create hidden headroom."
   },
   "repositoryBudgets": {
-    "baselineRevision": "858dbe00b6206a8f356b4a12d2659bee7a72e71b",
+    "baselineRevision": "4d404e012cd6c199c4d3fa770625ce0d33c9a2cf",
     "maxHandMaintainedSourceFiles": 463,
-    "maxHandMaintainedSourceLines": 170543,
+    "maxHandMaintainedSourceLines": 170637,
     "maxWorkflowFiles": 80,
     "maxWorkflowLines": 26791,
-    "latestTransition": "V4 product publication retries bounded transient GitHub mutations.",
-    "latestTransitionRationale": "The existing v4 product provider retries only status-classified transient GitHub writes with fixed one, two, and four second delays, and checks provider readback before replaying pull-request creation. Direct low-level adapter callers retain the prior single-attempt default when no retry boundary is supplied. Deterministic protection, conflict, permission, admission, and authority failures remain fail-closed. The exact inventory remains 463 hand-maintained source files and grows by 66 lines to 170543; the ceiling grants no new workflow, credential, provider permission, merge authority, capability, or publication scope.",
+    "latestTransition": "V4 zero-delta version-state publication reuses the rooted source tree and retains safe GitHub mutation status codes.",
+    "latestTransitionRationale": "When declared version files already equal the qualified product version, the GitHub provider now reuses the exact source tree instead of submitting an invalid empty createTree request. Non-empty materialization, bounded retry, protected-ref fallback, npm publication, permissions, and publication targets remain unchanged. Provider failures retain only a safe status-scoped code, avoiding both raw provider details and an undiagnosable generic failure. Focused tests isolate the zero-delta and failure-classification behavior in a new 99-line test surface; the exact inventory grows by 15 hand-maintained source lines to 170637 and grants no new workflow, credential, provider permission, merge authority, capability, or publication target.",
     "rationale": "Bounded modules separate candidate, evidence, native proof and execution, canonical failure verification, closed-set execution transfer, process-boundary verification, Warrant state and qualification, authority state, qualification, Landing acquisition, verified-attempt admission, Landing settlement and fence validation, provider attempt and heartbeat readback, sealed terminal evidence, hosted heartbeat, resume, store, options, command-specific adapters, and CLI orchestration responsibilities. The protected delivery workflow gives candidate and seal jobs no provider write credential, recursively rejects transfer drift, scopes every transfer artifact to the exact provider run attempt, chains every durable heartbeat state and receipt root on a distinct hosted runner domain, and permits qualification or exact failure settlement only after the finalizer verifies live jobs and the latest durable authority state. Public Landing admission and heartbeat always perform non-injectable fresh exact-attempt provider readback, tolerate only a not-yet-materialized seal job while retaining exact native and duplicate-job rejection, and heartbeat-loss coordination never invokes GitHub's run-scoped cancellation API where a successor rerun could race. The hosted process boundary anchors trust in the kernel-resolved versioned Runner.Worker path while accepting an equivalent argv-zero spelling with the same basename; its public boundary marker is allowed only at the one exact non-secret value, so a forged value under the same credential-like name still fails closed. The credentialless transfer seal validates the rooted native reuse decision against the Warrant-bound source, closure, dependency, toolchain, environment and command inputs; qualifiedBase stays in the proof and decision where it is rooted and later independently rechecked, rather than being assumed on the Warrant schema. V2 mutation cannot initialize a second empty authority beside a legacy ref: migration reads and roots the canonical live v1 ref, rechecks it, applies the explicit configured v2 policy, and atomically replaces its bytes through one expected-old non-force update, so old v1 controllers fail closed while the prior commit remains immutable history. Candidate ancestry classifies the GitHub artifact runtime token as credential authority. Every Landing settlement, including an unexpired fence, requires product-owned terminal readback. Terminal cleanup reads the immutable historical attempt, derives workflow and hosted Landing job identity from live run data, reads the exact protected ref head and compares containment against that immutable SHA, and seals merged only when the admitted merge-group head is contained by that protected base; a later different-head merge settles the old attempt as dequeued. Terminal normalization preserves transfer, finalizer boundary, native and seal job, admitted provider attempt, protected-base head, containment result, and terminal readback coordinates. The public reusable workflow truthfully retains its single-flight v1 authority without advertising v2 migration, while bounded v2 remains a separate opt-in CLI, Node API, and schema contract; the tracked self-caller stays on public v4-alpha with matching stable and alpha locks, and transient train selection is dispatch-only. Next-development parity adds one versioned transition authority, one durable controller, one bounded reservation adapter, and pure public-contract recovery evidence while retaining the existing thin floating-channel callers byte-for-byte. The floating-consumer gate reuses the existing contract-world evaluator so SHA drift passes only under the selected lock's compatibility policy, breaking surface drift still fails closed, and external certification reconstructs the receipt from the observed workflow SHA rather than the lock's historical evidence SHA. Tail reseal adds no Stage Capsule effect or general rebuild authority: it verifies the exact retained four-platform bytes, admits one known macOS tail failure through live provider readback, fences signing and finalization to explicit credentials and Warrant identity, and requires standard candidate Passport plus provider and protected readback. Compatibility Facts parity isolates canonical encoding, temporal verification, lifecycle validation, fixture projection, public authority projection, and CLI adaptation into bounded modules; legacy digest and proof arrays are derived only from exact current Fact lineage. Publication Rehearsal adds no production release authority: the content-addressed capsule contract binds source, candidate, manifest, config, canonical data-only provider bindings, provider policy, observations and core version separately from filesystem, runtime and rehearsal-only provider authority; simulate, replay and explicitly authorized provider rehearsal all reuse the release-tail planner, while same-commit local dogfood resolves the new reusable contract and exact current runtime before external callers remain on floating v4-alpha. Cross-runtime candidate recovery preserves original runtime and provider roots and creates resume lineage only after exact public ref, tag, ancestry, npm version and integrity readback. Adopter Delivery restores the reviewed public v3 gate, drivers, Passport binding, N-1 bootstrap and exact archive loader through one public v4 surface while keeping provider and release authority explicit non-claims. Floating Alpha bootstrap uses only the existing exact resolver and protected Alpha private shell to move an otherwise stale floating shell, retains public v4 stable promotion, and removes itself after protected readback. CI lane change-budget enforcement adds a bounded parser, evaluator, guard, and tests without creating another merge authority.",
     "governance": "legacy-debt-sunset-2026q4"
   },

package/architecture/v4-universal-workflow-bootstrap.json

@@ -156,7 +156,7 @@
   ],
   "migration": {
     "compatibilityFacadeGenerator": "scripts/generate-v4-universal-workflow-facades.mjs",
-    "facadeSourceRevision": "7f9ce215cf05bfd6b190624bfc1de8545065767d",
+    "facadeSourceRevision": "06a2d9f7d5753c5c9b2bf0e7f0e3220fc18cc183",
     "channelGeneratedFacades": [
       ".github/workflows/build.yml",
       ".github/workflows/release-candidate-promote.yml"

package/architecture/v4-universal-workflow-train-admission.json

@@ -24,11 +24,11 @@
   },
   "contractRoots": [
     "sha256:4563c954e84d34b73e6683981e1e23dd6b8bb9b9551392b4e393efb624cc980e",
+    "sha256:639c9b8e68e0735030450d9014937dc0d427dfc105dafc6f1a659be426437ce5",
     "sha256:65a0c2fc3faecaddf5076fff086b5d6e12eb9ba27796efc10aed19f2d93b9457",
     "sha256:b6737ed958e8f53f7770b1c214c092591573ad63af41e05797117d9b7b212ed8",
     "sha256:b94023c4abe4216765198adcaefb4825874a4d9053be096d35a53d6821128b52",
     "sha256:ca0592275354f0690756e3f11accdd23615987827c346618c50c2e8a2807ad4d",
-    "sha256:cf3c5a79de580525953e1fc02b2b2937a1d1a50219b4464510dd5b4725ca9ca5",
     "sha256:d6ad9cf661c0ba3825cabdc7185fd122a60fc1929dfc799cda3352650588663f"
   ],
   "targetRef": "dev/v4/v4.0",

package/dist/site/buildchain-contract.json

@@ -4,7 +4,7 @@
   "product": {
     "name": "Buildchain",
     "package": "@kungfu-tech/buildchain",
-    "version": "4.0.2-alpha.26",
+    "version": "4.0.2-alpha.28",
     "repository": "https://github.com/kungfu-systems/buildchain"
   },
   "majorLine": "v4",
@@ -1646,7 +1646,7 @@
         "resume-from-candidate-run is fail-closed and uses a fresh caller event instead of rerunning a frozen startup graph"
       ],
       "breakingDigest": "sha256:9db8dd07152855d03ff30f9c571438593c689d3e8139fa45431d000f548242f5",
-      "auditDigest": "sha256:210ea08ce25f27bb56bca50291c7280d6c65f3405c56a2b7d3b21cbb0f620f38",
+      "auditDigest": "sha256:177b3c50685405e5ed2bf1ac893469fdb3a27e7b03d55025611b2985028cd8cf",
       "compatibleBreakingDigests": [
         "sha256:aa30f22e3af0a89841310bdbdc900844dd95a66974db173fa140a71bbd7e82c0"
       ],
@@ -1863,7 +1863,7 @@
         "no consumer command, script, shell, checkout, or executable tail hook is accepted"
       ],
       "breakingDigest": "sha256:9229eb3a000fb408feb6b8793c209c77afbf9327026467d68954470e22e4f8f4",
-      "auditDigest": "sha256:a8c58825798d6bc078154c063db2d705c5b5cb6eadd58c8fc7a075d8c3948429"
+      "auditDigest": "sha256:4d51bce0908155875a70f8168fc545fe164bd1b6a4146a3de56b4dd7a5c1758c"
     },
     {
       "contractVersion": 1,
@@ -5213,7 +5213,7 @@
         "missing receipts are non-qualifying and must not be represented as a successful controller run"
       ],
       "breakingDigest": "sha256:015d8de793adbd4c539416be7d7512e18cc92097e629b0203fa06d2c183e98bd",
-      "auditDigest": "sha256:210ea08ce25f27bb56bca50291c7280d6c65f3405c56a2b7d3b21cbb0f620f38"
+      "auditDigest": "sha256:177b3c50685405e5ed2bf1ac893469fdb3a27e7b03d55025611b2985028cd8cf"
     },
     {
       "contractVersion": 1,
@@ -5444,5 +5444,5 @@
   "compatibilityFactCutRoot": "sha256:f61b975d4a96c921cc4bd37fb3ed9a0596b47004fe34dc7219979d697e3707f9",
   "compatibilityProofRegistryRoot": "sha256:b7194b811e4d3af2df4390bc4d1731e16a86215bd64ee18cb630dd5492f4fb63",
   "compatibilityDigest": "sha256:20411029d83211dff426fb6535a608902129844a5ccb4788db77d3f81becb839",
-  "contractDigest": "sha256:fd01a2837c5d6e06d6f15b83ca00b8de9d512f2a0677d1a23dd57095041f71ed"
+  "contractDigest": "sha256:a20ed3dbffe4211e82a368c28a78d3ddea7d147d0034482508e078af674e16fb"
 }

package/dist/site/buildchain-site.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "contract": "kungfu-buildchain-site-bundle",
-  "generatedAt": "2026-09-02T19:46:24.000Z",
-  "publishedAt": "2026-09-02T19:46:24.000Z",
+  "generatedAt": "2026-09-03T11:14:58.000Z",
+  "publishedAt": "2026-09-03T11:14:58.000Z",
   "reproducible": true,
   "timestampPolicy": "ci-injected",
   "deterministicInputs": [
@@ -19,7 +19,7 @@
     "declared Buildchain surface manifest contract"
   ],
   "sourceDateEpoch": "0",
-  "sourceRevision": "6018a102de6efeb4999298db8e5539fe9dd154f5",
+  "sourceRevision": "6b0935c5663d38893a9ff4688fed4cbbe6b9f0ac",
   "timestampPolicyDetails": {
     "contract": "kungfu-buildchain-surface-timestamp-policy",
     "timestampFields": [
@@ -37,7 +37,7 @@
   },
   "package": {
     "name": "@kungfu-tech/buildchain",
-    "version": "4.0.2-alpha.26",
+    "version": "4.0.2-alpha.28",
     "versionSource": "package.json#version"
   },
   "source": {

package/dist/site/kfd-claims.json

@@ -21,7 +21,7 @@
     "contract": "kungfu-buildchain-public-surface-reverse-audit",
     "path": "dist/site/public-surface-audit.json",
     "status": "passed",
-    "sha256": "2315b79a4610e95330e4f3f5ac38d36653de4dec938f539bbb67e43610c71a71",
+    "sha256": "976d0c0c6c20b2c98342de9a7cabd7df9c242ae3f47a58b2144621c25b433d85",
     "summary": {
       "cliCommandCount": 117,
       "workflowCount": 74,
@@ -246,7 +246,7 @@
       "contract": "kungfu-buildchain-public-surface-reverse-audit",
       "path": "dist/site/public-surface-audit.json",
       "status": "passed",
-      "sha256": "2315b79a4610e95330e4f3f5ac38d36653de4dec938f539bbb67e43610c71a71",
+      "sha256": "976d0c0c6c20b2c98342de9a7cabd7df9c242ae3f47a58b2144621c25b433d85",
       "summary": {
         "cliCommandCount": 117,
         "workflowCount": 74,
@@ -6234,7 +6234,7 @@
           "visibility": "public",
           "participantFacing": true,
           "public": true,
-          "inputCount": 30,
+          "inputCount": 31,
           "inputs": [
             "artifact-paths",
             "candidate-build-summary-path",
@@ -6243,6 +6243,7 @@
             "mutation-token",
             "product-publication-intent-path",
             "publication-qualification-path",
+            "publish-artifact-kind",
             "publish-auth",
             "publish-command",
             "publish-dist-tag",

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.26",
+    "version": "4.0.2-alpha.28",
     "repository": "https://github.com/kungfu-systems/buildchain"
   },
   "source": {

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

@@ -3271,6 +3271,7 @@
           "mutation-token",
           "product-publication-intent-path",
           "publication-qualification-path",
+          "publish-artifact-kind",
           "publish-auth",
           "publish-command",
           "publish-dist-tag",
@@ -3295,7 +3296,7 @@
           "target-sha",
           "token"
         ],
-        "inputCount": 30
+        "inputCount": 31
       },
       {
         "id": "validate-config",
@@ -8904,7 +8905,7 @@
     "workflowRegistryPath": "dist/site/workflow-registry.json",
     "pageRegistryPath": "dist/site/page-registry.json",
     "cliRegistryDigest": "fbc23073bbae240489a2f826b2c26daadc58e704050c5f8df366509f5c5a1c3e",
-    "workflowRegistryDigest": "33010f77280e24843b6ad4331e2e12694da78ca75cdf9e5857ca176e84e7ec86",
+    "workflowRegistryDigest": "d89f5d875f63d04ba2ab055fe3741acb72c5a537e53db8af9df3fe3170317d52",
     "pageRegistryDigest": "ae0b1b9c7b883027cf53403221ff2fe2e41ad1aa4d16851d4550e89947d6d6d7"
   },
   "comparison": {

package/dist/site/publication-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "contract": "kungfu-buildchain-publication-release-registry",
-  "generatedAt": "2026-09-02T19:46:24.000Z",
-  "publishedAt": "2026-09-02T19:46:24.000Z",
+  "generatedAt": "2026-09-03T11:14:58.000Z",
+  "publishedAt": "2026-09-03T11:14:58.000Z",
   "reproducible": true,
   "timestampPolicy": "ci-injected",
   "deterministicInputs": [
@@ -19,7 +19,7 @@
     "declared Buildchain surface manifest contract"
   ],
   "sourceDateEpoch": "0",
-  "sourceRevision": "6018a102de6efeb4999298db8e5539fe9dd154f5",
+  "sourceRevision": "6b0935c5663d38893a9ff4688fed4cbbe6b9f0ac",
   "timestampPolicyDetails": {
     "contract": "kungfu-buildchain-surface-timestamp-policy",
     "timestampFields": [
@@ -32,7 +32,7 @@
   },
   "package": {
     "name": "@kungfu-tech/buildchain",
-    "version": "4.0.2-alpha.26",
+    "version": "4.0.2-alpha.28",
     "versionSource": "package.json#version"
   },
   "sourceKind": "package-site-bundle",

package/dist/site/site-manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "contract": "kungfu-buildchain-site-manifest",
-  "generatedAt": "2026-09-02T19:46:24.000Z",
-  "publishedAt": "2026-09-02T19:46:24.000Z",
+  "generatedAt": "2026-09-03T11:14:58.000Z",
+  "publishedAt": "2026-09-03T11:14:58.000Z",
   "reproducible": true,
   "timestampPolicy": "ci-injected",
   "deterministicInputs": [
@@ -19,7 +19,7 @@
     "declared Buildchain surface manifest contract"
   ],
   "sourceDateEpoch": "0",
-  "sourceRevision": "6018a102de6efeb4999298db8e5539fe9dd154f5",
+  "sourceRevision": "6b0935c5663d38893a9ff4688fed4cbbe6b9f0ac",
   "timestampPolicyDetails": {
     "contract": "kungfu-buildchain-surface-timestamp-policy",
     "timestampFields": [
@@ -37,7 +37,7 @@
   },
   "package": {
     "name": "@kungfu-tech/buildchain",
-    "version": "4.0.2-alpha.26",
+    "version": "4.0.2-alpha.28",
     "versionSource": "package.json#version"
   },
   "entrypoint": "buildchain-site.json",

package/dist/site/workflow-registry.json

@@ -1926,7 +1926,7 @@
       "status": "preview",
       "owner": "buildchain-workflows",
       "maturity": "preview",
-      "introducedVersion": "4.0.2-alpha.26",
+      "introducedVersion": "4.0.2-alpha.28",
       "compatibilityPromise": "preserved-through-the-v3-major-line",
       "deprecationReplacement": "",
       "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
@@ -1947,7 +1947,7 @@
       "status": "preview",
       "owner": "buildchain-workflows",
       "maturity": "preview",
-      "introducedVersion": "4.0.2-alpha.26",
+      "introducedVersion": "4.0.2-alpha.28",
       "compatibilityPromise": "preserved-through-the-v3-major-line",
       "deprecationReplacement": "",
       "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
@@ -1968,7 +1968,7 @@
       "status": "preview",
       "owner": "buildchain-workflows",
       "maturity": "preview",
-      "introducedVersion": "4.0.2-alpha.26",
+      "introducedVersion": "4.0.2-alpha.28",
       "compatibilityPromise": "preserved-through-the-v3-major-line",
       "deprecationReplacement": "",
       "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
@@ -2019,7 +2019,7 @@
       "status": "preview",
       "owner": "buildchain-workflows",
       "maturity": "preview",
-      "introducedVersion": "4.0.2-alpha.26",
+      "introducedVersion": "4.0.2-alpha.28",
       "compatibilityPromise": "preserved-through-the-v3-major-line",
       "deprecationReplacement": "",
       "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
@@ -3470,6 +3470,7 @@
         "mutation-token",
         "product-publication-intent-path",
         "publication-qualification-path",
+        "publish-artifact-kind",
         "publish-auth",
         "publish-command",
         "publish-dist-tag",
@@ -3494,7 +3495,7 @@
         "target-sha",
         "token"
       ],
-      "inputCount": 30,
+      "inputCount": 31,
       "capabilityGroup": "api-cli-reference",
       "status": "active",
       "owner": "buildchain-actions",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kungfu-tech/buildchain",
-  "version": "4.0.2-alpha.26",
+  "version": "4.0.2-alpha.28",
   "private": false,
   "description": "Buildchain Release Passport, release governance, CLI toolkit, and site facts.",
   "repository": "https://github.com/kungfu-systems/buildchain",

package/packages/core/v4-product-publication.js

@@ -41,6 +41,29 @@ function channelName(value) {
   fail(`unsupported channel '${value}'`);
 }
 
+function publicationArtifactKind(value) {
+  if (!value || value === "npm") return "npm";
+  if (value === "custom") return "custom";
+  fail(`unsupported artifactKind '${value}'`);
+}
+
+function publicationProductCoordinates({
+  artifactKind,
+  packageName,
+  distTag,
+  sealedBundleRoot,
+}) {
+  if (artifactKind === "custom") return { artifactKind };
+  const normalizedDistTag = requiredString(distTag, "distTag");
+  if (!/^[a-z0-9][a-z0-9._-]*$/u.test(normalizedDistTag))
+    fail("distTag must be an npm dist-tag");
+  return {
+    packageName: requiredString(packageName, "packageName"),
+    distTag: normalizedDistTag,
+    sealedBundleRoot: requiredRoot(sealedBundleRoot, "sealedBundleRoot"),
+  };
+}
+
 function assertLane({ channel, targetRef, version }) {
   const expression =
     channel === "alpha"
@@ -83,6 +106,7 @@ export function selectV4ProductPublicationIntent({
   sourceSha,
   sourceTimestamp,
   repository,
+  artifactKind = "npm",
   packageName,
   distTag,
   sealedBundleRoot,
@@ -102,10 +126,15 @@ export function selectV4ProductPublicationIntent({
   );
   if (Number.isNaN(Date.parse(normalizedTimestamp)))
     fail("sourceTimestamp must be an ISO timestamp");
-  const normalizedPackageName = requiredString(packageName, "packageName");
-  const normalizedDistTag = requiredString(distTag, "distTag");
-  if (!/^[a-z0-9][a-z0-9._-]*$/u.test(normalizedDistTag))
-    fail("distTag must be an npm dist-tag");
+  const normalizedArtifactKind = publicationArtifactKind(
+    String(artifactKind || "").trim(),
+  );
+  const productCoordinates = publicationProductCoordinates({
+    artifactKind: normalizedArtifactKind,
+    packageName,
+    distTag,
+    sealedBundleRoot,
+  });
   if (!Array.isArray(observedVersions))
     fail("observedVersions must be an array");
   const candidate = parseVersion(candidateVersion, "candidateVersion");
@@ -128,12 +157,16 @@ export function selectV4ProductPublicationIntent({
   } else if (normalizedChannel === "alpha") {
     if (candidate.alpha === null)
       fail("fresh alpha publication requires an alpha candidate version");
-    const highest = observed.reduce(
-      (current, entry) =>
-        Math.max(current, observedAlphaNumber(entry, candidate) ?? -1),
-      candidate.alpha,
-    );
-    version = `${candidate.major}.${candidate.minor}.${candidate.patch}-alpha.${highest + 1}`;
+    if (normalizedArtifactKind === "custom") {
+      version = candidate.value;
+    } else {
+      const highest = observed.reduce(
+        (current, entry) =>
+          Math.max(current, observedAlphaNumber(entry, candidate) ?? -1),
+        candidate.alpha,
+      );
+      version = `${candidate.major}.${candidate.minor}.${candidate.patch}-alpha.${highest + 1}`;
+    }
   } else {
     version = `${candidate.major}.${candidate.minor}.${candidate.patch}`;
   }
@@ -145,9 +178,7 @@ export function selectV4ProductPublicationIntent({
     sourceSha,
     sourceTimestamp: new Date(normalizedTimestamp).toISOString(),
     repository,
-    packageName: normalizedPackageName,
-    distTag: normalizedDistTag,
-    sealedBundleRoot: requiredRoot(sealedBundleRoot, "sealedBundleRoot"),
+    ...productCoordinates,
     requiredArtifactsRoot: requiredRoot(
       requiredArtifactsRoot,
       "requiredArtifactsRoot",
@@ -202,6 +233,7 @@ export function createV4ProductPublicationPlan({
     sourceSha: intent.sourceSha,
     sourceTimestamp: intent.sourceTimestamp,
     repository: intent.repository,
+    artifactKind: intent.artifactKind,
     packageName: intent.packageName,
     distTag: intent.distTag,
     sealedBundleRoot: intent.sealedBundleRoot,
@@ -231,18 +263,22 @@ export function createV4ProductPublicationPlan({
         stateRef,
       },
     },
-    {
-      id: "product.package.publish",
-      adapter: "npm-trusted-publishing",
-      authority: "oidc-provider-mutation",
-      target: {
-        packageName: intent.packageName,
-        version: intent.version,
-        distTag: intent.distTag,
-        sealedBundleRoot: intent.sealedBundleRoot,
-        requiredArtifactsRoot: intent.requiredArtifactsRoot,
-      },
-    },
+    ...(intent.artifactKind === "custom"
+      ? []
+      : [
+          {
+            id: "product.package.publish",
+            adapter: "npm-trusted-publishing",
+            authority: "oidc-provider-mutation",
+            target: {
+              packageName: intent.packageName,
+              version: intent.version,
+              distTag: intent.distTag,
+              sealedBundleRoot: intent.sealedBundleRoot,
+              requiredArtifactsRoot: intent.requiredArtifactsRoot,
+            },
+          },
+        ]),
     {
       id: "product.release-refs.converge",
       adapter: "github-release-refs",

package/scripts/v4-product-publication-intent.mjs

@@ -18,7 +18,8 @@ function readJson(file) {
   return JSON.parse(fs.readFileSync(path.resolve(file), "utf8"));
 }
 
-function packageName() {
+function packageName(artifactKind) {
+  if (artifactKind !== "npm") return "";
   const declared = env("BUILDCHAIN_PUBLISH_PACKAGE_MAIN");
   if (declared) return declared;
   const manifestPath = env("BUILDCHAIN_SEALED_BUNDLE_MANIFEST", true);
@@ -59,9 +60,14 @@ function writeOutput(name, value) {
 }
 
 export function resolveV4ProductPublicationIntent() {
-  const name = packageName();
+  const artifactKind = env("BUILDCHAIN_PUBLISH_ARTIFACT_KIND") || "npm";
+  const name = packageName(artifactKind);
   const sourceSha = env("BUILDCHAIN_SOURCE_SHA", true);
-  const manifest = readJson(env("BUILDCHAIN_SEALED_BUNDLE_MANIFEST", true));
+  const manifestPath = env(
+    "BUILDCHAIN_SEALED_BUNDLE_MANIFEST",
+    artifactKind === "npm",
+  );
+  const manifest = manifestPath ? readJson(manifestPath) : null;
   const requiredArtifacts = readJson(
     env("BUILDCHAIN_REQUIRED_ARTIFACTS_PATH", true),
   );
@@ -72,18 +78,19 @@ export function resolveV4ProductPublicationIntent() {
     sourceSha,
     sourceTimestamp: env("BUILDCHAIN_SOURCE_TIMESTAMP", true),
     repository: env("BUILDCHAIN_REPOSITORY", true),
+    artifactKind,
     packageName: name,
     distTag:
       env("BUILDCHAIN_PUBLISH_DIST_TAG") ||
       (channel === "alpha" ? "alpha" : "latest"),
-    sealedBundleRoot: manifest.root,
+    sealedBundleRoot: manifest?.root,
     requiredArtifactsRoot: v4ContentRoot(
       "v4-product-required-artifacts",
       requiredArtifacts,
     ),
     candidateVersion: env("BUILDCHAIN_CANDIDATE_VERSION", true),
     recoveredVersion: env("BUILDCHAIN_RECOVERED_PUBLICATION_VERSION"),
-    observedVersions: observedVersions(name),
+    observedVersions: artifactKind === "npm" ? observedVersions(name) : [],
   });
   const outputPath = path.resolve(
     env("BUILDCHAIN_PRODUCT_PUBLICATION_INTENT_PATH") ||
@@ -95,7 +102,7 @@ export function resolveV4ProductPublicationIntent() {
   writeOutput("exact-tag", intent.exactTag);
   writeOutput("intent-path", outputPath);
   writeOutput("intent-root", intent.intentRoot);
-  return { name, intent, outputPath };
+  return { name: name || artifactKind, intent, outputPath };
 }
 
 if (