fix(composer): docblocks

Author: Anne-Julia Seitz

src/Tool/Composer.php

@@ -5,6 +5,7 @@
 namespace Dazz\PhpMcpTools\Tool;
 
 use Dazz\PhpMcpTools\Exception\InvalidArgumentException;
+use PhpLlm\LlmChain\Chain\JsonSchema\Attribute\With;
 use PhpLlm\LlmChain\Chain\Toolbox\Attribute\AsTool;
 use Webmozart\Assert\Assert;
 
@@ -17,6 +18,9 @@ public function __construct(
     ) {
     }
 
+    /**
+     * @return string Result of checking if executable exists
+     */
     public function exists(): string
     {
         return $this->isExecutableExisting() ? 'composer executable exists' : 'composer executable not found';
@@ -33,6 +37,7 @@ public function exists(): string
      * @throws \InvalidArgumentException If composer executable is not found
      */
     public function execute(
+        #[With(pattern: '/^[a-z\-]+$/')]
         string $command = 'list',
         array $options = [],
         array $arguments = [],
@@ -42,7 +47,7 @@ public function execute(
             throw new InvalidArgumentException('Composer executable not found. Please install Composer.');
         }
 
-        if (!preg_match('/^[a-zA-Z0-9_\-]+$/', $command)) {
+        if (!preg_match('/^[a-z\-]+$/', $command)) {
             throw new InvalidArgumentException('Invalid Composer command. Only alphanumeric characters, underscores, and hyphens are allowed.');
         }