Files

T

weichen 36793a4ea5 fix(tooling): emit NDJSON MCP responses for agentctl and jev

Cursor IDE loads pi-subagents (NDJSON) but not agentctl/jev which replied
with Content-Length framing. Align send() and mark type=stdio in mcp.json.

2026-09-24 10:39:43 +00:00

4.8 KiB

Raw Blame History

PI Subagent 执行器初版边界审查

task_id：subagent-workflow-standard-2026-09-24；issue_id：ISSUE-20260924-pi-executor-boundaries。 owner：Cursor（修复）/ Codex（复核）；issue_state：resolved；severity：high。本记录针对尚未发布的执行器初版，不表示 dev 或产品 Runner 存在这些实现。

事实与机制

独立验证发现 PI 内置工具的路径规范化与扩展守卫不一致。安装版本 0.85.1 的 tools/path-utils.js 中 resolveToCwd 使用 stripAtPrefix 并展开 home；初版守卫使用 path.resolve(root,input)。
以专门创建的 /tmp/pi-guard-audit-* 临时目录及 outside.txt 假文件测试 @绝对路径，实际结果为 guard_blocked=false、actual_tool_path_escapes=true。没有读取真实密钥或业务文件。
同类范围：@ 前缀、~ 前缀、相对父路径、符号链接、Unicode/读取路径规范化；MCP 的同仓/工作区验证和临时文件写入；报告幂等与损坏收据；进程树/输出上限/环境变量隔离。
初版静态阅读另发现：跨仓 MCP 可能执行目标仓脚本；输出仅在 communicate 完成后截断；只回收仍存活 leader 的进程组；测试环境黑名单不足；模型报告用关键词推导 PASS。上述需要实现修复和负例，不以本行代替实测。
初版测试夹具存在 eager stderr.read()，在 MCP 仍存活时阻塞。host 两次仅终止 /tmp/pi-subagent-test-* 的假 MCP 子进程以释放测试，未终止产品或用户进程。

复现与迭代

初次 RED：19 项，7 failures / 11 errors，主实现未创建；存在性/调用失败为已缺失功能，不当作实现通过。
初版回归：19 项，4 failures / 7 errors；耗时含夹具死锁处理。后续错误数不作为发布质量结论，待主机完整重跑。
Cursor 首轮 supervisor 已由 host 为明确的修复交接发送 TERM，退出143；源文件保留。没有未知写副作用后盲目重派，第二轮是带具体修复清单的新执行。
本机 Qwen3.8-Flash、GLM-5.3-Flash 无工具短请求连通通过，实际 provider/model 与配置一致，正常 stop + agent_end/agent_settled。仅连接证据。
GLM-5.3 对初版整包快照的只读审查 300 秒超时，无完整结论；不报审查 PASS。进程由 subprocess 超时处理结束，未授予工具，无仓库写入。

修复与验收要求

Cursor 修复清单已交接：统一/拒绝路径规范化；MCP 同仓注册验证和无租约写入；有界双向进程通信/整体回收；测试环境白名单；严格请求/配置与冻结 SHA；损坏收据禁止重派；报告完成与审查通过分离；最终事件完整性；禁用 PI 隐式重试；相关真实 Git/进程/MCP 回归。

关闭条件：静态发现均落实对应修复或有证据排除；原例与同类负例通过；真实 PI 调用经新执行器完成；审查与测试报告保存。修复中，不新增 validated 经验；验证后再总结。

2026-09-24 修复关闭

issue_state=resolved 仅针对未发布初版的约定缺陷；代码提交 69ffaa677e23a1dd9aa0528bb09b3acfcd38b119，主机完整工程回归 173 项通过，提交后专项 34 项通过；最终 Cursor CLI→MCP→PI 中 ls/read 全通过。实际覆盖、早期失败和独立 GLM 审查边界见报告。新增经验。本文件前面的“修复中/待验证”为初版历史，当前结论以本节为准。dev 集成/客户端 IDE 验收不由本问题关闭状态推导。

cursor-cli-mcp-path

issue_id：ISSUE-20260924-cursor-cli-mcp-path；issue_state：deferred；severity：medium；owner：工程维护；日期：2026-09-24。本机 Cursor CLI 2026.09.18 在项目 MCP args 中未展开 workspaceFolder 变量，原样传给 Node。pi-subagents 新入口已改工作区相对路径并实测通过。同类只读检查：agent mcp list 也显示既有 agentctl / jev Connection failed，它们仍使用相同变量写法；codegraph ready。未进一步修改/验收这两个既有服务，也未断言 IDE 同样失败。官方支持声明与本机观测须分开。此残差不阻塞 PI MCP（其内部直接调用主仓治理 CLI），不构成本轮产品发布结论；后续由工程维护在 Cursor CLI 升级或这两项 MCP 接入验收时检查路径/stdio 协议，形成独立修复与实际客户端证据。仅保留问题，不宣称已修复。

cursor-cli-mcp-path 续：NDJSON 回包

2026-09-24 IDE：pi-subagents/codegraph ready；agentctl/jev 不在 MCP 缓存。根因补充：后两者 send() 使用 Content-Length 帧，而可加载的 pi-subagents 使用换行分隔 JSON-RPC。已改为 NDJSON 回包并补 "type":"stdio"；仍接受 Content-Length 请求。单元：scripts/tests/test_mcp_ndjson_framing.py。IDE 重载后需再核 list-tools。

4.8 KiB Raw Blame History Unescape Escape