Introduce EXPERIMENTAL_DF flag to gate cloud features (#531)

* Add EXPERIMENTAL_DF flag around cloud features

* Remove duplicate comment

* Update deepfabric/auth.py

Resolve blank lines

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

* Update deepfabric/evaluation/reporters/cloud_reporter.py

Simplify if/else block to boolean expression

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

* Lint checked

---------

Co-authored-by: Stephen Parkinson <scp@Stephens-MacBook-Pro.local>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Author: 3 people

deepfabric/auth.py

@@ -10,8 +10,10 @@
 import httpx
 
 from .tui import get_tui
+from .utils import get_bool_env
 
 DEFAULT_API_URL = os.getenv("DEEPFABRIC_API_URL", "https://api.deepfabric.dev")
+
 CONFIG_DIR = Path.home() / ".deepfabric"
 CONFIG_FILE = CONFIG_DIR / "config.json"
 
@@ -75,8 +77,14 @@ def prompt_cloud_signup(api_url: str = DEFAULT_API_URL) -> bool:
     Returns:
         True if user successfully authenticated, False otherwise
     """
+    if not get_bool_env("EXPERIMENTAL_DF"):
+        return False
+
     tui = get_tui()
 
+
+
+
     tui.console.print("")
     tui.info("DeepFabric Cloud can save and track your evaluations")
     tui.info("   - Compare models across runs")

deepfabric/cli.py

@@ -23,6 +23,7 @@
 from .topic_model import TopicModel
 from .tui import configure_tui, get_tui
 from .update_checker import check_for_updates
+from .utils import get_bool_env
 from .validation import show_validation_success, validate_path_requirements
 
 OverrideValue = str | int | float | bool | None
@@ -1097,7 +1098,11 @@ def evaluate(
 
 
 # Register the auth command group
-cli.add_command(auth_group)
+# EXPERIMENTAL: Only enable cloud features if explicitly opted in
+if get_bool_env("EXPERIMENTAL_DF"):
+    cli.add_command(auth_group)
+
+
 
 
 @cli.command("import-tools")

deepfabric/evaluation/reporters/cloud_reporter.py

@@ -13,6 +13,7 @@
 
 from rich.console import Console
 
+from ...utils import get_bool_env
 from .base import BaseReporter
 
 if TYPE_CHECKING:
@@ -67,11 +68,15 @@ def __init__(self, config: dict | None = None):
         # Get project ID from config
         self.project_id = config.get("project_id") if config else None
 
-        # Enable cloud reporting if authenticated
-        self.enabled = (
+        # Enable cloud reporting if authenticated AND experimental flag is set
+        is_experimental = get_bool_env("EXPERIMENTAL_DF")
+        self.enabled = is_experimental and (
             config.get("enabled", bool(self.auth_token)) if config else bool(self.auth_token)
         )
 
+
+
+
         # Generate unique run ID for this evaluation
         self.run_id = None  # Will be set when creating run
         self.evaluation_run_id = None  # Backend run ID

deepfabric/utils.py

@@ -1,6 +1,7 @@
 import ast
 import asyncio
 import json
+import os
 import re
 
 VALIDATION_ERROR_INDICATORS = [
@@ -147,4 +148,18 @@ def read_topic_tree_from_jsonl(file_path: str) -> list[dict]:
     with open(file_path) as file:
         for line in file:
             topic_tree.append(json.loads(line.strip()))
+
     return topic_tree
+
+
+def get_bool_env(key: str, default: bool = False) -> bool:
+    """Get a boolean environment variable.
+
+    Supports: '1', 'true', 'yes', 'on' (case-insensitive) as True.
+    Everything else is False unless default is True and key is missing.
+    """
+    val = os.getenv(key)
+    if val is None:
+        return default
+    return val.lower() in ("1", "true", "yes", "on")
+