ralph-mcp 1.0.6 → 1.0.8

package/dist/tools/start.d.ts

@@ -7,6 +7,7 @@ export declare const startInputSchema: z.ZodObject<{
     autoMerge: z.ZodDefault<z.ZodBoolean>;
     notifyOnComplete: z.ZodDefault<z.ZodBoolean>;
     onConflict: z.ZodDefault<z.ZodEnum<["auto_theirs", "auto_ours", "notify", "agent"]>>;
+    contextInjectionPath: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     prdPath: string;
     onConflict: "auto_theirs" | "auto_ours" | "notify" | "agent";
@@ -15,6 +16,7 @@ export declare const startInputSchema: z.ZodObject<{
     worktree: boolean;
     autoStart: boolean;
     projectRoot?: string | undefined;
+    contextInjectionPath?: string | undefined;
 }, {
     prdPath: string;
     projectRoot?: string | undefined;
@@ -23,6 +25,7 @@ export declare const startInputSchema: z.ZodObject<{
     notifyOnComplete?: boolean | undefined;
     worktree?: boolean | undefined;
     autoStart?: boolean | undefined;
+    contextInjectionPath?: string | undefined;
 }>;
 export type StartInput = z.infer<typeof startInputSchema>;
 export interface StartResult {

package/dist/tools/start.js

@@ -16,6 +16,10 @@ export const startInputSchema = z.object({
         .enum(["auto_theirs", "auto_ours", "notify", "agent"])
         .default("agent")
         .describe("Conflict resolution strategy for merge"),
+    contextInjectionPath: z
+        .string()
+        .optional()
+        .describe("Path to a file (e.g., CLAUDE.md) to inject into the agent prompt"),
 });
 export async function start(input) {
     const projectRoot = input.projectRoot || process.cwd();
@@ -70,6 +74,9 @@ export async function start(input) {
     // Generate agent prompt if auto-start
     let agentPrompt = null;
     if (input.autoStart) {
+        const contextPath = input.contextInjectionPath
+            ? resolve(projectRoot, input.contextInjectionPath)
+            : undefined;
         agentPrompt = generateAgentPrompt(prd.branchName, prd.description, worktreePath || projectRoot, storyRecords.map((s) => ({
             storyId: s.storyId,
             title: s.title,
@@ -77,7 +84,7 @@ export async function start(input) {
             acceptanceCriteria: s.acceptanceCriteria,
             priority: s.priority,
             passes: s.passes,
-        })));
+        })), contextPath);
     }
     return {
         executionId,

package/dist/utils/agent.d.ts

@@ -8,7 +8,7 @@ export declare function generateAgentPrompt(branch: string, description: string,
     acceptanceCriteria: string[];
     priority: number;
     passes: boolean;
-}>): string;
+}>, contextInjectionPath?: string): string;
 /**
  * Generate merge agent prompt for conflict resolution
  */

package/dist/utils/agent.js

@@ -6,7 +6,7 @@ const execAsync = promisify(exec);
 /**
  * Generate agent prompt for PRD execution
  */
-export function generateAgentPrompt(branch, description, worktreePath, stories) {
+export function generateAgentPrompt(branch, description, worktreePath, stories, contextInjectionPath) {
     const pendingStories = stories
         .filter((s) => !s.passes)
         .sort((a, b) => a.priority - b.priority);
@@ -33,6 +33,16 @@ ${s.acceptanceCriteria.map((ac) => `- ${ac}`).join("\n")}
             // Ignore read errors
         }
     }
+    // Read injected context if provided
+    let injectedContext = "";
+    if (contextInjectionPath && existsSync(contextInjectionPath)) {
+        try {
+            injectedContext = readFileSync(contextInjectionPath, "utf-8");
+        }
+        catch (e) {
+            // Ignore read errors
+        }
+    }
     return `You are an autonomous coding agent working on the "${branch}" branch.
 
 ## Working Directory
@@ -40,6 +50,8 @@ ${worktreePath}
 
 ## PRD: ${description}
 
+${injectedContext ? `## Project Context\n${injectedContext}\n` : ""}
+
 ${progressLog ? `## Progress & Learnings\n${progressLog}\n` : ""}
 
 ## Pending User Stories

package/dist/utils/worktree.js

@@ -1,5 +1,5 @@
 import { execSync, exec } from "child_process";
-import { existsSync, appendFileSync } from "fs";
+import { existsSync, appendFileSync, readFileSync } from "fs";
 import { join } from "path";
 import { promisify } from "util";
 const execAsync = promisify(exec);
@@ -27,8 +27,21 @@ export async function createWorktree(projectRoot, branch) {
     }
     // Prevent ralph-progress.md from being committed
     try {
-        const excludePath = join(worktreePath, ".git", "info", "exclude");
+        const { stdout: gitCommonDir } = await execAsync("git rev-parse --git-common-dir", {
+            cwd: worktreePath,
+        });
+        const excludePath = join(gitCommonDir.trim(), "info", "exclude");
+        // Ensure info directory exists
+        // (git-common-dir usually returns absolute path or relative to cwd.
+        // If relative, join with worktreePath might be needed, but rev-parse usually returns absolute if outside?
+        // Actually rev-parse --git-common-dir usually returns absolute path if called with proper context or relative.
+        // Safest is to resolve it.)
+        // Let's rely on reading current content to check if needed
+        let content = "";
         if (existsSync(excludePath)) {
+            content = readFileSync(excludePath, "utf-8");
+        }
+        if (!content.includes("ralph-progress.md")) {
             appendFileSync(excludePath, "\nralph-progress.md\n", "utf-8");
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ralph-mcp",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "MCP server for autonomous PRD execution with Claude Code. Git worktree isolation, progress tracking, auto-merge.",
   "type": "module",
   "main": "dist/index.js",
@@ -20,7 +20,7 @@
     "user-story",
     "merge-queue"
   ],
-  "author": "G0d2i11a",
+  "author": "Godzi11a <2492186627@qq.com>",
   "license": "MIT",
   "repository": {
     "type": "git",