no-log.mts

/**
 * Module-level "no-log" mode used to keep stdout clean for automation.
 *
 * When enabled (via `--no-log`, or implicitly by `--json` / `--markdown`),
 * informational CLI output routes to stderr instead of stdout. The primary
 * result payload (JSON, Markdown, or plain-text report) is still the only
 * thing that appears on stdout, so consumers can pipe it safely.
 */

let noLogMode = false

export function setNoLogMode(on: boolean): void {
  noLogMode = on
}

export function isNoLogMode(): boolean {
  return noLogMode
}

/**
 * Returns true when the caller should route informational output to
 * stderr instead of stdout — either because `--no-log` was passed, or
 * because the user asked for a machine-readable output format that
 * must not be polluted by human-readable log lines.
 */
export function shouldQuietStdout(flags?: Record<string, unknown>): boolean {
  if (noLogMode) {
    return true
  }
  if (!flags) {
    return false
  }
  return Boolean(flags['json']) || Boolean(flags['markdown'])
}