@agent-teams/engineering-foundation 1.0.1 → 1.1.0

package/dist/capabilities/repository-agent-workflow/adapters/outbound/filesystem/filesystem-effective-instructions-reader.js

@@ -1,18 +1,8 @@
 import { lstat, realpath, stat } from "node:fs/promises";
 import { isAbsolute, join, posix, relative, sep, win32 } from "node:path";
-import { CapabilityInputError } from "../../../../../capability-runtime.js";
-import { ContainedFileReadError, inspectContainedRegularFile, readContainedRegularFile } from "../../../../../filesystem-path-safety.js";
-import { assertNotCancelled, assertRepositoryRelativePath } from "../../../../../strict-yaml.js";
+import { assertEffectiveInstructionRepositoryPath, assertWorkflowObservationActive, effectiveInstructionFailureDetail, rejectEffectiveInstructionInput, isWorkflowInputFailure } from "../../../application/policies/workflow-input.js";
 import { EFFECTIVE_INSTRUCTION_CANDIDATE_NAMES } from "../../../application/model/effective-instructions.js";
 const MAXIMUM_INSTRUCTION_SOURCE_BYTES = 256 * 1024;
-function inputError(code, message) {
-    throw new CapabilityInputError({
-        code,
-        message,
-        phase: "repository-agent-workflow-effective-instructions",
-        retryable: false
-    });
-}
 function isMissing(error) {
     return error instanceof Error && "code" in error &&
         error.code === "ENOENT";
@@ -44,15 +34,15 @@ async function resolveConsumerRoot(consumerRoot) {
     try {
         const root = await realpath(consumerRoot);
         if (!(await stat(root)).isDirectory()) {
-            inputError("REPOSITORY_AGENT_WORKFLOW_ROOT_INVALID", "The consumer root must be an existing directory.");
+            rejectEffectiveInstructionInput("REPOSITORY_AGENT_WORKFLOW_ROOT_INVALID", "The consumer root must be an existing directory.");
         }
         return root;
     }
     catch (error) {
-        if (error instanceof CapabilityInputError) {
+        if (isWorkflowInputFailure(error)) {
             throw error;
         }
-        inputError("REPOSITORY_AGENT_WORKFLOW_ROOT_UNAVAILABLE", "The consumer root is unavailable.");
+        rejectEffectiveInstructionInput("REPOSITORY_AGENT_WORKFLOW_ROOT_UNAVAILABLE", "The consumer root is unavailable.");
     }
 }
 async function safeTargetDirectories(root, targetDirectory) {
@@ -68,16 +58,16 @@ async function safeTargetDirectories(root, targetDirectory) {
         }
         catch (error) {
             if (isMissing(error)) {
-                inputError("REPOSITORY_AGENT_WORKFLOW_TARGET_DIRECTORY_MISSING", `The target directory does not exist: ${targetDirectory}.`);
+                rejectEffectiveInstructionInput("REPOSITORY_AGENT_WORKFLOW_TARGET_DIRECTORY_MISSING", `The target directory does not exist: ${targetDirectory}.`);
             }
-            inputError("REPOSITORY_AGENT_WORKFLOW_TARGET_DIRECTORY_UNAVAILABLE", `The target directory is unavailable: ${targetDirectory}.`);
+            rejectEffectiveInstructionInput("REPOSITORY_AGENT_WORKFLOW_TARGET_DIRECTORY_UNAVAILABLE", `The target directory is unavailable: ${targetDirectory}.`);
         }
         if (metadata.isSymbolicLink() || !metadata.isDirectory()) {
-            inputError("REPOSITORY_AGENT_WORKFLOW_TARGET_DIRECTORY_INVALID", `The target path must have only real repository directories: ${targetDirectory}.`);
+            rejectEffectiveInstructionInput("REPOSITORY_AGENT_WORKFLOW_TARGET_DIRECTORY_INVALID", `The target path must have only real repository directories: ${targetDirectory}.`);
         }
-        const canonical = await realpath(next).catch(() => inputError("REPOSITORY_AGENT_WORKFLOW_TARGET_DIRECTORY_UNAVAILABLE", `The target directory is unavailable: ${targetDirectory}.`));
+        const canonical = await realpath(next).catch(() => rejectEffectiveInstructionInput("REPOSITORY_AGENT_WORKFLOW_TARGET_DIRECTORY_UNAVAILABLE", `The target directory is unavailable: ${targetDirectory}.`));
         if (!contained(root, canonical)) {
-            inputError("REPOSITORY_AGENT_WORKFLOW_TARGET_DIRECTORY_ESCAPE", `The target directory escapes the consumer repository: ${targetDirectory}.`);
+            rejectEffectiveInstructionInput("REPOSITORY_AGENT_WORKFLOW_TARGET_DIRECTORY_ESCAPE", `The target directory escapes the consumer repository: ${targetDirectory}.`);
         }
         absolute = canonical;
         repositoryPath = repositoryPath.length === 0
@@ -87,7 +77,7 @@ async function safeTargetDirectories(root, targetDirectory) {
     }
     return Object.freeze(directories);
 }
-async function readCandidate(root, directory, name, mode) {
+async function readCandidate(observation, root, directory, { name, mode }) {
     const repositoryPath = directory.repositoryPath === "."
         ? name
         : posix.join(directory.repositoryPath, name);
@@ -100,7 +90,7 @@ async function readCandidate(root, directory, name, mode) {
         if (isMissing(error)) {
             return Object.freeze({ kind: "missing", path: repositoryPath });
         }
-        inputError("REPOSITORY_AGENT_WORKFLOW_INSTRUCTION_UNAVAILABLE", `The instruction candidate is unavailable: ${repositoryPath}.`);
+        rejectEffectiveInstructionInput("REPOSITORY_AGENT_WORKFLOW_INSTRUCTION_UNAVAILABLE", `The instruction candidate is unavailable: ${repositoryPath}.`);
     }
     if (metadata.isSymbolicLink()) {
         return Object.freeze({ kind: "symlink", path: repositoryPath });
@@ -109,7 +99,7 @@ async function readCandidate(root, directory, name, mode) {
         return Object.freeze({ kind: "not-file", path: repositoryPath });
     }
     if (!Number.isSafeInteger(metadata.size) || metadata.size < 0) {
-        inputError("REPOSITORY_AGENT_WORKFLOW_INSTRUCTION_UNAVAILABLE", `The instruction candidate has an unsupported size: ${repositoryPath}.`);
+        rejectEffectiveInstructionInput("REPOSITORY_AGENT_WORKFLOW_INSTRUCTION_UNAVAILABLE", `The instruction candidate has an unsupported size: ${repositoryPath}.`);
     }
     if (mode === "classify") {
         return Object.freeze({
@@ -121,21 +111,21 @@ async function readCandidate(root, directory, name, mode) {
     }
     if (mode === "metadata") {
         try {
-            const observation = await inspectContainedRegularFile({ candidate, root });
+            const metadataObservation = await observation.inspect({ candidate, root });
             return Object.freeze({
                 kind: "file",
                 path: repositoryPath,
-                sourceBytes: observation.size,
+                sourceBytes: metadataObservation.size,
                 bytes: null
             });
         }
         catch (error) {
-            const detail = error instanceof ContainedFileReadError ? error.failure : "unavailable";
-            inputError("REPOSITORY_AGENT_WORKFLOW_INSTRUCTION_UNAVAILABLE", `The instruction candidate must remain a stable real repository file: ${repositoryPath} (${detail}).`);
+            const detail = effectiveInstructionFailureDetail(error);
+            rejectEffectiveInstructionInput("REPOSITORY_AGENT_WORKFLOW_INSTRUCTION_UNAVAILABLE", `The instruction candidate must remain a stable real repository file: ${repositoryPath} (${detail}).`);
         }
     }
     try {
-        const bytes = await readContainedRegularFile({
+        const bytes = await observation.read({
             candidate,
             maxBytes: MAXIMUM_INSTRUCTION_SOURCE_BYTES,
             root
@@ -148,19 +138,23 @@ async function readCandidate(root, directory, name, mode) {
         });
     }
     catch (error) {
-        const detail = error instanceof ContainedFileReadError ? error.failure : "unavailable";
-        inputError("REPOSITORY_AGENT_WORKFLOW_INSTRUCTION_UNAVAILABLE", `The instruction candidate must be a stable real file no larger than ${MAXIMUM_INSTRUCTION_SOURCE_BYTES} bytes: ${repositoryPath} (${detail}).`);
+        const detail = effectiveInstructionFailureDetail(error);
+        rejectEffectiveInstructionInput("REPOSITORY_AGENT_WORKFLOW_INSTRUCTION_UNAVAILABLE", `The instruction candidate must be a stable real file no larger than ${MAXIMUM_INSTRUCTION_SOURCE_BYTES} bytes: ${repositoryPath} (${detail}).`);
     }
 }
 export class FilesystemEffectiveInstructionsReader {
+    observation;
+    constructor(observation) {
+        this.observation = observation;
+    }
     async discover(input) {
-        assertNotCancelled(input.signal);
+        assertWorkflowObservationActive(input.signal);
         if (hasUnsafeDisplayCharacter(input.targetPath) ||
             win32.isAbsolute(input.targetPath) ||
             input.targetPath.normalize("NFC") !== input.targetPath) {
-            inputError("REPOSITORY_AGENT_WORKFLOW_TARGET_PATH_INVALID", "The target path must be a well-formed repository-relative POSIX path in Unicode NFC without control, bidirectional-formatting, or line-separator characters.");
+            rejectEffectiveInstructionInput("REPOSITORY_AGENT_WORKFLOW_TARGET_PATH_INVALID", "The target path must be a well-formed repository-relative POSIX path in Unicode NFC without control, bidirectional-formatting, or line-separator characters.");
         }
-        assertRepositoryRelativePath(input.targetPath, "repository-agent-workflow-effective-instructions");
+        assertEffectiveInstructionRepositoryPath(input.targetPath);
         const root = await resolveConsumerRoot(input.consumerRoot);
         const targetDirectory = posix.dirname(input.targetPath);
         const directories = await safeTargetDirectories(root, targetDirectory);
@@ -169,13 +163,13 @@ export class FilesystemEffectiveInstructionsReader {
             if (isMissing(error)) {
                 return null;
             }
-            inputError("REPOSITORY_AGENT_WORKFLOW_TARGET_UNAVAILABLE", `The target path is unavailable: ${input.targetPath}.`);
+            rejectEffectiveInstructionInput("REPOSITORY_AGENT_WORKFLOW_TARGET_UNAVAILABLE", `The target path is unavailable: ${input.targetPath}.`);
         });
         if (targetMetadata !== null &&
             (targetMetadata.isSymbolicLink() || !targetMetadata.isFile())) {
-            inputError("REPOSITORY_AGENT_WORKFLOW_TARGET_INVALID", `The target must be a repository file or a planned file path: ${input.targetPath}.`);
+            rejectEffectiveInstructionInput("REPOSITORY_AGENT_WORKFLOW_TARGET_INVALID", `The target must be a repository file or a planned file path: ${input.targetPath}.`);
         }
-        assertNotCancelled(input.signal);
+        assertWorkflowObservationActive(input.signal);
         return Object.freeze({
             targetPath: input.targetPath,
             targetDirectory,
@@ -183,15 +177,15 @@ export class FilesystemEffectiveInstructionsReader {
         });
     }
     async readDirectory(input) {
-        assertNotCancelled(input.signal);
+        assertWorkflowObservationActive(input.signal);
         if (input.directory !== ".") {
-            assertRepositoryRelativePath(input.directory, "repository-agent-workflow-effective-instructions");
+            assertEffectiveInstructionRepositoryPath(input.directory);
         }
         const root = await resolveConsumerRoot(input.consumerRoot);
         const directories = await safeTargetDirectories(root, input.directory);
         const directory = directories.at(-1);
         if (directory === undefined || directory.repositoryPath !== input.directory) {
-            inputError("REPOSITORY_AGENT_WORKFLOW_TARGET_DIRECTORY_INVALID", `The instruction directory is invalid: ${input.directory}.`);
+            rejectEffectiveInstructionInput("REPOSITORY_AGENT_WORKFLOW_TARGET_DIRECTORY_INVALID", `The instruction directory is invalid: ${input.directory}.`);
         }
         const candidates = [];
         let selected = false;
@@ -199,11 +193,11 @@ export class FilesystemEffectiveInstructionsReader {
             const mode = selected
                 ? "classify"
                 : input.readSelectedBytes ? "content" : "metadata";
-            const candidate = await readCandidate(root, directory, name, mode);
+            const candidate = await readCandidate(this.observation, root, directory, { name, mode });
             candidates.push(candidate);
             selected ||= candidate.kind === "file" || candidate.kind === "symlink";
         }
-        assertNotCancelled(input.signal);
+        assertWorkflowObservationActive(input.signal);
         return Object.freeze({
             directory: input.directory,
             candidates: Object.freeze(candidates)

package/dist/capabilities/repository-agent-workflow/adapters/outbound/filesystem/filesystem-effective-instructions-reader.js.map

@@ -1 +1 @@
-{"version":3,"file":"filesystem-effective-instructions-reader.js","sourceRoot":"","sources":["../../../../../../src/capabilities/repository-agent-workflow/adapters/outbound/filesystem/filesystem-effective-instructions-reader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"filesystem-effective-instructions-reader.js","sourceRoot":"","sources":["../../../../../../src/capabilities/repository-agent-workflow/adapters/outbound/filesystem/filesystem-effective-instructions-reader.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/repository-agent-workflow/adapters/outbound/filesystem/filesystem-repository-agent-workflow-reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filesystem-repository-agent-workflow-reader.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/repository-agent-workflow/adapters/outbound/filesystem/filesystem-repository-agent-workflow-reader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAGV,+BAA+B,EAC/B,6BAA6B,EAC9B,MAAM,yDAAyD,CAAC;AACjE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,gEAAgE,CAAC;AAwEpH,qBAAa,uCAAwC,YAAW,6BAA6B;IACrF,IAAI,CACR,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,6BAA6B,EACrC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,+BAA+B,CAAC,CAoB1C;CACF"}
+{"version":3,"file":"filesystem-repository-agent-workflow-reader.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/repository-agent-workflow/adapters/outbound/filesystem/filesystem-repository-agent-workflow-reader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAGV,+BAA+B,EAC/B,6BAA6B,EAC9B,MAAM,yDAAyD,CAAC;AACjE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,gEAAgE,CAAC;AA+DpH,qBAAa,uCAAwC,YAAW,6BAA6B;IACrF,IAAI,CACR,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,6BAA6B,EACrC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,+BAA+B,CAAC,CAoB1C;CACF"}

package/dist/capabilities/repository-agent-workflow/adapters/outbound/filesystem/filesystem-repository-agent-workflow-reader.js

@@ -1,17 +1,8 @@
 import { lstat, readFile, realpath } from "node:fs/promises";
 import { isAbsolute, relative, resolve, sep } from "node:path";
-import { CapabilityInputError } from "../../../../../capability-runtime.js";
-import { assertNotCancelled } from "../../../../../strict-yaml.js";
+import { assertWorkflowObservationActive, rejectWorkflowEvidence } from "../../../application/policies/workflow-input.js";
 const MAX_INSTRUCTION_BYTES = 256 * 1024;
 const PACKAGE_MANIFEST = "package.json";
-function inputError(code, message) {
-    throw new CapabilityInputError({
-        code,
-        message,
-        phase: "repository-agent-workflow-evidence",
-        retryable: false
-    });
-}
 function contained(root, candidate) {
     const relation = relative(root, candidate);
     return relation === "" || (!isAbsolute(relation) && relation !== ".." && !relation.startsWith(`..${sep}`));
@@ -49,10 +40,10 @@ async function readPackageScripts(root) {
         input = JSON.parse(await readFile(resolve(root, PACKAGE_MANIFEST), "utf8"));
     }
     catch {
-        inputError("REPOSITORY_AGENT_WORKFLOW_PACKAGE_INVALID", "package.json must be valid JSON.");
+        rejectWorkflowEvidence("REPOSITORY_AGENT_WORKFLOW_PACKAGE_INVALID", "package.json must be valid JSON.");
     }
     if (typeof input !== "object" || input === null || Array.isArray(input)) {
-        inputError("REPOSITORY_AGENT_WORKFLOW_PACKAGE_INVALID", "package.json must be an object.");
+        rejectWorkflowEvidence("REPOSITORY_AGENT_WORKFLOW_PACKAGE_INVALID", "package.json must be an object.");
     }
     const scriptsInput = input["scripts"];
     if (typeof scriptsInput !== "object" || scriptsInput === null || Array.isArray(scriptsInput)) {
@@ -68,10 +59,10 @@ async function readPackageScripts(root) {
 }
 export class FilesystemRepositoryAgentWorkflowReader {
     async read(consumerRoot, policy, signal) {
-        assertNotCancelled(signal);
-        const root = await realpath(consumerRoot).catch(() => inputError("REPOSITORY_AGENT_WORKFLOW_ROOT_UNAVAILABLE", "The consumer root is unavailable."));
+        assertWorkflowObservationActive(signal);
+        const root = await realpath(consumerRoot).catch(() => rejectWorkflowEvidence("REPOSITORY_AGENT_WORKFLOW_ROOT_UNAVAILABLE", "The consumer root is unavailable."));
         const entries = await Promise.all(Object.entries(policy.instructions).map(async ([kind, repositoryPath]) => [kind, await readInstruction(root, repositoryPath)]));
-        assertNotCancelled(signal);
+        assertWorkflowObservationActive(signal);
         return Object.freeze({
             instructionFiles: Object.freeze(Object.fromEntries(entries)),
             packageScripts: await readPackageScripts(root)

package/dist/capabilities/repository-agent-workflow/adapters/outbound/filesystem/filesystem-repository-agent-workflow-reader.js.map

@@ -1 +1 @@
-{"version":3,"file":"filesystem-repository-agent-workflow-reader.js","sourceRoot":"","sources":["../../../../../../src/capabilities/repository-agent-workflow/adapters/outbound/filesystem/filesystem-repository-agent-workflow-reader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"filesystem-repository-agent-workflow-reader.js","sourceRoot":"","sources":["../../../../../../src/capabilities/repository-agent-workflow/adapters/outbound/filesystem/filesystem-repository-agent-workflow-reader.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/repository-agent-workflow/adapters/outbound/git/git-repository-changes-reader.d.ts

@@ -1,6 +1,9 @@
 import type { RepositoryChangesReader } from "../../../application/ports/changed-workflow.js";
 import type { RepositoryChangeGroups } from "../../../application/model/changed-workflow.js";
+import type { ExecuteWorkflowProcess } from "../../../application/ports/process-execution.js";
 export declare class GitRepositoryChangesReader implements RepositoryChangesReader {
+    private readonly execute;
+    constructor(execute: ExecuteWorkflowProcess);
     collect(input: {
         readonly consumerRoot: string;
         readonly baseRef?: string;

package/dist/capabilities/repository-agent-workflow/adapters/outbound/git/git-repository-changes-reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-repository-changes-reader.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/repository-agent-workflow/adapters/outbound/git/git-repository-changes-reader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gDAAgD,CAAC;AAC9F,OAAO,KAAK,EAEV,sBAAsB,EACvB,MAAM,gDAAgD,CAAC;AAoZxD,qBAAa,0BAA2B,YAAW,uBAAuB;IAClE,OAAO,CAAC,KAAK,EAAE;QACnB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B;;;;;;iBAwCY,MAAM;;;;;;;;QASlB;CACF"}
+{"version":3,"file":"git-repository-changes-reader.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/repository-agent-workflow/adapters/outbound/git/git-repository-changes-reader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gDAAgD,CAAC;AAC9F,OAAO,KAAK,EAEV,sBAAsB,EACvB,MAAM,gDAAgD,CAAC;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iDAAiD,CAAC;AA+Y9F,qBAAa,0BAA2B,YAAW,uBAAuB;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO;IAApC,YAA6B,OAAO,EAAE,sBAAsB,EAAI;IAE1D,OAAO,CAAC,KAAK,EAAE;QACnB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B;;;;;;iBAyCY,MAAM;;;;;;;;QASlB;CACF"}

package/dist/capabilities/repository-agent-workflow/adapters/outbound/git/git-repository-changes-reader.js

@@ -1,7 +1,6 @@
 import { lstat, realpath } from "node:fs/promises";
 import { isAbsolute, relative, resolve, sep } from "node:path";
-import { FoundationError } from "../../../../../errors.js";
-import { execute } from "../process/process-execution.js";
+import { rejectChangedWorkflowInput } from "../../../application/policies/workflow-input.js";
 const AUTO_BASE_REFS = [
     { display: "origin/main", ref: "refs/remotes/origin/main" },
     { display: "origin/master", ref: "refs/remotes/origin/master" },
@@ -20,19 +19,16 @@ const GIT_HARDENING = [
     "-c",
     "diff.renames=false"
 ];
-function invalid(message) {
-    throw new FoundationError("CONSUMER_INVALID", message);
-}
 function parseNullDelimited(value, context) {
     if (value.length === 0) {
         return [];
     }
     if (!value.endsWith("\0")) {
-        invalid(`Git returned malformed NUL-delimited ${context} evidence.`);
+        rejectChangedWorkflowInput(`Git returned malformed NUL-delimited ${context} evidence.`);
     }
     const paths = value.slice(0, -1).split("\0");
     if (paths.some((path) => path.length === 0)) {
-        invalid(`Git returned an empty path in ${context} evidence.`);
+        rejectChangedWorkflowInput(`Git returned an empty path in ${context} evidence.`);
     }
     return paths;
 }
@@ -56,10 +52,10 @@ function assertSafeRepositoryPath(path) {
         path === ".." ||
         path.startsWith("../") ||
         path.includes("/../")) {
-        invalid(`Git reported an unsafe repository path: ${JSON.stringify(path)}.`);
+        rejectChangedWorkflowInput(`Git reported an unsafe repository path: ${JSON.stringify(path)}.`);
     }
 }
-async function git(root, args, signal) {
+async function git(execute, root, args, signal) {
     try {
         return await execute("git", [...GIT_HARDENING, ...args], {
             cwd: root,
@@ -69,7 +65,7 @@ async function git(root, args, signal) {
     }
     catch (error) {
         if (error instanceof Error && /not valid UTF-8/u.test(error.message)) {
-            invalid("Git returned repository evidence that is not valid UTF-8.");
+            rejectChangedWorkflowInput("Git returned repository evidence that is not valid UTF-8.");
         }
         throw error;
     }
@@ -77,38 +73,38 @@ async function git(root, args, signal) {
 function exactCommit(value, context) {
     const commit = value.replace(/\r?\n$/u, "");
     if (!FULL_COMMIT.test(commit)) {
-        invalid(`Git did not return an immutable ${context} commit identifier.`);
+        rejectChangedWorkflowInput(`Git did not return an immutable ${context} commit identifier.`);
     }
     return commit.toLowerCase();
 }
-async function resolveCommit(root, ref, signal) {
-    const resolved = await git(root, ["rev-parse", "--verify", "--quiet", "--end-of-options", `${ref}^{commit}`], signal);
+async function resolveCommit(execute, root, ref, signal) {
+    const resolved = await git(execute, root, ["rev-parse", "--verify", "--quiet", "--end-of-options", `${ref}^{commit}`], signal);
     if (resolved.exitCode === 0) {
         return exactCommit(resolved.stdout, "resolved");
     }
     if (resolved.exitCode === 1) {
         return null;
     }
-    invalid(`Git could not resolve an immutable commit: ${resolved.stderr.trim() || "git rev-parse failed"}.`);
+    rejectChangedWorkflowInput(`Git could not resolve an immutable commit: ${resolved.stderr.trim() || "git rev-parse failed"}.`);
 }
-async function assertExactRef(root, ref, signal) {
-    const result = await git(root, ["check-ref-format", ref], signal);
+async function assertExactRef(execute, root, ref, signal) {
+    const result = await git(execute, root, ["check-ref-format", ref], signal);
     if (result.exitCode === 0) {
         return;
     }
     if (result.exitCode === 1) {
-        invalid(`The explicit base ref ${JSON.stringify(ref)} is not an exact Git ref name.`);
+        rejectChangedWorkflowInput(`The explicit base ref ${JSON.stringify(ref)} is not an exact Git ref name.`);
     }
-    invalid(`Git could not validate the explicit base ref: ${result.stderr.trim() || "git check-ref-format failed"}.`);
+    rejectChangedWorkflowInput(`Git could not validate the explicit base ref: ${result.stderr.trim() || "git check-ref-format failed"}.`);
 }
-async function resolveRequestedRef(root, requested, signal) {
+async function resolveRequestedRef(execute, root, requested, signal) {
     if (requested === "HEAD" || FULL_COMMIT.test(requested)) {
-        const commit = await resolveCommit(root, requested, signal);
+        const commit = await resolveCommit(execute, root, requested, signal);
         return commit === null ? null : { ref: requested, commit };
     }
     if (requested.startsWith("refs/")) {
-        await assertExactRef(root, requested, signal);
-        const commit = await resolveCommit(root, requested, signal);
+        await assertExactRef(execute, root, requested, signal);
+        const commit = await resolveCommit(execute, root, requested, signal);
         return commit === null ? null : { ref: requested, commit };
     }
     const candidates = [
@@ -116,39 +112,39 @@ async function resolveRequestedRef(root, requested, signal) {
         `refs/remotes/${requested}`,
         `refs/tags/${requested}`
     ];
-    await assertExactRef(root, `refs/heads/${requested}`, signal);
-    const matches = (await Promise.all(candidates.map(async (ref) => ({ ref, commit: await resolveCommit(root, ref, signal) })))).filter((match) => match.commit !== null);
+    await assertExactRef(execute, root, `refs/heads/${requested}`, signal);
+    const matches = (await Promise.all(candidates.map(async (ref) => ({ ref, commit: await resolveCommit(execute, root, ref, signal) })))).filter((match) => match.commit !== null);
     if (matches.length > 1) {
-        invalid(`The explicit base ref ${JSON.stringify(requested)} is ambiguous: ${matches.map(({ ref }) => ref).join(", ")}.`);
+        rejectChangedWorkflowInput(`The explicit base ref ${JSON.stringify(requested)} is ambiguous: ${matches.map(({ ref }) => ref).join(", ")}.`);
     }
     return matches[0] ?? null;
 }
-async function uniqueMergeBase(root, headCommit, baseCommit, signal) {
-    const result = await git(root, ["merge-base", "--all", "--", headCommit, baseCommit], signal);
+async function uniqueMergeBase(execute, root, headCommit, baseCommit, signal) {
+    const result = await git(execute, root, ["merge-base", "--all", "--", headCommit, baseCommit], signal);
     if (result.exitCode === 1) {
         return null;
     }
     if (result.exitCode !== 0) {
-        invalid(`Git could not inspect merge bases: ${result.stderr.trim() || "git merge-base failed"}.`);
+        rejectChangedWorkflowInput(`Git could not inspect merge bases: ${result.stderr.trim() || "git merge-base failed"}.`);
     }
     const lines = result.stdout.split(/\r?\n/u);
     if (lines.at(-1) === "") {
         lines.pop();
     }
     if (lines.length === 0) {
-        invalid("Git did not return a merge-base commit identifier.");
+        rejectChangedWorkflowInput("Git did not return a merge-base commit identifier.");
     }
     const commits = lines.map((value) => exactCommit(value, "merge-base"));
     if (commits.length !== 1) {
-        invalid(`Git reported ${String(commits.length)} merge bases; changed scope requires one unique merge base.`);
+        rejectChangedWorkflowInput(`Git reported ${String(commits.length)} merge bases; changed scope requires one unique merge base.`);
     }
     return commits[0] ?? null;
 }
-async function resolveBaseline(root, requested, signal) {
-    const headCommit = await resolveCommit(root, "HEAD", signal);
+async function resolveBaseline(execute, root, requested, signal) {
+    const headCommit = await resolveCommit(execute, root, "HEAD", signal);
     if (headCommit === null) {
         if (requested !== undefined) {
-            invalid("An explicit base cannot be resolved before the repository has an initial commit.");
+            rejectChangedWorkflowInput("An explicit base cannot be resolved before the repository has an initial commit.");
         }
         return {
             requestedRef: null,
@@ -166,13 +162,13 @@ async function resolveBaseline(root, requested, signal) {
     let resolvedCandidateCount = 0;
     for (const candidate of candidates) {
         const resolved = requested === undefined
-            ? await resolveCommit(root, candidate.ref, signal).then((commit) => commit === null ? null : { ref: candidate.ref, commit })
-            : await resolveRequestedRef(root, candidate.ref, signal);
+            ? await resolveCommit(execute, root, candidate.ref, signal).then((commit) => commit === null ? null : { ref: candidate.ref, commit })
+            : await resolveRequestedRef(execute, root, candidate.ref, signal);
         if (resolved === null) {
             continue;
         }
         resolvedCandidateCount += 1;
-        const mergeBaseCommit = await uniqueMergeBase(root, headCommit, resolved.commit, signal);
+        const mergeBaseCommit = await uniqueMergeBase(execute, root, headCommit, resolved.commit, signal);
         if (mergeBaseCommit !== null) {
             return {
                 requestedRef: requested ?? null,
@@ -186,10 +182,10 @@ async function resolveBaseline(root, requested, signal) {
         }
     }
     if (requested !== undefined) {
-        invalid(`Unable to resolve one exact merge base for ${JSON.stringify(requested)}.`);
+        rejectChangedWorkflowInput(`Unable to resolve one exact merge base for ${JSON.stringify(requested)}.`);
     }
     if (resolvedCandidateCount > 0) {
-        invalid("Unable to establish a merge base from the discovered refs; the history may be shallow or unrelated. Fetch the required history or pass an explicit base.");
+        rejectChangedWorkflowInput("Unable to establish a merge base from the discovered refs; the history may be shallow or unrelated. Fetch the required history or pass an explicit base.");
     }
     return {
         requestedRef: null,
@@ -207,14 +203,14 @@ async function existingFiles(root, paths) {
         const candidate = resolve(root, path);
         const relation = relative(root, candidate);
         if (relation.startsWith(`..${sep}`) || relation === "..") {
-            invalid(`Changed path escapes the repository: ${path}.`);
+            rejectChangedWorkflowInput(`Changed path escapes the repository: ${path}.`);
         }
         const metadata = await lstat(candidate).catch(() => null);
         if (metadata === null) {
             continue;
         }
         if (!metadata.isFile()) {
-            invalid(`Changed path is not a regular file: ${path}.`);
+            rejectChangedWorkflowInput(`Changed path is not a regular file: ${path}.`);
         }
         result.push(path);
     }
@@ -227,14 +223,14 @@ const DIFF_PATH_OPTIONS = [
     "--name-only",
     "-z"
 ];
-async function diffGroup(root, prefix, signal) {
+async function diffGroup(execute, root, prefix, signal) {
     const [all, deleted] = await Promise.all([
-        git(root, ["diff", ...prefix, ...DIFF_PATH_OPTIONS, "--end-of-options", "--"], signal),
-        git(root, ["diff", ...prefix, "--diff-filter=D", ...DIFF_PATH_OPTIONS, "--end-of-options", "--"], signal)
+        git(execute, root, ["diff", ...prefix, ...DIFF_PATH_OPTIONS, "--end-of-options", "--"], signal),
+        git(execute, root, ["diff", ...prefix, "--diff-filter=D", ...DIFF_PATH_OPTIONS, "--end-of-options", "--"], signal)
     ]);
     for (const result of [all, deleted]) {
         if (result.exitCode !== 0) {
-            invalid(`Unable to inspect repository changes: ${result.stderr.trim() || "git diff failed"}.`);
+            rejectChangedWorkflowInput(`Unable to inspect repository changes: ${result.stderr.trim() || "git diff failed"}.`);
         }
     }
     return Object.freeze({
@@ -242,17 +238,17 @@ async function diffGroup(root, prefix, signal) {
         deletedPaths: Object.freeze([...new Set(parseNullDelimited(deleted.stdout, "deleted-path"))].toSorted(comparePaths))
     });
 }
-async function changedPathGroups(root, baseline, signal) {
+async function changedPathGroups(execute, root, baseline, signal) {
     const committed = baseline.baselineCommit === null || baseline.headCommit === null
         ? Object.freeze({ paths: Object.freeze([]), deletedPaths: Object.freeze([]) })
-        : await diffGroup(root, [`${baseline.baselineCommit}..${baseline.headCommit}`], signal);
+        : await diffGroup(execute, root, [`${baseline.baselineCommit}..${baseline.headCommit}`], signal);
     const [staged, unstaged, untrackedResult] = await Promise.all([
-        diffGroup(root, ["--cached"], signal),
-        diffGroup(root, [], signal),
-        git(root, ["ls-files", "--others", "--exclude-standard", "-z", "--"], signal)
+        diffGroup(execute, root, ["--cached"], signal),
+        diffGroup(execute, root, [], signal),
+        git(execute, root, ["ls-files", "--others", "--exclude-standard", "-z", "--"], signal)
     ]);
     if (untrackedResult.exitCode !== 0) {
-        invalid(`Unable to inspect repository changes: ${untrackedResult.stderr.trim() || "git ls-files failed"}.`);
+        rejectChangedWorkflowInput(`Unable to inspect repository changes: ${untrackedResult.stderr.trim() || "git ls-files failed"}.`);
     }
     const untracked = Object.freeze({
         paths: Object.freeze([...new Set(parseNullDelimited(untrackedResult.stdout, "untracked-path"))].toSorted(comparePaths)),
@@ -275,21 +271,26 @@ async function scopeDigest(baseline, groups) {
     return `sha256:${Buffer.from(digest).toString("hex")}`;
 }
 export class GitRepositoryChangesReader {
+    execute;
+    constructor(execute) {
+        this.execute = execute;
+    }
     async collect(input) {
+        const execute = this.execute;
         if (input.baseRef !== undefined && input.baseRef.startsWith("-")) {
-            invalid("The base ref cannot start with a dash.");
+            rejectChangedWorkflowInput("The base ref cannot start with a dash.");
         }
-        const root = await realpath(input.consumerRoot).catch(() => invalid("The consumer root is unavailable."));
-        const topLevel = await git(root, ["rev-parse", "--show-toplevel"], input.signal);
+        const root = await realpath(input.consumerRoot).catch(() => rejectChangedWorkflowInput("The consumer root is unavailable."));
+        const topLevel = await git(execute, root, ["rev-parse", "--show-toplevel"], input.signal);
         if (topLevel.exitCode !== 0) {
-            invalid("The consumer root must be a Git repository.");
+            rejectChangedWorkflowInput("The consumer root must be a Git repository.");
         }
         const gitRoot = await realpath(topLevel.stdout.trim());
         if (gitRoot !== root) {
-            invalid("The consumer root must be the Git repository root.");
+            rejectChangedWorkflowInput("The consumer root must be the Git repository root.");
         }
-        const baseline = await resolveBaseline(root, input.baseRef, input.signal);
-        const changeGroups = await changedPathGroups(root, baseline, input.signal);
+        const baseline = await resolveBaseline(execute, root, input.baseRef, input.signal);
+        const changeGroups = await changedPathGroups(execute, root, baseline, input.signal);
         const groups = [
             changeGroups.committed,
             changeGroups.staged,