接入 OpenSandbox 官方 Go SDK

docs/design-principles.md

@@ -93,5 +93,5 @@ OpenBao 或其他资源的特殊权限。资源所有者在资源端按照有意
 
 基础设施协议优先使用上游维护的成熟客户端，不在 controller 内重复实现认证、连接、
 资源编码或错误语义。Kubernetes 使用 `client-go`，NATS JetStream 使用 `nats.go`，
-Gitea RunnerService 使用 `actionslib`；自定义代码只保留领域模型、reconcile 规则及
-上游客户端未覆盖的最小适配层。
+Gitea RunnerService 使用 `actionslib`，OpenSandbox Lifecycle API 使用官方 Go SDK；
+自定义代码只保留领域模型、reconcile 规则及上游客户端未覆盖的最小适配层。

docs/runner-protocol-roadmap.md

@@ -43,6 +43,8 @@ dynamic-runner scheduler
   不承担 executor 生命周期记录。
 - worker 按稳定 assignment ID reconcile 后端资源，进程内只保留并发控制等可丢弃状态；
   不新增数据库，也不依赖内存中的 runner-to-executor 映射。
+- VM worker 使用 OpenSandbox 官方 Go SDK，并把 assignment ID、repository、job key 和
+  SPIFFE ID写入 sandbox metadata；通过 `extensions.poolRef=ci-vm` 使用既有 Kata Pool。
 - 结果处理顺序固定为回报 Gitea、清理后端、ACK assignment；重投时先查询 Gitea 终态，
   从而关闭后端已删除但消息尚未 ACK 的崩溃窗口。
 - Pod 与 VM 共享 task/executor 协议，只有环境创建和销毁实现不同。