cralph 1.0.0-beta.5 → 1.0.0-beta.7

package/README.md

@@ -62,8 +62,9 @@ cralph --yes
 2. Looks for `.ralph/` in current directory only (not subdirectories)
 3. Loads config from `.ralph/paths.json` or creates starter structure
 4. Runs `claude -p --dangerously-skip-permissions` in a loop
-5. Claude updates `.ralph/TODO.md` after each iteration
-6. Stops when Claude outputs `<promise>COMPLETE</promise>`
+5. Claude completes **ONE task per iteration**, marks it done, then stops
+6. Auto-commits progress after each iteration (fails gracefully if no git)
+7. Stops when Claude outputs `<promise>COMPLETE</promise>`
 
 ## Config
 
@@ -90,7 +91,7 @@ Save as `.ralph/paths.json`. Refs are optional reference material (read-only).
 
 ### TODO Format
 
-Claude maintains this structure:
+Claude maintains this structure (one task per iteration):
 
 ```markdown
 # Tasks
@@ -98,9 +99,17 @@ Claude maintains this structure:
 - [ ] Pending task
 - [x] Completed task
 
+---
+
 # Notes
 
-Any relevant context
+## Task 1 - Done
+- What was implemented
+- Files changed
+- Learnings: patterns discovered, gotchas encountered
+
+## Task 2 - Done
+- ...
 ```
 
 ## First Run (No .ralph/ in cwd)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cralph",
-  "version": "1.0.0-beta.5",
+  "version": "1.0.0-beta.7",
   "description": "Claude in a loop. Point at refs, give it a rule, let it cook.",
   "author": "mguleryuz",
   "license": "MIT",

package/src/prompt.ts

@@ -8,19 +8,19 @@ const BASE_PROMPT = `You are an autonomous coding agent running in a loop.
 
 FIRST: Read and internalize the rules provided below.
 
-## Your Task Each Iteration
+## Your Task This Iteration
 
-1. Read the TODO file and check the Patterns section first
+1. Read the TODO file
 2. Pick the FIRST uncompleted task (marked with [ ])
 3. Implement that SINGLE task
 4. Run quality checks (typecheck, lint, test - whatever the project requires)
 5. If checks pass, mark the task [x] complete
-6. Append your progress with learnings (see format below)
-7. If ALL tasks are complete, output the completion signal
+6. Append your progress to the Notes section
+7. **STOP** - End your response. Another iteration will handle the next task.
 
 ## Critical Rules
 
-- **ONE task per iteration** - Do not try to complete multiple tasks
+- **ONE task per iteration** - Complete exactly ONE task, then STOP. Do NOT continue to the next task.
 - **Quality first** - Do NOT mark a task complete if tests/typecheck fail
 - **Keep changes focused** - Minimal, targeted changes only
 - **Follow existing patterns** - Match the codebase style
@@ -38,31 +38,21 @@ After completing a task, APPEND to the Notes section:
   - Gotchas encountered
 \`\`\`
 
-## Consolidate Patterns
-
-If you discover a REUSABLE pattern, add it to the **# Patterns** section at the TOP of the TODO file:
-
-\`\`\`
-# Patterns
-- Example: Use \`sql<number>\` template for aggregations
-- Example: Always update X when changing Y
-\`\`\`
-
-Only add patterns that are general and reusable, not task-specific details.
-
 ## Refs (Read-Only)
 
 If refs paths are provided, they are READ-ONLY reference material. Never modify files in refs.
 
 ## Stop Condition
 
-After completing a task, check if ALL tasks are marked [x] complete.
+After completing ONE task, check the TODO file:
+
+- If there are still tasks marked [ ] (pending): **END your response normally.** Another iteration will pick up the next task.
 
-If ALL tasks are done, output exactly:
+- If ALL tasks are marked [x] (complete): Output exactly:
 
 <promise>COMPLETE</promise>
 
-If there are still pending tasks, end your response normally (the loop will continue).`;
+**IMPORTANT:** Do NOT continue to the next task. Complete ONE task, then STOP.`;
 
 /**
  * Build the complete prompt with config and rules injected

package/src/runner.ts

@@ -9,13 +9,7 @@ import { setCurrentProcess, throwIfCancelled } from "./state";
 const COMPLETION_SIGNAL = "<promise>COMPLETE</promise>";
 const AUTH_CACHE_TTL_MS = 6 * 60 * 60 * 1000; // 6 hours
 
-const INITIAL_TODO_CONTENT = `# Patterns
-
-_None yet - add reusable patterns discovered during work_
-
----
-
-# Tasks
+const INITIAL_TODO_CONTENT = `# Tasks
 
 - [ ] Task 1
 - [ ] Task 2
@@ -186,6 +180,48 @@ async function log(state: RunnerState, message: string): Promise<void> {
   await Bun.write(state.logFile, existing + logLine);
 }
 
+/**
+ * Try to commit progress after each iteration
+ * Fails gracefully - logs warning and continues if commit fails
+ */
+async function tryCommitProgress(state: RunnerState, cwd: string): Promise<void> {
+  try {
+    // Stage all changes
+    const addProc = Bun.spawn(["git", "add", "-A"], {
+      cwd,
+      stdout: "pipe",
+      stderr: "pipe",
+    });
+    await addProc.exited;
+
+    // Commit with iteration number
+    const commitMessage = `chore(ralph): iteration ${state.iteration} progress`;
+    const commitProc = Bun.spawn(
+      ["git", "commit", "-m", commitMessage, "--no-verify"],
+      {
+        cwd,
+        stdout: "pipe",
+        stderr: "pipe",
+      }
+    );
+    
+    const exitCode = await commitProc.exited;
+    
+    if (exitCode === 0) {
+      consola.info(`Committed iteration ${state.iteration} progress`);
+      await log(state, `Committed: ${commitMessage}`);
+    } else {
+      // Exit code 1 usually means nothing to commit
+      await log(state, `No changes to commit for iteration ${state.iteration}`);
+    }
+  } catch (error) {
+    // Gracefully fail - just log and continue
+    const errorMsg = error instanceof Error ? error.message : String(error);
+    consola.warn(`Could not commit progress: ${errorMsg}`);
+    await log(state, `Commit failed: ${errorMsg}`);
+  }
+}
+
 /**
  * Run a single Claude iteration
  */
@@ -268,6 +304,9 @@ export async function run(config: RalphConfig): Promise<void> {
 
     const result = await runIteration(prompt, state, cwd);
 
+    // Try to commit progress after each iteration (fails gracefully)
+    await tryCommitProgress(state, cwd);
+
     if (result.isComplete) {
       break;
     }