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

package/packages/core/index.js

@@ -1,6 +1,7 @@
 export {
   discoverConfiguredVersionStateFiles,
   getLifecycleStage,
+  getNativeDiagnosticsProfile,
   getPublishContract,
   getVersionStrategy,
   loadBuildchainConfig,
@@ -53,6 +54,37 @@ export {
   verifyBuildchainLogEvents,
 } from "./logging.js";
 
+export {
+  BUILDCHAIN_ANCHORED_PACKAGE_RELEASE_VALIDATION_CONTRACT,
+  BUILDCHAIN_DIAGNOSTICS_CONTRACT,
+  BUILDCHAIN_DIAGNOSTICS_MANIFEST_CONTRACT,
+  BUILDCHAIN_DIAGNOSTICS_SUMMARY_CONTRACT,
+  BUILDCHAIN_LIFECYCLE_OBSERVABILITY_CONTRACT,
+  BUILDCHAIN_PROCESS_SAMPLE_REPORT_CONTRACT,
+  BUILDCHAIN_PROCESS_SAMPLE_SUMMARY_CONTRACT,
+  classifyProcessCommand,
+  collectBuildchainDiagnostics,
+  collectCacheDiagnostics,
+  collectCompilerCacheDiagnostics,
+  collectGitDiagnostics,
+  collectNativeDiagnostics,
+  collectProcessTreeSnapshot,
+  collectRunnerDiagnostics,
+  collectToolDiagnostics,
+  createDiagnosticsArtifact,
+  detectRequestedParallelism,
+  detectRequestedParallelismFromProcessSamples,
+  formatDiagnosticsSummaryTable,
+  readDiagnosticsArtifact,
+  redactDiagnosticsValue,
+  startProcessSampler,
+  summarizeDiagnosticsArtifacts,
+  summarizeLifecycleObservability,
+  summarizeProcessSamples,
+  validateAnchoredPackageRelease,
+  writeDiagnosticsArtifact,
+} from "./diagnostics.js";
+
 export {
   AGENT_INDEX_CONTRACT,
   ARTIFACT_EVIDENCE_CONTRACT,

package/packages/core/logging.js

@@ -1,4 +1,5 @@
 import crypto from "node:crypto";
+import { spawnSync as nodeSpawnSync } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
 
@@ -267,6 +268,54 @@ export function createBuildchainLogger(options = {}) {
     }
   }
 
+  function spanSync(eventName, details = {}, callback = () => undefined) {
+    const spanId = details.spanId || crypto.randomUUID();
+    const startedAt = Date.now();
+    emit("info", `${eventName}.start`, { ...details, spanId });
+    try {
+      const result = callback({ spanId });
+      emit("info", `${eventName}.end`, {
+        ...details,
+        spanId,
+        durationMs: Date.now() - startedAt,
+      });
+      return result;
+    } catch (error) {
+      emit("error", `${eventName}.error`, {
+        ...details,
+        spanId,
+        durationMs: Date.now() - startedAt,
+        message: error.message,
+        attributes: {
+          ...(details.attributes || {}),
+          errorName: error.name,
+        },
+      });
+      throw error;
+    }
+  }
+
+  function spawnSync(eventName, command, args = [], spawnOptions = {}, details = {}) {
+    return spanSync(eventName, details, () => {
+      const result = nodeSpawnSync(command, args, {
+        cwd,
+        env: process.env,
+        stdio: "inherit",
+        ...spawnOptions,
+      });
+      if (result.error) {
+        throw result.error;
+      }
+      if (result.status !== 0) {
+        const error = new Error(`command exited with ${result.status ?? "signal"}`);
+        error.status = result.status;
+        error.signal = result.signal;
+        throw error;
+      }
+      return result;
+    });
+  }
+
   return {
     path: resolvedPath,
     events: inMemoryEvents,
@@ -276,6 +325,8 @@ export function createBuildchainLogger(options = {}) {
     error: (eventName, details) => emit("error", eventName, details),
     mark: (eventName, details) => emit("info", eventName, details),
     span,
+    spanSync,
+    spawnSync,
     summary: () => summarizeBuildchainLogEvents(resolvedPath ? { path: resolvedPath } : inMemoryEvents),
   };
 }