sadrazam 0.1.8 → 0.1.10

package/dist/init.js

@@ -0,0 +1,219 @@
+import { access, mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import * as readline from "node:readline";
+import { findNearestPackageJson, readPackageJson } from "./packageReader.js";
+export async function runInit(targetDir) {
+    const absoluteDir = path.resolve(targetDir);
+    const configPath = path.join(absoluteDir, "sadrazam.json");
+    const promptSession = await createPromptSession();
+    try {
+        // Check if config already exists
+        if (await fileExists(configPath)) {
+            const answer = await promptSession.ask("sadrazam.json already exists. Overwrite? (y/N) ");
+            if (answer.trim().toLowerCase() !== "y") {
+                console.log("Aborted.");
+                return;
+            }
+        }
+        const context = await detectContext(absoluteDir);
+        const config = await promptConfig(context, promptSession.ask);
+        await mkdir(absoluteDir, { recursive: true });
+        await writeFile(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+        console.log(`\nCreated sadrazam.json`);
+        if (Object.keys(config).length === 0) {
+            console.log("No options selected — using all defaults.");
+        }
+        else {
+            console.log("\nConfiguration summary:");
+            for (const [key, value] of Object.entries(config)) {
+                console.log(`  ${key}: ${JSON.stringify(value)}`);
+            }
+        }
+        console.log("\nRun `sadrazam .` to start scanning.");
+    }
+    finally {
+        promptSession.close();
+    }
+}
+async function createPromptSession() {
+    if (!process.stdin.isTTY) {
+        const answers = splitInputLines(await readAllStdin());
+        let index = 0;
+        return {
+            ask: async (question) => {
+                process.stdout.write(question);
+                const answer = answers[index] ?? "";
+                index += 1;
+                return answer;
+            },
+            close: () => { },
+        };
+    }
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        terminal: true,
+    });
+    return {
+        ask: makeReadlineAsker(rl),
+        close: () => rl.close(),
+    };
+}
+async function readAllStdin() {
+    let input = "";
+    process.stdin.setEncoding("utf8");
+    for await (const chunk of process.stdin) {
+        input += chunk;
+    }
+    return input;
+}
+function splitInputLines(input) {
+    return input.replace(/\r\n/g, "\n").replace(/\r/g, "\n").split("\n");
+}
+function makeReadlineAsker(rl) {
+    let closed = false;
+    rl.on("close", () => { closed = true; });
+    return (question) => new Promise((resolve) => {
+        if (closed) {
+            resolve("");
+            return;
+        }
+        let settled = false;
+        const settle = (value) => {
+            if (!settled) {
+                settled = true;
+                resolve(value);
+            }
+        };
+        rl.question(question, settle);
+        rl.once("close", () => settle(""));
+    });
+}
+async function promptConfig(context, ask) {
+    const config = {};
+    console.log(`\nInitializing sadrazam for ${context.packageName}`);
+    console.log("Press Enter to accept defaults, or type a value.\n");
+    // Reporter
+    const reporter = await ask("Default reporter? (text/json/markdown/sarif) [text]: ");
+    const trimmedReporter = reporter.trim();
+    if (trimmedReporter && trimmedReporter !== "text") {
+        const valid = ["text", "json", "toon", "markdown", "sarif"];
+        if (valid.includes(trimmedReporter)) {
+            config.reporter = trimmedReporter;
+        }
+        else {
+            console.log(`  Unknown reporter "${trimmedReporter}", using text.`);
+        }
+    }
+    // Cache
+    const cache = await ask("Enable cache by default? (y/N) [y]: ");
+    const cacheVal = cache.trim().toLowerCase() || "y";
+    if (cacheVal === "y") {
+        config.cache = true;
+    }
+    // Production mode
+    const production = await ask("Scan production files only? (y/N) [N]: ");
+    if (production.trim().toLowerCase() === "y") {
+        config.production = true;
+        // Strict mode (only relevant with production)
+        const strict = await ask("Enable strict mode (flag devDeps in production files)? (y/N) [N]: ");
+        if (strict.trim().toLowerCase() === "y") {
+            config.strict = true;
+        }
+    }
+    // Exclude finding types
+    console.log("\nFinding types: missing, unused-dependencies, unused-devDependencies,");
+    console.log("               misplaced-devDependencies, unused-files, unused-exports");
+    const exclude = await ask("Exclude any finding types? (comma-separated, or Enter to skip): ");
+    const excludeList = exclude
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    if (excludeList.length > 0) {
+        config.exclude = excludeList;
+    }
+    // Monorepo workspace filter
+    if (context.isMonorepo) {
+        const workspace = await ask("Filter to specific workspaces? (comma-separated names, or Enter to scan all): ");
+        const workspaceList = workspace
+            .split(",")
+            .map((s) => s.trim())
+            .filter(Boolean);
+        if (workspaceList.length > 0) {
+            config.workspace = workspaceList;
+        }
+    }
+    // Allowlists
+    const allowUnused = await ask("Allow specific unused dependencies? (comma-separated, or Enter to skip): ");
+    const allowUnusedList = allowUnused
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    if (allowUnusedList.length > 0) {
+        config.allowUnusedDependencies = allowUnusedList;
+    }
+    const ignorePackages = await ask("Ignore specific packages in all findings? (comma-separated, or Enter to skip): ");
+    const ignoreList = ignorePackages
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    if (ignoreList.length > 0) {
+        config.ignorePackages = ignoreList;
+    }
+    // AI
+    const ai = await ask("Configure AI summary? (y/N) [N]: ");
+    if (ai.trim().toLowerCase() === "y") {
+        const provider = await ask("AI provider? (openai/anthropic/gemini) [openai]: ");
+        const trimmedProvider = provider.trim() || "openai";
+        config.ai = { provider: trimmedProvider };
+        const model = await ask("AI model? (Enter for provider default): ");
+        if (model.trim()) {
+            config.ai.model = model.trim();
+        }
+    }
+    return config;
+}
+async function detectContext(packageDir) {
+    try {
+        const packagePath = await findNearestPackageJson(packageDir);
+        const packageJson = (await readPackageJson(packagePath));
+        const allDeps = {
+            ...packageJson.dependencies,
+            ...packageJson.devDependencies,
+        };
+        const isMonorepo = Array.isArray(packageJson.workspaces) ||
+            (typeof packageJson.workspaces === "object" &&
+                Array.isArray(packageJson.workspaces.packages)) ||
+            (await fileExists(path.join(packageDir, "pnpm-workspace.yaml")));
+        return {
+            isMonorepo,
+            hasTypeScript: "typescript" in allDeps,
+            hasVitest: "vitest" in allDeps,
+            hasJest: "jest" in allDeps,
+            hasEslint: "eslint" in allDeps,
+            hasPrettier: "prettier" in allDeps,
+            packageName: packageJson.name ?? path.basename(packageDir),
+        };
+    }
+    catch {
+        return {
+            isMonorepo: false,
+            hasTypeScript: false,
+            hasVitest: false,
+            hasJest: false,
+            hasEslint: false,
+            hasPrettier: false,
+            packageName: path.basename(packageDir),
+        };
+    }
+}
+async function fileExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

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

package/dist/oxcParser.d.ts

@@ -0,0 +1,3 @@
+import type { FileSymbols } from "./symbolParser.js";
+export declare function parseFileSymbolsWithOxc(source: string, ignoredExportNames?: string[], filename?: string): FileSymbols | null;
+//# sourceMappingURL=oxcParser.d.ts.map

package/dist/oxcParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oxcParser.d.ts","sourceRoot":"","sources":["../src/oxcParser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,mBAAmB,CAAC;AAErE,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,kBAAkB,GAAE,MAAM,EAAO,EACjC,QAAQ,SAAe,GACtB,WAAW,GAAG,IAAI,CAiFpB"}

package/dist/oxcParser.js

@@ -0,0 +1,188 @@
+import { parseSync } from "oxc-parser";
+export function parseFileSymbolsWithOxc(source, ignoredExportNames = [], filename = "source.tsx") {
+    let result;
+    try {
+        result = parseSync(filename, source, { sourceType: "unambiguous" });
+    }
+    catch {
+        return null;
+    }
+    if (result.errors.some((error) => error.severity === "Error")) {
+        return null;
+    }
+    const allSpecifiers = new Set();
+    const references = [];
+    const exportedNames = new Set();
+    for (const staticImport of result.module.staticImports) {
+        const specifier = staticImport.moduleRequest.value.trim();
+        if (!specifier) {
+            continue;
+        }
+        allSpecifiers.add(specifier);
+        if (staticImport.entries.length === 0) {
+            continue;
+        }
+        references.push({
+            specifier,
+            importedNames: parseOxcImportNames(staticImport.entries),
+            usesAllExports: staticImport.entries.some((entry) => entry.importName.kind === "NamespaceObject"),
+        });
+    }
+    for (const dynamicImport of result.module.dynamicImports) {
+        const specifier = readModuleRequest(source, dynamicImport.moduleRequest);
+        if (specifier) {
+            allSpecifiers.add(specifier);
+            references.push({ specifier, importedNames: [], usesAllExports: true });
+        }
+    }
+    for (const staticExport of result.module.staticExports) {
+        for (const entry of staticExport.entries) {
+            if (entry.moduleRequest) {
+                const specifier = entry.moduleRequest.value.trim();
+                if (!specifier) {
+                    continue;
+                }
+                allSpecifiers.add(specifier);
+                references.push({
+                    specifier,
+                    importedNames: parseOxcExportImportNames(entry.importName),
+                    usesAllExports: entry.importName.kind === "All"
+                        || entry.importName.kind === "AllButDefault",
+                });
+                continue;
+            }
+            const exportName = parseOxcExportName(entry.exportName);
+            if (exportName) {
+                exportedNames.add(exportName);
+            }
+        }
+    }
+    collectCommonJsReferences(result.program, allSpecifiers, references);
+    return {
+        allSpecifiers: [...allSpecifiers].sort(),
+        localReferences: dedupeReferences(references),
+        exportedNames: [...exportedNames].sort(),
+        ignoredExportNames,
+    };
+}
+function parseOxcImportNames(entries) {
+    const names = new Set();
+    for (const entry of entries) {
+        if (entry.importName.kind === "Default") {
+            names.add("default");
+        }
+        else if (entry.importName.kind === "Name" && entry.importName.name) {
+            names.add(entry.importName.name);
+        }
+    }
+    return [...names].sort();
+}
+function parseOxcExportImportNames(importName) {
+    return importName.kind === "Name" && importName.name ? [importName.name] : [];
+}
+function parseOxcExportName(exportName) {
+    if (exportName.kind === "Default") {
+        return "default";
+    }
+    return exportName.kind === "Name" ? exportName.name : null;
+}
+function collectCommonJsReferences(program, allSpecifiers, references) {
+    visitNode(program, (node) => {
+        const importEqualsSpecifier = getImportEqualsSpecifier(node);
+        if (importEqualsSpecifier) {
+            allSpecifiers.add(importEqualsSpecifier);
+            references.push({ specifier: importEqualsSpecifier, importedNames: [], usesAllExports: true });
+            return;
+        }
+        if (node.type !== "CallExpression") {
+            return;
+        }
+        const specifier = getRequireCallSpecifier(node);
+        if (specifier) {
+            allSpecifiers.add(specifier);
+            references.push({ specifier, importedNames: [], usesAllExports: true });
+        }
+    });
+}
+function getImportEqualsSpecifier(node) {
+    if (node.type !== "TSImportEqualsDeclaration") {
+        return null;
+    }
+    const moduleReference = node.moduleReference;
+    if (!isRecord(moduleReference) || moduleReference.type !== "TSExternalModuleReference") {
+        return null;
+    }
+    return getStringLiteralValue(moduleReference.expression);
+}
+function getRequireCallSpecifier(node) {
+    const args = Array.isArray(node.arguments) ? node.arguments : [];
+    const specifier = getStringLiteralValue(args[0]);
+    if (!specifier) {
+        return null;
+    }
+    const callee = node.callee;
+    if (isIdentifier(callee, "require")) {
+        return specifier;
+    }
+    if (!isRecord(callee) || callee.type !== "MemberExpression" || callee.computed !== false) {
+        return null;
+    }
+    return isIdentifier(callee.object, "require") && isIdentifier(callee.property, "resolve")
+        ? specifier
+        : null;
+}
+function readModuleRequest(source, span) {
+    return unquoteStringLiteral(source.slice(span.start, span.end).trim());
+}
+function getStringLiteralValue(node) {
+    return isRecord(node) && node.type === "Literal" && typeof node.value === "string"
+        ? node.value
+        : null;
+}
+function unquoteStringLiteral(value) {
+    if (value.length < 2) {
+        return null;
+    }
+    const quote = value[0];
+    const endQuote = value[value.length - 1];
+    if ((quote !== "\"" && quote !== "'" && quote !== "`") || quote !== endQuote) {
+        return null;
+    }
+    return value.slice(1, -1);
+}
+function visitNode(node, visitor) {
+    if (!isRecord(node)) {
+        return;
+    }
+    visitor(node);
+    for (const [key, value] of Object.entries(node)) {
+        if (key === "type" || key === "start" || key === "end") {
+            continue;
+        }
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                visitNode(item, visitor);
+            }
+            continue;
+        }
+        visitNode(value, visitor);
+    }
+}
+function dedupeReferences(references) {
+    const seen = new Set();
+    return references.filter((reference) => {
+        const key = `${reference.specifier}:${reference.usesAllExports}:${reference.importedNames.join(",")}`;
+        if (seen.has(key)) {
+            return false;
+        }
+        seen.add(key);
+        return true;
+    });
+}
+function isIdentifier(node, name) {
+    return isRecord(node) && node.type === "Identifier" && node.name === name;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=oxcParser.js.map

package/dist/oxcParser.js.map

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

package/dist/reporters.d.ts

@@ -30,6 +30,7 @@ export interface RenderReportInput {
     workspaces: ReportWorkspace[];
     trace?: string;
     traceExport?: string;
+    explain?: string;
     aiSummary?: string;
     warnings?: string[];
     configurationHints?: string[];
@@ -63,6 +64,7 @@ export interface RenderReportInput {
         packagePath: string;
         removedDependencies: string[];
         removedDevDependencies: string[];
+        addedDevDependencies: string[];
         formattedFiles: string[];
     }>;
 }

package/dist/reporters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reporters.d.ts","sourceRoot":"","sources":["../src/reporters.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,eAAO,MAAM,mBAAmB,wDAAyD,CAAC;AAE1F,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAChE,MAAM,MAAM,WAAW,GACnB,SAAS,GACT,qBAAqB,GACrB,wBAAwB,GACxB,2BAA2B,GAC3B,cAAc,GACd,gBAAgB,CAAC;AAErB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,eAAe,CAAC;IAC3B,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE;QACb,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,uBAAuB,EAAE,MAAM,EAAE,CAAC;QAClC,0BAA0B,EAAE,MAAM,EAAE,CAAC;QACrC,oBAAoB,EAAE,MAAM,EAAE,CAAC;QAC/B,6BAA6B,EAAE,MAAM,EAAE,CAAC;QACxC,aAAa,EAAE;YACb,eAAe,EAAE,MAAM,EAAE,CAAC;YAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;YACvB,cAAc,EAAE,MAAM,EAAE,CAAC;SAC1B,CAAC;KACH,CAAC;IACF,kBAAkB,CAAC,EAAE;QACnB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,aAAa,CAAC,EAAE;QACd,IAAI,EAAE,UAAU,CAAC;KAClB,CAAC;IACF,EAAE,CAAC,EAAE;QACH,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,YAAY,CAAC,EAAE,KAAK,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,mBAAmB,EAAE,MAAM,EAAE,CAAC;QAC9B,sBAAsB,EAAE,MAAM,EAAE,CAAC;QACjC,cAAc,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC,CAAC;CACJ;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAiO7D"}
+{"version":3,"file":"reporters.d.ts","sourceRoot":"","sources":["../src/reporters.ts"],"names":[],"mappings":"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"}

package/dist/reporters.js

@@ -37,6 +37,9 @@ export function renderReport(input) {
             if (fix.removedDevDependencies.length > 0) {
                 lines.push(`Removed devDependencies: ${fix.removedDevDependencies.join(", ")}`);
             }
+            if (fix.addedDevDependencies.length > 0) {
+                lines.push(`Added devDependencies: ${fix.addedDevDependencies.join(", ")} (version "*" — run npm install to resolve)`);
+            }
             if (fix.formattedFiles.length > 0) {
                 lines.push(`Formatted files: ${fix.formattedFiles.join(", ")}`);
             }
@@ -101,6 +104,9 @@ export function renderReport(input) {
         if (input.memory) {
             lines.push(`Heap used: ${formatMb(result.memory.heapUsedMb)}`);
         }
+        if (input.debug) {
+            lines.push(`Parser: OXC ${result.parseStats.oxcFiles}, fallback ${result.parseStats.fallbackFiles}`);
+        }
         if (findingCount === 0) {
             lines.push(pc.green("No dependency issues found."));
         }
@@ -141,6 +147,11 @@ export function renderReport(input) {
                 }
             }
         }
+        if (input.explain) {
+            lines.push("");
+            lines.push(pc.bold(`Explain: ${input.explain}`));
+            lines.push(...renderExplainLines(input.explain, result, workspace.relativeDir));
+        }
     }
     if (input.debug) {
         lines.push("");
@@ -205,6 +216,10 @@ function buildStructuredReport(input) {
                 scriptCommandPackages: result.scriptCommandPackages,
                 scriptEntryFiles: result.scriptEntryFiles,
                 cached: result.cached,
+                parser: {
+                    oxcFiles: result.parseStats.oxcFiles,
+                    fallbackFiles: result.parseStats.fallbackFiles,
+                },
             },
             findings,
             externalImports: result.externalImports,
@@ -224,6 +239,9 @@ function buildStructuredReport(input) {
                     sources: result.exportTraces[input.traceExport] ?? [],
                 }
                 : null,
+            explain: input.explain
+                ? buildExplainPayload(input.explain, result, workspace.relativeDir)
+                : null,
         })),
     };
 }
@@ -450,4 +468,101 @@ function renderSarifReport(input) {
         ],
     };
 }
+function buildExplainPayload(findingType, result, relativeDir) {
+    const entryFiles = result.scriptEntryFiles;
+    if (findingType === "unused-files") {
+        return {
+            type: findingType,
+            entryFiles,
+            items: result.unusedFiles.map((file) => ({
+                item: file,
+                reason: "Not reachable from any entry point via local imports.",
+            })),
+        };
+    }
+    if (findingType === "unused-exports") {
+        return {
+            type: findingType,
+            entryFiles,
+            items: result.unusedExports.map((entry) => {
+                const [file, exportName] = entry.split(": ");
+                const traceKey = `${file}: ${exportName}`;
+                const importedBy = result.exportTraces[traceKey] ?? [];
+                return {
+                    item: entry,
+                    reason: importedBy.length === 0
+                        ? "Export is not imported by any reachable file."
+                        : "Export exists in traces but was filtered.",
+                    importedBy,
+                };
+            }),
+        };
+    }
+    if (findingType === "unused-dependencies" ||
+        findingType === "unused-devDependencies") {
+        const packages = findingType === "unused-dependencies"
+            ? result.unusedDependencies
+            : result.unusedDevDependencies;
+        return {
+            type: findingType,
+            entryFiles,
+            items: packages.map((pkg) => ({
+                item: pkg,
+                reason: "Package is declared but not imported in any scanned file or script.",
+                importedBy: result.packageTraces[pkg] ?? [],
+            })),
+        };
+    }
+    if (findingType === "missing") {
+        return {
+            type: findingType,
+            entryFiles,
+            items: result.missingPackages.map((pkg) => ({
+                item: pkg,
+                reason: "Package is imported but not declared in package.json.",
+                importedBy: result.packageTraces[pkg] ?? [],
+            })),
+        };
+    }
+    if (findingType === "misplaced-devDependencies") {
+        return {
+            type: findingType,
+            entryFiles,
+            items: result.misplacedDevDependencies.map((pkg) => ({
+                item: pkg,
+                reason: "Package is a devDependency but imported in production files.",
+                importedBy: (result.packageTraces[pkg] ?? []).filter((f) => result.files.find((file) => file.relativePath === f)?.isProduction),
+            })),
+        };
+    }
+    return { type: findingType, entryFiles, items: [] };
+}
+function renderExplainLines(findingType, result, relativeDir) {
+    const payload = buildExplainPayload(findingType, result, relativeDir);
+    const lines = [];
+    if (payload.entryFiles.length > 0) {
+        lines.push(pc.dim(`Entry files: ${payload.entryFiles.join(", ")}`));
+    }
+    else {
+        lines.push(pc.dim("Entry files: none detected"));
+    }
+    if (payload.items.length === 0) {
+        lines.push(pc.green(`No ${findingType} findings to explain.`));
+        return lines;
+    }
+    for (const entry of payload.items) {
+        lines.push("");
+        lines.push(pc.yellow(`  ${entry.item}`));
+        lines.push(pc.dim(`  Reason: ${entry.reason}`));
+        if (entry.importedBy && entry.importedBy.length > 0) {
+            lines.push(pc.dim(`  Imported by: ${entry.importedBy.join(", ")}`));
+        }
+        else if (findingType === "unused-dependencies" ||
+            findingType === "unused-devDependencies" ||
+            findingType === "missing") {
+            lines.push(pc.dim("  Imported by: (none found in scanned files)"));
+        }
+    }
+    return lines;
+}
 //# sourceMappingURL=reporters.js.map