@agent-teams/engineering-foundation 0.4.1 → 0.6.0

package/dist/capabilities/contract-protobuf-evolution/contract/config.js

@@ -0,0 +1,186 @@
+import { CapabilityInputError } from "../../../capability-runtime.js";
+import { assertSchema } from "../../../schema-catalog.js";
+import { assertNotCancelled, assertRepositoryRelativePath, loadStrictYamlFile } from "../../../strict-yaml.js";
+export const CAPABILITY_ID = "contract.protobuf-evolution";
+export const CAPABILITY_CONFIG_SCHEMA_VERSION = 1;
+const SCHEMA_ID_BY_VERSION = Object.freeze({
+    1: "contract-protobuf-evolution/v1"
+});
+function inputError(message) {
+    throw new CapabilityInputError({
+        code: "PROTOBUF_EVOLUTION_CONFIG_INVALID",
+        message,
+        phase: "protobuf-evolution-config",
+        retryable: false
+    });
+}
+function record(value, field) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        inputError(`${field} must be an object.`);
+    }
+    return value;
+}
+function string(value, field) {
+    if (typeof value !== "string") {
+        inputError(`${field} must be a string.`);
+    }
+    return value;
+}
+function number(value, field) {
+    if (typeof value !== "number") {
+        inputError(`${field} must be a number.`);
+    }
+    return value;
+}
+function configSchemaId(value) {
+    if (value === CAPABILITY_CONFIG_SCHEMA_VERSION) {
+        return SCHEMA_ID_BY_VERSION[value];
+    }
+    inputError(`schemaVersion must be ${CAPABILITY_CONFIG_SCHEMA_VERSION}.`);
+}
+function releasedBaselineSchemaId(value) {
+    if (value === 1) {
+        return "contract-protobuf-evolution-baseline/v1";
+    }
+    inputError("released baseline schemaVersion must be 1.");
+}
+function list(value, field) {
+    if (!Array.isArray(value)) {
+        inputError(`${field} must be an array.`);
+    }
+    return value;
+}
+function digest(value, field) {
+    return string(value, field);
+}
+function releasedBaselinePath(value) {
+    const repositoryPath = string(value, "releasedBaselinePath");
+    assertRepositoryRelativePath(repositoryPath, "protobuf-evolution-config");
+    if (!/\.(?:json|ya?ml)$/u.test(repositoryPath)) {
+        inputError("releasedBaselinePath must name a JSON or YAML file.");
+    }
+    if (!repositoryPath.startsWith("architecture/contracts/")) {
+        inputError("releasedBaselinePath must be inside the release-owned architecture/contracts directory.");
+    }
+    return repositoryPath;
+}
+function acceptedDecisionBaselinePath(value) {
+    const repositoryPath = string(value, "acceptedDecisionBaselinePath");
+    assertRepositoryRelativePath(repositoryPath, "protobuf-evolution-config");
+    if (repositoryPath !== "architecture/decisions/accepted-decisions.json") {
+        inputError("acceptedDecisionBaselinePath must use the stable architecture/decisions/accepted-decisions.json anchor.");
+    }
+    return repositoryPath;
+}
+function governanceConfigPath(value) {
+    const repositoryPath = string(value, "governanceConfigPath");
+    assertRepositoryRelativePath(repositoryPath, "protobuf-evolution-config");
+    if (!/\.ya?ml$/u.test(repositoryPath)) {
+        inputError("governanceConfigPath must name a YAML governance configuration file.");
+    }
+    return repositoryPath;
+}
+function mapBreakingApproval(value, index) {
+    const field = `approvedBreakingChanges[${index}]`;
+    const source = record(value, field);
+    return Object.freeze({
+        decisionId: string(source["decisionId"], `${field}.decisionId`),
+        fingerprint: digest(source["fingerprint"], `${field}.fingerprint`)
+    });
+}
+function mapGenerator(value, field) {
+    const source = record(value, field);
+    return Object.freeze({
+        name: string(source["name"], `${field}.name`),
+        version: string(source["version"], `${field}.version`)
+    });
+}
+function mapGenerators(value, field) {
+    return Object.freeze(list(value, field).map((entry, index) => mapGenerator(entry, `${field}[${index}]`)));
+}
+function mapBreaking(value) {
+    const source = record(value, "current.breaking");
+    const status = string(source["status"], "current.breaking.status");
+    if (status !== "compatible" && status !== "breaking" && status !== "not-run") {
+        inputError("current.breaking.status is invalid.");
+    }
+    const fingerprint = source["fingerprint"];
+    return Object.freeze({
+        status,
+        ...(fingerprint === undefined ? {} : { fingerprint: digest(fingerprint, "current.breaking.fingerprint") })
+    });
+}
+function mapReleased(value, field = "released baseline") {
+    const source = record(value, field);
+    return Object.freeze({
+        schemaVersion: number(source["schemaVersion"], `${field}.schemaVersion`),
+        contractId: string(source["contractId"], `${field}.contractId`),
+        publicContractVersion: string(source["publicContractVersion"], `${field}.publicContractVersion`),
+        bufVersion: string(source["bufVersion"], `${field}.bufVersion`),
+        bufConfigDigest: digest(source["bufConfigDigest"], `${field}.bufConfigDigest`),
+        descriptorImageDigest: digest(source["descriptorImageDigest"], `${field}.descriptorImageDigest`),
+        generatorVersions: mapGenerators(source["generatorVersions"], `${field}.generatorVersions`),
+        generatedOutputDigest: digest(source["generatedOutputDigest"], `${field}.generatedOutputDigest`)
+    });
+}
+async function loadReleasedBaseline(consumerRoot, repositoryPath, signal) {
+    const input = await loadStrictYamlFile(consumerRoot, repositoryPath, "protobuf-evolution-baseline", signal);
+    assertNotCancelled(signal);
+    const source = record(input, "Protobuf released baseline");
+    await assertSchema(releasedBaselineSchemaId(source["schemaVersion"]), input, "protobuf-evolution-baseline");
+    assertNotCancelled(signal);
+    return mapReleased(source);
+}
+function mapCurrent(value) {
+    const source = record(value, "current");
+    const generationDrift = record(source["generationDrift"], "current.generationDrift");
+    return Object.freeze({
+        schemaVersion: number(source["schemaVersion"], "current.schemaVersion"),
+        contractId: string(source["contractId"], "current.contractId"),
+        publicContractVersion: string(source["publicContractVersion"], "current.publicContractVersion"),
+        bufVersion: string(source["bufVersion"], "current.bufVersion"),
+        bufConfigDigest: digest(source["bufConfigDigest"], "current.bufConfigDigest"),
+        descriptorImageDigest: digest(source["descriptorImageDigest"], "current.descriptorImageDigest"),
+        releasedDescriptorImageDigest: digest(source["releasedDescriptorImageDigest"], "current.releasedDescriptorImageDigest"),
+        generatorVersions: mapGenerators(source["generatorVersions"], "current.generatorVersions"),
+        generationDrift: Object.freeze({
+            expectedGeneratedOutputDigest: digest(generationDrift["expectedGeneratedOutputDigest"], "current.generationDrift.expectedGeneratedOutputDigest"),
+            observedGeneratedOutputDigest: digest(generationDrift["observedGeneratedOutputDigest"], "current.generationDrift.observedGeneratedOutputDigest")
+        }),
+        breaking: mapBreaking(source["breaking"])
+    });
+}
+export async function loadCapabilityConfig(consumerRoot, configPath, signal) {
+    const input = await loadStrictYamlFile(consumerRoot, configPath, "protobuf-evolution-config", signal);
+    assertNotCancelled(signal);
+    const source = record(input, "protobuf evolution config");
+    await assertSchema(configSchemaId(source["schemaVersion"]), input, "protobuf-evolution-config");
+    assertNotCancelled(signal);
+    const baselinePath = releasedBaselinePath(source["releasedBaselinePath"]);
+    const approvals = Object.freeze(list(source["approvedBreakingChanges"], "approvedBreakingChanges").map(mapBreakingApproval));
+    const decisionBaselinePathValue = source["acceptedDecisionBaselinePath"];
+    const decisionBaselinePath = decisionBaselinePathValue === undefined
+        ? undefined
+        : acceptedDecisionBaselinePath(decisionBaselinePathValue);
+    const governanceConfigPathValue = source["governanceConfigPath"];
+    const governancePath = governanceConfigPathValue === undefined
+        ? undefined
+        : governanceConfigPath(governanceConfigPathValue);
+    if ((decisionBaselinePath === undefined) !== (governancePath === undefined)) {
+        inputError("acceptedDecisionBaselinePath and governanceConfigPath must be declared together.");
+    }
+    if (approvals.length > 0 && decisionBaselinePath === undefined) {
+        inputError("acceptedDecisionBaselinePath and governanceConfigPath are required when breaking approvals are declared.");
+    }
+    const released = await loadReleasedBaseline(consumerRoot, baselinePath, signal);
+    return Object.freeze({
+        ...(decisionBaselinePath === undefined
+            ? {}
+            : { acceptedDecisionBaselinePath: decisionBaselinePath }),
+        ...(governancePath === undefined ? {} : { governanceConfigPath: governancePath }),
+        approvedBreakingChanges: approvals,
+        released,
+        current: mapCurrent(source["current"])
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/capabilities/contract-protobuf-evolution/contract/config.js.map

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

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

@@ -0,0 +1,11 @@
+import { type CapabilityDefinition } from "../../capability-runtime.js";
+import type { AcceptedDecisionEvidencePort } from "./application/ports/accepted-decision-evidence.js";
+export { evaluateProtobufEvolution } from "./application/policies/evaluate-protobuf-evolution.js";
+export type { ApprovedProtobufBreakingChange, BufBreakingEvidence, BufGeneratorVersionEvidence, CurrentProtobufContractEvidence, GenerationDriftEvidence, ProtobufEvolutionPolicy, ReleasedProtobufContractEvidence, Sha256Digest } from "./application/model/protobuf-release-evidence.js";
+export type { AcceptedDecisionEvidence, AcceptedDecisionEvidencePort, ReadAcceptedDecisionEvidenceInput } from "./application/ports/accepted-decision-evidence.js";
+export { PROTOBUF_EVOLUTION_RULES, PROTOBUF_EVOLUTION_RULES_BY_ID } from "./application/rules.js";
+export interface ProtobufEvolutionCapabilityDependencies {
+    readonly acceptedDecisionEvidence?: AcceptedDecisionEvidencePort;
+}
+export declare function createProtobufEvolutionCapability(dependencies?: ProtobufEvolutionCapabilityDependencies): CapabilityDefinition;
+//# sourceMappingURL=module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/capabilities/contract-protobuf-evolution/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,oBAAoB,EAE1B,MAAM,6BAA6B,CAAC;AAQrC,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,mDAAmD,CAAC;AAGtG,OAAO,EACL,yBAAyB,EAC1B,MAAM,uDAAuD,CAAC;AAC/D,YAAY,EACV,8BAA8B,EAC9B,mBAAmB,EACnB,2BAA2B,EAC3B,+BAA+B,EAC/B,uBAAuB,EACvB,uBAAuB,EACvB,gCAAgC,EAChC,YAAY,EACb,MAAM,kDAAkD,CAAC;AAC1D,YAAY,EACV,wBAAwB,EACxB,4BAA4B,EAC5B,iCAAiC,EAClC,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC/B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,uCAAuC;IACtD,QAAQ,CAAC,wBAAwB,CAAC,EAAE,4BAA4B,CAAC;CAClE;AAED,wBAAgB,iCAAiC,CAC/C,YAAY,GAAE,uCAA4C,GACzD,oBAAoB,CAiDtB"}

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

@@ -0,0 +1,51 @@
+import { CapabilityInputError, capabilityReport } from "../../capability-runtime.js";
+import { GovernanceAcceptedDecisionEvidenceAcl } from "./adapters/outbound/governance/governance-accepted-decision-evidence-acl.js";
+import { CAPABILITY_CONFIG_SCHEMA_VERSION, CAPABILITY_ID, loadCapabilityConfig } from "./contract/config.js";
+import { evaluateProtobufEvolution } from "./application/policies/evaluate-protobuf-evolution.js";
+import { resolveProtobufEvolutionPolicy } from "./application/use-cases/resolve-protobuf-evolution-policy.js";
+export { evaluateProtobufEvolution } from "./application/policies/evaluate-protobuf-evolution.js";
+export { PROTOBUF_EVOLUTION_RULES, PROTOBUF_EVOLUTION_RULES_BY_ID } from "./application/rules.js";
+export function createProtobufEvolutionCapability(dependencies = {}) {
+    const acceptedDecisionEvidence = dependencies.acceptedDecisionEvidence ?? new GovernanceAcceptedDecisionEvidenceAcl();
+    return Object.freeze({
+        id: CAPABILITY_ID,
+        configSchemaVersion: CAPABILITY_CONFIG_SCHEMA_VERSION,
+        async run(invocation) {
+            try {
+                const configuration = await loadCapabilityConfig(invocation.consumerRoot, invocation.configPath, invocation.signal);
+                const policy = await resolveProtobufEvolutionPolicy({
+                    consumerRoot: invocation.consumerRoot,
+                    configuration,
+                    ...(invocation.signal === undefined ? {} : { signal: invocation.signal })
+                }, { acceptedDecisionEvidence });
+                return capabilityReport({
+                    capabilityId: CAPABILITY_ID,
+                    capabilityConfigSchemaVersion: CAPABILITY_CONFIG_SCHEMA_VERSION,
+                    diagnostics: evaluateProtobufEvolution(policy)
+                });
+            }
+            catch (error) {
+                if (error instanceof CapabilityInputError) {
+                    return capabilityReport({
+                        capabilityId: CAPABILITY_ID,
+                        capabilityConfigSchemaVersion: CAPABILITY_CONFIG_SCHEMA_VERSION,
+                        outcome: error.problem.code === "EXECUTION_CANCELLED" ? "cancelled" : "invalid-input",
+                        problem: error.problem
+                    });
+                }
+                return capabilityReport({
+                    capabilityId: CAPABILITY_ID,
+                    capabilityConfigSchemaVersion: CAPABILITY_CONFIG_SCHEMA_VERSION,
+                    outcome: "failed",
+                    problem: {
+                        code: "CAPABILITY_EXECUTION_FAILED",
+                        message: "Protobuf evolution capability execution failed.",
+                        phase: "protobuf-evolution-execution",
+                        retryable: false
+                    }
+                });
+            }
+        }
+    });
+}
+//# sourceMappingURL=module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../src/capabilities/contract-protobuf-evolution/module.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAGjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,qCAAqC,EAAE,MAAM,6EAA6E,CAAC;AACpI,OAAO,EACL,gCAAgC,EAChC,aAAa,EACb,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,yBAAyB,EAAE,MAAM,uDAAuD,CAAC;AAElG,OAAO,EAAE,8BAA8B,EAAE,MAAM,8DAA8D,CAAC;AAE9G,OAAO,EACL,yBAAyB,EAC1B,MAAM,uDAAuD,CAAC;AAgB/D,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC/B,MAAM,wBAAwB,CAAC;AAMhC,MAAM,UAAU,iCAAiC,CAC/C,YAAY,GAA4C,EAAE;IAE1D,MAAM,wBAAwB,GAC5B,YAAY,CAAC,wBAAwB,IAAI,IAAI,qCAAqC,EAAE,CAAC;IACvF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,aAAa;QACjB,mBAAmB,EAAE,gCAAgC;QACrD,KAAK,CAAC,GAAG,CAAC,UAAgC;YACxC,IAAI,CAAC;gBACH,MAAM,aAAa,GAAG,MAAM,oBAAoB,CAC9C,UAAU,CAAC,YAAY,EACvB,UAAU,CAAC,UAAU,EACrB,UAAU,CAAC,MAAM,CAClB,CAAC;gBACF,MAAM,MAAM,GAAG,MAAM,8BAA8B,CACjD;oBACE,YAAY,EAAE,UAAU,CAAC,YAAY;oBACrC,aAAa;oBACb,GAAG,CAAC,UAAU,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;iBAC1E,EACD,EAAE,wBAAwB,EAAE,CAC7B,CAAC;gBACF,OAAO,gBAAgB,CAAC;oBACtB,YAAY,EAAE,aAAa;oBAC3B,6BAA6B,EAAE,gCAAgC;oBAC/D,WAAW,EAAE,yBAAyB,CAAC,MAAM,CAAC;iBAC/C,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,oBAAoB,EAAE,CAAC;oBAC1C,OAAO,gBAAgB,CAAC;wBACtB,YAAY,EAAE,aAAa;wBAC3B,6BAA6B,EAAE,gCAAgC;wBAC/D,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,qBAAqB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe;wBACrF,OAAO,EAAE,KAAK,CAAC,OAAO;qBACvB,CAAC,CAAC;gBACL,CAAC;gBACD,OAAO,gBAAgB,CAAC;oBACtB,YAAY,EAAE,aAAa;oBAC3B,6BAA6B,EAAE,gCAAgC;oBAC/D,OAAO,EAAE,QAAQ;oBACjB,OAAO,EAAE;wBACP,IAAI,EAAE,6BAA6B;wBACnC,OAAO,EAAE,iDAAiD;wBAC1D,KAAK,EAAE,8BAA8B;wBACrC,SAAS,EAAE,KAAK;qBACjB;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,5 @@
+import type { BufExecutable, BufExecutionResult, BufInvocation } from "../../../ports/buf-executable.js";
+export declare class ProcessBufExecutable implements BufExecutable {
+    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

@@ -0,0 +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"}

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

@@ -0,0 +1,109 @@
+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 { assertNotCancelled } from "../../../../../../strict-yaml.js";
+const MAX_ARGUMENTS = 128;
+const MAX_ARGUMENT_LENGTH = 16 * 1024;
+const MAX_OUTPUT_BYTES = 4 * 1024 * 1024;
+function hasControlCharacter(value) {
+    for (const character of value) {
+        const code = character.codePointAt(0);
+        if (code !== undefined && (code <= 0x1f || code === 0x7f)) {
+            return true;
+        }
+    }
+    return false;
+}
+function inputError(code, message) {
+    throw new CapabilityInputError({
+        code,
+        message,
+        phase: "protobuf-buf-process",
+        retryable: false
+    });
+}
+function assertArgument(value, index) {
+    if (typeof value !== "string" ||
+        value.length > MAX_ARGUMENT_LENGTH ||
+        hasControlCharacter(value)) {
+        inputError("BUF_ARGUMENT_INVALID", `Buf argument ${index} is invalid.`);
+    }
+}
+async function executablePath(path) {
+    if (typeof path !== "string" || !isAbsolute(path)) {
+        inputError("BUF_EXECUTABLE_PATH_INVALID", "Buf executable path must be absolute.");
+    }
+    const canonical = await realpath(path).catch(() => inputError("BUF_EXECUTABLE_UNAVAILABLE", "Pinned Buf executable is unavailable."));
+    const metadata = await stat(canonical);
+    if (!metadata.isFile()) {
+        inputError("BUF_EXECUTABLE_INVALID", "Pinned Buf executable must be a regular file.");
+    }
+    return canonical;
+}
+async function workingDirectory(path) {
+    if (typeof path !== "string" || !isAbsolute(path)) {
+        inputError("BUF_WORKING_DIRECTORY_INVALID", "Buf working directory must be absolute.");
+    }
+    const canonical = await realpath(path).catch(() => inputError("BUF_WORKING_DIRECTORY_UNAVAILABLE", "Buf working directory is unavailable."));
+    const metadata = await stat(canonical);
+    if (!metadata.isDirectory()) {
+        inputError("BUF_WORKING_DIRECTORY_INVALID", "Buf working directory must be a directory.");
+    }
+    return canonical;
+}
+function execute(command, arguments_, cwd, signal) {
+    return new Promise((resolve, reject) => {
+        execFile(command, [...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 }));
+        });
+    });
+}
+export class ProcessBufExecutable {
+    async run(invocation, signal) {
+        assertNotCancelled(signal);
+        if (!Array.isArray(invocation.arguments) || invocation.arguments.length > MAX_ARGUMENTS) {
+            inputError("BUF_ARGUMENTS_INVALID", "Buf invocation has too many arguments.");
+        }
+        invocation.arguments.forEach(assertArgument);
+        const [command, cwd] = await Promise.all([
+            executablePath(invocation.executablePath),
+            workingDirectory(invocation.workingDirectory)
+        ]);
+        assertNotCancelled(signal);
+        return execute(command, invocation.arguments, cwd, signal);
+    }
+}
+//# sourceMappingURL=process-buf-executable.js.map

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

@@ -0,0 +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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"}

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

@@ -0,0 +1,4 @@
+export { ProcessBufExecutable } from "./adapters/outbound/process/process-buf-executable.js";
+export type { BufExecutable, BufExecutionResult, BufInvocation } from "./ports/buf-executable.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

@@ -0,0 +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"}

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

@@ -0,0 +1,3 @@
+export { ProcessBufExecutable } from "./adapters/outbound/process/process-buf-executable.js";
+export { verifyPinnedBufVersion } from "./use-cases/verify-pinned-buf-version.js";
+//# sourceMappingURL=module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../../src/capabilities/contract-protobuf-evolution/qualification/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uDAAuD,CAAC;AAM7F,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC"}

package/dist/capabilities/contract-protobuf-evolution/qualification/ports/buf-executable.d.ts

@@ -0,0 +1,14 @@
+export interface BufInvocation {
+    readonly executablePath: string;
+    readonly workingDirectory: string;
+    readonly arguments: readonly string[];
+}
+export interface BufExecutionResult {
+    readonly exitCode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+}
+export interface BufExecutable {
+    run(invocation: BufInvocation, signal?: AbortSignal): Promise<BufExecutionResult>;
+}
+//# sourceMappingURL=buf-executable.d.ts.map

package/dist/capabilities/contract-protobuf-evolution/qualification/ports/buf-executable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buf-executable.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/contract-protobuf-evolution/qualification/ports/buf-executable.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,CACD,UAAU,EAAE,aAAa,EACzB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAChC"}

package/dist/capabilities/contract-protobuf-evolution/qualification/ports/buf-executable.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=buf-executable.js.map

package/dist/capabilities/contract-protobuf-evolution/qualification/ports/buf-executable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buf-executable.js","sourceRoot":"","sources":["../../../../../src/capabilities/contract-protobuf-evolution/qualification/ports/buf-executable.ts"],"names":[],"mappings":""}

package/dist/capabilities/contract-protobuf-evolution/qualification/use-cases/verify-pinned-buf-version.d.ts

@@ -0,0 +1,7 @@
+import type { BufExecutable, BufInvocation } from "../ports/buf-executable.js";
+export declare function verifyPinnedBufVersion(input: {
+    readonly invocation: Omit<BufInvocation, "arguments">;
+    readonly expectedVersion: string;
+    readonly signal?: AbortSignal;
+}, executable: BufExecutable): Promise<void>;
+//# sourceMappingURL=verify-pinned-buf-version.d.ts.map

package/dist/capabilities/contract-protobuf-evolution/qualification/use-cases/verify-pinned-buf-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-pinned-buf-version.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/contract-protobuf-evolution/qualification/use-cases/verify-pinned-buf-version.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAqB/E,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE;IACL,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IACtD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,EACD,UAAU,EAAE,aAAa,GACxB,OAAO,CAAC,IAAI,CAAC,CA+Bf"}

package/dist/capabilities/contract-protobuf-evolution/qualification/use-cases/verify-pinned-buf-version.js

@@ -0,0 +1,41 @@
+import { CapabilityInputError } from "../../../../capability-runtime.js";
+import { assertNotCancelled } from "../../../../strict-yaml.js";
+function hasControlCharacter(value) {
+    for (const character of value) {
+        const code = character.codePointAt(0);
+        if (code !== undefined && (code <= 0x1f || code === 0x7f)) {
+            return true;
+        }
+    }
+    return false;
+}
+function inputError(code, message) {
+    throw new CapabilityInputError({
+        code,
+        message,
+        phase: "protobuf-buf-executable",
+        retryable: false
+    });
+}
+export async function verifyPinnedBufVersion(input, executable) {
+    assertNotCancelled(input.signal);
+    if (typeof input.expectedVersion !== "string" ||
+        input.expectedVersion.length === 0 ||
+        input.expectedVersion.length > 80 ||
+        hasControlCharacter(input.expectedVersion)) {
+        inputError("BUF_VERSION_EXPECTATION_INVALID", "Expected Buf version is invalid.");
+    }
+    const result = await executable.run({
+        ...input.invocation,
+        arguments: ["--version"]
+    }, input.signal);
+    assertNotCancelled(input.signal);
+    if (result.exitCode !== 0) {
+        inputError("BUF_VERSION_FAILED", `Pinned Buf executable could not report its version: ${result.stderr.trim() || "unknown error"}.`);
+    }
+    const reportedVersion = result.stdout.trim();
+    if (reportedVersion !== input.expectedVersion) {
+        inputError("BUF_VERSION_MISMATCH", `Pinned Buf version ${reportedVersion || "missing"} does not match expected ${input.expectedVersion}.`);
+    }
+}
+//# sourceMappingURL=verify-pinned-buf-version.js.map

package/dist/capabilities/contract-protobuf-evolution/qualification/use-cases/verify-pinned-buf-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-pinned-buf-version.js","sourceRoot":"","sources":["../../../../../src/capabilities/contract-protobuf-evolution/qualification/use-cases/verify-pinned-buf-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGhE,SAAS,mBAAmB,CAAC,KAAa;IACxC,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACtC,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YAC1D,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,OAAe;IAC/C,MAAM,IAAI,oBAAoB,CAAC;QAC7B,IAAI;QACJ,OAAO;QACP,KAAK,EAAE,yBAAyB;QAChC,SAAS,EAAE,KAAK;KACjB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAIC,EACD,UAAyB;IAEzB,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACjC,IACE,OAAO,KAAK,CAAC,eAAe,KAAK,QAAQ;QACzC,KAAK,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC;QAClC,KAAK,CAAC,eAAe,CAAC,MAAM,GAAG,EAAE;QACjC,mBAAmB,CAAC,KAAK,CAAC,eAAe,CAAC,EAC1C,CAAC;QACD,UAAU,CAAC,iCAAiC,EAAE,kCAAkC,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CACjC;QACE,GAAG,KAAK,CAAC,UAAU;QACnB,SAAS,EAAE,CAAC,WAAW,CAAC;KACzB,EACD,KAAK,CAAC,MAAM,CACb,CAAC;IACF,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC1B,UAAU,CACR,oBAAoB,EACpB,uDAAuD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,eAAe,GAAG,CAClG,CAAC;IACJ,CAAC;IACD,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC7C,IAAI,eAAe,KAAK,KAAK,CAAC,eAAe,EAAE,CAAC;QAC9C,UAAU,CACR,sBAAsB,EACtB,sBAAsB,eAAe,IAAI,SAAS,4BAA4B,KAAK,CAAC,eAAe,GAAG,CACvG,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/capabilities/documentation-local-references/application/model/documentation-local-references.d.ts

@@ -0,0 +1,15 @@
+import type { MarkdownAnchorProfile, MarkdownReferenceObservation, MarkdownReferenceResolution, MarkdownRepositoryObservation } from "../../../../documentation-observation/application/model/markdown-document.js";
+export interface DocumentationLocalReferencesPolicy {
+    readonly anchorProfile: MarkdownAnchorProfile;
+    readonly markdownRoots: readonly string[];
+}
+export interface ResolvedMarkdownReferenceObservation {
+    readonly reference: MarkdownReferenceObservation;
+    readonly resolution: MarkdownReferenceResolution;
+    readonly sourcePath: string;
+}
+export interface DocumentationLocalReferencesObservation {
+    readonly repository: MarkdownRepositoryObservation;
+    readonly resolvedReferences: readonly ResolvedMarkdownReferenceObservation[];
+}
+//# sourceMappingURL=documentation-local-references.d.ts.map

package/dist/capabilities/documentation-local-references/application/model/documentation-local-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentation-local-references.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/documentation-local-references/application/model/documentation-local-references.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,EAC3B,6BAA6B,EAC9B,MAAM,8EAA8E,CAAC;AAEtF,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;IAC9C,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,SAAS,EAAE,4BAA4B,CAAC;IACjD,QAAQ,CAAC,UAAU,EAAE,2BAA2B,CAAC;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,uCAAuC;IACtD,QAAQ,CAAC,UAAU,EAAE,6BAA6B,CAAC;IACnD,QAAQ,CAAC,kBAAkB,EAAE,SAAS,oCAAoC,EAAE,CAAC;CAC9E"}

package/dist/capabilities/documentation-local-references/application/model/documentation-local-references.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=documentation-local-references.js.map

package/dist/capabilities/documentation-local-references/application/model/documentation-local-references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentation-local-references.js","sourceRoot":"","sources":["../../../../../src/capabilities/documentation-local-references/application/model/documentation-local-references.ts"],"names":[],"mappings":""}

package/dist/capabilities/documentation-local-references/application/policies/evaluate-documentation-local-references.d.ts

@@ -0,0 +1,9 @@
+import type { FoundationDiagnostic } from "../../../../check-contract.js";
+import type { DocumentationLocalReferencesObservation, DocumentationLocalReferencesPolicy } from "../model/documentation-local-references.js";
+interface EvaluationInput {
+    readonly observation: DocumentationLocalReferencesObservation;
+    readonly policy: DocumentationLocalReferencesPolicy;
+}
+export declare function evaluateDocumentationLocalReferences(input: EvaluationInput): readonly FoundationDiagnostic[];
+export {};
+//# sourceMappingURL=evaluate-documentation-local-references.d.ts.map

package/dist/capabilities/documentation-local-references/application/policies/evaluate-documentation-local-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate-documentation-local-references.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/documentation-local-references/application/policies/evaluate-documentation-local-references.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAM1E,OAAO,KAAK,EACV,uCAAuC,EACvC,kCAAkC,EACnC,MAAM,4CAA4C,CAAC;AAMpD,UAAU,eAAe;IACvB,QAAQ,CAAC,WAAW,EAAE,uCAAuC,CAAC;IAC9D,QAAQ,CAAC,MAAM,EAAE,kCAAkC,CAAC;CACrD;AAwGD,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,eAAe,GACrB,SAAS,oBAAoB,EAAE,CAkDjC"}