autodocs-engine 0.5.0

package/dist/architecture-detector.js

@@ -0,0 +1,212 @@
+// src/architecture-detector.ts — Module 7: Architecture Detector
+// Errata applied: E-30 (remove org-specific name matching, content-based heuristics only)
+import { readdirSync, existsSync, readFileSync } from "node:fs";
+import { resolve, join } from "node:path";
+const DIRECTORY_PURPOSES = {
+    hooks: "Custom hooks",
+    components: "React components",
+    graphql: "GraphQL operations",
+    queries: "GraphQL queries",
+    mutations: "GraphQL mutations",
+    types: "Type definitions",
+    interfaces: "Type definitions",
+    utils: "Utilities",
+    helpers: "Utilities",
+    lib: "Utilities",
+    contexts: "React context",
+    providers: "React context",
+    constants: "Constants",
+    __tests__: "Tests",
+    test: "Tests",
+    tests: "Tests",
+    models: "Data models",
+    services: "Services",
+    api: "API layer",
+};
+export function detectArchitecture(parsedFiles, packageDir, publicAPI, barrelFile, warnings = []) {
+    const absPackageDir = resolve(packageDir);
+    const entryPoint = barrelFile ?? "none";
+    const hasJSX = parsedFiles.some((f) => f.hasJSX && !f.isTestFile && !f.isGeneratedFile);
+    const packageType = classifyPackageType(publicAPI, parsedFiles, absPackageDir);
+    const directories = detectDirectories(parsedFiles, absPackageDir, publicAPI);
+    return { entryPoint, directories, packageType, hasJSX };
+}
+function classifyPackageType(publicAPI, parsedFiles, packageDir) {
+    const nonTypeExports = publicAPI.filter((e) => !e.isTypeOnly);
+    if (nonTypeExports.length === 0) {
+        // W3-3: Check package.json dependencies before defaulting to "unknown"
+        // API servers and web apps often have no barrel exports
+        const depClassification = classifyByDependencies(packageDir);
+        if (depClassification)
+            return depClassification;
+        // Check file content for clues
+        if (parsedFiles.some((f) => f.hasJSX))
+            return "mixed";
+        return "unknown";
+    }
+    const hooks = nonTypeExports.filter((e) => e.kind === "hook").length;
+    const components = nonTypeExports.filter((e) => e.kind === "component").length;
+    const total = nonTypeExports.length;
+    if (hooks > 0 && hooks / total > 0.5)
+        return "hooks";
+    if (components > 0 && components / total > 0.5)
+        return "react-components";
+    if (hooks > 0 || components > 0)
+        return "mixed";
+    // E-30: Content-based heuristics (not org-specific name matching)
+    // Check for GraphQL files
+    const hasGraphql = parsedFiles.some((f) => f.isGeneratedFile && (f.relativePath.includes(".graphql.") ||
+        f.relativePath.includes(".generated.")));
+    if (hasGraphql)
+        return "library"; // was "graphql", now generic per E-30
+    // Check for bin field → CLI
+    try {
+        const pkgJson = JSON.parse(readFileSync(join(packageDir, "package.json"), "utf-8"));
+        if (pkgJson.bin)
+            return "cli";
+    }
+    catch {
+        // No package.json
+    }
+    // W3-3: Check for app/HTTP framework dependencies
+    const depClassification = classifyByDependencies(packageDir);
+    if (depClassification)
+        return depClassification;
+    return "library";
+}
+/**
+ * W3-3: Classify package type by checking dependencies for HTTP/app frameworks.
+ */
+function classifyByDependencies(packageDir) {
+    try {
+        const pkgJson = JSON.parse(readFileSync(join(packageDir, "package.json"), "utf-8"));
+        const allDeps = {
+            ...pkgJson.dependencies,
+            ...pkgJson.devDependencies,
+        };
+        const appFrameworks = ["next", "nuxt", "remix", "astro", "@sveltejs/kit"];
+        if (appFrameworks.some((fw) => fw in allDeps))
+            return "web-application";
+        const httpFrameworks = ["hono", "express", "fastify", "koa", "hapi", "nest", "@hono/node-server"];
+        if (httpFrameworks.some((fw) => fw in allDeps))
+            return "api-server";
+    }
+    catch {
+        // No package.json
+    }
+    return undefined;
+}
+function detectDirectories(parsedFiles, packageDir, publicAPI) {
+    const dirs = [];
+    // Look for src/ directory first
+    const srcDir = join(packageDir, "src");
+    const baseDir = existsSync(srcDir) ? srcDir : packageDir;
+    const baseDirRel = existsSync(srcDir) ? "src" : "";
+    try {
+        const entries = readdirSync(baseDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            if (entry.name.startsWith(".") || entry.name === "node_modules")
+                continue;
+            const dirRelPath = baseDirRel
+                ? `${baseDirRel}/${entry.name}`
+                : entry.name;
+            const filesInDir = parsedFiles.filter((f) => f.relativePath.startsWith(dirRelPath + "/") &&
+                !f.isTestFile &&
+                !f.isGeneratedFile);
+            if (filesInDir.length === 0)
+                continue;
+            const purpose = DIRECTORY_PURPOSES[entry.name] ?? `Feature: ${entry.name}`;
+            // Enhancement 2: Map public exports to this directory
+            const dirExports = publicAPI
+                .filter((e) => e.sourceFile.startsWith(dirRelPath + "/"))
+                .map((e) => e.name);
+            // Enhancement 2: Detect file naming pattern
+            const pattern = detectFilePattern(filesInDir.map((f) => {
+                const parts = f.relativePath.split("/");
+                return parts[parts.length - 1];
+            }));
+            dirs.push({
+                path: dirRelPath,
+                purpose,
+                fileCount: filesInDir.length,
+                exports: dirExports,
+                pattern,
+            });
+        }
+    }
+    catch {
+        // Can't read directory
+    }
+    return dirs.sort((a, b) => b.fileCount - a.fileCount);
+}
+/**
+ * Enhancement 2: Detect file naming pattern from a set of filenames.
+ * Finds the longest common prefix and suffix, with the variable part as {...}.
+ */
+export function detectFilePattern(filenames) {
+    // Filter out index files and non-source files
+    const names = filenames.filter((n) => !n.startsWith("index.") && /\.(ts|tsx|js|jsx)$/.test(n));
+    if (names.length < 3)
+        return undefined;
+    // Strip extension for pattern detection
+    const stripped = names.map((n) => n.replace(/\.(ts|tsx|js|jsx)$/, ""));
+    const commonExt = getMostCommonExtension(filenames);
+    // Find longest common prefix
+    let prefix = "";
+    const first = stripped[0];
+    for (let i = 0; i < first.length; i++) {
+        const char = first[i];
+        if (stripped.every((s) => s.length > i && s[i] === char)) {
+            prefix += char;
+        }
+        else {
+            break;
+        }
+    }
+    // Find longest common suffix
+    let suffix = "";
+    const reversed = stripped.map((s) => [...s].reverse().join(""));
+    const firstRev = reversed[0];
+    for (let i = 0; i < firstRev.length; i++) {
+        const char = firstRev[i];
+        if (reversed.every((s) => s.length > i && s[i] === char)) {
+            suffix = char + suffix;
+        }
+        else {
+            break;
+        }
+    }
+    // Check for overlap between prefix and suffix
+    if (prefix.length + suffix.length >= first.length) {
+        return undefined; // All files have the same name — no pattern
+    }
+    // Only return pattern if prefix or suffix is meaningful (>= 2 chars)
+    if (prefix.length < 2 && suffix.length < 2)
+        return undefined;
+    const variable = prefix.length > 0 || suffix.length > 0
+        ? `${prefix}{...}${suffix}${commonExt}`
+        : undefined;
+    return variable;
+}
+function getMostCommonExtension(filenames) {
+    const counts = new Map();
+    for (const name of filenames) {
+        const match = name.match(/\.(tsx?|jsx?)$/);
+        if (match) {
+            const ext = "." + match[1];
+            counts.set(ext, (counts.get(ext) ?? 0) + 1);
+        }
+    }
+    let maxExt = ".ts";
+    let maxCount = 0;
+    for (const [ext, count] of counts) {
+        if (count > maxCount) {
+            maxExt = ext;
+            maxCount = count;
+        }
+    }
+    return maxExt;
+}
+//# sourceMappingURL=architecture-detector.js.map

package/dist/architecture-detector.js.map

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

package/dist/ast-parser.d.ts

@@ -0,0 +1,5 @@
+import type { ParsedFile, Warning } from "./types.js";
+/**
+ * Parse a single file into a structured representation of its exports, imports, and signals.
+ */
+export declare function parseFile(filePath: string, packageDir: string, warnings?: Warning[]): ParsedFile;