autosnippet 3.2.16 → 3.2.18

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

@@ -19,54 +19,20 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { analyzeProject, isAvailable as astIsAvailable, generateContextForAgent, } from '#core/AstAnalyzer.js';
-import { DimensionCopy } from '#shared/DimensionCopyRegistry.js';
+import { DimensionCopy } from '#service/bootstrap/DimensionCopyRegistry.js';
 import { LanguageService } from '#shared/LanguageService.js';
 import pathGuard from '#shared/PathGuard.js';
 import { detectPrimaryLanguage } from '../../LanguageExtensions.js';
 import { inferTargetRole } from '../../TargetClassifier.js';
 import { baseDimensions, resolveActiveDimensions } from '../base-dimensions.js';
 // ── 类型定义 ────────────────────────────────────────────────
-/**
- * @typedef {object} PhaseOptions
- * @property {number}  [maxFiles=500]         最大扫描文件数
- * @property {number}  [contentMaxLines=120]  每文件读取最大行数
- * @property {boolean} [skipGuard=false]      是否跳过 Guard 审计
- * @property {object}  [sourceTag='bootstrap'] 依赖图 edge 的 source 标签后缀
- * @property {boolean} [generateAstContext=false] 是否生成 astContext 文本（内部 Agent 专用）
- */
-/**
- * @typedef {object} PhaseResults
- * @property {Array}   allFiles             扫描到的所有文件 { name, path, relativePath, content, targetName }
- * @property {object}  langStats            语言统计 { ext: count }
- * @property {string}  primaryLang          主语言
- * @property {object}  discoverer           - Discoverer 实例
- * @property {Array}   allTargets           所有 Targets
- * @property {object|null} astProjectSummary - AST 分析结果
- * @property {string}  astContext           - AST 上下文文本（仅 generateAstContext=true 时非空）
- * @property {object|null} codeEntityResult  - Entity Graph 结果
- * @property {object|null} depGraphData      依赖图数据
- * @property {object|null} guardAudit        - Guard 审计结果
- * @property {object|null} guardEngine       - Guard 引擎实例（供 Enhancement Pack 注入后二次审计）
- * @property {Array}   activeDimensions      最终激活的维度列表（含 Enhancement Pack 追加、语言画像）
- * @property {Array}   enhancementPackInfo   匹配的 Enhancement Pack 信息
- * @property {Array}   enhancementPatterns   - Enhancement Pack 检测到的 AST 模式
- * @property {object}  langProfile           语言画像
- * @property {Array}   targetsSummary        - Targets 摘要
- * @property {string[]} warnings             非致命警告
- * @property {object}  report                - Phase 级报告（供内部 Agent 使用）
- * @property {string[]} detectedFrameworks   检测到的框架
- */
 // ── R13: AutoSnippet 生成物黑名单 ─────────────────────────
 const ASD_GENERATED_BASENAMES = new Set(['AGENTS.md', 'CLAUDE.md', 'copilot-instructions.md']);
 const ASD_GENERATED_PATH_SEGMENTS = [
     `${path.sep}.cursor${path.sep}`, // .cursor/rules/*.mdc
     `${path.sep}.github${path.sep}copilot-instructions.md`,
 ];
-/**
- * 判断文件是否为 AutoSnippet 生成物（用于排除自引用循环知识）
- * @param {string} filePath
- * @returns {boolean}
- */
+/** 判断文件是否为 AutoSnippet 生成物（用于排除自引用循环知识） */
 export function isAutoSnippetGenerated(filePath) {
     const base = path.basename(filePath);
     if (ASD_GENERATED_BASENAMES.has(base)) {
@@ -86,10 +52,8 @@ export function isAutoSnippetGenerated(filePath) {
 /**
  * Phase 1: 通过 DiscovererRegistry 检测项目类型并收集源文件
  *
- * @param {string} projectRoot 项目根目录
- * @param {object} logger
- * @param {PhaseOptions} options
- * @returns {Promise<{ allFiles: Array, allTargets: Array, discoverer: object, langStats: object }>}
+ * @param projectRoot 项目根目录
+ * @returns >}
  */
 export async function runPhase1_FileCollection(projectRoot, logger, options = {}) {
     const maxFiles = options.maxFiles || 500;
@@ -164,12 +128,10 @@ export async function runPhase1_FileCollection(projectRoot, logger, options = {}
  *   - 1.5a: 按需安装缺失的语法包
  *   - 1.5b: 执行 AST 分析 + SFC 预处理
  *
- * @param {Array} allFiles - Phase 1 收集的文件
- * @param {object} langStats 语言统计
- * @param {object} logger
- * @param {object} [options]
- * @param {boolean} [options.generateAstContext=false] 是否生成 astContext 文本
- * @returns {Promise<{ astProjectSummary: object|null, astContext: string, warnings: string[] }>}
+ * @param allFiles Phase 1 收集的文件
+ * @param langStats 语言统计
+ * @param [options.generateAstContext=false] 是否生成 astContext 文本
+ * @returns >}
  */
 export async function runPhase1_5_AstAnalysis(allFiles, langStats, logger, options = {}) {
     const warnings = [];
@@ -245,11 +207,9 @@ export async function runPhase1_5_AstAnalysis(allFiles, langStats, logger, optio
 /**
  * Phase 1.6: 从 AST 结果构建代码实体关系图谱
  *
- * @param {object|null} astProjectSummary - AST 分析结果
- * @param {string} projectRoot
- * @param {object} container - ServiceContainer
- * @param {object} logger
- * @returns {Promise<{ codeEntityResult: object|null, warnings: string[] }>}
+ * @param astProjectSummary AST 分析结果
+ * @param container ServiceContainer
+ * @returns >}
  */
 export async function runPhase1_6_EntityGraph(astProjectSummary, projectRoot, container, logger) {
     const warnings = [];
@@ -280,13 +240,11 @@ export async function runPhase1_6_EntityGraph(astProjectSummary, projectRoot, co
  *
  * 从 AST 的 callSites 构建全局调用图并写入 CodeEntityGraph。
  *
- * @param {object|null} astProjectSummary - AST 分析结果 (含 fileSummaries[].callSites)
- * @param {string} projectRoot
- * @param {object} container - ServiceContainer
- * @param {object} logger
- * @param {object} [incrementalOpts] 增量分析选项
- * @param {string[]} [incrementalOpts.changedFiles] 变更文件的相对路径
- * @returns {Promise<{ callGraphResult: object|null, warnings: string[] }>}
+ * @param astProjectSummary AST 分析结果 (含 fileSummaries[].callSites)
+ * @param container ServiceContainer
+ * @param [incrementalOpts] 增量分析选项
+ * @param [incrementalOpts.changedFiles] 变更文件的相对路径
+ * @returns >}
  */
 export async function runPhase1_7_CallGraph(astProjectSummary, projectRoot, container, logger, incrementalOpts = null) {
     const warnings = [];
@@ -350,11 +308,10 @@ export async function runPhase1_7_CallGraph(astProjectSummary, projectRoot, cont
 /**
  * Phase 2: 获取依赖图并写入 knowledge_edges
  *
- * @param {object} discoverer - DiscovererRegistry 检测到的 discoverer
- * @param {object} container - ServiceContainer
- * @param {object} logger
- * @param {string} [sourceTag='bootstrap'] - edge 的 source 标签后缀
- * @returns {Promise<{ depGraphData: object|null, depEdgesWritten: number, warnings: string[] }>}
+ * @param discoverer DiscovererRegistry 检测到的 discoverer
+ * @param container ServiceContainer
+ * @param [sourceTag='bootstrap'] edge 的 source 标签后缀
+ * @returns >}
  */
 export async function runPhase2_DependencyGraph(discoverer, container, logger, sourceTag = 'bootstrap') {
     const warnings = [];
@@ -382,10 +339,7 @@ export async function runPhase2_DependencyGraph(discoverer, container, logger, s
 /**
  * Phase 2.1: 将依赖图的 module 节点写入 Code Entity Graph
  *
- * @param {object|null} depGraphData 依赖图数据
- * @param {string} projectRoot
- * @param {object} container
- * @param {object} logger
+ * @param depGraphData 依赖图数据
  */
 export async function runPhase2_1_ModuleEntities(depGraphData, projectRoot, container, logger) {
     if (!depGraphData?.nodes?.length) {
@@ -408,13 +362,9 @@ export async function runPhase2_1_ModuleEntities(depGraphData, projectRoot, cont
 /**
  * Phase 3: Guard 规则审计
  *
- * @param {Array} allFiles - Phase 1 收集的文件
- * @param {object} container
- * @param {object} logger
- * @param {object} [options]
- * @param {boolean} [options.skipGuard=false]
- * @param {string}  [options.summaryPrefix='Bootstrap scan'] - ViolationsStore 摘要前缀
- * @returns {Promise<{ guardAudit: object|null, guardEngine: object|null, warnings: string[] }>}
+ * @param allFiles Phase 1 收集的文件
+ * @param [options.summaryPrefix='Bootstrap scan'] - ViolationsStore 摘要前缀
+ * @returns >}
  */
 export async function runPhase3_GuardAudit(allFiles, container, logger, options = {}) {
     const warnings = [];
@@ -460,14 +410,9 @@ export async function runPhase3_GuardAudit(allFiles, container, logger, options
 /**
  * Phase 4: 维度条件化过滤 + Enhancement Pack 动态追加 + 语言画像 + Skill 增强
  *
- * @param {object} params
- * @param {string} params.primaryLang
- * @param {object} params.langStats
- * @param {Array}  params.allTargets
- * @param {object|null} params.astProjectSummary - AST 结果（供 Enhancement Pack 模式检测）
- * @param {object|null} params.guardEngine - Guard 引擎（供 Enhancement Pack 规则注入）
- * @param {Array}  params.allFiles 文件列表（供 Guard 二次审计）
- * @param {object} params.logger
+ * @param params.astProjectSummary AST 结果（供 Enhancement Pack 模式检测）
+ * @param params.guardEngine Guard 引擎（供 Enhancement Pack 规则注入）
+ * @param params.allFiles 文件列表（供 Guard 二次审计）
  * @returns {Promise<{
  *   activeDimensions: Array,
  *   enhancementPackInfo: Array,
@@ -563,18 +508,13 @@ export async function runPhase4_DimensionResolve(params) {
  *
  * 内部 Agent 和外部 Agent 均可调用此函数获取统一的分析结果。
  *
- * @param {string} projectRoot 项目根目录
- * @param {object} ctx - { container, logger }
- * @param {object} [options]
- * @param {boolean} [options.incremental=false]       启用增量评估 (Phase 1 后执行)
- * @param {boolean} [options.generateReport=false]    生成 Phase 级详细报告
- * @param {boolean} [options.clearOldData=false]      先清除旧 checkpoints/snapshots
- * @param {boolean} [options.generateAstContext=false] 生成 astContext 文本
- * @param {number}  [options.maxFiles=500]
- * @param {boolean} [options.skipGuard=false]
- * @param {string}  [options.sourceTag='bootstrap']
- * @param {string}  [options.summaryPrefix='Bootstrap scan']
- * @returns {Promise<PhaseResults>}
+ * @param projectRoot 项目根目录
+ * @param ctx { container, logger }
+ * @param [options.incremental=false] 启用增量评估 (Phase 1 后执行)
+ * @param [options.generateReport=false] 生成 Phase 级详细报告
+ * @param [options.clearOldData=false] 先清除旧 checkpoints/snapshots
+ * @param [options.generateAstContext=false] 生成 astContext 文本
+ * @param [options.summaryPrefix='Bootstrap scan']
  */
 export async function runAllPhases(projectRoot, ctx, options = {}) {
     const warnings = [];
@@ -783,4 +723,3 @@ export async function runAllPhases(projectRoot, ctx, options = {}) {
         isEmpty: false,
     };
 }
-//# sourceMappingURL=bootstrap-phases.js.map

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

@@ -329,8 +329,8 @@ export declare const PRE_SUBMIT_CHECKLIST: {
 };
 /**
  * 获取维度的 SOP 配置
- * @param {string} dimId 维度 ID
- * @returns {object|null} - SOP 配置，未定义时返回 null
+ * @param dimId 维度 ID
+ * @returns SOP 配置，未定义时返回 null
  */
 export declare function getDimensionSOP(dimId: string): {
     focusKeywords?: string[];
@@ -350,15 +350,15 @@ export declare function getDimensionSOP(dimId: string): {
  * 优先使用 SOP 中显式定义的 focusKeywords；
  * 若无，则从 baseDimension.guide 按中文顿号/逗号/斜杠拆分。
  *
- * @param {string} dimId 维度 ID
- * @param {string} [guideText] - fallback: baseDimension.guide 文本
- * @returns {string[]} 关键词列表（短语级，用于 includes() 匹配）
+ * @param dimId 维度 ID
+ * @param [guideText] fallback: baseDimension.guide 文本
+ * @returns 关键词列表（短语级，用于 includes() 匹配）
  */
 export declare function getDimensionFocusKeywords(dimId: string, guideText?: string): string[];
 /**
  * 将 SOP 步骤序列化为紧凑文本（用于体积紧张时的降级）
- * @param {object} sop - SOP 配置
- * @returns {string} 紧凑的文本表示
+ * @param sop SOP 配置
+ * @returns 紧凑的文本表示
  */
 export declare function sopToCompactText(sop: {
     steps?: Array<{
@@ -368,4 +368,3 @@ export declare function sopToCompactText(sop: {
     }>;
     commonMistakes?: string[];
 } | null | undefined): string;
-//# sourceMappingURL=dimension-sop.d.ts.map

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

@@ -752,8 +752,8 @@ export const PRE_SUBMIT_CHECKLIST = {
 // ═══════════════════════════════════════════════════════════
 /**
  * 获取维度的 SOP 配置
- * @param {string} dimId 维度 ID
- * @returns {object|null} - SOP 配置，未定义时返回 null
+ * @param dimId 维度 ID
+ * @returns SOP 配置，未定义时返回 null
  */
 export function getDimensionSOP(dimId) {
     return (DIMENSION_SOP[dimId] || null);
@@ -764,9 +764,9 @@ export function getDimensionSOP(dimId) {
  * 优先使用 SOP 中显式定义的 focusKeywords；
  * 若无，则从 baseDimension.guide 按中文顿号/逗号/斜杠拆分。
  *
- * @param {string} dimId 维度 ID
- * @param {string} [guideText] - fallback: baseDimension.guide 文本
- * @returns {string[]} 关键词列表（短语级，用于 includes() 匹配）
+ * @param dimId 维度 ID
+ * @param [guideText] fallback: baseDimension.guide 文本
+ * @returns 关键词列表（短语级，用于 includes() 匹配）
  */
 export function getDimensionFocusKeywords(dimId, guideText = '') {
     const sop = DIMENSION_SOP[dimId];
@@ -784,8 +784,8 @@ export function getDimensionFocusKeywords(dimId, guideText = '') {
 }
 /**
  * 将 SOP 步骤序列化为紧凑文本（用于体积紧张时的降级）
- * @param {object} sop - SOP 配置
- * @returns {string} 紧凑的文本表示
+ * @param sop SOP 配置
+ * @returns 紧凑的文本表示
  */
 export function sopToCompactText(sop) {
     if (!sop?.steps) {
@@ -806,4 +806,3 @@ export function sopToCompactText(sop) {
     }
     return lines.join('\n');
 }
-//# sourceMappingURL=dimension-sop.js.map

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

@@ -17,9 +17,7 @@
  *
  * @module bootstrap/shared/dimension-text
  */
-/**
- * 知识提交的完整 Schema — 定义必填字段、内容结构、枚举值和质量门控
- */
+/** 知识提交的完整 Schema — 定义必填字段、内容结构、枚举值和质量门控 */
 export declare const SUBMISSION_SCHEMA: {
     tool: string;
     batchTool: string;
@@ -148,16 +146,13 @@ export declare const REQUIRED_FIELDS_DESCRIPTION: string[];
 /**
  * 内部 Agent 完成后的 nextSteps 提示
  *
- * @param {Array} dimensions 激活的维度列表
- * @returns {string[]}
+ * @param dimensions 激活的维度列表
  */
 export declare function buildInternalNextSteps(dimensions: ReadonlyArray<{
     id: string;
     skillWorthy?: boolean;
 }>): string[];
-/**
- * Bootstrap 全部维度完成后的 nextActions（供外部 Agent 使用）
- */
+/** Bootstrap 全部维度完成后的 nextActions（供外部 Agent 使用） */
 export declare const BOOTSTRAP_COMPLETE_ACTIONS: ({
     action: string;
     prompt: string;
@@ -169,4 +164,3 @@ export declare const BOOTSTRAP_COMPLETE_ACTIONS: ({
     tool: string;
     auto?: undefined;
 })[];
-//# sourceMappingURL=dimension-text.d.ts.map

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

@@ -17,13 +17,11 @@
  *
  * @module bootstrap/shared/dimension-text
  */
-import { getRequiredFieldNames, getRequiredFieldsDescription } from '#shared/FieldSpec.js';
+import { getRequiredFieldNames, getRequiredFieldsDescription, } from '#domain/knowledge/FieldSpec.js';
 // ═══════════════════════════════════════════════════════════
 // 提交 Schema 定义
 // ═══════════════════════════════════════════════════════════
-/**
- * 知识提交的完整 Schema — 定义必填字段、内容结构、枚举值和质量门控
- */
+/** 知识提交的完整 Schema — 定义必填字段、内容结构、枚举值和质量门控 */
 export const SUBMISSION_SCHEMA = {
     tool: 'autosnippet_submit_knowledge',
     batchTool: 'autosnippet_submit_knowledge_batch',
@@ -168,8 +166,7 @@ export const REQUIRED_FIELDS_DESCRIPTION = getRequiredFieldsDescription();
 /**
  * 内部 Agent 完成后的 nextSteps 提示
  *
- * @param {Array} dimensions 激活的维度列表
- * @returns {string[]}
+ * @param dimensions 激活的维度列表
  */
 export function buildInternalNextSteps(dimensions) {
     return [
@@ -193,9 +190,7 @@ export function buildInternalNextSteps(dimensions) {
         '自动生成 Project Skill 到 AutoSnippet/skills/，可通过 autosnippet_skill({ operation: "load" }) 加载。',
     ];
 }
-/**
- * Bootstrap 全部维度完成后的 nextActions（供外部 Agent 使用）
- */
+/** Bootstrap 全部维度完成后的 nextActions（供外部 Agent 使用） */
 export const BOOTSTRAP_COMPLETE_ACTIONS = [
     {
         action: 'cursor_delivery',
@@ -209,4 +204,3 @@ export const BOOTSTRAP_COMPLETE_ACTIONS = [
         tool: 'autosnippet_wiki_plan',
     },
 ];
-//# sourceMappingURL=dimension-text.js.map

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

@@ -26,13 +26,13 @@ interface SkillDimensionDef {
  *
  * 执行流程: 质量门控 → 内容构建 → createSkill 调用
  *
- * @param {object} ctx - { container, logger }
- * @param {object} dim 维度定义 { id, label, skillWorthy, skillMeta }
- * @param {string} analysisText 分析报告全文
- * @param {string[]} [referencedFiles=[]] 引用的文件
- * @param {string[]} [keyFindings=[]] 关键发现
- * @param {string} [source='bootstrap'] 来源标签
- * @returns {Promise<{ success: boolean, skillName: string, error?: string }>}
+ * @param ctx { container, logger }
+ * @param dim 维度定义 { id, label, skillWorthy, skillMeta }
+ * @param analysisText 分析报告全文
+ * @param [referencedFiles=[]] 引用的文件
+ * @param [keyFindings=[]] 关键发现
+ * @param [source='bootstrap'] 来源标签
+ * @returns >}
  */
 export declare function generateSkill(ctx: McpContext, dim: SkillDimensionDef, analysisText: string, referencedFiles?: string[], keyFindings?: string[], source?: string): Promise<{
     success: boolean;
@@ -40,4 +40,3 @@ export declare function generateSkill(ctx: McpContext, dim: SkillDimensionDef, a
     error?: string;
 }>;
 export {};
-//# sourceMappingURL=skill-generator.d.ts.map

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

@@ -38,9 +38,7 @@ function normalizeLine(line) {
         .replace(/\s+/g, ' ') // collapse whitespace
         .trim();
 }
-/**
- * 检测最长连续重复块长度 — AI 循环的核心特征
- */
+/** 检测最长连续重复块长度 — AI 循环的核心特征 */
 function maxConsecutiveDuplicates(lines) {
     let max = 0;
     let current = 0;
@@ -57,9 +55,7 @@ function maxConsecutiveDuplicates(lines) {
     }
     return max;
 }
-/**
- * 去除连续重复行 — 将连续 N 行相同内容压缩为 1 行
- */
+/** 去除连续重复行 — 将连续 N 行相同内容压缩为 1 行 */
 function deduplicateConsecutive(text) {
     const lines = text.split('\n');
     const result = [lines[0]];
@@ -82,8 +78,8 @@ function deduplicateConsecutive(text) {
  *
  * 挽救机制: 当检测到重复时，先去除连续重复行，如果去重后文本 ≥ 100 字符则放行。
  *
- * @param {string} analysisText - Analyst 或外部 Agent 的分析文本
- * @returns {{ pass: boolean, reason: string|null, deduplicatedText?: string }}
+ * @param analysisText Analyst 或外部 Agent 的分析文本
+ * @returns }
  */
 function validateSkillQuality(analysisText) {
     // 1. 文本过短
@@ -147,12 +143,12 @@ function validateSkillQuality(analysisText) {
  *   ## Referenced Files (如果有)
  *   - `file1`
  *
- * @param {object} dim 维度定义 { id, label }
- * @param {string} analysisText 分析报告全文
- * @param {string[]} [referencedFiles=[]] 引用的文件路径列表
- * @param {string[]} [keyFindings=[]] 关键发现摘要
- * @param {string} [source='bootstrap'] 来源标签 (bootstrap-v3 / external-agent-bootstrap)
- * @returns {string} - Skill Markdown 内容
+ * @param dim 维度定义 { id, label }
+ * @param analysisText 分析报告全文
+ * @param [referencedFiles=[]] 引用的文件路径列表
+ * @param [keyFindings=[]] 关键发现摘要
+ * @param [source='bootstrap'] 来源标签 (bootstrap-v3 / external-agent-bootstrap)
+ * @returns Skill Markdown 内容
  */
 function buildSkillContent(dim, analysisText, referencedFiles = [], keyFindings = [], source = 'bootstrap') {
     const parts = [];
@@ -189,13 +185,13 @@ function buildSkillContent(dim, analysisText, referencedFiles = [], keyFindings
  *
  * 执行流程: 质量门控 → 内容构建 → createSkill 调用
  *
- * @param {object} ctx - { container, logger }
- * @param {object} dim 维度定义 { id, label, skillWorthy, skillMeta }
- * @param {string} analysisText 分析报告全文
- * @param {string[]} [referencedFiles=[]] 引用的文件
- * @param {string[]} [keyFindings=[]] 关键发现
- * @param {string} [source='bootstrap'] 来源标签
- * @returns {Promise<{ success: boolean, skillName: string, error?: string }>}
+ * @param ctx { container, logger }
+ * @param dim 维度定义 { id, label, skillWorthy, skillMeta }
+ * @param analysisText 分析报告全文
+ * @param [referencedFiles=[]] 引用的文件
+ * @param [keyFindings=[]] 关键发现
+ * @param [source='bootstrap'] 来源标签
+ * @returns >}
  */
 export async function generateSkill(ctx, dim, analysisText, referencedFiles = [], keyFindings = [], source = 'bootstrap') {
     const skillName = dim.skillMeta?.name || `project-${dim.id}`;
@@ -234,4 +230,3 @@ export async function generateSkill(ctx, dim, analysisText, referencedFiles = []
         return { success: false, skillName, error: msg };
     }
 }
-//# sourceMappingURL=skill-generator.js.map

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

@@ -23,9 +23,8 @@ interface DimensionLike {
 /**
  * 加载 Bootstrap 相关 Skills（仅 coldstart Skill）
  *
- * @param {string} _primaryLanguage 主语言（保留参数签名兼容）
- * @param {object} logger
- * @returns {{ coldstartSkill: string|null, loaded: string[] }}
+ * @param _primaryLanguage 主语言（保留参数签名兼容）
+ * @returns }
  */
 export declare function loadBootstrapSkills(_primaryLanguage: string, logger?: SkillLogger): {
     coldstartSkill: string | null;
@@ -37,8 +36,8 @@ export declare function loadBootstrapSkills(_primaryLanguage: string, logger?: S
  * 从 coldstart SKILL.md 中的 "Per-Dimension Industry Reference Templates" 提取
  * rationale/whyStandard 作为维度增强指引。
  *
- * @param {object} skillContext 由 loadBootstrapSkills 返回
- * @returns {{ guides: Record<string, string>, sectionMap: Record<string, Array<{title: string, content: string, keywords: string[]}>> }}
+ * @param skillContext 由 loadBootstrapSkills 返回
+ * @returns >> }}
  */
 export declare function extractSkillDimensionGuides(skillContext: {
     coldstartSkill: string | null;
@@ -54,10 +53,10 @@ export declare function extractSkillDimensionGuides(skillContext: {
 /**
  * 增强 9 维度定义 — 将 Skill 提供的参考指引注入 dimensions[].guide
  *
- * @param {Array} dimensions 原始维度数组
- * @param {Record<string, string>} skillGuides - guides 部分
- * @param {Record<string, Array>} skillSections - sectionMap 部分（per-candidate 匹配用）
- * @returns {Array} 增强后的维度数组（原数组不变，返回新数组）
+ * @param dimensions 原始维度数组
+ * @param skillGuides guides 部分
+ * @param skillSections sectionMap 部分（per-candidate 匹配用）
+ * @returns 增强后的维度数组（原数组不变，返回新数组）
  */
 export declare function enhanceDimensions(dimensions: DimensionLike[], skillGuides: Record<string, string>, skillSections: Record<string, Array<{
     title: string;
@@ -65,4 +64,3 @@ export declare function enhanceDimensions(dimensions: DimensionLike[], skillGuid
     keywords: string[];
 }>>): DimensionLike[];
 export {};
-//# sourceMappingURL=skills.d.ts.map

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

@@ -15,9 +15,8 @@ const COLDSTART_SKILL_NAME = 'autosnippet-coldstart';
 /**
  * 加载 Bootstrap 相关 Skills（仅 coldstart Skill）
  *
- * @param {string} _primaryLanguage 主语言（保留参数签名兼容）
- * @param {object} logger
- * @returns {{ coldstartSkill: string|null, loaded: string[] }}
+ * @param _primaryLanguage 主语言（保留参数签名兼容）
+ * @returns }
  */
 export function loadBootstrapSkills(_primaryLanguage, logger) {
     const result = {
@@ -47,8 +46,8 @@ export function loadBootstrapSkills(_primaryLanguage, logger) {
  * 从 coldstart SKILL.md 中的 "Per-Dimension Industry Reference Templates" 提取
  * rationale/whyStandard 作为维度增强指引。
  *
- * @param {object} skillContext 由 loadBootstrapSkills 返回
- * @returns {{ guides: Record<string, string>, sectionMap: Record<string, Array<{title: string, content: string, keywords: string[]}>> }}
+ * @param skillContext 由 loadBootstrapSkills 返回
+ * @returns >> }}
  */
 export function extractSkillDimensionGuides(skillContext) {
     const guides = {}; // dimId → summary guide text
@@ -77,10 +76,10 @@ export function extractSkillDimensionGuides(skillContext) {
 /**
  * 增强 9 维度定义 — 将 Skill 提供的参考指引注入 dimensions[].guide
  *
- * @param {Array} dimensions 原始维度数组
- * @param {Record<string, string>} skillGuides - guides 部分
- * @param {Record<string, Array>} skillSections - sectionMap 部分（per-candidate 匹配用）
- * @returns {Array} 增强后的维度数组（原数组不变，返回新数组）
+ * @param dimensions 原始维度数组
+ * @param skillGuides guides 部分
+ * @param skillSections sectionMap 部分（per-candidate 匹配用）
+ * @returns 增强后的维度数组（原数组不变，返回新数组）
  */
 export function enhanceDimensions(dimensions, skillGuides, skillSections) {
     if (!skillGuides || Object.keys(skillGuides).length === 0) {
@@ -99,4 +98,3 @@ export function enhanceDimensions(dimensions, skillGuides, skillSections) {
         };
     });
 }
-//# sourceMappingURL=skills.js.map

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

@@ -39,8 +39,8 @@ interface MissionBriefingResult {
  * 无参数调用，返回 Mission Briefing。
  * Phase 1-4 复用现有 bootstrap.js 逻辑，Phase 5 不启动。
  *
- * @param {object} ctx - { container, logger, startedAt }
- * @returns {Promise<object>} - envelope({ success, data: MissionBriefing })
+ * @param ctx { container, logger, startedAt }
+ * @returns envelope({ success, data: MissionBriefing })
  */
 export declare function bootstrapExternal(ctx: McpContext): Promise<{
     success: boolean;
@@ -72,11 +72,6 @@ export declare function bootstrapExternal(ctx: McpContext): Promise<{
  *
  * 当指定了 sessionId 时，如果 active session 已过期但 id 匹配，
  * 仍然返回该 session（支持新 bootstrap 创建后旧 session 的 dimension_complete 继续工作）。
- *
- * @param {object} container
- * @param {string} [sessionId]
- * @returns {import('./bootstrap/BootstrapSession.js').BootstrapSession|null}
  */
 export declare function getActiveSession(container: ServiceContainer, sessionId?: string): import("./bootstrap/BootstrapSession.js").BootstrapSession | null;
 export {};
-//# sourceMappingURL=bootstrap-external.d.ts.map

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

@@ -25,8 +25,7 @@ import { buildLanguageExtension } from './LanguageExtensions.js';
 let _sessionManager = null;
 /**
  * 获取或创建 BootstrapSessionManager
- * @param {object} container - ServiceContainer
- * @returns {BootstrapSessionManager}
+ * @param container ServiceContainer
  */
 function getSessionManager(container) {
     // 优先使用容器注册的 (如果已注册)
@@ -59,8 +58,8 @@ function getSessionManager(container) {
  * 无参数调用，返回 Mission Briefing。
  * Phase 1-4 复用现有 bootstrap.js 逻辑，Phase 5 不启动。
  *
- * @param {object} ctx - { container, logger, startedAt }
- * @returns {Promise<object>} - envelope({ success, data: MissionBriefing })
+ * @param ctx { container, logger, startedAt }
+ * @returns envelope({ success, data: MissionBriefing })
  */
 export async function bootstrapExternal(ctx) {
     const t0 = Date.now();
@@ -156,10 +155,6 @@ export async function bootstrapExternal(ctx) {
  *
  * 当指定了 sessionId 时，如果 active session 已过期但 id 匹配，
  * 仍然返回该 session（支持新 bootstrap 创建后旧 session 的 dimension_complete 继续工作）。
- *
- * @param {object} container
- * @param {string} [sessionId]
- * @returns {import('./bootstrap/BootstrapSession.js').BootstrapSession|null}
  */
 export function getActiveSession(container, sessionId) {
     const mgr = getSessionManager(container);
@@ -177,4 +172,3 @@ export function getActiveSession(container, sessionId) {
     }
     return null;
 }
-//# sourceMappingURL=bootstrap-external.js.map

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

@@ -75,12 +75,11 @@ interface BootstrapKnowledgeArgs {
  *
  * ⚠️ 本函数是内部 Agent 路径。外部 Agent 使用 bootstrap-external.js 的 Mission Briefing + dimension_complete 流程。
  *
- * @param {object} ctx  { container, logger }
- * @param {object} args
- * @param {number} [args.maxFiles=500] 最大扫描文件数
- * @param {boolean} [args.skipGuard=false] 是否跳过 Guard 审计
- * @param {number} [args.contentMaxLines=120] 每文件读取最大行数
- * @param {boolean} [args.incremental=true] 是否启用增量 Bootstrap (自动检测变更, 仅重跑受影响维度)
+ * @param ctx { container, logger }
+ * @param [args.maxFiles=500] 最大扫描文件数
+ * @param [args.skipGuard=false] 是否跳过 Guard 审计
+ * @param [args.contentMaxLines=120] 每文件读取最大行数
+ * @param [args.incremental=true] 是否启用增量 Bootstrap (自动检测变更, 仅重跑受影响维度)
  */
 export declare function bootstrapKnowledge(ctx: BootstrapMcpContext, args: BootstrapKnowledgeArgs): Promise<{
     success: boolean;
@@ -108,4 +107,3 @@ export declare function bootstrapKnowledge(ctx: BootstrapMcpContext, args: Boots
         tool?: string | undefined;
     };
 }>;
-//# sourceMappingURL=bootstrap-internal.d.ts.map