feat: add git-consistent memory gateway architecture

2026-03-07 22:33:41 +08:00
commit d4cd81f498
40 changed files with 2114 additions and 0 deletions
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -0,0 +1,11 @@
+# AGENTS.md
+
+## Working Rules
+
+- 先阅读 `README.md`，确认架构和 API 约定后再修改代码。
+- 修改 `memory-gateway`、`git` 同步逻辑或 `docker-compose.yml` 后，先运行测试再提交结果。
+- 不要破坏现有 `qmd` 容器能力（HTTP MCP、健康检查、模型配置与持久化）。
+- 优先保证功能正确性和可恢复性，不为了“优雅”牺牲可追溯和可运维性。
+- 每次查询返回必须可追溯到 `branch + commit_hash + synced_at`。
+- 禁止实现“单目录频繁 checkout 不同 branch”的方案；必须使用分支隔离 workspace。
+- 任何查询一致性逻辑必须遵循：`sync git -> qmd update/embed -> query`。