bugzero 0.0.13 → 0.0.17

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> bugzero@0.0.13 build D:\WD projects\OpsPilot\packages\cli
+> bugzero@0.0.17 build D:\WD projects\OpsPilot\packages\cli
 > tsup src/index.ts --format cjs --dts
 
 CLI Building entry: src/index.ts
@@ -7,8 +7,8 @@
 CLI tsup v8.5.1
 CLI Target: es2022
 CJS Build start
-CJS dist\index.js 50.76 KB
-CJS ⚡️ Build success in 63ms
+CJS dist\index.js 63.10 KB
+CJS ⚡️ Build success in 102ms
 DTS Build start
-DTS ⚡️ Build success in 1156ms
+DTS ⚡️ Build success in 1876ms
 DTS dist\index.d.ts 20.00 B

package/README.md

@@ -77,6 +77,7 @@ bugzero rescue
 | Error type parsing | Parses TypeScript, ESLint, and Jest error formats |
 | Dry-run mode | Analyze and report without writing any files |
 | Local model config | Save preferred model to `.bugzerorc` per project |
+| Markdown Reports | Automatically generates a detailed Markdown report and opens it in your IDE (VS Code, Cursor, Windsurf, Sublime) as an unsaved editor tab, giving you the choice to save or discard it. |
 
 ---
 
@@ -165,6 +166,17 @@ This file is created automatically when you run `bugzero vibe`.
 
 ---
 
+## Reports
+
+Every time you run `bugzero hunt` or `bugzero rescue`, a detailed Markdown report is generated and automatically opened in your IDE (VS Code, Cursor, Windsurf, or Sublime Text) as an unsaved editor tab. This avoids polluting your project workspace and gives you the choice to save it or discard it. The report includes:
+- **Pipeline Summary:** Clear status checklist of your project's Build, Lint, and Test suites.
+- **Detailed Error Outputs:** Full error logs from any failing checks.
+- **AI Brain Details:** The exact OpenRouter model used.
+- **Token Usage:** Accumulated prompt and completion tokens used for the run.
+- **Applied Fixes (for rescue):** The root cause, explanation, and before/after search-replace code diffs of any patches applied.
+
+---
+
 ## Development Setup
 
 Clone the repository and install dependencies. This project uses a pnpm monorepo managed by Turborepo.

package/dist/index.js

@@ -643,7 +643,11 @@ var require_dist3 = __commonJS({
           if (response.data?.error) {
             throw new Error(response.data.error.message || JSON.stringify(response.data.error));
           }
-          return response.data.choices[0].message.content;
+          return {
+            content: response.data.choices[0].message.content,
+            model,
+            usage: response.data.usage
+          };
         } catch (error) {
           let msg = error.message;
           if (error.response?.data?.error?.message) {
@@ -877,6 +881,21 @@ var require_dist6 = __commonJS({
       success: (0, import_langgraph.Annotation)({
         reducer: (_, value) => value,
         default: () => false
+      }),
+      /** Model used for the repair */
+      modelUsed: (0, import_langgraph.Annotation)({
+        reducer: (_, value) => value,
+        default: () => ""
+      }),
+      /** Total prompt tokens used */
+      promptTokens: (0, import_langgraph.Annotation)({
+        reducer: (old, value) => old + value,
+        default: () => 0
+      }),
+      /** Total completion tokens used */
+      completionTokens: (0, import_langgraph.Annotation)({
+        reducer: (old, value) => old + value,
+        default: () => 0
       })
     });
     var import_ai_provider = require_dist3();
@@ -890,7 +909,8 @@ var require_dist6 = __commonJS({
 [BugZero] Attempt ${state.attempts + 1}/${state.maxAttempts} \u2014 asking AI\u2026`
       );
       const prompt = (0, import_prompts.buildAnalysisPrompt)(state.logs, state.cwd);
-      const response = await provider.invoke(prompt, { cwd: state.cwd });
+      const result = await provider.invoke(prompt, { cwd: state.cwd });
+      const response = result.content;
       let fixSuggestion = null;
       try {
         const cleaned = response.replace(/```json\n?/g, "").replace(/```\n?/g, "").trim();
@@ -906,7 +926,10 @@ var require_dist6 = __commonJS({
       return {
         analysis: response,
         fixSuggestion,
-        attempts: state.attempts + 1
+        attempts: state.attempts + 1,
+        modelUsed: result.model,
+        promptTokens: result.usage?.prompt_tokens ?? 0,
+        completionTokens: result.usage?.completion_tokens ?? 0
       };
     }
     async function applyFixNode(state) {
@@ -1036,6 +1059,7 @@ var require_dist7 = __commonJS({
     }
     var import_analyzers = require_dist2();
     var import_agents = require_dist6();
+    var import_ai_provider = require_dist3();
     async function orchestrate2(options = {}) {
       const cwd = options.cwd ?? process.cwd();
       const [build, lint, test] = await Promise.all([
@@ -1043,6 +1067,12 @@ var require_dist7 = __commonJS({
         (0, import_analyzers.runLint)(cwd),
         (0, import_analyzers.runTests)(cwd)
       ]);
+      await writeReport(cwd, "hunt", {
+        success: build.success && lint.success && test.success,
+        build,
+        lint,
+        test
+      });
       return { build, lint, test };
     }
     async function orchestrateAndFix2(options = {}) {
@@ -1052,12 +1082,25 @@ var require_dist7 = __commonJS({
       const pipelineResult = await (0, import_analyzers.runValidationPipeline)(cwd);
       if (pipelineResult.success) {
         console.log("[BugZero] Validation already passing \u2014 nothing to fix.");
+        await writeReport(cwd, "rescue", {
+          success: true,
+          attempts: 0,
+          maxAttempts,
+          rawOutput: ""
+        });
         return { success: true, attempts: 0, finalOutput: "" };
       }
       const errors = (0, import_analyzers.parseErrors)(pipelineResult.output);
       console.log(`[BugZero] Detected ${errors.length} error(s) (type: ${errors[0]?.type ?? "unknown"})`);
       if (options.dryRun) {
         console.log("[BugZero] Dry-run mode \u2014 skipping AI fix.");
+        await writeReport(cwd, "rescue", {
+          success: false,
+          attempts: 0,
+          maxAttempts,
+          error: "Dry-run: analysis complete, no files modified.",
+          rawOutput: pipelineResult.output
+        });
         return {
           success: false,
           attempts: 0,
@@ -1072,13 +1115,242 @@ var require_dist7 = __commonJS({
         attempts: 0,
         success: false
       });
-      return {
+      const result = {
         success: finalState.success,
         attempts: finalState.attempts,
         finalOutput: finalState.logs || pipelineResult.output,
         appliedFix: finalState.fixSuggestion ?? void 0,
-        error: finalState.success ? void 0 : `Max attempts (${maxAttempts}) reached without a successful build.`
+        error: finalState.success ? void 0 : `Max attempts (${maxAttempts}) reached without a successful build.`,
+        modelUsed: finalState.modelUsed,
+        promptTokens: finalState.promptTokens,
+        completionTokens: finalState.completionTokens
       };
+      await writeReport(cwd, "rescue", {
+        success: result.success,
+        attempts: result.attempts,
+        maxAttempts,
+        appliedFix: result.appliedFix,
+        error: result.error,
+        rawOutput: result.finalOutput,
+        modelUsed: result.modelUsed,
+        promptTokens: result.promptTokens,
+        completionTokens: result.completionTokens
+      });
+      return result;
+    }
+    async function writeReport(cwd, type, data) {
+      let content = "";
+      const provider = new import_ai_provider.OpenRouterProvider();
+      if (type === "hunt") {
+        const { build, lint, test } = data;
+        if (!build.success || !lint.success || !test.success) {
+          let logs = "";
+          if (!build.success) logs += `[BUILD FAILURE]
+${build.output}
+
+`;
+          if (!lint.success) logs += `[LINT FAILURE]
+${lint.output}
+
+`;
+          if (!test.success) logs += `[TEST FAILURE]
+${test.output}
+
+`;
+          console.log("[BugZero] Calling AI to diagnose errors and write report...");
+          const prompt = `You are an expert software engineer assistant. Below is the error output from a project's build, lint, and test checks.
+Please analyze the errors and generate a professional, beautifully formatted Markdown report summarizing:
+1. **Diagnosis:** Clear explanation of what failed and why.
+2. **Root Cause:** The underlying issue in the code/config.
+3. **Action Plan:** Step-by-step instructions on what files need to be modified and what exact changes to make.
+
+Failed Checks Logs:
+${logs}
+
+Generate the Markdown report directly. Do not wrap it in markdown block fences (\`\`\`markdown ... \`\`\`). Just write the markdown text directly.`;
+          try {
+            const result = await provider.invoke(prompt, { cwd });
+            content = result.content;
+            content += `
+
+---
+### \u{1F50D} BugZero Hunt Metadata
+- **AI Brain (Model) used for Diagnosis:** \`${result.model || "unknown"}\`
+- **Token Usage for Diagnosis:** ${result.usage ? `Prompt: **${result.usage.prompt_tokens}** | Completion: **${result.usage.completion_tokens}** | Total: **${result.usage.total_tokens}**` : "*N/A*"}`;
+          } catch (e) {
+            content = `# \u{1F50D} BugZero Hunt Report
+
+**Date:** ${(/* @__PURE__ */ new Date()).toLocaleString()}
+**Project Path:** \`${cwd}\`
+**Framework:** \`${detectFramework2(cwd)}\`
+
+## \u{1F4CA} Status Summary
+- **Build:** ${build.success ? "\u2705 Passed" : "\u274C Failed"}
+- **Lint:** ${lint.success ? "\u2705 Passed" : "\u274C Failed"}
+- **Test:** ${test.success ? "\u2705 Passed" : "\u274C Failed"}
+
+## \u274C Failed Checks & Error Output
+${logs}
+`;
+          }
+        } else {
+          content = `# \u{1F50D} BugZero Hunt Report
+
+**Date:** ${(/* @__PURE__ */ new Date()).toLocaleString()}
+**Project Path:** \`${cwd}\`
+**Framework:** \`${detectFramework2(cwd)}\`
+
+## \u{1F4CA} Status Summary
+- **Build:** \u2705 Passed
+- **Lint:** \u2705 Passed
+- **Test:** \u2705 Passed
+
+\u{1F389} **All checks passed! Your project is in perfect shape.**`;
+        }
+      } else {
+        const { success, attempts, maxAttempts, appliedFix, error, rawOutput, modelUsed, promptTokens, completionTokens } = data;
+        if (success && appliedFix) {
+          console.log("[BugZero] Calling AI to write solution summary report...");
+          const prompt = `You are an expert software engineer assistant. An automated AI agent successfully resolved a build/lint/test failure in a project located at "${cwd}" after ${attempts} attempts by applying a patch to "${appliedFix.filePath}".
+Here is the patch details:
+- Root Cause: ${appliedFix.rootCause}
+- Explanation: ${appliedFix.explanation}
+- Search code:
+${appliedFix.search}
+- Replace code:
+${appliedFix.replace}
+
+Please generate a professional, beautifully formatted Markdown report summarizing:
+1. **Repair Summary:** Celebrate the success and explain the fix.
+2. **Details of the Solution:** Walk the developer through what was changed and why.
+3. **Verification:** Explain how it was verified (build, lint, tests passed).
+
+Generate the Markdown report directly. Do not wrap it in markdown block fences (\`\`\`markdown ... \`\`\`). Just write the markdown text directly.`;
+          try {
+            const result = await provider.invoke(prompt, { cwd });
+            content = result.content;
+            content += `
+
+---
+### \u{1F916} BugZero Rescue Metadata
+- **AI Brain (Model) used for Fix:** \`${modelUsed || "unknown"}\`
+- **Token Usage for Fix:** ${promptTokens !== void 0 && completionTokens !== void 0 ? `Prompt: **${promptTokens}** | Completion: **${completionTokens}** | Total: **${promptTokens + completionTokens}**` : "*N/A*"}
+- **AI Brain (Model) used for Report:** \`${result.model || "unknown"}\`
+- **Token Usage for Report:** ${result.usage ? `Prompt: **${result.usage.prompt_tokens}** | Completion: **${result.usage.completion_tokens}** | Total: **${result.usage.total_tokens}**` : "*N/A*"}`;
+          } catch (e) {
+            content = `# \u{1F916} BugZero Rescue Report
+
+**Date:** ${(/* @__PURE__ */ new Date()).toLocaleString()}
+**Project Path:** \`${cwd}\`
+**Framework:** \`${detectFramework2(cwd)}\`
+
+## \u{1F4CA} Repair Summary
+- **Status:** \u2705 Fixed successfully!
+- **Attempts:** ${attempts} / ${maxAttempts}
+- **AI Brain (Model):** \`${modelUsed || "unknown"}\`
+- **Token Usage:** ${promptTokens !== void 0 && completionTokens !== void 0 ? `Prompt: **${promptTokens}** | Completion: **${completionTokens}** | Total: **${promptTokens + completionTokens}**` : "*N/A*"}
+
+## \u{1F6E0}\uFE0F Applied Solution
+- **Target File:** \`${appliedFix.filePath}\`
+- **Root Cause:** ${appliedFix.rootCause}
+- **Explanation:** ${appliedFix.explanation}
+
+### \u{1F4DD} Code Changes
+**Search (Before):**
+\`\`\`typescript
+${appliedFix.search}
+\`\`\`
+
+**Replace (After):**
+\`\`\`typescript
+${appliedFix.replace}
+\`\`\`
+`;
+          }
+        } else {
+          console.log("[BugZero] Calling AI to analyze unresolved errors and write report...");
+          const prompt = `You are an expert software engineer assistant. An automated AI agent tried to repair build/lint/test errors in a project located at "${cwd}", but could not resolve them after ${attempts} attempts.
+Below is the unresolved error logs.
+Please analyze these logs and generate a professional, beautifully formatted Markdown report summarizing:
+1. **Analysis of Unresolved Errors:** Explain why the AI fixes might have failed or what is still unresolved.
+2. **Manual Action Plan:** Provide detailed, step-by-step instructions for the developer on how to fix this manually.
+
+Unresolved Error Logs:
+${rawOutput}
+
+Generate the Markdown report directly. Do not wrap it in markdown block fences (\`\`\`markdown ... \`\`\`). Just write the markdown text directly.`;
+          try {
+            const result = await provider.invoke(prompt, { cwd });
+            content = result.content;
+            content += `
+
+---
+### \u{1F916} BugZero Rescue Metadata
+- **AI Brain (Model) used for Fix Attempts:** \`${modelUsed || "unknown"}\`
+- **Token Usage for Fix Attempts:** ${promptTokens !== void 0 && completionTokens !== void 0 ? `Prompt: **${promptTokens}** | Completion: **${completionTokens}** | Total: **${promptTokens + completionTokens}**` : "*N/A*"}
+- **AI Brain (Model) used for Report:** \`${result.model || "unknown"}\`
+- **Token Usage for Report:** ${result.usage ? `Prompt: **${result.usage.prompt_tokens}** | Completion: **${result.usage.completion_tokens}** | Total: **${result.usage.total_tokens}**` : "*N/A*"}`;
+          } catch (e) {
+            content = `# \u{1F916} BugZero Rescue Report
+
+**Date:** ${(/* @__PURE__ */ new Date()).toLocaleString()}
+**Project Path:** \`${cwd}\`
+**Framework:** \`${detectFramework2(cwd)}\`
+
+## \u{1F4CA} Repair Summary
+- **Status:** \u274C Could not repair automatically
+- **Attempts:** ${attempts} / ${maxAttempts}
+- **AI Brain (Model):** \`${modelUsed || "unknown"}\`
+- **Token Usage:** ${promptTokens !== void 0 && completionTokens !== void 0 ? `Prompt: **${promptTokens}** | Completion: **${completionTokens}** | Total: **${promptTokens + completionTokens}**` : "*N/A*"}
+
+## \u274C Failed to Repair
+**Reason:** ${error || "Max attempts reached without finding a solution."}
+
+### \u{1F7E5} Unresolved Errors & Logs
+\`\`\`text
+${rawOutput}
+\`\`\`
+`;
+          }
+        }
+      }
+      content += `
+
+---
+*Report generated by **BugZero** on ${(/* @__PURE__ */ new Date()).toLocaleString()}*`;
+      const opened = await openInIDE(content);
+      if (!opened) {
+        console.log("\n\u26A0\uFE0F Could not automatically open the report in your IDE (no compatible editor found in PATH).");
+        console.log("Here is the generated report:\n");
+        console.log(content);
+        console.log("\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+      }
+    }
+    async function openInIDE(content) {
+      const editors = [
+        { cmd: "code", args: ["-"], name: "VS Code" },
+        { cmd: "cursor", args: ["-"], name: "Cursor" },
+        { cmd: "windsurf", args: ["-"], name: "Windsurf" },
+        { cmd: "subl", args: ["-"], name: "Sublime Text" }
+      ];
+      try {
+        const { execa } = await import("execa");
+        for (const editor of editors) {
+          try {
+            const proc = execa(editor.cmd, editor.args, { shell: true });
+            if (proc.stdin) {
+              proc.stdin.write(content);
+              proc.stdin.end();
+              await proc;
+              console.log(`\u{1F5A5}\uFE0F Opened report as an unsaved tab in ${editor.name}.`);
+              return true;
+            }
+          } catch (err) {
+          }
+        }
+      } catch (e) {
+      }
+      return false;
     }
   }
 });
@@ -1142,6 +1414,10 @@ program.command("rescue").description("Detect build failures and automatically a
   console.log("\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
   if (result.success) {
     console.log(`\u2705 Build fixed after ${result.attempts} attempt(s)!`);
+    console.log(`   Model:  ${result.modelUsed || "unknown"}`);
+    if (result.promptTokens !== void 0 && result.completionTokens !== void 0) {
+      console.log(`   Tokens: Prompt: ${result.promptTokens} | Completion: ${result.completionTokens} | Total: ${result.promptTokens + result.completionTokens}`);
+    }
     if (result.appliedFix) {
       console.log(`   File:   ${result.appliedFix.filePath}`);
       console.log(`   Reason: ${result.appliedFix.explanation}`);
@@ -1149,7 +1425,16 @@ program.command("rescue").description("Detect build failures and automatically a
     }
   } else {
     console.log(`\u274C Could not fix build after ${result.attempts} attempt(s).`);
+    console.log(`   Model:  ${result.modelUsed || "unknown"}`);
+    if (result.promptTokens !== void 0 && result.completionTokens !== void 0) {
+      console.log(`   Tokens: Prompt: ${result.promptTokens} | Completion: ${result.completionTokens} | Total: ${result.promptTokens + result.completionTokens}`);
+    }
     if (result.error) console.log(`   ${result.error}`);
+    console.log(`
+\u2500\u2500 Unresolved Error Output \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`);
+    console.log(result.finalOutput);
+    console.log(`\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+`);
   }
   console.log();
   process.exit(result.success ? 0 : 1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bugzero",
-  "version": "0.0.13",
+  "version": "0.0.17",
   "bin": {
     "bugzero": "dist/index.js"
   },

package/src/index.ts

@@ -82,6 +82,10 @@ program
     console.log("\n──────────────────────────────────────────────");
     if (result.success) {
       console.log(`✅ Build fixed after ${result.attempts} attempt(s)!`);
+      console.log(`   Model:  ${result.modelUsed || "unknown"}`);
+      if (result.promptTokens !== undefined && result.completionTokens !== undefined) {
+        console.log(`   Tokens: Prompt: ${result.promptTokens} | Completion: ${result.completionTokens} | Total: ${result.promptTokens + result.completionTokens}`);
+      }
       if (result.appliedFix) {
         console.log(`   File:   ${result.appliedFix.filePath}`);
         console.log(`   Reason: ${result.appliedFix.explanation}`);
@@ -89,7 +93,14 @@ program
       }
     } else {
       console.log(`❌ Could not fix build after ${result.attempts} attempt(s).`);
+      console.log(`   Model:  ${result.modelUsed || "unknown"}`);
+      if (result.promptTokens !== undefined && result.completionTokens !== undefined) {
+        console.log(`   Tokens: Prompt: ${result.promptTokens} | Completion: ${result.completionTokens} | Total: ${result.promptTokens + result.completionTokens}`);
+      }
       if (result.error) console.log(`   ${result.error}`);
+      console.log(`\n── Unresolved Error Output ────────────────────────`);
+      console.log(result.finalOutput);
+      console.log(`───────────────────────────────────────────────────\n`);
     }
     console.log();