devfix-cli 1.0.0 → 1.0.1

package/README.md

@@ -0,0 +1,95 @@
+# DevFix CLI 🚀  
+AI-powered CLI tool that helps you debug errors, logs, and DevOps issues directly from your terminal.
+
+DevFix analyzes your error output (Node, Docker, Kubernetes, Minikube, Git, etc.) and suggests the most likely fix with copy-paste commands.
+
+---
+
+## ✨ Features
+
+- 🔐 Login once (saved locally for 7 days)
+- 🤖 Uses OpenRouter API (supports many models)
+- 🧠 Auto-detects stack (Node, Docker, Kubernetes, Git, Python, React)
+- 📦 Optional auto context mode (`--context`)
+- 🎬 Animated DevFix logo during analysis (Minikube-style)
+- 🧾 Clean Markdown output in terminal
+- 🧩 Works on macOS / Linux / Windows
+
+---
+
+### 1) Install DevFix globally
+```bash
+npm install -g devfix
+```
+
+Check installation:
+```bash
+devfix --version
+```
+
+---
+
+### 2) Login (required)
+
+DevFix needs your OpenRouter API key to work.
+
+Run:
+```bash
+devfix login
+```
+
+It will ask for:
+- Username
+- Email
+- OpenRouter API Key
+
+Your login is saved locally for **7 days**, so you don’t need to login again daily.
+
+---
+
+### 3) Start using DevFix
+
+Analyze an error directly:
+```bash
+devfix analyze "npm install failing"
+```
+
+Analyze with automatic context collection (recommended):
+```bash
+devfix analyze "minikube ingress not working" --context
+```
+
+Analyze a log file:
+```bash
+devfix analyze --file error.log
+```
+
+---
+
+### 4) Session commands
+
+Check current login:
+```bash
+devfix whoami
+```
+
+Logout:
+```bash
+devfix logout
+```
+
+scan -> collects context + auto errors:
+```bash
+devfix scan
+```
+
+scan preview -> shows what it found:
+```bash
+devfix scan --preview 
+```
+
+sacn analyze -> Send scan results to AI:
+```bash
+devfix scan -a 
+```
+

package/bin/index.js

@@ -5,6 +5,7 @@ import { loginCommand } from "../src/commands/login.js";
 import { logoutCommand } from "../src/commands/logout.js";
 import { whoamiCommand } from "../src/commands/whoami.js";
 import { analyzeCommand } from "../src/commands/analyze.js";
+import { scanCommand } from "../src/commands/scan.js";
 
 
 const program = new Command();
@@ -38,4 +39,18 @@ program
     });
   });
 
+program
+  .command("scan")
+  .description("Scan your system/project for recent errors and context")
+  .option("-p, --preview", "Preview collected data only (recommended)")
+  .option("-a, --analyze", "Send scan results to AI")
+  .option("-m, --model <model>", "OpenRouter model override")
+  .action((options) => {
+    scanCommand({
+      preview: options.preview,
+      analyze: options.analyze,
+      model: options.model,
+    });
+  });
+
 program.parse(process.argv);

package/package.json

@@ -18,5 +18,5 @@
     "marked-terminal": "^7.3.0",
     "ora": "^9.3.0"
   },
-  "version": "1.0.0"
+  "version": "1.0.1"
 }

package/src/commands/analyze.js

@@ -10,6 +10,7 @@ import TerminalRenderer from "marked-terminal";
 import { readConfig } from "../utils/config.js";
 import { isSessionValid } from "../utils/session.js";
 import { decrypt } from "../utils/cryptoStore.js";
+import { collectAutoError } from "../utils/autoError.js";
 
 import { collectContext } from "../utils/context.js";
 import { detectStack } from "../utils/detectStack.js";
@@ -44,10 +45,18 @@ export async function analyzeCommand({ text, file, stack, model, useContext }) {
     input = fs.readFileSync(file, "utf-8");
   }
 
-  if (!input || input.trim().length < 2) {
-    console.log(chalk.red("\n❌ Please provide error text or use --file\n"));
-    process.exit(1);
-  }
+  // If no text + no file, try auto error collection
+if ((!input || input.trim().length < 2) && useContext) {
+  const autoErr = collectAutoError();
+  if (autoErr) input = autoErr;
+}
+
+if (!input || input.trim().length < 2) {
+  console.log(chalk.red("\n❌ Please provide error text or use --file\n"));
+  console.log(chalk.gray("Tip: You can also run: devfix analyze --context"));
+  process.exit(1);
+}
+
 
   const detected = stack || detectStack(input);
   const usedModel = model || "openai/gpt-4o-mini";

package/src/commands/scan.js

@@ -0,0 +1,94 @@
+import chalk from "chalk";
+import boxen from "boxen";
+
+import { readConfig } from "../utils/config.js";
+import { isSessionValid } from "../utils/session.js";
+import { decrypt } from "../utils/cryptoStore.js";
+
+import { collectContext } from "../utils/context.js";
+import { collectAutoError } from "../utils/autoError.js";
+import { detectStack } from "../utils/detectStack.js";
+import { buildPrompt } from "../utils/prompt.js";
+import { askAI } from "../utils/ai.js";
+
+export async function scanCommand({ preview, analyze, model }) {
+  const config = readConfig();
+
+  if (!isSessionValid(config)) {
+    console.log(chalk.red("\n❌ Not logged in or session expired.\nRun: devfix login\n"));
+    process.exit(1);
+  }
+
+  const apiKey = decrypt(config.apiKeyEncrypted);
+  if (!apiKey) {
+    console.log(chalk.red("\n❌ API key missing. Run: devfix login\n"));
+    process.exit(1);
+  }
+
+  const context = collectContext();
+  const autoErr = collectAutoError();
+
+  const detected = detectStack(autoErr || "");
+  const usedModel = model || "openai/gpt-4o-mini";
+
+  console.log(
+    boxen(chalk.bold.cyan("🔎 DevFix Scan Results"), {
+      padding: 1,
+      borderStyle: "round",
+    })
+  );
+
+  console.log(chalk.white("\nContext collected:"));
+  console.log(chalk.gray(JSON.stringify(context, null, 2)));
+
+  console.log(chalk.white("\nAuto error detected:"));
+  if (autoErr) {
+    console.log(chalk.yellow(autoErr.slice(0, 2500)));
+    if (autoErr.length > 2500) console.log(chalk.gray("\n...trimmed output...\n"));
+  } else {
+    console.log(chalk.red("❌ No recent error log found."));
+  }
+
+  console.log(chalk.white("\nDetected stack: ") + chalk.cyan(detected));
+  console.log(chalk.white("Model: ") + chalk.magenta(usedModel));
+  console.log();
+
+  // If only preview requested
+  if (preview && !analyze) {
+    console.log(chalk.green("✅ Preview complete. Nothing was sent to AI.\n"));
+    return;
+  }
+
+  // If analyze requested
+  if (analyze) {
+    if (!autoErr) {
+      console.log(chalk.red("\n❌ No error found to analyze.\n"));
+      console.log(chalk.gray("Tip: Run devfix analyze \"your error\" --context\n"));
+      process.exit(1);
+    }
+
+    console.log(chalk.cyan("🤖 Sending scan data to AI...\n"));
+
+    const prompt = buildPrompt({
+      stack: detected,
+      input: autoErr,
+      context,
+    });
+
+    const answer = await askAI({
+      apiKey,
+      model: usedModel,
+      prompt,
+    });
+
+    console.log(
+      boxen(chalk.bold.green("✅ DevFix Suggested Fix"), {
+        padding: 1,
+        borderStyle: "round",
+      })
+    );
+
+    console.log(answer);
+    console.log();
+  }
+}

package/src/utils/autoError.js

@@ -0,0 +1,53 @@
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { execSync } from "child_process";
+
+function safeExec(cmd) {
+  try {
+    return execSync(cmd, { encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+  } catch {
+    return null;
+  }
+}
+
+export function collectAutoError() {
+  const cwd = process.cwd();
+
+  // 1) npm debug log (most common)
+  const npmLog = path.join(os.homedir(), ".npm", "_logs");
+  if (fs.existsSync(npmLog)) {
+    const files = fs
+      .readdirSync(npmLog)
+      .filter((f) => f.endsWith(".log"))
+      .map((f) => ({
+        name: f,
+        full: path.join(npmLog, f),
+        time: fs.statSync(path.join(npmLog, f)).mtimeMs,
+      }))
+      .sort((a, b) => b.time - a.time);
+
+    if (files.length > 0) {
+      const latest = files[0].full;
+      const content = fs.readFileSync(latest, "utf-8").slice(-6000);
+      return `📌 Auto-collected npm debug log:\nFile: ${latest}\n\n${content}`;
+    }
+  }
+
+  // 2) Git status (sometimes shows merge conflicts)
+  const git = safeExec("git status --porcelain=v1");
+  if (git && git.trim().length > 0) {
+    return `📌 Auto-collected Git status:\n\n${git}`;
+  }
+
+  // 3) Kubernetes events (if cluster exists)
+  const events = safeExec(
+    "kubectl get events -A --sort-by=.metadata.creationTimestamp | tail -n 25"
+  );
+  if (events) {
+    return `📌 Auto-collected Kubernetes events:\n\n${events}`;
+  }
+
+  // Nothing found
+  return null;
+}