# Changelog
All notable changes to this project 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-30
### Added
- **search_posts tool** - Search HackerNews posts with advanced filtering
- Keyword search across posts
- Filter by content type (story, comment, poll, show_hn, ask_hn, front_page)
- Filter by author username
- Filter by story ID (for comment search)
- Filter by points threshold (min/max)
- Filter by comment count (min/max)
- Filter by date range (after/before)
- Sort by relevance or date
- Pagination support (up to 100 results per page)
- **get_front_page tool** - Retrieve current HackerNews front page
- Returns posts currently on HN front page
- Pagination support (up to 30 results per page)
- Matches news.ycombinator.com front page content
- **get_post tool** - Get detailed post information with comment tree
- Fetch post by ID
- Full comment tree with nested structure
- Comment count and nesting depth metadata
- Handles deleted posts and missing content gracefully
- **get_user tool** - Retrieve user profile information
- Username lookup
- Karma score
- Account creation date
- User bio/about text
- Computed fields: account age, karma per year, activity status
- **Type Safety** - Full TypeScript implementation
- Strict mode enabled
- Zod schema validation for all inputs
- Complete type definitions for HN API responses
- **Error Handling** - Comprehensive error management
- Custom error types (APIError, ValidationError, RateLimitError, NotFoundError)
- Detailed error messages
- MCP-compliant error responses
- **Rate Limiting** - Built-in rate limit tracking
- Respects HN API limit of 10,000 requests/hour
- Remaining quota included in responses
- Automatic rate limit error handling
### Technical Details
- TypeScript 5.x with strict mode
- Node.js 22+ required
- Model Context Protocol (MCP) SDK integration
- Zod for input validation and JSON schema generation
- Biome for linting and formatting
- Vitest for testing framework
### Infrastructure
- Complete project structure with src/ and tests/ directories
- TypeScript compilation to ESM modules
- NPM package configuration with bin entry point
- Git ignore files for clean repository
- Comprehensive README with installation and usage instructions
[1.0.0]: https://github.com/yourusername/hn-mcp-server/releases/tag/v1.0.0
