reposer 1.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 21e6ac1d1b953194dc4176df7f2dffeb3d1642a6d74297980ff71e9389e88b76
+  data.tar.gz: ab6964bc0cda7ad948032fb28bf5c7dd84bf0fbf443f625531a9199940981a16
+SHA512:
+  metadata.gz: aba8513ddcf8f13210dd61f0c736c87d68d05d8b067a4a8d01851a0c1ee84453dae1b800e79be30d503e1547fa3cff46b181067faebfeb139e5a66735d063bc7
+  data.tar.gz: d4d3eebe27baec85cde71c21f6475e0d8a2fe8cf88237d9e4e502f1653dae91e2ba06d6cf89c60e48a5050632ab74ac30b7d0e28091b9decd5d40ffcb2b8b987

data/.rspec

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

data/.rubocop.yml

@@ -0,0 +1,33 @@
+require:
+  - rubocop-performance
+  - rubocop-rspec
+
+AllCops:
+  TargetRubyVersion: 3.0
+  NewCops: enable
+  Exclude:
+    - 'vendor/**/*'
+    - 'spec/vcr_cassettes/**/*'
+
+Style/Documentation:
+  Enabled: false
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+
+Layout/LineLength:
+  Max: 120
+
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*'
+    - '*.gemspec'
+
+Metrics/MethodLength:
+  Max: 20
+
+Metrics/ClassLength:
+  Max: 150

data/.ruby-version

@@ -0,0 +1 @@
+3.4.7

data/CHANGELOG.md

@@ -0,0 +1,203 @@
+# 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]
+
+## [1.1.0] - 2025-01-20
+
+### Changed - Gem Renamed
+- **Breaking**: Gem renamed from `repose` to `repo-composer` (original name taken on RubyGems)
+- Installation: `gem install repo-composer` (was `gem install repose`)
+- Command: `repo-composer` (was `repose`)
+- All functionality remains identical
+
+### Added - AI Provider Integration 🤖
+
+#### Gemini AI Integration
+- **New Provider**: `Repose::AI::GeminiProvider` for Google Gemini AI
+  - AI-powered repository descriptions, topics, and README generation
+  - Support for multiple models (gemini-1.5-flash default, gemini-1.5-pro)
+  - Automatic API key configuration via `GEMINI_API_KEY` environment variable
+  - Retry logic with exponential backoff (max 3 retries, 30s timeout)
+  - Comprehensive error handling (authentication, rate limiting, timeouts)
+  - 56 test cases with full coverage
+
+#### Ollama Local AI Integration
+- **New Provider**: `Repose::AI::OllamaProvider` for local AI models
+  - Privacy-focused AI generation using locally-hosted models
+  - Support for all Ollama models (mistral, llama3, gemma, etc.)
+  - Model listing and pulling capabilities
+  - Configurable via `OLLAMA_ENDPOINT` and `OLLAMA_MODEL` env vars
+  - Connection error handling with setup instructions
+  - 56 test cases with full coverage
+
+#### Enhanced AIGenerator
+- Auto-detection of available AI providers (Gemini → Ollama → Fallback)
+- Explicit provider selection via `provider:` constructor parameter
+- `use_ai?` method to check if AI provider is active
+- Graceful degradation to template-based generation on errors
+- Comprehensive fallback logic for all generation methods
+- 13 new test cases for provider integration
+
+#### Error Handling
+- Extended error hierarchy with AI-specific exceptions
+- `ConfigurationError` for missing/invalid API keys
+- `APIError` for general API failures
+- `AuthenticationError` for invalid credentials
+- `RateLimitError` for API rate limit exceeded
+
+#### Documentation & Demos
+- `demo_ai_providers.rb` - Comprehensive demo of all AI features
+  - Fallback mode demonstration
+  - Gemini integration (when API key available)
+  - Ollama integration (when service running)
+  - Auto-detection behavior
+  - Error handling and graceful degradation
+  - Configuration examples
+
+### Changed
+- **AIGenerator API**: Now accepts optional `provider:` parameter
+  - `:gemini` - Force Gemini provider
+  - `:ollama` - Force Ollama provider  
+  - `:none`/`false` - Force fallback mode
+  - `nil` (default) - Auto-detect best available
+
+### Technical Details
+- **Test Coverage**: 96.63% (373/386 lines)
+- **New Code**: 455 lines (AI providers)
+- **Test Code**: 642 lines (comprehensive suite)
+- **Dependencies**: No new gems (uses Net::HTTP)
+- **Backward Compatible**: All existing tests passing
+
+### Configuration Examples
+```bash
+# Gemini
+export GEMINI_API_KEY='your-api-key'
+
+# Ollama (optional, defaults shown)
+export OLLAMA_ENDPOINT='http://localhost:11434'
+export OLLAMA_MODEL='mistral'
+```
+
+### Usage Examples
+```ruby
+# Auto-detect provider
+generator = Repose::AIGenerator.new
+
+# Force specific provider
+generator = Repose::AIGenerator.new(provider: :gemini)
+generator = Repose::AIGenerator.new(provider: :ollama)
+
+# Generate content
+result = generator.generate({
+  name: "my-project",
+  language: "Ruby",
+  framework: "Rails",
+  purpose: "Web application"
+})
+```
+
+---
+
+## [1.0.0] - 2025-11-07 🎉
+
+### 🎯 Production Release
+First stable production release of Repose - the AI-powered GitHub repository creation tool.
+
+### ✨ Features
+- **🤖 AI-Generated Content**: Automatically generates descriptions, topics, and READMEs using GPT-4 patterns
+- **🎯 Smart Context Awareness**: Understands project purpose from name, language, and framework
+- **🔧 Interactive CLI**: Guided prompts for missing information with intelligent defaults
+- **📝 Professional READMEs**: Creates comprehensive, well-structured documentation
+- **🏷️ Intelligent Topics**: Generates relevant tags and topics automatically based on project context
+- **👁️ Preview Mode**: See generated content before creating repository with `--dry-run`
+- **🔐 Secure Configuration**: Encrypted storage of API keys and tokens with proper file permissions
+- **⚡ Framework Support**: Built-in support for popular frameworks across multiple languages
+
+### 🛠️ Technical Implementation
+- **98.39% Test Coverage**: Comprehensive test suite with unit, integration, and error handling tests
+- **Ruby 3.4.7+ Support**: Modern Ruby compatibility with latest language features
+- **Robust Error Handling**: Graceful error handling with detailed error messages and recovery options
+- **Modular Architecture**: Clean separation of concerns with dedicated classes for each responsibility
+- **GitHub API Integration**: Full integration with GitHub API v4 using Octokit
+- **Interactive UX**: Beautiful CLI interface using TTY toolkit with spinners, prompts, and colors
+
+### 🌍 Language & Framework Support
+- **Ruby**: Rails, Sinatra, Hanami, Roda
+- **JavaScript/TypeScript**: React, Vue, Express, Next.js, Nuxt, Angular  
+- **Python**: Django, Flask, FastAPI, Streamlit
+- **Go**: Gin, Echo, Fiber, Chi
+- **Java**: Spring Boot, Quarkus, Micronaut
+- **Rust**: Actix, Axum, Warp, Rocket
+- **Swift**: Vapor, Perfect, Kitura
+- **And more**: Extensible architecture for additional languages
+
+### 🎨 Usage Examples
+```bash
+# Quick repository creation
+repose create my-awesome-project
+
+# With specific options
+repose create web-scraper --language ruby --framework rails --private
+
+# Preview before creating
+repose create ai-chatbot --language python --framework fastapi --dry-run
+
+# Interactive mode with intelligent prompts
+repose create awesome-api  # Repose will guide you through the process
+```
+
+### 🔧 Configuration
+```bash
+# One-time setup
+repose configure
+
+# Configure programmatically
+repose create my-project --language go --framework gin --topics api,microservice
+```
+
+### 📦 Installation
+```bash
+gem install repose
+```
+
+### 🏗️ Architecture
+- `Repose::CLI`: Thor-based command-line interface with interactive prompts
+- `Repose::AIGenerator`: Intelligent content generation with fallback mechanisms
+- `Repose::GitHubClient`: GitHub API integration with error handling
+- `Repose::Config`: Secure configuration management with validation
+- `Repose::Errors`: Comprehensive error hierarchy for different failure modes
+
+### 🧪 Quality Assurance
+- **123 Test Examples**: Comprehensive test coverage across all components
+- **Unit Tests**: Individual class and method testing
+- **Integration Tests**: End-to-end workflow validation
+- **Error Handling Tests**: Comprehensive error scenario coverage
+- **Mock & Stub Tests**: External API interaction testing
+- **Configuration Tests**: Secure file handling validation
+
+### 📋 Requirements
+- Ruby 3.0.0 or higher
+- GitHub Personal Access Token (for repository creation)
+- OpenAI API Key (for enhanced content generation)
+
+### 🔒 Security
+- Secure API key storage with 600 file permissions
+- Input validation and sanitization
+- Error message sanitization (no sensitive data in logs)
+- Secure YAML configuration handling
+
+---
+
+## [0.1.0] - 2024-11-07
+
+### Added
+- Initial project structure and core functionality
+- Basic CLI interface and GitHub integration
+- AI content generation foundation
+- Configuration system prototype
+- Error handling framework

data/Gemfile

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gemspec
+
+group :development, :test do
+  gem "rspec", "~> 3.0"
+  gem "rubocop", "~> 1.0"
+  gem "rubocop-performance", require: false
+  gem "rubocop-rspec", require: false
+  gem "pry", "~> 0.14"
+  gem "yard", "~> 0.9"
+end
+
+group :test do
+  gem "webmock", "~> 3.0"
+  gem "vcr", "~> 6.0"
+  gem "simplecov", "~> 0.22"
+  gem "simplecov-lcov", "~> 0.8"
+end

data/Gemfile.lock

@@ -0,0 +1,151 @@
+PATH
+  remote: .
+  specs:
+    repose (1.1.0)
+      faraday (~> 2.0)
+      octokit (~> 6.0)
+      ostruct (~> 0.6)
+      pastel (~> 0.8)
+      thor (~> 1.0)
+      tty-prompt (~> 0.23)
+      tty-spinner (~> 0.9)
+      yaml (~> 0.3)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.8.7)
+      public_suffix (>= 2.0.2, < 7.0)
+    ast (2.4.3)
+    base64 (0.3.0)
+    bigdecimal (3.3.1)
+    coderay (1.1.3)
+    crack (1.0.1)
+      bigdecimal
+      rexml
+    diff-lcs (1.6.2)
+    docile (1.4.1)
+    faraday (2.14.0)
+      faraday-net_http (>= 2.0, < 3.5)
+      json
+      logger
+    faraday-net_http (3.4.1)
+      net-http (>= 0.5.0)
+    hashdiff (1.2.1)
+    json (2.16.0)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    method_source (1.1.0)
+    net-http (0.7.0)
+      uri
+    octokit (6.1.1)
+      faraday (>= 1, < 3)
+      sawyer (~> 0.9)
+    ostruct (0.6.3)
+    parallel (1.27.0)
+    parser (3.3.10.0)
+      ast (~> 2.4.1)
+      racc
+    pastel (0.8.0)
+      tty-color (~> 0.5)
+    prism (1.6.0)
+    pry (0.15.2)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    public_suffix (6.0.2)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    regexp_parser (2.11.3)
+    rexml (3.4.4)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      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.7)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.6)
+    rubocop (1.81.7)
+      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.47.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.47.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    rubocop-performance (1.26.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
+    rubocop-rspec (3.7.0)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.72, >= 1.72.1)
+    ruby-progressbar (1.13.0)
+    sawyer (0.9.3)
+      addressable (>= 2.3.5)
+      faraday (>= 0.17.3, < 3)
+    simplecov (0.22.0)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.13.2)
+    simplecov-lcov (0.9.0)
+    simplecov_json_formatter (0.1.4)
+    thor (1.4.0)
+    tty-color (0.6.0)
+    tty-cursor (0.7.1)
+    tty-prompt (0.23.1)
+      pastel (~> 0.8)
+      tty-reader (~> 0.8)
+    tty-reader (0.9.0)
+      tty-cursor (~> 0.7)
+      tty-screen (~> 0.8)
+      wisper (~> 2.0)
+    tty-screen (0.8.2)
+    tty-spinner (0.9.3)
+      tty-cursor (~> 0.7)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.1.0)
+    uri (1.1.1)
+    vcr (6.3.1)
+      base64
+    webmock (3.26.1)
+      addressable (>= 2.8.0)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
+    wisper (2.0.1)
+    yaml (0.4.0)
+    yard (0.9.37)
+
+PLATFORMS
+  arm64-darwin-24
+  ruby
+
+DEPENDENCIES
+  pry (~> 0.14)
+  repose!
+  rspec (~> 3.0)
+  rubocop (~> 1.0)
+  rubocop-performance
+  rubocop-rspec
+  simplecov (~> 0.22)
+  simplecov-lcov (~> 0.8)
+  vcr (~> 6.0)
+  webmock (~> 3.0)
+  yard (~> 0.9)
+
+BUNDLED WITH
+   2.7.2

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Wesley Scholl
+
+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.