nodewise 1.0.1 → 1.0.3

package/README.md

@@ -71,6 +71,9 @@ Traditional error messages can be cryptic, long, or stacked with irrelevant inte
 
 ## 📋 Example Output
 
+<img width="1836" height="694" alt="Screenshot 2026-02-15 223424" src="https://github.com/user-attachments/assets/412f60cf-5ab6-4662-8a0a-1f92145f2485" />
+
+
   ✦ GEMINI INTELLIGENCE
   ─────────────────────────────────────────────
 

package/bin/nodewise.js

@@ -26,7 +26,7 @@ function parseArgs() {
     setup: false,
     reset: false
   };
-  
+
   let scriptPath = null;
   const scriptArgs = [];
 
@@ -78,13 +78,14 @@ ${chalk.bold('MODES')}
   ${chalk.cyan('Normal Detection')}      - Pattern-based error detection (offline)
 
 ${chalk.bold('CONFIGURATION')}
-  Settings are saved in ${chalk.yellow('nodewise.config.json')} in your project root.
+  Settings are saved in ${chalk.yellow('node_modules/.nodewise.config.json')} (if available)
+  or ${chalk.yellow('.nodewise.config.json')} in your project root.
+  This ensures your API keys are not accidentally committed to version control.
 
 ${chalk.bold('DOCUMENTATION')}
   https://github.com/yourusername/nodewise
   `);
 }
-
 /**
  * Display version
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nodewise",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Node.js error explainer with AI-powered clarity",
   "main": "src/index.js",
   "type": "commonjs",
@@ -22,10 +22,10 @@
   "author": "Gourab Das",
   "license": "MIT",
   "dependencies": {
-    "inquirer": "^9.2.15",
     "axios": "^1.6.5",
+    "chalk": "^4.1.2",
     "chokidar": "^3.5.3",
-    "chalk": "^4.1.2"
+    "inquirer": "^9.2.15"
   },
   "files": [
     "bin",
@@ -44,7 +44,6 @@
     "url": "https://github.com/Gourab2005/nodewise/issues"
   },
   "homepage": "https://github.com/Gourab2005/nodewise#readme",
-  "devDependencies": {},
   "engines": {
     "node": ">=18.0.0"
   }

package/src/config.js

@@ -9,13 +9,47 @@ const fs = require('fs');
 const path = require('path');
 
 const CONFIG_FILE = 'nodewise.config.json';
+const HIDDEN_CONFIG_FILE = '.nodewise.config.json';
 
 /**
  * Get the configuration file path
- * Looks in current working directory
+ * Prioritizes node_modules to avoid accidental git commits
  */
 function getConfigPath() {
-  return path.join(process.cwd(), CONFIG_FILE);
+  const cwd = process.cwd();
+  const nodeModulesPath = path.join(cwd, 'node_modules');
+  const nodeModulesConfig = path.join(nodeModulesPath, HIDDEN_CONFIG_FILE);
+  const rootHiddenConfig = path.join(cwd, HIDDEN_CONFIG_FILE);
+  const rootLegacyConfig = path.join(cwd, CONFIG_FILE);
+
+  // 1. Check if config already exists in node_modules
+  if (fs.existsSync(nodeModulesConfig)) {
+    return nodeModulesConfig;
+  }
+
+  // 2. Check if hidden config exists in root
+  if (fs.existsSync(rootHiddenConfig)) {
+    return rootHiddenConfig;
+  }
+
+  // 3. Check if legacy config exists in root
+  if (fs.existsSync(rootLegacyConfig)) {
+    return rootLegacyConfig;
+  }
+
+  // 4. For NEW configs:
+  // If node_modules exists, use it (recommended for security)
+  if (fs.existsSync(nodeModulesPath)) {
+    try {
+      // Ensure node_modules exists (redundant but safe)
+      return nodeModulesConfig;
+    } catch (e) {
+      // Fallback to root if node_modules is not writable
+    }
+  }
+
+  // Final fallback to hidden root config
+  return rootHiddenConfig;
 }
 
 /**
@@ -163,5 +197,6 @@ module.exports = {
   mergeWithDefaults,
   createConfig,
   updateConfig,
-  CONFIG_FILE
+  CONFIG_FILE,
+  HIDDEN_CONFIG_FILE
 };

package/src/explainer/interactive.js

@@ -8,7 +8,14 @@ const chalk = require('chalk');
 const readline = require('readline');
 const { explain } = require('./index');
 
+// Global state for cancellation
+let cancelPrompt = false;
+let activePromptResolver = null;
+
 async function showInteractiveExplainer(errorText, config) {
+  // Reset cancel flag
+  cancelPrompt = false;
+
   console.log('\n');
   const summary = (errorText || '').toString().split('\n')[0] || 'Unknown error';
 
@@ -20,34 +27,105 @@ async function showInteractiveExplainer(errorText, config) {
   console.log(chalk.white('    ' + summary));
   console.log();
 
-  // Compact, modern prompt
-  console.log(chalk.cyan.bold('    ? ') + chalk.white('Would you like an AI explanation?'));
-  console.log(chalk.gray('      [y] Yes, explain it  [n] No, just skip'));
-  console.log();
-
   const answer = await getUserInput();
 
-  if (answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes' || answer === '') {
+  if (answer === 'yes') {
     await explainErrorInteractively(errorText, config);
+  } else if (answer === 'cancelled') {
+    // Silently skip on cancellation
   } else {
     console.log(chalk.gray('    Skipped.\n'));
   }
 }
 
-function getUserInput() {
+async function getUserInput() {
   return new Promise((resolve) => {
-    const rl = readline.createInterface({
-      input: process.stdin,
-      output: process.stdout,
-      terminal: true
-    });
-
-    process.stdout.write(chalk.cyan('    > '));
-
-    rl.on('line', (answer) => {
-      rl.close();
-      resolve(answer.trim());
-    });
+    const options = [
+      { label: chalk.green('✓ Yes, explain it'), value: 'yes' },
+      { label: chalk.gray('✗ No, just skip'), value: 'no' }
+    ];
+
+    let selectedIndex = 0;
+    let isResolved = false;
+
+    // Store resolver for cancellation
+    activePromptResolver = () => {
+      if (!isResolved) {
+        cleanup();
+        isResolved = true;
+        resolve('cancelled');
+      }
+    };
+
+    // Display the question
+    console.log(chalk.cyan('    ? ') + chalk.white('Would you like an AI explanation?'));
+
+    const renderOptions = () => {
+      options.forEach((option, index) => {
+        const prefix = index === selectedIndex ? chalk.cyan('❯ ') : '  ';
+        console.log(`    ${prefix}${option.label}`);
+      });
+    };
+
+    const cleanup = () => {
+      process.stdin.removeListener('keypress', onKeypress);
+      if (process.stdin.isTTY) {
+        process.stdin.setRawMode(false);
+      }
+      process.stdin.pause();
+      activePromptResolver = null;
+    };
+
+    // Initial render
+    renderOptions();
+
+    // Setup readline for keypress
+    readline.emitKeypressEvents(process.stdin);
+    if (process.stdin.isTTY) {
+      process.stdin.setRawMode(true);
+    }
+
+    const onKeypress = (str, key) => {
+      // Check if cancelled
+      if (cancelPrompt) {
+        cleanup();
+        if (!isResolved) {
+          isResolved = true;
+          console.log(chalk.yellow('\n    (Skipped due to restart)\n'));
+          resolve('cancelled');
+        }
+        return;
+      }
+
+      if (key.name === 'up') {
+        // Clear previous options
+        process.stdout.write('\x1b[' + options.length + 'A'); // Move cursor up
+        process.stdout.write('\x1b[0J'); // Clear from cursor down
+
+        selectedIndex = selectedIndex > 0 ? selectedIndex - 1 : options.length - 1;
+        renderOptions();
+      } else if (key.name === 'down') {
+        // Clear previous options
+        process.stdout.write('\x1b[' + options.length + 'A'); // Move cursor up
+        process.stdout.write('\x1b[0J'); // Clear from cursor down
+
+        selectedIndex = selectedIndex < options.length - 1 ? selectedIndex + 1 : 0;
+        renderOptions();
+      } else if (key.name === 'return') {
+        cleanup();
+        if (!isResolved) {
+          isResolved = true;
+          console.log(); // Add newline after selection
+          resolve(options[selectedIndex].value);
+        }
+      } else if (key.ctrl && key.name === 'c') {
+        cleanup();
+        process.exit(0);
+      }
+    };
+
+    process.stdin.on('keypress', onKeypress);
+    process.stdin.resume();
   });
 }
 
@@ -69,6 +147,16 @@ function clearThinking(interval) {
   process.stdout.write('\r' + ' '.repeat(50) + '\r');
 }
 
+/**
+ * Cancel any active prompt
+ */
+function cancelActivePrompt() {
+  cancelPrompt = true;
+  if (activePromptResolver) {
+    activePromptResolver();
+  }
+}
+
 function displayExplanation(explanation) {
   console.log('\n');
 
@@ -87,12 +175,12 @@ function displayExplanation(explanation) {
 
     // High-end minimalist styling
     // If it starts with a keyword, add a line break before it to create gaps between sections
-    if (/^(Summary|Problem|Cause|Solution|Fix|Where|Why|File|Line|Note|Suggestion):/i.test(content)) {
+    if (/^(Summary|Problem|Cause|Solution|Fix|Where|Why|File|Line|Note|Suggestion|Minimal code fix|Code):/i.test(content)) {
       console.log();
     }
 
     content = content
-      .replace(/^(Summary|Problem|Cause|Solution|Fix|Where|Why|File|Line|Note|Suggestion):/i, (match) => chalk.hex('#FFAF00').bold(match))
+      .replace(/^(Summary|Problem|Cause|Solution|Fix|Where|Why|File|Line|Note|Suggestion|Minimal code fix|Code):/i, (match) => chalk.hex('#FFAF00').bold(match))
       .replace(/`([^`]+)`/g, (match) => chalk.hex('#00FF87')(match))
       .replace(/'([^']+)'/g, (match) => chalk.hex('#00FF87')(match));
 
@@ -119,5 +207,6 @@ async function explainErrorInteractively(errorText, config) {
 
 module.exports = {
   showInteractiveExplainer,
-  displayExplanation
+  displayExplanation,
+  cancelActivePrompt
 };

package/src/runner.js

@@ -12,7 +12,7 @@ const { spawn } = require('child_process');
 const chokidar = require('chokidar');
 const chalk = require('chalk');
 const { explain } = require('./explainer');
-const { showInteractiveExplainer } = require('./explainer/interactive');
+const { showInteractiveExplainer, cancelActivePrompt } = require('./explainer/interactive');
 
 class Runner {
   constructor(scriptPath, args = [], config = {}) {
@@ -57,7 +57,7 @@ class Runner {
       const text = data.toString();
       process.stderr.write(text);
       errorBuffer += text;
-      
+
       // Detect errors in stderr and explain them immediately
       if (this.isErrorOutput(text)) {
         this.explainErrorWithDebounce(text);
@@ -85,7 +85,7 @@ class Runner {
 
     this.child.on('exit', (code, signal) => {
       this.isProcessExiting = true;
-      
+
       if (code !== 0 && code !== null) {
         // Process exited with error
         if (!this.isRestarting && errorBuffer) {
@@ -148,15 +148,18 @@ class Runner {
 
     this.isRestarting = true;
 
+    // Cancel any active interactive prompt
+    cancelActivePrompt();
+
     if (this.child) {
       this.child.kill('SIGTERM');
-      
+
       // Wait a bit for graceful shutdown
       setTimeout(() => {
         if (this.child && !this.child.killed) {
           this.child.kill('SIGKILL');
         }
-        
+
         setTimeout(() => {
           this.isRestarting = false;
           if (reason) {
@@ -175,6 +178,9 @@ class Runner {
    * Stop the process and watcher
    */
   stop() {
+    // Cancel any active interactive prompt
+    cancelActivePrompt();
+
     if (this.watcher) {
       this.watcher.close();
       this.watcher = null;
@@ -228,7 +234,7 @@ class Runner {
       return;
     }
     this.lastErrorExplanationTime = now;
-    
+
     // Don't explain startup errors that already caused process exit
     if (this.isProcessExiting) {
       return;

package/USER_MANUAL.md

@@ -1,106 +0,0 @@
-# 📖 NodeWise User Manual
-
-Welcome to **NodeWise**, your AI-powered companion for Node.js development. This manual will help you get the most out of NodeWise's error explanation and auto-restart features.
-
----
-
-## 🚀 Getting Started
-
-NodeWise is designed to be a drop-in replacement for `node` or `nodemon` during development.
-
-### Installation
-If you haven't already, you can link it globally or install it in your project:
-```bash
-# Link for local development
-npm link
-
-# Install as a dev dependency
-npm install -D nodewise
-```
-
-### Initial Setup
-The first time you run NodeWise, it will launch a setup wizard to configure your preferred explanation mode.
-```bash
-npx nodewise --setup
-```
-
----
-
-## 🤖 Explanation Modes
-
-### 1. Gemini Explainer (AI-Powered)
-The "Top-G" mode. It uses Google's latest Gemini models to analyze your specific code and provide context-aware fixes.
-
-*   **Setup**: Requires a free Gemini API Key from [Google AI Studio](https://aistudio.google.com/app/apikey).
-*   **Best for**: Complex logic errors, obscure Node.js core errors, and step-by-step fix guides.
-*   **Features**: Beautiful minimalist terminal output with neon highlighting.
-
-### 2. Normal Detection (Offline)
-A lightning-fast, pattern-based mode that works entirely offline.
-
-*   **Setup**: No setup required.
-*   **Best for**: Common errors like `MODULE_NOT_FOUND`, `TypeError`, and `ReferenceError`.
-*   **Features**: Zero latency, works without an internet connection.
-
----
-
-## ⌨️ Command Line Interface
-
-| Command | Description |
-| :--- | :--- |
-| `nodewise <script.js>` | Run a script with auto-restart and error explainer. |
-| `nodewise --setup` | Change modes or update your Gemini API key. |
-| `nodewise --reset` | Wipe configuration and start fresh. |
-| `nodewise --help` | Show available options and examples. |
-| `nodewise -v` | Check your current NodeWise version. |
-
-### Running with Arguments
-You can pass arguments to your script just like you would with node:
-```bash
-nodewise server.js --port 3000 --env production
-```
-
----
-
-## ⚙️ Configuration
-NodeWise saves your preferences in `nodewise.config.json` in your project root.
-
-```json
-{
-  "mode": "gemini",
-  "gemini": {
-    "apiKey": "YOUR_KEY_HERE"
-  },
-  "autoRestart": true,
-  "ignorePatterns": ["node_modules", ".git"],
-  "timeout": 60000
-}
-```
-
-*   **autoRestart**: Set to `false` if you don't want the process to restart on file changes.
-*   **timeout**: Increase this if the AI is taking too long to respond on slow connections.
-
----
-
-## ✨ Pro Tips
-
-### 1. Minimalist AI Insight
-When a crash occurs in Gemini mode, you'll see a clean, gapped output. We've removed bulky boxes to keep your terminal clean. Look for the **✦ GEMINI INTELLIGENCE** header.
-
-### 2. Auto-Restart
-NodeWise watches your `.js` and `.json` files. As soon as you save a fix, NodeWise will instantly restart your application, allowing for a rapid "Code-Crash-Fix-Repeat" cycle.
-
-### 3. Graceful Exit
-Use `Ctrl+C` to shut down both your application and the NodeWise watcher gracefully.
-
----
-
-## 🆘 Troubleshooting
-
-*   **API Timeouts**: If you see "Gemini timed out," check your internet connection or increase the `timeout` in `nodewise.config.json`.
-*   **Invalid Key**: Ensure your API key is correct by re-running `nodewise --setup`.
-*   **Files not watching**: Ensure the directory you are working in doesn't have an ignore pattern matching your files.
-
----
-
-*Made with ❤️ for Node.js developers.*