roar-cli 0.2.8__tar.gz → 0.2.10__tar.gz

{roar_cli-0.2.8 → roar_cli-0.2.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: roar-cli
-Version: 0.2.8
+Version: 0.2.10
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Science/Research
@@ -15,6 +15,7 @@ Classifier: Topic :: Software Development :: Version Control
 Classifier: Typing :: Typed
 Requires-Dist: blake3>=0.3.0
 Requires-Dist: click>=8.1.0
+Requires-Dist: cryptography>=42.0.0
 Requires-Dist: dependency-injector>=4.40.0
 Requires-Dist: msgpack>=1.0.0
 Requires-Dist: sqlalchemy>=2.0.0
@@ -66,12 +67,12 @@ Requires Python 3.10+.
 
 ### Platform Support
 
-| Platform      | Status         |
-| ------------- | -------------- |
-| Linux x86_64  | ✅ Full support |
-| Linux aarch64 | ✅ Full support |
+| Platform      | Status                                                      |
+| ------------- | ----------------------------------------------------------- |
+| Linux x86_64  | ✅ Full support                                             |
+| Linux aarch64 | ✅ Full support                                             |
 | macOS         | 🚧 Experimental ([limitations](#macos-tracing-limitations)) |
-| Windows       | Coming soon    |
+| Windows       | Coming soon                                                 |
 
 PyPI wheels are published for Linux and macOS (`x86_64` and `arm64`).
 
@@ -107,11 +108,11 @@ roar run python evaluate.py --model model.pt --output metrics.json
 
 ### Backends
 
-| Backend | Binary | Platforms | Notes |
-| --- | --- | --- | --- |
-| eBPF | `roar-tracer-ebpf` | Linux | Fastest, but requires permissions and kernel support. |
+| 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. |
+| ptrace  | `roar-tracer`                                    | Linux        | Slowest, broadest compatibility on Linux.                                                                                                                                                                  |
 
 ### Building
 
@@ -259,19 +260,19 @@ roar config set <key> <value>
 
 Run `roar config list` to see all available options with descriptions. Common options:
 
-| Key                            | Default              | Description                             |
-| ------------------------------ | -------------------- | --------------------------------------- |
-| `output.track_repo_files`      | false                | Include repo files in provenance        |
-| `output.quiet`                 | false                | Suppress written files report           |
-| `filters.ignore_system_reads`  | true                 | Ignore /sys, /etc, /sbin reads          |
-| `filters.ignore_package_reads` | true                 | Ignore installed package reads          |
-| `filters.ignore_torch_cache`   | true                 | Ignore torch/triton cache               |
-| `filters.ignore_tmp_files`     | true                 | Ignore /tmp files                       |
+| Key                            | Default                | Description                             |
+| ------------------------------ | ---------------------- | --------------------------------------- |
+| `output.track_repo_files`      | false                  | Include repo files in provenance        |
+| `output.quiet`                 | false                  | Suppress written files report           |
+| `filters.ignore_system_reads`  | true                   | Ignore /sys, /etc, /sbin reads          |
+| `filters.ignore_package_reads` | true                   | Ignore installed package reads          |
+| `filters.ignore_torch_cache`   | true                   | Ignore torch/triton cache               |
+| `filters.ignore_tmp_files`     | true                   | Ignore /tmp files                       |
 | `glaas.url`                    | <https://api.glaas.ai> | GLaaS server URL                        |
 | `glaas.web_url`                | <https://glaas.ai>     | GLaaS web UI URL                        |
-| `registration.omit.enabled`    | true                 | Enable secret filtering                 |
-| `hash.primary`                 | blake3               | Primary hash algorithm                  |
-| `logging.level`                | warning              | Log level (debug, info, warning, error) |
+| `registration.omit.enabled`    | true                   | Enable secret filtering                 |
+| `hash.primary`                 | blake3                 | Primary hash algorithm                  |
+| `logging.level`                | warning                | Log level (debug, info, warning, error) |
 
 ### `roar dag`
 
@@ -305,14 +306,30 @@ roar log                  # Show recent job history
 
 ### `roar register`
 
-Register artifact lineage with GLaaS.
+Register session, job, step, or artifact lineage with GLaaS.
 
 ```bash
 roar register model.pt              # Register model lineage
 roar register --dry-run model.pt    # Preview without registering
 roar register -y model.pt           # Skip confirmation prompt
+roar register @4                    # Register lineage for DAG step 4
+roar register deadbeef              # Register lineage for a local job UID
+roar register 7f1e...c9a4           # Register lineage for a tracked artifact hash
+roar register 8d7a1f2c...           # Register a whole local session
+roar register s3://bucket/run/out   # Register a tracked remote S3 artifact
 ```
 
+**Supported targets:**
+
+- Local artifact path: `model.pt`, `./outputs/metrics.json`
+- Tracked artifact hash: primitive or composite
+- Local job UID: full UID or unique prefix
+- Step reference: `@N` or `@BN`
+- Local session hash: full hash or unique prefix
+- Tracked remote path: `s3://...`
+
+For bare 8-character hex targets, `roar register` prefers a matching local job UID before falling back to session-hash-prefix resolution.
+
 ### `roar put`
 
 Upload artifacts to cloud storage and register lineage with GLaaS.
@@ -324,11 +341,13 @@ roar put @2 s3://bucket/outputs/ -m "Step 2 outputs"
 ```
 
 **Options:**
+
 - `-m, --message` — Description of the upload (required)
 - `--dry-run` — Preview without uploading
 - `--no-tag` — Skip git tagging
 
 **Source formats:**
+
 - File path: `model.pt`, `./data/output.csv`
 - Directory: `./checkpoints/` (uploads all files recursively)
 - Job reference: `@2` (uploads outputs from step 2)
@@ -346,6 +365,7 @@ roar get s3://bucket/checkpoints/ ./local/ # Download all files under prefix
 ```
 
 **Options:**
+
 - `-m, --message` — Annotation for this download
 - `--hash` — Expected BLAKE3 hash (for verification)
 - `--tag` — Create a git tag for this download
@@ -393,6 +413,7 @@ roar pop -y           # Pop without confirmation (skip prompt)
 ```
 
 **What it does:**
+
 - Removes the last job from the session history
 - Deletes output artifacts created by that job (unless they're packages/system files)
 - Does not affect the original input files
@@ -443,7 +464,7 @@ Add `.roar/` to your `.gitignore` (roar offers to do this during `roar init`).
 
 ## GLaaS Server
 
-Roar can register artifacts and jobs with a GLaaS (Global Lineage-as-a-Service) server using the `roar register` command.
+Roar can register sessions, jobs, steps, and artifacts with a GLaaS (Global Lineage-as-a-Service) server using the `roar register` command.
 
 ### Server Setup
 
@@ -479,6 +500,9 @@ roar auth register
 roar auth test
 ```
 
+> [!TIP]
+> Roar activity can be registered without authentication. Unauthenticated registrations are attributed to a public "anonymous" user, but are not guaranteed persistence. For persistent attribution, we recommend setting up `roar auth`.
+
 ## Development
 
 ### Prerequisites

{roar_cli-0.2.8 → roar_cli-0.2.10}/README.md

@@ -20,12 +20,12 @@ Requires Python 3.10+.
 
 ### Platform Support
 
-| Platform      | Status         |
-| ------------- | -------------- |
-| Linux x86_64  | ✅ Full support |
-| Linux aarch64 | ✅ Full support |
+| Platform      | Status                                                      |
+| ------------- | ----------------------------------------------------------- |
+| Linux x86_64  | ✅ Full support                                             |
+| Linux aarch64 | ✅ Full support                                             |
 | macOS         | 🚧 Experimental ([limitations](#macos-tracing-limitations)) |
-| Windows       | Coming soon    |
+| Windows       | Coming soon                                                 |
 
 PyPI wheels are published for Linux and macOS (`x86_64` and `arm64`).
 
@@ -61,11 +61,11 @@ roar run python evaluate.py --model model.pt --output metrics.json
 
 ### Backends
 
-| Backend | Binary | Platforms | Notes |
-| --- | --- | --- | --- |
-| eBPF | `roar-tracer-ebpf` | Linux | Fastest, but requires permissions and kernel support. |
+| 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. |
+| ptrace  | `roar-tracer`                                    | Linux        | Slowest, broadest compatibility on Linux.                                                                                                                                                                  |
 
 ### Building
 
@@ -213,19 +213,19 @@ roar config set <key> <value>
 
 Run `roar config list` to see all available options with descriptions. Common options:
 
-| Key                            | Default              | Description                             |
-| ------------------------------ | -------------------- | --------------------------------------- |
-| `output.track_repo_files`      | false                | Include repo files in provenance        |
-| `output.quiet`                 | false                | Suppress written files report           |
-| `filters.ignore_system_reads`  | true                 | Ignore /sys, /etc, /sbin reads          |
-| `filters.ignore_package_reads` | true                 | Ignore installed package reads          |
-| `filters.ignore_torch_cache`   | true                 | Ignore torch/triton cache               |
-| `filters.ignore_tmp_files`     | true                 | Ignore /tmp files                       |
+| Key                            | Default                | Description                             |
+| ------------------------------ | ---------------------- | --------------------------------------- |
+| `output.track_repo_files`      | false                  | Include repo files in provenance        |
+| `output.quiet`                 | false                  | Suppress written files report           |
+| `filters.ignore_system_reads`  | true                   | Ignore /sys, /etc, /sbin reads          |
+| `filters.ignore_package_reads` | true                   | Ignore installed package reads          |
+| `filters.ignore_torch_cache`   | true                   | Ignore torch/triton cache               |
+| `filters.ignore_tmp_files`     | true                   | Ignore /tmp files                       |
 | `glaas.url`                    | <https://api.glaas.ai> | GLaaS server URL                        |
 | `glaas.web_url`                | <https://glaas.ai>     | GLaaS web UI URL                        |
-| `registration.omit.enabled`    | true                 | Enable secret filtering                 |
-| `hash.primary`                 | blake3               | Primary hash algorithm                  |
-| `logging.level`                | warning              | Log level (debug, info, warning, error) |
+| `registration.omit.enabled`    | true                   | Enable secret filtering                 |
+| `hash.primary`                 | blake3                 | Primary hash algorithm                  |
+| `logging.level`                | warning                | Log level (debug, info, warning, error) |
 
 ### `roar dag`
 
@@ -259,14 +259,30 @@ roar log                  # Show recent job history
 
 ### `roar register`
 
-Register artifact lineage with GLaaS.
+Register session, job, step, or artifact lineage with GLaaS.
 
 ```bash
 roar register model.pt              # Register model lineage
 roar register --dry-run model.pt    # Preview without registering
 roar register -y model.pt           # Skip confirmation prompt
+roar register @4                    # Register lineage for DAG step 4
+roar register deadbeef              # Register lineage for a local job UID
+roar register 7f1e...c9a4           # Register lineage for a tracked artifact hash
+roar register 8d7a1f2c...           # Register a whole local session
+roar register s3://bucket/run/out   # Register a tracked remote S3 artifact
 ```
 
+**Supported targets:**
+
+- Local artifact path: `model.pt`, `./outputs/metrics.json`
+- Tracked artifact hash: primitive or composite
+- Local job UID: full UID or unique prefix
+- Step reference: `@N` or `@BN`
+- Local session hash: full hash or unique prefix
+- Tracked remote path: `s3://...`
+
+For bare 8-character hex targets, `roar register` prefers a matching local job UID before falling back to session-hash-prefix resolution.
+
 ### `roar put`
 
 Upload artifacts to cloud storage and register lineage with GLaaS.
@@ -278,11 +294,13 @@ roar put @2 s3://bucket/outputs/ -m "Step 2 outputs"
 ```
 
 **Options:**
+
 - `-m, --message` — Description of the upload (required)
 - `--dry-run` — Preview without uploading
 - `--no-tag` — Skip git tagging
 
 **Source formats:**
+
 - File path: `model.pt`, `./data/output.csv`
 - Directory: `./checkpoints/` (uploads all files recursively)
 - Job reference: `@2` (uploads outputs from step 2)
@@ -300,6 +318,7 @@ roar get s3://bucket/checkpoints/ ./local/ # Download all files under prefix
 ```
 
 **Options:**
+
 - `-m, --message` — Annotation for this download
 - `--hash` — Expected BLAKE3 hash (for verification)
 - `--tag` — Create a git tag for this download
@@ -347,6 +366,7 @@ roar pop -y           # Pop without confirmation (skip prompt)
 ```
 
 **What it does:**
+
 - Removes the last job from the session history
 - Deletes output artifacts created by that job (unless they're packages/system files)
 - Does not affect the original input files
@@ -397,7 +417,7 @@ Add `.roar/` to your `.gitignore` (roar offers to do this during `roar init`).
 
 ## GLaaS Server
 
-Roar can register artifacts and jobs with a GLaaS (Global Lineage-as-a-Service) server using the `roar register` command.
+Roar can register sessions, jobs, steps, and artifacts with a GLaaS (Global Lineage-as-a-Service) server using the `roar register` command.
 
 ### Server Setup
 
@@ -433,6 +453,9 @@ roar auth register
 roar auth test
 ```
 
+> [!TIP]
+> Roar activity can be registered without authentication. Unauthenticated registrations are attributed to a public "anonymous" user, but are not guaranteed persistence. For persistent attribution, we recommend setting up `roar auth`.
+
 ## Development
 
 ### Prerequisites

{roar_cli-0.2.8 → roar_cli-0.2.10}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "roar-cli"
-version = "0.2.8"
+version = "0.2.10"
 description = "Reproducibility and provenance tracker for ML training pipelines"
 authors = [
     { name="TReqs Team", email="info@treqs.ai" }
@@ -38,6 +38,7 @@ classifiers = [
 dependencies = [
     "blake3>=0.3.0",
     "click>=8.1.0",
+    "cryptography>=42.0.0",
     "dependency-injector>=4.40.0",
     "msgpack>=1.0.0",
     "sqlalchemy>=2.0.0",
@@ -69,7 +70,10 @@ dev = [
 [project.scripts]
 # This registers `roar` on PATH after pip install
 roar = "roar.__main__:main"
-roar-worker = "roar.ray.roar_worker:main"
+roar-worker = "roar.execution.runtime.worker_bootstrap:main"
+
+[project.entry-points."roar.execution_backends"]
+ray = "roar.backends.ray.plugin:register"
 
 [tool.maturin]
 manifest-path = "rust/crates/artifact-hash-py/Cargo.toml"
@@ -81,6 +85,7 @@ include = [
     { path = "LICENSE", format = "wheel" },
     { path = "roar/bin/*", format = "sdist" },
     { path = "roar/bin/*", format = "wheel" },
+    { path = "roar_inject.pth", format = "wheel" },
 ]
 
 [tool.pytest.ini_options]
@@ -96,9 +101,13 @@ markers = [
     "ebpf: Tests requiring eBPF daemon/root privileges",
     "cloud: Tests for cloud storage operations",
     "happy_path: Happy path tests for core functionality",
+    "diagnostic: Opt-in diagnostics or aspirational performance budgets outside the default gate",
+    "large_pipeline: Stress-style pipeline coverage with larger DAG fixtures",
     "ray_e2e: Ray end-to-end tests requiring a running Docker cluster",
+    "ray_contract: User-facing Ray contract tests using `roar run ray job submit ...`",
+    "ray_diagnostic: Diagnostic Ray tests that intentionally inspect internal runtime details",
 ]
-addopts = "-v --strict-markers -n auto --dist loadfile --ignore=tests/ebpf --ignore=tests/live_glaas --ignore=tests/benchmarks --ignore=tests/integration --ignore=tests/e2e"
+addopts = "-v --strict-markers -n auto --dist loadfile --ignore=tests/ebpf --ignore=tests/live_glaas --ignore=tests/benchmarks --ignore=tests/e2e --ignore=tests/integration/test_cli_startup.py --ignore=tests/execution/runtime/test_sitecustomize_perf.py --ignore-glob=tests/backends/*/e2e --ignore-glob=tests/backends/*/live"
 timeout = 60
 filterwarnings = [
     "ignore::DeprecationWarning",
@@ -130,6 +139,7 @@ ignore = ["E501", "B008", "SIM108"]
 
 [tool.ruff.lint.per-file-ignores]
 "tests/**/*.py" = ["B011", "B017"]
+"tests/backends/*/e2e/jobs/**/*.py" = ["I001"]
 
 [tool.ruff.lint.isort]
 known-first-party = ["roar"]

roar_cli-0.2.10/roar/application/__init__.py

@@ -0,0 +1 @@
+"""Application workflow entrypoints."""

roar_cli-0.2.10/roar/application/get/__init__.py

@@ -0,0 +1,7 @@
+"""Application entrypoints for `roar get` workflows."""
+
+from .requests import GetRequest
+from .results import GetDownloadedFile, GetDryRunItem, GetResponse
+from .service import get_artifacts
+
+__all__ = ["GetDownloadedFile", "GetDryRunItem", "GetRequest", "GetResponse", "get_artifacts"]

roar_cli-0.2.10/roar/application/get/requests.py

@@ -0,0 +1,22 @@
+"""Request DTOs for `roar get` application flows."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from pathlib import Path
+
+
+@dataclass(frozen=True)
+class GetRequest:
+    """Application request for a get workflow."""
+
+    source: str
+    destination: Path
+    roar_dir: Path
+    cwd: Path
+    repo_root: Path | None = None
+    message: str | None = None
+    expected_hash: str | None = None
+    dry_run: bool = False
+    force: bool = False
+    tag: bool = False

roar_cli-0.2.10/roar/application/get/results.py

@@ -0,0 +1,35 @@
+"""Typed result DTOs for `roar get` application flows."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+
+@dataclass(frozen=True)
+class GetDownloadedFile:
+    remote_url: str
+    local_path: str
+    hash: str | None = None
+    size: int | None = None
+
+
+@dataclass(frozen=True)
+class GetDryRunItem:
+    remote_url: str
+    local_path: str
+
+
+@dataclass(frozen=True)
+class GetResponse:
+    """Application response for a get workflow."""
+
+    success: bool
+    source: str
+    job_id: int | None = None
+    job_uid: str | None = None
+    downloaded_files: list[GetDownloadedFile] = field(default_factory=list)
+    dry_run: bool = False
+    would_download: list[GetDryRunItem] = field(default_factory=list)
+    git_tag: str | None = None
+    warnings: list[str] = field(default_factory=list)
+    error: str | None = None

roar_cli-0.2.10/roar/application/get/service.py

@@ -0,0 +1,169 @@
+"""Application orchestration for `roar get` workflows."""
+
+from __future__ import annotations
+
+import time
+
+from ...application.git import build_roar_git_tag_name, create_roar_git_tag, resolve_git_state
+from ...core.bootstrap import bootstrap
+from ...core.logging import get_logger
+from ...core.operation_metadata import build_operation_metadata_json
+from ...db.context import create_database_context
+from ...execution.recording import LocalJobRecorder, LocalRecordedArtifact
+from ...integrations.download import parse_source, resolve_download_backend
+from .requests import GetRequest
+from .results import GetDownloadedFile, GetResponse
+from .transfer import GetService, GetTransferResult
+
+
+def get_artifacts(request: GetRequest) -> GetResponse:
+    """Execute the `roar get` application workflow."""
+    bootstrap(request.roar_dir)
+    logger = get_logger()
+
+    parsed_source = parse_source(request.source)
+    backend = resolve_download_backend(request.source)
+    repo_root = request.repo_root or request.cwd
+    is_prefix = request.source.rstrip("/") != request.source or parsed_source.is_prefix
+
+    git_commit = None
+    if not request.dry_run:
+        try:
+            git_commit = resolve_git_state(repo_root).commit
+            logger.debug("Git commit: %s", git_commit)
+        except Exception as exc:
+            logger.debug("Git operation failed (non-fatal for get): %s", exc)
+
+    with create_database_context(request.roar_dir) as db_ctx:
+        service = GetService(
+            backend=backend,
+            source=parsed_source,
+            repo_root=repo_root,
+        )
+        transfer_result = service.get(
+            destination=request.destination,
+            expected_hash=request.expected_hash,
+            dry_run=request.dry_run,
+            force=request.force,
+            is_prefix=is_prefix,
+        )
+
+        result = _materialize_get_result(
+            db_ctx=db_ctx,
+            request=request,
+            parsed_source=parsed_source,
+            transfer_result=transfer_result,
+            git_commit=git_commit,
+        )
+
+    git_tag_name = None
+    warnings: list[str] = []
+    if request.tag and git_commit and result.success and not result.dry_run:
+        git_tag_name = build_roar_git_tag_name(git_commit)
+        try:
+            success, tag_error = create_roar_git_tag(repo_root, git_tag_name)
+            if not success:
+                git_tag_name = None
+                if tag_error:
+                    warnings.append(f"Could not create git tag: {tag_error}")
+        except Exception as exc:
+            git_tag_name = None
+            warnings.append(f"Could not create git tag: {exc}")
+
+    return GetResponse(
+        success=result.success,
+        source=request.source,
+        job_id=result.job_id,
+        job_uid=result.job_uid,
+        downloaded_files=result.downloaded_files,
+        dry_run=result.dry_run,
+        would_download=result.would_download,
+        git_tag=git_tag_name,
+        warnings=warnings,
+        error=result.error,
+    )
+
+
+def _materialize_get_result(
+    *,
+    db_ctx,
+    request: GetRequest,
+    parsed_source,
+    transfer_result: GetTransferResult,
+    git_commit: str | None,
+) -> GetResponse:
+    if transfer_result.dry_run or not transfer_result.success:
+        return GetResponse(
+            success=transfer_result.success,
+            source=request.source,
+            downloaded_files=transfer_result.downloaded_files,
+            dry_run=transfer_result.dry_run,
+            would_download=transfer_result.would_download,
+            error=transfer_result.error,
+        )
+
+    metadata_json = _build_get_operation_metadata_json(
+        request=request,
+        parsed_source=parsed_source,
+        downloaded_files=transfer_result.downloaded_files,
+        git_commit=git_commit,
+    )
+    recorder = LocalJobRecorder()
+    output_artifacts = [
+        LocalRecordedArtifact(
+            path=file_info.local_path,
+            hashes={"blake3": str(file_info.hash)},
+            size=int(file_info.size or 0),
+        )
+        for file_info in transfer_result.downloaded_files
+    ]
+    job_id, job_uid = recorder.record(
+        db_ctx,
+        command=_build_get_command(request),
+        timestamp=time.time(),
+        metadata=metadata_json,
+        execution_backend="local",
+        execution_role="host",
+        job_type="get",
+        output_artifacts=output_artifacts,
+        exit_code=0,
+    )
+    return GetResponse(
+        success=True,
+        source=request.source,
+        job_id=job_id,
+        job_uid=job_uid,
+        downloaded_files=transfer_result.downloaded_files,
+    )
+
+
+def _build_get_command(request: GetRequest) -> str:
+    command = f"roar get {request.source}"
+    if request.message:
+        command += f' -m "{request.message}"'
+    return command
+
+
+def _build_get_operation_metadata_json(
+    *,
+    request: GetRequest,
+    parsed_source,
+    downloaded_files: list[GetDownloadedFile],
+    git_commit: str | None,
+) -> str:
+    artifact_urls: dict[str, str] = {}
+    for file_info in downloaded_files:
+        artifact_urls[file_info.local_path] = file_info.remote_url
+
+    return build_operation_metadata_json(
+        "get",
+        {
+            "source": request.source,
+            "source_type": parsed_source.scheme,
+            "message": request.message,
+            "artifacts": artifact_urls,
+            "git_commit": git_commit,
+            "git_tag": None,
+            "timestamp": time.time(),
+        },
+    )