@fredlackey/devutils 0.0.13 → 0.0.15

package/README.md

@@ -27,11 +27,38 @@ That's it. DevUtils CLI detects your operating system and installs everything yo
 
 ## Installation
 
+### If You Have Node.js Installed
+
+If you already have Node.js 18+ on your machine, install DevUtils CLI as a global npm package:
+
 ```bash
 npm install -g @fredlackey/devutils
 ```
 
-**Requirements:** Node.js 18+
+### Fresh Machine (No Node.js)
+
+For a fresh machine without Node.js, run the bootstrap script. It installs everything you need: build tools, nvm, Node.js LTS, and DevUtils CLI.
+
+**macOS:**
+```bash
+bash -c "$(curl -LsS https://raw.github.com/fredlackey/devutils-cli/main/setup.sh)"
+```
+
+**Ubuntu / Debian / Raspberry Pi OS:**
+```bash
+bash -c "$(wget -qO - https://raw.github.com/fredlackey/devutils-cli/main/setup.sh)"
+```
+
+**Amazon Linux / RHEL / Fedora:**
+```bash
+bash -c "$(curl -LsS https://raw.github.com/fredlackey/devutils-cli/main/setup.sh)"
+```
+
+The script is interactive by default. For automated/CI environments, add `--no-prompt`:
+
+```bash
+bash -c "$(curl -LsS https://raw.github.com/fredlackey/devutils-cli/main/setup.sh)" -- --no-prompt
+```
 
 ## Quick Start
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fredlackey/devutils",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "description": "A globally-installable Node.js CLI toolkit for bootstrapping and configuring development environments across any machine.",
   "main": "src/index.js",
   "bin": {

package/src/cli.js

@@ -13,6 +13,8 @@ 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');
 
 /**
@@ -36,6 +38,8 @@ function run() {
   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');

package/src/commands/update.js

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

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