@prmichaelsen/remember-mcp 0.1.0

package/agent/milestones/milestone-2-core-memory-system.md

@@ -0,0 +1,150 @@
+# Milestone 2: Core Memory System
+
+**Goal**: Implement basic memory CRUD operations with user isolation  
+**Duration**: 2 weeks  
+**Dependencies**: M1 (Project Foundation)  
+**Status**: Not Started
+
+---
+
+## Overview
+
+Implement the core memory system with create, read, update, delete, and search operations. Establish user isolation with per-user Weaviate collections.
+
+---
+
+## Deliverables
+
+### 1. Memory Schema
+- Complete Memory interface (25+ fields)
+- Weaviate schema for Memory_{user_id} collection
+- Support for doc_type discriminator
+- Vector embedding configuration
+
+### 2. Memory CRUD Tools (6 tools)
+- remember_create_memory
+- remember_update_memory
+- remember_delete_memory
+- remember_search_memory (hybrid search)
+- remember_find_similar
+- remember_query_memory (RAG)
+
+### 3. User Isolation
+- Per-user collection naming: Memory_{sanitized_user_id}
+- Collection creation on first use
+- Verify no cross-user data access
+
+### 4. Context Integration
+- Extract location from request context
+- Extract locale and timezone from cookies
+- Store context with each memory
+
+---
+
+## Success Criteria
+
+- [ ] Can create memories with all fields (content, type, weight, trust, location, context)
+- [ ] Can search memories semantically (hybrid search working)
+- [ ] Can update memories (version tracking works)
+- [ ] Can delete memories
+- [ ] Can find similar memories
+- [ ] RAG queries return relevant answers
+- [ ] User data completely isolated (tested with multiple users)
+- [ ] Location and locale stored correctly from cookies
+
+---
+
+## Key Files to Create
+
+```
+src/
+├── types/
+│   ├── memory.ts           # Memory interface
+│   ├── context.ts          # RequestContext interface
+│   └── location.ts         # Location/Locale interfaces
+├── weaviate/
+│   └── memory-schema.ts    # Weaviate schema definition
+├── tools/
+│   ├── create-memory.ts
+│   ├── update-memory.ts
+│   ├── delete-memory.ts
+│   ├── search-memory.ts
+│   ├── find-similar.ts
+│   └── query-memory.ts
+└── services/
+    └── context-extractor.ts  # Extract location/locale from cookies
+```
+
+---
+
+## Memory Schema (Weaviate)
+
+```yaml
+Memory_{user_id}:
+  # Discriminator
+  doc_type: text              # "memory" or "relationship"
+  
+  # Core
+  user_id: text
+  content: text               # Vectorized
+  title: text
+  summary: text
+  type: text                  # Content type
+  
+  # Scoring
+  weight: number              # 0-1
+  trust: number               # 0-1
+  confidence: number          # 0-1
+  
+  # Location (from cookies)
+  location_gps_lat: number
+  location_gps_lng: number
+  location_address: text
+  location_city: text
+  location_country: text
+  
+  # Locale (from cookies)
+  locale_language: text
+  locale_timezone: text
+  
+  # Context
+  context_conversation_id: text
+  context_summary: text
+  context_timestamp: date
+  
+  # Relationships
+  relationships: text[]       # Array of relationship IDs
+  
+  # Access tracking
+  access_count: number
+  last_accessed_at: date
+  
+  # Metadata
+  tags: text[]
+  references: text[]          # Source URLs
+  created_at: date
+  updated_at: date
+  version: number
+  
+  # Template
+  template_id: text
+```
+
+---
+
+## Testing
+
+- [ ] Create memory test
+- [ ] Update memory test
+- [ ] Delete memory test
+- [ ] Search memory test (semantic + keyword)
+- [ ] Find similar test
+- [ ] RAG query test
+- [ ] User isolation test (critical!)
+- [ ] Location extraction test
+- [ ] Locale extraction test
+
+---
+
+**Next Milestone**: M3 - Relationships & Graph  
+**Blockers**: M1 must be complete

package/agent/milestones/milestone-3-relationships-graph.md

@@ -0,0 +1,116 @@
+# Milestone 3: Relationships & Graph
+
+**Goal**: Implement memory relationships stored in Memory collection  
+**Duration**: 1 week  
+**Dependencies**: M2 (Core Memory System)  
+**Status**: Not Started
+
+---
+
+## Overview
+
+Implement relationship system that connects memories together. Relationships are stored in the same Memory_{user_id} collection with doc_type: "relationship" for unified RAG queries.
+
+---
+
+## Deliverables
+
+### 1. Relationship Schema
+- Relationship interface with free-form types
+- Store in Memory_{user_id} with doc_type: "relationship"
+- Support N-way relationships (2...N memories)
+- Context with summary
+
+### 2. Relationship Tools (4 tools)
+- remember_create_relationship
+- remember_update_relationship
+- remember_search_relationship
+- remember_delete_relationship
+
+### 3. Bidirectional Tracking
+- Update connected memories' relationships arrays
+- Maintain consistency on create/delete
+- Handle orphaned relationships
+
+### 4. Unified Queries
+- Search memories and relationships together
+- Filter by doc_type when needed
+- RAG queries include relationship context
+
+---
+
+## Success Criteria
+
+- [ ] Can create relationships between 2...N memories
+- [ ] Relationship types are free-form strings (agent decides)
+- [ ] Can search relationships by observation text
+- [ ] Relationships and memories queryable together (single query)
+- [ ] RAG includes relationship context
+- [ ] Bidirectional updates work correctly
+- [ ] Deleting memory handles relationships appropriately
+
+---
+
+## Key Files to Create
+
+```
+src/
+├── types/
+│   └── relationship.ts     # Relationship interface
+├── tools/
+│   ├── create-relationship.ts
+│   ├── update-relationship.ts
+│   ├── search-relationship.ts
+│   └── delete-relationship.ts
+└── services/
+    └── relationship-manager.ts  # Bidirectional updates
+```
+
+---
+
+## Relationship Schema (in Memory_{user_id})
+
+```yaml
+Relationship (doc_type: "relationship"):
+  # Discriminator
+  doc_type: "relationship"
+  
+  # Core
+  user_id: text
+  memory_ids: text[]          # 2...N memory IDs
+  relationship_type: text     # Free-form: "inspired_by", "contradicts", etc.
+  
+  # Description
+  observation: text           # Vectorized for semantic search
+  strength: number            # 0-1
+  confidence: number          # 0-1
+  
+  # Context
+  context_conversation_id: text
+  context_summary: text
+  context_timestamp: date
+  
+  # Metadata
+  tags: text[]
+  created_at: date
+  updated_at: date
+  version: number
+```
+
+---
+
+## Testing
+
+- [ ] Create 2-way relationship test
+- [ ] Create N-way relationship test
+- [ ] Search relationships test
+- [ ] Update relationship test
+- [ ] Delete relationship test
+- [ ] Bidirectional update test
+- [ ] Unified memory+relationship query test (RAG)
+- [ ] Orphan handling test
+
+---
+
+**Next Milestone**: M4 - User Preferences  
+**Blockers**: M2 must be complete

package/agent/milestones/milestone-4-user-preferences.md

@@ -0,0 +1,103 @@
+# Milestone 4: User Preferences
+
+**Goal**: Implement user preference system with conversational management  
+**Duration**: 1 week  
+**Dependencies**: M2 (Core Memory System)  
+**Status**: Not Started
+
+---
+
+## Overview
+
+Implement user preferences stored in Firestore with tools to manage preferences through natural conversation.
+
+---
+
+## Deliverables
+
+### 1. Preferences Schema
+- UserPreferences interface
+- Default preferences
+- Preference validation
+- Store in users/{user_id}/preferences
+
+### 2. Preference Tools (2 tools)
+- remember_update_preferences
+- remember_get_preferences
+
+### 3. Preference Integration
+- Template auto-suggest respects preferences
+- Search uses preference defaults
+- Trust defaults from preferences
+- All tools check preferences
+
+---
+
+## Success Criteria
+
+- [ ] Preferences stored in Firestore users/{user_id}/preferences
+- [ ] Can update preferences via conversation
+- [ ] Can query current preferences
+- [ ] Template auto-suggest respects preferences.templates.auto_suggest
+- [ ] Search uses preferences.search.default_limit
+- [ ] New memories use preferences.privacy.default_trust_level
+- [ ] Preference changes logged
+
+---
+
+## Key Files to Create
+
+```
+src/
+├── types/
+│   └── preferences.ts      # UserPreferences interface
+├── firestore/
+│   └── preferences.ts      # Preference CRUD
+├── tools/
+│   ├── update-preferences.ts
+│   └── get-preferences.ts
+└── services/
+    └── preference-manager.ts
+```
+
+---
+
+## Preferences Schema (Firestore)
+
+```typescript
+users/{user_id}/preferences:
+  templates:
+    auto_suggest: boolean (default: true)
+    suggestion_threshold: number (default: 0.6)
+    max_suggestions: number (default: 3)
+    suppressed_categories: string[]
+    
+  search:
+    default_limit: number (default: 10)
+    default_alpha: number (default: 0.7)
+    weight_by_access: boolean (default: true)
+    
+  privacy:
+    default_trust_level: number (default: 0.5)
+    allow_cross_user_access: boolean (default: false)
+    
+  location:
+    auto_capture: boolean (default: true)
+    precision: string (default: "approximate")
+```
+
+---
+
+## Testing
+
+- [ ] Get preferences test (with defaults)
+- [ ] Update preferences test
+- [ ] Preference validation test
+- [ ] Integration: template auto-suggest respects preferences
+- [ ] Integration: search uses preference defaults
+- [ ] Conversational preference update test
+
+---
+
+**Next Milestone**: M5 - Template System  
+**Blockers**: M2 must be complete

package/agent/milestones/milestone-5-template-system.md

@@ -0,0 +1,126 @@
+# Milestone 5: Template System
+
+**Goal**: Implement template system with default library and auto-suggestion  
+**Duration**: 2 weeks  
+**Dependencies**: M2 (Core Memory), M4 (Preferences)  
+**Status**: Not Started
+
+---
+
+## Overview
+
+Implement the template system with 15 default templates, auto-suggestion based on context, and user custom templates.
+
+---
+
+## Deliverables
+
+### 1. Template Schema
+- Template interface
+- Field definition schema
+- Trigger configuration
+- Store in Template_system and Template_{user_id}
+
+### 2. Default Template Library
+- 15 curated default templates
+- Person, Meeting Notes, Restaurant Review, Book Review, etc.
+- Inventory Item template
+- All templates include references, tags, notes fields
+
+### 3. Template Suggestion
+- Keyword matching algorithm
+- Context pattern matching
+- Semantic similarity matching
+- Scoring and ranking
+- Integration with remember_create_memory
+
+### 4. Template Tools (6 tools)
+- remember_create_template
+- remember_list_templates
+- remember_get_template
+- remember_update_template
+- remember_delete_template
+- remember_copy_template
+
+### 5. Firestore Storage
+- templates/default/{weaviate_uuid} for defaults
+- users/{user_id}/templates/{weaviate_uuid} for user templates
+- No sharing (promotion model instead)
+
+---
+
+## Success Criteria
+
+- [ ] 15 default templates available to all users
+- [ ] Template suggestion works based on keywords and context
+- [ ] Users can create custom templates
+- [ ] Users can copy and modify default templates
+- [ ] Template validation works
+- [ ] Auto-suggest respects user preferences
+- [ ] Templates stored correctly in Firestore and Weaviate
+
+---
+
+## Key Files to Create
+
+```
+src/
+├── types/
+│   └── template.ts
+├── templates/
+│   └── defaults/
+│       ├── person.ts
+│       ├── meeting-notes.ts
+│       ├── restaurant-review.ts
+│       ├── inventory-item.ts
+│       └── ... (11 more)
+├── services/
+│   ├── template-suggestion.ts
+│   └── template-manager.ts
+├── tools/
+│   ├── create-template.ts
+│   ├── list-templates.ts
+│   ├── get-template.ts
+│   ├── update-template.ts
+│   ├── delete-template.ts
+│   └── copy-template.ts
+└── firestore/
+    └── templates.ts
+```
+
+---
+
+## Default Templates (15)
+
+1. Person - Unified personal/professional contacts
+2. Meeting Notes - Work meetings
+3. Project Tracker - Project management
+4. Task - Action items
+5. Journal Entry - Daily journaling
+6. Goal - Goal tracking
+7. Habit - Habit tracking
+8. Inventory Item - Home organization
+9. Restaurant Review - Dining experiences
+10. Book Review - Books read
+11. Movie Review - Movies/shows watched
+12. Recipe - Cooking recipes
+13. Idea - Quick ideas
+14. Learning Note - Things learned
+15. Travel Destination - Places visited
+
+---
+
+## Testing
+
+- [ ] Template creation test
+- [ ] Template suggestion test (keyword matching)
+- [ ] Template suggestion test (context matching)
+- [ ] Template validation test
+- [ ] User template CRUD test
+- [ ] Copy default template test
+- [ ] Integration: create memory with template
+
+---
+
+**Next Milestone**: M6 - Auth & Multi-Tenancy  
+**Blockers**: M2 and M4 must be complete

package/agent/milestones/milestone-6-auth-multi-tenancy.md

@@ -0,0 +1,124 @@
+# Milestone 6: Authentication & Multi-Tenancy
+
+**Goal**: Implement Firebase authentication and SSE transport  
+**Duration**: 1 week  
+**Dependencies**: M1-M5 (All previous milestones)  
+**Status**: Not Started
+
+---
+
+## Overview
+
+Integrate Firebase authentication for user identification and implement SSE transport for remote access. Verify multi-user isolation.
+
+---
+
+## Deliverables
+
+### 1. Firebase Authentication
+- JWT token validation
+- Extract user_id from token
+- Auth error handling
+- Token refresh handling
+
+### 2. Request Context Extraction
+- Parse location from cookies
+- Parse locale from cookies
+- Parse timezone from cookies
+- Validate context data
+
+### 3. SSE Transport
+- HTTP server setup
+- SSE endpoint implementation
+- MCP protocol over SSE
+- Connection management
+
+### 4. Multi-User Verification
+- Test with multiple users simultaneously
+- Verify data isolation
+- Test concurrent operations
+- Load testing
+
+---
+
+## Success Criteria
+
+- [ ] Firebase JWT tokens validated correctly
+- [ ] user_id extracted from tokens
+- [ ] Invalid tokens rejected with clear errors
+- [ ] Location extracted from cookies
+- [ ] Locale and timezone extracted from cookies
+- [ ] SSE transport works with MCP clients
+- [ ] Multiple users can connect simultaneously
+- [ ] User data completely isolated (no leaks)
+- [ ] Performance acceptable with 100 concurrent users
+
+---
+
+## Key Files to Create
+
+```
+src/
+├── auth/
+│   ├── firebase-provider.ts
+│   └── token-validator.ts
+├── transport/
+│   ├── sse-server.ts
+│   └── connection-manager.ts
+├── middleware/
+│   ├── auth-middleware.ts
+│   └── context-middleware.ts
+└── services/
+    └── context-parser.ts
+```
+
+---
+
+## Request Context Structure
+
+```typescript
+RequestContext {
+  // Auth
+  user_id: string;
+  auth_token: string;
+  
+  // Location (from cookies)
+  location: {
+    gps: { latitude, longitude, accuracy };
+    address: { formatted, city, state, country };
+    source: string;
+    confidence: number;
+  };
+  
+  // Locale (from cookies)
+  locale: {
+    language: string;
+    country: string;
+    timezone: string;
+    currency: string;
+  };
+  
+  // Session
+  timestamp: datetime;
+  session_id: string;
+}
+```
+
+---
+
+## Testing
+
+- [ ] Valid JWT authentication test
+- [ ] Invalid JWT rejection test
+- [ ] Expired token test
+- [ ] Location extraction test
+- [ ] Locale extraction test
+- [ ] SSE connection test
+- [ ] Multi-user isolation test
+- [ ] Concurrent user test
+- [ ] Load test (100 users)
+
+---
+
+**Next Milestone**: M7 - Trust & Permissions  
+**Blockers**: M1-M5 must be complete