+ finalize by claude

Author: palkan

CHANGELOG.md

@@ -4,10 +4,9 @@
 
 ## 2.0.0
 
+- Added Claude-delegation: ask AI to finalize the installation (if present)
 - Add Claude Code CLI to the container (`dip claude`)
-- LSP support
-- Vite support
-- MySQL support
+- More configurations/features supported: LSPs, Vite, MySQL
 
 ## 1.1.0
 

template/_claude_finalize.rb

@@ -0,0 +1,58 @@
+# Check if Claude CLI is available and offer to run it for polishing the configuration
+
+claude_available = system("which claude > /dev/null 2>&1")
+
+if claude_available
+  if yes?("Would you like to run Claude to review and polish your Docker configuration?")
+    # Build the prompt with todos
+    todos_text = todos.map { |t| t.sub(/^\s*-?\s*/, "- ") }.join("\n")
+
+    prompt = <<~PROMPT
+      I just set up a Docker development environment for this Rails application using the "Ruby on Whales" template.
+
+      ## Generated files
+
+      The following files were created in `#{DOCKER_DEV_ROOT}/`:
+      - `Dockerfile` - Multi-stage Docker image for development
+      - `compose.yml` - Docker Compose configuration
+      - `Aptfile` - System dependencies
+      - `README.md` - Usage documentation
+
+      And `dip.yml` in the project root for the Dip CLI.
+
+      ## TODOs to complete
+
+      #{todos_text}
+
+      ## Your tasks
+
+      1. **Review the generated configuration** - Check the files in `#{DOCKER_DEV_ROOT}/` and `dip.yml` to ensure they match the project's needs
+      2. **Complete the TODOs** - Help me address each item listed above
+      3. **Suggest improvements** - Based on this project's structure, suggest any additional Docker configuration that might be helpful
+      4. **Document the setup** - Create or update documentation appropriate for this project:
+         - If CLAUDE.md or AGENTS.md exists, add Docker-related instructions there
+         - If there's a docs/ folder, consider adding a Docker setup guide
+         - Otherwise, ensure #{DOCKER_DEV_ROOT}/README.md is comprehensive
+
+      ## References
+
+      For more context, see these guides:
+      - [Ruby on Whales: Dockerizing Ruby and Rails development](https://evilmartians.com/chronicles/ruby-on-whales-docker-for-ruby-rails-development) - The main guide this template is based on
+      - [System of a test: Dockerizing system tests](https://evilmartians.com/chronicles/system-of-a-test-setting-up-end-to-end-rails-testing#dockerizing-system-tests) - For setting up system/integration tests with Docker
+      - [Vite-lizing Rails: Dockerizing Vite](https://evilmartians.com/chronicles/vite-lizing-rails-get-live-reload-and-hot-replacement-with-vite-ruby#dockerizing-vite-or-not) - For Vite.js integration with Docker
+    PROMPT
+
+    say_status :info, "Handing over to Claude to review your Docker setup...\n"
+
+    # Use fork + exec to hand over control to Claude for interactive session
+    # while allowing the parent process to complete
+    pid = fork do
+      exec(
+        "claude",
+        "--allowedTools", "Read", "Edit", "Write", "MultiEdit", "Glob", "Grep", "Bash(git *)",
+        prompt
+      )
+    end
+    Process.wait(pid)
+  end
+end

template/ruby-on-whales.rb

@@ -48,4 +48,8 @@
   say_status(:warn, todos.join("\n"))
 end
 
+<%= include "claude_finalize" %>
+
+
+
 say_status :info, "✅  You're ready to sail! Check out #{DOCKER_DEV_ROOT}/README.md or run `dip provision && dip up web` 🚀"

test/fixtures/bin/claude

@@ -0,0 +1,6 @@
+#!/bin/bash
+# Mock claude binary for testing
+# Writes all arguments to a file specified by CLAUDE_MOCK_OUTPUT env var
+
+output_file="${CLAUDE_MOCK_OUTPUT:-/tmp/claude_mock_args.txt}"
+echo "$@" > "$output_file"

test/template/claude_finalize_test.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+class ClaudeFinalizeTest < GeneratorTestCase
+  template <<~'CODE'
+    DOCKER_DEV_ROOT = ".dockerdev"
+    todos = [
+      "📝  Important things to take care of:",
+      "  - Make sure you have `ENV[\"RAILS_ENV\"] = \"test\"` (not `ENV[\"RAILS_ENV\"] ||= \"test\"`) in your test helper.",
+      "  - Don't forget to add DATABASE_URL to your database.yml"
+    ]
+
+    <%= include "claude_finalize" %>
+  CODE
+
+  def setup
+    super
+    @mock_bin = File.expand_path("../fixtures/bin", __dir__)
+    @claude_output_file = File.join(TMP_DIR, "claude_args.txt")
+  end
+
+  def test_runs_claude_with_correct_arguments
+    original_path = ENV["PATH"]
+    ENV["PATH"] = "#{@mock_bin}:#{original_path}"
+    ENV["CLAUDE_MOCK_OUTPUT"] = @claude_output_file
+
+    begin
+      run_generator(input: ["y"]) # "y" for yes? prompt
+    ensure
+      ENV["PATH"] = original_path
+      ENV.delete("CLAUDE_MOCK_OUTPUT")
+    end
+
+    assert File.exist?(@claude_output_file), "Mock claude should have been called"
+
+    args = File.read(@claude_output_file)
+
+    # Check --allowedTools flag and tools
+    assert_includes args, "--allowedTools"
+    assert_includes args, "Read"
+    assert_includes args, "Edit"
+    assert_includes args, "Write"
+    assert_includes args, "Grep"
+    assert_includes args, "Bash(git *)"
+
+    # Check prompt content includes todos
+    assert_includes args, "Ruby on Whales"
+    assert_includes args, "TODOs to complete"
+    assert_includes args, "Important things to take care of"
+    assert_includes args, "ENV[\"RAILS_ENV\"] = \"test\""
+    assert_includes args, "DATABASE_URL"
+
+    # Check prompt includes references
+    assert_includes args, "evilmartians.com/chronicles/ruby-on-whales-docker-for-ruby-rails-development"
+    assert_includes args, "system-of-a-test"
+    assert_includes args, "vite-lizing-rails"
+  end
+
+  def test_skips_when_user_declines
+    original_path = ENV["PATH"]
+    ENV["PATH"] = "#{@mock_bin}:#{original_path}"
+    ENV["CLAUDE_MOCK_OUTPUT"] = @claude_output_file
+
+    begin
+      run_generator(input: ["n"]) # "n" for no
+    ensure
+      ENV["PATH"] = original_path
+      ENV.delete("CLAUDE_MOCK_OUTPUT")
+    end
+
+    refute File.exist?(@claude_output_file), "Mock claude should not have been called when user declines"
+  end
+
+  def test_skips_when_claude_unavailable
+    # Don't add mock bin to PATH, so claude won't be found
+    ENV["CLAUDE_MOCK_OUTPUT"] = @claude_output_file
+    original_path = ENV["PATH"]
+    ENV["PATH"] = __dir__
+
+    begin
+      run_generator(input: []) # No input needed since prompt won't appear
+    ensure
+      ENV["PATH"] = original_path
+      ENV.delete("CLAUDE_MOCK_OUTPUT")
+    end
+
+    refute File.exist?(@claude_output_file), "Mock claude should not have been called when unavailable"
+  end
+end