@yabasha/gex 0.1.0

package/LICENSE

@@ -0,0 +1,16 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE
+OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,137 @@
+```
+  ________                __
+ /  _____/  ____   _____/  |_  ____   ____
+/   \\  ___ /  _ \\ /  _ \\   __\\/ __ \\ /    \\
+\\    \\_\\  (  <_> |  <_> )  | \\  ___/|   |  \\
+ \\______  /\\____/ \\____/|__|  \\___  >___|  /
+        \\/                         \\/     \\/
+                      GEX
+
+```
+
+# GEX — Global/local dependency auditing and documentation for Node.js
+
+GEX is a focused CLI that generates structured, reproducible reports of your Node.js package environments:
+
+- Local project dependencies (default)
+- Globally installed packages
+
+Reports can be emitted as machine-readable JSON (default) or human-friendly Markdown. Use GEX to inventory environments, document state for handovers/audits, and keep a versionable dependency log.
+
+## Install
+
+- Requirements: Node >= 18.18, npm
+- Global install:
+
+```bash
+npm i -g @yabasha/gex
+```
+
+Or run locally after building this repo:
+
+```bash
+npm i
+npm run build
+node dist/cli.cjs --help
+```
+
+## Usage
+
+Synopsis:
+
+```bash
+gex [options]          # defaults to: gex local
+gex local [options]
+gex global [options]
+```
+
+Common options:
+
+- f, --output-format <md|json> (default: json)
+- o, --out-file <path>
+- -full-tree Include the full npm ls JSON under `tree` (default uses depth=0)
+- -omit-dev Local only; exclude devDependencies
+
+Examples:
+
+```bash
+# Local (default): JSON → stdout or to default file if -f provided without -o
+gex                  # same as: gex local
+gex -f md -o report.md
+
+# Local: exclude devDependencies
+gex local --omit-dev -f json -o deps.json
+
+# Global packages
+gex global -f md -o global.md
+```
+
+## JSON schema (summary)
+
+Top-level keys:
+
+- report_version, timestamp, tool_version
+- project_name, project_version (omitted for global reports)
+- global_packages: Array<{ name, version, resolved_path }>
+- local_dependencies: Array<{ name, version, resolved_path }>
+- local_dev_dependencies: Array<{ name, version, resolved_path }>
+- tree: raw `npm ls --json` output (when --full-tree)
+
+Example (truncated):
+
+```json
+{
+  "report_version": "1.0",
+  "timestamp": "2025-01-01T12:00:00.000Z",
+  "tool_version": "0.1.0",
+  "project_name": "my-app",
+  "project_version": "1.2.3",
+  "global_packages": [],
+  "local_dependencies": [
+    {
+      "name": "commander",
+      "version": "12.1.0",
+      "resolved_path": "/path/to/project/node_modules/commander"
+    }
+  ],
+  "local_dev_dependencies": [
+    {
+      "name": "vitest",
+      "version": "2.1.1",
+      "resolved_path": "/path/to/project/node_modules/vitest"
+    }
+  ]
+}
+```
+
+## Production usage
+
+- Deterministic output: packages are sorted by name; default uses depth=0 for fast, stable runs.
+- Exit codes: returns 0 on success; non-zero on fatal errors (e.g., npm not found, unreadable output).
+- npm behavior: npm ls may exit non-zero but still produce JSON; GEX parses stdout when available.
+- Paths: resolved_path is best-effort from npm and environment (uses `npm root -g` for global discovery).
+
+CI/CD examples:
+
+- Using npx (no global install):
+
+```bash
+npx -y @yabasha/gex@latest -f json -o gex-report.json
+```
+
+- GitHub Actions step snippet:
+
+```yaml
+- name: Generate dependency report
+  run: npx -y @yabasha/gex@latest -f json -o gex-report.json
+```
+
+## Development (repo)
+
+```bash
+npm i
+npm run build
+npm test
+npm run dev      # watch + shows CLI help on success
+npm run lint
+```

package/dist/cli.cjs

@@ -0,0 +1,366 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/cli.ts
+var cli_exports = {};
+__export(cli_exports, {
+  run: () => run
+});
+module.exports = __toCommonJS(cli_exports);
+var import_promises2 = require("fs/promises");
+var import_node_path2 = __toESM(require("path"), 1);
+var import_node_url = require("url");
+var import_commander = require("commander");
+
+// src/npm.ts
+var import_node_child_process = require("child_process");
+var import_node_util = require("util");
+var execFileAsync = (0, import_node_util.promisify)(import_node_child_process.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 { 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 {
+      }
+    }
+    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 npmRootGlobal() {
+  try {
+    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}`);
+  }
+}
+
+// src/transform.ts
+var import_node_path = __toESM(require("path"), 1);
+var import_promises = require("fs/promises");
+function toPkgArray(obj) {
+  if (!obj) return [];
+  return Object.keys(obj).map((name) => ({ name, node: obj[name] })).filter((p) => p && p.node);
+}
+async function buildReportFromNpmTree(tree, opts) {
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+  const report = {
+    report_version: "1.0",
+    timestamp,
+    tool_version: opts.toolVersion,
+    global_packages: [],
+    local_dependencies: [],
+    local_dev_dependencies: []
+  };
+  if (opts.context === "local") {
+    let pkgMeta = null;
+    try {
+      const pkgJsonPath = import_node_path.default.join(opts.cwd || process.cwd(), "package.json");
+      const raw = await (0, import_promises.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 version = node && node.version || "";
+      const resolvedPath = node && node.path || import_node_path.default.join(opts.cwd || process.cwd(), "node_modules", name);
+      const pkg = { name, version, resolved_path: resolvedPath };
+      if (devKeys.has(name)) {
+        report.local_dev_dependencies.push(pkg);
+      } else {
+        report.local_dependencies.push(pkg);
+      }
+    }
+    report.local_dependencies.sort((a, b) => a.name.localeCompare(b.name));
+    report.local_dev_dependencies.sort((a, b) => a.name.localeCompare(b.name));
+  } else if (opts.context === "global") {
+    const depsObj = tree?.dependencies;
+    const items = toPkgArray(depsObj);
+    for (const { name, node } of items) {
+      const version = node && node.version || "";
+      const resolvedPath = node && node.path || import_node_path.default.join(opts.globalRoot || "", name);
+      const pkg = { name, version, resolved_path: resolvedPath };
+      report.global_packages.push(pkg);
+    }
+    report.global_packages.sort((a, b) => a.name.localeCompare(b.name));
+  }
+  if (opts.includeTree) {
+    report.tree = tree;
+  }
+  return report;
+}
+
+// src/report/json.ts
+function renderJson(report) {
+  const r = {
+    ...report,
+    global_packages: [...report.global_packages].sort((a, b) => a.name.localeCompare(b.name)),
+    local_dependencies: [...report.local_dependencies].sort((a, b) => a.name.localeCompare(b.name)),
+    local_dev_dependencies: [...report.local_dev_dependencies].sort(
+      (a, b) => a.name.localeCompare(b.name)
+    )
+  };
+  return JSON.stringify(r, null, 2);
+}
+
+// src/report/md.ts
+function table(headers, rows) {
+  const header = `| ${headers.join(" | ")} |`;
+  const sep = `| ${headers.map(() => "---").join(" | ")} |`;
+  const body = rows.map((r) => `| ${r.join(" | ")} |`).join("\n");
+  return [header, sep, body].filter(Boolean).join("\n");
+}
+function renderMarkdown(report) {
+  const lines = [];
+  lines.push("# GEX Report");
+  lines.push("");
+  if (report.project_name || report.project_version) {
+    lines.push("## Project Metadata");
+    if (report.project_name) lines.push(`- Name: ${report.project_name}`);
+    if (report.project_version) lines.push(`- Version: ${report.project_version}`);
+    if (report.project_description)
+      lines.push(`- Description: ${report.project_description}`);
+    if (report.project_homepage)
+      lines.push(`- Homepage: ${report.project_homepage}`);
+    if (report.project_bugs) lines.push(`- Bugs: ${report.project_bugs}`);
+    lines.push("");
+  }
+  if (report.global_packages.length > 0) {
+    lines.push("## Global Packages");
+    const rows = report.global_packages.map((p) => [p.name, p.version || "", p.resolved_path || ""]);
+    lines.push(table(["Name", "Version", "Path"], rows));
+    lines.push("");
+  }
+  if (report.local_dependencies.length > 0) {
+    lines.push("## Local Dependencies");
+    const rows = report.local_dependencies.map((p) => [
+      p.name,
+      p.version || "",
+      p.resolved_path || ""
+    ]);
+    lines.push(table(["Name", "Version", "Path"], rows));
+    lines.push("");
+  }
+  if (report.local_dev_dependencies.length > 0) {
+    lines.push("## Local Dev Dependencies");
+    const rows = report.local_dev_dependencies.map((p) => [
+      p.name,
+      p.version || "",
+      p.resolved_path || ""
+    ]);
+    lines.push(table(["Name", "Version", "Path"], rows));
+    lines.push("");
+  }
+  lines.push("---");
+  lines.push("_Generated by GEX_");
+  return lines.join("\n");
+}
+
+// src/cli.ts
+var import_meta = {};
+function getPkgJsonPath() {
+  try {
+    const __filename = (0, import_node_url.fileURLToPath)(import_meta.url);
+    const __dirnameLocal = import_node_path2.default.dirname(__filename);
+    return import_node_path2.default.resolve(__dirnameLocal, "..", "package.json");
+  } catch {
+    const dir = typeof __dirname !== "undefined" ? __dirname : process.cwd();
+    return import_node_path2.default.resolve(dir, "..", "package.json");
+  }
+}
+async function getToolVersion() {
+  try {
+    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
+`;
+async function produceReport(ctx, options) {
+  const toolVersion = await getToolVersion();
+  const depth0 = !options.fullTree;
+  const cwd = options.cwd || process.cwd();
+  const tree = await npmLs({
+    global: ctx === "global",
+    omitDev: ctx === "local" ? Boolean(options.omitDev) : false,
+    depth0,
+    cwd
+  });
+  let project_description;
+  let project_homepage;
+  let project_bugs;
+  if (ctx === "local") {
+    try {
+      const pkgRaw = await (0, import_promises2.readFile)(import_node_path2.default.join(cwd, "package.json"), "utf8");
+      const pkg = JSON.parse(pkgRaw);
+      project_description = pkg.description;
+      project_homepage = pkg.homepage;
+      if (typeof pkg.bugs === "string") project_bugs = pkg.bugs;
+      else if (pkg.bugs && typeof pkg.bugs.url === "string") project_bugs = pkg.bugs.url;
+    } catch {
+    }
+  }
+  const globalRoot = ctx === "global" ? await npmRootGlobal().catch(() => void 0) : void 0;
+  const report = await buildReportFromNpmTree(tree, {
+    context: ctx,
+    includeTree: Boolean(options.fullTree),
+    omitDev: Boolean(options.omitDev),
+    cwd,
+    toolVersion,
+    globalRoot
+  });
+  const markdownExtras = { project_description, project_homepage, project_bugs };
+  return { report, markdownExtras };
+}
+async function outputReport(report, format, outFile, markdownExtras) {
+  const content = format === "json" ? renderJson(report) : renderMarkdown({ ...report, ...markdownExtras || {} });
+  if (outFile) {
+    const outDir = import_node_path2.default.dirname(outFile);
+    await (await import("fs/promises")).mkdir(outDir, { recursive: true });
+    await (await import("fs/promises")).writeFile(outFile, content, "utf8");
+    console.log(`Wrote report to ${outFile}`);
+  } else {
+    console.log(content);
+  }
+}
+async function run(argv = process.argv) {
+  const program = new import_commander.Command().name("gex").description("GEX: Dependency auditing and documentation for Node.js (local and global).").version(await getToolVersion());
+  program.addHelpText("beforeAll", `
+${ASCII_BANNER}`);
+  const addCommonOptions = (cmd, { allowOmitDev }) => {
+    cmd.option(
+      "-f, --output-format <format>",
+      "Output format: md or json",
+      (val) => val === "md" ? "md" : "json",
+      "json"
+    ).option("-o, --out-file <path>", "Write report to file").option("--full-tree", "Include full npm ls tree (omit depth=0 default)", false);
+    if (allowOmitDev) {
+      cmd.option("--omit-dev", "Exclude devDependencies (local only)", false);
+    }
+    return cmd;
+  };
+  addCommonOptions(program, { allowOmitDev: true });
+  program.action(async (opts) => {
+    const outputFormat = opts.outputFormat ?? "json";
+    const outFile = opts.outFile;
+    const fullTree = Boolean(opts.fullTree);
+    const omitDev = Boolean(opts.omitDev);
+    let finalOutFile = outFile;
+    if (!outFile && opts.outputFormat && typeof opts.outputFormat === "string") {
+      finalOutFile = `gex-report.${outputFormat}`;
+    }
+    const { report, markdownExtras } = await produceReport("local", {
+      outputFormat,
+      outFile: finalOutFile,
+      fullTree,
+      omitDev
+    });
+    await outputReport(report, outputFormat, finalOutFile, markdownExtras);
+  });
+  const localCmd = program.command("local").description("Generate a report for the current project's dependencies");
+  addCommonOptions(localCmd, { allowOmitDev: true });
+  localCmd.action(async (opts) => {
+    const outputFormat = opts.outputFormat ?? "json";
+    const outFile = opts.outFile;
+    const fullTree = Boolean(opts.fullTree);
+    const omitDev = Boolean(opts.omitDev);
+    let finalOutFile = outFile;
+    if (!outFile && opts.outputFormat && typeof opts.outputFormat === "string") {
+      finalOutFile = `gex-report.${outputFormat}`;
+    }
+    const { report, markdownExtras } = await produceReport("local", {
+      outputFormat,
+      outFile: finalOutFile,
+      fullTree,
+      omitDev
+    });
+    await outputReport(report, outputFormat, finalOutFile, markdownExtras);
+  });
+  const globalCmd = program.command("global").description("Generate a report of globally installed packages");
+  addCommonOptions(globalCmd, { allowOmitDev: false });
+  globalCmd.action(async (opts) => {
+    const outputFormat = opts.outputFormat ?? "json";
+    const outFile = opts.outFile;
+    const fullTree = Boolean(opts.fullTree);
+    let finalOutFile = outFile;
+    if (!outFile && opts.outputFormat && typeof opts.outputFormat === "string") {
+      finalOutFile = `gex-report.${outputFormat}`;
+    }
+    const { report, markdownExtras } = await produceReport("global", {
+      outputFormat,
+      outFile: finalOutFile,
+      fullTree
+    });
+    await outputReport(report, outputFormat, finalOutFile, markdownExtras);
+  });
+  await program.parseAsync(argv);
+}
+var isCjsMain = typeof require !== "undefined" && require.main === module;
+var isEsmMain = typeof import_meta !== "undefined" && import_meta.url === `file://${process.argv[1]}`;
+if (isCjsMain || isEsmMain) {
+  run();
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  run
+});
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts","../src/npm.ts","../src/transform.ts","../src/report/json.ts","../src/report/md.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises'\nimport path from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nimport { Command } from 'commander'\n\nimport { npmLs, npmRootGlobal } from './npm.js'\nimport { buildReportFromNpmTree } from './transform.js'\nimport { renderJson } from './report/json.js'\nimport { renderMarkdown } from './report/md.js'\nimport type { OutputFormat, Report } from './types.js'\n\nfunction getPkgJsonPath(): string {\n  // Resolve package.json relative to this file for both ESM and CJS bundles\n  try {\n    const __filename = fileURLToPath((import.meta as any).url)\n    const __dirnameLocal = path.dirname(__filename)\n    return path.resolve(__dirnameLocal, '..', 'package.json')\n  } catch {\n    const dir = typeof __dirname !== 'undefined' ? __dirname : process.cwd()\n    return path.resolve(dir, '..', 'package.json')\n  }\n}\n\nasync 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\nconst ASCII_BANNER = String.raw`\n  ________                __\n /  _____/  ____   _____/  |_  ____   ____ \n/   \\  ___ /  _ \\ /  _ \\   __\\/ __ \\ /    \\\n\\    \\_\\  (  <_> |  <_> )  | \\  ___/|   |  \\\n \\______  /\\____/ \\____/|__|  \\___  >___|  /\n        \\/                         \\/     \\/ \n                      GEX\n`\n\nasync function produceReport(\n  ctx: 'local' | 'global',\n  options: {\n    outputFormat: OutputFormat\n    outFile?: string\n    fullTree?: boolean\n    omitDev?: boolean\n    cwd?: string\n  },\n): Promise<{ report: Report; markdownExtras?: any }> {\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  // Get extra metadata for markdown rendering when local\n  let project_description: string | undefined\n  let project_homepage: string | undefined\n  let project_bugs: string | undefined\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\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\nasync function outputReport(\n  report: Report,\n  format: OutputFormat,\n  outFile?: string,\n  markdownExtras?: any,\n) {\n  const content =\n    format === 'json'\n      ? renderJson(report)\n      : renderMarkdown({ ...report, ...(markdownExtras || {}) })\n  if (outFile) {\n    const outDir = path.dirname(outFile)\n    await (await import('node:fs/promises')).mkdir(outDir, { recursive: true })\n    await (await import('node:fs/promises')).writeFile(outFile, content, 'utf8')\n     \n    console.log(`Wrote report to ${outFile}`)\n  } else {\n     \n    console.log(content)\n  }\n}\n\nexport async function run(argv = process.argv) {\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  const addCommonOptions = (cmd: Command, { allowOmitDev }: { allowOmitDev: boolean }) => {\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    if (allowOmitDev) {\n      cmd.option('--omit-dev', 'Exclude devDependencies (local only)', false)\n    }\n    return cmd\n  }\n\n  // Root behaves like `local` by default\n  addCommonOptions(program as unknown as Command, { allowOmitDev: true })\n  program.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    let finalOutFile = outFile\n    if (!outFile && opts.outputFormat && typeof opts.outputFormat === 'string') {\n      finalOutFile = `gex-report.${outputFormat}`\n    }\n\n    const { report, markdownExtras } = await produceReport('local', {\n      outputFormat,\n      outFile: finalOutFile,\n      fullTree,\n      omitDev,\n    })\n    await outputReport(report, outputFormat, finalOutFile, markdownExtras)\n  })\n\n  // gex local\n  const localCmd = program\n    .command('local')\n    .description(\"Generate a report for the current project's dependencies\")\n  addCommonOptions(localCmd, { allowOmitDev: true })\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    let finalOutFile = outFile\n    if (!outFile && opts.outputFormat && typeof opts.outputFormat === 'string') {\n      finalOutFile = `gex-report.${outputFormat}`\n    }\n\n    const { report, markdownExtras } = await produceReport('local', {\n      outputFormat,\n      outFile: finalOutFile,\n      fullTree,\n      omitDev,\n    })\n    await outputReport(report, outputFormat, finalOutFile, markdownExtras)\n  })\n\n  // gex global\n  const globalCmd = program\n    .command('global')\n    .description('Generate a report of globally installed packages')\n  addCommonOptions(globalCmd, { allowOmitDev: false })\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    let finalOutFile = outFile\n    if (!outFile && opts.outputFormat && typeof opts.outputFormat === 'string') {\n      finalOutFile = `gex-report.${outputFormat}`\n    }\n\n    const { report, markdownExtras } = await produceReport('global', {\n      outputFormat,\n      outFile: finalOutFile,\n      fullTree,\n    })\n    await outputReport(report, outputFormat, finalOutFile, markdownExtras)\n  })\n\n  await program.parseAsync(argv)\n}\n\nconst isCjsMain = typeof require !== 'undefined' && (require as any).main === module\nconst isEsmMain =\n  typeof import.meta !== 'undefined' && (import.meta as any).url === `file://${process.argv[1]}`\nif (isCjsMain || isEsmMain) {\n  run()\n}\n","import { execFile } from 'node:child_process'\nimport { promisify } from 'node:util'\n\nconst execFileAsync = promisify(execFile)\n\nexport type NpmLsOptions = {\n  global?: boolean\n  omitDev?: boolean\n  depth0?: boolean\n  cwd?: string\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 { 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 {\n        // fallthrough\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\nexport async function npmRootGlobal(): Promise<string> {\n  try {\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","import path from 'node:path'\nimport { readFile } from 'node:fs/promises'\n\nimport type { PackageInfo, Report } from './types.js'\n\nexport type NormalizeOptions = {\n  context: 'local' | 'global'\n  includeTree?: boolean\n  omitDev?: boolean\n  cwd?: string\n  toolVersion: string\n  globalRoot?: string\n}\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\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; project metadata optional\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 items = toPkgArray(depsObj)\n    const devKeys = new Set(Object.keys((pkgMeta?.devDependencies as Record<string, string>) || {}))\n\n    for (const { name, node } of items) {\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 (devKeys.has(name)) {\n        // Only categorize as dev if present in the tree; with --omit-dev they won't appear\n        report.local_dev_dependencies.push(pkg)\n      } else {\n        report.local_dependencies.push(pkg)\n      }\n    }\n\n    // sort\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","import type { Report } from '../types.js'\n\nexport function renderJson(report: Report): string {\n  // Ensure stable ordering (defensive; arrays already sorted)\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","import type { Report } from '../types.js'\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\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 (report.project_name || report.project_version) {\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"],"mappings":"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","names":["import_promises","import_node_path","path","path"]}

package/dist/cli.mjs

@@ -0,0 +1,337 @@
+#!/usr/bin/env node
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/cli.ts
+import { readFile as readFile2 } from "fs/promises";
+import path2 from "path";
+import { fileURLToPath } from "url";
+import { Command } from "commander";
+
+// src/npm.ts
+import { execFile } from "child_process";
+import { promisify } from "util";
+var execFileAsync = 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 { 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 {
+      }
+    }
+    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 npmRootGlobal() {
+  try {
+    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}`);
+  }
+}
+
+// src/transform.ts
+import path from "path";
+import { readFile } from "fs/promises";
+function toPkgArray(obj) {
+  if (!obj) return [];
+  return Object.keys(obj).map((name) => ({ name, node: obj[name] })).filter((p) => p && p.node);
+}
+async function buildReportFromNpmTree(tree, opts) {
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+  const report = {
+    report_version: "1.0",
+    timestamp,
+    tool_version: opts.toolVersion,
+    global_packages: [],
+    local_dependencies: [],
+    local_dev_dependencies: []
+  };
+  if (opts.context === "local") {
+    let pkgMeta = null;
+    try {
+      const pkgJsonPath = path.join(opts.cwd || process.cwd(), "package.json");
+      const raw = await 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 version = node && node.version || "";
+      const resolvedPath = node && node.path || path.join(opts.cwd || process.cwd(), "node_modules", name);
+      const pkg = { name, version, resolved_path: resolvedPath };
+      if (devKeys.has(name)) {
+        report.local_dev_dependencies.push(pkg);
+      } else {
+        report.local_dependencies.push(pkg);
+      }
+    }
+    report.local_dependencies.sort((a, b) => a.name.localeCompare(b.name));
+    report.local_dev_dependencies.sort((a, b) => a.name.localeCompare(b.name));
+  } else if (opts.context === "global") {
+    const depsObj = tree?.dependencies;
+    const items = toPkgArray(depsObj);
+    for (const { name, node } of items) {
+      const version = node && node.version || "";
+      const resolvedPath = node && node.path || path.join(opts.globalRoot || "", name);
+      const pkg = { name, version, resolved_path: resolvedPath };
+      report.global_packages.push(pkg);
+    }
+    report.global_packages.sort((a, b) => a.name.localeCompare(b.name));
+  }
+  if (opts.includeTree) {
+    report.tree = tree;
+  }
+  return report;
+}
+
+// src/report/json.ts
+function renderJson(report) {
+  const r = {
+    ...report,
+    global_packages: [...report.global_packages].sort((a, b) => a.name.localeCompare(b.name)),
+    local_dependencies: [...report.local_dependencies].sort((a, b) => a.name.localeCompare(b.name)),
+    local_dev_dependencies: [...report.local_dev_dependencies].sort(
+      (a, b) => a.name.localeCompare(b.name)
+    )
+  };
+  return JSON.stringify(r, null, 2);
+}
+
+// src/report/md.ts
+function table(headers, rows) {
+  const header = `| ${headers.join(" | ")} |`;
+  const sep = `| ${headers.map(() => "---").join(" | ")} |`;
+  const body = rows.map((r) => `| ${r.join(" | ")} |`).join("\n");
+  return [header, sep, body].filter(Boolean).join("\n");
+}
+function renderMarkdown(report) {
+  const lines = [];
+  lines.push("# GEX Report");
+  lines.push("");
+  if (report.project_name || report.project_version) {
+    lines.push("## Project Metadata");
+    if (report.project_name) lines.push(`- Name: ${report.project_name}`);
+    if (report.project_version) lines.push(`- Version: ${report.project_version}`);
+    if (report.project_description)
+      lines.push(`- Description: ${report.project_description}`);
+    if (report.project_homepage)
+      lines.push(`- Homepage: ${report.project_homepage}`);
+    if (report.project_bugs) lines.push(`- Bugs: ${report.project_bugs}`);
+    lines.push("");
+  }
+  if (report.global_packages.length > 0) {
+    lines.push("## Global Packages");
+    const rows = report.global_packages.map((p) => [p.name, p.version || "", p.resolved_path || ""]);
+    lines.push(table(["Name", "Version", "Path"], rows));
+    lines.push("");
+  }
+  if (report.local_dependencies.length > 0) {
+    lines.push("## Local Dependencies");
+    const rows = report.local_dependencies.map((p) => [
+      p.name,
+      p.version || "",
+      p.resolved_path || ""
+    ]);
+    lines.push(table(["Name", "Version", "Path"], rows));
+    lines.push("");
+  }
+  if (report.local_dev_dependencies.length > 0) {
+    lines.push("## Local Dev Dependencies");
+    const rows = report.local_dev_dependencies.map((p) => [
+      p.name,
+      p.version || "",
+      p.resolved_path || ""
+    ]);
+    lines.push(table(["Name", "Version", "Path"], rows));
+    lines.push("");
+  }
+  lines.push("---");
+  lines.push("_Generated by GEX_");
+  return lines.join("\n");
+}
+
+// src/cli.ts
+function getPkgJsonPath() {
+  try {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirnameLocal = path2.dirname(__filename);
+    return path2.resolve(__dirnameLocal, "..", "package.json");
+  } catch {
+    const dir = typeof __dirname !== "undefined" ? __dirname : process.cwd();
+    return path2.resolve(dir, "..", "package.json");
+  }
+}
+async function getToolVersion() {
+  try {
+    const pkgPath = getPkgJsonPath();
+    const raw = await readFile2(pkgPath, "utf8");
+    const pkg = JSON.parse(raw);
+    return pkg.version || "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
+var ASCII_BANNER = String.raw`
+  ________                __
+ /  _____/  ____   _____/  |_  ____   ____ 
+/   \  ___ /  _ \ /  _ \   __\/ __ \ /    \
+\    \_\  (  <_> |  <_> )  | \  ___/|   |  \
+ \______  /\____/ \____/|__|  \___  >___|  /
+        \/                         \/     \/ 
+                      GEX
+`;
+async function produceReport(ctx, options) {
+  const toolVersion = await getToolVersion();
+  const depth0 = !options.fullTree;
+  const cwd = options.cwd || process.cwd();
+  const tree = await npmLs({
+    global: ctx === "global",
+    omitDev: ctx === "local" ? Boolean(options.omitDev) : false,
+    depth0,
+    cwd
+  });
+  let project_description;
+  let project_homepage;
+  let project_bugs;
+  if (ctx === "local") {
+    try {
+      const pkgRaw = await readFile2(path2.join(cwd, "package.json"), "utf8");
+      const pkg = JSON.parse(pkgRaw);
+      project_description = pkg.description;
+      project_homepage = pkg.homepage;
+      if (typeof pkg.bugs === "string") project_bugs = pkg.bugs;
+      else if (pkg.bugs && typeof pkg.bugs.url === "string") project_bugs = pkg.bugs.url;
+    } catch {
+    }
+  }
+  const globalRoot = ctx === "global" ? await npmRootGlobal().catch(() => void 0) : void 0;
+  const report = await buildReportFromNpmTree(tree, {
+    context: ctx,
+    includeTree: Boolean(options.fullTree),
+    omitDev: Boolean(options.omitDev),
+    cwd,
+    toolVersion,
+    globalRoot
+  });
+  const markdownExtras = { project_description, project_homepage, project_bugs };
+  return { report, markdownExtras };
+}
+async function outputReport(report, format, outFile, markdownExtras) {
+  const content = format === "json" ? renderJson(report) : renderMarkdown({ ...report, ...markdownExtras || {} });
+  if (outFile) {
+    const outDir = path2.dirname(outFile);
+    await (await import("fs/promises")).mkdir(outDir, { recursive: true });
+    await (await import("fs/promises")).writeFile(outFile, content, "utf8");
+    console.log(`Wrote report to ${outFile}`);
+  } else {
+    console.log(content);
+  }
+}
+async function run(argv = process.argv) {
+  const program = new Command().name("gex").description("GEX: Dependency auditing and documentation for Node.js (local and global).").version(await getToolVersion());
+  program.addHelpText("beforeAll", `
+${ASCII_BANNER}`);
+  const addCommonOptions = (cmd, { allowOmitDev }) => {
+    cmd.option(
+      "-f, --output-format <format>",
+      "Output format: md or json",
+      (val) => val === "md" ? "md" : "json",
+      "json"
+    ).option("-o, --out-file <path>", "Write report to file").option("--full-tree", "Include full npm ls tree (omit depth=0 default)", false);
+    if (allowOmitDev) {
+      cmd.option("--omit-dev", "Exclude devDependencies (local only)", false);
+    }
+    return cmd;
+  };
+  addCommonOptions(program, { allowOmitDev: true });
+  program.action(async (opts) => {
+    const outputFormat = opts.outputFormat ?? "json";
+    const outFile = opts.outFile;
+    const fullTree = Boolean(opts.fullTree);
+    const omitDev = Boolean(opts.omitDev);
+    let finalOutFile = outFile;
+    if (!outFile && opts.outputFormat && typeof opts.outputFormat === "string") {
+      finalOutFile = `gex-report.${outputFormat}`;
+    }
+    const { report, markdownExtras } = await produceReport("local", {
+      outputFormat,
+      outFile: finalOutFile,
+      fullTree,
+      omitDev
+    });
+    await outputReport(report, outputFormat, finalOutFile, markdownExtras);
+  });
+  const localCmd = program.command("local").description("Generate a report for the current project's dependencies");
+  addCommonOptions(localCmd, { allowOmitDev: true });
+  localCmd.action(async (opts) => {
+    const outputFormat = opts.outputFormat ?? "json";
+    const outFile = opts.outFile;
+    const fullTree = Boolean(opts.fullTree);
+    const omitDev = Boolean(opts.omitDev);
+    let finalOutFile = outFile;
+    if (!outFile && opts.outputFormat && typeof opts.outputFormat === "string") {
+      finalOutFile = `gex-report.${outputFormat}`;
+    }
+    const { report, markdownExtras } = await produceReport("local", {
+      outputFormat,
+      outFile: finalOutFile,
+      fullTree,
+      omitDev
+    });
+    await outputReport(report, outputFormat, finalOutFile, markdownExtras);
+  });
+  const globalCmd = program.command("global").description("Generate a report of globally installed packages");
+  addCommonOptions(globalCmd, { allowOmitDev: false });
+  globalCmd.action(async (opts) => {
+    const outputFormat = opts.outputFormat ?? "json";
+    const outFile = opts.outFile;
+    const fullTree = Boolean(opts.fullTree);
+    let finalOutFile = outFile;
+    if (!outFile && opts.outputFormat && typeof opts.outputFormat === "string") {
+      finalOutFile = `gex-report.${outputFormat}`;
+    }
+    const { report, markdownExtras } = await produceReport("global", {
+      outputFormat,
+      outFile: finalOutFile,
+      fullTree
+    });
+    await outputReport(report, outputFormat, finalOutFile, markdownExtras);
+  });
+  await program.parseAsync(argv);
+}
+var isCjsMain = typeof __require !== "undefined" && __require.main === module;
+var isEsmMain = typeof import.meta !== "undefined" && import.meta.url === `file://${process.argv[1]}`;
+if (isCjsMain || isEsmMain) {
+  run();
+}
+export {
+  run
+};
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts","../src/npm.ts","../src/transform.ts","../src/report/json.ts","../src/report/md.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises'\nimport path from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nimport { Command } from 'commander'\n\nimport { npmLs, npmRootGlobal } from './npm.js'\nimport { buildReportFromNpmTree } from './transform.js'\nimport { renderJson } from './report/json.js'\nimport { renderMarkdown } from './report/md.js'\nimport type { OutputFormat, Report } from './types.js'\n\nfunction getPkgJsonPath(): string {\n  // Resolve package.json relative to this file for both ESM and CJS bundles\n  try {\n    const __filename = fileURLToPath((import.meta as any).url)\n    const __dirnameLocal = path.dirname(__filename)\n    return path.resolve(__dirnameLocal, '..', 'package.json')\n  } catch {\n    const dir = typeof __dirname !== 'undefined' ? __dirname : process.cwd()\n    return path.resolve(dir, '..', 'package.json')\n  }\n}\n\nasync 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\nconst ASCII_BANNER = String.raw`\n  ________                __\n /  _____/  ____   _____/  |_  ____   ____ \n/   \\  ___ /  _ \\ /  _ \\   __\\/ __ \\ /    \\\n\\    \\_\\  (  <_> |  <_> )  | \\  ___/|   |  \\\n \\______  /\\____/ \\____/|__|  \\___  >___|  /\n        \\/                         \\/     \\/ \n                      GEX\n`\n\nasync function produceReport(\n  ctx: 'local' | 'global',\n  options: {\n    outputFormat: OutputFormat\n    outFile?: string\n    fullTree?: boolean\n    omitDev?: boolean\n    cwd?: string\n  },\n): Promise<{ report: Report; markdownExtras?: any }> {\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  // Get extra metadata for markdown rendering when local\n  let project_description: string | undefined\n  let project_homepage: string | undefined\n  let project_bugs: string | undefined\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\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\nasync function outputReport(\n  report: Report,\n  format: OutputFormat,\n  outFile?: string,\n  markdownExtras?: any,\n) {\n  const content =\n    format === 'json'\n      ? renderJson(report)\n      : renderMarkdown({ ...report, ...(markdownExtras || {}) })\n  if (outFile) {\n    const outDir = path.dirname(outFile)\n    await (await import('node:fs/promises')).mkdir(outDir, { recursive: true })\n    await (await import('node:fs/promises')).writeFile(outFile, content, 'utf8')\n     \n    console.log(`Wrote report to ${outFile}`)\n  } else {\n     \n    console.log(content)\n  }\n}\n\nexport async function run(argv = process.argv) {\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  const addCommonOptions = (cmd: Command, { allowOmitDev }: { allowOmitDev: boolean }) => {\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    if (allowOmitDev) {\n      cmd.option('--omit-dev', 'Exclude devDependencies (local only)', false)\n    }\n    return cmd\n  }\n\n  // Root behaves like `local` by default\n  addCommonOptions(program as unknown as Command, { allowOmitDev: true })\n  program.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    let finalOutFile = outFile\n    if (!outFile && opts.outputFormat && typeof opts.outputFormat === 'string') {\n      finalOutFile = `gex-report.${outputFormat}`\n    }\n\n    const { report, markdownExtras } = await produceReport('local', {\n      outputFormat,\n      outFile: finalOutFile,\n      fullTree,\n      omitDev,\n    })\n    await outputReport(report, outputFormat, finalOutFile, markdownExtras)\n  })\n\n  // gex local\n  const localCmd = program\n    .command('local')\n    .description(\"Generate a report for the current project's dependencies\")\n  addCommonOptions(localCmd, { allowOmitDev: true })\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    let finalOutFile = outFile\n    if (!outFile && opts.outputFormat && typeof opts.outputFormat === 'string') {\n      finalOutFile = `gex-report.${outputFormat}`\n    }\n\n    const { report, markdownExtras } = await produceReport('local', {\n      outputFormat,\n      outFile: finalOutFile,\n      fullTree,\n      omitDev,\n    })\n    await outputReport(report, outputFormat, finalOutFile, markdownExtras)\n  })\n\n  // gex global\n  const globalCmd = program\n    .command('global')\n    .description('Generate a report of globally installed packages')\n  addCommonOptions(globalCmd, { allowOmitDev: false })\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    let finalOutFile = outFile\n    if (!outFile && opts.outputFormat && typeof opts.outputFormat === 'string') {\n      finalOutFile = `gex-report.${outputFormat}`\n    }\n\n    const { report, markdownExtras } = await produceReport('global', {\n      outputFormat,\n      outFile: finalOutFile,\n      fullTree,\n    })\n    await outputReport(report, outputFormat, finalOutFile, markdownExtras)\n  })\n\n  await program.parseAsync(argv)\n}\n\nconst isCjsMain = typeof require !== 'undefined' && (require as any).main === module\nconst isEsmMain =\n  typeof import.meta !== 'undefined' && (import.meta as any).url === `file://${process.argv[1]}`\nif (isCjsMain || isEsmMain) {\n  run()\n}\n","import { execFile } from 'node:child_process'\nimport { promisify } from 'node:util'\n\nconst execFileAsync = promisify(execFile)\n\nexport type NpmLsOptions = {\n  global?: boolean\n  omitDev?: boolean\n  depth0?: boolean\n  cwd?: string\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 { 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 {\n        // fallthrough\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\nexport async function npmRootGlobal(): Promise<string> {\n  try {\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","import path from 'node:path'\nimport { readFile } from 'node:fs/promises'\n\nimport type { PackageInfo, Report } from './types.js'\n\nexport type NormalizeOptions = {\n  context: 'local' | 'global'\n  includeTree?: boolean\n  omitDev?: boolean\n  cwd?: string\n  toolVersion: string\n  globalRoot?: string\n}\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\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; project metadata optional\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 items = toPkgArray(depsObj)\n    const devKeys = new Set(Object.keys((pkgMeta?.devDependencies as Record<string, string>) || {}))\n\n    for (const { name, node } of items) {\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 (devKeys.has(name)) {\n        // Only categorize as dev if present in the tree; with --omit-dev they won't appear\n        report.local_dev_dependencies.push(pkg)\n      } else {\n        report.local_dependencies.push(pkg)\n      }\n    }\n\n    // sort\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","import type { Report } from '../types.js'\n\nexport function renderJson(report: Report): string {\n  // Ensure stable ordering (defensive; arrays already sorted)\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","import type { Report } from '../types.js'\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\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 (report.project_name || report.project_version) {\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"],"mappings":"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","names":["readFile","path","path","readFile"]}

package/dist/index.cjs

@@ -0,0 +1,33 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  greet: () => greet
+});
+module.exports = __toCommonJS(src_exports);
+function greet(name) {
+  return `Hello, ${name}!`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  greet
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Library API entry.\n * Export functions here for consumers who import your package.\n */\n\nexport function greet(name: string): string {\n  return `Hello, ${name}!`\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAKO,SAAS,MAAM,MAAsB;AAC1C,SAAO,UAAU,IAAI;AACvB;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,7 @@
+/**
+ * Library API entry.
+ * Export functions here for consumers who import your package.
+ */
+declare function greet(name: string): string;
+
+export { greet };

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Library API entry.
+ * Export functions here for consumers who import your package.
+ */
+declare function greet(name: string): string;
+
+export { greet };

package/dist/index.mjs

@@ -0,0 +1,8 @@
+// src/index.ts
+function greet(name) {
+  return `Hello, ${name}!`;
+}
+export {
+  greet
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Library API entry.\n * Export functions here for consumers who import your package.\n */\n\nexport function greet(name: string): string {\n  return `Hello, ${name}!`\n}\n"],"mappings":";AAKO,SAAS,MAAM,MAAsB;AAC1C,SAAO,UAAU,IAAI;AACvB;","names":[]}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@yabasha/gex",
+  "version": "0.1.0",
+  "private": false,
+  "description": "A CLI tool for auditing and documenting your Node.js package environment, generating comprehensive reports of global and local dependencies.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "bin": {
+    "gex": "./dist/cli.cjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18.18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch --onSuccess \"node dist/cli.cjs --help\"",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepare": "husky install || true",
+    "release": "changeset publish",
+    "version-pack": "npm pack"
+  },
+  "keywords": [
+    "typescript",
+    "starter",
+    "cli",
+    "library",
+    "tsup",
+    "commander"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@changesets/cli": "^2.27.8",
+    "@types/node": "^22.5.4",
+    "@typescript-eslint/eslint-plugin": "^8.6.0",
+    "@typescript-eslint/parser": "^8.6.0",
+    "eslint": "^9.9.1",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-import": "^2.30.0",
+    "husky": "^9.1.6",
+    "lint-staged": "^15.2.10",
+    "prettier": "^3.3.3",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.2",
+    "vitest": "^2.1.1"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  },
+  "lint-staged": {
+    "*.{ts,tsx,js,jsx,json,md,yml,yaml}": [
+      "prettier --write"
+    ],
+    "*.{ts,tsx,js,jsx}": [
+      "eslint --fix"
+    ]
+  }
+}