Merge pull request #57 from trypostit/feat/ai-image-regenerate

feat: regenerate AI post images with brand palette

Author: paulocastellano

.cursor/rules/laravel-patterns.mdc

@@ -61,3 +61,9 @@ If you hit `Illuminate\Foundation\ViteException: Unable to locate file in Vite m
 ## Deployment
 
 Laravel can be deployed using [Laravel Cloud](https://cloud.laravel.com/) — the fastest path to production for Laravel apps.
+
+## AI agents (`app/Ai/Agents`)
+
+- Do not write prompts inside agent classes (no heredocs, no long strings in `instructions()`).
+- Store prompt copy in `resources/views/prompts/**/*.blade.php` and render with `view('prompts....', $vars)->render()`.
+- Follow `PostContentStreamer`, `PostContentReviewer`, or `BrandAnalyzer` for structure.

.cursor/rules/project-context.mdc

@@ -28,6 +28,8 @@ This project has domain-specific skills in `.claude/skills/` (e.g. `pest-testing
 ## Conventions
 
 - Follow existing code conventions. Check sibling files for structure, approach and naming before creating or editing.
+- In Vue `<DialogFooter>`, primary action button first in markup, then cancel/secondary (see `vue-typescript.mdc` and `CLAUDE.md`).
+- AI agents: prompts live in `resources/views/prompts/`; `instructions()` uses `view(...)->render()` only — never heredocs or inline prompt strings in `app/Ai/Agents/` (see `CLAUDE.md`).
 - Use descriptive names (`isRegisteredForDiscounts`, not `discount()`).
 - Reuse existing components before writing new ones.
 - Stick to existing directory structure. Do not create new base folders without approval.

.cursor/rules/vue-typescript.mdc

@@ -42,6 +42,21 @@ This project uses `@tabler/icons-vue` for all icons. NEVER use `lucide-vue-next`
 - Import routes from `@/routes/...` — e.g. `import { store } from '@/routes/login'`.
 - Import controller actions from `@/actions/...`.
 
+## Dialogs
+
+In `<DialogFooter>`, put the **primary action button first** in the markup, then secondary/cancel.
+
+`DialogFooter` (`resources/js/components/ui/dialog/DialogFooter.vue`) uses `flex-col-reverse` on mobile and `sm:flex-row sm:justify-start` on desktop — the first child is the leftmost action on larger screens.
+
+```vue
+<DialogFooter>
+    <Button @click="submit">{{ $t('...submit') }}</Button>
+    <Button variant="outline" @click="open = false">{{ $t('common.cancel') }}</Button>
+</DialogFooter>
+```
+
+Check sibling dialogs in the same feature before inventing a new footer layout.
+
 ## Form validation
 
 NEVER use HTML5 validation attributes (`required`, `minlength`, `pattern`, etc.) on form inputs. Always rely solely on backend validation.

CLAUDE.md

@@ -230,6 +230,17 @@ Vue components must have a single root element.
 
 - Always use arrow functions in Vue components and TypeScript files. Never use `function` declarations.
 
+## Dialogs
+
+- In `<DialogFooter>`, put the **primary action button first** in the markup, then secondary/cancel (e.g. Save → Cancel). `DialogFooter` uses `flex-col-reverse` on mobile and `sm:flex-row sm:justify-start` on desktop, so the first child is the leftmost action on larger screens.
+- Match sibling dialogs in the same feature area before inventing a new footer layout.
+
+## AI agents (`app/Ai/Agents`)
+
+- **Never** embed prompts in PHP (`<<<PROMPT`, heredocs, or long string literals in `instructions()`).
+- Put system/instruction text in Blade under `resources/views/prompts/` (e.g. `prompts.post_content.generator`, `prompts.post_image.regenerator`).
+- In `instructions()`, return `view('prompts....', [...])->render()` and pass only the variables the Blade file needs — same pattern as `PostContentStreamer`, `PostContentReviewer`, and `BrandAnalyzer`.
+
 ## Icons (@tabler/icons-vue)
 
 - This project uses `@tabler/icons-vue` for all icons. NEVER use `lucide-vue-next`.

app/Actions/Post/UpdatePost.php

@@ -9,6 +9,7 @@
 use App\Jobs\PublishPost;
 use App\Models\Post;
 use App\Models\Workspace;
+use App\Support\PostStatusRules;
 use Carbon\Carbon;
 use Illuminate\Support\Arr;
 use Illuminate\Support\Facades\DB;
@@ -20,9 +21,7 @@ class UpdatePost
      */
     public static function execute(Workspace $workspace, Post $post, array $data): array
     {
-        $terminalStatuses = [PostStatus::Published, PostStatus::PartiallyPublished, PostStatus::Failed, PostStatus::Publishing];
-
-        if (in_array($post->status, $terminalStatuses, true)) {
+        if (PostStatusRules::blocksEditing($post)) {
             return ['post' => $post, 'action' => PostAction::Finalized];
         }
 

app/Ai/Agents/PostImageRegenerator.php

@@ -0,0 +1,64 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Ai\Agents;
+
+use App\Models\Workspace;
+use Illuminate\Contracts\JsonSchema\JsonSchema;
+use Laravel\Ai\Attributes\Temperature;
+use Laravel\Ai\Contracts\Agent;
+use Laravel\Ai\Contracts\HasStructuredOutput;
+use Laravel\Ai\Enums\Lab;
+use Laravel\Ai\Promptable;
+
+#[Temperature(0.25)]
+class PostImageRegenerator implements Agent, HasStructuredOutput
+{
+    use Promptable;
+
+    public function __construct(
+        public Workspace $workspace,
+    ) {}
+
+    public function instructions(): string
+    {
+        return view('prompts.post_image.regenerator', [
+            'content_language' => $this->workspace->content_language ?: 'en',
+        ])->render();
+    }
+
+    public function schema(JsonSchema $schema): array
+    {
+        return [
+            'title' => $schema->string()
+                ->description('Updated short title for the image (max ~120 chars).')
+                ->required(),
+            'body' => $schema->string()
+                ->description('Updated supporting text for the image (max ~240 chars).')
+                ->required(),
+            'keywords' => $schema->array()
+                ->items($schema->string())
+                ->description('3-10 short keywords for image generation context.')
+                ->required(),
+            'change_mode' => $schema->string()
+                ->enum(['image_only', 'text_only', 'both'])
+                ->description('Set to image_only (change visual only), text_only (change text only), or both (change visual and text).')
+                ->required(),
+        ];
+    }
+
+    public function provider(): Lab
+    {
+        return match (config('ai.default')) {
+            'openai' => Lab::OpenAI,
+            'anthropic' => Lab::Anthropic,
+            default => Lab::Gemini,
+        };
+    }
+
+    public function model(): string
+    {
+        return config('ai.default_text_model');
+    }
+}

app/Broadcasting/UserAiMediaRegenerationChannel.php

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Broadcasting;
+
+use App\Models\User;
+
+class UserAiMediaRegenerationChannel
+{
+    public function join(User $user, User $owner, string $regenerationId): bool
+    {
+        return $user->is($owner);
+    }
+}

app/Events/Ai/PostMediaRegenerated.php

@@ -0,0 +1,55 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Events\Ai;
+
+use Illuminate\Broadcasting\InteractsWithSockets;
+use Illuminate\Broadcasting\PrivateChannel;
+use Illuminate\Contracts\Broadcasting\ShouldBroadcast;
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Queue\SerializesModels;
+
+class PostMediaRegenerated implements ShouldBroadcast
+{
+    use Dispatchable, InteractsWithSockets, SerializesModels;
+
+    /**
+     * @param  array<string, mixed>|null  $media
+     */
+    public function __construct(
+        public string $userId,
+        public string $regenerationId,
+        public string $postId,
+        public ?array $media = null,
+        public ?string $error = null,
+    ) {}
+
+    public function broadcastAs(): string
+    {
+        return 'ai.media.regenerated';
+    }
+
+    public function broadcastOn(): PrivateChannel
+    {
+        return new PrivateChannel("user.{$this->userId}.ai-media.{$this->regenerationId}");
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function broadcastWith(): array
+    {
+        return [
+            'regeneration_id' => $this->regenerationId,
+            'post_id' => $this->postId,
+            'media' => $this->media,
+            'error' => $this->error,
+        ];
+    }
+
+    public function broadcastQueue(): string
+    {
+        return 'broadcasts';
+    }
+}

app/Http/Controllers/Api/PostController.php

@@ -19,6 +19,7 @@
 use App\Http\Resources\Api\PostResource;
 use App\Models\Post;
 use App\Services\Post\MediaAttacher;
+use App\Support\PostStatusRules;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
 use Illuminate\Http\Resources\Json\AnonymousResourceCollection;
@@ -69,7 +70,7 @@ public function update(UpdatePostRequest $request, Post $post): PostResource|Jso
 
         if (data_get($result, 'action') === PostAction::Finalized) {
             return response()->json(
-                ['message' => 'Cannot edit a post in a terminal state.'],
+                ['message' => PostStatusRules::editBlockedMessage()],
                 Response::HTTP_UNPROCESSABLE_ENTITY
             );
         }

app/Http/Controllers/App/PostAiGenerateController.php

@@ -18,9 +18,7 @@ public function generate(GeneratePostContentRequest $request, Post $post): JsonR
     {
         $workspace = $request->user()->currentWorkspace;
 
-        if ($post->workspace_id !== $workspace->id) {
-            abort(Response::HTTP_FORBIDDEN);
-        }
+        $this->authorize('update', $post);
 
         $gate = Gate::inspect('useAi', $workspace->account);
         if ($gate->denied()) {