@fredlackey/devutils 0.0.1

package/src/commands/status.js

@@ -0,0 +1,223 @@
+#!/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/completion.js

@@ -0,0 +1,284 @@
+#!/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

@@ -0,0 +1,45 @@
+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

@@ -0,0 +1,10 @@
+# ##############################################################################
+# 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

@@ -0,0 +1,18 @@
+# ##############################################################################
+# 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

@@ -0,0 +1,23 @@
+# ##############################################################################
+# 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

@@ -0,0 +1,36 @@
+# ##############################################################################
+# 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

package/src/ignore/node.txt

@@ -0,0 +1,55 @@
+# ##############################################################################
+# NODE.JS
+# Generated by DevUtils CLI (https://github.com/fredlackey/devutils-cli)
+# ##############################################################################
+
+# Dependencies
+node_modules/
+jspm_packages/
+bower_components/
+
+# Debug logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Runtime data
+pids/
+*.pid
+*.seed
+*.pid.lock
+
+# Coverage
+coverage/
+*.lcov
+.nyc_output/
+
+# Build output
+dist/
+build/
+out/
+
+# TypeScript
+*.tsbuildinfo
+
+# Optional caches
+.npm/
+.eslintcache
+.stylelintcache
+
+# Yarn
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+# pnpm
+.pnpm-store/
+
+# Environment files
+.env
+.env.local
+.env.*.local