@hubspot/cli 8.15.0-beta.0 → 8.15.0-beta.1

package/commands/getStarted.js

@@ -117,7 +117,7 @@ async function handler(args) {
         // 4. Clone the project template from GitHub
         try {
             await cloneGithubRepo(HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, projectDest, {
-                sourceDir: '2026.03/private-app-get-started-template',
+                sourceDir: '2026.09/private-app-get-started-template',
                 hideLogs: true,
             });
             await trackCommandMetadataUsage('get-started', {

package/commands/project/create.js

@@ -22,6 +22,7 @@ import { showMcpPromotionNudge } from '../../lib/mcp/promotion.js';
 const command = ['create', 'init'];
 const describe = commands.project.create.describe;
 const BETA_VERSIONS = [
+    PLATFORM_VERSIONS.v2027_03_BETA,
     PLATFORM_VERSIONS.v2026_09_BETA,
     PLATFORM_VERSIONS.v2026_03_BETA,
 ];
@@ -151,8 +152,10 @@ function projectCreateBuilder(yargs) {
                 PLATFORM_VERSIONS.v2026_03_BETA,
                 PLATFORM_VERSIONS.v2026_03,
                 PLATFORM_VERSIONS.v2026_09_BETA,
+                PLATFORM_VERSIONS.v2026_09,
+                PLATFORM_VERSIONS.v2027_03_BETA,
             ],
-            default: PLATFORM_VERSIONS.v2026_03,
+            default: PLATFORM_VERSIONS.v2026_09,
         },
         'project-base': {
             describe: commands.project.create.options.projectBase.describe,

package/commands/project/download.d.ts

@@ -1,5 +1,6 @@
-import { CommonArgs, ConfigArgs, AccountArgs, EnvironmentArgs, YargsCommandModule } from '../../types/Yargs.js';
-type ProjectDownloadArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & {
+import { CommonArgs, ConfigArgs, AccountArgs, EnvironmentArgs, JSONOutputArgs, YargsCommandModule } from '../../types/Yargs.js';
+import { DownloadJsonOutput } from '../../lib/jsonOutput/download.js';
+export type ProjectDownloadArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & JSONOutputArgs<DownloadJsonOutput> & {
     project?: string;
     dest?: string;
     build?: number;

package/commands/project/download.js

@@ -11,10 +11,11 @@ import { uiLogger } from '../../lib/ui/logger.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
+import { DownloadSchema, } from '../../lib/jsonOutput/download.js';
 const command = 'download';
 const describe = commands.project.download.describe;
 async function handler(args) {
-    const { dest, build, derivedAccountId, exit } = args;
+    const { dest, build, derivedAccountId, exit, addJsonOutput } = args;
     const isInProjectDir = getIsInProject();
     if (isInProjectDir) {
         uiLogger.error(commands.project.download.warnings.cannotDownloadWithinProject);
@@ -41,6 +42,11 @@ async function handler(args) {
             : path.resolve(getCwd(), sanitizedProjectName);
         const { data: zippedProject } = await downloadProject(derivedAccountId, projectName, buildNumberToDownload);
         await extractZipArchive(zippedProject, sanitizeFileName(projectName), path.resolve(absoluteDestPath));
+        addJsonOutput({
+            projectName,
+            buildId: buildNumberToDownload,
+            dest: absoluteDestPath,
+        });
         uiLogger.log(commands.project.download.logs.downloadSucceeded(buildNumberToDownload, projectName));
         return exit(EXIT_CODES.SUCCESS);
     }
@@ -76,6 +82,10 @@ function projectDownloadBuilder(yargs) {
             '$0 project download --project=myProject --dest=myProjectFolder',
             commands.project.download.examples.default,
         ],
+        [
+            '$0 project download --project=myProject --json',
+            commands.project.download.examples.json,
+        ],
     ]);
     return yargs;
 }
@@ -84,11 +94,14 @@ const builder = makeYargsBuilder(projectDownloadBuilder, command, describe, {
     useConfigOptions: true,
     useAccountOptions: true,
     useEnvironmentOptions: true,
+    useJSONOutputOptions: true,
 });
 const projectDownloadCommand = {
     command,
     describe,
-    handler: makeWrappedYargsHandler('project-download', handler),
+    handler: makeWrappedYargsHandler('project-download', handler, {
+        jsonOutputSchema: DownloadSchema,
+    }),
     builder,
 };
 export default projectDownloadCommand;

package/commands/project/migrate.js

@@ -11,8 +11,6 @@ import { uiLogger } from '../../lib/ui/logger.js';
 import { renderInline } from '../../ui/render.js';
 import { getWarningBox } from '../../ui/components/StatusMessageBoxes.js';
 import { getHasMigratableThemes, migrateThemesV2, } from '../../lib/theme/migrate.js';
-import { hasFeature } from '../../lib/hasFeature.js';
-import { FEATURES } from '../../lib/constants.js';
 import { trackCommandMetadataUsage } from '../../lib/usageTracking.js';
 const { v2025_2, v2026_03_BETA, v2026_03 } = PLATFORM_VERSIONS;
 const command = 'migrate';
@@ -35,11 +33,6 @@ async function handler(args) {
     try {
         const { hasMigratableThemes, migratableThemesCount } = await getHasMigratableThemes({ projectConfig, projectDir });
         if (hasMigratableThemes) {
-            const hasThemeMigrationAccess = await hasFeature(derivedAccountId, FEATURES.THEME_MIGRATION_2025_2);
-            if (!hasThemeMigrationAccess) {
-                uiLogger.error(commands.project.migrate.errors.noThemeMigrationAccess(derivedAccountId));
-                return exit(EXIT_CODES.ERROR);
-            }
             await migrateThemesV2(derivedAccountId, {
                 ...args,
                 platformVersion: unstable

package/commands/project/validate.d.ts

@@ -1,5 +1,6 @@
-import { CommonArgs, YargsCommandModule } from '../../types/Yargs.js';
-export type ProjectValidateArgs = CommonArgs & {
+import { CommonArgs, JSONOutputArgs, YargsCommandModule } from '../../types/Yargs.js';
+import { ValidateJsonOutput } from '../../lib/jsonOutput/validate.js';
+export type ProjectValidateArgs = CommonArgs & JSONOutputArgs<ValidateJsonOutput> & {
     profile?: string;
 };
 declare const projectValidateCommand: YargsCommandModule<unknown, ProjectValidateArgs>;

package/commands/project/validate.js

@@ -7,34 +7,83 @@ import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { commands } from '../../lang/en.js';
 import { logError } from '../../lib/errorHandlers/index.js';
-import { validateProject } from '../../lib/projects/validate.js';
+import { validateProject, toIssue, } from '../../lib/projects/validate.js';
+import { ValidateSchema, } from '../../lib/jsonOutput/validate.js';
 const command = 'validate';
 const describe = commands.project.validate.describe;
+function generateJson({ result, projectConfig, profile, }) {
+    const { valid, errors, warnings, profiles } = result;
+    const output = { valid, errors, warnings };
+    if (projectConfig) {
+        output.projectName = projectConfig.name;
+        output.platformVersion = projectConfig.platformVersion;
+    }
+    if (profile) {
+        output.profile = profile;
+    }
+    if (profiles.length > 0) {
+        output.profiles = profiles;
+    }
+    return output;
+}
 async function handler(args) {
-    const { derivedAccountId, profile, exit, addUsageMetadata } = args;
-    const accountConfig = getConfigAccountById(derivedAccountId);
-    const accountType = accountConfig && accountConfig.accountType;
-    addUsageMetadata({ type: accountType });
+    const { derivedAccountId, profile, exit, addUsageMetadata, formatOutputAsJson, addJsonOutput, } = args;
     let projectConfig;
     let projectDir;
+    function outputError(error) {
+        logError(error);
+        addJsonOutput(generateJson({
+            result: {
+                valid: false,
+                errors: [toIssue(error)],
+                warnings: [],
+                profiles: [],
+            },
+            projectConfig,
+            profile,
+        }));
+    }
     try {
+        const accountConfig = getConfigAccountById(derivedAccountId);
+        const accountType = accountConfig && accountConfig.accountType;
+        addUsageMetadata({ type: accountType });
         ({ projectConfig, projectDir } = getProjectConfig());
     }
     catch (error) {
-        logError(error);
+        outputError(error);
         return exit(EXIT_CODES.ERROR);
     }
     if (isLegacyProject(projectConfig.platformVersion)) {
-        uiLogger.error(commands.project.validate.badVersion);
+        const message = commands.project.validate.badVersion;
+        uiLogger.error(message);
+        addJsonOutput(generateJson({
+            result: {
+                valid: false,
+                errors: [{ message }],
+                warnings: [],
+                profiles: [],
+            },
+            projectConfig,
+            profile,
+        }));
         return exit(EXIT_CODES.ERROR);
     }
-    const valid = await validateProject({
-        projectConfig,
-        projectDir,
-        derivedAccountId,
-        profile,
-    });
-    if (!valid) {
+    let result;
+    try {
+        result = await validateProject({
+            projectConfig,
+            projectDir,
+            derivedAccountId,
+            profile,
+            formatOutputAsJson,
+        });
+    }
+    catch (error) {
+        outputError(error);
+        return exit(EXIT_CODES.ERROR);
+    }
+    addJsonOutput(generateJson({ result, projectConfig, profile }));
+    if (!result.valid) {
         return exit(EXIT_CODES.ERROR);
     }
     uiLogger.success(commands.project.validate.success(projectConfig.name));
@@ -55,6 +104,7 @@ function projectValidateBuilder(yargs) {
             '$0 project validate --profile=profileName',
             commands.project.validate.examples.withProfile,
         ],
+        ['$0 project validate --json', commands.project.validate.examples.json],
     ]);
     return yargs;
 }
@@ -63,11 +113,14 @@ const builder = makeYargsBuilder(projectValidateBuilder, command, describe, {
     useConfigOptions: true,
     useAccountOptions: true,
     useEnvironmentOptions: true,
+    useJSONOutputOptions: true,
 });
 const projectValidateCommand = {
     command,
     describe,
-    handler: makeWrappedYargsHandler('project-validate', handler),
+    handler: makeWrappedYargsHandler('project-validate', handler, {
+        jsonOutputSchema: ValidateSchema,
+    }),
     builder,
 };
 export default projectValidateCommand;

package/lang/en.d.ts

@@ -1646,7 +1646,6 @@ export declare const commands: {
             describe: string;
             errors: {
                 noProjectConfig: (command: string) => string;
-                noThemeMigrationAccess: (accountId?: number) => string;
             };
             examples: {
                 default: string;
@@ -1986,6 +1985,7 @@ export declare const commands: {
             describe: string;
             examples: {
                 default: string;
+                json: string;
             };
             logs: {
                 downloadCancelled: string;
@@ -2097,6 +2097,7 @@ export declare const commands: {
             examples: {
                 default: string;
                 withProfile: string;
+                json: string;
             };
             success: (projectName: string) => string;
             failure: (projectName: string, profileName?: string) => string;

package/lang/en.js

@@ -1662,7 +1662,6 @@ export const commands = {
             describe: 'Migrate an existing project to the new version of the projects framework.',
             errors: {
                 noProjectConfig: (command) => `No project detected. Please run this command again from a project directory.  If you are trying to migrate an app, run ${command}`,
-                noThemeMigrationAccess: (accountId) => `This project contains a CMS theme. You must opt in to theme migration beta to continue updating it on ${uiAccountDescription(accountId)}. Try again with a different account or ${uiLink('join the beta now', getProductUpdatesUrl('253920', accountId))}`,
             },
             examples: {
                 default: 'Migrate an existing project to the new version of the projects framework.',
@@ -2002,6 +2001,7 @@ export const commands = {
             describe: 'Download your project files from HubSpot.',
             examples: {
                 default: 'Download the project myProject into myProjectFolder folder',
+                json: 'Output the download result as JSON for scripting',
             },
             logs: {
                 downloadCancelled: 'Cancelling project download',
@@ -2125,6 +2125,7 @@ export const commands = {
             examples: {
                 default: 'Validate the project before uploading',
                 withProfile: 'Validate the project with a profile before uploading.',
+                json: 'Output validation results as JSON for scripting',
             },
             success: (projectName) => `Project ${projectName} is valid and ready to upload`,
             failure: (projectName, profileName) => `Project ${projectName} is invalid${profileName ? ` with profile "${profileName}" applied` : ''}`,

package/lib/constants.d.ts

@@ -80,7 +80,6 @@ export declare const APP_AUTH_TYPES: {
 export declare const FEATURES: {
     readonly UNIFIED_APPS: "Developers:UnifiedApps:PrivateBeta";
     readonly APP_EVENTS: "Developers:UnifiedApps:AppEventsAccess";
-    readonly THEME_MIGRATION_2025_2: "Developers:ProjectThemeMigrations:2025.2";
     readonly AGENT_TOOLS: "ThirdPartyAgentTools";
     readonly APP_ACTIONS: "Developers:AppActions";
 };

package/lib/constants.js

@@ -72,7 +72,6 @@ export const APP_AUTH_TYPES = {
 export const FEATURES = {
     UNIFIED_APPS: 'Developers:UnifiedApps:PrivateBeta',
     APP_EVENTS: 'Developers:UnifiedApps:AppEventsAccess',
-    THEME_MIGRATION_2025_2: 'Developers:ProjectThemeMigrations:2025.2',
     AGENT_TOOLS: 'ThirdPartyAgentTools',
     APP_ACTIONS: 'Developers:AppActions',
 };

package/lib/filesystem.d.ts

@@ -1,2 +1,8 @@
 export declare function resolveLocalPath(filepath?: string): string;
+/**
+ * Returns true if childPath is parentDirectory itself or a descendant of it.
+ * Compares resolved paths segment by segment, so sibling directories with a
+ * shared name prefix (foo-backup vs. foo) are not treated as descendants.
+ */
+export declare function isPathInsideDirectory(childPath: string, parentDirectory: string): boolean;
 export declare function isPathFolder(path: string): boolean;

package/lib/filesystem.js

@@ -7,6 +7,15 @@ export function resolveLocalPath(filepath) {
         : // Use CWD if optional filepath is not passed.
             getCwd();
 }
+/**
+ * Returns true if childPath is parentDirectory itself or a descendant of it.
+ * Compares resolved paths segment by segment, so sibling directories with a
+ * shared name prefix (foo-backup vs. foo) are not treated as descendants.
+ */
+export function isPathInsideDirectory(childPath, parentDirectory) {
+    const relativePath = path.relative(path.resolve(parentDirectory), path.resolve(childPath));
+    return !relativePath.startsWith('..') && !path.isAbsolute(relativePath);
+}
 export function isPathFolder(path) {
     const splitPath = path.split('/');
     const fileOrFolderName = splitPath[splitPath.length - 1];

package/lib/jsonOutput/download.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+export declare const DownloadSchema: z.ZodObject<{
+    projectName: z.ZodString;
+    buildId: z.ZodNumber;
+    dest: z.ZodString;
+}, z.core.$strip>;
+export type DownloadJsonOutput = z.infer<typeof DownloadSchema>;

package/lib/jsonOutput/download.js

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+export const DownloadSchema = z.object({
+    projectName: z.string(),
+    buildId: z.number(),
+    dest: z.string(),
+});

package/lib/jsonOutput/validate.d.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+declare const ValidationIssueSchema: z.ZodObject<{
+    message: z.ZodString;
+    file: z.ZodOptional<z.ZodString>;
+    profile: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const ProfileValidationSchema: z.ZodObject<{
+    name: z.ZodString;
+    accountId: z.ZodOptional<z.ZodNumber>;
+    valid: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const ValidateSchema: z.ZodObject<{
+    valid: z.ZodBoolean;
+    projectName: z.ZodOptional<z.ZodString>;
+    platformVersion: z.ZodOptional<z.ZodString>;
+    profile: z.ZodOptional<z.ZodString>;
+    errors: z.ZodArray<z.ZodObject<{
+        message: z.ZodString;
+        file: z.ZodOptional<z.ZodString>;
+        profile: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    warnings: z.ZodArray<z.ZodObject<{
+        message: z.ZodString;
+        file: z.ZodOptional<z.ZodString>;
+        profile: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    profiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        accountId: z.ZodOptional<z.ZodNumber>;
+        valid: z.ZodBoolean;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type ValidationIssueJsonOutput = z.infer<typeof ValidationIssueSchema>;
+export type ProfileValidationJsonOutput = z.infer<typeof ProfileValidationSchema>;
+export type ValidateJsonOutput = z.infer<typeof ValidateSchema>;
+export {};

package/lib/jsonOutput/validate.js

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+const ValidationIssueSchema = z.object({
+    message: z.string(),
+    file: z.string().optional(),
+    profile: z.string().optional(),
+});
+const ProfileValidationSchema = z.object({
+    name: z.string(),
+    accountId: z.number().optional(),
+    valid: z.boolean(),
+});
+export const ValidateSchema = z.object({
+    valid: z.boolean(),
+    projectName: z.string().optional(),
+    platformVersion: z.string().optional(),
+    profile: z.string().optional(),
+    errors: z.array(ValidationIssueSchema),
+    warnings: z.array(ValidationIssueSchema),
+    profiles: z.array(ProfileValidationSchema).optional(),
+});

package/lib/projects/projectProfiles.d.ts

@@ -3,6 +3,7 @@ import { ProjectConfig } from '../../types/Projects.js';
 export declare function logProfileHeader(profileName: string): void;
 export declare function logProfileFooter(profile: HsProfileFile, includeVariables?: boolean): void;
 export declare function loadProfile(projectConfig: ProjectConfig, projectDir: string, profileName: string): HsProfileFile | never;
+export declare function getProfileAccountId(projectConfig: ProjectConfig, projectDir: string, profileName: string): number | undefined;
 export declare function loadAndValidateProfile(projectConfig: ProjectConfig, projectDir: string, profileName: string, silent?: boolean): Promise<HsProfileFile | never>;
 type ValidateProjectForProfileOptions = {
     projectConfig: ProjectConfig;

package/lib/projects/projectProfiles.js

@@ -48,6 +48,14 @@ export function loadProfile(projectConfig, projectDir, profileName) {
     }
     return profile;
 }
+export function getProfileAccountId(projectConfig, projectDir, profileName) {
+    try {
+        return loadProfile(projectConfig, projectDir, profileName).accountId;
+    }
+    catch (_e) {
+        return undefined;
+    }
+}
 export async function loadAndValidateProfile(projectConfig, projectDir, profileName, silent = false) {
     if (!silent) {
         logProfileHeader(profileName);

package/lib/projects/uieLinting.d.ts

@@ -24,6 +24,8 @@ export declare function hasEslintConfig(directory: string): boolean;
 export declare function hasDeprecatedEslintConfig(directory: string): boolean;
 export declare function getDeprecatedEslintConfigFiles(directory: string): string[];
 export declare function createEslintConfig(directory: string, platformVersion?: string | null): Promise<string>;
+export declare function getUieComponentDirPrefixes(srcDir: string): string[];
+export declare function isUieComponentDirectory(directory: string, srcDir: string): boolean;
 export declare function getUieLintablePackageJsonLocations(projectConfig: LoadedProjectConfig): Promise<string[]>;
 export declare const HUBSPOT_UI_EXTENSIONS_RULE_PREFIX = "@hubspot/ui-extensions/";
 export declare function isHubSpotEslintConfigActive(directory: string): Promise<boolean>;

package/lib/projects/uieLinting.js

@@ -9,9 +9,10 @@ import { commands } from '../../lang/en.js';
 import { uiLogger } from '../ui/logger.js';
 import { clearPackageJsonCache, safeGetPackageJsonCached, } from '../npm/packageJson.js';
 import { debugError } from '../errorHandlers/index.js';
+import { isPathInsideDirectory } from '../filesystem.js';
 import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { DEFAULT_PROJECT_TEMPLATE_BRANCH, HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, } from '../constants.js';
-import { CARDS_KEY, Components, PAGES_KEY, SETTINGS_KEY, } from '@hubspot/project-parsing-lib/constants';
+import { ACTIONS_KEY, CARDS_KEY, Components, PAGES_KEY, SETTINGS_KEY, } from '@hubspot/project-parsing-lib/constants';
 export const REQUIRED_PACKAGES_AND_MIN_VERSIONS = {
     eslint: '9.0.0',
     '@eslint/js': '9.0.0',
@@ -42,6 +43,7 @@ const DEPRECATED_ESLINT_CONFIG_FILES = [
     '.eslintrc',
 ];
 const UIE_COMPONENTS = [
+    Components[ACTIONS_KEY],
     Components[CARDS_KEY],
     Components[SETTINGS_KEY],
     Components[PAGES_KEY],
@@ -169,16 +171,19 @@ export async function createEslintConfig(directory, platformVersion) {
         throw error;
     }
 }
-export async function getUieLintablePackageJsonLocations(projectConfig) {
-    const srcDirAbsolute = path.resolve(projectConfig.projectDir, projectConfig.projectConfig.srcDir);
-    const uiePackageDirPrefixes = UIE_COMPONENTS.map(component => path.join(srcDirAbsolute, component.parentComponent
+export function getUieComponentDirPrefixes(srcDir) {
+    const srcDirAbsolute = path.resolve(srcDir);
+    return UIE_COMPONENTS.map(component => path.join(srcDirAbsolute, component.parentComponent
         ? Components[component.parentComponent].dir
         : '', component.dir));
+}
+export function isUieComponentDirectory(directory, srcDir) {
+    return getUieComponentDirPrefixes(srcDir).some(componentDir => isPathInsideDirectory(directory, componentDir));
+}
+export async function getUieLintablePackageJsonLocations(projectConfig) {
+    const srcDirAbsolute = path.resolve(projectConfig.projectDir, projectConfig.projectConfig.srcDir);
     const allLocations = await getProjectPackageJsonLocations(projectConfig.projectDir);
-    return allLocations.filter(location => {
-        const resolvedLocation = path.resolve(location);
-        return uiePackageDirPrefixes.some(prefix => resolvedLocation.startsWith(prefix));
-    });
+    return allLocations.filter(location => isUieComponentDirectory(location, srcDirAbsolute));
 }
 export const HUBSPOT_UI_EXTENSIONS_RULE_PREFIX = '@hubspot/ui-extensions/';
 function getEnvironmentWithoutNpmConfig() {

package/lib/projects/upload.d.ts

@@ -25,7 +25,11 @@ type HandleProjectUploadArg<T> = {
     force?: boolean;
 };
 export declare function handleProjectUpload<T>({ accountId, projectConfig, projectDir, callbackFunc, profile, uploadMessage, forceCreate, isUploadCommand, sendIR, skipValidation, skipNpmAudit, skipAutoDeploy, force, }: HandleProjectUploadArg<T>): Promise<ProjectUploadResult<T>>;
-export declare function validateSourceDirectory(srcDir: string, projectConfig: ProjectConfig, projectDir: string): Promise<void>;
+export type SourceDirectoryWarning = {
+    message: string;
+    file: string;
+};
+export declare function validateSourceDirectory(srcDir: string, projectConfig: ProjectConfig, projectDir: string): Promise<SourceDirectoryWarning[]>;
 export declare function validateNoHSMetaMismatch(srcDir: string, projectConfig: ProjectConfig): Promise<void>;
 type HandleTranslateArg = {
     projectDir: string;

package/lib/projects/upload.js

@@ -159,14 +159,19 @@ export async function validateSourceDirectory(srcDir, projectConfig, projectDir)
     if (!projectFilePaths || projectFilePaths.length === 0) {
         throw new ProjectValidationError(lib.projectUpload.handleProjectUpload.emptySource(projectConfig.srcDir));
     }
+    const warnings = [];
     if (!isLegacyProject(projectConfig.platformVersion)) {
         projectFilePaths.forEach(filePath => {
             const filename = path.basename(filePath);
             if (LEGACY_CONFIG_FILES.includes(filename)) {
-                uiLogger.warn(lib.projectUpload.handleProjectUpload.legacyFileDetected(path.relative(projectDir, filePath), projectConfig.platformVersion));
+                const relativePath = path.relative(projectDir, filePath);
+                const message = lib.projectUpload.handleProjectUpload.legacyFileDetected(relativePath, projectConfig.platformVersion);
+                warnings.push({ message, file: relativePath });
+                uiLogger.warn(message);
             }
         });
     }
+    return warnings;
 }
 export async function validateNoHSMetaMismatch(srcDir, projectConfig) {
     const hasHsMetaFiles = await projectContainsHsMetaFiles(srcDir);

package/lib/projects/validate.d.ts

@@ -1,9 +1,18 @@
 import { ProjectConfig } from '../../types/Projects.js';
+import { ProfileValidationJsonOutput, ValidationIssueJsonOutput } from '../jsonOutput/validate.js';
+export type ProjectValidationResult = {
+    valid: boolean;
+    errors: ValidationIssueJsonOutput[];
+    warnings: ValidationIssueJsonOutput[];
+    profiles: ProfileValidationJsonOutput[];
+};
 type ValidateProjectArgs = {
     projectConfig: ProjectConfig;
     projectDir: string;
     derivedAccountId: number;
     profile?: string;
+    formatOutputAsJson?: boolean;
 };
-export declare function validateProject({ projectConfig, projectDir, derivedAccountId, profile, }: ValidateProjectArgs): Promise<boolean>;
+export declare function toIssue(error: unknown, profile?: string): ValidationIssueJsonOutput;
+export declare function validateProject({ projectConfig, projectDir, derivedAccountId, profile, formatOutputAsJson, }: ValidateProjectArgs): Promise<ProjectValidationResult>;
 export {};

package/lib/projects/validate.js

@@ -1,11 +1,21 @@
 import path from 'path';
+import stripAnsi from 'strip-ansi';
 import { getAllHsProfiles } from '@hubspot/project-parsing-lib/profiles';
 import { uiLogger } from '../ui/logger.js';
 import SpinniesManager from '../ui/SpinniesManager.js';
-import { logError } from '../errorHandlers/index.js';
+import { logError, getErrorMessage } from '../errorHandlers/index.js';
 import { commands } from '../../lang/en.js';
-import { validateProjectForProfile } from './projectProfiles.js';
+import { getProfileAccountId, validateProjectForProfile, } from './projectProfiles.js';
 import { handleTranslate, validateSourceDirectory } from './upload.js';
+export function toIssue(error, profile) {
+    const issue = {
+        message: stripAnsi(getErrorMessage(error)).trim(),
+    };
+    if (profile) {
+        issue.profile = profile;
+    }
+    return issue;
+}
 function logValidationErrors(validationErrors) {
     uiLogger.log('');
     validationErrors.forEach(error => {
@@ -17,41 +27,73 @@ function logValidationErrors(validationErrors) {
         }
     });
 }
-export async function validateProject({ projectConfig, projectDir, derivedAccountId, profile, }) {
+async function validateProfile({ projectConfig, projectDir, derivedAccountId, profileName, formatOutputAsJson, indentSpinners, }) {
+    const rawErrors = await validateProjectForProfile({
+        projectConfig,
+        projectDir,
+        profileName,
+        derivedAccountId,
+        ...(indentSpinners ? { indentSpinners: true } : {}),
+    });
+    const accountId = formatOutputAsJson
+        ? getProfileAccountId(projectConfig, projectDir, profileName)
+        : undefined;
+    const profile = {
+        name: profileName,
+        valid: rawErrors.length === 0,
+    };
+    if (accountId !== undefined) {
+        profile.accountId = accountId;
+    }
+    return {
+        profile,
+        errors: rawErrors.map(e => toIssue(e, profileName)),
+        rawErrors,
+    };
+}
+export async function validateProject({ projectConfig, projectDir, derivedAccountId, profile, formatOutputAsJson, }) {
+    const errors = [];
+    const warnings = [];
+    const profiles = [];
     let valid = true;
     const srcDir = path.resolve(projectDir, projectConfig.srcDir);
-    const profiles = await getAllHsProfiles(path.join(projectDir, projectConfig.srcDir));
-    // If a profile is specified, only validate that profile
+    const projectProfiles = await getAllHsProfiles(path.join(projectDir, projectConfig.srcDir));
     if (profile) {
-        const validationErrors = await validateProjectForProfile({
+        const result = await validateProfile({
             projectConfig,
             projectDir,
-            profileName: profile,
             derivedAccountId,
+            profileName: profile,
+            formatOutputAsJson,
+            indentSpinners: false,
         });
-        if (validationErrors.length) {
-            logValidationErrors(validationErrors);
+        profiles.push(result.profile);
+        if (result.rawErrors.length) {
             valid = false;
+            errors.push(...result.errors);
+            logValidationErrors(result.rawErrors);
         }
     }
-    else if (profiles.length > 0) {
-        // If no profile was specified and the project has profiles, validate all of them
+    else if (projectProfiles.length > 0) {
         SpinniesManager.add('validatingAllProfiles', {
             text: commands.project.validate.spinners.validatingAllProfiles,
         });
-        const errors = [];
-        for (const profileName of profiles) {
-            const validationErrors = await validateProjectForProfile({
+        const rawErrors = [];
+        for (const profileName of projectProfiles) {
+            const result = await validateProfile({
                 projectConfig,
                 projectDir,
-                profileName,
                 derivedAccountId,
+                profileName,
+                formatOutputAsJson,
                 indentSpinners: true,
             });
-            if (validationErrors.length) {
-                errors.push(...validationErrors);
+            profiles.push(result.profile);
+            if (result.rawErrors.length) {
                 valid = false;
+                errors.push(...result.errors);
             }
+            rawErrors.push(...result.rawErrors);
         }
         if (valid) {
             SpinniesManager.succeed('validatingAllProfiles', {
@@ -63,10 +105,9 @@ export async function validateProject({ projectConfig, projectDir, derivedAccoun
                 text: commands.project.validate.spinners.allProfilesValidationFailed,
             });
         }
-        logValidationErrors(errors);
+        logValidationErrors(rawErrors);
     }
     else {
-        // If the project has no profiles, validate the project without a profile
         try {
             await handleTranslate({
                 projectDir,
@@ -76,21 +117,26 @@ export async function validateProject({ projectConfig, projectDir, derivedAccoun
             });
         }
         catch (e) {
+            valid = false;
+            errors.push(toIssue(e));
             uiLogger.error(commands.project.validate.failure(projectConfig.name));
             logError(e);
-            valid = false;
             uiLogger.log('');
         }
     }
-    if (!valid) {
-        return false;
-    }
-    try {
-        await validateSourceDirectory(srcDir, projectConfig, projectDir);
-    }
-    catch (e) {
-        logError(e);
-        return false;
+    if (valid) {
+        try {
+            const sourceWarnings = await validateSourceDirectory(srcDir, projectConfig, projectDir);
+            warnings.push(...sourceWarnings.map(warning => ({
+                message: stripAnsi(warning.message).trim(),
+                file: warning.file,
+            })));
+        }
+        catch (e) {
+            valid = false;
+            errors.push(toIssue(e));
+            logError(e);
+        }
     }
-    return true;
+    return { valid, errors, warnings, profiles };
 }

package/lib/projects/validateLintConfigOnUpload.js

@@ -1,18 +1,19 @@
 import path from 'path';
 import { lib } from '../../lang/en.js';
 import { uiLogger } from '../ui/logger.js';
-import { areAllLintPackagesInstalled, hasEslintConfig, isHubSpotEslintConfigActive, } from './uieLinting.js';
+import { areAllLintPackagesInstalled, hasEslintConfig, isHubSpotEslintConfigActive, isUieComponentDirectory, } from './uieLinting.js';
 export async function validateLintConfigOnUpload({ srcDir, projectDir, parsedPackageJsons, isLegacyPlatform, }) {
     const lintRoots = new Set();
     if (isLegacyPlatform) {
         lintRoots.add(srcDir);
     }
     else {
+        // Only check the directories that `hs project lint` actually covers,
+        // otherwise these warnings can never be resolved.
         for (const { dir } of parsedPackageJsons) {
-            lintRoots.add(dir);
-        }
-        if (lintRoots.size === 0) {
-            lintRoots.add(srcDir);
+            if (isUieComponentDirectory(dir, srcDir)) {
+                lintRoots.add(dir);
+            }
         }
     }
     let hasAnyOutput = false;

package/lib/projects/workspaces.js

@@ -4,6 +4,7 @@ import crypto from 'crypto';
 import { shouldIgnoreFile } from '@hubspot/local-dev-lib/ignoreRules';
 import { getPackableFiles, } from '@hubspot/project-parsing-lib/workspaces';
 import { uiLogger } from '../ui/logger.js';
+import { isPathInsideDirectory } from '../filesystem.js';
 import { lib } from '../../lang/en.js';
 const FILE_PROTOCOL_PREFIX = 'file:';
 const LINK_PROTOCOL_PREFIX = 'link:';
@@ -62,14 +63,6 @@ export function computeExternalArchivePath(absolutePath, kind = KIND_DIRECTORY)
     }
     return path.posix.join('_workspaces', `${name}-${shortHash(resolved)}`);
 }
-/**
- * Returns true if dir is inside srcDir (i.e. it will already be included
- * in the archive from the srcDir walk and must not be copied again).
- */
-function isInsideSrcDir(dir, srcDir) {
-    const rel = path.relative(path.resolve(srcDir), path.resolve(dir));
-    return !rel.startsWith('..') && !path.isAbsolute(rel);
-}
 /**
  * Creates a file filter function for workspace archiving.
  * Filters files based on packable files list and ignore rules.
@@ -108,7 +101,7 @@ async function archiveWorkspaceDirectories(archive, srcDir, workspaceMappings) {
         if (!packageWorkspaceEntries.has(sourcePackageJsonPath)) {
             packageWorkspaceEntries.set(sourcePackageJsonPath, []);
         }
-        if (isInsideSrcDir(workspaceDir, srcDir)) {
+        if (isPathInsideDirectory(workspaceDir, srcDir)) {
             // Internal: already in archive from srcDir walk.
             // Store the relative path from the package.json directory so npm can resolve it.
             const relPath = toPosixPath(path.relative(path.dirname(sourcePackageJsonPath), path.resolve(workspaceDir)));
@@ -161,7 +154,7 @@ async function archiveFileDependencies(archive, srcDir, fileDependencyMappings,
     const toArchive = [];
     for (const mapping of fileDependencyMappings) {
         const { packageName, localPath, sourcePackageJsonPath, kind, protocol } = mapping;
-        if (isInsideSrcDir(localPath, srcDir)) {
+        if (isPathInsideDirectory(localPath, srcDir)) {
             continue;
         }
         const archivePath = computeExternalArchivePath(localPath, kind);
@@ -325,7 +318,7 @@ export function getPackageJsonPathsToUpdate(srcDir, workspaceMappings, fileDepen
         paths.add(toPosixPath(path.relative(srcDir, sourcePackageJsonPath)));
     }
     for (const { localPath, sourcePackageJsonPath } of fileDependencyMappings) {
-        if (!isInsideSrcDir(localPath, srcDir)) {
+        if (!isPathInsideDirectory(localPath, srcDir)) {
             paths.add(toPosixPath(path.relative(srcDir, sourcePackageJsonPath)));
         }
     }
@@ -334,12 +327,12 @@ export function getPackageJsonPathsToUpdate(srcDir, workspaceMappings, fileDepen
 function getDirsWithExternalDeps(srcDir, workspaceMappings, fileDependencyMappings) {
     const dirs = new Set();
     for (const { workspaceDir, sourcePackageJsonPath } of workspaceMappings) {
-        if (!isInsideSrcDir(workspaceDir, srcDir)) {
+        if (!isPathInsideDirectory(workspaceDir, srcDir)) {
             dirs.add(path.dirname(sourcePackageJsonPath));
         }
     }
     for (const { localPath, sourcePackageJsonPath } of fileDependencyMappings) {
-        if (!isInsideSrcDir(localPath, srcDir)) {
+        if (!isPathInsideDirectory(localPath, srcDir)) {
             dirs.add(path.dirname(sourcePackageJsonPath));
         }
     }

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

@@ -18,9 +18,9 @@ declare const inputSchemaZodObject: z.ZodObject<{
     features: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         card: "card";
         settings: "settings";
+        "crm-bulk-action": "crm-bulk-action";
         "app-event": "app-event";
         "workflow-action-tool": "workflow-action-tool";
-        "crm-bulk-action": "crm-bulk-action";
         page: "page";
         webhooks: "webhooks";
         "app-function": "app-function";

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

@@ -22,9 +22,9 @@ declare const inputSchemaZodObject: z.ZodObject<{
     features: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         card: "card";
         settings: "settings";
+        "crm-bulk-action": "crm-bulk-action";
         "app-event": "app-event";
         "workflow-action-tool": "workflow-action-tool";
-        "crm-bulk-action": "crm-bulk-action";
         page: "page";
         webhooks: "webhooks";
         "app-function": "app-function";

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

@@ -4,9 +4,9 @@ export declare const absoluteCurrentWorkingDirectory: z.ZodString;
 export declare const features: z.ZodOptional<z.ZodArray<z.ZodEnum<{
     card: "card";
     settings: "settings";
+    "crm-bulk-action": "crm-bulk-action";
     "app-event": "app-event";
     "workflow-action-tool": "workflow-action-tool";
-    "crm-bulk-action": "crm-bulk-action";
     page: "page";
     webhooks: "webhooks";
     "app-function": "app-function";

package/package.json

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