@kungfu-tech/buildchain 2.3.0 → 2.3.1-alpha.1

package/scripts/aggregate-build-summary.mjs

@@ -47,13 +47,42 @@ export function aggregateBuildSummaryCli() {
       consumerVersion: readEnv("BUILDCHAIN_PUBLISH_SOURCE_CONSUMER_VERSION", ""),
       releaseManifest: readEnv("BUILDCHAIN_RELEASE_MANIFEST_JSON", ""),
     },
+    runtime: {
+      workflowShellRef: readEnv("BUILDCHAIN_WORKFLOW_SHELL_REF", ""),
+      requestedRef: readEnv("BUILDCHAIN_RUNTIME_REQUESTED_REF", ""),
+      ref: readEnv("BUILDCHAIN_RUNTIME_REF", ""),
+      sha: readEnv("BUILDCHAIN_RUNTIME_SHA", ""),
+      class: readEnv("BUILDCHAIN_RUNTIME_CLASS", ""),
+      override: readEnv("BUILDCHAIN_RUNTIME_OVERRIDE", "false") === "true",
+      trustDecision: readEnv("BUILDCHAIN_RUNTIME_TRUST_DECISION", ""),
+      rollbackRef: readEnv("BUILDCHAIN_ROLLBACK_REF", ""),
+    },
     platformCount: manifests.length,
     fileCount: manifests.reduce((sum, manifest) => sum + Number(manifest.summary?.fileCount || 0), 0),
     totalBytes: manifests.reduce((sum, manifest) => sum + Number(manifest.summary?.totalBytes || 0), 0),
+    observability: {
+      lifecycle: {
+        stages: manifests.reduce((acc, manifest) => {
+          for (const [stage, value] of Object.entries(manifest.observability?.lifecycle?.stages || {})) {
+            acc[stage] = acc[stage] || { durationMs: 0, eventCount: 0 };
+            acc[stage].durationMs += Number(value.durationMs || 0);
+            acc[stage].eventCount += Number(value.eventCount || 0);
+          }
+          return acc;
+        }, {}),
+        topSlowSpans: manifests
+          .flatMap((manifest) => manifest.observability?.lifecycle?.topSlowSpans || [])
+          .sort((left, right) => Number(right.durationMs || 0) - Number(left.durationMs || 0))
+          .slice(0, 10),
+        warningCount: manifests.reduce((sum, manifest) => sum + Number(manifest.observability?.lifecycle?.warningCount || 0), 0),
+        errorCount: manifests.reduce((sum, manifest) => sum + Number(manifest.observability?.lifecycle?.errorCount || 0), 0),
+      },
+    },
     platforms: manifests.map((manifest, index) => ({
       artifactName: manifest.artifactName,
       platform: manifest.platform,
       summary: manifest.summary,
+      observability: manifest.observability,
       expectedArtifacts: manifest.expectedArtifacts,
       manifestPath: manifestFiles[index],
     })),
@@ -73,6 +102,7 @@ export function aggregateBuildSummaryCli() {
       totalBytes: summary.totalBytes,
       publishGate: summary.publishGate,
       publishSource: summary.publishSource,
+      runtime: summary.runtime,
     }),
   });
   return summary;

package/scripts/aggregate-diagnostics-summary.mjs

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { findJsonFiles, writeGitHubOutputs } from "./build-contract-core.mjs";
+import {
+  formatDiagnosticsSummaryTable,
+  summarizeDiagnosticsArtifacts,
+} from "../packages/core/diagnostics.js";
+
+function readEnv(name, fallback = "") {
+  return process.env[name] || fallback;
+}
+
+export function aggregateDiagnosticsSummaryCli() {
+  const inputRoot = path.resolve(readEnv("BUILDCHAIN_DIAGNOSTICS_INPUT", ".buildchain/downloaded-diagnostics"));
+  const outputPath = path.resolve(readEnv("BUILDCHAIN_DIAGNOSTICS_OUTPUT", ".buildchain/artifacts/diagnostics-summary.json"));
+  const expectedPlatformCount = Number(readEnv("BUILDCHAIN_PLATFORM_COUNT", "0"));
+  const diagnosticsFiles = findJsonFiles(inputRoot)
+    .filter((file) => path.basename(file) === "diagnostics.json")
+    .sort();
+  if (expectedPlatformCount > 0 && diagnosticsFiles.length !== expectedPlatformCount) {
+    throw new Error(
+      `expected ${expectedPlatformCount} platform diagnostics artifacts, found ${diagnosticsFiles.length} under ${inputRoot}`,
+    );
+  }
+  const summary = summarizeDiagnosticsArtifacts(diagnosticsFiles);
+  fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+  fs.writeFileSync(outputPath, `${JSON.stringify(summary, null, 2)}\n`);
+  process.stdout.write(`${formatDiagnosticsSummaryTable(summary)}\n`);
+  writeGitHubOutputs({
+    "diagnostics-summary-path": path.relative(process.cwd(), outputPath).split(path.sep).join("/"),
+    "diagnostics-platform-count": String(summary.count),
+    "diagnostics-summary-json": JSON.stringify({
+      contract: summary.contract,
+      count: summary.count,
+      totalWarningCount: summary.totalWarningCount,
+      totalErrorCount: summary.totalErrorCount,
+      diagnosticsManifestWarningCount: summary.diagnosticsManifestWarningCount,
+      diagnosticsContractWarningCount: summary.diagnosticsContractWarningCount,
+      slowestPlatforms: summary.slowestPlatforms,
+    }),
+  });
+  return summary;
+}
+
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  try {
+    aggregateDiagnosticsSummaryCli();
+  } catch (error) {
+    console.error(`::error::${String(error.message || error).replace(/\r?\n/g, "%0A")}`);
+    process.exitCode = 1;
+  }
+}

package/scripts/check-inventory.mjs

@@ -66,6 +66,9 @@ if (rootPackage.bin?.buildchain !== "./bin/buildchain.mjs") {
 if (rootPackage.exports?.["."] !== "./packages/core/index.js") {
   throw new Error("root package must export packages/core/index.js");
 }
+if (rootPackage.exports?.["./diagnostics"] !== "./packages/core/diagnostics.js") {
+  throw new Error("root package must export @kungfu-tech/buildchain/diagnostics");
+}
 if (rootPackage.exports?.["./logging"] !== "./packages/core/logging.js") {
   throw new Error("root package must export @kungfu-tech/buildchain/logging");
 }
@@ -91,6 +94,8 @@ for (const expectedFile of ["dist/site/", "docs/install.md", "docs/binary-distri
 const cliSource = fs.readFileSync(path.join(root, "bin/buildchain.mjs"), "utf8");
 const coreIndexSource = fs.readFileSync(path.join(root, "packages/core/index.js"), "utf8");
 const versioningDoc = fs.readFileSync(path.join(root, "docs/versioning.md"), "utf8");
+const cliDoc = fs.readFileSync(path.join(root, "docs/cli.md"), "utf8");
+const installDoc = fs.readFileSync(path.join(root, "docs/install.md"), "utf8");
 if (!cliSource.startsWith("#!/usr/bin/env node")) {
   throw new Error("bin/buildchain.mjs must be executable with a node shebang");
 }
@@ -100,6 +105,9 @@ if (commonJsSourcePattern.test(cliSource)) {
 if (!coreIndexSource.includes("verifyBuildchainLogEvents")) {
   throw new Error("packages/core/index.js must export verifyBuildchainLogEvents");
 }
+if (!coreIndexSource.includes("collectBuildchainDiagnostics")) {
+  throw new Error("packages/core/index.js must export collectBuildchainDiagnostics");
+}
 for (const requiredSnippet of [
   "Release passport and binary distribution are a minor surface.",
   "`v2.2`",
@@ -110,6 +118,17 @@ for (const requiredSnippet of [
     throw new Error(`versioning doc missing required snippet: ${requiredSnippet}`);
   }
 }
+for (const [docName, docSource] of Object.entries({ "docs/cli.md": cliDoc, "docs/install.md": installDoc })) {
+  for (const requiredSnippet of [
+    "minimumReleaseAgeExclude",
+    "@kungfu-tech/buildchain@2.2.5",
+    "package/version-specific",
+  ]) {
+    if (!docSource.includes(requiredSnippet)) {
+      throw new Error(`${docName} missing fresh Buildchain package pin guidance: ${requiredSnippet}`);
+    }
+  }
+}
 const releaseLineDryRunScript = fs.readFileSync(path.join(root, "scripts/release-line-dry-run.mjs"), "utf8");
 const standaloneBinaryScript = fs.readFileSync(path.join(root, "scripts/build-standalone-binary.mjs"), "utf8");
 for (const requiredSnippet of [

package/scripts/generate-site-bundle.mjs

@@ -69,6 +69,7 @@ function buildSiteBundle() {
       { id: "collect-github-release", usage: "buildchain collect github-release --tag <tag>", purpose: "Collect release assets into a release passport." },
       { id: "verify-release-passport", usage: "buildchain verify release-passport <file-or-url>", purpose: "Fail closed unless a release passport and its evidence are complete." },
       { id: "logging", usage: "buildchain log|mark|span|verify observability-log", purpose: "Emit timestamped build events, summarize logs, and enforce required phases." },
+      { id: "diagnostics-summary", usage: "buildchain diagnostics summary <diagnostics.json>...", purpose: "Summarize small diagnostics artifacts into JSON and a cross-platform lifecycle timing table." },
       { id: "npm-dry-run", usage: "buildchain npm dry-run --json", purpose: "Verify npm publish shape before a release transaction." },
     ],
   };

package/scripts/init-repo.mjs

@@ -112,6 +112,13 @@ commands = [
 commands = [
   "ctest --test-dir build --output-on-failure",
 ]
+
+[diagnostics.native]
+enabled = true
+sample_process_tree = false
+compiler_cache = "auto"
+expected_tools = ["ccache", "sccache", "clang", "cl", "cmake", "ninja"]
+artifact_dirs = ["build", "dist"]
 `;
 }
 
@@ -209,6 +216,12 @@ function workflowYaml({ runnerPreset, artifactName }) {
   return `name: Build
 
 on:
+  workflow_dispatch:
+    inputs:
+      buildchain-ref:
+        description: "Temporary Buildchain runtime ref for trusted manual validation"
+        required: false
+        default: ""
   pull_request:
   push:
     branches:
@@ -225,6 +238,7 @@ jobs:
     uses: ${BUILDCHAIN_WORKFLOW_REF}
     with:
       working-directory: "."
+      buildchain-ref: \${{ inputs.buildchain-ref || '' }}
       runner-preset: "${runnerPreset}"
       artifact-name-template: "${artifactName}"
       artifact-paths: |

package/scripts/npm-publish-dry-run.mjs

@@ -50,6 +50,11 @@ function parsePackResult(stdout) {
   const pack = Array.isArray(parsed) ? parsed[0] : parsed;
   const files = Array.isArray(pack?.files) ? pack.files : [];
   const bin = files.find((file) => file.path === "bin/buildchain.mjs");
+  const fileEntries = files.map((file) => ({
+    path: file.path,
+    size: file.size,
+    mode: file.mode,
+  }));
   return {
     filename: pack?.filename || "",
     name: pack?.name || "",
@@ -58,6 +63,7 @@ function parsePackResult(stdout) {
     unpackedSize: pack?.unpackedSize || 0,
     entryCount: pack?.entryCount || files.length,
     bundled: pack?.bundled || [],
+    files: fileEntries,
     binMode: bin?.mode,
   };
 }