feat(cli): scaffold evalhub CLI entry point and command groups

Author: ruivieira

pyproject.toml

@@ -49,6 +49,12 @@ client = [
     "eval-hub-sdk[core]",
 ]
 
+# CLI - command-line interface
+cli = [
+    "eval-hub-sdk[core]",
+    "click>=8.1.0",
+]
+
 # Development dependencies
 # NOTE: Versions should match .pre-commit-config.yaml and .github/workflows/pre-commit.yml
 dev = [
@@ -67,7 +73,10 @@ examples = [
 ]
 
 # All core functionality (excludes examples which are optional)
-all = ["eval-hub-sdk[core,adapter,client,dev]"]
+all = ["eval-hub-sdk[core,adapter,client,cli,dev]"]
+
+[project.scripts]
+evalhub = "evalhub.cli:main"
 
 [project.urls]
 Homepage = "https://github.com/eval-hub"

src/evalhub/cli/__init__.py

@@ -0,0 +1,5 @@
+"""EvalHub CLI - command-line interface for EvalHub."""
+
+from .main import main
+
+__all__ = ["main"]

src/evalhub/cli/main.py

@@ -0,0 +1,37 @@
+"""EvalHub CLI entry point and command groups."""
+
+import click
+
+import evalhub
+
+
+@click.group(context_settings={"help_option_names": ["-h", "--help"]})
+@click.version_option(version=evalhub.__version__, prog_name="evalhub")
+def main() -> None:
+    """EvalHub CLI - manage evaluations, providers, collections, and configuration."""
+
+
+@main.command()
+def version() -> None:
+    """Print version and build info."""
+    click.echo(f"evalhub {evalhub.__version__}")
+
+
+@main.group()
+def eval() -> None:
+    """Submit and manage evaluation jobs."""
+
+
+@main.group()
+def collections() -> None:
+    """Browse and manage benchmark collections."""
+
+
+@main.group()
+def providers() -> None:
+    """List and inspect evaluation providers."""
+
+
+@main.group()
+def config() -> None:
+    """View and update CLI configuration."""