bevor-cli 0.1.0__tar.gz → 0.1.1__tar.gz

bevor_cli-0.1.1/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.5
+Name: bevor-cli
+Version: 0.1.1
+Summary: Bevor CLI tool for security analysis and graph inspection
+Classifier: Development Status :: 3 - Alpha
+Requires-Python: >=3.13
+Requires-Dist: bevor-sdk==0.1.1
+Requires-Dist: click~=8.1
+Requires-Dist: httpx~=0.28
+Requires-Dist: packaging~=26.2
+Requires-Dist: pydantic~=2.12
+Requires-Dist: pyyaml~=6.0
+Requires-Dist: questionary~=2.0
+Requires-Dist: rich~=15.0
+Requires-Dist: typer~=0.26
+Description-Content-Type: text/markdown
+
+# Bevor CLI
+
+The official command-line interface for [Bevor](https://bevor.io) — smart contract security analysis and code graph exploration.
+
+Use `bevor` to upload Solidity codebases, run security analyses, explore the code graph interactively, and manage findings — all from your terminal.
+
+---
+
+## Installation
+
+```bash
+curl -LsSf https://bevor.io/install.sh | bash
+```
+
+---
+
+## Setup
+
+```bash
+bevor login
+bevor link
+#
+bevor codes push
+bevor analyses create
+```
+
+---
+
+## Contents
+
+`[]` -> optional args.
+`<>` -> required args.
+
+Simplification: EVERYTHING operates on the currently configured analysis. Findings as well.
+Simplifies the DX, and we can take the stance that it's a rare state to want to operate on OTHER things via the CLI.
+"version" is a flag that can be passed, but it's intentionally hard to act on arbitrary versions, unless the head is moved or the flag is passed.
+
+### Local Configuration
+- workspace [id]
+- project [id]
+- code [id, fingerprint]
+- analysis [id]
+
+```bash
+help
+login
+logout
+whoami [--json]
+link
+context [--json]
+sessions
+sessions list
+sessions revoke <token_id>
+workspaces
+workspaces list [--json]
+workspaces view [workspace_id] [--json]
+workspaces select [workspace_id]
+projects
+projects list [--json]
+projects view [project_id] [--json]
+projects select [project_id]
+projects create [--name] [--description] [--kind] [--yes]
+codes
+codes list [--page] [--page-size] [--order] [--order-by] [--project] [--network] [--identifier] [--status] [--json]
+codes view [code_id] [--json]
+codes select [code_id]
+codes push [--path] [--no-wait] [--yes]
+codes nodes
+codes nodes list [--code] [--entrypoints] [--file] [--no-deps] [--name] [--node-type] [--json]
+codes nodes view <node_id> [--code] [--json]
+codes nodes content <node_id> [--code]
+codes nodes edges <node_id> [--code] [--direction] [--type] [--json]
+codes nodes call-chain <node_id> [--code] [--json]
+codes nodes interactive <node_id> [--code]
+analyses
+analyses list [--page] [--page-size] [--order] [--order-by] [--project] [--user] [--is-owner] [--json]
+analyses view [analysis_id] [--version] [--json]
+analyses select [analysis_id] [--page] [--page-size]
+analyses recent [--json]
+analyses create [--name] [--collision] [--yes] [--json] [--force]
+analyses set-head <version_id>
+analyses run [--version] [--no-wait] [--silent]
+analyses retry [--version] [--no-wait] [--silent]
+analyses diff [--version] [--staged] [--json]
+analyses commit [--version]
+analyses child [--version] [--collision]
+analyses fork [--version]
+analyses merge <from_analysis> [--to]
+analyses findings [--version] [--interactive] [--json] [--sarif]
+analyses entrypoints [--version] [--json]
+analyses transitions [--page] [--page-size] [--order] [--order-by] [--reason] [--version] [--project-wide] [--json]
+analyses delete
+analyses delete full
+analyses delete version [version]
+findings
+findings list [--page] [--page-size] [--order] [--order-by] [--project] [--self] [--user] [--code] [--analyses] [--type] [--level] [--acknowledged] [--operation] [--created-by-self] [--created-by] [--json]
+findings view <finding_id> [--json]
+findings add [--version] [--file] [--interactive] [--type] [--level] [--name] [--explanation] [--recommendation] [--poc] [--tool] [--node] [--location] [--uri] [--start-line] [--start-column] [--end-line] [--end-column] [--char-offset] [--char-length] [--byte-offset] [--byte-length] [--fqn]
+findings bulk <source> [--version]
+findings edit <finding_id> [--file]
+findings delete <finding_id>
+findings revert <finding_id>
+findings acknowledge <finding_id>
+agent
+agent setup
+agent materialize
+chats
+chats list --page --page-size --order --order-by --project [--json]
+chats view <chat_id> [--json]
+chats messages <chat_id> [--json]
+chats new <mode>
+chats resume <chat_id>
+```

{bevor_cli-0.1.0 → bevor_cli-0.1.1}/bevor_cli/apps/main.py

@@ -1,3 +1,5 @@
+import subprocess
+
 import typer
 from bevor_cli import output
 from bevor_cli.apps import (
@@ -10,6 +12,9 @@ from bevor_cli.apps import (
     sessions,
     workspaces,
 )
+from bevor_cli.callbacks.notify import _notify_if_outdated, _update_check_enabled
+from bevor_cli.callbacks.upgrade import _upgrade_command
+from bevor_cli.callbacks.version import _current_version, _latest_version, _version_callback
 from bevor_cli.commands.auth import login, logout, whoami
 from bevor_cli.commands.context import run_context
 from bevor_cli.commands.link import run_link
@@ -26,13 +31,24 @@ app = typer.Typer(
 
 @app.callback(invoke_without_command=True)
 def _root(
+    ctx: typer.Context,
     quiet: bool = typer.Option(
         False,
         "--quiet",
         help="Suppress informational output; useful for scripting.",
-        is_eager=False,
+    ),
+    version: bool = typer.Option(
+        False,
+        "--version",
+        "-v",
+        help="Show the CLI version and exit.",
+        callback=_version_callback,
+        is_eager=True,
     ),
 ) -> None:
+    if ctx.invoked_subcommand != "upgrade" and _update_check_enabled(quiet):
+        ctx.call_on_close(_notify_if_outdated)
+
     output.set_quiet(quiet)
 
 
@@ -43,6 +59,20 @@ def help_command(ctx: typer.Context) -> None:
     console.print(root_ctx.get_help())
 
 
+@app.command("upgrade")
+def upgrade() -> None:
+    """Upgrade bevor-cli to the latest release."""
+    current = _current_version()
+    latest = _latest_version()
+    if current >= latest:
+        typer.echo(f"Already on the latest version ({current}).")
+        return
+
+    typer.echo(f"Upgrading {current} → {latest}")
+    result = subprocess.run(_upgrade_command())
+    raise typer.Exit(result.returncode)
+
+
 app.command("login")(login)
 app.command("logout")(logout)
 app.command("whoami")(whoami)

bevor_cli-0.1.1/bevor_cli/callbacks/notify.py

@@ -0,0 +1,26 @@
+import os
+import sys
+
+import typer
+
+from bevor_cli.callbacks.version import _current_version
+from bevor_cli.configuration.update import UpdateCheck
+
+
+def _notify_if_outdated() -> None:
+    check = UpdateCheck.refresh()
+    if check and check.is_outdated:
+        typer.echo(
+            f"\nA new version of bevor-cli is available: {_current_version()} → {check.latest}\n"
+            "Run `bevor upgrade` to update.",
+            err=True,
+        )
+
+
+def _update_check_enabled(quiet: bool) -> bool:
+    return (
+        not quiet
+        and sys.stderr.isatty()
+        and not os.environ.get("CI")
+        and not os.environ.get("BEVOR_NO_UPDATE_CHECK")
+    )

bevor_cli-0.1.1/bevor_cli/callbacks/upgrade.py

@@ -0,0 +1,23 @@
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+PACKAGE = "bevor-cli"
+
+
+def _uv_tool_dir(uv: str) -> Path | None:
+    result = subprocess.run([uv, "tool", "dir"], capture_output=True, text=True)
+    if result.returncode != 0:
+        return None
+    return Path(result.stdout.strip()).resolve()
+
+
+def _upgrade_command() -> list[str]:
+    prefix = Path(sys.prefix).resolve()
+    uv = shutil.which("uv")
+    if uv:
+        tool_dir = _uv_tool_dir(uv)
+        if tool_dir and prefix.is_relative_to(tool_dir):
+            return [uv, "tool", "upgrade", PACKAGE]
+    return [sys.executable, "-m", "pip", "install", "--upgrade", PACKAGE]

bevor_cli-0.1.1/bevor_cli/callbacks/version.py

@@ -0,0 +1,25 @@
+import importlib.metadata
+import json
+import urllib.request
+
+import typer
+from packaging.version import Version
+
+PACKAGE = "bevor-cli"
+
+
+def _current_version() -> Version:
+    return Version(importlib.metadata.version(PACKAGE))
+
+
+def _latest_version(timeout: float = 5) -> Version:
+    url = f"https://pypi.org/pypi/{PACKAGE}/json"
+    with urllib.request.urlopen(url, timeout=timeout) as res:
+        return Version(json.load(res)["info"]["version"])
+
+
+def _version_callback(value: bool) -> None:
+    if not value:
+        return
+    typer.echo(f"bevor-cli {_current_version()}")
+    raise typer.Exit()

{bevor_cli-0.1.0 → bevor_cli-0.1.1}/bevor_cli/commands/analyses/retry.py

@@ -59,13 +59,13 @@ def retry_analysis(
                 for event in run_result.stream_completion():
                     if event.id in ep_map:
                         short_id, name, _ = ep_map[event.id]
-                        ep_map[event.id] = (short_id, name, event.status)
+                        ep_map[event.id] = (short_id, name, event.payload.status)
                         render_status(ep_map)
         else:
             for event in run_result.stream_completion():
                 if event.id in ep_map:
                     short_id, name, _ = ep_map[event.id]
-                    ep_map[event.id] = (short_id, name, event.status)
+                    ep_map[event.id] = (short_id, name, event.payload.status)
 
         n_failures = sum(1 if status == "failed" else 0 for _, _, status in ep_map.values())
         if n_failures > 0:

{bevor_cli-0.1.0 → bevor_cli-0.1.1}/bevor_cli/commands/analyses/run.py

@@ -69,13 +69,13 @@ def run_analysis(
                 for event in run_result.stream_completion():
                     if event.id in ep_map:
                         short_id, name, _ = ep_map[event.id]
-                        ep_map[event.id] = (short_id, name, event.status)
+                        ep_map[event.id] = (short_id, name, event.payload.status)
                         live.update(render_status(ep_map))
         else:
             for event in run_result.stream_completion():
                 if event.id in ep_map:
                     short_id, name, _ = ep_map[event.id]
-                    ep_map[event.id] = (short_id, name, event.status)
+                    ep_map[event.id] = (short_id, name, event.payload.status)
 
         n_failures = sum(1 if status == "failed" else 0 for _, _, status in ep_map.values())
         if n_failures > 0:

{bevor_cli-0.1.0 → bevor_cli-0.1.1}/bevor_cli/configuration/creds.py

@@ -5,10 +5,12 @@ import json
 from pathlib import Path
 
 import typer
-from bevor_cli import output
 from pydantic import BaseModel
 
-_CREDENTIALS_PATH = Path.home() / ".bevor" / "credentials"
+from bevor_cli import output
+
+BEVOR_DIR = Path.home() / ".bevor"
+_CREDENTIALS_PATH = BEVOR_DIR / "credentials"
 
 
 class Credentials(BaseModel):

{bevor_cli-0.1.0 → bevor_cli-0.1.1}/bevor_cli/configuration/state.py

@@ -5,12 +5,13 @@ from pathlib import Path
 from typing import Optional
 
 import typer
-from bevor_cli import output
 from bevor_sdk.types import ID
 from bevor_sdk.types.responses.graph import CodeMappingSchema
 from bevor_sdk.types.responses.security import AnalysisSchema
 from pydantic import BaseModel
 
+from bevor_cli import output
+
 _CONFIG_DIR = ".bevor"
 _CONFIG_FILE = "config.json"
 

bevor_cli-0.1.1/bevor_cli/configuration/update.py

@@ -0,0 +1,50 @@
+import datetime
+
+from packaging.version import Version
+from pydantic import BaseModel
+
+from bevor_cli.callbacks.version import _current_version, _latest_version
+
+from .creds import BEVOR_DIR
+
+_UPDATE_CHECK_PATH = BEVOR_DIR / "update-check.json"
+_UPDATE_CHECK_INTERVAL = datetime.timedelta(days=1)
+
+
+class UpdateCheck(BaseModel):
+    latest: str
+    checked_at: datetime.datetime
+
+    @property
+    def is_stale(self) -> bool:
+        return datetime.datetime.now(datetime.UTC) - self.checked_at >= _UPDATE_CHECK_INTERVAL
+
+    @property
+    def is_outdated(self) -> bool:
+        return Version(self.latest) > _current_version()
+
+    @classmethod
+    def load(cls) -> "UpdateCheck | None":
+        if not _UPDATE_CHECK_PATH.exists():
+            return None
+        try:
+            return cls.model_validate_json(_UPDATE_CHECK_PATH.read_text())
+        except Exception:
+            return None
+
+    @classmethod
+    def save(cls, latest: Version) -> "UpdateCheck":
+        check = cls(latest=str(latest), checked_at=datetime.datetime.now(datetime.UTC))
+        _UPDATE_CHECK_PATH.parent.mkdir(parents=True, exist_ok=True)
+        _UPDATE_CHECK_PATH.write_text(check.model_dump_json(indent=2))
+        return check
+
+    @classmethod
+    def refresh(cls) -> "UpdateCheck | None":
+        check = cls.load()
+        if check and not check.is_stale:
+            return check
+        try:
+            return cls.save(_latest_version(timeout=1))
+        except (OSError, ValueError):
+            return check

{bevor_cli-0.1.0 → bevor_cli-0.1.1}/bevor_cli/main.py

@@ -1,17 +1,32 @@
 import sys
 
 import typer
-from bevor_sdk.exceptions import BaseError, InvalidScopeError, UnauthorizedError
+from bevor_sdk.exceptions import (
+    BaseError,
+    InvalidScopeError,
+    SessionExpiredError,
+    UnauthenticatedError,
+    UnauthorizedError,
+)
 
 from bevor_cli import output
 from bevor_cli.apps.main import app
+from bevor_cli.configuration.creds import Credentials
 
 
 def main() -> None:
     try:
-        app(standalone_mode=False)
+        app()
+    except UnauthenticatedError:
+        Credentials.delete()
+        output.error("Unauthenticated.", hint="Run `bevor login`.")
+        sys.exit(1)
     except UnauthorizedError:
-        output.error("Unauthorized.", hint="Run `bevor login`.")
+        output.error("Unauthorized.", hint="Run `bevor link`.")
+        sys.exit(1)
+    except SessionExpiredError:
+        Credentials.delete()
+        output.error("Session Expired. Please re-authenticate", hint="Run `bevor login`.")
         sys.exit(1)
     except InvalidScopeError:
         output.error("Unauthorized: configure a workspace and project.", hint="Run `bevor link`.")
@@ -25,6 +40,7 @@ def main() -> None:
     except typer.Exit as e:
         sys.exit(e.exit_code)
     except Exception as e:
+        print(e, type(e))
         output.error(f"Unexpected error: {e}")
         sys.exit(1)
 

bevor_cli-0.1.1/bevor_cli/settings.py

@@ -0,0 +1,4 @@
+import os
+
+API_URL = os.environ.get("BEVOR_API_URL", "https://api.bevor.io")
+APP_URL = os.environ.get("BEVOR_APP_URL", "https://app.bevor.io")

{bevor_cli-0.1.0 → bevor_cli-0.1.1}/pyproject.toml

@@ -1,10 +1,10 @@
 [project]
 name = "bevor-cli"
-version = "0.1.0"
+version = "0.1.1"
 description = "Bevor CLI tool for security analysis and graph inspection"
 requires-python = ">=3.13"
 dependencies = [
-    "bevor-sdk==0.1.0",
+    "bevor-sdk==0.1.1",
     "typer~=0.26",
     "httpx~=0.28",
     "pydantic~=2.12",
@@ -12,8 +12,10 @@ dependencies = [
     "rich~=15.0",
     "pyyaml~=6.0",
     "click~=8.1",
+    "packaging~=26.2",
 ]
 classifiers = ["Development Status :: 3 - Alpha"]
+readme = "README.md"
 
 [project.scripts]
 bevor = "bevor_cli.main:main"

bevor_cli-0.1.0/PKG-INFO

@@ -1,14 +0,0 @@
-Metadata-Version: 2.5
-Name: bevor-cli
-Version: 0.1.0
-Summary: Bevor CLI tool for security analysis and graph inspection
-Classifier: Development Status :: 3 - Alpha
-Requires-Python: >=3.13
-Requires-Dist: bevor-sdk==0.1.0
-Requires-Dist: click~=8.1
-Requires-Dist: httpx~=0.28
-Requires-Dist: pydantic~=2.12
-Requires-Dist: pyyaml~=6.0
-Requires-Dist: questionary~=2.0
-Requires-Dist: rich~=15.0
-Requires-Dist: typer~=0.26

bevor_cli-0.1.0/bevor_cli/settings.py

@@ -1,4 +0,0 @@
-import os
-
-API_URL = os.environ.get("BEVOR_API_URL", "https://api.bevor.ai")
-APP_URL = os.environ.get("BEVOR_APP_URL", "https://app.bevor.ai")