## 📝 Description

<!-- Provide a clear and concise description of your changes -->

## 🎯 Type of Change

<!-- Mark the relevant option with an "x" -->

- [ ] 🐛 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
- [ ] 🎨 Code style update (formatting, renaming)
- [ ] ♻️ Refactoring (no functional changes)
- [ ] 🧪 Test update
- [ ] 🔧 Build/infrastructure change

## 🔗 Related Issues

<!-- Link any related issues here -->

Closes #
Fixes #
Related to #

## 🧪 Testing

<!-- Describe the tests you ran and how to reproduce them -->

- [ ] All existing tests pass (`task test`)
- [ ] New tests added for new functionality
- [ ] Test coverage remains at 100%
- [ ] Manually tested the changes

### Test Commands Run

```bash
# List the commands you ran to test your changes
task test
task lint
```

## 📸 Screenshots/Output

<!-- If applicable, add screenshots or command output to help explain your changes -->

```
# Paste relevant output here
```

## ✅ Checklist

<!-- Mark completed items with an "x" -->

- [ ] My code follows the project's style guidelines (Ruff passes)
- [ ] I have performed a self-review of my 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 or errors
- [ ] I have added tests that prove my fix is effective or that my feature works
- [ ] All tests pass locally with my changes (`task test`)
- [ ] Test coverage remains at 100%
- [ ] I have used [Conventional Commits](https://www.conventionalcommits.org/) format
- [ ] I have updated the relevant documentation (README, CONTRIBUTING, etc.)
- [ ] I have read the [Contributing Guidelines](CONTRIBUTING.md)
- [ ] I have read the [Code of Conduct](CODE_OF_CONDUCT.md)

## 📎 Additional Notes

<!-- Add any additional notes, context, or implementation details here -->
