[composer] Restore consumer command discovery compatibility (#185)

Author: coisa

CHANGELOG.md

@@ -19,6 +19,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Keep packaged `.agents` payloads exportable and synchronize packaged skills and agents with repository-relative symlink targets so consumer repositories no longer receive broken absolute machine paths (#188)
 - Rewrite drifted Git hooks by removing the previous target first, restore the intended `0o755` executable mode, and report unwritable hook replacements cleanly when `.git/hooks` stays locked (#190)
+- Keep Composer plugin command discovery compatible with consumer environments by moving unsupported Symfony Console named parameters out of command metadata/configuration and by decoupling the custom filesystem wrapper from Composer's bundled Symfony Filesystem signatures (#185)
 
 ## [1.20.0] - 2026-04-23
 

src/Console/Command/AgentsCommand.php

@@ -35,8 +35,7 @@
  */
 #[AsCommand(
     name: 'agents',
-    description: 'Synchronizes Fast Forward project agents into .agents/agents directory.',
-    help: 'This command ensures the consumer repository contains linked Fast Forward project agents by creating symlinks to the packaged prompts and removing broken links.'
+    description: 'Synchronizes Fast Forward project agents into .agents/agents directory.'
 )]
 final class AgentsCommand extends BaseCommand implements LoggerAwareCommandInterface
 {
@@ -63,6 +62,7 @@ public function __construct(
      */
     protected function configure(): void
     {
+        $this->setHelp('This command ensures the consumer repository contains linked Fast Forward project agents by creating symlinks to the packaged prompts and removing broken links.');
         $this->addJsonOption();
     }
 

src/Console/Command/ChangelogCheckCommand.php

@@ -35,8 +35,7 @@
  */
 #[AsCommand(
     name: 'changelog:check',
-    description: 'Checks whether a changelog file contains meaningful unreleased entries.',
-    help: 'This command validates the current Unreleased section and may compare it against a base git reference to enforce pull request changelog updates.'
+    description: 'Checks whether a changelog file contains meaningful unreleased entries.'
 )]
 final class ChangelogCheckCommand extends BaseCommand implements LoggerAwareCommandInterface
 {
@@ -61,6 +60,7 @@ public function __construct(
      */
     protected function configure(): void
     {
+        $this->setHelp('This command validates the current Unreleased section and may compare it against a base git reference to enforce pull request changelog updates.');
         $this->addJsonOption()
             ->addOption(
                 name: 'against',

src/Console/Command/ChangelogEntryCommand.php

@@ -38,8 +38,7 @@
  */
 #[AsCommand(
     name: 'changelog:entry',
-    description: 'Adds a changelog entry to Unreleased or a specific version section.',
-    help: 'This command appends one categorized changelog entry to the selected changelog file so it can be reused by local authoring flows and skills.'
+    description: 'Adds a changelog entry to Unreleased or a specific version section.'
 )]
 final class ChangelogEntryCommand extends BaseCommand implements LoggerAwareCommandInterface
 {
@@ -64,6 +63,7 @@ public function __construct(
      */
     protected function configure(): void
     {
+        $this->setHelp('This command appends one categorized changelog entry to the selected changelog file so it can be reused by local authoring flows and skills.');
         $this->addJsonOption()
             ->addArgument(
                 name: 'message',
@@ -76,10 +76,6 @@ protected function configure(): void
                 mode: InputOption::VALUE_REQUIRED,
                 description: 'The changelog category (added, changed, deprecated, removed, fixed, security).',
                 default: 'added',
-                suggestedValues: array_map(
-                    static fn(ChangelogEntryType $type): string => strtolower($type->value),
-                    ChangelogEntryType::ordered()
-                ),
             )
             ->addOption(
                 name: 'release',

src/Console/Command/ChangelogNextVersionCommand.php

@@ -36,8 +36,7 @@
  */
 #[AsCommand(
     name: 'changelog:next-version',
-    description: 'Infers the next semantic version from the Unreleased changelog section.',
-    help: 'This command inspects Unreleased changelog categories and prints the next semantic version inferred from the current changelog state.'
+    description: 'Infers the next semantic version from the Unreleased changelog section.'
 )]
 final class ChangelogNextVersionCommand extends BaseCommand implements LoggerAwareCommandInterface
 {
@@ -62,6 +61,7 @@ public function __construct(
      */
     protected function configure(): void
     {
+        $this->setHelp('This command inspects Unreleased changelog categories and prints the next semantic version inferred from the current changelog state.');
         $this->addJsonOption()
             ->addOption(
                 name: 'file',

src/Console/Command/ChangelogPromoteCommand.php

@@ -38,8 +38,7 @@
  */
 #[AsCommand(
     name: 'changelog:promote',
-    description: 'Promotes Unreleased entries into a published changelog version.',
-    help: 'This command moves the current Unreleased entries into a released version section, records the release date, and restores an empty Unreleased section.'
+    description: 'Promotes Unreleased entries into a published changelog version.'
 )]
 final class ChangelogPromoteCommand extends BaseCommand implements LoggerAwareCommandInterface
 {
@@ -66,6 +65,7 @@ public function __construct(
      */
     protected function configure(): void
     {
+        $this->setHelp('This command moves the current Unreleased entries into a released version section, records the release date, and restores an empty Unreleased section.');
         $this->addJsonOption()
             ->addArgument(
                 name: 'version',

src/Console/Command/ChangelogShowCommand.php

@@ -37,8 +37,7 @@
  */
 #[AsCommand(
     name: 'changelog:show',
-    description: 'Prints the notes body for a released changelog version.',
-    help: 'This command renders the body of one released changelog section so it can be reused for GitHub release notes.'
+    description: 'Prints the notes body for a released changelog version.'
 )]
 final class ChangelogShowCommand extends BaseCommand implements LoggerAwareCommandInterface
 {
@@ -63,6 +62,7 @@ public function __construct(
      */
     protected function configure(): void
     {
+        $this->setHelp('This command renders the body of one released changelog section so it can be reused for GitHub release notes.');
         $this->addJsonOption()
             ->addArgument(
                 name: 'version',

src/Console/Command/CodeOwnersCommand.php

@@ -37,8 +37,7 @@
  */
 #[AsCommand(
     name: 'codeowners',
-    description: 'Generates .github/CODEOWNERS from local project metadata.',
-    help: 'This command infers CODEOWNERS entries from composer.json metadata, falls back to a commented template, and supports drift-aware preview and overwrite flows.'
+    description: 'Generates .github/CODEOWNERS from local project metadata.'
 )]
 final class CodeOwnersCommand extends BaseCommand implements LoggerAwareCommandInterface
 {
@@ -67,6 +66,7 @@ public function __construct(
      */
     protected function configure(): void
     {
+        $this->setHelp('This command infers CODEOWNERS entries from composer.json metadata, falls back to a commented template, and supports drift-aware preview and overwrite flows.');
         $this->addJsonOption()
             ->addOption(
                 name: 'file',

src/Console/Command/CodeStyleCommand.php

@@ -38,8 +38,7 @@
  */
 #[AsCommand(
     name: 'code-style',
-    description: 'Checks and fixes code style issues using EasyCodingStandard and Composer Normalize.',
-    help: 'This command runs EasyCodingStandard and Composer Normalize to check and fix code style issues.'
+    description: 'Checks and fixes code style issues using EasyCodingStandard and Composer Normalize.'
 )]
 final class CodeStyleCommand extends BaseCommand implements LoggerAwareCommandInterface
 {
@@ -83,6 +82,7 @@ public function __construct(
      */
     protected function configure(): void
     {
+        $this->setHelp('This command runs EasyCodingStandard and Composer Normalize to check and fix code style issues.');
         $this->addJsonOption()
             ->addOption(
                 name: 'progress',

src/Console/Command/CopyResourceCommand.php

@@ -39,8 +39,7 @@
  */
 #[AsCommand(
     name: 'copy-resource',
-    description: 'Copies a file or directory resource into the current project.',
-    help: 'This command copies a configured source file or every file in a source directory into the target path.'
+    description: 'Copies a file or directory resource into the current project.'
 )]
 final class CopyResourceCommand extends BaseCommand implements LoggerAwareCommandInterface
 {
@@ -71,6 +70,7 @@ public function __construct(
      */
     protected function configure(): void
     {
+        $this->setHelp('This command copies a configured source file or every file in a source directory into the target path.');
         $this->addJsonOption()
             ->addOption(
                 name: 'source',