@fredlackey/devutils 0.0.17 → 0.0.19

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/commands/status.js

@@ -1,223 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * @fileoverview Status command - Display current configuration and environment health.
- */
-
-const { Command } = require('commander');
-const fs = require('fs');
-const path = require('path');
-const { execSync } = require('child_process');
-
-const CONFIG_FILE = path.join(process.env.HOME || process.env.USERPROFILE, '.devutils');
-
-/**
- * Load existing configuration
- * @returns {object|null}
- */
-function loadConfig() {
-  try {
-    if (fs.existsSync(CONFIG_FILE)) {
-      const content = fs.readFileSync(CONFIG_FILE, 'utf8');
-      return JSON.parse(content);
-    }
-  } catch {
-    return null;
-  }
-  return null;
-}
-
-/**
- * Check if current directory is inside a git repository
- * @returns {string|null} Path to git root or null
- */
-function getGitRoot() {
-  try {
-    const result = execSync('git rev-parse --show-toplevel', {
-      encoding: 'utf8',
-      stdio: ['pipe', 'pipe', 'pipe']
-    });
-    return result.trim();
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Get current git branch
- * @returns {string|null}
- */
-function getGitBranch() {
-  try {
-    const result = execSync('git branch --show-current', {
-      encoding: 'utf8',
-      stdio: ['pipe', 'pipe', 'pipe']
-    });
-    return result.trim();
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Get Node.js version
- * @returns {string|null}
- */
-function getNodeVersion() {
-  try {
-    return process.version;
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Get npm version
- * @returns {string|null}
- */
-function getNpmVersion() {
-  try {
-    return execSync('npm --version', {
-      encoding: 'utf8',
-      stdio: ['pipe', 'pipe', 'pipe']
-    }).trim();
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Detect operating system
- * @returns {string}
- */
-function getOS() {
-  switch (process.platform) {
-    case 'darwin':
-      return 'macOS';
-    case 'win32':
-      return 'Windows';
-    case 'linux':
-      return 'Linux';
-    default:
-      return process.platform;
-  }
-}
-
-/**
- * Check if a command exists
- * @param {string} cmd - Command to check
- * @returns {boolean}
- */
-function commandExists(cmd) {
-  try {
-    const checkCmd = process.platform === 'win32' ? `where ${cmd}` : `which ${cmd}`;
-    execSync(checkCmd, { stdio: ['pipe', 'pipe', 'pipe'] });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Display status information
- * @param {object} options - Command options
- */
-function runStatus(options) {
-  const config = loadConfig();
-  const warnings = [];
-
-  console.log('\n=== DevUtils CLI Status ===\n');
-
-  // Configuration Status
-  console.log('Configuration:');
-  console.log('─'.repeat(40));
-
-  if (config) {
-    console.log(`  File:    ${CONFIG_FILE}`);
-    console.log('  Status:  Valid');
-
-    if (config.user) {
-      console.log(`  User:    ${config.user.name} <${config.user.email}>`);
-    }
-
-    if (config.updated) {
-      console.log(`  Updated: ${new Date(config.updated).toLocaleString()}`);
-    }
-
-    // Check for issues
-    if (!config.user?.name || !config.user?.email) {
-      warnings.push('User name or email not configured');
-    }
-  } else {
-    console.log(`  File:   ${CONFIG_FILE}`);
-    console.log('  Status: Not found');
-    warnings.push(`Configuration file not found. Run 'dev configure' to create it.`);
-  }
-
-  // Environment
-  console.log('\nEnvironment:');
-  console.log('─'.repeat(40));
-  console.log(`  OS:      ${getOS()}`);
-  console.log(`  Node:    ${getNodeVersion() || 'Not found'}`);
-  console.log(`  npm:     ${getNpmVersion() || 'Not found'}`);
-  console.log(`  CWD:     ${process.cwd()}`);
-
-  // Git Repository
-  const gitRoot = getGitRoot();
-  console.log('\nGit Repository:');
-  console.log('─'.repeat(40));
-
-  if (gitRoot) {
-    console.log(`  Root:    ${gitRoot}`);
-    console.log(`  Branch:  ${getGitBranch() || 'Unknown'}`);
-  } else {
-    console.log('  Status:  Not in a git repository');
-  }
-
-  // Available Tools
-  console.log('\nAvailable Tools:');
-  console.log('─'.repeat(40));
-
-  const tools = [
-    { name: 'git', label: 'Git' },
-    { name: 'docker', label: 'Docker' },
-    { name: 'code', label: 'VS Code' },
-    { name: 'brew', label: 'Homebrew' },
-    { name: 'choco', label: 'Chocolatey' },
-    { name: 'winget', label: 'winget' }
-  ];
-
-  for (const tool of tools) {
-    const exists = commandExists(tool.name);
-    const status = exists ? 'Installed' : 'Not found';
-    console.log(`  ${tool.label.padEnd(12)} ${status}`);
-  }
-
-  // Identities
-  if (config?.identities && Object.keys(config.identities).length > 0) {
-    console.log('\nIdentities:');
-    console.log('─'.repeat(40));
-    for (const [name, identity] of Object.entries(config.identities)) {
-      console.log(`  ${name}: ${identity.email || identity.name || '(incomplete)'}`);
-    }
-  }
-
-  // Warnings
-  if (warnings.length > 0) {
-    console.log('\nWarnings:');
-    console.log('─'.repeat(40));
-    for (const warning of warnings) {
-      console.log(`  ! ${warning}`);
-    }
-  }
-
-  console.log('');
-}
-
-// Create and configure the command
-const status = new Command('status')
-  .description('Display current configuration and environment health')
-  .option('--verbose', 'Show detailed information')
-  .action(runStatus);
-
-module.exports = status;

package/src/commands/update.js

@@ -1,142 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * @fileoverview Update command - Update this package to the latest version.
- * Queries the NPM registry and installs the latest version globally.
- */
-
-const { Command } = require('commander');
-const { execSync, spawn } = require('child_process');
-const pkg = require('../../package.json');
-
-/**
- * The name of this package on NPM
- */
-const PACKAGE_NAME = pkg.name;
-
-/**
- * Get the latest version of this package from the NPM registry
- * @returns {string|null} The latest version string, or null if unable to fetch
- */
-function getLatestVersion() {
-  try {
-    const result = execSync(`npm view ${PACKAGE_NAME} version`, {
-      encoding: 'utf8',
-      stdio: ['pipe', 'pipe', 'pipe']
-    });
-    return result.trim();
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Compare two semantic version strings
- * @param {string} current - Current version (e.g., "1.2.3")
- * @param {string} latest - Latest version (e.g., "1.2.4")
- * @returns {boolean} True if latest is newer than current
- */
-function isNewerVersion(current, latest) {
-  if (!current || !latest) {
-    return false;
-  }
-
-  const currentParts = current.split('.').map(Number);
-  const latestParts = latest.split('.').map(Number);
-
-  for (let i = 0; i < 3; i++) {
-    const currentPart = currentParts[i] || 0;
-    const latestPart = latestParts[i] || 0;
-
-    if (latestPart > currentPart) {
-      return true;
-    }
-    if (latestPart < currentPart) {
-      return false;
-    }
-  }
-
-  return false;
-}
-
-/**
- * Install the latest version of this package globally
- * @returns {Promise<boolean>} True if installation succeeded
- */
-function installLatestVersion() {
-  return new Promise((resolve) => {
-    console.log(`\nInstalling ${PACKAGE_NAME}@latest globally...`);
-    console.log('─'.repeat(40));
-
-    const npmCommand = process.platform === 'win32' ? 'npm.cmd' : 'npm';
-    const child = spawn(npmCommand, ['install', '-g', `${PACKAGE_NAME}@latest`], {
-      stdio: 'inherit'
-    });
-
-    child.on('close', (code) => {
-      if (code === 0) {
-        resolve(true);
-      } else {
-        resolve(false);
-      }
-    });
-
-    child.on('error', () => {
-      resolve(false);
-    });
-  });
-}
-
-/**
- * Check for updates and install if available
- * @param {object} options - Command options
- */
-async function runUpdate(options) {
-  const currentVersion = pkg.version;
-
-  console.log(`\n${pkg.name}`);
-  console.log('─'.repeat(40));
-  console.log(`Current version: ${currentVersion}`);
-
-  // Check for updates
-  console.log('\nChecking for updates...');
-  const latestVersion = getLatestVersion();
-
-  if (!latestVersion) {
-    console.log('Unable to check for updates (NPM registry unreachable)');
-    console.log('');
-    return;
-  }
-
-  console.log(`Latest version:  ${latestVersion}`);
-
-  if (!isNewerVersion(currentVersion, latestVersion)) {
-    console.log('\nYou are already running the latest version.');
-    console.log('');
-    return;
-  }
-
-  console.log(`\nUpdate available: ${currentVersion} -> ${latestVersion}`);
-
-  // Perform the update
-  const success = await installLatestVersion();
-
-  if (success) {
-    console.log('─'.repeat(40));
-    console.log(`\nSuccessfully updated to version ${latestVersion}`);
-    console.log('');
-  } else {
-    console.log('─'.repeat(40));
-    console.log('\nUpdate failed. Try running manually:');
-    console.log(`  npm install -g ${PACKAGE_NAME}@latest`);
-    console.log('');
-    process.exit(1);
-  }
-}
-
-// Create and configure the command
-const update = new Command('update')
-  .description('Update this package to the latest version')
-  .action(runUpdate);
-
-module.exports = update;

package/src/commands/version.js

@@ -1,100 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * @fileoverview Version command - Display current version and check for updates.
- * Queries the NPM registry to determine if a newer version is available.
- */
-
-const { Command } = require('commander');
-const { execSync } = require('child_process');
-const pkg = require('../../package.json');
-
-/**
- * The name of this package on NPM
- */
-const PACKAGE_NAME = pkg.name;
-
-/**
- * Get the latest version of this package from the NPM registry
- * @returns {string|null} The latest version string, or null if unable to fetch
- */
-function getLatestVersion() {
-  try {
-    const result = execSync(`npm view ${PACKAGE_NAME} version`, {
-      encoding: 'utf8',
-      stdio: ['pipe', 'pipe', 'pipe']
-    });
-    return result.trim();
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Compare two semantic version strings
- * @param {string} current - Current version (e.g., "1.2.3")
- * @param {string} latest - Latest version (e.g., "1.2.4")
- * @returns {boolean} True if latest is newer than current
- */
-function isNewerVersion(current, latest) {
-  if (!current || !latest) {
-    return false;
-  }
-
-  const currentParts = current.split('.').map(Number);
-  const latestParts = latest.split('.').map(Number);
-
-  for (let i = 0; i < 3; i++) {
-    const currentPart = currentParts[i] || 0;
-    const latestPart = latestParts[i] || 0;
-
-    if (latestPart > currentPart) {
-      return true;
-    }
-    if (latestPart < currentPart) {
-      return false;
-    }
-  }
-
-  return false;
-}
-
-/**
- * Display version information and check for updates
- * @param {object} options - Command options
- */
-async function runVersion(options) {
-  const currentVersion = pkg.version;
-
-  console.log(`\n${pkg.name}`);
-  console.log('─'.repeat(40));
-  console.log(`Current version: ${currentVersion}`);
-
-  // Check for updates
-  console.log('\nChecking for updates...');
-  const latestVersion = getLatestVersion();
-
-  if (!latestVersion) {
-    console.log('Unable to check for updates (NPM registry unreachable)');
-    console.log('');
-    return;
-  }
-
-  if (isNewerVersion(currentVersion, latestVersion)) {
-    console.log(`\nUpdate available: ${currentVersion} -> ${latestVersion}`);
-    console.log('\nTo update, run:');
-    console.log('  dev update');
-    console.log('');
-  } else {
-    console.log(`Latest version:  ${latestVersion}`);
-    console.log('\nYou are running the latest version.');
-    console.log('');
-  }
-}
-
-// Create and configure the command
-const version = new Command('version')
-  .description('Display current version and check for updates')
-  .action(runVersion);
-
-module.exports = version;