"""Kiro CLI integration."""

import shutil

from ..base import MarkdownIntegration


# Kiro CLI file-based prompts do NOT support any argument-substitution syntax,
# so a raw "$ARGUMENTS" token would reach the model verbatim and break the
# prompt (issue #1926, kirodotdev/Kiro#4141). Use a prose fallback so the
# rendered prompt instructs the model to take its argument from the user's
# next message.
_KIRO_ARG_FALLBACK = "(the user will provide the argument in this conversation)"


class KiroCliIntegration(MarkdownIntegration):
    key = "kiro-cli"
    config = {
        "name": "Kiro CLI",
        "folder": ".kiro/",
        "commands_subdir": "prompts",
        "install_url": "https://kiro.dev/docs/cli/",
        "requires_cli": True,
    }
    registrar_config = {
        "dir": ".kiro/prompts",
        "format": "markdown",
        "args": _KIRO_ARG_FALLBACK,
        "extension": ".md",
    }
    context_file = "AGENTS.md"

    def is_cli_available(self) -> bool:
        """Return ``True`` if the Kiro CLI is installed.

        Kiro ships under two binary names: ``kiro-cli`` (preferred) and
        the legacy ``kiro`` alias.  Either name satisfies the availability
        check so existing installations continue to work.

        See issue #2597.
        """
        return (
            shutil.which("kiro-cli") is not None
            or shutil.which("kiro") is not None
        )