update worker manager and worker to support plugin registry

cmdlet/file/add.py

@@ -42,6 +42,10 @@ from SYS.utils import sha256_file, unique_path, sanitize_filename
 
 # Canonical supported filetypes for all stores/cmdlets
 SUPPORTED_MEDIA_EXTENSIONS = ALL_SUPPORTED_EXTENSIONS
+_SCREENSHOT_TIME_SUFFIX_RE = re.compile(
+    r"^(?P<title>.+?)_(?P<label>(?:\d+h)?(?:\d+m)?\d+s)$",
+    flags=re.IGNORECASE,
+)
 
 
 class _CommandDependencies:
@@ -260,7 +264,7 @@ class Add_File(Cmdlet):
 
         # Initialize command-scope dependency context (caches Store/plugins)
         deps = _CommandDependencies(config)
-        storage_registry = deps.get_backend_registry()
+        storage_registry: Optional[BackendRegistry] = None
 
         source_arg = parsed.get("source")
         location = parsed.get("instance")
@@ -363,9 +367,10 @@ class Add_File(Cmdlet):
 
         # Determine if -instance targets a registered backend (vs a filesystem export path).
         is_storage_backend_location = False
-        if location:
+        if location and not plugin_name:
             try:
                 backend_registry_for_lookup = storage_registry or deps.get_backend_registry()
+                storage_registry = backend_registry_for_lookup
                 is_storage_backend_location = Add_File._resolve_backend_by_name(backend_registry_for_lookup, str(location)) is not None
             except Exception:
                 is_storage_backend_location = False
@@ -418,6 +423,8 @@ class Add_File(Cmdlet):
                 store_instance=storage_registry,
                 deps=deps,
             )
+            if plugin_storage_backend and storage_registry is None:
+                storage_registry = deps.get_backend_registry()
 
         effective_storage_backend_name = plugin_storage_backend or (
             str(location) if location and is_storage_backend_location else None
@@ -582,7 +589,7 @@ class Add_File(Cmdlet):
         )
 
         for idx, item in enumerate(items_to_process, 1):
-            pipe_obj = coerce_to_pipe_object(item, path_arg)
+            pipe_obj = coerce_to_pipe_object(item, source_arg)
 
             if source_url_arg:
                 try:
@@ -1525,16 +1532,17 @@ class Add_File(Cmdlet):
             return f"Pipeline error: invalid add-file arguments: {exc}"
 
         deps = _CommandDependencies(cfg)
-        storage_registry = deps.get_backend_registry()
+        storage_registry: Optional[BackendRegistry] = None
 
         location = parsed.get("instance")
         plugin_instance = parsed.get("instance")
         plugin_name = parsed.get("plugin")
 
         is_storage_backend_location = False
-        if location:
+        if location and not plugin_name:
             try:
                 backend_registry_for_lookup = storage_registry or deps.get_backend_registry()
+                storage_registry = backend_registry_for_lookup
                 is_storage_backend_location = Add_File._resolve_backend_by_name(
                     backend_registry_for_lookup,
                     str(location),
@@ -1615,7 +1623,7 @@ class Add_File(Cmdlet):
 
         explicit_instance = str(instance_name or "").strip() or None
         try:
-            backend_registry = store_instance if store_instance is not None else BackendRegistry(config)
+            backend_registry = store_instance if store_instance is not None else deps.get_backend_registry()
         except Exception:
             backend_registry = None
 
@@ -2234,6 +2242,40 @@ class Add_File(Cmdlet):
 
         url_from_result = Add_File._get_url(result, pipe_obj)
 
+        def _has_namespace_tag(tags: Sequence[str], namespace: str) -> bool:
+            namespace_text = str(namespace or "").strip().lower()
+            if not namespace_text:
+                return False
+            prefix = f"{namespace_text}:"
+            for tag in tags or []:
+                text = str(tag or "").strip().lower()
+                if text.startswith(prefix):
+                    return True
+            return False
+
+        def _extract_screenshot_time_title() -> tuple[Optional[str], Optional[str]]:
+            # MPV screenshot saves use <title>_<2m46s>.png as a temp filename.
+            # When we ingest that into a tag-capable backend, recover the clean title
+            # and surface the capture position as a namespace tag instead of baking it
+            # into the stored display title.
+            current_title = str(preferred_title or "").strip()
+            filename_title = str(media_path.stem or "").strip()
+            if current_title and current_title != filename_title:
+                return None, None
+            if not url_from_result:
+                return None, None
+            suffix = str(media_path.suffix or "").strip().lower()
+            if suffix not in {".png", ".jpg", ".jpeg", ".webp", ".gif", ".bmp", ".avif", ".mhtml"}:
+                return None, None
+            match = _SCREENSHOT_TIME_SUFFIX_RE.match(str(media_path.stem or "").strip())
+            if not match:
+                return None, None
+            title_text = str(match.group("title") or "").strip().replace("_", " ").strip()
+            label_text = str(match.group("label") or "").strip().lower()
+            if not title_text or not label_text:
+                return None, None
+            return title_text, label_text
+
         preferred_title = pipe_obj.title
         if not preferred_title:
             for t in tags_from_result:
@@ -2247,6 +2289,12 @@ class Add_File(Cmdlet):
             if preferred_title:
                 preferred_title = preferred_title.replace("_", " ").strip()
 
+        derived_screenshot_title, derived_time_tag = _extract_screenshot_time_title()
+        if derived_screenshot_title and (
+            not preferred_title or str(preferred_title or "").strip() == str(media_path.stem or "").strip()
+        ):
+            preferred_title = derived_screenshot_title
+
         store = getattr(pipe_obj, "store", None)
         _, sidecar_hash, sidecar_tags, sidecar_url = Add_File._load_sidecar_bundle(
             media_path, store, config
@@ -2279,6 +2327,9 @@ class Add_File(Cmdlet):
             case_sensitive=True
         )
 
+        if derived_time_tag and not _has_namespace_tag(merged_tags, "time") and not _has_namespace_tag(merged_tags, "timestamp"):
+            merged_tags.append(f"time:{derived_time_tag}")
+
         if preferred_title:
             merged_tags.append(f"title:{preferred_title}")