@fredlackey/devutils 0.0.18 → 0.1.0

package/src/commands/setup.js

@@ -1,246 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * @fileoverview Setup command - Install essential tools required for DevUtils CLI to function.
- * This includes git, ssh-keygen, gpg, and other core dependencies.
- */
-
-const { Command } = require('commander');
-const readline = require('readline');
-
-const shell = require('../utils/common/shell');
-const osUtils = require('../utils/common/os');
-
-// Essential tools that DevUtils CLI requires (shared across all platforms)
-const CORE_TOOLS = [
-  {
-    name: 'git',
-    command: 'git',
-    description: 'Version control system',
-    install: 'git'
-  },
-  {
-    name: 'ssh-keygen',
-    command: 'ssh-keygen',
-    description: 'SSH key generation',
-    install: 'openssh'
-  },
-  {
-    name: 'gpg',
-    command: 'gpg',
-    description: 'GPG encryption and signing',
-    install: 'gpg'
-  },
-  {
-    name: 'curl',
-    command: 'curl',
-    description: 'Data transfer tool',
-    install: 'curl'
-  }
-];
-
-// Homebrew is required on macOS before installing other tools
-const HOMEBREW_TOOL = {
-  name: 'brew',
-  command: 'brew',
-  description: 'Package manager (required)',
-  install: 'homebrew'
-};
-
-/**
- * Get the list of essential tools for the current platform.
- * On macOS, Homebrew is included first since other tools depend on it.
- * @returns {Array<object>} Array of tool definitions
- */
-function getEssentialTools() {
-  const platform = osUtils.detect();
-
-  // On macOS, Homebrew must be installed first since all other tools use it
-  if (platform.type === 'macos') {
-    return [HOMEBREW_TOOL, ...CORE_TOOLS];
-  }
-
-  // On other platforms, just use the core tools
-  return CORE_TOOLS;
-}
-
-/**
- * Create readline interface for prompts
- * @returns {readline.Interface}
- */
-function createPrompt() {
-  return readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-}
-
-/**
- * Prompt user for confirmation
- * @param {readline.Interface} rl - Readline interface
- * @param {string} question - Question to ask
- * @returns {Promise<boolean>}
- */
-function confirm(rl, question) {
-  return new Promise(resolve => {
-    rl.question(`${question} (y/n): `, answer => {
-      resolve(answer.toLowerCase().startsWith('y'));
-    });
-  });
-}
-
-/**
- * Check which essential tools are missing
- * @returns {Array<object>} Array of missing tools
- */
-function checkMissingTools() {
-  const tools = getEssentialTools();
-  const missing = [];
-  for (const tool of tools) {
-    if (!shell.commandExists(tool.command)) {
-      missing.push(tool);
-    }
-  }
-  return missing;
-}
-
-/**
- * Get all tool statuses
- * @returns {Array<{ tool: object, installed: boolean }>}
- */
-function getToolStatuses() {
-  const tools = getEssentialTools();
-  return tools.map(tool => ({
-    tool,
-    installed: shell.commandExists(tool.command)
-  }));
-}
-
-/**
- * Install a tool using the appropriate installer
- * @param {object} tool - Tool definition
- * @returns {Promise<boolean>} True if installation succeeded
- */
-async function installTool(tool) {
-  try {
-    const installer = require(`../installs/${tool.install}`);
-    if (typeof installer.install !== 'function') {
-      console.error(`  No install function found for ${tool.name}`);
-      return false;
-    }
-
-    // Run the installer
-    await installer.install();
-
-    // Verify installation by checking if the command now exists
-    // This is more reliable than trusting return values from installers
-    const isNowInstalled = shell.commandExists(tool.command);
-    return isNowInstalled;
-  } catch (err) {
-    console.error(`  Failed to install ${tool.name}: ${err.message}`);
-    return false;
-  }
-}
-
-/**
- * Display tool status table
- * @param {Array<{ tool: object, installed: boolean }>} statuses
- */
-function displayToolStatus(statuses) {
-  console.log('\nEssential Tools:');
-  console.log('─'.repeat(50));
-
-  for (const { tool, installed } of statuses) {
-    const status = installed ? '✓ Installed' : '✗ Missing';
-    const statusColor = installed ? status : status;
-    console.log(`  ${tool.name.padEnd(15)} ${statusColor.padEnd(15)} ${tool.description}`);
-  }
-  console.log('');
-}
-
-/**
- * Run the setup command
- * @param {object} options - Command options
- */
-async function runSetup(options) {
-  const platform = osUtils.detect();
-
-  console.log('\n=== DevUtils CLI Setup ===\n');
-  console.log(`Platform: ${platform.type}`);
-  console.log(`Package Manager: ${platform.packageManager || 'unknown'}`);
-
-  // Check tool statuses
-  const statuses = getToolStatuses();
-  displayToolStatus(statuses);
-
-  // Find missing tools
-  const missing = statuses.filter(s => !s.installed).map(s => s.tool);
-
-  if (missing.length === 0) {
-    console.log('All essential tools are already installed.\n');
-    return;
-  }
-
-  console.log(`Missing ${missing.length} tool(s): ${missing.map(t => t.name).join(', ')}\n`);
-
-  // Confirm installation unless --force
-  let shouldInstall = options.force;
-  if (!shouldInstall) {
-    const rl = createPrompt();
-    shouldInstall = await confirm(rl, 'Install missing tools?');
-    rl.close();
-  }
-
-  if (!shouldInstall) {
-    console.log('Setup cancelled.\n');
-    return;
-  }
-
-  // Install each missing tool
-  console.log('\nInstalling missing tools...\n');
-
-  let installed = 0;
-  let failed = 0;
-
-  for (const tool of missing) {
-    console.log(`Installing ${tool.name}...`);
-    const success = await installTool(tool);
-    if (success) {
-      installed++;
-      console.log(`  ${tool.name} installed successfully.\n`);
-    } else {
-      failed++;
-      console.log(`  ${tool.name} installation failed.\n`);
-    }
-  }
-
-  // Show final status
-  console.log('─'.repeat(50));
-  console.log(`\nSetup complete: ${installed} installed, ${failed} failed.\n`);
-
-  // Show updated status
-  if (installed > 0) {
-    const updatedStatuses = getToolStatuses();
-    displayToolStatus(updatedStatuses);
-  }
-}
-
-// Create and configure the command
-const setup = new Command('setup')
-  .description('Install essential tools required for DevUtils CLI')
-  .option('--force', 'Install without prompting')
-  .option('--check', 'Check tool status without installing')
-  .action(async (options) => {
-    if (options.check) {
-      const statuses = getToolStatuses();
-      displayToolStatus(statuses);
-      const missing = statuses.filter(s => !s.installed);
-      if (missing.length > 0) {
-        console.log(`Run 'dev setup' to install missing tools.\n`);
-      }
-      return;
-    }
-    await runSetup(options);
-  });
-
-module.exports = setup;

package/src/completion.js

@@ -1,284 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * @fileoverview Tab completion handler for the dev CLI.
- * Provides shell completion for bash, zsh, and fish.
- */
-
-const fs = require('fs');
-const path = require('path');
-
-/**
- * Command completion definitions
- * Maps parent commands to their available subcommands
- */
-const COMMANDS = {
-  '': ['configure', 'status', 'identity', 'ignore', 'install', 'completion'],
-  'dev': ['configure', 'status', 'identity', 'ignore', 'install', 'completion'],
-  'identity': ['add', 'remove', 'link'],
-  'completion': ['install', 'uninstall']
-};
-
-/**
- * Command descriptions for enhanced completion (zsh/fish)
- */
-const DESCRIPTIONS = {
-  'configure': 'Interactive configuration wizard',
-  'status': 'Display current configuration',
-  'identity': 'Manage identity profiles',
-  'ignore': 'Append patterns to .gitignore',
-  'install': 'Install development tools',
-  'completion': 'Manage shell completion',
-  'add': 'Add a new identity profile',
-  'remove': 'Remove an identity profile',
-  'link': 'Link identity to a source folder'
-};
-
-/**
- * Get available ignore technologies by scanning src/ignore directory
- * @returns {string[]} Array of technology names
- */
-function getIgnoreTechnologies() {
-  try {
-    const ignoreDir = path.join(__dirname, 'ignore');
-    if (!fs.existsSync(ignoreDir)) {
-      return [];
-    }
-    return fs.readdirSync(ignoreDir)
-      .filter(file => file.endsWith('.txt'))
-      .map(file => file.replace('.txt', ''));
-  } catch {
-    return [];
-  }
-}
-
-/**
- * Get available install scripts by scanning src/installs directory
- * @returns {string[]} Array of install script names
- */
-function getInstallScripts() {
-  try {
-    const installsDir = path.join(__dirname, 'installs');
-    if (!fs.existsSync(installsDir)) {
-      return [];
-    }
-    return fs.readdirSync(installsDir)
-      .filter(file => file.endsWith('.js'))
-      .map(file => file.replace('.js', ''));
-  } catch {
-    return [];
-  }
-}
-
-/**
- * Parse completion environment variables
- * @returns {object} Parsed environment with line, words, prev, etc.
- */
-function parseEnv() {
-  const line = process.env.COMP_LINE || '';
-  const point = parseInt(process.env.COMP_POINT || line.length, 10);
-  const partial = line.slice(0, point);
-  const words = partial.split(/\s+/).filter(Boolean);
-  const lastPartial = partial.endsWith(' ') ? '' : (words[words.length - 1] || '');
-  const prev = words.length > 1 ? words[words.length - (partial.endsWith(' ') ? 1 : 2)] : '';
-
-  return {
-    line,
-    point,
-    words,
-    prev,
-    lastPartial,
-    wordCount: words.length
-  };
-}
-
-/**
- * Output completions in the format expected by shells
- * @param {string[]|object[]} completions - Array of completion strings or objects with name/description
- */
-function logCompletions(completions) {
-  completions.forEach(item => {
-    if (typeof item === 'string') {
-      console.log(item);
-    } else {
-      // For zsh/fish: name:description format
-      console.log(`${item.name}:${item.description || ''}`);
-    }
-  });
-}
-
-/**
- * Handle tab completion request
- * Called when COMP_LINE environment variable is present
- */
-function handleCompletion() {
-  const env = parseEnv();
-  let completions = [];
-
-  // Determine what completions to provide based on context
-  if (env.prev === 'ignore') {
-    completions = getIgnoreTechnologies();
-  } else if (env.prev === 'install') {
-    completions = getInstallScripts();
-  } else if (COMMANDS[env.prev]) {
-    completions = COMMANDS[env.prev];
-  } else if (env.wordCount <= 2) {
-    completions = COMMANDS['dev'];
-  }
-
-  // Filter completions by partial match
-  if (env.lastPartial && !env.line.endsWith(' ')) {
-    completions = completions.filter(c =>
-      c.toLowerCase().startsWith(env.lastPartial.toLowerCase())
-    );
-  }
-
-  // Add descriptions if available
-  const withDescriptions = completions.map(name => ({
-    name,
-    description: DESCRIPTIONS[name] || ''
-  }));
-
-  logCompletions(withDescriptions);
-}
-
-/**
- * Install shell tab completion
- * Adds completion script to user's shell configuration
- */
-async function installCompletion() {
-  const shell = process.env.SHELL || '';
-  const home = process.env.HOME || process.env.USERPROFILE;
-
-  let rcFile;
-  let completionScript;
-
-  if (shell.includes('zsh')) {
-    rcFile = path.join(home, '.zshrc');
-    completionScript = `
-# @fredlackey/devutils completion
-_dev_completions() {
-  local IFS=$'\\n'
-  COMPREPLY=($(COMP_LINE="$COMP_LINE" COMP_POINT="$COMP_POINT" dev))
-}
-complete -F _dev_completions dev
-`;
-  } else if (shell.includes('bash')) {
-    rcFile = path.join(home, '.bashrc');
-    completionScript = `
-# @fredlackey/devutils completion
-_dev_completions() {
-  local IFS=$'\\n'
-  COMPREPLY=($(COMP_LINE="$COMP_LINE" COMP_POINT="$COMP_POINT" dev))
-}
-complete -F _dev_completions dev
-`;
-  } else if (shell.includes('fish')) {
-    rcFile = path.join(home, '.config', 'fish', 'config.fish');
-    completionScript = `
-# @fredlackey/devutils completion
-complete -c dev -f -a "(COMP_LINE=(commandline) COMP_POINT=(commandline -C) dev)"
-`;
-  } else {
-    console.error('Unsupported shell. Supported shells: bash, zsh, fish');
-    process.exit(1);
-  }
-
-  try {
-    // Check if completion is already installed
-    if (fs.existsSync(rcFile)) {
-      const content = fs.readFileSync(rcFile, 'utf8');
-      if (content.includes('@fredlackey/devutils completion')) {
-        console.log('Tab completion is already installed.');
-        return;
-      }
-    }
-
-    // Append completion script
-    fs.appendFileSync(rcFile, '\n' + completionScript);
-    console.log(`Tab completion installed in ${rcFile}`);
-    console.log('Restart your shell or run:');
-    console.log(`  source ${rcFile}`);
-  } catch (err) {
-    console.error('Failed to install completion:', err.message);
-    process.exit(1);
-  }
-}
-
-/**
- * Uninstall shell tab completion
- * Removes completion script from user's shell configuration
- */
-async function uninstallCompletion() {
-  const shell = process.env.SHELL || '';
-  const home = process.env.HOME || process.env.USERPROFILE;
-
-  let rcFile;
-  if (shell.includes('zsh')) {
-    rcFile = path.join(home, '.zshrc');
-  } else if (shell.includes('bash')) {
-    rcFile = path.join(home, '.bashrc');
-  } else if (shell.includes('fish')) {
-    rcFile = path.join(home, '.config', 'fish', 'config.fish');
-  } else {
-    console.error('Unsupported shell. Supported shells: bash, zsh, fish');
-    process.exit(1);
-  }
-
-  try {
-    if (!fs.existsSync(rcFile)) {
-      console.log('Shell configuration file not found.');
-      return;
-    }
-
-    let content = fs.readFileSync(rcFile, 'utf8');
-
-    // Remove completion block
-    const startMarker = '# @fredlackey/devutils completion';
-    if (!content.includes(startMarker)) {
-      console.log('Tab completion is not installed.');
-      return;
-    }
-
-    // Remove the completion section (handles multi-line blocks)
-    const lines = content.split('\n');
-    const filteredLines = [];
-    let inCompletionBlock = false;
-    let braceCount = 0;
-
-    for (const line of lines) {
-      if (line.includes(startMarker)) {
-        inCompletionBlock = true;
-        continue;
-      }
-      if (inCompletionBlock) {
-        if (line.includes('{')) braceCount++;
-        if (line.includes('}')) braceCount--;
-        if (line.includes('complete') && braceCount === 0) {
-          inCompletionBlock = false;
-          continue;
-        }
-        if (braceCount === 0 && line.trim() === '') {
-          inCompletionBlock = false;
-        }
-        continue;
-      }
-      filteredLines.push(line);
-    }
-
-    fs.writeFileSync(rcFile, filteredLines.join('\n'));
-    console.log(`Tab completion removed from ${rcFile}`);
-    console.log('Restart your shell for changes to take effect.');
-  } catch (err) {
-    console.error('Failed to uninstall completion:', err.message);
-    process.exit(1);
-  }
-}
-
-module.exports = {
-  handleCompletion,
-  installCompletion,
-  uninstallCompletion,
-  getIgnoreTechnologies,
-  getInstallScripts
-};

package/src/constants.js

@@ -1,45 +0,0 @@
-const INSTALLS = [
-  {
-    name: "Debian",
-    environment: "debian",
-    description: "Installs generic to any Debian-based Linux distribution.",
-    packages: [
-      {
-        name: "Git",
-        description: "Git command line tool.",
-        command: "apt-get install -y git",
-        priority: 1,
-      }
-    ]
-  },
-  {
-    name: "Debian WSL",
-    environment: "debian_wsl",
-    description: "Installs generic to any Debian-based Linux distribution running in WSL.",
-  },
-  {
-    name: "Ubuntu",
-    environment: "ubuntu",
-    description: "Installs generic to any Ubuntu-based Linux distribution.",
-  },
-  {
-    name: "Ubuntu WSL",
-    environment: "ubuntu_wsl",
-    description: "Installs generic to any Ubuntu-based Linux distribution running in WSL.",
-  },
-  {
-    name: "macOS",
-    environment: "macos",
-    description: "Installs for macOS systems.",
-  },
-  {
-    name: "Windows",
-    environment: "windows",
-    description: "Installs for Windows systems.",
-  },
-  {
-    name: "Git Bash",
-    environment: "gitbash",
-    description: "Installs within the Git Bash environment.",
-  },
-]

package/src/ignore/claude-code.txt

@@ -1,10 +0,0 @@
-# ##############################################################################
-# CLAUDE CODE
-# Generated by DevUtils CLI (https://github.com/fredlackey/devutils-cli)
-# ##############################################################################
-
-# Claude Code local files
-.claude/
-.claude-context
-.claude_memory/
-claude-output/

package/src/ignore/docker.txt

@@ -1,18 +0,0 @@
-# ##############################################################################
-# DOCKER
-# Generated by DevUtils CLI (https://github.com/fredlackey/devutils-cli)
-# ##############################################################################
-
-# Docker configuration
-.docker/
-docker-compose.override.yml
-docker-compose.local.yml
-.dockerignore
-
-# Docker data volumes
-data/
-volumes/
-
-# Docker environment files
-.env.docker
-.env.docker.local

package/src/ignore/linux.txt

@@ -1,23 +0,0 @@
-# ##############################################################################
-# LINUX
-# Generated by DevUtils CLI (https://github.com/fredlackey/devutils-cli)
-# ##############################################################################
-
-# Backup files
-*~
-*.bak
-*.backup
-
-# Swap files
-*.swp
-*.swo
-
-# Temporary files
-.fuse_hidden*
-.nfs*
-
-# Trash
-.Trash-*
-
-# KDE directory preferences
-.directory

package/src/ignore/macos.txt

@@ -1,36 +0,0 @@
-# ##############################################################################
-# MACOS
-# Generated by DevUtils CLI (https://github.com/fredlackey/devutils-cli)
-# ##############################################################################
-
-# Finder metadata
-.DS_Store
-.AppleDouble
-.LSOverride
-
-# Icon must end with two \r
-Icon
-
-# Thumbnails
-._*
-
-# Volume files
-.DocumentRevisions-V100
-.fseventsd
-.Spotlight-V100
-.TemporaryItems
-.Trashes
-.VolumeIcon.icns
-.com.apple.timemachine.donotpresent
-
-# AFP share files
-.AppleDB
-.AppleDesktop
-Network Trash Folder
-Temporary Items
-.apdisk
-
-# Xcode
-xcuserdata/
-*.xcscmblueprint
-*.xccheckout