Skip to content

docs(rfc): keep controller interaction useful during execution - #7638

Merged
huangruiteng merged 1 commit into
mainfrom
codex/controller-interactive-product
Oct 29, 2026
Merged

huangruiteng merged 1 commit into
mainfrom
codex/controller-interactive-product

Conversation

@loopx-agent

Copy link
Copy Markdown
Collaborator

Goal And Delivered Outcome

现有 controller/executor 设计覆盖进度、Stop 和自然语言纠偏,但未明确要求 executor 执行时 controller 仍能与用户交流、主动汇报和呈现成果,并证明反馈进入后续工作。本 PR 将这条用户旅程补入 C6/C8,同步会话 RFC、管家 RFC 和整体路线图的中英文版本。

  • Before → after:仅有分散的能力条款 → 同一长程任务上的四项用户结果与六组决定性验收场景,区分收到、处理、实际采用和独立验收。
  • 范围:独立、可回退的设计修订,直接以 main 为目标;不依赖 C1: converge complete Turn input and host work identity #7430 的实现合并。

Author Declaration

  • Written by: model_agent — Codex (OpenAI GPT-6 family).
  • Specification and revision: controller-executor-unified-contract-v0.md §1/5/9/10/11 at 0a9a3a3884490e7af2c2f27c2f2136ae738460db,以及本 PR 中的产品目标增量。
Criterion Disposition Path / section Validation
执行期间可交流、反馈实际采用 implemented Controller RFC §5、§9、C6 逐条阅读双语 diff;明确忙碌、冲突反馈及后续产物证据
主动循证汇报和按任务丰富展现 implemented Controller RFC §5、§9、§10、C8 覆盖无变化安静、去重、文本降级、来源版本和受众拒绝
单一 authority、单 executor、原身份恢复 implemented Controller RFC 及配对 session/manager RFC 保留已有约束,补 Stop/重启/丢回复/迟到结果竞态
先单会话对照,再评估可选双会话完整成本 implemented Controller RFC §5/9;roadmap 原 C1 验收不变;新增交互不作独立 C1 切片的前置

Scope And Continuation

本次文档交付在范围内完整。运行时并发、主动投递、媒体呈现及反馈采用仍由现有 C6/C8 和 host/request/projection owner 交付并验证;现有原语或有界调用成功不证明旅程合格。未改变工作归属、默认 profile、发送权限、调度或运行时状态。

配对文档引用同一旅程,避免再建会话、投递或权限规则。回退仅需撤回文档提交;C1 数值无损、writer/caller 收敛、历史 reader 退出及原 quota 成果/完整成本资格保持开放。

Validation

  • Revision: 7aa7f67dbd0ea1542f5baa28472c43018e0b800f。premerge 与文档检查运行于相同的最终暂存内容;提交后再验证 exact-head 双语差分。
  • Run state: finished. Input classes: public_fixture.
Check kind Result Evidence / limitation
static passed python scripts/check_rfc_bilingual.py --base origin/main --staged 及提交后 --head HEAD,四组镜像成对变化
static passed python examples/docs-governance-smoke.py;RFC 状态索引检查通过,无需生成索引 diff
integration passed 标准 loopx canary premerge --from-git-diff --git-diff-base origin/main:4 direct checks、9 catalog canaries、8 risk smokes、1 public-boundary check 通过
manual passed 逐条核对新英文/中文义务及既有 C6/C8 不变量;8 文件公开边界扫描 clean
real_entrypoint not_applicable 仅设计文本变更;真实并发/产品旅程、安装采用与成本收益尚未资格验证

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

  • 无私有对话、身份、内部链接、本机路径、原始日志或凭据。
  • 未重复在办 benchmark 或 host 实现,沿现有 owner 和任务边界。
  • 四组 English/Chinese RFC 同步,staged/head 检查通过。
  • UI impact 为 none;没有运行时、采用或效果收益声明。
  • DCO Signed-off-by 完整;提交给维护者评审与合并。

Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

@huangruiteng
huangruiteng merged commit 1d651aa into main Oct 29, 2026
25 checks passed
@huangruiteng
huangruiteng deleted the codex/controller-interactive-product branch October 29, 2026 11:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants