Fix circular import between observer and platform

Author: kryphion

src/pidpal/core/explainer.py

@@ -23,6 +23,7 @@
 if TYPE_CHECKING:
     from pidpal.llm.base import LLMProvider
 
+
 @dataclass
 class ProcessExplanation:
     """Human-readable explanation of a process."""

src/pidpal/core/observer.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 """
 Observation Layer - System Truth
 
@@ -7,9 +9,10 @@
 
 from dataclasses import dataclass
 from datetime import datetime
-from typing import Any
+from typing import TYPE_CHECKING, Any
 
-from pidpal.platform.base import PlatformInterface
+if TYPE_CHECKING:
+    from pidpal.platform.base import PlatformInterface
 
 
 @dataclass

src/pidpal/knowledge/local_enrichment.py

@@ -562,7 +562,9 @@ def _iter_desktop_dirs(self) -> list[Path]:
             Path.home() / ".local/share/flatpak/exports/share/applications",
         ]
 
-    def _update_desktop_cache(self, cache: dict[str, dict[str, str]], entry: dict[str, str]) -> None:
+    def _update_desktop_cache(
+        self, cache: dict[str, dict[str, str]], entry: dict[str, str]
+    ) -> None:
         """Add a desktop entry to the cache with common keys."""
         exec_name = entry.get("exec_name", "").lower()
         if exec_name:

src/pidpal/platform/base.py

@@ -5,15 +5,17 @@
 """
 
 from abc import ABC, abstractmethod
+from typing import TYPE_CHECKING
 
-from pidpal.core.observer import ProcessData
+if TYPE_CHECKING:
+    from pidpal.core.observer import ProcessData
 
 
 class PlatformInterface(ABC):
     """Abstract interface for platform-specific process data collection."""
 
     @abstractmethod
-    def collect_process_data(self, pid: int) -> ProcessData:
+    def collect_process_data(self, pid: int) -> "ProcessData":
         """
         Collect all available data for a specific process.
 
@@ -30,7 +32,7 @@ def collect_process_data(self, pid: int) -> ProcessData:
         pass
 
     @abstractmethod
-    def collect_all_processes(self) -> list[ProcessData]:
+    def collect_all_processes(self) -> list["ProcessData"]:
         """
         Collect data for all running processes.
 

src/pidpal/ui/cli.py

@@ -21,6 +21,7 @@
 if TYPE_CHECKING:
     from threading import Thread
 
+
 @dataclass
 class CliOptions:
     pid: str | None