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 `repos` Test Plan Index
## Case Files
| Case Slug | File | Coverage Note |
| --- | --- | --- |
| `repos-lists-tracked-repositories` | [repos-lists-tracked-repositories.md](./repos-lists-tracked-repositories.md) | lists every tracked repository with entry counts and update timestamps |
| `repos-prints-no-repos-when-empty` | [repos-prints-no-repos-when-empty.md](./repos-prints-no-repos-when-empty.md) | prints `no repos` for an initialized but unused database |
@@ -0,0 +1,28 @@
# Case: `repos-lists-tracked-repositories`
## 用例意义
验证 `repos` 会列出当前数据库中所有已注册仓库,并附带 entry 数量。
## 前置条件
- 空数据库已完成 `init`
- 已存在两个 Git 仓库:`TMPDIR/cupid-service``TMPDIR/mars-service`
- 已分别执行一次 `add`,使两个 repo 都被注册到数据库
## 输入
```bash
repo-memory repos --db TMPDIR/repo-memory.db
```
## 预期输出
- 命令退出码为 `0`
- 输出包含 `TMPDIR/cupid-service (1 entries, updated `
- 输出包含 `TMPDIR/mars-service (1 entries, updated `
## 断言结论
- `repos` 以 repo 为聚合维度展示当前内存库覆盖范围
- 输出中的条目数来自持久化 entry 统计,而不是瞬时搜索结果
@@ -0,0 +1,25 @@
# Case: `repos-prints-no-repos-when-empty`
## 用例意义
验证 `repos` 在数据库已初始化但没有任何 repo 记录时返回稳定空结果文本。
## 前置条件
- 空数据库已完成 `init`
## 输入
```bash
repo-memory repos --db TMPDIR/repo-memory.db
```
## 预期输出
- 命令退出码为 `0`
- stdout 等于 `no repos`
## 断言结论
- `repos` 的空结果是正常状态,而不是错误
- 该命令可作为“数据库里是否已经有任何 repo memory” 的快速探针