speccore 6.83.0 → 6.90.0

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

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCodeGraph = buildCodeGraph;
+/**
+ * Code Knowledge Graph — 图谱构建器
+ * v6.90.0
+ */
+const path_1 = require("path");
+/**
+ * 计算节点度数、识别 god nodes、构建完整图谱
+ */
+function buildCodeGraph(nodes, edges, projectName, projectRoot, scannedFiles) {
+    // 0. 构建 name → id 映射，修复跨文件引用的裸名
+    const idSet = new Set(nodes.map(n => n.id));
+    const nameToIds = new Map();
+    for (const n of nodes) {
+        if (!nameToIds.has(n.name))
+            nameToIds.set(n.name, []);
+        nameToIds.get(n.name).push(n.id);
+    }
+    for (const e of edges) {
+        if (!idSet.has(e.source) && nameToIds.has(e.source)) {
+            e.source = nameToIds.get(e.source)[0];
+        }
+        if (!idSet.has(e.target) && nameToIds.has(e.target)) {
+            e.target = nameToIds.get(e.target)[0];
+        }
+    }
+    // 1. 计算每个节点的度数
+    const degreeMap = new Map();
+    for (const n of nodes) {
+        degreeMap.set(n.id, 0);
+    }
+    for (const e of edges) {
+        if (idSet.has(e.source))
+            degreeMap.set(e.source, (degreeMap.get(e.source) || 0) + 1);
+        if (idSet.has(e.target))
+            degreeMap.set(e.target, (degreeMap.get(e.target) || 0) + 1);
+    }
+    // 2. 按度数排序，识别 god nodes（前10%）
+    const sortedByDegree = Array.from(degreeMap.entries())
+        .sort((a, b) => b[1] - a[1]);
+    const godNodeThreshold = Math.max(1, Math.floor(nodes.length * 0.1));
+    const godNodes = sortedByDegree.slice(0, godNodeThreshold).map(([id]) => id);
+    // 3. 给节点附加度数
+    const enrichedNodes = nodes.map(n => ({
+        ...n,
+        degree: degreeMap.get(n.id) || 0,
+    }));
+    // 4. 社区检测（基于目录路径 + 连通分量）
+    const communities = detectCommunities(enrichedNodes, edges);
+    // 5. 统计
+    const extractedEdges = edges.filter(e => e.confidence === 'EXTRACTED').length;
+    const inferredEdges = edges.filter(e => e.confidence === 'INFERRED').length;
+    return {
+        nodes: enrichedNodes,
+        edges,
+        communities,
+        godNodes,
+        metadata: {
+            projectName,
+            projectRoot,
+            scannedFiles,
+            totalNodes: nodes.length,
+            totalEdges: edges.length,
+            extractedEdges,
+            inferredEdges,
+            generatedAt: new Date().toISOString(),
+        },
+    };
+}
+/**
+ * 社区检测：基于目录结构 + 简单连通分量
+ */
+function detectCommunities(nodes, edges) {
+    // Step 1: 按目录路径初步分组
+    const dirGroups = new Map();
+    for (const n of nodes) {
+        const dir = (0, path_1.dirname)(n.filePath);
+        if (!dirGroups.has(dir))
+            dirGroups.set(dir, []);
+        dirGroups.get(dir).push(n.id);
+    }
+    // Step 2: 用 Union-Find 合并有边连接的组
+    const uf = new UnionFind(nodes.map(n => n.id));
+    for (const e of edges) {
+        uf.union(e.source, e.target);
+    }
+    // Step 3: 按连通分量 + 目录信息生成社区
+    const componentMap = new Map();
+    for (const n of nodes) {
+        const root = uf.find(n.id);
+        if (!componentMap.has(root))
+            componentMap.set(root, []);
+        componentMap.get(root).push(n.id);
+    }
+    const communities = [];
+    let commId = 0;
+    for (const [, members] of componentMap) {
+        if (members.length < 2)
+            continue; // 忽略孤立节点
+        // 找社区标签：取成员最多的目录名
+        const dirCounts = new Map();
+        for (const id of members) {
+            const node = nodes.find(n => n.id === id);
+            if (node) {
+                const dir = (0, path_1.dirname)(node.filePath);
+                dirCounts.set(dir, (dirCounts.get(dir) || 0) + 1);
+            }
+        }
+        const label = Array.from(dirCounts.entries()).sort((a, b) => b[1] - a[1])[0]?.[0] || 'unknown';
+        // 计算密度：内部边 / 总边
+        const memberSet = new Set(members);
+        const internalEdges = edges.filter(e => memberSet.has(e.source) && memberSet.has(e.target)).length;
+        const totalPossible = members.length * (members.length - 1) / 2;
+        const density = totalPossible > 0 ? internalEdges / totalPossible : 0;
+        communities.push({
+            id: commId++,
+            label,
+            nodes: members,
+            density: Math.min(1, density),
+        });
+    }
+    // 给节点附加社区 ID
+    for (const comm of communities) {
+        for (const id of comm.nodes) {
+            const node = nodes.find(n => n.id === id);
+            if (node)
+                node.community = comm.id;
+        }
+    }
+    return communities.sort((a, b) => b.nodes.length - a.nodes.length);
+}
+class UnionFind {
+    constructor(ids) {
+        this.parent = new Map();
+        for (const id of ids)
+            this.parent.set(id, id);
+    }
+    find(x) {
+        const p = this.parent.get(x);
+        if (!p || p === x)
+            return x;
+        const root = this.find(p);
+        this.parent.set(x, root);
+        return root;
+    }
+    union(a, b) {
+        const ra = this.find(a);
+        const rb = this.find(b);
+        if (ra !== rb)
+            this.parent.set(ra, rb);
+    }
+}
+//# sourceMappingURL=builder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../src/core/code-graph/builder.ts"],"names":[],"mappings":";;AAUA,wCAqEC;AA/ED;;;GAGG;AACH,+BAA+B;AAG/B;;GAEG;AACH,SAAgB,cAAc,CAC5B,KAAiB,EACjB,KAAiB,EACjB,WAAmB,EACnB,WAAmB,EACnB,YAAoB;IAEpB,gCAAgC;IAChC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC9C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACtD,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;YACpD,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAE,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;YACpD,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAE,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,eAAe;IACf,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACzB,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;YAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACrF,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;YAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACvF,CAAC;IAED,8BAA8B;IAC9B,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;SACnD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;IAE7E,aAAa;IACb,MAAM,aAAa,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACpC,GAAG,CAAC;QACJ,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC;KACjC,CAAC,CAAC,CAAC;IAEJ,yBAAyB;IACzB,MAAM,WAAW,GAAG,iBAAiB,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAE5D,QAAQ;IACR,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;IAC9E,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC,MAAM,CAAC;IAE5E,OAAO;QACL,KAAK,EAAE,aAAa;QACpB,KAAK;QACL,WAAW;QACX,QAAQ;QACR,QAAQ,EAAE;YACR,WAAW;YACX,WAAW;YACX,YAAY;YACZ,UAAU,EAAE,KAAK,CAAC,MAAM;YACxB,UAAU,EAAE,KAAK,CAAC,MAAM;YACxB,cAAc;YACd,aAAa;YACb,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,KAAiB,EAAE,KAAiB;IAC7D,oBAAoB;IACpB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC9C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,IAAA,cAAO,EAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAChC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAChD,SAAS,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,gCAAgC;IAChC,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,2BAA2B;IAC3B,MAAM,YAAY,GAAG,IAAI,GAAG,EAAoB,CAAC;IACjD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACxD,YAAY,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,WAAW,GAAoB,EAAE,CAAC;IACxC,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,KAAK,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,YAAY,EAAE,CAAC;QACvC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS,CAAC,SAAS;QAE3C,kBAAkB;QAClB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC5C,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YAC1C,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,GAAG,GAAG,IAAA,cAAO,EAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACnC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;QAE/F,gBAAgB;QAChB,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAChC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CACxD,CAAC,MAAM,CAAC;QACT,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAEtE,WAAW,CAAC,IAAI,CAAC;YACf,EAAE,EAAE,MAAM,EAAE;YACZ,KAAK;YACL,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,aAAa;IACb,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YAC1C,IAAI,IAAI;gBAAE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC;QACrC,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,SAAS;IAGb,YAAY,GAAa;QAFjB,WAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;QAGzC,KAAK,MAAM,EAAE,IAAI,GAAG;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,CAAC,CAAS;QACZ,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,CAAS,EAAE,CAAS;QACxB,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxB,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,EAAE,KAAK,EAAE;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACzC,CAAC;CACF"}

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

@@ -0,0 +1,25 @@
+/**
+ * Code Knowledge Graph — 统一导出
+ * v6.90.0
+ */
+export * from './types';
+export { parseProject } from './parser';
+export { buildCodeGraph } from './builder';
+export { explainNode, findPath, queryGraph } from './query';
+export { generateGraphReport } from './reporter';
+export { buildCodeGraphHtml } from './visualizer';
+import type { CodeGraph } from './types';
+export interface BuildGraphOptions {
+    scope?: string;
+    projectRoot?: string;
+    projectName?: string;
+}
+/**
+ * 一键构建代码知识图谱，输出三产物
+ */
+export declare function buildCodeKnowledgeGraph(options?: BuildGraphOptions): Promise<CodeGraph>;
+/**
+ * 加载已存在的 graph.json
+ */
+export declare function loadCodeGraph(projectRoot?: string): Promise<CodeGraph | null>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/code-graph/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAUlD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAIzC,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,SAAS,CAAC,CA8CjG;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAWnF"}

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