import log from "loglevel";
export declare const METICULOUS_LOGGER_NAME = "@alwaysmeticulous";
export declare const initLogger: () => log.Logger;
export declare const setLogLevel: (logLevel: string | undefined) => void;
/**
 * Writes a verbose progress line to **stderr** (so stdout stays reserved for
 * machine-readable output), shown only when the logger level is INFO or more
 * verbose — i.e. under `--verbose` / `--logLevel info|debug|trace`. Use for
 * step-by-step progress that should be hidden by default.
 *
 * Uses `console.error` (stderr in Node, the console in browsers) deliberately:
 * the loglevel logger's `info` level writes to stdout, which would interleave
 * progress with machine-readable output.
 */
export declare const logProgress: (message: string) => void;
/**
 * Writes an always-on diagnostic line to **stderr** (shown regardless of
 * `--verbose`), so stdout stays reserved for machine-readable output. Use for
 * warnings and essential notices that must always surface.
 */
export declare const logNotice: (message: string) => void;