roar-cli 0.2.3__tar.gz → 0.2.7__tar.gz

{roar_cli-0.2.3 → roar_cli-0.2.7}/PKG-INFO

@@ -1,14 +1,6 @@
 Metadata-Version: 2.4
 Name: roar-cli
-Version: 0.2.3
-Summary: Reproducibility and provenance tracker for ML training pipelines
-Author-email: TReqs Team <info@treqs.ai>
-License-Expression: Apache-2.0
-Project-URL: Homepage, https://github.com/treqs/roar
-Project-URL: Repository, https://github.com/treqs/roar
-Project-URL: Documentation, https://github.com/treqs/roar#readme
-Project-URL: Issues, https://github.com/treqs/roar/issues
-Keywords: machine-learning,reproducibility,lineage,provenance,mlops,data-versioning,artifact-tracking
+Version: 0.2.7
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Science/Research
@@ -21,28 +13,36 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Version Control
 Classifier: Typing :: Typed
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
 Requires-Dist: blake3>=0.3.0
 Requires-Dist: click>=8.1.0
 Requires-Dist: dependency-injector>=4.40.0
+Requires-Dist: msgpack>=1.0.0
 Requires-Dist: sqlalchemy>=2.0.0
-Requires-Dist: pysqlite3-binary>=0.5.0
+Requires-Dist: pysqlite3-binary>=0.5.0 ; platform_machine == 'x86_64' and sys_platform == 'linux'
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: pydantic-settings>=2.0.0
-Requires-Dist: tomli>=2.0.0; python_version < "3.11"
+Requires-Dist: tomli>=2.0.0 ; python_full_version < '3.11'
+Requires-Dist: pytest>=7.0.0 ; extra == 'dev'
+Requires-Dist: pytest-timeout>=2.0.0 ; extra == 'dev'
+Requires-Dist: pytest-mock>=3.10.0 ; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0 ; extra == 'dev'
+Requires-Dist: pytest-xdist>=3.5.0 ; extra == 'dev'
+Requires-Dist: ruff>=0.8.0 ; extra == 'dev'
+Requires-Dist: mypy>=1.13.0 ; extra == 'dev'
+Requires-Dist: boto3>=1.28.0 ; extra == 'dev'
+Requires-Dist: google-cloud-storage>=2.10.0 ; extra == 'dev'
 Provides-Extra: dev
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: pytest-timeout>=2.0.0; extra == "dev"
-Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
-Requires-Dist: pytest-xdist>=3.5.0; extra == "dev"
-Requires-Dist: ruff>=0.8.0; extra == "dev"
-Requires-Dist: mypy>=1.13.0; extra == "dev"
-Requires-Dist: boto3>=1.28.0; extra == "dev"
-Requires-Dist: google-cloud-storage>=2.10.0; extra == "dev"
-Dynamic: license-file
+License-File: LICENSE
+Summary: Reproducibility and provenance tracker for ML training pipelines
+Keywords: machine-learning,reproducibility,lineage,provenance,mlops,data-versioning,artifact-tracking
+Author-email: TReqs Team <info@treqs.ai>
+License-Expression: Apache-2.0
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Documentation, https://github.com/treqs/roar#readme
+Project-URL: Homepage, https://github.com/treqs/roar
+Project-URL: Issues, https://github.com/treqs/roar/issues
+Project-URL: Repository, https://github.com/treqs/roar
 
 # roar
 
@@ -62,7 +62,7 @@ pip install roar-cli
 uv pip install roar-cli
 ```
 
-Requires Python 3.10+ and Linux (x86_64 or aarch64).
+Requires Python 3.10+.
 
 ### Platform Support
 
@@ -70,10 +70,10 @@ Requires Python 3.10+ and Linux (x86_64 or aarch64).
 | ------------- | -------------- |
 | Linux x86_64  | ✅ Full support |
 | Linux aarch64 | ✅ Full support |
-| macOS         | Coming soon    |
+| macOS         | 🚧 Experimental ([limitations](#macos-tracing-limitations)) |
 | Windows       | Coming soon    |
 
-macOS and Windows support are planned for future releases.
+PyPI wheels are published for Linux and macOS (`x86_64` and `arm64`).
 
 ### Development Installation
 
@@ -82,7 +82,7 @@ macOS and Windows support are planned for future releases.
 git clone https://github.com/treqs/roar.git
 cd roar
 
-# Install in development mode (automatically builds tracer if Rust is installed)
+# Install in development mode
 uv pip install -e ".[dev]"
 # or without uv
 pip install -e ".[dev]"
@@ -101,6 +101,67 @@ roar run python train.py --data features.parquet --output model.pt
 roar run python evaluate.py --model model.pt --output metrics.json
 ```
 
+## Tracer Backends
+
+`roar run` relies on a Rust "tracer" binary to observe file I/O. If you see an error like "No tracer binary found", build one of the backends below.
+
+### Backends
+
+| Backend | Binary | Platforms | Notes |
+| --- | --- | --- | --- |
+| eBPF | `roar-tracer-ebpf` | Linux | Fastest, but requires permissions and kernel support. |
+| preload | `roar-tracer-preload` + `libroar_tracer_preload` | macOS, Linux | Uses `DYLD_INSERT_LIBRARIES` (macOS) or `LD_PRELOAD` (Linux). Not compatible with processes that ignore preload env vars (e.g., SIP/hardened runtime on macOS), or fully-static binaries (common with Go). |
+| ptrace | `roar-tracer` | Linux | Slowest, broadest compatibility on Linux. |
+
+### Building
+
+```bash
+cd rust
+
+# eBPF (Linux)
+cargo build --release -p roar-tracer-ebpf
+
+# preload (macOS & Linux)
+cargo build --release -p roar-tracer-preload
+
+# ptrace (Linux)
+cargo build --release -p roar-tracer
+```
+
+### Selecting A Backend
+
+By default, `roar` uses `auto` mode: prefer eBPF, then preload, then ptrace.
+
+```bash
+# Show what roar can currently find and whether it looks usable
+roar tracer status
+
+# Set a default backend (auto|ebpf|preload|ptrace)
+roar tracer set-default preload
+```
+
+### macOS Tracing Limitations
+
+On macOS, `roar` uses the `preload` backend (`DYLD_INSERT_LIBRARIES`). macOS System Integrity Protection (SIP) silently blocks library injection for Apple-signed platform binaries — anything under `/usr/bin/`, `/bin/`, `/sbin/`, or `/System/`. When this happens, `roar run` will complete successfully but capture no file I/O events.
+
+**Affected:** `/usr/bin/python3`, `/bin/sh`, `/usr/bin/ruby`, and all other Apple-shipped binaries.
+
+**Workaround:** Use non-Apple builds of your tools:
+
+```bash
+# Homebrew
+brew install python3
+roar run python3 train.py          # Uses /opt/homebrew/bin/python3 — works
+
+# conda / pyenv / nix also work
+roar run ~/.pyenv/shims/python train.py
+
+# This will NOT capture file events (SIP blocks it):
+roar run /usr/bin/python3 train.py
+```
+
+`roar` prints a warning when it detects no events were captured from a SIP-protected binary.
+
 ## Commands
 
 ### `roar init`
@@ -428,7 +489,7 @@ roar auth test
 ### Setup
 
 ```bash
-# Install dev dependencies (automatically builds tracer if Rust is installed)
+# Install dev dependencies
 uv pip install -e ".[dev]"
 ```
 
@@ -467,3 +528,4 @@ pytest tests/ -v -m "not integration and not e2e and not glaas and not live_glaa
 ## License
 
 Apache 2.0
+

roar_cli-0.2.3/roar_cli.egg-info/PKG-INFO → roar_cli-0.2.7/README.md

@@ -1,49 +1,3 @@
-Metadata-Version: 2.4
-Name: roar-cli
-Version: 0.2.3
-Summary: Reproducibility and provenance tracker for ML training pipelines
-Author-email: TReqs Team <info@treqs.ai>
-License-Expression: Apache-2.0
-Project-URL: Homepage, https://github.com/treqs/roar
-Project-URL: Repository, https://github.com/treqs/roar
-Project-URL: Documentation, https://github.com/treqs/roar#readme
-Project-URL: Issues, https://github.com/treqs/roar/issues
-Keywords: machine-learning,reproducibility,lineage,provenance,mlops,data-versioning,artifact-tracking
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Science/Research
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Classifier: Topic :: Software Development :: Version Control
-Classifier: Typing :: Typed
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: blake3>=0.3.0
-Requires-Dist: click>=8.1.0
-Requires-Dist: dependency-injector>=4.40.0
-Requires-Dist: sqlalchemy>=2.0.0
-Requires-Dist: pysqlite3-binary>=0.5.0
-Requires-Dist: pydantic>=2.0.0
-Requires-Dist: pydantic-settings>=2.0.0
-Requires-Dist: tomli>=2.0.0; python_version < "3.11"
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: pytest-timeout>=2.0.0; extra == "dev"
-Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
-Requires-Dist: pytest-xdist>=3.5.0; extra == "dev"
-Requires-Dist: ruff>=0.8.0; extra == "dev"
-Requires-Dist: mypy>=1.13.0; extra == "dev"
-Requires-Dist: boto3>=1.28.0; extra == "dev"
-Requires-Dist: google-cloud-storage>=2.10.0; extra == "dev"
-Dynamic: license-file
-
 # roar
 
 **Run Observation & Artifact Registration**
@@ -62,7 +16,7 @@ pip install roar-cli
 uv pip install roar-cli
 ```
 
-Requires Python 3.10+ and Linux (x86_64 or aarch64).
+Requires Python 3.10+.
 
 ### Platform Support
 
@@ -70,10 +24,10 @@ Requires Python 3.10+ and Linux (x86_64 or aarch64).
 | ------------- | -------------- |
 | Linux x86_64  | ✅ Full support |
 | Linux aarch64 | ✅ Full support |
-| macOS         | Coming soon    |
+| macOS         | 🚧 Experimental ([limitations](#macos-tracing-limitations)) |
 | Windows       | Coming soon    |
 
-macOS and Windows support are planned for future releases.
+PyPI wheels are published for Linux and macOS (`x86_64` and `arm64`).
 
 ### Development Installation
 
@@ -82,7 +36,7 @@ macOS and Windows support are planned for future releases.
 git clone https://github.com/treqs/roar.git
 cd roar
 
-# Install in development mode (automatically builds tracer if Rust is installed)
+# Install in development mode
 uv pip install -e ".[dev]"
 # or without uv
 pip install -e ".[dev]"
@@ -101,6 +55,67 @@ roar run python train.py --data features.parquet --output model.pt
 roar run python evaluate.py --model model.pt --output metrics.json
 ```
 
+## Tracer Backends
+
+`roar run` relies on a Rust "tracer" binary to observe file I/O. If you see an error like "No tracer binary found", build one of the backends below.
+
+### Backends
+
+| Backend | Binary | Platforms | Notes |
+| --- | --- | --- | --- |
+| eBPF | `roar-tracer-ebpf` | Linux | Fastest, but requires permissions and kernel support. |
+| preload | `roar-tracer-preload` + `libroar_tracer_preload` | macOS, Linux | Uses `DYLD_INSERT_LIBRARIES` (macOS) or `LD_PRELOAD` (Linux). Not compatible with processes that ignore preload env vars (e.g., SIP/hardened runtime on macOS), or fully-static binaries (common with Go). |
+| ptrace | `roar-tracer` | Linux | Slowest, broadest compatibility on Linux. |
+
+### Building
+
+```bash
+cd rust
+
+# eBPF (Linux)
+cargo build --release -p roar-tracer-ebpf
+
+# preload (macOS & Linux)
+cargo build --release -p roar-tracer-preload
+
+# ptrace (Linux)
+cargo build --release -p roar-tracer
+```
+
+### Selecting A Backend
+
+By default, `roar` uses `auto` mode: prefer eBPF, then preload, then ptrace.
+
+```bash
+# Show what roar can currently find and whether it looks usable
+roar tracer status
+
+# Set a default backend (auto|ebpf|preload|ptrace)
+roar tracer set-default preload
+```
+
+### macOS Tracing Limitations
+
+On macOS, `roar` uses the `preload` backend (`DYLD_INSERT_LIBRARIES`). macOS System Integrity Protection (SIP) silently blocks library injection for Apple-signed platform binaries — anything under `/usr/bin/`, `/bin/`, `/sbin/`, or `/System/`. When this happens, `roar run` will complete successfully but capture no file I/O events.
+
+**Affected:** `/usr/bin/python3`, `/bin/sh`, `/usr/bin/ruby`, and all other Apple-shipped binaries.
+
+**Workaround:** Use non-Apple builds of your tools:
+
+```bash
+# Homebrew
+brew install python3
+roar run python3 train.py          # Uses /opt/homebrew/bin/python3 — works
+
+# conda / pyenv / nix also work
+roar run ~/.pyenv/shims/python train.py
+
+# This will NOT capture file events (SIP blocks it):
+roar run /usr/bin/python3 train.py
+```
+
+`roar` prints a warning when it detects no events were captured from a SIP-protected binary.
+
 ## Commands
 
 ### `roar init`
@@ -428,7 +443,7 @@ roar auth test
 ### Setup
 
 ```bash
-# Install dev dependencies (automatically builds tracer if Rust is installed)
+# Install dev dependencies
 uv pip install -e ".[dev]"
 ```
 

{roar_cli-0.2.3 → roar_cli-0.2.7}/pyproject.toml

@@ -1,10 +1,10 @@
 [build-system]
-requires = ["setuptools>=61.0"]
-build-backend = "setuptools.build_meta"
+requires = ["maturin>=1.11.5,<2.0"]
+build-backend = "maturin"
 
 [project]
 name = "roar-cli"
-version = "0.2.3"
+version = "0.2.7"
 description = "Reproducibility and provenance tracker for ML training pipelines"
 authors = [
     { name="TReqs Team", email="info@treqs.ai" }
@@ -39,8 +39,9 @@ dependencies = [
     "blake3>=0.3.0",
     "click>=8.1.0",
     "dependency-injector>=4.40.0",
+    "msgpack>=1.0.0",
     "sqlalchemy>=2.0.0",
-    "pysqlite3-binary>=0.5.0",  # Fallback when stdlib sqlite3 unavailable
+    "pysqlite3-binary>=0.5.0; sys_platform == 'linux' and platform_machine == 'x86_64'",  # Fallback when stdlib sqlite3 unavailable
     "pydantic>=2.0.0",
     "pydantic-settings>=2.0.0",
     "tomli>=2.0.0; python_version < '3.11'",
@@ -68,28 +69,36 @@ dev = [
 [project.scripts]
 # This registers `roar` on PATH after pip install
 roar = "roar.__main__:main"
+roar-worker = "roar.ray.roar_worker:main"
 
-[tool.setuptools.packages.find]
-where = ["."]
-include = ["roar", "roar.*"]
-
-[tool.setuptools.package-data]
-roar = ["bin/*"]
+[tool.maturin]
+manifest-path = "rust/crates/artifact-hash-py/Cargo.toml"
+python-source = "."
+module-name = "roar._hash_native"
+bindings = "pyo3"
+include = [
+    { path = "LICENSE", format = "sdist" },
+    { path = "LICENSE", format = "wheel" },
+    { path = "roar/bin/*", format = "sdist" },
+    { path = "roar/bin/*", format = "wheel" },
+]
 
 [tool.pytest.ini_options]
 # Parallel execution enabled by default with pytest-xdist
 # - Uses --dist loadfile to keep same-file tests in same worker (avoids cwd race conditions)
-# - live_glaas tests must be run separately with --dist no (sequential)
+# - Default profile excludes tests requiring root/eBPF and live GLaaS dependencies
 testpaths = ["tests"]
 markers = [
     "integration: Integration tests (uses fixtures)",
     "e2e: End-to-end tests (full workflows)",
     "glaas: Tests requiring GLaaS server",
     "live_glaas: Tests requiring live GLaaS API running locally",
+    "ebpf: Tests requiring eBPF daemon/root privileges",
     "cloud: Tests for cloud storage operations",
     "happy_path: Happy path tests for core functionality",
+    "ray_e2e: Ray end-to-end tests requiring a running Docker cluster",
 ]
-addopts = "-v --strict-markers -n auto --dist loadfile"
+addopts = "-v --strict-markers -n auto --dist loadfile --ignore=tests/ebpf --ignore=tests/live_glaas --ignore=tests/benchmarks --ignore=tests/integration --ignore=tests/e2e"
 timeout = 60
 filterwarnings = [
     "ignore::DeprecationWarning",

{roar_cli-0.2.3 → roar_cli-0.2.7}/roar/cli/__init__.py

@@ -38,6 +38,7 @@ LAZY_COMMANDS: dict[str, tuple[str, str, str]] = {
     "lineage": ("roar.cli.commands.lineage", "lineage", "Show lineage for an artifact"),
     "log": ("roar.cli.commands.log", "log", "Show execution log"),
     "pop": ("roar.cli.commands.pop", "pop", "Pop the last step from the session"),
+    "proxy": ("roar.cli.commands.proxy", "proxy", "Manage S3 proxy for lineage tracking"),
     "put": ("roar.cli.commands.put", "put", "Publish artifacts to cloud storage"),
     "register": ("roar.cli.commands.register", "register", "Register artifacts or jobs"),
     "reproduce": ("roar.cli.commands.reproduce", "reproduce", "Reproduce an artifact"),
@@ -45,6 +46,7 @@ LAZY_COMMANDS: dict[str, tuple[str, str, str]] = {
     "run": ("roar.cli.commands.run", "run", "Run a command with provenance tracking"),
     "show": ("roar.cli.commands.show", "show", "Show details of a job or artifact"),
     "status": ("roar.cli.commands.status", "status", "Show current session status"),
+    "tracer": ("roar.cli.commands.tracer", "tracer", "Manage tracer backend defaults"),
 }
 
 

roar_cli-0.2.7/roar/cli/commands/__init__.py

@@ -0,0 +1,70 @@
+"""
+Click command implementations for roar CLI.
+
+This package contains the Click-based command implementations that
+replace the legacy command classes. Each module corresponds to a
+roar command (e.g., run.py implements 'roar run').
+
+Commands are lazily imported via the LazyCommand mechanism in roar.cli.
+This __init__ defers all imports to avoid loading every command module
+when only one command is invoked.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    import click
+
+_COMMAND_MODULES: dict[str, tuple[str, str]] = {
+    "auth": (".auth", "auth"),
+    "build": (".build", "build"),
+    "config": (".config", "config"),
+    "dag": (".dag", "dag"),
+    "env": (".env", "env"),
+    "get": (".get", "get"),
+    "init": (".init", "init"),
+    "lineage": (".lineage", "lineage"),
+    "log": (".log", "log"),
+    "pop": (".pop", "pop"),
+    "put": (".put", "put"),
+    "register": (".register", "register"),
+    "reproduce": (".reproduce", "reproduce"),
+    "reset": (".reset", "reset"),
+    "run": (".run", "run"),
+    "show": (".show", "show"),
+    "status": (".status", "status"),
+    "tracer": (".tracer", "tracer"),
+}
+
+
+def get_migrated_commands() -> list[click.Command]:
+    """Import and return all command objects (used by legacy registration paths)."""
+    import importlib
+
+    commands = []
+    for module_path, attr_name in _COMMAND_MODULES.values():
+        mod = importlib.import_module(module_path, __name__)
+        commands.append(getattr(mod, attr_name))
+    return commands
+
+
+def __getattr__(name: str):
+    if name == "MIGRATED_COMMANDS":
+        return get_migrated_commands()
+    if name in _COMMAND_MODULES:
+        import importlib
+
+        module_path, attr_name = _COMMAND_MODULES[name]
+        mod = importlib.import_module(module_path, __name__)
+        value = getattr(mod, attr_name)
+        globals()[name] = value
+        return value
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+__all__ = [
+    "MIGRATED_COMMANDS",
+    *_COMMAND_MODULES.keys(),
+]

{roar_cli-0.2.3 → roar_cli-0.2.7}/roar/cli/commands/_execution.py

@@ -19,39 +19,47 @@ if TYPE_CHECKING:
     from ..context import RoarContext
 
 
-def validate_git_clean() -> tuple[str, dict]:
+def validate_git_clean() -> str:
     """
-    Validate git repository is clean and return git info.
+    Validate git repository is clean and return repo root.
 
-    This function checks:
-    1. We're inside a git repository
-    2. The working tree has no uncommitted changes
+    Lightweight pre-fork check using git subprocesses directly, avoiding
+    the heavy bootstrap/import cascade. Git info (commit, branch, etc.)
+    is collected by the ProvenanceService after the fork.
 
     Returns:
-        Tuple of (repo_root, git_info) where git_info contains:
-        - commit: Current commit hash
-        - branch: Current branch name
-        - remote_url: Remote origin URL
+        Repository root path
 
     Raises:
         click.ClickException: If not in a git repo or has uncommitted changes
     """
-    from ...core.bootstrap import bootstrap
-    from ...core.container import get_container
-
-    # Bootstrap container to ensure VCS provider is registered
-    bootstrap()
-
-    vcs = get_container().get_vcs_provider("git")
-    repo_root = vcs.get_repo_root()
-
-    if not repo_root:
+    import subprocess
+
+    # Find repo root (no bootstrap needed)
+    try:
+        repo_root = subprocess.check_output(
+            ["git", "rev-parse", "--show-toplevel"],
+            stderr=subprocess.DEVNULL,
+            text=True,
+        ).strip()
+    except (subprocess.CalledProcessError, FileNotFoundError):
         raise click.ClickException(
             "roar requires the working directory to be inside a git repository."
-        )
-
-    clean, changes = vcs.get_status(repo_root)
-    if not clean:
+        ) from None
+
+    # Check dirty status
+    try:
+        status_output = subprocess.check_output(
+            ["git", "status", "--porcelain"],
+            stderr=subprocess.DEVNULL,
+            text=True,
+            cwd=repo_root,
+        ).strip()
+    except (subprocess.CalledProcessError, FileNotFoundError):
+        status_output = ""
+
+    if status_output:
+        changes = status_output.split("\n")
         lines = ["Git repo has uncommitted changes:"]
         for change in changes[:5]:
             lines.append(f"  {change}")
@@ -61,15 +69,7 @@ def validate_git_clean() -> tuple[str, dict]:
         lines.append("Commit your changes before running this command.")
         raise click.ClickException("\n".join(lines))
 
-    # Get git info
-    vcs_info = vcs.get_info(repo_root)
-    git_info = {
-        "commit": vcs_info.commit if vcs_info else None,
-        "branch": vcs_info.branch if vcs_info else None,
-        "remote_url": vcs_info.remote_url if vcs_info else None,
-    }
-
-    return repo_root, git_info
+    return repo_root
 
 
 def get_quiet_setting(quiet_flag: bool | None, repo_root: str | Path) -> bool:
@@ -99,10 +99,12 @@ def execute_and_report(
     ctx: "RoarContext",
     command: list[str],
     job_type: str | None,
+    step_name: str | None,
     quiet: bool,
     hash_algorithms: list[str],
-    git_info: dict,
     repo_root: str,
+    tracer_mode: str | None = None,
+    tracer_fallback: bool | None = None,
 ) -> int:
     """
     Execute command via coordinator and show report.
@@ -118,9 +120,9 @@ def execute_and_report(
         ctx: RoarContext with roar_dir and other context
         command: Command to execute as list of strings
         job_type: Job type - None for run, "build" for build
+        step_name: Optional user-defined step label
         quiet: Whether to suppress output
         hash_algorithms: List of hash algorithms to use
-        git_info: Git info dict with commit, branch, remote_url
         repo_root: Git repository root path
 
     Returns:
@@ -128,9 +130,28 @@ def execute_and_report(
     """
     from typing import Literal, cast
 
+    from ...config import config_get
+    from ...core.bootstrap import bootstrap
     from ...core.interfaces.run import RunContext
-    from ...presenters.run_report import RunReportPresenter
-    from ...services.execution import RunCoordinator
+    from ...services.execution.coordinator import RunCoordinator
+
+    # Ensure plugin/provider registries (including VCS=git) are populated.
+    bootstrap(ctx.roar_dir)
+
+    # Check if S3 proxy is enabled
+    proxy_service = None
+    if config_get("proxy.enabled"):
+        from ...services.execution.proxy import ProxyService
+
+        proxy_service = ProxyService()
+        if not proxy_service.find_proxy():
+            click.echo(
+                "Error: S3 proxy is enabled but roar-proxy binary not found.\n"
+                "Build it with: cargo build --release --manifest-path rust/Cargo.toml -p roar-proxy\n"
+                "Or disable: roar proxy disable",
+                err=True,
+            )
+            return 1
 
     # Create run context
     hash_algos = cast(list[Literal["blake3", "sha256", "sha512", "md5"]], hash_algorithms)
@@ -140,19 +161,20 @@ def execute_and_report(
         repo_root=repo_root,
         command=command,
         job_type=job_type_literal,
+        step_name=step_name,
         quiet=quiet,
         hash_algorithms=hash_algos,
-        git_commit=git_info.get("commit"),
-        git_branch=git_info.get("branch"),
-        git_repo=git_info.get("remote_url"),
+        tracer_mode=tracer_mode,  # type: ignore[arg-type]
+        tracer_fallback=tracer_fallback,
     )
 
     # Execute via coordinator
-    coordinator = RunCoordinator()
+    coordinator = RunCoordinator(proxy_service=proxy_service)
     result = coordinator.execute(run_ctx)
 
     # Present report
     from ...presenters.console import ConsolePresenter
+    from ...presenters.run_report import RunReportPresenter
 
     presenter = ConsolePresenter()
     report = RunReportPresenter(presenter)