speccore 6.89.0 → 6.90.0

package/dist/core/code-graph/index.js

@@ -0,0 +1,125 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCodeGraphHtml = exports.generateGraphReport = exports.queryGraph = exports.findPath = exports.explainNode = exports.buildCodeGraph = exports.parseProject = void 0;
+exports.buildCodeKnowledgeGraph = buildCodeKnowledgeGraph;
+exports.loadCodeGraph = loadCodeGraph;
+/**
+ * Code Knowledge Graph — 统一导出
+ * v6.90.0
+ */
+__exportStar(require("./types"), exports);
+var parser_1 = require("./parser");
+Object.defineProperty(exports, "parseProject", { enumerable: true, get: function () { return parser_1.parseProject; } });
+var builder_1 = require("./builder");
+Object.defineProperty(exports, "buildCodeGraph", { enumerable: true, get: function () { return builder_1.buildCodeGraph; } });
+var query_1 = require("./query");
+Object.defineProperty(exports, "explainNode", { enumerable: true, get: function () { return query_1.explainNode; } });
+Object.defineProperty(exports, "findPath", { enumerable: true, get: function () { return query_1.findPath; } });
+Object.defineProperty(exports, "queryGraph", { enumerable: true, get: function () { return query_1.queryGraph; } });
+var reporter_1 = require("./reporter");
+Object.defineProperty(exports, "generateGraphReport", { enumerable: true, get: function () { return reporter_1.generateGraphReport; } });
+var visualizer_1 = require("./visualizer");
+Object.defineProperty(exports, "buildCodeGraphHtml", { enumerable: true, get: function () { return visualizer_1.buildCodeGraphHtml; } });
+const path_1 = require("path");
+const fs_extra_1 = require("fs-extra");
+const glob_1 = require("glob");
+const logger_1 = require("../../utils/logger");
+const parser_2 = require("./parser");
+const builder_2 = require("./builder");
+const reporter_2 = require("./reporter");
+const visualizer_2 = require("./visualizer");
+const GRAPH_DIR = '.speccore/code-graph';
+/**
+ * 一键构建代码知识图谱，输出三产物
+ */
+async function buildCodeKnowledgeGraph(options = {}) {
+    const projectRoot = options.projectRoot || process.cwd();
+    const projectName = options.projectName || 'Project';
+    const scope = options.scope || 'src';
+    const scopePath = (0, path_1.join)(projectRoot, scope);
+    // 1. 扫描文件
+    logger_1.logger.info(`🔍 扫描代码文件: ${scope}`);
+    const pattern = (0, path_1.join)(scopePath, '**/*.{ts,tsx,js,jsx,mts,cts,mjs,cjs}');
+    const files = await (0, glob_1.glob)(pattern, { absolute: true });
+    logger_1.logger.info(`   发现 ${files.length} 个文件`);
+    // 2. AST 解析
+    logger_1.logger.info(`🌳 AST 解析中...`);
+    const { nodes, edges, fileCount } = await (0, parser_2.parseProject)(files, projectRoot);
+    logger_1.logger.info(`   提取 ${nodes.length} 个节点, ${edges.length} 条边`);
+    // 3. 构建图谱
+    const graph = (0, builder_2.buildCodeGraph)(nodes, edges, projectName, projectRoot, fileCount);
+    logger_1.logger.info(`   社区: ${graph.communities.length} 个 | God nodes: ${graph.godNodes.length} 个`);
+    // 4. 输出产物
+    const outDir = (0, path_1.join)(projectRoot, GRAPH_DIR);
+    await (0, fs_extra_1.ensureDir)(outDir);
+    // graph.json
+    const jsonPath = (0, path_1.join)(outDir, 'graph.json');
+    await (0, fs_extra_1.writeFile)(jsonPath, JSON.stringify(graph, null, 2));
+    logger_1.logger.info(`   ✅ graph.json`);
+    // GRAPH_REPORT.md
+    const reportPath = (0, path_1.join)(outDir, 'GRAPH_REPORT.md');
+    await (0, fs_extra_1.writeFile)(reportPath, (0, reporter_2.generateGraphReport)(graph));
+    logger_1.logger.info(`   ✅ GRAPH_REPORT.md`);
+    // graph.html
+    const htmlPath = (0, path_1.join)(outDir, 'graph.html');
+    await (0, fs_extra_1.writeFile)(htmlPath, (0, visualizer_2.buildCodeGraphHtml)(graph));
+    logger_1.logger.info(`   ✅ graph.html`);
+    logger_1.logger.info('');
+    logger_1.logger.info(`📊 代码知识图谱已生成: ${outDir}`);
+    logger_1.logger.info(`   打开 ${(0, path_1.join)(GRAPH_DIR, 'graph.html')} 查看可视化`);
+    return graph;
+}
+/**
+ * 加载已存在的 graph.json
+ */
+async function loadCodeGraph(projectRoot) {
+    const root = projectRoot || process.cwd();
+    const jsonPath = (0, path_1.join)(root, GRAPH_DIR, 'graph.json');
+    if (!(await (0, fs_extra_1.pathExists)(jsonPath)))
+        return null;
+    try {
+        const { readFile } = await Promise.resolve().then(() => __importStar(require('fs-extra')));
+        const raw = await readFile(jsonPath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/core/code-graph/index.js.map

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

package/dist/core/code-graph/parser.d.ts

@@ -0,0 +1,10 @@
+import type { CodeNode, CodeEdge } from './types';
+/**
+ * 扫描目录，解析所有 TS/JS 文件
+ */
+export declare function parseProject(filePaths: string[], projectRoot: string): Promise<{
+    nodes: CodeNode[];
+    edges: CodeEdge[];
+    fileCount: number;
+}>;
+//# sourceMappingURL=parser.d.ts.map

package/dist/core/code-graph/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/core/code-graph/parser.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAc,MAAM,SAAS,CAAC;AAoR9D;;GAEG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EAAE,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CA2BtE"}

package/dist/core/code-graph/parser.js

@@ -0,0 +1,314 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseProject = parseProject;
+/**
+ * Code Knowledge Graph — AST 解析器
+ * v6.90.0: 基于 TypeScript 编译器 API 的本地确定性解析
+ *
+ * 零 LLM Token 消耗，代码不出本机。
+ */
+const ts = __importStar(require("typescript"));
+const fs_1 = require("fs");
+const path_1 = require("path");
+const SCRIPT_TARGET = ts.ScriptTarget.ES2020;
+const SCRIPT_KIND_TS = ts.ScriptKind.TS;
+const SCRIPT_KIND_JS = ts.ScriptKind.JS;
+function isTsOrJs(filePath) {
+    return /\.(ts|tsx|js|jsx|mts|cts|mjs|cjs)$/i.test(filePath);
+}
+function getScriptKind(filePath) {
+    if (/\.tsx$/i.test(filePath))
+        return ts.ScriptKind.TSX;
+    if (/\.jsx$/i.test(filePath))
+        return ts.ScriptKind.JSX;
+    if (/\.(js|mjs|cjs)$/i.test(filePath))
+        return SCRIPT_KIND_JS;
+    return SCRIPT_KIND_TS;
+}
+function makeNodeId(filePath, name) {
+    return `${filePath}::${name}`;
+}
+function getNodePosition(node, sourceFile) {
+    const pos = sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile));
+    return { line: pos.line + 1, column: pos.character + 1 };
+}
+function getSnippet(node, sourceFile) {
+    const text = node.getText(sourceFile);
+    return text.slice(0, 200).replace(/\s+/g, ' ').trim();
+}
+/**
+ * 解析单个文件，提取节点和边
+ */
+function parseSingleFile(filePath, projectRoot) {
+    if (!isTsOrJs(filePath))
+        return null;
+    let content;
+    try {
+        content = (0, fs_1.readFileSync)(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+    const relPath = (0, path_1.relative)(projectRoot, filePath);
+    const sourceFile = ts.createSourceFile(filePath, content, SCRIPT_TARGET, true, getScriptKind(filePath));
+    const nodes = [];
+    const edges = [];
+    const exports = [];
+    const localNames = new Set();
+    // 文件级 module 节点
+    const moduleId = relPath;
+    nodes.push({
+        id: moduleId,
+        name: (0, path_1.basename)(relPath),
+        type: 'module',
+        filePath: relPath,
+        line: 1,
+        column: 1,
+    });
+    function addNode(name, type, node) {
+        const pos = getNodePosition(node, sourceFile);
+        const id = makeNodeId(relPath, name);
+        const n = {
+            id,
+            name,
+            type,
+            filePath: relPath,
+            line: pos.line,
+            column: pos.column,
+            snippet: getSnippet(node, sourceFile),
+        };
+        nodes.push(n);
+        localNames.add(name);
+        return n;
+    }
+    function addEdge(source, target, type, confidence, line) {
+        edges.push({ source, target, type, confidence, filePath: relPath, line });
+    }
+    function visit(node) {
+        // 1. Import declarations → module dependency edges
+        if (ts.isImportDeclaration(node)) {
+            const moduleName = node.moduleSpecifier?.text;
+            if (moduleName) {
+                // Named imports / namespace imports
+                const importClause = node.importClause;
+                if (importClause) {
+                    if (importClause.namedBindings) {
+                        if (ts.isNamedImports(importClause.namedBindings)) {
+                            for (const elem of importClause.namedBindings.elements) {
+                                const name = elem.name.text;
+                                addNode(name, 'variable', elem); // imported symbol as a node
+                                addEdge(makeNodeId(relPath, name), moduleName, 'imports', 'EXTRACTED', getNodePosition(node, sourceFile).line);
+                            }
+                        }
+                        else if (ts.isNamespaceImport(importClause.namedBindings)) {
+                            const name = importClause.namedBindings.name.text;
+                            addNode(name, 'variable', importClause.namedBindings);
+                            addEdge(makeNodeId(relPath, name), moduleName, 'imports', 'EXTRACTED', getNodePosition(node, sourceFile).line);
+                        }
+                    }
+                    if (importClause.name) {
+                        const name = importClause.name.text;
+                        addNode(name, 'variable', importClause);
+                        addEdge(makeNodeId(relPath, name), moduleName, 'imports', 'EXTRACTED', getNodePosition(node, sourceFile).line);
+                    }
+                }
+                else {
+                    // side-effect import: import "module"
+                    addEdge(relPath, moduleName, 'imports', 'EXTRACTED', getNodePosition(node, sourceFile).line);
+                }
+            }
+        }
+        // 2. Export declarations
+        if (ts.isExportDeclaration(node) && node.exportClause && ts.isNamedExports(node.exportClause)) {
+            for (const elem of node.exportClause.elements) {
+                exports.push(elem.name.text);
+            }
+        }
+        if (ts.isExportAssignment(node) && !node.isExportEquals) {
+            // export default <expr>
+            const expr = node.expression;
+            if (ts.isIdentifier(expr)) {
+                exports.push(`default:${expr.text}`);
+            }
+        }
+        // 3. Function declarations
+        if (ts.isFunctionDeclaration(node) && node.name) {
+            addNode(node.name.text, 'function', node);
+        }
+        // 4. Class declarations
+        if (ts.isClassDeclaration(node) && node.name) {
+            const className = node.name.text;
+            const classId = makeNodeId(relPath, className);
+            addNode(className, 'class', node);
+            // extends
+            if (node.heritageClauses) {
+                for (const clause of node.heritageClauses) {
+                    if (clause.token === ts.SyntaxKind.ExtendsKeyword) {
+                        for (const type of clause.types) {
+                            const parentName = type.expression.getText(sourceFile);
+                            addEdge(classId, parentName, 'extends', 'EXTRACTED', getNodePosition(clause, sourceFile).line);
+                        }
+                    }
+                    if (clause.token === ts.SyntaxKind.ImplementsKeyword) {
+                        for (const type of clause.types) {
+                            const ifaceName = type.expression.getText(sourceFile);
+                            addEdge(classId, ifaceName, 'implements', 'EXTRACTED', getNodePosition(clause, sourceFile).line);
+                        }
+                    }
+                }
+            }
+            // methods and properties
+            for (const member of node.members) {
+                if (ts.isMethodDeclaration(member) && member.name) {
+                    const methodName = member.name.getText(sourceFile);
+                    const methodId = makeNodeId(relPath, `${className}.${methodName}`);
+                    nodes.push({
+                        id: methodId,
+                        name: methodName,
+                        type: 'method',
+                        filePath: relPath,
+                        line: getNodePosition(member, sourceFile).line,
+                        column: getNodePosition(member, sourceFile).column,
+                        snippet: getSnippet(member, sourceFile),
+                    });
+                    localNames.add(methodName);
+                    addEdge(classId, methodId, 'contains', 'EXTRACTED', getNodePosition(member, sourceFile).line);
+                }
+                if (ts.isPropertyDeclaration(member) && member.name) {
+                    const propName = member.name.getText(sourceFile);
+                    const propId = makeNodeId(relPath, `${className}.${propName}`);
+                    nodes.push({
+                        id: propId,
+                        name: propName,
+                        type: 'property',
+                        filePath: relPath,
+                        line: getNodePosition(member, sourceFile).line,
+                        column: getNodePosition(member, sourceFile).column,
+                        snippet: getSnippet(member, sourceFile),
+                    });
+                    addEdge(classId, propId, 'contains', 'EXTRACTED', getNodePosition(member, sourceFile).line);
+                }
+            }
+        }
+        // 5. Interface declarations
+        if (ts.isInterfaceDeclaration(node) && node.name) {
+            const ifaceName = node.name.text;
+            const ifaceId = makeNodeId(relPath, ifaceName);
+            addNode(ifaceName, 'interface', node);
+            if (node.heritageClauses) {
+                for (const clause of node.heritageClauses) {
+                    for (const type of clause.types) {
+                        const parentName = type.expression.getText(sourceFile);
+                        addEdge(ifaceId, parentName, 'extends', 'EXTRACTED', getNodePosition(clause, sourceFile).line);
+                    }
+                }
+            }
+        }
+        // 6. Type alias declarations
+        if (ts.isTypeAliasDeclaration(node) && node.name) {
+            addNode(node.name.text, 'type', node);
+        }
+        // 7. Enum declarations
+        if (ts.isEnumDeclaration(node) && node.name) {
+            addNode(node.name.text, 'enum', node);
+        }
+        // 8. Variable declarations (catch arrow functions / function expressions)
+        if (ts.isVariableDeclaration(node) && node.name) {
+            const varName = node.name.getText(sourceFile);
+            const isFunctionLike = node.initializer &&
+                (ts.isArrowFunction(node.initializer) || ts.isFunctionExpression(node.initializer));
+            addNode(varName, isFunctionLike ? 'function' : 'variable', node);
+        }
+        // 9. Call expressions → same-file call edges
+        if (ts.isCallExpression(node)) {
+            const expr = node.expression;
+            let calleeName;
+            if (ts.isIdentifier(expr)) {
+                calleeName = expr.text;
+            }
+            else if (ts.isPropertyAccessExpression(expr)) {
+                // obj.method() or Class.method()
+                calleeName = expr.name.text;
+                // Try to get full chain like "fs.readFileSync"
+                const fullChain = expr.getText(sourceFile);
+                if (fullChain.includes('.')) {
+                    calleeName = fullChain;
+                }
+            }
+            if (calleeName && localNames.has(calleeName)) {
+                // 简单推断：如果调用的是本文件已知的名称，标记为 EXTRACTED
+                const confidence = 'EXTRACTED';
+                addEdge(moduleId, makeNodeId(relPath, calleeName), 'calls', confidence, getNodePosition(node, sourceFile).line);
+            }
+            else if (calleeName) {
+                // INFERRED: could be imported or built-in
+                addEdge(moduleId, calleeName, 'calls', 'INFERRED', getNodePosition(node, sourceFile).line);
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    return { filePath: relPath, nodes, edges, exports };
+}
+/**
+ * 扫描目录，解析所有 TS/JS 文件
+ */
+async function parseProject(filePaths, projectRoot) {
+    const allNodes = [];
+    const allEdges = [];
+    let fileCount = 0;
+    for (const fp of filePaths) {
+        const parsed = parseSingleFile(fp, projectRoot);
+        if (parsed) {
+            allNodes.push(...parsed.nodes);
+            allEdges.push(...parsed.edges);
+            fileCount++;
+        }
+    }
+    // 去重节点（按 id）
+    const nodeMap = new Map();
+    for (const n of allNodes) {
+        if (!nodeMap.has(n.id)) {
+            nodeMap.set(n.id, n);
+        }
+    }
+    return {
+        nodes: Array.from(nodeMap.values()),
+        edges: allEdges,
+        fileCount,
+    };
+}
+//# sourceMappingURL=parser.js.map

package/dist/core/code-graph/parser.js.map

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

package/dist/core/code-graph/query.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Code Knowledge Graph — 查询引擎
+ * v6.90.0
+ *
+ * 支持 explain / path / query 三种查询模式
+ */
+import type { CodeGraph, GraphQueryResult } from './types';
+/** explain: 解释一个节点及其直接连接 */
+export declare function explainNode(graph: CodeGraph, nameOrId: string): GraphQueryResult;
+/** path: BFS 最短路径 */
+export declare function findPath(graph: CodeGraph, from: string, to: string): GraphQueryResult;
+/** query: 关键词匹配返回子图（简化版） */
+export declare function queryGraph(graph: CodeGraph, question: string): GraphQueryResult;
+//# sourceMappingURL=query.d.ts.map

package/dist/core/code-graph/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/core/code-graph/query.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAsB,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAO/E,4BAA4B;AAC5B,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAoBhF;AAED,qBAAqB;AACrB,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,gBAAgB,CAqDrF;AAED,4BAA4B;AAC5B,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAqC/E"}

package/dist/core/code-graph/query.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.explainNode = explainNode;
+exports.findPath = findPath;
+exports.queryGraph = queryGraph;
+/** 根据名称或 id 查找节点 */
+function findNode(graph, nameOrId) {
+    return graph.nodes.find(n => n.id === nameOrId || n.name === nameOrId);
+}
+/** explain: 解释一个节点及其直接连接 */
+function explainNode(graph, nameOrId) {
+    const target = findNode(graph, nameOrId);
+    if (!target) {
+        return { nodes: [], edges: [] };
+    }
+    const relatedEdges = graph.edges.filter(e => e.source === target.id || e.target === target.id);
+    const relatedNodeIds = new Set([target.id]);
+    for (const e of relatedEdges) {
+        relatedNodeIds.add(e.source);
+        relatedNodeIds.add(e.target);
+    }
+    return {
+        nodes: graph.nodes.filter(n => relatedNodeIds.has(n.id)),
+        edges: relatedEdges,
+    };
+}
+/** path: BFS 最短路径 */
+function findPath(graph, from, to) {
+    const start = findNode(graph, from);
+    const end = findNode(graph, to);
+    if (!start || !end) {
+        return { nodes: [], edges: [] };
+    }
+    // BFS
+    const queue = [start.id];
+    const visited = new Set([start.id]);
+    const parent = new Map();
+    while (queue.length > 0) {
+        const current = queue.shift();
+        if (current === end.id)
+            break;
+        for (const edge of graph.edges) {
+            let neighbor;
+            if (edge.source === current)
+                neighbor = edge.target;
+            else if (edge.target === current)
+                neighbor = edge.source;
+            if (neighbor && !visited.has(neighbor)) {
+                visited.add(neighbor);
+                parent.set(neighbor, { node: current, edge });
+                queue.push(neighbor);
+            }
+        }
+    }
+    if (!parent.has(end.id) && start.id !== end.id) {
+        return { nodes: [start, end], edges: [] };
+    }
+    // Reconstruct path
+    const pathNodes = [];
+    const pathEdges = [];
+    let curr = end.id;
+    while (curr !== start.id) {
+        pathNodes.unshift(curr);
+        const p = parent.get(curr);
+        if (!p)
+            break;
+        pathEdges.unshift(p.edge);
+        curr = p.node;
+    }
+    pathNodes.unshift(start.id);
+    const nodeSet = new Set(pathNodes);
+    return {
+        nodes: graph.nodes.filter(n => nodeSet.has(n.id)),
+        edges: pathEdges,
+        path: pathNodes,
+    };
+}
+/** query: 关键词匹配返回子图（简化版） */
+function queryGraph(graph, question) {
+    const keywords = question.toLowerCase()
+        .replace(/[^\u4e00-\u9fa5a-z0-9\s]/g, ' ')
+        .split(/\s+/)
+        .filter(w => w.length >= 2);
+    if (keywords.length === 0) {
+        return { nodes: [], edges: [] };
+    }
+    const scoredNodes = graph.nodes.map(n => {
+        const text = `${n.name} ${n.type} ${n.filePath} ${n.snippet || ''}`.toLowerCase();
+        let score = 0;
+        for (const kw of keywords) {
+            if (n.name.toLowerCase().includes(kw))
+                score += 5;
+            else if (text.includes(kw))
+                score += 1;
+        }
+        return { node: n, score };
+    }).filter(s => s.score > 0)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, 20);
+    const matchedIds = new Set(scoredNodes.map(s => s.node.id));
+    // 包含匹配节点的一阶邻居
+    const relatedEdges = graph.edges.filter(e => matchedIds.has(e.source) || matchedIds.has(e.target));
+    for (const e of relatedEdges) {
+        matchedIds.add(e.source);
+        matchedIds.add(e.target);
+    }
+    return {
+        nodes: graph.nodes.filter(n => matchedIds.has(n.id)),
+        edges: relatedEdges,
+    };
+}
+//# sourceMappingURL=query.js.map

package/dist/core/code-graph/query.js.map

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

package/dist/core/code-graph/reporter.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Code Knowledge Graph — GRAPH_REPORT.md 生成器
+ * v6.90.0
+ */
+import type { CodeGraph } from './types';
+export declare function generateGraphReport(graph: CodeGraph): string;
+//# sourceMappingURL=reporter.d.ts.map

package/dist/core/code-graph/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../../src/core/code-graph/reporter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CA0F5D"}