@neriros/ralphy 0.2.1 → 0.2.2

package/dist/cli/index.js

@@ -37423,28 +37423,28 @@ var require_react_jsx_dev_runtime_development = __commonJS((exports) => {
         return null;
       }
       var ReactSharedInternals = React10.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED;
-      function error(format) {
+      function error(format2) {
         {
           {
             for (var _len2 = arguments.length, args = new Array(_len2 > 1 ? _len2 - 1 : 0), _key2 = 1;_key2 < _len2; _key2++) {
               args[_key2 - 1] = arguments[_key2];
             }
-            printWarning("error", format, args);
+            printWarning("error", format2, args);
           }
         }
       }
-      function printWarning(level, format, args) {
+      function printWarning(level, format2, args) {
         {
           var ReactDebugCurrentFrame2 = ReactSharedInternals.ReactDebugCurrentFrame;
           var stack = ReactDebugCurrentFrame2.getStackAddendum();
           if (stack !== "") {
-            format += "%s";
+            format2 += "%s";
             args = args.concat([stack]);
           }
           var argsWithFormat = args.map(function(item) {
             return String(item);
           });
-          argsWithFormat.unshift("Warning: " + format);
+          argsWithFormat.unshift("Warning: " + format2);
           Function.prototype.apply.call(console[level], console, argsWithFormat);
         }
       }
@@ -43760,8 +43760,76 @@ var import_react58 = __toESM(require_react(), 1);
 
 // apps/cli/src/cli.ts
 import { readFileSync as readFileSync2 } from "fs";
+
+// packages/output/src/output.ts
+var formatters = {
+  bold: (text) => source_default.bold(text),
+  dim: (text) => source_default.dim(text),
+  gray: (text) => source_default.gray(text),
+  error: (text) => source_default.red(text),
+  fail: (text) => source_default.red.bold(text),
+  warn: (text) => source_default.yellow.bold(text),
+  header: (text) => source_default.bold.cyan(text),
+  success: (text) => source_default.green(text),
+  successBold: (text) => source_default.green.bold(text),
+  cyan: (text) => source_default.cyan(text)
+};
+function format(msg) {
+  return formatters[msg.style](msg.text);
+}
+function styled(text, style) {
+  return format({ text, style });
+}
+function log(msg) {
+  console.log(typeof msg === "string" ? msg : format(msg));
+}
+
+// apps/cli/src/cli.ts
 var VALID_MODES = new Set(["task", "list", "status", "advance", "set-phase", "init"]);
 var VALID_MODELS = new Set(["haiku", "sonnet", "opus"]);
+var HELP_TEXT = [
+  "Usage: ralph <command> [options]",
+  "",
+  "Commands:",
+  "  task                    Run a task (default)",
+  "  list                    List incomplete tasks",
+  "  status                  Show detailed task status",
+  "  advance                 Advance task to next phase",
+  "  set-phase               Set task to a specific phase",
+  "  init                    Initialize ralph in current directory",
+  "",
+  "Options:",
+  "  --name <name>           Task name (required for most commands)",
+  "  --prompt <text>         Task description",
+  "  --prompt-file <path>    Read prompt from file",
+  "  --model <model>         Set model (haiku|sonnet|opus)",
+  "  --claude [model]        Use Claude engine (haiku|sonnet|opus, default: opus)",
+  "  --codex                 Use Codex engine",
+  "  --phase <phase>         Target phase (for set-phase)",
+  "  --no-execute            Stop after research + plan",
+  "  --interactive           Run research+plan interactively, then continue automated",
+  "  --delay <seconds>       Seconds between iterations",
+  "  --max-iterations <n>    Stop after N iterations (0 = unlimited)",
+  "  --max-cost <n>          Stop when total cost exceeds $N (0 = no limit)",
+  "  --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)",
+  "  --log                   Log raw engine stream",
+  "  --verbose               Verbose output",
+  "  --help, -h              Show this help message",
+  "",
+  "Examples:",
+  '  ralph task --name my-feature --prompt "Add dark mode"',
+  "  ralph task --name my-feature --claude sonnet --max-iterations 10",
+  "  ralph list",
+  "  ralph status --name my-feature",
+  "  ralph advance --name my-feature",
+  "  ralph set-phase --name my-feature --phase exec"
+].join(`
+`);
+function printHelp() {
+  log(HELP_TEXT);
+}
 function parseArgs(argv) {
   const result2 = {
     mode: "task",
@@ -43865,6 +43933,10 @@ function parseArgs(argv) {
       continue;
     }
     switch (arg) {
+      case "--help":
+      case "-h":
+        printHelp();
+        process.exit(0);
       case "--claude":
         if (result2.engineSet && result2.engine !== "claude") {
           throw new Error("Choose only one engine flag: --claude or --codex");
@@ -43935,7 +44007,9 @@ function parseArgs(argv) {
         if (VALID_MODES.has(arg)) {
           result2.mode = arg;
         } else {
-          throw new Error(`Unknown argument or mode '${arg}'`);
+          throw new Error(`Unknown argument '${arg}'
+
+Run 'ralph --help' for usage information.`);
         }
         break;
     }
@@ -52392,26 +52466,6 @@ import { writeFileSync as writeFileSync3, unlinkSync as unlinkSync2, existsSync
 import { join as join9 } from "path";
 import { tmpdir } from "os";
 
-// packages/output/src/output.ts
-var formatters = {
-  bold: (text) => source_default.bold(text),
-  dim: (text) => source_default.dim(text),
-  gray: (text) => source_default.gray(text),
-  error: (text) => source_default.red(text),
-  fail: (text) => source_default.red.bold(text),
-  warn: (text) => source_default.yellow.bold(text),
-  header: (text) => source_default.bold.cyan(text),
-  success: (text) => source_default.green(text),
-  successBold: (text) => source_default.green.bold(text),
-  cyan: (text) => source_default.cyan(text)
-};
-function format(msg) {
-  return formatters[msg.style](msg.text);
-}
-function styled(text, style) {
-  return format({ text, style });
-}
-
 // packages/engine/src/feed-events.ts
 function formatCost2(usd) {
   return (Math.round(usd * 100) / 100).toFixed(2);