autosnippet 3.0.0 → 3.0.2

package/lib/{service → platform/ios}/spm/SpmService.js

@@ -3,13 +3,19 @@
  * 整合 PackageSwiftParser + DependencyGraph + PolicyEngine
  */
 
-import Logger from '../../infrastructure/logging/Logger.js';
-import { PackageSwiftParser } from './PackageSwiftParser.js';
+import { readFileSync, writeFileSync } from 'node:fs';
+import {
+  basename as _pathBasename,
+  dirname,
+  resolve as pathResolve,
+  relative,
+  sep,
+} from 'node:path';
+import { GraphCache } from '../../../infrastructure/cache/GraphCache.js';
+import Logger from '../../../infrastructure/logging/Logger.js';
 import { DependencyGraph } from './DependencyGraph.js';
+import { PackageSwiftParser } from './PackageSwiftParser.js';
 import { PolicyEngine } from './PolicyEngine.js';
-import { GraphCache } from '../../infrastructure/cache/GraphCache.js';
-import { basename as _pathBasename, dirname, relative, sep, resolve as pathResolve } from 'node:path';
-import { readFileSync, writeFileSync, existsSync } from 'node:fs';
 
 export class SpmService {
   #parser;
@@ -62,7 +68,7 @@ export class SpmService {
 
   /**
    * 加载并解析 Package.swift，构建依赖图
-   * 支持多 Package 项目（如 BiliDemo 有多个子 Package）
+   * 支持多 Package 项目
    * 优先从磁盘缓存加载（Package.swift contentHash 匹配即命中）
    */
   async load() {
@@ -72,21 +78,23 @@ export class SpmService {
 
     // ── 收集所有 Package.swift 路径 + 联合 hash ──
     const packagePath = this.#parser.findPackageSwift(this.#projectRoot);
-    const allPaths = packagePath ? [packagePath] : this.#parser.findAllPackageSwifts(this.#projectRoot);
+    const allPaths = packagePath
+      ? [packagePath]
+      : this.#parser.findAllPackageSwifts(this.#projectRoot);
     if (allPaths.length === 0) {
       this.#logger.warn('[SpmService] Package.swift 未找到');
       return null;
     }
 
-    const combinedHash = allPaths
-      .map(p => this.#graphCache.computeFileHash(p))
-      .join(':');
+    const combinedHash = allPaths.map((p) => this.#graphCache.computeFileHash(p)).join(':');
 
     // ── 尝试命中缓存 ──
     const cached = this.#graphCache.load('spm-graph');
     if (cached && cached.contentHash === combinedHash) {
       this.#restoreFromCache(cached.data);
-      this.#logger.info(`[SpmService] ⚡ 缓存命中 (${this.#graph.getNodes().length} targets, hash=${combinedHash.substring(0, 8)})`);
+      this.#logger.info(
+        `[SpmService] ⚡ 缓存命中 (${this.#graph.getNodes().length} targets, hash=${combinedHash.substring(0, 8)})`
+      );
       return cached.data.parsedResult;
     }
 
@@ -125,7 +133,7 @@ export class SpmService {
    */
   #loadMultiPackage(allPaths) {
     this.#logger.info(`[SpmService] 发现 ${allPaths.length} 个 Package.swift，逐一解析...`);
-    let mergedTargets = [];
+    const mergedTargets = [];
     let lastName = 'multi-package';
     const allParsed = [];
 
@@ -158,7 +166,9 @@ export class SpmService {
 
     this.#buildPackageDepGraph(allParsed);
 
-    this.#logger.info(`[SpmService] 多包加载完成: ${mergedTargets.length} targets from ${allPaths.length} packages`);
+    this.#logger.info(
+      `[SpmService] 多包加载完成: ${mergedTargets.length} targets from ${allPaths.length} packages`
+    );
     return {
       name: lastName,
       targets: mergedTargets,
@@ -172,17 +182,19 @@ export class SpmService {
   #saveToCache(contentHash, parsedResult) {
     const graphJSON = this.#graph.toJSON();
     const targetPackageEntries = [...this.#targetPackageMap.entries()];
-    const packageDepEntries = [...this.#packageDepGraph.entries()].map(
-      ([k, v]) => [k, [...v]]
+    const packageDepEntries = [...this.#packageDepGraph.entries()].map(([k, v]) => [k, [...v]]);
+
+    this.#graphCache.save(
+      'spm-graph',
+      {
+        parsedResult,
+        graphNodes: graphJSON.nodes,
+        graphEdges: graphJSON.edges,
+        targetPackageMap: targetPackageEntries,
+        packageDepGraph: packageDepEntries,
+      },
+      { contentHash }
     );
-
-    this.#graphCache.save('spm-graph', {
-      parsedResult,
-      graphNodes: graphJSON.nodes,
-      graphEdges: graphJSON.edges,
-      targetPackageMap: targetPackageEntries,
-      packageDepGraph: packageDepEntries,
-    }, { contentHash });
   }
 
   /**
@@ -258,17 +270,25 @@ export class SpmService {
    * @returns {boolean}
    */
   _canReachPackage(fromPkgPath, toPkgPath) {
-    if (fromPkgPath === toPkgPath) return true;
+    if (fromPkgPath === toPkgPath) {
+      return true;
+    }
     const visited = new Set();
     const queue = [fromPkgPath];
     while (queue.length > 0) {
       const current = queue.shift();
-      if (current === toPkgPath) return true;
-      if (visited.has(current)) continue;
+      if (current === toPkgPath) {
+        return true;
+      }
+      if (visited.has(current)) {
+        continue;
+      }
       visited.add(current);
       const neighbors = this.#packageDepGraph.get(current);
       if (neighbors) {
-        for (const n of neighbors) queue.push(n);
+        for (const n of neighbors) {
+          queue.push(n);
+        }
       }
     }
     return false;
@@ -295,7 +315,9 @@ export class SpmService {
    */
   getFixMode() {
     const env = (process.env.ASD_FIX_SPM_DEPS_MODE || '').toLowerCase().trim();
-    if (env === 'off' || env === 'suggest' || env === 'fix') return env;
+    if (env === 'off' || env === 'suggest' || env === 'fix') {
+      return env;
+    }
     return 'suggest'; // 默认仅提示模式
   }
 
@@ -398,7 +420,7 @@ export class SpmService {
         return { ok: false, changed: false, error: 'Package.swift not found' };
       }
 
-      let content = readFileSync(packagePath, 'utf8');
+      const content = readFileSync(packagePath, 'utf8');
 
       // ── 1. 构建依赖 token ──
       let depToken;
@@ -464,7 +486,9 @@ export class SpmService {
       this.#graph.addEdge(from, to);
       this.#parser.clearCache();
 
-      this.#logger.info(`[SpmService] 已自动补齐依赖: ${from} -> ${to}${isCrossPackage ? ' (跨包)' : ''} (${packagePath})`);
+      this.#logger.info(
+        `[SpmService] 已自动补齐依赖: ${from} -> ${to}${isCrossPackage ? ' (跨包)' : ''} (${packagePath})`
+      );
       return { ok: true, changed: true, file: packagePath, crossPackage: isCrossPackage };
     } catch (err) {
       this.#logger.error(`[SpmService] addDependency failed: ${err.message}`);
@@ -486,7 +510,10 @@ export class SpmService {
 
     // 检查是否已有对该路径的 .package 声明
     const escapedPath = relPath.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-    const existsRe = new RegExp(`\\.package\\s*\\(\\s*(?:name\\s*:[^,]*,\\s*)?path\\s*:\\s*"${escapedPath}"`, 'm');
+    const existsRe = new RegExp(
+      `\\.package\\s*\\(\\s*(?:name\\s*:[^,]*,\\s*)?path\\s*:\\s*"${escapedPath}"`,
+      'm'
+    );
     if (existsRe.test(content)) {
       return { changed: false, content };
     }
@@ -527,10 +554,14 @@ export class SpmService {
   resolveCurrentTarget(filePath) {
     try {
       const packagePath = this.#parser.findPackageSwift(dirname(filePath));
-      if (!packagePath) return null;
+      if (!packagePath) {
+        return null;
+      }
 
       const nodes = this.#graph.getNodes();
-      if (nodes.length === 0) return null;
+      if (nodes.length === 0) {
+        return null;
+      }
 
       const packageDir = dirname(packagePath);
       const rel = relative(packageDir, filePath);
@@ -539,7 +570,9 @@ export class SpmService {
       // 从路径段反向查找第一个匹配的 target（V1 原始逻辑）
       const nodeSet = new Set(nodes);
       for (let i = segments.length - 1; i >= 0; i--) {
-        if (nodeSet.has(segments[i])) return segments[i];
+        if (nodeSet.has(segments[i])) {
+          return segments[i];
+        }
       }
 
       // 兜底：第一个 target
@@ -576,7 +609,7 @@ export class SpmService {
       edgeCount: this.#graph.edgeCount(),
       levels: Object.fromEntries(levels),
       cycleCount: cycles.length,
-      cycles: cycles.map(c => c.join(' → ')),
+      cycles: cycles.map((c) => c.join(' → ')),
     };
   }
 
@@ -592,7 +625,7 @@ export class SpmService {
     // 如果图中有节点，先用图数据
     const nodes = this.#graph.getNodes();
     if (nodes.length > 0) {
-      return [...nodes].map(name => ({
+      return [...nodes].map((name) => ({
         name,
         type: 'target',
       }));
@@ -602,12 +635,12 @@ export class SpmService {
     const allPaths = this.#parser.findAllPackageSwifts(this.#projectRoot);
 
     if (allPaths.length > 0) {
-      const { dirname } = await import('path');
+      const { dirname } = await import('node:path');
       const targets = [];
       for (const pkgPath of allPaths) {
         try {
           const parsed = this.#parser.parse(pkgPath);
-          if (parsed && parsed.targets) {
+          if (parsed?.targets) {
             const pkgDir = dirname(pkgPath);
             for (const t of parsed.targets) {
               targets.push({
@@ -624,13 +657,24 @@ export class SpmService {
           // Skip unparseable packages
         }
       }
-      if (targets.length > 0) return targets;
+      if (targets.length > 0) {
+        return targets;
+      }
     }
 
     // 非 SPM 项目 fallback：将常见源码目录作为虚拟 Target
-    const { existsSync } = await import('fs');
-    const { join } = await import('path');
-    const fallbackDirs = ['Sources', 'src', 'lib', 'app', 'pages', 'components', 'modules', 'packages'];
+    const { existsSync } = await import('node:fs');
+    const { join } = await import('node:path');
+    const fallbackDirs = [
+      'Sources',
+      'src',
+      'lib',
+      'app',
+      'pages',
+      'components',
+      'modules',
+      'packages',
+    ];
     const virtualTargets = [];
     for (const dir of fallbackDirs) {
       if (existsSync(join(this.#projectRoot, dir))) {
@@ -653,12 +697,12 @@ export class SpmService {
     const json = this.#graph.toJSON();
 
     return {
-      nodes: json.nodes.map(name => ({
+      nodes: json.nodes.map((name) => ({
         id: name,
         label: name,
         type: options.level === 'package' ? 'package' : 'target',
       })),
-      edges: json.edges.map(e => ({ from: e.from, to: e.to, source: 'spm' })),
+      edges: json.edges.map((e) => ({ from: e.from, to: e.to, source: 'spm' })),
       projectRoot: this.#projectRoot,
       generatedAt: new Date().toISOString(),
     };
@@ -672,7 +716,9 @@ export class SpmService {
    */
   async getTargetFiles(target) {
     const targetName = typeof target === 'string' ? target : target?.name;
-    if (!targetName) return [];
+    if (!targetName) {
+      return [];
+    }
 
     // 内存缓存命中
     if (this.#targetFilesCache.has(targetName)) {
@@ -688,8 +734,8 @@ export class SpmService {
    * 实际的文件遍历逻辑（拆出以供缓存用）
    */
   async #walkTargetFiles(target, targetName) {
-    const { existsSync, readdirSync, statSync } = await import('fs');
-    const { join, dirname, relative, extname } = await import('path');
+    const { existsSync, readdirSync, statSync } = await import('node:fs');
+    const { join, dirname, extname } = await import('node:path');
 
     // 判断是否为虚拟目录 target（非 SPM fallback）
     const isDirectoryTarget = typeof target === 'object' && target?.type === 'directory';
@@ -716,9 +762,9 @@ export class SpmService {
       for (const pkgPath of allPaths) {
         try {
           const parsed = this.#parser.parse(pkgPath);
-          if (parsed?.targets?.some(t => t.name === targetName)) {
+          if (parsed?.targets?.some((t) => t.name === targetName)) {
             const pkgDir = dirname(pkgPath);
-            const matchTarget = parsed.targets.find(t => t.name === targetName);
+            const matchTarget = parsed.targets.find((t) => t.name === targetName);
             if (matchTarget?.path) {
               searchDirs.push(join(pkgDir, matchTarget.path));
             }
@@ -742,32 +788,86 @@ export class SpmService {
         break;
       }
     }
-    if (!sourcesDir) return [];
+    if (!sourcesDir) {
+      return [];
+    }
 
     // 文件扩展名白名单
     const CODE_EXTS = isDirectoryTarget
-      ? new Set(['.swift', '.m', '.mm', '.h', '.c', '.cpp', '.js', '.ts', '.tsx', '.jsx', '.py', '.java', '.kt', '.go', '.rs', '.rb', '.vue', '.mjs', '.cjs'])
+      ? new Set([
+          '.swift',
+          '.m',
+          '.mm',
+          '.h',
+          '.c',
+          '.cpp',
+          '.js',
+          '.ts',
+          '.tsx',
+          '.jsx',
+          '.py',
+          '.java',
+          '.kt',
+          '.go',
+          '.rs',
+          '.rb',
+          '.vue',
+          '.mjs',
+          '.cjs',
+        ])
       : new Set(['.swift', '.m', '.h', '.c', '.cpp', '.mm']);
-    const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', 'build', '.next', 'Pods', 'Carthage', '.build', 'DerivedData', 'vendor', '__pycache__', '.venv', 'target']);
+    const SKIP_DIRS = new Set([
+      'node_modules',
+      '.git',
+      'dist',
+      'build',
+      '.next',
+      'Pods',
+      'Carthage',
+      '.build',
+      'DerivedData',
+      'vendor',
+      '__pycache__',
+      '.venv',
+      'target',
+    ]);
     const MAX_FILES = 300;
 
     const files = [];
     const walk = (dir, rel = '') => {
-      if (files.length >= MAX_FILES) return;
+      if (files.length >= MAX_FILES) {
+        return;
+      }
       let entries;
-      try { entries = readdirSync(dir); } catch { return; }
+      try {
+        entries = readdirSync(dir);
+      } catch {
+        return;
+      }
       for (const entry of entries) {
-        if (files.length >= MAX_FILES) break;
-        if (entry.startsWith('.')) continue;
+        if (files.length >= MAX_FILES) {
+          break;
+        }
+        if (entry.startsWith('.')) {
+          continue;
+        }
         const full = join(dir, entry);
         const relPath = rel ? `${rel}/${entry}` : entry;
         let st;
-        try { st = statSync(full); } catch { continue; }
+        try {
+          st = statSync(full);
+        } catch {
+          continue;
+        }
         if (st.isDirectory()) {
-          if (SKIP_DIRS.has(entry)) continue;
+          if (SKIP_DIRS.has(entry)) {
+            continue;
+          }
           walk(full, relPath);
         } else if (CODE_EXTS.has(extname(entry).toLowerCase())) {
-          if (st.size > 512 * 1024) continue; // 跳过 > 512KB
+          if (st.size > 512 * 1024) {
+            continue; // 跳过 > 512KB
+          }
           files.push({ name: entry, path: full, relativePath: relPath, size: st.size });
         }
       }
@@ -816,10 +916,14 @@ export class SpmService {
     onProgress?.({ type: 'scan:started', targetName });
     const fileList = await this.getTargetFiles(target);
     if (!fileList || fileList.length === 0) {
-      return { recipes: [], scannedFiles: [], message: `No source files found for target: ${targetName}` };
+      return {
+        recipes: [],
+        scannedFiles: [],
+        message: `No source files found for target: ${targetName}`,
+      };
     }
 
-    const scannedFilesMeta = fileList.map(f => {
+    const scannedFilesMeta = fileList.map((f) => {
       const filePath = typeof f === 'string' ? f : f.path;
       return { name: _pathBasename(filePath), path: f.relativePath || _pathBasename(filePath) };
     });
@@ -827,28 +931,39 @@ export class SpmService {
 
     // 2. 读取文件内容
     onProgress?.({ type: 'scan:reading', count: fileList.length });
-    const { readFileSync } = await import('fs');
-    const { basename, resolve } = await import('path');
-    const files = fileList.map(f => {
-      const filePath = typeof f === 'string' ? f : f.path;
-      try {
-        return { name: basename(filePath), path: filePath, relativePath: f.relativePath || basename(filePath), content: readFileSync(filePath, 'utf8') };
-      } catch (err) {
-        this.#logger.warn(`[SpmService] 读取文件失败: ${filePath} — ${err.message}`);
-        return null;
-      }
-    }).filter(Boolean);
+    const { readFileSync } = await import('node:fs');
+    const { basename } = await import('node:path');
+    const files = fileList
+      .map((f) => {
+        const filePath = typeof f === 'string' ? f : f.path;
+        try {
+          return {
+            name: basename(filePath),
+            path: filePath,
+            relativePath: f.relativePath || basename(filePath),
+            content: readFileSync(filePath, 'utf8'),
+          };
+        } catch (err) {
+          this.#logger.warn(`[SpmService] 读取文件失败: ${filePath} — ${err.message}`);
+          return null;
+        }
+      })
+      .filter(Boolean);
 
     if (files.length === 0) {
       return { recipes: [], scannedFiles: [], message: 'All source files unreadable' };
     }
 
-    const scannedFiles = files.map(f => ({ name: f.name, path: f.relativePath }));
+    const scannedFiles = files.map((f) => ({ name: f.name, path: f.relativePath }));
     this.#logger.info(`[SpmService] scanTarget: ${targetName}, ${files.length} files`);
 
     // 3. AI 提取 Recipes（通过 ChatAgent 统一入口）
     if (!this.#chatAgent && !this.#aiFactory) {
-      return { recipes: [], scannedFiles, message: 'AI provider not configured. Please set ASD_AI_PROVIDER.' };
+      return {
+        recipes: [],
+        scannedFiles,
+        message: 'AI provider not configured. Please set ASD_AI_PROVIDER.',
+      };
     }
 
     onProgress?.({ type: 'scan:ai-extracting', fileCount: files.length, targetName });
@@ -856,9 +971,16 @@ export class SpmService {
     let recipes;
     try {
       if (this.#chatAgent) {
-        const extractPromise = this.#chatAgent.executeTool('extract_recipes', { targetName, files });
+        const extractPromise = this.#chatAgent.executeTool('extract_recipes', {
+          targetName,
+          files,
+        });
         const timeoutPromise = new Promise((_, reject) =>
-          setTimeout(() => reject(new Error(`AI extraction timeout (${AI_EXTRACT_TIMEOUT / 1000}s)`)), AI_EXTRACT_TIMEOUT));
+          setTimeout(
+            () => reject(new Error(`AI extraction timeout (${AI_EXTRACT_TIMEOUT / 1000}s)`)),
+            AI_EXTRACT_TIMEOUT
+          )
+        );
         const result = await Promise.race([extractPromise, timeoutPromise]);
         if (result?.error) {
           return { recipes: [], scannedFiles, message: result.error };
@@ -866,7 +988,12 @@ export class SpmService {
         recipes = result?.recipes || [];
       } else {
         // 降级: 直接使用 aiFactory（兼容未注入 chatAgent 的场景）
-        const { getProviderWithFallback, isGeoOrProviderError, getAvailableFallbacks, createProvider } = this.#aiFactory;
+        const {
+          getProviderWithFallback,
+          isGeoOrProviderError,
+          getAvailableFallbacks,
+          createProvider,
+        } = this.#aiFactory;
         let ai = await getProviderWithFallback();
         if (!ai) {
           return { recipes: [], scannedFiles, message: 'AI provider not available' };
@@ -875,7 +1002,7 @@ export class SpmService {
         // 加载语言参考 Skill 注入 AI 提取 prompt
         let extractOpts = {};
         try {
-          const { loadBootstrapSkills } = await import('../../external/mcp/handlers/bootstrap.js');
+          const { loadBootstrapSkills } = await import('../../../external/mcp/handlers/bootstrap.js');
           const langProfile = ai._detectLanguageProfile?.(files);
           const primaryLang = langProfile?.primaryLanguage;
           if (primaryLang) {
@@ -884,7 +1011,9 @@ export class SpmService {
               extractOpts = { skillReference: skillCtx.languageSkill.substring(0, 2000) };
             }
           }
-        } catch { /* Skills not available */ }
+        } catch {
+          /* Skills not available */
+        }
 
         try {
           recipes = await ai.extractRecipes(targetName, files, extractOpts);
@@ -903,7 +1032,9 @@ export class SpmService {
                 this.#logger.warn(`[SpmService] fallback "${fbName}" failed: ${fbErr.message}`);
               }
             }
-            if (!fallbackOk) throw primaryErr;
+            if (!fallbackOk) {
+              throw primaryErr;
+            }
           } else {
             throw primaryErr;
           }
@@ -914,17 +1045,19 @@ export class SpmService {
       return { recipes: [], scannedFiles, message: `AI extraction failed: ${err.message}` };
     }
 
-    if (!Array.isArray(recipes)) recipes = [];
+    if (!Array.isArray(recipes)) {
+      recipes = [];
+    }
 
     // 3.5 Header 路径解析 + moduleName 注入
     try {
-      const PathFinder = await import('../../infrastructure/paths/PathFinder.js');
-      const HeaderResolver = await import('../../infrastructure/paths/HeaderResolver.js');
+      const PathFinder = await import('../../../infrastructure/paths/PathFinder.js');
+      const HeaderResolver = await import('../../../infrastructure/paths/HeaderResolver.js');
       const targetRootDir = await PathFinder.findTargetRootDir(files[0].path);
       for (const recipe of recipes) {
         const headerList = recipe.headers || [];
         recipe.headerPaths = await Promise.all(
-          headerList.map(h => HeaderResolver.resolveHeaderRelativePath(h, targetRootDir))
+          headerList.map((h) => HeaderResolver.resolveHeaderRelativePath(h, targetRootDir))
         );
         recipe.moduleName = targetName;
       }
@@ -938,9 +1071,21 @@ export class SpmService {
 
     const result = { recipes, scannedFiles };
     if (recipes.length === 0) {
-      result.message = `AI extraction returned 0 recipes for ${targetName} (${files.length} files analyzed)`;
+      const aiInfo = this.#aiFactory
+        ? (await import('../../../external/ai/AiFactory.js')).getAiConfigInfo()
+        : null;
+      if (aiInfo && !aiInfo.hasKey) {
+        result.noAi = true;
+        result.message = 'AI 未配置，已跳过智能提取。请在 .env 中设置 API Key 后重试。';
+      } else {
+        result.message = `AI 提取完成，但未发现可复用的代码模式（${targetName}, ${files.length} 个文件）`;
+      }
     }
-    onProgress?.({ type: 'scan:completed', recipeCount: recipes.length, fileCount: scannedFiles.length });
+    onProgress?.({
+      type: 'scan:completed',
+      recipeCount: recipes.length,
+      fileCount: scannedFiles.length,
+    });
     return result;
   }
 
@@ -951,15 +1096,15 @@ export class SpmService {
   async scanProject(options = {}) {
     this.#logger.info('[SpmService] scanProject: starting full-project scan');
 
-    const { readFileSync, existsSync, readdirSync, statSync } = await import('fs');
-    const { basename: bn, join, extname, relative } = await import('path');
+    const { readFileSync, existsSync, readdirSync, statSync } = await import('node:fs');
+    const { basename: bn, join, extname, relative } = await import('node:path');
 
     // 1. 列出所有 target
     const allTargets = await this.listTargets();
 
     // 2. 收集所有源文件（去重）
     const seenPaths = new Set();
-    const allFiles = [];  // { name, path, relativePath, content, targetName }
+    const allFiles = []; // { name, path, relativePath, content, targetName }
     const MAX_FILES = options.maxFiles || 200;
 
     if (allTargets && allTargets.length > 0) {
@@ -969,7 +1114,9 @@ export class SpmService {
           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');
@@ -980,40 +1127,105 @@ export class SpmService {
                 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(`[SpmService] scanProject: skipping target ${t.name}: ${e.message}`);
         }
-        if (allFiles.length >= MAX_FILES) break;
+        if (allFiles.length >= MAX_FILES) {
+          break;
+        }
       }
     } else {
       // 非 SPM 项目：直接扫描常见源码目录（fallback）
       this.#logger.info('[SpmService] scanProject: No SPM targets, falling back to directory scan');
-      const CODE_EXTS = new Set(['.swift', '.m', '.mm', '.h', '.js', '.ts', '.tsx', '.jsx', '.py', '.java', '.kt', '.go', '.rs', '.rb', '.vue', '.mjs', '.cjs']);
-      const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', 'build', '.next', 'Pods', 'Carthage', '.build', 'DerivedData', 'vendor', '__pycache__', '.venv', 'target']);
-      const srcDirs = ['Sources', 'src', 'lib', 'app', 'pages', 'components', 'modules', 'packages'];
+      const CODE_EXTS = new Set([
+        '.swift',
+        '.m',
+        '.mm',
+        '.h',
+        '.js',
+        '.ts',
+        '.tsx',
+        '.jsx',
+        '.py',
+        '.java',
+        '.kt',
+        '.go',
+        '.rs',
+        '.rb',
+        '.vue',
+        '.mjs',
+        '.cjs',
+      ]);
+      const SKIP_DIRS = new Set([
+        'node_modules',
+        '.git',
+        'dist',
+        'build',
+        '.next',
+        'Pods',
+        'Carthage',
+        '.build',
+        'DerivedData',
+        'vendor',
+        '__pycache__',
+        '.venv',
+        'target',
+      ]);
+      const srcDirs = [
+        'Sources',
+        'src',
+        'lib',
+        'app',
+        'pages',
+        'components',
+        'modules',
+        'packages',
+      ];
 
       const walkDir = (dir, targetName) => {
-        if (allFiles.length >= MAX_FILES) return;
+        if (allFiles.length >= MAX_FILES) {
+          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 >= MAX_FILES) break;
-          if (ent.name.startsWith('.')) continue;
+          if (allFiles.length >= MAX_FILES) {
+            break;
+          }
+          if (ent.name.startsWith('.')) {
+            continue;
+          }
           const fp = join(dir, ent.name);
           if (ent.isDirectory()) {
-            if (SKIP_DIRS.has(ent.name)) continue;
+            if (SKIP_DIRS.has(ent.name)) {
+              continue;
+            }
             walkDir(fp, targetName);
           } else if (ent.isFile() && CODE_EXTS.has(extname(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; // 跳过 > 512KB
+              if (st.size > 512 * 1024) {
+                continue; // 跳过 > 512KB
+              }
               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,
@@ -1021,7 +1233,9 @@ export class SpmService {
                 content,
                 targetName,
               });
-            } catch { /* unreadable */ }
+            } catch {
+              /* unreadable */
+            }
           }
         }
       };
@@ -1039,16 +1253,28 @@ export class SpmService {
       }
     }
 
-    this.#logger.info(`[SpmService] scanProject: ${allFiles.length} unique files from ${allTargets?.length || 0} targets`);
+    this.#logger.info(
+      `[SpmService] scanProject: ${allFiles.length} unique files from ${allTargets?.length || 0} targets`
+    );
 
     if (allFiles.length === 0) {
-      return { targets: (allTargets || []).map(t => t.name), recipes: [], guardAudit: null, scannedFiles: [], message: 'No readable source files' };
+      return {
+        targets: (allTargets || []).map((t) => t.name),
+        recipes: [],
+        guardAudit: null,
+        scannedFiles: [],
+        message: 'No readable source files',
+      };
     }
 
-    const scannedFiles = allFiles.map(f => ({ name: f.name, path: f.relativePath, targetName: f.targetName }));
+    const scannedFiles = allFiles.map((f) => ({
+      name: f.name,
+      path: f.relativePath,
+      targetName: f.targetName,
+    }));
 
     // 3. AI 提取 Recipes（全局批量，分批避免 token 超限）— 通过 ChatAgent 统一入口
-    let allRecipes = [];
+    const allRecipes = [];
     const PER_BATCH_TIMEOUT = options.batchTimeout || 90000; // 每批最多 90 秒
     const startTime = Date.now();
     const TOTAL_TIMEOUT = options.totalTimeout || 540000; // 总超时 9 分钟（留 1 分钟给 Guard）
@@ -1061,7 +1287,9 @@ export class SpmService {
         // 通过 ChatAgent extract_recipes 工具（内置 fallback）
         for (let i = 0; i < allFiles.length; i += BATCH_SIZE) {
           if (Date.now() - startTime > TOTAL_TIMEOUT) {
-            this.#logger.warn(`[SpmService] scanProject: total timeout reached after ${Math.floor((Date.now() - startTime) / 1000)}s, returning partial results`);
+            this.#logger.warn(
+              `[SpmService] scanProject: total timeout reached after ${Math.floor((Date.now() - startTime) / 1000)}s, returning partial results`
+            );
             timedOut = true;
             break;
           }
@@ -1069,47 +1297,75 @@ export class SpmService {
           const batchLabel = `project-batch-${Math.floor(i / BATCH_SIZE) + 1}`;
           try {
             const result = await Promise.race([
-              this.#chatAgent.executeTool('extract_recipes', { targetName: batchLabel, files: batch }),
-              new Promise((_, reject) => setTimeout(() => reject(new Error('batch timeout')), PER_BATCH_TIMEOUT)),
+              this.#chatAgent.executeTool('extract_recipes', {
+                targetName: batchLabel,
+                files: batch,
+              }),
+              new Promise((_, reject) =>
+                setTimeout(() => reject(new Error('batch timeout')), PER_BATCH_TIMEOUT)
+              ),
             ]);
-            if (Array.isArray(result?.recipes)) allRecipes.push(...result.recipes);
+            if (Array.isArray(result?.recipes)) {
+              allRecipes.push(...result.recipes);
+            }
           } catch (err) {
-            this.#logger.warn(`[SpmService] scanProject ChatAgent batch ${batchLabel} failed: ${err.message}`);
+            this.#logger.warn(
+              `[SpmService] scanProject ChatAgent batch ${batchLabel} failed: ${err.message}`
+            );
           }
         }
       } else {
         // 降级: 直接使用 aiFactory（兼容未注入 chatAgent 的场景）
-        const { getProviderWithFallback, isGeoOrProviderError, getAvailableFallbacks, createProvider } = this.#aiFactory;
+        const {
+          getProviderWithFallback,
+          isGeoOrProviderError,
+          getAvailableFallbacks,
+          createProvider,
+        } = this.#aiFactory;
         let ai = await getProviderWithFallback();
 
         if (ai) {
           for (let i = 0; i < allFiles.length; i += BATCH_SIZE) {
             if (Date.now() - startTime > TOTAL_TIMEOUT) {
-              this.#logger.warn(`[SpmService] scanProject: total timeout reached, returning partial results`);
+              this.#logger.warn(
+                `[SpmService] scanProject: total timeout reached, returning partial results`
+              );
               timedOut = true;
               break;
             }
             const batch = allFiles.slice(i, i + BATCH_SIZE);
             const batchLabel = `project-batch-${Math.floor(i / BATCH_SIZE) + 1}`;
             try {
-              let recipes = await Promise.race([
+              const recipes = await Promise.race([
                 ai.extractRecipes(batchLabel, batch),
-                new Promise((_, reject) => setTimeout(() => reject(new Error('batch timeout')), PER_BATCH_TIMEOUT)),
+                new Promise((_, reject) =>
+                  setTimeout(() => reject(new Error('batch timeout')), PER_BATCH_TIMEOUT)
+                ),
               ]);
-              if (Array.isArray(recipes)) allRecipes.push(...recipes);
+              if (Array.isArray(recipes)) {
+                allRecipes.push(...recipes);
+              }
             } catch (err) {
               if (isGeoOrProviderError(err)) {
-                const fallbacks = getAvailableFallbacks((process.env.ASD_AI_PROVIDER || 'google').toLowerCase());
+                const fallbacks = getAvailableFallbacks(
+                  (process.env.ASD_AI_PROVIDER || 'google').toLowerCase()
+                );
                 for (const fb of fallbacks) {
                   try {
                     ai = createProvider({ provider: fb });
-                    let recipes = await ai.extractRecipes(batchLabel, batch);
-                    if (Array.isArray(recipes)) allRecipes.push(...recipes);
+                    const recipes = await ai.extractRecipes(batchLabel, batch);
+                    if (Array.isArray(recipes)) {
+                      allRecipes.push(...recipes);
+                    }
                     break;
-                  } catch { /* next fallback */ }
+                  } catch {
+                    /* next fallback */
+                  }
                 }
               } else {
-                this.#logger.warn(`[SpmService] scanProject AI batch ${batchLabel} failed: ${err.message}`);
+                this.#logger.warn(
+                  `[SpmService] scanProject AI batch ${batchLabel} failed: ${err.message}`
+                );
               }
             }
           }
@@ -1124,7 +1380,7 @@ export class SpmService {
     let guardAudit = null;
     if (this.#guardCheckEngine) {
       try {
-        const guardFiles = allFiles.map(f => ({ path: f.path, content: f.content }));
+        const guardFiles = allFiles.map((f) => ({ path: f.path, content: f.content }));
         guardAudit = this.#guardCheckEngine.auditFiles(guardFiles, { scope: 'project' });
 
         // 将有违反的文件写入 ViolationsStore
@@ -1144,10 +1400,12 @@ export class SpmService {
       }
     }
 
-    this.#logger.info(`[SpmService] scanProject complete: ${allRecipes.length} recipes, ${guardAudit?.summary?.totalViolations || 0} violations${timedOut ? ' (partial — timed out)' : ''}`);
+    this.#logger.info(
+      `[SpmService] scanProject complete: ${allRecipes.length} recipes, ${guardAudit?.summary?.totalViolations || 0} violations${timedOut ? ' (partial — timed out)' : ''}`
+    );
 
     return {
-      targets: allTargets.map(t => t.name),
+      targets: allTargets.map((t) => t.name),
       recipes: allRecipes,
       guardAudit,
       scannedFiles,