使用说明
ai工具栈
此仓库是ApertureStack工具生态系统的发布序列控制点。 它的存在是为了遏制版本蔓延和连锁效应。
它做了三件事：
- 在DAG中标记版本。
- 运行跨库烟雾测试(
smoke_test.go). - 提供规范的凹凸顺序和工作流程。
存储库结构
ApertureStack由10个存储库组成：
| 存储库 | 描述 | 包 |
|---|---|---|
| 工具基础 | 核心模式、适配器、版本控制 | 模型、适配器、版 |
| 工具发现 | 注册表、搜索、语义、文档 | 索引、搜索、含义、工具文档 |
| toolexec | 执行、运行时、编排 | 运行、运行时，代码、后端 |
| toolexec集成 | 运行时客户端集成 | kubernetes、proxmox、remotehttp |
| 工具组合 | 工具集、技能 | 集、技能 |
| 工具操作 | 可观察性、缓存、身份验证 | 观察、缓存、认证、弹性、健康 |
| 工具协议 | MCP协议支持 | 传输、连线、发现、内容、任务、流、会话、引出、资源、提示 |
| 元工具mcp | MCP服务器应用程序 | -- |
| 元工具-a2a | A2A服务器应用程序 | -- |
| ai工具栈 | 此仓库-文档和版本矩阵 | -- |
烟雾测试包括哪些内容
smoke_test.go 检查整个堆栈是否仍然组成：
tooldiscovery/index发现（与tooldiscovery/searchBM25注射液）tooldiscovery/tooldoc渐进式披露toolexec/run执行toolexec/code编排toolexec/runtime发动机适配器metatools-mcp类型兼容性metatools-a2a表面布线（代理卡+技能）
这是有意重集成轻实施。
版本兼容性
看 VERSIONS.md 对于权威的兼容性矩阵。
文件网站
该仓库还托管了统一文档网站（MkDocs+multirepo） 聚合来自所有工具库和MCP服务器的文档。
本地构建：
pip install -r requirements.txt
./scripts/prepare-mkdocs-multirepo.sh
mkdocs serve
版本预览（mike）：
pip install -r requirements.txt
./scripts/prepare-mkdocs-multirepo.sh
mike serve
DAG感知碰撞顺序（非自由式）
除非您有意支付爆炸半径，否则请始终按此顺序撞击：
toolfoundation（基础层）tooldiscovery（发现层）toolexec（执行层）toolexec-integrations（执行集成）toolcompose（组成层）toolops（操作层）toolprotocol（协议层）metatools-mcp（应用层）metatools-a2a（应用层）
发布工作流（此仓库的要点）
当您剪切或接收新的上游标签时：
- 请先在此处更新。
- 在这里打开集成门。
- 只有这样，下游的颠簸才会级联。
- 仅在您实际需要更改时标记下游仓库。
例子：
go get github.com/jonwraymond/toolfoundation@v0.1.1
go mod tidy
go test ./...
go vet ./...
如果此repo为红色，请不要碰撞DAG。
自动化（来自此仓库）
使用DAG感知凹凸助手。默认情况下为模拟运行：
./scripts/bump-dep.sh --dep toolfoundation --latest
./scripts/bump-dep.sh --dep toolfoundation --version v0.1.1 --apply
此更新影响了以下存储库 ~/Documents/Projects，运行 go mod tidy,
go test ./...，以及 go vet ./...。它不会为您提交或标记。
操作员检查表
将此作为一致的发布列车检查表：
- 上游回购：合并、标记、推送。
- 这里：撞
go get那么go mod tidy. - 这里：run
go test ./...和go vet ./.... - 这里：等待CI变绿。
- 下游：按DAG顺序凸起。
本地验证
go test ./...
go vet ./...
go list -m all | rg jonwraymond
