feat: reply.raw 原生能力逃生舱 + 全自动 Raw 泛型（v3.1.0）

[yourtion]

概述

v3.0 的标准化抽象（Reply）只有 status/json/send 三个方法，导致 setCookie、redirect、流式响应等底层能力在 registerTyped handler 里完全无法访问。逐个补 Reply 方法不可行——三框架签名永远对不齐（Express res.cookie() / Koa ctx.cookies.set() / leizmweb 各不同）。

本 PR 引入框架泛型驱动的 reply.raw 逃生舱，让 handler 能拿到强类型的原生对象；同时审计三框架能力差异，提供可选的统一错误格式器。非破坏性（现有 new ERest() 代码零改动）。

设计文档：docs/superpowers/specs/2026-06-29-raw-escape-hatch-and-capability-alignment.md

主要变更

1. reply.raw 逃生舱

• Reply<Raw> 接口新增 readonly raw: Raw 字段，handler 通过 reply.raw 访问原生对象
• Context.reply 保持 Reply<unknown> —— before/middleware/hook 不暴露 raw（仅 handler 拿，避免 onError 与 re-throw 双重写入）

2. 全自动 Raw 泛型 + createERest() 工厂

• ERest<T, Raw> / API<T, Raw> / IGroup<T, Raw> / genSchema<T, Raw> 全链路透传 Raw
• 三子包各导出 createERest()，构造时锁定 Raw，handler 内 reply.raw 零标注强类型：

import { createERest } from "@erest/express";
const api = createERest({ info, groups, forceGroup: true });
api.api.post("/login").group("auth").registerTyped({ body: S }, (req, reply) => {
  reply.raw.res.cookie("token", jwt, { httpOnly: true });  // 自动推导 { req, res }
});

• 裸 new ERest() 标记 @deprecated（过渡期保留，Raw 默认 unknown）

3. 可选 defaultErrorFormatter

工具函数（不改 adapter、不破坏 re-throw 对齐），用户在 app 级错误中间件调用统一三框架错误响应体。

4. 三框架能力速查表

cookie/stream/redirect 差异统一通过 raw + README 速查表暴露，不再逐个补 Reply 方法。

附带

• 727b2c0：leizmweb 错误处理对齐 express/koa（re-throw 给 app 级错误中间件）
• 各包 bump 至 3.1.0，MIGRATION.md 新增 3.1.0 changelog

测试

• 核心库 276 测试全通过（新增：raw 三框架集成 3 + 类型推导 2 + 错误格式器 4）
• examples 13 测试全通过（验证 new ERest() 向后兼容）
• tsc --noEmit 全量通过
• 最终 code review 已处理：测试无效错误码、断言注释、MIGRATION 文档

不在范围

• ❌ 给 Reply 补 cookie()/redirect() 等方法（三框架签名永远对不齐）
• ❌ adapter 内置错误格式化（破坏 re-throw 对齐）
• 📝 测试文件未纳入类型检查（既有基础设施缺口，非本 PR 引入，留后续）

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 91.64%. Comparing base (7728444) to head (72b869e).

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #191      +/-   ##
==========================================
+ Coverage   91.59%   91.64%   +0.04%     
==========================================
  Files          28       28              
  Lines        2821     2837      +16     
  Branches      719      722       +3     
==========================================
+ Hits         2584     2600      +16     
  Misses        235      235              
  Partials        2        2              

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.