@neriros/ralphy 2.13.7 → 2.13.10

package/README.md

@@ -82,12 +82,15 @@ ralph status --name fix-auth  # Detailed view of one task
 ```bash
 export LINEAR_API_KEY=lin_api_xxx
 ralph agent --linear-team ENG --linear-assignee me --concurrency 3 --poll-interval 60
+
+# Limit the number of tickets processed in this run
+ralph agent --max-tickets 5 --linear-team ENG --linear-assignee me
 ```
 
 What it does on each tick:
 
 1. Polls Linear for open issues matching the filter (team / assignee / status / labels)
-2. Dedupes against `.ralph/agent-state.json` (already processed) plus any in-flight workers
+2. Dedupes against in-flight workers and any already-active issues
 3. For each new issue: fetches existing comments, scaffolds `openspec/changes/<id-slug>/{proposal.md,tasks.md,design.md}` (with the comments embedded so the worker sees prior discussion), then spawns `ralph task --name <id-slug>` up to the concurrency cap
 4. Posts a "🤖 started" comment on the Linear issue and applies the `setInProgress` indicator (if configured)
 5. On worker exit, posts a success/failure comment and applies the `setDone` indicator on success or `setError` on failure (if configured)
@@ -196,11 +199,41 @@ Failed workers (non-zero exit) are not marked processed, so they'll be retried o
 | `--linear-assignee <id>`  | Filter by assignee (user id, email, or `me`)                                  |
 | `--poll-interval <s>`     | Seconds between Linear polls (default: 60)                                    |
 | `--concurrency <n>`       | Max concurrent task loops (default: 1)                                        |
+| `--max-tickets <n>`       | Stop picking up new issues after N have been started this run (0 = unlimited) |
 | `--worktree`              | Run each task in its own git worktree                                         |
 | `--indicator <k>:<t>:<v>` | Override a `linear.indicators` entry; repeatable (e.g. `setDone:status:Done`) |
 | `--create-pr`             | Push worker branch + open a GitHub PR on success (needs `--worktree`)         |
 | `--fix-ci`                | After PR opens, re-run task on CI failures until green (needs `--create-pr`)  |
 
+#### `--max-tickets`
+
+Use `--max-tickets N` to cap how many issues ralph picks up in a single agent run. Once N issues have been started (across fresh, resume, and conflict-fix modes), the coordinator stops enqueuing new work. In-flight workers continue to completion. The limit resets each time you restart `ralph agent`.
+
+```bash
+# Process at most 3 issues this session, then idle
+ralph agent --max-tickets 3 --linear-team ENG
+```
+
+When the limit is reached, ralph logs a yellow notice and the dashboard header shows `│ tickets ≤N`. Polling continues (to handle conflict re-fixes on already-started issues), but no new issues are queued.
+
+#### Dashboard
+
+The `ralph agent` terminal dashboard shows a full-terminal layout with three always-visible panels:
+
+- **RALPH AGENT** (blue box): engine/model, concurrency, poll interval, active limits (`iter ≤N`, `cost ≤$N`, `tickets ≤N`), feature flags (● PR ● fixCI ● worktree), and the Linear filter on the second line
+- **POLL STATUS + WORKERS** (side-by-side): last-poll counts and next-poll countdown; active/queued worker totals with colored counts
+- **TASKS tab bar** (when multiple workers run): numbered worker tabs with priority glyph and phase — Tab/← → to switch, 1-9 to jump
+
+Each worker card shows:
+
+- Priority badge (`▲ URGENT` / `↑ HIGH` / `· MED` / `↓ LOW`) + issue identifier + title + mode badge (`[NEW]` / `[RESUME]` / `[FIX]`)
+- `↗ LINEAR  ISSUE-ID` and `↗ PR  #N` (short labels, not full URLs)
+- `▶ 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`
+- `─ OUTPUT ─` section with live stdout/stderr (scales to fill remaining terminal height for the focused worker)
+
 ## OpenSpec Flow
 
 There are no phases. One loop, one prompt, one `tasks.md` checklist.

package/dist/cli/index.js

@@ -48157,10 +48157,10 @@ var require_axios = __commonJS((exports, module) => {
       this.__CANCEL__ = true;
     }
   }
-  function settle(resolve, reject2, response) {
+  function settle(resolve2, reject2, response) {
     const validateStatus = response.config.validateStatus;
     if (!response.status || !validateStatus || validateStatus(response.status)) {
-      resolve(response);
+      resolve2(response);
     } else {
       reject2(new AxiosError("Request failed with status code " + response.status, response.status >= 400 && response.status < 500 ? AxiosError.ERR_BAD_REQUEST : AxiosError.ERR_BAD_RESPONSE, response.config, response.request, response));
     }
@@ -49013,7 +49013,7 @@ var require_axios = __commonJS((exports, module) => {
   }
   var isHttpAdapterSupported = typeof process !== "undefined" && utils$1.kindOf(process) === "process";
   var wrapAsync = (asyncExecutor) => {
-    return new Promise((resolve, reject2) => {
+    return new Promise((resolve2, reject2) => {
       let onDone;
       let isDone;
       const done = (value, isRejected) => {
@@ -49024,7 +49024,7 @@ var require_axios = __commonJS((exports, module) => {
       };
       const _resolve = (value) => {
         done(value);
-        resolve(value);
+        resolve2(value);
       };
       const _reject = (reason) => {
         done(reason, true);
@@ -49085,7 +49085,7 @@ var require_axios = __commonJS((exports, module) => {
     }
   };
   var httpAdapter = isHttpAdapterSupported && function httpAdapter2(config) {
-    return wrapAsync(async function dispatchHttpRequest(resolve, reject2, onDone) {
+    return wrapAsync(async function dispatchHttpRequest(resolve2, reject2, onDone) {
       const own2 = (key) => utils$1.hasOwnProp(config, key) ? config[key] : undefined;
       let data = own2("data");
       let lookup = own2("lookup");
@@ -49193,7 +49193,7 @@ var require_axios = __commonJS((exports, module) => {
         }
         let convertedData;
         if (method2 !== "GET") {
-          return settle(resolve, reject2, {
+          return settle(resolve2, reject2, {
             status: 405,
             statusText: "method not allowed",
             headers: {},
@@ -49215,7 +49215,7 @@ var require_axios = __commonJS((exports, module) => {
         } else if (responseType === "stream") {
           convertedData = stream.Readable.from(convertedData);
         }
-        return settle(resolve, reject2, {
+        return settle(resolve2, reject2, {
           data: convertedData,
           status: 200,
           statusText: "OK",
@@ -49442,7 +49442,7 @@ var require_axios = __commonJS((exports, module) => {
             });
           }
           response.data = responseStream;
-          settle(resolve, reject2, response);
+          settle(resolve2, reject2, response);
         } else {
           const responseBuffer = [];
           let totalResponseBytes = 0;
@@ -49481,7 +49481,7 @@ var require_axios = __commonJS((exports, module) => {
             } catch (err) {
               return reject2(AxiosError.from(err, null, config, response.request, response));
             }
-            settle(resolve, reject2, response);
+            settle(resolve2, reject2, response);
           });
         }
         abortEmitter.once("abort", (err) => {
@@ -49782,7 +49782,7 @@ var require_axios = __commonJS((exports, module) => {
   };
   var isXHRAdapterSupported = typeof XMLHttpRequest !== "undefined";
   var xhrAdapter = isXHRAdapterSupported && function(config) {
-    return new Promise(function dispatchXhrRequest(resolve, reject2) {
+    return new Promise(function dispatchXhrRequest(resolve2, reject2) {
       const _config = resolveConfig(config);
       let requestData = _config.data;
       const requestHeaders = AxiosHeaders.from(_config.headers).normalize();
@@ -49818,7 +49818,7 @@ var require_axios = __commonJS((exports, module) => {
           request
         };
         settle(function _resolve(value) {
-          resolve(value);
+          resolve2(value);
           done();
         }, function _reject(err) {
           reject2(err);
@@ -50247,8 +50247,8 @@ var require_axios = __commonJS((exports, module) => {
           }
         }
         !isStreamResponse && unsubscribe && unsubscribe();
-        return await new Promise((resolve, reject2) => {
-          settle(resolve, reject2, {
+        return await new Promise((resolve2, reject2) => {
+          settle(resolve2, reject2, {
             data: responseData,
             headers: AxiosHeaders.from(response.headers),
             status: response.status,
@@ -50640,8 +50640,8 @@ var require_axios = __commonJS((exports, module) => {
         throw new TypeError("executor must be a function.");
       }
       let resolvePromise;
-      this.promise = new Promise(function promiseExecutor(resolve) {
-        resolvePromise = resolve;
+      this.promise = new Promise(function promiseExecutor(resolve2) {
+        resolvePromise = resolve2;
       });
       const token = this;
       this.promise.then((cancel) => {
@@ -50655,9 +50655,9 @@ var require_axios = __commonJS((exports, module) => {
       });
       this.promise.then = (onfulfilled) => {
         let _resolve;
-        const promise = new Promise((resolve) => {
-          token.subscribe(resolve);
-          _resolve = resolve;
+        const promise = new Promise((resolve2) => {
+          token.subscribe(resolve2);
+          _resolve = resolve2;
         }).then(onfulfilled);
         promise.cancel = function reject2() {
           token.unsubscribe(_resolve);
@@ -50837,7 +50837,7 @@ var require_axios = __commonJS((exports, module) => {
 });
 
 // apps/cli/src/index.ts
-import { resolve, join as join19, dirname as dirname5 } from "path";
+import { resolve as resolve2, join as join19, dirname as dirname5 } from "path";
 import { exists as exists2, mkdir as mkdir5, rm } from "fs/promises";
 
 // node_modules/.bun/ink@5.2.1+1f88f629f0141b18/node_modules/ink/build/render.js
@@ -56406,102 +56406,36 @@ function styled(text, style) {
 function log(msg) {
   console.log(typeof msg === "string" ? msg : format(msg));
 }
-// package.json
-var package_default = {
-  name: "@neriros/ralphy",
-  version: "2.13.7",
-  description: "An iterative AI task execution framework. Orchestrates multi-phase autonomous work using Claude or Codex engines.",
-  keywords: [
-    "agent",
-    "ai",
-    "claude",
-    "cli",
-    "loop",
-    "mcp",
-    "ralph",
-    "task-runner"
-  ],
-  license: "MIT",
-  repository: {
-    type: "git",
-    url: "https://github.com/NeriRos/ralphy.git"
-  },
-  bin: {
-    ralphy: "./dist/cli/index.js",
-    "ralphy-mcp": "./dist/mcp/index.js"
-  },
-  workspaces: [
-    "packages/*",
-    "apps/*",
-    "tools/generators/*"
-  ],
-  files: [
-    "dist/cli/index.js",
-    "dist/mcp/index.js",
-    "README.md"
-  ],
-  type: "module",
-  scripts: {
-    ralph: "bun .ralph/bin/cli.js",
-    lint: "oxlint --config .oxlintrc.json .",
-    "lint:fix": "oxlint --config .oxlintrc.json --fix .",
-    fmt: "oxfmt --write .",
-    "fmt:check": "oxfmt --check .",
-    typecheck: "nx affected -t typecheck",
-    "check:deps": "depcruise packages/*/src apps/*/src --config .dependency-cruiser.cjs",
-    "check:unused": "knip",
-    "lint:ci": "nx affected -t lint --exclude=ui",
-    "fmt:ci": "nx affected -t fmt:check --exclude=ui",
-    "typecheck:ci": "nx affected -t typecheck --parallel=1 --exclude=ui",
-    "test:ci": "nx affected -t test --exclude=ui",
-    "test:affected-files:coverage:ci": "bun scripts/bun-test-affected-files.ts --coverage",
-    "test:coverage:ci": "nx affected -t test:coverage --exclude=ui",
-    "build:ci": "nx affected -t build --exclude=ui",
-    "check:circular:ci": "depcruise packages/*/src apps/*/src --config .dependency-cruiser.cjs",
-    "check:unused:ci": "knip",
-    "check:outdated:ci": "bun scripts/check-outdated.ts",
-    prepare: "bunx husky",
-    "build:publish": "bunx nx run-many --target=build --projects=cli,mcp --output-style stream && bun run copy-assets",
-    "copy-assets": "bun scripts/copy-assets.ts",
-    prepublishOnly: "bun run build:publish"
-  },
-  devDependencies: {
-    "@commitlint/cli": "^20.4.3",
-    "@commitlint/config-conventional": "^20.4.3",
-    "@fission-ai/openspec": "latest",
-    "@modelcontextprotocol/sdk": "^1.12.0",
-    "@nx/devkit": "^22.7.1",
-    "@nx/js": "^22.7.1",
-    "@secretlint/secretlint-rule-preset-recommend": "^11.3.1",
-    "@swc-node/register": "^1.11.1",
-    "@swc/core": "^1.15.18",
-    "@total-typescript/ts-reset": "^0.6.1",
-    "@types/node": "^22.0.0",
-    "bun-types": "^1.3.0",
-    chalk: "^5.4.0",
-    "dependency-cruiser": "^17.3.8",
-    husky: "^9.1.7",
-    knip: "^5.85.0",
-    "lint-staged": "^16.3.2",
-    nx: "22.5.3",
-    "oxc-parser": "^0.126.0",
-    oxfmt: "^0.36.0",
-    oxlint: "^1.51.0",
-    secretlint: "^11.3.1",
-    typescript: "^5.8.0",
-    zod: "^3.24.0"
-  },
-  overrides: {
-    axios: "^1.15.1",
-    minimatch: "^10.2.3"
-  },
-  engines: {
-    bun: ">=1.0.0"
-  }
-};
 
 // apps/cli/src/cli.ts
-var VERSION = package_default.version;
+import { readFileSync as readFileSync2 } from "fs";
+import { resolve } from "path";
+function getVersion() {
+  const dirsToTry = [];
+  try {
+    const cliDir = import.meta.dir;
+    dirsToTry.push(cliDir);
+  } catch {}
+  dirsToTry.push(process.cwd());
+  for (const startDir of dirsToTry) {
+    let current = startDir;
+    for (let i = 0;i < 10; i++) {
+      const pkgPath = resolve(current, "package.json");
+      try {
+        const pkg = JSON.parse(readFileSync2(pkgPath, "utf-8"));
+        if (pkg.workspaces && pkg.version && pkg.version !== "0.0.0") {
+          return pkg.version;
+        }
+      } catch {}
+      const parent = resolve(current, "..");
+      if (parent === current)
+        break;
+      current = parent;
+    }
+  }
+  return "unknown";
+}
+var VERSION = getVersion();
 var VALID_MODES = new Set(["task", "list", "status", "init", "agent", "clean"]);
 var VALID_MODELS = new Set(["haiku", "sonnet", "opus"]);
 var INDICATOR_KEYS = new Set([
@@ -56541,6 +56475,7 @@ var HELP_TEXT = [
   "  --max-runtime <n>       Stop after N minutes of wall-clock time (0 = no limit)",
   "  --max-failures <n>      Stop after N consecutive failures (default: 5, 0 = disable)",
   "  --unlimited             No iteration limit (default)",
+  "  --manual-test           Enable manual testing phase (create test tasks in tasks.md)",
   "  --log                   Log raw engine stream",
   "  --verbose               Verbose output",
   "",
@@ -56559,6 +56494,7 @@ var HELP_TEXT = [
   "                          Types: label, status",
   "  --create-pr             Push the worker branch and open a GitHub PR on success (needs --worktree)",
   "  --fix-ci                After opening the PR, re-run on CI failures until green (needs --create-pr)",
+  "  --max-tickets <n>       Stop picking up new issues after N have been started (0 = unlimited)",
   "",
   "  --help, -h              Show this help message",
   "",
@@ -56636,6 +56572,7 @@ async function parseArgs(argv) {
     delay: 0,
     log: false,
     verbose: false,
+    manualTest: false,
     linearTeam: "",
     linearAssignee: "",
     pollInterval: 60,
@@ -56643,7 +56580,8 @@ async function parseArgs(argv) {
     worktree: false,
     indicators: {},
     createPr: false,
-    fixCi: false
+    fixCi: false,
+    maxTickets: 0
   };
   let expectModel = false;
   let expectModelFlag = false;
@@ -56659,6 +56597,7 @@ async function parseArgs(argv) {
   let expectLinearAssignee = false;
   let expectPollInterval = false;
   let expectConcurrency = false;
+  let expectMaxTickets = false;
   let expectIndicator = false;
   for (const arg of argv) {
     if (expectModel) {
@@ -56737,6 +56676,11 @@ async function parseArgs(argv) {
       expectConcurrency = false;
       continue;
     }
+    if (expectMaxTickets) {
+      result2.maxTickets = parseInt(arg, 10);
+      expectMaxTickets = false;
+      continue;
+    }
     if (expectIndicator) {
       const { key, marker } = parseIndicatorArg(arg);
       mergeIndicator(result2.indicators, key, marker);
@@ -56807,6 +56751,9 @@ async function parseArgs(argv) {
       case "--concurrency":
         expectConcurrency = true;
         break;
+      case "--max-tickets":
+        expectMaxTickets = true;
+        break;
       case "--worktree":
         result2.worktree = true;
         break;
@@ -56819,6 +56766,9 @@ async function parseArgs(argv) {
       case "--fix-ci":
         result2.fixCi = true;
         break;
+      case "--manual-test":
+        result2.manualTest = true;
+        break;
       default:
         if (VALID_MODES.has(arg)) {
           result2.mode = arg;
@@ -56834,7 +56784,7 @@ async function parseArgs(argv) {
 // packages/context/src/context.ts
 import { AsyncLocalStorage } from "async_hooks";
 import {
-  readFileSync as readFileSync2,
+  readFileSync as readFileSync3,
   writeFileSync,
   existsSync as existsSync2,
   unlinkSync,
@@ -56847,7 +56797,7 @@ class FileSystemProvider {
   read(path) {
     if (!existsSync2(path))
       return null;
-    return readFileSync2(path, "utf-8");
+    return readFileSync3(path, "utf-8");
   }
   write(path, content) {
     mkdirSync(dirname(path), { recursive: true });
@@ -60907,6 +60857,7 @@ var StateSchema = exports_external.object({
   lastModified: exports_external.string(),
   engine: exports_external.enum(["claude", "codex"]).default("claude"),
   model: exports_external.string().default("opus"),
+  manualTest: exports_external.boolean().default(false),
   usage: UsageSchema.default({}),
   history: exports_external.array(HistoryEntrySchema).default([]),
   metadata: exports_external.object({ branch: exports_external.string().optional() }).default({})
@@ -60981,6 +60932,7 @@ function buildInitialState(options) {
     prompt: options.prompt,
     engine: options.engine ?? "claude",
     model: options.model ?? "opus",
+    manualTest: options.manualTest ?? false,
     createdAt: now2,
     lastModified: now2,
     metadata: { branch }
@@ -65738,10 +65690,10 @@ async function runEngine(opts) {
       rawWriter.write(line + `
 `);
   };
-  const closeRaw = () => new Promise((resolve) => {
+  const closeRaw = () => new Promise((resolve2) => {
     if (!rawWriter)
-      return resolve();
-    rawWriter.end(resolve);
+      return resolve2();
+    rawWriter.end(resolve2);
   });
   const emit = opts.onFeedEvent;
   function emitEvent(event) {
@@ -66567,14 +66519,14 @@ async function addSourceContext(frames) {
   return frames;
 }
 function getContextLinesFromFile(path, ranges, output) {
-  return new Promise((resolve) => {
+  return new Promise((resolve2) => {
     const stream = createReadStream(path);
     const lineReaded = createInterface({
       input: stream
     });
     function destroyStreamAndResolve() {
       stream.destroy();
-      resolve();
+      resolve2();
     }
     let lineNumber = 0;
     let currentRangeIndex = 0;
@@ -69106,15 +69058,15 @@ class PostHogBackendClient extends PostHogCoreStateless {
     if (this.featureFlagsPoller === undefined) {
       return false;
     }
-    return new Promise((resolve) => {
+    return new Promise((resolve2) => {
       const timeout = setTimeout(() => {
         cleanup();
-        resolve(false);
+        resolve2(false);
       }, timeoutMs);
       const cleanup = this._events.on("localEvaluationFlagsLoaded", (count) => {
         clearTimeout(timeout);
         cleanup();
-        resolve(count > 0);
+        resolve2(count > 0);
       });
     });
   }
@@ -69601,6 +69553,34 @@ function buildTaskPrompt(state, taskDir) {
 
 `;
   }
+  if (state.manualTest) {
+    const tasksContent2 = storage.read(join7(taskDir, "tasks.md"));
+    const hasUncheckedTasks = tasksContent2 !== null && /^- \[ \]/m.test(tasksContent2);
+    if (!hasUncheckedTasks) {
+      const hasManualTestSection = tasksContent2 !== null && /^## Manual Testing/m.test(tasksContent2);
+      if (!hasManualTestSection) {
+        prompt += `---
+
+## Manual Testing Phase
+
+`;
+        prompt += `All primary implementation tasks are complete. Now create manual test tasks.
+
+`;
+        prompt += `1. Analyze the specification and implementation
+`;
+        prompt += `2. Identify critical manual test scenarios (UI interactions, edge cases, user workflows, integration testing)
+`;
+        prompt += "3. Add a `## Manual Testing` section to tasks.md with test items as `- [ ] Test scenario description`\n";
+        prompt += `4. Complete each test and check it off when done
+
+`;
+        prompt += `---
+
+`;
+      }
+    }
+  }
   prompt += `Change name: \`${state.name}\`
 
 `;
@@ -69718,7 +69698,7 @@ function mergeUsage(base2, resumed) {
 }
 // apps/cli/src/hooks/useLoop.ts
 function sleep(seconds) {
-  return new Promise((resolve) => setTimeout(resolve, seconds * 1000));
+  return new Promise((resolve2) => setTimeout(resolve2, seconds * 1000));
 }
 function useLoop(opts) {
   const [state, setState] = import_react55.useState(null);
@@ -69772,7 +69752,8 @@ function useLoop(opts) {
           name: opts.name,
           prompt: opts.prompt,
           engine: opts.engine,
-          model: opts.model
+          model: opts.model,
+          manualTest: opts.manualTest
         });
         writeState(stateDir, currentState);
       }
@@ -70177,6 +70158,7 @@ var RalphyConfigSchema = exports_external.object({
   iterationDelaySeconds: exports_external.number().int().nonnegative().default(0),
   logRawStream: exports_external.boolean().default(false),
   taskVerbose: exports_external.boolean().default(false),
+  enableManualTest: exports_external.boolean().default(false),
   useWorktree: exports_external.boolean().default(false),
   cleanupWorktreeOnSuccess: exports_external.boolean().default(false),
   setupScript: exports_external.string().optional(),
@@ -70201,6 +70183,7 @@ var RalphyConfigSchema = exports_external.object({
   pollIntervalSeconds: 60,
   maxIterationsPerTask: 0,
   maxCostUsdPerTask: 0,
+  enableManualTest: false,
   engine: "claude",
   model: "opus",
   linear: { postComments: true, updateEveryIterations: 10, indicators: {} }
@@ -70401,10 +70384,8 @@ function buildIssueFilter(spec) {
       branches.push({ state: { name: { in: statuses } } });
     if (labels.length > 0)
       branches.push({ labels: { some: { name: { in: labels } } } });
-    if (branches.length === 1)
-      Object.assign(where, branches[0]);
-    else
-      where.or = branches;
+    for (const b of branches)
+      Object.assign(where, b);
   } else {
     where.state = { type: { in: ["unstarted", "started", "backlog"] } };
   }
@@ -70562,6 +70543,7 @@ class AgentCoordinator {
   queue = [];
   stopped = false;
   conflictNotified = new Set;
+  ticketsStarted = 0;
   constructor(deps, opts) {
     this.deps = deps;
     this.opts = opts;
@@ -70575,6 +70557,9 @@ class AgentCoordinator {
   get activeWorkers() {
     return this.workers;
   }
+  get ticketsStartedCount() {
+    return this.ticketsStarted;
+  }
   async init() {}
   async pollOnce() {
     if (this.stopped)
@@ -70596,8 +70581,17 @@ class AgentCoordinator {
     const queuedIds = new Set(this.queue.map((q) => q.issue.id));
     const activeIds = new Set(this.workers.map((w) => w.issueId));
     const eligible = (id) => !queuedIds.has(id) && !activeIds.has(id) && !this.pendingIds.has(id);
+    const maxT = this.opts.maxTickets ?? 0;
+    const atTicketLimit = () => {
+      if (maxT === 0)
+        return false;
+      const inFlight = this.ticketsStarted + this.queue.length + this.workers.length + this.pendingIds.size;
+      return inFlight >= maxT;
+    };
     let added = 0;
     for (const issue of inProgress) {
+      if (atTicketLimit())
+        break;
       if (!eligible(issue.id))
         continue;
       if (!this.dependenciesResolved(issue))
@@ -70607,6 +70601,8 @@ class AgentCoordinator {
       added += 1;
     }
     for (const issue of conflicted) {
+      if (atTicketLimit())
+        break;
       if (!eligible(issue.id))
         continue;
       this.queue.push({ issue, mode: "conflict-fix" });
@@ -70614,6 +70610,8 @@ class AgentCoordinator {
       added += 1;
     }
     for (const issue of todo) {
+      if (atTicketLimit())
+        break;
       if (!eligible(issue.id))
         continue;
       if (!this.dependenciesResolved(issue))
@@ -70808,6 +70806,11 @@ class AgentCoordinator {
     };
     this.workers.push(worker);
     this.pendingIds.delete(issue.id);
+    this.ticketsStarted += 1;
+    const maxT = this.opts.maxTickets ?? 0;
+    if (maxT > 0 && this.ticketsStarted >= maxT) {
+      this.deps.onLog(`  ticket limit reached (${maxT}) \u2014 no new issues will be picked up`, "yellow");
+    }
     capture("agent_worker_spawned", {
       spawn_mode: mode,
       issue_identifier: issue.identifier
@@ -71829,6 +71832,8 @@ PR: ${prUrl}` : ""
       c.push("--log");
     if (args.verbose || cfg.taskVerbose)
       c.push("--verbose");
+    if (args.manualTest || cfg.enableManualTest)
+      c.push("--manual-test");
     return c;
   }
   function defaultSpawn(changeName, cmd, cwd2, note) {
@@ -72054,7 +72059,8 @@ PR: ${prUrl}` : ""
     ...indicators.setConflicted !== undefined ? { setConflicted: indicators.setConflicted } : {},
     ...indicators.clearConflicted !== undefined ? { clearConflicted: indicators.clearConflicted } : {},
     postComments: cfg.linear.postComments,
-    commentEveryIterations: cfg.linear.updateEveryIterations
+    commentEveryIterations: cfg.linear.updateEveryIterations,
+    ...args.maxTickets > 0 ? { maxTickets: args.maxTickets } : {}
   });
   const filterDesc = describeIndicators(indicators, team, assignee);
   return {
@@ -72496,6 +72502,13 @@ function AgentMode({ args, projectRoot, statesDir, tasksDir }) {
                           cfg.maxCostUsdPerTask
                         ]
                       }, undefined, true, undefined, this),
+                      args.maxTickets > 0 && /* @__PURE__ */ jsx_dev_runtime9.jsxDEV(Text, {
+                        color: "yellow",
+                        children: [
+                          " \u2502 tickets \u2264",
+                          args.maxTickets
+                        ]
+                      }, undefined, true, undefined, this),
                       cfg.createPrOnSuccess && /* @__PURE__ */ jsx_dev_runtime9.jsxDEV(Text, {
                         color: "green",
                         children: " \u25CF PR"
@@ -73152,6 +73165,41 @@ function ErrorMessage({ message }) {
     children: message
   }, undefined, false, undefined, this);
 }
+function TaskModeWrapper({ args, statesDir, tasksDir, projectRoot }) {
+  const [config, setConfig] = import_react58.useState(null);
+  const [error, setError] = import_react58.useState(null);
+  import_react58.useEffect(() => {
+    loadRalphyConfig(projectRoot).then((cfg) => setConfig({ manualTest: cfg.enableManualTest })).catch((err) => setError(err.message));
+  }, [projectRoot]);
+  if (error) {
+    return /* @__PURE__ */ jsx_dev_runtime10.jsxDEV(ErrorMessage, {
+      message: `Error loading config: ${error}`
+    }, undefined, false, undefined, this);
+  }
+  if (!config) {
+    return /* @__PURE__ */ jsx_dev_runtime10.jsxDEV(Text, {}, undefined, false, undefined, this);
+  }
+  const manualTest = args.manualTest || config.manualTest;
+  return /* @__PURE__ */ jsx_dev_runtime10.jsxDEV(TaskLoop, {
+    opts: {
+      name: args.name,
+      prompt: args.prompt,
+      engine: args.engine,
+      model: args.model,
+      maxIterations: args.maxIterations,
+      maxCostUsd: args.maxCostUsd,
+      maxRuntimeMinutes: args.maxRuntimeMinutes,
+      maxConsecutiveFailures: args.maxConsecutiveFailures,
+      delay: args.delay,
+      log: args.log,
+      verbose: args.verbose,
+      manualTest,
+      statesDir,
+      tasksDir,
+      changeStore: new OpenSpecChangeStore
+    }
+  }, undefined, false, undefined, this);
+}
 function App2({ args, statesDir, tasksDir, projectRoot }) {
   switch (args.mode) {
     case "list":
@@ -73203,23 +73251,11 @@ function App2({ args, statesDir, tasksDir, projectRoot }) {
           message: "Error: --name is required for task mode"
         }, undefined, false, undefined, this);
       }
-      return /* @__PURE__ */ jsx_dev_runtime10.jsxDEV(TaskLoop, {
-        opts: {
-          name: args.name,
-          prompt: args.prompt,
-          engine: args.engine,
-          model: args.model,
-          maxIterations: args.maxIterations,
-          maxCostUsd: args.maxCostUsd,
-          maxRuntimeMinutes: args.maxRuntimeMinutes,
-          maxConsecutiveFailures: args.maxConsecutiveFailures,
-          delay: args.delay,
-          log: args.log,
-          verbose: args.verbose,
-          statesDir,
-          tasksDir,
-          changeStore: new OpenSpecChangeStore
-        }
+      return /* @__PURE__ */ jsx_dev_runtime10.jsxDEV(TaskModeWrapper, {
+        args,
+        statesDir,
+        tasksDir,
+        projectRoot
       }, undefined, false, undefined, this);
     }
   }
@@ -73236,7 +73272,7 @@ async function findProjectRoot() {
   while (dir !== "/") {
     if (await exists2(join19(dir, "openspec")))
       return dir;
-    dir = resolve(dir, "..");
+    dir = resolve2(dir, "..");
   }
   return process.cwd();
 }

package/dist/mcp/index.js

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

package/package.json

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