# Changelog

All notable changes to the Obsidian MCP Bundle 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] - 2026-03-22

### Added

#### File Operations (User Story 1)
- `obsidian_create_note` - Create new notes with optional content and frontmatter properties
- `obsidian_read_note` - Read note content by filename or path
- `obsidian_append_to_note` - Append content to existing notes
- `obsidian_prepend_to_note` - Prepend content to existing notes
- `obsidian_delete_note` - Delete notes from vault
- `obsidian_move_note` - Move notes to different folders
- `obsidian_rename_note` - Rename note files
- `obsidian_open_note` - Open notes in Obsidian application

#### Search & Discovery (User Story 2)
- `obsidian_search` - Full-text search with query filters, path scoping, case sensitivity, and format options (text/json)
- `obsidian_get_backlinks` - Find all notes linking to a specific note
- `obsidian_list_outgoing_links` - List all links from a note to other notes
- `obsidian_list_unresolved_links` - Identify broken/non-existent links across vault
- `obsidian_list_tags` - List all tags in vault or specific note
- `obsidian_search_by_tag` - Find notes containing specific tags
- `obsidian_get_tag_count` - Count usage of specific tags
- `obsidian_list_aliases` - List all aliases in vault or per note
- `obsidian_list_properties` - List all frontmatter properties used in vault
- `obsidian_get_property_count` - Count usage of specific properties

#### Task Management (User Story 3)
- `obsidian_list_tasks` - List tasks with filtering by status, file, path, tags; supports multiple output formats
- `obsidian_toggle_task` - Toggle task completion status between done and todo
- `obsidian_mark_task_done` - Mark tasks as completed
- `obsidian_mark_task_todo` - Mark tasks as incomplete
- `obsidian_update_task_status` - Set custom task status characters (-, >, !, ?, etc.)

#### Property Management (User Story 3)
- `obsidian_get_property` - Read single property value from a file
- `obsidian_set_property` - Set or update frontmatter properties with type specification
- `obsidian_remove_property` - Remove properties from files

### Infrastructure
- **MCP Protocol**: Full compliance with Model Context Protocol via @modelcontextprotocol/sdk
- **MCPB Bundle**: Conforms to MCPB specification v0.3 with complete manifest
- **Validation**: Zod schemas for all tool inputs with runtime type checking
- **Error Handling**: Consistent error responses with actionable messages
- **Security**: Input sanitization and parameter validation for all tools
- **Timeout Management**: 30-second timeout for CLI operations
- **Parameter Quoting**: Automatic quoting for filenames/values containing spaces
- **Logging**: stderr-only logging with sensitive data sanitization

### Technical Details
- **TypeScript**: Fully typed codebase with strict mode enabled
- **Node.js**: ES2022 module format with ESNext target
- **Transport**: stdio JSON-RPC for MCP communication
- **CLI Integration**: Wrapper for Obsidian CLI with proper parameter formatting
- **Bundle Format**: .mcpb packaging with manifest, icons, and compiled code

### Documentation
- Complete README with installation instructions for Claude Desktop extensions
- Manifest with detailed tool descriptions and parameter schemas
- Input validation and error documentation
- Development and testing guidelines

### Quality
- Zero TypeScript compilation errors
- MCPB manifest validation passes
- All tools tested with Obsidian CLI
- Comprehensive input schema definitions
- Security audit of parameter handling

## [Unreleased]

### Planned
- Additional vault navigation tools (User Story 4 - deferred)
- Advanced features like templates and daily notes (User Story 5 - deferred)
- Performance optimizations for large vaults
- Expanded test coverage
- Multi-vault support enhancements

---

## Version History

- **1.0.0** - Initial release with 28 MCP tools across 3 user stories
  - File Operations (8 tools)
  - Search & Discovery (12 tools)
  - Task & Property Management (8 tools)

[1.0.0]: https://github.com/yourusername/obsidian-mcp/releases/tag/v1.0.0