refactor(settings): rename update_flag_strategy to version_grouping with migration

py/services/base_model_service.py

@@ -116,11 +116,11 @@ class BaseModelService(ABC):
         dedup_lost = 0
         if kwargs.get("group_by_model") and civitai_model_id is None:
             # Determine whether to further sub-group by base model
-            # When update_flag_strategy is "same_base", versions with different
+            # When version_grouping is "same_base", versions with different
             # base models are effectively different groups — the dedup key
             # needs to include base_model so the version count and VLM flow
             # stay consistent (card shows correct count for its base model).
-            ufs = self.settings.get("update_flag_strategy", "same_base")
+            ufs = self.settings.get("version_grouping", "same_base")
             group_by_base = ufs == "same_base"
 
             dedup_map = {}  # (modelId [,base_model]) -> (item, version_id)
@@ -551,7 +551,7 @@ class BaseModelService(ABC):
         if not ordered_ids:
             return annotated
 
-        strategy_value = self.settings.get("update_flag_strategy")
+        strategy_value = self.settings.get("version_grouping")
         if isinstance(strategy_value, str) and strategy_value.strip():
             strategy = strategy_value.strip().lower()
         else:

py/services/settings_manager.py

@@ -98,7 +98,7 @@ DEFAULT_SETTINGS: Dict[str, Any] = {
     "lora_syntax_format": "legacy",
     "model_card_footer_action": "replace_preview",
     "show_version_on_card": True,
-    "update_flag_strategy": "same_base",
+    "version_grouping": "same_base",
     "auto_organize_exclusions": [],
     "metadata_refresh_skip_paths": [],
     "skip_previously_downloaded_model_versions": False,
@@ -745,6 +745,7 @@ class SettingsManager:
             "includeTriggerWords": "include_trigger_words",
             "compactMode": "compact_mode",
             "modelCardFooterAction": "model_card_footer_action",
+            "update_flag_strategy": "version_grouping",
         }
 
         updated = False