Implement a basic "blueprint.php info <blueprint-json>" command

Author: JanJakes

components/Blueprints/Runner.php

@@ -182,6 +182,12 @@ private function validateConfiguration( RunnerConfiguration $config ): void {
 		}
 	}
 
+	public function parseBlueprint(): Blueprint {
+		$blueprint_string = $this->loadBlueprint();
+		$parser           = new BlueprintParser( $this->configuration );
+		return $parser->parse( $blueprint_string );
+	}
+
 	public function run(): void {
 		$tempRoot = wp_unix_sys_get_temp_dir() . '/wp-blueprints-runtime-' . uniqid();
 

components/Blueprints/bin/blueprint.php

@@ -286,6 +286,17 @@ function createProgressReporter(): ProgressReporter {
 		'aliases'         => [ 'run' ],
 		'requiredOptions' => [ 'site-path', 'site-url', 'mode' ],
 	],
+	'info' => [
+		'description'     => 'Show detailed information about a WordPress Blueprint',
+		'positionalArgs'  => [
+			'blueprint' => 'Path / URL / DataReference to the blueprint (required)',
+		],
+		'options'         => array_merge( $commonOptions, [] ),
+		'examples'        => [
+			'php blueprint.php info my-blueprint.json',
+		],
+		'aliases'         => [ 'explain', 'inspect' ],
+	],
 	'help' => [
 		'description'    => 'Show help for WordPress Blueprint Runner CLI',
 		'positionalArgs' => [
@@ -372,6 +383,46 @@ function handleExecCommand( array $positionalArgs, array $options, array $comman
 	}
 }
 
+function handleInfoCommand( array $positionalArgs, array $options, array $commandConfig, ProgressReporter $progressReporter ): void {
+	// Check if help is requested for this command
+	if ( $options['help'] ) {
+		showCommandHelpMessage( 'info', $commandConfig );
+		exit( 0 );
+	}
+
+	// Convert CLI arguments to RunnerConfiguration
+	$defaults = [ 'site-path' => '.', 'site-url' => '', 'mode' => Runner::EXECUTION_MODE_APPLY_TO_EXISTING_SITE, 'db-engine' => 'sqlite', 'truncate-new-site-directory' => false ];
+	$config = cliArgsToRunnerConfiguration( $positionalArgs, $options + $defaults );
+	$config->setProgressObserver( new ProgressObserver( function ( $progress, $caption ) use ( $progressReporter ) {
+		$progressReporter->reportProgress( $progress, $caption );
+	} ) );
+	$runner = new Runner( $config );
+
+	try {
+		$blueprint       = $runner->parseBlueprint();
+		$blueprint_array = $blueprint->getBlueprintArray();
+
+		echo "BLUEPRINT:\n\n";
+		foreach ( $blueprint_array as $key => $value ) {
+			echo sprintf("  %s: %s\n", $key, json_encode( $value, JSON_UNESCAPED_SLASHES ) );
+		}
+
+		echo "\n";
+		echo "EXECUTION PLAN:\n\n";
+		foreach ( $blueprint->getExecutionPlan() as $i => $step ) {
+			echo sprintf("  [%d] %s\n", $i + 1, $step['name']);
+			foreach ( $step['args'] as $key => $value ) {
+				echo '        ' . $key . ': ' . json_encode( $value, JSON_UNESCAPED_SLASHES ) . "\n";
+			}
+			echo "\n";
+		}
+
+		exit(0);
+	} catch ( InvalidArgumentException $e ) {
+		throw new InvalidArgumentException( sprintf( "Invalid Blueprint reference: %s. Hint: paths must start with ./ or /. URLs must start with http:// or https://.", $positionalArgs[0] ) );
+	}
+}
+
 function handleHelpCommand( array $positionalArgs, array $options, array $commandConfigurations, ProgressReporter $progressReporter ): void {
 	if ( ! empty( $positionalArgs ) ) {
 		$requestedCommand = $positionalArgs[0];
@@ -620,6 +671,9 @@ function showCommandHelpMessage( string $command, array $commandConfig ): void {
 		case 'exec':
 			handleExecCommand( $positionalArgs, $options, $commandConfigurations[ $command ], $progressReporter );
 			break;
+		case 'info':
+			handleInfoCommand( $positionalArgs, $options, $commandConfigurations[ $command ], $progressReporter );
+			break;
 		case 'help':
 			handleHelpCommand( $positionalArgs, $options, $commandConfigurations, $progressReporter );
 			break;