/**
 * Logger — 核心基础层模块。
 *
 * 职责边界：
 * - 负责：按运行模式输出受治理的日志
 * - 不负责：不属于本模块的职责由对应模块承担
 *
 * 被谁调用：引擎各子模块、管线层
 * 调用谁：env、log_governance
 *
 * 数据流：底层能力请求 → 处理 → 返回结果
 * 持久化：无持久化（纯计算/内存态）
 */
/**
 * 初始化日志器状态。
 * 在 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;
/**
 * 调试日志。仅 SOLOFORGE_DEBUG=1 时输出到 stderr。
 * 所有引擎内部 trace 应使用此函数。
 *
 * 在开发模式下同时执行日志治理旁路校验，发现格式违规时
 * 通过 console.warn 输出警告，不阻断日志写入。
 */
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;