feat(FN-011): complete Step 1 — Git types and provider abstraction

Fusion-Task-Id: FN-011 Fusion-Task-Lineage: 4a9aca6f-9d91-43aa-8d2a-d59657c1541a
2026-05-14 07:23:02 +02:00
parent 64ba5e3e56
commit f9dd56902f
3 changed files with 105 additions and 0 deletions
@@ -0,0 +1,48 @@
+"""Abstract base class for Git provider adapters."""
+
+import abc
+from typing import Any
+
+from app.git.types import ConnectionStatus, ProviderKind
+
+
+class GitProvider(abc.ABC):
+    """Provider API adapter for remote Git operations.
+
+    This abstraction is separate from :class:`~app.git.operations.GitOperations`,
+    which handles local Git subprocess workflows.
+    """
+
+    @abc.abstractmethod
+    def get_kind(self) -> ProviderKind:
+        """Return the provider kind identifier."""
+
+    @abc.abstractmethod
+    async def validate_connection(
+        self, git_url: str, credential_id: str
+    ) -> ConnectionStatus:
+        """Validate that the given credential can access *git_url*.
+
+        Returns a :class:`ConnectionStatus` indicating the result.
+        """
+
+    @abc.abstractmethod
+    async def list_repositories(self, credential_id: str) -> list[dict[str, Any]]:
+        """List repositories accessible with *credential_id*."""
+
+    @abc.abstractmethod
+    async def create_deploy_key(
+        self, git_url: str, public_key: str
+    ) -> str:
+        """Register a deploy key on the remote provider.
+
+        Returns the provider-side deploy key ID.
+        """
+
+    @abc.abstractmethod
+    async def delete_deploy_key(self, git_url: str, deploy_key_id: str) -> None:
+        """Remove a previously registered deploy key."""
+
+    @abc.abstractmethod
+    async def get_default_branch(self, git_url: str, credential_id: str) -> str:
+        """Return the default branch name for the repository at *git_url*."""