@0xprathamesh/why-cli 1.1.1

package/dist/core/simulation.js

@@ -0,0 +1,330 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.simulateCommand = simulateCommand;
+const process_1 = require("./process");
+function confidenceForVerdict(verdict, supported) {
+    if (!supported) {
+        return 35;
+    }
+    switch (verdict) {
+        case "ready":
+            return 90;
+        case "blocked":
+            return 88;
+        case "warning":
+        default:
+            return 60;
+    }
+}
+function quoteArgs(args) {
+    return args.map((part) => (/\s/.test(part) ? JSON.stringify(part) : part)).join(" ");
+}
+async function simulateGit(intent, commandArgs, cwd) {
+    const action = intent.action;
+    const artifacts = [];
+    const checks = [];
+    if (action === "init") {
+        const gitDirProbe = await (0, process_1.runProcess)(["test", "-d", ".git"], { cwd });
+        const alreadyInitialized = gitDirProbe.ok;
+        return {
+            simulatedCommand: quoteArgs(commandArgs),
+            supported: true,
+            verdict: alreadyInitialized ? "blocked" : "ready",
+            confidence: confidenceForVerdict(alreadyInitialized ? "blocked" : "ready", true),
+            summary: alreadyInitialized
+                ? "This directory already looks like a Git repository, so `git init` would be redundant here."
+                : "This directory is not initialized yet, so `git init` would create a new `.git` folder here.",
+            checks: [
+                "Checked whether a `.git` directory already exists in the current folder.",
+            ],
+            artifacts: [
+                {
+                    title: "Repository inspection",
+                    body: alreadyInitialized ? ".git directory already exists." : ".git directory does not exist yet.",
+                },
+            ],
+            exitCode: alreadyInitialized ? 1 : 0,
+        };
+    }
+    const status = await (0, process_1.runProcess)(["git", "status", "--short", "--branch"], { cwd });
+    const statusBody = `${status.stdout}\n${status.stderr}`.trim();
+    if (statusBody) {
+        artifacts.push({ title: "git status --short --branch", body: statusBody });
+    }
+    if (!status.ok && /not a git repository/i.test(statusBody)) {
+        return {
+            simulatedCommand: quoteArgs(commandArgs),
+            supported: true,
+            verdict: "blocked",
+            confidence: confidenceForVerdict("blocked", true),
+            summary: "The command cannot be simulated here because the current directory is not inside a Git repository.",
+            checks: ["Validated repository presence before simulating the Git command."],
+            artifacts,
+            exitCode: status.exitCode,
+        };
+    }
+    if (action === "add") {
+        const dryRunArgs = ["git", "add", "--dry-run", ...commandArgs.slice(2)];
+        const probe = await (0, process_1.runProcess)(dryRunArgs, { cwd });
+        const body = `${probe.stdout}\n${probe.stderr}`.trim() || "git add --dry-run produced no output.";
+        checks.push("Validated the add operation with Git dry-run mode.");
+        artifacts.push({ title: quoteArgs(dryRunArgs), body });
+        return {
+            simulatedCommand: quoteArgs(dryRunArgs),
+            supported: true,
+            verdict: probe.ok ? "ready" : "blocked",
+            confidence: confidenceForVerdict(probe.ok ? "ready" : "blocked", true),
+            summary: probe.ok
+                ? "Git accepted the staged-file simulation, so the add should succeed if executed for real."
+                : "Git rejected the simulated add command before any files were staged.",
+            checks,
+            artifacts,
+            exitCode: probe.exitCode,
+        };
+    }
+    if (action === "commit") {
+        const staged = await (0, process_1.runProcess)(["git", "diff", "--cached", "--stat"], { cwd });
+        if (!staged.ok && staged.stderr.trim()) {
+            artifacts.push({ title: "git diff --cached --stat", body: `${staged.stdout}\n${staged.stderr}`.trim() });
+            return {
+                simulatedCommand: quoteArgs(commandArgs),
+                supported: true,
+                verdict: "blocked",
+                confidence: confidenceForVerdict("blocked", true),
+                summary: "why-cli could not validate the commit because Git returned an error while inspecting staged changes.",
+                checks: ["Tried to inspect the staged diff without creating a commit."],
+                artifacts,
+                exitCode: staged.exitCode,
+            };
+        }
+        const commitMessageIndex = commandArgs.findIndex((value) => value === "-m" || value === "--message");
+        const commitMessage = commitMessageIndex >= 0 ? commandArgs[commitMessageIndex + 1] : undefined;
+        const stagedBody = staged.stdout.trim() || "No staged diff was found.";
+        artifacts.push({ title: "git diff --cached --stat", body: stagedBody });
+        checks.push(commitMessage ? "Detected an explicit commit message." : "No explicit commit message flag was detected.");
+        return {
+            simulatedCommand: quoteArgs(commandArgs),
+            supported: true,
+            verdict: staged.stdout.trim() ? "ready" : "blocked",
+            confidence: confidenceForVerdict(staged.stdout.trim() ? "ready" : "blocked", true),
+            summary: staged.stdout.trim()
+                ? "A commit was not executed, but staged changes exist and the repository looks ready for commit validation."
+                : "The commit would likely fail because there are no staged changes to commit.",
+            checks,
+            artifacts,
+            exitCode: staged.stdout.trim() ? 0 : 1,
+        };
+    }
+    if (action === "push") {
+        const dryRunArgs = ["git", "push", "--dry-run", ...commandArgs.slice(2)];
+        const probe = await (0, process_1.runProcess)(dryRunArgs, { cwd });
+        const body = `${probe.stdout}\n${probe.stderr}`.trim() || "git push --dry-run produced no output.";
+        checks.push("Validated the push operation with Git dry-run mode.");
+        artifacts.push({ title: quoteArgs(dryRunArgs), body });
+        return {
+            simulatedCommand: quoteArgs(dryRunArgs),
+            supported: true,
+            verdict: probe.ok ? "ready" : "blocked",
+            confidence: confidenceForVerdict(probe.ok ? "ready" : "blocked", true),
+            summary: probe.ok
+                ? "The remote accepted the dry-run push, so the real push appears viable from Git's perspective."
+                : "The dry-run push surfaced a problem before any remote changes were sent.",
+            checks,
+            artifacts,
+            exitCode: probe.exitCode,
+        };
+    }
+    if (action === "merge" || action === "pull" || action === "rebase") {
+        return {
+            simulatedCommand: quoteArgs(commandArgs),
+            supported: false,
+            verdict: "warning",
+            confidence: confidenceForVerdict("warning", false),
+            summary: `why-cli detected a high-risk Git history command (${action}), but it does not yet have a safe no-side-effect simulator for it.`,
+            checks: [
+                "Repository status was inspected first.",
+                "No changes were executed.",
+            ],
+            artifacts,
+            exitCode: null,
+        };
+    }
+    return {
+        simulatedCommand: quoteArgs(commandArgs),
+        supported: false,
+        verdict: "warning",
+        confidence: confidenceForVerdict("warning", false),
+        summary: `why-cli recognized \`git ${action}\`, but does not have a native simulator for it yet.`,
+        checks: ["No changes were executed."],
+        artifacts,
+        exitCode: null,
+    };
+}
+async function simulatePackageManager(intent, commandArgs, cwd) {
+    const executable = commandArgs[0];
+    const action = intent.action;
+    if (!executable) {
+        return {
+            simulatedCommand: "",
+            supported: false,
+            verdict: "blocked",
+            confidence: confidenceForVerdict("blocked", false),
+            summary: "No executable was provided for simulation.",
+            checks: [],
+            artifacts: [],
+            exitCode: 1,
+        };
+    }
+    if (action === "publish" || action === "install" || action === "add") {
+        const dryRunArgs = [...commandArgs];
+        if (!dryRunArgs.includes("--dry-run")) {
+            dryRunArgs.push("--dry-run");
+        }
+        const probe = await (0, process_1.runProcess)(dryRunArgs, { cwd });
+        return {
+            simulatedCommand: quoteArgs(dryRunArgs),
+            supported: true,
+            verdict: probe.ok ? "ready" : "blocked",
+            confidence: confidenceForVerdict(probe.ok ? "ready" : "blocked", true),
+            summary: probe.ok
+                ? `${executable} accepted the dry-run, so the command shape looks valid without making changes.`
+                : `${executable} rejected the dry-run command before making changes.`,
+            checks: ["Used the package manager dry-run mode where supported."],
+            artifacts: [
+                {
+                    title: quoteArgs(dryRunArgs),
+                    body: `${probe.stdout}\n${probe.stderr}`.trim() || "No output from dry-run.",
+                },
+            ],
+            exitCode: probe.exitCode,
+        };
+    }
+    return {
+        simulatedCommand: quoteArgs(commandArgs),
+        supported: false,
+        verdict: "warning",
+        confidence: confidenceForVerdict("warning", false),
+        summary: `why-cli recognized ${executable}, but this action does not expose a safe native dry-run flow here.`,
+        checks: ["No changes were executed."],
+        artifacts: [],
+        exitCode: null,
+    };
+}
+async function simulateFilesystem(commandArgs, cwd) {
+    const executable = commandArgs[0];
+    const targets = commandArgs.slice(1);
+    if (executable === "cat" || executable === "ls" || executable === "pwd" || executable === "echo" || executable === "whoami") {
+        const probe = await (0, process_1.runProcess)(commandArgs, { cwd });
+        return {
+            simulatedCommand: quoteArgs(commandArgs),
+            supported: true,
+            verdict: probe.ok ? "ready" : "blocked",
+            confidence: confidenceForVerdict(probe.ok ? "ready" : "blocked", true),
+            summary: probe.ok
+                ? "This is a read-only command, so why-cli executed it safely during simulation."
+                : "The read-only command failed during simulation, so it would also fail when run normally.",
+            checks: ["Executed the read-only command directly because it does not mutate local state."],
+            artifacts: [
+                {
+                    title: quoteArgs(commandArgs),
+                    body: `${probe.stdout}\n${probe.stderr}`.trim() || "No output.",
+                },
+            ],
+            exitCode: probe.exitCode,
+        };
+    }
+    if (executable === "mkdir") {
+        const targetChecks = await Promise.all(targets.map(async (target) => {
+            const exists = await (0, process_1.runProcess)(["test", "-e", target], { cwd });
+            return `${target}: ${exists.ok ? "already exists" : "would be created"}`;
+        }));
+        return {
+            simulatedCommand: quoteArgs(commandArgs),
+            supported: true,
+            verdict: targetChecks.some((check) => check.includes("already exists")) ? "blocked" : "ready",
+            confidence: confidenceForVerdict(targetChecks.some((check) => check.includes("already exists")) ? "blocked" : "ready", true),
+            summary: "why-cli inspected whether the target directories already exist without creating them.",
+            checks: ["Validated mkdir targets before execution."],
+            artifacts: [{ title: "Directory inspection", body: targetChecks.join("\n") }],
+            exitCode: targetChecks.some((check) => check.includes("already exists")) ? 1 : 0,
+        };
+    }
+    if (executable === "touch") {
+        const targetChecks = await Promise.all(targets.map(async (target) => {
+            const exists = await (0, process_1.runProcess)(["test", "-e", target], { cwd });
+            return `${target}: ${exists.ok ? "would update timestamp" : "would create file"}`;
+        }));
+        return {
+            simulatedCommand: quoteArgs(commandArgs),
+            supported: true,
+            verdict: "ready",
+            confidence: confidenceForVerdict("ready", true),
+            summary: "why-cli inspected whether touch would create a file or update an existing one.",
+            checks: ["Validated touch targets before execution."],
+            artifacts: [{ title: "File inspection", body: targetChecks.join("\n") }],
+            exitCode: 0,
+        };
+    }
+    if (executable === "rmdir") {
+        const targetChecks = await Promise.all(targets.map(async (target) => {
+            const exists = await (0, process_1.runProcess)(["test", "-d", target], { cwd });
+            if (!exists.ok) {
+                return `${target}: missing`;
+            }
+            const list = await (0, process_1.runProcess)(["find", target, "-mindepth", "1", "-maxdepth", "1"], { cwd });
+            const empty = !list.stdout.trim();
+            return `${target}: ${empty ? "empty and removable" : "not empty"}`;
+        }));
+        return {
+            simulatedCommand: quoteArgs(commandArgs),
+            supported: true,
+            verdict: targetChecks.every((check) => check.includes("empty and removable")) ? "ready" : "blocked",
+            confidence: confidenceForVerdict(targetChecks.every((check) => check.includes("empty and removable")) ? "ready" : "blocked", true),
+            summary: "why-cli checked whether the directories exist and are empty before removing them.",
+            checks: ["Validated rmdir targets before execution."],
+            artifacts: [{ title: "Directory inspection", body: targetChecks.join("\n") }],
+            exitCode: targetChecks.every((check) => check.includes("empty and removable")) ? 0 : 1,
+        };
+    }
+    const probes = await Promise.all(targets.map(async (target) => {
+        const result = await (0, process_1.runProcess)(["test", "-e", target], { cwd });
+        return `${target}: ${result.ok ? "exists" : "missing"}`;
+    }));
+    return {
+        simulatedCommand: quoteArgs(commandArgs),
+        supported: true,
+        verdict: probes.some((probe) => probe.endsWith("missing")) ? "blocked" : "warning",
+        confidence: confidenceForVerdict(probes.some((probe) => probe.endsWith("missing")) ? "blocked" : "warning", true),
+        summary: "why-cli inspected the filesystem targets without executing the destructive command.",
+        checks: ["Validated whether the referenced paths exist before execution."],
+        artifacts: [
+            {
+                title: "Path inspection",
+                body: probes.join("\n"),
+            },
+        ],
+        exitCode: probes.some((probe) => probe.endsWith("missing")) ? 1 : 0,
+    };
+}
+async function simulateCommand(commandArgs, intent, cwd) {
+    if (intent.family === "git") {
+        return simulateGit(intent, commandArgs, cwd);
+    }
+    if (intent.family === "npm" || intent.family === "pnpm" || intent.family === "yarn") {
+        return simulatePackageManager(intent, commandArgs, cwd);
+    }
+    if (intent.family === "system") {
+        return simulateFilesystem(commandArgs, cwd);
+    }
+    return {
+        simulatedCommand: quoteArgs(commandArgs),
+        supported: false,
+        verdict: "warning",
+        confidence: confidenceForVerdict("warning", false),
+        summary: "No native simulation strategy is available for this command yet.",
+        checks: ["No changes were executed."],
+        artifacts: [],
+        exitCode: null,
+    };
+}
+//# sourceMappingURL=simulation.js.map

package/dist/core/simulation.js.map

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

package/dist/core/skills.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUILTIN_SKILLS = void 0;
+exports.resolveSkills = resolveSkills;
+exports.formatSkillList = formatSkillList;
+exports.BUILTIN_SKILLS = [
+    {
+        name: "debug",
+        title: "Root Cause Debugger",
+        description: "Focus on the most likely root cause and how to verify it quickly.",
+        promptHint: "Explain the most probable root cause first. Prefer a minimal reproduction or verification step.",
+    },
+    {
+        name: "teach",
+        title: "Explain Like A Teammate",
+        description: "Translate the failure into plain language for developers who need context.",
+        promptHint: "Use simple language, define jargon briefly, and help the user understand what the error means.",
+    },
+    {
+        name: "fix",
+        title: "Patch Planner",
+        description: "Turn the failure into a concrete fix path with likely code changes.",
+        promptHint: "Offer likely code-level fixes, mention where to look first, and call out edge cases if relevant.",
+    },
+    {
+        name: "tests",
+        title: "Test Guard",
+        description: "Recommend tests that would catch this failure next time.",
+        promptHint: "Include 1-3 test ideas that would prevent regressions once the issue is fixed.",
+    },
+    {
+        name: "security",
+        title: "Security Lens",
+        description: "Highlight whether the failure could involve secrets, auth, or unsafe config.",
+        promptHint: "Point out any security concerns, especially around secrets, permissions, tokens, and unsafe fallbacks.",
+    },
+    {
+        name: "perf",
+        title: "Performance Lens",
+        description: "Spot performance or scalability angles related to the failure.",
+        promptHint: "Mention performance or resource-usage implications only if they materially affect the issue.",
+    },
+];
+function resolveSkills(input) {
+    const requested = new Set(input
+        .flatMap((value) => value.split(","))
+        .map((value) => value.trim().toLowerCase())
+        .filter(Boolean));
+    if (requested.size === 0) {
+        return [exports.BUILTIN_SKILLS[0], exports.BUILTIN_SKILLS[1]];
+    }
+    return exports.BUILTIN_SKILLS.filter((skill) => requested.has(skill.name));
+}
+function formatSkillList() {
+    return exports.BUILTIN_SKILLS.map((skill) => `${skill.name.padEnd(8)} ${skill.description}`).join("\n");
+}
+//# sourceMappingURL=skills.js.map

package/dist/core/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/core/skills.ts"],"names":[],"mappings":";;;AAoDA,sCAaC;AAED,0CAEC;AA9DY,QAAA,cAAc,GAAsB;IAC/C;QACE,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,mEAAmE;QAChF,UAAU,EACR,iGAAiG;KACpG;IACD;QACE,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE,4EAA4E;QACzF,UAAU,EACR,gGAAgG;KACnG;IACD;QACE,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,qEAAqE;QAClF,UAAU,EACR,kGAAkG;KACrG;IACD;QACE,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,0DAA0D;QACvE,UAAU,EACR,gFAAgF;KACnF;IACD;QACE,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,8EAA8E;QAC3F,UAAU,EACR,wGAAwG;KAC3G;IACD;QACE,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,gEAAgE;QAC7E,UAAU,EACR,8FAA8F;KACjG;CACF,CAAC;AAEF,SAAgB,aAAa,CAAC,KAAe;IAC3C,MAAM,SAAS,GAAG,IAAI,GAAG,CACvB,KAAK;SACF,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;SACpC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;SAC1C,MAAM,CAAC,OAAO,CAAC,CACnB,CAAC;IAEF,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,sBAAc,CAAC,CAAC,CAAC,EAAE,sBAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,sBAAc,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,SAAgB,eAAe;IAC7B,OAAO,sBAAc,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAClG,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+const ANSI = {
+    reset: "\x1b[0m",
+    dim: "\x1b[2m",
+    bold: "\x1b[1m",
+    red: "\x1b[31m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    blue: "\x1b[34m",
+    cyan: "\x1b[36m",
+    gray: "\x1b[90m",
+};
+function applyColor(enabled, value, color) {
+    if (!enabled) {
+        return value;
+    }
+    return `${color}${value}${ANSI.reset}`;
+}
+function toneToColor(tone) {
+    switch (tone) {
+        case "success":
+            return ANSI.green;
+        case "warn":
+            return ANSI.yellow;
+        case "error":
+            return ANSI.red;
+        case "muted":
+            return ANSI.gray;
+        case "accent":
+            return ANSI.cyan;
+        case "info":
+        default:
+            return ANSI.blue;
+    }
+}
+function formatJson(event, payload) {
+    return JSON.stringify({
+        event,
+        ...payload,
+    }, null, 2);
+}
+class Logger {
+    constructor(options = {}) {
+        this.color = options.color ?? process.stdout.isTTY ?? false;
+        this.silent = options.silent ?? false;
+        this.json = options.json ?? false;
+    }
+    heading(title, subtitle) {
+        if (this.silent) {
+            return;
+        }
+        if (this.json) {
+            console.log(formatJson("heading", { title, subtitle }));
+            return;
+        }
+        const renderedTitle = applyColor(this.color, title, `${ANSI.bold}${ANSI.cyan}`);
+        console.log(renderedTitle);
+        if (subtitle) {
+            console.log(applyColor(this.color, subtitle, ANSI.gray));
+        }
+    }
+    line(message = "") {
+        if (this.silent) {
+            return;
+        }
+        if (this.json) {
+            console.log(formatJson("line", { message }));
+            return;
+        }
+        console.log(message);
+    }
+    section(title) {
+        if (this.silent) {
+            return;
+        }
+        if (this.json) {
+            console.log(formatJson("section", { title }));
+            return;
+        }
+        const decorated = applyColor(this.color, `\n${title}`, `${ANSI.bold}${ANSI.blue}`);
+        console.log(decorated);
+    }
+    badge(label, value, tone = "info") {
+        if (this.silent) {
+            return;
+        }
+        if (this.json) {
+            console.log(formatJson("badge", { label, value, tone }));
+            return;
+        }
+        const renderedLabel = applyColor(this.color, ` ${label.toUpperCase()} `, `${ANSI.bold}${toneToColor(tone)}`);
+        console.log(`${renderedLabel} ${value}`);
+    }
+    list(items, tone = "info") {
+        if (items.length === 0 || this.silent) {
+            return;
+        }
+        if (this.json) {
+            console.log(formatJson("list", { tone, items }));
+            return;
+        }
+        const bullet = applyColor(this.color, "•", toneToColor(tone));
+        for (const item of items) {
+            console.log(`${bullet} ${item}`);
+        }
+    }
+    block(title, body, tone = "muted") {
+        if (!body.trim() || this.silent) {
+            return;
+        }
+        if (this.json) {
+            console.log(formatJson("block", { title, tone, body }));
+            return;
+        }
+        const heading = applyColor(this.color, title, `${ANSI.bold}${toneToColor(tone)}`);
+        console.log(`${heading}\n${body}`);
+    }
+    event(message, tone = "info") {
+        if (this.silent) {
+            return;
+        }
+        if (this.json) {
+            console.log(formatJson("event", { tone, message }));
+            return;
+        }
+        console.log(applyColor(this.color, message, toneToColor(tone)));
+    }
+    rawStdout(message) {
+        if (this.silent) {
+            return;
+        }
+        process.stdout.write(message);
+    }
+    rawStderr(message) {
+        if (this.silent) {
+            return;
+        }
+        process.stderr.write(message);
+    }
+    printJson(payload) {
+        console.log(JSON.stringify(payload, null, 2));
+    }
+}
+exports.Logger = Logger;
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@0xprathamesh/why-cli",
+  "version": "1.1.1",
+  "description": "AI-first CLI debugger with safe simulation, code-aware fixes, and LangChain support for OpenAI and Ollama.",
+  "main": "dist/cli/index.js",
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "why": "dist/cli/index.js"
+  },
+  "preferGlobal": true,
+  "scripts": {
+    "build": "tsc",
+    "dev": "node dist/cli/index.js",
+    "check": "npm run build && npm pack --dry-run --cache ./.npm-pack-cache",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "cli",
+    "debugging",
+    "developer-tools",
+    "openai",
+    "ollama",
+    "typescript",
+    "langchain"
+  ],
+  "author": "why-cli contributors",
+  "license": "ISC",
+  "type": "commonjs",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@langchain/core": "^0.3.58",
+    "@langchain/ollama": "^0.2.0",
+    "@langchain/openai": "^0.6.16"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.2",
+    "typescript": "^6.0.2"
+  }
+}