916e9cfb9b
fix: critical command name and quoting bugs in US2 tools + polish docs
...
Fixed critical bugs in User Story 2 tools (links, tags, aliases) and
completed polish phase documentation tasks.
## Critical Bug Fixes
**links.ts - Wrong Command Names:**
- ❌ Was calling: `obsidian link backlinks` (wrong - 'link' command doesn't exist)
- ✅ Now calling: `obsidian backlinks` (correct CLI command)
- Fixed 5 tools: backlinks, outgoing links, unresolved, deadends, orphans
- Changed executeObsidianCommand('link', ...) → executeObsidianCommand('backlinks', ...)
- Changed 'outgoing-links' → 'links' (correct command name)
- Changed 'unresolved-links' → 'unresolved'
**tags-aliases.ts - Wrong Command Names:**
- ❌ Was calling: `obsidian tag list-tags` (wrong format)
- ✅ Now calling: `obsidian tags` (correct command)
- Fixed 3 tools: list_tags, tag_info, list_aliases
- Changed executeObsidianCommand('tag', ['list-tags']) → executeObsidianCommand('tags', [])
- Changed 'tag-info' → 'tag' with name parameter
- Changed 'alias' → 'aliases'
**Parameter Quoting:**
- Added formatParam() imports to both files
- All string parameters now quoted: `file="My Note"` not `file=My Note`
- Fixes multi-word filename handling (previously split on spaces)
**Parameter Format:**
- Changed from `--flag value` to Obsidian CLI format: `param=value`
- Boolean flags now standalone: `counts` not `--counts`
- Aligns with file-operations.ts and search.ts patterns
## Documentation (Polish Phase)
**T150 - README.md Updated:**
- Changed "20 tools" → "28 tools" (accurate count)
- Added complete tool listing with descriptions
- Organized by category: File Operations (8), Search & Discovery (12), Tasks & Properties (8)
- Each tool includes name and brief description
- Removed placeholder text about US3 being "planned"
**T151 - CHANGELOG.md Created:**
- Full v1.0.0 changelog following Keep a Changelog format
- Documents all 28 tools across 3 user stories
- Lists infrastructure features (MCP protocol, MCPB bundle, validation, security)
- Technical details section (TypeScript, Node.js, transport, CLI integration)
- Quality metrics (0 compilation errors, passing validation)
- Planned features section for deferred US4/US5
## Impact
These fixes resolve 8 broken tools that would have failed on:
- Any command execution (wrong command names)
- Any filename with spaces (missing quoting)
Affected tools now work correctly:
- obsidian_get_backlinks
- obsidian_list_outgoing_links
- obsidian_list_unresolved_links
- obsidian_list_deadends
- obsidian_list_orphans
- obsidian_list_tags
- obsidian_get_tag_info
- obsidian_list_aliases
## Files Changed
- src/tools/links.ts: Fixed 5 tools (command names + quoting)
- src/tools/tags-aliases.ts: Fixed 3 tools (command names + quoting)
- README.md: Updated tool count and complete listings (T150)
- CHANGELOG.md: Created comprehensive v1.0.0 changelog (T151)
- specs/001-obsidian-mcp-bundle/tasks.md: Marked T150-T151, T080-T081 complete
## Task Progress
- Completed: T080-T081 (infrastructure helpers), T150-T151 (polish docs)
- Total: 89/101 tasks (88.1%)
- Remaining: T076-T078 (optional wrappers), T153-T165 (polish/testing)
## Build Status
✅ TypeScript: 0 errors
✅ All 28 tools now have correct CLI integration
✅ Parameter quoting consistent across all tool files
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com >
2026-03-22 14:04:17 -05:00
0c6f1762c4
docs: update README with desktop extension installation instructions
...
Updated installation section to use Claude Desktop's custom desktop
extension workflow instead of generic MCP server configuration.
Changes:
1. Installation Section:
- Added step-by-step instructions for installing via Extensions UI
- Included Advanced Settings -> Extension Developer flow
- Added link to official Claude Desktop documentation
- Mentioned automatic encryption of vault_name via OS keychain
2. Configuration Section:
- Prioritized UI-based configuration approach
- Kept manual JSON config as 'advanced' option
- Clarified vault_name is the primary required setting
3. Available Tools Section:
- Updated tool count from 95+ to accurate 20 tools
- Listed actual implemented tools (File Ops: 8, Search: 11)
- Noted User Story 3 (Tasks & Properties) as planned
- Removed references to non-existent tools
Reference:
- https://support.claude.com/en/articles/10949351
Reflects current project scope (US1 and US2 complete, US4/US5 removed).
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com >
2026-03-22 13:49:50 -05:00
622b28e42c
feat: implement Obsidian MCP Bundle MVP (Phase 1-3)
...
- Complete project setup with TypeScript, Jest, MCPB manifest
- Implement foundational infrastructure (CLI executor, logger, error handler)
- Add 9 file operation tools for User Story 1
- Full MCP protocol compliance with stdio transport
- Input validation and sanitization for security
- Comprehensive error handling with actionable messages
- Constitutional compliance: all 6 principles satisfied
MVP includes:
- obsidian_create_note, read, append, prepend, delete, move, rename, open, file_info
- Zod validation schemas for all parameters
- 30s timeout configuration with per-command overrides
- Stderr-only logging with sanitized output
- Graceful shutdown handling
Build: ✅ 0 errors, 0 vulnerabilities
Tasks: 48/167 complete (MVP milestone)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com >
2026-03-22 11:21:38 -05:00
