codex-ralph 0.3.2 → 0.4.1

package/README.md

@@ -5,7 +5,7 @@ Minimal Ralph Wiggum Loop runner that feeds a sprint requirement into Codex, one
 ## Quick start
 
 ```bash
-npx codex-ralph --sprint=path/to/Sprint_0001.md --max-iterations=1
+npx codex-ralph path/to/Sprint_0001.md --max-iterations=1
 ```
 
 ## Telegram progress notifications
@@ -19,6 +19,18 @@ CODEX_RALPH_TG_CHAT=123456789
 
 Provide these as environment variables (e.g., when invoking `npx`). Each session generates a UUID and includes it in progress messages.
 
+Usage:
+
+```
+npx codex-ralph path/to/Sprint_0001.md
+```
+
+Optional flags:
+
+```
+--max-iterations=10
+```
+
 Message format:
 
 ```

package/agent/ralph-loop.sh

@@ -9,7 +9,7 @@ PY
 )"
 ROOT_DIR="$(cd "$(dirname "$SCRIPT_PATH")/.." && pwd)"
 SPRINT_FILE=""
-MAX_ITERATIONS=0
+MAX_ITERATIONS=10
 NOTES_FILE=""
 SESSION_UUID=""
 
@@ -40,11 +40,11 @@ send_telegram() {
 
 usage() {
   cat <<USAGE
-Usage: ralph-loop --sprint=PATH [--max-iterations=N]
+Usage: ralph-loop SPRINT_PATH [--max-iterations=N]
 
 Options:
-  --sprint=PATH          Path to the sprint markdown file (required).
-  --max-iterations=N     Stop after N iterations (0 = no limit).
+  SPRINT_PATH            Path to the sprint markdown file (required).
+  --max-iterations=N     Stop after N iterations (0 = no limit, default 10).
   -h, --help             Show this help.
 USAGE
 }
@@ -53,9 +53,6 @@ session_uuid >/dev/null
 
 for arg in "$@"; do
   case "$arg" in
-    --sprint=*)
-      SPRINT_FILE="${arg#*=}"
-      ;;
     --max-iterations=*)
       MAX_ITERATIONS="${arg#*=}"
       ;;
@@ -63,11 +60,20 @@ for arg in "$@"; do
       usage
       exit 0
       ;;
-    *)
+    -*)
       echo "Unknown argument: $arg" >&2
       usage >&2
       exit 1
       ;;
+    *)
+      if [[ -z "$SPRINT_FILE" ]]; then
+        SPRINT_FILE="$arg"
+      else
+        echo "Unexpected argument: $arg" >&2
+        usage >&2
+        exit 1
+      fi
+      ;;
   esac
  done
 
@@ -189,7 +195,7 @@ while true; do
   remaining="$(remaining_count)"
   if [[ "$remaining" == "0" ]]; then
     total="$(total_count)"
-    send_telegram "🧭 ~${SESSION_UUID}~"$'\n'"✅ All requirements completed"$'\n'"🎯 ${total} of ${total}"
+    send_telegram "🧭 `${SESSION_UUID}`"$'\n'"✅ All requirements completed"$'\n'"🎯 ${total} of ${total}"
     echo "All sprint requirements complete."
     echo "<promise>DONE</promise>"
     exit 0
@@ -203,7 +209,7 @@ while true; do
   desc="$(next_description)"
   total="$(total_count)"
   current="$(current_index)"
-  send_telegram "🧭 ~${SESSION_UUID}~"$'\n'"📌 ${desc}"$'\n'"🎯 ${current} of ${total}"
+  send_telegram "🧭 `${SESSION_UUID}`"$'\n'"📌 ${desc}"$'\n'"🎯 ${current} of ${total}"
   echo "Iteration $iteration - next requirement: $desc"
 
   prompt_tmp="$(mktemp)"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-ralph",
-  "version": "0.3.2",
+  "version": "0.4.1",
   "description": "Ralph Loop sprint runner for Codex.",
   "bin": {
     "ralph-loop": "agent/ralph-loop.sh"