ralph-cli-sandboxed 0.6.4 → 0.6.5

package/dist/commands/run.js

@@ -118,11 +118,11 @@ function setupWorktreeRalphDir(worktreePath, branchItems, workspacePaths) {
 }
 /**
  * Creates a filtered PRD file containing only incomplete items (passes: false).
- * Optionally filters by category if specified.
+ * Optionally filters by category and/or branch if specified.
  * Expands @{filepath} references to include file contents.
  * Returns the path to the temp file, or null if all items pass.
  */
-function createFilteredPrd(prdPath, baseDir, category) {
+function createFilteredPrd(prdPath, baseDir, category, branchFilterActive, branchFilter) {
     // Use readPrdFile to handle both JSON and YAML formats
     const parsed = readPrdFile(prdPath);
     if (!parsed) {
@@ -145,6 +145,10 @@ function createFilteredPrd(prdPath, baseDir, category) {
     if (category) {
         filteredItems = filteredItems.filter((item) => item.category === category);
     }
+    // Apply branch filter if specified
+    if (branchFilterActive) {
+        filteredItems = applyBranchFilter(filteredItems, branchFilter);
+    }
     // Expand @{filepath} references in description and steps
     const expandedItems = expandPrdFileReferences(filteredItems, baseDir);
     // Write to .ralph/prd-tasks.json so LLMs see a sensible path
@@ -406,11 +410,24 @@ function formatElapsedTime(startTime, endTime) {
         parts.push(`${seconds}s`);
     return parts.join(" ");
 }
+/**
+ * Filters PRD items by branch.
+ * - branchFilter = "name": only items whose branch field matches "name"
+ * - branchFilter = "": only items that have any branch field set (non-empty)
+ */
+function applyBranchFilter(items, branchFilter) {
+    if (branchFilter === "") {
+        // --branch without value: include only items that have a branch set
+        return items.filter((item) => item.branch && item.branch.length > 0);
+    }
+    // --branch <name>: include only items whose branch matches
+    return items.filter((item) => item.branch === branchFilter);
+}
 /**
  * Counts total and incomplete items in the PRD.
- * Optionally filters by category if specified.
+ * Optionally filters by category and/or branch if specified.
  */
-function countPrdItems(prdPath, category) {
+function countPrdItems(prdPath, category, branchFilterActive, branchFilter) {
     // Use readPrdFile to handle both JSON and YAML formats
     const parsed = readPrdFile(prdPath);
     if (!parsed) {
@@ -430,7 +447,10 @@ function countPrdItems(prdPath, category) {
     const items = parsed.content;
     let filteredItems = items;
     if (category) {
-        filteredItems = items.filter((item) => item.category === category);
+        filteredItems = filteredItems.filter((item) => item.category === category);
+    }
+    if (branchFilterActive) {
+        filteredItems = applyBranchFilter(filteredItems, branchFilter);
     }
     const complete = filteredItems.filter((item) => item.passes === true).length;
     const incomplete = filteredItems.filter((item) => item.passes === false).length;
@@ -537,6 +557,8 @@ function loadValidPrd(prdPath) {
 export async function run(args) {
     // Parse flags
     let category;
+    let branchFilter; // undefined = no filter, "" = any branch, "name" = specific branch
+    let branchFilterActive = false; // true when --branch flag is present
     let model;
     let loopMode = false;
     let allModeExplicit = false;
@@ -554,6 +576,18 @@ export async function run(args) {
                 process.exit(1);
             }
         }
+        else if (args[i] === "--branch" || args[i] === "-b") {
+            branchFilterActive = true;
+            // Check if next arg is a branch name (not another flag)
+            if (i + 1 < args.length && !args[i + 1].startsWith("-")) {
+                branchFilter = args[i + 1];
+                i++; // Skip the branch value
+            }
+            else {
+                // --branch without a value: filter to items that have any branch set
+                branchFilter = "";
+            }
+        }
         else if (args[i] === "--model" || args[i] === "-m") {
             if (i + 1 < args.length) {
                 model = args[i + 1];
@@ -638,7 +672,7 @@ export async function run(args) {
     // Container is required, so always run with skip-permissions
     const sandboxed = true;
     if (allMode) {
-        const counts = countPrdItems(paths.prd, category);
+        const counts = countPrdItems(paths.prd, category, branchFilterActive, branchFilter);
         console.log("Starting ralph in --all mode (runs until all tasks complete)...");
         console.log(`PRD Status: ${counts.complete}/${counts.total} complete, ${counts.incomplete} remaining`);
     }
@@ -651,6 +685,25 @@ export async function run(args) {
     if (category) {
         console.log(`Filtering PRD items by category: ${category}`);
     }
+    if (branchFilterActive) {
+        if (branchFilter === "") {
+            console.log("Filtering PRD items to only branched items");
+        }
+        else {
+            console.log(`Filtering PRD items by branch: ${branchFilter}`);
+        }
+        // Check if any items match the branch filter; if not, exit early
+        const branchCounts = countPrdItems(paths.prd, category, branchFilterActive, branchFilter);
+        if (branchCounts.total === 0) {
+            if (branchFilter === "") {
+                console.error("\nNo PRD items have a branch field set.");
+            }
+            else {
+                console.error(`\nNo PRD items match branch "${branchFilter}".`);
+            }
+            process.exit(1);
+        }
+    }
     if (streamJson?.enabled) {
         console.log("Stream JSON output enabled - displaying formatted Claude output");
         if (streamJson.saveRawJson) {
@@ -668,7 +721,7 @@ export async function run(args) {
     let iterationCount = 0;
     // Progress tracking for --all mode
     // Progress = tasks completed OR new tasks added (allows ralph to expand the PRD)
-    const initialCounts = countPrdItems(paths.prd, category);
+    const initialCounts = countPrdItems(paths.prd, category, branchFilterActive, branchFilter);
     let lastCompletedCount = initialCounts.complete;
     let lastTotalCount = initialCounts.total;
     let iterationsWithoutProgress = 0;
@@ -796,7 +849,7 @@ export async function run(args) {
     try {
         while (true) {
             iterationCount++;
-            const currentCounts = countPrdItems(paths.prd, category);
+            const currentCounts = countPrdItems(paths.prd, category, branchFilterActive, branchFilter);
             // Check if we should stop (not in loop mode)
             if (!loopMode && !allMode) {
                 if (iterationCount > requestedIterations) {
@@ -823,6 +876,9 @@ export async function run(args) {
             if (category) {
                 itemsForIteration = itemsForIteration.filter((item) => item.category === category);
             }
+            if (branchFilterActive) {
+                itemsForIteration = applyBranchFilter(itemsForIteration, branchFilter);
+            }
             const branchGroups = groupItemsByBranch(itemsForIteration);
             // Check if there are any incomplete items
             if (branchGroups.size === 0) {
@@ -838,7 +894,7 @@ export async function run(args) {
                     console.log("=".repeat(50));
                     while (true) {
                         await sleep(POLL_INTERVAL_MS);
-                        const { hasIncomplete: newItems } = createFilteredPrd(paths.prd, paths.dir, category);
+                        const { hasIncomplete: newItems } = createFilteredPrd(paths.prd, paths.dir, category, branchFilterActive, branchFilter);
                         if (newItems) {
                             console.log("\nNew incomplete item(s) detected! Resuming...");
                             break;
@@ -850,7 +906,7 @@ export async function run(args) {
                 else {
                     console.log("\n" + "=".repeat(50));
                     if (allMode) {
-                        const counts = countPrdItems(paths.prd, category);
+                        const counts = countPrdItems(paths.prd, category, branchFilterActive, branchFilter);
                         if (category) {
                             console.log(`PRD COMPLETE - All "${category}" tasks finished!`);
                         }
@@ -980,7 +1036,7 @@ export async function run(args) {
                         console.log(`\n\x1b[36m--- No-branch items (${noBranchItems.length} item(s)) ---\x1b[0m`);
                     }
                     // Create filtered PRD for no-branch items only (or all items if no branches exist)
-                    const { tempPath } = createFilteredPrd(paths.prd, paths.dir, category);
+                    const { tempPath } = createFilteredPrd(paths.prd, paths.dir, category, branchFilterActive, branchFilter);
                     filteredPrdPath = tempPath;
                     // If there are branch groups, rewrite prd-tasks.json to only include no-branch items
                     if (hasBranches) {
@@ -999,7 +1055,7 @@ export async function run(args) {
             validateAndRecoverPrd(paths.prd, validPrd);
             // Track progress for --all mode: stop if no progress after N iterations
             if (allMode) {
-                const progressCounts = countPrdItems(paths.prd, category);
+                const progressCounts = countPrdItems(paths.prd, category, branchFilterActive, branchFilter);
                 const tasksCompleted = progressCounts.complete > lastCompletedCount;
                 const tasksAdded = progressCounts.total > lastTotalCount;
                 if (tasksCompleted || tasksAdded) {
@@ -1060,7 +1116,7 @@ export async function run(args) {
             // so its COMPLETE signal means "this group is done", not "all PRD items are done".
             // We must verify the full PRD before treating this as a global completion.
             if (iterOutput.includes("<promise>COMPLETE</promise>")) {
-                const fullCounts = countPrdItems(paths.prd, category);
+                const fullCounts = countPrdItems(paths.prd, category, branchFilterActive, branchFilter);
                 if (fullCounts.incomplete > 0) {
                     // There are still incomplete items in other groups — continue the loop
                     if (debug) {
@@ -1074,7 +1130,7 @@ export async function run(args) {
                     console.log("=".repeat(50));
                     while (true) {
                         await sleep(POLL_INTERVAL_MS);
-                        const { hasIncomplete: newItems } = createFilteredPrd(paths.prd, paths.dir, category);
+                        const { hasIncomplete: newItems } = createFilteredPrd(paths.prd, paths.dir, category, branchFilterActive, branchFilter);
                         if (newItems) {
                             console.log("\nNew incomplete item(s) detected! Resuming...");
                             break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ralph-cli-sandboxed",
-  "version": "0.6.4",
+  "version": "0.6.5",
   "description": "AI-driven development automation CLI for Claude Code",
   "type": "module",
   "bin": {