ralph-hero-mcp-server 2.4.89 → 2.4.90

package/dist/tools/issue-tools.js

@@ -14,7 +14,7 @@ import { resolveState } from "../lib/state-resolution.js";
 import { parseDateMath } from "../lib/date-math.js";
 import { expandProfile } from "../lib/filter-profiles.js";
 import { toolSuccess, toolError } from "../types.js";
-import { ensureFieldCache, resolveIssueNodeId, resolveProjectItemId, updateProjectItemField, getCurrentFieldValue, resolveConfig, resolveFullConfig, resolveFullConfigOptionalRepo, syncStatusField, } from "../lib/helpers.js";
+import { ensureFieldCache, resolveIssueNodeId, resolveProjectItemId, updateProjectItemField, resolveConfig, resolveFullConfig, resolveFullConfigOptionalRepo, } from "../lib/helpers.js";
 // ---------------------------------------------------------------------------
 // Register issue tools
 // ---------------------------------------------------------------------------
@@ -876,198 +876,6 @@ export function registerIssueTools(server, client, fieldCache) {
         }
     });
     // -------------------------------------------------------------------------
-    // ralph_hero__update_issue
-    // -------------------------------------------------------------------------
-    server.tool("ralph_hero__update_issue", "Update a GitHub issue's basic properties (title, body, labels, assignees). Returns: number, title, url. Use update_workflow_state for state changes, update_estimate for estimates, update_priority for priorities.", {
-        owner: z
-            .string()
-            .optional()
-            .describe("GitHub owner. Defaults to GITHUB_OWNER env var"),
-        repo: z
-            .string()
-            .optional()
-            .describe("Repository name. Defaults to GITHUB_REPO env var"),
-        number: z.coerce.number().describe("Issue number"),
-        title: z.string().optional().describe("New issue title"),
-        body: z.string().optional().describe("New issue body (Markdown)"),
-        labels: z
-            .array(z.string())
-            .optional()
-            .describe("Label names (replaces existing labels)"),
-        assignees: z
-            .array(z.string())
-            .optional()
-            .describe("GitHub usernames to assign (replaces existing)"),
-    }, async (args) => {
-        try {
-            const { owner, repo } = resolveConfig(client, args);
-            const issueId = await resolveIssueNodeId(client, owner, repo, args.number);
-            // Resolve label IDs if provided
-            let labelIds;
-            if (args.labels) {
-                const labelResult = await client.query(`query($owner: String!, $repo: String!) {
-              repository(owner: $owner, name: $repo) {
-                labels(first: 100) {
-                  nodes { id name }
-                }
-              }
-            }`, { owner, repo }, { cache: true, cacheTtlMs: 5 * 60 * 1000 });
-                const allLabels = labelResult.repository.labels.nodes;
-                labelIds = args.labels
-                    .map((name) => allLabels.find((l) => l.name === name)?.id)
-                    .filter((id) => id !== undefined);
-            }
-            const result = await client.mutate(`mutation($issueId: ID!, $title: String, $body: String, $labelIds: [ID!], $assigneeIds: [ID!]) {
-            updateIssue(input: {
-              id: $issueId,
-              title: $title,
-              body: $body,
-              labelIds: $labelIds,
-              assigneeIds: $assigneeIds
-            }) {
-              issue {
-                number
-                title
-                url
-              }
-            }
-          }`, {
-                issueId,
-                title: args.title || null,
-                body: args.body || null,
-                labelIds: labelIds || null,
-                assigneeIds: null, // Would need username -> ID resolution
-            });
-            return toolSuccess({
-                number: result.updateIssue.issue.number,
-                title: result.updateIssue.issue.title,
-                url: result.updateIssue.issue.url,
-            });
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return toolError(`Failed to update issue: ${message}`);
-        }
-    });
-    // -------------------------------------------------------------------------
-    // ralph_hero__update_workflow_state
-    // -------------------------------------------------------------------------
-    server.tool("ralph_hero__update_workflow_state", "Change an issue's Workflow State using semantic intents or direct state names. Returns: number, previousState, newState, command. Semantic intents: __LOCK__ (lock for processing), __COMPLETE__ (mark done), __ESCALATE__ (needs human), __CLOSE__, __CANCEL__. Recovery: if state transition fails, verify the issue is in the project and the state name is valid.", {
-        owner: z
-            .string()
-            .optional()
-            .describe("GitHub owner. Defaults to GITHUB_OWNER env var"),
-        repo: z
-            .string()
-            .optional()
-            .describe("Repository name. Defaults to GITHUB_REPO env var"),
-        projectNumber: z.coerce.number().optional()
-            .describe("Project number override (defaults to configured project)"),
-        number: z.coerce.number().describe("Issue number"),
-        state: z
-            .string()
-            .describe("Target state: semantic intent (__LOCK__, __COMPLETE__, __ESCALATE__, __CLOSE__, __CANCEL__) " +
-            "or direct state name (e.g., 'Research Needed', 'In Progress')"),
-        command: z
-            .string()
-            .describe("Ralph command making this transition (e.g., 'ralph_research', 'ralph_plan'). " +
-            "Required for validation and semantic intent resolution."),
-    }, async (args) => {
-        try {
-            const { owner, repo, projectNumber, projectOwner } = resolveFullConfig(client, args);
-            // Resolve semantic intent or validate direct state
-            const { resolvedState, wasIntent, originalState } = resolveState(args.state, args.command);
-            // Ensure field cache is populated
-            await ensureFieldCache(client, fieldCache, projectOwner, projectNumber);
-            // Get current state for the response
-            const previousState = await getCurrentFieldValue(client, fieldCache, owner, repo, args.number, "Workflow State", projectNumber);
-            // Resolve project item ID
-            const projectItemId = await resolveProjectItemId(client, fieldCache, owner, repo, args.number, projectNumber);
-            // Update the field with the resolved state
-            await updateProjectItemField(client, fieldCache, projectItemId, "Workflow State", resolvedState, projectNumber);
-            // Sync default Status field (best-effort, one-way)
-            await syncStatusField(client, fieldCache, projectItemId, resolvedState, projectNumber);
-            const result = {
-                number: args.number,
-                previousState: previousState || "(unknown)",
-                newState: resolvedState,
-                command: args.command,
-            };
-            if (wasIntent) {
-                result.resolvedFrom = originalState;
-            }
-            return toolSuccess(result);
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return toolError(`Failed to update workflow state: ${message}`);
-        }
-    });
-    // -------------------------------------------------------------------------
-    // ralph_hero__update_estimate
-    // -------------------------------------------------------------------------
-    server.tool("ralph_hero__update_estimate", "Change an issue's Estimate in the project. Returns: number, estimate. Valid values: XS, S, M, L, XL. Recovery: if the issue is not in the project, add it first via create_issue.", {
-        owner: z
-            .string()
-            .optional()
-            .describe("GitHub owner. Defaults to GITHUB_OWNER env var"),
-        repo: z
-            .string()
-            .optional()
-            .describe("Repository name. Defaults to GITHUB_REPO env var"),
-        projectNumber: z.coerce.number().optional()
-            .describe("Project number override (defaults to configured project)"),
-        number: z.coerce.number().describe("Issue number"),
-        estimate: z.string().describe("Estimate value (XS, S, M, L, XL)"),
-    }, async (args) => {
-        try {
-            const { owner, repo, projectNumber, projectOwner } = resolveFullConfig(client, args);
-            await ensureFieldCache(client, fieldCache, projectOwner, projectNumber);
-            const projectItemId = await resolveProjectItemId(client, fieldCache, owner, repo, args.number, projectNumber);
-            await updateProjectItemField(client, fieldCache, projectItemId, "Estimate", args.estimate, projectNumber);
-            return toolSuccess({
-                number: args.number,
-                estimate: args.estimate,
-            });
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return toolError(`Failed to update estimate: ${message}`);
-        }
-    });
-    // -------------------------------------------------------------------------
-    // ralph_hero__update_priority
-    // -------------------------------------------------------------------------
-    server.tool("ralph_hero__update_priority", "Change an issue's Priority in the project. Returns: number, priority. Valid values: P0, P1, P2, P3. Recovery: if the issue is not in the project, add it first via create_issue.", {
-        owner: z
-            .string()
-            .optional()
-            .describe("GitHub owner. Defaults to GITHUB_OWNER env var"),
-        repo: z
-            .string()
-            .optional()
-            .describe("Repository name. Defaults to GITHUB_REPO env var"),
-        projectNumber: z.coerce.number().optional()
-            .describe("Project number override (defaults to configured project)"),
-        number: z.coerce.number().describe("Issue number"),
-        priority: z.string().describe("Priority value (P0, P1, P2, P3)"),
-    }, async (args) => {
-        try {
-            const { owner, repo, projectNumber, projectOwner } = resolveFullConfig(client, args);
-            await ensureFieldCache(client, fieldCache, projectOwner, projectNumber);
-            const projectItemId = await resolveProjectItemId(client, fieldCache, owner, repo, args.number, projectNumber);
-            await updateProjectItemField(client, fieldCache, projectItemId, "Priority", args.priority, projectNumber);
-            return toolSuccess({
-                number: args.number,
-                priority: args.priority,
-            });
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return toolError(`Failed to update priority: ${message}`);
-        }
-    });
-    // -------------------------------------------------------------------------
     // ralph_hero__create_comment
     // -------------------------------------------------------------------------
     server.tool("ralph_hero__create_comment", "Add a comment to a GitHub issue. Returns: commentId, issueNumber. Recovery: if issue not found, verify the issue number exists in the repository.", {

package/dist/tools/project-management-tools.js

@@ -242,51 +242,6 @@ export function registerProjectManagementTools(server, client, fieldCache) {
         }
     });
     // -------------------------------------------------------------------------
-    // ralph_hero__clear_field
-    // -------------------------------------------------------------------------
-    server.tool("ralph_hero__clear_field", "Clear a field value on a project item. Works for any single-select field (Workflow State, Estimate, Priority, Status, etc.). Returns: number, field, cleared.", {
-        owner: z.string().optional().describe("GitHub owner. Defaults to env var"),
-        repo: z.string().optional().describe("Repository name. Defaults to env var"),
-        projectNumber: z.coerce.number().optional()
-            .describe("Project number override (defaults to configured project)"),
-        number: z.coerce.number().describe("Issue number"),
-        field: z.string().describe("Field name to clear (e.g., 'Estimate', 'Priority', 'Workflow State')"),
-    }, async (args) => {
-        try {
-            const { owner, repo, projectNumber, projectOwner } = resolveFullConfig(client, args);
-            await ensureFieldCache(client, fieldCache, projectOwner, projectNumber);
-            const projectId = fieldCache.getProjectId(projectNumber);
-            if (!projectId) {
-                return toolError("Could not resolve project ID");
-            }
-            const fieldId = fieldCache.getFieldId(args.field, projectNumber);
-            if (!fieldId) {
-                const validFields = fieldCache.getFieldNames(projectNumber);
-                return toolError(`Field "${args.field}" not found in project. ` +
-                    `Valid fields: ${validFields.join(", ")}`);
-            }
-            const projectItemId = await resolveProjectItemId(client, fieldCache, owner, repo, args.number, projectNumber);
-            await client.projectMutate(`mutation($projectId: ID!, $itemId: ID!, $fieldId: ID!) {
-            clearProjectV2ItemFieldValue(input: {
-              projectId: $projectId,
-              itemId: $itemId,
-              fieldId: $fieldId
-            }) {
-              projectV2Item { id }
-            }
-          }`, { projectId, itemId: projectItemId, fieldId });
-            return toolSuccess({
-                number: args.number,
-                field: args.field,
-                cleared: true,
-            });
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return toolError(`Failed to clear field: ${message}`);
-        }
-    });
-    // -------------------------------------------------------------------------
     // ralph_hero__create_draft_issue
     // -------------------------------------------------------------------------
     server.tool("ralph_hero__create_draft_issue", "Create a draft issue in the project (no repo required). Optionally set workflow state, priority, and estimate after creation. Returns: projectItemId, title, fieldsSet.", {

package/package.json

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