AX-Copilot-Codex/src/AxCopilot/Handlers/QuickLinkHandler.cs

using AxCopilot.SDK;
using AxCopilot.Services;
using AxCopilot.Themes;

namespace AxCopilot.Handlers;

/// <summary>
/// Phase L3-4: 파라미터 퀵링크 핸들러. "ql" 예약어로 사용합니다.
/// 예: ql maps 강남역      → "maps" 키워드 URL에 "강남역" 치환 후 열기
///     ql jira PROJ-1234   → "jira" 키워드 URL에 티켓 번호 치환
///     ql (목록)            → 등록된 퀵링크 목록 표시
///
/// 퀵링크는 설정 → 일반 → 퀵링크 탭에서 등록합니다.
/// </summary>
public class QuickLinkHandler : IActionHandler
{
    private readonly SettingsService _settings;

    public string? Prefix => "ql";

    public PluginMetadata Metadata => new(
        "QuickLink",
        "파라미터 퀵링크 — ql [키워드] [인자]",
        "1.0",
        "AX");

    public QuickLinkHandler(SettingsService settings) => _settings = settings;

    public Task<IEnumerable<LauncherItem>> GetItemsAsync(string query, CancellationToken ct)
    {
        var links = _settings.Settings.QuickLinks;

        // 등록된 퀵링크 없음
        if (links.Count == 0)
        {
            return Task.FromResult<IEnumerable<LauncherItem>>(
            [
                new LauncherItem(
                    "등록된 퀵링크 없음",
                    "설정 → 일반 → 퀵링크에서 추가하세요. 예: keyword=maps, url=https://map.naver.com/p/search/{0}",
                    null, null, Symbol: Symbols.Globe)
            ]);
        }

        var items = new List<LauncherItem>();
        var parts = query.Trim().Split(' ', 2, StringSplitOptions.RemoveEmptyEntries);

        if (parts.Length == 0)
        {
            // 쿼리 없음 — 전체 목록 표시
            foreach (var link in links)
            {
                items.Add(new LauncherItem(
                    link.Name.Length > 0 ? link.Name : link.Keyword,
                    $"ql {link.Keyword} [인자]  ·  {link.Description}  ·  {link.UrlTemplate}",
                    null, null, Symbol: Symbols.Globe));
            }
            return Task.FromResult<IEnumerable<LauncherItem>>(items);
        }

        var keyword  = parts[0].ToLowerInvariant();
        var argQuery = parts.Length > 1 ? parts[1] : "";

        // 키워드로 정확 일치 검색
        var matched = links.Where(l => l.Keyword.ToLowerInvariant() == keyword).ToList();

        if (matched.Count > 0 && !string.IsNullOrWhiteSpace(argQuery))
        {
            // 인자가 있으면 URL 치환 후 실행 항목 생성
            foreach (var link in matched)
            {
                var url = UrlTemplateEngine.ExpandFromQuery(link.UrlTemplate, argQuery);
                items.Add(new LauncherItem(
                    $"{(link.Name.Length > 0 ? link.Name : link.Keyword)}: {argQuery}",
                    url,
                    null, url, Symbol: Symbols.Globe));
            }
        }
        else
        {
            // 키워드 퍼지 검색 (부분 일치)
            var fuzzy = links
                .Where(l => l.Keyword.Contains(keyword, StringComparison.OrdinalIgnoreCase) ||
                            l.Name.Contains(keyword, StringComparison.OrdinalIgnoreCase))
                .ToList();

            if (fuzzy.Count == 0)
            {
                items.Add(new LauncherItem(
                    $"'{keyword}'에 해당하는 퀵링크 없음",
                    "설정에서 새 퀵링크를 추가하세요",
                    null, null, Symbol: Symbols.Globe));
            }
            else
            {
                foreach (var link in fuzzy)
                {
                    var hint = UrlTemplateEngine.GetPlaceholders(link.UrlTemplate);
                    var ph   = hint.Count > 0 ? $"  ·  인자: {string.Join(", ", hint)}" : "";
                    items.Add(new LauncherItem(
                        $"ql {link.Keyword}{ph}",
                        link.Description.Length > 0 ? link.Description : link.UrlTemplate,
                        null, null, Symbol: Symbols.Globe));
                }
            }
        }

        return Task.FromResult<IEnumerable<LauncherItem>>(items);
    }

    public Task ExecuteAsync(LauncherItem item, CancellationToken ct)
    {
        if (item.Data is string url && !string.IsNullOrWhiteSpace(url))
        {
            try
            {
                System.Diagnostics.Process.Start(
                    new System.Diagnostics.ProcessStartInfo(url) { UseShellExecute = true });
            }
            catch (Exception ex)
            {
                LogService.Warn($"퀵링크 열기 실패: {ex.Message}");
            }
        }
        return Task.CompletedTask;
    }
}