feat: regenerate paths in catalog and cache

data/cache.tar.gz

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:8d9e2f29be8e2e38d250becadb88625bb598a9a7359e1107a90b48edbfadddcc
-size 213437895
+oid sha256:6ab39ded3902bc775ffa102dafdd566ae066084318b28504651333268a8d0157
+size 213436978

data/catalog.tar.gz

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:034ffb5eec607ebcce6372a725d947f0607866d9d89272e2d20b32604ffcfbe7
+oid sha256:7f50a73310600440e9ab53c081a12f637b33289815171ea80d6c9ebd28000c07
 size 276174890

scripts/precompute_cache.py

@@ -81,6 +81,23 @@ TOP_K_DEFAULT = 5
 ALL_EXTRACTORS = ["sift", "superpoint", "disk", "aliked"]
 
 
+def make_relative_path(filepath: str, project_root: Path) -> str:
+    """Convert absolute path to relative path from project root.
+
+    Args:
+        filepath: Absolute or relative file path
+        project_root: Project root directory
+
+    Returns:
+        Relative path string from project root
+    """
+    try:
+        return str(Path(filepath).relative_to(project_root))
+    except ValueError:
+        # Already relative or different root
+        return filepath
+
+
 def ensure_sam_model() -> Path:
     """Download SAM HQ model if not present.
 
@@ -269,7 +286,7 @@ def process_and_cache(
             logger.info(f"  Found {len(matches)} matches")
 
             # ================================================================
-            # Enrich matches with location/body_part
+            # Enrich matches with location/body_part and convert to relative paths
             # ================================================================
             logger.info("  Adding location/body_part metadata...")
             for match in matches:
@@ -278,6 +295,8 @@ def process_and_cache(
                 )
                 match["location"] = location
                 match["body_part"] = body_part
+                # Convert absolute path to relative (portable across environments)
+                match["filepath"] = make_relative_path(match["filepath"], PROJECT_ROOT)
 
             # ================================================================
             # Set up cache directory

src/snowleopard_reid/cache.py

@@ -358,7 +358,13 @@ def generate_visualizations_from_npz(
     for match in matches:
         rank = match["rank"]
         catalog_id = match["catalog_id"]
-        catalog_image_path = Path(match["filepath"])
+
+        # Resolve relative path to absolute (handles both relative and absolute paths)
+        filepath = match["filepath"]
+        if not Path(filepath).is_absolute():
+            catalog_image_path = PROJECT_ROOT / filepath
+        else:
+            catalog_image_path = Path(filepath)
 
         # Look for NPZ file by catalog_id
         npz_path = pairwise_dir / f"{catalog_id}.npz"