Promote cloud/SFTP backends and ship PySide6 GUI

- Move boto3, azure-storage-blob, dropbox, paramiko, and PySide6 out of
  optional extras and into the required runtime dependencies
- Auto-register every backend in build_default_registry, so FA_s3_*,
  FA_azure_blob_*, FA_dropbox_*, and FA_sftp_* work without opt-in
- Add automation_file.ui: PySide6 MainWindow with nine tabs (Local, HTTP,
  Drive, S3, Azure, Dropbox, SFTP, JSON actions, Servers), a persistent
  log panel, and QThreadPool-based ActionWorker for background dispatch
- Expose launch_ui via lazy facade __getattr__ and wire the `ui`
  subcommand on `python -m automation_file`; add main_ui.py for quick
  dev launches
- Update README, CLAUDE.md, Sphinx usage/architecture/api docs to
  reflect non-optional backends and the new GUI; add api/ui.rst
- Replace test_optional_backends with test_backends (asserts backends
  are present in the default registry) and add test_ui_smoke covering
  launcher, MainWindow, and every tab under the offscreen Qt platform
- Clean up unused # type: ignore comments on now-required SDKs and
  adjust ruff/mypy configs accordingly

Author: JE-Chen

CLAUDE.md

@@ -36,24 +36,32 @@ automation_file/
 │   │   ├── search_ops.py
 │   │   ├── share_ops.py
 │   │   └── upload_ops.py
-│   ├── s3/                     # Optional — pip install automation_file[s3]
-│   │   ├── client.py           # S3Client (lazy boto3 import)
+│   ├── s3/                     # S3 (boto3) — auto-registered in build_default_registry()
+│   │   ├── client.py           # S3Client
 │   │   ├── upload_ops.py
 │   │   ├── download_ops.py
 │   │   ├── delete_ops.py
 │   │   └── list_ops.py
-│   ├── azure_blob/             # Optional — pip install automation_file[azure]
+│   ├── azure_blob/             # Azure Blob — auto-registered in build_default_registry()
 │   │   └── {client,upload,download,delete,list}_ops.py
-│   ├── dropbox_api/            # Optional — pip install automation_file[dropbox]
+│   ├── dropbox_api/            # Dropbox — auto-registered in build_default_registry()
 │   │   └── {client,upload,download,delete,list}_ops.py
-│   └── sftp/                   # Optional — pip install automation_file[sftp]
+│   └── sftp/                   # SFTP (paramiko + RejectPolicy) — auto-registered in build_default_registry()
 │       └── {client,upload,download,delete,list}_ops.py
 ├── server/
 │   ├── tcp_server.py           # Loopback-only TCP server executing JSON actions (optional shared-secret auth)
 │   └── http_server.py          # Loopback-only HTTP server (POST /actions, optional Bearer auth)
 ├── project/
 │   ├── project_builder.py      # ProjectBuilder (Builder pattern)
 │   └── templates.py            # Scaffolding templates
+├── ui/                         # PySide6 GUI (required dep)
+│   ├── launcher.py             # launch_ui(argv) — boots QApplication + MainWindow
+│   ├── main_window.py          # MainWindow — tabbed control surface over every feature
+│   ├── worker.py               # ActionWorker(QRunnable) + _WorkerSignals
+│   ├── log_widget.py           # LogPanel — timestamped, read-only log stream
+│   └── tabs/                   # One tab per domain: local / http / drive / s3 /
+│                               #                    azure / dropbox / sftp /
+│                               #                    JSON actions / servers
 └── utils/
     └── file_discovery.py       # Recursive file listing by extension
 ```
@@ -73,7 +81,9 @@ automation_file/
 - `CallbackExecutor` — runs a registered trigger, then a user callback, sharing the executor's registry.
 - `PackageLoader` — imports a package by name and registers its top-level functions / classes / builtins as `<package>_<member>`.
 - `GoogleDriveClient` — wraps OAuth2 credential loading; exposes `service` lazily. `later_init(token_path, credentials_path)` bootstraps; `require_service()` raises if not initialised.
-- `S3Client` / `AzureBlobClient` / `DropboxClient` / `SFTPClient` — lazy-import singleton wrappers around the optional SDKs. Each exposes `later_init(...)` plus `close()` where relevant. Operations are registered via `register_<backend>_ops(registry)`.
+- `S3Client` / `AzureBlobClient` / `DropboxClient` / `SFTPClient` — singleton wrappers around the required SDKs. Each exposes `later_init(...)` plus `close()` where relevant. Their ops are auto-registered by `build_default_registry()`; `register_<backend>_ops(registry)` is still exported so callers can populate custom registries.
+- `MainWindow` — PySide6 tabbed control surface (`ui/main_window.py`). Nine tabs — Local, HTTP, Google Drive, S3, Azure Blob, Dropbox, SFTP, JSON actions, Servers — share a `LogPanel` and dispatch work through `ActionWorker(QRunnable)` on the global `QThreadPool`.
+- `launch_ui(argv=None)` — boots / reuses a `QApplication`, shows `MainWindow`, and returns the exec code. Exposed lazily on the facade via `__getattr__` so the Qt runtime isn't paid for by non-UI importers.
 - `TCPActionServer` — threaded TCP server that deserialises a JSON action list per connection. Defaults to loopback; optional `shared_secret` enforces `AUTH <secret>\n` prefix.
 - `HTTPActionServer` — `ThreadingHTTPServer` exposing `POST /actions`. Defaults to loopback; optional `shared_secret` enforces `Authorization: Bearer <secret>`.
 - `Quota` — frozen dataclass capping bytes and wall-clock seconds per action or block (`check_size`, `time_budget` context manager, `wraps` decorator). `0` disables each cap.
@@ -84,7 +94,7 @@ automation_file/
 
 - `main` branch: stable releases, publishes `automation_file` to PyPI (version in `stable.toml`).
 - `dev` branch: development, publishes `automation_file_dev` to PyPI (version in `dev.toml`).
-- Keep both TOMLs in sync when bumping. `[project.optional-dependencies]` (s3/azure/dropbox/sftp/dev) must also stay in sync.
+- Keep both TOMLs in sync when bumping. `dependencies` and `[project.optional-dependencies]` (`dev`) must also stay in sync. Backends (`boto3`, `azure-storage-blob`, `dropbox`, `paramiko`) and `PySide6` are first-class runtime deps — do not move them back under extras.
 - CI: GitHub Actions (Windows, Python 3.10 / 3.11 / 3.12) — one matrix workflow per branch: `.github/workflows/ci-dev.yml`, `.github/workflows/ci-stable.yml`.
 - CI steps: `lint` (ruff check + ruff format --check + mypy) → `pytest` with coverage → uploads `coverage.xml` as an artifact.
 - Stable branch additionally runs a `publish` job on push to `main`: builds the sdist + wheel, `twine check`, `twine upload` using `PYPI_API_TOKEN`, then `gh release create v<version> --generate-notes`.

README.md

@@ -3,16 +3,18 @@
 A modular automation framework for local file / directory / ZIP operations,
 SSRF-validated HTTP downloads, remote storage (Google Drive, S3, Azure Blob,
 Dropbox, SFTP), and JSON-driven action execution over embedded TCP / HTTP
-servers. All public functionality is re-exported from the top-level
-`automation_file` facade.
+servers. Ships with a PySide6 GUI that exposes every feature through tabs.
+All public functionality is re-exported from the top-level `automation_file`
+facade.
 
 - Local file / directory / ZIP operations with path traversal guard (`safe_join`)
 - Validated HTTP downloads with SSRF protections, retry, and size / time caps
 - Google Drive CRUD (upload, download, search, delete, share, folders)
-- Optional S3, Azure Blob, Dropbox, and SFTP backends behind extras
+- First-class S3, Azure Blob, Dropbox, and SFTP backends — installed by default
 - JSON action lists executed by a shared `ActionExecutor` — validate, dry-run, parallel
 - Loopback-first TCP **and** HTTP servers that accept JSON command batches with optional shared-secret auth
 - Reliability primitives: `retry_on_transient` decorator, `Quota` size / time budgets
+- PySide6 GUI (`python -m automation_file ui`) with a tab per backend plus a JSON-action runner
 - Rich CLI with one-shot subcommands plus legacy JSON-batch flags
 - Project scaffolding (`ProjectBuilder`) for executor-based automations
 
@@ -47,24 +49,32 @@ flowchart LR
         UrlVal[url_validator]
         Http[http_download]
         Drive["google_drive<br/>client + *_ops"]
-        S3["s3<br/>(optional)"]
-        Azure["azure_blob<br/>(optional)"]
-        Dropbox["dropbox_api<br/>(optional)"]
-        SFTP["sftp<br/>(optional)"]
+        S3["s3"]
+        Azure["azure_blob"]
+        Dropbox["dropbox_api"]
+        SFTP["sftp"]
     end
 
     subgraph Server["server"]
         TCP[TCPActionServer]
         HTTP[HTTPActionServer]
     end
 
+    subgraph UI["ui (PySide6)"]
+        Launcher[launch_ui]
+        MainWindow["MainWindow<br/>9-tab control surface"]
+    end
+
     subgraph Project["project / utils"]
         Builder[ProjectBuilder]
         Templates[templates]
         Discovery[file_discovery]
     end
 
     User --> Public
+    User --> Launcher
+    Launcher --> MainWindow
+    MainWindow --> Public
     Public --> Executor
     Public --> Callback
     Public --> Loader
@@ -109,20 +119,18 @@ through the same shared registry instance exposed as `executor.registry`.
 pip install automation_file
 ```
 
-Optional cloud backends (lazy-imported — install only what you need):
+A single install pulls in every backend (Google Drive, S3, Azure Blob, Dropbox,
+SFTP) and the PySide6 GUI — no extras required for day-to-day use.
 
 ```bash
-pip install "automation_file[s3]"        # boto3
-pip install "automation_file[azure]"     # azure-storage-blob
-pip install "automation_file[dropbox]"   # dropbox
-pip install "automation_file[sftp]"      # paramiko
-pip install "automation_file[dev]"       # ruff, mypy, pre-commit, pytest-cov
+pip install "automation_file[dev]"       # ruff, mypy, pre-commit, pytest-cov, build, twine
 ```
 
 Requirements:
 - Python 3.10+
-- `google-api-python-client`, `google-auth-oauthlib` (for Drive)
-- `requests`, `tqdm` (for HTTP download with progress)
+- Bundled dependencies: `google-api-python-client`, `google-auth-oauthlib`,
+  `requests`, `tqdm`, `boto3`, `azure-storage-blob`, `dropbox`, `paramiko`,
+  `PySide6`
 
 ## Usage
 
@@ -213,12 +221,14 @@ target = safe_join("/data/jobs", user_supplied_path)
 # raises PathTraversalException if the resolved path escapes /data/jobs.
 ```
 
-### Optional cloud backends
+### Cloud / SFTP backends
+Every backend is auto-registered by `build_default_registry()`, so `FA_s3_*`,
+`FA_azure_blob_*`, `FA_dropbox_*`, and `FA_sftp_*` actions are available out
+of the box — no separate `register_*_ops` call needed.
+
 ```python
-from automation_file import executor
-from automation_file.remote.s3 import register_s3_ops, s3_instance
+from automation_file import execute_action, s3_instance
 
-register_s3_ops(executor.registry)
 s3_instance.later_init(region_name="us-east-1")
 
 execute_action([
@@ -230,6 +240,19 @@ All backends (`s3`, `azure_blob`, `dropbox_api`, `sftp`) expose the same five
 operations: `upload_file`, `upload_dir`, `download_file`, `delete_*`, `list_*`.
 SFTP uses `paramiko.RejectPolicy` — unknown hosts are rejected, not auto-added.
 
+### GUI
+```bash
+python -m automation_file ui        # or: python main_ui.py
+```
+
+```python
+from automation_file import launch_ui
+launch_ui()
+```
+
+Tabs: Local, HTTP, Google Drive, S3, Azure Blob, Dropbox, SFTP, JSON actions,
+Servers. A persistent log panel at the bottom streams every result and error.
+
 ### Scaffold an executor-based project
 ```python
 from automation_file import create_project_dir
@@ -241,6 +264,7 @@ create_project_dir("my_workflow")
 
 ```bash
 # Subcommands (one-shot operations)
+python -m automation_file ui
 python -m automation_file zip ./src out.zip --dir
 python -m automation_file unzip out.zip ./restored
 python -m automation_file download https://example.com/file.bin file.bin

automation_file/__init__.py

@@ -4,8 +4,11 @@
 singleton is re-exported from here, so callers only ever need
 ``from automation_file import X``.
 """
+
 from __future__ import annotations
 
+from typing import TYPE_CHECKING, Any
+
 from automation_file.core.action_executor import (
     ActionExecutor,
     add_command_to_executor,
@@ -42,6 +45,16 @@
     zip_info,
 )
 from automation_file.project.project_builder import ProjectBuilder, create_project_dir
+from automation_file.remote.azure_blob import (
+    AzureBlobClient,
+    azure_blob_instance,
+    register_azure_blob_ops,
+)
+from automation_file.remote.dropbox_api import (
+    DropboxClient,
+    dropbox_instance,
+    register_dropbox_ops,
+)
 from automation_file.remote.google_drive.client import GoogleDriveClient, driver_instance
 from automation_file.remote.google_drive.delete_ops import drive_delete_file
 from automation_file.remote.google_drive.download_ops import (
@@ -66,6 +79,8 @@
     drive_upload_to_folder,
 )
 from automation_file.remote.http_download import download_file
+from automation_file.remote.s3 import S3Client, register_s3_ops, s3_instance
+from automation_file.remote.sftp import SFTPClient, register_sftp_ops, sftp_instance
 from automation_file.remote.url_validator import validate_http_url
 from automation_file.server.http_server import HTTPActionServer, start_http_action_server
 from automation_file.server.tcp_server import (
@@ -74,37 +89,101 @@
 )
 from automation_file.utils.file_discovery import get_dir_files_as_list
 
+if TYPE_CHECKING:
+    from automation_file.ui.launcher import launch_ui as launch_ui
+
 # Shared callback executor + package loader wired to the shared registry.
 callback_executor: CallbackExecutor = CallbackExecutor(executor.registry)
 package_manager: PackageLoader = PackageLoader(executor.registry)
 
+
+def __getattr__(name: str) -> Any:
+    if name == "launch_ui":
+        from automation_file.ui.launcher import launch_ui as _launch_ui
+
+        return _launch_ui
+    raise AttributeError(f"module 'automation_file' has no attribute {name!r}")
+
+
 __all__ = [
     # Core
-    "ActionExecutor", "ActionRegistry", "CallbackExecutor", "PackageLoader",
-    "Quota", "build_default_registry", "execute_action", "execute_action_parallel",
-    "execute_files", "validate_action", "retry_on_transient",
-    "add_command_to_executor", "read_action_json", "write_action_json",
-    "executor", "callback_executor", "package_manager",
+    "ActionExecutor",
+    "ActionRegistry",
+    "CallbackExecutor",
+    "PackageLoader",
+    "Quota",
+    "build_default_registry",
+    "execute_action",
+    "execute_action_parallel",
+    "execute_files",
+    "validate_action",
+    "retry_on_transient",
+    "add_command_to_executor",
+    "read_action_json",
+    "write_action_json",
+    "executor",
+    "callback_executor",
+    "package_manager",
     # Local
-    "copy_file", "rename_file", "remove_file", "copy_all_file_to_dir",
-    "copy_specify_extension_file", "create_file",
-    "copy_dir", "create_dir", "remove_dir_tree", "rename_dir",
-    "zip_dir", "zip_file", "zip_info", "zip_file_info", "set_zip_password",
-    "unzip_file", "read_zip_file", "unzip_all",
-    "safe_join", "is_within",
+    "copy_file",
+    "rename_file",
+    "remove_file",
+    "copy_all_file_to_dir",
+    "copy_specify_extension_file",
+    "create_file",
+    "copy_dir",
+    "create_dir",
+    "remove_dir_tree",
+    "rename_dir",
+    "zip_dir",
+    "zip_file",
+    "zip_info",
+    "zip_file_info",
+    "set_zip_password",
+    "unzip_file",
+    "read_zip_file",
+    "unzip_all",
+    "safe_join",
+    "is_within",
     # Remote
-    "download_file", "validate_http_url",
-    "GoogleDriveClient", "driver_instance",
-    "drive_search_all_file", "drive_search_field", "drive_search_file_mimetype",
-    "drive_upload_dir_to_folder", "drive_upload_to_folder",
-    "drive_upload_dir_to_drive", "drive_upload_to_drive",
+    "download_file",
+    "validate_http_url",
+    "GoogleDriveClient",
+    "driver_instance",
+    "drive_search_all_file",
+    "drive_search_field",
+    "drive_search_file_mimetype",
+    "drive_upload_dir_to_folder",
+    "drive_upload_to_folder",
+    "drive_upload_dir_to_drive",
+    "drive_upload_to_drive",
     "drive_add_folder",
-    "drive_share_file_to_anyone", "drive_share_file_to_domain", "drive_share_file_to_user",
+    "drive_share_file_to_anyone",
+    "drive_share_file_to_domain",
+    "drive_share_file_to_user",
     "drive_delete_file",
-    "drive_download_file", "drive_download_file_from_folder",
+    "drive_download_file",
+    "drive_download_file_from_folder",
+    "S3Client",
+    "s3_instance",
+    "register_s3_ops",
+    "AzureBlobClient",
+    "azure_blob_instance",
+    "register_azure_blob_ops",
+    "DropboxClient",
+    "dropbox_instance",
+    "register_dropbox_ops",
+    "SFTPClient",
+    "sftp_instance",
+    "register_sftp_ops",
     # Server / Project / Utils
-    "TCPActionServer", "start_autocontrol_socket_server",
-    "HTTPActionServer", "start_http_action_server",
-    "ProjectBuilder", "create_project_dir",
+    "TCPActionServer",
+    "start_autocontrol_socket_server",
+    "HTTPActionServer",
+    "start_http_action_server",
+    "ProjectBuilder",
+    "create_project_dir",
     "get_dir_files_as_list",
+    # UI (lazy-loaded)
+    "launch_ui",
 ]