autosnippet 3.2.9 → 3.2.11

package/lib/service/guard/GuardCrossFileChecks.js

@@ -1,326 +0,0 @@
-/**
- * GuardCrossFileChecks - Guard 跨文件检查
- *
- * 从 GuardCheckEngine._runCrossFileChecks 拆分
- * 包含: 跨文件规则检查 + 路径归一化工具
- */
-
-/**
- * 解析相对 import 路径为归一化路径（去掉扩展名）
- * @param {string} fromDir - 当前文件目录
- * @param {string} importPath - 相对路径如 './foo' 或 '../bar/baz'
- * @returns {string|null}
- */
-export function resolveImportPath(fromDir, importPath) {
-  try {
-    const parts = `${fromDir}/${importPath}`.split('/');
-    const resolved = [];
-    for (const p of parts) {
-      if (p === '.' || p === '') {
-        continue;
-      }
-      if (p === '..') {
-        resolved.pop();
-        continue;
-      }
-      resolved.push(p);
-    }
-    // 去掉扩展名归一化
-    let result = resolved.join('/');
-    result = result.replace(/\.(js|ts|jsx|tsx|mjs|mts)$/, '');
-    // 移除 /index 后缀（index barrel 导入）
-    result = result.replace(/\/index$/, '');
-    return result;
-  } catch {
-    return null;
-  }
-}
-
-/**
- * 归一化文件路径（去扩展名，用于 import 比较）
- * @param {string} filePath
- * @returns {string}
- */
-export function normalizeFilePath(filePath) {
-  return filePath.replace(/\.(js|ts|jsx|tsx|mjs|mts)$/, '').replace(/\/index$/, '');
-}
-
-/**
- * 跨文件检查 — 需要多文件上下文才能发现的问题
- * @param {Array<{path: string, content: string}>} files
- * @param {object} options
- * @param {string[]} [options.disabledRules] - 禁用的规则 ID 列表
- * @returns {Array<{ruleId, message, severity, locations}>}
- */
-export function runCrossFileChecks(files, options = {}) {
-  const violations = [];
-  const disabledSet = new Set(options.disabledRules || []);
-  const isDisabled = (ruleId) => disabledSet.has(ruleId);
-
-  // ── ObjC Category 跨文件重名检查 ──
-  if (!isDisabled('objc-cross-file-duplicate-category')) {
-    const categoryMap = new Map();
-    const categoryRegex = /@interface\s+(\w+)\s*\(\s*(\w+)\s*\)/g;
-
-    for (const { path: filePath, content } of files) {
-      const ext = filePath.split('.').pop()?.toLowerCase();
-      if (ext !== 'm' && ext !== 'mm' && ext !== 'h') {
-        continue;
-      }
-
-      const lines = content.split(/\r?\n/);
-      for (let i = 0; i < lines.length; i++) {
-        categoryRegex.lastIndex = 0;
-        let m;
-        while ((m = categoryRegex.exec(lines[i])) !== null) {
-          const key = `${m[1]}(${m[2]})`;
-          if (!categoryMap.has(key)) {
-            categoryMap.set(key, []);
-          }
-          categoryMap.get(key).push({
-            filePath,
-            line: i + 1,
-            snippet: lines[i].trim().slice(0, 120),
-          });
-        }
-      }
-    }
-
-    for (const [key, locations] of categoryMap) {
-      if (locations.length <= 1) {
-        continue;
-      }
-
-      const hFiles = locations.filter((l) => l.filePath.endsWith('.h'));
-      const mFiles = locations.filter((l) => !l.filePath.endsWith('.h'));
-      const hasDuplicateH = hFiles.length > 1;
-      const hasDuplicateM = mFiles.length > 1;
-      const tooMany = locations.length > 2;
-
-      if (hasDuplicateH || hasDuplicateM || tooMany) {
-        const conflictLocations = tooMany
-          ? locations
-          : hasDuplicateH && hasDuplicateM
-            ? locations
-            : hasDuplicateH
-              ? hFiles
-              : mFiles;
-
-        violations.push({
-          ruleId: 'objc-cross-file-duplicate-category',
-          message: `Category ${key} 在 ${conflictLocations.length} 个文件中重复声明，可能导致方法覆盖或未定义行为`,
-          severity: 'warning',
-          locations: conflictLocations,
-        });
-      }
-    }
-  } // end isDisabled('objc-cross-file-duplicate-category')
-
-  // ── JS/TS 循环依赖检查 ──
-  // 检测 A imports B 且 B imports A 的直接循环
-  if (!isDisabled('js-circular-import')) {
-    const jsImportMap = new Map(); // filePath → Set<importedPath>
-    const jsExts = new Set(['js', 'ts', 'jsx', 'tsx', 'mjs', 'mts']);
-    const importRegex =
-      /(?:import\s+.+?\s+from\s+['"](.+?)['"]|require\s*\(\s*['"](.+?)['"]\s*\))/g;
-
-    for (const { path: filePath, content } of files) {
-      const ext = filePath.split('.').pop()?.toLowerCase();
-      if (!jsExts.has(ext)) {
-        continue;
-      }
-
-      const imports = new Set();
-      const lines = content.split(/\r?\n/);
-      for (const line of lines) {
-        importRegex.lastIndex = 0;
-        let m;
-        while ((m = importRegex.exec(line)) !== null) {
-          const importPath = m[1] || m[2];
-          if (importPath.startsWith('.')) {
-            // 解析相对路径为归一化 key
-            const dir = filePath.substring(0, filePath.lastIndexOf('/'));
-            const resolved = resolveImportPath(dir, importPath);
-            if (resolved) {
-              imports.add(resolved);
-            }
-          }
-        }
-      }
-      if (imports.size > 0) {
-        jsImportMap.set(normalizeFilePath(filePath), imports);
-      }
-    }
-
-    // 检测直接双向循环: A→B 且 B→A
-    const reportedCycles = new Set();
-    for (const [fileA, importsA] of jsImportMap) {
-      for (const depB of importsA) {
-        const importsB = jsImportMap.get(depB);
-        if (importsB?.has(fileA)) {
-          const cycleKey = [fileA, depB].sort().join(' <-> ');
-          if (!reportedCycles.has(cycleKey)) {
-            reportedCycles.add(cycleKey);
-            violations.push({
-              ruleId: 'js-circular-import',
-              message: `检测到循环依赖，两个模块互相导入可能导致运行时 undefined`,
-              severity: 'warning',
-              locations: [
-                { filePath: fileA, line: 1, snippet: `imports ${depB.split('/').pop()}` },
-                { filePath: depB, line: 1, snippet: `imports ${fileA.split('/').pop()}` },
-              ],
-            });
-          }
-        }
-      }
-    }
-  } // end isDisabled('js-circular-import')
-
-  // ── Java/Kotlin 同名类跨文件检查 ──
-  if (!isDisabled('java-duplicate-class-name')) {
-    const classMap = new Map(); // className → [{filePath, line, snippet}]
-    const javaClassRegex = /(?:public\s+)?(?:abstract\s+)?(?:final\s+)?class\s+(\w+)/;
-    const jkExts = new Set(['java', 'kt']);
-
-    for (const { path: filePath, content } of files) {
-      const ext = filePath.split('.').pop()?.toLowerCase();
-      if (!jkExts.has(ext)) {
-        continue;
-      }
-
-      const lines = content.split(/\r?\n/);
-      for (let i = 0; i < lines.length; i++) {
-        const m = javaClassRegex.exec(lines[i]);
-        if (m) {
-          const className = m[1];
-          if (!classMap.has(className)) {
-            classMap.set(className, []);
-          }
-          classMap.get(className).push({
-            filePath,
-            line: i + 1,
-            snippet: lines[i].trim().slice(0, 120),
-          });
-        }
-      }
-    }
-
-    for (const [className, locations] of classMap) {
-      if (locations.length > 1) {
-        violations.push({
-          ruleId: 'java-duplicate-class-name',
-          message: `类名 "${className}" 在 ${locations.length} 个文件中定义，可能导致导入歧义`,
-          severity: 'info',
-          locations,
-        });
-      }
-    }
-  } // end isDisabled('java-duplicate-class-name')
-
-  // ── Go 多文件 init() 函数检查 ──
-  // 同一 package 下多个文件都有 init()，执行顺序依赖文件名排序，容易出错
-  if (!isDisabled('go-multiple-init')) {
-    const goInitMap = new Map(); // dirPath → [{filePath, line}]
-
-    for (const { path: filePath, content } of files) {
-      if (!filePath.endsWith('.go')) {
-        continue;
-      }
-
-      const lines = content.split(/\r?\n/);
-      for (let i = 0; i < lines.length; i++) {
-        if (/^func\s+init\s*\(\s*\)/.test(lines[i].trim())) {
-          const dir = filePath.substring(0, filePath.lastIndexOf('/'));
-          if (!goInitMap.has(dir)) {
-            goInitMap.set(dir, []);
-          }
-          goInitMap.get(dir).push({
-            filePath,
-            line: i + 1,
-            snippet: lines[i].trim().slice(0, 120),
-          });
-          break; // 每个文件只记录一次
-        }
-      }
-    }
-
-    for (const [dir, locations] of goInitMap) {
-      if (locations.length > 2) {
-        violations.push({
-          ruleId: 'go-multiple-init',
-          message: `同一 package (${dir.split('/').pop()}) 中 ${locations.length} 个文件都定义了 init()，执行顺序依赖文件名排序`,
-          severity: 'info',
-          locations,
-        });
-      }
-    }
-  } // end isDisabled('go-multiple-init')
-
-  // ── Swift Extension 方法跨文件冲突检查 ──
-  if (!isDisabled('swift-cross-file-extension-conflict')) {
-    const swiftExtMethodMap = new Map(); // "TypeName.methodName" → [{filePath, line}]
-    const swiftExtRegex = /extension\s+(\w+)/;
-    const swiftFuncRegex = /func\s+(\w+)\s*\(/;
-
-    for (const { path: filePath, content } of files) {
-      if (!filePath.endsWith('.swift')) {
-        continue;
-      }
-
-      const lines = content.split(/\r?\n/);
-      let currentExt = null;
-      let braceDepth = 0;
-
-      for (let i = 0; i < lines.length; i++) {
-        const extMatch = swiftExtRegex.exec(lines[i]);
-        if (extMatch && !currentExt) {
-          currentExt = extMatch[1];
-          braceDepth = 0;
-        }
-
-        if (currentExt) {
-          for (const ch of lines[i]) {
-            if (ch === '{') {
-              braceDepth++;
-            } else if (ch === '}') {
-              braceDepth--;
-            }
-          }
-
-          const funcMatch = swiftFuncRegex.exec(lines[i]);
-          if (funcMatch && braceDepth >= 1) {
-            const key = `${currentExt}.${funcMatch[1]}`;
-            if (!swiftExtMethodMap.has(key)) {
-              swiftExtMethodMap.set(key, []);
-            }
-            swiftExtMethodMap.get(key).push({
-              filePath,
-              line: i + 1,
-              snippet: lines[i].trim().slice(0, 120),
-            });
-          }
-
-          if (braceDepth <= 0) {
-            currentExt = null;
-          }
-        }
-      }
-    }
-
-    for (const [key, locations] of swiftExtMethodMap) {
-      if (locations.length > 1) {
-        const uniqueFiles = new Set(locations.map((l) => l.filePath));
-        if (uniqueFiles.size > 1) {
-          violations.push({
-            ruleId: 'swift-cross-file-extension-conflict',
-            message: `Extension 方法 ${key} 在 ${uniqueFiles.size} 个文件中定义，可能导致方法冲突`,
-            severity: 'warning',
-            locations,
-          });
-        }
-      }
-    }
-  } // end isDisabled('swift-cross-file-extension-conflict')
-
-  return violations;
-}

package/lib/service/guard/GuardFeedbackLoop.js

@@ -1,152 +0,0 @@
-/**
- * GuardFeedbackLoop — Guard ↔ Recipe 闭环联动
- *
- * 功能:
- *   1. 对比当前和历史 violations，检测已修复的违规
- *   2. 已修复违规如有 fixSuggestion → 自动 confirmUsage（记录 Recipe 使用）
- *   3. 集成到 guardAuditFiles MCP handler 和 GuardHandler (FileWatcher)
- */
-
-import Logger from '../../infrastructure/logging/Logger.js';
-
-export class GuardFeedbackLoop {
-  /**
-   * @param {import('./ViolationsStore.js').ViolationsStore} violationsStore
-   * @param {import('../quality/FeedbackCollector.js').FeedbackCollector} feedbackCollector
-   * @param {object} [options]
-   * @param {import('./GuardCheckEngine.js').GuardCheckEngine} [options.guardCheckEngine] - 用于查找规则
-   */
-  constructor(violationsStore, feedbackCollector, options = {}) {
-    this.violationsStore = violationsStore;
-    this.feedbackCollector = feedbackCollector;
-    this.guardCheckEngine = options.guardCheckEngine || null;
-    this.logger = Logger.getInstance();
-  }
-
-  /**
-   * 对比当前和历史 violations，检测已修复的违规
-   * @param {{ violations: Array<{ruleId: string}> }} currentResult - 本次检查结果
-   * @param {string} filePath - 文件路径
-   * @returns {Array<{ ruleId: string, filePath: string, fixRecipeId: string }>} 已修复且有 Recipe 关联的列表
-   */
-  detectFixedViolations(currentResult, filePath) {
-    if (!this.violationsStore) {
-      return [];
-    }
-
-    try {
-      const previousRuns = this.violationsStore.getRunsByFile(filePath);
-      if (previousRuns.length === 0) {
-        return [];
-      }
-
-      // 取最近一次运行结果
-      const lastRun = previousRuns[previousRuns.length - 1];
-      const lastRuleIds = new Set((lastRun.violations || []).map((v) => v.ruleId));
-      const currentRuleIds = new Set((currentResult.violations || []).map((v) => v.ruleId));
-
-      const fixed = [];
-      for (const ruleId of lastRuleIds) {
-        if (!currentRuleIds.has(ruleId)) {
-          // 该规则的违规已消失 → 修复了
-          const fixRecipeId = this._findFixRecipe(ruleId, lastRun.violations);
-          if (fixRecipeId) {
-            fixed.push({ ruleId, filePath, fixRecipeId });
-          }
-        }
-      }
-
-      return fixed;
-    } catch (err) {
-      this.logger.debug(`[GuardFeedbackLoop] detectFixedViolations error: ${err.message}`);
-      return [];
-    }
-  }
-
-  /**
-   * 对已修复的违规自动确认使用
-   * @param {Array<{ ruleId: string, filePath: string, fixRecipeId: string }>} fixedList
-   */
-  autoConfirmUsage(fixedList) {
-    if (!this.feedbackCollector || !fixedList?.length) {
-      return;
-    }
-
-    for (const { ruleId, fixRecipeId, filePath } of fixedList) {
-      try {
-        this.feedbackCollector.record('insert', fixRecipeId, {
-          source: 'guard_fix_detection',
-          automatic: true,
-          ruleId,
-          filePath,
-        });
-        this.logger.info(
-          `[GuardFeedbackLoop] Auto-confirmed usage: recipe=${fixRecipeId} from fixing rule=${ruleId}`
-        );
-      } catch (err) {
-        this.logger.debug(`[GuardFeedbackLoop] autoConfirmUsage error: ${err.message}`);
-      }
-    }
-  }
-
-  /**
-   * 一站式处理：检测修复 + 自动确认
-   * 供 MCP handler、GuardHandler、HTTP guard/file 端点集成调用
-   * @param {{ violations: Array }} currentResult
-   * @param {string} filePath
-   */
-  processFixDetection(currentResult, filePath) {
-    const fixed = this.detectFixedViolations(currentResult, filePath);
-    if (fixed.length > 0) {
-      this.autoConfirmUsage(fixed);
-      this.logger.info(
-        `[GuardFeedbackLoop] Detected ${fixed.length} fixed violations in ${filePath}`
-      );
-    }
-    return fixed;
-  }
-
-  /**
-   * 获取闭环统计数据
-   * @returns {{ totalFixDetected: number, totalConfirmed: number }}
-   */
-  getStats() {
-    return {
-      hasViolationsStore: !!this.violationsStore,
-      hasFeedbackCollector: !!this.feedbackCollector,
-      hasGuardCheckEngine: !!this.guardCheckEngine,
-    };
-  }
-
-  /**
-   * 从 violation 或 GuardCheckEngine 查找 fixRecipeId
-   * 增强：当无显式 fixSuggestion 时，以 ruleId 本身作为 fallback recipeId
-   * 这允许 Knowledge Base 中以 ruleId 命名的条目自动关联
-   */
-  _findFixRecipe(ruleId, violations) {
-    // 先从 violation 本身的 fixSuggestion 查找
-    for (const v of violations || []) {
-      if (v.ruleId === ruleId && v.fixSuggestion) {
-        return v.fixSuggestion.replace(/^recipe:/, '');
-      }
-    }
-
-    // 再从 GuardCheckEngine 的规则定义中查找
-    if (this.guardCheckEngine) {
-      try {
-        const rules = this.guardCheckEngine.getRules();
-        const rule = rules.find((r) => r.id === ruleId);
-        if (rule?.fixSuggestion) {
-          return rule.fixSuggestion.replace(/^recipe:/, '');
-        }
-      } catch {
-        /* ignore */
-      }
-    }
-
-    // fallback: 用 ruleId 本身作为 recipeId — 允许知识库按规则 ID 索引
-    return ruleId || null;
-  }
-}
-
-export default GuardFeedbackLoop;

package/lib/service/guard/GuardPatternUtils.js

@@ -1,187 +0,0 @@
-/**
- * GuardPatternUtils - Guard 模式匹配与掩码工具函数
- *
- * 从 GuardCheckEngine 拆分，包含:
- * - compilePattern: 正则编译（带缓存）
- * - clearPatternCache: 清除正则缓存
- * - buildTestBlockMask: 测试块掩码（Rust #[cfg(test)]）
- * - buildCommentMask: 注释行掩码
- * - detectLanguage: 文件扩展名推断语言
- */
-
-import { LanguageService } from '../../shared/LanguageService.js';
-
-/** @type {Map<string, RegExp>} 已编译的正则缓存 (pattern string → RegExp) */
-const _regexCache = new Map();
-
-/**
- * 编译正则模式（支持 RegExp 对象和 string，带缓存）
- * @param {RegExp|string} pattern
- * @returns {RegExp}
- */
-export function compilePattern(pattern) {
-  if (pattern instanceof RegExp) {
-    return pattern;
-  }
-  const key = String(pattern);
-  let cached = _regexCache.get(key);
-  if (!cached) {
-    cached = new RegExp(key);
-    _regexCache.set(key, cached);
-  }
-  return cached;
-}
-
-/**
- * 清除正则缓存
- */
-export function clearPatternCache() {
-  _regexCache.clear();
-}
-
-/**
- * 构建内联测试块掩码
- * 目前支持 Rust #[cfg(test)] mod xxx { ... } 块
- * @param {string[]} lines
- * @param {string} language
- * @returns {boolean[]} 每行是否在测试块内
- */
-export function buildTestBlockMask(lines, language) {
-  const mask = new Array(lines.length).fill(false);
-
-  // 目前仅 Rust 需要 — #[cfg(test)] 内联测试模块
-  if (language !== 'rust') {
-    return mask;
-  }
-
-  let inTestBlock = false;
-  let braceDepth = 0;
-
-  for (let i = 0; i < lines.length; i++) {
-    const trimmed = lines[i].trimStart();
-
-    if (!inTestBlock) {
-      // 检测 #[cfg(test)] 属性行
-      if (/^#\[cfg\(test\)\]/.test(trimmed)) {
-        // 向后找 mod xxx { — 标记为测试块起始
-        // 可能在同一行: #[cfg(test)] mod tests {
-        // 也可能在下一行: mod tests {
-        const restOfLine = trimmed.slice('#[cfg(test)]'.length).trim();
-        if (/^mod\s+\w+/.test(restOfLine)) {
-          // 同一行有 mod 声明
-          inTestBlock = true;
-          braceDepth = 0;
-          // 计算本行的花括号
-          for (const ch of lines[i]) {
-            if (ch === '{') {
-              braceDepth++;
-            } else if (ch === '}') {
-              braceDepth--;
-            }
-          }
-          mask[i] = true;
-          if (braceDepth <= 0) {
-            inTestBlock = false; // 单行 mod 声明 (mod tests;)
-          }
-          continue;
-        }
-        // 检查下一行是否是 mod xxx {
-        if (i + 1 < lines.length && /^\s*mod\s+\w+/.test(lines[i + 1])) {
-          mask[i] = true; // #[cfg(test)] 行本身也标记
-          inTestBlock = true;
-          braceDepth = 0;
-        }
-        // 单行 #[cfg(test)] 但后面不是 mod — 不处理
-      }
-    } else {
-      // 正在测试块内 — 追踪花括号深度
-      mask[i] = true;
-      for (const ch of lines[i]) {
-        if (ch === '{') {
-          braceDepth++;
-        } else if (ch === '}') {
-          braceDepth--;
-        }
-      }
-      if (braceDepth <= 0) {
-        inTestBlock = false; // 测试块结束
-      }
-    }
-  }
-
-  return mask;
-}
-
-/**
- * 构建注释行掩码 — 识别行注释和块注释内部行
- *
- * 支持的注释形式:
- *   // 行注释,  /// 文档注释,  //! 内部文档注释  (C/Java/JS/TS/Go/Rust/Swift/Kotlin/Dart)
- *   # 行注释  (Python)
- *   /* ... * / 块注释  (C/Java/JS/TS/Go/Rust/Swift/Kotlin)
- *   \"\"\" ... \"\"\"  (Python doc-string — 简化: 整行以 \"\"\" 开头的行)
- *
- * @param {string[]} lines
- * @param {string} language
- * @returns {boolean[]} 每行是否为注释行
- */
-export function buildCommentMask(lines, language) {
-  const mask = new Array(lines.length).fill(false);
-  let inBlock = false; // 是否在 /* ... */ 块内
-
-  const usesHash = language === 'python'; // Python 用 # 注释
-  const usesSlash = !usesHash; // 其他语言用 //
-
-  for (let i = 0; i < lines.length; i++) {
-    const trimmed = lines[i].trimStart();
-
-    // 块注释延续
-    if (inBlock) {
-      mask[i] = true;
-      if (trimmed.includes('*/')) {
-        inBlock = false;
-      }
-      continue;
-    }
-
-    // 块注释开始（同行不闭合）
-    if (usesSlash && /^\s*\/\*/.test(lines[i])) {
-      mask[i] = true;
-      if (!trimmed.includes('*/')) {
-        inBlock = true;
-      }
-      continue;
-    }
-
-    // 行注释: // 或 /// 或 //!
-    if (usesSlash && /^\s*\/\//.test(lines[i])) {
-      mask[i] = true;
-      continue;
-    }
-
-    // Python 行注释: #
-    if (usesHash && /^\s*#/.test(lines[i])) {
-      mask[i] = true;
-      continue;
-    }
-
-    // Python docstring 行 (简化: 整行以 """ 或 ''' 开头)
-    if (usesHash && /^\s*("""|''')/.test(lines[i])) {
-      mask[i] = true;
-    }
-  }
-
-  return mask;
-}
-
-/**
- * 从文件扩展名推断语言
- */
-export function detectLanguage(filePath) {
-  if (!filePath) {
-    return 'unknown';
-  }
-  const lang = LanguageService.inferLang(filePath);
-  // 向后兼容: Guard 内置规则使用 'objc' 而非 'objectivec'
-  return LanguageService.toGuardLangId(lang);
-}