Repository navigation
Fix interaction CLI channel typing for Monitor notices - #8869
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
动机 / Motivation
维护者在准备主干改动、运行仓库规定的类型检查时遇到错误,即使没有修改 Monitor 逻辑也无法得到干净结果。基线在 Monitor 通知分支报告 object 不可下标;候选只补上已有字典类型,使同一条类型检查通过,并保持运行行为。同一环境下,基线的配置范围内 17 个文件出现 1 项错误,候选无错误;完整模块的可执行字节码与常量保持一致。本改动不调整 Monitor 的观察职责、User gate 的完成权限、调度优先级或 Turn 结算规则。
这是一次有独立价值的维护修复:不处理它,每次后续开发都会继承同一个静态检查错误。无需让使用者重新配置 Goal、补充信息或确认操作。
改动思路 / Approach
Python 对混合字典的推断会把列表、字符串和布尔值归到宽泛的 object;随后读取 available_actions 并切片时,mypy 无法保证它可下标。候选采用已有返回类型和 TypedDict 字段的 dict[str, Any],让局部变量的声明与现有契约一致。它没有新增转换、异常吞噬或忽略检查。
在已有 Python 投影适配器中补充类型,沿用现成的 CLI channel 契约,职责和决策所有者均保持原位。本 PR 的边界是一处字典注解;不新增运行状态、CLI 参数、用户操作或并行决策实现。Monitor 是否只观察、User gate 由谁完成、遇到阻塞如何恢复,仍由原来的显式状态和所有者决定。普通调用和 Monitor 分支都保留原来的代码;不必为了这一行把稳定的 Python 投影器迁移或拆成新模块。
具体改动 / Changes
完整 diff 为一个生产文件 +1/-1:只在 channel 赋值处增加注解,没有新状态、生成代码或配置豁免。判定依据是 CONTRIBUTING.md,固定版本 02cc338;其中 mypy 要求在本 head 上为 implemented。配置范围和命令保持一致,基线错误与候选通过可直接比较。
关键代码讲解
- _build_interaction_cli_channel 接收已有交互投影,构造 CLI 的操作与说明。修改点在 channel 声明;Monitor 分支仍按原顺序裁剪动作列表,没有替换条件或默认值。
- MONITOR_USER_GATE_NOTICE 明确观察不能完成或批准 User gate,并保留轮询、让出执行与独立后续工作的边界。该完整常量与生成命令在 base/head 相同。
- build_interaction_contract 仍经原投影器返回同一个 channel;注解不会制造运行时对象或改变外部消费者。
对主干的风险 / Risks
最有价值的反例是「类型检查修好了,却顺手改变了 Monitor 权限或列表顺序」。我以同一解释器编译完整 base/head 模块,仅排除文件名和源码行位置,保留 opcode、递归常量、名称、闭包和参数信息;两个可执行指纹相同。再通过真实 CLI 的 File/SQLite 隔离状态检查观察、非法完成拒绝及合法恢复,覆盖运行行为,而不只检查 helper 返回值。
PASS:相同配置的 mypy(基线 1 项错误,候选 17 个文件无错误);三个相关 Python suite 共 58 项通过;基线真实 Monitor CLI 的两个后端用例通过;标准 premerge、修改文件 Ruff 和 diff 检查通过。没有放宽断言、检查范围或预算。Monitor 的跨域义务文本、结构化选择条件、默认行为与结算权限均未修改。
未执行 Windows、PostgreSQL、运行宿主升级或模型任务;该注解不改变这些路径的执行字节码。CI 未查询、未轮询。这些未测环境不被宣称为本次交付;它们也没有新增执行分支需要本注解修复。没有已验证的当前回归或阻塞 finding。
我的整体评价 / Verdict
APPROVE,适用于精确 head 8a5e66f。交付判断为 goal_achieved:恢复仓库要求的类型检查,范围与故障相称。long_horizon=preserved,user_experience=preserved:动作、诊断、权限和恢复步骤保持一致;静态验证改善不被解释为模型效果或长程效率收益。observable_semantics=equivalent,沿用已有类型和词汇,无迁移或额外用户轮次。
已检查 interaction_contract.py 的调用链;这处注解不改变任何渲染内容或用户界面。无可视界面变更;未将类型检查成功解释为产品 UI 验收。当前结论与后续平台 closeout、merge-readiness 和维护者合并授权分开;本审查不执行合并。
English verdict: APPROVE — the existing dictionary type fixes the reproducible mypy error with verified executable parity and real CLI coverage.
Monitor 与开放 User gate 同时存在时,CLI 契约会在下一步动作列表中插入提示。这个异构字典被 Mypy 推断为
dict[str, object],使动作列表切片在当前主干和 C1 的kernel-contracts检查中失败。给现有通道标注其返回契约使用的dict[str, Any],保留现有列表顺序与运行行为。The interaction CLI channel contains action lists, booleans and policy strings. Declare its existing heterogeneous mapping type so Mypy accepts the Monitor notice splice. This preserves the current runtime projection and reuses the surrounding channel representation.
Validation on the same main baseline and candidate:
python -m mypy: baseline reproduces the indexing error, candidate passes all 17 configured source files.git diff --checkpass.The bounded typing cleanup stays at the existing Python projection boundary. C1 #8266 can adopt this independent main-targeted fix and rerun its exact-head checks. Native Windows output-budget qualification remains open.