Rename refua-studio package to clawcures-ui

Author: jbenjoseph

Containerfile

@@ -19,4 +19,4 @@ USER studio
 
 EXPOSE 8787
 
-CMD ["refua-studio", "--host", "0.0.0.0", "--port", "8787", "--data-dir", "/data", "--workspace-root", "/workspace"]
+CMD ["clawcures-ui", "--host", "0.0.0.0", "--port", "8787", "--data-dir", "/data", "--workspace-root", "/workspace"]

README.md

@@ -1,6 +1,6 @@
-# refua-studio
+# clawcures-ui
 
-`refua-studio` is the Refua web control plane for planning and running discovery campaigns.
+`clawcures-ui` is the ClawCures web control plane for planning and running discovery campaigns across the Refua workspace.
 
 It provides:
 
@@ -31,51 +31,57 @@ This project is designed to reuse existing workspace components:
 ## Install
 
 ```bash
-cd path/to/refua-studio
+cd path/to/clawcures-ui
 pip install -e .
 ```
 
 ## Run
 
 ```bash
-refua-studio --host 127.0.0.1 --port 8787 --open-browser
+clawcures-ui --host 127.0.0.1 --port 8787 --open-browser
 ```
 
 Or from source without install:
 
 ```bash
-cd path/to/refua-studio
-PYTHONPATH=src python -m refua_studio --host 127.0.0.1 --port 8787
+cd path/to/clawcures-ui
+PYTHONPATH=src python -m clawcures_ui --host 127.0.0.1 --port 8787
 ```
 
+Legacy compatibility is still shipped for existing automation:
+
+- `refua-studio` remains as a console-script alias
+- `python -m refua_studio` still works
+- legacy `REFUA_STUDIO_*` auth token env vars are still accepted
+
 ## Podman
 
 Build image:
 
 ```bash
-cd path/to/refua-studio
-podman build -t refua-studio:local -f Containerfile .
+cd path/to/clawcures-ui
+podman build -t clawcures-ui:local -f Containerfile .
 ```
 
 Run container:
 
 ```bash
 podman run --rm -p 8787:8787 \
   -e REFUA_CAMPAIGN_OPENCLAW_BASE_URL=http://host.containers.internal:18789 \
-  -v "$(pwd)/.refua-studio-data:/data" \
+  -v "$(pwd)/.clawcures-ui-data:/data" \
   -v "$(pwd)/..:/workspace:ro" \
-  refua-studio:local
+  clawcures-ui:local
 ```
 
 Notes:
 
-- The container starts `refua-studio` on `0.0.0.0:8787`.
+- The container starts `clawcures-ui` on `0.0.0.0:8787`.
 - Mount the monorepo root at `/workspace` so Studio can integrate with `ClawCures`, `refua-mcp`, and other sibling projects.
-- Persistent job database lives in `.refua-studio-data/`.
+- Persistent job database lives in `.clawcures-ui-data/`.
 
 ## Podman Compose
 
-From `refua-studio/`:
+From `clawcures-ui/`:
 
 ```bash
 podman compose -f docker-compose.yml up --build
@@ -96,7 +102,7 @@ CLI flags:
 
 - `--host`
 - `--port`
-- `--data-dir` (default: `.refua-studio`)
+- `--data-dir` (default: `.clawcures-ui`, with fallback to `.refua-studio` when present)
 - `--workspace-root` (defaults to parent workspace)
 - `--max-workers` (background job concurrency)
 
@@ -264,14 +270,14 @@ Each job records request payload, status transitions (`queued` -> `running` -> `
 ## Tests
 
 ```bash
-cd path/to/refua-studio
+cd path/to/clawcures-ui
 python -m unittest discover -s tests -v
 ```
 
 Playwright E2E suite:
 
 ```bash
-cd path/to/refua-studio
+cd path/to/clawcures-ui
 npm install
 npx playwright install chromium
 npm run test:e2e
@@ -284,7 +290,7 @@ command center, planning/jobs, clinical operations, and wet-lab/regulatory flows
 ## Build
 
 ```bash
-cd path/to/refua-studio
+cd path/to/clawcures-ui
 python -m build
 ```
 
@@ -293,10 +299,10 @@ Build artifacts are written to `dist/` (`.tar.gz` and `.whl`).
 ## Project Layout
 
 ```text
-refua-studio/
+clawcures-ui/
   Containerfile
   docker-compose.yml
-  src/refua_studio/
+  src/clawcures_ui/
     app.py
     bridge.py
     cli.py
@@ -307,6 +313,8 @@ refua-studio/
       index.html
       app.js
       styles.css
+  src/refua_studio/
+    ...
   tests/
 ```
 

docker-compose.yml

@@ -1,10 +1,10 @@
 services:
-  refua-studio:
+  clawcures-ui:
     build:
       context: .
       dockerfile: Containerfile
-    image: refua-studio:local
-    container_name: refua-studio
+    image: clawcures-ui:local
+    container_name: clawcures-ui
     restart: unless-stopped
     init: true
     ports:
@@ -16,7 +16,7 @@ services:
       OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN:-}
       REFUA_CAMPAIGN_OPENCLAW_TOKEN: ${REFUA_CAMPAIGN_OPENCLAW_TOKEN:-}
     command:
-      - refua-studio
+      - clawcures-ui
       - --host
       - 0.0.0.0
       - --port
@@ -28,7 +28,7 @@ services:
       - --max-workers
       - "2"
     volumes:
-      - ./.refua-studio-data:/data
+      - ./.clawcures-ui-data:/data
       - ../:/workspace:ro
     healthcheck:
       test:

e2e/helpers.ts

@@ -102,7 +102,7 @@ from pathlib import Path
 import json
 import os
 
-from refua_studio.storage import JobStore
+from clawcures_ui.storage import JobStore
 
 store = JobStore(Path(os.environ["STUDIO_DATA_DIR"]) / "studio.db")
 job = store.create_job(

package-lock.json

@@ -1,8 +1,8 @@
 {
-  "name": "refua-studio-e2e",
+  "name": "clawcures-ui-e2e",
   "private": true,
   "version": "0.7.1",
-  "description": "Playwright E2E test suite for refua-studio",
+  "description": "Playwright E2E test suite for clawcures-ui",
   "scripts": {
     "test:e2e": "playwright test",
     "test:e2e:headed": "playwright test --headed",

package.json

@@ -20,7 +20,7 @@ export default defineConfig({
     video: "retain-on-failure",
   },
   webServer: {
-    command: `rm -rf .playwright-data && PYTHONPATH=src ./.venv_release/bin/python -m refua_studio --host ${host} --port ${port} --data-dir .playwright-data --workspace-root .. --max-workers 2`,
+    command: `rm -rf .playwright-data && PYTHONPATH=src ./.venv_release/bin/python -m clawcures_ui --host ${host} --port ${port} --data-dir .playwright-data --workspace-root .. --max-workers 2`,
     url: `${baseURL}/api/health`,
     reuseExistingServer: false,
     timeout: 120_000,

playwright.config.ts

@@ -3,9 +3,9 @@ requires = ["setuptools>=68", "wheel"]
 build-backend = "setuptools.build_meta"
 
 [project]
-name = "refua-studio"
-version = "0.7.1"
-description = "Web control plane for Refua campaign orchestration and scientific execution."
+name = "clawcures-ui"
+version = "0.8.0"
+description = "Web control plane for ClawCures campaign orchestration and scientific execution."
 readme = "README.md"
 requires-python = ">=3.11,<3.15"
 license = "MIT"
@@ -43,23 +43,24 @@ dependencies = [
 
 [project.urls]
 Homepage = "https://agentcures.com/"
-Repository = "https://github.com/agentcures/refua"
-Documentation = "https://github.com/agentcures/refua#readme"
-Issues = "https://github.com/agentcures/refua/issues"
+Repository = "https://github.com/agentcures/clawcures-ui"
+Documentation = "https://github.com/agentcures/clawcures-ui#readme"
+Issues = "https://github.com/agentcures/clawcures-ui/issues"
 
 [project.optional-dependencies]
 dev = [
   "pre-commit>=4.5.1",
 ]
 
 [project.scripts]
+clawcures-ui = "clawcures_ui.cli:main"
 refua-studio = "refua_studio.cli:main"
 
 [tool.setuptools.packages.find]
 where = ["src"]
 
 [tool.setuptools.package-data]
-refua_studio = ["static/*"]
+clawcures_ui = ["static/*"]
 
 [tool.setuptools.exclude-package-data]
 "*" = ["*.py[cod]", "__pycache__/*"]

pyproject.toml

@@ -0,0 +1,35 @@
+"""ClawCures UI package."""
+
+from importlib.metadata import version as _distribution_version
+from pathlib import Path
+import tomllib
+
+__all__ = ["__version__"]
+
+
+def _read_version_from_pyproject() -> str | None:
+    pyproject_path = Path(__file__).resolve().parents[2] / "pyproject.toml"
+    if not pyproject_path.exists():
+        return None
+
+    data = tomllib.loads(pyproject_path.read_text(encoding="utf-8"))
+    project = data.get("project", {})
+    version = project.get("version")
+    if not version:
+        return None
+    return str(version)
+
+
+def _resolve_version() -> str:
+    local_version = _read_version_from_pyproject()
+    if local_version is not None:
+        return local_version
+    for distribution_name in ("clawcures-ui", "refua-studio"):
+        try:
+            return _distribution_version(distribution_name)
+        except Exception:  # noqa: BLE001
+            continue
+    raise RuntimeError("Unable to resolve package version for clawcures-ui")
+
+
+__version__ = _resolve_version()

src/clawcures_ui/__init__.py

@@ -0,0 +1,6 @@
+from __future__ import annotations
+
+from clawcures_ui.cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())