commitcraft 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7e514536174168988c5ab69979cd03087275c27a070a08b75c764d04f9ee2d63
+  data.tar.gz: 0aee9c93f8a43c25f1fe46ba83daf73f70776f1a6db7258966a0052559d5e56c
+SHA512:
+  metadata.gz: 0c663dcd43da6f431955d6825393449dc7c6312002cf199c16f41c4a13eb02ff2ef0d14b901a07e9b3ddd4a0f617db6469c06203d21b819e4e3191691469731f
+  data.tar.gz: e7eec0574248aebdeee7da1f1a9945ae55e393dce0c6e36b603299aee45c1a089e4e93838cb75f688139242c6ff5af2bb5ce93b4633bbb8ab165c63a71de563b

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CommitCraft
+
+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,232 @@
+# CommitCraft
+
+**AI-powered git commit message generator using FREE Google Gemini API**
+
+CommitCraft uses Google's Gemini AI to analyze your code changes and automatically generate meaningful, conventional commit messages. Completely FREE - no credit card required.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+- 100% FREE - Uses Google's free Gemini API
+- AI-Powered - Uses latest Gemini models to understand your code
+- Multiple Suggestions - Get 3 different commit message options
+- Multiple Styles - Conventional, Semantic, Descriptive, or Custom
+- Jira Integration - Automatic ticket key prepending
+- Interactive CLI - Beautiful terminal interface
+- Context-Aware - Considers branch names, files, and history
+- Fast & Easy - One command to generate and commit
+
+## Installation
+
+```bash
+gem install commitcraft
+```
+
+Or add to your Gemfile:
+
+```ruby
+gem 'commitcraft'
+```
+
+## Setup
+
+### Get Your FREE API Key
+
+1. Go to https://aistudio.google.com/app/apikey
+2. Click "Create API Key"
+3. Copy your key
+
+### Set Your API Key
+
+```bash
+export GEMINI_API_KEY='your-key-here'
+
+# Make it permanent:
+echo 'export GEMINI_API_KEY="your-key"' >> ~/.bashrc
+source ~/.bashrc
+```
+
+### Use It
+
+```bash
+cd your-project
+git add .
+commitcraft generate
+```
+
+## Usage
+
+### Basic Usage
+
+```bash
+git add .
+commitcraft generate
+```
+
+CommitCraft will:
+- Analyze your staged changes
+- Generate 3 commit message suggestions
+- Let you choose one (or write your own)
+- Commit with your selected message
+
+### Command Options
+
+```bash
+commitcraft generate --auto-commit              # Auto-commit with first suggestion
+commitcraft generate --style semantic           # Use specific commit style
+commitcraft generate --all                      # Include all changes
+commitcraft generate --amend                    # Amend previous commit
+commitcraft generate --include-history          # Include commit history as context
+commitcraft generate --jira CF-123              # Add Jira ticket key
+```
+
+### Jira Integration
+
+Automatically prepend Jira ticket keys to your commit messages:
+
+```bash
+# One-time Jira key
+commitcraft generate --jira CF-123
+
+# Short form
+commitcraft generate -j CF-123
+
+# Combined with other options
+commitcraft generate -j CF-123 -s semantic -y
+```
+
+**Output:**
+```
+Choose a commit message:
+  [CF-123] feat(auth): add OAuth2 authentication
+  [CF-123] feat: implement user login system
+  [CF-123] Add authentication with OAuth2
+```
+
+**Set default Jira prefix:**
+```bash
+# Set once for all commits
+commitcraft config --jira-prefix CF-123
+
+# Now every commit includes CF-123 automatically
+commitcraft generate
+```
+
+**Supported formats:**
+- `PROJECT-123`
+- `ABC-456`
+- `JIRA-789`
+
+### Commit Styles
+
+**Conventional (default)**
+```
+feat(auth): add OAuth2 login flow
+fix(api): resolve null pointer error
+docs(readme): update installation steps
+```
+
+**Semantic**
+```
+Add user authentication middleware
+Fix memory leak in background worker
+Update dependencies to latest versions
+```
+
+**Descriptive**
+```
+Implement caching to improve response time by 40%
+Refactor database queries to eliminate N+1 problems
+Add comprehensive error handling for edge cases
+```
+
+## Configuration
+
+```bash
+commitcraft config --show                       # Show current config
+commitcraft config --style conventional         # Set default style
+commitcraft config --model gemini-2.5-flash     # Set AI model
+commitcraft config --jira-prefix CF-123         # Set default Jira prefix
+commitcraft status                              # View git status
+commitcraft version                             # Check version
+```
+
+### Available Models (All FREE)
+
+- `gemini-2.5-flash` (default) - Best balance
+- `gemini-2.5-pro` - Highest quality
+- `gemini-2.5-flash-lite` - Fastest
+- `gemini-2.0-flash` - Fast and versatile
+- `gemini-flash-latest` - Auto-updates to latest
+
+### Git Alias
+
+Add to `~/.gitconfig`:
+
+```ini
+[alias]
+    ai = !commitcraft generate
+    aic = !commitcraft generate --auto-commit
+```
+
+Then use:
+```bash
+git ai              # Interactive mode
+git aic             # Auto-commit
+```
+
+### Set Default for Long-Running Work
+```bash
+# Working on CF-123 all week
+commitcraft config --jira-prefix CF-123
+
+# All commits include CF-123
+git add file1.rb && commitcraft generate -y
+git add file2.rb && commitcraft generate -y
+git add file3.rb && commitcraft generate -y
+```
+
+### Git History with Jira
+```bash
+$ git log --oneline
+
+a1b2c3d [CF-123] feat(auth): add OAuth2 authentication
+d4e5f6g [CF-123] test(auth): add integration tests
+h7i8j9k [CF-456] fix(api): resolve validation error
+l0m1n2o [CF-456] docs(api): update API documentation
+```
+
+**Filter by ticket:**
+```bash
+git log --grep="CF-123" --oneline
+```
+
+## Rate Limits (Free Tier)
+
+- 15 requests/minute
+- 1 million tokens/minute
+- 1,500 requests/day
+
+## Contributing
+
+Bug reports and pull requests are welcome.
+
+1. Fork the repository
+2. Create your feature branch
+3. Commit your changes
+4. Push to the branch
+5. Create a Pull Request
+
+## License
+
+MIT License - see LICENSE.txt
+
+## Tips
+
+1. **Stage related changes together** for better commit messages
+2. **Use --include-history** for context-aware suggestions
+3. **Try different styles** to match your team's conventions
+4. **Set default Jira prefix** for long-running feature work
+5. **Use --auto-commit** for quick, simple changes
+6. **Create git aliases** for faster workflow

data/exe/commitcraft

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/commitcraft"
+
+begin
+  CommitCraft::CLI.start(ARGV)
+rescue Interrupt
+  puts "\nInterrupted. Exiting..."
+  exit 130
+end

data/lib/commitcraft/ai_client.rb

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+require "gemini-ai"
+
+module CommitCraft
+  class AIClient
+    def initialize(config = CommitCraft.configuration)
+      @config = config
+      @config.validate!
+      @client = Gemini.new(
+        credentials: {
+          service: "generative-language-api",
+          api_key: @config.api_key
+        },
+        options: {
+          model: @config.model,
+          server_sent_events: true
+        }
+      )
+    end
+
+    def generate_commit_messages(diff, context = {})
+      prompt = build_prompt(diff, context)
+
+      result = @client.stream_generate_content({
+                                                 contents: { role: "user", parts: { text: prompt } }
+                                               })
+
+      # Collect the full response
+      full_response = ""
+      result.each do |event|
+        next unless event.dig("candidates", 0, "content", "parts")
+
+        event.dig("candidates", 0, "content", "parts").each do |part|
+          full_response += part["text"] if part["text"]
+        end
+      end
+
+      parse_response(full_response)
+    rescue StandardError => e
+      raise AIError, "Failed to generate commit message: #{e.message}"
+    end
+
+    private
+
+    def build_prompt(diff, context)
+      style_instruction = style_instructions[@config.commit_style]
+
+      prompt = <<~PROMPT
+        You are an expert at writing clear, concise git commit messages.
+
+        #{style_instruction}
+
+        Please generate 3 different commit message options for the following changes.
+        Each message should be on its own line, numbered 1-3.
+
+        #{context_section(context)}
+
+        Git diff:
+        ```
+        #{diff}
+        ```
+
+        Generate exactly 3 commit messages, one per line, numbered 1-3.
+      PROMPT
+
+      prompt.strip
+    end
+
+    def context_section(context)
+      return "" if context.empty?
+
+      sections = []
+      sections << "Current branch: #{context[:branch]}" if context[:branch]
+      sections << "Files changed: #{context[:files].join(", ")}" if context[:files]&.any?
+      sections << "Recent commits:\n#{context[:recent_commits].join("\n")}" if context[:recent_commits]&.any?
+
+      return "" if sections.empty?
+
+      "Context:\n#{sections.join("\n")}\n"
+    end
+
+    def style_instructions
+      {
+        "conventional" => <<~STYLE,
+          Follow the Conventional Commits specification:
+          - Format: <type>(<scope>): <description>
+          - Types: feat, fix, docs, style, refactor, test, chore, perf, ci, build
+          - Keep the description concise and in present tense
+          - Example: "feat(auth): add OAuth2 login flow"
+        STYLE
+        "semantic" => <<~STYLE,
+          Follow semantic commit format:
+          - Start with a verb in present tense (Add, Update, Fix, Remove, etc.)
+          - Be specific about what changed
+          - Example: "Add user authentication middleware"
+        STYLE
+        "descriptive" => <<~STYLE,
+          Write descriptive commit messages:
+          - Focus on the "what" and "why"
+          - Use complete sentences
+          - Example: "Implement caching to improve API response time by 40%"
+        STYLE
+        "custom" => <<~STYLE
+          Write clear, professional commit messages that accurately describe the changes.
+        STYLE
+      }
+    end
+
+    def parse_response(response)
+      return [] if response.nil? || response.empty?
+
+      messages = response.split("\n")
+                         .map(&:strip)
+                         .grep(/^\d+[.)]\s+/)
+                         .map { |line| line.sub(/^\d+[.)]\s+/, "") }
+                         .reject(&:empty?)
+
+      raise AIError, "Failed to parse commit messages from AI response" if messages.empty?
+
+      messages
+    end
+  end
+end

data/lib/commitcraft/cli.rb

@@ -0,0 +1,220 @@
+# frozen_string_literal: true
+
+require "thor"
+require "tty-prompt"
+require "tty-spinner"
+require "pastel"
+
+module CommitCraft
+  class CLI < Thor
+    def self.exit_on_failure?
+      true
+    end
+
+    desc "generate", "Generate AI-powered commit messages"
+    method_option :all, type: :boolean, aliases: "-a", desc: "Include all changes (staged and unstaged)"
+    method_option :unstaged, type: :boolean, aliases: "-u", desc: "Use unstaged changes only"
+    method_option :amend, type: :boolean, desc: "Amend the previous commit"
+    method_option :no_context, type: :boolean, desc: "Don't include git context (branch, files)"
+    method_option :include_history, type: :boolean, aliases: "-h", desc: "Include recent commit history as context"
+    method_option :auto_commit, type: :boolean, aliases: "-y", desc: "Automatically commit with the first suggestion"
+    method_option :style, type: :string, aliases: "-s",
+                          desc: "Commit message style (conventional, semantic, descriptive, custom)"
+    method_option :jira, type: :string, aliases: '-j', desc: 'Jira ticket key (e.g., CF-123)'
+    def generate
+      setup_style(options[:style]) if options[:style]
+
+      generator = MessageGenerator.new
+      prompt = TTY::Prompt.new
+      pastel = Pastel.new
+
+        if options[:jira]
+          validate_jira_key!(options[:jira])
+        end
+
+      # Show test mode indicator
+      if CommitCraft.test_mode?
+        puts pastel.yellow("⚠️  TEST MODE - Using mock AI (no API calls)")
+        puts ""
+      end
+
+      # Show spinner while generating
+      spinner = TTY::Spinner.new("[:spinner] Analyzing changes and generating commit messages...", format: :dots)
+      spinner.auto_spin
+
+      begin
+        result = generator.generate(
+          all: options[:all],
+          unstaged: options[:unstaged],
+          no_context: options[:no_context],
+          include_history: options[:include_history],
+          jira: options[:jira]
+        )
+      rescue CommitCraft::Error => e
+        spinner.error("(#{pastel.red("failed")})")
+        puts pastel.red("Error: #{e.message}")
+        exit 1
+      end
+
+      spinner.success("(#{pastel.green("done")})")
+      puts
+
+      # Show diff summary
+      summary = result[:diff_summary]
+      puts pastel.dim("Files changed: #{summary[:files_changed]}, ") +
+           pastel.green("+#{summary[:additions]}") + pastel.dim(" / ") +
+           pastel.red("-#{summary[:deletions]}")
+      puts
+
+      # Show generated messages
+      messages = result[:messages]
+
+      if options[:auto_commit]
+        selected_message = messages.first
+        puts pastel.cyan("Auto-committing with: ") + pastel.white(selected_message)
+      else
+        choices = messages.map.with_index do |msg, _idx|
+          { name: msg, value: msg }
+        end
+        choices << { name: pastel.dim("✎ Write custom message"), value: :custom }
+        choices << { name: pastel.dim("✗ Cancel"), value: :cancel }
+
+        selected_message = prompt.select("Choose a commit message:", choices, per_page: 10)
+
+        case selected_message
+        when :custom
+          selected_message = prompt.ask("Enter your commit message:") do |q|
+            q.required true
+            q.validate(/\S+/)
+          end
+        when :cancel
+          puts pastel.yellow("Commit cancelled.")
+          exit 0
+        end
+      end
+
+      puts
+
+      # Confirm and commit
+      begin
+        generator.commit_with_message(selected_message, amend: options[:amend])
+        action = options[:amend] ? "amended" : "created"
+        puts pastel.green("✓ Commit #{action} successfully!")
+        puts pastel.dim("  Message: #{selected_message}")
+      rescue CommitCraft::GitError => e
+        puts pastel.red("Failed to commit: #{e.message}")
+        exit 1
+      end
+    end
+
+    desc "config", "Configure CommitCraft"
+    method_option :api_key, type: :string, desc: "Set Anthropic API key"
+    method_option :model, type: :string, desc: "Set AI model"
+    method_option :style, type: :string, desc: "Set default commit message style"
+    method_option :show, type: :boolean, desc: "Show current configuration"
+    method_option :jira_prefix, type: :string, desc: 'Set default Jira prefix'
+
+    def config
+      config_file = File.join(Dir.home, ".commitcraft.yml")
+
+      if options[:show]
+        show_config(config_file)  
+      elsif options[:jira_prefix]
+        validate_jira_key!(options[:jira_prefix])
+        set_config_value('jira_prefix', options[:jira_prefix])
+        say pastel.green("✓ Default Jira prefix set to: #{options[:jira_prefix]}")
+      end
+
+      require "yaml"
+
+      current_config = File.exist?(config_file) ? YAML.load_file(config_file) : {}
+
+      current_config["api_key"] = options[:api_key] if options[:api_key]
+      current_config["model"] = options[:model] if options[:model]
+      current_config["style"] = options[:style] if options[:style]
+
+      File.write(config_file, current_config.to_yaml)
+
+      pastel = Pastel.new
+      puts pastel.green("✓ Configuration saved to #{config_file}")
+    end
+
+    desc "status", "Show git status and staged changes"
+    def status
+      git_client = GitClient.new
+      pastel = Pastel.new
+
+      begin
+        puts pastel.bold("Git Status:")
+        puts git_client.status
+        puts
+
+        staged_files = git_client.staged_files
+        if staged_files.any?
+          puts pastel.bold("Staged Files:")
+          staged_files.each { |file| puts pastel.green("  + #{file}") }
+          puts
+
+          stats = git_client.file_stats
+          total_add = stats.sum { |s| s[:additions] }
+          total_del = stats.sum { |s| s[:deletions] }
+          puts pastel.dim("Total changes: ") +
+               pastel.green("+#{total_add}") + pastel.dim(" / ") +
+               pastel.red("-#{total_del}")
+        else
+          puts pastel.yellow("No staged changes.")
+        end
+      rescue CommitCraft::GitError => e
+        puts pastel.red("Error: #{e.message}")
+        exit 1
+      end
+    end
+
+    desc "version", "Show CommitCraft version"
+    def version
+      puts "CommitCraft v#{CommitCraft::VERSION}"
+    end
+
+    private
+
+    def validate_jira_key!(key)      
+      pastel = Pastel.new
+      unless key.match?(/^[A-Z]+-\d+$/)
+        say pastel.red("✗ Invalid Jira key format: #{key}")
+        say pastel.dim("Expected format: PROJECT-123 (e.g., CF-123, JIRA-456)")
+        exit 1
+      end
+    end
+
+    def setup_style(style)
+      CommitCraft.configure do |config|
+        config.commit_style = style
+      end
+    end
+
+    def show_config(config_file)
+      pastel = Pastel.new
+
+      if File.exist?(config_file)
+        require "yaml"
+        config = YAML.load_file(config_file)
+
+        puts pastel.bold("Current Configuration:")
+        puts pastel.dim("Location: #{config_file}")
+        puts
+        config.each do |key, value|
+          display_value = key == "api_key" ? "#{value[0..8]}..." : value
+          puts "  #{pastel.cyan(key)}: #{display_value}"
+        end
+      else
+        puts pastel.yellow("No configuration file found.")
+        puts pastel.dim("Using environment variable: GEMINI_API_KEY")
+      end
+
+      puts
+      puts pastel.bold("Environment:")
+      api_key = ENV.fetch("GEMINI_API_KEY", nil)
+      puts "  GEMINI_API_KEY: #{api_key ? pastel.green("Set") : pastel.red("Not set")}"
+    end
+  end
+end

data/lib/commitcraft/configuration.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module CommitCraft
+  class Configuration
+    attr_accessor :api_key, :model, :max_tokens, :temperature, :commit_style, :test_mode, :jira_prefix
+
+    SUPPORTED_MODELS = %w[
+      gemini-2.5-flash
+      gemini-2.5-pro
+      gemini-2.0-flash
+      gemini-flash-latest
+      gemini-pro-latest
+      gemini-2.5-flash-lite
+    ].freeze
+
+    COMMIT_STYLES = %w[
+      conventional
+      semantic
+      descriptive
+      custom
+    ].freeze
+
+    def initialize
+      load_config_file
+      @api_key ||= ENV.fetch("GEMINI_API_KEY", nil)
+      @model ||= "gemini-2.5-flash"
+      @max_tokens ||= 1000
+      @temperature ||= 0.7
+      @commit_style ||= "conventional"
+      @jira_prefix ||= nil
+      @test_mode = ENV["COMMITCRAFT_TEST_MODE"] == "true"
+    end
+
+    def validate!
+      return if @test_mode
+      raise ConfigurationError, "API key is required" if api_key.nil? || api_key.empty?
+      raise ConfigurationError, "Invalid model: #{model}" unless SUPPORTED_MODELS.include?(model)
+      raise ConfigurationError, "Invalid commit style: #{commit_style}" unless COMMIT_STYLES.include?(commit_style)
+      validate_jira_prefix! if jira_prefix
+    end
+
+    private
+
+    def load_config_file
+      config_file = File.join(Dir.home, ".commitcraft.yml")
+      return unless File.exist?(config_file)
+
+      require "yaml"
+      config = YAML.load_file(config_file)
+      @api_key = config["api_key"]
+      @model = config["model"]
+      @max_tokens = config["max_tokens"]
+      @temperature = config["temperature"]
+      @commit_style = config["style"]
+      @jira_prefix = config["jira_prefix"]
+    rescue StandardError
+      nil
+    end
+    
+    def validate_jira_prefix!
+      unless jira_prefix.match?(/^[A-Z]+-\d+$/)
+        raise ConfigurationError, "Invalid Jira key format: #{jira_prefix}. Expected format: PROJECT-123"
+      end
+    end
+  end
+end

data/lib/commitcraft/errors.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module CommitCraft
+  class Error < StandardError; end
+  class ConfigurationError < Error; end
+  class GitError < Error; end
+  class AIError < Error; end
+  class NoChangesError < GitError; end
+end

data/lib/commitcraft/git_client.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+require "English"
+module CommitCraft
+  class GitClient
+    def initialize(repo_path: Dir.pwd)
+      @repo_path = repo_path
+      validate_git_repo!
+    end
+
+    def staged_diff
+      diff = execute_command("git diff --cached")
+      raise NoChangesError, "No staged changes found. Use 'git add' to stage your changes." if diff.empty?
+
+      diff
+    end
+
+    def unstaged_diff
+      execute_command("git diff")
+    end
+
+    def all_diff
+      execute_command("git diff HEAD")
+    end
+
+    def status
+      execute_command("git status --short")
+    end
+
+    def current_branch
+      execute_command("git branch --show-current").strip
+    end
+
+    def recent_commits(count = 5)
+      execute_command("git log -#{count} --oneline").split("\n")
+    end
+
+    def commit(message, amend: false)
+      escaped_message = message.gsub("'", "'\\''")
+      cmd = amend ? "git commit --amend -m '#{escaped_message}'" : "git commit -m '#{escaped_message}'"
+      execute_command(cmd)
+    end
+
+    def staged_files
+      execute_command("git diff --cached --name-only").split("\n")
+    end
+
+    def file_stats
+      stats = execute_command("git diff --cached --numstat")
+      parse_file_stats(stats)
+    end
+
+    private
+
+    def validate_git_repo!
+      Dir.chdir(@repo_path) do
+        `git rev-parse --git-dir 2>&1`
+        raise GitError, "Not a git repository: #{@repo_path}" unless $CHILD_STATUS.success?
+      end
+    end
+
+    def execute_command(command)
+      Dir.chdir(@repo_path) do
+        result = `#{command} 2>&1`
+        raise GitError, "Git command failed: #{result}" unless $CHILD_STATUS.success?
+
+        result
+      end
+    end
+
+    def parse_file_stats(stats)
+      return [] if stats.empty?
+
+      stats.split("\n").map do |line|
+        added, deleted, file = line.split("\t")
+        {
+          file: file,
+          additions: added.to_i,
+          deletions: deleted.to_i
+        }
+      end
+    end
+  end
+end

data/lib/commitcraft/message_generator.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module CommitCraft
+  class MessageGenerator
+    def initialize(git_client: nil, ai_client: nil)
+      @git_client = git_client || GitClient.new
+      @config = CommitCraft.configuration
+
+      @ai_client = if ai_client
+                     ai_client
+                   elsif CommitCraft.test_mode?
+                     MockAIClient.new
+                   else
+                     AIClient.new
+                   end
+    end
+
+    def generate(options = {})      
+      diff = get_diff(options)
+      context = build_context(options)
+      
+      jira_key = options[:jira] || @config.jira_prefix
+      
+      messages = @ai_client.generate_commit_messages(diff, context)
+      
+      if jira_key
+        messages = messages.map { |msg| format_with_jira(msg, jira_key) }
+      end
+      
+      {
+        messages: messages,
+        context: context,
+        diff_summary: summarize_diff
+      }
+    end
+
+    def commit_with_message(message, amend: false)
+      @git_client.commit(message, amend: amend)
+    end
+
+    private
+
+    def format_with_jira(message, jira_key)
+      return message if message.match?(/^\[[A-Z]+-\d+\]/)
+      
+      "[#{jira_key}] #{message}"
+    end
+
+    def get_diff(options)
+      if options[:all]
+        @git_client.all_diff
+      elsif options[:unstaged]
+        @git_client.unstaged_diff
+      else
+        @git_client.staged_diff
+      end
+    end
+
+    def build_context(options)
+      context = {}
+
+      unless options[:no_context]
+        context[:branch] = @git_client.current_branch
+        context[:files] = @git_client.staged_files
+        context[:recent_commits] = @git_client.recent_commits(3) if options[:include_history]
+      end
+
+      context
+    end
+
+    def summarize_diff
+      stats = @git_client.file_stats
+
+      total_additions = stats.sum { |s| s[:additions] }
+      total_deletions = stats.sum { |s| s[:deletions] }
+
+      {
+        files_changed: stats.length,
+        additions: total_additions,
+        deletions: total_deletions,
+        file_stats: stats
+      }
+    end
+  end
+end

data/lib/commitcraft/mock_ai_client.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+module CommitCraft
+  class MockAIClient
+    def initialize(config = CommitCraft.configuration)
+      @config = config
+    end
+
+    def generate_commit_messages(diff, context = {})
+      # Analyze the diff to generate relevant messages
+      files_changed = context[:files] || []
+
+      # Generate messages based on commit style
+      case @config.commit_style
+      when "conventional"
+        generate_conventional_messages(diff, files_changed)
+      when "semantic"
+        generate_semantic_messages(diff, files_changed)
+      when "descriptive"
+        generate_descriptive_messages(diff, files_changed)
+      else
+        generate_default_messages(diff, files_changed)
+      end
+    end
+
+    private
+
+    def generate_conventional_messages(diff, files)
+      type = detect_type(diff, files)
+      scope = detect_scope(files)
+
+      [
+        "#{type}(#{scope}): implement changes to #{files.first || "codebase"}",
+        "#{type}: update #{files.length} file#{"s" if files.length != 1}",
+        "#{type}(#{scope}): add new functionality"
+      ]
+    end
+
+    def generate_semantic_messages(diff, files)
+      [
+        "Add #{extract_feature(diff, files)}",
+        "Update #{files.first || "code"} with improvements",
+        "Implement #{extract_feature(diff, files)}"
+      ]
+    end
+
+    def generate_descriptive_messages(diff, files)
+      [
+        "Implement new features across #{files.length} file#{"s" if files.length != 1}",
+        "Refactor code to improve maintainability and readability",
+        "Add functionality for #{extract_feature(diff, files)}"
+      ]
+    end
+
+    def generate_default_messages(_diff, files)
+      [
+        "Update #{files.first || "code"}",
+        "Implement changes",
+        "Add new functionality"
+      ]
+    end
+
+    def detect_type(diff, files)
+      # Simple heuristic based on files
+      return "feat" if diff.include?("class") || diff.include?("def")
+      return "fix" if diff.include?("bug") || diff.include?("fix")
+      return "docs" if files.any? { |f| f.end_with?(".md", ".txt") }
+      return "test" if files.any? { |f| f.include?("spec") || f.include?("test") }
+      return "refactor" if diff.include?("refactor")
+
+      "feat"
+    end
+
+    def detect_scope(files)
+      return "core" if files.empty?
+
+      # Get first file's directory or name
+      first_file = files.first.to_s
+      if first_file.include?("/")
+        parts = first_file.split("/")
+        parts.length > 1 ? parts[0] : "core"
+      else
+        first_file.split(".").first
+      end
+    end
+
+    def extract_feature(diff, files)
+      # Try to extract a feature name from class/method names
+      if diff =~ /class\s+(\w+)/
+        ::Regexp.last_match(1).downcase
+      elsif diff =~ /def\s+(\w+)/
+        ::Regexp.last_match(1).gsub("_", " ")
+      elsif files.any?
+        files.first.to_s.split("/").last.split(".").first
+      else
+        "new feature"
+      end
+    end
+  end
+end

data/lib/commitcraft/version.rb

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

data/lib/commitcraft.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require_relative "commitcraft/version"
+require_relative "commitcraft/configuration"
+require_relative "commitcraft/git_client"
+require_relative "commitcraft/ai_client"
+require_relative "commitcraft/mock_ai_client"
+require_relative "commitcraft/message_generator"
+require_relative "commitcraft/cli"
+require_relative "commitcraft/errors"
+
+module CommitCraft
+  class << self
+    attr_writer :configuration
+
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield(configuration)
+    end
+
+    def reset_configuration!
+      @configuration = Configuration.new
+    end
+
+    def test_mode?
+      ENV["COMMITCRAFT_TEST_MODE"] == "true" || configuration.test_mode
+    end
+  end
+end

metadata

@@ -0,0 +1,187 @@
+--- !ruby/object:Gem::Specification
+name: commitcraft
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Khaled Elabady
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2026-02-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: gemini-ai
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+- !ruby/object:Gem::Dependency
+  name: pastel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: tty-prompt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.23'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.23'
+- !ruby/object:Gem::Dependency
+  name: tty-spinner
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+description: CommitCraft uses AI to analyze your code changes and generate meaningful,
+  conventional commit messages automatically.
+email:
+- khaledelabadyy@gmail.com
+executables:
+- commitcraft
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- exe/commitcraft
+- lib/commitcraft.rb
+- lib/commitcraft/ai_client.rb
+- lib/commitcraft/cli.rb
+- lib/commitcraft/configuration.rb
+- lib/commitcraft/errors.rb
+- lib/commitcraft/git_client.rb
+- lib/commitcraft/message_generator.rb
+- lib/commitcraft/mock_ai_client.rb
+- lib/commitcraft/version.rb
+homepage: https://github.com/Khaledelabady11/commitcraft
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/Khaledelabady11/commitcraft
+  source_code_uri: https://github.com/Khaledelabady11/commitcraft
+  changelog_uri: https://github.com/Khaledelabady11/commitcraft/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key: 
+specification_version: 4
+summary: AI-powered git commit message generator
+test_files: []