fix: add from __future__ import annotations to workspace_manager.py

Fixes NameError: ToolInstance not defined at runtime because
type annotations are evaluated at class definition time.
Deferring annotation evaluation with __future__ annotations
keeps TYPE_CHECKING imports from causing runtime crashes.

Also includes ruff formatting cleanup on workspace-related files.

apps/api/src/api/tool_instances.py

@@ -1684,6 +1684,7 @@ async def start_instance(
         repo_path = ""
         if instance.workspace_id:
             from src.models.workspace import Workspace as WorkspaceModel
+
             workspace = await session.get(WorkspaceModel, instance.workspace_id)
             if workspace:
                 repo_path = workspace.path

apps/api/src/api/workspaces.py

@@ -108,7 +108,9 @@ async def create_workspace(
         "branch": workspace.branch,
         "path": workspace.path,
         "status": workspace.status,
-        "created_at": workspace.created_at.isoformat() if workspace.created_at else None,
+        "created_at": workspace.created_at.isoformat()
+        if workspace.created_at
+        else None,
     }
 
 
@@ -216,9 +218,7 @@ async def delete_workspace(
             status_code=409,
             detail={
                 "message": "Workspace has running tool instances",
-                "instances": [
-                    {"id": str(i.id), "name": i.name} for i in exc.instances
-                ],
+                "instances": [{"id": str(i.id), "name": i.name} for i in exc.instances],
             },
         ) from exc
     except Exception as exc:

apps/api/src/services/workspace_manager.py

@@ -1,5 +1,7 @@
 """Workspace lifecycle management service."""
 
+from __future__ import annotations
+
 import logging
 import os
 import shutil
@@ -170,6 +172,4 @@ class WorkspaceManager:
         TODO(PR-2): Wire up to actual instance stop/delete logic.
         For now, this is a placeholder.
         """
-        logger.warning(
-            "Placeholder: stopping and deleting instance %s", instance.id
-        )
+        logger.warning("Placeholder: stopping and deleting instance %s", instance.id)

apps/api/tests/integration/test_workspaces_api.py

@@ -60,7 +60,9 @@ def test_repo(db_session: AsyncSession, authenticated_client: TestClient):
 class TestListWorkspaces:
     """Tests for GET /projects/{pid}/repositories/{rid}/workspaces."""
 
-    def test_list_empty(self, authenticated_client: TestClient, test_repo: GitRepository):
+    def test_list_empty(
+        self, authenticated_client: TestClient, test_repo: GitRepository
+    ):
         """Returns empty list when no workspaces exist."""
         response = authenticated_client.get(
             f"/projects/{test_repo.project_id}/repositories/{test_repo.id}/workspaces"
@@ -69,7 +71,10 @@ class TestListWorkspaces:
         assert response.json() == []
 
     def test_list_with_workspaces(
-        self, authenticated_client: TestClient, db_session: AsyncSession, test_repo: GitRepository
+        self,
+        authenticated_client: TestClient,
+        db_session: AsyncSession,
+        test_repo: GitRepository,
     ):
         """Returns workspaces with instance counts."""
         ws = Workspace(
@@ -99,7 +104,9 @@ class TestListWorkspaces:
 class TestCreateWorkspace:
     """Tests for POST /projects/{pid}/repositories/{rid}/workspaces."""
 
-    def test_create_success(self, authenticated_client: TestClient, test_repo: GitRepository):
+    def test_create_success(
+        self, authenticated_client: TestClient, test_repo: GitRepository
+    ):
         """Creates a workspace and clones the repo."""
         mock_ws = Workspace(
             id=uuid.uuid4(),
@@ -110,7 +117,9 @@ class TestCreateWorkspace:
             path="/data/working-copies/test/feature-branch",
         )
 
-        with patch.object(WorkspaceManager, "create", return_value=mock_ws) as mock_create:
+        with patch.object(
+            WorkspaceManager, "create", return_value=mock_ws
+        ) as mock_create:
             response = authenticated_client.post(
                 f"/projects/{test_repo.project_id}/repositories/{test_repo.id}/workspaces",
                 json={"name": "feature-branch", "branch": "feature"},
@@ -121,7 +130,9 @@ class TestCreateWorkspace:
             assert data["branch"] == "feature"
             mock_create.assert_called_once()
 
-    def test_create_missing_name(self, authenticated_client: TestClient, test_repo: GitRepository):
+    def test_create_missing_name(
+        self, authenticated_client: TestClient, test_repo: GitRepository
+    ):
         """Returns 400 when name is missing."""
         response = authenticated_client.post(
             f"/projects/{test_repo.project_id}/repositories/{test_repo.id}/workspaces",
@@ -131,7 +142,10 @@ class TestCreateWorkspace:
         assert "name" in response.json()["detail"]
 
     def test_create_duplicate_name(
-        self, authenticated_client: TestClient, db_session: AsyncSession, test_repo: GitRepository
+        self,
+        authenticated_client: TestClient,
+        db_session: AsyncSession,
+        test_repo: GitRepository,
     ):
         """Returns 409 when workspace name already exists."""
         ws = Workspace(
@@ -148,7 +162,9 @@ class TestCreateWorkspace:
 
         asyncio.run(_commit())
 
-        with patch.object(WorkspaceManager, "create", side_effect=Exception("duplicate")):
+        with patch.object(
+            WorkspaceManager, "create", side_effect=Exception("duplicate")
+        ):
             response = authenticated_client.post(
                 f"/projects/{test_repo.project_id}/repositories/{test_repo.id}/workspaces",
                 json={"name": "dev", "branch": "main"},
@@ -160,7 +176,10 @@ class TestDeleteWorkspace:
     """Tests for DELETE /projects/{pid}/repositories/{rid}/workspaces/{wid}."""
 
     def test_delete_without_instances(
-        self, authenticated_client: TestClient, db_session: AsyncSession, test_repo: GitRepository
+        self,
+        authenticated_client: TestClient,
+        db_session: AsyncSession,
+        test_repo: GitRepository,
     ):
         """Deletes workspace when no instances exist."""
         ws = Workspace(
@@ -185,9 +204,14 @@ class TestDeleteWorkspace:
             assert response.status_code == 200
             assert response.json()["status"] == "deleted"
 
-    @pytest.mark.skip(reason="Async fixture interaction with sync tests — endpoint logic verified manually")
+    @pytest.mark.skip(
+        reason="Async fixture interaction with sync tests — endpoint logic verified manually"
+    )
     def test_delete_with_instances_no_force(
-        self, authenticated_client: TestClient, db_session: AsyncSession, test_repo: GitRepository
+        self,
+        authenticated_client: TestClient,
+        db_session: AsyncSession,
+        test_repo: GitRepository,
     ):
         """Returns 409 when workspace has instances and force=False."""
         ws = Workspace(
@@ -239,7 +263,10 @@ class TestDeleteWorkspace:
         assert len(detail["instances"]) == 1
 
     def test_delete_with_instances_force(
-        self, authenticated_client: TestClient, db_session: AsyncSession, test_repo: GitRepository
+        self,
+        authenticated_client: TestClient,
+        db_session: AsyncSession,
+        test_repo: GitRepository,
     ):
         """Deletes workspace when force=True even with instances."""
         ws = Workspace(
@@ -268,7 +295,10 @@ class TestSyncWorkspace:
     """Tests for POST /projects/{pid}/repositories/{rid}/workspaces/{wid}/sync."""
 
     def test_sync_success(
-        self, authenticated_client: TestClient, db_session: AsyncSession, test_repo: GitRepository
+        self,
+        authenticated_client: TestClient,
+        db_session: AsyncSession,
+        test_repo: GitRepository,
     ):
         """Sync succeeds and updates last_sync_at."""
         ws = Workspace(
@@ -298,7 +328,10 @@ class TestSyncWorkspace:
             assert data["pulled"] is True
 
     def test_sync_branch_deleted(
-        self, authenticated_client: TestClient, db_session: AsyncSession, test_repo: GitRepository
+        self,
+        authenticated_client: TestClient,
+        db_session: AsyncSession,
+        test_repo: GitRepository,
     ):
         """Returns 409 when branch was deleted from remote."""
         ws = Workspace(

apps/api/tests/unit/test_git_service.py

@@ -21,7 +21,9 @@ class TestGitServiceClone:
         with patch(
             "asyncio.create_subprocess_exec", return_value=mock_proc
         ) as mock_exec:
-            await GitService.clone("https://github.com/test/repo.git", "main", "/tmp/ws")
+            await GitService.clone(
+                "https://github.com/test/repo.git", "main", "/tmp/ws"
+            )
 
         mock_exec.assert_called_once_with(
             "git",