[
  {
    "hash": "a1b2c3d",
    "author": "Sarah Johnson <[email protected]>",
    "date": "2024-01-15T14:30:22Z",
    "message": "feat(auth): add OAuth2 integration with Google and GitHub\n\nImplement OAuth2 authentication flow supporting Google and GitHub providers.\nUsers can now sign in using their existing social media accounts, improving\nuser experience and reducing password fatigue.\n\n- Add OAuth2 client configuration\n- Implement authorization code flow\n- Add user profile mapping from providers\n- Include comprehensive error handling\n\nCloses #123\nResolves #145"
  },
  {
    "hash": "e4f5g6h",
    "author": "Mike Chen <[email protected]>",
    "date": "2024-01-15T13:45:18Z",
    "message": "fix(api): resolve race condition in user creation endpoint\n\nFixed a race condition that occurred when multiple requests attempted\nto create users with the same email address simultaneously. This was\ncausing duplicate user records in some edge cases.\n\n- Added database unique constraint on email field\n- Implemented proper error handling for constraint violations\n- Added retry logic with exponential backoff\n\nFixes #234"
  },
  {
    "hash": "i7j8k9l",
    "author": "Emily Davis <[email protected]>",
    "date": "2024-01-15T12:20:45Z",
    "message": "docs(readme): update installation and deployment instructions\n\nUpdated README with comprehensive installation guide including:\n- Docker setup instructions\n- Environment variable configuration\n- Database migration steps\n- Troubleshooting common issues"
  },
  {
    "hash": "m1n2o3p",
    "author": "David Wilson <[email protected]>",
    "date": "2024-01-15T11:15:30Z",
    "message": "feat(ui)!: redesign dashboard with new component library\n\nComplete redesign of the user dashboard using our new component library.\nThis provides better accessibility, improved mobile responsiveness, and\na more modern user interface.\n\nBREAKING CHANGE: The dashboard API endpoints have changed structure.\nFrontend clients must update to use the new /v2/dashboard endpoints.\nThe legacy /v1/dashboard endpoints will be removed in version 3.0.0.\n\n- Implement new Card, Grid, and Chart components\n- Add responsive breakpoints for mobile devices\n- Improve accessibility with proper ARIA labels\n- Add dark mode support\n\nCloses #345, #367, #389"
  },
  {
    "hash": "q4r5s6t",
    "author": "Lisa Rodriguez <[email protected]>",
    "date": "2024-01-15T10:45:12Z",
    "message": "fix(db): optimize slow query in user search functionality\n\nOptimized the user search query that was causing performance issues\non databases with large user counts. Query time reduced from 2.5s to 150ms.\n\n- Added composite index on (email, username, created_at)\n- Refactored query to use more efficient JOIN structure\n- Added query result caching for common search patterns\n\nFixes #456"
  },
  {
    "hash": "u7v8w9x",
    "author": "Tom Anderson <[email protected]>",
    "date": "2024-01-15T09:30:55Z",
    "message": "chore(deps): upgrade React to version 18.2.0\n\nUpgrade React and related dependencies to latest stable versions.\nThis includes performance improvements and new concurrent features.\n\n- React: 17.0.2 → 18.2.0\n- React-DOM: 17.0.2 → 18.2.0\n- React-Router: 6.8.0 → 6.8.1\n- Updated all peer dependencies"
  },
  {
    "hash": "y1z2a3b",
    "author": "Jennifer Kim <[email protected]>",
    "date": "2024-01-15T08:15:33Z",
    "message": "test(auth): add comprehensive tests for OAuth flow\n\nAdded unit and integration tests for the OAuth2 authentication system\nto ensure reliability and prevent regressions.\n\n- Unit tests for OAuth client configuration\n- Integration tests for complete auth flow\n- Mock providers for testing without external dependencies\n- Error scenario testing\n\nTest coverage increased from 72% to 89% for auth module."
  },
  {
    "hash": "c4d5e6f",
    "author": "Alex Thompson <[email protected]>",
    "date": "2024-01-15T07:45:20Z",
    "message": "perf(image): implement WebP compression reducing size by 40%\n\nReplaced PNG compression with WebP format for uploaded images.\nThis reduces average image file sizes by 40% while maintaining\nvisual quality, improving page load times and reducing bandwidth costs.\n\n- Add WebP encoding support\n- Implement fallback to PNG for older browsers\n- Add quality settings configuration\n- Update image serving endpoints\n\nPerformance improvement: Page load time reduced by 25% on average."
  },
  {
    "hash": "g7h8i9j",
    "author": "Rachel Green <[email protected]>",
    "date": "2024-01-14T16:20:10Z",
    "message": "feat(payment): add Stripe payment processor integration\n\nIntegrate Stripe as a payment processor to support credit card payments.\nThis enables users to purchase premium features and subscriptions.\n\n- Add Stripe SDK integration\n- Implement payment intent flow\n- Add webhook handling for payment status updates\n- Include comprehensive error handling and logging\n- Add payment method management for users\n\nCloses #567\nCo-authored-by: Payment Team <[email protected]>"
  },
  {
    "hash": "k1l2m3n",
    "author": "Chris Martinez <[email protected]>",
    "date": "2024-01-14T15:30:45Z",
    "message": "fix(ui): resolve mobile navigation menu overflow issue\n\nFixed navigation menu overflow on mobile devices where long menu items\nwere being cut off and causing horizontal scrolling issues.\n\n- Implement responsive text wrapping\n- Add horizontal scrolling for overflowing content\n- Improve touch targets for better mobile usability\n- Fix z-index conflicts with dropdown menus\n\nFixes #678\nTested on iOS Safari, Chrome Mobile, and Firefox Mobile"
  },
  {
    "hash": "o4p5q6r",
    "author": "Anna Kowalski <[email protected]>",
    "date": "2024-01-14T14:20:15Z",
    "message": "refactor(api): extract validation logic into reusable middleware\n\nExtracted common validation logic from individual API endpoints into\nreusable middleware functions to reduce code duplication and improve\nmaintainability.\n\n- Create validation middleware for common patterns\n- Refactor user, product, and order endpoints\n- Add comprehensive error messages\n- Improve validation performance by 30%"
  },
  {
    "hash": "s7t8u9v",
    "author": "Kevin Park <[email protected]>",
    "date": "2024-01-14T13:10:30Z",
    "message": "feat(search): implement fuzzy search with Elasticsearch\n\nImplemented fuzzy search functionality using Elasticsearch to provide\nbetter search results for users with typos or partial matches.\n\n- Integrate Elasticsearch cluster\n- Add fuzzy matching with configurable distance\n- Implement search result ranking algorithm\n- Add search analytics and logging\n\nSearch accuracy improved by 35% in user testing.\nCloses #789"
  },
  {
    "hash": "w1x2y3z",
    "author": "Security Team <[email protected]>",
    "date": "2024-01-14T12:45:22Z",
    "message": "fix(security): patch SQL injection vulnerability in reports\n\nPatched SQL injection vulnerability in the reports generation endpoint\nthat could allow unauthorized access to sensitive data.\n\n- Implement parameterized queries for all report filters\n- Add input sanitization and validation\n- Update security audit logging\n- Add automated security tests\n\nSeverity: HIGH - CVE-2024-0001\nReported by: External security researcher"
  }
]

a1b2c3d feat(auth): add OAuth2 integration with Google and GitHub
e4f5g6h fix(api): resolve race condition in user creation endpoint
i7j8k9l docs(readme): update installation and deployment instructions
m1n2o3p feat(ui)!: redesign dashboard with new component library
q4r5s6t fix(db): optimize slow query in user search functionality
u7v8w9x chore(deps): upgrade React to version 18.2.0
y1z2a3b test(auth): add comprehensive tests for OAuth flow
c4d5e6f perf(image): implement WebP compression reducing size by 40%
g7h8i9j feat(payment): add Stripe payment processor integration
k1l2m3n fix(ui): resolve mobile navigation menu overflow issue
o4p5q6r refactor(api): extract validation logic into reusable middleware
s7t8u9v feat(search): implement fuzzy search with Elasticsearch
w1x2y3z fix(security): patch SQL injection vulnerability in reports
a4b5c6d build(ci): add automated security scanning to deployment pipeline
e7f8g9h feat(notification): add email and SMS notification system
i1j2k3l fix(payment): handle expired credit cards gracefully
m4n5o6p docs(api): generate OpenAPI specification for all endpoints
q7r8s9t chore(cleanup): remove deprecated user preference API endpoints
u1v2w3x feat(admin)!: redesign admin panel with role-based permissions
y4z5a6b fix(db): resolve deadlock issues in concurrent transactions
c7d8e9f perf(cache): implement Redis caching for frequent database queries
g1h2i3j feat(mobile): add biometric authentication support
k4l5m6n fix(api): validate input parameters to prevent XSS attacks
o7p8q9r style(ui): update color palette and typography consistency
s1t2u3v feat(analytics): integrate Google Analytics 4 tracking
w4x5y6z fix(memory): resolve memory leak in image processing service
a7b8c9d ci(github): add automated testing for all pull requests
e1f2g3h feat(export): add CSV and PDF export functionality for reports
i4j5k6l fix(ui): resolve accessibility issues with screen readers
m7n8o9p refactor(auth): consolidate authentication logic into single service

commit a1b2c3d4e5f6789012345678901234567890abcd
Author: Sarah Johnson <[email protected]>
Date:   Mon Jan 15 14:30:22 2024 +0000

    feat(auth): add OAuth2 integration with Google and GitHub
    
    Implement OAuth2 authentication flow supporting Google and GitHub providers.
    Users can now sign in using their existing social media accounts, improving
    user experience and reducing password fatigue.
    
    - Add OAuth2 client configuration
    - Implement authorization code flow
    - Add user profile mapping from providers
    - Include comprehensive error handling
    
    Closes #123
    Resolves #145

commit e4f5g6h7i8j9012345678901234567890123abcdef
Author: Mike Chen <[email protected]>
Date:   Mon Jan 15 13:45:18 2024 +0000

    fix(api): resolve race condition in user creation endpoint
    
    Fixed a race condition that occurred when multiple requests attempted
    to create users with the same email address simultaneously. This was
    causing duplicate user records in some edge cases.
    
    - Added database unique constraint on email field
    - Implemented proper error handling for constraint violations
    - Added retry logic with exponential backoff
    
    Fixes #234

commit i7j8k9l0m1n2345678901234567890123456789abcd
Author: Emily Davis <[email protected]>
Date:   Mon Jan 15 12:20:45 2024 +0000

    docs(readme): update installation and deployment instructions
    
    Updated README with comprehensive installation guide including:
    - Docker setup instructions
    - Environment variable configuration
    - Database migration steps
    - Troubleshooting common issues

commit m1n2o3p4q5r6789012345678901234567890abcdefg
Author: David Wilson <[email protected]>
Date:   Mon Jan 15 11:15:30 2024 +0000

    feat(ui)!: redesign dashboard with new component library
    
    Complete redesign of the user dashboard using our new component library.
    This provides better accessibility, improved mobile responsiveness, and
    a more modern user interface.
    
    BREAKING CHANGE: The dashboard API endpoints have changed structure.
    Frontend clients must update to use the new /v2/dashboard endpoints.
    The legacy /v1/dashboard endpoints will be removed in version 3.0.0.
    
    - Implement new Card, Grid, and Chart components
    - Add responsive breakpoints for mobile devices
    - Improve accessibility with proper ARIA labels
    - Add dark mode support
    
    Closes #345, #367, #389

commit q4r5s6t7u8v9012345678901234567890123456abcd
Author: Lisa Rodriguez <[email protected]>
Date:   Mon Jan 15 10:45:12 2024 +0000

    fix(db): optimize slow query in user search functionality
    
    Optimized the user search query that was causing performance issues
    on databases with large user counts. Query time reduced from 2.5s to 150ms.
    
    - Added composite index on (email, username, created_at)
    - Refactored query to use more efficient JOIN structure
    - Added query result caching for common search patterns
    
    Fixes #456

commit u7v8w9x0y1z2345678901234567890123456789abcde
Author: Tom Anderson <[email protected]>
Date:   Mon Jan 15 09:30:55 2024 +0000

    chore(deps): upgrade React to version 18.2.0
    
    Upgrade React and related dependencies to latest stable versions.
    This includes performance improvements and new concurrent features.
    
    - React: 17.0.2 → 18.2.0
    - React-DOM: 17.0.2 → 18.2.0  
    - React-Router: 6.8.0 → 6.8.1
    - Updated all peer dependencies

commit y1z2a3b4c5d6789012345678901234567890abcdefg
Author: Jennifer Kim <[email protected]>
Date:   Mon Jan 15 08:15:33 2024 +0000

    test(auth): add comprehensive tests for OAuth flow
    
    Added unit and integration tests for the OAuth2 authentication system
    to ensure reliability and prevent regressions.
    
    - Unit tests for OAuth client configuration
    - Integration tests for complete auth flow
    - Mock providers for testing without external dependencies
    - Error scenario testing
    
    Test coverage increased from 72% to 89% for auth module.

commit c4d5e6f7g8h9012345678901234567890123456abcd
Author: Alex Thompson <[email protected]>
Date:   Mon Jan 15 07:45:20 2024 +0000

    perf(image): implement WebP compression reducing size by 40%
    
    Replaced PNG compression with WebP format for uploaded images.
    This reduces average image file sizes by 40% while maintaining
    visual quality, improving page load times and reducing bandwidth costs.
    
    - Add WebP encoding support
    - Implement fallback to PNG for older browsers  
    - Add quality settings configuration
    - Update image serving endpoints
    
    Performance improvement: Page load time reduced by 25% on average.

commit g7h8i9j0k1l2345678901234567890123456789abcde
Author: Rachel Green <[email protected]>
Date:   Sun Jan 14 16:20:10 2024 +0000

    feat(payment): add Stripe payment processor integration
    
    Integrate Stripe as a payment processor to support credit card payments.
    This enables users to purchase premium features and subscriptions.
    
    - Add Stripe SDK integration
    - Implement payment intent flow
    - Add webhook handling for payment status updates
    - Include comprehensive error handling and logging
    - Add payment method management for users
    
    Closes #567
    Co-authored-by: Payment Team <[email protected]>

commit k1l2m3n4o5p6789012345678901234567890abcdefg
Author: Chris Martinez <[email protected]>
Date:   Sun Jan 14 15:30:45 2024 +0000

    fix(ui): resolve mobile navigation menu overflow issue
    
    Fixed navigation menu overflow on mobile devices where long menu items
    were being cut off and causing horizontal scrolling issues.
    
    - Implement responsive text wrapping
    - Add horizontal scrolling for overflowing content
    - Improve touch targets for better mobile usability
    - Fix z-index conflicts with dropdown menus
    
    Fixes #678
    Tested on iOS Safari, Chrome Mobile, and Firefox Mobile

{
  "release_name": "Winter 2024 Release",
  "version": "2.3.0",
  "target_date": "2024-02-15T10:00:00Z",
  "features": [
    {
      "id": "AUTH-123",
      "title": "OAuth2 Integration",
      "description": "Add support for Google and GitHub OAuth2 authentication",
      "type": "feature",
      "assignee": "[email protected]",
      "status": "ready",
      "pull_request_url": "https://github.com/ourapp/backend/pull/234",
      "issue_url": "https://github.com/ourapp/backend/issues/123",
      "risk_level": "medium",
      "test_coverage_required": 85.0,
      "test_coverage_actual": 89.5,
      "requires_migration": false,
      "breaking_changes": [],
      "dependencies": ["AUTH-124"],
      "qa_approved": true,
      "security_approved": true,
      "pm_approved": true
    },
    {
      "id": "UI-345",
      "title": "Dashboard Redesign",
      "description": "Complete redesign of user dashboard with new component library",
      "type": "breaking_change", 
      "assignee": "[email protected]",
      "status": "ready",
      "pull_request_url": "https://github.com/ourapp/frontend/pull/456",
      "issue_url": "https://github.com/ourapp/frontend/issues/345",
      "risk_level": "high",
      "test_coverage_required": 90.0,
      "test_coverage_actual": 92.3,
      "requires_migration": true,
      "migration_complexity": "moderate",
      "breaking_changes": [
        "Dashboard API endpoints changed from /v1/dashboard to /v2/dashboard",
        "Dashboard widget configuration format updated"
      ],
      "dependencies": [],
      "qa_approved": true,
      "security_approved": true,
      "pm_approved": true
    },
    {
      "id": "PAY-567",
      "title": "Stripe Payment Integration",
      "description": "Add Stripe as payment processor for premium features",
      "type": "feature",
      "assignee": "[email protected]",
      "status": "ready",
      "pull_request_url": "https://github.com/ourapp/backend/pull/678",
      "issue_url": "https://github.com/ourapp/backend/issues/567",
      "risk_level": "high",
      "test_coverage_required": 95.0,
      "test_coverage_actual": 97.2,
      "requires_migration": true,
      "migration_complexity": "complex",
      "breaking_changes": [],
      "dependencies": ["SEC-890"],
      "qa_approved": true,
      "security_approved": true,
      "pm_approved": true
    },
    {
      "id": "SEARCH-789",
      "title": "Elasticsearch Fuzzy Search",
      "description": "Implement fuzzy search functionality with Elasticsearch",
      "type": "feature",
      "assignee": "[email protected]",
      "status": "in_progress",
      "pull_request_url": "https://github.com/ourapp/backend/pull/890",
      "issue_url": "https://github.com/ourapp/backend/issues/789",
      "risk_level": "medium",
      "test_coverage_required": 80.0,
      "test_coverage_actual": 76.5,
      "requires_migration": true,
      "migration_complexity": "moderate",
      "breaking_changes": [],
      "dependencies": ["INFRA-234"],
      "qa_approved": false,
      "security_approved": true,
      "pm_approved": true
    },
    {
      "id": "MOBILE-456",
      "title": "Biometric Authentication",
      "description": "Add fingerprint and face ID support for mobile apps",
      "type": "feature",
      "assignee": "[email protected]",
      "status": "blocked",
      "pull_request_url": null,
      "issue_url": "https://github.com/ourapp/mobile/issues/456",
      "risk_level": "medium",
      "test_coverage_required": 85.0,
      "test_coverage_actual": null,
      "requires_migration": false,
      "breaking_changes": [],
      "dependencies": ["AUTH-123"],
      "qa_approved": false,
      "security_approved": false,
      "pm_approved": true
    },
    {
      "id": "PERF-678",
      "title": "Redis Caching Implementation",
      "description": "Implement Redis caching for frequently accessed data",
      "type": "performance",
      "assignee": "[email protected]",
      "status": "ready",
      "pull_request_url": "https://github.com/ourapp/backend/pull/901",
      "issue_url": "https://github.com/ourapp/backend/issues/678",
      "risk_level": "low",
      "test_coverage_required": 75.0,
      "test_coverage_actual": 82.1,
      "requires_migration": false,
      "breaking_changes": [],
      "dependencies": [],
      "qa_approved": true,
      "security_approved": false,
      "pm_approved": true
    }
  ],
  "quality_gates": [
    {
      "name": "Unit Test Coverage",
      "required": true,
      "status": "ready",
      "details": "Overall test coverage above 85% threshold",
      "threshold": 85.0,
      "actual_value": 87.3
    },
    {
      "name": "Integration Tests",
      "required": true,
      "status": "ready",
      "details": "All integration tests passing"
    },
    {
      "name": "Security Scan",
      "required": true,
      "status": "pending",
      "details": "Waiting for security team review of payment integration"
    },
    {
      "name": "Performance Testing",
      "required": true,
      "status": "ready",
      "details": "Load testing shows 99th percentile response time under 500ms"
    },
    {
      "name": "Documentation Review",
      "required": true,
      "status": "pending",
      "details": "API documentation needs update for dashboard changes"
    },
    {
      "name": "Dependency Audit",
      "required": true,
      "status": "ready",
      "details": "No high or critical vulnerabilities found"
    }
  ],
  "stakeholders": [
    {
      "name": "Engineering Team",
      "role": "developer",
      "contact": "[email protected]",
      "notification_type": "slack",
      "critical_path": true
    },
    {
      "name": "Product Team",
      "role": "pm",
      "contact": "[email protected]",
      "notification_type": "email",
      "critical_path": true
    },
    {
      "name": "QA Team",
      "role": "qa",
      "contact": "[email protected]",
      "notification_type": "slack",
      "critical_path": true
    },
    {
      "name": "Security Team",
      "role": "security",
      "contact": "[email protected]",
      "notification_type": "email",
      "critical_path": false
    },
    {
      "name": "Customer Support",
      "role": "support",
      "contact": "[email protected]",
      "notification_type": "email",
      "critical_path": false
    },
    {
      "name": "Sales Team",
      "role": "sales",
      "contact": "[email protected]",
      "notification_type": "email",
      "critical_path": false
    },
    {
      "name": "Beta Users",
      "role": "customer",
      "contact": "[email protected]",
      "notification_type": "email",
      "critical_path": false
    }
  ],
  "rollback_steps": [
    {
      "order": 1,
      "description": "Alert incident response team and stakeholders",
      "estimated_time": "2 minutes",
      "risk_level": "low",
      "verification": "Confirm team is aware and responding via Slack"
    },
    {
      "order": 2,
      "description": "Switch load balancer to previous version",
      "command": "kubectl patch service app --patch '{\"spec\": {\"selector\": {\"version\": \"v2.2.1\"}}}'",
      "estimated_time": "30 seconds",
      "risk_level": "low",
      "verification": "Check traffic routing to previous version via monitoring dashboard"
    },
    {
      "order": 3,
      "description": "Disable new feature flags",
      "command": "curl -X POST https://api.example.com/feature-flags/oauth2/disable",
      "estimated_time": "1 minute",
      "risk_level": "low",
      "verification": "Verify feature flags are disabled in admin panel"
    },
    {
      "order": 4,
      "description": "Roll back database migrations",
      "command": "python manage.py migrate app 0042",
      "estimated_time": "10 minutes",
      "risk_level": "high",
      "verification": "Verify database schema and run data integrity checks"
    },
    {
      "order": 5,
      "description": "Clear Redis cache",
      "command": "redis-cli FLUSHALL",
      "estimated_time": "30 seconds",
      "risk_level": "medium",
      "verification": "Confirm cache is cleared and application rebuilds cache properly"
    },
    {
      "order": 6,
      "description": "Verify application health",
      "estimated_time": "5 minutes",
      "risk_level": "low",
      "verification": "Check health endpoints, error rates, and core user workflows"
    },
    {
      "order": 7,
      "description": "Update status page and notify users",
      "estimated_time": "5 minutes",
      "risk_level": "low",
      "verification": "Confirm status page updated and notifications sent"
    }
  ]
}

#!/usr/bin/env python3
"""
Changelog Generator

Parses git log output in conventional commits format and generates structured changelogs
in multiple formats (Markdown, Keep a Changelog). Groups commits by type, extracts scope,
links to PRs/issues, and highlights breaking changes.

Input: git log text (piped from git log) or JSON array of commits
Output: formatted CHANGELOG.md section + release summary stats
"""

import argparse
import json
import re
import sys
from collections import defaultdict, Counter
from datetime import datetime
from typing import Dict, List, Optional, Tuple, Union


class ConventionalCommit:
    """Represents a parsed conventional commit."""
    
    def __init__(self, raw_message: str, commit_hash: str = "", author: str = "", 
                 date: str = "", merge_info: Optional[str] = None):
        self.raw_message = raw_message
        self.commit_hash = commit_hash
        self.author = author
        self.date = date
        self.merge_info = merge_info
        
        # Parse the commit message
        self.type = ""
        self.scope = ""
        self.description = ""
        self.body = ""
        self.footers = []
        self.is_breaking = False
        self.breaking_change_description = ""
        
        self._parse_commit_message()
    
    def _parse_commit_message(self):
        """Parse conventional commit format."""
        lines = self.raw_message.split('\n')
        header = lines[0] if lines else ""
        
        # Parse header: type(scope): description
        header_pattern = r'^(\w+)(\([^)]+\))?(!)?:\s*(.+)$'
        match = re.match(header_pattern, header)
        
        if match:
            self.type = match.group(1).lower()
            scope_match = match.group(2)
            self.scope = scope_match[1:-1] if scope_match else ""  # Remove parentheses
            self.is_breaking = bool(match.group(3))  # ! indicates breaking change
            self.description = match.group(4).strip()
        else:
            # Fallback for non-conventional commits
            self.type = "chore"
            self.description = header
        
        # Parse body and footers
        if len(lines) > 1:
            body_lines = []
            footer_lines = []
            in_footer = False
            
            for line in lines[1:]:
                if not line.strip():
                    continue
                    
                # Check if this is a footer (KEY: value or KEY #value format)
                footer_pattern = r'^([A-Z-]+):\s*(.+)$|^([A-Z-]+)\s+#(\d+)$'
                if re.match(footer_pattern, line):
                    in_footer = True
                    footer_lines.append(line)
                    
                    # Check for breaking change
                    if line.startswith('BREAKING CHANGE:'):
                        self.is_breaking = True
                        self.breaking_change_description = line[16:].strip()
                else:
                    if in_footer:
                        # Continuation of footer
                        footer_lines.append(line)
                    else:
                        body_lines.append(line)
            
            self.body = '\n'.join(body_lines).strip()
            self.footers = footer_lines
    
    def extract_issue_references(self) -> List[str]:
        """Extract issue/PR references like #123, fixes #456, etc."""
        text = f"{self.description} {self.body} {' '.join(self.footers)}"
        
        # Common patterns for issue references
        patterns = [
            r'#(\d+)',  # Simple #123
            r'(?:close[sd]?|fix(?:e[sd])?|resolve[sd]?)\s+#(\d+)',  # closes #123
            r'(?:close[sd]?|fix(?:e[sd])?|resolve[sd]?)\s+(\w+/\w+)?#(\d+)'  # fixes repo#123
        ]
        
        references = []
        for pattern in patterns:
            matches = re.findall(pattern, text, re.IGNORECASE)
            for match in matches:
                if isinstance(match, tuple):
                    # Handle tuple results from more complex patterns
                    ref = match[-1] if match[-1] else match[0]
                else:
                    ref = match
                if ref and ref not in references:
                    references.append(ref)
        
        return references
    
    def get_changelog_category(self) -> str:
        """Map commit type to changelog category."""
        category_map = {
            'feat': 'Added',
            'add': 'Added',
            'fix': 'Fixed',
            'bugfix': 'Fixed',
            'security': 'Security',
            'perf': 'Fixed',  # Performance improvements go to Fixed
            'refactor': 'Changed',
            'style': 'Changed',
            'docs': 'Changed',
            'test': None,  # Tests don't appear in user-facing changelog
            'ci': None,
            'build': None,
            'chore': None,
            'revert': 'Fixed',
            'remove': 'Removed',
            'deprecate': 'Deprecated'
        }
        
        return category_map.get(self.type, 'Changed')


class ChangelogGenerator:
    """Main changelog generator class."""
    
    def __init__(self):
        self.commits: List[ConventionalCommit] = []
        self.version = "Unreleased"
        self.date = datetime.now().strftime("%Y-%m-%d")
        self.base_url = ""
        
    def parse_git_log_output(self, git_log_text: str):
        """Parse git log output into ConventionalCommit objects."""
        # Try to detect format based on patterns in the text
        lines = git_log_text.strip().split('\n')
        
        if not lines or not lines[0]:
            return
            
        # Format 1: Simple oneline format (hash message)
        oneline_pattern = r'^([a-f0-9]{7,40})\s+(.+)$'
        
        # Format 2: Full format with metadata
        full_pattern = r'^commit\s+([a-f0-9]+)'
        
        current_commit = None
        commit_buffer = []
        
        for line in lines:
            line = line.strip()
            if not line:
                continue
                
            # Check if this is a new commit (oneline format)
            oneline_match = re.match(oneline_pattern, line)
            if oneline_match:
                # Process previous commit
                if current_commit:
                    self.commits.append(current_commit)
                
                # Start new commit
                commit_hash = oneline_match.group(1)
                message = oneline_match.group(2)
                current_commit = ConventionalCommit(message, commit_hash)
                continue
            
            # Check if this is a new commit (full format)
            full_match = re.match(full_pattern, line)
            if full_match:
                # Process previous commit
                if current_commit:
                    commit_message = '\n'.join(commit_buffer).strip()
                    if commit_message:
                        current_commit = ConventionalCommit(commit_message, current_commit.commit_hash, 
                                                          current_commit.author, current_commit.date)
                    self.commits.append(current_commit)
                
                # Start new commit
                commit_hash = full_match.group(1)
                current_commit = ConventionalCommit("", commit_hash)
                commit_buffer = []
                continue
            
            # Parse metadata lines in full format
            if current_commit and not current_commit.raw_message:
                if line.startswith('Author:'):
                    current_commit.author = line[7:].strip()
                elif line.startswith('Date:'):
                    current_commit.date = line[5:].strip()
                elif line.startswith('Merge:'):
                    current_commit.merge_info = line[6:].strip()
                elif line.startswith('    '):
                    # Commit message line (indented)
                    commit_buffer.append(line[4:])  # Remove 4-space indent
            
        # Process final commit
        if current_commit:
            if commit_buffer:
                commit_message = '\n'.join(commit_buffer).strip()
                current_commit = ConventionalCommit(commit_message, current_commit.commit_hash,
                                                  current_commit.author, current_commit.date)
            self.commits.append(current_commit)
    
    def parse_json_commits(self, json_data: Union[str, List[Dict]]):
        """Parse commits from JSON format."""
        if isinstance(json_data, str):
            data = json.loads(json_data)
        else:
            data = json_data
        
        for commit_data in data:
            commit = ConventionalCommit(
                raw_message=commit_data.get('message', ''),
                commit_hash=commit_data.get('hash', ''),
                author=commit_data.get('author', ''),
                date=commit_data.get('date', '')
            )
            self.commits.append(commit)
    
    def group_commits_by_category(self) -> Dict[str, List[ConventionalCommit]]:
        """Group commits by changelog category."""
        categories = defaultdict(list)
        
        for commit in self.commits:
            category = commit.get_changelog_category()
            if category:  # Skip None categories (internal changes)
                categories[category].append(commit)
        
        return dict(categories)
    
    def generate_markdown_changelog(self, include_unreleased: bool = True) -> str:
        """Generate Keep a Changelog format markdown."""
        grouped_commits = self.group_commits_by_category()
        
        if not grouped_commits:
            return "No notable changes.\n"
        
        # Start with header
        changelog = []
        if include_unreleased and self.version == "Unreleased":
            changelog.append(f"## [{self.version}]")
        else:
            changelog.append(f"## [{self.version}] - {self.date}")
        
        changelog.append("")
        
        # Order categories logically
        category_order = ['Added', 'Changed', 'Deprecated', 'Removed', 'Fixed', 'Security']
        
        # Separate breaking changes
        breaking_changes = [commit for commit in self.commits if commit.is_breaking]
        
        # Add breaking changes section first if any exist
        if breaking_changes:
            changelog.append("### Breaking Changes")
            for commit in breaking_changes:
                line = self._format_commit_line(commit, show_breaking=True)
                changelog.append(f"- {line}")
            changelog.append("")
        
        # Add regular categories
        for category in category_order:
            if category not in grouped_commits:
                continue
                
            changelog.append(f"### {category}")
            
            # Group by scope for better organization
            scoped_commits = defaultdict(list)
            for commit in grouped_commits[category]:
                scope = commit.scope if commit.scope else "general"
                scoped_commits[scope].append(commit)
            
            # Sort scopes, with 'general' last
            scopes = sorted(scoped_commits.keys())
            if "general" in scopes:
                scopes.remove("general")
                scopes.append("general")
            
            for scope in scopes:
                if len(scoped_commits) > 1 and scope != "general":
                    changelog.append(f"#### {scope.title()}")
                
                for commit in scoped_commits[scope]:
                    line = self._format_commit_line(commit)
                    changelog.append(f"- {line}")
            
            changelog.append("")
        
        return '\n'.join(changelog)
    
    def _format_commit_line(self, commit: ConventionalCommit, show_breaking: bool = False) -> str:
        """Format a single commit line for the changelog."""
        # Start with description
        line = commit.description.capitalize()
        
        # Add scope if present and not already in description
        if commit.scope and commit.scope.lower() not in line.lower():
            line = f"{commit.scope}: {line}"
        
        # Add issue references
        issue_refs = commit.extract_issue_references()
        if issue_refs:
            refs_str = ', '.join(f"#{ref}" for ref in issue_refs)
            line += f" ({refs_str})"
        
        # Add commit hash if available
        if commit.commit_hash:
            short_hash = commit.commit_hash[:7]
            line += f" [{short_hash}]"
            
            if self.base_url:
                line += f"({self.base_url}/commit/{commit.commit_hash})"
        
        # Add breaking change indicator
        if show_breaking and commit.breaking_change_description:
            line += f" - {commit.breaking_change_description}"
        elif commit.is_breaking and not show_breaking:
            line += " ⚠️ BREAKING"
        
        return line
    
    def generate_release_summary(self) -> Dict:
        """Generate summary statistics for the release."""
        if not self.commits:
            return {
                'version': self.version,
                'date': self.date,
                'total_commits': 0,
                'by_type': {},
                'by_author': {},
                'breaking_changes': 0,
                'notable_changes': 0
            }
        
        # Count by type
        type_counts = Counter(commit.type for commit in self.commits)
        
        # Count by author
        author_counts = Counter(commit.author for commit in self.commits if commit.author)
        
        # Count breaking changes
        breaking_count = sum(1 for commit in self.commits if commit.is_breaking)
        
        # Count notable changes (excluding chore, ci, build, test)
        notable_types = {'feat', 'fix', 'security', 'perf', 'refactor', 'remove', 'deprecate'}
        notable_count = sum(1 for commit in self.commits if commit.type in notable_types)
        
        return {
            'version': self.version,
            'date': self.date,
            'total_commits': len(self.commits),
            'by_type': dict(type_counts.most_common()),
            'by_author': dict(author_counts.most_common(10)),  # Top 10 contributors
            'breaking_changes': breaking_count,
            'notable_changes': notable_count,
            'scopes': list(set(commit.scope for commit in self.commits if commit.scope)),
            'issue_references': len(set().union(*(commit.extract_issue_references() for commit in self.commits)))
        }
    
    def generate_json_output(self) -> str:
        """Generate JSON representation of the changelog data."""
        grouped_commits = self.group_commits_by_category()
        
        # Convert commits to serializable format
        json_data = {
            'version': self.version,
            'date': self.date,
            'summary': self.generate_release_summary(),
            'categories': {}
        }
        
        for category, commits in grouped_commits.items():
            json_data['categories'][category] = []
            for commit in commits:
                commit_data = {
                    'type': commit.type,
                    'scope': commit.scope,
                    'description': commit.description,
                    'hash': commit.commit_hash,
                    'author': commit.author,
                    'date': commit.date,
                    'breaking': commit.is_breaking,
                    'breaking_description': commit.breaking_change_description,
                    'issue_references': commit.extract_issue_references()
                }
                json_data['categories'][category].append(commit_data)
        
        return json.dumps(json_data, indent=2)


def main():
    """Main entry point with CLI argument parsing."""
    parser = argparse.ArgumentParser(description="Generate changelog from conventional commits")
    parser.add_argument('--input', '-i', type=str, help='Input file (default: stdin)')
    parser.add_argument('--format', '-f', choices=['markdown', 'json', 'both'], 
                       default='markdown', help='Output format')
    parser.add_argument('--version', '-v', type=str, default='Unreleased',
                       help='Version for this release')
    parser.add_argument('--date', '-d', type=str, 
                       default=datetime.now().strftime("%Y-%m-%d"),
                       help='Release date (YYYY-MM-DD format)')
    parser.add_argument('--base-url', '-u', type=str, default='',
                       help='Base URL for commit links')
    parser.add_argument('--input-format', choices=['git-log', 'json'], 
                       default='git-log', help='Input format')
    parser.add_argument('--output', '-o', type=str, help='Output file (default: stdout)')
    parser.add_argument('--summary', '-s', action='store_true',
                       help='Include release summary statistics')
    
    args = parser.parse_args()
    
    # Read input
    if args.input:
        with open(args.input, 'r', encoding='utf-8') as f:
            input_data = f.read()
    else:
        input_data = sys.stdin.read()
    
    if not input_data.strip():
        print("No input data provided", file=sys.stderr)
        sys.exit(1)
    
    # Initialize generator
    generator = ChangelogGenerator()
    generator.version = args.version
    generator.date = args.date
    generator.base_url = args.base_url
    
    # Parse input
    try:
        if args.input_format == 'json':
            generator.parse_json_commits(input_data)
        else:
            generator.parse_git_log_output(input_data)
    except Exception as e:
        print(f"Error parsing input: {e}", file=sys.stderr)
        sys.exit(1)
    
    if not generator.commits:
        print("No valid commits found in input", file=sys.stderr)
        sys.exit(1)
    
    # Generate output
    output_lines = []
    
    if args.format in ['markdown', 'both']:
        changelog_md = generator.generate_markdown_changelog()
        if args.format == 'both':
            output_lines.append("# Markdown Changelog\n")
        output_lines.append(changelog_md)
    
    if args.format in ['json', 'both']:
        changelog_json = generator.generate_json_output()
        if args.format == 'both':
            output_lines.append("\n# JSON Output\n")
        output_lines.append(changelog_json)
    
    if args.summary:
        summary = generator.generate_release_summary()
        output_lines.append(f"\n# Release Summary")
        output_lines.append(f"- **Version:** {summary['version']}")
        output_lines.append(f"- **Total Commits:** {summary['total_commits']}")
        output_lines.append(f"- **Notable Changes:** {summary['notable_changes']}")
        output_lines.append(f"- **Breaking Changes:** {summary['breaking_changes']}")
        output_lines.append(f"- **Issue References:** {summary['issue_references']}")
        
        if summary['by_type']:
            output_lines.append("- **By Type:**")
            for commit_type, count in summary['by_type'].items():
                output_lines.append(f"  - {commit_type}: {count}")
    
    # Write output
    final_output = '\n'.join(output_lines)
    
    if args.output:
        with open(args.output, 'w', encoding='utf-8') as f:
            f.write(final_output)
    else:
        print(final_output)


if __name__ == '__main__':
    main()

Release Readiness Report
========================
Release: Winter 2024 Release v2.3.0
Status: AT_RISK
Readiness Score: 73.3%

WARNINGS:

  ⚠️  Feature 'Elasticsearch Fuzzy Search' (SEARCH-789) still in progress
  ⚠️  Feature 'Elasticsearch Fuzzy Search' has low test coverage: 76.5% < 80.0%
  ⚠️  Required quality gate 'Security Scan' is pending
  ⚠️  Required quality gate 'Documentation Review' is pending

BLOCKING ISSUES:

  ❌ Feature 'Biometric Authentication' (MOBILE-456) is blocked
  ❌ Feature 'Biometric Authentication' missing approvals: QA approval, Security approval

RECOMMENDATIONS:

  💡 Obtain required approvals for pending features
  💡 Improve test coverage for features below threshold
  💡 Complete pending quality gate validations

FEATURE SUMMARY:
  Total: 6 | Ready: 3 | Blocked: 1
  Breaking Changes: 1 | Missing Approvals: 1

QUALITY GATES:
  Total: 6 | Passed: 3 | Failed: 0

Current Version: 2.2.5
Recommended Version: 3.0.0
With v prefix: v3.0.0
Bump Type: major

Commit Analysis:
- Total commits: 13
- Breaking changes: 2
- New features: 4
- Bug fixes: 4
- Ignored commits: 3

Breaking Changes:
  - feat(ui): redesign dashboard with new component library
  - fix(security): patch SQL injection vulnerability in reports

Bump Commands:
  npm:
    npm version 3.0.0 --no-git-tag-version
  python:
    # Update version in setup.py, __init__.py, or pyproject.toml
    # pyproject.toml: version = "3.0.0"
  rust:
    # Update Cargo.toml
    # version = "3.0.0"
  git:
    git tag -a v3.0.0 -m 'Release v3.0.0'
    git push origin v3.0.0
  docker:
    docker build -t myapp:3.0.0 .
    docker tag myapp:3.0.0 myapp:latest