@saluzi/codegraph 0.1.0

package/dist/resolution/frameworks/go.js

@@ -0,0 +1,158 @@
+"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

@@ -0,0 +1,52 @@
+/**
+ * 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

@@ -0,0 +1,137 @@
+"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

@@ -0,0 +1,8 @@
+/**
+ * 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

@@ -0,0 +1,177 @@
+"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

@@ -0,0 +1,13 @@
+/**
+ * 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