code_sage 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 54bbfe11204be27b426808d1ee98e5ea40aed7c8a25d525c613044f75f35e9c6
+  data.tar.gz: 453c726fd2f5dc7f2a6c7a975ead2f36420a7d40f3d96c3eb9a7099ad7b710cd
+SHA512:
+  metadata.gz: 49e79a62468d7dda3d7d027259802d2fa00d3049a096e885430e634b70384185cda168be105afc0c3842c9908751d4f18bdb761e4dfd15aa022791ada6f02430
+  data.tar.gz: 45280224e33c0dbf2c8c721a0def678388148b2bc294f714c2956d5234e2c7cc52a909f4f7340dc6b29595d6c96570259441e2bc5add7c240fe925040f86749d

data/.github/workflows/gem.yml

@@ -0,0 +1,47 @@
+name: Ruby Gem
+
+on:
+  push:
+    branches: [ "master" ]
+  pull_request:
+    branches: [ "master" ]
+
+jobs:
+  build:
+    name: Build + Publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: 3.2.2
+        bundler-cache: true
+
+    - name: Install dependencies
+      run: bundle install
+
+    - name: Build gem
+      run: gem build *.gemspec
+
+    - name: Publish to GPR (GitHub Package Registry)
+      run: |
+        mkdir -p $HOME/.gem
+        touch $HOME/.gem/credentials
+        chmod 0600 $HOME/.gem/credentials
+        printf -- "---\n:github: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
+        gem push --KEY github --host https://rubygems.pkg.github.com/${OWNER} *.gem
+      env:
+        GEM_HOST_API_KEY: "Bearer ${{secrets.GITHUB_TOKEN}}"
+        OWNER: ${{ github.repository_owner }}
+
+    - name: Publish to RubyGems
+      if: success()
+      run: gem push *.gem
+      env:
+        GEM_HOST_API_KEY: "${{secrets.RUBYGEMS_AUTH_TOKEN}}" 

data/.gitignore

@@ -0,0 +1,54 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Gem builds
+*.gem
+
+# Config files with sensitive data
+config/credentials.yml.enc
+config/master.key
+
+# Logs
+*.log
+
+# Runtime data
+*.pid
+*.seed
+*.pid.lock
+
+# Coverage directory used by tools like istanbul
+coverage/
+
+# nyc test coverage
+.nyc_output
+
+# node_modules
+node_modules/
+
+# Local configuration
+.env
+.env.local 

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper 

data/CHANGELOG.md

@@ -0,0 +1,24 @@
+# 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.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- Initial gem structure
+- CLI interface with Thor
+- Git integration using Rugged
+- LLM-powered code review using llm_chain
+- Multiple output formats (console, JSON, markdown)
+- Ruby code analysis and review
+- Comprehensive reporting system
+
+## [0.1.0] - 2025-01-XX
+
+### Added
+- Initial release of CodeSage
+- Basic code review functionality
+- CLI interface for easy usage 

data/Gemfile

@@ -0,0 +1,11 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in code_sage.gemspec
+gemspec
+
+group :development, :test do
+  gem 'rspec', '~> 3.0'
+  gem 'pry'
+  gem 'rubocop', require: false
+  gem 'yard', require: false
+end 

data/Gemfile.lock

@@ -0,0 +1,150 @@
+PATH
+  remote: .
+  specs:
+    code_sage (0.1.0)
+      colorize (~> 0.8)
+      llm_chain (~> 0.5.2)
+      rugged (~> 1.0)
+      thor (~> 1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (8.0.2)
+      base64
+      benchmark (>= 0.3)
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.3.1)
+      connection_pool (>= 2.2.5)
+      drb
+      i18n (>= 1.6, < 2)
+      logger (>= 1.4.2)
+      minitest (>= 5.1)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
+    ast (2.4.3)
+    base64 (0.3.0)
+    benchmark (0.4.1)
+    bigdecimal (3.2.2)
+    coderay (1.1.3)
+    colorize (0.8.1)
+    concurrent-ruby (1.3.5)
+    connection_pool (2.5.3)
+    csv (3.3.5)
+    diff-lcs (1.6.2)
+    drb (2.2.3)
+    faraday (2.13.1)
+      faraday-net_http (>= 2.0, < 3.5)
+      json
+      logger
+    faraday-net_http (3.4.1)
+      net-http (>= 0.5.0)
+    fiber-storage (1.0.1)
+    graphlient (0.8.0)
+      faraday (~> 2.0)
+      graphql-client
+    graphql (2.5.9)
+      base64
+      fiber-storage
+      logger
+    graphql-client (0.26.0)
+      activesupport (>= 3.0)
+      graphql (>= 1.13.0)
+    httparty (0.23.1)
+      csv
+      mini_mime (>= 1.0.0)
+      multi_xml (>= 0.5.2)
+    i18n (1.14.7)
+      concurrent-ruby (~> 1.0)
+    json (2.12.2)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    llm_chain (0.5.2)
+      faraday (~> 2.7)
+      faraday-net_http
+      httparty
+      json
+      redis
+      weaviate-ruby (= 0.9.1)
+    logger (1.7.0)
+    method_source (1.1.0)
+    mini_mime (1.1.5)
+    minitest (5.25.5)
+    multi_xml (0.7.2)
+      bigdecimal (~> 3.1)
+    net-http (0.6.0)
+      uri
+    parallel (1.27.0)
+    parser (3.3.8.0)
+      ast (~> 2.4.1)
+      racc
+    prism (1.4.0)
+    pry (0.15.2)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.3.0)
+    redis (5.4.0)
+      redis-client (>= 0.22.0)
+    redis-client (0.25.0)
+      connection_pool
+    regexp_parser (2.10.0)
+    rspec (3.13.1)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.5)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.4)
+    rubocop (1.77.0)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.45.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.45.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    ruby-progressbar (1.13.0)
+    rugged (1.9.0)
+    securerandom (0.4.1)
+    thor (1.3.2)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    unicode-display_width (3.1.4)
+      unicode-emoji (~> 4.0, >= 4.0.4)
+    unicode-emoji (4.0.4)
+    uri (1.0.3)
+    weaviate-ruby (0.9.1)
+      faraday (>= 2.0.1, < 3.0)
+      graphlient (>= 0.7.0, < 0.9.0)
+    yard (0.9.37)
+
+PLATFORMS
+  ruby
+  x86_64-linux
+
+DEPENDENCIES
+  bundler (~> 2.0)
+  code_sage!
+  pry
+  rake (~> 13.0)
+  rspec (~> 3.0)
+  rubocop
+  yard
+
+BUNDLED WITH
+   2.6.7

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 FuryCow
+
+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,279 @@
+# CodeSage 🔮
+
+**Wisdom for your code** - AI-powered code review tool for Ruby projects.
+
+CodeSage leverages the power of Large Language Models (LLM) through the [`llm_chain`](https://github.com/FuryCow/llm_chain) library to provide intelligent, context-aware code reviews for your Ruby projects. Get expert-level feedback on code quality, security, performance, and best practices.
+
+## Features
+
+- 🤖 **AI-Powered Reviews**: Intelligent code analysis using advanced language models
+- 🔍 **Git Integration**: Seamless integration with Git workflows
+- 📊 **Multiple Output Formats**: Console, JSON, and Markdown reports
+- ⚙️ **Configurable**: Customizable review criteria and output preferences  
+- 🎯 **Ruby-Focused**: Specialized knowledge of Ruby best practices and idioms
+- 🚀 **CLI Interface**: Easy-to-use command-line interface
+- 🌐 **Multiple LLM Providers**: OpenAI, Ollama, Qwen, and more via llm_chain
+- 🏠 **Local Models**: Support for local models through Ollama
+- 🔧 **System Diagnostics**: Built-in health checks and configuration validation
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'code_sage'
+```
+
+And then execute:
+
+```bash
+$ bundle install
+```
+
+Or install it yourself as:
+
+```bash
+$ gem install code_sage
+```
+
+## Usage
+
+### System Check
+
+Before starting, run diagnostics to ensure your system is properly configured:
+
+```bash
+$ code_sage diagnose
+```
+
+### Basic Usage
+
+Review changes between your current branch and main:
+
+```bash
+$ code_sage review
+```
+
+### Advanced Usage
+
+```bash
+# Review against a specific branch
+$ code_sage review -b develop
+
+# Review specific files
+$ code_sage review -f lib/my_class.rb app/controllers/my_controller.rb
+
+# Output in JSON format
+$ code_sage review --format json
+
+# Output in Markdown format  
+$ code_sage review --format markdown
+
+# Verbose output
+$ code_sage review -v
+
+# Review with custom configuration
+$ code_sage review -c ~/.my_code_sage_config.yml
+```
+
+### Configuration
+
+CodeSage can be configured using a YAML file. By default, it looks for `~/.code_sage.yml`:
+
+#### Basic Configuration
+
+```yaml
+llm:
+  provider: openai  # openai, ollama, qwen
+  model: gpt-4
+  temperature: 0.1
+  max_tokens: 2000
+  api_key: null  # Will use ENV variables
+
+git:
+  default_branch: main
+  include_patterns:
+    - "*.rb"
+    - "*.rake"
+    - "Gemfile"
+    - "Rakefile"
+  exclude_patterns:
+    - "spec/**/*"
+    - "test/**/*"
+
+review:
+  focus_areas:
+    - security
+    - performance
+    - maintainability
+    - best_practices
+  severity_levels:
+    - low
+    - medium
+    - high
+    - critical
+
+output:
+  format: console
+  verbose: false
+  colors: true
+```
+
+#### Configuration Examples
+
+**Using OpenAI GPT-4:**
+```yaml
+llm:
+  provider: openai
+  model: gpt-4
+  temperature: 0.1
+  max_tokens: 2000
+```
+
+**Using Local Ollama with Qwen:**
+```yaml
+llm:
+  provider: qwen
+  model: qwen2:7b
+  temperature: 0.2
+```
+
+**Using Local Ollama with LLaMA:**
+```yaml
+llm:
+  provider: ollama
+  model: llama2:7b
+  temperature: 0.1
+```
+
+#### Configuration Management
+
+```bash
+# Show current configuration
+$ code_sage config --show
+
+# Set LLM provider
+$ code_sage config --key llm.provider --value ollama
+
+# Set model
+$ code_sage config --key llm.model --value qwen2:7b
+
+# Reset to defaults
+$ code_sage config --reset
+```
+
+### Programmatic Usage
+
+You can also use CodeSage programmatically in your Ruby code:
+
+```ruby
+require 'code_sage'
+
+# Basic review
+result = CodeSage.review
+
+# With options
+result = CodeSage.review(
+  branch: 'develop',
+  files: ['lib/my_file.rb'],
+  format: 'json',
+  verbose: true
+)
+
+puts result[:report] if result[:success]
+```
+
+## CLI Commands
+
+### `review`
+
+Perform a code review on your repository.
+
+**Options:**
+- `-b, --branch BRANCH` - Branch to compare against (default: main)
+- `-f, --files FILES` - Specific files to review
+- `--format FORMAT` - Output format: console, json, markdown (default: console)
+- `-c, --config PATH` - Path to configuration file
+- `-v, --verbose` - Verbose output
+- `--rag` - Enable RAG (Retrieval Augmented Generation) functionality
+
+### `config`
+
+Manage configuration settings.
+
+**Options:**
+- `--show` - Show current configuration
+- `--key KEY --value VALUE` - Set configuration values
+- `--reset` - Reset configuration to defaults
+
+### `diagnose`
+
+Run comprehensive system diagnostics to check your setup.
+
+**Features:**
+- Check Ruby, Git, and llm_chain availability
+- Validate API key configuration
+- Display current LLM provider and model
+- Provide setup recommendations
+
+### `version`
+
+Show the current version of CodeSage.
+
+## Requirements
+
+- Ruby >= 2.7.0
+- Git repository
+- [`llm_chain`](https://github.com/FuryCow/llm_chain) gem configured with your preferred LLM provider
+
+### LLM Provider Setup
+
+CodeSage supports multiple LLM providers through llm_chain:
+
+#### OpenAI (Default)
+```bash
+export OPENAI_API_KEY="your-openai-api-key"
+```
+
+#### Local Models via Ollama
+```bash
+# Install Ollama
+curl -fsSL https://ollama.ai/install.sh | sh
+
+# Download models
+ollama pull qwen2:7b
+ollama pull llama2:7b
+
+# Start Ollama server
+ollama serve
+```
+
+#### Other Providers
+- **Anthropic**: Set `ANTHROPIC_API_KEY`
+- **Google**: Set `GOOGLE_API_KEY`
+- **Qwen**: Available through Ollama
+
+## Dependencies
+
+- `llm_chain` - For LLM integration
+- `thor` - CLI framework
+- `colorize` - Terminal colors
+- `rugged` - Git integration
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/FuryCow/code_sage.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for version history and changes.

data/Rakefile

@@ -0,0 +1,20 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+begin
+  require 'rubocop/rake_task'
+  RuboCop::RakeTask.new
+rescue LoadError
+  # Rubocop not available
+end
+
+task :default => :spec
+
+desc "Run a console with code_sage loaded"
+task :console do
+  require 'pry'
+  require_relative 'lib/code_sage'
+  Pry.start
+end 

data/bin/console

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "code_sage"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+require "pry"
+Pry.start 

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here 

data/code_sage.gemspec

@@ -0,0 +1,39 @@
+require_relative 'lib/code_sage/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "code_sage"
+  spec.version       = CodeSage::VERSION
+  spec.authors       = ["FuryCow"]
+  spec.email         = ["info@furycow.com"]
+
+  spec.summary       = "AI-powered code review tool for Ruby"
+  spec.description   = "Wisdom for your code - an intelligent code review assistant using LLM"
+  spec.homepage      = "https://github.com/FuryCow/code_sage"
+  spec.license       = "MIT"
+
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.7.0")
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/FuryCow/code_sage"
+  spec.metadata["changelog_uri"] = "https://github.com/FuryCow/code_sage/blob/master/CHANGELOG.md"
+
+  # Specify which files should be added to the gem when it is released.
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  # Dependencies
+  spec.add_dependency "llm_chain", "~> 0.5.2"
+  spec.add_dependency "thor", "~> 1.0"
+  spec.add_dependency "colorize", "~> 0.8"
+  spec.add_dependency "rugged", "~> 1.0"
+
+  # Development dependencies
+  spec.add_development_dependency "bundler", "~> 2.0"
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "pry"
+end 

data/exe/code_sage

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "code_sage"
+
+CodeSage::CLI.start(ARGV)