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,45 @@
+# Case: `ingest-imports-docs-ai-markdown`
+
+## 用例意义
+
+验证 `ingest` 会扫描 `docs/ai` 下的 Markdown，并把 section 导入为可检索的 durable knowledge entry。
+
+## 前置条件
+
+- `TMPDIR/repo` 是一个已提交初始 commit 的 Git 仓库
+- `TMPDIR/repo/docs/ai/repo-memory.md` 内容至少包含：
+
+```md
+# Repo Memory
+
+## Module Map
+
+- gateway
+- app/app
+
+## Danger Zones
+
+- shared libs first
+```
+
+- `TMPDIR/repo-memory.db` 尚不存在
+
+## 输入
+
+```bash
+repo-memory ingest --db TMPDIR/repo-memory.db --repo TMPDIR/repo
+repo-memory list --db TMPDIR/repo-memory.db --repo repo
+```
+
+## 预期输出
+
+- `ingest` 退出码为 `0`
+- `ingest` 输出 `ingested 1 docs from ABS_REPO`
+- `list` 输出包含 `module:repo-memory:module-map [confirmed]`
+- `list` 输出包含 `danger:repo-memory:danger-zones [confirmed]`
+
+## 断言结论
+
+- 一个 Markdown 文件中的多个 section 会被拆成多条知识 entry
+- `ingest` 会自动初始化数据库并注册 repo
+- 从 `repo-memory.md` 导入的 `Module Map`、`Danger Zones` 会被分类为不同 kind