103 lines
3.8 KiB
PHP
103 lines
3.8 KiB
PHP
<?php
|
|
|
|
namespace App\Mcp\Tools;
|
|
|
|
use App\Actions\Tickets\MoveProjectTicket;
|
|
use App\Mcp\Support\DescribesTicketWriting;
|
|
use App\Mcp\Support\KanbanGitMcp;
|
|
use Illuminate\Contracts\JsonSchema\JsonSchema;
|
|
use Illuminate\JsonSchema\Types\Type;
|
|
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('move_ticket_status')]
|
|
#[Description('Move a ticket to an allowed target status. Use ticket_status_id when possible; status_slug or status_name are convenience lookups and must resolve to one status in the ticket project.')]
|
|
#[IsDestructive(false)]
|
|
class MoveTicketStatus extends Tool
|
|
{
|
|
use DescribesTicketWriting;
|
|
|
|
public function __construct(
|
|
private readonly KanbanGitMcp $kanbanGitMcp,
|
|
private readonly MoveProjectTicket $moveProjectTicket,
|
|
) {}
|
|
|
|
public function handle(Request $request): Response|ResponseFactory
|
|
{
|
|
$validated = $request->validate([
|
|
'status_name' => ['nullable', 'string'],
|
|
'status_slug' => ['nullable', 'string'],
|
|
'ticket_id' => ['required', 'integer'],
|
|
'ticket_status_id' => ['nullable', 'integer'],
|
|
]);
|
|
|
|
$user = $this->kanbanGitMcp->user($request);
|
|
$ticket = $this->kanbanGitMcp->ticketForWrite($user, (int) $validated['ticket_id']);
|
|
$ticketStatuses = $this->kanbanGitMcp->resolveTicketStatuses($user, $validated, $ticket->project);
|
|
|
|
if ($ticketStatuses instanceof Response) {
|
|
return $ticketStatuses;
|
|
}
|
|
|
|
if ($ticketStatuses->isEmpty()) {
|
|
return Response::error('Ticket status was not found in this ticket project.');
|
|
}
|
|
|
|
$destinationStatus = $ticketStatuses->first();
|
|
|
|
if ($destinationStatus->project_id !== $ticket->project_id) {
|
|
return Response::error('Ticket status must belong to the same project as the ticket.');
|
|
}
|
|
|
|
$ticket->loadMissing('ticketStatus');
|
|
|
|
if (
|
|
$ticket->ticket_status_id !== $destinationStatus->id
|
|
&& ! ($ticket->ticketStatus?->allowedTargetStatuses()->whereKey($destinationStatus->id)->exists() ?? false)
|
|
) {
|
|
return Response::error('Choose a status this ticket is allowed to move to.');
|
|
}
|
|
|
|
$result = $this->moveProjectTicket->handle($ticket->project, $ticket, $user, [
|
|
'ticket_status_id' => $destinationStatus->id,
|
|
]);
|
|
|
|
return Response::structured([
|
|
'data' => $this->kanbanGitMcp->ticketPayload($ticket->fresh()),
|
|
'meta' => [
|
|
'destination_label' => $result['destination_label'],
|
|
'message' => $result['moved']
|
|
? "{$ticket->ticket_key} moved to {$result['destination_label']}."
|
|
: "{$ticket->ticket_key} already belongs to {$result['destination_label']}.",
|
|
'moved' => $result['moved'],
|
|
],
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* @return array<string, Type>
|
|
*/
|
|
public function schema(JsonSchema $schema): array
|
|
{
|
|
return [
|
|
'status_name' => $schema->string()
|
|
->nullable()
|
|
->description('Exact target status name. Must resolve to one status in the ticket project.'),
|
|
'status_slug' => $schema->string()
|
|
->nullable()
|
|
->description('Target status slug. Must resolve to one status in the ticket project.'),
|
|
'ticket_id' => $schema->integer()
|
|
->description('Ticket ID.')
|
|
->required(),
|
|
'ticket_status_id' => $schema->integer()
|
|
->nullable()
|
|
->description('Stable target status ID. Preferred when available.'),
|
|
];
|
|
}
|
|
}
|