assertloom 0.0.0-stage → 0.2.0

package/dist/ci/run.js

@@ -0,0 +1,198 @@
+import { access, copyFile, mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { estimateCost } from "../ai/pricing.js";
+import { analyzeSource } from "../analyzer/index.js";
+import { validateSourceFile } from "../cli/validateFile.js";
+import { BudgetExceededError, generateTests, previewPathFor, writeTestFile } from "../generator/index.js";
+import { repairTests, summarize } from "../repair/index.js";
+import { runJest } from "../runner/index.js";
+const zeroUsage = () => ({ inputTokens: 0, outputTokens: 0 });
+function emptyReport(candidate) {
+    return {
+        path: candidate.path,
+        ...(candidate.from ? { from: candidate.from } : {}),
+        change: candidate.status,
+        status: "processed",
+        generated: 0,
+        accepted: 0,
+        rejected: 0,
+        repaired: 0,
+        flaggedAsSourceBugs: 0,
+        removed: 0,
+        gaveUp: 0,
+        repairRounds: 0,
+        regressions: 0,
+        durationMs: 0,
+        usage: zeroUsage(),
+        costUsd: null,
+    };
+}
+const key = (suite, name) => `${suite}\u0000${name}`;
+/** Tests that failed in the first run and pass in the final run. */
+export function countRepaired(initial, final) {
+    const failedAtFirst = new Set(initial.tests.filter((t) => t.status === "failed").map((t) => key(t.suite, t.name)));
+    return final.tests.filter((t) => t.status === "passed" && failedAtFirst.has(key(t.suite, t.name))).length;
+}
+function firstLine(text) {
+    return text.split("\n").find((l) => l.trim())?.trim().slice(0, 300) ?? "";
+}
+async function exists(file) {
+    return access(file).then(() => true, () => false);
+}
+/**
+ * Generates, runs, and repairs tests for each eligible file in turn, with one shared budget.
+ * Never writes outside generated preview files, which are removed from the tree once copied to `testsDir`.
+ */
+export async function runFiles(options) {
+    const log = options.log ?? (() => { });
+    const files = [];
+    let budgetExhausted = false;
+    let started = 0;
+    for (const candidate of options.candidates) {
+        const report = emptyReport(candidate);
+        files.push(report);
+        if (candidate.skip) {
+            Object.assign(report, { status: "skipped", skipReason: candidate.skip.reason, detail: candidate.skip.detail });
+            continue;
+        }
+        if (budgetExhausted) {
+            Object.assign(report, { status: "skipped", skipReason: "budget", detail: "the shared spending limit was reached" });
+            continue;
+        }
+        if (started >= options.maxFiles) {
+            Object.assign(report, { status: "skipped", skipReason: "file-limit", detail: `max-files (${options.maxFiles}) reached` });
+            continue;
+        }
+        started++;
+        log(`${candidate.path} ...`);
+        const outcome = await processFile(candidate, report, options);
+        if (outcome === "budget")
+            budgetExhausted = true;
+        log(`  ${describe(report)}`);
+        await options.onProgress?.(files);
+    }
+    await options.onProgress?.(files);
+    return { files, budgetExhausted };
+}
+function describe(report) {
+    if (report.status === "skipped")
+        return `skipped: ${report.detail}`;
+    if (report.status === "failed")
+        return `failed: ${report.detail}`;
+    const f = report.final;
+    return `${f.passed} passed, ${f.failed} failed, ${f.skipped} skipped`;
+}
+async function processFile(candidate, report, options) {
+    const { budget, provider } = options;
+    const startedAt = Date.now();
+    const usageBefore = { ...budget.usage };
+    const absolute = path.resolve(options.root, candidate.path);
+    const previewPath = previewPathFor(absolute);
+    let wrotePreview = false;
+    let result = "ok";
+    const runTests = options.runTests ?? ((testPath, sourcePath) => runJest({ testPath, sourcePath, timeoutMs: options.timeoutMs }));
+    try {
+        const source = await validateSourceFile(candidate.path, options.root);
+        const analysis = analyzeSource(await readFile(absolute, "utf8"), source);
+        if (!analysis.functions.some((f) => f.exported)) {
+            Object.assign(report, { status: "skipped", skipReason: "no-exported-functions", detail: "no exported functions to test" });
+            return result;
+        }
+        // Never overwrite a file that is already there, generated or not.
+        if (await exists(previewPath)) {
+            Object.assign(report, { status: "skipped", skipReason: "preview-exists", detail: `${path.basename(previewPath)} already exists` });
+            return result;
+        }
+        let generation;
+        try {
+            generation = await generateTests({ source, provider, budget });
+        }
+        catch (error) {
+            if (error instanceof BudgetExceededError) {
+                Object.assign(report, { status: "skipped", skipReason: "budget", detail: "the shared spending limit was reached" });
+                return (result = "budget");
+            }
+            throw error;
+        }
+        report.accepted = generation.suites.reduce((n, s) => n + s.cases.length, 0);
+        report.rejected = generation.rejected.length;
+        report.generated = report.accepted + report.rejected;
+        await writeTestFile(previewPath, generation.content);
+        wrotePreview = true;
+        const firstRun = await runTests(previewPath, absolute);
+        report.initial = summarize(firstRun);
+        let finalRun = firstRun;
+        let content = generation.content;
+        let repair;
+        if (firstRun.status === "failed" && options.maxAttempts > 0) {
+            repair = await repairTests({
+                provider,
+                analysis: generation.analysis,
+                promptSource: generation.promptSource,
+                sourcePath: absolute,
+                testPath: previewPath,
+                extension: source.extension,
+                preamble: generation.preamble,
+                mockSummary: generation.mocks.summary,
+                suites: generation.suites,
+                initialRun: firstRun,
+                maxAttempts: options.maxAttempts,
+                budget,
+                runTests: (testPath) => runTests(testPath, absolute),
+            });
+            finalRun = repair.run;
+            content = repair.content;
+            const kept = repair.attempts.filter((a) => !a.regressed);
+            report.repairRounds = repair.attempts.length;
+            report.regressions = repair.attempts.length - kept.length;
+            report.flaggedAsSourceBugs = kept.flatMap((a) => a.changes).filter((c) => c.action === "skip").length;
+            report.removed = kept.flatMap((a) => a.changes).filter((c) => c.action === "remove").length;
+            report.gaveUp = repair.gaveUp.length;
+            report.stopReason = repair.stopReason;
+            if (repair.stopReason === "budget")
+                result = "budget";
+        }
+        else {
+            report.stopReason = firstRun.status === "passed" ? "all-passing" : firstRun.status === "failed" ? "not-repaired" : "unrepairable";
+        }
+        report.final = summarize(finalRun);
+        report.repaired = countRepaired(firstRun, finalRun);
+        if (finalRun.infra) {
+            report.infra = { kind: finalRun.infra.kind, message: firstLine(finalRun.infra.message) };
+            Object.assign(report, { status: "failed", detail: `tests could not run (${finalRun.infra.kind})` });
+        }
+        const artifact = path.join(options.testsDir, path.dirname(candidate.path), path.basename(previewPath));
+        await mkdir(path.dirname(artifact), { recursive: true });
+        await writeFile(artifact, content);
+        report.artifact = path.relative(path.dirname(options.testsDir), artifact).split(path.sep).join("/");
+    }
+    catch (error) {
+        // Keep whatever generation produced, then move on to the next file.
+        if (wrotePreview && !report.artifact)
+            await saveArtifact(previewPath, candidate.path, options.testsDir, report);
+        Object.assign(report, { status: "failed", detail: firstLine(error instanceof Error ? error.message : String(error)) });
+    }
+    finally {
+        if (wrotePreview)
+            await rm(previewPath, { force: true });
+        report.durationMs = Date.now() - startedAt;
+        report.usage = {
+            inputTokens: budget.usage.inputTokens - usageBefore.inputTokens,
+            outputTokens: budget.usage.outputTokens - usageBefore.outputTokens,
+        };
+        report.costUsd = estimateCost(budget.model, report.usage) ?? null;
+    }
+    return result;
+}
+async function saveArtifact(previewPath, relativeSource, testsDir, report) {
+    const artifact = path.join(testsDir, path.dirname(relativeSource), path.basename(previewPath));
+    try {
+        await mkdir(path.dirname(artifact), { recursive: true });
+        await copyFile(previewPath, artifact);
+        report.artifact = path.relative(path.dirname(testsDir), artifact).split(path.sep).join("/");
+    }
+    catch {
+        // The preview may not exist any more; the report still records the failure.
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/ci/run.js.map

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

package/dist/ci/select.d.ts

@@ -0,0 +1,58 @@
+import { UserError } from "../errors.js";
+export declare class SelectionError extends UserError {
+}
+/**
+ * Paths that are never worth generating tests for: dependencies, build output, tests themselves,
+ * type declarations, minified and generated code.
+ */
+export declare const DEFAULT_EXCLUDES: string[];
+export type ChangeStatus = "added" | "modified" | "renamed" | "copied" | "deleted" | "explicit";
+export interface ChangedFile {
+    /** Repository-relative path with forward slashes. */
+    path: string;
+    status: ChangeStatus;
+    /** Previous path of a renamed or copied file. */
+    from?: string;
+}
+export type SkipReason = "deleted" | "unsupported" | "excluded" | "not-included" | "generated" | "not-a-file" | "outside-workspace" | "too-large" | "file-limit" | "budget" | "no-exported-functions" | "preview-exists" | "dry-run" | "not-processed";
+export interface Candidate extends ChangedFile {
+    /** Undefined when the file is eligible. */
+    skip?: {
+        reason: SkipReason;
+        detail: string;
+    };
+}
+/** Commit-ish values from event data or inputs. Rejects anything git could read as an option. */
+export declare function checkRef(ref: string, name: string): string;
+export declare function repositoryRoot(cwd: string): Promise<string>;
+/** Parses `git diff --name-status -z` output. Paths may contain spaces, quotes, newlines, or any other byte. */
+export declare function parseNameStatus(output: string): ChangedFile[];
+/**
+ * Files added, modified, renamed, or deleted on `head` since it branched from `base`
+ * (`git diff base...head`), relative to the repository root.
+ */
+export declare function changedFiles(options: {
+    cwd: string;
+    base: string;
+    head?: string;
+}): Promise<ChangedFile[]>;
+/** Splits a multi-line or comma-separated input into trimmed, non-empty entries. */
+export declare function splitList(value: string | undefined): string[];
+/** Like `splitList`, but newline-only, so file names may contain commas. */
+export declare function splitLines(value: string | undefined): string[];
+/**
+ * Converts a glob to a regular expression: `**` matches any number of directories, `*` anything but `/`,
+ * `?` one character, and `{a,b}` alternatives. Patterns without a `/` match the file name at any depth.
+ */
+export declare function globToRegExp(glob: string): RegExp;
+export declare function matchesAny(file: string, patterns: RegExp[]): boolean;
+export interface ClassifyOptions {
+    root: string;
+    include: string[];
+    exclude: string[];
+    useDefaultExcludes: boolean;
+}
+/** Decides for each changed file whether Assertloom should generate tests for it, and why not. */
+export declare function classify(files: ChangedFile[], options: ClassifyOptions): Promise<Candidate[]>;
+/** Explicit file inputs, for manual runs outside a pull request. */
+export declare function explicitFiles(paths: string[], root: string, cwd: string): ChangedFile[];

package/dist/ci/select.js

@@ -0,0 +1,238 @@
+import { execFile } from "node:child_process";
+import { lstat, readFile, realpath } from "node:fs/promises";
+import path from "node:path";
+import { UserError } from "../errors.js";
+import { SUPPORTED_EXTENSIONS } from "../types/index.js";
+export class SelectionError extends UserError {
+}
+/**
+ * Paths that are never worth generating tests for: dependencies, build output, tests themselves,
+ * type declarations, minified and generated code.
+ */
+export const DEFAULT_EXCLUDES = [
+    "**/node_modules/**",
+    "**/dist/**",
+    "**/build/**",
+    "**/out/**",
+    "**/coverage/**",
+    "**/vendor/**",
+    "**/.next/**",
+    "**/.nuxt/**",
+    "**/__tests__/**",
+    "**/__mocks__/**",
+    "**/__generated__/**",
+    "**/*.test.*",
+    "**/*.spec.*",
+    "**/*.d.ts",
+    "**/*.d.mts",
+    "**/*.d.cts",
+    "**/*.min.js",
+    "**/*.generated.*",
+];
+const MAX_FILE_SIZE_BYTES = 1024 * 1024;
+const GIT_MAX_BUFFER = 64 * 1024 * 1024;
+function git(args, cwd) {
+    return new Promise((resolve, reject) => {
+        // Arguments are passed as an array with no shell, so file names and refs are never interpreted.
+        execFile("git", args, { cwd, encoding: "utf8", maxBuffer: GIT_MAX_BUFFER, windowsHide: true }, (error, stdout, stderr) => {
+            if (error)
+                reject(Object.assign(error, { stderr: String(stderr) }));
+            else
+                resolve(stdout);
+        });
+    });
+}
+/** Commit-ish values from event data or inputs. Rejects anything git could read as an option. */
+export function checkRef(ref, name) {
+    if (!/^[0-9A-Za-z][0-9A-Za-z._/~^@{}-]*$/.test(ref) || ref.includes("..")) {
+        throw new SelectionError(`${name} "${ref.slice(0, 80)}" is not a valid commit SHA or ref.`);
+    }
+    return ref;
+}
+export async function repositoryRoot(cwd) {
+    try {
+        return path.resolve((await git(["rev-parse", "--show-toplevel"], cwd)).trim());
+    }
+    catch {
+        throw new SelectionError(`${cwd} is not inside a git repository. Check out the repository first (actions/checkout).`);
+    }
+}
+async function resolveCommit(ref, name, cwd) {
+    try {
+        return (await git(["rev-parse", "--verify", "--quiet", "--end-of-options", `${ref}^{commit}`], cwd)).trim();
+    }
+    catch {
+        const shallow = (await git(["rev-parse", "--is-shallow-repository"], cwd).catch(() => "")).trim() === "true";
+        throw new SelectionError(`The ${name} commit ${ref} is not available in this checkout${shallow ? " (it is a shallow clone)" : ""}. ` +
+            "Check out with full history (actions/checkout with `fetch-depth: 0`), or fetch the base commit before running Assertloom.");
+    }
+}
+/** Parses `git diff --name-status -z` output. Paths may contain spaces, quotes, newlines, or any other byte. */
+export function parseNameStatus(output) {
+    const fields = output.split("\0");
+    if (fields.at(-1) === "")
+        fields.pop();
+    const files = [];
+    for (let i = 0; i < fields.length;) {
+        const code = fields[i++];
+        const kind = code[0];
+        if (kind === "R" || kind === "C") {
+            const from = fields[i++];
+            const to = fields[i++];
+            files.push({ path: to, status: kind === "R" ? "renamed" : "copied", from });
+        }
+        else {
+            const file = fields[i++];
+            const status = kind === "A" ? "added" : kind === "D" ? "deleted" : "modified";
+            files.push({ path: file, status });
+        }
+    }
+    return files;
+}
+/**
+ * Files added, modified, renamed, or deleted on `head` since it branched from `base`
+ * (`git diff base...head`), relative to the repository root.
+ */
+export async function changedFiles(options) {
+    const base = await resolveCommit(checkRef(options.base, "Base"), "base", options.cwd);
+    const head = await resolveCommit(checkRef(options.head ?? "HEAD", "Head"), "head", options.cwd);
+    try {
+        await git(["merge-base", base, head], options.cwd);
+    }
+    catch {
+        throw new SelectionError(`No common ancestor of ${base.slice(0, 12)} and ${head.slice(0, 12)} is available. ` +
+            "The checkout is probably shallow: use actions/checkout with `fetch-depth: 0`.");
+    }
+    const output = await git(["-c", "core.quotepath=off", "diff", "--name-status", "-z", "--find-renames", "--no-ext-diff", "--no-textconv", `${base}...${head}`, "--"], options.cwd);
+    return parseNameStatus(output);
+}
+/** Splits a multi-line or comma-separated input into trimmed, non-empty entries. */
+export function splitList(value) {
+    if (!value)
+        return [];
+    return value
+        .split(/\r?\n|,/)
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+/** Like `splitList`, but newline-only, so file names may contain commas. */
+export function splitLines(value) {
+    if (!value)
+        return [];
+    return value
+        .split(/\r?\n/)
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+/**
+ * Converts a glob to a regular expression: `**` matches any number of directories, `*` anything but `/`,
+ * `?` one character, and `{a,b}` alternatives. Patterns without a `/` match the file name at any depth.
+ */
+export function globToRegExp(glob) {
+    const pattern = glob.includes("/") ? glob.replace(/^\.\//, "").replace(/^\//, "") : `**/${glob}`;
+    let re = "";
+    let braces = 0;
+    for (let i = 0; i < pattern.length; i++) {
+        const c = pattern[i];
+        if (c === "*") {
+            if (pattern[i + 1] === "*") {
+                const slash = pattern[i + 2] === "/";
+                re += slash ? "(?:.*/)?" : ".*";
+                i += slash ? 2 : 1;
+            }
+            else {
+                re += "[^/]*";
+            }
+        }
+        else if (c === "?")
+            re += "[^/]";
+        else if (c === "{") {
+            braces++;
+            re += "(?:";
+        }
+        else if (c === "}" && braces > 0) {
+            braces--;
+            re += ")";
+        }
+        else if (c === "," && braces > 0)
+            re += "|";
+        else
+            re += c.replace(/[.+^$()|[\]\\]/g, "\\$&");
+    }
+    return new RegExp(`^${re}$`);
+}
+export function matchesAny(file, patterns) {
+    return patterns.some((p) => p.test(file));
+}
+const toPosix = (p) => p.split(path.sep).join("/");
+/** `@generated` near the top of a file marks it as machine-written (a common convention). */
+function looksGenerated(head) {
+    return /@generated\b|\bDO NOT EDIT\b|^\/\/ Generated by Assertloom\./m.test(head.slice(0, 600));
+}
+/** Decides for each changed file whether Assertloom should generate tests for it, and why not. */
+export async function classify(files, options) {
+    const include = options.include.map(globToRegExp);
+    const exclude = [...(options.useDefaultExcludes ? DEFAULT_EXCLUDES : []), ...options.exclude].map(globToRegExp);
+    const realRoot = await realpath(options.root);
+    const seen = new Set();
+    const result = [];
+    for (const file of files) {
+        const rel = toPosix(file.path);
+        const key = `${file.status === "deleted" ? "D" : ""}${rel}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        const candidate = { ...file, path: rel };
+        candidate.skip = await skipReason(candidate, { include, exclude, root: options.root, realRoot });
+        result.push(candidate);
+    }
+    return result.sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
+}
+async function skipReason(file, ctx) {
+    if (file.status === "deleted")
+        return { reason: "deleted", detail: "deleted in this change" };
+    const absolute = path.resolve(ctx.root, file.path);
+    const inside = path.relative(ctx.root, absolute);
+    if (!inside || inside.startsWith("..") || path.isAbsolute(inside)) {
+        return { reason: "outside-workspace", detail: "path is outside the repository" };
+    }
+    const extension = path.extname(file.path).toLowerCase();
+    if (!SUPPORTED_EXTENSIONS.includes(extension)) {
+        return { reason: "unsupported", detail: `unsupported file type "${extension || "(none)"}"` };
+    }
+    if (matchesAny(file.path, ctx.exclude))
+        return { reason: "excluded", detail: "matches an exclude pattern" };
+    if (ctx.include.length && !matchesAny(file.path, ctx.include))
+        return { reason: "not-included", detail: "matches no include pattern" };
+    let stats;
+    try {
+        stats = await lstat(absolute);
+    }
+    catch {
+        return { reason: "not-a-file", detail: "not found in the checkout" };
+    }
+    // A symlink could point outside the repository; its target would be sent to the model.
+    if (stats.isSymbolicLink())
+        return { reason: "not-a-file", detail: "symbolic link" };
+    if (!stats.isFile())
+        return { reason: "not-a-file", detail: "not a regular file" };
+    const real = await realpath(absolute);
+    const realInside = path.relative(ctx.realRoot, real);
+    if (realInside.startsWith("..") || path.isAbsolute(realInside)) {
+        return { reason: "outside-workspace", detail: "resolves outside the repository" };
+    }
+    if (stats.size > MAX_FILE_SIZE_BYTES)
+        return { reason: "too-large", detail: `${Math.round(stats.size / 1024)} KB; the limit is 1 MB` };
+    const head = (await readFile(absolute, "utf8")).slice(0, 600);
+    if (looksGenerated(head))
+        return { reason: "generated", detail: "marked as generated" };
+    return undefined;
+}
+/** Explicit file inputs, for manual runs outside a pull request. */
+export function explicitFiles(paths, root, cwd) {
+    return paths.map((p) => {
+        const relative = path.relative(root, path.resolve(cwd, p));
+        return { path: relative.startsWith("..") || path.isAbsolute(relative) ? p : toPosix(relative), status: "explicit" };
+    });
+}
+//# sourceMappingURL=select.js.map

package/dist/ci/select.js.map

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

package/dist/cli/commands/analyze.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerAnalyzeCommand(program: Command): void;

package/dist/cli/commands/analyze.js

@@ -0,0 +1,49 @@
+import { formatSignature } from "../../analyzer/format.js";
+import { analyzeFile } from "../../analyzer/index.js";
+import { validateSourceFile } from "../validateFile.js";
+function plural(count, word, pluralWord = `${word}s`) {
+    return `${count} ${count === 1 ? word : pluralWord}`;
+}
+function signature(fn) {
+    const alias = fn.exportedAs.filter((name) => name !== fn.name);
+    const notes = [
+        alias.length ? `exported as ${alias.join(", ")}` : "",
+        fn.throws ? "throws" : "",
+        fn.dependencies.length || fn.globals.length ? `uses ${[...fn.dependencies, ...fn.globals.map((g) => `global ${g}`)].join(", ")}` : "",
+    ].filter(Boolean);
+    return `${formatSignature(fn)}${notes.length ? `  [${notes.join("; ")}]` : ""}`;
+}
+function printSummary(analysis) {
+    const exported = analysis.functions.filter((f) => f.exported);
+    const internal = analysis.functions.length - exported.length;
+    const { local, external, builtin } = analysis.dependencies;
+    const language = analysis.language === "typescript" ? "TypeScript" : "JavaScript";
+    console.log(`✓ Parsed ${analysis.file} (${language}, ${analysis.moduleSystem === "none" ? "no imports/exports" : analysis.moduleSystem.toUpperCase()})`);
+    console.log(`✓ Found ${plural(exported.length, "exported function")}${internal ? ` (+${internal} internal)` : ""}`);
+    console.log(`✓ Found ${plural(local.length + external.length + builtin.length, "dependency", "dependencies")} ` +
+        `(${external.length} external, ${local.length} local, ${builtin.length} built-in)`);
+    if (exported.length) {
+        console.log("");
+        for (const fn of exported)
+            console.log(`  ${signature(fn)}`);
+    }
+    if (external.length)
+        console.log(`\nExternal packages: ${external.join(", ")}`);
+}
+export function registerAnalyzeCommand(program) {
+    program
+        .command("analyze")
+        .description("Statically analyze a JS/TS file: exported functions, parameters, imports, and dependencies")
+        .argument("<file>", "path to a JavaScript or TypeScript source file")
+        .option("--json", "print the full analysis as JSON")
+        .action(async (file, options) => {
+        const analysis = await analyzeFile(await validateSourceFile(file));
+        if (options.json) {
+            console.log(JSON.stringify(analysis, null, 2));
+        }
+        else {
+            printSummary(analysis);
+        }
+    });
+}
+//# sourceMappingURL=analyze.js.map

package/dist/cli/commands/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../../src/cli/commands/analyze.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/ci.d.ts

@@ -0,0 +1,37 @@
+import { type Command } from "commander";
+import { type LLMProvider, type ProviderOptions } from "../../ai/index.js";
+import { type CiReport } from "../../ci/report.js";
+import type { RunResult } from "../../runner/index.js";
+/** Environment variables that hold provider credentials. Their values are redacted from everything Assertloom writes. */
+export declare const CREDENTIAL_ENV: string[];
+export declare const DEFAULT_CI_MAX_FILES = 10;
+export declare const DEFAULT_CI_MAX_COST_USD = 1;
+export interface CiCommandOptions {
+    base?: string;
+    head?: string;
+    files?: string;
+    include?: string;
+    exclude?: string;
+    defaultExcludes: boolean;
+    maxFiles: string;
+    maxCost: string;
+    maxTokens?: string;
+    maxAttempts: string;
+    timeout: string;
+    out: string;
+    failOn: string;
+    provider: string;
+    model?: string;
+    baseUrl?: string;
+    workingDirectory?: string;
+    dryRun?: boolean;
+    githubSummary?: string;
+    githubOutput?: string;
+}
+export interface CiDependencies {
+    createProvider: (name: string, options: ProviderOptions) => LLMProvider;
+    runTests?: (testPath: string, sourcePath: string) => Promise<RunResult>;
+    log: (line: string) => void;
+}
+export declare function runCi(options: CiCommandOptions, deps: CiDependencies): Promise<CiReport>;
+export declare function registerCiCommand(program: Command, deps?: Partial<CiDependencies>): void;