remove some comments

Author: soyuka

src/Capability/Discovery/CachedDiscoverer.php

@@ -21,6 +21,7 @@
  * to improve performance when discovery is called multiple times.
  *
  * @internal
+ *
  * @final
  *
  * @author Xentixar <xentixar@gmail.com>

src/Capability/Discovery/Discoverer.php

@@ -43,6 +43,7 @@
  * }
  *
  * @internal
+ *
  * @final
  *
  * @author Kyrian Obikwelu <koshnawaza@gmail.com>

src/Capability/Discovery/DiscovererInterface.php

@@ -14,11 +14,6 @@
 /**
  * Discovers MCP elements (tools, resources, prompts, resource templates) in directories.
  *
- * Implementations can use different strategies:
- * - File system scanning with reflection
- * - Cached discovery
- * - Pre-configured discovery
- *
  * @internal
  *
  * @author Antoine Bluchet <soyuka@gmail.com>

src/Capability/Discovery/SchemaGenerator.php

@@ -78,6 +78,10 @@ public function generate(\Reflector $reflection): array
             throw new \BadMethodCallException(\sprintf('Schema generation from %s is not supported.', $reflection::class));
         }
 
+        if (!$reflection instanceof \ReflectionMethod && !$reflection instanceof \ReflectionFunction) {
+            throw new \BadMethodCallException(\sprintf('Schema generation from %s is not supported.', $reflection::class));
+        }
+
         $methodSchema = $this->extractMethodLevelSchema($reflection);
 
         if ($methodSchema && isset($methodSchema['definition'])) {
@@ -92,8 +96,6 @@ public function generate(\Reflector $reflection): array
     /**
      * Extracts method-level or function-level Schema attribute.
      *
-     * @param \ReflectionFunctionAbstract $reflection
-     *
      * @return SchemaAttributeData
      */
     private function extractMethodLevelSchema(\ReflectionFunctionAbstract $reflection): ?array
@@ -411,11 +413,9 @@ private function applyArrayConstraints(array $paramSchema, array $paramInfo): ar
     /**
      * Parses detailed information about a method's parameters.
      *
-     * @param \ReflectionFunctionAbstract $reflection
-     *
      * @return ParameterInfo[]
      */
-    private function parseParametersInfo(\ReflectionFunctionAbstract $reflection): array
+    private function parseParametersInfo(\ReflectionMethod|\ReflectionFunction $reflection): array
     {
         $docComment = $reflection->getDocComment() ?: null;
         $docBlock = $this->docBlockParser->parseDocBlock($docComment);

src/Capability/Discovery/SchemaGeneratorInterface.php

@@ -14,12 +14,6 @@
 /**
  * Provides JSON Schema generation for reflected elements.
  *
- * Implementations can use different strategies to generate schemas:
- * - Reflection-based (types and docblocks)
- * - Attribute-based (Schema attributes)
- * - External libraries (API Platform, etc.)
- * - Class-based metadata
- *
  * @author Antoine Bluchet <soyuka@gmail.com>
  */
 interface SchemaGeneratorInterface
@@ -28,11 +22,7 @@ interface SchemaGeneratorInterface
      * Generates a JSON Schema for input parameters.
      *
      * The returned schema must be a valid JSON Schema object (type: 'object')
-     * with properties corresponding to parameters.
-     *
-     * - For ReflectionMethod/ReflectionFunction: schema based on method parameters
-     * - For ReflectionClass: schema based on __construct, __invoke parameters,
-     *   or class properties/metadata
+     * with properties corresponding to a tool's parameters.
      *
      * @return array{
      *     type: 'object',

src/Capability/Registry/Loader/ArrayLoader.php

@@ -17,6 +17,7 @@
 use Mcp\Capability\Completion\ProviderInterface;
 use Mcp\Capability\Discovery\DocBlockParser;
 use Mcp\Capability\Discovery\HandlerResolver;
+use Mcp\Capability\Discovery\SchemaGenerator;
 use Mcp\Capability\Discovery\SchemaGeneratorInterface;
 use Mcp\Capability\Registry\ElementReference;
 use Mcp\Capability\RegistryInterface;

src/Capability/Registry/Loader/DiscoveryLoader.php

@@ -15,6 +15,7 @@
 use Mcp\Capability\RegistryInterface;
 
 /**
+ * @internal
  * @author Antoine Bluchet <soyuka@gmail.com>
  */
 final class DiscoveryLoader implements LoaderInterface