ralph-hero-mcp-server 2.5.193 → 2.5.195

package/dist/lib/hygiene.js

@@ -90,6 +90,9 @@ export function findFieldGaps(items, now) {
         missingPriority: nonTerminal
             .filter((item) => item.priority === null)
             .map((item) => toHygieneItem(item, now)),
+        missingWorkflowState: nonTerminal
+            .filter((item) => item.workflowState === null)
+            .map((item) => toHygieneItem(item, now)),
     };
 }
 /**
@@ -338,7 +341,8 @@ export function formatHygieneMarkdown(report) {
     }
     // Field gaps
     const totalGaps = report.fieldGaps.missingEstimate.length +
-        report.fieldGaps.missingPriority.length;
+        report.fieldGaps.missingPriority.length +
+        report.fieldGaps.missingWorkflowState.length;
     if (totalGaps > 0) {
         lines.push("## Field Gaps");
         if (report.fieldGaps.missingEstimate.length > 0) {
@@ -359,6 +363,15 @@ export function formatHygieneMarkdown(report) {
             }
             lines.push("");
         }
+        if (report.fieldGaps.missingWorkflowState.length > 0) {
+            lines.push("### Missing Workflow State");
+            lines.push("| Issue | Title | State | Age |");
+            lines.push("|-------|-------|-------|-----|");
+            for (const item of report.fieldGaps.missingWorkflowState) {
+                lines.push(formatItemRow(item));
+            }
+            lines.push("");
+        }
     }
     // WIP violations
     if (report.wipViolations.length > 0) {
@@ -426,7 +439,8 @@ export function formatHygieneMarkdown(report) {
                 renderedAny = true;
             }
             const repoTotalGaps = repo.fieldGaps.missingEstimate.length +
-                repo.fieldGaps.missingPriority.length;
+                repo.fieldGaps.missingPriority.length +
+                repo.fieldGaps.missingWorkflowState.length;
             if (repoTotalGaps > 0) {
                 lines.push("#### Field Gaps");
                 if (repo.fieldGaps.missingEstimate.length > 0) {
@@ -447,6 +461,15 @@ export function formatHygieneMarkdown(report) {
                     }
                     lines.push("");
                 }
+                if (repo.fieldGaps.missingWorkflowState.length > 0) {
+                    lines.push("##### Missing Workflow State");
+                    lines.push("| Issue | Title | State | Age |");
+                    lines.push("|-------|-------|-------|-----|");
+                    for (const item of repo.fieldGaps.missingWorkflowState) {
+                        lines.push(formatItemRow(item));
+                    }
+                    lines.push("");
+                }
                 renderedAny = true;
             }
             if (repo.wipViolations.length > 0) {

package/dist/tools/issue-tools.js

@@ -668,8 +668,9 @@ export function registerIssueTools(server, client, fieldCache) {
             .describe("GitHub usernames to assign"),
         workflowState: z
             .string()
+            .min(1, 'workflowState must be a non-empty state name; omit it to default to "Backlog"')
             .optional()
-            .describe("Initial Workflow State name"),
+            .describe('Initial Workflow State name (defaults to "Backlog")'),
         estimate: z.string().optional().describe("Estimate (XS, S, M, L, XL)"),
         priority: z.string().optional().describe("Priority (P0, P1, P2, P3)"),
     }, async (args) => {
@@ -688,6 +689,7 @@ export function registerIssueTools(server, client, fieldCache) {
             let effectiveLabels = args.labels;
             let effectiveAssignees = args.assignees;
             let effectiveEstimate = args.estimate;
+            const effectiveState = args.workflowState ?? "Backlog";
             if (registry) {
                 const repoLookup = lookupRepo(registry, repo);
                 if (repoLookup) {
@@ -773,10 +775,8 @@ export function registerIssueTools(server, client, fieldCache) {
                 .getCache()
                 .set(`project-item-id:${owner}/${repo}#${issue.number}`, projectItemId, 30 * 60 * 1000);
             // Step 5: Set field values
-            if (args.workflowState) {
-                await updateProjectItemField(client, fieldCache, projectItemId, "Workflow State", args.workflowState, projectNumber);
-                await syncStatusField(client, fieldCache, projectItemId, args.workflowState, projectNumber);
-            }
+            await updateProjectItemField(client, fieldCache, projectItemId, "Workflow State", effectiveState, projectNumber);
+            await syncStatusField(client, fieldCache, projectItemId, effectiveState, projectNumber);
             if (effectiveEstimate) {
                 await updateProjectItemField(client, fieldCache, projectItemId, "Estimate", effectiveEstimate, projectNumber);
             }
@@ -790,7 +790,7 @@ export function registerIssueTools(server, client, fieldCache) {
                 url: issue.url,
                 projectItemId,
                 fieldsSet: {
-                    workflowState: args.workflowState || null,
+                    workflowState: effectiveState,
                     estimate: effectiveEstimate || null,
                     priority: args.priority || null,
                 },

package/package.json

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