ralph-hero-mcp-server 2.5.192 → 2.5.193

package/dist/lib/workflow-states.js

@@ -131,4 +131,22 @@ export const WORKFLOW_STATE_TO_STATUS = {
     "Canceled": "Done",
     "Human Needed": "Todo",
 };
+/**
+ * Reverse-inference map (GH-1471): when a save_issue call closes the GitHub
+ * issue but provides no explicit workflowState, infer the matching terminal
+ * board state. Keyed by `CLOSED:${stateReason ?? ""}` to mirror the lookup in
+ * issue-tools.ts. This is the symmetric inverse of the forward auto-close path.
+ *
+ * - CLOSED:COMPLETED   → Done     (issue closed as completed)
+ * - CLOSED:NOT_PLANNED → Canceled (issue closed as not planned)
+ * - CLOSED:            → Done     (close with no stateReason defaults to Done)
+ *
+ * An explicit workflowState always wins — the caller only consults this map
+ * when args.workflowState is undefined.
+ */
+export const ISSUE_STATE_TO_TERMINAL_WORKFLOW = {
+    "CLOSED:COMPLETED": "Done",
+    "CLOSED:NOT_PLANNED": "Canceled",
+    "CLOSED:": "Done",
+};
 //# sourceMappingURL=workflow-states.js.map

package/dist/tools/issue-tools.js

@@ -8,7 +8,7 @@ import { z } from "zod";
 import { paginateConnection } from "../lib/pagination.js";
 import { detectGroup } from "../lib/group-detection.js";
 import { detectPipelinePosition, OVERSIZED_ESTIMATES, } from "../lib/pipeline-detection.js";
-import { isValidState, isParentGateState, VALID_STATES, LOCK_STATES, TERMINAL_STATES, WORKFLOW_STATE_TO_STATUS, } from "../lib/workflow-states.js";
+import { isValidState, isParentGateState, VALID_STATES, LOCK_STATES, TERMINAL_STATES, WORKFLOW_STATE_TO_STATUS, ISSUE_STATE_TO_TERMINAL_WORKFLOW, } from "../lib/workflow-states.js";
 import { buildBatchMutationQuery } from "./batch-tools.js";
 import { resolveState } from "../lib/state-resolution.js";
 import { parseDateMath } from "../lib/date-math.js";
@@ -808,6 +808,7 @@ export function registerIssueTools(server, client, fieldCache) {
         "and project field values (workflow state, estimate, priority, iteration) in a single call. " +
         "Supports semantic intents (__LOCK__, __COMPLETE__, etc.) for workflowState. " +
         "Auto-closes the GitHub issue when workflowState resolves to a terminal state (Done, Canceled) unless issueState is explicitly set. " +
+        "Reverse inference: when issueState closes the issue (CLOSED→Done, CLOSED_NOT_PLANNED→Canceled) and no workflowState is provided, the board is advanced to the matching terminal state automatically. Explicit workflowState always wins. " +
         "Set estimate, priority, or iteration to null to clear the field. Use @current/@next tokens for iteration. " +
         "Returns: number, url, changes.", {
         owner: z.string().optional().describe("GitHub owner. Defaults to GITHUB_OWNER env var"),
@@ -887,6 +888,20 @@ export function registerIssueTools(server, client, fieldCache) {
                 stateReason = resolvedWorkflowState === "Canceled" ? "NOT_PLANNED" : "COMPLETED";
                 changes.autoClose = true;
             }
+            // Reverse inference: if issueState closes the issue and no explicit workflowState,
+            // default the board to the matching terminal workflow state (Done or Canceled).
+            // This is the symmetric inverse of the forward auto-close path above.
+            // Explicit workflowState always wins — this only fires when args.workflowState is absent.
+            let inferredFromClose = false;
+            if (args.workflowState === undefined && targetState === "CLOSED") {
+                const key = `CLOSED:${stateReason ?? ""}`;
+                const inferred = ISSUE_STATE_TO_TERMINAL_WORKFLOW[key];
+                if (inferred) {
+                    resolvedWorkflowState = inferred;
+                    inferredFromClose = true;
+                    changes.workflowStateInferred = inferred;
+                }
+            }
             // 3. Issue state mutations (close/reopen) - use dedicated mutations
             const hasMetadataFields = args.title !== undefined || args.body !== undefined ||
                 args.labels !== undefined || args.assignees !== undefined;
@@ -982,7 +997,8 @@ export function registerIssueTools(server, client, fieldCache) {
                 }
             }
             // 4. Project-field mutations (aliased batch for workflow state + status sync + estimate + priority)
-            if (hasProjectFields) {
+            // Also fires when workflowState was inferred from issueState (reverse-close inference).
+            if (hasProjectFields || inferredFromClose) {
                 const { projectNumber, projectOwner } = resolveFullConfig(client, args);
                 await ensureFieldCache(client, fieldCache, projectOwner, projectNumber);
                 const projectItemId = await resolveProjectItemId(client, fieldCache, owner, repo, args.number, projectNumber);

package/package.json

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