stacks 0.51.0 → 0.52.1

package/core/buddy/src/cli.ts

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+import { runAction } from '@stacksjs/actions'
+import { command, execSync, log, runCommand } from '@stacksjs/cli'
+import { env, frameworkVersion, isProjectCreated, parseYaml, semver } from '@stacksjs/utils'
+import { projectPath } from '@stacksjs/path'
+import { Action } from '@stacksjs/types'
+import { filesystem } from '@stacksjs/storage'
+import { build, changelog, clean, commit, create, dev, example, fresh, generate, key, lint, make, migrate, preinstall, prepublish, release, seed, setup, test, upgrade, version } from './commands'
+
+const cli = command('buddy')
+const { fs } = filesystem
+
+// setup global error handlers
+process.on('uncaughtException', errorHandler)
+process.on('unhandledRejection', errorHandler)
+
+async function main() {
+  // the following commands are not dependent on the project being initialized
+  installIfVersionMismatch()
+  await setup(cli)
+  await key(cli)
+
+  // before running any commands, check if the project is already initialized
+  if (!await isProjectCreated()) {
+    if (env('APP_ENV') !== 'production') {
+      log.info('Project not yet initialized, generating application key...')
+    }
+    else {
+      log.error('Please run `buddy key:generate` to generate an application key.')
+      process.exit()
+    }
+
+    const result = await runAction(Action.KeyGenerate, { cwd: projectPath() })
+
+    if (result.isErr()) {
+      log.error(result.error)
+      process.exit()
+    }
+
+    log.info('Application key generated.')
+
+    await create(cli)
+  }
+
+  await preinstall(cli)
+  await prepublish(cli)
+  await upgrade(cli)
+  await generate(cli)
+  await dev(cli)
+  await build(cli)
+  await changelog(cli)
+  await clean(cli)
+  await commit(cli)
+  await fresh(cli)
+  await lint(cli)
+  await release(cli)
+  await make(cli)
+  await migrate(cli)
+  await seed(cli)
+  await example(cli)
+  await test(cli)
+  await version(cli)
+
+  cli.help()
+  cli.version(await frameworkVersion())
+
+  cli.parse()
+}
+
+main()
+
+async function installIfVersionMismatch() {
+  const dependenciesYaml = fs.readFileSync(projectPath('tea.yaml'), 'utf8')
+  const dependencies = parseYaml(dependenciesYaml).dependencies
+
+  const requiredNodeVersion = dependencies['nodejs.org']
+  const requiredPnpmVersion = dependencies['pnpm.io']
+
+  const installedNodeVersion = process.version
+  const installedPnpmVersion = execSync('pnpm -v').trim()
+
+  if (!semver.satisfies(installedNodeVersion, requiredNodeVersion)) {
+    log.error(`Installed Node.js version (${installedNodeVersion}) does not satisfy required version (${requiredNodeVersion}). Installing...`)
+    await runCommand(`tea +nodejs.org${requiredNodeVersion} >/dev/null 2>&1`)
+  }
+
+  if (!semver.satisfies(installedPnpmVersion, requiredPnpmVersion)) {
+    log.error(`Installed pnpm version (${installedPnpmVersion}) does not satisfy required version (${requiredPnpmVersion}). Installing...`)
+    await runCommand(`tea +pnpm.io${requiredPnpmVersion} >/dev/null 2>&1`)
+  }
+}
+
+function errorHandler(error: Error): void {
+  log.error(error)
+  process.exit(1)
+}

package/{buddy → core/buddy}/src/commands/add.ts

@@ -1,6 +1,6 @@
 import type { AddOptions, BuildOptions, CLI } from '@stacksjs/types'
 import { ExitCode } from '@stacksjs/types'
-import { prompts } from '@stacksjs/cli'
+import { prompt } from '@stacksjs/cli'
 import { invoke } from '@stacksjs/actions/add'
 
 async function add(buddy: CLI) {
@@ -9,8 +9,8 @@ async function add(buddy: CLI) {
     table: 'Add the Table Stack to your project',
     calendar: 'Add the Calendar Stack to your project',
     all: 'Add all stacks',
+    select: 'Which stack/s are you trying to add?',
     verbose: 'Enable verbose output',
-    debug: 'Enable debug mode',
   }
 
   buddy
@@ -19,16 +19,13 @@ async function add(buddy: CLI) {
     .option('-c, --calendar', descriptions.calendar, { default: false })
     .option('-a, --all', descriptions.all, { default: false })
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     .action(async (options: BuildOptions) => {
       if (hasNoOptions(options)) {
-        const answers = await prompts.multiselect({
+        const answers = await prompt(descriptions.select, {
           type: 'multiselect',
-          name: 'add',
-          message: 'Which stack/s are you trying to add?',
-          choices: [
-            { title: 'Calendar', value: 'calendar' },
-            { title: 'Table', value: 'table' },
+          options: [
+            { label: 'Calendar', value: 'calendar' },
+            { label: 'Table', value: 'table' },
           ],
         })
 
@@ -45,7 +42,6 @@ async function add(buddy: CLI) {
     .command('add:table', descriptions.table)
     .option('-t, --table', descriptions.table, { default: true })
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     .action(async (options: BuildOptions) => {
       await invoke(options)
     })
@@ -54,7 +50,6 @@ async function add(buddy: CLI) {
     .command('add:calendar', descriptions.calendar)
     .option('-t, --calendar', descriptions.calendar, { default: true })
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     .action(async (options: BuildOptions) => {
       await invoke(options)
     })

package/{buddy → core/buddy}/src/commands/build.ts

@@ -1,6 +1,6 @@
 import type { BuildOptions, CLI } from '@stacksjs/types'
 import { Action, ExitCode } from '@stacksjs/types'
-import { intro, log, outro, prompts } from '@stacksjs/cli'
+import { intro, outro, prompt } from '@stacksjs/cli'
 import { runAction } from '@stacksjs/actions'
 
 async function build(buddy: CLI) {
@@ -13,8 +13,8 @@ async function build(buddy: CLI) {
     pages: 'Build your SSG pages',
     docs: 'Build your documentation site',
     stacks: 'Build Stacks framework',
+    select: 'What are you trying to build?',
     verbose: 'Enable verbose output',
-    debug: 'Enable debug mode',
   }
 
   buddy
@@ -28,20 +28,18 @@ async function build(buddy: CLI) {
     .option('-d, --docs', descriptions.docs)
     .option('-s, --stacks', descriptions.stacks, { default: false })
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     .action(async (options: BuildOptions) => {
       if (hasNoOptions(options)) {
-        const answers = await prompts.multiselect({
+        const answers = await prompt(descriptions.select, {
           type: 'multiselect',
-          name: 'update',
-          message: 'What are you trying to build?',
-          choices: [
-            { title: 'Components', value: 'components' },
-            { title: 'Vue Components', value: 'vue-components' },
-            { title: 'Web Components', value: 'web-components' },
-            { title: 'Functions', value: 'functions' },
-            { title: 'Pages', value: 'pages' },
-            { title: 'Documentation', value: 'docs' },
+          required: true,
+          options: [
+            { label: 'Components', value: 'components' },
+            // { label: 'Vue Components', value: 'vue-components' },
+            // { label: 'Web Components', value: 'web-components' },
+            { label: 'Functions', value: 'functions' },
+            { label: 'Pages', value: 'pages' },
+            { label: 'Documentation', value: 'docs' },
           ],
         })
 
@@ -58,8 +56,6 @@ async function build(buddy: CLI) {
     .command('build:components', 'Automagically build component libraries for production use & npm/CDN distribution')
     .option('-c, --components', descriptions.components, { default: true })
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     .action(async (options: BuildOptions) => {
       await runAction(Action.BuildComponentLibs, options)
     })
@@ -68,8 +64,6 @@ async function build(buddy: CLI) {
     .command('build:cli', 'Automagically build the CLI')
     .option('-c, --components', descriptions.components, { default: true })
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     .action(async (options: BuildOptions) => {
       await runAction(Action.BuildCli, options)
     })
@@ -78,8 +72,6 @@ async function build(buddy: CLI) {
     .command('build:functions', 'Automagically build function library for npm/CDN distribution')
     .option('-f, --functions', descriptions.functions, { default: true })
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     .action(async (options: BuildOptions) => {
       await runAction(Action.BuildFunctionLib, options)
     })
@@ -88,7 +80,6 @@ async function build(buddy: CLI) {
     .command('build:vue-components', 'Automagically build Vue component library for npm/CDN distribution')
     .option('-v, --vue-components', descriptions.vueComponents, { default: true })
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     .alias('build:vue')
     .action(async (options: BuildOptions) => {
       await runAction(Action.BuildVueComponentLib, options)
@@ -98,7 +89,6 @@ async function build(buddy: CLI) {
     .command('build:web-components', 'Automagically build Web Component library for npm/CDN distribution')
     .option('-w, --web-components', descriptions.webComponents, { default: true })
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     .alias('build:elements')
     .alias('build:wc')
     .action(async (options: BuildOptions) => {
@@ -109,7 +99,6 @@ async function build(buddy: CLI) {
     .command('build:docs', 'Automagically build your documentation site.')
     .option('-d, --docs', descriptions.docs, { default: true })
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     .action(async (options: BuildOptions) => {
       await runAction(Action.BuildDocs, options)
     })
@@ -121,10 +110,12 @@ async function build(buddy: CLI) {
       const startTime = await intro('buddy build:core')
       const result = await runAction(Action.BuildCore, options)
 
-      if (result.isErr()) {
-        log.error('Failed to build the Stacks core.', result.error)
-        process.exit()
-      }
+      console.log('result', result)
+
+      // if (result.isErr()) {
+      //   log.error('Failed to build the Stacks core.', result.error)
+      //   process.exit()
+      // }
 
       outro('Stacks core built successfully', { startTime, useSeconds: true })
     })
@@ -133,15 +124,15 @@ async function build(buddy: CLI) {
     .command('build:stacks', 'Build the Stacks framework.')
     .option('-s, --stacks', descriptions.stacks, { default: true })
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     .action(async (options: BuildOptions) => {
       const startTime = await intro('buddy build:stacks')
       const result = await runAction(Action.BuildStacks, options)
+      console.log('result', result)
 
-      if (result.isErr()) {
-        log.error('Failed to build Stacks.', result.error)
-        process.exit()
-      }
+      // if (result.isErr()) {
+      //   log.error('Failed to build Stacks.', result.error)
+      //   process.exit()
+      // }
 
       outro('Stacks built successfully', { startTime, useSeconds: true })
     })

package/{buddy → core/buddy}/src/commands/changelog.ts

@@ -7,21 +7,20 @@ async function changelog(buddy: CLI) {
   const descriptions = {
     changelog: 'Create a CHANGELOG.md file',
     verbose: 'Enable verbose output',
-    debug: 'Enable debug mode',
   }
 
   buddy
     .command('changelog', descriptions.changelog)
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     .action(async (options: FreshOptions) => {
       const perf = await intro('buddy changelog')
       const result = await runAction(Action.Changelog, options)
+      console.log('result', result)
 
-      if (result.isErr()) {
-        outro('While running the changelog command, there was an issue', { startTime: perf, useSeconds: true, isError: true }, result.error)
-        process.exit()
-      }
+      // if (result.isErr()) {
+      //   outro('While running the changelog command, there was an issue', { startTime: perf, useSeconds: true, isError: true }, result.error)
+      //   process.exit()
+      // }
 
       outro('Generated the CHANGELOG.md file.', { startTime: perf, useSeconds: true })
       process.exit(ExitCode.Success)

package/core/buddy/src/commands/clean.ts

@@ -0,0 +1,29 @@
+import type { CLI, CleanOptions } from '@stacksjs/types'
+import { runAction } from '@stacksjs/actions'
+import { intro, outro } from '@stacksjs/cli'
+import { Action, ExitCode } from '@stacksjs/types'
+
+async function clean(buddy: CLI) {
+  const descriptions = {
+    clean: 'Removes all node_modules & lock files',
+    verbose: 'Enable verbose output',
+  }
+
+  buddy
+    .command('clean', descriptions.clean)
+    .option('--verbose', descriptions.verbose, { default: false })
+    .action(async (options: CleanOptions) => {
+      const perf = await intro('buddy clean')
+      const result = await runAction(Action.Clean, { ...options, verbose: true })
+
+      if (result.isErr()) {
+        outro('While running the clean command, there was an issue', { startTime: perf, useSeconds: true, isError: true }, result.error as Error)
+        process.exit(ExitCode.FatalError)
+      }
+
+      outro('Cleaned up', { startTime: perf, useSeconds: true })
+      process.exit(ExitCode.Success)
+    })
+}
+
+export { clean }

package/{buddy → core/buddy}/src/commands/commit.ts

@@ -5,13 +5,11 @@ async function commit(buddy: CLI) {
   const descriptions = {
     commit: 'Commit your stashed changes',
     verbose: 'Enable verbose output',
-    debug: 'Enable debug mode',
   }
 
   buddy
     .command('commit', descriptions.commit)
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     .action(async (options: FreshOptions) => {
       await invoke(options)
     })

package/{buddy → core/buddy}/src/commands/create.ts

@@ -1,5 +1,5 @@
 import type { CLI, CreateOptions } from '@stacksjs/types'
-import { bold, cyan, green, intro, link, log, runCommand } from '@stacksjs/cli'
+import { bold, cyan, green, intro, log, runCommand } from '@stacksjs/cli'
 import { useOnline } from '@stacksjs/utils'
 import { isFolder } from '@stacksjs/storage'
 import { resolve } from '@stacksjs/path'
@@ -18,7 +18,6 @@ async function create(buddy: CLI) {
     api: 'Are you building an API?',
     database: 'Do you need a database?',
     verbose: 'Enable verbose output',
-    debug: 'Enable debug mode',
   }
 
   buddy
@@ -32,7 +31,6 @@ async function create(buddy: CLI) {
     .option('-a, --api', descriptions.api, { default: true }) // APIs need an HTTP server & assumes functions is true
     .option('-d, --database', descriptions.database, { default: true })
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     // .option('--auth', 'Scaffold an authentication?', { default: true })
     .action(async (options: CreateOptions) => {
       const startTime = await intro('stacks new')
@@ -52,7 +50,7 @@ async function create(buddy: CLI) {
       await install(path, options)
 
       // a custom outro
-      console.log()
+      // console.log()
 
       if (startTime) {
         const time = performance.now() - startTime
@@ -60,8 +58,8 @@ async function create(buddy: CLI) {
       }
 
       log.info(bold('Welcome to the Stacks Framework! ⚛️'))
-      console.log(`cd ${link(path, `vscode://file/${path}:1`)} && code .`)
-      console.log()
+      // console.log(`cd ${link(path, `vscode://file/${path}:1`)} && code .`)
+      // console.log()
       log.info('To learn more, visit https://stacksjs.dev')
 
       process.exit(ExitCode.Success)

package/core/buddy/src/commands/deploy.ts

@@ -0,0 +1,30 @@
+import type { CLI, DeployOptions } from '@stacksjs/types'
+import { runAction } from '@stacksjs/actions'
+import { intro, outro } from '@stacksjs/cli'
+import { Action, ExitCode } from '@stacksjs/types'
+
+async function deploy(buddy: CLI) {
+  const descriptions = {
+    deploy: 'Reinstalls your npm dependencies',
+    verbose: 'Enable verbose output',
+  }
+
+  buddy
+    .command('deploy', descriptions.deploy)
+    .option('--verbose', descriptions.verbose, { default: false })
+    .action(async (options: DeployOptions) => {
+      const perf = await intro('buddy deploy')
+      const result = await runAction(Action.Deploy, options)
+      console.log('result', result)
+
+      // if (result.isErr()) {
+      //   outro('While running the `buddy deploy`, there was an issue', { startTime: perf, useSeconds: true, isError: true }, result.error)
+      //   process.exit()
+      // }
+
+      outro('Deployment succeeded.', { startTime: perf, useSeconds: true })
+      process.exit(ExitCode.Success)
+    })
+}
+
+export { deploy }

package/{buddy → core/buddy}/src/commands/dev.ts

@@ -1,8 +1,10 @@
 import { Action, ExitCode } from '@stacksjs/types'
 import { runAction } from '@stacksjs/actions'
-import type { CLI, DevOption, DevOptions } from '@stacksjs/types'
-import { intro, log, outro, prompts } from '@stacksjs/cli'
-import { components, desktop, docs, functions, pages, invoke as startDevelopmentServer } from '@stacksjs/actions/dev'
+import type { CLI, DevOptions } from '@stacksjs/types'
+import { intro, log, outro, prompt } from '@stacksjs/cli'
+import { components, desktop, functions, pages } from '@stacksjs/actions/dev'
+
+// import { components, desktop, functions, pages, invoke as startDevelopmentServer } from '@stacksjs/actions/dev'
 
 async function dev(buddy: CLI) {
   const descriptions = {
@@ -11,8 +13,8 @@ async function dev(buddy: CLI) {
     functions: 'Start the Functions development server',
     docs: 'Start the Documentation development server',
     pages: 'Start the Pages development server',
+    select: 'Which development server are you trying to start?',
     verbose: 'Enable verbose output',
-    debug: 'Enable debug mode',
   }
 
   buddy
@@ -22,18 +24,17 @@ async function dev(buddy: CLI) {
     .option('-d, --docs', descriptions.docs)
     .option('-p, --pages', descriptions.pages)
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     .action(async (options: DevOptions) => {
       if (hasNoOptions(options)) {
-        const answer: DevOption | void = await prompts.select({
+        const answer = await prompt(descriptions.select, {
           type: 'select',
-          name: 'development',
-          message: 'Which development server are you trying to start?',
-          choices: [
-            { title: 'Components', value: 'components' },
-            { title: 'Functions', value: 'functions' },
-            { title: 'Pages', value: 'pages' },
-            { title: 'Docs', value: 'docs' },
+          required: true,
+          options: [
+            { value: 'pages', label: 'Pages' },
+            { value: 'desktop', label: 'Desktop' },
+            { value: 'components', label: 'Components' },
+            { value: 'functions', label: 'Functions' },
+            { value: 'docs', label: 'Documentation' },
           ],
         })
 
@@ -46,13 +47,13 @@ async function dev(buddy: CLI) {
           await functions(options)
         else if (answer === 'pages')
           await pages(options)
-        else if (answer === 'docs')
-          await docs(options)
+        // else if (answer === 'docs')
+          // await docs(options)
 
         else process.exit(ExitCode.InvalidArgument)
       }
 
-      await startDevelopmentServer(options)
+      // await startDevelopmentServer(options)
       process.exit(ExitCode.Success)
     })
 
@@ -68,34 +69,52 @@ async function dev(buddy: CLI) {
       // check if result is an array
       if (Array.isArray(result)) {
         // check if any of the items in the array is an error
-        if (result.some(item => item.isErr())) {
-          outro('While running the dev:components command, there was an issue', { startTime: perf, useSeconds: true, isError: true }, result.error)
-          process.exit()
-        }
+        // if (result.some(item => item.isErr())) {
+        //   outro('While running the dev:components command, there was an issue', { startTime: perf, useSeconds: true, isError: true })
+        //   process.exit()
+        // }
       }
 
       // check if result is an error
       else if (result.isErr()) {
-        outro('While running the dev:components command, there was an issue', { startTime: perf, useSeconds: true, isError: true }, result.error)
+        outro('While running the dev:components command, there was an issue', { startTime: perf, useSeconds: true, isError: true }, result.error ?? undefined)
         process.exit()
       }
 
-      outro('Finished running dev:components.', { startTime: perf, useSeconds: true })
+      console.log('')
+      outro('Exited', { startTime: perf, useSeconds: true })
       process.exit(ExitCode.Success)
     })
 
   buddy
     .command('dev:docs', descriptions.docs)
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     .action(async (options: DevOptions) => {
-      await docs(options)
+      const perf = await intro('buddy dev:docs')
+      const result = await runAction(Action.DevDocs, { ...options, verbose: true })
+
+      // check if result is an array
+      if (Array.isArray(result)) {
+        // check if any of the items in the array is an error
+        // if (result.some(item => item.isErr())) {
+        //   outro('While running the dev:docs command, there was an issue', { startTime: perf, useSeconds: true, isError: true })
+        //   process.exit()
+        // }
+      }
+
+      // check if result is an error
+      else if (result.isErr()) {
+        outro('While running the dev:components command, there was an issue', { startTime: perf, useSeconds: true, isError: true }, result.error ?? undefined)
+        process.exit()
+      }
+
+      outro('Finished running dev:docs.', { startTime: perf, useSeconds: true })
+      process.exit(ExitCode.Success)
     })
 
   buddy
     .command('dev:desktop', descriptions.desktop)
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     .action(async (options: DevOptions) => {
       await desktop(options)
     })
@@ -103,7 +122,6 @@ async function dev(buddy: CLI) {
   buddy
     .command('dev:functions', descriptions.functions)
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     .action(async (options: DevOptions) => {
       await functions(options)
     })
@@ -111,7 +129,6 @@ async function dev(buddy: CLI) {
   buddy
     .command('dev:pages', descriptions.pages)
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     .action(async (options: DevOptions) => {
       await pages(options)
     })

package/{buddy → core/buddy}/src/commands/example.ts

@@ -1,6 +1,6 @@
 import { ExitCode } from '@stacksjs/types'
-import type { CLI, ExamplesOption, ExamplesOptions } from '@stacksjs/types'
-import { italic, log, prompts } from '@stacksjs/cli'
+import type { CLI, ExamplesOptions } from '@stacksjs/types'
+import { italic, log, prompt } from '@stacksjs/cli'
 import { componentExample, invoke as runExample, webComponentExample } from '@stacksjs/actions/examples'
 
 async function example(buddy: CLI) {
@@ -9,8 +9,8 @@ async function example(buddy: CLI) {
     components: 'Test your libraries against your built bundle',
     vue: 'Test your Vue component library',
     webComponents: 'Test your web component library',
+    select: 'Which example are you trying to view?',
     verbose: 'Enable verbose output',
-    debug: 'Enable debug mode',
   }
 
   buddy
@@ -19,15 +19,13 @@ async function example(buddy: CLI) {
     .option('-v, --vue', descriptions.vue)
     .option('-w, --web-components', descriptions.webComponents)
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     .action(async (options: ExamplesOptions) => {
-      const answer: ExamplesOption = await prompts.select({
+      const answer = await prompt(descriptions.select, {
         type: 'select',
-        name: 'example',
-        message: 'Which example are you trying to view?',
-        choices: [
-          { title: 'Components', value: 'components' },
-          { title: 'Web Components', value: 'web-components' },
+        required: true,
+        options: [
+          { value: 'components', label: 'Vue Components' },
+          { value: 'web-components', label: 'Web Components' },
         ],
       })
 
@@ -50,7 +48,6 @@ async function example(buddy: CLI) {
     .command('example:vue', descriptions.vue)
     .option('-v, --vue', descriptions.verbose, { default: true })
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     .alias('example:components')
     .action(async (options: ExamplesOptions) => {
       await runExample(options)
@@ -60,7 +57,6 @@ async function example(buddy: CLI) {
     .command('example:web-components', 'Test your Web Component library.')
     .option('-w, --web-components', descriptions.verbose, { default: true })
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     .action(async (options: ExamplesOptions) => {
       await runExample(options)
     })

package/{buddy → core/buddy}/src/commands/fresh.ts

@@ -7,20 +7,18 @@ async function fresh(buddy: CLI) {
   const descriptions = {
     fresh: 'Reinstalls your npm dependencies',
     verbose: 'Enable verbose output',
-    debug: 'Enable debug mode',
   }
 
   buddy
     .command('fresh', descriptions.fresh)
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     .action(async (options: FreshOptions) => {
       const perf = await intro('buddy fresh')
-      const result = await runAction(Action.Fresh, { ...options, showSpinner: true, spinnerText: 'Freshly installing dependencies...' })
+      const result = await runAction(Action.Fresh, { ...options, verbose: true })
 
       if (result.isErr()) {
-        outro('While running the fresh command, there was an issue', { startTime: perf, useSeconds: true, isError: true }, result.error)
-        process.exit()
+        outro('While running the `fresh` command, there was an issue', { startTime: perf, useSeconds: true, isError: true }, result.error as Error)
+        process.exit(ExitCode.FatalError)
       }
 
       outro('Freshly reinstalled your dependencies.', { startTime: perf, useSeconds: true })