dsh-mnemon 0.1.5 → 0.2.0

package/docs/zh-CN/storage-model.md

@@ -1,185 +0,0 @@
-# 存储与三层记忆模型
-
-**简体中文** | [English](../en/storage-model.md) | [文档中心](./README.md)
-
-## 为什么是三层
-
-一种存储形态无法同时满足“每轮都可见”“保留完整叙事”和“长期图增强召回”：
-
-| 问题 | 对应层 | 原因 |
-|---|---|---|
-| 下一轮必须直接知道什么？ | Runtime Memory | 极小、直接进入 prompt |
-| 哪份设计或流程需要快速完整阅读？ | active Documents | 保留 Markdown 结构，不必做深召回 |
-| 哪些历史事实和关系应跨会话存在？ | Memory Spaces | 独立数据库、图关系、按需召回 |
-| 长文已不常用但仍需追溯怎么办？ | archived Documents | Mnemon 留索引，冷层保留原文 |
-
-推荐查询梯度：
-
-```text
-current request and repository facts
-             |
-             v
-Runtime Memory already in prompt
-             |
-             v
-search active Documents
-             |
-             v
-recall active Memory Spaces
-             |
-             v
-follow an exact cold reference when full text is required
-```
-
-## 统一根目录
-
-```text
-<storageRoot>/
-+-- runtime/
-|   +-- memories.json
-|   +-- USER.md
-|   +-- MEMORY.md
-+-- documents/
-|   +-- index.json
-|   +-- active/
-|   +-- archived/
-+-- data/
-|   +-- .dsh-memory-bodies.json
-|   +-- <memory-space-id>/
-|       +-- mnemon.db
-+-- state/                         # reserved; no persistent reviewer yet
-```
-
-`storageScope` 决定整个根，而不只是 Mnemon 数据库。`workspace` 范围会为每个已登记 DSH 工作区解析独立的 `<workspace>/.mnemon`；Web 查看目标与当前会话执行目标彼此独立，只有后者会驱动 Agent、工具和生命周期。`state/` 当前只会被状态盘点器识别；评分水位仍保存在运行中 Host 的内存中。
-
-## Runtime Memory
-
-### 语义
-
-- `target=user`：身份、角色、长期偏好、习惯、沟通风格和明确协作要求。
-- `target=memory`：项目、环境、决策、约定、工具特性和可复用经验。
-- `importance=critical|normal|low`：用于整理时的保留优先级。
-
-当前不实现 `daily` target。
-
-### 事实源和投影
-
-`runtime/memories.json` 是唯一事实源。每条记录包含：
-
-```text
-content
-created_at
-updated_at
-target
-importance
-```
-
-`USER.md` 和 `MEMORY.md` 是确定性派生文件。每个条目被归一成单行，条目之间使用单独一行的 `§` 分隔；`§` 是保留字符。启动和 prompt 组装时，控制层会从 JSON 修复缺失或被手工修改的投影。
-
-### 操作
-
-- `add` 写入独立新事实，完全相同的内容不会重复添加。
-- `replace` 用 `old_text` 的唯一子串定位并替换整个条目。
-- `remove` 用唯一子串移除整个条目。
-- 零命中或多命中都拒绝，不执行模糊修改。
-
-### 容量
-
-| 目标 | 上限 | 维护方式 |
-|---|---:|---|
-| `USER.md` | 4 KiB | 本地、无工具 worker 保守合并，不进入 Memory Space |
-| `MEMORY.md` | 10 KiB | worker 先归档已提交内容，再返回压缩候选 |
-
-容量按投影正文的实际 UTF-8 字节计算。单条内容最大 8 KiB。自动容量维护只由溢出的 `add` 触发；导致溢出的 `replace` 会直接报错，调用方应先显式整理。
-
-## Project Documents
-
-### 用途
-
-Documents 保存比单条记忆更完整、又希望快速阅读的项目知识，例如：
-
-- 架构设计和理由；
-- 有证据的调查结论；
-- 操作流程、发布清单和故障复盘；
-- 实现交接与长期维护说明。
-
-用户画像、普通聊天、临时进度、原始大日志和秘密不应进入 Documents。
-
-### 控制面
-
-`documents/index.json` 是元数据事实源，管理 ID、标题、description、状态、文件名、来源路径、session、时间、revision、SHA-256、大小和 Memory Space 引用。Markdown 托管副本带有生成的 frontmatter。
-
-`sourcePaths`：
-
-- 只能指向当前会话工作区内部；
-- 只作为来源引用，不会被插件修改；
-- 当前实现不要求路径实际存在；
-- 不允许指向受管 `documents/` 目录自身。
-
-### 范围
-
-Documents 的物理共享范围由 `storageScope` 决定：
-
-- `workspace`：通常随项目隔离；
-- `global` / `custom`：多个工作区可能共享同一个 `documents/index.json`。
-
-因此“项目档案”表示内容类型，不保证天然按工作区物理隔离。当前会话工作区只约束新写入的 `sourcePaths`。
-
-### 容量与冷热分层
-
-| 项目 | 限制 |
-|---|---:|
-| 单份正文 | 最大 2 MiB |
-| active 总量 | 最大 10 MiB，包含生成后的 frontmatter |
-| archived 总量 | 不计 active 上限 |
-
-创建或更新前会计算真实投影大小。空间不足时按 `lastAccessedAt`、再按 `updatedAt` 选择最久未访问的 active 文档；先写入/验证 Mnemon 冷引用，再在 revision 未变化时迁移原文。
-
-默认搜索只覆盖 active。搜索会更新命中文档的 `lastAccessedAt`，因此它对正文只读，但会写索引元数据。
-
-## Memory Spaces
-
-每个记忆体是一个 Mnemon 原生命名 Store，并在 `.dsh-memory-bodies.json` 中增加可维护元数据：
-
-```text
-id            Host 生成的稳定 UUID 或已发现的兼容 Store 名
-name          人类可读名称
-description   路由边界：什么属于这里、何时召回
-active        是否参与读取
-mnemon.db     独立数据面
-```
-
-### 读写边界
-
-- 召回、图谱、内容和实体读取只使用已激活记忆体。
-- 指定未激活记忆体进行读取会被拒绝。
-- 写入可以选择已登记的任意记忆体。
-- 对未激活目标写入成功后，插件自动激活它。
-- 没有显式目标且激活数量不是 1 时，确定性服务要求调用方先选择目标。
-
-### 创建、发现和合并
-
-- 创建时模型提供 name 和 description，Host 生成 ID。
-- 既有 `<storageRoot>/data/<store>/mnemon.db` 会被发现并登记，不移动数据库。
-- 合并通过 Mnemon import 把来源内容导入目标；来源数据库保留，默认只将来源设为未激活。
-- `forget` 是按精确 ID 的软删除，不等于删除数据库文件。
-
-### 跨 Agent 可见性
-
-`mnemon.db` 是 Mnemon 原生数据面，不是 dsh-mnemon 私有格式。其他 Mnemon-enabled Agent 在使用同一个 `storageRoot` 和 Store 时，可以访问同一份长期记忆。dsh-mnemon 也会发现磁盘上兼容的 Store；其 DSH 专有名称、说明和激活状态仍由 `.dsh-memory-bodies.json` 管理。
-
-共享不延伸到 `runtime/` 或 `documents/`。即使它们位于同一个根，其他 Agent 也必须自行实现相应协议才能理解这些 DSH 管理层；不能把“共享 Mnemon 长期记忆”表述为自动共享完整 DSH 上下文。
-
-## 四类关系
-
-Mnemon 长期层保留 `temporal`、`semantic`、`causal` 和 `entity` 关系。插件不会要求每条记忆都手工创建关系；关系应在确实能改善未来召回时建立。记忆体页可以聚合多个已激活记忆体的记忆、实体、关系和空间归属。
-
-## 数据权威表
-
-| 数据 | 权威源 | 派生/缓存 |
-|---|---|---|
-| 热记忆 | `runtime/memories.json` | `USER.md`、`MEMORY.md` |
-| Documents | `documents/index.json` + 托管 Markdown | excerpt、搜索排序、状态聚合 |
-| Memory Space 目录 | `data/.dsh-memory-bodies.json` + 磁盘 Store | Web 状态聚合 |
-| 长期记忆 | 各 Store 的 `mnemon.db` | HTML/DOT 图谱解析结果 |
-| 审查水位 | Host 进程内存 | 状态页快照；尚未持久化 |

package/docs/zh-CN/ui-guide.md

@@ -1,160 +0,0 @@
-# Sidebar 与对话交互指南
-
-**简体中文** | [English](../en/ui-guide.md) | [文档中心](./README.md)
-
-本指南以默认的 `sidebar` 形态为主，按真实使用路径介绍记忆系统。截图来自 v0.1.5 实机界面；数量、名称和内容会随你的数据变化。
-
-## 先认识两种展示形态
-
-在 DSH 的“设置 → 记忆系统”中选择入口与存储位置：
-
-[![记忆系统设置：Sidebar、Buildin、存储位置、对话界面与备份迁移](../assets/screenshots/settings-memory-system.png)](../assets/screenshots/settings-memory-system.png)
-
-| 形态 | 适合场景 |
-|---|---|
-| **Sidebar**（默认） | 从 DSH 左侧栏进入独立工作台；外观与任务看板、SSH 等官方面板一致，适合日常管理 |
-| **Buildin** | 在对话区内打开原有标签页；保留之前的布局和视觉，适合依赖旧工作流的用户 |
-
-两种形态共享功能、数据和 Host 服务，只拆分入口与外观。保存后实时切换，不需要刷新浏览器，也不会同时挂载两个入口。
-
-## 工作台结构
-
-Sidebar 顶部始终回答三个问题：
-
-1. 现在打开的是“记忆系统”；
-2. 存储位置使用全局、工作区还是自定义模式；
-3. Host 是否已连接。
-
-主体只有四个一级标签：**状态、运行时、记忆体、档案**。记忆体内部再分为**概览、检索、内容、实体**；“沉淀记忆”固定为这一层的主要动作。
-
-## 1. 状态：先确认系统是否可用
-
-[![状态页：版本、运行时、记忆体、档案与存储根摘要](../assets/screenshots/status-overview.png)](../assets/screenshots/status-overview.png)
-
-状态页聚合以下信息：
-
-- Mnemon CLI 与 dsh-mnemon 当前版本；
-- USER / MEMORY 运行时条目数；
-- 已激活记忆体与长期记忆数量；
-- active / archived 档案数量；
-- 当前存储根，以及 Runtime、Documents、Memory Spaces 三个实际目录。
-
-如果这里显示异常，先不要沉淀或归档；从[故障排查](./operations.md#故障排查)开始检查。
-
-### 检查与更新版本
-
-点击版本区域会打开只读检查面板：
-
-[![检查与更新 Mnemon 和 dsh-mnemon 版本](../assets/screenshots/version-check.png)](../assets/screenshots/version-check.png)
-
-检查不会自动安装。只有识别到受支持的安装来源并发现新版本时，才会出现“更新”。更新完成后界面会自动重新检查并刷新系统状态；dsh-mnemon 更新后仍需重启 `dsh web` 才能加载新代码。
-
-## 2. 运行时：管理每轮都会使用的热记忆
-
-[![运行时记忆：容量摘要、范围筛选、内容筛选与统一列表](../assets/screenshots/runtime-memory.png)](../assets/screenshots/runtime-memory.png)
-
-页面上方分别显示用户画像（`USER.md`）和工作记忆（`MEMORY.md`）的条目与容量；下方是统一列表。
-
-- 用“全部 / 用户画像 / 工作记忆”筛选范围；
-- 用右侧输入框按内容筛选；
-- 标签显示来源和重要性；
-- “编辑”打开弹窗，“移除”进入危险操作流程；
-- 长列表通过“再显示 N 条”逐步展开。
-
-### 添加运行时记忆
-
-[![添加热记忆弹窗：内容、分类与重要性](../assets/screenshots/runtime-memory-add.png)](../assets/screenshots/runtime-memory-add.png)
-
-一条运行时记忆应当简洁、独立、未来仍然常用。用户身份、偏好与明确协作要求放入“用户画像”；项目、环境、决策和工具经验放入“工作记忆”。临时进度、原始日志和一次性事实不适合这里。
-
-## 3. 记忆体：管理长期记忆与关系
-
-### 概览
-
-[![记忆体概览：目录卡片、激活开关与多空间关系图](../assets/screenshots/overview-memory-graph.png)](../assets/screenshots/overview-memory-graph.png)
-
-目录卡片先展示名称和路由说明，右上角是读取激活开关，底部是统计与编辑 / 删除操作。激活只控制读取范围；写入可以选择已登记但未激活的目标，成功后会自动激活。
-
-下方关系图聚合全部已激活记忆体。布局、拖拽和重置只影响当前浏览器展示，不会修改 Mnemon 数据。
-
-### 沉淀记忆
-
-[![沉淀记忆弹窗：候选内容与可选高级约束](../assets/screenshots/remember-dialog.png)](../assets/screenshots/remember-dialog.png)
-
-默认只需填写候选内容。确认后，隔离的记忆子 Agent 会判断是否值得保存、选择最窄记忆体、查重、提炼并写入。“人工高级选项”只用于确实需要约束目标记忆体、分类或重要性时。
-
-### 检索
-
-[![记忆检索：查询、分类、策略、原始召回与加载更多](../assets/screenshots/recall-agent-answer.png)](../assets/screenshots/recall-agent-answer.png)
-
-- **直接检索**返回原始证据，不启动回答 Agent；
-- **Agent 查询**先取得相同证据，再让无 Mnemon 工具的 evidence-only worker 组织答案；
-- 分类与策略可以缩小范围；
-- 结果保留记忆体来源、分类、重要性、分数与 ID；
-- “查看关联”继续沿图遍历，“忘记”属于破坏性语义操作。
-
-使用具体问题比宽泛关键词更可靠。例如“这个项目为什么禁止 shell 拼接？”通常优于“项目架构”。
-
-### 内容与实体
-
-| 内容 | 实体 |
-|---|---|
-| [![记忆内容列表与筛选](../assets/screenshots/memory-content.png)](../assets/screenshots/memory-content.png) | [![实体查询与相关记忆](../assets/screenshots/entities-context.png)](../assets/screenshots/entities-context.png) |
-
-- **内容**用于无召回副作用地浏览长期记忆，并按文本或分类筛选；可以查看关联、基于当前内容新建、复制 ID 或忘记。
-- **实体**先显示高频实体，选择或输入名称后聚合跨事实、决策与上下文的相关记忆。
-
-两页都采用可见数量 / 总数和加载更多，避免大量数据一次撑满页面。
-
-## 4. 档案：保留完整项目叙事
-
-[![项目档案：容量摘要、渐进目录与独立 Markdown 阅读器](../assets/screenshots/documents-markdown.png)](../assets/screenshots/documents-markdown.png)
-
-档案适合设计、调查、流程、复盘和交接。左侧目录分批加载，右侧保留标题、检索说明、来源、revision、哈希、文件大小与完整 Markdown；切换文档时阅读区会回到顶部。
-
-达到 active 容量上限前，最久未使用的档案会先在 Mnemon 中建立冷引用，再迁入 archived；失败或 revision 冲突时保留 active 原文。
-
-### 新建档案
-
-[![创建托管档案弹窗](../assets/screenshots/document-create-dialog.png)](../assets/screenshots/document-create-dialog.png)
-
-标题与检索说明决定未来是否容易找到，来源路径用于追溯；正文保留 Markdown 结构。原项目文件始终只读，工作台创建的是受管副本。
-
-## 5. 对话内交互
-
-### 本回合记忆
-
-[![展开本回合记忆：召回、档案检索与精确工具跳转](../assets/screenshots/conversation-turn-memory.png)](../assets/screenshots/conversation-turn-memory.png)
-
-只有已完成且发生记忆活动的回合才显示这一行。展开后列出具体工具；点击工具名会打开对应页面，并保留当前会话上下文。
-
-[![从本回合记忆跳转到记忆体检索页](../assets/screenshots/conversation-memory-jump.png)](../assets/screenshots/conversation-memory-jump.png)
-
-### 存入记忆
-
-[![确认存入记忆：编辑候选后再交给记忆子 Agent](../assets/screenshots/conversation-save-dialog.png)](../assets/screenshots/conversation-save-dialog.png)
-
-“存入记忆”位于已定稿助手回复的原生操作区。点击只会打开确认弹窗并读取这条回复；可以修改候选或取消。只有点击“确认并交给记忆子 Agent”才会执行写入流程。
-
-## 工作区模式：查看与执行分离
-
-`storageScope=workspace` 下需要区分两个概念：
-
-| 概念 | 由什么决定 | 影响什么 |
-|---|---|---|
-| **查看工作区** | 工作台顶部的工作区选择器 | 当前页面展示和人工维护哪套 `<workspace>/.mnemon` |
-| **执行工作区** | 当前对话 / Agent 的 cwd | 工具、命令、生命周期与子 Agent 实际使用哪套目录 |
-
-因此，你可以留在项目 A 的对话中查看项目 B 的记忆，但 Agent 仍然使用项目 A。两者不一致时，顶部会显示提示与一键对齐；需要 Agent 子任务的操作会被 Host 拒绝，防止写错项目。切换查看工作区会先卸载旧页面状态，再加载新目录。
-
-`global` 与 `custom` 只有一个明确存储根，不需要这层对齐。
-
-## 常见交互规则
-
-- 蓝色实心按钮表示当前主要动作；蓝色描边通常用于编辑；红色用于移除、删除、归档或忘记；中性按钮用于查看、复制与取消。
-- 删除记忆体等物理危险操作需要独立确认；“忘记”是长期语义软删除，也只应在明确需要时使用。
-- 保存配置后页面自动清理旧状态并重新读取，无需浏览器刷新。
-- Sidebar 的一级页头保持稳定；记忆体内部二级内容标题随内容自然滚动。
-- Buildin 保留既有布局和视觉，功能说明仍可参考本指南，但控件位置可能不同。
-
-下一步：[快速开始](./getting-started.md) · [存储模型](./storage-model.md) · [配置参考](./configuration.md) · [运维指南](./operations.md)

package/docs/zh-CN/workflows.md

@@ -1,290 +0,0 @@
-# 生命周期与核心流程
-
-**简体中文** | [English](../en/workflows.md) | [文档中心](./README.md)
-
-## 每轮上下文
-
-插件注册两个 system prompt section：
-
-- `mnemon:routing`：当 `routingGuidance=true` 时提供简短的分层查询边界；
-- `mnemon:runtime-memory`：每次组装 prompt 时读取最新 `USER.md` 和 `MEMORY.md`，并附带保存准入规则。
-
-生命周期 hook 不会在每轮开始无条件读取记忆体目录或执行 recall：
-
-```text
-agent/session-start
-  -> mark primePending
-
-agent/pre-step(step=1)
-  -> cancel pending/running background review for a new turn
-  -> mark Prime once
-  -> optionally append one short recall/writeback cue
-  -> main Agent decides whether to call a memory tool
-```
-
-Prime 只初始化路由状态，不执行异步 CLI 状态查询。
-
-## 主 Agent 召回
-
-```text
-Root Agent calls mnemon_recall(query)
-          |
-          v
-MnemonSubagentCoordinator
-          |
-          | spawn + recall persona
-          | allow: memory_bodies, recall, related
-          v
-Recall worker lists the catalog
-          |
-          v
-select active Memory Space(s) by name + description
-          |
-          v
-call mnemon_recall from the worker
-          |
-          v
-MnemonService searches selected Store(s)
-          |
-          v
-normalize and attach memoryBodyId / memoryBodyName
-          |
-          v
-structured output, Host caps results at 12
-          |
-          v
-Root Agent receives evidence, not the raw routing trace
-```
-
-如果用户已经提供当前事实，或仓库可以直接回答，Agent 不应为了“展示记忆”而召回。需要关系解释时，先使用 recall 返回的完整 `memoryBodyId + id`，再执行 related。
-
-## Web 检索和 Agent 查询
-
-Web “检索”页与模型工具路径不同：
-
-```text
-Direct search
-  -> RPC read channel
-  -> MnemonService.search directly
-  -> raw evidence
-
-Agent search
-  -> the same deterministic direct search
-  -> spawn a worker with no Mnemon tools
-  -> answer only from supplied evidence
-  -> Host filters citations to actual memoryBodyId/id pairs
-```
-
-“实体”和“内容”页也直接读取确定性服务，不启动 recall worker。“内容”使用图谱快照，不增加 Mnemon recall 访问计数。
-
-## 显式长期写入
-
-根 Agent 或 `/mnemon remember` 的长期写入流程：
-
-```text
-durable candidate
-       |
-       v
-spawn write worker
-       |
-       +-- list Memory Spaces
-       +-- choose the narrowest suitable scope
-       +-- recall when duplicate/conflict checking is useful
-       +-- create a new scope only for a recurring distinct domain
-       +-- remember / link / forget / merge as requested
-       v
-structured receipt
-```
-
-新建 Memory Space 的 ID 由 Host 生成。向 inactive 目标写入成功后会激活它。来源数据库的合并是非破坏性的。
-
-运行时 `add` / `replace` / `remove` 和 Document `create` / `update` 不需要模型做存储 I/O；它们通过 coordinator 进入确定性控制层。容量维护和归档才启动专用 worker。
-
-## Runtime add：正常路径
-
-```text
-request
-  -> normalize content
-  -> acquire in-process queue and file lock
-  -> reload memories.json
-  -> validate unique match / duplicate / capacity
-  -> write temporary JSON and Markdown projections
-  -> rename projections
-  -> rename memories.json as the commit marker
-  -> return compact receipt
-```
-
-`replace` 和 `remove` 必须通过 `old_text` 唯一命中一条。容量维护只在 `add` 溢出时自动触发。
-
-## USER.md 容量整理
-
-```text
-USER add exceeds 4 KiB
-          |
-          v
-snapshot revision + committed entries
-          |
-          v
-spawn no-tool local compactor
-          |
-          v
-return compacted entries + sourceIndexes
-          |
-          v
-Host validates:
-  - every source index appears exactly once
-  - no duplicate or out-of-range index
-  - importance is not lowered
-  - candidate fits the Host byte budget
-  - revision is still current
-          |
-          +-- invalid/conflict -> preserve original data
-          |
-          v
-deterministic UTF-8 packing
-          |
-          v
-retry pending add
-```
-
-用户画像不会被发送到 Memory Spaces。worker 没有任何工具权限。
-
-## MEMORY.md 归档与压缩
-
-```text
-MEMORY add exceeds 10 KiB
-          |
-          v
-snapshot revision + committed entries
-          |
-          v
-spawn archive worker
-  allow: memory_bodies, recall, remember, body_create
-          |
-          v
-route semantic clusters and archive or duplicate-check them
-          |
-          v
-return action + target spaces + compacted candidates
-          |
-          v
-Host validates structure, action, revision and byte budget
-          |
-          +-- failure/conflict -> preserve hot memory
-          |
-          v
-pack candidates by importance
-          |
-          v
-retry pending add
-```
-
-worker persona 要求每条已提交 entry 都被长期表示或验证为重复；这是 LLM 监督策略。Host 的硬保证是结构、revision 和容量验证，不应把语义覆盖描述成数据库级证明。
-
-如果长期写入成功后发生 revision 冲突，热记忆会保留，长期层可能同时已有副本。插件优先避免丢失，不尝试跨数据库和文件系统回滚已完成的 Mnemon 写入。
-
-## Documents 创建、更新和归档
-
-```text
-create/update request
-          |
-          v
-capacityPlan using rendered UTF-8 bytes
-          |
-     +----+----+
-     |         |
-    fits     overflow
-     |         |
-     v         v
- commit    select least-recently-used active Document
-               |
-               v
-          snapshot document + revision
-               |
-               v
-          spawn archive worker
-               |
-               v
-       write/verify concise Mnemon cold reference
-       with title, summary, planned path, SHA-256
-               |
-          +----+----+
-          |         |
-        failed    receipt ok
-          |         |
-          v         v
-   keep active   revision check
-                    |
-               +----+----+
-               |         |
-             conflict   current
-               |         |
-               v         v
-          keep active  move file to archived
-                             |
-                             v
-                    retry original mutation
-```
-
-人工归档使用同一条“先索引、后迁移”路径。Mnemon 索引已经成功但 revision 冲突时不会回滚索引，因此可能出现安全的重复引用，而不会丢失 active 原文。
-
-## 确定性活动评分和后台审查
-
-完成的 turn 累计四种信号：
-
-```text
-score =
-  min(floor(totalUserCharacters / 50), 3)
-  + completedTurnCount
-  + min(floor(completedToolResults / 5), 2)
-  + toolDiversityScore
-
-toolDiversityScore:
-  unique tools < 3  -> 0
-  unique tools = 3  -> 1
-  unique tools >= 4 -> 2
-
-eligible when score >= 5
-```
-
-达到门槛并不代表一定写入：
-
-```text
-completed turn
-      |
-      v
-score >= 5 ? -- no --> retain activity for later turns
-      |
-     yes
-      |
-      v
-wait idleReviewMs (default 30 s)
-      |
-      +-- new turn --> cancel timer/worker, retain activity
-      |
-      v
-confirm Agent is idle and turn/end exists
-      |
-      v
-fork completed parent checkpoint
-      |
-      v
-conservative maintenance decision
-  - at most one hot-memory mutation by persona
-  - at most one Document create/update by persona
-  - no direct long-term remember/forget tools
-      |
-      +-- completed, including skip -> clear activity
-      |
-      +-- failed/aborted ------------> retain activity
-```
-
-“最多一次”当前由 worker persona 约束，不是 Host mutation counter。后台水位尚未持久化，Host 重启会丢失未处理的累计信号。
-
-## 配置开关的关系
-
-- `recallMode=off`：不再注入 recall cue，显式 `mnemon_recall` 仍可用。
-- `writebackMode=off`：关闭写回 cue 和评分后台审查，显式写入仍由 `writeEnabled` 决定。
-- `lifecycleEnabled=false`：关闭生命周期提醒和审查，不移除显式工具或 Web 入口。
-- `routingGuidance=false`：只移除额外路由 section；Runtime Memory section 仍注册。
-- `writeEnabled=false`：移除语义写工具和写 RPC，拒绝写命令；它不是文件系统只读挂载保证。