refactor: improve function naming for clarity and consistency

Rename functions to use clearer verb-based names:
- pick_best_live_path → select_best_live_path
- escape_like_prefix → escape_sql_like_string
- list_tree → list_files_recursively
- check_asset_file_fast → verify_asset_file_unchanged
- _seed_from_paths_batch → _batch_insert_assets_from_paths
- reconcile_cache_states_for_root → sync_cache_states_with_filesystem
- touch_asset_info_by_id → update_asset_info_access_time
- replace_asset_info_metadata_projection → set_asset_info_metadata
- expand_metadata_to_rows → convert_metadata_to_rows
- _rows_per_stmt → _calculate_rows_per_statement
- ensure_within_base → validate_path_within_base
- _cleanup_temp → _delete_temp_file_if_exists
- validate_hash_format → normalize_and_validate_hash
- get_relative_to_root_category_path_of_asset → get_asset_category_and_relative_path

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

app/assets/services/path_utils.py

@@ -48,7 +48,7 @@ def resolve_destination_from_tags(tags: list[str]) -> tuple[str, list[str]]:
     return base_dir, raw_subdirs if raw_subdirs else []
 
 
-def ensure_within_base(candidate: str, base: str) -> None:
+def validate_path_within_base(candidate: str, base: str) -> None:
     cand_abs = os.path.abspath(candidate)
     base_abs = os.path.abspath(base)
     try:
@@ -69,7 +69,7 @@ def compute_relative_filename(file_path: str) -> str | None:
     NOTE: this is a temporary helper, used only for initializing metadata["filename"] field.
     """
     try:
-        root_category, rel_path = get_relative_to_root_category_path_of_asset(file_path)
+        root_category, rel_path = get_asset_category_and_relative_path(file_path)
     except ValueError:
         return None
 
@@ -85,7 +85,7 @@ def compute_relative_filename(file_path: str) -> str | None:
     return "/".join(parts)  # input/output: keep all parts
 
 
-def get_relative_to_root_category_path_of_asset(file_path: str) -> tuple[Literal["input", "output", "models"], str]:
+def get_asset_category_and_relative_path(file_path: str) -> tuple[Literal["input", "output", "models"], str]:
     """Given an absolute or relative file path, determine which root category the path belongs to:
       - 'input' if the file resides under `folder_paths.get_input_directory()`
       - 'output' if the file resides under `folder_paths.get_output_directory()`
@@ -143,7 +143,7 @@ def get_name_and_tags_from_asset_path(file_path: str) -> tuple[str, list[str]]:
     """Return a tuple (name, tags) derived from a filesystem path.
 
     Semantics:
-      - Root category is determined by `get_relative_to_root_category_path_of_asset`.
+      - Root category is determined by `get_asset_category_and_relative_path`.
       - The returned `name` is the base filename with extension from the relative path.
       - The returned `tags` are:
             [root_category] + parent folders of the relative path (in order)
@@ -155,7 +155,7 @@ def get_name_and_tags_from_asset_path(file_path: str) -> tuple[str, list[str]]:
     Raises:
         ValueError: if the path does not belong to input, output, or configured model bases.
     """
-    root_category, some_path = get_relative_to_root_category_path_of_asset(file_path)
+    root_category, some_path = get_asset_category_and_relative_path(file_path)
     p = Path(some_path)
     parent_parts = [part for part in p.parent.parts if part not in (".", "..", p.anchor)]
     return p.name, list(dict.fromkeys(normalize_tags([root_category, *parent_parts])))