sim/scripts/setup/index.ts

#!/usr/bin/env bun
import { getErrorMessage } from '@sim/utils/errors'
import { runDoctor } from './doctor.ts'
import { SetupError } from './errors.ts'
import { runFeatureSetup, setupFeatureUsage } from './feature-setup.ts'
import { isLifecycleCommand, runLifecycle } from './lifecycle.ts'
import { runSetupStatus } from './setup-status.ts'
import { exitWith, restoreTerminal } from './terminal.ts'
import { theme } from './theme.ts'
import { runWizard, type WizardMode } from './wizard.ts'

const USAGE = `Usage:
  bun run setup                                run the setup wizard
  bun run setup status                         show configured capabilities and integrations
  bun run setup <feature>                      configure ${setupFeatureUsage()}
  bun run sim setup [--quick] [--mode compose|dev|k8s]
  bun run sim setup status                     show configured capabilities and integrations
  bun run sim setup <feature>                  configure one feature
  bun run sim doctor [--fix] [--json]          check your setup
  bun run sim start | stop | restart           bring your install up / down / cycle
  bun run sim update                           pull/rebuild and apply Compose images
  bun run sim status                           what's installed and healthy
  bun run sim logs                             follow logs
  bun run sim down                             remove containers (data kept)
  bun run sim reset                            archive .env + wipe managed data

Prefer a bare "sim"? Run "bun link" once, then ensure ~/.bun/bin is on your
PATH (Homebrew's bun doesn't add it): export PATH="$HOME/.bun/bin:$PATH".`

function parseMode(value: string | undefined): WizardMode {
  if (value === 'compose' || value === 'dev' || value === 'k8s') return value
  throw new Error(`invalid --mode "${value}" — expected compose, dev, or k8s`)
}

async function main(): Promise<void> {
  const args = process.argv.slice(2)
  if (args.includes('--help') || args.includes('-h')) {
    console.log(USAGE)
    return
  }
  process.on('SIGINT', () => exitWith(130))

  const command = args[0]

  // Bare `sim` prints help; the wizard is `sim setup` (or `bun run setup`).
  if (!command) {
    console.log(USAGE)
    return
  }

  if (command === 'doctor') {
    process.exitCode = await runDoctor({
      fix: args.includes('--fix'),
      json: args.includes('--json'),
    })
    return
  }

  if (isLifecycleCommand(command)) {
    await runLifecycle(command)
    return
  }

  if (command === 'setup') {
    const setupArgs = args.slice(1)
    const feature = setupArgs[0]?.startsWith('-') ? undefined : setupArgs[0]
    if (feature === 'status') {
      process.exitCode = await runSetupStatus()
      return
    }
    if (feature) {
      const featureIndex = setupArgs.indexOf(feature)
      await runFeatureSetup(feature, setupArgs.slice(featureIndex + 1))
      return
    }
    const modeIdx = setupArgs.indexOf('--mode')
    await runWizard({
      quick: setupArgs.includes('--quick'),
      mode: modeIdx === -1 ? undefined : parseMode(setupArgs[modeIdx + 1]),
    })
    return
  }

  console.error(`Unknown command: ${command}\n`)
  console.log(USAGE)
  process.exitCode = 1
}

function renderFailure(error: unknown): void {
  const hints = error instanceof SetupError ? error.hints : []
  console.error()
  console.error(`${theme.error('✗ Setup failed')}\n`)
  console.error(`  ${getErrorMessage(error).split('\n').join('\n  ')}`)
  if (hints.length > 0) {
    console.error(`\n  ${theme.heading('Try:')}`)
    for (const hint of hints) {
      console.error(`   ${theme.muted('•')} ${hint}`)
    }
  }
  console.error(
    `\n  ${theme.muted('Your progress is saved — re-run')} ${theme.command('bun run setup')} ${theme.muted('to pick up where you left off.')}`
  )
}

main()
  .catch((error) => {
    renderFailure(error)
    process.exitCode = 1
  })
  .finally(restoreTerminal)