kie-ruby 0.1.0

data/.devcontainer/bin/down

@@ -0,0 +1,55 @@
+#!/bin/bash
+
+echo "Stopping devcontainer..."
+
+# Get the directory where this script is located
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ENV_FILE="$SCRIPT_DIR/../.env"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+PROJECT_NAME="$(basename "$PROJECT_ROOT")"
+
+# Load COMPOSE_PROJECT_NAME from .env file
+if [ -f "$ENV_FILE" ]; then
+    # Source the .env file to get COMPOSE_PROJECT_NAME
+    export $(grep -E '^COMPOSE_PROJECT_NAME=' "$ENV_FILE" | xargs)
+fi
+
+# Use COMPOSE_PROJECT_NAME from .env or fallback to directory name with _devcontainer suffix
+if [ -z "$COMPOSE_PROJECT_NAME" ]; then
+    COMPOSE_PROJECT_NAME="${PROJECT_NAME}_devcontainer"
+    echo "Warning: COMPOSE_PROJECT_NAME not found in .env, using default: $COMPOSE_PROJECT_NAME"
+fi
+
+echo "Compose project name: $COMPOSE_PROJECT_NAME"
+
+# Stop containers managed by docker compose if compose files exist
+cd .devcontainer 2>/dev/null || true
+if [ -f "compose.yaml" ] || [ -f "compose.yml" ]; then
+    if [ -f "compose.yaml" ]; then
+        echo "Running docker compose down..."
+        docker compose --env-file .env -f compose.yaml down
+    elif [ -f "compose.yml" ]; then
+        echo "Running docker compose down..."
+        docker compose --env-file .env -f compose.yml down
+    fi
+else
+    echo "No compose file found, skipping docker compose down"
+fi
+cd - >/dev/null 2>&1 || true
+
+# Stop containers by project name (regardless of compose file existence)
+echo "Searching for containers with project name: $PROJECT_NAME"
+CONTAINER_IDS=$(docker ps -q --filter "name=${PROJECT_NAME}")
+
+if [ -n "$CONTAINER_IDS" ]; then
+    echo "Found containers to stop:"
+    docker ps --filter "name=${PROJECT_NAME}" --format "table {{.Names}}\t{{.Status}}"
+    echo ""
+    echo "Stopping containers..."
+    docker stop $CONTAINER_IDS
+    echo "Containers stopped."
+else
+    echo "No running containers found with project name: $PROJECT_NAME"
+fi
+
+echo "Devcontainer cleanup completed."

data/.devcontainer/bin/init

@@ -0,0 +1,159 @@
+#!/bin/bash
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+DEVCONTAINER_DIR="$(dirname "$SCRIPT_DIR")"
+PROJECT_ROOT="$(dirname "$DEVCONTAINER_DIR")"
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Check if already initialized
+if [ -f "$DEVCONTAINER_DIR/compose.yaml" ]; then
+    echo -e "${YELLOW}This project has already been initialized.${NC}"
+    echo ""
+    # Try to extract configuration from compose.yaml
+    if grep -q "ports:" "$DEVCONTAINER_DIR/compose.yaml" 2>/dev/null; then
+        echo "Current configuration: Web application with ports"
+        grep -A10 "ports:" "$DEVCONTAINER_DIR/compose.yaml" | grep -E "^[ ]*-" | sed 's/.*"\([0-9]*\):.*/  - Port \1/'
+    else
+        echo "Current configuration: No ports configured"
+    fi
+    echo ""
+    read -p "Do you want to reinitialize? (y/N): " reinit
+    if [[ ! "$reinit" =~ ^[Yy]$ ]]; then
+        echo "Initialization cancelled."
+        exit 0
+    fi
+fi
+
+echo -e "${GREEN}=== DevContainer Project Initialization ===${NC}"
+echo ""
+
+# Project type selection
+echo "Select your project type:"
+echo "  1) Web Application (with ports)"
+echo "  2) CLI Tool (no ports)"
+echo "  3) Library/Package (no ports)"
+echo "  4) Custom (configure manually)"
+echo ""
+read -p "Enter your choice (1-4): " project_type
+
+case $project_type in
+    1)
+        PROJECT_TYPE="web"
+        echo ""
+        echo "Enter the ports your application needs (space-separated)."
+        echo "Examples:"
+        echo "  - Next.js/React: 3000"
+        echo "  - API + Frontend: 3000 8080"
+        echo "  - Full stack with DB: 3000 8080 5432"
+        echo ""
+        read -p "Ports: " -a PORTS
+
+        if [ ${#PORTS[@]} -eq 0 ]; then
+            echo -e "${RED}Error: Web applications require at least one port.${NC}"
+            exit 1
+        fi
+        ;;
+    2)
+        PROJECT_TYPE="cli"
+        PORTS=()
+        echo -e "${GREEN}CLI tool configuration selected (no ports).${NC}"
+        ;;
+    3)
+        PROJECT_TYPE="library"
+        PORTS=()
+        echo -e "${GREEN}Library/Package configuration selected (no ports).${NC}"
+        ;;
+    4)
+        PROJECT_TYPE="custom"
+        read -p "Do you need port forwarding? (y/N): " need_ports
+        if [[ "$need_ports" =~ ^[Yy]$ ]]; then
+            echo ""
+            read -p "Enter ports (space-separated): " -a PORTS
+        else
+            PORTS=()
+        fi
+        ;;
+    *)
+        echo -e "${RED}Invalid choice. Exiting.${NC}"
+        exit 1
+        ;;
+esac
+
+# Generate compose.yaml from template
+echo ""
+echo -e "${GREEN}Generating Docker Compose configuration...${NC}"
+
+# Build ports section
+if [ ${#PORTS[@]} -gt 0 ]; then
+    PORTS_SECTION="ports:"
+    for port in "${PORTS[@]}"; do
+        PORTS_SECTION="$PORTS_SECTION\n      - \"${port}:${port}\""
+    done
+    # Replace placeholder with ports section
+    sed "s|    {{PORTS_SECTION}}|    ${PORTS_SECTION}|" "$DEVCONTAINER_DIR/compose.yaml.template" | sed 's/\\n/\n/g' > "$DEVCONTAINER_DIR/compose.yaml"
+
+    # Generate devcontainer.local.json
+    PORTS_JSON=$(printf '%s,' "${PORTS[@]}" | sed 's/,$//')
+    cat > "$DEVCONTAINER_DIR/devcontainer.local.json" <<EOF
+{
+  "forwardPorts": [${PORTS_JSON}]
+}
+EOF
+
+    echo "✓ Port forwarding configured: ${PORTS[*]}"
+else
+    # No ports needed - remove the placeholder line entirely
+    sed '/{{PORTS_SECTION}}/d' "$DEVCONTAINER_DIR/compose.yaml.template" > "$DEVCONTAINER_DIR/compose.yaml"
+
+    # Create empty port forwarding config
+    cat > "$DEVCONTAINER_DIR/devcontainer.local.json" <<EOF
+{
+  "forwardPorts": []
+}
+EOF
+
+    echo -e "${GREEN}✓ No port forwarding configured${NC}"
+fi
+
+# Add comment to compose.yaml about configuration
+if [ -f "$DEVCONTAINER_DIR/compose.yaml" ]; then
+    # Prepend configuration info as comment
+    {
+        echo "# DevContainer configuration"
+        echo "# Generated: $(date -u +"%Y-%m-%d %H:%M:%S UTC")"
+        echo "# Project type: ${PROJECT_TYPE}"
+        if [ ${#PORTS[@]} -gt 0 ]; then
+            echo "# Ports: ${PORTS[*]}"
+        else
+            echo "# Ports: none"
+        fi
+        echo ""
+        cat "$DEVCONTAINER_DIR/compose.yaml"
+    } > "$DEVCONTAINER_DIR/compose.yaml.tmp"
+    mv "$DEVCONTAINER_DIR/compose.yaml.tmp" "$DEVCONTAINER_DIR/compose.yaml"
+fi
+
+echo ""
+echo -e "${GREEN}=== Initialization Complete ===${NC}"
+echo ""
+echo "Configuration summary:"
+echo "  Project Type: ${PROJECT_TYPE}"
+if [ ${#PORTS[@]} -gt 0 ]; then
+    echo "  Forwarded Ports: ${PORTS[*]}"
+else
+    echo "  Forwarded Ports: none"
+fi
+echo ""
+echo -e "${GREEN}You can now open this project in VS Code with DevContainers.${NC}"
+echo ""
+echo "Next steps:"
+echo "  1. The compose.yaml file has been generated (gitignored)"
+echo "  2. Open in VS Code: code . (then Reopen in Container)"
+echo "  3. Or use DevContainer CLI: devcontainer up --workspace-folder ."

data/.devcontainer/bin/rebuild

@@ -0,0 +1,10 @@
+#!/bin/bash
+
+# Get the directory where this script is located
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Source the common functions
+source "$SCRIPT_DIR/devcontainer-common.sh"
+
+# Rebuild and start devcontainer
+up_devcontainer "--remove-existing-container"

data/.devcontainer/bin/up

@@ -0,0 +1,11 @@
+#!/bin/bash
+
+# Get the directory where this script is located
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Source the common functions
+source "$SCRIPT_DIR/devcontainer-common.sh"
+
+# Start devcontainer and connect to it
+up_devcontainer ""
+exec_devcontainer

data/.devcontainer/compose.yaml

@@ -0,0 +1,12 @@
+# DevContainer configuration
+# Generated: 2026-01-10 04:57:22 UTC
+# Project type: library
+# Ports: none
+
+services:
+  app:
+    image: mcr.microsoft.com/vscode/devcontainers/base:ubuntu-24.04
+    volumes:
+      - ../..:/workspaces
+    command: sleep infinity
+    network_mode: bridge

data/.devcontainer/compose.yaml.template

@@ -0,0 +1,8 @@
+services:
+  app:
+    image: mcr.microsoft.com/vscode/devcontainers/base:ubuntu-24.04
+    volumes:
+      - ../..:/workspaces
+    {{PORTS_SECTION}}
+    command: sleep infinity
+    network_mode: bridge

data/.devcontainer/devcontainer.json

@@ -0,0 +1,30 @@
+{
+  "name": "Claude Code",
+  "dockerComposeFile": "compose.yaml",
+  "service": "app",
+  "workspaceFolder": "/workspaces/${localWorkspaceFolderBasename}",
+  "features": {
+    "ghcr.io/anthropics/devcontainer-features/claude-code:latest": {},
+    "ghcr.io/roul/devcontainer-features/mise-python:1": {},
+    "ghcr.io/roul/devcontainer-features/mise-node:1": {},
+    "ghcr.io/roul/devcontainer-features/mise-ruby:1": {},
+    "ghcr.io/devcontainers/features/github-cli:1": {},
+    "ghcr.io/devcontainers-extra/features/tmux-apt-get:1": {},
+    "ghcr.io/devcontainers/features/docker-in-docker:2": {
+      "version": "latest",
+      "moby": true,
+      "dockerDashComposeVersion": "v2",
+      "installDockerBuildx": true
+    }
+  },
+  "mounts": [
+    "type=bind,consistency=cached,source=${localEnv:HOME}/.gitconfig,target=/home/vscode/.gitconfig,readonly",
+    "type=bind,consistency=cached,source=${localEnv:HOME}/.config/gh,target=/home/vscode/.config/gh",
+    "type=bind,consistency=cached,source=${localEnv:HOME}/.claude,target=/home/vscode/.claude",
+    "type=bind,consistency=cached,source=${localEnv:HOME}/.ssh,target=/home/vscode/.ssh"
+  ],
+  "forwardPorts": [],
+  // Ports are configured via devcontainer.local.json after running init script
+  "postCreateCommand": "/bin/bash .devcontainer/scripts/setup.sh",
+  "initializeCommand": "/bin/bash -c 'if [ ! -f .devcontainer/compose.yaml ]; then echo \"ERROR: Project not initialized. Run: .devcontainer/bin/init\"; exit 1; fi'"
+}

data/.devcontainer/devcontainer.local.json

@@ -0,0 +1,3 @@
+{
+  "forwardPorts": []
+}

data/.devcontainer/scripts/setup.sh

@@ -0,0 +1,12 @@
+curl -L https://github.com/douhashi/soba/releases/latest/download/soba_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/x86_64/; s/aarch64/arm64/').tar.gz | tar xz -C /tmp && mkdir -p ~/.local/bin &&mv /tmp/soba ~/.local/bin/
+
+# Setup bash environment
+cat >> ~/.bashrc << 'EOF'
+
+# Custom settings for devcontainer
+export LANG=en_US.UTF-8
+export TERM=xterm-256color
+alias vim='nvim'
+alias claude='claude --dangerously-skip-permissions'
+EOF
+

data/.lefthook/rubocop-autofix.sh

@@ -0,0 +1,51 @@
+#!/bin/bash
+
+# Exit if no files provided
+if [ $# -eq 0 ]; then
+  exit 0
+fi
+
+# Filter only Ruby files
+ruby_files=()
+for file in "$@"; do
+  if [[ "$file" == *.rb ]]; then
+    ruby_files+=("$file")
+  fi
+done
+
+# Exit if no Ruby files
+if [ ${#ruby_files[@]} -eq 0 ]; then
+  exit 0
+fi
+
+# Run RuboCop with auto-fix
+bundle exec rubocop -a "${ruby_files[@]}"
+rubocop_exit_code=$?
+
+# Check if any staged files were modified by auto-fix
+modified_files=()
+for file in "${ruby_files[@]}"; do
+  if [ -f "$file" ] && ! git diff --quiet "$file" 2>/dev/null; then
+    modified_files+=("$file")
+  fi
+done
+
+# If files were modified by auto-fix, show message and fail
+if [ ${#modified_files[@]} -gt 0 ]; then
+  echo ""
+  echo "=============================================="
+  echo "  RuboCop has auto-fixed the following files:"
+  echo "=============================================="
+  for file in "${modified_files[@]}"; do
+    echo "  - $file"
+  done
+  echo ""
+  echo "Please review the changes, then re-stage and commit:"
+  echo "  git add ${modified_files[*]}"
+  echo "  git commit"
+  echo "=============================================="
+  exit 1
+fi
+
+# Return RuboCop's exit code
+exit $rubocop_exit_code

data/.soba/config.yml

@@ -0,0 +1,78 @@
+# GitHub settings
+github:
+  # Authentication method: 'gh', 'env', or omit for auto-detect
+  # Use 'gh' to use GitHub CLI authentication (gh auth token)
+  # Use 'env' to use environment variable
+  auth_method: gh  # or 'env', or omit for auto-detect
+
+  # Personal Access Token (required when auth_method is 'env' or omitted)
+  # Can use environment variable
+  # token: ${GITHUB_TOKEN}
+
+  # Target repository (format: owner/repo)
+  repository: douhashi/kie-ruby
+
+# Workflow settings
+workflow:
+  # Issue polling interval in seconds (default: 20)
+  interval: 20
+  # Use tmux for Claude execution (default: true)
+  use_tmux: true
+  # Enable automatic PR merging (default: true)
+  auto_merge_enabled: true
+  # Clean up tmux windows for closed issues (default: true)
+  closed_issue_cleanup_enabled: true
+  # Cleanup interval in seconds (default: 300)
+  closed_issue_cleanup_interval: 300
+  # Command delay for tmux panes in seconds (default: 3)
+  tmux_command_delay: 3
+
+# Slack notifications
+slack:
+  # Webhook URL for Slack notifications
+  # Get your webhook URL from: https://api.slack.com/messaging/webhooks
+  webhook_url: ${SLACK_WEBHOOK_URL}
+  # Enable notifications for phase starts (default: false)
+  notifications_enabled: false
+
+# Git settings
+git:
+  # Base path for git worktrees (default: /tmp/soba/worktrees)
+  worktree_base_path: /tmp/soba/worktrees
+  # Base branch for rebase operations and worktree creation (default: main)
+  base_branch: main
+
+# Logging settings
+log:
+  # Log file output path (default: .soba/logs/soba-{pid}.log)
+  # ${PID} will be replaced with actual process ID at runtime
+  output_path: .soba/logs/soba-${PID}.log
+  # Number of log files to retain (default: 10)
+  retention_count: 10
+  # Log level: debug, info, warn, error (default: info)
+  level: info
+  # Log format: "text" or "json" (default: text)
+  format: text
+
+# Phase commands (optional - for custom Claude commands)
+phase:
+  plan:
+    command: claude
+    options:
+      - --dangerously-skip-permissions
+    parameter: '/soba:plan {{issue-number}}'
+  implement:
+    command: claude
+    options:
+      - --dangerously-skip-permissions
+    parameter: '/soba:implement {{issue-number}}'
+  review:
+    command: claude
+    options:
+      - --dangerously-skip-permissions
+    parameter: '/soba:review {{issue-number}}'
+  revise:
+    command: claude
+    options:
+      - --dangerously-skip-permissions
+    parameter: '/soba:revise {{issue-number}}'

data/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2025-01-10
+
+### Added
+
+- Initial release of kie-ruby client library
+- Support for General API models
+  - `nano-banana-pro` for image generation
+- Support for Suno API models
+  - `V4`, `V4_5`, `V4_5PLUS`, `V4_5ALL`, `V5` for music generation
+- Unified `Kie::Client` interface for all models
+- Automatic polling with `task.wait(timeout:, interval:)`
+- Structured exception classes for error handling
+  - `AuthenticationError`, `InsufficientCreditsError`, `RateLimitError`
+  - `ContentPolicyError`, `TaskFailedError`, `TimeoutError`
+- Model registry for extensible model definitions
+- Input validation for Suno models (prompt, style, title length)

data/CLAUDE.md

@@ -0,0 +1,20 @@
+# Guideline
+
+## Top-Level Rules
+
+- Run independent processes concurrently, not sequentially.  
+- Think only in English; respond only in Japanese.  
+- Use **Contex7 MCP** to check library usage.  
+- Save temp design notes as `./.tmp/` in Markdown.  
+- After **Write/Edit**, always verify with **Read**, even if system says "(no content)".  
+- Be critical, not obedient—but stay respectful.
+
+## Context
+
+- Document System: @docs/document_system.md
+
+## Documents
+
+- Business: @docs/business/INDEX.md
+- Development: @docs/development/INDEX.md
+

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sho DOUHASHI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.