rules-conflict-resolver

⚡ 规则冲突解决和监控 (Rule Conflict Resolver & Monitor)

本文档是从 @rules-router 分割出来的冲突解决和监控部分。

⚠️ 解决原则

MUST 遵循以下冲突解决准则：

• MUST 基于优先级矩阵解决规则冲突
• NEVER 随意忽略或禁用冲突的规则
• ALWAYS 记录冲突解决决策
• DO NOT 让规则冲突影响系统稳定性
• MUST 定期审查和优化冲突解决策略
• ALWAYS 提供冲突解决的透明性

优先级计算模型

interface RulePriority {
  basePriority: number;     // 基础优先级
  contextBoost: number;     // 上下文提升
  userPreference: number;   // 用户偏好
  recencyBonus: number;     // 最近使用奖励
  finalPriority: number;    // 最终优先级
}

class PriorityCalculator {
  calculatePriorities(
    rules: string[],
    context: RuleActivationContext
  ): Record<string, RulePriority> {

    const priorities: Record<string, RulePriority> = {};

    for (const rule of rules) {
      const basePriority = RULE_DEPENDENCIES[rule]?.priority ?? 5;

      // 上下文提升
      let contextBoost = 0;
      if (this.isHighlyRelevant(rule, context)) {
        contextBoost += 3;
      } else if (this.isModeratelyRelevant(rule, context)) {
        contextBoost += 1;
      }

      // 用户偏好
      const userPreference = context.userPreferences?.rule_preferences?.[rule] ?? 0;

      // 最近使用奖励 (模拟)
      const recencyBonus = Math.random() * 2; // 0-2的随机值

      const finalPriority = basePriority + contextBoost + userPreference + recencyBonus;

      priorities[rule] = {
        basePriority,
        contextBoost,
        userPreference,
        recencyBonus,
        finalPriority
      };
    }

    return priorities;
  }

  private isHighlyRelevant(rule: string, context: RuleActivationContext): boolean {
    const highRelevanceMap: Record<string, string[]> = {
      "javascript": ["javascript", "typescript", "react", "vue", "node"],
      "python": ["python", "django", "fastapi", "flask"],
      "collaboration": ["team", "collaboration", "git", "merge"],
      "generator": ["create", "new", "init", "generate"],
      "eslint": ["lint", "quality", "check", "fix"]
    };

    const relevantContexts = highRelevanceMap[rule] ?? [];
    return relevantContexts.some(ctx =>
      context.userIntent.includes(ctx) ||
      context.techStack.includes(ctx) ||
      context.projectType.includes(ctx)
    );
  }

  private isModeratelyRelevant(rule: string, context: RuleActivationContext): boolean {
    // 中等相关性逻辑
    return false; // 简化实现
  }
}