autosnippet 3.0.0 → 3.0.2

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

@@ -7,38 +7,16 @@
  *   - 主语言 → 语言扩展字段（分析维度、典型模式、反模式、Guard 规则等）
  */
 
-import path from 'path';
+import { LanguageService } from '../../../shared/LanguageService.js';
 
-/** 根据文件扩展名推断语言 */
+/** 根据文件扩展名推断语言 — 委托给 LanguageService（唯一来源） */
 export function inferLang(filename) {
-  const ext = path.extname(filename).toLowerCase();
-  const map = {
-    '.swift': 'swift', '.m': 'objectivec', '.h': 'objectivec', '.mm': 'objectivec',
-    '.c': 'c', '.cpp': 'cpp', '.js': 'javascript', '.ts': 'typescript',
-    '.py': 'python', '.rb': 'ruby', '.java': 'java', '.kt': 'kotlin',
-  };
-  return map[ext] || 'unknown';
+  return LanguageService.inferLang(filename);
 }
 
-/** 从 langStats 推断主语言 — 按映射后的语言聚合计数 */
+/** 从 langStats 推断主语言 — 委托给 LanguageService（唯一来源） */
 export function detectPrimaryLanguage(langStats) {
-  const langMap = {
-    swift: 'swift', m: 'objectivec', h: 'objectivec', mm: 'objectivec',
-    c: 'c', cpp: 'cpp', js: 'javascript', ts: 'typescript', jsx: 'javascript', tsx: 'typescript',
-    py: 'python', rb: 'ruby', java: 'java', kt: 'kotlin', go: 'go', rs: 'rust',
-    dart: 'dart', cs: 'csharp',
-  };
-  // 按映射后的语言聚合计数，避免多扩展名语言（ObjC .h/.m/.mm）计数分散
-  const aggregated = {};
-  for (const [ext, count] of Object.entries(langStats)) {
-    const lang = langMap[ext] || ext;
-    aggregated[lang] = (aggregated[lang] || 0) + count;
-  }
-  let best = 'unknown', bestCount = 0;
-  for (const [lang, count] of Object.entries(aggregated)) {
-    if (count > bestCount) { best = lang; bestCount = count; }
-  }
-  return best;
+  return LanguageService.detectPrimary(langStats);
 }
 
 /**
@@ -59,10 +37,26 @@ export function buildLanguageExtension(lang) {
   switch (lang) {
     case 'swift':
       base.extraDimensions = [
-        { id: 'concurrency', label: 'Swift Concurrency', guide: 'async/await、Actor、@Sendable、TaskGroup、MainActor 用法' },
-        { id: 'protocol-oriented', label: '面向协议编程', guide: 'Protocol 扩展、条件一致性、PAT (Protocol with Associated Type)' },
-        { id: 'property-wrapper', label: 'Property Wrapper', guide: '@Published、@State、@Environment、自定义 Property Wrapper' },
-        { id: 'value-semantics', label: '值语义', guide: 'struct vs class 决策、COW (Copy-on-Write)、Equatable/Hashable' },
+        {
+          id: 'concurrency',
+          label: 'Swift Concurrency',
+          guide: 'async/await、Actor、@Sendable、TaskGroup、MainActor 用法',
+        },
+        {
+          id: 'protocol-oriented',
+          label: '面向协议编程',
+          guide: 'Protocol 扩展、条件一致性、PAT (Protocol with Associated Type)',
+        },
+        {
+          id: 'property-wrapper',
+          label: 'Property Wrapper',
+          guide: '@Published、@State、@Environment、自定义 Property Wrapper',
+        },
+        {
+          id: 'value-semantics',
+          label: '值语义',
+          guide: 'struct vs class 决策、COW (Copy-on-Write)、Equatable/Hashable',
+        },
       ];
       base.typicalPatterns = [
         'Result<Success, Failure> 统一错误处理',
@@ -74,8 +68,16 @@ export function buildLanguageExtension(lang) {
       ];
       base.commonAntiPatterns = [
         { bad: '强制 try! / as! 解包', why: '运行时 crash', fix: 'guard let / if let / do-catch' },
-        { bad: 'DispatchQueue.main.async 更新 UI', why: 'Swift Concurrency 下造成 data race', fix: '@MainActor' },
-        { bad: '闭包中不用 [weak self]', why: '循环引用导致内存泄漏', fix: '[weak self] / [unowned self]' },
+        {
+          bad: 'DispatchQueue.main.async 更新 UI',
+          why: 'Swift Concurrency 下造成 data race',
+          fix: '@MainActor',
+        },
+        {
+          bad: '闭包中不用 [weak self]',
+          why: '循环引用导致内存泄漏',
+          fix: '[weak self] / [unowned self]',
+        },
       ];
       base.suggestedGuardRules = [
         { pattern: 'try!', severity: 'warning', message: '避免 force try，使用 do-catch' },
@@ -93,10 +95,26 @@ export function buildLanguageExtension(lang) {
 
     case 'objectivec':
       base.extraDimensions = [
-        { id: 'memory-management', label: '内存管理', guide: 'ARC 下的 strong/weak/unsafe_unretained、autorelease、dealloc 模式' },
-        { id: 'category-extension', label: 'Category/Extension', guide: 'Category 方法命名冲突、Class Extension 私有属性' },
-        { id: 'block-pattern', label: 'Block 模式', guide: 'Block 循环引用、__weak/__strong dance、Block 作为回调' },
-        { id: 'nullability', label: 'Nullability 标注', guide: 'nullable/nonnull/NS_ASSUME_NONNULL、与 Swift 互操作' },
+        {
+          id: 'memory-management',
+          label: '内存管理',
+          guide: 'ARC 下的 strong/weak/unsafe_unretained、autorelease、dealloc 模式',
+        },
+        {
+          id: 'category-extension',
+          label: 'Category/Extension',
+          guide: 'Category 方法命名冲突、Class Extension 私有属性',
+        },
+        {
+          id: 'block-pattern',
+          label: 'Block 模式',
+          guide: 'Block 循环引用、__weak/__strong dance、Block 作为回调',
+        },
+        {
+          id: 'nullability',
+          label: 'Nullability 标注',
+          guide: 'nullable/nonnull/NS_ASSUME_NONNULL、与 Swift 互操作',
+        },
       ];
       base.typicalPatterns = [
         'delegate + protocol 回调模式',
@@ -108,11 +126,23 @@ export function buildLanguageExtension(lang) {
       ];
       base.commonAntiPatterns = [
         { bad: 'Block 内直接引用 self', why: '循环引用', fix: '__weak + __strong dance' },
-        { bad: '头文件缺少 nullability 标注', why: 'Swift 桥接时全部变为 optional', fix: 'NS_ASSUME_NONNULL + 显式 nullable' },
-        { bad: 'Category 方法不带前缀', why: '与系统方法/其他库冲突', fix: '加项目前缀如 xx_methodName' },
+        {
+          bad: '头文件缺少 nullability 标注',
+          why: 'Swift 桥接时全部变为 optional',
+          fix: 'NS_ASSUME_NONNULL + 显式 nullable',
+        },
+        {
+          bad: 'Category 方法不带前缀',
+          why: '与系统方法/其他库冲突',
+          fix: '加项目前缀如 xx_methodName',
+        },
       ];
       base.suggestedGuardRules = [
-        { pattern: '\\[self\\s', severity: 'warning', message: 'Block 内直接引用 self，考虑 __weak' },
+        {
+          pattern: '\\[self\\s',
+          severity: 'warning',
+          message: 'Block 内直接引用 self，考虑 __weak',
+        },
       ];
       base.agentCautions = [
         'ObjC 头文件必须包含 NS_ASSUME_NONNULL_BEGIN/END',
@@ -125,10 +155,29 @@ export function buildLanguageExtension(lang) {
     case 'typescript':
     case 'javascript':
       base.extraDimensions = [
-        { id: 'module-system', label: '模块系统', guide: 'ESM vs CJS、dynamic import、barrel export、tree-shaking' },
-        { id: 'type-safety', label: '类型安全', guide: lang === 'typescript' ? 'strict 模式、泛型、类型守卫、Utility Types' : 'JSDoc 类型标注、.d.ts 声明' },
-        { id: 'async-pattern', label: '异步模式', guide: 'Promise 链、async/await、Error 处理、AbortController' },
-        { id: 'framework-convention', label: '框架约定', guide: 'React Hooks/Vue Composition/Node.js 中间件等框架特有模式' },
+        {
+          id: 'module-system',
+          label: '模块系统',
+          guide: 'ESM vs CJS、dynamic import、barrel export、tree-shaking',
+        },
+        {
+          id: 'type-safety',
+          label: '类型安全',
+          guide:
+            lang === 'typescript'
+              ? 'strict 模式、泛型、类型守卫、Utility Types'
+              : 'JSDoc 类型标注、.d.ts 声明',
+        },
+        {
+          id: 'async-pattern',
+          label: '异步模式',
+          guide: 'Promise 链、async/await、Error 处理、AbortController',
+        },
+        {
+          id: 'framework-convention',
+          label: '框架约定',
+          guide: 'React Hooks/Vue Composition/Node.js 中间件等框架特有模式',
+        },
       ];
       base.typicalPatterns = [
         'async/await + try-catch 错误处理',
@@ -157,9 +206,17 @@ export function buildLanguageExtension(lang) {
 
     case 'python':
       base.extraDimensions = [
-        { id: 'type-hints', label: '类型注解', guide: 'typing 模块、Protocol、TypeVar、Generic、dataclass' },
+        {
+          id: 'type-hints',
+          label: '类型注解',
+          guide: 'typing 模块、Protocol、TypeVar、Generic、dataclass',
+        },
         { id: 'async-io', label: '异步 IO', guide: 'asyncio、aiohttp、async generators' },
-        { id: 'package-structure', label: '包结构', guide: '__init__.py、相对导入、pyproject.toml' },
+        {
+          id: 'package-structure',
+          label: '包结构',
+          guide: '__init__.py、相对导入、pyproject.toml',
+        },
       ];
       base.typicalPatterns = [
         'dataclass 数据建模',
@@ -205,8 +262,16 @@ export function buildLanguageExtension(lang) {
 
     case 'java':
       base.extraDimensions = [
-        { id: 'concurrency', label: '并发', guide: 'synchronized、ExecutorService、CompletableFuture、虚拟线程 (21+)' },
-        { id: 'generics', label: '泛型', guide: '类型擦除、通配符 <? extends/super>、类型安全容器' },
+        {
+          id: 'concurrency',
+          label: '并发',
+          guide: 'synchronized、ExecutorService、CompletableFuture、虚拟线程 (21+)',
+        },
+        {
+          id: 'generics',
+          label: '泛型',
+          guide: '类型擦除、通配符 <? extends/super>、类型安全容器',
+        },
       ];
       base.typicalPatterns = [
         'Builder 模式',
@@ -224,8 +289,16 @@ export function buildLanguageExtension(lang) {
 
     case 'go':
       base.extraDimensions = [
-        { id: 'goroutine', label: 'Goroutine/Channel', guide: '并发模式、channel、select、context 传播' },
-        { id: 'error-handling', label: '错误处理', guide: 'error interface、errors.Is/As、sentinel errors、%w wrap' },
+        {
+          id: 'goroutine',
+          label: 'Goroutine/Channel',
+          guide: '并发模式、channel、select、context 传播',
+        },
+        {
+          id: 'error-handling',
+          label: '错误处理',
+          guide: 'error interface、errors.Is/As、sentinel errors、%w wrap',
+        },
         { id: 'interface', label: '接口设计', guide: '隐式实现、小接口、io.Reader/Writer 组合' },
       ];
       base.typicalPatterns = [
@@ -244,9 +317,21 @@ export function buildLanguageExtension(lang) {
 
     case 'rust':
       base.extraDimensions = [
-        { id: 'ownership', label: '所有权/借用', guide: 'ownership、borrowing、lifetime、Clone vs Copy' },
-        { id: 'error-handling', label: '错误处理', guide: 'Result<T,E>、? 操作符、thiserror/anyhow' },
-        { id: 'trait-system', label: 'Trait 系统', guide: 'trait bound、impl Trait、dyn Trait、derive 宏' },
+        {
+          id: 'ownership',
+          label: '所有权/借用',
+          guide: 'ownership、borrowing、lifetime、Clone vs Copy',
+        },
+        {
+          id: 'error-handling',
+          label: '错误处理',
+          guide: 'Result<T,E>、? 操作符、thiserror/anyhow',
+        },
+        {
+          id: 'trait-system',
+          label: 'Trait 系统',
+          guide: 'trait bound、impl Trait、dyn Trait、derive 宏',
+        },
       ];
       base.typicalPatterns = [
         'Result<T, E> + ? 操作符',

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

@@ -9,18 +9,42 @@
 /** 根据 Target 名称推断模块职责 */
 export function inferTargetRole(targetName) {
   const n = targetName.toLowerCase();
-  if (/core|kit|shared|common|foundation|base/i.test(n)) return 'core';
-  if (/service|manager|provider|repository|store/i.test(n)) return 'service';
-  if (/ui|view|screen|component|widget/i.test(n)) return 'ui';
-  if (/network|api|http|grpc|socket/i.test(n)) return 'networking';
-  if (/storage|database|cache|persist|realm|coredata/i.test(n)) return 'storage';
-  if (/test|spec|mock|stub|fake/i.test(n)) return 'test';
-  if (/app|main|launch|entry/i.test(n)) return 'app';
-  if (/router|coordinator|navigation/i.test(n)) return 'routing';
-  if (/util|helper|extension|tool/i.test(n)) return 'utility';
-  if (/model|entity|dto|schema/i.test(n)) return 'model';
-  if (/auth|login|session|token/i.test(n)) return 'auth';
-  if (/config|setting|environment|constant/i.test(n)) return 'config';
+  if (/core|kit|shared|common|foundation|base/i.test(n)) {
+    return 'core';
+  }
+  if (/service|manager|provider|repository|store/i.test(n)) {
+    return 'service';
+  }
+  if (/ui|view|screen|component|widget/i.test(n)) {
+    return 'ui';
+  }
+  if (/network|api|http|grpc|socket/i.test(n)) {
+    return 'networking';
+  }
+  if (/storage|database|cache|persist|realm|coredata/i.test(n)) {
+    return 'storage';
+  }
+  if (/test|spec|mock|stub|fake/i.test(n)) {
+    return 'test';
+  }
+  if (/app|main|launch|entry/i.test(n)) {
+    return 'app';
+  }
+  if (/router|coordinator|navigation/i.test(n)) {
+    return 'routing';
+  }
+  if (/util|helper|extension|tool/i.test(n)) {
+    return 'utility';
+  }
+  if (/model|entity|dto|schema/i.test(n)) {
+    return 'model';
+  }
+  if (/auth|login|session|token/i.test(n)) {
+    return 'auth';
+  }
+  if (/config|setting|environment|constant/i.test(n)) {
+    return 'config';
+  }
   return 'feature';
 }
 
@@ -28,11 +52,23 @@ export function inferTargetRole(targetName) {
 export function inferFilePriority(filename) {
   const n = filename.toLowerCase();
   // High: core definitions, services, protocols, configs
-  if (/protocol|interface|delegate|service|manager|provider|config|constant|router|coordinator|factory|builder/i.test(n)) return 'high';
-  if (/^(app|main|launch|entry|bootstrap)/i.test(n)) return 'high';
+  if (
+    /protocol|interface|delegate|service|manager|provider|config|constant|router|coordinator|factory|builder/i.test(
+      n
+    )
+  ) {
+    return 'high';
+  }
+  if (/^(app|main|launch|entry|bootstrap)/i.test(n)) {
+    return 'high';
+  }
   // Low: tests, extensions, helpers, generated
-  if (/test|spec|mock|stub|fake|\+|\bext\b|extension|helper|generated|\.pb\./i.test(n)) return 'low';
-  if (/readme|changelog|license/i.test(n)) return 'low';
+  if (/test|spec|mock|stub|fake|\+|\bext\b|extension|helper|generated|\.pb\./i.test(n)) {
+    return 'low';
+  }
+  if (/readme|changelog|license/i.test(n)) {
+    return 'low';
+  }
   // Medium: everything else
   return 'medium';
 }

package/lib/external/mcp/handlers/bootstrap/pipeline/BootstrapSnapshot.js

@@ -46,7 +46,9 @@ export class BootstrapSnapshot {
    * @param {object} [opts.logger]
    */
   constructor(db, { logger } = {}) {
-    if (!db) throw new Error('BootstrapSnapshot requires a database instance');
+    if (!db) {
+      throw new Error('BootstrapSnapshot requires a database instance');
+    }
     this.#db = typeof db?.getDb === 'function' ? db.getDb() : db;
     this.#logger = logger || null;
 
@@ -134,9 +136,12 @@ export class BootstrapSnapshot {
       for (const [dimId, stat] of Object.entries(dimensionStats || {})) {
         const refFiles = stat.referencedFilesList || [];
         for (const filePath of refFiles) {
-          const rel = typeof filePath === 'string'
-            ? (filePath.startsWith('/') ? relative(projectRoot, filePath) : filePath)
-            : filePath;
+          const rel =
+            typeof filePath === 'string'
+              ? filePath.startsWith('/')
+                ? relative(projectRoot, filePath)
+                : filePath
+              : filePath;
           this.#stmts.insertDimFile.run({
             snapshot_id: id,
             dim_id: dimId,
@@ -152,7 +157,9 @@ export class BootstrapSnapshot {
 
     saveTransaction();
 
-    this.#log(`Snapshot saved: ${id} (${allFiles.length} files, ${Object.keys(dimensionStats || {}).length} dims)`);
+    this.#log(
+      `Snapshot saved: ${id} (${allFiles.length} files, ${Object.keys(dimensionStats || {}).length} dims)`
+    );
     return id;
   }
 
@@ -182,7 +189,9 @@ export class BootstrapSnapshot {
    */
   getLatest(projectRoot) {
     const row = this.#stmts.getLatest.get(projectRoot);
-    if (!row) return null;
+    if (!row) {
+      return null;
+    }
     return this.#deserialize(row);
   }
 
@@ -193,7 +202,9 @@ export class BootstrapSnapshot {
    */
   getById(id) {
     const row = this.#stmts.getById.get(id);
-    if (!row) return null;
+    if (!row) {
+      return null;
+    }
     return this.#deserialize(row);
   }
 
@@ -204,8 +215,7 @@ export class BootstrapSnapshot {
    * @returns {Array<object>}
    */
   list(projectRoot, limit = 10) {
-    return this.#stmts.listByProject.all(projectRoot, limit)
-      .map(r => this.#deserialize(r));
+    return this.#stmts.listByProject.all(projectRoot, limit).map((r) => this.#deserialize(r));
   }
 
   // ─── 增量 Diff 计算 ──────────────────────────────────
@@ -244,7 +254,7 @@ export class BootstrapSnapshot {
     }
 
     // 已删除的文件
-    const deleted = Object.keys(oldHashes).filter(p => !(p in newHashes));
+    const deleted = Object.keys(oldHashes).filter((p) => !(p in newHashes));
 
     const totalFiles = Object.keys(newHashes).length || 1;
     const changedCount = added.length + modified.length + deleted.length;
@@ -269,8 +279,12 @@ export class BootstrapSnapshot {
    * @returns {{ mode: 'incremental'|'full', dimensions: string[], skippedDimensions: string[], reason: string }}
    */
   inferAffectedDimensions(snapshot, diff, allDimIds) {
-    const changeRatio = (diff.added.length + diff.modified.length + diff.deleted.length) /
-      (diff.added.length + diff.modified.length + diff.deleted.length + (diff.unchanged?.length || 0) || 1);
+    const changeRatio =
+      (diff.added.length + diff.modified.length + diff.deleted.length) /
+      (diff.added.length +
+        diff.modified.length +
+        diff.deleted.length +
+        (diff.unchanged?.length || 0) || 1);
 
     // 变更超过 50% → 全量
     if (changeRatio > FULL_REBUILD_THRESHOLD) {
@@ -322,8 +336,8 @@ export class BootstrapSnapshot {
       affected.add('project-profile');
     }
 
-    const dimensions = allDimIds.filter(d => affected.has(d));
-    const skippedDimensions = allDimIds.filter(d => !affected.has(d));
+    const dimensions = allDimIds.filter((d) => affected.has(d));
+    const skippedDimensions = allDimIds.filter((d) => !affected.has(d));
 
     return {
       mode: 'incremental',
@@ -344,7 +358,9 @@ export class BootstrapSnapshot {
     const rows = this.#stmts.getDimFiles.all(snapshotId);
     const map = {};
     for (const row of rows) {
-      if (!map[row.dim_id]) map[row.dim_id] = new Set();
+      if (!map[row.dim_id]) {
+        map[row.dim_id] = new Set();
+      }
       map[row.dim_id].add(row.file_path);
     }
     return map;
@@ -376,19 +392,61 @@ export class BootstrapSnapshot {
       dims.push('code-standard', 'architecture');
     }
 
+    // TS/JS 相关
+    if (['ts', 'tsx', 'js', 'jsx', 'mjs', 'cjs', 'vue', 'svelte'].includes(ext)) {
+      dims.push('module-export-scan', 'code-standard', 'architecture');
+    }
+
+    // Python 相关
+    if (ext === 'py') {
+      dims.push('python-package-scan', 'code-standard', 'architecture');
+    }
+
+    // Java/Kotlin 相关
+    if (['java', 'kt', 'kts'].includes(ext)) {
+      dims.push('jvm-annotation-scan', 'code-standard', 'architecture');
+    }
+
     // 配置文件
-    if (['json', 'yaml', 'yml', 'plist', 'xcconfig'].includes(ext)) {
+    if (
+      ['json', 'yaml', 'yml', 'plist', 'xcconfig', 'toml', 'properties', 'gradle'].includes(ext)
+    ) {
       dims.push('project-profile');
     }
 
     // 通用: 代码文件都可能影响 code-pattern 和 best-practice
-    if (['m', 'mm', 'h', 'swift', 'js', 'ts', 'py'].includes(ext)) {
+    if (
+      [
+        'm',
+        'mm',
+        'h',
+        'swift',
+        'js',
+        'jsx',
+        'ts',
+        'tsx',
+        'mjs',
+        'cjs',
+        'py',
+        'java',
+        'kt',
+        'kts',
+        'go',
+        'rs',
+        'rb',
+      ].includes(ext)
+    ) {
       dims.push('code-pattern', 'best-practice');
     }
 
     // 数据流相关
-    if (name.includes('manager') || name.includes('service') || name.includes('event') ||
-        name.includes('notification') || name.includes('delegate')) {
+    if (
+      name.includes('manager') ||
+      name.includes('service') ||
+      name.includes('event') ||
+      name.includes('notification') ||
+      name.includes('delegate')
+    ) {
       dims.push('event-and-data-flow');
     }
 
@@ -398,7 +456,10 @@ export class BootstrapSnapshot {
   // ─── 内部方法 ─────────────────────────────────────────
 
   #computeContentHash(content) {
-    return createHash('sha256').update(content || '').digest('hex').substring(0, 16);
+    return createHash('sha256')
+      .update(content || '')
+      .digest('hex')
+      .substring(0, 16);
   }
 
   #readFileContent(filePath) {