@theglitchking/hit-em-with-the-docs 2.0.0

package/dist/core/discover/dependencies.js

@@ -0,0 +1,311 @@
+import { readFile } from 'fs/promises';
+import { join, relative } from 'path';
+import { glob, pathExists } from '../../utils/glob.js';
+import { logger } from '../../utils/logger.js';
+/**
+ * Analyze project dependencies
+ */
+export async function analyzeDependencies(options) {
+    const { rootPath, silent = false } = options;
+    if (!silent) {
+        logger.header('Dependency Analysis');
+        logger.info(`Analyzing: ${rootPath}`);
+    }
+    // Analyze package.json dependencies
+    const packages = await analyzePackages(rootPath);
+    if (!silent) {
+        logger.info(`Found ${packages.total} packages (${packages.production} prod, ${packages.development} dev)`);
+    }
+    // Analyze module imports
+    const modules = await analyzeModules(rootPath);
+    if (!silent) {
+        logger.info(`Analyzed ${modules.totalFiles} files, ${modules.imports} imports`);
+        if (modules.circularDependencies.length > 0) {
+            logger.warn(`Found ${modules.circularDependencies.length} circular dependencies`);
+        }
+    }
+    // Check for security issues (basic check)
+    const security = await analyzeSecurityBasic(packages);
+    // Find unused dependencies
+    const unused = await findUnusedDependencies(rootPath, packages);
+    if (!silent && unused.length > 0) {
+        logger.warn(`Found ${unused.length} potentially unused dependencies`);
+    }
+    return {
+        packages,
+        modules,
+        security,
+        unused,
+    };
+}
+/**
+ * Analyze package.json
+ */
+async function analyzePackages(rootPath) {
+    const result = {
+        total: 0,
+        production: 0,
+        development: 0,
+        dependencies: [],
+        devDependencies: [],
+    };
+    const packageJsonPath = join(rootPath, 'package.json');
+    if (!(await pathExists(packageJsonPath))) {
+        return result;
+    }
+    try {
+        const content = await readFile(packageJsonPath, 'utf-8');
+        const pkg = JSON.parse(content);
+        // Production dependencies
+        if (pkg.dependencies) {
+            for (const [name, version] of Object.entries(pkg.dependencies)) {
+                result.dependencies.push({
+                    name,
+                    version: String(version),
+                    type: 'production',
+                });
+            }
+            result.production = result.dependencies.length;
+        }
+        // Dev dependencies
+        if (pkg.devDependencies) {
+            for (const [name, version] of Object.entries(pkg.devDependencies)) {
+                result.devDependencies.push({
+                    name,
+                    version: String(version),
+                    type: 'development',
+                });
+            }
+            result.development = result.devDependencies.length;
+        }
+        result.total = result.production + result.development;
+    }
+    catch {
+        // Invalid package.json
+    }
+    return result;
+}
+/**
+ * Analyze module imports and dependencies
+ */
+async function analyzeModules(rootPath) {
+    const result = {
+        totalFiles: 0,
+        imports: 0,
+        circularDependencies: [],
+        highCoupling: [],
+    };
+    // Find all source files
+    const files = await glob('**/*.{ts,tsx,js,jsx}', {
+        cwd: rootPath,
+        absolute: true,
+        ignore: ['**/node_modules/**', '**/dist/**', '**/build/**'],
+    });
+    result.totalFiles = files.length;
+    // Build import graph
+    const importGraph = new Map();
+    const importedBy = new Map();
+    for (const file of files) {
+        try {
+            const content = await readFile(file, 'utf-8');
+            const relPath = relative(rootPath, file);
+            // Extract imports
+            const importMatches = content.matchAll(/import\s+.*?from\s+['"]([^'"]+)['"]/g);
+            const imports = new Set();
+            for (const match of importMatches) {
+                const importPath = match[1];
+                if (importPath?.startsWith('.')) {
+                    // Resolve relative import
+                    const resolved = resolveImport(relPath, importPath);
+                    imports.add(resolved);
+                    result.imports++;
+                    // Track imported by
+                    if (!importedBy.has(resolved)) {
+                        importedBy.set(resolved, new Set());
+                    }
+                    importedBy.get(resolved).add(relPath);
+                }
+            }
+            importGraph.set(relPath, imports);
+        }
+        catch {
+            // Skip unreadable files
+        }
+    }
+    // Detect circular dependencies
+    result.circularDependencies = detectCircularDependencies(importGraph);
+    // Find high coupling modules
+    for (const [file, imports] of importGraph) {
+        const importCount = imports.size;
+        const importedByCount = importedBy.get(file)?.size ?? 0;
+        if (importCount > 10 || importedByCount > 10) {
+            result.highCoupling.push({
+                file,
+                imports: importCount,
+                importedBy: importedByCount,
+            });
+        }
+    }
+    // Sort by total coupling
+    result.highCoupling.sort((a, b) => (b.imports + b.importedBy) - (a.imports + a.importedBy));
+    return result;
+}
+/**
+ * Resolve relative import path
+ */
+function resolveImport(fromFile, importPath) {
+    const fromDir = fromFile.split('/').slice(0, -1).join('/');
+    const parts = importPath.split('/');
+    const result = fromDir ? fromDir.split('/') : [];
+    for (const part of parts) {
+        if (part === '.')
+            continue;
+        if (part === '..') {
+            result.pop();
+        }
+        else {
+            result.push(part);
+        }
+    }
+    let resolved = result.join('/');
+    // Add extension if not present
+    if (!resolved.match(/\.[jt]sx?$/)) {
+        resolved += '.ts';
+    }
+    return resolved;
+}
+/**
+ * Detect circular dependencies using DFS
+ */
+function detectCircularDependencies(graph) {
+    const cycles = [];
+    const visited = new Set();
+    const recursionStack = new Set();
+    function dfs(node, path) {
+        if (recursionStack.has(node)) {
+            // Found a cycle
+            const cycleStart = path.indexOf(node);
+            if (cycleStart !== -1) {
+                cycles.push({ files: path.slice(cycleStart) });
+            }
+            return true;
+        }
+        if (visited.has(node)) {
+            return false;
+        }
+        visited.add(node);
+        recursionStack.add(node);
+        path.push(node);
+        const imports = graph.get(node) ?? new Set();
+        for (const imported of imports) {
+            dfs(imported, [...path]);
+        }
+        recursionStack.delete(node);
+        return false;
+    }
+    for (const node of graph.keys()) {
+        if (!visited.has(node)) {
+            dfs(node, []);
+        }
+    }
+    // Deduplicate cycles (same cycle can be detected from different starting points)
+    const uniqueCycles = [];
+    const seen = new Set();
+    for (const cycle of cycles) {
+        const key = [...cycle.files].sort().join('->');
+        if (!seen.has(key)) {
+            seen.add(key);
+            uniqueCycles.push(cycle);
+        }
+    }
+    return uniqueCycles.slice(0, 10); // Limit to first 10
+}
+/**
+ * Basic security check (pattern-based)
+ */
+async function analyzeSecurityBasic(packages) {
+    const vulnerabilities = [];
+    // Known vulnerable packages (simplified - real implementation would use a vulnerability database)
+    const knownVulnerable = {
+        'lodash': {
+            severity: 'high',
+            title: 'Prototype Pollution in lodash < 4.17.21',
+            fix: 'Upgrade to lodash@4.17.21 or higher',
+        },
+        'minimist': {
+            severity: 'moderate',
+            title: 'Prototype Pollution in minimist < 1.2.6',
+            fix: 'Upgrade to minimist@1.2.6 or higher',
+        },
+        'node-fetch': {
+            severity: 'moderate',
+            title: 'Exposure of Sensitive Information in node-fetch < 2.6.7',
+            fix: 'Upgrade to node-fetch@2.6.7 or higher',
+        },
+    };
+    const allPackages = [...packages.dependencies, ...packages.devDependencies];
+    for (const pkg of allPackages) {
+        const vuln = knownVulnerable[pkg.name];
+        if (vuln) {
+            // Check version (simplified - real implementation would do proper semver comparison)
+            vulnerabilities.push({
+                package: pkg.name,
+                severity: vuln.severity,
+                title: vuln.title,
+                recommendation: vuln.fix,
+            });
+        }
+    }
+    return { vulnerabilities };
+}
+/**
+ * Find potentially unused dependencies
+ */
+async function findUnusedDependencies(rootPath, packages) {
+    const unused = [];
+    // Get all source files
+    const files = await glob('**/*.{ts,tsx,js,jsx,json}', {
+        cwd: rootPath,
+        absolute: true,
+        ignore: ['**/node_modules/**', '**/dist/**'],
+    });
+    // Read all file contents
+    let allContent = '';
+    for (const file of files) {
+        try {
+            const content = await readFile(file, 'utf-8');
+            allContent += content + '\n';
+        }
+        catch {
+            // Skip
+        }
+    }
+    // Check each dependency
+    const allPackages = [...packages.dependencies, ...packages.devDependencies];
+    for (const pkg of allPackages) {
+        const name = pkg.name;
+        // Skip common false positives
+        if (['typescript', '@types/', 'eslint', 'prettier', 'vitest', 'jest'].some((p) => name.includes(p))) {
+            continue;
+        }
+        // Check if package is imported
+        const importPatterns = [
+            `from '${name}'`,
+            `from "${name}"`,
+            `require('${name}')`,
+            `require("${name}")`,
+            `from '${name}/`,
+            `from "${name}/`,
+        ];
+        const isUsed = importPatterns.some((p) => allContent.includes(p));
+        if (!isUsed) {
+            unused.push({
+                name,
+                type: pkg.type,
+                reason: 'No import found in source files',
+            });
+        }
+    }
+    return unused;
+}
+//# sourceMappingURL=dependencies.js.map

package/dist/core/discover/dependencies.js.map

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

package/dist/core/discover/patterns.d.ts

@@ -0,0 +1,38 @@
+export interface PatternDiscoveryOptions {
+    rootPath: string;
+    language?: string;
+    category?: string;
+    silent?: boolean;
+}
+export interface DiscoveredPattern {
+    name: string;
+    category: PatternCategory;
+    description: string;
+    occurrences: number;
+    examples: PatternExample[];
+    suggestedDocumentation?: string;
+}
+export interface PatternExample {
+    file: string;
+    line: number;
+    code: string;
+    context?: string;
+}
+export type PatternCategory = 'architecture' | 'data-access' | 'error-handling' | 'security' | 'testing' | 'api' | 'state-management' | 'utility';
+export interface PatternDefinition {
+    name: string;
+    category: PatternCategory;
+    description: string;
+    patterns: RegExp[];
+    filePatterns?: string[];
+    languages?: string[];
+}
+/**
+ * Discover patterns in codebase
+ */
+export declare function discoverPatterns(options: PatternDiscoveryOptions): Promise<DiscoveredPattern[]>;
+/**
+ * Generate documentation suggestion for a pattern
+ */
+export declare function generatePatternDocumentation(pattern: DiscoveredPattern): string;
+//# sourceMappingURL=patterns.d.ts.map

package/dist/core/discover/patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.d.ts","sourceRoot":"","sources":["../../../src/core/discover/patterns.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,UAAU,GACV,SAAS,GACT,KAAK,GACL,kBAAkB,GAClB,SAAS,CAAC;AAEd,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAsND;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAoE9B;AA0FD;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAkC/E"}