Add repo-memory CLI test docs

This commit is contained in:
2026-03-20 15:42:35 +08:00
parent e32c81db12
commit a6ffc376e3
43 changed files with 1583 additions and 17 deletions
+8
View File
@@ -0,0 +1,8 @@
# Repo Memory `list` Test Plan Index
## Case Files
| Case Slug | File | Coverage Note |
| --- | --- | --- |
| `list-filters-by-kind-and-status` | [list-filters-by-kind-and-status.md](./list-filters-by-kind-and-status.md) | narrows entries by repo substring, kind, and status |
| `list-returns-no-entries-when-empty` | [list-returns-no-entries-when-empty.md](./list-returns-no-entries-when-empty.md) | prints `no entries` when the filtered result set is empty |
@@ -0,0 +1,34 @@
# Case: `list-filters-by-kind-and-status`
## 用例意义
验证 `list` 会同时应用 repo、kind、status 过滤条件,而不是只看其中之一。
## 前置条件
- 空数据库已完成 `init`
- 同一 repo 下已存在三条 entry
```bash
repo-memory add --db TMPDIR/repo-memory.db --repo TMPDIR/repo --kind term --key AITask --summary "Plan 内嵌任务结构" --status confirmed
repo-memory add --db TMPDIR/repo-memory.db --repo TMPDIR/repo --kind term --key AIJob --summary "后台任务封装" --status draft
repo-memory add --db TMPDIR/repo-memory.db --repo TMPDIR/repo --kind chain --key ai-insight.get --summary "gateway -> app service -> cache/db" --status confirmed
```
## 输入
```bash
repo-memory list --db TMPDIR/repo-memory.db --repo repo --kind term --status confirmed
```
## 预期输出
- 命令退出码为 `0`
- 输出包含 `term:AITask [confirmed]`
- 输出不包含 `AIJob`
- 输出不包含 `chain:ai-insight.get`
## 断言结论
- `list` 过滤条件是交集语义
- repo 路径过滤、kind 过滤、status 过滤可以叠加使用
@@ -0,0 +1,25 @@
# Case: `list-returns-no-entries-when-empty`
## 用例意义
验证 `list` 在没有任何匹配 entry 时返回稳定空结果文本。
## 前置条件
- 空数据库已完成 `init`
## 输入
```bash
repo-memory list --db TMPDIR/repo-memory.db --repo repo --kind term --status confirmed
```
## 预期输出
- 命令退出码为 `0`
- stdout 等于 `no entries`
## 断言结论
- 空列表属于正常读取路径,不应被当作错误
- 调用方可以通过固定文本判断当前过滤条件下无匹配项