[CLI] Support TERM=dumb (#2929)

## Motivation for the change, related issues

Detects a "dumb terminal" and CI environments in the CLI worker to avoid
using rich output features such as line rewriting.

Why?

Because CI logs for the playground-cli tests are polluted with progress
updates:

```
  Downloading WordPress 8%...
  Downloading WordPress 9%...
  Downloading WordPress 10%...
  Downloading WordPress 11%...
  Downloading WordPress 12%...
  Downloading WordPress 13%...
  Downloading WordPress 14%...
  Downloading WordPress 15%...
  Resolving data reference #5: https://downloads.w.org/release/wordpress-6.3.7.zip – 23.76%
  Resolving data reference #5: https://downloads.w.org/release/wordpress-6.3.7.zip – 23.76%
  Resolving data reference #5: https://downloads.w.org/release/wordpress-6.3.7.zip – 23.76%
  Resolving data reference #5: https://downloads.w.org/release/wordpress-6.3.7.zip – 23.77%
  Resolving data reference #5: https://downloads.w.org/release/wordpress-6.3.7.zip – 23.77%
  Resolving data reference #5: https://downloads.w.org/release/wordpress-6.3.7.zip – 23.77%
```

## Testing Instructions (or ideally a Blueprint)

Inspect the CLI CI tests output and confirm it's clean.

Author: adamziel

packages/playground/cli/src/blueprints-v1/blueprints-v1-handler.ts

@@ -25,6 +25,7 @@ import {
 	type SpawnedWorker,
 	type WorkerType,
 } from '../run-cli';
+import { shouldRenderProgress } from '../utils/progress';
 
 /**
  * Boots Playground CLI workers using Blueprint version 1.
@@ -102,7 +103,7 @@ export class BlueprintsV1Handler {
 						wpDetails.releaseUrl,
 						`${wpDetails.version}.zip`,
 						monitor
-				  );
+					);
 			logger.log(
 				`Resolved WordPress release URL: ${wpDetails?.releaseUrl}`
 			);
@@ -268,7 +269,7 @@ export class BlueprintsV1Handler {
 							'latest',
 						...(resolvedBlueprint?.preferredVersions || {}),
 					},
-			  };
+				};
 	}
 
 	writeProgressUpdate(
@@ -279,6 +280,9 @@ export class BlueprintsV1Handler {
 		if (this.args.verbosity === LogVerbosity.Quiet.name) {
 			return;
 		}
+		if (!shouldRenderProgress(writeStream)) {
+			return;
+		}
 		if (message === this.lastProgressMessage) {
 			// Avoid repeating the same message
 			return;

packages/playground/cli/src/blueprints-v2/blueprints-v2-handler.ts

@@ -6,6 +6,7 @@ import type {
 } from './worker-thread-v2';
 import type { MessagePort as NodeMessagePort } from 'worker_threads';
 import type { RunCLIArgs, SpawnedWorker, WorkerType } from '../run-cli';
+import { shouldRenderProgress } from '../utils/progress';
 
 /**
  * Boots Playground CLI workers using Blueprint version 2.
@@ -108,6 +109,9 @@ export class BlueprintsV2Handler {
 		message: string,
 		finalUpdate: boolean
 	) {
+		if (!shouldRenderProgress(writeStream)) {
+			return;
+		}
 		if (message === this.lastProgressMessage) {
 			// Avoid repeating the same message
 			return;

packages/playground/cli/src/blueprints-v2/worker-thread-v2.ts

@@ -39,6 +39,7 @@ import type {
 	PhpIniOptions,
 	PHPInstanceCreatedHook,
 } from '@wp-playground/wordpress';
+import { shouldRenderProgress } from '../utils/progress';
 
 async function mountResources(php: PHP, mounts: Mount[]) {
 	for (const mount of mounts) {
@@ -74,7 +75,8 @@ function tracePhpWasm(processId: number, format: string, ...args: any[]) {
 }
 
 /**
- * Force TTY status to preserve ANSI control codes in the output.
+ * Force TTY status to preserve ANSI control codes in the output
+ * when the environment is interactive.
  *
  * This script is spawned as `new Worker()` and process.stdout and process.stderr are
  * WritableWorkerStdio objects. By default, they strip ANSI control codes from the output
@@ -90,6 +92,9 @@ Object.defineProperty(process.stderr, 'isTTY', { value: true });
 const output = {
 	lastWriteWasProgress: false,
 	progress(data: string) {
+		if (!shouldRenderProgress(process.stdout)) {
+			return;
+		}
 		if (!process.stdout.isTTY) {
 			// eslint-disable-next-line no-console
 			console.log(data);
@@ -382,9 +387,8 @@ export class PlaygroundCliBlueprintV2Worker extends PHPWorker {
 			if ((await streamedResponse!.exitCode) !== 0) {
 				// exitCode != 1 means the blueprint execution failed. Let's throw an error.
 				// and clean up.
-				const syncResponse = await PHPResponse.fromStreamedResponse(
-					streamedResponse
-				);
+				const syncResponse =
+					await PHPResponse.fromStreamedResponse(streamedResponse);
 				throw new PHPExecutionFailureError(
 					`PHP.run() failed with exit code ${syncResponse.exitCode}.`,
 					syncResponse,

packages/playground/cli/src/utils/progress.ts

@@ -0,0 +1,17 @@
+export function shouldRenderProgress(
+	writeStream?: { isTTY?: boolean } | null
+): boolean {
+	const termIsDumb = (process.env['TERM'] || '').toLowerCase() === 'dumb';
+	const ciFlag = (process.env['CI'] || '').toLowerCase();
+	const runningInCI = ciFlag === '1' || ciFlag === 'true';
+
+	if (termIsDumb || runningInCI) {
+		return false;
+	}
+
+	if (writeStream) {
+		return Boolean(writeStream.isTTY);
+	}
+
+	return true;
+}