chore: Sync with rhiza

.devcontainer/bootstrap.sh

@@ -2,10 +2,27 @@
 set -euo pipefail
 IFS=$'\n\t'
 
+# Error handler with descriptive messages and remediation steps
+error_with_recovery() {
+    local step="$1"
+    local error_msg="$2"
+    local remediation="$3"
+
+    echo "❌ ERROR: $step failed"
+    echo "   Details: $error_msg"
+    echo "   💡 Suggested fix: $remediation"
+    return 1
+}
+
 # Read Python version from .python-version (single source of truth)
 if [ -f ".python-version" ]; then
     export PYTHON_VERSION=$(cat .python-version | tr -d '[:space:]')
-    echo "Using Python version from .python-version: $PYTHON_VERSION"
+    echo "✓ Using Python version from .python-version: $PYTHON_VERSION"
+else
+    error_with_recovery \
+        "Python version detection" \
+        ".python-version file not found" \
+        "Ensure .python-version file exists in repository root"
 fi
 
 # Use INSTALL_DIR from environment or default to local bin
@@ -32,13 +49,36 @@ echo "export PATH=\"$INSTALL_DIR:\$PATH\"" >> ~/.bashrc
 # Add to current PATH so subsequent commands can find uv
 export PATH="$INSTALL_DIR:$PATH"
 
-make install
+# Install dependencies with recovery options
+echo "📦 Installing project dependencies..."
+if ! make install; then
+    error_with_recovery \
+        "Dependency installation" \
+        "make install failed" \
+        "Try: 1) Check internet connectivity, 2) Manually run 'make install' to see detailed errors, 3) Check disk space with 'df -h'"
+fi
+echo "✓ Dependencies installed successfully"
 
-# Install Marimo tool for notebook editing
-"$UV_BIN" tool install marimo 
+# Install Marimo tool for notebook editing with fallback
+echo "📓 Installing Marimo notebook tool..."
+if ! "$UV_BIN" tool install marimo 2>/dev/null; then
+    echo "⚠️  WARNING: Marimo installation failed (non-critical)"
+    echo "   You can manually install later with: uv tool install marimo"
+    echo "   Continuing with bootstrap..."
+else
+    echo "✓ Marimo installed successfully"
+fi
 
-# Initialize pre-commit hooks if configured
+# Initialize pre-commit hooks if configured with fallback
 if [ -f .pre-commit-config.yaml ]; then
-  # uvx runs tools without requiring them in the project deps
-  "$UVX_BIN" pre-commit install
+    echo "🔧 Setting up pre-commit hooks..."
+    if ! "$UVX_BIN" pre-commit install 2>/dev/null; then
+        echo "⚠️  WARNING: Pre-commit hook installation failed (non-critical)"
+        echo "   You can manually install later with: uvx pre-commit install"
+        echo "   Continuing with bootstrap..."
+    else
+        echo "✓ Pre-commit hooks configured successfully"
+    fi
 fi
+
+echo "✅ Bootstrap completed successfully!"

.devcontainer/devcontainer.json

@@ -5,19 +5,20 @@
         "cpus": 4
     },
     "features": {
-        "ghcr.io/devcontainers/features/common-utils:2": {},
-        "ghcr.io/devcontainers/features/git:1": {},
         "ghcr.io/devcontainers/features/github-cli:1": {},
-        "ghcr.io/devcontainers/features/copilot-cli:1": {}
+        "ghcr.io/devcontainers/features/copilot-cli:1": {},
+        "ghcr.io/devcontainers/features/node:1": {},
+        "ghcr.io/devcontainers/features/docker-in-docker:2": {
+            "moby": false
+        }
     },
     "mounts": [
         "source=${localEnv:HOME}/.ssh,target=/home/vscode/.ssh,type=bind,consistency=cached"
     ],
     "containerEnv": {
-        "SSH_AUTH_SOCK": "${localEnv:SSH_AUTH_SOCK}",
         "INSTALL_DIR": "/home/vscode/.local/bin"
     },
-    "forwardPorts": [8080],
+    "forwardPorts": [8080, 2718],
     "customizations": {
         "vscode": {
             "settings": {
@@ -43,7 +44,8 @@
                 "ms-vscode.makefile-tools",
                 // AI Assistance
                 "github.copilot-chat",
-                "github.copilot"
+                "github.copilot",
+                "anthropic.claude-code"
             ]
         }
     },

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,57 @@
+name: Bug Report
+description: Report a bug or unexpected behaviour
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug. Please fill out the sections below.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear and concise description of what the bug is.
+      placeholder: What happened?
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: Minimal steps to reproduce the behaviour.
+      placeholder: |
+        1. Run `make ...`
+        2. See error
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behaviour
+      description: What did you expect to happen?
+    validations:
+      required: true
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: |
+        Relevant versions and system info. Run `make info` if available.
+      placeholder: |
+        - OS: macOS 14 / Ubuntu 24.04 / Windows 11
+        - Python: 3.13.x
+        - rhiza version:
+    validations:
+      required: false
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional context
+      description: Logs, screenshots, or anything else that may be helpful.
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Question / Discussion
+    url: https://github.com/jqr-labs/rhiza/discussions
+    about: Ask questions or discuss ideas in GitHub Discussions rather than opening an issue.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,41 @@
+name: Feature Request
+description: Suggest a new feature or enhancement
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for proposing a feature. Please align with the team before investing significant effort.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem / motivation
+      description: What problem does this solve? Why is it valuable?
+      placeholder: As a contributor I find it hard to ... because ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed solution
+      description: Describe the solution you have in mind.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Other approaches you have considered and why you ruled them out.
+    validations:
+      required: false
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional context
+      description: Links, mockups, prior art, or anything else that may be helpful.
+    validations:
+      required: false