@hubspot/cli 8.3.0 → 8.3.1-experimental.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (859) hide show
  1. package/api/feedback.d.ts +10 -0
  2. package/api/feedback.js +9 -0
  3. package/api/migrate.js +3 -3
  4. package/api/releases.d.ts +39 -0
  5. package/api/releases.js +41 -0
  6. package/bin/cli.js +39 -8
  7. package/bin/hs.js +1 -0
  8. package/bin/hscms.js +1 -0
  9. package/bin/setupColor.d.ts +2 -0
  10. package/bin/setupColor.js +10 -0
  11. package/commands/account/auth.d.ts +6 -3
  12. package/commands/account/auth.js +49 -30
  13. package/commands/account/clean.js +7 -6
  14. package/commands/account/createOverride.js +12 -7
  15. package/commands/account/info.js +36 -17
  16. package/commands/account/link.d.ts +4 -0
  17. package/commands/account/link.js +87 -0
  18. package/commands/account/list.js +32 -76
  19. package/commands/account/remove.js +4 -3
  20. package/commands/account/removeOverride.js +13 -10
  21. package/commands/account/rename.js +5 -6
  22. package/commands/account/unlink.d.ts +4 -0
  23. package/commands/account/unlink.js +68 -0
  24. package/commands/account/use.js +79 -20
  25. package/commands/account.js +4 -0
  26. package/commands/api.d.ts +13 -0
  27. package/commands/api.js +161 -0
  28. package/commands/app/logDetails.d.ts +9 -0
  29. package/commands/app/logDetails.js +86 -0
  30. package/commands/app/logs.d.ts +13 -0
  31. package/commands/app/logs.js +126 -0
  32. package/commands/app/migrate.js +13 -13
  33. package/commands/app/secret/add.js +7 -8
  34. package/commands/app/secret/delete.js +10 -11
  35. package/commands/app/secret/list.js +7 -8
  36. package/commands/app/secret/update.js +9 -10
  37. package/commands/app/secret.js +1 -1
  38. package/commands/app.js +8 -1
  39. package/commands/auth.js +16 -15
  40. package/commands/cms/app/create.js +9 -5
  41. package/commands/cms/convertFields.js +8 -8
  42. package/commands/cms/delete.js +2 -3
  43. package/commands/cms/fetch.js +7 -7
  44. package/commands/cms/function/create.js +7 -35
  45. package/commands/cms/function/deploy.js +10 -4
  46. package/commands/cms/function/list.js +15 -7
  47. package/commands/cms/function/logs.js +19 -23
  48. package/commands/cms/function/server.js +22 -10
  49. package/commands/cms/getReactModule.js +7 -8
  50. package/commands/cms/lighthouseScore.js +26 -25
  51. package/commands/cms/lint.js +4 -5
  52. package/commands/cms/list.js +5 -6
  53. package/commands/cms/module/create.js +15 -5
  54. package/commands/cms/module/marketplace-validate.js +7 -8
  55. package/commands/cms/mv.js +2 -3
  56. package/commands/cms/template/create.js +10 -6
  57. package/commands/cms/theme/create.js +5 -5
  58. package/commands/cms/theme/generate-selectors.js +5 -4
  59. package/commands/cms/theme/marketplace-validate.js +8 -9
  60. package/commands/cms/theme/preview.js +24 -9
  61. package/commands/cms/upload.js +21 -12
  62. package/commands/cms/watch.js +7 -5
  63. package/commands/cms/webpack/create.js +7 -34
  64. package/commands/completion.js +3 -5
  65. package/commands/config/migrate.js +6 -7
  66. package/commands/config/set.js +29 -11
  67. package/commands/customObject/create.js +4 -5
  68. package/commands/customObject/createSchema.js +6 -8
  69. package/commands/customObject/deleteSchema.js +4 -5
  70. package/commands/customObject/fetchAllSchemas.js +2 -3
  71. package/commands/customObject/fetchSchema.js +2 -3
  72. package/commands/customObject/listSchemas.js +2 -3
  73. package/commands/customObject/updateSchema.js +6 -8
  74. package/commands/customObject.js +2 -2
  75. package/commands/doctor.js +8 -8
  76. package/commands/feedback.d.ts +6 -2
  77. package/commands/feedback.js +87 -11
  78. package/commands/filemanager/fetch.js +5 -6
  79. package/commands/filemanager/upload.js +5 -5
  80. package/commands/getStarted.js +38 -42
  81. package/commands/hubdb/clear.js +5 -6
  82. package/commands/hubdb/create.js +4 -5
  83. package/commands/hubdb/delete.js +8 -9
  84. package/commands/hubdb/fetch.js +5 -6
  85. package/commands/hubdb/list.d.ts +1 -1
  86. package/commands/hubdb/list.js +23 -22
  87. package/commands/init.js +20 -20
  88. package/commands/mcp/setup.d.ts +3 -0
  89. package/commands/mcp/setup.js +43 -8
  90. package/commands/mcp/start.js +2 -3
  91. package/commands/open.js +4 -5
  92. package/commands/project/add.d.ts +3 -2
  93. package/commands/project/add.js +26 -18
  94. package/commands/project/appInstallStatus.d.ts +5 -0
  95. package/commands/project/appInstallStatus.js +139 -0
  96. package/commands/project/create.d.ts +4 -2
  97. package/commands/project/create.js +64 -23
  98. package/commands/project/delete.d.ts +7 -0
  99. package/commands/project/delete.js +74 -0
  100. package/commands/project/deploy.d.ts +2 -1
  101. package/commands/project/deploy.js +72 -50
  102. package/commands/project/dev/index.d.ts +3 -3
  103. package/commands/project/dev/index.js +49 -92
  104. package/commands/project/dev/unifiedFlow.js +81 -22
  105. package/commands/project/download.d.ts +5 -2
  106. package/commands/project/download.js +77 -25
  107. package/commands/project/info.d.ts +5 -0
  108. package/commands/project/info.js +73 -0
  109. package/commands/project/installApp.d.ts +8 -0
  110. package/commands/project/installApp.js +185 -0
  111. package/commands/project/installDeps.js +17 -11
  112. package/commands/project/lint.js +57 -19
  113. package/commands/project/list.d.ts +3 -2
  114. package/commands/project/list.js +34 -15
  115. package/commands/project/listBuilds.d.ts +3 -2
  116. package/commands/project/listBuilds.js +50 -19
  117. package/commands/project/logs.js +9 -12
  118. package/commands/project/migrate.js +28 -33
  119. package/commands/project/open.js +20 -13
  120. package/commands/project/profile/add.d.ts +2 -1
  121. package/commands/project/profile/add.js +42 -13
  122. package/commands/project/profile/delete.d.ts +1 -1
  123. package/commands/project/profile/delete.js +23 -15
  124. package/commands/project/release/create.d.ts +8 -0
  125. package/commands/project/release/create.js +160 -0
  126. package/commands/project/release/info.d.ts +7 -0
  127. package/commands/project/release/info.js +148 -0
  128. package/commands/project/release/list.d.ts +7 -0
  129. package/commands/project/release/list.js +119 -0
  130. package/commands/project/release/preview.d.ts +9 -0
  131. package/commands/project/release/preview.js +167 -0
  132. package/commands/project/release.d.ts +3 -0
  133. package/commands/project/release.js +26 -0
  134. package/commands/project/updateDeps.js +15 -11
  135. package/commands/project/upload.d.ts +7 -1
  136. package/commands/project/upload.js +163 -35
  137. package/commands/project/validate.d.ts +3 -2
  138. package/commands/project/validate.js +73 -103
  139. package/commands/project/watch.js +27 -29
  140. package/commands/project.js +17 -4
  141. package/commands/sandbox/create.js +18 -18
  142. package/commands/sandbox/delete.js +16 -18
  143. package/commands/sandbox.js +1 -1
  144. package/commands/secret/addSecret.js +6 -7
  145. package/commands/secret/deleteSecret.js +5 -6
  146. package/commands/secret/listSecret.js +2 -3
  147. package/commands/secret/updateSecret.js +4 -5
  148. package/commands/testAccount/create.d.ts +3 -2
  149. package/commands/testAccount/create.js +29 -25
  150. package/commands/testAccount/createConfig.js +7 -8
  151. package/commands/testAccount/delete.js +27 -18
  152. package/commands/testAccount/importData.d.ts +1 -1
  153. package/commands/testAccount/importData.js +6 -7
  154. package/commands/upgrade.js +11 -10
  155. package/lang/en.d.ts +710 -58
  156. package/lang/en.js +909 -121
  157. package/lib/CLIWebSocketServer.d.ts +5 -3
  158. package/lib/CLIWebSocketServer.js +31 -4
  159. package/lib/accountAuth.d.ts +4 -1
  160. package/lib/accountAuth.js +65 -19
  161. package/lib/accountCredentials.d.ts +1 -0
  162. package/lib/accountCredentials.js +25 -0
  163. package/lib/accountTargetDiscovery.d.ts +15 -0
  164. package/lib/accountTargetDiscovery.js +175 -0
  165. package/lib/agentHelp.d.ts +17 -0
  166. package/lib/agentHelp.js +90 -0
  167. package/lib/api/usageTracking.d.ts +30 -0
  168. package/lib/api/usageTracking.js +11 -0
  169. package/lib/app/install.d.ts +22 -0
  170. package/lib/app/install.js +42 -0
  171. package/lib/app/logs.d.ts +38 -0
  172. package/lib/app/logs.js +225 -0
  173. package/lib/app/migrate.js +18 -15
  174. package/lib/app/urls.d.ts +2 -1
  175. package/lib/app/urls.js +6 -4
  176. package/lib/auth/awaitPersonalAccessKeyOverWebsocket.d.ts +4 -0
  177. package/lib/auth/awaitPersonalAccessKeyOverWebsocket.js +146 -0
  178. package/lib/buildAccount.js +4 -4
  179. package/lib/cms/serverlessDevRuntime.d.ts +1 -0
  180. package/lib/cms/serverlessDevRuntime.js +72 -0
  181. package/lib/commonOpts.js +10 -2
  182. package/lib/configOptions.d.ts +10 -10
  183. package/lib/configOptions.js +10 -11
  184. package/lib/constants.d.ts +24 -2
  185. package/lib/constants.js +33 -2
  186. package/lib/dependencyManagement.js +10 -17
  187. package/lib/doctor/Diagnosis.js +5 -5
  188. package/lib/doctor/DiagnosticInfoBuilder.d.ts +2 -2
  189. package/lib/doctor/DiagnosticInfoBuilder.js +8 -8
  190. package/lib/doctor/Doctor.d.ts +1 -0
  191. package/lib/doctor/Doctor.js +40 -16
  192. package/lib/errorHandlers/index.js +4 -3
  193. package/lib/errorHandlers/suppressError.js +7 -3
  194. package/lib/errors/ProjectErrors.d.ts +0 -6
  195. package/lib/errors/ProjectErrors.js +0 -12
  196. package/lib/errors/ProjectValidationError.d.ts +2 -1
  197. package/lib/errors/ProjectValidationError.js +3 -1
  198. package/lib/errors/PromptExitError.d.ts +4 -2
  199. package/lib/errors/PromptExitError.js +3 -0
  200. package/lib/feedback.d.ts +3 -0
  201. package/lib/feedback.js +13 -0
  202. package/lib/filesystem.d.ts +6 -0
  203. package/lib/filesystem.js +9 -0
  204. package/lib/getStartedV2Actions.js +18 -21
  205. package/lib/hasFeature.js +1 -2
  206. package/lib/importData.js +3 -4
  207. package/lib/jsonOutput/accountAuth.d.ts +7 -0
  208. package/lib/jsonOutput/accountAuth.js +6 -0
  209. package/lib/jsonOutput/projectAdd.d.ts +9 -0
  210. package/lib/jsonOutput/projectAdd.js +10 -0
  211. package/lib/jsonOutput/projectAppInstallStatus.d.ts +14 -0
  212. package/lib/jsonOutput/projectAppInstallStatus.js +14 -0
  213. package/lib/jsonOutput/projectCreate.d.ts +8 -0
  214. package/lib/jsonOutput/projectCreate.js +7 -0
  215. package/lib/jsonOutput/projectDeploy.d.ts +5 -0
  216. package/lib/jsonOutput/projectDeploy.js +4 -0
  217. package/lib/jsonOutput/projectDownload.d.ts +8 -0
  218. package/lib/jsonOutput/projectDownload.js +7 -0
  219. package/lib/jsonOutput/projectInfo.d.ts +21 -0
  220. package/lib/jsonOutput/projectInfo.js +19 -0
  221. package/lib/jsonOutput/projectInstallApp.d.ts +11 -0
  222. package/lib/jsonOutput/projectInstallApp.js +10 -0
  223. package/lib/jsonOutput/projectList.d.ts +29 -0
  224. package/lib/jsonOutput/projectList.js +28 -0
  225. package/lib/jsonOutput/projectListBuilds.d.ts +75 -0
  226. package/lib/jsonOutput/projectListBuilds.js +65 -0
  227. package/lib/jsonOutput/projectRelease.d.ts +49 -0
  228. package/lib/jsonOutput/projectRelease.js +44 -0
  229. package/lib/jsonOutput/projectUpload.d.ts +30 -0
  230. package/lib/jsonOutput/projectUpload.js +24 -0
  231. package/lib/jsonOutput/projectValidate.d.ts +36 -0
  232. package/lib/jsonOutput/projectValidate.js +20 -0
  233. package/lib/jsonOutput/testAccountCreate.d.ts +7 -0
  234. package/lib/jsonOutput/testAccountCreate.js +6 -0
  235. package/lib/link/accountTableUtils.d.ts +10 -0
  236. package/lib/link/accountTableUtils.js +39 -0
  237. package/lib/link/index.d.ts +18 -0
  238. package/lib/link/index.js +185 -0
  239. package/lib/link/linkUtils.d.ts +5 -0
  240. package/lib/link/linkUtils.js +49 -0
  241. package/lib/link/prompts.d.ts +7 -0
  242. package/lib/link/prompts.js +126 -0
  243. package/lib/link/renderLinkedAccountsTable.d.ts +2 -0
  244. package/lib/link/renderLinkedAccountsTable.js +14 -0
  245. package/lib/link/warnIfLinkedDirectory.d.ts +1 -0
  246. package/lib/link/warnIfLinkedDirectory.js +9 -0
  247. package/lib/links.js +6 -5
  248. package/lib/mcp/clients.d.ts +14 -0
  249. package/lib/mcp/clients.js +62 -0
  250. package/lib/mcp/promotion.d.ts +3 -0
  251. package/lib/mcp/promotion.js +109 -0
  252. package/lib/mcp/setup.d.ts +14 -3
  253. package/lib/mcp/setup.js +135 -55
  254. package/lib/mcp/skills.d.ts +8 -0
  255. package/lib/mcp/skills.js +64 -0
  256. package/lib/middleware/autoUpdateMiddleware.js +6 -3
  257. package/lib/middleware/commandTargetingUtils.js +1 -0
  258. package/lib/middleware/deprecationWarningMiddleware.d.ts +1 -0
  259. package/lib/middleware/deprecationWarningMiddleware.js +57 -0
  260. package/lib/npm/npmCli.d.ts +1 -0
  261. package/lib/npm/npmCli.js +13 -0
  262. package/lib/npm/packageJson.js +1 -1
  263. package/lib/process.d.ts +1 -1
  264. package/lib/process.js +10 -3
  265. package/lib/projects/ProjectLogsManager.js +7 -7
  266. package/lib/projects/add/legacyAddComponent.d.ts +2 -1
  267. package/lib/projects/add/legacyAddComponent.js +3 -0
  268. package/lib/projects/add/v2AddComponent.d.ts +2 -1
  269. package/lib/projects/add/v2AddComponent.js +7 -1
  270. package/lib/projects/archive.d.ts +8 -0
  271. package/lib/projects/archive.js +104 -0
  272. package/lib/projects/archiveDiff.d.ts +12 -0
  273. package/lib/projects/archiveDiff.js +68 -0
  274. package/lib/projects/builds.d.ts +2 -0
  275. package/lib/projects/builds.js +22 -0
  276. package/lib/projects/config.d.ts +6 -5
  277. package/lib/projects/config.js +8 -39
  278. package/lib/projects/create/index.js +2 -2
  279. package/lib/projects/create/legacy.js +2 -2
  280. package/lib/projects/create/tracking.d.ts +1 -0
  281. package/lib/projects/create/tracking.js +27 -0
  282. package/lib/projects/create/v2.js +4 -4
  283. package/lib/projects/delete.d.ts +13 -0
  284. package/lib/projects/delete.js +206 -0
  285. package/lib/projects/deploy.d.ts +1 -1
  286. package/lib/projects/deploy.js +2 -2
  287. package/lib/projects/download.d.ts +37 -0
  288. package/lib/projects/download.js +123 -0
  289. package/lib/projects/installApp.d.ts +58 -0
  290. package/lib/projects/installApp.js +283 -0
  291. package/lib/projects/localDev/AppDevModeInterface.d.ts +0 -3
  292. package/lib/projects/localDev/AppDevModeInterface.js +36 -58
  293. package/lib/projects/localDev/DevSessionManager.d.ts +8 -5
  294. package/lib/projects/localDev/DevSessionManager.js +35 -49
  295. package/lib/projects/localDev/LocalDevLogger.d.ts +4 -0
  296. package/lib/projects/localDev/LocalDevLogger.js +23 -5
  297. package/lib/projects/localDev/LocalDevProcess.d.ts +11 -1
  298. package/lib/projects/localDev/LocalDevProcess.js +104 -19
  299. package/lib/projects/localDev/LocalDevState.d.ts +9 -2
  300. package/lib/projects/localDev/LocalDevState.js +21 -1
  301. package/lib/projects/localDev/LocalDevWatcher.js +3 -2
  302. package/lib/projects/localDev/LocalDevWebsocketServer.d.ts +1 -0
  303. package/lib/projects/localDev/LocalDevWebsocketServer.js +24 -2
  304. package/lib/projects/localDev/UIExtensionsDevModeInterface.js +2 -0
  305. package/lib/projects/localDev/helpers/account.d.ts +1 -7
  306. package/lib/projects/localDev/helpers/account.js +8 -90
  307. package/lib/projects/localDev/helpers/process.d.ts +1 -1
  308. package/lib/projects/localDev/helpers/process.js +4 -10
  309. package/lib/projects/localDev/helpers/project.d.ts +8 -6
  310. package/lib/projects/localDev/helpers/project.js +82 -31
  311. package/lib/projects/localDev/localDevWebsocketServerUtils.d.ts +2 -1
  312. package/lib/projects/localDev/localDevWebsocketServerUtils.js +3 -0
  313. package/lib/projects/npmAuditOnUpload.d.ts +10 -0
  314. package/lib/projects/npmAuditOnUpload.js +73 -0
  315. package/lib/projects/pollProjectBuildAndDeploy.d.ts +5 -1
  316. package/lib/projects/pollProjectBuildAndDeploy.js +7 -6
  317. package/lib/projects/preview.d.ts +7 -0
  318. package/lib/projects/preview.js +48 -0
  319. package/lib/projects/projectInfo.d.ts +5 -0
  320. package/lib/projects/projectInfo.js +82 -0
  321. package/lib/projects/projectProfiles.d.ts +3 -3
  322. package/lib/projects/projectProfiles.js +13 -20
  323. package/lib/projects/release.d.ts +4 -0
  324. package/lib/projects/release.js +90 -0
  325. package/lib/projects/ui.d.ts +1 -0
  326. package/lib/projects/ui.js +17 -3
  327. package/lib/projects/uieLinting.d.ts +23 -3
  328. package/lib/projects/uieLinting.js +134 -28
  329. package/lib/projects/upload.d.ts +19 -3
  330. package/lib/projects/upload.js +84 -16
  331. package/lib/projects/urls.d.ts +0 -1
  332. package/lib/projects/urls.js +6 -13
  333. package/lib/projects/validate.d.ts +18 -0
  334. package/lib/projects/validate.js +142 -0
  335. package/lib/projects/validateLintConfigOnUpload.d.ts +9 -0
  336. package/lib/projects/validateLintConfigOnUpload.js +46 -0
  337. package/lib/projects/watch.js +4 -2
  338. package/lib/projects/workspaces.d.ts +60 -0
  339. package/lib/projects/workspaces.js +404 -0
  340. package/lib/prompts/createApiSamplePrompt.js +4 -0
  341. package/lib/prompts/importDataTestAccountSelectPrompt.js +1 -1
  342. package/lib/prompts/personalAccessKeyPrompt.d.ts +2 -5
  343. package/lib/prompts/personalAccessKeyPrompt.js +9 -7
  344. package/lib/prompts/projectDevTargetAccountPrompt.d.ts +1 -0
  345. package/lib/prompts/projectDevTargetAccountPrompt.js +13 -2
  346. package/lib/prompts/projectProfilePrompt.d.ts +9 -0
  347. package/lib/prompts/projectProfilePrompt.js +46 -0
  348. package/lib/prompts/projectsLogsPrompt.js +3 -0
  349. package/lib/prompts/promptUtils.js +4 -2
  350. package/lib/prompts/selectAppPrompt.js +1 -0
  351. package/lib/prompts/selectHubDBTablePrompt.js +2 -2
  352. package/lib/prompts/selectPublicAppForMigrationPrompt.js +5 -5
  353. package/lib/prompts/setAsDefaultAccountPrompt.js +2 -1
  354. package/lib/serverlessLogs.js +2 -2
  355. package/lib/serverlessSunset.d.ts +6 -0
  356. package/lib/serverlessSunset.js +32 -0
  357. package/lib/testUtils.d.ts +11 -1
  358. package/lib/testUtils.js +40 -2
  359. package/lib/theme/cmsDevServerProcess.d.ts +2 -0
  360. package/lib/theme/cmsDevServerProcess.js +8 -7
  361. package/lib/theme/migrate.js +1 -4
  362. package/lib/ui/SpinniesManager.d.ts +2 -0
  363. package/lib/ui/SpinniesManager.js +34 -10
  364. package/lib/ui/accountTable.d.ts +8 -0
  365. package/lib/ui/accountTable.js +67 -0
  366. package/lib/ui/appLogs.d.ts +32 -0
  367. package/lib/ui/appLogs.js +175 -0
  368. package/lib/ui/git.js +3 -3
  369. package/lib/ui/index.d.ts +8 -10
  370. package/lib/ui/index.js +46 -33
  371. package/lib/ui/spinniesUtils.d.ts +0 -1
  372. package/lib/ui/spinniesUtils.js +6 -16
  373. package/lib/ui/supportsColor.d.ts +4 -0
  374. package/lib/ui/supportsColor.js +25 -6
  375. package/lib/ui/uiMessages.d.ts +1 -0
  376. package/lib/ui/uiMessages.js +1 -0
  377. package/lib/usageTracking.d.ts +10 -20
  378. package/lib/usageTracking.js +77 -30
  379. package/lib/validation.js +16 -1
  380. package/lib/yargs/makeWrappedYargsHandler.d.ts +8 -0
  381. package/lib/yargs/makeWrappedYargsHandler.js +186 -0
  382. package/lib/yargs/makeYargsBuilder.d.ts +13 -0
  383. package/lib/yargs/makeYargsBuilder.js +33 -0
  384. package/lib/yargs/parseYargsOrExit.d.ts +4 -0
  385. package/lib/yargs/parseYargsOrExit.js +25 -0
  386. package/lib/yargs/strictEnforceBoolean.d.ts +1 -0
  387. package/lib/yargs/strictEnforceBoolean.js +13 -0
  388. package/lib/yargsUtils.d.ts +3 -16
  389. package/lib/yargsUtils.js +3 -48
  390. package/mcp-server/Tool.d.ts +26 -0
  391. package/mcp-server/Tool.js +86 -0
  392. package/mcp-server/server.js +80 -3
  393. package/mcp-server/skills/hubspot-fix-build/SKILL.md +61 -0
  394. package/mcp-server/skills/hubspot-new-app/SKILL.md +84 -0
  395. package/mcp-server/tools/cms/HsCreateModuleTool.d.ts +5 -3
  396. package/mcp-server/tools/cms/HsCreateModuleTool.js +21 -26
  397. package/mcp-server/tools/cms/HsCreateTemplateTool.d.ts +5 -3
  398. package/mcp-server/tools/cms/HsCreateTemplateTool.js +16 -16
  399. package/mcp-server/tools/cms/HsFunctionLogsTool.d.ts +6 -4
  400. package/mcp-server/tools/cms/HsFunctionLogsTool.js +75 -20
  401. package/mcp-server/tools/cms/HsListFunctionsTool.d.ts +5 -3
  402. package/mcp-server/tools/cms/HsListFunctionsTool.js +15 -14
  403. package/mcp-server/tools/cms/HsListTool.d.ts +5 -3
  404. package/mcp-server/tools/cms/HsListTool.js +14 -16
  405. package/mcp-server/tools/index.d.ts +3 -2
  406. package/mcp-server/tools/index.js +29 -23
  407. package/mcp-server/tools/project/AddFeatureToProjectTool.d.ts +8 -5
  408. package/mcp-server/tools/project/AddFeatureToProjectTool.js +38 -37
  409. package/mcp-server/tools/project/AuthAccountTool.d.ts +19 -0
  410. package/mcp-server/tools/project/AuthAccountTool.js +109 -0
  411. package/mcp-server/tools/project/CreateProjectTool.d.ts +8 -5
  412. package/mcp-server/tools/project/CreateProjectTool.js +33 -20
  413. package/mcp-server/tools/project/CreateTestAccountTool.d.ts +5 -3
  414. package/mcp-server/tools/project/CreateTestAccountTool.js +42 -31
  415. package/mcp-server/tools/project/DeployProjectTool.d.ts +6 -4
  416. package/mcp-server/tools/project/DeployProjectTool.js +44 -28
  417. package/mcp-server/tools/project/DocFetchTool.d.ts +8 -3
  418. package/mcp-server/tools/project/DocFetchTool.js +61 -18
  419. package/mcp-server/tools/project/DocsSearchTool.d.ts +12 -3
  420. package/mcp-server/tools/project/DocsSearchTool.js +52 -24
  421. package/mcp-server/tools/project/FindProjectsTool.d.ts +15 -0
  422. package/mcp-server/tools/project/FindProjectsTool.js +75 -0
  423. package/mcp-server/tools/project/GetApiUsagePatternsByAppIdTool.d.ts +8 -4
  424. package/mcp-server/tools/project/GetApiUsagePatternsByAppIdTool.js +50 -24
  425. package/mcp-server/tools/project/GetApplicationInfoTool.d.ts +7 -3
  426. package/mcp-server/tools/project/GetApplicationInfoTool.js +28 -29
  427. package/mcp-server/tools/project/GetBuildLogsTool.d.ts +7 -4
  428. package/mcp-server/tools/project/GetBuildLogsTool.js +27 -29
  429. package/mcp-server/tools/project/GetBuildStatusTool.d.ts +6 -3
  430. package/mcp-server/tools/project/GetBuildStatusTool.js +27 -29
  431. package/mcp-server/tools/project/GetConfigValuesTool.d.ts +7 -3
  432. package/mcp-server/tools/project/GetConfigValuesTool.js +25 -15
  433. package/mcp-server/tools/project/GuidedWalkthroughTool.d.ts +5 -3
  434. package/mcp-server/tools/project/GuidedWalkthroughTool.js +4 -6
  435. package/mcp-server/tools/project/KnowledgeSearchTool.d.ts +29 -0
  436. package/mcp-server/tools/project/KnowledgeSearchTool.js +79 -0
  437. package/mcp-server/tools/project/SubmitFeedbackTool.d.ts +25 -0
  438. package/mcp-server/tools/project/SubmitFeedbackTool.js +73 -0
  439. package/mcp-server/tools/project/UploadProjectTools.d.ts +6 -4
  440. package/mcp-server/tools/project/UploadProjectTools.js +63 -42
  441. package/mcp-server/tools/project/ValidateProjectTool.d.ts +5 -3
  442. package/mcp-server/tools/project/ValidateProjectTool.js +32 -13
  443. package/mcp-server/tools/project/apps.d.ts +8 -0
  444. package/mcp-server/tools/project/apps.js +7 -0
  445. package/mcp-server/tools/project/constants.d.ts +6 -2
  446. package/mcp-server/tools/project/constants.js +12 -1
  447. package/mcp-server/tools/project/productionConfirmation.d.ts +12 -0
  448. package/mcp-server/tools/project/productionConfirmation.js +45 -0
  449. package/mcp-server/tools/project/resolveAccount.d.ts +15 -0
  450. package/mcp-server/tools/project/resolveAccount.js +60 -0
  451. package/mcp-server/types.d.ts +3 -8
  452. package/mcp-server/types.js +1 -13
  453. package/mcp-server/utils/command.d.ts +26 -2
  454. package/mcp-server/utils/command.js +95 -16
  455. package/mcp-server/utils/config.js +6 -0
  456. package/mcp-server/utils/content.d.ts +3 -2
  457. package/mcp-server/utils/content.js +6 -1
  458. package/mcp-server/utils/elicitSelection.d.ts +11 -0
  459. package/mcp-server/utils/elicitSelection.js +25 -0
  460. package/mcp-server/utils/elicitation.d.ts +11 -0
  461. package/mcp-server/utils/elicitation.js +38 -0
  462. package/mcp-server/utils/errors.d.ts +1 -0
  463. package/mcp-server/utils/errors.js +9 -0
  464. package/mcp-server/utils/feedbackTracking.js +3 -1
  465. package/mcp-server/utils/json.d.ts +3 -0
  466. package/mcp-server/utils/json.js +29 -0
  467. package/mcp-server/utils/logger.d.ts +13 -0
  468. package/mcp-server/utils/logger.js +59 -0
  469. package/mcp-server/utils/toolUsageTracking.js +28 -11
  470. package/package.json +41 -32
  471. package/types/AccountTargets.d.ts +37 -0
  472. package/types/AccountTargets.js +12 -0
  473. package/types/Link.d.ts +32 -0
  474. package/types/Link.js +5 -0
  475. package/types/LocalDev.d.ts +15 -2
  476. package/types/PackageJson.d.ts +1 -0
  477. package/types/ProjectComponents.d.ts +2 -1
  478. package/types/Projects.d.ts +25 -5
  479. package/types/Prompts.d.ts +1 -0
  480. package/types/Yargs.d.ts +23 -2
  481. package/ui/components/ActionSection.d.ts +1 -1
  482. package/ui/components/InputField.d.ts +1 -1
  483. package/ui/components/SelectInput.d.ts +1 -1
  484. package/ui/components/StatusIcon.d.ts +1 -1
  485. package/ui/components/Table.d.ts +13 -13
  486. package/ui/components/getStarted/GetStartedFlow.d.ts +1 -1
  487. package/ui/components/getStarted/screens/InstallationScreen.d.ts +1 -1
  488. package/ui/components/getStarted/screens/ProjectSetupScreen.d.ts +1 -1
  489. package/ui/components/getStarted/screens/UploadScreen.d.ts +1 -1
  490. package/api/__tests__/migrate.test.d.ts +0 -1
  491. package/api/__tests__/migrate.test.js +0 -199
  492. package/commands/__tests__/account.test.d.ts +0 -1
  493. package/commands/__tests__/account.test.js +0 -69
  494. package/commands/__tests__/auth.test.d.ts +0 -1
  495. package/commands/__tests__/auth.test.js +0 -43
  496. package/commands/__tests__/cms.test.d.ts +0 -1
  497. package/commands/__tests__/cms.test.js +0 -87
  498. package/commands/__tests__/config.test.d.ts +0 -1
  499. package/commands/__tests__/config.test.js +0 -44
  500. package/commands/__tests__/customObject.test.d.ts +0 -1
  501. package/commands/__tests__/customObject.test.js +0 -68
  502. package/commands/__tests__/doctor.test.d.ts +0 -1
  503. package/commands/__tests__/doctor.test.js +0 -132
  504. package/commands/__tests__/feedback.test.d.ts +0 -1
  505. package/commands/__tests__/feedback.test.js +0 -24
  506. package/commands/__tests__/filemanager.test.d.ts +0 -1
  507. package/commands/__tests__/filemanager.test.js +0 -45
  508. package/commands/__tests__/getStarted.test.d.ts +0 -1
  509. package/commands/__tests__/getStarted.test.js +0 -173
  510. package/commands/__tests__/hubdb.test.d.ts +0 -1
  511. package/commands/__tests__/hubdb.test.js +0 -50
  512. package/commands/__tests__/init.test.d.ts +0 -1
  513. package/commands/__tests__/init.test.js +0 -42
  514. package/commands/__tests__/mcp.test.d.ts +0 -1
  515. package/commands/__tests__/mcp.test.js +0 -46
  516. package/commands/__tests__/open.test.d.ts +0 -1
  517. package/commands/__tests__/open.test.js +0 -58
  518. package/commands/__tests__/project.test.d.ts +0 -1
  519. package/commands/__tests__/project.test.js +0 -125
  520. package/commands/__tests__/sandbox.test.d.ts +0 -1
  521. package/commands/__tests__/sandbox.test.js +0 -44
  522. package/commands/__tests__/secret.test.d.ts +0 -1
  523. package/commands/__tests__/secret.test.js +0 -49
  524. package/commands/__tests__/testAccount.test.d.ts +0 -1
  525. package/commands/__tests__/testAccount.test.js +0 -57
  526. package/commands/__tests__/upgrade.test.d.ts +0 -1
  527. package/commands/__tests__/upgrade.test.js +0 -309
  528. package/commands/account/__tests__/auth.test.d.ts +0 -1
  529. package/commands/account/__tests__/auth.test.js +0 -206
  530. package/commands/account/__tests__/clean.test.d.ts +0 -1
  531. package/commands/account/__tests__/clean.test.js +0 -28
  532. package/commands/account/__tests__/createOverride.test.d.ts +0 -1
  533. package/commands/account/__tests__/createOverride.test.js +0 -32
  534. package/commands/account/__tests__/info.test.d.ts +0 -1
  535. package/commands/account/__tests__/info.test.js +0 -28
  536. package/commands/account/__tests__/list.test.d.ts +0 -1
  537. package/commands/account/__tests__/list.test.js +0 -153
  538. package/commands/account/__tests__/remove.test.d.ts +0 -1
  539. package/commands/account/__tests__/remove.test.js +0 -36
  540. package/commands/account/__tests__/removeOverride.d.ts +0 -1
  541. package/commands/account/__tests__/removeOverride.js +0 -25
  542. package/commands/account/__tests__/rename.test.d.ts +0 -1
  543. package/commands/account/__tests__/rename.test.js +0 -82
  544. package/commands/account/__tests__/use.test.d.ts +0 -1
  545. package/commands/account/__tests__/use.test.js +0 -170
  546. package/commands/app/__tests__/migrate.test.d.ts +0 -1
  547. package/commands/app/__tests__/migrate.test.js +0 -111
  548. package/commands/app/secret/__tests__/add.test.d.ts +0 -1
  549. package/commands/app/secret/__tests__/add.test.js +0 -140
  550. package/commands/app/secret/__tests__/delete.test.d.ts +0 -1
  551. package/commands/app/secret/__tests__/delete.test.js +0 -28
  552. package/commands/app/secret/__tests__/list.test.d.ts +0 -1
  553. package/commands/app/secret/__tests__/list.test.js +0 -25
  554. package/commands/app/secret/__tests__/update.test.d.ts +0 -1
  555. package/commands/app/secret/__tests__/update.test.js +0 -28
  556. package/commands/cms/__tests__/delete.test.d.ts +0 -1
  557. package/commands/cms/__tests__/delete.test.js +0 -39
  558. package/commands/cms/__tests__/fetch.test.d.ts +0 -1
  559. package/commands/cms/__tests__/fetch.test.js +0 -156
  560. package/commands/cms/__tests__/function.test.d.ts +0 -1
  561. package/commands/cms/__tests__/function.test.js +0 -50
  562. package/commands/cms/__tests__/lint.test.d.ts +0 -1
  563. package/commands/cms/__tests__/lint.test.js +0 -33
  564. package/commands/cms/__tests__/list.test.d.ts +0 -1
  565. package/commands/cms/__tests__/list.test.js +0 -42
  566. package/commands/cms/__tests__/module.test.d.ts +0 -1
  567. package/commands/cms/__tests__/module.test.js +0 -45
  568. package/commands/cms/__tests__/mv.test.d.ts +0 -1
  569. package/commands/cms/__tests__/mv.test.js +0 -46
  570. package/commands/cms/__tests__/theme.test.d.ts +0 -1
  571. package/commands/cms/__tests__/theme.test.js +0 -54
  572. package/commands/cms/__tests__/upload.test.d.ts +0 -1
  573. package/commands/cms/__tests__/upload.test.js +0 -312
  574. package/commands/cms/__tests__/watch.test.d.ts +0 -1
  575. package/commands/cms/__tests__/watch.test.js +0 -204
  576. package/commands/cms/function/__tests__/logs.test.d.ts +0 -1
  577. package/commands/cms/function/__tests__/logs.test.js +0 -70
  578. package/commands/cms/theme/__tests__/generate-selectors.test.d.ts +0 -1
  579. package/commands/cms/theme/__tests__/generate-selectors.test.js +0 -28
  580. package/commands/cms/theme/__tests__/marketplace-validate.test.d.ts +0 -1
  581. package/commands/cms/theme/__tests__/marketplace-validate.test.js +0 -36
  582. package/commands/cms/theme/__tests__/preview.test.d.ts +0 -1
  583. package/commands/cms/theme/__tests__/preview.test.js +0 -54
  584. package/commands/customObject/__tests__/create.test.d.ts +0 -1
  585. package/commands/customObject/__tests__/create.test.js +0 -40
  586. package/commands/customObject/__tests__/createSchema.test.d.ts +0 -1
  587. package/commands/customObject/__tests__/createSchema.test.js +0 -28
  588. package/commands/customObject/__tests__/deleteSchema.test.d.ts +0 -1
  589. package/commands/customObject/__tests__/deleteSchema.test.js +0 -42
  590. package/commands/customObject/__tests__/fetch-all-schemas.test.d.ts +0 -1
  591. package/commands/customObject/__tests__/fetch-all-schemas.test.js +0 -41
  592. package/commands/customObject/__tests__/fetchSchema.test.d.ts +0 -1
  593. package/commands/customObject/__tests__/fetchSchema.test.js +0 -45
  594. package/commands/customObject/__tests__/listSchemas.test.d.ts +0 -1
  595. package/commands/customObject/__tests__/listSchemas.test.js +0 -29
  596. package/commands/customObject/__tests__/updateSchema.test.d.ts +0 -1
  597. package/commands/customObject/__tests__/updateSchema.test.js +0 -40
  598. package/commands/filemanager/__tests__/fetch.test.d.ts +0 -1
  599. package/commands/filemanager/__tests__/fetch.test.js +0 -32
  600. package/commands/filemanager/__tests__/upload.test.d.ts +0 -1
  601. package/commands/filemanager/__tests__/upload.test.js +0 -191
  602. package/commands/hubdb/__tests__/clear.test.d.ts +0 -1
  603. package/commands/hubdb/__tests__/clear.test.js +0 -28
  604. package/commands/hubdb/__tests__/create.test.d.ts +0 -1
  605. package/commands/hubdb/__tests__/create.test.js +0 -28
  606. package/commands/hubdb/__tests__/delete.test.d.ts +0 -1
  607. package/commands/hubdb/__tests__/delete.test.js +0 -28
  608. package/commands/hubdb/__tests__/fetch.test.d.ts +0 -1
  609. package/commands/hubdb/__tests__/fetch.test.js +0 -28
  610. package/commands/hubdb/__tests__/list.test.d.ts +0 -1
  611. package/commands/hubdb/__tests__/list.test.js +0 -88
  612. package/commands/mcp/__tests__/setup.test.d.ts +0 -1
  613. package/commands/mcp/__tests__/setup.test.js +0 -26
  614. package/commands/mcp/__tests__/start.test.d.ts +0 -1
  615. package/commands/mcp/__tests__/start.test.js +0 -144
  616. package/commands/project/__tests__/add.test.d.ts +0 -1
  617. package/commands/project/__tests__/add.test.js +0 -107
  618. package/commands/project/__tests__/create.test.d.ts +0 -1
  619. package/commands/project/__tests__/create.test.js +0 -97
  620. package/commands/project/__tests__/deploy.test.d.ts +0 -1
  621. package/commands/project/__tests__/deploy.test.js +0 -307
  622. package/commands/project/__tests__/dev.test.d.ts +0 -1
  623. package/commands/project/__tests__/dev.test.js +0 -273
  624. package/commands/project/__tests__/devUnifiedFlow.test.d.ts +0 -1
  625. package/commands/project/__tests__/devUnifiedFlow.test.js +0 -434
  626. package/commands/project/__tests__/download.test.d.ts +0 -1
  627. package/commands/project/__tests__/download.test.js +0 -39
  628. package/commands/project/__tests__/installDeps.test.d.ts +0 -1
  629. package/commands/project/__tests__/installDeps.test.js +0 -140
  630. package/commands/project/__tests__/lint.test.d.ts +0 -1
  631. package/commands/project/__tests__/lint.test.js +0 -704
  632. package/commands/project/__tests__/list.test.d.ts +0 -1
  633. package/commands/project/__tests__/list.test.js +0 -31
  634. package/commands/project/__tests__/listBuilds.test.d.ts +0 -1
  635. package/commands/project/__tests__/listBuilds.test.js +0 -38
  636. package/commands/project/__tests__/logs.test.d.ts +0 -1
  637. package/commands/project/__tests__/logs.test.js +0 -202
  638. package/commands/project/__tests__/migrate.test.d.ts +0 -1
  639. package/commands/project/__tests__/migrate.test.js +0 -106
  640. package/commands/project/__tests__/open.test.d.ts +0 -1
  641. package/commands/project/__tests__/open.test.js +0 -39
  642. package/commands/project/__tests__/profile.test.d.ts +0 -1
  643. package/commands/project/__tests__/profile.test.js +0 -42
  644. package/commands/project/__tests__/updateDeps.test.d.ts +0 -1
  645. package/commands/project/__tests__/updateDeps.test.js +0 -140
  646. package/commands/project/__tests__/upload.test.d.ts +0 -1
  647. package/commands/project/__tests__/upload.test.js +0 -234
  648. package/commands/project/__tests__/validate.test.d.ts +0 -1
  649. package/commands/project/__tests__/validate.test.js +0 -381
  650. package/commands/project/__tests__/watch.test.d.ts +0 -1
  651. package/commands/project/__tests__/watch.test.js +0 -35
  652. package/commands/project/dev/deprecatedFlow.d.ts +0 -11
  653. package/commands/project/dev/deprecatedFlow.js +0 -135
  654. package/commands/sandbox/__tests__/create.test.d.ts +0 -1
  655. package/commands/sandbox/__tests__/create.test.js +0 -198
  656. package/commands/sandbox/__tests__/delete.test.d.ts +0 -1
  657. package/commands/sandbox/__tests__/delete.test.js +0 -31
  658. package/commands/secret/__tests__/addSecret.test.d.ts +0 -1
  659. package/commands/secret/__tests__/addSecret.test.js +0 -162
  660. package/commands/secret/__tests__/deleteSecret.test.d.ts +0 -1
  661. package/commands/secret/__tests__/deleteSecret.test.js +0 -41
  662. package/commands/secret/__tests__/listSecret.test.d.ts +0 -1
  663. package/commands/secret/__tests__/listSecret.test.js +0 -29
  664. package/commands/secret/__tests__/updateSecret.test.d.ts +0 -1
  665. package/commands/secret/__tests__/updateSecret.test.js +0 -29
  666. package/commands/testAccount/__tests__/create.test.d.ts +0 -1
  667. package/commands/testAccount/__tests__/create.test.js +0 -106
  668. package/commands/testAccount/__tests__/createConfig.test.d.ts +0 -1
  669. package/commands/testAccount/__tests__/createConfig.test.js +0 -32
  670. package/commands/testAccount/__tests__/delete.test.d.ts +0 -1
  671. package/commands/testAccount/__tests__/delete.test.js +0 -29
  672. package/commands/testAccount/__tests__/importData.test.d.ts +0 -1
  673. package/commands/testAccount/__tests__/importData.test.js +0 -92
  674. package/lib/__tests__/CLIWebSocketServer.test.d.ts +0 -1
  675. package/lib/__tests__/CLIWebSocketServer.test.js +0 -252
  676. package/lib/__tests__/accountAuth.test.d.ts +0 -1
  677. package/lib/__tests__/accountAuth.test.js +0 -258
  678. package/lib/__tests__/accountTypes.test.d.ts +0 -1
  679. package/lib/__tests__/accountTypes.test.js +0 -98
  680. package/lib/__tests__/buildAccount.test.d.ts +0 -1
  681. package/lib/__tests__/buildAccount.test.js +0 -211
  682. package/lib/__tests__/cliUpgradeUtils.test.d.ts +0 -1
  683. package/lib/__tests__/cliUpgradeUtils.test.js +0 -131
  684. package/lib/__tests__/commandSuggestion.test.d.ts +0 -1
  685. package/lib/__tests__/commandSuggestion.test.js +0 -121
  686. package/lib/__tests__/commonOpts.test.d.ts +0 -1
  687. package/lib/__tests__/commonOpts.test.js +0 -80
  688. package/lib/__tests__/dependencyManagement.test.d.ts +0 -1
  689. package/lib/__tests__/dependencyManagement.test.js +0 -1067
  690. package/lib/__tests__/developerTestAccounts.test.d.ts +0 -1
  691. package/lib/__tests__/developerTestAccounts.test.js +0 -156
  692. package/lib/__tests__/hasFeature.test.d.ts +0 -1
  693. package/lib/__tests__/hasFeature.test.js +0 -167
  694. package/lib/__tests__/http.test.d.ts +0 -1
  695. package/lib/__tests__/http.test.js +0 -40
  696. package/lib/__tests__/importData.test.d.ts +0 -1
  697. package/lib/__tests__/importData.test.js +0 -98
  698. package/lib/__tests__/npmCli.test.d.ts +0 -1
  699. package/lib/__tests__/npmCli.test.js +0 -84
  700. package/lib/__tests__/oauth.test.d.ts +0 -1
  701. package/lib/__tests__/oauth.test.js +0 -109
  702. package/lib/__tests__/parsing.test.d.ts +0 -1
  703. package/lib/__tests__/parsing.test.js +0 -34
  704. package/lib/__tests__/polling.test.d.ts +0 -1
  705. package/lib/__tests__/polling.test.js +0 -76
  706. package/lib/__tests__/process.test.d.ts +0 -1
  707. package/lib/__tests__/process.test.js +0 -89
  708. package/lib/__tests__/sandboxes.test.d.ts +0 -1
  709. package/lib/__tests__/sandboxes.test.js +0 -128
  710. package/lib/__tests__/serverlessLogs.test.d.ts +0 -1
  711. package/lib/__tests__/serverlessLogs.test.js +0 -163
  712. package/lib/__tests__/usageTracking.test.d.ts +0 -1
  713. package/lib/__tests__/usageTracking.test.js +0 -197
  714. package/lib/__tests__/validation.test.d.ts +0 -1
  715. package/lib/__tests__/validation.test.js +0 -143
  716. package/lib/__tests__/yargsUtils.test.d.ts +0 -1
  717. package/lib/__tests__/yargsUtils.test.js +0 -124
  718. package/lib/app/__tests__/migrate.test.d.ts +0 -1
  719. package/lib/app/__tests__/migrate.test.js +0 -638
  720. package/lib/doctor/__tests__/Diagnosis.test.d.ts +0 -1
  721. package/lib/doctor/__tests__/Diagnosis.test.js +0 -84
  722. package/lib/doctor/__tests__/DiagnosticInfoBuilder.test.d.ts +0 -1
  723. package/lib/doctor/__tests__/DiagnosticInfoBuilder.test.js +0 -177
  724. package/lib/doctor/__tests__/Doctor.test.d.ts +0 -1
  725. package/lib/doctor/__tests__/Doctor.test.js +0 -560
  726. package/lib/errorHandlers/__tests__/index.test.d.ts +0 -1
  727. package/lib/errorHandlers/__tests__/index.test.js +0 -278
  728. package/lib/mcp/__tests__/setup.test.d.ts +0 -1
  729. package/lib/mcp/__tests__/setup.test.js +0 -523
  730. package/lib/middleware/__tests__/commandTargetingUtils.test.d.ts +0 -1
  731. package/lib/middleware/__tests__/commandTargetingUtils.test.js +0 -99
  732. package/lib/middleware/__tests__/configMiddleware.test.d.ts +0 -1
  733. package/lib/middleware/__tests__/configMiddleware.test.js +0 -118
  734. package/lib/middleware/__tests__/gitMiddleware.test.d.ts +0 -1
  735. package/lib/middleware/__tests__/gitMiddleware.test.js +0 -43
  736. package/lib/middleware/__tests__/requestMiddleware.test.d.ts +0 -1
  737. package/lib/middleware/__tests__/requestMiddleware.test.js +0 -15
  738. package/lib/middleware/__tests__/usageTrackingMiddleware.test.d.ts +0 -1
  739. package/lib/middleware/__tests__/usageTrackingMiddleware.test.js +0 -44
  740. package/lib/middleware/__tests__/yargsChecksMiddleware.test.d.ts +0 -1
  741. package/lib/middleware/__tests__/yargsChecksMiddleware.test.js +0 -39
  742. package/lib/projects/__tests__/AppDevModeInterface.test.d.ts +0 -1
  743. package/lib/projects/__tests__/AppDevModeInterface.test.js +0 -541
  744. package/lib/projects/__tests__/DevServerManager.test.d.ts +0 -1
  745. package/lib/projects/__tests__/DevServerManager.test.js +0 -185
  746. package/lib/projects/__tests__/DevSessionManager.test.d.ts +0 -1
  747. package/lib/projects/__tests__/DevSessionManager.test.js +0 -250
  748. package/lib/projects/__tests__/LocalDevProcess.test.d.ts +0 -1
  749. package/lib/projects/__tests__/LocalDevProcess.test.js +0 -481
  750. package/lib/projects/__tests__/LocalDevWebsocketServer.test.d.ts +0 -1
  751. package/lib/projects/__tests__/LocalDevWebsocketServer.test.js +0 -231
  752. package/lib/projects/__tests__/ProjectLogsManager.test.d.ts +0 -1
  753. package/lib/projects/__tests__/ProjectLogsManager.test.js +0 -302
  754. package/lib/projects/__tests__/UIExtensionsDevModeInterface.test.d.ts +0 -1
  755. package/lib/projects/__tests__/UIExtensionsDevModeInterface.test.js +0 -160
  756. package/lib/projects/__tests__/components.test.d.ts +0 -1
  757. package/lib/projects/__tests__/components.test.js +0 -440
  758. package/lib/projects/__tests__/deploy.test.d.ts +0 -1
  759. package/lib/projects/__tests__/deploy.test.js +0 -231
  760. package/lib/projects/__tests__/localDevProjectHelpers.test.d.ts +0 -1
  761. package/lib/projects/__tests__/localDevProjectHelpers.test.js +0 -120
  762. package/lib/projects/__tests__/platformVersion.test.d.ts +0 -1
  763. package/lib/projects/__tests__/platformVersion.test.js +0 -63
  764. package/lib/projects/__tests__/pollProjectBuildAndDeploy.test.d.ts +0 -1
  765. package/lib/projects/__tests__/pollProjectBuildAndDeploy.test.js +0 -328
  766. package/lib/projects/__tests__/projectProfiles.test.d.ts +0 -1
  767. package/lib/projects/__tests__/projectProfiles.test.js +0 -441
  768. package/lib/projects/__tests__/projects.test.d.ts +0 -1
  769. package/lib/projects/__tests__/projects.test.js +0 -58
  770. package/lib/projects/__tests__/structure.test.d.ts +0 -1
  771. package/lib/projects/__tests__/structure.test.js +0 -210
  772. package/lib/projects/__tests__/uieLinting.test.d.ts +0 -1
  773. package/lib/projects/__tests__/uieLinting.test.js +0 -631
  774. package/lib/projects/__tests__/upload.test.d.ts +0 -1
  775. package/lib/projects/__tests__/upload.test.js +0 -183
  776. package/lib/projects/add/__tests__/legacyAddComponent.test.d.ts +0 -1
  777. package/lib/projects/add/__tests__/legacyAddComponent.test.js +0 -245
  778. package/lib/projects/add/__tests__/v2AddComponent.test.d.ts +0 -1
  779. package/lib/projects/add/__tests__/v2AddComponent.test.js +0 -343
  780. package/lib/projects/create/__tests__/legacy.test.d.ts +0 -1
  781. package/lib/projects/create/__tests__/legacy.test.js +0 -72
  782. package/lib/projects/create/__tests__/v2.test.d.ts +0 -1
  783. package/lib/projects/create/__tests__/v2.test.js +0 -257
  784. package/lib/projects/localDev/DevServerManager_DEPRECATED.d.ts +0 -40
  785. package/lib/projects/localDev/DevServerManager_DEPRECATED.js +0 -128
  786. package/lib/projects/localDev/LocalDevManager_DEPRECATED.d.ts +0 -59
  787. package/lib/projects/localDev/LocalDevManager_DEPRECATED.js +0 -387
  788. package/lib/projects/platformVersion.d.ts +0 -9
  789. package/lib/projects/platformVersion.js +0 -39
  790. package/lib/prompts/__tests__/createDeveloperTestAccountConfigPrompt.test.d.ts +0 -1
  791. package/lib/prompts/__tests__/createDeveloperTestAccountConfigPrompt.test.js +0 -157
  792. package/lib/prompts/__tests__/createFunctionPrompt.test.d.ts +0 -1
  793. package/lib/prompts/__tests__/createFunctionPrompt.test.js +0 -129
  794. package/lib/prompts/__tests__/createModulePrompt.test.d.ts +0 -1
  795. package/lib/prompts/__tests__/createModulePrompt.test.js +0 -187
  796. package/lib/prompts/__tests__/createTemplatePrompt.test.d.ts +0 -1
  797. package/lib/prompts/__tests__/createTemplatePrompt.test.js +0 -102
  798. package/lib/prompts/__tests__/downloadProjectPrompt.test.d.ts +0 -1
  799. package/lib/prompts/__tests__/downloadProjectPrompt.test.js +0 -31
  800. package/lib/prompts/__tests__/projectAddPrompt.test.d.ts +0 -1
  801. package/lib/prompts/__tests__/projectAddPrompt.test.js +0 -143
  802. package/lib/prompts/__tests__/projectsLogsPrompt.test.d.ts +0 -1
  803. package/lib/prompts/__tests__/projectsLogsPrompt.test.js +0 -37
  804. package/lib/prompts/__tests__/selectProjectTemplatePrompt.test.d.ts +0 -1
  805. package/lib/prompts/__tests__/selectProjectTemplatePrompt.test.js +0 -160
  806. package/lib/theme/__tests__/migrate.test.d.ts +0 -1
  807. package/lib/theme/__tests__/migrate.test.js +0 -247
  808. package/lib/ui/__tests__/SpinniesManager.test.d.ts +0 -1
  809. package/lib/ui/__tests__/SpinniesManager.test.js +0 -488
  810. package/lib/ui/__tests__/removeAnsiCodes.test.d.ts +0 -1
  811. package/lib/ui/__tests__/removeAnsiCodes.test.js +0 -84
  812. package/mcp-server/tools/cms/HsCreateFunctionTool.d.ts +0 -24
  813. package/mcp-server/tools/cms/HsCreateFunctionTool.js +0 -105
  814. package/mcp-server/tools/cms/__tests__/HsCreateFunctionTool.test.d.ts +0 -1
  815. package/mcp-server/tools/cms/__tests__/HsCreateFunctionTool.test.js +0 -254
  816. package/mcp-server/tools/cms/__tests__/HsCreateModuleTool.test.d.ts +0 -1
  817. package/mcp-server/tools/cms/__tests__/HsCreateModuleTool.test.js +0 -227
  818. package/mcp-server/tools/cms/__tests__/HsCreateTemplateTool.test.d.ts +0 -1
  819. package/mcp-server/tools/cms/__tests__/HsCreateTemplateTool.test.js +0 -208
  820. package/mcp-server/tools/cms/__tests__/HsFunctionLogsTool.test.d.ts +0 -1
  821. package/mcp-server/tools/cms/__tests__/HsFunctionLogsTool.test.js +0 -186
  822. package/mcp-server/tools/cms/__tests__/HsListFunctionsTool.test.d.ts +0 -1
  823. package/mcp-server/tools/cms/__tests__/HsListFunctionsTool.test.js +0 -124
  824. package/mcp-server/tools/cms/__tests__/HsListTool.test.d.ts +0 -1
  825. package/mcp-server/tools/cms/__tests__/HsListTool.test.js +0 -124
  826. package/mcp-server/tools/project/__tests__/AddFeatureToProjectTool.test.d.ts +0 -1
  827. package/mcp-server/tools/project/__tests__/AddFeatureToProjectTool.test.js +0 -157
  828. package/mcp-server/tools/project/__tests__/CreateProjectTool.test.d.ts +0 -1
  829. package/mcp-server/tools/project/__tests__/CreateProjectTool.test.js +0 -131
  830. package/mcp-server/tools/project/__tests__/CreateTestAccountTool.test.d.ts +0 -1
  831. package/mcp-server/tools/project/__tests__/CreateTestAccountTool.test.js +0 -461
  832. package/mcp-server/tools/project/__tests__/DeployProjectTool.test.d.ts +0 -1
  833. package/mcp-server/tools/project/__tests__/DeployProjectTool.test.js +0 -125
  834. package/mcp-server/tools/project/__tests__/DocFetchTool.test.d.ts +0 -1
  835. package/mcp-server/tools/project/__tests__/DocFetchTool.test.js +0 -125
  836. package/mcp-server/tools/project/__tests__/DocsSearchTool.test.d.ts +0 -1
  837. package/mcp-server/tools/project/__tests__/DocsSearchTool.test.js +0 -210
  838. package/mcp-server/tools/project/__tests__/GetApiUsagePatternsByAppIdTool.test.d.ts +0 -1
  839. package/mcp-server/tools/project/__tests__/GetApiUsagePatternsByAppIdTool.test.js +0 -146
  840. package/mcp-server/tools/project/__tests__/GetApplicationInfoTool.test.d.ts +0 -1
  841. package/mcp-server/tools/project/__tests__/GetApplicationInfoTool.test.js +0 -124
  842. package/mcp-server/tools/project/__tests__/GetBuildLogsTool.test.d.ts +0 -1
  843. package/mcp-server/tools/project/__tests__/GetBuildLogsTool.test.js +0 -307
  844. package/mcp-server/tools/project/__tests__/GetBuildStatusTool.test.d.ts +0 -1
  845. package/mcp-server/tools/project/__tests__/GetBuildStatusTool.test.js +0 -242
  846. package/mcp-server/tools/project/__tests__/GetConfigValuesTool.test.d.ts +0 -1
  847. package/mcp-server/tools/project/__tests__/GetConfigValuesTool.test.js +0 -209
  848. package/mcp-server/tools/project/__tests__/GuidedWalkthroughTool.test.d.ts +0 -1
  849. package/mcp-server/tools/project/__tests__/GuidedWalkthroughTool.test.js +0 -158
  850. package/mcp-server/tools/project/__tests__/UploadProjectTools.test.d.ts +0 -1
  851. package/mcp-server/tools/project/__tests__/UploadProjectTools.test.js +0 -187
  852. package/mcp-server/tools/project/__tests__/ValidateProjectTool.test.d.ts +0 -1
  853. package/mcp-server/tools/project/__tests__/ValidateProjectTool.test.js +0 -118
  854. package/mcp-server/utils/__tests__/command.test.d.ts +0 -1
  855. package/mcp-server/utils/__tests__/command.test.js +0 -275
  856. package/mcp-server/utils/__tests__/content.test.d.ts +0 -1
  857. package/mcp-server/utils/__tests__/content.test.js +0 -164
  858. package/mcp-server/utils/__tests__/feedbackTracking.test.d.ts +0 -1
  859. package/mcp-server/utils/__tests__/feedbackTracking.test.js +0 -69
package/lang/en.js CHANGED
@@ -1,12 +1,28 @@
1
1
  import chalk from 'chalk';
2
2
  import { mapToUserFriendlyName } from '@hubspot/project-parsing-lib/transform';
3
- import { PLATFORM_VERSIONS } from '@hubspot/local-dev-lib/constants/projects';
3
+ import { PLATFORM_VERSIONS } from '@hubspot/project-parsing-lib/constants';
4
4
  import { PERSONAL_ACCESS_KEY_AUTH_METHOD } from '@hubspot/local-dev-lib/constants/auth';
5
- import { ARCHIVED_HUBSPOT_CONFIG_YAML_FILE_NAME, GLOBAL_CONFIG_PATH, DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME, } from '@hubspot/local-dev-lib/constants/config';
6
- import { uiAccountDescription, uiBetaTag, uiCommandReference, uiLink, UI_COLORS, uiAuthCommandReference, } from '../lib/ui/index.js';
7
- import { getProjectDetailUrl, getProjectSettingsUrl, getLocalDevUiUrl, } from '../lib/projects/urls.js';
5
+ import { APP_AUTH_TYPES, APP_DISTRIBUTION_TYPES, CLI_SUPPORT_GUIDELINES_URL, FEEDBACK_SOURCE_ENV_VAR, LEGACY_PUBLIC_APP_FILE, LOCAL_DEV_DEFAULT_PORT, MAX_FEEDBACK_LENGTH, PROJECT_CONFIG_FILE, PROJECT_WITH_APP, SERVERLESS_SUNSET_CHANGELOG_URL, } from '../lib/constants.js';
6
+ import { ARCHIVED_HUBSPOT_CONFIG_YAML_FILE_NAME, DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME, GLOBAL_CONFIG_PATH, } from '@hubspot/local-dev-lib/constants/config';
7
+ import { indent, UI_COLORS, uiAccountDescription, uiAuthCommandReference, uiBetaTag, uiCommandReference, uiDeprecatedTag, uiLink, } from '../lib/ui/index.js';
8
+ import { getLocalDevUiUrl, getProjectDetailUrl, getProjectSettingsUrl, } from '../lib/projects/urls.js';
8
9
  import { getProductUpdatesUrl } from '../lib/links.js';
9
- import { APP_DISTRIBUTION_TYPES, APP_AUTH_TYPES, PROJECT_CONFIG_FILE, PROJECT_WITH_APP, LEGACY_PUBLIC_APP_FILE, } from '../lib/constants.js';
10
+ const AGENT_HELP_EXIT_CODES = '0 means success. 1 means an error. 2 means a warning, for example a validation issue or JSON output that does not match its schema.';
11
+ const MIGRATION_SUPPORT_CUTOFF_NOTICE = 'Automated platform version migrations beyond 2026.09 will not be supported.';
12
+ const SERVERLESS_SUNSET_NOTICE = 'CMS serverless functions are being sunset. Creating them has ended, editing ends on November 17, 2026, and existing functions stop running on February 1, 2027.';
13
+ const SERVERLESS_CREATION_BLOCKED_NOTICE = 'Serverless functions can no longer be created in the Design Manager. Build new serverless functions in Developer Projects instead.';
14
+ const SERVERLESS_CREATION_ENDED_NOTICE = 'Creating serverless functions has ended.';
15
+ const SERVERLESS_CHANGELOG_LINK_TEXT = 'Read more on the announcement and how to migrate your serverless functions to Developer Projects in the Developer Changelog.';
16
+ const LEGACY_CONFIG_REPLACEMENTS = [
17
+ ['hs account auth', 'Create the global config file and add accounts'],
18
+ ['hs account link', 'Link accounts to a project directory'],
19
+ ['hs config migrate', 'Migrate your existing config'],
20
+ ];
21
+ function getLegacyConfigDeprecationMessage(command) {
22
+ const columnWidth = Math.max(...LEGACY_CONFIG_REPLACEMENTS.map(([name]) => name.length)) + 3;
23
+ const replacements = LEGACY_CONFIG_REPLACEMENTS.map(([name, description]) => `${indent(1)}${uiCommandReference(name, false)}${' '.repeat(columnWidth - name.length)}${description}`);
24
+ return `${uiCommandReference(command)} is being replaced as we move to global config.\n\n${replacements.join('\n')}`;
25
+ }
10
26
  export const commands = {
11
27
  generalErrors: {
12
28
  srcIsProject: (src, command) => `"${src}" is in a project folder. Did you mean "hs project ${command}"?`,
@@ -123,9 +139,15 @@ export const commands = {
123
139
  options: {
124
140
  account: 'HubSpot account to authenticate',
125
141
  personalAccessKey: 'Enter existing personal access key',
142
+ default: 'Set the authenticated account as the default account',
143
+ name: 'Set a name for the account in the CLI config (cannot contain spaces)',
144
+ useDefaultName: 'Use the account name derived from the HubSpot portal name',
126
145
  },
127
146
  errors: {
128
147
  invalidAccountIdProvided: `--account must be a number.`,
148
+ accountNameContainsSpaces: (accountName, suggestedName) => suggestedName
149
+ ? `The account name "${accountName}" cannot contain spaces. Try ${uiCommandReference(`--name ${suggestedName}`)}.`
150
+ : `The account name "${accountName}" cannot contain spaces. Provide a name without spaces.`,
129
151
  failedToUpdateConfig: 'Failed to update the configuration file. Please try again.',
130
152
  migrationNotConfirmed: `Did not migrate your configuration file. Run ${uiAuthCommandReference()} to update your existing config, or use ${uiCommandReference('hs config migrate')} to switch to the new global configuration.`,
131
153
  mergeNotConfirmed: `Did not merge configuration files. When you are ready to merge the deprecated config file with the global config file, run ${uiCommandReference('hs config migrate')}.`,
@@ -137,8 +159,12 @@ export const commands = {
137
159
  },
138
160
  list: {
139
161
  accounts: `${chalk.bold('Accounts')}:`,
162
+ allAccounts: `${chalk.bold('All Accounts')}:`,
163
+ linkedAccounts: `${chalk.bold('Linked Accounts')}:`,
140
164
  defaultAccountTitle: `${chalk.bold('Default Account')}`,
165
+ linkedDefaultTitle: `${chalk.bold('Linked Default Account')}`,
141
166
  currentResolvedDefaultAccount: (accountId) => `Account: ${uiAccountDescription(accountId)}`,
167
+ directory: (dir) => `Directory: ${dir}`,
142
168
  describe: 'List names of accounts defined in config.',
143
169
  configPath: (configPath) => `Source: ${configPath}`,
144
170
  overrideFilePathTitle: `${chalk.bold('Default Account Override')}`,
@@ -185,6 +211,70 @@ export const commands = {
185
211
  success: {
186
212
  defaultAccountUpdated: (accountName) => `Default account updated to "${accountName}"`,
187
213
  },
214
+ linked: {
215
+ editingLinkedDefault: (dir) => `Editing the default linked account for this directory (not the global default):\n${indent(1)}${dir}`,
216
+ alreadyDefault: (accountId) => `${uiAccountDescription(accountId)} is the only linked account and is already the default.`,
217
+ setLinkedDefault: (account) => `Linked default set to ${chalk.cyan(account)}`,
218
+ accountNotLinked: (account) => `${account} is not linked to this directory.`,
219
+ promptToLink: (account) => `Would you like to link ${account} to this directory?`,
220
+ settingGlobalDefault: 'Setting global default instead.',
221
+ nonInteractiveNotLinked: (account) => `${account} is not linked to this directory. Setting global default instead.`,
222
+ },
223
+ },
224
+ link: {
225
+ describe: 'Link authenticated HubSpot accounts to the current directory',
226
+ verboseDescribe: `Link one or more authenticated HubSpot accounts to the current directory. Linked accounts are saved in a local ${chalk.bold('.hs/settings.json')} file (added to .gitignore automatically).\n\nThis lets the CLI know which account to use when you run commands from this directory, without changing the global default. Run ${uiCommandReference('hs account current')} to see the active configuration.`,
227
+ shared: {
228
+ noLinkedAccounts: 'No HubSpot accounts are linked in this directory.',
229
+ globalAccountsAvailable: (count) => `You have ${chalk.cyan(count.toString())} ${count === 1 ? 'account' : 'accounts'} in your global config.`,
230
+ configurePrompt: `To configure this directory, run:\n${indent(1)}${uiCommandReference('hs account link')}`,
231
+ deprecatedConfigNotSupported: (command) => `${uiCommandReference(command)} does not support deprecated config. Run ${uiCommandReference('hs config migrate')} to migrate to global config. Then re-run ${uiCommandReference(command)}`,
232
+ writeSettingsFailed: (path, err) => `Failed to write to ${path}: ${err}`,
233
+ savedToSettings: (path) => `Saved to ${path}`,
234
+ usingLinkedAccounts: (settingsPath) => `This directory has linked accounts via ${settingsPath}. Only linked accounts will be available for this command. To manage linked accounts, run ${uiCommandReference('hs account link')}.`,
235
+ accountAutoLinked: (accountId) => `Automatically linked ${uiAccountDescription(accountId)} to this directory.`,
236
+ accountAutoLinkFailed: (accountId) => `Could not automatically link ${uiAccountDescription(accountId)} to this directory. Run ${uiCommandReference('hs account link')} to link it manually.`,
237
+ },
238
+ linkingDirectory: (dir) => `Linking HubSpot account(s) for directory:\n${indent(1)}${dir}`,
239
+ managingLinkedAccounts: (dir) => `Managing linked accounts for:\n${indent(1)}${dir}`,
240
+ settingsInfo: (path) => `\u2139 Accounts linked here are saved in ${path}`,
241
+ success: {
242
+ created: (path) => `Linked to ${path} (created .hs and added to .gitignore).\n${indent(1)}Now when you work within this directory, the CLI will use the linked account(s).`,
243
+ },
244
+ errors: {
245
+ authFailed: `Authentication failed to complete`,
246
+ },
247
+ events: {
248
+ accountsLinked: (count) => `Linked ${count} account${count !== 1 ? 's' : ''}`,
249
+ accountsUnlinked: (count) => `Unlinked ${count} account${count !== 1 ? 's' : ''}`,
250
+ overrideAccountDetected: (accountId) => `\nCurrent default account (from .hsaccount):\n${indent(1)}${uiAccountDescription(accountId)}`,
251
+ defaultAccountSet: (accountId) => `Linked default account set to ${chalk.cyan(uiAccountDescription(accountId))}`,
252
+ defaultAccountRemoved: (isSelectionRequired) => `The linked default account was removed. ${isSelectionRequired ? 'A linked default account is required.\n' : ''}`,
253
+ defaultAccountRemains: (accountId) => `Linked default account remains ${chalk.cyan(uiAccountDescription(accountId))}`,
254
+ updatedLinkedAccounts: 'Updated linked accounts',
255
+ noAccountsLinked: `All accounts have been unlinked. Your global config accounts will be used.\n${indent(1)}The ${chalk.bold('.hs')} directory is no longer needed and can be safely deleted.`,
256
+ overrideFileRemoved: '.hsaccount file removed',
257
+ invalidDefaultAccount: (accountId) => `Default account ${uiAccountDescription(accountId)} is not in the linked accounts list and has been reset. Please select a new default.`,
258
+ },
259
+ prompts: {
260
+ howToProceed: 'How would you like to link an account?',
261
+ whatToDo: 'Which action would you like to perform?',
262
+ linkExisting: 'Link existing authenticated account(s)',
263
+ authenticateNew: 'Authenticate and link a new account',
264
+ cancel: 'Cancel',
265
+ selectDefault: 'Select a linked default account',
266
+ selectToLink: 'Select authenticated account(s) to link:',
267
+ selectToUnlink: 'Select account(s) to unlink',
268
+ alreadyLinked: '- Already linked',
269
+ fromHsAccount: '(from .hsaccount)',
270
+ newlyAuthenticated: '(just authenticated)',
271
+ mustSelectOne: 'You must select at least one account to link',
272
+ keepAsDefault: 'Keep this as the default?',
273
+ },
274
+ },
275
+ unlink: {
276
+ describe: 'Unlink HubSpot account(s) from the current directory',
277
+ verboseDescribe: `Remove one or more linked accounts from this directory's ${chalk.bold('.hs/settings.json')}. If the default account is removed, you will be prompted to select a new one.\n\nThis does not delete the account from the global config - it only removes the local association.`,
188
278
  },
189
279
  remove: {
190
280
  describe: 'Remove an account from the config.',
@@ -213,7 +303,10 @@ export const commands = {
213
303
  },
214
304
  },
215
305
  removeOverride: {
216
- describe: (overrideFile) => `Remove the default account override file (${overrideFile}) from the current working directory.`,
306
+ describe: (overrideFile) => uiDeprecatedTag(`Remove the default account override file (${overrideFile}) from the current working directory. Replaced by ${uiCommandReference('hs account unlink')}.`),
307
+ logs: {
308
+ deprecated: `${uiCommandReference('hs account remove-override')} is being replaced by ${uiCommandReference('hs account unlink')}.\nUse ${uiCommandReference('hs account unlink')} to unlink accounts from a project directory.`,
309
+ },
217
310
  accountOverride: (overrideFilePath, accountOverride) => `There is an account override file at ${overrideFilePath} associated with account "${accountOverride}".`,
218
311
  prompts: {
219
312
  deleteOverrideFile: 'Delete account override file?',
@@ -253,6 +346,9 @@ export const commands = {
253
346
  },
254
347
  name: (name) => `${chalk.bold('Account name')}: ${name}`,
255
348
  scopeGroups: `${chalk.bold('Scopes available')}:`,
349
+ linkedDefaultTitle: `${chalk.bold('Linked Default Account')}`,
350
+ settingsPath: (path) => `Source: ${path}`,
351
+ linkedDefault: (account) => `Account: ${account}`,
256
352
  },
257
353
  clean: {
258
354
  describe: 'Check for inactive accounts and removes them from the CLI config.',
@@ -273,7 +369,10 @@ export const commands = {
273
369
  defaultAccountOverride: (overrideFilePath) => `\n(This will also delete the default account override file at ${overrideFilePath})`,
274
370
  },
275
371
  createOverride: {
276
- describe: (hsAccountFileName) => `Create a new default account override file (${hsAccountFileName}) in the current working directory.`,
372
+ describe: (hsAccountFileName) => uiDeprecatedTag(`Create a new default account override file (${hsAccountFileName}) in the current working directory. Replaced by ${uiCommandReference('hs account link')}.`),
373
+ logs: {
374
+ deprecated: `${uiCommandReference('hs account create-override')} is being replaced by ${uiCommandReference('hs account link')}.\nUse ${uiCommandReference('hs account link')} to link accounts to a project directory.`,
375
+ },
277
376
  success: (overrideFilePath) => `Default account override file created at ${overrideFilePath}`,
278
377
  accountOverride: (overrideFilePath, accountOverride) => `An account override file already exists at ${overrideFilePath} associated with account "${accountOverride}".`,
279
378
  prompts: {
@@ -297,8 +396,11 @@ export const commands = {
297
396
  },
298
397
  },
299
398
  auth: {
300
- describe: 'Configure authentication for your HubSpot account.',
301
- verboseDescribe: (configName, authMethod) => `Configure authentication for a HubSpot account. This will update the ${configName} file that stores your account information.\n\nThe recommended authentication method is ${chalk.bold(authMethod)}, which uses an access token tied to a specific user account.`,
399
+ describe: uiDeprecatedTag(`Configure authentication for your HubSpot account. Replaced by ${uiCommandReference('hs account auth')}.`),
400
+ verboseDescribe: (configName, authMethod) => uiDeprecatedTag(`Configure authentication for a HubSpot account. This will update the ${configName} file that stores your account information.\n\nThe recommended authentication method is ${chalk.bold(authMethod)}, which uses an access token tied to a specific user account.\n\nThis command is deprecated because we are moving to global config, and the legacy config format will be replaced. Use ${uiCommandReference('hs account auth')} to create the global config file and add accounts to it, and ${uiCommandReference('hs account link')} to link accounts to a project directory. Run ${uiCommandReference('hs config migrate')} to migrate your existing config.`),
401
+ logs: {
402
+ deprecated: getLegacyConfigDeprecationMessage('hs auth'),
403
+ },
302
404
  errors: {
303
405
  invalidAccountIdProvided: `--account must be a number.`,
304
406
  globalConfigFileExists: (accountAuthCommand) => `You are using our new global configuration for account management, which is not compatible with this command. Please use ${uiCommandReference(accountAuthCommand)} instead.`,
@@ -391,15 +493,15 @@ export const commands = {
391
493
  },
392
494
  },
393
495
  webpack: {
394
- describe: 'Commands for managing webpack.',
496
+ describe: uiDeprecatedTag('Commands for managing webpack.'),
395
497
  subcommands: {
396
498
  create: {
397
- describe: 'Create a new webpack bundle.',
499
+ describe: uiDeprecatedTag(`Create a new webpack bundle. ${SERVERLESS_CREATION_ENDED_NOTICE}`),
398
500
  errors: {
399
501
  unusablePath: (path) => `The "${path}" is not a usable path to a directory.`,
400
502
  },
401
503
  positionals: {
402
- dest: 'Destination folder for the new webpack bundle.',
504
+ dest: uiDeprecatedTag('Destination folder for the new webpack bundle.'),
403
505
  },
404
506
  },
405
507
  },
@@ -714,26 +816,26 @@ export const commands = {
714
816
  },
715
817
  },
716
818
  function: {
717
- describe: 'Commands for managing CMS serverless functions.',
819
+ describe: uiDeprecatedTag(`Commands for managing CMS serverless functions. ${SERVERLESS_SUNSET_NOTICE}`),
718
820
  subcommands: {
719
821
  create: {
720
- describe: 'Create a new CMS serverless function.',
822
+ describe: uiDeprecatedTag(`Create a new CMS serverless function. ${SERVERLESS_CREATION_ENDED_NOTICE}`),
721
823
  errors: {
722
824
  unusablePath: (path) => `The "${path}" is not a usable path to a directory.`,
723
825
  },
724
826
  positionals: {
725
- name: 'Name of the function',
726
- dest: 'Destination folder for the function',
827
+ name: uiDeprecatedTag('Name of the function'),
828
+ dest: uiDeprecatedTag('Destination folder for the function'),
727
829
  },
728
830
  options: {
729
- functionsFolder: 'Folder to create functions in',
730
- filename: 'Filename for the function',
731
- endpointMethod: 'HTTP method for the function endpoint',
732
- endpointPath: 'API endpoint path for the function',
831
+ functionsFolder: uiDeprecatedTag('Folder to create functions in'),
832
+ filename: uiDeprecatedTag('Filename for the function'),
833
+ endpointMethod: uiDeprecatedTag('HTTP method for the function endpoint'),
834
+ endpointPath: uiDeprecatedTag('API endpoint path for the function'),
733
835
  },
734
836
  },
735
837
  logs: {
736
- describe: 'View logs for a CMS serverless function.',
838
+ describe: uiDeprecatedTag('View logs for a CMS serverless function.'),
737
839
  errors: {
738
840
  noLogsFound: (functionPath, accountId) => `No logs were found for the function path "${functionPath}" in account "${accountId}".`,
739
841
  },
@@ -746,21 +848,21 @@ export const commands = {
746
848
  gettingLogs: (latest, functionPath) => `Getting ${latest ? 'latest ' : ''}logs for function with path: ${functionPath}.`,
747
849
  options: {
748
850
  compact: {
749
- describe: 'output compact logs',
851
+ describe: uiDeprecatedTag('output compact logs'),
750
852
  },
751
853
  follow: {
752
- describe: 'follow logs',
854
+ describe: uiDeprecatedTag('follow logs'),
753
855
  },
754
856
  latest: {
755
- describe: 'retrieve most recent log only',
857
+ describe: uiDeprecatedTag('retrieve most recent log only'),
756
858
  },
757
859
  limit: {
758
- describe: 'limit the number of logs to output',
860
+ describe: uiDeprecatedTag('limit the number of logs to output'),
759
861
  },
760
862
  },
761
863
  positionals: {
762
864
  endpoint: {
763
- describe: 'Serverless function endpoint',
865
+ describe: uiDeprecatedTag('Serverless function endpoint'),
764
866
  },
765
867
  },
766
868
  tailLogs: (functionPath, accountId) => `Waiting for log entries for "${functionPath}" on account "${accountId}".\n`,
@@ -781,7 +883,7 @@ export const commands = {
781
883
  loadingFailed: (functionPath, account) => `Failed to build and deploy bundle for "${functionPath}" on ${account}`,
782
884
  positionals: {
783
885
  path: {
784
- describe: 'Path to the ".functions" folder',
886
+ describe: uiDeprecatedTag('Path to the ".functions" folder'),
785
887
  },
786
888
  },
787
889
  success: {
@@ -792,13 +894,13 @@ export const commands = {
792
894
  debug: {
793
895
  gettingFunctions: 'Getting currently deployed functions',
794
896
  },
795
- describe: 'List the currently deployed CMS serverless functions.',
897
+ describe: uiDeprecatedTag('List the currently deployed CMS serverless functions.'),
796
898
  info: {
797
899
  noFunctions: 'No functions found',
798
900
  },
799
901
  options: {
800
902
  json: {
801
- describe: 'output raw json data',
903
+ describe: uiDeprecatedTag('output raw json data'),
802
904
  },
803
905
  },
804
906
  },
@@ -811,21 +913,21 @@ export const commands = {
811
913
  },
812
914
  options: {
813
915
  contact: {
814
- describe: 'Pass contact data to the test function',
916
+ describe: uiDeprecatedTag('Pass contact data to the test function'),
815
917
  },
816
918
  logOutput: {
817
- describe: 'Output the response body from the serverless function execution (It is suggested not to use this in production environments as it can reveal any secure data returned by the function in logs)',
919
+ describe: uiDeprecatedTag('Output the response body from the serverless function execution (It is suggested not to use this in production environments as it can reveal any secure data returned by the function in logs)'),
818
920
  },
819
921
  port: {
820
- describe: 'Port to run the test server on',
922
+ describe: uiDeprecatedTag('Port to run the test server on'),
821
923
  },
822
924
  watch: {
823
- describe: 'Watch the specified .functions folder for changes and restart the server',
925
+ describe: uiDeprecatedTag('Watch the specified .functions folder for changes and restart the server'),
824
926
  },
825
927
  },
826
928
  positionals: {
827
929
  path: {
828
- describe: 'Path to local .functions folder',
930
+ describe: uiDeprecatedTag('Path to local .functions folder'),
829
931
  },
830
932
  },
831
933
  },
@@ -1221,8 +1323,8 @@ export const commands = {
1221
1323
  },
1222
1324
  },
1223
1325
  init: {
1224
- describe: 'Create a CLI config file and configure authentication for your HubSpot account.',
1225
- verboseDescribe: (configName, command, authMethod) => `Configure authentication for a HubSpot account. This will create a ${configName} file to store your account information. To configure authentication for additional accounts, run ${command}.\n\nThe recommended authentication method is ${chalk.bold(authMethod)}, which uses an access token tied to a specific user account.`,
1326
+ describe: uiDeprecatedTag(`Create a CLI config file and configure authentication for your HubSpot account. Replaced by ${uiCommandReference('hs account auth')}.`),
1327
+ verboseDescribe: (configName, command, authMethod) => uiDeprecatedTag(`Configure authentication for a HubSpot account. This will create a ${configName} file to store your account information. To configure authentication for additional accounts, run ${command}.\n\nThe recommended authentication method is ${chalk.bold(authMethod)}, which uses an access token tied to a specific user account.\n\nThis command is deprecated because we are moving to global config, and the legacy config format will be replaced. Use ${uiCommandReference('hs account auth')} to create the global config file and add accounts to it, and ${uiCommandReference('hs account link')} to link accounts to a project directory. Run ${uiCommandReference('hs config migrate')} to migrate your existing config.`),
1226
1328
  options: {
1227
1329
  authType: {
1228
1330
  describe: 'Authentication mechanism',
@@ -1240,6 +1342,7 @@ export const commands = {
1240
1342
  configFileUpdated: (authType, account) => `Connected account "${account}" using "${authType}" and set it as the default account`,
1241
1343
  },
1242
1344
  logs: {
1345
+ deprecated: getLegacyConfigDeprecationMessage('hs init'),
1243
1346
  updateConfig: `To update an existing config file, use the ${uiAuthCommandReference()} command.`,
1244
1347
  },
1245
1348
  errors: {
@@ -1251,22 +1354,34 @@ export const commands = {
1251
1354
  },
1252
1355
  mcp: {
1253
1356
  describe: 'Commands for managing HubSpot MCP servers.',
1357
+ promotion: {
1358
+ activeNudge: `${chalk.bold('Tip:')} Work faster with AI coding tools. Run ${uiCommandReference('hs mcp setup')} to connect HubSpot developer context to supported clients.`,
1359
+ },
1254
1360
  setup: {
1255
- describe: 'Setup the HubSpot development MCP servers.',
1361
+ describe: `Run ${uiCommandReference('hs mcp setup')} to connect the HubSpot Dev MCP and work faster with your AI coding tools.`,
1256
1362
  installingDocSearch: 'Adding the docs-search mcp server',
1257
1363
  codex: 'Codex CLI',
1258
1364
  claudeCode: 'Claude Code',
1259
1365
  cursor: 'Cursor',
1260
- gemini: 'Gemini CLI',
1261
- windsurf: 'Windsurf',
1366
+ devin: 'Devin',
1367
+ opencode: 'OpenCode',
1262
1368
  vsCode: 'VSCode',
1369
+ other: 'Other (manual setup)',
1263
1370
  args: {
1264
1371
  client: 'Target apps to configure',
1372
+ standalone: 'Use npx for all of the hs commands run by the MCP server. This allows you to use the MCP server without having the CLI globally installed.',
1373
+ cliVersion: 'Pin a specific CLI version for standalone mode',
1374
+ skills: 'HubSpot skills to install for the selected tools. Pass --skills with no names to skip skills.',
1265
1375
  docsSearch: 'Should the docs search mcp server be installed',
1266
1376
  },
1377
+ examples: {
1378
+ nonInteractive: 'Configure Claude Code without prompts',
1379
+ standalone: 'Configure Cursor in standalone mode with a pinned CLI version',
1380
+ },
1267
1381
  success: (derivedTargets) => `You can now use the HubSpot CLI MCP Server in ${derivedTargets.join(', ')}. ${chalk.bold('You may need to restart these tools to apply the changes')}.`,
1268
1382
  errors: {
1269
1383
  errorParsingJsonFIle: (filename, errorMessage) => `Unable to update ${chalk.bold(filename)} due to invalid JSON: ${errorMessage}`,
1384
+ cliVersionRequiresStandalone: '`--cli-version` requires `--standalone`. Pass `--standalone` to use a specific CLI version.',
1270
1385
  },
1271
1386
  spinners: {
1272
1387
  failedToConfigure: 'Failed to configure the HubSpot mcp server.',
@@ -1285,28 +1400,45 @@ export const commands = {
1285
1400
  cursorNotFound: 'Cursor is not installed. Install it and re-run hs mcp setup.',
1286
1401
  failedToConfigureCursor: 'Failed to configure Cursor',
1287
1402
  configuredCursor: 'Configured Cursor',
1288
- // Gemini
1289
- configuringGemini: 'Configuring Gemini CLI...',
1290
- configuredGemini: 'Configured Gemini CLI',
1291
- geminiNotFound: "Gemini CLI is not installed (missing 'gemini' command). Install it and re-run hs mcp setup.",
1292
- geminiInstallFailed: 'Failed to configure Gemini CLI',
1293
1403
  alreadyInstalled: 'HubSpot CLI mcp server already installed, reinstalling',
1294
- // Windsurf
1295
- configuringWindsurf: 'Configuring Windsurf...',
1296
- windsurfNotFound: 'Windsurf is not installed. Install it and re-run hs mcp setup.',
1297
- failedToConfigureWindsurf: 'Failed to configure Windsurf',
1298
- configuredWindsurf: 'Configured Windsurf',
1404
+ // Devin
1405
+ configuringDevin: 'Configuring Devin...',
1406
+ devinNotFound: 'Devin is not installed. Install it and re-run hs mcp setup.',
1407
+ failedToConfigureDevin: 'Failed to configure Devin',
1408
+ configuredDevin: 'Configured Devin',
1409
+ // OpenCode
1410
+ configuringOpenCode: 'Configuring OpenCode...',
1411
+ openCodeNotFound: "OpenCode is not installed (missing 'opencode' command). Install it and re-run hs mcp setup.",
1412
+ openCodeInstallFailed: 'Failed to configure OpenCode',
1413
+ configuredOpenCode: 'Configured OpenCode',
1299
1414
  // VS Code
1300
1415
  configuringVsCode: 'Configuring VSCode...',
1301
1416
  failedToConfigureVsCode: 'Failed to configure VSCode',
1302
1417
  configuredVsCode: 'Configured VSCode',
1303
1418
  vsCodeNotFound: "VSCode CLI is not installed (missing 'code' command). Install it and re-run hs mcp setup.",
1419
+ vsCodeVersionUnsupported: 'VSCode 1.99 or later is required for MCP server support. Please update VSCode and try again.',
1420
+ // Skills
1421
+ installingSkills: 'Installing HubSpot skills...',
1422
+ installedSkills: (skillNames, targetDirs) => `Installed ${skillNames.join(', ')} in ${targetDirs.join(', ')}`,
1423
+ failedToInstallSkills: 'Failed to install HubSpot skills',
1424
+ },
1425
+ otherInstructions: {
1426
+ header: 'To connect the HubSpot MCP server to another tool, add the following MCP server configuration.',
1427
+ docsNote: "Each tool handles MCP setup differently. Check your tool's documentation for how to add an MCP server using a command or JSON config.",
1428
+ commandLabel: 'Command:',
1429
+ jsonLabel: 'JSON configuration (for tools that use a config file):',
1430
+ skillsNote: (skillsDir) => `To add HubSpot skills, copy the folders in ${skillsDir} to your tool's skills folder.`,
1304
1431
  },
1305
1432
  prompts: {
1306
1433
  targets: '[--client] Which tools would you like to add the HubSpot CLI MCP server to?',
1307
1434
  targetsRequired: 'Must choose at least one app to configure.',
1308
1435
  standaloneMode: 'Do you want to run in standalone mode? (This will use npx @hubspot/cli instead of the installed hs command)',
1309
1436
  cliVersion: 'Specify a CLI version to pin (leave blank for latest):',
1437
+ selectSkills: '[--skills] Which HubSpot skills do you want to install? (optional)',
1438
+ },
1439
+ skillDescriptions: {
1440
+ newApp: 'Plan and create a HubSpot app project',
1441
+ fixBuild: 'Find and fix a failed project build',
1310
1442
  },
1311
1443
  },
1312
1444
  start: {
@@ -1320,6 +1452,30 @@ export const commands = {
1320
1452
  shuttingDown: 'Shutting down MCP server...',
1321
1453
  },
1322
1454
  },
1455
+ api: {
1456
+ describe: 'Make an authenticated HTTP request to any HubSpot API endpoint that supports PAKs.',
1457
+ verboseDescribe: `Make an authenticated HTTP request to any HubSpot API that supports PAKs using your CLI authentication.\n\nThis command is intended for testing and exploration of HubSpot APIs. It uses the authentication credentials configured in the CLI to make requests on your behalf.\n\nThe endpoint should be the API path, e.g. ${chalk.bold('/crm/v3/objects/contacts')}. The request will be authenticated using the account specified by ${uiCommandReference('--account')} or the default account.\n\nNote: The available endpoints depend on the scopes granted to your personal access key. If you receive a 403 error, check that your key includes the required scopes for the endpoint you are trying to reach. ${uiLink('Learn more about the HubSpot API', 'https://developers.hubspot.com/docs/api-reference/latest/overview')}`,
1458
+ positionals: {
1459
+ endpoint: {
1460
+ describe: 'API endpoint path (e.g. /crm/v3/objects/contacts)',
1461
+ },
1462
+ },
1463
+ options: {
1464
+ method: {
1465
+ describe: 'HTTP method to use. Defaults to GET, or POST if --data is provided',
1466
+ },
1467
+ data: {
1468
+ describe: 'JSON-formatted request body for POST, PUT, and PATCH requests',
1469
+ },
1470
+ },
1471
+ requestLog: (method, url) => `${chalk.bold(method)} ${url}`,
1472
+ requestBodyLog: (body) => `Request body: ${body}`,
1473
+ responseLog: 'Response:',
1474
+ errors: {
1475
+ invalidJson: 'The value passed to --data is not valid JSON. Please provide a valid JSON string.',
1476
+ statusLine: (status, statusText) => `${chalk.red(`${status} ${statusText}`)}`,
1477
+ },
1478
+ },
1323
1479
  open: {
1324
1480
  describe: 'Open a HubSpot page in your browser.',
1325
1481
  options: {
@@ -1343,6 +1499,7 @@ export const commands = {
1343
1499
  describe: 'Add a new project profile',
1344
1500
  verboseDescribe: `Add a new project profile\n\nProfiles enable you to reference variables in your component configuration files. Use the syntax ${chalk.bold('\${VARIABLE_NAME}')} to reference profile variables in your component configuration files. Then target the profile using the ${uiCommandReference('--profile')} flag when you upload your project.`,
1345
1501
  example: 'Add a new project profile named hsprofile.qa.json',
1502
+ exampleCopyFrom: 'Add a profile and copy variables from the staging profile',
1346
1503
  logs: {
1347
1504
  copyExistingProfile: (profileName) => `Found an existing profile. We can copy the variables from ${chalk.bold(profileName)} into your new profile.`,
1348
1505
  copyExistingProfiles: 'We can copy the variables from one of your existing profiles into your new profile.',
@@ -1360,11 +1517,12 @@ export const commands = {
1360
1517
  duplicateTargetAccount: (targetAccountId) => `The account ${uiAccountDescription(targetAccountId)} is being used in an existing profile. Make sure to edit your project's name between uploads if you do not want to overwrite the existing project in this account.`,
1361
1518
  },
1362
1519
  errors: {
1363
- noProjectConfig: 'No project config found. Please run this command from a project directory.',
1520
+ unsupportedPlatformVersion: 'This command is only available for projects 2025.2 and later.',
1364
1521
  profileExists: (profileName) => `Profile ${chalk.bold(profileName)} already exists. Please choose a different name.`,
1365
1522
  invalidTargetAccount: 'Target account is not configured in the CLI',
1366
1523
  noAccountsConfigured: 'No accounts configured in the CLI',
1367
1524
  failedToLoadProfile: (profileName) => `Unable to copy variables. Failed to load profile ${chalk.bold(profileName)}`,
1525
+ copyFromProfileNotFound: (profileName) => `Profile ${chalk.bold(profileName)} does not exist. Available profiles can be found in your project source directory.`,
1368
1526
  failedToCreateProfile: 'Failed to create profile',
1369
1527
  },
1370
1528
  positionals: {
@@ -1372,6 +1530,7 @@ export const commands = {
1372
1530
  },
1373
1531
  options: {
1374
1532
  targetAccount: 'The target account ID for this profile',
1533
+ copyFrom: 'Copy variables from an existing profile',
1375
1534
  },
1376
1535
  },
1377
1536
  delete: {
@@ -1390,7 +1549,7 @@ export const commands = {
1390
1549
  deleteProjectPrompt: (accountId) => `Would you like to delete this project from ${uiAccountDescription(accountId)}?`,
1391
1550
  },
1392
1551
  errors: {
1393
- noProjectConfig: 'No project config found. Please run this command from a project directory.',
1552
+ unsupportedPlatformVersion: 'This command is only available for projects 2025.2 and later.',
1394
1553
  noProfileFound: (profileName) => `No profile with filename ${chalk.bold(profileName)} found in your project.`,
1395
1554
  noProfilesFound: 'No profiles found in your project.',
1396
1555
  failedToDeleteProfile: (profileName) => `Unable to delete profile ${chalk.bold(profileName)}. Please try again.`,
@@ -1405,27 +1564,20 @@ export const commands = {
1405
1564
  describe: 'Start local dev for the current project.',
1406
1565
  logs: {
1407
1566
  header: 'HubSpot projects local development',
1408
- placeholderAccountSelection: 'Using default account as target account (for now)',
1409
- accountTypeInformation: 'Testing in a developer test account is strongly recommended, but you can use a sandbox account if your plan allows you to create one.',
1410
1567
  learnMoreMessageV2: `Learn more about ${uiLink('HubSpot projects local dev', 'https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands#start-a-local-development-server')} | ${uiLink('HubSpot account types', 'https://developers.hubspot.com/docs/getting-started/account-types')}`,
1411
- learnMoreMessageLegacy: uiLink('Learn more about the projects local dev server', 'https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands#start-a-local-development-server'),
1412
1568
  profileProjectAccountExplanation: (accountId, profileName) => `Using account ${uiAccountDescription(accountId)} from profile ${chalk.bold(profileName)} for project upload`,
1413
1569
  defaultProjectAccountExplanation: (accountId) => `Using default account ${uiAccountDescription(accountId)} for project upload`,
1414
1570
  projectAccountFlagExplanation: (accountId) => `Using account ${uiAccountDescription(accountId)} provided by the --project-account flag for project upload`,
1415
- accountFlagExplanation: (accountId) => `Using account ${uiAccountDescription(accountId)} provided by the --account flag for project upload`,
1416
1571
  defaultSandboxOrDevTestTestingAccountExplanation: (accountId) => `Using default account ${uiAccountDescription(accountId)} for testing`,
1417
1572
  testingAccountFlagExplanation: (accountId) => `Using account ${uiAccountDescription(accountId)} provided by the --testing-account flag for testing`,
1418
1573
  },
1419
1574
  errors: {
1420
- noProjectConfig: 'No project detected. Please run this command again from a project directory.',
1421
1575
  noAccount: (accountId) => `An error occurred while reading account ${uiAccountDescription(accountId)} from your config. Run ${uiAuthCommandReference()} to re-auth this account.`,
1422
- noAccountsInConfig: `No accounts found in your config. Run ${uiAuthCommandReference()} to configure a HubSpot account with the CLI.`,
1423
- invalidProjectComponents: 'Projects cannot contain both private and public apps. Move your apps to separate projects before attempting local development.',
1576
+ unsupportedPlatformVersion: (platformVersion) => `Local development is not supported for platform version ${chalk.bold(platformVersion)}. Please upgrade to 2025.2 or later.`,
1424
1577
  noRunnableComponents: `No supported components were found in this project. Run ${uiCommandReference('hs project add')} to see a list of available components and add one to your project.`,
1425
1578
  accountNotCombined: `\nLocal development of unified apps is currently only compatible with accounts that are opted into the unified apps beta. Make sure that this account is opted in or switch accounts using ${uiCommandReference('hs account use')}.`,
1426
- unsupportedAccountFlagLegacy: 'The --project-account and --testing-account flags are not supported for projects with platform versions earlier than 2025.2.',
1427
- unsupportedAccountFlagV2: 'The --account flag is is not supported supported for projects with platform versions 2025.2 and newer. Use --testing-account and --project-account flags to specify accounts to use for local dev',
1428
1579
  localDevAlreadyRunning: `Another ${uiCommandReference('hs project dev')} process is already running. To proceed with local development of this project, stop the existing process and re-run ${uiCommandReference('hs project dev')}.`,
1580
+ autoUploadRequiresAutoDeploy: `${uiCommandReference('hs project dev --auto-upload')} requires auto-deploy to be enabled for this project, since auto-upload deploys every change. Enable auto-deploy in your project settings, or run ${uiCommandReference('hs project dev')} without it.`,
1429
1581
  },
1430
1582
  examples: {
1431
1583
  default: 'Start local dev for the current project',
@@ -1435,9 +1587,10 @@ export const commands = {
1435
1587
  },
1436
1588
  options: {
1437
1589
  profile: 'The profile to target during local dev',
1438
- projectAccount: 'The id of the account to upload your project to. Must be used with --testing-account. Supported on platform versions 2025.2 and newer.',
1439
- testingAccount: 'The id of the account to install apps and test on. Must be used with --project-account. Supported on platform versions 2025.2 and newer.',
1440
- account: 'The id of the account to upload your project to. Unsupported on platform versions 2025.2 and newer.',
1590
+ projectAccount: 'The id of the account to upload your project to. Must be used with --testing-account.',
1591
+ testingAccount: 'The id of the account to install apps and test on. Must be used with --project-account.',
1592
+ port: `The port for the local dev server. Defaults to ${LOCAL_DEV_DEFAULT_PORT}.`,
1593
+ autoUpload: 'Automatically upload local changes to HubSpot as you edit files, instead of uploading manually from the Local Dev Panel.',
1441
1594
  },
1442
1595
  },
1443
1596
  create: {
@@ -1448,6 +1601,9 @@ export const commands = {
1448
1601
  failedToFetchProjectList: 'Failed to fetch the list of available project templates. Please try again later.',
1449
1602
  cannotNestProjects: (projectDir) => `A project already exists at ${projectDir}. Projects cannot be nested within other projects. Please choose a different destination and try again.`,
1450
1603
  },
1604
+ warnings: {
1605
+ betaPlatformVersion: (platformVersion) => `Your portal must be enrolled in the beta to use platform version ${platformVersion}. If you are not enrolled in the beta, your upload will fail. ${uiLink('Enroll in the beta', getProductUpdatesUrl('286886'))}`,
1606
+ },
1451
1607
  logs: {
1452
1608
  success: (projectName, projectDest) => `Project ${chalk.bold(projectName)} was successfully created in ${projectDest}`,
1453
1609
  },
@@ -1494,7 +1650,8 @@ export const commands = {
1494
1650
  },
1495
1651
  },
1496
1652
  migrateApp: {
1497
- describe: 'Migrate a public app to the projects framework.',
1653
+ describe: uiDeprecatedTag(`Migrate a public app to the projects framework. ${MIGRATION_SUPPORT_CUTOFF_NOTICE}`),
1654
+ verboseDescribe: uiDeprecatedTag(`Migrate a public app to the projects framework. This command walks you through the fields required to complete the migration and downloads the project source code into a directory of your choosing.\n\n${chalk.bold.yellow(MIGRATION_SUPPORT_CUTOFF_NOTICE)}`),
1498
1655
  examples: {
1499
1656
  default: 'Migrate a public app to the projects framework',
1500
1657
  },
@@ -1538,10 +1695,10 @@ export const commands = {
1538
1695
  },
1539
1696
  migrate: {
1540
1697
  preamble: (platformVersion) => `This command will migrate an existing project to platformVersion ${platformVersion}. It will walk you through the fields required to complete the migration and download the new project source code into the project source directory. It will also copy all of your existing files to a new directory (archive) in case you need access to your old files later.`,
1541
- describe: 'Migrate an existing project to the new version of the projects framework.',
1698
+ describe: uiDeprecatedTag(`Migrate an existing project to the new version of the projects framework. ${MIGRATION_SUPPORT_CUTOFF_NOTICE}`),
1699
+ verboseDescribe: uiDeprecatedTag(`Migrate an existing project to a newer platform version. This command walks you through the fields required to complete the migration and downloads the new project source code into the project source directory. Your existing files are copied to a new directory (archive) in case you need access to them later.\n\n${chalk.bold.yellow(MIGRATION_SUPPORT_CUTOFF_NOTICE)}`),
1542
1700
  errors: {
1543
1701
  noProjectConfig: (command) => `No project detected. Please run this command again from a project directory. If you are trying to migrate an app, run ${command}`,
1544
- 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))}`,
1545
1702
  },
1546
1703
  examples: {
1547
1704
  default: 'Migrate an existing project to the new version of the projects framework.',
@@ -1614,13 +1771,16 @@ export const commands = {
1614
1771
  deploy: {
1615
1772
  describe: 'Deploy a project build.',
1616
1773
  deployBuildIdPrompt: '[--build] Deploy which build?',
1774
+ profileMessage: (profileName, accountId) => `Deploying with ${chalk.bold(profileName)} profile: ${uiAccountDescription(accountId)}`,
1617
1775
  debug: {
1618
1776
  deploying: (path) => `Deploying project at path: ${path}`,
1619
1777
  },
1620
1778
  errors: {
1621
1779
  deploy: 'Deploy error: an unknown error occurred.',
1622
1780
  noBuilds: 'Deploy error: no builds for this project were found.',
1781
+ noSuccessfulBuilds: 'Deploy error: no successful builds for this project were found.',
1623
1782
  noBuildId: 'You must specify a build to deploy',
1783
+ notSupportedForBuildVersion: `This build's platform version does not support deploy. Run ${uiCommandReference('hs project release create')} to create a release instead.`,
1624
1784
  projectNotFound: (accountId, projectName) => `The project ${chalk.bold(projectName)} does not exist in account ${uiAccountDescription(accountId)}. Run ${uiCommandReference('hs project upload')} to upload your project files to HubSpot.`,
1625
1785
  buildIdDoesNotExist: (accountId, buildId, projectName) => `Build ${buildId} does not exist for project ${chalk.bold(projectName)}. Run ${uiCommandReference('hs project list-builds')} to view existing builds for this project.`,
1626
1786
  buildAlreadyDeployed: (accountId, buildId, projectName) => `Build ${buildId} is already deployed. ${uiLink('View project builds in HubSpot', getProjectDetailUrl(projectName, accountId))}`,
@@ -1631,7 +1791,7 @@ export const commands = {
1631
1791
  deployIssueComponentWarning: (uid, componentTypeName, message) => `- [${mapToUserFriendlyName(componentTypeName)}] ${chalk.bold('(' + uid + ')')} ${message}`,
1632
1792
  },
1633
1793
  examples: {
1634
- default: 'Deploy the latest build of the current project',
1794
+ default: 'Deploy the last successful build of the current project',
1635
1795
  withOptions: 'Deploy build 5 of the project my-project',
1636
1796
  withProfile: 'Deploy using the provided profile',
1637
1797
  },
@@ -1640,7 +1800,96 @@ export const commands = {
1640
1800
  project: 'Project name',
1641
1801
  profile: 'The profile to target with this deploy',
1642
1802
  force: 'Skip warnings and force deploy. Use this carefully as it will bypass warnings for destructive actions.',
1643
- deployLatestBuild: 'Deploy the latest build of the current project',
1803
+ deployLatestBuild: 'Deploy the last successful build of the current project',
1804
+ },
1805
+ },
1806
+ release: {
1807
+ describe: 'Manage project releases.',
1808
+ create: {
1809
+ describe: 'Create a release for a project build.',
1810
+ verboseDescribe: `Create a release for a project build\n\nReleases mark an uploaded build with an auto-generated semantic version tag (e.g. v1.0.0).\n\nBy default, the latest build is used. Use ${uiCommandReference('--build')} to specify a different build ID.`,
1811
+ confirmPrompt: (projectName, buildId) => `Create a release for project ${chalk.bold(projectName)} using build ${chalk.bold(String(buildId))}?`,
1812
+ success: (releaseTag, buildId) => `Release ${chalk.bold(releaseTag)} created for build ${chalk.bold(String(buildId))}.`,
1813
+ successNoTag: (buildId) => `Released build ${chalk.bold(String(buildId))}. Your project is now live.`,
1814
+ cancelled: 'Release creation cancelled.',
1815
+ buildIdPrompt: '[--build] Select a successful build to release:',
1816
+ noUploadMessage: 'No upload message',
1817
+ buildStatus: {
1818
+ BUILDING: 'Build in progress',
1819
+ FAILURE: 'Build failed',
1820
+ PENDING: 'Pending',
1821
+ PREPARING: 'Preparing',
1822
+ },
1823
+ uploadPrompt: (projectName) => `No successful builds for project ${chalk.bold(projectName)}. Would you like to upload it?`,
1824
+ errors: {
1825
+ projectNotFound: (accountId, projectName) => `The project ${chalk.bold(projectName)} does not exist in account ${uiAccountDescription(accountId)}. Run ${uiCommandReference('hs project upload')} to upload your project files to HubSpot.`,
1826
+ buildNotFound: (buildId, projectName) => `Build ${chalk.bold(String(buildId))} was not found for project ${chalk.bold(projectName)}. Run ${uiCommandReference('hs project list-builds')} to view existing builds or ${uiCommandReference('hs project upload')} to upload a build first.`,
1827
+ noSuccessfulBuilds: (projectName) => `No successful builds found for project ${chalk.bold(projectName)}. Run ${uiCommandReference('hs project upload')} to create a new build.`,
1828
+ incompatibleBuildVersion: `This build's platform version does not support releases. Upgrade your project to a newer platform version to use releases.`,
1829
+ },
1830
+ options: {
1831
+ build: 'Build ID to release. Defaults to the latest build.',
1832
+ force: 'Skip all confirmation prompts, including automatic upload when no build exists.',
1833
+ },
1834
+ examples: {
1835
+ default: 'Create a release for the latest build',
1836
+ withBuild: 'Create a release for a specific build',
1837
+ },
1838
+ },
1839
+ list: {
1840
+ describe: 'List releases for the current project.',
1841
+ verboseDescribe: `List releases for the current project\n\nDisplays all releases in sorted order, newest first. Includes the version tag, build ID, and creation date. Use ${uiCommandReference('--limit')} to control how many results are shown.`,
1842
+ noReleases: 'No releases found for this project.',
1843
+ showingReleases: (count, projectName) => `Showing ${count} release${count === 1 ? '' : 's'} for ${chalk.bold(projectName)}:`,
1844
+ continueOrExitPrompt: 'Press <enter> to load more, or ctrl+c to exit',
1845
+ errors: {
1846
+ projectNotFound: (accountId, projectName) => `The project ${chalk.bold(projectName)} does not exist in account ${uiAccountDescription(accountId)}. Run ${uiCommandReference('hs project upload')} to upload your project files to HubSpot.`,
1847
+ },
1848
+ options: {
1849
+ limit: 'Number of releases to show',
1850
+ },
1851
+ examples: {
1852
+ default: 'List releases for the current project',
1853
+ withLimit: 'Show only the 5 most recent releases',
1854
+ },
1855
+ },
1856
+ info: {
1857
+ describe: 'Show details about a specific release.',
1858
+ verboseDescribe: `Show details about a specific release\n\nDisplays the release tag, build ID, creation date, and list of components included in the release. Use ${uiCommandReference('--json')} for machine-readable output.`,
1859
+ releaseDetails: (releaseTag, projectName) => `Release ${chalk.bold(releaseTag)} for ${chalk.bold(projectName)}:`,
1860
+ components: 'Components:',
1861
+ noComponents: 'No components found for this release.',
1862
+ moreReleasesHint: `Not all releases are shown. Use ${uiCommandReference('--tag')} to look up an older release directly.`,
1863
+ selectRelease: (projectName) => `Select a release for ${chalk.bold(projectName)}`,
1864
+ errors: {
1865
+ releaseNotFound: (releaseTag, projectName) => `Release ${chalk.bold(releaseTag)} was not found for project ${chalk.bold(projectName)}. Verify the project has been uploaded and the release tag exists. Run ${uiCommandReference('hs project release list')} to view existing releases.`,
1866
+ noReleases: 'No releases found for this project.',
1867
+ },
1868
+ options: {
1869
+ tag: 'Release tag to look up (e.g. v1.0.0)',
1870
+ },
1871
+ examples: {
1872
+ default: 'Show details about a specific release',
1873
+ json: 'Output release details as JSON',
1874
+ },
1875
+ },
1876
+ preview: {
1877
+ describe: 'Build and preview a project on a target portal.',
1878
+ verboseDescribe: `Build and preview a project on a target portal\n\nUploads the current project (unless ${uiCommandReference('--build')} is passed), then deploys that build to the target portal so you can try it before releasing it. Use ${uiCommandReference('--target')} to choose the portal.`,
1879
+ uploadPrompt: (projectName) => `No successful builds for project ${chalk.bold(projectName)}. Would you like to upload it?`,
1880
+ errors: {
1881
+ targetRequired: `${uiCommandReference('--target=<portalId>')} is required to specify the portal to preview on.`,
1882
+ previewFailed: 'The preview failed. You can try again or preview this build from the project UI.',
1883
+ },
1884
+ options: {
1885
+ build: 'Build ID to preview. Defaults to the latest build.',
1886
+ target: 'Portal ID to preview the build on.',
1887
+ force: 'Skip all confirmation prompts, including automatic upload when no build exists.',
1888
+ },
1889
+ examples: {
1890
+ default: 'Build and preview the current project on a target portal',
1891
+ withBuild: 'Preview a specific build on a target portal',
1892
+ },
1644
1893
  },
1645
1894
  },
1646
1895
  listBuilds: {
@@ -1663,6 +1912,8 @@ export const commands = {
1663
1912
  },
1664
1913
  examples: {
1665
1914
  default: 'List the builds for the current project',
1915
+ withLimit: 'List the five most recent builds for the current project',
1916
+ json: 'Output the builds for the current project as JSON',
1666
1917
  },
1667
1918
  },
1668
1919
  logs: {
@@ -1673,6 +1924,7 @@ export const commands = {
1673
1924
  noFunctionsLinkText: 'Visit developer docs',
1674
1925
  noFunctionsInProject: `There aren't any functions in this project\n\t- Run ${uiCommandReference('hs project logs --help')} to learn more about logs\n\t- ${uiLink('Visit developer docs', 'https://developers.hubspot.com/docs/platform/serverless-functions')} to learn more about serverless functions`,
1675
1926
  noFunctionWithName: (name) => `No function with name "${name}"`,
1927
+ functionNameRequired: `A function name is required. Pass ${uiCommandReference('--function=<name>')} or run without it to select one interactively.`,
1676
1928
  functionNotDeployed: (name) => `The function with name "${name}" is not deployed`,
1677
1929
  projectLogsManagerNotInitialized: 'Function called on ProjectLogsManager before initialization',
1678
1930
  noDeployedBuild: 'This project has not been deployed yet. Deploy the project first, then try again.',
@@ -1718,19 +1970,31 @@ export const commands = {
1718
1970
  examples: {
1719
1971
  default: 'Upload a project into your HubSpot account',
1720
1972
  withProfile: 'Upload a project into your HubSpot account when using profiles',
1973
+ withPreview: 'Upload and preview the build on a target portal',
1721
1974
  },
1722
1975
  logs: {
1976
+ forceCreateDeprecated: `The ${uiCommandReference('--force-create')} flag is deprecated. Use ${uiCommandReference('--force')} instead.`,
1723
1977
  buildSucceeded: (buildId) => `Build #${buildId} succeeded\n`,
1724
1978
  readyToGoLive: '🚀 Ready to take your project live?',
1725
1979
  runCommand: (command) => `Run \`${uiCommandReference(command)}\``,
1726
1980
  autoDeployDisabled: (deployCommand) => `Automatic deploys are disabled for this project. Run ${uiCommandReference(deployCommand)} to deploy this build.`,
1981
+ autoDeploySkipped: (deployCommand) => `Auto-deploy was skipped for this build. Run ${uiCommandReference(deployCommand)} to deploy this build.`,
1982
+ releaseManagementRequired: (releaseCommand) => `This build is not live yet. Run ${uiCommandReference(releaseCommand)} to release it. Apps then go live when you roll the release out in the projects UI.`,
1983
+ uploadingWithProfile: (profileName, accountId) => `Initializing project upload with ${chalk.bold(profileName)} profile: ${uiAccountDescription(accountId)}`,
1984
+ uploadingToAccount: (accountId) => `Initializing project upload to account ${uiAccountDescription(accountId)}`,
1985
+ uploadedToAccount: (accountId) => `Project uploaded to ${uiAccountDescription(accountId)}`,
1727
1986
  },
1728
1987
  errors: {
1729
1988
  projectLockedError: `Your project is locked. This may mean that another user is running the ${uiCommandReference('hs project dev')} command for this project. If this is you, unlock the project in Projects UI.`,
1989
+ previewRequiresTarget: `${uiCommandReference('--preview')} requires ${uiCommandReference('--target=<portalId>')} to specify the portal to preview on.`,
1990
+ targetRequiresPreview: `${uiCommandReference('--target')} can only be used with ${uiCommandReference('--preview')}.`,
1730
1991
  },
1731
1992
  options: {
1993
+ force: {
1994
+ describe: 'Skip confirmation prompts and force the upload.',
1995
+ },
1732
1996
  forceCreate: {
1733
- describe: 'Automatically create project if it does not exist',
1997
+ describe: uiDeprecatedTag(`Automatically create project if it does not exist. Use ${uiCommandReference('--force')} instead.`),
1734
1998
  },
1735
1999
  message: {
1736
2000
  describe: 'Add a message when you upload your project and create a build',
@@ -1738,6 +2002,18 @@ export const commands = {
1738
2002
  profile: {
1739
2003
  describe: 'Profile to target for this upload',
1740
2004
  },
2005
+ skipNpmAudit: {
2006
+ describe: 'Skip the npm audit security check before uploading',
2007
+ },
2008
+ skipAutoDeploy: {
2009
+ describe: 'Skip automatic deployment after a successful build',
2010
+ },
2011
+ preview: {
2012
+ describe: 'Preview the build on a target portal after a successful upload',
2013
+ },
2014
+ target: {
2015
+ describe: 'Portal ID to preview the build on',
2016
+ },
1741
2017
  },
1742
2018
  },
1743
2019
  watch: {
@@ -1770,7 +2046,6 @@ export const commands = {
1770
2046
  fileAlreadyQueued: (filePath) => `File "${filePath}" is already queued for upload`,
1771
2047
  },
1772
2048
  errors: {
1773
- projectConfigNotFound: 'No project config found. Please ensure that you are in a project directory.',
1774
2049
  projectLockedError: `Your project is locked. This may mean that another user is running the ${chalk.bold(`hs project dev`)} command for this project. If this is you, unlock the project in Projects UI.`,
1775
2050
  uploadFailed: (remotePath, filePath) => `Failed to upload file "${filePath}" to "${remotePath}"`,
1776
2051
  deleteFileFailed: (remotePath) => `Failed to delete file "${remotePath}"`,
@@ -1782,25 +2057,54 @@ export const commands = {
1782
2057
  describe: 'Download your project files from HubSpot.',
1783
2058
  examples: {
1784
2059
  default: 'Download the project myProject into myProjectFolder folder',
2060
+ currentProject: 'Download build 3 of the current project into the current project directory',
2061
+ json: 'Output the download result as JSON for scripting',
1785
2062
  },
1786
2063
  logs: {
1787
2064
  downloadCancelled: 'Cancelling project download',
1788
2065
  downloadSucceeded: (buildId, projectName) => `Downloaded build "${buildId}" from project "${projectName}"`,
2066
+ filesOnlyInArchive: (files, hiddenCount, diffFilePath) => [
2067
+ 'These files existed locally but are not in the downloaded build. They are available in the archive directory:',
2068
+ ...files.map(file => `${indent(2)}- ${file}`),
2069
+ ...(hiddenCount > 0
2070
+ ? [`${indent(2)}...and ${hiddenCount} more`]
2071
+ : []),
2072
+ ...(hiddenCount > 0 && diffFilePath
2073
+ ? [`\nThe full list can be viewed in ${chalk.bold(diffFilePath)}`]
2074
+ : []),
2075
+ ].join('\n'),
2076
+ filesCopiedBack: (copiedCount, srcPath) => `Copied ${copiedCount} ${copiedCount === 1 ? 'file' : 'files'} back to ${chalk.bold(srcPath)}`,
2077
+ sourceContentsArchived: (archiveLocation) => `The previous contents of your project have been moved to ${archiveLocation}. Once you have reviewed them, you can safely delete that directory.`,
1789
2078
  },
1790
2079
  errors: {
1791
2080
  downloadFailed: 'Something went wrong downloading the project',
1792
2081
  projectNotFound: (projectName, accountId) => `Your project ${chalk.bold(projectName)} could not be found in ${accountId}`,
1793
2082
  noBuildIdToDownload: 'No build ID available for download',
2083
+ restoreFailed: (archiveDest) => `Extracting the downloaded build failed, and your original project files could not be restored automatically. They are in ${chalk.bold(archiveDest)}.`,
2084
+ archiveAlreadyExists: (archiveDest) => `Cannot download into the current project because ${chalk.bold(archiveDest)} already exists. Delete or rename it and run the command again.`,
1794
2085
  },
1795
2086
  warnings: {
1796
- cannotDownloadWithinProject: 'Cancelling project download. Please run the command again outside the context of an existing project.',
2087
+ filesNotCopiedBack: (failedCount) => `${failedCount} ${failedCount === 1 ? 'file' : 'files'} could not be copied back. ${failedCount === 1 ? 'It is' : 'They are'} still available in the archive directory.`,
2088
+ sourceWillBeArchived: (archiveLocation) => `Your current project source files will be moved to ${archiveLocation}.\nBack up any local changes in this project before you continue.`,
2089
+ sourceRestored: 'Extracting the downloaded build failed. Your original project files have been restored. The archive directory was left in place and can be deleted.',
2090
+ },
2091
+ archiveLocation: (archivePath) => `the archive directory in your project root (${chalk.bold(archivePath)})`,
2092
+ prompts: {
2093
+ confirmCopyFilesBack: (fileCount) => `[--keep-local-files] Copy ${fileCount === 1 ? 'this file' : `these ${fileCount} files`} back into your project source directory?`,
2094
+ confirmDownload: (buildId, projectName) => `[--force] Download build "${buildId}" of project "${projectName}"?`,
1797
2095
  },
1798
2096
  options: {
1799
2097
  build: {
1800
- describe: 'The build to download',
2098
+ describe: 'The build to download (defaults to the latest build)',
2099
+ },
2100
+ force: {
2101
+ describe: 'Skip the confirmation prompt before archiving your source',
2102
+ },
2103
+ keepLocalFiles: {
2104
+ describe: 'Copy local files missing from the build back into the source directory without prompting (--no-keep-local-files skips)',
1801
2105
  },
1802
2106
  project: {
1803
- describe: 'The name of the project to download',
2107
+ describe: 'The name of the project to download (defaults to the current project)',
1804
2108
  },
1805
2109
  dest: {
1806
2110
  describe: 'Destination folder for the project',
@@ -1821,9 +2125,33 @@ export const commands = {
1821
2125
  },
1822
2126
  feedback: {
1823
2127
  describe: 'Leave feedback or file a bug report.',
2128
+ verboseDescribe: `Leave feedback or file a bug report.\n\nPass ${uiCommandReference('--message')} to send feedback from the terminal. Run ${uiCommandReference('hs feedback')} without it to open the feedback form in your browser instead.\n\nThe feedback includes your account ID, your user ID, and the CLI version.`,
2129
+ options: {
2130
+ message: {
2131
+ describe: 'Feedback to send. If omitted, opens the feedback form in your browser.',
2132
+ },
2133
+ source: {
2134
+ describe: `Who is sending the feedback. Required with ${uiCommandReference('--message')} unless the ${FEEDBACK_SOURCE_ENV_VAR} environment variable is set.`,
2135
+ },
2136
+ },
2137
+ examples: {
2138
+ openForm: 'Open the feedback form in your browser',
2139
+ submit: 'Send feedback from the terminal',
2140
+ submitAsAgent: 'Send feedback on behalf of an AI agent',
2141
+ },
1824
2142
  openPrompt: 'Open the feedback form in your browser?',
1825
2143
  success: (url) => `We opened ${uiLink('the developer feedback form', url)} in your browser.`,
1826
2144
  error: (url) => `Navigate to ${uiLink('the developer feedback form', url)} to leave feedback.`,
2145
+ nonInteractive: (url) => `To send feedback from the terminal, run ${uiCommandReference('hs feedback --message "<message>" --source <user|agent>')}. To use the browser instead, navigate to ${uiLink('the developer feedback form', url)}.`,
2146
+ submitSuccess: 'Your feedback has been successfully submitted. Thank you.',
2147
+ errors: {
2148
+ blankMessage: `Feedback cannot be blank. Pass your feedback with ${uiCommandReference('hs feedback --message "<message>" --source <user|agent>')}.`,
2149
+ messageTooLong: (length) => `Feedback must be ${MAX_FEEDBACK_LENGTH} characters or fewer. Your message has ${length} characters.`,
2150
+ containsCredentials: 'Feedback cannot contain an access key, token, or secret from your HubSpot config. Remove it, then try again.',
2151
+ sourceRequired: `${uiCommandReference('--message')} requires ${uiCommandReference('--source')}. Pass ${uiCommandReference('--source user')} if you are a person, or ${uiCommandReference('--source agent')} if you are an AI agent.`,
2152
+ noAccount: `To send feedback from the terminal, authenticate an account with ${uiCommandReference('hs account auth')}. To use the feedback form instead, run ${uiCommandReference('hs feedback')} without ${uiCommandReference('--message')}.`,
2153
+ submitFailed: `Could not send your feedback. To use the feedback form instead, run ${uiCommandReference('hs feedback')} without ${uiCommandReference('--message')}.`,
2154
+ },
1827
2155
  },
1828
2156
  installDeps: {
1829
2157
  help: {
@@ -1837,7 +2165,6 @@ export const commands = {
1837
2165
  installationSuccessful: (directory) => `Installed dependencies in ${directory}`,
1838
2166
  addingDependenciesToLocation: (dependencies, directory) => `Installing ${dependencies} in ${directory}`,
1839
2167
  installingDependenciesFailed: (directory) => `Installing dependencies for ${directory} failed`,
1840
- noProjectConfig: 'No project detected. Run this command from a project directory.',
1841
2168
  noPackageJsonInProject: (projectName) => `No dependencies to install. The project ${projectName} folder might be missing component or subcomponent files. ${uiLink('Learn how to create a project from scratch', 'https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app#customize-a-new-project-using-the-cli')}`,
1842
2169
  packageManagerNotInstalled: (packageManager) => `This command depends on ${packageManager}, install ${uiLink(packageManager, 'https://docs.npmjs.com/downloading-and-installing-node-js-and-npm')}`,
1843
2170
  },
@@ -1852,15 +2179,16 @@ export const commands = {
1852
2179
  loading: {
1853
2180
  checking: 'Checking lint packages and configuration…',
1854
2181
  creatingConfig: 'Creating ESLint configuration files…',
2182
+ addingLintScripts: 'Adding lint scripts to package.json files…',
1855
2183
  linting: 'Linting…',
1856
2184
  },
1857
- noProjectConfig: 'No project detected. Run this command from a project directory.',
1858
2185
  failedToReadPackageJson: (packageJsonPath) => `Failed to read package.json at ${packageJsonPath}`,
1859
2186
  installLintPackagesPrompt: (directories, missingPackages) => {
1860
2187
  const uniquePackages = Array.from(new Set(missingPackages)).sort();
1861
2188
  return `The dependencies required for linting are missing or outdated.\n\nDependencies:\n${uniquePackages.map(p => ` - ${p}`).join('\n')}\n\n${directories.length === 1 ? 'Directory' : 'Directories'}:\n${directories.map(d => ` - ${d}`).join('\n')}\n\nWould you like to install the required dependencies?`;
1862
2189
  },
1863
2190
  skippingDirectoriesWarning: (directories) => `Skipping linting for the following ${directories.length === 1 ? 'directory' : 'directories'}:\n${directories.map(d => ` - ${d}`).join('\n')}`,
2191
+ skippedDirectoriesError: (directoryCount) => `Linting could not run for ${directoryCount === 1 ? 'the directory' : 'the directories'} above because the required dependencies are missing. Run ${uiCommandReference('hs project lint --install-missing-deps')} to install them.`,
1864
2192
  deprecatedEslintConfigWarning: (details) => {
1865
2193
  const dirCount = details.length;
1866
2194
  const header = `Deprecated ESLint configuration file${dirCount === 1 ? '' : 's'} detected in the following ${dirCount === 1 ? 'directory' : 'directories'}:`;
@@ -1871,8 +2199,17 @@ export const commands = {
1871
2199
  },
1872
2200
  createEslintConfigPrompt: (directories) => `ESLint configuration file not found in the following ${directories.length === 1 ? 'directory' : 'directories'}:\n${directories.map(d => ` - ${d}`).join('\n')}\n\nWould you like to set up the required ESLint configuration?`,
1873
2201
  eslintConfigCreated: (configPath) => `ESLint configuration created at ${configPath}`,
2202
+ createEslintConfigRequiresV2Platform: (platformVersion) => {
2203
+ if (!platformVersion) {
2204
+ return 'Automatic ESLint configuration requires a Developer Platform project (2025.2 or later) with platformVersion set in hsproject.json. Add an eslint.config.js file manually, or set platformVersion and try again.';
2205
+ }
2206
+ return `Automatic ESLint configuration is not available for platform version ${platformVersion}. Use Developer Platform 2025.2 or later, or add eslint.config.js manually.`;
2207
+ },
2208
+ failedToFetchRemoteEslintConfig: (platformVersion) => `Could not download the ESLint config from HubSpot project components for platform version ${platformVersion}. Check your network connection and try again, or add eslint.config.js manually.`,
1874
2209
  failedToCreateEslintConfig: (configPath) => `Failed to create ESLint configuration at ${configPath}`,
1875
2210
  eslintConfigRequired: 'ESLint configuration is required to run the lint command. Run the command again to create the configuration.',
2211
+ lintScriptsAdded: (scriptNames, packageJsonPath) => `Added ${scriptNames.map(s => `"${s}"`).join(' and ')} to ${packageJsonPath}`,
2212
+ failedToAddLintScripts: (packageJsonPath) => `Failed to add lint scripts to ${packageJsonPath}`,
1876
2213
  },
1877
2214
  updateDeps: {
1878
2215
  help: {
@@ -1886,7 +2223,6 @@ export const commands = {
1886
2223
  updateSuccessful: (directory) => `Updated dependencies in ${directory}`,
1887
2224
  updatingDependenciesToLocation: (dependencies, directory) => `Updating ${dependencies} in ${directory}`,
1888
2225
  updatingDependenciesFailed: (directory) => `Updating dependencies for ${directory} failed`,
1889
- noProjectConfig: 'No project detected. Run this command from a project directory.',
1890
2226
  noPackageJsonInProject: (projectName) => `No dependencies to update. The project ${projectName} folder might be missing component or subcomponent files. ${uiLink('Learn how to create a project from scratch', 'https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app#customize-a-new-project-using-the-cli')}`,
1891
2227
  packageManagerNotInstalled: (packageManager) => `This command depends on ${packageManager}, install ${uiLink(packageManager, 'https://docs.npmjs.com/downloading-and-installing-node-js-and-npm')}`,
1892
2228
  },
@@ -1897,6 +2233,7 @@ export const commands = {
1897
2233
  examples: {
1898
2234
  default: 'Validate the project before uploading',
1899
2235
  withProfile: 'Validate the project with a profile before uploading.',
2236
+ json: 'Output validation results as JSON for scripting',
1900
2237
  },
1901
2238
  success: (projectName) => `Project ${projectName} is valid and ready to upload`,
1902
2239
  failure: (projectName, profileName) => `Project ${projectName} is invalid${profileName ? ` with profile "${profileName}" applied` : ''}`,
@@ -1923,10 +2260,145 @@ export const commands = {
1923
2260
  name: 'Name',
1924
2261
  platformVersion: 'Platform Version',
1925
2262
  },
2263
+ examples: {
2264
+ default: 'List projects in the target account',
2265
+ json: 'Output as JSON for scripting',
2266
+ },
2267
+ errors: {
2268
+ noProjectsFound: (accountId) => `No projects found for account ${uiAccountDescription(accountId)}`,
2269
+ },
2270
+ },
2271
+ info: {
2272
+ describe: 'Display information about a project, its app, and its components',
2273
+ verboseDescribe: `Display information about a project, its app, and its components\n\nShows the project's platform version, deployed build ID, auto-deploy status, app metadata, and a list of components.\n\nRun ${uiCommandReference('hs project info --json')} to output the result as JSON for scripting.`,
2274
+ project: {
2275
+ title: (name) => `Project: ${name}`,
2276
+ platformVersion: (version) => `Platform Version: ${version}`,
2277
+ id: (id) => `Project ID: ${id}`,
2278
+ deployedBuild: (buildId) => `Deployed Build: #${buildId}`,
2279
+ autoDeploy: (enabled) => `Auto-deploy: ${enabled ? 'Enabled' : 'Disabled'}`,
2280
+ },
2281
+ app: {
2282
+ title: 'App',
2283
+ name: (name) => `Name: ${name}`,
2284
+ id: (id) => `App ID: ${id}`,
2285
+ uid: (uid) => `UID: ${uid}`,
2286
+ authType: (authType) => `Auth Type: ${authType}`,
2287
+ distributionType: (distributionType) => `Distribution: ${distributionType}`,
2288
+ },
2289
+ examples: {
2290
+ default: 'Display project information',
2291
+ json: 'Output as JSON for scripting',
2292
+ },
2293
+ viewProjectLink: 'View project in HubSpot',
2294
+ componentsHeader: 'Components',
2295
+ labels: {
2296
+ type: 'Type',
2297
+ uid: 'UID',
2298
+ },
2299
+ errors: {
2300
+ projectNotFound: (projectName, accountId) => `Project "${projectName}" was not found in account ${uiAccountDescription(accountId)}. Make sure the project has been uploaded at least once.`,
2301
+ noDeployedBuild: `This project has not been deployed yet.\n\nRun ${uiCommandReference('hs project deploy')} to deploy your project.`,
2302
+ unsupportedPlatformVersion: (platformVersion) => `This command is not supported for platform version ${chalk.bold(platformVersion)}. Please upgrade to 2025.2 or later.`,
2303
+ },
2304
+ },
2305
+ delete: {
2306
+ describe: 'Delete a project from the current target account',
2307
+ verboseDescribe: `Delete a project from the current target account\n\nThis will permanently delete the project, all deployed components, and any app installations associated with it. Your local project files will not be affected.`,
2308
+ warnings: {
2309
+ irreversibleTitle: 'Warning: This will permanently delete your project',
2310
+ irreversible: 'Deleting this project will also delete all deployed components and app installations. This action cannot be undone. Your local project files will not be affected.',
2311
+ },
2312
+ prompts: {
2313
+ selectProject: (accountId) => `Select a project to delete in ${uiAccountDescription(accountId)}`,
2314
+ confirmDelete: (projectName, accountId) => `[--force] Delete ${chalk.bold(projectName)} from ${uiAccountDescription(accountId)}? This cannot be undone.`,
2315
+ validation: {
2316
+ projectRequired: 'Please select a project to delete',
2317
+ },
2318
+ },
2319
+ logs: {
2320
+ deleting: (projectName) => `Deleting project ${chalk.bold(projectName)}...`,
2321
+ deleted: (projectName, accountId) => `Deleted project ${chalk.bold(projectName)} from ${uiAccountDescription(accountId)}`,
2322
+ cancelled: 'Deletion cancelled',
2323
+ componentsToDeleteUnified: (components) => `The following deployed components will be deleted:\n${components.map(c => ` - ${chalk.bold(c.componentId)} (${mapToUserFriendlyName(c.componentType)})`).join('\n')}`,
2324
+ componentsToDeleteLegacy: (components) => `The following deployed components will be deleted:\n${components.map(c => ` - ${chalk.bold(c)}`).join('\n')}`,
2325
+ deletingComponents: (projectName) => `Deleting deployed components from ${chalk.bold(projectName)}...`,
2326
+ componentsDeleted: (projectName) => `Deleted deployed components from ${chalk.bold(projectName)}`,
2327
+ unableToDetermineIfComponentsWereDeleted: (projectName) => `Unable to determine if components were successfully deleted from ${chalk.bold(projectName)}. Please try again.`,
2328
+ installWarning: (installCount) => `This project has ${chalk.bold(String(installCount))} active app ${installCount === 1 ? 'installation' : 'installations'} that will be deleted.`,
2329
+ installCountUnknown: 'Unable to determine the number of active app installations for this project.',
2330
+ },
1926
2331
  errors: {
1927
2332
  noProjectsFound: (accountId) => `No projects found for account ${uiAccountDescription(accountId)}`,
2333
+ projectNotFound: (projectName, accountId) => `Project ${chalk.bold(projectName)} not found in ${uiAccountDescription(accountId)}`,
2334
+ deleteFailed: (projectName) => `Failed to delete project ${chalk.bold(projectName)}. Run with --debug for details or try again.`,
2335
+ cannotDelete: (projectName, reason) => `Cannot delete project ${chalk.bold(projectName)}: ${reason}`,
2336
+ noPlatformVersion: 'Unable to determine platform version for project',
2337
+ componentDeletionFailed: (projectName) => `Failed to delete deployed components from ${chalk.bold(projectName)}. The project was not deleted.`,
2338
+ },
2339
+ options: {
2340
+ project: 'name of the project to delete',
2341
+ force: 'skip confirmation prompt',
1928
2342
  },
1929
2343
  },
2344
+ installApp: {
2345
+ describe: 'Install a static auth app from the current project into the target account',
2346
+ verboseDescribe: `Install a static auth app from the current project into the target account.\n\nRun this command from within the project directory. The project must contain a privately distributed static auth app and must already be uploaded to the target account.`,
2347
+ examples: {
2348
+ default: 'Install the static auth app from the current project',
2349
+ withAccount: 'Install the app into a specific account',
2350
+ withProfile: 'Install the app into the account targeted by a profile',
2351
+ json: 'Output install result as JSON',
2352
+ },
2353
+ options: {
2354
+ force: 'Skip confirmation prompts',
2355
+ profile: 'The profile to target with this install',
2356
+ },
2357
+ errors: {
2358
+ unsupportedPlatformVersion: (platformVersion) => `This command is only supported for projects on platform version 2025.2 or later (detected: ${platformVersion}).`,
2359
+ failedToParseProject: 'Failed to parse the project. Check your project configuration is valid and try again.',
2360
+ noAppInProject: 'No app was found in the local project. This command requires a project that contains an app.',
2361
+ unsupportedAuthType: (authType) => `This command only supports static auth apps. Detected auth type: ${authType}.`,
2362
+ unsupportedDistribution: (distribution) => `This command only supports privately distributed apps. Detected distribution: ${distribution}.`,
2363
+ invalidAppDeveloperAccount: (accountId) => `Static auth apps can't be installed into the app developer account ${uiAccountDescription(accountId)}. Switch to a standard, sandbox, or developer test account with ${uiCommandReference('hs account use')}, or pass ${uiCommandReference('--account')}.`,
2364
+ projectNotFound: (accountId, projectName) => `The project ${chalk.bold(projectName)} does not exist in ${uiAccountDescription(accountId)}. Run ${uiCommandReference('hs project upload')} to upload your project files to HubSpot.`,
2365
+ appNotDeployed: (appName, accountId) => `The app ${chalk.bold(appName)} has not been deployed to ${uiAccountDescription(accountId)}. Upload the project with ${uiCommandReference('hs project upload')} and ensure the build succeeds, then try again.`,
2366
+ automaticInstallUnavailable: (appName, accountId) => `${chalk.bold(appName)} could not be installed automatically in ${uiAccountDescription(accountId)}.`,
2367
+ installFailed: (appName, accountId) => `Failed to install ${chalk.bold(appName)} in ${uiAccountDescription(accountId)}.`,
2368
+ },
2369
+ jsonErrors: {
2370
+ automaticInstallUnavailable: 'Automatic install is unavailable for this account.',
2371
+ installFailed: (appName, accountId) => `Failed to install ${appName} in account ${accountId}.`,
2372
+ },
2373
+ profileMessage: (profileName, accountId) => `Installing with ${chalk.bold(profileName)} profile: ${uiAccountDescription(accountId)}`,
2374
+ appDeveloperAccountNotice: (accountId) => `${uiAccountDescription(accountId)} is an app developer account, which can't have apps installed into it.`,
2375
+ selectInstallAccountPrompt: 'Select an account to install the app into',
2376
+ uploadAndDeployPrompt: (accountId) => `The app isn't deployed to ${uiAccountDescription(accountId)} yet. Upload and deploy the project now?`,
2377
+ alreadyInstalled: (appName, accountId) => `${chalk.bold(appName)} is already installed in ${uiAccountDescription(accountId)}.`,
2378
+ outdatedScopes: (appName, accountId) => `${chalk.bold(appName)} is installed in ${uiAccountDescription(accountId)} with outdated scopes.`,
2379
+ reinstallPrompt: 'Reinstall the app to grant the latest scopes?',
2380
+ installPrompt: (appName, accountId) => `Install ${chalk.bold(appName)} in ${uiAccountDescription(accountId)}?`,
2381
+ installFromBrowser: (installUrl) => `Install the app in HubSpot: ${uiLink('Open install page', installUrl)}`,
2382
+ success: (appName, accountId) => `${chalk.bold(appName)} installed in ${uiAccountDescription(accountId)}.`,
2383
+ },
2384
+ installStatus: {
2385
+ describe: 'Check whether a static auth app in the current project is installed in the target account. This command must be run from within a HubSpot project directory.',
2386
+ examples: {
2387
+ default: 'Check install status for the static auth app in the current project',
2388
+ json: 'Output install status as JSON',
2389
+ },
2390
+ errors: {
2391
+ unsupportedPlatformVersion: (platformVersion) => `This command is only supported for projects on platform version 2025.2 or later (detected: ${platformVersion}).`,
2392
+ failedToParseProject: 'Failed to parse the project. Check your project configuration is valid and try again.',
2393
+ noAppInProject: 'No app was found in the local project. Install status is only available for projects that contain an app.',
2394
+ unsupportedAuthType: (authType) => `This command only supports static auth apps. Detected auth type: ${authType}.`,
2395
+ },
2396
+ success: {
2397
+ installed: (appName, accountId) => `${chalk.bold(appName)} is installed in ${uiAccountDescription(accountId)}.`,
2398
+ installedWithOutdatedScopes: (appName, accountId) => `${chalk.bold(appName)} is installed in ${uiAccountDescription(accountId)} with outdated scopes. Reinstall the app to grant the latest scopes.`,
2399
+ },
2400
+ notInstalled: (appName, accountId) => `${chalk.bold(appName)} is not installed in ${uiAccountDescription(accountId)}.`,
2401
+ },
1930
2402
  },
1931
2403
  sandbox: {
1932
2404
  describe: 'Commands for managing sandboxes.',
@@ -2121,6 +2593,111 @@ export const commands = {
2121
2593
  },
2122
2594
  },
2123
2595
  },
2596
+ logs: {
2597
+ describe: 'View recent application logs.',
2598
+ verboseDescribe: `View recent application logs for a specific log type.\n\nFilter by time range with ${uiCommandReference('--since')} (e.g. 1h, 30m, 2d, or an ISO timestamp). Use ${uiCommandReference('--tail')} to follow logs in real-time, ${uiCommandReference('--compact')} for one-line-per-log output, or ${uiCommandReference('--json')} for machine-readable output.\n\nRun ${uiCommandReference('hs app log-details <logId>')} to inspect a specific log entry.`,
2599
+ options: {
2600
+ appId: 'App ID',
2601
+ type: 'Log type',
2602
+ json: 'Output logs as JSON',
2603
+ limit: 'Maximum number of logs to return',
2604
+ since: 'Filter logs by time ago (1h, 30m, 2d, or ISO timestamp)',
2605
+ tail: 'Follow logs in real-time',
2606
+ errorsOnly: 'Only show error logs',
2607
+ compact: 'Display logs in compact format (one line per log)',
2608
+ },
2609
+ errors: {
2610
+ noLogs: 'No logs found. Try a wider time range (--since) or remove --errors-only to see all logs.',
2611
+ noApps: `No apps found. Create an app with ${uiCommandReference('hs project create')}.`,
2612
+ },
2613
+ prompts: {
2614
+ selectType: '[--type] Select the type of logs to view:',
2615
+ },
2616
+ examples: {
2617
+ basic: 'Fetch webhook logs for app 123456',
2618
+ since: 'Fetch logs from the last hour',
2619
+ tail: 'Follow logs in real-time',
2620
+ json: 'Output logs as JSON',
2621
+ compact: 'Display logs in compact format',
2622
+ },
2623
+ outputMessages: {
2624
+ viewInHubSpot: (url) => uiLink('View in HubSpot', url),
2625
+ tableHeaders: {
2626
+ appId: 'App ID',
2627
+ type: 'Type',
2628
+ logsFound: 'Logs Found',
2629
+ },
2630
+ logDetails: {
2631
+ id: 'ID',
2632
+ duration: 'Duration',
2633
+ portal: 'Portal',
2634
+ trace: 'Trace',
2635
+ error: 'Error',
2636
+ viewDetails: (logId, appId, systemType) => `To view more details, run: ${uiCommandReference(`hs app log-details ${logId} --app=${appId} --type=${systemType}`)}`,
2637
+ viewInUI: (url) => uiLink('View details in UI', url),
2638
+ },
2639
+ tailMessages: {
2640
+ following: (appId) => `Following logs for app ${appId}`,
2641
+ stop: `> Press ${chalk.bold('q')} to stop following`,
2642
+ },
2643
+ },
2644
+ },
2645
+ logDetails: {
2646
+ describe: 'View details for a specific log entry.',
2647
+ verboseDescribe: `View full details for a specific app log entry, including request/response bodies, context information, and error details.\n\nUse ${uiCommandReference('--json')} for machine-readable output.`,
2648
+ positionals: {
2649
+ logId: 'The log ID to fetch details for',
2650
+ },
2651
+ options: {
2652
+ appId: 'App ID',
2653
+ type: 'Log type',
2654
+ json: 'Output details as JSON',
2655
+ },
2656
+ errors: {
2657
+ noApps: `No apps found. Create an app with ${uiCommandReference('hs project create')}.`,
2658
+ },
2659
+ prompts: {
2660
+ selectType: '[--type] Select the log type:',
2661
+ },
2662
+ examples: {
2663
+ basic: 'Fetch details for log abc-123',
2664
+ json: 'Output log details as JSON',
2665
+ },
2666
+ outputMessages: {
2667
+ viewInHubSpot: (url) => uiLink('View in HubSpot', url),
2668
+ logDetailsHeader: 'Log Details',
2669
+ basicInfo: {
2670
+ id: 'Log ID',
2671
+ timestamp: 'Timestamp',
2672
+ status: 'Status',
2673
+ duration: 'Duration',
2674
+ systemType: 'Type',
2675
+ },
2676
+ contextInfo: {
2677
+ header: 'Context',
2678
+ portalId: 'Portal ID',
2679
+ traceId: 'Trace ID',
2680
+ function: 'Function',
2681
+ location: 'Location',
2682
+ card: 'Card',
2683
+ userId: 'User ID',
2684
+ },
2685
+ requestResponse: {
2686
+ header: 'Request/Response',
2687
+ requestBody: 'Request Body',
2688
+ responseBody: 'Response Body',
2689
+ },
2690
+ errorInfo: {
2691
+ header: 'Error Details',
2692
+ errorType: 'Type',
2693
+ errorMessage: 'Message',
2694
+ stackTrace: 'Stack Trace',
2695
+ },
2696
+ additionalInfo: {
2697
+ header: 'Additional Information',
2698
+ },
2699
+ },
2700
+ },
2124
2701
  },
2125
2702
  },
2126
2703
  secret: {
@@ -2222,7 +2799,7 @@ export const commands = {
2222
2799
  configPathPrompt: '[--config-path] Enter the path to the test account config: ',
2223
2800
  createTestAccountFromConfigPrompt: 'How would you like to create your test account?',
2224
2801
  createFromConfigOption: 'Create test account from config file',
2225
- createFromScratchOption: 'Create test account from scratch',
2802
+ createFromScratchOption: 'Select hub tiers manually',
2226
2803
  errors: {
2227
2804
  configFileNotFound: (configPath) => `No test account config file exists at ${configPath}. Create a test account config file with the ${uiCommandReference('hs test-account create-config')} command.`,
2228
2805
  configFileParseFailed: (configPath) => `Failed to parse test account config file at ${configPath}`,
@@ -2242,8 +2819,8 @@ export const commands = {
2242
2819
  opsLevel: 'Operations Hub tier. Options: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
2243
2820
  serviceLevel: 'Service Hub tier. Options: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
2244
2821
  salesLevel: 'Sales Hub tier. Options: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
2245
- contentLevel: 'CMS Hub tier. Options: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
2246
- commerceLevel: 'Commerce Hub tier. Options: FREE, PROFESSIONAL, ENTERPRISE',
2822
+ contentLevel: 'Content Hub tier. Options: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
2823
+ commerceLevel: 'Revenue Hub tier. Options: FREE, PROFESSIONAL, ENTERPRISE',
2247
2824
  },
2248
2825
  example: (configPath) => `Create a test account from the config file at ${configPath}`,
2249
2826
  examples: {
@@ -2895,15 +3472,145 @@ export const commands = {
2895
3472
  },
2896
3473
  };
2897
3474
  export const lib = {
3475
+ linkedDirectory: {
3476
+ warning: (action, settingsPath) => `This directory has linked accounts via ${settingsPath}. ${uiCommandReference(action)} modifies your global config, not the linked directory settings. Use ${uiCommandReference('hs account link')} to manage linked accounts.\n`,
3477
+ },
2898
3478
  parsing: {
2899
3479
  unableToParseStringToNumber: 'Unable to parse string to number',
2900
3480
  },
2901
3481
  configMiddleWare: {
2902
3482
  invalidAccountIdEnvironmentVariable: 'Unable to parse `HUBSPOT_ACCOUNT_ID` environment variable into a number',
2903
3483
  },
3484
+ accountTargetDiscovery: {
3485
+ errors: {
3486
+ explicitAccountNotFound: (account) => `Account ${chalk.bold(String(account))} was not found in your config. Run ${uiCommandReference('hs account list')} to see available accounts.`,
3487
+ },
3488
+ },
2904
3489
  process: {
2905
3490
  exitDebug: (signal) => `Attempting to gracefully exit. Triggered by ${signal}`,
2906
3491
  },
3492
+ handlerLogFile: {
3493
+ saved: (filePath) => `Debug logs can be viewed at ${filePath}`,
3494
+ },
3495
+ jsonSchema: {
3496
+ noSchemaForCommand: 'No schema defined for this command',
3497
+ validationFailed: 'JSON output may be missing or malformed fields. The output schema may be out of date.',
3498
+ },
3499
+ agentHelp: {
3500
+ headings: {
3501
+ conventions: chalk.bold('Conventions:'),
3502
+ jsonOutput: chalk.bold('JSON output:'),
3503
+ workflows: chalk.bold('Workflows:'),
3504
+ exitCodes: chalk.bold('Exit codes:'),
3505
+ commands: chalk.bold('All commands:'),
3506
+ },
3507
+ conventions: [
3508
+ 'More help: To see the workflows that use one command, run `hs <command> --agent-help`.',
3509
+ 'JSON output: Commands that support `--json` print one JSON object to stdout when they finish. Errors and warnings print to stderr.',
3510
+ 'JSON schemas: To print the JSON Schema for the output of a command, run the command with `--json-schema`.',
3511
+ 'Prompts: Commands prompt for values that you do not pass as flags. To run a command without prompts, pass each value as a flag.',
3512
+ 'Long-running commands: `hs project dev`, `hs project watch`, `hs cms watch`, and `hs cms theme preview` run until they are stopped and can prompt for input. Do not run them from your shell, even in the background. Ask the user to run them in a separate terminal window.',
3513
+ 'Accounts: Commands use the default account in the CLI config. To use a different account, pass `--account <name or ID>`. To see the configured accounts, run `hs account list`.',
3514
+ 'Environment variables: To read the account from `HUBSPOT_ACCOUNT_ID` and `HUBSPOT_PERSONAL_ACCESS_KEY` instead of the config file, pass `--use-env`.',
3515
+ 'Config file: The global config file is `~/.hscli/config.yml`. To use a different file, pass `--config <path>`.',
3516
+ 'Color: To remove color from the output, pass `--no-color` or set `NO_COLOR`.',
3517
+ 'Debug logs: To print debug logs, pass `--debug`.',
3518
+ 'MCP server: To connect the HubSpot Dev MCP server to an AI coding tool, run `hs mcp setup`.',
3519
+ 'Feedback: To send feedback about the CLI, run `hs feedback --message "<message>" --source agent`. Send one short line about a bug, a missing command or flag, or anything that confused the user. Keep it about the CLI. Do not include secrets, access keys, file contents, or personal data. Then continue with the task.',
3520
+ ],
3521
+ jsonOutput: {
3522
+ schema: 'With `--json`, the command prints one JSON object to stdout. The object matches this JSON Schema:',
3523
+ noSchema: 'With `--json`, the command prints JSON to stdout. The CLI does not define a schema for this output.',
3524
+ },
3525
+ workflows: [
3526
+ {
3527
+ title: 'Authenticate an account',
3528
+ steps: [
3529
+ {
3530
+ command: 'hs account auth',
3531
+ description: 'Ask the user to run this command in their own terminal. It can open a browser page where the user creates a personal access key, and then it prompts for the key. Do not ask the user to paste the key into the conversation.',
3532
+ },
3533
+ {
3534
+ command: 'hs account list',
3535
+ description: 'List the accounts in the CLI config.',
3536
+ },
3537
+ {
3538
+ command: 'hs account use <account>',
3539
+ description: 'Set the default account. Commands use the default account unless you pass `--account`.',
3540
+ },
3541
+ ],
3542
+ },
3543
+ {
3544
+ title: 'Create a project',
3545
+ steps: [
3546
+ {
3547
+ command: 'hs project create --name <name> --dest <directory> --project-base app --distribution <private|marketplace> --auth <oauth|static> --features --json',
3548
+ description: 'Create a project with an app in a new directory. Pass every flag to skip the prompts. A `--features` flag with no values adds no features.',
3549
+ },
3550
+ {
3551
+ command: 'hs project validate --json',
3552
+ description: 'Run this command in the project directory. It checks the project files before you upload them.',
3553
+ },
3554
+ ],
3555
+ },
3556
+ {
3557
+ title: 'Generate test data',
3558
+ steps: [
3559
+ {
3560
+ command: 'hs test-account create --name <name> --description <description> --marketing-level ENTERPRISE --ops-level ENTERPRISE --service-level ENTERPRISE --sales-level ENTERPRISE --content-level ENTERPRISE --commerce-level ENTERPRISE',
3561
+ description: 'Create a developer test account and save it to the CLI config. Pass every flag to skip the prompts. Do not pass `--json`. With `--json`, the command does not save the account to the config, and the output includes the personal access key of the account.',
3562
+ },
3563
+ {
3564
+ command: 'hs test-account import-data --account <test account> --file-path <import.json> --skip-confirm',
3565
+ description: 'Import CRM records into the test account. The JSON file uses the request format of the CRM imports API: https://developers.hubspot.com/docs/guides/api/crm/imports. Each `fileName` in the file is a path relative to the current directory.',
3566
+ },
3567
+ ],
3568
+ },
3569
+ {
3570
+ title: 'Develop a project',
3571
+ steps: [
3572
+ {
3573
+ command: 'hs project create',
3574
+ description: 'Create the project. The "Create a project" workflow shows the flags that skip the prompts.',
3575
+ },
3576
+ {
3577
+ command: 'hs project upload --json',
3578
+ description: 'Run this command in the project directory. It uploads the project and creates a build. If auto-deploy is on, it also deploys the build, and the output includes `deployId`.',
3579
+ },
3580
+ {
3581
+ command: 'hs project deploy --build <buildId> --json',
3582
+ description: 'Deploy the build. Use this command if the upload output has no `deployId`.',
3583
+ },
3584
+ {
3585
+ command: 'hs project dev',
3586
+ description: 'Ask the user to run this command in a separate terminal window. It starts local development and runs until it is stopped. Changes upload from the Local Dev Panel, or as you edit with `--auto-upload`. To test on a test account, also pass `--testing-account <test account ID>` and `--project-account <developer account ID>`.',
3587
+ },
3588
+ {
3589
+ command: 'hs project list-builds --limit 1 --json',
3590
+ description: 'Show the status of the latest build. `deployedBuildId` is the build that is deployed now.',
3591
+ },
3592
+ ],
3593
+ },
3594
+ {
3595
+ title: 'Investigate a failed build',
3596
+ steps: [
3597
+ {
3598
+ command: 'hs project list-builds --limit 1 --json',
3599
+ description: 'Get the latest build. Each entry in `subbuildStatuses` has the status and error message of one component.',
3600
+ },
3601
+ {
3602
+ command: 'hs project validate --json',
3603
+ description: 'Validate the local project files.',
3604
+ },
3605
+ {
3606
+ command: 'hs project upload --json',
3607
+ description: 'Upload the project again after you fix the errors.',
3608
+ },
3609
+ ],
3610
+ },
3611
+ ],
3612
+ exitCodes: AGENT_HELP_EXIT_CODES,
3613
+ },
2907
3614
  DevServerManager: {
2908
3615
  portConflict: (port) => `The port ${port} is already in use.`,
2909
3616
  notInitialized: 'The Dev Server Manager must be initialized before it is started.',
@@ -2918,6 +3625,7 @@ export const lib = {
2918
3625
  learnMoreLocalDevServer: uiLink('Learn more about the projects local dev server', 'https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands'),
2919
3626
  running: (projectName, accountIdentifier) => chalk.hex(UI_COLORS.SORBET)(`Running ${chalk.bold(projectName)} locally on ${accountIdentifier}, waiting for changes ...`),
2920
3627
  quitHelper: `Press ${chalk.bold('q')} to stop the local dev server`,
3628
+ autoUploadEnabled: `${chalk.bold('Auto-upload is on.')} Changes you make locally will be uploaded to HubSpot automatically.`,
2921
3629
  viewProjectLink: (name, accountId) => uiLink('View project in HubSpot', getProjectDetailUrl(name, accountId) || ''),
2922
3630
  viewLocalDevUILink: (accountId, showWelcomeScreen) => uiLink('View local dev session in HubSpot', getLocalDevUiUrl(accountId, showWelcomeScreen)),
2923
3631
  localDevUIAutoMessage: (accountId, showWelcomeScreen) => `Opening your ${uiLink('local dev session in HubSpot', getLocalDevUiUrl(accountId, showWelcomeScreen))}...`,
@@ -2986,6 +3694,13 @@ export const lib = {
2986
3694
  appDataNotFound: 'An error occurred while fetching data for your app.',
2987
3695
  oauthAppRedirectUrlError: (redirectUrl) => `${chalk.bold('No reponse from your OAuth service:')} ${redirectUrl}\nYour app needs a valid OAuth2 service to be installed for local dev. ${uiLink('Learn more', 'https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/oauth/working-with-oauth')}`,
2988
3696
  },
3697
+ accountAuthWebsocket: {
3698
+ logs: {
3699
+ openingWebBrowser: (url) => `Opening ${uiLink('HubSpot', url)} in your web browser\n`,
3700
+ spinner: 'Waiting for HubSpot to send your personal access key... (press any key to enter it manually)',
3701
+ received: 'Personal access key received',
3702
+ },
3703
+ },
2989
3704
  CLIWebsocketServer: {
2990
3705
  errors: {
2991
3706
  portManagerNotRunning: (prefix) => `${prefix ? `${prefix} ` : ''}PortManagerServing must be running before starting WebsocketServer.`,
@@ -2993,6 +3708,7 @@ export const lib = {
2993
3708
  missingTypeField: (data) => `Unsupported message received. Missing type field: ${data}`,
2994
3709
  invalidJSON: (data) => `Unsupported message received. Invalid JSON: ${data}`,
2995
3710
  unknownMessageType: (type) => `Unsupported message received. Unknown message type: ${type}`,
3711
+ failedToBindEphemeralPort: (prefix) => `${prefix ? `${prefix} ` : ''}Failed to determine the assigned port for the WebsocketServer.`,
2996
3712
  },
2997
3713
  logs: {
2998
3714
  startup: (port) => `WebsocketServer running on port ${port}`,
@@ -3000,8 +3716,14 @@ export const lib = {
3000
3716
  },
3001
3717
  LocalDevProcess: {
3002
3718
  projectConfigMismatch: `Unable to upload project. The project config has been modified since starting ${uiCommandReference('hs project dev')}.`,
3003
- uploadInitiated: 'Project upload initiated from Local Dev UI.',
3004
- deployInitiated: 'Project deploy initiated from Local Dev UI.',
3719
+ uploadInitiated: 'Project upload initiated.',
3720
+ autoUploadScheduled: (filePath) => `Auto-upload: detected change to ${filePath}, upload scheduled.`,
3721
+ autoUploadTriggered: 'Auto-upload: debounce elapsed, uploading now.',
3722
+ autoUploadInProgress: 'Auto-upload: an upload is already running, will re-run after it finishes.',
3723
+ autoUploadToggled: (enabled) => enabled
3724
+ ? `${chalk.bold('Auto-upload turned on')} from the Local Dev Panel. Changes you make locally will be uploaded to HubSpot automatically.`
3725
+ : `${chalk.bold('Auto-upload turned off')} from the Local Dev Panel. Upload manually from the Local Dev Panel to push your changes.`,
3726
+ deployInitiated: 'Project deploy initiated from the Local Dev Panel.',
3005
3727
  uploadFailed: 'Project upload failed. To proceed with local development, fix any necessary errors, then re-upload your project.',
3006
3728
  deployFailed: 'Project deploy failed. To proceed with local development, fix any necessary errors, then re-deploy your project.',
3007
3729
  uploadSuccess: 'Project upload completed successfully. Resuming local dev...',
@@ -3016,7 +3738,21 @@ export const lib = {
3016
3738
  checking: 'Checking if your deployed build is up to date...',
3017
3739
  upToDate: 'Deployed build is up to date.',
3018
3740
  notUpToDate: `Your project contains undeployed local changes.`,
3741
+ changedFiles: (changed) => {
3742
+ const sections = [];
3743
+ if (changed.added.length > 0) {
3744
+ sections.push(`${chalk.bold('Features Added:')}\n${changed.added.map(f => ` - ${f}`).join('\n')}`);
3745
+ }
3746
+ if (changed.updated.length > 0) {
3747
+ sections.push(`${chalk.bold('Features Modified:')}\n${changed.updated.map(f => ` - ${f}`).join('\n')}`);
3748
+ }
3749
+ if (changed.removed.length > 0) {
3750
+ sections.push(`${chalk.bold('Features Removed:')}\n${changed.removed.map(f => ` - ${f}`).join('\n')}`);
3751
+ }
3752
+ return sections.join('\n\n');
3753
+ },
3019
3754
  notUpToDateExplanation: (profile) => `Run ${uiCommandReference(`hs project upload${profile ? ` --profile ${profile}` : ''}`)} to upload these changes to HubSpot, then re-run ${uiCommandReference(`hs project dev${profile ? ` --profile ${profile}` : ''}`)} to continue local development.`,
3755
+ unableToCompare: `Unable to check if local *-hsmeta.json files match the deployed build. Run ${uiCommandReference('hs project upload')} to upload any local changes before continuing.`,
3020
3756
  },
3021
3757
  createNewProjectForLocalDev: {
3022
3758
  projectMustExistExplanation: (projectName, accountId) => `The project ${projectName} does not exist in the target account ${uiAccountDescription(accountId)}. This command requires the project to exist in the target account.`,
@@ -3039,19 +3775,6 @@ export const lib = {
3039
3775
  },
3040
3776
  },
3041
3777
  account: {
3042
- checkIfDefaultAccountIsSupported: {
3043
- publicApp: `This project contains a public app. Local development of public apps is only supported on developer accounts and developer test accounts. Change your default account using ${uiCommandReference('hs account use')}, or link a new account with ${uiAuthCommandReference()}.`,
3044
- privateApp: `This project contains a private app. Local development of private apps is not supported in developer accounts. Change your default account using ${uiCommandReference('hs account use')}, or link a new account with ${uiAuthCommandReference()}.`,
3045
- },
3046
- validateAccountOption: {
3047
- invalidPublicAppAccount: `This project contains a public app. The "--account" flag must point to a developer test account to develop this project locally. Alternatively, change your default account to an app developer account using ${uiCommandReference('hs account use')} and run ${uiCommandReference('hs project dev')} to set up a new developer test account.`,
3048
- invalidPrivateAppAccount: `This project contains a private app. The account specified with the "--account" flag points to a developer account, which do not support the local development of private apps. Update the "--account" flag to point to a standard, sandbox, or developer test account, or change your default account by running ${uiCommandReference('hs account use')}.`,
3049
- nonSandboxWarning: `Testing in a sandbox is strongly recommended. To switch the target account, select an option below or run ${uiCommandReference('hs account use')} before running the command again.`,
3050
- publicAppNonDeveloperTestAccountWarning: `Local development of public apps is only supported in ${chalk.bold('developer test accounts')}.`,
3051
- },
3052
- checkIfParentAccountIsAuthed: {
3053
- notAuthedError: (parentAccountId, accountIdentifier) => `To develop this project locally, run ${uiAuthCommandReference({ accountId: parentAccountId })} to authenticate the App Developer Account ${parentAccountId} associated with ${accountIdentifier}.`,
3054
- },
3055
3778
  selectAccountTypePrompt: {
3056
3779
  message: 'Choose the type of account to test on',
3057
3780
  developerTestAccountOption: 'Test on a developer test account (recommended)',
@@ -3059,12 +3782,16 @@ export const lib = {
3059
3782
  sandboxAccountOptionDisabled: 'Disabled - requires access to sandbox accounts',
3060
3783
  productionAccountOption: (accountId) => `<${chalk.red('!')} Test on your project account: ${uiAccountDescription(accountId, false)} ${chalk.red('!')}>`,
3061
3784
  },
3062
- confirmDefaultAccountIsTarget: {
3063
- configError: `An error occurred while reading the default account from your config. Run ${uiAuthCommandReference()} to re-auth this account`,
3064
- declineDefaultAccountExplanation: `To develop on a different account, run ${uiCommandReference('hs account use')} to change your default account, then re-run ${uiCommandReference('hs project dev')}.`,
3065
- },
3785
+ declineDefaultAccountExplanation: `To develop on a different account, run ${uiCommandReference('hs account use')} to change your default account, then re-run ${uiCommandReference('hs project dev')}.`,
3066
3786
  },
3067
3787
  },
3788
+ serverlessSunset: {
3789
+ deprecationNotice: (command) => `The ${uiCommandReference(command)} command is deprecated. ${SERVERLESS_SUNSET_NOTICE} ${uiLink(SERVERLESS_CHANGELOG_LINK_TEXT, SERVERLESS_SUNSET_CHANGELOG_URL)}`,
3790
+ creationBlocked: (command) => `The ${uiCommandReference(command)} command is disabled. ${SERVERLESS_CREATION_BLOCKED_NOTICE} Existing functions can no longer be edited from November 17, 2026 and stop running on February 1, 2027. ${uiLink(SERVERLESS_CHANGELOG_LINK_TEXT, SERVERLESS_SUNSET_CHANGELOG_URL)}`,
3791
+ editingDisabled: (command) => `The ${uiCommandReference(command)} command is disabled. Serverless functions can no longer be created or edited in the Design Manager. Existing functions stop running on February 1, 2027. Build your serverless functions in Developer Projects instead. ${uiLink(SERVERLESS_CHANGELOG_LINK_TEXT, SERVERLESS_SUNSET_CHANGELOG_URL)}`,
3792
+ uploadEditingBlockedHint: `If this upload was rejected, it is because serverless functions can no longer be created or edited in the Design Manager. Build your serverless functions in Developer Projects instead. ${uiLink(SERVERLESS_CHANGELOG_LINK_TEXT, SERVERLESS_SUNSET_CHANGELOG_URL)}`,
3793
+ uploadBlockedHint: `If this upload was rejected, it is because serverless functions can no longer be created in the Design Manager, so new function folders can't be uploaded. Build new serverless functions in Developer Projects instead. ${uiLink(SERVERLESS_CHANGELOG_LINK_TEXT, SERVERLESS_SUNSET_CHANGELOG_URL)}`,
3794
+ },
3068
3795
  middleware: {
3069
3796
  updateNotification: {
3070
3797
  notifyTitle: chalk.bold('Update available'),
@@ -3078,6 +3805,12 @@ export const lib = {
3078
3805
  updateFailed: (latestVersion) => `Failed to update HubSpot CLI to version ${chalk.bold(latestVersion)}`,
3079
3806
  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')}`,
3080
3807
  },
3808
+ deprecationWarning: {
3809
+ deprecatedTitle: 'Deprecated',
3810
+ deprecatedMessage: (currentVersion, eolDate) => `Version: HubSpot CLI v${currentVersion}\n\nStatus: Deprecated (End of Life: ${eolDate})\n\nAction Required: Upgrade to the latest major version to continue receiving new features\n\nReplacement: Run ${uiCommandReference('npm install -g @hubspot/cli@latest')} to upgrade\n\n${uiLink('CLI Support Guidelines', CLI_SUPPORT_GUIDELINES_URL)}`,
3811
+ endOfLifeTitle: 'End of Life',
3812
+ endOfLifeMessage: (currentVersion, eolDate) => `Version: HubSpot CLI v${currentVersion}\n\nStatus: End of Life (as of ${eolDate})\n\nAction Required: This version is no longer supported. Upgrade immediately to continue receiving updates\n\nReplacement: Run ${uiCommandReference('npm install -g @hubspot/cli@latest')} to upgrade\n\n${uiLink('CLI Support Guidelines', CLI_SUPPORT_GUIDELINES_URL)}`,
3813
+ },
3081
3814
  },
3082
3815
  projectProfiles: {
3083
3816
  logs: {
@@ -3085,14 +3818,8 @@ export const lib = {
3085
3818
  profileTargetAccount: (accountId) => `Targeting ${uiAccountDescription(accountId)}`,
3086
3819
  profileVariables: 'Profile variables',
3087
3820
  },
3088
- exitIfUsingProfiles: {
3089
- errors: {
3090
- noProfileSpecified: `This project is configured to use profiles, but no profile was specified. Target a profile using the ${uiCommandReference('--profile')} flag.`,
3091
- },
3092
- },
3093
3821
  loadProfile: {
3094
3822
  errors: {
3095
- noProjectConfig: 'No project config found. Please run this command from a project directory.',
3096
3823
  profileNotFound: (profileName) => `Profile ${chalk.bold(profileName)} not found.`,
3097
3824
  missingAccountId: (profileName) => `Profile ${chalk.bold(profileName)} is missing an account id.`,
3098
3825
  listedAccountNotFound: (accountId, profileName) => `The account ${uiAccountDescription(accountId)} is defined in your profile ${chalk.bold(profileName)}, but is missing in your config file`,
@@ -3132,14 +3859,14 @@ export const lib = {
3132
3859
  generateSafeFilenameDifferentiator: {
3133
3860
  failedToCheckFiles: 'Failed to check files for filename differentiator. Falling back to timestamp.',
3134
3861
  },
3862
+ archive: {
3863
+ errors: {
3864
+ archiveNotFound: (archiveDest) => `Archive directory not found: ${archiveDest}`,
3865
+ srcDirInsideArchive: (srcDir) => `The source directory "${srcDir}" cannot be the archive directory or inside it`,
3866
+ },
3867
+ },
3135
3868
  validateProjectConfig: {
3136
3869
  configNotFound: `Unable to locate a project configuration file. Try running again from a project directory, or run ${uiCommandReference('hs project create')} to create a new project.`,
3137
- configMissingFields: (missingFields) => `The project configuration file is missing required field${missingFields.length > 1 ? 's' : ''}: ${missingFields.map(f => chalk.bold(f)).join(', ')}`,
3138
- srcDirNotFound: (srcDir, projectDir) => `Project source directory ${chalk.bold(srcDir)} could not be found in ${chalk.bold(projectDir)}.`,
3139
- srcOutsideProjectDir: (projectConfig, srcDir) => `Invalid value for 'srcDir' in ${projectConfig}: ${chalk.bold(`srcDir: "${srcDir}"`)}\n\t'srcDir' must be a relative path to a folder under the project root, such as "." or "./src"`,
3140
- },
3141
- getProjectConfig: {
3142
- error: 'Could not read from project config',
3143
3870
  },
3144
3871
  platformVersion: {
3145
3872
  unsupported: (currentCliVersion, latestSupported, platformVersion) => `Platform version${platformVersion ? ' ' + chalk.bold(platformVersion) : ''} is not officially supported by this version of the CLI (${chalk.bold(currentCliVersion)}).\n\nUpdate your CLI to the latest version with ${uiCommandReference('hs upgrade')} or use a compatible platform version (${chalk.bold(latestSupported)} or earlier).`,
@@ -3157,6 +3884,12 @@ export const lib = {
3157
3884
  feedbackHeader: "We'd love to hear your feedback!",
3158
3885
  feedbackMessage: `How are you liking the new projects and developer tools? \n > Run ${uiCommandReference('hs feedback')} to let us know what you think!\n`,
3159
3886
  },
3887
+ skippedHsMetaFiles: {
3888
+ warning: (files) => `The following *-hsmeta.json files will be skipped.\nThis CLI version doesn't support the features they require:\n${files.map(f => ` ${chalk.bold(f)}`).join('\n')}\nRun ${uiCommandReference('hs upgrade')} to update the CLI, which may add support for these features.`,
3889
+ uploadWarning: (files) => `The following *-hsmeta.json files will be skipped during upload.\nThis CLI version doesn't support the features they require:\n${files.map(f => ` ${chalk.bold(f)}`).join('\n')}\nRun ${uiCommandReference('hs upgrade')} to update the CLI, which may add support for these features.`,
3890
+ prompt: '[--force] Continue anyway?',
3891
+ jsonRequiresForce: (files) => `The following *-hsmeta.json files would be skipped during upload:\n${files.map(f => ` ${chalk.bold(f)}`).join('\n')}\nRe-run with ${uiCommandReference('--force')} to upload anyway.`,
3892
+ },
3160
3893
  components: {
3161
3894
  unableToGetUidFromHsmeta: 'Unable to get UID from hsmeta',
3162
3895
  buildSuccessMessage: {
@@ -3164,9 +3897,9 @@ export const lib = {
3164
3897
  docsUrl: 'https://developers.hubspot.com/docs/apps/developer-platform/build-apps/overview',
3165
3898
  headerCreated: (projectName, projectDest) => `${chalk.bold(projectName)} was successfully created in ${projectDest}`,
3166
3899
  headerAdded: (featureText, uid, plural) => `${featureText} ${plural ? 'were' : 'was'} successfully added to ${uid}:`,
3167
- docsDetails: (docsLink) => `📖 ${docsLink} for more details about building and testing these features.`,
3168
- uploadPrompt: `🚀 Run ${uiCommandReference('hs project upload')} when you're ready to deploy.`,
3169
- devPrompt: `🧪 Run ${uiCommandReference('hs project dev')} to start local development.`,
3900
+ docsDetails: (docsLink) => `${docsLink} for more details about building and testing these features.`,
3901
+ uploadPrompt: `Run ${uiCommandReference('hs project upload')} when you're ready to deploy.`,
3902
+ devPrompt: `Run ${uiCommandReference('hs project dev')} to start local development.`,
3170
3903
  },
3171
3904
  },
3172
3905
  },
@@ -3197,13 +3930,39 @@ export const lib = {
3197
3930
  },
3198
3931
  handleProjectUpload: {
3199
3932
  emptySource: (srcDir) => `Source directory "${srcDir}" is empty. Add files to your project and rerun ${uiCommandReference('hs project upload')} to upload them to HubSpot.`,
3933
+ noFilesToUpload: (srcDir) => `No files in source directory "${srcDir}" were included in the upload because every file was ignored. Rerun ${uiCommandReference('hs project upload --debug')} to see which files were ignored and why.`,
3200
3934
  compressed: (byteCount) => `Project files compressed: ${byteCount} bytes`,
3201
3935
  compressing: (path) => `Compressing build files to "${path}"`,
3202
3936
  fileFiltered: (filename) => `Ignore rule triggered for "${filename}"`,
3203
3937
  legacyFileDetected: (filename, platformVersion) => `The ${chalk.bold(filename)} file is not supported on platform version ${chalk.bold(platformVersion)} and will be ignored.`,
3204
3938
  projectDoesNotExist: (accountId) => `Upload cancelled. Run ${uiCommandReference('hs project upload')} again to create the project in ${uiAccountDescription(accountId)}.`,
3939
+ workspaceIncluded: (workspaceDir, archivePath) => `Including workspace: ${workspaceDir} → ${archivePath}`,
3940
+ fileDependencyIncluded: (packageName, localPath, archivePath) => `Including file: dependency ${packageName}: ${localPath} → ${archivePath}`,
3941
+ malformedPackageJson: (packageJsonPath, error) => `Skipping malformed package.json at ${packageJsonPath}: ${error}`,
3942
+ workspaceCollision: (archivePath, workspaceDir, existingWorkspace) => `Workspace collision: ${archivePath} from ${workspaceDir} and ${existingWorkspace}`,
3943
+ fileDependencyAlreadyIncluded: (packageName, archivePath) => `file: dependency ${packageName} already included as workspace: ${archivePath}`,
3944
+ updatingLockfile: (lockfilePath) => `Updating package-lock.json in archive: ${lockfilePath}`,
3945
+ updatingPackageJsonWorkspaces: (packageJsonPath) => `Updating package.json workspaces in archive: ${packageJsonPath}`,
3946
+ updatedWorkspaces: (workspaces) => ` Updated workspaces: ${workspaces}`,
3947
+ updatedFileDependency: (packageName, relativePath) => ` Updated dependencies.${packageName}: file:${relativePath}`,
3948
+ lintPackagesNotConfigured: (packageRoot) => `Project lint: lint packages not installed for ${chalk.bold(packageRoot)}. Run ${uiCommandReference('hs project lint')} to install them.`,
3949
+ lintConfigNotFound: (packageRoot) => `Project lint: ESLint configuration not found for ${chalk.bold(packageRoot)}. Run ${uiCommandReference('hs project lint')} to create an ESLint config.`,
3950
+ lintHubSpotRulesNotActive: (packageRoot) => `Project lint: HubSpot ESLint rules not active for ${chalk.bold(packageRoot)}. Configure ${chalk.bold('@hubspot/eslint-config-ui-extensions')} — see ${uiLink('setup instructions', 'https://www.npmjs.com/package/@hubspot/eslint-config-ui-extensions')}.`,
3951
+ npmAuditClean: (packageRoot) => `npm audit: No npm dependency issues found for ${chalk.bold(packageRoot)}`,
3952
+ npmAuditIssues: (packageRoot, details) => `npm audit: security issues found for ${chalk.bold(packageRoot)}: ${details}`,
3953
+ npmAuditNpmUnavailable: (packageRoot) => `npm audit: skipped for ${chalk.bold(packageRoot)} (npm not available in PATH)`,
3954
+ npmAuditNonZeroExit: (packageRoot, exitCode) => `npm audit: ${chalk.bold(packageRoot)} exited with code ${exitCode}`,
3205
3955
  },
3206
3956
  },
3957
+ projectPreview: {
3958
+ triggeringPreview: (buildId, targetPortalId) => `Previewing build #${buildId} on ${uiAccountDescription(targetPortalId)}`,
3959
+ pollingStatus: (releaseTag, targetPortalId) => `Previewing ${chalk.bold(releaseTag)} on ${uiAccountDescription(targetPortalId)}`,
3960
+ succeeded: (releaseTag, targetPortalId) => `Previewed ${chalk.bold(releaseTag)} on ${uiAccountDescription(targetPortalId)}`,
3961
+ triggerFailed: 'Failed to trigger preview',
3962
+ pollFailed: 'Failed to poll preview status',
3963
+ warning: 'The build succeeded but the preview failed. You can manually preview this build from the project UI.',
3964
+ missingProjectId: 'Unable to preview: could not resolve the project ID.',
3965
+ },
3207
3966
  importData: {
3208
3967
  errors: {
3209
3968
  incorrectAccountType: (derivedAccountId) => `The account ${uiAccountDescription(derivedAccountId)} is not a standard account, developer test account, or app developer account.`,
@@ -3312,6 +4071,9 @@ export const lib = {
3312
4071
  pakFailure: 'Failed to generate personal access key for developer test account',
3313
4072
  },
3314
4073
  },
4074
+ usageTracking: {
4075
+ transparencyMessage: `HubSpot CLI collects anonymous usage data to improve the product. Run ${uiCommandReference('hs config set --enable-usage-tracking=false', false)} to opt out.\n`,
4076
+ },
3315
4077
  configOptions: {
3316
4078
  enableOrDisableBooleanFieldPrompt: {
3317
4079
  message: (fieldName) => `Choose to enable or disable ${fieldName}`,
@@ -3357,7 +4119,10 @@ export const lib = {
3357
4119
  qa: 'Run command in QA mode',
3358
4120
  useEnv: 'Use environment variable config',
3359
4121
  jsonOutput: 'Format output as JSON',
4122
+ jsonSchema: 'Print the JSON output schema and exit',
4123
+ agentHelp: 'Show help with workflows and conventions for AI agents',
3360
4124
  debug: 'Set log level to debug',
4125
+ color: 'Enable colored output (use --no-color to disable)',
3361
4126
  },
3362
4127
  },
3363
4128
  configMigrate: {
@@ -3400,8 +4165,14 @@ export const lib = {
3400
4165
  promptUtils: {
3401
4166
  errors: {
3402
4167
  noSelectableChoices: 'Exiting prompt because no selectable choices are available',
4168
+ userCancelled: 'User cancelled prompt',
3403
4169
  },
3404
4170
  },
4171
+ projectProfilePrompt: {
4172
+ message: '[--profile] This project is configured to use profiles. Select a profile to use:',
4173
+ exitMessage: `This project is configured to use profiles, but no profile was specified. Try again using ${uiCommandReference('--profile')}`,
4174
+ noValidProfilesMessage: 'There are no valid profiles in this project. Ensure the accounts they are targeting are authenticated and try again.',
4175
+ },
3405
4176
  importDataFilePathPrompt: {
3406
4177
  promptContext: `To view the JSON schema for data imports, visit ${uiLink('the docs', 'https://developers.hubspot.com/docs/guides/api/crm/imports')}`,
3407
4178
  promptMessage: '[--file-path] Select the JSON file that will be used to import your data.',
@@ -3410,6 +4181,7 @@ export const lib = {
3410
4181
  message: (dataFileNames, cliAccount) => `You are importing [${dataFileNames.join(', ')}] into ${uiAccountDescription(cliAccount?.accountId)}. Continue?`,
3411
4182
  },
3412
4183
  importDataTestAccountSelectPrompt: {
4184
+ message: '[--account] Select a developer test account:',
3413
4185
  errors: {
3414
4186
  noAccountsFound: 'No accounts found.',
3415
4187
  noChildTestAccountsFound: (parentAccountId) => `No developer test accounts found under the parent account ${uiAccountDescription(parentAccountId)}`,
@@ -3425,13 +4197,15 @@ export const lib = {
3425
4197
  developerTestAccountLimit: (limit) => `Your account reached the limit of ${limit} developer test accounts.`,
3426
4198
  confirmDefaultAccount: (accountName, accountType) => `Continue testing on ${chalk.bold(`${accountName} (${accountType})`)}? (Y/n)`,
3427
4199
  confirmUseExistingDeveloperTestAccount: (accountName) => `Continue with ${accountName}? This account isn't currently connected to the HubSpot CLI. By continuing, you'll be prompted to generate a personal access key and connect it.`,
4200
+ confirmLinkExistingDeveloperTestAccount: (accountName) => `${accountName} is not linked to this directory. Would you like to link it?`,
3428
4201
  noAccountId: 'No account ID found for the selected account. Please try again.',
4202
+ fetchDeveloperTestAccountsError: 'Unable to fetch developer test accounts. Please try again.',
3429
4203
  },
3430
4204
  projectLogsPrompt: {
3431
4205
  functionName: (projectName) => `[--function] Select function in ${chalk.bold(projectName)} project`,
3432
4206
  },
3433
4207
  setAsDefaultAccountPrompt: {
3434
- setAsDefaultAccountMessage: 'Set this account as the default?',
4208
+ setAsDefaultAccountMessage: (accountName) => `Set ${accountName} as your default account? [--default]`,
3435
4209
  setAsDefaultAccount: (accountName) => `Account "${accountName}" set as the default account`,
3436
4210
  keepingCurrentDefault: (accountName) => `Account "${accountName}" will continue to be the default account`,
3437
4211
  },
@@ -3572,9 +4346,9 @@ export const lib = {
3572
4346
  },
3573
4347
  },
3574
4348
  downloadProjectPrompt: {
3575
- selectProject: 'Select a project to download:',
4349
+ selectProject: '[--project] Select a project to download:',
3576
4350
  errors: {
3577
- projectNotFound: (projectName, accountId) => `Your project ${projectName} could not be found in ${accountId}. Please select a valid project:`,
4351
+ projectNotFound: (projectName, accountId) => `[--project] Your project ${projectName} could not be found in ${uiAccountDescription(accountId)}. Please select a valid project:`,
3578
4352
  accountIdRequired: 'An account ID is required to download a project.',
3579
4353
  },
3580
4354
  },
@@ -3830,6 +4604,11 @@ export const lib = {
3830
4604
  installed: (npmVersion) => `npm v${npmVersion} is installed`,
3831
4605
  unableToDetermine: 'Unable to determine if npm is installed',
3832
4606
  },
4607
+ mcpChecks: {
4608
+ configured: (clients) => `HubSpot MCP server configured in ${clients.join(', ')}`,
4609
+ notConfigured: (clients) => `HubSpot MCP server not configured in ${clients.join(', ')}`,
4610
+ notConfiguredSecondary: `Run ${uiCommandReference('hs mcp setup')} to connect AI coding tools to HubSpot developer context`,
4611
+ },
3833
4612
  hsChecks: {
3834
4613
  notLatest: (hsVersion) => `Version ${hsVersion} outdated`,
3835
4614
  notLatestSecondary: (command, hsVersion) => `Run ${uiCommandReference(command)} to upgrade to the latest version ${hsVersion}`,
@@ -3848,9 +4627,9 @@ export const lib = {
3848
4627
  validJson: 'JSON files valid',
3849
4628
  },
3850
4629
  port: {
3851
- inUse: (port) => `Port ${port} is in use`,
3852
- inUseSecondary: `Make sure it is available before running ${uiCommandReference('hs project dev')}`,
3853
- available: (port) => `Port ${port} available for local development`,
4630
+ inUse: (port) => `Default port ${port} is in use`,
4631
+ inUseSecondary: `Make sure it is available before running ${uiCommandReference('hs project dev')}, or use ${uiCommandReference('--port')} to specify a different port`,
4632
+ available: (port) => `Default port ${port} available for local development`,
3854
4633
  },
3855
4634
  projectValidation: {
3856
4635
  valid: 'Project configuration and structure is valid',
@@ -3930,6 +4709,7 @@ export const lib = {
3930
4709
  oauth2AccessTokenNotFound: (accountId) => `The OAuth2 access token could not be found for accountId ${uiAccountDescription(accountId)}`,
3931
4710
  personalAccessKeyMissing: (accountId) => `The account "${uiAccountDescription(accountId)}" is configured to use a access key for authentication and is missing a "personalAccessKey" in the configuration file`,
3932
4711
  personalAccessKeyTokenRetrievalFailed: (accountId) => `An OAuth2 access token for account "${uiAccountDescription(accountId)} could not be retrieved using the "personalAccessKey" provided`,
4712
+ accessTokenMissing: (accountId) => `The account "${uiAccountDescription(accountId)}" is configured to use an access token for authentication and is missing an access token`,
3933
4713
  authConfigurationMissing: (accountId) => `The accountId ${uiAccountDescription(accountId)} is missing authentication configuration`,
3934
4714
  availableCMSModes: (modes) => `Available CMS publish modes are: ${modes}`,
3935
4715
  invalidCmsPublishMode: (cmsPublishMode, modesMessage) => `The CMS publish mode "${cmsPublishMode}" is invalid. ${modesMessage}`,
@@ -3941,9 +4721,10 @@ export const lib = {
3941
4721
  migrate: {
3942
4722
  componentsToBeMigrated: (components) => `${chalk.bold('The following features will be migrated:')} ${components}`,
3943
4723
  componentsThatWillNotBeMigrated: (components) => `[NOTE] These features are not yet supported for migration but will be available later: ${components}`,
4724
+ legacyCrmCardMigrationDocs: () => `For more information on migrating legacy-crm-card components, follow ${uiLink('these docs', 'https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/migrate-legacy-crm-cards-to-app-cards')}`,
3944
4725
  sourceContentsMoved: (newLocation) => `The contents of your old source directory have been moved to ${newLocation}, move any required files to the new source directory.`,
3945
4726
  projectMigrationWarningTitle: (platformVersion) => `Important: Migrating to platformVersion ${platformVersion} is irreversible`,
3946
- projectMigrationWarning: (platformVersion) => uiBetaTag(`Running the ${uiCommandReference('hs project migrate')} command will permanently upgrade your project to platformVersion ${platformVersion}. This action cannot be undone. To ensure you have access to your original files, they will be copied to a new directory (archive) for safekeeping.\n\nThis command will guide you through the process, prompting you to enter the required fields and will download the new project source code into your project source directory.`, false),
4727
+ projectMigrationWarning: (platformVersion) => uiBetaTag(`Running the ${uiCommandReference('hs project migrate')} command will permanently upgrade your project to platformVersion ${platformVersion}. This action cannot be undone. To ensure you have access to your original files, they will be copied to a new directory (archive) for safekeeping.\n\nThis command will guide you through the process, prompting you to enter the required fields and will download the new project source code into your project source directory.`),
3947
4728
  exitWithoutMigrating: 'Exiting without migrating',
3948
4729
  success: {
3949
4730
  downloadedProject: (projectName, projectDest) => `Saved ${projectName} to ${projectDest}`,
@@ -3955,7 +4736,7 @@ export const lib = {
3955
4736
  doesNotExist: (account) => `Project does not exist in ${uiAccountDescription(account)}. Migrations are only supported for existing projects.`,
3956
4737
  themesAlreadyMigrated: 'This project has already been migrated to the latest platform version.',
3957
4738
  noProjectForThemesMigration: 'Theme migrations are only supported for projects. Please try again from a project directory.',
3958
- themesAndAppsNotAllowed: 'Support for migrating projects containing both themes and apps to the latest platform version is coming soon. Try again later.',
4739
+ themesAndAppsNotAllowed: 'Projects containing both themes and apps cannot be migrated together. To migrate, split the project into separate theme-only and app-only projects, then run migrate on each individually.',
3959
4740
  multipleApps: 'Multiple apps found in project, this is not allowed in 2025.2',
3960
4741
  alreadyExists: (projectName) => `A project with name ${projectName} already exists. Please choose another name.`,
3961
4742
  failedToMigrateThemes: 'Failed to migrate project themes. Please verify that your themes are properly formatted before trying again.',
@@ -4000,6 +4781,13 @@ export const lib = {
4000
4781
  copyingProjectFilesFailed: 'Unable to copy migrated project files',
4001
4782
  },
4002
4783
  },
4784
+ cms: {
4785
+ serverlessDevRuntime: {
4786
+ installStarted: (targetVersion) => `Installing serverless-dev-runtime ${targetVersion}...`,
4787
+ installSucceeded: 'serverless-dev-runtime setup complete',
4788
+ installFailed: 'Failed to install serverless-dev-runtime',
4789
+ },
4790
+ },
4003
4791
  theme: {
4004
4792
  cmsDevServerProcess: {
4005
4793
  installStarted: (targetVersion) => `Installing cms-dev-server ${targetVersion}...`,