# Changelog
All notable changes to the HackerNews MCP Server 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.0.0] - 2025-10-14
### Added
- 🎉 **Initial Release**: Complete HackerNews MCP Server implementation
- 🔍 **9 MCP Tools**: Comprehensive HN API integration
- `search_stories` - Search stories by relevance with advanced filtering
- `search_by_date` - Search stories sorted by date
- `search_comments` - Search comments with filtering
- `get_front_page` - Retrieve current HN front page
- `get_latest_stories` - Get most recently submitted stories
- `get_ask_hn` - Retrieve Ask HN posts
- `get_show_hn` - Retrieve Show HN posts
- `get_story` - Get specific story with nested comments
- `get_user` - Retrieve user profile information
- 🛡️ **Rate Limiting**: Automatic rate limiting respecting HN API limits (10,000 req/hr)
- 📊 **Structured Logging**: Pino-based JSON logging with correlation IDs
- 🧪 **Comprehensive Testing**: Unit, integration, and contract tests
- 📚 **Full Documentation**: Complete setup guides and API documentation
- 🔧 **Type Safety**: Full TypeScript with strict mode
- 🏗️ **Build System**: Automated build, lint, and test pipeline
- 📦 **NPM Package**: Ready for publication and distribution
### Technical Features
- **MCP Protocol v2.0**: Full Model Context Protocol compliance
- **Error Handling**: Comprehensive error handling with MCP-formatted responses
- **Validation**: Zod-based request/response validation
- **Observability**: Debug logging and performance monitoring
- **Security**: HTTPS-only API calls, input validation, secure defaults
### Documentation
- **README.md**: Complete setup and usage guide
- **API Documentation**: Detailed tool specifications with examples
- **VS Code Setup**: Step-by-step VS Code integration guide
- **Claude Desktop**: Configuration instructions
- **Troubleshooting**: Common issues and solutions
### Development
- **Constitution-Driven**: Development following strict quality principles
- **TDD Approach**: Test-first development methodology
- **Quality Gates**: Automated linting, type checking, and testing
- **CI/CD Ready**: GitHub Actions workflow template
- **Open Source Ready**: Complete contributor documentation
## Types of Changes
- `Added` for new features
- `Changed` for changes in existing functionality
- `Deprecated` for soon-to-be removed features
- `Removed` for now removed features
- `Fixed` for any bug fixes
- `Security` in case of vulnerabilities
## Contributing to Changelog
When contributing to this project, please:
1. Add entries to the "Unreleased" section above
2. Follow the format: `- [Type] Description (#PR)`
3. Keep descriptions concise but informative
4. Group related changes together
Example:
```
### Added
- Add new search tool for comments (#123)
- Improve error handling for API timeouts (#124)
### Fixed
- Fix rate limiting calculation bug (#125)
```
---
**Legend:**
- 🎉 Major feature
- ✨ New feature
- 🐛 Bug fix
- 📚 Documentation
- 🛠️ Maintenance
- 🔒 Security
