TASKS.md

Development Tasks

Phase 1: Core Foundation

• Verify project setup works (uv sync, imports, basic tests)
• Implement basic Note model with frontmatter parsing
• Implement filesystem storage backend
• Add basic Tantivy search integration
• Wire up MCP tools (create, read, update, delete, list)
• Test MCP server manually with Claude Desktop or similar

Phase 2: Search & Discovery

• Improve search with better ranking (field boosting, raw tokenizer for tags)
• Add tag-based filtering
• Implement path-based navigation (list notes in folder)
• Add search by date range (with date math: now-7d, 2024-01-01+1M)
• Support markdown links between notes

Phase 3: AI Optimization

• Add context tools (get related notes, recent notes)
• Implement semantic search (embeddings)
• Add note summarization support
• Create "knowledge graph" view of note connections

Phase 4: Multi-client Support

• Test with Claude Desktop
• Test with other MCP clients
• Document setup for different AI tools
• Add web UI for note management (replaces CLI task)

Phase 5: Production Hardening

• Add input validation (path traversal prevention, model validators)
• Add comprehensive error handling for edge cases
• Implement logging
• Add user configuration file support
• Write user documentation (README with MCP client setup)
• Add backup/export functionality (CLI and Web UI)

Backlog / Ideas

• Team/shared notes support
• Note versioning/history
• Encryption for sensitive notes
• Web UI for browsing (moved to Phase 4, completed)
• Import from other note tools (Obsidian, Notion, etc.)
• Claude skills integration