autosnippet 3.0.13 → 3.1.1

package/lib/service/wiki/WikiUtils.js

@@ -8,8 +8,8 @@
 
 import fs from 'node:fs';
 import path from 'node:path';
-import { LanguageService } from '../../shared/LanguageService.js';
 import Logger from '../../infrastructure/logging/Logger.js';
+import { LanguageService } from '../../shared/LanguageService.js';
 
 const logger = Logger.getInstance();
 
@@ -131,12 +131,10 @@ export function inferModuleFromPath(filePath) {
   // Java/Kotlin: src/main/java/{pkg}/... → 跳过域名前缀，取最后一个有意义的包目录
   //   例: src/main/java/org/springframework/samples/petclinic/vet/Vet.java → "vet"
   //   例: src/main/java/com/example/demo/DemoApp.java → "demo"
-  const JAVA_DOMAIN_PREFIXES = new Set(['com', 'org', 'net', 'io', 'de', 'fr', 'jp', 'cn', 'uk', 'us', 'edu', 'gov']);
   for (const langDir of ['java', 'kotlin']) {
     const langIdx = parts.indexOf(langDir);
     if (langIdx >= 0 && langIdx + 1 < parts.length) {
       // 文件名所在目录（倒数第二个 part）才是 "模块"
-      const fileName = parts[parts.length - 1];
       const pkgParts = parts.slice(langIdx + 1, parts.length - 1); // 包路径（不含文件名）
       if (pkgParts.length >= 2) {
         // 从尾部取: 最后一个包段即为功能模块
@@ -294,8 +292,7 @@ export function getInheritanceRoots(codeEntityGraph) {
   }
   try {
     // 尝试查询继承关系
-    const entities =
-      codeEntityGraph.queryEntities?.({ entityType: 'class', limit: 50 }) || [];
+    const entities = codeEntityGraph.queryEntities?.({ entityType: 'class', limit: 50 }) || [];
     const roots = [];
     for (const e of entities) {
       const _parents =
@@ -341,9 +338,7 @@ export function dedup(files, wikiDir, emit) {
           /* skip */
         }
         removed.push(file.path);
-        logger.info(
-          `[WikiGenerator] Dedup: removed ${file.path} (same hash as ${existing.path})`
-        );
+        logger.info(`[WikiGenerator] Dedup: removed ${file.path} (same hash as ${existing.path})`);
       }
       // hash 不同 → 保留两个（不同目录允许同名）
     } else {
@@ -361,8 +356,7 @@ export function dedup(files, wikiDir, emit) {
       const firstPath = hashMap.get(file.hash);
       // 优先保留代码生成的（非 synced）
       const isFirstSynced = firstPath.startsWith('documents/') || firstPath.startsWith('skills/');
-      const isCurrentSynced =
-        file.path.startsWith('documents/') || file.path.startsWith('skills/');
+      const isCurrentSynced = file.path.startsWith('documents/') || file.path.startsWith('skills/');
 
       if (isCurrentSynced && !isFirstSynced) {
         // 当前是 synced，first 是 codegen → 删除 synced
@@ -411,19 +405,69 @@ export function dedup(files, wikiDir, emit) {
  */
 export function getLangTerms(langId) {
   const TERMS = {
-    swift:      { typeLabel: { zh: '类/结构体', en: 'Classes/Structs' },     interfaceLabel: { zh: '协议', en: 'Protocols' },       moduleMetric: { zh: 'SPM Targets', en: 'SPM Targets' } },
-    objectivec: { typeLabel: { zh: '类',       en: 'Classes' },             interfaceLabel: { zh: '协议', en: 'Protocols' },       moduleMetric: { zh: 'Targets', en: 'Targets' } },
-    typescript: { typeLabel: { zh: '类',       en: 'Classes' },             interfaceLabel: { zh: '接口', en: 'Interfaces' },      moduleMetric: { zh: 'Packages', en: 'Packages' } },
-    javascript: { typeLabel: { zh: '类/模块',   en: 'Classes/Modules' },     interfaceLabel: { zh: '接口', en: 'Interfaces' },      moduleMetric: { zh: 'Packages', en: 'Packages' } },
-    python:     { typeLabel: { zh: '类',       en: 'Classes' },             interfaceLabel: { zh: '抽象基类', en: 'Abstract Base' }, moduleMetric: { zh: 'Packages', en: 'Packages' } },
-    go:         { typeLabel: { zh: '结构体',    en: 'Structs' },             interfaceLabel: { zh: '接口', en: 'Interfaces' },      moduleMetric: { zh: 'Go Modules', en: 'Go Modules' } },
-    rust:       { typeLabel: { zh: '结构体/枚举', en: 'Structs/Enums' },      interfaceLabel: { zh: 'Trait', en: 'Traits' },        moduleMetric: { zh: 'Crates', en: 'Crates' } },
-    java:       { typeLabel: { zh: '类',       en: 'Classes' },             interfaceLabel: { zh: '接口', en: 'Interfaces' },      moduleMetric: { zh: 'Modules', en: 'Modules' } },
-    kotlin:     { typeLabel: { zh: '类',       en: 'Classes' },             interfaceLabel: { zh: '接口', en: 'Interfaces' },      moduleMetric: { zh: 'Modules', en: 'Modules' } },
-    dart:       { typeLabel: { zh: '类',       en: 'Classes' },             interfaceLabel: { zh: '抽象类', en: 'Abstract Classes' }, moduleMetric: { zh: 'Packages', en: 'Packages' } },
-    csharp:     { typeLabel: { zh: '类',       en: 'Classes' },             interfaceLabel: { zh: '接口', en: 'Interfaces' },      moduleMetric: { zh: 'Projects', en: 'Projects' } },
+    swift: {
+      typeLabel: { zh: '类/结构体', en: 'Classes/Structs' },
+      interfaceLabel: { zh: '协议', en: 'Protocols' },
+      moduleMetric: { zh: 'SPM Targets', en: 'SPM Targets' },
+    },
+    objectivec: {
+      typeLabel: { zh: '类', en: 'Classes' },
+      interfaceLabel: { zh: '协议', en: 'Protocols' },
+      moduleMetric: { zh: 'Targets', en: 'Targets' },
+    },
+    typescript: {
+      typeLabel: { zh: '类', en: 'Classes' },
+      interfaceLabel: { zh: '接口', en: 'Interfaces' },
+      moduleMetric: { zh: 'Packages', en: 'Packages' },
+    },
+    javascript: {
+      typeLabel: { zh: '类/模块', en: 'Classes/Modules' },
+      interfaceLabel: { zh: '接口', en: 'Interfaces' },
+      moduleMetric: { zh: 'Packages', en: 'Packages' },
+    },
+    python: {
+      typeLabel: { zh: '类', en: 'Classes' },
+      interfaceLabel: { zh: '抽象基类', en: 'Abstract Base' },
+      moduleMetric: { zh: 'Packages', en: 'Packages' },
+    },
+    go: {
+      typeLabel: { zh: '结构体', en: 'Structs' },
+      interfaceLabel: { zh: '接口', en: 'Interfaces' },
+      moduleMetric: { zh: 'Go Modules', en: 'Go Modules' },
+    },
+    rust: {
+      typeLabel: { zh: '结构体/枚举', en: 'Structs/Enums' },
+      interfaceLabel: { zh: 'Trait', en: 'Traits' },
+      moduleMetric: { zh: 'Crates', en: 'Crates' },
+    },
+    java: {
+      typeLabel: { zh: '类', en: 'Classes' },
+      interfaceLabel: { zh: '接口', en: 'Interfaces' },
+      moduleMetric: { zh: 'Modules', en: 'Modules' },
+    },
+    kotlin: {
+      typeLabel: { zh: '类', en: 'Classes' },
+      interfaceLabel: { zh: '接口', en: 'Interfaces' },
+      moduleMetric: { zh: 'Modules', en: 'Modules' },
+    },
+    dart: {
+      typeLabel: { zh: '类', en: 'Classes' },
+      interfaceLabel: { zh: '抽象类', en: 'Abstract Classes' },
+      moduleMetric: { zh: 'Packages', en: 'Packages' },
+    },
+    csharp: {
+      typeLabel: { zh: '类', en: 'Classes' },
+      interfaceLabel: { zh: '接口', en: 'Interfaces' },
+      moduleMetric: { zh: 'Projects', en: 'Projects' },
+    },
   };
-  return TERMS[langId] || { typeLabel: { zh: '类型', en: 'Types' }, interfaceLabel: { zh: '接口', en: 'Interfaces' }, moduleMetric: { zh: 'Modules', en: 'Modules' } };
+  return (
+    TERMS[langId] || {
+      typeLabel: { zh: '类型', en: 'Types' },
+      interfaceLabel: { zh: '接口', en: 'Interfaces' },
+      moduleMetric: { zh: 'Modules', en: 'Modules' },
+    }
+  );
 }
 
 /**
@@ -456,11 +500,13 @@ export function detectBuildSystems(rootEntryNames, projectRoot) {
     try {
       const entries = fs.readdirSync(projectRoot, { withFileTypes: true });
       for (const dir of entries) {
-        if (!dir.isDirectory() || dir.name.startsWith('.') || skipDirs.has(dir.name)) continue;
+        if (!dir.isDirectory() || dir.name.startsWith('.') || skipDirs.has(dir.name)) {
+          continue;
+        }
         try {
-          const subEntries = fs.readdirSync(path.join(projectRoot, dir.name)).filter(
-            (n) => !n.startsWith('.')
-          );
+          const subEntries = fs
+            .readdirSync(path.join(projectRoot, dir.name))
+            .filter((n) => !n.startsWith('.'));
           const subResults = LanguageService.matchBuildMarkers(subEntries);
           for (const r of subResults) {
             if (!seenEco.has(r.eco)) {
@@ -468,9 +514,13 @@ export function detectBuildSystems(rootEntryNames, projectRoot) {
               seenEco.add(r.eco);
             }
           }
-        } catch { /* skip unreadable subdirs */ }
+        } catch {
+          /* skip unreadable subdirs */
+        }
       }
-    } catch { /* skip */ }
+    } catch {
+      /* skip */
+    }
   }
 
   return results;
@@ -498,12 +548,29 @@ export function detectBuildSystems(rootEntryNames, projectRoot) {
 
 /** 入口文件名模式 */
 const ENTRY_POINT_NAMES = new Set([
-  'index.js', 'index.ts', 'index.tsx', 'index.jsx', 'index.mjs',
-  'main.js', 'main.ts', 'main.go', 'main.py', 'main.rs', 'main.dart', 'main.c', 'main.cpp',
-  'mod.rs', 'lib.rs',
+  'index.js',
+  'index.ts',
+  'index.tsx',
+  'index.jsx',
+  'index.mjs',
+  'main.js',
+  'main.ts',
+  'main.go',
+  'main.py',
+  'main.rs',
+  'main.dart',
+  'main.c',
+  'main.cpp',
+  'mod.rs',
+  'lib.rs',
   '__init__.py',
-  'app.js', 'app.ts', 'app.py', 'app.rb',
-  'server.js', 'server.ts', 'server.py',
+  'app.js',
+  'app.ts',
+  'app.py',
+  'app.rb',
+  'server.js',
+  'server.ts',
+  'server.py',
 ]);
 
 /** 多语言 import/require 正则 (轻量级, 不依赖 AST) */
@@ -540,11 +607,7 @@ const IMPORT_PATTERNS = [
  * @returns {FolderProfile[]}
  */
 export function profileFolders(projectInfo, options = {}) {
-  const {
-    minFiles = 3,
-    maxFolders = 20,
-    sampleLines = 40,
-  } = options;
+  const { minFiles = 3, maxFolders = 20, sampleLines = 40 } = options;
 
   const root = projectInfo.root;
   const sourceFiles = projectInfo.sourceFiles || [];
@@ -578,12 +641,18 @@ export function profileFolders(projectInfo, options = {}) {
   // ── 3. 筛选重要文件夹 ──
   const candidates = [];
   for (const [dir, files] of folderRecursive) {
-    if (files.length < minFiles) continue;
+    if (files.length < minFiles) {
+      continue;
+    }
     // 排除根目录 '.'
-    if (dir === '.') continue;
+    if (dir === '.') {
+      continue;
+    }
     // 排除太深的目录 (depth > 4), 这些通常是叶子目录, 信息量低
     const depth = dir.split('/').length;
-    if (depth > 4) continue;
+    if (depth > 4) {
+      continue;
+    }
 
     candidates.push({ dir, files, depth });
   }
@@ -607,7 +676,9 @@ export function profileFolders(projectInfo, options = {}) {
 
   // 按 fileCount 降序 + depth 升序 排序
   profiles.sort((a, b) => {
-    if (b.fileCount !== a.fileCount) return b.fileCount - a.fileCount;
+    if (b.fileCount !== a.fileCount) {
+      return b.fileCount - a.fileCount;
+    }
     return a.depth - b.depth;
   });
 
@@ -623,18 +694,20 @@ function _pruneRedundantFolders(candidates, maxFolders) {
   const removedDirs = new Set();
 
   for (const c of candidates) {
-    if (removedDirs.has(c.dir)) continue;
+    if (removedDirs.has(c.dir)) {
+      continue;
+    }
 
     // 检查是否有已 kept 的父目录, 且文件比率 > 80%
     let isRedundant = false;
     for (const k of kept) {
-      if (c.dir.startsWith(k.dir + '/')) {
+      if (c.dir.startsWith(`${k.dir}/`)) {
         // c 是 k 的子目录
         if (c.files.length / k.files.length > 0.8) {
           isRedundant = true;
           break;
         }
-      } else if (k.dir.startsWith(c.dir + '/')) {
+      } else if (k.dir.startsWith(`${c.dir}/`)) {
         // c 是 k 的父目录, k 覆盖了 c 大部分 → 保留 c (更高层), 移除 k
         if (k.files.length / c.files.length > 0.8) {
           removedDirs.add(k.dir);
@@ -646,10 +719,12 @@ function _pruneRedundantFolders(candidates, maxFolders) {
       kept.push(c);
     }
 
-    if (kept.length >= maxFolders) break;
+    if (kept.length >= maxFolders) {
+      break;
+    }
   }
 
-  return kept.filter(c => !removedDirs.has(c.dir));
+  return kept.filter((c) => !removedDirs.has(c.dir));
 }
 
 /**
@@ -670,14 +745,16 @@ function _buildFolderProfile(relDir, files, depth, projectRoot, sampleLines) {
     try {
       const stat = fs.statSync(path.join(projectRoot, f));
       totalSize += stat.size;
-    } catch { /* skip */ }
+    } catch {
+      /* skip */
+    }
   }
 
   // ── 文件名列表 ──
-  const fileNames = files.map(f => path.basename(f)).sort();
+  const fileNames = files.map((f) => path.basename(f)).sort();
 
   // ── 入口点检测 ──
-  const entryPoints = files.filter(f => ENTRY_POINT_NAMES.has(path.basename(f).toLowerCase()));
+  const entryPoints = files.filter((f) => ENTRY_POINT_NAMES.has(path.basename(f).toLowerCase()));
 
   // ── 重要文件 (大文件 top5 + 入口文件) ──
   const fileSizes = [];
@@ -685,15 +762,12 @@ function _buildFolderProfile(relDir, files, depth, projectRoot, sampleLines) {
     try {
       const stat = fs.statSync(path.join(projectRoot, f));
       fileSizes.push({ file: f, size: stat.size });
-    } catch { /* skip */ }
+    } catch {
+      /* skip */
+    }
   }
   fileSizes.sort((a, b) => b.size - a.size);
-  const keyFiles = [
-    ...new Set([
-      ...entryPoints,
-      ...fileSizes.slice(0, 5).map(fs => fs.file),
-    ]),
-  ];
+  const keyFiles = [...new Set([...entryPoints, ...fileSizes.slice(0, 5).map((fs) => fs.file)])];
 
   // ── README 检测 ──
   let readme = null;
@@ -706,7 +780,9 @@ function _buildFolderProfile(relDir, files, depth, projectRoot, sampleLines) {
         readme = content.slice(0, 1000); // 只取前 1000 字符
         break;
       }
-    } catch { /* skip */ }
+    } catch {
+      /* skip */
+    }
   }
 
   // ── 命名模式检测 ──
@@ -739,7 +815,7 @@ function _buildFolderProfile(relDir, files, depth, projectRoot, sampleLines) {
     readme,
     purpose: purpose ? purpose : null,
     imports,
-    entryPoints: [...new Set(entryPoints.map(f => path.basename(f)))],
+    entryPoints: [...new Set(entryPoints.map((f) => path.basename(f)))],
     namingPatterns,
     headerComments,
   };
@@ -753,14 +829,20 @@ function _buildFolderProfile(relDir, files, depth, projectRoot, sampleLines) {
  */
 function _detectNamingPatterns(fileNames) {
   const patterns = [];
-  const lower = fileNames.map(n => n.toLowerCase());
+  const lower = fileNames.map((n) => n.toLowerCase());
 
   // 测试文件
-  const testFiles = lower.filter(n =>
-    n.startsWith('test_') || n.startsWith('test.') ||
-    n.endsWith('_test.go') || n.endsWith('.test.js') || n.endsWith('.test.ts') ||
-    n.endsWith('.spec.js') || n.endsWith('.spec.ts') || n.endsWith('_spec.rb') ||
-    n.startsWith('test') && n.includes('.')
+  const testFiles = lower.filter(
+    (n) =>
+      n.startsWith('test_') ||
+      n.startsWith('test.') ||
+      n.endsWith('_test.go') ||
+      n.endsWith('.test.js') ||
+      n.endsWith('.test.ts') ||
+      n.endsWith('.spec.js') ||
+      n.endsWith('.spec.ts') ||
+      n.endsWith('_spec.rb') ||
+      (n.startsWith('test') && n.includes('.'))
   );
   if (testFiles.length > 0) {
     patterns.push(`test files: ${testFiles.length}`);
@@ -803,16 +885,54 @@ function _extractImports(keyFiles, projectRoot, sampleLines, currentDir) {
 
   // Node.js / 常见运行时内置模块 — 不应计入项目文件夹依赖
   const BUILTIN_MODULES = new Set([
-    'fs', 'path', 'os', 'http', 'https', 'url', 'util', 'crypto', 'stream',
-    'events', 'child_process', 'cluster', 'net', 'dns', 'tls', 'zlib',
-    'readline', 'assert', 'buffer', 'querystring', 'string_decoder',
-    'timers', 'tty', 'dgram', 'vm', 'worker_threads', 'perf_hooks',
-    'async_hooks', 'v8', 'inspector', 'console', 'process', 'module',
+    'fs',
+    'path',
+    'os',
+    'http',
+    'https',
+    'url',
+    'util',
+    'crypto',
+    'stream',
+    'events',
+    'child_process',
+    'cluster',
+    'net',
+    'dns',
+    'tls',
+    'zlib',
+    'readline',
+    'assert',
+    'buffer',
+    'querystring',
+    'string_decoder',
+    'timers',
+    'tty',
+    'dgram',
+    'vm',
+    'worker_threads',
+    'perf_hooks',
+    'async_hooks',
+    'v8',
+    'inspector',
+    'console',
+    'process',
+    'module',
     // node: prefix 会被 firstSeg 拆出 "node" — 直接排除
     'node',
     // 常见第三方包 (非项目目录)
-    'react', 'vue', 'express', 'lodash', 'axios', 'moment', 'dayjs',
-    'webpack', 'vite', 'jest', 'mocha', 'chai',
+    'react',
+    'vue',
+    'express',
+    'lodash',
+    'axios',
+    'moment',
+    'dayjs',
+    'webpack',
+    'vite',
+    'jest',
+    'mocha',
+    'chai',
   ]);
 
   for (const relFile of keyFiles) {
@@ -829,13 +949,20 @@ function _extractImports(keyFiles, projectRoot, sampleLines, currentDir) {
             const target = match[1] || match[2];
             if (target) {
               // 跳过 node: 协议前缀 (Node.js 内置模块)
-              if (target.startsWith('node:')) continue;
+              if (target.startsWith('node:')) {
+                continue;
+              }
 
               // 解析相对路径 import → 文件夹名
               if (target.startsWith('.') || target.startsWith('/')) {
                 const resolved = path.normalize(path.join(currentDir, target));
                 const topDir = resolved.split('/')[0];
-                if (topDir && topDir !== '.' && topDir !== '..' && topDir !== currentDir.split('/')[0]) {
+                if (
+                  topDir &&
+                  topDir !== '.' &&
+                  topDir !== '..' &&
+                  topDir !== currentDir.split('/')[0]
+                ) {
                   importTargets.add(topDir);
                 }
               } else {
@@ -849,7 +976,9 @@ function _extractImports(keyFiles, projectRoot, sampleLines, currentDir) {
           }
         }
       }
-    } catch { /* skip unreadable files */ }
+    } catch {
+      /* skip unreadable files */
+    }
   }
 
   return [...importTargets].slice(0, 20);
@@ -870,18 +999,24 @@ function _extractHeaderComment(fullPath) {
     if (blockMatch) {
       const comment = blockMatch[1]
         .split('\n')
-        .map(l => l.replace(/^\s*\*\s?/, '').trim())
-        .filter(l => l && !l.startsWith('@'))
+        .map((l) => l.replace(/^\s*\*\s?/, '').trim())
+        .filter((l) => l && !l.startsWith('@'))
         .join(' ')
         .slice(0, 200);
-      if (comment.length > 10) return comment;
+      if (comment.length > 10) {
+        return comment;
+      }
     }
 
     // 尝试匹配 # 或 // 开头的连续行注释
     const lineComments = [];
     for (const line of lines) {
       const stripped = line.trim();
-      if (stripped.startsWith('#') && !stripped.startsWith('#!') && !stripped.startsWith('#include')) {
+      if (
+        stripped.startsWith('#') &&
+        !stripped.startsWith('#!') &&
+        !stripped.startsWith('#include')
+      ) {
         lineComments.push(stripped.replace(/^#+\s*/, ''));
       } else if (stripped.startsWith('//')) {
         lineComments.push(stripped.replace(/^\/\/\s*/, ''));
@@ -897,7 +1032,9 @@ function _extractHeaderComment(fullPath) {
     }
     if (lineComments.length > 0) {
       const comment = lineComments.join(' ').slice(0, 200);
-      if (comment.length > 10) return comment;
+      if (comment.length > 10) {
+        return comment;
+      }
     }
 
     return null;