codesummary 1.2.0 → 1.2.2

package/src/analysis/repositorySignals.js

@@ -0,0 +1,196 @@
+import path from 'path';
+
+/**
+ * RepositorySignals
+ * Shared heuristics that can be reused by multiple output generators.
+ */
+export default class RepositorySignals {
+  /**
+   * Extract file tags based on path and filename heuristics.
+   * @param {string} relativePath - Relative file path
+   * @param {string} extension - File extension
+   * @returns {Array} Array of tags
+   */
+  extractFileTags(relativePath, extension) {
+    const tags = [];
+    const pathLower = relativePath.toLowerCase();
+    const fileName = path.basename(relativePath, extension).toLowerCase();
+    const fullPath = relativePath.toLowerCase();
+
+    if (pathLower.includes('/test/') || pathLower.includes('\\test\\')) tags.push('test');
+    if (pathLower.includes('/spec/') || pathLower.includes('\\spec\\')) tags.push('test');
+    if (pathLower.includes('/__tests__/') || pathLower.includes('\\__tests__\\')) tags.push('test');
+    if (pathLower.includes('/scripts/') || pathLower.includes('\\scripts\\')) tags.push('script');
+    if (pathLower.includes('/config/') || pathLower.includes('\\config\\')) tags.push('config');
+    if (pathLower.includes('/lib/') || pathLower.includes('\\lib\\')) tags.push('library');
+    if (pathLower.includes('/utils/') || pathLower.includes('\\utils\\')) tags.push('utility');
+    if (pathLower.includes('/helpers/') || pathLower.includes('\\helpers\\')) tags.push('utility');
+
+    if (pathLower.includes('/pages/') || pathLower.includes('\\pages\\')) tags.push('page');
+    if (pathLower.includes('/components/') || pathLower.includes('\\components\\')) tags.push('component');
+    if (pathLower.includes('/shared/') || pathLower.includes('\\shared\\')) tags.push('shared');
+    if (pathLower.includes('/common/') || pathLower.includes('\\common\\')) tags.push('shared');
+    if (pathLower.includes('/hooks/') || pathLower.includes('\\hooks\\')) tags.push('hook');
+    if (pathLower.includes('/services/') || pathLower.includes('\\services\\')) tags.push('service');
+    if (pathLower.includes('/api/') || pathLower.includes('\\api\\')) tags.push('api');
+    if (pathLower.includes('/routes/') || pathLower.includes('\\routes\\')) tags.push('route');
+    if (pathLower.includes('/controllers/') || pathLower.includes('\\controllers\\')) tags.push('controller');
+    if (pathLower.includes('/models/') || pathLower.includes('\\models\\')) tags.push('model');
+    if (pathLower.includes('/views/') || pathLower.includes('\\views\\')) tags.push('view');
+    if (pathLower.includes('/layouts/') || pathLower.includes('\\layouts\\')) tags.push('layout');
+    if (pathLower.includes('/middleware/') || pathLower.includes('\\middleware\\')) tags.push('middleware');
+
+    if (pathLower.includes('/build/') || pathLower.includes('\\build\\')) tags.push('build');
+    if (pathLower.includes('/dist/') || pathLower.includes('\\dist\\')) tags.push('build');
+    if (pathLower.includes('/.github/') || pathLower.includes('\\.github\\')) tags.push('ci');
+    if (pathLower.includes('/workflows/') || pathLower.includes('\\workflows\\')) tags.push('ci');
+
+    if (fileName.includes('config')) tags.push('config');
+    if (fileName.includes('test') || fileName.includes('spec')) tags.push('test');
+    if (fileName.includes('index')) tags.push('entry');
+    if (fileName.includes('main')) tags.push('entry');
+    if (fileName.includes('app')) tags.push('application');
+    if (fileName.includes('component')) tags.push('component');
+    if (fileName.includes('page')) tags.push('page');
+    if (fileName.includes('layout')) tags.push('layout');
+    if (fileName.includes('service')) tags.push('service');
+    if (fileName.includes('util') || fileName.includes('helper')) tags.push('utility');
+    if (fileName.includes('hook')) tags.push('hook');
+    if (fileName.includes('api')) tags.push('api');
+    if (fileName.includes('route')) tags.push('route');
+    if (fileName.includes('model')) tags.push('model');
+    if (fileName.includes('controller')) tags.push('controller');
+    if (fileName.includes('middleware')) tags.push('middleware');
+    if (fileName.includes('store') || fileName.includes('state')) tags.push('state');
+    if (fileName.includes('context')) tags.push('context');
+    if (fileName.includes('provider')) tags.push('provider');
+
+    if (['.test.js', '.spec.js', '.test.ts', '.spec.ts', '.test.tsx', '.spec.tsx'].some(ext => fullPath.endsWith(ext))) {
+      tags.push('test');
+    }
+    if (['.d.ts'].some(ext => fullPath.endsWith(ext))) {
+      tags.push('types');
+    }
+    if (['.stories.js', '.stories.ts', '.stories.tsx'].some(ext => fullPath.endsWith(ext))) {
+      tags.push('storybook');
+    }
+    if (['.cy.js', '.cy.ts'].some(ext => fullPath.endsWith(ext))) {
+      tags.push('e2e');
+    }
+
+    if (extension === '.tsx' || extension === '.jsx') {
+      tags.push('react');
+    }
+    if (fullPath.includes('vue') || extension === '.vue') {
+      tags.push('vue');
+    }
+    if (fullPath.includes('angular') || fullPath.includes('.component.') || fullPath.includes('.service.')) {
+      tags.push('angular');
+    }
+    if (fullPath.includes('next') || fullPath.includes('_app.') || fullPath.includes('_document.')) {
+      tags.push('nextjs');
+    }
+
+    if (['readme', 'license', 'changelog', 'contributing'].includes(fileName)) {
+      tags.push('documentation');
+    }
+    if (['dockerfile', 'docker-compose', '.dockerignore'].includes(fileName)) {
+      tags.push('docker');
+    }
+    if (['package.json', 'package-lock.json', 'yarn.lock', 'pnpm-lock.yaml'].includes(path.basename(relativePath))) {
+      tags.push('package');
+    }
+    if (['tsconfig.json', 'jsconfig.json', 'webpack.config.js', 'vite.config.js'].includes(path.basename(relativePath))) {
+      tags.push('config');
+    }
+
+    if (extension === '.bat' || extension === '.cmd') {
+      tags.push('infrastructure', 'script', 'windows');
+    }
+    if (extension === '.sh') {
+      tags.push('infrastructure', 'script', 'unix');
+    }
+    if (extension === '.json' && (fileName.includes('config') || fileName.includes('settings') || fileName.includes('.config.'))) {
+      tags.push('infrastructure', 'config');
+    }
+    if (['makefile', 'makefile.am', 'cmake', 'cmakelists.txt'].includes(fileName)) {
+      tags.push('infrastructure', 'build');
+    }
+    if (['readme', 'license', 'changelog', 'contributing'].includes(fileName)) {
+      tags.push('documentation');
+    }
+
+    return [...new Set(tags)];
+  }
+
+  /**
+   * Extract imports from content using simple regex.
+   * @param {string} content - File content
+   * @param {string} extension - File extension
+   * @returns {Array} Array of import statements
+   */
+  extractImports(content, extension) {
+    const imports = [];
+
+    switch (extension) {
+      case '.js':
+      case '.jsx':
+      case '.ts':
+      case '.tsx': {
+        const importRegex = /import\s+.*?from\s+['"]([^'"]+)['"]/g;
+        let match;
+        while ((match = importRegex.exec(content)) !== null) {
+          imports.push(match[1]);
+        }
+
+        const requireRegex = /require\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
+        while ((match = requireRegex.exec(content)) !== null) {
+          imports.push(match[1]);
+        }
+        break;
+      }
+      case '.py': {
+        const pyImportRegex = /(?:from\s+(\S+)\s+import|import\s+(\S+))/g;
+        let match;
+        while ((match = pyImportRegex.exec(content)) !== null) {
+          imports.push(match[1] || match[2]);
+        }
+        break;
+      }
+      case '.c':
+      case '.cpp':
+      case '.h': {
+        const includeRegex = /#include\s*[<"]([^>"]+)[>"]/g;
+        let match;
+        while ((match = includeRegex.exec(content)) !== null) {
+          imports.push(match[1]);
+        }
+        break;
+      }
+    }
+
+    return [...new Set(imports)];
+  }
+
+  /**
+   * Extract function/method calls using simple regex.
+   * @param {string} content - File content
+   * @returns {Array} Array of function calls
+   */
+  extractCalls(content) {
+    const calls = [];
+    const callRegex = /\b([a-zA-Z_][a-zA-Z0-9_]*)\s*\(/g;
+    let match;
+
+    while ((match = callRegex.exec(content)) !== null) {
+      const funcName = match[1];
+      const keywords = ['if', 'for', 'while', 'switch', 'catch', 'typeof', 'return', 'new'];
+
+      if (!keywords.includes(funcName) && funcName.length > 1) {
+        calls.push(funcName);
+      }
+    }
+
+    return [...new Set(calls)].slice(0, 20);
+  }
+}