ralph-hero-mcp-server 2.5.24 → 2.5.42

package/dist/github-client.js

@@ -166,6 +166,27 @@ export function createGitHubClient(clientConfig, debugLogger) {
             cache.set(cacheKey, login, 60 * 60 * 1000); // Cache for 1 hour
             return login;
         },
+        async restPost(path, body, useProjectToken = true) {
+            const token = useProjectToken
+                ? (clientConfig.projectToken ?? clientConfig.token)
+                : clientConfig.token;
+            const url = `https://api.github.com${path}`;
+            const response = await fetch(url, {
+                method: "POST",
+                headers: {
+                    Authorization: `token ${token}`,
+                    Accept: "application/vnd.github+json",
+                    "X-GitHub-Api-Version": "2022-11-28",
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(body),
+            });
+            if (!response.ok) {
+                const text = await response.text().catch(() => "");
+                throw new Error(`GitHub REST API error ${response.status} for ${path}: ${text}`);
+            }
+            return response.json();
+        },
     };
 }
 //# sourceMappingURL=github-client.js.map

package/dist/index.js

@@ -22,6 +22,7 @@ import { registerProjectManagementTools } from "./tools/project-management-tools
 import { registerHygieneTools } from "./tools/hygiene-tools.js";
 import { registerDebugTools } from "./tools/debug-tools.js";
 import { registerDecomposeTools } from "./tools/decompose-tools.js";
+import { registerViewTools } from "./tools/view-tools.js";
 /**
  * Initialize the GitHub client from environment variables.
  */
@@ -301,6 +302,8 @@ async function main() {
     registerHygieneTools(server, client, fieldCache);
     // Decompose feature tool (cross-repo decomposition via .ralph-repos.yml)
     registerDecomposeTools(server, client, fieldCache);
+    // View management tools (REST API view creation)
+    registerViewTools(server, client, fieldCache);
     // Debug tools (only when RALPH_DEBUG=true)
     if (process.env.RALPH_DEBUG === 'true') {
         registerDebugTools(server, client);

package/dist/tools/project-tools.js

@@ -386,6 +386,52 @@ async function fetchProject(client, owner, number) {
     }
     return null;
 }
+const VIEWS_QUERY_USER = `
+  query($login: String!, $number: Int!) {
+    user(login: $login) {
+      projectV2(number: $number) {
+        views(first: 50) {
+          nodes { id name number layout filter }
+        }
+      }
+    }
+  }
+`;
+const VIEWS_QUERY_ORG = `
+  query($login: String!, $number: Int!) {
+    organization(login: $login) {
+      projectV2(number: $number) {
+        views(first: 50) {
+          nodes { id name number layout filter }
+        }
+      }
+    }
+  }
+`;
+/**
+ * Fetch project views via GraphQL with user→org fallback.
+ * Returns views AND the resolved ownerType so callers can construct
+ * the correct REST API path without a separate round-trip.
+ */
+export async function fetchProjectViews(client, owner, projectNumber) {
+    // Try user first
+    try {
+        const result = await client.projectQuery(VIEWS_QUERY_USER, { login: owner, number: projectNumber });
+        const nodes = result.user?.projectV2?.views?.nodes;
+        if (nodes)
+            return { views: nodes, ownerType: "users" };
+    }
+    catch {
+        // fall through to org
+    }
+    // Try org
+    const result = await client.projectQuery(VIEWS_QUERY_ORG, { login: owner, number: projectNumber });
+    const nodes = result.organization?.projectV2?.views?.nodes;
+    if (!nodes) {
+        throw new Error(`Project #${projectNumber} not found for owner "${owner}"`);
+    }
+    return { views: nodes, ownerType: "orgs" };
+}
 async function createSingleSelectField(client, projectId, fieldName, options) {
     const result = await client.projectMutate(`mutation($projectId: ID!, $name: String!, $dataType: ProjectV2CustomFieldType!, $singleSelectOptions: [ProjectV2SingleSelectFieldOptionInput!]) {
       createProjectV2Field(input: {

package/dist/tools/view-tools.js

@@ -0,0 +1,102 @@
+/**
+ * MCP tools for GitHub Projects V2 view management.
+ *
+ * Copies views from a source project (read via GraphQL) to a target
+ * project using the REST API POST endpoint.
+ */
+import { z } from "zod";
+import { toolError, toolSuccess } from "../types.js";
+import { fetchProjectViews } from "./project-tools.js";
+/**
+ * Convert GraphQL layout enum to REST API layout value.
+ * All three variants are handled exhaustively — TypeScript will error
+ * at build time if a new layout variant is added and not handled here.
+ */
+export function toRestLayout(layout) {
+    switch (layout) {
+        case "TABLE_LAYOUT":
+            return "table";
+        case "BOARD_LAYOUT":
+            return "board";
+        case "ROADMAP_LAYOUT":
+            return "roadmap";
+    }
+}
+export function registerViewTools(server, client, _fieldCache) {
+    server.tool("ralph_hero__create_views", "Copy views from a source GitHub Project V2 to a target project using the REST API. Reads view names, layouts, and filter strings from the source project via GraphQL, then creates matching views in the target. Note: sort/group configuration is not available via API and must be set manually after creation.", {
+        owner: z
+            .string()
+            .optional()
+            .describe("GitHub owner (user or org). Defaults to RALPH_GH_OWNER env var"),
+        sourceProjectNumber: z.coerce
+            .number()
+            .describe("Project number to copy views FROM"),
+        targetProjectNumber: z.coerce
+            .number()
+            .describe("Project number to copy views INTO"),
+    }, async (args) => {
+        const owner = args.owner ?? client.config.projectOwner ?? client.config.owner;
+        if (!owner) {
+            return toolError("owner is required — set RALPH_GH_OWNER or pass owner param");
+        }
+        // Read views from source project; ownerType drives REST path selection
+        let sourceViews;
+        let ownerType;
+        try {
+            const result = await fetchProjectViews(client, owner, args.sourceProjectNumber);
+            sourceViews = result.views;
+            ownerType = result.ownerType;
+        }
+        catch (err) {
+            return toolError(`Failed to read views from project #${args.sourceProjectNumber}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        if (sourceViews.length === 0) {
+            return toolSuccess({
+                created: [],
+                failed: [],
+                count: 0,
+                sourceProject: args.sourceProjectNumber,
+                targetProject: args.targetProjectNumber,
+                message: "Source project has no views",
+            });
+        }
+        // REST path uses owner login (not numeric ID).
+        // filter is a plain top-level string matching the GraphQL field value.
+        const basePath = ownerType === "users"
+            ? `/users/${owner}/projectsV2/${args.targetProjectNumber}/views`
+            : `/orgs/${owner}/projectsV2/${args.targetProjectNumber}/views`;
+        const created = [];
+        const failed = [];
+        for (const view of sourceViews) {
+            const body = {
+                name: view.name,
+                layout: toRestLayout(view.layout),
+            };
+            if (view.filter) {
+                body.filter = view.filter;
+            }
+            try {
+                const createdView = await client.restPost(basePath, body);
+                created.push({
+                    name: createdView.name,
+                    layout: createdView.layout,
+                    id: createdView.id,
+                });
+            }
+            catch (err) {
+                failed.push({
+                    name: view.name,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        return toolSuccess({
+            created,
+            failed,
+            count: created.length,
+            sourceProject: args.sourceProjectNumber,
+            targetProject: args.targetProjectNumber,
+        });
+    });
+}
+//# sourceMappingURL=view-tools.js.map

package/package.json

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