gims 0.5.3 → 0.6.1

package/.gimsrc

@@ -0,0 +1,10 @@
+{
+  "provider": "gemini",
+  "model": "",
+  "conventional": true,
+  "copy": true,
+  "autoStage": false,
+  "maxDiffSize": 100000,
+  "cacheEnabled": true,
+  "progressIndicators": true
+}

package/.kiro/steering/product.md

@@ -0,0 +1,21 @@
+# GIMS - Git Made Simple
+
+GIMS is an AI-powered Git CLI tool that automatically generates meaningful commit messages from code changes. It's designed to replace generic commit messages with descriptive, professional ones that tell a story.
+
+## Core Value Proposition
+- Eliminates the need to write commit messages manually
+- Uses AI (OpenAI, Google Gemini, Groq) to analyze code diffs and generate contextual messages
+- Provides a streamlined Git workflow with single-command operations
+- Supports both local and remote operations with intelligent fallbacks
+
+## Key Features
+- AI-powered commit message generation from code diffs
+- One-command workflow: analyze, commit, and push (`g o`)
+- Smart suggestions with clipboard integration (`g s`)
+- Conventional Commits support
+- Numbered commit history and branch management
+- Safe operations with confirmations and dry-run support
+- Graceful fallbacks for large diffs and offline use
+
+## Target Users
+Developers who want to maintain clean Git history without spending time crafting commit messages, especially those working on projects where commit message quality matters for collaboration and code review.

package/.kiro/steering/structure.md

@@ -0,0 +1,72 @@
+# Project Structure
+
+## Directory Layout
+```
+gims/
+├── bin/
+│   └── gims.js              # Main CLI executable and entry point
+├── node_modules/            # npm dependencies (auto-generated)
+├── .npm-cache/             # npm cache directory (auto-generated)
+├── .github/                # GitHub workflows and templates
+├── .git/                   # Git repository data
+├── .kiro/                  # Kiro AI assistant configuration
+│   └── steering/           # AI guidance documents
+├── package.json            # Project metadata and dependencies
+├── package-lock.json       # Dependency lock file
+├── README.md              # Comprehensive project documentation
+├── LICENSE                # MIT license
+└── .gitignore             # Git ignore patterns
+```
+
+## Key Files
+
+### `bin/gims.js`
+- **Purpose**: Single-file CLI application containing all functionality
+- **Structure**: Monolithic approach with utility functions, command handlers, and AI integration
+- **Exports**: Executable binary via shebang (`#!/usr/bin/env node`)
+- **Commands**: All CLI commands and subcommands defined in this file
+
+### `package.json`
+- **Binary entries**: `gims` and `g` both point to `bin/gims.js`
+- **Main entry**: Points to `bin/gims.js`
+- **Scripts**: Minimal test script placeholder
+- **Keywords**: Focused on git, cli, ai, commit, developer-tools
+
+### Configuration Files
+- **`.gimsrc`**: Optional JSON config (project root or home directory)
+- **Environment variables**: API keys and default settings
+- **Git integration**: Uses existing `.git` directory and configuration
+
+## Architecture Principles
+
+### Single-File Design
+- All functionality consolidated in `bin/gims.js` for simplicity
+- No separate modules or complex directory structure
+- Easy to understand, debug, and maintain
+- Reduces complexity for a CLI tool
+
+### Command Structure
+- Uses commander.js for CLI parsing and command organization
+- Short aliases for all commands (`g o`, `g s`, `g l`, etc.)
+- Consistent option patterns across commands
+- Global options available to all subcommands
+
+### File Naming Conventions
+- Executable files in `bin/` directory
+- Configuration files use dotfile convention (`.gimsrc`)
+- Standard npm project files (package.json, README.md, LICENSE)
+- No custom file extensions or special naming schemes
+
+## Development Guidelines
+
+### Adding New Features
+- Add new commands directly to `bin/gims.js`
+- Follow existing pattern of command definition with commander.js
+- Maintain consistent error handling and logging patterns
+- Add appropriate help text and examples
+
+### Configuration Management
+- Environment variables for sensitive data (API keys)
+- JSON config files for user preferences
+- Runtime detection and fallback logic
+- Validate configuration at startup when needed

package/.kiro/steering/tech.md

@@ -0,0 +1,68 @@
+# Technology Stack
+
+## Runtime & Language
+- **Node.js**: >= 18.18.0 (Node 20+ recommended)
+- **JavaScript**: CommonJS modules (`"type": "commonjs"`)
+- **Package Manager**: npm (with package-lock.json)
+
+## Core Dependencies
+- **commander**: CLI framework for command parsing and structure
+- **simple-git**: Git operations and repository management
+- **clipboardy**: Cross-platform clipboard operations
+- **@google/genai**: Google Gemini AI integration
+- **openai**: OpenAI API client
+
+## Architecture Patterns
+- Single-file CLI application (`bin/gims.js`)
+- Functional programming approach with utility functions
+- Configuration via environment variables and `.gimsrc` JSON files
+- Graceful fallbacks and error handling throughout
+- ANSI color utilities without external dependencies
+
+## Code Style Conventions
+- Use `const` for immutable values, avoid `var`
+- Prefer template literals for string interpolation
+- Use async/await for asynchronous operations
+- Implement comprehensive error handling with try/catch
+- Keep functions focused and modular
+- Use descriptive variable names (e.g., `rawDiff`, `prefProvider`)
+- Comment complex logic and AI prompt engineering sections
+
+## Common Commands
+
+### Development
+```bash
+# Install dependencies
+npm install
+
+# Test installation
+npm test  # Currently returns "No tests yet"
+
+# Global installation for testing
+npm install -g .
+```
+
+### Publishing
+```bash
+# Update version
+npm version patch|minor|major
+
+# Publish to npm
+npm publish
+```
+
+### Local Development Testing
+```bash
+# Link for local testing
+npm link
+
+# Test CLI commands
+gims --help
+g --help
+```
+
+## Configuration Management
+- Environment variables for API keys (`OPENAI_API_KEY`, `GEMINI_API_KEY`, `GROQ_API_KEY`)
+- Optional `.gimsrc` JSON config in project root or home directory
+- Runtime provider detection and fallback logic
+- Support for custom models and base URLs

package/CHANGELOG.md

@@ -0,0 +1,116 @@
+# Changelog
+
+## [0.6.0] - Enhanced GIMS - 2024-12-19
+
+### 🚀 Major Features Added
+
+#### **Interactive & Enhanced UX**
+- **Interactive Commit Wizard** (`g int`) - Guided workflow with multiple AI suggestions
+- **Enhanced Status** (`g status`) - Git status with AI insights and project analysis
+- **Preview Mode** (`g preview`) - See commit preview with AI message and diff analysis
+- **Setup Wizard** (`g setup`) - Interactive first-time configuration
+- **Progress Indicators** - Visual feedback for all AI operations
+
+#### **Smart Configuration Management**
+- **Config Command** (`g config`) - Manage settings with `--set`, `--get`, `--list`
+- **Project Type Detection** - Automatically detects React, Node, Python, etc.
+- **Enhanced .gimsrc** - More configuration options and better validation
+- **Global vs Local Config** - Project-specific or user-wide settings
+
+#### **Advanced Git Operations**
+- **Smart Sync** (`g sync`) - Intelligent pull with rebase/merge options
+- **Enhanced Stash** (`g stash`) - AI-generated stash descriptions
+- **Better Amend** (`g amend`) - Smart amend with AI message generation or `--no-edit`
+- **Enhanced List** (`g ls`) - Unified list command with `--detailed` and `--limit` options
+
+#### **AI & Performance Improvements**
+- **Multiple Suggestions** (`g s --multiple`) - Generate 3 different commit message options
+- **Caching System** - Cache AI responses for faster repeated operations
+- **Provider Fallback Chain** - Automatic fallback between AI providers
+- **Better Error Handling** - Actionable guidance and helpful suggestions
+
+### 🔧 Architecture Improvements
+
+#### **Modular Design**
+- Split monolithic `gims.js` into focused modules:
+  - `lib/utils/` - Colors, progress indicators
+  - `lib/config/` - Configuration management
+  - `lib/git/` - Git analysis and insights
+  - `lib/ai/` - AI provider management
+  - `lib/commands/` - Interactive commands
+
+#### **Enhanced Components**
+- **GitAnalyzer** - Smart git status analysis with insights
+- **AIProviderManager** - Improved AI handling with caching and fallbacks
+- **ConfigManager** - Comprehensive configuration with validation
+- **InteractiveCommands** - User interaction and guided workflows
+- **Progress** - Visual feedback system
+
+### 📊 User Experience Enhancements
+
+#### **Better Feedback**
+- Progress spinners for AI operations
+- Success/warning/error indicators with colors
+- Actionable error messages with suggestions
+- Step-by-step guidance in interactive mode
+
+#### **Smart Defaults**
+- Auto-detection of project type and commit style
+- Intelligent provider selection
+- Context-aware configuration suggestions
+
+#### **Enhanced Commands**
+- All existing commands improved with progress indicators
+- Better error handling and user guidance
+- Consistent color coding and formatting
+- More informative output
+
+### 🛠️ Configuration Options Added
+
+#### **New Environment Variables**
+- `GIMS_AUTO_STAGE` - Auto-stage changes by default
+- `GIMS_CACHE` - Enable/disable AI response caching
+- `GIMS_PROGRESS` - Show/hide progress indicators
+- `GIMS_MAX_DIFF_SIZE` - Maximum diff size for AI processing
+
+#### **New .gimsrc Options**
+```json
+{
+  "autoStage": false,
+  "cacheEnabled": true,
+  "progressIndicators": true,
+  "maxDiffSize": 100000,
+  "projectType": "react"
+}
+```
+
+### 📈 Performance Improvements
+- **Caching**: AI responses cached for 1 hour
+- **Modular Loading**: Components loaded on-demand
+- **Better Memory Management**: Efficient diff processing
+- **Faster Startup**: Optimized initialization
+
+### 🔄 Breaking Changes
+- Removed `largelist` command (merged into `list --detailed`)
+- Changed some internal APIs (affects programmatic usage only)
+- Updated minimum Node.js version recommendation to 20+
+
+### 🐛 Bug Fixes
+- Fixed git status parsing for different git versions
+- Improved error handling for large diffs
+- Better clipboard handling across platforms
+- Fixed configuration file validation
+
+### 📚 Documentation
+- Completely updated README with new features
+- Added comprehensive examples for all new commands
+- Enhanced configuration documentation
+- Added troubleshooting guide
+
+---
+
+## [0.5.4] - Previous Version
+- Basic AI-powered commit messages
+- Simple configuration
+- Core git operations
+- Single-file architecture

package/QUICK_REFERENCE.md

@@ -0,0 +1,74 @@
+# 🚀 GIMS Quick Reference
+
+## Single-Letter Workflow Commands
+
+```bash
+g s    # Status - Enhanced git status with AI insights
+g i    # Interactive - Guided commit wizard  
+g p    # Preview - See what will be committed
+g l    # Local - AI commit locally
+g o    # Online - AI commit + push
+g h    # History - Numbered commit log
+g a    # Amend - Smart amend with AI
+g u    # Undo - Undo last commit
+```
+
+## Quick Setup
+
+```bash
+# Choose your AI provider (one-time setup)
+g setup --api-key gemini    # 🚀 Recommended: Fast & free
+g setup --api-key openai    # 💎 High quality
+g setup --api-key groq      # ⚡ Ultra fast
+
+# Or run full setup wizard
+g setup
+```
+
+## Essential Workflow
+
+```bash
+# 1. Check what's changed
+g s
+
+# 2. Commit with AI (choose one)
+g i          # Interactive mode (guided)
+g o          # One-command: commit + push
+g l          # Local commit only
+
+# 3. View history
+g h          # Recent commits
+g h --detailed --limit 10  # Detailed view
+```
+
+## Default AI Models
+
+- **Gemini**: `gemini-2.0-flash-exp` (Fast, free, recommended)
+- **OpenAI**: `gpt-4o-mini` (Cost-effective, high quality)
+- **Groq**: `llama-3.1-8b-instant` (Ultra-fast inference)
+
+## Pro Tips
+
+```bash
+g sg --multiple    # Get 3 AI suggestions
+g p               # Preview before committing
+g a               # Smart amend with new AI message
+g sync --rebase   # Smart sync with rebase
+g stash           # Stash with AI description
+```
+
+## Configuration
+
+```bash
+g config --list                    # View all settings
+g config --set conventional=true   # Enable conventional commits
+g config --set autoStage=true      # Auto-stage changes
+g config --set provider=gemini     # Set AI provider
+```
+
+## Help
+
+```bash
+g --help          # All commands
+g <command> --help # Command-specific help
+```