feat(refactor): Document refactoring progress and phases in markdown

feat(scripts): Add backfill script for content_hash in cache tables

feat(scripts): Create recompute script for analysis_cache population

test(tests): Implement comprehensive tests for analysis module functions

fix(tests): Update CLI tests to assert errors on stderr instead of stdout

fix(tests): Adjust MCP integration tests to pass context parameter correctly

fix(tests): Modify service tests to return hash on save functions for consistency

tests/test_service.py

@@ -38,7 +38,7 @@ async def test_get_or_fetch_ad_fetches_when_cache_miss():
         patch("finn_eiendom.service.init_db"),
         patch("finn_eiendom.service.get_finn_ad", return_value=None),
         patch("finn_eiendom.service.fetch_ad_details", return_value=mock_ad) as mock_fetch,
-        patch("finn_eiendom.service.save_finn_ad") as mock_save,
+        patch("finn_eiendom.service.save_finn_ad", return_value=("hash123", True)) as mock_save,
     ):
         result = await get_or_fetch_ad("123")
 
@@ -56,7 +56,7 @@ async def test_get_or_fetch_ad_force_refresh():
         patch("finn_eiendom.service.init_db"),
         patch("finn_eiendom.service.get_finn_ad", return_value=mock_ad) as mock_get,
         patch("finn_eiendom.service.fetch_ad_details", return_value=mock_ad) as mock_fetch,
-        patch("finn_eiendom.service.save_finn_ad") as mock_save,
+        patch("finn_eiendom.service.save_finn_ad", return_value=("hash123", True)) as mock_save,
     ):
         result = await get_or_fetch_ad("123", force_refresh=True)
 
@@ -92,7 +92,9 @@ async def test_get_or_fetch_eiendom_unit_fetches_when_cache_miss():
         patch("finn_eiendom.service.init_db"),
         patch("finn_eiendom.service.get_cached_eiendom_unit", return_value=None),
         patch("finn_eiendom.service.get_unit", return_value=mock_unit) as mock_fetch,
-        patch("finn_eiendom.service.save_eiendom_unit") as mock_save,
+        patch(
+            "finn_eiendom.service.save_eiendom_unit", return_value=("hash123", True)
+        ) as mock_save,
     ):
         result = await get_or_fetch_eiendom_unit("test-code")
 
@@ -110,7 +112,9 @@ async def test_get_or_fetch_similar_units_uses_cache():
     with (
         patch("finn_eiendom.service.init_db"),
         patch("finn_eiendom.service.get_or_fetch_eiendom_unit", return_value=mock_unit),
-        patch("finn_eiendom.service.get_cached_similar_units", return_value=mock_similar) as mock_get,
+        patch(
+            "finn_eiendom.service.get_cached_similar_units", return_value=mock_similar
+        ) as mock_get,
         patch("finn_eiendom.service.get_similar_units") as mock_fetch,
     ):
         result = await get_or_fetch_similar_units("test-code", "RECENTLY_SOLD")
@@ -133,7 +137,9 @@ async def test_get_or_fetch_similar_units_fetches_when_cache_miss():
         patch("finn_eiendom.service.get_cached_similar_units", return_value=[]),
         patch("finn_eiendom.service.build_unit_vector", return_value="vector_data"),
         patch("finn_eiendom.service.get_similar_units", return_value=mock_similar) as mock_fetch,
-        patch("finn_eiendom.service.save_similar_units") as mock_save,
+        patch(
+            "finn_eiendom.service.save_similar_units", return_value=("hash123", True)
+        ) as mock_save,
     ):
         result = await get_or_fetch_similar_units("test-code", "RECENTLY_SOLD")
 
@@ -152,10 +158,14 @@ async def test_get_or_fetch_similar_units_force_refresh():
     with (
         patch("finn_eiendom.service.init_db"),
         patch("finn_eiendom.service.get_or_fetch_eiendom_unit", return_value=mock_unit),
-        patch("finn_eiendom.service.get_cached_similar_units", return_value=mock_similar) as mock_get,
+        patch(
+            "finn_eiendom.service.get_cached_similar_units", return_value=mock_similar
+        ) as mock_get,
         patch("finn_eiendom.service.build_unit_vector", return_value="vector_data"),
         patch("finn_eiendom.service.get_similar_units", return_value=mock_similar) as mock_fetch,
-        patch("finn_eiendom.service.save_similar_units") as mock_save,
+        patch(
+            "finn_eiendom.service.save_similar_units", return_value=("hash123", True)
+        ) as mock_save,
     ):
         result = await get_or_fetch_similar_units("test-code", "RECENTLY_SOLD", force_refresh=True)