cralph 1.0.0-beta.4 → 1.0.0-beta.6

package/README.md

@@ -1,7 +1,7 @@
 # cralph
 
 <p align="center">
-  <img src="assets/ralph.png" alt="Ralph cooking" width="500">
+  <img src="https://raw.githubusercontent.com/mguleryuz/cralph/main/assets/ralph.png" alt="Ralph cooking" width="500">
 </p>
 
 Claude in a loop. Give it a rule, let it cook.
@@ -98,9 +98,14 @@ Claude maintains this structure:
 - [ ] Pending task
 - [x] Completed task
 
+---
+
 # Notes
 
-Any relevant context
+## Task Title - Done
+- What was implemented
+- Files changed
+- Learnings: patterns discovered, gotchas encountered
 ```
 
 ## First Run (No .ralph/ in cwd)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cralph",
-  "version": "1.0.0-beta.4",
+  "version": "1.0.0-beta.6",
   "description": "Claude in a loop. Point at refs, give it a rule, let it cook.",
   "author": "mguleryuz",
   "license": "MIT",
@@ -26,8 +26,7 @@
     "src",
     "index.ts",
     "README.md",
-    "LICENSE",
-    "assets"
+    "LICENSE"
   ],
   "scripts": {
     "start": "bun run src/cli.ts",

package/src/prompt.ts

@@ -10,12 +10,12 @@ FIRST: Read and internalize the rules provided below.
 
 ## Your Task Each 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)
+6. Append your progress to the Notes section (see format below)
 7. If ALL tasks are complete, output the completion signal
 
 ## Critical Rules
@@ -24,6 +24,17 @@ FIRST: Read and internalize the rules provided below.
 - **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
+- **Commit after completing** - Commit your changes with a meaningful message
+
+## Commit Format
+
+After completing a task and quality checks pass, commit ALL changes with:
+
+\`\`\`
+feat: [Task Title]
+\`\`\`
+
+Use \`feat:\` for new features, \`fix:\` for bug fixes, \`refactor:\` for refactoring, \`docs:\` for documentation.
 
 ## Progress Format
 
@@ -38,18 +49,6 @@ 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.

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;
     }