stackops 8.98__tar.gz → 8.100__tar.gz

stackops-8.100/PKG-INFO

@@ -0,0 +1,118 @@
+Metadata-Version: 2.4
+Name: stackops
+Version: 8.100
+Summary: Developer Stack Manager
+Author-email: Alex Al-Saffar <programmer@usa.com>
+License: Apache 2.0
+Project-URL: Homepage, https://github.com/thisismygitrepo/stackops
+Project-URL: Bug Tracker, https://github.com/thisismygitrepo/stackops/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: fire>=0.7.1
+Requires-Dist: gitpython>=3.1.46
+Requires-Dist: joblib>=1.5.3
+Requires-Dist: paramiko>=4.0.0
+Requires-Dist: psutil>=7.2.2
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: questionary>=2.1.1
+Requires-Dist: randomname>=0.2.1
+Requires-Dist: requests>=2.32.5
+Requires-Dist: rich>=14.3.3
+Requires-Dist: tenacity>=9.1.4
+Requires-Dist: typer>=0.24.1
+Provides-Extra: windows
+Provides-Extra: plot
+
+<div align="center">
+
+<h1>🗜 StackOps</h1>
+
+<strong>Digital Life Manager.</strong>
+
+<p>
+  <a href="https://thisismygitrepo.github.io/stackops/"><img alt="Docs" src="https://img.shields.io/badge/docs-online-2f6f6f"></a>
+  <a href="https://pypi.org/project/stackops/"><img alt="PyPI package" src="https://img.shields.io/pypi/v/stackops?color=2f6f6f"></a>
+  <img alt="Python 3.13+" src="https://img.shields.io/badge/python-3.13%2B-3776AB">
+  <img alt="Installed with uv" src="https://img.shields.io/badge/install-uv-f05d23">
+</p>
+
+</div>
+
+StackOps is a cross-platform CLI for managing your development stack. It is package installer, configurator, dotfile/secrets manager, data and code sync solution, command launcher, processes orchestator (is there anything else?) all wrapped into one solution. As such, it should take a few minutes to make a fresh new machine to look like the machine you were customizing for 10 years.
+
+
+| Before | After |
+| --- | --- |
+| ![Fresh minimal machine state](docs/assets/before.png) | ![Developer-ready machine state](docs/assets/after.png) |
+
+
+See the [online docs](https://thisismygitrepo.github.io/stackops/) for full usage and reference material.
+
+## Install
+
+Choose your platform and expand only the commands you need.
+
+<details>
+<summary><strong>Linux</strong></summary>
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+# OR: . < (curl -L https://bit.ly/sopsu)
+```
+
+</details>
+
+<details>
+<summary><strong>macOS</strong></summary>
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+# OR: . < (curl -L https://bit.ly/sopsu)
+```
+
+</details>
+
+<details>
+<summary><strong>Windows PowerShell</strong></summary>
+
+```powershell
+powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+# OR: irm bit.ly/sopsw | iex
+```
+
+</details>
+
+
+## Quick Init
+
+Run these once StackOps is installed.
+
+```bash
+devops install --group sysabc
+devops config copy-assets all
+devops config sync down \
+  --sensitivity public \
+  --method copy \
+  --on-conflict overwrite-default-path \
+  --which all
+devops config terminal config-shell --which default
+devops install --group termabc
+```
+
+
+## Author
+
+Alex Al-Saffar. [email](mailto:programmer@usa.com)
+
+## Contributor
+
+Ruby Chan. [email](mailto:ruby.chan@sa.gov.au)

stackops-8.100/README.md

@@ -0,0 +1,90 @@
+<div align="center">
+
+<h1>🗜 StackOps</h1>
+
+<strong>Digital Life Manager.</strong>
+
+<p>
+  <a href="https://thisismygitrepo.github.io/stackops/"><img alt="Docs" src="https://img.shields.io/badge/docs-online-2f6f6f"></a>
+  <a href="https://pypi.org/project/stackops/"><img alt="PyPI package" src="https://img.shields.io/pypi/v/stackops?color=2f6f6f"></a>
+  <img alt="Python 3.13+" src="https://img.shields.io/badge/python-3.13%2B-3776AB">
+  <img alt="Installed with uv" src="https://img.shields.io/badge/install-uv-f05d23">
+</p>
+
+</div>
+
+StackOps is a cross-platform CLI for managing your development stack. It is package installer, configurator, dotfile/secrets manager, data and code sync solution, command launcher, processes orchestator (is there anything else?) all wrapped into one solution. As such, it should take a few minutes to make a fresh new machine to look like the machine you were customizing for 10 years.
+
+
+| Before | After |
+| --- | --- |
+| ![Fresh minimal machine state](docs/assets/before.png) | ![Developer-ready machine state](docs/assets/after.png) |
+
+
+See the [online docs](https://thisismygitrepo.github.io/stackops/) for full usage and reference material.
+
+## Install
+
+Choose your platform and expand only the commands you need.
+
+<details>
+<summary><strong>Linux</strong></summary>
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+# OR: . < (curl -L https://bit.ly/sopsu)
+```
+
+</details>
+
+<details>
+<summary><strong>macOS</strong></summary>
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+# OR: . < (curl -L https://bit.ly/sopsu)
+```
+
+</details>
+
+<details>
+<summary><strong>Windows PowerShell</strong></summary>
+
+```powershell
+powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+# OR: irm bit.ly/sopsw | iex
+```
+
+</details>
+
+
+## Quick Init
+
+Run these once StackOps is installed.
+
+```bash
+devops install --group sysabc
+devops config copy-assets all
+devops config sync down \
+  --sensitivity public \
+  --method copy \
+  --on-conflict overwrite-default-path \
+  --which all
+devops config terminal config-shell --which default
+devops install --group termabc
+```
+
+
+## Author
+
+Alex Al-Saffar. [email](mailto:programmer@usa.com)
+
+## Contributor
+
+Ruby Chan. [email](mailto:ruby.chan@sa.gov.au)

stackops-8.100/pyproject.toml

@@ -0,0 +1,163 @@
+[build-system]
+requires = ["setuptools>=80", "wheel"]
+build-backend = "setuptools.build_meta"
+# requires = ["hatchling"]
+# build-backend = "hatchling.build"
+
+[project]
+name = "stackops"
+version = "8.100"
+description = "Developer Stack Manager"
+readme = "README.md"
+license = {text = "Apache 2.0"}
+authors = [
+    {name = "Alex Al-Saffar", email = "programmer@usa.com"},
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+]
+requires-python = ">=3.13"
+dependencies = [
+    "fire>=0.7.1",
+    "gitpython>=3.1.46",
+    "joblib>=1.5.3",
+    "paramiko>=4.0.0",
+    "psutil>=7.2.2",
+    "pyyaml>=6.0.3",
+    "questionary>=2.1.1",
+    "randomname>=0.2.1",
+    "requests>=2.32.5",
+    "rich>=14.3.3",
+    "tenacity>=9.1.4",
+    "typer>=0.24.1",
+]
+
+[project.optional-dependencies]
+windows = []
+plot = [
+
+]
+
+
+[project.urls]
+"Homepage" = "https://github.com/thisismygitrepo/stackops"
+"Bug Tracker" = "https://github.com/thisismygitrepo/stackops/issues"
+
+[project.scripts]
+devops = "stackops.scripts.python.devops:main"
+cloud = "stackops.scripts.python.cloud:main"
+fire = "stackops.scripts.python.fire_jobs:main"
+agents = "stackops.scripts.python.agents:main"
+terminal = "stackops.scripts.python.terminal:main"
+croshell = "stackops.scripts.python.croshell:main"
+utils = "stackops.scripts.python.utils:main"
+stackops = "stackops.scripts.python.stackops_entry:main"
+seek = "stackops.scripts.python.seek:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+include-package-data = true
+license-files = []
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+stackops = ["**/*.toml", "**/*.md", "**/*.sh", "**/*.ps1", "**/*.txt", "utils/schemas/**/*.json"]
+
+[dependency-groups]
+dev = [
+    "aider>=0.2.6",
+    "build>=1.4.1",
+    "cleanpy>=0.5.1",
+    "cowsay>=6.1",
+    "duckdb>=1.5.1",
+    "gdown>=5.2.1",
+    "griffe>=2.0.2",
+    "ipdb>=0.13.13",
+    "ipykernel>=7.2.0",
+    "ipython>=9.11.0",
+    "kaleido>=1.2.0",
+    "marimo>=0.21.1",
+    "matplotlib>=3.10.8",
+    "mkdocstrings>=1.0.3",
+    "mkdocstrings-python>=2.0.3",
+    "mypy>=1.19.1",
+    "numpy>=2.4.3",
+    "pandas>=3.0.1",
+    "plotly>=6.6.0",
+    "polars>=1.39.3",
+    "pre-commit>=4.5.1",
+    "pudb>=2025.1.5",
+    "py7zr>=1.1.0",
+    "pydantic>=2.12.5",
+    "pydeps>=3.0.2",
+    "pyinstaller>=6.19.0",
+    "pylint>=4.0.5",
+    "pylsp-mypy>=0.7.1",
+    "pymupdf>=1.27.2.2",
+    "pypdf>=6.9.2",
+    "pyrefly>=0.58.0",
+    "pyright>=1.1.408",
+    "pytest>=9.0.2",
+    "python-lsp-server[mypy]>=1.14.0",
+    "qrcode>=8.2",
+    "ruff>=0.15.7",
+    "ruff-lsp>=0.0.62",
+    "sqlalchemy>=2.0.48",
+    "textual>=8.1.1",
+    "trogon>=0.6.0",
+    "ty>=0.0.25",
+    "types-mysqlclient>=2.2.0.20250915",
+    "types-paramiko>=4.0.0.20260322",
+    "types-pytz>=2026.1.1.20260304",
+    "types-pyyaml>=6.0.12.20250915",
+    "types-requests>=2.32.4.20260324",
+    "types-sqlalchemy>=1.4.53.38",
+    "types-toml>=0.10.8.20240310",
+    "types-urllib3>=1.26.25.14",
+    "vt-py>=0.22.0",
+    "yapf>=0.43.0",
+    "zensical>=0.0.29",
+]
+other = [
+    "duckdb-engine>=0.17.0",
+    "pycrucible>=0.4.6",
+    "vt-py>=0.22.0",
+]
+plot = [
+    "duckdb>=1.5.1",
+    "ipykernel>=7.2.0",
+    "ipython>=9.11.0",
+    "jupyterlab>=4.5.6",
+    "kaleido>=1.2.0",
+    "matplotlib>=3.10.8",
+    "nbformat>=5.10.4",
+    "numpy>=2.4.3",
+    "plotly>=6.6.0",
+    "polars>=1.39.3",
+    "python-magic>=0.4.27",
+    "sqlalchemy>=2.0.48",
+]
+
+
+[tool.pycrucible]
+entry = "src/stackops/scripts/python/devops.py"
+[tool.pycrucible.options]
+debug = false
+extract_to_temp = false
+delete_after_run = false
+offline_mode = false
+
+[tool.pycrucible.patterns]
+include = [
+    "**/*.py",
+    "**/*.ps1",
+    "**/*.sh",
+    "**/*.md",
+]
+exclude = [
+    "**/__pycache__/**",
+]

stackops-8.100/src/stackops/cluster/remote/remote_machine.py

@@ -0,0 +1,274 @@
+
+import inspect
+from types import FunctionType
+from typing import Callable
+from typing import cast
+from pathlib import Path
+from datetime import datetime
+
+from rich.console import Console
+from rich.panel import Panel
+from rich.syntax import Syntax
+
+from stackops.utils.accessories import randstr
+from stackops.utils.io import save_json
+from stackops.utils.files.read import read_json
+from stackops.utils.ssh import SSH
+from stackops.cluster.remote.models import RemoteStackOpsConfig, EmailParams
+from stackops.cluster.remote.job_params import JobParams
+from stackops.cluster.remote.file_manager import FileManager
+from stackops.cluster.remote.execution_script import render_execution_script
+from stackops.cluster.remote.notification import render_notification_block
+from stackops.cluster.remote.data_transfer import transfer_sftp, transfer_cloud
+
+console = Console()
+
+
+class RemoteMachine:
+    def __init__(self, func: str | Path | Callable[..., object], config: RemoteStackOpsConfig, func_kwargs: dict[str, object] | None, data: list[str] | None) -> None:
+        self.config = config
+        if isinstance(func, str | Path):
+            self.job_params = JobParams.from_script(str(func))
+        elif inspect.isfunction(func):
+            self.job_params = JobParams.from_callable(func)
+        elif inspect.ismethod(func):
+            self.job_params = JobParams.from_callable(cast(FunctionType, func.__func__))
+        else:
+            raise TypeError("func must be a script path, function, or bound method.")
+        if config.workload_params is not None and func_kwargs is not None:
+            if "workload_params" in func_kwargs:
+                raise ValueError("workload_params provided in both config and func_kwargs")
+        self.kwargs: dict[str, object] = func_kwargs or {}
+        self.data: list[str] = data if data is not None else []
+        self.ssh: SSH | None = None
+        self.file_manager = FileManager(job_id=config.job_id, remote_machine_type="Linux", lock_resources=config.lock_resources, max_simultaneous_jobs=config.max_simultaneous_jobs, base=config.base_dir)
+        self.submitted: bool = False
+        self.scripts_generated: bool = False
+        self.results_downloaded: bool = False
+        self.results_path: Path | None = None
+
+    def __repr__(self) -> str:
+        ssh_repr = self.ssh.get_remote_repr(add_machine=True) if self.ssh else (self.config.ssh_host or "local")
+        return f"RemoteMachine({ssh_repr})"
+
+    def to_dict(self) -> dict[str, object]:
+        return {"config": self.config.to_dict(), "job_params": self.job_params.to_dict(), "file_manager": self.file_manager.to_dict(), "kwargs": self.kwargs, "data": self.data, "submitted": self.submitted, "scripts_generated": self.scripts_generated, "results_downloaded": self.results_downloaded, "results_path": str(self.results_path) if self.results_path else None}
+
+    @staticmethod
+    def from_dict(d: dict[str, object]) -> "RemoteMachine":
+        rm = RemoteMachine.__new__(RemoteMachine)
+        config_data = d["config"]
+        if not isinstance(config_data, dict):
+            raise TypeError("config must be a dict")
+        job_params_data = d["job_params"]
+        if not isinstance(job_params_data, dict):
+            raise TypeError("job_params must be a dict")
+        file_manager_data = d["file_manager"]
+        if not isinstance(file_manager_data, dict):
+            raise TypeError("file_manager must be a dict")
+        rm.config = RemoteStackOpsConfig.from_dict(config_data)
+        rm.job_params = JobParams.from_dict(job_params_data)
+        rm.file_manager = FileManager.from_dict(file_manager_data)
+        kwargs_raw = d.get("kwargs")
+        rm.kwargs = dict(kwargs_raw) if isinstance(kwargs_raw, dict) else {}
+        data_raw = d.get("data")
+        rm.data = [str(item) for item in data_raw] if isinstance(data_raw, list) else []
+        rm.submitted = bool(d.get("submitted", False))
+        rm.scripts_generated = bool(d.get("scripts_generated", False))
+        rm.results_downloaded = bool(d.get("results_downloaded", False))
+        rm.results_path = Path(str(d["results_path"])) if d.get("results_path") else None
+        rm.ssh = None
+        return rm
+
+    @staticmethod
+    def from_job_dir(job_dir: Path) -> "RemoteMachine":
+        data_dir = job_dir / "data"
+        rm_json = data_dir / "remote_machine.json"
+        d: dict[str, object] = read_json(rm_json)
+        return RemoteMachine.from_dict(d)
+
+    def _ensure_ssh(self) -> SSH:
+        if self.ssh is None:
+            if self.config.ssh_host is None:
+                raise ValueError("ssh_host must be set in config to connect to a remote machine")
+            self.ssh = SSH.from_config_file(host=self.config.ssh_host)
+        return self.ssh
+
+    def generate_scripts(self) -> None:
+        console.rule(f"Generating scripts for job `{self.file_manager.job_id}` @ {self!r}")
+        self.job_params.ssh_repr = repr(self.ssh) if self.ssh else ""
+        self.job_params.ssh_repr_remote = self.ssh.get_remote_repr() if self.ssh else ""
+        self.job_params.description = self.config.description
+        self.job_params.file_manager_path = str(self.file_manager.file_manager_path)
+        self.job_params.session_name = "TS-" + randstr(noun=True)
+        self.job_params.tab_name = f"job-{self.file_manager.job_id}"
+
+        execution_line = self.job_params.get_execution_line(parallelize=self.config.parallelize, workload_params=self.config.workload_params, wrap_in_try_except=self.config.wrap_in_try_except)
+
+        notification_block = ""
+        if self.config.notify_upon_completion:
+            assert self.config.email_config_name is not None
+            assert self.config.to_email is not None
+            email_params = EmailParams(
+                addressee=self.ssh.get_local_repr(add_machine=True) if self.ssh else "local",
+                speaker=self.ssh.get_remote_repr(add_machine=True) if self.ssh else "local",
+                ssh_conn_str=self.ssh.get_remote_repr(add_machine=False) if self.ssh else "",
+                executed_obj=f"{self.job_params.repo_path_rh}/{self.job_params.file_path_r}",
+                file_manager_path=str(self.file_manager.file_manager_path),
+                to_email=self.config.to_email,
+                email_config_name=self.config.email_config_name,
+            )
+            notification_block = render_notification_block(email_params)
+
+        # Save params JSON first so the template can reference it
+        params_json_path = self.file_manager.job_root / "data/job_params.json"
+        params_json_path.parent.mkdir(parents=True, exist_ok=True)
+        save_json(obj=self.job_params.to_dict(), path=params_json_path, indent=2, verbose=False)
+
+        py_script = render_execution_script(
+            params_json_path=str(params_json_path),
+            file_manager_json_path=str(self.file_manager.file_manager_path),
+            execution_line=execution_line,
+            notification_block=notification_block,
+        )
+
+        shell_script = _build_shell_script(self.job_params, self.config, self.file_manager)
+
+        # Write shell script
+        shell_path = self.file_manager.shell_script_path.expanduser()
+        shell_path.parent.mkdir(parents=True, exist_ok=True)
+        shell_path.write_text(shell_script, encoding="utf-8")
+
+        # Write python script
+        py_path = self.file_manager.py_script_path.expanduser()
+        py_path.parent.mkdir(parents=True, exist_ok=True)
+        py_path.write_text(py_script, encoding="utf-8")
+
+        # Save supporting data as JSON
+        save_json(obj=self.kwargs, path=self.file_manager.kwargs_path.expanduser(), indent=2, verbose=False)
+        save_json(obj=self.file_manager.to_dict(), path=self.file_manager.file_manager_path.expanduser(), indent=2, verbose=False)
+        save_json(obj=self.config.to_dict(), path=self.file_manager.remote_machine_config_path.expanduser(), indent=2, verbose=False)
+        save_json(obj=self.to_dict(), path=self.file_manager.remote_machine_path.expanduser(), indent=2, verbose=False)
+
+        log_dir = self.file_manager.execution_log_dir.expanduser()
+        log_dir.mkdir(parents=True, exist_ok=True)
+        (log_dir / "status.txt").write_text("queued", encoding="utf-8")
+        self.scripts_generated = True
+
+    def show_scripts(self) -> None:
+        shell_text = self.file_manager.shell_script_path.expanduser().read_text(encoding="utf-8")
+        py_text = self.file_manager.py_script_path.expanduser().read_text(encoding="utf-8")
+        console.print(Panel(Syntax(shell_text, lexer="sh", theme="monokai", line_numbers=True), title="Shell Script"))
+        console.print(Panel(Syntax(py_text, lexer="python", theme="monokai", line_numbers=True), title="Python Script"))
+
+    def submit(self) -> None:
+        console.rule("Submitting job")
+        if self.config.ssh_host is not None:
+            ssh = self._ensure_ssh()
+            if self.config.transfer_method == "sftp":
+                transfer_sftp(ssh=ssh, config=self.config, job_params=self.job_params, file_manager=self.file_manager, data=self.data)
+            elif self.config.transfer_method == "cloud":
+                transfer_cloud(ssh=ssh, config=self.config, job_params=self.job_params, file_manager=self.file_manager, data=self.data)
+            else:
+                raise ValueError(f"Unknown transfer_method: {self.config.transfer_method}")
+        self.submitted = True
+
+    def fire(self, run: bool) -> tuple[int, str]:
+        if not self.submitted:
+            raise RuntimeError("Job not submitted yet")
+        console.rule(f"Firing job `{self.config.job_id}`")
+        cmd = self.file_manager.get_fire_command()
+        if self.config.ssh_host is not None:
+            ssh = self._ensure_ssh()
+            response = ssh.run_shell_cmd_on_remote(command=cmd, verbose_output=True, description=f"fire job {self.config.job_id}", strict_stderr=False, strict_return_code=False)
+            return 0, response.op
+        else:
+            import subprocess
+            result = subprocess.run(cmd, shell=True, capture_output=True, text=True)
+            return result.returncode, result.stdout
+
+    def run(self, run: bool, show_scripts: bool) -> "RemoteMachine":
+        self.generate_scripts()
+        if show_scripts:
+            self.show_scripts()
+        self.submit()
+        self.fire(run=run)
+        return self
+
+    def check_job_status(self) -> Path | None:
+        if not self.submitted:
+            print("Job not submitted yet.")
+            return None
+        if self.results_downloaded:
+            print("Results already downloaded.")
+            return None
+        log_dir = self.file_manager.execution_log_dir.expanduser()
+        log_dir.mkdir(parents=True, exist_ok=True)
+        if self.config.ssh_host is not None:
+            ssh = self._ensure_ssh()
+            try:
+                ssh.copy_to_here(source=str(self.file_manager.execution_log_dir), target=None, compress_with_zip=True, recursive=True)
+            except Exception:
+                pass
+        end_time_file = log_dir / "end_time.txt"
+        if not end_time_file.exists():
+            start_file = log_dir / "start_time.txt"
+            if not start_file.exists():
+                print(f"Job {self.config.job_id} still queued.")
+            else:
+                start_time = start_file.read_text(encoding="utf-8").strip()
+                try:
+                    elapsed = datetime.now() - datetime.fromisoformat(start_time)
+                    msg = f"Job `{self.config.job_id}` running since {start_time} ({elapsed})"
+                except ValueError:
+                    msg = f"Job `{self.config.job_id}` running since {start_time}"
+                console.print(Panel(msg, title="Job Status", border_style="bold red"))
+            return None
+        results_folder_file = log_dir / "results_folder_path.txt"
+        results_folder = results_folder_file.read_text(encoding="utf-8").strip()
+        console.rule("Job Completed")
+        print(f"Results: {results_folder}")
+        self.results_path = Path(results_folder)
+        return self.results_path
+
+    def download_results(self, target: str | None) -> "RemoteMachine":
+        if self.results_path is None:
+            raise RuntimeError("Results path unknown. Check job status first.")
+        if self.results_downloaded:
+            print(f"Results already downloaded: {self.results_path}")
+            return self
+        if self.config.ssh_host is not None:
+            ssh = self._ensure_ssh()
+            ssh.copy_to_here(source=str(self.results_path), target=target, compress_with_zip=True, recursive=True)
+        self.results_downloaded = True
+        return self
+
+    def delete_remote_results(self) -> "RemoteMachine":
+        if self.results_path is None:
+            print("Results path unknown.")
+            return self
+        if self.config.ssh_host is not None:
+            ssh = self._ensure_ssh()
+            ssh.run_shell_cmd_on_remote(command=f"rm -rf {self.results_path}", verbose_output=False, description="delete remote results", strict_stderr=False, strict_return_code=False)
+        return self
+
+def _build_shell_script(job_params: JobParams, config: RemoteStackOpsConfig, file_manager: FileManager) -> str:
+    lines: list[str] = ['echo "=== SHELL START ==="']
+    lines.append(f"cd {job_params.repo_path_rh}")
+    if config.update_repo:
+        lines.append("git pull")
+    if config.install_repo:
+        lines.append("pip install -e .")
+    lines.append('echo "=== SHELL END ==="')
+    lines.append(f'echo "Starting job {config.job_id}"')
+    py_rel = file_manager.py_script_path
+    try:
+        py_rel_str = str(py_rel.relative_to(Path.home()))
+    except ValueError:
+        py_rel_str = str(py_rel)
+    lines.append("cd ~")
+    if config.interactive:
+        lines.append(f"python -i ./{py_rel_str}")
+    else:
+        lines.append(f"python ./{py_rel_str}")
+    return "\n".join(lines) + "\n"