fix: add missing modules to package (session, telemetry, policy, cli)

v0.5.0 PyPI package was broken — `import venturalitica` raised
ImportError because session.py, telemetry.py, and policy.py were
never committed. Also replaces the old monolithic cli.py with the
cli/ package (auth, dashboard, sync, transfer subcommands).

Bumps version to 0.5.1.

Author: morganrcu

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "venturalitica"
-version = "0.5.0"
+version = "0.5.1"
 description = "Frictionless Governance for AI. Enforce policies in your ML training with one line of code."
 requires-python = ">=3.11"
 readme = "README.md"

src/venturalitica/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "0.5.0"
+__version__ = "0.5.1"
 
 from .api import (
     enforce,
@@ -15,3 +15,36 @@
     "quickstart",
     "PolicyManager",
 ]
+
+
+def _send_first_import():
+    """Fire a one-time sdk_first_import event (guarded by analytics.json flag)."""
+    try:
+        import json
+        from pathlib import Path
+        config_path = Path.home() / ".venturalitica" / "analytics.json"
+        if config_path.exists():
+            with open(config_path, "r") as f:
+                data = json.load(f)
+            if data.get("first_import_sent"):
+                return
+
+        from .telemetry import telemetry
+        telemetry.capture("sdk_first_import", {})
+
+        # Mark as sent
+        config_path.parent.mkdir(parents=True, exist_ok=True)
+        existing = {}
+        if config_path.exists():
+            try:
+                with open(config_path, "r") as f:
+                    existing = json.load(f)
+            except Exception:
+                pass
+        existing["first_import_sent"] = True
+        with open(config_path, "w") as f:
+            json.dump(existing, f)
+    except Exception:
+        pass  # Never crash the import
+
+_send_first_import()

src/venturalitica/cli.py

@@ -0,0 +1,16 @@
+# Import submodules to register commands
+from . import (
+    auth as auth,
+)
+from . import (
+    dashboard as dashboard,
+)
+from . import (
+    sync as sync,
+)
+from . import (
+    transfer as transfer,
+)
+from .common import app
+
+__all__ = ["app"]

src/venturalitica/cli/__init__.py

@@ -0,0 +1,36 @@
+import json
+
+import requests
+import typer
+
+from ..telemetry import track_command
+from .common import SAAS_URL, app, console, get_config_path
+
+
+@app.command()
+@track_command("login")
+def login(system_id: str):
+    """
+    Authenticates with the Venturalítica SaaS for a specific AI System.
+    """
+    console.print(f"[bold green]🔐 Authenticating for system:[/bold green] {system_id}")
+
+    try:
+        response = requests.post(
+            f"{SAAS_URL}/api/cli-auth", json={"aiSystemId": system_id}
+        )
+        response.raise_for_status()
+        data = response.json()
+
+        creds_path = get_config_path("credentials.json")
+        with open(creds_path, "w") as f:
+            json.dump(data, f)
+
+        console.print(
+            f"[bold green]✓ Login successful for {data.get('aiSystemName')}[/bold green]"
+        )
+        console.print(f"Key stored in: {creds_path}")
+
+    except Exception as e:
+        console.print(f"[bold red]Login failed:[/bold red] {e}")
+        raise typer.Exit(code=1)

src/venturalitica/cli/auth.py

@@ -0,0 +1,25 @@
+import os
+
+import typer
+from rich.console import Console
+
+app = typer.Typer()
+console = Console()
+
+SAAS_URL = os.getenv("VENTURALITICA_SAAS_URL", "http://localhost:3000")
+
+def get_config_path(filename: str) -> str:
+    path = os.path.expanduser(f"~/.venturalitica/{filename}")
+    dir_path = os.path.dirname(path)
+    if not os.path.exists(dir_path):
+        os.makedirs(dir_path, exist_ok=True)
+        # First Run Detection
+        if "VENTURALITICA_NO_ANALYTICS" not in os.environ:
+             console.print(
+                "[bold blue]ℹ Telemetry Notice[/bold blue]\n"
+                "[dim]Venturalítica collects anonymous technical metrics to improve this tool.\n"
+                "We NEVER collect your model data, datasets, or personal identifiers.\n"
+                "To opt-out, set [/dim][cyan]VENTURALITICA_NO_ANALYTICS=1[/cyan][dim].\n"
+                "Read our transparent privacy policy at: [link=https://venturalitica.ai/telemetry]https://venturalitica.ai/telemetry[/link][/dim]\n"
+             )
+    return path