lyceum-cli 1.1.7__tar.gz → 1.2.2__tar.gz

{lyceum_cli-1.1.7 → lyceum_cli-1.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lyceum-cli
-Version: 1.1.7
+Version: 1.2.2
 Summary: Command-line interface for Lyceum Cloud
 Author-email: Lyceum <support@lyceum.technology>
 License: MIT
@@ -13,20 +13,19 @@ Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development
 Classifier: Topic :: System :: Distributed Computing
 Classifier: Topic :: Utilities
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
-Requires-Dist: typer>=0.12.0
-Requires-Dist: rich>=13.0.0
-Requires-Dist: httpx>=0.24.0
-Requires-Dist: PyJWT>=2.8.0
-Requires-Dist: boto3>=1.35.0
+Requires-Dist: typer==0.24.1
+Requires-Dist: rich==14.3.3
+Requires-Dist: httpx==0.28.1
+Requires-Dist: PyJWT==2.13.0
+Requires-Dist: boto3==1.42.62
 
 # Lyceum CLI
 

lyceum_cli-1.2.2/lyceum/_version.py

@@ -0,0 +1,10 @@
+"""The version lyceum-cli publishes under.
+
+NOTE: This package deliberately has no __init__.py. 'lyceum' is a namespace
+shared with lyceum-shared-models and lyceum-neph. An __init__.py here would
+shadow theirs and break 'lyceum.shared_models' and 'lyceum.neph'. That is why
+__version__ lives in this module. A future refactor could move these modules
+under lyceum/cli/, claiming one subpackage the way the other two do.
+"""
+
+__version__ = "1.2.2"

{lyceum_cli-1.1.7 → lyceum_cli-1.2.2}/lyceum/external/auth/keys.py

@@ -62,6 +62,7 @@ def create_key(
     console.print(f"[bold yellow]{res['api_key']}[/bold yellow]")
     console.print()
     console.print("[dim]This is the only time the key will be displayed. Copy it now.[/dim]")
+    console.print("[dim]This key follows --org and the active org; without either it acts as your personal org.[/dim]")
 
 
 @keys_app.command("revoke")

{lyceum_cli-1.1.7 → lyceum_cli-1.2.2}/lyceum/external/auth/login.py

@@ -7,6 +7,7 @@ import threading
 import time
 import webbrowser
 from http.server import BaseHTTPRequestHandler, HTTPServer
+from typing import Any
 from urllib.parse import parse_qs, urlparse
 
 import httpx
@@ -14,6 +15,7 @@ import typer
 from rich.console import Console
 
 from ...shared.config import config
+from ...shared.orgs import explain, resolve_org_context
 from .keys import keys_app
 
 console = Console()
@@ -22,14 +24,14 @@ auth_app = typer.Typer(name="auth", help="Authentication commands")
 auth_app.add_typer(keys_app, name="keys")
 
 # Global state for the OAuth callback server
-callback_result = {"token": None, "error": None, "received": False}
+callback_result: dict[str, Any] = {"token": None, "error": None, "received": False}
 
 # (svg path, tailwind color) per page kind
 _PAGE_ICONS = {
     "success": ("M5 13l4 4L19 7", "green"),
     "error": ("M6 18L18 6M6 6l12 12", "red"),
     "warning": (
-        "M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-2.5L13.732 4c-.77-.833-1.732-.833-2.5 0L3.268 16c-.77.833.192 2.5 1.732 2.5z",
+        "M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-2.5L13.732 4c-.77-.833-1.732-.833-2.5 0L3.268 16c-.77.833.192 2.5 1.732 2.5z",  # noqa: E501
         "yellow",
     ),
 }
@@ -94,7 +96,9 @@ class CallbackHandler(BaseHTTPRequestHandler):
                 self._send_page(
                     404,
                     _render_callback_page(
-                        "warning", "Page Not Found", "Page Not Found",
+                        "warning",
+                        "Page Not Found",
+                        "Page Not Found",
                         "<p>The requested page could not be found.</p>",
                     ),
                 )
@@ -111,7 +115,9 @@ class CallbackHandler(BaseHTTPRequestHandler):
                 self._send_page(
                     200,
                     _render_callback_page(
-                        "success", "Authentication Success", "Authentication Successful!",
+                        "success",
+                        "Authentication Success",
+                        "Authentication Successful!",
                         "<p class='text-lg'>Welcome to Lyceum</p>"
                         "<p>You can now close this browser tab and return to the CLI.</p>",
                         auto_close=True,
@@ -125,8 +131,10 @@ class CallbackHandler(BaseHTTPRequestHandler):
                 self._send_page(
                     400,
                     _render_callback_page(
-                        "error", "Authentication Error", "Authentication Failed",
-                        f"<div class='bg-red-50 border border-red-200 text-red-700 px-4 py-3 rounded-md'><p class='text-sm'>{html.escape(error)}</p></div>"
+                        "error",
+                        "Authentication Error",
+                        "Authentication Failed",
+                        f"<div class='bg-red-50 border border-red-200 text-red-700 px-4 py-3 rounded-md'><p class='text-sm'>{html.escape(error)}</p></div>"  # noqa: E501
                         "<p>Please try again or contact support if the issue persists.</p>",
                     ),
                 )
@@ -137,7 +145,9 @@ class CallbackHandler(BaseHTTPRequestHandler):
                 self._send_page(
                     400,
                     _render_callback_page(
-                        "warning", "Invalid Parameters", "Invalid Parameters",
+                        "warning",
+                        "Invalid Parameters",
+                        "Invalid Parameters",
                         "<p>The authentication callback received invalid parameters.</p>",
                     ),
                 )
@@ -148,8 +158,10 @@ class CallbackHandler(BaseHTTPRequestHandler):
             self._send_page(
                 500,
                 _render_callback_page(
-                    "error", "Server Error", "Server Error",
-                    f"<div class='bg-red-50 border border-red-200 text-red-700 px-4 py-3 rounded-md'><p class='text-sm'>{html.escape(str(e))}</p></div>",
+                    "error",
+                    "Server Error",
+                    "Server Error",
+                    f"<div class='bg-red-50 border border-red-200 text-red-700 px-4 py-3 rounded-md'><p class='text-sm'>{html.escape(str(e))}</p></div>",  # noqa: E501,
                 ),
             )
 
@@ -176,17 +188,16 @@ def _auto_pin_active_org(client):
         return
 
     if not sys.stdin.isatty():
-        console.print(
-            "[dim]You belong to multiple orgs. Pick one with 'lyceum org use <slug>'.[/dim]"
-        )
+        console.print("[dim]You belong to multiple orgs. Pick one with 'lyceum org use <slug>'.[/dim]")
         return
 
     console.print()
     console.print("[bold]You belong to multiple orgs. Pick one to make active:[/bold]")
     for i, org in enumerate(orgs, start=1):
         role = org.get("role", "")
-        console.print(f"  [cyan]{i}[/cyan]. {org['name']} ([dim]{org['slug']}[/dim]) — {role}")
-    console.print("  [cyan]0[/cyan]. [dim]Skip — fall back to default org[/dim]")
+        kind = "personal" if org.get("is_default") else "team"
+        console.print(f"  [cyan]{i}[/cyan]. {org['name']} ([dim]{org['slug']}[/dim]) — {kind}, {role}")
+    console.print("  [cyan]0[/cyan]. [dim]Skip — use your personal org[/dim]")
 
     while True:
         raw = typer.prompt("Selection", default="0")
@@ -207,10 +218,20 @@ def _auto_pin_active_org(client):
         console.print(f"[yellow]Pick 0–{len(orgs)}.[/yellow]")
 
 
+def _pin_key_org():
+    """An org key acts as its own org; make the active org say so."""
+    ctx = resolve_org_context()
+    if ctx.is_key_scoped and ctx.slug:
+        config.active_org_slug = ctx.slug
+        config.save()
+    for line in explain(ctx):
+        console.print(line)
+
+
 def get_available_port():
     """Find an available port for the callback server"""
     with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
-        s.bind(('', 0))
+        s.bind(("", 0))
         s.listen(1)
         port = s.getsockname()[1]
     return port
@@ -220,12 +241,8 @@ def get_available_port():
 def login(
     base_url: str | None = typer.Option(None, "--url", help="API base URL (for development)"),
     dashboard_url: str | None = typer.Option(None, "--dashboard", help="Dashboard URL (for development)"),
-    manual: bool = typer.Option(
-        False, "--manual", help="Use manual API key login instead of browser"
-    ),
-    api_key: str | None = typer.Option(
-        None, "--api-key", "-k", help="API key for manual login"
-    ),
+    manual: bool = typer.Option(False, "--manual", help="Use manual API key login instead of browser"),
+    api_key: str | None = typer.Option(None, "--api-key", "-k", help="API key for manual login"),
 ):
     """Login to Lyceum via browser authentication"""
     global callback_result
@@ -255,6 +272,7 @@ def login(
             else:
                 console.print(f"[red]Authentication failed: HTTP {response.status_code}[/red]")
                 raise typer.Exit(1)
+            _pin_key_org()
         except typer.Exit:
             raise
         except Exception as e:
@@ -275,7 +293,7 @@ def login(
 
         # Start callback server
         callback_port = get_available_port()
-        callback_server = HTTPServer(('localhost', callback_port), CallbackHandler)
+        callback_server = HTTPServer(("localhost", callback_port), CallbackHandler)
 
         console.print(f"[dim]Starting callback server on port {callback_port}...[/dim]")
 
@@ -366,6 +384,7 @@ def login(
 def logout():
     """Logout and remove stored credentials"""
     from ...shared.config import CONFIG_FILE
+
     if CONFIG_FILE.exists():
         CONFIG_FILE.unlink()
     console.print("[green]Logged out successfully![/green]")
@@ -375,6 +394,7 @@ def logout():
 def status():
     """Show current configuration and authentication status"""
     from ...shared.config import CONFIG_FILE
+
     console.print(f"[dim]Config file: {CONFIG_FILE}[/dim]")
     console.print(f"[dim]Base URL: {config.base_url}[/dim]")
 
@@ -385,11 +405,8 @@ def status():
     console.print("[green]Authenticated[/green]")
     console.print(f"[dim]API Key: {config.api_key[:8]}...[/dim]")
 
-    active_org = config.get_active_org_slug()
-    if active_org:
-        console.print(f"[dim]Active org: {active_org}[/dim]")
-    else:
-        console.print("[dim]Active org: (none — falls back to default)[/dim]")
+    for line in explain(resolve_org_context()):
+        console.print(line)
 
     # Test connection
     try:

{lyceum_cli-1.1.7 → lyceum_cli-1.2.2}/lyceum/external/compute/execution/config.py

@@ -3,15 +3,14 @@
 import importlib.metadata as im
 import json
 from pathlib import Path
-from typing import Optional
 
 import typer
 from rich.console import Console
 
 from ....shared.imports import (
+    find_imports_in_file,
     is_stdlib_module_by_name,
     should_skip_path,
-    find_imports_in_file,
 )
 
 console = Console()
@@ -38,7 +37,7 @@ def get_package_name(module_name: str) -> str:
     return PACKAGE_NAME_MAP.get(top_level, top_level)
 
 
-def get_installed_version(package_name: str) -> Optional[str]:
+def get_installed_version(package_name: str) -> str | None:
     """Get installed version of a package."""
     try:
         return im.version(package_name)
@@ -99,15 +98,22 @@ def parse_requirements_file(req_file: Path) -> list[str]:
 
 def extract_package_name(dep: str) -> str:
     """Extract package name from a dependency string."""
-    return dep.split("==")[0].split(">=")[0].split("<=")[0].split("<")[0].split(">")[0].split("[")[0].split("~=")[0].lower()
+    return (
+        dep.split("==")[0]
+        .split(">=")[0]
+        .split("<=")[0]
+        .split("<")[0]
+        .split(">")[0]
+        .split("[")[0]
+        .split("~=")[0]
+        .lower()
+    )
 
 
 @config_app.command("init")
 def init_config(
     workspace: Path = typer.Argument(".", help="Workspace directory to analyze"),
-    requirements: Path | None = typer.Option(
-        None, "--requirements", "-r", help="Path to requirements.txt"
-    ),
+    requirements: Path | None = typer.Option(None, "--requirements", "-r", help="Path to requirements.txt"),
     force: bool = typer.Option(False, "--force", "-f", help="Overwrite existing config"),
 ):
     """Initialize workspace configuration for Lyceum Cloud execution.
@@ -161,10 +167,7 @@ def init_config(
 
     # Filter to external dependencies
     local_package_names = {Path(p).parts[0] if "/" in p else p for p in local_packages.keys()}
-    external_deps = {
-        imp for imp in all_imports
-        if not is_stdlib_module_by_name(imp) and imp not in local_package_names
-    }
+    external_deps = {imp for imp in all_imports if not is_stdlib_module_by_name(imp) and imp not in local_package_names}
     console.print(f"[dim]Found {len(external_deps)} external dependencies from imports[/dim]")
 
     # Parse requirements.txt
@@ -249,9 +252,7 @@ def show_config(
 @config_app.command("refresh")
 def refresh_config(
     workspace: Path = typer.Argument(".", help="Workspace directory"),
-    requirements: Path | None = typer.Option(
-        None, "--requirements", "-r", help="Path to requirements.txt"
-    ),
+    requirements: Path | None = typer.Option(None, "--requirements", "-r", help="Path to requirements.txt"),
 ):
     """Refresh workspace configuration (re-scans the workspace)."""
     init_config(workspace=workspace, requirements=requirements, force=True)

{lyceum_cli-1.1.7 → lyceum_cli-1.2.2}/lyceum/external/compute/execution/docker.py

@@ -1,10 +1,7 @@
-"""
-Docker execution commands
-"""
+"""Docker execution commands"""
 
 import json
 import shlex
-from typing import Optional
 
 import httpx
 import typer
@@ -28,37 +25,25 @@ docker_app = typer.Typer(name="docker", help="Docker execution commands")
 @docker_app.command("run")
 def run_docker(
     image: str = typer.Argument(..., help="Docker image to run"),
-    machine_type: str = typer.Option(
-        "gpu.l40s", "--machine", "-m", help="Machine type (gpu.l40s, a100, h100, etc.)"
-    ),
-    timeout: int = typer.Option(
-        300, "--timeout", "-t", help="Execution timeout in seconds"
-    ),
-    file_name: Optional[str] = typer.Option(
-        None, "--file-name", "-f", help="Name for the execution"
-    ),
-    run_name: Optional[str] = RUN_NAME_OPTION,
-    label: Optional[list[str]] = LABEL_OPTION,
-    metadata: Optional[list[str]] = METADATA_OPTION,
-    command: Optional[str] = typer.Option(
+    machine_type: str = typer.Option("gpu.l40s", "--machine", "-m", help="Machine type (gpu.l40s, a100, h100, etc.)"),
+    timeout: int = typer.Option(300, "--timeout", "-t", help="Execution timeout in seconds"),
+    file_name: str | None = typer.Option(None, "--file-name", "-f", help="Name for the execution"),
+    run_name: str | None = RUN_NAME_OPTION,
+    label: list[str] | None = LABEL_OPTION,
+    metadata: list[str] | None = METADATA_OPTION,
+    command: str | None = typer.Option(
         None,
         "--command",
         "-c",
         help="Command to run in container (e.g., 'python app.py')",
     ),
-    env: Optional[list[str]] = typer.Option(
-        None, "--env", "-e", help="Environment variables (e.g., KEY=value)"
-    ),
-    detach: bool = typer.Option(
-        False, "--detach", "-d", help="Run container in background and print execution ID"
-    ),
-    callback_url: Optional[str] = typer.Option(
-        None, "--callback", help="Webhook URL for completion notification"
-    ),
-    registry_creds: Optional[str] = typer.Option(
+    env: list[str] | None = typer.Option(None, "--env", "-e", help="Environment variables (e.g., KEY=value)"),
+    detach: bool = typer.Option(False, "--detach", "-d", help="Run container in background and print execution ID"),
+    callback_url: str | None = typer.Option(None, "--callback", help="Webhook URL for completion notification"),
+    registry_creds: str | None = typer.Option(
         None, "--registry-creds", help="Docker registry credentials as JSON string"
     ),
-    registry_type: Optional[str] = typer.Option(
+    registry_type: str | None = typer.Option(
         None, "--registry-type", help="Registry credential type: basic, aws, etc."
     ),
     s3_mount: bool = typer.Option(
@@ -67,7 +52,7 @@ def run_docker(
     s3_mount_path: str = typer.Option(
         "/mnt/s3", "--s3-mount-path", help="Path where S3 bucket will be mounted inside the container"
     ),
-    graceful_timeout: Optional[int] = typer.Option(
+    graceful_timeout: int | None = typer.Option(
         None, "--graceful-timeout", help="Seconds to wait for graceful shutdown on cancel (default: 10)"
     ),
 ):
@@ -98,9 +83,7 @@ def run_docker(
                     docker_env[key] = value
                 else:
                     status.stop()
-                    console.print(
-                        f"[yellow]Warning: Ignoring invalid env var format: {env_var}[/yellow]"
-                    )
+                    console.print(f"[yellow]Warning: Ignoring invalid env var format: {env_var}[/yellow]")
                     status.start()
 
         # Parse registry credentials
@@ -110,19 +93,13 @@ def run_docker(
                 registry_credentials = json.loads(registry_creds)
             except json.JSONDecodeError:
                 status.stop()
-                console.print(
-                    "[red]Error: Invalid JSON format for registry credentials[/red]"
-                )
+                console.print("[red]Error: Invalid JSON format for registry credentials[/red]")
                 raise typer.Exit(1)
 
         # Validate registry credentials and type
-        if (registry_creds and not registry_type) or (
-            registry_type and not registry_creds
-        ):
+        if (registry_creds and not registry_type) or (registry_type and not registry_creds):
             status.stop()
-            console.print(
-                "[red]Error: Both --registry-creds and --registry-type must be provided together[/red]"
-            )
+            console.print("[red]Error: Both --registry-creds and --registry-type must be provided together[/red]")
             raise typer.Exit(1)
 
         # Validate S3 mount options
@@ -194,9 +171,7 @@ def run_docker(
             status.stop()
             console.print(f"[red]Error: HTTP {response.status_code}[/red]")
             if response.status_code == 401:
-                console.print(
-                    "[red]Authentication failed. Your session may have expired.[/red]"
-                )
+                console.print("[red]Authentication failed. Your session may have expired.[/red]")
                 console.print("[yellow]Run 'lyceum auth login' to re-authenticate.[/yellow]")
             elif response.content:
                 console.print(f"[red]{response.content.decode()}[/red]")
@@ -277,32 +252,33 @@ def show_registry_examples():
 
     console.print("[bold]1. Docker Hub (basic)[/bold]")
     console.print("Type: [green]basic[/green]")
-    console.print(
-        'Credentials: [yellow]\'{"username": "myuser", "password": "mypassword"}\'[/yellow]\n'
-    )
+    console.print('Credentials: [yellow]\'{"username": "myuser", "password": "mypassword"}\'[/yellow]\n')
 
     console.print("[bold]2. AWS ECR (aws)[/bold]")
     console.print("Type: [green]aws[/green]")
     console.print(
-        'Credentials: [yellow]\'{"region": "us-west-2", "aws_access_key_id": "AKIAI...", "aws_secret_access_key": "wJalrX...", "session_token": "optional..."}\'[/yellow]\n'
+        'Credentials: [yellow]\'{"region": "us-west-2", "aws_access_key_id": "AKIAI...", '
+        '"aws_secret_access_key": "wJalrX...", "session_token": "optional..."}\'[/yellow]\n'
     )
 
     console.print("[bold]3. Private Registry (basic)[/bold]")
     console.print("Type: [green]basic[/green]")
-    console.print(
-        'Credentials: [yellow]\'{"username": "admin", "password": "secret"}\'[/yellow]\n'
-    )
+    console.print('Credentials: [yellow]\'{"username": "admin", "password": "secret"}\'[/yellow]\n')
 
     console.print("[bold]Example Commands:[/bold]")
     console.print("# Docker Hub:")
     console.print(
-        "[dim]lyceum docker run myuser/myapp:latest --registry-type basic --registry-creds '{\"username\": \"myuser\", \"password\": \"mytoken\"}'[/dim]"
+        "[dim]lyceum docker run myuser/myapp:latest --registry-type basic "
+        '--registry-creds \'{"username": "myuser", "password": "mytoken"}\'[/dim]'
     )
     console.print("\n# AWS ECR:")
     console.print(
-        "[dim]lyceum docker run 123456789012.dkr.ecr.us-west-2.amazonaws.com/myapp:latest --registry-type aws --registry-creds '{\"region\": \"us-west-2\", \"aws_access_key_id\": \"AKIAI...\", \"aws_secret_access_key\": \"wJalrX...\"}'[/dim]"
+        "[dim]lyceum docker run 123456789012.dkr.ecr.us-west-2.amazonaws.com/myapp:latest "
+        '--registry-type aws --registry-creds \'{"region": "us-west-2", "aws_access_key_id": "AKIAI...", '
+        '"aws_secret_access_key": "wJalrX..."}\'[/dim]'
     )
     console.print("\n# Private Registry:")
     console.print(
-        "[dim]lyceum docker run myregistry.com/myapp:latest --registry-type basic --registry-creds '{\"username\": \"admin\", \"password\": \"secret\"}'[/dim]"
+        "[dim]lyceum docker run myregistry.com/myapp:latest --registry-type basic "
+        '--registry-creds \'{"username": "admin", "password": "secret"}\'[/dim]'
     )

{lyceum_cli-1.1.7 → lyceum_cli-1.2.2}/lyceum/external/compute/execution/docker_compose.py

@@ -1,10 +1,7 @@
-"""
-Docker Compose execution commands
-"""
+"""Docker Compose execution commands"""
 
 import json
 from pathlib import Path
-from typing import Optional
 
 import httpx
 import typer
@@ -28,38 +25,23 @@ compose_app = typer.Typer(name="compose", help="Docker Compose execution command
 @compose_app.command("run")
 def run_docker_compose(
     compose_file: Path = typer.Argument(
-        ...,
-        help="Path to docker-compose.yml file",
-        exists=True,
-        file_okay=True,
-        dir_okay=False,
-        readable=True
+        ..., help="Path to docker-compose.yml file", exists=True, file_okay=True, dir_okay=False, readable=True
     ),
-    machine_type: str = typer.Option(
-        "gpu.l40s", "--machine", "-m", help="Machine type (gpu.l40s, a100, h100, etc.)"
-    ),
-    timeout: int = typer.Option(
-        300, "--timeout", "-t", help="Execution timeout in seconds"
-    ),
-    file_name: Optional[str] = typer.Option(
-        None, "--file-name", "-f", help="Name for the execution"
-    ),
-    run_name: Optional[str] = RUN_NAME_OPTION,
-    label: Optional[list[str]] = LABEL_OPTION,
-    metadata: Optional[list[str]] = METADATA_OPTION,
-    detach: bool = typer.Option(
-        False, "--detach", "-d", help="Run in background and print execution ID"
-    ),
-    callback_url: Optional[str] = typer.Option(
-        None, "--callback", help="Webhook URL for completion notification"
-    ),
-    registry_creds: Optional[str] = typer.Option(
+    machine_type: str = typer.Option("gpu.l40s", "--machine", "-m", help="Machine type (gpu.l40s, a100, h100, etc.)"),
+    timeout: int = typer.Option(300, "--timeout", "-t", help="Execution timeout in seconds"),
+    file_name: str | None = typer.Option(None, "--file-name", "-f", help="Name for the execution"),
+    run_name: str | None = RUN_NAME_OPTION,
+    label: list[str] | None = LABEL_OPTION,
+    metadata: list[str] | None = METADATA_OPTION,
+    detach: bool = typer.Option(False, "--detach", "-d", help="Run in background and print execution ID"),
+    callback_url: str | None = typer.Option(None, "--callback", help="Webhook URL for completion notification"),
+    registry_creds: str | None = typer.Option(
         None, "--registry-creds", help="Docker registry credentials as JSON string"
     ),
-    registry_type: Optional[str] = typer.Option(
+    registry_type: str | None = typer.Option(
         None, "--registry-type", help="Registry credential type: basic, aws, etc."
     ),
-    graceful_timeout: Optional[int] = typer.Option(
+    graceful_timeout: int | None = typer.Option(
         None, "--graceful-timeout", help="Seconds to wait for graceful shutdown on cancel (default: 10)"
     ),
 ):
@@ -96,19 +78,13 @@ def run_docker_compose(
                 registry_credentials = json.loads(registry_creds)
             except json.JSONDecodeError:
                 status.stop()
-                console.print(
-                    "[red]Error: Invalid JSON format for registry credentials[/red]"
-                )
+                console.print("[red]Error: Invalid JSON format for registry credentials[/red]")
                 raise typer.Exit(1)
 
         # Validate registry credentials and type
-        if (registry_creds and not registry_type) or (
-            registry_type and not registry_creds
-        ):
+        if (registry_creds and not registry_type) or (registry_type and not registry_creds):
             status.stop()
-            console.print(
-                "[red]Error: Both --registry-creds and --registry-type must be provided together[/red]"
-            )
+            console.print("[red]Error: Both --registry-creds and --registry-type must be provided together[/red]")
             raise typer.Exit(1)
 
         status.update(f"Starting Docker Compose from {compose_file.name}...")
@@ -169,9 +145,7 @@ def run_docker_compose(
             status.stop()
             console.print(f"[red]Error: HTTP {response.status_code}[/red]")
             if response.status_code == 401:
-                console.print(
-                    "[red]Authentication failed. Your session may have expired.[/red]"
-                )
+                console.print("[red]Authentication failed. Your session may have expired.[/red]")
                 console.print("[yellow]Run 'lyceum auth login' to re-authenticate.[/yellow]")
             elif response.content:
                 console.print(f"[red]{response.content.decode()}[/red]")
@@ -251,32 +225,33 @@ def show_registry_examples():
 
     console.print("[bold]1. Docker Hub (basic)[/bold]")
     console.print("Type: [green]basic[/green]")
-    console.print(
-        'Credentials: [yellow]\'{"username": "myuser", "password": "mypassword"}\'[/yellow]\n'
-    )
+    console.print('Credentials: [yellow]\'{"username": "myuser", "password": "mypassword"}\'[/yellow]\n')
 
     console.print("[bold]2. AWS ECR (aws)[/bold]")
     console.print("Type: [green]aws[/green]")
     console.print(
-        'Credentials: [yellow]\'{"region": "us-west-2", "aws_access_key_id": "AKIAI...", "aws_secret_access_key": "wJalrX...", "session_token": "optional..."}\'[/yellow]\n'
+        'Credentials: [yellow]\'{"region": "us-west-2", "aws_access_key_id": "AKIAI...", '
+        '"aws_secret_access_key": "wJalrX...", "session_token": "optional..."}\'[/yellow]\n'
     )
 
     console.print("[bold]3. Private Registry (basic)[/bold]")
     console.print("Type: [green]basic[/green]")
-    console.print(
-        'Credentials: [yellow]\'{"username": "admin", "password": "secret"}\'[/yellow]\n'
-    )
+    console.print('Credentials: [yellow]\'{"username": "admin", "password": "secret"}\'[/yellow]\n')
 
     console.print("[bold]Example Commands:[/bold]")
     console.print("# Docker Hub:")
     console.print(
-        "[dim]lyceum compose run docker-compose.yml --registry-type basic --registry-creds '{\"username\": \"myuser\", \"password\": \"mytoken\"}'[/dim]"
+        "[dim]lyceum compose run docker-compose.yml --registry-type basic "
+        '--registry-creds \'{"username": "myuser", "password": "mytoken"}\'[/dim]'
     )
     console.print("\n# AWS ECR:")
     console.print(
-        "[dim]lyceum compose run docker-compose.yml --registry-type aws --registry-creds '{\"region\": \"us-west-2\", \"aws_access_key_id\": \"AKIAI...\", \"aws_secret_access_key\": \"wJalrX...\"}'[/dim]"
+        "[dim]lyceum compose run docker-compose.yml --registry-type aws "
+        '--registry-creds \'{"region": "us-west-2", "aws_access_key_id": "AKIAI...", '
+        '"aws_secret_access_key": "wJalrX..."}\'[/dim]'
     )
     console.print("\n# Private Registry:")
     console.print(
-        "[dim]lyceum compose run docker-compose.yml --registry-type basic --registry-creds '{\"username\": \"admin\", \"password\": \"secret\"}'[/dim]"
+        "[dim]lyceum compose run docker-compose.yml --registry-type basic "
+        '--registry-creds \'{"username": "admin", "password": "secret"}\'[/dim]'
     )