@agent-teams/engineering-foundation 0.4.1 → 0.6.0

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

@@ -0,0 +1,153 @@
+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";
+const AUTO_BASE_REFS = ["origin/main", "origin/master", "main", "master"];
+function invalid(message) {
+    throw new FoundationError("CONSUMER_INVALID", message);
+}
+function parseNullDelimited(value) {
+    return value
+        .split("\0")
+        .filter((path) => path.length > 0);
+}
+function hasControlCharacter(value) {
+    for (let index = 0; index < value.length; index += 1) {
+        const codeUnit = value.charCodeAt(index);
+        if (codeUnit <= 31 || codeUnit === 127) {
+            return true;
+        }
+    }
+    return false;
+}
+function assertSafeRepositoryPath(path) {
+    if (path.includes("\0") ||
+        hasControlCharacter(path) ||
+        path.includes("\\") ||
+        isAbsolute(path) ||
+        path === ".." ||
+        path.startsWith("../") ||
+        path.includes("/../")) {
+        invalid(`Git reported an unsafe repository path: ${JSON.stringify(path)}.`);
+    }
+}
+async function git(cwd, args, signal) {
+    return execute("git", args, { cwd, ...(signal === undefined ? {} : { signal }) });
+}
+async function resolveBaseline(root, requested, signal) {
+    const head = await git(root, ["rev-parse", "--verify", "HEAD^{commit}"], signal);
+    if (head.exitCode !== 0) {
+        if (requested !== undefined) {
+            invalid("An explicit base cannot be resolved before the repository has an initial commit.");
+        }
+        return { ref: "unborn-head", commit: null };
+    }
+    const candidates = requested === undefined ? AUTO_BASE_REFS : [requested];
+    for (const candidate of candidates) {
+        const resolved = await git(root, ["rev-parse", "--verify", `${candidate}^{commit}`], signal);
+        if (resolved.exitCode !== 0) {
+            continue;
+        }
+        const mergeBase = await git(root, ["merge-base", "HEAD", resolved.stdout.trim()], signal);
+        if (mergeBase.exitCode === 0 && mergeBase.stdout.trim().length > 0) {
+            return { ref: candidate, commit: mergeBase.stdout.trim() };
+        }
+    }
+    if (requested !== undefined) {
+        invalid(`Unable to resolve an exact merge base for ${requested}.`);
+    }
+    return { ref: "HEAD", commit: head.stdout.trim() };
+}
+async function existingFiles(root, paths) {
+    const result = [];
+    for (const path of paths) {
+        const candidate = resolve(root, path);
+        const relation = relative(root, candidate);
+        if (relation.startsWith(`..${sep}`) || relation === "..") {
+            invalid(`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}.`);
+        }
+        result.push(path);
+    }
+    return Object.freeze(result);
+}
+async function changedPathGroups(root, baselineCommit, signal) {
+    const common = [
+        "--no-renames",
+        "--name-only",
+        "-z"
+    ];
+    const trackedCommands = [
+        ...(baselineCommit === null
+            ? []
+            : [["diff", ...common, `${baselineCommit}..HEAD`]]),
+        ["diff", ...common],
+        ["diff", "--cached", ...common]
+    ];
+    const commands = [
+        ...trackedCommands.map((args) => ({
+            kind: "changed",
+            args: [...args.slice(0, 2), "--diff-filter=ACMRDTUXB", ...args.slice(2)]
+        })),
+        ...trackedCommands.map((args) => ({
+            kind: "deleted",
+            args: [...args.slice(0, 2), "--diff-filter=D", ...args.slice(2)]
+        })),
+        {
+            kind: "changed",
+            args: ["ls-files", "--others", "--exclude-standard", "-z"]
+        }
+    ];
+    const results = await Promise.all(commands.map(async ({ kind, args }) => ({
+        kind,
+        result: await git(root, args, signal)
+    })));
+    for (const { result } of results) {
+        if (result.exitCode !== 0) {
+            invalid(`Unable to inspect repository changes: ${result.stderr.trim() || "git failed"}.`);
+        }
+    }
+    return Object.freeze({
+        changed: Object.freeze(results
+            .filter(({ kind }) => kind === "changed")
+            .map(({ result }) => parseNullDelimited(result.stdout))),
+        deleted: Object.freeze(results
+            .filter(({ kind }) => kind === "deleted")
+            .map(({ result }) => parseNullDelimited(result.stdout)))
+    });
+}
+export class GitRepositoryChangesReader {
+    async collect(input) {
+        if (input.baseRef !== undefined && input.baseRef.startsWith("-")) {
+            invalid("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);
+        if (topLevel.exitCode !== 0) {
+            invalid("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.");
+        }
+        const baseline = await resolveBaseline(root, input.baseRef, input.signal);
+        const groups = await changedPathGroups(root, baseline.commit, input.signal);
+        const changedPaths = [...new Set(groups.changed.flat())].toSorted();
+        const deletedPaths = [...new Set(groups.deleted.flat())].toSorted();
+        [...changedPaths, ...deletedPaths].forEach(assertSafeRepositoryPath);
+        return Object.freeze({
+            baselineRef: baseline.ref,
+            baselineCommit: baseline.commit,
+            changedPaths: Object.freeze(changedPaths),
+            deletedPaths: Object.freeze(deletedPaths),
+            existingPaths: await existingFiles(root, changedPaths)
+        });
+    }
+}
+//# sourceMappingURL=git-repository-changes-reader.js.map

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

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

package/dist/capabilities/repository-agent-workflow/adapters/outbound/pnpm/pnpm-package-script-runner.d.ts

@@ -0,0 +1,17 @@
+import type { PackageScriptRunner } from "../../../application/ports/changed-workflow.js";
+export interface PnpmProcessEnvironment {
+    readonly npmExecPath?: string;
+    readonly pnpmHome?: string;
+    readonly pathValue?: string;
+}
+export declare class PnpmPackageScriptRunner implements PackageScriptRunner {
+    private readonly environment;
+    constructor(environment: PnpmProcessEnvironment);
+    run(input: {
+        readonly consumerRoot: string;
+        readonly script: string;
+        readonly paths: readonly string[];
+        readonly signal?: AbortSignal;
+    }): Promise<import("../process/process-execution.js").ProcessExecution>;
+}
+//# sourceMappingURL=pnpm-package-script-runner.d.ts.map

package/dist/capabilities/repository-agent-workflow/adapters/outbound/pnpm/pnpm-package-script-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnpm-package-script-runner.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/repository-agent-workflow/adapters/outbound/pnpm/pnpm-package-script-runner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AAI1F,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAmED,qBAAa,uBAAwB,YAAW,mBAAmB;IACrD,OAAO,CAAC,QAAQ,CAAC,WAAW;IAAxC,YAA6B,WAAW,EAAE,sBAAsB,EAAI;IAE9D,GAAG,CAAC,KAAK,EAAE;QACf,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;QAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,uEAeA;CACF"}

package/dist/capabilities/repository-agent-workflow/adapters/outbound/pnpm/pnpm-package-script-runner.js

@@ -0,0 +1,70 @@
+import { lstat } from "node:fs/promises";
+import { delimiter, isAbsolute, resolve } from "node:path";
+import { FoundationError } from "../../../../../errors.js";
+import { execute } from "../process/process-execution.js";
+async function isRegularFile(path) {
+    const metadata = await lstat(path).catch(() => null);
+    return metadata !== null && metadata.isFile();
+}
+async function nodeEntrypoint(candidates) {
+    for (const candidate of candidates) {
+        if (candidate !== undefined &&
+            isAbsolute(candidate) &&
+            /\.(?:c|m)?js$/u.test(candidate) &&
+            await isRegularFile(candidate)) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+async function resolvePnpmInvocation(environment) {
+    const pnpmPackageEntrypoint = environment.pnpmHome === undefined
+        ? undefined
+        : resolve(environment.pnpmHome, "..", "pnpm", "bin", "pnpm.cjs");
+    const entrypoint = await nodeEntrypoint([
+        environment.npmExecPath,
+        pnpmPackageEntrypoint
+    ]);
+    if (entrypoint !== undefined) {
+        return { command: process.execPath, argsPrefix: [entrypoint] };
+    }
+    if (process.platform !== "win32") {
+        return { command: "pnpm", argsPrefix: [] };
+    }
+    const executableCandidates = [
+        ...(environment.pnpmHome === undefined
+            ? []
+            : [resolve(environment.pnpmHome, "pnpm.exe")]),
+        ...(environment.pathValue === undefined
+            ? []
+            : environment.pathValue
+                .split(delimiter)
+                .filter((path) => path.length > 0)
+                .map((path) => resolve(path, "pnpm.exe")))
+    ];
+    for (const candidate of executableCandidates) {
+        if (await isRegularFile(candidate)) {
+            return { command: candidate, argsPrefix: [] };
+        }
+    }
+    throw new FoundationError("PROCESS_FAILED", "Unable to resolve a shell-free pnpm entrypoint on Windows.");
+}
+export class PnpmPackageScriptRunner {
+    environment;
+    constructor(environment) {
+        this.environment = environment;
+    }
+    async run(input) {
+        const args = [
+            "run",
+            input.script,
+            ...(input.paths.length === 0 ? [] : ["--", ...input.paths])
+        ];
+        const invocation = await resolvePnpmInvocation(this.environment);
+        return execute(invocation.command, [...invocation.argsPrefix, ...args], {
+            cwd: input.consumerRoot,
+            ...(input.signal === undefined ? {} : { signal: input.signal })
+        });
+    }
+}
+//# sourceMappingURL=pnpm-package-script-runner.js.map

package/dist/capabilities/repository-agent-workflow/adapters/outbound/pnpm/pnpm-package-script-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnpm-package-script-runner.js","sourceRoot":"","sources":["../../../../../../src/capabilities/repository-agent-workflow/adapters/outbound/pnpm/pnpm-package-script-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG3D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAa1D,KAAK,UAAU,aAAa,CAAC,IAAY;IACvC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACrD,OAAO,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;AAChD,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,UAA2C;IAE3C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IACE,SAAS,KAAK,SAAS;YACvB,UAAU,CAAC,SAAS,CAAC;YACrB,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC;YAChC,MAAM,aAAa,CAAC,SAAS,CAAC,EAC9B,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,WAAmC;IAEnC,MAAM,qBAAqB,GACzB,WAAW,CAAC,QAAQ,KAAK,SAAS;QAChC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC;QACtC,WAAW,CAAC,WAAW;QACvB,qBAAqB;KACtB,CAAC,CAAC;IACH,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;IACjE,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAC7C,CAAC;IACD,MAAM,oBAAoB,GAAG;QAC3B,GAAG,CAAC,WAAW,CAAC,QAAQ,KAAK,SAAS;YACpC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;QAChD,GAAG,CAAC,WAAW,CAAC,SAAS,KAAK,SAAS;YACrC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,WAAW,CAAC,SAAS;iBAClB,KAAK,CAAC,SAAS,CAAC;iBAChB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;iBACjC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;KACjD,CAAC;IACF,KAAK,MAAM,SAAS,IAAI,oBAAoB,EAAE,CAAC;QAC7C,IAAI,MAAM,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QAChD,CAAC;IACH,CAAC;IACD,MAAM,IAAI,eAAe,CACvB,gBAAgB,EAChB,4DAA4D,CAC7D,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,uBAAuB;IACL,WAAW;IAAxC,YAA6B,WAAmC;2BAAnC,WAAW;IAA2B,CAAC;IAEpE,KAAK,CAAC,GAAG,CAAC,KAKT;QACC,MAAM,IAAI,GAAG;YACX,KAAK;YACL,KAAK,CAAC,MAAM;YACZ,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;SAC5D,CAAC;QACF,MAAM,UAAU,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACjE,OAAO,OAAO,CACZ,UAAU,CAAC,OAAO,EAClB,CAAC,GAAG,UAAU,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,EACnC;YACE,GAAG,EAAE,KAAK,CAAC,YAAY;YACvB,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;SAChE,CACF,CAAC;IACJ,CAAC;CACF"}

package/dist/capabilities/repository-agent-workflow/adapters/outbound/process/process-execution.d.ts

@@ -0,0 +1,10 @@
+export interface ProcessExecution {
+    readonly exitCode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+}
+export declare function execute(command: string, args: readonly string[], options: {
+    readonly cwd: string;
+    readonly signal?: AbortSignal;
+}): Promise<ProcessExecution>;
+//# sourceMappingURL=process-execution.d.ts.map

package/dist/capabilities/repository-agent-workflow/adapters/outbound/process/process-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-execution.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/repository-agent-workflow/adapters/outbound/process/process-execution.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wBAAsB,OAAO,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE;IACP,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,GACA,OAAO,CAAC,gBAAgB,CAAC,CAY3B"}

package/dist/capabilities/repository-agent-workflow/adapters/outbound/process/process-execution.js

@@ -0,0 +1,15 @@
+import { executeManagedProcess } from "../../../../../process-execution/node-process-runner.js";
+export async function execute(command, args, options) {
+    const result = await executeManagedProcess({
+        args,
+        command,
+        cwd: options.cwd,
+        ...(options.signal === undefined ? {} : { signal: options.signal })
+    });
+    return {
+        exitCode: result.exitCode,
+        stderr: result.stderr,
+        stdout: result.stdout
+    };
+}
+//# sourceMappingURL=process-execution.js.map

package/dist/capabilities/repository-agent-workflow/adapters/outbound/process/process-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-execution.js","sourceRoot":"","sources":["../../../../../../src/capabilities/repository-agent-workflow/adapters/outbound/process/process-execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yDAAyD,CAAC;AAQhG,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,OAAe,EACf,IAAuB,EACvB,OAGC;IAED,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC;QACzC,IAAI;QACJ,OAAO;QACP,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;KACpE,CAAC,CAAC;IACH,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC"}

package/dist/capabilities/repository-agent-workflow/application/model/changed-workflow.d.ts

@@ -0,0 +1,36 @@
+import type { RepositoryAgentWorkflowPolicy } from "./repository-agent-workflow.js";
+export interface RepositoryChanges {
+    readonly baselineRef: string;
+    readonly baselineCommit: string | null;
+    readonly changedPaths: readonly string[];
+    readonly deletedPaths: readonly string[];
+    readonly existingPaths: readonly string[];
+}
+export interface ScriptExecutionResult {
+    readonly exitCode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+}
+export interface AgentWorkflowStepReport {
+    readonly id: string;
+    readonly script: string;
+    readonly paths: readonly string[];
+    readonly outcome: "passed" | "violations";
+    readonly output: string;
+}
+export interface AgentWorkflowChangedReport {
+    readonly reportSchemaVersion: 1;
+    readonly outcome: "passed" | "violations";
+    readonly coverage: "changed" | "fast-full";
+    readonly baselineRef: string;
+    readonly baselineCommit: string | null;
+    readonly changedPaths: readonly string[];
+    readonly steps: readonly AgentWorkflowStepReport[];
+}
+export interface AgentWorkflowInvocation {
+    readonly consumerRoot: string;
+    readonly policy: RepositoryAgentWorkflowPolicy;
+    readonly baseRef?: string;
+    readonly signal?: AbortSignal;
+}
+//# sourceMappingURL=changed-workflow.d.ts.map

package/dist/capabilities/repository-agent-workflow/application/model/changed-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changed-workflow.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/repository-agent-workflow/application/model/changed-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAEpF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,YAAY,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,YAAY,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,WAAW,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACpD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,6BAA6B,CAAC;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B"}

package/dist/capabilities/repository-agent-workflow/application/model/changed-workflow.js

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

package/dist/capabilities/repository-agent-workflow/application/model/changed-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changed-workflow.js","sourceRoot":"","sources":["../../../../../src/capabilities/repository-agent-workflow/application/model/changed-workflow.ts"],"names":[],"mappings":""}

package/dist/capabilities/repository-agent-workflow/application/model/repository-agent-workflow.d.ts

@@ -0,0 +1,34 @@
+export interface AgentInstructionPaths {
+    readonly canonical: string;
+    readonly claude: string;
+    readonly gemini: string;
+    readonly copilot: string;
+}
+export interface AgentWorkflowScripts {
+    readonly changed: string;
+    readonly fast: string;
+    readonly full: string;
+}
+export interface ChangedCheckPolicy {
+    readonly id: string;
+    readonly script: string;
+    readonly extensions: readonly string[];
+    readonly passPaths: boolean;
+}
+export interface RepositoryAgentWorkflowPolicy {
+    readonly instructions: AgentInstructionPaths;
+    readonly scripts: AgentWorkflowScripts;
+    readonly changedChecks: readonly ChangedCheckPolicy[];
+    readonly fullScanPaths: readonly string[];
+}
+export type InstructionFileEvidence = {
+    readonly kind: "file";
+    readonly source: string;
+} | {
+    readonly kind: "missing" | "symlink" | "invalid";
+};
+export interface RepositoryAgentWorkflowEvidence {
+    readonly instructionFiles: Readonly<Record<keyof AgentInstructionPaths, InstructionFileEvidence>>;
+    readonly packageScripts: Readonly<Record<string, string>>;
+}
+//# sourceMappingURL=repository-agent-workflow.d.ts.map

package/dist/capabilities/repository-agent-workflow/application/model/repository-agent-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-agent-workflow.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/repository-agent-workflow/application/model/repository-agent-workflow.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,QAAQ,CAAC,aAAa,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACtD,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED,MAAM,MAAM,uBAAuB,GAC/B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;CAAE,CAAC;AAEzD,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,qBAAqB,EAAE,uBAAuB,CAAC,CAAC,CAAC;IAClG,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC3D"}

package/dist/capabilities/repository-agent-workflow/application/model/repository-agent-workflow.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=repository-agent-workflow.js.map

package/dist/capabilities/repository-agent-workflow/application/model/repository-agent-workflow.js.map

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

package/dist/capabilities/repository-agent-workflow/application/policies/evaluate-repository-agent-workflow.d.ts

@@ -0,0 +1,4 @@
+import type { FoundationDiagnostic } from "../../../../check-contract.js";
+import type { RepositoryAgentWorkflowEvidence, RepositoryAgentWorkflowPolicy } from "../model/repository-agent-workflow.js";
+export declare function evaluateRepositoryAgentWorkflow(policy: RepositoryAgentWorkflowPolicy, evidence: RepositoryAgentWorkflowEvidence): readonly FoundationDiagnostic[];
+//# sourceMappingURL=evaluate-repository-agent-workflow.d.ts.map

package/dist/capabilities/repository-agent-workflow/application/policies/evaluate-repository-agent-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate-repository-agent-workflow.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/repository-agent-workflow/application/policies/evaluate-repository-agent-workflow.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,KAAK,EAEV,+BAA+B,EAC/B,6BAA6B,EAC9B,MAAM,uCAAuC,CAAC;AAuK/C,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,6BAA6B,EACrC,QAAQ,EAAE,+BAA+B,GACxC,SAAS,oBAAoB,EAAE,CAWjC"}

package/dist/capabilities/repository-agent-workflow/application/policies/evaluate-repository-agent-workflow.js

@@ -0,0 +1,132 @@
+import { compareBinaryStrings } from "../../../../binary-string-comparator.js";
+function diagnostic(input) {
+    return Object.freeze({
+        ruleId: input.ruleId,
+        severity: "error",
+        subject: input.subject,
+        message: input.message,
+        location: { path: input.path },
+        relatedLocations: [],
+        evidence: input.evidence ?? [],
+        remediation: input.remediation,
+        requiresArchitectureReview: false
+    });
+}
+function fileSource(evidence) {
+    return evidence.kind === "file" ? evidence.source : null;
+}
+function isExactAdapter(source, candidates) {
+    return candidates.includes(source.trim());
+}
+function importCandidates(adapterPath, canonicalPath) {
+    const adapterDirectory = adapterPath.split("/").slice(0, -1);
+    const canonicalSegments = canonicalPath.split("/");
+    let commonSegments = 0;
+    while (adapterDirectory[commonSegments] !== undefined &&
+        adapterDirectory[commonSegments] === canonicalSegments[commonSegments]) {
+        commonSegments += 1;
+    }
+    const relative = [
+        ...adapterDirectory.slice(commonSegments).map(() => ".."),
+        ...canonicalSegments.slice(commonSegments)
+    ].join("/");
+    const normalized = relative.startsWith(".") ? relative : `./${relative}`;
+    return Object.freeze([`@${relative}`, `@${normalized}`]);
+}
+function validateInstructionFiles(policy, evidence) {
+    const diagnostics = [];
+    for (const kind of ["canonical", "claude", "gemini", "copilot"]) {
+        const repositoryPath = policy.instructions[kind];
+        const file = evidence.instructionFiles[kind];
+        if (file.kind !== "file") {
+            diagnostics.push(diagnostic({
+                ruleId: "repository.agent-workflow.instruction-file-invalid",
+                subject: `${kind}:${repositoryPath}`,
+                message: `Instruction file is ${file.kind}: ${repositoryPath}.`,
+                path: repositoryPath,
+                remediation: "Create a regular instruction file within the repository."
+            }));
+        }
+    }
+    return diagnostics;
+}
+function validateAdapters(policy, evidence) {
+    const diagnostics = [];
+    for (const kind of ["claude", "gemini"]) {
+        const source = fileSource(evidence.instructionFiles[kind]);
+        const candidates = importCandidates(policy.instructions[kind], policy.instructions.canonical);
+        if (source !== null && !isExactAdapter(source, candidates)) {
+            diagnostics.push(diagnostic({
+                ruleId: "repository.agent-workflow.adapter-not-linked",
+                subject: `${kind}:${policy.instructions[kind]}`,
+                message: `${kind} instructions do not import ${policy.instructions.canonical}.`,
+                path: policy.instructions[kind],
+                remediation: `Replace the adapter content with ${candidates[0]}.`,
+                evidence: candidates.map((value) => ({ kind: "accepted-import", value }))
+            }));
+        }
+    }
+    const copilotSource = fileSource(evidence.instructionFiles.copilot);
+    if (copilotSource !== null && !copilotSource.includes(policy.instructions.canonical)) {
+        diagnostics.push(diagnostic({
+            ruleId: "repository.agent-workflow.adapter-not-linked",
+            subject: `copilot:${policy.instructions.copilot}`,
+            message: `Copilot instructions do not reference ${policy.instructions.canonical}.`,
+            path: policy.instructions.copilot,
+            remediation: `Require Copilot to read and follow ${policy.instructions.canonical}.`
+        }));
+    }
+    return diagnostics;
+}
+function validateCommands(policy, evidence) {
+    const diagnostics = [];
+    const canonicalSource = fileSource(evidence.instructionFiles.canonical);
+    const requiredScripts = new Set([
+        policy.scripts.changed,
+        policy.scripts.fast,
+        policy.scripts.full,
+        ...policy.changedChecks.map(({ script }) => script)
+    ]);
+    for (const script of [...requiredScripts].toSorted()) {
+        if (!(script in evidence.packageScripts)) {
+            diagnostics.push(diagnostic({
+                ruleId: "repository.agent-workflow.package-script-missing",
+                subject: `package-script:${script}`,
+                message: `Required package script is missing: ${script}.`,
+                path: "package.json",
+                remediation: `Define the ${script} package script.`
+            }));
+        }
+    }
+    for (const script of [policy.scripts.changed, policy.scripts.fast, policy.scripts.full]) {
+        if (canonicalSource !== null && !canonicalSource.includes(script)) {
+            diagnostics.push(diagnostic({
+                ruleId: "repository.agent-workflow.command-not-documented",
+                subject: `instruction-command:${script}`,
+                message: `Canonical instructions do not mention ${script}.`,
+                path: policy.instructions.canonical,
+                remediation: `Document when agents must run pnpm ${script}.`
+            }));
+        }
+    }
+    const changedCommand = evidence.packageScripts[policy.scripts.changed];
+    if (changedCommand !== undefined &&
+        !/^(?:pnpm\s+build\s*&&\s*)?agent-teams-foundation\s+agent-workflow\s+changed\s+--consumer\s+\.$/u.test(changedCommand.trim())) {
+        diagnostics.push(diagnostic({
+            ruleId: "repository.agent-workflow.changed-runner-invalid",
+            subject: `package-script:${policy.scripts.changed}`,
+            message: "The changed-file script bypasses the shared Foundation runner.",
+            path: "package.json",
+            remediation: "Set the script exactly to: agent-teams-foundation agent-workflow changed --consumer ."
+        }));
+    }
+    return diagnostics;
+}
+export function evaluateRepositoryAgentWorkflow(policy, evidence) {
+    return Object.freeze([
+        ...validateInstructionFiles(policy, evidence),
+        ...validateAdapters(policy, evidence),
+        ...validateCommands(policy, evidence)
+    ].toSorted((left, right) => compareBinaryStrings(`${left.ruleId}:${left.subject}`, `${right.ruleId}:${right.subject}`)));
+}
+//# sourceMappingURL=evaluate-repository-agent-workflow.js.map

package/dist/capabilities/repository-agent-workflow/application/policies/evaluate-repository-agent-workflow.js.map

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

package/dist/capabilities/repository-agent-workflow/application/ports/changed-workflow.d.ts

@@ -0,0 +1,17 @@
+import type { RepositoryChanges, ScriptExecutionResult } from "../model/changed-workflow.js";
+export interface RepositoryChangesReader {
+    collect(input: {
+        readonly consumerRoot: string;
+        readonly baseRef?: string;
+        readonly signal?: AbortSignal;
+    }): Promise<RepositoryChanges>;
+}
+export interface PackageScriptRunner {
+    run(input: {
+        readonly consumerRoot: string;
+        readonly script: string;
+        readonly paths: readonly string[];
+        readonly signal?: AbortSignal;
+    }): Promise<ScriptExecutionResult>;
+}
+//# sourceMappingURL=changed-workflow.d.ts.map

package/dist/capabilities/repository-agent-workflow/application/ports/changed-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changed-workflow.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/repository-agent-workflow/application/ports/changed-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,8BAA8B,CAAC;AAEtC,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,KAAK,EAAE;QACb,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,KAAK,EAAE;QACT,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;QAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACpC"}

package/dist/capabilities/repository-agent-workflow/application/ports/changed-workflow.js

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

package/dist/capabilities/repository-agent-workflow/application/ports/changed-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changed-workflow.js","sourceRoot":"","sources":["../../../../../src/capabilities/repository-agent-workflow/application/ports/changed-workflow.ts"],"names":[],"mappings":""}

package/dist/capabilities/repository-agent-workflow/application/ports/repository-agent-workflow-reader.d.ts

@@ -0,0 +1,5 @@
+import type { RepositoryAgentWorkflowEvidence, RepositoryAgentWorkflowPolicy } from "../model/repository-agent-workflow.js";
+export interface RepositoryAgentWorkflowReader {
+    read(consumerRoot: string, policy: RepositoryAgentWorkflowPolicy, signal?: AbortSignal): Promise<RepositoryAgentWorkflowEvidence>;
+}
+//# sourceMappingURL=repository-agent-workflow-reader.d.ts.map

package/dist/capabilities/repository-agent-workflow/application/ports/repository-agent-workflow-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-agent-workflow-reader.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/repository-agent-workflow/application/ports/repository-agent-workflow-reader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,+BAA+B,EAC/B,6BAA6B,EAC9B,MAAM,uCAAuC,CAAC;AAE/C,MAAM,WAAW,6BAA6B;IAC5C,IAAI,CACF,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,6BAA6B,EACrC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,+BAA+B,CAAC,CAAC;CAC7C"}

package/dist/capabilities/repository-agent-workflow/application/ports/repository-agent-workflow-reader.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=repository-agent-workflow-reader.js.map

package/dist/capabilities/repository-agent-workflow/application/ports/repository-agent-workflow-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-agent-workflow-reader.js","sourceRoot":"","sources":["../../../../../src/capabilities/repository-agent-workflow/application/ports/repository-agent-workflow-reader.ts"],"names":[],"mappings":""}

package/dist/capabilities/repository-agent-workflow/application/rules.d.ts

@@ -0,0 +1,8 @@
+export interface RepositoryAgentWorkflowRuleMetadata {
+    readonly id: string;
+    readonly rationale: string;
+    readonly remediation: string;
+    readonly documentation: string;
+}
+export declare const REPOSITORY_AGENT_WORKFLOW_RULES_BY_ID: ReadonlyMap<string, RepositoryAgentWorkflowRuleMetadata>;
+//# sourceMappingURL=rules.d.ts.map

package/dist/capabilities/repository-agent-workflow/application/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/repository-agent-workflow/application/rules.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAsCD,eAAO,MAAM,qCAAqC,EAAE,WAAW,CAC7D,MAAM,EACN,mCAAmC,CACY,CAAC"}