autodocs-engine 0.5.0

package/dist/detectors/database.js

@@ -0,0 +1,54 @@
+// src/detectors/database.ts — W2-3: Database/ORM Pattern Detector
+// Detects Drizzle, Prisma, TypeORM, Sequelize, Knex from dependencies.
+import { buildConfidence } from "../convention-extractor.js";
+const ORM_MAP = {
+    "drizzle-orm": { name: "Drizzle ORM", description: "Schema-as-code ORM with SQL-like query builder" },
+    "prisma": { name: "Prisma", description: "Schema-first ORM with generated client" },
+    "@prisma/client": { name: "Prisma", description: "Schema-first ORM with generated client" },
+    "typeorm": { name: "TypeORM", description: "Decorator-based ORM with Active Record and Data Mapper patterns" },
+    "sequelize": { name: "Sequelize", description: "Promise-based ORM for SQL databases" },
+    "knex": { name: "Knex", description: "SQL query builder (not a full ORM)" },
+    "kysely": { name: "Kysely", description: "Type-safe SQL query builder" },
+    "mongoose": { name: "Mongoose", description: "MongoDB ODM with schema validation" },
+};
+export const databaseDetector = (files, _tiers, _warnings, context) => {
+    if (!context?.dependencies)
+        return [];
+    const conventions = [];
+    const frameworks = context.dependencies.frameworks?.map((f) => f.name) ?? [];
+    const detected = new Set();
+    // Check dependency insights for ORM packages
+    for (const fw of context.dependencies.frameworks ?? []) {
+        const orm = ORM_MAP[fw.name];
+        if (orm && !detected.has(orm.name)) {
+            detected.add(orm.name);
+            conventions.push({
+                category: "ecosystem",
+                source: "database",
+                name: `${orm.name} database`,
+                description: `Uses ${orm.name} (${fw.version}): ${orm.description}`,
+                confidence: buildConfidence(1, 1),
+                examples: [`${fw.name}@${fw.version}`],
+            });
+        }
+    }
+    // Also check import patterns in source files for ORMs not in dependency insights
+    for (const [pkg, orm] of Object.entries(ORM_MAP)) {
+        if (detected.has(orm.name))
+            continue;
+        const importCount = files.filter((f) => f.imports.some((i) => !i.isTypeOnly && (i.moduleSpecifier === pkg || i.moduleSpecifier.startsWith(pkg + "/")))).length;
+        if (importCount > 0) {
+            detected.add(orm.name);
+            conventions.push({
+                category: "ecosystem",
+                source: "database",
+                name: `${orm.name} database`,
+                description: `Uses ${orm.name}: ${orm.description}`,
+                confidence: buildConfidence(importCount, importCount),
+                examples: [`${importCount} files import from ${pkg}`],
+            });
+        }
+    }
+    return conventions;
+};
+//# sourceMappingURL=database.js.map

package/dist/detectors/database.js.map

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

package/dist/detectors/error-handling.d.ts

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

package/dist/detectors/error-handling.js

@@ -0,0 +1,47 @@
+import { sourceParsedFiles } from "../convention-extractor.js";
+export const errorHandlingDetector = (files, tiers, _warnings) => {
+    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++;
+        }
+        if (f.contentSignals.hasErrorBoundary)
+            errorBoundaryCount++;
+    }
+    if (tryCatchTotal > 0) {
+        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`],
+        });
+    }
+    if (errorBoundaryCount > 0) {
+        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`],
+        });
+    }
+    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

@@ -0,0 +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"}

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

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

package/dist/detectors/export-patterns.js

@@ -0,0 +1,64 @@
+import { sourceParsedFiles } from "../convention-extractor.js";
+export const exportPatternDetector = (files, tiers, _warnings) => {
+    const conventions = [];
+    const sourceFiles = sourceParsedFiles(files, tiers);
+    if (sourceFiles.length === 0)
+        return conventions;
+    let named = 0, defaults = 0, reExports = 0, total = 0;
+    for (const f of sourceFiles) {
+        for (const exp of f.exports) {
+            total++;
+            if (exp.name === "default")
+                defaults++;
+            else
+                named++;
+            if (exp.isReExport)
+                reExports++;
+        }
+    }
+    if (total === 0)
+        return conventions;
+    // Named vs default
+    if (named > 0 && defaults === 0) {
+        conventions.push({
+            category: "exports",
+            name: "Named exports only",
+            description: `All exports use named exports (no default exports)`,
+            confidence: conf(named, total),
+            examples: [`${named} named, ${defaults} default exports`],
+        });
+    }
+    else if (named > 0 && defaults > 0) {
+        const namedPct = Math.round((named / total) * 100);
+        if (namedPct >= 90) {
+            conventions.push({
+                category: "exports",
+                name: "Named exports preferred",
+                description: `Named exports are strongly preferred over default exports`,
+                confidence: conf(named, total),
+                examples: [`${named} named (${namedPct}%) vs ${defaults} default`],
+            });
+        }
+    }
+    // Re-exports
+    if (reExports >= 3) {
+        conventions.push({
+            category: "exports",
+            name: "Barrel re-exports",
+            description: `Package uses barrel file re-exports to define public API`,
+            confidence: conf(reExports, total),
+            examples: [`${reExports} re-export statements`],
+        });
+    }
+    return conventions;
+};
+function conf(matched, total) {
+    const percentage = total > 0 ? Math.round((matched / total) * 100) : 0;
+    return {
+        matched,
+        total,
+        percentage,
+        description: `${matched} of ${total} exports (${percentage}%)`,
+    };
+}
+//# sourceMappingURL=export-patterns.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export-patterns.js","sourceRoot":"","sources":["../../src/detectors/export-patterns.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,KAAK,GAAG,CAAC,EAAE,QAAQ,GAAG,CAAC,EAAE,SAAS,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC;IAEtD,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YAC5B,KAAK,EAAE,CAAC;YACR,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;gBAAE,QAAQ,EAAE,CAAC;;gBAClC,KAAK,EAAE,CAAC;YACb,IAAI,GAAG,CAAC,UAAU;gBAAE,SAAS,EAAE,CAAC;QAClC,CAAC;IACH,CAAC;IAED,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC;IAEpC,mBAAmB;IACnB,IAAI,KAAK,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QAChC,WAAW,CAAC,IAAI,CAAC;YACf,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EAAE,oDAAoD;YACjE,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC;YAC9B,QAAQ,EAAE,CAAC,GAAG,KAAK,WAAW,QAAQ,kBAAkB,CAAC;SAC1D,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,KAAK,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;QACnD,IAAI,QAAQ,IAAI,EAAE,EAAE,CAAC;YACnB,WAAW,CAAC,IAAI,CAAC;gBACf,QAAQ,EAAE,SAAS;gBACnB,IAAI,EAAE,yBAAyB;gBAC/B,WAAW,EAAE,2DAA2D;gBACxE,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC;gBAC9B,QAAQ,EAAE,CAAC,GAAG,KAAK,WAAW,QAAQ,SAAS,QAAQ,UAAU,CAAC;aACnE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,aAAa;IACb,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACnB,WAAW,CAAC,IAAI,CAAC;YACf,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,mBAAmB;YACzB,WAAW,EAAE,0DAA0D;YACvE,UAAU,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC;YAClC,QAAQ,EAAE,CAAC,GAAG,SAAS,uBAAuB,CAAC;SAChD,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,aAAa,UAAU,IAAI;KAC/D,CAAC;AACJ,CAAC"}

package/dist/detectors/file-naming.d.ts

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

package/dist/detectors/file-naming.js

@@ -0,0 +1,74 @@
+import { basename } from "node:path";
+import { sourceParsedFiles, buildConfidence } from "../convention-extractor.js";
+const KEBAB_CASE = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
+const CAMEL_CASE = /^[a-z][a-zA-Z0-9]*$/;
+const PASCAL_CASE = /^[A-Z][a-zA-Z0-9]*$/;
+export const fileNamingDetector = (files, tiers, _warnings) => {
+    const conventions = [];
+    const sourceFiles = sourceParsedFiles(files, tiers);
+    if (sourceFiles.length === 0)
+        return conventions;
+    let kebab = 0, camel = 0, pascal = 0;
+    const total = sourceFiles.length;
+    for (const f of sourceFiles) {
+        const name = basename(f.relativePath).replace(/\.[^.]+$/, "");
+        if (name === "index")
+            continue; // Skip index files
+        if (KEBAB_CASE.test(name))
+            kebab++;
+        else if (PASCAL_CASE.test(name))
+            pascal++;
+        else if (CAMEL_CASE.test(name))
+            camel++;
+    }
+    const nonIndex = total - sourceFiles.filter((f) => basename(f.relativePath).startsWith("index.")).length;
+    if (nonIndex === 0)
+        return conventions;
+    // E-26: Report dominant pattern even below threshold
+    const patterns = [
+        { name: "kebab-case", count: kebab },
+        { name: "PascalCase", count: pascal },
+        { name: "camelCase", count: camel },
+    ].sort((a, b) => b.count - a.count);
+    const dominant = patterns[0];
+    const pct = Math.round((dominant.count / nonIndex) * 100);
+    if (pct >= 80) {
+        conventions.push({
+            category: "file-naming",
+            name: `${dominant.name} filenames`,
+            description: `Source files use ${dominant.name} naming convention`,
+            confidence: buildConfidence(dominant.count, nonIndex),
+            examples: sourceFiles
+                .map((f) => basename(f.relativePath))
+                .filter((n) => !n.startsWith("index."))
+                .slice(0, 3),
+        });
+    }
+    else if (pct >= 40) {
+        const secondPct = Math.round((patterns[1].count / nonIndex) * 100);
+        conventions.push({
+            category: "file-naming",
+            name: "Mixed file naming",
+            description: `Mixed: ${dominant.name} (${pct}%), ${patterns[1].name} (${secondPct}%)`,
+            confidence: buildConfidence(dominant.count, nonIndex),
+            examples: sourceFiles
+                .map((f) => basename(f.relativePath))
+                .filter((n) => !n.startsWith("index."))
+                .slice(0, 3),
+        });
+    }
+    // Extension split
+    const tsx = sourceFiles.filter((f) => f.relativePath.endsWith(".tsx")).length;
+    const ts = sourceFiles.filter((f) => f.relativePath.endsWith(".ts")).length;
+    if (tsx > 0 && ts > 0) {
+        conventions.push({
+            category: "file-naming",
+            name: ".tsx/.ts extension split",
+            description: `.tsx for JSX components, .ts for logic`,
+            confidence: buildConfidence(tsx + ts, total),
+            examples: [`${tsx} .tsx files`, `${ts} .ts files`],
+        });
+    }
+    return conventions;
+};
+//# sourceMappingURL=file-naming.js.map

package/dist/detectors/file-naming.js.map

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

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

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

package/dist/detectors/graphql-patterns.js

@@ -0,0 +1,47 @@
+import { sourceParsedFiles } from "../convention-extractor.js";
+export const graphqlPatternDetector = (files, tiers, _warnings) => {
+    const conventions = [];
+    // Check generated graphql interface files (in all files, not just source)
+    const generatedGql = files.filter((f) => f.isGeneratedFile &&
+        (f.relativePath.includes(".graphql.interface.") ||
+            f.relativePath.includes(".generated.")));
+    if (generatedGql.length > 0) {
+        conventions.push({
+            category: "graphql",
+            name: "Generated GraphQL interfaces",
+            description: `Package has generated GraphQL interface files`,
+            confidence: conf(generatedGql.length, generatedGql.length),
+            examples: generatedGql.slice(0, 3).map((f) => f.relativePath),
+        });
+    }
+    // Check for Apollo/GraphQL hook usage
+    const sourceFiles = sourceParsedFiles(files, tiers);
+    let queryCount = 0, mutationCount = 0;
+    for (const f of sourceFiles) {
+        queryCount += f.contentSignals.useQueryCount;
+        mutationCount += f.contentSignals.useMutationCount;
+    }
+    if (queryCount > 0 || mutationCount > 0) {
+        conventions.push({
+            category: "graphql",
+            name: "GraphQL hooks",
+            description: `Uses useQuery/useMutation hooks for GraphQL operations`,
+            confidence: conf(queryCount + mutationCount, queryCount + mutationCount),
+            examples: [
+                ...(queryCount > 0 ? [`useQuery: ${queryCount} usages`] : []),
+                ...(mutationCount > 0 ? [`useMutation: ${mutationCount} usages`] : []),
+            ],
+        });
+    }
+    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=graphql-patterns.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-patterns.js","sourceRoot":"","sources":["../../src/detectors/graphql-patterns.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D,MAAM,CAAC,MAAM,sBAAsB,GAAuB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;IACpF,MAAM,WAAW,GAAiB,EAAE,CAAC;IAErC,0EAA0E;IAC1E,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAC/B,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,eAAe;QACjB,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,qBAAqB,CAAC;YAC7C,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAC5C,CAAC;IAEF,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,WAAW,CAAC,IAAI,CAAC;YACf,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,8BAA8B;YACpC,WAAW,EAAE,+CAA+C;YAC5D,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC;YAC1D,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;IAED,sCAAsC;IACtC,MAAM,WAAW,GAAG,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACpD,IAAI,UAAU,GAAG,CAAC,EAAE,aAAa,GAAG,CAAC,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,UAAU,IAAI,CAAC,CAAC,cAAc,CAAC,aAAa,CAAC;QAC7C,aAAa,IAAI,CAAC,CAAC,cAAc,CAAC,gBAAgB,CAAC;IACrD,CAAC;IAED,IAAI,UAAU,GAAG,CAAC,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;QACxC,WAAW,CAAC,IAAI,CAAC;YACf,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,wDAAwD;YACrE,UAAU,EAAE,IAAI,CAAC,UAAU,GAAG,aAAa,EAAE,UAAU,GAAG,aAAa,CAAC;YACxE,QAAQ,EAAE;gBACR,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,UAAU,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7D,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,aAAa,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;aACvE;SACF,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"}

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

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

package/dist/detectors/hook-patterns.js

@@ -0,0 +1,105 @@
+import { basename } from "node:path";
+import { sourceParsedFiles, buildConfidence } from "../convention-extractor.js";
+const REACT_MODULES = new Set(["react", "react-dom", "preact", "preact/hooks", "preact/compat"]);
+export const hookPatternDetector = (files, tiers, _warnings) => {
+    const conventions = [];
+    const sourceFiles = sourceParsedFiles(files, tiers);
+    // Only report hook conventions if the package actually uses React/Preact
+    const hasReactImport = sourceFiles.some((f) => f.imports.some((imp) => !imp.isTypeOnly && REACT_MODULES.has(imp.moduleSpecifier)));
+    if (!hasReactImport)
+        return conventions;
+    const hookFiles = [];
+    const hookNames = [];
+    for (const f of sourceFiles) {
+        const hooks = f.exports.filter((e) => e.kind === "hook");
+        if (hooks.length > 0) {
+            hookFiles.push(f);
+            hookNames.push(...hooks.map((h) => h.name));
+        }
+    }
+    if (hookFiles.length === 0)
+        return conventions;
+    // Hook count convention
+    conventions.push({
+        category: "hooks",
+        name: "Custom hooks",
+        description: `Package exports ${hookNames.length} custom hooks`,
+        confidence: buildConfidence(hookNames.length, hookNames.length),
+        examples: hookNames.slice(0, 3),
+    });
+    // Return type analysis
+    let returnObj = 0, returnArr = 0, returnVoid = 0;
+    for (const f of hookFiles) {
+        for (const exp of f.exports) {
+            if (exp.kind !== "hook" || !exp.signature)
+                continue;
+            const returnType = exp.signature.split("=>").pop()?.trim() ?? "";
+            if (returnType.startsWith("{") || returnType.startsWith("Record"))
+                returnObj++;
+            else if (returnType.startsWith("["))
+                returnArr++;
+            else if (returnType === "void")
+                returnVoid++;
+            else
+                returnObj++; // named types typically are objects
+        }
+    }
+    if (returnObj > 0 && returnArr === 0 && returnVoid === 0) {
+        conventions.push({
+            category: "hooks",
+            name: "Hooks return objects",
+            description: `Hooks return objects with named properties (not arrays)`,
+            confidence: buildConfidence(returnObj, returnObj + returnArr + returnVoid),
+            examples: hookNames.slice(0, 2).map((n) => `${n} returns { ... }`),
+        });
+    }
+    // Co-located tests
+    const allFiles = new Set(files.map((f) => f.relativePath));
+    let coLocated = 0;
+    for (const hf of hookFiles) {
+        const base = hf.relativePath.replace(/\.[^.]+$/, "");
+        const testExists = allFiles.has(`${base}.test.ts`) ||
+            allFiles.has(`${base}.test.tsx`) ||
+            allFiles.has(`${base}.spec.ts`);
+        if (testExists)
+            coLocated++;
+    }
+    if (coLocated > 0) {
+        conventions.push({
+            category: "hooks",
+            name: "Co-located hook tests",
+            description: `Hook files have co-located test files`,
+            confidence: buildConfidence(coLocated, hookFiles.length),
+            examples: hookFiles.slice(0, 2).map((f) => `${basename(f.relativePath)} + .test.ts`),
+        });
+    }
+    // Aggregate React hook usage
+    let useMemo = 0, useCallback = 0, useEffect = 0, useState = 0;
+    for (const f of sourceFiles) {
+        useMemo += f.contentSignals.useMemoCount;
+        useCallback += f.contentSignals.useCallbackCount;
+        useEffect += f.contentSignals.useEffectCount;
+        useState += f.contentSignals.useStateCount;
+    }
+    const hookUsage = [
+        { name: "useMemo", count: useMemo },
+        { name: "useCallback", count: useCallback },
+        { name: "useEffect", count: useEffect },
+        { name: "useState", count: useState },
+    ].filter((h) => h.count > 0);
+    if (hookUsage.length > 0) {
+        const total = hookUsage.reduce((s, h) => s + h.count, 0);
+        // Only report hook usage distribution if there's meaningful usage (≥3 total calls)
+        if (total >= 3) {
+            conventions.push({
+                category: "hooks",
+                name: "React hook usage distribution",
+                description: `React hooks used across source files`,
+                confidence: buildConfidence(total, total),
+                examples: hookUsage.map((h) => `${h.name}: ${h.count}`),
+            });
+        }
+    }
+    return conventions;
+};
+//# sourceMappingURL=hook-patterns.js.map

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

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

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

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

package/dist/detectors/import-patterns.js

@@ -0,0 +1,88 @@
+import { sourceParsedFiles } from "../convention-extractor.js";
+export const importPatternDetector = (files, tiers, _warnings) => {
+    const conventions = [];
+    const sourceFiles = sourceParsedFiles(files, tiers);
+    if (sourceFiles.length === 0)
+        return conventions;
+    let barrel = 0, deep = 0, relative = 0, absolute = 0, typeOnly = 0, total = 0;
+    for (const f of sourceFiles) {
+        for (const imp of f.imports) {
+            if (imp.isDynamic)
+                continue;
+            total++;
+            if (imp.moduleSpecifier.startsWith(".")) {
+                relative++;
+            }
+            else {
+                absolute++;
+                // Check barrel vs deep: scoped @org/pkg/sub is deep, @org/pkg is barrel
+                if (imp.moduleSpecifier.startsWith("@")) {
+                    const parts = imp.moduleSpecifier.split("/");
+                    if (parts.length > 2)
+                        deep++;
+                    else
+                        barrel++;
+                }
+                else {
+                    const parts = imp.moduleSpecifier.split("/");
+                    if (parts.length > 1)
+                        deep++;
+                    else
+                        barrel++;
+                }
+            }
+            if (imp.isTypeOnly)
+                typeOnly++;
+        }
+    }
+    if (total === 0)
+        return conventions;
+    // Barrel vs deep imports for external packages
+    const extTotal = barrel + deep;
+    if (extTotal > 0 && barrel > 0) {
+        const pct = Math.round((barrel / extTotal) * 100);
+        if (pct >= 70) {
+            conventions.push({
+                category: "imports",
+                name: "Barrel imports for external packages",
+                description: `External packages are imported from their barrel (entry point), not deep paths`,
+                confidence: conf(barrel, extTotal),
+                examples: [`${barrel} barrel vs ${deep} deep imports`],
+            });
+        }
+    }
+    // Relative imports
+    if (relative > 0) {
+        conventions.push({
+            category: "imports",
+            name: "Relative imports within package",
+            description: `Internal imports use relative paths`,
+            confidence: conf(relative, total),
+            examples: [`${relative} relative of ${total} total imports`],
+        });
+    }
+    // Type-only imports
+    if (typeOnly > 0) {
+        const pct = Math.round((typeOnly / total) * 100);
+        if (pct >= 10) {
+            conventions.push({
+                category: "imports",
+                name: "Type-only imports",
+                description: `Type-only import syntax used for type imports`,
+                confidence: conf(typeOnly, total),
+                examples: [`${typeOnly} type-only of ${total} imports (${pct}%)`],
+            });
+        }
+    }
+    return conventions;
+};
+function conf(matched, total) {
+    const percentage = total > 0 ? Math.round((matched / total) * 100) : 0;
+    return {
+        matched,
+        total,
+        percentage,
+        description: `${matched} of ${total} imports (${percentage}%)`,
+    };
+}
+//# sourceMappingURL=import-patterns.js.map

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

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

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

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

package/dist/detectors/telemetry-patterns.js

@@ -0,0 +1,42 @@
+import { sourceParsedFiles } from "../convention-extractor.js";
+export const telemetryPatternDetector = (files, tiers, _warnings) => {
+    const conventions = [];
+    const sourceFiles = sourceParsedFiles(files, tiers);
+    if (sourceFiles.length === 0)
+        return conventions;
+    let telemetryFiles = 0;
+    const telemetryImports = [];
+    for (const f of sourceFiles) {
+        const hasTelemetry = f.imports.some((i) => i.moduleSpecifier.includes("scenario") ||
+            i.moduleSpecifier.includes("telemetry") ||
+            i.moduleSpecifier.includes("logging"));
+        if (hasTelemetry) {
+            telemetryFiles++;
+            const matches = f.imports
+                .filter((i) => i.moduleSpecifier.includes("scenario") ||
+                i.moduleSpecifier.includes("telemetry"))
+                .map((i) => i.moduleSpecifier);
+            telemetryImports.push(...matches);
+        }
+    }
+    if (telemetryFiles > 0) {
+        conventions.push({
+            category: "telemetry",
+            name: "Telemetry instrumentation",
+            description: `Package uses telemetry/scenario instrumentation`,
+            confidence: conf(telemetryFiles, sourceFiles.length),
+            examples: [...new Set(telemetryImports)].slice(0, 3),
+        });
+    }
+    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=telemetry-patterns.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-patterns.js","sourceRoot":"","sources":["../../src/detectors/telemetry-patterns.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D,MAAM,CAAC,MAAM,wBAAwB,GAAuB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;IACtF,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,cAAc,GAAG,CAAC,CAAC;IACvB,MAAM,gBAAgB,GAAa,EAAE,CAAC;IAEtC,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,MAAM,YAAY,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CACjC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,UAAU,CAAC;YACtC,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,WAAW,CAAC;YACvC,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC,CACxC,CAAC;QACF,IAAI,YAAY,EAAE,CAAC;YACjB,cAAc,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO;iBACtB,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,UAAU,CAAC;gBACtC,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,WAAW,CAAC,CAC1C;iBACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;YACjC,gBAAgB,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;QACvB,WAAW,CAAC,IAAI,CAAC;YACf,QAAQ,EAAE,WAAW;YACrB,IAAI,EAAE,2BAA2B;YACjC,WAAW,EAAE,iDAAiD;YAC9D,UAAU,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC;YACpD,QAAQ,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACrD,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"}

package/dist/detectors/test-framework-ecosystem.d.ts

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