dsh-tool-failure-journal

编码 agent 最棘手的不是单次出错，而是以完全相同的方式反复失败，而每一次的证据都在下一轮尝试中被折叠、压缩、淹没在上下文窗口里。会话日志本身就会被模型重写和裁剪，根本留不住一份可靠的失败史。

dsh-tool-failure-journal 在上下文窗口之外维护一份持久化 JSONL 日志：每一次异常工具调用——无论是抛出异常、输出违反 schema、工具名未知、派发前被拒绝还是调用方取消——都被同步追加到磁盘，进程中途崩溃也不丢失。签名折叠机制将路径、时间戳、UUID 等变量归一化后哈希为稳定 ID，四十次近似失败变成一行带计数和 recurring 标记的记录。此前成功过后来又失败的调用被单独标记为 regression，调用方主动取消则严格区分为 aborted，不污染复发统计。对 EDIT_NO_MATCH、COMMAND_NOT_FOUND、TIMEOUT 等高频失败类型，记录还附带原因和一条与刚才失败动作真正不同的下一步建议。

整套能力通过一个 failure_journal 工具暴露给 agent：stats 一条命令就能让重复错误从五条堆栈变成一行可操作的信号。适合所有使用 DeepSeek Harness 运行编码 agent、希望让失败模式从噪声变成可追踪证据的开发者。