errlens 1.0.7 → 1.0.9

package/README.md

@@ -54,8 +54,32 @@ npm install -g errlens
 
 ---
 
+## ⚡ Quick Start
+
+```bash
+# Analyze an error message
+errlens analyze "TypeError: Cannot read property 'name' of undefined"
+
+# Run a script with error monitoring
+errlens run your-script.js
+
+# Get JSON output for CI/CD pipelines
+errlens analyze "is not a function" --json
+```
+
+---
+
 ## 🛠 Usage
 
+### Available Commands
+
+```bash
+errlens run <file> [--json]       # Run a script and analyze any crashes
+errlens analyze <error> [--json]  # Analyze a specific error message
+errlens --version                 # Show version information
+errlens --help                    # Show help
+```
+
 ### 1️⃣ Automatic Monitoring (The "Pro" Way)
 
 Run your script through ErrLens. If it crashes, ErrLens intercepts the error and explains the fix before the process exits.
@@ -71,7 +95,7 @@ errlens run your-app.js
 Found a weird error in your logs? Just paste the message:
 
 ```bash
-errlens "TypeError: Cannot read properties of undefined"
+errlens analyze "TypeError: Cannot read properties of undefined"
 ```
 
 ---
@@ -81,7 +105,7 @@ errlens "TypeError: Cannot read properties of undefined"
 Get machine-readable results for your own tooling or automated reports:
 
 ```bash
-errlens "is not a function" --json
+errlens analyze "is not a function" --json
 ```
 
 Run a script and write the JSON report directly to a file in CI:

package/bin/index.js

@@ -1,37 +1,41 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 const { Command } = require("commander");
 const { spawn } = require("child_process");
-
 const chalk = require("chalk");
 const path = require("path");
 const { findError } = require("../lib/matcher");
 const { formatError } = require("../lib/formatter");
-
 const { version } = require("../package.json");
+
 const program = new Command();
 
 program
   .name("errlens")
   .description("Professional JS Error Analytics")
-  .version(version);
+  .version(version)
+  .option("--json", "Output JSON instead of pretty UI"); // ✅ GLOBAL OPTION
 
 // ----------------- RUN COMMAND -----------------
 program
   .command("run <file>")
-  .option('--json', 'Output JSON instead of pretty UI')
   .description("Run a Javascript file and analyze crashes")
-  .action(async (file, options) => {
+  .action(async (file) => {
     const { default: ora } = await import("ora");
+
+    const isJson = Boolean(program.opts().json);
     const filePath = path.resolve(process.cwd(), file);
-    const isJson = Boolean(options.json);
-    const spinner = isJson ? null : ora(`Running ${chalk.yellow(file)}...`).start();
+    const spinner = isJson
+      ? null
+      : ora(`Running ${chalk.yellow(file)}...`).start();
 
-    const child = spawn(process.execPath, [filePath], { stdio: ["inherit", "pipe", "pipe"] });
+    const child = spawn(process.execPath, [filePath], {
+      stdio: ["inherit", "pipe", "pipe"],
+    });
 
     let errorOutput = "";
 
-    // Stream logs to terminal in real-time
+    // Stream stdout only in pretty mode
     child.stdout.on("data", (data) => {
       if (!isJson) {
         spinner.stop();
@@ -40,7 +44,7 @@ program
       }
     });
 
-    // Capture stderr for analysis
+    // Capture stderr (DO NOT print in JSON mode)
     child.stderr.on("data", (data) => {
       errorOutput += data.toString();
 
@@ -50,34 +54,46 @@ program
     });
 
     child.on("close", (code, signal) => {
-      if (!isJson) {
+      if (!isJson && spinner) {
         spinner.stop();
       }
 
       const { count, matches } = findError(errorOutput);
 
+      // Process killed by signal
       if (code === null) {
+        const result = { code: 1, count, matches };
+
         if (isJson) {
-          const result = { code: 1, count, matches };
           console.log(JSON.stringify(result, null, 2));
         } else {
-          console.log(chalk.red.bold(`\n⚠️ Process killed by signal: ${signal}`));
+          console.log(
+            chalk.red.bold(`\n⚠️ Process killed by signal: ${signal}`)
+          );
         }
+
         process.exit(1);
-        return;
       }
 
+      // JSON MODE
       if (isJson) {
-        const result = { code, count, matches };
-        console.log(JSON.stringify(result, null, 2));
-      } else if (code === 0) {
-          console.log(chalk.green.bold("\n✨ Process finished successfully."));
+        console.log(JSON.stringify({ code, count, matches }, null, 2));
+        process.exit(code ?? 1);
+      }
+
+      // PRETTY MODE
+      if (code === 0) {
+        console.log(chalk.green.bold("\n✨ Process finished successfully."));
       } else {
         if (count > 0) {
-          console.log(chalk.bold.cyan(`\n🚀 ErrLens Analysis (${count} Issue(s)):`));
-          matches.forEach(m => { console.log(formatError(m)); }); // Pretty UI only here
+          console.log(
+            chalk.bold.cyan(`\n🚀 ErrLens Analysis (${count} Issue(s)):`)
+          );
+          matches.forEach((m) => console.log(formatError(m)));
         } else {
-          console.log(chalk.red.bold("\n❌ Crash detected (No known fix in database):"));
+          console.log(
+            chalk.red.bold("\n❌ Crash detected (No known fix in database):")
+          );
           console.log(chalk.gray(errorOutput));
         }
       }
@@ -86,42 +102,48 @@ program
     });
 
     child.on("error", (err) => {
+      const result = { code: 1, count: 0, matches: [] };
+
       if (isJson) {
-        const result = { code: 1, count: 0, matches: [] };
         console.log(JSON.stringify(result, null, 2));
       } else {
-        spinner.fail(chalk.red(`System Error: ${err.message}`));
+        console.log(chalk.red(`System Error: ${err.message}`));
       }
+
       process.exit(1);
     });
   });
 
 // ----------------- ANALYZE COMMAND -----------------
 program
-  .arguments("<errorString>") // default command if no "run"
+  .command("analyze <errorString>")
   .description("Analyze a specific error string")
-  .option('--json', 'Output result in JSON format')
-  .action((errorString, options) => {
+  .action((errorString) => {
+    const isJson = Boolean(program.opts().json);
     const { count, matches } = findError(errorString);
     const exitCode = count > 0 ? 1 : 0;
-    const isJson = Boolean(options.json);
 
     if (isJson) {
-      console.log(JSON.stringify({ code: exitCode, count, matches }, null, 2));
+      console.log(
+        JSON.stringify({ code: exitCode, count, matches }, null, 2)
+      );
       process.exit(exitCode);
-      return;
     }
 
     if (count > 0) {
-      console.log(chalk.bold.cyan(`\n🚀 ErrLens Analysis (${count} Issue(s)):`));
-      matches.forEach(m => { console.log(formatError(m)); }); // Pretty UI
+      console.log(
+        chalk.bold.cyan(`\n🚀 ErrLens Analysis (${count} Issue(s)):`)
+      );
+      matches.forEach((m) => console.log(formatError(m)));
     } else {
-      console.log(chalk.red.bold("\n❌ Crash detected (No known fix in database):"));
+      console.log(
+        chalk.red.bold("\n❌ Crash detected (No known fix in database):")
+      );
       console.log(chalk.gray(errorString));
     }
 
     process.exit(exitCode);
   });
 
-// ----------------- PARSE ARGUMENTS -----------------
+// ----------------- PARSE -----------------
 program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "errlens",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Professional CLI tool that explains JavaScript and Node.js errors in plain English with actionable fixes directly in your terminal.",
   "main": "./bin/index.js",
   "bin": {
@@ -48,7 +48,7 @@
   },
   "dependencies": {
     "boxen": "^5.1.2",
-    "chalk": "^4.1.2",
+    "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "fuse.js": "^7.0.0",
     "ora": "^9.3.0"