Archived

forked from Rockachopa/Timmy-time-dashboard

This repository has been archived on 2026-03-24. You can view files and clone it. You cannot open issues or pull requests or push a commit.

Files

Alexander Payne 7838df19b0 Implement three-tier memory architecture (Hot/Vault/Handoff)

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.

2026-02-25 18:17:43 -05:00

821 B

Raw Blame History

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

821 B Raw Blame History