refactor: remove the Ray execution skeleton — ship only what runs

Ray was a NotImplementedError stub advertising a feature that never worked. Removed
execution/ray_backend.py + tests/test_execution_ray_graceful.py, the RayExecutor export, the
`[ray]` extra (and its slot in `all`), the `--execution ray` choice + the run-suite guard, and the
dead `ExecutionSpec.ray_address` field. Local is the only executor. ruff clean, 370 tests, mkdocs
--strict green.

Author: copparihollmann

AGENTS.md

@@ -65,6 +65,3 @@ Data flow: `transcript.jsonl → import_transcript → RunTrajectory → (emit_t
   indirection. If trimming: extract the pure report-**writers** (`write_summary_metrics`,
   `write_eval_report`, `write_metrics_structured`, `write_run_record`) into a `tracking/reports.py`
   of free functions — low-risk, reduces size *and* coupling.
-- Ray executor: `execution/ray_backend.py` is a `NotImplementedError` skeleton + a heavy `[ray]`
-  extra, now undocumented. Candidate for full removal (backend + extra + `--execution ray` choice +
-  its test) so the package advertises only what runs.

CHANGELOG.md

@@ -102,6 +102,11 @@ All notable changes to `aet` are recorded here.
   score <baseline−0.05.
 - **`aet runs`** and **`aet show`** CLI subcommands for listing and inspecting recorded runs.
 
+### Removed
+- **Ray execution backend** — it was a `NotImplementedError` skeleton advertising a feature that
+  didn't run. Removed the backend, the `[ray]` extra, the `--execution ray` choice, and its docs/test.
+  Only the local executor ships (ship only what's real).
+
 ### Changed
 - **Lint-clean + enforced**: repo is `ruff`-clean; `[tool.ruff]`/`[tool.pytest.ini_options]` pinned in
   `pyproject.toml`; the `all` extra now composes the other extras (single source of truth) + a new

pyproject.toml

@@ -22,12 +22,11 @@ openllmetry = [
     "opentelemetry-instrumentation-anthropic>=0.55",
     "opentelemetry-instrumentation-openai>=0.55",
 ]
-ray    = ["ray[default]>=2.40"]
 viz    = ["matplotlib>=3.7", "numpy>=1.24"]
 docs   = ["mkdocs>=1.6", "mkdocs-material>=9.5", "mkdocstrings[python]>=0.26"]
 dev    = ["pytest>=8.0", "ruff", "jsonschema>=4.0"]
 # `all` composes the other extras (single source of truth — no hand-duplicated pins).
-all    = ["aet[tracking,openllmetry,ray,viz,docs,dev]"]
+all    = ["aet[tracking,openllmetry,viz,docs,dev]"]
 
 [project.scripts]
 aet = "aet.cli.main:main"

src/aet/cli/_common.py

@@ -16,7 +16,7 @@ def _add_global_args(p: argparse.ArgumentParser) -> None:
     )
     p.add_argument(
         "--execution",
-        choices=["local", "ray"],
+        choices=["local"],
         default="local",
         help="Execution backend (default: local)",
     )

src/aet/cli/commands/lifecycle.py

@@ -188,12 +188,6 @@ def _cmd_validate(args) -> None:
 
 
 def _cmd_run_suite(args) -> None:
-    if args.execution == "ray":
-        raise NotImplementedError(
-            "Ray execution backend is not yet implemented. "
-            "Use --execution local to run locally."
-        )
-
     methods = [m.strip() for m in args.methods.split(",")]
     seeds = [int(s.strip()) for s in args.seeds.split(",")]
     combos = [(method, seed) for method in methods for seed in seeds]

src/aet/execution/__init__.py

@@ -1,3 +1,3 @@
 from aet.execution.local_backend import LocalExecutor
-from aet.execution.ray_backend import RayExecutor
-__all__ = ["LocalExecutor", "RayExecutor"]
+
+__all__ = ["LocalExecutor"]

src/aet/execution/ray_backend.py

@@ -4,5 +4,4 @@
 @dataclass
 class ExecutionSpec:
     backend: str = "local"
-    ray_address: str | None = None
     max_concurrency: int = 1