<?php

namespace App\Mcp\Tools\Skill;

use App\Domain\Skill\Models\Skill;
use App\Domain\Skill\Models\SkillVersion;
use App\Mcp\Concerns\HasStructuredErrors;
use Illuminate\Contracts\JsonSchema\JsonSchema;
use Laravel\Mcp\Request;
use Laravel\Mcp\Response;
use Laravel\Mcp\Server\Tool;
use Laravel\Mcp\Server\Tools\Annotations\IsIdempotent;
use Laravel\Mcp\Server\Tools\Annotations\IsReadOnly;

/**
 * Returns the full version lineage and evolution history for a skill,
 * ordered chronologically with parent/child relationship data.
 */
#[IsReadOnly]
#[IsIdempotent]
class SkillLineageTool extends Tool
{
    use HasStructuredErrors;

    protected string $name = 'skill_lineage';

    protected string $description = 'Get the version lineage and evolution history for a skill.';

    public function schema(JsonSchema $schema): array
    {
        return [
            'skill_id' => $schema->string()
                ->description('The skill UUID')
                ->required(),
        ];
    }

    public function handle(Request $request): Response
    {
        $validated = $request->validate(['skill_id' => 'required|string']);

        $teamId = (app()->bound('mcp.team_id') ? app('mcp.team_id') : null) ?? auth()->user()?->current_team_id;
        if (! $teamId) {
            return $this->permissionDeniedError('No current team.');
        }
        $skill = Skill::withoutGlobalScopes()->where('team_id', $teamId)->find($validated['skill_id']);
        if (! $skill) {
            return $this->notFoundError('skill');
        }

        $versions = SkillVersion::query()
            ->where('skill_id', $skill->id)
            ->orderBy('created_at')
            ->get(['id', 'version', 'evolution_type', 'changelog', 'parent_version_id', 'created_at']);

        if ($versions->isEmpty()) {
            return Response::text(json_encode([
                'skill_id' => $skill->id,
                'total_versions' => 0,
                'versions' => [],
            ]));
        }

        return Response::text(json_encode([
            'skill_id' => $skill->id,
            'total_versions' => $versions->count(),
            'versions' => $versions->map(fn ($v) => [
                'id' => $v->id,
                'version' => $v->version,
                'evolution_type' => $v->evolution_type ?? 'manual',
                'changelog' => $v->changelog,
                'parent_version_id' => $v->parent_version_id,
                'created_at' => $v->created_at?->toIso8601String(),
            ])->values()->toArray(),
        ]));
    }
}
