cralph 1.0.0-alpha.3 → 1.0.0-alpha.4

package/README.md

@@ -134,6 +134,14 @@ If not authenticated:
 ✔ Saved .ralph/paths.json
 ```
 
+**TODO state check (on run):**
+```
+? Found existing TODO with progress. Reset to start fresh? (y/N)
+```
+- If the `.ralph/TODO.md` file has been modified from previous runs, you'll be asked whether to reset it
+- Default is **No** (continue with existing progress)
+- Choose **Yes** to start fresh with a clean TODO
+
 **Cancellation:**
 - Press `Ctrl+C` at any time to exit
 - Running Claude processes are terminated cleanly
@@ -149,7 +157,8 @@ If not authenticated:
 bun test
 ```
 
-Tests validate config loading, prompt building, and CLI behavior without calling Claude.
+- **Unit tests** validate config loading, prompt building, and CLI behavior
+- **E2E tests** run the full loop with Claude (requires authentication)
 
 ## Requirements
 

package/package.json

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

package/src/runner.ts

@@ -6,6 +6,21 @@ import { createPrompt } from "./prompt";
 
 const COMPLETION_SIGNAL = "<promise>COMPLETE</promise>";
 
+const INITIAL_TODO_CONTENT = `# Ralph Agent Status
+
+## Current Status
+
+Idle - waiting for documents in refs/
+
+## Processed Files
+
+_None yet_
+
+## Pending
+
+_Check refs/ for new documents_
+`;
+
 /**
  * Check if Claude CLI is authenticated by sending a minimal test prompt
  */
@@ -40,6 +55,18 @@ export async function checkClaudeAuth(): Promise<boolean> {
 }
 
 
+/**
+ * Check if the TODO file is in a clean/initial state
+ */
+async function isTodoClean(todoPath: string): Promise<boolean> {
+  const file = Bun.file(todoPath);
+  if (!(await file.exists())) {
+    return true; // Non-existent is considered clean
+  }
+  const content = await file.text();
+  return content.trim() === INITIAL_TODO_CONTENT.trim();
+}
+
 /**
  * Initialize the runner state and log file
  */
@@ -61,26 +88,29 @@ Ralph Session: ${state.startTime.toISOString()}
 
   await Bun.write(state.logFile, logHeader);
 
-  // Initialize TODO file if not exists
+  // Check TODO file state
   const todoFile = Bun.file(state.todoFile);
-  if (!(await todoFile.exists())) {
-    await Bun.write(
-      state.todoFile,
-      `# Ralph Agent Status
-
-## Current Status
-
-Idle - waiting for documents in refs/
-
-## Processed Files
-
-_None yet_
-
-## Pending
-
-_Check refs/ for new documents_
-`
+  const todoExists = await todoFile.exists();
+  
+  if (!todoExists) {
+    // Create fresh TODO file
+    await Bun.write(state.todoFile, INITIAL_TODO_CONTENT);
+  } else if (!(await isTodoClean(state.todoFile))) {
+    // TODO exists and has been modified - ask about reset
+    const response = await consola.prompt(
+      "Found existing TODO with progress. Reset to start fresh?",
+      {
+        type: "confirm",
+        initial: false,
+      }
     );
+    
+    if (response === true) {
+      await Bun.write(state.todoFile, INITIAL_TODO_CONTENT);
+      consola.info("TODO reset to clean state");
+    } else {
+      consola.info("Continuing with existing TODO state");
+    }
   }
 
   return state;