✨ Add ResolvesEntities concern for name-based ID resolution

- 🤖 Introduced `ResolvesEntities` trait to simplify entity resolution by name or ID across MCP tools.
- 📚 Updated tools (Meetups, Cities, Venues, Courses, Lecturers) to use the concern for resolving related entities (e.g., courses, venues, lecturers).
- 🎯 Enhanced tool descriptions and schemas for better name-based parameter handling with fallback support for IDs.
- ✅ Added dedicated feature tests for name resolution logic, partial matches, and error handling scenarios.

app/Mcp/Tools/MeetupEvent/UpdateMeetupEventTool.php

@@ -4,6 +4,8 @@ namespace App\Mcp\Tools\MeetupEvent;
 
 use App\Http\Requests\Api\UpdateMeetupEventRequest;
 use App\Http\Resources\MeetupEventResource;
+use App\Mcp\Tools\Concerns\ResolvesEntities;
+use App\Models\Meetup;
 use App\Models\MeetupEvent;
 use Illuminate\Contracts\JsonSchema\JsonSchema;
 use Illuminate\JsonSchema\Types\Type;
@@ -16,6 +18,8 @@ use Laravel\Mcp\Server\Tool;
 #[Description('Aktualisiert einen bestehenden Meetup-Termin. Nur der Ersteller oder ein Super-Admin darf ihn ändern.')]
 class UpdateMeetupEventTool extends Tool
 {
+    use ResolvesEntities;
+
     public function handle(Request $request): Response
     {
         $meetupEvent = MeetupEvent::find($request->get('id'));
@@ -30,6 +34,10 @@ class UpdateMeetupEventTool extends Tool
             return Response::error('Nur der Ersteller oder ein Super-Admin darf diesen Meetup-Termin ändern.');
         }
 
+        if ($error = $this->mergeForeignKey($request, 'meetup', 'meetup_id', Meetup::query()->where('created_by', $user->getAuthIdentifier()), 'Meetups', false)) {
+            return $error;
+        }
+
         $validated = $request->validate((new UpdateMeetupEventRequest)->rules());
 
         $meetupEvent->update($validated);
@@ -43,8 +51,9 @@ class UpdateMeetupEventTool extends Tool
     public function schema(JsonSchema $schema): array
     {
         return [
-            'id' => $schema->integer()->description('ID des zu aktualisierenden Meetup-Termins.')->required(),
-            'meetup_id' => $schema->integer()->description('ID des zugehörigen Meetups.'),
+            'id' => $schema->integer()->description('ID des zu aktualisierenden Meetup-Termins (über list-my-meetup-events ermitteln; nicht den Nutzer danach fragen).')->required(),
+            'meetup' => $schema->string()->description('Name des zugehörigen Meetups, falls geändert werden soll (wird automatisch aufgelöst).'),
+            'meetup_id' => $schema->integer()->description('Optional: ID des Meetups (Alternative zu "meetup").'),
             'start' => $schema->string()->description('Startzeitpunkt als Datum/Uhrzeit (z. B. 2026-08-01 18:00:00).'),
             'location' => $schema->string()->description('Veranstaltungsort.'),
             'description' => $schema->string()->description('Beschreibung des Termins.'),