@neriros/ralphy 3.10.8 → 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.8")
-      return "3.10.8";
+    if ("3.10.9")
+      return "3.10.9";
   } catch {}
   const dirsToTry = [];
   try {
@@ -81906,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);
@@ -81919,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;
@@ -84362,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);
 }
@@ -84712,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",
@@ -84725,6 +84732,7 @@ function initialCommonArgs() {
     log: false,
     verbose: false,
     projectRoot: undefined,
+    workflowFile: undefined,
     name: "",
     prompt: "",
     fromAgent: false
@@ -84747,6 +84755,7 @@ function emptyParseState() {
     pendingOption: null,
     expectClaudeModel: false,
     expectProjectRoot: false,
+    expectWorkflow: false,
     expectName: false,
     expectPrompt: false,
     expectPromptFile: false,
@@ -84771,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;
@@ -84817,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;
@@ -84966,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)",
@@ -85049,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)",
@@ -97382,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
       });
@@ -98816,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) => {
@@ -98963,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();
         })
       ]);
@@ -100138,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);
@@ -101390,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);
@@ -101778,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)",
@@ -101838,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();
@@ -102150,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
@@ -107150,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,
@@ -111615,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));
@@ -111635,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());
       });
@@ -111864,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);
       }
     };
@@ -112734,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));
             });
@@ -260785,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,
@@ -260794,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);
@@ -262092,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(() => {
@@ -262100,7 +262120,7 @@ async function waitForActiveWorkers(deps) {
       const elapsed = Date.now() - start;
       if (active === 0) {
         clearInterval(wait);
-        resolve3();
+        resolve4();
         return;
       }
       if (!warned && elapsed >= warnAtMs) {
@@ -262110,7 +262130,7 @@ async function waitForActiveWorkers(deps) {
       if (elapsed >= budgetMs) {
         clearInterval(wait);
         deps.onTimeout?.(active);
-        resolve3();
+        resolve4();
       }
     }, 100);
   });
@@ -262695,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"];
@@ -264600,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;
@@ -264724,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);
@@ -264862,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,
@@ -265020,7 +265040,7 @@ async function runAgentJson({
       }
     })();
   }, 1000);
-  await new Promise((resolve3) => {
+  await new Promise((resolve4) => {
     let shuttingDown = false;
     const onSig = () => {
       if (shuttingDown) {
@@ -265050,7 +265070,7 @@ async function runAgentJson({
           });
           setTimeout(() => process.exit(1), 50);
         }
-      }).then(() => resolve3());
+      }).then(() => resolve4());
     };
     process.once("SIGINT", onSig);
     process.once("SIGTERM", onSig);
@@ -265128,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.8",
+  "version": "3.10.9",
   "description": "An iterative AI task execution framework. Orchestrates multi-phase autonomous work using Claude or Codex engines.",
   "keywords": [
     "agent",