@hubspot/cli 8.0.3-experimental.1 → 8.0.4-experimental.0

package/commands/project/migrate.js

@@ -13,7 +13,7 @@ import { getHasMigratableThemes, migrateThemes2025_2, } from '../../lib/theme/mi
 import { hasFeature } from '../../lib/hasFeature.js';
 import { FEATURES } from '../../lib/constants.js';
 import { trackCommandMetadataUsage, trackCommandUsage, } from '../../lib/usageTracking.js';
-const { v2025_2 } = PLATFORM_VERSIONS;
+const { v2025_2, v2026_3 } = PLATFORM_VERSIONS;
 const command = 'migrate';
 const describe = commands.project.migrate.describe;
 async function handler(args) {
@@ -67,7 +67,7 @@ function projectMigrateBuilder(yargs) {
     yargs
         .option('platform-version', {
         type: 'string',
-        choices: [v2025_2],
+        choices: [v2025_2, v2026_3],
         default: v2025_2,
     })
         .option('unstable', {

package/lang/en.d.ts

@@ -43,6 +43,11 @@ export declare const commands: {
             checkOutConfig: (configPath: string) => string;
             pressEnterToInstall: (accountName: string) => string;
             pressKeyToExit: string;
+            installingApp: (appName: string, accountName: string) => string;
+            installInstructions: string;
+            browserFailedToOpen: (url: string) => string;
+            pollingTimeout: (minutes: number) => string;
+            pressEnterToContinueSetup: string;
             prompts: {
                 selectOptionV2: string;
                 options: {
@@ -3179,14 +3184,6 @@ export declare const lib: {
             fileFiltered: (filename: string) => string;
             legacyFileDetected: (filename: string, platformVersion: string) => string;
             projectDoesNotExist: (accountId: number) => string;
-            workspaceIncluded: (workspaceDir: string, archivePath: string) => string;
-            fileDependencyIncluded: (packageName: string, localPath: string, archivePath: string) => string;
-            malformedPackageJson: (packageJsonPath: string, error: string) => string;
-            workspaceCollision: (archivePath: string, workspaceDir: string, existingWorkspace: string) => string;
-            fileDependencyAlreadyIncluded: (packageName: string, archivePath: string) => string;
-            updatingPackageJsonWorkspaces: (packageJsonPath: string) => string;
-            updatedWorkspaces: (workspaces: string) => string;
-            updatedFileDependency: (packageName: string, relativePath: string) => string;
         };
     };
     importData: {

package/lang/en.js

@@ -51,6 +51,11 @@ export const commands = {
             checkOutConfig: (configPath) => `Check out ${chalk.cyan(configPath)} for the full configuration.`,
             pressEnterToInstall: (accountName) => `? Press ${chalk.bold('<enter>')} to continue installing and previewing this app in ${chalk.bold(accountName)}`,
             pressKeyToExit: `Press any key to exit...`,
+            installingApp: (appName, accountName) => `Installing ${chalk.bold(appName)} in ${chalk.bold(accountName)}...`,
+            installInstructions: `We'll take you to your HubSpot account and walk you through installing your app.`,
+            browserFailedToOpen: (url) => `⚠️  Failed to open browser automatically. Please open this URL manually:\n${chalk.cyan(url)}`,
+            pollingTimeout: (minutes) => `⚠️  Installation polling timed out after ${minutes} minutes. The app may still be installing in the background.`,
+            pressEnterToContinueSetup: `Press ${chalk.bold('<enter>')} to continue with card setup...`,
             prompts: {
                 selectOptionV2: 'Choose a component type to get started',
                 options: {
@@ -3076,7 +3081,7 @@ export const lib = {
             updateSucceeded: (latestVersion) => `Successfully updated HubSpot CLI to version ${chalk.bold(latestVersion)}`,
             notInstalledGlobally: 'Cannot auto-update the HubSpot CLI because NPM is not installed globally',
             updateFailed: (latestVersion) => `Failed to update HubSpot CLI to version ${chalk.bold(latestVersion)}`,
-            enableAutoUpdatesMessage: `The HubSpot CLI can automatically keep itself up to date.\n\nThis helps ensure compatibility with the HubSpot platform. You can change this later at any time.\n\nRun${uiCommandReference('hs config set --allow-auto-updates=true')}`,
+            enableAutoUpdatesMessage: `The HubSpot CLI can automatically keep itself up to date.\n\nThis helps ensure compatibility with the HubSpot platform. You can change this later at any time.\n\nRun ${uiCommandReference('hs config set --allow-auto-updates=true')}`,
         },
     },
     projectProfiles: {
@@ -3202,14 +3207,6 @@ export const lib = {
             fileFiltered: (filename) => `Ignore rule triggered for "${filename}"`,
             legacyFileDetected: (filename, platformVersion) => `The ${chalk.bold(filename)} file is not supported on platform version ${chalk.bold(platformVersion)} and will be ignored.`,
             projectDoesNotExist: (accountId) => `Upload cancelled. Run ${uiCommandReference('hs project upload')} again to create the project in ${uiAccountDescription(accountId)}.`,
-            workspaceIncluded: (workspaceDir, archivePath) => `Including workspace: ${workspaceDir} → ${archivePath}`,
-            fileDependencyIncluded: (packageName, localPath, archivePath) => `Including file: dependency ${packageName}: ${localPath} → ${archivePath}`,
-            malformedPackageJson: (packageJsonPath, error) => `Skipping malformed package.json at ${packageJsonPath}: ${error}`,
-            workspaceCollision: (archivePath, workspaceDir, existingWorkspace) => `Workspace collision: ${archivePath} from ${workspaceDir} and ${existingWorkspace}`,
-            fileDependencyAlreadyIncluded: (packageName, archivePath) => `file: dependency ${packageName} already included as workspace: ${archivePath}`,
-            updatingPackageJsonWorkspaces: (packageJsonPath) => `Updating package.json workspaces in archive: ${packageJsonPath}`,
-            updatedWorkspaces: (workspaces) => `  Updated workspaces: ${workspaces}`,
-            updatedFileDependency: (packageName, relativePath) => `  Updated dependencies.${packageName}: file:${relativePath}`,
         },
     },
     importData: {

package/lib/getStartedV2Actions.d.ts

@@ -35,3 +35,16 @@ export declare function uploadAndDeployAction({ accountId, projectDest, }: {
     projectDest: string;
 }): Promise<UploadAndDeployResult>;
 export declare function trackGetStartedUsage(params: Record<string, unknown>, accountId: number): Promise<void>;
+export type PollAppInstallationOptions = {
+    accountId: number;
+    projectId: number;
+    appUid: string;
+    requiredScopes?: string[];
+    optionalScopes?: string[];
+    timeoutMs?: number;
+    intervalMs?: number;
+    onTimeout?: () => void;
+};
+export declare function pollAppInstallation({ accountId, projectId, appUid, requiredScopes, optionalScopes, timeoutMs, // 2 minutes
+intervalMs, // 2 seconds
+onTimeout, }: PollAppInstallationOptions): Promise<void>;

package/lib/getStartedV2Actions.js

@@ -1,6 +1,7 @@
 import fs from 'fs-extra';
 import path from 'path';
 import { fetchPublicAppsForPortal } from '@hubspot/local-dev-lib/api/appsDev';
+import { fetchAppInstallationData } from '@hubspot/local-dev-lib/api/localDevAuth';
 import { fetchProject } from '@hubspot/local-dev-lib/api/projects';
 import { getConfigAccountEnvironment } from '@hubspot/local-dev-lib/config';
 import { cloneGithubRepo } from '@hubspot/local-dev-lib/github';
@@ -144,3 +145,55 @@ export async function uploadAndDeployAction({ accountId, projectDest, }) {
 export function trackGetStartedUsage(params, accountId) {
     return trackCommandMetadataUsage('get-started', params, accountId);
 }
+export async function pollAppInstallation({ accountId, projectId, appUid, requiredScopes = [], optionalScopes = [], timeoutMs = 2 * 60 * 1000, // 2 minutes
+intervalMs = 2000, // 2 seconds
+onTimeout, }) {
+    return new Promise((resolve, reject) => {
+        let consecutiveErrors = 0;
+        const MAX_CONSECUTIVE_ERRORS = 5;
+        let pollInterval = null;
+        let pollTimeout = null;
+        const cleanup = () => {
+            if (pollInterval) {
+                clearTimeout(pollInterval);
+                pollInterval = null;
+            }
+            if (pollTimeout) {
+                clearTimeout(pollTimeout);
+                pollTimeout = null;
+            }
+        };
+        pollTimeout = setTimeout(() => {
+            cleanup();
+            if (onTimeout) {
+                onTimeout();
+            }
+            resolve(); // Resolve instead of reject to allow continuing with timeout state
+        }, timeoutMs);
+        const poll = async () => {
+            try {
+                const { data } = await fetchAppInstallationData(accountId, projectId, appUid, requiredScopes, optionalScopes);
+                // Reset error counter on successful fetch
+                consecutiveErrors = 0;
+                if (data.isInstalledWithScopeGroups) {
+                    cleanup();
+                    resolve();
+                }
+                else if (pollInterval) {
+                    pollInterval = setTimeout(poll, intervalMs);
+                }
+            }
+            catch (error) {
+                consecutiveErrors++;
+                if (consecutiveErrors >= MAX_CONSECUTIVE_ERRORS) {
+                    cleanup();
+                    reject(new Error(`Failed to check app installation status after ${MAX_CONSECUTIVE_ERRORS} consecutive errors`, { cause: error }));
+                }
+                else if (pollInterval !== null) {
+                    pollInterval = setTimeout(poll, intervalMs);
+                }
+            }
+        };
+        pollInterval = setTimeout(poll, 0);
+    });
+}

package/lib/projects/__tests__/upload.test.js

@@ -13,7 +13,6 @@ import { walk } from '@hubspot/local-dev-lib/fs';
 import { uploadProject } from '@hubspot/local-dev-lib/api/projects';
 import { ensureProjectExists } from '../ensureProjectExists.js';
 import { projectContainsHsMetaFiles } from '@hubspot/project-parsing-lib/projects';
-import { findAndParsePackageJsonFiles, collectWorkspaceDirectories, collectFileDependencies, } from '@hubspot/project-parsing-lib/workspaces';
 import { shouldIgnoreFile } from '@hubspot/local-dev-lib/ignoreRules';
 import { getConfigAccountIfExists } from '@hubspot/local-dev-lib/config';
 // Mock dependencies
@@ -23,11 +22,6 @@ vi.mock('@hubspot/local-dev-lib/fs');
 vi.mock('@hubspot/local-dev-lib/api/projects');
 vi.mock('../ensureProjectExists.js');
 vi.mock('@hubspot/project-parsing-lib/projects');
-vi.mock('@hubspot/project-parsing-lib/workspaces', () => ({
-    findAndParsePackageJsonFiles: vi.fn(),
-    collectWorkspaceDirectories: vi.fn(),
-    collectFileDependencies: vi.fn(),
-}));
 vi.mock('@hubspot/local-dev-lib/ignoreRules');
 vi.mock('@hubspot/local-dev-lib/config');
 vi.mock('archiver');
@@ -128,10 +122,6 @@ describe('lib/projects/upload', () => {
             vi.mocked(shouldIgnoreFile).mockReturnValue(false);
             vi.mocked(projectContainsHsMetaFiles).mockResolvedValue(false);
             vi.mocked(isV2Project).mockReturnValue(false);
-            // Mock workspace functions to return empty arrays
-            vi.mocked(findAndParsePackageJsonFiles).mockResolvedValue([]);
-            vi.mocked(collectWorkspaceDirectories).mockResolvedValue([]);
-            vi.mocked(collectFileDependencies).mockResolvedValue([]);
             vi.mocked(tmp.fileSync).mockReturnValue({
                 name: path.join(tempDir, 'test.zip'),
                 fd: 1,

package/lib/projects/platformVersion.d.ts

@@ -4,6 +4,6 @@
  *
  * We are unable to reliably support versions of projects that are newer than any given CLI release
  * */
-export declare const LATEST_SUPPORTED_PLATFORM_VERSION = "2026.03";
+export declare const LATEST_SUPPORTED_PLATFORM_VERSION: string;
 export declare function isV2Project(platformVersion?: string | null): boolean;
 export declare function isUnsupportedPlatformVersion(platformVersion?: string | null): boolean;

package/lib/projects/platformVersion.js

@@ -1,10 +1,11 @@
+import { PLATFORM_VERSIONS } from '@hubspot/local-dev-lib/constants/projects';
 /**
  * Used to surface warnings when users attempt to interact with new platform versions
  * that were released after this version of the CLI was released.
  *
  * We are unable to reliably support versions of projects that are newer than any given CLI release
  * */
-export const LATEST_SUPPORTED_PLATFORM_VERSION = '2026.03';
+export const LATEST_SUPPORTED_PLATFORM_VERSION = PLATFORM_VERSIONS.v2026_3;
 function parsePlatformVersion(platformVersion) {
     const [year, minor] = platformVersion.split(/[.-]/);
     return {

package/lib/projects/upload.js

@@ -6,7 +6,6 @@ import { uploadProject } from '@hubspot/local-dev-lib/api/projects';
 import { shouldIgnoreFile } from '@hubspot/local-dev-lib/ignoreRules';
 import { isTranslationError, translate, } from '@hubspot/project-parsing-lib/translate';
 import { projectContainsHsMetaFiles } from '@hubspot/project-parsing-lib/projects';
-import { findAndParsePackageJsonFiles, collectWorkspaceDirectories, collectFileDependencies, } from '@hubspot/project-parsing-lib/workspaces';
 import SpinniesManager from '../ui/SpinniesManager.js';
 import { uiAccountDescription } from '../ui/index.js';
 import { logError } from '../errorHandlers/index.js';
@@ -19,7 +18,6 @@ import { EXIT_CODES } from '../enums/exitCodes.js';
 import ProjectValidationError from '../errors/ProjectValidationError.js';
 import { walk } from '@hubspot/local-dev-lib/fs';
 import { LEGACY_CONFIG_FILES } from '../constants.js';
-import { archiveWorkspacesAndDependencies } from './workspaces.js';
 async function uploadProjectFiles(accountId, projectName, filePath, uploadMessage, platformVersion, intermediateRepresentation) {
     const accountIdentifier = uiAccountDescription(accountId) || `${accountId}`;
     SpinniesManager.add('upload', {
@@ -64,11 +62,6 @@ export async function handleProjectUpload({ accountId, projectConfig, projectDir
     }
     const tempFile = tmp.fileSync({ postfix: '.zip' });
     uiLogger.debug(lib.projectUpload.handleProjectUpload.compressing(tempFile.name));
-    // Find and parse all package.json files once (avoids duplicate filesystem walks)
-    const parsedPackageJsons = await findAndParsePackageJsonFiles(srcDir);
-    // Collect workspace directories and file: dependencies from parsed data
-    const workspaceMappings = await collectWorkspaceDirectories(parsedPackageJsons);
-    const fileDependencyMappings = await collectFileDependencies(parsedPackageJsons);
     const output = fs.createWriteStream(tempFile.name);
     const archive = archiver('zip');
     const result = new Promise(resolve => output.on('close', async function () {
@@ -121,8 +114,6 @@ export async function handleProjectUpload({ accountId, projectConfig, projectDir
         }
         return ignored ? false : file;
     });
-    // Archive workspaces and file: dependencies
-    await archiveWorkspacesAndDependencies(archive, srcDir, projectDir, workspaceMappings, fileDependencyMappings);
     archive.finalize();
     return result;
 }

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

@@ -5,9 +5,26 @@ declare const inputSchemaZodObject: z.ZodObject<{
     absoluteProjectPath: z.ZodString;
     absoluteCurrentWorkingDirectory: z.ZodString;
     addApp: z.ZodBoolean;
-    distribution: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"marketplace">, z.ZodLiteral<"private">]>>;
-    auth: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"static">, z.ZodLiteral<"oauth">]>>;
-    features: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"card">, z.ZodLiteral<"settings">, z.ZodLiteral<"app-function">, z.ZodLiteral<"webhooks">, z.ZodLiteral<"workflow-action">, z.ZodLiteral<"workflow-action-tool">, z.ZodLiteral<"app-object">, z.ZodLiteral<"app-event">, z.ZodLiteral<"scim">, z.ZodLiteral<"page">]>>>;
+    distribution: z.ZodOptional<z.ZodEnum<{
+        marketplace: "marketplace";
+        private: "private";
+    }>>;
+    auth: z.ZodOptional<z.ZodEnum<{
+        oauth: "oauth";
+        static: "static";
+    }>>;
+    features: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        card: "card";
+        settings: "settings";
+        "app-event": "app-event";
+        page: "page";
+        "workflow-action-tool": "workflow-action-tool";
+        webhooks: "webhooks";
+        "workflow-action": "workflow-action";
+        "app-function": "app-function";
+        "app-object": "app-object";
+        scim: "scim";
+    }>>>;
 }, z.core.$strip>;
 export type AddFeatureInputSchema = z.infer<typeof inputSchemaZodObject>;
 export declare class AddFeatureToProjectTool extends Tool<AddFeatureInputSchema> {

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

@@ -15,17 +15,13 @@ const inputSchema = {
         .boolean()
         .describe('Should an app be added?  If there is no app in the project, an app must be added to add a feature'),
     distribution: z
-        .optional(z.union([
-        z.literal(APP_DISTRIBUTION_TYPES.MARKETPLACE),
-        z.literal(APP_DISTRIBUTION_TYPES.PRIVATE),
-    ]))
-        .describe('If not specified by the user, DO NOT choose for them.  This cannot be changed after a project is uploaded. Private is used if you do not wish to distribute your app on the HubSpot marketplace. '),
+        .enum([APP_DISTRIBUTION_TYPES.MARKETPLACE, APP_DISTRIBUTION_TYPES.PRIVATE])
+        .describe('If not specified by the user, DO NOT choose for them.  This cannot be changed after a project is uploaded. Private is used if you do not wish to distribute your app on the HubSpot marketplace. ')
+        .optional(),
     auth: z
-        .optional(z.union([
-        z.literal(APP_AUTH_TYPES.STATIC),
-        z.literal(APP_AUTH_TYPES.OAUTH),
-    ]))
-        .describe('If not specified by the user, DO NOT choose for them.  This cannot be changed after a project is uploaded. Static uses a static non changing authentication token, and is only available for private distribution. '),
+        .enum([APP_AUTH_TYPES.STATIC, APP_AUTH_TYPES.OAUTH])
+        .describe('If not specified by the user, DO NOT choose for them.  This cannot be changed after a project is uploaded. Static uses a static non changing authentication token, and is only available for private distribution. ')
+        .optional(),
     features,
 };
 // eslint-disable-next-line @typescript-eslint/no-unused-vars

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

@@ -5,10 +5,30 @@ declare const inputSchemaZodObject: z.ZodObject<{
     absoluteCurrentWorkingDirectory: z.ZodString;
     name: z.ZodOptional<z.ZodString>;
     destination: z.ZodString;
-    projectBase: z.ZodUnion<readonly [z.ZodLiteral<"empty">, z.ZodLiteral<"app">]>;
-    distribution: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"marketplace">, z.ZodLiteral<"private">]>>;
-    auth: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"static">, z.ZodLiteral<"oauth">]>>>;
-    features: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"card">, z.ZodLiteral<"settings">, z.ZodLiteral<"app-function">, z.ZodLiteral<"webhooks">, z.ZodLiteral<"workflow-action">, z.ZodLiteral<"workflow-action-tool">, z.ZodLiteral<"app-object">, z.ZodLiteral<"app-event">, z.ZodLiteral<"scim">, z.ZodLiteral<"page">]>>>;
+    projectBase: z.ZodEnum<{
+        app: "app";
+        empty: "empty";
+    }>;
+    distribution: z.ZodOptional<z.ZodEnum<{
+        marketplace: "marketplace";
+        private: "private";
+    }>>;
+    auth: z.ZodOptional<z.ZodEnum<{
+        oauth: "oauth";
+        static: "static";
+    }>>;
+    features: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        card: "card";
+        settings: "settings";
+        "app-event": "app-event";
+        page: "page";
+        "workflow-action-tool": "workflow-action-tool";
+        webhooks: "webhooks";
+        "workflow-action": "workflow-action";
+        "app-function": "app-function";
+        "app-object": "app-object";
+        scim: "scim";
+    }>>>;
 }, z.core.$strip>;
 export type CreateProjectInputSchema = z.infer<typeof inputSchemaZodObject>;
 export declare class CreateProjectTool extends Tool<CreateProjectInputSchema> {

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

@@ -18,19 +18,14 @@ const inputSchema = {
         .string()
         .describe('DO NOT use the current directory unless the user has explicitly stated to do so. Relative path to the directory the project will be created in.'),
     projectBase: z
-        .union([z.literal(EMPTY_PROJECT), z.literal(PROJECT_WITH_APP)])
+        .enum([EMPTY_PROJECT, PROJECT_WITH_APP])
         .describe('Empty will create an empty project, and app will create a project with an app inside of it.'),
     distribution: z
-        .optional(z.union([
-        z.literal(APP_DISTRIBUTION_TYPES.MARKETPLACE),
-        z.literal(APP_DISTRIBUTION_TYPES.PRIVATE),
-    ]))
-        .describe('If not specified by the user, DO NOT choose for them.  This cannot be changed after a project is uploaded. Private is used if you do not wish to distribute your app on the HubSpot marketplace. '),
+        .enum([APP_DISTRIBUTION_TYPES.MARKETPLACE, APP_DISTRIBUTION_TYPES.PRIVATE])
+        .describe('If not specified by the user, DO NOT choose for them.  This cannot be changed after a project is uploaded. Private is used if you do not wish to distribute your app on the HubSpot marketplace. ')
+        .optional(),
     auth: z
-        .optional(z.union([
-        z.literal(APP_AUTH_TYPES.STATIC),
-        z.literal(APP_AUTH_TYPES.OAUTH),
-    ]))
+        .enum([APP_AUTH_TYPES.STATIC, APP_AUTH_TYPES.OAUTH])
         .describe('If not specified by the user, DO NOT choose for them.  This cannot be changed after a project is uploaded. Static uses a static non changing authentication token, and is only available for private distribution. ')
         .optional(),
     features,

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

@@ -12,18 +12,15 @@ const inputSchema = {
     absoluteCurrentWorkingDirectory,
     appId: z
         .string()
-        .regex(/^\d+$/, 'App ID must be a numeric string')
-        .describe('The numeric app ID as a string (e.g., "3003909"). Use get-apps-info to find available app IDs.'),
+        .describe('The numeric app ID as a string (e.g., "3003909"). Must contain only digits. Use get-apps-info to find available app IDs.'),
     startDate: z
         .string()
-        .regex(/^\d{4}-\d{2}-\d{2}$/, 'Start date must be in YYYY-MM-DD format')
-        .optional()
-        .describe('Start date for the usage patterns query in ISO 8601 format (e.g., 2025-01-01).'),
+        .describe('Start date for the usage patterns query in YYYY-MM-DD format (e.g., 2025-01-01).')
+        .optional(),
     endDate: z
         .string()
-        .regex(/^\d{4}-\d{2}-\d{2}$/, 'End date must be in YYYY-MM-DD format')
-        .optional()
-        .describe('End date for the usage patterns query in ISO 8601 format (e.g., 2025-12-31).'),
+        .describe('End date for the usage patterns query in YYYY-MM-DD format (e.g., 2025-12-31).')
+        .optional(),
 };
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 const inputSchemaZodObject = z.object({ ...inputSchema });

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

@@ -5,12 +5,12 @@ declare const inputSchemaZodObject: z.ZodObject<{
     absoluteProjectPath: z.ZodString;
     absoluteCurrentWorkingDirectory: z.ZodString;
     buildId: z.ZodNumber;
-    logLevel: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+    logLevel: z.ZodOptional<z.ZodEnum<{
         ERROR: "ERROR";
         WARN: "WARN";
         INFO: "INFO";
         ALL: "ALL";
-    }>>>;
+    }>>;
 }, z.core.$strip>;
 export type GetBuildLogsInputSchema = z.infer<typeof inputSchemaZodObject>;
 export declare class GetBuildLogsTool extends Tool<GetBuildLogsInputSchema> {

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

@@ -18,9 +18,8 @@ const inputSchema = {
         .describe('Build ID to fetch logs for. Use get-build-status to find recent build IDs.'),
     logLevel: z
         .enum(['ERROR', 'WARN', 'INFO', 'ALL'])
-        .optional()
-        .default('ALL')
-        .describe('Filter logs by level. ERROR: Show only errors, WARN: Show only warnings, INFO: Show only info, ALL: Show all logs.'),
+        .describe('Filter logs by level. ERROR: Show only errors, WARN: Show only warnings, INFO: Show only info, ALL: Show all logs. Defaults to ALL if not specified.')
+        .optional(),
 };
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 const inputSchemaZodObject = z.object({ ...inputSchema });
@@ -85,14 +84,14 @@ export class GetBuildLogsTool extends Tool {
             if (allLogs.length === 0) {
                 return formatTextContents(absoluteCurrentWorkingDirectory, `No logs found for build #${buildId} in project '${projectName}'.`);
             }
-            const filteredLogs = filterLogsByLevel(allLogs, logLevel);
+            const resolvedLogLevel = logLevel || 'ALL';
+            const filteredLogs = filterLogsByLevel(allLogs, resolvedLogLevel);
             let output;
             if (filteredLogs.length === 0) {
-                // No logs match filter, show all logs instead
-                output = `No ${logLevel} level logs found for build #${buildId} in '${projectName}'.\nShowing all logs instead:\n\n${formatLogs(allLogs)}`;
+                output = `No ${resolvedLogLevel} level logs found for build #${buildId} in '${projectName}'.\nShowing all logs instead:\n\n${formatLogs(allLogs)}`;
             }
             else {
-                output = `Logs for build #${buildId} in '${projectName}' (${logLevel} level):\n\n${formatLogs(filteredLogs)}`;
+                output = `Logs for build #${buildId} in '${projectName}' (${resolvedLogLevel} level):\n\n${formatLogs(filteredLogs)}`;
             }
             return formatTextContents(absoluteCurrentWorkingDirectory, output);
         }

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

@@ -5,7 +5,7 @@ declare const inputSchemaZodObject: z.ZodObject<{
     absoluteProjectPath: z.ZodString;
     absoluteCurrentWorkingDirectory: z.ZodString;
     buildId: z.ZodOptional<z.ZodNumber>;
-    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    limit: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type GetBuildStatusInputSchema = z.infer<typeof inputSchemaZodObject>;
 export declare class GetBuildStatusTool extends Tool<GetBuildStatusInputSchema> {

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

@@ -19,9 +19,8 @@ const inputSchema = {
         .describe('Optional: Specific build ID to inspect. If omitted, shows recent builds to help identify the latest build.'),
     limit: z
         .number()
-        .optional()
-        .default(3)
-        .describe('Number of recent builds to fetch when buildId is not specified.'),
+        .describe('Number of recent builds to fetch when buildId is not specified. Defaults to 3 if not specified.')
+        .optional(),
 };
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 const inputSchemaZodObject = z.object({ ...inputSchema });
@@ -127,7 +126,7 @@ export class GetBuildStatusTool extends Tool {
             }
             else {
                 const response = await fetchProjectBuilds(accountId, projectName, {
-                    limit,
+                    limit: limit || 3,
                 });
                 const { results } = response.data;
                 if (!results || results.length === 0) {

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

@@ -3,7 +3,12 @@ import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.
 import { z } from 'zod';
 declare const inputSchemaZodObject: z.ZodObject<{
     absoluteCurrentWorkingDirectory: z.ZodString;
-    command: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"hs init">, z.ZodLiteral<"hs auth">, z.ZodLiteral<"hs project create">, z.ZodLiteral<"hs project upload">]>>;
+    command: z.ZodOptional<z.ZodEnum<{
+        "hs auth": "hs auth";
+        "hs project create": "hs project create";
+        "hs project upload": "hs project upload";
+        "hs init": "hs init";
+    }>>;
 }, z.core.$strip>;
 type InputSchemaType = z.infer<typeof inputSchemaZodObject>;
 export declare class GuidedWalkthroughTool extends Tool<InputSchemaType> {

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

@@ -14,12 +14,7 @@ const nextCommands = {
 const inputSchema = {
     absoluteCurrentWorkingDirectory,
     command: z
-        .union([
-        z.literal('hs init'),
-        z.literal('hs auth'),
-        z.literal('hs project create'),
-        z.literal('hs project upload'),
-    ])
+        .enum(['hs init', 'hs auth', 'hs project create', 'hs project upload'])
         .describe('The command to learn more about.  Start with `hs init`')
         .optional(),
 };

package/mcp-server/tools/project/__tests__/GetApiUsagePatternsByAppIdTool.test.js

@@ -1,5 +1,4 @@
 import { GetApiUsagePatternsByAppIdTool } from '../GetApiUsagePatternsByAppIdTool.js';
-import { z } from 'zod';
 import { getConfigDefaultAccountIfExists } from '@hubspot/local-dev-lib/config';
 import { http } from '@hubspot/local-dev-lib/http';
 import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
@@ -52,37 +51,6 @@ describe('mcp-server/tools/project/GetApiUsagePatternsByAppIdTool', () => {
             expect(result).toBe(mockRegisteredTool);
         });
     });
-    describe('input validation', () => {
-        const inputSchema = z.object({
-            appId: z
-                .string()
-                .describe('The application ID to get API usage patterns for.'),
-            startDate: z
-                .string()
-                .regex(/^\d{4}-\d{2}-\d{2}$/, 'Start date must be in YYYY-MM-DD format')
-                .optional()
-                .describe('Start date for the usage patterns query in ISO 8601 format (e.g., 2025-01-01).'),
-            endDate: z
-                .string()
-                .regex(/^\d{4}-\d{2}-\d{2}$/, 'End date must be in YYYY-MM-DD format')
-                .optional()
-                .describe('End date for the usage patterns query in ISO 8601 format (e.g., 2025-12-31).'),
-        });
-        it('should validate date format correctly', () => {
-            const validInput = {
-                appId: '12345',
-                startDate: '2025-01-01',
-                endDate: '2025-12-31',
-            };
-            const invalidInput = {
-                appId: '12345',
-                startDate: '2025-1-1',
-                endDate: '2025-12-31T00:00:00Z',
-            };
-            expect(() => inputSchema.parse(validInput)).not.toThrow();
-            expect(() => inputSchema.parse(invalidInput)).toThrow();
-        });
-    });
     describe('handler', () => {
         const input = {
             absoluteCurrentWorkingDirectory: '/test/dir',

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

@@ -1,6 +1,17 @@
 import z from 'zod';
 export declare const absoluteProjectPath: z.ZodString;
 export declare const absoluteCurrentWorkingDirectory: z.ZodString;
-export declare const features: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"card">, z.ZodLiteral<"settings">, z.ZodLiteral<"app-function">, z.ZodLiteral<"webhooks">, z.ZodLiteral<"workflow-action">, z.ZodLiteral<"workflow-action-tool">, z.ZodLiteral<"app-object">, z.ZodLiteral<"app-event">, z.ZodLiteral<"scim">, z.ZodLiteral<"page">]>>>;
+export declare const features: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+    card: "card";
+    settings: "settings";
+    "app-event": "app-event";
+    page: "page";
+    "workflow-action-tool": "workflow-action-tool";
+    webhooks: "webhooks";
+    "workflow-action": "workflow-action";
+    "app-function": "app-function";
+    "app-object": "app-object";
+    scim: "scim";
+}>>>;
 export declare const docsSearchQuery: z.ZodString;
 export declare const docUrl: z.ZodString;

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

@@ -6,23 +6,19 @@ export const absoluteCurrentWorkingDirectory = z
     .string()
     .describe('The absolute path to the current working directory.');
 export const features = z
-    .array(z.union([
-    z.literal('card'),
-    z.literal('settings'),
-    z
-        .literal('app-function')
-        .describe('Also known as a public serverless function'),
-    z.literal('webhooks'),
-    z
-        .literal('workflow-action')
-        .describe('Also known as a custom workflow action.'),
-    z.literal('workflow-action-tool').describe('Also known as agent tools.'),
-    z.literal('app-object'),
-    z.literal('app-event'),
-    z.literal('scim'),
-    z.literal('page'),
+    .array(z.enum([
+    'card',
+    'settings',
+    'app-function',
+    'webhooks',
+    'workflow-action',
+    'workflow-action-tool',
+    'app-object',
+    'app-event',
+    'scim',
+    'page',
 ]))
-    .describe('The features to include in the project, multiple options can be selected')
+    .describe('The features to include in the project, multiple options can be selected. "app-function" is also known as a public serverless function. "workflow-action" is also known as a custom workflow action. "workflow-action-tool" is also known as agent tools.')
     .optional();
 export const docsSearchQuery = z
     .string()

package/package.json

@@ -1,14 +1,14 @@
 {
     "name": "@hubspot/cli",
-    "version": "8.0.3-experimental.1",
+    "version": "8.0.4-experimental.0",
     "description": "The official CLI for developing on HubSpot",
     "license": "Apache-2.0",
     "repository": "https://github.com/HubSpot/hubspot-cli",
     "type": "module",
     "dependencies": {
         "@hubspot/cms-dev-server": "1.2.16",
-        "@hubspot/local-dev-lib": "5.1.1",
-        "@hubspot/project-parsing-lib": "0.2.0-experimental.0",
+        "@hubspot/local-dev-lib": "0.7.1-experimental.0",
+        "@hubspot/project-parsing-lib": "0.12.0",
         "@hubspot/serverless-dev-runtime": "7.0.7",
         "@hubspot/ui-extensions-dev-server": "1.1.8",
         "@inquirer/prompts": "7.1.0",