speccore 8.3.121 → 8.3.127

package/dist/core/knowledge-graph.js

@@ -46,6 +46,7 @@ exports.getTaskContext = getTaskContext;
 exports.isGraphStale = isGraphStale;
 exports.incrementalUpdateKnowledgeGraph = incrementalUpdateKnowledgeGraph;
 exports.refreshKnowledgeGraph = refreshKnowledgeGraph;
+exports.loadFreshKnowledgeGraph = loadFreshKnowledgeGraph;
 exports.traceDependencyChain = traceDependencyChain;
 exports.getFullTaskContext = getFullTaskContext;
 const fs_extra_1 = require("fs-extra");
@@ -309,113 +310,136 @@ async function scanBusinessCodeMappings(iterDir) {
     const specsDir = (0, path_1.join)(iterDir, '020-specs');
     if (!(await (0, fs_extra_1.pathExists)(specsDir)))
         return { entities, relations };
-    // 扫描各端子目录
-    const knownNonPlatformDirs = new Set(['sources', 'assets', 'prototypes', 'converted', 'features', 'bugs', 'refactors', 'research', 'staging', 'platforms', 'snapshots', 'global']);
+    // v8.3.122+: 同时兼容新旧两种路径结构
+    // 新结构: 020-specs/{feature}/{platform}/TECH.md
+    // 旧结构: 020-specs/{platform}/TECH.md
+    const knownNonPlatformDirs = new Set(['sources', 'assets', 'prototypes', 'converted', 'features', 'bugs', 'refactors', 'research', 'staging', 'platforms', 'snapshots', 'global', 'overview', 'requirements']);
     const specsEntries = await (0, fs_extra_1.readdir)(specsDir, { withFileTypes: true });
-    for (const e of specsEntries) {
-        if (!e.isDirectory() || e.name.startsWith('_') || e.name.startsWith('.') || knownNonPlatformDirs.has(e.name))
+    for (const featureEntry of specsEntries) {
+        if (!featureEntry.isDirectory() || featureEntry.name.startsWith('_') || featureEntry.name.startsWith('.') || knownNonPlatformDirs.has(featureEntry.name))
             continue;
-        const platformName = e.name;
-        const techMdPath = (0, path_1.join)(specsDir, platformName, 'TECH.md');
-        if (!(await (0, fs_extra_1.pathExists)(techMdPath)))
+        const featureName = featureEntry.name;
+        const featureDir = (0, path_1.join)(specsDir, featureName);
+        // 检测是旧结构（直接有 TECH.md）还是新结构（有子目录）
+        const hasTechMdDirectly = await (0, fs_extra_1.pathExists)((0, path_1.join)(featureDir, 'TECH.md'));
+        if (hasTechMdDirectly) {
+            // 旧结构: 020-specs/{platform}/TECH.md — 把 featureName 当成 platformName
+            await processTechMdForMappings(featureDir, featureName, '', entities, relations);
+        }
+        else {
+            // 新结构: 020-specs/{feature}/{platform}/TECH.md
+            const platformEntries = await (0, fs_extra_1.readdir)(featureDir, { withFileTypes: true }).catch(() => []);
+            for (const platformEntry of platformEntries) {
+                if (!platformEntry.isDirectory() || platformEntry.name.startsWith('.') || knownNonPlatformDirs.has(platformEntry.name))
+                    continue;
+                const platformDir = (0, path_1.join)(featureDir, platformEntry.name);
+                await processTechMdForMappings(platformDir, platformEntry.name, featureName, entities, relations);
+            }
+        }
+    }
+    return { entities, relations };
+}
+/** 从单个 TECH.md 中提取业务-代码映射 */
+async function processTechMdForMappings(dir, platformName, featureName, entities, relations) {
+    const techMdPath = (0, path_1.join)(dir, 'TECH.md');
+    if (!(await (0, fs_extra_1.pathExists)(techMdPath)))
+        return;
+    const content = await (0, fs_extra_1.readFile)(techMdPath, 'utf-8').catch(() => '');
+    if (!content)
+        return;
+    // 查找「业务-代码映射」章节
+    const mappingSectionMatch = content.match(/##\s+业务-代码映射[\s\S]*?(?=\n##\s|$)/i);
+    if (!mappingSectionMatch)
+        return;
+    const sectionContent = mappingSectionMatch[0];
+    const lines = sectionContent.split(/\r?\n/);
+    let inTable = false;
+    let headerParsed = false;
+    let colIndices = { module: -1, entity: -1, relation: -1, desc: -1 };
+    const seenModules = new Set();
+    for (const line of lines) {
+        const cells = line.split('|').map(c => c.trim()).filter(Boolean);
+        if (cells.length < 2)
             continue;
-        const content = await (0, fs_extra_1.readFile)(techMdPath, 'utf-8').catch(() => '');
-        if (!content)
+        if (!headerParsed && cells.some(c => c.includes('业务模块') || c.includes('代码实体'))) {
+            colIndices = {
+                module: cells.findIndex(c => c.includes('业务模块')),
+                entity: cells.findIndex(c => c.includes('代码实体')),
+                relation: cells.findIndex(c => c.includes('关系类型')),
+                desc: cells.findIndex(c => c.includes('说明')),
+            };
+            if (colIndices.module < 0)
+                colIndices.module = 0;
+            if (colIndices.entity < 0)
+                colIndices.entity = 1;
+            headerParsed = true;
+            inTable = true;
             continue;
-        // 查找「业务-代码映射」章节（不用 m 标志，$ 仅匹配字符串末尾）
-        const mappingSectionMatch = content.match(/##\s+业务-代码映射[\s\S]*?(?=\n##\s|$)/i);
-        if (!mappingSectionMatch)
+        }
+        if (cells.every(c => /^[-:]+$/.test(c)))
             continue;
-        const sectionContent = mappingSectionMatch[0];
-        // 解析表格
-        const lines = sectionContent.split(/\r?\n/);
-        let inTable = false;
-        let headerParsed = false;
-        let colIndices = { module: -1, entity: -1, relation: -1, desc: -1 };
-        // 用于去重的业务模块集合
-        const seenModules = new Set();
-        for (const line of lines) {
-            const cells = line.split('|').map(c => c.trim()).filter(Boolean);
-            if (cells.length < 2)
-                continue;
-            // 表头行
-            if (!headerParsed && cells.some(c => c.includes('业务模块') || c.includes('代码实体'))) {
-                colIndices = {
-                    module: cells.findIndex(c => c.includes('业务模块')),
-                    entity: cells.findIndex(c => c.includes('代码实体')),
-                    relation: cells.findIndex(c => c.includes('关系类型')),
-                    desc: cells.findIndex(c => c.includes('说明')),
-                };
-                if (colIndices.module < 0)
-                    colIndices.module = 0;
-                if (colIndices.entity < 0)
-                    colIndices.entity = 1;
-                headerParsed = true;
-                inTable = true;
-                continue;
-            }
-            // 分隔行跳过
-            if (cells.every(c => /^[-:]+$/.test(c)))
-                continue;
-            if (!inTable || !headerParsed)
-                continue;
-            // 数据行
-            const moduleName = cells[colIndices.module];
-            const codeEntity = cells[colIndices.entity];
-            const relationType = colIndices.relation >= 0 && colIndices.relation < cells.length ? cells[colIndices.relation] : 'maps_to';
-            const desc = colIndices.desc >= 0 && colIndices.desc < cells.length ? cells[colIndices.desc] : '';
-            if (!moduleName || !codeEntity)
-                continue;
-            if (moduleName === '业务模块' || moduleName === '#')
-                continue;
-            // 创建业务模块实体（去重）
-            const bizModuleId = `biz:${platformName}:${moduleName}`;
-            if (!seenModules.has(bizModuleId)) {
-                seenModules.add(bizModuleId);
-                entities.push({
-                    id: bizModuleId,
-                    type: 'business_module',
-                    title: moduleName,
-                    file: `020-specs/${platformName}/TECH.md`,
-                    hash: '',
-                    mtime: '',
-                    platform: platformName,
-                    businessModule: moduleName,
-                    tags: ['business-mapping'],
-                });
-                // 关联到对应的 spec 实体
-                const specId = `SPEC:${platformName}/TECH`;
-                relations.push({
-                    from: bizModuleId,
-                    to: specId,
-                    type: 'elaborates',
-                    metadata: { source: 'tech-md-mapping' },
-                });
-            }
-            // 创建代码实体（作为 business_module 的关联目标）
-            const codeEntityId = `code:${platformName}:${codeEntity.replace(/[/\\]/g, '-')}`;
-            if (!entities.find(e => e.id === codeEntityId)) {
-                entities.push({
-                    id: codeEntityId,
-                    type: 'source-file',
-                    title: codeEntity,
-                    file: codeEntity,
-                    hash: '',
-                    mtime: '',
-                    platform: platformName,
-                    tags: ['code-entity', relationType],
-                });
-            }
-            // 创建关系
+        if (!inTable || !headerParsed)
+            continue;
+        const moduleName = cells[colIndices.module];
+        const codeEntity = cells[colIndices.entity];
+        const relationType = colIndices.relation >= 0 && colIndices.relation < cells.length ? cells[colIndices.relation] : 'maps_to';
+        const desc = colIndices.desc >= 0 && colIndices.desc < cells.length ? cells[colIndices.desc] : '';
+        if (!moduleName || !codeEntity)
+            continue;
+        if (moduleName === '业务模块' || moduleName === '#')
+            continue;
+        // v8.3.122+: bizModuleId 包含 featureName 避免跨模块冲突
+        const bizModuleId = featureName
+            ? `biz:${featureName}:${platformName}:${moduleName}`
+            : `biz:${platformName}:${moduleName}`;
+        const filePath = featureName
+            ? `020-specs/${featureName}/${platformName}/TECH.md`
+            : `020-specs/${platformName}/TECH.md`;
+        const specId = featureName
+            ? `SPEC:${featureName}/${platformName}/TECH`
+            : `SPEC:${platformName}/TECH`;
+        if (!seenModules.has(bizModuleId)) {
+            seenModules.add(bizModuleId);
+            entities.push({
+                id: bizModuleId,
+                type: 'business_module',
+                title: moduleName,
+                file: filePath,
+                hash: '',
+                mtime: '',
+                platform: platformName,
+                businessModule: moduleName,
+                tags: ['business-mapping'],
+            });
             relations.push({
                 from: bizModuleId,
-                to: codeEntityId,
-                type: relationType || 'maps_to',
-                metadata: { description: desc, source: 'tech-md-mapping' },
+                to: specId,
+                type: 'elaborates',
+                metadata: { source: 'tech-md-mapping' },
+            });
+        }
+        const codeEntityId = featureName
+            ? `code:${featureName}:${platformName}:${codeEntity.replace(/[/\\]/g, '-')}`
+            : `code:${platformName}:${codeEntity.replace(/[/\\]/g, '-')}`;
+        if (!entities.find(e => e.id === codeEntityId)) {
+            entities.push({
+                id: codeEntityId,
+                type: 'source-file',
+                title: codeEntity,
+                file: codeEntity,
+                hash: '',
+                mtime: '',
+                platform: platformName,
+                tags: ['code-entity', relationType],
             });
         }
+        relations.push({
+            from: bizModuleId,
+            to: codeEntityId,
+            type: relationType || 'maps_to',
+            metadata: { description: desc, source: 'tech-md-mapping' },
+        });
     }
-    return { entities, relations };
 }
 // ═══════════════════════════════════════════════════
 // 任务扫描（含子任务）
@@ -509,94 +533,84 @@ async function scanTasks(iterDir) {
             status,
             tags: [type],
         });
-        // 扫描各端子任务（新结构: 10-backend/{service}/{subtask}/ + 20-frontend/{platform}/{subtask}/）
+        // v8.3.121+: 端平铺结构扫描 — {端名}/{子任务}/
+        const EXCLUDE_DIRS = new Set(['00-specs', '_shared', '99-artifacts', '.meta']);
         const dirEntries = await (0, fs_extra_1.readdir)(taskPath, { withFileTypes: true }).catch(() => []);
-        const hasNewStructure = dirEntries.some(de => de.isDirectory() && (de.name === '10-backend' || de.name === '20-frontend'));
-        if (hasNewStructure) {
-            // 新结构：三级嵌套
-            for (const catDir of ['10-backend', '20-frontend']) {
-                const catPath = (0, path_1.join)(taskPath, catDir);
-                if (!(await (0, fs_extra_1.pathExists)(catPath)))
-                    continue;
-                const serviceEntries = await (0, fs_extra_1.readdir)(catPath, { withFileTypes: true }).catch(() => []);
-                for (const svc of serviceEntries) {
-                    if (!svc.isDirectory())
+        for (const de of dirEntries) {
+            if (!de.isDirectory() || de.name.startsWith('.') || EXCLUDE_DIRS.has(de.name))
+                continue;
+            if ((0, task_utils_1.isTimestampBackup)(de.name))
+                continue;
+            const platformPath = (0, path_1.join)(taskPath, de.name);
+            const subtaskEntries = await (0, fs_extra_1.readdir)(platformPath, { withFileTypes: true }).catch(() => []);
+            const hasSubtasks = subtaskEntries.some((se) => se.isDirectory() && !se.name.startsWith('.') && !(0, task_utils_1.isTimestampBackup)(se.name));
+            if (hasSubtasks) {
+                // 标准端平铺结构：{端名}/{子任务}/
+                for (const sub of subtaskEntries) {
+                    if (!sub.isDirectory() || sub.name.startsWith('.') || (0, task_utils_1.isTimestampBackup)(sub.name))
                         continue;
-                    const subEntries = await (0, fs_extra_1.readdir)((0, path_1.join)(catPath, svc.name), { withFileTypes: true }).catch(() => []);
-                    for (const sub of subEntries) {
-                        if (!sub.isDirectory() || sub.name.startsWith('.'))
-                            continue;
-                        const subtaskPath = (0, path_1.join)(catPath, svc.name, sub.name);
-                        const platformLabel = `${svc.name}/${sub.name}`;
-                        const subtaskTaskMd = (0, path_1.join)(subtaskPath, 'TASK.md');
-                        let subTitle = `${title} — ${platformLabel}`;
-                        let subStatus = 'pending';
-                        let subTaskId = `${taskId}-${svc.name}-${sub.name}`;
-                        if (await (0, fs_extra_1.pathExists)(subtaskTaskMd)) {
-                            const subContent = await (0, fs_extra_1.readFile)(subtaskTaskMd, 'utf-8');
-                            const titleMatch = subContent.match(/^#\s+(.+)/m);
-                            if (titleMatch)
-                                subTitle = titleMatch[1].trim().slice(0, 80);
-                            const statusMatch = subContent.match(/\*\*状态\*\*[:\s]*(.+)/);
-                            if (statusMatch) {
-                                const raw = statusMatch[1].trim();
-                                if (raw.includes('已完成') || raw.includes('completed'))
-                                    subStatus = 'completed';
-                                else if (raw.includes('进行中') || raw.includes('in_progress'))
-                                    subStatus = 'in_progress';
-                            }
-                            const subIdMatch = subContent.match(/子任务 ID\*\*[:\s]*`(Task-[^`]+)`/);
-                            if (subIdMatch)
-                                subTaskId = subIdMatch[1];
+                    const subtaskPath = (0, path_1.join)(platformPath, sub.name);
+                    const platformLabel = `${de.name}/${sub.name}`;
+                    const subtaskTaskMd = (0, path_1.join)(subtaskPath, 'TASK.md');
+                    let subTitle = `${title} — ${platformLabel}`;
+                    let subStatus = 'pending';
+                    let subTaskId = `${taskId}-${de.name}-${sub.name}`;
+                    if (await (0, fs_extra_1.pathExists)(subtaskTaskMd)) {
+                        const subContent = await (0, fs_extra_1.readFile)(subtaskTaskMd, 'utf-8');
+                        const titleMatch = subContent.match(/^#\s+(.+)/m);
+                        if (titleMatch)
+                            subTitle = titleMatch[1].trim().slice(0, 80);
+                        const statusMatch = subContent.match(/\*\*状态\*\*[:\s]*(.+)/);
+                        if (statusMatch) {
+                            const raw = statusMatch[1].trim();
+                            if (raw.includes('已完成') || raw.includes('completed'))
+                                subStatus = 'completed';
+                            else if (raw.includes('进行中') || raw.includes('in_progress'))
+                                subStatus = 'in_progress';
                         }
-                        // hash 回退：TASK.md → .meta/status → src/ → 空
-                        let subHash = { hash: '', mtime: '' };
-                        if (await (0, fs_extra_1.pathExists)(subtaskTaskMd)) {
-                            subHash = await fileHash(subtaskTaskMd);
+                        const subIdMatch = subContent.match(/子任务 ID\*\*[:\s]*`(Task-[^`]+)`/);
+                        if (subIdMatch)
+                            subTaskId = subIdMatch[1];
+                    }
+                    // hash 回退：TASK.md → .meta/status → src/ → 空
+                    let subHash = { hash: '', mtime: '' };
+                    if (await (0, fs_extra_1.pathExists)(subtaskTaskMd)) {
+                        subHash = await fileHash(subtaskTaskMd);
+                    }
+                    else {
+                        const metaStatus = (0, path_1.join)(subtaskPath, '.meta', 'status');
+                        if (await (0, fs_extra_1.pathExists)(metaStatus)) {
+                            subHash = await fileHash(metaStatus);
                         }
                         else {
-                            const metaStatus = (0, path_1.join)(subtaskPath, '.meta', 'status');
-                            if (await (0, fs_extra_1.pathExists)(metaStatus)) {
-                                subHash = await fileHash(metaStatus);
-                            }
-                            else {
-                                const srcDir = (0, path_1.join)(subtaskPath, 'src');
-                                if (await (0, fs_extra_1.pathExists)(srcDir)) {
-                                    try {
-                                        const srcFiles = await (0, fs_extra_1.readdir)(srcDir);
-                                        if (srcFiles.length > 0)
-                                            subHash = await fileHash((0, path_1.join)(srcDir, srcFiles[0]));
-                                    }
-                                    catch { /* 忽略 */ }
+                            const srcDir = (0, path_1.join)(subtaskPath, 'src');
+                            if (await (0, fs_extra_1.pathExists)(srcDir)) {
+                                try {
+                                    const srcFiles = await (0, fs_extra_1.readdir)(srcDir);
+                                    if (srcFiles.length > 0)
+                                        subHash = await fileHash((0, path_1.join)(srcDir, srcFiles[0]));
                                 }
+                                catch { /* 忽略 */ }
                             }
                         }
-                        entities.push({
-                            id: subTaskId,
-                            type: 'subtask',
-                            title: subTitle,
-                            file: `030-tasks/${type === 'feature' ? '' : type + '/'}${taskId}/${catDir}/${svc.name}/${sub.name}`,
-                            hash: subHash.hash,
-                            mtime: subHash.mtime,
-                            status: subStatus,
-                            platform: platformLabel,
-                            parentTaskId: taskId,
-                        });
-                        relations.push({ from: subTaskId, to: taskId, type: 'subtask_of' });
                     }
+                    entities.push({
+                        id: subTaskId,
+                        type: 'subtask',
+                        title: subTitle,
+                        file: `030-tasks/${type === 'feature' ? '' : type + '/'}${taskId}/${de.name}/${sub.name}`,
+                        hash: subHash.hash,
+                        mtime: subHash.mtime,
+                        status: subStatus,
+                        platform: platformLabel,
+                        parentTaskId: taskId,
+                    });
+                    relations.push({ from: subTaskId, to: taskId, type: 'subtask_of' });
                 }
             }
-        }
-        else {
-            // 旧结构：扁平平台目录
-            for (const de of dirEntries) {
-                if (!de.isDirectory())
-                    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');
+            else {
+                // 兼容：端目录下无子任务，端本身作为子任务（如旧数据的单端任务）
+                const platformTaskMd = (0, path_1.join)(platformPath, 'TASK.md');
                 let subTitle = `${title} — ${de.name}`;
                 let subStatus = 'pending';
                 let subTaskId = `${taskId}-${de.name}`;
@@ -622,7 +636,7 @@ async function scanTasks(iterDir) {
                     subHash = await fileHash(platformTaskMd);
                 }
                 else {
-                    const srcDir = (0, path_1.join)(taskPath, de.name, 'src');
+                    const srcDir = (0, path_1.join)(platformPath, 'src');
                     if (await (0, fs_extra_1.pathExists)(srcDir)) {
                         try {
                             const srcFiles = await (0, fs_extra_1.readdir)(srcDir);
@@ -1017,41 +1031,10 @@ async function scanTaskSpecs(iterDir) {
     const taskDirs = await findTaskDirs(tasksDir);
     for (const taskDir of taskDirs) {
         const taskId = (0, path_1.basename)(taskDir) || '';
-        const subDirs = ['_shared', '00-specs'];
-        // 新结构: 10-backend/{service}/{subtask}/ + 20-frontend/{platform}/{subtask}/
-        const nestedSubDirs = [];
-        try {
-            const entries = await (0, fs_extra_1.readdir)(taskDir, { withFileTypes: true });
-            for (const e of entries) {
-                if (!e.isDirectory() || e.name.startsWith('.') || (0, task_utils_1.isTimestampBackup)(e.name))
-                    continue;
-                if (e.name === '10-backend' || e.name === '20-frontend') {
-                    // 新结构：深入两层（service/platform → subtask）
-                    const catPath = (0, path_1.join)(taskDir, e.name);
-                    try {
-                        const svcEntries = await (0, fs_extra_1.readdir)(catPath, { withFileTypes: true });
-                        for (const svc of svcEntries) {
-                            if (!svc.isDirectory())
-                                continue;
-                            const subEntries = await (0, fs_extra_1.readdir)((0, path_1.join)(catPath, svc.name), { withFileTypes: true });
-                            for (const sub of subEntries) {
-                                if (!sub.isDirectory() || sub.name.startsWith('.'))
-                                    continue;
-                                nestedSubDirs.push(`${e.name}/${svc.name}/${sub.name}`);
-                            }
-                        }
-                    }
-                    catch { /* 跳过 */ }
-                }
-                else if (!e.name.startsWith('0') && e.name !== '_shared' && e.name !== '99-artifacts') {
-                    // 旧结构：扁平平台目录
-                    subDirs.push(e.name);
-                }
-            }
-        }
-        catch { /* 跳过 */ }
-        // 扫描任务根下的子目录（_shared/、00-specs/、旧平台目录）
-        for (const subDir of subDirs) {
+        // v8.3.121+: 端平铺结构扫描 — {端名}/{子任务}/
+        const EXCLUDE_DIRS = new Set(['00-specs', '_shared', '99-artifacts', '.meta']);
+        // 扫描任务根下的规格目录（_shared/、00-specs/）
+        for (const subDir of ['_shared', '00-specs']) {
             const specDir = (0, path_1.join)(taskDir, subDir);
             if (!(await (0, fs_extra_1.pathExists)(specDir)))
                 continue;
@@ -1074,31 +1057,44 @@ async function scanTaskSpecs(iterDir) {
                 relations.push({ from: `TSPEC:${taskId}-${subDir}-${specType}`, to: taskId, type: 'elaborates' });
             }
         }
-        // 扫描新结构的子任务目录（10-backend/svc/sub/、20-frontend/plat/sub/）
-        for (const nestedDir of nestedSubDirs) {
-            const specDir = (0, path_1.join)(taskDir, nestedDir);
-            if (!(await (0, fs_extra_1.pathExists)(specDir)))
-                continue;
-            for (const specFile of TASK_SPEC_FILES) {
-                const specPath = (0, path_1.join)(specDir, specFile);
-                if (!(await (0, fs_extra_1.pathExists)(specPath)))
+        // 扫描端平铺结构下的子任务规格文件
+        try {
+            const platformEntries = await (0, fs_extra_1.readdir)(taskDir, { withFileTypes: true });
+            for (const pe of platformEntries) {
+                if (!pe.isDirectory() || pe.name.startsWith('.') || EXCLUDE_DIRS.has(pe.name))
                     continue;
-                const { hash, mtime } = await fileHash(specPath);
-                const title = await extractTitle(specPath);
-                const specType = specFile.replace('.md', '').toLowerCase();
-                const label = nestedDir.replace(/\//g, '-');
-                entities.push({
-                    id: `TSPEC:${taskId}-${label}-${specType}`,
-                    type: 'task-spec',
-                    title: title || `${taskId}/${nestedDir}/${specFile}`,
-                    file: `030-tasks/**/${taskId}/${nestedDir}/${specFile}`,
-                    hash,
-                    mtime,
-                    tags: ['task-spec', specType, label],
-                });
-                relations.push({ from: `TSPEC:${taskId}-${label}-${specType}`, to: taskId, type: 'elaborates' });
+                if ((0, task_utils_1.isTimestampBackup)(pe.name))
+                    continue;
+                const platformPath = (0, path_1.join)(taskDir, pe.name);
+                const subtaskEntries = await (0, fs_extra_1.readdir)(platformPath, { withFileTypes: true });
+                for (const sub of subtaskEntries) {
+                    if (!sub.isDirectory() || sub.name.startsWith('.') || (0, task_utils_1.isTimestampBackup)(sub.name))
+                        continue;
+                    const subtaskPath = (0, path_1.join)(platformPath, sub.name);
+                    const nestedDir = `${pe.name}/${sub.name}`;
+                    const label = `${pe.name}-${sub.name}`;
+                    for (const specFile of TASK_SPEC_FILES) {
+                        const specPath = (0, path_1.join)(subtaskPath, specFile);
+                        if (!(await (0, fs_extra_1.pathExists)(specPath)))
+                            continue;
+                        const { hash, mtime } = await fileHash(specPath);
+                        const title = await extractTitle(specPath);
+                        const specType = specFile.replace('.md', '').toLowerCase();
+                        entities.push({
+                            id: `TSPEC:${taskId}-${label}-${specType}`,
+                            type: 'task-spec',
+                            title: title || `${taskId}/${nestedDir}/${specFile}`,
+                            file: `030-tasks/**/${taskId}/${nestedDir}/${specFile}`,
+                            hash,
+                            mtime,
+                            tags: ['task-spec', specType, label],
+                        });
+                        relations.push({ from: `TSPEC:${taskId}-${label}-${specType}`, to: taskId, type: 'elaborates' });
+                    }
+                }
             }
         }
+        catch { /* 跳过 */ }
     }
     return { entities, relations };
 }
@@ -1812,6 +1808,24 @@ async function incrementalUpdateKnowledgeGraph(cwd, iteration) {
 async function refreshKnowledgeGraph(cwd, iteration) {
     return incrementalUpdateKnowledgeGraph(cwd, iteration);
 }
+/** v8.3.125+: 加载知识图谱（自动检查过期并刷新） */
+async function loadFreshKnowledgeGraph(cwd, iteration) {
+    let graph = await loadKnowledgeGraph(cwd);
+    if (!graph)
+        return null;
+    try {
+        const stale = await isGraphStale(cwd, iteration);
+        if (stale) {
+            graph = await refreshKnowledgeGraph(cwd, iteration);
+            if (graph)
+                logger_1.logger?.info?.('🧠 知识图谱已自动刷新（检测到变更）');
+        }
+    }
+    catch {
+        // 过期检查失败不阻断，使用现有图谱
+    }
+    return graph;
+}
 /**
  * 追踪任务的完整依赖链路（向上追溯）
  * 递归追踪 implements → references → depends_on 关系