codesearch-mcp 0.2.3-alpha → 0.3.0-alpha

package/dist/src/services/AstParserService.js

@@ -37,6 +37,8 @@ exports.AstParserService = void 0;
 const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
 const ts_morph_1 = require("ts-morph");
+const DeclarationTreeBuilder_1 = require("../declarations/DeclarationTreeBuilder");
+const DeclarationTree_1 = require("../declarations/DeclarationTree");
 const LoggerService_1 = require("./LoggerService");
 const GRAPHQL_MODULE = '@nestjs/graphql';
 const GRAPHQL_TYPE_DECORATORS = new Set(['ObjectType', 'InputType', 'InterfaceType']);
@@ -55,11 +57,11 @@ class AstParserService {
     logger;
     deps;
     morphProjects = new Map();
+    declarationBuilder = new DeclarationTreeBuilder_1.DeclarationTreeBuilder();
     constructor(logger = LoggerService_1.LoggerService.silent(), deps = {}) {
         this.logger = logger;
         this.deps = deps;
     }
-    // ── public interface ────────────────────────────────────────────────────────
     async analyzeProject(filePaths, serviceName, projectRoot = process.cwd(), opts = {}) {
         const t0 = Date.now();
         const skipDependencyResolution = opts.skipDependencyResolution ?? false;
@@ -76,7 +78,7 @@ class AstParserService {
                 morphProject.addSourceFileAtPath(filePath);
             }
             catch (err) {
-                this.logger.warn('AstParser: failed to add source file', { filePath, reason: err.message });
+                this.logger.warn('AstParser: failed to add source file', { filePath, err });
                 analysisMap.set(filePath, { edges: [], symbols: [], calls: [], members: [], graphqlNames: [] });
             }
         }
@@ -84,7 +86,6 @@ class AstParserService {
             const filePath = sourceFile.getFilePath();
             analysisMap.set(filePath, this.analyzeSourceFile(sourceFile, filePath, serviceName));
         }
-        // Release source file memory before returning
         for (const sourceFile of morphProject.getSourceFiles()) {
             morphProject.removeSourceFile(sourceFile);
         }
@@ -120,7 +121,7 @@ class AstParserService {
             sourceFile = morphProject.addSourceFileAtPath(filePath);
         }
         catch (err) {
-            this.logger.warn('AstParser: analyzeFile failed to add source file', { filePath, reason: err.message, ms: Date.now() - t0 });
+            this.logger.warn('AstParser: analyzeFile failed to add source file', { filePath, err, ms: Date.now() - t0 });
             return { edges: [], symbols: [], calls: [], members: [], graphqlNames: [] };
         }
         const result = this.analyzeSourceFile(sourceFile, filePath, serviceName);
@@ -130,7 +131,6 @@ class AstParserService {
         });
         return result;
     }
-    // Kept for test compatibility (extract-import-edges.test.ts).
     async extractImportEdges(filePath, serviceName, projectRoot) {
         const { edges } = await this.analyzeFile(filePath, serviceName, projectRoot);
         return edges;
@@ -140,54 +140,37 @@ class AstParserService {
             const edges = this.extractEdges(sourceFile, filePath, serviceName);
             const symbolCandidates = this.extractSymbols(sourceFile, filePath, serviceName);
             const symbols = symbolCandidates.map(c => c.entry);
-            // Member extraction (classes anywhere, class/interface/object-literal
-            // members, namespace-level declarations) is isolated in its own try: a
-            // bug there must never change a file's top-level symbols, chunks or
-            // embedding prompt (see the `symbol-index-members` retrieval-invariance
-            // requirement).
             let memberCandidates = [];
             try {
                 memberCandidates = this.extractMembers(sourceFile, filePath, serviceName);
             }
             catch (err) {
-                this.logger.warn('AstParser: member extraction failed', { filePath, reason: err.message });
+                this.logger.warn('AstParser: member extraction failed', { filePath, err });
                 memberCandidates = [];
             }
             const members = memberCandidates.map(c => c.entry);
             const calls = this.extractCalls(sourceFile, filePath, serviceName);
-            const ownerRanges = this.buildOwnerRanges([...symbolCandidates, ...memberCandidates]);
-            // GraphQL-named rows are isolated like members: a bug here must never
-            // change a file's symbols, members, chunks, ownerPath or call graph.
-            // Runs after member extraction (decision 6 of `graphql-symbols`) — a
-            // GraphQL row is written only when the decorated declaration's own row
-            // was written to code_symbol.
+            const declarations = this.buildDeclarations(sourceFile, filePath, symbolCandidates, memberCandidates);
             let graphqlNames = [];
             try {
                 graphqlNames = this.extractGraphqlNames(sourceFile, filePath, serviceName, [...symbolCandidates, ...memberCandidates]);
             }
             catch (err) {
-                this.logger.warn('AstParser: GraphQL extraction failed', { filePath, reason: err.message });
+                this.logger.warn('AstParser: GraphQL extraction failed', { filePath, err });
                 graphqlNames = [];
             }
-            return { edges, symbols, members, calls, ownerRanges, graphqlNames };
+            return { edges, symbols, members, calls, declarations, graphqlNames };
         }
         catch (err) {
-            this.logger.warn('AstParser: failed to analyze file', { filePath, reason: err.message });
+            this.logger.warn('AstParser: failed to analyze file', { filePath, err });
             return { edges: [], symbols: [], calls: [], members: [], graphqlNames: [] };
         }
     }
-    // ── private: MorphProject cache (LRU, max MORPH_CACHE_MAX entries) ──────────
     createMorphProject(projectRoot, skipFileDependencyResolution = false, rootTsConfigPath) {
         const t0 = Date.now();
-        // Determine which tsconfig to use:
-        // 1. Project-local tsconfig.json
-        // 2. Root tsconfig (e.g. tsconfig.base.json for Nx monorepos)
-        // 3. Fallback options
         const localTsconfigPath = path.join(projectRoot, 'tsconfig.json');
         const hasLocalTsconfig = fs.existsSync(localTsconfigPath);
         const hasRootTsconfig = rootTsConfigPath ? fs.existsSync(rootTsConfigPath) : false;
-        // For monorepos: prefer the root tsconfig.base.json which contains
-        // workspace-wide path aliases (e.g. @scope/* → libs/*/src)
         const effectiveTsconfig = hasRootTsconfig ? rootTsConfigPath : (hasLocalTsconfig ? localTsconfigPath : null);
         this.logger.debug('AstParser: tsconfig lookup', {
             projectRoot,
@@ -219,7 +202,7 @@ class AstParserService {
         catch (err) {
             this.logger.warn('AstParser: tsconfig load failed, using fallback', {
                 tsconfigPath: effectiveTsconfig ?? localTsconfigPath,
-                reason: err.message,
+                err,
                 ms: Date.now() - t0,
             });
             project = new ts_morph_1.Project(FALLBACK_OPTS);
@@ -228,7 +211,6 @@ class AstParserService {
     }
     getMorphProject(projectRoot) {
         if (this.morphProjects.has(projectRoot)) {
-            // Move to end = most recently used
             const cached = this.morphProjects.get(projectRoot);
             this.morphProjects.delete(projectRoot);
             this.morphProjects.set(projectRoot, cached);
@@ -236,7 +218,6 @@ class AstParserService {
             return cached;
         }
         if (this.morphProjects.size >= MORPH_CACHE_MAX) {
-            // Evict least recently used (first entry in insertion-order Map)
             const lruKey = this.morphProjects.keys().next().value;
             this.morphProjects.delete(lruKey);
             this.logger.debug('AstParser: evicted LRU project', { lruKey });
@@ -246,7 +227,6 @@ class AstParserService {
         this.morphProjects.set(projectRoot, project);
         return project;
     }
-    // ── private: edge extraction (imports + re-exports) ────────────────────────
     extractEdges(sourceFile, filePath, serviceName) {
         const edges = [];
         const usageMap = this.buildUsageMap(sourceFile);
@@ -257,9 +237,6 @@ class AstParserService {
             const hasClause = Boolean(defaultImport || namespaceImport || namedImports.length > 0);
             const resolved = decl.getModuleSpecifierSourceFile();
             let toFile = resolved ? resolved.getFilePath() : null;
-            // A bindingless specifier never resolves through ts-morph's bound symbol
-            // (nothing is bound), even for a real project file — fall back to
-            // TypeScript's own resolver and map the result back onto the project.
             if (!toFile && !hasClause) {
                 toFile = this.resolveSideEffectModuleSpecifier(decl, sourceFile, filePath);
             }
@@ -328,9 +305,6 @@ class AstParserService {
         }
         return edges;
     }
-    /** Manual fallback for a bindingless import specifier (design.md decision 2) —
-     * ts-morph's `getModuleSpecifierSourceFile()` is `null` for these even when
-     * the target is a real project file, since nothing is bound to resolve through. */
     resolveSideEffectModuleSpecifier(decl, sourceFile, filePath) {
         const specifier = decl.getModuleSpecifierValue();
         const compilerOptions = sourceFile.getProject().getCompilerOptions();
@@ -349,7 +323,6 @@ class AstParserService {
         const containers = [
             ...sourceFile.getClasses().flatMap(n => n.getName() ? [{ name: n.getName(), node: n }] : []),
             ...sourceFile.getFunctions().flatMap(n => n.getName() ? [{ name: n.getName(), node: n }] : []),
-            // include top-level variable declarations so arrow function exports are tracked for fromSymbol
             ...sourceFile.getVariableStatements()
                 .flatMap(stmt => stmt.getDeclarations())
                 .flatMap(n => {
@@ -372,20 +345,15 @@ class AstParserService {
         }
         return map;
     }
-    // ── private: position / signature helpers ───────────────────────────────────
     getPos(sourceFile, node) {
         const { line, character } = sourceFile.compilerNode
             .getLineAndCharacterOfPosition(node.getStart());
         return { line: line + 1, col: character + 1 };
     }
-    /** Trimmed text of the source line containing `node`'s start — the signature
-     * rule for every kind (name node for members, the position node for
-     * constructors/anonymous default classes). */
     lineTextAt(sourceLines, sourceFile, node) {
         const { line } = this.getPos(sourceFile, node);
         return (sourceLines[line - 1] ?? node.getText().split('\n')[0]).trim();
     }
-    // ── private: top-level symbol extraction (feeds the chunker + prompt) ──────
     extractSymbols(sourceFile, filePath, serviceName) {
         const candidates = [];
         const sourceLines = sourceFile.getFullText().split('\n');
@@ -453,8 +421,6 @@ class AstParserService {
                 const nameNode = decl.getNameNode();
                 const { line, col } = this.getPos(sourceFile, nameNode);
                 candidates.push({
-                    // Owner ranges use the declarator's own span, not the statement's —
-                    // each declarator of `const a = 1, b = () => {…}` owns only its lines.
                     declNode: decl,
                     entry: {
                         project: serviceName, filePath, name: decl.getName(), kind: 'variable',
@@ -467,7 +433,6 @@ class AstParserService {
         }
         return candidates;
     }
-    // ── private: member extraction (classes anywhere, members, namespace body) ─
     extractMembers(sourceFile, filePath, serviceName) {
         const candidates = [];
         const sourceLines = sourceFile.getFullText().split('\n');
@@ -485,14 +450,10 @@ class AstParserService {
                 },
             });
         };
-        // Classes anywhere in the file — nested, expression, anonymous default.
         for (const cls of [
             ...sourceFile.getDescendantsOfKind(ts_morph_1.SyntaxKind.ClassDeclaration),
             ...sourceFile.getDescendantsOfKind(ts_morph_1.SyntaxKind.ClassExpression),
         ]) {
-            // Named top-level classes are already handled by extractSymbols; an
-            // anonymous top-level class (`export default class {}`) is not — it
-            // must still be collected here.
             if (ts_morph_1.Node.isClassDeclaration(cls) && cls.getName() && ts_morph_1.Node.isSourceFile(cls.getParent()))
                 continue;
             const described = this.describeIndexedNode(cls);
@@ -501,7 +462,6 @@ class AstParserService {
             const posNode = (ts_morph_1.Node.isClassDeclaration(cls) ? cls.getNameNode() : undefined) ?? cls;
             push(cls, posNode, described.name, 'class', described.container, false, true);
         }
-        // Class / object-literal methods, accessors, constructors, function properties.
         for (const m of sourceFile.getDescendantsOfKind(ts_morph_1.SyntaxKind.MethodDeclaration)) {
             const described = this.describeIndexedNode(m);
             if (!described)
@@ -539,7 +499,6 @@ class AstParserService {
                 continue;
             push(p, p.getNameNode(), described.name, 'function_property', described.container, false, true);
         }
-        // Interface / type-literal method and function-typed property signatures.
         for (const s of sourceFile.getDescendantsOfKind(ts_morph_1.SyntaxKind.MethodSignature)) {
             const described = this.describeIndexedNode(s);
             if (!described)
@@ -552,7 +511,6 @@ class AstParserService {
                 continue;
             push(s, s.getNameNode(), described.name, 'method_signature', described.container, false, false);
         }
-        // Declarations directly in a namespace body.
         for (const fn of sourceFile.getDescendantsOfKind(ts_morph_1.SyntaxKind.FunctionDeclaration)) {
             if (!ts_morph_1.Node.isModuleBlock(fn.getParent()))
                 continue;
@@ -592,24 +550,20 @@ class AstParserService {
         }
         return candidates;
     }
-    /** Chunk-ownership ranges from every indexed declaration (top-level symbols +
-     * members) except `method_signature`. Each range spans the declaration node's
-     * own first-to-last line — decorator-inclusive, comment-exclusive, and (for a
-     * variable) the declarator alone, never the whole statement. */
-    buildOwnerRanges(candidates) {
-        return candidates
-            .filter(c => c.entry.kind !== 'method_signature')
-            .map(c => ({
-            name: c.entry.name,
-            container: c.entry.container,
-            line: c.declNode.getStartLineNumber(),
-            endLine: c.declNode.getEndLineNumber(),
-        }));
+    buildDeclarations(sourceFile, filePath, symbolCandidates, memberCandidates) {
+        try {
+            return this.declarationBuilder.build(sourceFile, [...symbolCandidates, ...memberCandidates]);
+        }
+        catch (err) {
+            this.logger.warn('AstParser: declaration tree build failed', { filePath, err });
+            try {
+                return this.declarationBuilder.flat(symbolCandidates);
+            }
+            catch {
+                return DeclarationTree_1.DeclarationTree.EMPTY;
+            }
+        }
     }
-    // ── private: GraphQL-named rows (graphql-symbols) ───────────────────────────
-    /** Local name → the name exported by `@nestjs/graphql`, for every named import
-     * of that module specifier (aliases followed). Recognition is import-based,
-     * not type-checker-based, so `skipFileDependencyResolution` batches agree. */
     buildGraphqlImportMap(sourceFile) {
         const map = new Map();
         for (const decl of sourceFile.getImportDeclarations()) {
@@ -623,7 +577,6 @@ class AstParserService {
         }
         return map;
     }
-    /** The identifier naming a decorator's expression (`@Foo` or the callee of `@Foo(...)`). */
     static decoratorIdentifier(dec) {
         const expr = dec.getExpression();
         if (ts_morph_1.Node.isCallExpression(expr)) {
@@ -632,7 +585,6 @@ class AstParserService {
         }
         return ts_morph_1.Node.isIdentifier(expr) ? expr : undefined;
     }
-    /** `dec` recognised against `importMap` — its exported `@nestjs/graphql` name and its call arguments (`[]` for a bare `@Foo`). */
     recognizedDecorator(dec, importMap) {
         const idNode = AstParserService.decoratorIdentifier(dec);
         if (!idNode)
@@ -652,9 +604,6 @@ class AstParserService {
     static checkGraphqlGrammar(name) {
         return GRAPHQL_NAME_RE.test(name) ? { ok: true, name } : { ok: false, reason: 'invalid-name', value: name };
     }
-    /** `true` when any decorator argument is an (unwrapped) options object
-     * literal with `isAbstract: true` — an abstract base type (`PaginatedType`
-     * pattern) that NestJS never registers in the actual GraphQL schema. */
     static isAbstractGraphqlType(args) {
         return args.some((arg) => {
             if (!ts_morph_1.Node.isObjectLiteralExpression(arg))
@@ -673,7 +622,6 @@ class AstParserService {
             return init !== undefined && ts_morph_1.Node.isTrueLiteral(init);
         });
     }
-    /** `obj`'s own `name` property (`PropertyAssignment` or `ShorthandPropertyAssignment`), if any. */
     static findNameProperty(obj) {
         return obj.getProperties().find((p) => {
             if (!ts_morph_1.Node.isPropertyAssignment(p) && !ts_morph_1.Node.isShorthandPropertyAssignment(p))
@@ -686,10 +634,6 @@ class AstParserService {
             return false;
         });
     }
-    /** Strips parens/`as`/`satisfies`/non-null wrappers (any nesting) to find the
-     * underlying node — used only to classify an argument's *shape* (type
-     * function vs. options object vs. literal vs. other), never to read a name
-     * value through the wrapper (decision 4 of `graphql-symbols` forbids that). */
     static peekThroughWrapper(node) {
         let current = node;
         let wrapped = false;
@@ -703,22 +647,12 @@ class AstParserService {
         }
         return { inner: current, wrapped };
     }
-    /**
-     * GraphQL name from a decorator's arguments (design decision 4 of
-     * `graphql-symbols`) — syntactic, no wrapper looked through at any step.
-     * `allowOptionsName` gates step 2 (the `name` option — `Query`/`Mutation`/
-     * `Subscription`/`ResolveField` only); `fallbackName` is the TS name used at
-     * step 3.
-     */
     deriveGraphqlName(args, allowOptionsName, fallbackName) {
         if (args.length > 0) {
             const first = args[0];
             const { inner, wrapped } = AstParserService.peekThroughWrapper(first);
             const literal = AstParserService.literalStringValue(inner);
             if (literal !== null) {
-                // A wrapped literal is still "a wrapped ... argument", an anything-else
-                // node (decision 4) — reading its value through the wrapper is exactly
-                // what "no wrapper is looked through" forbids.
                 if (wrapped)
                     return { ok: false, reason: 'non-literal-name' };
                 return AstParserService.checkGraphqlGrammar(literal);
@@ -726,18 +660,12 @@ class AstParserService {
             const isTypeFnOrOptions = ts_morph_1.Node.isArrowFunction(inner) || ts_morph_1.Node.isFunctionExpression(inner) || ts_morph_1.Node.isObjectLiteralExpression(inner);
             if (!isTypeFnOrOptions)
                 return { ok: false, reason: 'non-literal-name' };
-            // Type function / options object, wrapped or not — this is a routing
-            // decision only (go to step 2/3); nothing is read from it here, so its
-            // wrapper doesn't matter yet.
         }
         if (allowOptionsName) {
             for (const arg of args) {
                 const { inner, wrapped } = AstParserService.peekThroughWrapper(arg);
                 if (!ts_morph_1.Node.isObjectLiteralExpression(inner))
                     continue;
-                // A wrapped options object cannot be trusted without looking through
-                // the wrapper, which decision 4 forbids — treat it as non-literal
-                // rather than silently skipping to the next argument or to step 3.
                 if (wrapped)
                     return { ok: false, reason: 'non-literal-name' };
                 const nameProp = AstParserService.findNameProperty(inner);
@@ -760,15 +688,10 @@ class AstParserService {
             fields.value = value;
         this.logger.debug('AstParser: graphql row skipped', fields);
     }
-    /** `declNode`'s qualified TypeScript name for diagnostics, independent of
-     * whether its own `code_symbol` row was actually written. */
     declarationNameFor(node, fallback) {
         const described = this.describeIndexedNode(node);
         return described ? this.qualifiedName(described) : fallback;
     }
-    /** The identifier named by a `@Resolver` argument: directly, or as an arrow
-     * function's expression body; or the sole identifier of a single-element
-     * array literal in either position (list-returning resolver). */
     static extractResolverIdentifier(argNode) {
         let target = argNode;
         if (ts_morph_1.Node.isArrowFunction(target)) {
@@ -794,10 +717,6 @@ class AstParserService {
         const resolved = firstDecl && ts_morph_1.Node.isImportSpecifier(firstDecl) ? (sym.getAliasedSymbol() ?? sym) : sym;
         return resolved.getDeclarations()?.[0];
     }
-    /** The GraphQL type name of a `@ResolveField`'s resolved parent class
-     * (design decision 5, second half): its recognised `@ObjectType` (else
-     * `@InterfaceType`) decorator, or its class name when it carries no
-     * decorator spelled `ObjectType`/`InterfaceType` at all, recognised or not. */
     classGraphqlTypeName(declClass) {
         const declImportMap = this.buildGraphqlImportMap(declClass.getSourceFile());
         const decorators = declClass.getDecorators();
@@ -815,9 +734,6 @@ class AstParserService {
             const nameResult = this.deriveGraphqlName(recognized.args, false, fallbackName);
             return nameResult.ok ? { ok: true, name: nameResult.name } : { ok: false };
         }
-        // Carries a type-spelled decorator that isn't recognised (e.g. imported
-        // through a barrel) — its GraphQL name is unreadable; the class-name
-        // fallback never applies to it (it may differ from the unreadable name).
         if (hasAnyTypeSpelledDecorator)
             return { ok: false };
         const name = declClass.getName();
@@ -825,8 +741,6 @@ class AstParserService {
             return { ok: false };
         return GRAPHQL_NAME_RE.test(name) ? { ok: true, name } : { ok: false, value: name };
     }
-    /** The parent type of a `@ResolveField` — the enclosing class's recognised
-     * `@Resolver` argument (design decision 5, first half). */
     resolveResolverParentType(cls, importMap) {
         const resolverDec = cls.getDecorators()
             .map(d => this.recognizedDecorator(d, importMap))
@@ -914,9 +828,6 @@ class AstParserService {
             if (!rec)
                 continue;
             if (rec.name === 'ResolveField') {
-                // Isolated per field: a throw resolving this field's parent (e.g. the
-                // injected test seam) degrades to "no row for that field" and never
-                // trips the file-level catch in `analyzeSourceFile`.
                 try {
                     this.extractResolveFieldRow(method, rec, own, declaration, importMap, filePath, serviceName, entries);
                 }
@@ -927,7 +838,7 @@ class AstParserService {
             }
             const kind = GRAPHQL_OPERATION_KIND[rec.name];
             if (!kind)
-                continue; // recognised but not an operation decorator (wrong declaration kind) — ignored, no log
+                continue;
             if (!own) {
                 this.logGraphqlSkip(filePath, declaration, rec.name, 'no-symbol-row');
                 continue;
@@ -944,10 +855,6 @@ class AstParserService {
             });
         }
     }
-    /** GraphQL-named rows for every recognised `@nestjs/graphql` decorator in
-     * the file (`graphql-symbols`). `ownRows` is `symbols ∪ members` — the
-     * declarations' own `code_symbol` candidates, checked so a GraphQL row is
-     * never written without its decorated declaration's own row. */
     extractGraphqlNames(sourceFile, filePath, serviceName, ownRows) {
         const importMap = this.buildGraphqlImportMap(sourceFile);
         if (importMap.size === 0)
@@ -964,7 +871,6 @@ class AstParserService {
         }
         return entries;
     }
-    // ── private: shared container resolution ────────────────────────────────────
     static isValidSegment(s) {
         return VALID_SEGMENT.test(s);
     }
@@ -998,7 +904,6 @@ class AstParserService {
         return current;
     }
     isModuleOrNamespaceLevelVariable(varDecl) {
-        // VariableDeclaration -> VariableDeclarationList -> VariableStatement -> (SourceFile | ModuleBlock)
         const stmt = varDecl.getParent()?.getParent();
         const stmtParent = stmt?.getParent();
         return ts_morph_1.Node.isSourceFile(stmtParent) || ts_morph_1.Node.isModuleBlock(stmtParent);
@@ -1031,9 +936,6 @@ class AstParserService {
     isTopLevelOrNamespaceDirect(node) {
         return ts_morph_1.Node.isSourceFile(node) || ts_morph_1.Node.isModuleBlock(node);
     }
-    /** One step of the ancestor walk used by `containerSegments`: does `node`
-     * contribute a named segment, pass through transparently, or disqualify
-     * (exclude) everything nested inside it? */
     walkStep(node) {
         if (ts_morph_1.Node.isModuleDeclaration(node)) {
             if (node.compilerNode.flags & ts_morph_1.NodeFlags.GlobalAugmentation)
@@ -1086,10 +988,6 @@ class AstParserService {
         }
         return { kind: 'transparent' };
     }
-    /** The dotted container path of `node`'s enclosing named scopes, outermost
-     * first, or null when any contributing ancestor is invalid (a computed /
-     * string-literal segment, a string-named module, `declare global`, or an
-     * unrooted class expression / object literal). */
     containerSegments(node) {
         const segments = [];
         let current = node.getParent();
@@ -1108,10 +1006,6 @@ class AstParserService {
         }
         return segments;
     }
-    /** If `node` is a declaration this service indexes (top-level symbol, member,
-     * or collected class), its own name + container. Otherwise null. Shared by
-     * member extraction, ownership ranges and the call graph so all three name a
-     * declaration identically. */
     describeIndexedNode(node) {
         if (ts_morph_1.Node.isClassDeclaration(node)) {
             const name = node.getName() ?? (node.isDefaultExport() ? 'default' : null);
@@ -1204,9 +1098,6 @@ class AstParserService {
     qualifiedName(described) {
         return described.container.length ? `${described.container.join('.')}.${described.name}` : described.name;
     }
-    /** The qualified name of the nearest ancestor of `node` that is itself an
-     * indexed declaration (method, accessor, constructor, function property,
-     * namespace/top-level function, or module-/namespace-level variable). */
     findFromSymbol(node) {
         let current = node.getParent();
         while (current) {
@@ -1217,7 +1108,6 @@ class AstParserService {
         }
         return null;
     }
-    // ── private: call graph extraction ────────────────────────────────────────
     extractCalls(sourceFile, filePath, serviceName) {
         const calls = [];
         for (const callExpr of sourceFile.getDescendantsOfKind(ts_morph_1.SyntaxKind.CallExpression)) {
@@ -1240,7 +1130,6 @@ class AstParserService {
                     calleeName = expr.getText();
                     const sym = expr.getSymbol();
                     if (sym) {
-                        // Imported identifiers resolve to ImportSpecifier (same file); follow the alias.
                         const firstDecl = sym.getDeclarations()?.[0];
                         const resolved = firstDecl && ts_morph_1.Node.isImportSpecifier(firstDecl)
                             ? (sym.getAliasedSymbol() ?? sym)
@@ -1255,7 +1144,6 @@ class AstParserService {
                 }
             }
             catch {
-                // type resolution failures are normal — skip this call
             }
             if (!calleeName || !calleeFile)
                 continue;

package/dist/src/services/DatabaseService.d.ts

@@ -13,17 +13,13 @@ export declare class DatabaseService implements IDatabase {
     constructor(config: Config);
     get orm(): DrizzleDb;
     query<T = any>(sql: string, params?: any[]): Promise<T>;
+    queryWithLocalSettings<T = any>(settings: Record<string, string | number>, sql: string, params?: any[]): Promise<T>;
+    pgvectorVersion(): Promise<string | null>;
     transaction<T>(fn: (tx: DrizzleTx) => Promise<T>): Promise<T>;
     destroy(): Promise<void>;
     initDb(): Promise<void>;
     initDbWithSchema(): Promise<void>;
-    /**
-     * Create `code_chunk` at `dimensions` if it does not exist, plus its HNSW and
-     * (serviceName, filePath) indexes and the additive `contentHash`/`ownerPath`
-     * columns for pre-existing tables. Idempotent — safe to call repeatedly.
-     */
     ensureChunkTable(dimensions: number): Promise<void>;
-    /** Drop and recreate `code_chunk` at `dimensions` — used on a dimension change. */
     recreateChunkTable(dimensions: number): Promise<void>;
     readIndexMeta(): Promise<IndexMeta | null>;
     writeIndexMeta(meta: IndexMeta): Promise<void>;
@@ -31,7 +27,6 @@ export declare class DatabaseService implements IDatabase {
     deleteFiles(project: string, filePaths: string[]): Promise<void>;
     listIndexedProjects(): Promise<string[]>;
     deleteProject(name: string): Promise<void>;
-    /** Guard against SQL injection — the dimension is interpolated into DDL. */
     private assertDim;
     private assertMinPostgresVersion;
     private ensureDatabaseExists;