f

Store/Folder.py

@@ -10,6 +10,7 @@ from typing import Any, Dict, List, Optional, Tuple
 
 from SYS.logger import debug, log
 from SYS.utils import sha256_file, expand_path
+from SYS.config import get_local_storage_path
 
 from Store._base import Store
 
@@ -56,7 +57,7 @@ class Folder(Store):
     """"""
 
     # Track which locations have already been migrated to avoid repeated migrations
-    _migrated_locations = set()
+    _migrated_locations: set[str] = set()
     # Cache scan results to avoid repeated full scans across repeated instantiations
     _scan_cache: Dict[str,
                       Tuple[bool,
@@ -65,7 +66,7 @@ class Folder(Store):
                                  int]]] = {}
 
     @classmethod
-    def config(cls) -> List[Dict[str, Any]]:
+    def config_schema(cls) -> List[Dict[str, Any]]:
         return [
             {
                 "key": "NAME",
@@ -1498,11 +1499,12 @@ class Folder(Store):
             debug(f"Failed to get file for hash {file_hash}: {exc}")
             return None
 
-    def get_metadata(self, file_hash: str) -> Optional[Dict[str, Any]]:
+    def get_metadata(self, file_hash: str, **kwargs: Any) -> Optional[Dict[str, Any]]:
         """Get metadata for a file from the database by hash.
 
         Args:
             file_hash: SHA256 hash of the file (64-char hex string)
+            **kwargs: Additional options
 
         Returns:
             Dict with metadata fields (ext, size, hash, duration, etc.) or None if not found
@@ -1613,7 +1615,7 @@ class Folder(Store):
             debug(f"get_tags failed for local file: {exc}")
             return [], "unknown"
 
-    def add_tag(self, hash: str, tag: List[str], **kwargs: Any) -> bool:
+    def add_tag(self, file_identifier: str, tags: List[str], **kwargs: Any) -> bool:
         """Add tags to a local file by hash (via API_folder_store).
 
         Handles namespace collapsing: when adding namespace:value, removes existing namespace:* tags.
@@ -1628,14 +1630,14 @@ class Folder(Store):
             try:
                 with API_folder_store(Path(self._location)) as db:
                     existing_tags = [
-                        t for t in (db.get_tags(hash) or [])
+                        t for t in (db.get_tags(file_identifier) or [])
                         if isinstance(t, str) and t.strip()
                     ]
 
                     from SYS.metadata import compute_namespaced_tag_overwrite
 
                     _to_remove, _to_add, merged = compute_namespaced_tag_overwrite(
-                        existing_tags, tag or []
+                        existing_tags, tags or []
                     )
                     if not _to_remove and not _to_add:
                         return True
@@ -1644,7 +1646,7 @@ class Folder(Store):
                     # To enforce lowercase-only tags and namespace overwrites, rewrite the full tag set.
                     cursor = db.connection.cursor()
                     cursor.execute("DELETE FROM tag WHERE hash = ?",
-                                   (hash,
+                                   (file_identifier,
                                     ))
                     for t in merged:
                         t = str(t).strip().lower()