cgraphx 1.1.0

package/dist/resolution/frameworks/react.js

@@ -0,0 +1,334 @@
+"use strict";
+/**
+ * React Framework Resolver
+ *
+ * Handles React and Next.js patterns.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reactResolver = void 0;
+exports.reactResolver = {
+    name: 'react',
+    // Includes 'tsx'/'jsx' so route extraction runs on JSX files (where
+    // `<Route element={<X/>}>` routes live) — without them the .tsx/.jsx grammars
+    // were filtered out of the extract pass and those routes were never indexed.
+    // (resolve() is unaffected — it runs for every detected framework regardless
+    // of language; only the extract pass filters on `languages`.)
+    languages: ['javascript', 'typescript', 'tsx', 'jsx'],
+    detect(context) {
+        // Check for React in package.json
+        const packageJson = context.readFile('package.json');
+        if (packageJson) {
+            try {
+                const pkg = JSON.parse(packageJson);
+                const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+                if (deps.react || deps.next || deps['react-native']) {
+                    return true;
+                }
+            }
+            catch {
+                // Invalid JSON
+            }
+        }
+        // Check for .jsx/.tsx files
+        const allFiles = context.getAllFiles();
+        return allFiles.some((f) => f.endsWith('.jsx') || f.endsWith('.tsx'));
+    },
+    resolve(ref, context) {
+        // Pattern 1: Component references (PascalCase). Only from JSX-capable
+        // files — a component is USED in markup, which only parses in .tsx/.jsx.
+        // Without this gate, every PascalCase TYPE reference in plain .ts files
+        // went through component resolution: in a monorepo with same-named
+        // classes per package (#764, amplication), a `.ts` GraphQL-types file's
+        // own `Account` type alias lost to an arbitrary `Account` CLASS in
+        // another package (the framework's 0.8 outranked the name-matcher's
+        // proximity-correct 0.7).
+        if ((ref.language === 'tsx' || ref.language === 'jsx') &&
+            isPascalCase(ref.referenceName) &&
+            !isBuiltInType(ref.referenceName)) {
+            const result = resolveComponent(ref.referenceName, ref.filePath, context);
+            if (result) {
+                return {
+                    original: ref,
+                    targetNodeId: result,
+                    confidence: 0.8,
+                    resolvedBy: 'framework',
+                };
+            }
+        }
+        // Pattern 2: Hook references (use*)
+        if (ref.referenceName.startsWith('use') && ref.referenceName.length > 3) {
+            const result = resolveHook(ref.referenceName, context);
+            if (result) {
+                return {
+                    original: ref,
+                    targetNodeId: result,
+                    confidence: 0.85,
+                    resolvedBy: 'framework',
+                };
+            }
+        }
+        // Pattern 3: Context references
+        if (ref.referenceName.endsWith('Context') || ref.referenceName.endsWith('Provider')) {
+            const result = resolveContext(ref.referenceName, context);
+            if (result) {
+                return {
+                    original: ref,
+                    targetNodeId: result,
+                    confidence: 0.8,
+                    resolvedBy: 'framework',
+                };
+            }
+        }
+        return null;
+    },
+    extract(filePath, content) {
+        const nodes = [];
+        const references = [];
+        const now = Date.now();
+        // Components and custom hooks are NOT extracted here. The tree-sitter
+        // extractor already emits them natively across .ts/.tsx/.js/.jsx — function
+        // and arrow components as `function` nodes, HOC-wrapped components
+        // (`forwardRef`/`memo`/`styled`) as `component` nodes (#841), and `useX`
+        // hooks as `function` nodes. Re-deriving them here with regex only ran on
+        // .ts/.js anyway (this resolver's `languages` didn't include the 'tsx'/'jsx'
+        // grammars), and it DUPLICATED those tree-sitter nodes (e.g. a `useAuth`
+        // ended up as two `function` nodes). This `extract` now contributes only
+        // what tree-sitter can't: route nodes (React Router + Next.js conventions),
+        // which is why 'tsx'/'jsx' are now in `languages` — `<Route>`/`element={<X/>}`
+        // routes live in JSX files and were previously skipped entirely.
+        // React Router: <Route path="/x" component={Comp}/> (v5) or
+        // <Route path="/x" element={<Comp/>}/> (v6). Attributes appear in any order,
+        // and element={...} contains a nested `>`, so scan a window after each
+        // <Route rather than trying to match the whole (possibly multi-line) tag.
+        const routeTagRegex = /<Route\b/g;
+        let routeMatch;
+        while ((routeMatch = routeTagRegex.exec(content)) !== null) {
+            const window = content.slice(routeMatch.index, routeMatch.index + 400);
+            const pathMatch = window.match(/\bpath\s*=\s*["']([^"']+)["']/);
+            if (!pathMatch)
+                continue; // index/layout routes without a path
+            const routePath = pathMatch[1];
+            const compMatch = window.match(/\bcomponent\s*=\s*\{\s*([A-Z][A-Za-z0-9_]*)/) ||
+                window.match(/\belement\s*=\s*\{\s*<\s*([A-Z][A-Za-z0-9_]*)/);
+            const line = content.slice(0, routeMatch.index).split('\n').length;
+            const routeNode = {
+                id: `route:${filePath}:${line}:${routePath}`,
+                kind: 'route',
+                name: routePath,
+                qualifiedName: `${filePath}::route:${routePath}`,
+                filePath,
+                startLine: line,
+                endLine: line,
+                startColumn: 0,
+                endColumn: 0,
+                language: filePath.endsWith('.tsx') ? 'tsx' : 'jsx',
+                updatedAt: now,
+            };
+            nodes.push(routeNode);
+            if (compMatch) {
+                references.push({
+                    fromNodeId: routeNode.id,
+                    referenceName: compMatch[1],
+                    referenceKind: 'references',
+                    line,
+                    column: 0,
+                    filePath,
+                    language: filePath.endsWith('.tsx') ? 'tsx' : 'jsx',
+                });
+            }
+        }
+        // React Router data-router (v6.4+): createBrowserRouter([{ path, element }]).
+        // Only scan files that use the data-router API, then pull each route object's
+        // `path` + `element={<Comp/>}` / `Component: Comp` (a forward window confirms
+        // it's a route object, not a stray `path:` field).
+        if (/\b(?:createBrowserRouter|createHashRouter|createMemoryRouter|createRoutesFromElements)\b/.test(content)) {
+            const objPathRe = /\bpath\s*:\s*['"]([^'"]*)['"]/g;
+            let om;
+            while ((om = objPathRe.exec(content)) !== null) {
+                const win = content.slice(om.index, om.index + 300);
+                const compMatch = win.match(/\belement\s*:\s*<\s*([A-Z][A-Za-z0-9_]*)/) ||
+                    win.match(/\bComponent\s*:\s*([A-Z][A-Za-z0-9_]*)/);
+                if (!compMatch)
+                    continue; // require a component → it's a real route object
+                const routePath = om[1] || '/';
+                const line = content.slice(0, om.index).split('\n').length;
+                const routeNode = {
+                    id: `route:${filePath}:${line}:${routePath}`,
+                    kind: 'route',
+                    name: routePath,
+                    qualifiedName: `${filePath}::route:${routePath}`,
+                    filePath,
+                    startLine: line,
+                    endLine: line,
+                    startColumn: 0,
+                    endColumn: 0,
+                    language: filePath.endsWith('.tsx') ? 'tsx' : 'jsx',
+                    updatedAt: now,
+                };
+                nodes.push(routeNode);
+                references.push({
+                    fromNodeId: routeNode.id,
+                    referenceName: compMatch[1],
+                    referenceKind: 'references',
+                    line,
+                    column: 0,
+                    filePath,
+                    language: filePath.endsWith('.tsx') ? 'tsx' : 'jsx',
+                });
+            }
+        }
+        // Extract Next.js pages/routes (pages directory convention)
+        if (filePath.includes('pages/') || filePath.includes('app/')) {
+            // Default export in pages becomes a route
+            if (content.includes('export default')) {
+                const routePath = filePathToRoute(filePath);
+                if (routePath) {
+                    const line = content.indexOf('export default');
+                    const lineNum = content.slice(0, line).split('\n').length;
+                    nodes.push({
+                        id: `route:${filePath}:${routePath}:${lineNum}`,
+                        kind: 'route',
+                        name: routePath,
+                        qualifiedName: `${filePath}::route:${routePath}`,
+                        filePath,
+                        startLine: lineNum,
+                        endLine: lineNum,
+                        startColumn: 0,
+                        endColumn: 0,
+                        language: filePath.endsWith('.tsx') ? 'tsx' : filePath.endsWith('.ts') ? 'typescript' : 'javascript',
+                        updatedAt: now,
+                    });
+                }
+            }
+        }
+        return { nodes, references };
+    },
+};
+/**
+ * Check if string is PascalCase
+ */
+function isPascalCase(str) {
+    return /^[A-Z][a-zA-Z0-9]*$/.test(str);
+}
+/**
+ * Check if name is a built-in type
+ */
+function isBuiltInType(name) {
+    return BUILT_IN_TYPES.has(name);
+}
+const BUILT_IN_TYPES = new Set([
+    'Array', 'Boolean', 'Date', 'Error', 'Function', 'JSON', 'Math', 'Number',
+    'Object', 'Promise', 'RegExp', 'String', 'Symbol', 'Map', 'Set', 'WeakMap', 'WeakSet',
+    'React', 'Component', 'Fragment', 'Suspense', 'StrictMode',
+]);
+const COMPONENT_KINDS = new Set(['component', 'function', 'class']);
+/**
+ * Resolve a component reference using name-based lookup
+ */
+function resolveComponent(name, fromFile, context) {
+    const candidates = context.getNodesByName(name);
+    if (candidates.length === 0)
+        return null;
+    const components = candidates.filter((n) => COMPONENT_KINDS.has(n.kind));
+    if (components.length === 0)
+        return null;
+    // Prefer same directory
+    const fromDir = fromFile.substring(0, fromFile.lastIndexOf('/'));
+    const sameDir = components.filter((n) => n.filePath.startsWith(fromDir));
+    if (sameDir.length > 0)
+        return sameDir[0].id;
+    // Prefer component directories
+    const COMPONENT_DIRS = ['/components/', '/src/components/', '/app/components/', '/pages/', '/src/pages/', '/views/', '/src/views/'];
+    const preferred = components.filter((n) => COMPONENT_DIRS.some((d) => n.filePath.includes(d)));
+    if (preferred.length > 0)
+        return preferred[0].id;
+    // No positional signal: only an UNAMBIGUOUS name may resolve. Returning
+    // components[0] here picked an arbitrary same-named class anywhere in the
+    // repo (#764) — let the name-matcher's proximity scoring decide instead.
+    return components.length === 1 ? components[0].id : null;
+}
+/**
+ * Resolve a custom hook reference using name-based lookup
+ */
+function resolveHook(name, context) {
+    const candidates = context.getNodesByName(name);
+    if (candidates.length === 0)
+        return null;
+    const hooks = candidates.filter((n) => n.kind === 'function' && n.name.startsWith('use'));
+    if (hooks.length === 0)
+        return null;
+    // Prefer hooks directories
+    const HOOK_DIRS = ['/hooks/', '/src/hooks/', '/lib/hooks/', '/utils/hooks/'];
+    const preferred = hooks.filter((n) => HOOK_DIRS.some((d) => n.filePath.includes(d)));
+    if (preferred.length > 0)
+        return preferred[0].id;
+    return hooks[0].id;
+}
+/**
+ * Resolve a context reference using name-based lookup
+ */
+function resolveContext(name, context) {
+    const candidates = context.getNodesByName(name);
+    if (candidates.length === 0) {
+        // Try without Context/Provider suffix
+        const baseName = name.replace(/Context$|Provider$/, '');
+        if (baseName !== name) {
+            const baseCandidates = context.getNodesByName(baseName);
+            if (baseCandidates.length > 0)
+                return baseCandidates[0].id;
+        }
+        return null;
+    }
+    // Prefer context directories
+    const CONTEXT_DIRS = ['/context/', '/contexts/', '/src/context/', '/src/contexts/', '/providers/', '/src/providers/'];
+    const preferred = candidates.filter((n) => CONTEXT_DIRS.some((d) => n.filePath.includes(d)));
+    if (preferred.length > 0)
+        return preferred[0].id;
+    return candidates[0].id;
+}
+/**
+ * Convert file path to Next.js route
+ */
+function filePathToRoute(filePath) {
+    // pages/index.tsx -> /
+    // pages/about.tsx -> /about
+    // pages/blog/[slug].tsx -> /blog/:slug
+    // app/page.tsx -> /
+    // app/about/page.tsx -> /about
+    // Only real page-component files are routes. Exclude non-page extensions
+    // (.mjs/.json/.cjs), config files (next.config.ts, vite.config.ts…), and
+    // Next.js special files (_app/_document). This also stops a `*.config.mjs`
+    // with `export default` in a dir like `nextjs-pages/` from being a "route".
+    const base = filePath.split('/').pop() ?? '';
+    if (!/\.(tsx?|jsx?)$/.test(base))
+        return null;
+    if (base.startsWith('_') || /\.config\.[a-z]+$/.test(base))
+        return null;
+    // Match pages/ and app/ as PATH SEGMENTS (not a substring — `nextjs-pages/`
+    // must not count as a `pages/` router dir).
+    if (/(?:^|\/)pages\//.test(filePath)) {
+        let route = filePath
+            .replace(/^.*pages\//, '/')
+            .replace(/\/index\.(tsx?|jsx?)$/, '')
+            .replace(/\.(tsx?|jsx?)$/, '')
+            .replace(/\[([^\]]+)\]/g, ':$1');
+        if (route === '')
+            route = '/';
+        return route;
+    }
+    if (/(?:^|\/)app\//.test(filePath)) {
+        // App router - only page.tsx files are routes
+        if (!filePath.includes('page.')) {
+            return null;
+        }
+        let route = filePath
+            .replace(/^.*app\//, '/')
+            .replace(/\/page\.(tsx?|jsx?)$/, '')
+            .replace(/\[([^\]]+)\]/g, ':$1');
+        if (route === '')
+            route = '/';
+        return route;
+    }
+    return null;
+}
+//# sourceMappingURL=react.js.map

package/dist/resolution/frameworks/react.js.map

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

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

@@ -0,0 +1,8 @@
+/**
+ * Ruby Framework Resolver
+ *
+ * Handles Ruby on Rails patterns.
+ */
+import { FrameworkResolver } from '../types';
+export declare const railsResolver: FrameworkResolver;
+//# sourceMappingURL=ruby.d.ts.map

package/dist/resolution/frameworks/ruby.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ruby.d.ts","sourceRoot":"","sources":["../../../src/resolution/frameworks/ruby.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,iBAAiB,EAAiD,MAAM,UAAU,CAAC;AAG5F,eAAO,MAAM,aAAa,EAAE,iBAoL3B,CAAC"}

package/dist/resolution/frameworks/ruby.js

@@ -0,0 +1,302 @@
+"use strict";
+/**
+ * Ruby Framework Resolver
+ *
+ * Handles Ruby on Rails patterns.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.railsResolver = void 0;
+const strip_comments_1 = require("../strip-comments");
+exports.railsResolver = {
+    name: 'rails',
+    languages: ['ruby'],
+    // `controller#action` route refs name no declared symbol, so resolveOne's
+    // pre-filter would drop them before resolve() runs. Claim them (like the django
+    // `_iterable_class` hook) so they reach Pattern 0.
+    claimsReference(name) {
+        return /^[\w/]+#\w+$/.test(name);
+    },
+    detect(context) {
+        // Check for Gemfile with rails
+        const gemfile = context.readFile('Gemfile');
+        if (gemfile && gemfile.includes("'rails'")) {
+            return true;
+        }
+        // Check for config/application.rb (Rails signature)
+        if (context.fileExists('config/application.rb')) {
+            return true;
+        }
+        // Check for typical Rails directory structure
+        return (context.fileExists('app/controllers/application_controller.rb') ||
+            context.fileExists('config/routes.rb'));
+    },
+    resolve(ref, context) {
+        // Pattern 0: route action `controller#action` (from RESTful `resources` or an
+        // explicit route) → the action method in that controller. Precise — avoids the
+        // bare-`action` ambiguity (every controller has an `index`/`show`).
+        const ca = ref.referenceName.match(/^([\w/]+)#(\w+)$/);
+        if (ca) {
+            const result = resolveControllerAction(ca[1], ca[2], context);
+            if (result) {
+                return { original: ref, targetNodeId: result, confidence: 0.85, resolvedBy: 'framework' };
+            }
+            return null;
+        }
+        // Pattern 1: Model references (ActiveRecord)
+        if (/^[A-Z][a-zA-Z]+$/.test(ref.referenceName)) {
+            const result = resolveModel(ref.referenceName, context);
+            if (result) {
+                return {
+                    original: ref,
+                    targetNodeId: result,
+                    confidence: 0.8,
+                    resolvedBy: 'framework',
+                };
+            }
+        }
+        // Pattern 2: Controller references
+        if (ref.referenceName.endsWith('Controller')) {
+            const result = resolveController(ref.referenceName, context);
+            if (result) {
+                return {
+                    original: ref,
+                    targetNodeId: result,
+                    confidence: 0.85,
+                    resolvedBy: 'framework',
+                };
+            }
+        }
+        // Pattern 3: Helper references
+        if (ref.referenceName.endsWith('Helper')) {
+            const result = resolveHelper(ref.referenceName, context);
+            if (result) {
+                return {
+                    original: ref,
+                    targetNodeId: result,
+                    confidence: 0.8,
+                    resolvedBy: 'framework',
+                };
+            }
+        }
+        // Pattern 4: Service/Job references
+        if (ref.referenceName.endsWith('Service') || ref.referenceName.endsWith('Job')) {
+            const result = resolveService(ref.referenceName, context);
+            if (result) {
+                return {
+                    original: ref,
+                    targetNodeId: result,
+                    confidence: 0.8,
+                    resolvedBy: 'framework',
+                };
+            }
+        }
+        return null;
+    },
+    extract(filePath, content) {
+        if (!filePath.endsWith('.rb'))
+            return { nodes: [], references: [] };
+        const nodes = [];
+        const references = [];
+        const now = Date.now();
+        const safe = (0, strip_comments_1.stripCommentsForRegex)(content, 'ruby');
+        // get/post/put/patch/delete/match '/path', to: 'controller#action'
+        // Also: get '/path' => 'controller#action'
+        const routeRegex = /\b(get|post|put|patch|delete|match)\s+['"]([^'"]+)['"]\s*(?:,\s*to:\s*|=>\s*)['"]([^#'"]+)#([^'"]+)['"]/g;
+        let match;
+        while ((match = routeRegex.exec(safe)) !== null) {
+            const [, method, routePath, ctrl, action] = match;
+            const line = safe.slice(0, match.index).split('\n').length;
+            const upper = method.toUpperCase();
+            const routeNode = {
+                id: `route:${filePath}:${line}:${upper}:${routePath}`,
+                kind: 'route',
+                name: `${upper} ${routePath}`,
+                qualifiedName: `${filePath}::route:${routePath}`,
+                filePath,
+                startLine: line,
+                endLine: line,
+                startColumn: 0,
+                endColumn: match[0].length,
+                language: 'ruby',
+                updatedAt: now,
+            };
+            nodes.push(routeNode);
+            references.push({
+                fromNodeId: routeNode.id,
+                referenceName: `${ctrl}#${action}`, // precise controller#action, not bare action
+                referenceKind: 'references',
+                line,
+                column: 0,
+                filePath,
+                language: 'ruby',
+            });
+        }
+        // RESTful resources: `resources :articles` / `resource :user` (the dominant
+        // Rails routing) generate a controller action per REST verb. The old resolver
+        // only saw explicit `get '/x' => 'c#a'` routes, so resource-routed apps had
+        // ZERO route nodes. Expand each into its actions → `controller#action` refs.
+        const resRegex = /\b(resources?)\s+:(\w+)([^\n]*)/g;
+        while ((match = resRegex.exec(safe)) !== null) {
+            const plural = match[1] === 'resources';
+            const resName = match[2];
+            const tail = match[3] || '';
+            let actions = plural ? PLURAL_ACTIONS : SINGULAR_ACTIONS;
+            const only = tail.match(/only:\s*\[([^\]]*)\]/);
+            const except = tail.match(/except:\s*\[([^\]]*)\]/);
+            const symList = (s) => new Set(s.split(',').map((x) => x.trim().replace(/^:/, '')));
+            if (only) {
+                const s = symList(only[1]);
+                actions = actions.filter((a) => s.has(a));
+            }
+            else if (except) {
+                const s = symList(except[1]);
+                actions = actions.filter((a) => !s.has(a));
+            }
+            // `resources :articles` → ArticlesController; `resource :user` → UsersController.
+            const ctrl = plural ? resName : pluralize(resName);
+            const line = safe.slice(0, match.index).split('\n').length;
+            for (const action of actions) {
+                const spec = RESTFUL_ROUTES[action];
+                const path = spec.path(resName);
+                const routeNode = {
+                    id: `route:${filePath}:${line}:${spec.method}:${ctrl}#${action}`,
+                    kind: 'route',
+                    name: `${spec.method} ${path}`,
+                    qualifiedName: `${filePath}::route:${ctrl}#${action}`,
+                    filePath, startLine: line, endLine: line, startColumn: 0, endColumn: match[0].length,
+                    language: 'ruby', updatedAt: now,
+                };
+                nodes.push(routeNode);
+                references.push({
+                    fromNodeId: routeNode.id,
+                    referenceName: `${ctrl}#${action}`,
+                    referenceKind: 'references',
+                    line, column: 0, filePath, language: 'ruby',
+                });
+            }
+        }
+        return { nodes, references };
+    },
+};
+// Helper functions
+// RESTful action → HTTP verb + path. `resources` gets all seven; a singular
+// `resource` omits `index`.
+const RESTFUL_ROUTES = {
+    index: { method: 'GET', path: (r) => `/${r}` },
+    create: { method: 'POST', path: (r) => `/${r}` },
+    new: { method: 'GET', path: (r) => `/${r}/new` },
+    show: { method: 'GET', path: (r) => `/${r}/:id` },
+    edit: { method: 'GET', path: (r) => `/${r}/:id/edit` },
+    update: { method: 'PATCH', path: (r) => `/${r}/:id` },
+    destroy: { method: 'DELETE', path: (r) => `/${r}/:id` },
+};
+const PLURAL_ACTIONS = ['index', 'create', 'new', 'show', 'edit', 'update', 'destroy'];
+const SINGULAR_ACTIONS = ['create', 'new', 'show', 'edit', 'update', 'destroy'];
+/** Naive ActiveSupport-style pluralize — covers the common resource names. */
+function pluralize(w) {
+    if (/[^aeiou]y$/.test(w))
+        return w.slice(0, -1) + 'ies';
+    if (/(s|x|z|ch|sh)$/.test(w))
+        return w + 'es';
+    return w + 's';
+}
+/** snake_case → CamelCase (`user_profiles` → `UserProfiles`). */
+function camelize(s) {
+    return s.split('_').map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join('');
+}
+/** Resolve a `controller#action` route ref to the action method in that controller. */
+function resolveControllerAction(ctrlPath, action, context) {
+    // Rails convention: `articles` → app/controllers/articles_controller.rb.
+    const direct = `app/controllers/${ctrlPath}_controller.rb`;
+    if (context.fileExists(direct)) {
+        const m = context.getNodesInFile(direct).find((n) => (n.kind === 'method' || n.kind === 'function') && n.name === action);
+        if (m)
+            return m.id;
+    }
+    // Fall back: controller class by name, then the action method in its file.
+    const cls = camelize(ctrlPath.split('/').pop()) + 'Controller';
+    for (const ctrl of context.getNodesByName(cls).filter((n) => n.kind === 'class')) {
+        const m = context.getNodesInFile(ctrl.filePath).find((n) => (n.kind === 'method' || n.kind === 'function') && n.name === action);
+        if (m)
+            return m.id;
+    }
+    return null;
+}
+function resolveModel(name, context) {
+    // Try direct file path lookup first (Rails convention: CamelCase -> snake_case.rb)
+    const snakeName = name.replace(/([A-Z])/g, '_$1').toLowerCase().slice(1);
+    const possiblePaths = [
+        `app/models/${snakeName}.rb`,
+        `app/models/concerns/${snakeName}.rb`,
+    ];
+    for (const modelPath of possiblePaths) {
+        if (context.fileExists(modelPath)) {
+            const nodes = context.getNodesInFile(modelPath);
+            const modelNode = nodes.find((n) => n.kind === 'class' && n.name === name);
+            if (modelNode) {
+                return modelNode.id;
+            }
+        }
+    }
+    // Fall back to name-based lookup
+    const candidates = context.getNodesByName(name);
+    const modelNode = candidates.find((n) => n.kind === 'class' && n.filePath.includes('app/models/'));
+    if (modelNode)
+        return modelNode.id;
+    return null;
+}
+function resolveController(name, context) {
+    // Try direct file path lookup first
+    const snakeName = name.replace(/([A-Z])/g, '_$1').toLowerCase().slice(1);
+    const possiblePaths = [
+        `app/controllers/${snakeName}.rb`,
+        `app/controllers/api/${snakeName}.rb`,
+        `app/controllers/api/v1/${snakeName}.rb`,
+    ];
+    for (const controllerPath of possiblePaths) {
+        if (context.fileExists(controllerPath)) {
+            const nodes = context.getNodesInFile(controllerPath);
+            const controllerNode = nodes.find((n) => n.kind === 'class' && n.name === name);
+            if (controllerNode) {
+                return controllerNode.id;
+            }
+        }
+    }
+    // Fall back to name-based lookup
+    const candidates = context.getNodesByName(name);
+    const controllerNode = candidates.find((n) => n.kind === 'class' && n.filePath.includes('controllers/'));
+    if (controllerNode)
+        return controllerNode.id;
+    return null;
+}
+function resolveHelper(name, context) {
+    const snakeName = name.replace(/([A-Z])/g, '_$1').toLowerCase().slice(1);
+    const helperPath = `app/helpers/${snakeName}.rb`;
+    if (context.fileExists(helperPath)) {
+        const nodes = context.getNodesInFile(helperPath);
+        const helperNode = nodes.find((n) => n.kind === 'module' && n.name === name);
+        if (helperNode) {
+            return helperNode.id;
+        }
+    }
+    return null;
+}
+function resolveService(name, context) {
+    const snakeName = name.replace(/([A-Z])/g, '_$1').toLowerCase().slice(1);
+    const possiblePaths = [
+        `app/services/${snakeName}.rb`,
+        `app/jobs/${snakeName}.rb`,
+        `app/workers/${snakeName}.rb`,
+    ];
+    for (const servicePath of possiblePaths) {
+        if (context.fileExists(servicePath)) {
+            const nodes = context.getNodesInFile(servicePath);
+            const serviceNode = nodes.find((n) => n.kind === 'class' && n.name === name);
+            if (serviceNode) {
+                return serviceNode.id;
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=ruby.js.map