flakelab 0.1.0

package/dist/investigator/schema.d.ts

@@ -0,0 +1,110 @@
+import { z } from "zod";
+export declare const experimentResultSchema: z.ZodObject<{
+    confirmed: z.ZodBoolean;
+    dominantFailureSignature: z.ZodOptional<z.ZodString>;
+    dominantFailureReason: z.ZodOptional<z.ZodString>;
+    errors: z.ZodNumber;
+    failed: z.ZodNumber;
+    failureRate: z.ZodNumber;
+    lowerBound80: z.ZodNumber;
+    passed: z.ZodNumber;
+    trials: z.ZodNumber;
+}, z.core.$strip>;
+export declare const experimentConditionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"baseline">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"network-delay">;
+    delayMs: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"request-failure">;
+    statusCode: z.ZodNumber;
+}, z.core.$strip>], "kind">;
+export declare const hypothesisSchema: z.ZodObject<{
+    id: z.ZodString;
+    statement: z.ZodString;
+    prediction: z.ZodString;
+    status: z.ZodEnum<{
+        rejected: "rejected";
+        confirmed: "confirmed";
+        proposed: "proposed";
+    }>;
+    evidenceExperimentIds: z.ZodArray<z.ZodString>;
+    explanation: z.ZodString;
+}, z.core.$strip>;
+export declare const experimentEvidenceSchema: z.ZodObject<{
+    id: z.ZodString;
+    hypothesisId: z.ZodString;
+    condition: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"baseline">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"network-delay">;
+        delayMs: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"request-failure">;
+        statusCode: z.ZodNumber;
+    }, z.core.$strip>], "kind">;
+    result: z.ZodObject<{
+        confirmed: z.ZodBoolean;
+        dominantFailureSignature: z.ZodOptional<z.ZodString>;
+        dominantFailureReason: z.ZodOptional<z.ZodString>;
+        errors: z.ZodNumber;
+        failed: z.ZodNumber;
+        failureRate: z.ZodNumber;
+        lowerBound80: z.ZodNumber;
+        passed: z.ZodNumber;
+        trials: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const investigationReportSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    test: z.ZodString;
+    model: z.ZodString;
+    conclusion: z.ZodString;
+    conclusionHypothesisId: z.ZodString;
+    conclusionEvidenceIds: z.ZodArray<z.ZodString>;
+    hypotheses: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        statement: z.ZodString;
+        prediction: z.ZodString;
+        status: z.ZodEnum<{
+            rejected: "rejected";
+            confirmed: "confirmed";
+            proposed: "proposed";
+        }>;
+        evidenceExperimentIds: z.ZodArray<z.ZodString>;
+        explanation: z.ZodString;
+    }, z.core.$strip>>;
+    experiments: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        hypothesisId: z.ZodString;
+        condition: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"baseline">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"network-delay">;
+            delayMs: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"request-failure">;
+            statusCode: z.ZodNumber;
+        }, z.core.$strip>], "kind">;
+        result: z.ZodObject<{
+            confirmed: z.ZodBoolean;
+            dominantFailureSignature: z.ZodOptional<z.ZodString>;
+            dominantFailureReason: z.ZodOptional<z.ZodString>;
+            errors: z.ZodNumber;
+            failed: z.ZodNumber;
+            failureRate: z.ZodNumber;
+            lowerBound80: z.ZodNumber;
+            passed: z.ZodNumber;
+            trials: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    usage: z.ZodObject<{
+        inputTokens: z.ZodNumber;
+        outputTokens: z.ZodNumber;
+        estimatedCostUsd: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ExperimentCondition = z.infer<typeof experimentConditionSchema>;
+export type ExperimentEvidence = z.infer<typeof experimentEvidenceSchema>;
+export type Hypothesis = z.infer<typeof hypothesisSchema>;
+export type InvestigationReport = z.infer<typeof investigationReportSchema>;

package/dist/investigator/schema.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+export const experimentResultSchema = z.object({
+    confirmed: z.boolean(),
+    dominantFailureSignature: z.string().min(1).optional(),
+    dominantFailureReason: z.string().min(1).max(2_000).optional(),
+    errors: z.number().int().nonnegative(),
+    failed: z.number().int().nonnegative(),
+    failureRate: z.number().min(0).max(1),
+    lowerBound80: z.number().min(0).max(1),
+    passed: z.number().int().nonnegative(),
+    trials: z.number().int().nonnegative(),
+});
+export const experimentConditionSchema = z.discriminatedUnion("kind", [
+    z.object({ kind: z.literal("baseline") }),
+    z.object({
+        kind: z.literal("network-delay"),
+        delayMs: z.number().int().min(1).max(30_000),
+    }),
+    z.object({
+        kind: z.literal("request-failure"),
+        statusCode: z.number().int().min(400).max(599),
+    }),
+]);
+export const hypothesisSchema = z.object({
+    id: z.string().regex(/^H\d+$/u),
+    statement: z.string().min(8).max(500),
+    prediction: z.string().min(8).max(500),
+    status: z.enum(["proposed", "rejected", "confirmed"]),
+    evidenceExperimentIds: z.array(z.string().regex(/^E\d+$/u)),
+    explanation: z.string().max(1_000),
+});
+export const experimentEvidenceSchema = z.object({
+    id: z.string().regex(/^E\d+$/u),
+    hypothesisId: z.string().regex(/^H\d+$/u),
+    condition: experimentConditionSchema,
+    result: experimentResultSchema,
+});
+export const investigationReportSchema = z.object({
+    version: z.literal(1),
+    test: z.string().min(1),
+    model: z.string().min(1),
+    conclusion: z.string().min(8).max(2_000),
+    conclusionHypothesisId: z.string().regex(/^H\d+$/u),
+    conclusionEvidenceIds: z.array(z.string().regex(/^E\d+$/u)).min(1),
+    hypotheses: z.array(hypothesisSchema).min(2),
+    experiments: z.array(experimentEvidenceSchema).min(1),
+    usage: z.object({
+        inputTokens: z.number().int().nonnegative(),
+        outputTokens: z.number().int().nonnegative(),
+        estimatedCostUsd: z.number().nonnegative(),
+    }),
+});
+//# sourceMappingURL=schema.js.map

package/dist/investigator/schema.js.map

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

package/dist/playwright.d.ts

@@ -0,0 +1,3 @@
+import { expect } from "@playwright/test";
+export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
+export { expect };

package/dist/playwright.js

@@ -0,0 +1,21 @@
+import { expect, test as base } from "@playwright/test";
+import { installFault } from "./faults/install.js";
+import { readNetworkDelayFromEnvironment } from "./faults/network-delay.js";
+import { readRequestFailureFromEnvironment } from "./faults/request-failure.js";
+function readFaultFromEnvironment() {
+    return readNetworkDelayFromEnvironment() ?? readRequestFailureFromEnvironment();
+}
+export const test = base.extend({
+    page: async ({ page }, use) => {
+        const fault = readFaultFromEnvironment();
+        const removeFault = fault ? await installFault(page, fault) : undefined;
+        try {
+            await use(page);
+        }
+        finally {
+            await removeFault?.();
+        }
+    },
+});
+export { expect };
+//# sourceMappingURL=playwright.js.map

package/dist/playwright.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright.js","sourceRoot":"","sources":["../src/playwright.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,IAAI,IAAI,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAGvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAA;AAC3E,OAAO,EAAE,iCAAiC,EAAE,MAAM,6BAA6B,CAAA;AAE/E,SAAS,wBAAwB;IAC/B,OAAO,+BAA+B,EAAE,IAAI,iCAAiC,EAAE,CAAA;AACjF,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;IAC9B,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE;QAC5B,MAAM,KAAK,GAAG,wBAAwB,EAAE,CAAA;QACxC,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACvE,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,IAAI,CAAC,CAAA;QACjB,CAAC;gBAAS,CAAC;YACT,MAAM,WAAW,EAAE,EAAE,CAAA;QACvB,CAAC;IACH,CAAC;CACF,CAAC,CAAA;AAEF,OAAO,EAAE,MAAM,EAAE,CAAA"}

package/dist/providers/errors.d.ts

@@ -0,0 +1,21 @@
+export type ProviderName = "Groq" | "Solari";
+export type ProviderFailureCategory = "authentication" | "billing" | "capacity" | "concurrency" | "configuration" | "network" | "permission" | "rate-limit" | "request" | "timeout" | "unavailable";
+interface ProviderFailureOptions {
+    action: string;
+    category: ProviderFailureCategory;
+    provider: ProviderName;
+    retryable: boolean;
+    status?: number;
+}
+export declare class ProviderFailure extends Error {
+    readonly action: string;
+    readonly category: ProviderFailureCategory;
+    readonly provider: ProviderName;
+    readonly retryable: boolean;
+    readonly status?: number;
+    constructor(message: string, options: ProviderFailureOptions);
+}
+export declare function solariResponseFailure(response: Response): Promise<ProviderFailure>;
+export declare function normalizeProviderError(error: Error): Error;
+export declare function cliErrorMessage(error: Error): string;
+export {};

package/dist/providers/errors.js

@@ -0,0 +1,159 @@
+import { SolariError as BrowserSolariError } from "@solarisdk/browser";
+import { ConnectionError, GatewayError, TimeoutError, } from "@solarisdk/sandbox";
+import { APICallError, RetryError } from "ai";
+import { z } from "zod";
+const groqErrorSchema = z.object({
+    error: z.object({
+        code: z.string().optional(),
+        type: z.string().optional(),
+    }),
+});
+const solariErrorSchema = z.object({
+    code: z.string().optional(),
+});
+export class ProviderFailure extends Error {
+    action;
+    category;
+    provider;
+    retryable;
+    status;
+    constructor(message, options) {
+        super(message);
+        this.name = "ProviderFailure";
+        this.action = options.action;
+        this.category = options.category;
+        this.provider = options.provider;
+        this.retryable = options.retryable;
+        this.status = options.status;
+    }
+}
+function failure(provider, category, message, action, status, retryable = false) {
+    return new ProviderFailure(message, { action, category, provider, retryable, status });
+}
+function parseGroqCode(error) {
+    if (!error.responseBody) {
+        return undefined;
+    }
+    try {
+        const parsed = groqErrorSchema.safeParse(JSON.parse(error.responseBody));
+        return parsed.success ? parsed.data.error.code : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+const GROQ_STATUS_FAILURES = new Map([
+    [401, () => failure("Groq", "authentication", "Groq rejected the configured API key.", "Replace GROQ_API_KEY or rerun with --prompt-credentials.", 401)],
+    [403, () => failure("Groq", "permission", "Groq denied access to the requested model.", "Enable the model for the Groq project or choose an allowed model.", 403)],
+    [404, () => failure("Groq", "configuration", "The configured Groq model is unavailable.", "Check --model and the models enabled for the Groq project.", 404)],
+    [408, () => failure("Groq", "timeout", "The Groq request timed out.", "Rerun the investigation; increase --max-seconds only if necessary.", 408, true)],
+    [413, () => failure("Groq", "request", "The Groq request exceeded the provider payload limit.", "Reduce the selected source context before rerunning.", 413)],
+    [429, () => failure("Groq", "rate-limit", "The Groq project reached a request or token limit.", "Wait for the limit to reset or raise the project limit, then rerun.", 429, true)],
+    [498, () => failure("Groq", "capacity", "Groq Flex capacity is temporarily unavailable.", "Retry later or use the default service tier.", 498, true)],
+    [499, () => failure("Groq", "timeout", "The Groq request was cancelled.", "Rerun the investigation when ready.", 499, true)],
+]);
+function groqCodeFailure(code, status) {
+    if (code === "invalid_api_key") {
+        return GROQ_STATUS_FAILURES.get(401)?.() ?? failure("Groq", "authentication", "Groq rejected the configured API key.", "Replace GROQ_API_KEY or rerun with --prompt-credentials.", status);
+    }
+    if (code === "capacity_exceeded") {
+        return failure("Groq", "capacity", "Groq Flex capacity is temporarily unavailable.", "Retry later or use the default service tier.", status, true);
+    }
+    if (code === "blocked_api_access") {
+        return failure("Groq", "billing", "Groq API access is blocked by the organization spend limit.", "Review the Groq organization billing limit before rerunning.", status);
+    }
+    return undefined;
+}
+function mapGroqError(error) {
+    const status = error.statusCode;
+    const codeFailure = groqCodeFailure(parseGroqCode(error), status);
+    if (codeFailure) {
+        return codeFailure;
+    }
+    const knownStatus = status ? GROQ_STATUS_FAILURES.get(status) : undefined;
+    if (knownStatus) {
+        return knownStatus();
+    }
+    if (status === 400 || status === 422 || status === 424) {
+        return failure("Groq", "request", "Groq rejected the investigation request.", "Check the selected model and request configuration.", status);
+    }
+    if (error.isRetryable) {
+        return failure("Groq", "unavailable", "Groq could not complete the investigation request.", "Retry after a short delay.", status, true);
+    }
+    return failure("Groq", "request", "Groq could not complete the investigation request.", "Check the Groq project and model settings.", status);
+}
+const SOLARI_STATUS_FAILURES = new Map([
+    [401, () => failure("Solari", "authentication", "Solari rejected the configured API key.", "Replace SOLARI_API_KEY or rerun with --prompt-credentials.", 401)],
+    [402, () => failure("Solari", "permission", "The Solari plan does not allow this operation.", "Review the account plan and enabled products in the Solari console.", 402)],
+    [403, () => failure("Solari", "permission", "The Solari plan does not allow this operation.", "Review the account plan and enabled products in the Solari console.", 403)],
+    [409, () => failure("Solari", "configuration", "A Solari resource is not ready for this operation.", "Resolve the template, snapshot, or idempotency conflict before rerunning.", 409)],
+    [429, () => failure("Solari", "concurrency", "The Solari account is at its concurrent-session cap.", "Wait for, pause, or kill an existing session before rerunning.", 429)],
+    [501, () => failure("Solari", "configuration", "The requested Solari feature is not configured.", "Choose a supported feature or contact Solari support.", 501)],
+]);
+function solariGatewayFailure(status, code) {
+    if (code === "InsufficientCredit") {
+        return failure("Solari", "billing", "The Solari account has insufficient prepaid credit.", "Add credit in the Solari console before requesting isolated proof.", status);
+    }
+    if (code === "ConcurrencyLimitExceeded") {
+        return failure("Solari", "concurrency", "The Solari account is at its concurrent-session cap.", "Wait for, pause, or kill an existing session before rerunning.", status);
+    }
+    if (code === "BrowserUnhealthy") {
+        return failure("Solari", "unavailable", "The allocated Solari browser failed its health check.", "Rerun once; the browser SDK will allocate a fresh session.", status || undefined, true);
+    }
+    if (status === 502 || status === 503 || status === 504) {
+        return failure("Solari", "capacity", "Solari infrastructure is temporarily unavailable.", "Retry after a short delay; FlakeLab preserves bounded cleanup.", status, true);
+    }
+    const knownStatus = SOLARI_STATUS_FAILURES.get(status);
+    if (knownStatus) {
+        return knownStatus();
+    }
+    return failure("Solari", "request", "Solari rejected the isolated execution request.", "Check the requested resource and Solari account configuration.", status);
+}
+function mapSolariError(error) {
+    if (error instanceof GatewayError) {
+        return solariGatewayFailure(error.status, error.code);
+    }
+    if (error instanceof TimeoutError) {
+        return failure("Solari", "timeout", "A Solari operation exceeded its deadline.", "Retry once; if it repeats, inspect Solari service health.", undefined, true);
+    }
+    if (error instanceof ConnectionError) {
+        return failure("Solari", "network", "FlakeLab could not reach the Solari control channel.", "Check connectivity and rerun; no credential change is required.", undefined, true);
+    }
+    if (error instanceof BrowserSolariError) {
+        return solariGatewayFailure(error.status ?? 0, error.code);
+    }
+    return undefined;
+}
+export async function solariResponseFailure(response) {
+    const body = await response.text();
+    let code;
+    try {
+        const parsed = solariErrorSchema.safeParse(JSON.parse(body));
+        code = parsed.success ? parsed.data.code : undefined;
+    }
+    catch {
+        code = undefined;
+    }
+    return solariGatewayFailure(response.status, code);
+}
+export function normalizeProviderError(error) {
+    if (error instanceof ProviderFailure) {
+        return error;
+    }
+    if (RetryError.isInstance(error) && error.lastError instanceof Error) {
+        return normalizeProviderError(error.lastError);
+    }
+    if (APICallError.isInstance(error)) {
+        return mapGroqError(error);
+    }
+    return mapSolariError(error) ?? error;
+}
+export function cliErrorMessage(error) {
+    const normalized = normalizeProviderError(error);
+    if (!(normalized instanceof ProviderFailure)) {
+        return normalized.message;
+    }
+    const status = normalized.status ? ` · HTTP ${normalized.status}` : "";
+    return `${normalized.provider} ${normalized.category}${status}: ${normalized.message}\n${normalized.action}`;
+}
+//# sourceMappingURL=errors.js.map

package/dist/providers/errors.js.map

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

package/dist/repair/file.d.ts

@@ -0,0 +1,2 @@
+import type { ProofOfFix } from "./schema.js";
+export declare function readProofOfFix(path: string): Promise<ProofOfFix>;

package/dist/repair/file.js

@@ -0,0 +1,6 @@
+import { readFile } from "node:fs/promises";
+import { proofOfFixSchema } from "./schema.js";
+export async function readProofOfFix(path) {
+    return proofOfFixSchema.parse(JSON.parse(await readFile(path, "utf8")));
+}
+//# sourceMappingURL=file.js.map

package/dist/repair/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../src/repair/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAE3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAG9C,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,OAAO,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;AACzE,CAAC"}

package/dist/repair/generator.d.ts

@@ -0,0 +1,12 @@
+import type { LanguageModel } from "ai";
+import type { InvestigationReport } from "../investigator/schema.js";
+import type { CandidatePatch } from "./schema.js";
+interface PatchGeneratorOptions {
+    investigation: InvestigationReport;
+    maxSeconds: number;
+    model: LanguageModel;
+    projectRoot: string;
+    signal?: AbortSignal;
+}
+export declare function generateCandidatePatch(options: PatchGeneratorOptions): Promise<CandidatePatch>;
+export {};

package/dist/repair/generator.js

@@ -0,0 +1,74 @@
+import { generateText, Output } from "ai";
+import { readSafeTestContext } from "../investigator/safe-source.js";
+import { validateCandidatePatch } from "./policy.js";
+import { candidatePatchSchema } from "./schema.js";
+function patchPrompt(investigation, sources) {
+    return [
+        "Propose the smallest application-code repair for this experimentally confirmed failure.",
+        "Do not edit the selected test, assertions, test configuration, or dependency configuration.",
+        "Do not skip errors, add blanket catches, disable lint rules, or merely increase a timeout.",
+        "When control flow changes, remove obsolete timers, flags, branches, and write-only state.",
+        "The resulting source must pass strict type-aware ESLint with zero warnings.",
+        "Each edit must replace one exact, verbatim source substring. Prefer one cohesive edit.",
+        "The repair must preserve normal behavior and make the hostile condition pass.",
+        "Investigation evidence:",
+        JSON.stringify(investigation, null, 2),
+        "Bounded local source context:",
+        ...sources.flatMap((source) => [`--- ${source.path}`, source.content]),
+    ].join("\n");
+}
+async function requestCandidate(options, prompt) {
+    let currentPrompt = prompt;
+    for (let attempt = 1; attempt <= 2; attempt += 1) {
+        try {
+            const result = await generateText({
+                model: options.model,
+                output: Output.object({ schema: candidatePatchSchema }),
+                prompt: currentPrompt,
+                maxOutputTokens: 1_500,
+                maxRetries: 2,
+                timeout: { totalMs: options.maxSeconds * 1_000 },
+                abortSignal: options.signal,
+                temperature: 0.2,
+            });
+            return result.output;
+        }
+        catch (error) {
+            if (attempt === 2) {
+                throw error;
+            }
+            currentPrompt = [
+                prompt,
+                "Your previous response did not match the required candidate patch schema.",
+                "Return summary, rationale, and 1-3 exact edits with path, before, and after fields.",
+            ].join("\n");
+        }
+    }
+    throw new Error("Structured candidate generation exhausted its retry budget");
+}
+export async function generateCandidatePatch(options) {
+    const sources = await readSafeTestContext(options.projectRoot, options.investigation.test);
+    const allowedPaths = sources.map((source) => source.path);
+    let prompt = patchPrompt(options.investigation, sources);
+    for (let attempt = 1; attempt <= 2; attempt += 1) {
+        const candidate = await requestCandidate(options, prompt);
+        try {
+            return await validateCandidatePatch(options.projectRoot, options.investigation.test, allowedPaths, candidate);
+        }
+        catch (error) {
+            if (attempt === 2) {
+                throw error;
+            }
+            const reason = error instanceof Error ? error.message : "Candidate violated patch policy";
+            prompt = [
+                prompt,
+                "The previous candidate was rejected before execution.",
+                `Policy reason: ${reason}`,
+                `Rejected candidate: ${JSON.stringify(candidate)}`,
+                "Produce a structural application fix that satisfies the original constraints.",
+            ].join("\n");
+        }
+    }
+    throw new Error("Candidate generation exhausted its revision budget");
+}
+//# sourceMappingURL=generator.js.map

package/dist/repair/generator.js.map

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

package/dist/repair/policy.d.ts

@@ -0,0 +1,2 @@
+import type { CandidatePatch } from "./schema.js";
+export declare function validateCandidatePatch(projectRoot: string, selectedTest: string, allowedSourcePaths: string[], value: CandidatePatch): Promise<CandidatePatch>;

package/dist/repair/policy.js

@@ -0,0 +1,70 @@
+import { readFile } from "node:fs/promises";
+import { extname, relative, resolve } from "node:path";
+import { candidatePatchSchema } from "./schema.js";
+const ALLOWED_EXTENSIONS = new Set([".js", ".jsx", ".mjs", ".ts", ".tsx"]);
+const FORBIDDEN_ADDITIONS = [
+    "test.skip",
+    "test.fixme",
+    "test.only",
+    "expect.soft",
+    "eslint-disable",
+    "@ts-ignore",
+    "@ts-expect-error",
+];
+const SECRET_ASSIGNMENT = /(?:api[_-]?key|authorization|password|secret|token)\s*[:=]\s*["'][^"']{8,}/iu;
+function normalizedRelativePath(projectRoot, requestedPath) {
+    const absolutePath = resolve(projectRoot, requestedPath);
+    const pathFromRoot = relative(projectRoot, absolutePath).replaceAll("\\", "/");
+    if (pathFromRoot.startsWith("..") || pathFromRoot.includes("node_modules")) {
+        throw new Error("Candidate edits must stay inside project source");
+    }
+    if (!ALLOWED_EXTENSIONS.has(extname(absolutePath).toLowerCase())) {
+        throw new Error("Candidate edits are limited to JavaScript and TypeScript source");
+    }
+    return pathFromRoot;
+}
+function occurrences(content, snippet) {
+    let count = 0;
+    let index = content.indexOf(snippet);
+    while (index >= 0) {
+        count += 1;
+        index = content.indexOf(snippet, index + snippet.length);
+    }
+    return count;
+}
+function onlyRaisesNumericLimits(before, after) {
+    const beforeNumbers = [...before.matchAll(/\d+/gu)].map((match) => Number(match[0]));
+    const afterNumbers = [...after.matchAll(/\d+/gu)].map((match) => Number(match[0]));
+    const sameStructure = before.replaceAll(/\d+/gu, "<number>")
+        === after.replaceAll(/\d+/gu, "<number>");
+    return sameStructure
+        && beforeNumbers.length > 0
+        && beforeNumbers.length === afterNumbers.length
+        && afterNumbers.some((value, index) => value > beforeNumbers[index]);
+}
+export async function validateCandidatePatch(projectRoot, selectedTest, allowedSourcePaths, value) {
+    const candidate = candidatePatchSchema.parse(value);
+    const normalizedTest = normalizedRelativePath(projectRoot, selectedTest);
+    const allowed = new Set(allowedSourcePaths.map((path) => normalizedRelativePath(projectRoot, path)));
+    for (const edit of candidate.edits) {
+        const path = normalizedRelativePath(projectRoot, edit.path);
+        if (path === normalizedTest || !allowed.has(path)) {
+            throw new Error(`Candidate cannot edit unapproved source: ${path}`);
+        }
+        if (FORBIDDEN_ADDITIONS.some((token) => edit.after.includes(token) && !edit.before.includes(token))) {
+            throw new Error(`Candidate introduces a forbidden test-weakening construct in ${path}`);
+        }
+        if (SECRET_ASSIGNMENT.test(edit.after)) {
+            throw new Error(`Candidate introduces a possible credential in ${path}`);
+        }
+        if (onlyRaisesNumericLimits(edit.before, edit.after)) {
+            throw new Error(`Candidate only raises a numeric timing limit in ${path}`);
+        }
+        const content = await readFile(resolve(projectRoot, path), "utf8");
+        if (occurrences(content, edit.before) !== 1) {
+            throw new Error(`Candidate edit must match exactly one source location in ${path}`);
+        }
+    }
+    return candidate;
+}
+//# sourceMappingURL=policy.js.map

package/dist/repair/policy.js.map

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

package/dist/repair/remote-proof-runner.d.ts

@@ -0,0 +1 @@
+export {};