@neriros/ralphy 2.16.5 → 2.16.7

package/README.md

@@ -231,9 +231,24 @@ Each worker card shows:
 - `▶ TASK` — first unchecked task from `tasks.md`, updated every second
 - `PHASE` with color (cyan = working, yellow = git ops, blue = CI, green = done, red = gave-up) + time in phase
 - `⏵ CMD` when a shell command is in flight (shows the command and how long it's been running)
-- `LOG` — path to the worker's log file for `tail -f`
+- `LOG` — path to the worker's log file for `tail -f` (format: `[ISO] [type] message`)
 - `─ OUTPUT ─` section with live stdout/stderr (scales to fill remaining terminal height for the focused worker)
 
+### Log files
+
+All log entries use the format `[2024-01-15T12:00:00.000Z] [type] message`. Four log types:
+
+| Type      | Meaning                                            | Destination                                        |
+| --------- | -------------------------------------------------- | -------------------------------------------------- |
+| `session` | Worker start / stop boundaries                     | `agent-mode.log` + worker log                      |
+| `phase`   | Phase transitions (working → pushing → ci-poll …)  | `agent-mode.log` + worker log                      |
+| `coord`   | Coordinator events (Linear poll, worktree, labels) | `agent-mode.log` + worker log (when task-specific) |
+| `output`  | Raw subprocess stdout/stderr lines                 | Worker log only                                    |
+
+- **`~/.ralph/agent-mode.log`** — global session log, appended each agent run
+- **`<projectRoot>/.ralph/logs/<change>.log`** — per-worker unified log; includes output, phases, and coordinator events for that task. `tail -f` this for live progress.
+- **`<taskDir>/LOG.jsonl`** — structured JSON event log for the web UI (each line has a `ts` field)
+
 ## OpenSpec Flow
 
 There are no phases. One loop, one prompt, one `tasks.md` checklist.

package/dist/cli/index.js

@@ -35029,8 +35029,8 @@ import { readFileSync as readFileSync2 } from "fs";
 import { resolve } from "path";
 function getVersion() {
   try {
-    if ("2.16.5")
-      return "2.16.5";
+    if ("2.16.7")
+      return "2.16.7";
   } catch {}
   const dirsToTry = [];
   try {
@@ -35121,6 +35121,7 @@ async function parseArgs(argv) {
     log: false,
     verbose: false,
     manualTest: false,
+    fromAgent: false,
     linearTeam: "",
     linearAssignee: "",
     pollInterval: 60,
@@ -35321,6 +35322,9 @@ async function parseArgs(argv) {
       case "--manual-test":
         result2.manualTest = true;
         break;
+      case "--from-agent":
+        result2.fromAgent = true;
+        break;
       default:
         if (VALID_MODES.has(arg)) {
           result2.mode = arg;
@@ -39426,6 +39430,7 @@ var init_types2 = __esm(() => {
     engine: exports_external.enum(["claude", "codex"]).default("claude"),
     model: exports_external.string().default("opus"),
     manualTest: exports_external.boolean().default(false),
+    createPr: exports_external.boolean().default(false),
     usage: UsageSchema.default({}),
     history: exports_external.array(HistoryEntrySchema).default([]),
     metadata: exports_external.object({ branch: exports_external.string().optional() }).default({})
@@ -59616,19 +59621,73 @@ var init_config = __esm(() => {
   });
 });
 
+// packages/log/src/log.ts
+import { appendFile } from "fs/promises";
+import { join as join11, dirname as dirname4 } from "path";
+import { homedir as homedir2 } from "os";
+import { mkdir as mkdir2 } from "fs/promises";
+function fmt(type, text) {
+  return `[${new Date().toISOString()}] [${type}] ${text}
+`;
+}
+function write(path, line) {
+  appendFile(path, line).catch(() => {
+    return;
+  });
+}
+function logSession(text, workerLogFile) {
+  const clean = text.replace(ANSI_RE, "").trim();
+  if (!clean)
+    return;
+  const line = fmt("session", clean);
+  write(AGENT_LOG_PATH, line);
+  if (workerLogFile)
+    write(workerLogFile, line);
+}
+function logCoord(text, workerLogFile) {
+  const clean = text.replace(ANSI_RE, "").trim();
+  if (!clean)
+    return;
+  const line = fmt("coord", clean);
+  write(AGENT_LOG_PATH, line);
+  if (workerLogFile)
+    write(workerLogFile, line);
+}
+function logPhase(changeName, workerLogFile, phase, detail) {
+  const msg = `${changeName}: ${phase}${detail ? ` (${detail})` : ""}`;
+  const line = fmt("phase", msg);
+  write(AGENT_LOG_PATH, line);
+  write(workerLogFile, line);
+}
+function logOutput(workerLogFile, text) {
+  write(workerLogFile, fmt("output", text));
+}
+async function initWorkerLog(logFile) {
+  await mkdir2(dirname4(logFile), { recursive: true });
+  await Bun.write(logFile, "");
+}
+var ANSI_RE, AGENT_LOG_PATH;
+var init_log = __esm(() => {
+  ANSI_RE = /\x1b(?:\[[0-9;]*[A-Za-z]|\][^\x07\x1b]*(?:\x07|\x1b\\)|.)/g;
+  AGENT_LOG_PATH = join11(homedir2(), ".ralph", "agent-mode.log");
+  mkdir2(dirname4(AGENT_LOG_PATH), { recursive: true }).catch(() => {
+    return;
+  });
+});
+
 // packages/core/src/layout.ts
-import { join as join11 } from "path";
+import { join as join12 } from "path";
 function projectLayout(root) {
-  const statesDir = join11(root, ".ralph", "tasks");
-  const tasksDir = join11(root, "openspec", "changes");
+  const statesDir = join12(root, ".ralph", "tasks");
+  const tasksDir = join12(root, "openspec", "changes");
   return {
     root,
     statesDir,
     tasksDir,
-    agentStateFile: join11(root, ".ralph", "agent-state.json"),
-    changeDir: (name) => join11(tasksDir, name),
-    taskStateDir: (name) => join11(statesDir, name),
-    stateFile: (name) => join11(statesDir, name, STATE_FILE2)
+    agentStateFile: join12(root, ".ralph", "agent-state.json"),
+    changeDir: (name) => join12(tasksDir, name),
+    taskStateDir: (name) => join12(statesDir, name),
+    stateFile: (name) => join12(statesDir, name, STATE_FILE2)
   };
 }
 var STATE_FILE2 = ".ralph-state.json";
@@ -60221,19 +60280,19 @@ var init_coordinator = __esm(() => {
 });
 
 // apps/cli/src/agent/scaffold.ts
-import { join as join12 } from "path";
-import { mkdir as mkdir2 } from "fs/promises";
+import { join as join13 } from "path";
+import { mkdir as mkdir3 } from "fs/promises";
 function changeNameForIssue(issue) {
   const slug = issue.title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 40);
   return slug ? `${issue.identifier.toLowerCase()}-${slug}` : issue.identifier.toLowerCase();
 }
 async function scaffoldChangeForIssue(tasksDir, statesDir, issue, comments = [], appendPrompt = "") {
   const name = changeNameForIssue(issue);
-  const changeDir = join12(tasksDir, name);
-  const stateDir = join12(statesDir, name);
-  await mkdir2(changeDir, { recursive: true });
-  await mkdir2(join12(changeDir, "specs"), { recursive: true });
-  await mkdir2(stateDir, { recursive: true });
+  const changeDir = join13(tasksDir, name);
+  const stateDir = join13(statesDir, name);
+  await mkdir3(changeDir, { recursive: true });
+  await mkdir3(join13(changeDir, "specs"), { recursive: true });
+  await mkdir3(stateDir, { recursive: true });
   const commentsBlock = comments.length > 0 ? [
     "",
     "## Linear comments",
@@ -60284,26 +60343,26 @@ async function scaffoldChangeForIssue(tasksDir, statesDir, issue, comments = [],
     ""
   ].join(`
 `);
-  await Bun.write(join12(changeDir, "proposal.md"), proposal);
-  await Bun.write(join12(changeDir, "tasks.md"), tasks);
-  await Bun.write(join12(changeDir, "design.md"), design);
+  await Bun.write(join13(changeDir, "proposal.md"), proposal);
+  await Bun.write(join13(changeDir, "tasks.md"), tasks);
+  await Bun.write(join13(changeDir, "design.md"), design);
   return name;
 }
 var init_scaffold = () => {};
 
 // apps/cli/src/agent/worktree.ts
-import { basename, join as join13 } from "path";
-import { homedir as homedir2 } from "os";
+import { basename, join as join14 } from "path";
+import { homedir as homedir3 } from "os";
 import { exists } from "fs/promises";
 function worktreesDir(projectRoot) {
-  return join13(homedir2(), ".ralph", basename(projectRoot), "worktrees");
+  return join14(homedir3(), ".ralph", basename(projectRoot), "worktrees");
 }
 function branchForChange(changeName) {
   return `ralph/${changeName}`;
 }
 async function createWorktree(projectRoot, changeName, runner) {
   const dir = worktreesDir(projectRoot);
-  const cwd2 = join13(dir, changeName);
+  const cwd2 = join14(dir, changeName);
   const branch = branchForChange(changeName);
   const list = await runner.run(["worktree", "list", "--porcelain"], projectRoot);
   if (list.stdout.includes(`worktree ${cwd2}
@@ -60360,8 +60419,8 @@ async function isWorktreeSafeToRemove(cwd2, base2, runner) {
   return { safe: true, dirty, unpushedCommits };
 }
 async function seedWorktreeMcpConfig(projectRoot, worktreeCwd) {
-  const dst = join13(worktreeCwd, ".mcp.json");
-  const src = join13(projectRoot, ".mcp.json");
+  const dst = join14(worktreeCwd, ".mcp.json");
+  const src = join14(projectRoot, ".mcp.json");
   const source = await exists(dst) ? dst : await exists(src) ? src : null;
   if (!source)
     return;
@@ -60375,7 +60434,7 @@ async function seedWorktreeMcpConfig(projectRoot, worktreeCwd) {
   if (servers && typeof servers === "object") {
     for (const cfg of Object.values(servers)) {
       if (Array.isArray(cfg.args)) {
-        cfg.args = cfg.args.map((a) => typeof a === "string" && a.startsWith(".ralph/") ? join13(projectRoot, a) : a);
+        cfg.args = cfg.args.map((a) => typeof a === "string" && a.startsWith(".ralph/") ? join14(projectRoot, a) : a);
       }
     }
   }
@@ -60558,7 +60617,7 @@ var init_ci = __esm(() => {
 });
 
 // apps/cli/src/agent/post-task.ts
-import { join as join14 } from "path";
+import { join as join15 } from "path";
 async function reactivateState(stateFilePath, log2, changeName) {
   const file = Bun.file(stateFilePath);
   if (!await file.exists())
@@ -60577,7 +60636,7 @@ async function reactivateState(stateFilePath, log2, changeName) {
 }
 async function runWorkerWithFixTask(ctx, heading, body) {
   try {
-    await prependFixTask(join14(ctx.changeDir, "tasks.md"), heading, body);
+    await prependFixTask(join15(ctx.changeDir, "tasks.md"), heading, body);
   } catch (err) {
     ctx.log(`! could not prepend fix task: ${err.message}`, "red");
     return 1;
@@ -60889,8 +60948,8 @@ var init_post_task = __esm(() => {
 });
 
 // apps/cli/src/agent/wire.ts
-import { join as join15 } from "path";
-import { mkdir as mkdir3 } from "fs/promises";
+import { join as join16 } from "path";
+import { mkdir as mkdir4 } from "fs/promises";
 function traceCmdRunner(base2, onStart, onEnd) {
   return {
     run: async (cmd, cwd2) => {
@@ -60951,7 +61010,7 @@ function buildAgentCoordinator(input) {
     onWorkerOutput,
     onWorkerCmd
   } = input;
-  const logsDir = join15(projectRoot, ".ralph", "logs");
+  const logsDir = join16(projectRoot, ".ralph", "logs");
   const concurrency = args.concurrency || cfg.concurrency;
   const pollInterval = args.pollInterval || cfg.pollIntervalSeconds;
   const indicators = mergeIndicators(cfg.linear.indicators, args.indicators);
@@ -61143,8 +61202,8 @@ function buildAgentCoordinator(input) {
     } else {
       changeName = changeNameForIssue(issue);
       const wtLayout = projectLayout(workerCwd);
-      await mkdir3(wtLayout.changeDir(changeName), { recursive: true });
-      await mkdir3(wtLayout.taskStateDir(changeName), { recursive: true });
+      await mkdir4(wtLayout.changeDir(changeName), { recursive: true });
+      await mkdir4(wtLayout.taskStateDir(changeName), { recursive: true });
     }
     cwdByChange.set(changeName, workerCwd);
     statesDirByChange.set(changeName, scaffoldStatesDir);
@@ -61153,7 +61212,7 @@ function buildAgentCoordinator(input) {
       branchByChange.set(changeName, branch);
     if (mode === "conflict-fix") {
       const wtLayout = projectLayout(workerCwd);
-      const tasksFile = join15(wtLayout.changeDir(changeName), "tasks.md");
+      const tasksFile = join16(wtLayout.changeDir(changeName), "tasks.md");
       const prUrl = prByChange.get(changeName);
       const body = [
         `The PR for this change has merge conflicts with \`${cfg.prBaseBranch}\`.`,
@@ -61228,24 +61287,12 @@ PR: ${prUrl}` : ""
       c.push("--verbose");
     if (args.manualTest || cfg.enableManualTest)
       c.push("--manual-test");
+    c.push("--from-agent");
     return c;
   }
   function defaultSpawn(changeName, cmd, cwd2, note) {
-    const logFilePath = join15(logsDir, `${changeName}.log`);
-    let logWriter = null;
-    const ensureLogWriter = async () => {
-      if (logWriter)
-        return logWriter;
-      try {
-        await Bun.write(logFilePath, "");
-        logWriter = Bun.file(logFilePath).writer();
-        return logWriter;
-      } catch (err) {
-        onLog(`! could not open worker log ${logFilePath}: ${err.message}`, "yellow");
-        return null;
-      }
-    };
-    const ANSI_RE = /\x1b(?:\[[0-9;]*[A-Za-z]|\][^\x07\x1b]*(?:\x07|\x1b\\)|.)/g;
+    const logFilePath = join16(logsDir, `${changeName}.log`);
+    const ANSI_RE2 = /\x1b(?:\[[0-9;]*[A-Za-z]|\][^\x07\x1b]*(?:\x07|\x1b\\)|.)/g;
     const BOX_ONLY_RE = /^[\s\u2500\u2502\u256D\u256E\u2570\u256F\u254C\u2504\u2501\u2503]+$/;
     const STATUS_BAR_LINE_RE = /^[\u280B\u2819\u2839\u2838\u283C\u2834\u2826\u2827\u2807\u280F\u2713\u2717]\s+iter\s+\d+/;
     const ITER_HEADER_LINE_RE = /^\u2500\u2500/;
@@ -61258,7 +61305,6 @@ PR: ${prUrl}` : ""
       const reader = stream.getReader();
       const decoder = new TextDecoder;
       let buf = "";
-      const writer = await ensureLogWriter();
       try {
         while (true) {
           const { value, done } = await reader.read();
@@ -61271,26 +61317,20 @@ PR: ${prUrl}` : ""
 `)) >= 0) {
             const line = buf.slice(0, nl);
             buf = buf.slice(nl + 1);
-            const clean = line.replace(ANSI_RE, "").trim();
-            if (writer && clean && isLogWorthy(clean))
-              writer.write(clean + `
-`);
+            const clean = line.replace(ANSI_RE2, "").trim();
+            if (clean && isLogWorthy(clean))
+              logOutput(logFilePath, clean);
             if (line)
               onWorkerOutput?.(changeName, label === "err" ? `! ${line}` : line);
           }
         }
         if (buf) {
-          const clean = buf.replace(ANSI_RE, "").trim();
-          if (writer && clean && isLogWorthy(clean))
-            writer.write(clean + `
-`);
+          const clean = buf.replace(ANSI_RE2, "").trim();
+          if (clean && isLogWorthy(clean))
+            logOutput(logFilePath, clean);
           onWorkerOutput?.(changeName, label === "err" ? `! ${buf}` : buf);
         }
-      } catch {} finally {
-        try {
-          writer?.flush();
-        } catch {}
-      }
+      } catch {}
     }
     const p = Bun.spawn({
       cmd,
@@ -61299,13 +61339,10 @@ PR: ${prUrl}` : ""
       stderr: "pipe",
       stdin: "ignore"
     });
-    (async () => {
-      const writer = await ensureLogWriter();
-      if (note && writer)
-        writer.write(`
---- ${note} ---
-`);
-    })();
+    initWorkerLog(logFilePath).then(() => {
+      if (note)
+        logSession(note, logFilePath);
+    });
     pump(p.stdout, "out");
     pump(p.stderr, "err");
     return { exited: p.exited, kill: () => p.kill(), logFilePath };
@@ -61316,7 +61353,7 @@ PR: ${prUrl}` : ""
     let logFilePath;
     let handle;
     if (injected) {
-      logFilePath = join15(logsDir, `${changeName}.log`);
+      logFilePath = join16(logsDir, `${changeName}.log`);
       handle = injected(buildTaskCmdFor(changeName), cwd2);
     } else {
       const r = defaultSpawn(changeName, buildTaskCmdFor(changeName), cwd2, `spawn at ${new Date().toISOString()}`);
@@ -61500,6 +61537,7 @@ function describeIndicators(indicators, team, assignee) {
 }
 var bunGitRunner, bunCmdRunner;
 var init_wire = __esm(() => {
+  init_log();
   init_layout();
   init_types2();
   init_coordinator();
@@ -61546,7 +61584,7 @@ var exports_json_runner = {};
 __export(exports_json_runner, {
   runAgentJson: () => runAgentJson
 });
-import { join as join19 } from "path";
+import { join as join20 } from "path";
 import { mkdir as mkdir6 } from "fs/promises";
 import { homedir as homedir4 } from "os";
 function cleanOutputLine2(raw) {
@@ -61571,7 +61609,7 @@ async function runAgentJson({
   statesDir,
   tasksDir
 }) {
-  await mkdir6(join19(homedir4(), ".ralph"), { recursive: true }).catch(() => {
+  await mkdir6(join20(homedir4(), ".ralph"), { recursive: true }).catch(() => {
     return;
   });
   const cfgPath = await ensureRalphyConfig(projectRoot);
@@ -61677,7 +61715,7 @@ var init_json_runner = __esm(() => {
 });
 
 // apps/cli/src/index.ts
-import { resolve as resolve2, join as join20, dirname as dirname6 } from "path";
+import { resolve as resolve2, join as join21, dirname as dirname6 } from "path";
 import { exists as exists2, mkdir as mkdir7, rm } from "fs/promises";
 
 // node_modules/.bun/ink@5.2.1+1f88f629f0141b18/node_modules/ink/build/render.js
@@ -66800,7 +66838,7 @@ function createDefaultContext() {
 
 // apps/cli/src/components/App.tsx
 var import_react58 = __toESM(require_react(), 1);
-import { join as join18 } from "path";
+import { join as join19 } from "path";
 
 // packages/core/src/state.ts
 init_types2();
@@ -66853,6 +66891,7 @@ function buildInitialState(options) {
     engine: options.engine ?? "claude",
     model: options.model ?? "opus",
     manualTest: options.manualTest ?? false,
+    createPr: options.createPr ?? false,
     createdAt: now2,
     lastModified: now2,
     metadata: { branch }
@@ -71852,6 +71891,17 @@ function buildTaskPrompt(state, taskDir) {
 `;
   prompt += `Commit all changed files yourself before finishing \u2014 stage files individually (e.g. \`git add path/to/file\`), never \`git add -A\` or \`git commit -am\`. Nothing is committed automatically after you exit.
 `;
+  if (state.createPr) {
+    prompt += `
+When all tasks are complete and all files are committed, push your branch and open a pull request:
+`;
+    prompt += `  git push -u origin HEAD
+`;
+    prompt += `  gh pr create --title "${state.name}" --body "Summary of changes for ${state.name}"
+`;
+    prompt += `Use the change name as the PR title and write a concise summary of the implementation in the body.
+`;
+  }
   return prompt;
 }
 function checkStopSignal(taskDir, stateDir) {
@@ -72019,7 +72069,8 @@ function useLoop(opts) {
           prompt: opts.prompt,
           engine: opts.engine,
           model: opts.model,
-          manualTest: opts.manualTest
+          manualTest: opts.manualTest,
+          createPr: opts.createPr ?? false
         });
         writeState(stateDir, currentState);
       }
@@ -72377,10 +72428,8 @@ var import_react57 = __toESM(require_react(), 1);
 init_cli();
 init_config();
 init_wire();
-import { join as join16, dirname as dirname4 } from "path";
+import { join as join17 } from "path";
 import { pathToFileURL } from "url";
-import { homedir as homedir3 } from "os";
-import { appendFile, mkdir as mkdir4 } from "fs/promises";
 
 // packages/core/src/progress.ts
 function countProgress(content) {
@@ -72390,6 +72439,7 @@ function countProgress(content) {
 }
 
 // apps/cli/src/components/AgentMode.tsx
+init_log();
 var jsx_dev_runtime9 = __toESM(require_jsx_dev_runtime(), 1);
 var lineCounter = 0;
 function nextId() {
@@ -72592,28 +72642,7 @@ function displayTailLines(activeCount) {
     return 8;
   return 5;
 }
-var AGENT_LOG_PATH = join16(homedir3(), ".ralph", "agent-mode.log");
 var SESSION_START = new Date().toISOString();
-mkdir4(dirname4(AGENT_LOG_PATH), { recursive: true }).catch(() => {
-  return;
-});
-function writeAgentLog(text) {
-  const clean = text.replace(ANSI_STRIP_RE, "").trim();
-  if (!clean)
-    return;
-  const line = `[${new Date().toISOString()}] ${clean}
-`;
-  appendFile(AGENT_LOG_PATH, line).catch(() => {
-    return;
-  });
-}
-function writePhaseLog(phaseLogFile, text) {
-  const line = `[${new Date().toISOString()}] ${text}
-`;
-  appendFile(phaseLogFile, line).catch(() => {
-    return;
-  });
-}
 function AgentMode({ args, projectRoot, statesDir, tasksDir }) {
   const { exit } = use_app_default();
   const { stdout } = use_stdout_default();
@@ -72627,15 +72656,15 @@ function AgentMode({ args, projectRoot, statesDir, tasksDir }) {
   const nextPollAtRef = import_react57.useRef(0);
   const cfgRef = import_react57.useRef(null);
   const [pollStatus, setPollStatus] = import_react57.useState({ state: "idle", lastFound: null, lastAdded: null, lastAt: null, filterDesc: "" });
-  function appendLog(text, color) {
+  function appendLog(text, color, workerLogFile) {
     setLogs((prev) => [...prev, { id: nextId(), text, color }]);
-    writeAgentLog(text);
+    logCoord(text, workerLogFile);
   }
   import_react57.useEffect(() => {
     let pollTimer = null;
     let cancelled = false;
     async function init2() {
-      writeAgentLog(`=== session start ${SESSION_START} ===`);
+      logSession(`=== session start ${SESSION_START} ===`);
       const cfgPath = await ensureRalphyConfig(projectRoot);
       const cfg2 = await loadRalphyConfig(projectRoot);
       cfgRef.current = cfg2;
@@ -72656,17 +72685,11 @@ function AgentMode({ args, projectRoot, statesDir, tasksDir }) {
         onLog: appendLog,
         onWorkersChanged: () => setTick((t) => t + 1),
         onWorkerStarted: (changeName, dir, logFile, changeDir) => {
-          writeAgentLog(`worker-started ${changeName} log=${logFile}`);
-          const phaseLogFile = logFile.replace(/\.log$/, "-phases.log");
-          mkdir4(dirname4(phaseLogFile), { recursive: true }).then(() => appendFile(phaseLogFile, `=== session ${SESSION_START} | worker-started ${new Date().toISOString()} ===
-`)).catch(() => {
-            return;
-          });
+          logSession(`worker-started ${changeName} log=${logFile}`, logFile);
           workerMetaRef.current.set(changeName, {
             startedAt: Date.now(),
             statesDir: dir,
             logFile,
-            phaseLogFile,
             changeDir,
             iter: 0,
             phase: "working",
@@ -72680,26 +72703,19 @@ function AgentMode({ args, projectRoot, statesDir, tasksDir }) {
           });
         },
         onWorkerExited: (changeName) => {
-          writeAgentLog(`worker-exited ${changeName}`);
           const m = workerMetaRef.current.get(changeName);
-          if (m?.phaseLogFile) {
-            writePhaseLog(m.phaseLogFile, `=== worker-exited ===`);
-          }
+          logSession(`worker-exited ${changeName}`, m?.logFile);
           workerMetaRef.current.delete(changeName);
         },
         onWorkerPhase: (changeName, phase, detail) => {
           const m = workerMetaRef.current.get(changeName);
           if (!m)
             return;
-          if (m.phase !== phase) {
-            writeAgentLog(`phase ${changeName}: ${phase}${detail ? ` (${detail})` : ""}`);
+          if (m.phase !== phase)
             m.phaseStartedAt = Date.now();
-          }
           m.phase = phase;
           m.phaseDetail = detail ?? "";
-          if (m.phaseLogFile) {
-            writePhaseLog(m.phaseLogFile, `${phase}${detail ? ` (${detail})` : ""}`);
-          }
+          logPhase(changeName, m.logFile, phase, detail);
         },
         onWorkerOutput: (changeName, line) => {
           const m = workerMetaRef.current.get(changeName);
@@ -72780,7 +72796,7 @@ function AgentMode({ args, projectRoot, statesDir, tasksDir }) {
       (async () => {
         for (const [changeName, meta] of workerMetaRef.current) {
           try {
-            const file = Bun.file(join16(meta.statesDir, changeName, ".ralph-state.json"));
+            const file = Bun.file(join17(meta.statesDir, changeName, ".ralph-state.json"));
             if (await file.exists()) {
               const json = await file.json();
               meta.iter = json.iteration ?? meta.iter;
@@ -72790,7 +72806,7 @@ function AgentMode({ args, projectRoot, statesDir, tasksDir }) {
           }
           if (meta.changeDir) {
             try {
-              const tasksFile = Bun.file(join16(meta.changeDir, "tasks.md"));
+              const tasksFile = Bun.file(join17(meta.changeDir, "tasks.md"));
               if (await tasksFile.exists()) {
                 const text = await tasksFile.text();
                 const match = text.match(/^- \[ \] (.+)$/m);
@@ -73450,11 +73466,11 @@ function AgentMode({ args, projectRoot, statesDir, tasksDir }) {
 }
 
 // packages/openspec/src/openspec-change-store.ts
-import { join as join17, dirname as dirname5 } from "path";
+import { join as join18, dirname as dirname5 } from "path";
 import { readdir, mkdir as mkdir5 } from "fs/promises";
 function resolveOpenspecBin() {
   const pkgJsonPath = Bun.resolveSync("@fission-ai/openspec/package.json", import.meta.dir);
-  return join17(dirname5(pkgJsonPath), "bin", "openspec.js");
+  return join18(dirname5(pkgJsonPath), "bin", "openspec.js");
 }
 function runOpenspec(args, options = {}) {
   const stdio = options.inherit ? ["inherit", "inherit", "inherit"] : ["ignore", "pipe", "pipe"];
@@ -73480,7 +73496,7 @@ class OpenSpecChangeStore {
     }
   }
   getChangeDirectory(name) {
-    return join17("openspec", "changes", name);
+    return join18("openspec", "changes", name);
   }
   async listChanges() {
     const result2 = runOpenspec(["list", "--json"]);
@@ -73494,7 +73510,7 @@ class OpenSpecChangeStore {
         }
       } catch {}
     }
-    const changesDir = join17("openspec", "changes");
+    const changesDir = join18("openspec", "changes");
     if (!await Bun.file(changesDir).exists())
       return [];
     try {
@@ -73505,18 +73521,18 @@ class OpenSpecChangeStore {
     }
   }
   async readTaskList(name) {
-    const file = Bun.file(join17("openspec", "changes", name, "tasks.md"));
+    const file = Bun.file(join18("openspec", "changes", name, "tasks.md"));
     if (!await file.exists())
       return "";
     return await file.text();
   }
   async writeTaskList(name, content) {
-    const path = join17("openspec", "changes", name, "tasks.md");
+    const path = join18("openspec", "changes", name, "tasks.md");
     await mkdir5(dirname5(path), { recursive: true });
     await Bun.write(path, content);
   }
   async appendSteering(name, message) {
-    const path = join17("openspec", "changes", name, "steering.md");
+    const path = join18("openspec", "changes", name, "steering.md");
     const file = Bun.file(path);
     const existing = await file.exists() ? await file.text() : null;
     const updated = existing ? `${message}
@@ -73527,7 +73543,7 @@ ${existing.trimStart()}` : `${message}
     await Bun.write(path, updated);
   }
   async readSection(name, artifact, heading) {
-    const file = Bun.file(join17("openspec", "changes", name, artifact));
+    const file = Bun.file(join18("openspec", "changes", name, artifact));
     if (!await file.exists())
       return "";
     const content = await file.text();
@@ -73619,6 +73635,7 @@ function TaskModeWrapper({ args, statesDir, tasksDir, projectRoot }) {
       log: args.log,
       verbose: args.verbose,
       manualTest,
+      createPr: args.fromAgent,
       statesDir,
       tasksDir,
       changeStore: new OpenSpecChangeStore
@@ -73645,8 +73662,8 @@ function App2({ args, statesDir, tasksDir, projectRoot }) {
           message: "Error: --name is required for status mode"
         }, undefined, false, undefined, this);
       }
-      const stateDir = join18(statesDir, args.name);
-      if (getStorage().read(join18(stateDir, ".ralph-state.json")) === null) {
+      const stateDir = join19(statesDir, args.name);
+      if (getStorage().read(join19(stateDir, ".ralph-state.json")) === null) {
         return /* @__PURE__ */ jsx_dev_runtime10.jsxDEV(ErrorMessage, {
           message: `Error: change '${args.name}' not found`
         }, undefined, false, undefined, this);
@@ -73698,7 +73715,7 @@ if (typeof globalThis.Bun === "undefined") {
 async function findProjectRoot() {
   let dir = process.cwd();
   while (dir !== "/") {
-    if (await exists2(join20(dir, "openspec")))
+    if (await exists2(join21(dir, "openspec")))
       return dir;
     dir = resolve2(dir, "..");
   }
@@ -73739,7 +73756,7 @@ try {
   const tasksDir = layout.tasksDir;
   if (args.mode === "init") {
     await mkdir7(statesDir, { recursive: true });
-    const openspecBin = join20(dirname6(Bun.resolveSync("@fission-ai/openspec/package.json", import.meta.dir)), "bin", "openspec.js");
+    const openspecBin = join21(dirname6(Bun.resolveSync("@fission-ai/openspec/package.json", import.meta.dir)), "bin", "openspec.js");
     Bun.spawnSync({
       cmd: [process.execPath, openspecBin, "init", "--tools", "none", "--force"],
       stdio: ["inherit", "inherit", "inherit"],
@@ -73752,9 +73769,9 @@ try {
 `);
       process.exit(1);
     }
-    const worktreeDir = join20(worktreesDir(projectRoot), args.name);
-    const changeDir = join20(tasksDir, args.name);
-    const stateDir = join20(statesDir, args.name);
+    const worktreeDir = join21(worktreesDir(projectRoot), args.name);
+    const changeDir = join21(tasksDir, args.name);
+    const stateDir = join21(statesDir, args.name);
     const branch = `ralph/${args.name}`;
     const removed = [];
     if (await exists2(worktreeDir)) {
@@ -73806,13 +73823,13 @@ try {
     process.exit(0);
   }
   if (args.mode === "task" && args.name) {
-    await mkdir7(join20(statesDir, args.name), { recursive: true });
-    await mkdir7(join20(tasksDir, args.name), { recursive: true });
+    await mkdir7(join21(statesDir, args.name), { recursive: true });
+    await mkdir7(join21(tasksDir, args.name), { recursive: true });
   }
   if (args.mode === "agent") {
     await mkdir7(statesDir, { recursive: true });
     await mkdir7(tasksDir, { recursive: true });
-    await mkdir7(join20(projectRoot, ".ralph"), { recursive: true });
+    await mkdir7(join21(projectRoot, ".ralph"), { recursive: true });
   }
   if (args.mode === "agent" && args.jsonOutput) {
     const { runAgentJson: runAgentJson2 } = await Promise.resolve().then(() => (init_json_runner(), exports_json_runner));

package/dist/mcp/index.js

@@ -23967,6 +23967,7 @@ var StateSchema = exports_external.object({
   engine: exports_external.enum(["claude", "codex"]).default("claude"),
   model: exports_external.string().default("opus"),
   manualTest: exports_external.boolean().default(false),
+  createPr: exports_external.boolean().default(false),
   usage: UsageSchema.default({}),
   history: exports_external.array(HistoryEntrySchema).default([]),
   metadata: exports_external.object({ branch: exports_external.string().optional() }).default({})
@@ -24033,6 +24034,7 @@ function buildInitialState(options) {
     engine: options.engine ?? "claude",
     model: options.model ?? "opus",
     manualTest: options.manualTest ?? false,
+    createPr: options.createPr ?? false,
     createdAt: now,
     lastModified: now,
     metadata: { branch }

package/package.json

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