chore: shorten stdio logging comments

Author: Mochxd

src/cli/index.ts

@@ -7,7 +7,6 @@ export async function runCli(args: string[] = process.argv.slice(2)): Promise<vo
     return;
   }
 
-  // Stdio JSON-RPC is on stdout; quiet logging before the first startup info line.
   if (!args.includes('--httpStream')) {
     configureStdioTransportLogging();
   }

src/logger.ts

@@ -4,21 +4,15 @@ import {isStdioTransportLoggingConfigured, markStdioTransportLoggingConfigured}
 
 const log = logger.getLogger('appium-mcp');
 
-/**
- * Move npmlog off stdout when that is the current sink. Leave custom streams
- * (file, Winston, …) and stderr alone so host apps are not rewritten.
- */
+/** npmlog must not write to stdout (stdio JSON-RPC). Skip if the host already set a custom stream. */
 export function ensureLoggerWritesToStderr(): void {
   const root = log.unwrap();
   if (root.stream === process.stdout) {
     root.stream = process.stderr;
   }
 }
 
-/**
- * Quiet stdio MCP processes so info/debug driver and tool logs cannot mix with
- * JSON-RPC. Call only from the stdio startup path, before the first `log.info`.
- */
+/** stdio CLI only: drop info/debug so they cannot sit on stdout. */
 export function configureStdioTransportLogging(): void {
   if (isStdioTransportLoggingConfigured()) {
     return;

src/utils/webdriver-client-options.ts

@@ -1,12 +1,8 @@
 import {isStdioTransportLoggingConfigured} from '../stdio-logging-state.js';
 
-/** Keep WebDriver client protocol logs off stdout (MCP stdio uses stdout for JSON-RPC). */
 export const QUIET_WEBDRIVER_LOG_LEVEL = 'warn' as const;
 
-/**
- * Adds `logLevel: warn` only after the stdio CLI path has opted in.
- * httpStream and `appium-mcp/core` hosts keep the existing / `WDIO_LOG_LEVEL` setting.
- */
+/** `logLevel: warn` only after the stdio CLI path ran. */
 export function withQuietWebDriverLogging<T extends Record<string, unknown>>(
   options: T,
 ): T | (T & {logLevel: typeof QUIET_WEBDRIVER_LOG_LEVEL}) {