spectra-cli 4.1.1

package/dist/adapters/language-adapter-registry.d.ts

@@ -0,0 +1,56 @@
+import type { LanguageAdapter } from './language-adapter.js';
+export declare class LanguageAdapterRegistry {
+    /** 单例实例 */
+    private static instance;
+    /** 扩展名 → 适配器映射（key 为小写扩展名，如 '.ts'） */
+    private extensionMap;
+    /** 已注册适配器有序列表 */
+    private adapterList;
+    private constructor();
+    /**
+     * 获取或创建 Registry 单例
+     */
+    static getInstance(): LanguageAdapterRegistry;
+    /**
+     * 重置单例（仅限测试使用）
+     * 重置后下次 getInstance() 返回新的空白实例。
+     */
+    static resetInstance(): void;
+    /**
+     * 注册语言适配器
+     *
+     * 将适配器声明的所有扩展名映射到该实例。
+     * 如果某个扩展名已被另一个适配器注册，抛出 Error。
+     *
+     * @param adapter - LanguageAdapter 实例
+     * @throws Error 扩展名冲突时
+     */
+    register(adapter: LanguageAdapter): void;
+    /**
+     * 根据文件路径查找对应的语言适配器
+     *
+     * 提取文件扩展名（path.extname），转为小写后在 Map 中查找。
+     *
+     * @param filePath - 文件路径（绝对或相对均可）
+     * @returns 匹配的适配器实例，无匹配时返回 null
+     */
+    getAdapter(filePath: string): LanguageAdapter | null;
+    /**
+     * 获取当前所有已注册的文件扩展名
+     */
+    getSupportedExtensions(): Set<string>;
+    /**
+     * 聚合所有已注册适配器的默认忽略目录
+     */
+    getDefaultIgnoreDirs(): Set<string>;
+    /**
+     * 检查 Registry 是否为空（无任何已注册适配器）
+     * 用于区分"Registry 未初始化"和"文件类型不支持"两种错误场景。
+     */
+    isEmpty(): boolean;
+    /**
+     * 获取所有已注册适配器列表（按注册顺序）
+     */
+    getAllAdapters(): readonly LanguageAdapter[];
+}
+//# sourceMappingURL=language-adapter-registry.d.ts.map

package/dist/adapters/language-adapter-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-adapter-registry.d.ts","sourceRoot":"","sources":["../../src/adapters/language-adapter-registry.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,qBAAa,uBAAuB;IAClC,WAAW;IACX,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAwC;IAE/D,sCAAsC;IACtC,OAAO,CAAC,YAAY,CAA+B;IAEnD,iBAAiB;IACjB,OAAO,CAAC,WAAW,CAAoB;IAEvC,OAAO;IAKP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,uBAAuB;IAO7C;;;OAGG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAqBxC;;;;;;;OAOG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAKpD;;OAEG;IACH,sBAAsB,IAAI,GAAG,CAAC,MAAM,CAAC;IAIrC;;OAEG;IACH,oBAAoB,IAAI,GAAG,CAAC,MAAM,CAAC;IAUnC;;;OAGG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,cAAc,IAAI,SAAS,eAAe,EAAE;CAG7C"}

package/dist/adapters/language-adapter-registry.js

@@ -0,0 +1,110 @@
+/**
+ * 语言适配器注册中心（单例）
+ *
+ * 职责：
+ * - 维护文件扩展名到 LanguageAdapter 的映射（Map<string, LanguageAdapter>）
+ * - 提供按文件路径查找适配器的能力（O(1) 查找）
+ * - 聚合所有已注册适配器的元信息（支持的扩展名、忽略目录）
+ * - 检测扩展名冲突（同一扩展名不允许被多个适配器注册）
+ *
+ * 生命周期：进程级单例，CLI 和 MCP 入口各自在启动时完成注册。
+ */
+import * as path from 'node:path';
+export class LanguageAdapterRegistry {
+    /** 单例实例 */
+    static instance = null;
+    /** 扩展名 → 适配器映射（key 为小写扩展名，如 '.ts'） */
+    extensionMap;
+    /** 已注册适配器有序列表 */
+    adapterList;
+    constructor() {
+        this.extensionMap = new Map();
+        this.adapterList = [];
+    }
+    /**
+     * 获取或创建 Registry 单例
+     */
+    static getInstance() {
+        if (!LanguageAdapterRegistry.instance) {
+            LanguageAdapterRegistry.instance = new LanguageAdapterRegistry();
+        }
+        return LanguageAdapterRegistry.instance;
+    }
+    /**
+     * 重置单例（仅限测试使用）
+     * 重置后下次 getInstance() 返回新的空白实例。
+     */
+    static resetInstance() {
+        LanguageAdapterRegistry.instance = null;
+    }
+    /**
+     * 注册语言适配器
+     *
+     * 将适配器声明的所有扩展名映射到该实例。
+     * 如果某个扩展名已被另一个适配器注册，抛出 Error。
+     *
+     * @param adapter - LanguageAdapter 实例
+     * @throws Error 扩展名冲突时
+     */
+    register(adapter) {
+        // 先检查所有扩展名是否冲突，避免部分注册
+        for (const ext of adapter.extensions) {
+            const normalizedExt = ext.toLowerCase();
+            const existing = this.extensionMap.get(normalizedExt);
+            if (existing) {
+                throw new Error(`扩展名冲突: '${normalizedExt}' 已被适配器 '${existing.id}' 注册，` +
+                    `无法再注册到 '${adapter.id}'`);
+            }
+        }
+        // 无冲突，执行注册
+        for (const ext of adapter.extensions) {
+            const normalizedExt = ext.toLowerCase();
+            this.extensionMap.set(normalizedExt, adapter);
+        }
+        this.adapterList.push(adapter);
+    }
+    /**
+     * 根据文件路径查找对应的语言适配器
+     *
+     * 提取文件扩展名（path.extname），转为小写后在 Map 中查找。
+     *
+     * @param filePath - 文件路径（绝对或相对均可）
+     * @returns 匹配的适配器实例，无匹配时返回 null
+     */
+    getAdapter(filePath) {
+        const ext = path.extname(filePath).toLowerCase();
+        return this.extensionMap.get(ext) ?? null;
+    }
+    /**
+     * 获取当前所有已注册的文件扩展名
+     */
+    getSupportedExtensions() {
+        return new Set(this.extensionMap.keys());
+    }
+    /**
+     * 聚合所有已注册适配器的默认忽略目录
+     */
+    getDefaultIgnoreDirs() {
+        const dirs = new Set();
+        for (const adapter of this.adapterList) {
+            for (const dir of adapter.defaultIgnoreDirs) {
+                dirs.add(dir);
+            }
+        }
+        return dirs;
+    }
+    /**
+     * 检查 Registry 是否为空（无任何已注册适配器）
+     * 用于区分"Registry 未初始化"和"文件类型不支持"两种错误场景。
+     */
+    isEmpty() {
+        return this.adapterList.length === 0;
+    }
+    /**
+     * 获取所有已注册适配器列表（按注册顺序）
+     */
+    getAllAdapters() {
+        return [...this.adapterList];
+    }
+}
+//# sourceMappingURL=language-adapter-registry.js.map

package/dist/adapters/language-adapter-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-adapter-registry.js","sourceRoot":"","sources":["../../src/adapters/language-adapter-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,MAAM,OAAO,uBAAuB;IAClC,WAAW;IACH,MAAM,CAAC,QAAQ,GAAmC,IAAI,CAAC;IAE/D,sCAAsC;IAC9B,YAAY,CAA+B;IAEnD,iBAAiB;IACT,WAAW,CAAoB;IAEvC;QACE,IAAI,CAAC,YAAY,GAAG,IAAI,GAAG,EAAE,CAAC;QAC9B,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,uBAAuB,CAAC,QAAQ,EAAE,CAAC;YACtC,uBAAuB,CAAC,QAAQ,GAAG,IAAI,uBAAuB,EAAE,CAAC;QACnE,CAAC;QACD,OAAO,uBAAuB,CAAC,QAAQ,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,aAAa;QAClB,uBAAuB,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC1C,CAAC;IAED;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAwB;QAC/B,sBAAsB;QACtB,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACrC,MAAM,aAAa,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;YACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YACtD,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CACb,WAAW,aAAa,YAAY,QAAQ,CAAC,EAAE,OAAO;oBACtD,WAAW,OAAO,CAAC,EAAE,GAAG,CACzB,CAAC;YACJ,CAAC;QACH,CAAC;QAED,WAAW;QACX,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACrC,MAAM,aAAa,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;YACxC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED;;;;;;;OAOG;IACH,UAAU,CAAC,QAAgB;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,sBAAsB;QACpB,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,oBAAoB;QAClB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACvC,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;gBAC5C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC"}

package/dist/adapters/language-adapter.d.ts

@@ -0,0 +1,127 @@
+/**
+ * 语言适配器接口定义
+ * 定义一种编程语言支持所需的全部能力契约：文件分析、降级分析、
+ * 依赖图构建（可选）、术语映射、测试文件模式。
+ */
+import type { CodeSkeleton, Language } from '../models/code-skeleton.js';
+import type { DependencyGraph } from '../models/dependency-graph.js';
+import type { CommentRegion } from '../debt-scanner/types.js';
+export type { CommentRegion };
+/**
+ * 文件分析选项
+ */
+export interface AnalyzeFileOptions {
+    /** 包含非导出符号（默认 false） */
+    includePrivate?: boolean;
+    /** 类继承层级最大解析深度（默认 5） */
+    maxDepth?: number;
+}
+/**
+ * 依赖图构建选项
+ */
+export interface DependencyGraphOptions {
+    /** 用于过滤分析文件的 Glob 模式 */
+    includeOnly?: string;
+    /** 排除模式 */
+    excludePatterns?: string[];
+    /** 语言特定配置文件路径（如 tsconfig.json） */
+    configPath?: string;
+}
+/**
+ * 语言特定术语映射
+ * 每种语言对"导出"、"导入"等概念有不同的表达方式。
+ * 此类型允许 LLM prompt 使用与目标语言一致的术语。
+ */
+export interface LanguageTerminology {
+    /** 代码块语言标记（如 'typescript', 'python', 'go'） */
+    codeBlockLanguage: string;
+    /** "导出"概念的描述 */
+    exportConcept: string;
+    /** "导入"概念的描述 */
+    importConcept: string;
+    /** 类型系统描述 */
+    typeSystemDescription: string;
+    /** 接口/协议概念 */
+    interfaceConcept: string;
+    /** 模块系统描述 */
+    moduleSystem: string;
+}
+/**
+ * 测试文件匹配模式
+ * 用于 secret-redactor 和 noise-filter 识别测试文件。
+ */
+export interface TestPatterns {
+    /** 测试文件名正则 */
+    filePattern: RegExp;
+    /** 测试目录名集合 */
+    testDirs: readonly string[];
+}
+/**
+ * 语言适配器接口
+ * 定义一种编程语言支持所需的全部能力：文件分析、降级分析、
+ * 依赖图构建（可选）、术语映射、测试文件模式。
+ */
+export interface LanguageAdapter {
+    /** 适配器唯一标识（如 'ts-js', 'python', 'go'） */
+    readonly id: string;
+    /** 支持的语言列表（对应 CodeSkeleton.language 值） */
+    readonly languages: readonly Language[];
+    /**
+     * 支持的文件扩展名集合（含前导点，小写）
+     * 例：Set(['.ts', '.tsx', '.js', '.jsx'])
+     */
+    readonly extensions: ReadonlySet<string>;
+    /**
+     * 默认忽略目录集合（语言生态特有，如 node_modules、__pycache__）
+     * 不包含通用忽略目录（如 .git），通用目录由 file-scanner 独立维护。
+     */
+    readonly defaultIgnoreDirs: ReadonlySet<string>;
+    /**
+     * AST 分析单个文件，返回结构化的 CodeSkeleton
+     *
+     * @param filePath - 源文件绝对路径
+     * @param options - 分析选项（可选）
+     * @returns CodeSkeleton
+     * @throws FileNotFoundError 文件不存在时
+     */
+    analyzeFile(filePath: string, options?: AnalyzeFileOptions): Promise<CodeSkeleton>;
+    /**
+     * 正则降级分析
+     * 当主分析器（如 ts-morph）不可用或解析失败时，提供基于正则的兜底分析。
+     *
+     * @param filePath - 源文件绝对路径
+     * @returns 部分填充的 CodeSkeleton，parserUsed 标记为降级解析器
+     */
+    analyzeFallback(filePath: string): Promise<CodeSkeleton>;
+    /**
+     * 构建项目级依赖图（可选能力）
+     * 并非所有语言在初始阶段都需要依赖图支持。
+     *
+     * @param projectRoot - 项目根目录
+     * @param options - 构建选项（可选）
+     * @returns DependencyGraph
+     */
+    buildDependencyGraph?(projectRoot: string, options?: DependencyGraphOptions): Promise<DependencyGraph>;
+    /**
+     * 返回该语言的术语映射
+     * 用于 LLM prompt 的语言参数化。
+     */
+    getTerminology(): LanguageTerminology;
+    /**
+     * 返回该语言的测试文件匹配模式
+     * 用于 secret-redactor 和 noise-filter 识别测试文件。
+     */
+    getTestPatterns(): TestPatterns;
+    /**
+     * 基于 AST 提取源文件中的所有注释 region（可选能力）。
+     * 用于 Feature 130 debt-scanner：识别 TODO/FIXME 等注释，
+     * 并且排除字符串字面量内的 "TODO" 字样，避免规则误判。
+     *
+     * 适配器如未实现该能力，debt-scanner 会跳过这些文件并在 diagnostics 中计数。
+     *
+     * @param filePath 源文件绝对路径
+     * @returns 该文件的所有注释 region（已去掉注释起始/结束标记）
+     */
+    extractComments?(filePath: string): Promise<CommentRegion[]>;
+}
+//# sourceMappingURL=language-adapter.d.ts.map

package/dist/adapters/language-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/language-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,YAAY,EAAE,aAAa,EAAE,CAAC;AAM9B;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wBAAwB;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa;IACb,qBAAqB,EAAE,MAAM,CAAC;IAC9B,cAAc;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,cAAc;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc;IACd,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAMD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IAExC;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAEzC;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAEhD;;;;;;;OAOG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEnF;;;;;;OAMG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzD;;;;;;;OAOG;IACH,oBAAoB,CAAC,CACnB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,eAAe,CAAC,CAAC;IAE5B;;;OAGG;IACH,cAAc,IAAI,mBAAmB,CAAC;IAEtC;;;OAGG;IACH,eAAe,IAAI,YAAY,CAAC;IAEhC;;;;;;;;;OASG;IACH,eAAe,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;CAC9D"}

package/dist/adapters/language-adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=language-adapter.js.map

package/dist/adapters/language-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-adapter.js","sourceRoot":"","sources":["../../src/adapters/language-adapter.ts"],"names":[],"mappings":""}

package/dist/adapters/python-adapter.d.ts

@@ -0,0 +1,61 @@
+import type { CodeSkeleton, Language } from '../models/code-skeleton.js';
+import type { ExtractionResult } from '../extraction/extraction-types.js';
+import type { LanguageAdapter, AnalyzeFileOptions, DependencyGraphOptions, LanguageTerminology, TestPatterns } from './language-adapter.js';
+import type { DependencyGraph } from '../models/dependency-graph.js';
+import type { CommentRegion } from '../debt-scanner/types.js';
+export declare class PythonLanguageAdapter implements LanguageAdapter {
+    readonly id = "python";
+    readonly languages: readonly Language[];
+    readonly extensions: ReadonlySet<string>;
+    readonly defaultIgnoreDirs: ReadonlySet<string>;
+    /**
+     * AST 分析（委托 TreeSitterAnalyzer）
+     */
+    analyzeFile(filePath: string, options?: AnalyzeFileOptions): Promise<CodeSkeleton>;
+    /**
+     * 正则降级分析（委托 tree-sitter-fallback.ts 的 analyzeFallback）
+     */
+    analyzeFallback(filePath: string): Promise<CodeSkeleton>;
+    /**
+     * Python 语言术语映射
+     */
+    getTerminology(): LanguageTerminology;
+    /**
+     * Python 测试文件匹配模式
+     */
+    getTestPatterns(): TestPatterns;
+    /**
+     * 基于 tree-sitter-python 的注释提取。
+     *
+     * Python AST 将 docstring 归类为 `string` 节点（位于 expression_statement 下），
+     * 而非 `comment` 节点；因此 docstring 天然被排除，只有真正的 `#` 行注释被收集。
+     */
+    extractComments(filePath: string): Promise<CommentRegion[]>;
+    /**
+     * 递归扫描项目根目录下所有 `.py` 文件，排除语言生态常见忽略目录。
+     *
+     * 复用 `defaultIgnoreDirs` 并叠加 Python 项目惯例（test/tests/dist 等）。
+     * 由 `extractSymbolNodes` 与 `buildDependencyGraph` 共用，避免 DRY 违反。
+     *
+     * @throws 当根目录不可读时抛出（调用方按需 try-catch 决定是否吞掉）
+     */
+    private scanPyFiles;
+    /**
+     * 提取 Python 项目所有 .py 文件的符号节点（函数/类），转换为 ExtractionResult 格式
+     *
+     * Feature 145 P0：桥接 Python AST（CodeSkeleton.exports）到知识图谱 ExtractionResult 第四路数据源。
+     * 每个 .py 文件产出一个 ExtractionResult，包含：
+     * - 文件级 module 节点（id = relPath, kind = 'module'）
+     * - 每个 export 符号的 component 节点（id = {relPath}#{name}, kind = 'component'）
+     * - module → component 的 containment 边（relation = 'contains'）
+     *
+     * NF-004：处理完每个文件后 skeleton 立即丢弃，不集中持有全量数据，避免内存压力。
+     */
+    extractSymbolNodes(projectRoot: string): Promise<ExtractionResult[]>;
+    /**
+     * 构建 Python 项目的模块依赖图
+     * 扫描所有 .py 文件，解析 import 语句，仅对本地模块构建有向边
+     */
+    buildDependencyGraph(projectRoot: string, _options?: DependencyGraphOptions): Promise<DependencyGraph>;
+}
+//# sourceMappingURL=python-adapter.d.ts.map

package/dist/adapters/python-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/python-adapter.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,YAAY,EACb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,eAAe,EAA6B,MAAM,+BAA+B,CAAC;AAIhG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,qBAAa,qBAAsB,YAAW,eAAe;IAC3D,QAAQ,CAAC,EAAE,YAAY;IAEvB,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAc;IAErD,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAA4B;IAEpE,QAAQ,CAAC,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAC,CAQ5C;IAEH;;OAEG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,YAAY,CAAC;IAOxB;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI9D;;OAEG;IACH,cAAc,IAAI,mBAAmB;IAWrC;;OAEG;IACH,eAAe,IAAI,YAAY;IAO/B;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAOjE;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;IAqBnB;;;;;;;;;;OAUG;IACG,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IA8E1E;;;OAGG;IACG,oBAAoB,CACxB,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,sBAAsB,GAChC,OAAO,CAAC,eAAe,CAAC;CA2E5B"}

package/dist/adapters/python-adapter.js

@@ -0,0 +1,260 @@
+/**
+ * Python 语言适配器
+ *
+ * 将 TreeSitterAnalyzer（AST 解析）和 tree-sitter-fallback（正则降级）
+ * 中的 Python 支持聚合为一个内聚的适配器实例。
+ *
+ * 实现策略：委托（delegation）——调用现有函数，不复制代码。
+ */
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import { TreeSitterAnalyzer } from '../core/tree-sitter-analyzer.js';
+import { analyzeFallback as treeSitterFallback } from '../core/tree-sitter-fallback.js';
+import { extractCommentsWithTreeSitter } from './tree-sitter-comment-extractor.js';
+export class PythonLanguageAdapter {
+    id = 'python';
+    languages = ['python'];
+    extensions = new Set(['.py', '.pyi']);
+    defaultIgnoreDirs = new Set([
+        '__pycache__',
+        '.venv',
+        'venv',
+        '.tox',
+        '.mypy_cache',
+        '.pytest_cache',
+        '.eggs',
+    ]);
+    /**
+     * AST 分析（委托 TreeSitterAnalyzer）
+     */
+    async analyzeFile(filePath, options) {
+        const analyzer = TreeSitterAnalyzer.getInstance();
+        return analyzer.analyze(filePath, 'python', {
+            includePrivate: options?.includePrivate,
+        });
+    }
+    /**
+     * 正则降级分析（委托 tree-sitter-fallback.ts 的 analyzeFallback）
+     */
+    async analyzeFallback(filePath) {
+        return treeSitterFallback(filePath);
+    }
+    /**
+     * Python 语言术语映射
+     */
+    getTerminology() {
+        return {
+            codeBlockLanguage: 'python',
+            exportConcept: '公开符号（模块级定义，非 _ 前缀，受 __all__ 控制）',
+            importConcept: 'import / from...import 导入',
+            typeSystemDescription: '可选类型注解（PEP 484 type hints）',
+            interfaceConcept: 'Protocol（PEP 544）/ ABC（Abstract Base Class）',
+            moduleSystem: 'Python package/module 系统（__init__.py + import）',
+        };
+    }
+    /**
+     * Python 测试文件匹配模式
+     */
+    getTestPatterns() {
+        return {
+            filePattern: /^(test_.*|.*_test|conftest)\.py$/,
+            testDirs: ['tests', 'test', '__tests__'],
+        };
+    }
+    /**
+     * 基于 tree-sitter-python 的注释提取。
+     *
+     * Python AST 将 docstring 归类为 `string` 节点（位于 expression_statement 下），
+     * 而非 `comment` 节点；因此 docstring 天然被排除，只有真正的 `#` 行注释被收集。
+     */
+    async extractComments(filePath) {
+        return extractCommentsWithTreeSitter(filePath, {
+            grammarName: 'python',
+            commentNodeTypes: new Set(['comment']),
+        });
+    }
+    /**
+     * 递归扫描项目根目录下所有 `.py` 文件，排除语言生态常见忽略目录。
+     *
+     * 复用 `defaultIgnoreDirs` 并叠加 Python 项目惯例（test/tests/dist 等）。
+     * 由 `extractSymbolNodes` 与 `buildDependencyGraph` 共用，避免 DRY 违反。
+     *
+     * @throws 当根目录不可读时抛出（调用方按需 try-catch 决定是否吞掉）
+     */
+    scanPyFiles(resolvedRoot) {
+        const ignoreNames = new Set([
+            ...this.defaultIgnoreDirs,
+            'test', 'tests', 'dist', 'node_modules', '.git',
+        ]);
+        const pyFiles = [];
+        function walk(dir) {
+            for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+                if (entry.isDirectory()) {
+                    if (!ignoreNames.has(entry.name) && !entry.name.startsWith('.')) {
+                        walk(path.join(dir, entry.name));
+                    }
+                }
+                else if (entry.isFile() && entry.name.endsWith('.py')) {
+                    pyFiles.push(path.join(dir, entry.name));
+                }
+            }
+        }
+        walk(resolvedRoot);
+        return pyFiles;
+    }
+    /**
+     * 提取 Python 项目所有 .py 文件的符号节点（函数/类），转换为 ExtractionResult 格式
+     *
+     * Feature 145 P0：桥接 Python AST（CodeSkeleton.exports）到知识图谱 ExtractionResult 第四路数据源。
+     * 每个 .py 文件产出一个 ExtractionResult，包含：
+     * - 文件级 module 节点（id = relPath, kind = 'module'）
+     * - 每个 export 符号的 component 节点（id = {relPath}#{name}, kind = 'component'）
+     * - module → component 的 containment 边（relation = 'contains'）
+     *
+     * NF-004：处理完每个文件后 skeleton 立即丢弃，不集中持有全量数据，避免内存压力。
+     */
+    async extractSymbolNodes(projectRoot) {
+        const resolvedRoot = path.resolve(projectRoot);
+        let pyFiles;
+        try {
+            pyFiles = this.scanPyFiles(resolvedRoot);
+        }
+        catch {
+            // 目录不可读时返回空结果，不抛出
+            return [];
+        }
+        const results = [];
+        for (const absPath of pyFiles) {
+            const relPath = path.relative(resolvedRoot, absPath).split(path.sep).join('/');
+            let skeleton;
+            try {
+                skeleton = await this.analyzeFile(absPath);
+            }
+            catch {
+                // 单文件解析失败不影响整体，仍产出文件级 module 节点；
+                // metadata.parseError 标记用于调用方聚合统计（Codex 对抗审查 C001 修复）
+                results.push({
+                    nodes: [
+                        {
+                            id: relPath,
+                            kind: 'module',
+                            label: path.basename(relPath, '.py'),
+                            source_file: relPath,
+                            confidence: 'EXTRACTED',
+                            metadata: { parseError: true },
+                        },
+                    ],
+                    edges: [],
+                });
+                continue;
+            }
+            const nodes = [];
+            const edges = [];
+            // 文件级 module 节点
+            nodes.push({
+                id: relPath,
+                kind: 'module',
+                label: path.basename(relPath, '.py'),
+                source_file: relPath,
+                confidence: 'EXTRACTED',
+            });
+            // 每个导出符号（函数/类）产出 component 节点 + containment 边
+            for (const symbol of skeleton.exports) {
+                const symbolId = `${relPath}#${symbol.name}`;
+                nodes.push({
+                    id: symbolId,
+                    kind: 'component',
+                    label: symbol.name,
+                    source_file: relPath,
+                    confidence: 'EXTRACTED',
+                    metadata: {
+                        symbolKind: symbol.kind,
+                        signature: symbol.signature ?? undefined,
+                    },
+                });
+                edges.push({
+                    source: relPath,
+                    target: symbolId,
+                    relation: 'contains',
+                    confidence: 'EXTRACTED',
+                    weight: 1.0,
+                });
+            }
+            results.push({ nodes, edges });
+        }
+        return results;
+    }
+    /**
+     * 构建 Python 项目的模块依赖图
+     * 扫描所有 .py 文件，解析 import 语句，仅对本地模块构建有向边
+     */
+    async buildDependencyGraph(projectRoot, _options) {
+        const resolvedRoot = path.resolve(projectRoot);
+        // 递归扫描所有 .py 文件，排除语言生态常见忽略目录
+        const pyFiles = this.scanPyFiles(resolvedRoot);
+        // 构建模块名 → 绝对路径映射（basename 不含扩展名）
+        const pyModuleMap = new Map();
+        for (const f of pyFiles) {
+            pyModuleMap.set(path.basename(f, '.py'), f);
+        }
+        const nodeSet = new Set();
+        const rawEdges = [];
+        for (const filePath of pyFiles) {
+            try {
+                const skeleton = await this.analyzeFile(filePath);
+                const relFrom = path.relative(resolvedRoot, filePath);
+                nodeSet.add(relFrom);
+                for (const imp of skeleton.imports) {
+                    // 取模块路径的顶层包名（如 parser.submodule → parser）
+                    const topModule = imp.moduleSpecifier.replace(/^\.+/, '').split('.')[0];
+                    if (!topModule)
+                        continue;
+                    const resolvedPath = pyModuleMap.get(topModule);
+                    if (resolvedPath) {
+                        const relTo = path.relative(resolvedRoot, resolvedPath);
+                        nodeSet.add(relTo);
+                        rawEdges.push({ from: relFrom, to: relTo });
+                    }
+                }
+            }
+            catch {
+                // 单文件解析失败不影响整体依赖图构建
+            }
+        }
+        const edges = rawEdges.map(e => ({
+            from: e.from,
+            to: e.to,
+            isCircular: false,
+            importType: 'static',
+        }));
+        // O(n) 单次遍历计算度数（避免 O(n·m) 的 3 次数组遍历）
+        const inDegreeMap = new Map();
+        const outDegreeMap = new Map();
+        const connectedNodes = new Set();
+        for (const e of rawEdges) {
+            inDegreeMap.set(e.to, (inDegreeMap.get(e.to) ?? 0) + 1);
+            outDegreeMap.set(e.from, (outDegreeMap.get(e.from) ?? 0) + 1);
+            connectedNodes.add(e.from);
+            connectedNodes.add(e.to);
+        }
+        const modules = [...nodeSet].map(source => ({
+            source,
+            isOrphan: !connectedNodes.has(source),
+            inDegree: inDegreeMap.get(source) ?? 0,
+            outDegree: outDegreeMap.get(source) ?? 0,
+            level: 0,
+        }));
+        return {
+            projectRoot: resolvedRoot,
+            modules,
+            edges,
+            topologicalOrder: modules.map(m => m.source),
+            sccs: [],
+            totalModules: modules.length,
+            totalEdges: edges.length,
+            analyzedAt: new Date().toISOString(),
+            mermaidSource: '',
+        };
+    }
+}
+//# sourceMappingURL=python-adapter.js.map

package/dist/adapters/python-adapter.js.map

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