autosnippet 3.3.0 → 3.3.3

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

@@ -649,6 +649,45 @@ function buildExecutionPlan(activeDimensions) {
         workflow: '对每个维度: (1) 用你的原生能力阅读代码分析 → (2) 调用 autosnippet_submit_knowledge_batch 批量提交候选（**每维度最少 3 条，目标 5 条**，将不同关注点拆分为独立候选，1-2 条视为不合格） → (3) 调用 autosnippet_dimension_complete 完成维度（必须传 referencedFiles=[分析过的文件路径] 和 keyFindings=[3-5条关键发现]）',
     };
 }
+// ── Panorama 摘要构建 ──────────────────────────────────────
+/**
+ * 从 PanoramaResult 提取 layers / couplingHotspots / cycles / gaps
+ * 用于注入 MissionBriefing，使外部 Agent 获得项目全景视野
+ */
+function summarizePanorama(panoramaResult) {
+    if (!panoramaResult) {
+        return null;
+    }
+    try {
+        // PanoramaResult.layers: LayerHierarchy { levels: LayerLevel[] }
+        const layerHierarchy = panoramaResult.layers;
+        const layers = layerHierarchy?.levels ?? [];
+        // PanoramaResult.modules: Map<string, PanoramaModule>
+        const modules = panoramaResult.modules;
+        const couplingHotspots = [];
+        if (modules instanceof Map) {
+            for (const [, mod] of modules) {
+                if (mod.fanIn >= 10 || mod.fanOut >= 10) {
+                    couplingHotspots.push({ module: mod.name, fanIn: mod.fanIn, fanOut: mod.fanOut });
+                }
+            }
+            couplingHotspots.sort((a, b) => b.fanIn + b.fanOut - (a.fanIn + a.fanOut));
+        }
+        // PanoramaResult.cycles: CyclicDependency[]
+        const cycles = panoramaResult.cycles ?? [];
+        // PanoramaResult.gaps: KnowledgeGap[] (dimension-based)
+        const gaps = panoramaResult.gaps ?? [];
+        return {
+            layers: layers.slice(0, 10),
+            couplingHotspots: couplingHotspots.slice(0, 10),
+            cyclicDependencies: cycles.slice(0, 10),
+            knowledgeGaps: gaps.slice(0, 20),
+        };
+    }
+    catch {
+        return null;
+    }
+}
 // ── Mission Briefing 主构建函数 ──────────────────────────────
 /**
  * 构建 Mission Briefing
@@ -667,6 +706,7 @@ function buildExecutionPlan(activeDimensions) {
 export function buildMissionBriefing({ projectMeta, astData, codeEntityResult, callGraphResult, depGraphData, guardAudit, targets, activeDimensions, session, languageExtension, // §7.1: 语言扩展（反模式、Guard 规则、Agent 注意事项）
 incrementalPlan, // §7.3: 增量 Bootstrap 评估结果
 languageStats, // §7.4: 完整语言分布统计
+panoramaResult, // §M1: Phase 1.8 全景数据
  }) {
     const scheduler = new TierScheduler();
     // ── 构建维度任务列表 (v2: 附带 evidenceStarters) ──
@@ -727,6 +767,7 @@ languageStats, // §7.4: 完整语言分布统计
         // 完整语言统计（按文件扩展名计数）
         languageStats: languageStats || null,
         executionPlan: buildExecutionPlan(activeDimensions),
+        panorama: summarizePanorama(panoramaResult ?? null),
         session: session.toJSON(),
     };
     // ── 体积检测 + 渐进式压缩 ──

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

@@ -35,6 +35,53 @@ import { runNoAiFallback } from './noAiFallback.js';
 import { TierScheduler } from './tier-scheduler.js';
 const logger = Logger.getInstance();
 // ──────────────────────────────────────────────────────────────────
+// Panorama Context for strategyContext injection (M1 §5.2)
+// ──────────────────────────────────────────────────────────────────
+/**
+ * 从 fillContext.panoramaResult 提取维度级全景上下文
+ * 注入 strategyContext.panorama，使 Agent 获得模块角色/层级/耦合/空白区信息
+ */
+function buildPanoramaContext(fillContext, _dimConfig) {
+    const panoramaResult = fillContext.panoramaResult;
+    if (!panoramaResult) {
+        return null;
+    }
+    try {
+        const modules = panoramaResult.modules;
+        const layers = panoramaResult.layers;
+        const gaps = panoramaResult.gaps ?? [];
+        // 构建紧凑上下文
+        const layerNames = (layers?.levels ?? []).map((l) => `L${l.level}:${l.name}`).join(' → ');
+        const knownGaps = gaps.slice(0, 5).flatMap((g) => g.suggestedFocus ?? []);
+        // 找到与当前维度最相关的模块（如果 dimConfig 有 target 信息）
+        let moduleRole = null;
+        let moduleLayer = null;
+        let moduleCoupling = null;
+        if (modules instanceof Map && modules.size > 0) {
+            // 使用第一个模块作为代表（维度覆盖多模块时）
+            const firstMod = modules.values().next().value;
+            if (firstMod) {
+                moduleRole = firstMod.refinedRole ?? firstMod.inferredRole ?? null;
+                moduleLayer = firstMod.layer ?? null;
+                moduleCoupling = {
+                    fanIn: firstMod.fanIn ?? 0,
+                    fanOut: firstMod.fanOut ?? 0,
+                };
+            }
+        }
+        return {
+            moduleRole,
+            moduleLayer,
+            moduleCoupling,
+            knownGaps: [...new Set(knownGaps)],
+            layerContext: layerNames || null,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// ──────────────────────────────────────────────────────────────────
 // fillDimensionsV3 — v3.0 管线入口
 // ──────────────────────────────────────────────────────────────────
 /**
@@ -537,6 +584,8 @@ export async function fillDimensionsV3(fillContext) {
                 dimId,
                 activeContext: memoryCoordinator.getActiveContext(analystScopeId),
                 outputType: dimConfig.outputType || 'analysis',
+                // §M1: Panorama 全景上下文 (Phase 1.8 数据注入)
+                panorama: buildPanoramaContext(fillContext, dimConfig),
                 // ── 引擎增强参数 (PipelineStrategy → reactLoop 透传) ──
                 contextWindow: agentFactory.createContextWindow({ isSystem: true }),
                 // B1 fix: 分析阶段使用 analyst 策略 (SCAN→EXPLORE→VERIFY→SUMMARIZE)

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

@@ -9,6 +9,7 @@
  *   Phase 1   → 文件收集（DiscovererRegistry → 多语言项目类型检测）
  *   Phase 1.5 → AST 代码结构分析（tree-sitter + SFC 预处理）
  *   Phase 1.6 → Code Entity Graph（代码实体关系图谱）
+ *   Phase 1.8 → Panorama 全景汇总（RoleRefiner + CouplingAnalyzer + LayerInferrer）
  *   Phase 2   → 依赖关系 → knowledge_edges
  *   Phase 2.1 → Module 实体写入 Entity Graph
  *   Phase 3   → Guard 规则审计
@@ -297,6 +298,7 @@ export declare function runAllPhases(projectRoot: string, ctx: AllPhasesContext,
     warnings: string[];
     report: {};
     incrementalPlan: null;
+    panoramaResult: null;
     detectedFrameworks: never[];
     isEmpty: boolean;
 } | {
@@ -342,6 +344,7 @@ export declare function runAllPhases(projectRoot: string, ctx: AllPhasesContext,
     warnings: string[];
     report: PhaseReport | null;
     incrementalPlan: Record<string, any> | null;
+    panoramaResult: Record<string, unknown> | null;
     isEmpty: boolean;
 }>;
 export {};

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

@@ -9,6 +9,7 @@
  *   Phase 1   → 文件收集（DiscovererRegistry → 多语言项目类型检测）
  *   Phase 1.5 → AST 代码结构分析（tree-sitter + SFC 预处理）
  *   Phase 1.6 → Code Entity Graph（代码实体关系图谱）
+ *   Phase 1.8 → Panorama 全景汇总（RoleRefiner + CouplingAnalyzer + LayerInferrer）
  *   Phase 2   → 依赖关系 → knowledge_edges
  *   Phase 2.1 → Module 实体写入 Entity Graph
  *   Phase 3   → Guard 规则审计
@@ -577,6 +578,7 @@ export async function runAllPhases(projectRoot, ctx, options = {}) {
             warnings,
             report: report || {},
             incrementalPlan: null,
+            panoramaResult: null,
             detectedFrameworks: [],
             isEmpty: true,
         };
@@ -635,6 +637,30 @@ export async function runAllPhases(projectRoot, ctx, options = {}) {
     if (report) {
         report.phases.callGraph = { result: phase1_7.callGraphResult, ms: Date.now() - p17Start };
     }
+    // ── Phase 1.8: Panorama 全景汇总 ──
+    let panoramaResult = null;
+    try {
+        const panoramaService = ctx.container?.resolve?.('panoramaService');
+        if (panoramaService &&
+            typeof panoramaService.invalidate === 'function') {
+            const p18Start = Date.now();
+            panoramaService.invalidate();
+            const result = panoramaService.getResult();
+            panoramaResult = result;
+            ctx.logger.info(`[Bootstrap] Phase 1.8: Panorama computed in ${Date.now() - p18Start}ms`);
+            if (report) {
+                const overview = panoramaService.getOverview();
+                report.phases.panorama = {
+                    moduleCount: overview.moduleCount ?? 0,
+                    layerCount: overview.layerCount ?? 0,
+                    ms: Date.now() - p18Start,
+                };
+            }
+        }
+    }
+    catch (err) {
+        warnings.push(`Phase 1.8 panorama failed (non-blocking): ${err instanceof Error ? err.message : String(err)}`);
+    }
     // ── Phase 2: 依赖图 ──
     const p2Start = Date.now();
     const phase2 = await runPhase2_DependencyGraph(discoverer, ctx.container, ctx.logger, options.sourceTag || 'bootstrap');
@@ -720,6 +746,7 @@ export async function runAllPhases(projectRoot, ctx, options = {}) {
         warnings,
         report, // NEW: Phase 级报告 (null if generateReport=false)
         incrementalPlan, // NEW: 增量评估结果 (null if incremental=false)
+        panoramaResult, // Phase 1.8: 全景汇总 (null if panoramaService unavailable)
         isEmpty: false,
     };
 }

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

@@ -10,7 +10,7 @@
  */
 import fs from 'node:fs';
 import path from 'node:path';
-import { SKILLS_DIR } from '../../../../shared/package-root.js';
+import { SKILLS_DIR } from '#shared/package-root.js';
 const COLDSTART_SKILL_NAME = 'autosnippet-coldstart';
 /**
  * 加载 Bootstrap 相关 Skills（仅 coldstart Skill）

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

@@ -136,6 +136,7 @@ export async function bootstrapExternal(ctx) {
         languageExtension: buildLanguageExtension(primaryLang), // §7.1
         incrementalPlan,
         languageStats: langStats,
+        panoramaResult: phaseResults.panoramaResult, // §M1: Phase 1.8 全景数据
     });
     // 附加 warnings
     if (phaseResults.warnings.length > 0) {

package/dist/lib/external/mcp/handlers/bootstrap-internal.js

@@ -351,6 +351,8 @@ export async function bootstrapKnowledge(ctx, args) {
         projectRoot,
         // v5.0: 增量 Bootstrap 计划
         incrementalPlan,
+        // M1: Phase 1.8 全景数据 → strategyContext.panorama
+        panoramaResult: phaseResults.panoramaResult,
     };
     // 使用 setImmediate 避免阻塞 HTTP 响应
     // skipAsyncFill: CLI 非 --wait 模式跳过异步填充，避免进程退出后 DB 断连

package/dist/lib/external/mcp/handlers/browse.d.ts

@@ -67,6 +67,7 @@ export declare function getRecipe(ctx: McpContext, args: BrowseGetArgs): Promise
         } | undefined;
         headers: string[] | undefined;
         reasoning: {
+            sources?: unknown[] | undefined;
             confidence?: number | undefined;
             whyStandard?: string | undefined;
         } | undefined;

package/dist/lib/external/mcp/handlers/browse.js

@@ -74,11 +74,12 @@ function _projectForAgent(json) {
             ...((json.content.steps?.length ?? 0) > 0 ? { steps: json.content.steps } : {}),
         }
         : undefined;
-    // reasoning 精简：仅保留 whyStandard + confidence
+    // reasoning 精简：保留 whyStandard + confidence + sources（可信度证据链）
     const reasoning = json.reasoning
         ? {
             ...(json.reasoning.whyStandard ? { whyStandard: json.reasoning.whyStandard } : {}),
             ...(json.reasoning.confidence != null ? { confidence: json.reasoning.confidence } : {}),
+            ...((json.reasoning.sources?.length ?? 0) > 0 ? { sources: json.reasoning.sources } : {}),
         }
         : undefined;
     // constraints 精简：仅保留 guards 和 sideEffects

package/dist/lib/external/mcp/handlers/consolidated.d.ts

@@ -10,7 +10,7 @@
  */
 import * as guardHandlers from './guard.js';
 import * as structureHandlers from './structure.js';
-import type { ConsolidatedGraphArgs, ConsolidatedGuardArgs, ConsolidatedKnowledgeArgs, ConsolidatedSearchArgs, ConsolidatedSkillArgs, ConsolidatedStructureArgs, McpContext, SubmitKnowledgeArgs } from './types.js';
+import type { ConsolidatedGraphArgs, ConsolidatedGuardArgs, ConsolidatedKnowledgeArgs, ConsolidatedSearchArgs, ConsolidatedSkillArgs, ConsolidatedStructureArgs, McpContext } from './types.js';
 /**
  * 统合搜索：根据 mode 参数路由到对应搜索 handler
  *   auto (默认) → search()
@@ -112,6 +112,7 @@ export declare function consolidatedKnowledge(ctx: McpContext, args: Consolidate
         } | undefined;
         headers: string[] | undefined;
         reasoning: {
+            sources?: unknown[] | undefined;
             confidence?: number | undefined;
             whyStandard?: string | undefined;
         } | undefined;
@@ -307,6 +308,9 @@ export declare function consolidatedGraph(ctx: McpContext, args: ConsolidatedGra
 }>;
 /**
  * Guard 检查：按参数自动路由
+ *   operation: 'reverse_audit'      → guardReverseAudit()     (Recipe→Code 反向验证)
+ *   operation: 'coverage_matrix'    → guardCoverageMatrix()    (模块覆盖率矩阵)
+ *   operation: 'compliance_report'  → guardComplianceReport()  (3D 合规报告)
  *   无参数       → guardReview()    (自动 git diff 检测 + inline recipe)
  *   有 files     → guardReview()    (指定文件 + inline recipe) — files 为 string[] 或 {path}[]
  *   有 code      → guardCheck()     (单文件内联检查)
@@ -389,6 +393,12 @@ export declare function consolidatedGuard(ctx: McpContext, args: ConsolidatedGua
     errorCode: string | null;
     message: string;
     data: {
+        uncertainSummary?: {
+            total: number;
+            byLayer: Record<string, number>;
+            byReason: Record<string, number>;
+        } | undefined;
+        uncertainResults?: unknown[] | undefined;
         passed: boolean;
         reviewRound: any;
         fileSource: string;
@@ -407,6 +417,100 @@ export declare function consolidatedGuard(ctx: McpContext, args: ConsolidatedGua
         version: string;
         tool?: string | undefined;
     };
+} | {
+    success: boolean;
+    errorCode: string | null;
+    message: string;
+    data: {
+        totalRecipes: number;
+        healthy: number;
+        investigate: number;
+        decay: number;
+        drifts: {
+            recipeId: string;
+            title: string;
+            recommendation: import("../../../service/guard/ReverseGuard.js").ReverseRecommendation;
+            signals: import("../../../service/guard/ReverseGuard.js").PatternDriftSignal[];
+        }[];
+        allResults: {
+            recipeId: string;
+            title: string;
+            recommendation: import("../../../service/guard/ReverseGuard.js").ReverseRecommendation;
+            signalCount: number;
+        }[];
+    } | null;
+    meta: {
+        source?: string | undefined;
+        responseTimeMs?: number | undefined;
+        version: string;
+        tool?: string | undefined;
+    };
+} | {
+    success: boolean;
+    errorCode: string | null;
+    message: string;
+    data: {
+        overallCoverage: number;
+        zeroModules: string[];
+        lowModules: string[];
+        modules: import("../../../service/guard/CoverageAnalyzer.js").ModuleCoverage[];
+    } | null;
+    meta: {
+        source?: string | undefined;
+        responseTimeMs?: number | undefined;
+        version: string;
+        tool?: string | undefined;
+    };
+} | {
+    success: boolean;
+    errorCode: string | null;
+    message: string;
+    data: {
+        scores: {
+            compliance: number;
+            coverage: number;
+            confidence: number;
+        };
+        qualityGate: {
+            status: string;
+            score: number;
+            thresholds: {
+                maxErrors: number;
+                maxWarnings: number;
+                minScore: number;
+            };
+        };
+        summary: {
+            filesScanned: number;
+            totalViolations: number;
+            errors: number;
+            warnings: number;
+            infos: number;
+        };
+        uncertainSummary: {
+            total: number;
+            byLayer: Record<string, number>;
+            byReason: Record<string, number>;
+        };
+        boundaries: {
+            type: string;
+            description: string;
+            affectedRules: string[];
+            suggestedAction: string;
+        }[];
+        topViolations: any[];
+        trend: {
+            errorsChange: number;
+            warningsChange: number;
+            hasHistory: boolean;
+        };
+    } | null;
+    meta: {
+        source?: string | undefined;
+        responseTimeMs?: number | undefined;
+        version: string;
+        tool?: string | undefined;
+    };
 }>;
 /**
  * Skill 管理：根据 operation 参数路由
@@ -419,15 +523,22 @@ export declare function consolidatedGuard(ctx: McpContext, args: ConsolidatedGua
  */
 export declare function consolidatedSkill(ctx: McpContext, args: ConsolidatedSkillArgs): Promise<string>;
 /**
- * 增强版提交：严格前置校验，缺少必要字段直接拒绝（不入库）。
- * 通过校验后执行提交 + 去重检测，结果附在响应中。
- * v2: 成功提交后记录到 BootstrapSession.submissionTracker (如果有活跃 session)。
+ * 统一提交管线：单条与批量走同一代码路径。
+ *
+ * 流程:
+ *   1. 解析 items[] → 限流
+ *   2. 严格校验所有条目（UnifiedValidator）→ valid[] + rejected[]
+ *   3. 融合分析（ConsolidationAdvisor.analyzeBatch）→ submittable[] + blocked[]
+ *   4. 提交 submittable → enrich + service.create()
+ *   5. 返回统一结果
  *
  * 设计原则：
  *   - 不降级：缺字段不自动补全，要求 Agent 一次性生成完整数据
- *   - 不重复提交：拒绝时不创建任何记录，Agent 需补齐后重新调用
+ *   - 不碎片化：优先增强已有 Recipe，而非总新建
+ *   - 不重复提交：拒绝时不创建任何记录
+ *   - 单条/批量完全一致的校验与融合逻辑
  */
-export declare function enhancedSubmitKnowledge(ctx: McpContext, args: SubmitKnowledgeArgs): Promise<{
+export declare function enhancedSubmitKnowledge(ctx: McpContext, args: Record<string, unknown>): Promise<{
     success: boolean;
     errorCode: string | null;
     message: string;