@sovr/engine 3.3.0 → 3.5.0

package/dist/index.js

@@ -21,16 +21,45 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   AdaptiveThresholdManager: () => AdaptiveThresholdManager,
+  AutoHardenEngine: () => AutoHardenEngine,
+  ContextAccelerator: () => ContextAccelerator,
+  CostGateEnhancedEngine: () => CostGateEnhancedEngine,
+  DEFAULT_CA_CONFIG: () => DEFAULT_CA_CONFIG,
+  DEFAULT_GE_CONFIG: () => DEFAULT_GE_CONFIG,
+  DEFAULT_HARD_RULES: () => DEFAULT_HARD_RULES,
   DEFAULT_RULES: () => DEFAULT_RULES,
+  DEFAULT_SCORING_WEIGHTS: () => DEFAULT_SCORING_WEIGHTS,
+  DEFAULT_TSA_CONFIG: () => DEFAULT_TSA_CONFIG,
+  EvolutionChannelEngine: () => EvolutionChannelEngine,
   FeatureSwitchesManager: () => FeatureSwitchesManager,
+  GovernanceEnhancer: () => GovernanceEnhancer,
+  MultiLevelBudgetEngine: () => MultiLevelBudgetEngine,
   PolicyEngine: () => PolicyEngine,
   PricingRulesEngine: () => PricingRulesEngine,
+  RecalculationEngine: () => RecalculationEngine,
   SOVR_FEATURE_SWITCHES: () => SOVR_FEATURE_SWITCHES,
+  SemanticDriftDetectorEngine: () => SemanticDriftDetectorEngine,
+  TimeSeriesAggregator: () => TimeSeriesAggregator,
+  TwoPhaseRouter: () => TwoPhaseRouter,
+  ValuationModel: () => ValuationModel,
   compileFromJSON: () => compileFromJSON,
   compileRuleSet: () => compileRuleSet,
+  createAutoHardenEngine: () => createAutoHardenEngine,
+  createCostGateEnhanced: () => createCostGateEnhanced,
+  createEvolutionChannel: () => createEvolutionChannel,
+  createMultiLevelBudget: () => createMultiLevelBudget,
+  createRecalculationEngine: () => createRecalculationEngine,
+  createSemanticDriftDetector: () => createSemanticDriftDetector,
   default: () => index_default,
+  estimateCost: () => estimateCost,
   evaluateRules: () => evaluateRules,
-  registerFunction: () => registerFunction
+  getAccuracyStats: () => getAccuracyStats,
+  getModelPricingTable: () => getModelPricingTable,
+  getToolPricingTable: () => getToolPricingTable,
+  recordActualCost: () => recordActualCost,
+  registerFunction: () => registerFunction,
+  updateModelPricing: () => updateModelPricing,
+  updateToolPricing: () => updateToolPricing
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -685,6 +714,2556 @@ var PricingRulesEngine = class {
   }
 };
 
+// src/recalculationEngine.ts
+var idCounter = 0;
+function genId(prefix) {
+  return `${prefix}_${Date.now()}_${++idCounter}`;
+}
+function simpleHash(data) {
+  let hash = 0;
+  for (let i = 0; i < data.length; i++) {
+    const char = data.charCodeAt(i);
+    hash = (hash << 5) - hash + char;
+    hash = hash & hash;
+  }
+  return "h_" + Math.abs(hash).toString(16).padStart(8, "0");
+}
+var RecalculationEngine = class {
+  tasks = /* @__PURE__ */ new Map();
+  consistencyResults = /* @__PURE__ */ new Map();
+  snapshots = /* @__PURE__ */ new Map();
+  handlers = /* @__PURE__ */ new Map();
+  config;
+  constructor(config = {}) {
+    this.config = { maxRangeDays: 30, ...config };
+  }
+  /** G3: Trigger recalculation */
+  triggerRecalculation(input) {
+    if (input.fromTs >= input.toTs) throw new Error("fromTs must be before toTs");
+    const maxMs = this.config.maxRangeDays * 864e5;
+    if (input.toTs - input.fromTs > maxMs) throw new Error(`Range exceeds ${this.config.maxRangeDays} days`);
+    const task = {
+      id: genId("recalc"),
+      tenantId: input.tenantId,
+      triggerType: input.triggerType,
+      triggeredBy: input.triggeredBy,
+      reason: input.reason,
+      fromTs: input.fromTs,
+      toTs: input.toTs,
+      granularity: input.granularity || "all",
+      incremental: input.incremental || false,
+      incrementalCheckpoint: input.incrementalCheckpoint,
+      status: "pending",
+      progress: 0,
+      bucketsProcessed: 0,
+      rowsUpserted: 0,
+      createdAt: Date.now(),
+      traceId: genId("trace")
+    };
+    this.tasks.set(task.id, task);
+    this.audit("recalc.triggered", { taskId: task.id, triggerType: task.triggerType, reason: task.reason });
+    return task;
+  }
+  /** Execute recalculation task */
+  async executeTask(taskId) {
+    const task = this.tasks.get(taskId);
+    if (!task) throw new Error(`Task not found: ${taskId}`);
+    if (task.status !== "pending") throw new Error(`Task not pending: ${task.status}`);
+    task.status = "running";
+    task.startedAt = Date.now();
+    this.audit("recalc.started", { taskId: task.id });
+    try {
+      const preSnapshot = this.createSnapshot(task.tenantId, "pre_recalc", task.id);
+      const handler = this.handlers.get(task.granularity);
+      if (handler) {
+        const result = await handler(task);
+        task.bucketsProcessed = result.bucketsProcessed;
+        task.rowsUpserted = result.rowsUpserted;
+        const postSnapshot = this.createSnapshot(task.tenantId, "post_recalc", task.id, result.metrics);
+        task.consistencyResult = this.verifyConsistency(task.id, preSnapshot, postSnapshot, result.metrics);
+      } else {
+        const segmentMs = task.granularity === "5m" ? 3e5 : task.granularity === "1h" ? 36e5 : task.granularity === "1d" ? 864e5 : 36e5;
+        const totalSegments = Math.ceil((task.toTs - task.fromTs) / segmentMs);
+        task.bucketsProcessed = totalSegments;
+        task.progress = 100;
+      }
+      task.status = "completed";
+      task.completedAt = Date.now();
+      task.progress = 100;
+      this.audit("recalc.completed", {
+        taskId: task.id,
+        bucketsProcessed: task.bucketsProcessed,
+        durationMs: task.completedAt - (task.startedAt || 0),
+        consistencyRate: task.consistencyResult?.consistencyRate
+      });
+      return task;
+    } catch (error) {
+      task.status = "failed";
+      task.error = error instanceof Error ? error.message : "Unknown error";
+      task.completedAt = Date.now();
+      this.audit("recalc.failed", { taskId: task.id, error: task.error });
+      return task;
+    }
+  }
+  /** G4: Verify consistency */
+  verifyConsistency(taskId, preSnapshot, postSnapshot, recalculatedMetrics) {
+    const mismatches = [];
+    const metrics = recalculatedMetrics || postSnapshot.metrics;
+    let totalComparisons = 0;
+    let matchCount = 0;
+    for (const [metric, recalcValue] of Object.entries(metrics)) {
+      const currentValue = preSnapshot.metrics[metric];
+      if (currentValue === void 0) continue;
+      totalComparisons++;
+      const deviation = Math.abs(recalcValue - currentValue);
+      const deviationPercent = currentValue !== 0 ? deviation / Math.abs(currentValue) * 100 : recalcValue !== 0 ? 100 : 0;
+      if (deviationPercent < 0.01) {
+        matchCount++;
+      } else {
+        mismatches.push({
+          metric,
+          bucket: `${preSnapshot.id} \u2192 ${postSnapshot.id}`,
+          currentValue,
+          recalculatedValue: recalcValue,
+          deviation,
+          deviationPercent: Math.round(deviationPercent * 100) / 100,
+          severity: deviationPercent > 10 ? "critical" : deviationPercent > 5 ? "high" : deviationPercent > 1 ? "medium" : "low"
+        });
+      }
+    }
+    const consistencyRate = totalComparisons > 0 ? Math.round(matchCount / totalComparisons * 1e4) / 100 : 100;
+    const verificationHash = simpleHash(JSON.stringify({ taskId, pre: preSnapshot.hash, post: postSnapshot.hash, mismatches }));
+    const result = {
+      id: genId("cr"),
+      taskId,
+      status: mismatches.length === 0 ? "consistent" : consistencyRate > 95 ? "partial" : "inconsistent",
+      totalComparisons,
+      matchCount,
+      mismatchCount: mismatches.length,
+      consistencyRate,
+      mismatches,
+      verifiedAt: Date.now(),
+      verificationHash
+    };
+    this.consistencyResults.set(result.id, result);
+    this.audit("recalc.consistency_check", { taskId, consistencyRate, mismatchCount: mismatches.length, status: result.status });
+    return result;
+  }
+  /** G5: Incremental recalculation */
+  triggerIncremental(input) {
+    const completed = Array.from(this.tasks.values()).filter((t) => t.tenantId === input.tenantId && t.status === "completed").sort((a, b) => (b.completedAt || 0) - (a.completedAt || 0));
+    const last = completed[0];
+    const fromTs = last ? last.toTs : Date.now() - 864e5;
+    return this.triggerRecalculation({
+      tenantId: input.tenantId,
+      triggerType: "manual",
+      triggeredBy: input.triggeredBy,
+      reason: input.reason,
+      fromTs,
+      toTs: Date.now(),
+      granularity: input.granularity,
+      incremental: true,
+      incrementalCheckpoint: last?.id
+    });
+  }
+  /** Create aggregate snapshot */
+  createSnapshot(tenantId, snapshotType, taskId, metrics) {
+    const m = metrics || {};
+    const snapshot = {
+      id: genId("snap"),
+      tenantId,
+      snapshotType,
+      taskId,
+      metrics: m,
+      hash: simpleHash(JSON.stringify(m)),
+      createdAt: Date.now()
+    };
+    this.snapshots.set(snapshot.id, snapshot);
+    return snapshot;
+  }
+  /** Register recalculation handler */
+  registerHandler(granularity, handler) {
+    this.handlers.set(granularity, handler);
+  }
+  /** Query functions */
+  getTask(taskId) {
+    return this.tasks.get(taskId);
+  }
+  getTasks(tenantId, limit = 20) {
+    return Array.from(this.tasks.values()).filter((t) => t.tenantId === tenantId).sort((a, b) => b.createdAt - a.createdAt).slice(0, limit);
+  }
+  getConsistencyResult(taskId) {
+    return Array.from(this.consistencyResults.values()).find((r) => r.taskId === taskId);
+  }
+  getSnapshot(snapshotId) {
+    return this.snapshots.get(snapshotId);
+  }
+  cancelTask(taskId) {
+    const task = this.tasks.get(taskId);
+    if (!task || task.status !== "pending") return false;
+    task.status = "cancelled";
+    return true;
+  }
+  audit(type, details) {
+    if (this.config.onAudit) {
+      this.config.onAudit({ type, details, timestamp: Date.now() });
+    }
+  }
+};
+function createRecalculationEngine(config) {
+  return new RecalculationEngine(config);
+}
+
+// src/autoHarden.ts
+var LEVEL_PRIORITY = {
+  normal: 0,
+  elevated: 1,
+  hardened: 2,
+  lockdown: 3
+};
+var DEFAULT_CONFIG = {
+  enabled: true,
+  levelMeasures: {
+    normal: [],
+    elevated: ["enhanced_audit", "alert_admin"],
+    hardened: ["gate_level_upgrade", "rate_limit_reduce", "enhanced_audit", "alert_admin"],
+    lockdown: ["gate_level_upgrade", "rate_limit_reduce", "enhanced_audit", "ip_block", "session_invalidate", "feature_disable", "alert_admin"]
+  },
+  autoRollbackMs: 30 * 60 * 1e3,
+  rateLimitReductionFactor: 0.25,
+  notifyAdmin: true
+};
+var idCounter2 = 0;
+function genId2(prefix) {
+  return `${prefix}_${Date.now()}_${++idCounter2}`;
+}
+var AutoHardenEngine = class {
+  states = /* @__PURE__ */ new Map();
+  history = [];
+  config;
+  rollbackTimers = /* @__PURE__ */ new Map();
+  maxHistory = 1e3;
+  constructor(config = {}) {
+    this.config = { ...DEFAULT_CONFIG, ...config };
+  }
+  /** Get tenant harden state */
+  getState(tenantId) {
+    return this.states.get(tenantId) || { currentLevel: "normal", activeMeasures: [] };
+  }
+  /** Get current harden level */
+  getLevel(tenantId) {
+    return this.getState(tenantId).currentLevel;
+  }
+  /** Auto-harden (main entry) */
+  async harden(input) {
+    if (!this.config.enabled) throw new Error("AutoHarden is disabled");
+    const state = this.getState(input.tenantId);
+    const traceId = genId2("trace");
+    const targetLevel = input.targetLevel || this.determineLevel(
+      input.manipulationScore || 0,
+      input.reasonCodes || []
+    );
+    if (LEVEL_PRIORITY[targetLevel] <= LEVEL_PRIORITY[state.currentLevel]) {
+      const event2 = {
+        id: genId2("harden"),
+        tenantId: input.tenantId,
+        triggeredBy: input.triggeredBy,
+        reason: `Already at ${state.currentLevel}, target ${targetLevel} skipped`,
+        previousLevel: state.currentLevel,
+        newLevel: state.currentLevel,
+        measures: [],
+        createdAt: Date.now(),
+        rolledBack: false,
+        traceId
+      };
+      this.history.push(event2);
+      return event2;
+    }
+    const measures = this.applyMeasures(input.tenantId, targetLevel);
+    const previousLevel = state.currentLevel;
+    state.currentLevel = targetLevel;
+    state.activeMeasures = measures;
+    state.hardenedSince = Date.now();
+    if (this.config.autoRollbackMs > 0) {
+      state.expectedRollbackAt = Date.now() + this.config.autoRollbackMs;
+      this.scheduleAutoRollback(input.tenantId, this.config.autoRollbackMs);
+    }
+    this.states.set(input.tenantId, state);
+    const event = {
+      id: genId2("harden"),
+      tenantId: input.tenantId,
+      triggeredBy: input.triggeredBy,
+      reason: input.reason,
+      previousLevel,
+      newLevel: targetLevel,
+      measures,
+      createdAt: Date.now(),
+      rolledBack: false,
+      traceId
+    };
+    this.history.push(event);
+    if (this.history.length > this.maxHistory) this.history.shift();
+    state.lastEvent = event;
+    this.audit(event.rolledBack ? "HARDEN_ROLLBACK" : "HARDEN_ACTIVATED", {
+      tenantId: event.tenantId,
+      previousLevel,
+      newLevel: targetLevel,
+      measuresCount: measures.length,
+      measures: measures.map((m) => m.type)
+    });
+    if (this.config.notifyAdmin && this.config.onNotifyAdmin) {
+      try {
+        await this.config.onNotifyAdmin(event);
+      } catch {
+      }
+    }
+    return event;
+  }
+  /** Manual rollback */
+  async rollback(tenantId, rolledBackBy, reason) {
+    const state = this.getState(tenantId);
+    if (state.currentLevel === "normal") throw new Error("Already at normal level");
+    const timer = this.rollbackTimers.get(tenantId);
+    if (timer) {
+      clearTimeout(timer);
+      this.rollbackTimers.delete(tenantId);
+    }
+    const previousLevel = state.currentLevel;
+    const event = {
+      id: genId2("harden"),
+      tenantId,
+      triggeredBy: rolledBackBy,
+      reason: reason || `Manual rollback from ${previousLevel}`,
+      previousLevel,
+      newLevel: "normal",
+      measures: state.activeMeasures.map((m) => ({ ...m, rolledBackAt: Date.now() })),
+      createdAt: Date.now(),
+      rolledBack: true,
+      rolledBackAt: Date.now(),
+      traceId: genId2("trace")
+    };
+    state.currentLevel = "normal";
+    state.activeMeasures = [];
+    state.hardenedSince = void 0;
+    state.expectedRollbackAt = void 0;
+    state.lastEvent = event;
+    this.states.set(tenantId, state);
+    this.history.push(event);
+    this.audit("HARDEN_ROLLBACK", { tenantId, previousLevel, rolledBackBy });
+    return event;
+  }
+  /** Update config */
+  updateConfig(config) {
+    this.config = { ...this.config, ...config };
+    return this.config;
+  }
+  /** Get config */
+  getConfig() {
+    return { ...this.config };
+  }
+  /** Get history */
+  getHistory(tenantId, limit = 50) {
+    const filtered = tenantId ? this.history.filter((e) => e.tenantId === tenantId) : this.history;
+    return filtered.slice(-limit);
+  }
+  /** Get all active hardened states */
+  getActiveStates() {
+    const result = [];
+    this.states.forEach((state, tenantId) => {
+      if (state.currentLevel !== "normal") result.push({ tenantId, state });
+    });
+    return result;
+  }
+  /** Cleanup timers */
+  destroy() {
+    this.rollbackTimers.forEach((t) => clearTimeout(t));
+    this.rollbackTimers.clear();
+  }
+  // Internal
+  determineLevel(score, reasonCodes) {
+    if (reasonCodes.some((c) => c.startsWith("CRIT_"))) return "lockdown";
+    if (score >= 0.8) return "lockdown";
+    if (score >= 0.5) return "hardened";
+    if (score >= 0.3) return "elevated";
+    return "normal";
+  }
+  applyMeasures(tenantId, level) {
+    const types = this.config.levelMeasures[level];
+    return types.map((type) => ({
+      id: genId2("measure"),
+      type,
+      description: this.getMeasureDescription(type, level),
+      applied: true,
+      appliedAt: Date.now()
+    }));
+  }
+  getMeasureDescription(type, level) {
+    const d = {
+      gate_level_upgrade: `Gate approval level upgraded to ${level}`,
+      rate_limit_reduce: `Rate limit reduced to ${this.config.rateLimitReductionFactor * 100}%`,
+      enhanced_audit: "Enhanced audit mode enabled (full recording)",
+      ip_block: "Suspicious IPs blocked",
+      session_invalidate: "All active sessions invalidated",
+      feature_disable: "Non-essential features disabled",
+      alert_admin: "Admin security alert sent"
+    };
+    return d[type] || type;
+  }
+  scheduleAutoRollback(tenantId, delayMs) {
+    const existing = this.rollbackTimers.get(tenantId);
+    if (existing) clearTimeout(existing);
+    const timer = setTimeout(async () => {
+      try {
+        await this.rollback(tenantId, "system:auto_rollback", "Auto rollback after timeout");
+      } catch {
+      }
+      this.rollbackTimers.delete(tenantId);
+    }, delayMs);
+    this.rollbackTimers.set(tenantId, timer);
+  }
+  audit(type, details) {
+    if (this.config.onAudit) {
+      this.config.onAudit({ type, details, timestamp: Date.now() });
+    }
+  }
+};
+function createAutoHardenEngine(config) {
+  return new AutoHardenEngine(config);
+}
+
+// src/costEstimator.ts
+var DEFAULT_MODEL_PRICING = [
+  {
+    modelId: "gpt-4o",
+    modelName: "GPT-4o",
+    inputPricePerKToken: 25e-4,
+    outputPricePerKToken: 0.01,
+    cachedInputPricePerKToken: 125e-5,
+    maxContextLength: 128e3,
+    updatedAt: /* @__PURE__ */ new Date("2025-01-01")
+  },
+  {
+    modelId: "gpt-4o-mini",
+    modelName: "GPT-4o Mini",
+    inputPricePerKToken: 15e-5,
+    outputPricePerKToken: 6e-4,
+    cachedInputPricePerKToken: 75e-6,
+    maxContextLength: 128e3,
+    updatedAt: /* @__PURE__ */ new Date("2025-01-01")
+  },
+  {
+    modelId: "claude-3.5-sonnet",
+    modelName: "Claude 3.5 Sonnet",
+    inputPricePerKToken: 3e-3,
+    outputPricePerKToken: 0.015,
+    cachedInputPricePerKToken: 3e-4,
+    maxContextLength: 2e5,
+    updatedAt: /* @__PURE__ */ new Date("2025-01-01")
+  },
+  {
+    modelId: "claude-3.5-haiku",
+    modelName: "Claude 3.5 Haiku",
+    inputPricePerKToken: 8e-4,
+    outputPricePerKToken: 4e-3,
+    cachedInputPricePerKToken: 8e-5,
+    maxContextLength: 2e5,
+    updatedAt: /* @__PURE__ */ new Date("2025-01-01")
+  },
+  {
+    modelId: "gemini-2.0-flash",
+    modelName: "Gemini 2.0 Flash",
+    inputPricePerKToken: 1e-4,
+    outputPricePerKToken: 4e-4,
+    maxContextLength: 1e6,
+    updatedAt: /* @__PURE__ */ new Date("2025-01-01")
+  }
+];
+var DEFAULT_TOOL_PRICING = [
+  { toolId: "web_search", toolName: "Web Search", costPerCall: 5e-3, multiplier: 1, updatedAt: /* @__PURE__ */ new Date() },
+  { toolId: "code_exec", toolName: "Code Execution", costPerCall: 2e-3, multiplier: 1, updatedAt: /* @__PURE__ */ new Date() },
+  { toolId: "file_read", toolName: "File Read", costPerCall: 1e-3, multiplier: 1, updatedAt: /* @__PURE__ */ new Date() },
+  { toolId: "db_query", toolName: "Database Query", costPerCall: 3e-3, multiplier: 1, updatedAt: /* @__PURE__ */ new Date() },
+  { toolId: "api_call", toolName: "External API Call", costPerCall: 0.01, multiplier: 1.5, updatedAt: /* @__PURE__ */ new Date() }
+];
+var DEFAULT_HUMAN_RATES = [
+  { level: "standard", hourlyRate: 50, avgReviewMinutes: 5 },
+  { level: "senior", hourlyRate: 100, avgReviewMinutes: 10 },
+  { level: "executive", hourlyRate: 200, avgReviewMinutes: 15 }
+];
+var modelPricing = [...DEFAULT_MODEL_PRICING];
+var toolPricing = [...DEFAULT_TOOL_PRICING];
+var humanRates = [...DEFAULT_HUMAN_RATES];
+var accuracyRecords = [];
+var MAX_ACCURACY_RECORDS = 1e4;
+function estimateCost(request) {
+  const id = `est_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+  const model = modelPricing.find((m) => m.modelId === request.modelId) || modelPricing[0];
+  const inputCost = request.estimatedInputTokens / 1e3 * model.inputPricePerKToken;
+  const outputCost = request.estimatedOutputTokens / 1e3 * model.outputPricePerKToken;
+  const modelCostTotal = inputCost + outputCost;
+  const toolItems = [];
+  let toolCostTotal = 0;
+  if (request.toolCalls) {
+    for (const tc of request.toolCalls) {
+      const tool = toolPricing.find((t) => t.toolId === tc.toolId);
+      if (tool) {
+        const total = tc.estimatedCalls * tool.costPerCall * tool.multiplier;
+        toolItems.push({
+          toolId: tc.toolId,
+          calls: tc.estimatedCalls,
+          costPerCall: tool.costPerCall,
+          total
+        });
+        toolCostTotal += total;
+      }
+    }
+  }
+  let humanCost = null;
+  if (request.requiresHumanReview) {
+    const rate = humanRates.find((r) => r.level === (request.humanReviewLevel || "standard")) || humanRates[0];
+    const humanTotal = rate.avgReviewMinutes / 60 * rate.hourlyRate;
+    humanCost = {
+      level: rate.level,
+      hourlyRate: rate.hourlyRate,
+      estimatedMinutes: rate.avgReviewMinutes,
+      total: humanTotal
+    };
+  }
+  const totalCost = modelCostTotal + toolCostTotal + (humanCost?.total || 0);
+  const avgDeviation = getAverageDeviation();
+  const confidence = {
+    low: totalCost * (1 - avgDeviation),
+    high: totalCost * (1 + avgDeviation),
+    level: Math.max(0, 1 - avgDeviation)
+  };
+  return {
+    id,
+    modelCost: {
+      inputCost: Math.round(inputCost * 1e6) / 1e6,
+      outputCost: Math.round(outputCost * 1e6) / 1e6,
+      total: Math.round(modelCostTotal * 1e6) / 1e6
+    },
+    toolCost: {
+      items: toolItems,
+      total: Math.round(toolCostTotal * 1e6) / 1e6
+    },
+    humanCost,
+    totalCost: Math.round(totalCost * 1e6) / 1e6,
+    confidence,
+    estimatedAt: /* @__PURE__ */ new Date()
+  };
+}
+function recordActualCost(estimateId, actualCost) {
+  const record = {
+    estimateId,
+    estimatedCost: 0,
+    // 需要外部传入
+    actualCost,
+    deviation: 0,
+    deviationPercent: 0,
+    recordedAt: /* @__PURE__ */ new Date()
+  };
+  accuracyRecords.push(record);
+  if (accuracyRecords.length > MAX_ACCURACY_RECORDS) accuracyRecords.shift();
+  return record;
+}
+function getAverageDeviation() {
+  if (accuracyRecords.length === 0) return 0.3;
+  const deviations = accuracyRecords.filter((r) => r.estimatedCost > 0).map((r) => Math.abs(r.deviationPercent));
+  if (deviations.length === 0) return 0.3;
+  return deviations.reduce((sum, d) => sum + d, 0) / deviations.length / 100;
+}
+function updateModelPricing(pricing) {
+  const index = modelPricing.findIndex((m) => m.modelId === pricing.modelId);
+  if (index >= 0) {
+    modelPricing[index] = pricing;
+  } else {
+    modelPricing.push(pricing);
+  }
+}
+function updateToolPricing(pricing) {
+  const index = toolPricing.findIndex((t) => t.toolId === pricing.toolId);
+  if (index >= 0) {
+    toolPricing[index] = pricing;
+  } else {
+    toolPricing.push(pricing);
+  }
+}
+function getModelPricingTable() {
+  return [...modelPricing];
+}
+function getToolPricingTable() {
+  return [...toolPricing];
+}
+function getAccuracyStats() {
+  const avgDev = getAverageDeviation();
+  return {
+    totalRecords: accuracyRecords.length,
+    avgDeviation: avgDev,
+    avgDeviationPercent: avgDev * 100,
+    confidenceLevel: Math.max(0, 1 - avgDev)
+  };
+}
+
+// src/semanticDriftDetector.ts
+var DEFAULT_CONFIG2 = {
+  lowThreshold: 0.1,
+  mediumThreshold: 0.3,
+  highThreshold: 0.5,
+  criticalThreshold: 0.7,
+  onDriftDetected: void 0,
+  onAudit: void 0
+};
+var SemanticDriftDetectorEngine = class {
+  fingerprints = /* @__PURE__ */ new Map();
+  history = [];
+  config;
+  constructor(config = {}) {
+    this.config = { ...DEFAULT_CONFIG2, ...config };
+  }
+  /**
+   * 计算策略语义指纹
+   */
+  computeFingerprint(snapshot) {
+    const rules = snapshot.rules;
+    const resourceSet = [...new Set(rules.map((r) => r.resource))].sort();
+    const actionSet = [...new Set(rules.map((r) => r.action))].sort();
+    const fingerprint = {
+      version: snapshot.version,
+      hash: this.hashRules(rules),
+      ruleCount: rules.length,
+      allowCount: rules.filter((r) => r.decision === "ALLOW").length,
+      denyCount: rules.filter((r) => r.decision === "DENY").length,
+      reviewCount: rules.filter((r) => r.decision === "REVIEW").length,
+      resourceSet,
+      actionSet,
+      conditionDepth: this.maxConditionDepth(rules),
+      timestamp: Date.now()
+    };
+    this.fingerprints.set(snapshot.version, fingerprint);
+    return fingerprint;
+  }
+  /**
+   * 检测两个版本间的语义漂移
+   */
+  detectDrift(from, to) {
+    const fromRuleMap = new Map(from.rules.map((r) => [r.id, r]));
+    const toRuleMap = new Map(to.rules.map((r) => [r.id, r]));
+    const addedRules = [];
+    const removedRules = [];
+    const modifiedRules = [];
+    const decisionChanges = [];
+    for (const [id, toRule] of toRuleMap) {
+      const fromRule = fromRuleMap.get(id);
+      if (!fromRule) {
+        addedRules.push(id);
+      } else if (this.ruleChanged(fromRule, toRule)) {
+        modifiedRules.push(id);
+        if (fromRule.decision !== toRule.decision) {
+          decisionChanges.push({ ruleId: id, from: fromRule.decision, to: toRule.decision });
+        }
+      }
+    }
+    for (const id of fromRuleMap.keys()) {
+      if (!toRuleMap.has(id)) {
+        removedRules.push(id);
+      }
+    }
+    const fromResources = new Set(from.rules.map((r) => r.resource));
+    const toResources = new Set(to.rules.map((r) => r.resource));
+    const newResources = [...toResources].filter((r) => !fromResources.has(r));
+    const removedResources = [...fromResources].filter((r) => !toResources.has(r));
+    const totalRules = Math.max(from.rules.length, to.rules.length, 1);
+    const changeCount = addedRules.length + removedRules.length + modifiedRules.length;
+    const decisionWeight = decisionChanges.length * 2;
+    const driftScore = Math.min(1, (changeCount + decisionWeight) / totalRules);
+    let severity = "none";
+    if (driftScore >= this.config.criticalThreshold) severity = "critical";
+    else if (driftScore >= this.config.highThreshold) severity = "high";
+    else if (driftScore >= this.config.mediumThreshold) severity = "medium";
+    else if (driftScore >= this.config.lowThreshold) severity = "low";
+    const result = {
+      fromVersion: from.version,
+      toVersion: to.version,
+      driftScore,
+      ruleCountDelta: to.rules.length - from.rules.length,
+      addedRules,
+      removedRules,
+      modifiedRules,
+      decisionChanges,
+      newResources,
+      removedResources,
+      severity,
+      timestamp: Date.now()
+    };
+    this.history.push(result);
+    if (severity !== "none" && this.config.onDriftDetected) {
+      this.config.onDriftDetected(result);
+    }
+    if (this.config.onAudit) {
+      this.config.onAudit({
+        type: "drift_detected",
+        details: { fromVersion: from.version, toVersion: to.version, driftScore, severity },
+        timestamp: Date.now()
+      });
+    }
+    return result;
+  }
+  /**
+   * 获取漂移历史
+   */
+  getDriftHistory() {
+    return [...this.history];
+  }
+  /**
+   * 获取指纹
+   */
+  getFingerprint(version) {
+    return this.fingerprints.get(version) ?? null;
+  }
+  /**
+   * 获取漂移趋势
+   */
+  getDriftTrend() {
+    return this.history.map((h) => ({
+      version: h.toVersion,
+      driftScore: h.driftScore,
+      timestamp: h.timestamp
+    }));
+  }
+  // ============================================
+  // 私有方法
+  // ============================================
+  hashRules(rules) {
+    const sorted = [...rules].sort((a, b) => a.id.localeCompare(b.id));
+    const str = sorted.map((r) => `${r.id}:${r.action}:${r.resource}:${r.decision}:${r.priority}`).join("|");
+    let hash = 0;
+    for (let i = 0; i < str.length; i++) {
+      const char = str.charCodeAt(i);
+      hash = (hash << 5) - hash + char;
+      hash = hash & hash;
+    }
+    return "fp_" + Math.abs(hash).toString(16).padStart(8, "0");
+  }
+  ruleChanged(a, b) {
+    return a.action !== b.action || a.resource !== b.resource || a.decision !== b.decision || a.priority !== b.priority || JSON.stringify(a.conditions) !== JSON.stringify(b.conditions);
+  }
+  maxConditionDepth(rules) {
+    let max = 0;
+    for (const r of rules) {
+      if (r.conditions) {
+        max = Math.max(max, this.objectDepth(r.conditions));
+      }
+    }
+    return max;
+  }
+  objectDepth(obj, depth = 0) {
+    let max = depth;
+    for (const val of Object.values(obj)) {
+      if (val && typeof val === "object" && !Array.isArray(val)) {
+        max = Math.max(max, this.objectDepth(val, depth + 1));
+      }
+    }
+    return max;
+  }
+};
+function createSemanticDriftDetector(config) {
+  return new SemanticDriftDetectorEngine(config);
+}
+
+// src/costGateEnhanced.ts
+var DEFAULT_CONFIG3 = {
+  defaultBudgetUsd: 100,
+  warningThreshold: 0.8,
+  criticalThreshold: 0.95,
+  humanReviewHourlyRateUsd: 50,
+  toolCosts: [],
+  onAudit: void 0,
+  onBudgetExceeded: void 0
+};
+var CostGateEnhancedEngine = class {
+  records = [];
+  budgets = /* @__PURE__ */ new Map();
+  // tenantId → budgetUsd
+  config;
+  toolCostMap = /* @__PURE__ */ new Map();
+  constructor(config = {}) {
+    this.config = { ...DEFAULT_CONFIG3, ...config };
+    for (const tc of this.config.toolCosts) {
+      this.toolCostMap.set(tc.toolName, tc);
+    }
+  }
+  /**
+   * E2: 记录成本并生成汇总
+   */
+  recordCost(record) {
+    this.records.push(record);
+    this.audit("cost_recorded", record.tenantId, { record });
+    return this.checkBudget(record.tenantId, record.agentId, record.action);
+  }
+  /**
+   * E2: 获取成本汇总（滑动窗口）
+   */
+  getCostSummary(tenantId, period) {
+    const now = Date.now();
+    const periodMs = {
+      "1h": 36e5,
+      "24h": 864e5,
+      "7d": 6048e5,
+      "30d": 2592e6
+    };
+    const startTime = now - (periodMs[period] || 864e5);
+    const filtered = this.records.filter((r) => r.tenantId === tenantId && r.timestamp >= startTime);
+    const byCategory = {
+      llm_inference: 0,
+      tool_call: 0,
+      human_review: 0,
+      storage: 0,
+      network: 0,
+      compute: 0,
+      other: 0
+    };
+    const byAgent = {};
+    const byTool = {};
+    let totalCostUsd = 0;
+    for (const r of filtered) {
+      totalCostUsd += r.costUsd;
+      byCategory[r.category] = (byCategory[r.category] || 0) + r.costUsd;
+      byAgent[r.agentId] = (byAgent[r.agentId] || 0) + r.costUsd;
+      if (r.toolName) {
+        byTool[r.toolName] = (byTool[r.toolName] || 0) + r.costUsd;
+      }
+    }
+    this.audit("summary_generated", tenantId, { period, totalCostUsd, recordCount: filtered.length });
+    return {
+      period,
+      totalCostUsd,
+      byCategory,
+      byAgent,
+      byTool,
+      recordCount: filtered.length,
+      avgCostPerAction: filtered.length > 0 ? totalCostUsd / filtered.length : 0,
+      startTime,
+      endTime: now
+    };
+  }
+  /**
+   * E7: getDailyCostStats — 按天统计
+   */
+  getDailyCostStats(tenantId, days = 30) {
+    const now = Date.now();
+    const startTime = now - days * 864e5;
+    const filtered = this.records.filter((r) => r.tenantId === tenantId && r.timestamp >= startTime);
+    const dailyMap = /* @__PURE__ */ new Map();
+    for (const r of filtered) {
+      const date = new Date(r.timestamp).toISOString().split("T")[0];
+      if (!dailyMap.has(date)) {
+        dailyMap.set(date, { records: [], agents: /* @__PURE__ */ new Set() });
+      }
+      const day = dailyMap.get(date);
+      day.records.push(r);
+      day.agents.add(r.agentId);
+    }
+    const budget = this.budgets.get(tenantId) ?? this.config.defaultBudgetUsd;
+    const dailyBudget = budget / 30;
+    return Array.from(dailyMap.entries()).map(([date, { records, agents }]) => {
+      const byCategory = {
+        llm_inference: 0,
+        tool_call: 0,
+        human_review: 0,
+        storage: 0,
+        network: 0,
+        compute: 0,
+        other: 0
+      };
+      let totalCostUsd = 0;
+      for (const r of records) {
+        totalCostUsd += r.costUsd;
+        byCategory[r.category] = (byCategory[r.category] || 0) + r.costUsd;
+      }
+      return {
+        date,
+        totalCostUsd,
+        byCategory,
+        actionCount: records.length,
+        uniqueAgents: agents.size,
+        budgetUtilization: dailyBudget > 0 ? totalCostUsd / dailyBudget : 0
+      };
+    }).sort((a, b) => a.date.localeCompare(b.date));
+  }
+  /**
+   * E9: 计算工具调用成本
+   */
+  calculateToolCost(toolName, tokenCount) {
+    const config = this.toolCostMap.get(toolName);
+    if (!config) return 1e-3;
+    let cost = config.baseCostUsd + config.perCallCostUsd;
+    if (tokenCount && config.perTokenCostUsd) {
+      cost += tokenCount * config.perTokenCostUsd;
+    }
+    if (config.maxCostPerCallUsd) {
+      cost = Math.min(cost, config.maxCostPerCallUsd);
+    }
+    return cost;
+  }
+  /**
+   * E10: 计算人工审批成本
+   */
+  calculateHumanReviewCost(waitTimeMs, reviewTimeMs) {
+    const totalTimeMs = waitTimeMs + reviewTimeMs;
+    const hours = totalTimeMs / 36e5;
+    const costUsd = hours * this.config.humanReviewHourlyRateUsd;
+    return {
+      reviewId: `review_${Date.now()}`,
+      reviewerType: "human",
+      waitTimeMs,
+      reviewTimeMs,
+      costUsd: Math.round(costUsd * 1e4) / 1e4,
+      hourlyRateUsd: this.config.humanReviewHourlyRateUsd
+    };
+  }
+  /**
+   * 设置租户预算
+   */
+  setBudget(tenantId, budgetUsd) {
+    this.budgets.set(tenantId, budgetUsd);
+  }
+  /**
+   * 获取租户预算使用率
+   */
+  getBudgetUtilization(tenantId) {
+    const budget = this.budgets.get(tenantId) ?? this.config.defaultBudgetUsd;
+    const summary = this.getCostSummary(tenantId, "30d");
+    return {
+      used: summary.totalCostUsd,
+      limit: budget,
+      utilization: budget > 0 ? summary.totalCostUsd / budget : 0
+    };
+  }
+  // ============================================
+  // 私有方法
+  // ============================================
+  checkBudget(tenantId, agentId, action) {
+    const budget = this.budgets.get(tenantId) ?? this.config.defaultBudgetUsd;
+    const summary = this.getCostSummary(tenantId, "30d");
+    const utilization = budget > 0 ? summary.totalCostUsd / budget : 0;
+    if (utilization >= 1) {
+      const event = {
+        code: "BUDGET_EXCEEDED",
+        tenantId,
+        agentId,
+        action,
+        currentCostUsd: summary.totalCostUsd,
+        budgetLimitUsd: budget,
+        overage: summary.totalCostUsd - budget,
+        period: "30d",
+        timestamp: Date.now(),
+        severity: "blocked"
+      };
+      this.audit("budget_exceeded", tenantId, { event });
+      if (this.config.onBudgetExceeded) this.config.onBudgetExceeded(event);
+      return event;
+    }
+    if (utilization >= this.config.criticalThreshold) {
+      this.audit("budget_critical", tenantId, { utilization, budget });
+    } else if (utilization >= this.config.warningThreshold) {
+      this.audit("budget_warning", tenantId, { utilization, budget });
+    }
+    return null;
+  }
+  audit(type, tenantId, details) {
+    if (this.config.onAudit) {
+      this.config.onAudit({ type, tenantId, details, timestamp: Date.now() });
+    }
+  }
+};
+function createCostGateEnhanced(config) {
+  return new CostGateEnhancedEngine(config);
+}
+
+// src/budgetMultiLevel.ts
+var DEFAULT_ALERT_RULES = [
+  { id: "warn_80", threshold: 0.8, severity: "warning", action: "notify", cooldownMs: 36e5 },
+  { id: "crit_95", threshold: 0.95, severity: "critical", action: "throttle", cooldownMs: 18e5 },
+  { id: "block_100", threshold: 1, severity: "critical", action: "block", cooldownMs: 3e5 }
+];
+var DEFAULT_CONFIG4 = {
+  defaultAlertRules: DEFAULT_ALERT_RULES,
+  trendWindowDays: 30,
+  onAlert: void 0,
+  onAudit: void 0
+};
+var MultiLevelBudgetEngine = class {
+  nodes = /* @__PURE__ */ new Map();
+  spendHistory = [];
+  config;
+  constructor(config = {}) {
+    this.config = { ...DEFAULT_CONFIG4, ...config };
+  }
+  /**
+   * F6: 创建预算节点
+   */
+  createNode(node) {
+    const budgetNode = {
+      ...node,
+      spentUsd: 0,
+      children: [],
+      alertRules: node.alertRules ?? [...this.config.defaultAlertRules]
+    };
+    this.nodes.set(budgetNode.id, budgetNode);
+    if (node.parentId) {
+      const parent = this.nodes.get(node.parentId);
+      if (parent) {
+        parent.children.push(budgetNode.id);
+      }
+    }
+    return budgetNode;
+  }
+  /**
+   * F6: 记录支出（向上冒泡到所有父级）
+   */
+  recordSpend(nodeId, amount) {
+    const alerts = [];
+    let current = this.nodes.get(nodeId);
+    while (current) {
+      current.spentUsd += amount;
+      this.spendHistory.push({ nodeId: current.id, amount, timestamp: Date.now() });
+      const nodeAlerts = this.checkAlerts(current);
+      alerts.push(...nodeAlerts);
+      current = current.parentId ? this.nodes.get(current.parentId) : void 0;
+    }
+    return alerts;
+  }
+  /**
+   * F6: 获取节点预算状态（含子节点汇总）
+   */
+  getNodeStatus(nodeId) {
+    const node = this.nodes.get(nodeId);
+    if (!node) return null;
+    const childrenSpent = this.getChildrenSpent(nodeId);
+    const utilization = node.budgetUsd > 0 ? node.spentUsd / node.budgetUsd : 0;
+    return {
+      node,
+      utilization,
+      childrenSpent,
+      remaining: Math.max(0, node.budgetUsd - node.spentUsd)
+    };
+  }
+  /**
+   * F7: 预测预算耗尽日期
+   */
+  predictExhaustion(nodeId) {
+    const node = this.nodes.get(nodeId);
+    if (!node || node.spentUsd === 0) return null;
+    const remaining = node.budgetUsd - node.spentUsd;
+    if (remaining <= 0) return (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+    const sevenDaysAgo = Date.now() - 7 * 864e5;
+    const recentSpends = this.spendHistory.filter(
+      (s) => s.nodeId === nodeId && s.timestamp >= sevenDaysAgo
+    );
+    const recentTotal = recentSpends.reduce((sum, s) => sum + s.amount, 0);
+    const dailyRate = recentTotal / 7;
+    if (dailyRate <= 0) return null;
+    const daysRemaining = remaining / dailyRate;
+    const exhaustionDate = new Date(Date.now() + daysRemaining * 864e5);
+    return exhaustionDate.toISOString().split("T")[0];
+  }
+  /**
+   * F8: 生成成本报告
+   */
+  generateReport(rootNodeId) {
+    const nodes = rootNodeId ? this.getSubtree(rootNodeId) : Array.from(this.nodes.values());
+    const byLevel = {
+      organization: { budget: 0, spent: 0, count: 0 },
+      team: { budget: 0, spent: 0, count: 0 },
+      project: { budget: 0, spent: 0, count: 0 },
+      agent: { budget: 0, spent: 0, count: 0 }
+    };
+    let totalBudget = 0;
+    let totalSpent = 0;
+    for (const n of nodes) {
+      byLevel[n.level].budget += n.budgetUsd;
+      byLevel[n.level].spent += n.spentUsd;
+      byLevel[n.level].count++;
+      if (n.children.length === 0) {
+        totalBudget += n.budgetUsd;
+        totalSpent += n.spentUsd;
+      }
+    }
+    const topSpenders = nodes.sort((a, b) => b.spentUsd - a.spentUsd).slice(0, 10).map((n) => ({ id: n.id, name: n.name, level: n.level, spent: n.spentUsd }));
+    const trend = this.generateTrend(rootNodeId);
+    return {
+      reportId: `report_${Date.now()}`,
+      generatedAt: Date.now(),
+      period: { start: Date.now() - this.config.trendWindowDays * 864e5, end: Date.now() },
+      totalBudgetUsd: totalBudget,
+      totalSpentUsd: totalSpent,
+      utilization: totalBudget > 0 ? totalSpent / totalBudget : 0,
+      byLevel,
+      topSpenders,
+      alerts: [],
+      trend
+    };
+  }
+  /**
+   * 获取所有节点
+   */
+  listNodes(level) {
+    const all = Array.from(this.nodes.values());
+    return level ? all.filter((n) => n.level === level) : all;
+  }
+  // ============================================
+  // 私有方法
+  // ============================================
+  checkAlerts(node) {
+    const alerts = [];
+    const utilization = node.budgetUsd > 0 ? node.spentUsd / node.budgetUsd : 0;
+    for (const rule of node.alertRules) {
+      if (utilization >= rule.threshold) {
+        if (rule.lastTriggeredAt && Date.now() - rule.lastTriggeredAt < rule.cooldownMs) {
+          continue;
+        }
+        rule.lastTriggeredAt = Date.now();
+        const alert = {
+          ruleId: rule.id,
+          nodeId: node.id,
+          nodeName: node.name,
+          level: node.level,
+          severity: rule.severity,
+          action: rule.action,
+          utilization,
+          budgetUsd: node.budgetUsd,
+          spentUsd: node.spentUsd,
+          remainingUsd: Math.max(0, node.budgetUsd - node.spentUsd),
+          predictedExhaustionDate: this.predictExhaustion(node.id) ?? void 0,
+          timestamp: Date.now()
+        };
+        alerts.push(alert);
+        if (this.config.onAlert) this.config.onAlert(alert);
+      }
+    }
+    return alerts;
+  }
+  getChildrenSpent(nodeId) {
+    const node = this.nodes.get(nodeId);
+    if (!node) return 0;
+    let total = 0;
+    for (const childId of node.children) {
+      const child = this.nodes.get(childId);
+      if (child) {
+        total += child.spentUsd;
+      }
+    }
+    return total;
+  }
+  getSubtree(nodeId) {
+    const result = [];
+    const queue = [nodeId];
+    while (queue.length > 0) {
+      const id = queue.shift();
+      const node = this.nodes.get(id);
+      if (node) {
+        result.push(node);
+        queue.push(...node.children);
+      }
+    }
+    return result;
+  }
+  generateTrend(rootNodeId) {
+    const nodeIds = rootNodeId ? new Set(this.getSubtree(rootNodeId).map((n) => n.id)) : null;
+    const startTime = Date.now() - this.config.trendWindowDays * 864e5;
+    const filtered = this.spendHistory.filter((s) => {
+      if (s.timestamp < startTime) return false;
+      if (nodeIds && !nodeIds.has(s.nodeId)) return false;
+      return true;
+    });
+    const dailyMap = /* @__PURE__ */ new Map();
+    for (const s of filtered) {
+      const date = new Date(s.timestamp).toISOString().split("T")[0];
+      dailyMap.set(date, (dailyMap.get(date) ?? 0) + s.amount);
+    }
+    return Array.from(dailyMap.entries()).map(([date, spent]) => ({ date, spent })).sort((a, b) => a.date.localeCompare(b.date));
+  }
+};
+function createMultiLevelBudget(config) {
+  return new MultiLevelBudgetEngine(config);
+}
+
+// src/evolutionChannel.ts
+var DEFAULT_CONFIG5 = {
+  maxVersions: 50,
+  canaryMinDurationMs: 36e5,
+  // 1 小时
+  autoPromoteThreshold: 0.95,
+  onAudit: void 0
+};
+var EvolutionChannelEngine = class {
+  versions = /* @__PURE__ */ new Map();
+  activeVersionId = null;
+  canaryVersionId = null;
+  abTests = /* @__PURE__ */ new Map();
+  config;
+  constructor(config = {}) {
+    this.config = { ...DEFAULT_CONFIG5, ...config };
+  }
+  /**
+   * 发布新策略版本
+   */
+  publish(version) {
+    if (this.versions.size >= this.config.maxVersions) {
+      this.cleanupOldVersions();
+    }
+    version.status = "draft";
+    version.createdAt = Date.now();
+    this.versions.set(version.id, version);
+    this.audit("publish", version.id, version.version, version.createdBy);
+    return version;
+  }
+  /**
+   * 启动灰度发布
+   */
+  startCanary(versionId, percent, actor) {
+    const version = this.versions.get(versionId);
+    if (!version || version.status !== "draft") return false;
+    if (percent < 1 || percent > 99) return false;
+    version.status = "canary";
+    version.canaryPercent = percent;
+    this.canaryVersionId = versionId;
+    this.audit("canary_start", versionId, version.version, actor, { percent });
+    return true;
+  }
+  /**
+   * 灰度晋升为正式版本
+   */
+  promoteCanary(actor) {
+    if (!this.canaryVersionId) return false;
+    const canary = this.versions.get(this.canaryVersionId);
+    if (!canary || canary.status !== "canary") return false;
+    const elapsed = Date.now() - canary.createdAt;
+    if (elapsed < this.config.canaryMinDurationMs) return false;
+    if (this.activeVersionId) {
+      const old = this.versions.get(this.activeVersionId);
+      if (old) old.status = "deprecated";
+    }
+    canary.status = "active";
+    canary.canaryPercent = 100;
+    this.activeVersionId = this.canaryVersionId;
+    this.canaryVersionId = null;
+    this.audit("canary_promote", canary.id, canary.version, actor);
+    return true;
+  }
+  /**
+   * 灰度回滚
+   */
+  rollbackCanary(actor) {
+    if (!this.canaryVersionId) return false;
+    const canary = this.versions.get(this.canaryVersionId);
+    if (!canary) return false;
+    canary.status = "rollback";
+    canary.canaryPercent = 0;
+    this.canaryVersionId = null;
+    this.audit("canary_rollback", canary.id, canary.version, actor);
+    return true;
+  }
+  /**
+   * 路由决策：根据灰度百分比选择策略版本
+   */
+  resolveVersion(requestHash) {
+    if (this.canaryVersionId) {
+      const canary = this.versions.get(this.canaryVersionId);
+      if (canary && canary.status === "canary") {
+        const hash = requestHash ?? Math.random() * 100;
+        if (hash % 100 < canary.canaryPercent) {
+          return canary;
+        }
+      }
+    }
+    if (this.activeVersionId) {
+      return this.versions.get(this.activeVersionId) ?? null;
+    }
+    return null;
+  }
+  /**
+   * 启动 A/B 测试
+   */
+  startABTest(testId, controlId, treatmentId, trafficSplit, actor) {
+    const control = this.versions.get(controlId);
+    const treatment = this.versions.get(treatmentId);
+    if (!control || !treatment) return null;
+    const test = {
+      id: testId,
+      controlVersionId: controlId,
+      treatmentVersionId: treatmentId,
+      trafficSplit: Math.max(1, Math.min(99, trafficSplit)),
+      startedAt: Date.now(),
+      status: "running",
+      metrics: {
+        controlDecisions: 0,
+        treatmentDecisions: 0,
+        controlAllowRate: 0,
+        treatmentAllowRate: 0,
+        controlAvgLatencyMs: 0,
+        treatmentAvgLatencyMs: 0
+      }
+    };
+    this.abTests.set(testId, test);
+    this.audit("ab_test_start", testId, `${control.version} vs ${treatment.version}`, actor, { trafficSplit });
+    return test;
+  }
+  /**
+   * A/B 测试路由
+   */
+  resolveABTest(testId, requestHash) {
+    const test = this.abTests.get(testId);
+    if (!test || test.status !== "running") return null;
+    const hash = requestHash ?? Math.random() * 100;
+    const isTreatment = hash % 100 < test.trafficSplit;
+    const versionId = isTreatment ? test.treatmentVersionId : test.controlVersionId;
+    const version = this.versions.get(versionId);
+    if (!version) return null;
+    return { version, group: isTreatment ? "treatment" : "control" };
+  }
+  /**
+   * 结束 A/B 测试
+   */
+  endABTest(testId, actor) {
+    const test = this.abTests.get(testId);
+    if (!test) return null;
+    test.status = "completed";
+    this.audit("ab_test_end", testId, "", actor, { metrics: test.metrics });
+    return test;
+  }
+  /**
+   * 获取所有版本
+   */
+  listVersions() {
+    return Array.from(this.versions.values()).sort((a, b) => b.createdAt - a.createdAt);
+  }
+  /**
+   * 获取当前 active 版本
+   */
+  getActiveVersion() {
+    return this.activeVersionId ? this.versions.get(this.activeVersionId) ?? null : null;
+  }
+  // ============================================
+  // 私有方法
+  // ============================================
+  cleanupOldVersions() {
+    const deprecated = Array.from(this.versions.values()).filter((v) => v.status === "deprecated" || v.status === "rollback").sort((a, b) => a.createdAt - b.createdAt);
+    if (deprecated.length > 0) {
+      this.versions.delete(deprecated[0].id);
+    }
+  }
+  audit(type, policyId, version, actor, details) {
+    if (this.config.onAudit) {
+      this.config.onAudit({ type, policyId, version, timestamp: Date.now(), actor, details });
+    }
+  }
+};
+function createEvolutionChannel(config) {
+  return new EvolutionChannelEngine(config);
+}
+
+// src/twoPhaseRouter.ts
+var DEFAULT_HARD_RULES = [
+  {
+    id: "HR-001",
+    name: "high_risk_requires_powerful",
+    condition: (req, candidate) => (req.riskLevel === "critical" || req.riskLevel === "high") && candidate.tier === "cheap",
+    reasonCode: "RISK_TIER_MISMATCH",
+    reasonTemplate: "High/critical risk tasks cannot use cheap tier models",
+    enabled: true
+  },
+  {
+    id: "HR-002",
+    name: "critical_requires_powerful_only",
+    condition: (req, candidate) => req.riskLevel === "critical" && candidate.tier !== "powerful",
+    reasonCode: "RISK_TIER_MISMATCH",
+    reasonTemplate: "Critical risk tasks require powerful tier models only",
+    enabled: true
+  },
+  {
+    id: "HR-003",
+    name: "budget_hard_cap",
+    condition: (req, candidate) => {
+      if (!req.maxCostUsd) return false;
+      const estimatedCost = req.estimatedTokens / 1e3 * candidate.costPer1kTokens;
+      return estimatedCost > req.maxCostUsd;
+    },
+    reasonCode: "COST_EXCEEDS_BUDGET",
+    reasonTemplate: "Estimated cost exceeds hard budget cap",
+    enabled: true
+  }
+];
+var DEFAULT_SCORING_WEIGHTS = {
+  cost: 0.25,
+  latency: 0.2,
+  capability: 0.25,
+  weight: 0.15,
+  tierMatch: 0.15
+};
+var TwoPhaseRouter = class {
+  config;
+  constructor(config) {
+    this.config = {
+      ...config,
+      hardRules: config.hardRules.length > 0 ? config.hardRules : DEFAULT_HARD_RULES,
+      scoringWeights: config.scoringWeights ?? DEFAULT_SCORING_WEIGHTS
+    };
+  }
+  /**
+   * Phase 1: Eligibility — 硬性规则过滤
+   */
+  evaluateEligibility(request) {
+    return this.config.models.map((candidate) => {
+      if (!candidate.enabled) {
+        return {
+          candidateId: candidate.id,
+          eligible: false,
+          reasonCode: "DISABLED",
+          reasonDetail: `Model ${candidate.name} is disabled`
+        };
+      }
+      const missingCaps = request.requiredCapabilities.filter(
+        (cap) => !candidate.capabilities.includes(cap)
+      );
+      if (missingCaps.length > 0) {
+        return {
+          candidateId: candidate.id,
+          eligible: false,
+          reasonCode: "CAPABILITY_MISSING",
+          reasonDetail: `Missing capabilities: ${missingCaps.join(", ")}`
+        };
+      }
+      if (request.estimatedTokens > candidate.maxContextTokens) {
+        return {
+          candidateId: candidate.id,
+          eligible: false,
+          reasonCode: "CONTEXT_TOO_LARGE",
+          reasonDetail: `Estimated ${request.estimatedTokens} tokens exceeds max ${candidate.maxContextTokens}`
+        };
+      }
+      if (request.maxLatencyMs && candidate.avgLatencyMs > request.maxLatencyMs) {
+        return {
+          candidateId: candidate.id,
+          eligible: false,
+          reasonCode: "LATENCY_EXCEEDS_LIMIT",
+          reasonDetail: `Avg latency ${candidate.avgLatencyMs}ms exceeds limit ${request.maxLatencyMs}ms`
+        };
+      }
+      for (const rule of this.config.hardRules) {
+        if (!rule.enabled) continue;
+        if (rule.condition(request, candidate)) {
+          return {
+            candidateId: candidate.id,
+            eligible: false,
+            reasonCode: rule.reasonCode,
+            reasonDetail: rule.reasonTemplate
+          };
+        }
+      }
+      return {
+        candidateId: candidate.id,
+        eligible: true,
+        reasonCode: "ELIGIBLE",
+        reasonDetail: "Passed all eligibility checks"
+      };
+    });
+  }
+  /**
+   * Phase 2: Scoring — 软性指标加权评分
+   */
+  evaluateScoring(request, eligibleIds) {
+    const eligible = this.config.models.filter((m) => eligibleIds.has(m.id));
+    if (eligible.length === 0) return [];
+    const w = this.config.scoringWeights;
+    const maxCost = Math.max(...eligible.map((m) => m.costPer1kTokens), 1e-3);
+    const maxLatency = Math.max(...eligible.map((m) => m.avgLatencyMs), 1);
+    return eligible.map((candidate) => {
+      const costScore = 100 * (1 - candidate.costPer1kTokens / maxCost);
+      const latencyScore = 100 * (1 - candidate.avgLatencyMs / maxLatency);
+      const matchedCaps = request.requiredCapabilities.filter(
+        (cap) => candidate.capabilities.includes(cap)
+      ).length;
+      const capabilityScore = request.requiredCapabilities.length > 0 ? 100 * (matchedCaps / request.requiredCapabilities.length) : 50;
+      const weightScore = candidate.weight;
+      let tierMatchScore = 50;
+      if (request.preferredTier) {
+        if (candidate.tier === request.preferredTier) tierMatchScore = 100;
+        else {
+          const tierOrder = ["cheap", "balanced", "powerful"];
+          const diff = Math.abs(
+            tierOrder.indexOf(candidate.tier) - tierOrder.indexOf(request.preferredTier)
+          );
+          tierMatchScore = Math.max(0, 100 - diff * 40);
+        }
+      }
+      const score = costScore * w.cost + latencyScore * w.latency + capabilityScore * w.capability + weightScore * w.weight + tierMatchScore * w.tierMatch;
+      return {
+        candidateId: candidate.id,
+        score: Math.round(score * 100) / 100,
+        breakdown: {
+          costScore: Math.round(costScore * 100) / 100,
+          latencyScore: Math.round(latencyScore * 100) / 100,
+          capabilityScore: Math.round(capabilityScore * 100) / 100,
+          weightScore: Math.round(weightScore * 100) / 100,
+          tierMatchScore: Math.round(tierMatchScore * 100) / 100
+        }
+      };
+    });
+  }
+  /**
+   * Main routing decision
+   */
+  async route(request) {
+    const startTime = Date.now();
+    const phase1Results = this.evaluateEligibility(request);
+    const eligibleIds = new Set(
+      phase1Results.filter((r) => r.eligible).map((r) => r.candidateId)
+    );
+    const phase2Results = this.evaluateScoring(request, eligibleIds);
+    phase2Results.sort((a, b) => b.score - a.score);
+    let selectedModelId;
+    let fallbackUsed = false;
+    const reasonChain = [];
+    if (phase2Results.length > 0) {
+      selectedModelId = phase2Results[0].candidateId;
+      reasonChain.push(
+        `Phase 1: ${eligibleIds.size}/${this.config.models.length} candidates eligible`
+      );
+      reasonChain.push(
+        `Phase 2: Top scorer = ${selectedModelId} (score: ${phase2Results[0].score})`
+      );
+      const rejected = phase1Results.filter((r) => !r.eligible);
+      if (rejected.length > 0) {
+        reasonChain.push(
+          `Rejected: ${rejected.map((r) => `${r.candidateId}(${r.reasonCode})`).join(", ")}`
+        );
+      }
+    } else if (this.config.fallbackModelId) {
+      selectedModelId = this.config.fallbackModelId;
+      fallbackUsed = true;
+      reasonChain.push("Phase 1: No eligible candidates");
+      reasonChain.push(`Fallback: Using ${selectedModelId}`);
+    } else {
+      const leastBad = this.config.models.find((m) => m.enabled);
+      selectedModelId = leastBad?.id ?? this.config.models[0]?.id ?? "unknown";
+      fallbackUsed = true;
+      reasonChain.push("Phase 1: No eligible candidates, no fallback configured");
+      reasonChain.push(`Emergency: Using ${selectedModelId}`);
+    }
+    const selectedModel = this.config.models.find((m) => m.id === selectedModelId);
+    const decisionTimeMs = Date.now() - startTime;
+    const decision = {
+      selectedModelId,
+      selectedModelName: selectedModel?.name ?? "unknown",
+      tier: selectedModel?.tier ?? this.config.defaultTier,
+      phase1Results,
+      phase2Results,
+      reasonChain,
+      totalCandidates: this.config.models.length,
+      eligibleCandidates: eligibleIds.size,
+      decisionTimeMs,
+      fallbackUsed
+    };
+    if (this.config.onDecision) {
+      try {
+        await this.config.onDecision(decision);
+      } catch {
+      }
+    }
+    if (this.config.onAudit) {
+      try {
+        await this.config.onAudit({
+          type: "routing_decision",
+          data: {
+            selectedModelId,
+            tier: decision.tier,
+            eligibleCount: eligibleIds.size,
+            totalCount: this.config.models.length,
+            fallbackUsed,
+            decisionTimeMs,
+            taskType: request.taskType,
+            riskLevel: request.riskLevel
+          }
+        });
+      } catch {
+      }
+    }
+    return decision;
+  }
+  /**
+   * Get models by tier
+   */
+  getModelsByTier(tier) {
+    return this.config.models.filter((m) => m.tier === tier && m.enabled);
+  }
+  /**
+   * Update model status
+   */
+  updateModel(modelId, updates) {
+    const idx = this.config.models.findIndex((m) => m.id === modelId);
+    if (idx === -1) return false;
+    this.config.models[idx] = { ...this.config.models[idx], ...updates };
+    return true;
+  }
+  /**
+   * Add a new hard rule
+   */
+  addHardRule(rule) {
+    this.config.hardRules.push(rule);
+  }
+  /**
+   * Get routing explanation for a specific request (dry run)
+   */
+  async explain(request) {
+    const decision = await this.route(request);
+    const lines = [
+      `=== SOVR Routing Explanation ===`,
+      `Task: ${request.taskType} | Risk: ${request.riskLevel}`,
+      `Required Capabilities: ${request.requiredCapabilities.join(", ") || "none"}`,
+      `Estimated Tokens: ${request.estimatedTokens}`,
+      ``,
+      `--- Phase 1: Eligibility ---`
+    ];
+    for (const r of decision.phase1Results) {
+      const model = this.config.models.find((m) => m.id === r.candidateId);
+      lines.push(
+        `  ${r.eligible ? "\u2705" : "\u274C"} ${model?.name ?? r.candidateId} [${r.reasonCode}] ${r.reasonDetail}`
+      );
+    }
+    lines.push("", `--- Phase 2: Scoring ---`);
+    for (const r of decision.phase2Results) {
+      const model = this.config.models.find((m) => m.id === r.candidateId);
+      lines.push(
+        `  ${model?.name ?? r.candidateId}: ${r.score} (cost=${r.breakdown.costScore} lat=${r.breakdown.latencyScore} cap=${r.breakdown.capabilityScore})`
+      );
+    }
+    lines.push(
+      "",
+      `--- Decision ---`,
+      `Selected: ${decision.selectedModelName} (${decision.tier})`,
+      `Fallback: ${decision.fallbackUsed ? "YES" : "NO"}`,
+      `Time: ${decision.decisionTimeMs}ms`
+    );
+    return { decision, explanation: lines.join("\n") };
+  }
+};
+
+// src/timeSeriesAggregator.ts
+var DEFAULT_TSA_CONFIG = {
+  windowSizeMs: 6e4,
+  // 1 minute
+  windowType: "tumbling",
+  maxWindows: 60,
+  // Keep 1 hour of 1-min windows
+  maxValuesPerWindow: 1e4
+};
+function percentile(sorted, p) {
+  if (sorted.length === 0) return 0;
+  if (sorted.length === 1) return sorted[0];
+  const idx = p / 100 * (sorted.length - 1);
+  const lower = Math.floor(idx);
+  const upper = Math.ceil(idx);
+  if (lower === upper) return sorted[lower];
+  return sorted[lower] + (sorted[upper] - sorted[lower]) * (idx - lower);
+}
+var TimeSeriesAggregator = class {
+  windows = /* @__PURE__ */ new Map();
+  closedResults = [];
+  config;
+  totalDedups = 0;
+  constructor(config) {
+    this.config = { ...DEFAULT_TSA_CONFIG, ...config };
+  }
+  /**
+   * Ingest a data point (idempotent — duplicates are rejected)
+   */
+  async ingest(point) {
+    const windowId = this.getWindowId(point.timestamp);
+    let window = this.windows.get(windowId);
+    if (!window) {
+      window = this.createWindow(windowId, point.timestamp);
+      this.windows.set(windowId, window);
+      this.evictOldWindows();
+    }
+    if (window.seenIds.has(point.id)) {
+      this.totalDedups++;
+      return { accepted: false, windowId, duplicate: true };
+    }
+    window.seenIds.add(point.id);
+    window.count++;
+    window.sum += point.value;
+    window.min = Math.min(window.min, point.value);
+    window.max = Math.max(window.max, point.value);
+    if (window.values.length < this.config.maxValuesPerWindow) {
+      window.values.push(point.value);
+    }
+    return { accepted: true, windowId, duplicate: false };
+  }
+  /**
+   * Ingest multiple points (batch)
+   */
+  async ingestBatch(points) {
+    let accepted = 0;
+    let duplicates = 0;
+    let errors = 0;
+    for (const point of points) {
+      try {
+        const result = await this.ingest(point);
+        if (result.accepted) accepted++;
+        if (result.duplicate) duplicates++;
+      } catch {
+        errors++;
+      }
+    }
+    return { accepted, duplicates, errors };
+  }
+  /**
+   * Get aggregation result for a specific window
+   */
+  getWindowResult(windowId) {
+    const window = this.windows.get(windowId);
+    if (!window) {
+      return this.closedResults.find((r) => r.windowId === windowId) ?? null;
+    }
+    return this.computeResult(window);
+  }
+  /**
+   * Get current (latest) window result
+   */
+  getCurrentResult() {
+    const now = Date.now();
+    const windowId = this.getWindowId(now);
+    return this.getWindowResult(windowId);
+  }
+  /**
+   * Get results for a time range
+   */
+  getResultsInRange(startMs, endMs) {
+    const results = [];
+    for (const window of this.windows.values()) {
+      if (window.startMs >= startMs && window.endMs <= endMs) {
+        results.push(this.computeResult(window));
+      }
+    }
+    for (const result of this.closedResults) {
+      if (result.startMs >= startMs && result.endMs <= endMs) {
+        if (!results.find((r) => r.windowId === result.windowId)) {
+          results.push(result);
+        }
+      }
+    }
+    return results.sort((a, b) => a.startMs - b.startMs);
+  }
+  /**
+   * Close current window and emit result
+   */
+  async closeWindow(windowId) {
+    const window = this.windows.get(windowId);
+    if (!window) return null;
+    const result = this.computeResult(window);
+    this.closedResults.push(result);
+    this.windows.delete(windowId);
+    if (this.closedResults.length > this.config.maxWindows * 2) {
+      this.closedResults = this.closedResults.slice(-this.config.maxWindows);
+    }
+    if (this.config.onWindowClosed) {
+      try {
+        await this.config.onWindowClosed(result);
+      } catch {
+      }
+    }
+    if (this.config.onAudit) {
+      try {
+        await this.config.onAudit({
+          type: "window_closed",
+          data: {
+            windowId,
+            count: result.metrics.count,
+            avg: result.metrics.avg,
+            p95: result.metrics.p95,
+            dedupCount: result.dedupCount
+          }
+        });
+      } catch {
+      }
+    }
+    return result;
+  }
+  /**
+   * Get overall stats
+   */
+  getStats() {
+    let totalDataPoints = 0;
+    for (const w of this.windows.values()) totalDataPoints += w.count;
+    for (const r of this.closedResults) totalDataPoints += r.metrics.count;
+    return {
+      activeWindows: this.windows.size,
+      closedWindows: this.closedResults.length,
+      totalDedups: this.totalDedups,
+      totalDataPoints
+    };
+  }
+  /**
+   * Reset all windows
+   */
+  reset() {
+    this.windows.clear();
+    this.closedResults = [];
+    this.totalDedups = 0;
+  }
+  // ─── Internal ────────────────────────────────────────────────────
+  getWindowId(timestamp) {
+    const windowStart = Math.floor(timestamp / this.config.windowSizeMs) * this.config.windowSizeMs;
+    return `w_${windowStart}`;
+  }
+  createWindow(windowId, timestamp) {
+    const windowStart = Math.floor(timestamp / this.config.windowSizeMs) * this.config.windowSizeMs;
+    return {
+      windowId,
+      windowType: this.config.windowType,
+      startMs: windowStart,
+      endMs: windowStart + this.config.windowSizeMs,
+      count: 0,
+      sum: 0,
+      min: Infinity,
+      max: -Infinity,
+      values: [],
+      seenIds: /* @__PURE__ */ new Set()
+    };
+  }
+  computeResult(window) {
+    const sorted = [...window.values].sort((a, b) => a - b);
+    const durationSec = (window.endMs - window.startMs) / 1e3;
+    return {
+      windowId: window.windowId,
+      windowType: window.windowType,
+      startMs: window.startMs,
+      endMs: window.endMs,
+      metrics: {
+        count: window.count,
+        sum: window.sum,
+        avg: window.count > 0 ? window.sum / window.count : 0,
+        min: window.min === Infinity ? 0 : window.min,
+        max: window.max === -Infinity ? 0 : window.max,
+        p50: percentile(sorted, 50),
+        p95: percentile(sorted, 95),
+        p99: percentile(sorted, 99),
+        rate: durationSec > 0 ? window.count / durationSec : 0
+      },
+      dedupCount: window.seenIds.size - window.count > 0 ? 0 : this.totalDedups
+    };
+  }
+  evictOldWindows() {
+    if (this.windows.size <= this.config.maxWindows) return;
+    const sorted = Array.from(this.windows.entries()).sort((a, b) => a[1].startMs - b[1].startMs);
+    while (sorted.length > this.config.maxWindows) {
+      const [id, window] = sorted.shift();
+      this.closedResults.push(this.computeResult(window));
+      this.windows.delete(id);
+    }
+  }
+};
+
+// src/valuationModel.ts
+var ValuationModel = class {
+  config;
+  constructor(config) {
+    this.config = config ?? {};
+  }
+  /**
+   * Calculate TAM/SAM/SOM
+   */
+  calculateMarketSize(input) {
+    return {
+      tam: input.totalMarketUsd,
+      sam: input.totalMarketUsd * input.serviceablePercent,
+      som: input.totalMarketUsd * input.serviceablePercent * input.obtainablePercent,
+      year: input.year,
+      growthRate: input.growthRate,
+      assumptions: input.assumptions
+    };
+  }
+  /**
+   * Calculate Unit Economics
+   */
+  calculateUnitEconomics(input) {
+    const netChurn = input.churnRate - input.expansionRate;
+    const effectiveChurn = Math.max(netChurn, 1e-3);
+    const ltv = input.arpu * input.grossMargin / effectiveChurn;
+    const paybackMonths = input.cac / (input.arpu * input.grossMargin);
+    return {
+      arpu: input.arpu,
+      cac: input.cac,
+      ltv: Math.round(ltv * 100) / 100,
+      ltvCacRatio: Math.round(ltv / input.cac * 100) / 100,
+      paybackMonths: Math.round(paybackMonths * 10) / 10,
+      grossMargin: input.grossMargin,
+      churnRate: input.churnRate,
+      expansionRate: input.expansionRate
+    };
+  }
+  /**
+   * DCF Valuation
+   */
+  calculateDCF(input) {
+    const fcfs = [];
+    const discountedFcfs = [];
+    for (let i = 0; i < input.projectedRevenues.length; i++) {
+      const revenue = input.projectedRevenues[i];
+      const operatingIncome = revenue * input.operatingMargin;
+      const afterTax = operatingIncome * (1 - input.taxRate);
+      const capex = revenue * input.capexRatio;
+      const fcf = afterTax - capex;
+      fcfs.push(fcf);
+      const discountFactor = Math.pow(1 + input.discountRate, i + 1);
+      discountedFcfs.push(fcf / discountFactor);
+    }
+    const presentValue = discountedFcfs.reduce((sum, v) => sum + v, 0);
+    const lastFcf = fcfs[fcfs.length - 1] ?? 0;
+    const terminalFcf = lastFcf * (1 + input.terminalGrowthRate);
+    const terminalValue = terminalFcf / (input.discountRate - input.terminalGrowthRate);
+    const discountedTerminal = terminalValue / Math.pow(1 + input.discountRate, input.projectedRevenues.length);
+    const enterpriseValue = presentValue + discountedTerminal;
+    const lastRevenue = input.projectedRevenues[input.projectedRevenues.length - 1] ?? 1;
+    const impliedMultiple = enterpriseValue / lastRevenue;
+    return {
+      presentValue: Math.round(presentValue),
+      terminalValue: Math.round(discountedTerminal),
+      enterpriseValue: Math.round(enterpriseValue),
+      freeCashFlows: fcfs.map((v) => Math.round(v)),
+      discountedCashFlows: discountedFcfs.map((v) => Math.round(v)),
+      impliedMultiple: Math.round(impliedMultiple * 10) / 10
+    };
+  }
+  /**
+   * Comparable Company Valuation
+   */
+  calculateComparable(input) {
+    const revMultiples = input.comparables.map((c) => c.evRevenue);
+    const ebitdaMultiples = input.comparables.map((c) => c.evEbitda);
+    const userValues = input.comparables.map((c) => c.evUser);
+    const medianRevMultiple = this.median(revMultiples);
+    const medianEbitdaMultiple = this.median(ebitdaMultiples);
+    const medianUserValue = this.median(userValues);
+    const revenueVal = input.revenue * medianRevMultiple;
+    const ebitdaVal = input.ebitda * medianEbitdaMultiple;
+    const userVal = input.users * medianUserValue;
+    const avgCompGrowth = input.comparables.reduce((s, c) => s + c.growthRate, 0) / input.comparables.length;
+    const growthPremium = input.growthRate / (avgCompGrowth || 0.1);
+    const growthAdjusted = revenueVal * Math.min(growthPremium, 3);
+    return {
+      revenueMultipleValuation: Math.round(revenueVal),
+      ebitdaMultipleValuation: Math.round(ebitdaVal),
+      perUserValuation: Math.round(userVal),
+      averageValuation: Math.round((revenueVal + ebitdaVal + userVal) / 3),
+      medianMultiple: medianRevMultiple,
+      growthAdjustedValuation: Math.round(growthAdjusted)
+    };
+  }
+  /**
+   * Network Effect Valuation (Metcalfe's Law)
+   */
+  calculateNetworkEffect(input) {
+    const currentValue = Math.pow(input.currentUsers, input.metcalfeExponent) * input.valuePerConnection * input.networkDensity;
+    const projectedValues = input.projectedUsers.map(
+      (users) => Math.pow(users, input.metcalfeExponent) * input.valuePerConnection * input.networkDensity
+    );
+    const metcalfeValue = Math.pow(input.currentUsers, 2) * input.valuePerConnection;
+    const adjustedValue = metcalfeValue * input.networkDensity;
+    return {
+      currentNetworkValue: Math.round(currentValue),
+      projectedValues: projectedValues.map((v) => Math.round(v)),
+      metcalfeValue: Math.round(metcalfeValue),
+      adjustedValue: Math.round(adjustedValue)
+    };
+  }
+  /**
+   * Sensitivity Analysis
+   */
+  runSensitivity(baseInput, variables) {
+    const baseResult = this.calculateDCF(baseInput);
+    const baseCase = baseResult.enterpriseValue;
+    const scenarios = [];
+    const tornado = [];
+    for (const v of variables) {
+      const lowInput = { ...baseInput, [v.field]: v.low };
+      const lowResult = this.calculateDCF(lowInput);
+      const highInput = { ...baseInput, [v.field]: v.high };
+      const highResult = this.calculateDCF(highInput);
+      scenarios.push({
+        name: `${v.name} Low`,
+        value: lowResult.enterpriseValue,
+        delta: (lowResult.enterpriseValue - baseCase) / baseCase * 100,
+        variables: { [v.name]: v.low }
+      });
+      scenarios.push({
+        name: `${v.name} High`,
+        value: highResult.enterpriseValue,
+        delta: (highResult.enterpriseValue - baseCase) / baseCase * 100,
+        variables: { [v.name]: v.high }
+      });
+      tornado.push({
+        variable: v.name,
+        lowValue: lowResult.enterpriseValue,
+        highValue: highResult.enterpriseValue,
+        range: Math.abs(highResult.enterpriseValue - lowResult.enterpriseValue)
+      });
+    }
+    tornado.sort((a, b) => b.range - a.range);
+    return { baseCase, scenarios, tornado };
+  }
+  // ─── Helpers ─────────────────────────────────────────────────────
+  median(values) {
+    if (values.length === 0) return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    return sorted.length % 2 !== 0 ? sorted[mid] : (sorted[mid - 1] + sorted[mid]) / 2;
+  }
+};
+
+// src/governanceEnhancer.ts
+var DEFAULT_GE_CONFIG = {
+  circuitBreakerThreshold: 5,
+  circuitBreakerTimeoutMs: 3e4,
+  halfOpenSuccessThreshold: 3,
+  degradationChain: [
+    {
+      id: "full",
+      name: "Full Capability",
+      order: 4,
+      capabilities: ["all"],
+      restrictions: []
+    },
+    {
+      id: "reduced",
+      name: "Reduced Capability",
+      order: 3,
+      capabilities: ["read", "compute", "cache"],
+      restrictions: ["write", "external_api"]
+    },
+    {
+      id: "minimal",
+      name: "Minimal Capability",
+      order: 2,
+      capabilities: ["read", "cache"],
+      restrictions: ["write", "compute", "external_api"]
+    },
+    {
+      id: "readonly",
+      name: "Read-Only Mode",
+      order: 1,
+      capabilities: ["read"],
+      restrictions: ["write", "compute", "external_api", "cache"]
+    }
+  ],
+  maxPolicyVersions: 10
+};
+function simpleHash2(input) {
+  let hash = 0;
+  for (let i = 0; i < input.length; i++) {
+    hash = (hash << 5) - hash + input.charCodeAt(i);
+    hash = hash & hash;
+  }
+  return Math.abs(hash).toString(16).padStart(8, "0");
+}
+var GovernanceEnhancer = class {
+  currentPolicy = null;
+  policyHistory = [];
+  circuitBreakers = /* @__PURE__ */ new Map();
+  currentDegradationLevel = "full";
+  config;
+  constructor(config) {
+    this.config = { ...DEFAULT_GE_CONFIG, ...config };
+  }
+  // ─── Policy Hot-Reload ───────────────────────────────────────────
+  /**
+   * Load a new policy version (hot-reload)
+   */
+  async loadPolicy(version, rules) {
+    const hash = simpleHash2(JSON.stringify(rules));
+    const oldVersion = this.currentPolicy?.version;
+    const newPolicy = {
+      version,
+      rules: rules.sort((a, b) => b.priority - a.priority),
+      activatedAt: Date.now(),
+      hash
+    };
+    if (this.currentPolicy) {
+      this.policyHistory.push(this.currentPolicy);
+      if (this.policyHistory.length > this.config.maxPolicyVersions) {
+        this.policyHistory = this.policyHistory.slice(-this.config.maxPolicyVersions);
+      }
+    }
+    this.currentPolicy = newPolicy;
+    if (this.config.onPolicyChange && oldVersion) {
+      try {
+        await this.config.onPolicyChange(oldVersion, version);
+      } catch {
+      }
+    }
+    if (this.config.onAudit) {
+      try {
+        await this.config.onAudit({
+          type: "policy_loaded",
+          data: { version, ruleCount: rules.length, hash, previousVersion: oldVersion }
+        });
+      } catch {
+      }
+    }
+    return { success: true, previousVersion: oldVersion, newVersion: version };
+  }
+  /**
+   * Rollback to a previous policy version
+   */
+  async rollbackPolicy(version) {
+    const target = this.policyHistory.find((p) => p.version === version);
+    if (!target) return false;
+    if (this.currentPolicy) {
+      this.policyHistory.push(this.currentPolicy);
+    }
+    this.currentPolicy = { ...target, activatedAt: Date.now() };
+    return true;
+  }
+  /**
+   * Evaluate a governance decision
+   */
+  async evaluate(context) {
+    if (!this.currentPolicy) {
+      return {
+        allowed: false,
+        action: "deny",
+        reason: "No policy loaded",
+        policyVersion: "none"
+      };
+    }
+    const cbState = this.getCircuitBreakerState(context.resource);
+    if (cbState === "OPEN") {
+      return {
+        allowed: false,
+        action: "deny",
+        circuitState: "OPEN",
+        reason: `Circuit breaker OPEN for ${context.resource}`,
+        policyVersion: this.currentPolicy.version
+      };
+    }
+    for (const rule of this.currentPolicy.rules) {
+      if (!rule.enabled) continue;
+      const matches = this.evaluateCondition(rule.condition, context);
+      if (!matches) continue;
+      const decision = {
+        allowed: rule.action === "allow",
+        action: rule.action,
+        ruleId: rule.id,
+        ruleName: rule.name,
+        circuitState: cbState,
+        policyVersion: this.currentPolicy.version,
+        reason: `Rule ${rule.name} matched: ${rule.action}`
+      };
+      if (rule.action === "degrade" && rule.degradeTo) {
+        decision.degradationLevel = rule.degradeTo;
+        decision.allowed = true;
+        this.currentDegradationLevel = rule.degradeTo;
+      }
+      if (this.config.onAudit) {
+        try {
+          await this.config.onAudit({
+            type: "governance_decision",
+            data: {
+              action: context.action,
+              resource: context.resource,
+              decision: rule.action,
+              ruleId: rule.id,
+              policyVersion: this.currentPolicy.version
+            }
+          });
+        } catch {
+        }
+      }
+      return decision;
+    }
+    return {
+      allowed: true,
+      action: "allow",
+      reason: "No matching rule, default allow",
+      policyVersion: this.currentPolicy.version,
+      circuitState: cbState
+    };
+  }
+  // ─── Circuit Breaker ─────────────────────────────────────────────
+  /**
+   * Record a success for circuit breaker
+   */
+  recordSuccess(resource) {
+    const cb = this.getOrCreateCircuitBreaker(resource);
+    cb.successCount++;
+    cb.lastSuccessAt = Date.now();
+    if (cb.state === "HALF_OPEN") {
+      if (cb.successCount >= this.config.halfOpenSuccessThreshold) {
+        cb.state = "CLOSED";
+        cb.failureCount = 0;
+        cb.halfOpenAttempts = 0;
+      }
+    }
+  }
+  /**
+   * Record a failure for circuit breaker
+   */
+  recordFailure(resource) {
+    const cb = this.getOrCreateCircuitBreaker(resource);
+    cb.failureCount++;
+    cb.lastFailureAt = Date.now();
+    if (cb.state === "CLOSED" && cb.failureCount >= this.config.circuitBreakerThreshold) {
+      cb.state = "OPEN";
+      cb.openedAt = Date.now();
+    } else if (cb.state === "HALF_OPEN") {
+      cb.state = "OPEN";
+      cb.openedAt = Date.now();
+      cb.halfOpenAttempts++;
+    }
+  }
+  /**
+   * Get circuit breaker state for a resource
+   */
+  getCircuitBreakerState(resource) {
+    const cb = this.circuitBreakers.get(resource);
+    if (!cb) return "CLOSED";
+    if (cb.state === "OPEN") {
+      const elapsed = Date.now() - cb.openedAt;
+      if (elapsed >= this.config.circuitBreakerTimeoutMs) {
+        cb.state = "HALF_OPEN";
+        cb.successCount = 0;
+      }
+    }
+    return cb.state;
+  }
+  // ─── Degradation Chain ───────────────────────────────────────────
+  /**
+   * Get current degradation level
+   */
+  getCurrentDegradationLevel() {
+    return this.config.degradationChain.find((d) => d.id === this.currentDegradationLevel);
+  }
+  /**
+   * Degrade to next level
+   */
+  degradeOneLevel() {
+    const current = this.config.degradationChain.find((d) => d.id === this.currentDegradationLevel);
+    if (!current) return null;
+    const nextLevel = this.config.degradationChain.filter((d) => d.order < current.order).sort((a, b) => b.order - a.order)[0];
+    if (nextLevel) {
+      this.currentDegradationLevel = nextLevel.id;
+      return nextLevel;
+    }
+    return null;
+  }
+  /**
+   * Restore to full capability
+   */
+  restoreFullCapability() {
+    this.currentDegradationLevel = "full";
+  }
+  /**
+   * Check if a capability is available at current degradation level
+   */
+  isCapabilityAvailable(capability) {
+    const level = this.getCurrentDegradationLevel();
+    if (!level) return false;
+    return level.capabilities.includes("all") || level.capabilities.includes(capability);
+  }
+  // ─── Status ──────────────────────────────────────────────────────
+  /**
+   * Get full governance status
+   */
+  getStatus() {
+    return {
+      policyVersion: this.currentPolicy?.version ?? null,
+      ruleCount: this.currentPolicy?.rules.length ?? 0,
+      degradationLevel: this.currentDegradationLevel,
+      circuitBreakers: Array.from(this.circuitBreakers.values()),
+      policyHistoryCount: this.policyHistory.length
+    };
+  }
+  // ─── Internal ────────────────────────────────────────────────────
+  evaluateCondition(condition, context) {
+    if (condition === "*") return true;
+    if (condition.startsWith("action:")) {
+      return context.action === condition.substring(7);
+    }
+    if (condition.startsWith("resource:")) {
+      return context.resource.includes(condition.substring(9));
+    }
+    if (condition.startsWith("agent:")) {
+      return context.agentId === condition.substring(6);
+    }
+    return false;
+  }
+  getOrCreateCircuitBreaker(resource) {
+    let cb = this.circuitBreakers.get(resource);
+    if (!cb) {
+      cb = {
+        name: resource,
+        state: "CLOSED",
+        failureCount: 0,
+        successCount: 0,
+        lastFailureAt: 0,
+        lastSuccessAt: 0,
+        openedAt: 0,
+        halfOpenAttempts: 0
+      };
+      this.circuitBreakers.set(resource, cb);
+    }
+    return cb;
+  }
+};
+
+// src/contextAccelerator.ts
+var DEFAULT_CA_CONFIG = {
+  maxCacheEntries: 500,
+  defaultTtlMs: 3e5,
+  // 5 minutes
+  tokenBudget: 8e3,
+  compressionTarget: 0.5,
+  priorityWeights: {
+    critical: 100,
+    high: 75,
+    medium: 50,
+    low: 25
+  }
+};
+function estimateTokens(text) {
+  return Math.ceil(text.length / 3.5);
+}
+function defaultCompressor(content, targetTokens) {
+  const currentTokens = estimateTokens(content);
+  if (currentTokens <= targetTokens) return content;
+  const ratio = targetTokens / currentTokens;
+  const targetLength = Math.floor(content.length * ratio);
+  if (targetLength < 50) return content.substring(0, 50) + "...";
+  return content.substring(0, targetLength) + "...[compressed]";
+}
+var ContextAccelerator = class {
+  cache = /* @__PURE__ */ new Map();
+  prefetchRules = /* @__PURE__ */ new Map();
+  config;
+  stats = {
+    totalHits: 0,
+    totalMisses: 0,
+    totalEvictions: 0,
+    totalCompressions: 0,
+    totalAssemblies: 0
+  };
+  constructor(config) {
+    this.config = { ...DEFAULT_CA_CONFIG, ...config };
+  }
+  /**
+   * Put a fragment into cache
+   */
+  put(fragment) {
+    this.evictExpired();
+    if (this.cache.size >= this.config.maxCacheEntries) {
+      this.evictLRU();
+    }
+    this.cache.set(fragment.id, {
+      fragment,
+      accessCount: 0,
+      lastAccessedAt: Date.now(),
+      createdAt: Date.now(),
+      expiresAt: Date.now() + (fragment.ttlMs || this.config.defaultTtlMs)
+    });
+  }
+  /**
+   * Get a fragment from cache
+   */
+  get(id) {
+    const entry = this.cache.get(id);
+    if (!entry) {
+      this.stats.totalMisses++;
+      return null;
+    }
+    if (Date.now() > entry.expiresAt) {
+      this.cache.delete(id);
+      this.stats.totalMisses++;
+      return null;
+    }
+    entry.accessCount++;
+    entry.lastAccessedAt = Date.now();
+    this.stats.totalHits++;
+    return entry.fragment;
+  }
+  /**
+   * Assemble context from fragments within token budget
+   */
+  async assemble(fragmentIds, additionalFragments, budgetOverride) {
+    const startTime = Date.now();
+    const budget = budgetOverride ?? this.config.tokenBudget;
+    let cacheHits = 0;
+    let cacheMisses = 0;
+    const allFragments = [];
+    for (const id of fragmentIds) {
+      const fragment = this.get(id);
+      if (fragment) {
+        allFragments.push(fragment);
+        cacheHits++;
+      } else {
+        cacheMisses++;
+      }
+    }
+    if (additionalFragments) {
+      allFragments.push(...additionalFragments);
+    }
+    const weights = this.config.priorityWeights;
+    allFragments.sort((a, b) => {
+      const wDiff = (weights[b.priority] ?? 0) - (weights[a.priority] ?? 0);
+      if (wDiff !== 0) return wDiff;
+      return b.timestamp - a.timestamp;
+    });
+    const selected = [];
+    let totalTokens = 0;
+    let droppedCount = 0;
+    let compressedCount = 0;
+    for (const fragment of allFragments) {
+      if (totalTokens >= budget) {
+        droppedCount++;
+        continue;
+      }
+      const remaining = budget - totalTokens;
+      if (fragment.tokenCount <= remaining) {
+        selected.push(fragment);
+        totalTokens += fragment.tokenCount;
+      } else if (fragment.priority === "critical" || fragment.priority === "high") {
+        const compressor = this.config.compressor ?? defaultCompressor;
+        const compressed = compressor(fragment.content, remaining);
+        const compressedTokens = estimateTokens(compressed);
+        selected.push({
+          ...fragment,
+          content: compressed,
+          tokenCount: compressedTokens,
+          compressed: true
+        });
+        totalTokens += compressedTokens;
+        compressedCount++;
+        this.stats.totalCompressions++;
+      } else {
+        droppedCount++;
+      }
+    }
+    this.stats.totalAssemblies++;
+    const result = {
+      fragments: selected,
+      totalTokens,
+      budgetUsed: budget > 0 ? totalTokens / budget : 0,
+      droppedCount,
+      compressedCount,
+      cacheHits,
+      cacheMisses,
+      assemblyTimeMs: Date.now() - startTime
+    };
+    if (this.config.onAudit) {
+      try {
+        await this.config.onAudit({
+          type: "context_assembled",
+          data: {
+            totalTokens,
+            budgetUsed: result.budgetUsed,
+            fragmentCount: selected.length,
+            droppedCount,
+            compressedCount,
+            cacheHits,
+            cacheMisses,
+            assemblyTimeMs: result.assemblyTimeMs
+          }
+        });
+      } catch {
+      }
+    }
+    return result;
+  }
+  /**
+   * Register a prefetch rule
+   */
+  addPrefetchRule(rule) {
+    this.prefetchRules.set(rule.id, rule);
+  }
+  /**
+   * Execute prefetch based on task type
+   */
+  async prefetch(taskType, fragmentLoader) {
+    const matchingRules = Array.from(this.prefetchRules.values()).filter(
+      (r) => r.enabled && taskType.includes(r.trigger)
+    );
+    if (matchingRules.length === 0) return 0;
+    const idsToFetch = /* @__PURE__ */ new Set();
+    for (const rule of matchingRules) {
+      for (const id of rule.fragmentIds) {
+        if (!this.cache.has(id)) {
+          idsToFetch.add(id);
+        }
+      }
+    }
+    if (idsToFetch.size === 0) return 0;
+    const fragments = await fragmentLoader(Array.from(idsToFetch));
+    for (const f of fragments) {
+      this.put(f);
+    }
+    return fragments.length;
+  }
+  /**
+   * Invalidate cache entries
+   */
+  invalidate(ids) {
+    let count = 0;
+    for (const id of ids) {
+      if (this.cache.delete(id)) count++;
+    }
+    return count;
+  }
+  /**
+   * Get cache stats
+   */
+  getStats() {
+    const total = this.stats.totalHits + this.stats.totalMisses;
+    return {
+      cacheSize: this.cache.size,
+      maxSize: this.config.maxCacheEntries,
+      hitRate: total > 0 ? this.stats.totalHits / total : 0,
+      ...this.stats,
+      prefetchRuleCount: this.prefetchRules.size
+    };
+  }
+  /**
+   * Clear all cache
+   */
+  clear() {
+    this.cache.clear();
+  }
+  // ─── Internal ────────────────────────────────────────────────────
+  evictExpired() {
+    const now = Date.now();
+    for (const [id, entry] of this.cache) {
+      if (now > entry.expiresAt) {
+        this.cache.delete(id);
+        this.stats.totalEvictions++;
+      }
+    }
+  }
+  evictLRU() {
+    let oldestId = null;
+    let oldestAccess = Infinity;
+    for (const [id, entry] of this.cache) {
+      if (entry.lastAccessedAt < oldestAccess) {
+        oldestAccess = entry.lastAccessedAt;
+        oldestId = id;
+      }
+    }
+    if (oldestId) {
+      this.cache.delete(oldestId);
+      this.stats.totalEvictions++;
+    }
+  }
+};
+
 // src/index.ts
 var DEFAULT_RULES = [
   // --- HTTP Proxy: Dangerous outbound calls ---
@@ -919,7 +3498,7 @@ var RISK_SCORES = {
   high: 70,
   critical: 95
 };
-var ENGINE_VERSION = "3.3.0";
+var ENGINE_VERSION = "3.4.0";
 var ENGINE_VERSION_CHECK_URL = "https://api.sovr.inc/api/sovr/v1/version/check";
 var ENGINE_TIER_LIMITS = {
   free: { evaluationsPerMonth: 50, irreversibleAllowsPerMonth: 0 },
@@ -1175,13 +3754,42 @@ var index_default = PolicyEngine;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AdaptiveThresholdManager,
+  AutoHardenEngine,
+  ContextAccelerator,
+  CostGateEnhancedEngine,
+  DEFAULT_CA_CONFIG,
+  DEFAULT_GE_CONFIG,
+  DEFAULT_HARD_RULES,
   DEFAULT_RULES,
+  DEFAULT_SCORING_WEIGHTS,
+  DEFAULT_TSA_CONFIG,
+  EvolutionChannelEngine,
   FeatureSwitchesManager,
+  GovernanceEnhancer,
+  MultiLevelBudgetEngine,
   PolicyEngine,
   PricingRulesEngine,
+  RecalculationEngine,
   SOVR_FEATURE_SWITCHES,
+  SemanticDriftDetectorEngine,
+  TimeSeriesAggregator,
+  TwoPhaseRouter,
+  ValuationModel,
   compileFromJSON,
   compileRuleSet,
+  createAutoHardenEngine,
+  createCostGateEnhanced,
+  createEvolutionChannel,
+  createMultiLevelBudget,
+  createRecalculationEngine,
+  createSemanticDriftDetector,
+  estimateCost,
   evaluateRules,
-  registerFunction
+  getAccuracyStats,
+  getModelPricingTable,
+  getToolPricingTable,
+  recordActualCost,
+  registerFunction,
+  updateModelPricing,
+  updateToolPricing
 });