nodewise 1.0.0 → 1.0.2

package/README.md

@@ -1,3 +1,7 @@
+<p align="center">
+  <img src="logo.png" alt="NodeWise Logo" width="200px">
+</p>
+
 # nodewise
 
 > Node.js error explainer with AI-powered clarity
@@ -67,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.0",
+  "version": "1.0.2",
   "description": "Node.js error explainer with AI-powered clarity",
   "main": "src/index.js",
   "type": "commonjs",
@@ -22,17 +22,19 @@
   "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",
     "src",
     "examples",
     "README.md",
-    "USER_MANUAL.md"
+    "USER_MANUAL.md",
+    "logo.png",
+    "LICENSE"
   ],
   "repository": {
     "type": "git",
@@ -42,8 +44,7 @@
     "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

@@ -87,12 +87,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));
 

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.*