Initial commit

commands/changelog-view.md

@@ -0,0 +1,107 @@
+---
+description: View recent entries from the CHANGELOG.md file
+---
+
+Display recent changelog entries from the project's CHANGELOG.md file to help understand recent changes and the changelog format.
+
+## Context
+The CHANGELOG.md file contains all notable changes to the project, organized by version and date following the Keep a Changelog format.
+
+## Task
+Help the user view and understand recent changelog entries:
+
+1. **Locate CHANGELOG.md**: Find the CHANGELOG.md file in the project root or nearby repositories
+2. **Read the file**: Load the changelog content
+3. **Display recent entries**:
+   - Show the [Unreleased] section if it exists (this shows pending changes)
+   - Show the 3-5 most recent versioned releases
+   - Format the output in a readable way
+4. **Provide context**:
+   - Highlight the changelog format and structure
+   - Point out different change categories (Added, Changed, Fixed, etc.)
+   - Show examples of well-formatted entries
+5. **Offer next steps**:
+   - Suggest using /changelog-add if they need to add an entry
+   - Point out where new entries should be added
+
+## Display Format
+
+Show the changelog content in a structured way:
+
+```markdown
+# Recent Changelog Entries
+
+## [Unreleased]
+[If there are unreleased entries, show them here]
+
+## [Version] - Date
+[Show recent version entries]
+
+---
+
+💡 Tips:
+- New entries should be added to the [Unreleased] section
+- Use /changelog-add to add a new entry
+- Follow the existing format and style
+```
+
+## Example Output
+
+```
+# Recent Changelog Entries from CHANGELOG.md
+
+## [Unreleased]
+
+### Fixed
+- **Feeding Endpoint Error**: Fixed 500 server error in `/v3/feeding/sfr-by-weeknumber-and-year` endpoint
+
+## [3.7.19] - 2025-09-26
+
+## [3.7.18] - 2025-09-26
+
+## [3.7.17] - 2025-09-25
+
+### Changed
+- Use sudo apt install instead of curl for just install
+
+### Fixed
+- Reintroduced the period param
+
+---
+
+💡 The changelog follows Keep a Changelog format (https://keepachangelog.com/)
+
+Categories used:
+- Added: New features
+- Changed: Changes in existing functionality
+- Fixed: Bug fixes
+- Removed: Removed features
+- Security: Security improvements
+- Deprecated: Soon-to-be removed features
+
+To add a new entry: /changelog-add
+```
+
+## Options
+
+If the user specifies what they want to see, adjust the output:
+- "latest version" → Show only the most recent release
+- "unreleased" → Show only the [Unreleased] section
+- "all" → Show the entire changelog
+- "last N versions" → Show the last N versions
+
+## Additional Features
+
+- **Search**: If user asks to search for specific terms, grep through the changelog
+- **Statistics**: Can provide counts of different types of changes
+- **Format check**: Can validate that the changelog follows the expected format
+- **Compare**: Can compare what's in [Unreleased] vs what's committed
+
+## Important Notes
+- Make the output readable and well-formatted
+- Use appropriate markdown formatting
+- Highlight important sections
+- Provide helpful context about the changelog structure
+- Offer actionable next steps
+
+Remember: This command helps users understand the project's change history and learn the changelog format.