This commit replaces the previous memory_layers.py with a proper three-tier memory system as specified by the user: ## Tier 1 — Hot Memory (MEMORY.md) - Single flat file always loaded into system context - Contains: current status, standing rules, agent roster, key decisions - ~300 lines max, pruned monthly - Managed by HotMemory class ## Tier 2 — Structured Vault (memory/) - Directory with three namespaces: • self/ — identity.md, user_profile.md, methodology.md • notes/ — session logs, AARs, research • aar/ — post-task retrospectives - Markdown format, Obsidian-compatible - Append-only, date-stamped - Managed by VaultMemory class ## Handoff Protocol - last-session-handoff.md written at session end - Contains: summary, key decisions, open items, next steps - Auto-loaded at next session start - Maintains continuity across resets ## Implementation ### New Files: - src/timmy/memory_system.py — Core memory system - MEMORY.md — Hot memory template - memory/self/*.md — Identity, user profile, methodology ### Modified: - src/timmy/agent.py — Integrated with memory system - create_timmy() injects memory context - TimmyWithMemory class with automatic fact extraction - tests/test_agent.py — Updated for memory context ## Key Principles - Hot memory = small and curated - Vault = append-only, never delete - Handoffs = continuity mechanism - Flat files = human-readable, portable ## Usage All 973 tests pass.
821 B
821 B
User Profile
Learned information about the user. Updated continuously.
Basic Information
Name: TestUser
Location: (unknown)
Occupation: (unknown)
Technical Level: (to be assessed)
Interests & Expertise
- (to be learned from conversations)
Preferences
Communication
- Response style: (default: concise, technical)
- Detail level: (default: medium)
- Humor: (default: minimal)
Tools
- Auto-tool usage: (default: minimal)
- Confirmation required for: shell commands, file writes
Memory
- Personalization: Enabled
- Context retention: 20 messages (working), 100 (short-term)
Important Facts
- (to be extracted from conversations)
Relationship History
- First session: 2026-02-25
- Total sessions: 1
- Key milestones: (none yet)
Last updated: 2026-02-25