soba-cli 0.1.0

data/.devcontainer/sync-envs.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+set -e
+
+# Get the directory where this script is located
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# Path to .tool-versions and .env files
+TOOL_VERSIONS_FILE="$PROJECT_ROOT/.tool-versions"
+ENV_FILE="$SCRIPT_DIR/.env"
+
+# Check if .tool-versions exists
+if [ ! -f "$TOOL_VERSIONS_FILE" ]; then
+    echo "Error: .tool-versions file not found at $TOOL_VERSIONS_FILE"
+    exit 1
+fi
+
+# Extract Ruby version from .tool-versions
+RUBY_VERSION=$(grep "^ruby " "$TOOL_VERSIONS_FILE" | awk '{print $2}')
+
+if [ -z "$RUBY_VERSION" ]; then
+    echo "Error: Ruby version not found in .tool-versions"
+    exit 1
+fi
+
+echo "Found Ruby version: $RUBY_VERSION"
+
+# Get compose project name from directory
+COMPOSE_PROJECT_NAME=$(basename "$PROJECT_ROOT")
+echo "Found compose project name: $COMPOSE_PROJECT_NAME"
+
+# Create or update .env file
+if [ -f "$ENV_FILE" ]; then
+    # Update existing RUBY_VERSION line or add if not exists
+    if grep -q "^RUBY_VERSION=" "$ENV_FILE"; then
+        sed -i "s/^RUBY_VERSION=.*/RUBY_VERSION=$RUBY_VERSION/" "$ENV_FILE"
+        echo "Updated RUBY_VERSION in $ENV_FILE"
+    else
+        echo "RUBY_VERSION=$RUBY_VERSION" >> "$ENV_FILE"
+        echo "Added RUBY_VERSION to $ENV_FILE"
+    fi
+    
+    # Update existing COMPOSE_PROJECT_NAME line or add if not exists
+    if grep -q "^COMPOSE_PROJECT_NAME=" "$ENV_FILE"; then
+        sed -i "s/^COMPOSE_PROJECT_NAME=.*/COMPOSE_PROJECT_NAME=$COMPOSE_PROJECT_NAME/" "$ENV_FILE"
+        echo "Updated COMPOSE_PROJECT_NAME in $ENV_FILE"
+    else
+        echo "COMPOSE_PROJECT_NAME=$COMPOSE_PROJECT_NAME" >> "$ENV_FILE"
+        echo "Added COMPOSE_PROJECT_NAME to $ENV_FILE"
+    fi
+else
+    # Create new .env file
+    echo "RUBY_VERSION=$RUBY_VERSION" > "$ENV_FILE"
+    echo "COMPOSE_PROJECT_NAME=$COMPOSE_PROJECT_NAME" >> "$ENV_FILE"
+    echo "Created $ENV_FILE with RUBY_VERSION and COMPOSE_PROJECT_NAME"
+fi
+
+echo "Environment variables synchronized successfully!"

data/.envrc.sample

@@ -0,0 +1,7 @@
+# GitHub Personal Access Token for soba-cli
+# Required for GitHub API operations
+export GITHUB_TOKEN=your_github_token_here
+
+# Slack Webhook URL (Optional)
+# Used for sending notifications to Slack
+export SLACK_WEBHOOK_URL=https://hooks.slack.com/services/YOUR/WEBHOOK/URL

data/.rspec

@@ -0,0 +1,4 @@
+--require spec_helper
+--format progress
+--color
+--order random

data/.rubocop.yml

@@ -0,0 +1,70 @@
+inherit_from:
+  - .rubocop_todo.yml
+  - .rubocop_airbnb.yml
+
+require:
+  - rubocop-airbnb
+
+
+
+AllCops:
+  TargetRubyVersion: 3.2
+  NewCops: enable
+  Exclude:
+    - 'vendor/**/*'
+    - 'spec/fixtures/**/*'
+    - 'tmp/**/*'
+    - '.git/**/*'
+    - '.bundle/**/*'
+    - 'Gemfile.lock'
+
+# Project specific overrides
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*'
+    - '*.gemspec'
+    - 'Rakefile'
+    - 'bin/soba'
+
+Metrics/MethodLength:
+  Max: 20
+  Exclude:
+    - 'bin/soba'
+
+Metrics/ClassLength:
+  Max: 150
+
+Layout/LineLength:
+  Max: 120
+  Exclude:
+    - 'spec/**/*'
+
+# Allow Japanese comments in documentation
+Style/AsciiComments:
+  Enabled: false
+
+# For CLI application
+Style/GlobalVars:
+  Exclude:
+    - 'bin/soba'
+
+# For RSpec
+RSpec/MultipleExpectations:
+  Max: 3
+
+RSpec/ExampleLength:
+  Max: 15
+
+RSpec/NestedGroups:
+  Max: 4
+
+# This is a Rails-specific cop that doesn't apply to CLI applications
+Airbnb/ClassOrModuleDeclaredInWrongFile:
+  Enabled: false
+
+# Rails-specific cops that don't apply to CLI applications
+Rails/Pluck:
+  Enabled: false
+
+Rails/PluckInWhere:
+  Enabled: false

data/.rubocop_airbnb.yml

@@ -0,0 +1,2 @@
+# This is the Airbnb rubocop configuration file
+# It will be inherited by .rubocop.yml

data/.rubocop_todo.yml

@@ -0,0 +1,74 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2025-09-19 16:18:38 UTC using RuboCop version 1.32.0.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 1
+# Configuration parameters: Include.
+# Include: app/**/*, lib/**/*
+Airbnb/ConstAssignedInWrongFile:
+  Exclude:
+    - 'lib/soba/container.rb'
+
+# Offense count: 20
+# Configuration parameters: Include.
+# Include: app/**/*, lib/**/*
+Airbnb/ModuleMethodInWrongFile:
+  Exclude:
+    - 'lib/soba/infrastructure/github_client.rb'
+
+# Offense count: 1
+Airbnb/NoTimeout:
+  Exclude:
+    - 'lib/soba/services/pid_manager.rb'
+
+# Offense count: 8
+Airbnb/OptArgParameters:
+  Exclude:
+    - 'lib/soba/commands/start.rb'
+    - 'lib/soba/commands/status.rb'
+    - 'lib/soba/commands/stop.rb'
+    - 'lib/soba/services/pid_manager.rb'
+
+# Offense count: 3
+Airbnb/SimpleModifierConditional:
+  Exclude:
+    - 'lib/soba/commands/status.rb'
+    - 'lib/soba/domain/issue.rb'
+    - 'spec/spec_helper.rb'
+
+# Offense count: 4
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: leading, trailing
+Layout/DotPosition:
+  Exclude:
+    - 'spec/integration/github_client_spec.rb'
+
+# Offense count: 8
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EmptyLineBetweenMethodDefs, EmptyLineBetweenClassDefs, EmptyLineBetweenModuleDefs, AllowAdjacentOneLineDefs, NumberOfEmptyLines.
+Layout/EmptyLineBetweenDefs:
+  Exclude:
+    - 'lib/soba.rb'
+
+# Offense count: 86
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: final_newline, final_blank_line
+Layout/TrailingEmptyLines:
+  Enabled: false
+
+# Offense count: 1
+Style/MixinUsage:
+  Exclude:
+    - 'bin/soba'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Style/MultilineIfModifier:
+  Exclude:
+    - 'spec/spec_helper.rb'

data/.tool-versions

@@ -0,0 +1 @@
+ruby 3.4.5

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.

data/README.md

@@ -0,0 +1,384 @@
+# soba CLI
+
+[![GitHub Release](https://img.shields.io/github/v/release/douhashi/soba-cli)](https://github.com/douhashi/soba-cli/releases)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Ruby Version](https://img.shields.io/badge/ruby-%3E%3D%203.0-red)](https://www.ruby-lang.org/)
+
+[日本語版はこちら](README_ja.md)
+
+Autonomous GitHub Issue workflow automation CLI that bridges GitHub Issues with Claude Code, enabling AI-driven development cycles.
+
+## Overview
+
+soba CLI automates the entire development workflow from issue creation to pull request merging. It monitors GitHub Issues, automatically processes them through planning, implementation, review, and merge phases using Claude Code AI assistance.
+
+## Key Features
+
+- 🤖 **Autonomous Workflow**: Fully automated issue-to-merge pipeline
+- 🏷️ **Label-Driven State Management**: Progress tracking via GitHub labels
+- 🔄 **Continuous Processing**: Automatic polling and phase transitions
+- 🎯 **Priority Management**: Sequential processing by issue number
+- 🪟 **Tmux Integration**: Visual monitoring of AI processes
+- 🔀 **Git Worktree Support**: Isolated branch management
+- 🚀 **Auto-Merge**: Automatic PR merging after approval
+
+## Workflow
+
+```mermaid
+graph TD
+    A[Multiple soba:todo] -->|soba: Priority check| B[One becomes soba:queued]
+    B -->|soba: Immediately| C[soba:planning]
+    C -->|Claude: Plan creation| D[soba:ready]
+    D -->|soba: Auto-detect| E[soba:doing]
+    E -->|Claude: Implement & PR| F[soba:review-requested]
+    F -->|soba: Auto-detect| G[soba:reviewing]
+    G -->|Claude: Approve| H[soba:done + PR:soba:lgtm]
+    G -->|Claude: Request changes| I[soba:requires-changes]
+    I -->|soba: Auto-detect| K[soba:revising]
+    K -->|Claude: Apply fixes| F
+    H -->|soba: Auto-merge| J[soba:merged]
+    J -->|Next queuing| A
+```
+
+## Installation
+
+### As a Ruby Gem
+
+```bash
+gem install soba-cli
+```
+
+### From Source
+
+```bash
+# Clone the repository
+git clone https://github.com/douhashi/soba-cli.git
+cd soba-cli
+
+# Install dependencies
+bundle install
+
+# Run from source
+bin/soba --help
+```
+
+## Quick Start
+
+### ⚠ Important Notice ⚠
+
+soba uses `--dangerously-skip-permissions` by default to support AI-driven autonomous development. (This can be disabled in the configuration file)
+
+When using default settings, please take necessary precautions such as using devcontainers and restricting external access.
+
+---
+
+1. **Initialize configuration**
+   ```bash
+   soba init
+   ```
+
+2. **Configure settings**
+   Edit `.soba/config.yml`:
+   ```yaml
+   github:
+     token: ${GITHUB_TOKEN}
+     repository: owner/repo
+   ```
+
+3. **Start automation**
+   ```bash
+   soba start
+   ```
+
+4. **Create an issue with label**
+   Add `soba:todo` label to any GitHub issue to start automated processing.
+
+## Configuration
+
+Configuration file location: `.soba/config.yml` (in project root)
+
+### Full Configuration Example
+
+```yaml
+# GitHub settings
+github:
+  # Personal Access Token (can use environment variable)
+  token: ${GITHUB_TOKEN}
+  # Target repository (format: owner/repo)
+  repository: douhashi/soba-cli
+
+# 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
+  worktree_base_path: .git/soba/worktrees
+  # Auto-setup workspace on phase start (default: true)
+  setup_workspace: true
+
+# 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}}'
+```
+
+### Environment Variables
+
+| Variable | Description | Required |
+|----------|-------------|----------|
+| `GITHUB_TOKEN` | GitHub Personal Access Token with repo/read:org/write:discussion scopes | Yes |
+| `SLACK_WEBHOOK_URL` | Slack Webhook URL | No |
+
+### Claude Command Templates
+
+Soba automatically deploys Claude command templates to `.claude/commands/soba/` during initialization. These templates define the workflow automation commands for each phase:
+
+
+- **plan.md** - Issue planning phase template
+- **implement.md** - Implementation phase template
+- **review.md** - PR review phase template
+- **revise.md** - Revision phase template
+
+These templates are included in the gem package and can be found in:
+[lib/soba/templates/claude_commands/](lib/soba/templates/claude_commands/)
+
+## Commands
+
+### `soba init`
+Initialize soba configuration in the current project.
+
+```bash
+# Basic initialization
+soba init
+
+# Interactive mode
+soba init --interactive
+```
+
+### `soba start`
+Start the workflow automation daemon.
+
+```bash
+# Start in daemon mode (background)
+soba start
+
+# Start in daemon mode
+soba start --daemon
+
+# Start with specific issue
+soba start 123
+
+# Start without tmux
+soba start --no-tmux
+```
+
+### `soba status`
+Show daemon status and recent logs.
+
+```bash
+# Basic status
+soba status
+
+# Show more log lines
+soba status --log 50
+
+# Output as JSON
+soba status --json
+```
+
+### `soba stop`
+Stop the running daemon.
+
+```bash
+# Graceful stop
+soba stop
+
+# Force stop immediately
+soba stop --force
+
+# Custom timeout
+soba stop --timeout 60
+```
+
+### `soba open`
+Open or list tmux sessions for tasks.
+
+```bash
+# Open tmux session
+soba open
+
+# List all active sessions
+soba open --list
+```
+
+### `soba config`
+Display current configuration.
+
+```bash
+# Show configuration
+soba config
+
+# Use specific config file
+soba --config /path/to/config.yml config
+```
+
+## Label System
+
+### Issue Labels (State Management)
+
+| Label | State | Description |
+|-------|-------|-------------|
+| `soba:todo` | Waiting | New issue awaiting processing |
+| `soba:queued` | Queued | Selected for processing |
+| `soba:planning` | Planning | Claude creating implementation plan |
+| `soba:ready` | Ready | Plan complete, awaiting implementation |
+| `soba:doing` | Implementing | Claude working on implementation |
+| `soba:review-requested` | Review Pending | PR created, awaiting review |
+| `soba:reviewing` | Reviewing | Claude reviewing PR |
+| `soba:done` | Complete | Review approved, ready to merge |
+| `soba:requires-changes` | Changes Needed | Review requested modifications |
+| `soba:revising` | Revising | Claude applying requested changes |
+| `soba:merged` | Merged | PR merged and issue closed |
+
+### PR Labels
+
+| Label | Description |
+|-------|-------------|
+| `soba:lgtm` | Review approved, eligible for auto-merge |
+
+## Development
+
+### Directory Structure
+
+```
+lib/
+├── soba/
+│   ├── cli/              # CLI framework setup
+│   ├── commands/         # Command implementations
+│   ├── domain/           # Domain models
+│   ├── services/         # Business logic
+│   └── infrastructure/   # External integrations
+```
+
+### Running Tests
+
+```bash
+# Run all tests
+bundle exec rspec
+
+# Run with coverage
+bundle exec rake coverage
+
+# Run specific test suite
+bundle exec rspec spec/unit/
+```
+
+### Code Quality
+
+```bash
+# Run Rubocop (Airbnb style)
+bundle exec rubocop
+
+# Auto-fix violations
+bundle exec rubocop -a
+
+# Security audit
+bundle exec bundler-audit
+```
+
+### Git Hooks
+
+The project uses pre-commit hooks for code quality:
+- Automatic Rubocop fixes
+- Re-staging after auto-fixes
+- Block commits with manual fix requirements
+
+Setup hooks:
+```bash
+./scripts/setup-hooks.sh
+```
+
+## Requirements
+
+- Ruby >= 3.0
+- Git
+- tmux (optional, but recommended)
+- GitHub Personal Access Token
+- Claude Code CLI (`claude` command)
+
+## Architecture
+
+soba CLI follows a layered architecture:
+- **Commands Layer**: CLI command definitions and parsing
+- **Domain Layer**: Core business models and logic
+- **Services Layer**: Workflow orchestration and state management
+- **Infrastructure Layer**: GitHub API and external tool integration
+
+For detailed architecture documentation, see [docs/development/architecture.md](docs/development/architecture.md).
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit changes (`git commit -m 'Add amazing feature'`)
+4. Push to branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+Please ensure:
+- All tests pass (`bundle exec rspec`)
+- Rubocop checks pass (`bundle exec rubocop`)
+- Code coverage remains high
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Support
+
+- **Issues**: [GitHub Issues](https://github.com/douhashi/soba-cli/issues)
+- **Discussions**: [GitHub Discussions](https://github.com/douhashi/soba-cli/discussions)
+
+## Acknowledgments
+
+- Powered by [Claude Code](https://claude.ai/code) for AI-driven development
+- Built with [GLI](https://github.com/davetron5000/gli) for CLI framework
+- Styled with [Airbnb Ruby Style Guide](https://github.com/airbnb/ruby)