@symerian/symi 2.0.5 → 2.0.6

package/docs/reference/templates/SYMIPULSE.md

@@ -7,57 +7,75 @@ read_when:
 
 # SYMIPULSE.md - Periodic Tasks
 
-## Memory Consolidation (Every 3 Days)
+## Memory Consolidation (Priority Task)
 
-Rotate through these checks (one per heartbeat):
+Every heartbeat, check if consolidation is needed. Run consolidation when:
 
-### Task 1: Review Recent Daily Logs
+- It's been more than 24 hours since the last consolidation (check `memory/heartbeat-state.json` → `lastChecks.memoryConsolidation`)
+- There are 3+ daily log files that haven't been distilled into MEMORY.md
 
-- Read memory files from last 7 days (memory/YYYY-MM-DD.md)
-- Extract: decisions made, preferences expressed, patterns observed, lessons learned
-- Update MEMORY.md sections:
-  - "Preferences" (add new discoveries)
-  - "Lessons Learned" (add corrections or mistakes)
-  - "Open Items" (update progress)
-- Don't duplicate what's already there, only add new insights
+### Consolidation Steps
 
-### Task 2: Archive Old Logs
+1. **Read all recent daily logs** (`memory/YYYY-MM-DD*.md` from last 7 days)
+2. **Distill into structured MEMORY.md sections:**
+   - `## User` — name, timezone, preferences, working style, communication patterns
+   - `## Projects` — active projects, status, key decisions, blockers
+   - `## Preferences` — technical choices, tool preferences, response style
+   - `## Lessons Learned` — what worked, what didn't, mistakes to avoid
+   - `## People & Contacts` — names, roles, relationships mentioned
+   - `## Open Items` — pending tasks, follow-ups, things to remember
+3. **Keep MEMORY.md under 2000 tokens** — be ruthlessly concise. Use bullet points, not prose. Every line should be a retrievable fact.
+4. **Remove stale entries** — delete items from MEMORY.md that are resolved, outdated, or superseded
+5. **Archive old daily logs** — files older than 14 days: extract any unrecorded insights, then move to `memory/archive/` (create if needed)
+6. **Update heartbeat state** — set `lastChecks.memoryConsolidation` to current timestamp
 
-- Check memory/\*.md files older than 30 days
-- Move significant content to MEMORY.md if not already captured
-- Archive or compress old daily logs (optional: create memory/archive/ dir)
-- Keep MEMORY.md as canonical source, daily logs as raw capture
+### MEMORY.md Format (Target)
 
-### Task 3: Pattern Analysis
+```markdown
+## User
 
-- Search memory files for repeated phrases: "always", "never", "prefer", "don't"
-- Identify new communication patterns or technical preferences
-- Update MEMORY.md "Preferences" section with discoveries
-- Look for: time patterns, common tasks, recurring issues
+- Name: [name], TZ: [timezone]
+- Prefers: [concise/detailed], [practical/theoretical]
+- Working on: [current focus]
 
-### Task 4: Self-Assessment
+## Projects
 
-- Review "Lessons Learned" section
-- Check if past mistakes are being avoided
-- Verify preferences are being followed in recent interactions
-- Update approach if patterns show gaps
+- [project]: [status] — [key decision or note]
 
-## Execution Schedule
+## Preferences
 
-Heartbeat runs every 30 minutes. Rotate through tasks:
+- [preference]: [detail]
 
-- Heartbeat 1: Task 1 (review recent logs)
-- Heartbeat 2: Skip (SYMIPULSE_OK)
-- Heartbeat 3: Skip (SYMIPULSE_OK)
-- Heartbeat 4: Task 3 (pattern analysis)
-- Heartbeat 5-9: Skip (SYMIPULSE_OK)
-- Heartbeat 10: Task 2 (archive old logs)
+## Lessons Learned
 
-This gives ~3-day cycles for full memory consolidation.
+- [lesson]: [context]
 
-## Notes
+## Open Items
 
-- Only run memory tasks during main session (not in group chats)
-- Keep updates concise - MEMORY.md should stay readable
-- Focus on actionable insights, not raw history
-- Archive, don't delete - history might be useful later
+- [ ] [task or follow-up]
+```
+
+### Why This Matters
+
+MEMORY.md is injected into every system prompt. A bloated or disorganized MEMORY.md wastes tokens and degrades recall quality. A tight, structured one makes the model contextually aware on every turn.
+
+## Pattern Detection (Every 5th Heartbeat)
+
+- Search recent conversations for repeated themes: "always", "never", "prefer", "don't like"
+- Identify new communication or technical preferences
+- Update MEMORY.md Preferences section
+- Look for: time patterns, recurring tasks, common frustrations
+
+## Self-Assessment (Every 10th Heartbeat)
+
+- Verify MEMORY.md preferences are being followed in recent interactions
+- Check if past mistakes are being repeated
+- Remove any MEMORY.md entries that are no longer accurate
+
+## Execution Rules
+
+- Only run consolidation in main session (not group chats)
+- If nothing needs consolidation, reply SYMIPULSE_OK
+- Keep all updates concise — quality over quantity
+- Archive, don't delete — raw logs may be useful later
+- After consolidation, briefly note what was updated in the daily log

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symerian/symi",
-  "version": "2.0.5",
+  "version": "2.0.6",
   "description": "Multi-channel AI gateway with extensible messaging integrations",
   "keywords": [],
   "homepage": "https://github.com/jaysteelmind/symi#readme",