ralphy-spec 0.1.0 → 0.2.0

package/dist/core/backends/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../../src/core/backends/claude-code.ts"],"names":[],"mappings":";;;AAAA,iCAA8B;AAG9B;;;;;GAKG;AACH,MAAa,iBAAiB;IAGC;IAFpB,EAAE,GAAG,aAAa,CAAC;IAE5B,YAA6B,OAA+B,EAAE;QAAjC,SAAI,GAAJ,IAAI,CAA6B;IAAG,CAAC;IAElE,KAAK,CAAC,SAAS,CAAC,GAAe,EAAE,KAAqB;QACpD,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;QAE/C,0CAA0C;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QAE9D,IAAI,CAAC;YACH,+DAA+D;YAC/D,iDAAiD;YACjD,MAAM,MAAM,GAAG,MAAM,IAAA,aAAK,EAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE;gBACxD,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,OAAO,EAAE,iBAAiB;gBAC1D,MAAM,EAAE,KAAK;gBACb,KAAK,EAAE,MAAM;aACd,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO;oBACL,EAAE,EAAE,IAAI;oBACR,OAAO,EAAE,+BAA+B,IAAI,CAAC,EAAE,gBAAgB,SAAS,GAAG;iBAC5E,CAAC;YACJ,CAAC;YAED,qBAAqB;YACrB,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,gCAAgC,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CACjG,CAAC,EACD,IAAI,CACL;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,iDAAiD;YACjD,IAAI,GAAG,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC3B,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,OAAO,EACL,sFAAsF;iBACzF,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,eAAe;aAC7E,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,WAAW,CACjB,IAAmD,EACnD,SAAiB,EACjB,WAAoB;QAEpB,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,IAAI,WAAW,EAAE,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,8BAA8B,SAAS,GAAG,CAAC,CAAC;YACvD,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QAEzE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF;AA/ED,8CA+EC"}

package/dist/core/backends/cursor.d.ts

@@ -0,0 +1,17 @@
+import type { BackendEnv, CodingBackend, ImplementInput, ImplementOutput } from "./types";
+/**
+ * CursorBackend shells out to the `cursor` CLI for code implementation.
+ *
+ * Note: Cursor IDE typically runs interactively. This backend sends prompts
+ * via the CLI and expects the user/AI to complete the task.
+ */
+export declare class CursorBackend implements CodingBackend {
+    private readonly opts;
+    readonly id = "cursor";
+    constructor(opts?: {
+        timeoutMs?: number;
+    });
+    implement(env: BackendEnv, input: ImplementInput): Promise<ImplementOutput>;
+    private buildPrompt;
+}
+//# sourceMappingURL=cursor.d.ts.map

package/dist/core/backends/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../../src/core/backends/cursor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1F;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,aAAa;IAGrC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,QAAQ,CAAC,EAAE,YAAY;gBAEM,IAAI,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO;IAExD,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAgDjF,OAAO,CAAC,WAAW;CA0BpB"}

package/dist/core/backends/cursor.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CursorBackend = void 0;
+const execa_1 = require("execa");
+/**
+ * CursorBackend shells out to the `cursor` CLI for code implementation.
+ *
+ * Note: Cursor IDE typically runs interactively. This backend sends prompts
+ * via the CLI and expects the user/AI to complete the task.
+ */
+class CursorBackend {
+    opts;
+    id = "cursor";
+    constructor(opts = {}) {
+        this.opts = opts;
+    }
+    async implement(env, input) {
+        const { task, iteration, repairNotes } = input;
+        // Build the prompt to send to Cursor
+        const prompt = this.buildPrompt(task, iteration, repairNotes);
+        try {
+            // Cursor CLI: `cursor --command "prompt"` or similar
+            // Note: Cursor's CLI interface may vary; adjust as needed
+            const result = await (0, execa_1.execa)("cursor", ["--command", prompt], {
+                cwd: env.cwd,
+                timeout: this.opts.timeoutMs ?? 600_000, // 10 min default
+                reject: false,
+                stdio: "pipe",
+            });
+            if (result.exitCode === 0) {
+                return {
+                    ok: true,
+                    message: `Cursor completed task "${task.id}" (iteration ${iteration})`,
+                };
+            }
+            // Non-zero exit code
+            return {
+                ok: false,
+                message: `Cursor exited with code ${result.exitCode}: ${result.stderr || result.stdout}`.slice(0, 2000),
+            };
+        }
+        catch (err) {
+            // Handle cases where cursor CLI is not available
+            if (err?.code === "ENOENT") {
+                return {
+                    ok: false,
+                    message: "Cursor CLI not found. Please ensure Cursor is installed and the CLI is in PATH.",
+                };
+            }
+            return {
+                ok: false,
+                message: err?.message ? String(err.message).slice(0, 2000) : "Unknown error",
+            };
+        }
+    }
+    buildPrompt(task, iteration, repairNotes) {
+        const lines = [];
+        lines.push(`# Task: ${task.title ?? task.id}`);
+        lines.push(``);
+        if (task.goal) {
+            lines.push(`## Goal`);
+            lines.push(task.goal);
+            lines.push(``);
+        }
+        if (repairNotes) {
+            lines.push(`## Repair Notes (iteration ${iteration})`);
+            lines.push(repairNotes);
+            lines.push(``);
+        }
+        lines.push(`Please implement this task and ensure all validators pass.`);
+        return lines.join("\n");
+    }
+}
+exports.CursorBackend = CursorBackend;
+//# sourceMappingURL=cursor.js.map

package/dist/core/backends/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../../src/core/backends/cursor.ts"],"names":[],"mappings":";;;AAAA,iCAA8B;AAG9B;;;;;GAKG;AACH,MAAa,aAAa;IAGK;IAFpB,EAAE,GAAG,QAAQ,CAAC;IAEvB,YAA6B,OAA+B,EAAE;QAAjC,SAAI,GAAJ,IAAI,CAA6B;IAAG,CAAC;IAElE,KAAK,CAAC,SAAS,CAAC,GAAe,EAAE,KAAqB;QACpD,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;QAE/C,qCAAqC;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QAE9D,IAAI,CAAC;YACH,qDAAqD;YACrD,0DAA0D;YAC1D,MAAM,MAAM,GAAG,MAAM,IAAA,aAAK,EAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE;gBAC1D,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,OAAO,EAAE,iBAAiB;gBAC1D,MAAM,EAAE,KAAK;gBACb,KAAK,EAAE,MAAM;aACd,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO;oBACL,EAAE,EAAE,IAAI;oBACR,OAAO,EAAE,0BAA0B,IAAI,CAAC,EAAE,gBAAgB,SAAS,GAAG;iBACvE,CAAC;YACJ,CAAC;YAED,qBAAqB;YACrB,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,2BAA2B,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAC5F,CAAC,EACD,IAAI,CACL;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,iDAAiD;YACjD,IAAI,GAAG,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC3B,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,OAAO,EACL,iFAAiF;iBACpF,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,eAAe;aAC7E,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,WAAW,CACjB,IAAmD,EACnD,SAAiB,EACjB,WAAoB;QAEpB,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,IAAI,WAAW,EAAE,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,8BAA8B,SAAS,GAAG,CAAC,CAAC;YACvD,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QAEzE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF;AA/ED,sCA+EC"}

package/dist/core/backends/noop.d.ts

@@ -0,0 +1,10 @@
+import type { CodingBackend } from "./types";
+export declare class NoopBackend implements CodingBackend {
+    readonly id: string;
+    constructor(id: string);
+    implement(): Promise<{
+        ok: boolean;
+        message: string;
+    }>;
+}
+//# sourceMappingURL=noop.d.ts.map

package/dist/core/backends/noop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.d.ts","sourceRoot":"","sources":["../../../src/core/backends/noop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,qBAAa,WAAY,YAAW,aAAa;aACnB,EAAE,EAAE,MAAM;gBAAV,EAAE,EAAE,MAAM;IAEhC,SAAS,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAO7D"}

package/dist/core/backends/noop.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoopBackend = void 0;
+class NoopBackend {
+    id;
+    constructor(id) {
+        this.id = id;
+    }
+    async implement() {
+        return {
+            ok: true,
+            message: "Noop backend: no code changes performed. Use validators/contracts to verify desired state.",
+        };
+    }
+}
+exports.NoopBackend = NoopBackend;
+//# sourceMappingURL=noop.js.map

package/dist/core/backends/noop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.js","sourceRoot":"","sources":["../../../src/core/backends/noop.ts"],"names":[],"mappings":";;;AAEA,MAAa,WAAW;IACM;IAA5B,YAA4B,EAAU;QAAV,OAAE,GAAF,EAAE,CAAQ;IAAG,CAAC;IAE1C,KAAK,CAAC,SAAS;QACb,OAAO;YACL,EAAE,EAAE,IAAI;YACR,OAAO,EACL,4FAA4F;SAC/F,CAAC;IACJ,CAAC;CACF;AAVD,kCAUC"}

package/dist/core/backends/opencode.d.ts

@@ -0,0 +1,16 @@
+import type { BackendEnv, CodingBackend, ImplementInput, ImplementOutput } from "./types";
+/**
+ * OpenCodeBackend shells out to the `opencode` CLI for code implementation.
+ *
+ * OpenCode is an open-source AI coding assistant that can run in headless mode.
+ */
+export declare class OpenCodeBackend implements CodingBackend {
+    private readonly opts;
+    readonly id = "opencode";
+    constructor(opts?: {
+        timeoutMs?: number;
+    });
+    implement(env: BackendEnv, input: ImplementInput): Promise<ImplementOutput>;
+    private buildPrompt;
+}
+//# sourceMappingURL=opencode.d.ts.map

package/dist/core/backends/opencode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../../src/core/backends/opencode.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1F;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,aAAa;IAGvC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,QAAQ,CAAC,EAAE,cAAc;gBAEI,IAAI,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO;IAExD,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAmDjF,OAAO,CAAC,WAAW;CA0BpB"}

package/dist/core/backends/opencode.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenCodeBackend = void 0;
+const execa_1 = require("execa");
+/**
+ * OpenCodeBackend shells out to the `opencode` CLI for code implementation.
+ *
+ * OpenCode is an open-source AI coding assistant that can run in headless mode.
+ */
+class OpenCodeBackend {
+    opts;
+    id = "opencode";
+    constructor(opts = {}) {
+        this.opts = opts;
+    }
+    async implement(env, input) {
+        const { task, iteration, repairNotes } = input;
+        // Build the prompt to send to OpenCode
+        const prompt = this.buildPrompt(task, iteration, repairNotes);
+        try {
+            // OpenCode CLI: `opencode run --prompt "..." --non-interactive`
+            const result = await (0, execa_1.execa)("opencode", ["run", "--prompt", prompt, "--non-interactive"], {
+                cwd: env.cwd,
+                timeout: this.opts.timeoutMs ?? 600_000, // 10 min default
+                reject: false,
+                stdio: "pipe",
+            });
+            if (result.exitCode === 0) {
+                return {
+                    ok: true,
+                    message: `OpenCode completed task "${task.id}" (iteration ${iteration})`,
+                };
+            }
+            // Non-zero exit code
+            return {
+                ok: false,
+                message: `OpenCode exited with code ${result.exitCode}: ${result.stderr || result.stdout}`.slice(0, 2000),
+            };
+        }
+        catch (err) {
+            // Handle cases where opencode CLI is not available
+            if (err?.code === "ENOENT") {
+                return {
+                    ok: false,
+                    message: "OpenCode CLI not found. Please ensure OpenCode is installed and in PATH.",
+                };
+            }
+            return {
+                ok: false,
+                message: err?.message ? String(err.message).slice(0, 2000) : "Unknown error",
+            };
+        }
+    }
+    buildPrompt(task, iteration, repairNotes) {
+        const lines = [];
+        lines.push(`# Task: ${task.title ?? task.id}`);
+        lines.push(``);
+        if (task.goal) {
+            lines.push(`## Goal`);
+            lines.push(task.goal);
+            lines.push(``);
+        }
+        if (repairNotes) {
+            lines.push(`## Repair Notes (iteration ${iteration})`);
+            lines.push(repairNotes);
+            lines.push(``);
+        }
+        lines.push(`Please implement this task and ensure all validators pass.`);
+        return lines.join("\n");
+    }
+}
+exports.OpenCodeBackend = OpenCodeBackend;
+//# sourceMappingURL=opencode.js.map

package/dist/core/backends/opencode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.js","sourceRoot":"","sources":["../../../src/core/backends/opencode.ts"],"names":[],"mappings":";;;AAAA,iCAA8B;AAG9B;;;;GAIG;AACH,MAAa,eAAe;IAGG;IAFpB,EAAE,GAAG,UAAU,CAAC;IAEzB,YAA6B,OAA+B,EAAE;QAAjC,SAAI,GAAJ,IAAI,CAA6B;IAAG,CAAC;IAElE,KAAK,CAAC,SAAS,CAAC,GAAe,EAAE,KAAqB;QACpD,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;QAE/C,uCAAuC;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QAE9D,IAAI,CAAC;YACH,gEAAgE;YAChE,MAAM,MAAM,GAAG,MAAM,IAAA,aAAK,EACxB,UAAU,EACV,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,mBAAmB,CAAC,EAChD;gBACE,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,OAAO,EAAE,iBAAiB;gBAC1D,MAAM,EAAE,KAAK;gBACb,KAAK,EAAE,MAAM;aACd,CACF,CAAC;YAEF,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO;oBACL,EAAE,EAAE,IAAI;oBACR,OAAO,EAAE,4BAA4B,IAAI,CAAC,EAAE,gBAAgB,SAAS,GAAG;iBACzE,CAAC;YACJ,CAAC;YAED,qBAAqB;YACrB,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,6BAA6B,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAC9F,CAAC,EACD,IAAI,CACL;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,mDAAmD;YACnD,IAAI,GAAG,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC3B,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,OAAO,EACL,0EAA0E;iBAC7E,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,eAAe;aAC7E,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,WAAW,CACjB,IAAmD,EACnD,SAAiB,EACjB,WAAoB;QAEpB,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,IAAI,WAAW,EAAE,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,8BAA8B,SAAS,GAAG,CAAC,CAAC;YACvD,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QAEzE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF;AAlFD,0CAkFC"}

package/dist/core/backends/types.d.ts

@@ -0,0 +1,21 @@
+import type { TaskSpec } from "../spec/types";
+export type BackendEnv = {
+    cwd: string;
+    backendId: string;
+};
+export type ImplementInput = {
+    task: TaskSpec;
+    iteration: number;
+    repairNotes?: string;
+};
+export type ImplementOutput = {
+    ok: boolean;
+    message: string;
+    estimatedUsd?: number;
+    estimatedTokens?: number;
+};
+export interface CodingBackend {
+    id: string;
+    implement(env: BackendEnv, input: ImplementInput): Promise<ImplementOutput>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/backends/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/backends/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,MAAM,UAAU,GAAG;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC7E"}

package/dist/core/backends/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/core/backends/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/backends/types.ts"],"names":[],"mappings":""}

package/dist/core/budgets/manager.d.ts

@@ -0,0 +1,21 @@
+import { BudgetState } from "./state";
+import type { TaskBudgetConfig } from "./tiers";
+export declare class BudgetManager {
+    private readonly state;
+    constructor(state: BudgetState);
+    preflightOrThrow(args: {
+        estimatedUsd?: number;
+        estimatedTokens?: number;
+    }): void;
+    recordIteration(wallTimeMs: number): void;
+    recordBackendUsage(args: {
+        usd?: number;
+        tokens?: number;
+    }): void;
+    getTier(config?: TaskBudgetConfig): "optimal" | "warning" | "hard";
+    shouldApplyDegrade(config?: TaskBudgetConfig): boolean;
+    isAtHardCap(config?: TaskBudgetConfig): boolean;
+    getStatus(config: TaskBudgetConfig): import("./tiers").BudgetStatus;
+    getState(): BudgetState;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/core/budgets/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/core/budgets/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGhD,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,WAAW;IAE/C,gBAAgB,CAAC,IAAI,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAejF,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIzC,kBAAkB,CAAC,IAAI,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAIjE,OAAO,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM;IAKlE,kBAAkB,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO;IAItD,WAAW,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO;IAK/C,SAAS,CAAC,MAAM,EAAE,gBAAgB;IAIlC,QAAQ,IAAI,WAAW;CAGxB"}

package/dist/core/budgets/manager.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BudgetManager = void 0;
+const tiers_1 = require("./tiers");
+class BudgetManager {
+    state;
+    constructor(state) {
+        this.state = state;
+    }
+    preflightOrThrow(args) {
+        const usdAfter = this.state.usage.usd + (args.estimatedUsd ?? 0);
+        const tokensAfter = this.state.usage.tokens + (args.estimatedTokens ?? 0);
+        if (this.state.limits.usd !== undefined && usdAfter > this.state.limits.usd) {
+            throw new Error("Budget limit exceeded (usd)");
+        }
+        if (this.state.limits.tokens !== undefined &&
+            tokensAfter > this.state.limits.tokens) {
+            throw new Error("Budget limit exceeded (tokens)");
+        }
+    }
+    recordIteration(wallTimeMs) {
+        this.state.addUsage({ wallTimeMs, iterations: 1 });
+    }
+    recordBackendUsage(args) {
+        this.state.addUsage({ usd: args.usd ?? 0, tokens: args.tokens ?? 0 });
+    }
+    getTier(config) {
+        if (!config)
+            return this.state.exceededHardLimit().ok ? "optimal" : "hard";
+        return (0, tiers_1.getBudgetTier)(this.state.usage, config);
+    }
+    shouldApplyDegrade(config) {
+        return this.getTier(config) === "warning";
+    }
+    isAtHardCap(config) {
+        if (!config)
+            return !this.state.exceededHardLimit().ok;
+        return (0, tiers_1.getBudgetStatus)(this.state.usage, config).isAtHardCap;
+    }
+    getStatus(config) {
+        return (0, tiers_1.getBudgetStatus)(this.state.usage, config);
+    }
+    getState() {
+        return this.state;
+    }
+}
+exports.BudgetManager = BudgetManager;
+//# sourceMappingURL=manager.js.map

package/dist/core/budgets/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../src/core/budgets/manager.ts"],"names":[],"mappings":";;;AAEA,mCAAyD;AAEzD,MAAa,aAAa;IACK;IAA7B,YAA6B,KAAkB;QAAlB,UAAK,GAAL,KAAK,CAAa;IAAG,CAAC;IAEnD,gBAAgB,CAAC,IAAyD;QACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC;QACjE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,CAAC,CAAC;QAE1E,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,SAAS,IAAI,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;YAC5E,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QACD,IACE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS;YACtC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EACtC,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,eAAe,CAAC,UAAkB;QAChC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,kBAAkB,CAAC,IAAuC;QACxD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,CAAC,MAAyB;QAC/B,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;QAC3E,OAAO,IAAA,qBAAa,EAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,kBAAkB,CAAC,MAAyB;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC;IAC5C,CAAC;IAED,WAAW,CAAC,MAAyB;QACnC,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC,EAAE,CAAC;QACvD,OAAO,IAAA,uBAAe,EAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,WAAW,CAAC;IAC/D,CAAC;IAED,SAAS,CAAC,MAAwB;QAChC,OAAO,IAAA,uBAAe,EAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF;AA/CD,sCA+CC"}

package/dist/core/budgets/state.d.ts

@@ -0,0 +1,25 @@
+export type BudgetUsage = {
+    usd: number;
+    tokens: number;
+    wallTimeMs: number;
+    iterations: number;
+};
+export type BudgetLimits = {
+    usd?: number;
+    tokens?: number;
+    wallTimeMs?: number;
+    maxIterations?: number;
+};
+export declare class BudgetState {
+    readonly limits: BudgetLimits;
+    usage: BudgetUsage;
+    constructor(limits: BudgetLimits);
+    addUsage(delta: Partial<BudgetUsage>): void;
+    exceededHardLimit(): {
+        ok: true;
+    } | {
+        ok: false;
+        reason: string;
+    };
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/core/budgets/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/core/budgets/state.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,qBAAa,WAAW;aAGM,MAAM,EAAE,YAAY;IAFhD,KAAK,EAAE,WAAW,CAAuD;gBAE7C,MAAM,EAAE,YAAY;IAEhD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAS3C,iBAAiB,IAAI;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAYlE"}

package/dist/core/budgets/state.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BudgetState = void 0;
+class BudgetState {
+    limits;
+    usage = { usd: 0, tokens: 0, wallTimeMs: 0, iterations: 0 };
+    constructor(limits) {
+        this.limits = limits;
+    }
+    addUsage(delta) {
+        this.usage = {
+            usd: this.usage.usd + (delta.usd ?? 0),
+            tokens: this.usage.tokens + (delta.tokens ?? 0),
+            wallTimeMs: this.usage.wallTimeMs + (delta.wallTimeMs ?? 0),
+            iterations: this.usage.iterations + (delta.iterations ?? 0),
+        };
+    }
+    exceededHardLimit() {
+        const { usd, tokens, wallTimeMs, iterations } = this.usage;
+        const lim = this.limits;
+        if (lim.usd !== undefined && usd > lim.usd)
+            return { ok: false, reason: "usd" };
+        if (lim.tokens !== undefined && tokens > lim.tokens)
+            return { ok: false, reason: "tokens" };
+        if (lim.wallTimeMs !== undefined && wallTimeMs > lim.wallTimeMs)
+            return { ok: false, reason: "wall_time" };
+        if (lim.maxIterations !== undefined && iterations > lim.maxIterations)
+            return { ok: false, reason: "iterations" };
+        return { ok: true };
+    }
+}
+exports.BudgetState = BudgetState;
+//# sourceMappingURL=state.js.map

package/dist/core/budgets/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/core/budgets/state.ts"],"names":[],"mappings":";;;AAcA,MAAa,WAAW;IAGM;IAF5B,KAAK,GAAgB,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;IAEzE,YAA4B,MAAoB;QAApB,WAAM,GAAN,MAAM,CAAc;IAAG,CAAC;IAEpD,QAAQ,CAAC,KAA2B;QAClC,IAAI,CAAC,KAAK,GAAG;YACX,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;YACtC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;YAC/C,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;YAC3D,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;SAC5D,CAAC;IACJ,CAAC;IAED,iBAAiB;QACf,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;QAExB,IAAI,GAAG,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,GAAG,GAAG,CAAC,GAAG;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAChF,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,GAAG,GAAG,CAAC,MAAM;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAC5F,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,UAAU,GAAG,GAAG,CAAC,UAAU;YAC7D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QAC5C,IAAI,GAAG,CAAC,aAAa,KAAK,SAAS,IAAI,UAAU,GAAG,GAAG,CAAC,aAAa;YACnE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;QAC7C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;CACF;AA1BD,kCA0BC"}

package/dist/core/budgets/tiers.d.ts

@@ -0,0 +1,32 @@
+import type { BudgetUsage } from "./state";
+export type BudgetTierName = "optimal" | "warning" | "hard";
+export type BudgetTierConfig = {
+    usd?: number;
+    tokens?: number;
+    timeMinutes?: number;
+};
+export type TaskBudgetConfig = {
+    optimal: BudgetTierConfig;
+    warning: BudgetTierConfig;
+    hard: BudgetTierConfig & {
+        maxIterations: number;
+    };
+};
+export type BudgetStatus = {
+    tier: BudgetTierName;
+    usedUsd: number;
+    usedTokens: number;
+    usedTimeMs: number;
+    usedIterations: number;
+    usdPctOfOptimal: number | null;
+    usdPctOfHard: number | null;
+    tokensPctOfOptimal: number | null;
+    tokensPctOfHard: number | null;
+    timePctOfOptimal: number | null;
+    timePctOfHard: number | null;
+    isInWarning: boolean;
+    isAtHardCap: boolean;
+};
+export declare function getBudgetTier(used: BudgetUsage, config: TaskBudgetConfig): BudgetTierName;
+export declare function getBudgetStatus(used: BudgetUsage, config: TaskBudgetConfig): BudgetStatus;
+//# sourceMappingURL=tiers.d.ts.map

package/dist/core/budgets/tiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiers.d.ts","sourceRoot":"","sources":["../../../src/core/budgets/tiers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;AAE5D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,IAAI,EAAE,gBAAgB,GAAG;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAQF,wBAAgB,aAAa,CAC3B,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,gBAAgB,GACvB,cAAc,CAoChB;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,gBAAgB,GACvB,YAAY,CA6Bd"}

package/dist/core/budgets/tiers.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBudgetTier = getBudgetTier;
+exports.getBudgetStatus = getBudgetStatus;
+function pct(used, limit) {
+    if (limit === undefined)
+        return null;
+    if (limit === 0)
+        return used > 0 ? 1 : 0;
+    return used / limit;
+}
+function getBudgetTier(used, config) {
+    // HARD if any configured hard metric reached (or iterations)
+    if (used.iterations >= config.hard.maxIterations)
+        return "hard";
+    const hardUsd = config.hard.usd;
+    const hardTokens = config.hard.tokens;
+    const hardTimeMs = config.hard.timeMinutes !== undefined ? config.hard.timeMinutes * 60_000 : undefined;
+    if (hardUsd !== undefined && used.usd >= hardUsd)
+        return "hard";
+    if (hardTokens !== undefined && used.tokens >= hardTokens)
+        return "hard";
+    if (hardTimeMs !== undefined && used.wallTimeMs >= hardTimeMs)
+        return "hard";
+    // WARNING if any configured "optimal" threshold crossed (or explicit warning threshold)
+    const optUsd = config.optimal.usd;
+    const optTokens = config.optimal.tokens;
+    const optTimeMs = config.optimal.timeMinutes !== undefined ? config.optimal.timeMinutes * 60_000 : undefined;
+    const warnUsd = config.warning.usd;
+    const warnTokens = config.warning.tokens;
+    const warnTimeMs = config.warning.timeMinutes !== undefined ? config.warning.timeMinutes * 60_000 : undefined;
+    const crossedUsd = (optUsd !== undefined && used.usd >= optUsd) ||
+        (warnUsd !== undefined && used.usd >= warnUsd);
+    const crossedTokens = (optTokens !== undefined && used.tokens >= optTokens) ||
+        (warnTokens !== undefined && used.tokens >= warnTokens);
+    const crossedTime = (optTimeMs !== undefined && used.wallTimeMs >= optTimeMs) ||
+        (warnTimeMs !== undefined && used.wallTimeMs >= warnTimeMs);
+    if (crossedUsd || crossedTokens || crossedTime)
+        return "warning";
+    return "optimal";
+}
+function getBudgetStatus(used, config) {
+    const tier = getBudgetTier(used, config);
+    const hardTimeMs = config.hard.timeMinutes !== undefined ? config.hard.timeMinutes * 60_000 : undefined;
+    const optTimeMs = config.optimal.timeMinutes !== undefined ? config.optimal.timeMinutes * 60_000 : undefined;
+    const isAtHardCap = tier === "hard" ||
+        used.iterations >= config.hard.maxIterations ||
+        (config.hard.usd !== undefined && used.usd >= config.hard.usd) ||
+        (config.hard.tokens !== undefined && used.tokens >= config.hard.tokens) ||
+        (hardTimeMs !== undefined && used.wallTimeMs >= hardTimeMs);
+    return {
+        tier,
+        usedUsd: used.usd,
+        usedTokens: used.tokens,
+        usedTimeMs: used.wallTimeMs,
+        usedIterations: used.iterations,
+        usdPctOfOptimal: pct(used.usd, config.optimal.usd),
+        usdPctOfHard: pct(used.usd, config.hard.usd),
+        tokensPctOfOptimal: pct(used.tokens, config.optimal.tokens),
+        tokensPctOfHard: pct(used.tokens, config.hard.tokens),
+        timePctOfOptimal: pct(used.wallTimeMs, optTimeMs),
+        timePctOfHard: pct(used.wallTimeMs, hardTimeMs),
+        isInWarning: tier === "warning",
+        isAtHardCap,
+    };
+}
+//# sourceMappingURL=tiers.js.map

package/dist/core/budgets/tiers.js.map

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

package/dist/core/engine/context-pack.d.ts

@@ -0,0 +1,12 @@
+import type { Issue, ValidateResult } from "../validators/types";
+export type ContextPack = {
+    text: string;
+    size: "full" | "warning_shrunk";
+};
+export declare function buildContextPack(args: {
+    tier: "optimal" | "warning" | "hard";
+    taskId: string;
+    validatorResults: Record<string, ValidateResult>;
+    issues: Issue[];
+}): ContextPack;
+//# sourceMappingURL=context-pack.d.ts.map

package/dist/core/engine/context-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-pack.d.ts","sourceRoot":"","sources":["../../../src/core/engine/context-pack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEjE,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;CACjC,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACjD,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB,GAAG,WAAW,CA6Cd"}

package/dist/core/engine/context-pack.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildContextPack = buildContextPack;
+function buildContextPack(args) {
+    const failing = Object.entries(args.validatorResults).filter(([, r]) => !r.ok);
+    const issueFiles = [...new Set(args.issues.map((i) => i.file).filter(Boolean))];
+    if (args.tier !== "warning") {
+        return {
+            size: "full",
+            text: [
+                `# Context`,
+                ``,
+                `Task: ${args.taskId}`,
+                ``,
+                `## Validator summary`,
+                ...Object.entries(args.validatorResults).map(([id, r]) => `- ${id}: ${r.ok ? "OK" : "FAIL"} (exit=${r.exitCode ?? "?"})`),
+                ``,
+            ].join("\n"),
+        };
+    }
+    // Warning tier: include only failing validator output + referenced files list.
+    const shrunk = [
+        `# Context (WARNING: shrunk)`,
+        ``,
+        `Task: ${args.taskId}`,
+        ``,
+        `## Failing validators`,
+        ...(failing.length
+            ? failing.map(([id, r]) => {
+                const combined = [r.stdout, r.stderr].filter(Boolean).join("\n").trim();
+                return [
+                    `### ${id}`,
+                    combined ? "```" : "(no output)",
+                    ...(combined ? [combined.slice(0, 8000), "```"] : []),
+                    ``,
+                ].join("\n");
+            })
+            : ["(none)", ""]),
+        `## Issue files (hints)`,
+        ...(issueFiles.length ? issueFiles.map((f) => `- ${f}`) : ["(none)"]),
+        ``,
+    ].join("\n");
+    return { size: "warning_shrunk", text: shrunk };
+}
+//# sourceMappingURL=context-pack.js.map

package/dist/core/engine/context-pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-pack.js","sourceRoot":"","sources":["../../../src/core/engine/context-pack.ts"],"names":[],"mappings":";;AAOA,4CAkDC;AAlDD,SAAgB,gBAAgB,CAAC,IAKhC;IACC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/E,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAa,CAAC;IAE5F,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE;gBACJ,WAAW;gBACX,EAAE;gBACF,SAAS,IAAI,CAAC,MAAM,EAAE;gBACtB,EAAE;gBACF,sBAAsB;gBACtB,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAC1C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,CAAC,QAAQ,IAAI,GAAG,GAAG,CAC5E;gBACD,EAAE;aACH,CAAC,IAAI,CAAC,IAAI,CAAC;SACb,CAAC;IACJ,CAAC;IAED,+EAA+E;IAC/E,MAAM,MAAM,GAAG;QACb,6BAA6B;QAC7B,EAAE;QACF,SAAS,IAAI,CAAC,MAAM,EAAE;QACtB,EAAE;QACF,uBAAuB;QACvB,GAAG,CAAC,OAAO,CAAC,MAAM;YAChB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE;gBACtB,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;gBACxE,OAAO;oBACL,OAAO,EAAE,EAAE;oBACX,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa;oBAChC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBACrD,EAAE;iBACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,CAAC,CAAC;YACJ,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACnB,wBAAwB;QACxB,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACrE,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAClD,CAAC"}