socket 1.1.11 → 1.1.13

package/dist/cli.js

@@ -68,7 +68,7 @@ async function fetchRepoAnalyticsData(repo, time, options) {
 
 // Note: Widgets does not seem to actually work as code :'(
 
-const require$5 = require$$5.createRequire((typeof document === 'undefined' ? require$$0.pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli.js', document.baseURI).href)));
+const require$8 = require$$5.createRequire((typeof document === 'undefined' ? require$$0.pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli.js', document.baseURI).href)));
 const METRICS = ['total_critical_alerts', 'total_high_alerts', 'total_medium_alerts', 'total_low_alerts', 'total_critical_added', 'total_medium_added', 'total_low_added', 'total_high_added', 'total_critical_prevented', 'total_high_prevented', 'total_medium_prevented', 'total_low_prevented'];
 
 // Note: This maps `new Date(date).getMonth()` to English three letters
@@ -147,11 +147,11 @@ ${utils.mdTableStringNumber('Name', 'Counts', data['top_five_alert_types'])}
 `.trim() + '\n';
 }
 function displayAnalyticsScreen(data) {
-  const ScreenWidget = /*@__PURE__*/require$5('../external/blessed/lib/widgets/screen.js');
+  const ScreenWidget = /*@__PURE__*/require$8('../external/blessed/lib/widgets/screen.js');
   const screen = new ScreenWidget({
     ...constants.default.blessedOptions
   });
-  const GridLayout = /*@__PURE__*/require$5('../external/blessed-contrib/lib/layout/grid.js');
+  const GridLayout = /*@__PURE__*/require$8('../external/blessed-contrib/lib/layout/grid.js');
   const grid = new GridLayout({
     rows: 5,
     cols: 4,
@@ -165,7 +165,7 @@ function displayAnalyticsScreen(data) {
   renderLineCharts(grid, screen, 'Total high alerts prevented from the main branch', [2, 2, 1, 2], data['total_high_prevented']);
   renderLineCharts(grid, screen, 'Total medium alerts prevented from the main branch', [3, 0, 1, 2], data['total_medium_prevented']);
   renderLineCharts(grid, screen, 'Total low alerts prevented from the main branch', [3, 2, 1, 2], data['total_low_prevented']);
-  const BarChart = /*@__PURE__*/require$5('../external/blessed-contrib/lib/widget/charts/bar.js');
+  const BarChart = /*@__PURE__*/require$8('../external/blessed-contrib/lib/widget/charts/bar.js');
   const bar = grid.set(4, 0, 1, 2, BarChart, {
     label: 'Top 5 alert types',
     barWidth: 10,
@@ -265,7 +265,7 @@ function formatDate(date) {
   return `${Months[new Date(date).getMonth()]} ${new Date(date).getDate()}`;
 }
 function renderLineCharts(grid, screen, title, coords, data) {
-  const LineChart = /*@__PURE__*/require$5('../external/blessed-contrib/lib/widget/charts/line.js');
+  const LineChart = /*@__PURE__*/require$8('../external/blessed-contrib/lib/widget/charts/line.js');
   const line = grid.set(...coords, LineChart, {
     style: {
       line: 'cyan',
@@ -323,21 +323,21 @@ async function handleAnalytics({
   });
 }
 
-const CMD_NAME$w = 'analytics';
-const description$D = 'Look up analytics data';
-const hidden$v = false;
+const CMD_NAME$y = 'analytics';
+const description$F = 'Look up analytics data';
+const hidden$x = false;
 const cmdAnalytics = {
-  description: description$D,
-  hidden: hidden$v,
-  run: run$Q
+  description: description$F,
+  hidden: hidden$x,
+  run: run$S
 };
-async function run$Q(argv, importMeta, {
+async function run$S(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$w,
-    description: description$D,
-    hidden: hidden$v,
+    commandName: CMD_NAME$y,
+    description: description$F,
+    hidden: hidden$x,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags,
@@ -354,7 +354,7 @@ async function run$Q(argv, importMeta, {
       $ ${command} [options] [ "org" | "repo" <reponame>] [TIME]
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$w}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$y}`)}
 
     The scope is either org or repo level, defaults to org.
 
@@ -500,7 +500,7 @@ async function fetchAuditLog(config, options) {
   });
 }
 
-const require$4 = require$$5.createRequire((typeof document === 'undefined' ? require$$0.pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli.js', document.baseURI).href)));
+const require$7 = require$$5.createRequire((typeof document === 'undefined' ? require$$0.pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli.js', document.baseURI).href)));
 async function outputAuditLog(result, {
   logType,
   orgSlug,
@@ -628,7 +628,7 @@ async function outputWithBlessed(data, orgSlug) {
   const headers = [' Event id', ' Created at', ' Event type', ' User email', ' IP address', ' User agent'];
 
   // Note: this temporarily takes over the terminal (just like `man` does).
-  const ScreenWidget = /*@__PURE__*/require$4('../external/blessed/lib/widgets/screen.js');
+  const ScreenWidget = /*@__PURE__*/require$7('../external/blessed/lib/widgets/screen.js');
   const screen = new ScreenWidget({
     ...constants.default.blessedOptions
   });
@@ -637,7 +637,7 @@ async function outputWithBlessed(data, orgSlug) {
   // node process just to exit it. That's very bad UX.
   // eslint-disable-next-line n/no-process-exit
   screen.key(['escape', 'q', 'C-c'], () => process.exit(0));
-  const TableWidget = /*@__PURE__*/require$4('../external/blessed-contrib/lib/widget/table.js');
+  const TableWidget = /*@__PURE__*/require$7('../external/blessed-contrib/lib/widget/table.js');
   const tipsBoxHeight = 1; // 1 row for tips box
   const detailsBoxHeight = 20; // bottom N rows for details box. 20 gives 4 lines for condensed payload before it scrolls out of view
 
@@ -667,7 +667,7 @@ async function outputWithBlessed(data, orgSlug) {
     columnSpacing: 4,
     truncate: '_'
   });
-  const BoxWidget = /*@__PURE__*/require$4('../external/blessed/lib/widgets/box.js');
+  const BoxWidget = /*@__PURE__*/require$7('../external/blessed/lib/widgets/box.js');
   const tipsBox = new BoxWidget({
     bottom: detailsBoxHeight,
     // sits just above the details box
@@ -748,21 +748,21 @@ async function handleAuditLog({
   });
 }
 
-const CMD_NAME$v = 'audit-log';
-const description$C = 'Look up the audit log for an organization';
-const hidden$u = false;
+const CMD_NAME$x = 'audit-log';
+const description$E = 'Look up the audit log for an organization';
+const hidden$w = false;
 const cmdAuditLog = {
-  description: description$C,
-  hidden: hidden$u,
-  run: run$P
+  description: description$E,
+  hidden: hidden$w,
+  run: run$R
 };
-async function run$P(argv, importMeta, {
+async function run$R(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$v,
-    description: description$C,
-    hidden: hidden$u,
+    commandName: CMD_NAME$x,
+    description: description$E,
+    hidden: hidden$w,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags,
@@ -790,7 +790,7 @@ async function run$P(argv, importMeta, {
       $ ${command} [options] [FILTER]
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$v}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$x}`)}
 
     This feature requires an Enterprise Plan. To learn more about getting access
     to this feature and many more, please visit ${constants.default.SOCKET_WEBSITE_URL}/pricing
@@ -1574,7 +1574,7 @@ async function performReachabilityAnalysis(options) {
     return {
       ok: false,
       message: 'Tier 1 Reachability analysis requires an enterprise plan',
-      cause: `Please ${vendor.terminalLinkExports('upgrade your plan', 'https://socket.dev/pricing')}. This feature is only available for organizations with an enterprise plan.`
+      cause: `Please ${vendor.terminalLinkExports('upgrade your plan', `${constants.SOCKET_WEBSITE_URL}/pricing`)}. This feature is only available for organizations with an enterprise plan.`
     };
   }
   const wasSpinning = !!spinner?.isSpinning;
@@ -1671,25 +1671,25 @@ sockJson, cwd = process.cwd()) {
     sbt: false
   };
   if (sockJson?.defaults?.manifest?.sbt?.disabled) {
-    require$$9.debugLog('notice', '[DEBUG] - sbt auto-detection is disabled in socket.json');
+    require$$9.debugLog('notice', `[DEBUG] - sbt auto-detection is disabled in ${constants.SOCKET_JSON}`);
   } else if (fs$1.existsSync(path.join(cwd, 'build.sbt'))) {
     require$$9.debugLog('notice', '[DEBUG] - Detected a Scala sbt build file');
     output.sbt = true;
     output.count += 1;
   }
   if (sockJson?.defaults?.manifest?.gradle?.disabled) {
-    require$$9.debugLog('notice', '[DEBUG] - gradle auto-detection is disabled in socket.json');
+    require$$9.debugLog('notice', `[DEBUG] - gradle auto-detection is disabled in ${constants.SOCKET_JSON}`);
   } else if (fs$1.existsSync(path.join(cwd, 'gradlew'))) {
     require$$9.debugLog('notice', '[DEBUG] - Detected a gradle build file');
     output.gradle = true;
     output.count += 1;
   }
   if (sockJson?.defaults?.manifest?.conda?.disabled) {
-    require$$9.debugLog('notice', '[DEBUG] - conda auto-detection is disabled in socket.json');
+    require$$9.debugLog('notice', `[DEBUG] - conda auto-detection is disabled in ${constants.SOCKET_JSON}`);
   } else {
-    const envyml = path.join(cwd, 'environment.yml');
+    const envyml = path.join(cwd, constants.ENVIRONMENT_YML);
     const hasEnvyml = fs$1.existsSync(envyml);
-    const envyaml = path.join(cwd, 'environment.yaml');
+    const envyaml = path.join(cwd, constants.ENVIRONMENT_YAML);
     const hasEnvyaml = !hasEnvyml && fs$1.existsSync(envyaml);
     if (hasEnvyml || hasEnvyaml) {
       require$$9.debugLog('notice', '[DEBUG] - Detected an environment.yml Conda file');
@@ -2057,9 +2057,9 @@ async function outputRequirements(result, outputKind, out) {
     const arr = [];
     arr.push('# Converted Conda file');
     arr.push('');
-    arr.push('This is the Conda `environment.yml` file converted to python `requirements.txt`:');
+    arr.push(`This is the Conda \`environment.yml\` file converted to python \`${constants.REQUIREMENTS_TXT}\`:`);
     arr.push('');
-    arr.push('```file=requirements.txt');
+    arr.push(`\`\`\`file=${constants.REQUIREMENTS_TXT}`);
     arr.push(result.data.pip);
     arr.push('```');
     arr.push('');
@@ -2098,7 +2098,7 @@ async function generateAutoManifest({
 }) {
   const sockJson = utils.readOrDefaultSocketJson(cwd);
   if (verbose) {
-    logger.logger.info('Using this socket.json for defaults:', sockJson);
+    logger.logger.info(`Using this ${constants.SOCKET_JSON} for defaults:`, sockJson);
   }
   if (!sockJson?.defaults?.manifest?.sbt?.disabled && detected.sbt) {
     logger.logger.log('Detected a Scala sbt build, generating pom files with sbt...');
@@ -2129,7 +2129,7 @@ async function generateAutoManifest({
       cwd,
       filename: sockJson.defaults?.manifest?.conda?.infile ?? 'environment.yml',
       outputKind,
-      out: sockJson.defaults?.manifest?.conda?.outfile ?? 'requirements.txt',
+      out: sockJson.defaults?.manifest?.conda?.outfile ?? constants.REQUIREMENTS_TXT,
       verbose: Boolean(sockJson.defaults?.manifest?.conda?.verbose)
     });
   }
@@ -2369,9 +2369,9 @@ const config$k = {
 const cmdCI = {
   description: config$k.description,
   hidden: config$k.hidden,
-  run: run$O
+  run: run$Q
 };
-async function run$O(argv, importMeta, {
+async function run$Q(argv, importMeta, {
   parentName
 }) {
   const cli = utils.meowOrExit({
@@ -2613,21 +2613,21 @@ async function handleConfigAuto({
   await outputConfigAuto(key, result, outputKind);
 }
 
-const CMD_NAME$u = 'auto';
-const description$B = 'Automatically discover and set the correct value config item';
-const hidden$t = false;
+const CMD_NAME$w = 'auto';
+const description$D = 'Automatically discover and set the correct value config item';
+const hidden$v = false;
 const cmdConfigAuto = {
-  description: description$B,
-  hidden: hidden$t,
-  run: run$N
+  description: description$D,
+  hidden: hidden$v,
+  run: run$P
 };
-async function run$N(argv, importMeta, {
+async function run$P(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$u,
-    description: description$B,
-    hidden: hidden$t,
+    commandName: CMD_NAME$w,
+    description: description$D,
+    hidden: hidden$v,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags
@@ -2757,9 +2757,9 @@ ${utils.getSupportedConfigEntries().map(({
 const cmdConfigGet = {
   description: config$j.description,
   hidden: config$j.hidden,
-  run: run$M
+  run: run$O
 };
-async function run$M(argv, importMeta, {
+async function run$O(argv, importMeta, {
   parentName
 }) {
   const cli = utils.meowOrExit({
@@ -2893,9 +2893,9 @@ const config$i = {
 const cmdConfigList = {
   description: config$i.description,
   hidden: config$i.hidden,
-  run: run$L
+  run: run$N
 };
-async function run$L(argv, importMeta, {
+async function run$N(argv, importMeta, {
   parentName
 }) {
   const cli = utils.meowOrExit({
@@ -2969,21 +2969,21 @@ async function handleConfigSet({
   await outputConfigSet(result, outputKind);
 }
 
-const CMD_NAME$t = 'set';
-const description$A = 'Update the value of a local CLI config item';
-const hidden$s = false;
+const CMD_NAME$v = 'set';
+const description$C = 'Update the value of a local CLI config item';
+const hidden$u = false;
 const cmdConfigSet = {
-  description: description$A,
-  hidden: hidden$s,
-  run: run$K
+  description: description$C,
+  hidden: hidden$u,
+  run: run$M
 };
-async function run$K(argv, importMeta, {
+async function run$M(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$t,
-    description: description$A,
-    hidden: hidden$s,
+    commandName: CMD_NAME$v,
+    description: description$C,
+    hidden: hidden$u,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags
@@ -3096,21 +3096,21 @@ async function handleConfigUnset({
   await outputConfigUnset(updateResult, outputKind);
 }
 
-const CMD_NAME$s = 'unset';
-const description$z = 'Clear the value of a local CLI config item';
-const hidden$r = false;
+const CMD_NAME$u = 'unset';
+const description$B = 'Clear the value of a local CLI config item';
+const hidden$t = false;
 const cmdConfigUnset = {
-  description: description$z,
-  hidden: hidden$r,
-  run: run$J
+  description: description$B,
+  hidden: hidden$t,
+  run: run$L
 };
-async function run$J(argv, importMeta, {
+async function run$L(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$s,
-    description: description$z,
-    hidden: hidden$r,
+    commandName: CMD_NAME$u,
+    description: description$B,
+    hidden: hidden$t,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags
@@ -3172,9 +3172,9 @@ ${utils.getSupportedConfigEntries().map(({
   });
 }
 
-const description$y = 'Manage Socket CLI configuration';
+const description$A = 'Manage Socket CLI configuration';
 const cmdConfig = {
-  description: description$y,
+  description: description$A,
   hidden: false,
   async run(argv, importMeta, {
     parentName
@@ -3187,7 +3187,7 @@ const cmdConfig = {
       unset: cmdConfigUnset
     }, {
       argv,
-      description: description$y,
+      description: description$A,
       importMeta,
       name: `${parentName} config`
     });
@@ -3442,7 +3442,9 @@ async function coanaFix(fixConfig) {
     cwd,
     ghsas,
     limit,
+    onlyCompute,
     orgSlug,
+    outputFile,
     spinner
   } = fixConfig;
   const fixEnv = await getFixEnv();
@@ -3494,7 +3496,7 @@ async function coanaFix(fixConfig) {
         }
       };
     }
-    const fixCResult = await utils.spawnCoana(['compute-fixes-and-upgrade-purls', cwd, '--manifests-tar-hash', tarHash, '--apply-fixes-to', ...(isAll ? ['all'] : ghsas), ...(fixConfig.rangeStyle ? ['--range-style', fixConfig.rangeStyle] : []), ...fixConfig.unknownFlags], fixConfig.orgSlug, {
+    const fixCResult = await utils.spawnCoana(['compute-fixes-and-upgrade-purls', cwd, '--manifests-tar-hash', tarHash, '--apply-fixes-to', ...(isAll ? ['all'] : ghsas), ...(fixConfig.rangeStyle ? ['--range-style', fixConfig.rangeStyle] : []), ...fixConfig.unknownFlags, ...(onlyCompute ? ['--dry-run'] : []), ...(outputFile ? ['--output-file', outputFile] : [])], fixConfig.orgSlug, {
       cwd,
       spinner,
       stdio: 'inherit'
@@ -3769,7 +3771,9 @@ async function handleFix({
   ghsas,
   limit,
   minSatisfying,
+  onlyCompute,
   orgSlug,
+  outputFile,
   outputKind,
   prCheck,
   rangeStyle,
@@ -3785,18 +3789,20 @@ async function handleFix({
     orgSlug,
     rangeStyle,
     spinner,
-    unknownFlags
+    unknownFlags,
+    onlyCompute,
+    outputFile
   }), outputKind);
 }
 
-const CMD_NAME$r = 'fix';
+const CMD_NAME$t = 'fix';
 const DEFAULT_LIMIT = 10;
-const description$x = 'Update dependencies with "fixable" Socket alerts';
-const hidden$q = false;
+const description$z = 'Update dependencies with "fixable" Socket alerts';
+const hidden$s = false;
 const cmdFix = {
-  description: description$x,
-  hidden: hidden$q,
-  run: run$I
+  description: description$z,
+  hidden: hidden$s,
+  run: run$K
 };
 const generalFlags$2 = {
   autopilot: {
@@ -3828,6 +3834,16 @@ Available styles:
   * pin - Use the exact version (e.g. 1.2.3)
   * preserve - Retain the existing version range style as-is
       `.trim()
+  },
+  onlyCompute: {
+    type: 'boolean',
+    default: false,
+    description: 'Compute fixes only, do not apply them. Logs what upgrades would be applied. If combined with --output-file, the output file will contain the upgrades that would be applied.'
+  },
+  outputFile: {
+    type: 'string',
+    default: '',
+    description: 'Path to store upgrades as a JSON file at this path.'
   }
 };
 const hiddenFlags = {
@@ -3878,13 +3894,13 @@ const hiddenFlags = {
     hidden: true
   }
 };
-async function run$I(argv, importMeta, {
+async function run$K(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$r,
-    description: description$x,
-    hidden: hidden$q,
+    commandName: CMD_NAME$t,
+    description: description$z,
+    hidden: hidden$s,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags,
@@ -3896,14 +3912,14 @@ async function run$I(argv, importMeta, {
       $ ${command} [options] [CWD=.]
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$r}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$t}`)}
 
     Options
       ${utils.getFlagListOutput(config.flags)}
 
     Examples
       $ ${command}
-      $ ${command} ./proj/tree --auto-merge
+      $ ${command} ./path/to/project --range-style pin
     `
   };
   const cli = utils.meowOrExit({
@@ -3919,6 +3935,8 @@ async function run$I(argv, importMeta, {
     limit,
     markdown,
     maxSatisfying,
+    onlyCompute,
+    outputFile,
     prCheck,
     rangeStyle,
     // We patched in this feature with `npx custompatch meow` at
@@ -3971,7 +3989,9 @@ async function run$I(argv, importMeta, {
     outputKind,
     rangeStyle,
     spinner,
-    unknownFlags
+    unknownFlags,
+    onlyCompute,
+    outputFile
   });
 }
 
@@ -4128,9 +4148,9 @@ const config$h = {
 const cmdInstallCompletion = {
   description: config$h.description,
   hidden: config$h.hidden,
-  run: run$H
+  run: run$J
 };
-async function run$H(argv, importMeta, {
+async function run$J(argv, importMeta, {
   parentName
 }) {
   const cli = utils.meowOrExit({
@@ -4148,9 +4168,9 @@ async function run$H(argv, importMeta, {
   await handleInstallCompletion(String(targetName));
 }
 
-const description$w = 'Install Socket CLI tab completion';
+const description$y = 'Install Socket CLI tab completion';
 const cmdInstall = {
-  description: description$w,
+  description: description$y,
   hidden: false,
   async run(argv, importMeta, {
     parentName
@@ -4159,7 +4179,7 @@ const cmdInstall = {
       completion: cmdInstallCompletion
     }, {
       argv,
-      description: description$w,
+      description: description$y,
       importMeta,
       name: `${parentName} install`
     });
@@ -4168,7 +4188,7 @@ const cmdInstall = {
 
 async function outputCmdJson(cwd) {
   logger.logger.info('Target cwd:', constants.default.ENV.VITEST ? '<redacted>' : utils.tildify(cwd));
-  const sockJsonPath = path.join(cwd, 'socket.json');
+  const sockJsonPath = path.join(cwd, constants.SOCKET_JSON);
   const tildeSockJsonPath = constants.default.ENV.VITEST ? '<redacted>' : utils.tildify(sockJsonPath);
   if (!fs$1.existsSync(sockJsonPath)) {
     logger.logger.fail(`Not found: ${tildeSockJsonPath}`);
@@ -4192,7 +4212,7 @@ async function handleCmdJson(cwd) {
 
 const config$g = {
   commandName: 'json',
-  description: 'Display the `socket.json` that would be applied for target folder',
+  description: `Display the \`${constants.SOCKET_JSON}\` that would be applied for target folder`,
   hidden: true,
   flags: {
     ...flags.commonFlags
@@ -4201,7 +4221,7 @@ const config$g = {
     Usage
       $ ${command} [options] [CWD=.]
 
-    Display the \`socket.json\` file that would apply when running relevant commands
+    Display the \`${constants.SOCKET_JSON}\` file that would apply when running relevant commands
     in the target directory.
 
     Examples
@@ -4211,9 +4231,9 @@ const config$g = {
 const cmdJson = {
   description: config$g.description,
   hidden: config$g.hidden,
-  run: run$G
+  run: run$I
 };
-async function run$G(argv, importMeta, {
+async function run$I(argv, importMeta, {
   parentName
 }) {
   const cli = utils.meowOrExit({
@@ -4367,21 +4387,21 @@ async function attemptLogin(apiBaseUrl, apiProxy) {
   }
 }
 
-const CMD_NAME$q = 'login';
-const description$v = 'Setup Socket CLI with an API token and defaults';
-const hidden$p = false;
+const CMD_NAME$s = 'login';
+const description$x = 'Setup Socket CLI with an API token and defaults';
+const hidden$r = false;
 const cmdLogin = {
-  description: description$v,
-  hidden: hidden$p,
-  run: run$F
+  description: description$x,
+  hidden: hidden$r,
+  run: run$H
 };
-async function run$F(argv, importMeta, {
+async function run$H(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$q,
-    description: description$v,
-    hidden: hidden$p,
+    commandName: CMD_NAME$s,
+    description: description$x,
+    hidden: hidden$r,
     flags: {
       ...flags.commonFlags,
       apiBaseUrl: {
@@ -4400,7 +4420,7 @@ async function run$F(argv, importMeta, {
       $ ${command} [options]
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$q}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$s}`)}
 
     Logs into the Socket API by prompting for an API token
 
@@ -4473,9 +4493,9 @@ const config$f = {
 const cmdLogout = {
   description: config$f.description,
   hidden: config$f.hidden,
-  run: run$E
+  run: run$G
 };
-async function run$E(argv, importMeta, {
+async function run$G(argv, importMeta, {
   parentName
 }) {
   const cli = utils.meowOrExit({
@@ -4492,8 +4512,10 @@ async function run$E(argv, importMeta, {
   attemptLogout();
 }
 
+const require$6 = require$$5.createRequire((typeof document === 'undefined' ? require$$0.pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli.js', document.baseURI).href)));
 const {
   PACKAGE_LOCK_JSON,
+  PNPM_LOCK_YAML,
   YARN,
   YARN_LOCK
 } = constants.default;
@@ -4545,24 +4567,58 @@ async function runCdxgen(argvObj) {
     },
     stdio: 'inherit'
   };
+
+  // Detect package manager based on lockfiles
+  const pnpmLockPath = await utils.findUp(PNPM_LOCK_YAML, {
+    onlyFiles: true
+  });
+  const npmLockPath = pnpmLockPath ? undefined : await utils.findUp(PACKAGE_LOCK_JSON, {
+    onlyFiles: true
+  });
+  const yarnLockPath = pnpmLockPath || npmLockPath ? undefined : await utils.findUp(YARN_LOCK, {
+    onlyFiles: true
+  });
   let cleanupPackageLock = false;
-  if (argvMutable['type'] !== YARN && nodejsPlatformTypes.has(argvMutable['type']) && fs$1.existsSync(`./${YARN_LOCK}`)) {
-    if (fs$1.existsSync(`./${PACKAGE_LOCK_JSON}`)) {
+  if (argvMutable['type'] !== YARN && nodejsPlatformTypes.has(argvMutable['type']) && yarnLockPath) {
+    if (npmLockPath) {
       argvMutable['type'] = constants.NPM;
     } else {
       // Use synp to create a package-lock.json from the yarn.lock,
       // based on the node_modules folder, for a more accurate SBOM.
       try {
-        const {
-          spawnPromise: synpPromise
-        } = await shadowNpmBin('npx', ['--yes', `synp@${constants.default.ENV.INLINED_SOCKET_CLI_SYNP_VERSION}`, '--source-file', `./${YARN_LOCK}`], shadowOpts);
+        const useYarnBerry = utils.isYarnBerry();
+        let args;
+        let synpPromise;
+        if (pnpmLockPath) {
+          args = ['dlx', `synp@${constants.default.ENV.INLINED_SOCKET_CLI_SYNP_VERSION}`, '--source-file', `./${YARN_LOCK}`];
+          const shadowPnpmBin = /*@__PURE__*/require$6(constants.default.shadowPnpmBinPath);
+          synpPromise = (await shadowPnpmBin(args, shadowOpts)).spawnPromise;
+        } else if (useYarnBerry) {
+          args = ['dlx', `synp@${constants.default.ENV.INLINED_SOCKET_CLI_SYNP_VERSION}`, '--source-file', `./${YARN_LOCK}`];
+          const shadowYarnBin = /*@__PURE__*/require$6(constants.default.shadowYarnBinPath);
+          synpPromise = (await shadowYarnBin(args, shadowOpts)).spawnPromise;
+        } else {
+          args = ['exec', '--yes', `synp@${constants.default.ENV.INLINED_SOCKET_CLI_SYNP_VERSION}`, '--source-file', `./${YARN_LOCK}`];
+          synpPromise = (await shadowNpmBin('npm', args, shadowOpts)).spawnPromise;
+        }
         await synpPromise;
         argvMutable['type'] = constants.NPM;
         cleanupPackageLock = true;
       } catch {}
     }
   }
-  const shadowResult = await shadowNpmBin('npx', ['--yes', `@cyclonedx/cdxgen@${constants.default.ENV.INLINED_SOCKET_CLI_CYCLONEDX_CDXGEN_VERSION}`, ...argvToArray(argvMutable)], shadowOpts);
+
+  // Use appropriate package manager for cdxgen
+  let shadowResult;
+  if (pnpmLockPath) {
+    const shadowPnpmBin = /*@__PURE__*/require$6(constants.default.shadowPnpmBinPath);
+    shadowResult = await shadowPnpmBin(['dlx', '--silent', `@cyclonedx/cdxgen@${constants.default.ENV.INLINED_SOCKET_CLI_CYCLONEDX_CDXGEN_VERSION}`, ...argvToArray(argvMutable)], shadowOpts);
+  } else if (yarnLockPath && utils.isYarnBerry()) {
+    const shadowYarnBin = /*@__PURE__*/require$6(constants.default.shadowYarnBinPath);
+    shadowResult = await shadowYarnBin(['dlx', '--quiet', `@cyclonedx/cdxgen@${constants.default.ENV.INLINED_SOCKET_CLI_CYCLONEDX_CDXGEN_VERSION}`, ...argvToArray(argvMutable)], shadowOpts);
+  } else {
+    shadowResult = await shadowNpmBin('npm', ['exec', '--silent', '--yes', `@cyclonedx/cdxgen@${constants.default.ENV.INLINED_SOCKET_CLI_CYCLONEDX_CDXGEN_VERSION}`, '--', ...argvToArray(argvMutable)], shadowOpts);
+  }
   shadowResult.spawnPromise.process.on('exit', () => {
     if (cleanupPackageLock) {
       try {
@@ -4785,9 +4841,9 @@ const config$e = {
 const cmdManifestCdxgen = {
   description: config$e.description,
   hidden: config$e.hidden,
-  run: run$D
+  run: run$F
 };
-async function run$D(argv, importMeta, context) {
+async function run$F(argv, importMeta, context) {
   const {
     parentName
   } = {
@@ -4805,7 +4861,7 @@ async function run$D(argv, importMeta, context) {
     dryRun
   } = cli.flags;
 
-  // Filter Socket flags from argv but keep --no-banner and --help for cdxgen
+  // Filter Socket flags from argv but keep --no-banner and --help for cdxgen.
   const argsToProcess = utils.filterFlags(argv, {
     ...flags.commonFlags,
     ...flags.outputFlags
@@ -4905,9 +4961,9 @@ const config$d = {
 const cmdManifestAuto = {
   description: config$d.description,
   hidden: config$d.hidden,
-  run: run$C
+  run: run$E
 };
-async function run$C(argv, importMeta, {
+async function run$E(argv, importMeta, {
   parentName
 }) {
   const cli = utils.meowOrExit({
@@ -4966,14 +5022,15 @@ async function run$C(argv, importMeta, {
 
 const config$c = {
   commandName: 'conda',
-  description: '[beta] Convert a Conda environment.yml file to a python requirements.txt',
+  description: `[beta] Convert a Conda ${constants.ENVIRONMENT_YML} file to a python ${constants.REQUIREMENTS_TXT}`,
   hidden: false,
   flags: {
     ...flags.commonFlags,
     ...flags.outputFlags,
     file: {
       type: 'string',
-      description: 'Input file name (by default for Conda this is "environment.yml"), relative to cwd'
+      default: '',
+      description: `Input file name (by default for Conda this is "${constants.ENVIRONMENT_YML}"), relative to cwd`
     },
     stdin: {
       type: 'boolean',
@@ -4981,11 +5038,12 @@ const config$c = {
     },
     out: {
       type: 'string',
+      default: '',
       description: 'Output path (relative to cwd)'
     },
     stdout: {
       type: 'boolean',
-      description: 'Print resulting requirements.txt to stdout (supersedes --out)'
+      description: `Print resulting ${constants.REQUIREMENTS_TXT} to stdout (supersedes --out)`
     },
     verbose: {
       type: 'boolean',
@@ -4997,8 +5055,8 @@ const config$c = {
       $ ${command} [options] [CWD=.]
 
     Warning: While we don't support Conda necessarily, this tool extracts the pip
-             block from an environment.yml and outputs it as a requirements.txt
-             which you can scan as if it were a pypi package.
+             block from an ${constants.ENVIRONMENT_YML} and outputs it as a ${constants.REQUIREMENTS_TXT}
+             which you can scan as if it were a PyPI package.
 
     USE AT YOUR OWN RISK
 
@@ -5011,15 +5069,15 @@ const config$c = {
     Examples
 
       $ ${command}
-      $ ${command} ./project/foo --file environment.yaml
+      $ ${command} ./project/foo --file ${constants.ENVIRONMENT_YAML}
   `
 };
 const cmdManifestConda = {
   description: config$c.description,
   hidden: config$c.hidden,
-  run: run$B
+  run: run$D
 };
-async function run$B(argv, importMeta, {
+async function run$D(argv, importMeta, {
   parentName
 }) {
   const cli = utils.meowOrExit({
@@ -5029,10 +5087,10 @@ async function run$B(argv, importMeta, {
     parentName
   });
   const {
-    json = false,
-    markdown = false
+    dryRun,
+    json,
+    markdown
   } = cli.flags;
-  const dryRun = !!cli.flags['dryRun'];
   let [cwd = '.'] = cli.input;
   // Note: path.resolve vs .join:
   // If given path is absolute then cwd should not affect it.
@@ -5049,35 +5107,35 @@ async function run$B(argv, importMeta, {
   // Set defaults for any flag/arg that is not given. Check socket.json first.
   if (stdin === undefined && sockJson.defaults?.manifest?.conda?.stdin !== undefined) {
     stdin = sockJson.defaults?.manifest?.conda?.stdin;
-    logger.logger.info('Using default --stdin from socket.json:', stdin);
+    logger.logger.info(`Using default --stdin from ${constants.SOCKET_JSON}:`, stdin);
   }
   if (stdin) {
     filename = '-';
   } else if (!filename) {
     if (sockJson.defaults?.manifest?.conda?.infile) {
       filename = sockJson.defaults?.manifest?.conda?.infile;
-      logger.logger.info('Using default --file from socket.json:', filename);
+      logger.logger.info(`Using default --file from ${constants.SOCKET_JSON}:`, filename);
     } else {
-      filename = 'environment.yml';
+      filename = constants.ENVIRONMENT_YML;
     }
   }
   if (stdout === undefined && sockJson.defaults?.manifest?.conda?.stdout !== undefined) {
     stdout = sockJson.defaults?.manifest?.conda?.stdout;
-    logger.logger.info('Using default --stdout from socket.json:', stdout);
+    logger.logger.info(`Using default --stdout from ${constants.SOCKET_JSON}:`, stdout);
   }
   if (stdout) {
     out = '-';
   } else if (!out) {
     if (sockJson.defaults?.manifest?.conda?.outfile) {
       out = sockJson.defaults?.manifest?.conda?.outfile;
-      logger.logger.info('Using default --out from socket.json:', out);
+      logger.logger.info(`Using default --out from ${constants.SOCKET_JSON}:`, out);
     } else {
-      out = 'requirements.txt';
+      out = constants.REQUIREMENTS_TXT;
     }
   }
   if (verbose === undefined && sockJson.defaults?.manifest?.conda?.verbose !== undefined) {
     verbose = sockJson.defaults?.manifest?.conda?.verbose;
-    logger.logger.info('Using default --verbose from socket.json:', verbose);
+    logger.logger.info(`Using default --verbose from ${constants.SOCKET_JSON}:`, verbose);
   } else if (verbose === undefined) {
     verbose = false;
   }
@@ -5111,10 +5169,10 @@ async function run$B(argv, importMeta, {
   }
   await handleManifestConda({
     cwd,
-    filename: String(filename),
-    out: String(out || ''),
+    filename,
+    out,
     outputKind,
-    verbose: Boolean(verbose)
+    verbose
   });
 }
 
@@ -5149,7 +5207,7 @@ const config$b = {
     global \`gradle\` binary but that may not work (hard to predict).
 
     The \`pom.xml\` is a manifest file similar to \`package.json\` for npm or
-    or requirements.txt for PyPi), but specifically for Maven, which is Java's
+    or ${constants.REQUIREMENTS_TXT} for PyPi), but specifically for Maven, which is Java's
     dependency repository. Languages like Kotlin and Scala piggy back on it too.
 
     There are some caveats with the gradle to \`pom.xml\` conversion:
@@ -5173,9 +5231,9 @@ const config$b = {
 const cmdManifestGradle = {
   description: config$b.description,
   hidden: config$b.hidden,
-  run: run$A
+  run: run$C
 };
-async function run$A(argv, importMeta, {
+async function run$C(argv, importMeta, {
   parentName
 }) {
   const cli = utils.meowOrExit({
@@ -5197,7 +5255,7 @@ async function run$A(argv, importMeta, {
   // If given path is absolute then cwd should not affect it.
   cwd = path.resolve(process.cwd(), cwd);
   const sockJson = utils.readOrDefaultSocketJson(cwd);
-  require$$9.debugFn('inspect', 'override: socket.json gradle', sockJson?.defaults?.manifest?.gradle);
+  require$$9.debugFn('inspect', `override: ${constants.SOCKET_JSON} gradle`, sockJson?.defaults?.manifest?.gradle);
   let {
     bin,
     gradleOpts,
@@ -5208,7 +5266,7 @@ async function run$A(argv, importMeta, {
   if (!bin) {
     if (sockJson.defaults?.manifest?.gradle?.bin) {
       bin = sockJson.defaults?.manifest?.gradle?.bin;
-      logger.logger.info('Using default --bin from socket.json:', bin);
+      logger.logger.info(`Using default --bin from ${constants.SOCKET_JSON}:`, bin);
     } else {
       bin = path.join(cwd, 'gradlew');
     }
@@ -5216,7 +5274,7 @@ async function run$A(argv, importMeta, {
   if (!gradleOpts) {
     if (sockJson.defaults?.manifest?.gradle?.gradleOpts) {
       gradleOpts = sockJson.defaults?.manifest?.gradle?.gradleOpts;
-      logger.logger.info('Using default --gradle-opts from socket.json:', gradleOpts);
+      logger.logger.info(`Using default --gradle-opts from ${constants.SOCKET_JSON}:`, gradleOpts);
     } else {
       gradleOpts = '';
     }
@@ -5224,7 +5282,7 @@ async function run$A(argv, importMeta, {
   if (verbose === undefined) {
     if (sockJson.defaults?.manifest?.gradle?.verbose !== undefined) {
       verbose = sockJson.defaults?.manifest?.gradle?.verbose;
-      logger.logger.info('Using default --verbose from socket.json:', verbose);
+      logger.logger.info(`Using default --verbose from ${constants.SOCKET_JSON}:`, verbose);
     } else {
       verbose = false;
     }
@@ -5304,7 +5362,7 @@ const config$a = {
     global \`gradle\` binary but that may not work (hard to predict).
 
     The \`pom.xml\` is a manifest file similar to \`package.json\` for npm or
-    or requirements.txt for PyPi), but specifically for Maven, which is Java's
+    or ${constants.REQUIREMENTS_TXT} for PyPi), but specifically for Maven, which is Java's
     dependency repository. Languages like Kotlin and Scala piggy back on it too.
 
     There are some caveats with the gradle to \`pom.xml\` conversion:
@@ -5328,9 +5386,9 @@ const config$a = {
 const cmdManifestKotlin = {
   description: config$a.description,
   hidden: config$a.hidden,
-  run: run$z
+  run: run$B
 };
-async function run$z(argv, importMeta, {
+async function run$B(argv, importMeta, {
   parentName
 }) {
   const cli = utils.meowOrExit({
@@ -5352,7 +5410,7 @@ async function run$z(argv, importMeta, {
   // If given path is absolute then cwd should not affect it.
   cwd = path.resolve(process.cwd(), cwd);
   const sockJson = utils.readOrDefaultSocketJson(cwd);
-  require$$9.debugFn('inspect', 'override: socket.json gradle', sockJson?.defaults?.manifest?.gradle);
+  require$$9.debugFn('inspect', `override: ${constants.SOCKET_JSON} gradle`, sockJson?.defaults?.manifest?.gradle);
   let {
     bin,
     gradleOpts,
@@ -5363,7 +5421,7 @@ async function run$z(argv, importMeta, {
   if (!bin) {
     if (sockJson.defaults?.manifest?.gradle?.bin) {
       bin = sockJson.defaults?.manifest?.gradle?.bin;
-      logger.logger.info('Using default --bin from socket.json:', bin);
+      logger.logger.info(`Using default --bin from ${constants.SOCKET_JSON}:`, bin);
     } else {
       bin = path.join(cwd, 'gradlew');
     }
@@ -5371,7 +5429,7 @@ async function run$z(argv, importMeta, {
   if (!gradleOpts) {
     if (sockJson.defaults?.manifest?.gradle?.gradleOpts) {
       gradleOpts = sockJson.defaults?.manifest?.gradle?.gradleOpts;
-      logger.logger.info('Using default --gradle-opts from socket.json:', gradleOpts);
+      logger.logger.info(`Using default --gradle-opts from ${constants.SOCKET_JSON}:`, gradleOpts);
     } else {
       gradleOpts = '';
     }
@@ -5379,7 +5437,7 @@ async function run$z(argv, importMeta, {
   if (verbose === undefined) {
     if (sockJson.defaults?.manifest?.gradle?.verbose !== undefined) {
       verbose = sockJson.defaults?.manifest?.gradle?.verbose;
-      logger.logger.info('Using default --verbose from socket.json:', verbose);
+      logger.logger.info(`Using default --verbose from ${constants.SOCKET_JSON}:`, verbose);
     } else {
       verbose = false;
     }
@@ -5459,7 +5517,7 @@ const config$9 = {
 
     Uses \`sbt makePom\` to generate a \`pom.xml\` from your \`build.sbt\` file.
     This xml file is the dependency manifest (like a package.json
-    for Node.js or requirements.txt for PyPi), but specifically for Scala.
+    for Node.js or ${constants.REQUIREMENTS_TXT} for PyPi), but specifically for Scala.
 
     There are some caveats with \`build.sbt\` to \`pom.xml\` conversion:
 
@@ -5491,9 +5549,9 @@ const config$9 = {
 const cmdManifestScala = {
   description: config$9.description,
   hidden: config$9.hidden,
-  run: run$y
+  run: run$A
 };
-async function run$y(argv, importMeta, {
+async function run$A(argv, importMeta, {
   parentName
 }) {
   const cli = utils.meowOrExit({
@@ -5515,7 +5573,7 @@ async function run$y(argv, importMeta, {
   // TODO: Implement json/md further.
   const outputKind = utils.getOutputKind(json, markdown);
   const sockJson = utils.readOrDefaultSocketJson(cwd);
-  require$$9.debugFn('inspect', 'override: socket.json sbt', sockJson?.defaults?.manifest?.sbt);
+  require$$9.debugFn('inspect', `override: ${constants.SOCKET_JSON} sbt`, sockJson?.defaults?.manifest?.sbt);
   let {
     bin,
     out,
@@ -5528,21 +5586,21 @@ async function run$y(argv, importMeta, {
   if (!bin) {
     if (sockJson.defaults?.manifest?.sbt?.bin) {
       bin = sockJson.defaults?.manifest?.sbt?.bin;
-      logger.logger.info('Using default --bin from socket.json:', bin);
+      logger.logger.info(`Using default --bin from ${constants.SOCKET_JSON}:`, bin);
     } else {
       bin = 'sbt';
     }
   }
   if (stdout === undefined && sockJson.defaults?.manifest?.sbt?.stdout !== undefined) {
     stdout = sockJson.defaults?.manifest?.sbt?.stdout;
-    logger.logger.info('Using default --stdout from socket.json:', stdout);
+    logger.logger.info(`Using default --stdout from ${constants.SOCKET_JSON}:`, stdout);
   }
   if (stdout) {
     out = '-';
   } else if (!out) {
     if (sockJson.defaults?.manifest?.sbt?.outfile) {
       out = sockJson.defaults?.manifest?.sbt?.outfile;
-      logger.logger.info('Using default --out from socket.json:', out);
+      logger.logger.info(`Using default --out from ${constants.SOCKET_JSON}:`, out);
     } else {
       out = './socket.pom.xml';
     }
@@ -5550,14 +5608,14 @@ async function run$y(argv, importMeta, {
   if (!sbtOpts) {
     if (sockJson.defaults?.manifest?.sbt?.sbtOpts) {
       sbtOpts = sockJson.defaults?.manifest?.sbt?.sbtOpts;
-      logger.logger.info('Using default --sbt-opts from socket.json:', sbtOpts);
+      logger.logger.info(`Using default --sbt-opts from ${constants.SOCKET_JSON}:`, sbtOpts);
     } else {
       sbtOpts = '';
     }
   }
   if (verbose === undefined && sockJson.defaults?.manifest?.sbt?.verbose !== undefined) {
     verbose = sockJson.defaults?.manifest?.sbt?.verbose;
-    logger.logger.info('Using default --verbose from socket.json:', verbose);
+    logger.logger.info(`Using default --verbose from ${constants.SOCKET_JSON}:`, verbose);
   } else if (verbose === undefined) {
     verbose = false;
   }
@@ -5625,18 +5683,18 @@ async function setupManifestConfig(cwd, defaultOnReadError = false) {
   //   - each target will have its own specific options
   //   - record them to the socket.yml (or socket-cli.yml ? or just socket.json ?)
 
-  const jsonPath = path.join(cwd, `socket.json`);
+  const jsonPath = path.join(cwd, constants.SOCKET_JSON);
   if (fs$1.existsSync(jsonPath)) {
-    logger.logger.info(`Found socket.json at ${jsonPath}`);
+    logger.logger.info(`Found ${constants.SOCKET_JSON} at ${jsonPath}`);
   } else {
-    logger.logger.info(`No socket.json found at ${cwd}, will generate a new one`);
+    logger.logger.info(`No ${constants.SOCKET_JSON} found at ${cwd}, will generate a new one`);
   }
   logger.logger.log('');
   logger.logger.log('Note: This tool will set up flag and argument defaults for certain');
   logger.logger.log('      CLI commands. You can still override them by explicitly');
   logger.logger.log('      setting the flag. It is meant to be a convenience tool.');
   logger.logger.log('');
-  logger.logger.log('This command will generate a socket.json file in the target cwd.');
+  logger.logger.log(`This command will generate a ${constants.SOCKET_JSON} file in the target cwd.`);
   logger.logger.log('You can choose to add this file to your repo (handy for collaboration)');
   logger.logger.log('or to add it to the ignored files, or neither. This file is only');
   logger.logger.log('used in CLI workflows.');
@@ -5644,7 +5702,7 @@ async function setupManifestConfig(cwd, defaultOnReadError = false) {
   const choices = [{
     name: 'Conda'.padEnd(30, ' '),
     value: 'conda',
-    description: 'Generate requirements.txt from a Conda environment.yml'
+    description: `Generate ${constants.REQUIREMENTS_TXT} from a Conda environment.yml`
   }, {
     name: 'Gradle'.padEnd(30, ' '),
     value: 'gradle',
@@ -5737,7 +5795,7 @@ async function setupManifestConfig(cwd, defaultOnReadError = false) {
     return result;
   }
   logger.logger.log('');
-  logger.logger.log('Setup complete. Writing socket.json');
+  logger.logger.log(`Setup complete. Writing ${constants.SOCKET_JSON}`);
   logger.logger.log('');
   if (await prompts.select({
     message: `Do you want to write the new config to ${jsonPath} ?`,
@@ -5788,7 +5846,7 @@ async function setupConda(config) {
     delete config.stdout;
   }
   if (!config.stdout) {
-    const out = await askForOutputFile(config.outfile || 'requirements.txt');
+    const out = await askForOutputFile(config.outfile || constants.REQUIREMENTS_TXT);
     if (out === undefined) {
       return canceledByUser$1();
     } else if (out === '-') {
@@ -6015,7 +6073,7 @@ const config$8 = {
     ...flags.commonFlags,
     defaultOnReadError: {
       type: 'boolean',
-      description: 'If reading the socket.json fails, just use a default config? Warning: This might override the existing json file!'
+      description: `If reading the ${constants.SOCKET_JSON} fails, just use a default config? Warning: This might override the existing json file!`
     }
   },
   help: (command, config) => `
@@ -6028,7 +6086,7 @@ const config$8 = {
     This command will try to detect all supported ecosystems in given CWD. Then
     it starts a configurator where you can setup default values for certain flags
     when creating manifest files in that dir. These configuration details are
-    then stored in a local \`socket.json\` file (which you may or may not commit
+    then stored in a local \`${constants.SOCKET_JSON}\` file (which you may or may not commit
     to the repo). Next time you run \`socket manifest ...\` it will load this
     json file and any flags which are not explicitly set in the command but which
     have been registered in the json file will get the default value set to that
@@ -6052,9 +6110,9 @@ const config$8 = {
 const cmdManifestSetup = {
   description: config$8.description,
   hidden: config$8.hidden,
-  run: run$x
+  run: run$z
 };
-async function run$x(argv, importMeta, {
+async function run$z(argv, importMeta, {
   parentName
 }) {
   const cli = utils.meowOrExit({
@@ -6088,9 +6146,9 @@ const config$7 = {
 const cmdManifest = {
   description: config$7.description,
   hidden: config$7.hidden,
-  run: run$w
+  run: run$y
 };
-async function run$w(argv, importMeta, {
+async function run$y(argv, importMeta, {
   parentName
 }) {
   await utils.meowWithSubcommands({
@@ -6117,16 +6175,16 @@ async function run$w(argv, importMeta, {
   });
 }
 
-const require$3 = require$$5.createRequire((typeof document === 'undefined' ? require$$0.pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli.js', document.baseURI).href)));
-const CMD_NAME$p = constants.NPM;
-const description$u = 'Run npm with the Socket wrapper';
-const hidden$o = false;
+const require$5 = require$$5.createRequire((typeof document === 'undefined' ? require$$0.pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli.js', document.baseURI).href)));
+const CMD_NAME$r = constants.NPM;
+const description$w = 'Run npm with the Socket wrapper';
+const hidden$q = false;
 const cmdNpm = {
-  description: description$u,
-  hidden: hidden$o,
-  run: run$v
+  description: description$w,
+  hidden: hidden$q,
+  run: run$x
 };
-async function run$v(argv, importMeta, context) {
+async function run$x(argv, importMeta, context) {
   const {
     parentName
   } = {
@@ -6134,9 +6192,9 @@ async function run$v(argv, importMeta, context) {
     ...context
   };
   const config = {
-    commandName: CMD_NAME$p,
-    description: description$u,
-    hidden: hidden$o,
+    commandName: CMD_NAME$r,
+    description: description$w,
+    hidden: hidden$q,
     flags: {
       ...flags.commonFlags
     },
@@ -6145,7 +6203,7 @@ async function run$v(argv, importMeta, context) {
       $ ${command} ...
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$p}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$r}`)}
 
     Note: Everything after "npm" is passed to the npm command.
           Only the \`--dry-run\` and \`--help\` flags are caught here.
@@ -6155,6 +6213,7 @@ async function run$v(argv, importMeta, context) {
     Examples
       $ ${command}
       $ ${command} install -g cowsay
+      $ ${command} exec cowsay
     `
   };
   const cli = utils.meowOrExit({
@@ -6168,10 +6227,10 @@ async function run$v(argv, importMeta, context) {
     logger.logger.log(constants.default.DRY_RUN_BAILING_NOW);
     return;
   }
-  const shadowBin = /*@__PURE__*/require$3(constants.default.shadowNpmBinPath);
+  const shadowBin = /*@__PURE__*/require$5(constants.default.shadowNpmBinPath);
   process.exitCode = 1;
 
-  // Filter Socket flags from argv but keep --json for npm
+  // Filter Socket flags from argv but keep --json for npm.
   const argsToForward = utils.filterFlags(argv, {
     ...flags.commonFlags,
     ...flags.outputFlags
@@ -6194,22 +6253,22 @@ async function run$v(argv, importMeta, context) {
   await spawnPromise;
 }
 
-const require$2 = require$$5.createRequire((typeof document === 'undefined' ? require$$0.pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli.js', document.baseURI).href)));
-const CMD_NAME$o = constants.NPX;
-const description$t = 'Run npx with the Socket wrapper';
-const hidden$n = false;
+const require$4 = require$$5.createRequire((typeof document === 'undefined' ? require$$0.pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli.js', document.baseURI).href)));
+const CMD_NAME$q = constants.NPX;
+const description$v = 'Run npx with the Socket wrapper';
+const hidden$p = false;
 const cmdNpx = {
-  description: description$t,
-  hidden: hidden$n,
-  run: run$u
+  description: description$v,
+  hidden: hidden$p,
+  run: run$w
 };
-async function run$u(argv, importMeta, {
+async function run$w(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$o,
-    description: description$t,
-    hidden: hidden$n,
+    commandName: CMD_NAME$q,
+    description: description$v,
+    hidden: hidden$p,
     flags: {
       ...flags.commonFlags
     },
@@ -6218,7 +6277,7 @@ async function run$u(argv, importMeta, {
       $ ${command} ...
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$o}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$q}`)}
 
     Note: Everything after "npx" is passed to the npx command.
           Only the \`--dry-run\` and \`--help\` flags are caught here.
@@ -6227,6 +6286,7 @@ async function run$u(argv, importMeta, {
 
     Examples
       $ ${command} cowsay
+      $ ${command} cowsay@1.6.0 hello
   `
   };
   const cli = utils.meowOrExit({
@@ -6240,7 +6300,7 @@ async function run$u(argv, importMeta, {
     logger.logger.log(constants.default.DRY_RUN_BAILING_NOW);
     return;
   }
-  const shadowBin = /*@__PURE__*/require$2(constants.default.shadowNpmBinPath);
+  const shadowBin = /*@__PURE__*/require$4(constants.default.shadowNpmBinPath);
   process.exitCode = 1;
   const {
     spawnPromise
@@ -6283,9 +6343,9 @@ const config$6 = {
 const cmdOops = {
   description: config$6.description,
   hidden: config$6.hidden,
-  run: run$t
+  run: run$v
 };
-async function run$t(argv, importMeta, {
+async function run$v(argv, importMeta, {
   parentName
 }) {
   const cli = utils.meowOrExit({
@@ -6317,7 +6377,7 @@ async function run$t(argv, importMeta, {
     logger.logger.fail(utils.failMsgWithBadge('Oops', 'This error was intentionally left blank'));
     return;
   }
-  throw new Error('This error was intentionally left blank');
+  throw new Error('This error was intentionally left blank.');
 }
 
 const {
@@ -6702,7 +6762,7 @@ async function listPackages(pkgEnvDetails, options) {
   }
 }
 
-const CMD_NAME$n = 'socket optimize';
+const CMD_NAME$p = 'socket optimize';
 
 const {
   BUN,
@@ -6874,7 +6934,7 @@ async function addOverrides(pkgEnvDetails, pkgPath, options) {
   npmExecPath === constants.NPM && !state.warnedPnpmWorkspaceRequiresNpm) {
     state.warnedPnpmWorkspaceRequiresNpm = true;
     spinner?.stop();
-    logger?.warn(utils.cmdPrefixMessage(CMD_NAME$n, `${agent} workspace support requires \`npm ls\`, falling back to \`${agent} list\``));
+    logger?.warn(utils.cmdPrefixMessage(CMD_NAME$p, `${agent} workspace support requires \`npm ls\`, falling back to \`${agent} list\``));
     spinner?.start();
   }
   const overridesDataObjects = [];
@@ -7104,7 +7164,7 @@ async function applyOptimization(pkgEnvDetails, {
   const pkgJsonChanged = addedCount > 0 || updatedCount > 0;
   if (pkgJsonChanged || pkgEnvDetails.features.npmBuggyOverrides) {
     const result = await updateLockfile(pkgEnvDetails, {
-      cmdName: CMD_NAME$n,
+      cmdName: CMD_NAME$p,
       logger: logger.logger,
       spinner
     });
@@ -7166,7 +7226,7 @@ async function handleOptimize({
   prod
 }) {
   const pkgEnvCResult = await utils.detectAndValidatePackageEnvironment(cwd, {
-    cmdName: CMD_NAME$n,
+    cmdName: CMD_NAME$p,
     logger: logger.logger,
     prod
   });
@@ -7191,7 +7251,7 @@ async function handleOptimize({
     await outputOptimizeResult({
       ok: false,
       message: 'Unsupported',
-      cause: utils.cmdPrefixMessage(CMD_NAME$n, `${agent} v${agentVersion} does not support overrides.`)
+      cause: utils.cmdPrefixMessage(CMD_NAME$p, `${agent} v${agentVersion} does not support overrides.`)
     }, outputKind);
     return;
   }
@@ -7202,21 +7262,21 @@ async function handleOptimize({
   }), outputKind);
 }
 
-const CMD_NAME$m = 'optimize';
-const description$s = 'Optimize dependencies with @socketregistry overrides';
-const hidden$m = false;
+const CMD_NAME$o = 'optimize';
+const description$u = 'Optimize dependencies with @socketregistry overrides';
+const hidden$o = false;
 const cmdOptimize = {
-  description: description$s,
-  hidden: hidden$m,
-  run: run$s
+  description: description$u,
+  hidden: hidden$o,
+  run: run$u
 };
-async function run$s(argv, importMeta, {
+async function run$u(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$m,
-    description: description$s,
-    hidden: hidden$m,
+    commandName: CMD_NAME$o,
+    description: description$u,
+    hidden: hidden$o,
     flags: {
       ...flags.commonFlags,
       pin: {
@@ -7235,14 +7295,14 @@ async function run$s(argv, importMeta, {
       $ ${command} [options] [CWD=.]
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$m}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$o}`)}
 
     Options
       ${utils.getFlagListOutput(config.flags)}
 
     Examples
       $ ${command}
-      $ ${command} ./proj/tree --pin
+      $ ${command} ./path/to/project --pin
   `
   };
   const cli = utils.meowOrExit({
@@ -7378,21 +7438,21 @@ async function handleDependencies({
   });
 }
 
-const CMD_NAME$l = 'dependencies';
-const description$r = 'Search for any dependency that is being used in your organization';
-const hidden$l = false;
+const CMD_NAME$n = 'dependencies';
+const description$t = 'Search for any dependency that is being used in your organization';
+const hidden$n = false;
 const cmdOrganizationDependencies = {
-  description: description$r,
-  hidden: hidden$l,
-  run: run$r
+  description: description$t,
+  hidden: hidden$n,
+  run: run$t
 };
-async function run$r(argv, importMeta, {
+async function run$t(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$l,
-    description: description$r,
-    hidden: hidden$l,
+    commandName: CMD_NAME$n,
+    description: description$t,
+    hidden: hidden$n,
     flags: {
       ...flags.commonFlags,
       limit: {
@@ -7412,7 +7472,7 @@ async function run$r(argv, importMeta, {
       ${command} [options]
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$l}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$n}`)}
 
     Options
       ${utils.getFlagListOutput(config.flags)}
@@ -7512,21 +7572,21 @@ async function handleLicensePolicy(orgSlug, outputKind) {
   await outputLicensePolicy(data, outputKind);
 }
 
-const CMD_NAME$k = 'license';
-const description$q = 'Retrieve the license policy of an organization';
-const hidden$k = false;
+const CMD_NAME$m = 'license';
+const description$s = 'Retrieve the license policy of an organization';
+const hidden$m = false;
 const cmdOrganizationPolicyLicense = {
-  description: description$q,
-  hidden: hidden$k,
-  run: run$q
+  description: description$s,
+  hidden: hidden$m,
+  run: run$s
 };
-async function run$q(argv, importMeta, {
+async function run$s(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$k,
-    description: description$q,
-    hidden: hidden$k,
+    commandName: CMD_NAME$m,
+    description: description$s,
+    hidden: hidden$m,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags,
@@ -7545,7 +7605,7 @@ async function run$q(argv, importMeta, {
       $ ${command} [options]
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$k}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$m}`)}
 
     Options
       ${utils.getFlagListOutput(config.flags)}
@@ -7648,21 +7708,21 @@ async function handleSecurityPolicy(orgSlug, outputKind) {
   await outputSecurityPolicy(data, outputKind);
 }
 
-const CMD_NAME$j = 'security';
-const description$p = 'Retrieve the security policy of an organization';
-const hidden$j = true;
+const CMD_NAME$l = 'security';
+const description$r = 'Retrieve the security policy of an organization';
+const hidden$l = true;
 const cmdOrganizationPolicySecurity = {
-  description: description$p,
-  hidden: hidden$j,
-  run: run$p
+  description: description$r,
+  hidden: hidden$l,
+  run: run$r
 };
-async function run$p(argv, importMeta, {
+async function run$r(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$j,
-    description: description$p,
-    hidden: hidden$j,
+    commandName: CMD_NAME$l,
+    description: description$r,
+    hidden: hidden$l,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags,
@@ -7681,7 +7741,7 @@ async function run$p(argv, importMeta, {
       $ ${command} [options]
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$j}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$l}`)}
 
     Options
       ${utils.getFlagListOutput(config.flags)}
@@ -7785,21 +7845,21 @@ async function handleOrganizationList(outputKind = 'text') {
   await outputOrganizationList(data, outputKind);
 }
 
-const CMD_NAME$i = 'list';
-const description$o = 'List organizations associated with the Socket API token';
-const hidden$i = false;
+const CMD_NAME$k = 'list';
+const description$q = 'List organizations associated with the Socket API token';
+const hidden$k = false;
 const cmdOrganizationList = {
-  description: description$o,
-  hidden: hidden$i,
-  run: run$o
+  description: description$q,
+  hidden: hidden$k,
+  run: run$q
 };
-async function run$o(argv, importMeta, {
+async function run$q(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$i,
-    description: description$o,
-    hidden: hidden$i,
+    commandName: CMD_NAME$k,
+    description: description$q,
+    hidden: hidden$k,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags
@@ -7809,7 +7869,7 @@ async function run$o(argv, importMeta, {
       $ ${command} [options]
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$i}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$k}`)}
 
     Options
       ${utils.getFlagListOutput(config.flags)}
@@ -7853,9 +7913,9 @@ async function run$o(argv, importMeta, {
   await handleOrganizationList(outputKind);
 }
 
-const description$n = 'Organization policy details';
+const description$p = 'Organization policy details';
 const cmdOrganizationPolicy = {
-  description: description$n,
+  description: description$p,
   // Hidden because it was broken all this time (nobody could be using it)
   // and we're not sure if it's useful to anyone in its current state.
   // Until we do, we'll hide this to keep the help tidier.
@@ -7869,7 +7929,7 @@ const cmdOrganizationPolicy = {
       license: cmdOrganizationPolicyLicense
     }, {
       argv,
-      description: description$n,
+      description: description$p,
       defaultSub: 'list',
       // Backwards compat
       importMeta,
@@ -7946,9 +8006,9 @@ const config$5 = {
 const cmdOrganizationQuota = {
   description: config$5.description,
   hidden: config$5.hidden,
-  run: run$n
+  run: run$p
 };
-async function run$n(argv, importMeta, {
+async function run$p(argv, importMeta, {
   parentName
 }) {
   const cli = utils.meowOrExit({
@@ -7983,9 +8043,9 @@ async function run$n(argv, importMeta, {
   await handleQuota(outputKind);
 }
 
-const description$m = 'Manage Socket organization account details';
+const description$o = 'Manage Socket organization account details';
 const cmdOrganization = {
-  description: description$m,
+  description: description$o,
   hidden: false,
   async run(argv, importMeta, {
     parentName
@@ -8014,7 +8074,7 @@ const cmdOrganization = {
         }
       },
       argv,
-      description: description$m,
+      description: description$o,
       importMeta,
       name: `${parentName} organization`
     });
@@ -8239,21 +8299,21 @@ function parsePackageSpecifiers(ecosystem, pkgs) {
   };
 }
 
-const CMD_NAME$h = 'score';
-const description$l = 'Look up score for one package which reflects all of its transitive dependencies as well';
-const hidden$h = false;
+const CMD_NAME$j = 'score';
+const description$n = 'Look up score for one package which reflects all of its transitive dependencies as well';
+const hidden$j = false;
 const cmdPackageScore = {
-  description: description$l,
-  hidden: hidden$h,
-  run: run$m
+  description: description$n,
+  hidden: hidden$j,
+  run: run$o
 };
-async function run$m(argv, importMeta, {
+async function run$o(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$h,
-    description: description$l,
-    hidden: hidden$h,
+    commandName: CMD_NAME$j,
+    description: description$n,
+    hidden: hidden$j,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags
@@ -8263,7 +8323,7 @@ async function run$m(argv, importMeta, {
       $ ${command} [options] <<ECOSYSTEM> <NAME> | <PURL>>
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$h}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$j}`)}
 
     Options
       ${utils.getFlagListOutput(config.flags)}
@@ -8470,7 +8530,7 @@ function getAlertString(alerts, options) {
   return `${colorless}${padding}${arrays.joinAnd([...bad.map(a => `[${a.severity}] ${a.type}`), ...mid.map(a => `[${a.severity}] ${a.type}`), ...low.map(a => `[${a.severity}] ${a.type}`)])}`;
 }
 function preProcess(artifacts, requestedPurls) {
-  // Dedupe results (for example, pypi will emit one package for each system release (win/mac/cpu) even if it's
+  // Dedupe results (for example, PyPI will emit one package for each system release (win/mac/cpu) even if it's
   // the same package version with same results. The duplication is irrelevant and annoying to the user.
 
   // Make some effort to match the requested data with the response
@@ -8621,28 +8681,28 @@ async function handlePurlsShallowScore({
   outputPurlsShallowScore(purls, packageData, outputKind);
 }
 
-const CMD_NAME$g = 'shallow';
-const description$k = 'Look up info regarding one or more packages but not their transitives';
-const hidden$g = false;
+const CMD_NAME$i = 'shallow';
+const description$m = 'Look up info regarding one or more packages but not their transitives';
+const hidden$i = false;
 const cmdPackageShallow = {
-  description: description$k,
-  hidden: hidden$g,
+  description: description$m,
+  hidden: hidden$i,
   alias: {
     shallowScore: {
-      description: description$k,
+      description: description$m,
       hidden: true,
       argv: []
     }
   },
-  run: run$l
+  run: run$n
 };
-async function run$l(argv, importMeta, {
+async function run$n(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$g,
-    description: description$k,
-    hidden: hidden$g,
+    commandName: CMD_NAME$i,
+    description: description$m,
+    hidden: hidden$i,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags
@@ -8652,7 +8712,7 @@ async function run$l(argv, importMeta, {
       $ ${command} [options] <<ECOSYSTEM> <PKGNAME> [<PKGNAME> ...] | <PURL> [<PURL> ...]>
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$g}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$i}`)}
 
     Options
       ${utils.getFlagListOutput(config.flags)}
@@ -8726,9 +8786,9 @@ async function run$l(argv, importMeta, {
   });
 }
 
-const description$j = 'Look up published package details';
+const description$l = 'Look up published package details';
 const cmdPackage = {
-  description: description$j,
+  description: description$l,
   hidden: false,
   async run(argv, importMeta, {
     parentName
@@ -8739,13 +8799,13 @@ const cmdPackage = {
     }, {
       aliases: {
         deep: {
-          description: description$j,
+          description: description$l,
           hidden: true,
           argv: ['score']
         }
       },
       argv,
-      description: description$j,
+      description: description$l,
       importMeta,
       name: `${parentName} package`
     });
@@ -8799,7 +8859,7 @@ async function outputPatchResult(result, outputKind) {
     }
     logger.logger.groupEnd();
   } else {
-    logger.logger.warn('No packages found requiring patches');
+    logger.logger.warn('No packages found requiring patches.');
   }
   logger.logger.log('');
   logger.logger.success('Patch command completed!');
@@ -9115,21 +9175,21 @@ async function handlePatch({
   }
 }
 
-const CMD_NAME$f = 'patch';
-const description$i = 'Apply CVE patches to dependencies';
-const hidden$f = true;
+const CMD_NAME$h = 'patch';
+const description$k = 'Apply CVE patches to dependencies';
+const hidden$h = true;
 const cmdPatch = {
-  description: description$i,
-  hidden: hidden$f,
-  run: run$k
+  description: description$k,
+  hidden: hidden$h,
+  run: run$m
 };
-async function run$k(argv, importMeta, {
+async function run$m(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$f,
-    description: description$i,
-    hidden: hidden$f,
+    commandName: CMD_NAME$h,
+    description: description$k,
+    hidden: hidden$h,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags,
@@ -9146,7 +9206,7 @@ async function run$k(argv, importMeta, {
       $ ${command} [options] [CWD=.]
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$f}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$h}`)}
 
     Options
       ${utils.getFlagListOutput(config.flags)}
@@ -9154,7 +9214,7 @@ async function run$k(argv, importMeta, {
     Examples
       $ ${command}
       $ ${command} --package lodash
-      $ ${command} ./proj/tree --package lodash,react
+      $ ${command} ./path/to/project --package lodash,react
     `
   };
   const cli = utils.meowOrExit({
@@ -9206,6 +9266,71 @@ async function run$k(argv, importMeta, {
   });
 }
 
+const require$3 = require$$5.createRequire((typeof document === 'undefined' ? require$$0.pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli.js', document.baseURI).href)));
+const CMD_NAME$g = constants.PNPM;
+const description$j = 'Run pnpm with the Socket wrapper';
+const hidden$g = true;
+const cmdPnpm = {
+  description: description$j,
+  hidden: hidden$g,
+  run: run$l
+};
+async function run$l(argv, importMeta, context) {
+  const {
+    parentName
+  } = {
+    __proto__: null,
+    ...context
+  };
+  const config = {
+    commandName: CMD_NAME$g,
+    description: description$j,
+    hidden: hidden$g,
+    flags: {
+      ...flags.commonFlags
+    },
+    help: command => `
+    Usage
+      $ ${command} ...
+
+    API Token Requirements
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$g}`)}
+
+    Note: Everything after "pnpm" is passed to the pnpm command.
+          Only the \`--dry-run\` and \`--help\` flags are caught here.
+
+    Use \`socket wrapper on\` to alias this command as \`pnpm\`.
+
+    Examples
+      $ ${command}
+      $ ${command} install
+      $ ${command} add package-name
+      $ ${command} dlx package-name
+    `
+  };
+  const cli = utils.meowOrExit({
+    argv,
+    config,
+    importMeta,
+    parentName
+  });
+  const dryRun = !!cli.flags['dryRun'];
+  if (dryRun) {
+    logger.logger.log(constants.default.DRY_RUN_BAILING_NOW);
+    return;
+  }
+  const shadowBin = /*@__PURE__*/require$3(constants.default.shadowPnpmBinPath);
+  process.exitCode = 1;
+
+  // Filter Socket flags from argv.
+  const filteredArgv = utils.filterFlags(argv, config.flags);
+  const {
+    spawnPromise
+  } = await shadowBin(filteredArgv);
+  await spawnPromise;
+  process.exitCode = 0;
+}
+
 async function runRawNpm(argv) {
   process.exitCode = 1;
   const spawnPromise = spawn.spawn(utils.getNpmBinPath(), argv, {
@@ -9250,9 +9375,9 @@ const config$4 = {
 const cmdRawNpm = {
   description: config$4.description,
   hidden: config$4.hidden,
-  run: run$j
+  run: run$k
 };
-async function run$j(argv, importMeta, {
+async function run$k(argv, importMeta, {
   parentName
 }) {
   const cli = utils.meowOrExit({
@@ -9313,9 +9438,9 @@ const config$3 = {
 const cmdRawNpx = {
   description: config$3.description,
   hidden: config$3.hidden,
-  run: run$i
+  run: run$j
 };
-async function run$i(argv, importMeta, {
+async function run$j(argv, importMeta, {
   parentName
 }) {
   const cli = utils.meowOrExit({
@@ -9400,21 +9525,21 @@ async function handleCreateRepo({
   outputCreateRepo(data, repoName, outputKind);
 }
 
-const CMD_NAME$e = 'create';
-const description$h = 'Create a repository in an organization';
-const hidden$e = false;
+const CMD_NAME$f = 'create';
+const description$i = 'Create a repository in an organization';
+const hidden$f = false;
 const cmdRepositoryCreate = {
-  description: description$h,
-  hidden: hidden$e,
-  run: run$h
+  description: description$i,
+  hidden: hidden$f,
+  run: run$i
 };
-async function run$h(argv, importMeta, {
+async function run$i(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$e,
-    description: description$h,
-    hidden: hidden$e,
+    commandName: CMD_NAME$f,
+    description: description$i,
+    hidden: hidden$f,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags,
@@ -9453,7 +9578,7 @@ async function run$h(argv, importMeta, {
       $ ${command} [options] <REPO>
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$e}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$f}`)}
 
     The REPO name should be a "slug". Follows the same naming convention as GitHub.
 
@@ -9559,21 +9684,21 @@ async function handleDeleteRepo(orgSlug, repoName, outputKind) {
   await outputDeleteRepo(data, repoName, outputKind);
 }
 
-const CMD_NAME$d = 'del';
-const description$g = 'Delete a repository in an organization';
-const hidden$d = false;
+const CMD_NAME$e = 'del';
+const description$h = 'Delete a repository in an organization';
+const hidden$e = false;
 const cmdRepositoryDel = {
-  description: description$g,
-  hidden: hidden$d,
-  run: run$g
+  description: description$h,
+  hidden: hidden$e,
+  run: run$h
 };
-async function run$g(argv, importMeta, {
+async function run$h(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$d,
-    description: description$g,
-    hidden: hidden$d,
+    commandName: CMD_NAME$e,
+    description: description$h,
+    hidden: hidden$e,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags,
@@ -9592,7 +9717,7 @@ async function run$g(argv, importMeta, {
       $ ${command} [options] <REPO>
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$d}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$e}`)}
 
     Options
       ${utils.getFlagListOutput(config.flags)}
@@ -9822,21 +9947,21 @@ async function handleListRepos({
   }
 }
 
-const CMD_NAME$c = 'list';
-const description$f = 'List repositories in an organization';
-const hidden$c = false;
+const CMD_NAME$d = 'list';
+const description$g = 'List repositories in an organization';
+const hidden$d = false;
 const cmdRepositoryList = {
-  description: description$f,
-  hidden: hidden$c,
-  run: run$f
+  description: description$g,
+  hidden: hidden$d,
+  run: run$g
 };
-async function run$f(argv, importMeta, {
+async function run$g(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$c,
-    description: description$f,
-    hidden: hidden$c,
+    commandName: CMD_NAME$d,
+    description: description$g,
+    hidden: hidden$d,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags,
@@ -9884,7 +10009,7 @@ async function run$f(argv, importMeta, {
       $ ${command} [options]
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$c}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$d}`)}
 
     Options
       ${utils.getFlagListOutput(config.flags)}
@@ -10025,21 +10150,21 @@ async function handleUpdateRepo({
   await outputUpdateRepo(data, repoName, outputKind);
 }
 
-const CMD_NAME$b = 'update';
-const description$e = 'Update a repository in an organization';
-const hidden$b = false;
+const CMD_NAME$c = 'update';
+const description$f = 'Update a repository in an organization';
+const hidden$c = false;
 const cmdRepositoryUpdate = {
-  description: description$e,
-  hidden: hidden$b,
-  run: run$e
+  description: description$f,
+  hidden: hidden$c,
+  run: run$f
 };
-async function run$e(argv, importMeta, {
+async function run$f(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$b,
-    description: description$e,
-    hidden: hidden$b,
+    commandName: CMD_NAME$c,
+    description: description$f,
+    hidden: hidden$c,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags,
@@ -10082,7 +10207,7 @@ async function run$e(argv, importMeta, {
       $ ${command} [options] <REPO>
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$b}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$c}`)}
 
     Options
       ${utils.getFlagListOutput(config.flags)}
@@ -10211,21 +10336,21 @@ async function handleViewRepo(orgSlug, repoName, outputKind) {
   await outputViewRepo(data, outputKind);
 }
 
-const CMD_NAME$a = 'view';
-const description$d = 'View repositories in an organization';
-const hidden$a = false;
+const CMD_NAME$b = 'view';
+const description$e = 'View repositories in an organization';
+const hidden$b = false;
 const cmdRepositoryView = {
-  description: description$d,
-  hidden: hidden$a,
-  run: run$d
+  description: description$e,
+  hidden: hidden$b,
+  run: run$e
 };
-async function run$d(argv, importMeta, {
+async function run$e(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$a,
-    description: description$d,
-    hidden: hidden$a,
+    commandName: CMD_NAME$b,
+    description: description$e,
+    hidden: hidden$b,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags,
@@ -10244,7 +10369,7 @@ async function run$d(argv, importMeta, {
       $ ${command} [options] <REPO>
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$a}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$b}`)}
 
     Options
       ${utils.getFlagListOutput(config.flags)}
@@ -10309,9 +10434,9 @@ async function run$d(argv, importMeta, {
   await handleViewRepo(orgSlug, String(repoName), outputKind);
 }
 
-const description$c = 'Manage registered repositories';
+const description$d = 'Manage registered repositories';
 const cmdRepository = {
-  description: description$c,
+  description: description$d,
   async run(argv, importMeta, {
     parentName
   }) {
@@ -10323,7 +10448,7 @@ const cmdRepository = {
       update: cmdRepositoryUpdate
     }, {
       argv,
-      description: description$c,
+      description: description$d,
       importMeta,
       name: `${parentName} repository`
     });
@@ -10381,9 +10506,9 @@ async function suggestTarget() {
   return proceed ? ['.'] : [];
 }
 
-const CMD_NAME$9 = 'create';
-const description$b = 'Create a new Socket scan and report';
-const hidden$9 = false;
+const CMD_NAME$a = 'create';
+const description$c = 'Create a new Socket scan and report';
+const hidden$a = false;
 const generalFlags$1 = {
   ...flags.commonFlags,
   ...flags.outputFlags,
@@ -10479,17 +10604,17 @@ const generalFlags$1 = {
   }
 };
 const cmdScanCreate = {
-  description: description$b,
-  hidden: hidden$9,
-  run: run$c
+  description: description$c,
+  hidden: hidden$a,
+  run: run$d
 };
-async function run$c(argv, importMeta, {
+async function run$d(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$9,
-    description: description$b,
-    hidden: hidden$9,
+    commandName: CMD_NAME$a,
+    description: description$c,
+    hidden: hidden$a,
     flags: {
       ...generalFlags$1,
       ...reachabilityFlags
@@ -10500,7 +10625,7 @@ async function run$c(argv, importMeta, {
       $ ${command} [options] [TARGET...]
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$9}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$a}`)}
 
     Options
       ${utils.getFlagListOutput(generalFlags$1)}
@@ -10509,7 +10634,7 @@ async function run$c(argv, importMeta, {
       ${utils.getFlagListOutput(reachabilityFlags)}
 
     Uploads the specified dependency manifest files for Go, Gradle, JavaScript,
-    Kotlin, Python, and Scala. Files like "package.json" and "requirements.txt".
+    Kotlin, Python, and Scala. Files like "package.json" and "${constants.REQUIREMENTS_TXT}".
     If any folder is specified, the ones found in there recursively are uploaded.
 
     Details on TARGET:
@@ -10519,7 +10644,7 @@ async function run$c(argv, importMeta, {
     - If a target is a file, only that file is checked
     - If it is a dir, the dir is scanned for any supported manifest files
     - Dirs MUST be within the current dir (cwd), you can use --cwd to change it
-    - Supports globbing such as "**/package.json", "**/requirements.txt", etc.
+    - Supports globbing such as "**/package.json", "**/${constants.REQUIREMENTS_TXT}", etc.
     - Ignores any file specified in your project's ".gitignore"
     - Also a sensible set of default ignores from the "ignore-by-default" module
 
@@ -10594,13 +10719,13 @@ async function run$c(argv, importMeta, {
   } = await utils.determineOrgSlug(String(orgFlag || ''), interactive, dryRun);
   const processCwd = process.cwd();
   const cwd = cwdOverride && cwdOverride !== '.' && cwdOverride !== processCwd ? path.resolve(processCwd, cwdOverride) : processCwd;
-  const sockJson = utils.readOrDefaultSocketJson(cwd);
+  const sockJson = await utils.readOrDefaultSocketJsonUp(cwd);
 
   // Note: This needs meow booleanDefault=undefined.
   if (typeof autoManifest !== 'boolean') {
     if (sockJson.defaults?.scan?.create?.autoManifest !== undefined) {
       autoManifest = sockJson.defaults.scan.create.autoManifest;
-      logger.logger.info('Using default --auto-manifest from socket.json:', autoManifest);
+      logger.logger.info(`Using default --auto-manifest from ${constants.SOCKET_JSON}:`, autoManifest);
     } else {
       autoManifest = false;
     }
@@ -10608,7 +10733,7 @@ async function run$c(argv, importMeta, {
   if (!branchName) {
     if (sockJson.defaults?.scan?.create?.branch) {
       branchName = sockJson.defaults.scan.create.branch;
-      logger.logger.info('Using default --branch from socket.json:', branchName);
+      logger.logger.info(`Using default --branch from ${constants.SOCKET_JSON}:`, branchName);
     } else {
       branchName = (await utils.gitBranch(cwd)) || (await utils.detectDefaultBranch(cwd));
     }
@@ -10616,7 +10741,7 @@ async function run$c(argv, importMeta, {
   if (!repoName) {
     if (sockJson.defaults?.scan?.create?.repo) {
       repoName = sockJson.defaults.scan.create.repo;
-      logger.logger.info('Using default --repo from socket.json:', repoName);
+      logger.logger.info(`Using default --repo from ${constants.SOCKET_JSON}:`, repoName);
     } else {
       repoName = await utils.getRepoName(cwd);
     }
@@ -10624,7 +10749,7 @@ async function run$c(argv, importMeta, {
   if (typeof report !== 'boolean') {
     if (sockJson.defaults?.scan?.create?.report !== undefined) {
       report = sockJson.defaults.scan.create.report;
-      logger.logger.info('Using default --report from socket.json:', report);
+      logger.logger.info(`Using default --report from ${constants.SOCKET_JSON}:`, report);
     } else {
       report = false;
     }
@@ -10681,7 +10806,7 @@ async function run$c(argv, importMeta, {
     logger.logger.error(`    socket scan create [other flags...] ${orgSlug} ${targets.join(' ')}`);
     logger.logger.error('```');
     logger.logger.error('');
-    logger.logger.info('You can also run `socket scan setup` to persist these flag defaults to a socket.json file.');
+    logger.logger.info(`You can also run \`socket scan setup\` to persist these flag defaults to a ${constants.SOCKET_JSON} file.`);
     logger.logger.error('');
   }
   const reachExcludePaths = utils.cmdFlagValueToArray(cli.flags['reachExcludePaths']);
@@ -10803,21 +10928,21 @@ async function handleDeleteScan(orgSlug, scanId, outputKind) {
   await outputDeleteScan(data, outputKind);
 }
 
-const CMD_NAME$8 = 'del';
-const description$a = 'Delete a scan';
-const hidden$8 = false;
+const CMD_NAME$9 = 'del';
+const description$b = 'Delete a scan';
+const hidden$9 = false;
 const cmdScanDel = {
-  description: description$a,
-  hidden: hidden$8,
-  run: run$b
+  description: description$b,
+  hidden: hidden$9,
+  run: run$c
 };
-async function run$b(argv, importMeta, {
+async function run$c(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$8,
-    description: description$a,
-    hidden: hidden$8,
+    commandName: CMD_NAME$9,
+    description: description$b,
+    hidden: hidden$9,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags,
@@ -10836,7 +10961,7 @@ async function run$b(argv, importMeta, {
       $ ${command} [options] <SCAN_ID>
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$8}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$9}`)}
 
     Options
       ${utils.getFlagListOutput(config.flags)}
@@ -11080,21 +11205,21 @@ async function handleDiffScan({
   });
 }
 
-const CMD_NAME$7 = 'diff';
-const description$9 = 'See what changed between two Scans';
-const hidden$7 = false;
+const CMD_NAME$8 = 'diff';
+const description$a = 'See what changed between two Scans';
+const hidden$8 = false;
 const cmdScanDiff = {
-  description: description$9,
-  hidden: hidden$7,
-  run: run$a
+  description: description$a,
+  hidden: hidden$8,
+  run: run$b
 };
-async function run$a(argv, importMeta, {
+async function run$b(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$7,
-    description: description$9,
-    hidden: hidden$7,
+    commandName: CMD_NAME$8,
+    description: description$a,
+    hidden: hidden$8,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags,
@@ -11124,7 +11249,7 @@ async function run$a(argv, importMeta, {
       $ ${command} [options] <SCAN_ID1> <SCAN_ID2>
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$7}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$8}`)}
 
     This command displays the package changes between two scans. The full output
     can be pretty large depending on the size of your repo and time range. It is
@@ -11868,22 +11993,22 @@ async function handleCreateGithubScan({
   await outputScanGithub(ghScanCResult, outputKind);
 }
 
-const CMD_NAME$6 = 'github';
+const CMD_NAME$7 = 'github';
 const DEFAULT_GITHUB_URL = 'https://api.github.com';
-const description$8 = 'Create a scan for given GitHub repo';
-const hidden$6 = true;
+const description$9 = 'Create a scan for given GitHub repo';
+const hidden$7 = true;
 const cmdScanGithub = {
-  description: description$8,
-  hidden: hidden$6,
-  run: run$9
+  description: description$9,
+  hidden: hidden$7,
+  run: run$a
 };
-async function run$9(argv, importMeta, {
+async function run$a(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$6,
-    description: description$8,
-    hidden: hidden$6,
+    commandName: CMD_NAME$7,
+    description: description$9,
+    hidden: hidden$7,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags,
@@ -11927,7 +12052,7 @@ async function run$9(argv, importMeta, {
       $ ${command} [options] [CWD=.]
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$6}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$7}`)}
 
     This is similar to the \`socket scan create\` command except it pulls the files
     from GitHub. See the help for that command for more details.
@@ -12184,21 +12309,21 @@ async function handleListScans({
   await outputListScans(data, outputKind);
 }
 
-const CMD_NAME$5 = 'list';
-const description$7 = 'List the scans for an organization';
-const hidden$5 = false;
+const CMD_NAME$6 = 'list';
+const description$8 = 'List the scans for an organization';
+const hidden$6 = false;
 const cmdScanList = {
-  description: description$7,
-  hidden: hidden$5,
-  run: run$8
+  description: description$8,
+  hidden: hidden$6,
+  run: run$9
 };
-async function run$8(argv, importMeta, {
+async function run$9(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$5,
-    description: description$7,
-    hidden: hidden$5,
+    commandName: CMD_NAME$6,
+    description: description$8,
+    hidden: hidden$6,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags,
@@ -12257,7 +12382,7 @@ async function run$8(argv, importMeta, {
       $ ${command} [options] [REPO [BRANCH]]
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$5}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$6}`)}
 
     Optionally filter by REPO. If you specify a repo, you can also specify a
     branch to filter by. (Note: If you don't specify a repo then you must use
@@ -12393,21 +12518,21 @@ async function handleOrgScanMetadata(orgSlug, scanId, outputKind) {
   await outputScanMetadata(data, scanId, outputKind);
 }
 
-const CMD_NAME$4 = 'metadata';
-const description$6 = "Get a scan's metadata";
-const hidden$4 = false;
+const CMD_NAME$5 = 'metadata';
+const description$7 = "Get a scan's metadata";
+const hidden$5 = false;
 const cmdScanMetadata = {
-  description: description$6,
-  hidden: hidden$4,
-  run: run$7
+  description: description$7,
+  hidden: hidden$5,
+  run: run$8
 };
-async function run$7(argv, importMeta, {
+async function run$8(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$4,
-    description: description$6,
-    hidden: hidden$4,
+    commandName: CMD_NAME$5,
+    description: description$7,
+    hidden: hidden$5,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags,
@@ -12426,7 +12551,7 @@ async function run$7(argv, importMeta, {
       $ ${command} [options] <SCAN_ID>
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$4}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$5}`)}
 
     Options
       ${utils.getFlagListOutput(config.flags)}
@@ -12560,9 +12685,9 @@ async function handleScanReach({
   });
 }
 
-const CMD_NAME$3 = 'reach';
-const description$5 = 'Compute tier 1 reachability';
-const hidden$3 = true;
+const CMD_NAME$4 = 'reach';
+const description$6 = 'Compute tier 1 reachability';
+const hidden$4 = true;
 const generalFlags = {
   ...flags.commonFlags,
   ...flags.outputFlags,
@@ -12578,17 +12703,17 @@ const generalFlags = {
   }
 };
 const cmdScanReach = {
-  description: description$5,
-  hidden: hidden$3,
-  run: run$6
+  description: description$6,
+  hidden: hidden$4,
+  run: run$7
 };
-async function run$6(argv, importMeta, {
+async function run$7(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$3,
-    description: description$5,
-    hidden: hidden$3,
+    commandName: CMD_NAME$4,
+    description: description$6,
+    hidden: hidden$4,
     flags: {
       ...generalFlags,
       ...reachabilityFlags
@@ -12598,7 +12723,7 @@ async function run$6(argv, importMeta, {
       $ ${command} [options] [CWD=.]
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$3}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$4}`)}
 
     Options
       ${utils.getFlagListOutput(generalFlags)}
@@ -12706,21 +12831,21 @@ async function run$6(argv, importMeta, {
   });
 }
 
-const CMD_NAME$2 = 'report';
-const description$4 = 'Check whether a scan result passes the organizational policies (security, license)';
-const hidden$2 = false;
+const CMD_NAME$3 = 'report';
+const description$5 = 'Check whether a scan result passes the organizational policies (security, license)';
+const hidden$3 = false;
 const cmdScanReport = {
-  description: description$4,
-  hidden: hidden$2,
-  run: run$5
+  description: description$5,
+  hidden: hidden$3,
+  run: run$6
 };
-async function run$5(argv, importMeta, {
+async function run$6(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$2,
-    description: description$4,
-    hidden: hidden$2,
+    commandName: CMD_NAME$3,
+    description: description$5,
+    hidden: hidden$3,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags,
@@ -12759,7 +12884,7 @@ async function run$5(argv, importMeta, {
       $ ${command} [options] <SCAN_ID> [OUTPUT_PATH]
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$2}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$3}`)}
 
     Options
       ${utils.getFlagListOutput(config.flags)}
@@ -12870,18 +12995,18 @@ async function outputScanConfigResult(result) {
 }
 
 async function setupScanConfig(cwd, defaultOnReadError = false) {
-  const jsonPath = path.join(cwd, `socket.json`);
+  const jsonPath = path.join(cwd, constants.SOCKET_JSON);
   if (fs$1.existsSync(jsonPath)) {
-    logger.logger.info(`Found socket.json at ${jsonPath}`);
+    logger.logger.info(`Found ${constants.SOCKET_JSON} at ${jsonPath}`);
   } else {
-    logger.logger.info(`No socket.json found at ${cwd}, will generate a new one`);
+    logger.logger.info(`No ${constants.SOCKET_JSON} found at ${cwd}, will generate a new one`);
   }
   logger.logger.log('');
   logger.logger.log('Note: This tool will set up flag and argument defaults for certain');
   logger.logger.log('      CLI commands. You can still override them by explicitly');
   logger.logger.log('      setting the flag. It is meant to be a convenience tool.');
   logger.logger.log('');
-  logger.logger.log('This command will generate a `socket.json` file in the target cwd.');
+  logger.logger.log(`This command will generate a \`${constants.SOCKET_JSON}\` file in the target cwd.`);
   logger.logger.log('You can choose to add this file to your repo (handy for collab)');
   logger.logger.log('or to add it to the ignored files, or neither. This file is only');
   logger.logger.log('used in CLI workflows.');
@@ -12942,7 +13067,7 @@ async function setupScanConfig(cwd, defaultOnReadError = false) {
       }
   }
   logger.logger.log('');
-  logger.logger.log('Setup complete. Writing socket.json');
+  logger.logger.log(`Setup complete. Writing ${constants.SOCKET_JSON}`);
   logger.logger.log('');
   if (await prompts.select({
     message: `Do you want to write the new config to ${jsonPath} ?`,
@@ -13158,7 +13283,7 @@ const config$2 = {
     ...flags.commonFlags,
     defaultOnReadError: {
       type: 'boolean',
-      description: 'If reading the socket.json fails, just use a default config? Warning: This might override the existing json file!'
+      description: `If reading the ${constants.SOCKET_JSON} fails, just use a default config? Warning: This might override the existing json file!`
     }
   },
   help: (command, config) => `
@@ -13188,9 +13313,9 @@ const config$2 = {
 const cmdScanSetup = {
   description: config$2.description,
   hidden: config$2.hidden,
-  run: run$4
+  run: run$5
 };
-async function run$4(argv, importMeta, {
+async function run$5(argv, importMeta, {
   parentName
 }) {
   const cli = utils.meowOrExit({
@@ -13346,21 +13471,21 @@ async function streamScan(orgSlug, scanId, options) {
   });
 }
 
-const CMD_NAME$1 = 'view';
-const description$3 = 'View the raw results of a scan';
-const hidden$1 = false;
+const CMD_NAME$2 = 'view';
+const description$4 = 'View the raw results of a scan';
+const hidden$2 = false;
 const cmdScanView = {
-  description: description$3,
-  hidden: hidden$1,
-  run: run$3
+  description: description$4,
+  hidden: hidden$2,
+  run: run$4
 };
-async function run$3(argv, importMeta, {
+async function run$4(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME$1,
-    description: description$3,
-    hidden: hidden$1,
+    commandName: CMD_NAME$2,
+    description: description$4,
+    hidden: hidden$2,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags,
@@ -13384,7 +13509,7 @@ async function run$3(argv, importMeta, {
       $ ${command} [options] <SCAN_ID> [OUTPUT_FILE]
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$1}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$2}`)}
 
     When no output path is given the contents is sent to stdout.
 
@@ -13457,9 +13582,9 @@ async function run$3(argv, importMeta, {
   }
 }
 
-const description$2 = 'Manage Socket scans';
+const description$3 = 'Manage Socket scans';
 const cmdScan = {
-  description: description$2,
+  description: description$3,
   async run(argv, importMeta, {
     parentName
   }) {
@@ -13488,7 +13613,7 @@ const cmdScan = {
         }
       },
       argv,
-      description: description$2,
+      description: description$3,
       importMeta,
       name: `${parentName} scan`
     });
@@ -13509,7 +13634,7 @@ async function fetchThreatFeed({
   return await utils.queryApiSafeJson(`orgs/${orgSlug}/threat-feed?${queryParams}`, 'the Threat Feed data');
 }
 
-const require$1 = require$$5.createRequire((typeof document === 'undefined' ? require$$0.pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli.js', document.baseURI).href)));
+const require$2 = require$$5.createRequire((typeof document === 'undefined' ? require$$0.pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli.js', document.baseURI).href)));
 async function outputThreatFeed(result, outputKind) {
   if (!result.ok) {
     process.exitCode = result.code ?? 1;
@@ -13523,14 +13648,14 @@ async function outputThreatFeed(result, outputKind) {
     return;
   }
   if (!result.data?.results?.length) {
-    logger.logger.warn('Did not receive any data to display...');
+    logger.logger.warn('Did not receive any data to display.');
     return;
   }
   const formattedOutput = formatResults(result.data.results);
   const descriptions = result.data.results.map(d => d.description);
 
   // Note: this temporarily takes over the terminal (just like `man` does).
-  const ScreenWidget = /*@__PURE__*/require$1('../external/blessed/lib/widgets/screen.js');
+  const ScreenWidget = /*@__PURE__*/require$2('../external/blessed/lib/widgets/screen.js');
   const screen = new ScreenWidget({
     ...constants.default.blessedOptions
   });
@@ -13539,7 +13664,7 @@ async function outputThreatFeed(result, outputKind) {
   // node process just to exit it. That's very bad UX.
   // eslint-disable-next-line n/no-process-exit
   screen.key(['escape', 'q', 'C-c'], () => process.exit(0));
-  const TableWidget = /*@__PURE__*/require$1('../external/blessed-contrib/lib/widget/table.js');
+  const TableWidget = /*@__PURE__*/require$2('../external/blessed-contrib/lib/widget/table.js');
   const detailsBoxHeight = 20; // bottom N rows for details box
   const tipsBoxHeight = 1; // 1 row for tips box
 
@@ -13563,7 +13688,7 @@ async function outputThreatFeed(result, outputKind) {
     columnSpacing: 1,
     truncate: '_'
   });
-  const BoxWidget = /*@__PURE__*/require$1('../external/blessed/lib/widgets/box.js');
+  const BoxWidget = /*@__PURE__*/require$2('../external/blessed/lib/widgets/box.js');
   const tipsBox = new BoxWidget({
     bottom: detailsBoxHeight,
     // sits just above the details box
@@ -13670,23 +13795,23 @@ async function handleThreatFeed({
   await outputThreatFeed(data, outputKind);
 }
 
-const CMD_NAME = 'threat-feed';
+const CMD_NAME$1 = 'threat-feed';
 const ECOSYSTEMS = new Set(['gem', 'golang', 'maven', constants.NPM, 'nuget', 'pypi']);
 const TYPE_FILTERS = new Set(['anom', 'c', 'fp', 'joke', 'mal', 'secret', 'spy', 'tp', 'typo', 'u', 'vuln']);
-const description$1 = '[Beta] View the threat-feed';
-const hidden = false;
+const description$2 = '[Beta] View the threat-feed';
+const hidden$1 = false;
 const cmdThreatFeed = {
-  description: description$1,
-  hidden,
-  run: run$2
+  description: description$2,
+  hidden: hidden$1,
+  run: run$3
 };
-async function run$2(argv, importMeta, {
+async function run$3(argv, importMeta, {
   parentName
 }) {
   const config = {
-    commandName: CMD_NAME,
-    description: description$1,
-    hidden,
+    commandName: CMD_NAME$1,
+    description: description$2,
+    hidden: hidden$1,
     flags: {
       ...flags.commonFlags,
       ...flags.outputFlags,
@@ -13741,7 +13866,7 @@ async function run$2(argv, importMeta, {
       $ ${command} [options] [ECOSYSTEM] [TYPE_FILTER]
 
     API Token Requirements
-      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME}`)}
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME$1}`)}
       - Special access
 
     This feature requires a Threat Feed license. Please contact
@@ -14007,9 +14132,9 @@ const config$1 = {
 const cmdUninstallCompletion = {
   description: config$1.description,
   hidden: config$1.hidden,
-  run: run$1
+  run: run$2
 };
-async function run$1(argv, importMeta, {
+async function run$2(argv, importMeta, {
   parentName
 }) {
   const cli = utils.meowOrExit({
@@ -14027,9 +14152,9 @@ async function run$1(argv, importMeta, {
   await handleUninstallCompletion(String(targetName));
 }
 
-const description = 'Uninstall Socket CLI tab completion';
+const description$1 = 'Uninstall Socket CLI tab completion';
 const cmdUninstall = {
-  description,
+  description: description$1,
   hidden: false,
   async run(argv, importMeta, {
     parentName
@@ -14038,7 +14163,7 @@ const cmdUninstall = {
       completion: cmdUninstallCompletion
     }, {
       argv,
-      description,
+      description: description$1,
       importMeta,
       name: `${parentName} uninstall`
     });
@@ -14203,9 +14328,9 @@ const config = {
 const cmdWrapper = {
   description: config.description,
   hidden: config.hidden,
-  run
+  run: run$1
 };
-async function run(argv, importMeta, {
+async function run$1(argv, importMeta, {
   parentName
 }) {
   // I don't think meow would mess with this but ...
@@ -14278,6 +14403,71 @@ async function run(argv, importMeta, {
   }
 }
 
+const require$1 = require$$5.createRequire((typeof document === 'undefined' ? require$$0.pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli.js', document.baseURI).href)));
+const CMD_NAME = constants.YARN;
+const description = 'Run yarn with the Socket wrapper';
+const hidden = true;
+const cmdYarn = {
+  description,
+  hidden,
+  run
+};
+async function run(argv, importMeta, context) {
+  const {
+    parentName
+  } = {
+    __proto__: null,
+    ...context
+  };
+  const config = {
+    commandName: CMD_NAME,
+    description,
+    hidden,
+    flags: {
+      ...flags.commonFlags
+    },
+    help: command => `
+    Usage
+      $ ${command} ...
+
+    API Token Requirements
+      ${utils.getFlagApiRequirementsOutput(`${parentName}:${CMD_NAME}`)}
+
+    Note: Everything after "yarn" is passed to the yarn command.
+          Only the \`--dry-run\` and \`--help\` flags are caught here.
+
+    Use \`socket wrapper on\` to alias this command as \`yarn\`.
+
+    Examples
+      $ ${command}
+      $ ${command} install
+      $ ${command} add package-name
+      $ ${command} dlx package-name
+    `
+  };
+  const cli = utils.meowOrExit({
+    argv,
+    config,
+    importMeta,
+    parentName
+  });
+  const dryRun = !!cli.flags['dryRun'];
+  if (dryRun) {
+    logger.logger.log(constants.default.DRY_RUN_BAILING_NOW);
+    return;
+  }
+  const shadowBin = /*@__PURE__*/require$1(constants.default.shadowYarnBinPath);
+  process.exitCode = 1;
+
+  // Filter Socket flags from argv.
+  const filteredArgv = utils.filterFlags(argv, config.flags);
+  const {
+    spawnPromise
+  } = await shadowBin(filteredArgv);
+  await spawnPromise;
+  process.exitCode = 0;
+}
+
 const rootCommands = {
   analytics: cmdAnalytics,
   'audit-log': cmdAuditLog,
@@ -14294,6 +14484,7 @@ const rootCommands = {
   manifest: cmdManifest,
   npm: cmdNpm,
   npx: cmdNpx,
+  pnpm: cmdPnpm,
   oops: cmdOops,
   optimize: cmdOptimize,
   organization: cmdOrganization,
@@ -14306,7 +14497,8 @@ const rootCommands = {
   security: cmdOrganizationPolicySecurity,
   'threat-feed': cmdThreatFeed,
   uninstall: cmdUninstall,
-  wrapper: cmdWrapper
+  wrapper: cmdWrapper,
+  yarn: cmdYarn
 };
 const rootAliases = {
   audit: {
@@ -14396,7 +14588,11 @@ void (async () => {
     name: constants.default.SOCKET_CLI_BIN_NAME,
     registryUrl,
     ttl: 86_400_000 /* 24 hours in milliseconds */,
-    version: constants.default.ENV.INLINED_SOCKET_CLI_VERSION
+    version: constants.default.ENV.INLINED_SOCKET_CLI_VERSION,
+    logCallback: (name, version, latest) => {
+      logger.logger.log(`\n\n📦 Update available for ${vendor.yoctocolorsCjsExports.cyan(name)}: ${vendor.yoctocolorsCjsExports.gray(version)} → ${vendor.yoctocolorsCjsExports.green(latest)}`);
+      logger.logger.log(`📝 ${vendor.terminalLinkExports('View changelog', `https://socket.dev/npm/package/${name}/files/${latest}/CHANGELOG.md`)}`);
+    }
   });
   try {
     await utils.meowWithSubcommands(rootCommands, {
@@ -14464,5 +14660,5 @@ void (async () => {
     await utils.captureException(e);
   }
 })();
-//# debugId=d42a0267-36a6-4b2d-a161-8a78c8038a13
+//# debugId=5d651596-3967-43af-9860-99f4bc7ab867
 //# sourceMappingURL=cli.js.map