/**
 * Forgen — Unified Logger
 *
 * 환경변수:
 *   FORGEN_LOG_LEVEL   — debug | info | warn | error (기본: info)
 *   FORGEN_DEBUG       — 활성화할 namespace 목록 (쉼표 구분, 예: 'provider,hook')
 *                        '*' 이면 전체 네임스페이스 활성화
 *   COMPOUND_DEBUG=1   — 레거시 호환: 전체 debug 출력 활성화 (FORGEN_DEBUG='*' 와 동일)
 *
 * 출력 형식: [forgen:namespace] message
 * 출력 스트림: stderr (CLI 사용자 출력과 분리)
 *
 * ADR: debugLog()를 직접 대체하지 않고 내부 구현으로 유지.
 *      기존 호출자는 현행 동작을 유지하면서 점진적으로 createLogger()로 마이그레이션.
 */
export declare enum LogLevel {
    debug = 0,
    info = 1,
    warn = 2,
    error = 3
}
export declare class Logger {
    readonly namespace: string;
    constructor(namespace: string);
    private shouldOutput;
    private write;
    debug(msg: string, error?: unknown): void;
    info(msg: string, error?: unknown): void;
    warn(msg: string, error?: unknown): void;
    error(msg: string, error?: unknown): void;
}
/** namespace 기반 Logger 인스턴스 팩토리 */
export declare function createLogger(namespace: string): Logger;
export declare function debugLog(context: string, msg: string, error?: unknown): void;