autosnippet 3.0.0 → 3.0.2

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

@@ -7,8 +7,8 @@
  *     支持 toolChoice: 'auto' | 'required' | 'none'
  */
 
-import { AiProvider } from '../AiProvider.js';
 import Logger from '../../../infrastructure/logging/Logger.js';
+import { AiProvider } from '../AiProvider.js';
 
 const GEMINI_BASE = 'https://generativelanguage.googleapis.com/v1beta';
 const EMBED_MODEL = 'models/gemini-embedding-001';
@@ -35,7 +35,10 @@ export class GoogleGeminiProvider extends AiProvider {
       const contents = [];
 
       for (const h of history) {
-        contents.push({ role: h.role === 'assistant' ? 'model' : 'user', parts: [{ text: h.content }] });
+        contents.push({
+          role: h.role === 'assistant' ? 'model' : 'user',
+          parts: [{ text: h.content }],
+        });
       }
       contents.push({ role: 'user', parts: [{ text: prompt }] });
 
@@ -85,9 +88,10 @@ export class GoogleGeminiProvider extends AiProvider {
       } = opts;
 
       // 统一消息 → Gemini contents
-      const contents = messages?.length > 0
-        ? this.#convertMessages(messages)
-        : [{ role: 'user', parts: [{ text: prompt }] }];
+      const contents =
+        messages?.length > 0
+          ? this.#convertMessages(messages)
+          : [{ role: 'user', parts: [{ text: prompt }] }];
 
       const body = {
         contents,
@@ -99,9 +103,11 @@ export class GoogleGeminiProvider extends AiProvider {
 
       // 工具声明: 标准 schema → Gemini functionDeclarations
       if (toolSchemas?.length > 0) {
-        body.tools = [{
-          functionDeclarations: toolSchemas.map(s => this.#toFunctionDeclaration(s)),
-        }];
+        body.tools = [
+          {
+            functionDeclarations: toolSchemas.map((s) => this.#toFunctionDeclaration(s)),
+          },
+        ];
       }
 
       // toolChoice → Gemini mode
@@ -170,7 +176,9 @@ export class GoogleGeminiProvider extends AiProvider {
         pushOrMerge({ role: 'user', parts: [{ text: msg.content || '' }] });
       } else if (msg.role === 'assistant') {
         const parts = [];
-        if (msg.content) parts.push({ text: msg.content });
+        if (msg.content) {
+          parts.push({ text: msg.content });
+        }
         if (msg.toolCalls?.length > 0) {
           for (const tc of msg.toolCalls) {
             const fcPart = { functionCall: { name: tc.name, args: tc.args || {} } };
@@ -181,7 +189,9 @@ export class GoogleGeminiProvider extends AiProvider {
             parts.push(fcPart);
           }
         }
-        if (parts.length > 0) pushOrMerge({ role: 'model', parts });
+        if (parts.length > 0) {
+          pushOrMerge({ role: 'model', parts });
+        }
       }
     }
 
@@ -198,9 +208,12 @@ export class GoogleGeminiProvider extends AiProvider {
    */
   #toGeminiMode(toolChoice) {
     switch (toolChoice) {
-      case 'required': return 'ANY';
-      case 'none':     return 'NONE';
-      default:         return 'AUTO';
+      case 'required':
+        return 'ANY';
+      case 'none':
+        return 'NONE';
+      default:
+        return 'AUTO';
     }
   }
 
@@ -227,7 +240,9 @@ export class GoogleGeminiProvider extends AiProvider {
     const cleaned = { ...schema };
     delete cleaned.default;
     delete cleaned.examples;
-    if (!cleaned.type) cleaned.type = 'object';
+    if (!cleaned.type) {
+      cleaned.type = 'object';
+    }
 
     // 递归清理 properties
     if (cleaned.properties) {
@@ -290,7 +305,9 @@ export class GoogleGeminiProvider extends AiProvider {
     }
 
     if (functionCalls.length > 0) {
-      this.logger.debug(`[GeminiProvider] native function calls: ${functionCalls.map(fc => fc.name).join(', ')}`);
+      this.logger.debug(
+        `[GeminiProvider] native function calls: ${functionCalls.map((fc) => fc.name).join(', ')}`
+      );
       return {
         text: textParts.length > 0 ? textParts.join('\n') : null,
         functionCalls,
@@ -307,10 +324,12 @@ export class GoogleGeminiProvider extends AiProvider {
 
   async summarize(code) {
     const prompt = `请对以下代码生成结构化摘要，返回 JSON 格式 {title, description, language, patterns: [], keyAPIs: []}:\n\n${code}`;
-    return await this.chatWithStructuredOutput(prompt, {
-      temperature: 0.3,
-      maxTokens: 8192,
-    }) || { title: '', description: '' };
+    return (
+      (await this.chatWithStructuredOutput(prompt, {
+        temperature: 0.3,
+        maxTokens: 8192,
+      })) || { title: '', description: '' }
+    );
   }
 
   /**
@@ -321,12 +340,7 @@ export class GoogleGeminiProvider extends AiProvider {
    */
   async chatWithStructuredOutput(prompt, opts = {}) {
     return this._withRetry(async () => {
-      const {
-        schema,
-        temperature = 0.3,
-        maxTokens = 32768,
-        systemPrompt,
-      } = opts;
+      const { schema, temperature = 0.3, maxTokens = 32768, systemPrompt } = opts;
 
       const contents = [{ role: 'user', parts: [{ text: prompt }] }];
 
@@ -351,7 +365,9 @@ export class GoogleGeminiProvider extends AiProvider {
       const data = await this._post(url, body);
       const text = data?.candidates?.[0]?.content?.parts?.[0]?.text || '';
 
-      if (!text) return null;
+      if (!text) {
+        return null;
+      }
 
       try {
         return JSON.parse(text);
@@ -370,7 +386,7 @@ export class GoogleGeminiProvider extends AiProvider {
 
     for (let i = 0; i < texts.length; i += 100) {
       const batch = texts.slice(i, i + 100);
-      const requests = batch.map(t => ({
+      const requests = batch.map((t) => ({
         model: EMBED_MODEL,
         content: { parts: [{ text: t.slice(0, 8000) }] },
       }));
@@ -378,7 +394,7 @@ export class GoogleGeminiProvider extends AiProvider {
       const url = `${GEMINI_BASE}/${EMBED_MODEL}:batchEmbedContents?key=${this.apiKey}`;
       const data = await this._post(url, { requests });
       if (data?.embeddings) {
-        results.push(...data.embeddings.map(e => e.values));
+        results.push(...data.embeddings.map((e) => e.values));
       }
     }
 
@@ -386,6 +402,14 @@ export class GoogleGeminiProvider extends AiProvider {
   }
 
   async _post(url, body) {
+    if (!this.apiKey) {
+      const err = new Error(
+        'Google Gemini API Key 未配置。请在 .env 中设置 ASD_GOOGLE_API_KEY，或运行 asd setup 完成配置。'
+      );
+      err.code = 'API_KEY_MISSING';
+      throw err;
+    }
+
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), this.timeout);
 
@@ -398,8 +422,13 @@ export class GoogleGeminiProvider extends AiProvider {
       });
       if (!res.ok) {
         let detail = '';
-        try { const j = await res.json(); detail = j?.error?.message || JSON.stringify(j).slice(0, 300); } catch { /* ignore */ }
-        const err = new Error(`Gemini API error: ${res.status}${detail ? ' — ' + detail : ''}`);
+        try {
+          const j = await res.json();
+          detail = j?.error?.message || JSON.stringify(j).slice(0, 300);
+        } catch {
+          /* ignore */
+        }
+        const err = new Error(`Gemini API error: ${res.status}${detail ? ` — ${detail}` : ''}`);
         err.status = res.status;
         throw err;
       }

package/lib/external/ai/providers/MockProvider.js

@@ -16,13 +16,17 @@ export class MockProvider extends AiProvider {
 
   async chat(prompt, context = {}) {
     this.callLog.push({ method: 'chat', prompt, context });
-    if (this.responses.chat) return this.responses.chat;
+    if (this.responses.chat) {
+      return this.responses.chat;
+    }
     return `Mock response for: ${prompt.slice(0, 80)}`;
   }
 
   async summarize(code) {
     this.callLog.push({ method: 'summarize', code: code?.slice(0, 80) });
-    if (this.responses.summarize) return this.responses.summarize;
+    if (this.responses.summarize) {
+      return this.responses.summarize;
+    }
     return {
       title: 'Mock Summary',
       description: `Summary of ${code?.length || 0} chars`,
@@ -36,7 +40,9 @@ export class MockProvider extends AiProvider {
     this.callLog.push({ method: 'embed', text: Array.isArray(text) ? text.length : 1 });
     const dim = 768;
     const makeVector = () => Array.from({ length: dim }, () => Math.random() * 2 - 1);
-    if (Array.isArray(text)) return text.map(() => makeVector());
+    if (Array.isArray(text)) {
+      return text.map(() => makeVector());
+    }
     return makeVector();
   }
 

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

@@ -7,8 +7,8 @@
  *     - 兼容 DeepSeek / Ollama 等 OpenAI-compatible API
  */
 
-import { AiProvider } from '../AiProvider.js';
 import Logger from '../../../infrastructure/logging/Logger.js';
+import { AiProvider } from '../AiProvider.js';
 
 const OPENAI_BASE = 'https://api.openai.com/v1';
 
@@ -80,9 +80,8 @@ export class OpenAiProvider extends AiProvider {
         messages.push({ role: 'system', content: systemPrompt });
       }
 
-      const srcMessages = unifiedMessages?.length > 0
-        ? unifiedMessages
-        : [{ role: 'user', content: prompt }];
+      const srcMessages =
+        unifiedMessages?.length > 0 ? unifiedMessages : [{ role: 'user', content: prompt }];
 
       for (const msg of srcMessages) {
         if (msg.role === 'user') {
@@ -90,7 +89,7 @@ export class OpenAiProvider extends AiProvider {
         } else if (msg.role === 'assistant') {
           const m = { role: 'assistant', content: msg.content || null };
           if (msg.toolCalls?.length > 0) {
-            m.tool_calls = msg.toolCalls.map(tc => ({
+            m.tool_calls = msg.toolCalls.map((tc) => ({
               id: tc.id,
               type: 'function',
               function: {
@@ -118,7 +117,7 @@ export class OpenAiProvider extends AiProvider {
 
       // 标准 tool schemas → OpenAI tools format
       if (toolSchemas?.length > 0) {
-        body.tools = toolSchemas.map(s => ({
+        body.tools = toolSchemas.map((s) => ({
           type: 'function',
           function: {
             name: s.name,
@@ -129,9 +128,13 @@ export class OpenAiProvider extends AiProvider {
       }
 
       // toolChoice → OpenAI tool_choice
-      if (toolChoice === 'required') body.tool_choice = 'required';
-      else if (toolChoice === 'none') body.tool_choice = 'none';
-      else body.tool_choice = 'auto';
+      if (toolChoice === 'required') {
+        body.tool_choice = 'required';
+      } else if (toolChoice === 'none') {
+        body.tool_choice = 'none';
+      } else {
+        body.tool_choice = 'auto';
+      }
 
       const data = await this._post(`${this.baseUrl}/chat/completions`, body);
       return this.#parseToolResponse(data);
@@ -156,25 +159,32 @@ export class OpenAiProvider extends AiProvider {
         }
       : null;
 
-    if (!choice) return { text: '', functionCalls: null, usage };
+    if (!choice) {
+      return { text: '', functionCalls: null, usage };
+    }
 
     const message = choice.message;
     const text = message?.content || null;
 
     if (message?.tool_calls?.length > 0) {
       const functionCalls = message.tool_calls
-        .filter(tc => tc.type === 'function')
-        .map(tc => ({
+        .filter((tc) => tc.type === 'function')
+        .map((tc) => ({
           id: tc.id,
           name: tc.function.name,
           args: (() => {
-            try { return JSON.parse(tc.function.arguments || '{}'); }
-            catch { return {}; }
+            try {
+              return JSON.parse(tc.function.arguments || '{}');
+            } catch {
+              return {};
+            }
           })(),
         }));
 
       if (functionCalls.length > 0) {
-        this.logger.debug(`[OpenAI] native function calls: ${functionCalls.map(fc => fc.name).join(', ')}`);
+        this.logger.debug(
+          `[OpenAI] native function calls: ${functionCalls.map((fc) => fc.name).join(', ')}`
+        );
         return { text, functionCalls, usage };
       }
     }
@@ -184,10 +194,12 @@ export class OpenAiProvider extends AiProvider {
 
   async summarize(code) {
     const prompt = `请对以下代码生成结构化摘要，返回 JSON 格式 {title, description, language, patterns: [], keyAPIs: []}:\n\n${code}`;
-    return await this.chatWithStructuredOutput(prompt, {
-      temperature: 0.3,
-      maxTokens: 4096,
-    }) || { title: '', description: '' };
+    return (
+      (await this.chatWithStructuredOutput(prompt, {
+        temperature: 0.3,
+        maxTokens: 4096,
+      })) || { title: '', description: '' }
+    );
   }
 
   /**
@@ -198,11 +210,7 @@ export class OpenAiProvider extends AiProvider {
    */
   async chatWithStructuredOutput(prompt, opts = {}) {
     return this._withRetry(async () => {
-      const {
-        temperature = 0.3,
-        maxTokens = 32768,
-        systemPrompt,
-      } = opts;
+      const { temperature = 0.3, maxTokens = 32768, systemPrompt } = opts;
 
       const messages = [];
       if (systemPrompt) {
@@ -221,7 +229,9 @@ export class OpenAiProvider extends AiProvider {
       const data = await this._post(`${this.baseUrl}/chat/completions`, body);
       const text = data?.choices?.[0]?.message?.content || '';
 
-      if (!text) return null;
+      if (!text) {
+        return null;
+      }
 
       try {
         return JSON.parse(text);
@@ -240,15 +250,17 @@ export class OpenAiProvider extends AiProvider {
     try {
       const body = {
         model: this.embedModel,
-        input: texts.map(t => t.slice(0, 8000)),
+        input: texts.map((t) => t.slice(0, 8000)),
       };
 
       const data = await this._post(`${this.baseUrl}/embeddings`, body);
       const embeddings = (data?.data || [])
         .sort((a, b) => a.index - b.index)
-        .map(d => d.embedding);
+        .map((d) => d.embedding);
 
-      if (embeddings.length === 0) return Array.isArray(text) ? [] : [];
+      if (embeddings.length === 0) {
+        return Array.isArray(text) ? [] : [];
+      }
       return Array.isArray(text) ? embeddings : embeddings[0];
     } catch (err) {
       this.logger.warn(`${this.name} embed failed, returning empty`, { error: err.message });
@@ -257,6 +269,16 @@ export class OpenAiProvider extends AiProvider {
   }
 
   async _post(url, body) {
+    // Ollama 使用固定 dummy key，不需要校验
+    if (!this.apiKey && this.name !== 'ollama') {
+      const envKey = this.name === 'deepseek' ? 'ASD_DEEPSEEK_API_KEY' : 'ASD_OPENAI_API_KEY';
+      const err = new Error(
+        `${this.name} API Key 未配置。请在 .env 中设置 ${envKey}，或运行 asd setup 完成配置。`
+      );
+      err.code = 'API_KEY_MISSING';
+      throw err;
+    }
+
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), this.timeout);
 
@@ -265,7 +287,7 @@ export class OpenAiProvider extends AiProvider {
         method: 'POST',
         headers: {
           'Content-Type': 'application/json',
-          'Authorization': `Bearer ${this.apiKey}`,
+          Authorization: `Bearer ${this.apiKey}`,
         },
         body: JSON.stringify(body),
         signal: controller.signal,

package/lib/external/mcp/McpServer.js

@@ -17,21 +17,18 @@
 
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import {
-  CallToolRequestSchema,
-  ListToolsRequestSchema,
-} from '@modelcontextprotocol/sdk/types.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import Logger from '../../infrastructure/logging/Logger.js';
 import { envelope } from './envelope.js';
-import { TOOLS, TOOL_GATEWAY_MAP, TIER_ORDER } from './tools.js';
 import { wrapHandler } from './errorHandler.js';
+import { TIER_ORDER, TOOL_GATEWAY_MAP, TOOLS } from './tools.js';
 
 // ─── Handler 模块 ─────────────────────────────────────────────
 
-import * as systemHandlers from './handlers/system.js';
 import * as candidateHandlers from './handlers/candidate.js';
-import * as knowledgeHandlers from './handlers/knowledge.js';
 import * as consolidated from './handlers/consolidated.js';
+import * as knowledgeHandlers from './handlers/knowledge.js';
+import * as systemHandlers from './handlers/system.js';
 
 // ─── McpServer 类 ─────────────────────────────────────────────
 
@@ -78,7 +75,9 @@ export class McpServer {
       });
 
       // 注册 Gateway action handlers
-      const { registerGatewayActions } = await import('../../core/gateway/GatewayActionRegistry.js');
+      const { registerGatewayActions } = await import(
+        '../../core/gateway/GatewayActionRegistry.js'
+      );
       const gateway = this.container.get('gateway');
       if (gateway) {
         registerGatewayActions(gateway, this.container);
@@ -87,7 +86,7 @@ export class McpServer {
 
     this.server = new Server(
       { name: 'autosnippet-v3', version: '3.0.0' },
-      { capabilities: { tools: {} } },
+      { capabilities: { tools: {} } }
     );
 
     this._registerHandlers();
@@ -103,7 +102,7 @@ export class McpServer {
     this.server.setRequestHandler(ListToolsRequestSchema, async () => {
       const tierName = process.env.ASD_MCP_TIER || 'agent';
       const maxTier = TIER_ORDER[tierName] ?? TIER_ORDER.agent;
-      const visible = TOOLS.filter(t => (TIER_ORDER[t.tier || 'agent'] ?? 0) <= maxTier);
+      const visible = TOOLS.filter((t) => (TIER_ORDER[t.tier || 'agent'] ?? 0) <= maxTier);
       return { tools: visible };
     });
 
@@ -113,10 +112,22 @@ export class McpServer {
       const t0 = Date.now();
       try {
         const result = await this._handleToolCall(name, args || {});
-        return { content: [{ type: 'text', text: typeof result === 'string' ? result : JSON.stringify(result, null, 2) }] };
+        return {
+          content: [
+            {
+              type: 'text',
+              text: typeof result === 'string' ? result : JSON.stringify(result, null, 2),
+            },
+          ],
+        };
       } catch (err) {
         this.logger.error(`MCP tool error: ${name}`, { error: err.message });
-        const env = envelope({ success: false, message: err.message, errorCode: 'TOOL_ERROR', meta: { tool: name, responseTimeMs: Date.now() - t0 } });
+        const env = envelope({
+          success: false,
+          message: err.message,
+          errorCode: 'TOOL_ERROR',
+          meta: { tool: name, responseTimeMs: Date.now() - t0 },
+        });
         return { content: [{ type: 'text', text: JSON.stringify(env, null, 2) }], isError: true };
       }
     });
@@ -130,7 +141,9 @@ export class McpServer {
 
     // 查找 handler 并通过 wrapHandler 统一错误处理
     const handler = this._resolveHandler(name);
-    if (!handler) throw new Error(`Unknown tool: ${name}`);
+    if (!handler) {
+      throw new Error(`Unknown tool: ${name}`);
+    }
 
     const wrapped = wrapHandler(name, handler);
     return wrapped(ctx, args);
@@ -143,23 +156,25 @@ export class McpServer {
   _resolveHandler(name) {
     const HANDLER_MAP = {
       // ── Agent 层 (12) ──
-      autosnippet_health:                 (ctx) => systemHandlers.health(ctx),
-      autosnippet_capabilities:           () => systemHandlers.capabilities(),
-      autosnippet_search:                 (ctx, args) => consolidated.consolidatedSearch(ctx, args),
-      autosnippet_knowledge:              (ctx, args) => consolidated.consolidatedKnowledge(ctx, args),
-      autosnippet_structure:              (ctx, args) => consolidated.consolidatedStructure(ctx, args),
-      autosnippet_graph:                  (ctx, args) => consolidated.consolidatedGraph(ctx, args),
-      autosnippet_guard:                  (ctx, args) => consolidated.consolidatedGuard(ctx, args),
-      autosnippet_submit_knowledge:       (ctx, args) => consolidated.enhancedSubmitKnowledge(ctx, args),
-      autosnippet_submit_knowledge_batch: (ctx, args) => knowledgeHandlers.submitKnowledgeBatch(ctx, args),
-      autosnippet_save_document:          (ctx, args) => knowledgeHandlers.saveDocument(ctx, args),
-      autosnippet_skill:                  (ctx, args) => consolidated.consolidatedSkill(ctx, args),
-      autosnippet_bootstrap:              (ctx, args) => consolidated.consolidatedBootstrap(ctx, args),
+      autosnippet_health: (ctx) => systemHandlers.health(ctx),
+      autosnippet_capabilities: () => systemHandlers.capabilities(),
+      autosnippet_search: (ctx, args) => consolidated.consolidatedSearch(ctx, args),
+      autosnippet_knowledge: (ctx, args) => consolidated.consolidatedKnowledge(ctx, args),
+      autosnippet_structure: (ctx, args) => consolidated.consolidatedStructure(ctx, args),
+      autosnippet_graph: (ctx, args) => consolidated.consolidatedGraph(ctx, args),
+      autosnippet_guard: (ctx, args) => consolidated.consolidatedGuard(ctx, args),
+      autosnippet_submit_knowledge: (ctx, args) => consolidated.enhancedSubmitKnowledge(ctx, args),
+      autosnippet_submit_knowledge_batch: (ctx, args) =>
+        knowledgeHandlers.submitKnowledgeBatch(ctx, args),
+      autosnippet_save_document: (ctx, args) => knowledgeHandlers.saveDocument(ctx, args),
+      autosnippet_skill: (ctx, args) => consolidated.consolidatedSkill(ctx, args),
+      autosnippet_bootstrap: (ctx, args) => consolidated.consolidatedBootstrap(ctx, args),
       // ── Admin 层 (+4) ──
-      autosnippet_enrich_candidates:      (ctx, args) => candidateHandlers.enrichCandidates(ctx, args),
-      autosnippet_knowledge_lifecycle:    (ctx, args) => knowledgeHandlers.knowledgeLifecycle(ctx, args),
-      autosnippet_validate_candidate:     (ctx, args) => candidateHandlers.validateCandidate(ctx, args),
-      autosnippet_check_duplicate:        (ctx, args) => candidateHandlers.checkDuplicate(ctx, args),
+      autosnippet_enrich_candidates: (ctx, args) => candidateHandlers.enrichCandidates(ctx, args),
+      autosnippet_knowledge_lifecycle: (ctx, args) =>
+        knowledgeHandlers.knowledgeLifecycle(ctx, args),
+      autosnippet_validate_candidate: (ctx, args) => candidateHandlers.validateCandidate(ctx, args),
+      autosnippet_check_duplicate: (ctx, args) => candidateHandlers.checkDuplicate(ctx, args),
     };
     return HANDLER_MAP[name] || null;
   }
@@ -171,17 +186,23 @@ export class McpServer {
    */
   async _gatewayGate(toolName, args) {
     let mapping = TOOL_GATEWAY_MAP[toolName];
-    if (!mapping) return; // 只读工具，跳过
+    if (!mapping) {
+      return; // 只读工具，跳过
+    }
 
     // 动态 resolver：根据 args 计算实际 action/resource
     if (typeof mapping.resolver === 'function') {
       mapping = mapping.resolver(args);
-      if (!mapping) return; // resolver 返回 null 表示只读操作
+      if (!mapping) {
+        return; // resolver 返回 null 表示只读操作
+      }
     }
 
     try {
       const gateway = this.container.get('gateway');
-      if (!gateway) return; // Gateway 未初始化，降级放行
+      if (!gateway) {
+        return; // Gateway 未初始化，降级放行
+      }
 
       const result = await gateway.checkOnly({
         actor: 'external_agent',
@@ -200,7 +221,10 @@ export class McpServer {
       this.logger.debug(`MCP Gateway gating passed: ${toolName}`, { requestId: result.requestId });
     } catch (err) {
       // 区分 Gateway 自身错误 vs 权限拒绝
-      if (err.message?.startsWith('[PERMISSION_DENIED]') || err.message?.startsWith('[CONSTITUTION_VIOLATION]')) {
+      if (
+        err.message?.startsWith('[PERMISSION_DENIED]') ||
+        err.message?.startsWith('[CONSTITUTION_VIOLATION]')
+      ) {
         throw err;
       }
       // Gateway 内部故障不应阻断业务（降级放行 + 记录）
@@ -217,15 +241,21 @@ export class McpServer {
 
     const tierName = process.env.ASD_MCP_TIER || 'agent';
     const maxTier = TIER_ORDER[tierName] ?? TIER_ORDER.agent;
-    const visibleCount = TOOLS.filter(t => (TIER_ORDER[t.tier || 'agent'] ?? 0) <= maxTier).length;
+    const visibleCount = TOOLS.filter(
+      (t) => (TIER_ORDER[t.tier || 'agent'] ?? 0) <= maxTier
+    ).length;
 
     this.logger.info(`MCP Server started (stdio) — ${visibleCount} tools [tier=${tierName}]`);
     process.stderr.write(`AutoSnippet MCP ready — ${visibleCount} tools [tier=${tierName}]\n`);
   }
 
   async shutdown() {
-    if (this.server) await this.server.close();
-    if (this.bootstrap) await this.bootstrap.shutdown();
+    if (this.server) {
+      await this.server.close();
+    }
+    if (this.bootstrap) {
+      await this.bootstrap.shutdown();
+    }
   }
 }
 

package/lib/external/mcp/errorHandler.js

@@ -10,15 +10,15 @@
  * @module external/mcp/errorHandler
  */
 
-import { envelope } from './envelope.js';
+import Logger from '../../infrastructure/logging/Logger.js';
 import {
-  ValidationError,
-  NotFoundError,
   ConflictError,
-  PermissionDenied,
   ConstitutionViolation,
+  NotFoundError,
+  PermissionDenied,
+  ValidationError,
 } from '../../shared/errors/index.js';
-import Logger from '../../infrastructure/logging/Logger.js';
+import { envelope } from './envelope.js';
 
 const logger = Logger.getInstance();
 
@@ -28,12 +28,24 @@ const logger = Logger.getInstance();
  * @returns {string}
  */
 function inferErrorCode(err) {
-  if (err instanceof ValidationError)       return 'VALIDATION_ERROR';
-  if (err instanceof NotFoundError)         return 'NOT_FOUND';
-  if (err instanceof ConflictError)         return 'CONFLICT';
-  if (err instanceof PermissionDenied)      return 'PERMISSION_DENIED';
-  if (err instanceof ConstitutionViolation) return 'CONSTITUTION_VIOLATION';
-  if (err.code)                             return err.code;
+  if (err instanceof ValidationError) {
+    return 'VALIDATION_ERROR';
+  }
+  if (err instanceof NotFoundError) {
+    return 'NOT_FOUND';
+  }
+  if (err instanceof ConflictError) {
+    return 'CONFLICT';
+  }
+  if (err instanceof PermissionDenied) {
+    return 'PERMISSION_DENIED';
+  }
+  if (err instanceof ConstitutionViolation) {
+    return 'CONSTITUTION_VIOLATION';
+  }
+  if (err.code) {
+    return err.code;
+  }
   return 'INTERNAL_ERROR';
 }