chore: update workflows and docs for deva rebrand

lroolle · claude · lroolle · commit 6915c0fd3296 · 2026-01-09T02:05:09.000-08:00
- release.yml: fix IMAGE_NAME ccyolo→deva, add rust profile build
- ci.yml: test deva.sh instead of deprecated claude.sh
- version-check.sh: check deva.sh version instead of claude.sh
- install.sh: update branding to deva Multi-Agent Environment
- Add .deva.example config reference file

Co-Authored-By: Claude Opus 4.5 &lt;noreply@anthropic.com&gt;
diff --git a/.deva.example b/.deva.example
@@ -0,0 +1,62 @@
+# deva Configuration File Example
+#
+# This file demonstrates the .deva config file format.
+# Config files are loaded in this order:
+#   1. $XDG_CONFIG_HOME/deva/.deva  (usually ~/.config/deva/.deva)
+#   2. $HOME/.deva
+#   3. ./.deva                       (project-specific)
+#   4. ./.deva.local                 (gitignored overrides)
+#
+# Lines starting with # are comments.
+# Blank lines are ignored.
+
+# VOLUME Directives
+# Mount host directories into container
+# Format: VOLUME=<host-path>:<container-path>:<mode>
+# Modes: ro (read-only), rw (read-write)
+VOLUME=$HOME/.ssh:/home/deva/.ssh:ro
+VOLUME=$HOME/projects/shared:/home/deva/shared:ro
+
+# ENV Directives
+# Set environment variables in container
+# Format: ENV=<VAR_NAME>=<value>
+ENV=EDITOR=vim
+ENV=LANG=en_US.UTF-8
+
+# Variable Assignments
+# Set deva.sh behavior variables
+# These control wrapper behavior, not container environment
+AUTH_METHOD=claude
+PROFILE=rust
+EPHEMERAL=false
+
+# Common Use Cases:
+#
+# 1. Mount read-only SSH keys:
+#    VOLUME=$HOME/.ssh:/home/deva/.ssh:ro
+#
+# 2. Mount project dependencies:
+#    VOLUME=$HOME/shared-libs:/home/deva/libs:ro
+#
+# 3. Set default editor:
+#    ENV=EDITOR=nvim
+#
+# 4. Enable Docker-in-Docker:
+#    ENV=DOCKER_IN_DOCKER=true
+#
+# 5. Set default profile:
+#    PROFILE=rust
+#
+# 6. Disable ephemeral containers (persistent):
+#    EPHEMERAL=false
+
+# Project-Specific Config (.deva in project root):
+#
+# VOLUME=./vendor:/home/deva/project/vendor:ro
+# ENV=DATABASE_URL=postgres://localhost/dev
+# PROFILE=rust
+
+# Personal Overrides (.deva.local - add to .gitignore):
+#
+# VOLUME=$HOME/personal-keys:/home/deva/keys:ro
+# ENV=API_KEY=secret-key-here
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -31,12 +31,12 @@ jobs:
 
       - name: Test help output
         run: |
-          ./claude.sh --help
+          ./deva.sh --help
           ./claude-yolo --help
 
       - name: Test version output
         run: |
-          ./claude.sh --version
+          ./deva.sh --version
           ./claude-yolo --version
 
       - name: Check version consistency
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -13,7 +13,7 @@ on:
 
 env:
   REGISTRY: ghcr.io
-  IMAGE_NAME: thevibeworks/ccyolo
+  IMAGE_NAME: thevibeworks/deva
 
 jobs:
   build-and-push:
@@ -48,21 +48,69 @@ jobs:
             type=ref,event=tag
             type=raw,value=latest,enable={{is_default_branch}}
 
-      - name: Build and push Docker image
+      - name: Build and push base image
         uses: docker/build-push-action@v5
         with:
           context: .
+          file: ./Dockerfile
           platforms: linux/amd64,linux/arm64
           push: true
           tags: ${{ steps.meta.outputs.tags }}
           labels: ${{ steps.meta.outputs.labels }}
           cache-from: type=gha
           cache-to: type=gha,mode=max
 
+  build-and-push-rust:
+    name: Build and Push Rust Profile Image
+    runs-on: ubuntu-latest
+    needs: build-and-push
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata for rust profile
+        id: meta-rust
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=ref,event=tag,suffix=-rust
+            type=raw,value=rust,enable={{is_default_branch}}
+
+      - name: Build and push rust image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: ./Dockerfile.rust
+          platforms: linux/amd64,linux/arm64
+          push: true
+          tags: ${{ steps.meta-rust.outputs.tags }}
+          labels: ${{ steps.meta-rust.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+          build-args: |
+            BASE_IMAGE=${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:latest
+
   release:
     name: Create GitHub Release
     runs-on: ubuntu-latest
-    needs: build-and-push
+    needs: [build-and-push, build-and-push-rust]
     permissions:
       contents: write
     steps:
@@ -80,15 +128,15 @@ jobs:
             echo "version=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT
           fi
 
-      - name: Update version in claude.sh
+      - name: Update version in deva.sh
         run: |
           VERSION="${{ steps.version.outputs.version }}"
           # Remove 'v' prefix if present
           VERSION=${VERSION#v}
-          sed -i "s/^VERSION=.*/VERSION=\"$VERSION\"/" claude.sh
+          sed -i "s/^VERSION=.*/VERSION=\"$VERSION\"/" deva.sh
           git config --local user.email "action@github.com"
           git config --local user.name "GitHub Action"
-          git add claude.sh
+          git add deva.sh
           git commit -m "Update version to $VERSION" || echo "No changes to commit"
 
       - name: Generate release notes
@@ -105,15 +153,20 @@ jobs:
           else
             echo "## Initial Release" > release_notes.md
             echo "" >> release_notes.md
-            echo "First release of Claude Code YOLO - Docker wrapper for Claude CLI with safe YOLO mode." >> release_notes.md
+            echo "First release of deva - Multi-agent development environment for Claude Code, Codex, and other AI coding assistants." >> release_notes.md
           fi
 
           echo "" >> release_notes.md
           echo "## Docker Images" >> release_notes.md
           echo "" >> release_notes.md
+          echo "**Base Profile (Python, Node, Go):**" >> release_notes.md
           echo "- \`ghcr.io/${{ env.IMAGE_NAME }}:${{ steps.version.outputs.version }}\`" >> release_notes.md
           echo "- \`ghcr.io/${{ env.IMAGE_NAME }}:latest\`" >> release_notes.md
           echo "" >> release_notes.md
+          echo "**Rust Profile (includes Rust toolchain):**" >> release_notes.md
+          echo "- \`ghcr.io/${{ env.IMAGE_NAME }}:${{ steps.version.outputs.version }}-rust\`" >> release_notes.md
+          echo "- \`ghcr.io/${{ env.IMAGE_NAME }}:rust\`" >> release_notes.md
+          echo "" >> release_notes.md
           echo "## Supported Architectures" >> release_notes.md
           echo "" >> release_notes.md
           echo "- linux/amd64" >> release_notes.md
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -7,6 +7,33 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Fixed
+- **CRITICAL**: docker-entrypoint.sh UID/GID remapping broken since commit 5807889 (2025-12-29)
+  - Fixed selective `find -maxdepth 1 -user root` approach that skipped `.npm-global`, `.local`, etc.
+  - Implemented explicit whitelist approach for container-managed directories
+  - Prevents "env: 'claude': Permission denied" errors on container startup
+  - See docs/UID-GID-HANDLING-RESEARCH.md for industry patterns analysis
+- GitHub workflows updated for deva rebrand
+  - release.yml: Fixed IMAGE_NAME from `ccyolo` to `deva`
+  - release.yml: Updated to modify `deva.sh` instead of `claude.sh`
+  - release.yml: Added rust profile build and push
+  - ci.yml: Updated tests to use `deva.sh` instead of `claude.sh`
+  - scripts/version-check.sh: Updated to check `deva.sh` version
+- install.sh: Updated branding to "deva Multi-Agent Environment"
+
+### Added
+- Comprehensive UID/GID handling research document (docs/UID-GID-HANDLING-RESEARCH.md)
+  - Industry patterns from VS Code DevContainers, Jupyter, fixuid, and production best practices
+  - Comparison matrix of 6 different UID/GID handling approaches
+  - Validation that runtime UID fixing is legitimate for dev containers
+- Developer log documenting the UID/GID fix investigation (docs/devlog/20260108-docker-uid-permission-fix.org)
+- docker-entrypoint.sh: Improved execution order (setup_nonroot_user before ensure_agent_binaries)
+- `.deva.example` - Reference config file demonstrating all supported directives (VOLUME, ENV, PROFILE, etc.)
+
+### Changed
+- GitHub release workflow now builds both base and rust profile images
+- Release notes now document both image profiles (base and rust)
+
 ## [0.9.0] - 2026-01-08
 
 ### Added
diff --git a/install.sh b/install.sh
@@ -1,15 +1,15 @@
 #!/bin/bash
 set -e
 
-# Claude Code YOLO Quick Installer
+# deva Multi-Agent Development Environment Installer
 
 SCRIPT_NAME="claude.sh"
 YOLO_WRAPPER="claude-yolo"
 DEVA_LAUNCHER="deva.sh"
 DOCKER_IMAGE="ghcr.io/thevibeworks/deva:latest"
 GITHUB_RAW="https://raw.githubusercontent.com/thevibeworks/claude-code-yolo/main"
 
-echo "Claude Code YOLO Installer"
+echo "deva Multi-Agent Environment Installer"
 echo "=========================="
 echo ""
 
diff --git a/scripts/version-check.sh b/scripts/version-check.sh
@@ -1,7 +1,7 @@
 #!/bin/bash
 set -e
 
-# Claude Code YOLO Version Consistency Checker
+# deva Version Consistency Checker
 # Validates that all version references are consistent
 
 RED='\033[0;31m'
@@ -21,8 +21,8 @@ warning() {
     echo -e "${YELLOW}⚠️ $1${NC}"
 }
 
-get_claude_version() {
-    grep 'VERSION=' claude.sh | head -1 | sed 's/.*VERSION="\([^"]*\)".*/\1/'
+get_deva_version() {
+    grep 'VERSION=' deva.sh | head -1 | sed 's/.*VERSION="\([^"]*\)".*/\1/'
 }
 
 get_changelog_version() {
@@ -34,35 +34,35 @@ get_git_latest_tag() {
 }
 
 check_consistency() {
-    local claude_version=$(get_claude_version)
+    local deva_version=$(get_deva_version)
     local changelog_version=$(get_changelog_version)
     local git_version=$(get_git_latest_tag)
     
     echo "Version Consistency Check"
     echo "========================="
-    echo "claude.sh:      $claude_version"
+    echo "deva.sh:      $deva_version"
     echo "CHANGELOG.md:   $changelog_version"
     echo "Latest git tag: $git_version"
     echo ""
     
     local issues=0
     
-    if [[ "$claude_version" != "$changelog_version" ]]; then
-        error "Version mismatch: claude.sh ($claude_version) != CHANGELOG.md ($changelog_version)"
+    if [[ "$deva_version" != "$changelog_version" ]]; then
+        error "Version mismatch: deva.sh ($deva_version) != CHANGELOG.md ($changelog_version)"
         issues=$((issues + 1))
     else
-        success "claude.sh and CHANGELOG.md versions match"
+        success "deva.sh and CHANGELOG.md versions match"
     fi
     
-    if [[ "$claude_version" != "$git_version" ]]; then
-        if [[ "$claude_version" > "$git_version" ]]; then
-            warning "claude.sh version ($claude_version) is newer than latest tag ($git_version) - this is expected for unreleased versions"
+    if [[ "$deva_version" != "$git_version" ]]; then
+        if [[ "$deva_version" > "$git_version" ]]; then
+            warning "deva.sh version ($deva_version) is newer than latest tag ($git_version) - this is expected for unreleased versions"
         else
-            error "claude.sh version ($claude_version) is older than latest tag ($git_version)"
+            error "deva.sh version ($deva_version) is older than latest tag ($git_version)"
             issues=$((issues + 1))
         fi
     else
-        success "claude.sh version matches latest git tag"
+        success "deva.sh version matches latest git tag"
     fi
     
     echo ""
@@ -75,13 +75,13 @@ check_consistency() {
         echo ""
         echo "To fix:"
         echo "  1. Use ./scripts/release.sh <version> for new releases"
-        echo "  2. Or manually update claude.sh and CHANGELOG.md to match"
+        echo "  2. Or manually update deva.sh and CHANGELOG.md to match"
         return 1
     fi
 }
 
 main() {
-    if [[ ! -f "claude.sh" ]] || [[ ! -f "CHANGELOG.md" ]]; then
+    if [[ ! -f "deva.sh" ]] || [[ ! -f "CHANGELOG.md" ]]; then
         error "Must be run from claude-code-yolo root directory"
         exit 1
     fi
