Add repo-memory CLI test docs

2026-03-20 15:42:35 +08:00
parent e32c81db12
commit a6ffc376e3
43 changed files with 1583 additions and 17 deletions
@@ -0,0 +1,28 @@
+# Case: `events-reads-history-by-id`
+
+## 用例意义
+
+验证 `events --id` 会返回某个 entry 的历史记录，并按新到旧排序。
+
+## 前置条件
+
+- 空数据库已完成 `init`
+- `TMPDIR/repo` 下已经执行过两次同 key 的 `add`，第二次把状态从 `draft` 更新为 `confirmed`
+
+## 输入
+
+```bash
+repo-memory events --db TMPDIR/repo-memory.db --id 1
+```
+
+## 预期输出
+
+- 命令退出码为 `0`
+- 第一行包含 `term:AITask [confirmed] #1`
+- 事件列表包含 `updated (draft -> confirmed)`
+- 较早事件包含 `created (- -> draft)`
+
+## 断言结论
+
+- `events` 不只显示当前状态，也保留状态演进轨迹
+- 输出顺序是最新事件优先，便于人工快速读到最近变化