devfix-cli 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,108 @@
+# 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
+```
+---
+### 5) Run a command and auto-capture errors for AI fixing
+1. Context command -> Include project/system context
+```bash
+devfix run <Command> --context
+```
+---
+  for example : devfix run kubectl get pods --context
+---
+
+2. Stack Command -> Force stack type
+```bash
+devfix run <Command> --stack <StackName>
+```
+---
+  for example : devfix run kubectl get pods --stack kubernetes
+---
+
+Model Command -> OpenRouter model override
+
+```bash
+devfix run <Command> --model <ModelName>
+```
+---
+  for example : devfix run kubectl get pods --model openai/gpt-4o-mini
+---
+
+
+

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 { runCommand } from "../src/utils/run.js";
 
 
 const program = new Command();
@@ -38,4 +39,20 @@ program
     });
   });
 
+program
+  .command("run")
+  .description("Run a command and auto-capture errors for AI fixing")
+  .option("-c, --context", "Include project/system context")
+  .option("-s, --stack <stack>", "Force stack type")
+  .option("-m, --model <model>", "OpenRouter model override")
+  .argument("<cmd...>", "Command to run")
+  .action((cmd, options) => {
+    runCommand(cmd, {
+      context: options.context,
+      stack: options.stack,
+      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.2"
 }

package/src/utils/autoError.js

@@ -0,0 +1,76 @@
+import fs from "fs";
+import os from "os";
+import path from "path";
+
+function getLatestFile(dir, ext = ".log") {
+  try {
+    if (!fs.existsSync(dir)) return null;
+
+    const files = fs
+      .readdirSync(dir)
+      .filter((f) => f.endsWith(ext))
+      .map((f) => ({
+        name: f,
+        full: path.join(dir, f),
+        time: fs.statSync(path.join(dir, f)).mtimeMs,
+      }))
+      .sort((a, b) => b.time - a.time);
+
+    return files.length ? files[0].full : null;
+  } catch {
+    return null;
+  }
+}
+
+function extractNpmError(logText) {
+  const lines = logText.split("\n");
+
+  // Most npm errors appear in these patterns
+  const keywords = ["npm ERR!", "error", "ERR_", "EACCES", "ENOTFOUND", "ECONNRESET"];
+
+  // Find first error-like line
+  let startIndex = -1;
+  for (let i = 0; i < lines.length; i++) {
+    const lower = lines[i].toLowerCase();
+    if (keywords.some((k) => lower.includes(k.toLowerCase()))) {
+      startIndex = i;
+      break;
+    }
+  }
+
+  // If no errors found, return null
+  if (startIndex === -1) return null;
+
+  // Take a clean block after the error line
+  const extracted = lines.slice(startIndex, startIndex + 60).join("\n");
+
+  // Remove useless "silly" lines
+  return extracted
+    .split("\n")
+    .filter((l) => !l.includes("silly"))
+    .slice(0, 60)
+    .join("\n")
+    .trim();
+}
+
+export function collectAutoError() {
+  const npmLogsDir = path.join(os.homedir(), ".npm", "_logs");
+  const latestNpmLog = getLatestFile(npmLogsDir, ".log");
+
+  if (latestNpmLog) {
+    const raw = fs.readFileSync(latestNpmLog, "utf-8");
+    const extracted = extractNpmError(raw);
+
+    if (extracted) {
+      return {
+        source: "npm" | "kubernetes" | "docker" | "git",
+        title: "Short readable error title",
+        file: "...optional",
+        extracted: "error lines",
+     }
+
+    }
+  }
+
+  return null;
+}

package/src/utils/prompt.js

@@ -4,8 +4,8 @@ You are DevFix, a CLI debugging assistant.
 
 Hard rules:
 - Be concise.
-- Max 5 fix steps.
-- Max 6 commands.
+- Max 3 fix steps.
+- Max 3 commands.
 - No long paragraphs.
 - If log indicates success (no error), say so and ask for the real error.
 - If ambiguous, ask ONLY 1 question.

package/src/utils/run.js

@@ -0,0 +1,240 @@
+import chalk from "chalk";
+import boxen from "boxen";
+import inquirer from "inquirer";
+import ora from "ora";
+import { spawn } from "child_process";
+
+import { marked } from "marked";
+import TerminalRenderer from "marked-terminal";
+
+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 { detectStack } from "../utils/detectStack.js";
+import { buildPrompt } from "../utils/prompt.js";
+import { askAI } from "../utils/ai.js";
+
+// Markdown renderer
+marked.setOptions({
+  renderer: new TerminalRenderer(),
+});
+
+export async function runCommand(cmdArgs, options) {
+  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);
+  }
+
+  if (!cmdArgs || cmdArgs.length === 0) {
+    console.log(chalk.red("\n❌ Please provide a command.\nExample: devfix run kubectl get pods\n"));
+    process.exit(1);
+  }
+
+  const command = cmdArgs[0];
+  const args = cmdArgs.slice(1);
+  const fullCmd = `${command} ${args.join(" ")}`.trim();
+
+  console.log(
+    boxen(
+      `${chalk.bold.cyan("▶ DevFix Run")}\n\n${chalk.white("Command:")} ${chalk.yellow(fullCmd)}\n${
+        options.context ? chalk.green("Context: ON") : chalk.red("Context: OFF")
+      }`,
+      { padding: 1, borderStyle: "round" }
+    )
+  );
+
+  // ✅ No shell=true (removes the security warning)
+  const child = spawn(command, args, { stdio: ["inherit", "pipe", "pipe"] });
+
+  let stdout = "";
+  let stderr = "";
+
+  child.stdout.on("data", (d) => {
+    const text = d.toString();
+    stdout += text;
+    process.stdout.write(text);
+  });
+
+  child.stderr.on("data", (d) => {
+    const text = d.toString();
+    stderr += text;
+    process.stderr.write(text);
+  });
+
+  child.on("close", async (code) => {
+    if (code === 0) {
+      console.log(chalk.green("\n✅ Command succeeded.\n"));
+      return;
+    }
+
+    const errorText = (stderr || stdout || "").trim();
+
+    console.log(chalk.red(`\n❌ Command failed (exit code: ${code}).\n`));
+
+    if (!errorText) {
+      console.log(chalk.red("No error output captured.\n"));
+      return;
+    }
+
+    console.log(
+      boxen(chalk.bold.red("⚠️ Captured Error"), {
+        padding: 1,
+        borderStyle: "round",
+      })
+    );
+
+    console.log(chalk.red(errorText.slice(0, 1200)));
+    if (errorText.length > 1200) console.log(chalk.gray("\n...trimmed...\n"));
+
+    const { confirm } = await inquirer.prompt([
+      {
+        name: "confirm",
+        type: "confirm",
+        message: "Send this error to DevFix AI for a fix?",
+        default: true,
+      },
+    ]);
+
+    if (!confirm) {
+      console.log(chalk.yellow("\n❌ Not sent to AI.\n"));
+      return;
+    }
+
+    const context = options.context ? collectContext() : {};
+    const stack = options.stack || detectStack(errorText);
+    const usedModel = options.model || "openai/gpt-4o-mini";
+
+    // 🔥 Send a better bundle (so AI never asks useless questions)
+    const errorBundle = `
+Command:
+${fullCmd}
+
+Exit Code:
+${code}
+
+Error Output:
+${errorText}
+`.trim();
+
+    console.log(
+      boxen(
+        `${chalk.bold.white("Stack:")} ${chalk.cyan(stack)}\n${chalk.bold.white("Model:")} ${chalk.magenta(
+          usedModel
+        )}`,
+        { padding: 1, borderStyle: "round" }
+      )
+    );
+
+    const spinner = ora("DevFix AI is analyzing...").start();
+
+    try {
+      const prompt = buildPrompt({
+        stack,
+        input: errorBundle,
+        context,
+      });
+
+      const answer = await askAI({
+        apiKey,
+        model: usedModel,
+        prompt,
+      });
+
+      spinner.succeed("Analysis complete");
+
+      console.log(
+        boxen(chalk.bold.green("✅ DevFix Suggested Fix"), {
+          padding: 1,
+          borderStyle: "round",
+        })
+      );
+
+      // ✅ Pretty output (markdown rendered)
+      console.log(marked(answer));
+      console.log();
+    } catch (err) {
+      spinner.fail("AI request failed");
+
+      console.log(chalk.red("\n❌ Error:\n"));
+      console.log(err?.response?.data || err.message);
+      console.log();
+    }
+  });
+  child.on("error", async (err) => {
+  if (err.code === "ENOENT") {
+    console.log(chalk.red(`\n❌ Command not found: ${command}\n`));
+    console.log(chalk.gray("Tip: Did you mean `kubectl`?\n"));
+
+    const { confirm } = await inquirer.prompt([
+      {
+        name: "confirm",
+        type: "confirm",
+        message: "Send this error to DevFix AI for a fix?",
+        default: true,
+      },
+    ]);
+
+    if (!confirm) {
+      console.log(chalk.yellow("\n❌ Not sent to AI.\n"));
+      process.exit(1);
+    }
+
+    const errorText = `Command not found: ${command}\nTried to run: ${fullCmd}`;
+    const context = options.context ? collectContext() : {};
+    const stack = options.stack || detectStack(errorText);
+    const usedModel = options.model || "openai/gpt-4o-mini";
+
+    const spinner = ora("DevFix AI is analyzing...").start();
+
+    try {
+      const prompt = buildPrompt({
+        stack,
+        input: errorText,
+        context,
+      });
+
+      const answer = await askAI({
+        apiKey,
+        model: usedModel,
+        prompt,
+      });
+
+      spinner.succeed("Analysis complete");
+
+      console.log(
+        boxen(chalk.bold.green("✅ DevFix Suggested Fix"), {
+          padding: 1,
+          borderStyle: "round",
+        })
+      );
+
+      console.log(marked(answer));
+      console.log();
+    } catch (e) {
+      spinner.fail("AI request failed");
+      console.log(chalk.red("\n❌ Error:\n"));
+      console.log(e?.response?.data || e.message);
+      console.log();
+    }
+
+    process.exit(1);
+  }
+
+  console.log(chalk.red("\n❌ Failed to run command:\n"));
+  console.log(err.message);
+  process.exit(1);
+});
+
+}
+
+