autosnippet 2.5.0 → 2.7.0

package/lib/core/ast/ProjectGraph.js

@@ -0,0 +1,599 @@
+/**
+ * @module ProjectGraph
+ * @description 基于 Tree-sitter 的项目结构图 — v3.0 AI-First Bootstrap 核心组件
+ *
+ * 职责:
+ * 1. 扫描项目源码文件 → 调用 AstAnalyzer 解析
+ * 2. 构建 类/协议/Category 的查询索引
+ * 3. 提供查询 API 供 Analyst Agent 工具调用
+ *
+ * 生命周期:
+ * - 在 Bootstrap Phase 1 一次性构建 (ProjectGraph.build())
+ * - 所有维度共享同一个实例
+ * - 构建后只读
+ */
+
+import { analyzeFile, isAvailable } from '../AstAnalyzer.js';
+import fs from 'fs';
+import path from 'path';
+
+// ──────────────────────────────────────────────────────────────────
+// 默认配置
+// ──────────────────────────────────────────────────────────────────
+
+const DEFAULTS = {
+  maxFiles: 500,
+  maxFileSizeBytes: 500_000,       // 500KB — 跳过超大文件
+  excludePatterns: [
+    'Pods/', 'Carthage/', 'node_modules/', '.build/', 'build/',
+    'DerivedData/', 'vendor/', '.git/', '__tests__/', 'Tests/',
+  ],
+  extensionToLang: {
+    '.m': 'objectivec',
+    '.h': 'objectivec',
+    '.swift': 'swift',
+  },
+};
+
+// ──────────────────────────────────────────────────────────────────
+// ProjectGraph
+// ──────────────────────────────────────────────────────────────────
+
+export default class ProjectGraph {
+
+  /** @type {Map<string, ClassInfo>} */
+  #classes = new Map();
+
+  /** @type {Map<string, ProtocolInfo>} */
+  #protocols = new Map();
+
+  /** @type {Map<string, CategoryInfo[]>} */
+  #categories = new Map();
+
+  /** @type {Map<string, string>} 子类 → 父类 */
+  #inheritance = new Map();
+
+  /** @type {Map<string, Set<string>>} 类 → 遵循的协议集合 */
+  #conformance = new Map();
+
+  /** @type {Map<string, FileSymbols>} 文件路径 → 文件级符号 */
+  #files = new Map();
+
+  /** @type {Map<string, MethodInfo[]>} className → 方法列表 (含 impl 中的方法) */
+  #methodsByClass = new Map();
+
+  /** @type {ProjectOverview} 项目统计缓存 */
+  #overview = null;
+
+  /** @type {string} 项目根目录 */
+  #projectRoot;
+
+  /** @type {number} 构建耗时 ms */
+  #buildTimeMs = 0;
+
+  // ── 静态工厂 ──────────────────────────────────────────────────
+
+  /**
+   * 扫描项目并构建 ProjectGraph
+   * @param {string} projectRoot 项目根目录
+   * @param {object} [options]
+   * @param {number} [options.maxFiles=500]
+   * @param {string[]} [options.excludePatterns]
+   * @param {string[]} [options.extensions] 例如 ['.m', '.h', '.swift']
+   * @param {Function} [options.onProgress] (parsed, total) => void
+   * @param {number} [options.timeoutMs=30000]
+   * @returns {Promise<ProjectGraph>}
+   */
+  static async build(projectRoot, options = {}) {
+    if (!isAvailable()) {
+      throw new Error('Tree-sitter not available — cannot build ProjectGraph');
+    }
+
+    const startTime = Date.now();
+    const opts = { ...DEFAULTS, ...options };
+
+    // 1. 收集文件列表
+    const extToLang = opts.extensionToLang || DEFAULTS.extensionToLang;
+    const extensions = options.extensions
+      ? options.extensions
+      : Object.keys(extToLang);
+
+    const files = collectSourceFiles(projectRoot, extensions, opts);
+
+    // 2. 逐文件解析
+    const graph = new ProjectGraph();
+    graph.#projectRoot = projectRoot;
+    let parsed = 0;
+
+    for (const filePath of files) {
+      if (opts.timeoutMs && (Date.now() - startTime) > opts.timeoutMs) {
+        break; // 超时 — 返回部分结果
+      }
+
+      try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const ext = path.extname(filePath);
+        const lang = extToLang[ext];
+        if (!lang) continue;
+
+        const relativePath = path.relative(projectRoot, filePath);
+        const summary = analyzeFile(content, lang);
+        if (!summary) continue;
+
+        graph.#indexFileSummary(relativePath, summary);
+        parsed++;
+        opts.onProgress?.(parsed, files.length);
+      } catch {
+        // 单文件解析失败不阻塞
+      }
+    }
+
+    // 3. 构建反向索引
+    graph.#buildReverseIndices();
+    graph.#buildTimeMs = Date.now() - startTime;
+
+    return graph;
+  }
+
+  // ── 查询 API ──────────────────────────────────────────────────
+
+  /**
+   * 获取类的完整信息
+   * @param {string} className
+   * @returns {ClassInfo|null}
+   */
+  getClassInfo(className) {
+    return this.#classes.get(className) || null;
+  }
+
+  /**
+   * 获取协议定义 + 所有遵循者
+   * @param {string} protocolName
+   * @returns {ProtocolInfo|null}
+   */
+  getProtocolInfo(protocolName) {
+    return this.#protocols.get(protocolName) || null;
+  }
+
+  /**
+   * 获取继承链 (向上到根类)
+   * @param {string} className
+   * @returns {string[]} [className, parent, grandparent, ...]
+   */
+  getInheritanceChain(className) {
+    const chain = [];
+    let current = className;
+    const visited = new Set();
+    while (current && !visited.has(current)) {
+      chain.push(current);
+      visited.add(current);
+      current = this.#inheritance.get(current) || null;
+    }
+    return chain;
+  }
+
+  /**
+   * 获取直接子类
+   * @param {string} className
+   * @returns {string[]}
+   */
+  getSubclasses(className) {
+    const subs = [];
+    for (const [child, parent] of this.#inheritance) {
+      if (parent === className) subs.push(child);
+    }
+    return subs;
+  }
+
+  /**
+   * 递归获取所有后代类
+   * @param {string} className
+   * @returns {string[]}
+   */
+  getAllDescendants(className) {
+    const result = [];
+    const queue = [className];
+    const visited = new Set();
+    while (queue.length > 0) {
+      const current = queue.shift();
+      if (visited.has(current)) continue;
+      visited.add(current);
+      const subs = this.getSubclasses(current);
+      result.push(...subs);
+      queue.push(...subs);
+    }
+    return result;
+  }
+
+  /**
+   * 获取类的所有 Category 扩展
+   * @param {string} className
+   * @returns {CategoryInfo[]}
+   */
+  getCategoryExtensions(className) {
+    return this.#categories.get(className) || [];
+  }
+
+  /**
+   * 查找覆写了指定方法的所有后代类
+   * @param {string} className
+   * @param {string} methodName 方法名或 selector
+   * @returns {OverrideInfo[]}
+   */
+  getMethodOverrides(className, methodName) {
+    const descendants = this.getAllDescendants(className);
+    const overrides = [];
+
+    for (const desc of descendants) {
+      const methods = this.#methodsByClass.get(desc) || [];
+      const match = methods.find(m =>
+        m.name === methodName || m.selector === methodName
+      );
+      if (match) {
+        overrides.push({
+          className: desc,
+          method: match,
+          filePath: this.#classes.get(desc)?.filePath || 'unknown',
+        });
+      }
+    }
+
+    return overrides;
+  }
+
+  /**
+   * 获取类的所有方法
+   * @param {string} className
+   * @returns {MethodInfo[]}
+   */
+  getClassMethods(className) {
+    return this.#methodsByClass.get(className) || [];
+  }
+
+  /**
+   * 获取文件的符号摘要
+   * @param {string} relativePath
+   * @returns {FileSymbols|null}
+   */
+  getFileSymbols(relativePath) {
+    return this.#files.get(relativePath) || null;
+  }
+
+  /**
+   * 搜索类名 (模糊匹配)
+   * @param {string} query
+   * @param {number} [limit=20]
+   * @returns {string[]}
+   */
+  searchClasses(query, limit = 20) {
+    const lower = query.toLowerCase();
+    const results = [];
+    for (const name of this.#classes.keys()) {
+      if (name.toLowerCase().includes(lower)) {
+        results.push(name);
+        if (results.length >= limit) break;
+      }
+    }
+    return results;
+  }
+
+  /**
+   * 获取项目概览统计
+   * @returns {ProjectOverview}
+   */
+  getOverview() {
+    if (this.#overview) return this.#overview;
+
+    // 按模块 (顶层目录) 统计
+    const classesPerModule = {};
+    const topModules = new Set();
+    const entryPoints = [];
+
+    for (const [filePath, symbols] of this.#files) {
+      const parts = filePath.split('/');
+      const module = parts.length > 1 ? parts[0] : '(root)';
+      topModules.add(module);
+
+      if (!classesPerModule[module]) classesPerModule[module] = 0;
+      classesPerModule[module] += symbols.classes.length;
+
+      // 入口点检测
+      const base = path.basename(filePath);
+      if (/^(AppDelegate|main|SceneDelegate)\.(m|swift)$/.test(base)) {
+        entryPoints.push(filePath);
+      }
+    }
+
+    this.#overview = {
+      totalFiles: this.#files.size,
+      totalClasses: this.#classes.size,
+      totalProtocols: this.#protocols.size,
+      totalCategories: [...this.#categories.values()].reduce((s, arr) => s + arr.length, 0),
+      totalMethods: [...this.#methodsByClass.values()].reduce((s, arr) => s + arr.length, 0),
+      topLevelModules: [...topModules].sort(),
+      entryPoints,
+      classesPerModule,
+      buildTimeMs: this.#buildTimeMs,
+    };
+
+    return this.#overview;
+  }
+
+  /**
+   * 获取所有类名
+   * @returns {string[]}
+   */
+  getAllClassNames() {
+    return [...this.#classes.keys()];
+  }
+
+  /**
+   * 获取所有协议名
+   * @returns {string[]}
+   */
+  getAllProtocolNames() {
+    return [...this.#protocols.keys()];
+  }
+
+  // ── 内部索引构建 ──────────────────────────────────────────────
+
+  /**
+   * 索引单个文件的解析结果
+   */
+  #indexFileSummary(relativePath, summary) {
+    const fileSymbols = {
+      path: relativePath,
+      lang: summary.lang,
+      classes: [],
+      protocols: [],
+      categories: [],
+      imports: summary.imports || [],
+    };
+
+    // 索引类
+    for (const cls of summary.classes) {
+      const classInfo = {
+        name: cls.name,
+        filePath: relativePath,
+        line: cls.line,
+        endLine: cls.endLine,
+        superClass: cls.superclass || null,
+        protocols: cls.protocols || [],
+        properties: [],
+        methods: [],
+        imports: summary.imports || [],
+      };
+
+      // 收集该类的属性
+      for (const prop of (summary.properties || [])) {
+        if (prop.className === cls.name) {
+          classInfo.properties.push({
+            name: prop.name,
+            type: prop.type || 'id',
+            attributes: prop.attributes || [],
+            line: prop.line,
+          });
+        }
+      }
+
+      // 收集该类的方法 (声明 + 定义去重)
+      const methodSet = new Set();
+      for (const m of (summary.methods || [])) {
+        if (m.className === cls.name) {
+          const key = `${m.isClassMethod ? '+' : '-'}${m.name}`;
+          if (!methodSet.has(key)) {
+            methodSet.add(key);
+            classInfo.methods.push({
+              name: m.name,
+              selector: m.selector || m.name,
+              line: m.line,
+              isClassMethod: m.isClassMethod || false,
+              returnType: m.returnType || 'void',
+              paramCount: m.paramCount || 0,
+              bodyLines: m.bodyLines || 0,
+              complexity: m.complexity || 1,
+            });
+          }
+        }
+      }
+
+      this.#classes.set(cls.name, classInfo);
+
+      // 继承关系
+      if (cls.superclass) {
+        this.#inheritance.set(cls.name, cls.superclass);
+      }
+
+      // 协议遵循
+      if (cls.protocols && cls.protocols.length > 0) {
+        if (!this.#conformance.has(cls.name)) {
+          this.#conformance.set(cls.name, new Set());
+        }
+        for (const p of cls.protocols) {
+          this.#conformance.get(cls.name).add(p);
+        }
+      }
+
+      fileSymbols.classes.push(cls.name);
+    }
+
+    // 索引协议
+    for (const proto of summary.protocols) {
+      const protoInfo = {
+        name: proto.name,
+        filePath: relativePath,
+        line: proto.line,
+        inherits: proto.inherits || [],
+        requiredMethods: [],
+        optionalMethods: [],
+        conformers: [], // 稍后在 buildReverseIndices 中填充
+      };
+
+      for (const m of (proto.methods || [])) {
+        const methodInfo = {
+          name: m.name,
+          selector: m.selector || m.name,
+          line: m.line,
+          isClassMethod: m.isClassMethod || false,
+          returnType: m.returnType || 'void',
+          paramCount: m.paramCount || 0,
+        };
+        if (m.isOptional) {
+          protoInfo.optionalMethods.push(methodInfo);
+        } else {
+          protoInfo.requiredMethods.push(methodInfo);
+        }
+      }
+
+      this.#protocols.set(proto.name, protoInfo);
+      fileSymbols.protocols.push(proto.name);
+    }
+
+    // 索引 Category
+    for (const cat of summary.categories) {
+      const catInfo = {
+        className: cat.className || cat.name,
+        categoryName: cat.categoryName || 'ext',
+        filePath: relativePath,
+        line: cat.line,
+        methods: (cat.methods || []).map(m => ({
+          name: m.name,
+          selector: m.selector || m.name,
+          line: m.line,
+          isClassMethod: m.isClassMethod || false,
+          returnType: m.returnType || 'void',
+          paramCount: m.paramCount || 0,
+        })),
+        properties: [],
+        protocols: cat.protocols || [],
+      };
+
+      const key = catInfo.className;
+      if (!this.#categories.has(key)) {
+        this.#categories.set(key, []);
+      }
+      this.#categories.get(key).push(catInfo);
+
+      // Category 遵循的协议也记录到类的遵循关系
+      if (catInfo.protocols.length > 0) {
+        if (!this.#conformance.has(key)) {
+          this.#conformance.set(key, new Set());
+        }
+        for (const p of catInfo.protocols) {
+          this.#conformance.get(key).add(p);
+        }
+      }
+
+      fileSymbols.categories.push(`${catInfo.className}(${catInfo.categoryName})`);
+    }
+
+    // 索引方法 (按类名分组)
+    for (const m of (summary.methods || [])) {
+      if (!m.className) continue;
+      if (!this.#methodsByClass.has(m.className)) {
+        this.#methodsByClass.set(m.className, []);
+      }
+      this.#methodsByClass.get(m.className).push({
+        name: m.name,
+        selector: m.selector || m.name,
+        line: m.line,
+        isClassMethod: m.isClassMethod || false,
+        returnType: m.returnType || 'void',
+        paramCount: m.paramCount || 0,
+        bodyLines: m.bodyLines || 0,
+        complexity: m.complexity || 1,
+        filePath: relativePath,
+      });
+    }
+
+    this.#files.set(relativePath, fileSymbols);
+  }
+
+  /**
+   * 构建反向索引 — 协议遵循者列表
+   */
+  #buildReverseIndices() {
+    // 填充 protocol.conformers
+    for (const [className, protos] of this.#conformance) {
+      for (const protoName of protos) {
+        const proto = this.#protocols.get(protoName);
+        if (proto && !proto.conformers.includes(className)) {
+          proto.conformers.push(className);
+        }
+      }
+    }
+
+    // 补充 classInfo 中的 methods (从 methodsByClass 合并)
+    for (const [className, classInfo] of this.#classes) {
+      const allMethods = this.#methodsByClass.get(className) || [];
+      // 只补充 classInfo.methods 中没有的方法
+      const existingNames = new Set(classInfo.methods.map(m => `${m.isClassMethod ? '+' : '-'}${m.name}`));
+      for (const m of allMethods) {
+        const key = `${m.isClassMethod ? '+' : '-'}${m.name}`;
+        if (!existingNames.has(key)) {
+          classInfo.methods.push(m);
+          existingNames.add(key);
+        }
+      }
+    }
+  }
+}
+
+// ──────────────────────────────────────────────────────────────────
+// 工具函数 — 文件收集
+// ──────────────────────────────────────────────────────────────────
+
+/**
+ * 递归收集匹配扩展名的源文件
+ * @param {string} dir
+ * @param {string[]} extensions
+ * @param {object} opts
+ * @returns {string[]}
+ */
+function collectSourceFiles(dir, extensions, opts) {
+  const results = [];
+  const extSet = new Set(extensions);
+
+  function walk(currentDir) {
+    if (results.length >= opts.maxFiles) return;
+
+    let entries;
+    try {
+      entries = fs.readdirSync(currentDir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+
+    for (const entry of entries) {
+      if (results.length >= opts.maxFiles) return;
+
+      const fullPath = path.join(currentDir, entry.name);
+      const relativePath = path.relative(dir, fullPath);
+
+      // 排除模式检查
+      if (opts.excludePatterns.some(p => relativePath.includes(p))) {
+        continue;
+      }
+
+      if (entry.isDirectory()) {
+        walk(fullPath);
+      } else if (entry.isFile()) {
+        const ext = path.extname(entry.name);
+        if (!extSet.has(ext)) continue;
+
+        // 跳过过大的文件
+        try {
+          const stat = fs.statSync(fullPath);
+          if (stat.size > opts.maxFileSizeBytes) continue;
+        } catch {
+          continue;
+        }
+
+        results.push(fullPath);
+      }
+    }
+  }
+
+  walk(dir);
+  return results;
+}

package/lib/core/gateway/Gateway.js

@@ -22,6 +22,7 @@ export class Gateway extends EventEmitter {
     this.constitutionValidator = null;
     this.permissionManager = null;
     this.auditLogger = null;
+    this.eventBus = null; // 可选：外部注入 EventBus 实例
   }
 
   /**
@@ -219,7 +220,7 @@ export class Gateway extends EventEmitter {
   async auditSuccess(context, result) {
     if (!this.auditLogger) return;
 
-    await this.auditLogger.log({
+    const entry = {
       requestId: context.requestId,
       actor: context.actor,
       action: context.action,
@@ -227,7 +228,14 @@ export class Gateway extends EventEmitter {
       result: 'success',
       duration: Date.now() - context.startTime,
       context: { session: context.session },
-    });
+    };
+    await this.auditLogger.log(entry);
+
+    // 向 EventBus 发送 Gateway 操作完成事件（供 SignalCollector 等监听）
+    if (this.eventBus) {
+      this.emit('gateway:action:completed', { ...entry, timestamp: Date.now() });
+      this.eventBus.emit('gateway:action:completed', { ...entry, timestamp: Date.now() });
+    }
   }
 
   /**
@@ -236,7 +244,7 @@ export class Gateway extends EventEmitter {
   async auditFailure(context, error) {
     if (!this.auditLogger) return;
 
-    await this.auditLogger.log({
+    const entry = {
       requestId: context.requestId,
       actor: context.actor,
       action: context.action,
@@ -245,7 +253,14 @@ export class Gateway extends EventEmitter {
       error: error.message,
       duration: Date.now() - context.startTime,
       context: { session: context.session },
-    });
+    };
+    await this.auditLogger.log(entry);
+
+    // 向 EventBus 发送 Gateway 操作失败事件
+    if (this.eventBus) {
+      this.emit('gateway:action:failed', { ...entry, timestamp: Date.now() });
+      this.eventBus.emit('gateway:action:failed', { ...entry, timestamp: Date.now() });
+    }
   }
 
   /**

package/lib/core/gateway/GatewayActionRegistry.js

@@ -70,8 +70,8 @@ export function registerGatewayActions(gateway, container) {
   });
 
   gateway.register('candidate:delete', async (ctx) => {
-    const repo = container.get('candidateRepository');
-    return repo.delete(ctx.data.candidateId);
+    const service = container.get('candidateService');
+    return service.deleteCandidate(ctx.data.candidateId, { userId: ctx.actor });
   });
 
   // ========== Recipe Actions ==========

package/lib/domain/recipe/Recipe.js

@@ -40,6 +40,7 @@ const KIND_MAP = {
   'code-pattern':        Kind.PATTERN,
   'architecture':        Kind.PATTERN,
   'solution':            Kind.PATTERN,
+  'anti-pattern':        Kind.PATTERN,
   'code-relation':       Kind.FACT,
   'inheritance':         Kind.FACT,
   'call-chain':          Kind.FACT,
@@ -87,6 +88,8 @@ export const KnowledgeType = {
   CODE_STYLE:          'code-style',
   /** 问题解决方案: 具体 Bug/性能/迁移问题的解决办法 */
   SOLUTION:            'solution',
+  /** 反模式: force-unwrap、超长方法、循环引用等代码风险 */
+  ANTI_PATTERN:        'anti-pattern',
 };
 
 /** 复杂度 */