@sovr/engine 3.5.0 → 3.7.0

package/dist/index.d.ts

@@ -845,14 +845,14 @@ interface CostRecord {
     tokenCount?: number;
     modelName?: string;
     timestamp: number;
-    category: CostCategory;
+    category: CostCategory$1;
     metadata?: Record<string, unknown>;
 }
-type CostCategory = 'llm_inference' | 'tool_call' | 'human_review' | 'storage' | 'network' | 'compute' | 'other';
+type CostCategory$1 = 'llm_inference' | 'tool_call' | 'human_review' | 'storage' | 'network' | 'compute' | 'other';
 interface CostSummary {
     period: '1h' | '24h' | '7d' | '30d';
     totalCostUsd: number;
-    byCategory: Record<CostCategory, number>;
+    byCategory: Record<CostCategory$1, number>;
     byAgent: Record<string, number>;
     byTool: Record<string, number>;
     recordCount: number;
@@ -864,7 +864,7 @@ interface CostSummary {
 interface DailyCostStats {
     date: string;
     totalCostUsd: number;
-    byCategory: Record<CostCategory, number>;
+    byCategory: Record<CostCategory$1, number>;
     actionCount: number;
     uniqueAgents: number;
     budgetUtilization: number;
@@ -1870,6 +1870,751 @@ declare class ContextAccelerator {
     private evictLRU;
 }
 
+/**
+ * trendAlertEngine.ts — 趋势触发告警与 Kill-Switch 对接引擎
+ *
+ * 覆盖 PDF5: 人工智能痛点执行方案(1) — 趋势触发告警与 Kill-Switch 对接
+ *
+ * 核心能力:
+ * - Block Rate 突增检测: 拦截率相对基线大幅上升
+ * - Override Rate 突增检测: 人工强制通过率飙升
+ * - 未知原因码检测: 出现未定义的 reason_code
+ * - 人工审批队列积压检测: 审核队列任务大量堆积
+ * - 自动降级 (Degrade): 进入降级模式
+ * - 自动提高门槛: 提升安全阈值
+ * - 触发 Kill-Switch: 全局紧急停止
+ * - 告警事件持久化: 写入 sovr_system_events
+ * - DegradeEvaluator Cron: 定时评估趋势
+ */
+type AlertSeverity$1 = 'INFO' | 'WARN' | 'CRITICAL' | 'EMERGENCY';
+type AlertType = 'BLOCK_RATE_SURGE' | 'OVERRIDE_RATE_SURGE' | 'UNKNOWN_REASON_CODE' | 'APPROVAL_QUEUE_BACKLOG' | 'CONFIDENCE_DROP' | 'LATENCY_SPIKE' | 'ERROR_RATE_SURGE';
+type ProtectiveAction = 'DEGRADE' | 'TIGHTEN_THRESHOLD' | 'KILL_SWITCH' | 'NOTIFY_ONLY' | 'FORCE_HUMAN_GATE';
+interface AlertThreshold {
+    alert_type: AlertType;
+    metric_name: string;
+    baseline_window_hours: number;
+    surge_multiplier: number;
+    absolute_threshold: number;
+    severity: AlertSeverity$1;
+    protective_actions: ProtectiveAction[];
+    cooldown_seconds: number;
+    enabled: boolean;
+}
+interface TrendMetric {
+    metric_name: string;
+    current_value: number;
+    baseline_value: number;
+    window_start: number;
+    window_end: number;
+    sample_count: number;
+}
+interface AlertEvent {
+    alert_id: string;
+    alert_type: AlertType;
+    severity: AlertSeverity$1;
+    metric_name: string;
+    current_value: number;
+    baseline_value: number;
+    threshold_value: number;
+    surge_ratio: number;
+    protective_actions_taken: ProtectiveAction[];
+    message: string;
+    tenant_id: string;
+    created_at: number;
+    acknowledged: boolean;
+    acknowledged_by: string | null;
+    acknowledged_at: number | null;
+}
+interface KillSwitchState {
+    enabled: boolean;
+    reason: string | null;
+    enabled_at: number | null;
+    enabled_by: string;
+    auto_triggered: boolean;
+}
+interface DegradeState {
+    active: boolean;
+    level: 'LIGHT' | 'MODERATE' | 'SEVERE';
+    reason: string;
+    activated_at: number | null;
+    auto_recover_at: number | null;
+}
+interface SystemState {
+    kill_switch: KillSwitchState;
+    degrade: DegradeState;
+    tightened_threshold_multiplier: number;
+    force_human_gate: boolean;
+}
+declare class TrendAlertEngine {
+    private thresholds;
+    private alertHistory;
+    private lastAlertTime;
+    private systemState;
+    private metricsBuffer;
+    constructor(customThresholds?: AlertThreshold[]);
+    evaluate(metrics: TrendMetric[], tenantId?: string): AlertEvent[];
+    cronEvaluate(getMetrics: () => TrendMetric[], tenantId?: string): {
+        alerts: AlertEvent[];
+        state: SystemState;
+    };
+    private executeProtectiveAction;
+    private activateDegrade;
+    private tightenThreshold;
+    private activateKillSwitch;
+    private checkThreshold;
+    private checkAutoRecover;
+    acknowledgeAlert(alertId: string, acknowledgedBy: string): boolean;
+    disableKillSwitch(reason: string, actor: string): boolean;
+    resetDegrade(): void;
+    getSystemState(): SystemState;
+    getAlertHistory(limit?: number): AlertEvent[];
+    getActiveAlerts(): AlertEvent[];
+    getMetricsBuffer(): TrendMetric[];
+    private formatAlertMessage;
+}
+
+/**
+ * selfConstraintEngine.ts — 自我约束机制引擎
+ *
+ * 覆盖 PDF10: 人工智能痛点自我约束机制实施计划
+ *
+ * 核心能力:
+ * - 风险密度监测: 持续跟踪风险密度指标
+ * - 规则冲突率监测: 检测规则之间的冲突
+ * - 决策置信度监测: 跟踪决策置信度下降趋势
+ * - Auto Tightening Thresholds: 自动收紧阈值
+ * - Capability Downgrade Flags: 功能降级标志
+ * - Forced Human Gate: 强制人工门禁
+ * - tightening_thresholds 配置: 可配置化阈值策略
+ * - capability_flags 配置: 功能开关控制
+ *
+ * 三种退让模式:
+ * 1. 降低能力 — 自动缩小可执行操作范围
+ * 2. 降低速度 — 延后决策等待更多证据
+ * 3. 降低权限 — 交由人工介入
+ */
+type ConstraintMode = 'CAPABILITY_DOWN' | 'SPEED_DOWN' | 'PERMISSION_DOWN';
+type ConstraintLevel = 'NORMAL' | 'CAUTIOUS' | 'RESTRICTED' | 'LOCKDOWN';
+interface TighteningThresholds {
+    risk_density: number;
+    conflict_rate: number;
+    confidence_drop: number;
+    error_rate: number;
+    latency_p99_ms: number;
+    consecutive_failures: number;
+}
+interface CapabilityFlags {
+    enable_advanced_features: boolean;
+    enable_auto_approve: boolean;
+    enable_batch_operations: boolean;
+    enable_external_api_calls: boolean;
+    enable_write_operations: boolean;
+    require_human_gate: boolean;
+    require_dual_review: boolean;
+    max_concurrent_decisions: number;
+    decision_delay_ms: number;
+}
+interface ConstraintConfig {
+    thresholds: TighteningThresholds;
+    flags: CapabilityFlags;
+    auto_recover_after_minutes: number;
+    evaluation_interval_seconds: number;
+}
+interface MonitoringMetrics {
+    risk_density: number;
+    conflict_rate: number;
+    avg_confidence: number;
+    prev_avg_confidence: number;
+    error_rate: number;
+    latency_p99_ms: number;
+    consecutive_failures: number;
+    pending_approval_count: number;
+    system_pressure: number;
+}
+interface ConstraintDecision {
+    decision_id: string;
+    timestamp: number;
+    level: ConstraintLevel;
+    modes_activated: ConstraintMode[];
+    triggers: ConstraintTrigger[];
+    flags_applied: Partial<CapabilityFlags>;
+    reason_code: string;
+    auto_recover_at: number | null;
+}
+interface ConstraintTrigger {
+    metric_name: string;
+    current_value: number;
+    threshold_value: number;
+    exceeded: boolean;
+}
+interface ConstraintState {
+    current_level: ConstraintLevel;
+    active_modes: ConstraintMode[];
+    flags: CapabilityFlags;
+    activated_at: number | null;
+    auto_recover_at: number | null;
+    last_evaluation_at: number;
+    evaluation_count: number;
+    constraint_history: ConstraintDecision[];
+}
+declare class SelfConstraintEngine {
+    private config;
+    private state;
+    constructor(config?: Partial<ConstraintConfig>);
+    evaluate(metrics: MonitoringMetrics): ConstraintDecision;
+    private calculateLevel;
+    private applyConstraint;
+    checkAutoRecover(): boolean;
+    reset(): void;
+    forceLevel(level: ConstraintLevel): void;
+    preDecisionCheck(action: string, resource: string): {
+        allowed: boolean;
+        delay_ms: number;
+        requires_human: boolean;
+        requires_dual_review: boolean;
+        reason: string;
+    };
+    getState(): ConstraintState;
+    getCurrentLevel(): ConstraintLevel;
+    getFlags(): CapabilityFlags;
+    isConstrained(): boolean;
+    private isWriteAction;
+    private isExternalAction;
+    private isBatchAction;
+}
+
+/**
+ * contributionSettlement.ts — 贡献结算引擎
+ *
+ * 覆盖 PDF3: 人工智能痛点上下文总结(3) — 激励对齐方案
+ *
+ * 核心能力:
+ * - 四维贡献打分: Risk / Cost / Human / Stability
+ * - 归因引擎: 对 rule/model/tool/agent/human/system 各参与者计分
+ * - 窗口聚合: 按时间窗口聚合贡献事件为分数
+ * - 反作弊机制: 硬性门槛 + 惩罚机制 + 审计抽查
+ * - 评分公式: Score_total = w_R*Score_risk + w_C*Score_cost + w_H*Score_human + w_S*Score_stability - Penalties
+ * - 与控制面联动: 贡献分数→权限/资源分配
+ */
+type ContributionDimension = 'RISK' | 'COST' | 'HUMAN' | 'STABILITY';
+type EntityType = 'rule' | 'model' | 'tool' | 'agent' | 'human' | 'system';
+interface ContributionEvent {
+    event_id: string;
+    trace_id: string;
+    decision_id: string;
+    tenant_id: string;
+    entity_type: EntityType;
+    entity_id: string;
+    dimension: ContributionDimension;
+    delta_value: number;
+    delta_confidence: number;
+    baseline_ref: string;
+    evidence_bundle_hash: string;
+    created_at: number;
+}
+interface ContributionScore {
+    score_id: string;
+    window_start: number;
+    window_end: number;
+    tenant_id: string;
+    entity_type: EntityType;
+    entity_id: string;
+    score_risk: number;
+    score_cost: number;
+    score_human: number;
+    score_stability: number;
+    score_total: number;
+    penalty_total: number;
+    confidence: number;
+    score_config_version: string;
+    created_at: number;
+}
+interface ScoreConfigVersion {
+    version: string;
+    weight_risk: number;
+    weight_cost: number;
+    weight_human: number;
+    weight_stability: number;
+    weight_penalty: number;
+    caps: {
+        max_single_event: number;
+        max_risk_positive_when_risk_up: boolean;
+    };
+    guardrails: string[];
+    approved_by: string;
+    approved_at: number;
+}
+interface AttributionRule {
+    condition: string;
+    target_entity_type: EntityType;
+    target_entity_field: string;
+    weight: number;
+}
+interface PenaltyCheck {
+    name: string;
+    detect: (events: ContributionEvent[], context: SettlementContext) => number;
+}
+interface SettlementContext {
+    tenant_id: string;
+    window_start: number;
+    window_end: number;
+    override_count_delta: number;
+    replay_fail_delta: number;
+    risk_regression: boolean;
+    evidence_downgrade: boolean;
+}
+declare class ContributionSettlementEngine {
+    private config;
+    private attributionRules;
+    private penaltyChecks;
+    private eventStore;
+    private scoreStore;
+    constructor(config?: Partial<ScoreConfigVersion>, customRules?: AttributionRule[], customPenalties?: PenaltyCheck[]);
+    recordEvent(event: ContributionEvent): ContributionEvent;
+    attribute(traceId: string, condition: string, entityType: EntityType, entityId: string): ContributionEvent | null;
+    settle(context: SettlementContext): ContributionScore[];
+    getResourceAllocation(entityType: EntityType, entityId: string): {
+        token_budget_multiplier: number;
+        concurrency_quota_multiplier: number;
+        auto_approve_eligible: boolean;
+        requires_dual_review: boolean;
+    };
+    auditSample(entityType: EntityType, entityId: string, sampleSize?: number): ContributionEvent[];
+    private inferDimension;
+    getConfig(): ScoreConfigVersion;
+    getEventCount(): number;
+    getScoreCount(): number;
+}
+
+/**
+ * overrideDriftAnalyzer.ts — Override 漂移分析器
+ *
+ * 覆盖 PDF1/2: 对抗防护闭环 — Override Drift 检测
+ *
+ * 核心能力:
+ * - 周期统计: 按时间窗口统计 override 频率/分布
+ * - drift_index 计算: 量化 override 偏离基线的程度
+ * - 告警生成: 当 drift_index 超过阈值时触发告警
+ * - 模式识别: 识别 override 的时间/用户/规则模式
+ * - 与 trendAlertEngine / selfConstraintEngine 联动
+ */
+interface OverrideEvent {
+    event_id: string;
+    decision_id: string;
+    trace_id: string;
+    tenant_id: string;
+    actor_id: string;
+    actor_type: 'human' | 'agent' | 'system';
+    rule_id: string;
+    original_outcome: 'BLOCK' | 'WARN';
+    override_outcome: 'ALLOW';
+    override_reason: string;
+    risk_level: 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
+    created_at: number;
+}
+interface DriftWindow {
+    window_start: number;
+    window_end: number;
+    total_decisions: number;
+    total_overrides: number;
+    override_rate: number;
+    by_actor: Map<string, number>;
+    by_rule: Map<string, number>;
+    by_risk_level: Record<string, number>;
+    by_hour: number[];
+}
+interface DriftIndex {
+    value: number;
+    rate_drift: number;
+    concentration_drift: number;
+    risk_drift: number;
+    temporal_drift: number;
+    trend: 'STABLE' | 'RISING' | 'FALLING' | 'VOLATILE';
+}
+interface DriftAlert {
+    alert_id: string;
+    drift_index: DriftIndex;
+    severity: 'INFO' | 'WARN' | 'CRITICAL';
+    message: string;
+    patterns_detected: DriftPattern[];
+    recommendations: string[];
+    created_at: number;
+}
+interface DriftPattern {
+    pattern_type: 'ACTOR_CONCENTRATION' | 'RULE_BYPASS' | 'TIME_ANOMALY' | 'RISK_ESCALATION' | 'RATE_SPIKE';
+    description: string;
+    evidence: Record<string, unknown>;
+    confidence: number;
+}
+interface DriftAnalyzerConfig {
+    baseline_window_hours: number;
+    analysis_window_hours: number;
+    rate_drift_threshold: number;
+    concentration_threshold: number;
+    risk_drift_threshold: number;
+    temporal_drift_threshold: number;
+    composite_alert_threshold: number;
+    min_sample_size: number;
+}
+declare class OverrideDriftAnalyzer {
+    private config;
+    private events;
+    private baselineWindow;
+    private alerts;
+    constructor(config?: Partial<DriftAnalyzerConfig>);
+    recordOverride(event: OverrideEvent): void;
+    computeWindow(start: number, end: number, totalDecisions?: number): DriftWindow;
+    updateBaseline(totalDecisions?: number): DriftWindow;
+    calculateDriftIndex(currentWindow?: DriftWindow, totalDecisions?: number): DriftIndex;
+    analyze(totalDecisions?: number): DriftAlert | null;
+    private detectPatterns;
+    private generateRecommendations;
+    private calculateConcentration;
+    private calculateTemporalDrift;
+    private determineTrend;
+    getAlerts(limit?: number): DriftAlert[];
+    getEventCount(): number;
+    getLatestDriftIndex(totalDecisions?: number): DriftIndex;
+    getStats(): {
+        total_events: number;
+        total_alerts: number;
+        baseline_override_rate: number;
+        current_override_rate: number;
+    };
+}
+
+/**
+ * cockpitDataService.ts — SOVR Cockpit 控制面板数据服务层
+ *
+ * 来源文档: SOVR系统Cockpit趋势面板执行方案.pdf 等 85 份文档
+ * 优先级: P0
+ *
+ * 职责:
+ *   1. 聚合多维度运行指标 (gate/audit/trust/budget)
+ *   2. 提供 Cockpit 面板所需的实时数据 API
+ *   3. 趋势计算 + 健康评分 + 异常标记
+ *   4. 支持时间窗口查询 (1h/6h/24h/7d/30d)
+ */
+interface CockpitTimeWindow {
+    label: string;
+    seconds: number;
+}
+declare const TIME_WINDOWS: Record<string, CockpitTimeWindow>;
+interface MetricPoint {
+    timestamp: number;
+    value: number;
+    label?: string;
+}
+interface CockpitMetric {
+    id: string;
+    name: string;
+    category: 'gate' | 'audit' | 'trust' | 'budget' | 'performance' | 'security';
+    current: number;
+    previous: number;
+    trend: 'up' | 'down' | 'stable';
+    changePercent: number;
+    unit: string;
+    isAnomaly: boolean;
+    history: MetricPoint[];
+}
+interface HealthScore {
+    overall: number;
+    gate: number;
+    audit: number;
+    trust: number;
+    budget: number;
+    security: number;
+    lastUpdated: number;
+}
+
+/**
+ * timeConsistencyService.ts — SOVR 时间一致性服务
+ *
+ * 来源文档: 时间一致性实施方案.pdf 等 62 份文档
+ * 优先级: P0
+ *
+ * 职责:
+ *   1. 统一时间戳格式 (UTC Unix ms)
+ *   2. 时钟偏移检测 + 校正
+ *   3. 事件排序一致性保证
+ *   4. 跨服务时间同步验证
+ */
+interface TimestampRecord {
+    utcMs: number;
+    iso8601: string;
+    source: string;
+    clockDriftMs: number;
+    isReliable: boolean;
+}
+interface ClockDriftReport {
+    sourceA: string;
+    sourceB: string;
+    driftMs: number;
+    measuredAt: number;
+    withinTolerance: boolean;
+}
+interface EventOrderValidation {
+    events: Array<{
+        id: string;
+        timestamp: number;
+    }>;
+    isMonotonic: boolean;
+    violations: Array<{
+        before: string;
+        after: string;
+        gapMs: number;
+    }>;
+}
+interface TimeConsistencyConfig {
+    maxClockDriftMs: number;
+    ntpCheckIntervalMs: number;
+    enableDriftCorrection: boolean;
+    referenceSource: string;
+}
+
+/**
+ * failureAbsorber.ts — SOVR 失败吸收机制
+ *
+ * 来源文档: 失败吸收机制执行计划.pdf + 失败资本化自动回灌方案.pdf (20 份文档)
+ * 优先级: P0
+ *
+ * 职责:
+ *   1. 失败分类 (transient/permanent/degraded)
+ *   2. 失败资本化 — 将失败转化为知识资产
+ *   3. 自动回灌 — 失败经验注入策略引擎
+ *   4. 失败预算 — 控制可接受失败率
+ */
+type FailureCategory = 'transient' | 'permanent' | 'degraded' | 'unknown';
+type FailureSeverity = 'low' | 'medium' | 'high' | 'critical';
+interface FailureRecord {
+    id: string;
+    timestamp: number;
+    category: FailureCategory;
+    severity: FailureSeverity;
+    source: string;
+    action: string;
+    error: string;
+    context: Record<string, unknown>;
+    retryCount: number;
+    maxRetries: number;
+    resolved: boolean;
+    capitalizedAs?: string;
+    injectedToPolicy: boolean;
+}
+interface FailureBudget {
+    windowMs: number;
+    maxFailures: number;
+    currentFailures: number;
+    exhausted: boolean;
+    resetAt: number;
+}
+interface CapitalizationResult {
+    failureId: string;
+    knowledgeType: 'pattern' | 'rule' | 'threshold' | 'blocklist';
+    description: string;
+    injectedAt: number;
+    policyRef?: string;
+}
+
+/**
+ * realityAnchor.ts — SOVR 现实约束锚定系统
+ *
+ * 来源文档: 现实约束锚定系统执行计划.pdf (19 份文档)
+ * 优先级: P0
+ *
+ * 职责:
+ *   1. 物理世界约束注入 (时间/预算/法规/物理限制)
+ *   2. AI 输出的现实可行性验证
+ *   3. 约束冲突检测 + 解决建议
+ *   4. 约束松弛度评估
+ */
+type ConstraintType = 'temporal' | 'financial' | 'legal' | 'physical' | 'capacity' | 'dependency';
+type ConstraintStatus = 'active' | 'violated' | 'relaxed' | 'expired';
+interface RealityConstraint {
+    id: string;
+    type: ConstraintType;
+    name: string;
+    description: string;
+    condition: string;
+    threshold: number | string;
+    currentValue?: number | string;
+    status: ConstraintStatus;
+    severity: 'hard' | 'soft';
+    createdAt: number;
+    expiresAt?: number;
+    metadata: Record<string, unknown>;
+}
+interface FeasibilityCheck {
+    actionId: string;
+    action: string;
+    constraints: ConstraintCheckResult[];
+    overallFeasible: boolean;
+    feasibilityScore: number;
+    suggestions: string[];
+}
+interface ConstraintCheckResult {
+    constraintId: string;
+    constraintName: string;
+    type: ConstraintType;
+    passed: boolean;
+    reason: string;
+    relaxable: boolean;
+    relaxationCost?: string;
+}
+
+/**
+ * topNRanker.ts — SOVR Top-N 排名引擎
+ *
+ * 来源文档: 人工智能痛点Top-N实现方案.pdf (14 份文档)
+ * 优先级: P0
+ *
+ * 职责:
+ *   1. 多维度评分排名 (风险/频率/影响/成本)
+ *   2. 动态 Top-N 列表维护
+ *   3. 排名变化追踪 + 趋势告警
+ *   4. 可配置权重 + 自定义评分函数
+ */
+interface RankableItem {
+    id: string;
+    name: string;
+    category: string;
+    dimensions: Record<string, number>;
+    metadata?: Record<string, unknown>;
+}
+interface RankResult {
+    rank: number;
+    item: RankableItem;
+    compositeScore: number;
+    dimensionScores: Record<string, number>;
+    previousRank?: number;
+    rankChange: number;
+}
+interface RankingConfig {
+    n: number;
+    weights: Record<string, number>;
+    sortOrder: 'desc' | 'asc';
+    minScoreThreshold: number;
+    trackHistory: boolean;
+}
+interface RankingSnapshot {
+    timestamp: number;
+    configHash: string;
+    rankings: RankResult[];
+    totalItems: number;
+}
+
+/**
+ * finOpsRiskEngine.ts — SOVR FinOps 风险引擎
+ *
+ * 来源文档: FinOps风险执行方案.pdf (3 份文档)
+ * 优先级: P1
+ *
+ * 职责:
+ *   1. AI 运营成本追踪 (LLM tokens, API 调用, 存储)
+ *   2. 预算阈值告警
+ *   3. 成本异常检测
+ *   4. 成本优化建议
+ *   5. FinOps 报告生成
+ */
+type CostCategory = 'llm_tokens' | 'api_calls' | 'storage' | 'compute' | 'bandwidth' | 'third_party' | 'other';
+type AlertSeverity = 'info' | 'warning' | 'critical';
+interface CostEntry {
+    id: string;
+    category: CostCategory;
+    service: string;
+    amount: number;
+    quantity: number;
+    unitPrice: number;
+    timestamp: number;
+    metadata: Record<string, unknown>;
+}
+interface BudgetConfig {
+    category: CostCategory;
+    dailyLimit: number;
+    monthlyLimit: number;
+    alertThresholds: number[];
+}
+interface CostAlert {
+    id: string;
+    category: CostCategory;
+    severity: AlertSeverity;
+    message: string;
+    currentSpend: number;
+    budgetLimit: number;
+    percentage: number;
+    timestamp: number;
+}
+
+/**
+ * apiCacheOptimizer.ts — SOVR API 缓存优化策略引擎
+ *
+ * 来源文档: SOVRAPI缓存优化策略.pdf (2 份文档)
+ * 优先级: P1
+ *
+ * 职责:
+ *   1. 多层缓存管理 (L1 内存 / L2 Redis / L3 CDN)
+ *   2. 缓存策略自动选择 (TTL / LRU / LFU / Write-Through)
+ *   3. 缓存命中率监控与优化
+ *   4. 缓存预热与失效管理
+ *   5. 热点检测与自动扩容
+ */
+type CacheLayer = 'L1_memory' | 'L2_redis' | 'L3_cdn';
+type CacheStrategy = 'ttl' | 'lru' | 'lfu' | 'write_through' | 'write_behind' | 'read_through';
+type EvictionPolicy = 'lru' | 'lfu' | 'fifo' | 'random' | 'ttl';
+interface CacheConfig {
+    layer: CacheLayer;
+    maxSize: number;
+    maxMemoryMB: number;
+    defaultTTLMs: number;
+    evictionPolicy: EvictionPolicy;
+    warmupEnabled: boolean;
+    compressionEnabled: boolean;
+}
+
+/**
+ * releaseManager.ts — SOVR 冻结发布管理器
+ *
+ * 来源文档: 主权AIv1.2冻结发布方案.pdf + SOVRv2.0最终阶段计划.pdf + SOVRv2.0Gamma自动化执行计划.pdf (4 份文档)
+ * 优先级: P1
+ *
+ * 职责:
+ *   1. 版本冻结管理 (Code Freeze / Feature Freeze)
+ *   2. 发布 Checklist 自动化
+ *   3. 回归测试协调
+ *   4. 发布门禁 (Release Gate)
+ *   5. 灰度发布与回滚管理
+ */
+type FreezeType = 'feature_freeze' | 'code_freeze' | 'full_freeze';
+type ReleasePhase = 'planning' | 'development' | 'feature_frozen' | 'code_frozen' | 'testing' | 'staging' | 'canary' | 'rolling' | 'released' | 'rolled_back';
+type ChecklistItemStatus = 'pending' | 'in_progress' | 'passed' | 'failed' | 'skipped' | 'blocked';
+interface ReleaseVersion {
+    id: string;
+    version: string;
+    codename: string;
+    phase: ReleasePhase;
+    freezeType?: FreezeType;
+    frozenAt?: number;
+    plannedDate: number;
+    actualDate?: number;
+    owner: string;
+    changelog: string[];
+    blockers: string[];
+    rollbackPlan: string;
+    metadata: Record<string, unknown>;
+}
+interface ChecklistItem {
+    id: string;
+    releaseId: string;
+    category: 'build' | 'test' | 'security' | 'performance' | 'docs' | 'infra' | 'approval';
+    name: string;
+    description: string;
+    status: ChecklistItemStatus;
+    assignee: string;
+    completedAt?: number;
+    evidence?: string;
+    required: boolean;
+}
+
 /**
  * @sovr/engine — Unified Policy Engine
  *
@@ -2086,4 +2831,4 @@ declare class PolicyEngine {
     }): void;
 }
 
-export { type ABTestConfig, AdaptiveThresholdManager, type AdaptiveThresholdOptions, type AdjustmentResult, type AggregateSnapshot, type AggregationResult, type AggregationType, type AggregationWindow, type AssembledContext, type AuditEvent, AutoHardenEngine, type BudgetAlert, type BudgetLevel, type BudgetNode, type CacheEntry, type Channel, type CircuitBreakerState, type CircuitState, type ComparableInput, type ComparableResult, type ComparisonNode, type CompiledExpression, type ConsistencyMismatch, type ConsistencyResult, ContextAccelerator, type ContextAcceleratorConfig, type ContextFragment, type ContextPriority, type CostAuditEvent, type CostCategory, type CostEstimate, type CostEstimateRequest, type CostGateEnhancedConfig, CostGateEnhancedEngine, type CostRecord, type CostReport, type CostSummary, type DCFInput, type DCFResult, DEFAULT_CA_CONFIG, DEFAULT_GE_CONFIG, DEFAULT_HARD_RULES, DEFAULT_RULES, DEFAULT_SCORING_WEIGHTS, DEFAULT_TSA_CONFIG, type DataPoint, type DecisionFeedback, type DegradationLevel, type DriftConfig, type DriftResult, type EligibilityResult, type EngineConfig, type EngineTier, type EngineTierLimits, type EstimateAccuracy, type EvalContext, type EvalRequest, type EvalResult, EvolutionChannelEngine, type EvolutionConfig, type EvolutionEvent, type ExecContext, type ExprTreePolicyRule, type ExpressionNode, type FeatureSwitchDef, type FeatureSwitchState, FeatureSwitchesManager, type FeatureSwitchesOptions, type FunctionNode, type PolicyVersion as GovPolicyVersion, type GovernanceDecision, GovernanceEnhancer, type GovernanceEnhancerConfig, type GovernanceRule, type HardRule, type HardenConfig, type HardenEvent, type HardenLevel, type HardenMeasure, type HardenMeasureType, type HardenState, type HttpContext, type LiteralNode, type LogicalNode, type MarketSize, type McpContext, type ModelCandidate, type ModelPricing, type ModelTier, type MultiLevelBudgetConfig, MultiLevelBudgetEngine, type NetworkEffectInput, type NetworkEffectResult, type NotNode, PolicyEngine, type PolicyRule, type PolicySnapshot, type PolicyVersion$1 as PolicyVersion, type PrefetchRule, type PricingEvalRequest, type PricingEvalResult, type PricingRule, PricingRulesEngine, type ReasonCode, type RecalcEngineConfig, type RecalcGranularity, type RecalcHandler, type RecalcTask, type RecalcTaskStatus, type RecalcTriggerType, RecalculationEngine, type RiskLevel, type RoutingDecision, type RoutingRequest, type RuleCondition, type RuleEvalResult, SOVR_FEATURE_SWITCHES, type ScoringResult, type ScoringWeights, SemanticDriftDetectorEngine, type SemanticFingerprint, type SensitivityResult, type SqlContext, type ThresholdConfig, TimeSeriesAggregator, type TimeSeriesAggregatorConfig, type ToolPricing, TwoPhaseRouter, type TwoPhaseRouterConfig, type UnitEconomics, ValuationModel, type ValuationModelConfig, type VariableNode, type Verdict, type WindowType, compileFromJSON, compileRuleSet, createAutoHardenEngine, createCostGateEnhanced, createEvolutionChannel, createMultiLevelBudget, createRecalculationEngine, createSemanticDriftDetector, PolicyEngine as default, estimateCost, evaluateRules, getAccuracyStats, getModelPricingTable, getToolPricingTable, recordActualCost, registerFunction, updateModelPricing, updateToolPricing };
+export { type ABTestConfig, AdaptiveThresholdManager, type AdaptiveThresholdOptions, type AdjustmentResult, type AggregateSnapshot, type AggregationResult, type AggregationType, type AggregationWindow, type AlertEvent, type AlertSeverity$1 as AlertSeverity, type AlertThreshold, type AlertType, type AssembledContext, type AttributionRule, type AuditEvent, AutoHardenEngine, type BudgetAlert, type BudgetConfig, type BudgetLevel, type BudgetNode, type CacheConfig, type CacheEntry, type CacheLayer, type CacheStrategy, type CapabilityFlags, type CapitalizationResult, type Channel, type ChecklistItem, type ChecklistItemStatus, type CircuitBreakerState, type CircuitState, type ClockDriftReport, type CockpitMetric, type CockpitTimeWindow, type ComparableInput, type ComparableResult, type ComparisonNode, type CompiledExpression, type ConsistencyMismatch, type ConsistencyResult, type ConstraintCheckResult, type ConstraintConfig, type ConstraintDecision, type ConstraintLevel, type ConstraintMode, type ConstraintState, type ConstraintTrigger, ContextAccelerator, type ContextAcceleratorConfig, type ContextFragment, type ContextPriority, type ContributionDimension, type ContributionEvent, type ContributionScore, ContributionSettlementEngine, type CostAlert, type CostAuditEvent, type CostCategory$1 as CostCategory, type CostEntry, type CostEstimate, type CostEstimateRequest, type CostGateEnhancedConfig, CostGateEnhancedEngine, type CostRecord, type CostReport, type CostSummary, type DCFInput, type DCFResult, DEFAULT_CA_CONFIG, DEFAULT_GE_CONFIG, DEFAULT_HARD_RULES, DEFAULT_RULES, DEFAULT_SCORING_WEIGHTS, DEFAULT_TSA_CONFIG, type DataPoint, type DecisionFeedback, type DegradationLevel, type DegradeState, type DriftAlert, type DriftAnalyzerConfig, type DriftConfig, type DriftIndex, type DriftPattern, type DriftResult, type DriftWindow, type EligibilityResult, type EngineConfig, type EngineTier, type EngineTierLimits, type EntityType, type EstimateAccuracy, type EvalContext, type EvalRequest, type EvalResult, type EventOrderValidation, type EvictionPolicy, EvolutionChannelEngine, type EvolutionConfig, type EvolutionEvent, type ExecContext, type ExprTreePolicyRule, type ExpressionNode, type FailureBudget, type FailureCategory, type FailureRecord, type FailureSeverity, type FeasibilityCheck, type FeatureSwitchDef, type FeatureSwitchState, FeatureSwitchesManager, type FeatureSwitchesOptions, type CostCategory as FinOpsCostCategory, type FreezeType, type FunctionNode, type PolicyVersion as GovPolicyVersion, type GovernanceDecision, GovernanceEnhancer, type GovernanceEnhancerConfig, type GovernanceRule, type HardRule, type HardenConfig, type HardenEvent, type HardenLevel, type HardenMeasure, type HardenMeasureType, type HardenState, type HealthScore, type HttpContext, type KillSwitchState, type LiteralNode, type LogicalNode, type MarketSize, type McpContext, type MetricPoint, type ModelCandidate, type ModelPricing, type ModelTier, type MonitoringMetrics, type MultiLevelBudgetConfig, MultiLevelBudgetEngine, type NetworkEffectInput, type NetworkEffectResult, type NotNode, OverrideDriftAnalyzer, type OverrideEvent, type PenaltyCheck, PolicyEngine, type PolicyRule, type PolicySnapshot, type PolicyVersion$1 as PolicyVersion, type PrefetchRule, type PricingEvalRequest, type PricingEvalResult, type PricingRule, PricingRulesEngine, type ProtectiveAction, type RankResult, type RankableItem, type RankingConfig, type RankingSnapshot, type RealityConstraint, type ReasonCode, type RecalcEngineConfig, type RecalcGranularity, type RecalcHandler, type RecalcTask, type RecalcTaskStatus, type RecalcTriggerType, RecalculationEngine, type ReleasePhase, type ReleaseVersion, type RiskLevel, type RoutingDecision, type RoutingRequest, type RuleCondition, type RuleEvalResult, SOVR_FEATURE_SWITCHES, type ScoreConfigVersion, type ScoringResult, type ScoringWeights, SelfConstraintEngine, SemanticDriftDetectorEngine, type SemanticFingerprint, type SensitivityResult, type SettlementContext, type SqlContext, type SystemState, TIME_WINDOWS, type ThresholdConfig, type TighteningThresholds, type TimeConsistencyConfig, TimeSeriesAggregator, type TimeSeriesAggregatorConfig, type TimestampRecord, type ToolPricing, TrendAlertEngine, type TrendMetric, TwoPhaseRouter, type TwoPhaseRouterConfig, type UnitEconomics, ValuationModel, type ValuationModelConfig, type VariableNode, type Verdict, type WindowType, compileFromJSON, compileRuleSet, createAutoHardenEngine, createCostGateEnhanced, createEvolutionChannel, createMultiLevelBudget, createRecalculationEngine, createSemanticDriftDetector, PolicyEngine as default, estimateCost, evaluateRules, getAccuracyStats, getModelPricingTable, getToolPricingTable, recordActualCost, registerFunction, updateModelPricing, updateToolPricing };