# Changelog

All notable changes to the CK JIRA Integration expansion pack 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).

## [1.4.0] - 2025-01-07

### Changed

- 🎯 **Unified JIRA Agent** - Consolidated two agents into one for simpler user experience
  - Combined Alex Chen (jira-orchestrator) and Sarah Martinez (jira-specialist) into single unified agent
  - Single `@jira` command now handles all operations
  - Preserves all functionality from both agents
  - Seamless handling of both agile coaching and technical operations
  - No more handoff confusion - one assistant for everything

### Improved

- Simplified mental model - users interact with one assistant instead of two
- Cleaner command structure without duplicate functionality
- Maintained all capabilities while reducing complexity
- Better user experience with unified interaction flow

### Migration Notes

- Users upgrading from v1.3.0 or earlier: Use `@jira` instead of `@jira-orchestrator` or `@jira-specialist`
- All existing functionality remains available through the unified interface
- Configuration and setup processes remain unchanged

## [1.3.0] - 2025-01-04

### Added

- 🧠 **Advanced Context Management** - Maintains conversation state across operations
  - Session memory and entity resolution ("the story" = current story)
  - Pattern learning adapts to user preferences
  - Smart suggestions based on context
  - Persistent storage with versioning

- ⚡ **Intelligent Prompt Optimization** - Dynamic prompt enhancement
  - Context-aware query generation
  - Performance tracking and A/B testing
  - Adaptive complexity based on user expertise
  - Comprehensive prompt library with 30+ optimized templates

- 💬 **Multi-Turn Reasoning** - Natural conversation flows
  - Progressive disclosure of complexity
  - Decision trees for structured choices
  - Checkpoint recovery for interrupted operations
  - Example flows for epic breakdown and sprint planning

- 🔄 **Smart Checkpointing** - Never lose work
  - Automatic progress saving
  - Seamless operation resumption
  - Full context restoration
  - Rollback support for safety

- 📊 **Enhanced Learning System** - Continuous improvement
  - Pattern recognition and success tracking
  - Anonymous metrics only - no personal data
  - Adaptive behavior based on usage
  - Performance optimization insights

### Technical Additions

- 12 new LLM-native utility modules:
  - Context Management: context-manager, context-store, context-analyzer, context-templates
  - Prompt Optimization: prompt-optimizer, prompt-library, prompt-analyzer, prompt-chains
  - Multi-turn Reasoning: reasoning-engine, decision-trees, checkpoint-manager, interaction-flows
- Enhanced example workflows demonstrating new capabilities
- Comprehensive error recovery mechanisms

### Improved

- Epic breakdown now uses multi-turn conversations for better user experience
- Sprint planning adapts to team patterns and historical data
- Sync operations can be resumed after interruptions
- Daily standups personalized based on team preferences
- Bug investigation uses intelligent decision flows

### Developer Experience

- Clear separation of concerns in utility modules
- Extensive documentation in each module
- Example usage patterns for all new capabilities
- Integration points well-defined for extensibility

## [1.2.0] - 2025-01-04

### Added

- 🎯 Visual sync dashboard with traffic light system for instant health visibility
- 🚀 Smart setup wizard with auto-detection (2-5 minute setup vs 30 minutes)
- 📚 Progressive help system that shows features based on user experience
- 📊 Privacy-first learning system for continuous improvement
- 🎨 5 adaptive templates that intelligently adjust to context
- 🧠 Smart defaults based on team size, project type, and usage patterns

### Changed

- Consolidated 16 overlapping tasks into 5 clear, purposeful tasks
- Reduced 25 specific templates to 6 intelligent adaptive templates
- Simplified agent startup from overwhelming list to friendly conversation
- Updated all workflows to reference new consolidated task structure
- Renamed `jira.md` task to `jira-operations.md` to avoid confusion with agent

### Improved

- Setup time reduced by 83% through auto-detection and smart defaults
- Cognitive load reduced by 70% through consolidation
- Natural language understanding - no commands to memorize
- Clear, actionable error messages with solutions
- Better field mapping with automatic custom field detection

### Developer Experience

- Added comprehensive test suite for expansion pack integrity
- Created unified README focused on end-user needs
- Implemented learning hooks throughout for usage insights
- Added visual examples and clear workflow documentation

## [1.1.0] - 2024-12-23

### Added

- Enhanced three-way sync intelligence (Git ↔ BMAD ↔ JIRA)
- Universal sync analysis utilities
- Correlation analysis for comprehensive alignment
- Git-based standup intelligence
- Advanced daily sync capabilities

### Improved

- Security best practices throughout
- Pagination support for large result sets
- Better error handling and recovery
- Standardized formatting utilities

## [1.0.0] - 2024-12-01

### Initial Release

- Core JIRA integration via Atlassian MCP
- Story synchronization (BMAD → JIRA)
- Bug analysis and tracking workflows
- Team standup facilitation
- Sprint reporting and analytics
- Backlog grooming assistance
- Roadmap planning and visualization

---

_Compatible with BMAD Method v4.0.0+_