feat(cli): add --version flag (closes #2)

src/agentcorp/cli.py

@@ -16,6 +16,7 @@
 import logging
 import signal
 import sys
+from importlib import metadata as importlib_metadata
 from pathlib import Path
 from typing import Any
 
@@ -36,6 +37,34 @@
     help="AgentCorp — local-first, event-sourced multi-agent delivery orchestrator.",
 )
 
+
+def _agentcorp_version() -> str:
+    """Installed distribution version; in a source checkout fall back to the in-tree value."""
+    try:
+        return importlib_metadata.version("agentcorp")
+    except importlib_metadata.PackageNotFoundError:  # pragma: no cover - source checkout
+        return "0.1.0"
+
+
+def _version_callback(value: bool) -> None:
+    if value:
+        typer.echo(f"agentcorp {_agentcorp_version()}")
+        raise typer.Exit()
+
+
+@app.callback()
+def _main(
+    version: bool = typer.Option(
+        False,
+        "--version",
+        callback=_version_callback,
+        is_eager=True,
+        help="Show the version and exit.",
+    ),
+) -> None:
+    """AgentCorp — local-first, event-sourced multi-agent delivery orchestrator."""
+
+
 DEFAULT_DB = ".agentcorp/agentcorp.db"
 
 

tests/test_cli_version.py

@@ -0,0 +1,15 @@
+"""``agentcorp --version`` stays wired to the installed distribution metadata."""
+
+from __future__ import annotations
+
+import re
+
+from typer.testing import CliRunner
+
+from agentcorp.cli import app
+
+
+def test_version_flag_prints_package_version() -> None:
+    result = CliRunner().invoke(app, ["--version"])
+    assert result.exit_code == 0
+    assert re.fullmatch(r"agentcorp \d+\.\d+\.\d+\n", result.output)