mcp-ticketer 0.3.1__tar.gz → 0.3.2__tar.gz

mcp_ticketer-0.3.2/.claude/agents/.dependency_cache

@@ -0,0 +1,18 @@
+{
+  "bf8c9b0d7fac24c488522bbfa869e66b": {
+    "timestamp": 1761354165.189099,
+    "results": {
+      "agents": {},
+      "summary": {
+        "total_agents": 36,
+        "agents_with_deps": 0,
+        "missing_python": [],
+        "missing_system": [],
+        "satisfied_python": [],
+        "satisfied_system": []
+      }
+    },
+    "deployment_hash": "356954435a3667304f39f35a6d31a49c1ff5ecaeff7f58b4fac66b87908c5586",
+    "context": {}
+  }
+}

{mcp_ticketer-0.3.1 → mcp_ticketer-0.3.2}/.claude/agents/.mpm_deployment_state

@@ -1,6 +1,6 @@
 {
-  "deployment_hash": "c460ffb1ea5088ce8ee0e1d6e3e83d434833608e29ac2e64fd4d4d8f16f54c17",
-  "last_check_time": 1761160971.8831968,
+  "deployment_hash": "356954435a3667304f39f35a6d31a49c1ff5ecaeff7f58b4fac66b87908c5586",
+  "last_check_time": 1761354165.189831,
   "last_check_results": {
     "agents": {},
     "summary": {

{mcp_ticketer-0.3.1 → mcp_ticketer-0.3.2}/.claude/agents/local_ops_agent.md

@@ -3,7 +3,7 @@ name: local-ops-agent
 description: "Use this agent when you need specialized assistance with specialized agent for managing local development deployments with focus on maintaining single stable instances, protecting existing services, and never interfering with other projects or claude code services. This agent provides targeted expertise and follows best practices for local_ops_agent related tasks.\n\n<example>\nContext: When you need specialized assistance from the local_ops_agent agent.\nuser: \"I need help with local_ops_agent tasks\"\nassistant: \"I'll use the local_ops_agent agent to provide specialized assistance.\"\n<commentary>\nThis agent provides targeted expertise for local_ops_agent related tasks and follows established best practices.\n</commentary>\n</example>"
 model: sonnet
 category: operations
-version: "1.0.2"
+version: "2.0.0"
 tags: deployment,devops,local,process-management,monitoring
 ---
 # Agent Instructions

{mcp_ticketer-0.3.1/src/mcp_ticketer.egg-info → mcp_ticketer-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-ticketer
-Version: 0.3.1
+Version: 0.3.2
 Summary: Universal ticket management interface for AI agents with MCP support
 Author-email: MCP Ticketer Team <support@mcp-ticketer.io>
 Maintainer-email: MCP Ticketer Team <support@mcp-ticketer.io>

mcp_ticketer-0.3.2/docs/changelogs/CHANGELOG_v0.2.0.md

@@ -0,0 +1,201 @@
+# Changelog - MCP Ticketer v0.2.0
+
+**Release Date**: 2025-10-24  
+**Version**: 0.2.0 (Minor Release)  
+**Previous Version**: 0.1.39
+
+## 🎉 **Release Highlights**
+
+This minor release represents a **major milestone** in MCP Ticketer's development maturity, featuring comprehensive module refactoring and extensive testing infrastructure. The release significantly improves code organization, maintainability, and reliability.
+
+### **🏗️ Major Features**
+
+#### **1. Linear Adapter Module Refactoring**
+- **Monolithic Module Split**: Refactored 2,389-line Linear adapter into 5 focused modules
+- **66% Size Reduction**: Main adapter file reduced from 2,389 → 812 lines
+- **Improved Organization**: Clear separation of concerns across modules:
+  - `adapter.py` - Core CRUD operations and business logic
+  - `queries.py` - GraphQL queries and fragments  
+  - `types.py` - Linear-specific types and mappings
+  - `client.py` - GraphQL client management with error handling
+  - `mappers.py` - Data transformation between Linear and universal models
+
+#### **2. Comprehensive Testing Infrastructure**
+- **2,000+ Lines of Unit Tests**: Extensive unit test coverage for all refactored modules
+- **1,200+ Lines of E2E Tests**: Complete workflow testing from creation to closure
+- **90%+ Test Coverage**: Comprehensive coverage across critical functionality
+- **Automated Test Runner**: Comprehensive test execution with detailed reporting
+
+#### **3. Enhanced Error Handling System**
+- **Centralized Exception Hierarchy**: Created `core/exceptions.py` with comprehensive error types
+- **Rich Error Context**: Adapter name, original error, and retry information
+- **Type-Specific Errors**: `AuthenticationError`, `RateLimitError`, `ValidationError`
+- **Better Debugging**: Enhanced error messages and context for troubleshooting
+
+### **🔧 Technical Improvements**
+
+#### **Code Quality Enhancements**
+- **Separation of Concerns**: Each module has a single, clear responsibility
+- **Loose Coupling**: Modules interact through well-defined interfaces
+- **High Cohesion**: Related functionality grouped together
+- **Extensibility**: Easy to add new features or modify existing ones
+
+#### **Developer Experience Improvements**
+- **Easier Navigation**: Find specific functionality quickly in focused files
+- **Better Understanding**: Clear separation makes code easier to comprehend
+- **Faster Development**: Smaller files load and edit faster in IDEs
+- **Reduced Cognitive Load**: Work on one concern at a time
+
+#### **Maintainability Enhancements**
+- **Isolated Changes**: Modify queries without touching business logic
+- **Better Testing**: Test individual components in isolation
+- **Easier Debugging**: Smaller scope for troubleshooting issues
+- **Clear Responsibilities**: Each module has well-defined purpose
+
+### **🧪 Testing Infrastructure**
+
+#### **Unit Test Coverage**
+- **Linear Adapter Types**: 95%+ coverage (mappings, filters, metadata)
+- **Linear GraphQL Client**: 90%+ coverage (queries, errors, retries)
+- **Linear Data Mappers**: 95%+ coverage (transformations, builders)
+- **Linear Adapter Main**: 85%+ coverage (initialization, validation)
+- **Linear GraphQL Queries**: 100% coverage (syntax, structure)
+
+#### **End-to-End Test Coverage**
+- **Complete Workflows**: Epic → Issue → Task with full lifecycle
+- **State Transitions**: All 8 states with proper validation
+- **Comment Threading**: Multi-participant conversations
+- **Metadata Management**: Rich metadata handling and updates
+- **Hierarchy Validation**: Parent-child relationships
+- **Search and Filtering**: Cross-hierarchy search capabilities
+
+#### **Test Infrastructure Features**
+- **Comprehensive Test Runner**: Automated execution with detailed reporting
+- **Test Organization**: Proper markers and categories (unit, e2e, integration)
+- **Performance Insights**: Test timing and optimization recommendations
+- **CI/CD Ready**: Proper exit codes for continuous integration
+
+## 📋 **Detailed Changes**
+
+### **Added**
+- ✅ **Linear Adapter Module Structure**: Split monolithic adapter into focused modules
+- ✅ **Comprehensive Exception System**: `core/exceptions.py` with rich error hierarchy
+- ✅ **Unit Test Suite**: 2,000+ lines covering all refactored modules
+- ✅ **E2E Test Suite**: 1,200+ lines covering complete workflows
+- ✅ **Test Infrastructure**: Automated test runner with comprehensive reporting
+- ✅ **Module Documentation**: Enhanced docstrings and code documentation
+
+### **Improved**
+- ✅ **Code Organization**: Better separation of concerns and module boundaries
+- ✅ **Error Handling**: Centralized exceptions with rich context
+- ✅ **Import Structure**: Relative imports for better module organization
+- ✅ **Type Annotations**: Comprehensive type hints throughout refactored code
+- ✅ **Documentation**: Google-style docstrings for all public methods
+- ✅ **Test Coverage**: Significantly improved test coverage across all modules
+
+### **Fixed**
+- ✅ **Import Dependencies**: Proper handling of optional dependencies (gql library)
+- ✅ **State Initialization**: Fixed initialization order in Linear adapter
+- ✅ **Error Propagation**: Better error handling and context preservation
+- ✅ **Module Boundaries**: Clear interfaces between modules
+
+### **Technical Debt Reduction**
+- ✅ **Monolithic Files**: Split large files into manageable modules
+- ✅ **Code Duplication**: Reduced duplication through better organization
+- ✅ **Test Coverage Gaps**: Comprehensive test coverage for all functionality
+- ✅ **Documentation Gaps**: Enhanced documentation throughout codebase
+
+## 🚀 **Performance & Reliability**
+
+### **Performance Improvements**
+- **Faster Development**: Smaller files load and edit faster
+- **Better IDE Performance**: Improved code navigation and intellisense
+- **Reduced Memory Usage**: More efficient module loading
+- **Faster Test Execution**: Well-organized test suite with proper isolation
+
+### **Reliability Enhancements**
+- **Comprehensive Testing**: 90%+ test coverage ensures reliability
+- **Better Error Handling**: Rich error context for debugging
+- **Regression Prevention**: Extensive test suite prevents breaking changes
+- **Production Readiness**: Enterprise-grade testing and error handling
+
+## 🔄 **Migration Guide**
+
+### **For Developers**
+The refactoring maintains **100% backward compatibility**. Existing imports continue to work:
+
+```python
+# This continues to work exactly as before
+from mcp_ticketer.adapters.linear import LinearAdapter
+
+# All existing functionality preserved
+adapter = LinearAdapter(config)
+task = await adapter.create(task_data)
+```
+
+### **For Contributors**
+- **New Module Structure**: Familiarize yourself with the new Linear adapter organization
+- **Test Requirements**: All new code must include comprehensive tests
+- **Error Handling**: Use the new centralized exception system
+- **Documentation**: Follow Google-style docstring conventions
+
+### **For CI/CD**
+- **Test Execution**: Use the new comprehensive test runner
+- **Coverage Requirements**: Maintain 90%+ test coverage
+- **Quality Gates**: All tests must pass before deployment
+
+## 📊 **Metrics & Statistics**
+
+### **Code Organization Metrics**
+- **File Count**: 1 monolithic → 5 focused modules
+- **Main File Size**: 2,389 → 812 lines (66% reduction)
+- **Module Cohesion**: Significantly improved
+- **Coupling**: Reduced through clear interfaces
+
+### **Test Coverage Metrics**
+- **Unit Tests**: 2,000+ lines across 5 test modules
+- **E2E Tests**: 1,200+ lines covering complete workflows
+- **Coverage**: 90%+ across critical functionality
+- **Test Categories**: Unit, integration, E2E, and adapter-specific
+
+### **Quality Metrics**
+- **Type Coverage**: 100% type hints in refactored modules
+- **Documentation**: 100% docstring coverage for public methods
+- **Error Handling**: Comprehensive exception coverage
+- **Code Style**: Consistent formatting and organization
+
+## 🎯 **Future Roadmap**
+
+### **Next Phase (v0.3.0)**
+- **CLI Module Refactoring**: Apply same patterns to CLI module (1,785 lines)
+- **MCP Server Refactoring**: Modularize MCP server (1,895 lines)
+- **Other Adapter Refactoring**: GitHub (1,354 lines) and JIRA (1,011 lines)
+
+### **Continuous Improvements**
+- **Performance Optimization**: Further performance enhancements
+- **Additional Test Coverage**: Expand test scenarios
+- **Documentation Enhancement**: Comprehensive developer guides
+- **CI/CD Integration**: Enhanced continuous integration
+
+## 🙏 **Acknowledgments**
+
+This release represents significant effort in improving code quality and maintainability. The comprehensive refactoring and testing work establishes a solid foundation for future development and ensures MCP Ticketer can scale confidently.
+
+### **Key Achievements**
+- ✅ **66% reduction** in main adapter file size
+- ✅ **5 focused modules** with clear responsibilities
+- ✅ **2,000+ lines of tests** ensuring reliability
+- ✅ **90%+ test coverage** across critical functionality
+- ✅ **100% backward compatibility** maintained
+- ✅ **Enterprise-grade error handling** implemented
+
+## 📞 **Support & Resources**
+
+- **Documentation**: See updated module documentation
+- **Testing**: Use `python3 tests/run_comprehensive_tests.py`
+- **Issues**: Report issues with detailed context
+- **Contributing**: Follow new testing and documentation standards
+
+---
+
+**MCP Ticketer v0.2.0 - Production-Ready with Enterprise-Grade Quality** 🚀

mcp_ticketer-0.3.2/docs/changelogs/CHANGELOG_v0.3.0.md

@@ -0,0 +1,278 @@
+# MCP Ticketer v0.3.0 - Bulletproof Configuration & Interactive Setup
+
+**Release Date**: 2025-10-24  
+**Version**: 0.3.0  
+**Type**: Minor Release  
+**Status**: ✅ **READY FOR PUBLICATION**
+
+## 🎯 **Release Overview**
+
+MCP Ticketer v0.3.0 introduces **bulletproof ticket creation** and **interactive setup** that makes configuration reliable and user-friendly. This release solves the critical issue where tickets were being created in the wrong system and provides multiple intuitive ways to configure MCP Ticketer.
+
+## 🚀 **Major Features**
+
+### **1. Bulletproof Adapter Selection**
+- **Priority-based configuration**: Clear precedence rules prevent configuration conflicts
+- **.env file support**: Robust parsing of `.env.local` and `.env` files
+- **Auto-discovery**: Automatic detection of adapter configuration from existing files
+- **Environment isolation**: Project-specific configuration without global environment pollution
+
+### **2. Interactive CLI Setup**
+- **Visual adapter menu**: Clear numbered options with descriptions and requirements
+- **Interactive credential collection**: Secure prompts for API keys and configuration
+- **Smart auto-detection**: Confirms auto-detected adapters with user approval
+- **Comprehensive guidance**: Next steps and verification instructions
+
+### **3. Command Synonyms**
+- **Multiple entry points**: `init`, `setup`, and `install` all provide identical functionality
+- **User-friendly naming**: Intuitive command names for different user types
+- **Consistent experience**: Same interactive prompts regardless of command choice
+
+### **4. Enhanced Diagnostics**
+- **Configuration validation**: Comprehensive checking of .env files and adapter settings
+- **Troubleshooting guidance**: Specific recommendations for common configuration issues
+- **Adapter testing**: Validation of adapter instantiation and credential verification
+
+## 📋 **Detailed Changes**
+
+### **🔧 Configuration System**
+
+#### **New .env File Support**
+- **Manual parsing**: No external dependencies, robust error handling
+- **Priority handling**: `.env.local` > `.env` with clear precedence
+- **Auto-detection**: Adapter type detection from available configuration keys
+- **Validation**: Comprehensive checking of required fields
+
+#### **Enhanced MCP Server**
+- **Improved adapter selection**: Priority-based configuration loading
+- **Better error handling**: Graceful fallbacks when configuration is missing
+- **Clear logging**: Configuration source tracking for debugging
+- **Robust startup**: Handles missing or invalid configuration gracefully
+
+### **🎨 User Experience**
+
+#### **Interactive Setup Wizard**
+```bash
+🚀 MCP Ticketer Setup
+Choose which ticket system you want to connect to:
+
+1. Linear
+   Modern project management (linear.app)
+   Requirements: API key and team ID
+
+2. GitHub Issues
+   GitHub repository issues
+   Requirements: Personal access token, owner, and repo
+
+3. JIRA
+   Atlassian JIRA project management
+   Requirements: Server URL, email, and API token
+
+4. Local Files (AITrackdown)
+   Store tickets in local files (no external service)
+   Requirements: None - works offline
+```
+
+#### **Smart Credential Collection**
+- **Secure input**: API keys and tokens hidden during input
+- **Helpful guidance**: Links to credential generation pages
+- **Field validation**: Ensures required fields are provided
+- **Clear descriptions**: Explains what each field is for
+
+#### **Next Steps Guidance**
+- **Configuration testing**: Shows how to run diagnostics
+- **Test ticket creation**: Provides sample commands
+- **Verification instructions**: Explains where to check for created tickets
+- **MCP client setup**: Commands for Claude, Auggie, Gemini integration
+
+### **🛠️ Technical Improvements**
+
+#### **Enhanced CLI Commands**
+- **Command synonyms**: `init`, `setup`, `install` all work identically
+- **Consistent signatures**: All commands accept the same parameters
+- **True aliases**: `setup` and `install` are pure wrappers around `init`
+- **Clear documentation**: Explicit indication of synonym relationships
+
+#### **Improved Diagnostics**
+- **Comprehensive validation**: Checks .env files, configuration files, and adapter status
+- **Specific recommendations**: Targeted guidance for common configuration issues
+- **Adapter testing**: Validates adapter instantiation and credential verification
+- **Clear reporting**: Visual tables and status indicators
+
+#### **Better Error Handling**
+- **Graceful fallbacks**: Sensible defaults when configuration is missing
+- **Specific error messages**: Clear guidance for different types of failures
+- **Recovery suggestions**: Actionable steps to resolve configuration issues
+- **Debug information**: Detailed logging for troubleshooting
+
+## 🎯 **Problem Solved: Tickets in Wrong System**
+
+### **Root Cause**
+Users like Auggie were experiencing tickets being created in MCP Ticketer's internal system (AITrackdown) instead of their intended external system (Linear, GitHub, JIRA) due to improper adapter selection.
+
+### **Solution**
+- **Priority-based configuration**: Clear rules for adapter selection
+- **.env file support**: Project-specific configuration without environment variables
+- **Interactive setup**: Guides users through proper configuration
+- **Comprehensive diagnostics**: Helps troubleshoot configuration issues
+
+### **For Auggie Users**
+```bash
+# Simple setup process
+mcp-ticketer setup
+
+# Creates .env.local with proper configuration
+# MCP_TICKETER_ADAPTER=linear
+# LINEAR_API_KEY=your_key
+# LINEAR_TEAM_ID=your_team_id
+
+# Tickets now go to Linear, not internal storage
+```
+
+## 📊 **Configuration Priority**
+
+The new configuration system follows clear priority rules:
+
+1. **Command Line Arguments** (Highest Priority)
+2. **.env/.env.local Files** (Recommended for MCP)
+3. **Project Configuration Files**
+4. **Global Configuration Files**
+5. **Auto-Discovery from existing files**
+6. **Default (aitrackdown)** (Lowest Priority)
+
+## 🧪 **Quality Assurance**
+
+### **Testing Coverage**
+- ✅ **Interactive setup flows**: All adapter types tested
+- ✅ **Configuration priority**: Verified precedence rules
+- ✅ **Command synonyms**: All three commands tested
+- ✅ **Error handling**: Graceful failure scenarios
+- ✅ **Diagnostics**: Comprehensive validation testing
+
+### **Backward Compatibility**
+- ✅ **100% compatible**: All existing configurations continue to work
+- ✅ **No breaking changes**: Existing CLI arguments and config files supported
+- ✅ **Graceful migration**: Auto-detection of existing setups
+- ✅ **Clear upgrade path**: Smooth transition to new configuration methods
+
+## 🚀 **Usage Examples**
+
+### **Quick Setup (New Users)**
+```bash
+# Interactive setup with any command
+mcp-ticketer setup
+mcp-ticketer init
+mcp-ticketer install
+
+# All provide the same guided experience
+```
+
+### **Linear Configuration**
+```bash
+# Create .env.local file
+cat > .env.local << EOF
+MCP_TICKETER_ADAPTER=linear
+LINEAR_API_KEY=lin_api_YOUR_LINEAR_API_KEY_HERE
+LINEAR_TEAM_ID=02d15669-7351-4451-9719-807576c16049
+EOF
+
+# Test configuration
+mcp-ticketer diagnose
+
+# Create test ticket
+mcp-ticketer create "Test ticket from v0.3.0"
+```
+
+### **GitHub Configuration**
+```bash
+# Interactive setup
+mcp-ticketer setup --adapter github
+
+# Or create .env.local manually
+echo "MCP_TICKETER_ADAPTER=github" > .env.local
+echo "GITHUB_TOKEN=your_token" >> .env.local
+echo "GITHUB_OWNER=your_username" >> .env.local
+echo "GITHUB_REPO=your_repository" >> .env.local
+```
+
+## 🔍 **Troubleshooting**
+
+### **Enhanced Diagnostics**
+```bash
+# Comprehensive configuration check
+mcp-ticketer diagnose
+
+# Shows:
+# - .env file status
+# - Configuration source
+# - Adapter validation
+# - Credential verification
+# - Specific recommendations
+```
+
+### **Common Issues Resolved**
+- ✅ **Tickets in wrong system**: Clear adapter selection
+- ✅ **Missing credentials**: Interactive credential collection
+- ✅ **Configuration conflicts**: Priority-based resolution
+- ✅ **Setup confusion**: Multiple intuitive command names
+
+## 📈 **Impact**
+
+### **For Users**
+- ✅ **Reliable ticket creation**: Tickets go to the intended system
+- ✅ **Easy setup**: Interactive prompts guide through configuration
+- ✅ **Multiple entry points**: Use `init`, `setup`, or `install`
+- ✅ **Clear troubleshooting**: Comprehensive diagnostics and guidance
+
+### **For AI Clients (Auggie, Claude, etc.)**
+- ✅ **Bulletproof integration**: Reliable adapter selection
+- ✅ **Project-specific config**: .env.local files for each project
+- ✅ **Easy MCP setup**: Clear configuration for MCP servers
+- ✅ **Consistent behavior**: Predictable ticket creation
+
+### **For Developers**
+- ✅ **Better architecture**: Clean separation of configuration concerns
+- ✅ **Maintainable code**: Single implementation with command aliases
+- ✅ **Comprehensive testing**: Extensive validation of configuration flows
+- ✅ **Clear documentation**: Well-documented configuration system
+
+## 🏆 **Migration Guide**
+
+### **From v0.2.x**
+No migration required! v0.3.0 is 100% backward compatible.
+
+**Optional improvements:**
+1. **Use .env.local files** instead of environment variables
+2. **Try interactive setup** with `mcp-ticketer setup`
+3. **Run diagnostics** to verify configuration: `mcp-ticketer diagnose`
+
+### **For New Installations**
+```bash
+# Install latest version
+pip install mcp-ticketer==0.3.0
+
+# Interactive setup
+mcp-ticketer setup
+
+# Test configuration
+mcp-ticketer diagnose
+mcp-ticketer create "Test ticket"
+```
+
+## 🎉 **Conclusion**
+
+MCP Ticketer v0.3.0 represents a **major improvement in reliability and user experience**:
+
+- ✅ **Bulletproof ticket creation** ensures tickets go to the right system
+- ✅ **Interactive setup** makes configuration accessible to all users
+- ✅ **Multiple command names** provide intuitive entry points
+- ✅ **Comprehensive diagnostics** enable easy troubleshooting
+- ✅ **100% backward compatibility** ensures smooth upgrades
+
+**This release solves the critical adapter selection issues while maintaining the power and flexibility that makes MCP Ticketer the universal ticket management interface for AI agents.**
+
+---
+
+**Upgrade Command**: `pip install --upgrade mcp-ticketer==0.3.0`  
+**Documentation**: Updated guides and examples available  
+**Support**: Enhanced diagnostics and troubleshooting tools included