autodocs-engine 0.9.8 → 0.10.0

package/dist/detectors/api-patterns.js

@@ -0,0 +1,101 @@
+// src/detectors/api-patterns.ts — API pattern detector
+// Framework-aware detection: uses DependencyInsights to determine which framework
+// is active, then looks for framework-specific patterns in exports/imports.
+// Does NOT rely on directory name heuristics (routes/, api/, controllers/).
+import { buildConfidence, sourceParsedFiles } from "../convention-extractor.js";
+// Framework-specific detection strategies
+const FRAMEWORK_PATTERNS = {
+    express: {
+        packages: ["express"],
+        label: "Express",
+        description: "Express.js HTTP framework",
+    },
+    fastify: {
+        packages: ["fastify"],
+        label: "Fastify",
+        description: "Fastify HTTP framework",
+    },
+    hono: {
+        packages: ["hono"],
+        label: "Hono",
+        description: "Hono edge-first HTTP framework",
+    },
+    koa: {
+        packages: ["koa", "@koa/router"],
+        label: "Koa",
+        description: "Koa HTTP framework",
+    },
+    nestjs: {
+        packages: ["@nestjs/core", "@nestjs/common"],
+        label: "NestJS",
+        description: "NestJS framework with decorators",
+    },
+    trpc: {
+        packages: ["@trpc/server"],
+        label: "tRPC",
+        description: "tRPC type-safe API framework",
+    },
+    graphql: {
+        packages: ["@apollo/server", "graphql-yoga", "type-graphql", "mercurius"],
+        label: "GraphQL server",
+        description: "GraphQL API server",
+    },
+};
+export const apiPatternsDetector = (files, tiers, _warnings, context) => {
+    const conventions = [];
+    const sourceFiles = sourceParsedFiles(files, tiers);
+    if (sourceFiles.length === 0)
+        return conventions;
+    // Strategy 1: Dependency-based detection (highest confidence)
+    const detectedFromDeps = new Set();
+    if (context?.dependencies?.frameworks) {
+        for (const fw of context.dependencies.frameworks) {
+            for (const [key, pattern] of Object.entries(FRAMEWORK_PATTERNS)) {
+                if (pattern.packages.some((pkg) => fw.name === pkg || fw.name.startsWith(`${pkg}/`))) {
+                    detectedFromDeps.add(key);
+                }
+            }
+        }
+    }
+    // Strategy 2: Import-based detection (fallback + validation)
+    const importCounts = new Map(); // framework key → file count
+    for (const file of sourceFiles) {
+        const fileFrameworks = new Set();
+        for (const imp of file.imports) {
+            if (imp.isTypeOnly)
+                continue;
+            for (const [key, pattern] of Object.entries(FRAMEWORK_PATTERNS)) {
+                if (pattern.packages.some((pkg) => imp.moduleSpecifier === pkg || imp.moduleSpecifier.startsWith(`${pkg}/`))) {
+                    fileFrameworks.add(key);
+                }
+            }
+        }
+        for (const key of fileFrameworks) {
+            importCounts.set(key, (importCounts.get(key) ?? 0) + 1);
+        }
+    }
+    // Merge: deps detection + import validation
+    const detected = new Set([...detectedFromDeps, ...importCounts.keys()]);
+    if (detected.size === 0)
+        return conventions;
+    // Emit one convention per detected API framework
+    for (const key of detected) {
+        const pattern = FRAMEWORK_PATTERNS[key];
+        if (!pattern)
+            continue;
+        const fileCount = importCounts.get(key) ?? 0;
+        // Skip if detected only from deps but no actual imports (monorepo root dep noise)
+        if (fileCount === 0 && !detectedFromDeps.has(key))
+            continue;
+        conventions.push({
+            category: "api-patterns",
+            source: "apiPatterns",
+            name: `${pattern.label} API`,
+            description: `${pattern.description}${fileCount > 0 ? ` (${fileCount} files import from it)` : ""}`,
+            confidence: buildConfidence(Math.max(fileCount, 1), sourceFiles.length),
+            examples: fileCount > 0 ? [`${fileCount} files import from ${pattern.packages[0]}`] : [],
+        });
+    }
+    return conventions;
+};
+//# sourceMappingURL=api-patterns.js.map

package/dist/detectors/api-patterns.js.map

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

package/dist/detectors/async-patterns.d.ts

@@ -0,0 +1,2 @@
+import type { ConventionDetector } from "../types.js";
+export declare const asyncPatternsDetector: ConventionDetector;

package/dist/detectors/async-patterns.js

@@ -0,0 +1,79 @@
+// src/detectors/async-patterns.ts — Async pattern detector
+// Detects: Promise.all/allSettled usage, sequential await anti-patterns, AbortController.
+// Uses ContentSignals: promiseAllCount, asyncFunctionCount, awaitInLoopCount.
+import { buildConfidence, sourceParsedFiles } from "../convention-extractor.js";
+export const asyncPatternsDetector = (files, tiers, _warnings, _context) => {
+    const conventions = [];
+    const sourceFiles = sourceParsedFiles(files, tiers);
+    if (sourceFiles.length === 0)
+        return conventions;
+    // AbortController usage — cancellation pattern (not gated on async functions)
+    let abortControllerFiles = 0;
+    for (const file of sourceFiles) {
+        let found = false;
+        for (const imp of file.imports) {
+            if (imp.isTypeOnly)
+                continue;
+            if (imp.importedNames.includes("AbortController") || imp.importedNames.includes("AbortSignal")) {
+                found = true;
+                break;
+            }
+        }
+        if (!found) {
+            for (const exp of file.exports) {
+                if (exp.signature?.includes("AbortSignal") || exp.signature?.includes("signal")) {
+                    found = true;
+                    break;
+                }
+            }
+        }
+        if (found)
+            abortControllerFiles++;
+    }
+    if (abortControllerFiles >= 2) {
+        conventions.push({
+            category: "async-patterns",
+            source: "asyncPatterns",
+            name: "AbortController cancellation pattern",
+            description: `Uses AbortController/AbortSignal for cancellation (${abortControllerFiles} files)`,
+            confidence: buildConfidence(abortControllerFiles, sourceFiles.length),
+            examples: [],
+        });
+    }
+    // Async-specific patterns require async functions
+    const asyncFiles = sourceFiles.filter((f) => f.contentSignals.asyncFunctionCount > 0);
+    if (asyncFiles.length === 0)
+        return conventions;
+    // Concurrent patterns — Promise.all/allSettled/race
+    const promiseAllFiles = asyncFiles.filter((f) => f.contentSignals.promiseAllCount > 0);
+    if (promiseAllFiles.length > 0) {
+        const ratio = promiseAllFiles.length / asyncFiles.length;
+        if (ratio >= 0.15) {
+            conventions.push({
+                category: "async-patterns",
+                source: "asyncPatterns",
+                name: "Promise.all concurrent pattern",
+                description: `Uses Promise.all/allSettled for concurrent async operations (${promiseAllFiles.length} of ${asyncFiles.length} async files)`,
+                confidence: buildConfidence(promiseAllFiles.length, asyncFiles.length),
+                examples: promiseAllFiles.slice(0, 3).map((f) => f.relativePath),
+            });
+        }
+    }
+    // Sequential await in loops — anti-pattern signal (higher threshold: must be widespread, not incidental)
+    const awaitInLoopFiles = sourceFiles.filter((f) => f.contentSignals.awaitInLoopCount > 0);
+    if (awaitInLoopFiles.length >= 3) {
+        const ratio = awaitInLoopFiles.length / asyncFiles.length;
+        if (ratio >= 0.25) {
+            conventions.push({
+                category: "async-patterns",
+                source: "asyncPatterns",
+                name: "Sequential await in loops",
+                description: `${awaitInLoopFiles.length} file${awaitInLoopFiles.length === 1 ? "" : "s"} contain${awaitInLoopFiles.length === 1 ? "s" : ""} await inside loops — consider Promise.all for independent operations`,
+                confidence: buildConfidence(awaitInLoopFiles.length, asyncFiles.length),
+                examples: awaitInLoopFiles.slice(0, 3).map((f) => f.relativePath),
+            });
+        }
+    }
+    return conventions;
+};
+//# sourceMappingURL=async-patterns.js.map

package/dist/detectors/async-patterns.js.map

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

package/dist/detectors/error-handling.js

@@ -1,47 +1,99 @@
-import { sourceParsedFiles } from "../convention-extractor.js";
-export const errorHandlingDetector = (files, tiers, _warnings) => {
+// src/detectors/error-handling.ts — Error handling pattern detector
+// Detects: custom error classes, Result/Either patterns, error class hierarchies.
+// Does NOT use try/catch density — per adversarial review, that's a false signal
+// (mature codebases use middleware/Result types, not widespread try/catch).
+import { buildConfidence, sourceParsedFiles } from "../convention-extractor.js";
+// Libraries that provide typed error/result patterns
+const RESULT_LIBRARIES = {
+    neverthrow: "neverthrow (Result<T, E>)",
+    "fp-ts": "fp-ts (Either<E, A>)",
+    "oxide.ts": "oxide.ts (Result<T, E>)",
+    effect: "Effect (typed errors via Effect<A, E, R>)",
+    "ts-results": "ts-results (Result<T, E>)",
+    "true-myth": "true-myth (Result<T, E>)",
+};
+// Names that suggest a custom Result/Either type
+const RESULT_EXPORT_NAMES = new Set(["Result", "Ok", "Err", "Either", "Left", "Right", "Success", "Failure"]);
+export const errorHandlingDetector = (files, tiers, _warnings, _context) => {
     const conventions = [];
     const sourceFiles = sourceParsedFiles(files, tiers);
     if (sourceFiles.length === 0)
         return conventions;
-    let tryCatchTotal = 0;
-    let filesWithTryCatch = 0;
-    let errorBoundaryCount = 0;
-    for (const f of sourceFiles) {
-        if (f.contentSignals.tryCatchCount > 0) {
-            tryCatchTotal += f.contentSignals.tryCatchCount;
-            filesWithTryCatch++;
+    // 1. Custom error classes — exports with kind:"class" and name ending in Error/Exception
+    const errorClasses = [];
+    for (const file of sourceFiles) {
+        for (const exp of file.exports) {
+            if (exp.kind === "class" && (/Error$/.test(exp.name) || /Exception$/.test(exp.name))) {
+                errorClasses.push(exp.name);
+            }
         }
-        if (f.contentSignals.hasErrorBoundary)
-            errorBoundaryCount++;
     }
-    if (tryCatchTotal > 0) {
+    if (errorClasses.length >= 2) {
+        // Check for hierarchy pattern: multiple error classes suggest a typed error hierarchy
+        const isHierarchy = errorClasses.length >= 3;
+        const name = isHierarchy ? "Typed error class hierarchy" : "Custom error classes";
+        const description = isHierarchy
+            ? `Uses a hierarchy of ${errorClasses.length} typed error classes (${errorClasses.slice(0, 3).join(", ")}${errorClasses.length > 3 ? `, ...${errorClasses.length - 3} more` : ""})`
+            : `Defines custom error classes: ${errorClasses.join(", ")}`;
         conventions.push({
             category: "error-handling",
-            name: "Try-catch error handling",
-            description: `Uses try-catch blocks for error handling`,
-            confidence: conf(filesWithTryCatch, sourceFiles.length),
-            examples: [`${tryCatchTotal} try-catch blocks in ${filesWithTryCatch} files`],
+            source: "errorHandling",
+            name,
+            description,
+            confidence: buildConfidence(errorClasses.length, errorClasses.length),
+            examples: errorClasses.slice(0, 5),
         });
     }
-    if (errorBoundaryCount > 0) {
+    // 2. Result/Either pattern — check imports for known result-type libraries (count files, not imports)
+    const resultLibraryImports = new Map();
+    for (const file of sourceFiles) {
+        const fileLibs = new Set(); // dedupe per file
+        for (const imp of file.imports) {
+            if (imp.isTypeOnly)
+                continue;
+            for (const [pkg, label] of Object.entries(RESULT_LIBRARIES)) {
+                if (imp.moduleSpecifier === pkg || imp.moduleSpecifier.startsWith(`${pkg}/`)) {
+                    fileLibs.add(label);
+                }
+            }
+        }
+        for (const label of fileLibs) {
+            resultLibraryImports.set(label, (resultLibraryImports.get(label) ?? 0) + 1);
+        }
+    }
+    if (resultLibraryImports.size > 0) {
+        const totalFiles = [...resultLibraryImports.values()].reduce((a, b) => a + b, 0);
+        const libs = [...resultLibraryImports.entries()].sort((a, b) => b[1] - a[1]);
         conventions.push({
             category: "error-handling",
-            name: "Error boundaries",
-            description: `Uses React Error Boundaries for UI error handling`,
-            confidence: conf(errorBoundaryCount, sourceFiles.length),
-            examples: [`${errorBoundaryCount} files reference ErrorBoundary`],
+            source: "errorHandling",
+            name: "Result/Either pattern",
+            description: `Uses ${libs[0][0]} for typed error handling (${totalFiles} files)`,
+            confidence: buildConfidence(totalFiles, sourceFiles.length),
+            examples: libs.map(([lib, count]) => `${lib}: ${count} files`),
         });
     }
+    // 3. Custom Result types — exports named Result/Ok/Err/Either without a library
+    if (resultLibraryImports.size === 0) {
+        const resultExports = [];
+        for (const file of sourceFiles) {
+            for (const exp of file.exports) {
+                if (RESULT_EXPORT_NAMES.has(exp.name) && (exp.kind === "type" || exp.kind === "interface")) {
+                    resultExports.push(exp.name);
+                }
+            }
+        }
+        if (resultExports.length >= 2) {
+            conventions.push({
+                category: "error-handling",
+                source: "errorHandling",
+                name: "Custom Result type pattern",
+                description: `Defines custom Result types: ${[...new Set(resultExports)].join(", ")}`,
+                confidence: buildConfidence(resultExports.length, resultExports.length),
+                examples: [...new Set(resultExports)].slice(0, 5),
+            });
+        }
+    }
     return conventions;
 };
-function conf(matched, total) {
-    const percentage = total > 0 ? Math.round((matched / total) * 100) : 0;
-    return {
-        matched,
-        total,
-        percentage,
-        description: `${matched} of ${total} (${percentage}%)`,
-    };
-}
 //# sourceMappingURL=error-handling.js.map

package/dist/detectors/error-handling.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-handling.js","sourceRoot":"","sources":["../../src/detectors/error-handling.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D,MAAM,CAAC,MAAM,qBAAqB,GAAuB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;IACnF,MAAM,WAAW,GAAiB,EAAE,CAAC;IACrC,MAAM,WAAW,GAAG,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACpD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC;IAEjD,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,IAAI,kBAAkB,GAAG,CAAC,CAAC;IAE3B,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,cAAc,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;YACvC,aAAa,IAAI,CAAC,CAAC,cAAc,CAAC,aAAa,CAAC;YAChD,iBAAiB,EAAE,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,CAAC,cAAc,CAAC,gBAAgB;YAAE,kBAAkB,EAAE,CAAC;IAC9D,CAAC;IAED,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;QACtB,WAAW,CAAC,IAAI,CAAC;YACf,QAAQ,EAAE,gBAAgB;YAC1B,IAAI,EAAE,0BAA0B;YAChC,WAAW,EAAE,0CAA0C;YACvD,UAAU,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAC;YACvD,QAAQ,EAAE,CAAC,GAAG,aAAa,wBAAwB,iBAAiB,QAAQ,CAAC;SAC9E,CAAC,CAAC;IACL,CAAC;IAED,IAAI,kBAAkB,GAAG,CAAC,EAAE,CAAC;QAC3B,WAAW,CAAC,IAAI,CAAC;YACf,QAAQ,EAAE,gBAAgB;YAC1B,IAAI,EAAE,kBAAkB;YACxB,WAAW,EAAE,mDAAmD;YAChE,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC;YACxD,QAAQ,EAAE,CAAC,GAAG,kBAAkB,gCAAgC,CAAC;SAClE,CAAC,CAAC;IACL,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC;AAEF,SAAS,IAAI,CAAC,OAAe,EAAE,KAAa;IAC1C,MAAM,UAAU,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,OAAO;QACL,OAAO;QACP,KAAK;QACL,UAAU;QACV,WAAW,EAAE,GAAG,OAAO,OAAO,KAAK,KAAK,UAAU,IAAI;KACvD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"error-handling.js","sourceRoot":"","sources":["../../src/detectors/error-handling.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,kFAAkF;AAClF,iFAAiF;AACjF,4EAA4E;AAE5E,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGhF,qDAAqD;AACrD,MAAM,gBAAgB,GAA2B;IAC/C,UAAU,EAAE,2BAA2B;IACvC,OAAO,EAAE,sBAAsB;IAC/B,UAAU,EAAE,yBAAyB;IACrC,MAAM,EAAE,2CAA2C;IACnD,YAAY,EAAE,2BAA2B;IACzC,WAAW,EAAE,0BAA0B;CACxC,CAAC;AAEF,iDAAiD;AACjD,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;AAE9G,MAAM,CAAC,MAAM,qBAAqB,GAAuB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE;IAC7F,MAAM,WAAW,GAAiB,EAAE,CAAC;IACrC,MAAM,WAAW,GAAG,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACpD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC;IAEjD,yFAAyF;IACzF,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC/B,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;gBACrF,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAC7B,sFAAsF;QACtF,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,IAAI,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,sBAAsB,CAAC;QAClF,MAAM,WAAW,GAAG,WAAW;YAC7B,CAAC,CAAC,uBAAuB,YAAY,CAAC,MAAM,yBAAyB,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,YAAY,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG;YACnL,CAAC,CAAC,iCAAiC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAE/D,WAAW,CAAC,IAAI,CAAC;YACf,QAAQ,EAAE,gBAAgB;YAC1B,MAAM,EAAE,eAAe;YACvB,IAAI;YACJ,WAAW;YACX,UAAU,EAAE,eAAe,CAAC,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC;YACrE,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACnC,CAAC,CAAC;IACL,CAAC;IAED,sGAAsG;IACtG,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvD,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC,CAAC,kBAAkB;QACtD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC/B,IAAI,GAAG,CAAC,UAAU;gBAAE,SAAS;YAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBAC5D,IAAI,GAAG,CAAC,eAAe,KAAK,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC;oBAC7E,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACtB,CAAC;YACH,CAAC;QACH,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,oBAAoB,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAED,IAAI,oBAAoB,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,UAAU,GAAG,CAAC,GAAG,oBAAoB,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACjF,MAAM,IAAI,GAAG,CAAC,GAAG,oBAAoB,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7E,WAAW,CAAC,IAAI,CAAC;YACf,QAAQ,EAAE,gBAAgB;YAC1B,MAAM,EAAE,eAAe;YACvB,IAAI,EAAE,uBAAuB;YAC7B,WAAW,EAAE,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,8BAA8B,UAAU,SAAS;YAChF,UAAU,EAAE,eAAe,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC;YAC3D,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,KAAK,QAAQ,CAAC;SAC/D,CAAC,CAAC;IACL,CAAC;IAED,gFAAgF;IAChF,IAAI,oBAAoB,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,aAAa,GAAa,EAAE,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC/B,IAAI,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC,EAAE,CAAC;oBAC3F,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,aAAa,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YAC9B,WAAW,CAAC,IAAI,CAAC;gBACf,QAAQ,EAAE,gBAAgB;gBAC1B,MAAM,EAAE,eAAe;gBACvB,IAAI,EAAE,4BAA4B;gBAClC,WAAW,EAAE,gCAAgC,CAAC,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBACrF,UAAU,EAAE,eAAe,CAAC,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC;gBACvE,QAAQ,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;aAClD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC"}

package/dist/detectors/state-management.d.ts

@@ -0,0 +1,2 @@
+import type { ConventionDetector } from "../types.js";
+export declare const stateManagementDetector: ConventionDetector;

package/dist/detectors/state-management.js

@@ -0,0 +1,75 @@
+// src/detectors/state-management.ts — State management pattern detector
+// Import-based detection for Redux, Zustand, Jotai, MobX, Recoil, Signals, Context API.
+// Reports ALL detected libraries (dominant + supplementary) per adversarial review.
+import { buildConfidence, sourceParsedFiles } from "../convention-extractor.js";
+const STATE_LIBRARIES = {
+    redux: { label: "Redux", packages: ["@reduxjs/toolkit", "react-redux", "redux"] },
+    zustand: { label: "Zustand", packages: ["zustand"] },
+    jotai: { label: "Jotai", packages: ["jotai"] },
+    recoil: { label: "Recoil", packages: ["recoil"] },
+    mobx: { label: "MobX", packages: ["mobx", "mobx-react", "mobx-react-lite"] },
+    signals: { label: "Signals", packages: ["@preact/signals", "@preact/signals-react", "@angular/core"] },
+    valtio: { label: "Valtio", packages: ["valtio"] },
+    xstate: { label: "XState", packages: ["xstate", "@xstate/react"] },
+};
+export const stateManagementDetector = (files, tiers, _warnings, _context) => {
+    const conventions = [];
+    const sourceFiles = sourceParsedFiles(files, tiers);
+    if (sourceFiles.length === 0)
+        return conventions;
+    // Count files importing each state management library
+    const libFileCounts = new Map(); // library key → file count
+    for (const file of sourceFiles) {
+        const fileLibs = new Set(); // dedupe per file
+        for (const imp of file.imports) {
+            if (imp.isTypeOnly)
+                continue;
+            for (const [key, { packages }] of Object.entries(STATE_LIBRARIES)) {
+                if (packages.some((pkg) => imp.moduleSpecifier === pkg || imp.moduleSpecifier.startsWith(`${pkg}/`))) {
+                    fileLibs.add(key);
+                }
+            }
+        }
+        for (const key of fileLibs) {
+            libFileCounts.set(key, (libFileCounts.get(key) ?? 0) + 1);
+        }
+    }
+    // Detect Context API usage: imports of createContext from react
+    let contextApiFiles = 0;
+    for (const file of sourceFiles) {
+        for (const imp of file.imports) {
+            if (imp.isTypeOnly)
+                continue;
+            if (imp.moduleSpecifier === "react" && imp.importedNames.includes("createContext")) {
+                contextApiFiles++;
+                break;
+            }
+        }
+    }
+    if (contextApiFiles > 0) {
+        libFileCounts.set("context", contextApiFiles);
+    }
+    if (libFileCounts.size === 0)
+        return conventions;
+    // Sort by file count descending
+    const sorted = [...libFileCounts.entries()].sort((a, b) => b[1] - a[1]);
+    const totalFiles = sorted.reduce((sum, [, count]) => sum + count, 0);
+    // Build description showing all detected libraries with roles
+    const dominant = sorted[0];
+    const dominantLabel = dominant[0] === "context" ? "React Context API" : (STATE_LIBRARIES[dominant[0]]?.label ?? dominant[0]);
+    const parts = [];
+    for (const [key, count] of sorted) {
+        const label = key === "context" ? "React Context API" : (STATE_LIBRARIES[key]?.label ?? key);
+        parts.push(`${label} (${count} files)`);
+    }
+    conventions.push({
+        category: "state-management",
+        source: "stateManagement",
+        name: sorted.length === 1 ? `${dominantLabel} state management` : `${dominantLabel} + ${sorted.length - 1} more`,
+        description: sorted.length === 1 ? `Uses ${dominantLabel} for state management` : `State management: ${parts.join(", ")}`,
+        confidence: buildConfidence(totalFiles, sourceFiles.length),
+        examples: parts,
+    });
+    return conventions;
+};
+//# sourceMappingURL=state-management.js.map

package/dist/detectors/state-management.js.map

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

package/dist/execution-flow.d.ts

@@ -0,0 +1,23 @@
+import type { CallGraphEdge, CoChangeEdge, DependencyInsights, ExecutionFlow, PublicAPIEntry } from "./types.js";
+type NodeId = string;
+interface ScoredEntry {
+    nodeId: NodeId;
+    score: number;
+}
+export declare function scoreEntryPoints(callGraph: CallGraphEdge[], publicAPI: PublicAPIEntry[], dependencyInsights?: DependencyInsights): ScoredEntry[];
+interface RawFlow {
+    nodeIds: NodeId[];
+}
+export declare function traceFlows(callGraph: CallGraphEdge[], entries: ScoredEntry[]): RawFlow[];
+export declare function deduplicateFlows(candidates: RawFlow[], maxFlows: number): RawFlow[];
+/**
+ * Enrich existing flows with co-change confidence scores.
+ * Called after git history is attached to the package analysis.
+ */
+export declare function enrichFlowConfidence(flows: ExecutionFlow[], coChangeEdges: CoChangeEdge[]): void;
+/**
+ * Detect execution flows via forward BFS from scored entry points.
+ * Returns empty array if call graph is too sparse (<10 edges) or package is React-only.
+ */
+export declare function computeExecutionFlows(callGraph: CallGraphEdge[], publicAPI: PublicAPIEntry[], dependencyInsights?: DependencyInsights, coChangeEdges?: CoChangeEdge[]): ExecutionFlow[];
+export {};