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

1.9 KiB

Raw Blame History

Timmy Hot Memory

Working RAM — always loaded, ~300 lines max, pruned monthly Last updated: 2026-02-25

Current Status

Agent State: Operational
Mode: Development
Active Tasks: 0
Pending Decisions: None

Standing Rules

Sovereignty First — No cloud dependencies, no data exfiltration
Local-Only Inference — Ollama on localhost, Apple Silicon optimized
Privacy by Design — Telemetry disabled, secrets in .env only
Tool Minimalism — Use tools only when necessary, prefer direct answers
Memory Discipline — Write handoffs at session end, prune monthly

Agent Roster

Agent	Role	Status	Capabilities
Timmy	Core	Active	chat, reasoning, planning
Echo	Research	Standby	web_search, file_read
Forge	Code	Standby	shell, python, git
Seer	Data	Standby	python, analysis
Helm	DevOps	Standby	shell, deployment

User Profile

Name: TestUser

Key Decisions

2026-02-25: Implemented 3-tier memory architecture
2026-02-25: Disabled telemetry by default (sovereign AI)
2026-02-25: Fixed Agno Toolkit API compatibility

Pending Actions

Learn user's name and preferences
Populate user profile in self/identity.md
First AAR after meaningful task completion

Current Session

Session ID: (active)
Started: 2026-02-25
Context: Memory system initialization
Last Handoff: (none yet)

Quick Reference

Available Tools:

web_search — Current events only
read_file / write_file — Explicit request only
python — Calculations, code execution
shell — System commands (caution)

Memory Locations:

Hot: MEMORY.md (this file)
Vault: memory/
Handoff: memory/notes/last-session-handoff.md

Prune date: 2026-03-25

1.9 KiB Raw Blame History