autosnippet 3.0.0 → 3.0.2

package/lib/external/mcp/handlers/bootstrap/pipeline/orchestrator.js

@@ -11,19 +11,19 @@
  * @module pipeline/orchestrator
  */
 
-import path from 'node:path';
 import fs from 'node:fs/promises';
+import path from 'node:path';
+import Logger from '../../../../../infrastructure/logging/Logger.js';
 import { AnalystAgent } from '../../../../../service/chat/AnalystAgent.js';
+import { EpisodicConsolidator } from '../../../../../service/chat/EpisodicConsolidator.js';
 import { ProducerAgent } from '../../../../../service/chat/ProducerAgent.js';
-import { TierScheduler } from './tier-scheduler.js';
+import { ProjectSemanticMemory } from '../../../../../service/chat/ProjectSemanticMemory.js';
+import { WorkingMemory } from '../../../../../service/chat/WorkingMemory.js';
 import { DimensionContext, parseDimensionDigest } from './dimension-context.js';
 import { EpisodicMemory } from './EpisodicMemory.js';
-import { ToolResultCache } from './ToolResultCache.js';
-import { WorkingMemory } from '../../../../../service/chat/WorkingMemory.js';
-import { ProjectSemanticMemory } from '../../../../../service/chat/ProjectSemanticMemory.js';
-import { EpisodicConsolidator } from '../../../../../service/chat/EpisodicConsolidator.js';
 import { IncrementalBootstrap } from './IncrementalBootstrap.js';
-import Logger from '../../../../../infrastructure/logging/Logger.js';
+import { ToolResultCache } from './ToolResultCache.js';
+import { TierScheduler } from './tier-scheduler.js';
 
 const logger = Logger.getInstance();
 
@@ -47,7 +47,7 @@ async function saveDimensionCheckpoint(projectRoot, sessionId, dimId, result, di
     await fs.mkdir(checkpointDir, { recursive: true });
     await fs.writeFile(
       path.join(checkpointDir, `${dimId}.json`),
-      JSON.stringify({ dimId, sessionId, ...result, digest, completedAt: Date.now() }),
+      JSON.stringify({ dimId, sessionId, ...result, digest, completedAt: Date.now() })
     );
   } catch (err) {
     logger.warn(`[Bootstrap-v3] checkpoint save failed for "${dimId}": ${err.message}`);
@@ -66,16 +66,22 @@ async function loadCheckpoints(projectRoot) {
     const files = await fs.readdir(checkpointDir).catch(() => []);
     const now = Date.now();
     for (const file of files) {
-      if (!file.endsWith('.json')) continue;
+      if (!file.endsWith('.json')) {
+        continue;
+      }
       try {
         const content = await fs.readFile(path.join(checkpointDir, file), 'utf-8');
         const data = JSON.parse(content);
-        if (data.completedAt && (now - data.completedAt) < CHECKPOINT_TTL_MS) {
+        if (data.completedAt && now - data.completedAt < CHECKPOINT_TTL_MS) {
           checkpoints.set(data.dimId, data);
         }
-      } catch { /* skip corrupt checkpoint */ }
+      } catch {
+        /* skip corrupt checkpoint */
+      }
     }
-  } catch { /* checkpoint dir doesn't exist */ }
+  } catch {
+    /* checkpoint dir doesn't exist */
+  }
   return checkpoints;
 }
 
@@ -87,7 +93,9 @@ async function clearCheckpoints(projectRoot) {
   try {
     const checkpointDir = path.join(projectRoot, '.autosnippet', 'bootstrap-checkpoint');
     await fs.rm(checkpointDir, { recursive: true, force: true });
-  } catch { /* ignore */ }
+  } catch {
+    /* ignore */
+  }
 }
 
 // ──────────────────────────────────────────────────────────────────
@@ -98,11 +106,7 @@ const DIMENSION_CONFIGS_V3 = {
   'project-profile': {
     label: '项目概貌',
     guide: '分析项目的整体结构、技术栈、模块划分和入口点。',
-    focusAreas: [
-      '项目结构和模块划分',
-      '技术栈和框架依赖',
-      '核心入口点和启动流程',
-    ],
+    focusAreas: ['项目结构和模块划分', '技术栈和框架依赖', '核心入口点和启动流程'],
     outputType: 'dual',
     allowedKnowledgeTypes: ['architecture'],
   },
@@ -140,7 +144,7 @@ const DIMENSION_CONFIGS_V3 = {
     outputType: 'dual',
     allowedKnowledgeTypes: ['code-standard', 'code-style'],
   },
-  'architecture': {
+  architecture: {
     label: '架构模式',
     guide: '分析项目的分层架构、模块职责和依赖关系。',
     focusAreas: [
@@ -200,6 +204,57 @@ const DIMENSION_CONFIGS_V3 = {
     outputType: 'skill',
     allowedKnowledgeTypes: ['boundary-constraint', 'code-standard'],
   },
+
+  // ── 语言条件维度（v3.1: 多语言支持）──────────────────────
+
+  'module-export-scan': {
+    label: '模块导出分析',
+    guide: '分析 TS/JS 模块的导出结构和 public API surface。',
+    focusAreas: [
+      'barrel export 结构和 re-export 链路',
+      'public API surface 合规性',
+      'tree-shaking 兼容性',
+      '循环依赖检测',
+    ],
+    outputType: 'dual',
+    allowedKnowledgeTypes: ['code-standard', 'architecture'],
+  },
+  'framework-convention-scan': {
+    label: '框架约定扫描',
+    guide: '分析前端框架约定（组件结构、状态管理、路由）。',
+    focusAreas: [
+      '组件目录结构和命名约定',
+      '状态管理模式 (Redux/Vuex/Pinia/Zustand)',
+      '路由约定和数据获取模式',
+      '样式约定 (CSS Module/Tailwind/CSS-in-JS)',
+    ],
+    outputType: 'dual',
+    allowedKnowledgeTypes: ['code-standard', 'architecture'],
+  },
+  'python-package-scan': {
+    label: 'Python 包结构分析',
+    guide: '分析 Python 包的导入风格、类型标注和 __init__.py 策略。',
+    focusAreas: [
+      '__init__.py 导出策略和 __all__ 定义',
+      '相对/绝对导入风格',
+      'type hints 覆盖率和 Protocol 使用',
+      'decorator 使用模式',
+    ],
+    outputType: 'dual',
+    allowedKnowledgeTypes: ['code-standard', 'architecture'],
+  },
+  'jvm-annotation-scan': {
+    label: '注解/Annotation 扫描',
+    guide: '扫描 Java/Kotlin 项目中的 DI、ORM、API 注解使用模式。',
+    focusAreas: [
+      'DI 注解 (@Inject/@Autowired/@Component)',
+      'ORM 注解 (@Entity/@Table/@Column)',
+      'API 注解 (@RestController/@RequestMapping)',
+      '自定义注解和元编程模式',
+    ],
+    outputType: 'dual',
+    allowedKnowledgeTypes: ['code-pattern', 'architecture'],
+  },
 };
 
 // ──────────────────────────────────────────────────────────────────
@@ -251,7 +306,7 @@ function buildTierReflection(tierIndex, tierResults, episodicMemory) {
       }
     }
     // 统计关键词
-    const words = (f.finding || '').split(/[\s,，。.]+/).filter(w => w.length > 3);
+    const words = (f.finding || '').split(/[\s,，。.]+/).filter((w) => w.length > 3);
     for (const w of words) {
       keywordMentions[w] = (keywordMentions[w] || 0) + 1;
     }
@@ -262,18 +317,14 @@ function buildTierReflection(tierIndex, tierResults, episodicMemory) {
   // 多维度引用的文件 = 跨维度热点
   for (const [file, count] of Object.entries(fileMentions)) {
     if (count >= 2) {
-      crossDimensionPatterns.push(
-        `文件 "${file}" 被 ${count} 个维度引用 — 可能是系统核心组件`
-      );
+      crossDimensionPatterns.push(`文件 "${file}" 被 ${count} 个维度引用 — 可能是系统核心组件`);
     }
   }
 
   // 多维度提及的关键词
   for (const [word, count] of Object.entries(keywordMentions)) {
     if (count >= 3) {
-      crossDimensionPatterns.push(
-        `关键词 "${word}" 出现 ${count} 次 — 跨维度关联主题`
-      );
+      crossDimensionPatterns.push(`关键词 "${word}" 出现 ${count} 次 — 跨维度关联主题`);
     }
   }
 
@@ -324,14 +375,22 @@ function buildTierReflection(tierIndex, tierResults, episodicMemory) {
  */
 export async function fillDimensionsV3(fillContext) {
   const {
-    ctx, dimensions, taskManager, sessionId, projectRoot,
-    depGraphData, guardAudit, langStats, primaryLang, astProjectSummary,
-    skillContext, skillsEnhanced,
-    incrementalPlan,   // v5.0: 增量 Bootstrap 计划 (from bootstrap.js)
+    ctx,
+    dimensions,
+    taskManager,
+    sessionId,
+    projectRoot,
+    depGraphData,
+    guardAudit,
+    primaryLang,
+    astProjectSummary,
+    incrementalPlan, // v5.0: 增量 Bootstrap 计划 (from bootstrap.js)
   } = fillContext;
 
   const isIncremental = incrementalPlan?.canIncremental && incrementalPlan?.mode === 'incremental';
-  logger.info(`[Bootstrap-v3] ═══ fillDimensionsV3 entered — ${isIncremental ? 'INCREMENTAL' : 'FULL'} pipeline`);
+  logger.info(
+    `[Bootstrap-v3] ═══ fillDimensionsV3 entered — ${isIncremental ? 'INCREMENTAL' : 'FULL'} pipeline`
+  );
 
   let allFiles = fillContext.allFiles;
   fillContext.allFiles = null;
@@ -342,9 +401,15 @@ export async function fillDimensionsV3(fillContext) {
   let chatAgent = null;
   try {
     chatAgent = ctx.container.get('chatAgent');
-    if (chatAgent && !chatAgent.hasRealAI) chatAgent = null;
-    if (chatAgent) chatAgent.resetGlobalSubmittedTitles();
-  } catch { /* not available */ }
+    if (chatAgent && !chatAgent.hasRealAI) {
+      chatAgent = null;
+    }
+    if (chatAgent) {
+      chatAgent.resetGlobalSubmittedTitles();
+    }
+  } catch {
+    /* not available */
+  }
 
   if (!chatAgent) {
     logger.info('[Bootstrap-v3] AI not available — aborting v3 pipeline');
@@ -368,7 +433,9 @@ export async function fillDimensionsV3(fillContext) {
     });
     if (projectGraph) {
       const overview = projectGraph.getOverview();
-      logger.info(`[Bootstrap-v3] ProjectGraph: ${overview.totalClasses} classes, ${overview.totalProtocols} protocols (${overview.buildTimeMs}ms)`);
+      logger.info(
+        `[Bootstrap-v3] ProjectGraph: ${overview.totalClasses} classes, ${overview.totalProtocols} protocols (${overview.buildTimeMs}ms)`
+      );
     }
   } catch (e) {
     logger.warn(`[Bootstrap-v3] ProjectGraph build failed: ${e.message}`);
@@ -386,7 +453,7 @@ export async function fillDimensionsV3(fillContext) {
   // 项目信息
   const projectInfo = {
     name: path.basename(projectRoot),
-    lang: primaryLang || 'objectivec',
+    lang: primaryLang || 'unknown',
     fileCount: allFiles?.length || 0,
   };
 
@@ -408,7 +475,9 @@ export async function fillDimensionsV3(fillContext) {
   if (isIncremental && incrementalPlan.restoredEpisodic) {
     episodicMemory = incrementalPlan.restoredEpisodic;
     const restoredDims = episodicMemory.getCompletedDimensions();
-    logger.info(`[Bootstrap-v3] Restored EpisodicMemory: ${restoredDims.length} dims [${restoredDims.join(', ')}]`);
+    logger.info(
+      `[Bootstrap-v3] Restored EpisodicMemory: ${restoredDims.length} dims [${restoredDims.join(', ')}]`
+    );
 
     // 同步恢复 DimensionContext 的 digests (兼容)
     for (const dimId of restoredDims) {
@@ -440,7 +509,7 @@ export async function fillDimensionsV3(fillContext) {
       if (smStats.total > 0) {
         logger.info(
           `[Bootstrap-v3] Loaded ${smStats.total} semantic memories from previous bootstrap ` +
-          `(fact: ${smStats.byType.fact || 0}, insight: ${smStats.byType.insight || 0}, preference: ${smStats.byType.preference || 0})`
+            `(fact: ${smStats.byType.fact || 0}, insight: ${smStats.byType.insight || 0}, preference: ${smStats.byType.preference || 0})`
         );
       }
     }
@@ -473,10 +542,8 @@ export async function fillDimensionsV3(fillContext) {
   const enableParallel = process.env.ASD_PARALLEL_BOOTSTRAP !== 'false';
   const scheduler = new TierScheduler();
 
-  // 过滤出有定义的维度
-  let activeDimIds = dimensions
-    .map(d => d.id)
-    .filter(id => DIMENSION_CONFIGS_V3[id]);
+  // 包含所有维度（含 Enhancement Pack 动态追加的维度）
+  const activeDimIds = dimensions.map((d) => d.id);
 
   // v5.0: 增量模式 — 仅执行受影响维度, 跳过未变更维度
   const incrementalSkippedDims = [];
@@ -495,12 +562,14 @@ export async function fillDimensionsV3(fillContext) {
     if (incrementalSkippedDims.length > 0) {
       logger.info(
         `[Bootstrap-v3] ⏩ Incremental skip: [${incrementalSkippedDims.join(', ')}] ` +
-        `(using historical results)`
+          `(using historical results)`
       );
     }
   }
 
-  logger.info(`[Bootstrap-v3] Active dimensions: [${activeDimIds.join(', ')}], concurrency=${enableParallel ? concurrency : 1}${isIncremental ? `, incremental skip: [${incrementalSkippedDims.join(', ')}]` : ''}`);
+  logger.info(
+    `[Bootstrap-v3] Active dimensions: [${activeDimIds.join(', ')}], concurrency=${enableParallel ? concurrency : 1}${isIncremental ? `, incremental skip: [${incrementalSkippedDims.join(', ')}]` : ''}`
+  );
 
   // ── P3: 断点续传 — 加载有效 checkpoints ──
   const completedCheckpoints = await loadCheckpoints(projectRoot);
@@ -585,27 +654,43 @@ export async function fillDimensionsV3(fillContext) {
           referencedFiles: restoredFiles,
           candidatesSummary: [],
         });
-        logger.info(`[Bootstrap-v3] ✅ Checkpoint "${dimId}": analysisText restored (${cp.analysisText.length} chars) — Skill generation enabled`);
+        logger.info(
+          `[Bootstrap-v3] ✅ Checkpoint "${dimId}": analysisText restored (${cp.analysisText.length} chars) — Skill generation enabled`
+        );
       }
 
       return cpResult;
     }
 
-    const dim = dimensions.find(d => d.id === dimId);
-    const v3Config = DIMENSION_CONFIGS_V3[dimId];
-    if (!dim || !v3Config) {
+    const dim = dimensions.find((d) => d.id === dimId);
+    if (!dim) {
       return { candidateCount: 0, error: 'dimension not found' };
     }
 
-    // 合并 v3 配置和原始维度配置 (保留 skillWorthy, skillMeta 等)
-    const dimConfig = {
-      ...v3Config,
-      id: dimId,
-      skillWorthy: dim.skillWorthy,
-      dualOutput: dim.dualOutput,
-      skillMeta: dim.skillMeta,
-      knowledgeTypes: dim.knowledgeTypes || v3Config.allowedKnowledgeTypes,
-    };
+    // 合并 v3 配置和原始维度配置
+    // Enhancement Pack 动态维度可能不在 DIMENSION_CONFIGS_V3 中 — 从 dim 本身构建配置
+    const v3Config = DIMENSION_CONFIGS_V3[dimId];
+    const dimConfig = v3Config
+      ? {
+          ...v3Config,
+          id: dimId,
+          skillWorthy: dim.skillWorthy,
+          dualOutput: dim.dualOutput,
+          skillMeta: dim.skillMeta,
+          knowledgeTypes: dim.knowledgeTypes || v3Config.allowedKnowledgeTypes,
+        }
+      : {
+          id: dimId,
+          label: dim.label,
+          guide: dim.guide || '',
+          focusAreas: dim.focusAreas || [dim.guide || ''].filter(Boolean),
+          outputType: dim.dualOutput ? 'dual' : dim.skillWorthy ? 'skill' : 'candidate',
+          allowedKnowledgeTypes: dim.knowledgeTypes || [],
+          skillWorthy: dim.skillWorthy,
+          dualOutput: dim.dualOutput,
+          skillMeta: dim.skillMeta,
+          knowledgeTypes: dim.knowledgeTypes || [],
+        };
 
     // Session 有效性检查
     if (taskManager && !taskManager.isSessionValid(sessionId)) {
@@ -637,7 +722,8 @@ export async function fillDimensionsV3(fillContext) {
           codeEntityGraph: codeEntityGraphInst,
         }),
         new Promise((_, reject) =>
-          setTimeout(() => reject(new Error(`Analyst timeout for "${dimId}"`)), 180_000)),
+          setTimeout(() => reject(new Error(`Analyst timeout for "${dimId}"`)), 300_000)
+        ),
       ]);
 
       // v4.0: 蒸馏 Working → Episodic
@@ -652,9 +738,9 @@ export async function fillDimensionsV3(fillContext) {
 
       logger.info(
         `[Bootstrap-v3] Analyst "${dimId}": ${analysisReport.analysisText.length} chars, ` +
-        `${analysisReport.referencedFiles.length} files, ` +
-        `${distilled.keyFindings.length} key findings, ` +
-        `${distilled.totalObservations} observations (${Date.now() - dimStartTime}ms)`
+          `${analysisReport.referencedFiles.length} files, ` +
+          `${distilled.keyFindings.length} key findings, ` +
+          `${distilled.totalObservations} observations (${Date.now() - dimStartTime}ms)`
       );
 
       // ── Phase 2: Producer (如果需要候选输出) ──
@@ -662,18 +748,34 @@ export async function fillDimensionsV3(fillContext) {
       // v3 优先使用 DIMENSION_CONFIGS_V3 的 outputType，回退到 baseDimension 的 skillWorthy/dualOutput
       const v3OutputType = DIMENSION_CONFIGS_V3[dimId]?.outputType;
       const needsCandidates = v3OutputType
-        ? v3OutputType !== 'skill'   // 'dual' 或 'candidate' 都产出候选
-        : (!dimConfig.skillWorthy || dimConfig.dualOutput);
+        ? v3OutputType !== 'skill' // 'dual' 或 'candidate' 都产出候选
+        : !dimConfig.skillWorthy || dimConfig.dualOutput;
+
+      // 先保存 Analyst 结果，确保即使 Producer 失败也能生成 Skill
+      dimensionCandidates[dimId] = {
+        analysisReport,
+        producerResult,
+      };
 
       if (needsCandidates && analysisReport.analysisText.length >= 100) {
-        producerResult = await Promise.race([
-          producerAgent.produce(analysisReport, dimConfig, projectInfo, { sessionId }),
-          new Promise((_, reject) =>
-            setTimeout(() => reject(new Error(`Producer timeout for "${dimId}"`)), 120_000)),
-        ]);
-
-        candidateResults.created += producerResult.candidateCount;
-        logger.info(`[Bootstrap-v3] Producer "${dimId}": ${producerResult.candidateCount} candidates (${Date.now() - dimStartTime}ms total)`);
+        try {
+          producerResult = await Promise.race([
+            producerAgent.produce(analysisReport, dimConfig, projectInfo, { sessionId }),
+            new Promise((_, reject) =>
+              setTimeout(() => reject(new Error(`Producer timeout for "${dimId}"`)), 180_000)
+            ),
+          ]);
+
+          candidateResults.created += producerResult.candidateCount;
+          // 更新 dimensionCandidates 以包含 Producer 结果
+          dimensionCandidates[dimId].producerResult = producerResult;
+          logger.info(
+            `[Bootstrap-v3] Producer "${dimId}": ${producerResult.candidateCount} candidates (${Date.now() - dimStartTime}ms total)`
+          );
+        } catch (producerErr) {
+          logger.error(`[Bootstrap-v3] Producer "${dimId}" failed: ${producerErr.message} — Analyst result preserved for Skill generation`);
+          candidateResults.errors.push({ dimId, error: `Producer: ${producerErr.message}` });
+        }
       }
 
       // ── Phase 3: 记录 DimensionDigest ──
@@ -690,7 +792,7 @@ export async function fillDimensionsV3(fillContext) {
       episodicMemory.addDimensionDigest(dimId, digest);
 
       // 记录到 DimensionContext + EpisodicMemory
-      for (const tc of (producerResult.toolCalls || [])) {
+      for (const tc of producerResult.toolCalls || []) {
         const tool = tc.tool || tc.name;
         if (tool === 'submit_knowledge' || tool === 'submit_with_check') {
           const candidateSummary = {
@@ -704,19 +806,14 @@ export async function fillDimensionsV3(fillContext) {
         }
       }
 
-      // 保存分析结果供 Skill 生成
-      dimensionCandidates[dimId] = {
-        analysisReport,
-        producerResult,
-      };
-
       taskManager?.markTaskCompleted(dimId, {
         type: needsCandidates ? 'candidate' : 'skill',
         extracted: producerResult.candidateCount,
         created: producerResult.candidateCount,
         status: 'v3-complete',
         durationMs: Date.now() - dimStartTime,
-        toolCallCount: (analysisReport.metadata?.toolCallCount || 0) + (producerResult.toolCalls?.length || 0),
+        toolCallCount:
+          (analysisReport.metadata?.toolCallCount || 0) + (producerResult.toolCalls?.length || 0),
       });
 
       // P4.1: 聚合 token 用量
@@ -733,7 +830,8 @@ export async function fillDimensionsV3(fillContext) {
         analysisChars: analysisReport.analysisText.length,
         referencedFiles: analysisReport.referencedFiles.length,
         durationMs: Date.now() - dimStartTime,
-        toolCallCount: (analysisReport.metadata?.toolCallCount || 0) + (producerResult.toolCalls?.length || 0),
+        toolCallCount:
+          (analysisReport.metadata?.toolCallCount || 0) + (producerResult.toolCalls?.length || 0),
         tokenUsage: dimTokenUsage,
         // P3+: 保存 analysisText 供 checkpoint 恢复后 Skill 生成使用
         analysisText: analysisReport.analysisText,
@@ -747,7 +845,6 @@ export async function fillDimensionsV3(fillContext) {
       await saveDimensionCheckpoint(projectRoot, sessionId, dimId, dimResult, digest);
 
       return dimResult;
-
     } catch (err) {
       logger.error(`[Bootstrap-v3] Dimension "${dimId}" failed: ${err.message}`);
       candidateResults.errors.push({ dimId, error: err.message });
@@ -764,11 +861,14 @@ export async function fillDimensionsV3(fillContext) {
   if (enableParallel) {
     const results = await scheduler.execute(executeDimension, {
       concurrency,
+      activeDimIds,
       shouldAbort: () => taskManager && !taskManager.isSessionValid(sessionId),
       onTierComplete: (tierIndex, tierResults) => {
         const tierStats = [...tierResults.values()];
         const totalCandidates = tierStats.reduce((s, r) => s + (r.candidateCount || 0), 0);
-        logger.info(`[Bootstrap-v3] Tier ${tierIndex + 1} complete: ${tierResults.size} dimensions, ${totalCandidates} candidates`);
+        logger.info(
+          `[Bootstrap-v3] Tier ${tierIndex + 1} complete: ${tierResults.size} dimensions, ${totalCandidates} candidates`
+        );
 
         // v4.0: Tier 级 Reflection — 综合本 Tier 所有维度的发现
         try {
@@ -776,8 +876,8 @@ export async function fillDimensionsV3(fillContext) {
           episodicMemory.addTierReflection(tierIndex, reflection);
           logger.info(
             `[Bootstrap-v3] Tier ${tierIndex + 1} reflection: ` +
-            `${reflection.topFindings.length} top findings, ` +
-            `${reflection.crossDimensionPatterns.length} patterns`
+              `${reflection.topFindings.length} top findings, ` +
+              `${reflection.crossDimensionPatterns.length} patterns`
           );
         } catch (refErr) {
           logger.warn(`[Bootstrap-v3] Tier ${tierIndex + 1} reflection failed: ${refErr.message}`);
@@ -785,25 +885,31 @@ export async function fillDimensionsV3(fillContext) {
       },
     });
 
-    logger.info(`[Bootstrap-v3] All tiers complete: ${results.size} dimensions in ${Date.now() - t0}ms`);
+    logger.info(
+      `[Bootstrap-v3] All tiers complete: ${results.size} dimensions in ${Date.now() - t0}ms`
+    );
     // v4.0: 记录 EpisodicMemory 统计 + ToolResultCache 效率
     const emStats = episodicMemory.getStats();
     const cacheStats = toolResultCache.getStats();
     logger.info(
       `[Bootstrap-v3] Memory stats: ${emStats.completedDimensions} dims, ` +
-      `${emStats.totalFindings} findings, ${emStats.referencedFiles} files, ` +
-      `${emStats.crossReferences} cross-refs, ${emStats.tierReflections} reflections`
+        `${emStats.totalFindings} findings, ${emStats.referencedFiles} files, ` +
+        `${emStats.crossReferences} cross-refs, ${emStats.tierReflections} reflections`
     );
     logger.info(
       `[Bootstrap-v3] Cache stats: ${cacheStats.hitRate} hit rate, ` +
-      `${cacheStats.searchCacheSize} searches, ${cacheStats.fileCacheSize} files`
+        `${cacheStats.searchCacheSize} searches, ${cacheStats.fileCacheSize} files`
     );
   } else {
     // 串行: 按 TierScheduler 内部顺序逐个执行
     for (const tier of scheduler.getTiers()) {
       for (const dimId of tier) {
-        if (!activeDimIds.includes(dimId)) continue;
-        if (taskManager && !taskManager.isSessionValid(sessionId)) break;
+        if (!activeDimIds.includes(dimId)) {
+          continue;
+        }
+        if (taskManager && !taskManager.isSessionValid(sessionId)) {
+          break;
+        }
         await executeDimension(dimId);
       }
     }
@@ -822,19 +928,63 @@ export async function fillDimensionsV3(fillContext) {
     const { createSkill } = await import('../../skill.js');
 
     for (const dim of dimensions) {
-      if (!dim.skillWorthy) continue;
+      if (!dim.skillWorthy) {
+        continue;
+      }
       const dimData = dimensionCandidates[dim.id];
-      if (!dimData?.analysisReport?.analysisText) continue;
-      if (taskManager && !taskManager.isSessionValid(sessionId)) break;
+      if (!dimData?.analysisReport?.analysisText) {
+        continue;
+      }
+      if (taskManager && !taskManager.isSessionValid(sessionId)) {
+        break;
+      }
 
       try {
         const skillName = dim.skillMeta?.name || `project-${dim.id}`;
-        const skillDescription = dim.skillMeta?.description || `Auto-generated skill for ${dim.label}`;
+        const skillDescription =
+          dim.skillMeta?.description || `Auto-generated skill for ${dim.label}`;
 
         // v3: Analyst 分析文本就是高质量的 Skill 内容
         const analysisText = dimData.analysisReport.analysisText;
         const referencedFiles = dimData.analysisReport.referencedFiles || [];
 
+        // ── Skill 质量门控 ──
+        // 1. 文本过短（Analyst 产出空洞或仅 "请继续"）
+        if (!analysisText || analysisText.trim().length < 100) {
+          logger.warn(
+            `[Bootstrap-v3] Skill "${dim.id}" skipped — analysisText too short (${analysisText?.trim().length || 0} chars)`
+          );
+          skillResults.failed++;
+          skillResults.errors.push({ dimId: dim.id, error: 'analysisText too short' });
+          continue;
+        }
+        // 2. 重复行检测（AI 陷入循环输出工具提示等）
+        const textLines = analysisText.split('\n').filter(l => l.trim().length > 0);
+        const uniqueLines = new Set(textLines.map(l => l.trim()));
+        const uniqueRatio = textLines.length > 0 ? uniqueLines.size / textLines.length : 1;
+        if (textLines.length > 20 && uniqueRatio < 0.3) {
+          logger.warn(
+            `[Bootstrap-v3] Skill "${dim.id}" skipped — heavy repetition (${uniqueLines.size}/${textLines.length} unique, ratio ${uniqueRatio.toFixed(2)})`
+          );
+          skillResults.failed++;
+          skillResults.errors.push({ dimId: dim.id, error: 'repetitive content detected' });
+          continue;
+        }
+        // 3. 内容中不包含项目特定标记（无 Markdown 标题、列表、代码块等结构化内容）
+        const hasStructure =
+          /^#{1,3}\s.+/m.test(analysisText) ||
+          /^\d+\.\s/m.test(analysisText) ||
+          /^[-*•]\s/m.test(analysisText) ||
+          /```[\s\S]*?```/.test(analysisText);
+        if (!hasStructure && analysisText.length < 500) {
+          logger.warn(
+            `[Bootstrap-v3] Skill "${dim.id}" skipped — no structured content detected`
+          );
+          skillResults.failed++;
+          skillResults.errors.push({ dimId: dim.id, error: 'no structured content' });
+          continue;
+        }
+
         // 构建 Markdown Skill 内容
         const skillContent = [
           `# ${dim.label || dim.id}`,
@@ -844,9 +994,11 @@ export async function fillDimensionsV3(fillContext) {
           analysisText,
           '',
           referencedFiles.length > 0
-            ? `## Referenced Files\n\n${referencedFiles.map(f => `- \`${f}\``).join('\n')}`
+            ? `## Referenced Files\n\n${referencedFiles.map((f) => `- \`${f}\``).join('\n')}`
             : '',
-        ].filter(Boolean).join('\n');
+        ]
+          .filter(Boolean)
+          .join('\n');
 
         const result = createSkill(ctx, {
           name: skillName,
@@ -917,7 +1069,9 @@ export async function fillDimensionsV3(fillContext) {
       }
     }
   } catch (cegErr) {
-    logger.warn(`[Bootstrap-v3] Code Entity Graph relations failed (non-blocking): ${cegErr.message}`);
+    logger.warn(
+      `[Bootstrap-v3] Code Entity Graph relations failed (non-blocking): ${cegErr.message}`
+    );
   }
 
   // ═══════════════════════════════════════════════════════════
@@ -941,16 +1095,18 @@ export async function fillDimensionsV3(fillContext) {
       const smStats = semanticMemory.getStats();
       logger.info(
         `[Bootstrap-v3] Semantic Memory consolidation: ` +
-        `+${consolidationResult.total.added} ADD, ` +
-        `~${consolidationResult.total.updated} UPDATE, ` +
-        `⊕${consolidationResult.total.merged} MERGE | ` +
-        `Total: ${smStats.total} memories (avg importance: ${smStats.avgImportance})`
+          `+${consolidationResult.total.added} ADD, ` +
+          `~${consolidationResult.total.updated} UPDATE, ` +
+          `⊕${consolidationResult.total.merged} MERGE | ` +
+          `Total: ${smStats.total} memories (avg importance: ${smStats.avgImportance})`
       );
     } else {
       logger.warn('[Bootstrap-v3] Database not available — skipping Semantic Memory consolidation');
     }
   } catch (consolidateErr) {
-    logger.warn(`[Bootstrap-v3] Semantic Memory consolidation failed (non-blocking): ${consolidateErr.message}`);
+    logger.warn(
+      `[Bootstrap-v3] Semantic Memory consolidation failed (non-blocking): ${consolidateErr.message}`
+    );
   }
 
   // ═══════════════════════════════════════════════════════════
@@ -960,7 +1116,10 @@ export async function fillDimensionsV3(fillContext) {
 
   // P4.1: 汇总所有维度 token 用量
   const totalTokenUsage = { input: 0, output: 0 };
-  const totalToolCalls = Object.values(dimensionStats).reduce((sum, s) => sum + (s.toolCallCount || 0), 0);
+  const totalToolCalls = Object.values(dimensionStats).reduce(
+    (sum, s) => sum + (s.toolCallCount || 0),
+    0
+  );
   for (const stat of Object.values(dimensionStats)) {
     if (stat.tokenUsage) {
       totalTokenUsage.input += stat.tokenUsage.input || 0;
@@ -968,19 +1127,29 @@ export async function fillDimensionsV3(fillContext) {
     }
   }
 
-  logger.info([
-    `[Bootstrap-v3] ═══ Pipeline complete ═══`,
-    isIncremental ? `  Mode: INCREMENTAL (${incrementalPlan.affectedDimensions.length} affected, ${incrementalSkippedDims.length} skipped)` : '',
-    `  Candidates: ${candidateResults.created} created, ${candidateResults.errors.length} errors`,
-    `  Skills: ${skillResults.created} created, ${skillResults.failed} failed`,
-    consolidationResult ? `  Semantic Memory: +${consolidationResult.total.added} ADD, ~${consolidationResult.total.updated} UPDATE, ⊕${consolidationResult.total.merged} MERGE` : '',
-    `  Time: ${totalTimeMs}ms (${(totalTimeMs / 1000).toFixed(1)}s)`,
-    `  Mode: ${enableParallel ? `parallel (concurrency=${concurrency})` : 'serial'}`,
-    `  Tokens: input=${totalTokenUsage.input}, output=${totalTokenUsage.output}`,
-    `  Tool calls: ${totalToolCalls}`,
-    skippedDims.length > 0 ? `  Checkpoints restored: [${skippedDims.join(', ')}]` : '',
-    incrementalSkippedDims.length > 0 ? `  Incremental skip: [${incrementalSkippedDims.join(', ')}]` : '',
-  ].filter(Boolean).join('\n'));
+  logger.info(
+    [
+      `[Bootstrap-v3] ═══ Pipeline complete ═══`,
+      isIncremental
+        ? `  Mode: INCREMENTAL (${incrementalPlan.affectedDimensions.length} affected, ${incrementalSkippedDims.length} skipped)`
+        : '',
+      `  Candidates: ${candidateResults.created} created, ${candidateResults.errors.length} errors`,
+      `  Skills: ${skillResults.created} created, ${skillResults.failed} failed`,
+      consolidationResult
+        ? `  Semantic Memory: +${consolidationResult.total.added} ADD, ~${consolidationResult.total.updated} UPDATE, ⊕${consolidationResult.total.merged} MERGE`
+        : '',
+      `  Time: ${totalTimeMs}ms (${(totalTimeMs / 1000).toFixed(1)}s)`,
+      `  Mode: ${enableParallel ? `parallel (concurrency=${concurrency})` : 'serial'}`,
+      `  Tokens: input=${totalTokenUsage.input}, output=${totalTokenUsage.output}`,
+      `  Tool calls: ${totalToolCalls}`,
+      skippedDims.length > 0 ? `  Checkpoints restored: [${skippedDims.join(', ')}]` : '',
+      incrementalSkippedDims.length > 0
+        ? `  Incremental skip: [${incrementalSkippedDims.join(', ')}]`
+        : '',
+    ]
+      .filter(Boolean)
+      .join('\n')
+  );
 
   // P4.2: 生成冷启动报告
   try {
@@ -1007,25 +1176,31 @@ export async function fillDimensionsV3(fillContext) {
       checkpoints: {
         restored: skippedDims,
       },
-      incremental: isIncremental ? {
-        mode: 'incremental',
-        affectedDimensions: incrementalPlan.affectedDimensions,
-        skippedDimensions: incrementalSkippedDims,
-        diff: incrementalPlan.diff ? {
-          added: incrementalPlan.diff.added.length,
-          modified: incrementalPlan.diff.modified.length,
-          deleted: incrementalPlan.diff.deleted.length,
-          unchanged: incrementalPlan.diff.unchanged.length,
-        } : null,
-        reason: incrementalPlan.reason,
-      } : null,
-      semanticMemory: consolidationResult ? {
-        added: consolidationResult.total.added,
-        updated: consolidationResult.total.updated,
-        merged: consolidationResult.total.merged,
-        skipped: consolidationResult.total.skipped,
-        durationMs: consolidationResult.durationMs,
-      } : null,
+      incremental: isIncremental
+        ? {
+            mode: 'incremental',
+            affectedDimensions: incrementalPlan.affectedDimensions,
+            skippedDimensions: incrementalSkippedDims,
+            diff: incrementalPlan.diff
+              ? {
+                  added: incrementalPlan.diff.added.length,
+                  modified: incrementalPlan.diff.modified.length,
+                  deleted: incrementalPlan.diff.deleted.length,
+                  unchanged: incrementalPlan.diff.unchanged.length,
+                }
+              : null,
+            reason: incrementalPlan.reason,
+          }
+        : null,
+      semanticMemory: consolidationResult
+        ? {
+            added: consolidationResult.total.added,
+            updated: consolidationResult.total.updated,
+            merged: consolidationResult.total.merged,
+            skipped: consolidationResult.total.skipped,
+            durationMs: consolidationResult.durationMs,
+          }
+        : null,
     };
 
     for (const [dimId, stat] of Object.entries(dimensionStats)) {
@@ -1042,7 +1217,9 @@ export async function fillDimensionsV3(fillContext) {
 
     // Phase E: 附加 Code Entity Graph 拓扑到报告
     try {
-      const { CodeEntityGraph } = await import('../../../../../service/knowledge/CodeEntityGraph.js');
+      const { CodeEntityGraph } = await import(
+        '../../../../../service/knowledge/CodeEntityGraph.js'
+      );
       const db = ctx.container.get('database');
       if (db) {
         const ceg = new CodeEntityGraph(db, { projectRoot, logger });
@@ -1055,13 +1232,15 @@ export async function fillDimensionsV3(fillContext) {
           hotNodes: topo.hotNodes?.slice(0, 5),
         };
       }
-    } catch { /* non-blocking */ }
+    } catch {
+      /* non-blocking */
+    }
 
     const reportDir = path.join(projectRoot, '.autosnippet');
     await fs.mkdir(reportDir, { recursive: true });
     await fs.writeFile(
       path.join(reportDir, 'bootstrap-report.json'),
-      JSON.stringify(report, null, 2),
+      JSON.stringify(report, null, 2)
     );
     logger.info(`[Bootstrap-v3] 📊 Bootstrap report saved to .autosnippet/bootstrap-report.json`);
   } catch (reportErr) {
@@ -1105,11 +1284,13 @@ export async function fillDimensionsV3(fillContext) {
     if (container.services.cursorDeliveryPipeline) {
       const pipeline = container.get('cursorDeliveryPipeline');
       const deliveryResult = await pipeline.deliver();
-      logger.info(`[Bootstrap-v3] 🚀 Cursor Delivery complete — ` +
-        `A: ${deliveryResult.channelA.rulesCount} rules, ` +
-        `B: ${deliveryResult.channelB.topicCount} topics, ` +
-        `C: ${deliveryResult.channelC.synced} skills, ` +
-        `D: ${deliveryResult.channelD?.documentsCount || 0} documents`);
+      logger.info(
+        `[Bootstrap-v3] 🚀 Cursor Delivery complete — ` +
+          `A: ${deliveryResult.channelA.rulesCount} rules, ` +
+          `B: ${deliveryResult.channelB.topicCount} topics, ` +
+          `C: ${deliveryResult.channelC.synced} skills, ` +
+          `D: ${deliveryResult.channelD?.documentsCount || 0} documents`
+      );
     }
   } catch (deliveryErr) {
     logger.warn(`[Bootstrap-v3] Cursor Delivery failed (non-blocking): ${deliveryErr.message}`);
@@ -1117,29 +1298,47 @@ export async function fillDimensionsV3(fillContext) {
 
   // ── Repo Wiki: 自动生成项目文档 Wiki ──
   try {
-    const { getServiceContainer: getWikiContainer } = await import('../../../../../injection/ServiceContainer.js');
+    const { getServiceContainer: getWikiContainer } = await import(
+      '../../../../../injection/ServiceContainer.js'
+    );
     const wikiContainer = getWikiContainer();
     const { WikiGenerator } = await import('../../../../../service/wiki/WikiGenerator.js');
 
-    let spmService = null, knowledgeService = null, codeEntityGraph = null;
-    try { spmService = wikiContainer.get('spmService'); } catch { /* optional */ }
-    try { knowledgeService = wikiContainer.get('knowledgeService'); } catch { /* optional */ }
-    try { codeEntityGraph = wikiContainer.get('codeEntityGraph'); } catch { /* optional */ }
+    let moduleService = null,
+      knowledgeService = null,
+      codeEntityGraph = null;
+    try {
+      moduleService = wikiContainer.get('moduleService');
+    } catch {
+      /* optional */
+    }
+    try {
+      knowledgeService = wikiContainer.get('knowledgeService');
+    } catch {
+      /* optional */
+    }
+    try {
+      codeEntityGraph = wikiContainer.get('codeEntityGraph');
+    } catch {
+      /* optional */
+    }
 
     const wiki = new WikiGenerator({
       projectRoot,
-      spmService,
+      moduleService,
       knowledgeService,
-      projectGraph,       // 来自 Step 0.5 构建的 ProjectGraph
+      projectGraph, // 来自 Step 0.5 构建的 ProjectGraph
       codeEntityGraph,
       aiProvider: wikiContainer.singletons?.aiProvider || null,
       options: { language: process.env.ASD_WIKI_LANG || 'zh' },
     });
     const wikiResult = await wiki.generate();
     if (wikiResult.success) {
-      logger.info(`[Bootstrap-v3] 📖 Wiki generated — ${wikiResult.filesGenerated} files, ` +
-        `AI: ${wikiResult.aiComposed || 0}, Synced: ${wikiResult.syncedDocs || 0}, ` +
-        `Dedup removed: ${wikiResult.dedup?.removed?.length || 0}`);
+      logger.info(
+        `[Bootstrap-v3] 📖 Wiki generated — ${wikiResult.filesGenerated} files, ` +
+          `AI: ${wikiResult.aiComposed || 0}, Synced: ${wikiResult.syncedDocs || 0}, ` +
+          `Dedup removed: ${wikiResult.dedup?.removed?.length || 0}`
+      );
     }
   } catch (wikiErr) {
     logger.warn(`[Bootstrap-v3] Wiki generation failed (non-blocking): ${wikiErr.message}`);