evolcore 0.0.38 → 0.0.40

package/kits/templates/system-fragments/memory.md

@@ -11,8 +11,9 @@
 -   偏好/习惯：我喜欢、我不喜欢、我偏好、我习惯
 -   约束/禁止：不要、禁止、避免、别再、不允许
 -   规则/注意：注意、当心、以后、每次、必须、务必
--   纠错反馈：错了、不对、应该是、你搞错了  
-    不写：会话内临时信息；隐私信息。  
+-   纠错反馈：错了、不对、应该是、你搞错了
+-   自己发现的规律：对端的工作方式、反馈模式等跨会话有用的观察  
+    不写：会话内临时信息；隐私信息；当前话题的进展（写话题摘要，见 `[thread]` 段）；代码结构、文件路径、git 历史（代码库本身就记录了）。  
     **每轮审查（静默）**：每轮结束前扫描完整会话上下文（含历史轮次），检查有无通过判据但未记录的信息，或已有 note 需更新。  
     **命令**（`--slug` 必填，字母/数字/连字符，1-64 字符，当前关系内唯一）：
 
@@ -44,12 +45,17 @@ slug 撞名改用 `update`。完整用法见 `$KITS_DOCS/evolcore/memory.md`。
 
 ```bash
 ec memory create --scope <relation|agent|owner> --slug <slug> --desc '一句话描述' \
-  [--peer <peerKey>] --tags '<tag1>,<tag2>' [--keywords '<kw1>,<kw2>'] [--replaces '<路径1>,<路径2>'] '<正文>'
+  [--peer <peerKey>] --tags '<tag1>,<tag2>' [--keywords '<kw1>,<kw2>'] [--replaces '<路径1>,<路径2>'] \
+  [--reason '为什么'] [--generalized-from '<路径>'] [--promoted-from '<路径>'] '<正文>'
 ec memory update <路径> --tags '<tag1>,<tag2>'      # 整体替换标签，不是追加；改不了正文
 ec memory update <路径> --touch                  # 只刷新时间戳（遗忘续期）
 ec memory archive <路径...>                      # 下线记忆，移入 archive/
 ```
 
+泛化 / 提升专用：`--generalized-from <路径>`（scope=agent）、`--promoted-from <路径>`（scope=owner）记录来源，供 `ec memory demote` 回退。值为相对 `agents/<selfAid>/` 的路径。
+
+**跨层路径**：候选清单里的路径形如 `<peerKey>/consolidated/xxx.md`，直接照抄即可——它解析到本次会话所属关系的记忆，归档也落在该关系自己的 `archive/`。peerKey 只能是本次会话所属关系。不带前缀的 `consolidated/xxx.md` 一律指本次产出所在层。
+
 整理结束后，把本次整理的整体反馈写入任务书里指定的**反馈文件路径**。未写入则收尾时回退到默认统计模板（模式、触发方式、耗时、新建/更新/归档条数等）。
 
 自由文本参数（`--desc`、正文、`--keywords`）用**单引号**包住（`'…'`）；
@@ -63,6 +69,9 @@ ec memory archive <路径...>                      # 下线记忆，移入 archi
 | --tags | 必填，取值见 $KITS_DOCS/evolcore/memory-tags.md |
 | --keywords | 可选，串起相关记忆的内容关键词 |
 | --replaces | 可选，要替换的旧文件，自动归档。合并、纠正、升格作用域都走它，是唯一的防重复手段 |
+| --reason | 可选但应当写：一句话说明为什么做这个操作。进 ops.jsonl 的操作流水，不写进记忆正文 |
+| --generalized-from | 仅 scope=agent：泛化来源，相对 `agents/<selfAid>/` 的路径，供 demote 回退 |
+| --promoted-from | 仅 scope=owner：提升来源，相对 `agents/<selfAid>/` 的路径，供 demote 回退 |
 
 `--tags`、`--keywords`、`--replaces` 的值写成单引号包住、逗号分隔：`--tags 'rule,long-term'`、`--replaces 'consolidated/a.md,consolidated/b.md'`。
 

package/kits/templates/system-fragments/session.md

@@ -38,7 +38,7 @@ readonly: true — 禁止写入项目目录及临时目录；如需生成文件
 {{/}}
 # 决定响应后：
 # 命令速查：
-# 每次工具调用只执行一条完整的 ec 命令；禁止 command -v。托管 `ec aid` 允许 `show {{selfAid}}`、`lookup <任意合法 AID>`、`agentmd get <任意合法 AID>`；仅 request/bypass 可对 `{{selfAid}}` 执行 `agentmd put`。可选后缀仅限 --format json；禁止 &&、||、;、|、重定向、子 shell、bash -lc/sh -c 或其它脚本与其串联。
+# 每次工具调用只执行一条完整的 ec 命令；禁止 command -v。托管 `ec aid` 允许 `show {{selfAid}}`、`lookup <任意合法 AID>`、`agentmd get <任意合法 AID>`；仅 request/bypass 可对 `{{selfAid}}` 执行 `agentmd put`。可选后缀仅限 --format json；禁止 &&、||、;、子 shell、bash -lc/sh -c 或其它脚本与其串联。Bash 下输出过长时，可在 ec 后接只读 stdin 的过滤管道收窄输出，或用 `> $TMPDIR/<新文件>` 存盘后另行处理；PowerShell/cmd 下两者都不支持。
 # 审批拒绝时原样报告并停止；必须收到包含 message_id/status 的成功回执后才能声称已发送。
 {{?chatType=group}}
 #   群内公开发送用 ec group send；语法与选项见 [channel] 段。

package/kits/{rules/07-memory-and-thread.md → templates/system-fragments/thread.md}

@@ -1,59 +1,13 @@
-# 记忆与话题：持久化上下文的两套机制
+[thread] 话题系统（ec thread）
+触发词：话题/thread/summary/摘要/ec thread/话题名/工作报告
 
-触发词：记忆/memory/话题/thread/summary/摘要/ec memory/ec thread/话题名/工作报告
+话题摘要是**话题级**的进展快照：这条任务线做了什么、结果如何，供下次激活时快速恢复。
+对端的长期事实（偏好、角色、背景）不写这里，写记忆（见 `[memory]` 段）。
 
-这两套机制共同解决"跨会话上下文丢失"的问题，但定位不同：
+`ec thread` 的 `<peer>` 参数是对端**裸 AID**（取 `peerId`，如 `alice.agentid.cn`），
+不是 `aun#…` 形态的 peerKey；传 peerKey 会静默返回 0 条。
 
-| 机制 | 粒度 | 作用 | 写入时机 |
-|------|------|------|----------|
-| 记忆（memory） | 对端级 / agent 级 / owner 级 | 跨所有话题持久化的长期事实 | 每轮对话中识别到值得保留的事实时 |
-| 话题摘要（summary） | 话题级 | 这个话题的进展快照，供下次激活时快速恢复 | 阶段完成时、离开话题前 |
-
-两者不冲突，按粒度分工：对端的基本信息（偏好、角色、背景）写进记忆；这个任务线做了什么、结果如何写进话题摘要。
-
----
-
-## 一、记忆系统（ec memory）
-
-记忆是写给自己、跨会话持久的事实。不要依赖会话上下文来记住用户说过的事，用记忆系统写下来。
-
-### 什么时候写记忆
-
-**必须写的情况**：
-- 用户告知了关于自己的事实（姓名、职业、偏好、背景）
-- 用户明确要求"记住"某件事
-- 发现了跨会话有用的规律（用户的工作方式、反馈模式）
-
-**不要写的情况**：
-- 当前话题的具体进展（写话题摘要，不写记忆）
-- 只在本会话有意义的临时状态
-- 代码结构、文件路径、git 历史（代码库本身就记录了）
-
-### 记忆命令
-
-```bash
-# 写入新 note
-ec memory note --slug <slug> [--tags '<tag1>,<tag2>'] '<正文>'
-
-# 修改已有 note
-ec memory note update <slug> '<新正文>'
-
-# 查看待整理 notes
-ec memory note list
-
-# 触发整理会话（将 notes 归档为正式记忆）
-ec memory consolidate
-```
-
-### 默认行为
-
-记忆写入动作默认**静默**，不打断对话。用户明确要求记住某事时，给一句简短确认（"已记下"），然后继续。
-
----
-
-## 二、话题系统（ec thread）
-
-### 标准工作流
+## 标准工作流
 
 ```bash
 # 1. 列出本机所有 agent
@@ -71,11 +25,11 @@ ec thread list <peer> --self <selfAid> --page 2 --limit 10 --sort recent
 # 5. 查看某话题的历史消息
 ec thread history <peer>/<threadId> --self <selfAid> --limit 20
 
-# 6. 查看/更新话题摘要
+# 6. 查看话题摘要（写摘要见下文「话题摘要维护」）
 ec thread summary show <peer>/<threadId> --self <selfAid>
 ```
 
-### 跨话题发送（联系当前对端以外的对象）
+## 跨话题发送（联系当前对端以外的对象）
 
 一个话题只有本端与对端两端。当前话题能直接回复的只有本话题的对端；要联系**其他**对象，必须换到与该对象的话题上发送：
 
@@ -95,7 +49,7 @@ ec group send '<text>' --thread <threadId> --check-every 5m     # 群对端
 - `--check-every` 会创建周期复查 Trigger（每次发送各新建一个，名称 `check-<目标>-from-<来源>-<唯一后缀>`），
   需显式 `ec trigger delete <trigger_id>` 结束（不要用 `cancel`，那只是 disable，会留下挂起的死 Trigger）；定位用返回的 `trigger_id`（`trig_…`），**不是名称**
 
-### 话题名称维护
+## 话题名称维护
 
 **何时更新名称**（主动触发，不等对端问）：
 
@@ -115,7 +69,7 @@ ec thread rename current '<新名称>'                              # 托管会
 ec thread rename <peer>/<threadId> '<新名称>' --self <selfAid>  # 宿主终端
 ```
 
-### 话题摘要维护
+## 话题摘要维护
 
 摘要是话题的进展快照，**daemon 不自动总结**，需要主动写入。
 
@@ -134,8 +88,7 @@ ec thread summary set current '<摘要内容>' --name '<新标题>'   # 2. 写
 ec thread summary show <peer>/<threadId>                              # 1. 拿 coveredThroughTs
 ec thread history <peer>/<threadId> --after <coveredThroughTs> --limit 50   # 2. 读增量
 ec thread history <peer>/<threadId> --before <最早ts-1> --limit 50    # 3. 增量多则往回翻页
-ec thread summary set <peer>/<threadId> '<摘要内容>'                   # 4. 读完再写（游标自动推进）
-ec thread rename <peer>/<threadId> '<新名称>'                           # 5. 必要时改名
+ec thread summary set <peer>/<threadId> '<摘要内容>' --name '<新标题>'   # 4. 读完再写（游标自动推进）
 ```
 
 **关键约束**：`summary set` 把游标设为**当时话题的最新一条**，所以跨话题总结**必须先把增量读完再写**——
@@ -164,22 +117,15 @@ ec thread rename <peer>/<threadId> '<新名称>'                           # 5.
 - summary 是本端私有的（keyed by 本地 sessionId），只写"我下次该知道什么"，不写给对端的话
 
 ```bash
-# 查看当前摘要和版本号
-ec thread summary show current
-
-# 写入摘要（单 agent）
-ec thread summary set current '<摘要内容>'
-
-# 写入摘要（多 agent 协作，用 CAS 防覆盖）
-ec thread summary set current '<摘要内容>' --if-rev <当前rev>
-
-# 查看摘要历史
-ec thread summary log current
+ec thread summary set current '<摘要内容>' --name - --if-rev <当前rev>   # 多 agent 协作，CAS 防覆盖
+ec thread summary log current                                            # 查看摘要历史
 ```
 
 `ec thread list` 输出里摘要显示"未总结"就是行动信号。
 
-### 话题状态管理
+**不要**：每条消息后都更新摘要（只在阶段完成时）；把摘要写成会议纪要；因为对端没问就不更新。
+
+## 话题状态管理
 
 ```bash
 ec thread status current in_progress    # 开始处理
@@ -188,12 +134,3 @@ ec thread status current completed      # 任务完成
 ```
 
 状态改为 `completed` 前，先写入最终摘要。
-
----
-
-## 三、不需要做的事
-
-- 不要在每条消息后都更新摘要——只在阶段完成时
-- 不要把话题摘要当成会议纪要——简短的进展摘记即可
-- 不要把当前话题的进展写进记忆——那是话题摘要的工作
-- 不要因为对端没问就不更新——摘要和记忆都是给自己的

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evolcore",
-  "version": "0.0.38",
+  "version": "0.0.40",
   "description": "AI Agent gateway connecting Claude, Codex, Gemini, and the bundled ecagent runner to messaging channels with multi-project session management",
   "type": "module",
   "main": "dist/index.js",
@@ -54,14 +54,14 @@
     "prepublishOnly": "npm test"
   },
   "dependencies": {
-    "@agentunion/fastaun": "0.5.22",
+    "@agentunion/fastaun": "0.5.25",
     "@anthropic-ai/claude-agent-sdk": "0.3.300",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "ajv": "^8.20.0",
     "chokidar": "^5.0.0",
     "cron-parser": "^5.5.0",
     "dotenv": "^17.4.2",
-    "ec-web": "0.0.36",
+    "ec-web": "0.0.40",
     "ignore": "7.0.5",
     "image-type": "^6.0.0",
     "partial-json": "0.1.7",