rules-enforcer 1.0.0

package/detector/render-engine/ag-config-render.js

@@ -0,0 +1,195 @@
+/**
+ * Agent Config Render - Agent配置渲染器
+ * 生成AGENTS.md和CLAUDE.md标准配置
+ */
+
+class AgentConfigRender {
+  constructor() {
+    this.template = {
+      agents: this.getAgentsTemplate(),
+      claude: this.getClaudeTemplate()
+    };
+  }
+
+  /**
+   * 渲染AGENTS.md
+   */
+  renderAgentsMd(decisionResult) {
+    const recommendedAgent = decisionResult.decision?.recommendedAgent;
+    const recommendedMcp = decisionResult.decision?.recommendedMcp || [];
+
+    let content = `# AGENTS.md - Agent Configuration
+
+## Agent Identity
+
+`;
+
+    if (recommendedAgent) {
+      content += `### ${recommendedAgent.name}
+
+`;
+      content += `**Type**: ${recommendedAgent.type || 'general-purpose'}\n\n`;
+      content += `**Version**: 1.0.0\n\n`;
+      content += `**Description**: ${recommendedAgent.description || `AI agent configured for optimal project support`}\n\n`;
+
+      if (recommendedAgent.recommendedMcp) {
+        content += `### MCP Services\n\n`;
+        content += `Recommended MCP services for this agent:\n\n`;
+        for (const mcp of recommendedAgent.recommendedMcp) {
+          content += `- \`${mcp}\`\n`;
+        }
+        content += `\n`;
+      }
+
+      if (recommendedAgent.recommendedRules) {
+        content += `### Rule Levels\n\n`;
+        content += `Applicable rule levels:\n\n`;
+        for (const ruleLevel of recommendedAgent.recommendedRules) {
+          content += `- **${ruleLevel}**: `;
+          switch (ruleLevel) {
+            case 'L1': content += `Global behavior constraints\n`; break;
+            case 'L2': content += `Project-specific rules\n`; break;
+            case 'L3': content += `Module-level rules\n`; break;
+            default: content += `Custom rules\n`;
+          }
+        }
+        content += `\n`;
+      }
+    }
+
+    content += `## Agent Capabilities
+
+### Core Capabilities
+
+- **Code Generation**: Generate TypeScript, JavaScript, React components
+- **Code Refactoring**: Improve code quality and structure
+- **Bug Detection**: Identify and fix common bugs
+- **Debugging**: Analyze and resolve issues
+- **Documentation**: Generate API docs, README, code comments
+- **Testing**: Write unit tests, integration tests
+- **Requirements Analysis**: Parse and understand user requirements
+
+### Behavior Constraints
+
+1. Follow AGENTS.md > CLAUDE.md > .trae/rules priority
+2. Use TypeScript strict mode
+3. Follow ESLint rules
+4. Use Prettier for formatting
+5. No hardcoded credentials
+6. No console.log statements in production code
+
+### MCP Integration
+
+`;
+    if (recommendedMcp.length > 0) {
+      content += `Configured MCP services:\n\n`;
+      for (const mcp of recommendedMcp) {
+        content += `- **${mcp.name}** (${mcp.type}): ${mcp.id}\n`;
+      }
+    } else {
+      content += `No additional MCP services required.\n`;
+    }
+
+    content += `
+---
+
+*Generated by TRAIDE Project Configuration System*
+`;
+
+    return content;
+  }
+
+  /**
+   * 渲染CLAUDE.md
+   */
+  renderClaudeMd(decisionResult) {
+    const recommendedAgent = decisionResult.decision?.recommendedAgent;
+    const recommendedRules = decisionResult.decision?.recommendedRules || [];
+    const scoreBreakdown = decisionResult.scoreBreakdown || {};
+
+    let content = `# CLAUDE.md - Project Configuration
+
+## Project Overview
+
+`;
+    if (recommendedAgent) {
+      content += `**Agent**: ${recommendedAgent.name}\n`;
+    }
+    content += `**Generated**: ${new Date().toISOString()}\n`;
+    content += `**Confidence**: ${(decisionResult.decision?.confidence * 100 || 0).toFixed(1)}%\n\n`;
+
+    content += `## Score Breakdown\n\n`;
+    content += `| Metric | Score |\n`;
+    content += `|--------|-------|\n`;
+    content += `| Tech Stack Match | ${scoreBreakdown.techStackMatch || 0}/100 |\n`;
+    content += `| Complexity Fit | ${scoreBreakdown.complexityFit || 0}/100 |\n`;
+    content += `| Dependency Score | ${scoreBreakdown.dependencyScore || 0}/100 |\n`;
+    content += `| Reuse Score | ${scoreBreakdown.reuseScore || 0}/100 |\n\n`;
+
+    content += `## Configuration Priority\n\n`;
+    content += `**IMPORTANT**: Configuration files are loaded in the following order:\n\n`;
+    content += `1. **AGENTS.md** (highest priority) - Agent-specific configuration\n`;
+    content += `2. **CLAUDE.md** (project level) - Project-specific settings\n`;
+    content += `3. **.trae/rules/** (lowest priority) - Rule files\n\n`;
+
+    content += `## Rule Levels\n\n`;
+    content += `### L1 - Global Rules\n`;
+    content += `Global behavior constraints that apply to all operations.\n\n`;
+    content += `### L2 - Project Rules\n`;
+    content += `Project-specific rules for this workspace.\n\n`;
+    content += `### L3 - Module Rules\n`;
+    content += `Module-level rules organized by functionality.\n\n`;
+
+    if (recommendedRules.length > 0) {
+      content += `## Recommended Rules\n\n`;
+      for (const rule of recommendedRules) {
+        content += `- **${rule.name}** [${rule.level}]: ${rule.description || 'No description'}\n`;
+      }
+      content += `\n`;
+    }
+
+    content += `## Conflicts & Warnings\n\n`;
+    if (decisionResult.conflicts && decisionResult.conflicts.length > 0) {
+      for (const conflict of decisionResult.conflicts) {
+        const icon = conflict.severity === 'error' ? '❌' :
+                     conflict.severity === 'warning' ? '⚠️' : 'ℹ️';
+        content += `${icon} ${conflict.message}\n`;
+        if (conflict.suggestion) {
+          content += `   → ${conflict.suggestion}\n`;
+        }
+      }
+    } else {
+      content += `No conflicts detected.\n`;
+    }
+
+    content += `
+---
+
+*Generated by TRAIDE Decision Engine*
+`;
+
+    return content;
+  }
+
+  /**
+   * 获取AGENTS.md模板
+   */
+  getAgentsTemplate() {
+    return {
+      header: '# AGENTS.md - Agent Configuration',
+      sections: ['identity', 'capabilities', 'constraints', 'mcp', 'rules']
+    };
+  }
+
+  /**
+   * 获取CLAUDE.md模板
+   */
+  getClaudeTemplate() {
+    return {
+      header: '# CLAUDE.md - Project Configuration',
+      sections: ['overview', 'priority', 'rules', 'conflicts']
+    };
+  }
+}
+
+module.exports = { AgentConfigRender };

package/detector/render-engine/index.js

@@ -0,0 +1,124 @@
+/**
+ * Render Engine - 渲染引擎入口
+ * 对接decision-engine决策结果，一键渲染全套配置
+ */
+
+const path = require('path');
+const { RenderCore } = require('./render-core.js');
+
+class RenderEngine {
+  constructor(options = {}) {
+    this.outputDir = options.outputDir || process.cwd();
+    this.renderCore = new RenderCore({ outputDir: this.outputDir });
+  }
+
+  /**
+   * 执行完整渲染流程
+   * 接收decision-engine的决策结果作为唯一数据源
+   */
+  async render(decisionResult) {
+    console.log('\n[RenderEngine] ========== 配置渲染开始 ==========\n');
+
+    // 数据源验证：必须来自decision-engine
+    if (!decisionResult || !decisionResult.decision) {
+      throw new Error('无效的决策结果，数据源必须来自decision-engine');
+    }
+
+    // 执行渲染
+    const result = await this.renderCore.render(decisionResult);
+
+    // 输出结果
+    if (result.success) {
+      console.log(`[RenderEngine] ✅ 渲染成功，共生成 ${result.files.length} 个文件:\n`);
+      for (const file of result.files) {
+        console.log(`   - ${file.path} [${file.type || file.level || 'file'}]`);
+      }
+    } else {
+      console.log(`[RenderEngine] ❌ 渲染失败:\n`);
+      for (const error of result.errors) {
+        console.log(`   - ${error}`);
+      }
+    }
+
+    console.log('\n[RenderEngine] ========== 渲染完成 ==========\n');
+
+    return result;
+  }
+
+  /**
+   * 打印渲染摘要
+   */
+  printSummary() {
+    const summary = this.renderCore.getSummary();
+    console.log('\n========== 渲染摘要 ==========');
+    console.log(`优先级: ${summary.priority}`);
+    console.log(`文件总数: ${summary.totalFiles}`);
+    console.log('================================\n');
+  }
+
+  /**
+   * 获取引擎信息
+   */
+  getInfo() {
+    return {
+      name: 'RenderEngine',
+      version: '1.0.0',
+      priority: 'AGENTS.md > CLAUDE.md > .trae/rules',
+      formats: ['AGENTS.md (Markdown)', 'CLAUDE.md (Markdown)', '.trae/rules/*.yml (YAML)']
+    };
+  }
+}
+
+module.exports = { RenderEngine };
+
+// CLI入口
+if (require.main === module) {
+  const path = require('path');
+
+  try {
+    // 加载decision-engine结果（模拟）
+    console.log('[RenderEngine] CLI模式示例');
+    console.log('实际使用时，decision-result应从decision-engine获取\n');
+
+    // 示例决策结果
+    const mockDecisionResult = {
+      decision: {
+        recommendedMcp: [
+          { id: 'context7', name: 'Context7', type: 'context-management' }
+        ],
+        recommendedRules: [
+          { id: 'user-rules', name: 'User Rules', level: 'L1', description: '用户全局行为约束' },
+          { id: 'project-rules', name: 'Project Rules', level: 'L2', description: '项目特定规则' },
+          { id: 'rzero-agent', name: 'RZero Agent Configuration', level: 'L3', module: 'RZero', description: 'RZero Agent配置' }
+        ],
+        recommendedAgent: {
+          id: 'fullstack-developer',
+          name: 'Full Stack Developer',
+          type: 'general-purpose',
+          recommendedMcp: ['rules-enforcer', 'context7'],
+          recommendedRules: ['L1', 'L2']
+        },
+        confidence: 0.94
+      },
+      scoreBreakdown: {
+        techStackMatch: 93,
+        complexityFit: 100,
+        dependencyScore: 88,
+        reuseScore: 100
+      },
+      conflicts: [],
+      alternatives: []
+    };
+
+    const engine = new RenderEngine({ outputDir: process.cwd() });
+    engine.render(mockDecisionResult).then(result => {
+      engine.printSummary();
+      console.log('完整渲染结果:');
+      console.log(JSON.stringify(result, null, 2));
+    });
+
+  } catch (e) {
+    console.error('[RenderEngine] 执行失败:', e.message);
+    process.exit(1);
+  }
+}

package/detector/render-engine/render-core.js

@@ -0,0 +1,200 @@
+/**
+ * Render Core - 核心渲染引擎
+ * 接收decision-engine决策结果，调度各渲染器生成配置
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { RuleRender } = require('./rule-render.js');
+const { AgentConfigRender } = require('./ag-config-render.js');
+
+/**
+ * Promise化的fs方法
+ */
+const fsPromises = {
+  writeFile: (path, content, encoding) => fs.promises.writeFile(path, content, encoding),
+  readFile: (path, encoding) => fs.promises.readFile(path, encoding),
+  ensureDir: async (dirPath) => {
+    try {
+      await fs.promises.mkdir(dirPath, { recursive: true });
+    } catch (e) {
+      if (e.code !== 'EEXIST') throw e;
+    }
+  },
+  pathExists: (path) => fs.promises.access(path).then(() => true).catch(() => false),
+  readdir: (path, options) => fs.promises.readdir(path, options)
+};
+
+class RenderCore {
+  constructor(options = {}) {
+    this.outputDir = options.outputDir || process.cwd();
+    this.ruleRender = new RuleRender();
+    this.agentConfigRender = new AgentConfigRender();
+    this.renderedFiles = [];
+  }
+
+  /**
+   * 执行完整渲染流程
+   */
+  async render(decisionResult) {
+    const results = {
+      success: true,
+      files: [],
+      errors: []
+    };
+
+    try {
+      // 1. 渲染Agent配置（最高优先级）
+      const agentResult = await this.renderAgentConfigs(decisionResult);
+      results.files.push(...agentResult.files);
+      if (agentResult.error) results.errors.push(agentResult.error);
+
+      // 2. 渲染规则文件（次优先级）
+      const rulesResult = await this.renderRules(decisionResult);
+      results.files.push(...rulesResult.files);
+      if (rulesResult.error) results.errors.push(rulesResult.error);
+
+      results.success = results.errors.length === 0;
+      this.renderedFiles = results.files;
+
+    } catch (e) {
+      results.success = false;
+      results.errors.push(`渲染核心错误: ${e.message}`);
+    }
+
+    return results;
+  }
+
+  /**
+   * 渲染Agent配置文件
+   */
+  async renderAgentConfigs(decisionResult) {
+    const result = { files: [], error: null };
+
+    try {
+      // 渲染AGENTS.md
+      const agentsContent = this.agentConfigRender.renderAgentsMd(decisionResult);
+      const agentsPath = path.join(this.outputDir, 'AGENTS.md');
+      await fsPromises.writeFile(agentsPath, agentsContent, 'utf-8');
+      result.files.push({ path: agentsPath, type: 'agents-md' });
+
+      // 渲染CLAUDE.md
+      const claudeContent = this.agentConfigRender.renderClaudeMd(decisionResult);
+      const claudePath = path.join(this.outputDir, 'CLAUDE.md');
+      await fsPromises.writeFile(claudePath, claudeContent, 'utf-8');
+      result.files.push({ path: claudePath, type: 'claude-md' });
+
+    } catch (e) {
+      result.error = `Agent配置渲染失败: ${e.message}`;
+    }
+
+    return result;
+  }
+
+  /**
+   * 渲染规则文件
+   */
+  async renderRules(decisionResult) {
+    const result = { files: [], error: null };
+
+    try {
+      // 确保.trae/rules目录存在
+      const rulesDir = path.join(this.outputDir, '.trae', 'rules');
+      await fsPromises.ensureDir(rulesDir);
+
+      // 按优先级渲染规则：L1 > L2 > L3
+      const rulesByLevel = this.groupRulesByLevel(decisionResult);
+
+      // 渲染L1规则
+      if (rulesByLevel.L1 && rulesByLevel.L1.length > 0) {
+        const l1Dir = path.join(rulesDir, 'L1');
+        await fsPromises.ensureDir(l1Dir);
+        for (const rule of rulesByLevel.L1) {
+          const filePath = path.join(l1Dir, `${rule.id}.yml`);
+          const content = this.ruleRender.renderRule(rule, 'L1');
+          await fsPromises.writeFile(filePath, content, 'utf-8');
+          result.files.push({ path: filePath, type: 'rule-L1', level: 'L1' });
+        }
+      }
+
+      // 渲染L2规则
+      if (rulesByLevel.L2 && rulesByLevel.L2.length > 0) {
+        const l2Dir = path.join(rulesDir, 'L2');
+        await fsPromises.ensureDir(l2Dir);
+        for (const rule of rulesByLevel.L2) {
+          const filePath = path.join(l2Dir, `${rule.id}.yml`);
+          const content = this.ruleRender.renderRule(rule, 'L2');
+          await fsPromises.writeFile(filePath, content, 'utf-8');
+          result.files.push({ path: filePath, type: 'rule-L2', level: 'L2' });
+        }
+      }
+
+      // 渲染L3规则
+      if (rulesByLevel.L3 && rulesByLevel.L3.length > 0) {
+        // 按模块分组创建子目录
+        const l3Dir = path.join(rulesDir, 'L3');
+        await fsPromises.ensureDir(l3Dir);
+
+        for (const rule of rulesByLevel.L3) {
+          const module = rule.module || 'default';
+          const moduleDir = path.join(l3Dir, module);
+          await fsPromises.ensureDir(moduleDir);
+
+          const filePath = path.join(moduleDir, `${rule.id}.yml`);
+          const content = this.ruleRender.renderRule(rule, 'L3');
+          await fsPromises.writeFile(filePath, content, 'utf-8');
+          result.files.push({ path: filePath, type: 'rule-L3', level: 'L3', module });
+        }
+      }
+
+      // 渲染custom规则
+      if (rulesByLevel.custom && rulesByLevel.custom.length > 0) {
+        const customDir = path.join(rulesDir, 'custom');
+        await fsPromises.ensureDir(customDir);
+        for (const rule of rulesByLevel.custom) {
+          const filePath = path.join(customDir, `${rule.id}.yml`);
+          const content = this.ruleRender.renderRule(rule, 'custom');
+          await fsPromises.writeFile(filePath, content, 'utf-8');
+          result.files.push({ path: filePath, type: 'rule-custom', level: 'custom' });
+        }
+      }
+
+    } catch (e) {
+      result.error = `规则渲染失败: ${e.message}`;
+    }
+
+    return result;
+  }
+
+  /**
+   * 按优先级分组规则
+   */
+  groupRulesByLevel(decisionResult) {
+    const rules = decisionResult.decision?.recommendedRules || [];
+    const groups = { L1: [], L2: [], L3: [], custom: [] };
+
+    for (const rule of rules) {
+      const level = rule.level || 'L3';
+      if (groups[level]) {
+        groups[level].push(rule);
+      } else {
+        groups.custom.push(rule);
+      }
+    }
+
+    return groups;
+  }
+
+  /**
+   * 获取渲染结果摘要
+   */
+  getSummary() {
+    return {
+      totalFiles: this.renderedFiles.length,
+      files: this.renderedFiles,
+      priority: 'AGENTS.md > CLAUDE.md > .trae/rules'
+    };
+  }
+}
+
+module.exports = { RenderCore };