用途：cost-diff 是 PR 级别的成本回归检测工具，比较两份具体已知基线的成本快照，而非假设基线或历史均值。它消费 cost summary --format json 的稳定 JSON 契约。
主要能力：加载 --baseline 与 --current 两份 JSON 快照，校验两者都含 total_cost_usd 与 sessionCount；按 byTier（haiku/sonnet/opus）与 byModel 逐键计算差异；每项标记为 added / removed / changed；结果按 |delta| 降序排序，使最大变动排在最上；baseline 与 current 均为零的条目不展示。
用法：典型 PR 门禁流程为在主分支执行 cost summary --format json > baseline.json，在 PR 分支生成 current.json，再运行 cost diff --baseline baseline.json --current current.json --alert-on-pct 10 --alert-on-usd 5.00。--alert-on-pct N 在 total_pct > N 时退出 1；--alert-on-usd N 在 total_delta_usd > N 时退出 1；两者可同时设置，先触发者生效，任一信号独立失败即为 OR。--alert-on-class-pct 可检查单一令牌类别增长，如 cache_write:50,output:25，首个越界类别生效，有效类别为 input | output | cache_write | cache_read。
适用场景：用于确认某次 PR 是否相对 main 增加了支出，防止百分比小但绝对额大、或绝对额小但增幅大等回归被漏掉。
限制：退出码 0 表示无报警或未设阈值，1 表示阈值超限，2 表示配置错误（文件缺失、JSON 无效或快照格式错误）。快照需保持 cost-summary 的 JSON 形状，新增字段可以，重命名或删除字段不行。其余信息暂未提供。