everclaw 0.3.15 → 0.3.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "everclaw",
-  "version": "0.3.15",
+  "version": "0.3.17",
   "description": "Enterprise-level Agent Cli for digital productivity and privacy security.",
   "keywords": [
     "coding-agent",

package/skills/memory/SKILL.md

@@ -9,7 +9,7 @@ always: true
 ## Structure
 
 - `memory/MEMORY.md` — Long-term facts (preferences, project context, relationships). Always loaded into your context.
-- `memory/HISTORY.md` — Append-only event log. NOT loaded into context. Search it with grep. Each entry starts with [YYYY-MM-DD HH:MM].
+- `memory/HISTORY.md` — Append-only event log. NOT loaded into context. Search it with grep. Entries use ISO-prefix timestamps like `[2024-01-15T10:30]`.
 
 ## Search Past Events
 
@@ -19,13 +19,19 @@ grep -i "keyword" memory/HISTORY.md
 
 Use the `exec` tool to run grep. Combine patterns: `grep -iE "meeting|deadline" memory/HISTORY.md`
 
+## Auto-consolidation
+
+Old conversations are automatically summarized when the session grows beyond the `memoryWindow` threshold. The consolidation LLM:
+1. Appends a summary to `HISTORY.md`
+2. **Overwrites** `MEMORY.md` with an updated long-term memory snapshot
+
+Because consolidation overwrites MEMORY.md entirely, do **not** manually edit it for transient notes. The consolidation prompt includes the current MEMORY.md contents, so existing facts are generally preserved and refined automatically.
+
 ## When to Update MEMORY.md
 
-Write important facts immediately using `edit_file` or `write_file`:
+Only write to MEMORY.md for **critical persistent facts** that must survive before the next consolidation:
 - User preferences ("I prefer dark mode")
 - Project context ("The API uses OAuth2")
 - Relationships ("Alice is the project lead")
 
-## Auto-consolidation
-
-Old conversations are automatically summarized and appended to HISTORY.md when the session grows large. Long-term facts are extracted to MEMORY.md. You don't need to manage this.
+Use `edit_file` to update specific sections rather than `write_file` to avoid clobbering existing content.