CLI: Set PLAYGROUND_AUTO_LOGIN_AS_USER at boot time for all workers when --login is used

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

@@ -195,6 +195,7 @@ export class BlueprintsV1Handler {
 			withXdebug: !!this.args.xdebug,
 			nativeInternalDirPath,
 			pathAliases: this.args.pathAliases,
+			constants: mergeDefinedConstants(this.args),
 		});
 		await playground.isReady();
 		return playground;

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

@@ -52,6 +52,7 @@ interface WorkerBootRequestHandlerOptions {
 	withMemcached?: boolean;
 	withXdebug?: boolean;
 	pathAliases?: PathAlias[];
+	constants?: Record<string, string | number | boolean>;
 }
 
 /**
@@ -162,6 +163,7 @@ export class PlaygroundCliBlueprintV1Worker extends PHPWorker {
 			const requestHandler = await bootRequestHandler({
 				siteUrl: options.siteUrl,
 				maxPhpInstances: 1,
+				constants: options.constants,
 				createPhpRuntime: createPhpRuntimeFactory(
 					options,
 					this.fileLockManager!

packages/playground/cli/src/defines.ts

@@ -172,17 +172,28 @@ function mergeConstants(
 /**
  * Merge all constants from CLI arguments.
  *
+ * When `login` is true, `PLAYGROUND_AUTO_LOGIN_AS_USER` is injected so that
+ * every PHP worker defines the constant at boot time — not just the single
+ * worker that would run the blueprint `login` step via the pool proxy.
+ *
  * @param args - CLI arguments
  * @returns Merged constants
  */
 export function mergeDefinedConstants(args: {
 	define?: Record<string, string>;
 	'define-bool'?: Record<string, boolean>;
 	'define-number'?: Record<string, number>;
+	login?: boolean;
 }): Record<string, string | number | boolean> {
-	return mergeConstants(
+	const merged = mergeConstants(
 		args['define'],
 		args['define-bool'],
 		args['define-number']
 	);
+
+	if (args.login && !Object.hasOwn(merged, 'PLAYGROUND_AUTO_LOGIN_AS_USER')) {
+		merged['PLAYGROUND_AUTO_LOGIN_AS_USER'] = 'admin';
+	}
+
+	return merged;
 }

packages/playground/cli/tests/merge-defined-constants.spec.ts

@@ -0,0 +1,61 @@
+import { mergeDefinedConstants } from '../src/defines';
+
+describe('mergeDefinedConstants', () => {
+	it('should merge string, boolean, and number constants', () => {
+		const result = mergeDefinedConstants({
+			define: { API_KEY: 'secret' },
+			'define-bool': { WP_DEBUG: true },
+			'define-number': { LIMIT: 100 },
+		});
+		expect(result).toEqual({
+			API_KEY: 'secret',
+			WP_DEBUG: true,
+			LIMIT: 100,
+		});
+	});
+
+	it('should return empty object when no constants are provided', () => {
+		const result = mergeDefinedConstants({});
+		expect(result).toEqual({});
+	});
+
+	it('should inject PLAYGROUND_AUTO_LOGIN_AS_USER when login is true', () => {
+		const result = mergeDefinedConstants({ login: true });
+		expect(result).toEqual({
+			PLAYGROUND_AUTO_LOGIN_AS_USER: 'admin',
+		});
+	});
+
+	it('should not inject login constant when login is false', () => {
+		const result = mergeDefinedConstants({ login: false });
+		expect(result).toEqual({});
+	});
+
+	it('should not inject login constant when login is undefined', () => {
+		const result = mergeDefinedConstants({});
+		expect(result).toEqual({});
+	});
+
+	it('should not override explicit PLAYGROUND_AUTO_LOGIN_AS_USER from --define', () => {
+		const result = mergeDefinedConstants({
+			define: { PLAYGROUND_AUTO_LOGIN_AS_USER: 'editor' },
+			login: true,
+		});
+		expect(result).toEqual({
+			PLAYGROUND_AUTO_LOGIN_AS_USER: 'editor',
+		});
+	});
+
+	it('should preserve other constants alongside the injected login constant', () => {
+		const result = mergeDefinedConstants({
+			define: { API_KEY: 'secret' },
+			'define-bool': { WP_DEBUG: true },
+			login: true,
+		});
+		expect(result).toEqual({
+			API_KEY: 'secret',
+			WP_DEBUG: true,
+			PLAYGROUND_AUTO_LOGIN_AS_USER: 'admin',
+		});
+	});
+});