@saluzi/codegraph 0.1.0 → 0.2.0

package/dist/resolution/frameworks/go.js

@@ -1,158 +0,0 @@
-"use strict";
-/**
- * Go Framework Resolver
- *
- * Handles Gin, Echo, Fiber, Chi, and standard library patterns.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.goResolver = void 0;
-const strip_comments_1 = require("../strip-comments");
-exports.goResolver = {
-    name: 'go',
-    languages: ['go'],
-    detect(context) {
-        // Check for go.mod file (Go modules)
-        const goMod = context.readFile('go.mod');
-        if (goMod) {
-            return true;
-        }
-        // Check for .go files
-        const allFiles = context.getAllFiles();
-        return allFiles.some((f) => f.endsWith('.go'));
-    },
-    resolve(ref, context) {
-        // Pattern 1: Handler references
-        if (ref.referenceName.endsWith('Handler') || ref.referenceName.startsWith('Handle')) {
-            const result = resolveByNameAndKind(ref.referenceName, 'function', HANDLER_DIRS, context);
-            if (result) {
-                return {
-                    original: ref,
-                    targetNodeId: result,
-                    confidence: 0.8,
-                    resolvedBy: 'framework',
-                };
-            }
-        }
-        // Pattern 2: Service/Repository references
-        if (ref.referenceName.endsWith('Service') || ref.referenceName.endsWith('Repository') || ref.referenceName.endsWith('Store')) {
-            const result = resolveByNameAndKind(ref.referenceName, null, SERVICE_DIRS, context, SERVICE_KINDS);
-            if (result) {
-                return {
-                    original: ref,
-                    targetNodeId: result,
-                    confidence: 0.8,
-                    resolvedBy: 'framework',
-                };
-            }
-        }
-        // Pattern 3: Middleware references
-        if (ref.referenceName.endsWith('Middleware') || ref.referenceName.startsWith('Auth') || ref.referenceName.startsWith('Log')) {
-            const result = resolveByNameAndKind(ref.referenceName, 'function', MIDDLEWARE_DIRS, context);
-            if (result) {
-                return {
-                    original: ref,
-                    targetNodeId: result,
-                    confidence: 0.75,
-                    resolvedBy: 'framework',
-                };
-            }
-        }
-        // Pattern 4: Model/Entity references (typically PascalCase structs)
-        if (/^[A-Z][a-zA-Z]+$/.test(ref.referenceName)) {
-            const result = resolveByNameAndKind(ref.referenceName, 'struct', MODEL_DIRS, context);
-            if (result) {
-                return {
-                    original: ref,
-                    targetNodeId: result,
-                    confidence: 0.7,
-                    resolvedBy: 'framework',
-                };
-            }
-        }
-        return null;
-    },
-    extract(filePath, content) {
-        if (!filePath.endsWith('.go'))
-            return { nodes: [], references: [] };
-        const nodes = [];
-        const references = [];
-        const now = Date.now();
-        const safe = (0, strip_comments_1.stripCommentsForRegex)(content, 'go');
-        // (router|r|mux|app).METHOD("/path", handler)
-        // Handles Gin (GET/POST/...), Chi (Get/Post/...), net/http (HandleFunc/Handle).
-        const routeRegex = /\b(?:router|r|mux|app|e)\.(GET|POST|PUT|PATCH|DELETE|OPTIONS|HEAD|Get|Post|Put|Patch|Delete|Handle|HandleFunc)\s*\(\s*"([^"]+)"\s*,\s*([^)]+)\)/g;
-        let match;
-        while ((match = routeRegex.exec(safe)) !== null) {
-            const [, rawMethod, routePath, handlerExpr] = match;
-            const line = safe.slice(0, match.index).split('\n').length;
-            const method = rawMethod === 'Handle' || rawMethod === 'HandleFunc'
-                ? 'ANY'
-                : rawMethod.toUpperCase();
-            const routeNode = {
-                id: `route:${filePath}:${line}:${method}:${routePath}`,
-                kind: 'route',
-                name: `${method} ${routePath}`,
-                qualifiedName: `${filePath}::route:${routePath}`,
-                filePath,
-                startLine: line,
-                endLine: line,
-                startColumn: 0,
-                endColumn: match[0].length,
-                language: 'go',
-                updatedAt: now,
-            };
-            nodes.push(routeNode);
-            const handlerName = extractGoTailIdent(handlerExpr);
-            if (handlerName) {
-                references.push({
-                    fromNodeId: routeNode.id,
-                    referenceName: handlerName,
-                    referenceKind: 'references',
-                    line,
-                    column: 0,
-                    filePath,
-                    language: 'go',
-                });
-            }
-        }
-        return { nodes, references };
-    },
-};
-/** Extract the last identifier from an expression like `pkg.Sub.handler` or `handler`. */
-function extractGoTailIdent(expr) {
-    const cleaned = expr.trim().replace(/\s+/g, '').replace(/\(\)$/, '');
-    const m = cleaned.match(/(?:\.|^)([A-Za-z_][A-Za-z0-9_]*)$/);
-    return m ? m[1] : null;
-}
-// Directory patterns for framework resolution
-const HANDLER_DIRS = ['handler', 'handlers', 'api', 'routes', 'controller', 'controllers'];
-const SERVICE_DIRS = ['service', 'services', 'repository', 'store', 'pkg'];
-const MIDDLEWARE_DIRS = ['middleware', 'middlewares'];
-const MODEL_DIRS = ['model', 'models', 'entity', 'entities', 'domain', 'pkg'];
-const SERVICE_KINDS = new Set(['struct', 'interface']);
-/**
- * Resolve a symbol by name using indexed queries instead of scanning all files.
- * Uses getNodesByName (O(log n) indexed lookup) instead of iterating every file.
- */
-function resolveByNameAndKind(name, kind, preferredDirs, context, kinds) {
-    const candidates = context.getNodesByName(name);
-    if (candidates.length === 0)
-        return null;
-    // Filter by kind
-    const kindFiltered = candidates.filter((n) => {
-        if (kinds)
-            return kinds.has(n.kind);
-        if (kind)
-            return n.kind === kind;
-        return true;
-    });
-    if (kindFiltered.length === 0)
-        return null;
-    // Prefer candidates in framework-conventional directories
-    const preferred = kindFiltered.filter((n) => preferredDirs.some((d) => n.filePath.includes(`/${d}/`)));
-    if (preferred.length > 0)
-        return preferred[0].id;
-    // Fall back to any match
-    return kindFiltered[0].id;
-}
-//# sourceMappingURL=go.js.map

package/dist/resolution/frameworks/index.d.ts

@@ -1,52 +0,0 @@
-/**
- * Framework Resolver Registry
- *
- * Manages framework-specific resolvers.
- */
-import { FrameworkResolver, ResolutionContext } from '../types'
-import type { Language } from '../../types'
-/**
- * Get all framework resolvers
- */
-export declare function getAllFrameworkResolvers(): FrameworkResolver[]
-/**
- * Get a resolver by name
- */
-export declare function getFrameworkResolver(
-  name: string,
-): FrameworkResolver | undefined
-/**
- * Detect which frameworks are used in a project
- */
-export declare function detectFrameworks(
-  context: ResolutionContext,
-): FrameworkResolver[]
-/**
- * Filter a list of detected frameworks down to ones that apply to a given language.
- * Frameworks without an explicit `languages` list are treated as universal.
- */
-export declare function getApplicableFrameworks(
-  detected: FrameworkResolver[],
-  language: Language,
-): FrameworkResolver[]
-/**
- * Register a custom framework resolver
- */
-export declare function registerFrameworkResolver(
-  resolver: FrameworkResolver,
-): void
-export { drupalResolver } from './drupal'
-export { laravelResolver, FACADE_MAPPINGS } from './laravel'
-export { expressResolver } from './express'
-export { nestjsResolver } from './nestjs'
-export { reactResolver } from './react'
-export { svelteResolver } from './svelte'
-export { vueResolver } from './vue'
-export { djangoResolver, flaskResolver, fastapiResolver } from './python'
-export { railsResolver } from './ruby'
-export { springResolver } from './java'
-export { goResolver } from './go'
-export { rustResolver } from './rust'
-export { aspnetResolver } from './csharp'
-export { swiftUIResolver, uikitResolver, vaporResolver } from './swift'
-//# sourceMappingURL=index.d.ts.map

package/dist/resolution/frameworks/index.js

@@ -1,137 +0,0 @@
-"use strict";
-/**
- * Framework Resolver Registry
- *
- * Manages framework-specific resolvers.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.vaporResolver = exports.uikitResolver = exports.swiftUIResolver = exports.aspnetResolver = exports.rustResolver = exports.goResolver = exports.springResolver = exports.railsResolver = exports.fastapiResolver = exports.flaskResolver = exports.djangoResolver = exports.vueResolver = exports.svelteResolver = exports.reactResolver = exports.nestjsResolver = exports.expressResolver = exports.FACADE_MAPPINGS = exports.laravelResolver = exports.drupalResolver = void 0;
-exports.getAllFrameworkResolvers = getAllFrameworkResolvers;
-exports.getFrameworkResolver = getFrameworkResolver;
-exports.detectFrameworks = detectFrameworks;
-exports.getApplicableFrameworks = getApplicableFrameworks;
-exports.registerFrameworkResolver = registerFrameworkResolver;
-const drupal_1 = require("./drupal");
-const laravel_1 = require("./laravel");
-const express_1 = require("./express");
-const nestjs_1 = require("./nestjs");
-const react_1 = require("./react");
-const svelte_1 = require("./svelte");
-const vue_1 = require("./vue");
-const python_1 = require("./python");
-const ruby_1 = require("./ruby");
-const java_1 = require("./java");
-const go_1 = require("./go");
-const rust_1 = require("./rust");
-const csharp_1 = require("./csharp");
-const swift_1 = require("./swift");
-/**
- * All registered framework resolvers
- */
-const FRAMEWORK_RESOLVERS = [
-    // PHP
-    laravel_1.laravelResolver,
-    drupal_1.drupalResolver,
-    // JavaScript/TypeScript
-    express_1.expressResolver,
-    nestjs_1.nestjsResolver,
-    react_1.reactResolver,
-    svelte_1.svelteResolver,
-    vue_1.vueResolver,
-    // Python
-    python_1.djangoResolver,
-    python_1.flaskResolver,
-    python_1.fastapiResolver,
-    // Ruby
-    ruby_1.railsResolver,
-    // Java
-    java_1.springResolver,
-    // Go
-    go_1.goResolver,
-    // Rust
-    rust_1.rustResolver,
-    // C#
-    csharp_1.aspnetResolver,
-    // Swift
-    swift_1.swiftUIResolver,
-    swift_1.uikitResolver,
-    swift_1.vaporResolver,
-];
-/**
- * Get all framework resolvers
- */
-function getAllFrameworkResolvers() {
-    return FRAMEWORK_RESOLVERS;
-}
-/**
- * Get a resolver by name
- */
-function getFrameworkResolver(name) {
-    return FRAMEWORK_RESOLVERS.find((r) => r.name === name);
-}
-/**
- * Detect which frameworks are used in a project
- */
-function detectFrameworks(context) {
-    return FRAMEWORK_RESOLVERS.filter((resolver) => {
-        try {
-            return resolver.detect(context);
-        }
-        catch {
-            return false;
-        }
-    });
-}
-/**
- * Filter a list of detected frameworks down to ones that apply to a given language.
- * Frameworks without an explicit `languages` list are treated as universal.
- */
-function getApplicableFrameworks(detected, language) {
-    return detected.filter((fw) => !fw.languages || fw.languages.includes(language));
-}
-/**
- * Register a custom framework resolver
- */
-function registerFrameworkResolver(resolver) {
-    // Remove existing resolver with same name
-    const index = FRAMEWORK_RESOLVERS.findIndex((r) => r.name === resolver.name);
-    if (index !== -1) {
-        FRAMEWORK_RESOLVERS.splice(index, 1);
-    }
-    FRAMEWORK_RESOLVERS.push(resolver);
-}
-// Re-export framework resolvers
-var drupal_2 = require("./drupal");
-Object.defineProperty(exports, "drupalResolver", { enumerable: true, get: function () { return drupal_2.drupalResolver; } });
-var laravel_2 = require("./laravel");
-Object.defineProperty(exports, "laravelResolver", { enumerable: true, get: function () { return laravel_2.laravelResolver; } });
-Object.defineProperty(exports, "FACADE_MAPPINGS", { enumerable: true, get: function () { return laravel_2.FACADE_MAPPINGS; } });
-var express_2 = require("./express");
-Object.defineProperty(exports, "expressResolver", { enumerable: true, get: function () { return express_2.expressResolver; } });
-var nestjs_2 = require("./nestjs");
-Object.defineProperty(exports, "nestjsResolver", { enumerable: true, get: function () { return nestjs_2.nestjsResolver; } });
-var react_2 = require("./react");
-Object.defineProperty(exports, "reactResolver", { enumerable: true, get: function () { return react_2.reactResolver; } });
-var svelte_2 = require("./svelte");
-Object.defineProperty(exports, "svelteResolver", { enumerable: true, get: function () { return svelte_2.svelteResolver; } });
-var vue_2 = require("./vue");
-Object.defineProperty(exports, "vueResolver", { enumerable: true, get: function () { return vue_2.vueResolver; } });
-var python_2 = require("./python");
-Object.defineProperty(exports, "djangoResolver", { enumerable: true, get: function () { return python_2.djangoResolver; } });
-Object.defineProperty(exports, "flaskResolver", { enumerable: true, get: function () { return python_2.flaskResolver; } });
-Object.defineProperty(exports, "fastapiResolver", { enumerable: true, get: function () { return python_2.fastapiResolver; } });
-var ruby_2 = require("./ruby");
-Object.defineProperty(exports, "railsResolver", { enumerable: true, get: function () { return ruby_2.railsResolver; } });
-var java_2 = require("./java");
-Object.defineProperty(exports, "springResolver", { enumerable: true, get: function () { return java_2.springResolver; } });
-var go_2 = require("./go");
-Object.defineProperty(exports, "goResolver", { enumerable: true, get: function () { return go_2.goResolver; } });
-var rust_2 = require("./rust");
-Object.defineProperty(exports, "rustResolver", { enumerable: true, get: function () { return rust_2.rustResolver; } });
-var csharp_2 = require("./csharp");
-Object.defineProperty(exports, "aspnetResolver", { enumerable: true, get: function () { return csharp_2.aspnetResolver; } });
-var swift_2 = require("./swift");
-Object.defineProperty(exports, "swiftUIResolver", { enumerable: true, get: function () { return swift_2.swiftUIResolver; } });
-Object.defineProperty(exports, "uikitResolver", { enumerable: true, get: function () { return swift_2.uikitResolver; } });
-Object.defineProperty(exports, "vaporResolver", { enumerable: true, get: function () { return swift_2.vaporResolver; } });
-//# sourceMappingURL=index.js.map

package/dist/resolution/frameworks/java.d.ts

@@ -1,8 +0,0 @@
-/**
- * Java Framework Resolver
- *
- * Handles Spring Boot and general Java patterns.
- */
-import { FrameworkResolver } from '../types'
-export declare const springResolver: FrameworkResolver
-//# sourceMappingURL=java.d.ts.map

package/dist/resolution/frameworks/java.js

@@ -1,177 +0,0 @@
-"use strict";
-/**
- * Java Framework Resolver
- *
- * Handles Spring Boot and general Java patterns.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.springResolver = void 0;
-const strip_comments_1 = require("../strip-comments");
-exports.springResolver = {
-    name: 'spring',
-    languages: ['java'],
-    detect(context) {
-        // Check for pom.xml with Spring
-        const pomXml = context.readFile('pom.xml');
-        if (pomXml && (pomXml.includes('spring-boot') || pomXml.includes('springframework'))) {
-            return true;
-        }
-        // Check for build.gradle with Spring
-        const buildGradle = context.readFile('build.gradle');
-        if (buildGradle && (buildGradle.includes('spring-boot') || buildGradle.includes('springframework'))) {
-            return true;
-        }
-        const buildGradleKts = context.readFile('build.gradle.kts');
-        if (buildGradleKts && (buildGradleKts.includes('spring-boot') || buildGradleKts.includes('springframework'))) {
-            return true;
-        }
-        // Check for Spring annotations in Java files
-        const allFiles = context.getAllFiles();
-        for (const file of allFiles) {
-            if (file.endsWith('.java')) {
-                const content = context.readFile(file);
-                if (content && (content.includes('@SpringBootApplication') ||
-                    content.includes('@RestController') ||
-                    content.includes('@Service') ||
-                    content.includes('@Repository'))) {
-                    return true;
-                }
-            }
-        }
-        return false;
-    },
-    resolve(ref, context) {
-        // Pattern 1: Service references (dependency injection)
-        if (ref.referenceName.endsWith('Service')) {
-            const result = resolveByNameAndKind(ref.referenceName, SERVICE_KINDS, SERVICE_DIRS, context);
-            if (result) {
-                return {
-                    original: ref,
-                    targetNodeId: result,
-                    confidence: 0.85,
-                    resolvedBy: 'framework',
-                };
-            }
-        }
-        // Pattern 2: Repository references
-        if (ref.referenceName.endsWith('Repository')) {
-            const result = resolveByNameAndKind(ref.referenceName, SERVICE_KINDS, REPO_DIRS, context);
-            if (result) {
-                return {
-                    original: ref,
-                    targetNodeId: result,
-                    confidence: 0.85,
-                    resolvedBy: 'framework',
-                };
-            }
-        }
-        // Pattern 3: Controller references
-        if (ref.referenceName.endsWith('Controller')) {
-            const result = resolveByNameAndKind(ref.referenceName, CLASS_KINDS, CONTROLLER_DIRS, context);
-            if (result) {
-                return {
-                    original: ref,
-                    targetNodeId: result,
-                    confidence: 0.85,
-                    resolvedBy: 'framework',
-                };
-            }
-        }
-        // Pattern 4: Entity/Model references
-        if (/^[A-Z][a-zA-Z]+$/.test(ref.referenceName)) {
-            const result = resolveByNameAndKind(ref.referenceName, CLASS_KINDS, ENTITY_DIRS, context);
-            if (result) {
-                return {
-                    original: ref,
-                    targetNodeId: result,
-                    confidence: 0.7,
-                    resolvedBy: 'framework',
-                };
-            }
-        }
-        // Pattern 5: Component references
-        if (ref.referenceName.endsWith('Component') || ref.referenceName.endsWith('Config')) {
-            const result = resolveByNameAndKind(ref.referenceName, CLASS_KINDS, COMPONENT_DIRS, context);
-            if (result) {
-                return {
-                    original: ref,
-                    targetNodeId: result,
-                    confidence: 0.8,
-                    resolvedBy: 'framework',
-                };
-            }
-        }
-        return null;
-    },
-    extract(filePath, content) {
-        if (!filePath.endsWith('.java'))
-            return { nodes: [], references: [] };
-        const nodes = [];
-        const references = [];
-        const now = Date.now();
-        const safe = (0, strip_comments_1.stripCommentsForRegex)(content, 'java');
-        // @GetMapping("/path"), @PostMapping(value = "/path"), @RequestMapping("/path")
-        const mappingRegex = /@(GetMapping|PostMapping|PutMapping|PatchMapping|DeleteMapping|RequestMapping)\s*\(\s*(?:value\s*=\s*|path\s*=\s*)?["']([^"']+)["'][^)]*\)/g;
-        let match;
-        while ((match = mappingRegex.exec(safe)) !== null) {
-            const [, mappingName, routePath] = match;
-            const line = safe.slice(0, match.index).split('\n').length;
-            const method = mappingName === 'RequestMapping' ? 'ANY' : mappingName.replace(/Mapping$/, '').toUpperCase();
-            const routeNode = {
-                id: `route:${filePath}:${line}:${method}:${routePath}`,
-                kind: 'route',
-                name: `${method} ${routePath}`,
-                qualifiedName: `${filePath}::route:${routePath}`,
-                filePath,
-                startLine: line,
-                endLine: line,
-                startColumn: 0,
-                endColumn: match[0].length,
-                language: 'java',
-                updatedAt: now,
-            };
-            nodes.push(routeNode);
-            // Look for the next public/private/protected method after the annotation
-            const tail = safe.slice(match.index + match[0].length);
-            const methodMatch = tail.match(/\b(?:public|private|protected)\s+[^;{]*?\s+(\w+)\s*\(/);
-            if (methodMatch) {
-                references.push({
-                    fromNodeId: routeNode.id,
-                    referenceName: methodMatch[1],
-                    referenceKind: 'references',
-                    line,
-                    column: 0,
-                    filePath,
-                    language: 'java',
-                });
-            }
-        }
-        return { nodes, references };
-    },
-};
-// Directory patterns
-const SERVICE_DIRS = ['/service/', '/services/'];
-const REPO_DIRS = ['/repository/', '/repositories/'];
-const CONTROLLER_DIRS = ['/controller/', '/controllers/'];
-const ENTITY_DIRS = ['/entity/', '/entities/', '/model/', '/models/', '/domain/'];
-const COMPONENT_DIRS = ['/component/', '/components/', '/config/'];
-const CLASS_KINDS = new Set(['class']);
-const SERVICE_KINDS = new Set(['class', 'interface']);
-/**
- * Resolve a symbol by name using indexed queries instead of scanning all files.
- */
-function resolveByNameAndKind(name, kinds, preferredDirPatterns, context) {
-    const candidates = context.getNodesByName(name);
-    if (candidates.length === 0)
-        return null;
-    const kindFiltered = candidates.filter((n) => kinds.has(n.kind));
-    if (kindFiltered.length === 0)
-        return null;
-    // Prefer candidates in framework-conventional directories
-    const preferred = kindFiltered.filter((n) => preferredDirPatterns.some((d) => n.filePath.includes(d)));
-    if (preferred.length > 0)
-        return preferred[0].id;
-    // Fall back to any match
-    return kindFiltered[0].id;
-}
-//# sourceMappingURL=java.js.map

package/dist/resolution/frameworks/laravel.d.ts

@@ -1,13 +0,0 @@
-/**
- * Laravel Framework Resolver
- *
- * Handles Laravel-specific patterns for reference resolution.
- */
-import { FrameworkResolver } from '../types'
-/**
- * Laravel facade mappings to underlying classes
- * Exported for potential use in facade resolution
- */
-export declare const FACADE_MAPPINGS: Record<string, string>
-export declare const laravelResolver: FrameworkResolver
-//# sourceMappingURL=laravel.d.ts.map