Rename refua-studio integration to clawcures-ui

Author: jbenjoseph

GUIDEBOOK.md

@@ -3,7 +3,7 @@
 This guidebook is for new users who want to deploy:
 
 - the Refua agent (`ClawCures`)
-- Refua Studio (`refua-studio`)
+- ClawCures UI (`clawcures-ui`)
 
 The fastest path is a single machine deployment, then moving to Kubernetes when needed.
 
@@ -13,7 +13,7 @@ The fastest path is a single machine deployment, then moving to Kubernetes when
   the campaign agent that plans and executes discovery workflows.
 - `refua-mcp`:
   the tool/runtime server used by the agent.
-- `refua-studio`:
+- `clawcures-ui`:
   the web control plane for operating campaigns and reviewing outputs.
 
 ## 2. Prerequisites
@@ -147,7 +147,7 @@ Then apply manifests with your standard Kubernetes workflow (`kubectl`, Argo CD,
 - `OPENCLAW_GATEWAY_TOKEN` missing:
   set token in `.env` or secret templates before running agent/studio.
 - `Address already in use`:
-  change `REFUA_MCP_PORT` and/or `REFUA_STUDIO_PORT`.
+  change `REFUA_MCP_PORT` and/or `CLAWCURES_UI_PORT`.
 - Import/runtime dependency errors:
   re-run `install-ecosystem.sh` or `refua-deploy install-ecosystem`.
 - Studio runs but tools unavailable:

README.md

@@ -14,10 +14,10 @@ It integrates with the Refua ecosystem packages:
 - `refua-notebook`
 - `refua-mcp`
 - `ClawCures`
-- `refua-studio`
+- `clawcures-ui`
 - `refua-deploy`
 
-When these projects are present, `refua-deploy` auto-detects their versions and can install the full Refua ecosystem (including `refua-studio`).
+When these projects are present, `refua-deploy` auto-detects their versions and can install the full Refua ecosystem (including `clawcures-ui`).
 
 ## Guidebook
 
@@ -297,9 +297,10 @@ Generated artifacts follow existing Refua runtime contracts:
   - `REFUA_MCP_ALLOWED_ORIGINS`
   - `REFUA_MCP_AUTH_TOKENS`
 - Studio auth env vars (single-machine `.env.template` + `run-studio.sh`):
-  - `REFUA_STUDIO_AUTH_TOKENS`
-  - `REFUA_STUDIO_OPERATOR_TOKENS`
-  - `REFUA_STUDIO_ADMIN_TOKENS`
+  - `CLAWCURES_UI_AUTH_TOKENS`
+  - `CLAWCURES_UI_OPERATOR_TOKENS`
+  - `CLAWCURES_UI_ADMIN_TOKENS`
+  Legacy `REFUA_STUDIO_*` env vars are also accepted by generated scripts.
 - GPU runtime env vars:
   - `REFUA_GPU_MODE`
   - `REFUA_GPU_VENDOR`

src/refua_deploy/cli.py

@@ -582,9 +582,9 @@ def _single_machine_doctor_checks(output_dir: Path) -> list[dict[str, Any]]:
     )
 
     for token_key in (
-        "REFUA_STUDIO_AUTH_TOKENS",
-        "REFUA_STUDIO_OPERATOR_TOKENS",
-        "REFUA_STUDIO_ADMIN_TOKENS",
+        "CLAWCURES_UI_AUTH_TOKENS",
+        "CLAWCURES_UI_OPERATOR_TOKENS",
+        "CLAWCURES_UI_ADMIN_TOKENS",
         "REFUA_MCP_AUTH_TOKENS",
     ):
         checks.append(

src/refua_deploy/integration.py

@@ -9,19 +9,19 @@
 from refua_deploy.models import DeploymentSpec
 
 _DEFAULT_IMAGE_PREFIX = "ghcr.io/agentcures"
-_PROJECT_NAMES = (
-    "refua",
-    "refua-data",
-    "refua-clinical",
-    "refua-preclinical",
-    "refua-regulatory",
-    "refua-bench",
-    "refua-wetlab",
-    "refua-notebook",
-    "refua-mcp",
-    "ClawCures",
-    "refua-studio",
-    "refua-deploy",
+_PROJECT_CANDIDATES: tuple[tuple[str, tuple[str, ...]], ...] = (
+    ("refua", ("refua",)),
+    ("refua-data", ("refua-data",)),
+    ("refua-clinical", ("refua-clinical",)),
+    ("refua-preclinical", ("refua-preclinical",)),
+    ("refua-regulatory", ("refua-regulatory",)),
+    ("refua-bench", ("refua-bench",)),
+    ("refua-wetlab", ("refua-wetlab",)),
+    ("refua-notebook", ("refua-notebook",)),
+    ("refua-mcp", ("refua-mcp",)),
+    ("ClawCures", ("ClawCures",)),
+    ("clawcures-ui", ("clawcures-ui", "refua-studio")),
+    ("refua-deploy", ("refua-deploy",)),
 )
 
 
@@ -53,17 +53,19 @@ def discover_workspace(root: str | Path | None = None) -> WorkspaceIntegration:
 
     for candidate in candidate_roots:
         projects: dict[str, ProjectReference] = {}
-        for project_name in _PROJECT_NAMES:
-            project_dir = candidate / project_name
-            pyproject_path = project_dir / "pyproject.toml"
-            if not pyproject_path.exists():
-                continue
-            version = _read_version(pyproject_path)
-            projects[project_name] = ProjectReference(
-                name=project_name,
-                path=project_dir,
-                version=version,
-            )
+        for canonical_name, candidate_names in _PROJECT_CANDIDATES:
+            for project_name in candidate_names:
+                project_dir = candidate / project_name
+                pyproject_path = project_dir / "pyproject.toml"
+                if not pyproject_path.exists():
+                    continue
+                version = _read_version(pyproject_path)
+                projects[canonical_name] = ProjectReference(
+                    name=canonical_name,
+                    path=project_dir,
+                    version=version,
+                )
+                break
 
         if len(projects) > best_count:
             best_count = len(projects)
@@ -74,7 +76,7 @@ def discover_workspace(root: str | Path | None = None) -> WorkspaceIntegration:
 
 
 def ecosystem_packages() -> tuple[str, ...]:
-    return _PROJECT_NAMES
+    return tuple(canonical_name for canonical_name, _aliases in _PROJECT_CANDIDATES)
 
 
 def resolve_images(

src/refua_deploy/renderers.py

@@ -684,13 +684,13 @@ def _render_single_machine(
             f"REFUA_GPU_VENDOR={spec.gpu.vendor}",
             f"REFUA_GPU_COUNT={spec.gpu.count}",
             "",
-            "REFUA_STUDIO_HOST=127.0.0.1",
-            "REFUA_STUDIO_PORT=8787",
-            "REFUA_STUDIO_DATA_DIR=.refua-studio",
-            "REFUA_STUDIO_WORKSPACE_ROOT=.",
-            "REFUA_STUDIO_AUTH_TOKENS=replace-me-viewer-token",
-            "REFUA_STUDIO_OPERATOR_TOKENS=replace-me-operator-token",
-            "REFUA_STUDIO_ADMIN_TOKENS=replace-me-admin-token",
+            "CLAWCURES_UI_HOST=127.0.0.1",
+            "CLAWCURES_UI_PORT=8787",
+            "CLAWCURES_UI_DATA_DIR=.clawcures-ui",
+            "CLAWCURES_UI_WORKSPACE_ROOT=.",
+            "CLAWCURES_UI_AUTH_TOKENS=replace-me-viewer-token",
+            "CLAWCURES_UI_OPERATOR_TOKENS=replace-me-operator-token",
+            "CLAWCURES_UI_ADMIN_TOKENS=replace-me-admin-token",
             "",
         ]
     )
@@ -764,13 +764,17 @@ def _render_single_machine(
         "",
         'PYTHON_BIN="${PYTHON_BIN:-$ROOT_DIR/.venv-refua/bin/python}"',
         'if [[ ! -x "$PYTHON_BIN" ]]; then PYTHON_BIN="python3"; fi',
-        'STUDIO_HOST="${REFUA_STUDIO_HOST:-127.0.0.1}"',
-        'STUDIO_PORT="${REFUA_STUDIO_PORT:-8787}"',
-        'STUDIO_DATA_DIR="${REFUA_STUDIO_DATA_DIR:-$ROOT_DIR/.refua-studio}"',
-        'STUDIO_WORKSPACE_ROOT="${REFUA_STUDIO_WORKSPACE_ROOT:-$ROOT_DIR}"',
-        'STUDIO_AUTH_TOKENS="${REFUA_STUDIO_AUTH_TOKENS:-}"',
-        'STUDIO_OPERATOR_TOKENS="${REFUA_STUDIO_OPERATOR_TOKENS:-}"',
-        'STUDIO_ADMIN_TOKENS="${REFUA_STUDIO_ADMIN_TOKENS:-}"',
+        'STUDIO_HOST="${CLAWCURES_UI_HOST:-${REFUA_STUDIO_HOST:-127.0.0.1}}"',
+        'STUDIO_PORT="${CLAWCURES_UI_PORT:-${REFUA_STUDIO_PORT:-8787}}"',
+        'DEFAULT_STUDIO_DATA_DIR="$ROOT_DIR/.clawcures-ui"',
+        'if [[ -z "${CLAWCURES_UI_DATA_DIR:-}" && -z "${REFUA_STUDIO_DATA_DIR:-}" && ! -d "$DEFAULT_STUDIO_DATA_DIR" && -d "$ROOT_DIR/.refua-studio" ]]; then',
+        '  DEFAULT_STUDIO_DATA_DIR="$ROOT_DIR/.refua-studio"',
+        "fi",
+        'STUDIO_DATA_DIR="${CLAWCURES_UI_DATA_DIR:-${REFUA_STUDIO_DATA_DIR:-$DEFAULT_STUDIO_DATA_DIR}}"',
+        'STUDIO_WORKSPACE_ROOT="${CLAWCURES_UI_WORKSPACE_ROOT:-${REFUA_STUDIO_WORKSPACE_ROOT:-$ROOT_DIR}}"',
+        'STUDIO_AUTH_TOKENS="${CLAWCURES_UI_AUTH_TOKENS:-${REFUA_STUDIO_AUTH_TOKENS:-}}"',
+        'STUDIO_OPERATOR_TOKENS="${CLAWCURES_UI_OPERATOR_TOKENS:-${REFUA_STUDIO_OPERATOR_TOKENS:-}}"',
+        'STUDIO_ADMIN_TOKENS="${CLAWCURES_UI_ADMIN_TOKENS:-${REFUA_STUDIO_ADMIN_TOKENS:-}}"',
         "",
         "STUDIO_ARGS=(",
         '  --host "$STUDIO_HOST"',
@@ -806,7 +810,7 @@ def _render_single_machine(
         "  done",
         "fi",
         "",
-        '"$PYTHON_BIN" -m refua_studio "${STUDIO_ARGS[@]}"',
+        '"$PYTHON_BIN" -m clawcures_ui "${STUDIO_ARGS[@]}"',
     ]
     _write_script(studio_path, studio_lines)
 

tests/test_cli.py

@@ -87,7 +87,7 @@ def test_cli_install_ecosystem_dry_run(capsys: CaptureFixture[str]) -> None:
 
     assert install_rc == 0
     rendered = capsys.readouterr().out
-    assert "pip install refua-studio" in rendered
+    assert "pip install clawcures-ui" in rendered
 
 
 def test_cli_install_ecosystem_executes_expected_package_order(
@@ -307,7 +307,7 @@ def test_cli_doctor_single_machine_checks_auth_placeholders(
     assert doctor_rc == 0
     payload = json.loads(capsys.readouterr().out)
     checks = {item["name"]: item for item in payload["checks"]}
-    assert checks["single_machine_env_has_refua_studio_auth_tokens"]["ok"] is True
-    assert checks["single_machine_env_has_refua_studio_operator_tokens"]["ok"] is True
-    assert checks["single_machine_env_has_refua_studio_admin_tokens"]["ok"] is True
+    assert checks["single_machine_env_has_clawcures_ui_auth_tokens"]["ok"] is True
+    assert checks["single_machine_env_has_clawcures_ui_operator_tokens"]["ok"] is True
+    assert checks["single_machine_env_has_clawcures_ui_admin_tokens"]["ok"] is True
     assert checks["run_studio_supports_auth_tokens"]["ok"] is True

tests/test_integration.py

@@ -56,7 +56,7 @@ def test_discover_workspace_includes_extended_refua_projects(tmp_path: Path) ->
         "refua-preclinical",
         "refua-data",
         "refua-regulatory",
-        "refua-studio",
+        "clawcures-ui",
     )
     for name in project_names:
         project_dir = workspace_root / name

tests/test_renderers.py

@@ -255,7 +255,7 @@ def test_render_single_machine_bundle(tmp_path: Path) -> None:
 
     install_text = install_script.read_text(encoding="utf-8")
     assert "pip install --upgrade" in install_text
-    assert "refua-studio" in install_text
+    assert "clawcures-ui" in install_text
 
     campaign_text = campaign_script.read_text(encoding="utf-8")
     assert "refua_campaign.cli run-autonomous" in campaign_text
@@ -267,15 +267,15 @@ def test_render_single_machine_bundle(tmp_path: Path) -> None:
     assert "--admin-token" in studio_text
 
     env_text = env_template.read_text(encoding="utf-8")
-    assert "REFUA_STUDIO_PORT=8787" in env_text
+    assert "CLAWCURES_UI_PORT=8787" in env_text
     assert "REFUA_CAMPAIGN_OBJECTIVE=" in env_text
     assert (
         "REFUA_MCP_ALLOWED_HOSTS=127.0.0.1,127.0.0.1:9010,localhost,localhost:9010"
         in env_text
     )
-    assert "REFUA_STUDIO_AUTH_TOKENS=" in env_text
-    assert "REFUA_STUDIO_OPERATOR_TOKENS=" in env_text
-    assert "REFUA_STUDIO_ADMIN_TOKENS=" in env_text
+    assert "CLAWCURES_UI_AUTH_TOKENS=" in env_text
+    assert "CLAWCURES_UI_OPERATOR_TOKENS=" in env_text
+    assert "CLAWCURES_UI_ADMIN_TOKENS=" in env_text
 
 
 def test_render_gpu_required_for_kubernetes_and_compose(tmp_path: Path) -> None: