Choerodon Adapter
当前猪齿鱼 Provider 与兼容入口。Test Writeback 写入、Test Intake 读取、Tech Codex 主要读写链，以及 BA/Server 业务父子任务创建已通过 DevOps Connector；Robot 工作项缓存刷新已由 Resource Synchronizer 包住成熟 MCP/SQLite Provider。Robot bundled realtime/plan/write/operate MCP 仍复用原产品 handler 和返回，但已在显式 shadow/standard 增加逐调用签名授权、项目 scope、读写预算、删除拒绝与持久审计。Provider 内继续执行产品 HTTP/字段、marker 恢复、plan/apply、优先级补全、不确定写入恢复和 BA 根任务状态流转，Tech/Server/Robot 边缘恢复原详情、状态、依赖、action、receipt、缓存返回与异常语义。其他资源仍使用兼容路径。
职责与边界
负责
- 猪齿鱼 OAuth、Token 刷新与项目映射
- 猪齿鱼 API 路径和版本差异
- issue/status/fixVersion/transform 等字段转换
- 写操作 dry-run、乐观锁、幂等恢复和写后核验
不负责
- 不定义上层测试、BA、Robot 或 Server 流程
- 不替代猪齿鱼业务主状态
- 不让模型接触 OAuth 凭据
- 不将检索命中数当作整库数量
数据与接口
拥有的数据
- 本地任务缓存与同步元数据
输入
猪齿鱼 API；产品专属项目映射、状态映射与认证配置；DevOps Connector 标准请求
输出
标准 Work Item、Iteration、Comment、User 与 Relation；标准写入回执；当前兼容工作项快照
协议
OAuth2；HTTPS；当前兼容 MCP/SQLite/FTS5；flynor/devops-task-operation/v1alpha1；目标 flynor/devops-work-item/v1
依赖
devops-connector
运行与部署
集成平台组 · pilot · active；升级路径：集成平台组 → 运行平台组
embedded · limited；当前兼容实现仍分布在 integration-choerodon、Robot、Tech Codex 和 Server 装配点；迁移目标是所有产品字段、认证与 API 路径收敛到此 Adapter，不单独持有 Work Item 主状态。
当前沿用 zcy-mcp/.env、integration-choerodon 配置和项目连接配置；DevOpsConnection v1alpha1 只以 adapterConfigRef、平台统一 credentialRef 和逐项目读写范围声明装配意图。宿主先经既有配置加载器/Secret Store 解析并注入 Provider；Registry 不解析引用，产品配置与 Secret 正文不进入共享连接声明。
当前嵌入 Robot、Server、Tech Codex 及 Test Runtime 的 Intake/Writeback 兼容路径；第一阶段迁移后仍作为宿主内 Adapter，不新增独立服务
同步时间、缓存完整性、MCP 工具检查、Robot 缓存 Sync Run/freshness/last-good/原错误兼容、Robot bundled MCP signature/scope/budget/delete-deny/audit、Test Writeback Provider 评论/流转/幂等/错误契约，以及 Test Intake/Tech 当前工作列表/轻量工作项/流转候选/完整详情/中央建单/父任务状态的标准读写契约和受管 bridge 测试
同步日志、metadata 与写操作核验
集成包和 MCP 可独立回滚；写操作不可盲目重试