Enhance project structure and add new files for enrichment and analysis

- Updated AGENTS.md to reflect changes in CLI commands and module organization, including the addition of an enrichment step and new functional modules.
- Introduced analysis.json, identities.json, inventory.csv, and plan.json to support enriched metadata and execution planning.
- Added CODE_IMPROVEMENTS.md to document identified code issues and proposed solutions for future enhancements.
- Updated README.md to include new enrichment features and configuration options.
- Removed unused dependency on ffmpeg-python from pyproject.toml.

These changes improve the overall functionality and maintainability of the Video Library Manager project.

src/vlm/analysis.py

@@ -68,65 +68,39 @@ def analyze_series_completeness(episodes: list[SeriesIdentity]) -> list[SeasonCo
 
 
 def detect_duplicates(
-    identities: list[MovieIdentity | SeriesIdentity],
-    files: list[VideoFile]
+    identity_file_pairs: list[tuple[MovieIdentity | SeriesIdentity, VideoFile]],
 ) -> list[DuplicateGroup]:
     """Detect duplicate video files and provide quality comparison data.
-    
+
     Groups files by normalized identity (title+year for movies, title+season+episode
     for series) and identifies groups with multiple files as potential duplicates.
-    
+    Uses (identity, file) pairs so that same filename under different paths are
+    not conflated.
+
     Args:
-        identities: List of parsed identities (movies or series)
-        files: List of video files corresponding to the identities
-        
+        identity_file_pairs: List of (identity, video_file) in matching order
+
     Returns:
         List of DuplicateGroup objects for files with duplicates
     """
-    # Create a mapping from original filename to VideoFile for quick lookup
-    file_map = {file.filename: file for file in files}
-    
-    # Group identities by normalized identity
     groups: dict[tuple, list[tuple[MovieIdentity | SeriesIdentity, VideoFile]]] = {}
-    
-    for identity in identities:
-        # Create grouping key based on identity type
+
+    for identity, video_file in identity_file_pairs:
         if isinstance(identity, MovieIdentity):
-            # For movies: group by (title, year)
-            # Skip if year is None (needs review)
             if identity.year is None:
                 continue
-            key = ('movie', identity.title, identity.year)
+            key = ("movie", identity.title, identity.year)
+            if key not in groups:
+                groups[key] = []
+            groups[key].append((identity, video_file))
         else:  # SeriesIdentity
-            # For series: group by (title, season, episode)
-            # Skip if season is None or episodes is empty (needs review)
             if identity.season is None or not identity.episodes:
                 continue
-            # For multi-episode files, use the first episode for grouping
-            # Each episode in the list should be treated separately
             for episode in identity.episodes:
-                key = ('series', identity.title, identity.season, episode)
-                
-                # Get the corresponding VideoFile
-                video_file = file_map.get(identity.original_filename)
-                if video_file is None:
-                    continue
-                
-                # Add to group
+                key = ("series", identity.title, identity.season, episode)
                 if key not in groups:
                     groups[key] = []
                 groups[key].append((identity, video_file))
-            continue
-        
-        # Get the corresponding VideoFile for movies
-        video_file = file_map.get(identity.original_filename)
-        if video_file is None:
-            continue
-        
-        # Add to group
-        if key not in groups:
-            groups[key] = []
-        groups[key].append((identity, video_file))
     
     # Filter groups to only those with multiple files (duplicates)
     duplicate_groups = []