fix: add session-log migration tool for pre-0.1.0 logs (Fixes #19)

[uluckystar]

Fixes #19 — 存量会话日志迁移工具。

背景

0.1.0 及更早版本（以及 #8 修复前的本地构建）写入会话日志的 agent-teams/* 事件没有携带 ignorable 信封标记。harness 的持久化协调器会拒绝解释任何包含"未知且未标记 ignorable"事件类型的日志：

SessionFormatUnsupportedError: ... contains event type "agent-teams/task-created" ...
unknown to this harness and not marked ignorable; refusing to interpret the log

#8/#9 修复了新写入，但存量会话的日志仍然打不开，#19 请求提供迁移工具。

改动

• scripts/migrate-session-logs.mjs（新增，零依赖，仅 Node 内置 zstd）：
  • 解码日志的每个 Zstandard 帧（按 harness JSONL 后端的帧布局扫描）
  • 只给缺失标记的 agent-teams/* 事件插入 "ignorable": true，其余字节原样保留
  • 以"头帧 + 单 body 帧"重新编码（与 harness 读取器兼容，checksum 与写入端一致）
  • 幂等：无缺失标记的日志原样不动（不产生写入）
  • 结构校验：损坏/撕裂帧会报错而不是静默改写
  • 内置 --self-test：内存构造合成日志验证插入与幂等性
• README.md：新增「存量日志迁移」章节，给出 find ... -exec 一键迁移命令与自检方式

验证

• node scripts/migrate-session-logs.mjs --self-test 通过
• 用真实的历史损坏日志（3 条未标记事件）实测：修补成功、无残留未标记事件、首帧合法、二次运行 no-op

[spacexun2]

实测反馈：与你的工具等价的手工修复已在生产环境跑通（2026-08-21）

刚在真实部署上执行了与本工具完全等价的修复（逐帧解码 → 给缺失标记的 agent-teams/* 事件插入 "ignorable": true → 按原帧边界重压缩），结论：

• 8 个真实损坏会话（每会话 7–297 条未标记事件，seq 797–177022）全部修复成功；
• 修复后 73/73 会话通过真实 dsh-session 核心复验（帧解码 + seq 连续 + adoptSessionEvent + 未知类型检查）；
• 幂等性确认：二次运行无变更；事件保留（仅标记忽略），seq 不变；
• 与你的 --self-test 设计一致，工具方向正确。

两点建议：

1. 可扩展覆盖范围：同族"历史不可加载"还有一种成因——插件注入的 user/message 缺 message.id（本部署第 9 个损坏会话，见 [反馈] agent-teams/* 事件导致历史会话重启后无法加载：确认 0.1.0 已修复，但存量会话建议提供迁移工具 #19 评论）。若迁移工具能顺带检测/提示该类问题会更有价值（不一定需要自动修复）。
2. README 的迁移命令建议带 --self-test 前置步骤，并在命令后附验证方法（如修复后二次执行无输出）。

支持合并 —— 这是 #19 的直接解决方案。

[NanmiCoder]

感谢提供历史日志修复工具。自测通过，但我们复现了三种漏修：data 中出现 ignorable 字段、type 不是 JSON 首个键、顶层 ignorable 为 false。请按解析后的事件 envelope 判断，增加默认 dry-run、显式写入和自动备份，并用真实旧日志格式及目标宿主 reader 验证；暂不合入 README 的全目录原地修改命令。这个工具仍有价值，修正后继续审查。