ralph-hero-mcp-server 2.4.37 → 2.4.39

package/dist/index.js

@@ -69,6 +69,9 @@ function initGitHubClient() {
             .map((s) => parseInt(s.trim(), 10))
             .filter((n) => !isNaN(n))
         : undefined;
+    const templateProjectNumber = resolveEnv("RALPH_GH_TEMPLATE_PROJECT")
+        ? parseInt(resolveEnv("RALPH_GH_TEMPLATE_PROJECT"), 10)
+        : undefined;
     if (!owner) {
         console.error("[ralph-hero] Warning: RALPH_GH_OWNER not set.\n" +
             "Most tools require this. Set in your environment or .claude/ralph-hero.local.md");
@@ -93,6 +96,7 @@ function initGitHubClient() {
         projectNumber,
         projectNumbers,
         projectOwner: projectOwner || undefined,
+        templateProjectNumber,
     });
 }
 /**

package/dist/tools/project-tools.js

@@ -106,6 +106,11 @@ export function registerProjectTools(server, client, fieldCache) {
     server.tool("ralph_hero__setup_project", "Create a new GitHub Project V2 with Workflow State, Priority, and Estimate custom fields", {
         owner: z.string().describe("GitHub owner (user or org)"),
         title: z.string().describe("Project title").default("Ralph Workflow"),
+        templateProjectNumber: z
+            .number()
+            .optional()
+            .describe("Template project number to copy from. Overrides RALPH_GH_TEMPLATE_PROJECT env var. " +
+            "When set, copies the template project (views, fields, automations) instead of creating blank."),
     }, async (args) => {
         try {
             const owner = args.owner || resolveProjectOwner(client.config);
@@ -137,31 +142,86 @@ export function registerProjectTools(server, client, fieldCache) {
             if (!ownerId) {
                 return toolError(`Owner "${owner}" not found as user or organization`);
             }
-            // Step 2: Create project (project operation)
-            const createResult = await client.projectMutate(`mutation($ownerId: ID!, $title: String!) {
-            createProjectV2(input: { ownerId: $ownerId, title: $title }) {
-              projectV2 {
-                id
-                number
-                url
-                title
+            // Resolve template project number: arg > config > undefined (blank)
+            const templatePN = args.templateProjectNumber ?? client.config.templateProjectNumber;
+            let project;
+            let fieldResults;
+            if (templatePN) {
+                // --- Copy path: clone template project ---
+                // 1. Resolve template project node ID
+                const templateProject = await fetchProject(client, owner, templatePN);
+                if (!templateProject) {
+                    return toolError(`Template project #${templatePN} not found for owner "${owner}"`);
+                }
+                // 2. Copy via copyProjectV2
+                const copyResult = await client.projectMutate(`mutation($projectId: ID!, $ownerId: ID!, $title: String!) {
+              copyProjectV2(input: {
+                projectId: $projectId
+                ownerId: $ownerId
+                title: $title
+                includeDraftIssues: false
+              }) {
+                projectV2 { id number url title }
               }
+            }`, {
+                    projectId: templateProject.id,
+                    ownerId,
+                    title: args.title,
+                });
+                project = copyResult.copyProjectV2.projectV2;
+                // 3. Fetch fields from the copied project to build fieldResults
+                const copiedProject = await fetchProject(client, owner, project.number);
+                if (!copiedProject) {
+                    return toolError(`Copied project #${project.number} not found after creation`);
+                }
+                fieldResults = {};
+                for (const f of copiedProject.fields.nodes) {
+                    if (f.options) {
+                        fieldResults[f.name] = {
+                            id: f.id,
+                            options: f.options.map((o) => o.name),
+                        };
+                    }
+                }
             }
-          }`, { ownerId, title: args.title });
-            const project = createResult.createProjectV2.projectV2;
-            // Step 3: Create custom fields
-            const fieldResults = {};
-            // Workflow State field
-            const wsField = await createSingleSelectField(client, project.id, "Workflow State", WORKFLOW_STATE_OPTIONS);
-            fieldResults["Workflow State"] = wsField;
-            // Priority field
-            const prioField = await createSingleSelectField(client, project.id, "Priority", PRIORITY_OPTIONS);
-            fieldResults["Priority"] = prioField;
-            // Estimate field
-            const estField = await createSingleSelectField(client, project.id, "Estimate", ESTIMATE_OPTIONS);
-            fieldResults["Estimate"] = estField;
-            // Populate the field cache for this project
+            else {
+                // --- Blank path: existing createProjectV2 + field creation ---
+                const createResult = await client.projectMutate(`mutation($ownerId: ID!, $title: String!) {
+              createProjectV2(input: { ownerId: $ownerId, title: $title }) {
+                projectV2 {
+                  id
+                  number
+                  url
+                  title
+                }
+              }
+            }`, { ownerId, title: args.title });
+                project = createResult.createProjectV2.projectV2;
+                fieldResults = {};
+                // Workflow State field
+                const wsField = await createSingleSelectField(client, project.id, "Workflow State", WORKFLOW_STATE_OPTIONS);
+                fieldResults["Workflow State"] = wsField;
+                // Priority field
+                const prioField = await createSingleSelectField(client, project.id, "Priority", PRIORITY_OPTIONS);
+                fieldResults["Priority"] = prioField;
+                // Estimate field
+                const estField = await createSingleSelectField(client, project.id, "Estimate", ESTIMATE_OPTIONS);
+                fieldResults["Estimate"] = estField;
+            }
+            // Shared: cache hydration (both paths)
             await ensureFieldCacheForNewProject(client, fieldCache, owner, project.number);
+            // Link configured repo to new project (best-effort, both paths)
+            let repoLink;
+            const configOwner = client.config.owner;
+            const configRepo = client.config.repo;
+            if (configOwner && configRepo) {
+                try {
+                    repoLink = await linkRepoAfterSetup(client, project.id, configOwner, configRepo);
+                }
+                catch {
+                    // Best-effort - don't fail setup if linking fails
+                }
+            }
             return toolSuccess({
                 project: {
                     id: project.id,
@@ -170,6 +230,10 @@ export function registerProjectTools(server, client, fieldCache) {
                     title: project.title,
                 },
                 fields: fieldResults,
+                ...(templatePN && {
+                    copiedFrom: { templateProjectNumber: templatePN },
+                }),
+                ...(repoLink && { repositoryLink: repoLink }),
             });
         }
         catch (error) {
@@ -847,9 +911,27 @@ async function createSingleSelectField(client, projectId, fieldName, options) {
     };
 }
 async function ensureFieldCacheForNewProject(client, fieldCache, owner, number) {
-    // Clear any stale cache and force refresh
-    fieldCache.clear();
-    client.getCache().clear();
+    // Invalidate query cache to force fresh API responses for the new project.
+    // Do NOT clear fieldCache — other projects' data must be preserved (GH-242).
+    client.getCache().invalidatePrefix("query:");
     await ensureFieldCache(client, fieldCache, owner, number);
 }
+async function linkRepoAfterSetup(client, projectId, repoOwner, repoName) {
+    const repoResult = await client.query(`query($repoOwner: String!, $repoName: String!) {
+      repository(owner: $repoOwner, name: $repoName) { id }
+    }`, { repoOwner, repoName }, { cache: true, cacheTtlMs: 60 * 60 * 1000 });
+    const repoId = repoResult.repository?.id;
+    if (!repoId) {
+        return { linked: false, repository: `${repoOwner}/${repoName}` };
+    }
+    await client.projectMutate(`mutation($projectId: ID!, $repositoryId: ID!) {
+      linkProjectV2ToRepository(input: {
+        projectId: $projectId,
+        repositoryId: $repositoryId
+      }) {
+        repository { id }
+      }
+    }`, { projectId, repositoryId: repoId });
+    return { linked: true, repository: `${repoOwner}/${repoName}` };
+}
 //# sourceMappingURL=project-tools.js.map

package/package.json

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