ralph-hero-mcp-server 2.5.16 → 2.5.18

package/dist/lib/repo-registry.js

@@ -47,6 +47,7 @@ export const RepoDefaultsSchema = z.object({
  * Example YAML:
  *   mcp-server:
  *     owner: cdubiel08
+ *     localDir: ~/projects/mcp-server
  *     domain: platform
  *     tech: [typescript, node]
  *     defaults:
@@ -58,6 +59,10 @@ export const RepoEntrySchema = z.object({
         .string()
         .optional()
         .describe("GitHub owner (user or org); falls back to RALPH_GH_OWNER if omitted"),
+    localDir: z
+        .string()
+        .optional()
+        .describe("On-disk checkout location (e.g., '~/projects/ralph-hero'); used by agents for cross-repo Read/Grep/Glob"),
     domain: z
         .string()
         .describe("Functional domain this repo belongs to (e.g., 'platform', 'frontend')"),

package/dist/lib/state-resolution.js

@@ -11,6 +11,7 @@ const SEMANTIC_INTENTS = {
     __LOCK__: {
         ralph_research: "Research in Progress",
         ralph_plan: "Plan in Progress",
+        ralph_plan_epic: "Plan in Progress",
         ralph_impl: "In Progress",
     },
     __COMPLETE__: {
@@ -18,6 +19,7 @@ const SEMANTIC_INTENTS = {
         ralph_split: "Backlog",
         ralph_research: "Ready for Plan",
         ralph_plan: "Plan in Review",
+        ralph_plan_epic: "In Progress",
         ralph_impl: "In Review",
         ralph_review: "In Progress",
         ralph_merge: "Done",
@@ -35,9 +37,10 @@ const COMMAND_ALLOWED_STATES = {
         "Canceled",
         "Human Needed",
     ],
-    ralph_split: ["Backlog"],
+    ralph_split: ["Backlog", "In Progress", "Ready for Plan"],
     ralph_research: ["Research in Progress", "Ready for Plan", "Human Needed"],
-    ralph_plan: ["Plan in Progress", "Plan in Review", "Human Needed"],
+    ralph_plan: ["Plan in Progress", "Plan in Review", "In Progress", "Human Needed"],
+    ralph_plan_epic: ["Plan in Progress", "In Progress", "Human Needed"],
     ralph_impl: ["In Progress", "In Review", "Human Needed"],
     ralph_review: ["In Progress", "Ready for Plan", "Human Needed"],
     ralph_hero: ["In Review", "Human Needed"],

package/dist/lib/work-stream-detection.js

@@ -57,7 +57,8 @@ export function detectWorkStreams(issues) {
         const issueKey = `issue:${issue.number}`;
         // File-overlap edges: union issue with each of its files
         for (const file of issue.files) {
-            uf.union(`file:${file}`, issueKey);
+            const fileKey = issue.repo ? `file:${issue.repo}:${file}` : `file:${file}`;
+            uf.union(fileKey, issueKey);
         }
         // Dependency edges: union with blockedBy issues (only if in input set)
         for (const dep of issue.blockedBy) {
@@ -75,10 +76,10 @@ export function detectWorkStreams(issues) {
         }
         components.get(root).push(issue.number);
     }
-    // Build file ownership lookup: issue number -> files
-    const issueFiles = new Map();
+    // Build qualified file keys for shared-files reporting
+    const qualifiedFiles = new Map();
     for (const issue of issues) {
-        issueFiles.set(issue.number, issue.files);
+        qualifiedFiles.set(issue.number, issue.files.map((f) => (issue.repo ? `${issue.repo}:${f}` : f)));
     }
     // Build blockedBy lookup for rationale
     const issueBlockedBy = new Map();
@@ -90,7 +91,7 @@ export function detectWorkStreams(issues) {
     for (const issueNumbers of components.values()) {
         const sorted = [...issueNumbers].sort((a, b) => a - b);
         const id = `stream-${sorted.join("-")}`;
-        const sharedFiles = computeSharedFiles(sorted, issueFiles);
+        const sharedFiles = computeSharedFiles(sorted, qualifiedFiles);
         const primaryIssue = sorted[0];
         streams.push({ id, issues: sorted, sharedFiles, primaryIssue });
     }

package/dist/lib/workflow-states.js

@@ -104,6 +104,20 @@ export function isValidState(state) {
  * - In Progress = work actively being processed (lock states + review)
  * - Done = terminal/escalated states (no automated progression)
  */
+/**
+ * Maps parent plan document type to the entry state for children
+ * created by ralph_split from that plan.
+ *
+ * When a parent issue has a plan-of-plans, its feature children
+ * skip to "Ready for Plan" (they need their own detailed plan).
+ *
+ * When a parent issue has an implementation plan, its atomic children
+ * skip to "In Progress" (the plan already covers their implementation).
+ */
+export const SKIP_ENTRY_STATES = {
+    "plan-of-plans": "Ready for Plan",
+    "plan": "In Progress",
+};
 export const WORKFLOW_STATE_TO_STATUS = {
     "Backlog": "Todo",
     "Research Needed": "Todo",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ralph-hero-mcp-server",
-  "version": "2.5.16",
+  "version": "2.5.18",
   "description": "MCP server for GitHub Projects V2 - Ralph workflow automation",
   "type": "module",
   "main": "dist/index.js",