chore: move completed tasks to completed/ directory

Mueve las tareas completadas (01-bot-tools, 02-bot-memory, 04-bot-avatar) al directorio .claude/tasks/completed/ para organización. Añade nueva tarea 06. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-06 09:06:25 +00:00
parent b86da0b805
commit 2f89943511
4 changed files with 317 additions and 0 deletions
@@ -0,0 +1,95 @@
+# Plan: Memoria para los bots
+
+## Objetivo
+Que cada bot recuerde conversaciones anteriores, hechos importantes sobre usuarios
+y contexto de salas. Memoria a corto plazo (ventana de conversación) y largo plazo
+(SQLite persistente).
+
+## Estado: completado ✓
+
+---
+
+## Tipos de memoria
+
+### 1. Memoria de conversación (corto plazo)
+- Ventana deslizante de `N` mensajes por room
+- Se pasa como historial al LLM en cada llamada
+- Vive en RAM; se pierde al reiniciar (aceptable)
+
+### 2. Memoria episódica (largo plazo)
+- Hechos extraídos de conversaciones: nombre del usuario, preferencias, eventos
+- Guardados en SQLite (`agents/<id>/data/memory.db`)
+- El LLM puede leer y escribir hechos mediante herramientas (`remember`, `recall`)
+
+---
+
+## Diseño capa pura (`pkg/memory/`)
+
+```go
+// Tipos puros — sin I/O
+type Message struct {
+    Role    string    // "user" | "assistant"
+    Content string
+    At      time.Time
+}
+
+type Fact struct {
+    Subject string
+    Key     string
+    Value   string
+    At      time.Time
+}
+
+// Ventana de conversación
+type Window struct {
+    RoomID   string
+    Messages []Message
+    MaxSize  int
+}
+
+func (w Window) Append(m Message) Window { ... }  // pura
+func (w Window) ToLLMMessages() []llm.Message { ... }  // pura
+```
+
+## Diseño capa shell (`shell/memory/`)
+
+```go
+// Acceso a SQLite — impuro
+type Store interface {
+    SaveFact(ctx, agentID, fact) error
+    GetFacts(ctx, agentID, subject) ([]Fact, error)
+    GetHistory(ctx, agentID, roomID, limit) ([]Message, error)
+    AppendMessage(ctx, agentID, roomID, msg) error
+}
+```
+
+---
+
+## Herramientas LLM para memoria
+- `remember(subject, key, value)` — guardar un hecho
+- `recall(subject, key)` — recuperar hechos sobre alguien/algo
+- `forget(subject, key)` — borrar un hecho
+
+---
+
+## Integración con el flujo actual
+1. `agents/runtime.go` mantiene un `map[roomID]memory.Window` en RAM
+2. Antes de llamar al LLM, inyectar historial de la ventana al request
+3. Después de la respuesta, hacer `Append` con el mensaje del bot
+4. Las herramientas `remember`/`recall` van al `Store` SQLite
+
+---
+
+## Archivos a crear/modificar
+- `pkg/memory/types.go` — Message, Fact, Window (puros)
+- `pkg/memory/window.go` — operaciones sobre Window (puras)
+- `shell/memory/sqlite_store.go` — Store SQLite
+- `shell/memory/migrations/001_init.sql` — schema
+- `agents/runtime.go` — inyectar historial antes del LLM call
+- `agents/<id>/agent.go` — registrar herramientas remember/recall
+
+## Notas
+- Schema SQLite: tabla `facts(agent_id, subject, key, value, updated_at)`,
+  tabla `messages(agent_id, room_id, role, content, created_at)`
+- El tamaño de la ventana se configura en `storage.max_context_messages`
+  (añadir al schema de config)