@chongyan/autospec 1.0.1

package/plugins/hooks/lib/benchmarks/change-detector.js

@@ -0,0 +1,390 @@
+/**
+ * Benchmarks Change Detector
+ * 改动检测器 - 负责检测阶段产出物变更，触发 benchmarks 重新评测
+ */
+
+const fs = require('fs');
+const path = require('path');
+const crypto = require('crypto');
+const { EventEmitter } = require('events');
+
+class ChangeDetector extends EventEmitter {
+  constructor(projectRoot) {
+    super();
+    this.projectRoot = projectRoot;
+    this.statePath = path.join(projectRoot, '.autospec', 'benchmarks', '.state');
+    this.watchedPaths = new Map();
+    this.debounceTimers = new Map();
+    this.isWatching = false;
+  }
+
+  /**
+   * 初始化检测器
+   */
+  init() {
+    if (!fs.existsSync(this.statePath)) {
+      fs.mkdirSync(this.statePath, { recursive: true });
+    }
+    this.loadState();
+    return this;
+  }
+
+  /**
+   * 加载上次状态
+   */
+  loadState() {
+    const stateFile = path.join(this.statePath, 'file-hashes.json');
+    if (fs.existsSync(stateFile)) {
+      try {
+        const data = JSON.parse(fs.readFileSync(stateFile, 'utf8'));
+        this.previousState = data;
+      } catch {
+        this.previousState = {};
+      }
+    } else {
+      this.previousState = {};
+    }
+  }
+
+  /**
+   * 保存当前状态
+   */
+  saveState(currentState) {
+    const stateFile = path.join(this.statePath, 'file-hashes.json');
+    fs.writeFileSync(stateFile, JSON.stringify(currentState, null, 2));
+    this.previousState = currentState;
+  }
+
+  /**
+   * 计算文件哈希
+   */
+  calculateHash(filePath) {
+    try {
+      const content = fs.readFileSync(filePath, 'utf8');
+      return crypto.createHash('sha256').update(content).digest('hex');
+    } catch {
+      return null;
+    }
+  }
+
+  /**
+   * 获取阶段产出物清单
+   */
+  getStageArtifacts(stage) {
+    const artifactPatterns = {
+      exploration: [
+        'specs/**/clarifications.md',
+        'specs/**/requirement.md'
+      ],
+      requirement: [
+        'specs/**/requirement.md',
+        'specs/**/user-stories.md',
+        'specs/**/assumptions.md'
+      ],
+      design: [
+        'specs/**/design.md',
+        'specs/**/design/*.md',
+        'specs/**/contracts/*.yaml',
+        'specs/**/contracts/*.json',
+        'specs/**/data-model.md'
+      ],
+      implementation: [
+        'src/**/*',
+        'lib/**/*',
+        'app/**/*',
+        'tests/**/*',
+        'specs/**/docs/api.md'
+      ],
+      testing: [
+        'tests/**/*',
+        'coverage/**/*',
+        'specs/**/test-reports/**/*'
+      ]
+    };
+
+    return artifactPatterns[stage] || [];
+  }
+
+  /**
+   * 扫描产出物文件
+   */
+  scanArtifacts(patterns) {
+    const files = [];
+
+    for (const pattern of patterns) {
+      const matchedFiles = this.globSync(pattern);
+      files.push(...matchedFiles);
+    }
+
+    return [...new Set(files)]; // 去重
+  }
+
+  /**
+   * 简单的 glob 实现
+   */
+  globSync(pattern) {
+    const files = [];
+    const regex = this.globToRegex(pattern);
+
+    const traverse = (dir, relativePath = '') => {
+      const fullPath = path.join(this.projectRoot, dir);
+
+      if (!fs.existsSync(fullPath)) {
+        return;
+      }
+
+      const entries = fs.readdirSync(fullPath, { withFileTypes: true });
+
+      for (const entry of entries) {
+        const entryRelativePath = path.join(relativePath, entry.name);
+        const entryFullPath = path.join(fullPath, entry.name);
+
+        if (entry.isDirectory()) {
+          // 跳过特定目录
+          if (['node_modules', '.git', 'dist', 'build', '.autospec'].includes(entry.name)) {
+            continue;
+          }
+          traverse(entryFullPath, entryRelativePath);
+        } else if (entry.isFile()) {
+          if (regex.test(entryRelativePath)) {
+            files.push(entryRelativePath);
+          }
+        }
+      }
+    };
+
+    // 确定起始目录
+    const baseDir = pattern.split('/')[0];
+    if (fs.existsSync(path.join(this.projectRoot, baseDir))) {
+      traverse(path.join(this.projectRoot, baseDir), baseDir);
+    }
+
+    return files;
+  }
+
+  /**
+   * 将 glob 模式转换为正则表达式
+   */
+  globToRegex(pattern) {
+    const escaped = pattern
+      .replace(/\*\*/g, '<<<DOUBLESTAR>>>')
+      .replace(/\*/g, '[^/]*')
+      .replace(/<<<DOUBLESTAR>>>/g, '.*')
+      .replace(/\?/g, '.')
+      .replace(/\./g, '\\.');
+
+    return new RegExp(`^${escaped}$`);
+  }
+
+  /**
+   * 检测变更
+   */
+  detectChanges(stage) {
+    const patterns = this.getStageArtifacts(stage);
+    const currentFiles = this.scanArtifacts(patterns);
+    const currentState = {};
+    const changes = {
+      stage,
+      timestamp: new Date().toISOString(),
+      files_modified: [],
+      files_added: [],
+      files_deleted: [],
+      content_changed: [],
+      has_changes: false
+    };
+
+    // 计算当前状态
+    for (const file of currentFiles) {
+      const fullPath = path.join(this.projectRoot, file);
+      const hash = this.calculateHash(fullPath);
+      if (hash) {
+        currentState[file] = hash;
+      }
+    }
+
+    // 对比状态
+    const previousFiles = Object.keys(this.previousState);
+    const currentFilesSet = new Set(currentFiles);
+
+    // 检测新增文件
+    for (const file of currentFiles) {
+      if (!this.previousState[file]) {
+        changes.files_added.push(file);
+        changes.has_changes = true;
+      }
+    }
+
+    // 检测删除文件
+    for (const file of previousFiles) {
+      if (!currentFilesSet.has(file)) {
+        changes.files_deleted.push(file);
+        changes.has_changes = true;
+      }
+    }
+
+    // 检测内容变更
+    for (const file of currentFiles) {
+      if (this.previousState[file] && this.previousState[file] !== currentState[file]) {
+        changes.content_changed.push(file);
+        changes.files_modified.push(file);
+        changes.has_changes = true;
+      }
+    }
+
+    // 保存当前状态
+    this.saveState(currentState);
+
+    return changes;
+  }
+
+  /**
+   * 检测特定文件的变更
+   */
+  detectFileChange(filePath) {
+    const relativePath = path.relative(this.projectRoot, filePath);
+    const currentHash = this.calculateHash(filePath);
+    const previousHash = this.previousState[relativePath];
+
+    if (!previousHash) {
+      return { type: 'added', file: relativePath };
+    }
+
+    if (currentHash !== previousHash) {
+      return { type: 'modified', file: relativePath };
+    }
+
+    return null;
+  }
+
+  /**
+   * 启动文件监听
+   */
+  watch(stage, options = {}) {
+    if (this.isWatching) {
+      return this;
+    }
+
+    const patterns = this.getStageArtifacts(stage);
+    const debounceMs = options.debounceMs || 5000;
+
+    // 使用轮询方式监听（跨平台兼容）
+    const pollInterval = options.pollInterval || 2000;
+
+    this.watchInterval = setInterval(() => {
+      const changes = this.detectChanges(stage);
+
+      if (changes.has_changes) {
+        // 防抖处理
+        if (this.debounceTimers.has(stage)) {
+          clearTimeout(this.debounceTimers.get(stage));
+        }
+
+        const timer = setTimeout(() => {
+          this.emit('change', changes);
+          this.debounceTimers.delete(stage);
+        }, debounceMs);
+
+        this.debounceTimers.set(stage, timer);
+      }
+    }, pollInterval);
+
+    this.isWatching = true;
+    this.watchedStage = stage;
+
+    return this;
+  }
+
+  /**
+   * 停止监听
+   */
+  unwatch() {
+    if (this.watchInterval) {
+      clearInterval(this.watchInterval);
+      this.watchInterval = null;
+    }
+
+    // 清除所有防抖定时器
+    for (const timer of this.debounceTimers.values()) {
+      clearTimeout(timer);
+    }
+    this.debounceTimers.clear();
+
+    this.isWatching = false;
+    this.watchedStage = null;
+
+    return this;
+  }
+
+  /**
+   * 手动触发检测
+   */
+  triggerCheck(stage) {
+    const changes = this.detectChanges(stage);
+
+    if (changes.has_changes) {
+      this.emit('change', changes);
+    }
+
+    return changes;
+  }
+
+  /**
+   * 获取文件统计信息
+   */
+  getFileStats(filePath) {
+    try {
+      const stats = fs.statSync(filePath);
+      return {
+        size: stats.size,
+        mtime: stats.mtime.toISOString(),
+        ctime: stats.ctime.toISOString()
+      };
+    } catch {
+      return null;
+    }
+  }
+
+  /**
+   * 生成变更摘要
+   */
+  generateChangeSummary(changes) {
+    const parts = [];
+
+    if (changes.files_added.length > 0) {
+      parts.push(`新增 ${changes.files_added.length} 个文件`);
+    }
+
+    if (changes.content_changed.length > 0) {
+      parts.push(`修改 ${changes.content_changed.length} 个文件`);
+    }
+
+    if (changes.files_deleted.length > 0) {
+      parts.push(`删除 ${changes.files_deleted.length} 个文件`);
+    }
+
+    return parts.join('，') || '无变更';
+  }
+
+  /**
+   * 重置状态
+   */
+  reset() {
+    this.previousState = {};
+    this.saveState({});
+    return this;
+  }
+
+  /**
+   * 获取监听状态
+   */
+  getStatus() {
+    return {
+      isWatching: this.isWatching,
+      watchedStage: this.watchedStage,
+      watchedFilesCount: Object.keys(this.previousState).length,
+      debouncePending: this.debounceTimers.size
+    };
+  }
+}
+
+module.exports = ChangeDetector;