@hubspot/cli 8.0.12-experimental.0 → 8.0.12-experimental.1

package/lib/projects/uieLinting.d.ts

@@ -10,6 +10,10 @@ export declare const REQUIRED_PACKAGES_AND_MIN_VERSIONS: {
     readonly prettier: "3.0.0";
     readonly jiti: "2.6.1";
 };
+export declare const LINT_SCRIPTS: {
+    readonly lint: "eslint .";
+    readonly 'lint:fix': "eslint . --fix";
+};
 export declare function isEslintInstalled(directory: string): boolean;
 export declare function areAllLintPackagesInstalled(directory: string): boolean;
 export declare function getMissingLintPackages(directory: string): {
@@ -36,3 +40,8 @@ export declare function displayLintResults(results: Array<{
     success: boolean;
     output: string;
 }>): void;
+export declare function getMissingLintScripts(directory: string): string[];
+export declare function addLintScriptsToPackageJson(directory: string): {
+    added: string[];
+    relativePath: string;
+};

package/lib/projects/uieLinting.js

@@ -7,7 +7,7 @@ import { fetchRepoFile } from '@hubspot/local-dev-lib/api/github';
 import { getProjectPackageJsonLocations, isPackageInstalled, } from '../dependencyManagement.js';
 import { commands } from '../../lang/en.js';
 import { uiLogger } from '../ui/logger.js';
-import { safeGetPackageJsonCached } from '../npm/packageJson.js';
+import { clearPackageJsonCache, safeGetPackageJsonCached, } from '../npm/packageJson.js';
 import { debugError } from '../errorHandlers/index.js';
 import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, DEFAULT_PROJECT_TEMPLATE_BRANCH, } from '../constants.js';
@@ -40,6 +40,10 @@ const DEPRECATED_ESLINT_CONFIG_FILES = [
     '.eslintrc.json',
     '.eslintrc',
 ];
+export const LINT_SCRIPTS = {
+    lint: 'eslint .',
+    'lint:fix': 'eslint . --fix',
+};
 function getPackageVersionFromPackageJson(directory, packageName) {
     const packageJsonPath = path.join(directory, 'package.json');
     const packageJson = safeGetPackageJsonCached(packageJsonPath);
@@ -239,3 +243,43 @@ export function displayLintResults(results) {
         });
     }
 }
+export function getMissingLintScripts(directory) {
+    const packageJsonPath = path.join(directory, 'package.json');
+    const packageJson = safeGetPackageJsonCached(packageJsonPath);
+    if (!packageJson) {
+        return [];
+    }
+    return Object.keys(LINT_SCRIPTS).filter(scriptName => !packageJson.scripts?.[scriptName]);
+}
+export function addLintScriptsToPackageJson(directory) {
+    const packageJsonPath = path.join(directory, 'package.json');
+    try {
+        const rawContent = fs.readFileSync(packageJsonPath, 'utf-8');
+        const packageJson = JSON.parse(rawContent);
+        if (!packageJson.scripts) {
+            packageJson.scripts = {};
+        }
+        const added = [];
+        for (const [scriptName, scriptValue] of Object.entries(LINT_SCRIPTS)) {
+            if (!packageJson.scripts[scriptName]) {
+                packageJson.scripts[scriptName] = scriptValue;
+                added.push(scriptName);
+            }
+        }
+        if (added.length > 0) {
+            fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n', 'utf-8');
+            clearPackageJsonCache();
+        }
+        return {
+            added,
+            relativePath: path.relative(process.cwd(), packageJsonPath),
+        };
+    }
+    catch {
+        uiLogger.warn(commands.project.lint.failedToAddLintScripts(packageJsonPath));
+        return {
+            added: [],
+            relativePath: path.relative(process.cwd(), packageJsonPath),
+        };
+    }
+}

package/lib/ui/accountTable.d.ts

@@ -0,0 +1,8 @@
+import { HubSpotConfigAccount } from '@hubspot/local-dev-lib/types/Accounts';
+export declare function sortAndMapAccounts(accounts: HubSpotConfigAccount[]): {
+    [key: string]: HubSpotConfigAccount[];
+};
+export declare function getAccountData(mappedAccountData: {
+    [key: string]: HubSpotConfigAccount[];
+}): string[][];
+export declare function renderAccountTable(showAllLabel?: boolean): void;

package/lib/ui/accountTable.js

@@ -0,0 +1,67 @@
+import { HUBSPOT_ACCOUNT_TYPES, HUBSPOT_ACCOUNT_TYPE_STRINGS, } from '@hubspot/local-dev-lib/constants/config';
+import { isSandbox, isDeveloperTestAccount } from '../accountTypes.js';
+import { getAllConfigAccounts } from '@hubspot/local-dev-lib/config';
+import { commands } from '../../lang/en.js';
+import { renderTable } from '../../ui/render.js';
+import { uiLogger } from './logger.js';
+export function sortAndMapAccounts(accounts) {
+    const mappedAccountData = {};
+    // Standard and app developer accounts
+    accounts
+        .filter(p => p.accountType &&
+        (p.accountType === HUBSPOT_ACCOUNT_TYPES.STANDARD ||
+            p.accountType === HUBSPOT_ACCOUNT_TYPES.APP_DEVELOPER))
+        .forEach(account => {
+        mappedAccountData[account.accountId] = [account];
+    });
+    // Non-standard accounts (sandbox, developer test account)
+    accounts
+        .filter(p => p.accountType && (isSandbox(p) || isDeveloperTestAccount(p)))
+        .forEach(p => {
+        if (p.parentAccountId) {
+            mappedAccountData[p.parentAccountId] = [
+                ...(mappedAccountData[p.parentAccountId] || []),
+                p,
+            ];
+        }
+        else {
+            mappedAccountData[p.accountId] = [p];
+        }
+    });
+    return mappedAccountData;
+}
+export function getAccountData(mappedAccountData) {
+    const accountData = [];
+    Object.entries(mappedAccountData).forEach(([key, set]) => {
+        const hasParentAccount = set.filter(p => p.accountId === parseInt(key, 10))[0];
+        set.forEach(account => {
+            let name = `${account.name} [${HUBSPOT_ACCOUNT_TYPE_STRINGS[account.accountType]}]`;
+            if (isSandbox(account)) {
+                if (hasParentAccount && set.length > 1) {
+                    name = `↳ ${name}`;
+                }
+            }
+            else if (isDeveloperTestAccount(account)) {
+                if (hasParentAccount && set.length > 1) {
+                    name = `↳ ${name}`;
+                }
+            }
+            accountData.push([name, String(account.accountId), account.authType]);
+        });
+    });
+    return accountData;
+}
+export function renderAccountTable(showAllLabel = false) {
+    const accountsList = getAllConfigAccounts();
+    const mappedAccountData = sortAndMapAccounts(accountsList);
+    const accountData = getAccountData(mappedAccountData);
+    const tableHeader = [
+        commands.account.subcommands.list.labels.name,
+        commands.account.subcommands.list.labels.accountId,
+        commands.account.subcommands.list.labels.authType,
+    ];
+    uiLogger.log(showAllLabel
+        ? commands.account.subcommands.list.allAccounts
+        : commands.account.subcommands.list.accounts);
+    renderTable(tableHeader, accountData, true);
+}

package/lib/yargs/parseYargsOrExit.d.ts

@@ -0,0 +1,4 @@
+import { ArgumentsCamelCase, Argv } from 'yargs';
+type YargsFailureHandler<T> = (message: string | null, error: unknown, parser: Argv<T>) => never;
+export declare function parseYargsOrExit<T>(parser: Argv<T>, handleFailure: YargsFailureHandler<T>): Promise<ArgumentsCamelCase<T>>;
+export {};

package/lib/yargs/parseYargsOrExit.js

@@ -0,0 +1,25 @@
+function getYargsErrorMessage(error) {
+    return error instanceof Error && error.name === 'YError' ? error.message : '';
+}
+function getYargsFailureMessage(message, error) {
+    if (message) {
+        return message;
+    }
+    return getYargsErrorMessage(error) || message;
+}
+export async function parseYargsOrExit(parser, handleFailure) {
+    let failureHandled = false;
+    const parserWithFailureHandler = parser.fail((message, error, yargs) => {
+        failureHandled = true;
+        return handleFailure(getYargsFailureMessage(message, error), error, yargs);
+    });
+    try {
+        return await parserWithFailureHandler.parseAsync();
+    }
+    catch (error) {
+        if (failureHandled) {
+            throw error;
+        }
+        return handleFailure(getYargsErrorMessage(error), error, parserWithFailureHandler);
+    }
+}

package/mcp-server/server.js

@@ -20,15 +20,19 @@ REQUIRED WORKFLOWS
 1. Documentation lookup: always call \`search-docs\` first, then
    \`fetch-doc\` on the most relevant result(s) before planning, writing
    code, or answering platform/API questions. Do not answer from memory.
-2. Editing \`*-hsmeta.json\`: call \`get-feature-config-schema\` for that
+2. Locating a HubSpot project: when the current working directory is not
+   a HubSpot project (no \`hsproject.json\`) or you need to determine
+   whether a directory contains one, call \`find-projects\` before
+   running any tool that requires a project path.
+3. Editing \`*-hsmeta.json\`: call \`get-feature-config-schema\` for that
    feature type first to learn the allowed fields and values.
-3. Debugging a failed build: start with \`get-build-status\` to surface
+4. Debugging a failed build: start with \`get-build-status\` to surface
    error messages, and only reach for \`get-build-logs\` for deeper
    troubleshooting or warnings.
-4. Reading serverless function logs: call \`list-cms-serverless-functions\`
+5. Reading serverless function logs: call \`list-cms-serverless-functions\`
    first to discover the endpoint path, then
    \`get-cms-serverless-function-logs\`.
-5. App analytics: call \`get-apps-info\` to discover \`appId\` values
+6. App analytics: call \`get-apps-info\` to discover \`appId\` values
    before \`get-api-usage-patterns-by-app-id\`.
 
 OUTPUT

package/mcp-server/tools/index.js

@@ -18,6 +18,7 @@ import { HsCreateFunctionTool } from './cms/HsCreateFunctionTool.js';
 import { HsListFunctionsTool } from './cms/HsListFunctionsTool.js';
 import { HsFunctionLogsTool } from './cms/HsFunctionLogsTool.js';
 import { CreateTestAccountTool } from './project/CreateTestAccountTool.js';
+import { FindProjectsTool } from './project/FindProjectsTool.js';
 export function registerProjectTools(mcpServer, logger) {
     return [
         new UploadProjectTools(mcpServer, logger).register(),
@@ -34,6 +35,7 @@ export function registerProjectTools(mcpServer, logger) {
         new GetApplicationInfoTool(mcpServer, logger).register(),
         new GetBuildLogsTool(mcpServer, logger).register(),
         new GetBuildStatusTool(mcpServer, logger).register(),
+        new FindProjectsTool(mcpServer, logger).register(),
     ];
 }
 export function registerCmsTools(mcpServer, logger) {

package/mcp-server/tools/project/AddFeatureToProjectTool.js

@@ -71,7 +71,7 @@ export class AddFeatureToProjectTool extends Tool {
         return this.mcpServer.registerTool(toolName, {
             title: 'Add feature to HubSpot Project',
             description: `Adds a feature to an existing HubSpot project.
-          Only works for projects with platformVersion '2025.2' and beyond`,
+          Only works for projects with platformVersion '2025.2' and beyond. If you do not know the project path, use the find-projects tool first to locate HubSpot projects in the workspace.`,
             inputSchema,
             annotations: {
                 readOnlyHint: false,

package/mcp-server/tools/project/CreateTestAccountTool.js

@@ -57,7 +57,7 @@ const inputSchema = {
     contentLevel: z
         .enum(ACCOUNT_LEVEL_CHOICES)
         .optional()
-        .describe(`CMS Hub tier level. Options: ${ACCOUNT_LEVEL_CHOICES.join(', ')}. Defaults to ENTERPRISE if not specified.`),
+        .describe(`Content Hub tier level. Options: ${ACCOUNT_LEVEL_CHOICES.join(', ')}. Defaults to ENTERPRISE if not specified.`),
     commerceLevel: z
         .enum(ACCOUNT_LEVEL_CHOICES_WITHOUT_STARTER)
         .optional()

package/mcp-server/tools/project/DeployProjectTool.js

@@ -43,7 +43,7 @@ export class DeployProjectTool extends Tool {
     register() {
         return this.mcpServer.registerTool(toolName, {
             title: 'Deploy a build of HubSpot Project',
-            description: 'Takes a build number and a project name and deploys that build of the project. DO NOT run this tool unless the user specifies they would like to deploy the project.',
+            description: 'Takes a build number and a project name and deploys that build of the project. DO NOT run this tool unless the user specifies they would like to deploy the project. If you do not know the project path, use the find-projects tool first to locate HubSpot projects in the workspace.',
             inputSchema,
             annotations: {
                 readOnlyHint: false,

package/mcp-server/tools/project/FindProjectsTool.d.ts

@@ -0,0 +1,15 @@
+import { TextContentResponse } from '../../types.js';
+import { Tool } from '../../Tool.js';
+import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { McpLogger } from '../../utils/logger.js';
+import { z } from 'zod';
+declare const inputSchemaZodObject: z.ZodObject<{
+    absoluteDirectory: z.ZodString;
+}, z.core.$strip>;
+export type FindProjectsInputSchema = z.infer<typeof inputSchemaZodObject>;
+export declare class FindProjectsTool extends Tool<FindProjectsInputSchema> {
+    constructor(mcpServer: McpServer, logger: McpLogger);
+    handler({ absoluteDirectory, }: FindProjectsInputSchema): Promise<TextContentResponse>;
+    register(): RegisteredTool;
+}
+export {};

package/mcp-server/tools/project/FindProjectsTool.js

@@ -0,0 +1,60 @@
+import { Tool } from '../../Tool.js';
+import { z } from 'zod';
+import { formatTextContents } from '../../utils/content.js';
+import { walk } from '@hubspot/local-dev-lib/fs';
+import path from 'path';
+import { PROJECT_CONFIG_FILE } from '../../../lib/constants.js';
+const TOOL_NAME = 'find-projects';
+const IGNORE_DIRS = ['node_modules', '.git', '.vite'];
+const inputSchema = {
+    absoluteDirectory: z
+        .string()
+        .describe('The absolute path to the directory to search for HubSpot projects in.'),
+};
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+const inputSchemaZodObject = z.object({ ...inputSchema });
+export class FindProjectsTool extends Tool {
+    constructor(mcpServer, logger) {
+        super(mcpServer, logger, TOOL_NAME);
+    }
+    async handler({ absoluteDirectory, }) {
+        try {
+            const allFiles = await walk(absoluteDirectory, IGNORE_DIRS);
+            const projectFiles = allFiles.filter(file => path.basename(file) === PROJECT_CONFIG_FILE);
+            if (projectFiles.length === 0) {
+                return formatTextContents(`No ${PROJECT_CONFIG_FILE} files found under ${absoluteDirectory}.`);
+            }
+            const projectDirs = projectFiles.map(file => path.dirname(file));
+            const output = [
+                `Found ${projectFiles.length} project(s):`,
+                '',
+                ...projectDirs.map(dir => `  ${dir}`),
+            ].join('\n');
+            return formatTextContents(output);
+        }
+        catch (error) {
+            this.logger.debug(TOOL_NAME, {
+                message: 'Handler caught error',
+                error: error instanceof Error ? error.message : String(error),
+            });
+            const cause = error instanceof Error ? error.cause : undefined;
+            const causeMessage = cause instanceof Error ? `: ${cause.message}` : '';
+            const errorMessage = error instanceof Error
+                ? error.message || `FileSystemError${causeMessage}`
+                : String(error);
+            return formatTextContents(`Error searching for projects: ${errorMessage}`);
+        }
+    }
+    register() {
+        return this.mcpServer.registerTool(TOOL_NAME, {
+            title: 'Find HubSpot Projects',
+            description: 'Use this tool to locate HubSpot projects. Traverses child directories of the given directory to find hsproject.json files, returning the paths of all discovered HubSpot projects.',
+            inputSchema,
+            annotations: {
+                readOnlyHint: true,
+                openWorldHint: false,
+                idempotentHint: true,
+            },
+        }, input => this.wrappedHandler(input));
+    }
+}

package/mcp-server/tools/project/GetBuildLogsTool.js

@@ -114,7 +114,7 @@ export class GetBuildLogsTool extends Tool {
     register() {
         return this.mcpServer.registerTool(TOOL_NAME, {
             title: 'Get HubSpot Project Build Logs',
-            description: 'Retrieves build logs for a specific HubSpot project build. Use this to debug build failures by viewing the full build pipeline output. This tool is for more comprehensive troubleshootings or addressing build WARNINGs, build errors should be troubleshooted with get-build-status tool first. Logs can be filtered by level (ERROR, WARN, INFO, or ALL). Use `hs project list-builds`  first to identify the build ID and error messages.',
+            description: 'Retrieves build logs for a specific HubSpot project build. Use this to debug build failures by viewing the full build pipeline output. This tool is for more comprehensive troubleshootings or addressing build WARNINGs, build errors should be troubleshooted with get-build-status tool first. Logs can be filtered by level (ERROR, WARN, INFO, or ALL). Use `hs project list-builds`  first to identify the build ID and error messages. If you do not know the project path, use the find-projects tool first to locate HubSpot projects in the workspace.',
             inputSchema,
             annotations: {
                 readOnlyHint: true,

package/mcp-server/tools/project/GetBuildStatusTool.js

@@ -155,7 +155,7 @@ export class GetBuildStatusTool extends Tool {
     register() {
         return this.mcpServer.registerTool(TOOL_NAME, {
             title: 'Get HubSpot Projects Build Status and Errors',
-            description: 'Retrieves build status and error messages for HubSpot projects. When buildId is omitted, shows recent builds with their status(default 3) - use this to find the latest builds when troubleshooting. When buildId is provided, shows detailed error information for that specific build. Displays buildErrorMessage and subbuild failures to help diagnose build issues.',
+            description: 'Retrieves build status and error messages for HubSpot projects. When buildId is omitted, shows recent builds with their status(default 3) - use this to find the latest builds when troubleshooting. When buildId is provided, shows detailed error information for that specific build. Displays buildErrorMessage and subbuild failures to help diagnose build issues. If you do not know the project path, use the find-projects tool first to locate HubSpot projects in the workspace.',
             inputSchema,
             annotations: {
                 readOnlyHint: true,

package/mcp-server/tools/project/UploadProjectTools.js

@@ -72,7 +72,7 @@ export class UploadProjectTools extends Tool {
     register() {
         return this.mcpServer.registerTool(toolName, {
             title: 'Upload HubSpot Project',
-            description: 'DO NOT run this tool unless the user specifies they would like to upload the project, it is potentially destructive. Uploads the HubSpot project in current working directory.  If the project does not exist, it will be created. MUST be ran from within the project directory. IMPORTANT: Uploading a project does NOT automatically make cards live or visible to users. Cards must be manually added to a view in HubSpot after upload to become visible.',
+            description: 'DO NOT run this tool unless the user specifies they would like to upload the project, it is potentially destructive. Uploads the HubSpot project in current working directory.  If the project does not exist, it will be created. MUST be ran from within the project directory. IMPORTANT: Uploading a project does NOT automatically make cards live or visible to users. Cards must be manually added to a view in HubSpot after upload to become visible. If you do not know the project path, use the find-projects tool first to locate HubSpot projects in the workspace.',
             inputSchema,
             annotations: {
                 readOnlyHint: false,

package/mcp-server/tools/project/ValidateProjectTool.js

@@ -33,7 +33,7 @@ export class ValidateProjectTool extends Tool {
     register() {
         return this.mcpServer.registerTool(toolName, {
             title: 'Validate HubSpot Project',
-            description: 'Validates the HubSpot project and its configuration files.  This tool does not need to be ran before uploading the project',
+            description: 'Validates the HubSpot project and its configuration files.  This tool does not need to be ran before uploading the project. If you do not know the project path, use the find-projects tool first to locate HubSpot projects in the workspace.',
             inputSchema,
             annotations: {
                 readOnlyHint: true,

package/package.json

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

package/types/Link.d.ts

@@ -9,14 +9,19 @@ export type LinkContext = {
     accountOverrideId: number | null;
     preselectedAccountId?: number;
 };
+export declare const ACTION_RESULT_STATUS: {
+    readonly SUCCESS: "success";
+    readonly ERROR: "error";
+    readonly NOOP: "noop";
+};
 export type ActionResult = {
-    status: 'success';
+    status: typeof ACTION_RESULT_STATUS.SUCCESS;
     settings: HsSettingsFile;
 } | {
-    status: 'error';
+    status: typeof ACTION_RESULT_STATUS.ERROR;
     reason: string;
 } | {
-    status: 'noop';
+    status: typeof ACTION_RESULT_STATUS.NOOP;
 };
 export type ActionHandlerParams = {
     state: HsSettingsFile;

package/types/Link.js

@@ -1 +1,5 @@
-export {};
+export const ACTION_RESULT_STATUS = {
+    SUCCESS: 'success',
+    ERROR: 'error',
+    NOOP: 'noop',
+};

package/types/PackageJson.d.ts

@@ -5,6 +5,7 @@ export interface PackageJson {
     name: string;
     version?: string;
     workspaces?: string[];
+    scripts?: Record<string, string>;
     dependencies?: Record<string, string>;
     devDependencies?: Record<string, string>;
 }

package/types/Yargs.d.ts

@@ -46,6 +46,7 @@ export type ProjectDevArgs = CommonArgs & ConfigArgs & EnvironmentArgs & {
     profile?: string;
     testingAccount?: string | number;
     projectAccount?: string | number;
+    port?: number;
 };
 export type TestingArgs = {
     qa?: boolean;