Repository navigation
docs(rfc): keep controller interaction useful during execution - #7638
Conversation
Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent; gpt-6.1-sol; OpenAI; runtime_reported; reasoning_effort=max.
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
动机 / Motivation
长程任务的用户需要在执行尚未结束时了解依据、查看已保存产物,并纠正后续方向。旧设计列出进度与 steering 原语,却没有完整规定忙碌期间可交流和反馈实际采用;新文本把它们合成同一任务上的 C6/C8 产品旅程与验收场景。可审阅的结果是双语设计边界及验收标准更明确,运行时并发、主动投递和反馈采用仍需后续真实旅程证明。本 PR 不交付运行时、默认 profile、发送权限、UI 布局或 C1 成果与成本资格。
改动思路 / Approach
有用的最小结果是:同一任务仍在执行时,用户已经能看到有依据的说明和已保存产物,并确认纠偏进入后续工作。仅有独立聊天窗口、progress 或 steering 接口不足以证明这条旅程。提案复用既有 session/request、host 和 projection owner,由 controller 判断任务含义,Core 保持准入与结算 authority;不建第二套 manager 账本或 scheduler。四个用户结果集中在 controller RFC,配对文档摘要引用这个 owner,比多份独立规则更易维护。
具体改动 / Changes
完整审阅八文件(+198/-10),head 7aa7f67dbd0ea1542f5baa28472c43018e0b800f,base 0a9a3a3884490e7af2c2f27c2f2136ae738460db。先读修改前 docs/architecture/rfcs/controller-executor-unified-contract-v0.md,revision 0a9a3a3884490e7af2c2f27c2f2136ae738460db 的 §1/5/9/10/11,再判断本次新增设计义务;没有用修改后的规范证明其自身运行实现。
关键内容讲解
- Controller RFC §5 将忙碌时交流、主动报告、适合任务的丰富展现和反馈实际采用放在同一工作关系中。报告须有来源/版本,无变化安静且去重;不启动第二 executor 或第二次 Turn debit。反馈原文、有序 revision、待处理/拒绝/采用分别保留,原承诺不会被新消息静默取消。
- Controller RFC §9 增加六类决定性场景:忙碌、重复观察、冲突反馈、Stop竞态、断线/迟到结果和媒体/受众失败。它们要求后续工作与产物证明采用,并区分报告送达、Stop确认和实际终止;不是格式检查或 ACK 即可通过。
- C6 的完整来源、executor局部自主、Core隔离和独立验收均 implemented(设计条款);C8 的 packaged managed/attached旅程、不可用状态与installed单独资格也 implemented(设计条款)。session与manager镜像明确复用原owner、不授发送权限,roadmap明确这些不是当前runtime资格。
- 修改前 Outcome and cost benefit 仍 implemented(设计条款保留):原 quota 单会话对照先行,随后可选双会话组计入全部调用、缓存/非缓存输入、汇报/展现、补读、恢复、时延及人工注意力成本;新目标不成为独立 C1 切片的前置。
对主干的风险
最强反例是:文档检查通过,但 executor 忙时 controller 实际仍被串行阻塞,或者只收到反馈却没有改变后续工作。本提交明确保留这项实现资格,不能由已有原语、预览或一次调用成功推导通过。按条款顺序检查纠偏与 Stop 竞态、旧revision迟到及投递丢失:当前revision和权限决定验收,先恢复原队列/attempt/回执,只重试未解决的投递/效果;不重派、不额外扣额、不把旧结果覆盖为当前要求。错误受众拒绝,媒体不可用有可访问文本。
双语差分、文档治理、标准 premerge(4 direct、9 catalog、8 risk、1公开边界)均 PASS,0 manual hold。首次 strict build 因当前环境缺少 mkdocs 未启动;补用仓库 docs/requirements-docs.txt 后,同一head的完整 strict build PASS(7.09s),原失败保留。已有 INFO 级旧锚点提示未被声称修复。没有查询或等待CI。
语义与 CI 对齐
本次扩展既有 C6/C8 的设计语义,无新运行时 enum、配置默认、机器义务flag或权限owner。逐条核对两语言的 actor、revision、Stop/恢复、受众和成本范围一致;新设计不能被误作当前权限或runtime合格证明。
我的整体评价
没有当前阻塞finding,批准这个有界设计修订。长程路径保留原身份、单executor、权限、一次结算及C1先行边界;用户体验改善是验收目标更清楚,尚非已部署体验。没有渲染布局或组件变化,视觉检查不适用;真实managed/attached并发、投递、呈现质量、反馈采用、installed行为与完整成本仍由C6/C8后续验收,不能由文档或PR数结清。
English verdict: APPROVE at 7aa7f67: the bilingual C6/C8 design is coherent and validated; runtime interaction, adoption and complete-cost qualification remain explicitly open.
Goal And Delivered Outcome
现有 controller/executor 设计覆盖进度、Stop 和自然语言纠偏,但未明确要求 executor 执行时 controller 仍能与用户交流、主动汇报和呈现成果,并证明反馈进入后续工作。本 PR 将这条用户旅程补入 C6/C8,同步会话 RFC、管家 RFC 和整体路线图的中英文版本。
main为目标;不依赖 C1: converge complete Turn input and host work identity #7430 的实现合并。Author Declaration
controller-executor-unified-contract-v0.md§1/5/9/10/11 at0a9a3a3884490e7af2c2f27c2f2136ae738460db,以及本 PR 中的产品目标增量。Scope And Continuation
本次文档交付在范围内完整。运行时并发、主动投递、媒体呈现及反馈采用仍由现有 C6/C8 和 host/request/projection owner 交付并验证;现有原语或有界调用成功不证明旅程合格。未改变工作归属、默认 profile、发送权限、调度或运行时状态。
配对文档引用同一旅程,避免再建会话、投递或权限规则。回退仅需撤回文档提交;C1 数值无损、writer/caller 收敛、历史 reader 退出及原 quota 成果/完整成本资格保持开放。
Validation
7aa7f67dbd0ea1542f5baa28472c43018e0b800f。premerge 与文档检查运行于相同的最终暂存内容;提交后再验证 exact-head 双语差分。python scripts/check_rfc_bilingual.py --base origin/main --staged及提交后--head HEAD,四组镜像成对变化python examples/docs-governance-smoke.py;RFC 状态索引检查通过,无需生成索引 diffloopx canary premerge --from-git-diff --git-diff-base origin/main:4 direct checks、9 catalog canaries、8 risk smokes、1 public-boundary check 通过Frontend / Visual Evidence
UI impact: none. 未修改页面布局或产品组件;无运行时或视觉交付声明。
Type / Area
Documentation update;Public docs;Controller RFC C6/C8(S2/S4/S6/S7/S11)。Shared-authority fixture impact: N/A,未改 provider 或状态协议。
Boundary Checklist