@neriros/ralphy 2.13.2 → 2.13.4

package/dist/cli/index.js

@@ -56407,7 +56407,7 @@ function log(msg) {
 // package.json
 var package_default = {
   name: "@neriros/ralphy",
-  version: "2.13.2",
+  version: "2.13.4",
   description: "An iterative AI task execution framework. Orchestrates multi-phase autonomous work using Claude or Codex engines.",
   keywords: [
     "agent",
@@ -56653,8 +56653,6 @@ async function parseArgs(argv) {
   let expectMaxRuntime = false;
   let expectMaxFailures = false;
   let expectMaxIterations = false;
-  let expectTimeout = false;
-  let expectPushInterval = false;
   let expectLinearTeam = false;
   let expectLinearAssignee = false;
   let expectPollInterval = false;
@@ -56717,14 +56715,6 @@ async function parseArgs(argv) {
       expectMaxIterations = false;
       continue;
     }
-    if (expectTimeout) {
-      expectTimeout = false;
-      continue;
-    }
-    if (expectPushInterval) {
-      expectPushInterval = false;
-      continue;
-    }
     if (expectLinearTeam) {
       result2.linearTeam = arg;
       expectLinearTeam = false;
@@ -56794,12 +56784,6 @@ async function parseArgs(argv) {
       case "--max-iterations":
         expectMaxIterations = true;
         break;
-      case "--timeout":
-        expectTimeout = true;
-        break;
-      case "--push-interval":
-        expectPushInterval = true;
-        break;
       case "--unlimited":
         result2.maxIterations = 0;
         break;
@@ -69479,6 +69463,10 @@ var HOST = "https://eu.i.posthog.com";
 var enabled = process.env["RALPH_TELEMETRY"] !== "0";
 var client = null;
 var distinctId = "anonymous";
+var defaultProps = {};
+function setDefaultProperties(props) {
+  defaultProps = { ...defaultProps, ...props };
+}
 async function init() {
   if (!enabled)
     return;
@@ -69497,7 +69485,8 @@ async function init() {
   });
 }
 function capture(event, properties) {
-  client?.capture({ distinctId, event, ...properties !== undefined && { properties } });
+  const merged = { ...defaultProps, ...properties };
+  client?.capture({ distinctId, event, properties: merged });
 }
 async function shutdown() {
   if (client)
@@ -69889,10 +69878,16 @@ function useLoop(opts) {
             const result2 = `failed:exit-${engineResult.exitCode}`;
             updateStateIteration(stateDir, result2, iterStart, opts.engine, opts.model, engineResult.usage);
             if (failure.shouldStop || engineResult.rateLimited) {
+              capture("engine_rate_limited", { exit_code: engineResult.exitCode, iteration: iter });
               finalStopReason = "rateLimited";
               setStopReason("rateLimited");
               break;
             }
+            capture("iteration_failed", {
+              exit_code: engineResult.exitCode,
+              iteration: iter,
+              consecutive_failures: consFailures + 1
+            });
             if (result2 === lastResult) {
               consFailures++;
             } else {
@@ -69921,7 +69916,9 @@ function useLoop(opts) {
             await sleep(opts.delay);
           }
         } catch (err) {
+          const message = err instanceof Error ? err.message : String(err);
           addInfo(`Engine error: ${err}`);
+          capture("engine_error", { iteration: iter, error: message });
           break;
         }
       }
@@ -70206,23 +70203,145 @@ var RalphyConfigSchema = exports_external.object({
   model: "opus",
   linear: { postComments: true, updateEveryIterations: 10, indicators: {} }
 });
+function stripJsonComments(text) {
+  return text.replace(/\/\/[^\n]*/g, "");
+}
 async function loadRalphyConfig(projectRoot) {
   const path = join10(projectRoot, "ralphy.config.json");
   const file = Bun.file(path);
   if (!await file.exists()) {
     return RalphyConfigSchema.parse({});
   }
-  const raw = await file.json();
+  const text = await file.text();
+  const raw = JSON.parse(stripJsonComments(text));
   return RalphyConfigSchema.parse(raw);
 }
+var DEFAULT_CONFIG_TEMPLATE = `{
+  // How many tasks to run in parallel.
+  "concurrency": 1,
+
+  // Seconds between polls for new Linear issues (agent mode).
+  "pollIntervalSeconds": 60,
+
+  // Maximum iterations per task. 0 = unlimited.
+  "maxIterationsPerTask": 0,
+
+  // Maximum cost in USD per task. 0 = unlimited.
+  "maxCostUsdPerTask": 0,
+
+  // Maximum wall-clock minutes per task. 0 = unlimited.
+  "maxRuntimeMinutesPerTask": 0,
+
+  // Stop a task after this many consecutive identical failures.
+  "maxConsecutiveFailuresPerTask": 5,
+
+  // Seconds to wait between loop iterations (throttle).
+  "iterationDelaySeconds": 0,
+
+  // Log the raw engine stream to stdout.
+  "logRawStream": false,
+
+  // Pass --verbose to the ralph task sub-process.
+  "taskVerbose": false,
+
+  // Run each task in an isolated git worktree.
+  "useWorktree": false,
+
+  // Delete the worktree after a successful task.
+  "cleanupWorktreeOnSuccess": false,
+
+  // Shell script to run inside the worktree before the task starts.
+  // "setupScript": "bun install",
+
+  // Shell script to run inside the worktree after the task finishes.
+  // "teardownScript": "bun run lint",
+
+  // Extra text appended to every task prompt.
+  // "appendPrompt": "Always run tests before finishing.",
+
+  // Open a pull request after a task succeeds.
+  "createPrOnSuccess": false,
+
+  // Base branch for pull requests.
+  "prBaseBranch": "main",
+
+  // Let the agent attempt to fix CI failures after a PR is created.
+  "fixCiOnFailure": false,
+
+  // Maximum number of CI-fix attempts per task.
+  "maxCiFixAttempts": 5,
+
+  // Seconds between CI status polls.
+  "ciPollIntervalSeconds": 30,
+
+  // Underlying engine: "claude" or "codex".
+  "engine": "claude",
+
+  // Model tier: "haiku", "sonnet", or "opus".
+  "model": "opus",
+
+  "linear": {
+    // Linear team key to filter issues (e.g. "ENG"). Omit to match all teams.
+    // "team": "ENG",
+
+    // Linear user to filter issues. Can be an email address or user ID.
+    // Omit to match issues regardless of assignee.
+    // "assignee": "dev@example.com",
+
+    // Post progress comments on the Linear issue while a task is running.
+    "postComments": true,
+
+    // Post a progress update every N iterations. 0 disables. Requires postComments.
+    "updateEveryIterations": 10,
+
+    // ---------------------------------------------------------------------------
+    // Linear indicators \u2014 COMMENTED OUT BY DEFAULT
+    //
+    // Indicators map Ralph lifecycle events to Linear labels/statuses.
+    // WARNING: Activating indicators will query AND mutate your Linear workspace.
+    // Labels or statuses that do not already exist may be created automatically.
+    // Review every value against your actual Linear workspace before enabling,
+    // then replace the empty object below with the full indicators block.
+    //
+    // To activate, replace "indicators": {} with:
+    //
+    // "indicators": {
+    //   // Issues to pick up (any-of filter \u2014 Ralph will start working on these).
+    //   "getTodo": { "filter": [{ "type": "status", "value": "Todo" }] },
+    //
+    //   // Issues already in flight (resume after restart).
+    //   "getInProgress": { "filter": [{ "type": "label", "value": "ralph:in-progress" }] },
+    //
+    //   // Issues whose PR has a merge conflict (Ralph will attempt a re-fix run).
+    //   "getConflicted": { "filter": [{ "type": "label", "value": "ralph:conflict" }] },
+    //
+    //   // Applied when Ralph picks up an issue.
+    //   "setInProgress": { "type": "label", "value": "ralph:in-progress" },
+    //
+    //   // Applied on clean success.
+    //   "setDone": { "type": "status", "value": "In Review" },
+    //
+    //   // Applied when the task exits with an error (quarantine signal).
+    //   "setError": { "type": "label", "value": "ralph:error" },
+    //
+    //   // Applied when a PR merge conflict is detected.
+    //   "setConflicted": { "type": "label", "value": "ralph:conflict" },
+    //
+    //   // Label-only marker(s) removed once the conflict is fixed.
+    //   // Note: only label-typed markers are valid here \u2014 status removal is not supported.
+    //   "clearConflicted": { "type": "label", "value": "ralph:conflict" }
+    // }
+    // ---------------------------------------------------------------------------
+    "indicators": {}
+  }
+}
+`;
 async function ensureRalphyConfig(projectRoot) {
   const path = join10(projectRoot, "ralphy.config.json");
   const file = Bun.file(path);
   if (await file.exists())
     return path;
-  const defaults2 = RalphyConfigSchema.parse({});
-  await Bun.write(path, JSON.stringify(defaults2, null, 2) + `
-`);
+  await Bun.write(path, DEFAULT_CONFIG_TEMPLATE);
   return path;
 }
 
@@ -70469,6 +70588,7 @@ class AgentCoordinator {
       ]);
     } catch (err) {
       this.deps.onLog(`! Linear poll failed: ${err.message}`, "red");
+      capture("agent_linear_poll_failed", { error: err.message });
       return { found: 0, added: 0 };
     }
     const queuedIds = new Set(this.queue.map((q) => q.issue.id));
@@ -70593,10 +70713,16 @@ class AgentCoordinator {
       const alreadyNotified = this.conflictNotified.has(issue.id);
       if (alreadyNotified)
         continue;
+      capture("agent_conflict_detected", { issue_identifier: issue.identifier });
       try {
         await this.deps.applyIndicator(issue, this.opts.setConflicted);
       } catch (err) {
         this.deps.onLog(`! Linear setConflicted failed for ${issue.identifier}: ${err.message}`, "red");
+        capture("agent_indicator_failed", {
+          indicator: "setConflicted",
+          issue_identifier: issue.identifier,
+          error: err.message
+        });
         continue;
       }
       this.conflictNotified.add(issue.id);
@@ -70627,6 +70753,11 @@ class AgentCoordinator {
     } catch (err) {
       this.pendingIds.delete(issue.id);
       this.deps.onLog(`! prepare(${mode}) failed for ${issue.identifier}: ${err.message}`, "red");
+      capture("agent_prepare_failed", {
+        spawn_mode: mode,
+        issue_identifier: issue.identifier,
+        error: err.message
+      });
       this.spawnNext();
       return;
     }
@@ -70639,6 +70770,11 @@ class AgentCoordinator {
         await this.deps.applyIndicator(issue, this.opts.setInProgress);
       } catch (err) {
         this.deps.onLog(`! Linear setInProgress failed for ${issue.identifier}: ${err.message}`, "yellow");
+        capture("agent_indicator_failed", {
+          indicator: "setInProgress",
+          issue_identifier: issue.identifier,
+          error: err.message
+        });
       }
     }
     if (mode === "fresh" && this.opts.postComments !== false) {
@@ -70670,6 +70806,10 @@ class AgentCoordinator {
     };
     this.workers.push(worker);
     this.pendingIds.delete(issue.id);
+    capture("agent_worker_spawned", {
+      spawn_mode: mode,
+      issue_identifier: issue.identifier
+    });
     this.deps.onWorkersChanged();
     handle.exited.then(async (code) => {
       const idx = this.workers.indexOf(worker);
@@ -70677,6 +70817,12 @@ class AgentCoordinator {
         this.workers.splice(idx, 1);
       const ok = code === 0;
       this.deps.onLog(`${ok ? "\u2713" : "\u2717"} ${issue.identifier} \u2192 ${prep.changeName} exited (code ${code})`, ok ? "green" : "red");
+      capture("agent_worker_exited", {
+        spawn_mode: mode,
+        issue_identifier: issue.identifier,
+        exit_code: code,
+        ok
+      });
       await this.notifyExited(issue, prep.changeName, code, mode);
       this.deps.onWorkersChanged();
       this.spawnNext();
@@ -70701,6 +70847,11 @@ class AgentCoordinator {
             await this.deps.removeIndicator(issue, this.opts.clearConflicted);
           } catch (err) {
             this.deps.onLog(`! Linear clearConflicted failed for ${issue.identifier}: ${err.message}`, "red");
+            capture("agent_indicator_failed", {
+              indicator: "clearConflicted",
+              issue_identifier: issue.identifier,
+              error: err.message
+            });
           }
         }
         this.conflictNotified.delete(issue.id);
@@ -70709,6 +70860,11 @@ class AgentCoordinator {
           await this.deps.applyIndicator(issue, this.opts.setDone);
         } catch (err) {
           this.deps.onLog(`! Linear setDone failed for ${issue.identifier}: ${err.message}`, "red");
+          capture("agent_indicator_failed", {
+            indicator: "setDone",
+            issue_identifier: issue.identifier,
+            error: err.message
+          });
         }
       }
     } else if (this.opts.setError) {
@@ -70716,6 +70872,11 @@ class AgentCoordinator {
         await this.deps.applyIndicator(issue, this.opts.setError);
       } catch (err) {
         this.deps.onLog(`! Linear setError failed for ${issue.identifier}: ${err.message}`, "red");
+        capture("agent_indicator_failed", {
+          indicator: "setError",
+          issue_identifier: issue.identifier,
+          error: err.message
+        });
       }
     }
   }
@@ -71892,17 +72053,6 @@ PR: ${prUrl}` : ""
     postComments: cfg.linear.postComments,
     commentEveryIterations: cfg.linear.updateEveryIterations
   });
-  (async () => {
-    const legacy = Bun.file(projectLayout(projectRoot).agentStateFile);
-    if (await legacy.exists()) {
-      onLog("  legacy .ralph/agent-state.json detected \u2014 Linear is now the source of truth; deleting", "gray");
-      try {
-        await legacy.delete();
-      } catch (err) {
-        onLog(`! failed to delete legacy agent-state.json: ${err.message}`, "yellow");
-      }
-    }
-  })();
   const filterDesc = describeIndicators(indicators, team, assignee);
   return {
     coord,
@@ -72457,6 +72607,7 @@ try {
   printHelp();
   process.exit(1);
 }
+setDefaultProperties({ mode: args.mode, engine: args.engine, model: args.model });
 capture("command_run", { mode: args.mode, engine: args.engine, model: args.model });
 try {
   const projectRoot = await findProjectRoot();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neriros/ralphy",
-  "version": "2.13.2",
+  "version": "2.13.4",
   "description": "An iterative AI task execution framework. Orchestrates multi-phase autonomous work using Claude or Codex engines.",
   "keywords": [
     "agent",