Return full path and sort structures by full pathes in list tools

src/Entity/Parts/Category.php

@@ -87,7 +87,7 @@ use Symfony\Component\Validator\Constraints as Assert;
     mcp: [
         'list_categories' => new McpToolCollection(
             title: 'List/search categories',
-            description: 'List all part categories, optionally filtered by a keyword matched against the name and comment. Categories are used to group parts by their function.',
+            description: 'List all part categories, optionally filtered by a keyword matched against the name and comment. Categories are used to group parts by their function. Each entry includes its full hierarchical path, and results are sorted by that path so parents are immediately followed by their own children, making it easy to derive the tree structure from the flat list.',
             annotations: ['readOnlyHint' => true, 'destructiveHint' => false, 'idempotentHint' => true, 'openWorldHint' => false],
             output: StructuralElementOverview::class,
             normalizationContext: ['groups' => ['mcp_structural_overview:read']],

src/Entity/Parts/Footprint.php

@@ -86,7 +86,7 @@ use Symfony\Component\Validator\Constraints as Assert;
     mcp: [
         'list_footprints' => new McpToolCollection(
             title: 'List/search footprints',
-            description: 'List all footprints, optionally filtered by a keyword matched against the name and comment. Footprints describe the physical package/shape of a part.',
+            description: 'List all footprints, optionally filtered by a keyword matched against the name and comment. Footprints describe the physical package/shape of a part. Each entry includes its full hierarchical path, and results are sorted by that path so parents are immediately followed by their own children, making it easy to derive the tree structure from the flat list.',
             annotations: ['readOnlyHint' => true, 'destructiveHint' => false, 'idempotentHint' => true, 'openWorldHint' => false],
             output: StructuralElementOverview::class,
             normalizationContext: ['groups' => ['mcp_structural_overview:read']],

src/Entity/Parts/Manufacturer.php

@@ -85,7 +85,7 @@ use Symfony\Component\Validator\Constraints as Assert;
     mcp: [
         'list_manufacturers' => new McpToolCollection(
             title: 'List/search manufacturers',
-            description: 'List all manufacturers, optionally filtered by a keyword matched against the name and comment.',
+            description: 'List all manufacturers, optionally filtered by a keyword matched against the name and comment. Each entry includes its full hierarchical path, and results are sorted by that path so parents are immediately followed by their own children, making it easy to derive the tree structure from the flat list.',
             annotations: ['readOnlyHint' => true, 'destructiveHint' => false, 'idempotentHint' => true, 'openWorldHint' => false],
             output: StructuralElementOverview::class,
             normalizationContext: ['groups' => ['mcp_structural_overview:read']],

src/Entity/Parts/MeasurementUnit.php

@@ -90,7 +90,7 @@ use Symfony\Component\Validator\Constraints\Length;
     mcp: [
         'list_measurement_units' => new McpToolCollection(
             title: 'List/search measurement units',
-            description: 'List all measurement units, optionally filtered by a keyword matched against the name and comment. Measurement units describe how the amount of a part is measured (e.g. pieces, meters, grams).',
+            description: 'List all measurement units, optionally filtered by a keyword matched against the name and comment. Measurement units describe how the amount of a part is measured (e.g. pieces, meters, grams). Each entry includes its full hierarchical path, and results are sorted by that path so parents are immediately followed by their own children, making it easy to derive the tree structure from the flat list.',
             annotations: ['readOnlyHint' => true, 'destructiveHint' => false, 'idempotentHint' => true, 'openWorldHint' => false],
             output: StructuralElementOverview::class,
             normalizationContext: ['groups' => ['mcp_structural_overview:read']],

src/Entity/Parts/PartCustomState.php

@@ -77,7 +77,7 @@ use Symfony\Component\Validator\Constraints as Assert;
     mcp: [
         'list_part_custom_states' => new McpToolCollection(
             title: 'List/search part custom states',
-            description: 'List all part custom states, optionally filtered by a keyword matched against the name and comment. Custom states are used to mark parts with a custom status (e.g. "obsolete", "needs review").',
+            description: 'List all part custom states, optionally filtered by a keyword matched against the name and comment. Custom states are used to mark parts with a custom status (e.g. "obsolete", "needs review"). Each entry includes its full hierarchical path, and results are sorted by that path so parents are immediately followed by their own children, making it easy to derive the tree structure from the flat list.',
             annotations: ['readOnlyHint' => true, 'destructiveHint' => false, 'idempotentHint' => true, 'openWorldHint' => false],
             output: StructuralElementOverview::class,
             normalizationContext: ['groups' => ['mcp_structural_overview:read']],

src/Entity/Parts/StorageLocation.php

@@ -86,7 +86,7 @@ use Symfony\Component\Validator\Constraints as Assert;
     mcp: [
         'list_storage_locations' => new McpToolCollection(
             title: 'List/search storage locations',
-            description: 'List all storage locations, optionally filtered by a keyword matched against the name and comment. Storage locations describe where parts are physically stored.',
+            description: 'List all storage locations, optionally filtered by a keyword matched against the name and comment. Storage locations describe where parts are physically stored. Each entry includes its full hierarchical path, and results are sorted by that path so parents are immediately followed by their own children, making it easy to derive the tree structure from the flat list.',
             annotations: ['readOnlyHint' => true, 'destructiveHint' => false, 'idempotentHint' => true, 'openWorldHint' => false],
             output: StructuralElementOverview::class,
             normalizationContext: ['groups' => ['mcp_structural_overview:read']],

src/Entity/Parts/Supplier.php

@@ -90,7 +90,7 @@ use Symfony\Component\Validator\Constraints as Assert;
     mcp: [
         'list_suppliers' => new McpToolCollection(
             title: 'List/search suppliers',
-            description: 'List all suppliers, optionally filtered by a keyword matched against the name and comment.',
+            description: 'List all suppliers, optionally filtered by a keyword matched against the name and comment. Each entry includes its full hierarchical path, and results are sorted by that path so parents are immediately followed by their own children, making it easy to derive the tree structure from the flat list.',
             annotations: ['readOnlyHint' => true, 'destructiveHint' => false, 'idempotentHint' => true, 'openWorldHint' => false],
             output: StructuralElementOverview::class,
             normalizationContext: ['groups' => ['mcp_structural_overview:read']],