@dimensional-innovations/tool-config 2.0.0 → 3.0.0

package/README.md

@@ -39,7 +39,9 @@ npm install --save-dev @dimensional-innovations/tool-config
 - 📦 **All-In-One** - All plugins and parsers included as dependencies
 - 🔧 **Customizable** - Override any setting while keeping smart defaults
 - 🚀 **Modern** - ESLint 9+ flat config, TypeScript with tsgo support (10x faster)
-- ✅ **Battle-Tested** - 535 tests with 100% coverage
+- 🔄 **Uninstall Support** - Clean removal with safety checks for modified files
+- 🎬 **Smart Scripts** - Auto-generated `check-all` script runs tools in optimal order
+- ✅ **Battle-Tested** - 556 tests with 100% coverage
 
 ## Quick Start
 
@@ -121,11 +123,14 @@ That's it! The configs will automatically detect your framework and TypeScript s
     "style": "stylelint '**/*.css'",
     "style:fix": "stylelint '**/*.css' --fix",
     "typecheck": "tsc --noEmit",
-    "typecheck:watch": "tsc --noEmit --watch"
+    "typecheck:watch": "tsc --noEmit --watch",
+    "check-all": "npm run prettier && npm run style && npm run lint && npm run typecheck"
   }
 }
 ```
 
+**Tip:** The CLI automatically adds a `check-all` script when you setup multiple tools. This runs all validation tools in the optimal order: formatting → styles → linting → type checking.
+
 ## Supported Frameworks
 
 | Framework | ESLint | Prettier | Stylelint           | TypeScript      | Auto-Detect |
@@ -419,22 +424,68 @@ npx @dimensional-innovations/tool-config
 - Choose which tools to configure
 - Auto-detects framework and TypeScript
 - Creates config files automatically
-- Adds npm scripts to package.json
-- **NEW:** Automated CI/CD pipeline setup
+- Adds npm scripts to package.json (including `check-all` for multiple tools)
+- Automated CI/CD pipeline setup
+- **Uninstall support** - Clean removal of configs and scripts
 - Supports dry-run mode
 
-**Options:**
+**Setup Options:**
 
 ```bash
+# Interactive mode
+npx @dimensional-innovations/tool-config                 # Choose tools interactively
+
+# Single tool setup
 npx @dimensional-innovations/tool-config eslint          # Setup ESLint only
-npx @dimensional-innovations/tool-config --all           # Setup all tools
-npx @dimensional-innovations/tool-config --dry-run       # Preview without creating files
+npx @dimensional-innovations/tool-config prettier        # Setup Prettier only
+npx @dimensional-innovations/tool-config stylelint       # Setup Stylelint only
+
+# Setup all tools
+npx @dimensional-innovations/tool-config --all           # Setup all tools at once
+
+# CI/CD setup
 npx @dimensional-innovations/tool-config --ci gitlab     # Setup GitLab CI/CD
 npx @dimensional-innovations/tool-config --ci github     # Setup GitHub Actions
 npx @dimensional-innovations/tool-config --setup-ci      # Interactive CI setup
+
+# Preview mode
+npx @dimensional-innovations/tool-config --dry-run       # Preview without creating files
+
+# Help
 npx @dimensional-innovations/tool-config --help          # Show all options
 ```
 
+**Uninstall Options:**
+
+```bash
+# Interactive uninstall
+npx @dimensional-innovations/tool-config --uninstall     # Choose which tools to remove
+
+# Uninstall specific tool
+npx @dimensional-innovations/tool-config --uninstall eslint
+
+# Uninstall all detected tools
+npx @dimensional-innovations/tool-config --uninstall --all
+
+# Remove CI/CD configuration
+npx @dimensional-innovations/tool-config --uninstall --ci
+
+# Preview uninstall
+npx @dimensional-innovations/tool-config --uninstall --dry-run
+```
+
+**Safety Features:**
+
+The uninstall command includes safety features to protect your customizations:
+
+- Only removes files that match the original generated templates
+- Skips modified configuration files (warns you instead)
+- Only removes auto-generated package.json scripts
+- Preserves custom scripts with the same names
+- Supports dry-run to preview what will be removed
+- Cleans up empty directories (e.g., `.github/workflows`)
+- Idempotent - safe to run multiple times
+
 **CI/CD Integration:**
 
 When you select `semantic-release` in interactive mode, the CLI will automatically prompt you to setup CI/CD for automated releases. Or use the `--ci` flag to setup CI/CD directly:

package/bin/lib/formatting.js

@@ -0,0 +1,103 @@
+/**
+ * Formatting utilities for CLI output
+ * Standardized box drawing with consistent width
+ */
+
+import pc from 'picocolors'
+
+const BOX_WIDTH = 70 // Standard width for all boxes
+
+export const BOX = {
+  topLeft: '┌',
+  topRight: '┐',
+  bottomLeft: '└',
+  bottomRight: '┘',
+  vertical: '│',
+  horizontal: '─',
+  separator: '━',
+  width: BOX_WIDTH
+}
+
+/**
+ * Create a box with standard width (70 chars)
+ * @param {string[]} lines - Array of content lines
+ * @param {string} title - Optional title for top border
+ * @returns {string} Formatted box
+ */
+export function createBox(lines, title = '') {
+  const width = BOX.width
+  const contentWidth = width - 4 // Remove: │ + space + space + │
+
+  // Create top border
+  let top
+  if (title) {
+    const titlePart = `─ ${title} `
+    const remaining = width - 2 - titlePart.length // -2 for corners
+    top = BOX.topLeft + titlePart + BOX.horizontal.repeat(remaining) + BOX.topRight
+  } else {
+    top = BOX.topLeft + BOX.horizontal.repeat(width - 2) + BOX.topRight
+  }
+
+  // Create content lines - pad each to exact width
+  const content = lines.map(line => {
+    const padded = line.slice(0, contentWidth).padEnd(contentWidth)
+    return `${BOX.vertical} ${padded} ${BOX.vertical}`
+  })
+
+  // Create bottom border
+  const bottom = BOX.bottomLeft + BOX.horizontal.repeat(width - 2) + BOX.bottomRight
+
+  return [top, ...content, bottom].join('\n')
+}
+
+/**
+ * Create a separator line
+ * @returns {string} Separator line
+ */
+export function createSeparator() {
+  return BOX.separator.repeat(BOX.width)
+}
+
+/**
+ * Create a simple indented list
+ * @param {string[]} items - Array of items
+ * @param {string} bullet - Bullet character (default: '•')
+ * @returns {string} Formatted list
+ */
+export function createList(items, bullet = '•') {
+  return items.map(item => `   ${bullet} ${item}`).join('\n')
+}
+
+/**
+ * Create a progress indicator
+ * @param {number} current - Current step
+ * @param {number} total - Total steps
+ * @param {string} label - Label for this step
+ * @returns {string} Progress line
+ */
+export function createProgress(current, total, label) {
+  return `  [${current}/${total}] ${label}`
+}
+
+/**
+ * Color symbols for CLI output
+ */
+export const SYMBOLS = {
+  success: pc.green('✓'),
+  warning: pc.yellow('⚠'),
+  error: pc.red('✗'),
+  info: pc.blue('ℹ')
+}
+
+/**
+ * Color helper functions
+ */
+export const colors = {
+  success: pc.green,
+  warning: pc.yellow,
+  error: pc.red,
+  info: pc.blue,
+  dim: pc.dim,
+  bold: pc.bold,
+  cyan: pc.cyan
+}

package/bin/lib/package-manager.js

@@ -112,3 +112,90 @@ export function updatePackageJsonScripts(tools, getScriptsFn, context) {
     console.error('  ❌ Failed to update package.json:', error.message)
   }
 }
+
+/**
+ * Remove scripts from package.json for tools
+ * @param {string[]} tools - Array of tool names to remove scripts for
+ * @param {Function} getScriptsFn - Function that returns scripts for a tool: (tool, detected) => object
+ * @param {Object} context - Context object with {detected, cwd, dryRun}
+ */
+export function removePackageJsonScripts(tools, getScriptsFn, context) {
+  const { detected, cwd, dryRun = false } = context
+  const packageJsonPath = join(cwd, 'package.json')
+
+  if (!existsSync(packageJsonPath)) {
+    console.log('  ℹ️  No package.json found - skipping script removal')
+    return
+  }
+
+  try {
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'))
+
+    if (!packageJson.scripts) {
+      console.log('  ℹ️  No scripts section in package.json')
+      return
+    }
+
+    const scriptsToRemove = []
+
+    // Collect script names to remove based on tools
+    for (const tool of tools) {
+      const toolScripts = getScriptsFn(tool, detected)
+      for (const scriptName of Object.keys(toolScripts)) {
+        const expectedCommand = toolScripts[scriptName]
+        const actualCommand = packageJson.scripts[scriptName]
+
+        // Only remove if the script exists and matches our expected command
+        if (actualCommand === expectedCommand) {
+          scriptsToRemove.push(scriptName)
+        } else if (actualCommand) {
+          console.log(`  ⚠️  Script "${scriptName}" has been modified - skipping for safety`)
+        }
+      }
+    }
+
+    // Handle check-all script separately
+    const checkAllScript = packageJson.scripts['check-all']
+    if (checkAllScript) {
+      // Only remove if it's auto-generated (follows npm run X && npm run Y pattern)
+      const isAutoGenerated =
+        checkAllScript.startsWith('npm run') && checkAllScript.includes(' && npm run')
+
+      if (isAutoGenerated) {
+        scriptsToRemove.push('check-all')
+      }
+    }
+
+    if (scriptsToRemove.length === 0) {
+      console.log('  ℹ️  No scripts to remove from package.json')
+      return
+    }
+
+    if (dryRun) {
+      console.log('  📝 Would remove scripts from package.json:')
+      for (const name of scriptsToRemove) {
+        console.log(`     - ${name}`)
+      }
+      return
+    }
+
+    // Remove scripts
+    for (const scriptName of scriptsToRemove) {
+      delete packageJson.scripts[scriptName]
+    }
+
+    // Remove scripts section if empty
+    if (Object.keys(packageJson.scripts).length === 0) {
+      delete packageJson.scripts
+    }
+
+    writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`, 'utf8')
+
+    console.log('  ✅ Removed scripts from package.json:')
+    for (const name of scriptsToRemove) {
+      console.log(`     - ${name}`)
+    }
+  } catch (error) {
+    console.error('  ❌ Failed to update package.json:', error.message)
+  }
+}

package/bin/lib/ui.js

@@ -3,6 +3,8 @@
  * Handles help text, banners, and output formatting
  */
 
+import { createBox, createSeparator, SYMBOLS, colors } from './formatting.js'
+
 const VERSION = '0.0.0-development'
 
 /**
@@ -26,11 +28,12 @@ Options:
   --all, -a       Setup all tools (non-interactive)
   --ci [provider] Setup CI/CD pipeline (gitlab, github, bitbucket)
   --setup-ci      Interactive CI/CD setup
+  --uninstall     Remove tool configuration and scripts
   --dry-run, -d   Preview changes without writing files
   --help, -h      Show this help message
   --version, -v   Show version number
 
-Examples:
+Examples (Install):
   setup-tool-config                    # Interactive mode
   setup-tool-config eslint             # Setup ESLint only
   setup-tool-config --all              # Setup all tools
@@ -40,6 +43,13 @@ Examples:
   setup-tool-config --setup-ci         # Interactive CI setup
   setup-tool-config semantic-release --ci # Setup release + CI
 
+Examples (Uninstall):
+  setup-tool-config --uninstall        # Interactive uninstall
+  setup-tool-config --uninstall eslint # Remove ESLint only
+  setup-tool-config --uninstall --all  # Remove all detected tools
+  setup-tool-config --uninstall --ci   # Remove CI/CD configuration
+  setup-tool-config --uninstall --dry-run # Preview uninstall
+
 For more information, visit:
   https://gitlab.com/dimensional-innovations/tool-config
 `)
@@ -53,19 +63,40 @@ export function showVersion() {
 }
 
 /**
- * Show setup banner with detected configuration
+ * Show welcome and setup banner with detected configuration
  */
 export function showBanner(detected) {
   console.log('')
-  console.log('📦 @dimensional-innovations/tool-config Setup')
-  console.log('━'.repeat(50))
+
+  // Welcome box
+  const welcome = [
+    '🚀 Welcome to @dimensional-innovations/tool-config',
+    '',
+    'Zero-config setup for ESLint, Prettier, Stylelint,',
+    'TypeScript, and semantic-release.',
+    '',
+    '💡 Navigation: ↑↓ to move, Space to select, Enter to continue'
+  ]
+  console.log(createBox(welcome))
+
+  console.log('')
+
+  // Condensed detection info
+  const detectedParts = []
+  if (detected.framework !== 'vanilla') {
+    detectedParts.push(detected.framework.charAt(0).toUpperCase() + detected.framework.slice(1))
+  }
+  if (detected.typescript) {
+    detectedParts.push('TypeScript')
+  }
+  if (detected.environment) {
+    detectedParts.push(detected.environment.charAt(0).toUpperCase() + detected.environment.slice(1))
+  }
+
+  const detectedStr = detectedParts.length > 0 ? detectedParts.join(' • ') : 'JavaScript project'
+  console.log(`🔍 Auto-detected: ${detectedStr}`)
   console.log('')
-  console.log('🔍 Detected project configuration:')
-  console.log(`   Framework: ${detected.framework}`)
-  console.log(`   Environment: ${detected.environment}`)
-  console.log(`   TypeScript: ${detected.typescript ? 'Yes' : 'No'}`)
-  console.log(`   Electron: ${detected.electron ? 'Yes' : 'No'}`)
-  console.log(`   Git Provider: ${detected.gitProvider || 'Unknown'}`)
+  console.log('💡 Recommended tools are pre-selected based on your project')
   console.log('')
 }
 
@@ -79,21 +110,70 @@ export function showSection(title) {
 }
 
 /**
- * Show completion message
+ * Show completion message with detailed summary
+ * @param {boolean} dryRun - Whether this was a dry run
+ * @param {string[]} createdFiles - Files that were created
+ * @param {string[]} scripts - Scripts that were added
  */
-export function showCompletion(dryRun) {
+export function showCompletion(dryRun, createdFiles = [], scripts = []) {
   console.log('')
+
   if (dryRun) {
-    console.log('ℹ️  Dry run mode - no files were modified')
-    console.log('Run without --dry-run to apply changes')
+    console.log(createSeparator())
+    console.log('')
+    const dryRunMsg = [
+      `${SYMBOLS.info} DRY RUN MODE - Preview only, no files created`,
+      '',
+      'Run without --dry-run to create these files'
+    ]
+    console.log(createBox(dryRunMsg))
   } else {
-    console.log('✅ Setup complete!')
+    console.log(createSeparator())
     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)')
+
+    const completion = [colors.bold(colors.cyan('🎉 All done! Your project is ready.'))]
+
+    if (createdFiles.length > 0) {
+      completion.push('')
+      completion.push(
+        `📁 Created ${createdFiles.length} config file${createdFiles.length > 1 ? 's' : ''}:`
+      )
+      createdFiles.forEach(file => {
+        completion.push(`   • ${file}`)
+      })
+    }
+
+    if (scripts.length > 0) {
+      completion.push('')
+      completion.push(`📦 Added ${scripts.length} npm script${scripts.length > 1 ? 's' : ''}:`)
+
+      // Highlight check-all if present
+      const checkAllIndex = scripts.indexOf('check-all')
+      if (checkAllIndex !== -1) {
+        completion.push(`   • check-all  ← Run this to validate everything`)
+        scripts
+          .filter(s => s !== 'check-all')
+          .forEach(script => {
+            completion.push(`   • ${script}`)
+          })
+      } else {
+        scripts.forEach(script => {
+          completion.push(`   • ${script}`)
+        })
+      }
+    }
+
+    completion.push('')
+    completion.push('🚀 Quick start:')
+    if (scripts.includes('check-all')) {
+      completion.push('   npm run check-all')
+    } else if (scripts.length > 0) {
+      completion.push(`   npm run ${scripts[0]}`)
+    }
+
+    console.log(createBox(completion))
   }
+
   console.log('')
 }
 
@@ -103,9 +183,57 @@ export function showCompletion(dryRun) {
 export function showCICompletion(dryRun) {
   console.log('')
   if (dryRun) {
-    console.log('ℹ️  Dry run mode - no files were modified')
+    console.log(`${SYMBOLS.info} Dry run mode - no files were modified`)
+  } else {
+    console.log(`${SYMBOLS.success} CI/CD setup complete!`)
+  }
+  console.log('')
+}
+
+/**
+ * Show uninstall banner
+ */
+export function showUninstallBanner(installedTools, installedCI) {
+  console.log('')
+  console.log('🗑️  @dimensional-innovations/tool-config Uninstall')
+  console.log('━'.repeat(50))
+  console.log('')
+  console.log('⚠️  WARNING: This will remove configuration files and scripts')
+  console.log('   Make sure you have committed or backed up your changes first!')
+  console.log('')
+
+  if (installedTools.length > 0) {
+    console.log('📦 Detected tools:')
+    for (const tool of installedTools) {
+      console.log(`   - ${tool}`)
+    }
+    console.log('')
+  }
+
+  if (installedCI) {
+    console.log(`🚀 Detected CI/CD: ${installedCI}`)
+    console.log('')
+  }
+
+  if (installedTools.length === 0 && !installedCI) {
+    console.log('ℹ️  No tools or CI configuration detected')
+    console.log('')
+  }
+}
+
+/**
+ * Show uninstall completion message
+ */
+export function showUninstallCompletion(dryRun, removedCount) {
+  console.log('')
+  if (dryRun) {
+    console.log(`${SYMBOLS.info} Dry run mode - no files were modified`)
+    console.log('   Run without --dry-run to apply changes')
+  } else if (removedCount > 0) {
+    console.log(`${SYMBOLS.success} Uninstall complete!`)
+    console.log(`   Removed ${removedCount} file(s) and their associated scripts`)
   } else {
-    console.log('✅ CI/CD setup complete!')
+    console.log(`${SYMBOLS.info} Nothing was removed`)
   }
   console.log('')
 }

package/bin/lib/uninstall.js

@@ -0,0 +1,199 @@
+/**
+ * Uninstall utilities for setup-tool-config CLI
+ * Handles safe removal of config files, CI templates, and scripts
+ */
+
+import { existsSync, readdirSync, readFileSync, rmSync } from 'fs'
+import { join } from 'path'
+
+/**
+ * Detect which tools are currently installed
+ * @param {string} cwd - Current working directory
+ * @returns {string[]} Array of installed tool names
+ */
+export function detectInstalledTools(cwd) {
+  const toolFiles = {
+    eslint: 'eslint.config.js',
+    prettier: 'prettier.config.js',
+    stylelint: 'stylelint.config.js',
+    typescript: 'tsconfig.json',
+    'semantic-release': 'release.config.js'
+  }
+
+  const installed = []
+  for (const [tool, filename] of Object.entries(toolFiles)) {
+    if (existsSync(join(cwd, filename))) {
+      installed.push(tool)
+    }
+  }
+
+  return installed
+}
+
+/**
+ * Detect which CI provider is installed
+ * @param {string} cwd - Current working directory
+ * @returns {string|null} Provider name or null
+ */
+export function detectInstalledCI(cwd) {
+  const ciFiles = {
+    gitlab: '.gitlab-ci.yml',
+    github: '.github/workflows/ci.yml',
+    bitbucket: 'bitbucket-pipelines.yml'
+  }
+
+  for (const [provider, filepath] of Object.entries(ciFiles)) {
+    if (existsSync(join(cwd, filepath))) {
+      return provider
+    }
+  }
+
+  return null
+}
+
+/**
+ * Check if a file's content matches the expected template
+ * @param {string} filepath - Path to file
+ * @param {string} expectedContent - Expected content
+ * @returns {boolean} True if content matches
+ */
+function contentMatches(filepath, expectedContent) {
+  if (!existsSync(filepath)) {
+    return false
+  }
+
+  try {
+    const actualContent = readFileSync(filepath, 'utf8')
+    return actualContent.trim() === expectedContent.trim()
+  } catch {
+    return false
+  }
+}
+
+/**
+ * Uninstall a tool by removing its config file
+ * @param {string} _tool - Tool name
+ * @param {Object} handler - Tool handler with getConfigFilename and generateConfigContent
+ * @param {string} cwd - Current working directory
+ * @param {boolean} dryRun - Preview mode
+ * @returns {boolean} True if uninstalled successfully
+ */
+export function uninstallTool(_tool, handler, cwd, dryRun = false) {
+  const filename = handler.getConfigFilename()
+  const filepath = join(cwd, filename)
+
+  if (!existsSync(filepath)) {
+    console.log(`  ℹ️  ${filename} not found - already uninstalled`)
+    return false
+  }
+
+  // Check if file was modified by user
+  const expectedContent = handler.generateConfigContent()
+  const isUnmodified = contentMatches(filepath, expectedContent)
+
+  if (!isUnmodified) {
+    console.log(`  ⚠️  ${filename} has been modified - skipping for safety`)
+    console.log('     Remove manually if you want to delete it')
+    return false
+  }
+
+  if (dryRun) {
+    console.log(`  🗑️  Would remove: ${filename}`)
+    return true
+  }
+
+  try {
+    rmSync(filepath)
+    console.log(`  ✅ Removed: ${filename}`)
+    return true
+  } catch (error) {
+    console.error(`  ❌ Failed to remove ${filename}:`, error.message)
+    return false
+  }
+}
+
+/**
+ * Uninstall CI/CD configuration
+ * @param {string} provider - CI provider (gitlab, github, bitbucket)
+ * @param {string} cwd - Current working directory
+ * @param {boolean} dryRun - Preview mode
+ * @returns {boolean} True if uninstalled successfully
+ */
+export function uninstallCIConfig(provider, cwd, dryRun = false) {
+  const ciPaths = {
+    gitlab: '.gitlab-ci.yml',
+    github: '.github/workflows/ci.yml',
+    bitbucket: 'bitbucket-pipelines.yml'
+  }
+
+  const ciPath = ciPaths[provider]
+  if (!ciPath) {
+    console.log(`  ⚠️  Unknown provider: ${provider}`)
+    return false
+  }
+
+  const filepath = join(cwd, ciPath)
+
+  if (!existsSync(filepath)) {
+    console.log(`  ℹ️  ${ciPath} not found - already uninstalled`)
+    return false
+  }
+
+  if (dryRun) {
+    console.log(`  🗑️  Would remove: ${ciPath}`)
+    if (provider === 'github') {
+      console.log(`  🗑️  Would clean up empty directories if needed`)
+    }
+    return true
+  }
+
+  try {
+    rmSync(filepath)
+    console.log(`  ✅ Removed: ${ciPath}`)
+
+    // Clean up empty directories for GitHub
+    if (provider === 'github') {
+      cleanupGitHubDirectories(cwd)
+    }
+
+    return true
+  } catch (error) {
+    console.error(`  ❌ Failed to remove ${ciPath}:`, error.message)
+    return false
+  }
+}
+
+/**
+ * Clean up empty GitHub directories
+ * @param {string} cwd - Current working directory
+ */
+function cleanupGitHubDirectories(cwd) {
+  const workflowDir = join(cwd, '.github/workflows')
+  const githubDir = join(cwd, '.github')
+
+  // Remove .github/workflows if empty
+  if (existsSync(workflowDir)) {
+    try {
+      const files = readdirSync(workflowDir)
+      if (files.length === 0) {
+        rmSync(workflowDir, { recursive: true })
+        console.log(`  ✅ Removed empty directory: .github/workflows`)
+      }
+    } catch {
+      // Ignore cleanup errors
+    }
+  }
+
+  // Remove .github if empty
+  if (existsSync(githubDir)) {
+    try {
+      const files = readdirSync(githubDir)
+      if (files.length === 0) {
+        rmSync(githubDir, { recursive: true })
+        console.log(`  ✅ Removed empty directory: .github`)
+      }
+    } catch {
+      // Ignore cleanup errors
+    }
+  }
+}

package/bin/setup-tool-config.js

@@ -16,15 +16,23 @@ import * as prettierHandler from './lib/handlers/prettier.js'
 import * as semanticReleaseHandler from './lib/handlers/semantic-release.js'
 import * as stylelintHandler from './lib/handlers/stylelint.js'
 import * as typescriptHandler from './lib/handlers/typescript.js'
-import { updatePackageJsonScripts } from './lib/package-manager.js'
+import { removePackageJsonScripts, updatePackageJsonScripts } from './lib/package-manager.js'
 import {
   showBanner,
   showCICompletion,
   showCompletion,
   showHelp,
   showSection,
+  showUninstallBanner,
+  showUninstallCompletion,
   showVersion
 } from './lib/ui.js'
+import {
+  detectInstalledCI,
+  detectInstalledTools,
+  uninstallCIConfig,
+  uninstallTool
+} from './lib/uninstall.js'
 import { VALID_TOOLS, validateProvider, validateTool } from './lib/validators.js'
 
 // Tool handler registry
@@ -46,27 +54,59 @@ function getToolScripts(tool, detected) {
 
 /**
  * Setup tools
+ * @returns {Object} Summary of created files and scripts
  */
 async function setupTools(tools, detected, cwd, dryRun = false) {
-  showSection('📝 Generating configuration files...')
+  const { createProgress, SYMBOLS, colors } = await import('./lib/formatting.js')
+
+  console.log('')
+  console.log('Creating configuration files...')
+  console.log('')
 
   // Track which tools successfully created configs
   const successfulTools = []
+  const createdFiles = []
 
+  let current = 0
   for (const tool of tools) {
-    console.log(`${tool}:`)
+    current++
     const handler = TOOL_HANDLERS[tool]
+    const filename = handler.getConfigFilename()
+
+    const progressLine = colors.dim(createProgress(current, tools.length, filename))
+    process.stdout.write(progressLine)
+
     const success = await handler.writeConfig(cwd, detected, dryRun)
+
     if (success) {
       successfulTools.push(tool)
+      createdFiles.push(filename)
+      console.log(` ${SYMBOLS.success}`)
+    } else {
+      console.log(` ${SYMBOLS.warning}`)
     }
   }
 
   // Only add scripts for tools that created configs
+  const addedScripts = []
   if (successfulTools.length > 0) {
-    showSection('📦 Updating package.json scripts...')
+    console.log('')
+    console.log('Adding npm scripts...')
+    console.log('')
+
+    // Collect all scripts that will be added
+    for (const tool of successfulTools) {
+      const scripts = getToolScripts(tool, detected)
+      addedScripts.push(...Object.keys(scripts))
+    }
+
     updatePackageJsonScripts(successfulTools, getToolScripts, { detected, cwd, dryRun })
   }
+
+  return {
+    files: createdFiles,
+    scripts: addedScripts
+  }
 }
 
 /**
@@ -97,9 +137,10 @@ async function setupCI(detected, cwd, dryRun, ciProvider = null) {
 
   // If provider not detected or unknown, prompt for it
   if (!provider || provider === 'unknown') {
+    const { SYMBOLS } = await import('./lib/formatting.js')
     provider = await promptForProvider()
     if (!provider) {
-      console.log('⚠️  Skipping CI/CD setup.')
+      console.log(`${SYMBOLS.warning} Skipping CI/CD setup.`)
       console.log('')
       return
     }
@@ -111,6 +152,32 @@ async function setupCI(detected, cwd, dryRun, ciProvider = null) {
   showCICompletion(dryRun)
 }
 
+/**
+ * Uninstall tools
+ */
+function uninstallTools(tools, detected, cwd, dryRun = false) {
+  showSection('🗑️  Removing configuration files...')
+
+  let removedCount = 0
+
+  for (const tool of tools) {
+    console.log(`${tool}:`)
+    const handler = TOOL_HANDLERS[tool]
+    const success = uninstallTool(tool, handler, cwd, dryRun)
+    if (success) {
+      removedCount++
+    }
+  }
+
+  // Remove scripts for successfully uninstalled tools
+  if (tools.length > 0) {
+    showSection('📦 Removing package.json scripts...')
+    removePackageJsonScripts(tools, getToolScripts, { detected, cwd, dryRun })
+  }
+
+  return removedCount
+}
+
 /**
  * Main CLI function
  */
@@ -122,7 +189,8 @@ async function main() {
     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')
+    setupCI: args.includes('--setup-ci'),
+    uninstall: args.includes('--uninstall')
   }
 
   // Check for --ci flag with optional provider
@@ -149,6 +217,102 @@ async function main() {
 
   const cwd = process.cwd()
 
+  // Handle uninstall mode
+  if (flags.uninstall) {
+    const detected = autoDetect(cwd)
+    const installedTools = detectInstalledTools(cwd)
+    const installedCI = detectInstalledCI(cwd)
+
+    showUninstallBanner(installedTools, installedCI)
+
+    // No tools or CI detected
+    if (installedTools.length === 0 && !installedCI) {
+      console.log('Nothing to uninstall.')
+      process.exit(0)
+    }
+
+    // Handle --uninstall --ci flag
+    if (hasCI) {
+      if (!installedCI) {
+        console.log('⚠️  No CI/CD configuration detected')
+        process.exit(0)
+      }
+
+      showSection('🗑️  Removing CI/CD configuration...')
+      const success = uninstallCIConfig(installedCI, cwd, flags.dryRun)
+      showUninstallCompletion(flags.dryRun, success ? 1 : 0)
+      process.exit(0)
+    }
+
+    // Handle --uninstall --all flag
+    if (flags.all) {
+      if (installedTools.length === 0) {
+        console.log('⚠️  No tools detected to uninstall')
+        process.exit(0)
+      }
+
+      const removedCount = uninstallTools(installedTools, detected, cwd, flags.dryRun)
+      showUninstallCompletion(flags.dryRun, removedCount)
+      process.exit(0)
+    }
+
+    // Handle --uninstall <tool> flag
+    if (singleTool) {
+      if (!installedTools.includes(singleTool)) {
+        console.log(`⚠️  ${singleTool} is not installed`)
+        process.exit(0)
+      }
+
+      const removedCount = uninstallTools([singleTool], detected, cwd, flags.dryRun)
+      showUninstallCompletion(flags.dryRun, removedCount)
+      process.exit(0)
+    }
+
+    // Interactive uninstall mode
+    if (installedTools.length === 0) {
+      console.log('⚠️  No tools detected to uninstall')
+      process.exit(0)
+    }
+
+    const response = await prompts({
+      type: 'multiselect',
+      name: 'tools',
+      message: 'Which tools would you like to uninstall?',
+      choices: installedTools.map(tool => ({
+        title: tool,
+        value: tool,
+        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)
+    }
+
+    const removedCount = uninstallTools(response.tools, detected, cwd, flags.dryRun)
+
+    // Ask about CI removal if detected
+    if (installedCI) {
+      const ciResponse = await prompts({
+        type: 'confirm',
+        name: 'removeCI',
+        message: `Remove ${installedCI} CI/CD configuration?`,
+        initial: false
+      })
+
+      if (ciResponse.removeCI) {
+        showSection('🗑️  Removing CI/CD configuration...')
+        uninstallCIConfig(installedCI, cwd, flags.dryRun)
+      }
+    }
+
+    showUninstallCompletion(flags.dryRun, removedCount)
+    process.exit(0)
+  }
+
   // Show banner and auto-detect
   const detected = autoDetect(cwd)
   showBanner(detected)
@@ -168,22 +332,22 @@ async function main() {
 
   // Handle --all flag
   if (flags.all) {
-    await setupTools(VALID_TOOLS, detected, cwd, flags.dryRun)
-    showCompletion(flags.dryRun)
+    const summary = await setupTools(VALID_TOOLS, detected, cwd, flags.dryRun)
+    showCompletion(flags.dryRun, summary.files, summary.scripts)
     process.exit(0)
   }
 
   // Handle single tool mode
   if (singleTool) {
     validateTool(singleTool)
-    await setupTools([singleTool], detected, cwd, flags.dryRun)
+    const summary = await setupTools([singleTool], detected, cwd, flags.dryRun)
 
     // If semantic-release + --ci flag, setup CI
     if (singleTool === 'semantic-release' && hasCI) {
       await setupCI(detected, cwd, flags.dryRun, ciProvider)
     }
 
-    showCompletion(flags.dryRun)
+    showCompletion(flags.dryRun, summary.files, summary.scripts)
     process.exit(0)
   }
 
@@ -192,23 +356,35 @@ async function main() {
     {
       type: 'multiselect',
       name: 'tools',
-      message: 'Which tools would you like to setup?',
+      message: 'Select development tools to configure:',
       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: 'TypeScript (Type checking)',
+          title: 'ESLint        Catch bugs and enforce standards',
+          value: 'eslint',
+          selected: true
+        },
+        {
+          title: 'Prettier      Auto-format code consistently',
+          value: 'prettier',
+          selected: true
+        },
+        {
+          title: 'Stylelint     Lint CSS, SCSS, and style files',
+          value: 'stylelint',
+          selected: false
+        },
+        {
+          title: 'TypeScript    Type safety and better tooling',
           value: 'typescript',
           selected: detected.typescript
         },
         {
-          title: 'semantic-release (Automated versioning)',
+          title: 'semantic-release  Automated versioning & releases',
           value: 'semantic-release',
           selected: false
         }
       ],
-      hint: '- Space to select. Return to submit'
+      hint: '  (Recommended tools are pre-selected)'
     }
   ])
 
@@ -218,16 +394,18 @@ async function main() {
     process.exit(0)
   }
 
-  await setupTools(response.tools, detected, cwd, flags.dryRun)
+  const summary = await setupTools(response.tools, detected, cwd, flags.dryRun)
 
   // If semantic-release selected, prompt for CI setup
   if (response.tools.includes('semantic-release')) {
-    showSection('🚀 CI/CD Pipeline Setup')
+    console.log('')
+    console.log('🚀 semantic-release needs CI/CD to automate releases')
+    console.log('')
 
     const ciResponse = await prompts({
       type: 'confirm',
       name: 'setupCI',
-      message: 'Setup CI/CD pipeline for automated releases?',
+      message: 'Setup CI/CD pipeline now?',
       initial: true
     })
 
@@ -252,7 +430,7 @@ async function main() {
     }
   }
 
-  showCompletion(flags.dryRun)
+  showCompletion(flags.dryRun, summary.files, summary.scripts)
 }
 
 // Run CLI

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dimensional-innovations/tool-config",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "description": "Universal configuration package for ESLint, Prettier, Stylelint, TypeScript, and semantic-release with auto-detection for React, Vue, Svelte, Solid, Astro, Angular, and more",
   "license": "MIT",
   "author": {
@@ -81,6 +81,7 @@
     "eslint-plugin-svelte": "^3.12.4",
     "eslint-plugin-vue": "^10.5.0",
     "globals": "^16.4.0",
+    "picocolors": "^1.1.1",
     "postcss": "^8.4.49",
     "postcss-html": "^1.8.0",
     "postcss-scss": "^4.0.9",