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

package/dist/capabilities/quality-gate-runner/application/use-cases/run-quality-gate-profile.js

@@ -0,0 +1,138 @@
+import { PackageScriptTimeoutError } from "../ports/package-script-executor.js";
+const FAILURE_TAIL_CHARACTERS = 8_192;
+function unsafeTerminalControl(codePoint) {
+    return codePoint <= 0x08 ||
+        (codePoint >= 0x0b && codePoint <= 0x1f) ||
+        (codePoint >= 0x7f && codePoint <= 0x9f);
+}
+function sanitizeFailureOutput(value) {
+    let sanitized = "";
+    for (const character of value) {
+        const codePoint = character.codePointAt(0) ?? 0;
+        sanitized += unsafeTerminalControl(codePoint)
+            ? `\\u{${codePoint.toString(16).padStart(4, "0")}}`
+            : character;
+    }
+    return sanitized;
+}
+function elapsed(clock, startedAt) {
+    return Math.max(0, Math.floor(clock.nowMs() - startedAt));
+}
+function failureTail(stdout, stderr) {
+    const combined = sanitizeFailureOutput([stdout.trim(), stderr.trim()]
+        .filter((value) => value.length > 0)
+        .join("\n"));
+    const tail = combined.length <= FAILURE_TAIL_CHARACTERS
+        ? combined
+        : combined.slice(combined.length - FAILURE_TAIL_CHARACTERS);
+    return /^[\udc00-\udfff]/u.test(tail) ? tail.slice(1) : tail;
+}
+async function executeTask(input, executor, clock) {
+    const startedAt = clock.nowMs();
+    try {
+        const result = await executor.run({
+            consumerRoot: input.consumerRoot,
+            scriptId: input.task.id,
+            ...(input.task.timeoutMs === undefined
+                ? {}
+                : { timeoutMs: input.task.timeoutMs }),
+            ...(input.signal === undefined ? {} : { signal: input.signal })
+        });
+        return Object.freeze({
+            id: input.task.id,
+            outcome: result.exitCode === 0 ? "passed" : "failed",
+            durationMs: elapsed(clock, startedAt),
+            exitCode: result.exitCode,
+            signal: result.signal,
+            failureTail: result.exitCode === 0 ? "" : failureTail(result.stdout, result.stderr)
+        });
+    }
+    catch (error) {
+        const cancelled = input.signal?.aborted === true;
+        const timedOut = error instanceof PackageScriptTimeoutError;
+        return Object.freeze({
+            id: input.task.id,
+            outcome: cancelled ? "cancelled" : timedOut ? "timed-out" : "failed",
+            durationMs: elapsed(clock, startedAt),
+            exitCode: null,
+            signal: null,
+            failureTail: cancelled
+                ? ""
+                : error instanceof Error
+                    ? failureTail("", error.message)
+                    : "Package script execution failed."
+        });
+    }
+}
+function terminalReport(id, outcome) {
+    return Object.freeze({
+        id,
+        outcome,
+        durationMs: 0,
+        exitCode: null,
+        signal: null,
+        failureTail: ""
+    });
+}
+export async function runQualityGateProfile(input, executor, clock) {
+    const startedAt = clock.nowMs();
+    const reports = new Map();
+    const active = new Map();
+    while (reports.size < input.profile.tasks.length) {
+        const madeProgress = scheduleReadyTasks(input, reports, active, executor, clock);
+        if (active.size > 0) {
+            const completed = await Promise.race(active.values());
+            active.delete(completed.id);
+            reports.set(completed.id, completed);
+            continue;
+        }
+        if (!madeProgress && reports.size < input.profile.tasks.length) {
+            throw new Error("Quality gate scheduler reached an invalid dependency state.");
+        }
+    }
+    const tasks = Object.freeze(input.profile.tasks.map((task) => reports.get(task.id)));
+    return Object.freeze({
+        reportSchemaVersion: 1,
+        profileId: input.profile.id,
+        outcome: tasks.some(({ outcome }) => outcome === "cancelled")
+            ? "cancelled"
+            : tasks.every(({ outcome }) => outcome === "passed")
+                ? "passed"
+                : "failed",
+        durationMs: elapsed(clock, startedAt),
+        tasks
+    });
+}
+function scheduleReadyTasks(input, reports, active, executor, clock) {
+    let madeProgress = false;
+    for (const task of input.profile.tasks) {
+        if (reports.has(task.id) || active.has(task.id)) {
+            continue;
+        }
+        if (input.signal?.aborted === true) {
+            reports.set(task.id, terminalReport(task.id, "cancelled"));
+            madeProgress = true;
+            continue;
+        }
+        const dependencies = [...task.needs, ...task.after].map((id) => reports.get(id));
+        if (dependencies.some((report) => report === undefined)) {
+            continue;
+        }
+        if (task.needs.some((id) => reports.get(id)?.outcome !== "passed")) {
+            reports.set(task.id, terminalReport(task.id, "blocked"));
+            madeProgress = true;
+            continue;
+        }
+        if (active.size >= input.profile.concurrency) {
+            break;
+        }
+        active.set(task.id, executeTask({
+            consumerRoot: input.consumerRoot,
+            task,
+            ...(input.signal === undefined ? {} : { signal: input.signal })
+        }, executor, clock));
+        madeProgress = true;
+    }
+    return madeProgress;
+}
+//# sourceMappingURL=run-quality-gate-profile.js.map

package/dist/capabilities/quality-gate-runner/application/use-cases/run-quality-gate-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-quality-gate-profile.js","sourceRoot":"","sources":["../../../../../src/capabilities/quality-gate-runner/application/use-cases/run-quality-gate-profile.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/quality-gate-runner/contract/config.d.ts

@@ -0,0 +1,5 @@
+import type { QualityGatePolicy } from "../application/model/quality-gate.js";
+export declare const CAPABILITY_ID: "quality.gate-runner";
+export declare const CAPABILITY_CONFIG_SCHEMA_VERSION: 1;
+export declare function loadQualityGatePolicy(consumerRoot: string, configPath: string, signal?: AbortSignal): Promise<QualityGatePolicy>;
+//# sourceMappingURL=config.d.ts.map

package/dist/capabilities/quality-gate-runner/contract/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/quality-gate-runner/contract/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,sCAAsC,CAAC;AAM9C,eAAO,MAAM,aAAa,EAAG,qBAA8B,CAAC;AAC5D,eAAO,MAAM,gCAAgC,EAAG,CAAU,CAAC;AAsE3D,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,iBAAiB,CAAC,CA0B5B"}

package/dist/capabilities/quality-gate-runner/contract/config.js

@@ -0,0 +1,89 @@
+import { CapabilityInputError } from "../../../capability-runtime.js";
+import { assertSchema } from "../../../schema-catalog.js";
+import { loadStrictYamlFile } from "../../../strict-yaml.js";
+import { QualityGateGraphError, validateQualityGatePolicy } from "../application/policies/validate-quality-gate-graph.js";
+export const CAPABILITY_ID = "quality.gate-runner";
+export const CAPABILITY_CONFIG_SCHEMA_VERSION = 1;
+function inputError(message) {
+    throw new CapabilityInputError({
+        code: "QUALITY_GATE_RUNNER_CONFIG_INVALID",
+        message,
+        phase: "quality-gate-runner-config",
+        retryable: false
+    });
+}
+function record(value, field) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        inputError(`${field} must be an object.`);
+    }
+    return value;
+}
+function string(value, field) {
+    if (typeof value !== "string") {
+        inputError(`${field} must be a string.`);
+    }
+    return value;
+}
+function integer(value, field) {
+    if (!Number.isSafeInteger(value)) {
+        inputError(`${field} must be an integer.`);
+    }
+    return value;
+}
+function ids(value, field) {
+    if (value === undefined) {
+        return Object.freeze([]);
+    }
+    if (!Array.isArray(value)) {
+        inputError(`${field} must be an array.`);
+    }
+    return Object.freeze(value.map((entry, index) => string(entry, `${field}[${index}]`)));
+}
+function task(value, profileIndex, taskIndex) {
+    const field = `profiles[${profileIndex}].tasks[${taskIndex}]`;
+    const input = record(value, field);
+    const timeoutMs = input["timeoutMs"];
+    return Object.freeze({
+        id: string(input["id"], `${field}.id`),
+        needs: ids(input["needs"], `${field}.needs`),
+        after: ids(input["after"], `${field}.after`),
+        ...(timeoutMs === undefined ? {} : { timeoutMs: integer(timeoutMs, `${field}.timeoutMs`) })
+    });
+}
+function profile(value, index) {
+    const field = `profiles[${index}]`;
+    const input = record(value, field);
+    const tasks = input["tasks"];
+    if (!Array.isArray(tasks)) {
+        inputError(`${field}.tasks must be an array.`);
+    }
+    return Object.freeze({
+        id: string(input["id"], `${field}.id`),
+        concurrency: integer(input["concurrency"], `${field}.concurrency`),
+        tasks: Object.freeze(tasks.map((entry, taskIndex) => task(entry, index, taskIndex)))
+    });
+}
+export async function loadQualityGatePolicy(consumerRoot, configPath, signal) {
+    const input = await loadStrictYamlFile(consumerRoot, configPath, "quality-gate-runner-config", signal);
+    await assertSchema("quality-gate-runner/v1", input, "quality-gate-runner-config");
+    const root = record(input, "quality gate runner config");
+    const profiles = root["profiles"];
+    if (!Array.isArray(profiles)) {
+        inputError("profiles must be an array.");
+    }
+    const policy = Object.freeze({
+        packageManager: "pnpm",
+        profiles: Object.freeze(profiles.map(profile))
+    });
+    try {
+        validateQualityGatePolicy(policy);
+    }
+    catch (error) {
+        if (error instanceof QualityGateGraphError) {
+            inputError(error.message);
+        }
+        throw error;
+    }
+    return policy;
+}
+//# sourceMappingURL=config.js.map

package/dist/capabilities/quality-gate-runner/contract/config.js.map

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

package/dist/capabilities/quality-gate-runner/gate-command.d.ts

@@ -0,0 +1,10 @@
+import { type QualityGatePnpmEnvironment } from "./adapters/outbound/pnpm/pnpm-package-script-executor.js";
+export declare function runQualityGateCommand(input: {
+    readonly consumerRoot: string;
+    readonly configPath: string;
+    readonly profileId: string;
+    readonly format: "json" | "text";
+    readonly environment: NodeJS.ProcessEnv;
+    readonly pnpmEnvironment: QualityGatePnpmEnvironment;
+}): Promise<void>;
+//# sourceMappingURL=gate-command.d.ts.map

package/dist/capabilities/quality-gate-runner/gate-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-command.d.ts","sourceRoot":"","sources":["../../../src/capabilities/quality-gate-runner/gate-command.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,0DAA0D,CAAC;AAqClE,wBAAsB,qBAAqB,CAAC,KAAK,EAAE;IACjD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,UAAU,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,0BAA0B,CAAC;CACtD,GAAG,OAAO,CAAC,IAAI,CAAC,CAkEhB"}

package/dist/capabilities/quality-gate-runner/gate-command.js

@@ -0,0 +1,82 @@
+import { CapabilityInputError } from "../../capability-runtime.js";
+import { evaluateQualityGateScripts } from "./application/policies/evaluate-quality-gate-scripts.js";
+import { runQualityGateProfile } from "./application/use-cases/run-quality-gate-profile.js";
+import { renderQualityGateRunReport } from "./adapters/inbound/cli/report-renderer.js";
+import { FilesystemPackageScriptCatalogReader } from "./adapters/outbound/filesystem/filesystem-package-script-catalog-reader.js";
+import { PnpmQualityGateScriptExecutor } from "./adapters/outbound/pnpm/pnpm-package-script-executor.js";
+import { performanceMonotonicClock } from "./adapters/outbound/time/performance-monotonic-clock.js";
+import { loadQualityGatePolicy } from "./contract/config.js";
+const ACTIVE_GATE_ENVIRONMENT_VARIABLE = "AGENT_TEAMS_FOUNDATION_QUALITY_GATE_ACTIVE";
+function inputError(code, message) {
+    throw new CapabilityInputError({
+        code,
+        message,
+        phase: "quality-gate-runner-command",
+        retryable: false
+    });
+}
+function exitCodeForQualityGateRun(report, cancellationSignal) {
+    if (report.outcome === "passed") {
+        return 0;
+    }
+    if (report.outcome === "cancelled") {
+        return cancellationSignal === "SIGTERM" ? 143 : 130;
+    }
+    for (const task of report.tasks) {
+        if (task.outcome === "timed-out") {
+            return 124;
+        }
+        if (task.outcome === "failed") {
+            return task.exitCode === null || task.exitCode === 0 ? 1 : task.exitCode;
+        }
+    }
+    return 1;
+}
+export async function runQualityGateCommand(input) {
+    if (input.environment[ACTIVE_GATE_ENVIRONMENT_VARIABLE] !== undefined) {
+        inputError("QUALITY_GATE_RECURSION", "A quality gate task cannot start another quality gate runner.");
+    }
+    const controller = new AbortController();
+    let cancellationSignal;
+    const cancelFor = (signal) => () => {
+        cancellationSignal ??= signal;
+        controller.abort(signal);
+    };
+    const onInterrupt = cancelFor("SIGINT");
+    const onTerminate = cancelFor("SIGTERM");
+    process.on("SIGINT", onInterrupt);
+    process.on("SIGTERM", onTerminate);
+    try {
+        const policy = await loadQualityGatePolicy(input.consumerRoot, input.configPath, controller.signal);
+        const profile = policy.profiles.find(({ id }) => id === input.profileId);
+        if (profile === undefined) {
+            inputError("QUALITY_GATE_PROFILE_UNKNOWN", `Unknown quality gate profile: ${input.profileId}.`);
+        }
+        const catalog = await new FilesystemPackageScriptCatalogReader().read(input.consumerRoot, controller.signal);
+        const diagnostics = evaluateQualityGateScripts(policy, catalog);
+        if (diagnostics.length > 0) {
+            inputError("QUALITY_GATE_SCRIPTS_INVALID", diagnostics.map(({ message }) => message).join(" "));
+        }
+        input.environment[ACTIVE_GATE_ENVIRONMENT_VARIABLE] = input.profileId;
+        let report;
+        try {
+            report = await runQualityGateProfile({
+                consumerRoot: input.consumerRoot,
+                profile,
+                signal: controller.signal
+            }, new PnpmQualityGateScriptExecutor(input.pnpmEnvironment), performanceMonotonicClock);
+        }
+        finally {
+            delete input.environment[ACTIVE_GATE_ENVIRONMENT_VARIABLE];
+        }
+        process.stdout.write(input.format === "json"
+            ? `${JSON.stringify(report, null, 2)}\n`
+            : renderQualityGateRunReport(report));
+        process.exitCode = exitCodeForQualityGateRun(report, cancellationSignal);
+    }
+    finally {
+        process.removeListener("SIGINT", onInterrupt);
+        process.removeListener("SIGTERM", onTerminate);
+    }
+}
+//# sourceMappingURL=gate-command.js.map

package/dist/capabilities/quality-gate-runner/gate-command.js.map

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

package/dist/capabilities/quality-gate-runner/module.d.ts

@@ -0,0 +1,5 @@
+import { type CapabilityDefinition } from "../../capability-runtime.js";
+import { QUALITY_GATE_RUNNER_RULES_BY_ID } from "./application/rules.js";
+export { QUALITY_GATE_RUNNER_RULES_BY_ID };
+export declare function createQualityGateRunnerCapability(): CapabilityDefinition;
+//# sourceMappingURL=module.d.ts.map

package/dist/capabilities/quality-gate-runner/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/capabilities/quality-gate-runner/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,oBAAoB,EAE1B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAQzE,OAAO,EAAE,+BAA+B,EAAE,CAAC;AAE3C,wBAAgB,iCAAiC,IAAI,oBAAoB,CAkCxE"}

package/dist/capabilities/quality-gate-runner/module.js

@@ -0,0 +1,36 @@
+import { capabilityFailureReport, capabilityReport } from "../../capability-runtime.js";
+import { FilesystemPackageScriptCatalogReader } from "./adapters/outbound/filesystem/filesystem-package-script-catalog-reader.js";
+import { QUALITY_GATE_RUNNER_RULES_BY_ID } from "./application/rules.js";
+import { analyzeQualityGateRunner } from "./application/use-cases/analyze-quality-gate-runner.js";
+import { CAPABILITY_CONFIG_SCHEMA_VERSION, CAPABILITY_ID, loadQualityGatePolicy } from "./contract/config.js";
+export { QUALITY_GATE_RUNNER_RULES_BY_ID };
+export function createQualityGateRunnerCapability() {
+    const reader = new FilesystemPackageScriptCatalogReader();
+    return Object.freeze({
+        id: CAPABILITY_ID,
+        configSchemaVersion: CAPABILITY_CONFIG_SCHEMA_VERSION,
+        async run(invocation) {
+            try {
+                const policy = await loadQualityGatePolicy(invocation.consumerRoot, invocation.configPath, invocation.signal);
+                return capabilityReport({
+                    capabilityId: CAPABILITY_ID,
+                    capabilityConfigSchemaVersion: CAPABILITY_CONFIG_SCHEMA_VERSION,
+                    diagnostics: await analyzeQualityGateRunner({
+                        consumerRoot: invocation.consumerRoot,
+                        policy,
+                        ...(invocation.signal === undefined ? {} : { signal: invocation.signal })
+                    }, reader)
+                });
+            }
+            catch (error) {
+                return capabilityFailureReport({
+                    capabilityId: CAPABILITY_ID,
+                    capabilityConfigSchemaVersion: CAPABILITY_CONFIG_SCHEMA_VERSION,
+                    error,
+                    phase: "quality-gate-runner-execution"
+                });
+            }
+        }
+    });
+}
+//# sourceMappingURL=module.js.map

package/dist/capabilities/quality-gate-runner/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../src/capabilities/quality-gate-runner/module.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAGjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,oCAAoC,EAAE,MAAM,4EAA4E,CAAC;AAClI,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wDAAwD,CAAC;AAClG,OAAO,EACL,gCAAgC,EAChC,aAAa,EACb,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,+BAA+B,EAAE,CAAC;AAE3C,MAAM,UAAU,iCAAiC;IAC/C,MAAM,MAAM,GAAG,IAAI,oCAAoC,EAAE,CAAC;IAC1D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,aAAa;QACjB,mBAAmB,EAAE,gCAAgC;QACrD,KAAK,CAAC,GAAG,CAAC,UAAgC;YACxC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,qBAAqB,CACxC,UAAU,CAAC,YAAY,EACvB,UAAU,CAAC,UAAU,EACrB,UAAU,CAAC,MAAM,CAClB,CAAC;gBACF,OAAO,gBAAgB,CAAC;oBACtB,YAAY,EAAE,aAAa;oBAC3B,6BAA6B,EAAE,gCAAgC;oBAC/D,WAAW,EAAE,MAAM,wBAAwB,CACzC;wBACE,YAAY,EAAE,UAAU,CAAC,YAAY;wBACrC,MAAM;wBACN,GAAG,CAAC,UAAU,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;qBAC1E,EACD,MAAM,CACP;iBACF,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,uBAAuB,CAAC;oBAC7B,YAAY,EAAE,aAAa;oBAC3B,6BAA6B,EAAE,gCAAgC;oBAC/D,KAAK;oBACL,KAAK,EAAE,+BAA+B;iBACvC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

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

@@ -1,3 +1,5 @@
 import type { AgentWorkflowChangedReport } from "../../../application/model/changed-workflow.js";
+import type { EffectiveInstructionsReport } from "../../../application/model/effective-instructions.js";
 export declare function renderAgentWorkflowReport(report: AgentWorkflowChangedReport): string;
+export declare function renderEffectiveInstructionsReport(report: EffectiveInstructionsReport): string;
 //# sourceMappingURL=report-renderer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"report-renderer.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/repository-agent-workflow/adapters/inbound/cli/report-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,gDAAgD,CAAC;AAEjG,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,0BAA0B,GAAG,MAAM,CAwBpF"}
+{"version":3,"file":"report-renderer.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/repository-agent-workflow/adapters/inbound/cli/report-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,gDAAgD,CAAC;AACjG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sDAAsD,CAAC;AAExG,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,0BAA0B,GAAG,MAAM,CA6BpF;AAED,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,2BAA2B,GAClC,MAAM,CAiCR"}

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":"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"}

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"}