Feature/issue 71 crud for prompt suggestions

src/ChatBasedContentEditor/Presentation/Controller/PromptSuggestionsController.php

@@ -0,0 +1,192 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\ChatBasedContentEditor\Presentation\Controller;
+
+use App\Account\Facade\AccountFacadeInterface;
+use App\ChatBasedContentEditor\Domain\Entity\Conversation;
+use App\ChatBasedContentEditor\Domain\Enum\ConversationStatus;
+use App\ChatBasedContentEditor\Presentation\Dto\EditableWorkspaceContextDto;
+use App\ChatBasedContentEditor\Presentation\Service\PromptSuggestionsService;
+use App\WorkspaceMgmt\Facade\WorkspaceMgmtFacadeInterface;
+use Doctrine\ORM\EntityManagerInterface;
+use InvalidArgumentException;
+use OutOfRangeException;
+use RuntimeException;
+use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+use Symfony\Component\HttpFoundation\JsonResponse;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\Routing\Attribute\Route;
+use Symfony\Component\Security\Core\User\UserInterface;
+use Symfony\Component\Security\Http\Attribute\CurrentUser;
+use Symfony\Component\Security\Http\Attribute\IsGranted;
+use Throwable;
+
+/**
+ * JSON API controller for CRUD operations on prompt suggestions.
+ */
+#[IsGranted('ROLE_USER')]
+final class PromptSuggestionsController extends AbstractController
+{
+    public function __construct(
+        private readonly EntityManagerInterface       $entityManager,
+        private readonly AccountFacadeInterface       $accountFacade,
+        private readonly WorkspaceMgmtFacadeInterface $workspaceMgmtFacade,
+        private readonly PromptSuggestionsService     $promptSuggestionsService,
+    ) {
+    }
+
+    #[Route(
+        path: '/conversation/{conversationId}/prompt-suggestions',
+        name: 'chat_based_content_editor.presentation.prompt_suggestions.create',
+        methods: [Request::METHOD_POST],
+        requirements: ['conversationId' => '[a-f0-9-]{36}']
+    )]
+    public function create(
+        string        $conversationId,
+        Request       $request,
+        #[CurrentUser] UserInterface $user,
+    ): JsonResponse {
+        $context = $this->resolveEditableWorkspace($conversationId, $request, $user);
+
+        $text = $this->promptSuggestionsService->getRequestText($request);
+        if ($text === null) {
+            return $this->json(['error' => 'Missing or empty "text" field.'], Response::HTTP_BAD_REQUEST);
+        }
+
+        try {
+            $suggestions = $this->promptSuggestionsService->addSuggestion($context->workspacePath, $text);
+            $this->workspaceMgmtFacade->commitAndPush(
+                $context->workspaceId,
+                'Add prompt suggestion',
+                $context->authorEmail,
+                $conversationId,
+            );
+        } catch (InvalidArgumentException $e) {
+            return $this->json(['error' => $e->getMessage()], Response::HTTP_BAD_REQUEST);
+        } catch (Throwable $e) {
+            return $this->json(['error' => 'Failed to save changes: ' . $e->getMessage()], Response::HTTP_INTERNAL_SERVER_ERROR);
+        }
+
+        return $this->json(['suggestions' => $suggestions]);
+    }
+
+    #[Route(
+        path: '/conversation/{conversationId}/prompt-suggestions/{index}',
+        name: 'chat_based_content_editor.presentation.prompt_suggestions.update',
+        methods: [Request::METHOD_PUT],
+        requirements: ['conversationId' => '[a-f0-9-]{36}', 'index' => '\d+']
+    )]
+    public function update(
+        string        $conversationId,
+        int           $index,
+        Request       $request,
+        #[CurrentUser] UserInterface $user,
+    ): JsonResponse {
+        $context = $this->resolveEditableWorkspace($conversationId, $request, $user);
+
+        $text = $this->promptSuggestionsService->getRequestText($request);
+        if ($text === null) {
+            return $this->json(['error' => 'Missing or empty "text" field.'], Response::HTTP_BAD_REQUEST);
+        }
+
+        try {
+            $suggestions = $this->promptSuggestionsService->updateSuggestion($context->workspacePath, $index, $text);
+
+            $this->workspaceMgmtFacade->commitAndPush(
+                $context->workspaceId,
+                'Update prompt suggestion',
+                $context->authorEmail,
+                $conversationId,
+            );
+        } catch (InvalidArgumentException $e) {
+            return $this->json(['error' => $e->getMessage()], Response::HTTP_BAD_REQUEST);
+        } catch (OutOfRangeException $e) {
+            return $this->json(['error' => $e->getMessage()], Response::HTTP_NOT_FOUND);
+        } catch (Throwable $e) {
+            return $this->json(['error' => 'Failed to save changes: ' . $e->getMessage()], Response::HTTP_INTERNAL_SERVER_ERROR);
+        }
+
+        return $this->json(['suggestions' => $suggestions]);
+    }
+
+    #[Route(
+        path: '/conversation/{conversationId}/prompt-suggestions/{index}',
+        name: 'chat_based_content_editor.presentation.prompt_suggestions.delete',
+        methods: [Request::METHOD_DELETE],
+        requirements: ['conversationId' => '[a-f0-9-]{36}', 'index' => '\d+']
+    )]
+    public function delete(
+        string        $conversationId,
+        int           $index,
+        Request       $request,
+        #[CurrentUser] UserInterface $user,
+    ): JsonResponse {
+        $context = $this->resolveEditableWorkspace($conversationId, $request, $user);
+
+        try {
+            $suggestions = $this->promptSuggestionsService->deleteSuggestion($context->workspacePath, $index);
+
+            $this->workspaceMgmtFacade->commitAndPush(
+                $context->workspaceId,
+                'Remove prompt suggestion',
+                $context->authorEmail,
+                $conversationId,
+            );
+        } catch (OutOfRangeException $e) {
+            return $this->json(['error' => $e->getMessage()], Response::HTTP_NOT_FOUND);
+        } catch (Throwable $e) {
+            return $this->json(['error' => 'Failed to save changes: ' . $e->getMessage()], Response::HTTP_INTERNAL_SERVER_ERROR);
+        }
+
+        return $this->json(['suggestions' => $suggestions]);
+    }
+
+    /**
+     * Resolve conversation → workspace and enforce authorization + CSRF.
+     * Returns a context DTO with workspace path, workspace ID, and author email.
+     *
+     * @throws \Symfony\Component\HttpKernel\Exception\NotFoundHttpException
+     * @throws \Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException
+     */
+    private function resolveEditableWorkspace(
+        string        $conversationId,
+        Request       $request,
+        UserInterface $user,
+    ): EditableWorkspaceContextDto {
+        if (!$this->isCsrfTokenValid('prompt-suggestions', $request->headers->get('X-CSRF-Token', ''))) {
+            throw $this->createAccessDeniedException('Invalid CSRF token.');
+        }
+
+        $conversation = $this->entityManager->find(Conversation::class, $conversationId);
+        if ($conversation === null) {
+            throw $this->createNotFoundException('Conversation not found.');
+        }
+
+        $accountInfo = $this->accountFacade->getAccountInfoByEmail($user->getUserIdentifier());
+        if ($accountInfo === null) {
+            throw new RuntimeException('Account not found for authenticated user');
+        }
+
+        if ($conversation->getUserId() !== $accountInfo->id) {
+            throw $this->createAccessDeniedException('Only the conversation owner can manage prompt suggestions.');
+        }
+
+        if ($conversation->getStatus() !== ConversationStatus::ONGOING) {
+            throw $this->createAccessDeniedException('Cannot modify prompt suggestions for a finished conversation.');
+        }
+
+        $workspace = $this->workspaceMgmtFacade->getWorkspaceById($conversation->getWorkspaceId());
+        if ($workspace === null) {
+            throw $this->createNotFoundException('Workspace not found.');
+        }
+
+        return new EditableWorkspaceContextDto(
+            $workspace->workspacePath,
+            $workspace->id,
+            $accountInfo->email,
+        );
+    }
+}

src/ChatBasedContentEditor/Presentation/Dto/EditableWorkspaceContextDto.php

@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\ChatBasedContentEditor\Presentation\Dto;
+
+/**
+ * Internal context resolved when accessing an editable workspace for prompt suggestions.
+ * Groups the workspace path, workspace ID, and author email needed for file operations and git commits.
+ */
+readonly class EditableWorkspaceContextDto
+{
+    public function __construct(
+        public string $workspacePath,
+        public string $workspaceId,
+        public string $authorEmail,
+    ) {
+    }
+}