autodocs-engine 0.9.9 → 0.10.0

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":"AAAA,2DAA2D;AAC3D,0FAA0F;AAC1F,8EAA8E;AAE9E,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGhF,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,8EAA8E;IAC9E,IAAI,oBAAoB,GAAG,CAAC,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC/B,IAAI,GAAG,CAAC,UAAU;gBAAE,SAAS;YAC7B,IAAI,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC/F,KAAK,GAAG,IAAI,CAAC;gBACb,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC/B,IAAI,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAChF,KAAK,GAAG,IAAI,CAAC;oBACb,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,KAAK;YAAE,oBAAoB,EAAE,CAAC;IACpC,CAAC;IACD,IAAI,oBAAoB,IAAI,CAAC,EAAE,CAAC;QAC9B,WAAW,CAAC,IAAI,CAAC;YACf,QAAQ,EAAE,gBAAgB;YAC1B,MAAM,EAAE,eAAe;YACvB,IAAI,EAAE,sCAAsC;YAC5C,WAAW,EAAE,sDAAsD,oBAAoB,SAAS;YAChG,UAAU,EAAE,eAAe,CAAC,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC;YACrE,QAAQ,EAAE,EAAE;SACb,CAAC,CAAC;IACL,CAAC;IAED,kDAAkD;IAClD,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,kBAAkB,GAAG,CAAC,CAAC,CAAC;IACtF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC;IAEhD,oDAAoD;IACpD,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC;IACvF,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;QACzD,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAClB,WAAW,CAAC,IAAI,CAAC;gBACf,QAAQ,EAAE,gBAAgB;gBAC1B,MAAM,EAAE,eAAe;gBACvB,IAAI,EAAE,gCAAgC;gBACtC,WAAW,EAAE,gEAAgE,eAAe,CAAC,MAAM,OAAO,UAAU,CAAC,MAAM,eAAe;gBAC1I,UAAU,EAAE,eAAe,CAAC,eAAe,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC;gBACtE,QAAQ,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;aACjE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,yGAAyG;IACzG,MAAM,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC;IAC1F,IAAI,gBAAgB,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;QAC1D,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAClB,WAAW,CAAC,IAAI,CAAC;gBACf,QAAQ,EAAE,gBAAgB;gBAC1B,MAAM,EAAE,eAAe;gBACvB,IAAI,EAAE,2BAA2B;gBACjC,WAAW,EAAE,GAAG,gBAAgB,CAAC,MAAM,QAAQ,gBAAgB,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,WAAW,gBAAgB,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,uEAAuE;gBACjN,UAAU,EAAE,eAAe,CAAC,gBAAgB,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC;gBACvE,QAAQ,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;aAClE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC"}

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":"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"}

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":"AAAA,wEAAwE;AACxE,wFAAwF;AACxF,oFAAoF;AAEpF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGhF,MAAM,eAAe,GAA0D;IAC7E,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,kBAAkB,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE;IACjF,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE;IACpD,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE;IAC9C,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE;IACjD,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,iBAAiB,CAAC,EAAE;IAC5E,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,iBAAiB,EAAE,uBAAuB,EAAE,eAAe,CAAC,EAAE;IACtG,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE;IACjD,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC,EAAE;CACnE,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAuB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE;IAC/F,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,sDAAsD;IACtD,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,2BAA2B;IAE5E,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,EAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;gBAClE,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,eAAe,KAAK,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC;oBACrG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACpB,CAAC;YACH,CAAC;QACH,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC/B,IAAI,GAAG,CAAC,UAAU;gBAAE,SAAS;YAC7B,IAAI,GAAG,CAAC,eAAe,KAAK,OAAO,IAAI,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;gBACnF,eAAe,EAAE,CAAC;gBAClB,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;QACxB,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,aAAa,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC;IAEjD,gCAAgC;IAChC,MAAM,MAAM,GAAG,CAAC,GAAG,aAAa,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;IACxE,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;IAErE,8DAA8D;IAC9D,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,aAAa,GACjB,QAAQ,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzG,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,KAAK,IAAI,GAAG,CAAC,CAAC;QAC7F,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,KAAK,KAAK,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,WAAW,CAAC,IAAI,CAAC;QACf,QAAQ,EAAE,kBAAkB;QAC5B,MAAM,EAAE,iBAAiB;QACzB,IAAI,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,mBAAmB,CAAC,CAAC,CAAC,GAAG,aAAa,MAAM,MAAM,CAAC,MAAM,GAAG,CAAC,OAAO;QAChH,WAAW,EACT,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,aAAa,uBAAuB,CAAC,CAAC,CAAC,qBAAqB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC9G,UAAU,EAAE,eAAe,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC;QAC3D,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IAEH,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC"}

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 {};

package/dist/execution-flow.js

@@ -0,0 +1,286 @@
+// src/execution-flow.ts — Execution flow tracing via forward BFS from entry points.
+// Detects labeled execution paths: "runPipeline → analyzePackage → buildSymbolGraph (3 steps)"
+// Uses spine-first tracing (full primary chain + fork paths) instead of fixed maxBranching.
+// Co-change Jaccard validates flows — our unique advantage over GitNexus.
+// ─── Constants ───────────────────────────────────────────────────────────────
+const MIN_CALL_GRAPH_EDGES = 10; // Skip flow detection for sparse graphs
+const MAX_TRACE_DEPTH = 10; // Maximum steps in a single flow
+const MIN_STEPS = 3; // Minimum steps for a meaningful flow
+const MAX_FORK_PATHS = 3; // Alternative callees explored at each spine node
+const MAX_TRACES_PER_ENTRY = 15; // Cap traces from a single entry point
+function makeNodeId(file, fn) {
+    return `${file}#${fn}`;
+}
+function nodeName(id) {
+    return id.split("#")[1];
+}
+function nodeFile(id) {
+    return id.split("#")[0];
+}
+// ─── Entry Point Scoring ─────────────────────────────────────────────────────
+// Boost: patterns that indicate genuine entry points in TS/JS
+const ENTRY_PATTERNS = /^(main|run|start|handle|execute|process|serve|init|bootstrap|listen|register|setup|configure|launch)/i;
+const ENTRY_SUFFIX_PATTERNS = /(?:Controller|Middleware|Handler|Router|Command|Plugin)$/;
+// Penalty: utility functions that are rarely true entry points
+const UTILITY_PATTERNS = /^(get|set|is|has|to|from|parse|format|validate|normalize|ensure|assert|check|clone|merge|map|filter|reduce|compose|pipe|wrap|create(?!.*Server))/i;
+// Exclude: test orchestration functions
+const TEST_PATTERNS = /^(describe|it|test|beforeEach|afterEach|beforeAll|afterAll|expect)$/;
+// Framework-specific: high-value entry points detected from dependencies
+const FRAMEWORK_PATTERNS = {
+    next: { patterns: [/^(getServerSideProps|getStaticProps|getStaticPaths|loader|action|default)$/], multiplier: 2.5 },
+    express: { patterns: [/Middleware$/i, /Router$/i], multiplier: 2.5 },
+    fastify: { patterns: [/Middleware$/i, /Router$/i], multiplier: 2.5 },
+    hono: { patterns: [/Middleware$/i, /Handler$/i], multiplier: 2.5 },
+    "@nestjs/core": { patterns: [/Controller$/i], multiplier: 2.5 },
+    "@nestjs/common": { patterns: [/Controller$/i], multiplier: 2.5 },
+};
+export function scoreEntryPoints(callGraph, publicAPI, dependencyInsights) {
+    // Build adjacency counts
+    const outDegree = new Map();
+    const inDegree = new Map();
+    const allNodes = new Set();
+    for (const edge of callGraph) {
+        const from = makeNodeId(edge.fromFile, edge.from);
+        const to = makeNodeId(edge.toFile, edge.to);
+        allNodes.add(from);
+        allNodes.add(to);
+        outDegree.set(from, (outDegree.get(from) ?? 0) + 1);
+        inDegree.set(to, (inDegree.get(to) ?? 0) + 1);
+    }
+    // Detect active frameworks for multipliers
+    const activeFrameworks = new Set();
+    if (dependencyInsights?.frameworks) {
+        for (const fw of dependencyInsights.frameworks) {
+            if (FRAMEWORK_PATTERNS[fw.name])
+                activeFrameworks.add(fw.name);
+        }
+    }
+    const exportedNames = new Set(publicAPI.filter((e) => !e.isTypeOnly).map((e) => e.name));
+    const scored = [];
+    for (const nodeId of allNodes) {
+        const fn = nodeName(nodeId);
+        const out = outDegree.get(nodeId) ?? 0;
+        const inD = inDegree.get(nodeId) ?? 0;
+        // Exclude test orchestration
+        if (TEST_PATTERNS.test(fn))
+            continue;
+        // Base: functions with high out-degree relative to in-degree are entry-like
+        const baseScore = (out + 1) / (inD + 1);
+        // Export boost: exported functions are more likely externally invoked
+        const exportMul = exportedNames.has(fn) ? 1.5 : 1.0;
+        // Zero-caller boost: exported with no internal callers = likely framework-invoked
+        const externalOnlyMul = inD === 0 && out >= 2 && exportedNames.has(fn) ? 1.8 : 1.0;
+        // Framework multiplier (checked first — overrides name penalty for framework entry points)
+        let frameworkMul = 1.0;
+        for (const fwName of activeFrameworks) {
+            const fw = FRAMEWORK_PATTERNS[fwName];
+            if (fw.patterns.some((p) => p.test(fn))) {
+                frameworkMul = Math.max(frameworkMul, fw.multiplier);
+            }
+        }
+        // Name pattern multiplier (skip penalty if framework multiplier already boosted)
+        let nameMul = 1.0;
+        if (ENTRY_PATTERNS.test(fn) || ENTRY_SUFFIX_PATTERNS.test(fn))
+            nameMul = 2.0;
+        else if (UTILITY_PATTERNS.test(fn) && frameworkMul <= 1.0)
+            nameMul = 0.3;
+        const score = baseScore * exportMul * externalOnlyMul * nameMul * frameworkMul;
+        if (score > 0)
+            scored.push({ nodeId, score });
+    }
+    // Dynamic cap: scale with codebase size
+    const maxEntries = Math.max(10, Math.min(200, Math.floor(allNodes.size / 10)));
+    scored.sort((a, b) => b.score - a.score);
+    return scored.slice(0, maxEntries);
+}
+export function traceFlows(callGraph, entries) {
+    // Build forward adjacency with out-degree for callee ranking
+    const adj = new Map();
+    const outDegree = new Map();
+    for (const edge of callGraph) {
+        const from = makeNodeId(edge.fromFile, edge.from);
+        const to = makeNodeId(edge.toFile, edge.to);
+        const callees = adj.get(from) ?? [];
+        callees.push(to);
+        adj.set(from, callees);
+        outDegree.set(to, (outDegree.get(to) ?? 0) + (adj.get(to)?.length ?? 0));
+    }
+    // Recount out-degree properly
+    for (const [node, callees] of adj) {
+        outDegree.set(node, callees.length);
+    }
+    const allFlows = [];
+    for (const entry of entries) {
+        const traces = [];
+        // PRIMARY SPINE: follow highest out-degree callee at each step (no branching limit)
+        const spine = traceSpine(entry.nodeId, adj, outDegree);
+        if (spine.length >= MIN_STEPS) {
+            traces.push({ nodeIds: spine });
+        }
+        // FORK PATHS: at each spine node, explore alternative callees
+        for (let i = 0; i < spine.length && traces.length < MAX_TRACES_PER_ENTRY; i++) {
+            const node = spine[i];
+            const callees = adj.get(node) ?? [];
+            if (callees.length <= 1)
+                continue; // No forks at this node
+            // Sort callees by out-degree descending, skip the spine callee
+            const spineNext = i + 1 < spine.length ? spine[i + 1] : null;
+            const forks = callees
+                .filter((c) => c !== spineNext)
+                .sort((a, b) => (outDegree.get(b) ?? 0) - (outDegree.get(a) ?? 0))
+                .slice(0, MAX_FORK_PATHS);
+            for (const fork of forks) {
+                // Trace a sub-spine from this fork point
+                const pathPrefix = spine.slice(0, i + 1);
+                const visited = new Set(pathPrefix);
+                if (visited.has(fork))
+                    continue;
+                const forkSpine = traceSpine(fork, adj, outDegree, visited);
+                const fullPath = [...pathPrefix, ...forkSpine];
+                if (fullPath.length >= MIN_STEPS) {
+                    traces.push({ nodeIds: fullPath });
+                }
+            }
+        }
+        allFlows.push(...traces);
+    }
+    return allFlows;
+}
+/** Trace a single spine: follow highest out-degree callee at each step. */
+function traceSpine(start, adj, outDegree, visited) {
+    const path = [start];
+    const seen = visited ?? new Set([start]);
+    if (visited)
+        seen.add(start);
+    let current = start;
+    for (let depth = 1; depth < MAX_TRACE_DEPTH; depth++) {
+        const callees = (adj.get(current) ?? []).filter((c) => !seen.has(c));
+        if (callees.length === 0)
+            break;
+        // Pick callee with highest out-degree (leads to deeper paths)
+        // Tie-break: alphabetical nodeId for determinism
+        callees.sort((a, b) => {
+            const diff = (outDegree.get(b) ?? 0) - (outDegree.get(a) ?? 0);
+            return diff !== 0 ? diff : a.localeCompare(b);
+        });
+        const next = callees[0];
+        seen.add(next);
+        path.push(next);
+        current = next;
+    }
+    return path;
+}
+// ─── Deduplication ───────────────────────────────────────────────────────────
+export function deduplicateFlows(candidates, maxFlows) {
+    // Sort by length descending — longer flows are preferred
+    const sorted = [...candidates].sort((a, b) => b.nodeIds.length - a.nodeIds.length);
+    // Phase 1: Subset removal — discard flows that are contiguous subpaths of a longer flow
+    const kept = [];
+    for (const flow of sorted) {
+        const isSubset = kept.some((existing) => isContiguousSubpath(flow.nodeIds, existing.nodeIds));
+        if (!isSubset)
+            kept.push(flow);
+    }
+    // Phase 2: Endpoint dedup — keep longest per (entry, terminal) pair
+    const byEndpoints = new Map();
+    for (const flow of kept) {
+        const key = `${flow.nodeIds[0]}::${flow.nodeIds[flow.nodeIds.length - 1]}`;
+        const existing = byEndpoints.get(key);
+        if (!existing || flow.nodeIds.length > existing.nodeIds.length) {
+            byEndpoints.set(key, flow);
+        }
+    }
+    return [...byEndpoints.values()].sort((a, b) => b.nodeIds.length - a.nodeIds.length).slice(0, maxFlows);
+}
+/** Check if `sub` is a contiguous subpath of `sup` (sliding window). */
+function isContiguousSubpath(sub, sup) {
+    if (sub.length >= sup.length)
+        return false;
+    for (let i = 0; i <= sup.length - sub.length; i++) {
+        if (sub.every((step, j) => step === sup[i + j]))
+            return true;
+    }
+    return false;
+}
+// ─── Co-Change Confidence ────────────────────────────────────────────────────
+function computeFlowConfidence(files, coChangeEdges) {
+    if (!coChangeEdges || coChangeEdges.length === 0 || files.length < 2)
+        return 0;
+    // Build fast pairwise Jaccard lookup
+    const jaccardMap = new Map();
+    for (const e of coChangeEdges) {
+        jaccardMap.set(`${e.file1}\0${e.file2}`, e.jaccard);
+        jaccardMap.set(`${e.file2}\0${e.file1}`, e.jaccard);
+    }
+    let total = 0;
+    let pairs = 0;
+    for (let i = 0; i < files.length - 1; i++) {
+        if (files[i] === files[i + 1])
+            continue; // Skip same-file adjacent steps
+        total += jaccardMap.get(`${files[i]}\0${files[i + 1]}`) ?? 0;
+        pairs++;
+    }
+    return pairs > 0 ? total / pairs : 0;
+}
+// ─── Label Generation ────────────────────────────────────────────────────────
+function generateLabel(steps, files) {
+    const uniqueFiles = new Set(files).size;
+    if (steps.length <= 4) {
+        return `${steps.join(" → ")} (${steps.length} steps, ${uniqueFiles} files)`;
+    }
+    return `${steps[0]} → ${steps[1]} → ... → ${steps[steps.length - 1]} (${steps.length} steps, ${uniqueFiles} files)`;
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+/**
+ * Enrich existing flows with co-change confidence scores.
+ * Called after git history is attached to the package analysis.
+ */
+export function enrichFlowConfidence(flows, coChangeEdges) {
+    for (const flow of flows) {
+        flow.confidence = computeFlowConfidence(flow.files, coChangeEdges);
+    }
+    // Re-sort by confidence
+    flows.sort((a, b) => b.confidence - a.confidence || b.length - a.length);
+}
+/**
+ * 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 function computeExecutionFlows(callGraph, publicAPI, dependencyInsights, coChangeEdges) {
+    if (callGraph.length < MIN_CALL_GRAPH_EDGES)
+        return [];
+    // Score and select entry points
+    const entries = scoreEntryPoints(callGraph, publicAPI, dependencyInsights);
+    if (entries.length === 0)
+        return [];
+    // Trace flows via spine-first BFS
+    const rawFlows = traceFlows(callGraph, entries);
+    if (rawFlows.length === 0)
+        return [];
+    // Deduplicate
+    const functionCount = new Set(callGraph.flatMap((e) => [makeNodeId(e.fromFile, e.from), makeNodeId(e.toFile, e.to)]))
+        .size;
+    const maxFlows = Math.max(10, Math.min(200, Math.floor(functionCount / 10)));
+    const deduped = deduplicateFlows(rawFlows, maxFlows);
+    // Convert to ExecutionFlow with co-change confidence
+    const flows = deduped.map((raw) => {
+        const steps = raw.nodeIds.map(nodeName);
+        const files = raw.nodeIds.map(nodeFile);
+        const confidence = computeFlowConfidence(files, coChangeEdges);
+        return {
+            label: generateLabel(steps, files),
+            entryPoint: steps[0],
+            entryFile: files[0],
+            terminal: steps[steps.length - 1],
+            terminalFile: files[files.length - 1],
+            steps,
+            files,
+            length: steps.length,
+            confidence,
+        };
+    });
+    // Sort by confidence descending, then length descending
+    flows.sort((a, b) => b.confidence - a.confidence || b.length - a.length);
+    return flows;
+}
+//# sourceMappingURL=execution-flow.js.map

package/dist/execution-flow.js.map

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

package/dist/git-history.js

@@ -8,8 +8,11 @@ import { relative, resolve } from "node:path";
 import { SOURCE_EXTENSIONS } from "./types.js";
 // ─── Constants ───────────────────────────────────────────────────────────────
 const MIN_COMMITS = 10;
-const MAX_COMMITS = 500;
-const MAX_DAYS = 90;
+const INITIAL_MAX_COMMITS = 500;
+const EXPANDED_MAX_COMMITS = 1000;
+const FULL_MAX_COMMITS = 2000;
+const MAX_DAYS = 365; // expanded from 90 — recency decay handles old data
+const MIN_USEFUL_EDGES = 5; // minimum co-change edges before expanding
 const MAX_FILES_PER_COMMIT = 30;
 const HUB_FILE_THRESHOLD = 0.7;
 const HUB_FILE_THRESHOLD_YOUNG = 0.9;
@@ -37,15 +40,23 @@ export function mineGitHistory(repoDir, packageDirs, warnings, options = {}) {
         });
         return null;
     }
-    const maxCommits = options.maxCommits ?? MAX_COMMITS;
     const maxDays = options.maxDays ?? MAX_DAYS;
-    const raw = runGitLog(absRepoDir, maxCommits, maxDays);
-    if (raw === null)
-        return null;
     const gitRoot = resolveGitRoot(absRepoDir);
     if (gitRoot === null)
         return null;
-    const allCommits = parseGitLog(raw);
+    // Adaptive windowing: start with 500 commits, expand if insufficient signal
+    const commitTargets = [options.maxCommits ?? INITIAL_MAX_COMMITS, EXPANDED_MAX_COMMITS, FULL_MAX_COMMITS];
+    let allCommits = [];
+    for (const target of commitTargets) {
+        if (allCommits.length >= target)
+            break; // already have enough from prior expansion
+        const raw = runGitLog(absRepoDir, target, maxDays);
+        if (raw === null)
+            return null;
+        allCommits = parseGitLog(raw);
+        if (allCommits.length >= target * 0.8)
+            break; // got most of what we asked for — no point expanding
+    }
     if (allCommits.length < MIN_COMMITS) {
         warnings.push({
             level: "info",