feat(memory): #62-1 Project Setup & Core Architecture

cardosofelipe commented

2026-01-05 00:13:55 +00:00

Owner

Parent Issue

#62 Agent Memory System

Overview

Set up the foundational architecture for the Agent Memory System, including directory structure, base interfaces, configuration, and dependency injection.

Tasks

Create backend/app/services/memory/ directory structure
Create __init__.py with public API exports
Create config.py with MemorySettings (Pydantic, MEM_ prefix)
Define base types in types.py:
- MemoryItem - Base class for all memory items
- MemoryScope - Enum for scoping levels
- MemoryType - Enum for memory types
Create manager.py with MemoryManager class (facade pattern)
Create exceptions.py with memory-specific errors
Write ADR-010 documenting memory architecture decisions
Create dependency injection setup
Unit tests for configuration and types (>90% coverage)

Acceptance Criteria

Directory structure matches existing patterns (like context/, safety/)
Configuration validates correctly with Pydantic
All public interfaces are well-documented
Unit tests pass with >90% coverage
make validate-all passes

Priority

P0 - Must complete first (blocks all other sub-issues)

Labels

phase-2, mcp, backend, agents

## Parent Issue - #62 Agent Memory System ## Overview Set up the foundational architecture for the Agent Memory System, including directory structure, base interfaces, configuration, and dependency injection. ## Tasks - [ ] Create `backend/app/services/memory/` directory structure - [ ] Create `__init__.py` with public API exports - [ ] Create `config.py` with `MemorySettings` (Pydantic, MEM_ prefix) - [ ] Define base types in `types.py`: - `MemoryItem` - Base class for all memory items - `MemoryScope` - Enum for scoping levels - `MemoryType` - Enum for memory types - [ ] Create `manager.py` with `MemoryManager` class (facade pattern) - [ ] Create `exceptions.py` with memory-specific errors - [ ] Write ADR-010 documenting memory architecture decisions - [ ] Create dependency injection setup - [ ] Unit tests for configuration and types (>90% coverage) ## Acceptance Criteria - [ ] Directory structure matches existing patterns (like `context/`, `safety/`) - [ ] Configuration validates correctly with Pydantic - [ ] All public interfaces are well-documented - [ ] Unit tests pass with >90% coverage - [ ] `make validate-all` passes ## Priority P0 - Must complete first (blocks all other sub-issues) ## Labels `phase-2`, `mcp`, `backend`, `agents`