```

feat(memory): consolidate memory management by removing separate dream directory

BREAKING CHANGE: Remove the separate dream memory system and consolidate
all memory operations directly into MEMORY.md file.

- Replace dream/ directory with backup/ directory for storing memory backups
- Modify memory optimization process to directly update MEMORY.md instead
  of maintaining separate DREAM.md
- Update documentation to reflect single memory file approach
- Adjust cron manager to execute dream tasks synchronously instead of
  adding to background queue
- Remove references to DREAM.md from Chinese and English documentation
- Update memory workflow diagrams to remove dream-related components
```

Author: ployts

src/qwenpaw/agents/memory/reme_light_memory_manager.py

@@ -450,8 +450,9 @@ async def dream_memory(self, **kwargs) -> None:
         """
         logger.info("running dream-based memory optimization")
 
-        self.dream_path = Path(self.working_dir).absolute() / "dream"
-        self.dream_path.mkdir(parents=True, exist_ok=True)
+        # Create backup directory to store backup files
+        self.backup_path = Path(self.working_dir).absolute() / "backup"
+        self.backup_path.mkdir(parents=True, exist_ok=True)
 
         self._prepare_model_formatter()
 
@@ -535,9 +536,8 @@ def _get_dream_prompt(
             "zh": (
                 "现在进入梦境状态，对长期记忆进行安全优化整理。请严格按照以下步骤操作，"
                 "确保所有变更都有备份且可回滚。\n\n【核心概念】\n"
-                "- DREAM.md：这是你自主管理的长期记忆沉淀文件，包含经过提炼的核心业务决策、用户偏好和高价值经验\n"
-                "- MEMORY.md：这是用户可直接编辑的参考文件，包含初始配置和用户手动添加的记忆\n"
-                "- 你的任务是维护和优化 DREAM.md，而不是直接修改 MEMORY.md\n\n"
+                "- MEMORY.md：这是你的长期记忆文件，包含经过提炼的核心业务决策、用户偏好和高价值经验\n"
+                "- 你的任务是直接维护和优化 MEMORY.md\n\n"
                 "【梦境优化原则】\n"
                 "1. 极简去冗：严禁记录流水账、Bug修复细节或单次任务。"
                 "仅保留“核心业务决策”、“确认的用户偏好”与“高价值可复用经验”。\n"
@@ -546,44 +546,38 @@ def _get_dream_prompt(
                 "3. 归纳整合：主动将零碎的相似规则提炼、合并为通用性强的独立条目。"
                 "\n4. 废弃剔除：主动删除已被证伪的假设或不再适用的陈旧条目。\n\n"
                 "【安全操作流程】\n"
-                "⚠️ 重要：所有操作必须在 `dream/` 目录下进行，严禁直接修改根目录文件！\n\n"
+                "⚠️ 重要：在修改 MEMORY.md 之前必须先创建备份！\n\n"
                 f"当前日期: {current_date}\n\n"
                 "步骤 1 [环境准备]：\n"
-                "- 检查是否存在 `dream/` 目录，如果不存在则创建\n"
-                "- 读取现有的 `dream/DREAM.md` 文件作为当前记忆基准（如果不存在则从模板创建）\n"
-                "- 读取当天的日志文件 `memory/YYYY-MM-DD.md`\n"
-                "- 可选：读取根目录的 `MEMORY.md` 作为用户参考信息\n\n"
+                "- 读取现有的 MEMORY.md 文件作为当前记忆基准（如果不存在则从模板创建）\n"
+                "- 读取当天的日志文件 `memory/YYYY-MM-DD.md`\n\n"
                 "步骤 2 [备份创建]：\n"
-                "- 将当前 `dream/DREAM.md` 的内容备份到 "
-                "`dream/DREAM_backup_YYYYMMDD_HHMMSS.md`\n\n"
+                "- 将当前 MEMORY.md 的内容备份到 "
+                "`backup/memory_backup_YYYYMMDD_HHMMSS.md`\n\n"
                 "步骤 3 [梦境提纯]：\n"
                 "- 在梦境中对比新旧内容，严格按照【梦境优化原则】进行去重、替换、剔除和合并\n"
-                "- 生成一份全新的记忆内容，并保存到 `dream/DREAM_new.md`\n\n"
+                "- 生成一份全新的记忆内容，并保存到 `MEMORY_new.md`\n\n"
                 "步骤 4 [验证与提交]：\n"
-                "- 仔细检查 `dream/DREAM_new.md` 的内容是否符合优化原则\n"
-                "- 确认无误后，将 `dream/DREAM_new.md` 重命名为 `dream/DREAM.md`\n"
-                "- 记录操作日志到 `dream/dream_log_YYYYMMDD_HHMMSS.md`\n\n"
+                "- 仔细检查 `MEMORY_new.md` 的内容是否符合优化原则\n"
+                "- 确认无误后，将 `MEMORY_new.md` 重命名为 `MEMORY.md`\n"
+                "- 记录操作日志到 `backup/memory_log_YYYYMMDD_HHMMSS.md`\n\n"
                 "步骤 5 [苏醒汇报]：\n"
                 "从梦境中苏醒后，在对话中向我简短汇报：\n"
                 "1) 新增/沉淀了哪些核心记忆\n"
                 "2) 修正/删除了哪些过期内容\n"
                 "3) 备份文件的位置和名称\n"
-                "4) 最终的 DREAM.md 是否成功更新"
+                "4) 最终的 MEMORY.md 是否成功更新"
             ),
             "en": (
                 "Enter dream state for safe memory optimization. Please "
                 "strictly follow the steps below to ensure all changes are "
                 "backed up and can be rolled back.\n\n"
                 "[Core Concepts]\n"
-                "- DREAM.md: This is your autonomously managed long-term "
-                "memory consolidation file, containing distilled core "
-                "business decisions, user preferences, and "
+                "- MEMORY.md: This is your long-term memory file, containing "
+                "distilled core business decisions, user preferences, and "
                 "high-value experiences\n"
-                "- MEMORY.md: This is a user-editable reference file "
-                "containing initial configuration and manually added "
-                "memories\n"
-                "- Your task is to maintain and optimize DREAM.md, NOT "
-                "to directly modify MEMORY.md\n\n"
+                "- Your task is to directly maintain and optimize "
+                "MEMORY.md\n\n"
                 "[Dream Optimization Principles]\n"
                 "1. Extreme Minimalism: Strictly forbid recording daily "
                 "routines, specific bug-fix details, or one-off tasks. "
@@ -599,40 +593,36 @@ def _get_dream_prompt(
                 "4. Deprecation: Proactively delete hypotheses that have been "
                 "proven false or outdated entries that no longer apply.\n\n"
                 "[Safe Operation Procedure]\n"
-                "⚠️ Important: All operations MUST be performed in the "
-                "`dream/` directory! Never modify root directory files "
-                "directly!\n\n"
+                "⚠️ Important: You MUST create a backup before modifying "
+                "MEMORY.md!\n\n"
                 f"Current date: {current_date}\n\n"
                 "Step 1 [Environment Setup]:\n"
-                "- Check if `dream/` directory exists, create it if not\n"
-                "- Read existing `dream/DREAM.md` file as current memory"
-                " baseline (create from template if it doesn't exist)\n"
-                "- Read today's log file `memory/YYYY-MM-DD.md`\n"
-                "- Optional: Read root directory `MEMORY.md` as user "
-                "reference information\n\n"
+                "- Read existing MEMORY.md file as current memory baseline "
+                "(create from template if it doesn't exist)\n"
+                "- Read today's log file `memory/YYYY-MM-DD.md`\n\n"
                 "Step 2 [Backup Creation]:\n"
-                "- Backup current `dream/DREAM.md` content to "
-                "`dream/DREAM_backup_YYYYMMDD_HHMMSS.md`\n\n"
+                "- Backup current MEMORY.md content to "
+                "`backup/memory_backup_YYYYMMDD_HHMMSS.md`\n\n"
                 "Step 3 [Dream Purification]:\n"
                 "- Compare old and new content in your dream state, strictly "
                 "following [Dream Optimization Principles] to deduplicate, "
                 "replace, remove, and merge\n"
                 "- Generate entirely new memory content and save it to "
-                "`dream/DREAM_new.md`\n\n"
+                "`MEMORY_new.md`\n\n"
                 "Step 4 [Validation and Commit]:\n"
-                "- Carefully review `dream/DREAM_new.md` content for "
-                "compliance with principles\n"
-                "- If confirmed correct, rename `dream/DREAM_new.md` to "
-                "`dream/DREAM.md`\n"
+                "- Carefully review `MEMORY_new.md` content for compliance "
+                "with principles\n"
+                "- If confirmed correct, rename `MEMORY_new.md` to "
+                "`MEMORY.md`\n"
                 "- Record operation log to "
-                "`dream/dream_log_YYYYMMDD_HHMMSS.md`\n\n"
+                "`backup/memory_log_YYYYMMDD_HHMMSS.md`\n\n"
                 "Step 5 [Awake Report]:\n"
                 "After waking from your dream, briefly report to me in the "
                 "chat:\n"
                 "1) What core memories were newly added/consolidated\n"
                 "2) What outdated content was corrected/deleted\n"
                 "3) Backup file locations and names\n"
-                "4) Whether the final DREAM.md was successfully updated"
+                "4) Whether the final MEMORY.md was successfully updated"
             ),
         }
         return prompts.get(language, prompts["en"])

src/qwenpaw/app/crons/manager.py

@@ -429,11 +429,14 @@ async def _heartbeat_callback(self) -> None:
     async def _dream_callback(self) -> None:
         """Run one dream-based memory optimization task."""
         try:
-            # Add dream task as background async task, similar to summary tasks
-            self._runner.memory_manager.add_async_dream_task()
-            logger.debug("Dream task added to background queue successfully")
+            # Run dream task
+            await self._runner.memory_manager.dream_memory()
+            logger.debug("Dream task executed successfully")
+        except asyncio.CancelledError:
+            logger.info("Dream task was cancelled")
+            raise
         except Exception as e:  # pylint: disable=broad-except
-            logger.error(f"Failed to schedule dream task: {e}", exc_info=True)
+            logger.error(f"Failed to execute dream task: {e}", exc_info=True)
 
     async def _execute_once(self, job: CronJobSpec) -> None:
         rt = self._rt.get(job.id)

website/public/docs/memory.en.md

@@ -18,7 +18,6 @@ graph TB
     MemoryMgmt --> SearchLayer[Hybrid Memory Search]
     FileTools --> LTM[MEMORY.md]
     FileTools --> DailyLog[memory/YYYY-MM-DD.md]
-    FileTools --> Dream[DREAM.md]
     Watcher --> Index[Async DB Update]
     SearchLayer --> VectorSearch[Vector Semantic Search]
     SearchLayer --> BM25[BM25 Full-text Search]
@@ -44,11 +43,9 @@ three-level structure:
 graph LR
     Workspace[Workspace working_dir] --> MEMORY[MEMORY.md Long-term Memory]
     Workspace --> MemDir[memory/*]
-    Workspace --> DreamDir[dream/*]
     MemDir --> Day1[2025-02-12.md]
     MemDir --> Day2[2025-02-13.md]
     MemDir --> DayN[...]
-    DreamDir --> DREAM[DREAM.md Dream Memory]
 ```
 
 ### MEMORY.md (Long-term Memory, Optional)
@@ -68,22 +65,13 @@ One page per day, appended with the day's work and interactions.
 - **Updates**: Appended by the Agent via `write` / `edit` file tools; automatically triggered when conversations become
   too long and need summarization
 
-### DREAM.md (Dream Memory, Auto-managed)
-
-Stores core long-term memories after dream-based consolidation, automatically maintained and optimized by the Agent.
-
-- **Location**: `{working_dir}/dream/DREAM.md`
-- **Purpose**: Stores high-value core memories after automatic consolidation, deduplication, and summarization
-- **Updates**: Updated only automatically by the dream functionality; users should not modify directly
-
 ### When to Write Memory?
 
-| Information Type                         | Write Target              | Method                       | Example                                                |
-| ---------------------------------------- | ------------------------- | ---------------------------- | ------------------------------------------------------ |
-| Decisions, preferences, persistent facts | `MEMORY.md`               | `write` / `edit` tools       | "Project uses Python 3.12", "Prefers pytest framework" |
-| Daily notes, runtime context             | `memory/YYYY-MM-DD.md`    | `write` / `edit` tools       | "Fixed login bug today", "Deployed v2.1"               |
-| User says "remember this"                | Write to file immediately | `write` tool                 | Do not only save in memory!                            |
-| **High-value core memories**             | **`dream/DREAM.md`**      | **Dream auto-consolidation** | **Consolidated core business rules**                   |
+| Information Type                         | Write Target              | Method                 | Example                                                |
+| ---------------------------------------- | ------------------------- | ---------------------- | ------------------------------------------------------ |
+| Decisions, preferences, persistent facts | `MEMORY.md`               | `write` / `edit` tools | "Project uses Python 3.12", "Prefers pytest framework" |
+| Daily notes, runtime context             | `memory/YYYY-MM-DD.md`    | `write` / `edit` tools | "Fixed login bug today", "Deployed v2.1"               |
+| User says "remember this"                | Write to file immediately | `write` tool           | Do not only save in memory!                            |
 
 ---
 

website/public/docs/memory.zh.md

@@ -17,7 +17,6 @@ graph TB
     MemoryMgmt --> SearchLayer[记忆混合检索]
     FileTools --> LTM[MEMORY.md]
     FileTools --> DailyLog[memory/YYYY-MM-DD.md]
-    FileTools --> Dream[DREAM.md]
     Watcher --> Index[异步更新数据库]
     SearchLayer --> VectorSearch[向量语义搜索]
     SearchLayer --> BM25[BM25 全文检索]
@@ -42,11 +41,9 @@ graph TB
 graph LR
     Workspace[工作空间 working_dir] --> MEMORY[MEMORY.md 长期记忆]
     Workspace --> MemDir[memory/*]
-    Workspace --> DreamDir[dream/*]
     MemDir --> Day1[2025-02-12.md]
     MemDir --> Day2[2025-02-13.md]
     MemDir --> DayN[...]
-    DreamDir --> DREAM[DREAM.md 梦境记忆]
 ```
 
 ### MEMORY.md（长期记忆，可选）
@@ -65,22 +62,13 @@ graph LR
 - **用途**：记录日常笔记和运行上下文
 - **更新**：Agent 通过 `write` / `edit` 文件工具追加写入，对话过长需要进行总结时自动触发
 
-### DREAM.md（梦境记忆，自动管理）
-
-存放经过梦境整理后的核心长期记忆，由 Agent 自动维护和优化。
-
-- **位置**：`{working_dir}/dream/DREAM.md`
-- **用途**：存储经过自动整理、去重、归纳后的高价值核心记忆
-- **更新**：仅由梦境功能自动更新，用户不应直接修改
-
 ### 何时写入记忆？
 
 | 信息类型             | 写入目标               | 操作方式              | 示例                                       |
 | -------------------- | ---------------------- | --------------------- | ------------------------------------------ |
 | 决策、偏好、持久事实 | `MEMORY.md`            | `write` / `edit` 工具 | "项目使用 Python 3.12"、"偏好 pytest 框架" |
 | 日常笔记、运行上下文 | `memory/YYYY-MM-DD.md` | `write` / `edit` 工具 | "今天修复了登录 Bug"、"部署了 v2.1"        |
 | 用户说"记住这个"     | 立即写入文件           | `write` 工具          | 不要仅保存在内存中！                       |
-| **高价值核心记忆**   | **`dream/DREAM.md`**   | **梦境功能自动整理**  | **经过归纳整合的核心业务规则**             |
 
 ---