wov-sdk/AGENTS.md

WOV SDK

本仓库是 WOV 平台的节点协议和 SDK，不包含业务逻辑。

职责

• 定义 NodeManifest：节点的能力、命令、资源、生命周期配置。
• 定义节点调用协议：GET /health、POST /invoke。
• 提供标准节点 HTTP 服务端，让每个节点仓库可以独立运行。
• 提供工作流 DAG 数据结构，供 wov-api 使用。

不变量

• SDK 保持零第三方运行时依赖，方便任意节点仓库独立安装。
• 节点之间只通过产物 URI 交换数据，不直接互相调用。
• 节点 Manifest 一旦发布，字段语义不得随意改变；新增能力必须向后兼容。

环境

• Python 环境统一使用 uv 管理，不直接使用 pip 修改依赖。
• 测试必须达到 100% 行覆盖率，且只能通过调用真实代码路径覆盖。