/**
 * 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