fix: normalize manifest keys to POSIX, type manifest parameter

- Store manifest file keys using as_posix() after resolving relative
  to project root, ensuring cross-platform portable manifests
- Type the manifest parameter as IntegrationManifest (via TYPE_CHECKING
  import) instead of Any in IntegrationBase methods

Author: mnriem

src/specify_cli/integrations/base.py

@@ -13,7 +13,10 @@
 from abc import ABC
 from dataclasses import dataclass
 from pathlib import Path
-from typing import Any
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from .manifest import IntegrationManifest
 
 
 # ---------------------------------------------------------------------------
@@ -95,7 +98,7 @@ def templates_dir(self) -> Path:
     def setup(
         self,
         project_root: Path,
-        manifest: Any,
+        manifest: IntegrationManifest,
         parsed_options: dict[str, Any] | None = None,
         **opts: Any,
     ) -> list[Path]:
@@ -143,7 +146,7 @@ def setup(
     def teardown(
         self,
         project_root: Path,
-        manifest: Any,
+        manifest: IntegrationManifest,
         *,
         force: bool = False,
     ) -> tuple[list[Path], list[Path]]:
@@ -161,7 +164,7 @@ def teardown(
     def install(
         self,
         project_root: Path,
-        manifest: Any,
+        manifest: IntegrationManifest,
         parsed_options: dict[str, Any] | None = None,
         **opts: Any,
     ) -> list[Path]:
@@ -173,7 +176,7 @@ def install(
     def uninstall(
         self,
         project_root: Path,
-        manifest: Any,
+        manifest: IntegrationManifest,
         *,
         force: bool = False,
     ) -> tuple[list[Path], list[Path]]:

src/specify_cli/integrations/manifest.py

@@ -87,7 +87,8 @@ def record_file(self, rel_path: str | Path, content: bytes | str) -> Path:
             content = content.encode("utf-8")
         abs_path.write_bytes(content)
 
-        self._files[str(rel)] = hashlib.sha256(content).hexdigest()
+        normalized = abs_path.relative_to(self.project_root).as_posix()
+        self._files[normalized] = hashlib.sha256(content).hexdigest()
         return abs_path
 
     def record_existing(self, rel_path: str | Path) -> None:
@@ -97,7 +98,8 @@ def record_existing(self, rel_path: str | Path) -> None:
         """
         rel = Path(rel_path)
         abs_path = _validate_rel_path(rel, self.project_root)
-        self._files[str(rel)] = _sha256(abs_path)
+        normalized = abs_path.relative_to(self.project_root).as_posix()
+        self._files[normalized] = _sha256(abs_path)
 
     # -- Querying ---------------------------------------------------------