@kungfu-tech/buildchain 2.10.3 → 2.10.4

package/scripts/generate-site-bundle.mjs

@@ -3,6 +3,7 @@ import fs from "node:fs";
 import path from "node:path";
 import crypto from "node:crypto";
 import { pathToFileURL } from "node:url";
+import { createRequire } from "node:module";
 import { createBuildchainContractWorld } from "../packages/core/buildchain-contract.js";
 import {
   BUILDCHAIN_AGENT_MANUALS,
@@ -23,6 +24,7 @@ const SITE_BUNDLE_CONTRACT = "kungfu-buildchain-site-bundle";
 const README_PATH = "README.md";
 const root = path.resolve(import.meta.dirname, "..");
 const outputDir = path.join(root, "dist", "site");
+const requireFromHere = createRequire(import.meta.url);
 
 function readText(rel) {
   return fs.readFileSync(path.join(root, rel), "utf8");
@@ -32,6 +34,13 @@ function readJson(rel) {
   return JSON.parse(readText(rel));
 }
 
+function readPackageKfdStandards() {
+  const standardsPath = requireFromHere.resolve("@kungfu-tech/kfd/standards.json", {
+    paths: [root],
+  });
+  return JSON.parse(fs.readFileSync(standardsPath, "utf8"));
+}
+
 function writeJson(filePath, value) {
   fs.mkdirSync(path.dirname(filePath), { recursive: true });
   fs.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\n`);
@@ -247,7 +256,7 @@ const CAPABILITY_GROUPS = Object.freeze([
   {
     id: "kfd-trust",
     title: "KFD Trust and Surface Closure",
-    summary: "Discover KFD-1, KFD-2, and KFD-3 support, public surface reverse audits, and product capability queries.",
+    summary: "Discover KFD trust support, public surface reverse audits, and product capability queries.",
     audience: ["agent", "maintainer"],
     maturity: "stable",
   },
@@ -921,11 +930,7 @@ function buildSiteBundle() {
     instruction: "Use this bundle as the package-owned fact source for Buildchain pages. Do not infer current release mechanics from prose alone.",
   };
   const badgeEndpointRegistry = createReadmeBadgeEndpointRegistry({
-    kfdSpecs: [
-      { key: "kfd-1", label: "KFD-1", text: "contract world" },
-      { key: "kfd-2", label: "KFD-2", text: "release trust passport" },
-      { key: "kfd-3", label: "KFD-3", text: "collaboration interface" },
-    ],
+    kfdStandards: readPackageKfdStandards(),
   });
 
   const homepageSections = [

package/scripts/web-surface-production-release-pr.mjs

@@ -1,4 +1,6 @@
 #!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
 
 function requiredString(value, name) {
   const normalized = String(value || "").trim();
@@ -28,6 +30,27 @@ function parseJson(value, name) {
   }
 }
 
+function readArg(name, fallback = "") {
+  const index = process.argv.indexOf(`--${name}`);
+  if (index === -1) return fallback;
+  return process.argv[index + 1] || "";
+}
+
+function readJsonFile(filePath, name) {
+  const normalized = requiredString(filePath, name);
+  try {
+    return JSON.parse(fs.readFileSync(path.resolve(normalized), "utf8"));
+  } catch (error) {
+    throw new Error(`${name} must point to valid JSON: ${error.message}`);
+  }
+}
+
+function writeJsonFile(filePath, value) {
+  const resolved = path.resolve(requiredString(filePath, "output"));
+  fs.mkdirSync(path.dirname(resolved), { recursive: true });
+  fs.writeFileSync(resolved, `${JSON.stringify(value, null, 2)}\n`);
+}
+
 function runUrl({ serverUrl = "", repository = "", runId = "" } = {}) {
   if (!serverUrl || !repository || !runId) return "";
   return `${serverUrl.replace(/\/$/, "")}/${repository}/actions/runs/${runId}`;
@@ -39,6 +62,51 @@ function urlsFromResult(result = {}) {
   return result.url ? { default: result.url } : {};
 }
 
+export function compactProductionReleasePrSummary(result = {}) {
+  const manifest = result.manifest && typeof result.manifest === "object" ? result.manifest : {};
+  return {
+    schemaVersion: 1,
+    contract: "kungfu-buildchain-web-surface-production-release-pr-summary",
+    sourceContract: result.contract || "",
+    channel: result.channel || manifest.channel || "",
+    alias: result.alias || manifest.alias || "",
+    status: result.status || "",
+    applyMode: result.applyMode || "",
+    actor: result.actor || "",
+    runId: result.runId || "",
+    appliedAt: result.appliedAt || "",
+    url: result.url || "",
+    urls: urlsFromResult(result),
+    sourceSha: result.sourceSha || manifest.sourceSha || "",
+    artifactHash: result.artifactHash || manifest.artifactHash || "",
+    target: result.target || "",
+    manifestKey: result.manifestKey || "",
+    surfaceBindings: Array.isArray(result.surfaceBindings)
+      ? result.surfaceBindings.map((binding) => ({
+          surface: binding.surface || "",
+          pathPrefix: binding.pathPrefix || "",
+          objectPrefix: binding.objectPrefix || "",
+          url: binding.url || "",
+          manifestKey: binding.manifestKey || "",
+          accessControl: binding.accessControl || "",
+          healthStrategy: binding.healthStrategy || "",
+        }))
+      : [],
+  };
+}
+
+export function readStagingReleasePrSummary(env = process.env) {
+  const summaryPath = optionalString(env.STAGING_RELEASE_PR_SUMMARY_PATH);
+  if (summaryPath) {
+    return compactProductionReleasePrSummary(readJsonFile(summaryPath, "STAGING_RELEASE_PR_SUMMARY_PATH"));
+  }
+  const resultPath = optionalString(env.STAGING_APPLY_RESULT_PATH);
+  if (resultPath) {
+    return compactProductionReleasePrSummary(readJsonFile(resultPath, "STAGING_APPLY_RESULT_PATH"));
+  }
+  return compactProductionReleasePrSummary(parseJson(env.STAGING_APPLY_RESULT_JSON, "STAGING_APPLY_RESULT_JSON"));
+}
+
 export function releaseBranchName({ prefix = "release/", channel = "production", sourceSha = "" } = {}) {
   const normalizedPrefix = optionalString(prefix) || "release/";
   const normalizedChannel = slugify(channel || "production");
@@ -276,7 +344,7 @@ export async function openProductionReleasePr({
 }
 
 export async function webSurfaceProductionReleasePrCli(env = process.env) {
-  const stagingResult = parseJson(env.STAGING_APPLY_RESULT_JSON, "STAGING_APPLY_RESULT_JSON");
+  const stagingResult = readStagingReleasePrSummary(env);
   const sourceSha = optionalString(stagingResult.sourceSha) || requiredString(env.GITHUB_SHA, "GITHUB_SHA");
   const result = await openProductionReleasePr({
     apiUrl: env.GITHUB_API_URL || "https://api.github.com",
@@ -307,9 +375,26 @@ export async function webSurfaceProductionReleasePrCli(env = process.env) {
   return result;
 }
 
+export function writeProductionReleasePrSummaryCli(env = process.env) {
+  const input = readArg("input", env.STAGING_APPLY_RESULT_PATH || "");
+  const output = readArg("output", env.STAGING_RELEASE_PR_SUMMARY_PATH || "");
+  const result = input
+    ? readJsonFile(input, "input")
+    : parseJson(env.STAGING_APPLY_RESULT_JSON, "STAGING_APPLY_RESULT_JSON");
+  const summary = compactProductionReleasePrSummary(result);
+  writeJsonFile(output, summary);
+  return summary;
+}
+
 if (import.meta.url === `file://${process.argv[1]}`) {
-  webSurfaceProductionReleasePrCli().catch((error) => {
+  try {
+    if (process.argv[2] === "write-summary") {
+      writeProductionReleasePrSummaryCli();
+    } else {
+      await webSurfaceProductionReleasePrCli();
+    }
+  } catch (error) {
     console.error(error.stack || error.message);
     process.exitCode = 1;
-  });
+  }
 }

package/scripts/web-surface.mjs

@@ -103,6 +103,42 @@ function writeFailureResult({ output, mode, cwd, error }) {
   return result;
 }
 
+export function compactWebSurfaceApplyResult(result = {}) {
+  const manifest = result.manifest && typeof result.manifest === "object" ? result.manifest : {};
+  return {
+    schemaVersion: 1,
+    contract: "kungfu-buildchain-web-surface-deploy-apply-summary",
+    sourceContract: result.contract || "",
+    channel: result.channel || manifest.channel || "",
+    alias: result.alias || manifest.alias || "",
+    applyMode: result.applyMode || "",
+    status: result.status || "",
+    actor: result.actor || "",
+    runId: result.runId || "",
+    appliedAt: result.appliedAt || "",
+    url: result.url || "",
+    urls: result.urls && typeof result.urls === "object" ? result.urls : {},
+    sourceSha: result.sourceSha || manifest.sourceSha || "",
+    artifactHash: result.artifactHash || manifest.artifactHash || "",
+    adapter: result.adapter || "",
+    target: result.target || "",
+    objectPrefix: result.objectPrefix || "",
+    manifestKey: result.manifestKey || "",
+    invalidationPaths: Array.isArray(result.invalidationPaths) ? result.invalidationPaths : [],
+    surfaceBindings: Array.isArray(result.surfaceBindings)
+      ? result.surfaceBindings.map((binding) => ({
+          surface: binding.surface || "",
+          pathPrefix: binding.pathPrefix || "",
+          objectPrefix: binding.objectPrefix || "",
+          url: binding.url || "",
+          manifestKey: binding.manifestKey || "",
+          accessControl: binding.accessControl || "",
+          healthStrategy: binding.healthStrategy || "",
+        }))
+      : [],
+  };
+}
+
 export function webSurfaceCli() {
   const mode = readArg("mode", process.env.BUILDCHAIN_WEB_SURFACE_MODE || "validate");
   const cwd = readArg("cwd", process.env.BUILDCHAIN_WORKDIR || process.cwd());
@@ -184,6 +220,7 @@ export function webSurfaceCli() {
         ...(publishedAt ? { appliedAt: publishedAt } : {}),
       });
       writeJson(result, output);
+      const applySummary = compactWebSurfaceApplyResult(result);
       writeGitHubOutputs({
         "web-surface-channel": result.channel,
         "web-surface-alias": result.alias,
@@ -194,7 +231,8 @@ export function webSurfaceCli() {
         "web-surface-apply-status": result.status,
         "web-surface-manifest-json": JSON.stringify(result.manifest),
         "web-surface-bindings-json": JSON.stringify(result.surfaceBindings || []),
-        "web-surface-apply-result-json": JSON.stringify(result),
+        "web-surface-apply-summary-json": JSON.stringify(applySummary),
+        "web-surface-apply-result-json": JSON.stringify(applySummary),
       });
       assertApplySucceeded(result);
       return result;