sovaria-cli 0.2.4__tar.gz → 0.2.7__tar.gz

{sovaria_cli-0.2.4 → sovaria_cli-0.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sovaria-cli
-Version: 0.2.4
+Version: 0.2.7
 Summary: Sovaria BaaS command-line interface (sov)
 Project-URL: Homepage, https://sovaria.in
 Project-URL: Documentation, https://docs.sovaria.in/cli
@@ -11,6 +11,7 @@ Requires-Python: >=3.11
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: keyring>=25.0
 Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.7.0
 Requires-Dist: sovaria-sdk>=0.2.0
 Requires-Dist: tomli-w>=1.2.0
 Requires-Dist: typer>=0.17.4

{sovaria_cli-0.2.4 → sovaria_cli-0.2.7}/apps/cli/src/__init__.py

@@ -1,3 +1,3 @@
 """Sovaria CLI — sov command."""
 
-__version__ = "0.2.4"
+__version__ = "0.2.7"

{sovaria_cli-0.2.4 → sovaria_cli-0.2.7}/apps/cli/src/commands/admin.py

@@ -7,7 +7,8 @@ from urllib.parse import quote, urlencode
 import typer
 
 from apps.cli.src.utils.api_client import CLIRequestError, call_api
-from apps.cli.src.utils.display import print_json
+from apps.cli.src.utils.display import handle_cli_error, handle_command_error, print_json
+from apps.cli.src.utils.project_context import resolve_org_id
 
 app = typer.Typer(help="Platform admin: error traces, usage, transparency")
 
@@ -52,8 +53,7 @@ def error_traces_list(
             params=params,
         )
     except CLIRequestError as exc:
-        typer.echo(str(exc), err=True)
-        raise typer.Exit(1) from exc
+        handle_cli_error(exc)
     print_json(result)
 
 
@@ -71,8 +71,7 @@ def error_traces_get(
             require_scope=False,
         )
     except CLIRequestError as exc:
-        typer.echo(str(exc), err=True)
-        raise typer.Exit(1) from exc
+        handle_cli_error(exc)
     print_json(result)
 
 
@@ -92,8 +91,7 @@ def error_traces_resolve(
             body={"resolved": resolved},
         )
     except CLIRequestError as exc:
-        typer.echo(str(exc), err=True)
-        raise typer.Exit(1) from exc
+        handle_cli_error(exc)
     print_json(result)
 
 
@@ -118,14 +116,13 @@ def usage_overview(
             params=params or None,
         )
     except CLIRequestError as exc:
-        typer.echo(str(exc), err=True)
-        raise typer.Exit(1) from exc
+        handle_cli_error(exc)
     print_json(result)
 
 
 @transparency_app.command("list")
 def transparency_list(
-    org_id: str = typer.Option(..., "--org", help="Organisation ID"),
+    org_id: str | None = typer.Option(None, "--org", help="Organisation ID (defaults to scoped org)"),
     project_id: str | None = typer.Option(None, "--project"),
     event_type: str | None = typer.Option(None, "--event-type"),
     since: str | None = typer.Option(None, "--since", help="ISO-8601 lower bound"),
@@ -134,8 +131,12 @@ def transparency_list(
     profile: str | None = typer.Option(None, "--profile"),
 ) -> None:
     """List tenant-visible staff access transparency events."""
+    try:
+        resolved_org = resolve_org_id(profile=profile, org_id=org_id, require=True)
+    except ValueError as exc:
+        handle_command_error(exc)
     query: dict[str, str] = {
-        "org_id": org_id,
+        "org_id": resolved_org,
         "limit": str(limit),
         "offset": str(offset),
     }
@@ -151,10 +152,9 @@ def transparency_list(
             method="GET",
             path=path,
             profile=profile,
-            org_id=org_id,
+            org_id=resolved_org,
             require_scope=False,
         )
     except CLIRequestError as exc:
-        typer.echo(str(exc), err=True)
-        raise typer.Exit(1) from exc
+        handle_cli_error(exc)
     print_json(result)

{sovaria_cli-0.2.4 → sovaria_cli-0.2.7}/apps/cli/src/commands/api.py

@@ -4,7 +4,8 @@ from __future__ import annotations
 
 import typer
 
-from apps.cli.src.utils.api_client import CLIRequestError, call_api, parse_json_arg, print_json
+from apps.cli.src.utils.api_client import CLIRequestError, call_api, parse_json_arg
+from apps.cli.src.utils.display import handle_cli_error, print_json
 
 app = typer.Typer(help="Raw gateway API calls")
 
@@ -42,7 +43,6 @@ def call_command(
             env_id=env_id,
         )
     except CLIRequestError as exc:
-        typer.echo(str(exc), err=True)
-        raise typer.Exit(1) from exc
+        handle_cli_error(exc)
 
-    typer.echo(print_json(result))
+    print_json(result)

sovaria_cli-0.2.7/apps/cli/src/commands/audit.py

@@ -0,0 +1,172 @@
+"""Echo audit and simulation commands."""
+
+from __future__ import annotations
+
+import typer
+
+from apps.cli.src.utils.api_client import CLIRequestError, parse_json_arg
+from apps.cli.src.utils.api_helpers import premium_api, premium_mutate
+
+app = typer.Typer(help="Echo audit trail and simulation operations")
+
+
+@app.command("append")
+def append_audit(
+    event_type: str = typer.Option(..., "--event-type"),
+    actor_id: str = typer.Option(..., "--actor-id"),
+    source: str = typer.Option(..., "--source"),
+    action: str = typer.Option(..., "--action"),
+    resource_id: str | None = typer.Option(None, "--resource-id"),
+    metadata: str | None = typer.Option(None, "--metadata", help="JSON object"),
+    ip_address: str | None = typer.Option(None, "--ip-address"),
+    profile: str | None = typer.Option(None, "--profile"),
+) -> None:
+    """Append an immutable audit entry."""
+    parsed_metadata = parse_json_arg(metadata, label="--metadata") if metadata else {}
+    if parsed_metadata is not None and not isinstance(parsed_metadata, dict):
+        raise CLIRequestError("--metadata must be a JSON object")
+    premium_mutate(
+        "Appending audit entry…",
+        success="Appended",
+        title="Audit entry",
+        method="POST",
+        path="/api/v1/audit/",
+        profile=profile,
+        body={
+            "event_type": event_type,
+            "actor_id": actor_id,
+            "resource_id": resource_id,
+            "source": source,
+            "action": action,
+            "metadata": parsed_metadata or {},
+            "ip_address": ip_address,
+        },
+    )
+
+
+@app.command("list")
+def list_audit(
+    actor_id: str | None = typer.Option(None, "--actor-id"),
+    event_type: str | None = typer.Option(None, "--event-type"),
+    source: str | None = typer.Option(None, "--source"),
+    resource_id: str | None = typer.Option(None, "--resource-id"),
+    limit: int = typer.Option(50, "--limit"),
+    offset: int = typer.Option(0, "--offset"),
+    profile: str | None = typer.Option(None, "--profile"),
+) -> None:
+    """Query audit log entries."""
+    params = {
+        "limit": str(limit),
+        "offset": str(offset),
+    }
+    if actor_id:
+        params["actor_id"] = actor_id
+    if event_type:
+        params["event_type"] = event_type
+    if source:
+        params["source"] = source
+    if resource_id:
+        params["resource_id"] = resource_id
+
+    premium_api(
+        "Loading audit entries…",
+        success="Loaded",
+        title="Audit log",
+        method="GET",
+        path="/api/v1/audit/",
+        profile=profile,
+        params=params,
+    )
+
+
+@app.command("verify")
+def verify_chain(profile: str | None = typer.Option(None, "--profile")) -> None:
+    """Verify audit hash-chain integrity."""
+    premium_api(
+        "Verifying audit chain…",
+        success="Verified",
+        title="Audit verification",
+        method="GET",
+        path="/api/v1/audit/verify",
+        profile=profile,
+    )
+
+
+@app.command("count")
+def audit_count(profile: str | None = typer.Option(None, "--profile")) -> None:
+    """Return audit log entry count."""
+    premium_api(
+        "Counting audit entries…",
+        success="Loaded",
+        title="Audit count",
+        method="GET",
+        path="/api/v1/audit/count",
+        profile=profile,
+    )
+
+
+@app.command("sim-run")
+def sim_run(
+    simulation_name: str = typer.Argument(...),
+    operations: str = typer.Argument(..., help="JSON array operations"),
+    context: str | None = typer.Option(None, "--context", help="JSON object"),
+    include_execution_tree: bool = typer.Option(False, "--include-execution-tree"),
+    profile: str | None = typer.Option(None, "--profile"),
+) -> None:
+    """Run an Echo phantom simulation."""
+    parsed_ops = parse_json_arg(operations, label="operations")
+    if not isinstance(parsed_ops, list):
+        raise CLIRequestError("operations must be a JSON array")
+
+    parsed_context = parse_json_arg(context, label="--context") if context else {}
+    if parsed_context is not None and not isinstance(parsed_context, dict):
+        raise CLIRequestError("--context must be a JSON object")
+
+    premium_api(
+        f"Running simulation '{simulation_name}'…",
+        success="Completed",
+        title="Simulation",
+        method="POST",
+        path="/api/v1/sim/run",
+        profile=profile,
+        body={
+            "simulation_name": simulation_name,
+            "operations": parsed_ops,
+            "echo_flag": True,
+            "include_execution_tree": include_execution_tree,
+            "context": parsed_context or {},
+        },
+    )
+
+
+@app.command("sim-plan")
+def sim_plan(
+    simulation_name: str = typer.Argument(...),
+    operations: str = typer.Argument(..., help="JSON array operations"),
+    context: str | None = typer.Option(None, "--context", help="JSON object"),
+    profile: str | None = typer.Option(None, "--profile"),
+) -> None:
+    """Preview an Echo simulation plan."""
+    parsed_ops = parse_json_arg(operations, label="operations")
+    if not isinstance(parsed_ops, list):
+        raise CLIRequestError("operations must be a JSON array")
+
+    parsed_context = parse_json_arg(context, label="--context") if context else {}
+    if parsed_context is not None and not isinstance(parsed_context, dict):
+        raise CLIRequestError("--context must be a JSON object")
+
+    premium_api(
+        f"Planning simulation '{simulation_name}'…",
+        success="Planned",
+        title="Simulation plan",
+        method="POST",
+        path="/api/v1/sim/plan",
+        profile=profile,
+        body={
+            "simulation_name": simulation_name,
+            "operations": parsed_ops,
+            "echo_flag": True,
+            "include_execution_tree": True,
+            "context": parsed_context or {},
+        },
+    )

{sovaria_cli-0.2.4 → sovaria_cli-0.2.7}/apps/cli/src/commands/auth_product.py

@@ -7,7 +7,9 @@ from urllib.parse import quote
 
 import typer
 
-from apps.cli.src.utils.api_client import CLIRequestError, call_api, print_json
+from apps.cli.src.utils.api_client import CLIRequestError, call_api
+from apps.cli.src.utils.display import handle_cli_error, print_json
+from apps.cli.src.utils.premium_display import run_with_spinner
 from apps.cli.src.utils.config import get_scope
 
 app = typer.Typer(help="Manage product users within an org/project scope")
@@ -49,17 +51,20 @@ def list_users(
 ) -> None:
     """List product users for the resolved org/project scope."""
     try:
-        result = call_api(
-            method="GET",
-            path=_project_auth_path(profile, project_id, "/users"),
-            profile=profile,
-            require_scope=True,
-            **_scope_args(org_id, project_id, env_id),
+        result = run_with_spinner(
+            "Loading app users…",
+            lambda: call_api(
+                method="GET",
+                path=_project_auth_path(profile, project_id, "/users"),
+                profile=profile,
+                require_scope=True,
+                **_scope_args(org_id, project_id, env_id),
+            ),
+            success="Users loaded",
         )
     except CLIRequestError as exc:
-        typer.echo(str(exc), err=True)
-        raise typer.Exit(1) from exc
-    typer.echo(print_json(result))
+        handle_cli_error(exc)
+    print_json(result, title="App users")
 
 
 @app.command("ban")
@@ -81,9 +86,8 @@ def ban_user(
             **_scope_args(org_id, project_id, env_id),
         )
     except CLIRequestError as exc:
-        typer.echo(str(exc), err=True)
-        raise typer.Exit(1) from exc
-    typer.echo(print_json(result))
+        handle_cli_error(exc)
+    print_json(result)
 
 
 @app.command("delete")
@@ -105,9 +109,8 @@ def delete_user(
             **_scope_args(org_id, project_id, env_id),
         )
     except CLIRequestError as exc:
-        typer.echo(str(exc), err=True)
-        raise typer.Exit(1) from exc
-    typer.echo(print_json(result))
+        handle_cli_error(exc)
+    print_json(result)
 
 
 @app.command("roles")
@@ -129,9 +132,8 @@ def get_roles(
             **_scope_args(org_id, project_id, env_id),
         )
     except CLIRequestError as exc:
-        typer.echo(str(exc), err=True)
-        raise typer.Exit(1) from exc
-    typer.echo(print_json(result))
+        handle_cli_error(exc)
+    print_json(result)
 
 
 @app.command("roles-set")
@@ -155,9 +157,8 @@ def set_roles(
             **_scope_args(org_id, project_id, env_id),
         )
     except CLIRequestError as exc:
-        typer.echo(str(exc), err=True)
-        raise typer.Exit(1) from exc
-    typer.echo(print_json(result))
+        handle_cli_error(exc)
+    print_json(result)
 
 
 @app.command("create")
@@ -173,15 +174,18 @@ def create_user(
     """Create a product user in the current project scope."""
     display_name = name or email.split("@", maxsplit=1)[0]
     try:
-        result = call_api(
-            method="POST",
-            path=_project_auth_path(profile, project_id, "/users"),
-            profile=profile,
-            require_scope=True,
-            **_scope_args(org_id, project_id, env_id),
-            body={"name": display_name, "email": email, "password": password},
+        result = run_with_spinner(
+            f"Creating user {email}…",
+            lambda: call_api(
+                method="POST",
+                path=_project_auth_path(profile, project_id, "/users"),
+                profile=profile,
+                require_scope=True,
+                **_scope_args(org_id, project_id, env_id),
+                body={"name": display_name, "email": email, "password": password},
+            ),
+            success="User created",
         )
     except CLIRequestError as exc:
-        typer.echo(str(exc), err=True)
-        raise typer.Exit(1) from exc
-    typer.echo(print_json(result))
+        handle_cli_error(exc)
+    print_json(result)