node-power-user 2.1.3 → 2.1.4

package/README.md

@@ -106,6 +106,10 @@ npu outdated
 npu out --force  # bypass Socket protection
 ```
 
+When discrepancies are found between `package.json` and `node_modules`, the menu offers context-aware actions:
+- **Sync** — when `node_modules` is *behind* `package.json`, installs packages to match what `package.json` declares.
+- **Reconcile** — when `node_modules` is *ahead* of `package.json`, updates `package.json` to match installed versions.
+
 ### List Packages
 List all packages in your project.
 ```shell
@@ -137,6 +141,7 @@ npu wait <ms>
 ```
 
 ### Global flags
+  * `-C <dir>`, `--cwd <dir>`: Run as if invoked from `<dir>` (e.g. `npu -C /path/to/project out`)
   * `--debug`: Log the commands and flags before they are executed
 
 ## 🛠️ Development

package/bin/node-power-user

@@ -1,6 +1,13 @@
 #!/usr/bin/env node
 const { hideBin } = require('yargs/helpers');
 const argv = require('yargs')(hideBin(process.argv)).parseSync();
+
+// --cwd / -C: run as if invoked from a different directory
+const targetDir = argv.cwd || argv.C;
+if (targetDir) {
+  process.chdir(targetDir);
+}
+
 const cli = new (require('../dist/cli.js'))();
 (async function() {
   'use strict';

package/dist/commands/install.js

@@ -1,6 +1,8 @@
 // Libraries
 const logger = new (require('../lib/logger'))('node-power-user');
 const socket = require('../lib/socket');
+const jetpack = require('fs-jetpack');
+const path = require('path');
 
 // Module
 module.exports = async function (options) {
@@ -22,6 +24,26 @@ module.exports = async function (options) {
     flags.push('--global');
   }
 
+  // When installing specific packages with a version/tag (e.g. @latest, @^2.0.0),
+  // remove existing node_modules copies first so npm actually re-fetches them
+  // instead of reporting "up to date" with a stale cached version.
+  if (packages.length > 0 && !flags.includes('--global')) {
+    for (const pkg of packages) {
+      // For scoped packages like @scope/name@version, skip the leading @
+      const searchFrom = pkg.startsWith('@') ? 1 : 0;
+      const versionIdx = pkg.indexOf('@', searchFrom);
+      if (versionIdx <= 0) {
+        continue;
+      }
+
+      const pkgName = pkg.substring(0, versionIdx);
+      const pkgDir = path.join(process.cwd(), 'node_modules', pkgName);
+      if (jetpack.exists(pkgDir)) {
+        jetpack.remove(pkgDir);
+      }
+    }
+  }
+
   const command = packages.length > 0
     ? `npm install ${packages.join(' ')} ${flags.join(' ')}`.trim()
     : `npm install ${flags.join(' ')}`.trim();

package/dist/commands/outdated.js

@@ -143,8 +143,19 @@ module.exports = async function (options) {
     logger.log(chalk.dim('Legend: ') + chalk.magenta('⚠ = major version (breaking changes)'));
   }
 
-  // Get counts for menu (only show a tier if it offers upgrades beyond the tier below)
+  // Separate discrepancies into two categories:
+  // - "behind": node_modules has an OLDER version than package.json wants (needs npm install)
+  // - "ahead": node_modules has a NEWER version than package.json specifies (reconcile package.json)
   const discrepancies = [...allPackages.values()].filter(pkg => pkg.hasDiscrepancy);
+  const behindPackages = discrepancies.filter(pkg =>
+    pkg.installedVersion !== '?' && version.is(pkg.installedVersion, '<', pkg.packageVersion)
+  );
+  const aheadPackages = discrepancies.filter(pkg =>
+    pkg.installedVersion !== '?' && version.is(pkg.installedVersion, '>', pkg.packageVersion)
+  );
+  const unknownPackages = discrepancies.filter(pkg => pkg.installedVersion === '?');
+
+  // Get counts for menu (only show a tier if it offers upgrades beyond the tier below)
   const patchCount = Object.keys(patchUpgrades).length;
   const minorCount = Object.keys(minorUpgrades).length;
   const majorCount = Object.keys(latestUpgrades).length;
@@ -180,9 +191,19 @@ module.exports = async function (options) {
   if (!action) {
     const choices = [];
 
-    if (discrepancies.length > 0) {
+    // "Sync" installs packages where node_modules is behind package.json
+    const syncCount = behindPackages.length + unknownPackages.length;
+    if (syncCount > 0) {
+      choices.push({
+        name: `Sync (${syncCount}) - install packages to match package.json`,
+        value: 'sync',
+      });
+    }
+
+    // "Reconcile" updates package.json where node_modules is ahead
+    if (aheadPackages.length > 0) {
       choices.push({
-        name: `Reconcile (${discrepancies.length}) - sync package.json to installed versions`,
+        name: `Reconcile (${aheadPackages.length}) - sync package.json to installed versions`,
         value: 'reconcile',
       });
     }
@@ -220,12 +241,39 @@ module.exports = async function (options) {
     return { allPackages };
   }
 
-  // Handle reconcile
+  // Handle sync — run npm install for packages where node_modules is behind package.json
+  if (action === 'sync') {
+    const toSync = [...behindPackages, ...unknownPackages];
+    const installCmd = `npm install ${toSync.map(pkg => `${pkg.name}@${pkg.packageVersion}`).join(' ')}`;
+    logger.log(logger.format.cyan(`\nRunning ${installCmd}...`));
+
+    try {
+      await socket.wrap(installCmd, { force: options.force });
+    } catch (e) {
+      if (e.reason === 'npm-failed') {
+        logger.log('');
+        logger.log('Fix the npm error above and retry.');
+        return { allPackages, updated: false };
+      }
+      throw e;
+    }
+
+    try {
+      await socket.audit({ force: options.force });
+    } catch (e) {
+      logger.error(`Audit warning: ${e.message}`);
+    }
+
+    logger.log(logger.format.green(`\nSynced ${toSync.length} package(s) to match package.json.`));
+    return { allPackages, synced: true };
+  }
+
+  // Handle reconcile — update package.json for packages where node_modules is ahead
   if (action === 'reconcile') {
-    // Re-read in case it changed
     projectJson = jetpack.read(packageJsonPath, 'json');
 
-    for (const pkg of discrepancies) {
+    const toReconcile = aheadPackages.length > 0 ? aheadPackages : discrepancies;
+    for (const pkg of toReconcile) {
       const depType = pkg.type === 'dev' ? 'devDependencies'
         : pkg.type === 'peer' ? 'peerDependencies'
         : 'dependencies';
@@ -234,7 +282,7 @@ module.exports = async function (options) {
     }
 
     jetpack.write(packageJsonPath, projectJson);
-    logger.log(logger.format.green(`\nReconciled ${discrepancies.length} package(s) in package.json.`));
+    logger.log(logger.format.green(`\nReconciled ${toReconcile.length} package(s) in package.json.`));
 
     return { allPackages, reconciled: true };
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-power-user",
-  "version": "2.1.3",
+  "version": "2.1.4",
   "description": "Easy tools for every Node.js developer!",
   "main": "dist/index.js",
   "scripts": {