@fredlackey/devutils 0.0.18 → 0.0.19

package/src/cli.js

@@ -1,72 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * @fileoverview CLI setup using Commander.js
- * Registers all commands and handles program execution.
- */
-
-const { program } = require('commander');
-const pkg = require('../package.json');
-
-const configureCommand = require('./commands/configure');
-const statusCommand = require('./commands/status');
-const identityCommand = require('./commands/identity');
-const ignoreCommand = require('./commands/ignore');
-const installCommand = require('./commands/install');
-const versionCommand = require('./commands/version');
-const updateCommand = require('./commands/update');
-const { installCompletion, uninstallCompletion } = require('./completion');
-
-/**
- * Run the CLI program
- */
-function run() {
-  program
-    .name('dev')
-    .description('CLI toolkit for bootstrapping development environments')
-    .version(pkg.version, '-v, --version', 'Display version number');
-
-  // Global options
-  program
-    .option('--verbose', 'Enable verbose output')
-    .option('-q, --quiet', 'Suppress non-essential output')
-    .option('--no-color', 'Disable colored output');
-
-  // Add commands
-  program.addCommand(configureCommand);
-  program.addCommand(statusCommand);
-  program.addCommand(identityCommand);
-  program.addCommand(ignoreCommand);
-  program.addCommand(installCommand);
-  program.addCommand(versionCommand);
-  program.addCommand(updateCommand);
-
-  // Setup command - install essential tools
-  const setupCommand = require('./commands/setup');
-  program.addCommand(setupCommand);
-
-  // Completion management
-  const completion = program
-    .command('completion')
-    .description('Manage shell tab completion');
-
-  completion
-    .command('install')
-    .description('Install tab completion for your shell')
-    .action(installCompletion);
-
-  completion
-    .command('uninstall')
-    .description('Remove tab completion')
-    .action(uninstallCompletion);
-
-  // Parse and execute
-  program.parse(process.argv);
-
-  // If no command specified, show help
-  if (process.argv.length === 2) {
-    program.help();
-  }
-}
-
-module.exports = { run };

package/src/commands/README.md

@@ -1,41 +0,0 @@
-# Commands
-
-This folder contains the implementation logic for **Commands** — multi-word CLI operations invoked with the `dev` prefix.
-
-## Structure
-
-```
-dev <action> [subcommand] [arguments] [options]
-```
-
-## Examples
-
-```bash
-dev configure              # Configure developer profile
-dev status                 # Show current configuration
-dev install vscode         # Install VS Code
-dev ignore node            # Add Node.js patterns to .gitignore
-dev identity add           # Add a new identity profile
-dev identity remove        # Remove an identity profile
-dev identity link          # Link identity to a source folder
-```
-
-## Files
-
-| File | Command | Description |
-|------|---------|-------------|
-| `configure.js` | `dev configure` | Interactive configuration wizard |
-| `status.js` | `dev status` | Display current configuration |
-| `install.js` | `dev install <name>` | Install development tools |
-| `ignore.js` | `dev ignore <technology>` | Append patterns to .gitignore |
-| `identity.js` | `dev identity <action>` | Manage identity profiles (add, remove, link) |
-
-## Related
-
-- **Scripts** (`../scripts/`) — Standalone global utilities (e.g., `afk`, `clone`)
-- **Installs** (`../installs/`) — Platform-specific installation logic
-- **Utils** (`../utils/`) — Internal shared utilities
-
-## Documentation
-
-See [docs/COMMANDS.md](../../docs/COMMANDS.md) for the complete command specification.

package/src/commands/configure.js

@@ -1,199 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * @fileoverview Configure command - Create the initial .devutils configuration
- * file with user information.
- */
-
-const { Command } = require('commander');
-const fs = require('fs');
-const path = require('path');
-const readline = require('readline');
-
-const CONFIG_FILE = path.join(process.env.HOME || process.env.USERPROFILE, '.devutils');
-
-/**
- * Create readline interface for prompts
- * @returns {readline.Interface}
- */
-function createPrompt() {
-  return readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-}
-
-/**
- * Prompt user for input
- * @param {readline.Interface} rl - Readline interface
- * @param {string} question - Question to ask
- * @param {string} [defaultValue] - Default value if empty
- * @returns {Promise<string>}
- */
-function ask(rl, question, defaultValue) {
-  return new Promise(resolve => {
-    const prompt = defaultValue ? `${question} [${defaultValue}]: ` : `${question}: `;
-    rl.question(prompt, answer => {
-      resolve(answer.trim() || defaultValue || '');
-    });
-  });
-}
-
-/**
- * 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'));
-    });
-  });
-}
-
-/**
- * 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 (err) {
-    // Invalid JSON or read error
-  }
-  return null;
-}
-
-/**
- * Save configuration to file
- * @param {object} config - Configuration object
- */
-function saveConfig(config) {
-  fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + '\n');
-}
-
-/**
- * Display current configuration
- * @param {object} config - Configuration object
- */
-function displayConfig(config) {
-  console.log('\nCurrent Configuration:');
-  console.log('─'.repeat(40));
-
-  if (config.user) {
-    console.log('User:');
-    console.log(`  Name:  ${config.user.name || '(not set)'}`);
-    console.log(`  Email: ${config.user.email || '(not set)'}`);
-    console.log(`  URL:   ${config.user.url || '(not set)'}`);
-  }
-
-  console.log('\nConfig file:', CONFIG_FILE);
-  if (config.created) {
-    console.log(`Created:     ${new Date(config.created).toLocaleString()}`);
-  }
-  if (config.updated) {
-    console.log(`Updated:     ${new Date(config.updated).toLocaleString()}`);
-  }
-  console.log('');
-}
-
-/**
- * Run the configure command
- * @param {object} options - Command options
- */
-async function runConfigure(options) {
-  const existingConfig = loadConfig();
-
-  // Show existing config if requested
-  if (options.show) {
-    if (existingConfig) {
-      displayConfig(existingConfig);
-    } else {
-      console.log('\nNo configuration found.');
-      console.log(`Run 'dev configure' to create ${CONFIG_FILE}\n`);
-    }
-    return;
-  }
-
-  let name = options.name;
-  let email = options.email;
-  let url = options.url;
-
-  // If all required params provided via CLI, skip interactive mode
-  const hasAllRequired = name && email;
-
-  if (!hasAllRequired) {
-    // Check for existing config
-    if (existingConfig && !options.force) {
-      console.log('\nExisting configuration found:');
-      displayConfig(existingConfig);
-
-      const rl = createPrompt();
-      const shouldUpdate = await confirm(rl, 'Do you want to update this configuration?');
-      rl.close();
-
-      if (!shouldUpdate) {
-        console.log('Configuration unchanged.');
-        return;
-      }
-    }
-
-    const rl = createPrompt();
-
-    console.log('\n--- Developer Profile Setup ---\n');
-
-    // Get user information (use CLI args as defaults if provided)
-    name = await ask(rl, 'Name (required)', name || existingConfig?.user?.name);
-    if (!name) {
-      console.error('\nError: Name is required.');
-      rl.close();
-      process.exit(1);
-    }
-
-    email = await ask(rl, 'Email (required)', email || existingConfig?.user?.email);
-    if (!email) {
-      console.error('\nError: Email is required.');
-      rl.close();
-      process.exit(1);
-    }
-
-    url = await ask(rl, 'URL (optional)', url || existingConfig?.user?.url);
-
-    rl.close();
-  }
-
-  // Build config object
-  const now = new Date().toISOString();
-  const config = {
-    user: {
-      name,
-      email,
-      ...(url && { url })
-    },
-    created: existingConfig?.created || now,
-    updated: now
-  };
-
-  // Save configuration
-  saveConfig(config);
-
-  console.log(`\nConfiguration saved to ${CONFIG_FILE}`);
-  displayConfig(config);
-}
-
-// Create and configure the command
-const configure = new Command('configure')
-  .description('Configure developer profile and create ~/.devutils')
-  .option('--name <name>', 'Developer name')
-  .option('--email <email>', 'Developer email')
-  .option('--url <url>', 'Developer URL (optional)')
-  .option('--force', 'Overwrite existing config without prompting')
-  .option('-s, --show', 'Display current configuration')
-  .action(runConfigure);
-
-module.exports = configure;