speccore 6.5.1 → 6.10.0

package/dist/core/intent-cache.js

@@ -20,9 +20,25 @@ const logger_1 = require("../utils/logger");
 // 常量
 // ═══════════════════════════════════════════════════════════
 const CACHE_PATH = '.speccore/local/intent-cache.json';
-const CACHE_VERSION = '1.0';
+const CACHE_VERSION = '1.1'; // 升级到 1.1 支持 normalizedInput
 const MAX_ENTRIES = 200;
 const FUZZY_THRESHOLD = 2; // 编辑距离阈值
+/** 停用词表 */
+const NORMALIZE_STOP_WORDS = new Set([
+    '的', '与', '和', '及', '在', '中', '对', '为', '是', '有', '从', '到',
+    'the', 'a', 'an', 'and', 'or', 'to', 'of', 'in', 'for', 'on', 'with', 'by',
+    '请', '帮我', '给我', '一下', '一个', '这个', '那个',
+]);
+/** 将输入归一化为语义键（去停用词 + 排序） */
+function normalizeInput(input) {
+    const tokens = input
+        .toLowerCase()
+        .replace(/[^\u4e00-\u9fa5a-z0-9\s]/g, ' ')
+        .split(/\s+/)
+        .filter(t => t.length >= 2 && !NORMALIZE_STOP_WORDS.has(t))
+        .sort();
+    return tokens.slice(0, 6).join('|'); // 取前6个关键词，用 | 分隔
+}
 // ═══════════════════════════════════════════════════════════
 // 缓存读写
 // ═══════════════════════════════════════════════════════════
@@ -54,7 +70,7 @@ async function saveCache(cache) {
 // 公共 API
 // ═══════════════════════════════════════════════════════════
 /**
- * 查询缓存：先精确匹配，再模糊匹配
+ * 查询缓存：精确 → 归一化语义 → 编辑距离模糊
  */
 async function getCachedIntent(input) {
     const cache = await loadCache();
@@ -67,7 +83,20 @@ async function getCachedIntent(input) {
         logger_1.logger.info(`💾 意图缓存命中(精确): "${input.slice(0, 30)}..." → ${exact.result.summary.slice(0, 30)}`);
         return exact.result;
     }
-    // 2. 模糊匹配（编辑距离 ≤ 2，且长度比例合理）
+    // 2. 归一化语义匹配（"分析一下登录" ≈ "分析登录功能"）
+    const normalized = normalizeInput(input);
+    if (normalized) {
+        for (const entry of Object.values(cache.entries)) {
+            if (entry.normalizedInput === normalized) {
+                entry.hitCount++;
+                entry.lastUsed = new Date().toISOString();
+                await saveCache(cache);
+                logger_1.logger.info(`💾 意图缓存命中(语义): "${input.slice(0, 30)}..." ≈ "${entry.input.slice(0, 30)}..."`);
+                return entry.result;
+            }
+        }
+    }
+    // 3. 模糊匹配（编辑距离 ≤ 2，且长度比例合理）
     // 防止短字符串误匹配：如"补充测试"匹配"补充分析"（编辑距离 2 但语义完全不同）
     for (const [cachedInput, entry] of Object.entries(cache.entries)) {
         const dist = levenshtein(input, cachedInput);
@@ -92,6 +121,7 @@ async function cacheIntent(input, result, source = 'host-ai') {
     const cache = await loadCache();
     cache.entries[input] = {
         input,
+        normalizedInput: normalizeInput(input),
         result,
         source,
         hitCount: 1,

package/dist/core/intent-cache.js.map

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

package/dist/core/knowledge-graph.d.ts

@@ -41,14 +41,20 @@ export declare function buildKnowledgeGraph(cwd: string, iteration?: string): Pr
 /** 保存知识图谱到 cache 目录 */
 export declare function saveKnowledgeGraph(cwd: string, graph: KnowledgeGraph): Promise<string>;
 /** 加载已存在的知识图谱 */
+/**
+ * 加载知识图谱（带进程缓存）
+ * 文件 mtime 未变时直接返回缓存，避免重复 JSON 解析
+ */
 export declare function loadKnowledgeGraph(cwd: string): Promise<KnowledgeGraph | null>;
 /** 获取指定任务的关联链（上游需求 + 关联子任务） */
 export declare function getTaskContext(graph: KnowledgeGraph, taskId: string): {
     requirement: GraphEntity | null;
     siblingSubtasks: GraphEntity[];
     parentTask: GraphEntity | null;
+    relatedSpecs: GraphEntity[];
+    dependsOn: GraphEntity[];
 };
-/** 检查知识图谱是否已过期 */
+/** 检查知识图谱是否已过期（带 500ms 超时保护） */
 export declare function isGraphStale(cwd: string, iteration?: string): Promise<boolean>;
 /** 刷新知识图谱（重建 + 保存）—— 供命令完成后调用 */
 export declare function refreshKnowledgeGraph(cwd: string, iteration?: string): Promise<KnowledgeGraph | null>;

package/dist/core/knowledge-graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge-graph.d.ts","sourceRoot":"","sources":["../../src/core/knowledge-graph.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtC,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,CAAC;CAC/E;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAiVD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,CAAC,CAoDzB;AAED,uBAAuB;AACvB,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAM5F;AAED,iBAAiB;AACjB,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CASpF;AAED,+BAA+B;AAC/B,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG;IACrE,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,eAAe,EAAE,WAAW,EAAE,CAAC;IAC/B,UAAU,EAAE,WAAW,GAAG,IAAI,CAAC;CAChC,CA+BA;AAMD,kBAAkB;AAClB,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA2BpF;AAED,iCAAiC;AACjC,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAShC"}
+{"version":3,"file":"knowledge-graph.d.ts","sourceRoot":"","sources":["../../src/core/knowledge-graph.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyBH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtC,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,CAAC;CAC/E;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAmeD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,CAAC,CAkEzB;AAED,uBAAuB;AACvB,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAM5F;AAED,iBAAiB;AACjB;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAkBpF;AAED,+BAA+B;AAC/B,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG;IACrE,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,eAAe,EAAE,WAAW,EAAE,CAAC;IAC/B,UAAU,EAAE,WAAW,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,SAAS,EAAE,WAAW,EAAE,CAAC;CAC1B,CAwDA;AAiCD,gCAAgC;AAChC,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA6BpF;AAED,iCAAiC;AACjC,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAShC"}

package/dist/core/knowledge-graph.js

@@ -51,6 +51,8 @@ const crypto_1 = require("crypto");
 const context_1 = require("./context");
 const task_paths_1 = require("./task-paths");
 const task_utils_1 = require("../utils/task-utils");
+const logger_1 = require("../utils/logger");
+const kgCache = new Map();
 // ═══════════════════════════════════════════════
 // 文件扫描辅助
 // ═══════════════════════════════════════════════
@@ -104,11 +106,13 @@ async function scanRequirements(iterDir, iterName) {
             if (item.isDirectory()) {
                 await scanDir(fullPath, `${relPath}/`);
             }
-            else if (item.name.endsWith('.md') && item.name !== 'INDEX.md') {
+            else if (item.name.endsWith('.md') && item.name !== 'INDEX.md' && !(0, task_utils_1.isTimestampBackup)(item.name)) {
                 const { hash, mtime } = await fileHash(fullPath);
                 const title = await extractTitle(fullPath);
                 const content = await (0, fs_extra_1.readFile)(fullPath, 'utf-8').catch(() => '');
-                const reqId = extractReqId(content, item.name.replace('.md', ''));
+                // 用路径前缀确保 ID 唯一性，避免不同文件引用同一 REQ-xxx 时覆盖
+                const pathPrefix = relPath.replace(/\.md$/, '').replace(/\//g, '-');
+                const reqId = extractReqId(content, pathPrefix);
                 entities.push({
                     id: reqId,
                     type: 'requirement',
@@ -116,7 +120,13 @@ async function scanRequirements(iterDir, iterName) {
                     file: `010-requirements/${relPath}`,
                     hash,
                     mtime,
-                    tags: [prefix.includes('features/') ? 'feature' : 'requirement'],
+                    tags: [
+                        prefix.includes('features/') ? 'feature'
+                            : prefix.includes('bugs/') ? 'bug'
+                                : prefix.includes('refactors/') ? 'refactor'
+                                    : prefix.includes('research/') ? 'research'
+                                        : 'requirement'
+                    ],
                 });
             }
         }
@@ -177,6 +187,74 @@ async function scanSpecs(iterDir) {
             }
         }
     }
+    // 扫描 features/ 子目录（按功能模块的分析产出）
+    const featuresDir = (0, path_1.join)(specsDir, 'features');
+    if (await (0, fs_extra_1.pathExists)(featuresDir)) {
+        const featureEntries = await (0, fs_extra_1.readdir)(featuresDir, { withFileTypes: true });
+        for (const fe of featureEntries) {
+            if (fe.name.startsWith('.') || (0, task_utils_1.isTimestampBackup)(fe.name))
+                continue;
+            if (!fe.name.endsWith('.md'))
+                continue;
+            const fullPath = (0, path_1.join)(featuresDir, fe.name);
+            const { hash, mtime } = await fileHash(fullPath);
+            const title = await extractTitle(fullPath);
+            const featureName = fe.name.replace('.md', '');
+            entities.push({
+                id: `SPEC:features/${featureName}`,
+                type: 'spec',
+                title: title || featureName,
+                file: `020-specs/features/${fe.name}`,
+                hash,
+                mtime,
+                tags: ['feature-spec'],
+            });
+            // 关联到对应的需求 feature（同名匹配）
+            const reqFeaturePath = (0, path_1.join)('010-requirements', 'features', featureName);
+            const matchedReq = entities.find(e => e.file?.startsWith(reqFeaturePath));
+            if (matchedReq) {
+                relations.push({
+                    from: `SPEC:features/${featureName}`,
+                    to: matchedReq.id,
+                    type: 'references',
+                });
+            }
+        }
+    }
+    // 扫描类型目录（bugs/refactors/research — 扁平文件）
+    for (const typeDir of ['bugs', 'refactors', 'research']) {
+        const typeDirPath = (0, path_1.join)(specsDir, typeDir);
+        if (!(await (0, fs_extra_1.pathExists)(typeDirPath)))
+            continue;
+        const typeEntries = await (0, fs_extra_1.readdir)(typeDirPath, { withFileTypes: true });
+        for (const te of typeEntries) {
+            if (!te.isFile() || !te.name.endsWith('.md') || (0, task_utils_1.isTimestampBackup)(te.name))
+                continue;
+            const fullPath = (0, path_1.join)(typeDirPath, te.name);
+            const { hash, mtime } = await fileHash(fullPath);
+            const title = await extractTitle(fullPath);
+            const slug = te.name.replace('.md', '');
+            entities.push({
+                id: `SPEC:${typeDir}/${slug}`,
+                type: 'spec',
+                title: title || slug,
+                file: `020-specs/${typeDir}/${te.name}`,
+                hash,
+                mtime,
+                tags: [`${typeDir}-spec`],
+            });
+            // 关联到对应的需求文件（同名匹配）
+            const reqPath = (0, path_1.join)('010-requirements', typeDir, te.name);
+            const matchedReq = entities.find(e => e.file === reqPath);
+            if (matchedReq) {
+                relations.push({
+                    from: `SPEC:${typeDir}/${slug}`,
+                    to: matchedReq.id,
+                    type: 'references',
+                });
+            }
+        }
+    }
     return { entities, relations };
 }
 // ═══════════════════════════════════════════════
@@ -248,6 +326,8 @@ async function scanTasks(iterDir) {
                 continue;
             if (de.name.startsWith('.') || de.name.startsWith('0') || de.name === '_shared' || de.name === '99-artifacts')
                 continue;
+            if ((0, task_utils_1.isTimestampBackup)(de.name))
+                continue;
             const platformTaskMd = (0, path_1.join)(taskPath, de.name, 'TASK.md');
             if (!(await (0, fs_extra_1.pathExists)(platformTaskMd)))
                 continue;
@@ -329,11 +409,12 @@ async function scanUserFiles(iterDir) {
 // ═══════════════════════════════════════════════
 // 关联推断
 // ═══════════════════════════════════════════════
-function inferRelations(entities) {
+async function inferRelations(entities, iterDir) {
     const relations = [];
     const reqs = entities.filter(e => e.type === 'requirement');
     const tasks = entities.filter(e => e.type === 'task');
     const specs = entities.filter(e => e.type === 'spec');
+    const entityMap = new Map(entities.map(e => [e.id, e]));
     // 需求 → 任务：按编号匹配（REQ-001 → Task-001）
     for (const req of reqs) {
         const reqNum = req.id.match(/\d+/)?.[0];
@@ -346,8 +427,76 @@ function inferRelations(entities) {
             }
         }
     }
-    // 规格 → 需求：spec 文件内容中引用了 REQ-xxx
-    // （这里只做结构推断，实际内容分析在 CONTEXT.md 生成时做）
+    // 规格 → 需求：读取 spec 文件内容，提取 REQ-xxx 引用
+    for (const spec of specs) {
+        const specPath = (0, path_1.join)(iterDir, spec.file);
+        try {
+            const content = await (0, fs_extra_1.readFile)(specPath, 'utf-8');
+            const reqRefs = content.match(/REQ-\d+/g);
+            if (reqRefs) {
+                for (const ref of [...new Set(reqRefs)]) {
+                    if (entityMap.has(ref)) {
+                        relations.push({ from: spec.id, to: ref, type: 'specifies' });
+                    }
+                }
+            }
+        }
+        catch { /* 文件不存在或无法读取，跳过 */ }
+    }
+    // 任务 → 需求 / 任务 → 规格：读取任务目录下的 REQ.md 和 TECH.md
+    for (const task of tasks) {
+        const taskAbsDir = (0, path_1.join)(iterDir, task.file);
+        const reqPaths = [
+            (0, path_1.join)(taskAbsDir, '_shared', 'REQ.md'),
+            (0, path_1.join)(taskAbsDir, '00-specs', 'REQ.md'),
+            (0, path_1.join)(taskAbsDir, 'REQ.md'),
+        ];
+        for (const reqPath of reqPaths) {
+            if (!(await (0, fs_extra_1.pathExists)(reqPath)))
+                continue;
+            try {
+                const content = await (0, fs_extra_1.readFile)(reqPath, 'utf-8');
+                // 提取 REQ-xxx 引用 → task implements req
+                const reqRefs = content.match(/REQ-\d+/g);
+                if (reqRefs) {
+                    for (const ref of [...new Set(reqRefs)]) {
+                        if (entityMap.has(ref) && !relations.some(r => r.from === task.id && r.to === ref && r.type === 'implements')) {
+                            relations.push({ from: task.id, to: ref, type: 'implements' });
+                        }
+                    }
+                }
+                // 提取 SPEC:xxx 引用 → task references spec
+                const specRefs = content.match(/SPEC:[\w\/\-]+/g);
+                if (specRefs) {
+                    for (const ref of [...new Set(specRefs)]) {
+                        if (entityMap.has(ref) && !relations.some(r => r.from === task.id && r.to === ref && r.type === 'references')) {
+                            relations.push({ from: task.id, to: ref, type: 'references' });
+                        }
+                    }
+                }
+            }
+            catch { /* 跳过 */ }
+            break; // 只读第一个存在的
+        }
+        // 读取 API_CONTRACT.yaml 解析依赖
+        const contractPath = (0, path_1.join)(taskAbsDir, '_shared', 'API_CONTRACT.yaml');
+        if (await (0, fs_extra_1.pathExists)(contractPath)) {
+            try {
+                const content = await (0, fs_extra_1.readFile)(contractPath, 'utf-8');
+                // 提取依赖的任务引用: dependsOn: Task-xxx 或 # Depends on Task-xxx
+                const depRefs = content.match(/(?:dependsOn|depends on|依赖)\s*[:：]\s*(Task-\S+)/gi);
+                if (depRefs) {
+                    for (const raw of depRefs) {
+                        const m = raw.match(/(Task-\S+)/i);
+                        if (m && entityMap.has(m[1]) && !relations.some(r => r.from === task.id && r.to === m[1] && r.type === 'depends_on')) {
+                            relations.push({ from: task.id, to: m[1], type: 'depends_on' });
+                        }
+                    }
+                }
+            }
+            catch { /* 跳过 */ }
+        }
+    }
     return relations;
 }
 // ═══════════════════════════════════════════════
@@ -371,22 +520,35 @@ async function buildKnowledgeGraph(cwd, iteration) {
     const specResult = await scanSpecs(iterDir);
     const taskResult = await scanTasks(iterDir);
     const userFiles = await scanUserFiles(iterDir);
-    // 合并实体
+    // 合并实体（处理 ID 冲突：同名实体用路径前缀去重）
     const allEntities = [
         ...reqResult.entities,
         ...specResult.entities,
         ...taskResult.entities,
         ...userFiles,
     ];
+    const idRemap = new Map();
     for (const e of allEntities) {
+        let finalId = e.id;
+        if (graph.entities[e.id]) {
+            finalId = `${e.id}@${e.file.replace(/\//g, '-')}`;
+            idRemap.set(e.id, finalId);
+        }
+        e.id = finalId;
         graph.entities[e.id] = e;
     }
+    // 同步更新已有关系中的旧 ID
+    const remapId = (id) => idRemap.get(id) || id;
+    for (const r of [...reqResult.relations, ...specResult.relations, ...taskResult.relations]) {
+        r.from = remapId(r.from);
+        r.to = remapId(r.to);
+    }
     // 合并关系
     graph.relations = [
         ...reqResult.relations,
         ...specResult.relations,
         ...taskResult.relations,
-        ...inferRelations(allEntities),
+        ...(await inferRelations(allEntities, iterDir)),
     ];
     // 统计
     graph.stats = {
@@ -408,13 +570,24 @@ async function saveKnowledgeGraph(cwd, graph) {
     return filePath;
 }
 /** 加载已存在的知识图谱 */
+/**
+ * 加载知识图谱（带进程缓存）
+ * 文件 mtime 未变时直接返回缓存，避免重复 JSON 解析
+ */
 async function loadKnowledgeGraph(cwd) {
     const filePath = (0, path_1.join)(cwd, '.speccore', 'cache', 'knowledge-graph.json');
     if (!(await (0, fs_extra_1.pathExists)(filePath)))
         return null;
     try {
+        const st = await (0, fs_extra_1.stat)(filePath);
+        const cached = kgCache.get(filePath);
+        if (cached && cached.mtime >= st.mtimeMs) {
+            return cached.graph;
+        }
         const content = await (0, fs_extra_1.readFile)(filePath, 'utf-8');
-        return JSON.parse(content);
+        const graph = JSON.parse(content);
+        kgCache.set(filePath, { graph, mtime: st.mtimeMs });
+        return graph;
     }
     catch {
         return null;
@@ -424,35 +597,95 @@ async function loadKnowledgeGraph(cwd) {
 function getTaskContext(graph, taskId) {
     const entity = graph.entities[taskId];
     if (!entity) {
-        return { requirement: null, siblingSubtasks: [], parentTask: null };
+        return { requirement: null, siblingSubtasks: [], parentTask: null, relatedSpecs: [], dependsOn: [] };
     }
     let requirement = null;
     let parentTask = null;
-    const siblingSubtasks = [];
-    // 找上游需求
+    const relatedSpecs = [];
+    const dependsOn = [];
+    // 预建索引：避免多次遍历全量关系
+    const parentIndex = new Map();
+    for (const e of Object.values(graph.entities)) {
+        if (e.type === 'subtask' && e.parentTaskId) {
+            const list = parentIndex.get(e.parentTaskId) || [];
+            list.push(e);
+            parentIndex.set(e.parentTaskId, list);
+        }
+    }
+    // 找上游需求、关联规格、依赖任务
     for (const rel of graph.relations) {
-        if (rel.from === taskId && rel.type === 'implements') {
-            requirement = graph.entities[rel.to] || null;
+        if (rel.from === taskId) {
+            if (rel.type === 'implements')
+                requirement = graph.entities[rel.to] || null;
+            if (rel.type === 'references') {
+                const spec = graph.entities[rel.to];
+                if (spec)
+                    relatedSpecs.push(spec);
+            }
+            if (rel.type === 'depends_on') {
+                const dep = graph.entities[rel.to];
+                if (dep)
+                    dependsOn.push(dep);
+            }
+            if (rel.type === 'subtask_of')
+                parentTask = graph.entities[rel.to] || null;
         }
-        if (rel.from === taskId && rel.type === 'subtask_of') {
-            parentTask = graph.entities[rel.to] || null;
+    }
+    // 子任务没有直接 implements 关系 → 通过父任务找上游需求
+    if (!requirement && parentTask) {
+        for (const rel of graph.relations) {
+            if (rel.from === parentTask.id && rel.type === 'implements') {
+                requirement = graph.entities[rel.to] || null;
+                break;
+            }
         }
     }
-    // 如果是子任务，找兄弟子任务
+    // 如果是子任务，找兄弟子任务（用索引，O(1)）
+    const siblingSubtasks = [];
     const parentId = entity.parentTaskId || parentTask?.id;
     if (parentId) {
-        for (const e of Object.values(graph.entities)) {
-            if (e.type === 'subtask' && e.parentTaskId === parentId) {
-                siblingSubtasks.push(e);
-            }
-        }
+        const siblings = parentIndex.get(parentId);
+        if (siblings)
+            siblingSubtasks.push(...siblings);
     }
-    return { requirement, siblingSubtasks, parentTask };
+    return { requirement, siblingSubtasks, parentTask, relatedSpecs, dependsOn };
 }
 // ═══════════════════════════════════════════════
 // 自动更新机制
 // ═══════════════════════════════════════════════
-/** 检查知识图谱是否已过期 */
+/**
+ * 递归获取目录下所有文件的最新 mtime
+ * 限制：每个目录最多检查 MAX_FILES_PER_DIR 个文件，避免大型项目阻塞
+ */
+const MAX_FILES_PER_DIR = 100;
+async function getLatestMtime(dir, fileCount = { value: 0 }) {
+    if (!(await (0, fs_extra_1.pathExists)(dir)))
+        return 0;
+    let latest = 0;
+    const items = await (0, fs_extra_1.readdir)(dir, { withFileTypes: true });
+    for (const item of items) {
+        if (item.name.startsWith('.') || (0, task_utils_1.isTimestampBackup)(item.name))
+            continue;
+        if (fileCount.value >= MAX_FILES_PER_DIR)
+            break;
+        const fullPath = (0, path_1.join)(dir, item.name);
+        const st = await (0, fs_extra_1.stat)(fullPath);
+        if (item.isDirectory()) {
+            if (item.name === 'node_modules' || item.name === 'cache')
+                continue;
+            const subLatest = await getLatestMtime(fullPath, fileCount);
+            if (subLatest > latest)
+                latest = subLatest;
+        }
+        else {
+            fileCount.value++;
+            if (st.mtimeMs > latest)
+                latest = st.mtimeMs;
+        }
+    }
+    return latest;
+}
+/** 检查知识图谱是否已过期（带 500ms 超时保护） */
 async function isGraphStale(cwd, iteration) {
     const graph = await loadKnowledgeGraph(cwd);
     if (!graph)
@@ -461,23 +694,23 @@ async function isGraphStale(cwd, iteration) {
     const iterDir = await (0, context_1.getIterationDir)(iterName);
     if (!iterDir)
         return false;
-    const { stat } = await Promise.resolve().then(() => __importStar(require('fs-extra')));
     const graphTime = new Date(graph.generated).getTime();
-    // 检查关键目录的最新修改时间
+    // 递归检查目录下所有文件的最新 mtime（目录 mtime 只在增删文件时变）
     const dirsToCheck = [
         (0, path_1.join)(iterDir, '010-requirements'),
         (0, path_1.join)(iterDir, '020-specs'),
         (0, path_1.join)(iterDir, '030-tasks'),
     ];
     for (const dir of dirsToCheck) {
-        if (!(await Promise.resolve().then(() => __importStar(require('fs-extra')))).pathExists(dir))
+        // 超时保护：单目录扫描超过 200ms 就放弃
+        const start = Date.now();
+        const latestMtime = await getLatestMtime(dir);
+        if (Date.now() - start > 200) {
+            logger_1.logger.debug(`isGraphStale: ${dir} 扫描超时，假设未过期`);
             continue;
-        try {
-            const st = await stat(dir);
-            if (st.mtimeMs > graphTime)
-                return true;
         }
-        catch { /* ignore */ }
+        if (latestMtime > graphTime)
+            return true;
     }
     return false;
 }