autodocs-engine 0.5.0

package/dist/pattern-fingerprinter.js

@@ -0,0 +1,241 @@
+// src/pattern-fingerprinter.ts — W2-2: Pattern Fingerprinting (W5-B3: Simplified)
+// For the top N exports (by import count), analyze the function body AST to
+// extract concrete patterns: actual parameter names, return value keys, internal calls.
+// W5-B3: Removed abstract shapes (error pattern, async pattern, complexity).
+// Produces 1-line summaries per export with concrete details.
+import { readFileSync } from "node:fs";
+import { resolve, extname } from "node:path";
+import ts from "typescript";
+/**
+ * Fingerprint the top N public API exports by analyzing their function bodies.
+ * Returns fingerprints for exports where the source file can be parsed and
+ * the function body can be found.
+ */
+export function fingerprintTopExports(publicAPI, packageDir, topN = 5, warnings = []) {
+    // Select top N non-type exports by import count
+    const candidates = publicAPI
+        .filter((e) => !e.isTypeOnly && e.kind !== "type" && e.kind !== "interface" && e.kind !== "enum")
+        .sort((a, b) => (b.importCount ?? 0) - (a.importCount ?? 0))
+        .slice(0, topN);
+    if (candidates.length === 0)
+        return [];
+    // Group by source file to parse each file once
+    const byFile = new Map();
+    for (const entry of candidates) {
+        const file = entry.sourceFile;
+        if (!byFile.has(file))
+            byFile.set(file, []);
+        byFile.get(file).push(entry);
+    }
+    const fingerprints = [];
+    for (const [relFile, entries] of byFile) {
+        const absPath = resolve(packageDir, relFile);
+        let content;
+        try {
+            content = readFileSync(absPath, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        const ext = extname(absPath).toLowerCase();
+        const scriptKind = ext === ".tsx" ? ts.ScriptKind.TSX :
+            ext === ".jsx" ? ts.ScriptKind.JSX :
+                ext === ".js" ? ts.ScriptKind.JS :
+                    ts.ScriptKind.TS;
+        const sourceFile = ts.createSourceFile(absPath, content, ts.ScriptTarget.Latest, true, scriptKind);
+        for (const entry of entries) {
+            try {
+                const fp = fingerprintExport(sourceFile, entry, relFile);
+                if (fp)
+                    fingerprints.push(fp);
+            }
+            catch (err) {
+                warnings.push({
+                    level: "info",
+                    module: "pattern-fingerprinter",
+                    message: `Could not fingerprint ${entry.name}: ${err instanceof Error ? err.message : String(err)}`,
+                });
+            }
+        }
+    }
+    return fingerprints;
+}
+/**
+ * Analyze a single exported function/hook/component to produce a PatternFingerprint.
+ * W5-B3: Simplified — only extracts params, return shape, internal calls.
+ */
+function fingerprintExport(sourceFile, entry, relFile) {
+    const funcInfo = findExportedFunction(sourceFile, entry.name);
+    if (!funcInfo)
+        return null;
+    const { params, body, returnType } = funcInfo;
+    const parameterShape = analyzeParameterShape(params);
+    const returnShape = returnType
+        ? returnType.getText()
+        : analyzeReturnShape(body);
+    const internalCalls = extractInternalCalls(body);
+    const summary = composeSummary(entry, parameterShape, returnShape, internalCalls);
+    return {
+        exportName: entry.name,
+        sourceFile: relFile,
+        parameterShape,
+        returnShape,
+        internalCalls,
+        // W5-B3: Deprecated fields kept for backward compatibility, set to defaults
+        errorPattern: "none",
+        asyncPattern: "sync",
+        complexity: "simple",
+        summary,
+    };
+}
+function findExportedFunction(sourceFile, name) {
+    for (const stmt of sourceFile.statements) {
+        if (!ts.canHaveModifiers(stmt))
+            continue;
+        const modifiers = ts.getModifiers(stmt);
+        const hasExport = modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword);
+        if (!hasExport)
+            continue;
+        // export function foo(...)
+        if (ts.isFunctionDeclaration(stmt) && stmt.name?.text === name && stmt.body) {
+            return {
+                params: stmt.parameters,
+                body: stmt.body,
+                returnType: stmt.type,
+            };
+        }
+        // export const foo = (...) => ...
+        if (ts.isVariableStatement(stmt)) {
+            for (const decl of stmt.declarationList.declarations) {
+                if (!ts.isIdentifier(decl.name) || decl.name.text !== name)
+                    continue;
+                if (!decl.initializer)
+                    continue;
+                let func;
+                if (ts.isArrowFunction(decl.initializer)) {
+                    func = decl.initializer;
+                }
+                else if (ts.isFunctionExpression(decl.initializer)) {
+                    func = decl.initializer;
+                }
+                else if (ts.isCallExpression(decl.initializer)) {
+                    // React.memo(() => ...) or similar wrapper
+                    const arg = decl.initializer.arguments[0];
+                    if (arg && (ts.isArrowFunction(arg) || ts.isFunctionExpression(arg))) {
+                        func = arg;
+                    }
+                }
+                if (func) {
+                    return {
+                        params: func.parameters,
+                        body: func.body,
+                        returnType: func.type,
+                    };
+                }
+            }
+        }
+    }
+    return null;
+}
+// ---- Parameter Shape Analysis ----
+function analyzeParameterShape(params) {
+    if (params.length === 0)
+        return "no params";
+    if (params.length === 1) {
+        const param = params[0];
+        // Destructured object: ({ foo, bar })
+        if (ts.isObjectBindingPattern(param.name)) {
+            const props = param.name.elements.map((e) => e.name.getText());
+            return `{ ${props.join(", ")} }`;
+        }
+        // Object type annotation
+        if (param.type && ts.isTypeLiteralNode(param.type)) {
+            const props = param.type.members
+                .filter(ts.isPropertySignature)
+                .map((m) => m.name?.getText() ?? "?");
+            return `{ ${props.join(", ")} }`;
+        }
+        // Type reference (e.g., Options, Config)
+        if (param.type && ts.isTypeReferenceNode(param.type)) {
+            return `${param.name.getText()}: ${param.type.getText()}`;
+        }
+        return `${param.name.getText()}: ${param.type?.getText() ?? "unknown"}`;
+    }
+    return `(${params.map((p) => p.name.getText()).join(", ")})`;
+}
+// ---- Return Shape Analysis ----
+function analyzeReturnShape(body) {
+    const returnExprs = [];
+    function walk(node) {
+        if (ts.isReturnStatement(node) && node.expression) {
+            // Object literal return
+            if (ts.isObjectLiteralExpression(node.expression)) {
+                const props = node.expression.properties
+                    .map((p) => {
+                    if (ts.isPropertyAssignment(p) || ts.isShorthandPropertyAssignment(p)) {
+                        return p.name?.getText() ?? "?";
+                    }
+                    if (ts.isSpreadAssignment(p))
+                        return "...spread";
+                    return "?";
+                });
+                returnExprs.push(`{ ${props.join(", ")} }`);
+                return;
+            }
+            // JSX return
+            if (ts.isJsxElement(node.expression) || ts.isJsxSelfClosingElement(node.expression) || ts.isJsxFragment(node.expression)) {
+                returnExprs.push("JSX.Element");
+                return;
+            }
+            // Parenthesized JSX
+            if (ts.isParenthesizedExpression(node.expression)) {
+                const inner = node.expression.expression;
+                if (ts.isJsxElement(inner) || ts.isJsxSelfClosingElement(inner) || ts.isJsxFragment(inner)) {
+                    returnExprs.push("JSX.Element");
+                    return;
+                }
+            }
+            returnExprs.push("value");
+        }
+        ts.forEachChild(node, walk);
+    }
+    walk(body);
+    if (returnExprs.length === 0)
+        return "void";
+    const unique = [...new Set(returnExprs)];
+    return unique[0];
+}
+// ---- Internal Calls ----
+function extractInternalCalls(body) {
+    const calls = new Set();
+    function walk(node) {
+        if (ts.isCallExpression(node)) {
+            if (ts.isIdentifier(node.expression)) {
+                calls.add(node.expression.text);
+            }
+            else if (ts.isPropertyAccessExpression(node.expression) && ts.isIdentifier(node.expression.name)) {
+                const name = node.expression.name.text;
+                const obj = node.expression.expression;
+                if (ts.isIdentifier(obj)) {
+                    calls.add(`${obj.text}.${name}`);
+                }
+            }
+        }
+        ts.forEachChild(node, walk);
+    }
+    walk(body);
+    return [...calls].slice(0, 15);
+}
+// ---- Summary Composition ----
+function composeSummary(entry, parameterShape, returnShape, internalCalls) {
+    const kind = entry.kind === "hook" ? "Custom hook" :
+        entry.kind === "component" ? "React component" :
+            entry.kind === "function" ? "Function" : "Export";
+    const paramPart = parameterShape === "no params" ? "" : ` accepting ${parameterShape}`;
+    const callPart = internalCalls.length > 0
+        ? `, uses ${internalCalls.slice(0, 4).join(", ")}`
+        : "";
+    const returnPart = returnShape !== "void" ? `, returns ${returnShape}` : "";
+    return `${kind}${paramPart}${callPart}${returnPart}`;
+}
+//# sourceMappingURL=pattern-fingerprinter.js.map

package/dist/pattern-fingerprinter.js.map

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

package/dist/pipeline.d.ts

@@ -0,0 +1,5 @@
+import type { ResolvedConfig, StructuredAnalysis } from "./types.js";
+/**
+ * Run the full analysis pipeline for all packages.
+ */
+export declare function runPipeline(config: ResolvedConfig): Promise<StructuredAnalysis>;

package/dist/pipeline.js

@@ -0,0 +1,374 @@
+// src/pipeline.ts — Pipeline Orchestrator
+// Errata applied: E-31 (publicAPI before Architecture Detector), E-39 (warnings to all modules)
+import { readFileSync } from "node:fs";
+import { basename, join } from "node:path";
+import { discoverFiles } from "./file-discovery.js";
+import { parseFile } from "./ast-parser.js";
+import { buildSymbolGraph } from "./symbol-graph.js";
+import { classifyTiers } from "./tier-classifier.js";
+import { extractConventions } from "./convention-extractor.js";
+import { extractCommands, scanWorkspaceCommands } from "./command-extractor.js";
+import { detectArchitecture } from "./architecture-detector.js";
+import { buildPublicAPI, buildPackageAnalysis, buildStructuredAnalysis } from "./analysis-builder.js";
+import { analyzeCrossPackage } from "./cross-package.js";
+import { inferRole } from "./role-inferrer.js";
+import { deriveAntiPatterns } from "./anti-pattern-detector.js";
+import { detectContributionPatterns } from "./contribution-patterns.js";
+import { classifyImpacts } from "./impact-classifier.js";
+import { analyzeConfig } from "./config-analyzer.js";
+import { generateWorkflowRules } from "./workflow-rules.js";
+import { fingerprintTopExports } from "./pattern-fingerprinter.js";
+import { analyzeDependencies } from "./dependency-analyzer.js";
+import { detectExistingDocs } from "./existing-docs.js";
+import { extractExamples } from "./example-extractor.js";
+import { generateDependencyDiagram } from "./mermaid-generator.js";
+import { detectMetaTool } from "./meta-tool-detector.js";
+import { computeImportChain, generateImportChainRules } from "./import-chain.js";
+import { mineGitHistory, generateCoChangeRules } from "./git-history.js";
+/** Verbose logger — writes to stderr only when verbose is enabled. */
+function vlog(verbose, msg) {
+    if (verbose)
+        process.stderr.write(`[INFO] ${msg}\n`);
+}
+/**
+ * Run the full analysis pipeline for all packages.
+ */
+export async function runPipeline(config) {
+    const warnings = [];
+    const startTime = performance.now();
+    const packageAnalyses = [];
+    const verbose = config.verbose;
+    // Git history mining — run once at repo level, distribute to packages
+    const gitHistoryMap = mineGitHistory(config.rootDir ?? config.packages[0], config.packages, warnings);
+    if (gitHistoryMap) {
+        vlog(verbose, `Git history: mined for ${gitHistoryMap.size} package(s)`);
+    }
+    for (const pkgPath of config.packages) {
+        try {
+            const analysis = analyzePackage(pkgPath, config, warnings);
+            // Attach pre-computed git history for this package
+            const pkgGitHistory = gitHistoryMap?.get(pkgPath);
+            if (pkgGitHistory) {
+                analysis.gitHistory = pkgGitHistory;
+                vlog(verbose, `  Git co-change: ${pkgGitHistory.coChangeEdges.length} edges (${pkgGitHistory.totalCommitsAnalyzed} commits analyzed)`);
+            }
+            packageAnalyses.push(analysis);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            warnings.push({
+                level: "error",
+                module: "pipeline",
+                message: `Failed to analyze ${pkgPath}: ${msg}`,
+            });
+        }
+    }
+    // Cross-package analysis (if >1 package)
+    let crossPackage;
+    let workspaceCommands = [];
+    let rootCommands;
+    if (packageAnalyses.length > 1) {
+        vlog(verbose, `Running cross-package analysis for ${packageAnalyses.length} packages...`);
+        rootCommands = config.rootDir
+            ? extractCommands(config.rootDir, undefined, warnings)
+            : undefined;
+        crossPackage = analyzeCrossPackage(packageAnalyses, rootCommands);
+        if (crossPackage) {
+            vlog(verbose, `  Dependency edges: ${crossPackage.dependencyGraph.length}`);
+            vlog(verbose, `  Shared conventions: ${crossPackage.sharedConventions.length}`);
+            vlog(verbose, `  Divergent conventions: ${crossPackage.divergentConventions.length}`);
+        }
+        // W5-C3: Generate Mermaid dependency diagram
+        if (crossPackage && crossPackage.dependencyGraph.length > 0) {
+            const mermaidDiagram = generateDependencyDiagram(packageAnalyses, crossPackage.dependencyGraph);
+            if (mermaidDiagram) {
+                crossPackage.mermaidDiagram = mermaidDiagram;
+                vlog(verbose, `  Mermaid diagram: ${crossPackage.dependencyGraph.length} edges rendered`);
+            }
+        }
+        // W3-1: Workspace-wide command scanning (multi-package only)
+        if (config.rootDir) {
+            const analyzedPkgNames = new Set(packageAnalyses.map((p) => p.name));
+            workspaceCommands = scanWorkspaceCommands(config.rootDir, warnings, analyzedPkgNames);
+            if (workspaceCommands.length > 0) {
+                vlog(verbose, `  Workspace commands: ${workspaceCommands.length} operational commands found`);
+                if (crossPackage) {
+                    crossPackage.workspaceCommands = workspaceCommands;
+                }
+            }
+        }
+    }
+    // Workflow rule generation — runs for ALL analyses (single and multi-package)
+    const firstConfig = packageAnalyses.find((p) => p.configAnalysis)?.configAnalysis;
+    const workflowRules = generateWorkflowRules({
+        workspaceCommands,
+        rootCommands,
+        packageCommands: packageAnalyses.map((p) => ({
+            packageName: p.name,
+            commands: p.commands,
+        })),
+        configAnalysis: firstConfig,
+        allDependencyInsights: packageAnalyses
+            .map((p) => p.dependencyInsights)
+            .filter((d) => d != null),
+        allConventions: packageAnalyses.flatMap((p) => p.conventions),
+    });
+    // Add import-chain rules (from file-to-file coupling analysis)
+    const allImportChainEdges = packageAnalyses.flatMap((p) => p.importChain ?? []);
+    const importChainRules = generateImportChainRules(allImportChainEdges);
+    if (importChainRules.length > 0) {
+        vlog(verbose, `Import chain rules: ${importChainRules.length} high-coupling rules generated`);
+        workflowRules.push(...importChainRules);
+    }
+    // Add co-change rules from git history (structured dedup against import-chain)
+    const importChainCoveredFiles = new Set(allImportChainEdges.map((e) => e.source));
+    const coChangeRules = generateCoChangeRules(packageAnalyses.flatMap((p) => p.gitHistory?.coChangeEdges ?? []), importChainCoveredFiles);
+    if (coChangeRules.length > 0) {
+        vlog(verbose, `Co-change rules: ${coChangeRules.length} rules from git history`);
+        workflowRules.push(...coChangeRules);
+    }
+    if (workflowRules.length > 0) {
+        vlog(verbose, `Workflow rules: ${workflowRules.length} total rules generated`);
+        // For single-package, create a minimal crossPackage to hold the rules
+        if (!crossPackage) {
+            crossPackage = {
+                dependencyGraph: [],
+                sharedConventions: [],
+                divergentConventions: [],
+                sharedAntiPatterns: [],
+                workflowRules,
+            };
+        }
+        else {
+            crossPackage.workflowRules = workflowRules;
+        }
+    }
+    const totalMs = Math.round(performance.now() - startTime);
+    vlog(verbose, `Total analysis time: ${totalMs}ms`);
+    return buildStructuredAnalysis(packageAnalyses, crossPackage, config, warnings, startTime);
+}
+function analyzePackage(pkgPath, config, warnings) {
+    const verbose = config.verbose;
+    const pkgStart = performance.now();
+    vlog(verbose, `Analyzing ${basename(pkgPath)}...`);
+    // Step 1: File Discovery (E-39: pass warnings)
+    const files = discoverFiles(pkgPath, config.exclude, warnings);
+    // Step 2: AST Parser (E-39: pass warnings)
+    const parsed = files
+        .map((f) => {
+        try {
+            return parseFile(f, pkgPath, warnings);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            warnings.push({
+                level: "warn",
+                module: "ast-parser",
+                message: msg,
+                file: f,
+            });
+            return null;
+        }
+    })
+        .filter(Boolean);
+    // Step 3: Symbol Graph Builder (E-39: pass warnings)
+    const symbolGraph = buildSymbolGraph(parsed, pkgPath, warnings);
+    // Compute file-to-file import coupling before symbolGraph is discarded
+    const importChain = computeImportChain(symbolGraph, pkgPath, warnings);
+    if (importChain.length > 0) {
+        vlog(verbose, `  Import chain: ${importChain.length} high-coupling file pairs`);
+    }
+    // Step 4: Tier Classifier
+    const tiers = classifyTiers(parsed, symbolGraph, symbolGraph.barrelFile);
+    // Verbose: tier counts
+    if (verbose) {
+        let t1 = 0, t2 = 0, t3 = 0;
+        for (const [, info] of tiers) {
+            if (info.tier === 1)
+                t1++;
+            else if (info.tier === 2)
+                t2++;
+            else
+                t3++;
+        }
+        vlog(verbose, `  Files discovered: ${parsed.length} (${t1} T1, ${t2} T2, ${t3} T3)`);
+    }
+    // E-31: Compute publicAPI BEFORE Architecture Detector
+    const publicAPI = buildPublicAPI(symbolGraph, parsed, config.maxPublicAPIEntries, warnings);
+    vlog(verbose, `  Public API: ${publicAPI.length} exports`);
+    // Steps 5-7: Run analysis modules (E-39: pass warnings)
+    // Improvement 1 & 2: Config and dependency analysis needed before convention extraction
+    // (moved up so detectors can use context)
+    const configAnalysis = analyzeConfig(pkgPath, config.rootDir, warnings);
+    vlog(verbose, `  Config: build=${configAnalysis.buildTool?.name ?? "none"}, linter=${configAnalysis.linter?.name ?? "none"}, formatter=${configAnalysis.formatter?.name ?? "none"}`);
+    // Collect all imported module specifiers from source files for import-verified framework detection
+    // Excludes type-only imports — they don't indicate runtime framework usage
+    const allImportedModules = new Set();
+    for (const pf of parsed) {
+        for (const imp of pf.imports) {
+            if (imp.isTypeOnly)
+                continue;
+            const spec = imp.moduleSpecifier;
+            if (spec.startsWith(".") || spec.startsWith("/"))
+                continue;
+            const parts = spec.split("/");
+            const basePkg = spec.startsWith("@") ? parts.slice(0, 2).join("/") : parts[0];
+            allImportedModules.add(basePkg);
+        }
+    }
+    const dependencyInsights = analyzeDependencies(pkgPath, config.rootDir, warnings, allImportedModules);
+    vlog(verbose, `  Dependencies: ${dependencyInsights.frameworks.length} frameworks, runtime=${dependencyInsights.runtime.map((r) => r.name).join("+") || "node"}`);
+    // Meta-tool detection (before conventions — informs format-time reclassification)
+    let pkgJsonRaw = null;
+    try {
+        pkgJsonRaw = JSON.parse(readFileSync(join(pkgPath, "package.json"), "utf-8"));
+    }
+    catch { /* no package.json */ }
+    const metaToolResult = (!config.noMetaTool && pkgJsonRaw)
+        ? detectMetaTool({
+            parsedFiles: parsed,
+            tiers,
+            dependencies: (pkgJsonRaw.dependencies ?? {}),
+            devDependencies: (pkgJsonRaw.devDependencies ?? {}),
+            peerDeps: (pkgJsonRaw.peerDependencies ?? {}),
+            threshold: config.metaToolThreshold,
+        }, warnings)
+        : { isMetaTool: false, signal: "none", supportedFamilies: [], coreFamilies: [] };
+    if (metaToolResult.isMetaTool) {
+        vlog(verbose, `  Meta-tool: ${metaToolResult.signal} (${metaToolResult.supportedFamilies.length} families, core: ${metaToolResult.coreFamilies.join(", ") || "none"})`);
+    }
+    // Read root devDeps for test framework fallback in monorepos
+    let rootDevDeps;
+    if (config.rootDir) {
+        try {
+            const rootPkg = JSON.parse(readFileSync(join(config.rootDir, "package.json"), "utf-8"));
+            rootDevDeps = rootPkg.devDependencies;
+        }
+        catch {
+            // skip
+        }
+    }
+    // W2-3: Pass dependency and config context to convention detectors
+    const conventions = extractConventions(parsed, tiers, config.conventions.disable, warnings, { dependencies: dependencyInsights, config: configAnalysis, rootDevDeps });
+    vlog(verbose, `  Conventions: ${conventions.length} detected`);
+    // Improvement 4: Existing docs detection
+    const existingDocs = detectExistingDocs(pkgPath, warnings);
+    if (existingDocs.hasAgentsMd || existingDocs.hasClaudeMd) {
+        vlog(verbose, `  Existing docs: ${existingDocs.hasAgentsMd ? "AGENTS.md" : ""}${existingDocs.hasClaudeMd ? " CLAUDE.md" : ""}`);
+    }
+    const commands = extractCommands(pkgPath, config.rootDir, warnings);
+    // Improvement 1 integration: Override commands with build tool info (turbo, nx)
+    if (configAnalysis.buildTool && configAnalysis.buildTool.name !== "none") {
+        adjustCommandsForBuildTool(commands, configAnalysis.buildTool, warnings);
+    }
+    const cmdList = [
+        commands.build && "build",
+        commands.test && "test",
+        commands.lint && "lint",
+        commands.start && "start",
+    ].filter(Boolean);
+    vlog(verbose, `  Commands: ${commands.packageManager} (${cmdList.join(", ") || "none"})`);
+    const architecture = detectArchitecture(parsed, pkgPath, publicAPI, symbolGraph.barrelFile, warnings);
+    // Enhancement 1: Role inference
+    const partialAnalysis = buildPackageAnalysis(pkgPath, config.rootDir, parsed, symbolGraph, tiers, conventions, commands, architecture, publicAPI, warnings);
+    const role = inferRole(partialAnalysis);
+    if (metaToolResult.isMetaTool) {
+        role.summary += ` — integrates with ${metaToolResult.supportedFamilies.length} framework ecosystems`;
+    }
+    vlog(verbose, `  Role: ${role.summary}`);
+    // Enhancement 3: Anti-pattern derivation
+    const antiPatterns = deriveAntiPatterns(conventions);
+    vlog(verbose, `  Anti-patterns: ${antiPatterns.length} derived`);
+    // Enhancement 4: Contribution patterns
+    const contributionPatterns = detectContributionPatterns(parsed, publicAPI, tiers, architecture.directories, symbolGraph.barrelFile);
+    vlog(verbose, `  Contribution patterns: ${contributionPatterns.length} detected`);
+    // Impact classification
+    const classified = classifyImpacts(conventions, antiPatterns);
+    vlog(verbose, `  Impact: ${classified.conventions.filter((c) => c.impact === "high").length} high, ${classified.conventions.filter((c) => c.impact === "medium").length} medium, ${classified.conventions.filter((c) => c.impact === "low").length} low`);
+    // Improvement 3: Call graph logging
+    if (symbolGraph.callGraph.length > 0) {
+        vlog(verbose, `  Call graph: ${symbolGraph.callGraph.length} edges`);
+    }
+    // W2-2: Pattern fingerprinting for top exports
+    const patternFingerprints = fingerprintTopExports(publicAPI, pkgPath, 5, warnings);
+    if (patternFingerprints.length > 0) {
+        vlog(verbose, `  Pattern fingerprints: ${patternFingerprints.length} exports analyzed`);
+    }
+    // W5-C1: Extract usage examples from test files
+    const examples = extractExamples(publicAPI, parsed, pkgPath, 10, warnings);
+    if (examples.length > 0) {
+        vlog(verbose, `  Usage examples: ${examples.length} extracted from test files`);
+    }
+    const pkgMs = Math.round(performance.now() - pkgStart);
+    vlog(verbose, `  Analysis time: ${pkgMs}ms`);
+    return {
+        ...partialAnalysis,
+        conventions: classified.conventions,
+        role,
+        antiPatterns: classified.antiPatterns,
+        contributionPatterns,
+        configAnalysis,
+        dependencyInsights,
+        existingDocs,
+        callGraph: symbolGraph.callGraph.length > 0 ? symbolGraph.callGraph : undefined,
+        importChain: importChain.length > 0 ? importChain : undefined,
+        patternFingerprints: patternFingerprints.length > 0 ? patternFingerprints : undefined,
+        examples: examples.length > 0 ? examples : undefined,
+        isMetaTool: metaToolResult.isMetaTool || undefined,
+        metaToolInfo: metaToolResult.isMetaTool ? {
+            signal: metaToolResult.signal,
+            supportedFamilies: metaToolResult.supportedFamilies,
+            coreFamilies: metaToolResult.coreFamilies,
+        } : undefined,
+    };
+}
+/**
+ * Improvement 1: Adjust commands based on detected build tool (turbo, nx).
+ * If turbo.json defines tasks like "build", "test", "lint", "dev",
+ * use "turbo run <task>" instead of "<pm> run <script>".
+ */
+function adjustCommandsForBuildTool(commands, buildTool, _warnings) {
+    if (buildTool.name !== "turbo" && buildTool.name !== "nx")
+        return;
+    const prefix = buildTool.name === "turbo" ? "turbo run" : "nx run";
+    const taskSet = new Set(buildTool.taskNames);
+    const mapping = {
+        build: "build",
+        test: "test",
+        lint: "lint",
+        dev: "start",
+        start: "start",
+    };
+    for (const [taskName, cmdField] of Object.entries(mapping)) {
+        if (!taskSet.has(taskName))
+            continue;
+        const existing = commands[cmdField];
+        if (existing) {
+            // Keep the existing as a variant, use turbo as primary
+            const turboCmd = `${prefix} ${taskName}`;
+            if (existing.run !== turboCmd) {
+                if (!existing.variants)
+                    existing.variants = [];
+                existing.variants.push({ name: "package-level", run: existing.run });
+                existing.run = turboCmd;
+                existing.source = `${buildTool.configFile} tasks.${taskName}`;
+            }
+        }
+        else {
+            // Create new command from turbo task
+            const newCmd = {
+                run: `${prefix} ${taskName}`,
+                source: `${buildTool.configFile} tasks.${taskName}`,
+            };
+            if (cmdField === "build")
+                commands.build = newCmd;
+            else if (cmdField === "test")
+                commands.test = newCmd;
+            else if (cmdField === "lint")
+                commands.lint = newCmd;
+            else if (cmdField === "start")
+                commands.start = newCmd;
+        }
+    }
+}
+//# sourceMappingURL=pipeline.js.map