@fruition/fcp-mcp-server 1.15.0 → 1.16.0

package/dist/index.js

@@ -41,6 +41,9 @@ const FCP_API_TOKEN = process.env.FCP_API_TOKEN || '';
 // When UNROO_API_KEY is not set, Unroo calls go through FCP's proxy at /api/mcp/unroo/*
 const UNROO_API_URL = process.env.UNROO_API_URL || 'https://app.unroo.io';
 const UNROO_API_KEY = process.env.UNROO_API_KEY || '';
+// User identity for Unroo attribution
+// Without this, all actions are attributed to whoever created the FCP API key
+const FCP_USER_EMAIL = process.env.FCP_USER_EMAIL || '';
 // If no Unroo key, use FCP as proxy (unified key setup)
 const USE_FCP_UNROO_PROXY = !UNROO_API_KEY;
 // Helper to check if Unroo functionality is available (either mode)
@@ -466,6 +469,35 @@ class FCPClient {
             body: JSON.stringify({ s3Key }),
         });
     }
+    // Clone to Staging
+    async cloneToStagingConfirm(productionSiteId, stagingSiteId) {
+        return this.fetch('/api/clone-staging/confirm', {
+            method: 'POST',
+            body: JSON.stringify({ productionSiteId, stagingSiteId }),
+        });
+    }
+    async cloneToStaging(params) {
+        return this.fetch('/api/clone-staging', {
+            method: 'POST',
+            body: JSON.stringify(params),
+        });
+    }
+    async getCloneStatus(cloneId) {
+        return this.fetch(`/api/clone-staging/${encodeURIComponent(cloneId)}`);
+    }
+    async listCloneOperations(params) {
+        const query = new URLSearchParams();
+        if (params?.productionSiteId)
+            query.set('productionSiteId', String(params.productionSiteId));
+        if (params?.stagingSiteId)
+            query.set('stagingSiteId', String(params.stagingSiteId));
+        if (params?.limit)
+            query.set('limit', String(params.limit));
+        return this.fetch(`/api/clone-staging?${query.toString()}`);
+    }
+    async getDevEnvironmentInfo(siteId) {
+        return this.fetch(`/api/sites/${siteId}/dev-info`);
+    }
 }
 // Unroo API Client
 // Supports two modes:
@@ -508,6 +540,11 @@ class UnrooClient {
             else if (this.fcpToken === 'dev_bypass') {
                 headers['X-Dev-Bypass'] = 'true';
             }
+            // Pass actual user identity so Unroo attributes actions correctly
+            // (otherwise all actions show as the FCP API key creator)
+            if (FCP_USER_EMAIL) {
+                headers['X-Acting-User-Email'] = FCP_USER_EMAIL;
+            }
         }
         else {
             // Direct Unroo API call
@@ -1460,6 +1497,14 @@ const TOOLS = [
                     type: 'string',
                     description: 'Parent task ID if this is a subtask',
                 },
+                github_branch: {
+                    type: 'string',
+                    description: 'Git branch name associated with this task',
+                },
+                github_repo: {
+                    type: 'string',
+                    description: 'GitHub repository (owner/repo format)',
+                },
             },
             required: ['title', 'project_key'],
         },
@@ -1517,6 +1562,22 @@ const TOOLS = [
                     type: 'string',
                     description: 'Resolution when marking as Done',
                 },
+                github_branch: {
+                    type: 'string',
+                    description: 'Git branch name associated with this task',
+                },
+                github_pr_url: {
+                    type: 'string',
+                    description: 'GitHub pull request URL',
+                },
+                github_pr_number: {
+                    type: 'number',
+                    description: 'GitHub pull request number',
+                },
+                github_repo: {
+                    type: 'string',
+                    description: 'GitHub repository (owner/repo format)',
+                },
             },
             required: ['task_id'],
         },
@@ -2584,6 +2645,108 @@ const TOOLS = [
             required: ['s3Key'],
         },
     },
+    // Clone to Staging (unified prod → staging with files + database + search/replace)
+    {
+        name: 'fcp_clone_to_staging',
+        description: 'Clone production to staging environment. Combines file sync (from DO snapshots) and database sync (from S3 backups pulled from RO replicas) into a single tracked operation. Requires a confirmation token from fcp_clone_confirm first, unless triggerType is "mcp".',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productionSiteId: {
+                    type: 'number',
+                    description: 'Production site ID',
+                },
+                stagingSiteId: {
+                    type: 'number',
+                    description: 'Staging site ID to clone into',
+                },
+                includeFiles: {
+                    type: 'boolean',
+                    description: 'Whether to sync files from production snapshot (default: true)',
+                },
+                includeDatabase: {
+                    type: 'boolean',
+                    description: 'Whether to sync database from latest backup (default: true)',
+                },
+                runSearchReplace: {
+                    type: 'boolean',
+                    description: 'Whether to run domain search/replace after DB sync (default: true)',
+                },
+                backupId: {
+                    type: 'string',
+                    description: 'Specific backup ID to restore from (optional, defaults to latest)',
+                },
+            },
+            required: ['productionSiteId', 'stagingSiteId'],
+        },
+    },
+    {
+        name: 'fcp_clone_confirm',
+        description: 'Generate a safety confirmation token for a clone-to-staging operation. Returns token (5-min TTL) plus site info and latest backup age.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productionSiteId: {
+                    type: 'number',
+                    description: 'Production site ID',
+                },
+                stagingSiteId: {
+                    type: 'number',
+                    description: 'Staging site ID',
+                },
+            },
+            required: ['productionSiteId', 'stagingSiteId'],
+        },
+    },
+    {
+        name: 'fcp_clone_status',
+        description: 'Get the status of a clone-to-staging operation. Returns progress, step statuses (files, database, search/replace), and errors.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                cloneId: {
+                    type: 'string',
+                    description: 'Clone operation ID (e.g., clone_abc12345_lxyz)',
+                },
+            },
+            required: ['cloneId'],
+        },
+    },
+    {
+        name: 'fcp_clone_list',
+        description: 'List recent clone-to-staging operations for a site. Shows history of all clone operations with status.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productionSiteId: {
+                    type: 'number',
+                    description: 'Filter by production site ID',
+                },
+                stagingSiteId: {
+                    type: 'number',
+                    description: 'Filter by staging site ID',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Max results (default: 20)',
+                },
+            },
+        },
+    },
+    {
+        name: 'fcp_get_dev_environment_info',
+        description: 'Get developer environment info for a site. Shows what capabilities are available (clone to staging, download database, file sync, local setup), current state (latest backup age, clone status), staging sites, and quick action URLs. Use this to help developers understand what they can do with a site.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                siteId: {
+                    type: 'number',
+                    description: 'The production site ID to get dev environment info for',
+                },
+            },
+            required: ['siteId'],
+        },
+    },
 ];
 // Register tool handlers
 server.setRequestHandler(ListToolsRequestSchema, async () => {
@@ -3664,6 +3827,53 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
                 };
             }
+            // Clone to Staging tools
+            case 'fcp_clone_to_staging': {
+                const { productionSiteId, stagingSiteId, includeFiles, includeDatabase, runSearchReplace, backupId } = args;
+                // For MCP callers, auto-generate confirmation token (bypasses type-to-confirm UI)
+                const confirmResult = await client.cloneToStagingConfirm(productionSiteId, stagingSiteId);
+                const token = confirmResult.token;
+                const result = await client.cloneToStaging({
+                    productionSiteId,
+                    stagingSiteId,
+                    includeFiles: includeFiles !== false,
+                    includeDatabase: includeDatabase !== false,
+                    runSearchReplace: runSearchReplace !== false,
+                    confirmationToken: token,
+                    backupId,
+                });
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            case 'fcp_clone_confirm': {
+                const { productionSiteId, stagingSiteId } = args;
+                const result = await client.cloneToStagingConfirm(productionSiteId, stagingSiteId);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            case 'fcp_clone_status': {
+                const { cloneId } = args;
+                const result = await client.getCloneStatus(cloneId);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            case 'fcp_clone_list': {
+                const { productionSiteId, stagingSiteId, limit } = args;
+                const result = await client.listCloneOperations({ productionSiteId, stagingSiteId, limit });
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            case 'fcp_get_dev_environment_info': {
+                const { siteId } = args;
+                const result = await client.getDevEnvironmentInfo(siteId);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
             default:
                 throw new Error(`Unknown tool: ${name}`);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fruition/fcp-mcp-server",
-  "version": "1.15.0",
+  "version": "1.16.0",
   "description": "MCP Server for FCP Launch Coordination System - enables Claude Code to interact with FCP launches and track development time",
   "main": "dist/index.js",
   "type": "module",