ralph-mcp 1.0.3 → 1.0.6

package/dist/tools/update.js

@@ -1,5 +1,8 @@
 import { z } from "zod";
 import notifier from "node-notifier";
+import { appendFile, mkdir } from "fs/promises";
+import { existsSync } from "fs";
+import { join, dirname } from "path";
 import { findExecutionByBranch, findMergeQueueItemByExecutionId, findUserStoryById, insertMergeQueueItem, listMergeQueue, listUserStoriesByExecutionId, updateExecution, updateUserStory, } from "../store/state.js";
 import { mergeQueueAction } from "./merge.js";
 export const updateInputSchema = z.object({
@@ -8,6 +11,15 @@ export const updateInputSchema = z.object({
     passes: z.boolean().describe("Whether the story passes"),
     notes: z.string().optional().describe("Implementation notes"),
 });
+function formatDate(date) {
+    const pad = (n) => n.toString().padStart(2, '0');
+    const yyyy = date.getFullYear();
+    const MM = pad(date.getMonth() + 1);
+    const dd = pad(date.getDate());
+    const HH = pad(date.getHours());
+    const mm = pad(date.getMinutes());
+    return `${yyyy}-${MM}-${dd} ${HH}:${mm}`;
+}
 export async function update(input) {
     // Find execution by branch
     const exec = await findExecutionByBranch(input.branch);
@@ -25,6 +37,24 @@ export async function update(input) {
         passes: input.passes,
         notes: input.notes || story.notes,
     });
+    // Append to ralph-progress.md if passed
+    if (input.passes && exec.worktreePath) {
+        try {
+            const progressPath = join(exec.worktreePath, "ralph-progress.md");
+            const dir = dirname(progressPath);
+            if (!existsSync(dir)) {
+                await mkdir(dir, { recursive: true });
+            }
+            const timestamp = formatDate(new Date());
+            const notesContent = input.notes || story.notes || "No notes provided.";
+            const entry = `## [${timestamp}] ${story.storyId}: ${story.title}\n${notesContent}\n\n`;
+            await appendFile(progressPath, entry, "utf-8");
+        }
+        catch (e) {
+            console.error("Failed to write to ralph-progress.md:", e);
+            // Continue execution even if logging fails
+        }
+    }
     // Update execution timestamp and status
     const allStories = await listUserStoriesByExecutionId(exec.id);
     // Check if this update completes all stories

package/dist/utils/agent.js

@@ -14,41 +14,55 @@ export function generateAgentPrompt(branch, description, worktreePath, stories)
         return "All user stories are complete. No action needed.";
     }
     const storiesText = pendingStories
-        .map((s) => `
-### ${s.storyId}: ${s.title}
-${s.description}
-
-**Acceptance Criteria:**
-${s.acceptanceCriteria.map((ac) => `- ${ac}`).join("\n")}
+        .map((s) => `
+### ${s.storyId}: ${s.title}
+${s.description}
+
+**Acceptance Criteria:**
+${s.acceptanceCriteria.map((ac) => `- ${ac}`).join("\n")}
 `)
         .join("\n");
-    return `You are an autonomous coding agent working on the "${branch}" branch.
-
-## Working Directory
-${worktreePath}
-
-## PRD: ${description}
-
-## Pending User Stories
-${storiesText}
-
-## Instructions
-
-1. Work on ONE user story at a time, starting with the highest priority
-2. Implement the feature to satisfy all acceptance criteria
-3. Run quality checks: \`pnpm check-types\` and \`pnpm --filter api build\`
-4. Commit changes with message: \`feat: [${pendingStories[0].storyId}] - ${pendingStories[0].title}\`
-5. After completing a story, call \`ralph_update\` to mark it as passed:
-   \`ralph_update({ branch: "${branch}", storyId: "${pendingStories[0].storyId}", passes: true, notes: "..." })\`
-6. Continue to the next story until all are complete
-
-## Quality Requirements
-- ALL commits must pass typecheck and build
-- Keep changes focused and minimal
-- Follow existing code patterns
-
-## Stop Condition
-When all stories are complete, report completion.
+    // Read progress log if it exists
+    let progressLog = "";
+    const progressPath = join(worktreePath, "ralph-progress.md");
+    if (existsSync(progressPath)) {
+        try {
+            progressLog = readFileSync(progressPath, "utf-8");
+        }
+        catch (e) {
+            // Ignore read errors
+        }
+    }
+    return `You are an autonomous coding agent working on the "${branch}" branch.
+
+## Working Directory
+${worktreePath}
+
+## PRD: ${description}
+
+${progressLog ? `## Progress & Learnings\n${progressLog}\n` : ""}
+
+## Pending User Stories
+${storiesText}
+
+## Instructions
+
+1. Work on ONE user story at a time, starting with the highest priority.
+2. ${progressLog ? "Review the 'Progress & Learnings' section above to understand previous decisions and context." : "Check if 'ralph-progress.md' exists and review it for context."}
+3. Implement the feature to satisfy all acceptance criteria.
+4. Run quality checks: \`pnpm check-types\` and \`pnpm --filter api build\` (adjust command for the specific repo structure if needed).
+5. Commit changes with message: \`feat: [${pendingStories[0].storyId}] - ${pendingStories[0].title}\`
+6. After completing a story, call \`ralph_update\` to mark it as passed:
+   \`ralph_update({ branch: "${branch}", storyId: "${pendingStories[0].storyId}", passes: true, notes: "Brief summary of implementation, key decisions, and any learnings." })\`
+7. Continue to the next story until all are complete.
+
+## Quality Requirements
+- ALL commits must pass typecheck and build
+- Keep changes focused and minimal
+- Follow existing code patterns
+
+## Stop Condition
+When all stories are complete, report completion.
 `;
 }
 /**
@@ -66,31 +80,31 @@ export function generateMergeAgentPrompt(projectRoot, branch, description, confl
     if (prdPath && existsSync(prdPath)) {
         prdContent = readFileSync(prdPath, "utf-8");
     }
-    return `You are a Git merge expert. Please resolve the following merge conflicts.
-
-## Project Architecture
-${architectureContext || "No CLAUDE.md found. Use your best judgment based on the code."}
-
-## PRD Context
-${prdContent || `Branch: ${branch}\nDescription: ${description}`}
-
-## Conflict Files
-${conflictFiles.map((f) => `- ${f}`).join("\n")}
-
-## Tasks
-
-1. Read each conflict file to understand both sides of the conflict
-2. Analyze the intent of changes from both branches based on the PRD
-3. Resolve conflicts by keeping valuable changes from both sides
-4. Ensure the PRD requirements are satisfied
-5. Run \`git add <file>\` for each resolved file
-6. Run \`git commit -m "resolve: merge conflicts for ${branch}"\`
-
-## Guidelines
-- Prefer keeping both changes when they don't conflict logically
-- If changes conflict logically, prefer the feature branch changes (they implement the PRD)
-- Ensure the code compiles after resolution
-- Run \`pnpm check-types\` to verify
+    return `You are a Git merge expert. Please resolve the following merge conflicts.
+
+## Project Architecture
+${architectureContext || "No CLAUDE.md found. Use your best judgment based on the code."}
+
+## PRD Context
+${prdContent || `Branch: ${branch}\nDescription: ${description}`}
+
+## Conflict Files
+${conflictFiles.map((f) => `- ${f}`).join("\n")}
+
+## Tasks
+
+1. Read each conflict file to understand both sides of the conflict
+2. Analyze the intent of changes from both branches based on the PRD
+3. Resolve conflicts by keeping valuable changes from both sides
+4. Ensure the PRD requirements are satisfied
+5. Run \`git add <file>\` for each resolved file
+6. Run \`git commit -m "resolve: merge conflicts for ${branch}"\`
+
+## Guidelines
+- Prefer keeping both changes when they don't conflict logically
+- If changes conflict logically, prefer the feature branch changes (they implement the PRD)
+- Ensure the code compiles after resolution
+- Run \`pnpm check-types\` to verify
 `;
 }
 /**

package/dist/utils/worktree.js

@@ -1,5 +1,5 @@
 import { execSync, exec } from "child_process";
-import { existsSync } from "fs";
+import { existsSync, appendFileSync } from "fs";
 import { join } from "path";
 import { promisify } from "util";
 const execAsync = promisify(exec);
@@ -25,6 +25,17 @@ export async function createWorktree(projectRoot, branch) {
         // Create new branch from main
         await execAsync(`git worktree add -b "${branch}" "${worktreePath}" main`, { cwd: projectRoot });
     }
+    // Prevent ralph-progress.md from being committed
+    try {
+        const excludePath = join(worktreePath, ".git", "info", "exclude");
+        if (existsSync(excludePath)) {
+            appendFileSync(excludePath, "\nralph-progress.md\n", "utf-8");
+        }
+    }
+    catch (e) {
+        console.error("Failed to update .git/info/exclude:", e);
+        // Non-fatal error
+    }
     return worktreePath;
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ralph-mcp",
-  "version": "1.0.3",
+  "version": "1.0.6",
   "description": "MCP server for autonomous PRD execution with Claude Code. Git worktree isolation, progress tracking, auto-merge.",
   "type": "module",
   "main": "dist/index.js",