## 📝 Description

Please include a summary of the change and which issue is fixed. Please also include relevant motivation and context.

Fixes # (issue)

## 🔄 Type of Change

Please delete options that are not relevant.

- [ ] 🐛 Bug fix (non-breaking change which fixes an issue)
- [ ] ✨ New feature (non-breaking change which adds functionality)
- [ ] 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
- [ ] 📚 Documentation update
- [ ] 🧪 Test addition or update
- [ ] 🔧 Refactoring (no functional changes)
- [ ] ⚡ Performance improvement
- [ ] 🎨 Style/formatting change

## 🧪 How Has This Been Tested?

Please describe the tests that you ran to verify your changes. Provide instructions so we can reproduce. Please also list any relevant details for your test configuration.

- [ ] Unit tests pass: `uv run pytest tests/ -v`
- [ ] Linting passes: `uv run ruff check src/ tests/`
- [ ] Type checking passes: `uv run mypy src/`
- [ ] Manual testing with sample data
- [ ] Performance testing with large files

## 📋 Checklist

- [ ] My code follows the style guidelines of this project
- [ ] I have performed a self-review of my own code
- [ ] I have commented my code, particularly in hard-to-understand areas
- [ ] I have made corresponding changes to the documentation
- [ ] My changes generate no new warnings
- [ ] I have added tests that prove my fix is effective or that my feature works
- [ ] New and existing unit tests pass locally with my changes
- [ ] Any dependent changes have been merged and published in downstream modules

## 📱 Screenshots (if applicable)

If applicable, add screenshots to help explain your changes.

## 🔍 Additional Notes

Add any other context about the pull request here, such as:
- Design decisions and trade-offs
- Performance implications
- Breaking changes and migration notes
- Dependencies added or removed

## 📚 Documentation Updates

- [ ] README.md updated (if user-facing changes)
- [ ] Usage guide updated (if CLI changes)
- [ ] Implementation status updated (if architectural changes)
- [ ] Code comments added for complex logic

## 🚀 Performance Impact

- [ ] No performance impact
- [ ] Performance improvement (describe)
- [ ] Performance regression (describe and justify)

## 🔒 Security Considerations

- [ ] No security implications
- [ ] Security improvement (describe)
- [ ] Security considerations addressed (describe)
