bluera-knowledge 0.9.32 → 0.9.34

package/src/analysis/dependency-usage-analyzer.ts

@@ -1,15 +1,30 @@
-import { readFile, readdir } from 'node:fs/promises';
 import { existsSync } from 'node:fs';
+import { readFile, readdir } from 'node:fs/promises';
 import { join, extname } from 'node:path';
 import { ASTParser } from './ast-parser.js';
-import type { Result } from '../types/result.js';
 import { ok, err } from '../types/result.js';
 import type { SupportedLanguage } from './repo-url-resolver.js';
+import type { Result } from '../types/result.js';
 
 const TEXT_EXTENSIONS = new Set([
-  '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
-  '.py', '.rb', '.go', '.java', '.rs', '.php',
-  '.md', '.txt', '.json', '.yml', '.yaml', '.toml'
+  '.ts',
+  '.tsx',
+  '.js',
+  '.jsx',
+  '.mjs',
+  '.cjs',
+  '.py',
+  '.rb',
+  '.go',
+  '.java',
+  '.rs',
+  '.php',
+  '.md',
+  '.txt',
+  '.json',
+  '.yml',
+  '.yaml',
+  '.toml',
 ]);
 
 export interface PackageUsage {
@@ -60,7 +75,7 @@ export class DependencyUsageAnalyzer {
           usages: [],
           totalFilesScanned: 0,
           skippedFiles: 0,
-          analysisTimeMs: Date.now() - startTime
+          analysisTimeMs: Date.now() - startTime,
         });
       }
 
@@ -72,7 +87,7 @@ export class DependencyUsageAnalyzer {
           usages: [],
           totalFilesScanned: 0,
           skippedFiles: 0,
-          analysisTimeMs: Date.now() - startTime
+          analysisTimeMs: Date.now() - startTime,
         });
       }
 
@@ -92,20 +107,18 @@ export class DependencyUsageAnalyzer {
             if (packageName !== null && declaredDeps.has(packageName)) {
               const dep = declaredDeps.get(packageName);
               if (dep !== undefined) {
-                this.incrementUsage(
-                  usageMap,
-                  packageName,
-                  filePath,
-                  dep.isDev,
-                  dep.language
-                );
+                this.incrementUsage(usageMap, packageName, filePath, dep.isDev, dep.language);
               }
             }
           }
 
           processedCount++;
           if (onProgress !== undefined && processedCount % 10 === 0) {
-            onProgress(processedCount, files.length, `Analyzed ${String(processedCount)}/${String(files.length)} files`);
+            onProgress(
+              processedCount,
+              files.length,
+              `Analyzed ${String(processedCount)}/${String(files.length)} files`
+            );
           }
         } catch {
           // Skip files that can't be read or parsed
@@ -114,14 +127,15 @@ export class DependencyUsageAnalyzer {
       }
 
       // 4. Sort by usage frequency
-      const sortedUsages = Array.from(usageMap.values())
-        .sort((a, b) => b.importCount - a.importCount);
+      const sortedUsages = Array.from(usageMap.values()).sort(
+        (a, b) => b.importCount - a.importCount
+      );
 
       return ok({
         usages: sortedUsages,
         totalFilesScanned: processedCount,
         skippedFiles: skippedCount,
-        analysisTimeMs: Date.now() - startTime
+        analysisTimeMs: Date.now() - startTime,
       });
     } catch (error) {
       const errorObj = new Error(
@@ -178,7 +192,10 @@ export class DependencyUsageAnalyzer {
     return [];
   }
 
-  private extractImportsRegex(content: string, language: 'javascript' | 'python'): Array<{ source: string }> {
+  private extractImportsRegex(
+    content: string,
+    language: 'javascript' | 'python'
+  ): Array<{ source: string }> {
     const imports: Array<{ source: string }> = [];
 
     if (language === 'javascript') {
@@ -234,7 +251,7 @@ export class DependencyUsageAnalyzer {
         fileCount: 1,
         files: [filePath],
         isDevDependency,
-        language
+        language,
       });
     }
   }
@@ -250,7 +267,18 @@ export class DependencyUsageAnalyzer {
 
         if (entry.isDirectory()) {
           // Skip common ignored directories
-          if (!['node_modules', '.git', 'dist', 'build', 'coverage', '__pycache__', '.venv', 'venv'].includes(entry.name)) {
+          if (
+            ![
+              'node_modules',
+              '.git',
+              'dist',
+              'build',
+              'coverage',
+              '__pycache__',
+              '.venv',
+              'venv',
+            ].includes(entry.name)
+          ) {
             files.push(...(await this.scanDirectory(fullPath)));
           }
         } else if (entry.isFile()) {
@@ -312,7 +340,7 @@ export class DependencyUsageAnalyzer {
 
           // Parse package name (before ==, >=, etc.)
           const match = /^([a-zA-Z0-9_-]+)/.exec(trimmed);
-          if (match !== null && match[1] !== undefined) {
+          if (match?.[1] !== undefined) {
             const name = match[1].toLowerCase();
             deps.set(name, { name, isDev: false, language: 'python' });
           }
@@ -350,7 +378,7 @@ export class DependencyUsageAnalyzer {
         // or serde = { version = "1.0", features = [...] }
         const inDepsSection = /\[dependencies\]([\s\S]*?)(?=\n\[|$)/;
         const depsMatch = inDepsSection.exec(content);
-        if (depsMatch !== null && depsMatch[1] !== undefined) {
+        if (depsMatch?.[1] !== undefined) {
           const depsSection = depsMatch[1];
           // Match crate names at start of lines
           const cratePattern = /^([a-zA-Z0-9_-]+)\s*=/gm;
@@ -364,7 +392,7 @@ export class DependencyUsageAnalyzer {
         // Also check [dev-dependencies]
         const inDevDepsSection = /\[dev-dependencies\]([\s\S]*?)(?=\n\[|$)/;
         const devDepsMatch = inDevDepsSection.exec(content);
-        if (devDepsMatch !== null && devDepsMatch[1] !== undefined) {
+        if (devDepsMatch?.[1] !== undefined) {
           const devDepsSection = devDepsMatch[1];
           const cratePattern = /^([a-zA-Z0-9_-]+)\s*=/gm;
           for (const match of devDepsSection.matchAll(cratePattern)) {

package/src/analysis/go-ast-parser.test.ts

@@ -14,7 +14,7 @@ describe('GoASTParser', () => {
         type: 'function',
         name: 'hello',
         exported: false,
-        async: false
+        async: false,
       });
     });
 
@@ -68,9 +68,9 @@ func Third() int { return 3 }
       `.trim();
       const nodes = parser.parse(code, 'test.go');
 
-      const functions = nodes.filter(n => n.type === 'function');
+      const functions = nodes.filter((n) => n.type === 'function');
       expect(functions).toHaveLength(3);
-      expect(functions.map(f => f.name)).toEqual(['first', 'second', 'Third']);
+      expect(functions.map((f) => f.name)).toEqual(['first', 'second', 'Third']);
       expect(functions[2]?.exported).toBe(true);
     });
   });
@@ -84,7 +84,7 @@ func Third() int { return 3 }
       expect(nodes[0]).toMatchObject({
         type: 'class',
         name: 'user',
-        exported: false
+        exported: false,
       });
     });
 
@@ -139,7 +139,7 @@ type Data struct {
       expect(nodes[0]).toMatchObject({
         type: 'interface',
         name: 'drawable',
-        exported: false
+        exported: false,
       });
       expect(nodes[0]?.methods).toBeDefined();
     });
@@ -195,7 +195,7 @@ type Animal interface {
       expect(nodes[0]).toMatchObject({
         type: 'type',
         name: 'myInt',
-        exported: false
+        exported: false,
       });
     });
 
@@ -224,7 +224,7 @@ type Animal interface {
       expect(nodes[0]).toMatchObject({
         type: 'const',
         name: 'maxSize',
-        exported: false
+        exported: false,
       });
     });
 
@@ -254,9 +254,9 @@ const (
       `.trim();
       const nodes = parser.parse(code, 'test.go');
 
-      const constants = nodes.filter(n => n.type === 'const');
+      const constants = nodes.filter((n) => n.type === 'const');
       expect(constants).toHaveLength(3);
-      expect(constants.map(c => c.name)).toEqual(['Red', 'Green', 'Blue']);
+      expect(constants.map((c) => c.name)).toEqual(['Red', 'Green', 'Blue']);
     });
 
     it('parses var declaration', () => {
@@ -265,7 +265,7 @@ const (
 
       expect(nodes[0]).toMatchObject({
         type: 'const',
-        name: 'counter'
+        name: 'counter',
       });
     });
   });
@@ -281,7 +281,7 @@ func (u User) GetName() string {
       `.trim();
       const nodes = parser.parse(code, 'test.go');
 
-      const userStruct = nodes.find(n => n.name === 'User');
+      const userStruct = nodes.find((n) => n.name === 'User');
       expect(userStruct).toBeDefined();
       expect(userStruct?.methods).toHaveLength(1);
       expect(userStruct?.methods?.[0]?.name).toBe('GetName');
@@ -297,7 +297,7 @@ func (c *Counter) Increment() {
       `.trim();
       const nodes = parser.parse(code, 'test.go');
 
-      const counter = nodes.find(n => n.name === 'Counter');
+      const counter = nodes.find((n) => n.name === 'Counter');
       expect(counter?.methods).toHaveLength(1);
       expect(counter?.methods?.[0]?.name).toBe('Increment');
     });
@@ -318,9 +318,9 @@ func (s *Stack) Pop() int {
       `.trim();
       const nodes = parser.parse(code, 'test.go');
 
-      const stack = nodes.find(n => n.name === 'Stack');
+      const stack = nodes.find((n) => n.name === 'Stack');
       expect(stack?.methods).toHaveLength(2);
-      expect(stack?.methods?.map(m => m.name)).toEqual(['Push', 'Pop']);
+      expect(stack?.methods?.map((m) => m.name)).toEqual(['Push', 'Pop']);
     });
 
     it('does not count methods as standalone functions', () => {
@@ -332,7 +332,7 @@ func standalone() {}
       `.trim();
       const nodes = parser.parse(code, 'test.go');
 
-      const functions = nodes.filter(n => n.type === 'function');
+      const functions = nodes.filter((n) => n.type === 'function');
       expect(functions).toHaveLength(1);
       expect(functions[0]?.name).toBe('standalone');
     });
@@ -347,7 +347,7 @@ func standalone() {}
       expect(imports[0]).toMatchObject({
         source: 'fmt',
         specifiers: [],
-        isType: false
+        isType: false,
       });
     });
 
@@ -376,7 +376,7 @@ import (
       const imports = parser.extractImports(code);
 
       expect(imports).toHaveLength(3);
-      expect(imports.map(i => i.source)).toEqual(['fmt', 'os', 'net/http']);
+      expect(imports.map((i) => i.source)).toEqual(['fmt', 'os', 'net/http']);
     });
 
     it('extracts aliased import', () => {
@@ -470,10 +470,10 @@ type Handler interface {
 
       expect(nodes.length).toBeGreaterThan(0);
 
-      const structs = nodes.filter(n => n.type === 'class');
-      const functions = nodes.filter(n => n.type === 'function');
-      const interfaces = nodes.filter(n => n.type === 'interface');
-      const constants = nodes.filter(n => n.type === 'const');
+      const structs = nodes.filter((n) => n.type === 'class');
+      const functions = nodes.filter((n) => n.type === 'function');
+      const interfaces = nodes.filter((n) => n.type === 'interface');
+      const constants = nodes.filter((n) => n.type === 'const');
 
       expect(structs).toHaveLength(1);
       expect(functions).toHaveLength(1); // Only main, not the method
@@ -521,7 +521,7 @@ func (t Test) method() {
       `.trim();
       const nodes = parser.parse(code, 'test.go');
 
-      const test = nodes.find(n => n.name === 'Test');
+      const test = nodes.find((n) => n.name === 'Test');
       const method = test?.methods?.[0];
 
       expect(method?.startLine).toBe(3);

package/src/analysis/go-ast-parser.ts

@@ -1,4 +1,3 @@
-import type { CodeNode, ImportInfo } from './ast-parser.js';
 import {
   parseGoCode,
   queryNodesByType,
@@ -7,8 +6,9 @@ import {
   getFunctionSignature,
   getFirstChildOfType,
   type TreeSitterNode,
-  type TreeSitterTree
+  type TreeSitterTree,
 } from './tree-sitter-parser.js';
+import type { CodeNode, ImportInfo } from './ast-parser.js';
 
 /**
  * Parser for Go code using tree-sitter
@@ -87,13 +87,14 @@ export class GoASTParser {
 
           // Extract string content from interpreted_string_literal
           const stringContent = pathNode.descendantsOfType('interpreted_string_literal_content')[0];
-          const path = stringContent !== undefined ? stringContent.text : pathNode.text.replace(/"/g, '');
+          const path =
+            stringContent !== undefined ? stringContent.text : pathNode.text.replace(/"/g, '');
 
           if (path !== '') {
             imports.push({
               source: path,
               specifiers: [],
-              isType: false
+              isType: false,
             });
           }
         }
@@ -131,7 +132,7 @@ export class GoASTParser {
         async: false,
         startLine,
         endLine,
-        signature
+        signature,
       });
     }
 
@@ -176,7 +177,7 @@ export class GoASTParser {
         startLine,
         endLine,
         signature: name,
-        methods: []
+        methods: [],
       });
     }
 
@@ -223,7 +224,7 @@ export class GoASTParser {
         startLine,
         endLine,
         signature: name,
-        methods
+        methods,
       });
     }
 
@@ -267,7 +268,7 @@ export class GoASTParser {
         exported,
         startLine,
         endLine,
-        signature
+        signature,
       });
     }
 
@@ -296,9 +297,7 @@ export class GoASTParser {
         const endLine = positionToLineNumber(spec.endPosition);
 
         const typeNode = getChildByFieldName(spec, 'type');
-        const signature = typeNode !== null
-          ? `${name}: ${typeNode.text}`
-          : name;
+        const signature = typeNode !== null ? `${name}: ${typeNode.text}` : name;
 
         nodes.push({
           type: 'const',
@@ -306,7 +305,7 @@ export class GoASTParser {
           exported,
           startLine,
           endLine,
-          signature
+          signature,
         });
       }
     }
@@ -327,9 +326,7 @@ export class GoASTParser {
         const endLine = positionToLineNumber(spec.endPosition);
 
         const typeNode = getChildByFieldName(spec, 'type');
-        const signature = typeNode !== null
-          ? `${name}: ${typeNode.text}`
-          : name;
+        const signature = typeNode !== null ? `${name}: ${typeNode.text}` : name;
 
         nodes.push({
           type: 'const',
@@ -337,7 +334,7 @@ export class GoASTParser {
           exported,
           startLine,
           endLine,
-          signature
+          signature,
         });
       }
     }
@@ -368,17 +365,15 @@ export class GoASTParser {
       const endLine = positionToLineNumber(methodNode.endPosition);
 
       // Find the corresponding struct and attach method
-      const structNode = nodes.find(
-        node => node.type === 'class' && node.name === receiverType
-      );
+      const structNode = nodes.find((node) => node.type === 'class' && node.name === receiverType);
 
-      if (structNode !== undefined && structNode.methods !== undefined) {
+      if (structNode?.methods !== undefined) {
         structNode.methods.push({
           name,
           async: false,
           signature,
           startLine,
-          endLine
+          endLine,
         });
       }
     }
@@ -420,7 +415,7 @@ export class GoASTParser {
         async: false,
         signature,
         startLine,
-        endLine
+        endLine,
       });
     }
 
@@ -448,9 +443,7 @@ export class GoASTParser {
 
     // Handle pointer receivers (*Type)
     if (typeNode.type === 'pointer_type') {
-      const innerType = typeNode.children.find(
-        child => child.type === 'type_identifier'
-      );
+      const innerType = typeNode.children.find((child) => child.type === 'type_identifier');
       return innerType !== undefined ? innerType.text : null;
     }
 

package/src/analysis/parser-factory.test.ts

@@ -13,7 +13,7 @@ describe('ParserFactory', () => {
       expect(nodes[0]).toMatchObject({
         type: 'function',
         name: 'hello',
-        exported: true
+        exported: true,
       });
     });
 
@@ -35,7 +35,7 @@ describe('ParserFactory', () => {
       expect(nodes[0]).toMatchObject({
         type: 'function',
         name: 'add',
-        exported: true
+        exported: true,
       });
     });
 
@@ -57,13 +57,13 @@ describe('ParserFactory', () => {
             exported: true,
             startLine: 1,
             endLine: 2,
-            signature: 'def greet(name: str) -> str'
-          }
-        ]
+            signature: 'def greet(name: str) -> str',
+          },
+        ],
       };
 
       const mockBridge = {
-        parsePython: vi.fn().mockResolvedValue(mockResult)
+        parsePython: vi.fn().mockResolvedValue(mockResult),
       } as unknown as PythonBridge;
 
       const factory = new ParserFactory(mockBridge);
@@ -75,7 +75,7 @@ describe('ParserFactory', () => {
       expect(nodes[0]).toMatchObject({
         type: 'function',
         name: 'greet',
-        exported: true
+        exported: true,
       });
     });
 
@@ -97,7 +97,7 @@ describe('ParserFactory', () => {
       expect(nodes[0]).toMatchObject({
         type: 'function',
         name: 'calculate',
-        exported: true
+        exported: true,
       });
     });
 
@@ -110,7 +110,7 @@ describe('ParserFactory', () => {
       expect(nodes[0]).toMatchObject({
         type: 'function',
         name: 'Add',
-        exported: true
+        exported: true,
       });
     });
 

package/src/analysis/parser-factory.ts

@@ -1,9 +1,9 @@
 import path from 'node:path';
-import type { PythonBridge } from '../crawl/bridge.js';
 import { ASTParser, type CodeNode } from './ast-parser.js';
+import { GoASTParser } from './go-ast-parser.js';
 import { PythonASTParser } from './python-ast-parser.js';
 import { RustASTParser } from './rust-ast-parser.js';
-import { GoASTParser } from './go-ast-parser.js';
+import type { PythonBridge } from '../crawl/bridge.js';
 
 export class ParserFactory {
   constructor(private readonly pythonBridge?: PythonBridge) {}
@@ -26,7 +26,7 @@ export class ParserFactory {
         throw new Error('Python bridge not available for parsing Python files');
       }
       const parser = new PythonASTParser(this.pythonBridge);
-      return await parser.parse(code, filePath);
+      return parser.parse(code, filePath);
     }
 
     if (ext === '.rs') {

package/src/analysis/python-ast-parser.test.ts

@@ -4,7 +4,7 @@ import type { PythonBridge, ParsePythonResult } from '../crawl/bridge.js';
 
 function createMockBridge(result: ParsePythonResult): PythonBridge {
   return {
-    parsePython: vi.fn().mockResolvedValue(result)
+    parsePython: vi.fn().mockResolvedValue(result),
   } as unknown as PythonBridge;
 }
 
@@ -18,10 +18,10 @@ describe('PythonASTParser', () => {
             name: 'hello',
             exported: true,
             startLine: 1,
-            endLine: 2
-          }
+            endLine: 2,
+          },
         ],
-        imports: []
+        imports: [],
       };
 
       const bridge = createMockBridge(mockResult);
@@ -35,7 +35,7 @@ describe('PythonASTParser', () => {
         name: 'hello',
         exported: true,
         startLine: 1,
-        endLine: 2
+        endLine: 2,
       });
     });
 
@@ -48,10 +48,10 @@ describe('PythonASTParser', () => {
             exported: true,
             startLine: 1,
             endLine: 3,
-            async: true
-          }
+            async: true,
+          },
         ],
-        imports: []
+        imports: [],
       };
 
       const bridge = createMockBridge(mockResult);
@@ -71,10 +71,10 @@ describe('PythonASTParser', () => {
             exported: true,
             startLine: 1,
             endLine: 2,
-            signature: 'def greet(name: str) -> str'
-          }
+            signature: 'def greet(name: str) -> str',
+          },
         ],
-        imports: []
+        imports: [],
       };
 
       const bridge = createMockBridge(mockResult);
@@ -100,7 +100,7 @@ describe('PythonASTParser', () => {
                 signature: 'def add(self, a: int, b: int) -> int',
                 startLine: 2,
                 endLine: 3,
-                calls: []
+                calls: [],
               },
               {
                 name: 'subtract',
@@ -108,12 +108,12 @@ describe('PythonASTParser', () => {
                 signature: 'def subtract(self, a: int, b: int) -> int',
                 startLine: 4,
                 endLine: 5,
-                calls: []
-              }
-            ]
-          }
+                calls: [],
+              },
+            ],
+          },
         ],
-        imports: []
+        imports: [],
       };
 
       const bridge = createMockBridge(mockResult);
@@ -134,11 +134,11 @@ describe('PythonASTParser', () => {
             name: 'simple',
             exported: false,
             startLine: 1,
-            endLine: 1
+            endLine: 1,
             // No async, signature, or methods
-          }
+          },
         ],
-        imports: []
+        imports: [],
       };
 
       const bridge = createMockBridge(mockResult);
@@ -148,7 +148,7 @@ describe('PythonASTParser', () => {
       expect(nodes[0]).toMatchObject({
         type: 'function',
         name: 'simple',
-        exported: false
+        exported: false,
       });
       // Optional fields should not be present
       expect(nodes[0]?.async).toBeUndefined();
@@ -164,24 +164,24 @@ describe('PythonASTParser', () => {
             name: 'func1',
             exported: true,
             startLine: 1,
-            endLine: 2
+            endLine: 2,
           },
           {
             type: 'class',
             name: 'MyClass',
             exported: true,
             startLine: 3,
-            endLine: 10
+            endLine: 10,
           },
           {
             type: 'function',
             name: 'func2',
             exported: false,
             startLine: 11,
-            endLine: 12
-          }
+            endLine: 12,
+          },
         ],
-        imports: []
+        imports: [],
       };
 
       const bridge = createMockBridge(mockResult);
@@ -197,7 +197,7 @@ describe('PythonASTParser', () => {
     it('returns empty array when no nodes found', async () => {
       const mockResult: ParsePythonResult = {
         nodes: [],
-        imports: []
+        imports: [],
       };
 
       const bridge = createMockBridge(mockResult);