[composer] Scope ProxyCommand under composer adapter (#270)

* feat(composer): add command runtime hybrid foundation

* refactor composer json handling away from composer json utility classes

* refactor: complete composer-command migration and cleanup for dev-tools

* Update wiki submodule pointer for PR #270

* refactor: remove logger-aware command interface

* Update wiki submodule pointer for PR #270

* feat: change dirname e basename method names

Signed-off-by: Felipe Sayão Lobato Abreu <github@mentordosnerds.com>

* feat: change dirname e basename method names

Signed-off-by: Felipe Sayão Lobato Abreu <github@mentordosnerds.com>

* Fix coverage metadata and stabilize dev-tools command tests

* Update wiki submodule pointer for PR #270

* fix: align composer command provider test with proxy map keys

* refactor: centralize command retrieval through DevTools API

* Update wiki submodule pointer for PR #270

* fix: avoid registering command aliases in composer provider

* Update wiki submodule pointer for PR #270

* test: guard composer provider against alias-only command entries

* test: align DevTools test with Application::all loader contract

* test: document alias filtering and cover command alias registration

* test: cover alias preservation in composer command provider

* test: avoid command provider assertions depending on map keys

* chore: align standards php-cs-fixer naming and harden command loader

* Update wiki submodule pointer for PR #270

* refactor: rename dockblock references to docheader

* chore: normalize phpdoc command naming and docs

* docs: fix heading formatting in rector-and-phpdoc.rst

Signed-off-by: Felipe Sayão Lobato Abreu <github@mentordosnerds.com>

* test: centralize tooling excluded directories and cleanup fixture handling

* Update wiki submodule pointer for PR #270

* feat: add ignoreErrorsOnPackage for 'composer/composer' in configuration

Co-authored-by: Copilot <copilot@github.com>
Signed-off-by: Felipe Sayão Lobato Abreu <github@mentordosnerds.com>

* docs: update phpdoc section to clarify aliases and functionality

Signed-off-by: Felipe Sayão Lobato Abreu <github@mentordosnerds.com>

* docs: update parameter descriptions for SymfonyStyle in command classes

Co-authored-by: Copilot <copilot@github.com>
Signed-off-by: Felipe Sayão Lobato Abreu <github@mentordosnerds.com>

* Update wiki submodule pointer for PR #270

---------

Signed-off-by: Felipe Sayão Lobato Abreu <github@mentordosnerds.com>
Co-authored-by: github-actions <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Copilot <copilot@github.com>

Author: 3 people

.agents/skills/phpunit-tests/SKILL.md

@@ -83,4 +83,57 @@ Choose the smallest command that proves the change.
 - Re-run after fixes until the targeted tests pass.
 - If failures come from unrelated pre-existing breakage, call that out separately and do not silently claim success.
 
+### Composer plugin validation flow
+
+Some repository test scenarios are only valid when DevTools is executed as a Composer plugin.
+Create a temporary fixture under `backup/` before running plugin-based verification.
+
+```bash
+PROJECT_ROOT="$(pwd)"
+PLUGIN_FIXTURE="$PROJECT_ROOT/backup/composer-plugin-consumer"
+mkdir -p "$PROJECT_ROOT/backup"
+rm -rf "$PLUGIN_FIXTURE"
+mkdir -p "$PLUGIN_FIXTURE"
+
+cat > "$PLUGIN_FIXTURE/composer.json" <<'JSON'
+{
+    "name": "fast-forward/dev-tools-composer-plugin-consumer-fixture",
+    "description": "Fixture project used to validate DevTools plugin behavior.",
+    "license": "MIT",
+    "type": "project",
+    "require": {
+        "fast-forward/dev-tools": "*@dev"
+    },
+    "repositories": [
+        {
+            "type": "path",
+            "url": "../..",
+            "options": {
+                "symlink": true
+            }
+        }
+    ],
+    "minimum-stability": "dev",
+    "prefer-stable": true,
+    "config": {
+        "allow-plugins": {
+            "ergebnis/composer-normalize": true,
+            "fast-forward/dev-tools": true,
+            "phpdocumentor/shim": true,
+            "phpro/grumphp-shim": true,
+            "pyrech/composer-changelogs": true
+        }
+    },
+    "scripts": {
+        "dev-tools": "dev-tools",
+        "dev-tools:fix": "@dev-tools --fix"
+    }
+}
+JSON
+
+cd "$PLUGIN_FIXTURE"
+composer install
+composer tests
+```
+
 Read [references/generation-checklist.md](references/generation-checklist.md) before writing or repairing tests in an unfamiliar repository.

.github/wiki

@@ -2,6 +2,10 @@
 
 declare(strict_types=1);
 
+require __DIR__ . '/vendor/autoload.php';
+
+use FastForward\DevTools\Path\WorkingProjectPathResolver;
+
 $rules = [
     'phpdoc_indent' => true,
     'phpdoc_order' => [
@@ -39,11 +43,7 @@
 
 $finder = PhpCsFixer\Finder::create()
     ->in([getcwd()])
-    ->exclude('public')
-    ->exclude('resources')
-    ->exclude('vendor')
-    ->exclude('tmp')
-;
+    ->exclude(WorkingProjectPathResolver::TOOLING_EXCLUDED_DIRECTORIES);
 
 return (new PhpCsFixer\Config())
     ->setRiskyAllowed(false)

.php-cs-fixer.dist.php

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Add a hybrid command runtime bootstrap and capability bridge that keeps command discovery split between migrated Symfony commands (`DevTools`) and legacy Composer `BaseCommand` commands (`DevToolsComposer`) while exposing proxy commands during Composer execution for the first migration step (#199)
+
+### Changed
+
+- Restore `standards:phpdoc` as the command entry point for PHPDoc checks while keeping
+  the legacy aliases `docheader` and `php-cs-fixer`.
+- Remove the `phpdoc` alias from `reports:docs` to avoid command-name collisions with
+  the standards PHPDoc check command.
+
 ## [1.22.3] - 2026-04-25
 
 ### Fixed

CHANGELOG.md

@@ -20,11 +20,10 @@
 namespace FastForward\DevTools;
 
 use FastForward\DevTools\Console\DevTools;
-use Symfony\Component\Console\Input\ArgvInput;
 
 $projectVendorAutoload = \dirname(__DIR__, 4) . '/vendor/autoload.php';
 $pluginVendorAutoload = \dirname(__DIR__) . '/vendor/autoload.php';
 
 require_once file_exists($projectVendorAutoload) ? $projectVendorAutoload : $pluginVendorAutoload;
 
-DevTools::create()->run(new ArgvInput([...$argv, '--no-plugins']));
+DevTools::create()->run();

bin/dev-tools.php

@@ -41,7 +41,6 @@
     "require": {
         "php": "^8.3",
         "composer-plugin-api": "^2.0",
-        "composer/composer": "^2.9",
         "container-interop/service-provider": "^0.4.1",
         "dg/bypass-finals": "^1.9",
         "ergebnis/agent-detector": "^1.1",
@@ -82,6 +81,9 @@
         "thecodingmachine/safe": "^3.4",
         "twig/twig": "^3.24"
     },
+    "require-dev": {
+        "composer/composer": "^2.9"
+    },
     "minimum-stability": "stable",
     "autoload": {
         "psr-4": {

composer.json

@@ -37,8 +37,9 @@ subprocess execution is needed.
      - ``refactor``
      - Runs Rector with local or packaged configuration.
    * - ``FastForward\DevTools\Console\Command\PhpDocCommand``
-     - ``phpdoc``
-     - Runs PHP-CS-Fixer and a focused Rector PHPDoc pass.
+     - ``standards:phpdoc``
+     - Runs PHP-CS-Fixer and a focused Rector PHPDoc pass. Supported aliases:
+       ``phpdoc``, ``docheader`` and ``php-cs-fixer``.
    * - ``FastForward\DevTools\Console\Command\CodeStyleCommand``
      - ``code-style``
      - Runs Composer Normalize and ECS.

docs/api/commands.rst

@@ -33,7 +33,7 @@ Options
 
 ``--composer-file`` (optional)
    Path to the Composer manifest to synchronize. Default:
-   ``Factory::getComposerFile()``.
+   ``composer.json``.
 
 ``--funding-file`` (optional)
    Path to the GitHub funding file to synchronize. Default:

docs/commands/funding.rst

@@ -33,7 +33,7 @@ Options
    Comma-separated directories that should be excluded from analysis.
 
    Default:
-   ``vendor,tmp,cache,spec,build,.dev-tools,backup,resources,tests/Fixtures``.
+   ``vendor,tmp,cache,spec,build,.dev-tools,backup,resources``.
 
 ``--target=<directory>``
    Output directory for the generated metrics reports.

docs/commands/metrics.rst

@@ -7,6 +7,7 @@ Description
 -----------
 
 The ``phpdoc`` command coordinates PHPDoc checking and fixing using:
+(alias ``docheader`` and ``php-cs-fixer``)
 
 - PHP-CS-Fixer - fixes PHPDoc formatting
 - Rector with ``AddMissingMethodPhpDocRector`` - adds missing method PHPDoc