ralphy-spec 0.2.0 → 0.3.1

package/dist/core/artifacts/tasks-writer.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeTasksBoard = writeTasksBoard;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const folders_1 = require("../folders");
+const STATUS_ICON_EMOJI = {
+    pending: "⬜",
+    running: "⏳",
+    done: "✅",
+    blocked: "⛔",
+    error: "❌",
+};
+const STATUS_ICON_ASCII = {
+    pending: "[ ]",
+    running: "[~]",
+    done: "[x]",
+    blocked: "[!]",
+    error: "[x!]",
+};
+async function writeTasksBoard(args) {
+    const root = await (0, folders_1.ensureRalphyFolders)(args.repoRoot, args.rootDir);
+    const filePath = node_path_1.default.join(root, folders_1.FILES.tasks);
+    const titleById = new Map(args.specTasks.map((t) => [t.id, t.title]));
+    const goalById = new Map(args.specTasks.map((t) => [t.id, t.goal]));
+    const lines = [];
+    lines.push(`# TASKS`);
+    lines.push(``);
+    lines.push(`- **runId**: \`${args.runId}\``);
+    lines.push(`- **updatedAt**: ${new Date().toISOString()}`);
+    lines.push(``);
+    lines.push(`| Task | Status | Phase | Iter | Title |`);
+    lines.push(`|------|--------|-------|------|-------|`);
+    for (const r of args.rows) {
+        const mode = args.statusIcons ?? "emoji";
+        const icon = mode === "none"
+            ? ""
+            : (mode === "ascii" ? STATUS_ICON_ASCII : STATUS_ICON_EMOJI)[r.status] ?? "";
+        const title = titleById.get(r.taskId) ?? "";
+        const statusCell = `${icon ? `${icon} ` : ""}${r.status}`;
+        lines.push(`| \`${r.taskId}\` | ${statusCell} | ${r.phase ?? ""} | ${r.iteration} | ${escapePipes(title)} |`);
+    }
+    lines.push(``);
+    // Optional details for blocked/error tasks.
+    const trouble = args.rows.filter((r) => r.status === "blocked" || r.status === "error");
+    if (trouble.length) {
+        lines.push(`## Attention`);
+        lines.push(``);
+        for (const r of trouble) {
+            lines.push(`### ${r.taskId}`);
+            const goal = goalById.get(r.taskId);
+            if (goal)
+                lines.push(goal.trim());
+            if (r.lastError)
+                lines.push(`\nLast error: ${r.lastError}`);
+            lines.push(``);
+        }
+    }
+    await promises_1.default.writeFile(filePath, lines.join("\n"), "utf8");
+}
+function escapePipes(s) {
+    return s.replace(/\|/g, "\\|");
+}
+//# sourceMappingURL=tasks-writer.js.map

package/dist/core/artifacts/tasks-writer.js.map

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

package/dist/core/artifacts/tasks-writer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tasks-writer.test.d.ts.map

package/dist/core/artifacts/tasks-writer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks-writer.test.d.ts","sourceRoot":"","sources":["../../../src/core/artifacts/tasks-writer.test.ts"],"names":[],"mappings":""}

package/dist/core/artifacts/tasks-writer.test.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const tasks_writer_1 = require("./tasks-writer");
+const folders_1 = require("../folders");
+(0, vitest_1.describe)("writeTasksBoard", () => {
+    (0, vitest_1.it)("writes TASKS.md with configurable icon mode", async () => {
+        const repoRoot = await promises_1.default.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), "ralphy-artifacts-"));
+        await (0, tasks_writer_1.writeTasksBoard)({
+            repoRoot,
+            runId: "run_1",
+            statusIcons: "ascii",
+            specTasks: [{ id: "t1", title: "Hello" }],
+            rows: [{ taskId: "t1", status: "running", iteration: 2 }],
+        });
+        const tasksPath = node_path_1.default.join((0, folders_1.getRalphyRoot)(repoRoot), folders_1.FILES.tasks);
+        const md = await promises_1.default.readFile(tasksPath, "utf8");
+        (0, vitest_1.expect)(md).toContain("# TASKS");
+        (0, vitest_1.expect)(md).toContain("[~] running");
+    });
+});
+//# sourceMappingURL=tasks-writer.test.js.map

package/dist/core/artifacts/tasks-writer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks-writer.test.js","sourceRoot":"","sources":["../../../src/core/artifacts/tasks-writer.test.ts"],"names":[],"mappings":";;;;;AAAA,mCAA8C;AAC9C,gEAAkC;AAClC,sDAAyB;AACzB,0DAA6B;AAC7B,iDAAiD;AACjD,wCAAkD;AAElD,IAAA,iBAAQ,EAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAA,WAAE,EAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,QAAQ,GAAG,MAAM,kBAAE,CAAC,OAAO,CAAC,mBAAI,CAAC,IAAI,CAAC,iBAAE,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC;QAC/E,MAAM,IAAA,8BAAe,EAAC;YACpB,QAAQ;YACR,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,OAAO;YACpB,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAS,CAAC;YAChD,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;SAC1D,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,mBAAI,CAAC,IAAI,CAAC,IAAA,uBAAa,EAAC,QAAQ,CAAC,EAAE,eAAK,CAAC,KAAK,CAAC,CAAC;QAClE,MAAM,EAAE,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAChD,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAChC,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -1 +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"}
+{"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;IAqEjF,OAAO,CAAC,WAAW;CAsCpB"}

package/dist/core/backends/cursor.js

@@ -16,27 +16,41 @@ class CursorBackend {
     }
     async implement(env, input) {
         const { task, iteration, repairNotes } = input;
-        // Build the prompt to send to Cursor
+        // Build the prompt to send to Cursor Agent
         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], {
+            /**
+             * Cursor 2.x CLI provides `cursor agent` (headless) which is suitable for this backend.
+             *
+             * Notes:
+             * - Requires authentication: `cursor agent login` OR `CURSOR_API_KEY`.
+             * - `--print` makes it usable from scripts/non-interactive terminals.
+             * - `--workspace` ensures the agent operates on the task working directory.
+             */
+            const result = await (0, execa_1.execa)("cursor", ["agent", "--print", "--output-format", "text", "--workspace", env.cwd, prompt], {
                 cwd: env.cwd,
                 timeout: this.opts.timeoutMs ?? 600_000, // 10 min default
                 reject: false,
                 stdio: "pipe",
             });
+            const combined = [result.stdout, result.stderr].filter(Boolean).join("\n").trim();
+            // Cursor Agent auth failures (common on first run)
+            if (result.exitCode !== 0 && /(not logged in|authentication required)/i.test(combined)) {
+                return {
+                    ok: false,
+                    message: "Cursor Agent is not authenticated. Run `cursor agent login` (interactive) or set CURSOR_API_KEY, then retry.",
+                };
+            }
             if (result.exitCode === 0) {
                 return {
                     ok: true,
-                    message: `Cursor completed task "${task.id}" (iteration ${iteration})`,
+                    message: `Cursor Agent 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),
+                message: `Cursor Agent exited with code ${result.exitCode}: ${combined || "(no output)"}`.slice(0, 2000),
             };
         }
         catch (err) {
@@ -44,7 +58,7 @@ class CursorBackend {
             if (err?.code === "ENOENT") {
                 return {
                     ok: false,
-                    message: "Cursor CLI not found. Please ensure Cursor is installed and the CLI is in PATH.",
+                    message: "Cursor CLI not found. Install Cursor and enable its shell command so `cursor` is in PATH.",
                 };
             }
             return {
@@ -62,12 +76,21 @@ class CursorBackend {
             lines.push(task.goal);
             lines.push(``);
         }
+        lines.push(`## Where to read context`);
+        lines.push([
+            `- Read OpenSpec: \`openspec/project.yml\` and any relevant files under \`openspec/specs/**\`.`,
+            `- Read task context: \`ralphy-spec/tasks/${task.id}/CONTEXT.md\`.`,
+            `- If present, read repair notes: \`ralphy-spec/tasks/${task.id}/REPAIR.md\`.`,
+        ].join("\n"));
+        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.`);
+        lines.push(`## Instructions`);
+        lines.push(`- Implement the task in this workspace and ensure all configured validators pass.`);
+        lines.push(`- Keep changes within the task file contract / scope guard constraints.`);
         return lines.join("\n");
     }
 }

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

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

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

@@ -0,0 +1,5 @@
+export declare class BudgetExhaustedError extends Error {
+    readonly name = "BudgetExhaustedError";
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/budgets/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,0BAA0B;gBAC3B,OAAO,EAAE,MAAM;CAG5B"}

package/dist/core/budgets/errors.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BudgetExhaustedError = void 0;
+class BudgetExhaustedError extends Error {
+    name = "BudgetExhaustedError";
+    constructor(message) {
+        super(message);
+    }
+}
+exports.BudgetExhaustedError = BudgetExhaustedError;
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/budgets/errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,oBAAqB,SAAQ,KAAK;IACpC,IAAI,GAAG,sBAAsB,CAAC;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;CACF;AALD,oDAKC"}

package/dist/core/engine/constraints.d.ts

@@ -0,0 +1,16 @@
+import type { TaskSpec } from "../spec/types";
+export type ConstraintViolation = {
+    kind: "scope_violation";
+    level: "error";
+    message: string;
+    file?: string;
+    raw?: unknown;
+};
+export declare function enforceSprintConstraints(args: {
+    task: TaskSpec;
+    changedFiles: Array<{
+        file: string;
+        isNew: boolean;
+    }>;
+}): ConstraintViolation[];
+//# sourceMappingURL=constraints.d.ts.map

package/dist/core/engine/constraints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraints.d.ts","sourceRoot":"","sources":["../../../src/core/engine/constraints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,IAAI,EAAE,QAAQ,CAAC;IACf,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACvD,GAAG,mBAAmB,EAAE,CAoBxB"}

package/dist/core/engine/constraints.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enforceSprintConstraints = enforceSprintConstraints;
+function enforceSprintConstraints(args) {
+    const size = args.task.sprint?.size;
+    if (!size)
+        return [];
+    const newFiles = args.changedFiles.filter((f) => f.isNew);
+    const violations = [];
+    const maxNew = size === "XS" ? 0 : size === "S" ? 0 : size === "M" ? 2 : size === "L" ? 10 : Infinity;
+    if (newFiles.length > maxNew) {
+        violations.push({
+            kind: "scope_violation",
+            level: "error",
+            message: `Sprint size ${size} allows at most ${maxNew} new files, but found ${newFiles.length}.`,
+            raw: { size, maxNew, newFiles },
+        });
+    }
+    return violations;
+}
+//# sourceMappingURL=constraints.js.map

package/dist/core/engine/constraints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraints.js","sourceRoot":"","sources":["../../../src/core/engine/constraints.ts"],"names":[],"mappings":";;AAUA,4DAuBC;AAvBD,SAAgB,wBAAwB,CAAC,IAGxC;IACC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC;IACpC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC1D,MAAM,UAAU,GAA0B,EAAE,CAAC;IAE7C,MAAM,MAAM,GACV,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;IAEzF,IAAI,QAAQ,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;QAC7B,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,iBAAiB;YACvB,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,eAAe,IAAI,mBAAmB,MAAM,yBAAyB,QAAQ,CAAC,MAAM,GAAG;YAChG,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE;SAChC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/core/engine/constraints.policy.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=constraints.policy.test.d.ts.map

package/dist/core/engine/constraints.policy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraints.policy.test.d.ts","sourceRoot":"","sources":["../../../src/core/engine/constraints.policy.test.ts"],"names":[],"mappings":""}

package/dist/core/engine/constraints.policy.test.js

@@ -0,0 +1,85 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const loop_1 = require("./loop");
+const noop_1 = require("../backends/noop");
+class ScopeWorkspace {
+    cwd;
+    mode = "patch";
+    constructor(cwd) {
+        this.cwd = cwd;
+    }
+    async prepare(taskId) {
+        return { taskId, workingDir: this.cwd };
+    }
+    getWorkingDir() {
+        return this.cwd;
+    }
+    async getChangedFiles() {
+        // Pretend the backend changed an unrelated file.
+        return [{ file: "unrelated.txt", isNew: true }];
+    }
+    async enforceContract() {
+        return [];
+    }
+    async checkpoint() {
+        return { ref: "noop" };
+    }
+    async merge() { }
+    async revert() { }
+    async cleanup() { }
+}
+(0, vitest_1.describe)("scope guard policy", () => {
+    (0, vitest_1.it)("does not block when scopeGuard=warn", async () => {
+        const tmp = await promises_1.default.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), "ralphy-scope-"));
+        const spec = {
+            version: "1.1",
+            project: { name: "tmp", repoRoot: "." },
+            defaults: { backend: "noop", workspaceMode: "patch", checkpointMode: "commit", validators: [] },
+            policies: { scopeGuard: "warn" },
+            budgets: { limits: { commandTimeoutSeconds: 5 } },
+            validators: [],
+            tasks: [{ id: "t1", sprint: { size: "XS", intent: "fix" } }],
+            artifacts: { enabled: false },
+        };
+        const outcome = await new loop_1.EngineLoop().run({
+            repoRoot: tmp,
+            spec,
+            backend: new noop_1.NoopBackend("noop"),
+            workspace: new ScopeWorkspace(tmp),
+            dryRun: false,
+            json: true,
+        });
+        // With warn, the scope violation is a warning and should not fail the run by itself.
+        (0, vitest_1.expect)(outcome.ok).toBe(true);
+    });
+    (0, vitest_1.it)("blocks when scopeGuard=block", async () => {
+        const tmp = await promises_1.default.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), "ralphy-scope-"));
+        const spec = {
+            version: "1.1",
+            project: { name: "tmp", repoRoot: "." },
+            defaults: { backend: "noop", workspaceMode: "patch", checkpointMode: "commit", validators: [] },
+            policies: { scopeGuard: "block" },
+            budgets: { limits: { commandTimeoutSeconds: 5 } },
+            validators: [],
+            tasks: [{ id: "t1", sprint: { size: "XS", intent: "fix" } }],
+            artifacts: { enabled: false },
+        };
+        const outcome = await new loop_1.EngineLoop().run({
+            repoRoot: tmp,
+            spec,
+            backend: new noop_1.NoopBackend("noop"),
+            workspace: new ScopeWorkspace(tmp),
+            dryRun: false,
+            json: true,
+        });
+        (0, vitest_1.expect)(outcome.ok).toBe(false);
+    });
+});
+//# sourceMappingURL=constraints.policy.test.js.map

package/dist/core/engine/constraints.policy.test.js.map

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

package/dist/core/engine/loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../../src/core/engine/loop.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAY,MAAM,eAAe,CAAC;AAI3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAW7D,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,UAAU,GAClB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAQnE,qBAAa,UAAU;IACf,GAAG,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;YA8FrC,UAAU;IAsQxB,OAAO,CAAC,kBAAkB;IAwB1B,OAAO,CAAC,iBAAiB;CAiB1B"}
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../../src/core/engine/loop.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAY,MAAM,eAAe,CAAC;AAI3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAsB7D,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,UAAU,GAClB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAQnE,qBAAa,UAAU;IACf,GAAG,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;YA0KrC,UAAU;IA4qBxB,OAAO,CAAC,kBAAkB;IAwB1B,OAAO,CAAC,iBAAiB;CAiB1B"}

package/dist/core/engine/loop.hardcap.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=loop.hardcap.test.d.ts.map

package/dist/core/engine/loop.hardcap.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.hardcap.test.d.ts","sourceRoot":"","sources":["../../../src/core/engine/loop.hardcap.test.ts"],"names":[],"mappings":""}

package/dist/core/engine/loop.hardcap.test.js

@@ -0,0 +1,77 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const loop_1 = require("./loop");
+const noop_1 = require("../backends/noop");
+class MemoryWorkspace {
+    cwd;
+    mode = "patch";
+    constructor(cwd) {
+        this.cwd = cwd;
+    }
+    async prepare(taskId) {
+        return { taskId, workingDir: this.cwd };
+    }
+    getWorkingDir() {
+        return this.cwd;
+    }
+    async getChangedFiles() {
+        return [];
+    }
+    async enforceContract() {
+        return [];
+    }
+    async checkpoint() {
+        return { ref: "noop" };
+    }
+    async merge() { }
+    async revert() { }
+    async cleanup() { }
+}
+(0, vitest_1.describe)("EngineLoop hard cap blocking", () => {
+    (0, vitest_1.it)("blocks a task at hard cap without silent retries", async () => {
+        const tmp = await promises_1.default.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), "ralphy-loop-"));
+        await promises_1.default.mkdir(node_path_1.default.join(tmp, "openspec"), { recursive: true });
+        // Minimal openspec/project.yml is not required because we pass spec directly,
+        // but the persistence layer expects a repoRoot folder to exist.
+        const spec = {
+            version: "1.1",
+            project: { name: "tmp", repoRoot: "." },
+            defaults: { backend: "noop", workspaceMode: "patch", checkpointMode: "commit", validators: [] },
+            budgets: { limits: { commandTimeoutSeconds: 5 } },
+            validators: [
+                { id: "failfast", run: 'node -e "process.exit(1)"', timeoutSeconds: 5, parser: "jest" },
+            ],
+            tasks: [
+                {
+                    id: "t1",
+                    title: "Hard cap test",
+                    validators: ["failfast"],
+                    budget: { hard: { maxIterations: 1 } },
+                },
+            ],
+            artifacts: { enabled: false },
+        };
+        const engine = new loop_1.EngineLoop();
+        const outcome = await engine.run({
+            repoRoot: tmp,
+            spec,
+            backend: new noop_1.NoopBackend("noop"),
+            workspace: new MemoryWorkspace(tmp),
+            dryRun: false,
+            json: true,
+        });
+        (0, vitest_1.expect)(outcome.ok).toBe(false);
+        if (!outcome.ok) {
+            (0, vitest_1.expect)(outcome.exitCode).toBe(2);
+            (0, vitest_1.expect)(outcome.reason).toContain("Hard cap");
+        }
+    });
+});
+//# sourceMappingURL=loop.hardcap.test.js.map

package/dist/core/engine/loop.hardcap.test.js.map

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