@devness/coverit 0.1.0

package/dist/analysis/code-scanner.js

@@ -0,0 +1,409 @@
+import { Project, SyntaxKind } from "ts-morph";
+import { resolve, relative, extname } from "path";
+const EXTENSION_TO_LANGUAGE = {
+    ".ts": "typescript",
+    ".tsx": "typescript",
+    ".js": "javascript",
+    ".jsx": "javascript",
+    ".mjs": "javascript",
+    ".cjs": "javascript",
+};
+const FILE_TYPE_RULES = [
+    [/\.(test|spec)\.[^/]+$/, "test"],
+    [/\/src-tauri\//, "desktop-window"],
+    [/\/desktop\/.*components?\//, "desktop-component"],
+    [/\/desktop\//, "desktop-window"],
+    [/\/mobile\/.*screens?\//, "mobile-screen"],
+    [/\/mobile\/.*components?\//, "mobile-component"],
+    [/\/expo\/.*screens?\//, "mobile-screen"],
+    [/\/expo\/.*components?\//, "mobile-component"],
+    [/\/routes?\//, "api-route"],
+    [/\/api\//, "api-route"],
+    [/\/controllers?\//, "api-controller"],
+    [/\/middleware\//, "middleware"],
+    [/\/pages?\//, "react-page"],
+    [/\/screens?\//, "react-page"],
+    [/\/hooks?\//, "react-hook"],
+    [/\/components?\//, "react-component"],
+    [/\/services?\//, "service"],
+    [/\/utils?\//, "utility"],
+    [/\/helpers?\//, "utility"],
+    [/\/models?\//, "model"],
+    [/\/entities\//, "model"],
+    [/\/schemas?\//, "schema"],
+    [/\/migrations?\//, "migration"],
+    [/\.(config|rc)\.[^/]+$/, "config"],
+    [/\/config\//, "config"],
+    [/\.(css|scss|sass|less|styl)$/, "style"],
+];
+function detectLanguage(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    return EXTENSION_TO_LANGUAGE[ext] ?? "unknown";
+}
+function detectFileType(filePath) {
+    const normalized = filePath.replace(/\\/g, "/");
+    for (const [pattern, fileType] of FILE_TYPE_RULES) {
+        if (pattern.test(normalized))
+            return fileType;
+    }
+    if (normalized.endsWith(".tsx"))
+        return "react-component";
+    return "unknown";
+}
+/**
+ * Count branching/logical operators in a function body for cyclomatic complexity.
+ * Base complexity is 1 (single path). Each branch point adds 1.
+ */
+function calculateComplexity(node) {
+    let complexity = 1;
+    node.forEachDescendant((descendant) => {
+        switch (descendant.getKind()) {
+            case SyntaxKind.IfStatement:
+            case SyntaxKind.ForStatement:
+            case SyntaxKind.ForInStatement:
+            case SyntaxKind.ForOfStatement:
+            case SyntaxKind.WhileStatement:
+            case SyntaxKind.DoStatement:
+            case SyntaxKind.CatchClause:
+            case SyntaxKind.ConditionalExpression: // ternary
+            case SyntaxKind.CaseClause:
+                complexity++;
+                break;
+            case SyntaxKind.BinaryExpression: {
+                const opToken = descendant.getChildAtIndex(1);
+                if (opToken) {
+                    const opKind = opToken.getKind();
+                    if (opKind === SyntaxKind.AmpersandAmpersandToken ||
+                        opKind === SyntaxKind.BarBarToken ||
+                        opKind === SyntaxKind.QuestionQuestionToken) {
+                        complexity++;
+                    }
+                }
+                break;
+            }
+        }
+    });
+    return complexity;
+}
+function extractParams(params) {
+    return params.map((p) => ({
+        name: p.getName(),
+        type: p.getType().getText() ?? null,
+        isOptional: p.isOptional(),
+        defaultValue: p.getInitializer()?.getText() ?? null,
+    }));
+}
+function extractExports(sourceFile) {
+    const symbols = [];
+    for (const decl of sourceFile.getExportedDeclarations()) {
+        const [name, declarations] = decl;
+        for (const d of declarations) {
+            let kind = "variable";
+            const nodeKind = d.getKind();
+            if (nodeKind === SyntaxKind.FunctionDeclaration)
+                kind = "function";
+            else if (nodeKind === SyntaxKind.ClassDeclaration)
+                kind = "class";
+            else if (nodeKind === SyntaxKind.TypeAliasDeclaration)
+                kind = "type";
+            else if (nodeKind === SyntaxKind.InterfaceDeclaration)
+                kind = "interface";
+            else if (nodeKind === SyntaxKind.EnumDeclaration)
+                kind = "enum";
+            // Check if this is the default export
+            const isDefault = name === "default";
+            symbols.push({
+                name: isDefault ? (d.getSymbol()?.getName() ?? "default") : name,
+                kind,
+                isDefault,
+                line: d.getStartLineNumber(),
+            });
+        }
+    }
+    return symbols;
+}
+function extractImports(sourceFile) {
+    return sourceFile.getImportDeclarations().map((decl) => {
+        const source = decl.getModuleSpecifierValue();
+        const specifiers = [];
+        const defaultImport = decl.getDefaultImport();
+        if (defaultImport) {
+            specifiers.push(defaultImport.getText());
+        }
+        for (const named of decl.getNamedImports()) {
+            specifiers.push(named.getName());
+        }
+        const namespaceImport = decl.getNamespaceImport();
+        if (namespaceImport) {
+            specifiers.push(`* as ${namespaceImport.getText()}`);
+        }
+        // External = not starting with . or /
+        const isExternal = !source.startsWith(".") && !source.startsWith("/");
+        return { source, specifiers, isExternal };
+    });
+}
+function extractFunctions(sourceFile) {
+    const functions = [];
+    // Top-level function declarations
+    for (const fn of sourceFile.getFunctions()) {
+        functions.push({
+            name: fn.getName() ?? "(anonymous)",
+            params: extractParams(fn.getParameters()),
+            returnType: fn.getReturnTypeNode()?.getText() ?? null,
+            isAsync: fn.isAsync(),
+            isExported: fn.isExported(),
+            line: fn.getStartLineNumber(),
+            complexity: calculateComplexity(fn),
+        });
+    }
+    // Top-level variable declarations with arrow functions
+    for (const stmt of sourceFile.getVariableStatements()) {
+        const isExported = stmt.isExported();
+        for (const decl of stmt.getDeclarations()) {
+            const initializer = decl.getInitializer();
+            if (!initializer)
+                continue;
+            const isArrow = initializer.getKind() === SyntaxKind.ArrowFunction;
+            const isFnExpr = initializer.getKind() === SyntaxKind.FunctionExpression;
+            if (isArrow || isFnExpr) {
+                const fn = initializer;
+                functions.push({
+                    name: decl.getName(),
+                    params: extractParams(fn.getParameters()),
+                    returnType: fn.getReturnTypeNode()?.getText() ?? null,
+                    isAsync: fn.isAsync(),
+                    isExported,
+                    line: decl.getStartLineNumber(),
+                    complexity: calculateComplexity(initializer),
+                });
+            }
+        }
+    }
+    return functions;
+}
+function extractClasses(sourceFile) {
+    return sourceFile.getClasses().map((cls) => {
+        const methods = cls.getMethods().map((m) => ({
+            name: m.getName(),
+            params: extractParams(m.getParameters()),
+            returnType: m.getReturnTypeNode()?.getText() ?? null,
+            isAsync: m.isAsync(),
+            isExported: false,
+            line: m.getStartLineNumber(),
+            complexity: calculateComplexity(m),
+        }));
+        const properties = cls.getProperties().map((p) => ({
+            name: p.getName(),
+            type: p.getTypeNode()?.getText() ?? null,
+            isPublic: p.getScope() === undefined ||
+                p.getScope() === "public" ||
+                // ts-morph returns undefined for implicit public
+                !["private", "protected"].includes(p.getScope() ?? ""),
+        }));
+        return {
+            name: cls.getName() ?? "(anonymous)",
+            methods,
+            properties,
+            isExported: cls.isExported(),
+            line: cls.getStartLineNumber(),
+        };
+    });
+}
+/**
+ * Detect HTTP endpoint registrations:
+ * - Hono: app.get('/path', handler), app.post(...)
+ * - Express: router.get('/path', handler), app.post(...)
+ * - NestJS: @Get('/path'), @Post('/path') decorators
+ */
+function extractEndpoints(sourceFile) {
+    const endpoints = [];
+    const httpMethods = ["get", "post", "put", "patch", "delete"];
+    const toUpper = (m) => m.toUpperCase();
+    // Hono / Express style: app.get('/path', handler) or router.post(...)
+    for (const callExpr of sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression)) {
+        const expr = callExpr.getExpression();
+        if (expr.getKind() !== SyntaxKind.PropertyAccessExpression)
+            continue;
+        const propAccess = expr.asKind(SyntaxKind.PropertyAccessExpression);
+        if (!propAccess)
+            continue;
+        const methodName = propAccess.getName().toLowerCase();
+        if (!httpMethods.includes(methodName))
+            continue;
+        const args = callExpr.getArguments();
+        if (args.length === 0)
+            continue;
+        const firstArg = args[0];
+        // First argument should be a string literal (the path)
+        if (firstArg.getKind() !== SyntaxKind.StringLiteral)
+            continue;
+        const path = firstArg.getText().replace(/['"]/g, "");
+        const middleware = [];
+        let handler = "(anonymous)";
+        // Last argument is the handler, middle arguments are middleware
+        for (let i = 1; i < args.length; i++) {
+            const arg = args[i];
+            const text = arg.getText();
+            if (i === args.length - 1) {
+                handler = text.includes("=>") || text.includes("function") ? "(inline)" : text;
+            }
+            else {
+                middleware.push(text);
+            }
+        }
+        endpoints.push({
+            method: toUpper(methodName),
+            path,
+            handler,
+            middleware,
+            line: callExpr.getStartLineNumber(),
+        });
+    }
+    // NestJS decorators: @Get('/path'), @Post('/path')
+    const decoratorMethods = {
+        Get: "GET",
+        Post: "POST",
+        Put: "PUT",
+        Patch: "PATCH",
+        Delete: "DELETE",
+    };
+    for (const cls of sourceFile.getClasses()) {
+        for (const method of cls.getMethods()) {
+            for (const decorator of method.getDecorators()) {
+                const decoratorName = decorator.getName();
+                const httpMethod = decoratorMethods[decoratorName];
+                if (!httpMethod)
+                    continue;
+                const decoratorArgs = decorator.getArguments();
+                const path = decoratorArgs.length > 0
+                    ? decoratorArgs[0].getText().replace(/['"]/g, "")
+                    : "/";
+                // Collect middleware decorators like @UseGuards, @UseInterceptors
+                const middleware = method
+                    .getDecorators()
+                    .filter((d) => d.getName() !== decoratorName)
+                    .map((d) => d.getName());
+                endpoints.push({
+                    method: httpMethod,
+                    path,
+                    handler: method.getName(),
+                    middleware,
+                    line: decorator.getStartLineNumber(),
+                });
+            }
+        }
+    }
+    return endpoints;
+}
+/**
+ * Detect React function components that return JSX.
+ * Identifies props interface and hook usage.
+ */
+function extractComponents(sourceFile) {
+    const components = [];
+    const filePath = sourceFile.getFilePath();
+    // Only check tsx/jsx files (or files already identified as component types)
+    if (!filePath.endsWith(".tsx") && !filePath.endsWith(".jsx")) {
+        return components;
+    }
+    // Check exported function declarations returning JSX
+    for (const fn of sourceFile.getFunctions()) {
+        if (!fn.isExported())
+            continue;
+        const name = fn.getName();
+        if (!name || !/^[A-Z]/.test(name))
+            continue; // React components are PascalCase
+        if (containsJsx(fn)) {
+            components.push({
+                name,
+                props: extractParams(fn.getParameters()),
+                hooks: extractHooks(fn),
+                isPage: isPageComponent(filePath),
+                line: fn.getStartLineNumber(),
+            });
+        }
+    }
+    // Check exported arrow functions returning JSX
+    for (const stmt of sourceFile.getVariableStatements()) {
+        if (!stmt.isExported())
+            continue;
+        for (const decl of stmt.getDeclarations()) {
+            const name = decl.getName();
+            if (!/^[A-Z]/.test(name))
+                continue;
+            const initializer = decl.getInitializer();
+            if (!initializer)
+                continue;
+            if (initializer.getKind() === SyntaxKind.ArrowFunction ||
+                initializer.getKind() === SyntaxKind.FunctionExpression) {
+                if (containsJsx(initializer)) {
+                    const fn = initializer;
+                    components.push({
+                        name,
+                        props: extractParams(fn.getParameters()),
+                        hooks: extractHooks(initializer),
+                        isPage: isPageComponent(filePath),
+                        line: decl.getStartLineNumber(),
+                    });
+                }
+            }
+        }
+    }
+    return components;
+}
+function containsJsx(node) {
+    return (node.getDescendantsOfKind(SyntaxKind.JsxElement).length > 0 ||
+        node.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement).length > 0 ||
+        node.getDescendantsOfKind(SyntaxKind.JsxFragment).length > 0);
+}
+/**
+ * Extract React hook calls (useXxx pattern) from a function body.
+ */
+function extractHooks(node) {
+    const hooks = new Set();
+    for (const call of node.getDescendantsOfKind(SyntaxKind.CallExpression)) {
+        const expr = call.getExpression();
+        const text = expr.getText();
+        // Match useXxx pattern (built-in and custom hooks)
+        if (/^use[A-Z]/.test(text)) {
+            hooks.add(text);
+        }
+    }
+    return Array.from(hooks);
+}
+function isPageComponent(filePath) {
+    const normalized = filePath.replace(/\\/g, "/");
+    return /\/(pages?|screens?)\//.test(normalized);
+}
+/**
+ * Perform AST-level code analysis on a TypeScript/JavaScript file.
+ *
+ * @param filePath - Absolute path to the source file
+ * @param projectRoot - Absolute path to the project root (for relative path computation)
+ */
+export async function scanCode(filePath, projectRoot) {
+    const absolutePath = resolve(filePath);
+    const relPath = relative(resolve(projectRoot), absolutePath);
+    const project = new Project({
+        compilerOptions: {
+            allowJs: true,
+            jsx: 2, // React
+            noEmit: true,
+            strict: false, // Lenient for scanning; we're reading structure, not type-checking
+        },
+        skipAddingFilesFromTsConfig: true,
+    });
+    const sourceFile = project.addSourceFileAtPath(absolutePath);
+    return {
+        file: relPath,
+        language: detectLanguage(absolutePath),
+        fileType: detectFileType(relPath),
+        exports: extractExports(sourceFile),
+        imports: extractImports(sourceFile),
+        functions: extractFunctions(sourceFile),
+        classes: extractClasses(sourceFile),
+        endpoints: extractEndpoints(sourceFile),
+        components: extractComponents(sourceFile),
+    };
+}
+//# sourceMappingURL=code-scanner.js.map

package/dist/analysis/code-scanner.js.map

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

package/dist/analysis/dependency-graph.d.ts

@@ -0,0 +1,9 @@
+import type { DependencyGraph } from "../types/index.js";
+/**
+ * Build a dependency graph mapping each file to its direct dependencies and dependents.
+ *
+ * @param projectRoot - Absolute path to the project root
+ * @param files - Optional subset of files to include. If omitted, all source files are discovered.
+ */
+export declare function buildDependencyGraph(projectRoot: string, files?: string[]): Promise<DependencyGraph>;
+//# sourceMappingURL=dependency-graph.d.ts.map

package/dist/analysis/dependency-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-graph.d.ts","sourceRoot":"","sources":["../../src/analysis/dependency-graph.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AA8FzD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,MAAM,EAAE,GACf,OAAO,CAAC,eAAe,CAAC,CAwE1B"}

package/dist/analysis/dependency-graph.js

@@ -0,0 +1,149 @@
+import fg from "fast-glob";
+import { resolve, dirname, relative } from "path";
+import { readFile } from "fs/promises";
+/** Source file extensions we trace imports through. */
+const SOURCE_EXTENSIONS = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"];
+/** Glob patterns for discovering source files. */
+const SOURCE_GLOBS = ["**/*.{ts,tsx,js,jsx,mjs,cjs}"];
+/** Directories to exclude from scanning. */
+const IGNORE_PATTERNS = [
+    "**/node_modules/**",
+    "**/dist/**",
+    "**/build/**",
+    "**/.next/**",
+    "**/coverage/**",
+    "**/__mocks__/**",
+];
+/**
+ * Regex to match import/require statements and extract the module specifier.
+ * Handles:
+ *   import ... from "specifier"
+ *   import "specifier"
+ *   export ... from "specifier"
+ *   require("specifier")
+ *   dynamic import("specifier")
+ */
+const IMPORT_REGEX = /(?:import\s+(?:[\s\S]*?\s+from\s+)?["']([^"']+)["']|export\s+(?:[\s\S]*?\s+from\s+)?["']([^"']+)["']|require\s*\(\s*["']([^"']+)["']\s*\)|import\s*\(\s*["']([^"']+)["']\s*\))/g;
+/**
+ * Resolve a relative import specifier to an absolute file path.
+ * Tries the specifier as-is, then with each source extension appended,
+ * then as a directory index file.
+ */
+function resolveImport(specifier, importerDir, allFiles) {
+    // Only resolve relative imports
+    if (!specifier.startsWith("."))
+        return null;
+    const basePath = resolve(importerDir, specifier);
+    // Direct match (specifier already has extension)
+    if (allFiles.has(basePath))
+        return basePath;
+    // Try appending source extensions
+    for (const ext of SOURCE_EXTENSIONS) {
+        const withExt = basePath + ext;
+        if (allFiles.has(withExt))
+            return withExt;
+    }
+    // Strip .js extension and try .ts/.tsx (common in ESM projects importing .js that are actually .ts)
+    if (specifier.endsWith(".js")) {
+        const stripped = basePath.slice(0, -3);
+        for (const ext of [".ts", ".tsx"]) {
+            const mapped = stripped + ext;
+            if (allFiles.has(mapped))
+                return mapped;
+        }
+    }
+    // Try as directory index
+    for (const ext of SOURCE_EXTENSIONS) {
+        const indexPath = resolve(basePath, `index${ext}`);
+        if (allFiles.has(indexPath))
+            return indexPath;
+    }
+    return null;
+}
+/**
+ * Extract import specifiers from file content using regex.
+ * Faster than full AST parsing for dependency graph purposes.
+ */
+function extractImportSpecifiers(content) {
+    const specifiers = [];
+    let match;
+    // Reset lastIndex for the global regex
+    IMPORT_REGEX.lastIndex = 0;
+    while ((match = IMPORT_REGEX.exec(content)) !== null) {
+        // One of the capture groups will have the specifier
+        const specifier = match[1] ?? match[2] ?? match[3] ?? match[4];
+        if (specifier) {
+            specifiers.push(specifier);
+        }
+    }
+    return specifiers;
+}
+/**
+ * Build a dependency graph mapping each file to its direct dependencies and dependents.
+ *
+ * @param projectRoot - Absolute path to the project root
+ * @param files - Optional subset of files to include. If omitted, all source files are discovered.
+ */
+export async function buildDependencyGraph(projectRoot, files) {
+    const root = resolve(projectRoot);
+    // Discover all source files for import resolution
+    const allSourceFiles = await fg(SOURCE_GLOBS, {
+        cwd: root,
+        absolute: true,
+        ignore: IGNORE_PATTERNS,
+    });
+    const allFilesSet = new Set(allSourceFiles);
+    // Determine which files to analyze (all or a provided subset)
+    const filesToAnalyze = files
+        ? files.map((f) => resolve(root, f)).filter((f) => allFilesSet.has(f))
+        : allSourceFiles;
+    const graph = new Map();
+    // Initialize nodes for all discovered files so dependedBy edges are complete
+    for (const absPath of allSourceFiles) {
+        const relPath = relative(root, absPath);
+        if (!graph.has(relPath)) {
+            graph.set(relPath, { file: relPath, dependsOn: [], dependedBy: [] });
+        }
+    }
+    // Parse imports and build forward edges (dependsOn)
+    const readPromises = filesToAnalyze.map(async (absPath) => {
+        const relPath = relative(root, absPath);
+        let node = graph.get(relPath);
+        if (!node) {
+            node = { file: relPath, dependsOn: [], dependedBy: [] };
+            graph.set(relPath, node);
+        }
+        try {
+            const content = await readFile(absPath, "utf-8");
+            const specifiers = extractImportSpecifiers(content);
+            const importerDir = dirname(absPath);
+            for (const spec of specifiers) {
+                const resolved = resolveImport(spec, importerDir, allFilesSet);
+                if (!resolved)
+                    continue;
+                const resolvedRel = relative(root, resolved);
+                // Avoid self-references
+                if (resolvedRel === relPath)
+                    continue;
+                if (!node.dependsOn.includes(resolvedRel)) {
+                    node.dependsOn.push(resolvedRel);
+                }
+            }
+        }
+        catch {
+            // File may have been deleted or be unreadable; skip silently
+        }
+    });
+    await Promise.all(readPromises);
+    // Build reverse edges (dependedBy) from forward edges
+    for (const [filePath, node] of graph) {
+        for (const dep of node.dependsOn) {
+            const depNode = graph.get(dep);
+            if (depNode && !depNode.dependedBy.includes(filePath)) {
+                depNode.dependedBy.push(filePath);
+            }
+        }
+    }
+    return graph;
+}
+//# sourceMappingURL=dependency-graph.js.map

package/dist/analysis/dependency-graph.js.map

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

package/dist/analysis/diff-analyzer.d.ts

@@ -0,0 +1,9 @@
+import type { DiffResult } from "../types/index.js";
+/**
+ * Analyze git diff to identify changed files with metadata.
+ *
+ * @param projectRoot - Absolute path to the git repository root
+ * @param baseBranch - Branch to diff against (defaults to HEAD for uncommitted changes)
+ */
+export declare function analyzeDiff(projectRoot: string, baseBranch?: string): Promise<DiffResult>;
+//# sourceMappingURL=diff-analyzer.d.ts.map

package/dist/analysis/diff-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-analyzer.d.ts","sourceRoot":"","sources":["../../src/analysis/diff-analyzer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EAKX,MAAM,mBAAmB,CAAC;AA+I3B;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,CAAC,CAgHrB"}