@neriros/ralphy 3.10.7 → 3.10.9

package/dist/shell/index.js

@@ -18928,8 +18928,8 @@ import { readFileSync } from "fs";
 import { resolve } from "path";
 function getVersion() {
   try {
-    if ("3.10.7")
-      return "3.10.7";
+    if ("3.10.9")
+      return "3.10.9";
   } catch {}
   const dirsToTry = [];
   try {
@@ -80519,7 +80519,7 @@ function foldLegacyAssignee(v) {
   }
   return rest2;
 }
-var CURRENT_WORKFLOW_VERSION = 3, MarkerSchema, SET_INDICATOR_KEYS, GetIndicatorSchema, SetIndicatorSchema, IndicatorsSchema, ProjectSchema, CommandsSchema, DEFAULT_META_ONLY_FILES, BoundariesSchema, WorkflowConfigSchema;
+var CURRENT_WORKFLOW_VERSION = 4, MarkerSchema, SET_INDICATOR_KEYS, GetIndicatorSchema, SetIndicatorSchema, IndicatorsSchema, ProjectSchema, CommandsSchema, DEFAULT_META_ONLY_FILES, BoundariesSchema, WorkflowConfigSchema;
 var init_schema = __esm(() => {
   init_zod();
   MarkerSchema = exports_external.discriminatedUnion("type", [
@@ -80533,7 +80533,13 @@ var init_schema = __esm(() => {
     exports_external.object({ type: exports_external.literal("project"), value: exports_external.string().min(1) }).strict(),
     exports_external.object({ type: exports_external.literal("comment"), value: exports_external.string().min(1) }).strict()
   ]);
-  SET_INDICATOR_KEYS = ["setInProgress", "setDone", "setError", "clearApproved"];
+  SET_INDICATOR_KEYS = [
+    "setInProgress",
+    "setDone",
+    "setPrReady",
+    "setError",
+    "clearApproved"
+  ];
   GetIndicatorSchema = exports_external.object({
     filter: exports_external.array(MarkerSchema).default([])
   });
@@ -80547,6 +80553,7 @@ var init_schema = __esm(() => {
     getAutoApprove: GetIndicatorSchema.optional(),
     setInProgress: SetIndicatorSchema.optional(),
     setDone: SetIndicatorSchema.optional(),
+    setPrReady: SetIndicatorSchema.optional(),
     setError: SetIndicatorSchema.optional(),
     setAwaitingConfirmation: SetIndicatorSchema.optional(),
     clearApproved: SetIndicatorSchema.optional(),
@@ -80851,6 +80858,9 @@ linear:
     # setDone:           # status/label to set when the PR is opened
     #   type: status
     #   value: In Review
+    # setPrReady:        # additive: marker set when the PR is ready for human review
+    #   type: status     # (fires unless the PR is auto-merged immediately; does not replace setDone)
+    #   value: In Review
     # setError:          # label applied when a task is quarantined
     #   type: label
     #   value: "ralph:error"
@@ -81896,11 +81906,11 @@ function applyAliases(cfg) {
     }
   }
 }
-function workflowPath(projectRoot) {
-  return join5(projectRoot, WORKFLOW_FILE);
+function workflowPath(projectRoot, workflowFile) {
+  return workflowFile ?? join5(projectRoot, WORKFLOW_FILE);
 }
-async function loadWorkflow(projectRoot) {
-  const path = workflowPath(projectRoot);
+async function loadWorkflow(projectRoot, workflowFile) {
+  const path = workflowPath(projectRoot, workflowFile);
   const file2 = Bun.file(path);
   if (!await file2.exists()) {
     const { config: config2 } = parseWorkflow(DEFAULT_WORKFLOW_MD);
@@ -81909,8 +81919,8 @@ async function loadWorkflow(projectRoot) {
   const text = await file2.text();
   return parseWorkflow(text, path);
 }
-async function ensureWorkflow(projectRoot) {
-  const path = workflowPath(projectRoot);
+async function ensureWorkflow(projectRoot, workflowFile) {
+  const path = workflowPath(projectRoot, workflowFile);
   const file2 = Bun.file(path);
   if (await file2.exists())
     return path;
@@ -83953,6 +83963,12 @@ var init_SetupWizard = __esm(async () => {
       description: "Set when the task finishes and its pull request is opened.",
       slots: ["setDone"]
     },
+    {
+      key: "prReady",
+      label: "PR ready",
+      description: "Optional, additive: set when the PR is marked ready for human review (non-draft), layered on top of Done. Skipped only on the immediate non-draft auto-merge path.",
+      slots: ["setPrReady"]
+    },
     {
       key: "error",
       label: "Error",
@@ -84041,6 +84057,11 @@ var init_migrations = __esm(() => {
       version: 3,
       description: "The per-workflow `linear.assignee` setting is replaced by a global " + "`linear.filter` expression (e.g. `assignee = me`) applied to every " + "ticket fetch. Existing `assignee` values are folded in automatically; " + "note that an empty filter now defaults to `assignee = me` (it previously " + "meant unassigned-only).",
       fields: ["linear.filter"]
+    },
+    {
+      version: 4,
+      description: "A new additive `setPrReady` Linear indicator marks a ticket the moment its " + "PR is human-mergeable (ready, non-draft), layered on top of `setDone`. " + "Re-run the indicator builder to add it, or keep your current indicators.",
+      fields: ["linear.indicators"]
     }
   ];
   LATEST_MIGRATION_VERSION = MIGRATIONS.reduce((max2, migration) => Math.max(max2, migration.version), 0);
@@ -84341,6 +84362,12 @@ function getLayout() {
     throw new Error("No layout in context. Set layout when calling runWithContext().");
   return ctx.layout;
 }
+function getArgs() {
+  const ctx = getContext();
+  if (!ctx.args)
+    throw new Error("No args in context. Set args when calling runWithContext().");
+  return ctx.args;
+}
 function runWithContext(ctx, fn) {
   return contextStore.run(ctx, fn);
 }
@@ -84691,6 +84718,7 @@ var init_output2 = __esm(() => {
 });
 
 // packages/cli-args/src/common-args.ts
+import { resolve as resolve3 } from "path";
 function initialCommonArgs() {
   return {
     engine: "claude",
@@ -84704,6 +84732,7 @@ function initialCommonArgs() {
     log: false,
     verbose: false,
     projectRoot: undefined,
+    workflowFile: undefined,
     name: "",
     prompt: "",
     fromAgent: false
@@ -84726,6 +84755,7 @@ function emptyParseState() {
     pendingOption: null,
     expectClaudeModel: false,
     expectProjectRoot: false,
+    expectWorkflow: false,
     expectName: false,
     expectPrompt: false,
     expectPromptFile: false,
@@ -84750,6 +84780,11 @@ function parseCommonArg(arg, args, state) {
     state.expectProjectRoot = false;
     return true;
   }
+  if (state.expectWorkflow) {
+    args.workflowFile = resolve3(arg);
+    state.expectWorkflow = false;
+    return true;
+  }
   if (state.expectName) {
     args.name = arg;
     state.expectName = false;
@@ -84796,6 +84831,9 @@ function parseCommonArg(arg, args, state) {
     case "--project-root":
       state.expectProjectRoot = true;
       return true;
+    case "--workflow":
+      state.expectWorkflow = true;
+      return true;
     case "--name":
       state.expectName = true;
       return true;
@@ -84945,6 +84983,7 @@ var init_cli = __esm(() => {
     "",
     "Options:",
     "  --name <name>           Change name (required for most commands)",
+    "  --workflow <path>       Path to an alternate WORKFLOW.md (default: <project>/WORKFLOW.md)",
     "  --prompt <text>         Task description",
     "  --prompt-file <path>    Read prompt from file",
     "  --model <model>         Set model (haiku|sonnet|opus)",
@@ -85028,6 +85067,7 @@ var init_task_cli = __esm(() => {
     "",
     "Options:",
     "  --name <name>           Change name (required)",
+    "  --workflow <path>       Path to an alternate WORKFLOW.md (default: <project>/WORKFLOW.md)",
     "  --prompt <text>         Task description",
     "  --prompt-file <path>    Read prompt from file",
     "  --model <model>         Set model (haiku|sonnet|opus)",
@@ -97361,10 +97401,10 @@ var require_xstate_development_cjs = __commonJS((exports) => {
     }
   }
   function toPromise(actor) {
-    return new Promise((resolve3, reject2) => {
+    return new Promise((resolve4, reject2) => {
       actor.subscribe({
         complete: () => {
-          resolve3(actor.getSnapshot().output);
+          resolve4(actor.getSnapshot().output);
         },
         error: reject2
       });
@@ -98795,10 +98835,10 @@ async function runEngine(opts) {
     await mkdir4(dirname6(opts.logFile), { recursive: true });
     rawWriter = createWriteStream(opts.logFile, { flags: "a" });
   }
-  const closeRaw = () => new Promise((resolve3) => {
+  const closeRaw = () => new Promise((resolve4) => {
     if (!rawWriter)
-      return resolve3();
-    rawWriter.end(resolve3);
+      return resolve4();
+    rawWriter.end(resolve4);
   });
   const userOnFeedEvent = opts.onFeedEvent;
   const onFeedEvent = (event) => {
@@ -98942,8 +98982,8 @@ var init_flow_machine = __esm(() => {
       } catch {}
       const exited = await Promise.race([
         worker.exited.then(() => "exited"),
-        new Promise((resolve3) => {
-          const t = setTimeout(() => resolve3("timeout"), graceMs);
+        new Promise((resolve4) => {
+          const t = setTimeout(() => resolve4("timeout"), graceMs);
           t.unref();
         })
       ]);
@@ -100117,7 +100157,7 @@ var init_loop2 = __esm(() => {
 // apps/loop/src/hooks/useLoop.ts
 import { join as join15 } from "path";
 function sleep(seconds) {
-  return new Promise((resolve3) => setTimeout(resolve3, seconds * 1000));
+  return new Promise((resolve4) => setTimeout(resolve4, seconds * 1000));
 }
 function useLoop(opts) {
   const outerLayoutRef = import_react57.useRef(null);
@@ -101289,6 +101329,8 @@ async function runDebug(opts) {
     out("  \u26A0 setError applied \u2014 issue is quarantined in Linear");
   if (logHas("setDone applied"))
     out("  \u2713 setDone applied \u2014 issue marked done in Linear");
+  if (logHas("setPrReady applied"))
+    out("  \u2713 setPrReady applied \u2014 PR is ready for human review");
   if (logHas("clearConflicted applied"))
     out("  \u2713 clearConflicted applied");
   if (logHas("setConflicted applied"))
@@ -101367,7 +101409,7 @@ async function main2(argv) {
     await mkdir6(statesDir, { recursive: true });
     await ensureRalphGitignore(projectRoot);
     const { ensureWorkflow: ensureWorkflow2 } = await Promise.resolve().then(() => (init_workflow(), exports_workflow));
-    const workflowPath2 = await ensureWorkflow2(projectRoot);
+    const workflowPath2 = await ensureWorkflow2(projectRoot, args.workflowFile);
     process.stdout.write(`Workflow config: ${workflowPath2}
 `);
     const openspecBin = resolveOpenspecBin(import.meta.dir);
@@ -101738,6 +101780,7 @@ var init_cli2 = __esm(() => {
     "getAutoMerge",
     "setInProgress",
     "setDone",
+    "setPrReady",
     "setError"
   ]);
   GET_KEYS = new Set(["getTodo", "getInProgress", "getAutoMerge"]);
@@ -101754,6 +101797,7 @@ var init_cli2 = __esm(() => {
     "",
     "Options:",
     "  --name <id>             Change name / ticket identifier (list / debug filter)",
+    "  --workflow <path>       Path to an alternate WORKFLOW.md (default: <project>/WORKFLOW.md)",
     "  --prompt <text>         Task description appended to every scaffolded proposal",
     "  --prompt-file <path>    Read prompt from file",
     "  --model <model>         Set model (haiku|sonnet|opus)",
@@ -101776,9 +101820,10 @@ var init_cli2 = __esm(() => {
     "  --worktree              Run each task in its own git worktree",
     "  --indicator <k>:<t>:<v> Override an indicator (repeatable).",
     "                          Keys: getTodo, getInProgress, getAutoMerge,",
-    "                                setInProgress, setDone, setError",
+    "                                setInProgress, setDone, setPrReady, setError",
     "                          Types: label, status, attachment, project, comment",
     "                          --indicator setInProgress:attachment:In Progress",
+    "                          --indicator setPrReady:status:In Review (additive ready marker)",
     "                          (attachment upserts a single 'Ralphy' entry; value = subtitle)",
     "  --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)",
@@ -101813,12 +101858,12 @@ __export(exports_config, {
   loadRalphyConfig: () => loadRalphyConfig,
   ensureRalphyConfig: () => ensureRalphyConfig
 });
-async function loadRalphyConfig(projectRoot) {
-  const { config: config2 } = await loadWorkflow(projectRoot);
+async function loadRalphyConfig(projectRoot, workflowFile) {
+  const { config: config2 } = await loadWorkflow(projectRoot, workflowFile);
   return config2;
 }
-async function ensureRalphyConfig(projectRoot) {
-  return ensureWorkflow(projectRoot);
+async function ensureRalphyConfig(projectRoot, workflowFile) {
+  return ensureWorkflow(projectRoot, workflowFile);
 }
 var init_config = __esm(() => {
   init_workflow();
@@ -102125,7 +102170,7 @@ async function runCapability(cap, args, ctx = {}) {
   throw lastError;
 }
 function sleepMs(ms) {
-  return new Promise((resolve3) => setTimeout(resolve3, ms));
+  return new Promise((resolve4) => setTimeout(resolve4, ms));
 }
 
 // packages/workflow/src/boundaries.ts
@@ -104248,6 +104293,7 @@ async function runPrPhase(input, deps) {
     emit: emit3,
     respawnWorker,
     registerPr,
+    onPrReady,
     checkPrConflict,
     resolveDependencyBaseBranch
   } = deps;
@@ -104442,6 +104488,9 @@ ${indented}${suffix}`, "yellow");
       log3(`! manual merge failed for ${prUrl}: ${e.stderr?.trim() || e.message}`, "yellow");
     }
   }
+  if (!(wantAutoMerge && !prReadyNeeded)) {
+    await onPrReady?.(prUrl);
+  }
   return 0;
 }
 async function runWorktreeCleanupPhase(input, deps) {
@@ -104647,6 +104696,7 @@ async function runPostTask(input, deps) {
       emit: emit3,
       respawnWorker,
       ...deps.registerPr !== undefined ? { registerPr: deps.registerPr } : {},
+      ...deps.onPrReady !== undefined ? { onPrReady: deps.onPrReady } : {},
       ...deps.checkPrConflict !== undefined ? { checkPrConflict: deps.checkPrConflict } : {},
       ...deps.resolveDependencyBaseBranch !== undefined ? { resolveDependencyBaseBranch: deps.resolveDependencyBaseBranch } : {}
     });
@@ -107120,7 +107170,7 @@ function createPrepareHelpers(input) {
       }
       let workflowPrompt = "";
       try {
-        const workflow = await loadWorkflow(projectRoot);
+        const workflow = await loadWorkflow(projectRoot, args.workflowFile);
         workflowPrompt = renderWorkflowPrompt(workflow, {
           issue: {
             identifier: issue2.identifier,
@@ -108150,6 +108200,8 @@ function createSpawnWorker(input) {
     indicators,
     cmdRunner,
     gitRunner,
+    applyIndicator,
+    bus,
     onLog,
     diag,
     runners,
@@ -108378,6 +108430,23 @@ function createSpawnWorker(input) {
         runScript,
         ...retroDepEntry(args.agentDebug, runRetrospectiveHook),
         registerPr: (cn, url2) => onPrRegistered(cn, url2),
+        ...issueForChange && indicators.setPrReady ? {
+          onPrReady: async () => {
+            const issue2 = issueForChange;
+            const marker = indicators.setPrReady;
+            try {
+              await applyIndicator(issue2, marker);
+              onLog(`  ${issue2.identifier}: setPrReady applied`, "gray");
+            } catch (err) {
+              onLog(`! Linear setPrReady failed for ${issue2.identifier}: ${err.message}`, "yellow");
+              emitCapture(bus, "agent_indicator_failed", {
+                indicator: "setPrReady",
+                issue_identifier: issue2.identifier,
+                error: err.message
+              });
+            }
+          }
+        } : {},
         ...onWorkerPhase && {
           onPhase: (phase2, detail) => onWorkerPhase(changeName, phase2, detail)
         },
@@ -108415,6 +108484,7 @@ var init_worker = __esm(() => {
   init_agent_run_state();
   init_retro();
   init_engine();
+  init_coordinator();
 });
 
 // apps/agent/src/agent/baseline/runner.ts
@@ -111565,11 +111635,11 @@ var require_tslib = __commonJS((exports, module) => {
     };
     __awaiter = function(thisArg, _arguments, P, generator) {
       function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve3) {
-          resolve3(value);
+        return value instanceof P ? value : new P(function(resolve4) {
+          resolve4(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve3, reject2) {
+      return new (P || (P = Promise))(function(resolve4, reject2) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -111585,7 +111655,7 @@ var require_tslib = __commonJS((exports, module) => {
           }
         }
         function step(result2) {
-          result2.done ? resolve3(result2.value) : adopt(result2.value).then(fulfilled, rejected);
+          result2.done ? resolve4(result2.value) : adopt(result2.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -111814,14 +111884,14 @@ var require_tslib = __commonJS((exports, module) => {
       }, i);
       function verb(n) {
         i[n] = o[n] && function(v) {
-          return new Promise(function(resolve3, reject2) {
-            v = o[n](v), settle(resolve3, reject2, v.done, v.value);
+          return new Promise(function(resolve4, reject2) {
+            v = o[n](v), settle(resolve4, reject2, v.done, v.value);
           });
         };
       }
-      function settle(resolve3, reject2, d, v) {
+      function settle(resolve4, reject2, d, v) {
         Promise.resolve(v).then(function(v2) {
-          resolve3({ value: v2, done: d });
+          resolve4({ value: v2, done: d });
         }, reject2);
       }
     };
@@ -112684,9 +112754,9 @@ var require_clone = __commonJS((exports, module) => {
         } else if (_instanceof2(parent2, nativeSet)) {
           child = new nativeSet;
         } else if (_instanceof2(parent2, nativePromise)) {
-          child = new nativePromise(function(resolve3, reject2) {
+          child = new nativePromise(function(resolve4, reject2) {
             parent2.then(function(value) {
-              resolve3(_clone(value, depth2 - 1));
+              resolve4(_clone(value, depth2 - 1));
             }, function(err) {
               reject2(_clone(err, depth2 - 1));
             });
@@ -260735,7 +260805,7 @@ function toPdfSafe(text) {
   return out;
 }
 function renderMarkdownToPdf(md, title) {
-  return new Promise((resolve3, reject2) => {
+  return new Promise((resolve4, reject2) => {
     try {
       const doc2 = new PDFDocument({
         size: PAGE_SIZE,
@@ -260744,7 +260814,7 @@ function renderMarkdownToPdf(md, title) {
       });
       const chunks = [];
       doc2.on("data", (chunk2) => chunks.push(chunk2));
-      doc2.on("end", () => resolve3(new Uint8Array(Buffer.concat(chunks))));
+      doc2.on("end", () => resolve4(new Uint8Array(Buffer.concat(chunks))));
       doc2.on("error", reject2);
       doc2.fillColor(COLOR_TEXT).font(FONT_BODY).fontSize(BODY_SIZE);
       const tokens = g.lexer(md);
@@ -261809,6 +261879,8 @@ function buildAgentCoordinator(input) {
     indicators,
     cmdRunner,
     gitRunner,
+    applyIndicator: resolvers.applyIndicator,
+    bus,
     onLog,
     diag,
     runners: input.runners,
@@ -262040,7 +262112,7 @@ async function waitForActiveWorkers(deps) {
   const budgetMs = deps.budgetMs ?? 1e4;
   const warnAtMs = deps.warnAtMs ?? 5000;
   deps.stop();
-  await new Promise((resolve3) => {
+  await new Promise((resolve4) => {
     const start = Date.now();
     let warned = false;
     const wait = setInterval(() => {
@@ -262048,7 +262120,7 @@ async function waitForActiveWorkers(deps) {
       const elapsed = Date.now() - start;
       if (active === 0) {
         clearInterval(wait);
-        resolve3();
+        resolve4();
         return;
       }
       if (!warned && elapsed >= warnAtMs) {
@@ -262058,7 +262130,7 @@ async function waitForActiveWorkers(deps) {
       if (elapsed >= budgetMs) {
         clearInterval(wait);
         deps.onTimeout?.(active);
-        resolve3();
+        resolve4();
       }
     }, 100);
   });
@@ -262643,8 +262715,8 @@ function AgentMode({
     let cancelled = false;
     async function init2() {
       logSession(`=== session start ${SESSION_START} ===`);
-      const cfgPath = await ensureConfig(projectRoot);
-      const cfg2 = await loadConfig(projectRoot);
+      const cfgPath = await ensureConfig(projectRoot, args.workflowFile);
+      const cfg2 = await loadConfig(projectRoot, args.workflowFile);
       cfgRef.current = cfg2;
       appendLog(`agent mode v${VERSION} \u2014 config: ${cfgPath}`, "gray");
       const apiKey = process.env["LINEAR_API_KEY"];
@@ -264548,7 +264620,7 @@ async function runList(input) {
   }
   const rows = buildLocalRows();
   printLocalRows(rows);
-  const cfg = await loadRalphyConfig(projectRoot);
+  const cfg = await loadRalphyConfig(projectRoot, getArgs().workflowFile);
   const apiKey = process.env["LINEAR_API_KEY"];
   const indicators = cfg.linear.indicators;
   const team = input.linearTeamOverride || cfg.linear.team;
@@ -264672,7 +264744,7 @@ async function runListDebug(input) {
     process.exitCode = 1;
     return;
   }
-  const cfg = await loadRalphyConfig(projectRoot);
+  const cfg = await loadRalphyConfig(projectRoot, getArgs().workflowFile);
   const indicators = cfg.linear.indicators;
   const team = input.linearTeamOverride || cfg.linear.team;
   const { assignee, anyAssignee } = resolveLinearFilter(input.linearFilterOverride, input.linearAssigneeOverride, cfg.linear.filter);
@@ -264810,8 +264882,8 @@ async function runAgentJson({
   });
   const fileSink = createJsonLogFileSink(args.jsonLogFile);
   const emit3 = makeEmit(fileSink);
-  const cfgPath = await ensureRalphyConfig(projectRoot);
-  const cfg = await loadRalphyConfig(projectRoot);
+  const cfgPath = await ensureRalphyConfig(projectRoot, args.workflowFile);
+  const cfg = await loadRalphyConfig(projectRoot, args.workflowFile);
   await writeAgentRunState({
     projectRoot,
     configPath: cfgPath,
@@ -264968,7 +265040,7 @@ async function runAgentJson({
       }
     })();
   }, 1000);
-  await new Promise((resolve3) => {
+  await new Promise((resolve4) => {
     let shuttingDown = false;
     const onSig = () => {
       if (shuttingDown) {
@@ -264998,7 +265070,7 @@ async function runAgentJson({
           });
           setTimeout(() => process.exit(1), 50);
         }
-      }).then(() => resolve3());
+      }).then(() => resolve4());
     };
     process.once("SIGINT", onSig);
     process.once("SIGTERM", onSig);
@@ -265076,7 +265148,7 @@ async function main3(argv) {
   if (args.ticketTokens.length > 0) {
     const { loadRalphyConfig: loadRalphyConfig2 } = await Promise.resolve().then(() => (init_config(), exports_config));
     const { resolveTicketNumbers: resolveTicketNumbers2, formatTicketError: formatTicketError2 } = await Promise.resolve().then(() => (init_linear_client(), exports_linear_client));
-    const cfg = await loadRalphyConfig2(projectRoot);
+    const cfg = await loadRalphyConfig2(projectRoot, args.workflowFile);
     const team = args.linearTeam || cfg.linear.team;
     try {
       resolveTicketNumbers2(args.ticketTokens, team);

package/package.json

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