depfix-ai 0.2.11 → 0.2.12

package/dist/lib/audit/npmAudit.d.ts

@@ -4,10 +4,9 @@ export interface NpmAuditResult {
     exitCode: number | undefined;
 }
 /**
- * Run an npm audit in JSON mode.
+ * Run an audit in JSON mode.
  *
- * For v0.1.0 we only support npm; if another package manager
- * is detected we return early without running anything.
+ * Supports npm and pnpm. Both output JSON compatible with our summarize logic.
  */
 export declare function runNpmAuditJson(cwd?: string): Promise<NpmAuditResult>;
 //# sourceMappingURL=npmAudit.d.ts.map

package/dist/lib/audit/npmAudit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"npmAudit.d.ts","sourceRoot":"","sources":["../../../src/lib/audit/npmAudit.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,KAAK,GAAG,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,GAAG,SAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAgBlF"}
+{"version":3,"file":"npmAudit.d.ts","sourceRoot":"","sources":["../../../src/lib/audit/npmAudit.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,KAAK,GAAG,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,GAAG,SAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAkBlF"}

package/dist/lib/audit/npmAudit.js

@@ -1,22 +1,23 @@
 import { detectPackageManager } from "../pm/detect.js";
 import { runPmCommand } from "../pm/run.js";
 /**
- * Run an npm audit in JSON mode.
+ * Run an audit in JSON mode.
  *
- * For v0.1.0 we only support npm; if another package manager
- * is detected we return early without running anything.
+ * Supports npm and pnpm. Both output JSON compatible with our summarize logic.
  */
 export async function runNpmAuditJson(cwd = process.cwd()) {
     const pm = detectPackageManager(cwd);
-    if (pm !== "npm") {
+    if (pm !== "npm" && pm !== "pnpm") {
         return { pm, rawJson: undefined, exitCode: undefined };
     }
-    const { stdout, exitCode } = await runPmCommand(pm, ["audit", "--json"], {
+    const { stdout, stderr, exitCode } = await runPmCommand(pm, ["audit", "--json"], {
         cwd,
     });
+    // pnpm may send JSON to stderr when exitCode is non-zero
+    const rawJson = stdout?.trim() || stderr?.trim();
     return {
         pm,
-        rawJson: stdout,
+        rawJson: rawJson || undefined,
         exitCode,
     };
 }

package/dist/lib/env/ai.d.ts

@@ -0,0 +1,15 @@
+export interface EnvVarEnriched {
+    key: string;
+    description: string;
+    example: string;
+}
+export interface EnvAiOptions {
+    provider: "openai" | "google";
+    model: string;
+    apiKey: string;
+}
+/**
+ * Use AI to generate descriptions and example values for env vars.
+ */
+export declare function enrichEnvVarsWithAi(keys: string[], options: EnvAiOptions): Promise<EnvVarEnriched[]>;
+//# sourceMappingURL=ai.d.ts.map

package/dist/lib/env/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../../src/lib/env/ai.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,cAAc,EAAE,CAAC,CAmB3B"}

package/dist/lib/env/ai.js

@@ -0,0 +1,78 @@
+/**
+ * Use AI to generate descriptions and example values for env vars.
+ */
+export async function enrichEnvVarsWithAi(keys, options) {
+    if (keys.length === 0) {
+        return [];
+    }
+    const prompt = `You are helping generate a .env.example file. For each environment variable name below, provide:
+1. A brief description (one line, what it's used for)
+2. A realistic example value (placeholder, not real secrets)
+
+Return a JSON array only, no markdown. Format: [{"key":"VAR_NAME","description":"...","example":"..."}]
+Keep descriptions under 80 chars. Examples should be realistic placeholders like "localhost", "5432", "sk-xxx", "https://api.example.com".
+
+Variables:
+${keys.join("\n")}`;
+    if (options.provider === "openai") {
+        return callOpenAI(prompt, options.model, options.apiKey);
+    }
+    return callGoogle(prompt, options.model, options.apiKey);
+}
+async function callOpenAI(prompt, model, apiKey) {
+    const res = await fetch("https://api.openai.com/v1/chat/completions", {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify({
+            model,
+            messages: [{ role: "user", content: prompt }],
+            temperature: 0.3,
+        }),
+    });
+    if (!res.ok) {
+        const err = await res.text();
+        throw new Error(`OpenAI API error ${res.status}: ${err}`);
+    }
+    const data = (await res.json());
+    const content = data.choices?.[0]?.message?.content;
+    if (!content)
+        throw new Error("No response from OpenAI");
+    return parseJsonResponse(content);
+}
+async function callGoogle(prompt, model, apiKey) {
+    const url = `https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent?key=${apiKey}`;
+    const res = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            contents: [{ parts: [{ text: prompt }] }],
+            generationConfig: { temperature: 0.3 },
+        }),
+    });
+    if (!res.ok) {
+        const err = await res.text();
+        throw new Error(`Google AI API error ${res.status}: ${err}`);
+    }
+    const data = (await res.json());
+    const text = data.candidates?.[0]?.content?.parts?.[0]?.text;
+    if (!text)
+        throw new Error("No response from Google AI");
+    return parseJsonResponse(text);
+}
+function parseJsonResponse(content) {
+    const cleaned = content.replace(/```json\n?|\n?```/g, "").trim();
+    const parsed = JSON.parse(cleaned);
+    if (!Array.isArray(parsed))
+        throw new Error("AI did not return an array");
+    return parsed.map((item) => {
+        const obj = item;
+        return {
+            key: String(obj.key ?? ""),
+            description: String(obj.description ?? ""),
+            example: String(obj.example ?? ""),
+        };
+    });
+}

package/dist/lib/env/render.d.ts

@@ -1,3 +1,8 @@
 import { EnvScanResult } from "./scan.js";
+import type { EnvVarEnriched } from "./ai.js";
 export declare function renderEnv(result: EnvScanResult): string;
+/**
+ * Render .env.example with AI-generated descriptions and example values.
+ */
+export declare function renderEnvAi(enriched: EnvVarEnriched[]): string;
 //# sourceMappingURL=render.d.ts.map

package/dist/lib/env/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/lib/env/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAgB1C,wBAAgB,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CA6BvD"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/lib/env/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAgB9C,wBAAgB,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CA6BvD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,CA+B9D"}

package/dist/lib/env/render.js

@@ -1,4 +1,4 @@
-const GROUPS = [
+const GROUPS_PREFIX = [
     { prefix: "DB_", heading: "Database" },
     { prefix: "REDIS_", heading: "Redis" },
     { prefix: "AWS_", heading: "AWS" },
@@ -9,7 +9,7 @@ const GROUPS = [
 export function renderEnv(result) {
     const remaining = new Set(result.keys);
     const groups = [];
-    for (const { prefix, heading } of GROUPS) {
+    for (const { prefix, heading } of GROUPS_PREFIX) {
         const keys = result.keys.filter((k) => k.startsWith(prefix));
         if (keys.length === 0)
             continue;
@@ -32,3 +32,34 @@ export function renderEnv(result) {
     }
     return lines.join("\n").trimEnd() + (lines.length ? "\n" : "");
 }
+/**
+ * Render .env.example with AI-generated descriptions and example values.
+ */
+export function renderEnvAi(enriched) {
+    if (enriched.length === 0)
+        return "";
+    const byPrefix = new Map();
+    for (const { prefix, heading } of GROUPS_PREFIX) {
+        const keys = enriched.filter((e) => e.key.startsWith(prefix));
+        if (keys.length > 0) {
+            byPrefix.set(heading, keys);
+        }
+    }
+    const other = enriched.filter((e) => !GROUPS_PREFIX.some(({ prefix }) => e.key.startsWith(prefix)));
+    if (other.length > 0) {
+        byPrefix.set("Other", other.sort((a, b) => a.key.localeCompare(b.key)));
+    }
+    const headings = [...GROUPS_PREFIX.map((g) => g.heading), "Other"].filter((h) => byPrefix.has(h));
+    const lines = [];
+    for (const heading of headings) {
+        const items = byPrefix.get(heading);
+        lines.push(`# ${heading}`);
+        for (const { key, description, example } of items) {
+            if (description)
+                lines.push(`# ${description}`);
+            lines.push(`${key}=${example || ""}`);
+            lines.push("");
+        }
+    }
+    return lines.join("\n").trimEnd() + "\n";
+}

package/dist/lib/env/write.d.ts

@@ -1,8 +1,11 @@
+import { type EnvAiOptions } from "./ai.js";
 export interface EnvGenerateFlags {
     out: string;
     create: boolean;
     force: boolean;
     check: boolean;
+    /** AI options: adds descriptions and example values */
+    ai?: EnvAiOptions;
 }
 export declare function runEnvGenerate(opts?: Partial<EnvGenerateFlags>): Promise<void>;
 //# sourceMappingURL=write.d.ts.map

package/dist/lib/env/write.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../src/lib/env/write.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AAgCD,wBAAsB,cAAc,CAAC,IAAI,GAAE,OAAO,CAAC,gBAAgB,CAAM,iBA8CxE"}
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../src/lib/env/write.ts"],"names":[],"mappings":"AAIA,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAGjE,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,uDAAuD;IACvD,EAAE,CAAC,EAAE,YAAY,CAAC;CACnB;AAgCD,wBAAsB,cAAc,CAAC,IAAI,GAAE,OAAO,CAAC,gBAAgB,CAAM,iBAmDxE"}

package/dist/lib/env/write.js

@@ -1,7 +1,8 @@
 import fs from "node:fs/promises";
 import path from "node:path";
 import { scanEnv } from "./scan.js";
-import { renderEnv } from "./render.js";
+import { renderEnv, renderEnvAi } from "./render.js";
+import { enrichEnvVarsWithAi } from "./ai.js";
 import { logInfo, logError, logSuccess } from "../ui/log.js";
 const defaultEnvFlags = {
     out: ".env.example",
@@ -57,8 +58,14 @@ export async function runEnvGenerate(opts = {}) {
         logSuccess(`${flags.out} contains all required environment variables.`);
         return;
     }
-    // Always (re)write the template example file.
-    const exampleContent = renderEnv(scanResult);
+    let exampleContent;
+    if (flags.ai && scanResult.keys.length > 0) {
+        const enriched = await enrichEnvVarsWithAi(scanResult.keys, flags.ai);
+        exampleContent = renderEnvAi(enriched);
+    }
+    else {
+        exampleContent = renderEnv(scanResult);
+    }
     await fs.writeFile(outPath, exampleContent, "utf8");
     logSuccess(`Wrote environment template to ${outPath}`);
     if (flags.create) {

package/dist/ui/interactive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../src/ui/interactive.ts"],"names":[],"mappings":"AA2LA,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CA6DpD"}
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../src/ui/interactive.ts"],"names":[],"mappings":"AA6NA,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CA6DpD"}

package/dist/ui/interactive.js

@@ -2,7 +2,7 @@ import { readFileSync } from "node:fs";
 import { existsSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import { intro, select, confirm, password, isCancel, cancel } from "@clack/prompts";
+import { intro, select, confirm, password, isCancel, cancel, spinner } from "@clack/prompts";
 import pc from "picocolors";
 import { execute } from "@oclif/core";
 import { config as dotenvConfig } from "dotenv";
@@ -99,14 +99,15 @@ async function runEnvGenerateFlow() {
     const mode = await select({
         message: "📄 How would you like to generate .env.example?",
         options: [
-            { value: "default", label: "Default (fast)" },
-            { value: "ai", label: "AI-assisted" },
+            { value: "default", label: "Default (fast) – variable names only" },
+            { value: "ai", label: "AI-assisted – descriptions + example values (requires API key)" },
         ],
     });
     if (isCancel(mode)) {
         cancel("Cancelled.");
         process.exit(0);
     }
+    let aiOptions;
     if (mode === "ai") {
         const provider = await select({
             message: "🤖 Select AI provider",
@@ -119,8 +120,11 @@ async function runEnvGenerateFlow() {
             cancel("Cancelled.");
             process.exit(0);
         }
+        dotenvConfig({ path: join(getProjectCwd(), ".env") });
+        let model;
+        let apiKey;
         if (provider === "openai") {
-            await select({
+            const modelChoice = await select({
                 message: "🤖 Select model",
                 options: [
                     { value: "gpt-4o", label: "GPT-4o" },
@@ -128,20 +132,27 @@ async function runEnvGenerateFlow() {
                     { value: "gpt-3.5-turbo", label: "GPT-3.5 Turbo" },
                 ],
             });
-            const apiKey = await password({
+            if (isCancel(modelChoice)) {
+                cancel("Cancelled.");
+                process.exit(0);
+            }
+            model = modelChoice;
+            const keyInput = await password({
                 message: "🔑 OpenAI API key (or leave blank to use OPENAI_API_KEY from env)",
                 validate: () => undefined,
             });
-            if (isCancel(apiKey)) {
+            if (isCancel(keyInput)) {
                 cancel("Cancelled.");
                 process.exit(0);
             }
-            if (apiKey && typeof apiKey === "string") {
-                process.env.OPENAI_API_KEY = apiKey;
+            apiKey = (keyInput && typeof keyInput === "string" ? keyInput : process.env.OPENAI_API_KEY) ?? "";
+            if (!apiKey) {
+                logError("OpenAI API key is required for AI-assisted env generation.");
+                return;
             }
         }
-        else if (provider === "google") {
-            await select({
+        else {
+            const modelChoice = await select({
                 message: "🤖 Select model",
                 options: [
                     { value: "gemini-1.5-pro", label: "Gemini 1.5 Pro" },
@@ -149,21 +160,42 @@ async function runEnvGenerateFlow() {
                     { value: "gemini-1.0-pro", label: "Gemini 1.0 Pro" },
                 ],
             });
-            const apiKey = await password({
+            if (isCancel(modelChoice)) {
+                cancel("Cancelled.");
+                process.exit(0);
+            }
+            model = modelChoice;
+            const keyInput = await password({
                 message: "🔑 Google AI API key (or leave blank to use GOOGLE_API_KEY from env)",
                 validate: () => undefined,
             });
-            if (isCancel(apiKey)) {
+            if (isCancel(keyInput)) {
                 cancel("Cancelled.");
                 process.exit(0);
             }
-            if (apiKey && typeof apiKey === "string") {
-                process.env.GOOGLE_API_KEY = apiKey;
+            apiKey = (keyInput && typeof keyInput === "string" ? keyInput : process.env.GOOGLE_API_KEY) ?? "";
+            if (!apiKey) {
+                logError("Google API key is required for AI-assisted env generation.");
+                return;
             }
         }
-        dotenvConfig({ path: join(getProjectCwd(), ".env") });
+        aiOptions = { provider: provider, model, apiKey };
+    }
+    if (aiOptions) {
+        const s = spinner();
+        s.start("Generating .env.example with AI (descriptions + examples)...");
+        try {
+            await runEnvGenerate({ out: ".env.example", ai: aiOptions });
+            s.stop("Done.");
+        }
+        catch (err) {
+            s.stop("Failed.");
+            logError(String(err));
+        }
+    }
+    else {
+        await runEnvGenerate({ out: ".env.example" });
     }
-    await runEnvGenerate({ out: ".env.example" });
 }
 export async function runInteractive() {
     const cwd = getProjectCwd();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "depfix-ai",
-  "version": "0.2.11",
+  "version": "0.2.12",
   "type": "module",
   "license": "MIT",
   "engines": {