Automation 代码地图
- Asset
- ADP-AUT-DOC-DOC-0010
- Feature
- automation
- 领域
- automation
- 文档状态
- approved
- 文档 Owner
- DOC
- 事实源
- canonical-docs
- 更新
- 2026/10/14
WEN-53 Backlog 实施来源
必要的单并发交接修正见 !64，
完整 source tree 固定于
f07d933855efe2cabd1542f157419f394fc2d221。
backlog/delivery.py::includes_commit 读取 native commit parents，证明实际活动 release
包含旧／修正 MR；deployment/handoff.py::resume/restore_owned_issues 与
backlog/observe.py::main/collect 在单并发下先放行自然 Backlog，观察结束后恢复维护任务。
该最终修正还落实最新全访问授权，删除原来的文件拒绝表、启动沙箱和只读会话，不保留双模式。
这些源码定位不声明已安装或全部场景已验证。
下表原始实现 locators 固定于历史受审源 head
27c2980ea3ee6b29d889ea2f89588b3ab8677c90，
MR 为 !60。这是源码定位，
不是合并、安装或全部场景已运行的声明；精确 CI、merge 和运行证据归 WEN-53 workpad。
| 路径／symbol | 归属 |
|---|---|
symphony/backlog.patch、backlog/runner.ex 的 Backlog.states/eligible?/run | 官方候选、并发、同 Issue lease、独立 session 和 snapshot/presenter |
backlog/config.py 的 switch/gate | 缺省 true、严格开关、可信实际 Workflow 和同文件用户关闭来源 |
backlog/native.py 的 BacklogLinear.bound | 固定原生身份与状态、完整反馈/history/依赖及稳定读取 |
backlog/evidence.py 的 context/references、delivery.py 的 host_receipts | 原生内容和相关交付版本、注册范围、固定来源、实际宿主升级回执 |
backlog/actions.py 的 BacklogWriter/audit/finish/reconcile、store.py | 发送前复查、单条可追溯记录、状态 mutation、prepared/sending 和未知结果恢复 |
backlog/broker.py 的 operate | 绑定 Issue/session/version 的唯一受控工具，有限失败与等待去重 |
runtime/controlled_launch.py、runtime/guard.py、execution/selection.ex | 独立会话、danger-full-access / never、无额外启动沙箱及统一 lease |
install.sh、deploy_adp.py、deployment/handoff.py | 模板与当前值保留、外部 CI 正常交接、安装和恢复自有执行暂停 |
backlog/observe.py | owning master CI 只读自然原生结果及后续 poll；不是测试会话或第二调度器 |
下方 !55/!56 表保留其固定历史 revision；WEN-53 的当前受控 launcher 已替换旧
runtime/review_launch.py，不保留兼容入口。测试未新增或扩写，本地验证禁止执行。
| Owner | 负责范围 |
|---|---|
| Plane | Issue 原生状态、业务按钮、委托、执行身份、证据、审计和一次性数据迁移 |
| Symphony 接入仓 | 官方固定版本、Plane Tracker、业务工具、WORKFLOW 与服务部署配置 |
| Project Workspace | 项目身份、仓库及分支路由、执行服务绑定 |
| canonical docs | 产品合同、切换边界、固定来源资产索引 |
具体源码以本仓来源锁和 owning MR 的精确 commit 为准；来源锁未更新前不能把旧 Run 实现资产当作新机制证据。退役资产保留 ID 和墓碑，不能复用 ID 表示新 Symphony 合同。
旧 Coordinator、Worker Profile、Run callback 与 runtime API 不再有活动实现归属。历史 MR 和发布记录仍可追溯，但不能作为操作指南。
当前接入合同
执行服务统一使用 execution-context 和 execution-actions；旧 task-context/bug-context 保留人类 UI 职责。普通 Issue 与 Task 使用开始/提交验收动作，Bug 使用开始修复/提交回归；available_actions 限制实际执行权限。history-archive 只读提供旧 Epic 产物、审批与反馈。
完整字段见接入协议，原生角色见数据合同。源码固定来源尚未在锁中更新时，不以旧资产定位证明当前实现已完成。
Slack 人工审核
Plane 的 project-scoped bridge 和原生阶段决定固定来源为
MR !1015 的 reviewed head
6e6b2cfca3bf640b2e534bb7126c0b353bcac56f，合入 commit
4a1914f76c56ae6ba915690bbad08c35a709502a。最终生产稳态由
MR !1019 的 reviewed head
610b44003e949684bd94913e32ab592184a7b080 完成，合入 commit
1e01e7413cb8128f718b256e399edbbf372bfba1，随 autodev-v1.0.287 发布并删除一次性 rollout gate。主要 locator：
| 路径 | 归属 |
|---|---|
apps/api/plane/automation/api/human_review.py、apps/api/plane/app/urls/project.py | project-scoped token/decision 两个 endpoint |
apps/api/plane/automation/services/human_review.py | envelope、stage/action 映射、十分钟签名 token、CAS、幂等与结果 receipt |
apps/api/plane/automation/services/human_review_auth.py | 专用 bridge credential 认证 |
apps/api/plane/automation/models/automation.py、apps/api/plane/automation/migrations/0100_human_review_bridge.py | bridge、credential、identity 与 append-only decision receipt |
apps/api/plane/automation/management/commands/provision_human_review_bridge.py | 幂等注册、identity mapping 与 credential rotation |
deployments/kubernetes/autodev-plane/templates/human-review-bridge.yaml | 生产 provisioning Job；一次性 minimumReleaseVersion gate 已从最终稳态删除 |
固定 revision 只定位源码；TEST、PROD exact identity、运行健康、bridge/actor/executor 映射和一次性 rollout gate 的删除仍由 owning release evidence 证明，不能仅从页面或 source commit 推断。
Symphony Slack 审核桥最终稳态固定来源为 autodev-trial
MR !53 的 reviewed head
ab4601842ea17ec248aa600dd380fec41db48e41，包含前序功能 cleanup MR !51，并合入 master/source
commit 12c966c1011e759a4af6369bebc5ab179a2c14c4。主要 locator 与 symbol：
| 路径 | 归属 |
|---|---|
symphony/review/review_bridge.py | parse_manifest、snapshot_delivery、message、execute；稳态物化、卡片与动作编排 |
symphony/review/review_actions.py | accept_delivery、reject_delivery、Plane/Linear recovery；原生决定、actor/executor 审计与不明确结果收敛 |
symphony/review/gitlab_review.py | test_report_receipt、mr_snapshot、merge；test report provider truth、required exact-head CI、Draft ready、单 MR guarded merge 与幂等 readback |
symphony/review/review_registry.py、symphony/review/review-policy.json | 五个 profile 的 live registry/policy 交集、repo/required job/acceptance gate 与 active delivery kinds |
symphony/review/review_store.py | delivery/action/UI token、revision authorization 与 prepared-action recovery ledger |
symphony/review/slack_socket.py、symphony/review/review_config.py、symphony/review/slack-app-manifest.yaml | Socket Mode、严格 route binding 与最小权限 manifest |
symphony/profiles/{trial,adp,project2-linear,gameplay-linear}/WORKFLOW.md | 四个启用 profile 的原生 tracker、合并授权、交付和返工合同 |
symphony/profiles/project2-linear/WORKFLOW.md、symphony/periodic/project2-template.md | pure periodic test_report 的 native workpad、attempt 与 provider artifact 合同 |
symphony/notifications/install.sh | owning master CI 安装、activation/运行观察和钉钉信息事件切换；不保留 WEN 专用 gate |
该 reviewed head 的 exact-head pipeline 177119 已成功，required jobs 为 source 456012、symphony-build
456013、gameplay-binding 456014。合入后的 owning master pipeline 177120 绑定上述 source/merge SHA，
对应 jobs 456015、456016、456017 均成功；notifications deploy job 456020 进一步返回 healthy=true、
DingTalk direct 与 Slack activation 均 sent、Socket connected/authenticated，以及四个启用 profile
observing/healthy。Game Prototype profile 为 disabled，不能报告为已启动。
同一部署只读观察到 WEN-26 卡片已发送至 channel D0C9P89QT8Q、timestamp
1791904271.428149，actions=[]，因此该证据不代表执行了业务决定。WEN-24 的旧迁移卡未被本次部署
自动刷新；后续 source 已用 delivery_no_longer_reviewable 拒绝不再处于审核状态的 delivery，不能把
旧卡外观当作仍可执行。凭据、消息正文与私有运行数据库仍留在 repo 外。
自动审核来源与交付边界
Project Workspace 的条件式授权合同固定来源为
workspace MR !324 的 reviewed head
117b80445c7502a73e58f7260e886fd56989fe12，合入 commit
7ec89a010292a5b790625e03cff2c516206966a6。入口为 AGENTS.md、.autodev/automation.yaml 和
decisions/autodev-linear-symphony-development.md：默认关闭、host Workflow 为开关 authority，
只有明确启用才对 In Review 启动独立审核，关闭时保留人审合同。
该固定 revision 不改变现有资产 manifest，未重新锁定无关资产或生成 readiness。
审核实现源码与其精确 native CI 由注册 autodev-trial owning MR 交付；Project Workspace
source merge 不证明功能已部署、profile 已启用或真实自动审核闭环已通过。
自动审核完整实现由 Symphony MR !55
以 reviewed head 6f1209ca03dfdf119a9455806fe24ed9ee217e87 交付；
最终固定来源为 授权解释器保护 MR !56
的独立 reviewed head
bcc0e2ba14638ea93976d068e6071d2e48f93317，
其基准 b80f0a50b75b04b7beceda8bc01da38832ffc43e 已包含 !55 完整实现。
下表 locator 均对应此 revision；native CI、主干合入、安装与真实任务运行仍分别由 owning provider
提供证据，不在本页推断启用或全 profile rollout 已完成。
| 路径／symbol | 自动审核归属 |
|---|---|
symphony/automatic-review.patch | 官方候选状态、dispatch、worker 与 runtime snapshot 接入；不新增独立 scheduler |
symphony/automatic_review/runner.ex 的 AutomaticReview.states、eligible?、run、execute、request | 读取 host Workflow、官方占用内申请独立 Codex session、动态工具与 host broker 调用 |
symphony/review/automatic_review.py 的 gate、context、operate、ci_on_target | 版本／事实核对、证据缺项、受控决定／Draft ready／依赖合并、精确 target CI 与原生状态回执 |
symphony/review/automatic_store.py 的 locked、save、failed | host 私有持久记录、互斥、原子写入、有限失败与恢复 |
symphony/review/review_evidence.py 的 parse_manifest、snapshot_delivery | Slack 与自动审核共享受审交付解析，不复制两套 manifest／证据合同 |
symphony/review/review_registry.py 与 review-policy.json 的 automatic_review | live registry 范围、source 与 target jobs、必要独立决定及受审 target pipeline 请求范围 |
symphony/runtime/review_launch.py | 审核 session 独立模型认证、环境／工具和 OS 启动边界；不向审核者提供业务凭据 |
symphony/runtime/guard.py | 官方 Issue lease／进程监督及执行者对 host service、review ledger、控制授权文件及全部已注册 profile 的 review-venv 的直接写保护 |
symphony/profiles/*/WORKFLOW.md、symphony/build.sh、start.sh、install.sh | 默认关闭 source 配置、官方 source 安装与可信 $runtime/WORKFLOW.md live 配置；升级保留既有布尔开关 |