meh

Author: JoshuaEstes

docs/tools/chorale/commands/plan.md

@@ -26,6 +26,7 @@ chorale plan [<vendor/name>] [options]
   - `-v`: detailed blocks (per‑section details)
   - `-vv`: detailed blocks + no‑op summaries
   - `-vvv`: everything above plus full JSON plan printed at the end
+- `--composer-only`: Only include composer-related steps; exclude split steps
 - `--show-all`: Include no‑op summaries (same as `-vv` or higher)
 - `--json`: Output as JSON; ideal for `apply` or external tooling
 - `--project-root=PATH`: Explicit project root (defaults to current directory)
@@ -122,6 +123,5 @@ Example snippet (root update):
 
 ## Tips
 
-- Use `--concise` for quick scans, and omit it to see exact JSON diffs.
 - Combine the positional `<vendor/name>` with `--json` to isolate and export a single package’s plan.
 - For CI checks, run with `--strict` so the command exits non‑zero when action is required.

tools/chorale/src/Console/PlanCommand.php

@@ -56,6 +56,8 @@ protected function configure(): void
 - -v: detailed blocks
 - -vv: detailed + include no-op summaries
 - -vvv: everything above plus full JSON plan at end
+Other options:
+- --composer-only: Only include composer-related steps; exclude split steps.
 
 Notes
 - Delta notation [+added/-removed/~changed] summarizes composer map changes.
@@ -67,8 +69,7 @@ protected function configure(): void
             ->addOption('project-root', null, InputOption::VALUE_REQUIRED, 'Project root (default: CWD).')
             ->addOption('paths', null, InputOption::VALUE_REQUIRED | InputOption::VALUE_IS_ARRAY, 'Limit to specific package paths', [])
             ->addOption('json', null, InputOption::VALUE_NONE, 'Output as JSON instead of human-readable.')
-            // --concise retained for compatibility; default output is concise
-            ->addOption('concise', null, InputOption::VALUE_NONE, 'Force one-line summaries only; omit detailed blocks.')
+            ->addOption('composer-only', null, InputOption::VALUE_NONE, 'Only include composer-related steps; exclude split steps.')
             ->addOption('show-all', null, InputOption::VALUE_NONE, 'Show no-op summaries (does not turn them into steps).')
             ->addOption('force-split', null, InputOption::VALUE_NONE, 'Force split steps even if unchanged.')
             ->addOption('verify-remote', null, InputOption::VALUE_NONE, 'Verify remote state if lockfile is missing/stale.')
@@ -83,10 +84,10 @@ protected function execute(InputInterface $input, OutputInterface $output): int
         /** @var list<string> $paths */
         $paths  = (array) $input->getOption('paths');
         $json   = (bool) $input->getOption('json');
+        $composerOnly = (bool) $input->getOption('composer-only');
         $verbosity = $output->getVerbosity();
-        $explicitConcise = (bool) $input->getOption('concise');
-        // Concise by default; -v or higher switches to detailed unless --concise is given
-        $concise = $explicitConcise || ($verbosity <= OutputInterface::VERBOSITY_NORMAL);
+        // Concise by default; increase detail with -v/-vv/-vvv
+        $concise = ($verbosity <= OutputInterface::VERBOSITY_NORMAL);
         // Show no-op summaries at -vv or when explicitly requested
         $showAll = (bool) $input->getOption('show-all') || ($verbosity >= OutputInterface::VERBOSITY_VERY_VERBOSE);
         $force  = (bool) $input->getOption('force-split');
@@ -112,6 +113,22 @@ protected function execute(InputInterface $input, OutputInterface $output): int
         $steps = $result['steps'] ?? [];
         $noop  = $result['noop']  ?? [];
 
+        if ($composerOnly) {
+            $composerTypes = [
+                'package-version-update',
+                'package-metadata-sync',
+                'composer-root-update',
+                'composer-root-merge',
+                'composer-root-rebuild',
+            ];
+            $steps = array_values(array_filter(
+                $steps,
+                static fn(PlanStepInterface $s): bool => in_array($s->type(), $composerTypes, true)
+            ));
+            // Suppress noop summary to avoid confusion with filtered output
+            $noop = [];
+        }
+
         if ($json) {
             $payload = [
                 'version' => 1,