BUG 报告

[yw3l]

一、agent 在 pre-step 被拒时丢弃已排队唤醒消息并报空闲
pre-step 决策被拒时，落在组装窗口内的 followup/steer 被静默丢弃，agent 报空闲但消息未处理。
复现步骤：

1. 注册一个会返回 reject 的 agent/pre-step waterfall 监听器。
2. agent 运行中，在 pre-step 的 systemPrompt.assemble/waterfall await 期间调用 agent.followup(msg)。
3. 令 pre-step 决策被拒。
   实际结果：turn() 在 reject 路径直接返回，不做 inbox.hasPending 检查；wakeDriver() 对运行中 driver 不置 latch。driver 带着非空 inbox 退休，whenIdle() 解析、agent/status: idle 触发，消息滞留到下一次交互。
   预期结果：被拒后唤醒被重新 latch 或由 driver 重新领取，消息在下一个 turn 被处理。
   环境：任意平台；agent-loop 运行中。相关代码 packages/core/agent-loop/src/agent.ts:267（及 :324、:172）。
   验收条件：在 pre-step await 窗口内投递且决策被拒的 followup 最终被处理，或显式进入下一个 turn；whenIdle() 不得在 inbox 非空时解析。

二、persistent bash 超时/部分输出路径丢失命令早期输出
persistent bash 的 fallback 缓冲被后续空操作的 viewport 覆盖，超时与部分输出路径返回空或误导内容。

• 复现步骤：
  1. 通过 persistent bash 运行一条长命令，使其超过 timeoutMs。
  2. 使滚动缓冲在结算前不再包含 start marker（输出量超过保留页）。
• 实际结果：fallback = incremental.delta.length > 0 ? fallback + delta : result.viewport，空操作轮询返回空 delta，用空 viewport 替换首轮积累；partialOutput() 以 fallback 为最后手段时，模型收到空/误导输出，fallbackTruncated 被同步重置。
• 预期结果：fallback 保留命令早期输出，超时/部分输出返回其尾部。
• 环境：任意平台；tool-bash-persistent。相关代码 packages/shell/tool-bash-persistent/src/index.ts:303。
• 验收条件：超时路径下 fallback 含首轮输出；delta 为空时保留已积累缓冲。

三、一次持久化失败使 schedule 定时提醒永久停摆
schedule runtime 在持久化屏障失败后清掉定时器即返回，之后所有定时提醒不再触发。

• 复现步骤：
  1. 配置一条 one-shot 或 fixed-rate 提醒，agent 处于空闲。
  2. 使 ctx.sessions.flush 失败一次（例如存储暂时不可写）。
• 实际结果：driveOnce() 已 clearTimer()，两处 flushSchedulePersistence 失败分支只记日志并返回；requested 已被置 false，retire() 无待办。无定时器、无后续 idle/schedule/change 触发，runtime 永久停摆。
• 预期结果：失败后按有界重试重新 arm，提醒稍后触发。
• 环境：任意平台；schedule 插件。相关代码 packages/schedule/schedule/src/runtime.ts:231、:315。
• 验收条件：注入一次 flush 失败后，runtime 仍会 arm 并在随后触发提醒。

四、E2B 子进程被杀后误报为正常完成（exit 137）
E2B 适配器把被杀命令报成 { exitCode: 137, signal: null }，与本地 provider 报 { exitCode: null, signal } 不一致。

• 复现步骤：
  1. 在 E2B 沙箱运行长命令（如 sleep 60）。
  2. 从宿主对其实进程组发起 SIGKILL。
• 实际结果：远程包装非 exec，SIGKILL 后 wrapper 存活并写入 $?=137；commandOutcome 的 publishedExitCode !== undefined 分支忽略 terminationSignal，返回 { exitCode: 137, signal: null }。下游 bash-local 消费者把 proc.status 判为 'completed'，模型看到 [exit code: 137] 而非 kill 标记。
• 预期结果：两个 provider 对同一杀法报一致的独立事实（{ exitCode: null, signal: 'SIGKILL' }）。
• 环境：E2B sandbox。相关代码 packages/e2b/subprocess-e2b/src/process.ts:548（及 :527、:612）。
• 验收条件：同一 kill 在两个适配器产生相同的 { exitCode, signal }；terminationSignal 已设置时优先报告信号。

五、原子写未同步父目录，断电后已报告成功的写入可回退
writeFileAtomic rename 后不 fsync 父目录，断电可撤销已确认成功的写入。

• 复现步骤：
  1. POSIX 上通过 writeFileAtomic 写入文件并确认成功。
  2. 在 rename 落盘前断电。
• 实际结果：临时文件已 fsync，但目录条目未同步；断电后 rename 可被撤销，文件静默回退旧内容，下一次受保护写入报 FS_STALE_VERSION。同仓 storage-json/session-persistence-jsonl 均同步目录，此处未同步。
• 预期结果：rename 后同步父目录，断电后写入保持。
• 环境：macOS/Linux。相关代码 packages/fs/fs-local/src/fsio.ts:593。
• 验收条件：写成功后目录条目持久；或故障注入验证 fsyncDirectory 被调用。

六、spill 保存文件未 fsync，崩溃后日志定位符指向缺失文件
saveTextFile 返回定位符前不 fsync 文件与目录，崩溃后恢复工件可能缺失。

• 复现步骤：
  1. 触发溢出 spill（如超大 grep 输出），保存完整结果到 spill 文件。
  2. 在工具结果返回后、操作系统落盘前崩溃。
• 实际结果：saveTextFile 以 'wx', 0o600 打开、写入、关闭即返回 { path, bytes }，无 handle.sync() 与目录同步；日志中 "Full formatted result stored at: " 指向缺失或空文件，恢复路径失效。兄弟包 attachment-local 返回前会同步文件与两级目录。
• 预期结果：返回定位符前同步文件与父目录，崩溃后文件存在且完整。
• 环境：任意平台。相关代码 packages/spill/spill-local/src/store.ts:113。
• 验收条件：崩溃后定位符对应文件存在；写入在返回前达到持久。

七、SDK 会话 run 等待 idle 无期限，wedged runtime 挂起调用方
HarnessSession.run 等待 session.status: idle 无客户端期限，runtime 卡死时调用永不返回。

• 复现步骤：
  1. 使 runtime 的轮次永不回到 idle（模型流挂起或 agent 循环无法收敛）。
  2. 调用 harness.session(id).run(prompt)。
• 实际结果：client.prompt 受 requestTimeoutMs 约束，但等待 idle 通知的循环无任何 deadline；调用永不 settle，自动化调用方无法放弃。
• 预期结果：提供调用方可控的 idle 等待期限选项（含文档化默认值），超时以明确错误返回。
• 环境：任意平台。相关代码 packages/sdk/client/src/api.ts:169。
• 验收条件：设置期限后 run 在期限内 settle 或抛出超时错误；默认行为向后兼容。

八、审计发现 9 项低危缺陷，当前不阻断发布，建议随相关改动修复。

• 复现步骤：
  1. session-persistence-jsonl：日志文件被外部删除后，下次 append 静默重建、无会话头，再加载报 corrupt（packages/session/session-persistence-jsonl/src/index.ts:654）。
  2. session-projection-cache：markClean 在持久化屏障/store 写入成功前重置脏计数，写入失败不重试（packages/session/session-projection-cache/src/index.ts:141）。
  3. llm：adapterStream 清理期 await close() 无防护，第三方适配器 .return() 抛错会替换消费者结果（packages/llm/llm/src/index.ts:894）。
  4. subprocess-local：spawn 失败不封口 collect 模式 spill 文件，每次失败泄漏一个 fd 与临时文件（packages/subprocess/subprocess-local/src/spawn.ts:484）。
  5. terminal-bash：异步后端下，超时与在途写竞态令 active 槽残留，后续发送全报 SEND_ACTIVE（packages/terminal/terminal-bash/src/session.ts:251）。
  6. workflow-worker-thread：agentsStarted 计入启动被拒或失败的孩子（packages/workflow/workflow-worker-thread/src/host.ts:338）。
  7. timeout-policy：在 abort 时抛错的工具丢失 TOOL_TIMEOUT 分类（packages/guard/timeout-policy/src/index.ts:67）。
  8. apiproxy SSE：读取器只按 \n\n 切帧，CRLF 帧会停摆流并无限增长缓冲；当前同仓服务端只发 LF，属潜伏隐患（packages/host/apiproxy/src/fetch/client.ts:387）。
  9. sdk/protocol：入站缓冲无上限，未终止的超大帧无防护（packages/sdk/protocol/src/transport.ts:175）。
• 实际结果：各项影响见上；均不改变正常路径行为。
• 预期结果：随相关改动逐项修复或显式接受为已知限制。
• 环境：任意平台。
• 验收条件：按项逐条关闭。