refactor CLI command modules and synchronize docs

tests/test_analysis_properties.py

@@ -6,7 +6,7 @@ Each test validates a specific property from the design document.
 
 import pytest
 from pathlib import Path
-from datetime import datetime
+from datetime import datetime, timezone
 from hypothesis import given, strategies as st, settings
 from vlm.models import (
     SeriesIdentity, SeasonCompleteness, MovieIdentity, VideoFile, DuplicateGroup
@@ -74,7 +74,7 @@ def video_file_strategy(draw, filename=None, category="movie"):
     
     path = Path(f"/{category}/{filename}")
     size_bytes = draw(st.integers(min_value=1000000, max_value=10000000000))
-    modified_timestamp = datetime.now()
+    modified_timestamp = datetime.now(timezone.utc)
     
     # Optional metadata
     has_metadata = draw(st.booleans())
@@ -226,7 +226,7 @@ def test_property_12_duplicate_detection_movies(title, year, duplicate_count):
             Path(f"/movies/{filename}"),
             filename,
             1000000000 + i * 100000000,
-            datetime.now(),
+            datetime.now(timezone.utc),
             "movie"
         ))
     
@@ -272,7 +272,7 @@ def test_property_13_duplicate_detection_series(title, season, episode, duplicat
             Path(f"/series/{filename}"),
             filename,
             1000000000 + i * 100000000,
-            datetime.now(),
+            datetime.now(timezone.utc),
             "series"
         ))
     
@@ -321,7 +321,7 @@ def test_property_14_duplicate_quality_comparison(title, year, file_count):
                 Path(f"/movies/{filename}"),
                 filename,
                 1000000000 + i * 100000000,
-                datetime.now(),
+                datetime.now(timezone.utc),
                 "movie",
                 resolution="1920x1080",
                 codec="h264",
@@ -333,7 +333,7 @@ def test_property_14_duplicate_quality_comparison(title, year, file_count):
                 Path(f"/movies/{filename}"),
                 filename,
                 1000000000 + i * 100000000,
-                datetime.now(),
+                datetime.now(timezone.utc),
                 "movie"
             ))
     
@@ -429,7 +429,7 @@ def test_property_43_duplicate_report_grouping(duplicate_count, format):
                 Path(f"/movies/{filename}"),
                 filename,
                 1000000000 + j * 500000000,
-                datetime.now(),
+                datetime.now(timezone.utc),
                 "movie",
                 resolution="1920x1080" if j == 0 else "1280x720",
                 codec="h264"
@@ -492,7 +492,7 @@ def test_property_44_summary_report_accuracy(file_count, categories):
             Path(f"/{category}/{filename}"),
             filename,
             size,
-            datetime.now(),
+            datetime.now(timezone.utc),
             category
         ))