Skip to content

fix(release): resolve v2.4.0 qualification regressions and reconcile release notes - #9190

Merged
loopx-agent merged 1 commit into
mainfrom
codex/fix-v240-wave2-regressions-20261121
Nov 21, 2026
Merged

loopx-agent merged 1 commit into
mainfrom
codex/fix-v240-wave2-regressions-20261121

Conversation

@loopx-agent

Copy link
Copy Markdown
Collaborator

Delivery Brief

  • Goal / source: Resolve the 5 distinct blockers/flakes uncovered during full v2.4.0 release qualification on 23dacd5f, and reconcile docs/product/releases/v2.4.0.md up to origin/main (3d15059fef).
  • Gap closed & observable result:
    1. Chat bare-root code redaction (loopx/chat.py, tests/test_chat_path_redaction.py): Separate _CHAT_LOCAL_PATH_SURFACE_PATTERN (requiring a non-empty tail after Windows drive/home/Unix roots) so bare inline-code examples like `C:\` are preserved in streamed chat answers without narrowing loopx/public_safe_text.py fail-closed guards.
    2. generic-cli validation_command_json lease auto-prep (loopx/cli_commands/turn_cadence.py, turn.py, turn_run_once.py, tests/test_loopx_turn_driver.py): Pass validation_command_json into uses_effect_bound_start_identity(...) at both call sites (turn.py and turn_run_once.py) so complete v1 adapters without a configured validator no longer trigger premature lease auto-prep errors.
    3. Unmanaged Lark _poll_profile background thread / lease cleanup (loopx/extensions/lark/goal_topic_runtime_service.py, tests/extensions/test_lark_realtime_dispatch.py): Ensure unmanaged direct _poll_profile calls do not leave active loopx-lark-mew background worker threads or session lock files behind after completion/close.
    4. DSH shadow observer public-safety mirror alignment (packages/dsh-loopx-plugin/src/observer.ts, tests/observer.spec.ts): Sync LOCAL_PATH_SURFACES optional-tail patterns with canonical loopx/public_safe_text.py and cover bare-root SUMMARY_TOKEN rejection in observer.spec.ts.
    5. Git probe timeout margin under high CPU contention (tests/test_registry_git_probe.py): Give test_registry_git_probe_retires_the_process_tree_on_timeout a 4.0s subprocess probe budget so /bin/sh reliably writes grandchild.pid before timeout retirement under parallel shard contention.
    6. Release notes reconciliation (docs/product/releases/v2.4.0.md): Reconcile newly merged main PRs (#9056, #9063, #9070, #9187, #9188, #9189) across EN & ZH sections.
  • Owning boundary: Release blocker fixes + v2.4.0 release notes (docs/product/releases/v2.4.0.md). Zero private paths or local state included.
  • Verification:
    • pytest (targeted 9-file suite covering chat redaction, public safety, DSH observer mirror parity, Lark dispatch, git probe): 368 passed
    • pytest (test_loopx_turn_driver.py, test_core_distribution.py, test_lark_goal_topic_runtime.py): 314 passed, 49 skipped
    • pnpm --dir packages/dsh-loopx-plugin test (build + typecheck + vitest): 372 passed (15 test files)
    • python examples/release/release-readiness-doc-smoke.py --release-notes docs/product/releases/v2.4.0.md (all 13 surfaces): PASS
    • ruff check, mypy (17 files), check_rfc_bilingual.py, control-plane-maintainability-ratchet-smoke.py, loopx check --scan-path ...: PASS (0 errors)

@loopx-agent
loopx-agent force-pushed the codex/fix-v240-wave2-regressions-20261121 branch from a395d5e to 7950a0e Compare November 21, 2026 12:24

@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 · Gemini · Google · self_reported

Request changes conclusion (author-owned PR; GitHub blocks formal self-review)

说明:本次能力包中 reviewer_execution 为 unavailable(session_not_bound),因此依据契约按 self_reported 署名发布;此外依据仓库本地优先策略(wait_for_ci=false),未等待或轮询远程 GitHub Actions CI。

动机 / Motivation

受本次改动影响的调用方与维护者包括:运行流式对话脱敏与解析的 Chat 服务及用户、使用 generic-cli (loopx_turn_host_request_v1) 且未配置独立校验器的外置 Turn 宿主、托管运行或直接触发 LarkGoalTopicRuntimeService 轮询与关闭生命周期的飞书运行时、构建或测试 dsh-loopx-plugin 影子观察器的插件集成方、并行执行 pytest 套件的验证者,以及核对 v2.4.0 发布说明的维护者。

在基线 origin/main 上,#9080 放宽了共享路径正则尾部匹配后导致 Chat 流式回答会把行内代码裸根路径示例(如 Windows 盘符根路径字面量)误脱敏为 [local-path],同时 dsh-loopx-plugin 镜像未同步该可选尾部而破坏契约校验;generic-cli 的两处调用点对 validation_command_json 判断不一致引发预备/节律失配;直接非托管调用 LarkGoalTopicRuntimeService._poll_profile 退出时会触发 refresh() 泄漏后台守护线程与消费者锁文件;test_registry_git_probe 在高并发分片负载下因 1.5s 超时前未写入子进程 PID 而偶发失败。PR #9190 逐一修复上述问题并对齐 docs/product/releases/v2.4.0.md,但在 LarkGoalTopicRuntimeService.close() 中新增了对 _startup_thread 的 join(timeout=3),反而引入了新的关闭阻塞回归。

在精确 head 上,Chat 行内代码根路径保真、generic-cli 校验器门控一致性、dsh-loopx-plugin 镜像正则对齐、_poll_profile 非托管调用防泄漏、test_registry_git_probe 超时余量以及 v2.4.0 发布说明对账均已落地并经本地验证通过;但 LarkGoalTopicRuntimeService.close() 会因等待阻塞的 _startup_thread 最多卡顿 3 秒,导致 tests/test_chat_startup_isolation.py 中 2 项启动/关闭隔离测试确定性失败。

本 PR 不放宽 public_safe_text.py 对外部公开产物的严格路径拒止边界,不改变 codex-cli 默认起始身份绑定规则,不将生产环境 Git 探针默认 1.5s 超时放大到 4.0s,也不把 v2.4.0 文档对齐当成完整发布资格回执或直接触发合并/发版。

改动思路 / Approach

PR #9190 针对 v2.4.0 发布前质量门禁暴露的 5 个具体回归以及发布说明缺口采取逐点定点收敛策略,整体职责分层清晰:

各修复均保持在既有边界内:loopx/chat.py 仅将展示脱敏正则收窄为必须含子路径的 _CHAT_LOCAL_PATH_SURFACE_PATTERN 而不弱化 public_safe_text 守卫;turn_cadence.uses_effect_bound_start_identity 统一收敛 turn.py 与 turn_run_once.py 的 validation_command_json 判定;observer.ts 保留独立插件包所需的镜像正则校验合约;唯独 LarkGoalTopicRuntimeService.close() 误把可阻塞外部文件系统读的 _startup_thread 纳入同步 join 列表。

当前 PR 边界限定在修复这 5 项 v2.4.0 资格验证回归及同步 docs/product/releases/v2.4.0.md 至最新主干,不扩张为公共安全引擎重构或异步启动架构重写;仅需撤销 close() 对 _startup_thread 的阻塞等待即可使全量边界收口。

  1. 展示脱敏与公开安全守卫解耦:#9080 为对齐扩展展示层守卫而在 loopx/public_safe_text.py 中允许 Unix 与 Windows 盘符无尾部裸根前缀匹配,意外让共用同一正则的 loopx/chat.py 把文档或回答中的行内代码裸根示例改写成 [local-path]。本 PR 在 loopx/chat.py 引入专用的 _CHAT_LOCAL_PATH_SURFACE_PATTERN(要求根路径后必须跟随非空子路径段),保留 public_safe_text.LOCAL_PATH_SURFACE_PATTERN 的严格 fail-closed 边界不变。
  2. 统一 generic-cli 起始身份与校验器门控:此前 turn.py 在行内单独判断 validation_command_json,而 turn_cadence.uses_effect_bound_start_identity 与 turn_run_once.py 未带入该条件,导致无独立校验器的 generic-cli(loopx_turn_host_request_v1)在未做租约准备时仍按 effect_id 绑定节律请求 ID,使源状态变化后的重跑错误续借旧预留而非触发 interval_wait。本 PR 将 validation_command_json 收敛进单一决策函数 uses_effect_bound_start_identity。
  3. Lark 监听器非托管退出与清理加固:LarkGoalTopicRuntimeService._poll_profile 新增 managed_worker 判定,避免直接调用在 finally 分支误触发 self.refresh() 启动游离的 loopx-lark-* 守护线程;新增 _retiring_workers、_stop_consumer_process 与按构造时 HOME 定锚的 _consumer_lease_dir(),防止替换下来的消费者管道或进程泄漏真实主目录锁文件;但同时在 close() 中错误加入了 startup_thread.join(timeout=3)。
  4. DSH 插件镜像同步与测试隔离:同步 packages/dsh-loopx-plugin/src/observer.ts 的 LOCAL_PATH_SURFACES 可选尾部正则以对齐 public_safe_text.py,并在 test_registry_git_probe.py 单独放宽分片并发下 fake git 启动写 PID 的超时余量至 4.0s。
  5. 发布说明对齐:将合入主干的 #9056、#9063、#9070、#9187、#9188、#9189 以及本 PR #9190 同步至 docs/product/releases/v2.4.0.md 的中英文分组与贡献者致谢。

具体改动 / Changes

对照规范 docs/product/release-readiness.md(基线提交 3d15059fef142138a60fc8a03c8394e92879387c)逐项核对准入标准:

  • RR-DOC-SMOKE(implemented):docs/product/releases/v2.4.0.md 覆盖最新主干提交范围内的全部 PR 与贡献者归属,通过 release-readiness-doc-smoke.py 全部 13 个 --surface 校验及中英摘要对账。
  • RR-COMPAT-BOUNDARY(implemented):loopx/chat.py 保留 Chat 展示可用性的同时未放松 public_safe_text.py;turn_cadence.py / turn.py / turn_run_once.py 恢复无校验器 generic-cli 与含校验器 v1 适配器的契约边界;packages/dsh-loopx-plugin/src/observer.ts 与规范正则逐字对齐。
  • RR-CANARY-ISOLATION(not_met):LarkGoalTopicRuntimeService.close() 阻塞等待 _startup_thread 最长 3 秒,违背非阻塞关闭隔离契约,导致 tests/test_chat_startup_isolation.py 2 项既有测试确定性失败。

关键代码讲解

  1. _CHAT_LOCAL_PATH_SURFACE_PATTERN(loopx/chat.py:59)
    在 Chat 展示脱敏模块中定义了要求根前缀后必须跟随 [^\s'"<>]+的正则,替换_local_path_pattern与redact_local_paths末段兜底处对LOCAL_PATH_SURFACE_PATTERN的直接引用。输入不含子路径的裸根示例(Unix 主目录裸根或 Windows 盘符裸根行内代码)时不再被替换为[local-path];一旦带有真实子路径或命中 protected_paths保护根,仍按原逻辑脱敏为[local-path]或[project]/./...,而 public_safe_text.py` 及扩展展示守卫保持原严格判定不变。
  2. uses_effect_bound_start_identity(loopx/cli_commands/turn_cadence.py:25)
    新增可选参数 validation_command_json: str | None = None,仅当 host == "codex-cli" 或 host == "generic-cli" 且同时满足 adapter_request_schema == COMPLETE_TURN_HOST_REQUEST_SCHEMA 与 bool(validation_command_json) 时返回 True。loopx/cli_commands/turn.py:106 移除原有内联条件改由统一函数判定,loopx/cli_commands/turn_run_once.py:871 同步传入 validation_command_json,从而保证租约自动准备与节律 request_id 绑定在两处调用点完全一致。
  3. LarkGoalTopicRuntimeService._poll_profile 与 _consumer_lease_dir(loopx/extensions/lark/goal_topic_runtime_service.py:502,607)
    _poll_profile 入口在 self._lock 下校验 worker is not None and worker[0] is stop 并记为 managed_worker,finally 分支仅在 managed_worker and not self._closed.is_set() 时执行 self.refresh(),阻断非托管直调退出后隐式派生新后台线程的泄漏路径;同时 _retiring_workers 追踪被替换的在途工作线程,_consumer_lease_dir() 在 Path.home 未被测试 monkeypatch 替换时固定使用构造期捕获的 self._default_home,避免测试恢复环境变量后把锁文件写入真实宿主目录。
  4. LarkGoalTopicRuntimeService.close(loopx/extensions/lark/goal_topic_runtime_service.py:1023 — 存在阻塞性缺陷)
    close() 正确增加了 _refresh_retry.cancel()、_retiring_workers 清理与 _stop_consumer_process(consumer) 终止消费者子进程逻辑,但它同时将 startup_thread = self._startup_thread 加入 threads 并执行 thread.join(timeout=3)。当 snapshot_provider() 或队列文件读取阻塞时,该 join(timeout=3) 会令 close() 与上层 ChatHTTPServer.shutdown() 同步阻塞,触发下文 P1 回归。
  5. LOCAL_PATH_SURFACES(packages/dsh-loopx-plugin/src/observer.ts:73)
    将 Unix 根路径、Windows 盘符路径与家目录简写模式尾部补齐为可选组 (?:[^\s'"<>]+)?,与 loopx/public_safe_text.py的LOCAL_PATH_SURFACE_PATTERN和HOME_RELATIVE_PATH_PATTERN恢复逐arm等价;经test_typescript_mirror_equals_the_canonical_local_path_surfaces与observer.spec.ts双端验证,含裸 Unix 根或裸盘符根的SUMMARY_TOKEN` 均被 fail-closed 拦截。

对主干的风险 / Risks

[P1 阻塞缺陷] LarkGoalTopicRuntimeService.close() 阻塞等待 _startup_thread,破坏非阻塞关闭隔离契约

  • Problem & Trigger:当 LarkGoalTopicRuntimeService.start() 已启动后台发现线程 self._startup_thread(name="loopx-lark-startup", daemon=True)且 snapshot_provider() 或 _resume_session_queues() 中的文件 I/O 阻塞(例如系统等待目录访问授权或慢盘读取)时,调用 service.close() 或 ChatHTTPServer.shutdown()(serve_chat 退出路径)。
  • Code Path:loopx/extensions/lark/goal_topic_runtime_service.py:1032-1052(LarkGoalTopicRuntimeService.close())。
  • Observed Outcome & Evidence:PR #9190 将 startup_thread = self._startup_thread 放进 threads 列表并在关闭路径上执行 startup_thread.join(timeout=3),导致 close() 被阻塞最长 3 秒。我在精确 head 7950a0e278d03318ee74b70bb35190ad1ef805f6 上运行 tests/test_chat_startup_isolation.py 时,5 项测试中有 2 项确定性失败(FAIL):test_real_chat_entrypoint_serves_while_binding_discovery_is_blocked(worker.join(2) 后 worker.is_alive() 仍为 True)与 test_close_does_not_wait_for_real_queue_file_read(closed.wait(1) 超时返回 False)。对照基线 origin/main(3d15059fef)同一测试集 5/5 全量通过(耗时 7.17s)。
  • Impact:违背 goal_topic_runtime_service.py:929 已明确声明的“文件系统读可长于服务关闭生命周期”的架构边界,会使桌面端/Chat 服务在目录权限弹窗或慢 I/O 挂起时无法快速优雅退出。
  • Minimum Repair:从 LarkGoalTopicRuntimeService.close() 的 threads 等待列表中移除 startup_thread,保留 self._closed.set()、self._refresh_retry.cancel()、_stop_consumer_process 以及对工作线程与 _retiring_workers 的 join。我已在隔离临时覆盖中验证该单处最小修复:同时运行 tests/test_chat_startup_isolation.py 与 tests/extensions/test_lark_realtime_dispatch.py 全部 24 passed in 11.05s(PASS)。
  • Rerun Command:uv run --extra test python -m pytest -q tests/test_chat_startup_isolation.py tests/extensions/test_lark_realtime_dispatch.py

其余边界、隔离与权限检查

  • Scope Fit & Active Callers:loopx/chat.py 的 _CHAT_LOCAL_PATH_SURFACE_PATTERN 服务于 redact_local_paths、redact_response_markdown、VisibleResponseStreamFilter 等全部 Chat 展示链路;uses_effect_bound_start_identity 由 turn.py 与 turn_run_once.py 两个唯一生产入口共用;observer.ts 通过 packages/dsh-loopx-plugin 宿主插件注册并在 tests/capabilities/test_reliability_diagnostics_dsh_provider.py 中与规范文件受控对齐。
  • Default-Off Isolation:dsh-loopx-plugin 影子观察器仍保持 export const inject: readonly string[] = [] 且仅在明确注入目标上下文时激活;generic-cli 的首回合自动租约准备严格限制在显式声明 --host-adapter-request-schema loopx_turn_host_request_v1 且携带非空 --validation-command-json 时启用。在真实 CLI turn run-once 对照试验中,未传 --validation-command-json 的无租约 hard_lease 待办以拒绝退出(exit=1, lease_active=False),传入校验器后则自动完成声明并提交(exit=0, status="committed", quota_spent=True)。
  • Authority & Typed Rules:无新增越权生命周期或字符串黑名单分类;tests/test_registry_git_probe.py:185 仅在单条超时测试中通过 monkeypatch 将超时窗口调为 4.0s,生产默认 _GIT_PROBE_TIMEOUT_SECONDS = 1.5 与管道排空隔离测试均未放宽。

语义与 CI 对齐

本 PR 不新增或篡改公共状态词表(复用既有 public_safe_text.LOCAL_PATH_SURFACE_PATTERN、COMPLETE_TURN_HOST_REQUEST_SCHEMA 与 docs/product/release-readiness.md 发布面结构,semantic_alignment 判定为 aligned / reuse_existing)。基于 wait_for_ci=false 契约未查询远程 CI,所有关键验证均已在精确 head 本地隔离执行:pytest 针对性回归 391 passed、Turn 驱动与 Lark 运行时 314 passed(49 skipped 仅因未设置独立 core wheel 环境变量 LOOPX_CORE_TEST_PYTHON)、架构与 Chat/Lark 伴随套件 1957 passed / 2 failed(失败全数位于 tests/test_chat_startup_isolation.py,单独重跑 2 failed, 3 passed vs 基线 5/5 passed)、Lark 关联服务测试 187 passed、Turn 准备与隔离回归 278 passed、dsh-loopx-plugin (typecheck + vitest) 372 passed、release-readiness-doc-smoke.py(全 13 个 surface)PASS、ruff / mypy(17 个严格文件)/ check_rfc_bilingual.py / loopx check / canary premerge(19 项检查全绿)PASS。

我的整体评价 / Verdict

综合评估 outcome_impact:long_horizon 为 regression,user_experience 为 regression。尽管 PR #9190 准确修复了原本阻塞 v2.4.0 发布验证的 5 个问题(Chat 行内根路径保真、generic-cli 校验器门控同步、非托管 _poll_profile 防派生线程、DSH 插件镜像正则对齐、分片并发下的 git 探针测试稳定性)并完成了 docs/product/releases/v2.4.0.md 至最新主干的对账,但 LarkGoalTopicRuntimeService.close() 新增的 startup_thread.join(timeout=3) 引入了违反既有关闭隔离契约的 P1 阻塞回归,使真实 Chat 入口在目录发现挂起时无法在要求时间内完成关闭。

  • 视觉检查说明:经检查改动路径(loopx/chat.py、loopx/cli_commands/turn*.py、loopx/extensions/lark/goal_topic_runtime_service.py、packages/dsh-loopx-plugin/src/observer.ts、docs/product/releases/v2.4.0.md 与对应测试文件),本 PR 不涉及任何已渲染的前端页面、Desktop 界面或交互组件布局变更,视觉审查不适用。(unverified_scope: none)。
  • 代码体量与简化:整体改动 +163/-52(12 个文件)比例合理、高度聚焦;turn_cadence.uses_effect_bound_start_identity 已消除原有双处条件漂移,移除 close() 中多余的 startup_thread 等待即可保持最小清晰边界。
  • 词表归属:复用既有词表与规范契约(reuse_existing),无需新增 RFC 或词表注册项。
  • 精确 Head 新鲜度与复审门槛:本结论严格基于精确 head 7950a0e278d03318ee74b70bb35190ad1ef805f6。移除 LarkGoalTopicRuntimeService.close() 对 startup_thread 的 join 并确认 tests/test_chat_startup_isolation.py 与 tests/extensions/test_lark_realtime_dispatch.py 同步通过后,即可在下一精确 head 复审通过。

English verdict: REQUEST_CHANGES at exact head 7950a0e due to a P1 regression in LarkGoalTopicRuntimeService.close() joining _startup_thread and blocking shutdown isolation (tests/test_chat_startup_isolation.py 2 failed, 3 passed vs 5/5 passed on origin/main); the other 5 regression fixes, release-notes reconciliation, dsh-loopx-plugin checks, and canary premerge pass.

@loopx-agent
loopx-agent force-pushed the codex/fix-v240-wave2-regressions-20261121 branch from 7950a0e to 38e5b89 Compare November 21, 2026 12:50

@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 · Gemini · Google · self_reported

Approval conclusion (author-owned PR; GitHub blocks formal self-approval)

说明:本次 loopx pr-review 能力包返回 reviewer_execution: unavailable(session_not_bound),按评审契约使用 self_reported 署名发布;同时按目标仓库本地优先策略(wait_for_ci: false),本次审查基于精确 head 本地验证结论,未等待或轮询远程 GitHub Actions CI。

动机 / Motivation

受本次改动影响的调用方与运维者包括:执行流式回答展示脱敏的 Chat 服务与用户、使用完整 v1 协议但未配置校验命令的 generic-cli 外部 Turn 宿主、直接调用或托管运行 LarkGoalTopicRuntimeService 生命周期的飞书运行时、打包或测试 dsh-loopx-plugin 影子观察器的插件集成方、在并行分片下执行测试套件的验证者,以及核对 v2.4.0 发布说明的维护者。

在主干基线 871cc36 上,#9080 为收紧公开边界允许裸根前缀匹配,却连带导致共用同一正则的 loopx/chat.py 把回答里的行内代码裸根示例误脱敏为 [local-path],同时 dsh-loopx-plugin 镜像未同步该规则而违背跨语言一致性测试;#9047 在 turn.py 与 turn_run_once.py 对 generic-cli 是否传入 validation_command_json 判定不一致,令未配校验器的宿主在中断重入时误复用同一 effect_id 预留而非退回 interval_wait;非托管直调 LarkGoalTopicRuntimeService._poll_profile 退出时触发 refresh() 泄漏后台线程及锁文件;并行高负载下 test_registry_git_probe 超时测试偶发未写完子进程 PID 即被终止。上一审查提交 7950a0e 虽已修复上述 5 项问题,却因在 close() 中同步等待 _startup_thread 导致 tests/test_chat_startup_isolation.py 两项隔离测试失败;在当前精确 head 38e5b89 中已撤销该阻塞等待并补全 #9191 的 v2.4.0 发布说明对账。

若保持主干现状不做修复,v2.4.0 发布资格门禁中的 Lark 线程/锁隔离、Turn 启动恢复、Chat 流式代码渲染以及 DSH 镜像契约校验均无法同时收口,并在真实运行时留下线程泄漏与预备逻辑分叉风险。当前精确 head 38e5b89 已在全部 6 个修复面上落地并通过本地实测验证:Chat 展示脱敏保留行内裸根示例而不放松 public_safe_text.py 严格公开拦截;turn_cadence.uses_effect_bound_start_identity 统一收敛双调用点的 validation_command_json 门控;LarkGoalTopicRuntimeService 既防止非托管直调派生后台线程与默认主目录锁泄漏,又在 close() 期间严格保持对 _startup_thread 的非阻塞隔离;packages/dsh-loopx-plugin 与规范正则逐项一致并拦截裸根 SUMMARY_TOKEN;test_registry_git_probe 超时测试仅调整单测自身超时余量;docs/product/releases/v2.4.0.md 通过全部 13 个可选能力面的文档烟测。

本 PR 不放宽 loopx/public_safe_text.py 对对外公开产物或结构化回执的严格路径拦截边界,不更改 codex-cli 的起始身份绑定策略,不调高生产环境 Git 探针默认 1.5s 超时阈值,不重构异步启动线程架构,也不将发布说明对齐当成完整发布资格签收或直接合并发版。

改动思路 / Approach

各修复均收敛在既有职责边界内:loopx/chat.py 仅分离展示脱敏正则 _CHAT_LOCAL_PATH_SURFACE_PATTERN 而不削弱 public_safe_text.py 公开边界守卫;turn_cadence.uses_effect_bound_start_identity 消除 turn.py 与 turn_run_once.py 之间的双处条件漂移;goal_topic_runtime_service.py 通过 managed_worker、_retiring_workers、_stop_consumer_process 与 _consumer_lease_dir 隔离非托管调用和在途线程回收,同时避免 close() 同步 join _startup_thread;observer.ts 保持独立 npm 包所需的镜像合约对齐,test_registry_git_probe.py 仅调高单测自身超时余量。

当前 PR 边界严格限定在修复 v2.4.0 发布前门禁暴露的 5 项回归并同步 docs/product/releases/v2.4.0.md 至最新主干 871cc36(含 #9191),不扩展为公共安全规则引擎重写、Lark 启动模型重构或直接发版操作。

从数据流与控制流看,本次变更分别沿着四条独立边界修复“职责错配”或“双处分叉”,未引入新的全局状态或平行权威:

上一次审查 head 7950a0e278
  └─ LarkGoalTopicRuntimeService.close()
       ├─ join(workers + retiring_workers)
       └─ join(_startup_thread, timeout=3)  ──▶ FAIL: 慢盘/阻塞发现时卡住关闭流程

当前精确 head 38e5b89c70cf028c5854af0ef3706ae63f43fc37(示意图,来源:goal_topic_runtime_service.py)
  └─ LarkGoalTopicRuntimeService.close()
       ├─ _closed.set() + _refresh_retry.cancel() + _stop_consumer_process(consumers)
       ├─ join(workers + retiring_workers,跳过 current_thread)  ──▶ PASS: 正常退出且无游离消费者
       └─ 不等待 _startup_thread  ──▶ PASS: 满足“文件发现 I/O 可长于关闭周期”的隔离边界
  1. 展示层脱敏与公开安全守卫解耦:loopx/public_safe_text.py 的 LOCAL_PATH_SURFACE_PATTERN 继续由 validate_public_safe_value、public_safe_compact_text、classify_private_text 等公开导出安全门禁独占使用,对任何裸根前缀保持 fail-closed 拦截;面向终端用户回答渲染的 loopx/chat.py 则改用要求根路径后必须带非空子路径段的 _CHAT_LOCAL_PATH_SURFACE_PATTERN,避免技术问答中行内代码的裸盘符或裸根目录前缀被误替换为 [local-path]。
  2. 统一 generic-cli 起始身份门控:turn_cadence.uses_effect_bound_start_identity 增加可选参数 validation_command_json,作为 turn.py(首回合租约准备)与 turn_run_once.py(节律预留 request_id 选择)的单一决策函数,彻底消除此前一处校验器存在性判断在两处调用点不同步的问题。
  3. Lark 非托管轮询防泄漏与非阻塞关闭:_poll_profile 仅在入口锁内确认自身属于当前 self._workers[profile] 时标记 managed_worker=True,退出时非托管调用不再触发 self.refresh();_refresh_profile_workers 替换旧 worker 时将存活旧线程收入 _retiring_workers 并终止关联消费者子进程;_consumer_lease_dir() 在 Path.home 未被测试 monkeypatch 替换时固定使用构造期捕获的 self._default_home,阻断夹具清理后写入真实宿主目录锁文件的竞态;close() 则严格只回收已知工作线程与在途线程、取消重试定时器并终止消费者,不再阻塞等待 _startup_thread。
  4. DSH 插件镜像正则同步、测试超时余量与发布说明对齐:packages/dsh-loopx-plugin/src/observer.ts 补齐可选尾部以对齐 public_safe_text.py 并在 observer.spec.ts 覆盖裸根拒绝;tests/test_registry_git_probe.py 仅在单条超时的假 git 进程树测试里通过 monkeypatch 放宽超时窗口至 4.0s;docs/product/releases/v2.4.0.md 同步 #9056、#9063、#9070、#9187、#9188、#9189、#9191 及 #9190 本身修复条目与 @cocolord / @maxliux5 归属。

具体改动 / Changes

对照规范 docs/product/release-readiness.md(已提交基准修订 5422e6d67aacce70ec1e312164da07744b5abcf0)逐项核对验收标准:

  • RR-DOC-SMOKE(implemented):docs/product/releases/v2.4.0.md 将主干新合入 PR(#9056、#9063、#9070、#9187、#9188、#9189、#9191)及 #9190 同步至 EN/ZH Highlights、Capabilities & Workflows、Quality & Testing 及 Community Contributors,通过 examples/release/release-readiness-doc-smoke.py 全部 13 个 --surface 校验且无新增或遗漏可选能力入口。
  • RR-COMPAT-BOUNDARY(implemented):loopx/chat.py 仅调整展示脱敏正则而保持 loopx/public_safe_text.py fail-closed 边界不变;loopx/cli_commands/turn_cadence.py、turn.py、turn_run_once.py 统一 generic-cli 校验器存在性门控;packages/dsh-loopx-plugin/src/observer.ts 与规范正则逐字等价并通过 test_typescript_mirror_equals_the_canonical_local_path_surfaces 及 observer.spec.ts;tests/test_registry_git_probe.py 不改变生产超时默认值 1.5s。
  • RR-CANARY-ISOLATION(implemented):loopx/extensions/lark/goal_topic_runtime_service.py 在 38e5b89c70 已移除上一版 7950a0e278 在 close() 中对 _startup_thread 的同步等待,同时保留非托管 _poll_profile 防派生、_retiring_workers 追踪、_stop_consumer_process 进程清理与 _consumer_lease_dir() 隔离;tests/test_chat_startup_isolation.py 与 tests/extensions/test_lark_realtime_dispatch.py 共 24 项全部通过。

关键代码讲解

  1. _CHAT_LOCAL_PATH_SURFACE_PATTERN(loopx/chat.py:59)
    在 Chat 展示脱敏模块内独立定义仅匹配“包含非空子路径尾段”的本地路径正则,替换 _local_path_pattern 与 redact_local_paths 兜底分支中对 public_safe_text.LOCAL_PATH_SURFACE_PATTERN 的直接引用。当 protected_paths 为空或指向自定义项目目录时,行内裸盘符与裸根目录前缀保留原文可读性,而真实带子路径的绝对路径及受保护项目根仍稳定脱敏为 [local-path]、[project] 或 ./...;与此同时,public_safe_text.find_public_safe_local_path 与 classify_private_text 仍保持裸根拦截不变。
  2. uses_effect_bound_start_identity(loopx/cli_commands/turn_cadence.py:25)
    签名扩展为 (host, adapter_request_schema, validation_command_json=None):当 host == "codex-cli" 时返回 True;当 host == "generic-cli" 时要求同时满足 adapter_request_schema == COMPLETE_TURN_HOST_REQUEST_SCHEMA 且 bool(validation_command_json)。loopx/cli_commands/turn.py:106 移除原有额外内联条件并改由该函数统一判定,loopx/cli_commands/turn_run_once.py:871 同步透传 validation_command_json,确保无独立校验器的 generic-cli 在首回合不触发租约自动准备,且中断重入时按 turn_key 重新接受间隔门禁校验。
  3. LarkGoalTopicRuntimeService._poll_profile 与 _consumer_lease_dir(loopx/extensions/lark/goal_topic_runtime_service.py:607,502)
    _poll_profile 入口加锁比对 worker is not None and worker[0] is stop 得到 managed_worker,仅在受管 worker 且未关闭时才允许 finally 路径触发 self.refresh(),阻断直接单元测试退出后隐式拉起后台 loopx-lark-* 线程的路径;_consumer_lease_dir() 检查 Path.home.__func__ 是否属于标准库 pathlib,未打补丁时回落到构造期捕获的 self._default_home,防止测试撤销 monkeypatch 后并发残余读取将锁文件写入宿主家目录。
  4. LarkGoalTopicRuntimeService.close 与 _refresh_profile_workers(loopx/extensions/lark/goal_topic_runtime_service.py:1023,955)
    _refresh_profile_workers 淘汰旧 worker 时若线程仍存活则加入 self._retiring_workers 并对匹配 stop 的消费者调用 _stop_consumer_process;close() 在锁内取消 _refresh_retry 定时器、清空 _workers 与 _retiring_workers、置位所有 stop 并终止消费者进程,随后仅 join(timeout=3) 活跃工作线程与在途淘汰线程(并过滤 current_thread 防自锁)。与 7950a0e278 相比,本精确 head 彻底移除了对 _startup_thread 的 join,保证当目录权限确认或队列文件 I/O 阻塞时 close() 与 ChatHTTPServer.shutdown() 仍能立即返回。
  5. LOCAL_PATH_SURFACES(packages/dsh-loopx-plugin/src/observer.ts:73)
    将 Unix 绝对根目录、Windows 盘符根以及家目录简写(tilde prefix)三条正则的尾段改为 (?:[^\s'"<>]+)?,恢复与 loopx/public_safe_text.py中LOCAL_PATH_SURFACE_PATTERN和HOME_RELATIVE_PATH_PATTERN的逐臂文本等价,并由packages/dsh-loopx-plugin/tests/observer.spec.ts新增两条裸根SUMMARY_TOKEN` 拒止断言提供双端防护。

对主干的风险 / Risks

经对精确 head 38e5b89c70cf028c5854af0ef3706ae63f43fc37 完整基线到当前提交(871cc36348..38e5b89c70)及所有受影响共享边界的逐一复核,未发现阻塞主干合入的缺陷(no blocking findings)。较上一版 7950a0e278 暴露的 LarkGoalTopicRuntimeService.close() 等待 _startup_thread 回归(曾导致 tests/test_chat_startup_isolation.py 2 项失败)已在当前提交彻底移除并经实测恢复全绿。

  • 残余风险与边界说明:
    1. uses_effect_bound_start_identity 对 validation_command_json 采用字符串真值检查(bool(validation_command_json)),若调用方显式传入 "[]" 仍会在 turn.py 走入 admit_preparation,随即被 prepare_turn_host_arguments 下游解析或 command_validation._normalize_argv 空列表校验 fail-closed 拒绝而不会创建错误租约或调用宿主;这与修复前 turn.py 原内联逻辑完全一致,非本 PR 引入的新风险。
    2. tests/test_core_distribution.py 中 49 项独立 Core wheel 用例因未设置 LOOPX_CORE_TEST_PYTHON 而跳过(1 passed, 49 skipped),独立 wheel 打包验证需按发布流程另行执行;另 docs/product/releases/v2.4.0.md 的 13 项 --surface 文档校验已通过,完整版本 tag/桌面端包及真机验证仍归属独立发布门禁。
  • Active Callers & Scope Fit:_CHAT_LOCAL_PATH_SURFACE_PATTERN 直接服务于 redact_local_paths、redact_response_markdown 与 VisibleResponseStreamFilter 等全部 Chat 展示脱敏调用链;uses_effect_bound_start_identity 由仅有的两处 Turn 启动入口 turn.py 与 turn_run_once.py 共用;LarkGoalTopicRuntimeService 直接承担 Chat 服务内的飞书事件监听与私聊投递生命周期;observer.ts 通过 packages/dsh-loopx-plugin 的 ./observer 导出挂载并在跨语言契约测试中被校验。
  • Default-Off Isolation:dsh-loopx-plugin 影子观察器维持 export const inject: readonly string[] = [],未改变默认停用隔离边界;generic-cli 起始身份绑定继续严格限定在显式传入 --host-adapter-request-schema loopx_turn_host_request_v1 且携带非空 --validation-command-json 的调用路径上。在隔离 sqlite hard_lease 对照实测中,不带 --validation-command-json 的 generic-cli 调用以 LoopX Turn route is not host executable(state_written=None, host_invoked=None)退出,不会触发意外租约准备;带上校验器后则如期执行租约准备并进入宿主调度(state_written=True, host_invoked=True)。
  • Authority & Typed Rules:无新增越权生命周期或字符串黑名单规则;tests/test_registry_git_probe.py:185 仅通过 monkeypatch 放宽单条超时测试的进程树准备窗口,生产常量 _GIT_PROBE_TIMEOUT_SECONDS = 1.5 与管道排空隔离测试保持不变。
  • 本地验证汇总(精确 head 38e5b89c70cf028c5854af0ef3706ae63f43fc37,wait_for_ci: false):
    • pytest -q tests/test_chat_startup_isolation.py tests/extensions/test_lark_realtime_dispatch.py: PASS (24 passed in 11.01s)
    • pytest -q tests/test_chat_path_redaction.py tests/test_registry_git_probe.py tests/capabilities/test_reliability_diagnostics_dsh_provider.py: PASS (105 passed in 7.59s)
    • pytest -q tests/test_chat_response_parsing.py: PASS (48 passed in 0.54s)
    • pytest -q tests/control_plane/test_public_safety_path_shapes.py tests/control_plane/test_public_safe_local_path_owner.py tests/control_plane/test_public_safe_text_classifier.py tests/extensions/test_lark_goal_topic_runtime.py: PASS (279 passed in 38.78s)
    • pytest -q -n auto tests/test_loopx_turn_driver.py: PASS (212 passed in 37.82s;其中 -k "uses_effect_bound_start_identity or managed_start_interruption" 单独复核 13 passed)
    • pytest -q tests/test_core_distribution.py: PASS(边界说明:1 passed, 49 skipped,因未设置 LOOPX_CORE_TEST_PYTHON)
    • pnpm --dir packages/dsh-loopx-plugin run typecheck && pnpm --dir packages/dsh-loopx-plugin test: PASS (15 test files, 372 passed in 65.25s)
    • python examples/release/release-readiness-doc-smoke.py --release-notes docs/product/releases/v2.4.0.md(全部 13 个 --surface 项): PASS
    • ruff check(全部改动 Python 文件)、python -m mypy(17 个严格内核文件)、scripts/check_rfc_bilingual.py、loopx check --scan-path ...(12 个改动文件公开边界扫描): PASS
    • loopx canary premerge --from-git-diff --git-diff-base origin/main: PASS(6 direct checks、10 catalog canaries、8 risk-profile smokes 含 dsh-loopx-plugin-validation.py 全三阶段 quality/package/runtime、1 public-boundary 全部通过,failures=0)

我的整体评价 / Verdict

综合评估 outcome_impact:long_horizon 为 improved,user_experience 为 improved。PR #9190 在精确 head 38e5b89c70cf028c5854af0ef3706ae63f43fc37 上彻底消除了上一提交 7950a0e278 误引入的 Lark 关闭阻塞回归,精准解决了 v2.4.0 发布前验证暴露的 5 项回归并完成了 docs/product/releases/v2.4.0.md 与主干最新合入项的对账,全部本地回归套件与 canary premerge 门禁均已通过。

  • 视觉检查说明:经核对本次改动涉及的全部文件路径(docs/product/releases/v2.4.0.md、loopx/chat.py、loopx/cli_commands/turn*.py、loopx/extensions/lark/goal_topic_runtime_service.py、packages/dsh-loopx-plugin/src/observer.ts 及相关测试),本 PR 不涉及任何已渲染前端界面、Desktop 视图或交互组件布局变更,视觉审查不适用。(unverified_scope: none)
  • 代码体量与简化:全量差异为 12 个文件 +161/-52,每一处改动均直接对应具体故障根因。turn_cadence.uses_effect_bound_start_identity 已消除原有双处判定分叉,展示脱敏与公开边界校验、DSH 镜像校验与 Lark 托管/非托管生命周期均维持了当前最小清晰边界,评估结论为 proportionate / retain。
  • 词表与语义对齐:semantic_alignment 判定为 aligned(reuse_existing),继续复用既有 public_safe_text.LOCAL_PATH_SURFACE_PATTERN、COMPLETE_TURN_HOST_REQUEST_SCHEMA 与 docs/product/release-readiness.md 发布面契约,未新增、分叉或弱化任何公共状态词表,无需补充 RFC 或词表注册修复。
  • 精确 Head 新鲜度:本批准结论绑定当前远程精确 head 38e5b89c70cf028c5854af0ef3706ae63f43fc37(wait_for_ci: false,独立于远程 CI 队列;实际合并仍需由拥有仓库合并权限的维护者执行)。

English verdict: APPROVE at exact head 38e5b89; the blocking _startup_thread join in LarkGoalTopicRuntimeService.close() from 7950a0e is removed, all 5 v2.4.0 qualification regressions and release-note reconciliations pass local validation (including test_chat_startup_isolation.py + test_lark_realtime_dispatch.py 24 passed, test_chat_path_redaction + test_registry_git_probe + dsh_provider 105 passed, test_loopx_turn_driver 212 passed, dsh-loopx-plugin typecheck/vitest 372 passed, release-readiness-doc-smoke 13 surfaces, and canary premerge 19/19 checks).

@loopx-agent
loopx-agent merged commit 869de85 into main Nov 21, 2026
23 of 25 checks passed
@loopx-agent
loopx-agent deleted the codex/fix-v240-wave2-regressions-20261121 branch November 21, 2026 13:04
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.

1 participant