Migrate development workflow from Poetry to uv

Author: jbenjoseph

.github/workflows/ci.yml

@@ -14,43 +14,39 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
 
-      - name: Set up Python
-        uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
         with:
+          version: "0.11.32"
+          enable-cache: true
           python-version: ${{ matrix.python-version }}
 
       - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install -e .
-          pip install -e ".[test]" || true
-          pip install -e ".[dev]" || true
-          pip install pytest ruff mypy build twine types-PyYAML
+        run: uv sync --locked
 
       - name: Ruff
         run: |
           if grep -q "^\[tool.ruff" pyproject.toml; then
-            ruff check src tests
+            uv run ruff check src tests
           else
             echo "No Ruff config; skipping."
           fi
 
       - name: Mypy
         run: |
           if grep -q "^\[tool.mypy" pyproject.toml; then
-            mypy src
+            uv run mypy src
           else
             echo "No mypy config; skipping."
           fi
 
       - name: Pytest
-        run: pytest -q
+        run: uv run pytest -q
 
       - name: Build and check distributions
         if: matrix.python-version == '3.11'
         run: |
-          rm -rf build dist
-          python -m build
-          python -m twine check dist/*
+          uv build
+          uv run twine check dist/*

.gitignore

@@ -25,4 +25,3 @@ artifacts/
 .artifacts/
 
 .DS_Store
-poetry.toml

GUIDEBOOK.md

@@ -20,7 +20,7 @@ The fastest path is a single machine deployment, then moving to Kubernetes when
 
 - Python `3.11`-`3.13`
 - `pip`
-- `poetry`
+- `uv`
 - OpenClaw endpoint and token
 
 Optional:
@@ -31,21 +31,21 @@ Optional:
 
 ```bash
 cd refua-deploy
-poetry install
+uv sync
 ```
 
 You can also install ecosystem packages directly from PyPI:
 
 ```bash
-poetry run refua-deploy install-ecosystem
+uv run refua-deploy install-ecosystem
 ```
 
 ## 4. Recommended: Single-Machine Deployment
 
 ### 4.1 Generate config
 
 ```bash
-poetry run refua-deploy init \
+uv run refua-deploy init \
   --output deploy/single-machine.yaml \
   --name refua-local \
   --visibility private \
@@ -56,7 +56,7 @@ poetry run refua-deploy init \
 ### 4.2 Render artifacts
 
 ```bash
-poetry run refua-deploy render \
+uv run refua-deploy render \
   --config deploy/single-machine.yaml \
   --output-dir dist
 ```
@@ -119,7 +119,7 @@ Use this when you need multi-node scheduling, stronger isolation, and cluster in
 ### 5.1 Generate config
 
 ```bash
-poetry run refua-deploy init \
+uv run refua-deploy init \
   --output deploy/public.yaml \
   --name refua-prod \
   --visibility public \
@@ -130,8 +130,8 @@ poetry run refua-deploy init \
 ### 5.2 Render and review
 
 ```bash
-poetry run refua-deploy plan --config deploy/public.yaml --output deploy/plan.json
-poetry run refua-deploy render --config deploy/public.yaml --output-dir dist/public
+uv run refua-deploy plan --config deploy/public.yaml --output deploy/plan.json
+uv run refua-deploy render --config deploy/public.yaml --output-dir dist/public
 ```
 
 ### 5.3 Bootstrap/apply

README.md

@@ -30,10 +30,10 @@ If you just want it working with sensible defaults:
 
 ```bash
 cd refua-deploy
-poetry install
-poetry run refua-deploy install-ecosystem
-poetry run refua-deploy init --output deploy.yaml --name refua-prod --visibility public --provider aws
-poetry run refua-deploy render --config deploy.yaml --output-dir dist
+uv sync
+uv run refua-deploy install-ecosystem
+uv run refua-deploy init --output deploy.yaml --name refua-prod --visibility public --provider aws
+uv run refua-deploy render --config deploy.yaml --output-dir dist
 bash dist/bootstrap/cluster-bootstrap.sh
 ```
 
@@ -105,21 +105,21 @@ What this does automatically:
 
 ```bash
 cd refua-deploy
-poetry install
+uv sync
 ```
 
 Install the full Refua ecosystem (including Studio):
 
 ```bash
-poetry run refua-deploy install-ecosystem
+uv run refua-deploy install-ecosystem
 ```
 
 ## Quick Start
 
 Generate a starter config with maximum automation:
 
 ```bash
-poetry run refua-deploy init \
+uv run refua-deploy init \
   --output deploy/public.yaml \
   --name refua-oncology-prod \
   --visibility public \
@@ -133,39 +133,39 @@ poetry run refua-deploy init \
 Validate and preview plan:
 
 ```bash
-poetry run refua-deploy plan \
+uv run refua-deploy plan \
   --config deploy/public.yaml \
   --output deploy/plan.json
 ```
 
 Render artifacts:
 
 ```bash
-poetry run refua-deploy render \
+uv run refua-deploy render \
   --config deploy/public.yaml \
   --output-dir dist/public
 ```
 
 Apply rendered runtime:
 
 ```bash
-poetry run refua-deploy apply \
+uv run refua-deploy apply \
   --config deploy/public.yaml \
   --output-dir dist/public
 ```
 
 Check runtime status:
 
 ```bash
-poetry run refua-deploy status \
+uv run refua-deploy status \
   --config deploy/public.yaml \
   --output-dir dist/public
 ```
 
 Run deployment diagnostics:
 
 ```bash
-poetry run refua-deploy doctor \
+uv run refua-deploy doctor \
   --config deploy/public.yaml \
   --output-dir dist/public
 ```
@@ -179,7 +179,7 @@ bash dist/public/bootstrap/cluster-bootstrap.sh
 Private cloud with compose:
 
 ```bash
-poetry run refua-deploy init \
+uv run refua-deploy init \
   --output deploy/private.yaml \
   --visibility private \
   --provider onprem \
@@ -189,7 +189,7 @@ poetry run refua-deploy init \
 Private cloud with Kubernetes (for example k3s/rke2):
 
 ```bash
-poetry run refua-deploy init \
+uv run refua-deploy init \
   --output deploy/private-k8s.yaml \
   --visibility private \
   --provider vmware \
@@ -199,12 +199,12 @@ poetry run refua-deploy init \
 Single-machine lightweight bundle:
 
 ```bash
-poetry run refua-deploy init \
+uv run refua-deploy init \
   --output deploy/single-machine.yaml \
   --visibility private \
   --provider onprem \
   --orchestrator single-machine
-poetry run refua-deploy render \
+uv run refua-deploy render \
   --config deploy/single-machine.yaml \
   --output-dir dist/single-machine
 ```
@@ -312,13 +312,13 @@ Generated artifacts follow existing Refua runtime contracts:
 Run checks:
 
 ```bash
-poetry run ruff check src tests
-poetry run mypy src
-poetry run pytest
+uv run ruff check src tests
+uv run mypy src
+uv run pytest
 ```
 
 Build package:
 
 ```bash
-poetry build
+uv build
 ```