bugzero 0.0.1 → 0.0.3

package/README.md

@@ -0,0 +1,143 @@
+# 🚀 BugZero
+
+[![npm version](https://img.shields.io/npm/v/bugzero.svg?style=flat-square&color=FF69B4)](https://www.npmjs.com/package/bugzero)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![pnpm](https://img.shields.io/badge/maintained%20with-pnpm-cc00ff.svg?style=flat-square)](https://pnpm.io/)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/Saksham1800t)
+
+**BugZero** is an autonomous, AI-powered self-healing command-line tool. It monitors build, lint, and test errors in your project, analyzes them using an LLM, generates precise surgical code patches, applies them safely, and runs validation loops recursively until your build is completely green.
+
+Designed for modern developer loops, CI/CD pipelines, and automated hotfixes.
+
+---
+
+## 🛠️ How it Works
+
+```mermaid
+graph TD
+    A[Start: bugzero rescue] --> B[Run build, lint, and test scripts]
+    B --> C{Any Failures?}
+    C -- No --> D[Success: Exits cleanly]
+    C -- Yes --> E[Capture error outputs and logs]
+    E --> F[Prompt LLM via LangGraph Agent]
+    F --> G[Parse Structured Fix Suggestion]
+    G --> H[Apply Precise Search & Replace Patch]
+    H --> I[Verify build and validation tests]
+    I --> J{Build Fixed?}
+    J -- Yes --> K[✅ Output Fix Details & Exit]
+    J -- No --> L{Max attempts reached?}
+    L -- Yes --> M[❌ Exit failure with logs]
+    L -- No --> F
+```
+
+---
+
+## 🌟 Key Features
+
+*   **🔍 Automatic Framework Detection**: Detects common web frameworks and tooling setups inside your target directories.
+*   **🤖 LangGraph-Based Feedback Loop**: Employs stateful graphs to analyze compiler/test outputs, write minimal patches, and re-run compilation checks recursively.
+*   **⚡ Surgical Search-and-Replace**: Avoids corrupting files by using highly specific search-and-replace strings generated directly from the abstract syntax context.
+*   **📦 Safe Backups**: Creates a backup `.bugzero.bak` for every modified file so you can revert modifications easily.
+*   **📈 Multiple Checkups**: Validates builds, style guidelines (ESLint), and testing frameworks (Jest) automatically.
+
+---
+
+## 🚀 Getting Started
+
+### 1. Global Installation
+Install `bugzero` globally from NPM:
+```bash
+npm install -g bugzero
+```
+
+### 2. Configure Environment Variables
+BugZero relies on OpenRouter to access Claude. Configure your environment variable in your terminal session or add it to a `.env` file at the root of the project you are fixing:
+
+**On macOS/Linux:**
+```bash
+export OPENROUTER_API_KEY="your_openrouter_api_key_here"
+```
+
+**On Windows (PowerShell):**
+```powershell
+$env:OPENROUTER_API_KEY="your_openrouter_api_key_here"
+```
+
+---
+
+## 💻 Usage & Commands
+
+Run `bugzero` from any terminal directory.
+
+### 1. Hunt for Bugs (Dry-Run / Safe Check)
+Run build, lint, and test checks to report error diagnostics without modifying any files.
+```bash
+bugzero hunt --path /path/to/your/project
+```
+
+### 2. Rescue Your Project (Autonomous Mode)
+Run the AI repair loop to automatically detect compilation errors, generate code patches, apply them, and verify the build.
+```bash
+bugzero rescue --path /path/to/your/project
+```
+
+### 3. Vibe With a Brain (Change AI Model)
+List and select which LLM model you want to use. This fetches the latest available models from OpenRouter, lets you pick one, and saves it inside `.bugzerorc`.
+```bash
+bugzero vibe
+```
+
+### CLI Command Options
+
+| Option | Shorthand | Description | Default |
+| :--- | :--- | :--- | :--- |
+| `--path <dir>` | `-p <dir>` | The path to the target project you want to check/fix | `.` (Current directory) |
+| `--max-attempts <num>` | `-n <num>` | Maximum AI fix loops/attempts before giving up | `3` |
+| `--dry-run` | | Print the recommended fixes without saving changes to files | `false` |
+
+---
+
+## 🧱 Monorepo Development & Local Setup
+
+If you want to contribute to the BugZero engine:
+
+### Prerequisites
+*   Node.js (LTS version recommended)
+*   `pnpm` (workspace manager)
+
+### Installation
+Clone the repository, go into the workspace root, and run:
+```bash
+pnpm install
+```
+
+### Local Commands
+*   **Build all monorepo packages**:
+    ```bash
+    pnpm build
+    ```
+*   **Run CLI locally in development mode (shortcuts)**:
+    ```bash
+    pnpm hunt --path ./demo-project
+    pnpm rescue --path ./demo-project
+    pnpm vibe
+    ```
+
+---
+
+## 👥 Author
+
+Made with ❤️ and 😎 by:
+
+*   **Name**: Saksham Agarwal
+*   **Email**: [sakshamagarwal0507@gmail.com](mailto:sakshamagarwal0507@gmail.com)
+*   **GitHub**: [@Saksham1800t](https://github.com/Saksham1800t)
+*   **LinkedIn**: [Saksham Agarwal](https://www.linkedin.com/in/saksham-agarwal-/)
+
+---
+
+## ☕ Support My Work
+
+If BugZero saved you debugging hours in production or deployment pipelines, support the project!
+
+[!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/saksham_)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bugzero",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "bin": {
     "bugzero": "dist/index.js"
   },
@@ -13,8 +13,8 @@
   },
   "devDependencies": {
     "@opspilot/agents": "0.0.1",
-    "@opspilot/config": "0.0.1",
-    "@opspilot/core": "0.0.1"
+    "@opspilot/core": "0.0.1",
+    "@opspilot/config": "0.0.1"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/index.ts

@@ -13,9 +13,9 @@ program
   .description("AI-powered build issue fixer — detects and repairs build errors automatically")
   .version("0.0.1");
 
-// ── bugzero analyze ─────────────────────────────────────────────────────────
+// ── bugzero hunt ─────────────────────────────────────────────────────────────
 program
-  .command("analyze")
+  .command("hunt")
   .description("Run build, lint, and tests — report issues without modifying files")
   .option("-p, --path <dir>", "Path to the target project", ".")
   .action(async (opts) => {
@@ -53,13 +53,13 @@ program
     }
 
     const allPassed = build.success && lint.success && test.success;
-    console.log(`\n${allPassed ? "✅ All checks passed" : "❌ Issues found — run 'bugzero fix' to repair"}\n`);
+    console.log(`\n${allPassed ? "✅ All checks passed" : "❌ Issues found — run 'bugzero rescue' to repair"}\n`);
     process.exit(allPassed ? 0 : 1);
   });
 
-// ── bugzero fix ─────────────────────────────────────────────────────────────
+// ── bugzero rescue ───────────────────────────────────────────────────────────
 program
-  .command("fix")
+  .command("rescue")
   .description("Detect build failures and automatically apply AI-generated fixes")
   .option("-p, --path <dir>", "Path to the target project", ".")
   .option("-n, --max-attempts <number>", "Maximum AI fix attempts", "3")
@@ -99,11 +99,98 @@ program
 // ── bugzero protect (legacy) ────────────────────────────────────────────────
 program
   .command("protect")
-  .description("[Deprecated] Use 'analyze' instead")
+  .description("[Deprecated] Use 'hunt' instead")
   .action(async () => {
-    console.warn("⚠️  'protect' is deprecated — use 'bugzero analyze' instead.\n");
+    console.warn("⚠️  'protect' is deprecated — use 'bugzero hunt' instead.\n");
     const result = await orchestrate();
     console.log(result);
   });
 
+// ── bugzero vibe ─────────────────────────────────────────────────────────────
+program
+  .command("vibe")
+  .description("Select which AI model (brain) to use for resolving bugs")
+  .action(async () => {
+    const { getLocalConfig, saveLocalConfig } = await import("@opspilot/config");
+    const readline = await import("readline");
+    const axios = (await import("axios")).default;
+
+    console.log(`\n🧠 BugZero Brain Selector`);
+    console.log(`──────────────────────────────────────────────`);
+
+    let popularModels: any[] = [];
+    try {
+      console.log("🌀 Fetching active models list from OpenRouter...");
+      const response = await axios.get("https://openrouter.ai/api/v1/models", { timeout: 8000 });
+      const allModels = response.data?.data || [];
+      const popularModelIds = [
+        "deepseek/deepseek-chat",
+        "deepseek/deepseek-r1",
+        "anthropic/claude-3.5-sonnet",
+        "google/gemini-2.5-pro",
+        "google/gemini-2.5-flash",
+        "openai/gpt-4o",
+        "meta-llama/llama-3.3-70b-instruct"
+      ];
+      popularModels = allModels.filter((m: any) => popularModelIds.includes(m.id));
+    } catch (e: any) {
+      console.warn("⚠️ Failed to fetch models list from OpenRouter. Using cached default list.");
+    }
+
+    if (popularModels.length === 0) {
+      popularModels = [
+        { id: "deepseek/deepseek-chat", name: "DeepSeek V3 (Chat)" },
+        { id: "deepseek/deepseek-r1", name: "DeepSeek R1" },
+        { id: "anthropic/claude-3.5-sonnet", name: "Claude 3.5 Sonnet" },
+        { id: "google/gemini-2.5-pro", name: "Gemini 2.5 Pro" },
+        { id: "google/gemini-2.5-flash", name: "Gemini 2.5 Flash" },
+        { id: "openai/gpt-4o", name: "GPT-4o" },
+        { id: "meta-llama/llama-3.3-70b-instruct", name: "Llama 3.3 Instruct" }
+      ];
+    }
+
+    const currentModel = getLocalConfig().model || "deepseek/deepseek-chat";
+    console.log(`\nCurrent active model: \x1b[36m${currentModel}\x1b[0m\n`);
+
+    popularModels.forEach((m, idx) => {
+      console.log(`   [${idx + 1}] ${m.name} (${m.id})`);
+    });
+    console.log(`   [${popularModels.length + 1}] 🖋️  Custom Model (Type manually)`);
+    console.log();
+
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+
+    rl.question(`Select a number (1-${popularModels.length + 1}): `, (answer) => {
+      const choice = parseInt(answer.trim(), 10);
+      if (isNaN(choice) || choice < 1 || choice > popularModels.length + 1) {
+        console.log("❌ Invalid selection. Keeping current model.");
+        rl.close();
+        process.exit(1);
+      }
+
+      if (choice === popularModels.length + 1) {
+        rl.question("Enter custom OpenRouter Model ID (e.g. microsoft/phi-3-medium-128k-instruct): ", (customModel) => {
+          const selected = customModel.trim();
+          if (!selected) {
+            console.log("❌ No model entered. Keeping current model.");
+          } else {
+            saveLocalConfig({ model: selected });
+            console.log(`\n✅ Saved! Model set to: \x1b[32m${selected}\x1b[0m`);
+            console.log(`   Saved config to: .bugzerorc`);
+          }
+          rl.close();
+        });
+      } else {
+        const selected = popularModels[choice - 1].id;
+        saveLocalConfig({ model: selected });
+        console.log(`\n✅ Saved! Model set to: \x1b[32m${selected}\x1b[0m`);
+        console.log(`   Saved config to: .bugzerorc`);
+        rl.close();
+      }
+    });
+  });
+
 program.parse();