@dimensional-innovations/tool-config 1.0.0

package/bin/setup-tool-config.js

@@ -0,0 +1,675 @@
+#!/usr/bin/env node
+
+/**
+ * @dimensional-innovations/tool-config CLI Setup Tool
+ *
+ * Interactive configuration generator for ESLint, Prettier, Stylelint, and semantic-release
+ */
+
+import { writeFileSync, existsSync, readFileSync, mkdirSync, copyFileSync } from 'fs'
+import { join, dirname } from 'path'
+import { fileURLToPath } from 'url'
+
+import prompts from 'prompts'
+
+import { autoDetect } from '../src/detectors.js'
+import { prettierIgnoreContent } from '../src/tools/prettier/index.js'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+const VERSION = '0.0.0-development'
+
+// Parse CLI arguments
+const args = process.argv.slice(2)
+const flags = {
+  help: args.includes('--help') || args.includes('-h'),
+  version: args.includes('--version') || args.includes('-v'),
+  dryRun: args.includes('--dry-run') || args.includes('-d'),
+  all: args.includes('--all') || args.includes('-a'),
+  setupCI: args.includes('--setup-ci')
+}
+
+// Check for --ci flag with optional provider
+const ciIndex = args.indexOf('--ci')
+const ciProvider =
+  ciIndex !== -1 && args[ciIndex + 1] && !args[ciIndex + 1].startsWith('-')
+    ? args[ciIndex + 1]
+    : null
+const hasCI = args.includes('--ci')
+
+// Single tool mode: setup-tool-config eslint (but not --ci provider value)
+const singleTool = args.find(arg => !arg.startsWith('-') && arg !== ciProvider)
+
+/**
+ * Show help message
+ */
+function showHelp() {
+  console.log(`
+📦 @dimensional-innovations/tool-config Setup Tool
+
+Usage:
+  setup-tool-config [tool] [options]
+
+Tools:
+  eslint          Setup ESLint only
+  prettier        Setup Prettier only
+  stylelint       Setup Stylelint only
+  semantic-release Setup semantic-release only
+
+Options:
+  --all, -a       Setup all tools (non-interactive)
+  --ci [provider] Setup CI/CD pipeline (gitlab, github, bitbucket)
+  --setup-ci      Interactive CI/CD setup
+  --dry-run, -d   Preview changes without writing files
+  --help, -h      Show this help message
+  --version, -v   Show version number
+
+Examples:
+  setup-tool-config                    # Interactive mode
+  setup-tool-config eslint             # Setup ESLint only
+  setup-tool-config --all              # Setup all tools
+  setup-tool-config --dry-run          # Preview without changes
+  setup-tool-config --ci gitlab        # Setup GitLab CI/CD
+  setup-tool-config --ci github        # Setup GitHub Actions
+  setup-tool-config --setup-ci         # Interactive CI setup
+  setup-tool-config semantic-release --ci # Setup release + CI
+
+For more information, visit:
+  https://gitlab.com/dimensional-innovations/tool-config
+`)
+}
+
+/**
+ * Show version
+ */
+function showVersion() {
+  console.log(`@dimensional-innovations/tool-config v${VERSION}`)
+}
+
+/**
+ * Generate config file content for a tool
+ */
+function generateConfigContent(tool) {
+  const configs = {
+    eslint: `import { createConfig } from '@dimensional-innovations/tool-config'
+
+export default await createConfig('eslint')
+`,
+    prettier: `import { createConfig } from '@dimensional-innovations/tool-config'
+
+export default createConfig('prettier')
+`,
+    stylelint: `import { createConfig } from '@dimensional-innovations/tool-config'
+
+export default createConfig('stylelint')
+`,
+    'semantic-release': `import { createConfig } from '@dimensional-innovations/tool-config'
+
+export default createConfig('semantic-release')
+`
+  }
+
+  return configs[tool] || ''
+}
+
+/**
+ * Get config filename for a tool
+ */
+function getConfigFilename(tool) {
+  const filenames = {
+    eslint: 'eslint.config.js',
+    prettier: 'prettier.config.js',
+    stylelint: 'stylelint.config.js',
+    'semantic-release': 'release.config.js'
+  }
+
+  return filenames[tool] || `${tool}.config.js`
+}
+
+/**
+ * Get npm scripts for a tool
+ */
+function getToolScripts(tool) {
+  const scripts = {
+    eslint: {
+      lint: 'eslint .',
+      'lint:fix': 'eslint --fix .'
+    },
+    prettier: {
+      'prettier:fix': 'prettier --write .',
+      prettier: 'prettier --check .'
+    },
+    stylelint: {
+      style: 'stylelint "**/*.css"',
+      'style:fix': 'stylelint "**/*.css" --fix'
+    },
+    'semantic-release': {
+      release: 'semantic-release'
+    }
+  }
+
+  return scripts[tool] || {}
+}
+
+/**
+ * Write config file
+ */
+function writeConfigFile(tool, cwd, dryRun = false) {
+  const filename = getConfigFilename(tool)
+  const filepath = join(cwd, filename)
+  const content = generateConfigContent(tool)
+
+  if (existsSync(filepath)) {
+    console.log(`  ⚠️  ${filename} already exists - skipping`)
+    return false
+  }
+
+  if (dryRun) {
+    console.log(`  📄 Would create: ${filename}`)
+
+    // Prettier also creates .prettierignore
+    if (tool === 'prettier') {
+      const ignoreFile = '.prettierignore'
+      const ignoreExists = existsSync(join(cwd, ignoreFile))
+      if (!ignoreExists) {
+        console.log(`  📄 Would create: ${ignoreFile}`)
+      }
+    }
+
+    return true
+  }
+
+  try {
+    writeFileSync(filepath, content, 'utf8')
+    console.log(`  ✅ Created: ${filename}`)
+
+    // Prettier also creates .prettierignore
+    if (tool === 'prettier') {
+      const ignoreFile = '.prettierignore'
+      const ignorePath = join(cwd, ignoreFile)
+
+      if (!existsSync(ignorePath)) {
+        writeFileSync(ignorePath, prettierIgnoreContent, 'utf8')
+        console.log(`  ✅ Created: ${ignoreFile}`)
+      } else {
+        console.log(`  ⚠️  ${ignoreFile} already exists - skipping`)
+      }
+    }
+
+    return true
+  } catch (error) {
+    console.error(`  ❌ Failed to create ${filename}:`, error.message)
+    return false
+  }
+}
+
+/**
+ * Update package.json with scripts
+ */
+function updatePackageJsonScripts(tools, cwd, dryRun = false) {
+  const packageJsonPath = join(cwd, 'package.json')
+
+  if (!existsSync(packageJsonPath)) {
+    console.log('  ⚠️  No package.json found - skipping script injection')
+    return
+  }
+
+  try {
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'))
+
+    if (!packageJson.scripts) {
+      packageJson.scripts = {}
+    }
+
+    const scriptsToAdd = {}
+    for (const tool of tools) {
+      const toolScripts = getToolScripts(tool)
+      for (const [name, command] of Object.entries(toolScripts)) {
+        if (!packageJson.scripts[name]) {
+          scriptsToAdd[name] = command
+        }
+      }
+    }
+
+    if (Object.keys(scriptsToAdd).length === 0) {
+      console.log('  ℹ️  All scripts already exist in package.json')
+      return
+    }
+
+    if (dryRun) {
+      console.log('  📝 Would add scripts to package.json:')
+      for (const [name, command] of Object.entries(scriptsToAdd)) {
+        console.log(`     "${name}": "${command}"`)
+      }
+      return
+    }
+
+    Object.assign(packageJson.scripts, scriptsToAdd)
+
+    writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`, 'utf8')
+
+    console.log('  ✅ Updated package.json with scripts:')
+    for (const name of Object.keys(scriptsToAdd)) {
+      console.log(`     - ${name}`)
+    }
+  } catch (error) {
+    console.error('  ❌ Failed to update package.json:', error.message)
+  }
+}
+
+/**
+ * Get CI filename and path for a git provider
+ */
+function getCIFileInfo(provider) {
+  const ciFiles = {
+    gitlab: {
+      filename: '.gitlab-ci.yml',
+      destination: '.gitlab-ci.yml',
+      template: '.gitlab-ci.yml'
+    },
+    github: {
+      filename: 'ci.yml',
+      destination: '.github/workflows/ci.yml',
+      template: 'github-workflow.yml',
+      needsDir: true
+    },
+    bitbucket: {
+      filename: 'bitbucket-pipelines.yml',
+      destination: 'bitbucket-pipelines.yml',
+      template: 'bitbucket-pipelines.yml'
+    }
+  }
+
+  return ciFiles[provider] || null
+}
+
+/**
+ * Get environment variable instructions for a git provider
+ */
+function getCIInstructions(provider) {
+  const instructions = {
+    gitlab: `
+⚠️  Configuration Required:
+  Add these CI/CD variables in GitLab Settings > CI/CD > Variables:
+  - GL_TOKEN: GitLab Personal Access Token (with api scope)
+  - NPM_TOKEN: npm authentication token
+
+  Then push to main branch to trigger automated releases.`,
+    github: `
+⚠️  Configuration Required:
+  Add these secrets in GitHub Settings > Secrets and variables > Actions:
+  - GITHUB_TOKEN: Automatically provided by GitHub Actions
+  - NPM_TOKEN: npm authentication token
+
+  Then push to main branch to trigger automated releases.`,
+    bitbucket: `
+⚠️  Configuration Required:
+  Add this repository variable in Bitbucket Settings > Pipelines > Repository variables:
+  - NPM_TOKEN: npm authentication token
+
+  Then push to main branch to trigger automated releases.`
+  }
+
+  return instructions[provider] || ''
+}
+
+/**
+ * Copy CI/CD template
+ */
+function copyCITemplate(provider, cwd, dryRun = false) {
+  if (!provider || provider === 'unknown') {
+    console.log('  ⚠️  Could not detect git provider - skipping CI setup')
+    console.log('  💡 You can manually copy templates from:')
+    console.log(
+      '     node_modules/@dimensional-innovations/tool-config/src/tools/semantic-release/templates/'
+    )
+    return false
+  }
+
+  const ciInfo = getCIFileInfo(provider)
+
+  if (!ciInfo) {
+    console.log(`  ⚠️  Unsupported git provider: ${provider}`)
+    return false
+  }
+
+  const destPath = join(cwd, ciInfo.destination)
+  const destDir = dirname(destPath)
+
+  // Check if CI file already exists
+  if (existsSync(destPath)) {
+    console.log(`  ⚠️  ${ciInfo.destination} already exists - skipping`)
+    return false
+  }
+
+  if (dryRun) {
+    console.log(`  📄 Would create: ${ciInfo.destination}`)
+    if (ciInfo.needsDir && !existsSync(destDir)) {
+      console.log(`  📁 Would create directory: ${dirname(ciInfo.destination)}`)
+    }
+    return true
+  }
+
+  try {
+    // Create directory if needed
+    if (ciInfo.needsDir && !existsSync(destDir)) {
+      mkdirSync(destDir, { recursive: true })
+      console.log(`  ✅ Created directory: ${dirname(ciInfo.destination)}`)
+    }
+
+    // Copy template
+    const templatePath = join(
+      __dirname,
+      '..',
+      'src',
+      'tools',
+      'semantic-release',
+      'templates',
+      ciInfo.template
+    )
+    copyFileSync(templatePath, destPath)
+    console.log(`  ✅ Created: ${ciInfo.destination}`)
+
+    // Show configuration instructions
+    console.log(getCIInstructions(provider))
+
+    console.log('\n  📖 For more details, see:')
+    console.log(
+      '     node_modules/@dimensional-innovations/tool-config/src/tools/semantic-release/CI_SETUP.md'
+    )
+
+    return true
+  } catch (error) {
+    console.error(`  ❌ Failed to copy CI template:`, error.message)
+    return false
+  }
+}
+
+/**
+ * Setup tools
+ */
+function setupTools(tools, cwd, dryRun = false) {
+  console.log('')
+  console.log('📝 Generating configuration files...')
+  console.log('')
+
+  for (const tool of tools) {
+    console.log(`${tool}:`)
+    writeConfigFile(tool, cwd, dryRun)
+  }
+
+  console.log('')
+  console.log('📦 Updating package.json scripts...')
+  console.log('')
+  updatePackageJsonScripts(tools, cwd, dryRun)
+}
+
+/**
+ * Main CLI function
+ */
+async function main() {
+  // Handle flags
+  if (flags.help) {
+    showHelp()
+    process.exit(0)
+  }
+
+  if (flags.version) {
+    showVersion()
+    process.exit(0)
+  }
+
+  const cwd = process.cwd()
+
+  // Show banner
+  console.log('')
+  console.log('📦 @dimensional-innovations/tool-config Setup')
+  console.log('━'.repeat(50))
+  console.log('')
+
+  // Auto-detect project
+  const detected = autoDetect(cwd)
+  console.log('🔍 Detected project configuration:')
+  console.log(`   Framework: ${detected.framework}`)
+  console.log(`   Environment: ${detected.environment}`)
+  console.log(`   TypeScript: ${detected.typescript ? 'Yes' : 'No'}`)
+  console.log(`   Git Provider: ${detected.gitProvider || 'Unknown'}`)
+  console.log('')
+
+  // Handle standalone --setup-ci flag
+  if (flags.setupCI) {
+    console.log('🚀 CI/CD Pipeline Setup')
+    console.log('')
+
+    let provider = detected.gitProvider
+
+    // If provider not detected or unknown, prompt for it
+    if (!provider || provider === 'unknown') {
+      const providerResponse = await prompts({
+        type: 'select',
+        name: 'provider',
+        message: 'Which CI/CD platform would you like to use?',
+        choices: [
+          { title: 'GitLab CI', value: 'gitlab' },
+          { title: 'GitHub Actions', value: 'github' },
+          { title: 'Bitbucket Pipelines', value: 'bitbucket' }
+        ]
+      })
+
+      if (!providerResponse.provider) {
+        console.log('❌ No provider selected. Exiting.')
+        process.exit(0)
+      }
+
+      provider = providerResponse.provider
+    }
+
+    console.log('📝 Setting up CI/CD...')
+    console.log('')
+    copyCITemplate(provider, cwd, flags.dryRun)
+
+    console.log('')
+    if (flags.dryRun) {
+      console.log('ℹ️  Dry run mode - no files were modified')
+    } else {
+      console.log('✅ CI/CD setup complete!')
+    }
+    console.log('')
+    process.exit(0)
+  }
+
+  // Handle --ci flag with provider
+  if (hasCI && ciProvider) {
+    const validProviders = ['gitlab', 'github', 'bitbucket']
+
+    if (!validProviders.includes(ciProvider)) {
+      console.error(`❌ Unknown provider: ${ciProvider}`)
+      console.error(`Valid providers: ${validProviders.join(', ')}`)
+      process.exit(1)
+    }
+
+    console.log('🚀 CI/CD Pipeline Setup')
+    console.log('')
+    console.log('📝 Setting up CI/CD...')
+    console.log('')
+    copyCITemplate(ciProvider, cwd, flags.dryRun)
+
+    console.log('')
+    if (flags.dryRun) {
+      console.log('ℹ️  Dry run mode - no files were modified')
+    } else {
+      console.log('✅ CI/CD setup complete!')
+    }
+    console.log('')
+    process.exit(0)
+  }
+
+  // Handle --all flag
+  if (flags.all) {
+    const tools = ['eslint', 'prettier', 'stylelint', 'semantic-release']
+    setupTools(tools, cwd, flags.dryRun)
+    console.log('')
+    if (flags.dryRun) {
+      console.log('ℹ️  Dry run mode - no files were modified')
+      console.log('Run without --dry-run to apply changes')
+    } else {
+      console.log('✅ Setup complete!')
+    }
+    console.log('')
+    process.exit(0)
+  }
+
+  // Handle single tool mode
+  if (singleTool) {
+    const validTools = ['eslint', 'prettier', 'stylelint', 'semantic-release']
+
+    if (!validTools.includes(singleTool)) {
+      console.error(`❌ Unknown tool: ${singleTool}`)
+      console.error(`Valid tools: ${validTools.join(', ')}`)
+      process.exit(1)
+    }
+
+    setupTools([singleTool], cwd, flags.dryRun)
+
+    // If semantic-release + --ci flag, setup CI
+    if (singleTool === 'semantic-release' && hasCI) {
+      console.log('')
+      console.log('🚀 CI/CD Pipeline Setup')
+      console.log('')
+
+      let provider = ciProvider || detected.gitProvider
+
+      // If no provider specified and can't detect, prompt
+      if (!provider || provider === 'unknown') {
+        const providerResponse = await prompts({
+          type: 'select',
+          name: 'provider',
+          message: 'Which CI/CD platform would you like to use?',
+          choices: [
+            { title: 'GitLab CI', value: 'gitlab' },
+            { title: 'GitHub Actions', value: 'github' },
+            { title: 'Bitbucket Pipelines', value: 'bitbucket' }
+          ]
+        })
+
+        if (!providerResponse.provider) {
+          console.log('⚠️  Skipping CI/CD setup.')
+          console.log('')
+          process.exit(0)
+        }
+
+        provider = providerResponse.provider
+      }
+
+      console.log('📝 Setting up CI/CD...')
+      console.log('')
+      copyCITemplate(provider, cwd, flags.dryRun)
+    }
+
+    console.log('')
+    if (flags.dryRun) {
+      console.log('ℹ️  Dry run mode - no files were modified')
+      console.log('Run without --dry-run to apply changes')
+    } else {
+      console.log('✅ Setup complete!')
+    }
+    console.log('')
+    process.exit(0)
+  }
+
+  // Interactive mode
+  const response = await prompts([
+    {
+      type: 'multiselect',
+      name: 'tools',
+      message: 'Which tools would you like to setup?',
+      choices: [
+        { title: 'ESLint (JavaScript/TypeScript linting)', value: 'eslint', selected: true },
+        { title: 'Prettier (Code formatting)', value: 'prettier', selected: true },
+        { title: 'Stylelint (CSS/style linting)', value: 'stylelint', selected: false },
+        {
+          title: 'semantic-release (Automated versioning)',
+          value: 'semantic-release',
+          selected: false
+        }
+      ],
+      hint: '- Space to select. Return to submit'
+    }
+  ])
+
+  if (!response.tools || response.tools.length === 0) {
+    console.log('')
+    console.log('❌ No tools selected. Exiting.')
+    process.exit(0)
+  }
+
+  setupTools(response.tools, cwd, flags.dryRun)
+
+  // If semantic-release selected, prompt for CI setup
+  if (response.tools.includes('semantic-release')) {
+    console.log('')
+    console.log('🚀 CI/CD Pipeline Setup')
+    console.log('')
+
+    const ciResponse = await prompts({
+      type: 'confirm',
+      name: 'setupCI',
+      message: 'Setup CI/CD pipeline for automated releases?',
+      initial: true
+    })
+
+    if (ciResponse.setupCI) {
+      let provider = detected.gitProvider
+
+      // If provider not detected or unknown, prompt for it
+      if (!provider || provider === 'unknown') {
+        const providerResponse = await prompts({
+          type: 'select',
+          name: 'provider',
+          message: 'Which CI/CD platform would you like to use?',
+          choices: [
+            { title: 'GitLab CI', value: 'gitlab' },
+            { title: 'GitHub Actions', value: 'github' },
+            { title: 'Bitbucket Pipelines', value: 'bitbucket' }
+          ]
+        })
+
+        if (!providerResponse.provider) {
+          console.log('⚠️  Skipping CI/CD setup.')
+        } else {
+          provider = providerResponse.provider
+          console.log('📝 Setting up CI/CD...')
+          console.log('')
+          copyCITemplate(provider, cwd, flags.dryRun)
+        }
+      } else {
+        console.log('📝 Setting up CI/CD...')
+        console.log('')
+        copyCITemplate(provider, cwd, flags.dryRun)
+      }
+    }
+  }
+
+  console.log('')
+  if (flags.dryRun) {
+    console.log('ℹ️  Dry run mode - no files were modified')
+    console.log('Run without --dry-run to apply changes')
+  } else {
+    console.log('✅ Setup complete!')
+    console.log('')
+    console.log('Next steps:')
+    console.log('  1. Review the generated config files')
+    console.log('  2. Install peer dependencies if needed')
+    console.log('  3. Run: npm run lint (or other added scripts)')
+  }
+  console.log('')
+}
+
+// Run CLI
+main().catch(error => {
+  console.error('')
+  console.error('❌ Error:', error.message)
+  console.error('')
+  process.exit(1)
+})