rhiza 0.8.7__tar.gz → 0.9.0__tar.gz

{rhiza-0.8.7 → rhiza-0.9.0}/.editorconfig

@@ -24,6 +24,11 @@ indent_size = 2
 # [*.{md,markdown}]
 # trim_trailing_whitespace = false
 
+# Makefiles require tabs
+[{Makefile,*.mk,*.make}]
+indent_style = tab
+indent_size = 4
+
 # Don't apply editorconfig rules to vendor/ resources
 # This is a "defensive" rule for the day we may have
 # the vendor folder

rhiza-0.8.7/.rhiza/agentic/Makefile.agentic → rhiza-0.9.0/.github/agents/agentic.mk

@@ -1,8 +1,8 @@
-## Makefile.customisations - User-defined scripts and overrides
+## customisations.mk - User-defined scripts and overrides
 # This file is included by the main Makefile
 
 # Declare phony targets
-.PHONY: install-copilot analyse-repo summarize-changes
+.PHONY: install-copilot analyse-repo summarise-changes
 
 COPILOT_BIN ?= $(shell command -v copilot 2>/dev/null || echo "$(INSTALL_DIR)/copilot")
 ##@ Agentic Workflows
@@ -17,8 +17,8 @@ analyse-repo: install-copilot ## run the analyser agent to update REPOSITORY_ANA
 		--allow-tool 'write' --deny-tool 'remove' \
 		--allow-all-paths
 
-summarize-changes: install-copilot ## summarize changes since the most recent release/tag
-	@"$(COPILOT_BIN)" -p "Show me the commits since the last release/tag and summarize them" --allow-tool 'shell(git)' --model "$(DEFAULT_AI_MODEL)" --agent summarise
+summarise-changes: install-copilot ## summarise changes since the most recent release/tag
+	@"$(COPILOT_BIN)" -p "Show me the commits since the last release/tag and summarise them" --allow-tool 'shell(git)' --model "$(DEFAULT_AI_MODEL)" --agent summarise
 
 install-copilot:  ## checks for copilot and prompts to install
 	@if command -v copilot >/dev/null 2>&1; then \

{rhiza-0.8.7 → rhiza-0.9.0}/.github/copilot-instructions.md

@@ -1,7 +1,7 @@
 # Rhiza Copilot Instructions
 
-You are working in a project that utilizes the `rhiza` framework. Rhiza is a collection of reusable
-configuration templates and tooling designed to standardize and streamline modern Python development.
+You are working in a project that utilises the `rhiza` framework. Rhiza is a collection of reusable
+configuration templates and tooling designed to standardise and streamline modern Python development.
 
 As a Rhiza-based project, this workspace adheres to specific conventions for structure, dependency management, and automation.
 

rhiza-0.8.7/.github/Makefile.gh → rhiza-0.9.0/.github/github.mk

@@ -1,4 +1,4 @@
-## Makefile.gh - github repo maintenance and helpers
+## github.mk - github repo maintenance and helpers
 # This file is included by the main Makefile
 
 # Declare phony targets

rhiza-0.9.0/.github/workflows/rhiza_benchmarks.yml

@@ -0,0 +1,51 @@
+# This file is part of the jebel-quant/rhiza repository
+# (https://github.com/jebel-quant/rhiza).
+#
+# Workflow: Performance Benchmarks
+#
+# Purpose: Run performance benchmarks to track regressions.
+#
+# Trigger: On push to main/master branches and manual trigger.
+
+name: (RHIZA) Benchmarks
+
+permissions:
+  contents: read
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+  workflow_dispatch:
+
+jobs:
+  benchmark:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+        with:
+          lfs: true
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.9.26"
+          python-version: "3.12"
+
+      - name: Run benchmarks
+        run: |
+          make install
+          make benchmark
+
+      - name: Upload benchmark results
+        uses: actions/upload-artifact@v6
+        if: always()
+        with:
+          name: benchmark-results
+          path: |
+            tests/test_rhiza/benchmarks/benchmarks.json
+            tests/test_rhiza/benchmarks/benchmarks.svg
+            tests/test_rhiza/benchmarks/benchmarks.html

{rhiza-0.8.7 → rhiza-0.9.0}/.github/workflows/rhiza_book.yml

@@ -14,7 +14,7 @@
 #   - 🧪 Run tests and generate coverage reports
 #   - 🚀 Deploy combined documentation to GitHub Pages
 
-name: "BOOK"
+name: "(RHIZA) BOOK"
 
 on:
   push:
@@ -43,7 +43,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          version: "0.9.24"
+          version: "0.9.26"
 
       - name: "Sync the virtual environment for ${{ github.repository }}"
         shell: bash
@@ -54,7 +54,7 @@ jobs:
 
       - name: "Make the book"
         run: |
-          make book
+          make -f .rhiza/rhiza.mk book
 
       # Step 5: Package all artifacts for GitHub Pages deployment
       # This prepares the combined outputs for deployment by creating a single artifact
@@ -66,7 +66,7 @@ jobs:
       # Step 6: Deploy the packaged artifacts to GitHub Pages
       # This step publishes the content to GitHub Pages
       # The deployment is conditional based on whether the repository is a fork and the PUBLISH_COMPANION_BOOK variable is set
-      # If the repository is a fork, deployment is skipped to avoid unauthorized publishing
+      # If the repository is a fork, deployment is skipped to avoid unauthorised publishing
       # If PUBLISH_COMPANION_BOOK is not set, it defaults to allowing deployment
       - name: Deploy to GitHub Pages
         if: ${{ !github.event.repository.fork && (vars.PUBLISH_COMPANION_BOOK == 'true' || vars.PUBLISH_COMPANION_BOOK == '') }}

{rhiza-0.8.7 → rhiza-0.9.0}/.github/workflows/rhiza_ci.yml

@@ -7,7 +7,7 @@
 #
 # Trigger: On push and pull requests to main/master branches.
 
-name: CI
+name: (RHIZA) CI
 
 permissions:
   contents: read
@@ -29,12 +29,12 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          version: "0.9.24"
+          version: "0.9.26"
 
       - id: versions
         run: |
           # Generate Python versions JSON from the script
-          JSON=$(make -s version-matrix)
+          JSON=$(make -f .rhiza/rhiza.mk -s version-matrix)
           echo "list=$JSON" >> "$GITHUB_OUTPUT"
 
       - name: Debug matrix
@@ -58,9 +58,9 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          version: "0.9.24"
+          version: "0.9.26"
           python-version: ${{ matrix.python-version }}
 
       - name: Run tests
         run: |
-          make test
+          make -f .rhiza/rhiza.mk test

{rhiza-0.8.7 → rhiza-0.9.0}/.github/workflows/rhiza_codeql.yml

@@ -9,7 +9,22 @@
 # the `language` matrix defined below to confirm you have the correct set of
 # supported CodeQL languages.
 #
-name: "CodeQL Advanced"
+# ******** IMPORTANT: GitHub Advanced Security Required ********
+# CodeQL is FREE for public repositories, but requires GitHub Advanced Security
+# (part of GitHub Enterprise) for private repositories.
+#
+# This workflow automatically:
+# - Runs on public repositories
+# - Skips on private repositories (unless Advanced Security is available)
+#
+# To control this behavior, set the CODEQL_ENABLED repository variable:
+# - Set to 'true' to force enable (if you have Advanced Security on private repos)
+# - Set to 'false' to disable entirely
+# - Leave unset for automatic behavior (recommended)
+#
+# For more information, see docs/CUSTOMIZATION.md
+#
+name: "(RHIZA) CODEQL"
 
 on:
   push:
@@ -28,7 +43,15 @@ jobs:
     #   - https://gh.io/using-larger-runners (GitHub.com only)
     # Consider using larger runners or machines with greater resources for possible analysis time improvements.
     runs-on: ${{ (matrix.language == 'swift' && 'macos-latest') || 'ubuntu-latest' }}
-    if: ${{ !github.event.repository.private }}
+    # CodeQL requires GitHub Advanced Security (part of GitHub Enterprise).
+    # For users without Enterprise license:
+    # - Public repositories: CodeQL is available for free
+    # - Private repositories: Requires GitHub Advanced Security
+    # To disable this workflow, set CODEQL_ENABLED repository variable to 'false'
+    # To enable this workflow for private repos with Advanced Security, set CODEQL_ENABLED to 'true'
+    if: |
+      vars.CODEQL_ENABLED == 'true' ||
+      (vars.CODEQL_ENABLED != 'false' && github.event.repository.visibility == 'public')
     permissions:
       # required for all workflows
       security-events: write

{rhiza-0.8.7 → rhiza-0.9.0}/.github/workflows/rhiza_deptry.yml

@@ -10,7 +10,7 @@
 # Trigger: This workflow runs on every push and on pull requests to main/master
 #          branches (including from forks)
 
-name: "DEPTRY"
+name: "(RHIZA) DEPTRY"
 
 # Permissions: Only read access to repository contents is needed
 permissions:
@@ -27,14 +27,14 @@ jobs:
     name: Check dependencies with deptry
     runs-on: ubuntu-latest
     container:
-      image: ghcr.io/astral-sh/uv:0.9.24-python3.12-trixie
+      image: ghcr.io/astral-sh/uv:0.9.26-python3.12-trixie
 
     steps:
       - uses: actions/checkout@v6
 
       - name: Run deptry
-        run: make deptry
+        run: make -f .rhiza/rhiza.mk deptry
         # NOTE: make deptry is good style because it encapsulates the folders to check
         # (e.g. src and book/marimo) and keeps CI in sync with local development.
-        # Since we use a 'uv' container, the Makefile is optimized to use the
+        # Since we use a 'uv' container, the Makefile is optimised to use the
         # pre-installed 'uv' and 'uvx' from the system PATH.

{rhiza-0.8.7 → rhiza-0.9.0}/.github/workflows/rhiza_marimo.yml

@@ -15,7 +15,7 @@
 #   - 🧪 Run each notebook in parallel using a matrix strategy
 #   - ✅ Fail-fast disabled to report all failing notebooks
 
-name: "MARIMO"
+name: "(RHIZA) MARIMO"
 
 permissions:
   contents: read
@@ -40,7 +40,9 @@ jobs:
       - name: Find notebooks and build matrix
         id: notebooks
         run: |
-          NOTEBOOK_DIR="book/marimo"
+          # Extract MARIMO_FOLDER from the project configuration (via Makefile)
+          NOTEBOOK_DIR=$(make -s -f Makefile -f - <<< 'print: ; @echo $(or $(MARIMO_FOLDER),marimo)' print)
+
           echo "Searching notebooks in: $NOTEBOOK_DIR"
           # Check if directory exists
           if [ ! -d "$NOTEBOOK_DIR" ]; then
@@ -80,7 +82,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          version: "0.9.24"
+          version: "0.9.26"
 
       # Execute the notebook with the appropriate runner based on its content
       - name: Run notebook

{rhiza-0.8.7 → rhiza-0.9.0}/.github/workflows/rhiza_pre-commit.yml

@@ -14,7 +14,7 @@
 # Components:
 #   - 🔍 Run pre-commit checks using reusable action
 
-name: "PRE-COMMIT"
+name: "(RHIZA) PRE-COMMIT"
 permissions:
   contents: read
 
@@ -34,4 +34,4 @@ jobs:
       # Run pre-commit
       - name: Run pre-commit
         run: |
-          make fmt
+          make -f .rhiza/rhiza.mk fmt

{rhiza-0.8.7 → rhiza-0.9.0}/.github/workflows/rhiza_release.yml

@@ -53,7 +53,7 @@
 #   set to "true" or .devcontainer directory doesn't exist.
 
 
-name: RELEASE
+name: (RHIZA) RELEASE
 
 on:
   push:
@@ -111,7 +111,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          version: "0.9.24"
+          version: "0.9.26"
 
       - name: "Sync the virtual environment for ${{ github.repository }}"
         shell: bash
@@ -322,7 +322,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          version: "0.9.24"
+          version: "0.9.26"
 
       - name: "Sync the virtual environment for ${{ github.repository }}"
         shell: bash

rhiza-0.9.0/.github/workflows/rhiza_security.yml

@@ -0,0 +1,36 @@
+# This file is part of the jebel-quant/rhiza repository
+# (https://github.com/jebel-quant/rhiza).
+#
+# Workflow: Security
+#
+# Purpose: This workflow runs security scans on the project including:
+#          - pip-audit: Check for known vulnerabilities in dependencies
+#          - bandit: Static analysis for common security issues in Python code
+#
+# Trigger: This workflow runs on every push and on pull requests to main/master
+#          branches (including from forks)
+
+name: "(RHIZA) SECURITY"
+
+# Permissions: Only read access to repository contents is needed
+permissions:
+    contents: read
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+
+jobs:
+  security:
+    name: Security scanning
+    runs-on: ubuntu-latest
+    container:
+      image: ghcr.io/astral-sh/uv:0.9.26-python3.12-trixie
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Run security scans
+        run: make security

{rhiza-0.8.7 → rhiza-0.9.0}/.github/workflows/rhiza_sync.yml

@@ -1,4 +1,4 @@
-name: RHIZA SYNC
+name: (RHIZA) SYNC
 # This workflow synchronizes the repository with its template.
 # IMPORTANT: When workflow files (.github/workflows/rhiza_*.yml) are modified,
 # a Personal Access Token (PAT) with 'workflow' scope is required.
@@ -69,6 +69,9 @@ jobs:
 
           echo "changes_detected=true" >> "$GITHUB_OUTPUT"
 
+          # Generate PR description based on staged changes
+          uvx rhiza summarise --output pr-description.md
+
           git config user.name  "github-actions[bot]"
           git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
 
@@ -85,7 +88,4 @@ jobs:
           branch: ${{ steps.branch.outputs.name }}
           delete-branch: true
           title: "chore: Sync with rhiza"
-          body: |
-            This pull request synchronizes the repository with its template.
-
-            Changes were generated automatically using **rhiza**.
+          body-path: pr-description.md

{rhiza-0.8.7 → rhiza-0.9.0}/.github/workflows/rhiza_validate.yml

@@ -1,4 +1,4 @@
-name: RHIZA VALIDATE
+name: (RHIZA) VALIDATE
 
 permissions:
   contents: read
@@ -15,7 +15,7 @@ jobs:
     # 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.24-python3.12-trixie
+      image: ghcr.io/astral-sh/uv:0.9.26-python3.12-trixie
 
     steps:
       - name: Checkout repository

{rhiza-0.8.7 → rhiza-0.9.0}/.gitignore

@@ -5,7 +5,6 @@
 
 ### Don't expose API keys, etc.
 .env
-!.rhiza/.env
 
 __marimo__
 
@@ -13,11 +12,12 @@ _tests
 _book
 _pdoc
 _marimushka
+_benchmarks
 
 # temp file used by Junie
 .output.txt
 
-# folder used for task
+# folder used for programs, e.g. uv, uvx, task, etc.
 bin
 
 # Byte-compiled / optimized / DLL files
@@ -93,4 +93,6 @@ instance/
 # Cython debug symbols
 cython_debug/
 
+# Makefile
+local.mk
 

{rhiza-0.8.7 → rhiza-0.9.0}/.pre-commit-config.yaml

@@ -9,7 +9,7 @@ repos:
       - id: check-yaml
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: 'v0.14.11'
+    rev: 'v0.14.13'
     hooks:
       - id: ruff
         args: [ --fix, --exit-non-zero-on-fix, --unsafe-fixes ]
@@ -43,11 +43,24 @@ repos:
     hooks:
       - id: validate-pyproject
 
+  - repo: https://github.com/PyCQA/bandit
+    rev: 1.9.2
+    hooks:
+      - id: bandit
+        args: ["--skip", "B101", "--exclude", ".venv,tests,.git,.pytest_cache"]
+
   - repo: local
     hooks:
       - id: update-readme-help
         name: Update README with Makefile help output
-        entry: /bin/sh .rhiza/scripts/update-readme-help.sh
+        entry: make readme
         language: system
         files: '^Makefile$'
         pass_filenames: false
+
+      - id: check-rhiza-workflow-names
+        name: Check and Fix Rhiza workflow names
+        entry: python .rhiza/scripts/check_workflow_names.py
+        language: python
+        additional_dependencies: [PyYAML]
+        files: ^\.github/workflows/rhiza_.*\.ya?ml$

rhiza-0.9.0/.rhiza/.gitignore

@@ -0,0 +1,2 @@
+# Dedicated rhiza ignore rules
+!.env

{rhiza-0.8.7 → rhiza-0.9.0}/.rhiza/docs/CONFIG.md

@@ -9,7 +9,7 @@ This directory contains platform-agnostic scripts and utilities for the reposito
 ## Structure
 
 - **scripts/** - Shell scripts for common tasks (book generation, release, etc.)
-- **scripts/customisations/** - Repository-specific customization hooks
+- **scripts/customisations/** - Repository-specific customisation hooks
 - **utils/** - Python utilities for version management
 
 GitHub-specific composite actions are located in `.github/rhiza/actions/`.

{rhiza-0.8.7 → rhiza-0.9.0}/.rhiza/history

@@ -5,10 +5,12 @@
 #
 # Files under template control:
 .editorconfig
-.github/Makefile.gh
+.github/agents/agentic.mk
 .github/agents/analyser.md
 .github/agents/summarise.md
 .github/copilot-instructions.md
+.github/github.mk
+.github/workflows/rhiza_benchmarks.yml
 .github/workflows/rhiza_book.yml
 .github/workflows/rhiza_ci.yml
 .github/workflows/rhiza_codeql.yml
@@ -16,6 +18,7 @@
 .github/workflows/rhiza_marimo.yml
 .github/workflows/rhiza_pre-commit.yml
 .github/workflows/rhiza_release.yml
+.github/workflows/rhiza_security.yml
 .github/workflows/rhiza_sync.yml
 .github/workflows/rhiza_validate.yml
 .gitignore
@@ -23,53 +26,52 @@
 .python-version
 .rhiza/.cfg.toml
 .rhiza/.env
-.rhiza/Makefile.rhiza
-.rhiza/agentic/Makefile.agentic
-.rhiza/customisations/Makefile.customisations
-.rhiza/customisations/scripts/build-extras.sh
-.rhiza/customisations/scripts/post-release.sh
+.rhiza/.gitignore
 .rhiza/docs/CONFIG.md
 .rhiza/docs/TOKEN_SETUP.md
+.rhiza/make.d/01-custom-env.mk
+.rhiza/make.d/10-custom-task.mk
+.rhiza/make.d/README.md
 .rhiza/requirements/README.md
 .rhiza/requirements/docs.txt
 .rhiza/requirements/marimo.txt
 .rhiza/requirements/tests.txt
 .rhiza/requirements/tools.txt
-.rhiza/scripts/book.sh
-.rhiza/scripts/generate-coverage-badge.sh
-.rhiza/scripts/marimushka.sh
+.rhiza/rhiza.mk
+.rhiza/scripts/check_workflow_names.py
 .rhiza/scripts/release.sh
-.rhiza/scripts/update-readme-help.sh
 .rhiza/utils/version_matrix.py
 CODE_OF_CONDUCT.md
 CONTRIBUTING.md
 Makefile
-book/Makefile.book
 book/README.md
+book/book.mk
 book/marimo/README.md
-book/marimo/rhiza.py
+book/marimo/marimo.mk
+book/marimo/notebooks/rhiza.py
 book/minibook-templates/custom.html.jinja2
 book/pdoc-templates/module.html.jinja2
-presentation/Makefile.presentation
 presentation/README.md
+presentation/presentation.mk
 pytest.ini
 renovate.json
 ruff.toml
-tests/Makefile.tests
 tests/test_rhiza/README.md
 tests/test_rhiza/benchmarks/.gitignore
 tests/test_rhiza/benchmarks/README.md
 tests/test_rhiza/benchmarks/analyze_benchmarks.py
 tests/test_rhiza/conftest.py
-tests/test_rhiza/test_coverage_badge.py
+tests/test_rhiza/test_check_workflow_names.py
 tests/test_rhiza/test_docstrings.py
 tests/test_rhiza/test_git_repo_fixture.py
 tests/test_rhiza/test_makefile.py
+tests/test_rhiza/test_makefile_api.py
 tests/test_rhiza/test_makefile_gh.py
-tests/test_rhiza/test_marimushka_script.py
+tests/test_rhiza/test_marimushka_target.py
 tests/test_rhiza/test_notebooks.py
 tests/test_rhiza/test_readme.py
 tests/test_rhiza/test_release_script.py
 tests/test_rhiza/test_requirements_folder.py
 tests/test_rhiza/test_structure.py
-tests/test_rhiza/test_updatereadme_script.py
+tests/test_rhiza/test_version_matrix.py
+tests/tests.mk

rhiza-0.9.0/.rhiza/make.d/01-custom-env.mk

@@ -0,0 +1,9 @@
+## .rhiza/make.d/01-custom-env.mk - Custom Environment Configuration
+# This file example shows how to set variables for the project.
+
+# Custom variables for this repository
+PROJECT_NAME_EXTRA := Rhiza Platform
+LOG_LEVEL ?= INFO
+
+# Overriding core variables (be careful)
+# VENV := .venv_custom

rhiza-0.9.0/.rhiza/make.d/10-custom-task.mk

@@ -0,0 +1,12 @@
+## .rhiza/make.d/10-custom-task.mk - Custom Repository Tasks
+# This file example shows how to add new targets.
+
+.PHONY: hello-rhiza
+
+##@ Custom Tasks
+hello-rhiza: ## a custom greeting task
+	@printf "${GREEN}[INFO] Hello from the customised Rhiza project!${RESET}\n"
+
+# Adding logic to existing hooks
+post-install:: ## run custom logic after core install
+	@printf "${BLUE}[INFO] Running custom post-install steps...${RESET}\n"

rhiza-0.9.0/.rhiza/make.d/README.md

@@ -0,0 +1,82 @@
+# Makefile Cookbook
+
+This directory (`.rhiza/make.d/`) is the designated place for **repository-specific build logic**. Any `.mk` file added here is automatically absorbed by the main Makefile.
+
+Use this cookbook to find copy-paste patterns for common development needs.
+
+## 🥘 Recipes
+
+### 1. Add a Simple Task
+**Goal**: Run a script with `make train-model`.
+
+Create `.rhiza/make.d/50-model.mk`:
+```makefile
+##@ Machine Learning
+train: ## Train the model using local data
+	@echo "Training model..."
+	@uv run python scripts/train.py
+```
+
+### 2. Inject Code into Standard Workflows (Hooks)
+**Goal**: Apply task after `make sync`.
+
+Create `.rhiza/make.d/90-hooks.mk`:
+```makefile
+post-sync::
+	@echo "Applying something..."
+```
+*Note: Use double-colons (`::`) for hooks to avoid conflicts.*
+
+### 3. Define Global Variables
+**Goal**: Set a default timeout for all test runs.
+
+Create `.rhiza/make.d/01-config.mk`:
+```makefile
+# Override default timeout (defaults to 60s)
+export TEST_TIMEOUT := 120
+```
+
+### 4. Create a Private Shortcut
+**Goal**: Create a command that only exists on my machine (not committed).
+
+Do not use `.rhiza/make.d/`. Instead, create a `local.mk` in the project root:
+```makefile
+deploy-dev:
+	@./scripts/deploy-to-my-sandbox.sh
+```
+
+### 5. Install System Dependencies
+**Goal**: Ensure `graphviz` is installed for Marimo notebooks using a hook.
+
+Create `.rhiza/make.d/20-dependencies.mk`:
+```makefile
+pre-install::
+	@if ! command -v dot >/dev/null 2>&1; then \
+		echo "Graphviz not found. Installing..."; \
+		if command -v brew >/dev/null 2>&1; then \
+			brew install graphviz; \
+		elif command -v apt-get >/dev/null 2>&1; then \
+			sudo apt-get install -y graphviz; \
+		else \
+			echo "Please install graphviz manually."; \
+			exit 1; \
+		fi \
+	fi
+```
+
+---
+
+## ℹ️ Reference
+
+### Execution Order
+Files are loaded alphabetically. We use numeric prefixes to ensure dependencies resolve correctly:
+- `00-19`: Configuration & Variables
+- `20-79`: Custom Tasks & Rules
+- `80-99`: Hooks & Lifecycle logic
+
+### Available Hooks
+- `pre-install` / `post-install`: Runs around `make install`.
+- `pre-sync` / `post-sync`: Runs around repository synchronization.
+- `pre-validate` / `post-validate`: Runs around validation checks.
+- `pre-release` / `post-release`: Runs around release process.
+- `pre-bump` / `post-bump`: Runs around version bumping.