claude_code

defmodule ClaudeCode.Plugin do
  @moduledoc """
  Plugin management functions wrapping the `claude plugin` CLI commands.

  Provides functions to install, uninstall, enable, disable, update, list,
  and validate plugins from configured marketplaces.

  All functions resolve the CLI binary via the internal Adapter.Port.Resolver and execute
  commands synchronously via the system command abstraction.

  > **Note:** Remote node support is not yet implemented — these commands run on
  > the local machine only.

  ## Examples

      # List installed plugins
      {:ok, plugins} = ClaudeCode.Plugin.list()

      # Install a plugin from a marketplace
      {:ok, _} = ClaudeCode.Plugin.install("code-simplifier@claude-plugins-official")

      # Enable/disable a plugin
      {:ok, _} = ClaudeCode.Plugin.enable("code-simplifier@claude-plugins-official")
      {:ok, _} = ClaudeCode.Plugin.disable("code-simplifier@claude-plugins-official")
  """

  alias ClaudeCode.Plugin.CLI, as: PluginCLI

  defstruct [
    :id,
    :version,
    :scope,
    :enabled,
    :install_path,
    :installed_at,
    :last_updated,
    :project_path,
    :mcp_servers
  ]

  @type scope :: :user | :project | :local

  @type t :: %__MODULE__{
          id: String.t(),
          version: String.t() | nil,
          scope: scope() | nil,
          enabled: boolean(),
          install_path: String.t() | nil,
          installed_at: String.t() | nil,
          last_updated: String.t() | nil,
          project_path: String.t() | nil,
          mcp_servers: map() | nil
        }

  @doc """
  Lists installed plugins.

  Returns a list of `%ClaudeCode.Plugin{}` structs parsed from
  `claude plugin list --json`.

  ## Examples

      {:ok, plugins} = ClaudeCode.Plugin.list()
      Enum.each(plugins, fn p -> IO.puts("\#{p.id} (enabled: \#{p.enabled})") end)
  """
  @spec list(keyword()) :: {:ok, [t()]} | {:error, String.t()}
  def list(opts \\ []) do
    PluginCLI.run(["plugin", "list", "--json"], opts, &parse_list/1)
  end

  @doc """
  Installs a plugin from available marketplaces.

  Use `plugin@marketplace` format for a specific marketplace, or just `plugin`
  to search all configured marketplaces.

  ## Options

    * `:scope` - Installation scope: `:user` (default), `:project`, or `:local`

  ## Examples

      {:ok, _} = ClaudeCode.Plugin.install("code-simplifier@claude-plugins-official")
      {:ok, _} = ClaudeCode.Plugin.install("my-plugin@my-org", scope: :project)
  """
  @spec install(String.t(), keyword()) :: {:ok, String.t()} | {:error, String.t()}
  def install(plugin_id, opts \\ []) do
    args = ["plugin", "install"] ++ PluginCLI.scope_args(opts) ++ [plugin_id]
    PluginCLI.run(args, opts, &PluginCLI.ok_trimmed/1)
  end

  @doc """
  Uninstalls an installed plugin.

  ## Options

    * `:scope` - Uninstall from scope: `:user` (default), `:project`, or `:local`

  ## Examples

      {:ok, _} = ClaudeCode.Plugin.uninstall("code-simplifier@claude-plugins-official")
  """
  @spec uninstall(String.t(), keyword()) :: {:ok, String.t()} | {:error, String.t()}
  def uninstall(plugin_id, opts \\ []) do
    args = ["plugin", "uninstall"] ++ PluginCLI.scope_args(opts) ++ [plugin_id]
    PluginCLI.run(args, opts, &PluginCLI.ok_trimmed/1)
  end

  @doc """
  Enables a disabled plugin.

  ## Options

    * `:scope` - Scope: `:user`, `:project`, or `:local` (default: auto-detect)

  ## Examples

      {:ok, _} = ClaudeCode.Plugin.enable("code-simplifier@claude-plugins-official")
  """
  @spec enable(String.t(), keyword()) :: {:ok, String.t()} | {:error, String.t()}
  def enable(plugin_id, opts \\ []) do
    args = ["plugin", "enable"] ++ PluginCLI.scope_args(opts) ++ [plugin_id]
    PluginCLI.run(args, opts, &PluginCLI.ok_trimmed/1)
  end

  @doc """
  Disables an enabled plugin.

  ## Options

    * `:scope` - Scope: `:user`, `:project`, or `:local` (default: auto-detect)

  ## Examples

      {:ok, _} = ClaudeCode.Plugin.disable("code-simplifier@claude-plugins-official")
  """
  @spec disable(String.t(), keyword()) :: {:ok, String.t()} | {:error, String.t()}
  def disable(plugin_id, opts \\ []) do
    args = ["plugin", "disable"] ++ PluginCLI.scope_args(opts) ++ [plugin_id]
    PluginCLI.run(args, opts, &PluginCLI.ok_trimmed/1)
  end

  @doc """
  Disables all enabled plugins.

  ## Options

    * `:scope` - Scope: `:user`, `:project`, or `:local` (default: auto-detect)

  ## Examples

      {:ok, _} = ClaudeCode.Plugin.disable_all()
      {:ok, _} = ClaudeCode.Plugin.disable_all(scope: :project)
  """
  @spec disable_all(keyword()) :: {:ok, String.t()} | {:error, String.t()}
  def disable_all(opts \\ []) do
    args = ["plugin", "disable", "--all"] ++ PluginCLI.scope_args(opts)
    PluginCLI.run(args, opts, &PluginCLI.ok_trimmed/1)
  end

  @doc """
  Updates a plugin to the latest version.

  A session restart is required for updates to take effect.

  ## Options

    * `:scope` - Scope: `:user`, `:project`, `:local`, or `:managed`

  ## Examples

      {:ok, _} = ClaudeCode.Plugin.update("code-simplifier@claude-plugins-official")
  """
  @spec update(String.t(), keyword()) :: {:ok, String.t()} | {:error, String.t()}
  def update(plugin_id, opts \\ []) do
    args = ["plugin", "update"] ++ PluginCLI.scope_args(opts) ++ [plugin_id]
    PluginCLI.run(args, opts, &PluginCLI.ok_trimmed/1)
  end

  # -- Private: JSON parsing ---------------------------------------------------

  defp parse_list(output) do
    case Jason.decode(output) do
      {:ok, items} when is_list(items) ->
        {:ok, Enum.map(items, &from_json/1)}

      {:error, _reason} ->
        {:error, "Failed to parse plugin list JSON: #{String.trim(output)}"}
    end
  end

  defp from_json(map) when is_map(map) do
    %__MODULE__{
      id: map["id"],
      version: map["version"],
      scope: parse_scope(map["scope"]),
      enabled: map["enabled"] || false,
      install_path: map["installPath"],
      installed_at: map["installedAt"],
      last_updated: map["lastUpdated"],
      project_path: map["projectPath"],
      mcp_servers: map["mcpServers"]
    }
  end

  defp parse_scope("user"), do: :user
  defp parse_scope("project"), do: :project
  defp parse_scope("local"), do: :local
  defp parse_scope(_other), do: nil
end