@hubspot/cli 7.6.0-experimental.0 → 7.7.0-experimental.1

package/bin/cli.js

@@ -40,7 +40,7 @@ const feedbackCommand = require('../commands/feedback');
 const doctorCommand = require('../commands/doctor');
 const completionCommand = require('../commands/completion');
 const appCommand = require('../commands/app');
-const testAccountCommand = require('../commands/testAccount');
+const setupMcpCommand = require('../commands/setupMcp');
 const getTerminalWidth = () => {
     const width = yargs.terminalWidth();
     if (width >= 100)
@@ -119,7 +119,7 @@ const argv = yargs
     .command(doctorCommand)
     .command(completionCommand)
     .command(appCommand)
-    .command(testAccountCommand)
+    .command(setupMcpCommand)
     .help()
     .alias('h', 'help')
     .recommendCommands()

package/bin/hsmcp.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/bin/hsmcp.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+"use strict";
+console.log('Starting MCP server...');
+try {
+    require('../mcp-server/index');
+}
+catch (error) {
+    console.error('Failed to start MCP server:');
+    console.error('Error name:', error.name || 'Unknown');
+    console.error('Error message:', error.message || 'No message');
+    console.error('Full error:', error);
+    process.exit(1);
+}

package/commands/project/validate.d.ts

@@ -0,0 +1,4 @@
+import { CommonArgs, YargsCommandModule } from '../../types/Yargs';
+type ProjectValidateArgs = CommonArgs;
+declare const projectValidateCommand: YargsCommandModule<unknown, ProjectValidateArgs>;
+export default projectValidateCommand;

package/commands/project/validate.js

@@ -0,0 +1,53 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = __importDefault(require("path"));
+const project_parsing_lib_1 = require("@hubspot/project-parsing-lib");
+const project_parsing_lib_2 = require("@hubspot/project-parsing-lib");
+const ui_1 = require("../../lib/ui");
+const config_1 = require("../../lib/projects/config");
+const lang_1 = require("../../lib/lang");
+const index_1 = require("../../lib/errorHandlers/index");
+const exitCodes_1 = require("../../lib/enums/exitCodes");
+const yargsUtils_1 = require("../../lib/yargsUtils");
+const logger_1 = require("../../lib/ui/logger");
+const command = 'validate';
+const describe = (0, ui_1.uiBetaTag)((0, lang_1.i18n)(`commands.project.subcommands.validate.describe`), false);
+async function handler(args) {
+    const { derivedAccountId } = args;
+    const { projectConfig, projectDir } = await (0, config_1.getProjectConfig)();
+    (0, config_1.validateProjectConfig)(projectConfig, projectDir);
+    try {
+        await (0, project_parsing_lib_2.translate)({
+            projectSourceDir: path_1.default.join(projectDir, projectConfig.srcDir),
+            platformVersion: projectConfig.platformVersion,
+            accountId: derivedAccountId,
+        });
+        logger_1.uiLogger.success('Project validated successfully. No Errors');
+    }
+    catch (e) {
+        if ((0, project_parsing_lib_1.isTranslationError)(e)) {
+            logger_1.uiLogger.error(e.toString());
+        }
+        else {
+            (0, index_1.logError)(e);
+        }
+        return process.exit(exitCodes_1.EXIT_CODES.ERROR);
+    }
+    process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+}
+function projectValidateBuilder(yargs) {
+    return yargs;
+}
+const builder = (0, yargsUtils_1.makeYargsBuilder)(projectValidateBuilder, command, describe, {
+    useGlobalOptions: true,
+});
+const projectValidateCommand = {
+    command,
+    describe,
+    handler,
+    builder,
+};
+exports.default = projectValidateCommand;

package/commands/project.js

@@ -20,6 +20,7 @@ const migrateApp_1 = __importDefault(require("./project/migrateApp"));
 const cloneApp_1 = __importDefault(require("./project/cloneApp"));
 const installDeps_1 = __importDefault(require("./project/installDeps"));
 const profile_1 = __importDefault(require("./project/profile"));
+const validate_1 = __importDefault(require("./project/validate"));
 const yargsUtils_1 = require("../lib/yargsUtils");
 const command = ['project', 'projects'];
 const describe = (0, ui_1.uiBetaTag)((0, lang_1.i18n)(`commands.project.describe`), false);
@@ -40,6 +41,7 @@ function projectBuilder(yargs) {
         .command(cloneApp_1.default)
         .command(installDeps_1.default)
         .command(profile_1.default)
+        .command(validate_1.default)
         .demandCommand(1, '');
     return yargs;
 }

package/commands/setupMcp.d.ts

@@ -0,0 +1,8 @@
+import { CommonArgs, YargsCommandModule } from '../types/Yargs';
+type SetupMcpArgs = CommonArgs & {
+    autoSetup?: boolean;
+    showInstructions?: boolean;
+    global?: boolean;
+};
+declare const setupMcpCommand: YargsCommandModule<unknown, SetupMcpArgs>;
+export default setupMcpCommand;

package/commands/setupMcp.js

@@ -0,0 +1,229 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const exitCodes_1 = require("../lib/enums/exitCodes");
+const en_1 = require("../lang/en");
+const yargsUtils_1 = require("../lib/yargsUtils");
+const logger_1 = require("@hubspot/local-dev-lib/logger");
+const promptUtils_1 = require("../lib/prompts/promptUtils");
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const command = 'setup-mcp';
+const describe = en_1.commands.setupMcp.describe;
+function getCursorMcpConfigPath(global = true) {
+    if (global) {
+        // Global configuration: ~/.cursor/mcp.json
+        const homeDir = os_1.default.homedir();
+        return path_1.default.join(homeDir, '.cursor', 'mcp.json');
+    }
+    else {
+        // Project-specific configuration: .cursor/mcp.json in current directory
+        return path_1.default.join(process.cwd(), '.cursor', 'mcp.json');
+    }
+}
+const MCP_SERVER_COMMAND = 'hsmcp';
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+async function readCursorConfig(global = true) {
+    const configPath = getCursorMcpConfigPath(global);
+    try {
+        if (await fs_extra_1.default.pathExists(configPath)) {
+            const content = await fs_extra_1.default.readFile(configPath, 'utf8');
+            return JSON.parse(content);
+        }
+    }
+    catch (error) {
+        logger_1.logger.debug(`Error reading Cursor config: ${error}`);
+    }
+    return { mcpServers: {} };
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+async function writeCursorConfig(config, global = true) {
+    const configPath = getCursorMcpConfigPath(global);
+    const configDir = path_1.default.dirname(configPath);
+    // Ensure the directory exists
+    await fs_extra_1.default.ensureDir(configDir);
+    // Write the config with proper formatting
+    await fs_extra_1.default.writeFile(configPath, JSON.stringify(config, null, 2));
+}
+async function setupMcpServer(global = true) {
+    try {
+        const config = await readCursorConfig(global);
+        // Check if hsmcp command is available
+        try {
+            require('child_process').execSync(`which ${MCP_SERVER_COMMAND} 2>/dev/null`, {
+                encoding: 'utf8',
+            });
+        }
+        catch (error) {
+            logger_1.logger.error(en_1.commands.setupMcp.errors.serverNotFound);
+            logger_1.logger.error(en_1.commands.setupMcp.errors.installHint);
+            return false;
+        }
+        // Check if already configured
+        if (config.mcpServers && config.mcpServers['hubspot-cli-mcp']) {
+            logger_1.logger.info(en_1.commands.setupMcp.warnings.alreadyConfigured);
+            const { shouldOverwrite } = await (0, promptUtils_1.promptUser)([
+                {
+                    type: 'confirm',
+                    name: 'shouldOverwrite',
+                    message: en_1.commands.setupMcp.prompts.overwrite,
+                    default: false,
+                },
+            ]);
+            if (!shouldOverwrite) {
+                return true;
+            }
+        }
+        // Configure the MCP server with the simple global command
+        if (!config.mcpServers) {
+            config.mcpServers = {};
+        }
+        config.mcpServers['hubspot-cli-mcp'] = {
+            command: MCP_SERVER_COMMAND,
+            args: [],
+        };
+        await writeCursorConfig(config, global);
+        const configType = global ? 'global' : 'project-specific';
+        logger_1.logger.success(en_1.commands.setupMcp.success.configured.replace('Claude', `Cursor (${configType})`));
+        logger_1.logger.info(en_1.commands.setupMcp.success.restartCursor);
+        return true;
+    }
+    catch (error) {
+        logger_1.logger.error(`${en_1.commands.setupMcp.errors.configurationFailed}: ${error}`);
+        return false;
+    }
+}
+function displayInstructions(global = true) {
+    const configPath = getCursorMcpConfigPath(global);
+    const configType = global ? 'global' : 'project-specific';
+    logger_1.logger.log(en_1.commands.setupMcp.instructions.title.replace('Claude', `Cursor (${configType})`));
+    logger_1.logger.log('');
+    logger_1.logger.log(en_1.commands.setupMcp.instructions.step1);
+    logger_1.logger.log(`  ${configPath}`);
+    logger_1.logger.log('');
+    logger_1.logger.log(en_1.commands.setupMcp.instructions.step2);
+    logger_1.logger.log('  {');
+    logger_1.logger.log('    "mcpServers": {');
+    logger_1.logger.log('      "hubspot-cli-mcp": {');
+    logger_1.logger.log(`        "command": "${MCP_SERVER_COMMAND}",`);
+    logger_1.logger.log('        "args": []');
+    logger_1.logger.log('      }');
+    logger_1.logger.log('    }');
+    logger_1.logger.log('  }');
+    logger_1.logger.log('');
+    logger_1.logger.log(en_1.commands.setupMcp.instructions.step3.replace('Claude', 'Cursor'));
+    logger_1.logger.log('');
+    logger_1.logger.log(en_1.commands.setupMcp.instructions.documentation);
+}
+async function handler(args) {
+    const useGlobal = args.global !== false; // Default to global unless explicitly set to false
+    if (args.showInstructions) {
+        displayInstructions(useGlobal);
+        process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+        return;
+    }
+    if (args.autoSetup) {
+        const success = await setupMcpServer(useGlobal);
+        process.exit(success ? exitCodes_1.EXIT_CODES.SUCCESS : exitCodes_1.EXIT_CODES.ERROR);
+        return;
+    }
+    // Interactive mode - determine scope first if not specified
+    let isGlobal = useGlobal;
+    if (args.global === undefined) {
+        const { scope } = await (0, promptUtils_1.promptUser)([
+            {
+                type: 'list',
+                name: 'scope',
+                message: en_1.commands.setupMcp.prompts.selectScope,
+                choices: [
+                    {
+                        name: en_1.commands.setupMcp.choices.global,
+                        value: 'global',
+                    },
+                    {
+                        name: en_1.commands.setupMcp.choices.project,
+                        value: 'project',
+                    },
+                ],
+            },
+        ]);
+        isGlobal = scope === 'global';
+    }
+    // Then ask what action to take
+    const { action } = await (0, promptUtils_1.promptUser)([
+        {
+            type: 'list',
+            name: 'action',
+            message: en_1.commands.setupMcp.prompts.selectAction,
+            choices: [
+                {
+                    name: en_1.commands.setupMcp.choices.autoSetup,
+                    value: 'auto',
+                },
+                {
+                    name: en_1.commands.setupMcp.choices.showInstructions,
+                    value: 'instructions',
+                },
+            ],
+        },
+    ]);
+    if (action === 'auto') {
+        const success = await setupMcpServer(isGlobal);
+        process.exit(success ? exitCodes_1.EXIT_CODES.SUCCESS : exitCodes_1.EXIT_CODES.ERROR);
+    }
+    else {
+        displayInstructions(isGlobal);
+        process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+    }
+}
+function setupMcpBuilder(yargs) {
+    yargs
+        .options({
+        'auto-setup': {
+            describe: en_1.commands.setupMcp.options.autoSetup.describe,
+            type: 'boolean',
+            default: false,
+        },
+        'show-instructions': {
+            describe: en_1.commands.setupMcp.options.showInstructions.describe,
+            type: 'boolean',
+            default: false,
+        },
+        global: {
+            describe: en_1.commands.setupMcp.options.global.describe,
+            type: 'boolean',
+        },
+    })
+        .example([
+        ['$0 setup-mcp', en_1.commands.setupMcp.examples.default],
+        ['$0 setup-mcp --auto-setup', en_1.commands.setupMcp.examples.autoSetup],
+        [
+            '$0 setup-mcp --auto-setup --global',
+            en_1.commands.setupMcp.examples.autoSetupGlobal,
+        ],
+        [
+            '$0 setup-mcp --auto-setup --no-global',
+            en_1.commands.setupMcp.examples.autoSetupProject,
+        ],
+        [
+            '$0 setup-mcp --show-instructions',
+            en_1.commands.setupMcp.examples.showInstructions,
+        ],
+    ]);
+    return yargs;
+}
+const builder = (0, yargsUtils_1.makeYargsBuilder)(setupMcpBuilder, command, describe, {
+    useGlobalOptions: true,
+});
+const setupMcpCommand = {
+    command,
+    describe,
+    handler,
+    builder,
+};
+exports.default = setupMcpCommand;
+// Legacy export for compatibility
+module.exports = setupMcpCommand;

package/lang/en.d.ts

@@ -2211,6 +2211,57 @@ Profiles enable you to reference variables in your component configuration files
             };
         };
     };
+    readonly setupMcp: {
+        readonly describe: "Configure the HubSpot CLI MCP (Model Context Protocol) server for use with Cursor.";
+        readonly errors: {
+            readonly serverNotFound: "hsmcp command not found. Please ensure the HubSpot CLI is properly installed and available in your PATH.";
+            readonly installHint: "If you installed the CLI locally, make sure to install it globally with: npm install -g @hubspot/cli";
+            readonly configurationFailed: "Failed to configure MCP server";
+        };
+        readonly warnings: {
+            readonly alreadyConfigured: "MCP server is already configured.";
+        };
+        readonly success: {
+            readonly configured: "MCP server successfully configured for Cursor.";
+            readonly restartCursor: "Please restart Cursor to apply the changes.";
+        };
+        readonly instructions: {
+            readonly title: "Manual MCP Server Configuration Instructions:";
+            readonly step1: "1. Open or create the Cursor configuration file at:";
+            readonly step2: "2. Add the following configuration to the file:";
+            readonly step3: "3. Restart Cursor to apply the changes.";
+            readonly documentation: "For more information, visit: https://docs.cursor.com/context/model-context-protocol";
+        };
+        readonly options: {
+            readonly autoSetup: {
+                readonly describe: "Automatically configure the MCP server in Cursor configuration";
+            };
+            readonly showInstructions: {
+                readonly describe: "Display manual configuration instructions instead of auto-setup";
+            };
+            readonly global: {
+                readonly describe: "Configure globally for all Cursor workspaces (default: true)";
+            };
+        };
+        readonly prompts: {
+            readonly selectAction: "How would you like to configure the MCP server?";
+            readonly selectScope: "Configure MCP server for:";
+            readonly overwrite: "MCP server is already configured. Overwrite existing configuration?";
+        };
+        readonly choices: {
+            readonly autoSetup: "Automatically configure (recommended)";
+            readonly showInstructions: "Show manual configuration instructions";
+            readonly global: "Global (all Cursor workspaces)";
+            readonly project: "Current project only";
+        };
+        readonly examples: {
+            readonly default: "Configure the MCP server interactively";
+            readonly autoSetup: "Automatically configure the MCP server";
+            readonly autoSetupGlobal: "Automatically configure the MCP server globally";
+            readonly autoSetupProject: "Automatically configure for current project only";
+            readonly showInstructions: "Display manual configuration instructions";
+        };
+    };
 };
 export declare const lib: {
     readonly process: {

package/lang/en.js

@@ -2213,6 +2213,57 @@ exports.commands = {
             },
         },
     },
+    setupMcp: {
+        describe: 'Configure the HubSpot CLI MCP (Model Context Protocol) server for use with Cursor.',
+        errors: {
+            serverNotFound: 'hsmcp command not found. Please ensure the HubSpot CLI is properly installed and available in your PATH.',
+            installHint: 'If you installed the CLI locally, make sure to install it globally with: npm install -g @hubspot/cli',
+            configurationFailed: 'Failed to configure MCP server',
+        },
+        warnings: {
+            alreadyConfigured: 'MCP server is already configured.',
+        },
+        success: {
+            configured: 'MCP server successfully configured for Cursor.',
+            restartCursor: 'Please restart Cursor to apply the changes.',
+        },
+        instructions: {
+            title: 'Manual MCP Server Configuration Instructions:',
+            step1: '1. Open or create the Cursor configuration file at:',
+            step2: '2. Add the following configuration to the file:',
+            step3: '3. Restart Cursor to apply the changes.',
+            documentation: 'For more information, visit: https://docs.cursor.com/context/model-context-protocol',
+        },
+        options: {
+            autoSetup: {
+                describe: 'Automatically configure the MCP server in Cursor configuration',
+            },
+            showInstructions: {
+                describe: 'Display manual configuration instructions instead of auto-setup',
+            },
+            global: {
+                describe: 'Configure globally for all Cursor workspaces (default: true)',
+            },
+        },
+        prompts: {
+            selectAction: 'How would you like to configure the MCP server?',
+            selectScope: 'Configure MCP server for:',
+            overwrite: 'MCP server is already configured. Overwrite existing configuration?',
+        },
+        choices: {
+            autoSetup: 'Automatically configure (recommended)',
+            showInstructions: 'Show manual configuration instructions',
+            global: 'Global (all Cursor workspaces)',
+            project: 'Current project only',
+        },
+        examples: {
+            default: 'Configure the MCP server interactively',
+            autoSetup: 'Automatically configure the MCP server',
+            autoSetupGlobal: 'Automatically configure the MCP server globally',
+            autoSetupProject: 'Automatically configure for current project only',
+            showInstructions: 'Display manual configuration instructions',
+        },
+    },
 };
 exports.lib = {
     process: {

package/lib/prompts/promptUtils.d.ts

@@ -1,5 +1,4 @@
 import { PromptConfig, GenericPromptResponse, PromptWhen, PromptChoices } from '../../types/Prompts';
-export declare const Separator: any;
 export declare function promptUser<T extends GenericPromptResponse>(config: PromptConfig<T> | PromptConfig<T>[]): Promise<T>;
 export declare function confirmPrompt(message: string, options?: {
     defaultAnswer?: boolean;

package/lib/prompts/promptUtils.js

@@ -1,13 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Separator = void 0;
 exports.promptUser = promptUser;
 exports.confirmPrompt = confirmPrompt;
 exports.listPrompt = listPrompt;
 exports.inputPrompt = inputPrompt;
 const inquirer = require('inquirer');
 const promptModule = inquirer.createPromptModule();
-exports.Separator = new inquirer.Separator();
 function promptUser(config) {
     return promptModule(config);
 }

package/mcp-server/index.d.ts

@@ -0,0 +1 @@
+export {};

package/mcp-server/index.js

@@ -0,0 +1,17 @@
+import { MCPServer } from 'mcp-framework';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Calculate the correct base path for tools
+// ToolLoader does: dirname(basePath) + "/tools"
+// We want it to look in dist/mcp-server/tools
+// So basePath should be dist/mcp-server/anything
+// __filename is dist/mcp-server/index.js, so dirname is dist/mcp-server
+// We need to provide a path like dist/mcp-server/main.js
+const basePath = join(__dirname, 'main.js');
+console.log('Debug: basePath:', basePath);
+const server = new MCPServer({
+    basePath: basePath,
+});
+server.start();

package/mcp-server/mcpLoader.d.ts

@@ -0,0 +1,5 @@
+export declare function getMCPServer(): Promise<any>;
+export declare function getMCPTool(): Promise<any>;
+export declare class MCPToolBase {
+    static create(): Promise<any>;
+}

package/mcp-server/mcpLoader.js

@@ -0,0 +1,24 @@
+// Dynamic import loader for mcp-framework to handle ESM/CommonJS compatibility
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let mcpFramework = null;
+async function loadMCPFramework() {
+    if (!mcpFramework) {
+        mcpFramework = await import('mcp-framework');
+    }
+    return mcpFramework;
+}
+export async function getMCPServer() {
+    const framework = await loadMCPFramework();
+    return framework.MCPServer;
+}
+export async function getMCPTool() {
+    const framework = await loadMCPFramework();
+    return framework.MCPTool;
+}
+// Export a ready-to-use MCPTool base class
+export class MCPToolBase {
+    static async create() {
+        const MCPTool = await getMCPTool();
+        return MCPTool;
+    }
+}

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

@@ -0,0 +1,33 @@
+import { MCPTool } from "mcp-framework";
+import { z } from "zod";
+interface ExplainProjectStructureInput {
+    section?: string;
+}
+declare class ExplainProjectStructureTool extends MCPTool<ExplainProjectStructureInput> {
+    name: string;
+    description: string;
+    schema: {
+        section: {
+            type: z.ZodOptional<z.ZodString>;
+            description: string;
+        };
+    };
+    execute(input: ExplainProjectStructureInput): Promise<{
+        section: string;
+        title: string;
+        content: string;
+        message?: undefined;
+        sections?: undefined;
+    } | {
+        message: string;
+        sections: {
+            section: string;
+            title: string;
+            content: string;
+        }[];
+        section?: undefined;
+        title?: undefined;
+        content?: undefined;
+    }>;
+}
+export default ExplainProjectStructureTool;