adapter.py

"""Abstract adapter interface for CLI-based automation."""

from __future__ import annotations

from abc import ABC, abstractmethod
from dataclasses import dataclass, field
from pathlib import Path
from typing import TYPE_CHECKING

if TYPE_CHECKING:
    from cli_harness.simulator import HumanSimulator


@dataclass
class AdapterConfig:
    """Configuration for a CLI adapter run."""

    vision_path: Path
    output_dir: Path
    rules_path: Path
    tech_env_path: Path | None = None
    prompt_template: str | None = None
    model: str | None = None
    simulator_model: str | None = None  # kept for backwards compat; prefer simulator field
    aws_profile: str | None = None
    aws_region: str | None = None
    openapi_content: str | None = None  # injected into prompt/simulator for contract validation
    simulator: "HumanSimulator | None" = None  # pre-built by orchestrator; shared across adapters
    timeout_seconds: int = 7200  # 2 hours max


@dataclass
class AdapterResult:
    """Result from a CLI adapter run."""

    success: bool
    output_dir: Path
    aidlc_docs_dir: Path | None = None
    workspace_dir: Path | None = None
    error: str | None = None
    elapsed_seconds: float = 0.0
    token_estimate: int | None = None
    extra: dict = field(default_factory=dict)


class CLIAdapter(ABC):
    """Abstract base for CLI-specific automation adapters."""

    @property
    @abstractmethod
    def name(self) -> str:
        """Human-readable CLI tool name (e.g., 'kiro-cli')."""
        ...

    @abstractmethod
    def check_prerequisites(self) -> tuple[bool, str]:
        """Verify the CLI tool is installed, configured, and accessible.

        Returns:
            (ok, message) — True with a success message, or False with
            a description of what's missing.
        """
        ...

    @abstractmethod
    def run(self, config: AdapterConfig) -> AdapterResult:
        """Execute the AIDLC process through the CLI tool and capture outputs.

        The implementation should:
        1. Set up a clean workspace with vision.md, tech-env.md, and rules
        2. Launch the CLI tool or connect to a running instance
        3. Send the AIDLC prompt to the CLI tool
        4. Monitor for completion (all AIDLC phases done)
        5. Extract aidlc-docs/ and workspace/ from the output
        6. Generate run-meta.yaml with timing and adapter info
        """
        ...