# 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.2.1] - 2025-10-26

### Fixed
- 🐛 **Critical**: Fixed @mention format to use Figma's `message_meta` structure
- ✅ Mentions now create clickable user objects instead of plain text
- 🔄 Automatic detection and parsing of @username format
- 🎯 User ID resolution from username for proper mention linking
- 📦 Uses Figma web client's undocumented but working message_meta format

### Changed
- ⚙️ `postFigmaComment()` now uses `message_meta` array when mentions detected
- ⚙️ `replyToFigmaComment()` now uses `message_meta` array when mentions detected
- 🗺️ `getCommentUsers()` now returns object with both users array and usersMap
- 📝 Added `parseMessageWithMentions()` helper function for mention processing

### Technical Details
- Format discovered through reverse-engineering Figma web client
- Uses `message_meta` array with objects: `{t: "text", mention: "user_id"}`
- Automatically falls back to simple `message` field when no mentions present
- Maintains backward compatibility with non-mention comments

## [1.2.0] - 2025-10-26

### Added
- 🎯 **@Mentions support**: Mention users in comments and replies using @username format
- 📝 New tool: `get_comment_users` - Get list of users who have commented (useful for knowing who to mention)
- 💬 User notifications: Mentioned users receive notifications in Figma
- 📚 Complete mentions documentation in README with examples and best practices
- 🔄 Enhanced message descriptions for `post_figma_comment` and `reply_to_figma_comment` to indicate @mention support

### Changed
- 📖 Updated README with "Using @Mentions" section including:
  - How to use mentions guide
  - Best practices for mentioning users
  - Example workflows with mentions
- 📊 Updated tool descriptions to highlight @mention capability
- 🎨 Added mention examples in "Example Conversations" section

### Documentation
- New section: "Using @Mentions" with complete guide
- Updated verification section to show 5 tools (was 4)
- Added mention-specific use case examples
- Enhanced tool documentation with mention usage

## [1.1.0] - 2025-10-26

### Added
- ✨ **Write capabilities**: Create new comments in Figma files
- ✨ **Reply to comments**: Respond to existing comments maintaining conversation threads
- 📝 New tool: `post_figma_comment` - Create comments with optional location (node_id, coordinates)
- 📝 New tool: `reply_to_figma_comment` - Reply to existing comments by ID
- 📚 FEATURES.md - Complete documentation of read and write capabilities
- 🔒 Permission documentation in README and QUICKSTART
- 📊 Visual table showing all 4 available tools (2 read, 2 write)

### Changed
- 📖 Updated README with comprehensive examples for write operations
- 📖 Enhanced QUICKSTART with examples of creating and replying to comments
- 📖 Improved troubleshooting section with write permission requirements
- 🏷️ Updated package description to reflect read/write capabilities

### Documentation
- Added clear distinction between read and write operations
- Added permission requirements for each operation type
- Added AI-powered workflow examples
- Added combined read/write use cases

## [1.0.0] - 2025-10-25

### Added
- 🎉 Initial release
- 📖 Read comments from Figma files
- 📊 Generate comment summaries and statistics
- 🔧 Two tools: `get_figma_comments` and `summarize_figma_comments`
- 📚 Complete documentation (README, QUICKSTART)
- 🔐 Environment-based authentication
- 🏗️ MCP SDK integration

[1.1.0]: https://github.com/cloudframework-io/mcp-figma-comment-summary/compare/v1.0.0...v1.1.0
[1.0.0]: https://github.com/cloudframework-io/mcp-figma-comment-summary/releases/tag/v1.0.0