Function log

src/utils/logger.ts:250–287

(level: string, message: string, context?: LogContext)

 * @param context Optional context to control Sentry capture and other behavior
 */
export function log(level: string, message: string, context?: LogContext): void {
  const timestamp = new Date().toISOString();
  const logMessage = `[${timestamp}] [${level.toUpperCase()}] ${message}`;

  const captureToSentry = isSentryEnabled() && __shouldCaptureToSentryForTests(context);

  if (captureToSentry) {
    withSentry((s) => {
      const sentryLevel = mapLogLevelToSentry(level);
      const loggerMethod = s.logger?.[sentryLevel];
      if (typeof loggerMethod === 'function') {
        loggerMethod(message);
        return;
      }
      s.captureMessage(logMessage);
    });
  }

  if (logFileStream && clientLogLevel !== 'none') {
    try {
      logFileStream.write(`${logMessage}\n`);
    } catch {
      // ignore file logging failures
    }
  }

  if (!shouldLog(level)) {
    return;
  }

  // Uses stderr to avoid interfering with MCP protocol on stdout
  // https://modelcontextprotocol.io/docs/tools/debugging#server-side-logging
  if (areProcessStdioWritesSuppressed()) {
    return;
  }

  console.error(logMessage);
}