@yabasha/gex 1.0.0 → 1.1.0

package/dist/cli-node.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtimes/node/commands.ts","../src/shared/cli/install.ts","../src/shared/cli/output.ts","../src/shared/report/json.ts","../src/shared/report/md.ts","../src/shared/cli/parser.ts","../src/shared/cli/utils.ts","../src/runtimes/node/report.ts","../src/shared/transform.ts","../src/runtimes/node/package-manager.ts","../src/runtimes/node/cli.ts"],"sourcesContent":["/**\n * @fileoverview CLI command definitions and handlers\n */\n\nimport path from 'node:path'\n\nimport { Command } from 'commander'\n\nimport type { OutputFormat } from '../../shared/types.js'\nimport { installFromReport, printFromReport } from '../../shared/cli/install.js'\nimport { outputReport } from '../../shared/cli/output.js'\nimport { isMarkdownReportFile, loadReportFromFile } from '../../shared/cli/parser.js'\nimport { ASCII_BANNER, getToolVersion } from '../../shared/cli/utils.js'\n\nimport { produceReport } from './report.js'\n\n/**\n * Adds common options to a command\n *\n * @param cmd - Command to add options to\n * @param options - Configuration for which options to add\n * @returns Modified command\n */\nfunction addCommonOptions(cmd: Command, { allowOmitDev }: { allowOmitDev: boolean }): Command {\n  cmd\n    .option(\n      '-f, --output-format <format>',\n      'Output format: md or json',\n      (val) => (val === 'md' ? 'md' : 'json'),\n      'json',\n    )\n    .option('-o, --out-file <path>', 'Write report to file')\n    .option('--full-tree', 'Include full npm ls tree (omit depth=0 default)', false)\n\n  if (allowOmitDev) {\n    cmd.option('--omit-dev', 'Exclude devDependencies (local only)', false)\n  }\n\n  return cmd\n}\n\n/**\n * Creates the local command handler\n *\n * @param program - Commander program instance\n * @returns Command instance\n */\nexport function createLocalCommand(program: Command): Command {\n  const localCmd = program\n    .command('local', { isDefault: true })\n    .description(\"Generate a report for the current project's dependencies\")\n\n  addCommonOptions(localCmd, { allowOmitDev: true })\n\n  localCmd.action(async (opts) => {\n    const outputFormat = (opts.outputFormat ?? 'json') as OutputFormat\n    const outFile = opts.outFile as string | undefined\n    const fullTree = Boolean(opts.fullTree)\n    const omitDev = Boolean(opts.omitDev)\n\n    // Only set finalOutFile when explicitly provided via --out-file\n    const finalOutFile = outFile\n\n    const { report, markdownExtras } = await produceReport('local', {\n      outputFormat,\n      outFile: finalOutFile,\n      fullTree,\n      omitDev,\n    })\n\n    await outputReport(report, outputFormat, finalOutFile, markdownExtras)\n  })\n\n  return localCmd\n}\n\n/**\n * Creates the global command handler\n *\n * @param program - Commander program instance\n * @returns Command instance\n */\nexport function createGlobalCommand(program: Command): Command {\n  const globalCmd = program\n    .command('global')\n    .description('Generate a report of globally installed packages')\n\n  addCommonOptions(globalCmd, { allowOmitDev: false })\n\n  globalCmd.action(async (opts) => {\n    const outputFormat = (opts.outputFormat ?? 'json') as OutputFormat\n    const outFile = opts.outFile as string | undefined\n    const fullTree = Boolean(opts.fullTree)\n\n    // Only set finalOutFile when explicitly provided via --out-file\n    const finalOutFile = outFile\n\n    const { report, markdownExtras } = await produceReport('global', {\n      outputFormat,\n      outFile: finalOutFile,\n      fullTree,\n    })\n\n    await outputReport(report, outputFormat, finalOutFile, markdownExtras)\n  })\n\n  return globalCmd\n}\n\n/**\n * Creates the read command handler\n *\n * @param program - Commander program instance\n * @returns Command instance\n */\nexport function createReadCommand(program: Command): Command {\n  const readCmd = program\n    .command('read')\n    .description(\n      'Read a previously generated report (JSON or Markdown) and either print package names or install them',\n    )\n    .argument('[report]', 'Path to report file (JSON or Markdown)', 'gex-report.json')\n    .option('-r, --report <path>', 'Path to report file (JSON or Markdown)')\n    .option('-p, --print', 'Print package names/versions from the report (default)', false)\n    .option('-i, --install', 'Install packages from the report', false)\n\n  readCmd.action(async (reportArg: string | undefined, opts: any) => {\n    const chosen = (opts.report as string | undefined) || reportArg || 'gex-report.json'\n    const reportPath = path.resolve(process.cwd(), chosen)\n\n    try {\n      const parsed = await loadReportFromFile(reportPath)\n\n      const doInstall = Boolean(opts.install)\n      const doPrint = Boolean(opts.print) || !doInstall\n\n      if (doPrint) {\n        printFromReport(parsed)\n      }\n      if (doInstall) {\n        await installFromReport(parsed, { cwd: process.cwd(), packageManager: 'npm' })\n      }\n    } catch (err: any) {\n      const isMd = isMarkdownReportFile(reportPath)\n      const hint = isMd\n        ? 'Try generating a JSON report with: gex global -f json -o global.json, then: gex read global.json'\n        : 'Specify a report path with: gex read <path-to-report.json>'\n      console.error(`Failed to read report at ${reportPath}: ${err?.message || err}`)\n      console.error(hint)\n      process.exitCode = 1\n    }\n  })\n\n  return readCmd\n}\n\n/**\n * Creates and configures the main CLI program\n *\n * @returns Configured Commander program\n */\nexport async function createProgram(): Promise<Command> {\n  const program = new Command()\n    .name('gex')\n    .description('GEX: Dependency auditing and documentation for Node.js (local and global).')\n    .version(await getToolVersion())\n\n  program.addHelpText('beforeAll', `\\n${ASCII_BANNER}`)\n\n  createLocalCommand(program)\n  createGlobalCommand(program)\n  createReadCommand(program)\n\n  return program\n}\n","/**\n * @fileoverview Package installation utilities for CLI\n */\n\nimport type { Report } from '../types.js'\n\ntype PackageManager = 'npm' | 'bun'\n\nexport type InstallOptions = {\n  cwd: string\n  packageManager?: PackageManager\n}\n\nconst INSTALL_COMMANDS: Record<\n  PackageManager,\n  { global: string[]; local: string[]; dev: string[] }\n> = {\n  npm: {\n    global: ['i', '-g'],\n    local: ['i'],\n    dev: ['i', '-D'],\n  },\n  bun: {\n    global: ['add', '-g'],\n    local: ['add'],\n    dev: ['add', '-d'],\n  },\n}\n\nconst MAX_BUFFER = 10 * 1024 * 1024\n\nfunction formatSpec(pkg: { name: string; version: string }): string {\n  return pkg.version ? `${pkg.name}@${pkg.version}` : pkg.name\n}\n\n/**\n * Lazily obtain a promisified execFile so tests can mock built-ins reliably.\n */\nasync function getExecFileAsync(): Promise<\n  (\n    command: string,\n    args?: readonly string[] | null,\n    options?: any,\n  ) => Promise<{ stdout: string; stderr: string }>\n> {\n  const { execFile } = await import('node:child_process')\n  const { promisify } = await import('node:util')\n  return promisify(execFile) as any\n}\n\n/**\n * Installs packages from a report to the local environment\n *\n * @param report - The report containing packages to install\n * @param cwd - Current working directory for installation\n * @throws {Error} If npm installation fails\n */\nexport async function installFromReport(\n  report: Report,\n  options: InstallOptions | string,\n): Promise<void> {\n  const opts = typeof options === 'string' ? { cwd: options } : options\n  const { cwd, packageManager = 'npm' } = opts\n\n  const globalPkgs = report.global_packages.map(formatSpec).filter(Boolean)\n  const localPkgs = report.local_dependencies.map(formatSpec).filter(Boolean)\n  const devPkgs = report.local_dev_dependencies.map(formatSpec).filter(Boolean)\n\n  if (globalPkgs.length === 0 && localPkgs.length === 0 && devPkgs.length === 0) {\n    console.log('No packages to install from report.')\n    return\n  }\n\n  // Acquire execFileAsync once per run to keep logs grouped, while still mockable in tests\n  const execFileAsync = await getExecFileAsync()\n  const cmd = INSTALL_COMMANDS[packageManager]\n  const binary = packageManager === 'bun' ? 'bun' : 'npm'\n\n  if (globalPkgs.length > 0) {\n    console.log(`Installing global: ${globalPkgs.join(' ')}`)\n    await execFileAsync(binary, [...cmd.global, ...globalPkgs], { cwd, maxBuffer: MAX_BUFFER })\n  }\n\n  if (localPkgs.length > 0) {\n    console.log(`Installing local deps: ${localPkgs.join(' ')}`)\n    await execFileAsync(binary, [...cmd.local, ...localPkgs], { cwd, maxBuffer: MAX_BUFFER })\n  }\n\n  if (devPkgs.length > 0) {\n    console.log(`Installing local devDeps: ${devPkgs.join(' ')}`)\n    await execFileAsync(binary, [...cmd.dev, ...devPkgs], { cwd, maxBuffer: MAX_BUFFER })\n  }\n}\n\n/**\n * Prints packages from a report to the console\n *\n * @param report - The report to print packages from\n */\nexport function printFromReport(report: Report): void {\n  const lines: string[] = []\n\n  if (report.global_packages.length > 0) {\n    lines.push('Global Packages:')\n    for (const p of report.global_packages) {\n      lines.push(`- ${p.name}@${p.version}`)\n    }\n  }\n\n  if (report.local_dependencies.length > 0) {\n    if (lines.length) lines.push('')\n    lines.push('Local Dependencies:')\n    for (const p of report.local_dependencies) {\n      lines.push(`- ${p.name}@${p.version}`)\n    }\n  }\n\n  if (report.local_dev_dependencies.length > 0) {\n    if (lines.length) lines.push('')\n    lines.push('Local Dev Dependencies:')\n    for (const p of report.local_dev_dependencies) {\n      lines.push(`- ${p.name}@${p.version}`)\n    }\n  }\n\n  if (lines.length === 0) {\n    lines.push('(no packages found in report)')\n  }\n\n  console.log(lines.join('\\n'))\n}\n","/**\n * @fileoverview Report output utilities for CLI\n */\n\nimport path from 'node:path'\n\nimport { renderJson } from '../report/json.js'\nimport { renderMarkdown } from '../report/md.js'\nimport type { OutputFormat, Report } from '../types.js'\n\n/**\n * Outputs a report to console or file\n *\n * @param report - The report to output\n * @param format - Output format ('json' or 'md')\n * @param outFile - Optional file path to write to\n * @param markdownExtras - Additional metadata for markdown rendering\n */\nexport async function outputReport(\n  report: Report,\n  format: OutputFormat,\n  outFile?: string,\n  markdownExtras?: any,\n): Promise<void> {\n  const content =\n    format === 'json'\n      ? renderJson(report)\n      : renderMarkdown({ ...report, ...(markdownExtras || {}) })\n\n  if (outFile) {\n    const outDir = path.dirname(outFile)\n    const { mkdir, writeFile } = await import('node:fs/promises')\n\n    await mkdir(outDir, { recursive: true })\n    await writeFile(outFile, content, 'utf8')\n\n    console.log(`Wrote report to ${outFile}`)\n  } else {\n    console.log(content)\n  }\n}\n","/**\n * @fileoverview JSON report rendering utilities\n */\n\nimport type { Report } from '../types.js'\n\n/**\n * Renders a Report object as formatted JSON string\n *\n * @param report - Report object to render\n * @returns Pretty-printed JSON string with consistent package ordering\n *\n * @example\n * ```typescript\n * import { renderJson } from './report/json.js'\n *\n * const report = {\n *   report_version: '1.0',\n *   timestamp: new Date().toISOString(),\n *   tool_version: '0.3.2',\n *   global_packages: [],\n *   local_dependencies: [{ name: 'axios', version: '1.6.0', resolved_path: '/path/to/axios' }],\n *   local_dev_dependencies: []\n * }\n *\n * const jsonOutput = renderJson(report)\n * console.log(jsonOutput) // Pretty-printed JSON\n * ```\n */\nexport function renderJson(report: Report): string {\n  const r: Report = {\n    ...report,\n    global_packages: [...report.global_packages].sort((a, b) => a.name.localeCompare(b.name)),\n    local_dependencies: [...report.local_dependencies].sort((a, b) => a.name.localeCompare(b.name)),\n    local_dev_dependencies: [...report.local_dev_dependencies].sort((a, b) =>\n      a.name.localeCompare(b.name),\n    ),\n  }\n  return JSON.stringify(r, null, 2)\n}\n","/**\n * @fileoverview Markdown report rendering utilities\n */\n\nimport type { Report } from '../types.js'\n\n/**\n * Creates a markdown table from headers and row data\n *\n * @param headers - Array of table header strings\n * @param rows - Array of row data (each row is array of strings)\n * @returns Formatted markdown table string\n */\nfunction table(headers: string[], rows: string[][]): string {\n  const header = `| ${headers.join(' | ')} |`\n  const sep = `| ${headers.map(() => '---').join(' | ')} |`\n  const body = rows.map((r) => `| ${r.join(' | ')} |`).join('\\n')\n  return [header, sep, body].filter(Boolean).join('\\n')\n}\n\n/**\n * Renders a Report object as formatted Markdown\n *\n * @param report - Report object with optional project metadata\n * @returns Formatted Markdown string with tables and sections\n *\n * @example\n * ```typescript\n * import { renderMarkdown } from './report/md.js'\n *\n * const report = {\n *   report_version: '1.0',\n *   timestamp: new Date().toISOString(),\n *   tool_version: '0.3.2',\n *   project_name: 'my-project',\n *   global_packages: [],\n *   local_dependencies: [\n *     { name: 'axios', version: '1.6.0', resolved_path: '/path/to/axios' }\n *   ],\n *   local_dev_dependencies: [],\n *   project_description: 'My awesome project'\n * }\n *\n * const markdown = renderMarkdown(report)\n * console.log(markdown) // Formatted markdown with tables\n * ```\n */\nexport function renderMarkdown(\n  report: Report & {\n    project_description?: string\n    project_homepage?: string\n    project_bugs?: string\n  },\n): string {\n  const lines: string[] = []\n  lines.push('# GEX Report')\n  lines.push('')\n\n  if (\n    report.project_name ||\n    report.project_version ||\n    (report as any).project_description ||\n    (report as any).project_homepage ||\n    (report as any).project_bugs\n  ) {\n    lines.push('## Project Metadata')\n    if (report.project_name) lines.push(`- Name: ${report.project_name}`)\n    if (report.project_version) lines.push(`- Version: ${report.project_version}`)\n    if ((report as any).project_description)\n      lines.push(`- Description: ${(report as any).project_description}`)\n    if ((report as any).project_homepage)\n      lines.push(`- Homepage: ${(report as any).project_homepage}`)\n    if ((report as any).project_bugs) lines.push(`- Bugs: ${(report as any).project_bugs}`)\n    lines.push('')\n  }\n\n  if (report.global_packages.length > 0) {\n    lines.push('## Global Packages')\n    const rows = report.global_packages.map((p) => [p.name, p.version || '', p.resolved_path || ''])\n    lines.push(table(['Name', 'Version', 'Path'], rows))\n    lines.push('')\n  }\n\n  if (report.local_dependencies.length > 0) {\n    lines.push('## Local Dependencies')\n    const rows = report.local_dependencies.map((p) => [\n      p.name,\n      p.version || '',\n      p.resolved_path || '',\n    ])\n    lines.push(table(['Name', 'Version', 'Path'], rows))\n    lines.push('')\n  }\n\n  if (report.local_dev_dependencies.length > 0) {\n    lines.push('## Local Dev Dependencies')\n    const rows = report.local_dev_dependencies.map((p) => [\n      p.name,\n      p.version || '',\n      p.resolved_path || '',\n    ])\n    lines.push(table(['Name', 'Version', 'Path'], rows))\n    lines.push('')\n  }\n\n  lines.push('---')\n  lines.push('_Generated by GEX_')\n\n  return lines.join('\\n')\n}\n","/**\n * @fileoverview Report parsing utilities for CLI\n */\n\nimport { readFile } from 'node:fs/promises'\nimport path from 'node:path'\n\nimport type { PackageInfo, Report } from '../types.js'\n\n/**\n * Checks if a file path indicates a markdown report\n */\nexport function isMarkdownReportFile(filePath: string): boolean {\n  const ext = path.extname(filePath).toLowerCase()\n  return ext === '.md' || ext === '.markdown'\n}\n\n/**\n * Parses a markdown table and extracts package information\n *\n * @param lines - Array of file lines\n * @param startIndex - Index where table starts\n * @returns Array of package information\n */\nfunction parseMarkdownPackagesTable(lines: string[], startIndex: number): PackageInfo[] {\n  const rows: PackageInfo[] = []\n  if (!lines[startIndex] || !lines[startIndex].trim().startsWith('|')) return rows\n\n  let i = startIndex + 2\n  while (i < lines.length && lines[i].trim().startsWith('|')) {\n    const cols = lines[i]\n      .split('|')\n      .map((c) => c.trim())\n      .filter((_, idx, arr) => !(idx === 0 || idx === arr.length - 1))\n\n    const [name = '', version = '', resolved_path = ''] = cols\n    if (name) rows.push({ name, version, resolved_path })\n    i++\n  }\n  return rows\n}\n\n/**\n * Parses a markdown report and converts it to a Report object\n *\n * @param md - Markdown content to parse\n * @returns Parsed Report object\n */\nexport function parseMarkdownReport(md: string): Report {\n  const lines = md.split(/\\r?\\n/)\n\n  const findSection = (title: string) =>\n    lines.findIndex((l) => l.trim().toLowerCase() === `## ${title}`.toLowerCase())\n\n  const parseSection = (idx: number): PackageInfo[] => {\n    if (idx < 0) return []\n\n    let i = idx + 1\n    while (i < lines.length && !lines[i].trim().startsWith('|')) i++\n    return parseMarkdownPackagesTable(lines, i)\n  }\n\n  const global_packages = parseSection(findSection('Global Packages'))\n  const local_dependencies = parseSection(findSection('Local Dependencies'))\n  const local_dev_dependencies = parseSection(findSection('Local Dev Dependencies'))\n\n  const report: Report = {\n    report_version: '1.0',\n    timestamp: new Date().toISOString(),\n    tool_version: 'unknown',\n    global_packages,\n    local_dependencies,\n    local_dev_dependencies,\n  }\n  return report\n}\n\n/**\n * Loads and parses a report file (JSON or Markdown)\n *\n * @param reportPath - Path to the report file\n * @returns Parsed Report object\n * @throws {Error} If file cannot be read or parsed\n */\nexport async function loadReportFromFile(reportPath: string): Promise<Report> {\n  const raw = await readFile(reportPath, 'utf8')\n\n  if (isMarkdownReportFile(reportPath) || raw.startsWith('# GEX Report')) {\n    return parseMarkdownReport(raw)\n  }\n\n  return JSON.parse(raw) as Report\n}\n","/**\n * @fileoverview CLI utility functions for version handling and path resolution\n */\n\nimport { existsSync } from 'node:fs'\nimport { readFile } from 'node:fs/promises'\nimport path from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\n/**\n * Gets the path to package.json for version resolution\n */\nexport function getPkgJsonPath(): string {\n  let startDir: string\n  try {\n    const __filename = fileURLToPath((import.meta as any).url)\n    startDir = path.dirname(__filename)\n  } catch {\n    startDir = typeof __dirname !== 'undefined' ? __dirname : process.cwd()\n  }\n\n  return findPackageJson(startDir)\n}\n\nfunction findPackageJson(startDir: string): string {\n  let current = startDir\n  const maxDepth = 6\n\n  for (let i = 0; i < maxDepth; i++) {\n    const candidate = path.resolve(current, 'package.json')\n    if (existsSync(candidate)) {\n      return candidate\n    }\n\n    const parent = path.dirname(current)\n    if (parent === current) break\n    current = parent\n  }\n\n  return path.resolve(process.cwd(), 'package.json')\n}\n\n/**\n * Gets the current tool version from package.json\n */\nexport async function getToolVersion(): Promise<string> {\n  try {\n    const pkgPath = getPkgJsonPath()\n    const raw = await readFile(pkgPath, 'utf8')\n    const pkg = JSON.parse(raw)\n    return pkg.version || '0.0.0'\n  } catch {\n    return '0.0.0'\n  }\n}\n\n/**\n * ASCII banner for the CLI\n */\nexport const ASCII_BANNER = String.raw`\n  ________                __\n /  _____/  ____   _____/  |_  ____   ____\n/   \\  ___ /  _ \\ /  _ \\   __\\/ __ \\ /    \\\n\\    \\_\\  (  <_> |  <_> )  | \\  ___/|   |  \\\n \\______  /\\____/ \\____/|__|  \\___  >___|  /\n        \\/                         \\/     \\/\n                      GEX\n`\n","/**\n * @fileoverview Report generation utilities for CLI\n */\n\nimport { readFile } from 'node:fs/promises'\nimport path from 'node:path'\n\nimport { buildReportFromNpmTree } from '../../shared/transform.js'\nimport type { OutputFormat, Report } from '../../shared/types.js'\nimport { getToolVersion } from '../../shared/cli/utils.js'\n\nimport { npmLs, npmRootGlobal } from './package-manager.js'\n\n/**\n * Options for report generation\n */\nexport interface ReportOptions {\n  outputFormat: OutputFormat\n  outFile?: string\n  fullTree?: boolean\n  omitDev?: boolean\n  cwd?: string\n}\n\n/**\n * Result of report generation including markdown extras\n */\nexport interface ReportResult {\n  report: Report\n  markdownExtras?: {\n    project_description?: string\n    project_homepage?: string\n    project_bugs?: string\n  }\n}\n\n/**\n * Produces a dependency report for local or global context\n *\n * @param ctx - Context for report generation ('local' or 'global')\n * @param options - Report generation options\n * @returns Report and optional markdown extras\n */\nexport async function produceReport(\n  ctx: 'local' | 'global',\n  options: ReportOptions,\n): Promise<ReportResult> {\n  const toolVersion = await getToolVersion()\n  const depth0 = !options.fullTree\n  const cwd = options.cwd || process.cwd()\n\n  const tree = await npmLs({\n    global: ctx === 'global',\n    omitDev: ctx === 'local' ? Boolean(options.omitDev) : false,\n    depth0,\n    cwd,\n  })\n\n  let project_description: string | undefined\n  let project_homepage: string | undefined\n  let project_bugs: string | undefined\n\n  if (ctx === 'local') {\n    try {\n      const pkgRaw = await readFile(path.join(cwd, 'package.json'), 'utf8')\n      const pkg = JSON.parse(pkgRaw)\n      project_description = pkg.description\n      project_homepage = pkg.homepage\n      if (typeof pkg.bugs === 'string') project_bugs = pkg.bugs\n      else if (pkg.bugs && typeof pkg.bugs.url === 'string') project_bugs = pkg.bugs.url\n    } catch {\n      // Ignore errors reading local package.json (e.g., file missing or invalid JSON)\n      void 0\n    }\n  }\n\n  const globalRoot = ctx === 'global' ? await npmRootGlobal().catch(() => undefined) : undefined\n\n  const report = await buildReportFromNpmTree(tree, {\n    context: ctx,\n    includeTree: Boolean(options.fullTree),\n    omitDev: Boolean(options.omitDev),\n    cwd,\n    toolVersion,\n    globalRoot,\n  })\n\n  const markdownExtras = { project_description, project_homepage, project_bugs }\n  return { report, markdownExtras }\n}\n","/**\n * @fileoverview Data transformation utilities for converting npm tree data into reports\n */\n\nimport path from 'node:path'\nimport { readFile } from 'node:fs/promises'\n\nimport type { PackageInfo, Report } from './types.js'\n\n/**\n * Options for report generation and normalization\n */\nexport type NormalizeOptions = {\n  /** Context for report generation ('local' or 'global') */\n  context: 'local' | 'global'\n  /** Whether to include the full npm dependency tree */\n  includeTree?: boolean\n  /** Whether to omit devDependencies (local context only) */\n  omitDev?: boolean\n  /** Current working directory */\n  cwd?: string\n  /** Tool version to include in report */\n  toolVersion: string\n  /** Global npm root directory path */\n  globalRoot?: string\n}\n\n/**\n * Converts npm dependency object to array of package entries\n *\n * @param obj - npm dependency object from npm ls output\n * @returns Array of name/node pairs for packages\n */\nfunction toPkgArray(obj: Record<string, any> | undefined | null): { name: string; node: any }[] {\n  if (!obj) return []\n  return Object.keys(obj)\n    .map((name) => ({ name, node: obj[name] }))\n    .filter((p) => p && p.node)\n}\n\n/**\n * Builds a GEX report from npm ls tree output\n *\n * @param tree - Raw npm ls command output\n * @param opts - Report generation options\n * @returns Promise resolving to a formatted Report object\n *\n * @example\n * ```typescript\n * import { buildReportFromNpmTree } from './transform.js'\n * import { npmLs } from './npm.js'\n *\n * const tree = await npmLs({ depth0: true })\n * const report = await buildReportFromNpmTree(tree, {\n *   context: 'local',\n *   toolVersion: '0.3.2',\n *   cwd: process.cwd()\n * })\n *\n * console.log(`Found ${report.local_dependencies.length} dependencies`)\n * ```\n */\nexport async function buildReportFromNpmTree(tree: any, opts: NormalizeOptions): Promise<Report> {\n  const timestamp = new Date().toISOString()\n  const report: Report = {\n    report_version: '1.0',\n    timestamp,\n    tool_version: opts.toolVersion,\n    global_packages: [],\n    local_dependencies: [],\n    local_dev_dependencies: [],\n  }\n\n  if (opts.context === 'local') {\n    let pkgMeta: any = null\n    try {\n      const pkgJsonPath = path.join(opts.cwd || process.cwd(), 'package.json')\n      const raw = await readFile(pkgJsonPath, 'utf8')\n      pkgMeta = JSON.parse(raw)\n    } catch {\n      // Ignore errors reading/parsing package.json; fall back to undefined metadata\n      void 0\n    }\n    if (pkgMeta?.name) report.project_name = pkgMeta.name\n    if (pkgMeta?.version) report.project_version = pkgMeta.version\n\n    const depsObj = tree?.dependencies as Record<string, any> | undefined\n    const devDepsObj = tree?.devDependencies as Record<string, any> | undefined\n    const prodItems = toPkgArray(depsObj)\n    const treeDevItems = toPkgArray(devDepsObj)\n\n    if (treeDevItems.length > 0) {\n      for (const { name, node } of treeDevItems) {\n        const version = (node && node.version) || ''\n        const resolvedPath =\n          (node && node.path) || path.join(opts.cwd || process.cwd(), 'node_modules', name)\n        report.local_dev_dependencies.push({ name, version, resolved_path: resolvedPath })\n      }\n    }\n\n    const devKeys =\n      treeDevItems.length > 0\n        ? new Set(treeDevItems.map((entry) => entry.name))\n        : new Set(Object.keys((pkgMeta?.devDependencies as Record<string, string>) || {}))\n\n    for (const { name, node } of prodItems) {\n      const version = (node && node.version) || ''\n      const resolvedPath =\n        (node && node.path) || path.join(opts.cwd || process.cwd(), 'node_modules', name)\n      const pkg: PackageInfo = { name, version, resolved_path: resolvedPath }\n      if (!treeDevItems.length && devKeys.has(name)) {\n        report.local_dev_dependencies.push(pkg)\n      } else {\n        report.local_dependencies.push(pkg)\n      }\n    }\n\n    report.local_dependencies.sort((a, b) => a.name.localeCompare(b.name))\n    report.local_dev_dependencies.sort((a, b) => a.name.localeCompare(b.name))\n  } else if (opts.context === 'global') {\n    const depsObj = tree?.dependencies as Record<string, any> | undefined\n    const items = toPkgArray(depsObj)\n\n    for (const { name, node } of items) {\n      const version = (node && node.version) || ''\n      const resolvedPath = (node && node.path) || path.join(opts.globalRoot || '', name)\n      const pkg: PackageInfo = { name, version, resolved_path: resolvedPath }\n      report.global_packages.push(pkg)\n    }\n\n    report.global_packages.sort((a, b) => a.name.localeCompare(b.name))\n  }\n\n  if (opts.includeTree) {\n    report.tree = tree\n  }\n\n  return report\n}\n","/**\n * @fileoverview npm command execution utilities for dependency analysis\n */\n\n/**\n * Lazily obtain a promisified execFile so tests can mock built-ins reliably.\n */\nasync function getExecFileAsync(): Promise<\n  (\n    command: string,\n    args?: readonly string[] | null,\n    options?: any,\n  ) => Promise<{ stdout: string; stderr: string }>\n> {\n  const { execFile } = await import('node:child_process')\n  const { promisify } = await import('node:util')\n  return promisify(execFile) as any\n}\n\n/**\n * Options for npm ls command execution\n */\nexport type NpmLsOptions = {\n  /** Whether to list global packages */\n  global?: boolean\n  /** Whether to omit devDependencies */\n  omitDev?: boolean\n  /** Whether to use depth=0 for faster execution */\n  depth0?: boolean\n  /** Current working directory for command execution */\n  cwd?: string\n}\n\n/**\n * Executes npm ls command and returns parsed dependency tree\n *\n * @param options - Configuration options for npm ls command\n * @returns Promise resolving to npm dependency tree object\n * @throws {Error} If npm command fails or output cannot be parsed\n *\n * @example\n * ```typescript\n * import { npmLs } from './npm.js'\n *\n * // Get local dependencies with devDependencies omitted\n * const tree = await npmLs({ omitDev: true, depth0: true })\n *\n * // Get global packages\n * const globalTree = await npmLs({ global: true })\n * ```\n */\nexport async function npmLs(options: NpmLsOptions = {}): Promise<any> {\n  const args = ['ls', '--json']\n  if (options.global) args.push('--global')\n  if (options.omitDev) args.push('--omit=dev')\n  if (options.depth0) args.push('--depth=0')\n\n  try {\n    const execFileAsync = await getExecFileAsync()\n    const { stdout } = await execFileAsync('npm', args, {\n      cwd: options.cwd,\n      maxBuffer: 10 * 1024 * 1024,\n    })\n    if (stdout && stdout.trim()) return JSON.parse(stdout)\n    return {}\n  } catch (err: any) {\n    const stdout = err?.stdout\n    if (typeof stdout === 'string' && stdout.trim()) {\n      try {\n        return JSON.parse(stdout)\n      } catch (parseErr) {\n        if (process.env.DEBUG?.includes('gex')) {\n          console.warn('npm ls stdout parse failed:', parseErr)\n        }\n      }\n    }\n    const stderr = err?.stderr\n    const msg = (typeof stderr === 'string' && stderr.trim()) || err?.message || 'npm ls failed'\n    throw new Error(`npm ls failed: ${msg}`)\n  }\n}\n\n/**\n * Gets the global npm root directory path\n *\n * @returns Promise resolving to the global npm root path\n * @throws {Error} If npm root -g command fails\n *\n * @example\n * ```typescript\n * import { npmRootGlobal } from './npm.js'\n *\n * try {\n *   const globalRoot = await npmRootGlobal()\n *   console.log('Global npm root:', globalRoot)\n * } catch (error) {\n *   console.error('Failed to get global root:', error.message)\n * }\n * ```\n */\nexport async function npmRootGlobal(): Promise<string> {\n  try {\n    const execFileAsync = await getExecFileAsync()\n    const { stdout } = await execFileAsync('npm', ['root', '-g'])\n    return stdout.trim()\n  } catch (err: any) {\n    const stderr = err?.stderr\n    const msg =\n      (typeof stderr === 'string' && stderr.trim()) || err?.message || 'npm root -g failed'\n    throw new Error(`npm root -g failed: ${msg}`)\n  }\n}\n","/**\n * @fileoverview Node.js CLI entry point for GEX dependency auditing tool\n */\n\nimport { createProgram } from './commands.js'\n\n/**\n * Main CLI runner function\n *\n * @param argv - Command line arguments (defaults to process.argv)\n */\nexport async function run(argv = process.argv): Promise<void> {\n  const program = await createProgram()\n  await program.parseAsync(argv)\n}\n\nconst isMainModule = (() => {\n  try {\n    if (typeof require !== 'undefined' && typeof module !== 'undefined') {\n      return (require as any).main === module\n    }\n\n    if (typeof import.meta !== 'undefined') {\n      return import.meta.url === `file://${process.argv[1]}`\n    }\n    return false\n  } catch {\n    return false\n  }\n})()\n\nif (isMainModule) {\n  run().catch((error) => {\n    console.error('CLI error:', error)\n    process.exitCode = 1\n  })\n}\n"],"mappings":"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","names":["path","path","readFile","path","readFile","path","path","readFile","getExecFileAsync","readFile","path","path"]}

package/dist/cli.cjs

@@ -31,40 +31,60 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/cli.ts
 var cli_exports = {};
 __export(cli_exports, {
-  run: () => run
+  run: () => run2
 });
 module.exports = __toCommonJS(cli_exports);
 
-// src/cli/commands.ts
+// src/runtimes/node/commands.ts
 var import_node_path6 = __toESM(require("path"), 1);
 var import_commander = require("commander");
 
-// src/cli/install.ts
+// src/shared/cli/install.ts
+var INSTALL_COMMANDS = {
+  npm: {
+    global: ["i", "-g"],
+    local: ["i"],
+    dev: ["i", "-D"]
+  },
+  bun: {
+    global: ["add", "-g"],
+    local: ["add"],
+    dev: ["add", "-d"]
+  }
+};
+var MAX_BUFFER = 10 * 1024 * 1024;
+function formatSpec(pkg) {
+  return pkg.version ? `${pkg.name}@${pkg.version}` : pkg.name;
+}
 async function getExecFileAsync() {
   const { execFile } = await import("child_process");
   const { promisify } = await import("util");
   return promisify(execFile);
 }
-async function installFromReport(report, cwd) {
-  const globalPkgs = report.global_packages.map((p) => `${p.name}@${p.version}`).filter(Boolean);
-  const localPkgs = report.local_dependencies.map((p) => `${p.name}@${p.version}`).filter(Boolean);
-  const devPkgs = report.local_dev_dependencies.map((p) => `${p.name}@${p.version}`).filter(Boolean);
+async function installFromReport(report, options) {
+  const opts = typeof options === "string" ? { cwd: options } : options;
+  const { cwd, packageManager = "npm" } = opts;
+  const globalPkgs = report.global_packages.map(formatSpec).filter(Boolean);
+  const localPkgs = report.local_dependencies.map(formatSpec).filter(Boolean);
+  const devPkgs = report.local_dev_dependencies.map(formatSpec).filter(Boolean);
   if (globalPkgs.length === 0 && localPkgs.length === 0 && devPkgs.length === 0) {
     console.log("No packages to install from report.");
     return;
   }
   const execFileAsync = await getExecFileAsync();
+  const cmd = INSTALL_COMMANDS[packageManager];
+  const binary = packageManager === "bun" ? "bun" : "npm";
   if (globalPkgs.length > 0) {
     console.log(`Installing global: ${globalPkgs.join(" ")}`);
-    await execFileAsync("npm", ["i", "-g", ...globalPkgs], { cwd, maxBuffer: 10 * 1024 * 1024 });
+    await execFileAsync(binary, [...cmd.global, ...globalPkgs], { cwd, maxBuffer: MAX_BUFFER });
   }
   if (localPkgs.length > 0) {
     console.log(`Installing local deps: ${localPkgs.join(" ")}`);
-    await execFileAsync("npm", ["i", ...localPkgs], { cwd, maxBuffer: 10 * 1024 * 1024 });
+    await execFileAsync(binary, [...cmd.local, ...localPkgs], { cwd, maxBuffer: MAX_BUFFER });
   }
   if (devPkgs.length > 0) {
     console.log(`Installing local devDeps: ${devPkgs.join(" ")}`);
-    await execFileAsync("npm", ["i", "-D", ...devPkgs], { cwd, maxBuffer: 10 * 1024 * 1024 });
+    await execFileAsync(binary, [...cmd.dev, ...devPkgs], { cwd, maxBuffer: MAX_BUFFER });
   }
 }
 function printFromReport(report) {
@@ -95,10 +115,10 @@ function printFromReport(report) {
   console.log(lines.join("\n"));
 }
 
-// src/cli/output.ts
+// src/shared/cli/output.ts
 var import_node_path = __toESM(require("path"), 1);
 
-// src/report/json.ts
+// src/shared/report/json.ts
 function renderJson(report) {
   const r = {
     ...report,
@@ -111,7 +131,7 @@ function renderJson(report) {
   return JSON.stringify(r, null, 2);
 }
 
-// src/report/md.ts
+// src/shared/report/md.ts
 function table(headers, rows) {
   const header = `| ${headers.join(" | ")} |`;
   const sep = `| ${headers.map(() => "---").join(" | ")} |`;
@@ -164,7 +184,7 @@ function renderMarkdown(report) {
   return lines.join("\n");
 }
 
-// src/cli/output.ts
+// src/shared/cli/output.ts
 async function outputReport(report, format, outFile, markdownExtras) {
   const content = format === "json" ? renderJson(report) : renderMarkdown({ ...report, ...markdownExtras || {} });
   if (outFile) {
@@ -178,7 +198,7 @@ async function outputReport(report, format, outFile, markdownExtras) {
   }
 }
 
-// src/cli/parser.ts
+// src/shared/cli/parser.ts
 var import_promises = require("fs/promises");
 var import_node_path2 = __toESM(require("path"), 1);
 function isMarkdownReportFile(filePath) {
@@ -227,60 +247,63 @@ async function loadReportFromFile(reportPath) {
   return JSON.parse(raw);
 }
 
-// src/cli/report.ts
-var import_promises4 = require("fs/promises");
-var import_node_path5 = __toESM(require("path"), 1);
-
-// src/npm.ts
-async function getExecFileAsync2() {
-  const { execFile } = await import("child_process");
-  const { promisify } = await import("util");
-  return promisify(execFile);
-}
-async function npmLs(options = {}) {
-  const args = ["ls", "--json"];
-  if (options.global) args.push("--global");
-  if (options.omitDev) args.push("--omit=dev");
-  if (options.depth0) args.push("--depth=0");
+// src/shared/cli/utils.ts
+var import_node_fs = require("fs");
+var import_promises2 = require("fs/promises");
+var import_node_path3 = __toESM(require("path"), 1);
+var import_node_url = require("url");
+var import_meta = {};
+function getPkgJsonPath() {
+  let startDir;
   try {
-    const execFileAsync = await getExecFileAsync2();
-    const { stdout } = await execFileAsync("npm", args, {
-      cwd: options.cwd,
-      maxBuffer: 10 * 1024 * 1024
-    });
-    if (stdout && stdout.trim()) return JSON.parse(stdout);
-    return {};
-  } catch (err) {
-    const stdout = err?.stdout;
-    if (typeof stdout === "string" && stdout.trim()) {
-      try {
-        return JSON.parse(stdout);
-      } catch (parseErr) {
-        if (process.env.DEBUG?.includes("gex")) {
-          console.warn("npm ls stdout parse failed:", parseErr);
-        }
-      }
+    const __filename = (0, import_node_url.fileURLToPath)(import_meta.url);
+    startDir = import_node_path3.default.dirname(__filename);
+  } catch {
+    startDir = typeof __dirname !== "undefined" ? __dirname : process.cwd();
+  }
+  return findPackageJson(startDir);
+}
+function findPackageJson(startDir) {
+  let current = startDir;
+  const maxDepth = 6;
+  for (let i = 0; i < maxDepth; i++) {
+    const candidate = import_node_path3.default.resolve(current, "package.json");
+    if ((0, import_node_fs.existsSync)(candidate)) {
+      return candidate;
     }
-    const stderr = err?.stderr;
-    const msg = typeof stderr === "string" && stderr.trim() || err?.message || "npm ls failed";
-    throw new Error(`npm ls failed: ${msg}`);
+    const parent = import_node_path3.default.dirname(current);
+    if (parent === current) break;
+    current = parent;
   }
+  return import_node_path3.default.resolve(process.cwd(), "package.json");
 }
-async function npmRootGlobal() {
+async function getToolVersion() {
   try {
-    const execFileAsync = await getExecFileAsync2();
-    const { stdout } = await execFileAsync("npm", ["root", "-g"]);
-    return stdout.trim();
-  } catch (err) {
-    const stderr = err?.stderr;
-    const msg = typeof stderr === "string" && stderr.trim() || err?.message || "npm root -g failed";
-    throw new Error(`npm root -g failed: ${msg}`);
+    const pkgPath = getPkgJsonPath();
+    const raw = await (0, import_promises2.readFile)(pkgPath, "utf8");
+    const pkg = JSON.parse(raw);
+    return pkg.version || "0.0.0";
+  } catch {
+    return "0.0.0";
   }
 }
+var ASCII_BANNER = String.raw`
+  ________                __
+ /  _____/  ____   _____/  |_  ____   ____
+/   \  ___ /  _ \ /  _ \   __\/ __ \ /    \
+\    \_\  (  <_> |  <_> )  | \  ___/|   |  \
+ \______  /\____/ \____/|__|  \___  >___|  /
+        \/                         \/     \/
+                      GEX
+`;
 
-// src/transform.ts
-var import_node_path3 = __toESM(require("path"), 1);
-var import_promises2 = require("fs/promises");
+// src/runtimes/node/report.ts
+var import_promises4 = require("fs/promises");
+var import_node_path5 = __toESM(require("path"), 1);
+
+// src/shared/transform.ts
+var import_node_path4 = __toESM(require("path"), 1);
+var import_promises3 = require("fs/promises");
 function toPkgArray(obj) {
   if (!obj) return [];
   return Object.keys(obj).map((name) => ({ name, node: obj[name] })).filter((p) => p && p.node);
@@ -298,21 +321,30 @@ async function buildReportFromNpmTree(tree, opts) {
   if (opts.context === "local") {
     let pkgMeta = null;
     try {
-      const pkgJsonPath = import_node_path3.default.join(opts.cwd || process.cwd(), "package.json");
-      const raw = await (0, import_promises2.readFile)(pkgJsonPath, "utf8");
+      const pkgJsonPath = import_node_path4.default.join(opts.cwd || process.cwd(), "package.json");
+      const raw = await (0, import_promises3.readFile)(pkgJsonPath, "utf8");
       pkgMeta = JSON.parse(raw);
     } catch {
     }
     if (pkgMeta?.name) report.project_name = pkgMeta.name;
     if (pkgMeta?.version) report.project_version = pkgMeta.version;
     const depsObj = tree?.dependencies;
-    const items = toPkgArray(depsObj);
-    const devKeys = new Set(Object.keys(pkgMeta?.devDependencies || {}));
-    for (const { name, node } of items) {
+    const devDepsObj = tree?.devDependencies;
+    const prodItems = toPkgArray(depsObj);
+    const treeDevItems = toPkgArray(devDepsObj);
+    if (treeDevItems.length > 0) {
+      for (const { name, node } of treeDevItems) {
+        const version = node && node.version || "";
+        const resolvedPath = node && node.path || import_node_path4.default.join(opts.cwd || process.cwd(), "node_modules", name);
+        report.local_dev_dependencies.push({ name, version, resolved_path: resolvedPath });
+      }
+    }
+    const devKeys = treeDevItems.length > 0 ? new Set(treeDevItems.map((entry) => entry.name)) : new Set(Object.keys(pkgMeta?.devDependencies || {}));
+    for (const { name, node } of prodItems) {
       const version = node && node.version || "";
-      const resolvedPath = node && node.path || import_node_path3.default.join(opts.cwd || process.cwd(), "node_modules", name);
+      const resolvedPath = node && node.path || import_node_path4.default.join(opts.cwd || process.cwd(), "node_modules", name);
       const pkg = { name, version, resolved_path: resolvedPath };
-      if (devKeys.has(name)) {
+      if (!treeDevItems.length && devKeys.has(name)) {
         report.local_dev_dependencies.push(pkg);
       } else {
         report.local_dependencies.push(pkg);
@@ -325,7 +357,7 @@ async function buildReportFromNpmTree(tree, opts) {
     const items = toPkgArray(depsObj);
     for (const { name, node } of items) {
       const version = node && node.version || "";
-      const resolvedPath = node && node.path || import_node_path3.default.join(opts.globalRoot || "", name);
+      const resolvedPath = node && node.path || import_node_path4.default.join(opts.globalRoot || "", name);
       const pkg = { name, version, resolved_path: resolvedPath };
       report.global_packages.push(pkg);
     }
@@ -337,42 +369,54 @@ async function buildReportFromNpmTree(tree, opts) {
   return report;
 }
 
-// src/cli/utils.ts
-var import_promises3 = require("fs/promises");
-var import_node_path4 = __toESM(require("path"), 1);
-var import_node_url = require("url");
-var import_meta = {};
-function getPkgJsonPath() {
+// src/runtimes/node/package-manager.ts
+async function getExecFileAsync2() {
+  const { execFile } = await import("child_process");
+  const { promisify } = await import("util");
+  return promisify(execFile);
+}
+async function npmLs(options = {}) {
+  const args = ["ls", "--json"];
+  if (options.global) args.push("--global");
+  if (options.omitDev) args.push("--omit=dev");
+  if (options.depth0) args.push("--depth=0");
   try {
-    const __filename = (0, import_node_url.fileURLToPath)(import_meta.url);
-    const __dirnameLocal = import_node_path4.default.dirname(__filename);
-    return import_node_path4.default.resolve(__dirnameLocal, "..", "..", "package.json");
-  } catch {
-    const dir = typeof __dirname !== "undefined" ? __dirname : process.cwd();
-    return import_node_path4.default.resolve(dir, "..", "package.json");
+    const execFileAsync = await getExecFileAsync2();
+    const { stdout } = await execFileAsync("npm", args, {
+      cwd: options.cwd,
+      maxBuffer: 10 * 1024 * 1024
+    });
+    if (stdout && stdout.trim()) return JSON.parse(stdout);
+    return {};
+  } catch (err) {
+    const stdout = err?.stdout;
+    if (typeof stdout === "string" && stdout.trim()) {
+      try {
+        return JSON.parse(stdout);
+      } catch (parseErr) {
+        if (process.env.DEBUG?.includes("gex")) {
+          console.warn("npm ls stdout parse failed:", parseErr);
+        }
+      }
+    }
+    const stderr = err?.stderr;
+    const msg = typeof stderr === "string" && stderr.trim() || err?.message || "npm ls failed";
+    throw new Error(`npm ls failed: ${msg}`);
   }
 }
-async function getToolVersion() {
+async function npmRootGlobal() {
   try {
-    const pkgPath = getPkgJsonPath();
-    const raw = await (0, import_promises3.readFile)(pkgPath, "utf8");
-    const pkg = JSON.parse(raw);
-    return pkg.version || "0.0.0";
-  } catch {
-    return "0.0.0";
+    const execFileAsync = await getExecFileAsync2();
+    const { stdout } = await execFileAsync("npm", ["root", "-g"]);
+    return stdout.trim();
+  } catch (err) {
+    const stderr = err?.stderr;
+    const msg = typeof stderr === "string" && stderr.trim() || err?.message || "npm root -g failed";
+    throw new Error(`npm root -g failed: ${msg}`);
   }
 }
-var ASCII_BANNER = String.raw`
-  ________                __
- /  _____/  ____   _____/  |_  ____   ____
-/   \  ___ /  _ \ /  _ \   __\/ __ \ /    \
-\    \_\  (  <_> |  <_> )  | \  ___/|   |  \
- \______  /\____/ \____/|__|  \___  >___|  /
-        \/                         \/     \/
-                      GEX
-`;
 
-// src/cli/report.ts
+// src/runtimes/node/report.ts
 async function produceReport(ctx, options) {
   const toolVersion = await getToolVersion();
   const depth0 = !options.fullTree;
@@ -410,7 +454,7 @@ async function produceReport(ctx, options) {
   return { report, markdownExtras };
 }
 
-// src/cli/commands.ts
+// src/runtimes/node/commands.ts
 function addCommonOptions(cmd, { allowOmitDev }) {
   cmd.option(
     "-f, --output-format <format>",
@@ -474,7 +518,7 @@ function createReadCommand(program) {
         printFromReport(parsed);
       }
       if (doInstall) {
-        await installFromReport(parsed, process.cwd());
+        await installFromReport(parsed, { cwd: process.cwd(), packageManager: "npm" });
       }
     } catch (err) {
       const isMd = isMarkdownReportFile(reportPath);
@@ -496,7 +540,7 @@ ${ASCII_BANNER}`);
   return program;
 }
 
-// src/cli.ts
+// src/runtimes/node/cli.ts
 var import_meta2 = {};
 async function run(argv = process.argv) {
   const program = await createProgram();
@@ -521,6 +565,31 @@ if (isMainModule) {
     process.exitCode = 1;
   });
 }
+
+// src/cli.ts
+var import_meta3 = {};
+async function run2(argv = process.argv) {
+  return run(argv);
+}
+var isMainModule2 = (() => {
+  try {
+    if (typeof require !== "undefined" && typeof module !== "undefined") {
+      return require.main === module;
+    }
+    if (typeof import_meta3 !== "undefined") {
+      return import_meta3.url === `file://${process.argv[1]}`;
+    }
+    return false;
+  } catch {
+    return false;
+  }
+})();
+if (isMainModule2) {
+  run2().catch((error) => {
+    console.error("CLI error:", error);
+    process.exitCode = 1;
+  });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   run