atlas/tickets/backlog/TICKET-035_notes-files-tools.md
ilia 7c633a02ed Initialize project structure with essential files and documentation
- Added .cursorrules for project guidelines and context
- Created README.md for project overview and goals
- Established ARCHITECTURE.md for architectural documentation
- Set up tickets directory with initial ticket management files
- Included .gitignore to manage ignored files and directories

This commit lays the foundation for the Atlas project, ensuring a clear structure for development and collaboration.
2026-01-05 20:09:44 -05:00

1.5 KiB

Ticket: Notes & Files (Markdown, PDFs)

Ticket Information

  • ID: TICKET-035
  • Title: Notes & Files (Markdown, PDFs)
  • Type: Feature
  • Priority: Medium
  • Status: Backlog
  • Track: Tools/MCP
  • Milestone: Milestone 3 - Memory, Reminders, Safety
  • Created: 2024-01-XX

Description

Implement notes and file tools:

  • File indexing/search strategy (ripgrep + embeddings later)
  • Start with basic full-text search + metadata
  • MCP tools: search_notes, read_note, append_to_note, create_note
  • PDF handling with lightweight text extractor

Acceptance Criteria

  • File indexing implemented
  • Full-text search working
  • MCP tools for notes (search, read, append, create)
  • PDF text extraction working
  • get_pdf_text tool implemented
  • Tools registered in MCP server

Technical Details

Search strategy:

  • Phase 1: ripgrep for full-text search
  • Phase 2: Add embeddings for semantic search
  • Index: Markdown files, text files, PDFs

PDF extraction:

  • Use PyPDF2, pdfplumber, or similar
  • Extract text, preserve structure if possible

Tools:

  • search_notes: Full-text search
  • read_note: Read file content
  • append_to_note: Add to existing note
  • create_note: Create new note
  • get_pdf_text: Extract PDF text

Dependencies

  • TICKET-029 (MCP server)
  • Stable directory layout and backup strategy
  • home-voice-agent/mcp-server/tools/notes/ (to be created)

Notes

Needs stable directory layout. Can be enhanced with embeddings later.