v2.2.0 - Domain-Driven Design Architecture

Changelog for v2.2.0

Overview

Version 2.2.0 introduces a comprehensive Domain-Driven Design (DDD) architecture, enhanced TypeScript support, improved security, and better monitoring capabilities. This release represents a major architectural improvement while maintaining full backward compatibility.

Major Features

🏗️ Domain-Driven Design Architecture

• Complete DDD Implementation: Introduced bounded contexts for git-operations with clear separation of concerns
• CQRS Pattern: Implemented Command/Query Responsibility Segregation for better code organization
• Event-Driven Architecture: Added domain events and event bus for decoupled communication
• Value Objects: Introduced type-safe value objects for branch names, commit messages, and repository IDs
• Aggregate Roots: Implemented repository aggregate with proper domain logic encapsulation

🛡️ Enhanced Security

• Type Confusion Fix: Resolved security vulnerability in query parameter handling
• Type-Safe Query Parameters: Implemented comprehensive type checking for Express.js ParsedQs
• Input Validation: Added proper validation for all user inputs

📊 Improved Monitoring & Analytics

• Agent Monitoring System: Real-time dashboards for tracking autonomous agent activities
• Performance Monitoring: Added performance tracking for all domain operations
• Event Aggregation: Better insights into development patterns and milestones
• Learning System: Enhanced feedback store for adaptive behavior

🔧 Technical Improvements

• TypeScript ESLint v8: Updated to latest TypeScript ESLint packages (v8.34.1)
• Dependency Updates: Updated all major dependencies including:
  • @anthropic-ai/sdk: 0.24.3 → 0.54.0
  • openai: 4.104.0 → 5.6.0
  • commander: 13.1.0 → 14.0.0
  • express-rate-limit: 7.5.0 → 7.5.1
• Better Error Handling: Comprehensive error types and proper error propagation
• Code Quality: Fixed all ESLint errors and TypeScript compilation issues

Breaking Changes

None - This release maintains full backward compatibility.

Migration Guide

No migration required. All existing configurations and integrations will continue to work. To take advantage of new DDD features:

1. Update to v2.2.0: npm install @jdrhyne/claude-code-github@2.2.0
2. Optional: Enable new monitoring features in your config
3. Optional: Use new DDD-based commands through the enhanced API

Full Release Notes

See the complete changelog for detailed information about all changes.

v2.1.0-beta.1: LLM-Powered Automation (Beta)

🚀 Beta Release v2.1.0-beta.1

🎉 Introducing LLM-Powered Autonomous Git Workflow Automation

We're excited to announce the beta release of our most ambitious feature yet: AI-powered Git automation that learns from your development patterns and helps automate repetitive Git workflows.

✨ What's New

🤖 LLM Decision Engine

• Integrates with Anthropic Claude and OpenAI GPT-4
• Makes intelligent decisions about when to commit, branch, or create PRs
• Learns from your feedback to improve suggestions

🧠 Adaptive Learning System

• Learning Mode: Observes your patterns without taking action
• Assisted Mode: Suggests actions and waits for approval
• Autonomous Mode: Executes high-confidence actions automatically
• Adapts to your commit style, frequency, and preferences

🛡️ Safety First

• Protected branch safeguards
• Rate limiting (configurable actions per hour)
• Emergency stop mechanism
• Test status verification
• Comprehensive audit logging

🔧 New MCP Tools

• dev_automation_status - Check automation state
• dev_automation_enable - Turn on with mode selection
• dev_automation_disable - Turn off (with emergency option)
• dev_automation_configure - Adjust settings
• dev_feedback_approve/reject/correct - Train the system

🚀 Getting Started

1. Install Beta Version

npm install -g @jdrhyne/claude-code-github@beta

2. Set API Key

export ANTHROPIC_API_KEY=your-key-here
# or
export OPENAI_API_KEY=your-key-here

3. Enable in Config

# ~/.config/claude-code-github/config.yml
automation:
  enabled: true
  mode: learning  # Start here!
  llm:
    provider: anthropic
    api_key_env: ANTHROPIC_API_KEY

4. Start Testing!

See BETA_TESTING_GUIDE.md for detailed instructions.

⚠️ Beta Disclaimer

This is a beta release intended for testing and feedback:

• Use on non-critical projects first
• Start with learning mode
• Monitor API costs
• Report issues on GitHub
• Expect some rough edges

🐛 Known Issues

• CI tests show environmental failures (Rollup dependencies)
• Some integration tests need refinement
• Learning data is stored locally only (no sync)

🙏 We Need Your Feedback!

This feature represents months of work and we're excited to see how it performs in real-world scenarios. Please share:

• What works well?
• What could be improved?
• Any unexpected behaviors?
• Feature requests?

Report at: https://github.com/jdrhyne/claude-code-github/issues

📦 Installation

npm install -g @jdrhyne/claude-code-github@beta

Full Changelog: v2.0.0...v2.1.0-beta.1

v2.0.0 - API & Real-time Notification Architecture

🚀 claude-code-github v2.0.0 Release Announcement

Date: June 16, 2025
Version: 2.0.0
Breaking Changes: Yes (See Migration Guide)

🎉 Overview

We're excited to announce the biggest release in claude-code-github's history! Version 2.0.0 transforms our simple MCP server into a comprehensive development workflow platform with real-time capabilities, external integrations, and powerful automation features.

✨ What's New

🔥 REST API Server

• Complete HTTP API for external tool integration
• Authentication system with bearer tokens and scoped permissions
• Rate limiting and security middleware (CORS, Helmet)
• Health checks and monitoring endpoints
• Support for all Git workflow operations via HTTP

⚡ Real-time WebSocket Server

• Live event streaming for development activities
• Bidirectional communication with external clients
• Event filtering and subscription management
• Connection authentication and management
• Real-time suggestion delivery without polling

📡 Advanced Webhook System

• External service integration (Slack, Teams, custom endpoints)
• Exponential backoff retry logic for reliability
• Multiple authentication methods (Bearer tokens, HMAC signatures)
• Event filtering and conditional delivery
• Delivery tracking and error handling

🖥️ Terminal Notification Client

New: claude-code-notify command-line tool

• Real-time development suggestions in your terminal
• WebSocket connection to the API server
• Colored output and sound notifications
• Event filtering and project-specific monitoring
• Background operation support

🔍 Workspace Monitoring

• Dynamic Git repository discovery in parent directories
• Real-time detection of new projects
• Automatic GitHub repository detection from git remotes
• Smart exclusion patterns for performance
• Cross-platform compatibility

🎯 New Use Cases Unlocked

1. 📊 Real-time Development Dashboards

   # Get live suggestions without manual MCP calls
   claude-code-notify --project /my/project

2. 🤝 Team Collaboration

   # Send development insights to Slack
   webhooks:
     endpoints:
       - url: "https://hooks.slack.com/your-webhook"
         events: ["suggestion.created", "milestone.reached"]

3. 🔧 CI/CD Integration

   # Trigger workflows based on development patterns
   curl -H "Authorization: Bearer $TOKEN" \
        http://localhost:3000/api/status/enhanced

4. 🔌 External Tool Integration

   // Connect IDEs and editors via REST API
   const response = await fetch('http://localhost:3000/api/suggestions');
   const suggestions = await response.json();

5. 📱 Custom Monitoring Dashboards

   // Build real-time dashboards with WebSocket
   const socket = io('http://localhost:3000', {
     auth: { token: 'your-token' }
   });
   socket.on('suggestion.created', handleNewSuggestion);

📋 Migration Guide

Configuration Changes

⚠️ BREAKING CHANGE: New configuration sections required

Add these sections to your ~/.config/claude-code-github/config.yml:

# Enable API server (optional but recommended)
api_server:
  enabled: true
  port: 3000
  host: localhost
  auth:
    enabled: true
    tokens:
      - name: "notification-client"
        token: "generate-secure-token-here"
        scopes: ["*"]

# Enable WebSocket for real-time features (optional)
websocket:
  enabled: true
  events: ["*"]

# Enable webhooks for external integrations (optional)
webhooks:
  enabled: false  # Set to true when ready
  endpoints: []

# Enable workspace monitoring (optional)
workspace_monitoring:
  enabled: true
  workspaces:
    - path: "/Users/username/Projects"
      max_depth: 3
      exclude_patterns: ["node_modules", ".git", "dist"]

Claude Code Configuration

Your existing Claude Code configuration remains the same:

{
  "mcpServers": {
    "claude-code-github": {
      "command": "npx",
      "args": ["-y", "@jdrhyne/claude-code-github@latest"]
    }
  }
}

New Commands Available

# Terminal notifications (new!)
claude-code-notify

# Existing MCP server (unchanged)
claude-code-github

🚀 Getting Started with v2.0.0

1. Install/Update

# If using npx (recommended)
npx @jdrhyne/claude-code-github@latest

# If using global install
npm install -g @jdrhyne/claude-code-github@latest

2. Update Configuration

# Edit your config file
vi ~/.config/claude-code-github/config.yml

# Add the new sections shown in Migration Guide

3. Try Real-time Notifications

# In one terminal: start the MCP server with API enabled
claude-code-github

# In another terminal: get real-time suggestions
claude-code-notify --sound --verbose

4. Test the API

# Check server health
curl http://localhost:3000/health

# Get current status (requires token)
curl -H "Authorization: Bearer YOUR_TOKEN" \
     http://localhost:3000/api/status

📊 Performance & Architecture

Event-Driven Architecture

• Minimal resource usage with smart file watching
• Efficient WebSocket connections with connection pooling
• Background webhook delivery with retry queues
• Configurable monitoring depth and exclusion patterns

Security Features

• Token-based authentication for API access
• Scoped permissions system for fine-grained control
• Rate limiting to prevent API abuse
• HMAC signature verification for webhook security
• Secure GitHub token storage via system keychain

Scalability

• Graceful handling of large numbers of repositories
• Smart exclusion patterns for performance optimization
• Connection pooling for WebSocket efficiency
• Retry logic for reliable webhook delivery

🛠️ Technical Details

New Dependencies

• express ^5.1.0 - HTTP server framework
• socket.io ^4.8.1 - WebSocket communication
• blessed ^0.1.81 - Terminal UI components
• commander ^14.0.0 - CLI framework
• Security middleware: cors, helmet, express-rate-limit

API Endpoints

• GET /health - Server health check
• GET /api/status - Current development status
• GET /api/status/enhanced - Detailed project information
• GET /api/suggestions - List active suggestions
• POST /api/suggestions/:id/action - Execute suggestion actions
• WebSocket: ws://localhost:3000/ - Real-time events

Backward Compatibility

• Full MCP compatibility maintained
• Existing tools unchanged (dev_status, dev_create_branch, etc.)
• Configuration migration is additive (no breaking changes to existing settings)
• Optional features - new capabilities are opt-in

🔗 Resources

• Documentation: GitHub Repository
• Issue Tracker: GitHub Issues
• NPM Package: @jdrhyne/claude-code-github
• Changelog: CHANGELOG.md

🤝 Community & Support

• Report Issues: GitHub Issues
• Feature Requests: Use GitHub Issues with the enhancement label
• Discussions: GitHub Discussions

🎈 What's Next?

We're already working on the next major features:

• 📱 Mobile notifications - iOS/Android app integration
• 🤖 Advanced AI suggestions - More intelligent pattern recognition
• 👥 Team collaboration features - Shared development insights
• 🔧 IDE extensions - Native VS Code, JetBrains integration
• 📈 Analytics dashboard - Web-based monitoring interface

📝 Acknowledgments

Special thanks to all contributors, testers, and the Claude Code community for making this release possible. Your feedback and suggestions have shaped this major evolution of the project.

---

Ready to supercharge your development workflow?

npx @jdrhyne/claude-code-github@latest

Get real-time suggestions while you code:

claude-code-notify --sound

Happy coding! 🎉

v1.2.0 - Automatic Project Discovery

✨ What's New

Automatic Project Discovery - No more manual configuration for each project! (#24)

Instead of manually adding each project to your config file, you can now configure directory paths and let claude-code-github discover your Git repositories automatically.

🎯 Key Features

• Smart Discovery: Scans configured directories for Git repositories
• Auto-Detection: Automatically detects GitHub repository from git remotes (SSH & HTTPS)
• Flexible Filtering: Smart exclusion patterns (skip node_modules, archived folders, etc.)
• Configurable Depth: Set maximum scan depth (default: 3 levels)
• Seamless Integration: Works alongside manually configured projects
• Cross-Platform: Full Windows, macOS, and Linux support

📋 Configuration Example

# Automatic project discovery configuration
project_discovery:
  enabled: true                 # Enable automatic discovery
  scan_paths:                   # Directories to scan
    - "/Users/yourname/Projects"
    - "/Users/yourname/Work"
  exclude_patterns:             # Patterns to exclude
    - "*/archived/*"
    - "*/.Trash/*"
  auto_detect_github_repo: true # Auto-detect from git remote
  max_depth: 3                  # Maximum directory depth

🐛 Bug Fixes

• Fixed Windows path separator issues in project discovery
• Resolved ESLint errors for CI compliance
• Fixed const declaration scope issue with block statements

📦 Installation

npm install -g @jdrhyne/claude-code-github@latest
# or use npx
npx @jdrhyne/claude-code-github@latest

📚 Documentation

See the README for detailed configuration instructions.

Full Changelog

View the complete changelog: https://github.com/jdrhyne/claude-code-github/blob/main/CHANGELOG.md#120---2025-06-13

Full Changelog: v1.1.5...v1.2.0

v1.1.5 - MCP Server Initialization Fix

What's Changed

🐛 Bug Fixes

• Fixed MCP Server Initialization Hang - The server now runs silently in MCP mode
  • Suppresses all console output to stderr when running in MCP mode
  • Automatically detects MCP mode when no CLI arguments are provided
  • Fixes double configuration loading that caused duplicate validation messages
  • Ensures clean JSON-RPC protocol communication without interference

🔧 Code Quality

• Resolved all ESLint errors that were causing CI failures
  • Replaced all any types with unknown or proper types
  • Fixed unused parameters and imports
  • Added proper type assertions where needed

Installation

npm install -g @jdrhyne/claude-code-github@latest
# or use npx
npx @jdrhyne/claude-code-github@latest

Full Changelog

https://github.com/jdrhyne/claude-code-github/blob/main/CHANGELOG.md#115---2025-06-12

Full Changelog: v1.1.4...v1.1.5

v1.1.4: Active Monitoring System and Process Lifecycle Management

🚀 Major Enhancement Release

This release introduces a comprehensive Active Monitoring System that transforms claude-code-github from a passive command executor into an intelligent development assistant.

🧠 Active Monitoring System

• Conversation Tracking: Monitors development conversations with pattern recognition
• Git State Monitoring: Tracks repository changes and detects development milestones
• Event Aggregation: Intelligently combines related events to suggest improvements
• Smart Notifications: Provides contextual suggestions without interrupting flow

🛡️ Process Lifecycle Management

• Zombie Process Prevention: Eliminates accumulation of MCP server processes
• Single Instance Enforcement: Uses lock files to ensure one instance per project
• Graceful Shutdown: Proper cleanup of resources on exit
• Health Monitoring: Automatic detection and cleanup of stale processes

🔧 Enhanced Tools & Configuration

• New Tool: dev_monitoring_status() - View monitoring insights and events
• Enhanced MCP Server: Extended protocol support for real-time notifications
• Flexible Configuration: Comprehensive monitoring options in config.yml
• Learning Mode: Optional adaptive pattern recognition

🎯 Issues Fixed

• ✅ #26: No more zombie processes - proper lifecycle management
• ✅ #27: Active monitoring with intelligent suggestions
• ✅ Release detection when features are complete
• ✅ Repository hygiene through proactive suggestions

🔄 Upgrade Instructions

# Update to latest version
npx @jdrhyne/claude-code-github@latest

# Monitoring is enabled by default
# Check status with: dev_monitoring_status()

This transforms claude-code-github into a truly intelligent development assistant!
EOF < /dev/null

v1.1.3: Comprehensive Error Handling & Resilience

v1.1.3: Comprehensive Error Handling & Resilience

🛡️ What's Fixed

This patch release significantly improves the robustness of claude-code-github by addressing multiple edge cases and potential runtime errors discovered through comprehensive code analysis.

🔧 Critical Fixes

• File System Race Conditions: Fixed crashes when .gitignore files are deleted during read operations
• JSON Parsing Safety: Added proper error handling for malformed package.json files
• GitHub API Resilience: Handles deleted users and null API responses gracefully
• Array Safety: Prevents undefined access for empty arrays and null values

🚀 Enhanced Features

• 60-second Timeout: npm operations now timeout instead of hanging indefinitely
• Better URL Parsing: Supports GitHub Enterprise, SSH with ports, and various URL formats
• Partial Failure Handling: PR fetching continues even if individual requests fail
• Improved Logging: Added warning messages for debugging edge cases

📊 Impact

These fixes ensure claude-code-github remains stable even in unusual circumstances:

• Corrupted files won't crash the tool
• Network issues are handled gracefully
• Deleted GitHub accounts don't break PR workflows
• Enterprise GitHub instances are fully supported

🚀 Getting Started

npx @jdrhyne/claude-code-github@latest

📖 Documentation

• Configuration Guide
• Full Changelog

💬 Feedback

We'd love to hear your feedback! Please open an issue or start a discussion.

---

Full Changelog: v1.1.2...v1.1.3

v1.1.2: Bug Fix - PR Author Review Request

v1.1.2: Bug Fix - PR Author Review Request

🐛 What's Fixed

This patch release fixes a critical bug that prevented users from creating pull requests when their GitHub username was included in the project's configured reviewers list.

🛡️ GitHub API Compatibility

• PR Author Filtering: Automatically filters out the PR author from the reviewers list since GitHub doesn't allow requesting reviews from the person who created the PR
• Case-Insensitive Matching: Handles username variations (e.g., john-doe, John-Doe, JOHN-DOE) to ensure reliable filtering
• Error Prevention: Eliminates the "Review cannot be requested from pull request author" error

🚀 Getting Started

npx @jdrhyne/claude-code-github@latest

📖 Documentation

• Configuration Guide
• Usage Examples
• Full Changelog

💬 Feedback

We'd love to hear your feedback! Please open an issue or start a discussion.

---

Full Changelog: v1.1.1...v1.1.2

v1.1.1 - CLI Argument Handling Fix

What's Changed

🐛 Bug Fixes

• Fixed CLI argument handling for --version and --help flags
• Prevent CLI from hanging when run directly without arguments
• Improved user experience for direct CLI usage

Installation

npm install -g @jdrhyne/claude-code-github@1.1.1

Full Changelog: v1.1.0...v1.1.1

v1.1.0: Intelligent Workflow Assistant

v1.1.0: Intelligent Workflow Assistant

🎉 What's New

claude-code-github now features an intelligent workflow assistant that analyzes your development patterns and provides smart suggestions to improve productivity and maintain clean Git history. This major enhancement transforms the tool from basic Git automation into an AI-powered development companion.

🧠 Intelligent Workflow Assistant

• Pattern Recognition: Analyzes your work patterns and provides contextual suggestions
• Time Tracking: Reminds you to commit after extended work sessions (configurable: 1hr reminder, 2hr warning)
• Change Analysis: Suggests optimal commit strategies based on file types and changes
• Workflow Guidance: Recommends when to branch, commit, or create pull requests

🛡️ Smart Safety & Best Practices

• Protected Branch Warnings: Alerts when working directly on main/develop branches
• Atomic Commit Suggestions: Identifies large changesets (5+ files) and mixed change types
• PR Readiness Detection: Suggests creating pull requests when branches are ready
• Work Loss Prevention: Time-based reminders to avoid losing uncommitted work

⚙️ Comprehensive Configuration System

• Master Switch: suggestions.enabled: false to disable all suggestions
• Granular Controls: Enable/disable individual suggestion types
• Custom Thresholds: Adjust time limits (default: 60min/120min) and file counts (default: 5)
• Per-Project Overrides: Different configurations for different workflow styles

📊 Enhanced Status Reporting

• Intelligent Suggestions: Included in dev_status output with priority levels
• Contextual Hints: Smart recommendations based on current work context
• Priority Sorting: High/medium/low priority suggestions for better focus

🚀 Getting Started

npx @jdrhyne/claude-code-github@latest

The intelligent suggestions are enabled by default with sensible defaults. To customize:

# Edit ~/.config/claude-code-github/config.yml
suggestions:
  enabled: true
  time_reminders:
    warning_threshold_minutes: 120  # Customize timing
  large_changeset:
    threshold: 5                   # Customize file count

📖 Documentation

• Intelligent Suggestions Configuration
• Usage Examples
• Full Changelog

🔄 Migration

No breaking changes - this is a fully backward-compatible release. Existing configurations will continue to work, and suggestions are additive to existing functionality.

💬 Feedback

The intelligent workflow assistant learns from common development patterns. We'd love to hear how it works for your workflow! Please open an issue or start a discussion.

---

Full Changelog: 1.0.2...1.1.0