bugvinash 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Reejal
+
+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 whom the Software is
+furnished 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,176 @@
+<div align="center">
+
+# 🧠 BUGVINASH | बग विनाश | ਬੱਗ ਵਿਨਾਸ਼ | বাগবিনাশ | பக் வினாஷ்
+### _Destroying Bugs Before They Destroy Your GPA 💀_
+
+<img src="https://img.shields.io/badge/CLI-Tool-black?style=for-the-badge&logo=linux&logoColor=white"/>
+<img src="https://img.shields.io/badge/React-Analyzer-61DAFB?style=for-the-badge&logo=react&logoColor=black"/>
+<img src="https://img.shields.io/badge/Auto-Fix-Enabled?logoColor=green&logoSize=15&color=green
+"/>
+<img src="https://img.shields.io/badge/Made%20By-Student%20With%20Backlogs-ff4444?style=for-the-badge"/>
+
+</div>
+
+---
+
+## ⚡ What is BUGVINASH?
+
+**BUGVINASH** is a CLI tool that scans your React project, detects bugs, performance issues, and bad practices —  
+and optionally fixes them automatically.
+
+> Because debugging at 3 AM before exams is not a lifestyle… it's a problem.
+
+---
+
+## 🚀 Installation
+
+```bash
+npm install -g bugvinash
+```
+
+---
+
+## 🧪 Usage
+
+Run inside your React project:
+
+```bash
+bugvinash
+```
+
+---
+
+## 🛠 Auto Fix Mode
+
+```bash
+bugvinash --fix
+```
+
+---
+
+## 🔍 What It Actually Does
+
+### 🐛 Bug Detection
+- Detects `.map()` on undefined  
+- Missing `key` in React lists  
+- Syntax issues via AST  
+- Common React mistakes  
+
+---
+
+### ⚡ Performance Checks
+- Debug logs (`console.log`)  
+- Possible unnecessary re-renders  
+- Inefficient patterns  
+
+---
+
+### 🧹 Cleaner
+- Finds unwanted logs  
+- Removes them automatically using `--fix`  
+
+---
+
+### 🧠 AST Intelligence
+- Detects:
+  - Unused variables  
+  - `useEffect` without dependency array  
+  - Suspicious patterns  
+
+---
+
+### 📊 Project Health Score
+
+You get a final score like:
+
+```
+📊 Project Score: 67/100
+```
+
+> The lower the score… the more your code is crying internally.
+
+---
+
+## 💻 Example Output
+
+```
+🧠 BUGVINASH - Destroying Bugs...
+
+⚡ Performance Check:
+⚠ src/App.js → Debug logs present
+
+🐛 Bug Detection:
+⚠ src/App.js → Possible .map() on undefined
+⚠ src/App.js → Missing key prop in list rendering
+
+🧹 Cleaner Check:
+⚠ src/App.js → contains console.log
+
+📊 Project Score: 55/100
+
+✅ Your project is healthier now!
+```
+
+
+
+---
+
+## 🧠 Why This Exists
+
+Because:
+
+- You forgot `key` in `.map()`  
+- You left `console.log()` in production  
+- Your `useEffect` is doing black magic  
+- Your code works… but you don’t know why  
+
+> BUGVINASH knows.
+
+---
+
+## 💀 Real Talk
+
+Built by a student  
+with backlogs…  
+and bugs…  
+who decided to eliminate at least one of them.
+
+---
+
+## 🔮 Future Scope
+
+- AI-powered bug fixing 🤖  
+- VS Code Extension 🧩  
+- Advanced refactoring ⚡  
+
+---
+
+## 🤝 Contributing
+
+Pull requests are welcome.  
+Suggestions are welcome.  
+Bugs are not (BUGVINASH already handles them 😏)
+
+---
+
+## 📜 License
+
+MIT License © 2026 Reejal
+
+---
+
+## ⭐ Support
+
+If this tool helped you:
+
+- ⭐ Star the repo  
+- 🧑‍💻 Share with dev friends  
+- ☕ Use before panic debugging  
+
+---
+
+<div align="center">
+
+### 💀 _“Your code had bugs… now it has fear.”_
+
+</div>

package/bin/index.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+const chalk = require("chalk");
+const ora = require("ora");
+
+const { runPerformance } = require("../lib/modules/performance");
+const { runBugExplainer } = require("../lib/modules/bug");
+const { runCleaner } = require("../lib/modules/cleaner");
+const { generateReadme } = require("../lib/modules/readme");
+const { getScore } = require("../lib/core/scorer");
+
+const FIX_MODE = process.argv.includes("--fix");
+global.FIX_MODE = FIX_MODE;
+
+console.log(chalk.cyan.bold("\n🧠 BUGVINASH - Destroying Bugs...\n"));
+
+async function run() {
+const spinner = ora("Analyzing project...").start();
+
+try {
+await runPerformance();
+await runBugExplainer();
+await runCleaner();
+await generateReadme();
+
+
+spinner.succeed("Analysis complete!");
+
+console.log(chalk.blue(`\n📊 Project Score: ${getScore()}/100`));
+
+if (FIX_MODE) {
+  console.log(chalk.green("🛠 Auto-fix mode applied!\n"));
+}
+
+console.log(chalk.green("\n✅ Your project is healthier now!\n"));
+
+
+} catch (err) {
+spinner.fail("Error occurred");
+console.error(err);
+}
+}
+
+run();

package/lib/core/astScanner.js

@@ -0,0 +1,65 @@
+const fs = require("fs");
+const parser = require("@babel/parser");
+const traverse = require("@babel/traverse").default;
+
+function analyzeFile(filePath) {
+try {
+const code = fs.readFileSync(filePath, "utf-8");
+
+
+const ast = parser.parse(code, {
+  sourceType: "module",
+  plugins: ["jsx"]
+});
+
+const issues = new Set();
+
+traverse(ast, {
+  CallExpression(path) {
+    const callee = path.node.callee;
+
+    if (
+      callee.object &&
+      callee.object.name === "console" &&
+      callee.property &&
+      callee.property.name === "log"
+    ) {
+      issues.add("console.log detected");
+    }
+
+    if (callee.property && callee.property.name === "map") {
+      issues.add(".map() usage detected");
+    }
+  },
+
+  Identifier(path) {
+    if (path.node.name === "useEffect") {
+      const parent = path.parent;
+
+      if (parent.arguments && parent.arguments.length === 1) {
+        issues.add("useEffect without dependency array");
+      }
+    }
+  },
+
+  VariableDeclarator(path) {
+    const name = path.node.id.name;
+
+    if (
+      path.scope.bindings[name] &&
+      !path.scope.bindings[name].referenced
+    ) {
+      issues.add(`Unused variable: ${name}`);
+    }
+  }
+});
+
+return Array.from(issues);
+
+
+} catch (err) {
+return [`Syntax error in file: ${err.reasonCode || err.message}`];
+}
+}
+
+module.exports = { analyzeFile };

package/lib/core/scanner.js

@@ -0,0 +1,11 @@
+const glob = require("glob");
+
+function getAllFiles() {
+const files = glob.sync("src/**/*.{js,jsx}", {
+ignore: ["node_modules/**"]
+});
+
+return files;
+}
+
+module.exports = { getAllFiles };

package/lib/core/scorer.js

@@ -0,0 +1,12 @@
+let score = 100;
+
+function reduce(points) {
+score -= points;
+}
+
+function getScore() {
+if (score < 0) score = 0;
+return score;
+}
+
+module.exports = { reduce, getScore };

package/lib/modules/bug.js

@@ -0,0 +1,85 @@
+const fs = require("fs");
+const { getAllFiles } = require("../core/scanner");
+const { warning } = require("../utils/logger");
+const { reduce } = require("../core/scorer");
+
+function applyFixes(content) {
+let fixed = content;
+
+fixed = fixed.replace(/(\w+)\.map\(/g, "$1?.map(");
+
+fixed = fixed.replace(
+/useEffect(()\s*=>\s*{([\s\S]*?)}\s*)/g,
+"useEffect(() => {$1}, [])"
+);
+
+fixed = fixed.replace(
+/.map\((\w+)\s*=>\s*<(\w+)/g,
+'.map(($1, index) => <$2 key={index})'
+);
+
+fixed = fixed.replace(
+/const\s+(\w+)\s*=\s*[^;]+;\s*\n(?!.*\1)/g,
+""
+);
+
+return fixed;
+}
+
+async function runBugExplainer() {
+console.log("\n🐛 Bug Detection:\n");
+
+const astModule = require("../core/astScanner");
+const files = getAllFiles();
+
+files.forEach(file => {
+let content = fs.readFileSync(file, "utf-8");
+let updated = content;
+
+
+const reported = new Set();
+
+if (content.includes(".map(") && content.includes("undefined")) {
+  const msg = "Possible .map() on undefined";
+  if (!reported.has(msg)) {
+    warning(`${file} → ${msg}`);
+    reduce(10);
+    reported.add(msg);
+  }
+}
+
+if (content.includes(".map(") && !content.includes("key=")) {
+  const msg = "Missing key prop in list rendering";
+  if (!reported.has(msg)) {
+    warning(`${file} → ${msg}`);
+    reduce(8);
+    reported.add(msg);
+  }
+}
+
+if (astModule && typeof astModule.analyzeFile === "function") {
+  const astIssues = astModule.analyzeFile(file);
+
+  astIssues.forEach(issue => {
+    if (!reported.has(issue)) {
+      warning(`${file} → ${issue}`);
+      reduce(5);
+      reported.add(issue);
+    }
+  });
+}
+
+if (global.FIX_MODE) {
+  updated = applyFixes(content);
+
+  if (updated !== content) {
+    fs.writeFileSync(file, updated);
+    console.log(`🛠 Fixed issues in ${file}`);
+  }
+}
+
+
+});
+}
+
+module.exports = { runBugExplainer };

package/lib/modules/cleaner.js

@@ -0,0 +1,36 @@
+const fs = require("fs");
+const { getAllFiles } = require("../core/scanner");
+const { warning, success } = require("../utils/logger");
+const { reduce } = require("../core/scorer");
+
+async function runCleaner() {
+console.log("\n🧹 Cleaner Check:\n");
+
+const files = getAllFiles();
+let count = 0;
+
+files.forEach(file => {
+let content = fs.readFileSync(file, "utf-8");
+
+
+if (content.includes("console.log")) {
+  if (global.FIX_MODE) {
+    const cleaned = content.replace(/console\.log\([^)]*\);?/g, "");
+    fs.writeFileSync(file, cleaned);
+    warning(`${file} → console.log removed`);
+  } else {
+    warning(`${file} → contains console.log`);
+  }
+
+  reduce(3);
+  count++;
+}
+
+
+});
+
+console.log(`📊 Console logs found: ${count}`);
+success("Cleaner scan completed");
+}
+
+module.exports = { runCleaner };

package/lib/modules/performance.js

@@ -0,0 +1,46 @@
+const fs = require("fs");
+const { getAllFiles } = require("../core/scanner");
+const { warning, success } = require("../utils/logger");
+const { reduce } = require("../core/scorer"); // 🔥 NEW
+
+async function runPerformance() {
+console.log("\n⚡ Performance Check:\n");
+
+const files = getAllFiles();
+let issues = 0;
+
+files.forEach(file => {
+const content = fs.readFileSync(file, "utf-8");
+
+const reported = new Set(); 
+
+if (content.includes("useEffect") && content.includes("setState")) {
+  const msg = "Possible unnecessary re-render";
+  if (!reported.has(msg)) {
+    warning(`${file} → ${msg}`);
+    reduce(6);
+    issues++;
+    reported.add(msg);
+  }
+}
+
+if (content.includes("console.log")) {
+  const msg = "Debug logs present";
+  if (!reported.has(msg)) {
+    warning(`${file} → ${msg}`);
+    reduce(4);
+    issues++;
+    reported.add(msg);
+  }
+}
+
+
+});
+
+console.log(`📊 Files scanned: ${files.length}`);
+console.log(`⚠ Issues found: ${issues}`);
+
+success("Performance scan completed");
+}
+
+module.exports = { runPerformance };

package/lib/modules/readme.js

@@ -0,0 +1,23 @@
+const fs = require("fs");
+const { success } = require("../utils/logger");
+
+async function generateReadme() {
+console.log("\n📄 Generating README:\n");
+
+const content = `
+
+# 🚀 Project (Analyzed by BugVinash)
+
+## Features
+
+* Code scanned
+* Bugs detected
+* Cleaner applied
+  `;
+
+  fs.writeFileSync("README.md", content);
+
+  success("README.md created");
+  }
+
+module.exports = { generateReadme };

package/lib/utils/logger.js

@@ -0,0 +1,19 @@
+const chalk = require("chalk");
+
+function success(msg) {
+console.log(chalk.green(`✔ ${msg}`));
+}
+
+function warning(msg) {
+console.log(chalk.yellow(`⚠ ${msg}`));
+}
+
+function error(msg) {
+console.log(chalk.red(`❌ ${msg}`));
+}
+
+function info(msg) {
+console.log(chalk.cyan(`ℹ ${msg}`));
+}
+
+module.exports = { success, warning, error, info };

package/package.json

@@ -0,0 +1 @@
+{"name":"bugvinash","version":"1.0.1","description":"🚀 All-in-one React project analyzer & auto-fixer (bugs, performance, cleanup, README generator)","main":"bin/index.js","bin":{"bugvinash":"./bin/index.js"},"type":"commonjs","scripts":{"start":"node bin/index.js","dev":"node bin/index.js","test":"echo \"No tests yet\""},"keywords":["react","cli","bug-fixer","code-analyzer","developer-tool","performance","cleanup"],"author":"Reejal","license":"MIT","dependencies":{"@babel/parser":"^7.29.2","@babel/traverse":"^7.29.0","chalk":"^4.1.2","fs-extra":"^11.3.4","glob":"^13.0.6","ora":"^5.4.1"},"engines":{"node":">=14"}}