soloforge 1.1.2 → 1.1.31

package/dist/engine/core/llm_gateway.js

@@ -0,0 +1,374 @@
+import { loadKnowledgeConfig, extractNumberRule } from "./knowledge_config_loader.js";
+import { debug } from "./logger.js";
+debug("llm_gateway", "LLM 统一网关模块已加载");
+// ── 操作配置表 ──
+/** 各 AI 操作类型的 Token 估算和级别配置 */
+const OPERATION_PROFILES = {
+    intent_refinement: { tier: "medium", estimated_tokens: 2000, description: "意图理解深化" },
+    solution_brainstorm: { tier: "heavy", estimated_tokens: 4000, description: "方案脑暴推演" },
+    verification_reasoning: { tier: "heavy", estimated_tokens: 3000, description: "复杂验证推理" },
+    code_generation: { tier: "heavy", estimated_tokens: 5000, description: "代码生成" },
+    test_generation: { tier: "medium", estimated_tokens: 3000, description: "测试用例生成" },
+    review_deep_analysis: { tier: "heavy", estimated_tokens: 4000, description: "深度审查分析" },
+    debug_analysis: { tier: "medium", estimated_tokens: 2500, description: "排障推理" },
+};
+/**
+ * 从知识库 决策网关.md 读取阈值，文件不存在时使用硬编码兜底。
+ * @param projectPath - 可选的项目路径
+ * @returns 网关配置参数
+ */
+function loadGatewayConfig(projectPath) {
+    const config = loadKnowledgeConfig("patterns/core/决策网关.md", projectPath);
+    const body = config?.body ?? "";
+    return {
+        budget_total: extractNumberRule(body, "Budget_Total") ?? 100_000,
+        task_budget: extractNumberRule(body, "Task_Budget") ?? 30_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,
+    };
+}
+const DEFAULT_CONFIG = loadGatewayConfig();
+// ── 网关核心 ──
+/**
+ * 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 = DEFAULT_CONFIG;
+    /**
+     * 创建 LLM 网关实例。
+     * @param budget - 可选，Token 总预算，默认从配置读取
+     * @param taskBudget - 可选，单任务 Token 预算，默认从配置读取
+     */
+    constructor(budget, taskBudget) {
+        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,
+        };
+    }
+    /**
+     * 置信度闸口: 低于阈值禁止执行代码，必须调用 sf_brainstorm。
+     * @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}，禁止直接输出执行代码，必须调用 sf_brainstorm 展示三轨方案`,
+            };
+        }
+        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/engine/core/llm_gateway.js.map

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

package/dist/engine/core/log_governance.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 日志治理与用户可见输出检查。
+ *
+ * 面向 SoloForge 自身输出路径，补足统一 logger 之外的行为级约束。
+ */
+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/engine/core/log_governance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log_governance.d.ts","sourceRoot":"","sources":["../../../src/engine/core/log_governance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;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"}

package/dist/engine/core/log_governance.js

@@ -0,0 +1,71 @@
+/**
+ * 日志治理与用户可见输出检查。
+ *
+ * 面向 SoloForge 自身输出路径，补足统一 logger 之外的行为级约束。
+ */
+import { safeJsonParse } from "./helpers.js";
+const INTERNAL_NOISE_PATTERNS = [
+    /\[soloForge\].*(debug|trace|internal)/i,
+    /validate-release|BATCH\d/i,
+    /raw_prompt|authorization_token|sk-[A-Za-z0-9_-]{8,}/i,
+];
+export function classifyOutputVisibility(content) {
+    const trimmed = content.trim();
+    if (!trimmed)
+        return "user_visible";
+    if ((trimmed.startsWith("{") && trimmed.endsWith("}")) || (trimmed.startsWith("[") && trimmed.endsWith("]"))) {
+        if (safeJsonParse(trimmed) !== undefined) {
+            return "json";
+        }
+        return "user_visible";
+    }
+    return INTERNAL_NOISE_PATTERNS.some((p) => p.test(content)) ? "internal_noise" : "user_visible";
+}
+export function assessOutputNoise(outputs) {
+    const findings = [];
+    for (const output of outputs) {
+        if (classifyOutputVisibility(output) === "internal_noise") {
+            findings.push({
+                severity: "hard_fail",
+                kind: "raw_noise",
+                message_zh: "用户可见输出包含内部治理噪音或敏感信息",
+                evidence: output.slice(0, 160),
+            });
+        }
+    }
+    return { passed: findings.length === 0, findings };
+}
+export function validateLogFormat(entry) {
+    const findings = [];
+    if (typeof entry === "string") {
+        if (classifyOutputVisibility(entry) === "internal_noise") {
+            findings.push({ severity: "hard_fail", kind: "internal_leak", message_zh: "日志字符串包含内部噪音", evidence: entry });
+        }
+        return { passed: findings.length === 0, findings };
+    }
+    if (!entry || typeof entry !== "object") {
+        return { passed: false, findings: [{ severity: "hard_fail", kind: "format_violation", message_zh: "日志条目必须是字符串或对象" }] };
+    }
+    const obj = entry;
+    if (!obj.level || !obj.message) {
+        findings.push({ severity: "warning", kind: "format_violation", message_zh: "结构化日志缺少 level 或 message 字段" });
+    }
+    return { passed: findings.every((f) => f.severity !== "hard_fail"), findings };
+}
+export function enforceLogGovernance(output) {
+    const outputs = Array.isArray(output) ? output : [output];
+    return assessOutputNoise(outputs);
+}
+export function evaluateFeedbackOutputQuality(params) {
+    const findings = [...assessOutputNoise([params.output]).findings];
+    if (params.json_mode) {
+        if (safeJsonParse(params.output) === undefined) {
+            findings.push({ severity: "hard_fail", kind: "format_violation", message_zh: "--json 模式 stdout 必须是纯 JSON" });
+        }
+    }
+    if (params.critical_failure_hidden) {
+        findings.push({ severity: "hard_fail", kind: "internal_leak", message_zh: "用户反馈隐藏了关键失败" });
+    }
+    return { passed: findings.every((f) => f.severity !== "hard_fail"), findings };
+}
+//# sourceMappingURL=log_governance.js.map

package/dist/engine/core/log_governance.js.map

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

package/dist/engine/core/logger.d.ts

@@ -0,0 +1,64 @@
+/**
+ * SoloForge 统一日志模块
+ *
+ * 替代散落在 src 中的 console.log / console.error / console.warn。
+ * 区分用户可见输出、调试日志、错误日志，支持 --json 模式和测试静默。
+ */
+export type LogLevel = "debug" | "internal" | "info" | "warn" | "error";
+/**
+ * 初始化日志器状态。
+ * 在 CLI 入口和测试 setup 中调用。
+ */
+export declare function initLogger(opts?: {
+    json?: boolean;
+    silent?: boolean;
+    debug?: boolean;
+}): void;
+/**
+ * 从环境变量初始化（兼容 SOLOFORGE_DEBUG）。
+ */
+export declare function initLoggerFromEnv(): void;
+/**
+ * 重置日志器状态（测试 teardown 用）。
+ */
+export declare function resetLogger(): void;
+/**
+ * 用户可见信息。输出到 stdout。
+ * CLI 的 --json 模式由调用方自行判断是否输出。
+ */
+export declare function userInfo(...args: unknown[]): void;
+/**
+ * 用户可见警告。输出到 stderr，--json 模式下也输出（不污染 stdout）。
+ */
+export declare function userWarn(...args: unknown[]): void;
+/**
+ * 用户可见错误。输出到 stderr，--json 模式下也输出。
+ */
+export declare function userError(...args: unknown[]): void;
+/**
+ * 用户可见输出（强制 stdout，仅用于 --json 的 JSON.stringify 结果）。
+ * 调用方需确保只传 JSON 字符串。
+ */
+export declare function userJson(payload: string): void;
+/**
+ * 调试日志。仅 SOLOFORGE_DEBUG=1 时输出到 stderr。
+ * 所有引擎内部 trace 应使用此函数。
+ */
+export declare function debug(module: string, ...args: unknown[]): void;
+/**
+ * 内部警告：非用户直接可见，但运维/诊断需要。
+ * 始终输出到 stderr（除非静默模式）。
+ */
+export declare function internalWarn(module: string, ...args: unknown[]): void;
+/**
+ * JSON 安全错误：在 --json 模式下，将错误写入 stderr 而非 stdout。
+ */
+export declare function jsonSafeError(...args: unknown[]): void;
+export declare function isJsonMode(): boolean;
+export declare function isSilenced(): boolean;
+export declare function isDebugEnabled(): boolean;
+/**
+ * 向后兼容旧 debugLog()。新代码应使用 debug()。
+ */
+export declare function debugLog(...args: unknown[]): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/engine/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/engine/core/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAQxE;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,QAItF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,SAGhC;AAED;;GAEG;AACH,wBAAgB,WAAW,SAI1B;AAiBD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,QAE1C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,QAE1C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,QAE3C;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,QAEvC;AAID;;;GAGG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,QAGvD;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,QAG9D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,QAE/C;AAID,wBAAgB,UAAU,YAAwB;AAClD,wBAAgB,UAAU,YAAwB;AAClD,wBAAgB,cAAc,YAA4B;AAI1D;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAGjD"}