soba-cli 0.1.0

data/lib/soba/services/workflow_integrity_checker.rb

@@ -0,0 +1,151 @@
+# frozen_string_literal: true
+
+require_relative "../configuration"
+
+module Soba
+  module Services
+    class WorkflowIntegrityChecker
+      ACTIVE_LABELS = %w(
+        soba:queued
+        soba:planning
+        soba:doing
+        soba:reviewing
+        soba:revising
+      ).freeze
+
+      INTERMEDIATE_LABELS = %w(
+        soba:review-requested
+        soba:requires-changes
+      ).freeze
+
+      attr_reader :github_client, :logger
+
+      def initialize(github_client:, logger: nil)
+        @github_client = github_client
+        @logger = logger || SemanticLogger["WorkflowIntegrityChecker"]
+      end
+
+      def check_and_fix(repository, issues:, dry_run: false)
+        logger.info("Checking workflow integrity for #{repository}")
+
+        violations = detect_violations(issues)
+
+        if violations.empty?
+          logger.info("No workflow integrity violations found")
+          return {
+            violations_found: false,
+            fixed_count: 0,
+            violations: [],
+            dry_run: dry_run,
+          }
+        end
+
+        logger.warn("Found #{violations.size} workflow integrity violations")
+        violations.each do |violation|
+          logger.warn("  Issue ##{violation[:issue_number]}: #{violation[:label]} (#{violation[:action]})")
+        end
+
+        fixed_count = 0
+        failed_fixes = 0
+
+        if dry_run
+          logger.info("Dry run mode - no fixes applied")
+        else
+          violations.each do |violation|
+            if fix_violation(repository, violation)
+              fixed_count += 1
+            else
+              failed_fixes += 1
+            end
+          end
+          if fixed_count > 0 || failed_fixes > 0
+            logger.info("Fixed #{fixed_count} violations, #{failed_fixes} failed")
+          end
+        end
+
+        {
+          violations_found: true,
+          fixed_count: fixed_count,
+          failed_fixes: failed_fixes,
+          violations: violations,
+          dry_run: dry_run,
+        }
+      end
+
+      private
+
+      def detect_violations(issues)
+        violations = []
+
+        # Find all issues with active or intermediate labels
+        active_issues = issues.select do |issue|
+          labels = extract_label_names(issue.labels)
+          (labels & (ACTIVE_LABELS + INTERMEDIATE_LABELS)).any?
+        end
+
+        return violations if active_issues.size <= 1
+
+        # Multiple active issues detected - keep only the newest
+        # Sort by created_at descending (newest first)
+        sorted_issues = active_issues.sort_by { |issue| issue.created_at }.reverse
+        newest_issue = sorted_issues.first
+
+        # Mark all others as violations
+        sorted_issues[1..-1].each do |issue|
+          labels = extract_label_names(issue.labels)
+          conflicting_label = labels.find { |l| (ACTIVE_LABELS + INTERMEDIATE_LABELS).include?(l) }
+
+          violations << {
+            issue_number: issue.number,
+            label: conflicting_label,
+            action: "removed",
+            reason: "Multiple active issues detected, keeping newest (Issue ##{newest_issue.number})",
+          }
+        end
+
+        violations
+      end
+
+      def fix_violation(repository, violation)
+        logger.info("Fixing violation: Issue ##{violation[:issue_number]} - removing #{violation[:label]}")
+
+        # Determine the target label based on what's being removed
+        target_label = determine_target_label(violation[:label])
+
+        github_client.update_issue_labels(
+          repository,
+          violation[:issue_number],
+          from: violation[:label],
+          to: target_label
+        )
+
+        logger.info("Successfully fixed Issue ##{violation[:issue_number]}")
+        true
+      rescue => e
+        logger.error("Failed to fix violation for Issue ##{violation[:issue_number]}: #{e.message}")
+        false
+      end
+
+      def determine_target_label(from_label)
+        # Most labels should revert to todo
+        # Special cases can be handled here if needed
+        case from_label
+        when "soba:review-requested", "soba:requires-changes"
+          "soba:ready"  # Review states go back to ready
+        else
+          "soba:todo"   # Active states go back to todo
+        end
+      end
+
+      def extract_label_names(labels)
+        labels.map do |label|
+          if label.is_a?(Hash)
+            label[:name] || label["name"]
+          else
+            label.name
+          end
+        end
+      end
+    end
+  end
+end

data/lib/soba/templates/claude_commands/implement.md

@@ -0,0 +1,88 @@
+---
+allowed-tools: TodoRead, TodoWrite, Bash, Read, Write, Edit, MultiEdit, Grep, Glob
+description: "TDDによる実装とPR作成"
+---
+
+## 概要
+
+実装計画に基づいてTDDで開発を進め、Pull Requestを作成します。
+
+---
+
+## 前提条件
+
+- Issueコメントに実装計画が存在
+- ラベルは `soba:doing` の状態
+
+---
+
+## ルール
+
+1. **実装計画を必ず確認し従う**
+2. **TDD実践（テストファースト）**
+3. **既存設計・アーキテクチャを尊重**
+4. **実装完了後はPRを作成**
+5. **全テストのパスが必須条件**
+
+---
+
+## 実行手順
+
+1. **Issue・計画確認**
+   - `gh issue view <番号>` で内容確認
+   - `gh issue view <番号> --comments` でコメント確認
+
+2. **テスト作成**
+   - 計画に基づくテストケース作成
+   - Red → Green → Refactor
+
+3. **実装**
+   - 小さな単位でコミット
+   - 意味のあるコミットメッセージ
+
+4. **テスト実行**
+   - 単体テスト実行
+   - 全体テスト実行（必須）
+
+5. **PRテンプレート作成**
+   - `./.tmp/pull-request-<番号>.md` 作成
+
+6. **PR作成**
+   ```bash
+   gh pr create \
+     --title "feat: [機能名] (#<Issue番号>)" \
+     --body-file ./.tmp/pull-request-<番号>.md \
+     --base main
+   ```
+
+7. **Issueコメント**
+   - 「PR #<番号> を作成しました」
+
+8. **ラベル更新**
+   ```bash
+   gh issue edit <番号> \
+     --remove-label "soba:doing" \
+     --add-label "soba:review-requested"
+   ```
+
+---
+
+## PRテンプレート
+
+```markdown
+## 実装完了
+
+fixes #<番号>
+
+### 変更内容
+- [主要な変更点]
+
+### テスト結果
+- 単体テスト: ✅ パス
+- 全体テスト: ✅ パス
+
+### 確認事項
+- [ ] 実装計画に沿った実装
+- [ ] テストカバレッジ確保
+- [ ] 既存機能への影響なし
+```

data/lib/soba/templates/claude_commands/plan.md

@@ -0,0 +1,93 @@
+---
+allowed-tools: TodoWrite, TodoRead, Bash, Read, Grep, Glob
+description: "GitHub Issueの実装計画を策定"
+---
+
+## 概要
+
+GitHub Issueに対する実装計画を策定し、Issueコメントとして投稿します。
+
+---
+
+## 前提条件
+
+- ラベルは `soba:planning` の状態
+
+---
+
+## ルール
+
+1. **コード修正は行わず、計画策定に専念**
+2. **TDDを前提とした計画設計**
+3. **既存アーキテクチャに従う**
+4. **実行可能な単位にステップ分割**
+5. **テンプレート形式で計画作成**
+6. **完了後ラベルを `soba:ready` に更新**
+
+---
+
+## 実行手順
+
+1. **Issue確認**
+   - `gh issue view <番号>` で内容確認
+   - `gh issue view <番号> --comments` でコメント確認
+
+2. **コードベース調査**
+   - 関連ファイル・過去実装を確認
+   - 影響範囲と依存関係を特定
+
+3. **技術選定**
+   - 使用ライブラリ・パターンを決定
+   - 選定理由を明確化
+
+4. **実装ステップ定義**
+   - テスト可能な単位に分割
+   - 関連ファイル・副作用を記載
+
+5. **テスト・リスク・スケジュール策定**
+   - テスト計画（単体・統合）
+   - リスクと対策
+   - 実装期間の見積もり
+
+6. **計画ファイル作成**
+   - `./.tmp/plan-[slug].md` に保存
+
+7. **コメント投稿**
+   - `gh issue comment <番号> --body-file ./.tmp/plan-[slug].md`
+
+8. **ラベル更新**
+   - `gh issue edit <番号> --remove-label "soba:planning" --add-label "soba:ready"`
+
+---
+
+## テンプレート
+
+```markdown
+# 実装計画: [タイトル]
+
+## 要件概要
+- [目的と背景]
+- [機能要件]
+- [受け入れ条件]
+
+## 設計方針
+- [技術選定と理由]
+- [アーキテクチャ上の考慮点]
+
+## 実装ステップ
+1. [ステップ名]
+   - 作業内容: [詳細]
+   - 関連ファイル: [ファイルパス]
+
+## テスト計画
+- 単体テスト: [対象とケース]
+- 統合テスト: [シナリオ]
+
+## リスクと対策
+- リスク: [内容]
+  対策: [方法]
+
+## スケジュール
+- 見積もり: 合計[X]時間
+- ステップ別: 各[Y]時間
+```

data/lib/soba/templates/claude_commands/review.md

@@ -0,0 +1,91 @@
+---
+allowed-tools: Bash, Read, Write, Edit, MultiEdit, Grep, Glob, LS
+description: "Review a Pull Request for a soba Issue"
+---
+
+# Review PR
+
+PRレビューを実施します。
+
+## Context
+
+- Issue番号: $ARGUMENTS
+
+## Workflow
+
+### 1. Issue確認
+
+```bash
+GH_PAGER= gh issue view <issue-number>
+GH_PAGER= gh issue view <issue-number> --comments
+```
+
+### 2. PR確認
+
+```bash
+GH_PAGER= gh pr view <PR-number>
+GH_PAGER= gh pr view <PR-number> --json mergeable,mergeStateStatus
+```
+
+### 3. コード変更確認
+
+```bash
+GH_PAGER= gh pr diff <PR-number>
+```
+
+レビュー観点:
+- コーディング規約への準拠
+- テストの実装状況
+- セキュリティ上の懸念
+- 不要な差分の有無
+
+### 4. CI確認（必須・完了まで待機）
+
+```bash
+gh pr checks <PR-number> --watch  # Timeout 600000
+```
+
+⚠️ **重要**: CI完了前にレビュー結果を投稿しないこと
+
+### 5. レビュー結果投稿
+
+`./.tmp/review-result-<issue-number>.md`を作成:
+
+```markdown
+## レビュー結果
+
+- Issue: #<issue-number>
+- PR: #<PR-number>
+
+### ✅ 判定
+- [ ] 承認（LGTM）
+- [ ] 修正要求
+
+### 🔄 マージ状態
+- [ ] コンフリクトなし
+- [ ] コンフリクトあり（要リベース）
+
+### 👍 良い点
+- [実装の良い点]
+
+### 🛠 改善提案
+- [具体的な改善点]
+```
+
+投稿:
+```bash
+gh pr comment <PR-number> --body "$(cat ./.tmp/review-result-<issue-number>.md)"
+```
+
+### 6. ラベル更新
+
+承認の場合:
+```bash
+gh issue edit <issue-number> --remove-label "soba:reviewing" --add-label "soba:done"
+gh pr edit <PR-number> --add-label "soba:lgtm"
+```
+
+修正要求の場合:
+```bash
+gh issue edit <issue-number> --remove-label "soba:reviewing" --add-label "soba:requires-changes"
+```

data/lib/soba/templates/claude_commands/revise.md

@@ -0,0 +1,76 @@
+---
+allowed-tools: Bash, Read, Write, Edit, MultiEdit, Grep, Glob, LS
+description: "Revise implementation based on review feedback"
+---
+
+# Revise PR
+
+レビュー指摘事項に対応します。
+
+## Context
+
+- Issue番号: $ARGUMENTS
+
+## Workflow
+
+### 1. PR確認
+
+```bash
+GH_PAGER= gh pr list --search "linked:$ARGUMENTS" --state open --json number --jq '.[0].number'
+```
+
+### 2. レビューコメント確認
+
+```bash
+GH_PAGER= gh pr view <PR-number> --comments
+```
+
+### 3. 指摘事項への対応
+
+レビューコメントに基づいて修正を実施:
+- コード品質の改善
+- テストの追加・修正
+- エラーハンドリングの改善
+- 不要な差分の削除
+
+### 4. テスト実行
+
+```bash
+bundle exec rspec  # Timeout 600000
+```
+
+### 5. 修正内容のコミット
+
+```bash
+git add -A
+git commit -m "fix: レビュー指摘事項への対応
+
+- [修正内容の要約]
+"
+git push
+```
+
+### 6. 対応完了コメント
+
+`./.tmp/revise-complete-<issue-number>.md`を作成:
+
+```markdown
+## レビュー指摘対応完了
+
+以下の指摘事項に対応しました：
+- ✅ [対応項目]
+
+全てのテストがパスすることを確認済みです。
+再レビューをお願いいたします。
+```
+
+投稿:
+```bash
+gh pr comment <PR-number> --body "$(cat ./.tmp/revise-complete-<issue-number>.md)"
+```
+
+### 7. ラベル更新
+
+```bash
+gh issue edit <issue-number> --remove-label "soba:revising" --add-label "soba:review-requested"
+```

data/lib/soba/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Soba
+  VERSION = "0.1.0"
+end

data/lib/soba.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require "gli"
+require "dry-container"
+require "dry-auto_inject"
+require "faraday"
+require "octokit"
+require "concurrent"
+require "semantic_logger"
+
+require_relative "soba/version"
+
+module Soba
+  class Error < StandardError; end
+  class ConfigError < Error; end
+  class ConfigurationError < Error; end
+  class GitHubError < Error; end
+  class CommandError < Error; end
+
+  module Domain; end
+  module Services; end
+  module Infrastructure; end
+  module Commands
+    module Issue; end
+    module Config; end
+  end
+
+  SemanticLogger.default_level = :info
+  SemanticLogger.add_appender(io: $stdout, formatter: :color)
+
+  def self.logger
+    @logger ||= SemanticLogger["Soba"]
+  end
+end
+
+require_relative "soba/configuration"
+require_relative "soba/config_loader"
+require_relative "soba/container"
+require_relative "soba/domain/issue"
+require_relative "soba/services/issue_monitor"
+require_relative "soba/services/workflow_blocking_checker"
+require_relative "soba/services/queueing_service"
+require_relative "soba/infrastructure/errors"
+require_relative "soba/infrastructure/github_client"

data/lib/tasks/gem.rake

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require_relative "../soba/version"
+
+namespace :gem do
+  desc "Build the soba-cli gem"
+  task :build do
+    puts "Building soba-cli gem..."
+    system("gem build soba-cli.gemspec") || abort("Failed to build gem")
+    puts "Gem built successfully!"
+  end
+
+  desc "Install the soba-cli gem locally"
+  task install: "gem:build" do
+    gem_file = Dir.glob("soba-cli-*.gem").max_by { |f| File.mtime(f) }
+    abort("No gem file found") unless gem_file
+
+    puts "Installing #{gem_file}..."
+    system("gem install #{gem_file}") || abort("Failed to install gem")
+    puts "Gem installed successfully!"
+  end
+
+  desc "Uninstall the soba-cli gem"
+  task :uninstall do
+    puts "Uninstalling soba-cli gem..."
+    system("gem uninstall soba-cli -x") || puts("Gem may not be installed")
+    puts "Gem uninstalled successfully!"
+  end
+
+  desc "Clean up built gem files"
+  task :clean do
+    gem_files = Dir.glob("soba-cli-*.gem")
+    if gem_files.any?
+      puts "Removing gem files: #{gem_files.join(', ')}"
+      gem_files.each { |f| File.delete(f) }
+      puts "Cleaned up gem files"
+    else
+      puts "No gem files to clean"
+    end
+  end
+
+  desc "Build, tag, and push gem to RubyGems.org (manual release)"
+  task release: "gem:build" do
+    puts "🚨 NOTICE: This is a manual release task."
+    puts "📋 For automated releases, create a GitHub Release with a tag like 'v1.2.3'"
+    puts "🤖 GitHub Actions will automatically build and publish the gem."
+    puts ""
+
+    gem_file = Dir.glob("soba-cli-*.gem").max_by { |f| File.mtime(f) }
+    abort("No gem file found") unless gem_file
+
+    puts "WARNING: This will push #{gem_file} to RubyGems.org!"
+    print "Are you sure you want to proceed with manual release? (y/N): "
+    input = $stdin.gets.chomp
+
+    if input.downcase == "y"
+      system("gem push #{gem_file}") || abort("Failed to push gem")
+      puts "Gem released successfully!"
+
+      # Tag the release in git
+      version = Soba::VERSION
+      system("git tag v#{version}") || abort("Failed to create git tag")
+      system("git push origin v#{version}") || abort("Failed to push git tag")
+      puts "Git tag v#{version} created and pushed"
+    else
+      puts "Release cancelled"
+    end
+  end
+end
+
+desc "Alias for gem:build"
+task build: "gem:build"
+
+desc "Alias for gem:install"
+task install: "gem:install"

data/soba-cli.gemspec

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require_relative "lib/soba/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "soba-cli"
+  spec.version = Soba::VERSION
+  spec.authors = ["douhashi"]
+  spec.email = ["douhashi@gmail.com"]
+
+  spec.summary = "Autonomous GitHub Issue-driven development CLI with Claude Code"
+  spec.description = "Soba is an autonomous CLI tool that fully automates GitHub Issue-driven development workflows. " \
+                     "It monitors issues, creates implementation plans, generates code, and manages pull requests " \
+                     "through seamless integration with Claude Code AI, enabling hands-free development cycles."
+  spec.homepage = "https://github.com/douhashi/soba-cli"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.0.0"
+
+  spec.metadata["allowed_push_host"] = "https://rubygems.org"
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = "#{spec.homepage}/blob/main/CHANGELOG.md"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w(test/ spec/ features/ .git .github appveyor Gemfile scripts/ .tmp/))
+    end
+  end
+  spec.bindir = "bin"
+  spec.executables = ["soba"]
+  spec.require_paths = ["lib"]
+
+  # Runtime dependencies
+  spec.add_runtime_dependency "gli", "~> 2.21"
+  spec.add_runtime_dependency "dry-container", "~> 0.11"
+  spec.add_runtime_dependency "dry-auto_inject", "~> 1.0"
+  spec.add_runtime_dependency "faraday", "~> 2.9"
+  spec.add_runtime_dependency "faraday-retry", "~> 2.2"
+  spec.add_runtime_dependency "octokit", "~> 10.0"
+  spec.add_runtime_dependency "concurrent-ruby", "~> 1.2"
+  spec.add_runtime_dependency "semantic_logger", "~> 4.15"
+  spec.add_runtime_dependency "dry-configurable", "~> 1.1"
+  spec.add_runtime_dependency "activesupport", "~> 8.0"
+
+  # Development dependencies
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rspec", "~> 3.12"
+  spec.add_development_dependency "webmock", "~> 3.19"
+  spec.add_development_dependency "vcr", "~> 6.2"
+  spec.add_development_dependency "factory_bot", "~> 6.4"
+  spec.add_development_dependency "rubocop-airbnb", "~> 6.0"
+  spec.add_development_dependency "simplecov", "~> 0.22"
+  spec.add_development_dependency "bundler-audit", "~> 0.9"
+  spec.add_development_dependency "pry", "~> 0.14"
+  spec.add_development_dependency "pry-byebug", "~> 3.10"
+end