ralph-cursor 0.1.0

package/dist/loop/index.js

@@ -0,0 +1,165 @@
+import { createInterface } from "readline";
+import { execSync } from "child_process";
+import { ensureRalphDir, getIteration, setIteration, logProgress } from "../lib/ralph-dir.js";
+import { buildPrompt } from "./prompt.js";
+import { spawnCursorAgent } from "../lib/spawn.js";
+import { createStreamParser } from "../stream-parser/index.js";
+import { checkTaskComplete } from "../task-parser/index.js";
+import { calculateBackoffDelay, sleepMs } from "./retry.js";
+function tryOpenPr(workspace, branch) {
+    try {
+        execSync(`git push -u origin ${branch}`, { cwd: workspace, stdio: "pipe" });
+    }
+    catch {
+        try {
+            execSync("git push", { cwd: workspace, stdio: "pipe" });
+        }
+        catch {
+            // push failed
+        }
+    }
+    try {
+        execSync("gh pr create --fill", { cwd: workspace, stdio: "inherit" });
+    }
+    catch {
+        console.error("⚠️  gh CLI not found or PR create failed. Push complete; create PR manually.");
+    }
+}
+/**
+ * Run a single agent iteration. Returns the signal (ROTATE, GUTTER, COMPLETE, DEFER) or null when agent exits without signal.
+ */
+export async function runIteration(options) {
+    const { workspace, iteration, model, sessionId, warnThreshold = 70_000, rotateThreshold = 80_000, } = options;
+    ensureRalphDir(workspace);
+    const prompt = buildPrompt(workspace, iteration);
+    logProgress(workspace, `**Session ${iteration} started** (model: ${model})`);
+    const parser = createStreamParser(workspace, { warnThreshold, rotateThreshold });
+    parser.startSession();
+    let signal = null;
+    parser.onSignal((s) => {
+        if (!signal)
+            signal = s;
+    });
+    const child = spawnCursorAgent(prompt, { model, sessionId });
+    if (!child.stdout) {
+        return null;
+    }
+    const verbose = process.env.RALPH_VERBOSE === "1";
+    const spinChars = "⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏";
+    let spinIdx = 0;
+    const spinnerInterval = !verbose &&
+        setInterval(() => {
+            const c = spinChars[spinIdx++ % spinChars.length];
+            process.stderr.write(`\r  🐛 Agent working... ${c}  (watch: tail -f ${workspace}/.ralph/activity.log)    `);
+        }, 100);
+    const TOKEN_LOG_INTERVAL_MS = 30_000;
+    let lastTokenLog = Date.now();
+    const rl = createInterface({ input: child.stdout, crlfDelay: Infinity });
+    for await (const line of rl) {
+        if (verbose && line.trim())
+            process.stderr.write(`[ralph] ${line}\n`);
+        parser.processLine(line);
+        const now = Date.now();
+        if (now - lastTokenLog >= TOKEN_LOG_INTERVAL_MS) {
+            parser.logTokenStatus();
+            lastTokenLog = now;
+        }
+        if (signal === "ROTATE" || signal === "DEFER") {
+            child.kill("SIGTERM");
+            break;
+        }
+    }
+    if (spinnerInterval) {
+        clearInterval(spinnerInterval);
+        process.stderr.write("\r\x1b[K");
+    }
+    parser.logTokenStatus();
+    return new Promise((resolve) => {
+        child.on("exit", () => resolve(signal));
+        if (signal === "ROTATE" || signal === "DEFER") {
+            resolve(signal);
+        }
+    });
+}
+/**
+ * Run the main Ralph loop until COMPLETE, GUTTER, or max iterations.
+ */
+export async function runRalphLoop(options) {
+    const { workspace, model, maxIterations, taskFilePath, useBranch, openPr, warnThreshold = 70_000, rotateThreshold = 80_000, } = options;
+    ensureRalphDir(workspace);
+    try {
+        const status = execSync("git status --porcelain", { cwd: workspace, encoding: "utf-8" });
+        if (status.trim()) {
+            execSync("git add -A", { cwd: workspace });
+            execSync("git commit -m \"ralph: initial commit before loop\"", { cwd: workspace });
+        }
+    }
+    catch {
+        // not a git repo or nothing to commit
+    }
+    if (useBranch) {
+        try {
+            execSync(`git checkout -b ${useBranch}`, { cwd: workspace });
+        }
+        catch {
+            execSync(`git checkout ${useBranch}`, { cwd: workspace });
+        }
+    }
+    let iteration = getIteration(workspace) || 1;
+    let sessionId;
+    let deferAttempt = 0;
+    while (iteration <= maxIterations) {
+        const signal = await runIteration({
+            workspace,
+            iteration,
+            model,
+            sessionId,
+            warnThreshold,
+            rotateThreshold,
+            taskFilePath,
+        });
+        const taskStatus = checkTaskComplete(workspace, taskFilePath);
+        if (taskStatus === "COMPLETE") {
+            logProgress(workspace, `**Session ${iteration} ended** - ✅ TASK COMPLETE`);
+            setIteration(workspace, iteration);
+            if (openPr && useBranch)
+                tryOpenPr(workspace, useBranch);
+            return { success: true, iterations: iteration };
+        }
+        if (signal === "COMPLETE" && taskStatus === "COMPLETE") {
+            logProgress(workspace, `**Session ${iteration} ended** - ✅ TASK COMPLETE (agent signaled)`);
+            setIteration(workspace, iteration);
+            if (openPr && useBranch)
+                tryOpenPr(workspace, useBranch);
+            return { success: true, iterations: iteration };
+        }
+        if (signal === "ROTATE") {
+            logProgress(workspace, `**Session ${iteration} ended** - 🔄 Context rotation`);
+            iteration += 1;
+            setIteration(workspace, iteration);
+            sessionId = undefined;
+        }
+        else if (signal === "GUTTER") {
+            logProgress(workspace, `**Session ${iteration} ended** - 🚨 GUTTER`);
+            return { success: false, iterations: iteration };
+        }
+        else if (signal === "DEFER") {
+            deferAttempt += 1;
+            const delayMs = calculateBackoffDelay(deferAttempt, 15, 120, true);
+            logProgress(workspace, `**Session ${iteration} ended** - ⏸️ DEFER (retry in ${delayMs}ms)`);
+            await sleepMs(delayMs);
+            // retry same iteration, don't increment
+        }
+        else {
+            if (taskStatus.startsWith("INCOMPLETE:")) {
+                logProgress(workspace, `**Session ${iteration} ended** - more criteria remaining`);
+                iteration += 1;
+                setIteration(workspace, iteration);
+            }
+        }
+        await sleepMs(2000);
+    }
+    logProgress(workspace, `**Loop ended** - ⚠️ Max iterations (${maxIterations}) reached`);
+    return { success: false, iterations: iteration - 1 };
+}
+//# sourceMappingURL=index.js.map

package/dist/loop/index.js.map

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

package/dist/loop/prompt.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Build the Ralph prompt for an iteration.
+ */
+export declare function buildPrompt(workspace: string, iteration: number): string;
+//# sourceMappingURL=prompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/loop/prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAwExE"}

package/dist/loop/prompt.js

@@ -0,0 +1,77 @@
+/**
+ * Build the Ralph prompt for an iteration.
+ */
+export function buildPrompt(workspace, iteration) {
+    return `# Ralph Iteration ${iteration}
+
+You are an autonomous development agent using the Ralph methodology.
+
+## FIRST: Read State Files
+
+Before doing anything:
+1. Read \`RALPH_TASK.md\` - your task and completion criteria
+2. Read \`.ralph/guardrails.md\` - lessons from past failures (FOLLOW THESE)
+3. Read \`.ralph/progress.md\` - what's been accomplished
+4. Read \`.ralph/errors.log\` - recent failures to avoid
+
+## Working Directory (Critical)
+
+You are already in a git repository. Work HERE, not in a subdirectory:
+
+- Do NOT run \`git init\` - the repo already exists
+- Do NOT run scaffolding commands that create nested directories (\`npx create-*\`, \`pnpm init\`, etc.)
+- If you need to scaffold, use flags like \`--no-git\` or scaffold into the current directory (\`.\`)
+- All code should live at the repo root or in subdirectories you create manually
+
+## Git Protocol (Critical)
+
+Ralph's strength is state-in-git, not LLM memory. Commit early and often:
+
+1. After completing each criterion, commit your changes:
+   \`git add -A && git commit -m 'ralph: implement state tracker'\`
+   \`git add -A && git commit -m 'ralph: fix async race condition'\`
+   \`git add -A && git commit -m 'ralph: add CLI adapter with commander'\`
+   Always describe what you actually did - never use placeholders like '<description>'
+2. After any significant code change (even partial): commit with descriptive message
+3. Before any risky refactor: commit current state as checkpoint
+4. Push after every 2-3 commits: \`git push\`
+
+If you get rotated, the next agent picks up from your last commit. Your commits ARE your memory.
+
+## Task Execution
+
+1. Work on the next unchecked criterion in RALPH_TASK.md (look for \`[ ]\`)
+2. Run tests after changes (check RALPH_TASK.md for test_command)
+3. **Mark completed criteria**: Edit RALPH_TASK.md and change \`[ ]\` to \`[x]\`
+   - Example: \`- [ ] Implement parser\` becomes \`- [x] Implement parser\`
+   - This is how progress is tracked - YOU MUST update the file
+4. Update \`.ralph/progress.md\` with what you accomplished
+5. When ALL criteria show \`[x]\`: output \`<ralph>COMPLETE</ralph>\`
+6. If stuck 3+ times on same issue: output \`<ralph>GUTTER</ralph>\`
+
+## Learning from Failures
+
+When something fails:
+1. Check \`.ralph/errors.log\` for failure history
+2. Figure out the root cause
+3. Add a Sign to \`.ralph/guardrails.md\` using this format:
+
+\`\`\`
+### Sign: [Descriptive Name]
+- **Trigger**: When this situation occurs
+- **Instruction**: What to do instead
+- **Added after**: Iteration ${iteration} - what happened
+\`\`\`
+
+## Context Rotation Warning
+
+You may receive a warning that context is running low. When you see it:
+1. Finish your current file edit
+2. Commit and push your changes
+3. Update .ralph/progress.md with what you accomplished and what's next
+4. You will be rotated to a fresh agent that continues your work
+
+Begin by reading the state files.
+`;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/loop/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/loop/prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,SAAiB,EAAE,SAAiB;IAC9D,OAAO,qBAAqB,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BA0DR,SAAS;;;;;;;;;;;;CAYvC,CAAC;AACF,CAAC"}

package/dist/loop/retry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Exponential backoff delay for DEFER (rate limit / transient errors).
+ * Formula: baseDelayMs * 2^(attempt-1), capped at maxDelayMs.
+ * Jitter: 0–25% random addition when useJitter is true.
+ */
+export declare function calculateBackoffDelay(attempt: number, baseDelaySeconds: number, maxDelaySeconds: number, useJitter?: boolean): number;
+export declare function sleepMs(ms: number): Promise<void>;
+export interface WithRetryOptions {
+    maxRetries?: number;
+    baseDelaySeconds?: number;
+    maxDelaySeconds?: number;
+    useJitter?: boolean;
+    /** Return true if error is retryable (default: isRetryableError from stream-parser). */
+    isRetryable?: (err: unknown) => boolean;
+}
+/**
+ * Execute an async function with retry and exponential backoff.
+ * On rejection, if isRetryable(error) and attempt < maxRetries, waits then retries.
+ * Retry with exponential backoff and jitter.
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: WithRetryOptions): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/loop/retry.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,EACxB,eAAe,EAAE,MAAM,EACvB,SAAS,GAAE,OAAc,GACxB,MAAM,CAUR;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjD;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wFAAwF;IACxF,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;CACzC;AAMD;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,CAAC,CAAC,CA8CZ"}

package/dist/loop/retry.js

@@ -0,0 +1,65 @@
+import { isRetryableError } from "../stream-parser/index.js";
+/**
+ * Exponential backoff delay for DEFER (rate limit / transient errors).
+ * Formula: baseDelayMs * 2^(attempt-1), capped at maxDelayMs.
+ * Jitter: 0–25% random addition when useJitter is true.
+ */
+export function calculateBackoffDelay(attempt, baseDelaySeconds, maxDelaySeconds, useJitter = true) {
+    const baseMs = baseDelaySeconds * 1000;
+    const maxMs = maxDelaySeconds * 1000;
+    let delayMs = baseMs * Math.pow(2, attempt - 1);
+    if (delayMs > maxMs)
+        delayMs = maxMs;
+    if (useJitter) {
+        const jitter = Math.floor(delayMs * 0.25 * Math.random());
+        delayMs += jitter;
+    }
+    return Math.floor(delayMs);
+}
+export function sleepMs(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+const DEFAULT_MAX_RETRIES = 3;
+const DEFAULT_BASE_DELAY = 1;
+const DEFAULT_MAX_DELAY = 60;
+/**
+ * Execute an async function with retry and exponential backoff.
+ * On rejection, if isRetryable(error) and attempt < maxRetries, waits then retries.
+ * Retry with exponential backoff and jitter.
+ */
+export async function withRetry(fn, options = {}) {
+    const { maxRetries = DEFAULT_MAX_RETRIES, baseDelaySeconds = DEFAULT_BASE_DELAY, maxDelaySeconds = DEFAULT_MAX_DELAY, useJitter = true, isRetryable = (err) => isRetryableError(err instanceof Error ? err.message : String(err)), } = options;
+    let lastError;
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastError = err;
+            if (attempt === maxRetries) {
+                const msg = err instanceof Error ? err.message : String(err);
+                process.stderr.write(`Error: Command failed after ${maxRetries} attempts\n`);
+                process.stderr.write(`Last error: ${msg}\n`);
+                throw err;
+            }
+            if (!isRetryable(err)) {
+                const msg = err instanceof Error ? err.message : String(err);
+                process.stderr.write("Error: Non-retryable error detected, aborting retries\n");
+                process.stderr.write(`Error: ${msg}\n`);
+                throw err;
+            }
+            const delayMs = calculateBackoffDelay(attempt, baseDelaySeconds, maxDelaySeconds, useJitter);
+            const delaySeconds = Math.round(delayMs / 1000);
+            const msg = err instanceof Error ? err.message : String(err);
+            const exitCode = err && typeof err.code === "number" ? err.code : "?";
+            process.stderr.write(`⚠️  Attempt ${attempt}/${maxRetries} failed (exit code: ${exitCode})\n`);
+            process.stderr.write(`   Retrying in ${delaySeconds}s (with exponential backoff)...\n`);
+            if (msg.length > 0) {
+                process.stderr.write(`   Error: ${msg.slice(0, 200)}${msg.length > 200 ? "..." : ""}\n`);
+            }
+            await sleepMs(delayMs);
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=retry.js.map

package/dist/loop/retry.js.map

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

package/dist/parallel/lock.d.ts

@@ -0,0 +1,7 @@
+export declare function getLockDir(workspace: string): string;
+/**
+ * Acquire the parallel run lock. Returns a release function on success.
+ * Uses atomic mkdir; supports stale recovery (dead PID + age >= LOCK_STALE_MINUTES).
+ */
+export declare function acquireParallelLock(workspace: string): (() => void) | null;
+//# sourceMappingURL=lock.d.ts.map

package/dist/parallel/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/parallel/lock.ts"],"names":[],"mappings":"AAMA,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpD;AAmDD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAsD1E"}

package/dist/parallel/lock.js

@@ -0,0 +1,110 @@
+import { mkdirSync, rmSync, readFileSync, writeFileSync, existsSync } from "fs";
+import { join } from "path";
+const PARALLEL_LOCK_DIR = ".ralph/locks/parallel.lock";
+const LOCK_STALE_MINUTES = 45;
+export function getLockDir(workspace) {
+    return join(workspace, PARALLEL_LOCK_DIR);
+}
+function getLockPidPath(workspace) {
+    return join(getLockDir(workspace), "pid");
+}
+function getLockCreatedPath(workspace) {
+    return join(getLockDir(workspace), "created_at");
+}
+function isPidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function parseLockAgeMinutes(workspace) {
+    const path = getLockCreatedPath(workspace);
+    if (!existsSync(path))
+        return null;
+    try {
+        const iso = readFileSync(path, "utf-8").trim();
+        const lockEpoch = new Date(iso).getTime();
+        if (Number.isNaN(lockEpoch))
+            return null;
+        const ageMs = Date.now() - lockEpoch;
+        return Math.floor(ageMs / 60_000);
+    }
+    catch {
+        return null;
+    }
+}
+function tryRemoveStaleLock(workspace) {
+    const lockDir = getLockDir(workspace);
+    const pidPath = getLockPidPath(workspace);
+    if (!existsSync(pidPath)) {
+        rmSync(lockDir, { recursive: true, force: true });
+        return true;
+    }
+    const pid = parseInt(readFileSync(pidPath, "utf-8").trim(), 10);
+    if (Number.isNaN(pid) || isPidAlive(pid))
+        return false;
+    const age = parseLockAgeMinutes(workspace);
+    if (age === null || age < LOCK_STALE_MINUTES)
+        return false;
+    console.error(`🔓 Stale lock detected (PID ${pid} dead, age ${age}m >= ${LOCK_STALE_MINUTES}m). Recovering...`);
+    rmSync(lockDir, { recursive: true, force: true });
+    return true;
+}
+/**
+ * Acquire the parallel run lock. Returns a release function on success.
+ * Uses atomic mkdir; supports stale recovery (dead PID + age >= LOCK_STALE_MINUTES).
+ */
+export function acquireParallelLock(workspace) {
+    const lockDir = getLockDir(workspace);
+    const parent = join(lockDir, "..");
+    mkdirSync(parent, { recursive: true });
+    if (!existsSync(lockDir)) {
+        try {
+            mkdirSync(lockDir, { recursive: false });
+        }
+        catch {
+            // Race: someone else created it
+        }
+    }
+    if (!existsSync(lockDir)) {
+        console.error("❌ Failed to create lock dir:", lockDir);
+        return null;
+    }
+    const pidPath = getLockPidPath(workspace);
+    if (existsSync(pidPath)) {
+        if (tryRemoveStaleLock(workspace)) {
+            return acquireParallelLock(workspace);
+        }
+        const pid = readFileSync(pidPath, "utf-8").trim();
+        const created = readFileSync(getLockCreatedPath(workspace), "utf-8").trim();
+        console.error("❌ Parallel lock already held:", lockDir);
+        console.error("   pid:", pid);
+        console.error("   created_at:", created);
+        console.error("   If you're sure no run is active, delete: rm -rf", JSON.stringify(lockDir));
+        return null;
+    }
+    writeFileSync(pidPath, String(process.pid));
+    writeFileSync(getLockCreatedPath(workspace), new Date().toISOString());
+    const release = () => {
+        try {
+            rmSync(lockDir, { recursive: true, force: true });
+        }
+        catch {
+            // ignore
+        }
+    };
+    const onExit = () => {
+        release();
+        process.off("exit", onExit);
+        process.off("SIGINT", onExit);
+        process.off("SIGTERM", onExit);
+    };
+    process.on("exit", onExit);
+    process.on("SIGINT", onExit);
+    process.on("SIGTERM", onExit);
+    return release;
+}
+//# sourceMappingURL=lock.js.map

package/dist/parallel/lock.js.map

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

package/dist/parallel/merge.d.ts

@@ -0,0 +1,5 @@
+export declare function getConflictedFiles(workspace: string): string[];
+export type MergeResult = "success" | "conflict" | "error";
+export declare function mergeAgentBranch(workspace: string, branch: string, targetBranch: string): MergeResult;
+export declare function abortMerge(workspace: string): void;
+//# sourceMappingURL=merge.d.ts.map

package/dist/parallel/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../src/parallel/merge.ts"],"names":[],"mappings":"AAGA,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAU9D;AAED,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;AAE3D,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GACnB,WAAW,CAkBb;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAMlD"}

package/dist/parallel/merge.js

@@ -0,0 +1,39 @@
+import { execSync } from "child_process";
+export function getConflictedFiles(workspace) {
+    try {
+        const out = execSync("git diff --name-only --diff-filter=U", {
+            cwd: workspace,
+            encoding: "utf-8",
+        });
+        return out.trim() ? out.trim().split("\n") : [];
+    }
+    catch {
+        return [];
+    }
+}
+export function mergeAgentBranch(workspace, branch, targetBranch) {
+    try {
+        execSync(`git checkout "${targetBranch}"`, { cwd: workspace, stdio: "pipe" });
+    }
+    catch {
+        return "error";
+    }
+    try {
+        const msg = `Merge ${branch} into ${targetBranch}`.replace(/"/g, '\\"');
+        execSync(`git -c user.name=ralph-parallel -c user.email=ralph-parallel@localhost merge --no-ff -m "${msg}" "${branch}"`, { cwd: workspace, stdio: "pipe" });
+        return "success";
+    }
+    catch {
+        const conflicts = getConflictedFiles(workspace);
+        return conflicts.length > 0 ? "conflict" : "error";
+    }
+}
+export function abortMerge(workspace) {
+    try {
+        execSync("git merge --abort", { cwd: workspace, stdio: "pipe" });
+    }
+    catch {
+        // ignore
+    }
+}
+//# sourceMappingURL=merge.js.map

package/dist/parallel/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../src/parallel/merge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,QAAQ,CAAC,sCAAsC,EAAE;YAC3D,GAAG,EAAE,SAAS;YACd,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAID,MAAM,UAAU,gBAAgB,CAC9B,SAAiB,EACjB,MAAc,EACd,YAAoB;IAEpB,IAAI,CAAC;QACH,QAAQ,CAAC,iBAAiB,YAAY,GAAG,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAChF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,SAAS,MAAM,SAAS,YAAY,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACxE,QAAQ,CACN,4FAA4F,GAAG,MAAM,MAAM,GAAG,EAC9G,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAClC,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,SAAS,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAChD,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC;IACrD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,SAAiB;IAC1C,IAAI,CAAC;QACH,QAAQ,CAAC,mBAAmB,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;AACH,CAAC"}

package/dist/parallel/run.d.ts

@@ -0,0 +1,18 @@
+export interface RunAgentResult {
+    status: "done" | "failed";
+    outputStatus: "success" | "no_commits" | "error";
+}
+export interface RunParallelOptions {
+    maxParallel: number;
+    model: string;
+    baseBranch?: string;
+    integrationBranch?: string;
+    skipMerge?: boolean;
+    createPr?: boolean;
+    taskFilePath?: string;
+}
+export declare function runParallelTasks(workspace: string, options: RunParallelOptions): Promise<{
+    success: boolean;
+    mergedCount: number;
+}>;
+//# sourceMappingURL=run.d.ts.map

package/dist/parallel/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/parallel/run.ts"],"names":[],"mappings":"AA0EA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B,YAAY,EAAE,SAAS,GAAG,YAAY,GAAG,OAAO,CAAC;CAClD;AAsED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CA0XpD"}