refactor: Update runner specifications from 'python_uv_tool' to 'python' across components and documentation

core/tests/conftest.py

@@ -20,7 +20,7 @@ def castle_root(tmp_path: Path) -> Generator[Path, None, None]:
                 "description": "Test service",
                 "source": "test-svc",
                 "run": {
-                    "runner": "python_uv_tool",
+                    "runner": "python",
                     "tool": "test-svc",
                 },
                 "defaults": {

core/tests/test_config.py

@@ -60,7 +60,7 @@ class TestLoadConfig:
         """Service has correct RunSpec."""
         config = load_config(castle_root)
         svc = config.components["test-svc"]
-        assert svc.run.runner == "python_uv_tool"
+        assert svc.run.runner == "python"
         assert svc.run.tool == "test-svc"
         assert svc.source == "test-svc"
 

core/tests/test_manifest.py

@@ -17,7 +17,7 @@ from castle_core.manifest import (
     Role,
     RunCommand,
     RunContainer,
-    RunPythonUvTool,
+    RunPython,
     RunRemote,
     SystemdSpec,
     ToolSpec,
@@ -32,7 +32,7 @@ class TestRoleDerivation:
         """Component with expose.http gets SERVICE role."""
         m = ComponentManifest(
             id="svc",
-            run=RunPythonUvTool(runner="python_uv_tool", tool="svc"),
+            run=RunPython(runner="python", tool="svc"),
             expose=ExposeSpec(http=HttpExposeSpec(internal=HttpInternal(port=8000))),
         )
         assert Role.SERVICE in m.roles
@@ -114,7 +114,7 @@ class TestRoleDerivation:
         """Component can have multiple roles."""
         m = ComponentManifest(
             id="multi",
-            run=RunPythonUvTool(runner="python_uv_tool", tool="multi"),
+            run=RunPython(runner="python", tool="multi"),
             expose=ExposeSpec(http=HttpExposeSpec(internal=HttpInternal(port=8000))),
             install=InstallSpec(path=PathInstallSpec(alias="multi")),
         )
@@ -125,7 +125,7 @@ class TestRoleDerivation:
         """Systemd + HTTP = SERVICE, not WORKER."""
         m = ComponentManifest(
             id="svc",
-            run=RunPythonUvTool(runner="python_uv_tool", tool="svc"),
+            run=RunPython(runner="python", tool="svc"),
             expose=ExposeSpec(http=HttpExposeSpec(internal=HttpInternal(port=8000))),
             manage=ManageSpec(systemd=SystemdSpec()),
         )
@@ -170,7 +170,7 @@ class TestModelSerialization:
         m = ComponentManifest(
             id="svc",
             description="A service",
-            run=RunPythonUvTool(runner="python_uv_tool", tool="svc", cwd="svc"),
+            run=RunPython(runner="python", tool="svc", cwd="svc"),
             expose=ExposeSpec(
                 http=HttpExposeSpec(
                     internal=HttpInternal(port=9001), health_path="/health"
@@ -180,6 +180,6 @@ class TestModelSerialization:
             manage=ManageSpec(systemd=SystemdSpec()),
         )
         data = m.model_dump(exclude_none=True, exclude={"id", "roles"})
-        assert data["run"]["runner"] == "python_uv_tool"
+        assert data["run"]["runner"] == "python"
         assert data["expose"]["http"]["internal"]["port"] == 9001
         assert data["proxy"]["caddy"]["path_prefix"] == "/svc"

core/tests/test_systemd.py

@@ -55,7 +55,7 @@ class TestUnitGeneration:
         assert "Restart=on-failure" in unit
 
     def test_uses_uv_run(self, castle_root: Path) -> None:
-        """Unit file ExecStart uses uv run for python_uv_tool."""
+        """Unit file ExecStart uses uv run for python runner."""
         config = load_config(castle_root)
         manifest = config.components["test-svc"]
         unit = generate_unit(config, "test-svc", manifest)
@@ -68,7 +68,7 @@ class TestUnitFromDeployed:
     def test_basic_service(self) -> None:
         """Generate a unit from a deployed component."""
         deployed = DeployedComponent(
-            runner="python_uv_tool",
+            runner="python",
             run_cmd=["/home/user/.local/bin/uv", "run", "my-svc"],
             env={"MY_SVC_PORT": "9001", "MY_SVC_DATA_DIR": "/data/castle/my-svc"},
             description="My service",
@@ -97,7 +97,7 @@ class TestUnitFromDeployed:
     def test_no_repo_paths(self) -> None:
         """Generated units must not reference repo paths."""
         deployed = DeployedComponent(
-            runner="python_uv_tool",
+            runner="python",
             run_cmd=["/home/user/.local/bin/uv", "run", "my-svc"],
             env={"DATA_DIR": "/data/castle/my-svc"},
             description="Test",