autosnippet 3.0.0 → 3.0.2

package/lib/external/mcp/handlers/guard.js

@@ -8,13 +8,19 @@ import path from 'node:path';
 import { envelope } from '../envelope.js';
 
 export async function guardCheck(ctx, args) {
-  const { GuardCheckEngine, detectLanguage } = await import('../../../service/guard/GuardCheckEngine.js');
+  const { GuardCheckEngine, detectLanguage } = await import(
+    '../../../service/guard/GuardCheckEngine.js'
+  );
 
   // 输入校验：空代码直接返回
   if (!args.code || !args.code.trim()) {
     return envelope({
       success: true,
-      data: { language: args.language || 'unknown', violations: [], summary: { total: 0, errors: 0, warnings: 0 } },
+      data: {
+        language: args.language || 'unknown',
+        violations: [],
+        summary: { total: 0, errors: 0, warnings: 0 },
+      },
       meta: { tool: 'autosnippet_guard', note: 'Empty code — skipped' },
     });
   }
@@ -30,10 +36,14 @@ export async function guardCheck(ctx, args) {
     if (skillHooks.has('onGuardCheck')) {
       for (let i = 0; i < violations.length; i++) {
         const modified = await skillHooks.run('onGuardCheck', violations[i], { language });
-        if (modified && typeof modified === 'object') violations[i] = modified;
+        if (modified && typeof modified === 'object') {
+          violations[i] = modified;
+        }
       }
     }
-  } catch { /* skillHooks not available */ }
+  } catch {
+    /* skillHooks not available */
+  }
 
   const warnings = [];
   if (language === 'unknown') {
@@ -42,7 +52,16 @@ export async function guardCheck(ctx, args) {
 
   return envelope({
     success: true,
-    data: { language, violations, summary: { total: violations.length, errors: violations.filter(v => v.severity === 'error').length, warnings: violations.filter(v => v.severity === 'warning').length }, ...(warnings.length ? { warnings } : {}) },
+    data: {
+      language,
+      violations,
+      summary: {
+        total: violations.length,
+        errors: violations.filter((v) => v.severity === 'error').length,
+        warnings: violations.filter((v) => v.severity === 'warning').length,
+      },
+      ...(warnings.length ? { warnings } : {}),
+    },
     meta: { tool: 'autosnippet_guard' },
   });
 }
@@ -58,7 +77,7 @@ export async function guardAuditFiles(ctx, args) {
   const engine = new GuardCheckEngine(db);
 
   // 补充缺失的 content（从磁盘读取）
-  const filesToAudit = args.files.map(f => ({
+  const filesToAudit = args.files.map((f) => ({
     path: f.path,
     content: f.content || (fs.existsSync(f.path) ? fs.readFileSync(f.path, 'utf8') : ''),
   }));
@@ -68,7 +87,7 @@ export async function guardAuditFiles(ctx, args) {
   // 写入 ViolationsStore + GuardFeedbackLoop
   try {
     const violationsStore = ctx.container.get('violationsStore');
-    for (const fileResult of (result.files || [])) {
+    for (const fileResult of result.files || []) {
       if (fileResult.violations.length > 0) {
         violationsStore.appendRun({
           filePath: fileResult.filePath,
@@ -81,21 +100,27 @@ export async function guardAuditFiles(ctx, args) {
       try {
         const feedbackLoop = ctx.container.get('guardFeedbackLoop');
         feedbackLoop.processFixDetection(fileResult, fileResult.filePath);
-      } catch { /* guardFeedbackLoop not available */ }
+      } catch {
+        /* guardFeedbackLoop not available */
+      }
     }
-  } catch { /* ViolationsStore not available */ }
+  } catch {
+    /* ViolationsStore not available */
+  }
 
   return envelope({
     success: true,
     data: {
       summary: result.summary,
-      files: result.files.map(f => ({
+      files: result.files.map((f) => ({
         filePath: f.filePath,
         language: f.language,
         violations: f.violations,
         summary: f.summary,
       })),
-      ...(result.crossFileViolations?.length ? { crossFileViolations: result.crossFileViolations } : {}),
+      ...(result.crossFileViolations?.length
+        ? { crossFileViolations: result.crossFileViolations }
+        : {}),
     },
     meta: { tool: 'autosnippet_guard' },
   });
@@ -107,13 +132,25 @@ export async function scanProject(ctx, args) {
   const contentMaxLines = args.contentMaxLines || 100;
 
   const projectRoot = process.env.ASD_PROJECT_DIR || process.cwd();
-  const { SpmService } = await import('../../../service/spm/SpmService.js');
-  const spm = new SpmService(projectRoot);
-  await spm.load();
-  const allTargets = await spm.listTargets();
+
+  // 优先使用 ModuleService（多语言统一入口），回退到 SpmService
+  let service;
+  try {
+    const { ModuleService } = await import('../../../service/module/ModuleService.js');
+    service = new ModuleService(projectRoot);
+  } catch {
+    const { SpmService } = await import('../../../platform/ios/spm/SpmService.js');
+    service = new SpmService(projectRoot);
+  }
+  await service.load();
+  const allTargets = await service.listTargets();
 
   if (!allTargets || allTargets.length === 0) {
-    return envelope({ success: true, data: { targets: [], files: [], guardAudit: null, message: 'No SPM targets found' }, meta: { tool: 'autosnippet_bootstrap' } });
+    return envelope({
+      success: true,
+      data: { targets: [], files: [], guardAudit: null, message: 'No module targets found' },
+      meta: { tool: 'autosnippet_bootstrap' },
+    });
   }
 
   // 收集所有文件（去重）
@@ -121,12 +158,19 @@ export async function scanProject(ctx, args) {
   const allFiles = [];
   for (const t of allTargets) {
     try {
-      const fileList = await spm.getTargetFiles(t);
+      const fileList = await service.getTargetFiles(t);
       for (const f of fileList) {
         const fp = typeof f === 'string' ? f : f.path;
-        if (seenPaths.has(fp)) continue;
+        if (seenPaths.has(fp)) {
+          continue;
+        }
         seenPaths.add(fp);
-        const entry = { name: f.name || path.basename(fp), path: fp, relativePath: f.relativePath || path.basename(fp), targetName: t.name };
+        const entry = {
+          name: f.name || path.basename(fp),
+          path: fp,
+          relativePath: f.relativePath || path.basename(fp),
+          targetName: t.name,
+        };
         if (includeContent) {
           try {
             const raw = fs.readFileSync(fp, 'utf8');
@@ -134,13 +178,22 @@ export async function scanProject(ctx, args) {
             entry.content = lines.slice(0, contentMaxLines).join('\n');
             entry.totalLines = lines.length;
             entry.truncated = lines.length > contentMaxLines;
-          } catch { entry.content = ''; entry.totalLines = 0; }
+          } catch {
+            entry.content = '';
+            entry.totalLines = 0;
+          }
         }
         allFiles.push(entry);
-        if (allFiles.length >= maxFiles) break;
+        if (allFiles.length >= maxFiles) {
+          break;
+        }
       }
-    } catch { /* skip target */ }
-    if (allFiles.length >= maxFiles) break;
+    } catch {
+      /* skip target */
+    }
+    if (allFiles.length >= maxFiles) {
+      break;
+    }
   }
 
   // Guard 审计
@@ -150,7 +203,7 @@ export async function scanProject(ctx, args) {
     const db = ctx.container.get('database');
     const engine = new GuardCheckEngine(db);
 
-    const filesToAudit = allFiles.map(f => {
+    const filesToAudit = allFiles.map((f) => {
       const content = f.content || (fs.existsSync(f.path) ? fs.readFileSync(f.path, 'utf8') : '');
       return { path: f.path, content };
     });
@@ -159,7 +212,7 @@ export async function scanProject(ctx, args) {
     // 写入 ViolationsStore
     try {
       const violationsStore = ctx.container.get('violationsStore');
-      for (const fileResult of (guardAudit.files || [])) {
+      for (const fileResult of guardAudit.files || []) {
         if (fileResult.violations.length > 0) {
           violationsStore.appendRun({
             filePath: fileResult.filePath,
@@ -168,34 +221,46 @@ export async function scanProject(ctx, args) {
           });
         }
       }
-    } catch { /* store not available */ }
+    } catch {
+      /* store not available */
+    }
   } catch (e) {
     ctx.logger.warn(`[MCP] Guard audit in scanProject failed: ${e.message}`);
   }
 
   // 构建文件列表摘要
-  const fileSummary = allFiles.map(f => {
+  const fileSummary = allFiles.map((f) => {
     const base = { name: f.name, path: f.relativePath, targetName: f.targetName };
-    if (includeContent) { base.content = f.content; base.totalLines = f.totalLines; base.truncated = f.truncated; }
+    if (includeContent) {
+      base.content = f.content;
+      base.totalLines = f.totalLines;
+      base.truncated = f.truncated;
+    }
     return base;
   });
 
   return envelope({
     success: true,
     data: {
-      targets: allTargets.map(t => ({ name: t.name, type: t.type, packageName: t.packageName })),
+      targets: allTargets.map((t) => ({ name: t.name, type: t.type, packageName: t.packageName })),
       files: fileSummary,
       fileCount: allFiles.length,
-      guardAudit: guardAudit ? {
-        summary: guardAudit.summary,
-        filesWithViolations: (guardAudit.files || []).filter(f => f.violations.length > 0).map(f => ({
-          filePath: f.filePath,
-          language: f.language,
-          violations: f.violations,
-          summary: f.summary,
-        })),
-        ...(guardAudit.crossFileViolations?.length ? { crossFileViolations: guardAudit.crossFileViolations } : {}),
-      } : null,
+      guardAudit: guardAudit
+        ? {
+            summary: guardAudit.summary,
+            filesWithViolations: (guardAudit.files || [])
+              .filter((f) => f.violations.length > 0)
+              .map((f) => ({
+                filePath: f.filePath,
+                language: f.language,
+                violations: f.violations,
+                summary: f.summary,
+              })),
+            ...(guardAudit.crossFileViolations?.length
+              ? { crossFileViolations: guardAudit.crossFileViolations }
+              : {}),
+          }
+        : null,
     },
     meta: { tool: 'autosnippet_bootstrap' },
   });

package/lib/external/mcp/handlers/knowledge.js

@@ -3,8 +3,8 @@
  * submitKnowledge, submitKnowledgeBatch, knowledgeLifecycle
  */
 
-import { envelope } from '../envelope.js';
 import { checkRecipeReadiness } from '../../../shared/RecipeReadinessChecker.js';
+import { envelope } from '../envelope.js';
 
 // ─── 限流 ──────────────────────────────────────────────────
 
@@ -36,7 +36,9 @@ function _enrichToV3(args, container) {
   const data = { ...args };
 
   // 来源标记（非 Cursor 职责）
-  if (!data.source) data.source = 'mcp';
+  if (!data.source) {
+    data.source = 'mcp';
+  }
 
   // QualityScorer 评分（程序化）
   try {
@@ -55,7 +57,9 @@ function _enrichToV3(args, container) {
         grade: scoreResult.grade || '',
       };
     }
-  } catch { /* best effort */ }
+  } catch {
+    /* best effort */
+  }
 
   // RecipeExtractor 语义标签（程序化）
   try {
@@ -64,17 +68,25 @@ function _enrichToV3(args, container) {
       const codeForTags = data.content?.pattern || '';
       if (codeForTags) {
         const extracted = recipeExtractor.extractFromContent(
-          codeForTags, `${data.title || 'unknown'}.${data.language || 'swift'}`, ''
+          codeForTags,
+          `${data.title || 'unknown'}.${data.language || 'unknown'}`,
+          ''
         );
         if (extracted.semanticTags?.length > 0) {
           data.tags = [...new Set([...(data.tags || []), ...extracted.semanticTags])];
         }
-        if ((!data.category || data.category === 'Utility') && extracted.category && extracted.category !== 'general') {
+        if (
+          (!data.category || data.category === 'Utility') &&
+          extracted.category &&
+          extracted.category !== 'general'
+        ) {
           data.category = extracted.category;
         }
       }
     }
-  } catch { /* best effort */ }
+  } catch {
+    /* best effort */
+  }
 
   return data;
 }
@@ -90,7 +102,9 @@ function _enrichToV3(args, container) {
 export async function submitKnowledge(ctx, args) {
   // 限流
   const blocked = await _checkRateLimit('autosnippet_submit_knowledge', args.client_id);
-  if (blocked) return blocked;
+  if (blocked) {
+    return blocked;
+  }
 
   const service = ctx.container.get('knowledgeService');
 
@@ -135,23 +149,27 @@ export async function submitKnowledgeBatch(ctx, args) {
 
   // 限流
   const blocked = await _checkRateLimit('autosnippet_submit_knowledge_batch', args.client_id);
-  if (blocked) return blocked;
+  if (blocked) {
+    return blocked;
+  }
 
   // 去重（可选）
   let items = args.items;
   if (args.deduplicate !== false) {
     try {
-      const { aggregateCandidates } = await import('../../../service/candidate/CandidateAggregator.js');
+      const { aggregateCandidates } = await import(
+        '../../../service/candidate/CandidateAggregator.js'
+      );
       // 对 title 字段做去重
-      const readinessItems = items.map(it => ({
+      const readinessItems = items.map((it) => ({
         ...it,
         code: it.content?.pattern || it.code || '',
       }));
       const result = aggregateCandidates(readinessItems);
       // 保留原始 items 顺序中去重后的
       if (result.items && result.items.length < items.length) {
-        const titles = new Set(result.items.map(it => it.title));
-        items = items.filter(it => titles.has(it.title));
+        const titles = new Set(result.items.map((it) => it.title));
+        items = items.filter((it) => titles.has(it.title));
       }
     } catch {
       // CandidateAggregator 加载失败时降级：不去重
@@ -188,11 +206,13 @@ export async function submitKnowledgeBatch(ctx, args) {
   }
 
   const data = { count, total: items.length, targetName: args.target_name };
-  if (itemErrors.length > 0) data.errors = itemErrors;
+  if (itemErrors.length > 0) {
+    data.errors = itemErrors;
+  }
 
   // 被拒绝的条目：告知 Agent 需补齐哪些字段
   if (rejectedItems.length > 0) {
-    const allMissing = [...new Set(rejectedItems.flatMap(it => it.missingFields))];
+    const allMissing = [...new Set(rejectedItems.flatMap((it) => it.missingFields))];
     data.rejectedItems = rejectedItems;
     data.rejectedSummary = {
       rejectedCount: rejectedItems.length,
@@ -268,34 +288,36 @@ export async function saveDocument(ctx, args) {
 
   // 限流
   const blocked = await _checkRateLimit('autosnippet_save_document', args.client_id);
-  if (blocked) return blocked;
+  if (blocked) {
+    return blocked;
+  }
 
   const service = ctx.container.get('knowledgeService');
 
   const data = {
-    title:         args.title.trim(),
-    description:   args.description || '',
+    title: args.title.trim(),
+    description: args.description || '',
     knowledgeType: 'dev-document',
-    kind:          'fact',
-    source:        args.source || 'agent',
-    scope:         args.scope || 'project-specific',
-    tags:          args.tags || [],
+    kind: 'fact',
+    source: args.source || 'agent',
+    scope: args.scope || 'project-specific',
+    tags: args.tags || [],
     content: {
       markdown: args.markdown,
-      pattern:  '',
+      pattern: '',
     },
     // 文档不需要 Cursor Delivery 字段
-    trigger:    '',
-    doClause:   '',
+    trigger: '',
+    doClause: '',
     dontClause: '',
     whenClause: '',
-    topicHint:  '',
-    coreCode:   '',
+    topicHint: '',
+    coreCode: '',
     // 基础推理
     reasoning: {
       whyStandard: 'Agent development document — preserved for team knowledge',
-      sources:     ['agent'],
-      confidence:  0.8,
+      sources: ['agent'],
+      confidence: 0.8,
     },
   };
 
@@ -311,10 +333,10 @@ export async function saveDocument(ctx, args) {
   return envelope({
     success: true,
     data: {
-      id:        entry.id,
+      id: entry.id,
       lifecycle: 'active',
-      title:     entry.title,
-      kind:      'fact',
+      title: entry.title,
+      kind: 'fact',
       knowledgeType: 'dev-document',
     },
     message: `文档「${entry.title}」已保存到知识库。`,
@@ -336,11 +358,13 @@ function _toReadinessInput(args) {
     trigger: args.trigger,
     description: args.description,
     headers: args.headers,
-    reasoning: args.reasoning ? {
-      whyStandard: args.reasoning.whyStandard,
-      sources: args.reasoning.sources,
-      confidence: args.reasoning.confidence,
-    } : undefined,
+    reasoning: args.reasoning
+      ? {
+          whyStandard: args.reasoning.whyStandard,
+          sources: args.reasoning.sources,
+          confidence: args.reasoning.confidence,
+        }
+      : undefined,
     knowledgeType: args.knowledgeType,
     complexity: args.complexity,
     usageGuide: args.usageGuide,

package/lib/external/mcp/handlers/search.js

@@ -50,8 +50,10 @@ function groupByKind(items) {
  * 根据 kind 参数过滤 items
  */
 function filterByKind(items, kind) {
-  if (!kind || kind === 'all') return items;
-  return items.filter(it => (it.kind || it.metadata?.kind || 'pattern') === kind);
+  if (!kind || kind === 'all') {
+    return items;
+  }
+  return items.filter((it) => (it.kind || it.metadata?.kind || 'pattern') === kind);
 }
 
 // ─── 1. autosnippet_search — 统合搜索入口 ─────────────────────
@@ -64,7 +66,7 @@ function filterByKind(items, kind) {
  */
 export async function search(ctx, args) {
   const t0 = Date.now();
-  const engine = getSearchEngine(ctx) || await getFallbackEngine(ctx);
+  const engine = getSearchEngine(ctx) || (await getFallbackEngine(ctx));
   const query = args.query;
   const limit = args.limit || 10;
   const kind = args.kind || args.type || 'all';
@@ -72,7 +74,10 @@ export async function search(ctx, args) {
 
   // 统一调用 SearchEngine（auto 模式内置 BM25+semantic 融合去重 + Ranking Pipeline）
   const result = await engine.search(query, {
-    mode, limit: kind !== 'all' ? limit * 2 : limit, rank: true, groupByKind: true,
+    mode,
+    limit: kind !== 'all' ? limit * 2 : limit,
+    rank: true,
+    groupByKind: true,
   });
   let items = result?.items || [];
   const actualMode = result?.mode || mode;
@@ -93,7 +98,11 @@ export async function search(ctx, args) {
       totalResults: items.length,
       items,
       byKind,
-      kindCounts: { rule: byKind.rule.length, pattern: byKind.pattern.length, fact: byKind.fact.length },
+      kindCounts: {
+        rule: byKind.rule.length,
+        pattern: byKind.pattern.length,
+        fact: byKind.fact.length,
+      },
     },
     meta: { tool: 'autosnippet_search', responseTimeMs: elapsed },
   });
@@ -111,11 +120,14 @@ export async function search(ctx, args) {
  */
 export async function contextSearch(ctx, args) {
   const t0 = Date.now();
-  const engine = getSearchEngine(ctx) || await getFallbackEngine(ctx);
+  const engine = getSearchEngine(ctx) || (await getFallbackEngine(ctx));
   const limit = args.limit ?? 5;
 
   const result = await engine.search(args.query, {
-    mode: 'bm25', limit, rank: true, groupByKind: true,
+    mode: 'bm25',
+    limit,
+    rank: true,
+    groupByKind: true,
     context: {
       intent: 'search',
       language: args.language,
@@ -136,7 +148,11 @@ export async function contextSearch(ctx, args) {
       metadata: {
         responseTimeMs: elapsed,
         totalResults: items.length,
-        kindCounts: { rule: byKind.rule.length, pattern: byKind.pattern.length, fact: byKind.fact.length },
+        kindCounts: {
+          rule: byKind.rule.length,
+          pattern: byKind.pattern.length,
+          fact: byKind.fact.length,
+        },
       },
     },
     meta: { tool: 'autosnippet_context_search', source, responseTimeMs: elapsed },
@@ -154,13 +170,15 @@ export async function contextSearch(ctx, args) {
  */
 export async function keywordSearch(ctx, args) {
   const t0 = Date.now();
-  const engine = getSearchEngine(ctx) || await getFallbackEngine(ctx);
+  const engine = getSearchEngine(ctx) || (await getFallbackEngine(ctx));
   const query = args.query;
   const limit = args.limit || 10;
   const kind = args.kind || 'all';
 
   const result = await engine.search(query, {
-    mode: 'keyword', limit, groupByKind: true,
+    mode: 'keyword',
+    limit,
+    groupByKind: true,
   });
 
   let items = result?.items || [];
@@ -177,7 +195,11 @@ export async function keywordSearch(ctx, args) {
       totalResults: items.length,
       items,
       byKind,
-      kindCounts: { rule: byKind.rule.length, pattern: byKind.pattern.length, fact: byKind.fact.length },
+      kindCounts: {
+        rule: byKind.rule.length,
+        pattern: byKind.pattern.length,
+        fact: byKind.fact.length,
+      },
     },
     meta: { tool: 'autosnippet_keyword_search', responseTimeMs: elapsed },
   });
@@ -194,13 +216,16 @@ export async function keywordSearch(ctx, args) {
  */
 export async function semanticSearch(ctx, args) {
   const t0 = Date.now();
-  const engine = getSearchEngine(ctx) || await getFallbackEngine(ctx);
+  const engine = getSearchEngine(ctx) || (await getFallbackEngine(ctx));
   const query = args.query;
   const limit = args.limit || 10;
   const kind = args.kind || 'all';
 
   const result = await engine.search(query, {
-    mode: 'semantic', limit: limit * 2, rank: true, groupByKind: true,
+    mode: 'semantic',
+    limit: limit * 2,
+    rank: true,
+    groupByKind: true,
   });
 
   let items = result?.items || [];
@@ -223,7 +248,11 @@ export async function semanticSearch(ctx, args) {
       totalResults: items.length,
       items,
       byKind,
-      kindCounts: { rule: byKind.rule.length, pattern: byKind.pattern.length, fact: byKind.fact.length },
+      kindCounts: {
+        rule: byKind.rule.length,
+        pattern: byKind.pattern.length,
+        fact: byKind.fact.length,
+      },
     },
     meta: { tool: 'autosnippet_semantic_search', responseTimeMs: elapsed },
   });