@hubspot/cli 7.7.0-experimental.0 → 7.7.0-experimental.2

package/mcp-server/tools/GenerateAppComponentTool.d.ts

@@ -1,5 +1,5 @@
-import { MCPTool } from "mcp-framework";
-import { z } from "zod";
+import { MCPTool } from 'mcp-framework';
+import { z } from 'zod';
 interface GenerateAppComponentInput {
     appName: string;
     uid: string;

package/mcp-server/tools/GenerateAppComponentTool.js

@@ -1,16 +1,16 @@
-import { MCPTool } from "mcp-framework";
-import { z } from "zod";
+import { MCPTool } from 'mcp-framework';
+import { z } from 'zod';
 class GenerateAppComponentTool extends MCPTool {
-    name = "generateAppComponent";
-    description = "Generates an app component (top-level) with proper folder structure and hsmeta.json configuration file. Apps provide OAuth authentication that sub-components depend on.";
+    name = 'generateAppComponent';
+    description = 'Generates an app component (top-level) with proper folder structure and hsmeta.json configuration file. Apps provide OAuth authentication that sub-components depend on.';
     schema = {
         appName: {
             type: z.string(),
-            description: "Name of the app (used for file naming and default display name)",
+            description: 'Name of the app (used for file naming and default display name)',
         },
         uid: {
             type: z.string(),
-            description: "Unique identifier for the app component (must be unique per-project)",
+            description: 'Unique identifier for the app component (must be unique per-project)',
         },
         description: {
             type: z.string().optional(),
@@ -18,11 +18,11 @@ class GenerateAppComponentTool extends MCPTool {
         },
         displayName: {
             type: z.string().optional(),
-            description: "Display name of the app. Defaults to the appName",
+            description: 'Display name of the app. Defaults to the appName',
         },
         distribution: {
             type: z.string().optional(),
-            description: "Distribution description. Defaults to 'A public app'",
+            description: "Distribution type (one of 'marketplace' or 'private'). Defaults to 'marketplace'",
         },
         supportEmail: {
             type: z.string().optional(),
@@ -46,11 +46,11 @@ class GenerateAppComponentTool extends MCPTool {
         },
         requiredScopes: {
             type: z.array(z.string()).optional(),
-            description: "Required OAuth scopes. Consider what sub-components you plan to add. Defaults to basic CRM contact scopes",
+            description: 'Required OAuth scopes. Consider what sub-components you plan to add. Defaults to basic CRM contact scopes',
         },
         optionalScopes: {
             type: z.array(z.string()).optional(),
-            description: "Optional OAuth scopes. Defaults to empty array",
+            description: 'Optional OAuth scopes. Defaults to empty array',
         },
         permittedFetchUrls: {
             type: z.array(z.string()).optional(),
@@ -62,23 +62,23 @@ class GenerateAppComponentTool extends MCPTool {
         },
     };
     async execute(input) {
-        const { appName, uid, description = "A public app", displayName = appName, distribution = "A public app", supportEmail = "support@example.com", documentationUrl = "https://example.com/docs", supportUrl = "https://example.com/support", supportPhone = "+18005555555", redirectUrls = ["http://localhost:3000/oauth-callback"], requiredScopes = [
-            "crm.objects.contacts.read",
-            "crm.objects.contacts.write",
-        ], optionalScopes = [], permittedFetchUrls = ["https://api.example.com"], plannedFeatures = [], } = input;
+        const { appName, uid, description = 'A public app', displayName = appName, distribution = 'marketplace', supportEmail = 'support@example.com', documentationUrl = 'https://example.com/docs', supportUrl = 'https://example.com/support', supportPhone = '+18005555555', redirectUrls = ['http://localhost:3000/oauth-callback'], requiredScopes = [
+            'crm.objects.contacts.read',
+            'crm.objects.contacts.write',
+        ], optionalScopes = [], permittedFetchUrls = ['https://api.example.com'], plannedFeatures = [], } = input;
         // Generate the sanitized app name for file naming
-        const sanitizedAppName = appName.toLowerCase().replace(/\s+/g, "-");
+        const sanitizedAppName = appName.toLowerCase().replace(/\s+/g, '-');
         const fileName = `${sanitizedAppName}-hsmeta.json`;
-        const folderPath = "src/app";
+        const folderPath = 'src/app';
         const appConfig = {
             uid: uid,
-            type: "app",
+            type: 'app',
             config: {
                 description: description,
                 name: displayName,
                 distribution: distribution,
                 auth: {
-                    type: "oauth",
+                    type: 'oauth',
                     redirectUrls: redirectUrls,
                     requiredScopes: requiredScopes,
                     optionalScopes: optionalScopes,
@@ -108,8 +108,8 @@ class GenerateAppComponentTool extends MCPTool {
             fileName: fileName,
             fullPath: `${folderPath}/${fileName}`,
             architecture: {
-                componentType: "top-level",
-                role: "authentication-provider",
+                componentType: 'top-level',
+                role: 'authentication-provider',
                 singularComponent: true,
                 dependents: "All sub-components (cards, functions, settings, etc.) will depend on this app's authentication",
             },
@@ -121,8 +121,8 @@ class GenerateAppComponentTool extends MCPTool {
                 `This is a TOP-LEVEL component that provides OAuth authentication`,
                 `Sub-components (features) will live within ${folderPath}/ and depend on this app's authentication`,
                 `The app component uid: ${uid} must be unique within your project`,
-                "Consider what sub-components you plan to add and ensure sufficient OAuth scopes",
-                "Typically there is one app component per project (singular component)",
+                'Consider what sub-components you plan to add and ensure sufficient OAuth scopes',
+                'Typically there is one app component per project (singular component)',
             ],
         };
     }
@@ -130,52 +130,52 @@ class GenerateAppComponentTool extends MCPTool {
         const recommendations = [];
         if (plannedFeatures.length === 0) {
             return [
-                "Consider what sub-components you plan to add to determine required OAuth scopes",
-                "Cards typically need CRM object read access",
-                "Functions may need broader API access depending on functionality",
-                "Webhooks may need specific event subscription scopes",
+                'Consider what sub-components you plan to add to determine required OAuth scopes',
+                'Cards typically need CRM object read access',
+                'Functions may need broader API access depending on functionality',
+                'Webhooks may need specific event subscription scopes',
             ];
         }
         const scopeMap = {
             cards: [
-                "Cards typically need: crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.read",
+                'Cards typically need: crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.read',
             ],
             functions: [
-                "Functions may need: broader API access depending on functionality",
-                "Consider: crm.objects.*.read, crm.objects.*.write if manipulating CRM data",
+                'Functions may need: broader API access depending on functionality',
+                'Consider: crm.objects.*.read, crm.objects.*.write if manipulating CRM data',
             ],
             webhooks: [
-                "Webhooks may need: specific event subscription scopes",
-                "Consider: webhooks scope and relevant object scopes for events you want to receive",
+                'Webhooks may need: specific event subscription scopes',
+                'Consider: webhooks scope and relevant object scopes for events you want to receive',
             ],
             settings: [
-                "Settings typically need: minimal scopes, may inherit from other components",
+                'Settings typically need: minimal scopes, may inherit from other components',
             ],
-            "marketing-events": [
-                "Marketing events may need: marketing event creation and management scopes",
+            'marketing-events': [
+                'Marketing events may need: marketing event creation and management scopes',
             ],
-            "timeline-events": [
-                "Timeline events may need: timeline read/write scopes for the relevant objects",
+            'timeline-events': [
+                'Timeline events may need: timeline read/write scopes for the relevant objects',
             ],
-            "workflow-actions": [
-                "Workflow actions may need: workflow and automation related scopes",
+            'workflow-actions': [
+                'Workflow actions may need: workflow and automation related scopes',
             ],
         };
-        plannedFeatures.forEach((feature) => {
+        plannedFeatures.forEach(feature => {
             if (scopeMap[feature]) {
-                recommendations.push(`For ${feature}: ${scopeMap[feature].join(", ")}`);
+                recommendations.push(`For ${feature}: ${scopeMap[feature].join(', ')}`);
             }
         });
         return recommendations;
     }
     generateNextSteps(plannedFeatures, appPath) {
         const steps = [
-            "1. Create the app component configuration file and directory structure",
-            "2. Test OAuth flow and ensure authentication works correctly",
-            "3. Add sub-components within the app directory as needed:",
+            '1. Create the app component configuration file and directory structure',
+            '2. Test OAuth flow and ensure authentication works correctly',
+            '3. Add sub-components within the app directory as needed:',
         ];
         if (plannedFeatures.length > 0) {
-            plannedFeatures.forEach((feature) => {
+            plannedFeatures.forEach(feature => {
                 steps.push(`   - ${appPath}/${feature}/`);
             });
         }
@@ -186,7 +186,7 @@ class GenerateAppComponentTool extends MCPTool {
             steps.push(`   - ${appPath}/webhooks/ (for event handling)`);
         }
         steps.push("4. Ensure all sub-components can access required APIs with the app's OAuth scopes");
-        steps.push("5. Test the complete application with all components integrated");
+        steps.push('5. Test the complete application with all components integrated');
         return steps;
     }
 }

package/mcp-server/tools/HubSpotCLIHelper.d.ts

@@ -1,6 +1,13 @@
 interface CLICheckResult {
     isInstalled: boolean;
     version?: string;
+    debugInfo?: {
+        command: string;
+        success: boolean;
+        output: string;
+        error?: string;
+        env?: Record<string, string | undefined>;
+    };
 }
 interface CommandResult {
     success: boolean;
@@ -8,6 +15,7 @@ interface CommandResult {
     error?: string;
 }
 export declare class HubSpotCLIHelper {
+    private execAsync;
     checkCLIInstallation(): Promise<CLICheckResult>;
     installCLI(): Promise<CommandResult>;
     runCommand(command: string): Promise<CommandResult>;

package/mcp-server/tools/HubSpotCLIHelper.js

@@ -1,8 +1,22 @@
+import { exec } from 'child_process';
+import { promisify } from 'util';
 export class HubSpotCLIHelper {
+    execAsync = promisify(exec);
     async checkCLIInstallation() {
         try {
             // Run hs --version to check if CLI is installed
-            const result = await this.runCommand("hs --version");
+            const result = await this.runCommand('hs --version');
+            const debugInfo = {
+                command: 'hs --version',
+                success: result.success,
+                output: result.output,
+                error: result.error,
+                env: {
+                    PATH: process.env.PATH,
+                    NODE_PATH: process.env.NODE_PATH,
+                    npm_config_prefix: process.env.npm_config_prefix,
+                },
+            };
             if (result.success) {
                 // Parse version from output (typically like "@hubspot/cli/4.0.0 darwin-x64 node-v18.17.0")
                 const versionMatch = result.output.match(/@hubspot\/cli\/(\d+\.\d+\.\d+)/);
@@ -10,62 +24,84 @@ export class HubSpotCLIHelper {
                 return {
                     isInstalled: true,
                     version: version,
+                    debugInfo,
                 };
             }
             else {
-                return { isInstalled: false };
+                return {
+                    isInstalled: false,
+                    debugInfo,
+                };
             }
         }
         catch (error) {
-            return { isInstalled: false };
+            return {
+                isInstalled: false,
+                debugInfo: {
+                    command: 'hs --version',
+                    success: false,
+                    output: '',
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                    env: {
+                        PATH: process.env.PATH,
+                        NODE_PATH: process.env.NODE_PATH,
+                        npm_config_prefix: process.env.npm_config_prefix,
+                    },
+                },
+            };
         }
     }
     async installCLI() {
         try {
-            return await this.runCommand("npm install -g @hubspot/cli");
+            return await this.runCommand('npm install -g @hubspot/cli');
         }
         catch (error) {
-            const errorMessage = error instanceof Error ? error.message : "Unknown error";
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
             return {
                 success: false,
-                output: "",
+                output: '',
                 error: errorMessage,
             };
         }
     }
     async runCommand(command) {
         try {
-            // Execute the actual command using terminal
-            const { exec } = require("child_process");
-            const { promisify } = require("util");
-            const execAsync = promisify(exec);
-            const result = await execAsync(command);
+            // Use the same environment as the current process, including PATH
+            const result = await this.execAsync(command, {
+                env: process.env,
+                shell: '/bin/bash',
+            });
             return {
                 success: true,
-                output: result.stdout || result.stderr || "",
+                output: result.stdout || result.stderr || '',
             };
         }
         catch (error) {
             // Command failed (e.g., command not found, non-zero exit code)
+            const err = error;
             return {
                 success: false,
-                output: error.stdout || "",
-                error: error.stderr || error.message || "Command execution failed",
+                output: err.stdout || '',
+                error: err.stderr || err.message || 'Command execution failed',
             };
         }
     }
-    async runProjectCommand(command, projectPath = ".") {
+    async runProjectCommand(command, projectPath = '.') {
         try {
+            // Get absolute path to avoid any relative path issues
+            const path = await import('path');
+            const absoluteProjectPath = path.resolve(projectPath);
+            // Add debugging information about directories
+            const debugCommand = `echo "MCP Server CWD: $(pwd)" && echo "Project Path: ${absoluteProjectPath}" && ls -la "${absoluteProjectPath}" | head -5`;
             // Change to the project directory and run command
-            const cdCommand = projectPath !== "." ? `cd ${projectPath} && ` : "";
-            const fullCommand = `${cdCommand}${command}`;
+            const fullCommand = `cd "${absoluteProjectPath}" && ${debugCommand} && ${command}`;
             return await this.runCommand(fullCommand);
         }
         catch (error) {
-            const errorMessage = error instanceof Error ? error.message : "Unknown error";
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
             return {
                 success: false,
-                output: "",
+                output: '',
                 error: errorMessage,
             };
         }

package/mcp-server/tools/UploadProjectTool.d.ts

@@ -1,5 +1,5 @@
-import { MCPTool } from "mcp-framework";
-import { z } from "zod";
+import { MCPTool } from 'mcp-framework';
+import { z } from 'zod';
 interface UploadProjectInput {
     projectPath?: string;
     accountId?: string;

package/mcp-server/tools/UploadProjectTool.js

@@ -1,26 +1,27 @@
-import { MCPTool } from "mcp-framework";
-import { z } from "zod";
-import HubSpotCLIHelper from "./HubSpotCLIHelper.js";
+import { MCPTool } from 'mcp-framework';
+import { z } from 'zod';
+import HubSpotCLIHelper from './HubSpotCLIHelper.js';
 class UploadProjectTool extends MCPTool {
-    name = "uploadProject";
-    description = "Uploads a developer project to HubSpot using the HubSpot CLI";
+    name = 'uploadProject';
+    description = 'Uploads a developer project to HubSpot using the HubSpot CLI';
     cliHelper = new HubSpotCLIHelper();
     schema = {
         projectPath: {
             type: z.string().optional(),
-            description: "Path to the project directory. Defaults to current directory",
+            description: 'Path to the project directory. When using MCP server globally, provide the absolute path to your project (e.g., "/Users/yourname/projects/my-hubspot-project"). Defaults to "." for local usage.',
         },
         accountId: {
             type: z.string().optional(),
-            description: "HubSpot account ID to upload to. If not provided, uses CLI default or prompts",
+            description: 'HubSpot account ID to upload to. If not provided, uses CLI default or prompts',
         },
         autoInstallCLI: {
             type: z.boolean().optional(),
-            description: "Whether to automatically install HubSpot CLI if not found. Defaults to false",
+            description: 'Whether to automatically install HubSpot CLI if not found. Defaults to false',
         },
     };
     async execute(input) {
-        const { projectPath = ".", accountId, autoInstallCLI = false } = input;
+        // Default to current directory "." which should resolve relative to where the MCP client is running
+        const { projectPath = '.', accountId, autoInstallCLI = false } = input;
         try {
             // Step 1: Check if HubSpot CLI is installed
             const cliCheckResult = await this.cliHelper.checkCLIInstallation();
@@ -30,20 +31,20 @@ class UploadProjectTool extends MCPTool {
                     const installResult = await this.cliHelper.installCLI();
                     if (!installResult.success) {
                         return {
-                            status: "cli-install-failed",
-                            message: "❌ Failed to install HubSpot CLI automatically",
+                            status: 'cli-install-failed',
+                            message: '❌ Failed to install HubSpot CLI automatically',
                             error: installResult.error,
                             actions: [
                                 {
-                                    action: "install-cli-manually",
-                                    command: "npm install -g @hubspot/cli",
-                                    description: "Install HubSpot CLI manually",
+                                    action: 'install-cli-manually',
+                                    command: 'npm install -g @hubspot/cli',
+                                    description: 'Install HubSpot CLI manually',
                                 },
                             ],
                             troubleshooting: [
-                                "Try installing the CLI manually: npm install -g @hubspot/cli",
-                                "Ensure you have npm installed and proper permissions",
-                                "Run the upload command again after CLI installation",
+                                'Try installing the CLI manually: npm install -g @hubspot/cli',
+                                'Ensure you have npm installed and proper permissions',
+                                'Run the upload command again after CLI installation',
                             ],
                         };
                     }
@@ -51,37 +52,38 @@ class UploadProjectTool extends MCPTool {
                     const recheckResult = await this.cliHelper.checkCLIInstallation();
                     if (!recheckResult.isInstalled) {
                         return {
-                            status: "cli-install-verification-failed",
-                            message: "❌ CLI installation completed but verification failed",
+                            status: 'cli-install-verification-failed',
+                            message: '❌ CLI installation completed but verification failed',
                             troubleshooting: [
                                 "Try running 'hs --version' manually to verify installation",
-                                "Restart your terminal/shell session",
-                                "Check if the CLI was installed to the correct PATH",
+                                'Restart your terminal/shell session',
+                                'Check if the CLI was installed to the correct PATH',
                             ],
                         };
                     }
                 }
                 else {
                     return {
-                        status: "cli-not-found",
-                        message: "HubSpot CLI not found. Install it to upload projects.",
+                        status: 'cli-not-found',
+                        message: 'HubSpot CLI not found. Install it to upload projects.',
+                        error: `Debug info: ${JSON.stringify(cliCheckResult.debugInfo, null, 2)}`,
                         actions: [
                             {
-                                action: "install-cli",
-                                command: "npm install -g @hubspot/cli",
-                                description: "Install HubSpot CLI globally",
+                                action: 'install-cli',
+                                command: 'npm install -g @hubspot/cli',
+                                description: 'Install HubSpot CLI globally',
                             },
                         ],
                         nextSteps: [
-                            "1. Install HubSpot CLI globally",
-                            "2. Authenticate with your HubSpot account (hs auth)",
-                            "3. Run project upload again",
+                            '1. Install HubSpot CLI globally',
+                            '2. Authenticate with your HubSpot account (hs auth)',
+                            '3. Run project upload again',
                         ],
                     };
                 }
             }
             // Step 2: Build the upload command
-            let uploadCommand = "hs project upload";
+            let uploadCommand = 'hs project upload';
             if (accountId) {
                 uploadCommand += ` --account=${accountId}`;
             }
@@ -91,56 +93,71 @@ class UploadProjectTool extends MCPTool {
                 // Parse successful upload output
                 const output = uploadResult.output;
                 return {
-                    status: "success",
-                    message: "✅ Project uploaded successfully to HubSpot!",
+                    status: 'success',
+                    message: '✅ Project uploaded successfully to HubSpot!',
                     cliVersion: cliCheckResult.version,
                     uploadOutput: output,
                     accountId: accountId,
                     projectPath: projectPath,
                     nextSteps: [
-                        "1. Check your HubSpot account to verify the project appears",
-                        "2. Test your components in the HubSpot environment",
-                        "3. Monitor for any runtime errors or issues",
+                        '1. Check your HubSpot account to verify the project appears',
+                        '2. Test your components in the HubSpot environment',
+                        '3. Monitor for any runtime errors or issues',
                         "4. Use 'hs project logs' to view application logs if needed",
                     ],
                 };
             }
             else {
                 // Parse upload failure
-                const errorOutput = uploadResult.output || uploadResult.error || "Upload failed";
+                const errorOutput = uploadResult.output || uploadResult.error || 'Upload failed';
+                // Check if this looks like a path issue with global MCP server
+                const isPathIssue = errorOutput.includes('Unable to locate a project configuration file') || errorOutput.includes('MCP Server CWD: /');
                 return {
-                    status: "upload-failed",
-                    message: "❌ Project upload failed",
+                    status: 'upload-failed',
+                    message: '❌ Project upload failed',
                     cliVersion: cliCheckResult.version,
                     uploadOutput: errorOutput,
                     error: uploadResult.error,
                     troubleshooting: [
                         "Ensure you're authenticated: run 'hs auth' to login",
-                        "Verify your account has permission to upload projects",
+                        'Verify your account has permission to upload projects',
                         "Check that your project is valid: run 'hs project validate' first",
-                        "Ensure you have network connectivity to HubSpot",
-                        "Try uploading to a different account if you have access to multiple",
+                        'Ensure you have network connectivity to HubSpot',
+                        'Try uploading to a different account if you have access to multiple',
+                        `Working directory was: ${projectPath}`,
+                        ...(isPathIssue
+                            ? [
+                                '⚠️  PATH ISSUE DETECTED: You may be using the global MCP server',
+                                'When using global MCP server, provide the absolute path to your project:',
+                                'Example: {"projectPath": "/Users/yourname/projects/my-hubspot-project"}',
+                                'Or consider running the MCP server locally from your project directory',
+                            ]
+                            : []),
                     ],
                     nextSteps: [
-                        "1. Check authentication status: hs auth info",
-                        "2. Validate project first: hs project validate",
-                        "3. Review the error output above for specific issues",
-                        "4. Try the upload command again after fixing issues",
+                        '1. Check authentication status: hs auth info',
+                        '2. Validate project first: hs project validate',
+                        ...(isPathIssue
+                            ? ['3. Provide absolute projectPath if using global MCP server']
+                            : []),
+                        '4. Review the error output above for specific issues',
+                        '5. Try the upload command again after fixing issues',
                     ],
                 };
             }
         }
         catch (error) {
-            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
             return {
-                status: "error",
-                message: "An error occurred during project upload",
+                status: 'error',
+                message: 'An error occurred during project upload',
                 error: errorMessage,
                 troubleshooting: [
                     "Ensure you're in a valid developer project directory",
-                    "Check that hsproject.json exists in the project root",
-                    "Verify HubSpot CLI is properly installed and accessible",
+                    'Check that hsproject.json exists in the project root',
+                    'Verify HubSpot CLI is properly installed and accessible',
                     "Try running 'hs project upload' manually to see detailed output",
+                    `Attempted project path: ${projectPath}`,
                 ],
             };
         }

package/mcp-server/tools/ValidateProjectTool.d.ts

@@ -1,5 +1,5 @@
-import { MCPTool } from "mcp-framework";
-import { z } from "zod";
+import { MCPTool } from 'mcp-framework';
+import { z } from 'zod';
 interface ValidateProjectInput {
     autoFix?: boolean;
     projectPath?: string;
@@ -13,7 +13,7 @@ interface ValidationResponse {
     errorAnalysis?: Array<{
         category: string;
         issue: string;
-        severity: "error" | "warning";
+        severity: 'error' | 'warning';
         component?: string;
         file?: string;
     }>;

package/mcp-server/tools/ValidateProjectTool.js

@@ -1,40 +1,42 @@
-import { MCPTool } from "mcp-framework";
-import { z } from "zod";
-import HubSpotCLIHelper from "./HubSpotCLIHelper.js";
+import { MCPTool } from 'mcp-framework';
+import { z } from 'zod';
+import HubSpotCLIHelper from './HubSpotCLIHelper.js';
 class ValidateProjectTool extends MCPTool {
-    name = "validateProject";
-    description = "Validates a developer project using the HubSpot CLI and provides guidance for fixing any validation errors";
+    name = 'validateProject';
+    description = 'Validates a developer project using the HubSpot CLI and provides guidance for fixing any validation errors';
     cliHelper = new HubSpotCLIHelper();
     schema = {
         autoFix: {
             type: z.boolean().optional(),
-            description: "Whether to attempt automatic fixes for common validation errors. Defaults to false",
+            description: 'Whether to attempt automatic fixes for common validation errors. Defaults to false',
         },
         projectPath: {
             type: z.string().optional(),
-            description: "Path to the project directory. Defaults to current directory",
+            description: 'Path to the project directory. When using MCP server globally, provide the absolute path to your project (e.g., "/Users/yourname/projects/my-hubspot-project"). Defaults to "." for local usage.',
         },
     };
     async execute(input) {
-        const { autoFix = false, projectPath = "." } = input;
+        // Default to current directory "." which should resolve relative to where the MCP client is running
+        const { autoFix = false, projectPath = '.' } = input;
         try {
             // Step 1: Check if HubSpot CLI is installed
             const cliCheckResult = await this.cliHelper.checkCLIInstallation();
             if (!cliCheckResult.isInstalled) {
                 return {
-                    status: "cli-not-found",
-                    message: "HubSpot CLI not found. Installing...",
+                    status: 'cli-not-found',
+                    error: `Debug info: ${JSON.stringify(cliCheckResult.debugInfo, null, 2)}`,
+                    message: 'HubSpot CLI not found. Installing...',
                     actions: [
                         {
-                            action: "install-cli",
-                            command: "npm install -g @hubspot/cli",
-                            description: "Installing HubSpot CLI globally",
+                            action: 'install-cli',
+                            command: 'npm install -g @hubspot/cli',
+                            description: 'Installing HubSpot CLI globally',
                         },
                     ],
                     nextSteps: [
-                        "1. Install HubSpot CLI globally",
-                        "2. Run project validation again",
-                        "3. Follow any additional guidance for fixing validation errors",
+                        '1. Install HubSpot CLI globally',
+                        '2. Run project validation again',
+                        '3. Follow any additional guidance for fixing validation errors',
                     ],
                 };
             }
@@ -42,18 +44,18 @@ class ValidateProjectTool extends MCPTool {
             const validationResult = await this.runProjectValidation(projectPath);
             if (validationResult.isValid) {
                 return {
-                    status: "valid",
-                    message: "✅ Project validation passed! Your developer project is properly configured.",
+                    status: 'valid',
+                    message: '✅ Project validation passed! Your developer project is properly configured.',
                     cliVersion: cliCheckResult.version,
                     validationOutput: validationResult.output,
-                    projectStructure: "All components and configurations follow platform conventions",
+                    projectStructure: 'All components and configurations follow platform conventions',
                 };
             }
             // Step 3: Parse validation errors and provide guidance
             const errorAnalysis = this.analyzeValidationErrors(validationResult.errors);
             const suggestions = this.generateFixSuggestions(errorAnalysis);
             const response = {
-                status: "validation-failed",
+                status: 'validation-failed',
                 message: "❌ Project validation failed. Here's how to fix the issues:",
                 cliVersion: cliCheckResult.version,
                 validationOutput: validationResult.output,
@@ -68,36 +70,49 @@ class ValidateProjectTool extends MCPTool {
             return response;
         }
         catch (error) {
-            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
             return {
-                status: "error",
-                message: "An error occurred during project validation",
+                status: 'error',
+                message: 'An error occurred during project validation',
                 error: errorMessage,
                 troubleshooting: [
                     "Ensure you're in a valid developer project directory",
-                    "Check that hsproject.json exists in the project root",
-                    "Verify HubSpot CLI is properly installed and accessible",
+                    'Check that hsproject.json exists in the project root',
+                    'Verify HubSpot CLI is properly installed and accessible',
                     "Try running 'hs project validate' manually to see detailed output",
+                    `Attempted project path: ${projectPath}`,
                 ],
             };
         }
     }
     async runProjectValidation(projectPath) {
         try {
-            const result = await this.cliHelper.runProjectCommand("hs project validate", projectPath);
+            const result = await this.cliHelper.runProjectCommand('hs project validate', projectPath);
             if (result.success) {
                 // Parse the validation output to determine if it passed
                 const output = result.output;
                 // Check for validation success indicators
-                const isValid = output.includes("✅") ||
-                    output.includes("Project validation passed") ||
-                    output.includes("valid") ||
-                    !output.includes("Project validation failed:");
+                const isValid = output.includes('✅') ||
+                    output.includes('Project validation passed') ||
+                    output.includes('valid') ||
+                    !output.includes('Project validation failed:');
                 // Parse structured validation errors if present
                 const errors = [];
-                if (!isValid && output.includes("Project validation failed:")) {
+                if (!isValid && output.includes('Project validation failed:')) {
                     errors.push(...this.parseValidationErrors(output));
                 }
+                // Add debugging information about directory context
+                if (result.output.includes('Unable to locate a project configuration file')) {
+                    errors.push(`Working directory was: ${projectPath}`);
+                    errors.push("Make sure you're running this from a directory containing hsproject.json");
+                    // Check if this looks like a global MCP server path issue
+                    if (result.output.includes('MCP Server CWD: /')) {
+                        errors.push('⚠️  PATH ISSUE DETECTED: You may be using the global MCP server');
+                        errors.push('When using global MCP server, provide the absolute path to your project:');
+                        errors.push('Example: {"projectPath": "/Users/yourname/projects/my-hubspot-project"}');
+                        errors.push('Or consider running the MCP server locally from your project directory');
+                    }
+                }
                 return {
                     isValid: isValid,
                     output: output,
@@ -106,16 +121,22 @@ class ValidateProjectTool extends MCPTool {
             }
             else {
                 // Command failed to run
-                const errorMessage = result.error || "Failed to run project validation";
+                const errorMessage = result.error || 'Failed to run project validation';
+                const errors = [errorMessage];
+                // Add debugging information about directory context
+                if (result.output.includes('Unable to locate a project configuration file')) {
+                    errors.push(`Working directory was: ${projectPath}`);
+                    errors.push("Make sure you're running this from a directory containing hsproject.json");
+                }
                 return {
                     isValid: false,
-                    output: result.output || "",
-                    errors: [errorMessage],
+                    output: result.output || '',
+                    errors: errors,
                 };
             }
         }
         catch (error) {
-            const errorMessage = error instanceof Error ? error.message : "Unknown validation error";
+            const errorMessage = error instanceof Error ? error.message : 'Unknown validation error';
             throw new Error(`Failed to run project validation: ${errorMessage}`);
         }
     }
@@ -125,8 +146,8 @@ class ValidateProjectTool extends MCPTool {
     }
     parseValidationErrors(output) {
         const errors = [];
-        const lines = output.split("\n");
-        let currentFile = "";
+        const lines = output.split('\n');
+        let currentFile = '';
         let inErrorSection = false;
         for (const line of lines) {
             // Look for file error headers like "Encountered the following errors for src/app/file.json:"
@@ -138,7 +159,7 @@ class ValidateProjectTool extends MCPTool {
             }
             // Parse individual error lines (start with tab and dash)
             if (inErrorSection && line.match(/^\s*-\s+/)) {
-                const errorText = line.replace(/^\s*-\s+/, "").trim();
+                const errorText = line.replace(/^\s*-\s+/, '').trim();
                 if (errorText) {
                     errors.push(`${currentFile}: ${errorText}`);
                 }
@@ -146,7 +167,7 @@ class ValidateProjectTool extends MCPTool {
             }
             // Handle multi-line errors with additional indentation
             if (inErrorSection && line.match(/^\s{2,}-\s+/)) {
-                const errorText = line.replace(/^\s*-\s+/, "").trim();
+                const errorText = line.replace(/^\s*-\s+/, '').trim();
                 if (errorText && errors.length > 0) {
                     // Append to the last error as additional context
                     errors[errors.length - 1] += `\n  ${errorText}`;
@@ -154,10 +175,10 @@ class ValidateProjectTool extends MCPTool {
                 continue;
             }
             // Reset when we hit an empty line or new section
-            if (line.trim() === "" ||
-                (!line.startsWith("\t") && !line.startsWith(" "))) {
+            if (line.trim() === '' ||
+                (!line.startsWith('\t') && !line.startsWith(' '))) {
                 inErrorSection = false;
-                currentFile = "";
+                currentFile = '';
             }
         }
         return errors;
@@ -165,37 +186,37 @@ class ValidateProjectTool extends MCPTool {
     analyzeValidationErrors(errors) {
         const analysis = [];
         for (const error of errors) {
-            const filePath = error.split(":")[0];
-            const errorMessage = error.substring(error.indexOf(":") + 1).trim();
-            let category = "unknown";
-            let component = "unknown";
-            let severity = "error";
+            const filePath = error.split(':')[0];
+            const errorMessage = error.substring(error.indexOf(':') + 1).trim();
+            let category = 'unknown';
+            let component = 'unknown';
+            let severity = 'error';
             // Extract file information
-            if (filePath.includes("hsproject.json")) {
-                category = "project-config";
-                component = "project";
+            if (filePath.includes('hsproject.json')) {
+                category = 'project-config';
+                component = 'project';
             }
-            else if (filePath.includes("-hsmeta.json")) {
-                category = "component-config";
+            else if (filePath.includes('-hsmeta.json')) {
+                category = 'component-config';
                 component = this.extractComponentFromPath(filePath);
             }
-            else if (filePath.includes("package.json")) {
-                category = "dependencies";
+            else if (filePath.includes('package.json')) {
+                category = 'dependencies';
                 component = this.extractComponentFromPath(filePath);
-                severity = "warning";
+                severity = 'warning';
             }
             // Analyze error message content
-            if (errorMessage.includes("Invalid JSON")) {
-                category = "json-syntax";
+            if (errorMessage.includes('Invalid JSON')) {
+                category = 'json-syntax';
             }
-            else if (errorMessage.includes("Missing required field")) {
-                category = "required-field";
+            else if (errorMessage.includes('Missing required field')) {
+                category = 'required-field';
             }
-            else if (errorMessage.includes("must NOT have additional properties")) {
-                category = "schema-validation";
+            else if (errorMessage.includes('must NOT have additional properties')) {
+                category = 'schema-validation';
             }
-            else if (errorMessage.includes("entrypoint")) {
-                category = "entrypoint";
+            else if (errorMessage.includes('entrypoint')) {
+                category = 'entrypoint';
             }
             analysis.push({
                 category: category,
@@ -209,46 +230,46 @@ class ValidateProjectTool extends MCPTool {
     }
     extractComponentFromPath(filePath) {
         // Extract component type from file path like "src/app/cards/my-card-hsmeta.json"
-        if (filePath.includes("/app/")) {
-            const pathParts = filePath.split("/app/")[1].split("/");
+        if (filePath.includes('/app/')) {
+            const pathParts = filePath.split('/app/')[1].split('/');
             if (pathParts.length > 1) {
                 return pathParts[0]; // e.g., "cards", "functions", etc.
             }
-            return "app";
+            return 'app';
         }
         // Handle top-level app component files
-        if (filePath.includes("-hsmeta.json")) {
-            return "app";
+        if (filePath.includes('-hsmeta.json')) {
+            return 'app';
         }
-        return "unknown";
+        return 'unknown';
     }
     generateFixSuggestions(errorAnalysis) {
         const suggestions = [];
         for (const error of errorAnalysis) {
             switch (error.category) {
-                case "project-config":
-                    suggestions.push("Fix hsproject.json: Ensure it contains 'name', 'srcDir', and 'platformVersion' fields", "Use the generateProjectConfig tool to create a valid hsproject.json file");
+                case 'project-config':
+                    suggestions.push("Fix hsproject.json: Ensure it contains 'name', 'srcDir', and 'platformVersion' fields", 'Use the generateProjectConfig tool to create a valid hsproject.json file');
                     break;
-                case "component-config":
-                    suggestions.push(`Fix ${error.component} component: Check the *-hsmeta.json file structure`, "Ensure the component follows the envelope pattern: uid, type, config", `Use the appropriate generate component tool for ${error.component} type`);
+                case 'component-config':
+                    suggestions.push(`Fix ${error.component} component: Check the *-hsmeta.json file structure`, 'Ensure the component follows the envelope pattern: uid, type, config', `Use the appropriate generate component tool for ${error.component} type`);
                     break;
-                case "json-syntax":
-                    suggestions.push(`Fix JSON syntax error in ${error.file}`, "Check for missing commas, brackets, or quotes in the JSON file", "Use a JSON validator to identify the specific syntax issue");
+                case 'json-syntax':
+                    suggestions.push(`Fix JSON syntax error in ${error.file}`, 'Check for missing commas, brackets, or quotes in the JSON file', 'Use a JSON validator to identify the specific syntax issue');
                     break;
-                case "required-field":
-                    suggestions.push(`Add missing required field: ${this.extractFieldFromError(error.issue)}`, `Update ${error.file} to include all required fields`, "Refer to the platform documentation for required field specifications");
+                case 'required-field':
+                    suggestions.push(`Add missing required field: ${this.extractFieldFromError(error.issue)}`, `Update ${error.file} to include all required fields`, 'Refer to the platform documentation for required field specifications');
                     break;
-                case "schema-validation":
-                    suggestions.push(`Fix schema validation error in ${error.file}`, "Remove additional properties that are not allowed", `Check ${error.component} component schema requirements`, "Ensure all field types match the expected schema");
+                case 'schema-validation':
+                    suggestions.push(`Fix schema validation error in ${error.file}`, 'Remove additional properties that are not allowed', `Check ${error.component} component schema requirements`, 'Ensure all field types match the expected schema');
                     break;
-                case "dependencies":
-                    suggestions.push("Fix package.json: Ensure React and @hubspot/ui-extensions dependencies are present", "Run 'npm install' to install missing dependencies", "Check that package.json is in the correct component directory");
+                case 'dependencies':
+                    suggestions.push('Fix package.json: Ensure React and @hubspot/ui-extensions dependencies are present', "Run 'npm install' to install missing dependencies", 'Check that package.json is in the correct component directory');
                     break;
-                case "entrypoint":
-                    suggestions.push("Fix component entrypoint: Ensure the React file exists at the specified path", "Check that the entrypoint path in *-hsmeta.json matches the actual file location", "Verify the React component exports properly");
+                case 'entrypoint':
+                    suggestions.push('Fix component entrypoint: Ensure the React file exists at the specified path', 'Check that the entrypoint path in *-hsmeta.json matches the actual file location', 'Verify the React component exports properly');
                     break;
                 default:
-                    suggestions.push(`Review error in ${error.file || "project"}: ${error.issue}`);
+                    suggestions.push(`Review error in ${error.file || 'project'}: ${error.issue}`);
             }
         }
         return [...new Set(suggestions)]; // Remove duplicates
@@ -256,53 +277,53 @@ class ValidateProjectTool extends MCPTool {
     extractFieldFromError(errorMessage) {
         // Extract field name from messages like "Missing required field: config.description"
         const match = errorMessage.match(/Missing required field:\s*(.+)/);
-        return match ? match[1] : "unknown field";
+        return match ? match[1] : 'unknown field';
     }
     generateNextSteps(errorAnalysis, autoFix) {
         const steps = [];
         if (autoFix) {
-            steps.push("1. Review auto-fix actions and apply them");
+            steps.push('1. Review auto-fix actions and apply them');
         }
         else {
-            steps.push("1. Review the validation errors and suggestions above");
+            steps.push('1. Review the validation errors and suggestions above');
         }
-        const hasProjectConfig = errorAnalysis.some((e) => e.category === "project-config");
-        const hasComponentIssues = errorAnalysis.some((e) => e.category === "component-config");
-        const hasDependencyIssues = errorAnalysis.some((e) => e.category === "dependencies");
+        const hasProjectConfig = errorAnalysis.some(e => e.category === 'project-config');
+        const hasComponentIssues = errorAnalysis.some(e => e.category === 'component-config');
+        const hasDependencyIssues = errorAnalysis.some(e => e.category === 'dependencies');
         if (hasProjectConfig) {
-            steps.push("2. Fix hsproject.json configuration issues first");
+            steps.push('2. Fix hsproject.json configuration issues first');
         }
         if (hasComponentIssues) {
-            steps.push("3. Fix component configuration issues");
+            steps.push('3. Fix component configuration issues');
         }
         if (hasDependencyIssues) {
-            steps.push("4. Install missing dependencies");
+            steps.push('4. Install missing dependencies');
         }
-        steps.push("5. Run validation again to verify fixes");
-        steps.push("6. Test your components work correctly in development");
+        steps.push('5. Run validation again to verify fixes');
+        steps.push('6. Test your components work correctly in development');
         return steps;
     }
     generateAutoFixActions(errorAnalysis) {
         const actions = [];
         for (const error of errorAnalysis) {
             switch (error.category) {
-                case "project-config":
+                case 'project-config':
                     actions.push({
-                        action: "fix-project-config",
-                        description: "Generate valid hsproject.json configuration",
-                        tool: "generateProjectConfig",
+                        action: 'fix-project-config',
+                        description: 'Generate valid hsproject.json configuration',
+                        tool: 'generateProjectConfig',
                     });
                     break;
-                case "dependencies":
+                case 'dependencies':
                     actions.push({
-                        action: "install-dependencies",
-                        description: "Install missing npm dependencies",
-                        command: "npm install",
+                        action: 'install-dependencies',
+                        description: 'Install missing npm dependencies',
+                        command: 'npm install',
                     });
                     break;
-                case "component-config":
+                case 'component-config':
                     actions.push({
-                        action: "fix-component-config",
+                        action: 'fix-component-config',
                         description: `Fix ${error.component} component configuration`,
                         tool: `generate${error.component}Component`,
                     });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@hubspot/cli",
-    "version": "7.7.0-experimental.0",
+    "version": "7.7.0-experimental.2",
     "description": "The official CLI for developing on HubSpot",
     "license": "Apache-2.0",
     "repository": "https://github.com/HubSpot/hubspot-cli",