@fredlackey/devutils 0.0.8 → 0.0.10

package/package.json

@@ -1,10 +1,86 @@
 {
   "name": "@fredlackey/devutils",
-  "version": "0.0.8",
+  "version": "0.0.10",
   "description": "A globally-installable Node.js CLI toolkit for bootstrapping and configuring development environments across any machine.",
   "main": "src/index.js",
   "bin": {
-    "dev": "./bin/dev.js"
+    "dev": "./bin/dev.js",
+    "afk": "./src/scripts/afk.js",
+    "backup-all": "./src/scripts/backup-all.js",
+    "backup-source": "./src/scripts/backup-source.js",
+    "brewd": "./src/scripts/brewd.js",
+    "brewi": "./src/scripts/brewi.js",
+    "brewr": "./src/scripts/brewr.js",
+    "brews": "./src/scripts/brews.js",
+    "brewu": "./src/scripts/brewu.js",
+    "c": "./src/scripts/c.js",
+    "ccurl": "./src/scripts/ccurl.js",
+    "certbot-crontab-init": "./src/scripts/certbot-crontab-init.js",
+    "certbot-init": "./src/scripts/certbot-init.js",
+    "ch": "./src/scripts/ch.js",
+    "claude-danger": "./src/scripts/claude-danger.js",
+    "clean-dev": "./src/scripts/clean-dev.js",
+    "clear-dns-cache": "./src/scripts/clear-dns-cache.js",
+    "clone": "./src/scripts/clone.js",
+    "code-all": "./src/scripts/code-all.js",
+    "count": "./src/scripts/count.js",
+    "count-files": "./src/scripts/count-files.js",
+    "count-folders": "./src/scripts/count-folders.js",
+    "d": "./src/scripts/d.js",
+    "datauri": "./src/scripts/datauri.js",
+    "delete-files": "./src/scripts/delete-files.js",
+    "docker-clean": "./src/scripts/docker-clean.js",
+    "dp": "./src/scripts/dp.js",
+    "e": "./src/scripts/e.js",
+    "empty-trash": "./src/scripts/empty-trash.js",
+    "evm": "./src/scripts/evm.js",
+    "fetch-github-repos": "./src/scripts/fetch-github-repos.js",
+    "get-channel": "./src/scripts/get-channel.js",
+    "get-course": "./src/scripts/get-course.js",
+    "get-dependencies": "./src/scripts/get-dependencies.js",
+    "get-folder": "./src/scripts/get-folder.js",
+    "get-tunes": "./src/scripts/get-tunes.js",
+    "get-video": "./src/scripts/get-video.js",
+    "git-backup": "./src/scripts/git-backup.js",
+    "git-clone": "./src/scripts/git-clone.js",
+    "git-pup": "./src/scripts/git-pup.js",
+    "git-push": "./src/scripts/git-push.js",
+    "h": "./src/scripts/h.js",
+    "hide-desktop-icons": "./src/scripts/hide-desktop-icons.js",
+    "hide-hidden-files": "./src/scripts/hide-hidden-files.js",
+    "install-dependencies-from": "./src/scripts/install-dependencies-from.js",
+    "ips": "./src/scripts/ips.js",
+    "iso": "./src/scripts/iso.js",
+    "killni": "./src/scripts/killni.js",
+    "ll": "./src/scripts/ll.js",
+    "local-ip": "./src/scripts/local-ip.js",
+    "m": "./src/scripts/m.js",
+    "map": "./src/scripts/map.js",
+    "mkd": "./src/scripts/mkd.js",
+    "ncu-update-all": "./src/scripts/ncu-update-all.js",
+    "nginx-init": "./src/scripts/nginx-init.js",
+    "npmi": "./src/scripts/npmi.js",
+    "o": "./src/scripts/o.js",
+    "org-by-date": "./src/scripts/org-by-date.js",
+    "p": "./src/scripts/p.js",
+    "packages": "./src/scripts/packages.js",
+    "path": "./src/scripts/path.js",
+    "ports": "./src/scripts/ports.js",
+    "q": "./src/scripts/q.js",
+    "refresh-files": "./src/scripts/refresh-files.js",
+    "remove-smaller-files": "./src/scripts/remove-smaller-files.js",
+    "rename-files-with-date": "./src/scripts/rename-files-with-date.js",
+    "resize-image": "./src/scripts/resize-image.js",
+    "rm-safe": "./src/scripts/rm-safe.js",
+    "s": "./src/scripts/s.js",
+    "set-git-public": "./src/scripts/set-git-public.js",
+    "show-desktop-icons": "./src/scripts/show-desktop-icons.js",
+    "show-hidden-files": "./src/scripts/show-hidden-files.js",
+    "tpa": "./src/scripts/tpa.js",
+    "tpo": "./src/scripts/tpo.js",
+    "u": "./src/scripts/u.js",
+    "vpush": "./src/scripts/vpush.js",
+    "y": "./src/scripts/y.js"
   },
   "files": [
     "bin/",

package/src/commands/install.js

@@ -19,6 +19,7 @@ const { Command } = require('commander');
 const fs = require('fs');
 const path = require('path');
 const readline = require('readline');
+const os = require('../utils/common/os');
 
 const INSTALLS_DIR = path.join(__dirname, '..', 'installs');
 const INSTALLERS_JSON = path.join(INSTALLS_DIR, 'installers.json');
@@ -244,10 +245,24 @@ async function resolveDependencies(name, visited = new Set(), installing = new S
   // Sort dependencies by priority (lower priority = install first)
   const sortedDeps = [...dependencies].sort((a, b) => (a.priority || 0) - (b.priority || 0));
 
+  // Get current platform for filtering platform-specific dependencies
+  const currentPlatform = os.detect().type;
+
   // Process each dependency
   for (const dep of sortedDeps) {
     const depName = dep.name.replace('.js', '');
 
+    // Check if dependency is platform-specific and applies to current platform
+    // If 'platforms' is not specified, the dependency applies to all platforms
+    if (dep.platforms && dep.platforms.length > 0) {
+      if (!dep.platforms.includes(currentPlatform)) {
+        if (options.verbose) {
+          console.log(`  [Skipping ${depName}: not needed on ${currentPlatform}]`);
+        }
+        continue;
+      }
+    }
+
     // Check if dependency is eligible for this platform
     if (!checkIsEligible(depName)) {
       if (options.verbose) {

package/src/installs/chocolatey.js

@@ -25,6 +25,7 @@
 const os = require('../utils/common/os');
 const shell = require('../utils/common/shell');
 const windowsShell = require('../utils/windows/shell');
+const choco = require('../utils/windows/choco');
 
 /**
  * The official Chocolatey installation script URL.
@@ -252,6 +253,10 @@ async function install_windows() {
     return;
   }
 
+  // Add Chocolatey's bin directory to the current process PATH so that
+  // subsequent choco commands work without requiring a terminal restart
+  choco.addBinToPath();
+
   console.log('Chocolatey installed successfully.');
   console.log('');
   console.log('IMPORTANT: Close and reopen your terminal for PATH changes to take effect.');
@@ -341,6 +346,10 @@ async function install_gitbash() {
     return;
   }
 
+  // Add Chocolatey's bin directory to the current process PATH so that
+  // subsequent choco commands work without requiring a terminal restart
+  choco.addBinToPath();
+
   console.log('Chocolatey installed successfully.');
   console.log('');
   console.log('IMPORTANT: Close and reopen Git Bash for PATH changes to take effect.');

package/src/installs/installers.json

@@ -464,11 +464,13 @@
     "depends_on": [
       {
         "name": "homebrew.js",
-        "priority": 0
+        "priority": 0,
+        "platforms": ["macos"]
       },
       {
         "name": "chocolatey.js",
-        "priority": 0
+        "priority": 0,
+        "platforms": ["windows", "gitbash"]
       }
     ],
     "test_results": []
@@ -570,23 +572,28 @@
     "depends_on": [
       {
         "name": "curl.js",
-        "priority": 0
+        "priority": 0,
+        "platforms": ["ubuntu", "debian", "wsl", "raspbian", "amazon_linux", "rhel", "fedora"]
       },
       {
         "name": "ca-certificates.js",
-        "priority": 0
+        "priority": 0,
+        "platforms": ["ubuntu", "debian", "wsl", "raspbian", "amazon_linux", "rhel", "fedora"]
       },
       {
         "name": "homebrew.js",
-        "priority": 0
+        "priority": 0,
+        "platforms": ["macos"]
       },
       {
         "name": "chocolatey.js",
-        "priority": 0
+        "priority": 0,
+        "platforms": ["windows", "gitbash"]
       },
       {
         "name": "wsl.js",
-        "priority": 0
+        "priority": 0,
+        "platforms": ["windows"]
       }
     ],
     "test_results": []
@@ -747,15 +754,18 @@
     "depends_on": [
       {
         "name": "homebrew.js",
-        "priority": 0
+        "priority": 0,
+        "platforms": ["macos"]
       },
       {
         "name": "chocolatey.js",
-        "priority": 0
+        "priority": 0,
+        "platforms": ["windows", "gitbash"]
       },
       {
         "name": "software-properties-common.js",
-        "priority": 0
+        "priority": 0,
+        "platforms": ["ubuntu", "debian", "wsl", "raspbian"]
       }
     ],
     "test_results": []
@@ -864,15 +874,18 @@
     "depends_on": [
       {
         "name": "homebrew.js",
-        "priority": 0
+        "priority": 0,
+        "platforms": ["macos"]
       },
       {
         "name": "chocolatey.js",
-        "priority": 0
+        "priority": 0,
+        "platforms": ["windows", "gitbash"]
       },
       {
         "name": "pinentry.js",
-        "priority": 0
+        "priority": 0,
+        "platforms": ["macos"]
       }
     ],
     "test_results": []
@@ -1170,23 +1183,28 @@
     "depends_on": [
       {
         "name": "curl.js",
-        "priority": 0
+        "priority": 0,
+        "platforms": ["ubuntu", "debian", "wsl", "raspbian"]
       },
       {
         "name": "ca-certificates.js",
-        "priority": 0
+        "priority": 0,
+        "platforms": ["ubuntu", "debian", "wsl", "raspbian"]
       },
       {
         "name": "gpg.js",
-        "priority": 0
+        "priority": 0,
+        "platforms": ["ubuntu", "debian", "wsl", "raspbian"]
       },
       {
         "name": "homebrew.js",
-        "priority": 0
+        "priority": 0,
+        "platforms": ["macos"]
       },
       {
         "name": "chocolatey.js",
-        "priority": 0
+        "priority": 0,
+        "platforms": ["windows", "gitbash"]
       }
     ],
     "test_results": []
@@ -1332,11 +1350,13 @@
     "depends_on": [
       {
         "name": "homebrew.js",
-        "priority": 0
+        "priority": 0,
+        "platforms": ["macos"]
       },
       {
         "name": "chocolatey.js",
-        "priority": 0
+        "priority": 0,
+        "platforms": ["windows", "gitbash"]
       }
     ],
     "test_results": []
@@ -2045,11 +2065,13 @@
     "depends_on": [
       {
         "name": "homebrew.js",
-        "priority": 0
+        "priority": 0,
+        "platforms": ["macos"]
       },
       {
         "name": "chocolatey.js",
-        "priority": 0
+        "priority": 0,
+        "platforms": ["windows", "gitbash"]
       }
     ],
     "test_results": []

package/src/installs/wget.js

@@ -239,14 +239,19 @@ async function install_windows() {
     return;
   }
 
-  // Verify the installation succeeded by checking if the package is now installed
-  const verified = await choco.isPackageInstalled('wget');
+  // Verify the installation by checking if the binary exists in Chocolatey's bin directory
+  // This works even when PATH hasn't been updated in the current terminal session
+  const verified = choco.commandBinaryExists('wget');
   if (!verified) {
-    console.log('Installation may have failed: wget package not found after install.');
+    // Binary not found - this is unexpected since choco.install() succeeded
+    console.log('Warning: wget binary not found in Chocolatey bin directory.');
+    console.log('The package may use a different executable name.');
+    console.log('');
+    console.log('Try running in a new terminal: wget --version');
     return;
   }
 
-  console.log('wget installed successfully via Chocolatey.');
+  console.log('wget installed successfully.');
   console.log('');
   console.log('Note: In PowerShell, use "wget.exe" (with the extension) to run GNU wget,');
   console.log('as "wget" is an alias for Invoke-WebRequest.');

package/src/scripts/mkd.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * mkd - Create a new directory and display navigation instructions
+ * mkd - Create a new directory and change into it
  *
  * Migrated from legacy dotfiles function.
  * Original:
@@ -9,16 +9,21 @@
  *       mkdir -p "$@" && cd "$@"
  *   }
  *
- * This script creates a new directory (including all necessary parent directories)
- * and outputs instructions for navigating into it. The original shell function could
- * change the working directory directly, but since Node.js scripts run in a subprocess,
- * they cannot modify the parent shell's working directory.
+ * This script creates a new directory (including all necessary parent directories).
+ * Since Node.js scripts run in a subprocess, they cannot directly change the parent
+ * shell's working directory. To get the original "mkdir and cd" behavior, use the
+ * --print flag with command substitution:
  *
  * Usage:
- *   mkd my-project                    # Creates ./my-project
+ *   cd $(mkd -p my-project)           # Create and cd into directory (RECOMMENDED)
+ *   cd $(mkd --print my-project)      # Same as above, long form
+ *   mkd my-project                    # Just creates directory, shows instructions
  *   mkd path/to/nested/directory      # Creates all parent directories as needed
  *   mkd ~/projects/new-app            # Works with home directory paths
  *
+ * Shell alias (add to .bashrc/.zshrc for seamless experience):
+ *   alias mkd='_mkd() { cd "$(command mkd -p "$1")"; }; _mkd'
+ *
  * @module scripts/mkd
  */
 
@@ -56,19 +61,27 @@ function expandTilde(inputPath) {
  *
  * @param {string[]} args - Command line arguments
  * @param {string} args.0 - Directory path to create
+ * @param {Object} options - Options
+ * @param {boolean} options.printOnly - If true, only output the path (for command substitution)
  * @returns {Promise<void>}
  */
-async function do_mkd_nodejs(args) {
+async function do_mkd_nodejs(args, options = {}) {
+  const { printOnly = false } = options;
+
   // Validate arguments
   if (args.length === 0) {
-    console.error('Usage: mkd <directory>');
+    console.error('Usage: mkd [options] <directory>');
     console.error('');
     console.error('Creates a new directory, including parent directories if needed.');
     console.error('');
+    console.error('Options:');
+    console.error('  -p, --print    Output only the path (for use with cd)');
+    console.error('');
     console.error('Examples:');
-    console.error('  mkd my-project');
-    console.error('  mkd path/to/nested/directory');
-    console.error('  mkd ~/projects/new-app');
+    console.error('  mkd my-project                    # Create and show instructions');
+    console.error('  cd $(mkd -p my-project)           # Create and cd into it');
+    console.error('  mkd path/to/nested/directory      # Creates parent dirs as needed');
+    console.error('  mkd ~/projects/new-app            # Works with ~ paths');
     process.exit(1);
   }
 
@@ -89,9 +102,14 @@ async function do_mkd_nodejs(args) {
     const stats = fs.statSync(absolutePath);
     if (stats.isDirectory()) {
       // Directory already exists - this is fine (idempotent behavior)
-      console.log(`Directory already exists: ${absolutePath}`);
-      console.log('');
-      console.log(`To navigate there, run: cd "${absolutePath}"`);
+      if (printOnly) {
+        // In print mode, just output the path for command substitution
+        console.log(absolutePath);
+      } else {
+        console.log(`Directory already exists: ${absolutePath}`);
+        console.log('');
+        console.log(`To navigate there, run: cd "${absolutePath}"`);
+      }
       return;
     } else {
       // A file with the same name exists - this is an error
@@ -127,11 +145,23 @@ async function do_mkd_nodejs(args) {
   }
 
   // Success! Print the result
-  // Note: Unlike the original shell function, we cannot change the parent shell's
-  // working directory. We provide instructions instead.
-  console.log(`Created directory: ${absolutePath}`);
-  console.log('');
-  console.log(`To navigate there, run: cd "${absolutePath}"`);
+  if (printOnly) {
+    // In print mode, just output the path for command substitution
+    // This enables: cd $(mkd -p my-project)
+    console.log(absolutePath);
+  } else {
+    console.log(`Created directory: ${absolutePath}`);
+    console.log('');
+    console.log(`To navigate there, run: cd "${absolutePath}"`);
+    console.log('');
+    // Show platform-appropriate tip for command substitution
+    if (process.platform === 'win32') {
+      console.log('Tip (PowerShell): cd (mkd -p <dir>)');
+      console.log('Tip (Git Bash):   cd $(mkd -p <dir>)');
+    } else {
+      console.log('Tip: Use cd $(mkd -p <dir>) to create and cd in one step.');
+    }
+  }
 }
 
 /**
@@ -141,10 +171,11 @@ async function do_mkd_nodejs(args) {
  * identically on macOS as on other platforms.
  *
  * @param {string[]} args - Command line arguments
+ * @param {Object} options - Options passed through to do_mkd_nodejs
  * @returns {Promise<void>}
  */
-async function do_mkd_macos(args) {
-  return do_mkd_nodejs(args);
+async function do_mkd_macos(args, options) {
+  return do_mkd_nodejs(args, options);
 }
 
 /**
@@ -154,10 +185,11 @@ async function do_mkd_macos(args) {
  * identically on Linux as on other platforms.
  *
  * @param {string[]} args - Command line arguments
+ * @param {Object} options - Options passed through to do_mkd_nodejs
  * @returns {Promise<void>}
  */
-async function do_mkd_ubuntu(args) {
-  return do_mkd_nodejs(args);
+async function do_mkd_ubuntu(args, options) {
+  return do_mkd_nodejs(args, options);
 }
 
 /**
@@ -167,10 +199,11 @@ async function do_mkd_ubuntu(args) {
  * identically on Raspberry Pi OS as on other platforms.
  *
  * @param {string[]} args - Command line arguments
+ * @param {Object} options - Options passed through to do_mkd_nodejs
  * @returns {Promise<void>}
  */
-async function do_mkd_raspbian(args) {
-  return do_mkd_nodejs(args);
+async function do_mkd_raspbian(args, options) {
+  return do_mkd_nodejs(args, options);
 }
 
 /**
@@ -180,10 +213,11 @@ async function do_mkd_raspbian(args) {
  * identically on Amazon Linux as on other platforms.
  *
  * @param {string[]} args - Command line arguments
+ * @param {Object} options - Options passed through to do_mkd_nodejs
  * @returns {Promise<void>}
  */
-async function do_mkd_amazon_linux(args) {
-  return do_mkd_nodejs(args);
+async function do_mkd_amazon_linux(args, options) {
+  return do_mkd_nodejs(args, options);
 }
 
 /**
@@ -194,10 +228,11 @@ async function do_mkd_amazon_linux(args) {
  * handles Windows path separators automatically.
  *
  * @param {string[]} args - Command line arguments
+ * @param {Object} options - Options passed through to do_mkd_nodejs
  * @returns {Promise<void>}
  */
-async function do_mkd_cmd(args) {
-  return do_mkd_nodejs(args);
+async function do_mkd_cmd(args, options) {
+  return do_mkd_nodejs(args, options);
 }
 
 /**
@@ -207,10 +242,11 @@ async function do_mkd_cmd(args) {
  * identically across all platforms and shells.
  *
  * @param {string[]} args - Command line arguments
+ * @param {Object} options - Options passed through to do_mkd_nodejs
  * @returns {Promise<void>}
  */
-async function do_mkd_powershell(args) {
-  return do_mkd_nodejs(args);
+async function do_mkd_powershell(args, options) {
+  return do_mkd_nodejs(args, options);
 }
 
 /**
@@ -220,10 +256,11 @@ async function do_mkd_powershell(args) {
  * Unix-style and Windows-style paths, and Node.js handles the conversion.
  *
  * @param {string[]} args - Command line arguments
+ * @param {Object} options - Options passed through to do_mkd_nodejs
  * @returns {Promise<void>}
  */
-async function do_mkd_gitbash(args) {
-  return do_mkd_nodejs(args);
+async function do_mkd_gitbash(args, options) {
+  return do_mkd_nodejs(args, options);
 }
 
 /**
@@ -231,27 +268,37 @@ async function do_mkd_gitbash(args) {
  *
  * The "mkd" (make directory) command is a developer convenience tool that:
  * 1. Creates a new directory, including all parent directories if needed
- * 2. Provides the cd command to navigate to the new directory
+ * 2. Outputs the path (with -p flag) for use with cd command substitution
  *
  * This replicates the shell function pattern of creating a directory and
  * immediately entering it, common in developer workflows when starting
  * new projects or organizing files.
  *
- * Note: Unlike the original shell function, this script cannot change the
- * parent shell's working directory. Node.js scripts run in a subprocess and
- * cannot affect the parent process's environment. The script outputs the
- * cd command for the user to run.
- *
- * For a true "mkdir and cd" experience, users can use a shell alias:
- *   alias mkd='function _mkd(){ mkd "$1" && cd "$1"; }; _mkd'
- * Or use command substitution:
- *   cd $(mkd --quiet my-dir)  # If --quiet flag were implemented
+ * Usage patterns:
+ *   mkd my-dir              # Creates dir, shows instructions
+ *   cd $(mkd -p my-dir)     # Creates dir and cd into it (RECOMMENDED)
  *
  * @param {string[]} args - Command line arguments
- * @param {string} args.0 - Directory path to create
+ * @param {string} args.0 - Directory path to create (or -p/--print flag)
  * @returns {Promise<void>}
  */
 async function do_mkd(args) {
+  // Parse options
+  const options = { printOnly: false };
+  const remainingArgs = [];
+
+  for (const arg of args) {
+    if (arg === '-p' || arg === '--print') {
+      options.printOnly = true;
+    } else if (arg === '-h' || arg === '--help') {
+      // Show help by calling with empty args
+      remainingArgs.length = 0;
+      break;
+    } else {
+      remainingArgs.push(arg);
+    }
+  }
+
   const platform = os.detect();
 
   const handlers = {
@@ -283,7 +330,7 @@ async function do_mkd(args) {
     process.exit(1);
   }
 
-  await handler(args);
+  await handler(remainingArgs, options);
 }
 
 module.exports = {

package/src/utils/windows/choco.js

@@ -17,6 +17,43 @@ const fs = require('fs');
  */
 const CHOCO_KNOWN_PATH = 'C:\\ProgramData\\chocolatey\\bin\\choco.exe';
 
+/**
+ * Well-known directory where Chocolatey installs command binaries.
+ * All Chocolatey-installed commands get shims placed here.
+ */
+const CHOCO_BIN_DIR = 'C:\\ProgramData\\chocolatey\\bin';
+
+/**
+ * Adds Chocolatey's bin directory to the current process's PATH.
+ *
+ * This is necessary after installing Chocolatey because the PATH environment
+ * variable in the current Node.js process won't be updated until a new terminal
+ * is opened. By manually adding the bin directory, subsequent child processes
+ * spawned by this process will be able to find Chocolatey-installed commands.
+ *
+ * This function is idempotent - it won't add the path if it's already present.
+ *
+ * @returns {boolean} True if PATH was modified, false if already present
+ */
+function addBinToPath() {
+  const currentPath = process.env.PATH || '';
+  const pathSeparator = ';';
+
+  // Check if already in PATH (case-insensitive on Windows)
+  const paths = currentPath.split(pathSeparator);
+  const alreadyInPath = paths.some(p =>
+    p.toLowerCase() === CHOCO_BIN_DIR.toLowerCase()
+  );
+
+  if (alreadyInPath) {
+    return false;
+  }
+
+  // Prepend Chocolatey bin directory to PATH
+  process.env.PATH = `${CHOCO_BIN_DIR}${pathSeparator}${currentPath}`;
+  return true;
+}
+
 /**
  * Checks if Chocolatey is installed.
  *
@@ -59,6 +96,48 @@ function getExecutablePath() {
   return null;
 }
 
+/**
+ * Checks if a command binary exists in Chocolatey's bin directory.
+ *
+ * This is useful for verifying installations when the PATH hasn't been
+ * updated yet. Chocolatey creates shims (small .exe files) in its bin
+ * directory for all installed commands.
+ *
+ * @param {string} commandName - The command name (without .exe extension)
+ * @returns {boolean} True if the binary exists in Chocolatey's bin directory
+ */
+function commandBinaryExists(commandName) {
+  const path = require('path');
+  const binaryPath = path.join(CHOCO_BIN_DIR, `${commandName}.exe`);
+
+  try {
+    return fs.existsSync(binaryPath);
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Gets the full path to a command's binary in Chocolatey's bin directory.
+ *
+ * @param {string} commandName - The command name (without .exe extension)
+ * @returns {string|null} Full path to the binary, or null if not found
+ */
+function getCommandBinaryPath(commandName) {
+  const path = require('path');
+  const binaryPath = path.join(CHOCO_BIN_DIR, `${commandName}.exe`);
+
+  try {
+    if (fs.existsSync(binaryPath)) {
+      return binaryPath;
+    }
+  } catch {
+    // Ignore errors
+  }
+
+  return null;
+}
+
 /**
  * Returns the installed Chocolatey version
  * @returns {Promise<string|null>}
@@ -368,6 +447,9 @@ async function unpin(packageName) {
 module.exports = {
   isInstalled,
   getExecutablePath,
+  addBinToPath,
+  commandBinaryExists,
+  getCommandBinaryPath,
   getVersion,
   install,
   uninstall,

package/src/utils/windows/winget.js

@@ -23,6 +23,50 @@ const WINGET_KNOWN_PATH = path.join(
   'winget.exe'
 );
 
+/**
+ * The WindowsApps directory containing Microsoft Store app aliases.
+ */
+const WINDOWS_APPS_DIR = path.join(
+  process.env.LOCALAPPDATA || '',
+  'Microsoft',
+  'WindowsApps'
+);
+
+/**
+ * Adds the WindowsApps directory to the current process's PATH.
+ *
+ * This ensures that winget and other Microsoft Store apps are accessible
+ * to child processes spawned by this Node.js process. Normally this directory
+ * is in PATH, but in some environments (like fresh installations or CI) it may
+ * not be.
+ *
+ * This function is idempotent - it won't add the path if it's already present.
+ *
+ * @returns {boolean} True if PATH was modified, false if already present
+ */
+function addBinToPath() {
+  if (!WINDOWS_APPS_DIR) {
+    return false;
+  }
+
+  const currentPath = process.env.PATH || '';
+  const pathSeparator = ';';
+
+  // Check if already in PATH (case-insensitive on Windows)
+  const paths = currentPath.split(pathSeparator);
+  const alreadyInPath = paths.some(p =>
+    p.toLowerCase() === WINDOWS_APPS_DIR.toLowerCase()
+  );
+
+  if (alreadyInPath) {
+    return false;
+  }
+
+  // Prepend WindowsApps directory to PATH
+  process.env.PATH = `${WINDOWS_APPS_DIR}${pathSeparator}${currentPath}`;
+  return true;
+}
+
 /**
  * Checks if winget is available.
  *
@@ -429,6 +473,7 @@ async function updateSources() {
 module.exports = {
   isInstalled,
   getExecutablePath,
+  addBinToPath,
   getVersion,
   install,
   uninstall,