@prmichaelsen/remember-mcp 2.2.1 → 2.3.0

package/agent/tasks/task-41-configure-firestore-ttl.md

@@ -0,0 +1,188 @@
+# Task 41: Configure Firestore TTL Policy
+
+**Milestone**: M10 - Shared Spaces & Confirmation Flow
+**Estimated Time**: 1 hour
+**Dependencies**: Task 34 (Token Service)
+**Status**: Not Started
+
+---
+
+## Objective
+
+Configure Firestore Time-to-Live (TTL) policy to automatically delete expired confirmation tokens. This prevents accumulation of stale data and ensures cleanup without manual intervention.
+
+---
+
+## Steps
+
+### 1. Understand Firestore TTL
+
+Research Firestore TTL configuration.
+
+**Actions**:
+- Read Firestore TTL documentation
+- Understand collection group policies
+- Learn about TTL field requirements
+- Note deletion timing (within 24 hours of expiry)
+
+**Expected Outcome**: TTL concept understood
+
+### 2. Access GCP Console
+
+Navigate to Firestore TTL configuration.
+
+**Actions**:
+- Open Google Cloud Console
+- Navigate to Firestore
+- Find "Time-to-live" section
+- Verify project access
+
+**Expected Outcome**: TTL configuration page accessed
+
+### 3. Create TTL Policy
+
+Configure automatic deletion for confirmation tokens.
+
+**Actions**:
+- Click "Create Policy"
+- Select collection group: `requests`
+- Set TTL field: `expires_at`
+- Confirm policy creation
+- Wait for policy to activate
+
+**Expected Outcome**: TTL policy created
+
+### 4. Verify Policy Configuration
+
+Ensure policy is active and correct.
+
+**Actions**:
+- Check policy status (should be "Active")
+- Verify collection group: `requests`
+- Verify TTL field: `expires_at`
+- Note policy ID for documentation
+
+**Expected Outcome**: Policy verified
+
+### 5. Test Token Expiry
+
+Create test token and verify automatic deletion.
+
+**Actions**:
+- Create test confirmation request with short expiry (1 minute)
+- Wait for expiry time to pass
+- Wait up to 24 hours for deletion
+- Verify token document is deleted
+- Document deletion timing
+
+**Expected Outcome**: Automatic deletion confirmed
+
+### 6. Document Configuration
+
+Create documentation for TTL setup.
+
+**Actions**:
+- Document steps in README or setup guide
+- Include screenshots if helpful
+- Note timing expectations (within 24 hours)
+- Add troubleshooting tips
+- Document policy ID
+
+**Expected Outcome**: Configuration documented
+
+### 7. Update Code Comments
+
+Add comments about TTL in token service.
+
+**Actions**:
+- Update `confirmation-token.service.ts` comments
+- Note that Firestore TTL handles deletion
+- Explain `cleanupExpired()` is optional
+- Document timing expectations
+
+**Expected Outcome**: Code comments updated
+
+### 8. Create Monitoring Alert (Optional)
+
+Set up alert for TTL policy issues.
+
+**Actions**:
+- Create Cloud Monitoring alert
+- Monitor for TTL policy errors
+- Set notification channels
+- Document alert configuration
+
+**Expected Outcome**: Monitoring in place
+
+---
+
+## Verification
+
+- [ ] Firestore TTL policy created
+- [ ] Collection group set to `requests`
+- [ ] TTL field set to `expires_at`
+- [ ] Policy status is "Active"
+- [ ] Test token automatically deleted
+- [ ] Configuration documented
+- [ ] Code comments updated
+- [ ] Optional: Monitoring alert created
+
+---
+
+## Configuration Details
+
+**Policy Settings**:
+- **Collection Group**: `requests`
+- **TTL Field**: `expires_at`
+- **Deletion Timing**: Within 24 hours after expiry
+- **Scope**: All documents in `pending_confirmations/{user_id}/requests/` collections
+
+**Important Notes**:
+- Deletion is not immediate (up to 24 hours)
+- TTL field must be a Timestamp type
+- Policy applies to collection group (all matching collections)
+- No cost for TTL deletions
+
+---
+
+## Documentation Template
+
+```markdown
+## Firestore TTL Configuration
+
+Confirmation tokens are automatically deleted after expiry using Firestore TTL.
+
+### Setup
+
+1. Go to [Firestore Console](https://console.cloud.google.com/firestore)
+2. Navigate to "Time-to-live" section
+3. Click "Create Policy"
+4. Configure:
+   - Collection Group: `requests`
+   - TTL Field: `expires_at`
+5. Save and wait for activation
+
+### Behavior
+
+- Tokens expire after 5 minutes
+- Firestore deletes expired tokens within 24 hours
+- No manual cleanup required
+- Optional: Use `cleanupExpired()` for immediate cleanup
+
+### Troubleshooting
+
+- **Policy not active**: Wait a few minutes after creation
+- **Tokens not deleted**: Check TTL field is Timestamp type
+- **Errors**: Verify collection group name is correct
+```
+
+---
+
+## Related Files
+
+- Design: [`agent/design/publish-tools-confirmation-flow.md`](../design/publish-tools-confirmation-flow.md)
+- Token Service: [`src/services/confirmation-token.service.ts`](../../src/services/confirmation-token.service.ts)
+
+---
+
+**Next Task**: Task 42 - Create Tests for Shared Spaces

package/agent/tasks/task-42-create-tests-shared-spaces.md

@@ -0,0 +1,216 @@
+# Task 42: Create Tests for Shared Spaces
+
+**Milestone**: M10 - Shared Spaces & Confirmation Flow
+**Estimated Time**: 4 hours
+**Dependencies**: Tasks 34-40 (All implementation tasks)
+**Status**: Not Started
+
+---
+
+## Objective
+
+Create comprehensive test suite for shared spaces functionality, including unit tests, integration tests, and end-to-end workflow tests.
+
+---
+
+## Steps
+
+### 1. Review Existing Tests
+
+Understand current test patterns.
+
+**Actions**:
+- Review existing unit tests in `tests/unit/`
+- Review test utilities and mocks
+- Understand Jest configuration
+- Note testing patterns used
+
+**Expected Outcome**: Test patterns understood
+
+### 2. Create Integration Test File
+
+Create end-to-end test for publish workflow.
+
+**Actions**:
+- Create `tests/integration/publish-workflow.test.ts`
+- Test complete flow: publish → confirm → verify
+- Test complete flow: publish → deny → verify
+- Use actual Weaviate and Firestore (or emulators)
+- Clean up test data after each test
+
+**Expected Outcome**: Integration tests created
+
+### 3. Test Token Service
+
+Comprehensive tests for confirmation tokens.
+
+**Actions**:
+- Verify `tests/unit/confirmation-token.service.test.ts` exists
+- Test token creation
+- Test token validation
+- Test token expiry
+- Test confirm/deny/retract flows
+- Test cleanup function
+- Mock Firestore calls
+
+**Expected Outcome**: Token service fully tested
+
+### 4. Test Space Schema
+
+Test space collection management.
+
+**Actions**:
+- Verify `tests/unit/space-schema.test.ts` exists
+- Test `ensureSpaceCollection()`
+- Test collection name generation
+- Test space ID sanitization
+- Test display name mapping
+- Mock Weaviate client
+
+**Expected Outcome**: Space schema fully tested
+
+### 5. Test All Tools
+
+Verify all 5 new tools have tests.
+
+**Actions**:
+- Verify `tests/unit/publish.test.ts` exists
+- Verify `tests/unit/confirm.test.ts` exists
+- Verify `tests/unit/deny.test.ts` exists
+- Verify `tests/unit/search-space.test.ts` exists
+- Verify `tests/unit/query-space.test.ts` exists
+- Ensure comprehensive coverage
+- Test success and error cases
+
+**Expected Outcome**: All tools fully tested
+
+### 6. Test Multi-User Scenarios
+
+Test discovery across users.
+
+**Actions**:
+- User A publishes memory
+- User B searches space and finds it
+- User B queries space about it
+- Verify attribution (author_id)
+- Verify original memory unchanged
+
+**Expected Outcome**: Multi-user discovery working
+
+### 7. Test Security
+
+Verify security constraints.
+
+**Actions**:
+- Test user can only publish own memories
+- Test tokens are one-time use
+- Test tokens expire correctly
+- Test permission denied errors
+- Test token replay attacks fail
+
+**Expected Outcome**: Security verified
+
+### 8. Run All Tests
+
+Execute complete test suite.
+
+**Actions**:
+- Run `npm test` (unit tests)
+- Run `npm run test:e2e` (integration tests)
+- Verify all tests passing
+- Check test coverage
+- Fix any failing tests
+
+**Expected Outcome**: All tests passing
+
+### 9. Update Test Documentation
+
+Document test coverage and patterns.
+
+**Actions**:
+- Update README with test instructions
+- Document test data setup
+- Document emulator usage (if applicable)
+- Note coverage goals
+
+**Expected Outcome**: Test documentation complete
+
+---
+
+## Verification
+
+- [ ] Integration test file created
+- [ ] Token service tests complete
+- [ ] Space schema tests complete
+- [ ] All 5 tool tests complete
+- [ ] Multi-user scenarios tested
+- [ ] Security tests complete
+- [ ] All unit tests passing
+- [ ] All integration tests passing
+- [ ] Test coverage adequate (>70%)
+- [ ] Test documentation updated
+
+---
+
+## Test Structure
+
+```
+tests/
+├── unit/
+│   ├── confirmation-token.service.test.ts
+│   ├── space-schema.test.ts
+│   ├── publish.test.ts
+│   ├── confirm.test.ts
+│   ├── deny.test.ts
+│   ├── search-space.test.ts
+│   └── query-space.test.ts
+└── integration/
+    └── publish-workflow.test.ts
+```
+
+---
+
+## Example Integration Test
+
+```typescript
+describe('Publish Workflow', () => {
+  it('should publish memory to space with confirmation', async () => {
+    // 1. Create test memory
+    const memory = await createTestMemory(userId);
+    
+    // 2. Request publish
+    const publishResult = await handlePublish({
+      memory_id: memory.id,
+      target: 'the_void'
+    }, userId);
+    
+    const { token } = JSON.parse(publishResult);
+    expect(token).toBeDefined();
+    
+    // 3. Confirm publish
+    const confirmResult = await handleConfirm({ token }, userId);
+    const { space_memory_id } = JSON.parse(confirmResult).payload;
+    
+    // 4. Verify in space
+    const spaceMemory = await getSpaceMemory('the_void', space_memory_id);
+    expect(spaceMemory).toBeDefined();
+    expect(spaceMemory.author_id).toBe(userId);
+    
+    // 5. Verify original unchanged
+    const originalMemory = await getUserMemory(userId, memory.id);
+    expect(originalMemory).toBeDefined();
+  });
+});
+```
+
+---
+
+## Related Files
+
+- Design: [`agent/design/publish-tools-confirmation-flow.md`](../design/publish-tools-confirmation-flow.md)
+- Jest Config: [`jest.config.js`](../../jest.config.js)
+- E2E Config: [`jest.e2e.config.js`](../../jest.e2e.config.js)
+
+---
+
+**Next Task**: Task 43 - Update Documentation

package/agent/tasks/task-43-update-documentation.md

@@ -0,0 +1,255 @@
+# Task 43: Update Documentation
+
+**Milestone**: M10 - Shared Spaces & Confirmation Flow
+**Estimated Time**: 2 hours
+**Dependencies**: Tasks 34-42 (All implementation and testing)
+**Status**: Not Started
+
+---
+
+## Objective
+
+Update all project documentation to reflect the new shared spaces functionality, including README, CHANGELOG, and any relevant design documents.
+
+---
+
+## Steps
+
+### 1. Update README.md
+
+Add shared spaces section to README.
+
+**Actions**:
+- Add "Shared Spaces" section
+- Document 5 new tools (publish, confirm, deny, search_space, query_space)
+- Update tool count (17 total: 12 existing + 5 new)
+- Add usage examples for publish workflow
+- Document "The Void" space
+- Add configuration notes (Firestore TTL)
+
+**Expected Outcome**: README updated
+
+### 2. Update CHANGELOG.md
+
+Document new features in changelog.
+
+**Actions**:
+- Create new version entry (e.g., v2.3.0)
+- Add "Added" section with 5 new tools
+- Add "Added" section with token-based confirmation pattern
+- Add "Added" section with shared spaces support
+- Note breaking changes (if any)
+- Document Firestore TTL requirement
+
+**Expected Outcome**: CHANGELOG updated
+
+### 3. Update Tool Documentation
+
+Document each new tool.
+
+**Actions**:
+- Create or update tool reference documentation
+- Include tool schemas
+- Add usage examples
+- Document parameters and responses
+- Add error codes and messages
+
+**Expected Outcome**: Tool docs complete
+
+### 4. Update Architecture Documentation
+
+Document new architecture components.
+
+**Actions**:
+- Update architecture diagrams (if any)
+- Document token-based confirmation pattern
+- Document space collections
+- Document naming conventions (snake_case)
+- Add security considerations
+
+**Expected Outcome**: Architecture docs updated
+
+### 5. Create Migration Guide
+
+Help users adopt new features.
+
+**Actions**:
+- Document how to enable shared spaces
+- Explain Firestore TTL setup
+- Provide migration examples
+- Note any configuration changes
+- Add troubleshooting section
+
+**Expected Outcome**: Migration guide created
+
+### 6. Update API Reference
+
+Update API documentation.
+
+**Actions**:
+- Add new tools to API reference
+- Document request/response formats
+- Add code examples
+- Update tool count
+- Note version requirements
+
+**Expected Outcome**: API reference updated
+
+### 7. Update Design Documents
+
+Mark design as implemented.
+
+**Actions**:
+- Update [`agent/design/publish-tools-confirmation-flow.md`](../design/publish-tools-confirmation-flow.md)
+- Change status from "Design Specification" to "Implemented"
+- Add implementation notes
+- Link to relevant code files
+- Document any deviations from design
+
+**Expected Outcome**: Design docs updated
+
+### 8. Update Progress Tracking
+
+Update progress.yaml with M10 completion.
+
+**Actions**:
+- Mark M10 tasks as completed
+- Update milestone status
+- Add completion notes
+- Update overall progress percentage
+- Document next steps
+
+**Expected Outcome**: Progress tracking current
+
+### 9. Create Usage Examples
+
+Add practical examples.
+
+**Actions**:
+- Create example: Publishing a memory
+- Create example: Searching "The Void"
+- Create example: Querying shared spaces
+- Add to README or examples directory
+- Include error handling
+
+**Expected Outcome**: Examples available
+
+### 10. Review and Proofread
+
+Ensure documentation quality.
+
+**Actions**:
+- Review all updated documentation
+- Check for typos and errors
+- Verify links work
+- Ensure consistency
+- Get feedback if possible
+
+**Expected Outcome**: Documentation polished
+
+---
+
+## Verification
+
+- [ ] README.md updated with shared spaces section
+- [ ] CHANGELOG.md updated with new version
+- [ ] Tool documentation complete
+- [ ] Architecture documentation updated
+- [ ] Migration guide created
+- [ ] API reference updated
+- [ ] Design documents marked as implemented
+- [ ] Progress.yaml updated
+- [ ] Usage examples created
+- [ ] Documentation reviewed and proofread
+
+---
+
+## README.md Addition
+
+```markdown
+## Shared Spaces
+
+Publish memories to shared discovery spaces where other users can find them.
+
+### The Void
+
+"The Void" is a shared space for discovering thoughts and ideas from other users.
+
+### Publishing Workflow
+
+1. **Request Publication**: Generate confirmation token
+```bash
+remember_publish(memory_id="abc123", target="the_void")
+# Returns: { token: "xyz789", ... }
+```
+
+2. **User Confirms**: Execute the publication
+```bash
+remember_confirm(token="xyz789")
+# Memory now in The Void
+```
+
+3. **Discover**: Search shared spaces
+```bash
+remember_search_space(query="interesting ideas", space="the_void")
+```
+
+### Tools
+
+- `remember_publish` - Request to publish memory (generates token)
+- `remember_confirm` - Confirm any pending action
+- `remember_deny` - Cancel any pending action
+- `remember_search_space` - Search shared spaces
+- `remember_query_space` - Ask questions about shared memories
+
+### Configuration
+
+**Firestore TTL**: Configure automatic cleanup of expired tokens
+- Collection Group: `requests`
+- TTL Field: `expires_at`
+- See [Firestore TTL Guide](docs/firestore-ttl.md)
+```
+
+---
+
+## CHANGELOG.md Entry
+
+```markdown
+## [2.3.0] - 2026-02-16
+
+### Added
+- **Shared Spaces**: Publish memories to shared discovery spaces
+- **The Void**: First shared space for discovering thoughts and ideas
+- **Token-Based Confirmation**: Secure two-phase workflow for sensitive operations
+- **5 New Tools**:
+  - `remember_publish` - Request to publish memory to shared space
+  - `remember_confirm` - Confirm and execute pending actions
+  - `remember_deny` - Cancel pending actions
+  - `remember_search_space` - Search shared spaces
+  - `remember_query_space` - Query shared spaces with natural language
+- **Confirmation Token Service**: Manages one-time tokens with 5-minute expiry
+- **Space Collections**: `Memory_the_void` for shared memories
+- **Firestore TTL Support**: Automatic cleanup of expired tokens
+
+### Changed
+- Tool count increased from 12 to 17
+- Collection naming uses snake_case for spaces
+
+### Security
+- One-time use tokens prevent replay attacks
+- User ownership verification before publishing
+- Fresh data fetch during confirmation
+```
+
+---
+
+## Related Files
+
+- README: [`README.md`](../../README.md)
+- CHANGELOG: [`CHANGELOG.md`](../../CHANGELOG.md)
+- Design: [`agent/design/publish-tools-confirmation-flow.md`](../design/publish-tools-confirmation-flow.md)
+- Progress: [`agent/progress.yaml`](../progress.yaml)
+
+---
+
+**Next Task**: None - M10 Complete!

package/dist/llm/types.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=types.d.ts.map