Remove getSummary method and update tests and usages to use getDescription instead

Author: luoyue712

src/Capability/Discovery/DocBlockParser.php

@@ -55,19 +55,6 @@ public function parseDocBlock(string|false|null $docComment): ?DocBlock
         }
     }
 
-    /**
-     * Gets the summary line from a DocBlock.
-     */
-    public function getSummary(?DocBlock $docBlock): ?string
-    {
-        if (!$docBlock) {
-            return null;
-        }
-        $summary = trim($docBlock->getSummary());
-
-        return $summary ?: null; // Return null if empty after trimming
-    }
-
     /**
      * Gets the description from a DocBlock (summary + description body).
      */

src/Capability/Registry/Loader/ArrayLoader.php

@@ -105,7 +105,7 @@ public function load(RegistryInterface $registry): void
                     $docBlock = $docBlockParser->parseDocBlock($reflection->getDocComment() ?? null);
 
                     $name = $data['name'] ?? ('__invoke' === $methodName ? $classShortName : $methodName);
-                    $description = $data['description'] ?? $docBlockParser->getSummary($docBlock) ?? null;
+                    $description = $data['description'] ?? $docBlockParser->getDescription($docBlock) ?? null;
                 }
 
                 $inputSchema = $data['inputSchema'] ?? $schemaGenerator->generate($reflection);
@@ -145,7 +145,7 @@ public function load(RegistryInterface $registry): void
                     $docBlock = $docBlockParser->parseDocBlock($reflection->getDocComment() ?? null);
 
                     $name = $data['name'] ?? ('__invoke' === $methodName ? $classShortName : $methodName);
-                    $description = $data['description'] ?? $docBlockParser->getSummary($docBlock) ?? null;
+                    $description = $data['description'] ?? $docBlockParser->getDescription($docBlock) ?? null;
                 }
 
                 $resource = new Resource(
@@ -185,7 +185,7 @@ public function load(RegistryInterface $registry): void
                     $docBlock = $docBlockParser->parseDocBlock($reflection->getDocComment() ?? null);
 
                     $name = $data['name'] ?? ('__invoke' === $methodName ? $classShortName : $methodName);
-                    $description = $data['description'] ?? $docBlockParser->getSummary($docBlock) ?? null;
+                    $description = $data['description'] ?? $docBlockParser->getDescription($docBlock) ?? null;
                 }
 
                 $template = new ResourceTemplate(
@@ -224,7 +224,7 @@ public function load(RegistryInterface $registry): void
                     $docBlock = $docBlockParser->parseDocBlock($reflection->getDocComment() ?? null);
 
                     $name = $data['name'] ?? ('__invoke' === $methodName ? $classShortName : $methodName);
-                    $description = $data['description'] ?? $docBlockParser->getSummary($docBlock) ?? null;
+                    $description = $data['description'] ?? $docBlockParser->getDescription($docBlock) ?? null;
                 }
 
                 $arguments = [];

tests/Unit/Capability/Discovery/DocBlockParserTest.php

@@ -28,19 +28,6 @@ protected function setUp(): void
         $this->parser = new DocBlockParser();
     }
 
-    public function testGetSummaryReturnsCorrectSummary()
-    {
-        $method = new \ReflectionMethod(DocBlockTestFixture::class, 'methodWithSummaryOnly');
-        $docComment = $method->getDocComment() ?: null;
-        $docBlock = $this->parser->parseDocBlock($docComment);
-        $this->assertEquals('Simple summary line.', $this->parser->getSummary($docBlock));
-
-        $method2 = new \ReflectionMethod(DocBlockTestFixture::class, 'methodWithSummaryAndDescription');
-        $docComment2 = $method2->getDocComment() ?: null;
-        $docBlock2 = $this->parser->parseDocBlock($docComment2);
-        $this->assertEquals('Summary line here.', $this->parser->getSummary($docBlock2));
-    }
-
     public function testGetDescriptionReturnsCorrectDescription()
     {
         $method = new \ReflectionMethod(DocBlockTestFixture::class, 'methodWithSummaryAndDescription');
@@ -136,7 +123,6 @@ public function testHandlesMethodWithNoDocblockGracefully()
         $docBlock = $this->parser->parseDocBlock($docComment);
 
         $this->assertNull($docBlock);
-        $this->assertNull($this->parser->getSummary($docBlock));
         $this->assertNull($this->parser->getDescription($docBlock));
         $this->assertEmpty($this->parser->getParamTags($docBlock));
     }