add-adapter

Before doing anything else, check that /k9aif:configure has been run. If K9AIF_PROJECT_ROOT and K9AIF_APP_NAME are not set, refuse and say:

"Please run /k9aif:configure first to set your project root and app name." Do not proceed until init has been run.

K9-AIF: Add Adapter

Scaffold a new provider adapter for an infrastructure concern (secret management, cache, storage, etc.) following the three-layer Provider Adapter Pattern: ABB contract → adapter → factory.

The user provides: <ConcernName> <ProviderName> (e.g. Cache Redis or SecretManager Vault).

Three-layer structure to generate

k9_aif_abb/
  k9_core/<concern>/base_<concern>.py       ← ABB contract (if not already existing)
  k9_<concern>/adapters/<provider>_adapter.py  ← Concrete implementation
  k9_factories/<concern>_factory.py         ← Static factory (if not already existing)

1. ABB contract (only if it does not already exist)

# k9_core/<concern>/base_<concern>.py
from abc import ABC, abstractmethod


class Base<ConcernName>(ABC):

    @abstractmethod
    def get(self, key: str) -> str:
        raise NotImplementedError

    @abstractmethod
    def set(self, key: str, value: str) -> None:
        raise NotImplementedError

2. Provider adapter — with lazy import pattern (mandatory for optional dependencies)

# k9_<concern>/adapters/<provider>_adapter.py
from k9_aif_abb.k9_core.<concern>.base_<concern> import Base<ConcernName>


class <Provider><ConcernName>Adapter(Base<ConcernName>):

    def __init__(self, config=None):
        self._config = config or {}
        self._client = None  # lazy — do NOT import at module level

    def _ensure_client(self):
        if self._client is not None:
            return
        try:
            import <provider_package>
            self._client = <provider_package>.Client(
                url=self._config.get("<concern>", {}).get("url", ""),
            )
        except ImportError as exc:
            raise RuntimeError("pip install <provider_package> required") from exc

    def get(self, key: str) -> str:
        self._ensure_client()
        return self._client.get(key)

    def set(self, key: str, value: str) -> None:
        self._ensure_client()
        self._client.set(key, value)