autosnippet 3.0.0 → 3.0.2

package/lib/infrastructure/external/XcodeAutomation.js

@@ -1,259 +1,15 @@
 /**
- * XcodeAutomation — Xcode AppleScript 自动化
- *
- * 通过 osascript 向 Xcode 发送键盘事件，实现行级操作：
- *   跳转行、选中行内容、剪切行、粘贴、在行首插入、删除行内容、保存文档。
- *
- * 所有操作都带超时保护（OSASCRIPT_TIMEOUT），Xcode 未运行时安全跳过。
- * 仅支持 macOS。
- */
-
-import { execSync, spawnSync } from 'node:child_process';
-
-const OSASCRIPT_TIMEOUT = 5000;
-
-// ─────────────────────────────────────────────
-// 内部辅助
-// ─────────────────────────────────────────────
-
-/**
- * 将行号限制为有效正整数（最小值 1）
- * @param {number} n 原始行号
- * @returns {number} 安全的 1-based 行号
- */
-function _safeLine(n) {
-  return Number.isFinite(n) && n > 0 ? n : 1;
-}
-
-/**
- * 执行 osascript 并返回是否成功
- * @param {string[]} args  osascript 参数数组（每对 `-e`, `script`）
- * @returns {boolean}
- */
-function _run(args) {
-  try {
-    const res = spawnSync('osascript', args, { stdio: 'ignore', timeout: OSASCRIPT_TIMEOUT });
-    return res.status === 0;
-  } catch {
-    return false;
-  }
-}
-
-// ─────────────────────────────────────────────
-// 状态查询
-// ─────────────────────────────────────────────
-
-/**
- * 检查 Xcode 是否正在运行（不会启动 Xcode）
- */
-export function isXcodeRunning() {
-  if (process.platform !== 'darwin') return false;
-  try {
-    const result = execSync('pgrep -x Xcode', {
-      encoding: 'utf8',
-      timeout: 2000,
-      stdio: 'pipe',
-    });
-    return result.trim().length > 0;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * 检查 Xcode 是否为当前前台应用
- */
-export function isXcodeFrontmost() {
-  if (!isXcodeRunning()) return false;
-  try {
-    const result = execSync(
-      'osascript -e \'tell application "System Events" to get name of first process whose frontmost is true\'',
-      { encoding: 'utf8', timeout: OSASCRIPT_TIMEOUT, stdio: 'pipe' }
-    );
-    return result.trim() === 'Xcode';
-  } catch {
-    return false;
-  }
-}
-
-// ─────────────────────────────────────────────
-// 行操作
-// ─────────────────────────────────────────────
-
-/**
- * 跳转到指定行
- *
- * 按键序列：Cmd+L → 输入行号 → Return
- *
- * @param {number} lineNumber 1-based 行号
- * @returns {boolean} 是否成功
- */
-export function jumpToLineInXcode(lineNumber) {
-  if (!isXcodeRunning()) return false;
-  const n = _safeLine(lineNumber);
-  return _run([
-    '-e', 'tell application "Xcode" to activate',
-    '-e', 'delay 0.2',
-    '-e', 'tell application "System Events"',
-    '-e', '  keystroke "l" using command down',
-    '-e', '  delay 0.2',
-    '-e', `  keystroke "${String(n)}"`,
-    '-e', '  delay 0.2',
-    '-e', '  key code 36',
-    '-e', 'end tell',
-  ]);
-}
-
-/**
- * 剪切指定行的文本内容（不含换行符）
- *
- * 按键序列：Cmd+L 跳转 → Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Cmd+X 剪切
- *
- * @param {number} lineNumber 1-based 行号
- * @returns {boolean} 是否成功
- */
-export function cutLineInXcode(lineNumber) {
-  if (!isXcodeRunning()) return false;
-  const n = _safeLine(lineNumber);
-  return _run([
-    '-e', 'tell application "Xcode" to activate',
-    '-e', 'delay 0.5',
-    '-e', 'tell application "System Events"',
-    '-e', '  keystroke "l" using command down',                      // Cmd+L: Go to Line
-    '-e', '  delay 0.5',
-    '-e', `  keystroke "${String(n)}"`,                              // 输入行号
-    '-e', '  delay 0.5',
-    '-e', '  key code 36',                                           // Return
-    '-e', '  delay 0.5',
-    '-e', '  key code 123 using command down',                       // Cmd+← 行首
-    '-e', '  delay 0.5',
-    '-e', '  key code 124 using {command down, shift down}',         // Cmd+Shift+→ 选到行尾
-    '-e', '  delay 0.5',
-    '-e', '  keystroke "x" using command down',                      // Cmd+X
-    '-e', 'end tell',
-  ]);
-}
-
-/**
- * 删除指定行的文本内容（保留空行，不删除行本身）
- *
- * 按键序列：Cmd+L 跳转 → Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Delete
- *
- * @param {number} lineNumber 1-based 行号
- * @returns {boolean} 是否成功
- */
-export function deleteLineContentInXcode(lineNumber) {
-  if (!isXcodeRunning()) return false;
-  const n = _safeLine(lineNumber);
-  return _run([
-    '-e', 'tell application "Xcode" to activate',
-    '-e', 'delay 0.3',
-    '-e', 'tell application "System Events"',
-    '-e', '  keystroke "l" using command down',
-    '-e', '  delay 0.3',
-    '-e', `  keystroke "${String(n)}"`,
-    '-e', '  delay 0.3',
-    '-e', '  key code 36',
-    '-e', '  delay 0.3',
-    '-e', '  key code 123 using command down',                       // Cmd+← 行首
-    '-e', '  delay 0.2',
-    '-e', '  key code 124 using {command down, shift down}',         // Cmd+Shift+→ 选到行尾
-    '-e', '  delay 0.2',
-    '-e', '  key code 51',                                           // Delete 键
-    '-e', '  delay 0.3',
-    '-e', 'end tell',
-  ]);
-}
-
-// ─────────────────────────────────────────────
-// 粘贴操作
-// ─────────────────────────────────────────────
-
-/**
- * 执行粘贴（Cmd+V）
- *
- * 调用前须确保剪贴板已写入目标内容。
- * @returns {boolean} 是否成功
- */
-export function pasteInXcode() {
-  if (!isXcodeRunning()) return false;
-  return _run([
-    '-e', 'tell application "Xcode" to activate',
-    '-e', 'delay 0.2',
-    '-e', 'tell application "System Events"',
-    '-e', '  keystroke "v" using command down',
-    '-e', 'end tell',
-  ]);
-}
-
-/**
- * 选中当前行内容后粘贴替换
- *
- * 假设光标已在目标行（通常由 jumpToLineInXcode 定位后调用）。
- * 按键序列：Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Cmd+V 粘贴替换
- *
- * @returns {boolean} 是否成功
- */
-export function selectAndPasteInXcode() {
-  if (!isXcodeRunning()) return false;
-  return _run([
-    '-e', 'tell application "Xcode" to activate',
-    '-e', 'delay 0.5',
-    '-e', 'tell application "System Events"',
-    '-e', '  key code 123 using command down',                       // Cmd+← 行首
-    '-e', '  delay 0.1',
-    '-e', '  key code 124 using {command down, shift down}',         // Cmd+Shift+→ 选到行尾
-    '-e', '  delay 0.2',
-    '-e', '  keystroke "v" using command down',                      // Cmd+V 粘贴替换
-    '-e', 'end tell',
-  ]);
-}
-
-/**
- * 跳转到指定行行首并粘贴剪贴板内容
- *
- * 用于在 import 区域插入新行。
- * 按键序列：Cmd+L → 输入行号 → Return → Cmd+← 行首 → Cmd+V 粘贴
- *
- * @param {number} lineNumber 1-based 行号
- * @returns {boolean} 是否成功
- */
-export function insertAtLineStartInXcode(lineNumber) {
-  if (!isXcodeRunning()) return false;
-  const n = _safeLine(lineNumber);
-  return _run([
-    '-e', 'tell application "Xcode" to activate',
-    '-e', 'delay 0.3',
-    '-e', 'tell application "System Events"',
-    '-e', '  keystroke "l" using command down',                      // Cmd+L: Go to Line
-    '-e', '  delay 0.3',
-    '-e', `  keystroke "${String(n)}"`,                              // 输入行号
-    '-e', '  delay 0.3',
-    '-e', '  key code 36',                                           // Return
-    '-e', '  delay 0.3',
-    '-e', '  key code 123 using command down',                       // Cmd+← 行首
-    '-e', '  delay 0.2',
-    '-e', '  keystroke "v" using command down',                      // Cmd+V 粘贴
-    '-e', '  delay 0.3',
-    '-e', 'end tell',
-  ]);
-}
-
-// ─────────────────────────────────────────────
-// 文档操作
-// ─────────────────────────────────────────────
-
-/**
- * 保存 Xcode 当前活动文档（Cmd+S）
- * @returns {boolean} 是否成功
- */
-export function saveActiveDocumentInXcode() {
-  if (!isXcodeRunning()) return false;
-  return _run([
-    '-e', 'tell application "Xcode" to activate',
-    '-e', 'delay 0.1',
-    '-e', 'tell application "System Events"',
-    '-e', '  keystroke "s" using command down',
-    '-e', 'end tell',
-  ]);
-}
+ * @deprecated Moved to lib/platform/ios/xcode/XcodeAutomation.js
+ * This re-export shim maintains backward compatibility.
+ */
+export {
+  isXcodeRunning,
+  isXcodeFrontmost,
+  jumpToLineInXcode,
+  cutLineInXcode,
+  deleteLineContentInXcode,
+  pasteInXcode,
+  selectAndPasteInXcode,
+  insertAtLineStartInXcode,
+  saveActiveDocumentInXcode,
+} from '../../platform/ios/xcode/XcodeAutomation.js';

package/lib/infrastructure/logging/Logger.js

@@ -1,31 +1,38 @@
+import fs from 'node:fs';
+import path from 'node:path';
 import winston from 'winston';
-import path from 'path';
-import fs from 'fs';
 
 // ChatAgent 相关标签 — 终端高亮显示
-const AGENT_TAGS = ['ChatAgent', 'ToolRegistry', 'SignalCollector', 'SkillAdvisor', 'CircuitBreaker', 'EventAggregator'];
+const AGENT_TAGS = [
+  'ChatAgent',
+  'ToolRegistry',
+  'SignalCollector',
+  'SkillAdvisor',
+  'CircuitBreaker',
+  'EventAggregator',
+];
 const MUTED_PREFIXES = ['HTTP Request', 'Tool registered:', '📊 性能统计已更新'];
 
 // ANSI 颜色常量 — 保证深色终端可读性
 const C = {
-  reset:   '\x1b[0m',
-  dim:     '\x1b[2m',       // 真正的 dim（用于次要信息）
-  bold:    '\x1b[1m',
+  reset: '\x1b[0m',
+  dim: '\x1b[2m', // 真正的 dim（用于次要信息）
+  bold: '\x1b[1m',
   // 前景色 — 使用亮色变体，深色终端更清晰
-  gray:    '\x1b[37m',      // 白色（替代 90 暗灰）
-  cyan:    '\x1b[96m',      // 亮青
-  green:   '\x1b[92m',      // 亮绿
-  yellow:  '\x1b[93m',      // 亮黄
-  red:     '\x1b[91m',      // 亮红
-  magenta: '\x1b[95m',      // 亮洋红
-  blue:    '\x1b[94m',      // 亮蓝
-  dimGray: '\x1b[2;37m',    // dim 白色 — 比 90 在深色背景上更可读
+  gray: '\x1b[37m', // 白色（替代 90 暗灰）
+  cyan: '\x1b[96m', // 亮青
+  green: '\x1b[92m', // 亮绿
+  yellow: '\x1b[93m', // 亮黄
+  red: '\x1b[91m', // 亮红
+  magenta: '\x1b[95m', // 亮洋红
+  blue: '\x1b[94m', // 亮蓝
+  dimGray: '\x1b[2;37m', // dim 白色 — 比 90 在深色背景上更可读
 };
 
 const LEVEL_COLORS = {
   error: C.red,
-  warn:  C.yellow,
-  info:  C.green,
+  warn: C.yellow,
+  info: C.green,
   debug: C.blue,
 };
 
@@ -37,23 +44,32 @@ const LEVEL_COLORS = {
  * - 其他 info/debug: 一行精简格式
  */
 const compactConsoleFormat = winston.format.printf(({ level, message, timestamp, ...meta }) => {
-  const ts = new Date(timestamp).toLocaleTimeString('en-US', { hour12: false, hour: '2-digit', minute: '2-digit', second: '2-digit' });
+  const ts = new Date(timestamp).toLocaleTimeString('en-US', {
+    hour12: false,
+    hour: '2-digit',
+    minute: '2-digit',
+    second: '2-digit',
+  });
+  // biome-ignore lint/suspicious/noControlCharactersInRegex: intentional ANSI escape sequence stripping
   const rawLevel = level.replace(/\u001b\[\d+m/g, ''); // 去 ANSI
   const lc = LEVEL_COLORS[rawLevel] || C.gray;
 
   // 静音高频噪音日志
-  if (rawLevel === 'info' && MUTED_PREFIXES.some(p => message.startsWith(p))) {
+  if (rawLevel === 'info' && MUTED_PREFIXES.some((p) => message.startsWith(p))) {
     return ''; // 返回空字符串会被 winston 跳过
   }
 
   // 判断是否为 Agent 相关日志
-  const isAgentLog = AGENT_TAGS.some(tag => message.includes(tag) || message.startsWith(`[${tag}]`));
+  const isAgentLog = AGENT_TAGS.some(
+    (tag) => message.includes(tag) || message.startsWith(`[${tag}]`)
+  );
 
   if (isAgentLog) {
     // ChatAgent 日志 — 高亮显示
-    const metaStr = Object.keys(meta).length > 0
-      ? ' ' + JSON.stringify(meta, null, 0).replace(/"/g, '').replace(/,/g, ', ')
-      : '';
+    const metaStr =
+      Object.keys(meta).length > 0
+        ? ` ${JSON.stringify(meta, null, 0).replace(/"/g, '').replace(/,/g, ', ')}`
+        : '';
     return `${C.cyan}${ts}${C.reset} ${C.magenta}⚡ ${message}${C.reset}${metaStr ? `${C.dimGray}${metaStr}${C.reset}` : ''}`;
   }
 
@@ -62,17 +78,20 @@ const compactConsoleFormat = winston.format.printf(({ level, message, timestamp,
     const { method, path: reqPath, statusCode, duration } = meta;
     const status = Number(statusCode);
     const sc = status >= 500 ? C.red : status >= 400 ? C.yellow : C.dimGray;
-    const dur = parseInt(duration) > 1000 ? `${C.yellow}${duration}${C.reset}` : `${C.dimGray}${duration}${C.reset}`;
+    const dur =
+      parseInt(duration) > 1000
+        ? `${C.yellow}${duration}${C.reset}`
+        : `${C.dimGray}${duration}${C.reset}`;
     return `${C.dimGray}${ts}${C.reset} ${lc}${rawLevel}${C.reset} ${C.dimGray}${method}${C.reset} ${C.gray}${reqPath}${C.reset} ${sc}${statusCode}${C.reset} ${dur}`;
   }
 
   if (rawLevel === 'warn') {
-    const metaStr = Object.keys(meta).length > 0 ? ' ' + JSON.stringify(meta) : '';
+    const metaStr = Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : '';
     return `${C.gray}${ts}${C.reset} ${C.yellow}${C.bold}warn${C.reset} ${C.yellow}${message}${C.reset}${metaStr ? `${C.dimGray}${metaStr}${C.reset}` : ''}`;
   }
 
   if (rawLevel === 'error') {
-    const metaStr = Object.keys(meta).length > 0 ? ' ' + JSON.stringify(meta) : '';
+    const metaStr = Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : '';
     return `${C.gray}${ts}${C.reset} ${C.red}${C.bold}error${C.reset} ${C.red}${message}${C.reset}${metaStr ? `${C.dimGray}${metaStr}${C.reset}` : ''}`;
   }
 
@@ -96,7 +115,7 @@ export class Logger {
   static getInstance(config = {}) {
     if (!this.instance) {
       const logsDir = config.file?.path || './logs';
-      
+
       // 确保日志目录存在
       if (!fs.existsSync(logsDir)) {
         fs.mkdirSync(logsDir, { recursive: true });
@@ -111,10 +130,7 @@ export class Logger {
         transports.push(
           new winston.transports.Console({
             stderrLevels: ['error', 'warn', 'info', 'debug'],
-            format: winston.format.combine(
-              winston.format.timestamp(),
-              compactConsoleFormat,
-            ),
+            format: winston.format.combine(winston.format.timestamp(), compactConsoleFormat),
           })
         );
       }

package/lib/infrastructure/monitoring/ErrorTracker.js

@@ -3,9 +3,9 @@
  * 捕获、记录和分析应用程序错误
  */
 
+import fs from 'node:fs';
+import path from 'node:path';
 import Logger from '../logging/Logger.js';
-import fs from 'fs';
-import path from 'path';
 
 export class ErrorTracker {
   constructor(options = {}) {
@@ -29,7 +29,9 @@ export class ErrorTracker {
 
     // 定期生成错误报告（unref 避免阻止进程退出）
     this.reportInterval = setInterval(() => this._generateReport(), 60000);
-    if (this.reportInterval.unref) this.reportInterval.unref();
+    if (this.reportInterval.unref) {
+      this.reportInterval.unref();
+    }
   }
 
   /**
@@ -139,10 +141,10 @@ export class ErrorTracker {
       const fileName = `errors-${date}.log`;
       const filePath = path.join(this.config.logDirectory, fileName);
 
-      const logEntry = JSON.stringify({
+      const logEntry = `${JSON.stringify({
         ...errorData,
         _timestamp: Date.now(),
-      }) + '\n';
+      })}\n`;
 
       fs.appendFileSync(filePath, logEntry, 'utf8');
     } catch (error) {

package/lib/infrastructure/monitoring/PerformanceMonitor.js

@@ -29,7 +29,9 @@ export class PerformanceMonitor {
 
     // 定期计算统计数据（unref 避免阻止进程退出）
     this.statsInterval = setInterval(() => this.calculateStats(), 30000);
-    if (this.statsInterval.unref) this.statsInterval.unref();
+    if (this.statsInterval.unref) {
+      this.statsInterval.unref();
+    }
   }
 
   /**
@@ -79,11 +81,17 @@ export class PerformanceMonitor {
     if (!this.metrics.endpoints.has(route)) {
       if (this.metrics.endpoints.size >= 500) {
         // 淘汰最少访问的端点
-        let minKey = null, minCount = Infinity;
+        let minKey = null,
+          minCount = Infinity;
         for (const [k, v] of this.metrics.endpoints) {
-          if (v.count < minCount) { minCount = v.count; minKey = k; }
+          if (v.count < minCount) {
+            minCount = v.count;
+            minKey = k;
+          }
+        }
+        if (minKey) {
+          this.metrics.endpoints.delete(minKey);
         }
-        if (minKey) this.metrics.endpoints.delete(minKey);
       }
       this.metrics.endpoints.set(route, {
         count: 0,

package/lib/infrastructure/paths/HeaderResolver.js

@@ -1,5 +1,5 @@
-import path from 'node:path';
 import fs from 'node:fs';
+import path from 'node:path';
 import * as PathFinder from './PathFinder.js';
 
 /**
@@ -32,12 +32,18 @@ export function parseImportLine(headerStr) {
  * 解析单个 import 的相对路径
  */
 export async function resolveHeaderRelativePath(headerStr, targetRootDir) {
-  if (!targetRootDir) return undefined;
+  if (!targetRootDir) {
+    return undefined;
+  }
   const parsed = parseImportLine(headerStr);
-  if (!parsed) return undefined;
+  if (!parsed) {
+    return undefined;
+  }
   const { moduleName, headerName } = parsed;
   const headerPath = await PathFinder.findSubHeaderPath(targetRootDir, headerName, moduleName);
-  if (!headerPath) return undefined;
+  if (!headerPath) {
+    return undefined;
+  }
   return path.relative(targetRootDir, headerPath);
 }
 
@@ -48,7 +54,9 @@ export function determineModuleNameFromPath(filePath, packageInfo) {
   const relativePath = path.relative(packageInfo.path, filePath);
   const segments = relativePath.split(path.sep);
   for (let i = segments.length - 1; i >= 0; i--) {
-    if (packageInfo.targets?.includes(segments[i])) return segments[i];
+    if (packageInfo.targets?.includes(segments[i])) {
+      return segments[i];
+    }
   }
   return packageInfo.targets?.[0] || packageInfo.name || null;
 }
@@ -71,7 +79,7 @@ export async function resolveHeadersForText(projectRoot, relativePath, text) {
   const importRegex = /^(?:#import|import)\s+.*$/gm;
   let headers = (text.match(importRegex) || []).filter(Boolean);
   let headerPaths = targetRootDir
-    ? await Promise.all(headers.map(h => resolveHeaderRelativePath(h, targetRootDir)))
+    ? await Promise.all(headers.map((h) => resolveHeaderRelativePath(h, targetRootDir)))
     : [];
 
   // 如果 .m/.mm 无 import，尝试推断同名 .h
@@ -80,10 +88,18 @@ export async function resolveHeadersForText(projectRoot, relativePath, text) {
     const headerNameWithoutExt = path.basename(fullPath, ext);
     const packagePath = await PathFinder.findPackageSwiftPath(fullPath);
     const packageInfo = packagePath ? await PathFinder.parsePackageSwift(packagePath) : null;
-    if (packageInfo) moduleName = determineModuleNameFromPath(fullPath, packageInfo);
-    const headerPath = await PathFinder.findSubHeaderPath(targetRootDir, headerNameWithoutExt, moduleName);
+    if (packageInfo) {
+      moduleName = determineModuleNameFromPath(fullPath, packageInfo);
+    }
+    const headerPath = await PathFinder.findSubHeaderPath(
+      targetRootDir,
+      headerNameWithoutExt,
+      moduleName
+    );
     if (headerPath) {
-      headers = [`#import <${moduleName || path.basename(targetRootDir)}/${headerNameWithoutExt}.h>`];
+      headers = [
+        `#import <${moduleName || path.basename(targetRootDir)}/${headerNameWithoutExt}.h>`,
+      ];
       headerPaths = [path.relative(targetRootDir, headerPath)];
     }
   }

package/lib/infrastructure/paths/PathFinder.js

@@ -1,5 +1,5 @@
-import path from 'node:path';
 import fs from 'node:fs';
+import path from 'node:path';
 
 /**
  * PathFinder — 轻量级路径发现工具（V2 ESM）
@@ -21,9 +21,13 @@ export async function findTargetRootDir(filePath) {
           return current;
         }
       }
-    } catch { break; }
+    } catch {
+      break;
+    }
     const parent = path.dirname(current);
-    if (parent === current) break;
+    if (parent === current) {
+      break;
+    }
     current = parent;
   }
   return null;
@@ -36,9 +40,13 @@ export async function findPackageSwiftPath(filePath) {
   let current = path.dirname(path.resolve(filePath));
   for (let i = 0; i < 15; i++) {
     const candidate = path.join(current, 'Package.swift');
-    if (fs.existsSync(candidate)) return candidate;
+    if (fs.existsSync(candidate)) {
+      return candidate;
+    }
     const parent = path.dirname(current);
-    if (parent === current) break;
+    if (parent === current) {
+      break;
+    }
     current = parent;
   }
   return null;
@@ -73,14 +81,18 @@ export async function parsePackageSwift(packagePath) {
  * @returns {Promise<string|null>}
  */
 export async function findSubHeaderPath(rootDir, headerName, moduleName) {
-  if (!rootDir || !headerName) return null;
+  if (!rootDir || !headerName) {
+    return null;
+  }
   const target = `${headerName}.h`;
 
   // 优先在模块名子目录下找
   if (moduleName) {
     const modDir = path.join(rootDir, 'Sources', moduleName);
     const found = _findFile(modDir, target);
-    if (found) return found;
+    if (found) {
+      return found;
+    }
   }
 
   // 全局搜索
@@ -88,18 +100,28 @@ export async function findSubHeaderPath(rootDir, headerName, moduleName) {
 }
 
 function _findFile(dir, filename, maxDepth = 8, depth = 0) {
-  if (depth > maxDepth || !fs.existsSync(dir)) return null;
+  if (depth > maxDepth || !fs.existsSync(dir)) {
+    return null;
+  }
   try {
     for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-      if (entry.name.startsWith('.')) continue;
+      if (entry.name.startsWith('.')) {
+        continue;
+      }
       const full = path.join(dir, entry.name);
-      if (entry.isFile() && entry.name === filename) return full;
+      if (entry.isFile() && entry.name === filename) {
+        return full;
+      }
       if (entry.isDirectory()) {
         const found = _findFile(full, filename, maxDepth, depth + 1);
-        if (found) return found;
+        if (found) {
+          return found;
+        }
       }
     }
-  } catch { /* ignore */ }
+  } catch {
+    /* ignore */
+  }
   return null;
 }