ralph-cursor 0.1.0

package/dist/stream-parser/index.js

@@ -0,0 +1,248 @@
+import { appendFileSync, mkdirSync, existsSync } from "fs";
+import { join } from "path";
+const PROMPT_CHARS_DEFAULT = 3000;
+const DEFAULT_WARN = 70_000;
+const DEFAULT_ROTATE = 80_000;
+const THRASH_WINDOW_MS = 10 * 60 * 1000; // 10 min
+const THRASH_COUNT = 5;
+const SHELL_FAIL_COUNT = 3;
+/** Retryable error patterns (rate limit, network, 5xx). */
+const RETRYABLE_PATTERNS = [
+    /rate\s*limit|rate_limit|rate-limit/i,
+    /quota\s*exceeded|quota\s*limit|hit\s*your\s*limit/i,
+    /too\s*many\s*requests|429|http\s*429/i,
+    /timeout|timed\s*out|connection\s*timeout/i,
+    /network\s*error|network\s*unavailable/i,
+    /connection\s*refused|connection\s*reset|econnreset/i,
+    /connection\s*closed|connection\s*failed|etimedout|enotfound/i,
+    /service\s*unavailable|503/i,
+    /bad\s*gateway|502/i,
+    /gateway\s*timeout|504/i,
+    /overloaded|server\s*busy|try\s*again/i,
+];
+/** Returns true if the error message matches retryable patterns (rate limit, timeout, 5xx). */
+export function isRetryableError(msg) {
+    return RETRYABLE_PATTERNS.some((re) => re.test(msg));
+}
+export function createStreamParser(workspace, options = {}) {
+    const ralphDir = join(workspace, ".ralph");
+    const warnThreshold = options.warnThreshold ?? DEFAULT_WARN;
+    const rotateThreshold = options.rotateThreshold ?? DEFAULT_ROTATE;
+    const promptChars = options.promptChars ?? PROMPT_CHARS_DEFAULT;
+    let bytesRead = 0;
+    let bytesWritten = 0;
+    let assistantChars = 0;
+    let shellOutputChars = 0;
+    let warnSent = false;
+    const signalCbs = [];
+    const shellFailures = new Map();
+    const fileWrites = [];
+    if (!existsSync(ralphDir)) {
+        mkdirSync(ralphDir, { recursive: true });
+    }
+    function emit(signal) {
+        signalCbs.forEach((cb) => cb(signal));
+    }
+    function getTokens() {
+        const total = promptChars + bytesRead + bytesWritten + assistantChars + shellOutputChars;
+        return Math.floor(total / 4);
+    }
+    /** Health emoji by token % (integer division). */
+    function getHealthEmoji(tokens) {
+        const pct = Math.floor((tokens * 100) / rotateThreshold);
+        if (pct < 60)
+            return "🟢";
+        if (pct < 80)
+            return "🟡";
+        return "🔴";
+    }
+    function logActivity(message) {
+        const ts = new Date().toLocaleTimeString("en-GB", { hour12: false });
+        const tokens = getTokens();
+        const emoji = getHealthEmoji(tokens);
+        appendFileSync(join(ralphDir, "activity.log"), `[${ts}] ${emoji} ${message}\n`);
+    }
+    function logError(message) {
+        const ts = new Date().toLocaleTimeString("en-GB", { hour12: false });
+        appendFileSync(join(ralphDir, "errors.log"), `[${ts}] ${message}\n`);
+    }
+    function checkThresholds() {
+        const tokens = getTokens();
+        if (tokens >= rotateThreshold) {
+            logActivity(`ROTATE: Token threshold reached (${tokens} >= ${rotateThreshold})`);
+            emit("ROTATE");
+            return;
+        }
+        if (tokens >= warnThreshold && !warnSent) {
+            warnSent = true;
+            logActivity(`WARN: Approaching token limit (${tokens} >= ${warnThreshold})`);
+            emit("WARN");
+        }
+    }
+    function startSession() {
+        const sep = "═══════════════════════════════════════════════════════════════";
+        appendFileSync(join(ralphDir, "activity.log"), `\n${sep}\nRalph Session Started: ${new Date().toString()}\n${sep}\n`);
+    }
+    function logTokenStatus() {
+        const tokens = getTokens();
+        const pct = Math.floor((tokens * 100) / rotateThreshold);
+        const emoji = getHealthEmoji(tokens);
+        const ts = new Date().toLocaleTimeString("en-GB", { hour12: false });
+        let statusMsg = `TOKENS: ${tokens} / ${rotateThreshold} (${pct}%)`;
+        if (pct >= 90)
+            statusMsg += " - rotation imminent";
+        else if (pct >= 72)
+            statusMsg += " - approaching limit";
+        const breakdown = `[read:${Math.floor(bytesRead / 1024)}KB write:${Math.floor(bytesWritten / 1024)}KB assist:${Math.floor(assistantChars / 1024)}KB shell:${Math.floor(shellOutputChars / 1024)}KB]`;
+        appendFileSync(join(ralphDir, "activity.log"), `[${ts}] ${emoji} ${statusMsg} ${breakdown}\n`);
+    }
+    function trackFileWrite(path) {
+        const now = Date.now();
+        fileWrites.push({ ts: now, path });
+        const cutoff = now - THRASH_WINDOW_MS;
+        const recent = fileWrites.filter((w) => w.ts >= cutoff && w.path === path);
+        if (recent.length >= THRASH_COUNT) {
+            logError(`⚠️ THRASHING: ${path} written ${recent.length}x in 10 min`);
+            emit("GUTTER");
+        }
+    }
+    function trackShellFailure(cmd, exitCode) {
+        const count = (shellFailures.get(cmd) ?? 0) + 1;
+        shellFailures.set(cmd, count);
+        logError(`SHELL FAIL: ${cmd} → exit ${exitCode} (attempt ${count})`);
+        if (count >= SHELL_FAIL_COUNT) {
+            logError(`⚠️ GUTTER: same command failed ${count}x`);
+            emit("GUTTER");
+        }
+    }
+    function isRetryableError(msg) {
+        return RETRYABLE_PATTERNS.some((re) => re.test(msg));
+    }
+    function processLine(line) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            return;
+        let obj;
+        try {
+            obj = JSON.parse(trimmed);
+        }
+        catch {
+            return;
+        }
+        const rec = obj;
+        const type = rec.type;
+        const subtype = rec.subtype;
+        switch (type) {
+            case "system":
+                if (subtype === "init") {
+                    const model = rec.model ?? "unknown";
+                    logActivity(`SESSION START: model=${model}`);
+                }
+                break;
+            case "error": {
+                const err = rec.error;
+                const data = err?.data;
+                const msg = data?.message ??
+                    err?.message ??
+                    rec.message ??
+                    "Unknown error";
+                const msgStr = String(msg);
+                logError(`API ERROR: ${msgStr}`);
+                logActivity(`❌ API ERROR: ${msgStr}`);
+                if (isRetryableError(msgStr)) {
+                    logError("⚠️ RETRYABLE: Error may be transient (rate limit/network)");
+                    emit("DEFER");
+                }
+                else {
+                    logError("🚨 NON-RETRYABLE: Error requires attention");
+                    emit("GUTTER");
+                }
+                break;
+            }
+            case "assistant": {
+                const msg = rec.message;
+                const text = msg?.content?.[0]?.text ?? "";
+                if (text) {
+                    assistantChars += text.length;
+                    if (text.includes("<ralph>COMPLETE</ralph>")) {
+                        logActivity("✅ Agent signaled COMPLETE");
+                        emit("COMPLETE");
+                    }
+                    if (text.includes("<ralph>GUTTER</ralph>")) {
+                        logActivity("🚨 Agent signaled GUTTER (stuck)");
+                        emit("GUTTER");
+                    }
+                }
+                break;
+            }
+            case "tool_call":
+                if (subtype === "started") {
+                    // just count if needed
+                }
+                else if (subtype === "completed") {
+                    const tc = rec.tool_call;
+                    const readTool = tc?.readToolCall;
+                    if (readTool?.result && readTool.result.success) {
+                        const success = readTool.result.success;
+                        const path = readTool.args?.path ?? "unknown";
+                        const contentSize = success.contentSize ?? 0;
+                        const lines = success.totalLines ?? 0;
+                        const bytes = contentSize > 0 ? contentSize : lines * 100;
+                        bytesRead += bytes;
+                        const kb = (bytes / 1024).toFixed(1);
+                        logActivity(`READ ${path} (${lines} lines, ~${kb}KB)`);
+                    }
+                    const writeTool = tc?.writeToolCall;
+                    if (writeTool?.result && writeTool.result.success) {
+                        const success = writeTool.result.success;
+                        const path = writeTool.args?.path ?? "unknown";
+                        const bytes = success.fileSize ?? 0;
+                        const lines = success.linesCreated ?? 0;
+                        bytesWritten += bytes;
+                        trackFileWrite(path);
+                        const kb = (bytes / 1024).toFixed(1);
+                        logActivity(`WRITE ${path} (${lines} lines, ${kb}KB)`);
+                    }
+                    const shellTool = tc?.shellToolCall;
+                    if (shellTool?.result) {
+                        const result = shellTool.result;
+                        const cmd = shellTool.args?.command ?? "unknown";
+                        const exitCode = result.exitCode ?? 0;
+                        const stdout = result.stdout ?? "";
+                        const stderr = result.stderr ?? "";
+                        shellOutputChars += stdout.length + stderr.length;
+                        if (exitCode === 0) {
+                            if (stdout.length + stderr.length > 1024) {
+                                logActivity(`SHELL ${cmd} → exit 0 (${stdout.length + stderr.length} chars output)`);
+                            }
+                            else {
+                                logActivity(`SHELL ${cmd} → exit 0`);
+                            }
+                        }
+                        else {
+                            logActivity(`SHELL ${cmd} → exit ${exitCode}`);
+                            trackShellFailure(cmd, exitCode);
+                        }
+                    }
+                    checkThresholds();
+                }
+                break;
+            case "result": {
+                const duration = rec.duration_ms ?? 0;
+                const tokens = getTokens();
+                logActivity(`SESSION END: ${duration}ms, ~${tokens} tokens used`);
+                break;
+            }
+        }
+    }
+    return {
+        processLine,
+        onSignal(cb) {
+            signalCbs.push(cb);
+        },
+        getTokens,
+        startSession,
+        logTokenStatus,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/stream-parser/index.js.map

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

package/dist/task-parser/index.d.ts

@@ -0,0 +1,21 @@
+export declare function getTaskFilePath(workspace: string, taskFile?: string): string;
+export interface TaskItem {
+    id: string;
+    status: "pending" | "completed";
+    description: string;
+    group?: number;
+}
+export declare function parseTasks(workspace: string, taskFilePath?: string): void;
+export declare function getProgress(workspace: string, taskFilePath?: string): string;
+export declare function countRemaining(workspace: string, taskFilePath?: string): number;
+export declare function getNextTask(workspace: string, taskFilePath?: string): TaskItem | null;
+export declare function getAllTasks(workspace: string, taskFilePath?: string): TaskItem[];
+/** Pending tasks in a given group (for parallel mode). */
+export declare function getTasksByGroup(workspace: string, groupId: number, taskFilePath?: string): TaskItem[];
+/** Unique group IDs that have at least one pending task, sorted numerically. */
+export declare function getPendingGroups(workspace: string, taskFilePath?: string): number[];
+export declare function checkTaskComplete(workspace: string, taskFilePath?: string): string;
+export declare function getTaskById(workspace: string, taskId: string, taskFilePath?: string): TaskItem | null;
+export declare function markTaskComplete(workspace: string, taskId: string, taskFilePath?: string): void;
+export declare function markTaskIncomplete(workspace: string, taskId: string, taskFilePath?: string): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/task-parser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/task-parser/index.ts"],"names":[],"mappings":"AAoBA,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAK5E;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqCD,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CA8BzE;AAmBD,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAI5E;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAG/E;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAGrF;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,EAAE,CAEhF;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,QAAQ,EAAE,CAIZ;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAQnF;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAMlF;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAGrG;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAiB/F;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAiBjG"}

package/dist/task-parser/index.js

@@ -0,0 +1,195 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync, statSync, unlinkSync } from "fs";
+import { join, isAbsolute } from "path";
+const TASK_CACHE_FILE = "tasks.yaml";
+const TASK_MTIME_FILE = "tasks.mtime";
+const DEFAULT_GROUP_FALLBACK = 999999;
+/** Default group for tasks without <!-- group: N -->. Override via DEFAULT_GROUP or RALPH_DEFAULT_GROUP env. */
+function getDefaultGroup() {
+    const env = process.env.RALPH_DEFAULT_GROUP ?? process.env.DEFAULT_GROUP;
+    if (env === undefined || env === "")
+        return DEFAULT_GROUP_FALLBACK;
+    const n = parseInt(env, 10);
+    return Number.isNaN(n) ? DEFAULT_GROUP_FALLBACK : n;
+}
+const CHECKBOX_REGEX = /^\s*([-*]|\d+\.)\s+\[(x|X| )]\s+(.*)$/;
+const GROUP_REGEX = /<!--\s*group:\s*(\d+)\s*-->/;
+export function getTaskFilePath(workspace, taskFile) {
+    if (taskFile)
+        return isAbsolute(taskFile) ? taskFile : join(workspace, taskFile);
+    const envPath = process.env.RALPH_TASK_FILE;
+    if (envPath)
+        return envPath;
+    return join(workspace, "RALPH_TASK.md");
+}
+/** File mtime in seconds for cache invalidation. */
+function getFileMtime(filePath) {
+    try {
+        return Math.floor(statSync(filePath).mtimeMs / 1000);
+    }
+    catch {
+        return 0;
+    }
+}
+function parseTaskFileContent(content) {
+    const lines = content.replace(/\r\n/g, "\n").split("\n");
+    const tasks = [];
+    lines.forEach((line, i) => {
+        const lineNum = i + 1;
+        const m = line.match(CHECKBOX_REGEX);
+        if (!m)
+            return;
+        const statusChar = m[2];
+        let description = m[3];
+        const groupMatch = line.match(GROUP_REGEX);
+        const group = groupMatch ? parseInt(groupMatch[1], 10) : getDefaultGroup();
+        description = description.replace(/\s*<!--\s*group:\s*\d+\s*-->\s*/g, "").trim();
+        const status = statusChar === "x" || statusChar === "X" ? "completed" : "pending";
+        tasks.push({
+            id: `line_${lineNum}`,
+            status,
+            description,
+            group,
+        });
+    });
+    return tasks;
+}
+const taskCache = new Map();
+export function parseTasks(workspace, taskFilePath) {
+    const path = getTaskFilePath(workspace, taskFilePath);
+    if (!existsSync(path)) {
+        throw new Error(`No task file found at ${path}`);
+    }
+    const ralphDir = join(workspace, ".ralph");
+    const cachePath = join(ralphDir, TASK_CACHE_FILE);
+    const mtimePath = join(ralphDir, TASK_MTIME_FILE);
+    const currentMtime = getFileMtime(path);
+    if (existsSync(cachePath) && existsSync(mtimePath)) {
+        const cachedMtime = Number(readFileSync(mtimePath, "utf-8").trim());
+        if (cachedMtime === currentMtime && taskCache.has(workspace)) {
+            return;
+        }
+    }
+    const content = readFileSync(path, "utf-8");
+    const tasks = parseTaskFileContent(content);
+    if (!existsSync(ralphDir)) {
+        mkdirSync(ralphDir, { recursive: true });
+    }
+    const mtime = currentMtime;
+    writeFileSync(mtimePath, String(mtime));
+    const defaultGroup = getDefaultGroup();
+    let yaml = "# Ralph Task Cache\nsource_file: RALPH_TASK.md\nsource_mtime: " + mtime + "\ntasks:\n";
+    tasks.forEach((t) => {
+        const desc = t.description.includes(":") || t.description.includes('"') ? `"${t.description.replace(/"/g, '\\"')}"` : t.description;
+        yaml += `  - id: ${t.id}\n    status: ${t.status}\n    parallel_group: ${t.group ?? defaultGroup}\n    description: ${desc}\n`;
+    });
+    writeFileSync(cachePath, yaml);
+    taskCache.set(workspace, tasks);
+}
+function getTasks(workspace, taskFilePath) {
+    const path = getTaskFilePath(workspace, taskFilePath);
+    if (!existsSync(path))
+        return [];
+    const ralphDir = join(workspace, ".ralph");
+    const cachePath = join(ralphDir, TASK_CACHE_FILE);
+    const mtimePath = join(ralphDir, TASK_MTIME_FILE);
+    const currentMtime = getFileMtime(path);
+    if (existsSync(cachePath) && existsSync(mtimePath)) {
+        const cachedMtime = Number(readFileSync(mtimePath, "utf-8").trim());
+        if (cachedMtime === currentMtime && taskCache.has(workspace)) {
+            return taskCache.get(workspace);
+        }
+    }
+    parseTasks(workspace, taskFilePath);
+    return taskCache.get(workspace);
+}
+export function getProgress(workspace, taskFilePath) {
+    const tasks = getTasks(workspace, taskFilePath);
+    const completed = tasks.filter((t) => t.status === "completed").length;
+    return `${completed}:${tasks.length}`;
+}
+export function countRemaining(workspace, taskFilePath) {
+    const tasks = getTasks(workspace, taskFilePath);
+    return tasks.filter((t) => t.status === "pending").length;
+}
+export function getNextTask(workspace, taskFilePath) {
+    const tasks = getTasks(workspace, taskFilePath);
+    return tasks.find((t) => t.status === "pending") ?? null;
+}
+export function getAllTasks(workspace, taskFilePath) {
+    return getTasks(workspace, taskFilePath);
+}
+/** Pending tasks in a given group (for parallel mode). */
+export function getTasksByGroup(workspace, groupId, taskFilePath) {
+    const tasks = getTasks(workspace, taskFilePath);
+    const defaultGroup = getDefaultGroup();
+    return tasks.filter((t) => t.status === "pending" && (t.group ?? defaultGroup) === groupId);
+}
+/** Unique group IDs that have at least one pending task, sorted numerically. */
+export function getPendingGroups(workspace, taskFilePath) {
+    const tasks = getTasks(workspace, taskFilePath);
+    const defaultGroup = getDefaultGroup();
+    const pendingGroups = new Set();
+    for (const t of tasks) {
+        if (t.status === "pending")
+            pendingGroups.add(t.group ?? defaultGroup);
+    }
+    return [...pendingGroups].sort((a, b) => a - b);
+}
+export function checkTaskComplete(workspace, taskFilePath) {
+    const path = getTaskFilePath(workspace, taskFilePath);
+    if (!existsSync(path))
+        return "NO_TASK_FILE";
+    const remaining = countRemaining(workspace, taskFilePath);
+    if (remaining === 0)
+        return "COMPLETE";
+    return `INCOMPLETE:${remaining}`;
+}
+export function getTaskById(workspace, taskId, taskFilePath) {
+    const tasks = getTasks(workspace, taskFilePath);
+    return tasks.find((t) => t.id === taskId) ?? null;
+}
+export function markTaskComplete(workspace, taskId, taskFilePath) {
+    const path = getTaskFilePath(workspace, taskFilePath);
+    const content = readFileSync(path, "utf-8");
+    const lineMatch = taskId.match(/^line_(\d+)$/);
+    if (!lineMatch)
+        throw new Error(`Invalid task ID: ${taskId}`);
+    const lineNum = parseInt(lineMatch[1], 10);
+    const lines = content.split("\n");
+    const idx = lineNum - 1;
+    if (idx < 0 || idx >= lines.length)
+        throw new Error(`Line ${lineNum} out of range`);
+    const line = lines[idx];
+    const newLine = line.replace(/\[\s\]/, "[x]").replace(/\[ \]/, "[x]");
+    if (newLine === line)
+        return;
+    lines[idx] = newLine;
+    writeFileSync(path, lines.join("\n"));
+    taskCache.delete(workspace);
+    const mtimePath = join(workspace, ".ralph", TASK_MTIME_FILE);
+    if (existsSync(mtimePath))
+        unlinkSync(mtimePath);
+}
+export function markTaskIncomplete(workspace, taskId, taskFilePath) {
+    const path = getTaskFilePath(workspace, taskFilePath);
+    const content = readFileSync(path, "utf-8");
+    const lineMatch = taskId.match(/^line_(\d+)$/);
+    if (!lineMatch)
+        throw new Error(`Invalid task ID: ${taskId}`);
+    const lineNum = parseInt(lineMatch[1], 10);
+    const lines = content.split("\n");
+    const idx = lineNum - 1;
+    if (idx < 0 || idx >= lines.length)
+        throw new Error(`Line ${lineNum} out of range`);
+    const line = lines[idx];
+    const newLine = line.replace(/\[[xX]\]/, "[ ]");
+    if (newLine === line)
+        return;
+    lines[idx] = newLine;
+    writeFileSync(path, lines.join("\n"));
+    taskCache.delete(workspace);
+    const mtimePath = join(workspace, ".ralph", TASK_MTIME_FILE);
+    if (existsSync(mtimePath))
+        unlinkSync(mtimePath);
+}
+//# sourceMappingURL=index.js.map

package/dist/task-parser/index.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "ralph-cursor",
+  "version": "0.1.0",
+  "description": "CLI for Ralph Wiggum autonomous development loop for Cursor",
+  "type": "module",
+  "bin": {
+    "ralph-cursor": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "ralph-cursor": "node dist/cli.js",
+    "test": "bun run build && vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "prepublishOnly": "bun run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "ralph",
+    "cursor",
+    "ai",
+    "autonomous"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@eslint/js": "^9.39.4",
+    "@types/node": "^22.10.0",
+    "eslint": "^9.39.4",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.56.1",
+    "vitest": "^2.1.0"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.7.0",
+    "commander": "^12.1.0"
+  }
+}