@neriros/ralphy 2.16.4 → 2.16.6

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.4")
-      return "2.16.4";
+    if ("2.16.6")
+      return "2.16.6";
   } catch {}
   const dirsToTry = [];
   try {
@@ -59616,19 +59616,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 +60275,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 +60338,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 +60414,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 +60429,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 +60612,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 +60631,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 +60943,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 +61005,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 +61197,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 +61207,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}\`.`,
@@ -61231,21 +61285,8 @@ PR: ${prUrl}` : ""
     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 +61299,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 +61311,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 +61333,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 +61347,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 +61531,7 @@ function describeIndicators(indicators, team, assignee) {
 }
 var bunGitRunner, bunCmdRunner;
 var init_wire = __esm(() => {
+  init_log();
   init_layout();
   init_types2();
   init_coordinator();
@@ -61546,7 +61578,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 +61603,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 +61709,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 +66832,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();
@@ -72377,11 +72409,19 @@ var import_react57 = __toESM(require_react(), 1);
 init_cli();
 init_config();
 init_wire();
-var jsx_dev_runtime9 = __toESM(require_jsx_dev_runtime(), 1);
-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) {
+  const checked = (content.match(/^- \[x\]/gm) ?? []).length;
+  const unchecked = (content.match(/^- \[ \]/gm) ?? []).length;
+  return { checked, unchecked, total: checked + unchecked };
+}
+
+// apps/cli/src/components/AgentMode.tsx
+init_log();
+var jsx_dev_runtime9 = __toESM(require_jsx_dev_runtime(), 1);
 var lineCounter = 0;
 function nextId() {
   lineCounter += 1;
@@ -72408,6 +72448,18 @@ function fmtElapsed(ms) {
 function trunc(s, max2) {
   return s.length > max2 ? s.slice(0, max2 - 1) + "\u2026" : s;
 }
+function calcProgressBar(checked, total, width) {
+  const countStr = `${checked}/${total}`;
+  const inner = width - 2;
+  if (inner < countStr.length + 2)
+    return null;
+  const leftSlot = Math.floor((inner - countStr.length) / 2);
+  const rightSlot = Math.max(0, inner - countStr.length - leftSlot);
+  const filled = total > 0 ? Math.round(checked / total * inner) : 0;
+  const filledLeft = Math.min(filled, leftSlot);
+  const filledRight = Math.max(0, Math.min(filled - leftSlot - countStr.length, rightSlot));
+  return { countStr, filledLeft, leftSlot, filledRight, rightSlot };
+}
 function prLabel(prUrl) {
   const m = prUrl.match(/\/pull\/(\d+)/);
   return m ? `#${m[1]}` : "PR";
@@ -72571,28 +72623,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();
@@ -72606,15 +72637,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;
@@ -72635,49 +72666,37 @@ 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",
             phaseDetail: "",
             phaseStartedAt: Date.now(),
             currentTask: null,
+            taskProgress: null,
             prUrl: null,
             currentCmd: null,
             tail: []
           });
         },
         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);
@@ -72758,7 +72777,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;
@@ -72768,11 +72787,13 @@ 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);
                 meta.currentTask = match?.[1]?.trim() ?? null;
+                const { checked, total } = countProgress(text);
+                meta.taskProgress = total > 0 ? { checked, total } : null;
               }
             } catch (err) {
               console.error(`Failed to read tasks.md for worker '${changeName}' (may not exist yet):`, err);
@@ -73119,6 +73140,7 @@ function AgentMode({ args, projectRoot, statesDir, tasksDir }) {
             const tail2 = meta?.tail ?? [];
             const prUrl = meta?.prUrl ?? null;
             const currentTask = meta?.currentTask ?? null;
+            const taskProgress = meta?.taskProgress ?? null;
             const pBadge = priorityBadge(w.issue.priority);
             const mBadge = modeBadge(w.mode);
             const pColor = phaseColor(phase);
@@ -73322,6 +73344,46 @@ function AgentMode({ args, projectRoot, statesDir, tasksDir }) {
                     }, undefined, false, undefined, this)
                   ]
                 }, undefined, true, undefined, this),
+                taskProgress && (() => {
+                  const bar = calcProgressBar(taskProgress.checked, taskProgress.total, termWidth - 4);
+                  if (!bar)
+                    return null;
+                  const { countStr, filledLeft, leftSlot, filledRight, rightSlot } = bar;
+                  return /* @__PURE__ */ jsx_dev_runtime9.jsxDEV(Box_default, {
+                    marginTop: 0,
+                    children: [
+                      /* @__PURE__ */ jsx_dev_runtime9.jsxDEV(Text, {
+                        dimColor: true,
+                        children: "["
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsx_dev_runtime9.jsxDEV(Text, {
+                        color: "green",
+                        children: "\u2588".repeat(filledLeft)
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsx_dev_runtime9.jsxDEV(Text, {
+                        dimColor: true,
+                        children: "\u2591".repeat(leftSlot - filledLeft)
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsx_dev_runtime9.jsxDEV(Text, {
+                        color: "white",
+                        bold: true,
+                        children: countStr
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsx_dev_runtime9.jsxDEV(Text, {
+                        color: "green",
+                        children: "\u2588".repeat(filledRight)
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsx_dev_runtime9.jsxDEV(Text, {
+                        dimColor: true,
+                        children: "\u2591".repeat(rightSlot - filledRight)
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsx_dev_runtime9.jsxDEV(Text, {
+                        dimColor: true,
+                        children: "]"
+                      }, undefined, false, undefined, this)
+                    ]
+                  }, undefined, true, undefined, this);
+                })(),
                 currentTask && /* @__PURE__ */ jsx_dev_runtime9.jsxDEV(Box_default, {
                   gap: 1,
                   marginTop: 0,
@@ -73385,11 +73447,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"];
@@ -73415,7 +73477,7 @@ class OpenSpecChangeStore {
     }
   }
   getChangeDirectory(name) {
-    return join17("openspec", "changes", name);
+    return join18("openspec", "changes", name);
   }
   async listChanges() {
     const result2 = runOpenspec(["list", "--json"]);
@@ -73429,7 +73491,7 @@ class OpenSpecChangeStore {
         }
       } catch {}
     }
-    const changesDir = join17("openspec", "changes");
+    const changesDir = join18("openspec", "changes");
     if (!await Bun.file(changesDir).exists())
       return [];
     try {
@@ -73440,18 +73502,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}
@@ -73462,7 +73524,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();
@@ -73580,8 +73642,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);
@@ -73633,7 +73695,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, "..");
   }
@@ -73674,7 +73736,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"],
@@ -73687,9 +73749,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)) {
@@ -73741,13 +73803,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/package.json

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