soloforge 1.1.42 → 1.1.44

package/dist/shared/llm_gateway.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Llm Gateway — 核心基础层模块。
+ *
+ * 职责边界：
+ * - 负责：CircuitState 等 核心基础层职责
+ * - 不负责：不属于本模块的职责由对应模块承担
+ *
+ * 被谁调用：引擎各子模块、管线层
+ * 调用谁：knowledge_config_loader、logger
+ *
+ * 数据流：底层能力请求 → 处理 → 返回结果
+ * 持久化：无持久化（纯计算/内存态）
+ */
+/** 熔断器状态 */
+export type CircuitState = "closed" | "open" | "half-open";
+/** AI 操作类型分级 */
+export type AIOperationTier = "light" | "medium" | "heavy";
+/** AI 依赖的操作类型 */
+export type AIOperationType = "intent_refinement" | "solution_brainstorm" | "verification_reasoning" | "code_generation" | "test_generation" | "review_deep_analysis" | "debug_analysis";
+/** 操作类型配置: 级别 + Token 估算 */
+interface OperationProfile {
+    tier: AIOperationTier;
+    estimated_tokens: number;
+    description: string;
+}
+/** 调用审计记录 */
+export interface GatewayAuditEntry {
+    /** 操作类型 */
+    operation: AIOperationType;
+    /** 估算 Token 数 */
+    estimated_tokens: number;
+    /** 调用时间戳 */
+    timestamp: string;
+    /** 是否被熔断拦截 */
+    blocked: boolean;
+    /** 关联的任务 ID */
+    task_id?: string;
+}
+/** 网关状态快照 */
+export interface GatewayStatus {
+    /** Token 总预算 */
+    budget_total: number;
+    /** 已使用 Token 数 */
+    budget_used: number;
+    /** 剩余 Token 数 */
+    budget_remaining: number;
+    /** 使用比例 */
+    usage_ratio: number;
+    /** 熔断器状态 */
+    circuit_open: boolean;
+    /** 熔断器详细状态 */
+    circuit_state: CircuitState;
+    /** 总调用次数 */
+    call_count: number;
+    /** 被拦截次数 */
+    blocked_count: number;
+    /** 当前任务已用 Token */
+    task_tokens_used: number;
+    /** 审计日志 */
+    audit_log: GatewayAuditEntry[];
+}
+/** 心跳进度回调 */
+export type HeartbeatCallback = (progress: {
+    elapsed_ms: number;
+    tokens_used: number;
+    operation: AIOperationType;
+    message: string;
+}) => void;
+/**
+ * LLM 统一网关 — 管理 Token 预算、熔断和调用审计。
+ */
+export declare class LLMGateway {
+    private budgetTotal;
+    private budgetUsed;
+    private taskBudget;
+    private taskTokensUsed;
+    private currentTaskId;
+    private callCount;
+    private blockedCount;
+    private auditLog;
+    private circuitState;
+    /** 熔断器进入 open 状态的时间戳，用于 half-open 超时恢复 */
+    private circuitOpenedAt;
+    /** half-open 状态下允许的探测请求次数 */
+    private halfOpenProbeBudget;
+    /** half-open 探测已用次数（当前周期） */
+    private halfOpenProbeUsed;
+    /** 当前时间函数 — 生产环境用 Date.now，测试可注入 */
+    readonly now: () => number;
+    private heartbeatTimer;
+    private heartbeatCallback;
+    private operationStart;
+    private currentOperation;
+    private config;
+    /**
+     * 创建 LLM 网关实例。
+     * @param budget - 可选，Token 总预算，默认从配置读取
+     * @param taskBudget - 可选，单任务 Token 预算，默认从配置读取
+     */
+    constructor(budget?: number, taskBudget?: number);
+    /** 设置心跳回调（用于 stdio 输出进度） */
+    setHeartbeatCallback(cb: HeartbeatCallback): void;
+    /**
+     * 开始新任务的 Token 计量。
+     * @param taskId - 任务 ID
+     */
+    beginTask(taskId: string): void;
+    /** 结束任务计量，停止心跳 */
+    endTask(): void;
+    /**
+     * 请求 AI 操作许可 — 检查 Token 预算和熔断状态。
+     * 被拦截时返回原因说明。
+     *
+     * @param operation - AI 操作类型
+     * @param taskId - 可选的任务 ID
+     * @returns 许可结果，包含是否允许、剩余预算和拦截原因
+     */
+    request(operation: AIOperationType, taskId?: string): {
+        allowed: boolean;
+        estimated_tokens: number;
+        remaining_budget: number;
+        remaining_task_budget: number;
+        reason?: string;
+    };
+    /**
+     * 置信度闸口: 低于阈值禁止执行代码，必须触发头脑风暴流程。
+     * @param confidence - 当前置信度
+     * @returns 闸口结果，包含是否允许和阈值
+     */
+    confidenceGate(confidence: number): {
+        allowed: boolean;
+        threshold: number;
+        reason?: string;
+    };
+    /**
+     * 标记操作失败 — half-open 状态下探测失败时回退到 open 状态。
+     * 防止故障未恢复时大量请求涌入。
+     */
+    failOperation(): void;
+    /** 标记操作完成，停止心跳。half-open 状态下探测成功则关闭熔断器 */
+    completeOperation(): void;
+    /**
+     * 报告实际 Token 用量 — 根据估算与实际的差值调整预算计数。
+     * 差值为正时增加消耗，为负时回退多计部分。熔断器根据实际消耗重新评估。
+     * @param operation - 操作类型
+     * @param actualTokens - 实际消耗的 Token 数
+     */
+    reportActualUsage(operation: AIOperationType, actualTokens: number): void;
+    /**
+     * 获取网关当前状态快照。
+     * @returns 网关状态，包含预算、调用统计和审计日志
+     */
+    getStatus(): GatewayStatus;
+    /**
+     * 重置网关状态 — 清零所有计数器、审计日志和熔断器。
+     * @param budget - 可选的新 Token 总预算
+     */
+    reset(budget?: number): void;
+    /**
+     * 判断操作是否为本地操作（不需要 LLM 算力）。
+     * @param op - 操作名称
+     * @returns 是否为本地操作
+     */
+    static isLocalOperation(op: string): boolean;
+    /**
+     * 判断操作是否为 AI 操作。
+     * @param op - 操作类型
+     * @returns 是否为 AI 操作
+     */
+    static isAIOperation(op: AIOperationType): boolean;
+    /**
+     * 获取操作类型的配置信息。
+     * @param op - 操作类型
+     * @returns 操作配置（级别、Token 估算、描述）
+     */
+    static getProfile(op: AIOperationType): OperationProfile;
+    /**
+     * 启动流式心跳 — 重型操作期间定期发送进度报告，防止客户端超时断连。
+     * @param operation - 当前 AI 操作类型
+     */
+    private startHeartbeat;
+    /** 停止流式心跳计时器 */
+    private stopHeartbeat;
+}
+export {};
+//# sourceMappingURL=llm_gateway.d.ts.map

package/dist/shared/llm_gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm_gateway.d.ts","sourceRoot":"","sources":["../../src/shared/llm_gateway.ts"],"names":[],"mappings":"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"}

package/dist/shared/llm_gateway.js

@@ -0,0 +1,393 @@
+/**
+ * Llm Gateway — 核心基础层模块。
+ *
+ * 职责边界：
+ * - 负责：CircuitState 等 核心基础层职责
+ * - 不负责：不属于本模块的职责由对应模块承担
+ *
+ * 被谁调用：引擎各子模块、管线层
+ * 调用谁：knowledge_config_loader、logger
+ *
+ * 数据流：底层能力请求 → 处理 → 返回结果
+ * 持久化：无持久化（纯计算/内存态）
+ */
+import { loadKnowledgeConfig, extractNumberRule } from "./knowledge_config_loader.js";
+import { debug } from "./logger.js";
+// ── 操作配置表 ──
+/** 各 AI 操作类型的 Token 估算和级别配置 */
+const OPERATION_PROFILES = {
+    intent_refinement: { tier: "medium", estimated_tokens: 2000, description: "意图理解深化" },
+    solution_brainstorm: { tier: "heavy", estimated_tokens: 6000, description: "方案脑暴推演" },
+    verification_reasoning: { tier: "heavy", estimated_tokens: 5000, description: "复杂验证推理" },
+    code_generation: { tier: "heavy", estimated_tokens: 10000, description: "代码生成（含规则注入+门禁+instruction）" },
+    test_generation: { tier: "medium", estimated_tokens: 5000, description: "测试用例生成" },
+    review_deep_analysis: { tier: "heavy", estimated_tokens: 8000, description: "深度审查分析（含12+审查规则注入）" },
+    debug_analysis: { tier: "medium", estimated_tokens: 4000, description: "排障推理" },
+};
+/**
+ * 从知识库 决策网关.md 读取阈值，文件不存在时使用硬编码兜底。
+ * @param projectPath - 可选的项目路径
+ * @returns 网关配置参数
+ */
+function loadGatewayConfig(projectPath) {
+    const config = loadKnowledgeConfig("shared/决策网关.md", projectPath);
+    const body = config?.body ?? "";
+    return {
+        budget_total: extractNumberRule(body, "Budget_Total") ?? 500_000,
+        task_budget: extractNumberRule(body, "Task_Budget") ?? 100_000,
+        circuit_breaker_ratio: extractNumberRule(body, "Circuit_Breaker_Ratio") ?? 0.9,
+        heartbeat_interval: extractNumberRule(body, "Heartbeat_Interval") ?? 5000,
+        confidence_threshold: extractNumberRule(body, "Confidence_Threshold") ?? 0.95,
+    };
+}
+// CORE-005修复: 默认配置改为延迟加载，避免 import 时触发文件读取和 debug 输出
+let _defaultConfig = null;
+function getDefaultConfig() {
+    if (!_defaultConfig)
+        _defaultConfig = loadGatewayConfig();
+    return _defaultConfig;
+}
+// ── 网关核心 ──
+/**
+ * LLM 统一网关 — 管理 Token 预算、熔断和调用审计。
+ */
+export class LLMGateway {
+    budgetTotal;
+    budgetUsed = 0;
+    taskBudget;
+    taskTokensUsed = 0;
+    currentTaskId = null;
+    callCount = 0;
+    blockedCount = 0;
+    auditLog = [];
+    circuitState = "closed";
+    /** 熔断器进入 open 状态的时间戳，用于 half-open 超时恢复 */
+    circuitOpenedAt = 0;
+    /** half-open 状态下允许的探测请求次数 */
+    halfOpenProbeBudget = 1;
+    /** half-open 探测已用次数（当前周期） */
+    halfOpenProbeUsed = 0;
+    /** 当前时间函数 — 生产环境用 Date.now，测试可注入 */
+    now;
+    heartbeatTimer = null;
+    heartbeatCallback = null;
+    operationStart = 0;
+    currentOperation = null;
+    config = getDefaultConfig();
+    /**
+     * 创建 LLM 网关实例。
+     * @param budget - 可选，Token 总预算，默认从配置读取
+     * @param taskBudget - 可选，单任务 Token 预算，默认从配置读取
+     */
+    constructor(budget, taskBudget) {
+        debug("llm_gateway", "LLM 统一网关实例已创建");
+        const resolvedBudget = budget ?? this.config.budget_total;
+        const resolvedTaskBudget = taskBudget ?? this.config.task_budget;
+        // 安全校验: 预算必须为有限正数，防止 NaN/Infinity/负值导致熔断逻辑失效
+        if (!Number.isFinite(resolvedBudget) || resolvedBudget < 0) {
+            throw new RangeError(`LLMGateway: budgetTotal 必须为有限非负数，收到 ${resolvedBudget}`);
+        }
+        if (!Number.isFinite(resolvedTaskBudget) || resolvedTaskBudget < 0) {
+            throw new RangeError(`LLMGateway: taskBudget 必须为有限非负数，收到 ${resolvedTaskBudget}`);
+        }
+        this.budgetTotal = resolvedBudget;
+        this.taskBudget = resolvedTaskBudget;
+        this.now = () => Date.now();
+    }
+    /** 设置心跳回调（用于 stdio 输出进度） */
+    setHeartbeatCallback(cb) {
+        this.heartbeatCallback = cb;
+    }
+    /**
+     * 开始新任务的 Token 计量。
+     * @param taskId - 任务 ID
+     */
+    beginTask(taskId) {
+        this.currentTaskId = taskId;
+        this.taskTokensUsed = 0;
+        debug("llm_gateway", `任务 ${taskId} 开始，Token 计量已重置`);
+    }
+    /** 结束任务计量，停止心跳 */
+    endTask() {
+        this.currentTaskId = null;
+        this.taskTokensUsed = 0;
+        this.stopHeartbeat();
+    }
+    /**
+     * 请求 AI 操作许可 — 检查 Token 预算和熔断状态。
+     * 被拦截时返回原因说明。
+     *
+     * @param operation - AI 操作类型
+     * @param taskId - 可选的任务 ID
+     * @returns 许可结果，包含是否允许、剩余预算和拦截原因
+     */
+    request(operation, taskId) {
+        const profile = OPERATION_PROFILES[operation];
+        const tid = taskId ?? this.currentTaskId ?? undefined;
+        const entry = {
+            operation,
+            estimated_tokens: profile.estimated_tokens,
+            timestamp: new Date().toISOString(),
+            blocked: false,
+            task_id: tid,
+        };
+        // 单任务阈值检查
+        if (this.taskTokensUsed + profile.estimated_tokens > this.taskBudget) {
+            this.blockedCount++;
+            entry.blocked = true;
+            this.auditLog.push(entry);
+            debug("llm_gateway", `单任务 Token 阈值触发 — ${profile.description} 被拦截`);
+            return {
+                allowed: false,
+                estimated_tokens: profile.estimated_tokens,
+                remaining_budget: this.budgetTotal - this.budgetUsed,
+                remaining_task_budget: this.taskBudget - this.taskTokensUsed,
+                reason: `单任务 Token 阈值触发: 当前任务已使用 ${this.taskTokensUsed}/${this.taskBudget}，${profile.description} 需要 ~${profile.estimated_tokens}。建议拆分任务或减少范围`,
+            };
+        }
+        // 全局熔断检查（支持 half-open 探测恢复）
+        // 仅在从 closed/half-open 转换时记录 openedAt，避免重置计时器
+        if ((this.budgetUsed / this.budgetTotal) >= this.config.circuit_breaker_ratio) {
+            if (this.circuitState !== "open") {
+                this.circuitOpenedAt = this.now();
+            }
+            this.circuitState = "open";
+        }
+        if (this.circuitState === "open") {
+            // 检查是否超过 half-open 超时（默认 60 秒）
+            const halfOpenTimeout = 60_000; // 60 秒后允许探测
+            if (this.now() - this.circuitOpenedAt >= halfOpenTimeout) {
+                this.circuitState = "half-open";
+                this.halfOpenProbeUsed = 0;
+                debug("llm_gateway", "熔断器进入 half-open 状态，允许探测请求");
+            }
+        }
+        if (this.circuitState === "open") {
+            this.blockedCount++;
+            entry.blocked = true;
+            this.auditLog.push(entry);
+            debug("llm_gateway", `全局熔断器已开启 — ${profile.description} 被拦截`);
+            return {
+                allowed: false,
+                estimated_tokens: profile.estimated_tokens,
+                remaining_budget: this.budgetTotal - this.budgetUsed,
+                remaining_task_budget: this.taskBudget - this.taskTokensUsed,
+                reason: `Token 预告警: 已使用 ${this.budgetUsed}/${this.budgetTotal}（${((this.budgetUsed / this.budgetTotal) * 100).toFixed(0)}%）。${profile.description} 需要 ~${profile.estimated_tokens} Token，超出安全阈值`,
+            };
+        }
+        if (this.circuitState === "half-open") {
+            // half-open 状态下只允许有限次探测请求
+            if (this.halfOpenProbeUsed >= this.halfOpenProbeBudget) {
+                this.blockedCount++;
+                entry.blocked = true;
+                this.auditLog.push(entry);
+                debug("llm_gateway", `half-open 探测配额已用尽 — ${profile.description} 被拦截`);
+                return {
+                    allowed: false,
+                    estimated_tokens: profile.estimated_tokens,
+                    remaining_budget: this.budgetTotal - this.budgetUsed,
+                    remaining_task_budget: this.taskBudget - this.taskTokensUsed,
+                    reason: `half-open 探测配额已用尽，等待探测结果后决定恢复或继续熔断`,
+                };
+            }
+            this.halfOpenProbeUsed++;
+            debug("llm_gateway", `half-open 探测请求放行 (${this.halfOpenProbeUsed}/${this.halfOpenProbeBudget})`);
+        }
+        if (this.budgetUsed + profile.estimated_tokens > this.budgetTotal) {
+            this.blockedCount++;
+            entry.blocked = true;
+            this.auditLog.push(entry);
+            debug("llm_gateway", `Token 预算不足 — ${profile.description} 被拦截`);
+            return {
+                allowed: false,
+                estimated_tokens: profile.estimated_tokens,
+                remaining_budget: this.budgetTotal - this.budgetUsed,
+                remaining_task_budget: this.taskBudget - this.taskTokensUsed,
+                reason: `Token 预算不足: 剩余 ${this.budgetTotal - this.budgetUsed}，需要 ~${profile.estimated_tokens}`,
+            };
+        }
+        this.budgetUsed += profile.estimated_tokens;
+        this.taskTokensUsed += profile.estimated_tokens;
+        this.callCount++;
+        this.auditLog.push(entry);
+        // 重型操作启动心跳
+        if (profile.tier === "heavy") {
+            this.startHeartbeat(operation);
+        }
+        debug("llm_gateway", `${profile.description} 已放行（预估 ${profile.estimated_tokens} Token）`);
+        return {
+            allowed: true,
+            estimated_tokens: profile.estimated_tokens,
+            remaining_budget: this.budgetTotal - this.budgetUsed,
+            remaining_task_budget: this.taskBudget - this.taskTokensUsed,
+        };
+    }
+    /**
+     * 置信度闸口: 低于阈值禁止执行代码，必须触发头脑风暴流程。
+     * @param confidence - 当前置信度
+     * @returns 闸口结果，包含是否允许和阈值
+     */
+    confidenceGate(confidence) {
+        const threshold = this.config.confidence_threshold;
+        if (confidence < threshold) {
+            debug("llm_gateway", `置信度 ${confidence.toFixed(2)} 低于阈值 ${threshold}，禁止直接执行`);
+            return {
+                allowed: false,
+                threshold,
+                reason: `置信度 ${confidence.toFixed(2)} 低于阈值 ${threshold}，禁止直接输出执行代码，必须触发头脑风暴流程展示三轨方案`,
+            };
+        }
+        return { allowed: true, threshold };
+    }
+    /**
+     * 标记操作失败 — half-open 状态下探测失败时回退到 open 状态。
+     * 防止故障未恢复时大量请求涌入。
+     */
+    failOperation() {
+        this.stopHeartbeat();
+        this.currentOperation = null;
+        if (this.circuitState === "half-open") {
+            this.circuitState = "open";
+            this.circuitOpenedAt = this.now();
+            debug("llm_gateway", "half-open 探测失败，熔断器回退到 open 状态");
+        }
+    }
+    /** 标记操作完成，停止心跳。half-open 状态下探测成功则关闭熔断器 */
+    completeOperation() {
+        this.stopHeartbeat();
+        this.currentOperation = null;
+        // half-open 探测成功 → 关闭熔断器
+        if (this.circuitState === "half-open") {
+            this.circuitState = "closed";
+            debug("llm_gateway", "half-open 探测成功，熔断器已关闭");
+        }
+    }
+    /**
+     * 报告实际 Token 用量 — 根据估算与实际的差值调整预算计数。
+     * 差值为正时增加消耗，为负时回退多计部分。熔断器根据实际消耗重新评估。
+     * @param operation - 操作类型
+     * @param actualTokens - 实际消耗的 Token 数
+     */
+    reportActualUsage(operation, actualTokens) {
+        // 安全校验: actualTokens 必须为有限非负数，防止 NaN/Infinity 污染预算计数
+        if (!Number.isFinite(actualTokens) || actualTokens < 0) {
+            throw new RangeError(`LLMGateway.reportActualUsage(): actualTokens 必须为有限非负数，收到 ${actualTokens}`);
+        }
+        const profile = OPERATION_PROFILES[operation];
+        const diff = actualTokens - profile.estimated_tokens;
+        if (diff > 0) {
+            this.budgetUsed += diff;
+            this.taskTokensUsed += diff;
+            if ((this.budgetUsed / this.budgetTotal) >= this.config.circuit_breaker_ratio) {
+                this.circuitState = "open";
+                this.circuitOpenedAt = this.now();
+                debug("llm_gateway", `实际用量超阈值，熔断器已开启`);
+            }
+        }
+        else {
+            this.budgetUsed = Math.max(0, this.budgetUsed + diff);
+            this.taskTokensUsed = Math.max(0, this.taskTokensUsed + diff);
+        }
+    }
+    /**
+     * 获取网关当前状态快照。
+     * @returns 网关状态，包含预算、调用统计和审计日志
+     */
+    getStatus() {
+        return {
+            budget_total: this.budgetTotal,
+            budget_used: this.budgetUsed,
+            budget_remaining: this.budgetTotal - this.budgetUsed,
+            usage_ratio: this.budgetUsed / this.budgetTotal,
+            circuit_open: this.circuitState !== "closed",
+            circuit_state: this.circuitState,
+            call_count: this.callCount,
+            blocked_count: this.blockedCount,
+            task_tokens_used: this.taskTokensUsed,
+            audit_log: [...this.auditLog],
+        };
+    }
+    /**
+     * 重置网关状态 — 清零所有计数器、审计日志和熔断器。
+     * @param budget - 可选的新 Token 总预算
+     */
+    reset(budget) {
+        const resolvedBudget = budget ?? this.config.budget_total;
+        // 安全校验: 重置时预算必须为有限正数
+        if (!Number.isFinite(resolvedBudget) || resolvedBudget < 0) {
+            throw new RangeError(`LLMGateway.reset(): budget 必须为有限非负数，收到 ${resolvedBudget}`);
+        }
+        this.budgetTotal = resolvedBudget;
+        this.budgetUsed = 0;
+        this.callCount = 0;
+        this.blockedCount = 0;
+        this.auditLog = [];
+        this.circuitState = "closed";
+        this.circuitOpenedAt = 0;
+        this.halfOpenProbeUsed = 0;
+        this.taskTokensUsed = 0;
+        this.stopHeartbeat();
+        debug("llm_gateway", "网关状态已重置");
+    }
+    /**
+     * 判断操作是否为本地操作（不需要 LLM 算力）。
+     * @param op - 操作名称
+     * @returns 是否为本地操作
+     */
+    static isLocalOperation(op) {
+        const LOCAL_OPS = [
+            "classify", "scope_resolve", "knowledge_match", "pattern_extract",
+            "drift_detect", "mutation_test", "coverage_scan", "dependency_scan",
+            "migration_check", "contract_check", "debt_scan", "build_run",
+        ];
+        return LOCAL_OPS.includes(op);
+    }
+    /**
+     * 判断操作是否为 AI 操作。
+     * @param op - 操作类型
+     * @returns 是否为 AI 操作
+     */
+    static isAIOperation(op) {
+        return op in OPERATION_PROFILES;
+    }
+    /**
+     * 获取操作类型的配置信息。
+     * @param op - 操作类型
+     * @returns 操作配置（级别、Token 估算、描述）
+     */
+    static getProfile(op) {
+        return OPERATION_PROFILES[op];
+    }
+    // ── 流式心跳 ──
+    /**
+     * 启动流式心跳 — 重型操作期间定期发送进度报告，防止客户端超时断连。
+     * @param operation - 当前 AI 操作类型
+     */
+    startHeartbeat(operation) {
+        this.stopHeartbeat();
+        this.operationStart = this.now();
+        this.currentOperation = operation;
+        if (!this.heartbeatCallback)
+            return;
+        this.heartbeatTimer = setInterval(() => {
+            if (!this.heartbeatCallback || !this.currentOperation)
+                return;
+            const elapsed = this.now() - this.operationStart;
+            const profile = OPERATION_PROFILES[this.currentOperation];
+            this.heartbeatCallback({
+                elapsed_ms: elapsed,
+                tokens_used: this.taskTokensUsed,
+                operation: this.currentOperation,
+                message: `[SoloForge Heartbeat] ${profile.description} 执行中... 已耗时 ${(elapsed / 1000).toFixed(0)}s，当前任务已用 ${this.taskTokensUsed}/${this.taskBudget} Token`,
+            });
+        }, this.config.heartbeat_interval);
+    }
+    /** 停止流式心跳计时器 */
+    stopHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+    }
+}
+//# sourceMappingURL=llm_gateway.js.map

package/dist/shared/llm_gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm_gateway.js","sourceRoot":"","sources":["../../src/shared/llm_gateway.ts"],"names":[],"mappings":"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"}

package/dist/shared/log_governance.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Log Governance — 核心基础层模块。
+ *
+ * 职责边界：
+ * - 负责：LogGovernanceFinding 等 核心基础层职责
+ * - 不负责：不属于本模块的职责由对应模块承担
+ *
+ * 被谁调用：引擎各子模块、管线层
+ * 调用谁：helpers
+ *
+ * 数据流：底层能力请求 → 处理 → 返回结果
+ * 持久化：无持久化（纯计算/内存态）
+ */
+export interface LogGovernanceFinding {
+    severity: "hard_fail" | "warning";
+    kind: "raw_noise" | "format_violation" | "console_residue" | "internal_leak";
+    message_zh: string;
+    evidence?: string;
+}
+export interface LogGovernanceReport {
+    passed: boolean;
+    findings: LogGovernanceFinding[];
+}
+export declare function classifyOutputVisibility(content: string): "user_visible" | "internal_noise" | "json";
+export declare function assessOutputNoise(outputs: string[]): LogGovernanceReport;
+export declare function validateLogFormat(entry: unknown): LogGovernanceReport;
+export declare function enforceLogGovernance(output: string | string[]): LogGovernanceReport;
+export declare function evaluateFeedbackOutputQuality(params: {
+    output: string;
+    json_mode?: boolean;
+    critical_failure_hidden?: boolean;
+}): LogGovernanceReport;
+//# sourceMappingURL=log_governance.d.ts.map

package/dist/shared/log_governance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log_governance.d.ts","sourceRoot":"","sources":["../../src/shared/log_governance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,WAAW,GAAG,SAAS,CAAC;IAClC,IAAI,EAAE,WAAW,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,eAAe,CAAC;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,oBAAoB,EAAE,CAAC;CAClC;AAQD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,gBAAgB,GAAG,MAAM,CAUpG;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAaxE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAgBrE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,mBAAmB,CAGnF;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC,GAAG,mBAAmB,CAWtB"}