@0xprathamesh/why-cli 1.1.1

package/dist/core/ai.js

@@ -0,0 +1,195 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AIExplanationError = void 0;
+exports.hasAIConfiguration = hasAIConfiguration;
+exports.explainFailureWithAI = explainFailureWithAI;
+exports.explainSimulationWithAI = explainSimulationWithAI;
+const prompts_1 = require("@langchain/core/prompts");
+const ollama_1 = require("@langchain/ollama");
+const openai_1 = require("@langchain/openai");
+const env_1 = require("./env");
+const prompts_2 = require("./prompts");
+class AIExplanationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "AIExplanationError";
+    }
+}
+exports.AIExplanationError = AIExplanationError;
+function resolveOpenAIKey(options) {
+    if (options.apiKey) {
+        return options.apiKey;
+    }
+    if (options.apiKeyEnv) {
+        return process.env[options.apiKeyEnv];
+    }
+    return (0, env_1.resolveEnvAlias)(["OPENAI_API_KEY", "OPENAI_APIKEY", "OPENAIAPIKEY", "openaiapikey"]);
+}
+function hasAIConfiguration(options) {
+    if (options.provider === "none") {
+        return false;
+    }
+    if (options.provider === "ollama") {
+        return true;
+    }
+    return Boolean(resolveOpenAIKey(options));
+}
+function normalizeContent(content) {
+    if (typeof content === "string") {
+        return content;
+    }
+    if (Array.isArray(content)) {
+        return content
+            .map((part) => {
+            if (typeof part === "string") {
+                return part;
+            }
+            if (part && typeof part === "object" && "text" in part) {
+                return String(part.text ?? "");
+            }
+            return "";
+        })
+            .join("\n")
+            .trim();
+    }
+    return String(content ?? "");
+}
+function extractJsonObject(raw) {
+    const fenced = raw.match(/```(?:json)?\s*([\s\S]+?)```/i);
+    if (fenced?.[1]) {
+        raw = fenced[1].trim();
+    }
+    const firstBrace = raw.indexOf("{");
+    const lastBrace = raw.lastIndexOf("}");
+    if (firstBrace === -1 || lastBrace === -1 || lastBrace <= firstBrace) {
+        throw new AIExplanationError("The AI response did not contain a JSON object.");
+    }
+    return raw.slice(firstBrace, lastBrace + 1);
+}
+function parseAIExplanation(raw, provider, model) {
+    let json;
+    try {
+        json = JSON.parse(extractJsonObject(raw));
+    }
+    catch (error) {
+        throw new AIExplanationError(`Could not parse AI response as JSON: ${error.message}`);
+    }
+    return {
+        provider,
+        model,
+        headline: typeof json.headline === "string" ? json.headline : "AI analysis",
+        summary: typeof json.summary === "string" ? json.summary : raw.trim(),
+        mostLikelyCause: typeof json.mostLikelyCause === "string" ? json.mostLikelyCause : "The model did not provide a distinct root cause.",
+        nextSteps: Array.isArray(json.nextSteps) ? json.nextSteps.map(String).filter(Boolean) : [],
+        guardrails: Array.isArray(json.guardrails) ? json.guardrails.map(String).filter(Boolean) : [],
+        confidence: json.confidence === "low" || json.confidence === "medium" || json.confidence === "high" ? json.confidence : "medium",
+        raw,
+    };
+}
+function buildModel(options) {
+    if (options.provider === "none") {
+        return null;
+    }
+    const openAIKey = resolveOpenAIKey(options);
+    if (options.provider === "openai" || (options.provider === "auto" && openAIKey)) {
+        if (!openAIKey) {
+            return null;
+        }
+        const modelName = options.model ?? (0, env_1.resolveEnvAlias)(["OPENAI_MODEL", "openaimodel"]) ?? "gpt-4.1";
+        return {
+            provider: "openai",
+            modelName,
+            model: new openai_1.ChatOpenAI({
+                model: modelName,
+                apiKey: openAIKey,
+                temperature: 0,
+                configuration: options.openaiBaseUrl
+                    ? {
+                        baseURL: options.openaiBaseUrl,
+                    }
+                    : undefined,
+            }),
+        };
+    }
+    const modelName = options.model ?? (0, env_1.resolveEnvAlias)(["OLLAMA_MODEL", "ollamamodel"]) ?? "llama3.1";
+    return {
+        provider: "ollama",
+        modelName,
+        model: new ollama_1.ChatOllama({
+            model: modelName,
+            baseUrl: options.ollamaHost ??
+                (0, env_1.resolveEnvAlias)(["OLLAMA_HOST", "OLLAMA_URL", "ollamaurl", "ollamahost"]) ??
+                "http://127.0.0.1:11434",
+            temperature: 0,
+            format: "json",
+        }),
+    };
+}
+async function invokePrompt(model, promptText) {
+    const prompt = prompts_1.ChatPromptTemplate.fromMessages([
+        ["system", "You are a precise AI assistant for developers. Follow the requested JSON schema exactly."],
+        ["human", "{input}"],
+    ]);
+    const messages = await prompt.formatMessages({ input: promptText });
+    const response = await model.invoke(messages);
+    return normalizeContent(response.content);
+}
+function wrapPlainTextAsExplanation(raw, provider, model) {
+    return {
+        provider,
+        model,
+        headline: "AI Analysis",
+        summary: raw.trim() || "The model returned an empty response.",
+        mostLikelyCause: "",
+        nextSteps: [],
+        guardrails: [],
+        confidence: "medium",
+        raw,
+    };
+}
+async function explainFailureWithAI(input) {
+    const resolution = buildModel(input.options);
+    if (!resolution) {
+        return null;
+    }
+    const raw = await invokePrompt(resolution.model, (0, prompts_2.buildFailureAnalysisPrompt)({
+        command: input.command,
+        intent: input.intent,
+        parsedError: input.parsedError,
+        stdout: input.stdout,
+        stderr: input.stderr,
+        skills: input.skills,
+        codeContext: input.codeContext,
+    }));
+    try {
+        return parseAIExplanation(raw, resolution.provider, resolution.modelName);
+    }
+    catch (error) {
+        if (error instanceof AIExplanationError) {
+            return wrapPlainTextAsExplanation(raw, resolution.provider, resolution.modelName);
+        }
+        throw error;
+    }
+}
+async function explainSimulationWithAI(input) {
+    const resolution = buildModel(input.options);
+    if (!resolution) {
+        return null;
+    }
+    const raw = await invokePrompt(resolution.model, (0, prompts_2.buildSimulationPrompt)({
+        command: input.command,
+        intent: input.intent,
+        simulation: input.simulation,
+        skills: input.skills,
+    }));
+    try {
+        return parseAIExplanation(raw, resolution.provider, resolution.modelName);
+    }
+    catch (error) {
+        if (error instanceof AIExplanationError) {
+            return wrapPlainTextAsExplanation(raw, resolution.provider, resolution.modelName);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=ai.js.map

package/dist/core/ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../../src/core/ai.ts"],"names":[],"mappings":"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"}

package/dist/core/args.js

@@ -0,0 +1,221 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseArgs = parseArgs;
+exports.renderHelp = renderHelp;
+const DEFAULTS = {
+    commandArgs: [],
+    silent: false,
+    json: false,
+    color: true,
+    raw: false,
+    explain: false,
+    provider: "auto",
+    model: undefined,
+    cwd: undefined,
+    timeoutMs: undefined,
+    apiKey: undefined,
+    apiKeyEnv: undefined,
+    ollamaHost: undefined,
+    openaiBaseUrl: undefined,
+    skills: [],
+    listSkills: false,
+    help: false,
+    version: false,
+    mode: "auto",
+    doctor: false,
+    setup: false,
+    stream: undefined,
+};
+function takeValue(args, index, flag) {
+    const value = args[index + 1];
+    if (!value || value.startsWith("-")) {
+        throw new Error(`Missing value for ${flag}`);
+    }
+    return value;
+}
+function parseMode(value) {
+    if (value === "auto" || value === "run" || value === "simulate") {
+        return value;
+    }
+    throw new Error(`Unsupported mode: ${value}`);
+}
+function parseArgs(argv) {
+    const options = {
+        ...DEFAULTS,
+        command: "",
+    };
+    const commandParts = [];
+    let commandMode = false;
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (arg === "--") {
+            commandParts.push(...argv.slice(index + 1));
+            break;
+        }
+        if (commandMode) {
+            commandParts.push(arg);
+            continue;
+        }
+        if (!arg.startsWith("-")) {
+            commandParts.push(arg);
+            commandMode = true;
+            continue;
+        }
+        switch (arg) {
+            case "-h":
+            case "--help":
+                options.help = true;
+                break;
+            case "-v":
+            case "--version":
+                options.version = true;
+                break;
+            case "-s":
+            case "--silent":
+                options.silent = true;
+                break;
+            case "--json":
+                options.json = true;
+                break;
+            case "--no-color":
+                options.color = false;
+                break;
+            case "-r":
+            case "--raw":
+                options.raw = true;
+                break;
+            case "-e":
+            case "--explain":
+                options.explain = true;
+                break;
+            case "--list-skills":
+                options.listSkills = true;
+                break;
+            case "--doctor":
+                options.doctor = true;
+                break;
+            case "--setup":
+                options.setup = true;
+                break;
+            case "--stream":
+                options.stream = true;
+                break;
+            case "--no-stream":
+                options.stream = false;
+                break;
+            case "--provider":
+                options.provider = takeValue(argv, index, arg);
+                index += 1;
+                break;
+            case "--model":
+                options.model = takeValue(argv, index, arg);
+                index += 1;
+                break;
+            case "--cwd":
+                options.cwd = takeValue(argv, index, arg);
+                index += 1;
+                break;
+            case "--timeout":
+                options.timeoutMs = Number(takeValue(argv, index, arg));
+                index += 1;
+                break;
+            case "--api-key":
+                options.apiKey = takeValue(argv, index, arg);
+                index += 1;
+                break;
+            case "--api-key-env":
+                options.apiKeyEnv = takeValue(argv, index, arg);
+                index += 1;
+                break;
+            case "--ollama-host":
+                options.ollamaHost = takeValue(argv, index, arg);
+                index += 1;
+                break;
+            case "--openai-base-url":
+                options.openaiBaseUrl = takeValue(argv, index, arg);
+                index += 1;
+                break;
+            case "--skill":
+                options.skills.push(takeValue(argv, index, arg));
+                index += 1;
+                break;
+            case "--mode":
+                options.mode = parseMode(takeValue(argv, index, arg));
+                index += 1;
+                break;
+            case "--simulate":
+                options.mode = "simulate";
+                break;
+            case "--run":
+            case "--execute":
+                options.mode = "run";
+                break;
+            default:
+                throw new Error(`Unknown flag: ${arg}`);
+        }
+    }
+    if (options.timeoutMs !== undefined && Number.isNaN(options.timeoutMs)) {
+        throw new Error("`--timeout` must be a number in milliseconds");
+    }
+    options.commandArgs = [...commandParts];
+    options.command = commandParts
+        .map((part) => (/\s/.test(part) ? JSON.stringify(part) : part))
+        .join(" ")
+        .trim();
+    return options;
+}
+function renderHelp(version) {
+    return `
+why-cli v${version}
+
+AI-first command debugger with LangChain-backed analysis, dry-run simulation,
+and safer defaults for risky commands like git push or npm publish.
+
+Usage:
+  why [options] -- <command>
+  why [options] <command>
+
+Modes:
+  auto       Run read-only commands, simulate risky mutating commands
+  run        Execute the command for real
+  simulate   Run a safe preflight instead of the real command when supported
+
+Flags:
+  -h, --help               Show help
+  -v, --version            Show version
+  -s, --silent             Hide formatted output
+  --json                   Emit structured JSON
+  --no-color               Disable ANSI colors
+  -r, --raw                Stream raw stdout/stderr for executed commands
+  -e, --explain            Force AI narration when a model is available
+  --mode <name>            auto | run | simulate
+  --simulate               Alias for --mode simulate
+  --run, --execute         Alias for --mode run
+  --provider <name>        auto | none | openai | ollama
+  --model <name>           Override the model name for the selected provider
+  --cwd <path>             Run the command in a specific directory
+  --timeout <ms>           Kill the command if it runs too long
+  --skill <name>           Add AI behavior hints like debug, teach, fix, tests
+  --list-skills            Print the built-in skill catalog
+  --doctor                 Validate .env/provider configuration and connectivity
+  --setup                  Configure global why-cli defaults in ~/.config/why-cli/.env
+  --stream                 Force live streaming of stdout/stderr while the command runs
+  --no-stream              Disable live streaming and wait for process exit before printing output
+  --api-key <key>          Pass an API key directly
+  --api-key-env <name>     Read the API key from a custom env var
+  --openai-base-url <url>  Override the OpenAI-compatible base URL
+  --ollama-host <url>      Override the Ollama host
+
+Examples:
+  why --doctor
+  why --setup
+  why --stream -- npm start
+  why -- npm test
+  why --simulate -- git push origin main
+  why --simulate -- git add .
+  why --run -- git commit -m "ship it"
+  why --provider openai --skill debug --skill fix -- npm run build
+  why --provider ollama --model llama3.1 --simulate -- npm publish
+`.trim();
+}
+//# sourceMappingURL=args.js.map

package/dist/core/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/core/args.ts"],"names":[],"mappings":"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"}

package/dist/core/codebase-context.js

@@ -0,0 +1,74 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectCodeContext = collectCodeContext;
+exports.formatCodeContext = formatCodeContext;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+function unique(values) {
+    return [...new Set(values)];
+}
+function readSnippet(filePath, lineNumber) {
+    if (!(0, fs_1.existsSync)(filePath)) {
+        return null;
+    }
+    const content = (0, fs_1.readFileSync)(filePath, "utf8");
+    const lines = content.split(/\r?\n/);
+    const start = Math.max((lineNumber ?? 1) - 3, 1);
+    const end = Math.min((lineNumber ?? 1) + 3, lines.length);
+    const excerpt = lines
+        .slice(start - 1, end)
+        .map((line, index) => `${start + index}: ${line}`)
+        .join("\n");
+    return excerpt;
+}
+function extractTypedErrorLocations(output) {
+    const matches = [...output.matchAll(/([A-Za-z0-9_./-]+\.(?:ts|tsx|js|jsx|json|mjs|cjs))\((\d+),\d+\)/g)];
+    return matches.map((match) => ({
+        filePath: match[1],
+        lineNumber: Number(match[2]),
+    }));
+}
+function collectCodeContext(cwd, output) {
+    const snippets = [];
+    const typedLocations = extractTypedErrorLocations(output);
+    for (const location of typedLocations.slice(0, 3)) {
+        const absolutePath = path_1.default.isAbsolute(location.filePath) ? location.filePath : path_1.default.join(cwd, location.filePath);
+        const excerpt = readSnippet(absolutePath, location.lineNumber);
+        if (excerpt) {
+            snippets.push({
+                filePath: absolutePath,
+                reason: `Referenced by the error output around line ${location.lineNumber ?? "unknown"}.`,
+                excerpt,
+            });
+        }
+    }
+    for (const projectFile of ["package.json", "tsconfig.json"].map((name) => path_1.default.join(cwd, name))) {
+        if (snippets.length >= 5) {
+            break;
+        }
+        if (!(0, fs_1.existsSync)(projectFile)) {
+            continue;
+        }
+        const excerpt = readSnippet(projectFile, 1);
+        if (excerpt) {
+            snippets.push({
+                filePath: projectFile,
+                reason: "Project configuration context.",
+                excerpt,
+            });
+        }
+    }
+    return unique(snippets.map((snippet) => JSON.stringify(snippet))).map((snippet) => JSON.parse(snippet));
+}
+function formatCodeContext(snippets) {
+    if (snippets.length === 0) {
+        return "No local code context was collected.";
+    }
+    return snippets
+        .map((snippet) => `File: ${snippet.filePath}\nReason: ${snippet.reason}\nSnippet:\n${snippet.excerpt}`)
+        .join("\n\n");
+}
+//# sourceMappingURL=codebase-context.js.map

package/dist/core/codebase-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase-context.js","sourceRoot":"","sources":["../../src/core/codebase-context.ts"],"names":[],"mappings":"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"}