<?php

namespace App\Mcp\Tools;

use App\Actions\Tickets\Support\TicketDescriptionFormat;
use App\Actions\Tickets\UpdateProjectTicket;
use App\Mcp\Support\DescribesTicketWriting;
use App\Mcp\Support\KanbanGitMcp;
use App\Rules\VisualTicketDescription;
use Illuminate\Contracts\JsonSchema\JsonSchema;
use Illuminate\JsonSchema\Types\Type;
use Illuminate\Support\Arr;
use Laravel\Mcp\Request;
use Laravel\Mcp\Response;
use Laravel\Mcp\ResponseFactory;
use Laravel\Mcp\Server\Attributes\Description;
use Laravel\Mcp\Server\Attributes\Name;
use Laravel\Mcp\Server\Tool;
use Laravel\Mcp\Server\Tools\Annotations\IsDestructive;

#[Name('update_ticket_description')]
#[Description('Update only a ticket description while preserving all other ticket fields. Requires project write permission.')]
#[IsDestructive(false)]
class UpdateTicketDescription extends Tool
{
    use DescribesTicketWriting;

    public function __construct(
        private readonly KanbanGitMcp $kanbanGitMcp,
        private readonly UpdateProjectTicket $updateProjectTicket,
    ) {}

    public function handle(Request $request): Response|ResponseFactory
    {
        $validated = $request->validate([
            'description' => ['nullable', 'string', new VisualTicketDescription],
            'ticket_id' => ['required', 'integer'],
        ]);

        $user = $this->kanbanGitMcp->user($request);
        $ticket = $this->kanbanGitMcp->ticketForWrite($user, (int) $validated['ticket_id']);
        $payload = [
            ...$this->kanbanGitMcp->updatePayload($ticket),
            ...(Arr::exists($validated, 'description') ? ['description' => Arr::get($validated, 'description')] : []),
        ];

        $wasUpdated = $this->updateProjectTicket->handle($ticket, $user, $payload);

        return Response::structured([
            'data' => $this->kanbanGitMcp->ticketPayload($ticket->fresh()),
            'meta' => [
                'message' => $wasUpdated
                    ? "{$ticket->ticket_key} description was updated."
                    : 'No ticket changes were detected.',
            ],
        ]);
    }

    /**
     * @return array<string, Type>
     */
    public function schema(JsonSchema $schema): array
    {
        return [
            'description' => $schema->string()
                ->nullable()
                ->description('New ticket description. Omit to preserve; pass null to clear it. '.TicketDescriptionFormat::instructions()),
            'ticket_id' => $schema->integer()
                ->description('Ticket ID.')
                ->required(),
        ];
    }
}