用途：按 IRS 合规规则计算资本利得，处理加密货币及证券的成本基础与卖出交易。
主要能力：从 normalized/cost-basis.json 读取批次、从 normalized/transactions.json 读取交易；构建卖出列表并按资产以 FIFO 分配批次；按持有期将每笔收益分类为短期或长期；对证券检测 30 天内的洗售，加密货币按当前政策标记为不适用；将收益写入 normalized/capital-gains.json，更新后的批次写入 normalized/cost-basis-updated.json；生成 Form 8949 输出与汇总。
使用方式：运行 pnpm gains 构建 FIFO 收益与更新批次；运行 pnpm report 生成 Form 8949 与税务汇总。输出文件包括 reports/tax-ready/form-8949-c.csv、reports/tax-ready/turbotax-import.csv、reports/tax-ready/schedule-d-summary.md，相关脚本为 scripts/calculate-gains.ts 与 scripts/generate-report.ts。
适用场景：需要按 FIFO 与持有期规则整理加密资产或证券资本利得、准备报税表格与导入文件的场景。
限制：洗售检测仅适用于证券，加密货币按当前政策不适用；具体税务处理与合规性需以实际法规和专业意见为准，资料未提供更多平台、收费或效果信息。