update ai theme descrition

Author: claudemyburgh

.agents/skills/inertia-react-development/SKILL.md

@@ -9,7 +9,7 @@ The Laravel Boost guidelines are specifically curated by Laravel maintainers for
 
 This application is a Laravel application and its main Laravel ecosystems package & versions are below. You are an expert with them all. Ensure you abide by these specific packages & versions.
 
-- php - 8.3
+- php - 8.4
 - inertiajs/inertia-laravel (INERTIA_LARAVEL) - v3
 - laravel/fortify (FORTIFY) - v1
 - laravel/framework (LARAVEL) - v13
@@ -118,6 +118,13 @@ This project has domain-specific skills available in `**/skills/**`. You MUST ac
 
 - Laravel can be deployed using [Laravel Cloud](https://cloud.laravel.com/), which is the fastest way to deploy and scale production Laravel applications.
 
+=== herd rules ===
+
+# Laravel Herd
+
+- The application is served by Laravel Herd at `https?://[kebab-case-project-dir].test`. Use the `get-absolute-url` tool to generate valid URLs. Never run commands to serve the site. It is always available.
+- Use the `herd` CLI to manage services, PHP versions, and sites (e.g. `herd sites`, `herd services:start <service>`, `herd php:list`). Run `herd list` to discover all available commands.
+
 === tests rules ===
 
 # Test Enforcement

.claude/skills/inertia-react-development/SKILL.md

@@ -9,7 +9,7 @@ The Laravel Boost guidelines are specifically curated by Laravel maintainers for
 
 This application is a Laravel application and its main Laravel ecosystems package & versions are below. You are an expert with them all. Ensure you abide by these specific packages & versions.
 
-- php - 8.3
+- php - 8.4
 - inertiajs/inertia-laravel (INERTIA_LARAVEL) - v3
 - laravel/fortify (FORTIFY) - v1
 - laravel/framework (LARAVEL) - v13
@@ -118,6 +118,13 @@ This project has domain-specific skills available in `**/skills/**`. You MUST ac
 
 - Laravel can be deployed using [Laravel Cloud](https://cloud.laravel.com/), which is the fastest way to deploy and scale production Laravel applications.
 
+=== herd rules ===
+
+# Laravel Herd
+
+- The application is served by Laravel Herd at `https?://[kebab-case-project-dir].test`. Use the `get-absolute-url` tool to generate valid URLs. Never run commands to serve the site. It is always available.
+- Use the `herd` CLI to manage services, PHP versions, and sites (e.g. `herd sites`, `herd services:start <service>`, `herd php:list`). Run `herd list` to discover all available commands.
+
 === tests rules ===
 
 # Test Enforcement

AGENTS.md

@@ -9,7 +9,7 @@ The Laravel Boost guidelines are specifically curated by Laravel maintainers for
 
 This application is a Laravel application and its main Laravel ecosystems package & versions are below. You are an expert with them all. Ensure you abide by these specific packages & versions.
 
-- php - 8.3
+- php - 8.4
 - inertiajs/inertia-laravel (INERTIA_LARAVEL) - v3
 - laravel/fortify (FORTIFY) - v1
 - laravel/framework (LARAVEL) - v13
@@ -118,6 +118,13 @@ This project has domain-specific skills available in `**/skills/**`. You MUST ac
 
 - Laravel can be deployed using [Laravel Cloud](https://cloud.laravel.com/), which is the fastest way to deploy and scale production Laravel applications.
 
+=== herd rules ===
+
+# Laravel Herd
+
+- The application is served by Laravel Herd at `https?://[kebab-case-project-dir].test`. Use the `get-absolute-url` tool to generate valid URLs. Never run commands to serve the site. It is always available.
+- Use the `herd` CLI to manage services, PHP versions, and sites (e.g. `herd sites`, `herd services:start <service>`, `herd php:list`). Run `herd list` to discover all available commands.
+
 === tests rules ===
 
 # Test Enforcement

CLAUDE.md

@@ -5,6 +5,7 @@
 use App\Models\Theme;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Http;
 use Illuminate\Support\Str;
 use Inertia\Inertia;
@@ -137,7 +138,7 @@ public function index()
         $availableTags = Cache::remember('themes:available_tags', 3600, function () {
             return Tag::query()
                 ->whereExists(function ($query) {
-                    $query->select(\Illuminate\Support\Facades\DB::raw(1))
+                    $query->select(DB::raw(1))
                         ->from('taggables')
                         ->whereColumn('taggables.tag_id', 'tags.id')
                         ->where('taggables.taggable_type', Theme::class);

GEMINI.md

@@ -0,0 +1,41 @@
+<?php
+
+namespace App\Jobs;
+
+use App\Models\Theme;
+use App\Services\AiService;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Foundation\Queue\Queueable;
+
+class GenerateThemeMetadataJob implements ShouldQueue
+{
+    use Queueable;
+
+    public function __construct(
+        public Theme $theme,
+    ) {}
+
+    public function handle(AiService $ai): void
+    {
+        $theme = $this->theme->fresh();
+
+        if (! $theme) {
+            return;
+        }
+
+        try {
+            $metadata = $ai->generateThemeMetadata(
+                $theme->name,
+                $theme->vars_light ?? [],
+            );
+        } catch (\Throwable) {
+            return;
+        }
+
+        $theme->updateQuietly(['description' => $metadata['description']]);
+
+        if (! empty($metadata['tags'])) {
+            $theme->attachTags($metadata['tags']);
+        }
+    }
+}

app/Http/Controllers/ThemesController.php

@@ -2,39 +2,21 @@
 
 namespace App\Observers;
 
+use App\Jobs\GenerateThemeMetadataJob;
 use App\Models\Theme;
-use App\Services\AiService;
 use Illuminate\Support\Str;
 
 class ThemeObserver
 {
-    /**
-     * @var array<string>
-     */
-    protected static array $suggestedTagsMap = [];
-
     public function creating(Theme $theme): void
     {
         if (! $theme->title) {
             $theme->title = Str::headline($theme->name);
         }
-
-        if (! $theme->description) {
-            $ai = app(AiService::class);
-            $metadata = $ai->generateThemeMetadata(
-                $theme->name,
-                $theme->vars_light ?? []
-            );
-            $theme->description = $metadata['description'];
-            static::$suggestedTagsMap[$theme->name] = $metadata['tags'];
-        }
     }
 
     public function created(Theme $theme): void
     {
-        if (isset(static::$suggestedTagsMap[$theme->name])) {
-            $theme->attachTags(static::$suggestedTagsMap[$theme->name]);
-            unset(static::$suggestedTagsMap[$theme->name]);
-        }
+        GenerateThemeMetadataJob::dispatch($theme);
     }
 }

app/Jobs/GenerateThemeMetadataJob.php

@@ -23,14 +23,14 @@ public function generateThemeMetadata(string $name, array $colors): array
 
         $prompt = "Generate metadata for a UI theme named \"{$name}\" that uses these colors: {$colorList}.
         Return the result in JSON format with two keys:
-        1. \"description\": a short, engaging description (max 2 sentences) highlighting the mood or style.
+        1. \"description\": a short, engaging description (max 2 sentences) highlighting the mood or style. The description must not start with a colon.
         2. \"tags\": an array of 2 to 6 relevant style tags (e.g., \"warm\", \"cold\", \"retro\", \"vintage\", \"punk\", \"nature\", \"tech\", \"bold\", \"minimal\", \"elegant\").";
 
         $response = Http::withHeaders([
             'Authorization' => 'Bearer '.$apiKey,
             'HTTP-Referer' => config('app.url'),
             'X-Title' => config('app.name'),
-        ])->post('https://openrouter.ai/api/v1/chat/completions', [
+        ])->timeout(15)->post('https://openrouter.ai/api/v1/chat/completions', [
             'model' => config('services.openrouter.model'),
             'messages' => [
                 [
@@ -49,8 +49,14 @@ public function generateThemeMetadata(string $name, array $colors): array
         $content = $data['choices'][0]['message']['content'] ?? '{}';
         $decoded = json_decode($content, true);
 
+        $description = $decoded['description'] ?? null;
+
+        if ($description) {
+            $description = ltrim($description, ': ');
+        }
+
         return [
-            'description' => $decoded['description'] ?? null,
+            'description' => $description,
             'tags' => $decoded['tags'] ?? [],
         ];
     }

app/Observers/ThemeObserver.php

@@ -15,6 +15,7 @@
         "socialite-development",
         "wayfinder-development",
         "pest-testing",
+        "inertia-react-development",
         "tailwindcss-development"
     ]
 }