autosnippet 3.3.4 → 3.3.6

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)}`);
+        });
+    });
+}

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

@@ -0,0 +1,25 @@
+/**
+ * Shared helpers for recipe relevance audit.
+ *
+ * Previously duplicated in:
+ *   - rescan-internal.ts (Step 4)
+ *   - rescan-external.ts (Step 4)
+ *
+ * @module bootstrap/shared/audit-helpers
+ */
+import type { AstSummary, DependencyGraph } from '#types/project-snapshot.js';
+/**
+ * Extract code entities from AST project summary for audit evidence matching.
+ */
+export declare function extractCodeEntities(astProjectSummary: AstSummary | null | undefined): Array<{
+    name: string;
+    kind?: string;
+    file?: string;
+}>;
+/**
+ * Extract dependency edges from the dependency graph for audit evidence matching.
+ */
+export declare function extractDependencyEdges(depGraphData: DependencyGraph | null | undefined): Array<{
+    from: string;
+    to: string;
+}>;

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

@@ -0,0 +1,47 @@
+/**
+ * Shared helpers for recipe relevance audit.
+ *
+ * Previously duplicated in:
+ *   - rescan-internal.ts (Step 4)
+ *   - rescan-external.ts (Step 4)
+ *
+ * @module bootstrap/shared/audit-helpers
+ */
+// ── AST entity extraction ────────────────────────────────
+/**
+ * Extract code entities from AST project summary for audit evidence matching.
+ */
+export function extractCodeEntities(astProjectSummary) {
+    const entities = [];
+    if (!astProjectSummary) {
+        return entities;
+    }
+    for (const cls of astProjectSummary.classes || []) {
+        entities.push({ name: cls.name, kind: 'class', file: cls.relativePath || cls.file });
+    }
+    for (const proto of astProjectSummary.protocols || []) {
+        entities.push({ name: proto.name, kind: 'protocol', file: proto.relativePath || proto.file });
+    }
+    if (astProjectSummary.categories) {
+        for (const cat of astProjectSummary.categories) {
+            entities.push({ name: cat.name || '', kind: 'category', file: cat.relativePath || cat.file });
+        }
+    }
+    return entities;
+}
+// ── Dependency edge extraction ───────────────────────────
+/**
+ * Extract dependency edges from the dependency graph for audit evidence matching.
+ */
+export function extractDependencyEdges(depGraphData) {
+    const edges = [];
+    if (!depGraphData?.edges) {
+        return edges;
+    }
+    for (const edge of depGraphData.edges) {
+        if (edge.from && edge.to) {
+            edges.push({ from: edge.from, to: edge.to });
+        }
+    }
+    return edges;
+}

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

@@ -17,6 +17,8 @@
  *
  * @module bootstrap/shared/bootstrap-phases
  */
+import type { ProjectAnalysisResult } from '#core/AstAnalyzer.js';
+import type { GuardAudit } from '#types/project-snapshot.js';
 import { type BaseDimension } from '../base-dimensions.js';
 /** Logger with required info/warn (compatible with Logger singleton) */
 interface PhaseLogger {
@@ -56,8 +58,8 @@ interface DepGraphData {
     }>;
     [key: string]: unknown;
 }
-type AstProjectSummaryLike = Record<string, any>;
-type GuardAuditLike = Record<string, any>;
+type AstProjectSummaryLike = ProjectAnalysisResult;
+type GuardAuditLike = GuardAudit;
 /** Minimal guard engine shape */
 interface GuardEngineLike {
     auditFiles(files: Array<{
@@ -163,7 +165,7 @@ export declare function runPhase1_FileCollection(projectRoot: string, logger: Ph
  * @returns >}
  */
 export declare function runPhase1_5_AstAnalysis(allFiles: BootstrapFileEntry[], langStats: Record<string, number>, logger: PhaseLogger, options?: AstAnalysisOptions): Promise<{
-    astProjectSummary: AstProjectSummaryLike | null;
+    astProjectSummary: ProjectAnalysisResult | null;
     astContext: string;
     warnings: string[];
 }>;
@@ -175,7 +177,11 @@ export declare function runPhase1_5_AstAnalysis(allFiles: BootstrapFileEntry[],
  * @returns >}
  */
 export declare function runPhase1_6_EntityGraph(astProjectSummary: AstProjectSummaryLike | null, projectRoot: string, container: PhaseContainer, logger: PhaseLogger): Promise<{
-    codeEntityResult: Record<string, any> | null;
+    codeEntityResult: {
+        entitiesUpserted: number;
+        edgesCreated: number;
+        durationMs: number;
+    } | null;
     warnings: string[];
 }>;
 /**
@@ -190,7 +196,11 @@ export declare function runPhase1_6_EntityGraph(astProjectSummary: AstProjectSum
  * @returns >}
  */
 export declare function runPhase1_7_CallGraph(astProjectSummary: AstProjectSummaryLike | null, projectRoot: string, container: PhaseContainer, logger: PhaseLogger, incrementalOpts?: IncrementalCallGraphOpts | null): Promise<{
-    callGraphResult: Record<string, any> | null;
+    callGraphResult: {
+        entitiesUpserted: number;
+        edgesCreated: number;
+        durationMs: number;
+    } | null;
     warnings: string[];
 }>;
 /**
@@ -220,7 +230,7 @@ export declare function runPhase2_1_ModuleEntities(depGraphData: DepGraphData |
  * @returns >}
  */
 export declare function runPhase3_GuardAudit(allFiles: BootstrapFileEntry[], container: PhaseContainer, logger: PhaseLogger, options?: GuardAuditOptions): Promise<{
-    guardAudit: GuardAuditLike | null;
+    guardAudit: GuardAudit | null;
     guardEngine: GuardEngineLike | null;
     warnings: string[];
 }>;
@@ -260,7 +270,7 @@ export declare function runPhase4_DimensionResolve(params: Phase4Params): Promis
         isMultiLang: boolean;
     };
     detectedFrameworks: string[];
-    guardAudit: GuardAuditLike | null;
+    guardAudit: GuardAudit | null;
 }>;
 /**
  * runAllPhases — 一站式执行 Phase 1~4 全部数据收集
@@ -281,6 +291,7 @@ export declare function runAllPhases(projectRoot: string, ctx: AllPhasesContext,
     primaryLang: null;
     discoverer: DiscovererLike;
     allTargets: TargetItem[];
+    truncated: boolean;
     astProjectSummary: null;
     astContext: string;
     codeEntityResult: null;
@@ -295,6 +306,7 @@ export declare function runAllPhases(projectRoot: string, ctx: AllPhasesContext,
     enhancementGuardRules: never[];
     langProfile: {};
     targetsSummary: never[];
+    localPackageModules: never[];
     warnings: string[];
     report: {};
     incrementalPlan: null;
@@ -307,13 +319,22 @@ export declare function runAllPhases(projectRoot: string, ctx: AllPhasesContext,
     primaryLang: string;
     discoverer: DiscovererLike;
     allTargets: TargetItem[];
-    astProjectSummary: AstProjectSummaryLike | null;
+    truncated: boolean;
+    astProjectSummary: ProjectAnalysisResult | null;
     astContext: string;
-    codeEntityResult: Record<string, any> | null;
-    callGraphResult: Record<string, any> | null;
+    codeEntityResult: {
+        entitiesUpserted: number;
+        edgesCreated: number;
+        durationMs: number;
+    } | null;
+    callGraphResult: {
+        entitiesUpserted: number;
+        edgesCreated: number;
+        durationMs: number;
+    } | null;
     depGraphData: DepGraphData | null;
     depEdgesWritten: number;
-    guardAudit: GuardAuditLike | null;
+    guardAudit: GuardAudit | null;
     guardEngine: GuardEngineLike | null;
     activeDimensions: BaseDimension[];
     enhancementPackInfo: {
@@ -340,10 +361,27 @@ export declare function runAllPhases(projectRoot: string, ctx: AllPhasesContext,
         packageName: string | undefined;
         inferredRole: string;
         fileCount: number;
+        isLocalPackage: boolean | undefined;
+    }[];
+    localPackageModules: {
+        name: string;
+        packageName: string;
+        fileCount: number;
+        inferredRole: string;
+        keyFiles: string[];
     }[];
     warnings: string[];
     report: PhaseReport | null;
-    incrementalPlan: Record<string, any> | null;
+    incrementalPlan: {
+        mode: string;
+        canIncremental: boolean;
+        affectedDimensions: string[];
+        skippedDimensions: string[];
+        reason: string;
+        diff?: unknown;
+        previousSnapshot?: unknown;
+        restoredEpisodic?: unknown;
+    } | null;
     panoramaResult: Record<string, unknown> | null;
     isEmpty: boolean;
 }>;

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

@@ -20,7 +20,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { analyzeProject, isAvailable as astIsAvailable, generateContextForAgent, } from '#core/AstAnalyzer.js';
-import { DimensionCopy } from '#service/bootstrap/DimensionCopyRegistry.js';
+import { DimensionCopy } from '#domain/dimension/DimensionCopy.js';
 import { LanguageService } from '#shared/LanguageService.js';
 import pathGuard from '#shared/PathGuard.js';
 import { detectPrimaryLanguage } from '../../LanguageExtensions.js';
@@ -214,7 +214,6 @@ export async function runPhase1_5_AstAnalysis(allFiles, langStats, logger, optio
  */
 export async function runPhase1_6_EntityGraph(astProjectSummary, projectRoot, container, logger) {
     const warnings = [];
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- opaque result from CodeEntityGraph.populateFromAst
     let codeEntityResult = null;
     if (astProjectSummary) {
         try {
@@ -223,7 +222,7 @@ export async function runPhase1_6_EntityGraph(astProjectSummary, projectRoot, co
             if (db) {
                 const ceg = new CodeEntityGraph(db, { projectRoot });
                 ceg.clearProject();
-                // eslint-disable-next-line @typescript-eslint/no-unsafe-argument -- AstProjectSummaryLike is structurally compatible at runtime
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-argument -- ProjectAnalysisResult structurally compatible at runtime
                 codeEntityResult = ceg.populateFromAst(astProjectSummary);
                 logger.info(`[Bootstrap] Entity Graph: ${codeEntityResult.entitiesUpserted} entities, ${codeEntityResult.edgesCreated} edges`);
             }
@@ -249,7 +248,6 @@ export async function runPhase1_6_EntityGraph(astProjectSummary, projectRoot, co
  */
 export async function runPhase1_7_CallGraph(astProjectSummary, projectRoot, container, logger, incrementalOpts = null) {
     const warnings = [];
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- opaque result from CodeEntityGraph.populateCallGraph
     let callGraphResult = null;
     if (!astProjectSummary?.fileSummaries?.length) {
         return { callGraphResult, warnings };
@@ -268,13 +266,13 @@ export async function runPhase1_7_CallGraph(astProjectSummary, projectRoot, cont
         const isIncremental = (changedFiles?.length ?? 0) > 0 && changedFiles.length <= 10;
         // Phase 5 分析 (带超时保护 + 渐进式 partial result)
         const result = isIncremental
-            ? // eslint-disable-next-line @typescript-eslint/no-unsafe-argument -- AstProjectSummaryLike structurally compatible
+            ? // eslint-disable-next-line @typescript-eslint/no-unsafe-argument -- ProjectAnalysisResult structurally compatible with AstProjectSummary
                 await analyzer.analyzeIncremental(astProjectSummary, changedFiles, {
                     timeout: 15_000,
                     maxCallSitesPerFile: 500,
                     minConfidence: 0.5,
                 })
-            : // eslint-disable-next-line @typescript-eslint/no-unsafe-argument -- AstProjectSummaryLike structurally compatible
+            : // eslint-disable-next-line @typescript-eslint/no-unsafe-argument -- ProjectAnalysisResult structurally compatible with AstProjectSummary
                 await analyzer.analyze(astProjectSummary, {
                     timeout: 15_000,
                     maxCallSitesPerFile: 500,
@@ -389,10 +387,11 @@ export async function runPhase3_GuardAudit(allFiles, container, logger, options
             const prefix = options.summaryPrefix || 'Bootstrap scan';
             for (const fileResult of guardAudit.files || []) {
                 if (fileResult.violations.length > 0) {
+                    const fileSummary = fileResult.summary;
                     violationsStore.appendRun({
                         filePath: fileResult.filePath,
                         violations: fileResult.violations,
-                        summary: `${prefix}: ${fileResult.summary.errors}E ${fileResult.summary.warnings}W`,
+                        summary: `${prefix}: ${fileSummary?.errors ?? 0}E ${fileSummary?.warnings ?? 0}W`,
                     });
                 }
             }
@@ -484,7 +483,7 @@ export async function runPhase4_DimensionResolve(params) {
                 content: f.content,
             }));
             guardAudit = guardEngine.auditFiles(guardFiles, { scope: 'project' });
-            logger.info(`[Bootstrap] Guard re-audit with ${guardEngine.getExternalRuleCount()} Enhancement Pack rules → ${guardAudit.summary.totalViolations} total violations`);
+            logger.info(`[Bootstrap] Guard re-audit with ${guardEngine.getExternalRuleCount()} Enhancement Pack rules → ${guardAudit.summary?.totalViolations ?? 0} total violations`);
         }
         catch (e) {
             logger.warn(`[Bootstrap] Enhancement Pack guard re-audit failed: ${e instanceof Error ? e.message : String(e)}`);
@@ -561,6 +560,7 @@ export async function runAllPhases(projectRoot, ctx, options = {}) {
             primaryLang: null,
             discoverer,
             allTargets,
+            truncated,
             astProjectSummary: null,
             astContext: '',
             codeEntityResult: null,
@@ -575,6 +575,7 @@ export async function runAllPhases(projectRoot, ctx, options = {}) {
             enhancementGuardRules: [],
             langProfile: {},
             targetsSummary: [],
+            localPackageModules: [],
             warnings,
             report: report || {},
             incrementalPlan: null,
@@ -584,7 +585,6 @@ export async function runAllPhases(projectRoot, ctx, options = {}) {
         };
     }
     // ── Incremental evaluation (Phase 1 后执行，需要 allFiles) ──
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- IncrementalBootstrap.evaluate returns opaque plan object
     let incrementalPlan = null;
     if (options.incremental) {
         try {
@@ -710,14 +710,32 @@ export async function runAllPhases(projectRoot, ctx, options = {}) {
     // Targets 摘要
     const targetsSummary = allTargets.map((t) => {
         const name = typeof t === 'string' ? t : t.name;
+        const pkgName = typeof t === 'object' ? t.packageName : undefined;
+        const targetPath = typeof t === 'object' ? t.path : undefined;
         return {
             name,
             type: (typeof t === 'object' ? t.type : undefined) || 'target',
-            packageName: (typeof t === 'object' ? t.packageName : undefined) || undefined,
+            packageName: pkgName || undefined,
             inferredRole: inferTargetRole(name),
             fileCount: allFiles.filter((f) => f.targetName === name).length,
+            // 标记来自子包的 target（如 Packages/AOXNetworkKit）—— 语言无关
+            isLocalPackage: typeof targetPath === 'string' && targetPath !== projectRoot ? true : undefined,
         };
     });
+    // 本地子包汇总 — 供 MissionBriefing 构建 mustCoverModules
+    const localPackageModules = targetsSummary
+        .filter((t) => t.isLocalPackage && t.fileCount > 0)
+        .map((t) => ({
+        name: t.name,
+        packageName: t.packageName || t.name,
+        fileCount: t.fileCount,
+        inferredRole: t.inferredRole,
+        // 提取该模块的关键文件路径（前 8 个，用于 evidenceStarters）
+        keyFiles: allFiles
+            .filter((f) => f.targetName === t.name)
+            .slice(0, 8)
+            .map((f) => f.relativePath),
+    }));
     // 完成报告
     if (report) {
         report.totalMs = Date.now() - report.startTime;
@@ -728,6 +746,7 @@ export async function runAllPhases(projectRoot, ctx, options = {}) {
         primaryLang,
         discoverer,
         allTargets,
+        truncated,
         astProjectSummary: phase1_5.astProjectSummary,
         astContext: phase1_5.astContext,
         codeEntityResult: phase1_6.codeEntityResult,
@@ -743,6 +762,7 @@ export async function runAllPhases(projectRoot, ctx, options = {}) {
         langProfile: phase4.langProfile,
         detectedFrameworks: phase4.detectedFrameworks,
         targetsSummary,
+        localPackageModules, // 本地子包汇总（语言无关）
         warnings,
         report, // NEW: Phase 级报告 (null if generateReport=false)
         incrementalPlan, // NEW: 增量评估结果 (null if incremental=false)

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

@@ -42,7 +42,7 @@ export const SUBMISSION_SCHEMA = {
         'content.markdown ≥ 200 字符',
         '至少包含 1 个代码块 (```)',
         '包含来源标注 (来源: FileName:行号)',
-        '标题使用项目真实类名',
+        '标题使用项目真实类名（不以项目名开头）',
         'trigger 必须唯一（同批次内不重复）',
     ],
 };

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

@@ -0,0 +1,24 @@
+/**
+ * Shared type definitions for bootstrap & rescan handler modules.
+ *
+ * Consolidates interfaces previously duplicated across:
+ *   - bootstrap-internal.ts
+ *   - bootstrap-external.ts
+ *   - rescan-internal.ts
+ *   - rescan-external.ts
+ *
+ * v2: 类型统一到 project-snapshot.ts，本文件 re-export + 提供向后兼容别名。
+ *
+ * @module bootstrap/shared/handler-types
+ */
+export type { BootstrapSessionShape, DimensionDef, GuardAuditFileEntry as GuardAuditFile, GuardViolation, MissionBriefingResult, } from '#types/project-snapshot.js';
+/** Processed source file with language + priority metadata */
+export interface TargetFile {
+    name: string;
+    relativePath: string;
+    language: string;
+    totalLines: number;
+    priority: string;
+    content: string;
+    truncated: boolean;
+}

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

@@ -0,0 +1,14 @@
+/**
+ * Shared type definitions for bootstrap & rescan handler modules.
+ *
+ * Consolidates interfaces previously duplicated across:
+ *   - bootstrap-internal.ts
+ *   - bootstrap-external.ts
+ *   - rescan-internal.ts
+ *   - rescan-external.ts
+ *
+ * v2: 类型统一到 project-snapshot.ts，本文件 re-export + 提供向后兼容别名。
+ *
+ * @module bootstrap/shared/handler-types
+ */
+export {};

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

@@ -0,0 +1,14 @@
+/**
+ * Panorama summarization helper for internal agent responses.
+ *
+ * Extracted from bootstrap-internal.ts.
+ * Note: MissionBriefingBuilder has its own typed version for the MissionBriefing interface.
+ *
+ * @module bootstrap/shared/panorama-utils
+ */
+/**
+ * Summarize PanoramaResult into a compact internal-agent-friendly shape.
+ *
+ * Returns the top layers, coupling hotspots, cyclic dependencies, and knowledge gaps.
+ */
+export declare function summarizePanorama(panoramaResult: unknown): Record<string, unknown> | null;

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

@@ -0,0 +1,48 @@
+/**
+ * Panorama summarization helper for internal agent responses.
+ *
+ * Extracted from bootstrap-internal.ts.
+ * Note: MissionBriefingBuilder has its own typed version for the MissionBriefing interface.
+ *
+ * @module bootstrap/shared/panorama-utils
+ */
+/**
+ * Summarize PanoramaResult into a compact internal-agent-friendly shape.
+ *
+ * Returns the top layers, coupling hotspots, cyclic dependencies, and knowledge gaps.
+ */
+export function summarizePanorama(panoramaResult) {
+    if (!panoramaResult || typeof panoramaResult !== 'object') {
+        return null;
+    }
+    const pr = panoramaResult;
+    const moduleMap = pr.modules;
+    const layers = pr.layers;
+    const gaps = pr.gaps ?? [];
+    const cycles = pr.cycles ?? [];
+    // Coupling hotspots: fanIn >= 10 or fanOut >= 10
+    const couplingHotspots = [];
+    if (moduleMap) {
+        const entries = moduleMap instanceof Map
+            ? [...moduleMap.values()]
+            : Object.values(moduleMap);
+        for (const mod of entries) {
+            if ((mod.fanIn || 0) >= 10 || (mod.fanOut || 0) >= 10) {
+                couplingHotspots.push({
+                    name: mod.name || '',
+                    fanIn: mod.fanIn || 0,
+                    fanOut: mod.fanOut || 0,
+                });
+            }
+        }
+    }
+    return {
+        layers: layers?.levels?.slice(0, 10) ?? [],
+        couplingHotspots: couplingHotspots.slice(0, 10),
+        cyclicDependencies: cycles.slice(0, 10).map((c) => c.modules),
+        knowledgeGaps: gaps.slice(0, 20).map((g) => ({
+            module: g.module,
+            suggestedFocus: g.suggestedFocus,
+        })),
+    };
+}

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

@@ -0,0 +1,21 @@
+/**
+ * Shared BootstrapSessionManager singleton management.
+ *
+ * Previously duplicated (with identical logic) in:
+ *   - bootstrap-internal.ts  → getOrCreateSessionManager()
+ *   - bootstrap-external.ts  → getSessionManager()
+ *   - rescan-external.ts     → getSessionManager()
+ *
+ * @module bootstrap/shared/session-helpers
+ */
+import type { McpContext } from '../../types.js';
+import { BootstrapSessionManager } from '../BootstrapSession.js';
+/**
+ * Get or create the process-level BootstrapSessionManager singleton.
+ *
+ * Resolution order:
+ *   1. Check container for registered instance
+ *   2. Fall back to module-level singleton
+ *   3. Register into container for cross-handler access
+ */
+export declare function getOrCreateSessionManager(container: McpContext['container']): BootstrapSessionManager;

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

@@ -0,0 +1,45 @@
+/**
+ * Shared BootstrapSessionManager singleton management.
+ *
+ * Previously duplicated (with identical logic) in:
+ *   - bootstrap-internal.ts  → getOrCreateSessionManager()
+ *   - bootstrap-external.ts  → getSessionManager()
+ *   - rescan-external.ts     → getSessionManager()
+ *
+ * @module bootstrap/shared/session-helpers
+ */
+import { BootstrapSessionManager } from '../BootstrapSession.js';
+// ── Process-level singleton ──────────────────────────────
+let _sessionManager = null;
+/**
+ * Get or create the process-level BootstrapSessionManager singleton.
+ *
+ * Resolution order:
+ *   1. Check container for registered instance
+ *   2. Fall back to module-level singleton
+ *   3. Register into container for cross-handler access
+ */
+export function getOrCreateSessionManager(container) {
+    // Check container first
+    try {
+        const mgr = container.get('bootstrapSessionManager');
+        if (mgr) {
+            return mgr;
+        }
+    }
+    catch {
+        /* not registered yet */
+    }
+    // Fall back to module-level singleton
+    if (!_sessionManager) {
+        _sessionManager = new BootstrapSessionManager();
+    }
+    // Register into container for cross-handler access
+    try {
+        container.register?.('bootstrapSessionManager', () => _sessionManager);
+    }
+    catch {
+        /* already registered or container doesn't support register */
+    }
+    return _sessionManager;
+}

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

@@ -19,7 +19,7 @@ interface SkillDimensionDef {
     skillMeta?: {
         name?: string;
         description?: string;
-    };
+    } | null;
 }
 /**
  * generateSkill — 标准化 Skill 生成入口