spectra-cli 4.1.1 → 4.3.0

package/dist/core/import-resolver.d.ts

@@ -0,0 +1,93 @@
+/**
+ * import 路径解析结果。
+ * resolvedPath 为相对 projectRoot 的 POSIX 路径；external/unresolved 时为 null。
+ * 当 projectRoot 为空字符串（独立 AST 调用）时，resolvedPath 为绝对路径（调用方自行归一）。
+ */
+export interface ResolveResult {
+    /** 解析后的目标文件路径（相对 projectRoot 的 POSIX 相对路径；projectRoot 空时为绝对路径）。 */
+    resolvedPath: string | null;
+    kind: 'module' | 'package-init' | 'relative-sibling' | 'relative' | 'paths-alias' | 'absolute' | 'external' | 'unresolved';
+}
+/**
+ * TypeScript/JavaScript tsconfig.json 解析上下文。
+ * 由 findNearestTsConfig + buildTsConfigContext 协作生成。
+ */
+export interface TsConfigResolutionContext {
+    /** tsconfig.json 所在目录的绝对路径 */
+    configDir: string;
+    /**
+     * baseUrl 配置（经 ts.parseJsonConfigFileContent 解析，通常为绝对路径）。
+     * 用户未配置 baseUrl → null（跳过 baseUrl 解析）。
+     * 注：alias 算法用 path.resolve(configDir, baseUrl, replacement)，绝对 baseUrl 会正确覆盖 configDir。
+     */
+    baseUrl: string | null;
+    /** paths 映射（含 wildcard），key/value 保留原始 tsconfig 相对字符串 */
+    paths: Map<string, string[]>;
+}
+/** 将路径转换为 POSIX 格式（确保跨平台 resolvedPath 始终用 '/' 分隔符）。 */
+export declare function toPosix(p: string): string;
+/**
+ * 判断 candidate 路径是否严格在 projectRoot 子树内（C-5 + N-2）。
+ *
+ * 用 path.relative 逐 component 检查第一段是否为 '..'，避免字典序误判（/proj vs /projection）。
+ * candidate === projectRoot 返回 false（projectRoot 自身不算"在子树内"）。
+ */
+export declare function isInsideProjectRoot(candidate: string, projectRoot: string): boolean;
+/**
+ * 判断路径是否指向非源文件目标（W-1）。
+ * .json 和 .d.ts 文件不进入 callSites graph，返回 external。
+ */
+export declare function isNonSourceTarget(p: string): boolean;
+/**
+ * 解析 TypeScript/JavaScript import 路径（单一权威实现，Feature 181）。
+ *
+ * 解析顺序：
+ *   1. node: 内置 → external
+ *   2. 磁盘绝对路径（'/' 前缀）→ 文件候选 + projectRoot 守卫
+ *   3. 相对路径（'./' '../'）→ 文件候选 + projectRoot 守卫；.json/.d.ts → external
+ *   4. 非相对：tsconfig paths alias（最长前缀 + 多候选 + baseUrl 叠加）→ baseUrl 解析 → external/unresolved
+ *
+ * 守卫策略（逐分支复刻历史 kg）：relative / disk-absolute 分支启用 isInsideProjectRoot
+ * （仅 projectRoot 为真时）；paths-alias / baseUrl 分支不加守卫（保持 alias 语义）。
+ *
+ * @param moduleSpec      - import 说明符（如 './engine'、'~/utils'、'express'）
+ * @param callerFile      - 调用方文件的绝对路径
+ * @param projectRoot     - 项目根目录绝对路径（空字符串：返回绝对路径 + 跳过守卫）
+ * @param tsConfigContext - tsconfig 解析上下文（null/undefined：仅走相对/绝对路径）
+ * @returns ResolveResult（失败返回 { resolvedPath: null, kind: 'unresolved' }，不抛异常）
+ */
+export declare function resolveTsJsImport(moduleSpec: string, callerFile: string, projectRoot: string, tsConfigContext?: TsConfigResolutionContext | null): ResolveResult;
+/**
+ * AST 消费方便捷封装：解析并归一为**绝对路径**。
+ *
+ * ast-analyzer / tree-sitter-analyzer / tree-sitter-fallback 三处历史上把
+ * resolvedPath 以绝对路径写入 CodeSkeleton.imports[]（module-derivation.normalizeSkeletonPaths
+ * 期望绝对输入再相对化；collect EC-10 亦绝对）。本封装保持该形态：
+ *   - projectRoot 为真：把权威 resolver 的相对 POSIX 结果 path.resolve 回绝对
+ *   - projectRoot 为空：权威 resolver 已返回绝对路径，原样返回
+ * external/unresolved（resolvedPath=null）统一返回 null（与历史 core string|null 语义一致）。
+ */
+export declare function resolveTsJsImportToAbsolute(moduleSpec: string, callerFile: string, projectRoot: string, tsConfigContext?: TsConfigResolutionContext | null): string | null;
+/**
+ * 从 filePath 向上查找最近的 tsconfig.json（monorepo-aware）。
+ *
+ * 上溯范围：从 path.dirname(filePath) 向上，直到 projectRoot 边界（含 projectRoot 本身）。
+ * 越过 projectRoot 停止，不抛异常。
+ *
+ * @returns tsconfig.json 的绝对路径；未找到返回 null
+ */
+export declare function findNearestTsConfig(filePath: string, projectRoot: string): string | null;
+/**
+ * 解析 tsconfig.json 为 TsConfigResolutionContext（单一 loader，ts API 处理 extends 链）。
+ *
+ * 用 ts.readConfigFile + ts.parseJsonConfigFileContent：
+ *   - 自动处理 extends 链（优于历史 kg 手写 JSON.parse 的 YAGNI 无 extends）
+ *   - baseUrl 解析为绝对路径（alias 算法 path.resolve 正确覆盖 configDir）
+ *   - paths 保留原始相对字符串（由 alias 算法做唯一一次 resolve，避免双重 resolve）
+ *
+ * 失败时返回 null（不抛异常，按未配置 alias 处理）。
+ *
+ * @param configPath - tsconfig.json 的绝对路径（由 findNearestTsConfig / 调用方提供）
+ */
+export declare function buildTsConfigContext(configPath: string): TsConfigResolutionContext | null;
+//# sourceMappingURL=import-resolver.d.ts.map

package/dist/core/import-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-resolver.d.ts","sourceRoot":"","sources":["../../src/core/import-resolver.ts"],"names":[],"mappings":"AAiDA;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EACA,QAAQ,GACR,cAAc,GACd,kBAAkB,GAClB,UAAU,GACV,aAAa,GACb,UAAU,GACV,UAAU,GACV,YAAY,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,yDAAyD;IACzD,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC9B;AA8BD,uDAAuD;AACvD,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAOnF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAEpD;AA6ED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,yBAAyB,GAAG,IAAI,GACjD,aAAa,CAgFf;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,yBAAyB,GAAG,IAAI,GACjD,MAAM,GAAG,IAAI,CAMf;AAuED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBxF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,yBAAyB,GAAG,IAAI,CAmCzF"}

package/dist/core/import-resolver.js

@@ -0,0 +1,414 @@
+/**
+ * import-resolver.ts — TS/JS import specifier 单一权威解析（Feature 181 收口）
+ *
+ * 背景（Feature 181 单一权威收口）：
+ *   历史上 `core/import-resolver.ts` 与 `knowledge-graph/import-resolver.ts` 各有一份
+ *   `resolveTsJsImport`，行为分叉（core 返回绝对路径无 projectRoot 守卫 + ESM ext map；
+ *   kg 返回相对 POSIX + kind + isInsideProjectRoot 守卫）。两者经 AST 路径
+ *   （ast-analyzer / tree-sitter-*）与 batch 路径（collect / module-derivation）都进 graph.json。
+ *   本模块收口为唯一权威实现，合并两侧能力：
+ *     - 相对解析：ESM ext map（`./foo.js`→`foo.ts`）+ 直接命中 + .mjs/.cjs（源自 core）
+ *     - alias/baseUrl：tsconfig paths（最长前缀 + 多候选 + baseUrl 叠加，TS 官方语义）
+ *     - projectRoot 边界守卫（防图污染，源自 kg；relative / disk-absolute 分支启用）
+ *     - kind 分类 + external/unresolved 区分 + .json/.d.ts → external
+ *
+ * 设计约束：
+ *   - 纯 node:fs / node:path（+ typescript 仅用于 tsconfig 解析，含 extends 链）
+ *   - 不抛异常（无法解析返回 { resolvedPath: null, kind: 'unresolved' }）
+ *   - 跨平台：resolvedPath 输出统一为相对 projectRoot 的 POSIX 路径；
+ *     projectRoot 为空（独立 AST 调用）时返回绝对路径且跳过守卫（保持历史 core 行为）
+ *
+ * 注：Python import 解析（resolvePythonImport）不在本次收口范围，仍在
+ *   knowledge-graph/import-resolver.ts；其依赖的 ResolveResult / toPosix / isInsideProjectRoot
+ *   由本模块导出供其下行 import（knowledge-graph → core，层级方向干净）。
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+// 复用 ts-morph 再导出的 typescript 命名空间（避免新增对 'typescript' 的直接运行时依赖；
+// ts-morph 已是本仓运行时依赖）
+import { ts } from 'ts-morph';
+import { createLogger } from '../panoramic/utils/logger.js';
+// F183 修复 2：buildTsConfigContext 失败时不再静默——warn 出 configPath + error 摘要。
+const logger = createLogger('import-resolver');
+// 仅缓存已 warn 的 configPath 做 emission 限频（monorepo 同一损坏 tsconfig 会被每个
+// import-resolve 循环触发，造成日志洪泛）。注意：仅限频 warn，绝不跳过解析——
+// buildTsConfigContext 始终尝试解析，失败仍 return null。
+const warnedConfigPaths = new Set();
+/** 同一 configPath 仅发一次 warn（emission 限频，不影响解析）。 */
+function warnTsConfigFailureOnce(configPath, errorSummary) {
+    if (warnedConfigPaths.has(configPath))
+        return;
+    logger.warn(`[import-resolver] buildTsConfigContext 失败（${configPath}）：${errorSummary}`);
+    warnedConfigPaths.add(configPath);
+}
+// ───────────────────────────────────────────────────────────
+// 常量
+// ───────────────────────────────────────────────────────────
+/** TS/JS 候补扩展名顺序（含 .mjs/.cjs，源自历史 core 实现） */
+const TS_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'];
+/** index 文件名顺序 */
+const TS_INDEX_FILES = ['index.ts', 'index.tsx', 'index.js', 'index.jsx'];
+/** alias-like 前缀列表（C-2）：以这些前缀开头的 moduleSpec 无 paths 命中时返回 unresolved */
+const ALIAS_PREFIXES = ['~/', '#/', '$/'];
+/**
+ * TypeScript ESM 惯例：`import './foo.js'` 实际指向 `./foo.ts`（Feature 156 CRIT-1）。
+ * specifier 以 JS 扩展名结尾时，先尝试对应 TS 扩展名候选；命中即返回，否则 fallback 标准解析。
+ */
+const ESM_TS_EXT_MAP = {
+    '.js': ['.ts', '.tsx'],
+    '.jsx': ['.tsx'],
+    '.mjs': ['.mts'],
+    '.cjs': ['.cts'],
+};
+// ───────────────────────────────────────────────────────────
+// 共享辅助（导出供 knowledge-graph Python resolver 下行复用）
+// ───────────────────────────────────────────────────────────
+/** 将路径转换为 POSIX 格式（确保跨平台 resolvedPath 始终用 '/' 分隔符）。 */
+export function toPosix(p) {
+    return p.split(path.sep).join('/');
+}
+/**
+ * 判断 candidate 路径是否严格在 projectRoot 子树内（C-5 + N-2）。
+ *
+ * 用 path.relative 逐 component 检查第一段是否为 '..'，避免字典序误判（/proj vs /projection）。
+ * candidate === projectRoot 返回 false（projectRoot 自身不算"在子树内"）。
+ */
+export function isInsideProjectRoot(candidate, projectRoot) {
+    const rel = path.relative(projectRoot, candidate);
+    if (rel.length === 0)
+        return false; // candidate === projectRoot
+    if (path.isAbsolute(rel))
+        return false; // 跨盘符（Windows）
+    const firstSeg = rel.split(path.sep)[0];
+    if (firstSeg === '..')
+        return false;
+    return true;
+}
+/**
+ * 判断路径是否指向非源文件目标（W-1）。
+ * .json 和 .d.ts 文件不进入 callSites graph，返回 external。
+ */
+export function isNonSourceTarget(p) {
+    return p.endsWith('.json') || p.endsWith('.d.ts');
+}
+// ───────────────────────────────────────────────────────────
+// 内部：文件候选尝试（合并 core ESM ext map + 直接命中 + 扩展名 + index）
+// ───────────────────────────────────────────────────────────
+function existsAndIsFile(p) {
+    try {
+        return fs.statSync(p).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function existsAndIsDir(p) {
+    try {
+        return fs.statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 给定 base 路径，依次尝试（顺序严格复刻历史 core，护 graph.json byte-identical）：
+ *   1. ESM TS ext map（若 base 以 JS 扩展名结尾，先试 .ts/.tsx 等 TS 候选）
+ *   2. base 直接命中（已含扩展名）
+ *   3. base + 扩展名（.ts → .cjs）
+ *   4. base/index.{ts,tsx,js,jsx}
+ * @returns 命中的绝对路径；否则 null
+ */
+function tryFilePathVariants(base) {
+    // 1. ESM TS ext map（如 foo.js → foo.ts）
+    const sourceExt = path.extname(base);
+    const tsCandidatesExts = ESM_TS_EXT_MAP[sourceExt];
+    if (tsCandidatesExts) {
+        const baseWithoutExt = base.slice(0, -sourceExt.length);
+        for (const tsExt of tsCandidatesExts) {
+            const tsCandidate = baseWithoutExt + tsExt;
+            if (existsAndIsFile(tsCandidate))
+                return tsCandidate;
+        }
+    }
+    // 2. 直接命中
+    if (existsAndIsFile(base))
+        return base;
+    // 3. 扩展名补全
+    for (const ext of TS_EXTENSIONS) {
+        const candidate = base + ext;
+        if (existsAndIsFile(candidate))
+            return candidate;
+    }
+    // 4. 目录 + index 文件
+    if (existsAndIsDir(base)) {
+        for (const idxFile of TS_INDEX_FILES) {
+            const candidate = path.join(base, idxFile);
+            if (existsAndIsFile(candidate))
+                return candidate;
+        }
+    }
+    return null;
+}
+/**
+ * 把命中绝对路径归一为 ResolveResult。
+ * projectRoot 为真：相对 POSIX；projectRoot 为空：保留绝对路径（历史 core 独立调用行为）。
+ */
+function makeHit(absHit, projectRoot, kind) {
+    return {
+        resolvedPath: projectRoot ? toPosix(path.relative(projectRoot, absHit)) : absHit,
+        kind,
+    };
+}
+// ───────────────────────────────────────────────────────────
+// Public API — resolveTsJsImport（单一权威）
+// ───────────────────────────────────────────────────────────
+/**
+ * 解析 TypeScript/JavaScript import 路径（单一权威实现，Feature 181）。
+ *
+ * 解析顺序：
+ *   1. node: 内置 → external
+ *   2. 磁盘绝对路径（'/' 前缀）→ 文件候选 + projectRoot 守卫
+ *   3. 相对路径（'./' '../'）→ 文件候选 + projectRoot 守卫；.json/.d.ts → external
+ *   4. 非相对：tsconfig paths alias（最长前缀 + 多候选 + baseUrl 叠加）→ baseUrl 解析 → external/unresolved
+ *
+ * 守卫策略（逐分支复刻历史 kg）：relative / disk-absolute 分支启用 isInsideProjectRoot
+ * （仅 projectRoot 为真时）；paths-alias / baseUrl 分支不加守卫（保持 alias 语义）。
+ *
+ * @param moduleSpec      - import 说明符（如 './engine'、'~/utils'、'express'）
+ * @param callerFile      - 调用方文件的绝对路径
+ * @param projectRoot     - 项目根目录绝对路径（空字符串：返回绝对路径 + 跳过守卫）
+ * @param tsConfigContext - tsconfig 解析上下文（null/undefined：仅走相对/绝对路径）
+ * @returns ResolveResult（失败返回 { resolvedPath: null, kind: 'unresolved' }，不抛异常）
+ */
+export function resolveTsJsImport(moduleSpec, callerFile, projectRoot, tsConfigContext) {
+    if (!moduleSpec || typeof moduleSpec !== 'string') {
+        return { resolvedPath: null, kind: 'unresolved' };
+    }
+    // 1. node 内置模块 → external（不解析外部依赖）
+    if (moduleSpec.startsWith('node:')) {
+        return { resolvedPath: null, kind: 'external' };
+    }
+    // 2. 磁盘绝对路径（罕见）
+    if (moduleSpec.startsWith('/')) {
+        const hit = tryFilePathVariants(moduleSpec);
+        if (hit) {
+            // 守卫：候选必须在 projectRoot 内（仅 projectRoot 为真时启用）
+            if (projectRoot && !isInsideProjectRoot(hit, projectRoot)) {
+                return { resolvedPath: null, kind: 'unresolved' };
+            }
+            return makeHit(hit, projectRoot, 'absolute');
+        }
+        return { resolvedPath: null, kind: 'unresolved' };
+    }
+    // 3. 相对路径（./ 或 ../）
+    if (moduleSpec.startsWith('./') || moduleSpec.startsWith('../') || moduleSpec.startsWith('.')) {
+        // W-1：moduleSpec 自身已带 .json / .d.ts 后缀 → external
+        if (isNonSourceTarget(moduleSpec)) {
+            return { resolvedPath: null, kind: 'external' };
+        }
+        const base = path.resolve(path.dirname(callerFile), moduleSpec);
+        const hit = tryFilePathVariants(base);
+        if (hit) {
+            if (projectRoot && !isInsideProjectRoot(hit, projectRoot)) {
+                return { resolvedPath: null, kind: 'unresolved' };
+            }
+            // 命中 .json / .d.ts（如 base 无扩展名却命中同名 .d.ts）双保险 external
+            if (isNonSourceTarget(hit)) {
+                return { resolvedPath: null, kind: 'external' };
+            }
+            return makeHit(hit, projectRoot, 'relative');
+        }
+        // 候补失败但 base 本身指向 .json / .d.ts → external
+        if (isNonSourceTarget(base)) {
+            return { resolvedPath: null, kind: 'external' };
+        }
+        return { resolvedPath: null, kind: 'unresolved' };
+    }
+    // 4. 非相对路径：先 paths alias，再 baseUrl，再判定 external/unresolved
+    if (tsConfigContext) {
+        const aliasHit = resolvePathsAlias(moduleSpec, projectRoot, tsConfigContext);
+        if (aliasHit)
+            return aliasHit;
+        // baseUrl 解析（baseUrl 为字符串时）
+        if (typeof tsConfigContext.baseUrl === 'string') {
+            const absBase = path.resolve(tsConfigContext.configDir, tsConfigContext.baseUrl, moduleSpec);
+            const hit = tryFilePathVariants(absBase);
+            if (hit) {
+                return makeHit(hit, projectRoot, 'absolute');
+            }
+        }
+    }
+    // C-2：区分 alias-like（unresolved）与 bare npm package（external）
+    if (ALIAS_PREFIXES.some((p) => moduleSpec.startsWith(p)) || moduleSpec.startsWith('@/')) {
+        return { resolvedPath: null, kind: 'unresolved' };
+    }
+    // 合法 npm 包判定
+    const firstSeg = moduleSpec.split('/')[0] ?? '';
+    if (firstSeg.startsWith('@')) {
+        // scoped 包形如 @org/lib
+        return { resolvedPath: null, kind: 'external' };
+    }
+    if (/^[a-z0-9][a-z0-9-_.]*$/.test(firstSeg)) {
+        return { resolvedPath: null, kind: 'external' };
+    }
+    // 含 '/' 但首段不是合法 npm 包名 → alias-like 配置缺失
+    return { resolvedPath: null, kind: 'unresolved' };
+}
+/**
+ * AST 消费方便捷封装：解析并归一为**绝对路径**。
+ *
+ * ast-analyzer / tree-sitter-analyzer / tree-sitter-fallback 三处历史上把
+ * resolvedPath 以绝对路径写入 CodeSkeleton.imports[]（module-derivation.normalizeSkeletonPaths
+ * 期望绝对输入再相对化；collect EC-10 亦绝对）。本封装保持该形态：
+ *   - projectRoot 为真：把权威 resolver 的相对 POSIX 结果 path.resolve 回绝对
+ *   - projectRoot 为空：权威 resolver 已返回绝对路径，原样返回
+ * external/unresolved（resolvedPath=null）统一返回 null（与历史 core string|null 语义一致）。
+ */
+export function resolveTsJsImportToAbsolute(moduleSpec, callerFile, projectRoot, tsConfigContext) {
+    const r = resolveTsJsImport(moduleSpec, callerFile, projectRoot, tsConfigContext);
+    if (!r.resolvedPath)
+        return null;
+    return path.isAbsolute(r.resolvedPath)
+        ? r.resolvedPath
+        : path.resolve(projectRoot, r.resolvedPath);
+}
+/**
+ * tsconfig paths alias 解析（最长前缀 + 多候选 + baseUrl 叠加，TS 官方语义）。
+ *
+ * 合并历史两侧：
+ *   - 最长前缀匹配（core：`@app/utils/*` 优先于 `@app/*`；精确 key 因 prefixLen 最长天然居首）
+ *   - 多候选数组逐个尝试（core + kg）
+ *   - replacement 叠加 baseUrl：path.resolve(configDir, baseUrl ?? '.', replacement)（kg C-3）
+ *   - 文件候选用统一 tryFilePathVariants（含 ESM ext map / .mjs.cjs / index）
+ *
+ * @returns 命中的 ResolveResult（kind='paths-alias'）；未命中返回 null
+ */
+function resolvePathsAlias(moduleSpec, projectRoot, ctx) {
+    // 收集所有命中 alias，排序规则（TS 官方语义）：
+    //   1. 最长前缀优先（`@app/utils/*` 胜过 `@app/*`）
+    //   2. 同前缀长度时精确 key（无 wildcard）优先于 wildcard（`react` 胜过 `react*`）
+    const matched = [];
+    for (const [pattern, replacements] of ctx.paths) {
+        const tail = matchPathsPattern(moduleSpec, pattern);
+        if (tail === null)
+            continue;
+        const isWildcard = pattern.includes('*');
+        const prefixLen = isWildcard ? pattern.indexOf('*') : pattern.length;
+        matched.push({ prefixLen, isWildcard, tail, replacements });
+    }
+    if (matched.length === 0)
+        return null;
+    matched.sort((a, b) => {
+        if (b.prefixLen !== a.prefixLen)
+            return b.prefixLen - a.prefixLen;
+        return (a.isWildcard ? 1 : 0) - (b.isWildcard ? 1 : 0); // 同前缀长度：exact 优先
+    });
+    const baseUrl = typeof ctx.baseUrl === 'string' ? ctx.baseUrl : '.';
+    for (const m of matched) {
+        for (const replacement of m.replacements) {
+            const resolved = replacement.includes('*') ? replacement.replace('*', m.tail) : replacement;
+            const absBase = path.resolve(ctx.configDir, baseUrl, resolved);
+            const hit = tryFilePathVariants(absBase);
+            if (hit) {
+                return makeHit(hit, projectRoot, 'paths-alias');
+            }
+        }
+    }
+    return null;
+}
+/**
+ * 匹配 tsconfig paths pattern（精确 key + wildcard）。
+ * @returns null（不匹配），或 wildcard 截取的尾缀（精确 key 时为 ''）
+ */
+function matchPathsPattern(moduleSpec, pattern) {
+    if (pattern.includes('*')) {
+        const starIdx = pattern.indexOf('*');
+        const prefix = pattern.slice(0, starIdx);
+        const suffix = pattern.slice(starIdx + 1);
+        if (moduleSpec.startsWith(prefix) && moduleSpec.endsWith(suffix) &&
+            moduleSpec.length >= prefix.length + suffix.length) {
+            return moduleSpec.slice(prefix.length, moduleSpec.length - suffix.length);
+        }
+        return null;
+    }
+    return moduleSpec === pattern ? '' : null;
+}
+// ───────────────────────────────────────────────────────────
+// Public API — tsconfig loader（单一实现：ts.parseJsonConfigFileContent，含 extends 链）
+// ───────────────────────────────────────────────────────────
+/**
+ * 从 filePath 向上查找最近的 tsconfig.json（monorepo-aware）。
+ *
+ * 上溯范围：从 path.dirname(filePath) 向上，直到 projectRoot 边界（含 projectRoot 本身）。
+ * 越过 projectRoot 停止，不抛异常。
+ *
+ * @returns tsconfig.json 的绝对路径；未找到返回 null
+ */
+export function findNearestTsConfig(filePath, projectRoot) {
+    let dir = path.dirname(filePath);
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+        // 边界检查先于 fs 操作（C-3：避免越界路径误读）
+        if (dir !== projectRoot && !isInsideProjectRoot(dir, projectRoot)) {
+            break;
+        }
+        const candidate = path.join(dir, 'tsconfig.json');
+        if (fs.existsSync(candidate)) {
+            return candidate;
+        }
+        if (dir === projectRoot)
+            break;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break; // 文件系统根
+        dir = parent;
+    }
+    return null;
+}
+/**
+ * 解析 tsconfig.json 为 TsConfigResolutionContext（单一 loader，ts API 处理 extends 链）。
+ *
+ * 用 ts.readConfigFile + ts.parseJsonConfigFileContent：
+ *   - 自动处理 extends 链（优于历史 kg 手写 JSON.parse 的 YAGNI 无 extends）
+ *   - baseUrl 解析为绝对路径（alias 算法 path.resolve 正确覆盖 configDir）
+ *   - paths 保留原始相对字符串（由 alias 算法做唯一一次 resolve，避免双重 resolve）
+ *
+ * 失败时返回 null（不抛异常，按未配置 alias 处理）。
+ *
+ * @param configPath - tsconfig.json 的绝对路径（由 findNearestTsConfig / 调用方提供）
+ */
+export function buildTsConfigContext(configPath) {
+    try {
+        const configFile = ts.readConfigFile(configPath, ts.sys.readFile);
+        if (configFile.error || !configFile.config) {
+            // 解析失败仍 return null（行为不变），但不再静默——首次为该 configPath 发一次 warn
+            const errorSummary = configFile.error
+                ? ts.flattenDiagnosticMessageText(configFile.error.messageText, ' ')
+                : 'config 为空';
+            warnTsConfigFailureOnce(configPath, errorSummary);
+            return null;
+        }
+        const configDir = path.dirname(configPath);
+        const parsed = ts.parseJsonConfigFileContent(configFile.config, ts.sys, configDir);
+        const compilerOptions = parsed.options;
+        const baseUrl = typeof compilerOptions.baseUrl === 'string' ? compilerOptions.baseUrl : null;
+        const paths = new Map();
+        if (compilerOptions.paths) {
+            for (const [key, value] of Object.entries(compilerOptions.paths)) {
+                if (Array.isArray(value)) {
+                    const strs = value.filter((s) => typeof s === 'string');
+                    if (strs.length > 0)
+                        paths.set(key, strs);
+                }
+            }
+        }
+        return { configDir, baseUrl, paths };
+    }
+    catch (err) {
+        // 解析抛错仍 return null（行为不变），但不再静默——首次为该 configPath 发一次 warn
+        const errorSummary = err instanceof Error ? err.message : String(err);
+        warnTsConfigFailureOnce(configPath, errorSummary);
+        return null;
+    }
+}
+//# sourceMappingURL=import-resolver.js.map

package/dist/core/import-resolver.js.map

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

package/dist/core/query-mappers/base-mapper.d.ts

@@ -3,9 +3,12 @@
  */
 import type Parser from 'web-tree-sitter';
 import type { ExportSymbol, ImportReference, ParseError, Language } from '../../models/code-skeleton.js';
+import type { CallSite } from '../../models/call-site.js';
 export interface MapperOptions {
     /** 包含私有/非导出符号 */
     includePrivate?: boolean;
+    /** 抽取函数调用点（Feature 151，默认 false；仅 panoramic 流水线显式传 true） */
+    extractCallSites?: boolean;
 }
 export interface QueryMapper {
     /** 映射器对应的语言 */
@@ -18,5 +21,15 @@ export interface QueryMapper {
     extractParseErrors(tree: Parser.Tree): ParseError[];
     /** 提取模块级文档注释（可选，仅支持此概念的语言实现，如 Python） */
     extractModuleDoc?(tree: Parser.Tree): string | null;
+    /**
+     * 抽取函数调用点（Feature 151，可选；仅 PythonMapper 在 P1 阶段实现）。
+     *
+     * 实现要求：
+     * - 遍历 call / attribute / binary_operator / unary_operator / decorated_definition 等 AST 节点
+     * - 与 truth-set extractor (scripts/lib/python-call-extractor.py) 行为对齐（CL-04）
+     * - dynamic call (getattr / eval / 字符串拼接 attribute) 直接 skip 不输出（EC-12）
+     * - bare decorator (@staticmethod / @property) 不记录（CL-04）
+     */
+    extractCallSites?(tree: Parser.Tree, source: string): CallSite[];
 }
 //# sourceMappingURL=base-mapper.d.ts.map

package/dist/core/query-mappers/base-mapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-mapper.d.ts","sourceRoot":"","sources":["../../../src/core/query-mappers/base-mapper.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAEzG,MAAM,WAAW,aAAa;IAC5B,iBAAiB;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,eAAe;IACf,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B,wBAAwB;IACxB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,EAAE,CAAC;IAE3F,wBAAwB;IACxB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE,CAAC;IAErE,wBAAwB;IACxB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,GAAG,UAAU,EAAE,CAAC;IAEpD,yCAAyC;IACzC,gBAAgB,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;CACrD"}
+{"version":3,"file":"base-mapper.d.ts","sourceRoot":"","sources":["../../../src/core/query-mappers/base-mapper.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,MAAM,WAAW,aAAa;IAC5B,iBAAiB;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,eAAe;IACf,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B,wBAAwB;IACxB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,EAAE,CAAC;IAE3F,wBAAwB;IACxB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE,CAAC;IAErE,wBAAwB;IACxB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,GAAG,UAAU,EAAE,CAAC;IAEpD,yCAAyC;IACzC,gBAAgB,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IAEpD;;;;;;;;OAQG;IACH,gBAAgB,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE,CAAC;CAClE"}

package/dist/core/query-mappers/go-mapper.d.ts

@@ -4,6 +4,7 @@
  */
 import type Parser from 'web-tree-sitter';
 import type { ExportSymbol, ImportReference, ParseError, Language } from '../../models/code-skeleton.js';
+import type { CallSite } from '../../models/call-site.js';
 import type { QueryMapper, MapperOptions } from './base-mapper.js';
 export declare class GoMapper implements QueryMapper {
     readonly language: Language;
@@ -42,5 +43,72 @@ export declare class GoMapper implements QueryMapper {
     private _extractImportSpec;
     /** 递归收集 AST 中的 ERROR 节点 */
     private _collectErrors;
+    /**
+     * 抽取 Go 函数调用点。
+     *
+     * 行为对齐：
+     * - scripts/lib/go-call-extractor.mjs 的 _classifyCallExpression / _scanImports / _resolveGoCaller
+     * - call-resolver 4-stage 决策表（spec.md FR-2 表格 11 行 short-circuit）
+     *
+     * Size guard：source.length > 1MB 时返回 []（与 PythonMapper.extractCallSites 一致）。
+     */
+    extractCallSites(tree: Parser.Tree, source: string): CallSite[];
+    /**
+     * FR-5: 扫描 source_file → import_declaration → import_spec 收集 alias 集合。
+     *
+     * 与 go-call-extractor.mjs `_scanImports` 行为完全一致：
+     * - 自定义 alias `import f "fmt"` → 记 alias `f`
+     * - 标准 import `import "fmt"` → 记 path 末段 `fmt`
+     * - dot import (name=dot) / blank import (name=blank_identifier) → skip（不入集合）
+     */
+    private _scanImports;
+    /** FR-5 辅助：从 import_spec 提取 alias 名（dot/blank 返回 null）。 */
+    private _extractAliasFromImportSpec;
+    /**
+     * FR-7: 从 method_declaration 的 receiver 字段递归提取 type 名。
+     *
+     * 支持形态：值 receiver / 指针 / 嵌套指针 / 泛型 / 泛型指针 / qualified type，
+     * 与 go-call-extractor.mjs `_extractReceiverTypeName` + `_extractTypeNameRecursive` 行为一致。
+     */
+    private _extractReceiverTypeName;
+    /** 递归从 type 节点中提取末段 type_identifier 名（值 type / pointer / generic / qualified）。 */
+    private _extractTypeNameRecursive;
+    /** FR-7: 从 method_declaration receiver 提取 var name（identifier 子节点；可能为 null）。 */
+    private _extractReceiverVarName;
+    /**
+     * FR-1, FR-7: 递归遍历 AST，对 call_expression 产 CallSite。
+     *
+     * 栈协议（try/finally 配对）：
+     * - 进入 method_declaration → push `Type.method` + receiver var
+     * - 进入 function_declaration → push `funcName` + null
+     * - 进入 func_literal → push `<closure:line:col>` + null
+     * - 离开时 pop（finally 块保证）
+     */
+    private _walkCallSites;
+    /**
+     * FR-1, FR-2 (11 行分类表), FR-6: 处理单个 call_expression 节点。
+     *
+     * 路由顺序按 spec.md FR-2 表格行 #1 → #11 short-circuit 匹配，先匹配的形态先返回。
+     */
+    private _handleCall;
+    /**
+     * FR-2 行 #3, #4: 解开 parenthesized_expression 的 callee。
+     *
+     * 实测形态（与 go-call-extractor.mjs `_classifyCallExpression` 行 1.6 节段一致）：
+     * - `(T)(nil)` → parenthesized(identifier "T") → free + "T"
+     * - `(*T)(nil)` → parenthesized(unary_expression("*", identifier "T")) → free + "T"
+     * - `(*pkg.T)(nil)` → parenthesized(unary_expression("*", selector(pkg, T))) → cross-module + "T" + qualifier "pkg"
+     */
+    private _classifyParenthesized;
+    /**
+     * FR-6: phantom call 检测。
+     *
+     * - funcNode 缺失 / hasError → phantom（skip 抽取）
+     * - sibling 含 ERROR/MISSING → phantom
+     * children 仍由 _walkCallSites 递归 walk（不会因 phantom skip 整个子树）。
+     */
+    private _isPhantomCall;
+    /** 构造单个 CallSite 记录。 */
+    private _mkCallSite;
 }
 //# sourceMappingURL=go-mapper.d.ts.map