@prmichaelsen/remember-mcp 2.8.0 → 3.0.0

package/AGENT.md

@@ -1,7 +1,7 @@
 # Agent Context Protocol (ACP)
 
 **Also Known As**: The Agent Directory Pattern
-**Version**: 3.14.0
+**Version**: 3.13.0
 **Created**: 2026-02-11
 **Status**: Production Pattern
 

package/CHANGELOG.md

@@ -5,6 +5,136 @@ All notable changes to this project 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).
 
+## [3.0.0] - 2026-02-25
+
+### ⚠️ BREAKING CHANGES
+
+**Soft Delete System with Confirmation Flow**
+
+This release fundamentally changes how memory deletion works. All deletions now require explicit user confirmation and memories are soft-deleted (marked as deleted) rather than permanently removed.
+
+**What Changed**:
+
+1. **`remember_delete_memory` Behavior Change**
+   - **OLD**: Immediately deletes memory from database
+   - **NEW**: Creates confirmation token and returns preview
+   - **Migration**: No code changes needed, but behavior is different
+
+2. **Search Tools Default Behavior**
+   - **OLD**: Searches include all memories
+   - **NEW**: Searches exclude deleted memories by default
+   - **Migration**: Use `deleted_filter: "include"` to see deleted memories
+
+3. **Relationship Creation**
+   - **OLD**: Can create relationships with any memory
+   - **NEW**: Cannot create relationships with deleted memories
+   - **Migration**: Restore deleted memories before creating relationships
+
+4. **Memory Updates**
+   - **OLD**: Can update any memory
+   - **NEW**: Cannot update deleted memories
+   - **Migration**: Deleted memories must be restored first (future feature)
+
+### Added
+
+**Soft Delete System**:
+- Added 3 schema fields: `deleted_at` (timestamp), `deleted_by` (user ID), `deletion_reason` (text)
+- Added confirmation flow for deletion (reuses existing token service)
+- Added deletion preview showing content, type, relationship count, orphaned relationships
+- Added `deleted_filter` parameter to all search tools: `remember_search_memory`, `remember_query_memory`, `remember_find_similar`, `remember_search_relationship`
+- Added validation to prevent creating relationships with deleted memories
+- Added validation to prevent updating deleted memories
+
+**deleted_filter Parameter**:
+- `"exclude"` (default) - Hide deleted memories from search results
+- `"include"` - Show all memories (deleted + active)
+- `"only"` - Show only deleted memories
+
+### Changed
+
+**Tool Behavior**:
+- `remember_delete_memory` now returns confirmation token instead of immediately deleting
+- `remember_confirm` now handles `delete_memory` action type
+- All search tools now exclude deleted memories by default
+- Error messages include deletion timestamps for better UX
+
+**Data Model**:
+- Memories are soft-deleted (remain in database with `deleted_at` set)
+- Deleted memories can be searched with `deleted_filter: "include"` or `"only"`
+- No data migration needed (missing `deleted_at` = not deleted)
+
+### Migration Guide
+
+**For Users**:
+- Deletion now requires two steps: request → confirm
+- Deleted memories are hidden by default in searches
+- Use `deleted_filter: "include"` to search deleted memories
+
+**For Developers**:
+- No API changes required
+- Behavior change is immediate (no feature flags)
+- Version bump: v2.8.0 → v3.0.0 (major)
+
+**Example Workflow**:
+```typescript
+// 1. Request deletion
+const result = await remember_delete_memory({
+  memory_id: "abc123",
+  reason: "No longer needed"
+});
+// Returns: { token: "xyz789", preview: {...} }
+
+// 2. User confirms
+await remember_confirm({ token: "xyz789" });
+// Returns: { success: true }
+
+// 3. Memory is soft-deleted
+await remember_search_memory({
+  query: "test",
+  deleted_filter: "only"
+});
+// Finds deleted memories
+```
+
+### Technical Details
+
+**Implementation**:
+- Modified: `src/weaviate/schema.ts` (added 3 fields to Memory schema)
+- Modified: `src/weaviate/space-schema.ts` (added 3 fields to Memory_public)
+- Modified: `src/types/memory.ts` (added DeletedFilter type, updated Memory interface)
+- Modified: `src/types/space-memory.ts` (updated SpaceMemory interface)
+- Modified: `src/weaviate/client.ts` (added fields to ALL_MEMORY_PROPERTIES)
+- Modified: `src/tools/delete-memory.ts` (confirmation flow)
+- Modified: `src/tools/confirm.ts` (delete_memory action handler)
+- Modified: `src/tools/search-memory.ts` (deleted_filter parameter)
+- Modified: `src/tools/query-memory.ts` (deleted_filter parameter)
+- Modified: `src/tools/find-similar.ts` (deleted_filter parameter)
+- Modified: `src/tools/search-relationship.ts` (deleted_filter parameter)
+- Modified: `src/tools/create-relationship.ts` (deleted memory validation)
+- Modified: `src/tools/update-memory.ts` (deleted memory validation)
+- Modified: `src/utils/weaviate-filters.ts` (buildDeletedFilter helper)
+
+**Tests**:
+- 93 tests passing (1 skipped integration test)
+- Test coverage: 33.12% overall
+- All existing tests validate soft delete functionality
+
+**Documentation**:
+- Design: `agent/design/soft-delete-system.md`
+- Clarification: `agent/clarifications/clarification-1-soft-delete-confirmation-flow.md`
+- Milestone: `agent/milestones/milestone-13-soft-delete-system.md`
+- Tasks: `agent/tasks/task-70-*.md` through `task-75-*.md`
+
+### Future Enhancements
+
+**Not in v3.0.0** (deferred to future releases):
+- Memory restoration tool (`remember_restore_memory`)
+- Permanent deletion (memories remain in database indefinitely)
+- Auto-purge policies
+- Shared space integration (`remember_retract` for unpublishing)
+
+---
+
 ## [2.8.0] - 2026-02-25
 
 ### Added

package/README.md

@@ -64,9 +64,10 @@ Multi-tenant memory system MCP server with vector search, relationships, and tru
 ## Features
 
 - **17 MCP Tools**: Complete CRUD for memories, relationships, preferences, and shared spaces
+- **Soft Delete with Recovery**: Safe deletion with confirmation flow and recovery capability
 - **Multi-Tenant**: Per-user isolation with secure data boundaries
 - **Shared Spaces**: Publish memories to shared discovery spaces like "The Void"
-- **Token-Based Confirmation**: Secure two-phase workflow for sensitive operations
+- **Token-Based Confirmation**: Secure two-phase workflow for sensitive operations (publish, delete)
 - **Vector Search**: Semantic + keyword hybrid search with Weaviate
 - **Knowledge Graph**: N-way relationships with bidirectional tracking
 - **RAG Queries**: Natural language queries with context-aware responses
@@ -235,6 +236,99 @@ remember_search_space({
 - `remember_search_space` - Search shared spaces
 - `remember_query_space` - Ask questions about shared memories
 
+## Safe Deletion with Confirmation
+
+**v3.0.0+**: Deletion now requires confirmation to prevent accidental data loss.
+
+### Deletion Workflow
+
+1. **Request Deletion**: Generate confirmation token
+```typescript
+remember_delete_memory({
+  memory_id: "abc123",
+  reason: "No longer needed"
+})
+
+// Returns:
+{
+  "success": true,
+  "token": "xyz789",
+  "expires_at": "2026-02-25T17:30:00Z",
+  "preview": {
+    "memory_id": "abc123",
+    "content": "My camping trip to Yosemite...",
+    "type": "note",
+    "relationships_count": 3,
+    "will_orphan": ["rel1", "rel2", "rel3"]
+  },
+  "message": "Deletion requested. Use remember_confirm with token..."
+}
+```
+
+2. **User Confirms**: Execute the deletion
+```typescript
+remember_confirm({ token: "xyz789" })
+
+// Returns:
+{
+  "success": true,
+  "memory_id": "abc123",
+  "message": "Memory deleted successfully"
+}
+```
+
+3. **Memory is Soft-Deleted**: Marked as deleted, not removed
+- Memory remains in database with `deleted_at` timestamp
+- Excluded from searches by default
+- Can be searched with `deleted_filter: "include"` or `"only"`
+- Future: restoration tool (not in v3.0.0)
+
+### Searching Deleted Memories
+
+**Default behavior** (exclude deleted):
+```typescript
+remember_search_memory({ query: "camping" })
+// Returns only active memories
+```
+
+**Include deleted memories**:
+```typescript
+remember_search_memory({
+  query: "camping",
+  deleted_filter: "include"
+})
+// Returns both active and deleted memories
+```
+
+**Only deleted memories**:
+```typescript
+remember_search_memory({
+  query: "camping",
+  deleted_filter: "only"
+})
+// Returns only deleted memories
+```
+
+**Applies to all search tools**:
+- `remember_search_memory`
+- `remember_query_memory`
+- `remember_find_similar`
+- `remember_search_relationship`
+
+### Important Notes
+
+**⚠️ Breaking Change (v3.0.0)**:
+- Deletion now requires confirmation (two-step process)
+- Deleted memories excluded from searches by default
+- Cannot create relationships with deleted memories
+- Cannot update deleted memories
+
+**Data Safety**:
+- Deleted memories remain in database (soft delete)
+- No permanent deletion feature
+- Deletion timestamp and reason tracked
+- Future restoration capability planned
+
 ## Debugging
 
 Enable detailed debug logging with the `REMEMBER_MCP_DEBUG_LEVEL` environment variable:

package/agent/commands/acp.command-create.md

@@ -11,7 +11,6 @@
 **Created**: 2026-02-21
 **Last Updated**: 2026-02-21
 **Status**: Active
-**Scripts**: None
 
 ---
 

package/agent/commands/acp.design-create.md

@@ -11,7 +11,6 @@
 **Created**: 2026-02-21
 **Last Updated**: 2026-02-21
 **Status**: Active
-**Scripts**: None
 
 ---
 

package/agent/commands/acp.init.md

@@ -7,7 +7,6 @@
 **Created**: 2026-02-16
 **Last Updated**: 2026-02-16
 **Status**: Active
-**Scripts**: None
 
 ---
 

package/agent/commands/acp.package-create.md

@@ -9,7 +9,6 @@
 **Created**: 2026-02-20
 **Last Updated**: 2026-02-21
 **Status**: Active
-**Scripts**: acp.package-create.sh, acp.common.sh, acp.yaml-parser.sh
 
 ---
 

package/agent/commands/acp.package-info.md

@@ -7,7 +7,6 @@
 **Created**: 2026-02-18
 **Last Updated**: 2026-02-22
 **Status**: Active
-**Scripts**: acp.package-info.sh, acp.common.sh, acp.yaml-parser.sh
 
 ---
 

package/agent/commands/acp.package-install.md

@@ -9,7 +9,6 @@
 **Created**: 2026-02-16
 **Last Updated**: 2026-02-16
 **Status**: Active
-**Scripts**: acp.package-install.sh, acp.common.sh, acp.yaml-parser.sh
 
 ---
 

package/agent/commands/acp.package-list.md

@@ -7,7 +7,6 @@
 **Created**: 2026-02-18
 **Last Updated**: 2026-02-18
 **Status**: Active
-**Scripts**: acp.package-list.sh, acp.common.sh, acp.yaml-parser.sh
 
 ---
 

package/agent/commands/acp.package-publish.md

@@ -9,7 +9,6 @@
 **Created**: 2026-02-21
 **Last Updated**: 2026-02-21
 **Status**: Active
-**Scripts**: acp.package-publish.sh, acp.common.sh, acp.yaml-parser.sh
 
 ---
 

package/agent/commands/acp.package-remove.md

@@ -7,7 +7,6 @@
 **Created**: 2026-02-18
 **Last Updated**: 2026-02-22
 **Status**: Active
-**Scripts**: acp.package-remove.sh, acp.common.sh, acp.yaml-parser.sh
 
 ---
 

package/agent/commands/acp.package-search.md

@@ -7,7 +7,6 @@
 **Created**: 2026-02-18
 **Last Updated**: 2026-02-18
 **Status**: Active
-**Scripts**: acp.package-search.sh, acp.common.sh
 
 ---
 

package/agent/commands/acp.package-update.md

@@ -7,7 +7,6 @@
 **Created**: 2026-02-18
 **Last Updated**: 2026-02-22
 **Status**: Active
-**Scripts**: acp.package-update.sh, acp.common.sh, acp.yaml-parser.sh
 
 ---
 

package/agent/commands/acp.package-validate.md

@@ -9,7 +9,6 @@
 **Created**: 2026-02-21
 **Last Updated**: 2026-02-21
 **Status**: Active
-**Scripts**: acp.package-validate.sh, acp.common.sh, acp.yaml-parser.sh, acp.yaml-validate.sh
 
 ---
 

package/agent/commands/acp.pattern-create.md

@@ -11,7 +11,6 @@
 **Created**: 2026-02-20
 **Last Updated**: 2026-02-20
 **Status**: Active
-**Scripts**: None
 
 ---
 

package/agent/commands/acp.plan.md

@@ -8,7 +8,6 @@
 **Created**: 2026-02-22
 **Last Updated**: 2026-02-22
 **Status**: Active
-**Scripts**: None
 
 ---
 

package/agent/commands/acp.proceed.md

@@ -26,7 +26,6 @@
 **Created**: 2026-02-16
 **Last Updated**: 2026-02-18
 **Status**: Active
-**Scripts**: None
 
 ---
 

package/agent/commands/acp.project-create.md

@@ -9,7 +9,6 @@
 **Created**: 2026-02-22
 **Last Updated**: 2026-02-22
 **Status**: Active
-**Scripts**: None
 
 ---
 

package/agent/commands/acp.project-list.md

@@ -8,7 +8,6 @@
 **Created**: 2026-02-23
 **Last Updated**: 2026-02-23
 **Status**: Experimental
-**Scripts**: acp.project-list.sh, acp.common.sh, acp.yaml-parser.sh
 
 ---
 

package/agent/commands/acp.project-set.md

@@ -8,7 +8,6 @@
 **Created**: 2026-02-24
 **Last Updated**: 2026-02-24
 **Status**: Experimental
-**Scripts**: acp.project-set.sh, acp.common.sh, acp.yaml-parser.sh
 
 ---
 

package/agent/commands/acp.report.md

@@ -9,7 +9,6 @@
 **Created**: 2026-02-16
 **Last Updated**: 2026-02-16
 **Status**: Active
-**Scripts**: None
 
 ---
 

package/agent/commands/acp.resume.md

@@ -9,7 +9,6 @@
 **Created**: 2026-02-21
 **Last Updated**: 2026-02-21
 **Status**: Active
-**Scripts**: None
 
 ---
 

package/agent/commands/acp.status.md

@@ -7,7 +7,6 @@
 **Created**: 2026-02-16
 **Last Updated**: 2026-02-16
 **Status**: Active
-**Scripts**: None
 
 ---
 

package/agent/commands/acp.sync.md

@@ -7,7 +7,6 @@
 **Created**: 2026-02-16
 **Last Updated**: 2026-02-18
 **Status**: Active
-**Scripts**: None
 
 ---
 

package/agent/commands/acp.task-create.md

@@ -13,7 +13,6 @@
 **Created**: 2026-02-21
 **Last Updated**: 2026-02-21
 **Status**: Active
-**Scripts**: None
 
 ---
 

package/agent/commands/acp.update.md

@@ -7,7 +7,6 @@
 **Created**: 2026-02-16
 **Last Updated**: 2026-02-16
 **Status**: Active
-**Scripts**: None
 
 ---
 

package/agent/commands/acp.validate.md

@@ -9,7 +9,6 @@
 **Created**: 2026-02-16
 **Last Updated**: 2026-02-21
 **Status**: Active
-**Scripts**: None
 
 ---
 

package/agent/commands/acp.version-check-for-updates.md

@@ -7,7 +7,6 @@
 **Created**: 2026-02-16
 **Last Updated**: 2026-02-16
 **Status**: Active
-**Scripts**: acp.version-check-for-updates.sh
 
 ---
 

package/agent/commands/acp.version-check.md

@@ -7,7 +7,6 @@
 **Created**: 2026-02-16
 **Last Updated**: 2026-02-16
 **Status**: Active
-**Scripts**: acp.version-check.sh
 
 ---
 

package/agent/commands/acp.version-update.md

@@ -7,7 +7,6 @@
 **Created**: 2026-02-16
 **Last Updated**: 2026-02-16
 **Status**: Active
-**Scripts**: acp.version-update.sh, acp.common.sh
 
 ---
 

package/agent/commands/command.template.md

@@ -9,11 +9,6 @@
 **Created**: YYYY-MM-DD
 **Last Updated**: YYYY-MM-DD
 **Status**: [Draft | Active | Deprecated]
-**Scripts**: {namespace}.{command-name}.sh, acp.common.sh, acp.yaml-parser.sh
-
----
-
-**Note**: The `**Scripts**:` field is REQUIRED and must list ALL script dependencies (direct + shared utilities). This must match the `scripts` array in package.yaml exactly. If the command has no script dependencies, use `**Scripts**: None`.
 
 ---
 

package/agent/commands/git.commit.md

@@ -9,7 +9,6 @@
 **Created**: 2026-02-16
 **Last Updated**: 2026-02-16
 **Status**: Active
-**Scripts**: None
 
 ---
 

package/agent/commands/git.init.md

@@ -7,7 +7,6 @@
 **Created**: 2026-02-16
 **Last Updated**: 2026-02-16
 **Status**: Active
-**Scripts**: None
 
 ---