autosnippet 3.0.0 → 3.0.2

package/lib/external/mcp/tools.js

@@ -14,39 +14,41 @@ export const TIER_ORDER = { agent: 0, admin: 1 };
 export const TOOL_GATEWAY_MAP = {
   // bootstrap 写操作 — 动态路由
   autosnippet_bootstrap: {
-    resolver: (args) => ({
-      knowledge: { action: 'knowledge:bootstrap', resource: 'knowledge' },
-      refine:    { action: 'knowledge:update',    resource: 'knowledge' },
-      scan:      { action: 'guard_rule:check_code', resource: 'guard_rules' },
-    })[args?.operation] || null,
+    resolver: (args) =>
+      ({
+        knowledge: { action: 'knowledge:bootstrap', resource: 'knowledge' },
+        refine: { action: 'knowledge:update', resource: 'knowledge' },
+        scan: { action: 'guard_rule:check_code', resource: 'guard_rules' },
+      })[args?.operation] || null,
   },
   // guard 写操作（仅 files 模式）
   autosnippet_guard: {
-    resolver: (args) => (args?.files && Array.isArray(args.files))
-      ? { action: 'guard_rule:check_code', resource: 'guard_rules' }
-      : null, // code 模式只读，跳过 Gateway
+    resolver: (args) =>
+      args?.files && Array.isArray(args.files)
+        ? { action: 'guard_rule:check_code', resource: 'guard_rules' }
+        : null, // code 模式只读，跳过 Gateway
   },
   // skill 写操作（create/update/delete）
   autosnippet_skill: {
-    resolver: (args) => ({
-      create: { action: 'create:skills', resource: 'skills' },
-      update: { action: 'update:skills', resource: 'skills' },
-      delete: { action: 'delete:skills', resource: 'skills' },
-    })[args?.operation] || null, // list/load/suggest 只读
+    resolver: (args) =>
+      ({
+        create: { action: 'create:skills', resource: 'skills' },
+        update: { action: 'update:skills', resource: 'skills' },
+        delete: { action: 'delete:skills', resource: 'skills' },
+      })[args?.operation] || null, // list/load/suggest 只读
   },
   // 知识提交
-  autosnippet_submit_knowledge:       { action: 'knowledge:create', resource: 'knowledge' },
+  autosnippet_submit_knowledge: { action: 'knowledge:create', resource: 'knowledge' },
   autosnippet_submit_knowledge_batch: { action: 'knowledge:create', resource: 'knowledge' },
-  autosnippet_save_document:          { action: 'knowledge:create', resource: 'knowledge' },
+  autosnippet_save_document: { action: 'knowledge:create', resource: 'knowledge' },
   // admin 工具
-  autosnippet_enrich_candidates:      { action: 'knowledge:update', resource: 'knowledge' },
-  autosnippet_knowledge_lifecycle:    { action: 'knowledge:update', resource: 'knowledge' },
+  autosnippet_enrich_candidates: { action: 'knowledge:update', resource: 'knowledge' },
+  autosnippet_knowledge_lifecycle: { action: 'knowledge:update', resource: 'knowledge' },
 };
 
 // ─── 工具声明 ────────────────────────────────────────────────
 
 export const TOOLS = [
-
   // ══════════════════════════════════════════════════════
   //  Tier: agent — 外部 Agent 核心工具集 (12 个)
   // ══════════════════════════════════════════════════════
@@ -67,13 +69,28 @@ export const TOOLS = [
     inputSchema: {
       type: 'object',
       properties: {
-        query:          { type: 'string', description: '搜索查询' },
-        mode:           { type: 'string', enum: ['auto', 'keyword', 'bm25', 'semantic', 'context'], default: 'auto', description: 'auto=BM25+semantic 融合 | keyword=SQL LIKE 精确 | semantic=向量语义 | context=4层漏斗+会话感知' },
-        kind:           { type: 'string', enum: ['all', 'rule', 'pattern', 'fact'], default: 'all', description: '按知识类型过滤' },
-        limit:          { type: 'number', default: 10 },
-        language:       { type: 'string', description: '当前编程语言（mode=context 时用于重排）' },
-        sessionId:      { type: 'string', description: '会话 ID（mode=context 连续对话）' },
-        sessionHistory: { type: 'array', items: { type: 'object' }, description: '会话历史（mode=context 启用 Layer 4）' },
+        query: { type: 'string', description: '搜索查询' },
+        mode: {
+          type: 'string',
+          enum: ['auto', 'keyword', 'bm25', 'semantic', 'context'],
+          default: 'auto',
+          description:
+            'auto=BM25+semantic 融合 | keyword=SQL LIKE 精确 | semantic=向量语义 | context=4层漏斗+会话感知',
+        },
+        kind: {
+          type: 'string',
+          enum: ['all', 'rule', 'pattern', 'fact'],
+          default: 'all',
+          description: '按知识类型过滤',
+        },
+        limit: { type: 'number', default: 10 },
+        language: { type: 'string', description: '当前编程语言（mode=context 时用于重排）' },
+        sessionId: { type: 'string', description: '会话 ID（mode=context 连续对话）' },
+        sessionHistory: {
+          type: 'array',
+          items: { type: 'object' },
+          description: '会话历史（mode=context 启用 Layer 4）',
+        },
       },
       required: ['query'],
     },
@@ -83,21 +100,35 @@ export const TOOLS = [
   {
     name: 'autosnippet_knowledge',
     tier: 'agent',
-    description: '知识浏览与使用确认。list=列表过滤 | get=单条详情 | insights=质量洞察 | confirm_usage=记录采纳。',
+    description:
+      '知识浏览与使用确认。list=列表过滤 | get=单条详情 | insights=质量洞察 | confirm_usage=记录采纳。',
     inputSchema: {
       type: 'object',
       properties: {
-        operation:      { type: 'string', enum: ['list', 'get', 'insights', 'confirm_usage'], default: 'list', description: 'list=列表过滤 | get=获取详情 | insights=质量洞察 | confirm_usage=确认采纳' },
-        id:             { type: 'string', description: 'Recipe ID（get/insights/confirm_usage 必填）' },
-        kind:           { type: 'string', enum: ['all', 'rule', 'pattern', 'fact'], description: '按知识类型过滤（list）' },
-        language:       { type: 'string', description: '语言过滤' },
-        category:       { type: 'string', description: '分类过滤' },
-        knowledgeType:  { type: 'string', description: '知识类型过滤' },
-        status:         { type: 'string', description: '状态过滤：active/draft/deprecated' },
-        complexity:     { type: 'string', description: '复杂度过滤' },
-        limit:          { type: 'number', default: 20 },
-        usageType:      { type: 'string', enum: ['adoption', 'application'], description: '使用类型（confirm_usage）' },
-        feedback:       { type: 'string', description: '使用反馈（confirm_usage）' },
+        operation: {
+          type: 'string',
+          enum: ['list', 'get', 'insights', 'confirm_usage'],
+          default: 'list',
+          description: 'list=列表过滤 | get=获取详情 | insights=质量洞察 | confirm_usage=确认采纳',
+        },
+        id: { type: 'string', description: 'Recipe ID（get/insights/confirm_usage 必填）' },
+        kind: {
+          type: 'string',
+          enum: ['all', 'rule', 'pattern', 'fact'],
+          description: '按知识类型过滤（list）',
+        },
+        language: { type: 'string', description: '语言过滤' },
+        category: { type: 'string', description: '分类过滤' },
+        knowledgeType: { type: 'string', description: '知识类型过滤' },
+        status: { type: 'string', description: '状态过滤：active/draft/deprecated' },
+        complexity: { type: 'string', description: '复杂度过滤' },
+        limit: { type: 'number', default: 20 },
+        usageType: {
+          type: 'string',
+          enum: ['adoption', 'application'],
+          description: '使用类型（confirm_usage）',
+        },
+        feedback: { type: 'string', description: '使用反馈（confirm_usage）' },
       },
       required: [],
     },
@@ -111,12 +142,17 @@ export const TOOLS = [
     inputSchema: {
       type: 'object',
       properties: {
-        operation:       { type: 'string', enum: ['targets', 'files', 'metadata'], default: 'targets', description: 'targets=目标列表 | files=文件列表 | metadata=元数据' },
-        targetName:      { type: 'string', description: 'Target 名称（files/metadata 必填）' },
-        includeSummary:  { type: 'boolean', default: true, description: '附带摘要统计（targets）' },
-        includeContent:  { type: 'boolean', default: false, description: '返回文件内容（files）' },
+        operation: {
+          type: 'string',
+          enum: ['targets', 'files', 'metadata'],
+          default: 'targets',
+          description: 'targets=目标列表 | files=文件列表 | metadata=元数据',
+        },
+        targetName: { type: 'string', description: 'Target 名称（files/metadata 必填）' },
+        includeSummary: { type: 'boolean', default: true, description: '附带摘要统计（targets）' },
+        includeContent: { type: 'boolean', default: false, description: '返回文件内容（files）' },
         contentMaxLines: { type: 'number', default: 100, description: '截断行数（files）' },
-        maxFiles:        { type: 'number', default: 500, description: '最大文件数（files）' },
+        maxFiles: { type: 'number', default: 500, description: '最大文件数（files）' },
       },
       required: [],
     },
@@ -126,18 +162,28 @@ export const TOOLS = [
   {
     name: 'autosnippet_graph',
     tier: 'agent',
-    description: '知识图谱查询。query=节点关系 | impact=影响分析 | path=路径查找 | stats=全局统计。',
+    description:
+      '知识图谱查询。query=节点关系 | impact=影响分析 | path=路径查找 | stats=全局统计。',
     inputSchema: {
       type: 'object',
       properties: {
-        operation: { type: 'string', enum: ['query', 'impact', 'path', 'stats'], description: 'query=节点关系 | impact=影响分析 | path=路径查找 | stats=全局统计' },
-        nodeId:    { type: 'string', description: '节点 ID（query/impact）' },
-        nodeType:  { type: 'string', default: 'recipe' },
-        fromId:    { type: 'string', description: '起始节点（path）' },
-        toId:      { type: 'string', description: '目标节点（path）' },
-        direction: { type: 'string', enum: ['out', 'in', 'both'], default: 'both', description: '关系方向（query）' },
-        maxDepth:  { type: 'number', default: 3, description: '最大深度' },
-        relation:  { type: 'string', description: '关系类型过滤' },
+        operation: {
+          type: 'string',
+          enum: ['query', 'impact', 'path', 'stats'],
+          description: 'query=节点关系 | impact=影响分析 | path=路径查找 | stats=全局统计',
+        },
+        nodeId: { type: 'string', description: '节点 ID（query/impact）' },
+        nodeType: { type: 'string', default: 'recipe' },
+        fromId: { type: 'string', description: '起始节点（path）' },
+        toId: { type: 'string', description: '目标节点（path）' },
+        direction: {
+          type: 'string',
+          enum: ['out', 'in', 'both'],
+          default: 'both',
+          description: '关系方向（query）',
+        },
+        maxDepth: { type: 'number', default: 3, description: '最大深度' },
+        relation: { type: 'string', description: '关系类型过滤' },
       },
       required: ['operation'],
     },
@@ -151,11 +197,24 @@ export const TOOLS = [
     inputSchema: {
       type: 'object',
       properties: {
-        code:     { type: 'string', description: '待检查代码（单文件模式，与 files 二选一）' },
+        code: { type: 'string', description: '待检查代码（单文件模式，与 files 二选一）' },
         language: { type: 'string', description: '编程语言' },
         filePath: { type: 'string', description: '文件路径（单文件模式）' },
-        files:    { type: 'array', items: { type: 'object', properties: { path: { type: 'string' }, content: { type: 'string' } }, required: ['path'] }, description: '文件列表（批量模式，与 code 二选一）' },
-        scope:    { type: 'string', enum: ['file', 'target', 'project'], default: 'project', description: '审计范围（批量模式）' },
+        files: {
+          type: 'array',
+          items: {
+            type: 'object',
+            properties: { path: { type: 'string' }, content: { type: 'string' } },
+            required: ['path'],
+          },
+          description: '文件列表（批量模式，与 code 二选一）',
+        },
+        scope: {
+          type: 'string',
+          enum: ['file', 'target', 'project'],
+          default: 'project',
+          description: '审计范围（批量模式）',
+        },
       },
       required: [],
     },
@@ -173,39 +232,90 @@ export const TOOLS = [
       type: 'object',
       properties: {
         // ── 必填 ──
-        title:            { type: 'string', description: '中文标题（≤20字）' },
-        language:         { type: 'string', description: '编程语言（小写）' },
-        content:          { type: 'object', description: '内容值对象（必须有 pattern 或 markdown + rationale）', properties: { pattern: { type: 'string' }, markdown: { type: 'string' }, rationale: { type: 'string', description: '设计原理说明（必填）' }, steps: { type: 'array', items: { type: 'object' } }, codeChanges: { type: 'array', items: { type: 'object' } }, verification: { type: 'object' } } },
-        kind:             { type: 'string', enum: ['rule', 'pattern', 'fact'], description: 'rule=规则 | pattern=模板 | fact=参考' },
-        doClause:         { type: 'string', description: '正向指令（英文祈使句 ≤60 tokens）' },
-        category:         { type: 'string', description: '分类（必填）: View/Service/Tool/Model/Network/Storage/UI/Utility' },
-        trigger:          { type: 'string', description: '触发关键词（必填，@前缀，如 @video-cover-cell）' },
-        description:      { type: 'string', description: '中文简述（必填）≤80 字' },
-        headers:          { type: 'array', items: { type: 'string' }, description: '完整 import/include 语句数组（必填）' },
-        usageGuide:       { type: 'string', description: '使用指南（必填，Markdown ### 章节格式，描述何时/如何使用此知识）' },
-        knowledgeType:    { type: 'string', description: '知识维度（必填，如 code-pattern/architecture/best-practice/naming-convention 等）' },
+        title: { type: 'string', description: '中文标题（≤20字）' },
+        language: { type: 'string', description: '编程语言（小写）' },
+        content: {
+          type: 'object',
+          description: '内容值对象（必须有 pattern 或 markdown + rationale）',
+          properties: {
+            pattern: { type: 'string' },
+            markdown: { type: 'string' },
+            rationale: { type: 'string', description: '设计原理说明（必填）' },
+            steps: { type: 'array', items: { type: 'object' } },
+            codeChanges: { type: 'array', items: { type: 'object' } },
+            verification: { type: 'object' },
+          },
+        },
+        kind: {
+          type: 'string',
+          enum: ['rule', 'pattern', 'fact'],
+          description: 'rule=规则 | pattern=模板 | fact=参考',
+        },
+        doClause: { type: 'string', description: '正向指令（英文祈使句 ≤60 tokens）' },
+        category: {
+          type: 'string',
+          description: '分类（必填）: View/Service/Tool/Model/Network/Storage/UI/Utility',
+        },
+        trigger: { type: 'string', description: '触发关键词（必填，@前缀，如 @video-cover-cell）' },
+        description: { type: 'string', description: '中文简述（必填）≤80 字' },
+        headers: {
+          type: 'array',
+          items: { type: 'string' },
+          description: '完整 import/include 语句数组（必填）',
+        },
+        usageGuide: {
+          type: 'string',
+          description: '使用指南（必填，Markdown ### 章节格式，描述何时/如何使用此知识）',
+        },
+        knowledgeType: {
+          type: 'string',
+          description:
+            '知识维度（必填，如 code-pattern/architecture/best-practice/naming-convention 等）',
+        },
         // ── Cursor Delivery ──
-        dontClause:       { type: 'string', description: '反向约束' },
-        whenClause:       { type: 'string', description: '触发场景' },
-        topicHint:        { type: 'string', description: '主题分组' },
-        coreCode:         { type: 'string', description: '精华代码骨架（3-8行）' },
+        dontClause: { type: 'string', description: '反向约束' },
+        whenClause: { type: 'string', description: '触发场景' },
+        topicHint: { type: 'string', description: '主题分组' },
+        coreCode: { type: 'string', description: '精华代码骨架（3-8行，必须语法完整、括号配对）' },
         // ── 可选 ──
-        complexity:       { type: 'string', enum: ['beginner', 'intermediate', 'advanced'] },
-        scope:            { type: 'string', enum: ['universal', 'project-specific', 'target-specific'] },
-        difficulty:       { type: 'string' },
-        tags:             { type: 'array', items: { type: 'string' } },
-        constraints:      { type: 'object', description: '约束' },
-        relations:        { type: 'object', description: '关系' },
-        reasoning:        { type: 'object', description: '推理依据 {whyStandard, sources[], confidence}', properties: { whyStandard: { type: 'string' }, sources: { type: 'array', items: { type: 'string' } }, confidence: { type: 'number' }, qualitySignals: { type: 'object' }, alternatives: { type: 'array', items: { type: 'string' } } } },
-        headerPaths:      { type: 'array', items: { type: 'string' } },
-        moduleName:       { type: 'string' },
-        includeHeaders:   { type: 'boolean' },
-        source:           { type: 'string', description: '来源标识' },
-        client_id:        { type: 'string', description: '客户端标识' },
+        complexity: { type: 'string', enum: ['beginner', 'intermediate', 'advanced'] },
+        scope: { type: 'string', enum: ['universal', 'project-specific', 'target-specific'] },
+        difficulty: { type: 'string' },
+        tags: { type: 'array', items: { type: 'string' } },
+        constraints: { type: 'object', description: '约束' },
+        relations: { type: 'object', description: '关系' },
+        reasoning: {
+          type: 'object',
+          description: '推理依据 {whyStandard, sources[], confidence}',
+          properties: {
+            whyStandard: { type: 'string' },
+            sources: { type: 'array', items: { type: 'string' } },
+            confidence: { type: 'number' },
+            qualitySignals: { type: 'object' },
+            alternatives: { type: 'array', items: { type: 'string' } },
+          },
+        },
+        headerPaths: { type: 'array', items: { type: 'string' } },
+        moduleName: { type: 'string' },
+        includeHeaders: { type: 'boolean' },
+        source: { type: 'string', description: '来源标识' },
+        client_id: { type: 'string', description: '客户端标识' },
         // ── 增强控制 ──
-        skipDuplicateCheck:  { type: 'boolean', default: false, description: '跳过去重检测' },
+        skipDuplicateCheck: { type: 'boolean', default: false, description: '跳过去重检测' },
       },
-      required: ['title', 'language', 'content', 'kind', 'doClause', 'category', 'trigger', 'description', 'headers', 'usageGuide', 'knowledgeType'],
+      required: [
+        'title',
+        'language',
+        'content',
+        'kind',
+        'doClause',
+        'category',
+        'trigger',
+        'description',
+        'headers',
+        'usageGuide',
+        'knowledgeType',
+      ],
     },
   },
 
@@ -217,11 +327,15 @@ export const TOOLS = [
     inputSchema: {
       type: 'object',
       properties: {
-        target_name:  { type: 'string', description: 'Target 名称' },
-        items:        { type: 'array', description: '知识条目数组，每项字段同 submit_knowledge', items: { type: 'object' } },
-        source:       { type: 'string', default: 'cursor-scan' },
-        deduplicate:  { type: 'boolean', default: true },
-        client_id:    { type: 'string' },
+        target_name: { type: 'string', description: 'Target 名称' },
+        items: {
+          type: 'array',
+          description: '知识条目数组，每项字段同 submit_knowledge',
+          items: { type: 'object' },
+        },
+        source: { type: 'string', default: 'cursor-scan' },
+        deduplicate: { type: 'boolean', default: true },
+        client_id: { type: 'string' },
       },
       required: ['target_name', 'items'],
     },
@@ -231,16 +345,21 @@ export const TOOLS = [
   {
     name: 'autosnippet_save_document',
     tier: 'agent',
-    description: '保存开发文档（设计文档、排查报告、ADR 等）。仅需 title + markdown，自动以 dev-document 存储。',
+    description:
+      '保存开发文档（设计文档、排查报告、ADR 等）。仅需 title + markdown，自动以 dev-document 存储。',
     inputSchema: {
       type: 'object',
       properties: {
-        title:       { type: 'string', description: '文档标题' },
-        markdown:    { type: 'string', description: 'Markdown 全文' },
+        title: { type: 'string', description: '文档标题' },
+        markdown: { type: 'string', description: 'Markdown 全文' },
         description: { type: 'string', description: '一句话摘要' },
-        tags:        { type: 'array', items: { type: 'string' } },
-        scope:       { type: 'string', enum: ['universal', 'project-specific'], default: 'project-specific' },
-        source:      { type: 'string' },
+        tags: { type: 'array', items: { type: 'string' } },
+        scope: {
+          type: 'string',
+          enum: ['universal', 'project-specific'],
+          default: 'project-specific',
+        },
+        source: { type: 'string' },
       },
       required: ['title', 'markdown'],
     },
@@ -250,18 +369,28 @@ export const TOOLS = [
   {
     name: 'autosnippet_skill',
     tier: 'agent',
-    description: 'Skill 管理。list=列表 | load=加载 | create=创建 | update=更新 | delete=删除 | suggest=AI推荐。',
+    description:
+      'Skill 管理。list=列表 | load=加载 | create=创建 | update=更新 | delete=删除 | suggest=AI推荐。',
     inputSchema: {
       type: 'object',
       properties: {
-        operation:   { type: 'string', enum: ['list', 'load', 'create', 'update', 'delete', 'suggest'], description: 'list=列表 | load=加载 | create=创建 | update=更新 | delete=删除 | suggest=推荐' },
-        name:        { type: 'string', description: 'Skill 名称（load/create/update/delete）' },
-        skillName:   { type: 'string', description: 'Skill 名称（load 的别名，兼容旧调用）' },
-        section:     { type: 'string', description: '章节过滤（load）' },
+        operation: {
+          type: 'string',
+          enum: ['list', 'load', 'create', 'update', 'delete', 'suggest'],
+          description:
+            'list=列表 | load=加载 | create=创建 | update=更新 | delete=删除 | suggest=推荐',
+        },
+        name: { type: 'string', description: 'Skill 名称（load/create/update/delete）' },
+        skillName: { type: 'string', description: 'Skill 名称（load 的别名，兼容旧调用）' },
+        section: { type: 'string', description: '章节过滤（load）' },
         description: { type: 'string', description: '描述（create/update）' },
-        content:     { type: 'string', description: 'Markdown 正文（create/update）' },
-        overwrite:   { type: 'boolean', default: false, description: '覆盖已存在（create）' },
-        createdBy:   { type: 'string', enum: ['manual', 'user-ai', 'system-ai', 'external-ai'], default: 'external-ai' },
+        content: { type: 'string', description: 'Markdown 正文（create/update）' },
+        overwrite: { type: 'boolean', default: false, description: '覆盖已存在（create）' },
+        createdBy: {
+          type: 'string',
+          enum: ['manual', 'user-ai', 'system-ai', 'external-ai'],
+          default: 'external-ai',
+        },
       },
       required: ['operation'],
     },
@@ -271,19 +400,36 @@ export const TOOLS = [
   {
     name: 'autosnippet_bootstrap',
     tier: 'agent',
-    description: '冷启动与项目扫描。knowledge=初始化知识库9维度 | refine=AI润色候选 | scan=轻量探查。',
+    description:
+      '冷启动与项目扫描。knowledge=初始化知识库9维度 | refine=AI润色候选 | scan=轻量探查。',
     inputSchema: {
       type: 'object',
       properties: {
-        operation:       { type: 'string', enum: ['knowledge', 'refine', 'scan'], description: 'knowledge=冷启动 | refine=AI润色 | scan=轻量探查' },
-        maxFiles:        { type: 'number', default: 500, description: '最大扫描文件数（knowledge/scan）' },
-        contentMaxLines: { type: 'number', default: 120, description: '每文件最大行数（knowledge/scan）' },
-        skipGuard:       { type: 'boolean', default: false, description: '跳过 Guard 审计（knowledge）' },
-        loadSkills:      { type: 'boolean', default: true, description: '加载 Skills 增强维度（knowledge）' },
-        includeContent:  { type: 'boolean', default: false, description: '返回文件内容（scan）' },
-        candidateIds:    { type: 'array', items: { type: 'string' }, description: '候选 ID（refine）' },
-        userPrompt:      { type: 'string', description: '润色提示词（refine）' },
-        dryRun:          { type: 'boolean', default: false, description: '预览模式（refine）' },
+        operation: {
+          type: 'string',
+          enum: ['knowledge', 'refine', 'scan'],
+          description: 'knowledge=冷启动 | refine=AI润色 | scan=轻量探查',
+        },
+        maxFiles: { type: 'number', default: 500, description: '最大扫描文件数（knowledge/scan）' },
+        contentMaxLines: {
+          type: 'number',
+          default: 120,
+          description: '每文件最大行数（knowledge/scan）',
+        },
+        skipGuard: { type: 'boolean', default: false, description: '跳过 Guard 审计（knowledge）' },
+        loadSkills: {
+          type: 'boolean',
+          default: true,
+          description: '加载 Skills 增强维度（knowledge）',
+        },
+        includeContent: { type: 'boolean', default: false, description: '返回文件内容（scan）' },
+        candidateIds: {
+          type: 'array',
+          items: { type: 'string' },
+          description: '候选 ID（refine）',
+        },
+        userPrompt: { type: 'string', description: '润色提示词（refine）' },
+        dryRun: { type: 'boolean', default: false, description: '预览模式（refine）' },
       },
       required: ['operation'],
     },
@@ -309,7 +455,11 @@ export const TOOLS = [
     inputSchema: {
       type: 'object',
       properties: {
-        candidateIds: { type: 'array', items: { type: 'string' }, description: '候选 ID 列表（最多20条）' },
+        candidateIds: {
+          type: 'array',
+          items: { type: 'string' },
+          description: '候选 ID 列表（最多20条）',
+        },
       },
       required: ['candidateIds'],
     },
@@ -319,12 +469,25 @@ export const TOOLS = [
   {
     name: 'autosnippet_knowledge_lifecycle',
     tier: 'admin',
-    description: '知识条目生命周期操作：submit/approve/reject/publish/deprecate/reactivate/fast_track。',
+    description:
+      '知识条目生命周期操作：submit/approve/reject/publish/deprecate/reactivate/fast_track。',
     inputSchema: {
       type: 'object',
       properties: {
-        id:     { type: 'string', description: '知识条目 ID' },
-        action: { type: 'string', enum: ['submit', 'approve', 'reject', 'publish', 'deprecate', 'reactivate', 'to_draft', 'fast_track'] },
+        id: { type: 'string', description: '知识条目 ID' },
+        action: {
+          type: 'string',
+          enum: [
+            'submit',
+            'approve',
+            'reject',
+            'publish',
+            'deprecate',
+            'reactivate',
+            'to_draft',
+            'fast_track',
+          ],
+        },
         reason: { type: 'string', description: 'reject/deprecate 原因' },
       },
       required: ['id', 'action'],
@@ -343,18 +506,30 @@ export const TOOLS = [
           type: 'object',
           description: '候选结构',
           properties: {
-            title: { type: 'string' }, code: { type: 'string' }, language: { type: 'string' },
-            category: { type: 'string' }, knowledgeType: { type: 'string' },
+            title: { type: 'string' },
+            code: { type: 'string' },
+            language: { type: 'string' },
+            category: { type: 'string' },
+            knowledgeType: { type: 'string' },
             complexity: { type: 'string', enum: ['beginner', 'intermediate', 'advanced'] },
             scope: { type: 'string', enum: ['universal', 'project-specific', 'target-specific'] },
             tags: { type: 'array', items: { type: 'string' } },
-            description: { type: 'string' }, trigger: { type: 'string' },
-            usageGuide: { type: 'string' }, rationale: { type: 'string' },
+            description: { type: 'string' },
+            trigger: { type: 'string' },
+            usageGuide: { type: 'string' },
+            rationale: { type: 'string' },
             headers: { type: 'array', items: { type: 'string' } },
             steps: { type: 'array', items: { type: 'object' } },
             codeChanges: { type: 'array', items: { type: 'object' } },
             constraints: { type: 'object' },
-            reasoning: { type: 'object', properties: { whyStandard: { type: 'string' }, sources: { type: 'array', items: { type: 'string' } }, confidence: { type: 'number' } } },
+            reasoning: {
+              type: 'object',
+              properties: {
+                whyStandard: { type: 'string' },
+                sources: { type: 'array', items: { type: 'string' } },
+                confidence: { type: 'number' },
+              },
+            },
           },
         },
         strict: { type: 'boolean', default: false },
@@ -371,9 +546,17 @@ export const TOOLS = [
     inputSchema: {
       type: 'object',
       properties: {
-        candidate: { type: 'object', properties: { title: { type: 'string' }, summary: { type: 'string' }, usageGuide: { type: 'string' }, code: { type: 'string' } } },
+        candidate: {
+          type: 'object',
+          properties: {
+            title: { type: 'string' },
+            summary: { type: 'string' },
+            usageGuide: { type: 'string' },
+            code: { type: 'string' },
+          },
+        },
         threshold: { type: 'number', default: 0.7 },
-        topK:      { type: 'number', default: 5 },
+        topK: { type: 'number', default: 5 },
       },
       required: ['candidate'],
     },