REST/JSON 是事实来源
/agent/v1 提供 capabilities、project、graph、context、proposal、batch、event 和 readback；CLI 和 MCP stdio 只是薄适配器，不直接读取 SQLite。
开发者文档
通过同一份受治理契约，把兼容工具接到本地 GrowthMap。
这是高级集成参考。接口位于 127.0.0.1 本地，不是公开云端 API，也不代表任何具名 Agent 已有一键集成。
01 / 接口和共同语义
Context Packet
包含 target、ancestors、children/current work、decisions、constraints、risks、relations、revisions 和 snapshot digest。
02 / 授权和一致性
Grant scope
read、propose、write 可限制到 project、exact node 或 branch descendants，并可到期或撤销。
Revision 和 409
写入携带预期 project/entity revision；版本不同返回 409。请重新获取 Context Packet 并协调后再提交。
Atomic batch
同一批变更全部成功或全部失败，避免只写入一部分。
Idempotency 和 receipt
相同 idempotency key 和相同请求可安全重试并获得同一 receipt；更换 payload 却重用 key 会被拒绝。
03 / 经 repo contract 验证的只读最小示例
CLI / HTTP
CLI 获取默认 context：python3 scripts/growthmap_agent.py context --token-file <OWNER_ONLY_TOKEN_FILE> --base-url http://127.0.0.1:8100/agent/v1 --target <PROJECT_NODE_UUID>。在 POSIX 中，token file 必须仅允许所有者读写。HTTP 可另外带 objective：GET /agent/v1/context/<PROJECT_NODE_UUID>?objective=read-only-context，并通过 Authorization: Bearer <GRANT_TOKEN> header 发送；token 不得放入 URL。
04 / 集成状态和限制
当前可用
本地 REST/JSON v1、通用 CLI、MCP stdio、grant scope、人工审核、revision 409、atomic batch、idempotent receipt 和 readback。
仍是原型或规划
运行中的 API 已返回 Context Packet，但独立 JSON Schema、完整示例、各工具指南和 conformance tests 尚未发布。
不包含的能力
没有公开云端 Agent API、云同步、多人实时工作区、Git 自动扫描、自动执行 Agent、系统权限，也没有具名工具的一键官方集成。