arga-cli 0.1.2__tar.gz → 0.1.4__tar.gz

{arga_cli-0.1.2 → arga_cli-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arga-cli
-Version: 0.1.2
+Version: 0.1.4
 Summary: Command-line interface for Arga authentication, MCP installation, and browser validation
 Author: Arga Labs
 Project-URL: Homepage, https://github.com/ArgaLabs/arga-cli
@@ -198,6 +198,7 @@ arga runs cancel <run_id>
 - `arga runs logs <run_id>` prints worker logs plus recent runtime logs for a run you own.
 - When you omit `<run_id>`, `arga runs logs` falls back to `./.arga-session.json` when present, which makes wizard-created twin sessions easy to inspect from the same directory.
 - Add `--json` to `arga runs logs` for a machine-readable response.
+- Add `--errors-only` to keep only failed worker logs plus warning/error runtime entries.
 - `arga runs cancel <run_id>` cancels the run through the validation API.
 
 ### Git Wrappers

{arga_cli-0.1.2 → arga_cli-0.1.4}/README.md

@@ -178,6 +178,7 @@ arga runs cancel <run_id>
 - `arga runs logs <run_id>` prints worker logs plus recent runtime logs for a run you own.
 - When you omit `<run_id>`, `arga runs logs` falls back to `./.arga-session.json` when present, which makes wizard-created twin sessions easy to inspect from the same directory.
 - Add `--json` to `arga runs logs` for a machine-readable response.
+- Add `--errors-only` to keep only failed worker logs plus warning/error runtime entries.
 - `arga runs cancel <run_id>` cancels the run through the validation API.
 
 ### Git Wrappers

{arga_cli-0.1.2 → arga_cli-0.1.4}/arga_cli/main.py

@@ -10,6 +10,7 @@ import tempfile
 import time
 import webbrowser
 from datetime import datetime
+from importlib.metadata import PackageNotFoundError, version
 from pathlib import Path
 from typing import Any
 from urllib.parse import urlencode
@@ -27,6 +28,13 @@ POLL_TIMEOUT_SECONDS = 600.0
 SKIP_TRAILER = "[skip arga]"
 
 
+def _cli_version() -> str:
+    try:
+        return version("arga-cli")
+    except PackageNotFoundError:
+        return "unknown"
+
+
 class CliError(Exception):
     """Base CLI error."""
 
@@ -905,6 +913,40 @@ def _print_runtime_logs(runtime_logs: list[dict[str, Any]]) -> None:
             print()
 
 
+def _is_error_runtime_log(runtime_log: dict[str, Any]) -> bool:
+    severity = str(runtime_log.get("severity") or "").strip().upper()
+    return severity in {"WARNING", "ERROR", "CRITICAL", "ALERT", "EMERGENCY"}
+
+
+def _is_error_worker_log(worker_log: dict[str, Any]) -> bool:
+    status = str(worker_log.get("status") or "").strip().lower()
+    error = str(worker_log.get("error") or "").strip()
+    return status in {"failed", "error", "cancelled"} or bool(error)
+
+
+def _filter_run_logs_payload(payload: dict[str, Any], *, errors_only: bool) -> dict[str, Any]:
+    if not errors_only:
+        return payload
+
+    filtered_payload = dict(payload)
+    worker_logs = payload.get("worker_logs")
+    runtime_logs = payload.get("runtime_logs")
+    warnings = payload.get("warnings")
+
+    filtered_payload["worker_logs"] = (
+        [item for item in worker_logs if isinstance(item, dict) and _is_error_worker_log(item)]
+        if isinstance(worker_logs, list)
+        else []
+    )
+    filtered_payload["runtime_logs"] = (
+        [item for item in runtime_logs if isinstance(item, dict) and _is_error_runtime_log(item)]
+        if isinstance(runtime_logs, list)
+        else []
+    )
+    filtered_payload["warnings"] = warnings if isinstance(warnings, list) else []
+    return filtered_payload
+
+
 def _print_run_logs(payload: dict[str, Any], fallback_run_id: str) -> None:
     run = payload.get("run")
     run_data = run if isinstance(run, dict) else {}
@@ -996,6 +1038,8 @@ def run_runs_logs(args: argparse.Namespace) -> int:
     finally:
         client.close()
 
+    payload = _filter_run_logs_payload(payload, errors_only=args.errors_only)
+
     if args.json:
         print(json.dumps(payload, indent=2))
         return 0
@@ -1204,6 +1248,11 @@ def run_wizard(args: argparse.Namespace) -> int:
 
 def build_parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(prog="arga")
+    parser.add_argument(
+        "--version",
+        action="version",
+        version=f"%(prog)s {_cli_version()}",
+    )
     subparsers = parser.add_subparsers(dest="command", required=True)
 
     login_parser = subparsers.add_parser("login", help="Authenticate the CLI")
@@ -1291,6 +1340,11 @@ def build_parser() -> argparse.ArgumentParser:
         help=f"Validation run ID. Defaults to {WIZARD_SESSION_FILE} in the current directory when available.",
     )
     runs_logs_parser.add_argument("--json", action="store_true", help="Print the raw JSON response")
+    runs_logs_parser.add_argument(
+        "--errors-only",
+        action="store_true",
+        help="Show only failed worker logs and warning/error runtime logs",
+    )
     runs_logs_parser.set_defaults(func=run_runs_logs)
 
     runs_cancel_parser = runs_subparsers.add_parser("cancel", help="Cancel a validation run")

{arga_cli-0.1.2 → arga_cli-0.1.4}/arga_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arga-cli
-Version: 0.1.2
+Version: 0.1.4
 Summary: Command-line interface for Arga authentication, MCP installation, and browser validation
 Author: Arga Labs
 Project-URL: Homepage, https://github.com/ArgaLabs/arga-cli
@@ -198,6 +198,7 @@ arga runs cancel <run_id>
 - `arga runs logs <run_id>` prints worker logs plus recent runtime logs for a run you own.
 - When you omit `<run_id>`, `arga runs logs` falls back to `./.arga-session.json` when present, which makes wizard-created twin sessions easy to inspect from the same directory.
 - Add `--json` to `arga runs logs` for a machine-readable response.
+- Add `--errors-only` to keep only failed worker logs plus warning/error runtime entries.
 - `arga runs cancel <run_id>` cancels the run through the validation API.
 
 ### Git Wrappers

{arga_cli-0.1.2 → arga_cli-0.1.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "arga-cli"
-version = "0.1.2"
+version = "0.1.4"
 description = "Command-line interface for Arga authentication, MCP installation, and browser validation"
 readme = "README.md"
 requires-python = ">=3.12"

{arga_cli-0.1.2 → arga_cli-0.1.4}/tests/test_cli_runs.py

@@ -293,6 +293,117 @@ def test_runs_logs_prints_json(monkeypatch, capsys) -> None:
     assert json.loads(output) == payload
 
 
+def test_runs_logs_errors_only_filters_plain_output(monkeypatch, capsys) -> None:
+    monkeypatch.setattr(main, "load_api_key", lambda: "arga_api_key")
+    monkeypatch.setattr(main.ApiClient, "close", lambda self: None)
+
+    def fake_get_logs(self, run_id: str):
+        assert run_id == "run_123"
+        return {
+            "run": {
+                "id": run_id,
+                "status": "ready",
+                "run_type": "twin_quickstart",
+                "mode": "staging",
+                "repo_full_name": None,
+                "commit_sha": None,
+                "created_at": "2026-03-25T12:30:00Z",
+                "environment_url": "https://preview.example.com",
+                "event_log_json": [],
+            },
+            "worker_logs": [
+                {
+                    "job_id": "job_ok",
+                    "job_type": "build",
+                    "target_role": "builder",
+                    "status": "succeeded",
+                    "content": "all good",
+                    "truncated": False,
+                    "error": None,
+                },
+                {
+                    "job_id": "job_bad",
+                    "job_type": "deploy",
+                    "target_role": "warm-vm",
+                    "status": "failed",
+                    "content": "deploy failed output",
+                    "truncated": False,
+                    "error": None,
+                },
+            ],
+            "runtime_logs": [
+                {
+                    "timestamp": "2026-03-25T12:31:00Z",
+                    "service_name": "arga-api",
+                    "severity": "INFO",
+                    "event": "environment_ready",
+                    "code": None,
+                    "request_id": "req_ok",
+                    "job_id": None,
+                    "surface_name": None,
+                    "message": "Environment ready.",
+                },
+                {
+                    "timestamp": "2026-03-25T12:32:00Z",
+                    "service_name": "preview-proxy",
+                    "severity": "WARNING",
+                    "event": "preview.request.finish",
+                    "code": None,
+                    "request_id": "req_warn",
+                    "job_id": None,
+                    "surface_name": "slack",
+                    "message": "Preview request completed.",
+                },
+            ],
+            "warnings": ["Cloud Logging query was partially truncated."],
+        }
+
+    monkeypatch.setattr(main.ApiClient, "get_run_logs", fake_get_logs)
+
+    args = main.build_parser().parse_args(["runs", "logs", "run_123", "--errors-only"])
+    exit_code = args.func(args)
+    output = capsys.readouterr().out
+
+    assert exit_code == 0
+    assert "job_bad" in output
+    assert "deploy failed output" in output
+    assert "job_ok" not in output
+    assert "all good" not in output
+    assert "Preview request completed." in output
+    assert "Environment ready." not in output
+    assert "Warnings:" in output
+
+
+def test_runs_logs_errors_only_filters_json(monkeypatch, capsys) -> None:
+    monkeypatch.setattr(main, "load_api_key", lambda: "arga_api_key")
+    monkeypatch.setattr(main.ApiClient, "close", lambda self: None)
+
+    payload = {
+        "run": {"id": "run_123", "status": "ready"},
+        "worker_logs": [
+            {"job_id": "job_ok", "status": "succeeded", "error": None},
+            {"job_id": "job_bad", "status": "failed", "error": None},
+        ],
+        "runtime_logs": [
+            {"severity": "INFO", "message": "Environment ready."},
+            {"severity": "WARNING", "message": "Preview request completed."},
+        ],
+        "warnings": ["Cloud Logging query was partially truncated."],
+    }
+
+    monkeypatch.setattr(main.ApiClient, "get_run_logs", lambda self, run_id: payload)
+
+    args = main.build_parser().parse_args(["runs", "logs", "run_123", "--json", "--errors-only"])
+    exit_code = args.func(args)
+    output = capsys.readouterr().out
+
+    assert exit_code == 0
+    parsed = json.loads(output)
+    assert parsed["worker_logs"] == [{"job_id": "job_bad", "status": "failed", "error": None}]
+    assert parsed["runtime_logs"] == [{"severity": "WARNING", "message": "Preview request completed."}]
+    assert parsed["warnings"] == ["Cloud Logging query was partially truncated."]
+
+
 def test_runs_logs_uses_wizard_session_file_when_run_id_missing(monkeypatch, capsys, tmp_path) -> None:
     monkeypatch.chdir(tmp_path)
     (tmp_path / main.WIZARD_SESSION_FILE).write_text(json.dumps({"run_id": "run_from_session"}) + "\n")

{arga_cli-0.1.2 → arga_cli-0.1.4}/tests/test_cli_validate_config.py

@@ -127,3 +127,17 @@ def test_main_dispatches_validate_wrapper_before_argparse(monkeypatch) -> None:
         raise AssertionError("Expected main() to exit")
 
     assert captured["argv"] == ["config", "arga-labs/validation-server"]
+
+
+def test_main_supports_global_version_flag(monkeypatch, capsys) -> None:
+    monkeypatch.setattr(main, "_cli_version", lambda: "0.1.3")
+    monkeypatch.setattr(sys, "argv", ["arga", "--version"])
+
+    try:
+        main.main()
+    except SystemExit as exc:
+        assert exc.code == 0
+    else:
+        raise AssertionError("Expected main() to exit")
+
+    assert capsys.readouterr().out.strip() == "arga 0.1.3"