ralph-hero-mcp-server 2.4.39 → 2.4.41

package/dist/lib/pipeline-detection.js

@@ -22,7 +22,7 @@ const REMAINING_PHASES = {
 // ---------------------------------------------------------------------------
 // Oversized estimate detection
 // ---------------------------------------------------------------------------
-const OVERSIZED_ESTIMATES = new Set(["M", "L", "XL"]);
+export const OVERSIZED_ESTIMATES = new Set(["M", "L", "XL"]);
 // ---------------------------------------------------------------------------
 // Detection logic
 // ---------------------------------------------------------------------------
@@ -56,8 +56,8 @@ export function detectPipelinePosition(issues, isGroup, groupPrimary) {
             blocking: [],
         });
     }
-    // Step 1: Check for oversized issues needing split
-    const oversized = issues.filter((i) => i.estimate !== null && OVERSIZED_ESTIMATES.has(i.estimate));
+    // Step 1: Check for oversized issues needing split (skip already-split issues)
+    const oversized = issues.filter((i) => i.estimate !== null && OVERSIZED_ESTIMATES.has(i.estimate) && i.subIssueCount === 0);
     if (oversized.length > 0) {
         return buildResult("SPLIT", `${oversized.length} issue(s) need splitting (estimate: ${oversized.map((i) => `#${i.number}=${i.estimate}`).join(", ")})`, issues, isGroup, groupPrimary, { required: false, met: true, blocking: [] });
     }

package/dist/tools/issue-tools.js

@@ -7,7 +7,7 @@
 import { z } from "zod";
 import { paginateConnection } from "../lib/pagination.js";
 import { detectGroup } from "../lib/group-detection.js";
-import { detectPipelinePosition, } from "../lib/pipeline-detection.js";
+import { detectPipelinePosition, OVERSIZED_ESTIMATES, } from "../lib/pipeline-detection.js";
 import { isValidState, VALID_STATES, LOCK_STATES, } from "../lib/workflow-states.js";
 import { resolveState } from "../lib/state-resolution.js";
 import { parseDateMath } from "../lib/date-math.js";
@@ -880,8 +880,28 @@ export function registerIssueTools(server, client, fieldCache) {
                     title: ticket.title,
                     workflowState: state.workflowState || "unknown",
                     estimate: state.estimate || null,
+                    subIssueCount: 0,
                 };
             }));
+            // Fetch sub-issue counts for oversized issues (targeted query, not all issues)
+            const oversizedNumbers = issueStates
+                .filter((i) => i.estimate !== null && OVERSIZED_ESTIMATES.has(i.estimate))
+                .map((i) => i.number);
+            if (oversizedNumbers.length > 0) {
+                await Promise.all(oversizedNumbers.map(async (num) => {
+                    const subResult = await client.query(`query($owner: String!, $repo: String!, $issueNum: Int!) {
+                  repository(owner: $owner, name: $repo) {
+                    issue(number: $issueNum) {
+                      subIssuesSummary { total }
+                    }
+                  }
+                }`, { owner, repo, issueNum: num });
+                    const issueState = issueStates.find((i) => i.number === num);
+                    if (issueState && subResult.repository?.issue?.subIssuesSummary) {
+                        issueState.subIssueCount = subResult.repository.issue.subIssuesSummary.total;
+                    }
+                }));
+            }
             // Detect pipeline position
             const position = detectPipelinePosition(issueStates, group.isGroup, group.groupPrimary.number);
             return toolSuccess(position);

package/dist/tools/relationship-tools.js

@@ -13,6 +13,53 @@ import { isValidState, isEarlierState, VALID_STATES, PARENT_GATE_STATES, isParen
 import { toolSuccess, toolError } from "../types.js";
 import { ensureFieldCache, resolveIssueNodeId, resolveProjectItemId, updateProjectItemField, getCurrentFieldValue, resolveConfig, resolveFullConfig, syncStatusField, } from "../lib/helpers.js";
 // ---------------------------------------------------------------------------
+// Sub-issue tree helpers (exported for testing)
+// ---------------------------------------------------------------------------
+/**
+ * Recursively build the GraphQL selection set for nested sub-issues.
+ * At the leaf level (currentDepth >= maxDepth), returns only base fields.
+ * At inner levels, includes subIssuesSummary and nested subIssues.
+ */
+export function buildSubIssueFragment(currentDepth, maxDepth) {
+    const base = "id number title state";
+    if (currentDepth >= maxDepth)
+        return base;
+    return `${base}
+    subIssuesSummary { total completed percentCompleted }
+    subIssues(first: 50) {
+      nodes { ${buildSubIssueFragment(currentDepth + 1, maxDepth)} }
+    }`;
+}
+/**
+ * Recursively map raw GraphQL sub-issue nodes into typed SubIssueNode[].
+ * Adds subIssues/subIssuesSummary fields when currentDepth < maxDepth.
+ */
+export function mapSubIssueNodes(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+nodes, currentDepth, maxDepth) {
+    return nodes.map((node) => {
+        const mapped = {
+            id: node.id,
+            number: node.number,
+            title: node.title,
+            state: node.state,
+        };
+        if (currentDepth < maxDepth && node.subIssues?.nodes) {
+            mapped.subIssues = mapSubIssueNodes(node.subIssues.nodes, currentDepth + 1, maxDepth);
+            mapped.subIssuesSummary = node.subIssuesSummary || {
+                total: node.subIssues.nodes.length,
+                completed: node.subIssues.nodes.filter((si) => si.state === "CLOSED").length,
+                percentCompleted: node.subIssues.nodes.length > 0
+                    ? Math.round((node.subIssues.nodes.filter((si) => si.state === "CLOSED").length /
+                        node.subIssues.nodes.length) *
+                        100)
+                    : 0,
+            };
+        }
+        return mapped;
+    });
+}
+// ---------------------------------------------------------------------------
 // Register relationship tools
 // ---------------------------------------------------------------------------
 export function registerRelationshipTools(server, client, fieldCache) {
@@ -73,7 +120,7 @@ export function registerRelationshipTools(server, client, fieldCache) {
     // -------------------------------------------------------------------------
     // ralph_hero__list_sub_issues
     // -------------------------------------------------------------------------
-    server.tool("ralph_hero__list_sub_issues", "List all sub-issues (children) of a parent GitHub issue, with completion summary", {
+    server.tool("ralph_hero__list_sub_issues", "List all sub-issues (children) of a parent GitHub issue, with completion summary. Use depth parameter (1-3) to fetch nested sub-issue trees in a single call. Default depth=1 returns direct children only.", {
         owner: z
             .string()
             .optional()
@@ -83,10 +130,17 @@ export function registerRelationshipTools(server, client, fieldCache) {
             .optional()
             .describe("Repository name. Defaults to GITHUB_REPO env var"),
         number: z.coerce.number().describe("Parent issue number"),
+        depth: z.coerce
+            .number()
+            .optional()
+            .default(1)
+            .describe("How many levels of sub-issues to fetch (1=direct children, 2=children+grandchildren, max 3)"),
     }, async (args) => {
         try {
             const { owner, repo } = resolveConfig(client, args);
-            const result = await client.query(`query($owner: String!, $repo: String!, $number: Int!) {
+            const depth = Math.min(Math.max(args.depth, 1), 3);
+            const subIssueFields = buildSubIssueFragment(1, depth);
+            const queryStr = `query($owner: String!, $repo: String!, $number: Int!) {
             repository(owner: $owner, name: $repo) {
               issue(number: $number) {
                 id
@@ -94,34 +148,31 @@ export function registerRelationshipTools(server, client, fieldCache) {
                 title
                 subIssuesSummary { total completed percentCompleted }
                 subIssues(first: 50) {
-                  nodes { id number title state }
+                  nodes { ${subIssueFields} }
                   pageInfo { hasNextPage endCursor }
                 }
               }
             }
-          }`, { owner, repo, number: args.number });
+          }`;
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const result = await client.query(queryStr, { owner, repo, number: args.number });
             const issue = result.repository?.issue;
             if (!issue) {
                 return toolError(`Issue #${args.number} not found in ${owner}/${repo}`);
             }
+            const mappedSubIssues = mapSubIssueNodes(issue.subIssues.nodes, 1, depth);
             return toolSuccess({
                 parent: {
                     id: issue.id,
                     number: issue.number,
                     title: issue.title,
                 },
-                subIssues: issue.subIssues.nodes.map((si) => ({
-                    id: si.id,
-                    number: si.number,
-                    title: si.title,
-                    state: si.state,
-                })),
+                subIssues: mappedSubIssues,
                 summary: issue.subIssuesSummary || {
                     total: issue.subIssues.nodes.length,
                     completed: issue.subIssues.nodes.filter((si) => si.state === "CLOSED").length,
                     percentCompleted: issue.subIssues.nodes.length > 0
-                        ? Math.round((issue.subIssues.nodes.filter((si) => si.state === "CLOSED")
-                            .length /
+                        ? Math.round((issue.subIssues.nodes.filter((si) => si.state === "CLOSED").length /
                             issue.subIssues.nodes.length) *
                             100)
                         : 0,

package/package.json

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