ralph-cursor 0.1.0

package/dist/commands/task.js

@@ -0,0 +1,161 @@
+import { Command } from "commander";
+import { resolve } from "path";
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { getTaskFilePath, getAllTasks, getNextTask, getProgress, markTaskComplete, markTaskIncomplete, checkTaskComplete, parseTasks, } from "../task-parser/index.js";
+import { ensureRalphDir, getRalphDir } from "../lib/ralph-dir.js";
+export function taskCommand() {
+    const task = new Command("task")
+        .description("Task operations: list, next, complete, incomplete, parse, export");
+    task
+        .command("list")
+        .description("List all tasks (id, status, description)")
+        .argument("[workspace]", "Project directory (default: current)")
+        .option("--task <path>", "Path to task file")
+        .action((workspaceArg, opts) => {
+        const workspace = workspaceArg ? resolve(process.cwd(), workspaceArg) : process.cwd();
+        if (!existsSync(workspace)) {
+            console.error("Workspace not found:", workspace);
+            process.exit(2);
+        }
+        ensureRalphDir(workspace);
+        const path = getTaskFilePath(workspace, opts.task);
+        if (!existsSync(path)) {
+            console.error("No task file. Run: ralph-cursor init");
+            process.exit(2);
+        }
+        const tasks = getAllTasks(workspace, opts.task);
+        const progress = getProgress(workspace, opts.task);
+        console.log(`Tasks (${progress} done/total):\n`);
+        for (const t of tasks) {
+            const mark = t.status === "completed" ? "[x]" : "[ ]";
+            console.log(`  ${t.id}  ${mark}  ${t.description}`);
+        }
+    });
+    task
+        .command("next")
+        .description("Print the next incomplete task (id and description)")
+        .argument("[workspace]", "Project directory (default: current)")
+        .option("--task <path>", "Path to task file")
+        .action((workspaceArg, opts) => {
+        const workspace = workspaceArg ? resolve(process.cwd(), workspaceArg) : process.cwd();
+        if (!existsSync(workspace)) {
+            console.error("Workspace not found:", workspace);
+            process.exit(2);
+        }
+        ensureRalphDir(workspace);
+        if (checkTaskComplete(workspace, opts.task) === "NO_TASK_FILE") {
+            console.error("No task file. Run: ralph-cursor init");
+            process.exit(2);
+        }
+        const next = getNextTask(workspace, opts.task);
+        if (!next) {
+            console.log("All tasks complete.");
+            process.exit(0);
+        }
+        console.log(`${next.id}|${next.status}|${next.description}`);
+    });
+    task
+        .command("complete <id>")
+        .description("Mark a task complete by id (e.g. line_5)")
+        .argument("[workspace]", "Project directory (default: current)")
+        .option("--task <path>", "Path to task file")
+        .action((taskId, workspaceArg, opts) => {
+        const workspace = workspaceArg ? resolve(process.cwd(), workspaceArg) : process.cwd();
+        if (!existsSync(workspace)) {
+            console.error("Workspace not found:", workspace);
+            process.exit(2);
+        }
+        ensureRalphDir(workspace);
+        if (checkTaskComplete(workspace, opts.task) === "NO_TASK_FILE") {
+            console.error("No task file. Run: ralph-cursor init");
+            process.exit(2);
+        }
+        try {
+            markTaskComplete(workspace, taskId, opts.task);
+            console.log(`Marked ${taskId} complete.`);
+        }
+        catch (err) {
+            console.error(err instanceof Error ? err.message : err);
+            process.exit(1);
+        }
+    });
+    task
+        .command("incomplete <id>")
+        .description("Mark a task incomplete by id (e.g. line_5)")
+        .argument("[workspace]", "Project directory (default: current)")
+        .option("--task <path>", "Path to task file")
+        .action((taskId, workspaceArg, opts) => {
+        const workspace = workspaceArg ? resolve(process.cwd(), workspaceArg) : process.cwd();
+        if (!existsSync(workspace)) {
+            console.error("Workspace not found:", workspace);
+            process.exit(2);
+        }
+        ensureRalphDir(workspace);
+        if (checkTaskComplete(workspace, opts.task) === "NO_TASK_FILE") {
+            console.error("No task file. Run: ralph-cursor init");
+            process.exit(2);
+        }
+        try {
+            markTaskIncomplete(workspace, taskId, opts.task);
+            console.log(`Marked ${taskId} incomplete.`);
+        }
+        catch (err) {
+            console.error(err instanceof Error ? err.message : err);
+            process.exit(1);
+        }
+    });
+    task
+        .command("parse")
+        .description("Parse task file and update cache (.ralph/tasks.yaml)")
+        .argument("[workspace]", "Project directory (default: current)")
+        .option("--task <path>", "Path to task file")
+        .action((workspaceArg, opts) => {
+        const workspace = workspaceArg ? resolve(process.cwd(), workspaceArg) : process.cwd();
+        if (!existsSync(workspace)) {
+            console.error("Workspace not found:", workspace);
+            process.exit(2);
+        }
+        ensureRalphDir(workspace);
+        const path = getTaskFilePath(workspace, opts.task);
+        if (!existsSync(path)) {
+            console.error("No task file. Run: ralph-cursor init");
+            process.exit(2);
+        }
+        try {
+            parseTasks(workspace, opts.task);
+            console.log("Cache updated.");
+        }
+        catch (err) {
+            console.error(err instanceof Error ? err.message : err);
+            process.exit(1);
+        }
+    });
+    task
+        .command("export")
+        .description("Print task cache as YAML (same as .ralph/tasks.yaml)")
+        .argument("[workspace]", "Project directory (default: current)")
+        .option("--task <path>", "Path to task file")
+        .action((workspaceArg, opts) => {
+        const workspace = workspaceArg ? resolve(process.cwd(), workspaceArg) : process.cwd();
+        if (!existsSync(workspace)) {
+            console.error("Workspace not found:", workspace);
+            process.exit(2);
+        }
+        ensureRalphDir(workspace);
+        const path = getTaskFilePath(workspace, opts.task);
+        if (!existsSync(path)) {
+            console.error("No task file. Run: ralph-cursor init");
+            process.exit(2);
+        }
+        getAllTasks(workspace, opts.task);
+        const yamlPath = join(getRalphDir(workspace), "tasks.yaml");
+        if (!existsSync(yamlPath)) {
+            console.error("Cache not found. Run: ralph-cursor task parse");
+            process.exit(1);
+        }
+        console.log(readFileSync(yamlPath, "utf-8"));
+    });
+    return task;
+}
+//# sourceMappingURL=task.js.map

package/dist/commands/task.js.map

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

package/dist/lib/config.d.ts

@@ -0,0 +1,8 @@
+export interface RalphConfig {
+    warn_threshold: number;
+    rotate_threshold: number;
+    default_model: string;
+    max_iterations: number;
+}
+export declare function loadConfig(workspace: string): RalphConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AASD,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CA+BzD"}

package/dist/lib/config.js

@@ -0,0 +1,48 @@
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+import { getRalphDir } from "./ralph-dir.js";
+const DEFAULTS = {
+    warn_threshold: 70_000,
+    rotate_threshold: 80_000,
+    default_model: "opus-4.5-thinking",
+    max_iterations: 20,
+};
+export function loadConfig(workspace) {
+    const configPath = join(getRalphDir(workspace), "config.json");
+    const out = { ...DEFAULTS };
+    if (existsSync(configPath)) {
+        try {
+            const data = JSON.parse(readFileSync(configPath, "utf-8"));
+            if (typeof data.warn_threshold === "number")
+                out.warn_threshold = data.warn_threshold;
+            if (typeof data.rotate_threshold === "number")
+                out.rotate_threshold = data.rotate_threshold;
+            if (typeof data.default_model === "string")
+                out.default_model = data.default_model;
+            if (typeof data.max_iterations === "number")
+                out.max_iterations = data.max_iterations;
+        }
+        catch {
+            // ignore invalid config
+        }
+    }
+    if (process.env.RALPH_WARN_THRESHOLD ?? process.env.WARN_THRESHOLD) {
+        const n = parseInt(String(process.env.RALPH_WARN_THRESHOLD ?? process.env.WARN_THRESHOLD), 10);
+        if (!isNaN(n))
+            out.warn_threshold = n;
+    }
+    if (process.env.RALPH_ROTATE_THRESHOLD ?? process.env.ROTATE_THRESHOLD) {
+        const n = parseInt(String(process.env.RALPH_ROTATE_THRESHOLD ?? process.env.ROTATE_THRESHOLD), 10);
+        if (!isNaN(n))
+            out.rotate_threshold = n;
+    }
+    if (process.env.RALPH_MODEL)
+        out.default_model = process.env.RALPH_MODEL;
+    if (process.env.MAX_ITERATIONS) {
+        const n = parseInt(process.env.MAX_ITERATIONS, 10);
+        if (!isNaN(n))
+            out.max_iterations = n;
+    }
+    return out;
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAS7C,MAAM,QAAQ,GAAgB;IAC5B,cAAc,EAAE,MAAM;IACtB,gBAAgB,EAAE,MAAM;IACxB,aAAa,EAAE,mBAAmB;IAClC,cAAc,EAAE,EAAE;CACnB,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,SAAiB;IAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;IAE5B,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAyB,CAAC;YACnF,IAAI,OAAO,IAAI,CAAC,cAAc,KAAK,QAAQ;gBAAE,GAAG,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;YACtF,IAAI,OAAO,IAAI,CAAC,gBAAgB,KAAK,QAAQ;gBAAE,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;YAC5F,IAAI,OAAO,IAAI,CAAC,aAAa,KAAK,QAAQ;gBAAE,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;YACnF,IAAI,OAAO,IAAI,CAAC,cAAc,KAAK,QAAQ;gBAAE,GAAG,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QACxF,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QACnE,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/F,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAAE,GAAG,CAAC,cAAc,GAAG,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACvE,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,EAAE,CAAC,CAAC;QACnG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAAE,GAAG,CAAC,gBAAgB,GAAG,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW;QAAE,GAAG,CAAC,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IACzE,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QAC/B,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAAE,GAAG,CAAC,cAAc,GAAG,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/lib/last-run.d.ts

@@ -0,0 +1,12 @@
+export interface LastRunOptions {
+    model: string;
+    max_iterations: number;
+    use_branch: string;
+    open_pr: boolean;
+    parallel: boolean;
+    max_parallel: number;
+}
+export declare function getLastRunPath(workspace: string): string;
+export declare function readLastRun(workspace: string): LastRunOptions | null;
+export declare function writeLastRun(workspace: string, options: Partial<LastRunOptions>): void;
+//# sourceMappingURL=last-run.d.ts.map

package/dist/lib/last-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"last-run.d.ts","sourceRoot":"","sources":["../../src/lib/last-run.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAWD,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CASpE;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAKtF"}

package/dist/lib/last-run.js

@@ -0,0 +1,33 @@
+import { readFileSync, writeFileSync, existsSync } from "fs";
+import { join } from "path";
+import { getRalphDir } from "./ralph-dir.js";
+const DEFAULT_LAST_RUN = {
+    model: "opus-4.5-thinking",
+    max_iterations: 20,
+    use_branch: "",
+    open_pr: false,
+    parallel: false,
+    max_parallel: 3,
+};
+export function getLastRunPath(workspace) {
+    return join(getRalphDir(workspace), "last-run.json");
+}
+export function readLastRun(workspace) {
+    const path = getLastRunPath(workspace);
+    if (!existsSync(path))
+        return null;
+    try {
+        const data = JSON.parse(readFileSync(path, "utf-8"));
+        return { ...DEFAULT_LAST_RUN, ...data };
+    }
+    catch {
+        return null;
+    }
+}
+export function writeLastRun(workspace, options) {
+    const path = getLastRunPath(workspace);
+    const current = readLastRun(workspace) ?? DEFAULT_LAST_RUN;
+    const merged = { ...current, ...options };
+    writeFileSync(path, JSON.stringify(merged, null, 2));
+}
+//# sourceMappingURL=last-run.js.map

package/dist/lib/last-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"last-run.js","sourceRoot":"","sources":["../../src/lib/last-run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAW7C,MAAM,gBAAgB,GAAmB;IACvC,KAAK,EAAE,mBAAmB;IAC1B,cAAc,EAAE,EAAE;IAClB,UAAU,EAAE,EAAE;IACd,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,CAAC;CAChB,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,eAAe,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC3C,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IACvC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QACrD,OAAO,EAAE,GAAG,gBAAgB,EAAE,GAAG,IAAI,EAAE,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,OAAgC;IAC9E,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,WAAW,CAAC,SAAS,CAAC,IAAI,gBAAgB,CAAC;IAC3D,MAAM,MAAM,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;IAC1C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC"}

package/dist/lib/ralph-dir.d.ts

@@ -0,0 +1,6 @@
+export declare function getRalphDir(workspace: string): string;
+export declare function ensureRalphDir(workspace: string): void;
+export declare function getIteration(workspace: string): number;
+export declare function setIteration(workspace: string, iteration: number): void;
+export declare function logProgress(workspace: string, message: string): void;
+//# sourceMappingURL=ralph-dir.d.ts.map

package/dist/lib/ralph-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralph-dir.d.ts","sourceRoot":"","sources":["../../src/lib/ralph-dir.ts"],"names":[],"mappings":"AAUA,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAuEtD;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKtD;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAIvE;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAKpE"}

package/dist/lib/ralph-dir.js

@@ -0,0 +1,96 @@
+import { appendFileSync, mkdirSync, readFileSync, writeFileSync, existsSync } from "fs";
+import { join } from "path";
+const RALPH_DIR = ".ralph";
+const ITERATION_FILE = ".iteration";
+const PROGRESS_FILE = "progress.md";
+const GUARDRAILS_FILE = "guardrails.md";
+const ERRORS_FILE = "errors.log";
+const ACTIVITY_FILE = "activity.log";
+export function getRalphDir(workspace) {
+    return join(workspace, RALPH_DIR);
+}
+export function ensureRalphDir(workspace) {
+    const ralphDir = getRalphDir(workspace);
+    if (!existsSync(ralphDir)) {
+        mkdirSync(ralphDir, { recursive: true });
+    }
+    const progressPath = join(ralphDir, PROGRESS_FILE);
+    if (!existsSync(progressPath)) {
+        writeFileSync(progressPath, `# Progress Log
+
+> Updated by the agent after significant work.
+
+## Summary
+
+- Iterations completed: 0
+- Current status: Initialized
+
+## How This Works
+
+Progress is tracked in THIS FILE, not in LLM context.
+When context is rotated (fresh agent), the new agent reads this file.
+This is how Ralph maintains continuity across iterations.
+
+## Session History
+
+`);
+    }
+    const guardrailsPath = join(ralphDir, GUARDRAILS_FILE);
+    if (!existsSync(guardrailsPath)) {
+        writeFileSync(guardrailsPath, `# Ralph Guardrails (Signs)
+
+> Lessons learned from past failures. READ THESE BEFORE ACTING.
+
+## Core Signs
+
+### Sign: Read Before Writing
+- **Trigger**: Before modifying any file
+- **Instruction**: Always read the existing file first
+- **Added after**: Core principle
+
+### Sign: Test After Changes
+- **Trigger**: After any code change
+- **Instruction**: Run tests to verify nothing broke
+- **Added after**: Core principle
+
+### Sign: Commit Checkpoints
+- **Trigger**: Before risky changes
+- **Instruction**: Commit current working state first
+- **Added after**: Core principle
+
+---
+
+## Learned Signs
+
+(Signs added from observed failures will appear below)
+
+`);
+    }
+    const errorsPath = join(ralphDir, ERRORS_FILE);
+    if (!existsSync(errorsPath)) {
+        writeFileSync(errorsPath, "# Error Log\n\n");
+    }
+    const activityPath = join(ralphDir, ACTIVITY_FILE);
+    if (!existsSync(activityPath)) {
+        writeFileSync(activityPath, "# Activity Log\n\n");
+    }
+}
+export function getIteration(workspace) {
+    const path = join(getRalphDir(workspace), ITERATION_FILE);
+    if (!existsSync(path))
+        return 0;
+    const n = parseInt(readFileSync(path, "utf-8").trim(), 10);
+    return isNaN(n) ? 0 : n;
+}
+export function setIteration(workspace, iteration) {
+    ensureRalphDir(workspace);
+    const path = join(getRalphDir(workspace), ITERATION_FILE);
+    writeFileSync(path, String(iteration));
+}
+export function logProgress(workspace, message) {
+    ensureRalphDir(workspace);
+    const path = join(getRalphDir(workspace), PROGRESS_FILE);
+    const ts = new Date().toISOString().replace("T", " ").slice(0, 19);
+    appendFileSync(path, `\n### ${ts}\n${message}\n`);
+}
+//# sourceMappingURL=ralph-dir.js.map

package/dist/lib/ralph-dir.js.map

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

package/dist/lib/spawn.d.ts

@@ -0,0 +1,11 @@
+import { type ChildProcess } from "child_process";
+export interface SpawnOptions {
+    model: string;
+    sessionId?: string;
+}
+/**
+ * Spawn cursor-agent with the given prompt. Returns the child process.
+ * Caller should wire stdout to the stream parser and write prompt to stdin.
+ */
+export declare function spawnCursorAgent(prompt: string, options: SpawnOptions): ChildProcess;
+//# sourceMappingURL=spawn.d.ts.map

package/dist/lib/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../src/lib/spawn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,YAAY,GACpB,YAAY,CAsBd"}

package/dist/lib/spawn.js

@@ -0,0 +1,29 @@
+import { spawn } from "child_process";
+/**
+ * Spawn cursor-agent with the given prompt. Returns the child process.
+ * Caller should wire stdout to the stream parser and write prompt to stdin.
+ */
+export function spawnCursorAgent(prompt, options) {
+    const args = [
+        "-p",
+        "--force",
+        "--output-format",
+        "stream-json",
+        "--model",
+        options.model,
+    ];
+    if (options.sessionId) {
+        args.push("--resume", options.sessionId);
+    }
+    const child = spawn("cursor-agent", args, {
+        stdio: ["pipe", "pipe", "inherit"],
+        shell: false,
+    });
+    if (child.stdin) {
+        child.stdin.write(prompt, "utf-8", () => {
+            child.stdin?.end();
+        });
+    }
+    return child;
+}
+//# sourceMappingURL=spawn.js.map

package/dist/lib/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../../src/lib/spawn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,eAAe,CAAC;AAOzD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAc,EACd,OAAqB;IAErB,MAAM,IAAI,GAAG;QACX,IAAI;QACJ,SAAS;QACT,iBAAiB;QACjB,aAAa;QACb,SAAS;QACT,OAAO,CAAC,KAAK;KACd,CAAC;IACF,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,cAAc,EAAE,IAAI,EAAE;QACxC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC;QAClC,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE;YACtC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC;QACrB,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/lib/tail.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Stream last N lines of a file, then follow new content (like tail -f).
+ * Cross-platform: no dependency on the `tail` command.
+ */
+export declare function tailFile(filePath: string, options?: {
+    follow?: boolean;
+    lines?: number;
+}): void;
+//# sourceMappingURL=tail.d.ts.map

package/dist/lib/tail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tail.d.ts","sourceRoot":"","sources":["../../src/lib/tail.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACjD,IAAI,CAoDN"}

package/dist/lib/tail.js

@@ -0,0 +1,58 @@
+import { createReadStream, readFileSync, watch } from "fs";
+import { createInterface } from "readline";
+const DEFAULT_LINES = 50;
+/**
+ * Stream last N lines of a file, then follow new content (like tail -f).
+ * Cross-platform: no dependency on the `tail` command.
+ */
+export function tailFile(filePath, options = {}) {
+    const { follow = true, lines = DEFAULT_LINES } = options;
+    const buffer = [];
+    const stream = createReadStream(filePath, { encoding: "utf-8" });
+    const rl = createInterface({ input: stream, crlfDelay: Infinity });
+    rl.on("line", (line) => {
+        buffer.push(line);
+        if (buffer.length > lines)
+            buffer.shift();
+    });
+    rl.on("close", () => {
+        buffer.forEach((l) => console.log(l));
+        if (!follow) {
+            process.exit(0);
+            return;
+        }
+        let lastOffset = 0;
+        try {
+            const content = readFileSync(filePath, "utf-8");
+            lastOffset = content.length;
+        }
+        catch {
+            lastOffset = 0;
+        }
+        const watcher = watch(filePath, { persistent: true }, () => {
+            try {
+                const content = readFileSync(filePath, "utf-8");
+                if (content.length > lastOffset) {
+                    const newPart = content.slice(lastOffset);
+                    newPart.split("\n").forEach((l) => {
+                        if (l.length > 0)
+                            console.log(l);
+                    });
+                    lastOffset = content.length;
+                }
+            }
+            catch {
+                // file may be rotated or deleted
+            }
+        });
+        process.on("SIGINT", () => {
+            watcher.close();
+            process.exit(0);
+        });
+    });
+    stream.on("error", (err) => {
+        console.error(err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=tail.js.map

package/dist/lib/tail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tail.js","sourceRoot":"","sources":["../../src/lib/tail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB;;;GAGG;AACH,MAAM,UAAU,QAAQ,CACtB,QAAgB,EAChB,UAAgD,EAAE;IAElD,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,GAAG,aAAa,EAAE,GAAG,OAAO,CAAC;IACzD,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IACjE,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;IAEnE,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;QAC7B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,IAAI,MAAM,CAAC,MAAM,GAAG,KAAK;YAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QAClB,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QAED,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAChD,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,GAAG,CAAC,CAAC;QACjB,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE;YACzD,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAChD,IAAI,OAAO,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;oBAChC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;oBAC1C,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;wBAChC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;4BAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;oBACnC,CAAC,CAAC,CAAC;oBACH,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;gBAC9B,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,iCAAiC;YACnC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;YACxB,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QACzB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/loop/index.d.ts

@@ -0,0 +1,32 @@
+export type RalphSignal = "ROTATE" | "WARN" | "GUTTER" | "COMPLETE" | "DEFER";
+export interface RunIterationOptions {
+    workspace: string;
+    iteration: number;
+    model: string;
+    sessionId?: string;
+    warnThreshold?: number;
+    rotateThreshold?: number;
+    taskFilePath?: string;
+}
+export interface RunLoopOptions {
+    workspace: string;
+    model: string;
+    maxIterations: number;
+    useBranch?: string;
+    openPr?: boolean;
+    taskFilePath?: string;
+    warnThreshold?: number;
+    rotateThreshold?: number;
+}
+/**
+ * Run a single agent iteration. Returns the signal (ROTATE, GUTTER, COMPLETE, DEFER) or null when agent exits without signal.
+ */
+export declare function runIteration(options: RunIterationOptions): Promise<RalphSignal | null>;
+/**
+ * Run the main Ralph loop until COMPLETE, GUTTER, or max iterations.
+ */
+export declare function runRalphLoop(options: RunLoopOptions): Promise<{
+    success: boolean;
+    iterations: number;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/loop/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/loop/index.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAE9E,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAmBD;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAgE5F;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CA0F7G"}