hawkeye-mcp-server 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,123 @@
+# Changelog
+
+All notable changes to the Hawkeye 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] - 2024-11-19
+
+### Added
+
+#### Core Features
+- Initial release of Hawkeye MCP Server
+- Full Model Context Protocol (MCP) implementation
+- Authentication service with token caching and automatic refresh
+- Project management and selection
+- Session management and investigation lifecycle
+
+#### Investigation Tools
+- `hawkeye_list_projects` - List all available Hawkeye projects
+- `hawkeye_investigate_alert` - Find existing RCAs or create new investigations for alert IDs
+- `hawkeye_get_investigation_status` - Check investigation progress and results
+- `hawkeye_continue_investigation` - Ask follow-up questions on existing investigations
+
+#### Session Management & Analytics
+- `hawkeye_list_sessions` - List sessions with advanced filtering capabilities:
+  - Pagination support (page/limit parameters)
+  - Date range filtering (date_from/date_to)
+  - Investigation status filtering (uninvestigated, in progress, completed)
+  - Session type filtering (incident vs manual)
+  - Convenience parameter `only_uninvestigated` for quick filtering
+  - Option to hide grouped incidents
+- `hawkeye_inspect_session` - Get detailed session information with:
+  - All prompt cycles
+  - Chain of thoughts (analysis steps)
+  - Data sources used
+  - Follow-up suggestions
+- `hawkeye_get_session_report` - Get session summaries with time-saved metrics
+- `hawkeye_get_session_summary` - Get detailed quality scores and analysis metrics
+- `hawkeye_get_incident_report` - Get organization-wide analytics:
+  - MTTR (Mean Time To Resolution)
+  - Total time saved
+  - Noise reduction percentage
+  - Incident breakdown by type and priority
+
+#### Configuration & Environment
+- Comprehensive environment variable support
+- Configurable polling and timeouts
+- Optional logging configuration
+- Default project and organization settings
+
+#### Documentation
+- Comprehensive README with quick start guide
+- Detailed INSTALLATION.md with platform-specific instructions
+- Complete USAGE.md with workflows and examples
+- Technical SPECIFICATION.md with API reference
+- MIT License
+
+### Changed
+- Standardized all environment variables to use `HAWKEYE_` prefix (was `RAVEN_`)
+- Package renamed from `raven-api-services` to `hawkeye-mcp-server`
+- Updated to public npm package (was private)
+
+### Technical Details
+- Node.js >= 20.0.0 required
+- Built with TypeScript for type safety
+- Uses @modelcontextprotocol/sdk ^1.10.0
+- HTTP client with Axios ^1.9.0
+- Runtime validation with Zod ^3.24.3
+
+### Supported Platforms
+- macOS (Intel and Apple Silicon)
+- Windows 10/11
+- Linux (Ubuntu, Debian, Fedora, etc.)
+
+### Supported AI Agents
+- Claude Desktop (macOS, Windows)
+- Cursor.ai (macOS, Windows, Linux)
+- Continue.dev (VS Code extension)
+- Any MCP-compatible AI agent
+
+---
+
+## [Unreleased]
+
+### Planned Features
+- Custom investigation creation with natural language timeframes
+- Streaming support for real-time progress updates
+- Interactive setup wizard (`hawkeye-mcp init`)
+- Health check command (`hawkeye-mcp test-connection`)
+- CLI flags (`--version`, `--help`)
+- Additional filtering options (priority, incident type)
+- Pre-built binaries for platforms without Node.js
+
+---
+
+## How to Update
+
+### For Users
+
+```bash
+# Update to latest version
+npm update -g hawkeye-mcp-server
+
+# Or reinstall
+npm install -g hawkeye-mcp-server@latest
+```
+
+### For npx Users
+
+npx automatically uses the latest version, but you can force a cache clear:
+
+```bash
+# Clear npx cache and use latest
+npx clear-npx-cache
+npx hawkeye-mcp-server
+```
+
+---
+
+## Support
+
+For questions or issues, contact support@neubird.ai