@agent-teams/engineering-foundation 0.17.0-rc.8 → 0.17.0

package/dist/capabilities/repository-agent-workflow/adapters/inbound/cli/report-renderer.js

@@ -4,6 +4,11 @@ export function renderAgentWorkflowReport(report) {
         `Agent workflow: ${report.outcome}`,
         `Coverage: ${report.coverage}`,
         `Baseline: ${report.baselineRef}${report.baselineCommit === null ? "" : ` (${report.baselineCommit})`}`,
+        `Base: ${report.resolvedBaseRef}${report.baseCommit === null ? "" : ` (${report.baseCommit})`}`,
+        `Head: ${report.headRef}${report.headCommit === null ? "" : ` (${report.headCommit})`}`,
+        `Merge base: ${report.mergeBaseCommit ?? "none"}`,
+        `Scope digest: ${report.scopeDigest}`,
+        `Evidence groups: committed ${report.changeGroups.committed.paths.length}, staged ${report.changeGroups.staged.paths.length}, unstaged ${report.changeGroups.unstaged.paths.length}, untracked ${report.changeGroups.untracked.paths.length}`,
         `Changed paths: ${report.changedPaths.length}`
     ];
     if (report.changedPaths.length > 0) {
@@ -23,4 +28,31 @@ export function renderAgentWorkflowReport(report) {
     }
     return `${lines.join("\n")}\n`;
 }
+export function renderEffectiveInstructionsReport(report) {
+    const lines = [
+        `Effective instructions for ${report.target.path}`,
+        `Target directory: ${report.target.directory}`,
+        `Loaded: ${report.budget.loadedBytes}/${report.budget.maximumBytes} bytes`,
+        `Resolution digest: ${report.resolutionDigest}`
+    ];
+    if (report.layers.length === 0) {
+        lines.push("Applicable instruction files: none");
+    }
+    for (const layer of report.layers) {
+        lines.push(`${layer.order}. ${layer.selectedPath} [${layer.status}]`, `   Scope: ${layer.scope}`, `   Size: ${layer.loadedBytes}/${layer.sourceBytes} bytes`, `   Source digest: ${layer.sourceDigest ?? "not read (budget exhausted)"}`, `   Loaded digest: ${layer.loadedDigest}`, "   Why: first regular candidate in an ancestor directory of the target");
+        if (layer.canOverrideEarlier.length > 0) {
+            lines.push(`   Can override earlier: ${layer.canOverrideEarlier.join(", ")}`);
+        }
+        for (const shadowed of layer.shadowed) {
+            lines.push(`   Shadowed: ${shadowed.path} (higher-priority candidate selected)`);
+        }
+    }
+    if (report.budget.truncated) {
+        lines.push("Warning: the final applied instruction file was truncated by the byte budget.");
+    }
+    if (report.budget.exhausted) {
+        lines.push("Warning: later instruction layers may be excluded because the byte budget is exhausted.");
+    }
+    return `${lines.join("\n")}\n`;
+}
 //# sourceMappingURL=report-renderer.js.map

package/dist/capabilities/repository-agent-workflow/adapters/inbound/cli/report-renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"report-renderer.js","sourceRoot":"","sources":["../../../../../../src/capabilities/repository-agent-workflow/adapters/inbound/cli/report-renderer.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,yBAAyB,CAAC,MAAkC;IAC1E,MAAM,cAAc,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG;QACZ,mBAAmB,MAAM,CAAC,OAAO,EAAE;QACnC,aAAa,MAAM,CAAC,QAAQ,EAAE;QAC9B,aAAa,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,cAAc,GAAG,EAAE;QACvG,kBAAkB,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE;KAC/C,CAAC;IACF,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;QACzD,IAAI,cAAc,CAAC,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;YACvD,KAAK,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,OAAO,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAC5D,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,SAAS,CAAC,CAAC;QAC7F,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC"}
+{"version":3,"file":"report-renderer.js","sourceRoot":"","sources":["../../../../../../src/capabilities/repository-agent-workflow/adapters/inbound/cli/report-renderer.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,yBAAyB,CAAC,MAAkC;IAC1E,MAAM,cAAc,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG;QACZ,mBAAmB,MAAM,CAAC,OAAO,EAAE;QACnC,aAAa,MAAM,CAAC,QAAQ,EAAE;QAC9B,aAAa,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,cAAc,GAAG,EAAE;QACvG,SAAS,MAAM,CAAC,eAAe,GAAG,MAAM,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,UAAU,GAAG,EAAE;QAC/F,SAAS,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,UAAU,GAAG,EAAE;QACvF,eAAe,MAAM,CAAC,eAAe,IAAI,MAAM,EAAE;QACjD,iBAAiB,MAAM,CAAC,WAAW,EAAE;QACrC,8BAA8B,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,YAAY,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,cAAc,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,eAAe,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE;QAC7O,kBAAkB,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE;KAC/C,CAAC;IACF,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;QACzD,IAAI,cAAc,CAAC,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;YACvD,KAAK,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,OAAO,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAC5D,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,SAAS,CAAC,CAAC;QAC7F,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,MAAmC;IAEnC,MAAM,KAAK,GAAG;QACZ,8BAA8B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QAClD,qBAAqB,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE;QAC9C,WAAW,MAAM,CAAC,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,MAAM,CAAC,YAAY,QAAQ;QAC1E,sBAAsB,MAAM,CAAC,gBAAgB,EAAE;KAChD,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACnD,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CACR,GAAG,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,YAAY,KAAK,KAAK,CAAC,MAAM,GAAG,EACzD,aAAa,KAAK,CAAC,KAAK,EAAE,EAC1B,YAAY,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,QAAQ,EAC1D,qBAAqB,KAAK,CAAC,YAAY,IAAI,6BAA6B,EAAE,EAC1E,qBAAqB,KAAK,CAAC,YAAY,EAAE,EACzC,wEAAwE,CACzE,CAAC;QACF,IAAI,KAAK,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,4BAA4B,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChF,CAAC;QACD,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,gBAAgB,QAAQ,CAAC,IAAI,uCAAuC,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;IAC9F,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,yFAAyF,CAAC,CAAC;IACxG,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC"}

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

@@ -0,0 +1,16 @@
+import type { EffectiveInstructionDirectoryObservation, EffectiveInstructionDiscovery } from "../../../application/model/effective-instructions.js";
+import type { EffectiveInstructionsReader } from "../../../application/ports/effective-instructions-reader.js";
+export declare class FilesystemEffectiveInstructionsReader implements EffectiveInstructionsReader {
+    discover(input: {
+        readonly consumerRoot: string;
+        readonly targetPath: string;
+        readonly signal?: AbortSignal;
+    }): Promise<EffectiveInstructionDiscovery>;
+    readDirectory(input: {
+        readonly consumerRoot: string;
+        readonly directory: string;
+        readonly readSelectedBytes: boolean;
+        readonly signal?: AbortSignal;
+    }): Promise<EffectiveInstructionDirectoryObservation>;
+}
+//# sourceMappingURL=filesystem-effective-instructions-reader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-effective-instructions-reader.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/repository-agent-workflow/adapters/outbound/filesystem/filesystem-effective-instructions-reader.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAEV,wCAAwC,EACxC,6BAA6B,EAC9B,MAAM,sDAAsD,CAAC;AAE9D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,6DAA6D,CAAC;AAsM/G,qBAAa,qCAAsC,YAAW,2BAA2B;IACjF,QAAQ,CAAC,KAAK,EAAE;QACpB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,GAAG,OAAO,CAAC,6BAA6B,CAAC,CA0CzC;IAEK,aAAa,CAAC,KAAK,EAAE;QACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;QACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,GAAG,OAAO,CAAC,wCAAwC,CAAC,CAqCpD;CACF"}

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

@@ -0,0 +1,213 @@
+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 { 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";
+}
+function contained(root, candidate) {
+    const relation = relative(root, candidate);
+    return relation === "" ||
+        (!isAbsolute(relation) && relation !== ".." && !relation.startsWith(`..${sep}`));
+}
+function hasUnsafeDisplayCharacter(value) {
+    for (const character of value) {
+        const codePoint = character.codePointAt(0);
+        if (codePoint === undefined ||
+            codePoint <= 0x1f ||
+            (codePoint >= 0x7f && codePoint <= 0x9f) ||
+            (codePoint >= 0xd800 && codePoint <= 0xdfff) ||
+            codePoint === 0x2028 ||
+            codePoint === 0x2029 ||
+            codePoint === 0x061c ||
+            (codePoint >= 0x200e && codePoint <= 0x200f) ||
+            (codePoint >= 0x202a && codePoint <= 0x202e) ||
+            (codePoint >= 0x2066 && codePoint <= 0x2069)) {
+            return true;
+        }
+    }
+    return false;
+}
+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.");
+        }
+        return root;
+    }
+    catch (error) {
+        if (error instanceof CapabilityInputError) {
+            throw error;
+        }
+        inputError("REPOSITORY_AGENT_WORKFLOW_ROOT_UNAVAILABLE", "The consumer root is unavailable.");
+    }
+}
+async function safeTargetDirectories(root, targetDirectory) {
+    const directories = [{ absolute: root, repositoryPath: "." }];
+    let absolute = root;
+    let repositoryPath = "";
+    const segments = targetDirectory === "." ? [] : targetDirectory.split("/");
+    for (const segment of segments) {
+        const next = join(absolute, segment);
+        let metadata;
+        try {
+            metadata = await lstat(next);
+        }
+        catch (error) {
+            if (isMissing(error)) {
+                inputError("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}.`);
+        }
+        if (metadata.isSymbolicLink() || !metadata.isDirectory()) {
+            inputError("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}.`));
+        if (!contained(root, canonical)) {
+            inputError("REPOSITORY_AGENT_WORKFLOW_TARGET_DIRECTORY_ESCAPE", `The target directory escapes the consumer repository: ${targetDirectory}.`);
+        }
+        absolute = canonical;
+        repositoryPath = repositoryPath.length === 0
+            ? segment
+            : posix.join(repositoryPath, segment);
+        directories.push({ absolute, repositoryPath });
+    }
+    return Object.freeze(directories);
+}
+async function readCandidate(root, directory, name, mode) {
+    const repositoryPath = directory.repositoryPath === "."
+        ? name
+        : posix.join(directory.repositoryPath, name);
+    const candidate = join(directory.absolute, name);
+    let metadata;
+    try {
+        metadata = await lstat(candidate);
+    }
+    catch (error) {
+        if (isMissing(error)) {
+            return Object.freeze({ kind: "missing", path: repositoryPath });
+        }
+        inputError("REPOSITORY_AGENT_WORKFLOW_INSTRUCTION_UNAVAILABLE", `The instruction candidate is unavailable: ${repositoryPath}.`);
+    }
+    if (metadata.isSymbolicLink()) {
+        return Object.freeze({ kind: "symlink", path: repositoryPath });
+    }
+    if (!metadata.isFile()) {
+        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}.`);
+    }
+    if (mode === "classify") {
+        return Object.freeze({
+            kind: "file",
+            path: repositoryPath,
+            sourceBytes: metadata.size,
+            bytes: null
+        });
+    }
+    if (mode === "metadata") {
+        try {
+            const observation = await inspectContainedRegularFile({ candidate, root });
+            return Object.freeze({
+                kind: "file",
+                path: repositoryPath,
+                sourceBytes: observation.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}).`);
+        }
+    }
+    try {
+        const bytes = await readContainedRegularFile({
+            candidate,
+            maxBytes: MAXIMUM_INSTRUCTION_SOURCE_BYTES,
+            root
+        });
+        return Object.freeze({
+            kind: "file",
+            path: repositoryPath,
+            sourceBytes: bytes.byteLength,
+            bytes
+        });
+    }
+    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}).`);
+    }
+}
+export class FilesystemEffectiveInstructionsReader {
+    async discover(input) {
+        assertNotCancelled(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.");
+        }
+        assertRepositoryRelativePath(input.targetPath, "repository-agent-workflow-effective-instructions");
+        const root = await resolveConsumerRoot(input.consumerRoot);
+        const targetDirectory = posix.dirname(input.targetPath);
+        const directories = await safeTargetDirectories(root, targetDirectory);
+        const target = join(root, ...input.targetPath.split("/"));
+        const targetMetadata = await lstat(target).catch((error) => {
+            if (isMissing(error)) {
+                return null;
+            }
+            inputError("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}.`);
+        }
+        assertNotCancelled(input.signal);
+        return Object.freeze({
+            targetPath: input.targetPath,
+            targetDirectory,
+            directories: Object.freeze(directories.map(({ repositoryPath }) => repositoryPath))
+        });
+    }
+    async readDirectory(input) {
+        assertNotCancelled(input.signal);
+        if (input.directory !== ".") {
+            assertRepositoryRelativePath(input.directory, "repository-agent-workflow-effective-instructions");
+        }
+        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}.`);
+        }
+        const candidates = [];
+        let selected = false;
+        for (const name of EFFECTIVE_INSTRUCTION_CANDIDATE_NAMES) {
+            const mode = selected
+                ? "classify"
+                : input.readSelectedBytes ? "content" : "metadata";
+            const candidate = await readCandidate(root, directory, name, mode);
+            candidates.push(candidate);
+            selected ||= candidate.kind === "file" || candidate.kind === "symlink";
+        }
+        assertNotCancelled(input.signal);
+        return Object.freeze({
+            directory: input.directory,
+            candidates: Object.freeze(candidates)
+        });
+    }
+}
+//# sourceMappingURL=filesystem-effective-instructions-reader.js.map

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

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

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

@@ -1,4 +1,5 @@
 import type { RepositoryChangesReader } from "../../../application/ports/changed-workflow.js";
+import type { RepositoryChangeGroups } from "../../../application/model/changed-workflow.js";
 export declare class GitRepositoryChangesReader implements RepositoryChangesReader {
     collect(input: {
         readonly consumerRoot: string;
@@ -7,6 +8,14 @@ export declare class GitRepositoryChangesReader implements RepositoryChangesRead
     }): Promise<Readonly<{
         baselineRef: string;
         baselineCommit: string | null;
+        requestedBaseRef: string | null;
+        resolvedBaseRef: string;
+        baseCommit: string | null;
+        headRef: "HEAD";
+        headCommit: string | null;
+        mergeBaseCommit: string | null;
+        changeGroups: RepositoryChangeGroups;
+        scopeDigest: string;
         changedPaths: readonly string[];
         deletedPaths: readonly string[];
         existingPaths: readonly 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;AAqK9F,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;;;;;;QA2BA;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;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"}