// Copyright (C) 2025 David M. Cotter
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only WITH Qt-GPL-exception-1.0
#pragma once

#include "projectexplorer_export.h"

#include <QJsonObject>
#include <QObject>
#include <QString>
#include <QStringList>

// Include for MOC compilation
#include "task.h"

#include <mcp/server/mcpserver.h>

namespace ProjectExplorer {

/**
 * @brief Manages access to Qt Creator's Issues panel
 *]
 * This class provides a clean interface for accessing and retrieving
 * issues from Qt Creator's Issues panel. It encapsulates the complexity
 * of accessing internal Qt Creator APIs and provides a simple interface
 * for the MCP plugin.
 */
class PROJECTEXPLORER_EXPORT IssuesManager : public QObject
{
    Q_OBJECT

public:
    explicit IssuesManager(QObject *parent = nullptr);
    ~IssuesManager() override = default;

    /**
     * @brief Retrieves all current issues from the Issues panel
     * @return JSON object conforming to s_issueSchema
     */
    QJsonObject getCurrentIssues() const;

    /**
     * @brief Retrieves current issues filtered by file path
     * @param path File path to filter issues by
     * @return JSON object containing the filtered issues and summary
     */
    QJsonObject getCurrentIssues(const Utils::FilePath &path) const;

    /**
     * @brief Retrieves the issues schema from resources
     * @return JSON object containing the schema, or empty object on error
     */
    static Mcp::Schema::Tool::OutputSchema issuesSchema();

    /**
     * @brief Tests multiple approaches to access Qt Creator's task data
     * @return List of test results and findings
     */
    QStringList testTaskAccess() const;

private slots:
    /**
     * @brief Handles task added signals from TaskHub
     * @param task The task that was added
     */
    void onTaskAdded(const ProjectExplorer::Task &task);

    /**
     * @brief Handles task removed signals from TaskHub
     * @param task The task that was removed
     */
    void onTaskRemoved(const ProjectExplorer::Task &task);

    /**
     * @brief Handles tasks cleared signals from TaskHub
     * @param category The category of tasks that were cleared
     */
    void onTasksCleared(const Utils::Id &category);

    /**
     * @brief Handles tasks changed signal from TaskWindow
     */
    void onTasksChanged();

private:
    /**
     * @brief Attempts to access the Issues panel through various methods
     * @return true if successful, false otherwise
     */
    bool initializeAccess();

     /**
     * @brief Retrieves current issues with filtering
     * @param filter filter function to select specific tasks
     * @return JSON object containing the filtered issues and summary
     */
    QJsonObject getCurrentIssues(std::function<bool(const ProjectExplorer::Task &)> filter) const;

    /**
     * @brief Formats a task into a readable string
     * @param taskType The type of task (Error, Warning, etc.)
     * @param description The task description
     * @param filePath The file path (if available)
     * @param lineNumber The line number (if available)
     * @return Formatted string
     */
    QString formatTask(
        const QString &taskType,
        const QString &description,
        const QString &filePath = QString(),
        int lineNumber = -1) const;

    /**
     * @brief Connects to TaskHub and TaskWindow signals
     */
    void connectSignals();

    bool m_accessible = false;

    // Task tracking
    QList<ProjectExplorer::Task> m_trackedTasks;
    QObject *m_taskWindow = nullptr;
    bool m_signalsConnected = false;
};

} // namespace ProjectExplorer
