autosnippet 3.3.5 → 3.3.7

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

@@ -23,26 +23,26 @@ import { MemoryCoordinator } from '#agent/memory/MemoryCoordinator.js';
 import { PersistentMemory } from '#agent/memory/PersistentMemory.js';
 import { SessionStore } from '#agent/memory/SessionStore.js';
 import { PRESETS } from '#agent/presets.js';
+import { getDimensionFocusKeywords } from '#domain/dimension/DimensionSop.js';
 import Logger from '#infra/logging/Logger.js';
 import { BootstrapEventEmitter } from '#service/bootstrap/BootstrapEventEmitter.js';
-import { getDimensionFocusKeywords } from '../shared/dimension-sop.js';
+import { buildEvidenceStarters } from '../MissionBriefingBuilder.js';
 import { generateSkill } from '../shared/skill-generator.js';
 import { clearCheckpoints, loadCheckpoints, saveDimensionCheckpoint } from './checkpoint.js';
 import { buildTierReflection, DIMENSION_CONFIGS_V3, getFullDimensionConfig, } from './dimension-configs.js';
 import { DimensionContext, parseDimensionDigest } from './dimension-context.js';
 import { IncrementalBootstrap } from './IncrementalBootstrap.js';
-import { runNoAiFallback } from './noAiFallback.js';
+import { fillDimensionsMock } from './mock-pipeline.js';
 import { TierScheduler } from './tier-scheduler.js';
 const logger = Logger.getInstance();
 // ──────────────────────────────────────────────────────────────────
 // Panorama Context for strategyContext injection (M1 §5.2)
 // ──────────────────────────────────────────────────────────────────
 /**
- * 从 fillContext.panoramaResult 提取维度级全景上下文
+ * 从 panoramaResult 提取维度级全景上下文
  * 注入 strategyContext.panorama，使 Agent 获得模块角色/层级/耦合/空白区信息
  */
-function buildPanoramaContext(fillContext, _dimConfig) {
-    const panoramaResult = fillContext.panoramaResult;
+function buildPanoramaContext(panoramaResult, _dimConfig) {
     if (!panoramaResult) {
         return null;
     }
@@ -87,172 +87,77 @@ function buildPanoramaContext(fillContext, _dimConfig) {
 /**
  * fillDimensionsV3 — v3.0 AI-First 维度填充管线
  *
- * @param fillContext 由 bootstrapKnowledge 构建的上下文
+ * @param view PipelineFillView — 从 handler 传入的类型化视图
+ * @param dimensions 当前运行的维度列表（rescan 可能是 gap 子集）
  */
-export async function fillDimensionsV3(fillContext) {
-    const { ctx, dimensions, taskManager, sessionId, projectRoot, depGraphData, guardAudit, primaryLang, astProjectSummary, incrementalPlan, // v5.0: 增量 Bootstrap 计划 (from bootstrap.js)
-     } = fillContext;
+export async function fillDimensionsV3(view, dimensions) {
+    const { snapshot, projectRoot } = view;
+    const ctx = view.ctx;
+    // 从 snapshot 提取 orchestrator 所需字段
+    const depGraphData = snapshot.dependencyGraph;
+    const guardAudit = snapshot.guardAudit;
+    const primaryLang = snapshot.language.primaryLang ?? 'unknown';
+    const astProjectSummary = snapshot.ast;
+    const incrementalPlan = snapshot.incrementalPlan;
+    const panoramaResult = snapshot.panorama;
+    const callGraphResult = snapshot.callGraph;
+    const existingRecipes = view.existingRecipes ?? null;
+    const targetFileMap = view.targetFileMap;
+    // 从 ctx 获取运行时服务
+    let taskManager = null;
+    try {
+        taskManager = ctx.container.get('bootstrapTaskManager');
+    }
+    catch {
+        /* not available */
+    }
+    const sessionId = view.bootstrapSession?.id ?? '';
     const isIncremental = incrementalPlan?.canIncremental && incrementalPlan?.mode === 'incremental';
     const emitter = new BootstrapEventEmitter(ctx.container);
     logger.info(`[Insight-v3] ═══ fillDimensionsV3 entered — ${isIncremental ? 'INCREMENTAL' : 'FULL'} pipeline`);
-    let allFiles = fillContext.allFiles;
-    fillContext.allFiles = null;
+    let allFiles = snapshot.allFiles;
     // ═══════════════════════════════════════════════════════════
-    // Step 0: AI 可用性检查 (v7.2: 使用 AgentFactory)
+    // Step 0: AI 可用性检查 (v7.2: 使用 AgentFactory + AiProviderManager)
     // ═══════════════════════════════════════════════════════════
     let agentFactory = null;
+    let isMockMode = false;
     try {
-        agentFactory = ctx.container.get('agentFactory');
-        // 检查 AI Provider 是否可用
-        const aiProvider = ctx.container.singletons?.aiProvider;
-        if (!aiProvider || aiProvider.name === 'mock') {
-            agentFactory = null;
+        // 通过 AiProviderManager 统一检查 mock 模式
+        const manager = ctx.container.singletons?._aiProviderManager;
+        isMockMode = manager?.isMock ?? false;
+        if (!isMockMode) {
+            agentFactory = ctx.container.get('agentFactory');
         }
     }
     catch {
         /* not available */
     }
-    if (!agentFactory) {
-        logger.info('[Insight-v3] AI not available — entering rule-based fallback');
+    if (!agentFactory && !isMockMode) {
+        logger.error('[Insight-v3] AI Provider not available — bootstrap requires AI');
         emitter.emitProgress('bootstrap:ai-unavailable', {
-            message: 'AI 不可用，将使用规则化降级提取基础知识。请配置 AI Provider 以获取完整分析。',
+            message: 'AI Provider 不可用，Bootstrap 需要 AI 才能运行。请先配置 AI Provider（如 OpenAI、Anthropic 等）后重试。',
         });
-        // ── 规则化降级: 从 Phase 0-4 数据中提取基础知识 ──
-        try {
-            fillContext.allFiles = allFiles;
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-argument -- FillContextV3 is structurally compatible with FillContext at runtime
-            const fallbackResult = await runNoAiFallback(fillContext);
-            // ── 持久化候选到数据库 (KnowledgeService.create) ──
-            let persistedCount = 0;
-            if (fallbackResult.candidates.length > 0) {
-                try {
-                    const knowledgeService = ctx.container.get('knowledgeService');
-                    for (const candidate of fallbackResult.candidates) {
-                        try {
-                            await knowledgeService.create({
-                                title: candidate.title,
-                                content: candidate.content,
-                                language: candidate.language || primaryLang || '',
-                                category: candidate.category || '',
-                                knowledgeType: candidate.knowledgeType || 'code-pattern',
-                                source: 'bootstrap-fallback',
-                                difficulty: candidate.difficulty || 'beginner',
-                                scope: candidate.scope || 'project-specific',
-                                reasoning: candidate.reasoning || {},
-                                tags: ['bootstrap-fallback', 'rule-based'],
-                                trigger: candidate.trigger || '',
-                                doClause: candidate.doClause || '',
-                                dontClause: candidate.dontClause || '',
-                                whenClause: candidate.whenClause || '',
-                                coreCode: candidate.coreCode || '',
-                            }, { userId: 'bootstrap-fallback' });
-                            persistedCount++;
-                        }
-                        catch (entryErr) {
-                            logger.warn(`[Bootstrap-fallback] Candidate "${candidate.title}" persist failed: ${entryErr instanceof Error ? entryErr.message : String(entryErr)}`);
-                        }
-                    }
-                    logger.info(`[Bootstrap-fallback] ${persistedCount}/${fallbackResult.candidates.length} candidates persisted to DB`);
-                }
-                catch (svcErr) {
-                    logger.warn(`[Bootstrap-fallback] KnowledgeService not available — candidates not persisted: ${svcErr instanceof Error ? svcErr.message : String(svcErr)}`);
-                }
-            }
-            // ── 持久化 Skill 文件 ──
-            let skillsCreated = 0;
-            if (fallbackResult.skills.length > 0) {
-                try {
-                    const { createSkill } = await import('../../skill.js');
-                    for (const sk of fallbackResult.skills) {
-                        try {
-                            const result = createSkill(ctx, {
-                                name: sk.name,
-                                description: sk.description,
-                                content: sk.content,
-                                overwrite: true,
-                                createdBy: 'bootstrap-fallback',
-                            });
-                            const parsed = JSON.parse(result);
-                            if (parsed.success) {
-                                skillsCreated++;
-                                logger.info(`[Bootstrap-fallback] Skill "${sk.name}" created`);
-                            }
-                        }
-                        catch (skErr) {
-                            logger.warn(`[Bootstrap-fallback] Skill "${sk.name}" write failed: ${skErr instanceof Error ? skErr.message : String(skErr)}`);
-                        }
-                    }
-                }
-                catch (importErr) {
-                    logger.warn(`[Bootstrap-fallback] Skill module import failed: ${importErr instanceof Error ? importErr.message : String(importErr)}`);
-                }
-            }
-            // ── 写入降级报告 ──
-            try {
-                const reportDir = path.join(projectRoot, '.autosnippet');
-                await fs.mkdir(reportDir, { recursive: true });
-                await fs.writeFile(path.join(reportDir, 'bootstrap-report.json'), JSON.stringify({
-                    version: '2.7.0',
-                    timestamp: new Date().toISOString(),
-                    mode: 'no-ai-fallback',
-                    project: {
-                        name: path.basename(projectRoot),
-                        files: allFiles?.length || 0,
-                        lang: primaryLang || 'unknown',
-                    },
-                    fallback: fallbackResult.report,
-                    persisted: { candidates: persistedCount, skills: skillsCreated },
-                }, null, 2));
-            }
-            catch {
-                /* non-critical */
-            }
-            // ── 通知前端降级产出已完成 ──
-            emitter.emitProgress('bootstrap:fallback-complete', {
-                message: `降级产出完成: ${persistedCount} 条知识已入库, ${skillsCreated} 个 Skill 已生成`,
-                candidates: persistedCount,
-                skills: skillsCreated,
-                errors: fallbackResult.report.errors.length,
-            });
-            // ── R7: No-AI 降级路径完成后也触发 Cursor Delivery ──
-            if (persistedCount > 0 || skillsCreated > 0) {
-                try {
-                    const { getServiceContainer } = await import('#inject/ServiceContainer.js');
-                    const deliveryContainer = getServiceContainer();
-                    if (deliveryContainer.services.cursorDeliveryPipeline) {
-                        const pipeline = deliveryContainer.get('cursorDeliveryPipeline');
-                        const deliveryResult = await pipeline.deliver();
-                        logger.info(`[Bootstrap-fallback] Cursor Delivery complete — ` +
-                            `A: ${deliveryResult.channelA?.rulesCount || 0}, ` +
-                            `B: ${deliveryResult.channelB?.topicCount || 0}, ` +
-                            `F: ${deliveryResult.channelF?.filesWritten || 0}`);
-                    }
-                }
-                catch (deliveryErr) {
-                    logger.warn(`[Bootstrap-fallback] CursorDelivery failed (non-blocking): ${deliveryErr instanceof Error ? deliveryErr.message : String(deliveryErr)}`);
-                }
-            }
-            logger.info(`[Bootstrap-fallback] Completed: ${persistedCount} candidates persisted, ` +
-                `${skillsCreated} skills written, ${fallbackResult.report.errors.length} errors`);
-        }
-        catch (fallbackErr) {
-            logger.error(`[Bootstrap-fallback] Fallback failed: ${fallbackErr instanceof Error ? fallbackErr.message : String(fallbackErr)}`);
-            // 即使降级也失败，仍标记所有维度为 skipped
-            for (const dim of dimensions) {
-                emitter.emitDimensionComplete(dim.id, { type: 'skipped', reason: 'fallback-failed' });
-            }
+        for (const dim of dimensions) {
+            emitter.emitDimensionComplete(dim.id, { type: 'skipped', reason: 'ai-unavailable' });
         }
         return;
     }
+    // Mock AI: 走 mock-pipeline 轻量管线
+    if (isMockMode) {
+        logger.info('[Insight-v3] Mock AI detected — routing to mock-pipeline');
+        await fillDimensionsMock(view, dimensions);
+        return;
+    }
     // ═══════════════════════════════════════════════════════════
     // Step 0.5: 构建 ProjectGraph
     // ═══════════════════════════════════════════════════════════
     let projectGraph = null;
     try {
-        projectGraph = await ctx.container.buildProjectGraph(projectRoot, {
-            maxFiles: 500,
-            timeoutMs: 15_000,
-        });
+        projectGraph =
+            (await ctx.container.buildProjectGraph?.(projectRoot, {
+                maxFiles: 500,
+                timeoutMs: 15_000,
+            })) ?? null;
         if (projectGraph) {
             const overview = projectGraph.getOverview();
             logger.info(`[Insight-v3] ProjectGraph: ${overview.totalClasses} classes, ${overview.totalProtocols} protocols (${overview.buildTimeMs}ms)`);
@@ -278,11 +183,11 @@ export async function fillDimensionsV3(fillContext) {
         projectName: projectInfo.name,
         primaryLang: projectInfo.lang,
         fileCount: projectInfo.fileCount,
-        targetCount: Object.keys(fillContext.targetFileMap || {}).length,
-        modules: Object.keys(fillContext.targetFileMap || {}),
-        depGraph: depGraphData || null,
-        astMetrics: astProjectSummary?.projectMetrics || null,
-        guardSummary: guardAudit?.summary || null,
+        targetCount: Object.keys(targetFileMap || {}).length,
+        modules: Object.keys(targetFileMap || {}),
+        depGraph: depGraphData ?? undefined,
+        astMetrics: astProjectSummary?.projectMetrics ?? undefined,
+        guardSummary: guardAudit?.summary ?? undefined,
     });
     // v4.0: SessionStore — 替代 EpisodicMemory + ToolResultCache
     // v5.0: 增量模式下从快照恢复已完成维度的记忆
@@ -304,7 +209,7 @@ export async function fillDimensionsV3(fillContext) {
             projectName: projectInfo.name,
             primaryLang: projectInfo.lang,
             fileCount: projectInfo.fileCount,
-            modules: Object.keys(fillContext.targetFileMap || {}),
+            modules: Object.keys(targetFileMap || {}),
         });
     }
     // v4.1: PersistentMemory — 项目级永久语义记忆 (Tier 3)
@@ -414,6 +319,36 @@ export async function fillDimensionsV3(fillContext) {
     // ── 跨维度去重集合 (实例级持久化，等效旧 ChatAgent.#globalSubmittedTitles/Patterns) ──
     const globalSubmittedTitles = new Set();
     const globalSubmittedPatterns = new Set();
+    // ── Rescan 模式: 预种已有 recipe 标题到去重集合，防止重复创建 ──
+    const existingRecipesList = existingRecipes;
+    if (existingRecipesList && existingRecipesList.length > 0) {
+        for (const r of existingRecipesList) {
+            // ★ 只预种 healthy 标题，decaying 的允许被替代
+            if (r.title && r.status !== 'decaying') {
+                globalSubmittedTitles.add(r.title.toLowerCase().trim());
+            }
+        }
+        logger.info(`[Insight-v3] Rescan mode: seeded ${globalSubmittedTitles.size} existing recipe titles into dedup set`);
+    }
+    // 构建 rescanContext 供 Analyst/Producer prompt 使用（区分 healthy/decaying）
+    const rescanContext = existingRecipesList
+        ? {
+            // healthy 列表 — 告诉 Agent "不要重复"
+            existingRecipes: existingRecipesList.filter((r) => r.status !== 'decaying'),
+            // decaying 列表 — 告诉 Agent "可以替换"
+            decayingRecipes: existingRecipesList.filter((r) => r.status === 'decaying'),
+            // trigger 仍全部占用（含 decaying）
+            occupiedTriggers: existingRecipesList.map((r) => r.trigger).filter(Boolean),
+            coverageByDim: existingRecipesList.reduce((acc, r) => {
+                // 只有 healthy 计入覆盖
+                if (r.status !== 'decaying') {
+                    const dim = r.knowledgeType || 'unknown';
+                    acc[dim] = (acc[dim] || 0) + 1;
+                }
+                return acc;
+            }, {}),
+        }
+        : null;
     /** 执行单个维度: Analyst → Gate → Producer */
     async function executeDimension(dimId) {
         // v5.0: 增量模式 — 跳过未受影响的维度 (使用历史 EpisodicMemory)
@@ -530,15 +465,22 @@ export async function fillDimensionsV3(fillContext) {
                 : !dimConfig.skillWorthy || dimConfig.dualOutput;
             // ── 获取 Preset 的标准 stages 配置作为基础 ──
             const presetStages = PRESETS.insight.strategy.stages;
+            const evolutionPresetStages = PRESETS.evolution.strategy.stages;
+            // ── 判断当前维度是否有现有 Recipe（按维度过滤后） ──
+            const dimExistingRecipes = [
+                ...(rescanContext?.existingRecipes?.filter((r) => r.knowledgeType === dimId) ?? []),
+                ...(rescanContext?.decayingRecipes?.filter((r) => r.knowledgeType === dimId) ?? []),
+            ];
+            const hasExistingRecipes = dimExistingRecipes.length > 0;
             // ── 构建 per-dimension 的 stages ──
             // NOTE: onToolCall 不再注入 ac.recordToolCall — ToolExecutionPipeline 的
             // traceRecord 中间件已通过 loopCtx.trace 统一记录,避免同一 AC 上双重记录。
             const analyzeStage = {
                 ...presetStages[0],
             };
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any -- pipeline stage shapes from PRESETS; needs PipelineStage interface (T4)
             let stages;
             if (needsCandidates) {
-                // 候选维度: Analyze→QualityGate→Produce→RejectionGate
                 const produceStage = {
                     ...presetStages[2],
                     promptBuilder: (ctx) => {
@@ -546,12 +488,26 @@ export async function fillDimensionsV3(fillContext) {
                         return presetStages[2].promptBuilder?.(ctx);
                     },
                 };
-                stages = [
-                    analyzeStage,
-                    presetStages[1], // quality_gate
-                    produceStage,
-                    presetStages[3], // rejection_gate
-                ];
+                if (hasExistingRecipes) {
+                    // 当前维度有旧 Recipe: Evolve→EvolutionGate→Analyze→QualityGate→Produce→RejectionGate
+                    stages = [
+                        evolutionPresetStages[0], // evolve
+                        evolutionPresetStages[1], // evolution_gate
+                        analyzeStage,
+                        presetStages[1], // quality_gate
+                        produceStage,
+                        presetStages[3], // rejection_gate
+                    ];
+                }
+                else {
+                    // 当前维度无旧 Recipe: Analyze→QualityGate→Produce→RejectionGate
+                    stages = [
+                        analyzeStage,
+                        presetStages[1], // quality_gate
+                        produceStage,
+                        presetStages[3], // rejection_gate
+                    ];
+                }
             }
             else {
                 // Skill-only 维度: 仅 Analyze
@@ -585,9 +541,53 @@ export async function fillDimensionsV3(fillContext) {
                 activeContext: memoryCoordinator.getActiveContext(analystScopeId),
                 outputType: dimConfig.outputType || 'analysis',
                 // §M1: Panorama 全景上下文 (Phase 1.8 数据注入)
-                panorama: buildPanoramaContext(fillContext, dimConfig),
+                panorama: buildPanoramaContext(panoramaResult, dimConfig),
+                // §ES: Evidence Starters — 从 Phase 1-4 数据提取维度级证据启发
+                evidenceStarters: buildEvidenceStarters(dimConfig, {
+                    astData: astProjectSummary,
+                    guardAudit,
+                    depGraphData,
+                    callGraphResult,
+                    panoramaResult,
+                }),
+                // §R1: Rescan 模式 — 已有 recipe 上下文 (避免重复分析/创建)
+                rescanContext: rescanContext
+                    ? {
+                        existingRecipes: rescanContext.existingRecipes.filter((r) => r.knowledgeType === dimId),
+                        decayingRecipes: rescanContext.decayingRecipes.filter((r) => r.knowledgeType === dimId),
+                        occupiedTriggers: rescanContext.occupiedTriggers,
+                        gap: Math.max(0, 5 - (rescanContext.coverageByDim[dimId] || 0)),
+                        existing: rescanContext.coverageByDim[dimId] || 0,
+                    }
+                    : null,
+                // §EVO: Evolution Stage — 当前维度全部现有 Recipe（healthy + decaying），附带 audit hint
+                existingRecipes: dimExistingRecipes.map((r) => ({
+                    id: r.id,
+                    title: r.title,
+                    trigger: r.trigger,
+                    content: r.content,
+                    sourceRefs: r.sourceRefs,
+                    auditHint: 'auditScore' in r && r.auditScore != null
+                        ? {
+                            relevanceScore: r.auditScore,
+                            verdict: r.status === 'decaying' ? 'decay' : 'watch',
+                            evidence: r.auditEvidence ?? {},
+                            decayReasons: r.decayReason
+                                ? [String(r.decayReason)]
+                                : [],
+                        }
+                        : null,
+                })),
+                // Evolution 上下文字段 — buildEvolverPrompt 直接从 strategyContext 读取
+                dimensionId: dimId,
+                dimensionLabel: dimConfig.label,
+                projectOverview: {
+                    primaryLang: primaryLang || projectInfo.lang || 'unknown',
+                    fileCount: projectInfo.fileCount || 0,
+                    modules: Object.keys(targetFileMap || {}),
+                },
                 // ── 引擎增强参数 (PipelineStrategy → reactLoop 透传) ──
-                contextWindow: agentFactory.createContextWindow({ isSystem: true }),
+                contextWindow: agentFactory?.createContextWindow({ isSystem: true }),
                 // B1 fix: 分析阶段使用 analyst 策略 (SCAN→EXPLORE→VERIFY→SUMMARIZE)
                 // 而非 bootstrap (EXPLORE→PRODUCE→SUMMARIZE)，避免 PRODUCE nudge 浪费轮次
                 // B3 fix: 透传完整 ANALYST_BUDGET (searchBudget/maxSubmits/softSubmitLimit/idleRoundsToExit)
@@ -609,7 +609,7 @@ export async function fillDimensionsV3(fillContext) {
             };
             // ── 执行 ──
             // 外层超时 = 安全网 (各阶段已有独立超时: Analyst 300s + Producer 180s + 硬缓冲 60s)
-            const outerTimeoutMs = 600_000;
+            const outerTimeoutMs = 3_600_000; // 1 小时——维度分析本身耗时长
             const runResult = await Promise.race([
                 runtime.execute(message, { strategyContext }),
                 new Promise((_, reject) => setTimeout(() => reject(new Error(`Bootstrap runtime timeout for "${dimId}"`)), outerTimeoutMs)),
@@ -686,6 +686,26 @@ export async function fillDimensionsV3(fillContext) {
             };
             candidateResults.created += producerResult.candidateCount;
             dimensionCandidates[dimId] = { analysisReport, producerResult };
+            // ── Producer 阶段详细日志 ──
+            if (needsCandidates) {
+                const producerToolCalls = produceResult?.toolCalls || [];
+                const producerToolNames = producerToolCalls.map((tc) => tc?.tool || tc?.name || 'unknown');
+                const toolBreakdown = {};
+                for (const name of producerToolNames) {
+                    toolBreakdown[name] = (toolBreakdown[name] || 0) + 1;
+                }
+                const breakdownStr = Object.entries(toolBreakdown)
+                    .map(([k, v]) => `${k}=${v}`)
+                    .join(', ');
+                logger.info(`[Producer] "${dimId}": submitted=${submitCalls.length}, accepted=${successCount}, rejected=${rejectedCount}, ` +
+                    `producerToolCalls=${producerToolCalls.length} (${breakdownStr || 'none'}), ` +
+                    `analysisInput=${analysisText.length} chars`);
+                if (successCount === 0 && submitCalls.length === 0) {
+                    logger.warn(`[Producer] "${dimId}": ⚠ Producer 未提交任何候选。` +
+                        `分析文本=${analysisText.length} chars, findings=${(analysisReport.findings || []).length}, ` +
+                        `producerIterations=${producerToolCalls.length}, degraded=${runResult?.degraded || false}`);
+                }
+            }
             // ── Memory Update ──
             const ac = memoryCoordinator.getActiveContext(analystScopeId);
             const distilled = ac
@@ -866,9 +886,9 @@ export async function fillDimensionsV3(fillContext) {
         logger.info(`[Insight-v3] Memory stats: ${emStats.completedDimensions} dims, ` +
             `${emStats.totalFindings} findings, ${emStats.referencedFiles} files, ` +
             `${emStats.crossReferences} cross-refs, ${emStats.tierReflections} reflections`);
-        if (emStats.cacheStats) {
-            logger.info(`[Insight-v3] Cache stats: ${emStats.cacheStats.hitRate} hit rate, ` +
-                `${emStats.cacheStats.searchCacheSize} searches, ${emStats.cacheStats.fileCacheSize} files`);
+        if (emStats.cache) {
+            logger.info(`[Insight-v3] Cache stats: ${emStats.cache.hitRate} hit rate, ` +
+                `${emStats.cache.searchCacheSize} searches, ${emStats.cache.fileCacheSize} files`);
         }
     }
     else {
@@ -910,9 +930,8 @@ export async function fillDimensionsV3(fillContext) {
                 const referencedFiles = dimData.analysisReport.referencedFiles || [];
                 // 从 SessionStore 获取结构化发现，供 Skill 生成使用
                 const dimReport = sessionStore.getDimensionReport(dim.id);
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any -- SessionStore Finding type varies
                 const keyFindings = (dimReport?.findings || [])
-                    .sort((a, b) => (b.importance || 5) - (a.importance || 5))
+                    .sort((a, b) => (Number(b.importance) || 5) - (Number(a.importance) || 5))
                     .slice(0, 10)
                     .map((f) => String(f.finding || ''));
                 // 当 analysisText 过短（如 force-exit 时 AI 仅输出 JSON digest 被清洗后）

package/dist/lib/external/mcp/handlers/bootstrap/pipeline/tier-scheduler.js

@@ -16,28 +16,18 @@
  *
  * @module TierScheduler
  */
+import { buildTierPlan } from '#domain/dimension/index.js';
 import Logger from '#infra/logging/Logger.js';
 import { createLimit } from '#shared/concurrency.js';
 const logger = Logger.getInstance();
 // ──────────────────────────────────────────────────────────────────
-// 分层定义
+// 分层定义 — 从统一注册表动态生成
 // ──────────────────────────────────────────────────────────────────
-const DEFAULT_TIERS = [
-    // Tier 1: 基础数据（通用 + 语言条件维度并行执行）
-    [
-        'project-profile',
-        'objc-deep-scan',
-        'category-scan',
-        'module-export-scan',
-        'framework-convention-scan',
-        'python-package-scan',
-        'jvm-annotation-scan',
-    ],
-    // Tier 2: 规范+架构+模式
-    ['code-standard', 'architecture', 'code-pattern'],
-    // Tier 3: 流转+实践+总结
-    ['event-and-data-flow', 'best-practice', 'agent-guidelines'],
-];
+/**
+ * 默认分层来自 DimensionRegistry.buildTierPlan()，
+ * 该函数根据每个维度的 tierHint 自动分配。
+ */
+const DEFAULT_TIERS = buildTierPlan();
 // ──────────────────────────────────────────────────────────────────
 // TierScheduler
 // ──────────────────────────────────────────────────────────────────

package/dist/lib/external/mcp/handlers/bootstrap/refine.js

@@ -21,6 +21,14 @@ export async function bootstrapRefine(ctx, args) {
             errorCode: 'MISSING_AI_PROVIDER',
         });
     }
+    // Mock 模式下跳过 AI 润色
+    if (aiProvider.name === 'mock') {
+        return envelope({
+            success: false,
+            message: 'AI Provider 未配置，当前为 Mock 模式。请先配置 API Key。',
+            errorCode: 'MOCK_MODE',
+        });
+    }
     // 接入 BootstrapTaskManager 双通道推送 refine:* 事件
     let onProgress = null;
     try {

package/dist/lib/external/mcp/handlers/bootstrap/shared/async-fill-helpers.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Shared helpers for async AI-fill pipeline dispatch.
+ *
+ * Previously duplicated in:
+ *   - bootstrap-internal.ts (Phase 5)
+ *   - rescan-internal.ts (Step 6-7)
+ *
+ * @module bootstrap/shared/async-fill-helpers
+ */
+import type { BootstrapSessionShape, DimensionDef } from '#types/project-snapshot.js';
+import type { PipelineFillView } from '#types/snapshot-views.js';
+import type { McpContext } from '../../types.js';
+interface TaskDef {
+    id: string;
+    meta: {
+        type: string;
+        dimId: string;
+        label: string | undefined;
+        skillWorthy: boolean;
+        skillMeta: Record<string, unknown> | null;
+    };
+}
+/**
+ * Build task definitions from dimensions for BootstrapTaskManager.
+ */
+export declare function buildTaskDefs(dimensions: DimensionDef[]): TaskDef[];
+interface TaskManagerLogger {
+    warn(...args: unknown[]): void;
+}
+/**
+ * Start a BootstrapTaskManager session (graceful degradation if unavailable).
+ */
+export declare function startTaskManagerSession(container: McpContext['container'], taskDefs: TaskDef[], logger: TaskManagerLogger, logPrefix: string): BootstrapSessionShape | null;
+/**
+ * Dispatch fillDimensionsV3 from a PipelineFillView.
+ *
+ * Passes the view directly to orchestrator (no more flat-context expansion).
+ * Fires via setImmediate (fire-and-forget).
+ *
+ * @param view - Typed PipelineFillView from handler
+ * @param dimensions - Active dimensions for this run (may differ from snapshot.activeDimensions for rescan gap-only)
+ * @param fillDimensionsV3 - The pipeline function to invoke
+ * @param logPrefix - Log prefix (e.g. 'Bootstrap', 'Rescan-Internal')
+ */
+export declare function dispatchPipelineFill(view: PipelineFillView, dimensions: DimensionDef[], fillDimensionsV3: (view: PipelineFillView, dimensions: DimensionDef[]) => Promise<void>, logPrefix: string): void;
+export {};

package/dist/lib/external/mcp/handlers/bootstrap/shared/async-fill-helpers.js

@@ -0,0 +1,58 @@
+/**
+ * Shared helpers for async AI-fill pipeline dispatch.
+ *
+ * Previously duplicated in:
+ *   - bootstrap-internal.ts (Phase 5)
+ *   - rescan-internal.ts (Step 6-7)
+ *
+ * @module bootstrap/shared/async-fill-helpers
+ */
+/**
+ * Build task definitions from dimensions for BootstrapTaskManager.
+ */
+export function buildTaskDefs(dimensions) {
+    return dimensions.map((dim) => ({
+        id: dim.id,
+        meta: {
+            type: dim.skillWorthy ? 'skill' : 'candidate',
+            dimId: dim.id,
+            label: dim.label,
+            skillWorthy: !!dim.skillWorthy,
+            skillMeta: dim.skillMeta || null,
+        },
+    }));
+}
+/**
+ * Start a BootstrapTaskManager session (graceful degradation if unavailable).
+ */
+export function startTaskManagerSession(container, taskDefs, logger, logPrefix) {
+    try {
+        const taskManager = container.get('bootstrapTaskManager');
+        return taskManager.startSession(taskDefs);
+    }
+    catch (e) {
+        logger.warn(`[${logPrefix}] BootstrapTaskManager init failed (graceful degradation): ${e instanceof Error ? e.message : String(e)}`);
+        return null;
+    }
+}
+// ── Pipeline Fill View dispatch (Phase D-2) ──────────────
+/**
+ * Dispatch fillDimensionsV3 from a PipelineFillView.
+ *
+ * Passes the view directly to orchestrator (no more flat-context expansion).
+ * Fires via setImmediate (fire-and-forget).
+ *
+ * @param view - Typed PipelineFillView from handler
+ * @param dimensions - Active dimensions for this run (may differ from snapshot.activeDimensions for rescan gap-only)
+ * @param fillDimensionsV3 - The pipeline function to invoke
+ * @param logPrefix - Log prefix (e.g. 'Bootstrap', 'Rescan-Internal')
+ */
+export function dispatchPipelineFill(view, dimensions, fillDimensionsV3, logPrefix) {
+    const ctxLogger = view.ctx.logger;
+    setImmediate(() => {
+        ctxLogger?.info(`[${logPrefix}] Dispatching v3 AI-First pipeline`);
+        fillDimensionsV3(view, dimensions).catch((e) => {
+            ctxLogger?.error(`[${logPrefix}] Async fill failed: ${e instanceof Error ? e.message : String(e)}`);
+        });
+    });
+}