autosnippet 3.0.11 → 3.1.0

package/lib/service/module/ModuleService.js

@@ -6,26 +6,69 @@
  * 语言特有操作（如 SPM 依赖管理）由对应的 Discoverer / Service 直接暴露，不经此类代理。
  */
 
-import { basename as _pathBasename, relative, join as _pathJoin, extname as _pathExtname, isAbsolute as _pathIsAbsolute } from 'node:path';
-import { readFileSync, existsSync, readdirSync, statSync } from 'node:fs';
-import Logger from '../../infrastructure/logging/Logger.js';
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import {
+  basename as _pathBasename,
+  extname as _pathExtname,
+  isAbsolute as _pathIsAbsolute,
+  join as _pathJoin,
+  relative,
+} from 'node:path';
 import { getDiscovererRegistry } from '../../core/discovery/index.js';
 import { inferLang } from '../../external/mcp/handlers/LanguageExtensions.js';
+import Logger from '../../infrastructure/logging/Logger.js';
 
 /** 全局排除目录 */
 const SCAN_EXCLUDE_DIRS = new Set([
-  'node_modules', '.git', 'dist', 'build', '.next', 'Pods',
-  'Carthage', '.build', 'DerivedData', 'vendor', '__pycache__',
-  '.venv', 'venv', 'target', '.gradle', '.idea', 'out', 'coverage',
-  '.cache', '.tox', '.mypy_cache', '.pytest_cache', 'AutoSnippet',
+  'node_modules',
+  '.git',
+  'dist',
+  'build',
+  '.next',
+  'Pods',
+  'Carthage',
+  '.build',
+  'DerivedData',
+  'vendor',
+  '__pycache__',
+  '.venv',
+  'venv',
+  'target',
+  '.gradle',
+  '.idea',
+  'out',
+  'coverage',
+  '.cache',
+  '.tox',
+  '.mypy_cache',
+  '.pytest_cache',
+  'AutoSnippet',
 ]);
 
 /** 源码文件扩展名 */
 const SOURCE_CODE_EXTS = new Set([
-  '.swift', '.m', '.mm', '.h',
-  '.js', '.ts', '.tsx', '.jsx', '.mjs', '.cjs',
-  '.py', '.java', '.kt', '.kts', '.go', '.rs', '.rb',
-  '.vue', '.svelte', '.c', '.cpp', '.cs',
+  '.swift',
+  '.m',
+  '.mm',
+  '.h',
+  '.js',
+  '.ts',
+  '.tsx',
+  '.jsx',
+  '.mjs',
+  '.cjs',
+  '.py',
+  '.java',
+  '.kt',
+  '.kts',
+  '.go',
+  '.rs',
+  '.rb',
+  '.vue',
+  '.svelte',
+  '.c',
+  '.cpp',
+  '.cs',
 ]);
 
 export class ModuleService {
@@ -82,7 +125,9 @@ export class ModuleService {
    * 自动检测项目类型并加载所有匹配的 Discoverer
    */
   async load() {
-    if (this.#loaded) return;
+    if (this.#loaded) {
+      return;
+    }
 
     const matches = await this.#registry.detectAll(this.#projectRoot);
     this.#activeDiscoverers = [];
@@ -143,12 +188,16 @@ export class ModuleService {
 
     // 第一遍：加载非 generic 的 Discoverer（真实项目结构识别器）
     for (const { discoverer } of this.#activeDiscoverers) {
-      if (discoverer.id === 'generic') continue;
+      if (discoverer.id === 'generic') {
+        continue;
+      }
       try {
         const targets = await discoverer.listTargets();
         for (const t of targets) {
           const key = `${discoverer.id}::${t.name}`;
-          if (seenNames.has(key)) continue;
+          if (seenNames.has(key)) {
+            continue;
+          }
           seenNames.add(key);
           allTargets.push(this.#normalizeTarget(t, discoverer));
           hasRealDiscovererTargets = true;
@@ -163,12 +212,16 @@ export class ModuleService {
     // 第二遍：仅当没有真实 Discoverer 产出 target 时，才加载 GenericDiscoverer 的结果（兜底）
     if (!hasRealDiscovererTargets) {
       for (const { discoverer } of this.#activeDiscoverers) {
-        if (discoverer.id !== 'generic') continue;
+        if (discoverer.id !== 'generic') {
+          continue;
+        }
         try {
           const targets = await discoverer.listTargets();
           for (const t of targets) {
             const key = `${discoverer.id}::${t.name}`;
-            if (seenNames.has(key)) continue;
+            if (seenNames.has(key)) {
+              continue;
+            }
             seenNames.add(key);
             allTargets.push(this.#normalizeTarget(t, discoverer));
           }
@@ -235,14 +288,14 @@ export class ModuleService {
         if (targets.some((t) => t.name === targetObj.name)) {
           return discoverer.getTargetFiles(targetObj);
         }
-      } catch {
-        continue;
-      }
+      } catch {}
     }
 
     // 兜底：如果 target 有 path 属性且目录存在，直接收集
     if (targetObj.path && existsSync(targetObj.path)) {
-      this.#logger.info(`[ModuleService] getTargetFiles fallback: collecting from ${targetObj.path}`);
+      this.#logger.info(
+        `[ModuleService] getTargetFiles fallback: collecting from ${targetObj.path}`
+      );
       return this.#collectFolderFiles(targetObj.path);
     }
 
@@ -313,6 +366,7 @@ export class ModuleService {
 
     return {
       projectRoot: this.#projectRoot,
+      projectName: _pathBasename(this.#projectRoot) || '',
       primaryLanguage: primaryDiscoverer
         ? this.#discovererToLanguage(primaryDiscoverer.id)
         : 'unknown',
@@ -458,7 +512,9 @@ export class ModuleService {
           const fileList = await this.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);
             try {
               const content = readFileSync(fp, 'utf8');
@@ -469,19 +525,27 @@ export class ModuleService {
                 content,
                 targetName: t.name,
               });
-            } catch { /* unreadable */ }
-            if (allFiles.length >= MAX_FILES) break;
+            } catch {
+              /* unreadable */
+            }
+            if (allFiles.length >= MAX_FILES) {
+              break;
+            }
           }
         } catch (e) {
           this.#logger.warn(`[ModuleService] scanProject: skipping module ${t.name}: ${e.message}`);
         }
-        if (allFiles.length >= MAX_FILES) break;
+        if (allFiles.length >= MAX_FILES) {
+          break;
+        }
       }
     }
 
     // 如果没有 target 收集到文件，回退到目录扫描
     if (allFiles.length === 0) {
-      this.#logger.info('[ModuleService] scanProject: No module targets, falling back to directory scan');
+      this.#logger.info(
+        '[ModuleService] scanProject: No module targets, falling back to directory scan'
+      );
       this.#walkProjectForFiles(allFiles, seenPaths, MAX_FILES);
     }
 
@@ -610,9 +674,7 @@ export class ModuleService {
    * @returns {Promise<Array<{ name: string, path: string, depth: number, language: string, sourceFileCount: number, hasSourceFiles: boolean }>>}
    */
   async browseDirectories(basePath = '', maxDepth = 2) {
-    const root = basePath
-      ? _pathJoin(this.#projectRoot, basePath)
-      : this.#projectRoot;
+    const root = basePath ? _pathJoin(this.#projectRoot, basePath) : this.#projectRoot;
 
     if (!existsSync(root)) {
       return [];
@@ -726,7 +788,9 @@ export class ModuleService {
           createProvider,
         } = this.#aiFactory;
         let ai = await getProviderWithFallback();
-        if (!ai) return [];
+        if (!ai) {
+          return [];
+        }
 
         // 加载语言参考 Skill
         let extractOpts = {};
@@ -740,7 +804,9 @@ export class ModuleService {
               extractOpts = { skillReference: skillCtx.languageSkill.substring(0, 2000) };
             }
           }
-        } catch { /* Skills not available */ }
+        } catch {
+          /* Skills not available */
+        }
 
         try {
           return await ai.extractRecipes(targetName, files, extractOpts);
@@ -797,13 +863,21 @@ export class ModuleService {
    * 目录遍历 — 浏览子目录结构
    */
   #walkDirsForBrowse(dir, dirs, depth, maxDepth) {
-    if (depth >= maxDepth) return;
+    if (depth >= maxDepth) {
+      return;
+    }
     try {
       const entries = readdirSync(dir, { withFileTypes: true });
       for (const entry of entries) {
-        if (!entry.isDirectory()) continue;
-        if (entry.name.startsWith('.')) continue;
-        if (SCAN_EXCLUDE_DIRS.has(entry.name)) continue;
+        if (!entry.isDirectory()) {
+          continue;
+        }
+        if (entry.name.startsWith('.')) {
+          continue;
+        }
+        if (SCAN_EXCLUDE_DIRS.has(entry.name)) {
+          continue;
+        }
 
         const fullPath = _pathJoin(dir, entry.name);
         const relativePath = relative(this.#projectRoot, fullPath);
@@ -825,14 +899,18 @@ export class ModuleService {
 
         this.#walkDirsForBrowse(fullPath, dirs, depth + 1, maxDepth);
       }
-    } catch { /* skip */ }
+    } catch {
+      /* skip */
+    }
   }
 
   /**
    * 递归统计目录下源码文件数（限深度 + 上限 999 防止超大目录卡顿）
    */
   #countSourceFilesDeep(dir, maxDepth, depth = 0) {
-    if (depth >= maxDepth) return 0;
+    if (depth >= maxDepth) {
+      return 0;
+    }
     let count = 0;
     try {
       const entries = readdirSync(dir, { withFileTypes: true });
@@ -842,9 +920,13 @@ export class ModuleService {
         } else if (e.isDirectory() && !e.name.startsWith('.') && !SCAN_EXCLUDE_DIRS.has(e.name)) {
           count += this.#countSourceFilesDeep(_pathJoin(dir, e.name), maxDepth, depth + 1);
         }
-        if (count >= 999) return count;
+        if (count >= 999) {
+          return count;
+        }
       }
-    } catch { /* skip */ }
+    } catch {
+      /* skip */
+    }
     return count;
   }
 
@@ -861,12 +943,18 @@ export class ModuleService {
    * 递归收集源码文件
    */
   #walkCollectSourceFiles(dir, rootDir, files, depth, maxDepth) {
-    if (depth > maxDepth || files.length > 500) return;
+    if (depth > maxDepth || files.length > 500) {
+      return;
+    }
     try {
       const entries = readdirSync(dir, { withFileTypes: true });
       for (const entry of entries) {
-        if (entry.name.startsWith('.')) continue;
-        if (SCAN_EXCLUDE_DIRS.has(entry.name)) continue;
+        if (entry.name.startsWith('.')) {
+          continue;
+        }
+        if (SCAN_EXCLUDE_DIRS.has(entry.name)) {
+          continue;
+        }
 
         const fullPath = _pathJoin(dir, entry.name);
         if (entry.isDirectory()) {
@@ -883,7 +971,9 @@ export class ModuleService {
           }
         }
       }
-    } catch { /* skip */ }
+    } catch {
+      /* skip */
+    }
   }
 
   /**
@@ -894,15 +984,21 @@ export class ModuleService {
     try {
       const entries = readdirSync(dirPath, { withFileTypes: true });
       for (const entry of entries) {
-        if (!entry.isFile()) continue;
+        if (!entry.isFile()) {
+          continue;
+        }
         const ext = _pathExtname(entry.name).toLowerCase();
-        if (!SOURCE_CODE_EXTS.has(ext)) continue;
+        if (!SOURCE_CODE_EXTS.has(ext)) {
+          continue;
+        }
         const lang = inferLang(entry.name);
         if (lang) {
           langCount[lang] = (langCount[lang] || 0) + 1;
         }
       }
-    } catch { /* skip */ }
+    } catch {
+      /* skip */
+    }
 
     let maxLang = 'unknown';
     let maxCount = 0;
@@ -920,29 +1016,56 @@ export class ModuleService {
    */
   #walkProjectForFiles(allFiles, seenPaths, maxFiles) {
     const srcDirs = [
-      'Sources', 'src', 'lib', 'app', 'pages', 'components', 'modules', 'packages',
-      'cmd', 'internal', 'pkg',
+      'Sources',
+      'src',
+      'lib',
+      'app',
+      'pages',
+      'components',
+      'modules',
+      'packages',
+      'cmd',
+      'internal',
+      'pkg',
     ];
 
     const walkDir = (dir, targetName) => {
-      if (allFiles.length >= maxFiles) return;
+      if (allFiles.length >= maxFiles) {
+        return;
+      }
       let entries;
-      try { entries = readdirSync(dir, { withFileTypes: true }); } catch { return; }
+      try {
+        entries = readdirSync(dir, { withFileTypes: true });
+      } catch {
+        return;
+      }
       for (const ent of entries) {
-        if (allFiles.length >= maxFiles) break;
-        if (ent.name.startsWith('.')) continue;
+        if (allFiles.length >= maxFiles) {
+          break;
+        }
+        if (ent.name.startsWith('.')) {
+          continue;
+        }
         const fp = _pathJoin(dir, ent.name);
         if (ent.isDirectory()) {
-          if (SCAN_EXCLUDE_DIRS.has(ent.name)) continue;
+          if (SCAN_EXCLUDE_DIRS.has(ent.name)) {
+            continue;
+          }
           walkDir(fp, targetName);
         } else if (ent.isFile() && SOURCE_CODE_EXTS.has(_pathExtname(ent.name).toLowerCase())) {
-          if (seenPaths.has(fp)) continue;
+          if (seenPaths.has(fp)) {
+            continue;
+          }
           seenPaths.add(fp);
           try {
             const st = statSync(fp);
-            if (st.size > 512 * 1024) continue;
+            if (st.size > 512 * 1024) {
+              continue;
+            }
             const content = readFileSync(fp, 'utf8');
-            if (content.split('\n').length < 5) continue;
+            if (content.split('\n').length < 5) {
+              continue;
+            }
             allFiles.push({
               name: ent.name,
               path: fp,
@@ -950,7 +1073,9 @@ export class ModuleService {
               content,
               targetName,
             });
-          } catch { /* unreadable */ }
+          } catch {
+            /* unreadable */
+          }
         }
       }
     };

package/lib/service/recipe/RecipeCandidateValidator.js

@@ -9,17 +9,18 @@ import { LanguageService } from '../../shared/LanguageService.js';
 
 /* ── V3 必填字段 ── */
 const REQUIRED_FIELDS = [
-  'title',       // 中文简短标题
-  'trigger',     // @前缀 kebab-case
-  'category',    // View/Service/Tool/Model/Network/Storage/UI/Utility
-  'language',    // 编程语言标识
-  'kind',        // rule / pattern / fact
-  'doClause',    // 英文祈使句正向指令
+  'title', // 中文简短标题
+  'trigger', // @前缀 kebab-case
+  'category', // View/Service/Tool/Model/Network/Storage/UI/Utility
+  'language', // 编程语言标识
+  'kind', // rule / pattern / fact
+  'doClause', // 英文祈使句正向指令
   'description', // 中文简述 ≤80字
 ];
 
 /* ── 需要 content 子对象有内容 ── */
-const REQUIRED_CONTENT_FIELDS = ['pattern', 'markdown', 'rationale'];
+// NOTE: reserved for future content sub-field validation
+// const REQUIRED_CONTENT_FIELDS = ['pattern', 'markdown', 'rationale'];
 
 const VALID_CATEGORIES = new Set([
   'view',
@@ -94,7 +95,9 @@ export class RecipeCandidateValidator {
 
     // ── category 合法性 ──
     if (candidate.category && !VALID_CATEGORIES.has(candidate.category.toLowerCase())) {
-      warnings.push(`category "${candidate.category}" 不在标准列表（View/Service/Tool/Model/Network/Storage/UI/Utility）`);
+      warnings.push(
+        `category "${candidate.category}" 不在标准列表（View/Service/Tool/Model/Network/Storage/UI/Utility）`
+      );
     }
 
     // ── language 合法性 ──

package/lib/service/search/SearchEngine.js

@@ -659,7 +659,7 @@ export class SearchEngine {
   }
 
   /**
-   * 补充详细字段（content / description / trigger）— 批量 IN 查询
+   * 补充详细字段（content / description / trigger / delivery 字段）— 批量 IN 查询
    * 用于向量搜索结果与 BM25 结果的一致性
    */
   _supplementDetails(items) {
@@ -674,7 +674,8 @@ export class SearchEngine {
         rows = this.db
           .prepare(
             `SELECT id, content, description, trigger, headers, moduleName,
-                  tags, language, category, updatedAt, createdAt, quality, stats, difficulty
+                  tags, language, category, updatedAt, createdAt, quality, stats, difficulty,
+                  whenClause, doClause
            FROM knowledge_entries WHERE id IN (${placeholders})`
           )
           .all(...ids);
@@ -694,6 +695,13 @@ export class SearchEngine {
           if (row.moduleName) {
             item.moduleName = row.moduleName;
           }
+          // Cursor 交付字段 — 供 Agent 投影生成 actionHint
+          if (!item.whenClause && row.whenClause) {
+            item.whenClause = row.whenClause;
+          }
+          if (!item.doClause && row.doClause) {
+            item.doClause = row.doClause;
+          }
           // 排序信号补充 — 确保 Funnel/Ranker 有真实数据
           if (!item.language && row.language) {
             item.language = row.language;

package/lib/service/snippet/SnippetFactory.js

@@ -11,8 +11,6 @@
  *   factory.generate(spec, 'xcode')  — 按 target 生成
  */
 
-import { XcodeCodec } from './codecs/XcodeCodec.js';
-
 export class SnippetFactory {
   /** @type {Map<string, import('./codecs/SnippetCodec.js').SnippetCodec>} */
   #codecs = new Map();
@@ -174,7 +172,9 @@ export class SnippetFactory {
   #resolveCodec(target) {
     const codec = this.#codecs.get(target);
     if (!codec) {
-      throw new Error(`No codec registered for target "${target}". Available: [${this.getRegisteredTargets().join(', ')}]`);
+      throw new Error(
+        `No codec registered for target "${target}". Available: [${this.getRegisteredTargets().join(', ')}]`
+      );
     }
     return codec;
   }

package/lib/service/snippet/SnippetInstaller.js

@@ -8,7 +8,14 @@
  * 行为由注入的 SnippetCodec 决定。
  */
 
-import { existsSync, mkdirSync, readdirSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
+import {
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  unlinkSync,
+  writeFileSync,
+} from 'node:fs';
 import { join } from 'node:path';
 
 export class SnippetInstaller {
@@ -106,8 +113,11 @@ export class SnippetInstaller {
     for (const spec of specs) {
       const result = this.install(spec, projectRoot);
       details.push(result);
-      if (result.success) successCount++;
-      else errorCount++;
+      if (result.success) {
+        successCount++;
+      } else {
+        errorCount++;
+      }
     }
 
     return { success: errorCount === 0, count: recipes.length, successCount, errorCount, details };
@@ -122,13 +132,17 @@ export class SnippetInstaller {
    */
   listInstalled(projectRoot) {
     const dir = this.#resolveDir(projectRoot);
-    if (!existsSync(dir)) return [];
+    if (!existsSync(dir)) {
+      return [];
+    }
 
     const bundleFilename = this.#codec?.getBundleFilename();
     if (bundleFilename) {
       // VSCode: 检查 bundle 文件是否存在
       const bundlePath = join(dir, bundleFilename);
-      if (!existsSync(bundlePath)) return [];
+      if (!existsSync(bundlePath)) {
+        return [];
+      }
       try {
         const content = JSON.parse(readFileSync(bundlePath, 'utf-8'));
         return Object.keys(content).map((key) => ({
@@ -142,7 +156,11 @@ export class SnippetInstaller {
 
     // Xcode: 列出 com.autosnippet.*.codesnippet 文件
     return readdirSync(dir)
-      .filter((f) => f.startsWith('com.autosnippet.') && f.endsWith(this.#codec?.fileExtension || '.codesnippet'))
+      .filter(
+        (f) =>
+          f.startsWith('com.autosnippet.') &&
+          f.endsWith(this.#codec?.fileExtension || '.codesnippet')
+      )
       .map((f) => ({ filename: f, path: join(dir, f) }));
   }
 
@@ -210,15 +228,21 @@ export class SnippetInstaller {
   // ─────────────── Private ───────────────
 
   #assertCodec() {
-    if (!this.#codec) throw new Error('SnippetCodec not set');
+    if (!this.#codec) {
+      throw new Error('SnippetCodec not set');
+    }
   }
 
   #assertFactory() {
-    if (!this.#snippetFactory) throw new Error('SnippetFactory not set');
+    if (!this.#snippetFactory) {
+      throw new Error('SnippetFactory not set');
+    }
   }
 
   #resolveDir(projectRoot) {
-    if (this.#snippetsDirOverride) return this.#snippetsDirOverride;
+    if (this.#snippetsDirOverride) {
+      return this.#snippetsDirOverride;
+    }
     return this.#codec?.getInstallDir(projectRoot || process.cwd()) || '';
   }
 
@@ -247,7 +271,7 @@ export class SnippetInstaller {
     const entryKey = Object.keys(content)[0];
     bundle[key] = content[entryKey];
 
-    writeFileSync(bundlePath, JSON.stringify(bundle, null, 2) + '\n');
+    writeFileSync(bundlePath, `${JSON.stringify(bundle, null, 2)}\n`);
     return { success: true, path: bundlePath, message: `Installed: ${key}` };
   }
 
@@ -296,7 +320,7 @@ export class SnippetInstaller {
         return { success: false, message: `Snippet not found in bundle: ${identifier}` };
       }
       delete bundle[keyToRemove];
-      writeFileSync(bundlePath, JSON.stringify(bundle, null, 2) + '\n');
+      writeFileSync(bundlePath, `${JSON.stringify(bundle, null, 2)}\n`);
       return { success: true, message: `Uninstalled: ${keyToRemove}` };
     } catch (error) {
       return { success: false, message: error.message };

package/lib/service/snippet/codecs/VSCodeCodec.js

@@ -9,8 +9,8 @@
  */
 
 import { join } from 'node:path';
-import { SnippetCodec } from './SnippetCodec.js';
 import { PlaceholderConverter } from '../PlaceholderConverter.js';
+import { SnippetCodec } from './SnippetCodec.js';
 
 /** AutoSnippet language → VSCode snippet scope */
 const VSCODE_LANGUAGE_MAP = {
@@ -58,7 +58,7 @@ export class VSCodeCodec extends SnippetCodec {
       const key = `Recipe: ${spec.title || spec.identifier}`;
       bundle[key] = this.#specToEntry(spec);
     }
-    return JSON.stringify(bundle, null, 2) + '\n';
+    return `${JSON.stringify(bundle, null, 2)}\n`;
   }
 
   /**