rhiza 0.7.0__tar.gz → 0.8.0__tar.gz

{rhiza-0.7.0/.github → rhiza-0.8.0/.github/rhiza}/actions/setup-project/action.yml

@@ -13,11 +13,7 @@
 #     Can be overridden by setting PYTHON_DEFAULT_VERSION repository variable
 #   - uv-extra-index-url: Extra index URL for uv (optional)
 #
-# Outputs:
-#   - pyproject_exists: "true" if pyproject.toml exists, otherwise "false"
-#
 # Notes:
-#   - Safe to run in repositories without pyproject.toml; dependency sync will be skipped.
 #   - Used by workflows such as CI, Book, Marimo, and Release.
 
 name: 'Setup Project'
@@ -31,11 +27,6 @@ inputs:
     description: 'Extra index URL for uv'
     required: false
 
-outputs:
-  pyproject_exists:
-    description: 'Flag indicating whether pyproject.toml exists'
-    value: ${{ steps.check_pyproject.outputs.exists }}
-
 runs:
   using: 'composite'
   steps:
@@ -44,29 +35,15 @@ runs:
       with:
         version: "0.9.18"
 
-    - name: Check for pyproject.toml
-      id: check_pyproject
-      shell: bash
-      run: |
-        if [ -f "pyproject.toml" ]; then
-          echo "exists=true" >> "$GITHUB_OUTPUT"
-        else
-          echo "exists=false" >> "$GITHUB_OUTPUT"
-        fi
-
     - name: Build the virtual environment
       shell: bash
       run: uv venv --python ${{ inputs.python-version }}
 
-    - name: "Sync the virtual environment for ${{ github.repository }} if pyproject.toml exists"
+    - name: "Sync the virtual environment for ${{ github.repository }}"
       shell: bash
       run: |
         if [[ -n "${{ inputs.uv-extra-index-url }}" ]]; then
           export UV_EXTRA_INDEX_URL="${{ inputs.uv-extra-index-url }}"
         fi
 
-        if [ -f "pyproject.toml" ]; then
-          uv sync --all-extras
-        else
-          echo "No pyproject.toml found, skipping package installation"
-        fi
+        uv sync --all-extras --frozen

rhiza-0.7.0/.github/workflows/book.yml → rhiza-0.8.0/.github/workflows/rhiza_book.yml

@@ -44,11 +44,11 @@ jobs:
       - name: Get Python version
         id: get-python
         run: |
-          echo "python-version=$(python ./.github/workflows/scripts/version_max.py)" >> "$GITHUB_OUTPUT"
+          echo "python-version=$(python ./.rhiza/utils/version_max.py)" >> "$GITHUB_OUTPUT"
 
       # Use the composite action to set up the project
       - name: Setup the project
-        uses: ./.github/actions/setup-project
+        uses: ./.github/rhiza/actions/setup-project
         with:
           python-version: ${{ steps.get-python.outputs.python-version }}
           uv-extra-index-url: ${{ secrets.UV_EXTRA_INDEX_URL }}

rhiza-0.7.0/.github/workflows/ci.yml → rhiza-0.8.0/.github/workflows/rhiza_ci.yml

@@ -28,7 +28,7 @@ jobs:
       - id: versions
         run: |
           # Generate Python versions JSON from the script
-          JSON=$(python ./.github/workflows/scripts/version_matrix.py)
+          JSON=$(python ./.rhiza/utils/version_matrix.py)
           echo "list=$JSON" >> "$GITHUB_OUTPUT"
 
       - name: Debug matrix
@@ -50,7 +50,7 @@ jobs:
           lfs: true
 
       - name: Setup the project
-        uses: ./.github/actions/setup-project
+        uses: ./.github/rhiza/actions/setup-project
         with:
           python-version: ${{ matrix.python-version }}
           uv-extra-index-url: ${{ secrets.UV_EXTRA_INDEX_URL }}

rhiza-0.7.0/.github/workflows/deptry.yml → rhiza-0.8.0/.github/workflows/rhiza_deptry.yml

@@ -34,13 +34,9 @@ jobs:
       - name: Run deptry
         run: |
           set -euo pipefail
-          if [ -f "pyproject.toml" ]; then
-            if [ -d "src" ]; then
-              SOURCE_FOLDER="src"
-            else
-              SOURCE_FOLDER="."
-            fi
-            uvx deptry "$SOURCE_FOLDER"
+          if [ -d "src" ]; then
+            SOURCE_FOLDER="src"
           else
-            printf "${YELLOW:-}[WARN] No pyproject.toml found, skipping deptry${RESET:-}\n"
+            SOURCE_FOLDER="."
           fi
+          uvx deptry "$SOURCE_FOLDER"

rhiza-0.8.0/.github/workflows/rhiza_devcontainer.yml

@@ -0,0 +1,137 @@
+# This file is part of the jebel-quant/rhiza repository
+# (https://github.com/jebel-quant/rhiza).
+#
+# Devcontainer CI Workflow
+#
+# Purpose:
+#   Validates that the devcontainer image builds successfully when devcontainer-related
+#   files are changed. This workflow does NOT publish/push the image to any registry.
+#
+# Trigger Conditions:
+#   - Push to any branch when files in .devcontainer/ change
+#   - Pull requests to main/master when files in .devcontainer/ change
+#   - Changes to this workflow file itself
+#
+# Image Configuration:
+#   - Registry: Defaults to ghcr.io (override with DEVCONTAINER_REGISTRY variable)
+#   - Image name: {registry}/{owner}/{repository}/devcontainer
+#   - Image tag: {branch}-{commit-sha} (e.g., main-abc123def456)
+#   - Config file: Always .devcontainer/devcontainer.json
+#
+# Safeguards:
+#   - Checks if .devcontainer/devcontainer.json exists before building
+#   - Skips gracefully with a warning if devcontainer.json is not found
+#   - Converts repository owner to lowercase for Docker compatibility
+#
+# Publishing:
+#   Publishing only happens during releases via rhiza_release.yml when the
+#   PUBLISH_DEVCONTAINER repository variable is set to "true".
+#
+# For repos without devcontainers:
+#   This workflow won't trigger unless .devcontainer/ files exist and are modified,
+#   or this workflow file itself is changed (in which case it skips gracefully).
+
+
+name: DEVCONTAINER
+
+on:
+  push:
+    branches:
+      - '**'
+    paths:
+      - ".devcontainer/**"
+      - ".github/workflows/rhiza_devcontainer.yml"
+
+  pull_request:
+    branches: [ main, master ]
+    paths:
+      - ".devcontainer/**"
+      - ".github/workflows/rhiza_devcontainer.yml"
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  build:
+    name: Build Devcontainer Image
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Set registry
+        id: registry
+        run: |
+          REGISTRY="${{ vars.DEVCONTAINER_REGISTRY }}"
+          if [ -z "$REGISTRY" ]; then
+            REGISTRY="ghcr.io"
+          fi
+          echo "registry=$REGISTRY" >> $GITHUB_OUTPUT
+
+      - name: Login to Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ steps.registry.outputs.registry }}
+          username: ${{ github.repository_owner }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      # Additional gate to skip build if no devcontainer.json exists
+      - name: Check devcontainer exists
+        id: check
+        run: |
+          if [ ! -f ".devcontainer/devcontainer.json" ]; then
+            echo "exists=false" >> $GITHUB_OUTPUT
+            echo "::warning::No .devcontainer/devcontainer.json found, skipping build"
+          else
+            echo "exists=true" >> $GITHUB_OUTPUT
+          fi
+      # repository owner to lowercase for Docker image naming, as devcontainers/ci does not safeguard
+      - name: Get lowercase repository owner
+        id: repo_owner
+        run: echo "owner_lc=$(echo '${{ github.repository_owner }}' | tr '[:upper:]' '[:lower:]')" >> $GITHUB_OUTPUT
+
+      - name: Get Image Name
+        if: steps.check.outputs.exists == 'true'
+        id: image_name
+        run: |
+          # Check if custom name is provided, otherwise use default
+          if [ -z "${{ vars.DEVCONTAINER_IMAGE_NAME }}" ]; then
+            REPO_NAME_LC=$(echo "${{ github.event.repository.name }}" | tr '[:upper:]' '[:lower:]')
+            # Sanitize repo name: replace invalid characters with hyphens
+            # Docker image names must match [a-z0-9]+([._-][a-z0-9]+)*
+            # Replace leading dots and multiple consecutive separators
+            REPO_NAME_SANITIZED=$(echo "$REPO_NAME_LC" | sed 's/^[._-]*//; s/[._-][._-]*/-/g')
+            IMAGE_NAME="$REPO_NAME_SANITIZED/devcontainer"
+            echo "Using default image name component: $IMAGE_NAME"
+          else
+            IMAGE_NAME="${{ vars.DEVCONTAINER_IMAGE_NAME }}"
+            echo "Using custom image name component: $IMAGE_NAME"
+          fi
+
+          # Validate the image component matches [a-z0-9]+([._-][a-z0-9]+)* with optional / separators
+          if ! echo "$IMAGE_NAME" | grep -qE '^[a-z0-9]+([._-][a-z0-9]+)*(/[a-z0-9]+([._-][a-z0-9]+)*)*$'; then
+            echo "::error::Invalid image name component: $IMAGE_NAME"
+            echo "::error::Each component must match [a-z0-9]+([._-][a-z0-9]+)* separated by /"
+            exit 1
+          fi
+
+          IMAGE_NAME="${{ steps.registry.outputs.registry }}/${{ steps.repo_owner.outputs.owner_lc }}/$IMAGE_NAME"
+          echo "✅ Final image name: $IMAGE_NAME"
+          echo "image_name=$IMAGE_NAME" >> $GITHUB_OUTPUT
+
+      - name: Sanitize Image Tag
+        if: steps.check.outputs.exists == 'true'
+        id: sanitized_tag
+        run: |
+          SANITIZED_TAG=$(echo "${{ github.ref_name }}-${{ github.sha }}" | tr '/' '-')
+          echo "sanitized_tag=$SANITIZED_TAG" >> $GITHUB_OUTPUT
+
+      - name: Build Devcontainer Image
+        uses: devcontainers/ci@v0.3
+        if: steps.check.outputs.exists == 'true'
+        with:
+          configFile: .devcontainer/devcontainer.json
+          push: never
+          imageName: ${{ steps.image_name.outputs.image_name }}
+          imageTag: ${{ steps.sanitized_tag.outputs.sanitized_tag }}

rhiza-0.8.0/.github/workflows/rhiza_docker.yml

@@ -0,0 +1,63 @@
+# GitHub Actions workflow: Lint Dockerfile with hadolint and build the image
+#
+# This workflow runs on pushes and pull requests. It performs two main tasks:
+#  - Lints docker/Dockerfile using hadolint (fails the job on lint errors)
+#  - Builds the container image with Docker Buildx to ensure the Dockerfile is valid
+#
+# Notes:
+#  - The image is built locally for validation only; it is not pushed to any registry.
+#  - Permissions are minimized (read-only) since no repository writes occur.
+name: DOCKER
+
+permissions:
+  contents: read
+
+on:
+  push:
+  pull_request:
+    branches: [ main, master ]
+
+jobs:
+  lint_and_build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Detect docker/Dockerfile presence
+        id: check_dockerfile
+        run: |
+          if [ -f docker/Dockerfile ]; then
+            echo "docker_present=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "docker_present=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Skip notice (no docker/Dockerfile present)
+        if: ${{ steps.check_dockerfile.outputs.docker_present != 'true' }}
+        run: echo "No docker/Dockerfile found; skipping hadolint and image build."
+
+      - name: Lint Dockerfile with hadolint
+        if: ${{ steps.check_dockerfile.outputs.docker_present == 'true' }}
+        uses: hadolint/hadolint-action@v3.3.0
+        with:
+          dockerfile: docker/Dockerfile
+          # Fail on any error-level findings (default behavior). Adjust if needed:
+          # failure-threshold: error
+
+      - name: Set up Docker Buildx
+        if: ${{ steps.check_dockerfile.outputs.docker_present == 'true' }}
+        uses: docker/setup-buildx-action@v3
+
+      - name: Build container image with Docker Buildx (validation only)
+        if: ${{ steps.check_dockerfile.outputs.docker_present == 'true' }}
+        run: |
+          # Derive image tag from repository name and sanitize (remove '.' and '_')
+          REPO_NAME="${GITHUB_REPOSITORY##*/}"
+          REPO_NAME="${REPO_NAME//[._]/}"
+          docker buildx build \
+            --file docker/Dockerfile \
+            --tag "${REPO_NAME}:ci" \
+            --load \
+            .

rhiza-0.7.0/.github/workflows/pre-commit.yml → rhiza-0.8.0/.github/workflows/rhiza_pre-commit.yml

@@ -33,9 +33,9 @@ jobs:
       - name: Get Python version
         id: get-python
         run: |
-          echo "python-version=$(python ./.github/workflows/scripts/version_max.py)" >> "$GITHUB_OUTPUT"
+          echo "python-version=$(python ./.rhiza/utils/version_max.py)" >> "$GITHUB_OUTPUT"
 
-      - uses: ./.github/actions/setup-project
+      - uses: ./.github/rhiza/actions/setup-project
         with:
           python-version: ${{ steps.get-python.outputs.python-version }}
           uv-extra-index-url: ${{ secrets.UV_EXTRA_INDEX_URL }}

rhiza-0.7.0/.github/workflows/release.yml → rhiza-0.8.0/.github/workflows/rhiza_release.yml

@@ -111,7 +111,7 @@ jobs:
 
       # Use the composite action to set up the project
       - name: Setup the project
-        uses: ./.github/actions/setup-project
+        uses: ./.github/rhiza/actions/setup-project
         with:
           python-version: ${{ vars.PYTHON_DEFAULT_VERSION || '3.14' }}
           uv-extra-index-url: ${{ secrets.UV_EXTRA_INDEX_URL }}
@@ -321,7 +321,7 @@ jobs:
       - name: Get Python version
         id: get-python
         run: |
-          echo "python-version=$(python ./.github/workflows/scripts/version_max.py)" >> "$GITHUB_OUTPUT"
+          echo "python-version=$(python ./.rhiza/utils/version_max.py)" >> "$GITHUB_OUTPUT"
 
       - name: Set up Python
         uses: actions/setup-python@v6

rhiza-0.7.0/.github/workflows/sync.yml → rhiza-0.8.0/.github/workflows/rhiza_sync.yml

@@ -1,9 +1,9 @@
 name: RHIZA SYNC
 # This workflow synchronizes the repository with its template.
-# IMPORTANT: When workflow files (.github/workflows/*.yml) are modified,
+# IMPORTANT: When workflow files (.github/workflows/rhiza_*.yml) are modified,
 # a Personal Access Token (PAT) with 'workflow' scope is required.
 # The PAT_TOKEN secret must be set in repository secrets.
-# See .github/TOKEN_SETUP.md for setup instructions.
+# See .github/rhiza/TOKEN_SETUP.md for setup instructions.
 
 permissions:
   contents: write

rhiza-0.7.0/.github/workflows/rhiza.yml → rhiza-0.8.0/.github/workflows/rhiza_validate.yml

@@ -11,7 +11,7 @@ on:
 jobs:
   validation:
     runs-on: ubuntu-latest
-    # don't run this in rhiza itself. Rhiza has no template.yml file. 
+    # don't run this in rhiza itself. Rhiza has no template.yml file.
     if: ${{ github.repository != 'jebel-quant/rhiza' }}
     container:
       image: ghcr.io/astral-sh/uv:0.9.18-python3.12-trixie
@@ -20,7 +20,7 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v6
 
-      - name: Validate Rhiza config
-        shell: bash
-        run: |
-          uvx rhiza validate .
+      #- name: Validate Rhiza config
+      #  shell: bash
+      #  run: |
+      #    uvx rhiza validate .

{rhiza-0.7.0 → rhiza-0.8.0}/.gitignore

@@ -29,6 +29,9 @@ presentation.pdf
 # C extensions
 *.so
 
+# .DS_Store 
+.DS_Store
+
 # Distribution / packaging
 .Python
 build/

{rhiza-0.7.0 → rhiza-0.8.0}/.pre-commit-config.yaml

@@ -47,7 +47,7 @@ repos:
     hooks:
       - id: update-readme-help
         name: Update README with Makefile help output
-        entry: /bin/sh .github/scripts/update-readme-help.sh
+        entry: /bin/sh .rhiza/scripts/update-readme-help.sh
         language: system
         files: '^Makefile$'
         pass_filenames: false

rhiza-0.8.0/.rhiza/CONFIG.md

@@ -0,0 +1,41 @@
+# Rhiza Configuration
+
+This directory contains platform-agnostic scripts and utilities for the repository that can be used by GitHub Actions, GitLab CI, or other CI/CD systems.
+
+## Important Documentation
+
+- **[TOKEN_SETUP.md](TOKEN_SETUP.md)** - Instructions for setting up the `PAT_TOKEN` secret required for the SYNC workflow
+
+## Structure
+
+- **scripts/** - Shell scripts for common tasks (book generation, release, etc.)
+- **scripts/customisations/** - Repository-specific customization hooks
+- **utils/** - Python utilities for version management
+
+GitHub-specific composite actions are located in `.github/rhiza/actions/`.
+
+## Workflows
+
+The repository uses several automated workflows (located in `.github/workflows/`):
+
+- **SYNC** (`rhiza_sync.yml`) - Synchronizes with the template repository
+  - **Requires:** `PAT_TOKEN` secret with `workflow` scope when modifying workflow files
+  - See [TOKEN_SETUP.md](TOKEN_SETUP.md) for configuration
+- **CI** (`rhiza_ci.yml`) - Continuous integration tests
+- **Pre-commit** (`rhiza_pre-commit.yml`) - Code quality checks
+- **Book** (`rhiza_book.yml`) - Documentation deployment
+- **Release** (`rhiza_release.yml`) - Package publishing
+- **Deptry** (`rhiza_deptry.yml`) - Dependency checks
+- **Marimo** (`rhiza_marimo.yml`) - Interactive notebooks
+
+## Template Synchronization
+
+This repository is synchronized with the template repository defined in `template.yml`.
+
+The synchronization includes:
+- GitHub workflows and actions
+- Development tools configuration (`.editorconfig`, `ruff.toml`, etc.)
+- Testing infrastructure
+- Documentation templates
+
+See `template.yml` for the complete list of synchronized files and exclusions.

{rhiza-0.7.0/.github/rhiza → rhiza-0.8.0/.rhiza}/TOKEN_SETUP.md

@@ -4,7 +4,7 @@ This document explains how to set up a Personal Access Token (PAT) for the repos
 
 ## Why is PAT_TOKEN needed?
 
-The repository uses the `SYNC` workflow (`.github/workflows/sync.yml`) to automatically synchronize with a template repository. When this workflow modifies files in `.github/workflows/`, GitHub requires special permissions that the default `GITHUB_TOKEN` doesn't have.
+The repository uses the `SYNC` workflow (`.github/workflows/rhiza_sync.yml`) to automatically synchronize with a template repository. When this workflow modifies files in `.github/workflows/`, GitHub requires special permissions that the default `GITHUB_TOKEN` doesn't have.
 
 According to GitHub's security policy:
 - The default `GITHUB_TOKEN` **cannot** create or update workflow files (`.github/workflows/*.yml`)

rhiza-0.7.0/.rhiza.history → rhiza-0.8.0/.rhiza/history

@@ -5,31 +5,31 @@
 #
 # Files under template control:
 .editorconfig
-.github/actions/setup-project/action.yml
 .github/dependabot.yml
-.github/renovate.json
-.github/rhiza/CONFIG.md
-.github/rhiza/TOKEN_SETUP.md
-.github/scripts/book.sh
-.github/scripts/bump.sh
-.github/scripts/customisations/build-extras.sh
-.github/scripts/customisations/post-release.sh
-.github/scripts/marimushka.sh
-.github/scripts/release.sh
-.github/scripts/update-readme-help.sh
-.github/workflows/book.yml
-.github/workflows/ci.yml
-.github/workflows/deptry.yml
-.github/workflows/marimo.yml
-.github/workflows/pre-commit.yml
-.github/workflows/release.yml
-.github/workflows/rhiza.yml
-.github/workflows/scripts/version_matrix.py
-.github/workflows/scripts/version_max.py
-.github/workflows/security.yml
-.github/workflows/sync.yml
+.github/rhiza/actions/setup-project/action.yml
+.github/workflows/rhiza_book.yml
+.github/workflows/rhiza_ci.yml
+.github/workflows/rhiza_deptry.yml
+.github/workflows/rhiza_devcontainer.yml
+.github/workflows/rhiza_docker.yml
+.github/workflows/rhiza_marimo.yml
+.github/workflows/rhiza_pre-commit.yml
+.github/workflows/rhiza_release.yml
+.github/workflows/rhiza_sync.yml
+.github/workflows/rhiza_validate.yml
 .gitignore
 .pre-commit-config.yaml
+.rhiza/CONFIG.md
+.rhiza/TOKEN_SETUP.md
+.rhiza/scripts/book.sh
+.rhiza/scripts/bump.sh
+.rhiza/scripts/customisations/build-extras.sh
+.rhiza/scripts/customisations/post-release.sh
+.rhiza/scripts/marimushka.sh
+.rhiza/scripts/release.sh
+.rhiza/scripts/update-readme-help.sh
+.rhiza/utils/version_matrix.py
+.rhiza/utils/version_max.py
 CODE_OF_CONDUCT.md
 CONTRIBUTING.md
 Makefile
@@ -38,7 +38,10 @@ book/marimo/README.md
 book/marimo/rhiza.py
 book/minibook-templates/custom.html.jinja2
 book/pdoc-templates/module.html.jinja2
+presentation/Makefile.presentation
+presentation/README.md
 pytest.ini
+renovate.json
 ruff.toml
 tests/Makefile.tests
 tests/test_rhiza/README.md

{rhiza-0.7.0/.github → rhiza-0.8.0/.rhiza}/scripts/customisations/build-extras.sh

@@ -15,7 +15,7 @@
 #
 # How to use:
 #   1. Add your custom installation commands below
-#   2. Make sure the script is executable: chmod +x .github/scripts/customisations/build-extras.sh
+#   2. Make sure the script is executable: chmod +x .rhiza/scripts/customisations/build-extras.sh
 #   3. Commit to your repository
 #
 # Examples:
@@ -26,7 +26,7 @@
 # Note: If you customize this file in your repository, add it to the exclude list
 #       in action.yml to prevent it from being overwritten by template updates:
 #       exclude: |
-#         .github/scripts/customisations/build-extras.sh
+#         .rhiza/scripts/customisations/build-extras.sh
 #
 
 set -euo pipefail

{rhiza-0.7.0/.github → rhiza-0.8.0/.rhiza}/scripts/customisations/post-release.sh

@@ -14,7 +14,7 @@
 #
 # How to use:
 #   1. Add your custom post-release commands below
-#   2. Make sure the script is executable: chmod +x .github/scripts/customisations/post-release.sh
+#   2. Make sure the script is executable: chmod +x .rhiza/scripts/customisations/post-release.sh
 #   3. Commit to your repository
 #
 # Examples:
@@ -26,7 +26,7 @@
 # Note: If you customize this file in your repository, add it to the exclude list
 #       in template.yml to prevent it from being overwritten by template updates:
 #       exclude: |
-#         .github/scripts/customisations/post-release.sh
+#         .rhiza/scripts/customisations/post-release.sh
 #
 
 set -euo pipefail

{rhiza-0.7.0/.github → rhiza-0.8.0/.rhiza}/scripts/update-readme-help.sh

@@ -6,7 +6,7 @@
 
 set -eu
 
-# Navigate to repository root
+# Navigate to repository root (from .rhiza/scripts/ up two levels to repo root)
 cd "$(dirname "$0")/../.."
 
 README_FILE="README.md"

{rhiza-0.7.0/.github/rhiza → rhiza-0.8.0/.rhiza}/template.yml

@@ -2,6 +2,7 @@ template-repository: "jebel-quant/rhiza"
 template-branch: "main"
 include:
     - .github
+    - .rhiza
     - tests
     - .editorconfig
     - .gitignore
@@ -13,6 +14,7 @@ include:
     - pytest.ini
     - presentation
     - book
+    - renovate.json
 exclude:
     - .github/workflows/docker.yml
     - .github/workflows/devcontainer.yml

{rhiza-0.7.0/.github/workflows/scripts → rhiza-0.8.0/.rhiza/utils}/version_matrix.py

@@ -11,7 +11,7 @@ from pathlib import Path
 from packaging.specifiers import SpecifierSet
 from packaging.version import Version
 
-PYPROJECT = Path(__file__).resolve().parents[3] / "pyproject.toml"
+PYPROJECT = Path(__file__).resolve().parents[2] / "pyproject.toml"
 CANDIDATES = ["3.11", "3.12", "3.13", "3.14"]  # extend as needed
 
 

{rhiza-0.7.0/.github/workflows/scripts → rhiza-0.8.0/.rhiza/utils}/version_max.py

@@ -11,7 +11,7 @@ from pathlib import Path
 from packaging.specifiers import SpecifierSet
 from packaging.version import Version
 
-PYPROJECT = Path(__file__).resolve().parents[3] / "pyproject.toml"
+PYPROJECT = Path(__file__).resolve().parents[2] / "pyproject.toml"
 CANDIDATES = ["3.11", "3.12", "3.13", "3.14"]  # extend as needed
 
 

{rhiza-0.7.0 → rhiza-0.8.0}/CLI.md

@@ -8,6 +8,7 @@ This document provides a quick reference for the Rhiza command-line interface.
 |---------|-------------|
 | `rhiza init` | Initialize or validate `.github/template.yml` |
 | `rhiza materialize` | Inject templates into a target repository |
+| `rhiza migrate` | Migrate to the new `.rhiza` folder structure |
 | `rhiza validate` | Validate template configuration |
 
 ## Common Usage Patterns
@@ -88,6 +89,38 @@ rhiza materialize -b main -y                # Short form
 
 ---
 
+### rhiza migrate
+
+**Purpose:** Migrate project to the new `.rhiza` folder structure
+
+**Syntax:**
+```bash
+rhiza migrate [TARGET]
+```
+
+**Parameters:**
+- `TARGET` - Target repository directory (default: current directory)
+
+**Examples:**
+```bash
+rhiza migrate                    # Migrate current directory
+rhiza migrate /path/to/project   # Migrate specific directory
+```
+
+**What It Does:**
+- Creates the `.rhiza/` directory in the project root
+- Moves `template.yml` from `.github/rhiza/` or `.github/` to `.rhiza/template.yml`
+- Moves `.rhiza.history` to `.rhiza/history`
+- Provides instructions for next steps
+- Skips files that already exist in `.rhiza/` (leaves old files in place for manual cleanup)
+
+**When to Use:**
+- Transitioning to the new `.rhiza/` folder structure
+- Organizing Rhiza configuration separately from `.github/`
+- Cleaning up project structure
+
+---
+
 ### rhiza validate
 
 **Purpose:** Validate `.github/template.yml` configuration