npm - autosnippet - Versions diffs - 3.2.7 → 3.2.8 - Mend

autosnippet 3.2.7 → 3.2.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (60) hide show

package/bin/cli.js +7 -0
package/dashboard/dist/assets/index-D5jiDBQG.css +1 -0
package/dashboard/dist/assets/{index-DfHY_3ln.js → index-e5OKj-Ni.js} +38 -38
package/dashboard/dist/index.html +2 -2
package/lib/cli/AiScanService.js +3 -3
package/lib/core/AstAnalyzer.js +26 -4
package/lib/core/analysis/CallEdgeResolver.js +402 -0
package/lib/core/analysis/CallGraphAnalyzer.js +367 -0
package/lib/core/analysis/CallSiteExtractor.js +629 -0
package/lib/core/analysis/DataFlowInferrer.js +57 -0
package/lib/core/analysis/ImportPathResolver.js +189 -0
package/lib/core/analysis/ImportRecord.js +105 -0
package/lib/core/analysis/SymbolTableBuilder.js +211 -0
package/lib/core/ast/ProjectGraph.js +8 -0
package/lib/core/ast/lang-dart.js +352 -5
package/lib/core/ast/lang-go.js +212 -10
package/lib/core/ast/lang-java.js +205 -1
package/lib/core/ast/lang-kotlin.js +330 -1
package/lib/core/ast/lang-python.js +31 -2
package/lib/core/ast/lang-rust.js +284 -3
package/lib/core/ast/lang-swift.js +180 -1
package/lib/core/ast/lang-typescript.js +290 -1
package/lib/external/mcp/McpServer.js +1 -0
package/lib/external/mcp/handlers/bootstrap/MissionBriefingBuilder.js +21 -0
package/lib/external/mcp/handlers/bootstrap/pipeline/EpisodicMemory.js +5 -4
package/lib/external/mcp/handlers/bootstrap/pipeline/dimension-configs.js +2 -1
package/lib/external/mcp/handlers/bootstrap/pipeline/orchestrator.js +70 -4
package/lib/external/mcp/handlers/bootstrap/shared/bootstrap-phases.js +95 -1
package/lib/external/mcp/handlers/bootstrap-external.js +9 -2
package/lib/external/mcp/handlers/bootstrap-internal.js +17 -6
package/lib/external/mcp/handlers/consolidated.js +9 -0
package/lib/external/mcp/handlers/guard.js +3 -3
package/lib/external/mcp/handlers/structure.js +62 -0
package/lib/external/mcp/handlers/wiki-external.js +66 -3
package/lib/external/mcp/tools.js +36 -1
package/lib/http/routes/remote.js +15 -15
package/lib/injection/ServiceContainer.js +6 -11
package/lib/platform/ios/index.js +2 -2
package/lib/platform/ios/spm/PackageSwiftParser.js +14 -3
package/lib/platform/ios/spm/SpmDiscoverer.js +123 -17
package/lib/platform/ios/spm/{SpmService.js → SpmHelper.js} +43 -675
package/lib/platform/ios/xcode/XcodeWriteUtils.js +1 -1
package/lib/service/chat/ChatAgent.js +1 -1
package/lib/service/chat/ChatAgentPrompts.js +13 -1
package/lib/service/chat/ExplorationTracker.js +52 -8
package/lib/service/chat/HandoffProtocol.js +19 -1
package/lib/service/chat/WorkingMemory.js +3 -1
package/lib/service/chat/memory/ActiveContext.js +3 -1
package/lib/service/chat/memory/SessionStore.js +4 -3
package/lib/service/chat/tools/ast-graph.js +229 -32
package/lib/service/chat/tools/index.js +6 -1
package/lib/service/chat/tools/infrastructure.js +5 -0
package/lib/service/cursor/CursorDeliveryPipeline.js +167 -1
package/lib/service/knowledge/CodeEntityGraph.js +327 -2
package/lib/service/knowledge/KnowledgeService.js +5 -1
package/lib/service/module/ModuleService.js +9 -0
package/lib/service/wiki/WikiGenerator.js +1 -1
package/lib/shared/PathGuard.js +1 -1
package/package.json +1 -1
package/dashboard/dist/assets/index-BaGY7kJI.css +0 -1

package/dashboard/dist/index.html CHANGED Viewed

@@ -5,13 +5,13 @@
     <link rel="icon" type="image/svg+xml" href="/vite.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>AutoSnippet Dashboard</title>
-    <script type="module" crossorigin src="/assets/index-DfHY_3ln.js"></script>
+    <script type="module" crossorigin src="/assets/index-e5OKj-Ni.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/yaml-qRaU8Ldn.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-Ck-HBmg5.js">
     <link rel="modulepreload" crossorigin href="/assets/axios-C0Zqfgkc.js">
     <link rel="modulepreload" crossorigin href="/assets/icons-pSac4wYO.js">
     <link rel="modulepreload" crossorigin href="/assets/framer-motion-DOATyqla.js">
-    <link rel="stylesheet" crossorigin href="/assets/index-BaGY7kJI.css">
+    <link rel="stylesheet" crossorigin href="/assets/index-D5jiDBQG.css">
   </head>
   <body>
     <div id="root"></div>

package/lib/cli/AiScanService.js CHANGED Viewed

@@ -145,14 +145,14 @@ export class AiScanService {
     const files = [];
     try {
-      // 优先使用 ModuleService（多语言统一入口），回退到 SpmService
+      // 优先使用 ModuleService（多语言统一入口），回退到 SpmHelper
       let service;
       try {
         const { ModuleService } = await import('../service/module/ModuleService.js');
         service = new ModuleService(this.projectRoot);
       } catch {
-        const { SpmService } = await import('../platform/ios/spm/SpmService.js');
-        service = new SpmService(this.projectRoot);
+        const { SpmHelper } = await import('../platform/ios/spm/SpmHelper.js');
+        service = new SpmHelper(this.projectRoot);
       }
       await service.load();

package/lib/core/AstAnalyzer.js CHANGED Viewed

@@ -14,6 +14,7 @@
  */
 import { getParserClass, isParserReady } from './ast/parser-init.js';
+import { getCallSiteExtractor, defaultExtractCallSites } from './analysis/CallSiteExtractor.js';
 // ──────────────────────────────────────────────────────────────────
 // 插件注册表
@@ -49,9 +50,11 @@ export function registerLanguage(langId, plugin) {
  * 分析单个源文件，返回结构化 AST 摘要
  * @param {string} source  源代码文本
  * @param {string} lang    语言标识 'objectivec' | 'swift' | 'typescript' | 'javascript' | 'python' | 'java' | 'kotlin' | 'go' | 'dart' | 'rust' | 'tsx'
+ * @param {object} [options]
+ * @param {boolean} [options.extractCallSites=true] — 是否提取调用点 (Phase 5)
  * @returns {AstSummary | null}
  */
-function analyzeFile(source, lang) {
+function analyzeFile(source, lang, options = {}) {
   const plugin = _langPlugins.get(lang);
   if (!plugin) {
     return null; // 无插件 → 优雅降级
@@ -74,10 +77,23 @@ function analyzeFile(source, lang) {
     patterns: [],
     imports: [],
     exports: [],
+    // ─── Phase 5 新增 ───
+    callSites: [],
+    references: [],
   };
   plugin.walk(root, ctx);
+  // Phase 5: 可选的 call site 提取 pass (post-walk extraction)
+  if (options.extractCallSites !== false) {
+    const extractor = plugin.extractCallSites || getCallSiteExtractor(lang) || defaultExtractCallSites;
+    try {
+      extractor(root, ctx, lang);
+    } catch (_e) {
+      // Call site extraction failure is non-fatal — degrade gracefully
+    }
+  }
   // 构建继承图谱
   const inheritanceGraph = _buildInheritanceGraph(ctx.classes, ctx.protocols, ctx.categories);
@@ -100,6 +116,8 @@ function analyzeFile(source, lang) {
     patterns: ctx.patterns,
     imports: ctx.imports,
     exports: ctx.exports,
+    callSites: ctx.callSites,
+    references: ctx.references,
     inheritanceGraph,
     metrics,
   };
@@ -433,14 +451,18 @@ function _buildInheritanceGraph(classes, protocols, categories) {
   }
   for (const cat of categories) {
+    // 兼容 ObjC category (className/categoryName) 和 Dart extension (name/targetClass)
+    const catClassName = cat.className || cat.targetClass;
+    const catCategoryName = cat.categoryName || cat.name;
+    if (!catClassName) continue; // 跳过无法确定目标类的 category
     edges.push({
-      from: `${cat.className}(${cat.categoryName})`,
-      to: cat.className,
+      from: `${catClassName}(${catCategoryName})`,
+      to: catClassName,
       type: 'extends',
     });
     if (cat.protocols) {
       for (const proto of cat.protocols) {
-        edges.push({ from: cat.className, to: proto, type: 'conforms' });
+        edges.push({ from: catClassName, to: proto, type: 'conforms' });
       }
     }
   }

package/lib/core/analysis/CallEdgeResolver.js ADDED Viewed

@@ -0,0 +1,402 @@
+/**
+ * @module CallEdgeResolver
+ * @description Phase 5: 将调用点 (CallSite) 解析为调用边 (ResolvedEdge)
+ *
+ * 解析优先级 (4-priority system):
+ *   1. this.xxx() — 同类方法调用
+ *   2. ImportedType.method() / importedFunc() — import-based 解析
+ *   3. localFunc() — 同文件内函数调用
+ *   4. globalSearch(name) — 全局唯一匹配 (fallback, 低置信度)
+ *
+ * 数据流:
+ *   SymbolTable + ImportPathResolver + CallSite[] → ResolvedEdge[]
+ */
+/**
+ * @typedef {object} ResolvedEdge
+ * @property {string} caller — 调用者 FQN e.g. "src/service/UserService.ts::UserService.getUser"
+ * @property {string} callee — 被调用者 FQN e.g. "src/repository/UserRepo.ts::UserRepo.findById"
+ * @property {string} callType — 'function'|'method'|'constructor'|'super'|'static'
+ * @property {string} resolveMethod — 'direct'|'inferred'|'cha'
+ * @property {number} line — 调用点行号
+ * @property {string} file — 调用者文件
+ * @property {boolean} isAwait
+ */
+export class CallEdgeResolver {
+  /**
+   * @param {import('./SymbolTableBuilder.js').SymbolTable} symbolTable
+   * @param {import('./ImportPathResolver.js').ImportPathResolver} importResolver
+   * @param {Array<{from: string, to: string, type: string}>} [inheritanceGraph=[]] — 继承图边
+   */
+  constructor(symbolTable, importResolver, inheritanceGraph = []) {
+    this.symbolTable = symbolTable;
+    this.importResolver = importResolver;
+    this.inheritanceGraph = inheritanceGraph;
+    // Phase 5.3: RTA — set of classes that are actually instantiated in the program
+    this.instantiatedClasses = symbolTable.instantiatedClasses || new Set();
+    // Phase 5.3: DI — property type annotations: className → (fieldName → typeName)
+    this.propertyTypes = symbolTable.propertyTypes || new Map();
+    // 构建反向索引: symbolName → [fqn1, fqn2, ...]
+    /** @type {Map<string, string[]>} */
+    this.nameIndex = new Map();
+    // 构建文件级索引: file → [{ name, qualifiedName, fqn }] (Issue #14 性能优化)
+    /** @type {Map<string, Array<{name: string, qualifiedName: string, fqn: string}>>} */
+    this.fileIndex = new Map();
+    // Phase 5.3: 类名集合索引 (用于 _inferFieldType 优化，避免全表扫描)
+    /** @type {Set<string>} */
+    this.classNames = new Set();
+    for (const [fqn, decl] of symbolTable.declarations) {
+      const names = [decl.name];
+      const qualifiedName = decl.className ? `${decl.className}.${decl.name}` : decl.name;
+      if (decl.className) {
+        names.push(qualifiedName);
+      }
+      for (const name of names) {
+        if (!this.nameIndex.has(name)) this.nameIndex.set(name, []);
+        this.nameIndex.get(name).push(fqn);
+      }
+      // 文件级索引
+      if (!this.fileIndex.has(decl.file)) this.fileIndex.set(decl.file, []);
+      this.fileIndex.get(decl.file).push({ name: decl.name, qualifiedName, fqn });
+      // Phase 5.3: 收集类名用于快速 DI 推断
+      if (decl.kind === 'class') {
+        this.classNames.add(decl.name);
+      }
+    }
+  }
+  /**
+   * 解析一个文件中的所有调用点为边
+   *
+   * @param {import('./CallSiteExtractor.js').CallSite[]} callSites — 来自某个文件的所有调用点
+   * @param {string} callerFile — 调用者文件路径 (相对)
+   * @returns {ResolvedEdge[]}
+   */
+  resolveFile(callSites, callerFile) {
+    const edges = [];
+    const fileImports = this.symbolTable.fileImports.get(callerFile) || [];
+    // 构建局部 import 映射: symbolName → { file, namespace }
+    const importedSymbols = this._buildImportMap(fileImports, callerFile);
+    // 去重集合: "caller→callee@line" 防止同一调用点产生重复边
+    const seen = new Set();
+    for (const cs of callSites) {
+      const resolved = this._resolveCallSite(cs, callerFile, importedSymbols);
+      if (resolved) {
+        const key = `${resolved.caller}→${resolved.callee}@${resolved.line}`;
+        if (!seen.has(key)) {
+          seen.add(key);
+          edges.push(resolved);
+        }
+      }
+    }
+    return edges;
+  }
+  /**
+   * @private 构建局部 import 映射
+   */
+  _buildImportMap(fileImports, callerFile) {
+    /** @type {Map<string, { file: string, namespace: boolean }>} */
+    const importedSymbols = new Map();
+    for (const imp of fileImports) {
+      const targetFile = this.importResolver.resolve(imp.path || String(imp), callerFile);
+      if (!targetFile) continue; // 外部依赖, 跳过
+      if (imp.symbols && imp.symbols.length > 0) {
+        for (const sym of imp.symbols) {
+          if (sym === '*' && imp.alias) {
+            importedSymbols.set(imp.alias, { file: targetFile, namespace: true });
+          } else if (sym !== '*') {
+            // named/default: symbols 已包含本地名 (alias baked-in), 直接使用
+            importedSymbols.set(sym, { file: targetFile, namespace: false });
+          }
+        }
+      } else {
+        // 无结构化信息时，使用路径最后一段作为 namespace hint
+        const pathParts = String(imp).split('/');
+        const lastPart = pathParts[pathParts.length - 1]?.replace(/\.\w+$/, '');
+        if (lastPart) {
+          importedSymbols.set(lastPart, { file: targetFile, namespace: true });
+        }
+      }
+    }
+    return importedSymbols;
+  }
+  /**
+   * @private 解析单个调用点
+   */
+  _resolveCallSite(cs, callerFile, importedSymbols) {
+    const callerFqn = `${callerFile}::${cs.callerClass ? `${cs.callerClass}.` : ''}${cs.callerMethod}`;
+    // Priority 0: super.xxx() — 父类方法调用 (CHA 解析，禁止 fallthrough 防止自引用边)
+    if (cs.callType === 'super' || cs.receiver === 'super' || cs.receiver === 'super()') {
+      if (cs.callerClass && cs.callee && cs.callee !== 'super') {
+        const chaResult = this._resolveByCHA(cs.callee, cs.callerClass);
+        if (chaResult) {
+          return this._makeEdge(callerFqn, chaResult, 'cha', cs, callerFile);
+        }
+      }
+      // CHA 无法解析时不 fallthrough (避免 local search 匹配到自己产生 self-edge)
+      return null;
+    }
+    // Priority 1: this.xxx() / self.xxx() — 同类方法调用
+    if (cs.receiver === 'this' || cs.receiver === 'self') {
+      if (cs.callerClass) {
+        const candidates = this._findInFile(`${cs.callerClass}.${cs.callee}`, callerFile);
+        if (candidates.length > 0) {
+          return this._makeEdge(callerFqn, candidates[0], 'direct', cs, callerFile);
+        }
+        // CHA fallback: 在继承链上查找方法
+        const chaResult = this._resolveByCHA(cs.callee, cs.callerClass);
+        if (chaResult) {
+          return this._makeEdge(callerFqn, chaResult, 'cha', cs, callerFile);
+        }
+      }
+    }
+    // Priority 1.5: this.field.method() — DI 注入字段方法调用
+    if (cs.receiver && (cs.receiver.startsWith('this.') || cs.receiver.startsWith('self.'))) {
+      const fieldName = cs.receiver.split('.').slice(1).join('.');
+      // Phase 5.3: First try explicit type annotation from property declarations (DI-aware)
+      if (cs.callerClass) {
+        const classProps = this.propertyTypes.get(cs.callerClass);
+        if (classProps) {
+          const fieldType = classProps.get(fieldName);
+          if (fieldType) {
+            const typeCandidates = this.nameIndex.get(`${fieldType}.${cs.callee}`) || [];
+            if (typeCandidates.length > 0) {
+              return this._makeEdge(callerFqn, typeCandidates[0], 'direct', cs, callerFile);
+            }
+          }
+        }
+      }
+      // 尝试从 receiverType 解析 (可能 extractCallSites 已推断)
+      if (cs.receiverType) {
+        const typeCandidates = this.nameIndex.get(`${cs.receiverType}.${cs.callee}`) || [];
+        if (typeCandidates.length > 0) {
+          return this._makeEdge(callerFqn, typeCandidates[0], 'direct', cs, callerFile);
+        }
+      }
+      // 尝试通过命名约定推断: userRepo → UserRepo, userService → UserService
+      const inferredType = this._inferFieldType(fieldName);
+      if (inferredType) {
+        const typeCandidates = this.nameIndex.get(`${inferredType}.${cs.callee}`) || [];
+        if (typeCandidates.length > 0) {
+          return this._makeEdge(callerFqn, typeCandidates[0], 'inferred', cs, callerFile);
+        }
+      }
+    }
+    // Priority 2: Import-based 解析
+    const importInfo = importedSymbols.get(cs.receiver || cs.callee);
+    if (importInfo) {
+      const targetFile = importInfo.file;
+      if (importInfo.namespace && cs.receiver) {
+        // namespace import: M.foo() → 在 targetFile 中查找 foo
+        const candidates = this._findInFile(cs.callee, targetFile);
+        if (candidates.length > 0) {
+          return this._makeEdge(callerFqn, candidates[0], 'direct', cs, callerFile);
+        }
+      } else {
+        // named import: 查找 import 的符号
+        const lookupName = cs.receiver
+          ? `${cs.receiver}.${cs.callee}`
+          : cs.callee;
+        let candidates = this._findInFile(lookupName, targetFile);
+        if (candidates.length === 0 && cs.receiver) {
+          // 可能 import 的是类名，方法是类的方法
+          candidates = this._findInFile(`${cs.receiver}.${cs.callee}`, targetFile);
+        }
+        if (candidates.length === 0 && !cs.receiver) {
+          // 可能是函数名
+          candidates = this._findInFile(cs.callee, targetFile);
+        }
+        if (candidates.length > 0) {
+          return this._makeEdge(callerFqn, candidates[0], 'direct', cs, callerFile);
+        }
+      }
+    }
+    // Priority 2.5: Implicit this — OOP 语言中 bare method() 即 this.method()
+    // 在 Dart/Java/Kotlin/Swift 等语言中, 类内调用 method() 等价于 this.method()
+    // 先查同类方法, 再 CHA 查父类方法
+    if (!cs.receiver && cs.callerClass && cs.callType !== 'constructor') {
+      // 2.5a: 同类方法 (精确匹配 Class.method)
+      const implicitThisCandidates = this._findInFile(
+        `${cs.callerClass}.${cs.callee}`, callerFile,
+      ).filter(fqn => fqn !== callerFqn);
+      if (implicitThisCandidates.length > 0) {
+        return this._makeEdge(callerFqn, implicitThisCandidates[0], 'direct', cs, callerFile);
+      }
+      // 2.5b: CHA 查父类 (继承链上的方法)
+      const chaImplicit = this._resolveByCHA(cs.callee, cs.callerClass);
+      if (chaImplicit) {
+        return this._makeEdge(callerFqn, chaImplicit, 'cha', cs, callerFile);
+      }
+    }
+    // Priority 3: 同文件内的函数调用
+    // 过滤 callerFqn 防止同名方法重载(overload)产生假自引用边
+    const localCandidates = this._findInFile(cs.callee, callerFile)
+      .filter(fqn => fqn !== callerFqn);
+    if (localCandidates.length > 0) {
+      return this._makeEdge(callerFqn, localCandidates[0], 'direct', cs, callerFile);
+    }
+    // 也尝试 Class.method 格式
+    if (cs.receiver && !importedSymbols.has(cs.receiver)) {
+      const qualifiedLocal = this._findInFile(`${cs.receiver}.${cs.callee}`, callerFile)
+        .filter(fqn => fqn !== callerFqn);
+      if (qualifiedLocal.length > 0) {
+        return this._makeEdge(callerFqn, qualifiedLocal[0], 'direct', cs, callerFile);
+      }
+    }
+    // Priority 4: 全局搜索 (唯一匹配才采用)
+    // 过滤 callerFqn 防止全局唯一命名碰撞自己
+    const globalCandidates = (this.nameIndex.get(cs.callee) || [])
+      .filter(fqn => fqn !== callerFqn);
+    if (globalCandidates.length === 1) {
+      return this._makeEdge(callerFqn, globalCandidates[0], 'inferred', cs, callerFile);
+    }
+    // Phase 5.3 RTA: 多个全局候选 → 用实例化集合过滤
+    if (globalCandidates.length > 1 && this.instantiatedClasses.size > 0) {
+      const rtaFiltered = globalCandidates.filter((fqn) => {
+        if (fqn === callerFqn) return false; // 排除自己
+        const decl = this.symbolTable.declarations.get(fqn);
+        if (!decl) return false;
+        // 非类方法 (顶层函数) 不做 RTA 过滤
+        if (!decl.className) return true;
+        // 类方法 → 仅保留实际实例化的类
+        return this.instantiatedClasses.has(decl.className);
+      });
+      if (rtaFiltered.length === 1) {
+        return this._makeEdge(callerFqn, rtaFiltered[0], 'rta', cs, callerFile);
+      }
+    }
+    // 无法解析 → 不创建边 (宁缺勿滥)
+    return null;
+  }
+  /**
+   * @private CHA (Class Hierarchy Analysis): 沿继承链向上搜索方法
+   *
+   * 使用 BFS 遍历 inheritanceGraph，从 className 向上搜索直到找到
+   * 定义了 methodName 的祖先类。只跟踪 'inherits' 类型的边。
+   *
+   * @param {string} methodName — 被调用的方法名
+   * @param {string} className — 起始类名
+   * @returns {string|null} — 找到的 FQN 或 null
+   */
+  _resolveByCHA(methodName, className) {
+    if (!this.inheritanceGraph || this.inheritanceGraph.length === 0) return null;
+    // BFS 向上遍历继承链 (最多 10 层防止循环)
+    const visited = new Set([className]);
+    const queue = [className];
+    const MAX_DEPTH = 10;
+    let depth = 0;
+    while (queue.length > 0 && depth < MAX_DEPTH) {
+      depth++;
+      const nextQueue = [];
+      for (const current of queue) {
+        // 查找 current 的所有父类 (inherits 和 conforms 类型的边)
+        for (const edge of this.inheritanceGraph) {
+          if (edge.from === current && !visited.has(edge.to)) {
+            visited.add(edge.to);
+            // 在全局符号表中查找 ParentClass.methodName
+            const qualifiedName = `${edge.to}.${methodName}`;
+            const candidates = this.nameIndex.get(qualifiedName) || [];
+            if (candidates.length > 0) {
+              return candidates[0];
+            }
+            nextQueue.push(edge.to);
+          }
+        }
+      }
+      queue.length = 0;
+      queue.push(...nextQueue);
+    }
+    return null;
+  }
+  /**
+   * @private 从字段名推断类型（DI/IoC 命名约定推断）
+   *
+   * 常见模式:
+   *   - userRepo → UserRepo
+   *   - userRepository → UserRepository
+   *   - userService → UserService
+   *   - _userRepo → UserRepo (Java/Kotlin private field)
+   *
+   * 只在符号表中存在匹配类时返回
+   *
+   * @param {string} fieldName
+   * @returns {string|null}
+   */
+  _inferFieldType(fieldName) {
+    // 去除前导下划线
+    const cleaned = fieldName.replace(/^_+/, '');
+    if (!cleaned) return null;
+    // camelCase → PascalCase
+    const pascalCase = cleaned.charAt(0).toUpperCase() + cleaned.slice(1);
+    // Phase 5.3: 使用 classNames Set 快速查找 (O(1) 替代 O(n) 全表扫描)
+    return this.classNames.has(pascalCase) ? pascalCase : null;
+  }
+  /**
+   * @private 在指定文件中查找声明 (使用 fileIndex 优化，避免全表扫描)
+   * @param {string} name — 符号名 (可以是 "ClassName.methodName" 或 "functionName")
+   * @param {string} file
+   * @returns {string[]} 匹配的 FQN 列表
+   */
+  _findInFile(name, file) {
+    const fileDecls = this.fileIndex.get(file);
+    if (!fileDecls) return [];
+    return fileDecls
+      .filter((d) => d.name === name || d.qualifiedName === name)
+      .map((d) => d.fqn);
+  }
+  /**
+   * @private 构建 ResolvedEdge
+   */
+  _makeEdge(callerFqn, calleeFqn, resolveMethod, cs, callerFile) {
+    return {
+      caller: callerFqn,
+      callee: calleeFqn,
+      callType: cs.callType,
+      resolveMethod,
+      line: cs.line,
+      file: callerFile,
+      isAwait: cs.isAwait,
+      argCount: cs.argCount || 0,
+    };
+  }
+}
+export default CallEdgeResolver;