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

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

* [agents] Synchronize top-level packaged agent files (#185)

* Update wiki submodule pointer for PR #198

* [tests] Narrow composer plugin fixture to tracked inputs (#185)

* [sync] Preserve relative packaged symlink targets (#185)

* [style] Separate command help from option chains (#185)

* [style] Keep single-option command setup compact (#185)

* [style] Wrap long command help strings (#185)

* [refactor] Simplify symlink origin handling (#185)

---------

Co-authored-by: github-actions <41898282+github-actions[bot]@users.noreply.github.com>

Author: coisa

.github/wiki

@@ -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
 

CHANGELOG.md

@@ -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,10 @@ 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/AgentsCommand.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,11 @@ 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/ChangelogCheckCommand.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,11 @@ 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 +80,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/ChangelogEntryCommand.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,11 @@ 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/ChangelogNextVersionCommand.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,11 @@ 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/ChangelogPromoteCommand.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,11 @@ 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/ChangelogShowCommand.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,11 @@ 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/CodeOwnersCommand.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,10 @@ 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',