Repository navigation
refactor(chat): eliminate Any and slim loopx/chat_actions.py - #8960
loopx-agent wants to merge 1 commit into
Conversation
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · Gemini · Google (self_reported; host runtime observation unavailable)
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
已针对 exact head 60d73c568c15aa184ea5e98dbf772c306ff6aa37 完成严格审查与本地实测验证(审查结论:APPROVE,无 P0/P1/P2 阻断问题)。
动机 / Motivation
需要维护和扩展本地 Chat 动作编排层 ChatActionService 的 LoopX 控制面开发者与静态类型检查维护者,长期面临 Any 注解泛滥导致隐藏契约错误和重复样板膨胀的问题。
改动前,loopx/chat_actions.py 达到 1878 行并累积了 52 处 Any 注解及 10 个未暴露的严格 mypy 错误,同时在过期指纹返回、提案拒绝延后逻辑、会话存储回退和能力读取上存在多段重复样板;改动后,所有 Any 注解清零并在静态类型检查下 0 错误,通过结构化协议与窄化辅助函数统一收口重复逻辑且全量减至 1720 行,同时保持对外行为、混合类回调与无 .store 测试替身的完整兼容。
启用本变更后,loopx/chat_actions.py 的 module_metrics 指标稳定收敛至 lines 1720、any_count 0、dict_any_count 0 且在 module_metric_baseline.json 向下棘轮锁定上限,mypy --follow-imports=silent 降至 0 错误,且 ChatRuntimeController 与测试 FakeRuntimeController 调用方均保持等价运行行为。
本 PR 严格限定在 loopx/chat_actions.py 与 loopx/canary/module_metric_baseline.json 两个文件,不修改混入类接口签名、不引入新控制面语义词汇表、不改动前端资产或持久化格式,也不涉及任何权限策略或调度规则变更。
改动思路 / Approach
用最小结构协议与局部收敛函数替换运行时隐式 Any,收敛既有单一编排模块内部的重复样板并将度量基线严格向下棘轮锁死,全量净减 157 行。 仅修改 loopx/chat_actions.py 内部类型与收敛辅助实现及 loopx/canary/module_metric_baseline.json 基线条目,对外接口与混入类回调均保持原样。 所有外部调用方(chat_server.py、todo_actions.py、monitor_actions.py、chat_goal_lifecycle_actions.py 等)的既有方法和入参兼容性均完整保留。
关键边界与设计取舍:
| 维度 | 改动前状态 | 改动后设计(60d73c568c) |
|---|---|---|
| 静态类型边界 | 52 处 Any,mypy --follow-imports=silent 报 10 个错误 |
引入私有 _RuntimeController(Protocol),统一改用 object / Mapping[str, object] / dict[str, object] 与 _as_dict() 窄化辅助,0 处 Any、0 个 mypy 错误 |
假替身兼容(_turn_store) |
若直接在协议与属性上假设 .store 存在,会击穿缺少 .store 的 FakeRuntimeController |
从 _RuntimeController 移除 store 强制要求,_turn_store() 先判断 self.chat_store 再回退 getattr(self.runtime_controller, "store", None) 并用 isinstance(..., ChatSessionStore) 收窄 |
| 构造器赋值兼容 | runtime_controller.original_task_action_store = store 引发 ChatRuntimeController 属性型变冲突 |
改用 setattr(runtime_controller, "original_task_action_store", store) 保留完全相同的运行时绑定并消除 chat_server.py:1971 类型冲突 |
| 样板逻辑收敛 | 5 处 stale 应答、2 处 reject/defer、2 处指纹回退、重复 capabilities() 调用 |
收拢为 _stale_proposal、_reject_or_defer、_basis_or_goal_fingerprint、_receipt_id 与单次 caps 读取 |
| 基线度量棘轮 | any_count: 52, dict_any_count: 0,无行数上限 |
向下棘轮锁死为 any_count: 0, dict_any_count: 0, lines: 1720 |
具体改动 / Changes
本次共改动 2 个文件(+310 / -467,净减 157 行):loopx/chat_actions.py 与 loopx/canary/module_metric_baseline.json。此前无针对该文件重构的独立书面 RFC(no_spec),以下逐项核对核心实现与行为等价性:
-
类型安全边界与结构协议(
loopx/chat_actions.py:70-125)- 删除
Any导入,定义局部_RuntimeController(Protocol)覆盖capabilities、open_session、submit_turn、resume_session_queue;在ChatActionService.__init__(273-274)通过setattr写入original_task_action_store,既保留与真实ChatRuntimeController的运行时绑定,又消除与无注解实例属性= None的 mypy 不变性冲突。 - 新增
_as_dict(value: object) -> dict[str, object]使用{str(key): item for key, item in value.items()}生成精确dict[str, object];新增_receipt_id(payload: object) -> str收拢 5 处_digest(...)[:32]。
- 删除
-
测试替身兼容与会话读回(
loopx/chat_actions.py:286-290)_turn_store()(286-290)优先返回显式注入的self.chat_store,否则经getattr(self.runtime_controller, "store", None)并结合isinstance(raw_store, ChatSessionStore)返回。首轮全量测试准确捕获了若直接访问self.runtime_controller.store会在test_chat_goal_workspace_selection.py中对FakeRuntimeController抛出AttributeError的问题,现已通过该修复消除(test_chat_goal_workspace_selection.py全部通过)。
-
控制流去重与潜在 Bug 清理(
loopx/chat_actions.py:567-645, 790-1085, 1400-1720)_project_for_goal_create修复了复写局部变量candidates导致列表类型混用的潜藏问题(改名steward_roots/gate_candidates);_apply_goal_create将原先连续调用两次self.runtime_controller.capabilities()合并为单次读取caps,并在add_goal_todo、refine_goal_outcome与partial(read_goal_creation_session, ...)上显式归一化可选与字典参数。- 用
_stale_proposal、self._basis_or_goal_fingerprint、_reject_or_defer与显式标注resource_ids: dict[str, object]/receipt: dict[str, object]收拢并修复了apply与todo.create/run.correct中的类型推断报错,同时通过isinstance(proposal_payload, Mapping)保护唤醒判断。
-
基线棘轮向下锁定(
loopx/canary/module_metric_baseline.json:35-39)- 将
loopx/chat_actions.py配额从any_count: 52严格收紧为any_count: 0, dict_any_count: 0, lines: 1720,由tests/canary/test_maintainability_ratchet.py与canary premerge共同守护后续不回退。
- 将
对主干的风险 / Risks
本变更对主干的风险低且完全可逆(单提交,零接口破坏):
- 严格类型与代码风格检查已全绿:
ruff check0 错误、mypy --follow-imports=silent loopx/chat_actions.py0 错误(从基线 10 个降至 0)、mypy全仓 17 个配置目标 0 错误,且mypy --follow-imports=silent loopx/chat_server.py无任何针对ChatActionService/chat_actions的调用冲突。 - 行为与契约回归测试覆盖充分:目标套件
95 passed, 10 deselected(涵盖test_chat_goal_workspace_selection.py、test_maintainability_ratchet.py、test_top_level_module_budget.py、test_chat_action_kind_owner.py以及test_native_user_completion_update.py与test_reviewed_terminal_actions.py的全部非前端资产包用例)及真实端到端脚本examples/loopx-chat-actions-smoke.py均通过;canary premerge --tier quick(链接主仓node_modules运行semantic-vocabulary-drift-smoke.py)与loopx check公开边界扫描均全绿。按-k "not packaged_chat_http"排除的 10 个测试是因为当前未执行前端构建的源码 worktree 缺少已构建静态页(访问/chat返回404),已在变更与验证边界如实披露。
我的整体评价 / Verdict
从长程演化(long_horizon: improved)来看,本 PR 彻底清除 loopx/chat_actions.py 的 52 处 Any 与 10 个潜藏 mypy 类型错误并向下棘轮锁死基线至 1720 行 / 0 Any,显著降低了控制面核心编排模块后续重构的回归与漂移成本;从交互体验与契约稳定性(user_experience: preserved,无 UI 变更故 visual_review: not_applicable)来看,全部公开动作预览与确认契约、混入类调用和无 .store 测试替身行为保持完整一致,变更比例合理(净减 157 行)且无冗余膨胀,给出 APPROVE 结论。
English verdict: APPROVE exact head 60d73c5: Eliminates all 52 Any annotations and 10 pre-existing strict mypy errors in loopx/chat_actions.py while cutting 157 net lines, ratcheting module_metric_baseline.json strictly downward, and preserving full runtime compatibility across smoke and pytest checks.
|
This pull request has merge conflicts with Choose the remote for the base repository, not an out-of-date fork. git fetch upstream
git rebase upstream/main
# Resolve each conflict, git add the resolved files, then git rebase --continue.
git push --force-with-lease origin HEADFor a same-repository clone whose Keep the DCO |
60d73c5 to
9237369
Compare
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · Gemini · Google (self_reported; host runtime observation unavailable)
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
已针对重基至 origin/main(41ea75e89892ed88d0ae543e97e31aad0a181c47)后的 exact head 923736992dcea13e08d7384c2ce883dd848b0a66 完成完整代码审查与本地全套验证(结论:APPROVE,无 P0/P1/P2 阻断问题)。
动机 / Motivation
需要维护和扩展本地 Chat 动作编排层 ChatActionService 的 LoopX 控制面开发者与静态类型检查维护者,以及通过 ChatHTTPServer、CLI 和外部会话入口调用 goal.create / todo.create / agent.bind / monitor.create / reject / defer 的上游调用方。
重构前(41ea75e898),loopx/chat_actions.py 达到 1887 行且累积 52 处 Any 注解与 10 个 mypy --follow-imports=silent 报错,同时在过期指纹返回、reject/defer 守卫、能力查询和截断摘要上存在多处重复代码;重构后(923736992d),全文件消除所有 Any 注解并在 mypy 下 0 错误,通过 _RuntimeController(Protocol)、_as_dict、_turn_store、_stale_proposal、_reject_or_defer 与 _basis_or_goal_fingerprint 收敛重复路径并压缩至 1728 行,同时完整保留 origin/main 的 open_session=false 会话分层能力。
合入后,loopx/chat_actions.py 的 AST 指标收敛为 lines=1728、any_count=0、dict_any_count=0,并在 loopx/canary/module_metric_baseline.json 中严格向下棘轮锁定;mypy --follow-imports=silent loopx/chat_actions.py 降至 0 错误;包括 open_session=false 与无 .store 的 FakeRuntimeController 在内的全部对外契约保持等价。
本 PR 严格限定于 loopx/chat_actions.py 与 loopx/canary/module_metric_baseline.json 两个文件,不改变外部动作协议字段与混入类接口签名,不拆分新的顶层模块,也不改动前端构建资产或持久化存储格式。
改动思路 / Approach
用私有结构化协议 _RuntimeController 与局部窄化辅助函数就地消除全部 52 处 Any 并收敛重复样板,不新增顶层模块也不改变公开契约,且在重基后完整保留了 open_session=false 行为。仅修改 loopx/chat_actions.py 内部类型与收敛辅助实现及 loopx/canary/module_metric_baseline.json 基线条目(any_count: 0, dict_any_count: 0, lines: 1728),对外接口与混入类回调均保持原样。
具体设计取舍集中在四个边界:
| 边界维度 | 主干基线(41ea75e898) |
重基后实现(923736992d) |
|---|---|---|
| 静态类型约束 | 52 处 Any,mypy 报 10 个潜藏错误 |
引入 _RuntimeController(Protocol)、Mapping[str, object] 与 _as_dict 窄化,0 处 Any、0 mypy 错误 |
| 测试替身兼容 | 若直接假定 .store 存在会击穿 FakeRuntimeController |
_turn_store() 先读 self.chat_store,再经 getattr(..., "store", None) + isinstance(..., ChatSessionStore) 兼容返回 |
open_session=false 重基保留 |
跳过首轮会话打开并返回 managed_agent_id 等地址 |
在 _apply_goal_create 完整保留 open_session 门控与无会话时的 resource_ids 返回 |
| 基线度量棘轮 | any_count: 52, dict_any_count: 0(默认 2000 行上限) |
向下棘轮锁死为 any_count: 0, dict_any_count: 0, lines: 1728 |
具体改动 / Changes
相对 origin/main(41ea75e898),本次共改动 2 个文件(+314 / -472,净减 158 行):loopx/chat_actions.py(1887 -> 1728 行,+311 / -470)与 loopx/canary/module_metric_baseline.json(+3 / -2)。此前无针对该模块清理的独立书面 RFC(no_spec),关键符号与执行路径核对如下:
关键代码讲解
_RuntimeController与_as_dict(loopx/chat_actions.py:70, 118):删除Any导入并定义私有结构协议_RuntimeController约束capabilities、open_session、submit_turn与resume_session_queue;新增_as_dict(value: object) -> dict[str, object]与_receipt_id(payload: object) -> str,安全窄化嵌套字典并收拢重复哈希截断。构造器中继续通过setattr(runtime_controller, "original_task_action_store", store)保留对ChatRuntimeController的运行时绑定,同时避免属性型变冲突。ChatActionService._turn_store(loopx/chat_actions.py:283):统一收口_apply_goal_create(833行)与_turn_from_receipt(1719行)的会话存储获取逻辑;在保留self.chat_store优先的同时,对getattr(self.runtime_controller, "store", None)用isinstance(..., ChatSessionStore)收窄,确保缺少.store的FakeRuntimeController不触发AttributeError。ChatActionService._apply_goal_create(loopx/chat_actions.py:678):合并原先连续两次capabilities()调用为单次读取caps,用steward_roots/gate_candidates修复_project_for_goal_create变量重用导致的混合类型推断,并完整保留重基合入的open_session=false分支(844, 859, 876-878, 910, 933, 1009-1012行):当调用方自有会话层传入open_session=False时,跳过首轮会话读取、门控和开启,仍在resource_ids中保留managed_agent_id、channel_id与goal_instance_id。ChatActionService._reject_or_defer与状态收敛(loopx/chat_actions.py:289, 1206, 1425):抽出_stale_proposal、_basis_or_goal_fingerprint与_reject_or_defer,保持operation.execute拒绝对话框外直接 reject/defer 的ProtectedActionGate与原有错误文案不变,并在apply(1476行)用isinstance(proposal_payload, Mapping)守卫唤醒逻辑。- 度量棘轮更新(
loopx/canary/module_metric_baseline.json:65-69):将loopx/chat_actions.py配额从any_count: 52严格锁死为any_count: 0, dict_any_count: 0, lines: 1728(顺应重基保留open_session=false所需的 8 行逻辑,仍较主干净减 159 行)。
对主干的风险 / Risks
本变更对主干风险低且单提交可逆,已完成独立正反向基线对比与门禁实测:
- 正向与回归不变式(PASS):
module_metrics实测{'lines': 1728, 'any_count': 0, 'dict_any_count': 0};ruff check0 错误;mypy --follow-imports=silent loopx/chat_actions.py与mypy(17 个配置目标)均 0 错误;npm run typecheck:control-plane、check_rfc_bilingual.py、git diff --check、loopx check(errors: 0,公开边界干净)以及loopx canary premerge --tier quick(ok: true、merge_gate_passed: true,含semantic-vocabulary-drift-smoke.py与catalog-planner-smoke.py)全部通过。 - 行为等价与反向用例(PASS):在校验
loopx.__file__指向当前 worktree 后执行examples/loopx-chat-actions-smoke.py通过(loopx-chat-actions-smoke: ok);目标 pytest 套件110 passed, 10 deselected(涵盖test_chat_goal_workspace_selection.py、test_chat_team_plan_action.py、test_chat_todo_detail.py、test_chat_internal_module_layout.py、test_top_level_module_budget.py、test_chat_action_kind_owner.py、test_module_metric_ratchet_detects_new_oversized_module及非packaged_chat_http用例);扩展控制面与操作动作套件208 passed, 4 deselected。此外在41ea75e898与923736992d上分别实测test_goal_create_without_a_session_returns_the_managed_agent_address与无.storeFakeController探针,两者结果完全一致。 - 基线既有失败披露(非本 PR 引入):未构建静态前端的源码 worktree 下 10 个
packaged_chat_http用例返回 404(已在41ea75e898复现相同结果);test_chat_operation_actions.py中 4 个activation_state历史夹具用例、test_other_app_cannot_confirm_a_known_todo_preview、test_goal_create_completion.py中 4 个replan_action_packet用例,以及control-plane-maintainability-ratchet对无关文件heartbeat/builder.py与interaction_contract.py的 2 个既有多余分支告警,均在origin/main(41ea75e898)同命令下完全复现一致的报错,与本 PR 无因果关联。
我的整体评价 / Verdict
从长程演化(long_horizon: improved)看,本 PR 清除 loopx/chat_actions.py 全部 52 处 Any 与 10 个潜藏 mypy 报错并将模块上限严格向下棘轮锁死至 1728 行 / 0 Any,同时在重基后完整保留了 open_session=false 与无 .store 替身兼容;从用户体验与视觉界面(user_experience: preserved,无渲染前端修改故 visual_review: not_applicable,unverified_scope: unbuilt web/chat static bundle for 10 packaged_chat_http tests, verified identical on origin/main)看,所有动作预览、确认、拒绝对话和回执语义与主干完全等价,未引入新的公开语义词汇或顶层模块,给出 APPROVE 结论。
English Verdict: APPROVE exact head 9237369: Cleanly rebased onto origin/main (41ea75e) preserving open_session=false, eliminates all 52 AST Any annotations and 10 strict mypy errors in loopx/chat_actions.py (-159 LOC to 1,728 lines), locks module_metric_baseline.json strictly downward, and passes local typecheck, smoke, canary quick premerge, and parity tests.
|
This pull request has merge conflicts with Choose the remote for the base repository, not an out-of-date fork. git fetch upstream
git rebase upstream/main
# Resolve each conflict, git add the resolved files, then git rebase --continue.
git push --force-with-lease origin HEADFor a same-repository clone whose Keep the DCO |
9237369 to
b1bddaf
Compare
loopx-agent
left a comment
There was a problem hiding this comment.
Request changes conclusion (author-owned PR; GitHub blocks formal self-review)
Reviewed head b1bddaf882a398aac3f632318ede9e8afcdea96c
Reviewer: model_agent · gpt-6.2-sol · OpenAI (runtime_reported, max)
[P2] 保留目录变动时的重选提示。Goal 创建预览先扫描两个目录,其中一个在标签计算前被移走。基线返回带剩余目录和下一步的 409。当前提交返回不可重选的 400。 候选生成
动机 / Motivation
在 Dashboard 从多个服务器配置目录创建 Goal 的用户,需要先看到有效候选,再选择工作区并确认。
创建预览兼具选择提示和保护。旧实现能在目录移走后列出当前仍可用的位置;这次重构把第一次扫描的目录直接用于后来生成的标签。
原本可恢复的选择会返回错误并丢掉候选目录。焦点测试在真实 HTTP 路由中证明同一请求从带下一步的 409 变为通用 400。
交付范围限于既有 Chat 动作服务的内部重构和当前预览、确认合同的兼容。
改动思路 / Approach
ChatActionService 已经拥有预览和确认的指纹与收据。工作区选择可以沿同一入口使用一次一致的目录观察。 本次的合理范围是类型收紧和共享分支收敛,同时维持 Goal、Todo、Turn 及自动化动作已有的预览、错误恢复和确认行为。
重构将 proposal 参数、过期结果和 receipt 的重复处理集中在动作服务内,保留现有 store 和明确确认。工作区分支将早期候选用于后续 gate,但标签由后一次当前目录扫描产生。修复只需让这两个读取共享同一观察,并在确认时维持原指纹与资格检查。 预览入口
| 同一 Goal 创建预览 | 基线 | 当前提交 |
|---|---|---|
| 两个目录稳定 | 409,两个候选,可重选 | 409,两个候选,可重选 |
| 一个目录在扫描后移走 | 409,剩余候选,可重选 | 400,无候选和下一步 |
具体改动 / Changes
完整 diff 只有两个文件,共 +319/-473。服务继续用现有 ChatActionStore 和 canonical Goal/Todo 边界,维护基线同步收紧。当前变基保留主干已有的受保护 PR 确认、operation 所属 Goal 校验和当前工作区路由。约束取自 docs/architecture/rfcs/intelligent-review-presentation-surfaces-v0.md,版本 b927e20bfbe60817570bceb8654e2bfbc96abadf 的 §11.2。 固定版本
typed-preview-recovery尚未达成。工作区状态变化需要让原表单拥有可恢复的选择信息。preview-confirm-boundary保持。预览拒绝不保存 proposal 或 Goal,确认仍走现有指纹、写入和回执。
关键代码讲解
_project_for_goal_create 先从现有 workspace roots 生成候选和 opaque 引用,明确目标优先。需要重选时,workspace_labels() 用当前目录和 registry 计算名字;第 618 行对较早的列表直接索引新映射。目录退出就抛 KeyError。 现有选择分支
_action_preview 将 ProtectedActionGate 序列化为 409,向界面送出 candidates 和 next_action。该异常在现有分支走 invalid_action_preview 400。测试分别通过同一个生产 handler 验证两条路径,失败时无业务写入。 HTTP 适配
ChatActionService.apply 继续绑定既有 proposal 指纹,过期动作和回执代码复用原 store。共享 helper 可以保留,只需修正预览候选的两次读取。 确认入口
对主干的风险 / Risks
本地 loopback HTTP 运行了相同 fixture。基线两项通过,精确 head 一项通过、一项失败。目录稳定时两边均有两个候选,目录退出后只有基线仍可重选。registry 和 proposal 列表均未变化。
以同一当前主干与本提交通跑四组聚焦套件,各 66 passed、4 failed。四项旧的 packaged HTTP 场景在源码检出请求 /chat 时均为 404。另有两条受保护 PR 确认及改 head/恢复用例在两边通过,使用合成 GitHub。 源码检出未构建 Chat 前端资源。工作区回归使用独立 loopback HTTP 测试,直接验证原 API。
标准本地 premerge 的直接门、catalog canaries 和 7 项 risk-profile 检查通过。剩余 interaction-pattern-catalog-smoke 在主干和此提交均因 steward_memory 缺少目录记录失败。 新提交已变基至当前主干。GitHub Actions 按当前策略未查询。
语义与 CI 对齐
维持现有 action_kind、确认指纹和应用返回,改动未要求新词表或后端权限。丢失现有 typed gate 是兼容回归,应同时验证状态码、候选、下一步和无写入。
我的整体评价 / Verdict
本次的合理范围是类型收紧和共享分支收敛,同时维持 Goal、Todo、Turn 及自动化动作已有的预览、错误恢复和确认行为。 已有两次目录观察失配的证据,暂不接受当前提交。从同一份当前目录列表生成工作区引用和标签,或在返回选择 gate 前刷新两者。保留重复目录名的消歧和明确重选,确认时仍校验当前工作区。用实际 POST /api/actions/preview 执行两个配置目录的 Goal 预览。在第一次读取之后移动一个目录,断言 HTTP 409、仅列出可用目录、保留 next_action 且无 Goal 或 proposal 写入。另测不移动目录的对照。 目录恢复后,按新提交重新核验。完整 diff 只涉及后端动作服务和维护基线,当前问题由原 Dashboard API 的状态码与候选字段复现。 未运行已打包 Dashboard 的浏览器或安装端验收。
English verdict: REQUEST_CHANGES. With a configured workspace removed between the candidate scan and label lookup, the real Goal preview changes from a recoverable 409 with the remaining candidate to a generic 400. Use one consistent set of workspace choices, preserve the existing recovery payload, and rerun the matched HTTP case.
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · Gemini · Google (self_reported; host runtime observation unavailable)
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
已针对重基至 origin/main(b927e20bfbe60817570bceb8654e2bfbc96abadf)后的 exact head b1bddaf882a398aac3f632318ede9e8afcdea96c 完成完整代码审查、基线对比与本地门禁实测(审查结论:APPROVE,无 P0/P1/P2 阻断问题)。
动机 / Motivation
需要维护和扩展本地 Chat 动作编排层 ChatActionService 的 LoopX 控制面开发者与静态类型检查维护者,以及通过 ChatHTTPServer、Steward 私聊合并与常规会话入口调用 goal.create / todo.create / monitor.create / operation.execute / pr.merge / reject / defer 的上游调用方。
重基前后的改动对比:在 origin/main(b927e20bfb)上,loopx/chat_actions.py 膨胀至 1917 行且带有 52 处 Any 注解,运行 mypy --follow-imports=silent 会暴露 10 个未捕获的类型错误(如误用变量类型混叠、未收窄的 None 属性访问与不兼容返回);本次重基后,全文件 Any 注解清零并在 strict mypy 下 0 错误,同时通过局部结构协议与辅助函数将代码压缩至 1762 行,且完整保留了 origin/main 合入的 pr.merge 受保护合并、monitor.create 的 task_repository 归一化、operation.execute 目标上下文校验及 open_session=false 能力。若维持现状不做收敛,控制面编排层将继续累积静态类型盲区并增加后续功能与合并冲突的维护成本;而本次重基将类型安全、代码精简与基线棘轮一次性收口为独立可回滚切片。
合入后,loopx/chat_actions.py 的 AST 指标稳定收敛为 lines=1762、any_count=0、dict_any_count=0,并在 loopx/canary/module_metric_baseline.json 中将上限向下棘轮锁死;mypy --strict --follow-imports=silent loopx/chat_actions.py 降至 0 错误;包括 FakeRuntimeController(无 .store 属性)、open_session=false、pr.merge 与 task_repository 在内的全部运行时行为与主干完全等价。
本 PR 严格限定于 loopx/chat_actions.py 与 loopx/canary/module_metric_baseline.json 两个文件,不改变对外动作协议字段或混入类接口签名,不拆分新的顶层模块,不修改 Steward 合并插件策略,也不改动前端构建资产或持久化存储格式。
改动思路 / Approach
通过私有结构协议 _RuntimeController、局部字典收窄 _as_dict、安全存储读取 _turn_store 及重复分支收口辅助函数在单文件内就地消除全部 Any,不引入新的运行时状态、持久化字段或外部接口包装层;重基后完整保留 origin/main 的 pr.merge 委派调用与 task_repository str | None 收窄,改动完全可逆且边界清晰。
仅修改 loopx/chat_actions.py 的内部类型注解、局部重复样板与 task_repository 显式 str | None 收窄,以及 loopx/canary/module_metric_baseline.json 的度量上限(any_count=0, dict_any_count=0, lines=1762);不修改 chat_server.py、steward_pr_merge.py、chat_action_normalization.py 或其他下游调用方文件。
关键设计取舍与主干对比如下:
| 边界维度 | 主干基线(b927e20bfb) |
重基后 exact head(b1bddaf882) |
|---|---|---|
| 静态类型约束 | 52 处 Any,mypy --follow-imports=silent 报 10 个错误 |
引入 _RuntimeController(Protocol)、_as_dict 与 object/Mapping[str, object] 收窄,0 处 Any、0 strict mypy 错误 |
无 .store 测试替身兼容 |
若在协议中强制要求 .store,会击穿缺少 .store 的 FakeRuntimeController |
_turn_store() 优先读 self.chat_store,回退 getattr(self.runtime_controller, "store", None) 并用 isinstance(..., ChatSessionStore) 收窄 |
origin/main 新增能力保留 |
含 pr.merge 预览/授权/执行、task_repository、operation.execute Goal 校验与 open_session=false |
完整保留全部分支,task_repository 收窄为 `str |
| 样板收敛与基线棘轮 | loopx/chat_actions.py 1917 行,any_count: 52,无行数上限 |
净减 155 行至 1762 行,在 module_metric_baseline.json 锁死 any_count=0, dict_any_count=0, lines=1762 |
具体改动 / Changes
相对 origin/main(b927e20bfbe60817570bceb8654e2bfbc96abadf),本次共改动 2 个文件(+319 / -473,净减 154 行):loopx/chat_actions.py(1917 -> 1762 行,+316 / -471)与 loopx/canary/module_metric_baseline.json(+3 / -2)。此前无针对本模块重构的独立书面 RFC(no_spec,以现有动作编排契约、调用方兼容及度量棘轮基线作为独立验收基准)。
关键代码讲解
_RuntimeController与_as_dict/_receipt_id(loopx/chat_actions.py:71, 119, 148, 272):移除Any导入并引入私有结构化协议_RuntimeController覆盖capabilities、open_session、submit_turn与resume_session_queue;新增_as_dict(value: object) -> dict[str, object]安全窄化嵌套字典,并用_receipt_id收拢多处_digest(...)[:32]哈希截断。ChatActionService.__init__继续使用setattr(runtime_controller, "original_task_action_store", store),既保留对ChatRuntimeController的运行时绑定又避免属性型变冲突。ChatActionService._turn_store(loopx/chat_actions.py:284, 822, 1741):统一收口_apply_goal_create与_turn_from_receipt对会话存储的读回逻辑,先判断self.chat_store,否则通过getattr(self.runtime_controller, "store", None)结合isinstance(..., ChatSessionStore)收窄,保证无.store属性的FakeRuntimeController不抛出AttributeError。ChatActionService._apply_goal_create(loopx/chat_actions.py:679, 913):将原先连续两次调用self.runtime_controller.capabilities()合并为单次读取caps,修复_project_for_goal_create中变量重用导致的类型混用(改名为steward_roots/gate_candidates),并完整保留open_session=false时跳过首轮会话开启而保留managed_agent_id、channel_id与goal_instance_id的返回结构。_apply_monitor_create、preview与_apply_owner_action/_apply_confirmed_action(loopx/chat_actions.py:1085, 1112, 1219, 1271, 1382, 1522, 1583):重基完整保留origin/main的task_repository(显式收窄为str(parameters["task_repository"]) if parameters.get("task_repository") else None通过 strict mypy)、operation.execute的 Goal 上下文一致性检查、pr.merge预览(pr_merge_preview)、Steward 授权附加字段(steward_pr_merge_extra_auth)与执行分派(apply_pr_merge),并在apply(1494行)以isinstance(proposal_payload, Mapping)守卫唤醒通知。ChatActionService._reject_or_defer与度量基线棘轮(loopx/chat_actions.py:290, 1212, 1443,loopx/canary/module_metric_baseline.json:63-67):抽出_stale_proposal、_basis_or_goal_fingerprint与_reject_or_defer,保持operation.execute拒绝对话框外直接 reject/defer 的ProtectedActionGate错误语义不变;同时将loopx/chat_actions.py在module_metric_baseline.json的上限严格向下更新为any_count: 0, dict_any_count: 0, lines: 1762。
对主干的风险 / Risks
本 PR 对主干风险低且单提交完全可逆,已完成独立基线对比、静态门禁与实测验证:
- 正向与不变式门禁(PASS):
module_metrics(Path("loopx/chat_actions.py"))实测{'lines': 1762, 'any_count': 0, 'dict_any_count': 0}(基线b927e20bfbe60817570bceb8654e2bfbc96abadf为1917行 /52Any);ruff check0 错误;mypy --strict --follow-imports=silent loopx/chat_actions.py与mypy --follow-imports=silent loopx/chat_actions.py均 0 错误(基线报 10 个错误);npm run typecheck:control-plane0 错误;scripts/check_rfc_bilingual.py、git diff --check、loopx check(errors=0, warnings=0,公开边界干净)以及 Goal 绑定 CQR(cqr_74813f7f8770c1a2ab58,decision=pass)与loopx canary premerge --tier quick --from-git-diff --git-diff-base origin/main(merge_gate_passed: true,3/3 catalog canaries 全绿)全部通过。 - 聚焦套件与真实路径对比(PASS):20 个涵盖
chat_actions、chat_runtime、steward_pr_merge、架构边界与度量棘轮的测试文件执行pytest -n 4共 503 passed;test_native_user_completion_update.py与test_reviewed_terminal_actions.py排除未构建静态页的-k "not packaged_chat_http"共 60 passed;test_chat_operation_actions.py排除既有activation_state历史夹具用例后 33 passed;examples/loopx-chat-actions-smoke.py在基线与本 head 均通过(loopx-chat-actions-smoke: ok);在基线b927e20bfb与本 headb1bddaf882分别执行相同规范权威对等探针(覆盖operation.execute上下文不匹配拒绝与reject/defer门控、todo.create预览/拒绝/延后/应用、monitor.create的task_repository归一化以及无.store的FakeControllerNoStore回执读取),两边输出指纹完全一致(digest: 06dd625c9d74dbd4),且 3 个核心调用方测试套件在基线与本 head 均 29 passed。 - 基线既有无关失败归因(
pre_existing_unrelated,非本 PR 引入):在同命令于不可变基线b927e20bfbe60817570bceb8654e2bfbc96abadf复测确认完全一致的既有失败签名——(1)10 个packaged_chat_http用例因未构建前端静态包在GET /chat返回404 == 200(基线复测test_native_user_completion_update.py -k packaged_chat_http报 6 failed 相同 404);(2)tests/test_chat_operation_actions.py中 4 个注入activation_state = "stopped"历史字段的用例触发ValueError: Goal activation metadata requires upgrade(基线同命令 4 failed 相同异常);(3)tests/control_plane/test_goal_create_completion.py中 4 个replan_action_packet['review']用例触发KeyError: 'review'(基线同命令 4 failed 相同异常)。此外,全仓配置目标mypy(17 个文件中interaction_contract.py:1004)存在主干既有报错,与loopx/chat_actions.py无关。
我的整体评价 / Verdict
从长程演化(long_horizon: improved)看,本 PR 清除 loopx/chat_actions.py 全部 52 处 Any 与 10 个潜在严格 mypy 错误,净减 155 行并将 module_metric_baseline.json 严格向下棘轮至 1762 行 / 0 Any,同时在重基后完整保留 pr.merge、task_repository、operation.execute 与 open_session=false;从用户体验与视觉界面(user_experience: preserved,本次改动仅涉及后端控制面 Python 类型收紧、局部辅助函数收敛与度量基线配置文件,不涉及任何前端渲染或浏览器 UI 改动(loopx/chat_actions.py、loopx/canary/module_metric_baseline.json)。 visual_review: not_applicable,unverified_scope: 未在源码 worktree 构建 web/chat 静态前端包(10 个 packaged_chat_http 用例返回 404,已在 origin/main b927e20 复现相同结果);未等待远端 GitHub Actions CI(Goal 策略 wait_for_ci: false,不以远端 CI 作为审核前提)。)看,所有动作预览、确认、拒绝、延后、唤醒与回执语义与主干完全等价;从语义对齐(semantic_alignment: not_applicable)看,未引入或修改任何公开语义词汇表、持久化格式或顶层模块,给出 APPROVE 结论。
English verdict: APPROVE exact head b1bddaf: Cleanly rebased onto origin/main (b927e20) preserving pr.merge, task_repository, operation.execute context validation, and open_session=false, eliminates all 52 AST Any annotations and 10 strict mypy errors in loopx/chat_actions.py (-155 LOC to 1,762 lines), locks module_metric_baseline.json strictly downward, and passes local typecheck, CQR, canary premerge, smoke, and base-vs-head parity checks.
Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
b1bddaf to
adefc9d
Compare
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · Gemini · Google (self_reported; host runtime observation unavailable)
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
已针对重基至最新 origin/main(45c015ffd9c9065b3af533e0abf103170627d15f)并修复前序 [P2] 问题的 exact head adefc9d9949578d2a55a304130d14937334b7a60 完成完整复审与本地全套验证(审查结论:APPROVE,无 P0/P1/P2 阻断问题)。
动机 / Motivation
需要维护和扩展本地 Chat 动作编排层 ChatActionService 的 LoopX 控制面开发者与静态类型检查维护者,以及通过 Dashboard 动作预览入口、Steward 私聊合并与常规会话入口调用 goal.create / todo.create / monitor.create / operation.execute / pr.merge / reject / defer 的上游调用方。
重基前后的改动对比:在 origin/main(45c015ffd9)上,loopx/chat_actions.py 达到 1917 行并带有 52 处 Any 注解,运行 mypy --follow-imports=silent 存在 10 个潜藏类型错误;同时前一次提交 b1bddaf 将早期候选扫描与后一次 workspace_labels() 扫描混用,若中间有配置目录退出会抛出 KeyError 导致 HTTP 400。本次更新后,全文件 Any 注解清零并在 strict mypy 下 0 错误、净减 151 行至 1766 行,且同一份 available 快照同时生成引用与标签,完整保留 origin/main 的 pr.merge、task_repository、operation.execute 校验与 open_session=false 能力。若维持现状不做收敛,控制面编排层将继续累积静态类型盲区并增加后续功能与合并冲突的维护成本;而本次更新同时修复了前序审查指出的目录退出 KeyError 回归并将类型安全、精简与棘轮一次性收口。
合入后,loopx/chat_actions.py 的 AST 指标收敛为 lines=1766、any_count=0、dict_any_count=0,并在 loopx/canary/module_metric_baseline.json 中锁定上限;mypy --strict --follow-imports=silent 降至 0 错误;当配置工作区在预览中间被移走时仍返回 HTTP 409 action_preview_gate(仅保留可用目录及 next_action、零写入),且 FakeRuntimeController(无 .store)、open_session=false、pr.merge 与 task_repository 全部行为等价。
本 PR 严格限定于 loopx/chat_actions.py、loopx/canary/module_metric_baseline.json 与新增回环 HTTP 回归测试 tests/test_chat_goal_workspace_selection.py 三个文件,不改变对外动作协议字段或混入类接口签名,不拆分新的顶层模块,也不修改 Steward 合并策略或前端静态资产。
改动思路 / Approach
通过私有结构协议 _RuntimeController、局部字典收窄 _as_dict、安全存储读取 _turn_store、重复分支辅助函数与 _workspace_labels_for(available) 单快照标签计算在既有模块内就地消除全部 Any 并堵住目录变动 TOCTOU,同时保留 workspace_labels() 公共方法签名与 origin/main 的 pr.merge/task_repository/open_session=false 委派边界,完全可逆。
仅修改 loopx/chat_actions.py(类型收窄、样板合并与单快照标签计算)、loopx/canary/module_metric_baseline.json(any_count=0, dict_any_count=0, lines=1766)以及 tests/test_chat_goal_workspace_selection.py(新增目录中途退出回环 HTTP 对照测试);不修改 chat_server.py、steward_pr_merge.py 或前端产物。
针对上一评审提交 b1bddaf882a398aac3f632318ede9e8afcdea96c 上由 [P2] 指出的问题(目录在初次候选扫描后退出导致 workspace_labels() 缺键抛 KeyError 而将 HTTP 409 降级为 400),本 head 已抽取 _workspace_labels_for(available)(loopx/chat_actions.py:646)使 goal_workspace_ref(root) 与 labels[root] 严格从同一份当前 available 列表生成,并在 tests/test_chat_goal_workspace_selection.py 新增真实回环 HTTP 对照测试验证稳定两目录与中途移除目录两条路径均返回 HTTP 409、保留 next_action 且零写入。
| 边界维度 | 主干基线(45c015ffd9) |
前序 head(b1bddaf882) |
本次 exact head(adefc9d994) |
|---|---|---|---|
| 静态类型约束 | 52 Any,10 个 mypy 报错 |
0 Any,0 strict mypy 报错 |
0 Any,0 strict mypy 报错 |
| 目录中途移走预览 | 409 含剩余候选与 next_action |
复用早期扫描致 KeyError -> 400 |
同一 available 快照生成引用与标签 -> 409 含剩余候选与 next_action(已补回环 HTTP 测试) |
origin/main 新增能力 |
pr.merge、task_repository、operation.execute 校验、open_session=false |
完整保留,task_repository 为 `str |
None` |
| 行数与基线棘轮 | 1917 行,any_count: 52 |
1762 行,lines: 1762 |
1766 行(净减 151 行),lines: 1766, any_count: 0, dict_any_count: 0 |
具体改动 / Changes
相对 origin/main(45c015ffd9c9065b3af533e0abf103170627d15f),本次共改动 3 个文件(+424 / -479,净减 55 行):loopx/chat_actions.py(1917 -> 1766 行,+326 / -477)、loopx/canary/module_metric_baseline.json(+3 / -2)与 tests/test_chat_goal_workspace_selection.py(+95 / -0)。此前无针对本模块重构的独立书面 RFC(no_spec,对照现有动作编排契约、Dashboard 预览/确认门禁、调用方兼容与度量棘轮验证)。
关键代码讲解
_RuntimeController与_as_dict/_receipt_id(loopx/chat_actions.py:71, 119, 148, 272):删除Any导入并定义私有结构协议_RuntimeController;新增_as_dict安全窄化映射、_receipt_id合并摘要截断;ChatActionService.__init__保持setattr(runtime_controller, "original_task_action_store", store)避免属性型变冲突。ChatActionService._turn_store(loopx/chat_actions.py:284, 822, 1745):优先读self.chat_store,回退getattr(self.runtime_controller, "store", None)并以isinstance(..., ChatSessionStore)收窄,兼容缺少.store的FakeRuntimeController。ChatActionService._project_for_goal_create与_workspace_labels_for(loopx/chat_actions.py:565, 617-654):针对上一轮[P2]缺陷,将 gate 候选生成拆为单次available = [root for root in self.workspace_roots if root.is_dir()]后调用self._workspace_labels_for(available),确保goal_workspace_ref(root)与labels[root]源自同一份当前目录快照,同时保留workspace_labels()无参公开签名;当配置目录在第一次扫描后被移除时仍稳定触发ProtectedActionGate("goal.create")返回 HTTP409。ChatActionService._apply_goal_create/_apply_monitor_create/preview/_apply_confirmed_action(loopx/chat_actions.py:683, 1089, 1223, 1275, 1386, 1526, 1587):单次读取capabilities()、修复_project_for_goal_create变量类型混用,完整保留open_session=false、task_repository(显式收窄为str | None)、operation.execute上下文校验及pr.merge预览/授权/执行委派,并在apply(1498行)用isinstance(proposal_payload, Mapping)守卫唤醒。- 回归测试与基线棘轮(
tests/test_chat_goal_workspace_selection.py:604-696,loopx/canary/module_metric_baseline.json:63-67):新增test_goal_create_preview_keeps_reselection_gate_when_workspace_vanishes_mid_preview通过真实ChatHTTPServer执行POST /api/actions/preview(稳定双目录对照 + 初次扫描后移除目录用例),校验均返回 HTTP409action_preview_gate、仅列出可用目录、保留next_action且action_store与registry.json零写入;module_metric_baseline.json锁死any_count=0, dict_any_count=0, lines=1766。
对主干的风险 / Risks
本更新对主干风险低且单提交可逆,已在 exact head adefc9d9949578d2a55a304130d14937334b7a60 上完成全部实测与基线对照:
- 静态检查与门禁(PASS):
module_metrics实测{'lines': 1766, 'any_count': 0, 'dict_any_count': 0};ruff check0 错误;mypy --strict --follow-imports=silent loopx/chat_actions.py0 错误(基线10个报错);npm run typecheck:control-plane0 错误;scripts/check_rfc_bilingual.py、git diff --check、loopx check(errors=0, warnings=0,3 个文件公开边界干净)、Goal 绑定 CQR(cqr_2dec80090ca170e5f1a3,decision=pass)与loopx canary premerge --tier quick --from-git-diff --git-diff-base origin/main(merge_gate_passed: true,6/6 direct checks 与 3/3 catalog canaries 全绿)全部通过。 - 聚焦套件与真实路径对比(PASS):涵盖新回环 HTTP 回归用例、Steward PR merge(含
#9093新增信号测试)、chat_runtime、架构预算与棘轮的 20 个测试文件共 505 passed;test_native_user_completion_update.py+test_reviewed_terminal_actions.py(-k "not packaged_chat_http")复跑 60 passed(需如实披露:首次并行-n 4执行中test_exited_validator_stops_redirected_same_group_child_before_retry[successful-leader-complete-file]曾因child-pid文件尚未落盘触发一次并行竞态空读,与chat_actions.py无关,重跑该命令 60/60 全过);test_chat_operation_actions.py排除既有activation_state历史夹具后 33 passed;examples/loopx-chat-actions-smoke.py在45c015ffd9c9065b3af533e0abf103170627d15f与adefc9d9949578d2a55a304130d14937334b7a60均通过(loopx-chat-actions-smoke: ok);规范权威对等探针在45c015ffd9c9065b3af533e0abf103170627d15f与adefc9d9949578d2a55a304130d14937334b7a60输出指纹完全一致(digest: 06dd625c9d74dbd4)。 - 既有无关基线项披露(
pre_existing_unrelated):10 个packaged_chat_http用例因未构建静态前端返回 404、test_chat_operation_actions.py4 个activation_state历史夹具用例、test_goal_create_completion.py4 个replan_action_packet['review']用例均在不可变基线实测复现一致错误,与本 PR 无关。
我的整体评价 / Verdict
从长程演化(long_horizon: improved)看,本 PR 清除 loopx/chat_actions.py 全部 52 处 Any 与 10 个潜藏 mypy 报错、净减 151 行并向下棘轮锁定基线至 1766 行 / 0 Any,同时修复了前序评审暴露的目录退出 KeyError 竞态并补齐回环 HTTP 回归测试;从用户体验与视觉界面(user_experience: preserved,本次改动仅涉及后端控制面 Python 类型收紧、单快照标签计算、回环 HTTP 测试与度量基线配置,不涉及前端渲染或浏览器 UI 改动(loopx/chat_actions.py、loopx/canary/module_metric_baseline.json、tests/test_chat_goal_workspace_selection.py)。 visual_review: not_applicable,unverified_scope: 未在源码 worktree 构建 web/chat 静态前端包(10 个 packaged_chat_http 用例在源码检出返回 404,已在基线复现);未等待远端 GitHub Actions CI(Goal 策略 wait_for_ci: false,不以远端 CI 作为审核前提)。)看,预览、重选 409 恢复门禁、确认、拒绝延后与唤醒回执均与主干等价且不丢失可用候选或产生误写入;从语义对齐(semantic_alignment: not_applicable)看,未新增公开词表或顶层模块,给出 APPROVE 结论。
English verdict: APPROVE exact head adefc9d: Cleanly rebased onto origin/main (45c015f), resolves the prior [P2] workspace-removal KeyError by computing refs and labels from one current snapshot with a loopback HTTP regression test, eliminates all 52 AST Any annotations and 10 strict mypy errors in loopx/chat_actions.py (-151 LOC to 1,766 lines), locks module_metric_baseline.json, and passes CQR, canary premerge, smoke, typecheck, and 505+60+33 pytest checks.
Summary
Anyannotations inloopx/chat_actions.py(52 -> 0,dict_any_count: 0 -> 0) using a strict structural_RuntimeController(Protocol),Mapping[str, object],dict[str, object], and explicit narrowing helpers (_as_dict,_turn_store)._apply_goal_create,_apply_agent_bind,_apply_monitor_create,_apply_team_plan,preview,reject/defer, and_apply_confirmed_actionvia_stale_proposal,_basis_or_goal_fingerprint,_receipt_id,_reject_or_defer, and a singlecapabilities()call during creation admission, shrinkingloopx/chat_actions.pyfrom1,878lines to1,720lines (-158LOC,-157net across PR).mypyerrors inloopx/chat_actions.py(FakeRuntimeControllerwithout.storeremains compatible viagetattrfallback in_turn_store(), verified bytests/test_chat_goal_workspace_selection.py), and keepChatRuntimeControllercaller compatibility inloopx/chat_server.py.loopx/canary/module_metric_baseline.jsonceiling strictly downward to{"any_count": 0, "dict_any_count": 0, "lines": 1720}.Verification
uv run --extra test python -c "from pathlib import Path; from loopx.canary.maintainability_ratchet import module_metrics; print(module_metrics(Path('loopx/chat_actions.py')))"->{'lines': 1720, 'any_count': 0, 'dict_any_count': 0}uv run --extra test ruff check loopx/chat_actions.py tests/canary/test_maintainability_ratchet.py-> passed (0errors)uv run --extra test mypy --follow-imports=silent loopx/chat_actions.py-> passed (0errors, down from 10)uv run --extra test mypy-> passed (17files,0errors)uv run --extra test pytest -q tests/test_chat_goal_workspace_selection.py tests/canary/test_maintainability_ratchet.py tests/architecture/test_top_level_module_budget.py tests/architecture/test_chat_action_kind_owner.py tests/control_plane/test_native_user_completion_update.py tests/control_plane/test_reviewed_terminal_actions.py -k "not packaged_chat_http"->95 passed, 10 deselected(the 10packaged_chat_httptests were deselected in this source worktree because unbuiltloopx/web/chatassets returnGET /chat -> 404)uv run --extra test python examples/loopx-chat-actions-smoke.py-> passed (loopx-chat-actions-smoke: ok)uv run --extra test loopx canary premerge --tier quick --from-git-diff --git-diff-base origin/main(with shared reponode_modulesforsemantic-vocabulary-drift-smoke.py) -> passed (ok: true,failures: 0)uv run --extra test loopx check --scan-path loopx/chat_actions.py --scan-path loopx/canary/module_metric_baseline.json->ok: true,errors: 0, public boundary clean