autosnippet 3.0.0 → 3.0.2

package/lib/infrastructure/plugin/PluginManager.js

@@ -6,7 +6,7 @@
 import Logger from '../logging/Logger.js';
 
 export class PluginManager {
-  #plugins;    // Map<name, { plugin, enabled, priority, meta }>
+  #plugins; // Map<name, { plugin, enabled, priority, meta }>
   #logger;
 
   constructor() {
@@ -37,7 +37,11 @@ export class PluginManager {
   unregister(name) {
     const entry = this.#plugins.get(name);
     if (entry?.plugin?.destroy) {
-      try { entry.plugin.destroy(); } catch { /* silent */ }
+      try {
+        entry.plugin.destroy();
+      } catch {
+        /* silent */
+      }
     }
     this.#plugins.delete(name);
   }
@@ -47,7 +51,9 @@ export class PluginManager {
    */
   setEnabled(name, enabled) {
     const entry = this.#plugins.get(name);
-    if (entry) entry.enabled = enabled;
+    if (entry) {
+      entry.enabled = enabled;
+    }
   }
 
   /**
@@ -56,7 +62,9 @@ export class PluginManager {
   async initAll(context = {}) {
     const sorted = this.#getSorted();
     for (const { name, entry } of sorted) {
-      if (!entry.enabled || !entry.plugin.init) continue;
+      if (!entry.enabled || !entry.plugin.init) {
+        continue;
+      }
       try {
         await entry.plugin.init(context);
         this.#logger.debug(`[PluginManager] 初始化: ${name}`);
@@ -70,9 +78,13 @@ export class PluginManager {
    * 销毁所有插件
    */
   async destroyAll() {
-    for (const [name, entry] of this.#plugins) {
+    for (const [_name, entry] of this.#plugins) {
       if (entry.plugin.destroy) {
-        try { await entry.plugin.destroy(); } catch { /* silent */ }
+        try {
+          await entry.plugin.destroy();
+        } catch {
+          /* silent */
+        }
       }
     }
     this.#plugins.clear();
@@ -84,7 +96,11 @@ export class PluginManager {
   getEnabled() {
     return this.#getSorted()
       .filter(({ entry }) => entry.enabled)
-      .map(({ name, entry }) => ({ name, priority: entry.priority, description: entry.description }));
+      .map(({ name, entry }) => ({
+        name,
+        priority: entry.priority,
+        description: entry.description,
+      }));
   }
 
   /**
@@ -102,7 +118,9 @@ export class PluginManager {
   async callHook(hookName, ...args) {
     const results = [];
     for (const { name, entry } of this.#getSorted()) {
-      if (!entry.enabled || !entry.plugin[hookName]) continue;
+      if (!entry.enabled || !entry.plugin[hookName]) {
+        continue;
+      }
       try {
         const result = await entry.plugin[hookName](...args);
         results.push({ name, result });

package/lib/infrastructure/realtime/RealtimeService.js

@@ -17,8 +17,8 @@ export class RealtimeService {
         methods: ['GET', 'POST'],
       },
       transports: ['websocket', 'polling'],
-      pingInterval: 25000,   // 25s 心跳间隔（默认值，显式声明）
-      pingTimeout: 20000,    // 20s 超时（默认值）
+      pingInterval: 25000, // 25s 心跳间隔（默认值，显式声明）
+      pingTimeout: 20000, // 20s 超时（默认值）
     });
 
     this.setupEventHandlers();

package/lib/infrastructure/vector/Chunker.js

@@ -23,7 +23,9 @@ export function chunk(content, metadata = {}, options = {}) {
     overlapTokens = DEFAULT_OVERLAP_TOKENS,
   } = options;
 
-  if (!content || content.trim().length === 0) return [];
+  if (!content || content.trim().length === 0) {
+    return [];
+  }
 
   const tokens = estimateTokens(content);
 
@@ -86,7 +88,7 @@ function chunkBySection(content, metadata, maxChunkTokens) {
       buffer = section;
       continue;
     }
-    const combined = buffer.content + '\n' + section.content;
+    const combined = `${buffer.content}\n${section.content}`;
     if (estimateTokens(combined) <= maxChunkTokens) {
       buffer = { title: buffer.title, content: combined };
     } else {
@@ -94,7 +96,9 @@ function chunkBySection(content, metadata, maxChunkTokens) {
       buffer = section;
     }
   }
-  if (buffer) merged.push(buffer);
+  if (buffer) {
+    merged.push(buffer);
+  }
 
   // 对超大段落做 fixed 分割
   const results = [];
@@ -105,7 +109,12 @@ function chunkBySection(content, metadata, maxChunkTokens) {
       for (const sub of subChunks) {
         results.push({
           content: sub.content,
-          metadata: { ...metadata, ...sub.metadata, sectionTitle: section.title, chunkIndex: results.length },
+          metadata: {
+            ...metadata,
+            ...sub.metadata,
+            sectionTitle: section.title,
+            chunkIndex: results.length,
+          },
         });
       }
     } else {
@@ -117,7 +126,9 @@ function chunkBySection(content, metadata, maxChunkTokens) {
   }
 
   // 设置 totalChunks
-  for (const chunk of results) chunk.metadata.totalChunks = results.length;
+  for (const chunk of results) {
+    chunk.metadata.totalChunks = results.length;
+  }
   return results;
 }
 
@@ -152,10 +163,14 @@ function chunkFixed(content, metadata, maxChunkTokens, overlapTokens) {
     const nextStart = end - overlapChars;
     // 确保至少前进 1 字符，防止 overlap >= maxChars 时无限循环
     start = nextStart > start ? nextStart : end;
-    if (start >= content.length) break;
+    if (start >= content.length) {
+      break;
+    }
   }
 
-  for (const chunk of results) chunk.metadata.totalChunks = results.length;
+  for (const chunk of results) {
+    chunk.metadata.totalChunks = results.length;
+  }
   return results;
 }
 

package/lib/infrastructure/vector/IndexingPipeline.js

@@ -3,17 +3,26 @@
  * scan → chunk → detect incremental changes (sourceHash) → embed via AI → batch upsert
  */
 
-import { readdirSync, readFileSync, statSync, existsSync } from 'node:fs';
-import { join, relative, extname } from 'node:path';
 import { createHash } from 'node:crypto';
-import { chunk, estimateTokens } from './Chunker.js';
-
-const SCANNABLE_EXTENSIONS = new Set(['.md', '.markdown', '.txt', '.swift', '.js', '.ts', '.py']);
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { extname, join, relative } from 'node:path';
+import { LanguageService } from '../../shared/LanguageService.js';
+import { chunk } from './Chunker.js';
+
+const SCANNABLE_EXTENSIONS = new Set([
+  '.md', '.markdown', '.txt',
+  '.swift', '.m', '.h',
+  '.js', '.ts', '.jsx', '.tsx',
+  '.py',
+  '.java', '.kt',
+  '.go',
+  '.rs', '.rb',
+]);
 
 export class IndexingPipeline {
-  #vectorStore;    // VectorStore 实例
-  #aiProvider;     // AiProvider 实例 (可选, 用于 embedding)
-  #scanDirs;       // 要扫描的目录
+  #vectorStore; // VectorStore 实例
+  #aiProvider; // AiProvider 实例 (可选, 用于 embedding)
+  #scanDirs; // 要扫描的目录
   #projectRoot;
 
   constructor(options = {}) {
@@ -23,8 +32,12 @@ export class IndexingPipeline {
     this.#projectRoot = options.projectRoot || process.cwd();
   }
 
-  setVectorStore(store) { this.#vectorStore = store; }
-  setAiProvider(provider) { this.#aiProvider = provider; }
+  setVectorStore(store) {
+    this.#vectorStore = store;
+  }
+  setAiProvider(provider) {
+    this.#aiProvider = provider;
+  }
 
   /**
    * 运行完整索引管线
@@ -35,7 +48,9 @@ export class IndexingPipeline {
     const { force = false, dryRun = false } = options;
     const stats = { scanned: 0, chunked: 0, embedded: 0, upserted: 0, skipped: 0, errors: 0 };
 
-    if (!this.#vectorStore) throw new Error('VectorStore not set');
+    if (!this.#vectorStore) {
+      throw new Error('VectorStore not set');
+    }
 
     // 1. 扫描文件
     const files = this.scan();
@@ -53,7 +68,7 @@ export class IndexingPipeline {
 
         // 增量检测：hash 未变时跳过
         if (!force) {
-          const existing = await this.#vectorStore.getById(baseId + '_0');
+          const existing = await this.#vectorStore.getById(`${baseId}_0`);
           if (existing?.metadata?.sourceHash === hash) {
             stats.skipped++;
             continue;
@@ -79,7 +94,9 @@ export class IndexingPipeline {
             try {
               vector = await this.#aiProvider.embed(chunkItem.content);
               stats.embedded++;
-            } catch { /* embed optional */ }
+            } catch {
+              /* embed optional */
+            }
           }
 
           batch.push({
@@ -92,14 +109,16 @@ export class IndexingPipeline {
 
         // 清理旧 chunk (如果文件 chunk 数减少)
         for (const existId of existingIds) {
-          if (existId.startsWith(baseId + '_')) {
+          if (existId.startsWith(`${baseId}_`)) {
             const idx = parseInt(existId.split('_').pop(), 10);
             if (idx >= chunks.length) {
-              if (!dryRun) await this.#vectorStore.remove(existId);
+              if (!dryRun) {
+                await this.#vectorStore.remove(existId);
+              }
             }
           }
         }
-      } catch (error) {
+      } catch (_error) {
         stats.errors++;
       }
     }
@@ -122,7 +141,9 @@ export class IndexingPipeline {
 
     for (const dir of this.#scanDirs) {
       const absDir = join(this.#projectRoot, dir);
-      if (!existsSync(absDir)) continue;
+      if (!existsSync(absDir)) {
+        continue;
+      }
       this.#walkDir(absDir, files);
     }
 
@@ -152,7 +173,9 @@ export class IndexingPipeline {
       for (const entry of entries) {
         const fullPath = join(dir, entry.name);
         if (entry.isDirectory()) {
-          if (entry.name.startsWith('.') || entry.name === 'node_modules') continue;
+          if (entry.name.startsWith('.') || entry.name === 'node_modules') {
+            continue;
+          }
           this.#walkDir(fullPath, files);
         } else if (entry.isFile()) {
           const ext = extname(entry.name).toLowerCase();
@@ -165,12 +188,13 @@ export class IndexingPipeline {
           }
         }
       }
-    } catch { /* skip unreadable dirs */ }
+    } catch {
+      /* skip unreadable dirs */
+    }
   }
 
   #detectLanguage(filePath) {
-    const ext = extname(filePath).toLowerCase();
-    const map = { '.swift': 'swift', '.js': 'javascript', '.ts': 'typescript', '.py': 'python', '.md': 'markdown' };
-    return map[ext] || 'text';
+    const lang = LanguageService.inferLang(filePath);
+    return lang === 'unknown' ? 'text' : lang;
   }
 }

package/lib/infrastructure/vector/JsonVectorAdapter.js

@@ -4,15 +4,15 @@
  * 支持余弦相似度搜索、混合搜索（向量 70% + 关键词 30%）
  */
 
-import { VectorStore } from './VectorStore.js';
-import { writeFileSync, readFileSync, mkdirSync, existsSync, statSync } from 'node:fs';
-import { join, dirname } from 'node:path';
+import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
 import pathGuard from '../../shared/PathGuard.js';
 import { cosineSimilarity } from '../../shared/similarity.js';
+import { VectorStore } from './VectorStore.js';
 
 export class JsonVectorAdapter extends VectorStore {
   #indexPath;
-  #data;       // Map<id, { id, content, vector, metadata }>
+  #data; // Map<id, { id, content, vector, metadata }>
   #dirty;
 
   constructor(projectRoot, options = {}) {
@@ -36,7 +36,9 @@ export class JsonVectorAdapter extends VectorStore {
   }
 
   async upsert(item) {
-    if (!item?.id) throw new Error('Item must have an id');
+    if (!item?.id) {
+      throw new Error('Item must have an id');
+    }
     this.#data.set(item.id, {
       id: item.id,
       content: item.content || '',
@@ -50,7 +52,9 @@ export class JsonVectorAdapter extends VectorStore {
 
   async batchUpsert(items) {
     for (const item of items) {
-      if (!item?.id) continue;
+      if (!item?.id) {
+        continue;
+      }
       this.#data.set(item.id, {
         id: item.id,
         content: item.content || '',
@@ -79,7 +83,9 @@ export class JsonVectorAdapter extends VectorStore {
   async searchVector(queryVector, options = {}) {
     const { topK = 10, filter = null, minScore = 0 } = options;
 
-    if (!queryVector || queryVector.length === 0) return [];
+    if (!queryVector || queryVector.length === 0) {
+      return [];
+    }
 
     let candidates = [...this.#data.values()];
 
@@ -90,12 +96,12 @@ export class JsonVectorAdapter extends VectorStore {
 
     // 计算余弦相似度
     const scored = candidates
-      .filter(item => item.vector && item.vector.length > 0)
-      .map(item => ({
+      .filter((item) => item.vector && item.vector.length > 0)
+      .map((item) => ({
         item,
         score: this.#cosineSimilarity(queryVector, item.vector),
       }))
-      .filter(result => result.score >= minScore)
+      .filter((result) => result.score >= minScore)
       .sort((a, b) => b.score - a.score)
       .slice(0, topK);
 
@@ -109,35 +115,38 @@ export class JsonVectorAdapter extends VectorStore {
     const { topK = 10, filter = null } = options;
 
     let candidates = [...this.#data.values()];
-    if (filter) candidates = this.#applyFilter(candidates, filter);
+    if (filter) {
+      candidates = this.#applyFilter(candidates, filter);
+    }
 
-    const scored = candidates.map(item => {
-      // 向量分数
-      let vectorScore = 0;
-      if (queryVector && queryVector.length > 0 && item.vector && item.vector.length > 0) {
-        vectorScore = this.#cosineSimilarity(queryVector, item.vector);
-      }
+    const scored = candidates
+      .map((item) => {
+        // 向量分数
+        let vectorScore = 0;
+        if (queryVector && queryVector.length > 0 && item.vector && item.vector.length > 0) {
+          vectorScore = this.#cosineSimilarity(queryVector, item.vector);
+        }
 
-      // 关键词分数
-      let keywordScore = 0;
-      if (queryText) {
-        const text = (item.content || '').toLowerCase();
-        const query = queryText.toLowerCase();
-        const words = query.split(/\s+/);
-        const hits = words.filter(w => text.includes(w)).length;
-        keywordScore = words.length > 0 ? hits / words.length : 0;
-      }
+        // 关键词分数
+        let keywordScore = 0;
+        if (queryText) {
+          const text = (item.content || '').toLowerCase();
+          const query = queryText.toLowerCase();
+          const words = query.split(/\s+/);
+          const hits = words.filter((w) => text.includes(w)).length;
+          keywordScore = words.length > 0 ? hits / words.length : 0;
+        }
 
-      return {
-        item,
-        score: vectorScore * 0.7 + keywordScore * 0.3,
-        vectorScore,
-        keywordScore,
-      };
-    })
-    .filter(r => r.score > 0)
-    .sort((a, b) => b.score - a.score)
-    .slice(0, topK);
+        return {
+          item,
+          score: vectorScore * 0.7 + keywordScore * 0.3,
+          vectorScore,
+          keywordScore,
+        };
+      })
+      .filter((r) => r.score > 0)
+      .sort((a, b) => b.score - a.score)
+      .slice(0, topK);
 
     return scored;
   }
@@ -148,7 +157,7 @@ export class JsonVectorAdapter extends VectorStore {
    */
   async query(queryVector, topK = 10) {
     const results = await this.searchVector(queryVector, { topK });
-    return results.map(r => ({
+    return results.map((r) => ({
       id: r.item.id,
       similarity: r.score,
       score: r.score,
@@ -177,31 +186,47 @@ export class JsonVectorAdapter extends VectorStore {
       if (existsSync(this.#indexPath)) {
         indexSize = statSync(this.#indexPath).size;
       }
-    } catch { /* ignore */ }
+    } catch {
+      /* ignore */
+    }
 
     return {
       count: this.#data.size,
       indexSize,
       indexPath: this.#indexPath,
-      hasVectors: [...this.#data.values()].filter(d => d.vector?.length > 0).length,
+      hasVectors: [...this.#data.values()].filter((d) => d.vector?.length > 0).length,
     };
   }
 
   // --- 私有方法 ---
 
   #applyFilter(items, filter) {
-    return items.filter(item => {
+    return items.filter((item) => {
       const meta = item.metadata || {};
-      if (filter.type && meta.type !== filter.type) return false;
-      if (filter.category && meta.category !== filter.category) return false;
-      if (filter.language && meta.language !== filter.language) return false;
-      if (filter.sourcePath && !meta.sourcePath?.includes(filter.sourcePath)) return false;
-      if (filter.module && meta.module !== filter.module) return false;
+      if (filter.type && meta.type !== filter.type) {
+        return false;
+      }
+      if (filter.category && meta.category !== filter.category) {
+        return false;
+      }
+      if (filter.language && meta.language !== filter.language) {
+        return false;
+      }
+      if (filter.sourcePath && !meta.sourcePath?.includes(filter.sourcePath)) {
+        return false;
+      }
+      if (filter.module && meta.module !== filter.module) {
+        return false;
+      }
       if (filter.tags && Array.isArray(filter.tags)) {
         const itemTags = meta.tags || [];
-        if (!filter.tags.some(t => itemTags.includes(t))) return false;
+        if (!filter.tags.some((t) => itemTags.includes(t))) {
+          return false;
+        }
+      }
+      if (filter.deprecated === false && meta.deprecated) {
+        return false;
       }
-      if (filter.deprecated === false && meta.deprecated) return false;
       return true;
     });
   }
@@ -212,12 +237,16 @@ export class JsonVectorAdapter extends VectorStore {
 
   #load() {
     try {
-      if (!existsSync(this.#indexPath)) return;
+      if (!existsSync(this.#indexPath)) {
+        return;
+      }
       const raw = readFileSync(this.#indexPath, 'utf-8');
       const items = JSON.parse(raw);
       if (Array.isArray(items)) {
         for (const item of items) {
-          if (item?.id) this.#data.set(item.id, item);
+          if (item?.id) {
+            this.#data.set(item.id, item);
+          }
         }
       } else if (typeof items === 'object') {
         // 兼容旧格式 { id: item }
@@ -225,18 +254,26 @@ export class JsonVectorAdapter extends VectorStore {
           this.#data.set(id, { ...item, id });
         }
       }
-    } catch { /* silent: start empty */ }
+    } catch {
+      /* silent: start empty */
+    }
   }
 
   #autoSave() {
-    if (!this.#dirty) return;
+    if (!this.#dirty) {
+      return;
+    }
     try {
       const dir = dirname(this.#indexPath);
       pathGuard.assertProjectWriteSafe(dir);
-      if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+      if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+      }
       const items = [...this.#data.values()];
       writeFileSync(this.#indexPath, JSON.stringify(items, null, 2));
       this.#dirty = false;
-    } catch { /* silent */ }
+    } catch {
+      /* silent */
+    }
   }
 }

package/lib/infrastructure/vector/VectorStore.js

@@ -8,13 +8,17 @@ export class VectorStore {
    * 初始化存储
    * @returns {Promise<void>}
    */
-  async init() { throw new Error('Not implemented: init()'); }
+  async init() {
+    throw new Error('Not implemented: init()');
+  }
 
   /**
    * 插入或更新文档
    * @param {{ id: string, content: string, vector: number[], metadata: object }} item
    */
-  async upsert(item) { throw new Error('Not implemented: upsert()'); }
+  async upsert(item) {
+    throw new Error('Not implemented: upsert()');
+  }
 
   /**
    * 批量 upsert
@@ -25,7 +29,7 @@ export class VectorStore {
     const BATCH_SIZE = 50;
     for (let i = 0; i < items.length; i += BATCH_SIZE) {
       const batch = items.slice(i, i + BATCH_SIZE);
-      await Promise.all(batch.map(item => this.upsert(item)));
+      await Promise.all(batch.map((item) => this.upsert(item)));
     }
   }
 
@@ -33,14 +37,18 @@ export class VectorStore {
    * 删除文档
    * @param {string} id
    */
-  async remove(id) { throw new Error('Not implemented: remove()'); }
+  async remove(id) {
+    throw new Error('Not implemented: remove()');
+  }
 
   /**
    * 按 ID 获取
    * @param {string} id
    * @returns {object|null}
    */
-  async getById(id) { throw new Error('Not implemented: getById()'); }
+  async getById(id) {
+    throw new Error('Not implemented: getById()');
+  }
 
   /**
    * 向量相似度搜索
@@ -48,29 +56,39 @@ export class VectorStore {
    * @param {object} options — { topK, filter, minScore }
    * @returns {Array<{ item: object, score: number }>}
    */
-  async searchVector(queryVector, options = {}) { throw new Error('Not implemented: searchVector()'); }
+  async searchVector(queryVector, options = {}) {
+    throw new Error('Not implemented: searchVector()');
+  }
 
   /**
    * 按过滤条件搜索
    * @param {object} filter — { type, category, language, tags, ... }
    * @returns {Array}
    */
-  async searchByFilter(filter) { throw new Error('Not implemented: searchByFilter()'); }
+  async searchByFilter(filter) {
+    throw new Error('Not implemented: searchByFilter()');
+  }
 
   /**
    * 列出所有 ID
    * @returns {string[]}
    */
-  async listIds() { throw new Error('Not implemented: listIds()'); }
+  async listIds() {
+    throw new Error('Not implemented: listIds()');
+  }
 
   /**
    * 清空存储
    */
-  async clear() { throw new Error('Not implemented: clear()'); }
+  async clear() {
+    throw new Error('Not implemented: clear()');
+  }
 
   /**
    * 获取统计信息
    * @returns {{ count: number, indexSize: number }}
    */
-  async getStats() { throw new Error('Not implemented: getStats()'); }
+  async getStats() {
+    throw new Error('Not implemented: getStats()');
+  }
 }