autosnippet 3.4.0 → 3.4.2

package/dist/lib/external/ai/AiFactory.js

@@ -42,9 +42,11 @@ export function createProvider(options = {}) {
             break;
         case 'ollama':
             config.name = 'ollama';
-            config.baseUrl = config.baseUrl || 'http://localhost:11434/v1';
+            config.baseUrl =
+                config.baseUrl || process.env.ASD_OLLAMA_BASE_URL || 'http://localhost:11434/v1';
             config.apiKey = config.apiKey || 'ollama';
             config.model = config.model || 'llama3';
+            config.embedModel = config.embedModel || 'qwen3-embedding:0.6b';
             break;
         default:
             break;
@@ -172,10 +174,37 @@ export async function getProviderWithFallback() {
     }
     return primary;
 }
+/**
+ * 创建独立的 Embedding Provider
+ *
+ * 当 ASD_EMBED_PROVIDER 被设置时，创建一个专用于 embedding 的 provider 实例，
+ * 使 embedding 和 LLM 生成可以使用不同的提供商/模型。
+ *
+ * 典型场景：LLM 用 Google Gemini，Embedding 用本地 Ollama + qwen3-embedding
+ *
+ * @returns 独立的 embed provider，或 null（未配置时）
+ */
+export function createEmbedProvider() {
+    const embedProviderName = process.env.ASD_EMBED_PROVIDER;
+    if (!embedProviderName) {
+        return null;
+    }
+    const logger = Logger.getInstance();
+    logger.info(`[AiFactory] Creating dedicated embed provider: ${embedProviderName}`);
+    return createProvider({
+        provider: embedProviderName,
+        model: process.env.ASD_EMBED_MODEL || undefined,
+        baseUrl: process.env.ASD_EMBED_BASE_URL || undefined,
+        apiKey: process.env.ASD_EMBED_API_KEY || undefined,
+        embedModel: process.env.ASD_EMBED_MODEL || undefined,
+    });
+}
 /** 获取当前 AI 配置信息（同步，用于 UI 展示） */
 export function getAiConfigInfo() {
     const provider = process.env.ASD_AI_PROVIDER || 'auto';
     const model = process.env.ASD_AI_MODEL || '';
+    const embedProvider = process.env.ASD_EMBED_PROVIDER || '';
+    const embedModel = process.env.ASD_EMBED_MODEL || '';
     const hasGoogleKey = !!process.env.ASD_GOOGLE_API_KEY;
     const hasOpenAiKey = !!process.env.ASD_OPENAI_API_KEY;
     const hasClaudeKey = !!process.env.ASD_CLAUDE_API_KEY;
@@ -183,6 +212,8 @@ export function getAiConfigInfo() {
     return {
         provider,
         model,
+        embedProvider,
+        embedModel,
         hasKey: hasGoogleKey || hasOpenAiKey || hasClaudeKey || hasDeepSeekKey,
         keys: {
             google: hasGoogleKey,
@@ -200,6 +231,7 @@ export { MockProvider } from './providers/MockProvider.js';
 export { OpenAiProvider } from './providers/OpenAiProvider.js';
 export default {
     createProvider,
+    createEmbedProvider,
     autoDetectProvider,
     getAiConfigInfo,
     getProviderWithFallback,

package/dist/lib/external/ai/providers/GoogleGeminiProvider.js

@@ -9,8 +9,9 @@
 import Logger from '#infra/logging/Logger.js';
 import { AiProvider, } from '../AiProvider.js';
 const GEMINI_BASE = 'https://generativelanguage.googleapis.com/v1beta';
-const EMBED_MODEL = 'models/gemini-embedding-001';
+const DEFAULT_EMBED_MODEL = 'models/gemini-embedding-001';
 export class GoogleGeminiProvider extends AiProvider {
+    #embedModel;
     constructor(config = {}) {
         super({
             ...config,
@@ -20,6 +21,9 @@ export class GoogleGeminiProvider extends AiProvider {
         this.name = 'google-gemini';
         this.model = config.model || 'gemini-3-flash-preview';
         this.apiKey = config.apiKey || process.env.ASD_GOOGLE_API_KEY || '';
+        this.#embedModel = config.embedModel
+            ? `models/${config.embedModel.replace(/^models\//, '')}`
+            : DEFAULT_EMBED_MODEL;
         this.logger = Logger.getInstance();
     }
     /** 是否支持原生结构化函数调用 */
@@ -345,10 +349,10 @@ export class GoogleGeminiProvider extends AiProvider {
         for (let i = 0; i < texts.length; i += 100) {
             const batch = texts.slice(i, i + 100);
             const requests = batch.map((t) => ({
-                model: EMBED_MODEL,
+                model: this.#embedModel,
                 content: { parts: [{ text: t.slice(0, 8000) }] },
             }));
-            const url = `${GEMINI_BASE}/${EMBED_MODEL}:batchEmbedContents?key=${this.apiKey}`;
+            const url = `${GEMINI_BASE}/${this.#embedModel}:batchEmbedContents?key=${this.apiKey}`;
             const data = await this._post(url, { requests });
             if (data?.embeddings) {
                 results.push(...data.embeddings.map((e) => e.values));

package/dist/lib/external/ai/providers/OpenAiProvider.js

@@ -17,7 +17,7 @@ export class OpenAiProvider extends AiProvider {
         this.model = config.model || 'gpt-5.4-mini';
         this.apiKey = config.apiKey || process.env.ASD_OPENAI_API_KEY || '';
         this.baseUrl = config.baseUrl || OPENAI_BASE;
-        this.embedModel = config.embedModel || 'text-embedding-3-small';
+        this.embedModel = config.embedModel || process.env.ASD_EMBED_MODEL || 'text-embedding-3-small';
         this.logger = Logger.getInstance();
     }
     /**

package/dist/lib/external/mcp/handlers/bootstrap/MissionBriefingBuilder.d.ts

@@ -67,6 +67,7 @@ interface CompressedProtocol {
 /** 压缩后的 AST 类 */
 interface CompressedAstClass {
     name: string;
+    kind?: string;
     superclass?: string | null;
     file?: string | null;
     methodCount: number;
@@ -78,7 +79,11 @@ interface MissionBriefing {
     ast: {
         available: boolean;
         compressionLevel?: string;
-        summary?: string;
+        summary?: string | {
+            text: string;
+            kindDistribution: Record<string, number>;
+            insight: string;
+        };
         classes: CompressedAstClass[];
         protocols: CompressedProtocol[];
         categories?: {
@@ -96,6 +101,32 @@ interface MissionBriefing {
             longMethods?: number;
         } | null;
     };
+    architectureOverview?: {
+        style: string;
+        layers: {
+            name: string;
+            modules: string[];
+            fileCount: number;
+            role: string;
+        }[];
+        externalDeps: {
+            name: string;
+            role: string;
+        }[];
+        keyInsights: string[];
+    } | null;
+    technologyStack?: {
+        name: string;
+        role: string;
+        usedBy: string[];
+    }[] | null;
+    keyAbstractions?: {
+        name: string;
+        kind: string;
+        module: string;
+        significance: string;
+        detail: string;
+    }[] | null;
     codeEntityGraph: {
         totalEntities: number;
         totalEdges: number;
@@ -110,6 +141,7 @@ interface MissionBriefing {
             id: string;
             label: string;
             fileCount?: number;
+            dependentCount?: number;
         }[];
         edges: unknown[];
     } | null;

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

@@ -609,6 +609,7 @@ function compressAstForBriefing(astProjectSummary, fileCount) {
         .slice(0, topN);
     const compressedClasses = sortedClasses.map((c) => ({
         name: c.name,
+        kind: c.kind || 'class',
         superclass: c.superclass || null,
         file: c.file || c.relativePath || null,
         methodCount: c.methodCount || c.methods?.length || 0,
@@ -628,8 +629,43 @@ function compressAstForBriefing(astProjectSummary, fileCount) {
             .map((m) => (typeof m === 'string' ? m : m.name))
             .slice(0, 10),
     }));
-    const summary = `${classes.length} classes, ${protocols.length} protocols, ${categories.length} categories, ${astProjectSummary.projectMetrics?.totalMethods || 0} methods`;
-    // 压缩 patternStats: 保留计数，移除详细列表
+    // ── 结构化 summary: 含 kindDistribution + insight ──
+    const kindDist = {};
+    for (const c of dedupedClasses) {
+        const k = c.kind || 'class';
+        kindDist[k] = (kindDist[k] || 0) + 1;
+    }
+    const totalTypes = dedupedClasses.length;
+    const kindParts = Object.entries(kindDist)
+        .sort((a, b) => b[1] - a[1])
+        .map(([k, v]) => `${v} ${k}`);
+    const summaryText = `${totalTypes} types (${kindParts.join(', ')}), ${protocols.length} protocols, ${categories.length} ${categories.length > 0 && categories[0]?.baseClass ? 'categories' : 'extensions'}, ${astProjectSummary.projectMetrics?.totalMethods || 0} methods`;
+    // 生成 insight
+    const valueTypeCount = (kindDist.struct || 0) + (kindDist.enum || 0);
+    const refTypeCount = kindDist.class || 0;
+    const actorCount = kindDist.actor || 0;
+    let insight = '';
+    if (totalTypes > 0) {
+        const vtRatio = Math.round((valueTypeCount / totalTypes) * 100);
+        if (vtRatio >= 60) {
+            insight = `Value types (struct+enum) account for ${vtRatio}% — project favors value semantics`;
+        }
+        else if (refTypeCount > valueTypeCount) {
+            insight = `Reference types (class) account for ${Math.round((refTypeCount / totalTypes) * 100)}% — OOP-heavy codebase`;
+        }
+        else {
+            insight = `Balanced mix of value types (${vtRatio}%) and reference types (${Math.round((refTypeCount / totalTypes) * 100)}%)`;
+        }
+        if (actorCount > 0) {
+            insight += `; ${actorCount} actors indicate structured concurrency adoption`;
+        }
+    }
+    const summary = {
+        text: summaryText,
+        kindDistribution: kindDist,
+        insight,
+    };
+    // ── 压缩 patternStats: 保留计数 + 代表性类名 ──
     const rawPatterns = astProjectSummary.patternStats || {};
     const compressedPatterns = {};
     for (const [key, val] of Object.entries(rawPatterns)) {
@@ -640,17 +676,29 @@ function compressAstForBriefing(astProjectSummary, fileCount) {
             compressedPatterns[key] = val.length; // 数组 → 计数
         }
         else if (val && typeof val === 'object') {
-            // 嵌套对象: 保留 count/总数，或递归压缩为浅层概要
             const sub = {};
             for (const [sk, sv] of Object.entries(val)) {
                 if (typeof sv === 'number' || typeof sv === 'string' || typeof sv === 'boolean') {
                     sub[sk] = sv;
                 }
                 else if (Array.isArray(sv)) {
-                    sub[sk] = sv.length;
+                    // instances 数组: 提取 top-3 类名作为 representatives
+                    if (sk === 'instances' && sv.length > 0 && typeof sv[0] === 'object') {
+                        sub[sk] = sv.length;
+                        const classNames = sv
+                            .map((inst) => inst.className || '')
+                            .filter(Boolean);
+                        const unique = [...new Set(classNames)].slice(0, 3);
+                        if (unique.length > 0) {
+                            sub.representatives = unique.join(', ');
+                        }
+                    }
+                    else {
+                        sub[sk] = sv.length;
+                    }
                 }
                 else if (sv && typeof sv === 'object') {
-                    sub[sk] = Object.keys(sv).length; // 深层对象 → key 计数
+                    sub[sk] = Object.keys(sv).length;
                 }
             }
             compressedPatterns[key] = sub;
@@ -804,6 +852,300 @@ function buildExecutionPlan(activeDimensions) {
         workflow: '对每个维度: (1) 用你的原生能力阅读代码分析 → (2) 调用 autosnippet_submit_knowledge_batch 批量提交候选（**每维度最少 3 条，目标 5 条**，将不同关注点拆分为独立候选，1-2 条视为不合格） → (3) 调用 autosnippet_dimension_complete 完成维度（必须传 referencedFiles=[分析过的文件路径] 和 keyFindings=[3-5条关键发现]）',
     };
 }
+// ── Architecture Overview 自动推断 ────────────────────────
+/** 知名外部依赖的角色映射 */
+const KNOWN_DEPENDENCIES = {
+    // Swift / iOS
+    alamofire: 'HTTP networking',
+    moya: 'Network abstraction over Alamofire',
+    rxswift: 'Reactive programming (ReactiveX)',
+    rxcocoa: 'RxSwift UIKit bindings',
+    combine: 'Apple reactive framework',
+    kingfisher: 'Image downloading & caching',
+    sdwebimage: 'Image downloading & caching',
+    snapkit: 'Auto Layout DSL',
+    lottie: 'Animation rendering',
+    realm: 'Mobile database',
+    coredata: 'Apple persistence framework',
+    swiftui: 'Declarative UI framework',
+    // JavaScript / TypeScript
+    react: 'UI component framework',
+    vue: 'Progressive UI framework',
+    angular: 'Full-featured UI framework',
+    express: 'HTTP server framework',
+    nestjs: 'Enterprise Node.js framework',
+    axios: 'HTTP client',
+    prisma: 'Database ORM',
+    sequelize: 'SQL ORM',
+    mongoose: 'MongoDB ODM',
+    tailwindcss: 'Utility-first CSS',
+    webpack: 'Module bundler',
+    vite: 'Frontend build tool',
+    jest: 'Testing framework',
+    vitest: 'Vite-native testing',
+    redux: 'State management',
+    zustand: 'Lightweight state management',
+    // Go
+    gin: 'HTTP web framework',
+    echo: 'HTTP web framework',
+    gorm: 'Go ORM',
+    cobra: 'CLI framework',
+    // Python
+    django: 'Full-stack web framework',
+    flask: 'Micro web framework',
+    fastapi: 'Async web framework',
+    sqlalchemy: 'SQL toolkit & ORM',
+    pytorch: 'Deep learning framework',
+    tensorflow: 'Machine learning framework',
+    pandas: 'Data analysis library',
+    numpy: 'Numerical computing',
+};
+/**
+ * 从 targets + depGraph + localPackageModules 自动推断架构概览
+ */
+function buildArchitectureOverview(targets, depGraphData, localPackageModules) {
+    if (!targets || targets.length === 0) {
+        return null;
+    }
+    // ── 分层: 按 inferredRole 分组 ──
+    const roleGroups = {};
+    for (const t of targets) {
+        const role = t.inferredRole || 'unknown';
+        if (!roleGroups[role]) {
+            roleGroups[role] = { modules: [], fileCount: 0 };
+        }
+        roleGroups[role].modules.push(t.name);
+        roleGroups[role].fileCount += t.fileCount || 0;
+    }
+    // 层级命名映射
+    const ROLE_LAYER_MAP = {
+        app: {
+            name: 'App Shell',
+            priority: 0,
+            role: 'Application entry point, coordinators, DI assembly',
+        },
+        core: {
+            name: 'Core Infrastructure',
+            priority: 2,
+            role: 'Shared infrastructure libraries, base classes, utilities',
+        },
+        networking: {
+            name: 'Networking',
+            priority: 2,
+            role: 'Network client, middleware, API definitions',
+        },
+        feature: {
+            name: 'Feature Modules',
+            priority: 1,
+            role: 'Per-feature UI, view models, business logic',
+        },
+        ui: { name: 'UI Components', priority: 2, role: 'Shared UI components, themes, extensions' },
+        test: { name: 'Tests', priority: 3, role: 'Unit tests, integration tests, mocks' },
+        unknown: { name: 'Other', priority: 3, role: 'Uncategorized modules' },
+    };
+    const layers = [];
+    for (const [role, group] of Object.entries(roleGroups)) {
+        if (role === 'test') {
+            continue;
+        } // 测试模块不加入架构层
+        const layerDef = ROLE_LAYER_MAP[role] || ROLE_LAYER_MAP.unknown;
+        // 合并同优先级的层
+        const existing = layers.find((l) => l.name === layerDef.name);
+        if (existing) {
+            existing.modules.push(...group.modules);
+            existing.fileCount += group.fileCount;
+        }
+        else {
+            layers.push({
+                name: layerDef.name,
+                modules: [...group.modules],
+                fileCount: group.fileCount,
+                role: layerDef.role,
+            });
+        }
+    }
+    // 按 priority 排序 (App Shell → Features → Core → Other)
+    layers.sort((a, b) => {
+        const pa = Object.values(ROLE_LAYER_MAP).find((v) => v.name === a.name)?.priority ?? 99;
+        const pb = Object.values(ROLE_LAYER_MAP).find((v) => v.name === b.name)?.priority ?? 99;
+        return pa - pb;
+    });
+    // ── 外部依赖识别 ──
+    const externalDeps = [];
+    const localModuleNames = new Set(targets.map((t) => t.name));
+    if (depGraphData?.nodes) {
+        for (const n of depGraphData.nodes) {
+            const id = typeof n === 'string' ? n : n.id || '';
+            const label = typeof n === 'string' ? n : n.label || id;
+            if (!localModuleNames.has(id) && !localModuleNames.has(label)) {
+                const knownRole = KNOWN_DEPENDENCIES[label.toLowerCase()];
+                externalDeps.push({
+                    name: label,
+                    role: knownRole || 'third-party dependency',
+                });
+            }
+        }
+    }
+    // ── 关键洞察 ──
+    const insights = [];
+    const totalFiles = targets.reduce((s, t) => s + (t.fileCount || 0), 0);
+    const featureGroup = roleGroups.feature;
+    const coreGroup = roleGroups.core;
+    const networkGroup = roleGroups.networking;
+    // 本地子包占比
+    if (localPackageModules && localPackageModules.length > 0) {
+        const pkgFiles = localPackageModules.reduce((s, m) => s + m.fileCount, 0);
+        const pct = totalFiles > 0 ? Math.round((pkgFiles / totalFiles) * 100) : 0;
+        insights.push(`${localPackageModules.length} local packages provide ${pct}% of the codebase (${pkgFiles}/${totalFiles} files)`);
+    }
+    // Feature 模块特征
+    if (featureGroup) {
+        const avgFiles = Math.round(featureGroup.fileCount / featureGroup.modules.length);
+        if (avgFiles <= 5) {
+            insights.push(`Feature modules are thin (avg ${avgFiles} files) — business logic likely concentrates in core infrastructure`);
+        }
+        else {
+            insights.push(`Feature modules average ${avgFiles} files each — self-contained feature architecture`);
+        }
+    }
+    // 最大基础设施模块
+    if (coreGroup || networkGroup) {
+        const infraModules = [...(coreGroup?.modules || []), ...(networkGroup?.modules || [])];
+        const heaviest = targets
+            .filter((t) => infraModules.includes(t.name))
+            .sort((a, b) => (b.fileCount || 0) - (a.fileCount || 0));
+        if (heaviest.length > 0 && heaviest[0].fileCount) {
+            insights.push(`${heaviest[0].name} (${heaviest[0].fileCount} files) is the heaviest infrastructure module`);
+        }
+    }
+    // 推断架构风格
+    let style = 'Monolithic application';
+    if (localPackageModules && localPackageModules.length >= 2) {
+        style = 'Modular monolith (local packages)';
+    }
+    else if (targets.length >= 5 && featureGroup && featureGroup.modules.length >= 3) {
+        style = 'Feature-modular architecture';
+    }
+    return { style, layers, externalDeps, keyInsights: insights };
+}
+/**
+ * 从外部依赖图中提取技术栈信息
+ */
+function buildTechnologyStack(depGraphData, targets) {
+    if (!depGraphData?.nodes || !depGraphData?.edges) {
+        return null;
+    }
+    const localModuleNames = new Set(targets.map((t) => t.name));
+    const stack = [];
+    for (const n of depGraphData.nodes) {
+        const id = typeof n === 'string' ? n : n.id || '';
+        const label = typeof n === 'string' ? n : n.label || id;
+        if (localModuleNames.has(id) || localModuleNames.has(label)) {
+            continue;
+        }
+        const role = KNOWN_DEPENDENCIES[label.toLowerCase()] || 'third-party dependency';
+        // 找出哪些模块依赖它
+        const usedBy = (depGraphData.edges || [])
+            .filter((e) => {
+            const edge = e;
+            return edge.to === id || edge.to === label;
+        })
+            .map((e) => e.from)
+            .filter((f) => localModuleNames.has(f))
+            .slice(0, 5);
+        stack.push({ name: label, role, usedBy });
+    }
+    return stack.length > 0 ? stack : null;
+}
+/**
+ * 提取项目关键抽象 — 从继承热点、协议遵从数、模块入口类中识别
+ */
+function buildKeyAbstractions(astData, targets) {
+    if (!astData) {
+        return null;
+    }
+    const classes = astData.classes || [];
+    const protocols = astData.protocols || [];
+    const abstractions = [];
+    // §1: 高继承热点 — 被多个子类继承的基类
+    const subclassCount = {};
+    for (const cls of classes) {
+        if (cls.superclass) {
+            subclassCount[cls.superclass] = (subclassCount[cls.superclass] || 0) + 1;
+        }
+    }
+    const topBases = Object.entries(subclassCount)
+        .filter(([, count]) => count >= 2)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 5);
+    for (const [baseName, count] of topBases) {
+        const baseCls = classes.find((c) => c.name === baseName);
+        const module = baseCls?.targetName || _inferModule(baseCls?.file || baseCls?.relativePath, targets);
+        abstractions.push({
+            name: baseName,
+            kind: baseCls?.kind || 'class',
+            module,
+            significance: `Base class with ${count} subclasses`,
+            detail: `Subclasses: ${classes
+                .filter((c) => c.superclass === baseName)
+                .map((c) => c.name)
+                .slice(0, 5)
+                .join(', ')}`,
+        });
+    }
+    // §2: 高方法数类 — 复杂度热点
+    const methodHeavy = classes
+        .filter((c) => (c.methodCount || 0) >= 15)
+        .sort((a, b) => (b.methodCount || 0) - (a.methodCount || 0))
+        .slice(0, 3);
+    for (const cls of methodHeavy) {
+        // 跳过已在继承热点中出现的
+        if (abstractions.some((a) => a.name === cls.name)) {
+            continue;
+        }
+        const module = cls.targetName || _inferModule(cls.file || cls.relativePath, targets);
+        abstractions.push({
+            name: cls.name,
+            kind: cls.kind || 'class',
+            module,
+            significance: `Complexity hotspot (${cls.methodCount} methods)`,
+            detail: cls.superclass ? `extends ${cls.superclass}` : 'root class',
+        });
+    }
+    // §3: 高遵从协议 — 核心抽象接口
+    const protoWithConformers = protocols
+        .filter((p) => (p.conformers?.length || 0) >= 2 || (p.methodCount || 0) >= 3)
+        .sort((a, b) => (b.conformers?.length || 0) - (a.conformers?.length || 0))
+        .slice(0, 5);
+    for (const proto of protoWithConformers) {
+        const module = proto.targetName || _inferModule(proto.file || proto.relativePath, targets);
+        const conformerCount = proto.conformers?.length || 0;
+        abstractions.push({
+            name: proto.name,
+            kind: 'protocol',
+            module,
+            significance: conformerCount > 0
+                ? `Protocol with ${conformerCount} conformers`
+                : `Protocol with ${proto.methodCount || 0} method requirements`,
+            detail: conformerCount > 0
+                ? `Conformers: ${proto.conformers.slice(0, 5).join(', ')}`
+                : `${proto.methodCount || 0} required methods`,
+        });
+    }
+    return abstractions.length > 0 ? abstractions.slice(0, 10) : null;
+}
+/** 从文件路径推断模块名 */
+function _inferModule(filePath, targets) {
+    if (!filePath) {
+        return 'unknown';
+    }
+    for (const t of targets) {
+        if (filePath.includes(t.name)) {
+            return t.name;
+        }
+    }
+    return filePath.split('/')[0] || 'unknown';
+}
 // ── Panorama 摘要构建 ──────────────────────────────────────
 /**
  * 从 PanoramaResult 提取 layers / couplingHotspots / cycles / gaps
@@ -928,28 +1270,58 @@ localPackageModules, // 本地子包模块信息
         EXAMPLE_TEMPLATES[lang.toLowerCase()] ||
         EXAMPLE_TEMPLATES._default;
     // ── 组装 ──
+    // ── 依赖图节点去重 ──
+    const dedupedDepNodes = [];
+    if (depGraphData?.nodes) {
+        const nodeMap = new Map();
+        for (const n of depGraphData.nodes) {
+            const id = typeof n === 'string' ? n : n.id || '';
+            const label = typeof n === 'string' ? n : n.label || id;
+            const fileCount = typeof n === 'string' ? undefined : n.fileCount;
+            if (!nodeMap.has(id)) {
+                nodeMap.set(id, { id, label, fileCount, dependentCount: 0 });
+            }
+            else if (fileCount && !nodeMap.get(id).fileCount) {
+                nodeMap.get(id).fileCount = fileCount;
+            }
+        }
+        // 计算每个节点被多少模块依赖（fan-in）
+        for (const e of depGraphData.edges || []) {
+            const edge = e;
+            if (edge.to && nodeMap.has(edge.to)) {
+                nodeMap.get(edge.to).dependentCount++;
+            }
+        }
+        for (const node of nodeMap.values()) {
+            dedupedDepNodes.push(node);
+        }
+    }
+    // ── targets 构建 ──
+    const builtTargets = (targets || []).map((t) => ({
+        name: typeof t === 'string' ? t : t.name,
+        type: typeof t === 'string' ? 'target' : t.type || 'target',
+        inferredRole: typeof t === 'string' ? undefined : t.inferredRole,
+        fileCount: typeof t === 'string' ? undefined : t.fileCount,
+    }));
     const briefing = {
         projectMeta,
         ast: compressAstForBriefing(astData ?? null, projectMeta.fileCount || 0),
+        // 高层次架构概览 — Agent 一目了然项目结构
+        architectureOverview: buildArchitectureOverview(builtTargets, depGraphData ?? null, localPackageModules),
+        // 技术栈 — 外部依赖的角色识别
+        technologyStack: buildTechnologyStack(depGraphData ?? null, builtTargets),
+        // 关键抽象 — Agent 优先分析的核心类/协议
+        keyAbstractions: buildKeyAbstractions(astData ?? null, builtTargets),
         codeEntityGraph: summarizeEntityGraph(codeEntityResult ?? null),
         callGraph: summarizeCallGraph(callGraphResult ?? null),
-        dependencyGraph: depGraphData
+        dependencyGraph: dedupedDepNodes.length > 0
             ? {
-                nodes: (depGraphData.nodes || []).map((n) => ({
-                    id: typeof n === 'string' ? n : n.id || '',
-                    label: typeof n === 'string' ? n : n.label || '',
-                    fileCount: typeof n === 'string' ? undefined : n.fileCount,
-                })),
-                edges: (depGraphData.edges || []).slice(0, 100), // 限制边数
+                nodes: dedupedDepNodes,
+                edges: (depGraphData?.edges || []).slice(0, 100),
             }
             : null,
         guardFindings: summarizeGuardFindings(guardAudit ?? null),
-        targets: (targets || []).map((t) => ({
-            name: typeof t === 'string' ? t : t.name,
-            type: typeof t === 'string' ? 'target' : t.type || 'target',
-            inferredRole: typeof t === 'string' ? undefined : t.inferredRole,
-            fileCount: typeof t === 'string' ? undefined : t.fileCount,
-        })),
+        targets: builtTargets,
         dimensions,
         // §7.1: 语言扩展信息 (反模式、Guard 规则、Agent 注意事项)
         languageExtension: languageExtension || null,
@@ -1022,10 +1394,11 @@ localPackageModules, // 本地子包模块信息
         }
         else {
             // ── Level 4-5: 高代价压缩 (移除辅助数据) ──
-            // Level 4: 移除 evidenceStarters (体积优先)
+            // Level 4: 移除 evidenceStarters + technologyStack (体积优先)
             for (const dim of briefing.dimensions) {
                 delete dim.evidenceStarters;
             }
+            briefing.technologyStack = null;
             // Level 5: SOP 降级为紧凑文本 + 移除 FAIL_EXAMPLES
             for (const dim of briefing.dimensions) {
                 if (dim.analysisGuide && typeof dim.analysisGuide === 'object') {

package/dist/lib/external/mcp/handlers/bootstrap/pipeline/orchestrator.d.ts

@@ -68,6 +68,7 @@ interface BootstrapFileEntry {
 /** Task manager minimal shape */
 interface TaskManagerLike {
     isSessionValid(sessionId: string): boolean;
+    getSessionAbortSignal?(): AbortSignal | null;
     emitProgress?(event: string, data: Record<string, unknown>): void;
     [key: string]: unknown;
 }

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

@@ -113,6 +113,7 @@ export async function fillDimensionsV3(view, dimensions) {
         /* not available */
     }
     const sessionId = view.bootstrapSession?.id ?? '';
+    const sessionAbortSignal = taskManager?.getSessionAbortSignal?.() ?? null;
     const isIncremental = incrementalPlan?.canIncremental && incrementalPlan?.mode === 'incremental';
     const emitter = new BootstrapEventEmitter(ctx.container);
     logger.info(`[Insight-v3] ═══ fillDimensionsV3 entered — ${isIncremental ? 'INCREMENTAL' : 'FULL'} pipeline`);
@@ -623,7 +624,7 @@ export async function fillDimensionsV3(view, dimensions) {
             // 外层超时 = 安全网 (各阶段已有独立超时: Analyst 300s + Producer 180s + 硬缓冲 60s)
             const outerTimeoutMs = 3_600_000; // 1 小时——维度分析本身耗时长
             const runResult = await Promise.race([
-                runtime.execute(message, { strategyContext }),
+                runtime.execute(message, { strategyContext, abortSignal: sessionAbortSignal }),
                 new Promise((_, reject) => setTimeout(() => reject(new Error(`Bootstrap runtime timeout for "${dimId}"`)), outerTimeoutMs)),
             ]);
             // ── 提取结果 ──

package/dist/lib/external/mcp/handlers/bootstrap/shared/bootstrap-phases.d.ts

@@ -39,6 +39,8 @@ interface BootstrapFileEntry {
     relativePath: string;
     content: string;
     targetName: string;
+    /** Whether this file belongs to a test target or matches test file naming patterns */
+    isTest: boolean;
 }
 /** Target item — either a plain string or an object with metadata */
 type TargetItem = string | {