aevum-cli 0.2.0__py3-none-any.whl

aevum/cli/__init__.py

@@ -0,0 +1,14 @@
+"""
+aevum.cli -- Command-line interface for operating Aevum nodes.
+
+Usage: aevum <command> [options]
+
+Commands:
+    version          Print installed package versions
+    server start     Start the HTTP API server
+    store migrate    Migrate between graph backends
+    complication     Manage installed complications
+    conformance run  Run the conformance suite
+"""
+
+__version__ = "0.1.0"

aevum/cli/__main__.py

@@ -0,0 +1,9 @@
+"""
+Entry point: aevum <command>
+Invoked via [project.scripts] aevum = "aevum.cli.__main__:app"
+"""
+
+from aevum.cli.app import app
+
+if __name__ == "__main__":
+    app()

aevum/cli/app.py

@@ -0,0 +1,22 @@
+"""
+Top-level typer app. Sub-commands registered here.
+"""
+
+from __future__ import annotations
+
+import typer
+
+from aevum.cli.commands import complication, conformance, server, store, version
+
+app = typer.Typer(
+    name="aevum",
+    help="Aevum context kernel -- command-line interface.",
+    no_args_is_help=True,
+    pretty_exceptions_enable=False,
+)
+
+app.add_typer(server.app, name="server")
+app.add_typer(store.app, name="store")
+app.add_typer(complication.app, name="complication")
+app.add_typer(conformance.app, name="conformance")
+app.command(name="version")(version.version_command)

aevum/cli/commands/__init__.py

@@ -0,0 +1 @@
+"""aevum.cli.commands -- sub-command modules."""

aevum/cli/commands/complication.py

@@ -0,0 +1,60 @@
+"""
+aevum complication list/suspend/resume -- manage complications.
+"""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+import typer
+
+app = typer.Typer(help="Manage installed complications.")
+
+
+@app.command("list")
+def list_complications(
+    graph: Annotated[str, typer.Option(help="Graph backend")] = "memory",
+) -> None:
+    """List all installed complications with state and health."""
+    from aevum.core.engine import Engine
+    engine = Engine()
+    complications = engine.list_complications()
+    if not complications:
+        typer.echo("No complications installed.")
+        return
+    typer.echo(f"Installed complications ({len(complications)}):")
+    for name, entry in complications.items():
+        state = entry["state"]
+        typer.echo(f"  {name}: {state}")
+
+
+@app.command("suspend")
+def suspend(
+    name: Annotated[str, typer.Argument(help="Complication name to suspend")],
+) -> None:
+    """Suspend an ACTIVE complication."""
+    from aevum.core.engine import Engine
+    from aevum.core.exceptions import ComplicationError
+    engine = Engine()
+    try:
+        engine.suspend_complication(name)
+        typer.echo(f"Suspended: {name}")
+    except ComplicationError as e:
+        typer.echo(f"Error: {e}", err=True)
+        raise typer.Exit(code=1) from e
+
+
+@app.command("resume")
+def resume(
+    name: Annotated[str, typer.Argument(help="Complication name to resume")],
+) -> None:
+    """Resume a SUSPENDED complication."""
+    from aevum.core.engine import Engine
+    from aevum.core.exceptions import ComplicationError
+    engine = Engine()
+    try:
+        engine.resume_complication(name)
+        typer.echo(f"Resumed: {name}")
+    except ComplicationError as e:
+        typer.echo(f"Error: {e}", err=True)
+        raise typer.Exit(code=1) from e

aevum/cli/commands/conformance.py

@@ -0,0 +1,46 @@
+"""
+aevum conformance run -- run the conformance suite.
+"""
+
+from __future__ import annotations
+
+import subprocess
+from typing import Annotated
+
+import typer
+
+app = typer.Typer(help="Run the Aevum conformance suite.")
+
+
+@app.command("run")
+def run(
+    impl: Annotated[
+        str,
+        typer.Option(help="Python import path to AevumProtocol implementation"),
+    ] = "aevum.core.engine:Engine",
+    verbose: Annotated[bool, typer.Option("--verbose", "-v")] = False,
+) -> None:
+    """
+    Run the aevum-conformance suite against an implementation.
+
+    Requires aevum-conformance to be installed separately:
+        pip install aevum-conformance
+    """
+    try:
+        import importlib
+        importlib.import_module("conformance")
+    except ImportError:
+        typer.echo(
+            "aevum-conformance is not installed. "
+            "Install from: github.com/aevum-labs/aevum-conformance",
+            err=True,
+        )
+        raise typer.Exit(code=1) from None
+
+    args = ["python", "-m", "pytest", "conformance/"]
+    if verbose:
+        args.append("-v")
+
+    typer.echo(f"Running conformance suite against: {impl}")
+    result = subprocess.run(args)
+    raise typer.Exit(code=result.returncode)

aevum/cli/commands/server.py

@@ -0,0 +1,92 @@
+"""
+aevum server start -- start the Aevum HTTP API server.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Annotated
+
+import typer
+import uvicorn
+
+if TYPE_CHECKING:
+    from aevum.core.engine import Engine
+
+app = typer.Typer(help="Manage the Aevum HTTP API server.")
+
+
+@app.command("start")
+def start(
+    host: Annotated[str, typer.Option(help="Bind host")] = "0.0.0.0",
+    port: Annotated[int, typer.Option(help="Bind port")] = 8000,
+    workers: Annotated[int, typer.Option(help="Number of uvicorn workers")] = 1,
+    graph: Annotated[
+        str,
+        typer.Option(
+            help="Graph backend. Options: memory | oxigraph:<path> | postgres:<dsn>"
+        ),
+    ] = "memory",
+    api_key: Annotated[
+        str | None,
+        typer.Option(envvar="AEVUM_API_KEY", help="API key (overrides AEVUM_API_KEY env var)"),
+    ] = None,
+    reload: Annotated[bool, typer.Option(help="Enable auto-reload (dev only)")] = False,
+) -> None:
+    """Start the Aevum HTTP API server."""
+    import os
+
+    if api_key:
+        os.environ["AEVUM_API_KEY"] = api_key
+
+    engine = _build_engine(graph)
+
+    from aevum.server.app import create_app
+    from aevum.server.core.config import Settings
+
+    settings_with_overrides = Settings(
+        host=host,
+        port=port,
+    )
+    app_instance = create_app(engine=engine, settings=settings_with_overrides)
+
+    typer.echo(f"Starting Aevum server on {host}:{port} (graph={graph})")
+    uvicorn.run(
+        app_instance,
+        host=host,
+        port=port,
+        workers=workers if not reload else 1,
+        reload=reload,
+    )
+
+
+def _build_engine(graph: str) -> Engine:
+    """Build an Engine from the --graph flag."""
+    from aevum.core.engine import Engine
+
+    if graph == "memory":
+        typer.echo("Graph backend: in-memory (dev only -- data lost on restart)")
+        return Engine()
+
+    if graph.startswith("oxigraph:"):
+        path = graph[len("oxigraph:"):]
+        from aevum.store.oxigraph import OxigraphStore
+        typer.echo(f"Graph backend: Oxigraph at {path}")
+        return Engine(graph_store=OxigraphStore(path=path))
+
+    if graph.startswith("postgres:"):
+        dsn = graph[len("postgres:"):]
+        try:
+            import psycopg
+            from aevum.store.postgres import PostgresStore
+            from aevum.store.postgres.store import initialize_schema
+            conn = psycopg.connect(dsn)
+            initialize_schema(conn)
+            typer.echo("Graph backend: PostgreSQL")
+            return Engine(graph_store=PostgresStore(conn))
+        except ImportError:
+            typer.echo("Error: aevum-store-postgres is not installed.", err=True)
+            raise typer.Exit(code=1) from None
+
+    typer.echo(f"Unknown graph backend: {graph!r}", err=True)
+    typer.echo("Options: memory | oxigraph:<path> | postgres:<dsn>", err=True)
+    raise typer.Exit(code=1)

aevum/cli/commands/store.py

@@ -0,0 +1,51 @@
+"""
+aevum store migrate -- migrate between graph backends.
+"""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+import typer
+
+app = typer.Typer(help="Manage graph store backends.")
+
+
+@app.command("migrate")
+def migrate(
+    from_backend: Annotated[str, typer.Option("--from", help="Source backend (oxigraph:<path>)")] = "",
+    to_backend: Annotated[str, typer.Option("--to", help="Target backend (postgres:<dsn>)")] = "",
+) -> None:
+    """Migrate graph data between backends."""
+    if not from_backend or not to_backend:
+        typer.echo("Both --from and --to are required.", err=True)
+        raise typer.Exit(code=1)
+
+    if not from_backend.startswith("oxigraph:"):
+        typer.echo(f"Unsupported source backend: {from_backend!r}", err=True)
+        typer.echo("Currently supported source: oxigraph:<path>", err=True)
+        raise typer.Exit(code=1)
+
+    if not to_backend.startswith("postgres:"):
+        typer.echo(f"Unsupported target backend: {to_backend!r}", err=True)
+        typer.echo("Currently supported target: postgres:<dsn>", err=True)
+        raise typer.Exit(code=1)
+
+    try:
+        from aevum.store.postgres.store import migrate_from_oxigraph
+    except ImportError:
+        typer.echo("Error: aevum-store-postgres is not installed.", err=True)
+        raise typer.Exit(code=1) from None
+
+    oxigraph_path = from_backend[len("oxigraph:"):]
+    postgres_dsn = to_backend[len("postgres:"):]
+
+    typer.echo(f"Migrating: {oxigraph_path} -> PostgreSQL")
+    try:
+        import psycopg
+        conn = psycopg.connect(postgres_dsn)
+        migrated = migrate_from_oxigraph(oxigraph_path, conn)
+        typer.echo(f"Migration complete: {migrated} entities transferred.")
+    except Exception as e:
+        typer.echo(f"Migration failed: {e}", err=True)
+        raise typer.Exit(code=1) from e

aevum/cli/commands/version.py

@@ -0,0 +1,32 @@
+"""
+aevum version -- print installed package versions.
+"""
+
+from __future__ import annotations
+
+from importlib.metadata import PackageNotFoundError, version
+
+import typer
+
+_PACKAGES = [
+    "aevum-core",
+    "aevum-server",
+    "aevum-sdk",
+    "aevum-store-oxigraph",
+    "aevum-store-postgres",
+    "aevum-mcp",
+    "aevum-oidc",
+    "aevum-llm",
+    "aevum-cli",
+]
+
+
+def version_command() -> None:
+    """Print versions of all installed Aevum packages."""
+    typer.echo("Aevum package versions:")
+    for pkg in _PACKAGES:
+        try:
+            ver = version(pkg)
+            typer.echo(f"  {pkg}: {ver}")
+        except PackageNotFoundError:
+            typer.echo(f"  {pkg}: not installed")

aevum_cli-0.2.0.dist-info/METADATA

@@ -0,0 +1,36 @@
+Metadata-Version: 2.4
+Name: aevum-cli
+Version: 0.2.0
+Summary: Aevum -- command-line interface for operating Aevum nodes.
+Project-URL: Homepage, https://aevum.build
+Project-URL: Repository, https://github.com/aevum-labs/aevum
+License: Apache-2.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: aevum-core
+Requires-Dist: aevum-server
+Requires-Dist: typer[all]>=0.12
+Requires-Dist: uvicorn[standard]>=0.30
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.9; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# aevum-cli
+
+Command-line interface for Aevum — start the server, manage store migrations, and inspect complication state.
+
+```bash
+pip install aevum-cli
+aevum server start --graph memory
+aevum store migrate postgres:<dsn>
+aevum version
+```
+
+See the [main repository README](https://github.com/aevum-labs/aevum) for full usage.

aevum_cli-0.2.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+aevum/cli/__init__.py,sha256=x2aMTGkjweFxsJbQ_X5DcbrWu0otenHU1WBhbBwvqvc,405
+aevum/cli/__main__.py,sha256=B-UQJhoC1qBUg4VNUeriZs6WB5pK2dSMJSG1q34j5ik,178
+aevum/cli/app.py,sha256=d7r9eoftOkNOq4Djs-z4Oytq43MmEgcLw7JEDNOZIaw,613
+aevum/cli/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+aevum/cli/commands/__init__.py,sha256=q7YtACQ6aH71loaw9VqG1kSpKdc26usgmhtka0JmukI,50
+aevum/cli/commands/complication.py,sha256=kR9wAc5S6LB9PV5XPNRD-UCP2-oS8b9qvYQWoKWC3G8,1853
+aevum/cli/commands/conformance.py,sha256=SbvXZRHXcWoxUFZl-THt9sOdAxhOtABShihdGDxURjE,1263
+aevum/cli/commands/server.py,sha256=aYMs5Xbt7FQDoLqPf80N4hfHR06_cT-CgNBnI-Z3EG4,2981
+aevum/cli/commands/store.py,sha256=wUs_2osNVHd90BtT5h9GEqGRmvi6kYR1hpi7d5gwZcY,1886
+aevum/cli/commands/version.py,sha256=Gm4zassenyJ4ioAq8YHtTMwdaoUTqq9O_S0_Fu-GE4U,732
+aevum_cli-0.2.0.dist-info/METADATA,sha256=_FE4GJFGgZc-wHByK6YW7JdIDObvPegIP00F_fpvIVM,1193
+aevum_cli-0.2.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+aevum_cli-0.2.0.dist-info/entry_points.txt,sha256=bWoOLtXc2CMbW3VitiSdI0NzSnVOnnLdIdrORwDic10,49
+aevum_cli-0.2.0.dist-info/RECORD,,

aevum_cli-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

aevum_cli-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+aevum = aevum.cli.__main__:app