rralph 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 879adb96bb31b3269ef4f60a200a8689cf4283f694f2aca5e0f9a95c24bef7ff
-  data.tar.gz: 909224ae6b25857bff64c7c789d66a16025c74601ef397d9f40c8d066707ba94
+  metadata.gz: ebba7ca8a7b704f97c3dbc0df60c6df68d29542641fb91c9251574af1d79ecc5
+  data.tar.gz: 1846e26ecb26b0eab7f0df14330d2f1e8b279da785101e2b885e02d9b99d27e4
 SHA512:
-  metadata.gz: 6411d979dddce3cd5de21d510d5af092c4aa65f0d6af5371c96628320b3658d1b2f5a70495e861c15f77044fc1486fe1de29eb9fb0383a6a6637fe61c4cb11e8
-  data.tar.gz: '07018c95c8ec9029893b4548ede3e5ef1a1e601bc1243c665ba053c882fdca83ac7523c71df6005c179a85af3f775ef42f9d6a4b997ea6490dc4753918f0748b'
+  metadata.gz: 7e586e53ebba5ab3886388929d731eecfff9cdf74d8684a20ec7949fa249192cae9634d93e68b25cf96dedb2830b0471517e043cca0b28579b3a4794d8ebd756
+  data.tar.gz: f3ea37403f48d24dd1b506079450f7ed05e33c5462f6319d3735a7e4688223078020d624bc5f05c8fa8fb51389de646647a058996f460e7c52f470da18237d68

data/README.md

@@ -48,6 +48,25 @@ Requirements:
 Test: 0→EVEN, 7→ODD, -4→EVEN, abc→error, no arg→error
 ```
 
+After running `rralph start` you will get a `todo.md` generated for you like:
+
+```
+# Todo List
+
+- [ ] Create `odd_even.sh` file with bash shebang
+- [ ] Add input validation to check if argument is provided
+- [ ] Add regex validation for integer input (`^-?[0-9]+$`)
+- [ ] Implement even/odd check using `(( ))` arithmetic and `%` operator
+- [ ] Print "IS EVEN" or "IS ODD" based on result
+- [ ] Add error handling with exit code 1 for invalid inputs
+- [ ] Make script executable with `chmod +x`
+- [ ] Test with input `0` (expect "IS EVEN")
+- [ ] Test with input `7` (expect "IS ODD")
+- [ ] Test with input `-4` (expect "IS EVEN")
+- [ ] Test with input `abc` (expect error, exit 1)
+- [ ] Test with no argument (expect error, exit 1)
+```
+
 ### Basic Usage
 
 Run `rralph` with default settings:
@@ -65,16 +84,33 @@ rralph --max-failures 2 --watch
 ### Command-Line Options
 
 ```
-rralph run [OPTIONS]
+➜  rralph help      
+Commands:
+  rralph help [COMMAND]  # Describe available commands or one specific command
+  rralph start           # Run the rralph orchestrator
+  rralph stats           # Show progress statistics
+  rralph tree            # Print a tree of all available commands
+  rralph version         # Show rralph version
+
+➜  rralph help start
+Usage:
+  rralph start
 
 Options:
-  -m, --max-failures N       Maximum allowed failures before stopping (default: 3)
-  -a, --ai-command "CMD"     AI command to invoke (default: "qwen-code -y -s")
-  -w, --watch                Run in continuous loop until completion or max failures
-  -p, --plan-path PATH       Path to plan.md file (default: "plan.md")
-  -l, --learnings-path PATH  Path to learnings.md file (default: "learnings.md")
-  -t, --todo-path PATH       Path to todo.md file (default: "todo.md")
-  -h, --help                 Show help message
+  -m, [--max-failures=N]                       # Maximum allowed failures before stopping
+                                               # Default: 3
+  -a, [--ai-command=AI_COMMAND]                # AI command to invoke
+                                               # Default: qwen-code -y -s
+  -w, [--watch], [--no-watch], [--skip-watch]  # Run in continuous loop until completion or max failures
+                                               # Default: false
+  -p, [--plan-path=PLAN_PATH]                  # Path to plan.md file
+                                               # Default: plan.md
+  -l, [--learnings-path=LEARNINGS_PATH]        # Path to learnings.md file
+                                               # Default: learnings.md
+  -t, [--todo-path=TODO_PATH]                  # Path to todo.md file
+                                               # Default: todo.md
+  -s, [--skip-commit], [--no-skip-commit]      # Skip git commits between tasks
+                                               # Default: false
 ```
 
 ### Examples
@@ -88,13 +124,19 @@ rralph
 Run continuously until all tasks are done or max failures reached:
 
 ```bash
-rralph --watch --max-failures 5
+rralph start --watch --max-failures 5
 ```
 
 Use a custom AI command:
 
 ```bash
-rralph --ai-command "claude --prompt"
+rralph start --ai-command "claude --prompt"
+```
+
+Skip git commits between tasks (files are updated but not committed):
+
+```bash
+rralph start --skip-commit
 ```
 
 View progress statistics:

data/lib/rralph/cli.rb

@@ -34,6 +34,11 @@ module Rralph
                   default: "todo.md",
                   aliases: "-t",
                   desc: "Path to todo.md file"
+    method_option :skip_commit,
+                  type: :boolean,
+                  default: false,
+                  aliases: "-s",
+                  desc: "Skip git commits between tasks"
 
     def start
       runner = Runner.new(
@@ -42,7 +47,8 @@ module Rralph
         watch: options[:watch],
         plan_path: options[:plan_path],
         learnings_path: options[:learnings_path],
-        todo_path: options[:todo_path]
+        todo_path: options[:todo_path],
+        skip_commit: options[:skip_commit]
       )
 
       runner.run

data/lib/rralph/runner.rb

@@ -8,7 +8,8 @@ module Rralph
       watch: false,
       plan_path: "plan.md",
       learnings_path: "learnings.md",
-      todo_path: "todo.md"
+      todo_path: "todo.md",
+      skip_commit: false
     )
       @max_failures = max_failures
       @ai_command = ai_command
@@ -16,6 +17,7 @@ module Rralph
       @plan_path = plan_path
       @learnings_path = learnings_path
       @todo_path = todo_path
+      @skip_commit = skip_commit
 
       @cycle_count = 0
       @failure_count = 0
@@ -115,11 +117,15 @@ module Rralph
       new_learnings = @parser.extract_learnings(response)
       @file_updater.append_learnings(new_learnings) if new_learnings.any?
 
-      commit_message = "rralph: completed task and updated artifacts [cycle #{@cycle_count}]"
-      sha = @git.commit_changes(commit_message)
+      if @skip_commit
+        log("⏭️  [Cycle #{@cycle_count}] Skipping commit (skip_commit enabled)")
+      else
+        commit_message = "rralph: completed task and updated artifacts [cycle #{@cycle_count}]"
+        sha = @git.commit_changes(commit_message)
 
-      if sha
-        log("   Git commit: #{sha}")
+        if sha
+          log("   Git commit: #{sha}")
+        end
       end
 
       true
@@ -182,9 +188,9 @@ module Rralph
 
       timestamp = Time.now.strftime("%Y%m%d_%H%M%S")
       filename = "#{logs_dir}/cycle_#{@cycle_count}_#{timestamp}.md"
-      
+
       # Extract just the current task for the header
-      task_match = prompt.match(/YOUR CURRENT TASK.*?>\s*(.+?)\n/)
+      task_match = prompt.match(/YOUR CURRENT TASK.*?\n>\s*(.+?)\n/)
       task_text = task_match ? task_match[1].strip : "Unknown"
 
       content = <<~LOG
@@ -233,11 +239,15 @@ module Rralph
 
           File.write(@todo_path, todo_content)
 
-          commit_message = "rralph: generated todo from plan.md"
-          sha = @git.commit_changes(commit_message)
+          if @skip_commit
+            log("⏭️  Generated #{todo_items.size} tasks (skip_commit enabled, no commit)")
+          else
+            commit_message = "rralph: generated todo from plan.md"
+            sha = @git.commit_changes(commit_message)
 
-          if sha
-            log("✅ Generated #{todo_items.size} tasks. Git commit: #{sha}")
+            if sha
+              log("✅ Generated #{todo_items.size} tasks. Git commit: #{sha}")
+            end
           end
         else
           log("❌ Could not parse tasks from AI response")

data/lib/rralph.rb

@@ -1,5 +1,5 @@
 module Rralph
-  VERSION = "0.1.0"
+  VERSION = "0.1.2"
 
   class Error < StandardError; end
   class FileNotFound < Error; end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rralph
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - rralph