specmem-hardwicksoftware 3.5.99

package/dist/codebase/codeAnalyzer.d.ts

@@ -0,0 +1,272 @@
+/**
+ * codeAnalyzer.ts - Advanced Code Analysis for Semantic Search
+ *
+ * yo this analyzer SLAPS - extracts definitions, dependencies, chunks, and complexity
+ * from code files for storage in PostgreSQL with vector embeddings
+ *
+ * Features:
+ * - Function/class/variable definition extraction
+ * - Import/dependency tracking
+ * - Code chunking for semantic search
+ * - Complexity metrics calculation
+ * - Multi-language support (TypeScript, JavaScript, Python, etc.)
+ */
+/**
+ * CodeDefinition - represents a function, class, variable, etc.
+ */
+export interface CodeDefinition {
+    id: string;
+    fileId: string;
+    filePath: string;
+    name: string;
+    qualifiedName?: string;
+    definitionType: DefinitionType;
+    startLine: number;
+    endLine: number;
+    startColumn?: number;
+    endColumn?: number;
+    signature?: string;
+    docstring?: string;
+    returnType?: string;
+    visibility: VisibilityType;
+    isExported: boolean;
+    isAsync: boolean;
+    isStatic: boolean;
+    isAbstract: boolean;
+    parentDefinitionId?: string;
+    parameters: ParameterInfo[];
+    language: string;
+    decorators: string[];
+    metadata: Record<string, unknown>;
+}
+/**
+ * CodeDependency - represents an import/require statement
+ */
+export interface CodeDependency {
+    id: string;
+    sourceFileId: string;
+    sourceFilePath: string;
+    targetPath: string;
+    resolvedPath?: string;
+    targetFileId?: string;
+    importType: ImportType;
+    importStatement: string;
+    importedNames: string[];
+    importedAs: string[];
+    isDefaultImport: boolean;
+    isNamespaceImport: boolean;
+    isTypeImport: boolean;
+    isSideEffectImport: boolean;
+    lineNumber: number;
+    columnNumber?: number;
+    isExternal: boolean;
+    isBuiltin: boolean;
+    isRelative: boolean;
+    isAbsolute: boolean;
+    isDynamic: boolean;
+    packageName?: string;
+    packageVersion?: string;
+    language: string;
+    metadata: Record<string, unknown>;
+}
+/**
+ * CodeChunk - a chunk of code for semantic search
+ */
+export interface CodeChunk {
+    id: string;
+    fileId: string;
+    filePath: string;
+    chunkIndex: number;
+    startLine: number;
+    endLine: number;
+    startChar: number;
+    endChar: number;
+    content: string;
+    language: string;
+    chunkType: ChunkType;
+    contextBefore?: string;
+    contextAfter?: string;
+    metadata: Record<string, unknown>;
+    embedding?: number[];
+}
+/**
+ * CodeComplexity - complexity metrics for a file or definition
+ */
+export interface CodeComplexity {
+    id: string;
+    fileId: string;
+    filePath: string;
+    definitionId?: string;
+    definitionName?: string;
+    scopeType: ScopeType;
+    linesOfCode: number;
+    logicalLines: number;
+    commentLines: number;
+    blankLines: number;
+    cyclomaticComplexity?: number;
+    cognitiveComplexity?: number;
+    halsteadDifficulty?: number;
+    halsteadEffort?: number;
+    halsteadVolume?: number;
+    maintainabilityIndex?: number;
+    parameterCount?: number;
+    returnStatementCount?: number;
+    nestingDepth?: number;
+    couplingScore?: number;
+    issuesCount: number;
+    issues: CodeIssue[];
+    duplicateBlocks: number;
+    duplicateLines: number;
+    language: string;
+    metadata: Record<string, unknown>;
+    analyzedAt: Date;
+    analyzerVersion: string;
+}
+/**
+ * CodeIssue - a potential code quality issue
+ */
+export interface CodeIssue {
+    type: string;
+    severity: 'error' | 'warning' | 'info';
+    message: string;
+    line?: number;
+    column?: number;
+}
+/**
+ * ParameterInfo - function/method parameter details
+ */
+export interface ParameterInfo {
+    name: string;
+    type?: string;
+    defaultValue?: string;
+    optional?: boolean;
+}
+/**
+ * AnalysisResult - complete analysis of a file
+ */
+export interface AnalysisResult {
+    fileId: string;
+    filePath: string;
+    language: string;
+    definitions: CodeDefinition[];
+    dependencies: CodeDependency[];
+    chunks: CodeChunk[];
+    complexity: CodeComplexity;
+    analyzedAt: Date;
+}
+export type DefinitionType = 'function' | 'method' | 'class' | 'interface' | 'type' | 'enum' | 'variable' | 'constant' | 'property' | 'getter' | 'setter' | 'constructor' | 'decorator' | 'module' | 'namespace' | 'trait' | 'struct' | 'protocol' | 'extension' | 'mixin' | 'alias';
+export type VisibilityType = 'public' | 'private' | 'protected' | 'internal' | 'package';
+export type ImportType = 'import' | 'require' | 'include' | 'from' | 'dynamic' | 'import_type' | 'import_value' | 'reexport' | 'side_effect';
+export type ChunkType = 'code' | 'comment' | 'docstring' | 'mixed' | 'import' | 'definition';
+export type ScopeType = 'file' | 'function' | 'method' | 'class' | 'module' | 'chunk';
+/**
+ * CodeAnalyzer - extracts semantic information from code
+ *
+ * yo this class is the BRAIN of semantic code search
+ * parses code and extracts definitions, dependencies, chunks
+ */
+export declare class CodeAnalyzer {
+    private readonly chunkSize;
+    private readonly chunkOverlap;
+    private readonly analyzerVersion;
+    constructor(options?: {
+        chunkSize?: number;
+        chunkOverlap?: number;
+    });
+    /**
+     * analyzeFile - performs complete analysis of a code file
+     */
+    analyzeFile(fileId: string, filePath: string, content: string, language: string): Promise<AnalysisResult>;
+    /**
+     * extractDefinitions - extracts function/class/variable definitions
+     */
+    private extractDefinitions;
+    /**
+     * extractTSJSDefinitions - extracts TypeScript/JavaScript definitions
+     *
+     * Uses a definition stack to track nested functions/classes/methods
+     * so inner functions get proper parentDefinitionId linkage
+     */
+    private extractTSJSDefinitions;
+    /**
+     * extractPythonDefinitions - extracts Python definitions
+     *
+     * Uses indentation-based stack to track nested functions/classes
+     * Python's indentation makes this cleaner than brace-based languages
+     */
+    private extractPythonDefinitions;
+    /**
+     * extractGoDefinitions - extracts Go definitions
+     */
+    private extractGoDefinitions;
+    /**
+     * extractRustDefinitions - extracts Rust definitions
+     */
+    private extractRustDefinitions;
+    /**
+     * extractGenericDefinitions - generic extraction for unknown languages
+     */
+    private extractGenericDefinitions;
+    /**
+     * extractDependencies - extracts import/require statements
+     */
+    private extractDependencies;
+    /**
+     * extractTSJSDependencies - extracts TypeScript/JavaScript imports
+     */
+    private extractTSJSDependencies;
+    /**
+     * extractPythonDependencies - extracts Python imports
+     */
+    private extractPythonDependencies;
+    /**
+     * extractGoDependencies - extracts Go imports
+     */
+    private extractGoDependencies;
+    /**
+     * extractRustDependencies - extracts Rust use statements
+     */
+    private extractRustDependencies;
+    /**
+     * extractGenericDependencies - generic extraction for unknown languages
+     */
+    private extractGenericDependencies;
+    /**
+     * createChunks - splits code into chunks for semantic search
+     */
+    private createChunks;
+    /**
+     * determineChunkType - determines the type of a code chunk
+     */
+    private determineChunkType;
+    /**
+     * calculateComplexity - calculates complexity metrics for a file
+     */
+    private calculateComplexity;
+    private createDefinition;
+    private createDependency;
+    private createChunk;
+    private parseParameters;
+    private parsePythonParameters;
+    private detectVisibility;
+    private classifyImport;
+    private isComment;
+    private isImport;
+}
+/**
+ * getCodeAnalyzer - returns project-scoped analyzer instance
+ * uses Map<projectPath, CodeAnalyzer> pattern for proper isolation
+ */
+export declare function getCodeAnalyzer(options?: {
+    chunkSize?: number;
+    chunkOverlap?: number;
+}, projectPath?: string): CodeAnalyzer;
+/**
+ * resetCodeAnalyzer - resets the analyzer for a specific project (for testing)
+ */
+export declare function resetCodeAnalyzer(projectPath?: string): void;
+/**
+ * resetAllCodeAnalyzers - resets all project analyzers (for testing)
+ */
+export declare function resetAllCodeAnalyzers(): void;
+//# sourceMappingURL=codeAnalyzer.d.ts.map

package/dist/codebase/codeAnalyzer.d.ts.map

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