rules-enforcer 1.0.0

package/README.md

@@ -0,0 +1,58 @@
+# rules-enforcer
+
+R-Zero Rules Engine MCP Server
+
+## 功能
+
+- **规则验证** - L1/L2/L3 规则检查
+- **自定义钩子** - G 记忆管理、链式调用
+- **项目探测** - 技术栈识别、目录扫描
+
+## 安装
+
+```bash
+npm install rules-enforcer
+```
+
+## 使用
+
+### 作为 MCP 服务器
+
+```json
+{
+  "mcpServers": {
+    "rules-enforcer": {
+      "command": "node",
+      "args": ["node_modules/rules-enforcer/rules-server.js"]
+    }
+  }
+}
+```
+
+### 可用工具
+
+| 工具名 | 功能 |
+|--------|------|
+| `validate` | 验证代码是否符合规则 |
+| `get_rules` | 获取所有规则定义 |
+| `enforce` | 强制执行规则验证 |
+
+## 测试
+
+```bash
+npm test
+```
+
+## 目录结构
+
+```
+rules-enforcer/
+├── rules-server.js      # MCP 主入口
+├── hooks/               # 自定义钩子模块
+├── detector/            # 项目探测模块
+└── test/                # 测试脚本
+```
+
+## License
+
+MIT

package/detector/README.md

@@ -0,0 +1,212 @@
+# Project Detector Plugin
+
+## 插件信息
+
+| 属性 | 值 |
+|------|-----|
+| 名称 | project-detector |
+| 版本 | 1.0.0 |
+| 显示名 | Project Detector |
+| 描述 | Trae项目探测工具 - 自动扫描项目技术栈、目录拓扑、已有组件，为配置最优解生成提供数据支撑 |
+| 类型 | Trae工具插件 |
+| 目录 | `.trae/plugins/project-detector/` |
+| MCP服务 | project-detector |
+| 兼容性 | Trae >= 1.0.0 |
+| 许可证 | MIT |
+
+## 功能说明
+
+只读扫描项目结构，识别技术栈、目录拓扑、已有组件，为配置最优解生成提供数据支撑。
+
+### 核心功能
+
+1. **技术栈识别**
+   - 自动识别 package.json/requirements.txt/go.mod 等依赖清单
+   - 解析 Express.js/better-sqlite3 等框架库
+
+2. **目录拓扑扫描**
+   - 递归扫描目录结构（最大4层）
+   - 分类：业务代码/测试目录/部署脚本/配置文件
+
+3. **已有组件检测**
+   - MCP服务扫描（rules-enforcer/custom-hooks等）
+   - Agent配置扫描（AGENTS.md等）
+   - 规则文件扫描（L1/L2/L3三层规则）
+
+4. **异常捕获**
+   - 文件读取异常日志
+   - 目录不存在提示
+
+5. **复杂度评估**
+   - 根据技术栈、目录规模、组件数量评估项目复杂度
+
+## 快捷指令
+
+在 Trae 终端输入以下指令即可执行探测：
+
+| 指令 | 功能 |
+|------|------|
+| `$detect` | 执行完整项目探测 |
+| `$scan-project` | 执行完整项目探测 |
+| `$quick-scan` | 快速扫描基本信息 |
+
+## 文件结构
+
+```
+.trae/plugins/project-detector/
+├── plugin.json          # 插件配置（含IDE命令注册、元信息）
+├── project-detector.js  # 插件入口脚本
+├── mcp-service.js      # MCP服务集成
+├── verify-plugin.js     # 插件验证脚本
+├── test-exceptions.js   # 异常测试用例
+└── README.md           # 本文档
+```
+
+## MCP 服务
+
+插件已注册为 Trae MCP 服务：
+
+```json
+// .trae/mcp/mcp.json
+{
+  "mcpServers": {
+    "project-detector": {
+      "command": "node",
+      "args": ["${workspaceFolder}/.trae/plugins/project-detector/project-detector.js"]
+    }
+  }
+}
+```
+
+### MCP 工具
+
+| 工具名 | 功能 |
+|--------|------|
+| `scan_project` | 完整项目探测 |
+| `quick_scan` | 快速扫描 |
+| `list_rules` | 列出规则配置 |
+
+## IDE 命令面板
+
+插件注册了以下命令，可通过 `Ctrl+Shift+P` 打开命令面板搜索：
+
+- `TRAIDE: Project Detector: Full Scan` - 执行完整探测
+- `TRAIDE: Project Detector: Quick Scan` - 快速扫描
+- `TRAIDE: Project Detector: List Rules` - 列出规则
+
+## 使用方式
+
+### 方式1: 快捷指令（推荐）
+
+```
+$detect
+$scan-project
+$quick-scan
+```
+
+### 方式2: MCP 工具调用
+
+通过 rules-enforcer MCP 调用：
+```
+tools: scan_project
+```
+
+### 方式3: 命令面板
+
+1. `Ctrl+Shift+P` 打开命令面板
+2. 输入 `Project Detector`
+3. 选择对应命令执行
+
+### 方式4: Node.js 直接运行
+
+```bash
+node .trae/plugins/project-detector/project-detector.js
+```
+
+## 验证脚本
+
+### 插件验证
+
+```bash
+node .trae/plugins/project-detector/verify-plugin.js
+```
+
+### 异常测试
+
+```bash
+node .trae/plugins/project-detector/test-exceptions.js
+```
+
+## 输出格式
+
+```json
+{
+  "projectRoot": "c:\\path\\to\\project",
+  "techStack": ["Node.js", "Express.js", "SQLite"],
+  "existingComponents": {
+    "mcp": ["rules-enforcer", "custom-hooks", "project-detector"],
+    "agents": [...],
+    "rules": [...]
+  },
+  "stats": {
+    "mcpCount": 3,
+    "agentCount": 2,
+    "ruleCount": 12,
+    "complexity": "medium"
+  },
+  "topologyTree": "...",
+  "fileErrors": []
+}
+```
+
+## 约束
+
+- 全程只读，不修改项目任何源码与配置
+- 不新增MCP服务（project-detector MCP除外）
+- 遵循Trae插件目录规范
+
+## 配置
+
+编辑 `plugin.json` 可调整扫描参数：
+
+```json
+{
+  "config": {
+    "maxScanDepth": 4,
+    "excludePatterns": ["node_modules", ".git", "dist"]
+  }
+}
+```
+
+## IDE 前端验证步骤
+
+以下验证需要 Trae IDE 环境：
+
+1. **插件注册验证**
+   - 重启 Trae IDE
+   - 打开设置 → 插件管理
+   - 确认 `project-detector` 出现在已安装插件列表
+
+2. **快捷指令验证**
+   - 打开 Trae 内置终端
+   - 输入 `$detect` 或 `$quick-scan`
+   - 确认插件响应并输出探测结果
+
+3. **MCP 连通性验证**
+   - 打开 MCP 设置面板
+   - 确认 `project-detector` 服务状态为在线
+   - 通过 rules-enforcer 调用 `scan_project` 工具验证联动
+
+## 异常测试覆盖
+
+| 测试场景 | 说明 |
+|----------|------|
+| 空目录探测 | 不崩溃，返回空结果 |
+| 规则目录缺失 | 正确记录异常日志 |
+| 部分规则文件存在 | 正确识别现有规则 |
+| 无效项目路径 | 抛出明确错误 |
+| 非目录路径 | 抛出明确错误 |
+| 损坏的package.json | 健壮处理，返回默认值 |
+| 深层嵌套目录 | 正确截断在maxDepth |
+| 极长文件名 | 健壮处理 |
+| 符号链接目录 | 健壮处理 |

package/detector/decision-engine/README.md

@@ -0,0 +1,203 @@
+# Decision Engine - 最优决策引擎
+
+## 目录信息
+
+| 属性 | 值 |
+|------|-----|
+| 名称 | Decision Engine |
+| 版本 | 1.0.0 |
+| 路径 | `.trae/plugins/project-detector/decision-engine/` |
+| 插件 | project-detector |
+
+## 目录结构
+
+```
+decision-engine/
+├── scorer.js           # 评分引擎
+├── optimizer.js        # 优化算法
+├── conflict-resolver.js # 冲突解决器
+├── index.js           # 决策引擎入口
+└── de-verify.js       # 决策引擎验证脚本
+```
+
+## 核心算法
+
+### 1. 评分引擎 (Scorer)
+
+四项打分维度（0~100分值）：
+
+| 维度 | 权重 | 说明 |
+|------|------|------|
+| 技术栈匹配 | 40% | 项目技术栈与组件适配度 |
+| 复杂度适配 | 30% | 项目规模与组件支持范围匹配 |
+| 依赖兼容 | 20% | 组件依赖与已有组件匹配 |
+| 组件复用 | 10% | 已存在组件优先复用 |
+
+### 2. 优化算法 (Optimizer)
+
+固定权重配置：
+
+| 组件类型 | 权重 |
+|---------|------|
+| MCP | 40% |
+| 规则 | 35% |
+| Agent | 25% |
+
+### 3. 冲突解决器 (ConflictResolver)
+
+冲突检测类型：
+
+| 类型 | 说明 |
+|------|------|
+| 规则层级冲突 | L1>L2>L3优先级冲突 |
+| MCP依赖冲突 | 循环依赖、缺失依赖 |
+| 资源冲突 | 组件数量超限 |
+
+## 输出格式
+
+```json
+{
+  "decision": {
+    "recommendedMcp": [...],
+    "recommendedRules": [...],
+    "recommendedAgent": {...},
+    "confidence": 0.81
+  },
+  "scoreBreakdown": {
+    "techStackMatch": 93,
+    "complexityFit": 100,
+    "dependencyScore": 88,
+    "reuseScore": 0
+  },
+  "conflicts": [...],
+  "alternatives": [...]
+}
+```
+
+## 接口API
+
+### DecisionEngine类
+
+```javascript
+const { DecisionEngine } = require('./decision-engine/index.js');
+
+const engine = new DecisionEngine();
+
+// 执行决策
+const decision = engine.decide(knowledgeBase, projectReport);
+
+// 打印决策结果
+engine.printDecision(decision);
+
+// 获取引擎信息
+engine.getInfo();
+```
+
+### Scorer类
+
+```javascript
+const { Scorer } = require('./decision-engine/scorer.js');
+
+const scorer = new Scorer();
+
+// 计算技术栈匹配分
+scorer.calculateTechStackMatchScore(techStack, componentTechStack);
+
+// 计算复杂度适配分
+scorer.calculateComplexityFitScore(complexity, sizeRange);
+
+// 计算依赖兼容分
+scorer.calculateDependencyScore(dependencies, existingComponents);
+
+// 计算组件复用分
+scorer.calculateReuseScore(componentId, existingComponents);
+
+// 获取/设置权重（预留外置接口）
+scorer.getWeights();
+scorer.setWeights({ mcp: 0.4, rules: 0.35, agent: 0.25 });
+```
+
+### Optimizer类
+
+```javascript
+const { Optimizer } = require('./decision-engine/optimizer.js');
+
+const optimizer = new Optimizer();
+
+// 优化MCP配置
+optimizer.optimizeMcp(mcpKnowledge, projectInfo);
+
+// 优化规则配置
+optimizer.optimizeRules(rulesKnowledge, projectInfo);
+
+// 优化Agent配置
+optimizer.optimizeAgent(agentKnowledge, projectInfo);
+
+// 执行完整优化
+optimizer.optimize(knowledgeBase, projectInfo);
+```
+
+### ConflictResolver类
+
+```javascript
+const { ConflictResolver } = require('./decision-engine/conflict-resolver.js');
+
+const resolver = new ConflictResolver();
+
+// 检测规则冲突
+resolver.detectRuleConflicts(rules);
+
+// 检测MCP依赖冲突
+resolver.detectMcpConflicts(mcpServices, existingMcp);
+
+// 检测资源冲突
+resolver.detectResourceConflicts(components, projectInfo);
+
+// 解决规则冲突
+resolver.resolveRuleConflicts(rules);
+
+// 执行完整冲突检测
+resolver.detectAll(optimizationResult, projectInfo);
+```
+
+## 与project-detector对接
+
+项目探测结束后自动调用决策引擎：
+
+```javascript
+const detector = new ProjectDetector(projectPath);
+detector.scan();
+
+// 自动获取决策结果
+detector.printDecisionResult();
+```
+
+## 验证脚本
+
+```bash
+node .trae/plugins/project-detector/decision-engine/de-verify.js
+```
+
+### 验证用例
+
+| 用例 | 内容 |
+|------|------|
+| 常规项目配置 | 决策输出结构、置信度范围、分项得分、权重配置 |
+| 组件依赖冲突 | 循环依赖检测、缺失依赖检测 |
+| 规则层级冲突 | 同类型同优先级检测、缺失层级检测、冲突解决 |
+| 评分引擎 | 技术栈匹配分、复杂度适配分、依赖兼容分、组件复用分 |
+| 优化算法 | 优化结果结构、置信度计算 |
+| 全链路集成 | 探测→知识库→决策引擎完整串联 |
+
+## 约束遵守
+
+| 约束项 | 状态 |
+|--------|------|
+| 目录嵌套在插件内部 | ✅ |
+| 文件名固定 | ✅ scorer.js/optimizer.js/conflict-resolver.js/index.js/de-verify.js |
+| 权重锁死 | ✅ MCP=40%, 规则=35%, Agent=25% |
+| 分项得分0~100 | ✅ |
+| 输出字段规范 | ✅ decision/scoreBreakdown/conflicts/alternatives/confidence |
+| 置信度0~1 | ✅ |
+| 规则优先级L1>L2>L3 | ✅ |
+| 权重外置接口预留 | ✅ setWeights()方法 |