ralph-hero-mcp-server 2.4.28 → 2.4.31

package/dist/lib/state-resolution.js

@@ -20,6 +20,7 @@ const SEMANTIC_INTENTS = {
         ralph_plan: "Plan in Review",
         ralph_impl: "In Review",
         ralph_review: "In Progress",
+        ralph_merge: "Done",
     },
     __ESCALATE__: { "*": "Human Needed" },
     __CLOSE__: { "*": "Done" },
@@ -40,6 +41,7 @@ const COMMAND_ALLOWED_STATES = {
     ralph_impl: ["In Progress", "In Review", "Human Needed"],
     ralph_review: ["In Progress", "Ready for Plan", "Human Needed"],
     ralph_hero: ["In Review", "Human Needed"],
+    ralph_merge: ["Done", "Human Needed"],
 };
 // --- Helpers ---
 function isSemanticIntent(state) {

package/dist/tools/project-tools.js

@@ -231,6 +231,197 @@ export function registerProjectTools(server, client, fieldCache) {
         }
     });
     // -------------------------------------------------------------------------
+    // ralph_hero__list_projects
+    // -------------------------------------------------------------------------
+    server.tool("ralph_hero__list_projects", "List all GitHub Projects V2 for an owner (user or organization). Returns project summaries with item/field/view counts. Supports open/closed filtering.", {
+        owner: z
+            .string()
+            .optional()
+            .describe("GitHub owner (user or org). Defaults to RALPH_GH_PROJECT_OWNER or RALPH_GH_OWNER env var"),
+        state: z
+            .enum(["open", "closed", "all"])
+            .optional()
+            .default("open")
+            .describe('Filter by project state: "open" (default), "closed", or "all"'),
+        limit: z
+            .number()
+            .optional()
+            .default(50)
+            .describe("Maximum number of projects to return (default: 50, max: 100)"),
+    }, async (args) => {
+        try {
+            const owner = args.owner || resolveProjectOwner(client.config);
+            if (!owner) {
+                return toolError("owner is required (set RALPH_GH_PROJECT_OWNER or RALPH_GH_OWNER env var or pass explicitly)");
+            }
+            const maxItems = Math.min(args.limit ?? 50, 100);
+            const LIST_PROJECTS_QUERY = `
+          query($owner: String!, $cursor: String, $first: Int!) {
+            OWNER_TYPE(login: $owner) {
+              projectsV2(first: $first, after: $cursor, orderBy: {field: TITLE, direction: ASC}) {
+                totalCount
+                pageInfo { hasNextPage endCursor }
+                nodes {
+                  id
+                  number
+                  title
+                  shortDescription
+                  public
+                  closed
+                  url
+                  items { totalCount }
+                  fields { totalCount }
+                  views { totalCount }
+                }
+              }
+            }
+          }
+        `;
+            let allProjects = [];
+            let totalCount;
+            for (const ownerType of ["user", "organization"]) {
+                try {
+                    const result = await paginateConnection((q, vars) => client.projectQuery(q, vars), LIST_PROJECTS_QUERY.replace("OWNER_TYPE", ownerType), { owner }, `${ownerType}.projectsV2`, { maxItems });
+                    allProjects = result.nodes;
+                    totalCount = result.totalCount;
+                    break;
+                }
+                catch {
+                    // Try next owner type
+                }
+            }
+            // Client-side state filtering
+            const filtered = args.state === "all"
+                ? allProjects
+                : args.state === "closed"
+                    ? allProjects.filter((p) => p.closed)
+                    : allProjects.filter((p) => !p.closed);
+            const projects = filtered.map((p) => ({
+                id: p.id,
+                number: p.number,
+                title: p.title,
+                shortDescription: p.shortDescription,
+                public: p.public,
+                closed: p.closed,
+                url: p.url,
+                itemCount: p.items?.totalCount ?? 0,
+                fieldCount: p.fields?.totalCount ?? 0,
+                viewCount: p.views?.totalCount ?? 0,
+            }));
+            return toolSuccess({
+                owner,
+                state: args.state,
+                projects,
+                totalCount: totalCount ?? projects.length,
+                returnedCount: projects.length,
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return toolError(`Failed to list projects: ${message}`);
+        }
+    });
+    // -------------------------------------------------------------------------
+    // ralph_hero__copy_project
+    // -------------------------------------------------------------------------
+    server.tool("ralph_hero__copy_project", "Copy (duplicate) a GitHub Project V2, preserving views, custom fields, workflows, and insights. Does NOT copy items, collaborators, team links, or repository links.", {
+        sourceProjectNumber: z
+            .number()
+            .describe("Project number of the source project to copy"),
+        sourceOwner: z
+            .string()
+            .optional()
+            .describe("Owner of the source project. Defaults to RALPH_GH_PROJECT_OWNER or RALPH_GH_OWNER env var"),
+        title: z.string().describe("Title for the new project"),
+        targetOwner: z
+            .string()
+            .optional()
+            .describe("Owner for the new project. Defaults to sourceOwner. Supports cross-owner copy (e.g., personal to org)"),
+        includeDraftIssues: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Include draft issues from the source project in the copy (default: false)"),
+    }, async (args) => {
+        try {
+            const sourceOwner = args.sourceOwner || resolveProjectOwner(client.config);
+            if (!sourceOwner) {
+                return toolError("sourceOwner is required (set RALPH_GH_PROJECT_OWNER or RALPH_GH_OWNER env var or pass explicitly)");
+            }
+            // Step 1: Resolve source project node ID via fetchProject
+            const sourceProject = await fetchProject(client, sourceOwner, args.sourceProjectNumber);
+            if (!sourceProject) {
+                return toolError(`Source project #${args.sourceProjectNumber} not found for owner "${sourceOwner}"`);
+            }
+            // Step 2: Resolve target owner node ID (try user first, then org)
+            const targetOwnerLogin = args.targetOwner || sourceOwner;
+            let targetOwnerId;
+            try {
+                const userResult = await client.query(`query($login: String!) {
+              user(login: $login) { id }
+            }`, { login: targetOwnerLogin }, { cache: true });
+                targetOwnerId = userResult.user?.id;
+            }
+            catch {
+                // Not a user, try org below
+            }
+            if (!targetOwnerId) {
+                try {
+                    const orgResult = await client.query(`query($login: String!) {
+                organization(login: $login) { id }
+              }`, { login: targetOwnerLogin }, { cache: true });
+                    targetOwnerId = orgResult.organization?.id;
+                }
+                catch {
+                    // Not an org either
+                }
+            }
+            if (!targetOwnerId) {
+                return toolError(`Target owner "${targetOwnerLogin}" not found as user or organization`);
+            }
+            // Step 3: Execute copyProjectV2 mutation
+            const copyResult = await client.projectMutate(`mutation($projectId: ID!, $ownerId: ID!, $title: String!, $includeDraftIssues: Boolean!) {
+            copyProjectV2(input: {
+              projectId: $projectId
+              ownerId: $ownerId
+              title: $title
+              includeDraftIssues: $includeDraftIssues
+            }) {
+              projectV2 {
+                id
+                number
+                url
+                title
+              }
+            }
+          }`, {
+                projectId: sourceProject.id,
+                ownerId: targetOwnerId,
+                title: args.title,
+                includeDraftIssues: args.includeDraftIssues ?? false,
+            });
+            const newProject = copyResult.copyProjectV2.projectV2;
+            return toolSuccess({
+                project: {
+                    id: newProject.id,
+                    number: newProject.number,
+                    url: newProject.url,
+                    title: newProject.title,
+                },
+                copiedFrom: {
+                    number: args.sourceProjectNumber,
+                    owner: sourceOwner,
+                    title: sourceProject.title,
+                },
+                note: "Copied views, custom fields, workflows, and insights. Items, collaborators, team links, and repository links were NOT copied.",
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return toolError(`Failed to copy project: ${message}`);
+        }
+    });
+    // -------------------------------------------------------------------------
     // ralph_hero__list_project_items
     // -------------------------------------------------------------------------
     server.tool("ralph_hero__list_project_items", "List items in a GitHub Project V2, optionally filtered by Workflow State, Estimate, or Priority", {

package/package.json

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