@neriros/ralphy 2.7.6 → 2.7.7

package/README.md

@@ -111,6 +111,8 @@ Defaults are written to `ralphy.config.json` on first run; CLI flags override co
   "setupScript": "bun install",
   "teardownScript": "git status",
   "appendPrompt": "Always run lint before committing.",
+  "createPrOnSuccess": true,
+  "prBaseBranch": "main",
 }
 ```
 
@@ -126,6 +128,8 @@ Use `setupScript` (run inside the worktree right after scaffolding) to install d
 
 **`updateEveryIterations`** (default `10`, `0` disables) posts a "🔄 Ralph progress update: iteration N" comment on the Linear issue every N task iterations. Requires `postComments: true`.
 
+**`createPrOnSuccess`** (or `--create-pr`) pushes the worker's branch and opens a GitHub PR via `gh` after a clean exit. Requires `--worktree` (the PR needs a branch to point at) and the `gh` CLI authenticated. The PR title is `<ID>: <title>`, the body links the Linear issue. If a PR already exists for the branch the existing URL is reported (idempotent for retries). `prBaseBranch` defaults to `main`.
+
 Failed workers (non-zero exit) are not marked processed, so they'll be retried on the next poll. SIGINT/SIGTERM cleanly stops polling and kills active workers. All Linear side effects are best-effort — failures log a warning but never block the task loop.
 
 ## CLI Options
@@ -149,18 +153,19 @@ Failed workers (non-zero exit) are not marked processed, so they'll be retried o
 
 ### Agent mode flags
 
-| Option                        | Description                                   |
-| ----------------------------- | --------------------------------------------- |
-| `--linear-team <key>`         | Linear team key (e.g. `ENG`)                  |
-| `--linear-assignee <id>`      | Filter by assignee (user id, email, or `me`)  |
-| `--linear-status <name>`      | Filter by status name (repeatable)            |
-| `--linear-label <name>`       | Filter by label name (repeatable, any-of)     |
-| `--poll-interval <s>`         | Seconds between Linear polls (default: 60)    |
-| `--concurrency <n>`           | Max concurrent task loops (default: 1)        |
-| `--worktree`                  | Run each task in its own git worktree         |
-| `--in-progress-status <name>` | Linear status to set when work starts         |
-| `--done-status <name>`        | Linear status to set on successful completion |
-| `--done-label <name>`         | Linear label to add on successful completion  |
+| Option                        | Description                                                           |
+| ----------------------------- | --------------------------------------------------------------------- |
+| `--linear-team <key>`         | Linear team key (e.g. `ENG`)                                          |
+| `--linear-assignee <id>`      | Filter by assignee (user id, email, or `me`)                          |
+| `--linear-status <name>`      | Filter by status name (repeatable)                                    |
+| `--linear-label <name>`       | Filter by label name (repeatable, any-of)                             |
+| `--poll-interval <s>`         | Seconds between Linear polls (default: 60)                            |
+| `--concurrency <n>`           | Max concurrent task loops (default: 1)                                |
+| `--worktree`                  | Run each task in its own git worktree                                 |
+| `--in-progress-status <name>` | Linear status to set when work starts                                 |
+| `--done-status <name>`        | Linear status to set on successful completion                         |
+| `--done-label <name>`         | Linear label to add on successful completion                          |
+| `--create-pr`                 | Push worker branch + open a GitHub PR on success (needs `--worktree`) |
 
 ## OpenSpec Flow
 

package/dist/cli/index.js

@@ -56156,6 +56156,7 @@ var HELP_TEXT = [
   "  --in-progress-status <name>  Linear status to set when work starts on an issue",
   "  --done-status <name>    Linear status to set when work completes successfully",
   "  --done-label <name>     Linear label to add when work completes successfully",
+  "  --create-pr             Push the worker branch and open a GitHub PR on success (needs --worktree)",
   "",
   "  --help, -h              Show this help message",
   "",
@@ -56195,7 +56196,8 @@ async function parseArgs(argv) {
     worktree: false,
     inProgressStatus: "",
     doneStatus: "",
-    doneLabel: ""
+    doneLabel: "",
+    createPr: false
   };
   let expectModel = false;
   let expectModelFlag = false;
@@ -56416,6 +56418,9 @@ async function parseArgs(argv) {
       case "--done-label":
         expectDoneLabel = true;
         break;
+      case "--create-pr":
+        result2.createPr = true;
+        break;
       default:
         if (VALID_MODES.has(arg)) {
           result2.mode = arg;
@@ -69845,6 +69850,8 @@ var RalphyConfigSchema = exports_external.object({
   setupScript: exports_external.string().optional(),
   teardownScript: exports_external.string().optional(),
   appendPrompt: exports_external.string().optional(),
+  createPrOnSuccess: exports_external.boolean().default(false),
+  prBaseBranch: exports_external.string().default("main"),
   engine: exports_external.enum(["claude", "codex"]).default("claude"),
   model: exports_external.enum(["haiku", "sonnet", "opus"]).default("opus"),
   linear: exports_external.object({
@@ -70133,6 +70140,53 @@ async function removeWorktree(projectRoot, cwd2, runner) {
   await runner.run(["worktree", "remove", "--force", cwd2], projectRoot);
 }
 
+// apps/cli/src/agent/pr.ts
+function defaultTitle(issue) {
+  return `${issue.identifier}: ${issue.title}`;
+}
+function defaultBody(issue, branch) {
+  return [
+    `Auto-generated by Ralph for ${issue.identifier}.`,
+    "",
+    `Source: ${issue.url}`,
+    `Branch: \`${branch}\``,
+    "",
+    issue.description?.trim() ? `## Description
+
+${issue.description.trim()}` : ""
+  ].filter(Boolean).join(`
+`);
+}
+async function createPullRequest(input, runner) {
+  const base2 = input.base ?? "main";
+  const log2 = await runner.run(["git", "log", "--oneline", `${base2}..HEAD`, "--no-merges"], input.cwd);
+  if (log2.stdout.trim() === "")
+    return null;
+  await runner.run(["git", "push", "-u", "origin", input.branch], input.cwd);
+  const existing = await runner.run([
+    "gh",
+    "pr",
+    "list",
+    "--head",
+    input.branch,
+    "--state",
+    "open",
+    "--json",
+    "url",
+    "--jq",
+    ".[0].url // empty"
+  ], input.cwd);
+  const existingUrl = existing.stdout.trim();
+  if (existingUrl)
+    return { url: existingUrl, created: false };
+  const title = defaultTitle(input.issue);
+  const body = defaultBody(input.issue, input.branch);
+  const created = await runner.run(["gh", "pr", "create", "--base", base2, "--title", title, "--body", body], input.cwd);
+  const url = created.stdout.trim().split(`
+`).pop() ?? "";
+  return { url, created: true };
+}
+
 // apps/cli/src/components/AgentMode.tsx
 var jsx_dev_runtime9 = __toESM(require_jsx_dev_runtime(), 1);
 import { join as join14 } from "path";
@@ -70151,6 +70205,21 @@ var bunGitRunner = {
     return { stdout, stderr };
   }
 };
+var bunCmdRunner = {
+  run: async (cmd, cwd2) => {
+    const proc = Bun.spawn({ cmd, cwd: cwd2, stdout: "pipe", stderr: "pipe" });
+    const stdout = await new Response(proc.stdout).text();
+    const stderr = await new Response(proc.stderr).text();
+    const code = await proc.exited;
+    if (code !== 0) {
+      const err = new Error(`command \`${cmd[0]}\` failed`);
+      err.stderr = stderr;
+      err.code = code;
+      throw err;
+    }
+    return { stdout, stderr };
+  }
+};
 var lineCounter = 0;
 function nextId() {
   lineCounter += 1;
@@ -70180,10 +70249,13 @@ function AgentMode({ args, projectRoot, statesDir, tasksDir }) {
         exit();
         return;
       }
+      const inProgressName = args.inProgressStatus || cfg.linear.inProgressStatus;
+      const baseStatuses = args.linearStatus.length ? args.linearStatus : cfg.linear.statuses;
+      const effectiveStatuses = inProgressName && baseStatuses.length > 0 && !baseStatuses.includes(inProgressName) ? [...baseStatuses, inProgressName] : baseStatuses;
       const filter2 = {
         team: args.linearTeam || cfg.linear.team,
         assignee: args.linearAssignee || cfg.linear.assignee,
-        statuses: args.linearStatus.length ? args.linearStatus : cfg.linear.statuses,
+        statuses: effectiveStatuses,
         labels: args.linearLabel.length ? args.linearLabel : cfg.linear.labels
       };
       const stateCache = new Map;
@@ -70192,6 +70264,8 @@ function AgentMode({ args, projectRoot, statesDir, tasksDir }) {
       const useWorktree = args.worktree || cfg.useWorktree;
       const cwdByChange = new Map;
       const statesDirByChange = new Map;
+      const branchByChange = new Map;
+      const issueByChange = new Map;
       async function runScript(label, cmd, cwd2) {
         appendLog(`  ${label}: ${cmd}`, "gray");
         const proc = Bun.spawn({
@@ -70220,11 +70294,13 @@ function AgentMode({ args, projectRoot, statesDir, tasksDir }) {
           let workerCwd = projectRoot;
           let scaffoldTasksDir = tasksDir;
           let scaffoldStatesDir = statesDir;
+          let workerBranch = null;
           const probeName = issue.identifier.toLowerCase();
           if (useWorktree) {
             try {
               const wt = await createWorktree(projectRoot, probeName, bunGitRunner);
               workerCwd = wt.cwd;
+              workerBranch = wt.branch;
               scaffoldTasksDir = join14(wt.cwd, "openspec", "changes");
               scaffoldStatesDir = join14(wt.cwd, ".ralph", "tasks");
               appendLog(`  ${issue.identifier} worktree: ${wt.cwd} (${wt.branch})`, "gray");
@@ -70236,6 +70312,9 @@ function AgentMode({ args, projectRoot, statesDir, tasksDir }) {
           const changeName = await scaffoldChangeForIssue(scaffoldTasksDir, scaffoldStatesDir, issue, comments, appendPrompt);
           cwdByChange.set(changeName, workerCwd);
           statesDirByChange.set(changeName, scaffoldStatesDir);
+          issueByChange.set(changeName, issue);
+          if (workerBranch)
+            branchByChange.set(changeName, workerBranch);
           if (cfg.setupScript) {
             await runScript("setup", cfg.setupScript, workerCwd);
           }
@@ -70265,14 +70344,33 @@ function AgentMode({ args, projectRoot, statesDir, tasksDir }) {
             stderr: "ignore",
             stdin: "ignore"
           });
+          const wantPr = args.createPr || cfg.createPrOnSuccess;
           const wrapped = proc.exited.then(async (code) => {
             if (cfg.teardownScript) {
               try {
                 await runScript("teardown", cfg.teardownScript, cwd2);
               } catch {}
             }
+            const ok = code === 0;
+            if (ok && wantPr) {
+              const branch = branchByChange.get(changeName);
+              const prIssue = issueByChange.get(changeName);
+              if (!branch || !prIssue) {
+                appendLog(`! createPr requested but no worktree branch is tracked for ${changeName} (use --worktree)`, "yellow");
+              } else {
+                try {
+                  const pr = await createPullRequest({ cwd: cwd2, branch, issue: prIssue, base: cfg.prBaseBranch }, bunCmdRunner);
+                  if (!pr) {
+                    appendLog(`  no commits ahead of ${cfg.prBaseBranch} \u2014 skipping PR`, "gray");
+                  } else {
+                    appendLog(`  ${pr.created ? "opened" : "found existing"} PR: ${pr.url}`, "green");
+                  }
+                } catch (err) {
+                  appendLog(`! PR create failed for ${changeName}: ${err.message}`, "red");
+                }
+              }
+            }
             if (useWorktree && cwd2 !== projectRoot) {
-              const ok = code === 0;
               if (ok && cfg.cleanupWorktreeOnSuccess) {
                 try {
                   await removeWorktree(projectRoot, cwd2, bunGitRunner);
@@ -70284,6 +70382,8 @@ function AgentMode({ args, projectRoot, statesDir, tasksDir }) {
             }
             cwdByChange.delete(changeName);
             statesDirByChange.delete(changeName);
+            branchByChange.delete(changeName);
+            issueByChange.delete(changeName);
             return code;
           });
           return { exited: wrapped, kill: () => proc.kill() };

package/package.json

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