@agent-teams/engineering-foundation 0.6.0 → 0.8.0

package/dist/capabilities/contract-protobuf-evolution/qualification/adapters/outbound/filesystem/filesystem-buf-qualification-artifacts.js

@@ -0,0 +1,301 @@
+import { open, mkdir, mkdtemp, realpath, rename, rm, stat } from "node:fs/promises";
+import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { setTimeout as wait } from "node:timers/promises";
+import { lock } from "proper-lockfile";
+import { CapabilityInputError } from "../../../../../../capability-runtime.js";
+import { assertNotCancelled } from "../../../../../../cancellation.js";
+import { ContainedFileReadError, pathTraversesSymbolicLink, readContainedRegularFile } from "../../../../../../filesystem-path-safety.js";
+const MAX_EVIDENCE_BYTES = 8 * 1024 * 1024;
+const WRITE_LOCK_OPTIONS = Object.freeze({
+    realpath: false,
+    retries: 0,
+    stale: 30_000,
+    update: 10_000
+});
+const WRITE_LOCK_RETRIES = 30;
+const WRITE_LOCK_MIN_DELAY_MS = 25;
+const WRITE_LOCK_MAX_DELAY_MS = 100;
+const WRITE_LOCK_BACKOFF = 1.2;
+function inputError(code, message) {
+    throw qualificationError(code, message);
+}
+function qualificationError(code, message) {
+    return new CapabilityInputError({
+        code,
+        message,
+        phase: "protobuf-buf-qualification-artifacts",
+        retryable: false
+    });
+}
+function errorCode(error) {
+    return typeof error === "object" && error !== null && "code" in error
+        ? String(error.code)
+        : undefined;
+}
+function errorObject(error, message) {
+    return error instanceof Error ? error : new Error(message, { cause: error });
+}
+function contained(root, candidate) {
+    const relation = relative(root, candidate);
+    return (relation === "" ||
+        (!isAbsolute(relation) && relation !== ".." && !relation.startsWith(`..${sep}`)));
+}
+function readFailure(error, path, optional) {
+    if (optional && error.failure === "missing") {
+        return undefined;
+    }
+    inputError(error.failure === "symlink" || error.failure === "escape"
+        ? "BUF_QUALIFICATION_PATH_UNSAFE"
+        : "BUF_QUALIFICATION_INPUT_UNAVAILABLE", `Qualification artifact is unavailable, unsafe, or changed while reading: ${path}.`);
+}
+async function readContained(input) {
+    try {
+        return await readContainedRegularFile({
+            candidate: resolve(input.consumerRoot, input.path),
+            maxBytes: input.maxBytes,
+            root: input.consumerRoot
+        });
+    }
+    catch (error) {
+        if (!(error instanceof ContainedFileReadError)) {
+            throw error;
+        }
+        readFailure(error, input.path, input.optional);
+        return undefined;
+    }
+}
+async function assertSafeCandidate(target) {
+    if ((await pathTraversesSymbolicLink(target.root, target.parent)) ||
+        (await pathTraversesSymbolicLink(target.root, target.candidate))) {
+        inputError("BUF_QUALIFICATION_PATH_UNSAFE", "Evidence target cannot traverse a symbolic link.");
+    }
+    const canonicalParent = await realpath(target.parent);
+    const parentMetadata = await stat(canonicalParent, { bigint: true });
+    if (canonicalParent !== target.parent ||
+        !contained(target.root, canonicalParent) ||
+        !parentMetadata.isDirectory() ||
+        String(parentMetadata.dev) !== target.parentDevice ||
+        String(parentMetadata.ino) !== target.parentInode) {
+        inputError("BUF_QUALIFICATION_PATH_UNSAFE", "Evidence directory identity changed during qualification.");
+    }
+    try {
+        const metadata = await stat(target.candidate);
+        if (!metadata.isFile()) {
+            inputError("BUF_QUALIFICATION_PATH_UNSAFE", "Evidence target must be a regular file.");
+        }
+    }
+    catch (error) {
+        if (errorCode(error) !== "ENOENT") {
+            throw error;
+        }
+    }
+}
+async function canonicalWriteTarget(consumerRoot, path) {
+    const root = await realpath(consumerRoot);
+    const lexicalCandidate = resolve(root, path);
+    if (!contained(root, lexicalCandidate)) {
+        inputError("BUF_QUALIFICATION_PATH_UNSAFE", "Evidence path escapes the consumer repository.");
+    }
+    const parent = dirname(lexicalCandidate);
+    if (await pathTraversesSymbolicLink(root, parent)) {
+        inputError("BUF_QUALIFICATION_PATH_UNSAFE", "Evidence directory cannot traverse a symbolic link.");
+    }
+    await mkdir(parent, { recursive: true });
+    if (await pathTraversesSymbolicLink(root, parent)) {
+        inputError("BUF_QUALIFICATION_PATH_UNSAFE", "Evidence directory cannot traverse a symbolic link.");
+    }
+    const canonicalParent = await realpath(parent);
+    const parentMetadata = await stat(canonicalParent, { bigint: true });
+    if (!contained(root, canonicalParent) || !parentMetadata.isDirectory()) {
+        inputError("BUF_QUALIFICATION_PATH_UNSAFE", "Evidence directory escapes the consumer repository.");
+    }
+    const target = {
+        candidate: join(canonicalParent, basename(lexicalCandidate)),
+        parent: canonicalParent,
+        parentDevice: String(parentMetadata.dev),
+        parentInode: String(parentMetadata.ino),
+        root
+    };
+    await assertSafeCandidate(target);
+    return target;
+}
+async function flushParentDirectory(parent) {
+    if (process.platform === "win32") {
+        return;
+    }
+    const directory = await open(parent, "r");
+    try {
+        await directory.sync();
+    }
+    finally {
+        await directory.close();
+    }
+}
+async function waitForLockRetry(delayMs, signal) {
+    assertNotCancelled(signal);
+    try {
+        await wait(delayMs, undefined, signal === undefined ? {} : { signal });
+    }
+    catch (error) {
+        assertNotCancelled(signal);
+        throw error;
+    }
+    assertNotCancelled(signal);
+}
+async function acquireWriteLock(path, signal) {
+    for (let attempt = 0; attempt <= WRITE_LOCK_RETRIES; attempt += 1) {
+        assertNotCancelled(signal);
+        try {
+            return await lock(path, WRITE_LOCK_OPTIONS);
+        }
+        catch (error) {
+            if (errorCode(error) !== "ELOCKED" || attempt === WRITE_LOCK_RETRIES) {
+                throw error;
+            }
+        }
+        const delayMs = Math.min(WRITE_LOCK_MAX_DELAY_MS, WRITE_LOCK_MIN_DELAY_MS * (WRITE_LOCK_BACKOFF ** attempt));
+        await waitForLockRetry(delayMs, signal);
+    }
+    throw new Error("Unreachable write-lock retry state.");
+}
+async function writeAtomic(target, source, signal) {
+    assertNotCancelled(signal);
+    const expected = Buffer.from(source, "utf8");
+    if (expected.length > MAX_EVIDENCE_BYTES) {
+        inputError("BUF_QUALIFICATION_EVIDENCE_TOO_LARGE", "Canonical Buf qualification evidence exceeds the supported size limit.");
+    }
+    const temporaryRoot = await mkdtemp(join(target.parent, ".buf-evidence-"));
+    const temporaryPath = join(temporaryRoot, "evidence.json");
+    let replaced = false;
+    let durable = false;
+    let failure;
+    try {
+        const handle = await open(temporaryPath, "wx", 0o600);
+        try {
+            await handle.writeFile(source, "utf8");
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+        assertNotCancelled(signal);
+        await assertSafeCandidate(target);
+        assertNotCancelled(signal);
+        await rename(temporaryPath, target.candidate);
+        replaced = true;
+        await assertSafeCandidate(target);
+        const persisted = await readContainedRegularFile({
+            candidate: target.candidate,
+            maxBytes: MAX_EVIDENCE_BYTES,
+            root: target.root
+        });
+        if (!persisted.equals(expected)) {
+            inputError("BUF_QUALIFICATION_WRITE_OUTCOME_UNCERTAIN", "Evidence bytes changed during atomic publication.");
+        }
+        await assertSafeCandidate(target);
+        await flushParentDirectory(target.parent);
+        durable = true;
+    }
+    catch (error) {
+        if (replaced &&
+            (!(error instanceof CapabilityInputError) ||
+                error.problem.code !== "BUF_QUALIFICATION_WRITE_OUTCOME_UNCERTAIN")) {
+            failure = qualificationError("BUF_QUALIFICATION_WRITE_OUTCOME_UNCERTAIN", "Evidence was replaced but final durability or containment could not be proven.");
+        }
+        else {
+            failure = errorObject(error, "Evidence publication failed.");
+        }
+    }
+    let cleanupFailure;
+    try {
+        await rm(temporaryRoot, { force: true, recursive: true });
+    }
+    catch (error) {
+        cleanupFailure = errorObject(error, "Temporary evidence cleanup failed.");
+    }
+    if (failure !== undefined) {
+        throw failure;
+    }
+    if (cleanupFailure !== undefined) {
+        if (durable) {
+            inputError("BUF_QUALIFICATION_POST_COMMIT_CLEANUP_FAILED", "Evidence was durably published, but temporary artifact cleanup failed.");
+        }
+        if (replaced) {
+            inputError("BUF_QUALIFICATION_WRITE_OUTCOME_UNCERTAIN", "Evidence was replaced, but publication completion could not be proven.");
+        }
+        throw cleanupFailure;
+    }
+}
+async function readExistingForWrite(consumerRoot, path, target) {
+    let metadata;
+    try {
+        metadata = await stat(target.candidate);
+    }
+    catch (error) {
+        if (errorCode(error) === "ENOENT") {
+            return { exists: false };
+        }
+        throw error;
+    }
+    if (!metadata.isFile()) {
+        inputError("BUF_QUALIFICATION_PATH_UNSAFE", "Evidence target must be a regular file.");
+    }
+    if (metadata.size > MAX_EVIDENCE_BYTES) {
+        return { exists: true };
+    }
+    const bytes = await readContained({
+        consumerRoot,
+        path,
+        maxBytes: MAX_EVIDENCE_BYTES,
+        optional: false
+    });
+    return { exists: true, ...(bytes === undefined ? {} : { source: bytes.toString("utf8") }) };
+}
+export class FilesystemBufQualificationArtifacts {
+    async readInput(input) {
+        const bytes = await readContained({ ...input, optional: false });
+        if (bytes === undefined) {
+            inputError("BUF_QUALIFICATION_INPUT_UNAVAILABLE", `${input.label} is unavailable.`);
+        }
+        return bytes;
+    }
+    async readExistingEvidence(input) {
+        const bytes = await readContained({ ...input, optional: true });
+        return bytes?.toString("utf8");
+    }
+    async writeEvidence(input) {
+        assertNotCancelled(input.signal);
+        const target = await canonicalWriteTarget(input.consumerRoot, input.path);
+        let failed = false;
+        let release;
+        try {
+            release = await acquireWriteLock(target.candidate, input.signal);
+            assertNotCancelled(input.signal);
+            await assertSafeCandidate(target);
+            const existing = await readExistingForWrite(input.consumerRoot, input.path, target);
+            if (existing.source === input.source) {
+                return "unchanged";
+            }
+            await writeAtomic(target, input.source, input.signal);
+            return existing.exists ? "updated" : "created";
+        }
+        catch (error) {
+            failed = true;
+            if (error instanceof CapabilityInputError) {
+                throw error;
+            }
+            return inputError("BUF_QUALIFICATION_WRITE_UNAVAILABLE", "Buf qualification evidence could not be locked or replaced safely.");
+        }
+        finally {
+            try {
+                await release?.();
+            }
+            catch {
+                if (!failed) {
+                    inputError("BUF_QUALIFICATION_LOCK_RELEASE_FAILED", "Evidence was published but its cooperative write lock could not be released.");
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=filesystem-buf-qualification-artifacts.js.map

package/dist/capabilities/contract-protobuf-evolution/qualification/adapters/outbound/filesystem/filesystem-buf-qualification-artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-buf-qualification-artifacts.js","sourceRoot":"","sources":["../../../../../../../src/capabilities/contract-protobuf-evolution/qualification/adapters/outbound/filesystem/filesystem-buf-qualification-artifacts.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/contract-protobuf-evolution/qualification/adapters/outbound/process/process-buf-executable.d.ts

@@ -1,5 +1,7 @@
 import type { BufExecutable, BufExecutionResult, BufInvocation } from "../../../ports/buf-executable.js";
 export declare class ProcessBufExecutable implements BufExecutable {
+    #private;
+    constructor(timeoutMs?: number);
     run(invocation: BufInvocation, signal?: AbortSignal): Promise<BufExecutionResult>;
 }
 //# sourceMappingURL=process-buf-executable.d.ts.map

package/dist/capabilities/contract-protobuf-evolution/qualification/adapters/outbound/process/process-buf-executable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-buf-executable.d.ts","sourceRoot":"","sources":["../../../../../../../src/capabilities/contract-protobuf-evolution/qualification/adapters/outbound/process/process-buf-executable.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,aAAa,EACd,MAAM,kCAAkC,CAAC;AAyH1C,qBAAa,oBAAqB,YAAW,aAAa;IAClD,GAAG,CACP,UAAU,EAAE,aAAa,EACzB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAY7B;CACF"}
+{"version":3,"file":"process-buf-executable.d.ts","sourceRoot":"","sources":["../../../../../../../src/capabilities/contract-protobuf-evolution/qualification/adapters/outbound/process/process-buf-executable.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,aAAa,EACd,MAAM,kCAAkC,CAAC;AA+F1C,qBAAa,oBAAqB,YAAW,aAAa;;IAGxD,YAAY,SAAS,SAAiC,EAErD;IAEK,GAAG,CACP,UAAU,EAAE,aAAa,EACzB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAY7B;CACF"}

package/dist/capabilities/contract-protobuf-evolution/qualification/adapters/outbound/process/process-buf-executable.js

@@ -1,11 +1,11 @@
-import { execFile } from "node:child_process";
 import { realpath, stat } from "node:fs/promises";
 import { isAbsolute } from "node:path";
 import { CapabilityInputError } from "../../../../../../capability-runtime.js";
+import { executeManagedProcess } from "../../../../../../process-execution/node-process-runner.js";
 import { assertNotCancelled } from "../../../../../../strict-yaml.js";
 const MAX_ARGUMENTS = 128;
 const MAX_ARGUMENT_LENGTH = 16 * 1024;
-const MAX_OUTPUT_BYTES = 4 * 1024 * 1024;
+const DEFAULT_BUF_PROCESS_TIMEOUT_MS = 300_000;
 function hasControlCharacter(value) {
     for (const character of value) {
         const code = character.codePointAt(0);
@@ -15,13 +15,13 @@ function hasControlCharacter(value) {
     }
     return false;
 }
-function inputError(code, message) {
+function inputError(code, message, cause) {
     throw new CapabilityInputError({
         code,
         message,
         phase: "protobuf-buf-process",
         retryable: false
-    });
+    }, cause === undefined ? undefined : { cause });
 }
 function assertArgument(value, index) {
     if (typeof value !== "string" ||
@@ -52,46 +52,33 @@ async function workingDirectory(path) {
     }
     return canonical;
 }
-function execute(command, arguments_, cwd, signal) {
-    return new Promise((resolve, reject) => {
-        execFile(command, [...arguments_], {
+async function execute(command, arguments_, cwd, timeoutMs, signal) {
+    try {
+        const result = await executeManagedProcess({
+            command,
+            args: arguments_,
             cwd,
-            encoding: "utf8",
-            maxBuffer: MAX_OUTPUT_BYTES,
-            shell: false,
-            signal,
-            windowsHide: true
-        }, (error, stdout, stderr) => {
-            if (error === null) {
-                resolve({ exitCode: 0, stdout, stderr });
-                return;
-            }
-            if (signal?.aborted === true) {
-                reject(new CapabilityInputError({
-                    code: "EXECUTION_CANCELLED",
-                    message: "Foundation check was cancelled.",
-                    phase: "protobuf-buf-process",
-                    retryable: false
-                }));
-                return;
-            }
-            const exitCode = typeof error.code === "number"
-                ? error.code
-                : undefined;
-            if (exitCode !== undefined) {
-                resolve({ exitCode, stdout, stderr });
-                return;
-            }
-            reject(new CapabilityInputError({
-                code: "BUF_EXECUTION_UNAVAILABLE",
-                message: "Pinned Buf executable could not be started.",
-                phase: "protobuf-buf-process",
-                retryable: false
-            }, { cause: error }));
+            timeoutMs,
+            ...(signal === undefined ? {} : { signal })
         });
-    });
+        return {
+            exitCode: result.exitCode,
+            stdout: result.stdout,
+            stderr: result.stderr
+        };
+    }
+    catch (error) {
+        if (signal?.aborted === true) {
+            inputError("EXECUTION_CANCELLED", "Buf qualification was cancelled.", error);
+        }
+        inputError("BUF_EXECUTION_UNAVAILABLE", `Pinned Buf execution failed or exceeded its ${String(timeoutMs)}ms deadline.`, error);
+    }
 }
 export class ProcessBufExecutable {
+    #timeoutMs;
+    constructor(timeoutMs = DEFAULT_BUF_PROCESS_TIMEOUT_MS) {
+        this.#timeoutMs = timeoutMs;
+    }
     async run(invocation, signal) {
         assertNotCancelled(signal);
         if (!Array.isArray(invocation.arguments) || invocation.arguments.length > MAX_ARGUMENTS) {
@@ -103,7 +90,7 @@ export class ProcessBufExecutable {
             workingDirectory(invocation.workingDirectory)
         ]);
         assertNotCancelled(signal);
-        return execute(command, invocation.arguments, cwd, signal);
+        return execute(command, invocation.arguments, cwd, this.#timeoutMs, signal);
     }
 }
 //# sourceMappingURL=process-buf-executable.js.map

package/dist/capabilities/contract-protobuf-evolution/qualification/adapters/outbound/process/process-buf-executable.js.map

@@ -1 +1 @@
-{"version":3,"file":"process-buf-executable.js","sourceRoot":"","sources":["../../../../../../../src/capabilities/contract-protobuf-evolution/qualification/adapters/outbound/process/process-buf-executable.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"process-buf-executable.js","sourceRoot":"","sources":["../../../../../../../src/capabilities/contract-protobuf-evolution/qualification/adapters/outbound/process/process-buf-executable.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/contract-protobuf-evolution/qualification/adapters/outbound/process/process-buf-qualification-runner.d.ts

@@ -0,0 +1,8 @@
+import type { BufQualificationRunner, BufQualificationRunInput, BufQualificationRunResult } from "../../../ports/buf-qualification-runner.js";
+import type { BufExecutable } from "../../../ports/buf-executable.js";
+export declare class ProcessBufQualificationRunner implements BufQualificationRunner {
+    #private;
+    constructor(executable?: BufExecutable);
+    run(input: BufQualificationRunInput): Promise<BufQualificationRunResult>;
+}
+//# sourceMappingURL=process-buf-qualification-runner.d.ts.map

package/dist/capabilities/contract-protobuf-evolution/qualification/adapters/outbound/process/process-buf-qualification-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-buf-qualification-runner.d.ts","sourceRoot":"","sources":["../../../../../../../src/capabilities/contract-protobuf-evolution/qualification/adapters/outbound/process/process-buf-qualification-runner.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,4CAA4C,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AA6CtE,qBAAa,6BAA8B,YAAW,sBAAsB;;IAG1E,YAAY,UAAU,GAAE,aAA0C,EAEjE;IAEK,GAAG,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CA+D7E;CACF"}

package/dist/capabilities/contract-protobuf-evolution/qualification/adapters/outbound/process/process-buf-qualification-runner.js

@@ -0,0 +1,102 @@
+import { open, mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { CapabilityInputError } from "../../../../../../capability-runtime.js";
+import { readContainedRegularFile } from "../../../../../../filesystem-path-safety.js";
+import { assertNotCancelled } from "../../../../../../strict-yaml.js";
+import { bufQualificationInvocationPlan } from "../../../../application/model/buf-breaking-qualification.js";
+import { verifyPinnedBufVersion } from "../../../use-cases/verify-pinned-buf-version.js";
+import { ProcessBufExecutable } from "./process-buf-executable.js";
+const MAX_DESCRIPTOR_BYTES = 64 * 1024 * 1024;
+function inputError(code, message) {
+    throw new CapabilityInputError({
+        code,
+        message,
+        phase: "protobuf-buf-qualification-process",
+        retryable: false
+    });
+}
+async function writePrivateFile(path, bytes) {
+    const handle = await open(path, "wx", 0o600);
+    try {
+        await handle.writeFile(bytes);
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+}
+async function readBoundedDescriptor(root, path) {
+    let descriptor;
+    try {
+        descriptor = await readContainedRegularFile({
+            candidate: path,
+            maxBytes: MAX_DESCRIPTOR_BYTES,
+            root
+        });
+    }
+    catch {
+        inputError("BUF_CANDIDATE_DESCRIPTOR_INVALID", "Buf candidate descriptor is unavailable, unsafe, or exceeds the supported size limit.");
+    }
+    if (descriptor.length === 0) {
+        inputError("BUF_CANDIDATE_DESCRIPTOR_INVALID", "Buf candidate descriptor is empty.");
+    }
+    return descriptor;
+}
+export class ProcessBufQualificationRunner {
+    #executable;
+    constructor(executable = new ProcessBufExecutable()) {
+        this.#executable = executable;
+    }
+    async run(input) {
+        assertNotCancelled(input.signal);
+        await verifyPinnedBufVersion({
+            invocation: {
+                executablePath: input.executablePath,
+                workingDirectory: input.workingDirectory
+            },
+            expectedVersion: input.expectedVersion,
+            ...(input.signal === undefined ? {} : { signal: input.signal })
+        }, this.#executable);
+        const temporaryRoot = await mkdtemp(join(tmpdir(), "agent-teams-buf-qualification-"));
+        const baselinePath = join(temporaryRoot, "baseline.binpb");
+        const candidatePath = join(temporaryRoot, "candidate.binpb");
+        const invocation = bufQualificationInvocationPlan({
+            baselineDescriptorPath: baselinePath,
+            bufConfigPath: input.bufConfigPath,
+            candidateDescriptorPath: candidatePath,
+            modulePath: input.modulePath
+        });
+        try {
+            await writePrivateFile(baselinePath, input.baselineDescriptorImage);
+            const build = await this.#executable.run({
+                executablePath: input.executablePath,
+                workingDirectory: input.workingDirectory,
+                arguments: invocation.buildArguments
+            }, input.signal);
+            assertNotCancelled(input.signal);
+            if (build.exitCode !== 0 || build.stdout.length !== 0 || build.stderr.length !== 0) {
+                inputError("BUF_BUILD_FAILED", `Buf candidate descriptor build failed or emitted unexpected output: ${build.stderr.trim() || build.stdout.trim() || `exit ${build.exitCode}`}.`);
+            }
+            const candidateDescriptorImage = await readBoundedDescriptor(temporaryRoot, candidatePath);
+            const breaking = await this.#executable.run({
+                executablePath: input.executablePath,
+                workingDirectory: input.workingDirectory,
+                arguments: invocation.breakingArguments
+            }, input.signal);
+            assertNotCancelled(input.signal);
+            if ((breaking.exitCode !== 0 && breaking.exitCode !== 100) || breaking.stderr.length !== 0) {
+                inputError("BUF_BREAKING_EXECUTION_FAILED", `Buf breaking qualification failed: ${breaking.stderr.trim() || `exit ${breaking.exitCode}`}.`);
+            }
+            return Object.freeze({
+                status: breaking.exitCode === 0 ? "compatible" : "breaking",
+                candidateDescriptorImage,
+                rawOutput: breaking.stdout
+            });
+        }
+        finally {
+            await rm(temporaryRoot, { force: true, recursive: true });
+        }
+    }
+}
+//# sourceMappingURL=process-buf-qualification-runner.js.map

package/dist/capabilities/contract-protobuf-evolution/qualification/adapters/outbound/process/process-buf-qualification-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-buf-qualification-runner.js","sourceRoot":"","sources":["../../../../../../../src/capabilities/contract-protobuf-evolution/qualification/adapters/outbound/process/process-buf-qualification-runner.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/contract-protobuf-evolution/qualification/module.d.ts

@@ -1,4 +1,18 @@
+import { type QualifyBufBreakingEvidenceResult } from "./use-cases/qualify-buf-breaking-evidence.js";
+export declare function qualifyProtobufBreakingEvidence(input: {
+    readonly consumerRoot: string;
+    readonly configPath: string;
+    readonly executablePath: string;
+    readonly write: boolean;
+    readonly signal?: AbortSignal;
+}): Promise<QualifyBufBreakingEvidenceResult>;
+export { FilesystemBufQualificationArtifacts } from "./adapters/outbound/filesystem/filesystem-buf-qualification-artifacts.js";
 export { ProcessBufExecutable } from "./adapters/outbound/process/process-buf-executable.js";
+export { ProcessBufQualificationRunner } from "./adapters/outbound/process/process-buf-qualification-runner.js";
 export type { BufExecutable, BufExecutionResult, BufInvocation } from "./ports/buf-executable.js";
+export type { BufQualificationArtifacts, BufQualificationEvidenceWriteResult } from "./ports/buf-qualification-artifacts.js";
+export type { BufQualificationRunner, BufQualificationRunInput, BufQualificationRunResult } from "./ports/buf-qualification-runner.js";
+export { qualifyBufBreakingEvidence } from "./use-cases/qualify-buf-breaking-evidence.js";
+export type { QualifyBufBreakingEvidenceResult } from "./use-cases/qualify-buf-breaking-evidence.js";
 export { verifyPinnedBufVersion } from "./use-cases/verify-pinned-buf-version.js";
 //# sourceMappingURL=module.d.ts.map

package/dist/capabilities/contract-protobuf-evolution/qualification/module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/contract-protobuf-evolution/qualification/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uDAAuD,CAAC;AAC7F,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,aAAa,EACd,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC"}
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/contract-protobuf-evolution/qualification/module.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,8CAA8C,CAAC;AAEtD,wBAAsB,+BAA+B,CAAC,KAAK,EAAE;IAC3D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,GAAG,OAAO,CAAC,gCAAgC,CAAC,CAoB5C;AAED,OAAO,EAAE,mCAAmC,EAAE,MAAM,0EAA0E,CAAC;AAC/H,OAAO,EAAE,oBAAoB,EAAE,MAAM,uDAAuD,CAAC;AAC7F,OAAO,EAAE,6BAA6B,EAAE,MAAM,iEAAiE,CAAC;AAChH,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,aAAa,EACd,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,yBAAyB,EACzB,mCAAmC,EACpC,MAAM,wCAAwC,CAAC;AAChD,YAAY,EACV,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAC1F,YAAY,EAAE,gCAAgC,EAAE,MAAM,8CAA8C,CAAC;AACrG,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC"}

package/dist/capabilities/contract-protobuf-evolution/qualification/module.js

@@ -1,3 +1,25 @@
+import { NodeSha256Digest } from "../adapters/outbound/crypto/node-sha256-digest.js";
+import { loadCapabilityConfig } from "../contract/config.js";
+import { FilesystemBufQualificationArtifacts } from "./adapters/outbound/filesystem/filesystem-buf-qualification-artifacts.js";
+import { ProcessBufQualificationRunner } from "./adapters/outbound/process/process-buf-qualification-runner.js";
+import { qualifyBufBreakingEvidence } from "./use-cases/qualify-buf-breaking-evidence.js";
+export async function qualifyProtobufBreakingEvidence(input) {
+    const configuration = await loadCapabilityConfig(input.consumerRoot, input.configPath, input.signal);
+    return qualifyBufBreakingEvidence({
+        consumerRoot: input.consumerRoot,
+        executablePath: input.executablePath,
+        configuration,
+        write: input.write,
+        ...(input.signal === undefined ? {} : { signal: input.signal })
+    }, {
+        artifacts: new FilesystemBufQualificationArtifacts(),
+        digest: new NodeSha256Digest(),
+        runner: new ProcessBufQualificationRunner()
+    });
+}
+export { FilesystemBufQualificationArtifacts } from "./adapters/outbound/filesystem/filesystem-buf-qualification-artifacts.js";
 export { ProcessBufExecutable } from "./adapters/outbound/process/process-buf-executable.js";
+export { ProcessBufQualificationRunner } from "./adapters/outbound/process/process-buf-qualification-runner.js";
+export { qualifyBufBreakingEvidence } from "./use-cases/qualify-buf-breaking-evidence.js";
 export { verifyPinnedBufVersion } from "./use-cases/verify-pinned-buf-version.js";
 //# sourceMappingURL=module.js.map