@fruition/fcp-mcp-server 1.14.2 → 1.16.0

package/bin/unroo-heartbeat.sh

@@ -40,10 +40,12 @@ if [ -z "$UNROO_API_KEY" ]; then
   exit 0
 fi
 
-# Get git remote URL (if in a git repo)
+# Get git remote URL and branch (if in a git repo)
 GIT_REMOTE=""
+GIT_BRANCH=""
 if git rev-parse --git-dir > /dev/null 2>&1; then
   GIT_REMOTE=$(git remote get-url origin 2>/dev/null || echo "")
+  GIT_BRANCH=$(git symbolic-ref --short HEAD 2>/dev/null || echo "")
 fi
 
 # Get repo name from current directory
@@ -74,7 +76,8 @@ JSON_PAYLOAD=$(cat <<EOF
   "machine_id": "${MACHINE_ID}",
   "tool_name": "${TOOL_NAME:-}",
   "tool_description": "${TOOL_DESCRIPTION:-}",
-  "project_slug": "${PROJECT_SLUG:-}"
+  "project_slug": "${PROJECT_SLUG:-}",
+  "git_branch": "${GIT_BRANCH}"
 }
 EOF
 )

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
@@ -591,6 +628,18 @@ class UnrooClient {
         });
     }
     // ============================================================================
+    // Comment APIs
+    // ============================================================================
+    async addComment(taskId, input) {
+        return this.fetch(`/api/external/fcp/tasks/${encodeURIComponent(taskId)}/comments`, {
+            method: 'POST',
+            body: JSON.stringify(input),
+        });
+    }
+    async listComments(taskId) {
+        return this.fetch(`/api/external/fcp/tasks/${encodeURIComponent(taskId)}/comments`);
+    }
+    // ============================================================================
     // Parking Lot / Backlog APIs
     // ============================================================================
     async logFutureWork(input) {
@@ -1448,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'],
         },
@@ -1505,6 +1562,63 @@ 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'],
+        },
+    },
+    {
+        name: 'unroo_add_comment',
+        description: 'Add a comment to an Unroo task. Use this for progress updates, notes, or tagging people with @mentions. Comments sync to Jira and notify watchers. Use is_internal=true for team-only notes.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                task_id: {
+                    type: 'string',
+                    description: 'Task ID or Jira key (e.g., task_abc123 or FLYFRU-189)',
+                },
+                comment_text: {
+                    type: 'string',
+                    description: 'The comment content. Use @email to mention people (e.g., @tony.diaz@fruition.net)',
+                },
+                is_internal: {
+                    type: 'boolean',
+                    description: 'If true, comment is team-only (not synced to Jira, not visible to customers). Default: false',
+                },
+                mentions: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Email addresses of people to mention/notify (e.g., ["tony.diaz@fruition.net"])',
+                },
+            },
+            required: ['task_id', 'comment_text'],
+        },
+    },
+    {
+        name: 'unroo_list_comments',
+        description: 'List comments on an Unroo task. Returns all comments in reverse chronological order.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                task_id: {
+                    type: 'string',
+                    description: 'Task ID or Jira key (e.g., task_abc123 or FLYFRU-189)',
+                },
             },
             required: ['task_id'],
         },
@@ -2531,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 () => {
@@ -3061,6 +3277,41 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
+            case 'unroo_add_comment': {
+                const { task_id, comment_text, is_internal, mentions } = args;
+                const commentResult = await unrooClient.addComment(task_id, {
+                    comment_text,
+                    is_internal,
+                    mentions,
+                });
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                message: `Comment added to task ${task_id}${is_internal ? ' (internal)' : ''}`,
+                                comment: commentResult.comment,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'unroo_list_comments': {
+                const { task_id } = args;
+                const commentsResult = await unrooClient.listComments(task_id);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                total: commentsResult.total,
+                                comments: commentsResult.comments,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
             case 'unroo_get_my_tasks': {
                 const { status, limit } = args;
                 // Note: The API key determines the user, tasks are filtered server-side
@@ -3576,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.14.2",
+  "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",