@agentunion/fastaun-browser 0.5.18 → 0.5.20

package/CHANGELOG.md

@@ -4,85 +4,178 @@
 
 格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)；版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。
 
----
-
-## 0.5.18 — 2026-10-06
-
-### 新功能
-
-#### Owner relation 与 AID 注册编排
-- 新增 `register({aid, type, owner?, ...})`，由 SDK 编排 `auth.aid_register_prepare` → `auth.aid_register_submit` → 带 `ownerOperationId` 的 agent.md 上传 → `auth.aid_register_activate`；保留 `register(aid)` 的 legacy 兼容语义。
-- 新增 `bindAid`、`getAidBindingStatus`、`resumeAidBinding` 和 `changeOwner`，分别覆盖已有 `legacy_unbound`/`unbound` AID 的绑定、状态查询、operation 恢复和三方换 owner；绑定不重新签发证书。
-- 注册规则明确 human 不得指定 owner，非 human 必须指定 owner，只有 agent 支持 self-owner；外部 owner 需要 subject 与 owner 双签，换 owner 需要旧 owner、subject、新 owner 签名及 `expected_relation_version` CAS。
-- 新增 ownership proof canonical bytes、`factHash`/`statementHash`、UUID v4 `proofId` 和签名封套校验；AID 统一规范化为小写，普通 agent.md 更新保留现有 proof，不能通过普通 PUT 改 owner。
-- owner operation 有效期为 7 天；pending、失败或过期期间证书、登录、连接和基本消息通信保持可用，关系状态可查询并从 operation ID 恢复。
-
-#### Owner relation Storage 与审计门面
-- 补齐 `storage.relation_backup_provision`、`relation_backup_revoke`、`relation_backup_status` 的 SDK 契约和集成验证；关系目录固定为 `.aun/subjects/<lowercase_subject_aid>`，撤销只回收 ACL、保留数据并递增 ACL generation。
-- `MessageFacade` 和 `GroupFacade` 新增 `getAuditStatus`，统一映射对应的审计状态 RPC。
-
-### 修复
-
-#### 证书与签名安全
-- `AID.sign` 拒绝无效、过期或尚未生效证书；新增 `verifyWithContext`，绑定 expected AID、完整证书指纹、签名时间及当前有效性选项。
-- RPC client signature、事件签名和 agent.md 签名路径增加证书有效期检查，并统一处理 `signature_verification_unavailable`、`type_change_blocked`、`aid_binding_required` 等关系错误。
-
-#### V2 消息同步与投递
-- P2P/Group V2 Pull 增加有界生产者消费者流水线、volatile cursor 去重、epoch mismatch 单次重试和后台 gap fill；`background_sync` 关闭时不再隐式启动后台补齐。
-- inline push 在终态解密失败时仍提交连续序号并保留 ACK pending；Push、Pull、sender IK 延迟恢复共用去重和并发占用状态，减少交错投递重复。
-- 当前设备 self-sync 消息只推进本地发布序号而不重复投递，其它设备仍可收到；公开 payload 保留 `sender_device_id` 和 `direction`，继续隐藏内部 slot 字段。
-
-#### 会话、设备与连接生命周期
-- 加强 slot ID/full slot ID 隔离，支持 long/short connection、short TTL 和 `background_sync` 组合；重连任务增加所有权、代际保护和旧连接结果隔离。
-- 连接阶段暂存 Push，待应用监听器注册后排空，降低 `delivery.changed` 丢失和竞态；补齐多设备明文 P2P/Group self-sync 边界。
-
-### 改进
-
-- 四端公开类型和结果继续对齐 volatile cursor、ACK、设备来源及审计状态；当前 CA/Name Service 仅实现 `signing` 与 `group_identity` 证书用途，`org_identity` 不作为已实现能力暴露。
-- SDK、锁文件、运行时版本、V2 E2EE envelope `sdk_version` 和 conformance 期望统一更新为 `0.5.18`。
-
-### 测试
-
-- 新增 ownership proof 四端 golden vector、大小写 AID、非法 UUID/控制字符和跨 SDK 验签测试。
-- 增加 JavaScript owner relation 集成测试，覆盖新注册、self-owner、外部 owner 双签、legacy bind、operation 恢复、换 owner、unbind、Storage ACL/数据保留和重建访问。
-- 扩展证书有效期、上下文验签、审计 facade、V2 Pull/Push、volatile 分页、设备隔离、连接代际和浏览器 E2E/conformance 测试。
-
-## 0.5.17 — 2026-09-19
-
-### 新功能
-
-#### 非持久消息与设备定向
-- 正 `ttl` 的 V2 加密消息会透传到最终发送 RPC；`storage=volatile` 消息使用独立 volatile cursor 拉取和 ACK，不进入持久 `seq`、seq-tracker 或持久水位。
-- Push、Pull 和 sender IK 延迟恢复共用按消息去重及并发占用状态；纯 volatile 页可独立续页，cursor epoch 不匹配时清空旧 cursor 并重试一次，切换 AID、设备或 slot 时重置本地 volatile 状态。
-- `message.v2.pull` / `message.v2.ack` 接入公开调用管线和实例上下文校验；`message.ack` 支持只提交 `volatile_cursor(s)` / `volatile_ids`。
-- V2 `message.send` 支持 `device_id` / `to_device_id` 定向接收设备，同时保留发送方 self-sync 和 audit recipients；应用消息公开规范化的 `sender_device_id`，不再暴露内部 slot 字段。
-
-#### 群管理与 agent.md 事件
-- `GroupFacade` 新增 `block`、`unblock`、`getBlocklist`、`reportStatus` 和 `getMemberStatuses`；屏蔽、禁言和成员状态可通过高层 SDK 直接调用。
-- 远端 agent.md 已有版本的 ETag 或 Last-Modified 变化时，通过应用事件管线发布 `agentmd.changed`。
-
-### 修复
-
-#### Storage / Group FS 上传 Content-Type
-- `writeBytes`、`uploadFile` 和 Group FS 上传在未显式指定类型时按实际字节识别 MIME，并以路径后缀作为回退。
-- 上传会话、HTTP PUT 和 `completeUpload` 使用同一 Content-Type；保留 session 的其它 header 并替换冲突的 Content-Type，修复 OSS 预签名校验不一致导致的 403。
-
-#### 群身份恢复
-- 匿名群创建在 RPC 前持久化群密钥并复用稳定的 `_create_request_id`，响应丢失后的重试不会重复创建群；命名群恢复可复用已保存身份。
-- 新群主收到 `owner_transfer_rekey_pending` 后只自动完成一次转让；重连时即使服务端角色仍为 member，也会按本地 pending 状态续跑 `complete_transfer`。
-
-### 改进
-
-- Message、SendResult、PullResult 和 AckResult 类型补充 volatile 元数据、cursor、ACK 结果及 `sender_device_id`；`status` 接受 `accepted`。
-- SDK、锁文件、运行时版本、V2 E2EE envelope `sdk_version` 和 conformance 期望统一更新为 `0.5.17`。
-
-### 测试
-
-- 增加 volatile Push/Pull/ACK、纯 volatile 分页、cursor 恢复、并发去重、定向设备和公开字段边界测试。
-- 增加群屏蔽/禁言/成员状态、匿名创建幂等、群主转让自动完成与恢复测试，并扩展浏览器 E2E 覆盖。
-- 增加 Storage/Group FS MIME 与 Content-Type 一致性测试及 conformance 版本验证。
-
-## 0.5.16 — 2026-09-16
+---
+
+## 0.5.20 — 未发布
+
+> 基线：2026-10-12 发布的 npm `0.5.19`，发布包已与仓库快照 `ab05792f` 核对；本节整理 2026-10-15 工作区的 SDK 增量。
+
+### 新功能
+
+#### 通用签验与文档多签
+- 新增异步 `AIDStore.sign/verify`，支持 `raw/document`、显式 `text/file` 输入、分离签名、TAG 和追加签名；raw 文件保留二进制，`file://` 文本按字面处理，文件就地签署使用显式可写文件句柄。
+- 文档每一签覆盖此前完整字节前缀，附签必须包含 `signer_aid`；按签名 AID 和精确证书指纹逐签验证，尾签块总量限制为 2048 bytes。`agent.md` 与 Ownership 文件复用通用签验核心。
+
+### 修复
+
+#### 消息同步、已读事件与设备
+- Pull Gate 改为同 namespace 单飞、每客户端最多 4 个 namespace 并发；群事件与群消息使用独立 namespace，保留前台优先和同级 FIFO，超时任务结束前不释放同 namespace。
+- 后台补拉保留目标上界和 `has_more/remaining`，超过默认页预算、小页／空页或暂时失败后继续调度；RPC 响应、前台排空和 gate 空闲触发恢复，关闭后台同步或切换身份、连接时废弃旧代任务。
+- Forward 末页发布并持久化水位后独立发送最终累计 ACK，移除为提交 ACK 而发起的额外空 Pull；分页只捎带已提交水位，volatile 页消费后按最新 cursor 续拉。
+- `message.read_changed`、`group.read_changed` 和 `read_state_sync` 在出队及每个处理器执行前复核身份代次；首次合法 raw 已读事件同时交付应用事件和协议镜像，避免身份切换后交付旧事件或漏发首次更新。
+- 显式定向设备发送遇 bootstrap 缓存缺少目标时仅强制刷新一次；无定向、已强制查询及其他加密错误不额外重试。
+
+#### agent.md 与本地草稿
+- 自有 AID 默认 resolve 优先返回 IndexedDB 中的草稿／正文，读取不依赖联网或仍有效的私钥、证书；显式 refresh 和远端身份继续下载。
+- 候选稿在网络预检前保存，失败稿由显式 upload 重试；下载和连接自动恢复不覆盖、重传失败稿，只有权威确认精确同一候选后才清除，旧上传完成不删除较新草稿或 pending。
+- 损坏草稿元数据返回 `persistence_unavailable`；草稿失败不阻断独立 Ownership 任务和实体生命周期 checkpoint。
+- 历史名片读取兼容缺失 Schema、旧指纹／CN 和旧群单签，按签署时间核验证书并隔离历史兼容缓存；新上传及现代实体多签保持严格校验。
+- group/org 名片改为实体私钥主签、当前 owner 使用本人 token 上传，可选追加 owner 附签；移除实体额外 V2 上传授权，拒绝 owner 直接替代实体主签。
+- 多签上传和重试保留原始字节；普通正文更新保留既有 owner／ownership 材料并使用原 ETag CAS。下载协商 `multi-v1`，兼容响应头大小写，304 缺少本地正文时重新获取。
+
+#### Ownership 2.1 共识与恢复
+- 权威读取核对 NS 原 ETag、owner 当前完整原文、摘要和存在性，使用 head/get/head 并在验签后复读；30 秒观察窗口包含首次网络等待，不再以 Storage `revision/object_id` 作为共识依据。
+- owner.md 改走上传会话、HTTP PUT 和 `complete_upload`，使用 `expected_version` 条件提交；写前复查原件，CAS 冲突保留为 conflict，共识结果移除 `owner_md_revision`。
+- pending 绑定起始完整快照和原始声明，不能因 owner 或数字版本相同复用旧审批；release 保持 base 版本，sub 清理后投影归零，新绑定从 1 开始，未清理的旧 release 不覆盖新关系。
+- released 共识、恢复及清理均复核当前文件和新鲜证书状态；不能仅凭解锁认定完成或补造历史完成证据。损坏任务保留并失败关闭，其他 subject 任务仍可恢复。
+- 补齐 PKI critical extension、BasicConstraints、KeyUsage 和路径长度校验，当前权威证书读取不复用历史兼容缓存或接受重定向。
+
+#### 凭证、组织请求与实体恢复
+- `request_binding` 最长 300 秒，admission 不超过成员 binding 截止时间；完整 verify 返回前重查异步等待后可能过期的凭证、状态证明和请求绑定，复用本轮已解析证书及限流结果。
+- 已有合法 `client_signature` 保留并核对实际请求，冲突直接拒绝；服务事件限制白名单，规范化 AID 大小写并去重目标集合。
+- 组织门面分离本地 `aidStore` 参数时保留显式 null；转让缺少替代成员材料先拒绝，checkpoint 已存在但私钥丢失时不生成替代密钥。
+
+### 兼容性与语言边界
+
+- 显式登记允许 agent 不指定 owner；human 仍禁止 owner，group/org 仍要求 owner，无 owner 的 agent 不创建 Ownership 待续跑意图。
+- 签验和证书解析继续使用异步 WebCrypto；文件输入使用浏览器对象／句柄，持久草稿和 Ownership 任务使用 IndexedDB，不引入 Node.js 路径接口。
+- 包配置、锁文件、运行时 `VERSION`、V2 envelope 的 `sdk_version` 及加密 conformance 期望统一为 `0.5.20`。
+
+### 测试
+
+- 扩展通用签验、多签原文、历史证书、离线草稿、损坏元数据、Ownership 原件 CAS／清理重绑、请求时效及实体恢复测试。
+- 扩展 namespace 并发、后台续拉、末页 ACK、volatile cursor、已读事件逐处理器代次隔离和定向设备 bootstrap 测试，并更新浏览器离线 Ownership 用例。
+- 共享 Ownership 向量和 cross-SDK agent 接入公开 Store 签验；增加四语言签验及 Name Service 多签矩阵入口，测试落点与执行边界见 Python parity 文档。
+
+## 0.5.19 — 2026-10-12
+
+> 基线：`0.5.18` 的仓库快照 `1f03bf2d`；本节整理 2026-10-11 工作区的 SDK 增量。
+
+### 新功能
+
+#### 跨设备已读未读
+- 新增 `MessageFacade.read/readState`、`GroupFacade.read/readState`，分别上报话题的 `last_read_message_id`、查询当前 AID 的跨设备汇总及当前设备 seq 映射；业务已读状态独立于消息 ACK、Pull 游标和群事件游标。
+- 消费 `message.read_changed`、`group.read_changed`，按公共 `last_read_order` 单调更新缓存并抑制重复／倒序事件；切换 AID 或设备时隔离缓存和在途查询结果。
+- 重连后补查已登记的话题并发布本地 `read_state_sync` 完成事件，携带汇总状态及逐项错误；保留 `current_device_seq=null` 和 `mapping_status`；超过安全整数范围的公共顺序和设备 seq 保留为精确十进制字符串。
+
+#### Ownership 2.1 管理
+- 新增 `bindOwneraid`、`bindSubaid`、`releaseSubaid`、`transferSubaid`、`acceptOwnershipRequest`、`rejectOwnershipRequest` 和 `checkOwnershipConsensus`，覆盖双向发起绑定、释放、转移、审批和独立共识检查。
+- 关系依据 sub 的 NS `agent.md` 与 owner 的 `sub_aids/{sub_aid}/owner.md`；使用本人尾签、`relation_version`、owner 锁、NS ETag 和 Storage revision CAS 验证及提交，不依赖旧 Auth owner operation。
+- `aun.ownership.sdk.v1` 控制消息走加密消息通道，由 SDK 消费；审批、inbox/outbox、待提交原始字节和步骤先持久化到 IndexedDB，连接后续跑。任务完成需要重新读取权威文件验证目标共识，不能由通知或发送成功推断。
+- 新增 `ownership.request/action_required/progress/completed/rejected/stopped/error` 应用事件；group/org 使用专属生命周期，通用 Ownership 2.1 返回 `not_applicable`。
+
+#### 凭证与组织服务
+- 增加 `credential` 门面的 `create`、`verifySignature`、`verify`、`verifyRegistrationReceipt` 及登记、撤销、状态／撤销列表 RPC；区分离线签名校验和包含凭证链、实时状态、能力范围、实际请求绑定的完整验证。
+- 增加 `org.lifecycle/member/credential/authz/audit` 门面、组织请求准备、成员双签绑定和转让接受签署；组织请求绑定目标服务、nonce、请求摘要及必要的代表证明，并进入统一客户端签名管线。
+- 组织／群身份由当前 owner 持有；专属转移强制 rekey。实体 `agent.md` 由 owner 使用本人证书和私钥代签、代上传，绑定 `signer_aid`、实体证书指纹及上传授权，失败阶段可恢复。
+- `org.*` 与 `credential.revoked` 事件在进入应用事件队列前验证签发服务、接收身份、证书、时间窗口及签名，并按服务／事件／接收身份去重。
+
+### 修复
+
+- Ownership 控制消息落盘或处理失败时保留有序队列／sender IK 待重试项，避免提前提交交付水位或 ACK；V2 解密保留控制消息原始 JSON，供重复键和严格字段校验。
+- Ownership 证书验证绑定当前证书代际、生命周期状态和可信吊销证据；普通名片上传与关系字段变更分开，实体解散或身份失效后清理相应本地状态。
+- 错误映射优先保留服务端 `data.retryable`，组织请求采用一致 canonical JSON 和请求参数摘要。
+
+### 兼容性与语言边界
+
+- `AIDStore.register(aid, {type, owner?, exttype?})` 登记接口改为显式传入 type；human 禁止 owner，agent/group/org 要求 owner。登记意图持久化后由连接期续跑关系流程，group/org 交给各自生命周期。
+- 旧 `auth.aid_register_*` / `auth.aid_bind_*` 关系编排已移除；`bindAid`、`bindOwner`、`releaseOwnership` 的 legacy 入口返回 `unsupported_protocol`，调用方应迁移到本节的 2.1 管理 API。
+- 浏览器的凭证创建、成员绑定、转让签署及验签 helper 使用异步 WebCrypto；Ownership 任务、revision CAS 和登记意图保存到 IndexedDB。
+- 组织创建、接受转让及解散可通过 `aidStore` 接入实体身份编排；`org.resource/task/host/workflow` 当前通过 `client.call` 使用。
+- 包配置、锁文件、运行时 `VERSION`、V2 envelope 的 `sdk_version` 及加密 conformance 期望统一为 `0.5.19`。
+
+### 测试
+
+- 增加 Ownership 2.1 和组织／凭证协议的跨语言共享向量、严格解析、签名／吊销、CAS、审批与重连恢复测试。
+- 扩展已读状态门面、单调缓存、身份切换、重连补偿、组织实体身份及服务事件验签测试；配套单域、浏览器、cross-SDK 和双域测试入口列于 Python parity 文档。
+
+## 0.5.18 — 2026-10-06
+
+### 新功能
+
+#### Owner relation 与 AID 注册编排
+- 新增 `register({aid, type, owner?, ...})`，由 SDK 编排 `auth.aid_register_prepare` → `auth.aid_register_submit` → 带 `ownerOperationId` 的 agent.md 上传 → `auth.aid_register_activate`；保留 `register(aid)` 的 legacy 兼容语义。
+- 新增 `bindAid`、`getAidBindingStatus`、`resumeAidBinding` 和 `changeOwner`，分别覆盖已有 `legacy_unbound`/`unbound` AID 的绑定、状态查询、operation 恢复和三方换 owner；绑定不重新签发证书。
+- 注册规则明确 human 不得指定 owner，非 human 必须指定 owner，只有 agent 支持 self-owner；外部 owner 需要 subject 与 owner 双签，换 owner 需要旧 owner、subject、新 owner 签名及 `expected_relation_version` CAS。
+- 新增 ownership proof canonical bytes、`factHash`/`statementHash`、UUID v4 `proofId` 和签名封套校验；AID 统一规范化为小写，普通 agent.md 更新保留现有 proof，不能通过普通 PUT 改 owner。
+- owner operation 有效期为 7 天；pending、失败或过期期间证书、登录、连接和基本消息通信保持可用，关系状态可查询并从 operation ID 恢复。
+
+#### Owner relation Storage 与审计门面
+- 补齐 `storage.relation_backup_provision`、`relation_backup_revoke`、`relation_backup_status` 的 SDK 契约和集成验证；关系目录固定为 `.aun/subjects/<lowercase_subject_aid>`，撤销只回收 ACL、保留数据并递增 ACL generation。
+- `MessageFacade` 和 `GroupFacade` 新增 `getAuditStatus`，统一映射对应的审计状态 RPC。
+
+### 修复
+
+#### 证书与签名安全
+- `AID.sign` 拒绝无效、过期或尚未生效证书；新增 `verifyWithContext`，绑定 expected AID、完整证书指纹、签名时间及当前有效性选项。
+- RPC client signature、事件签名和 agent.md 签名路径增加证书有效期检查，并统一处理 `signature_verification_unavailable`、`type_change_blocked`、`aid_binding_required` 等关系错误。
+
+#### V2 消息同步与投递
+- P2P/Group V2 Pull 增加有界生产者消费者流水线、volatile cursor 去重、epoch mismatch 单次重试和后台 gap fill；`background_sync` 关闭时不再隐式启动后台补齐。
+- inline push 在终态解密失败时仍提交连续序号并保留 ACK pending；Push、Pull、sender IK 延迟恢复共用去重和并发占用状态，减少交错投递重复。
+- 当前设备 self-sync 消息只推进本地发布序号而不重复投递，其它设备仍可收到；公开 payload 保留 `sender_device_id` 和 `direction`，继续隐藏内部 slot 字段。
+
+#### 会话、设备与连接生命周期
+- 加强 slot ID/full slot ID 隔离，支持 long/short connection、short TTL 和 `background_sync` 组合；重连任务增加所有权、代际保护和旧连接结果隔离。
+- 连接阶段暂存 Push，待应用监听器注册后排空，降低 `delivery.changed` 丢失和竞态；补齐多设备明文 P2P/Group self-sync 边界。
+
+### 改进
+
+- 四端公开类型和结果继续对齐 volatile cursor、ACK、设备来源及审计状态；当前 CA/Name Service 仅实现 `signing` 与 `group_identity` 证书用途，`org_identity` 不作为已实现能力暴露。
+- SDK、锁文件、运行时版本、V2 E2EE envelope `sdk_version` 和 conformance 期望统一更新为 `0.5.18`。
+
+### 测试
+
+- 新增 ownership proof 四端 golden vector、大小写 AID、非法 UUID/控制字符和跨 SDK 验签测试。
+- 增加 JavaScript owner relation 集成测试，覆盖新注册、self-owner、外部 owner 双签、legacy bind、operation 恢复、换 owner、unbind、Storage ACL/数据保留和重建访问。
+- 扩展证书有效期、上下文验签、审计 facade、V2 Pull/Push、volatile 分页、设备隔离、连接代际和浏览器 E2E/conformance 测试。
+
+## 0.5.17 — 2026-09-19
+
+### 新功能
+
+#### 非持久消息与设备定向
+- 正 `ttl` 的 V2 加密消息会透传到最终发送 RPC；`storage=volatile` 消息使用独立 volatile cursor 拉取和 ACK，不进入持久 `seq`、seq-tracker 或持久水位。
+- Push、Pull 和 sender IK 延迟恢复共用按消息去重及并发占用状态；纯 volatile 页可独立续页，cursor epoch 不匹配时清空旧 cursor 并重试一次，切换 AID、设备或 slot 时重置本地 volatile 状态。
+- `message.v2.pull` / `message.v2.ack` 接入公开调用管线和实例上下文校验；`message.ack` 支持只提交 `volatile_cursor(s)` / `volatile_ids`。
+- V2 `message.send` 支持 `device_id` / `to_device_id` 定向接收设备，同时保留发送方 self-sync 和 audit recipients；应用消息公开规范化的 `sender_device_id`，不再暴露内部 slot 字段。
+
+#### 群管理与 agent.md 事件
+- `GroupFacade` 新增 `block`、`unblock`、`getBlocklist`、`reportStatus` 和 `getMemberStatuses`；屏蔽、禁言和成员状态可通过高层 SDK 直接调用。
+- 远端 agent.md 已有版本的 ETag 或 Last-Modified 变化时，通过应用事件管线发布 `agentmd.changed`。
+
+### 修复
+
+#### Storage / Group FS 上传 Content-Type
+- `writeBytes`、`uploadFile` 和 Group FS 上传在未显式指定类型时按实际字节识别 MIME，并以路径后缀作为回退。
+- 上传会话、HTTP PUT 和 `completeUpload` 使用同一 Content-Type；保留 session 的其它 header 并替换冲突的 Content-Type，修复 OSS 预签名校验不一致导致的 403。
+
+#### 群身份恢复
+- 匿名群创建在 RPC 前持久化群密钥并复用稳定的 `_create_request_id`，响应丢失后的重试不会重复创建群；命名群恢复可复用已保存身份。
+- 新群主收到 `owner_transfer_rekey_pending` 后只自动完成一次转让；重连时即使服务端角色仍为 member，也会按本地 pending 状态续跑 `complete_transfer`。
+
+### 改进
+
+- Message、SendResult、PullResult 和 AckResult 类型补充 volatile 元数据、cursor、ACK 结果及 `sender_device_id`；`status` 接受 `accepted`。
+- SDK、锁文件、运行时版本、V2 E2EE envelope `sdk_version` 和 conformance 期望统一更新为 `0.5.17`。
+
+### 测试
+
+- 增加 volatile Push/Pull/ACK、纯 volatile 分页、cursor 恢复、并发去重、定向设备和公开字段边界测试。
+- 增加群屏蔽/禁言/成员状态、匿名创建幂等、群主转让自动完成与恢复测试，并扩展浏览器 E2E 覆盖。
+- 增加 Storage/Group FS MIME 与 Content-Type 一致性测试及 conformance 版本验证。
+
+## 0.5.16 — 2026-09-16
 
 ### 修复
 

package/_packed_docs/CHANGELOG.md

@@ -4,85 +4,178 @@
 
 格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)；版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。
 
----
-
-## 0.5.18 — 2026-10-06
-
-### 新功能
-
-#### Owner relation 与 AID 注册编排
-- 新增 `register({aid, type, owner?, ...})`，由 SDK 编排 `auth.aid_register_prepare` → `auth.aid_register_submit` → 带 `ownerOperationId` 的 agent.md 上传 → `auth.aid_register_activate`；保留 `register(aid)` 的 legacy 兼容语义。
-- 新增 `bindAid`、`getAidBindingStatus`、`resumeAidBinding` 和 `changeOwner`，分别覆盖已有 `legacy_unbound`/`unbound` AID 的绑定、状态查询、operation 恢复和三方换 owner；绑定不重新签发证书。
-- 注册规则明确 human 不得指定 owner，非 human 必须指定 owner，只有 agent 支持 self-owner；外部 owner 需要 subject 与 owner 双签，换 owner 需要旧 owner、subject、新 owner 签名及 `expected_relation_version` CAS。
-- 新增 ownership proof canonical bytes、`factHash`/`statementHash`、UUID v4 `proofId` 和签名封套校验；AID 统一规范化为小写，普通 agent.md 更新保留现有 proof，不能通过普通 PUT 改 owner。
-- owner operation 有效期为 7 天；pending、失败或过期期间证书、登录、连接和基本消息通信保持可用，关系状态可查询并从 operation ID 恢复。
-
-#### Owner relation Storage 与审计门面
-- 补齐 `storage.relation_backup_provision`、`relation_backup_revoke`、`relation_backup_status` 的 SDK 契约和集成验证；关系目录固定为 `.aun/subjects/<lowercase_subject_aid>`，撤销只回收 ACL、保留数据并递增 ACL generation。
-- `MessageFacade` 和 `GroupFacade` 新增 `getAuditStatus`，统一映射对应的审计状态 RPC。
-
-### 修复
-
-#### 证书与签名安全
-- `AID.sign` 拒绝无效、过期或尚未生效证书；新增 `verifyWithContext`，绑定 expected AID、完整证书指纹、签名时间及当前有效性选项。
-- RPC client signature、事件签名和 agent.md 签名路径增加证书有效期检查，并统一处理 `signature_verification_unavailable`、`type_change_blocked`、`aid_binding_required` 等关系错误。
-
-#### V2 消息同步与投递
-- P2P/Group V2 Pull 增加有界生产者消费者流水线、volatile cursor 去重、epoch mismatch 单次重试和后台 gap fill；`background_sync` 关闭时不再隐式启动后台补齐。
-- inline push 在终态解密失败时仍提交连续序号并保留 ACK pending；Push、Pull、sender IK 延迟恢复共用去重和并发占用状态，减少交错投递重复。
-- 当前设备 self-sync 消息只推进本地发布序号而不重复投递，其它设备仍可收到；公开 payload 保留 `sender_device_id` 和 `direction`，继续隐藏内部 slot 字段。
-
-#### 会话、设备与连接生命周期
-- 加强 slot ID/full slot ID 隔离，支持 long/short connection、short TTL 和 `background_sync` 组合；重连任务增加所有权、代际保护和旧连接结果隔离。
-- 连接阶段暂存 Push，待应用监听器注册后排空，降低 `delivery.changed` 丢失和竞态；补齐多设备明文 P2P/Group self-sync 边界。
-
-### 改进
-
-- 四端公开类型和结果继续对齐 volatile cursor、ACK、设备来源及审计状态；当前 CA/Name Service 仅实现 `signing` 与 `group_identity` 证书用途，`org_identity` 不作为已实现能力暴露。
-- SDK、锁文件、运行时版本、V2 E2EE envelope `sdk_version` 和 conformance 期望统一更新为 `0.5.18`。
-
-### 测试
-
-- 新增 ownership proof 四端 golden vector、大小写 AID、非法 UUID/控制字符和跨 SDK 验签测试。
-- 增加 JavaScript owner relation 集成测试，覆盖新注册、self-owner、外部 owner 双签、legacy bind、operation 恢复、换 owner、unbind、Storage ACL/数据保留和重建访问。
-- 扩展证书有效期、上下文验签、审计 facade、V2 Pull/Push、volatile 分页、设备隔离、连接代际和浏览器 E2E/conformance 测试。
-
-## 0.5.17 — 2026-09-19
-
-### 新功能
-
-#### 非持久消息与设备定向
-- 正 `ttl` 的 V2 加密消息会透传到最终发送 RPC；`storage=volatile` 消息使用独立 volatile cursor 拉取和 ACK，不进入持久 `seq`、seq-tracker 或持久水位。
-- Push、Pull 和 sender IK 延迟恢复共用按消息去重及并发占用状态；纯 volatile 页可独立续页，cursor epoch 不匹配时清空旧 cursor 并重试一次，切换 AID、设备或 slot 时重置本地 volatile 状态。
-- `message.v2.pull` / `message.v2.ack` 接入公开调用管线和实例上下文校验；`message.ack` 支持只提交 `volatile_cursor(s)` / `volatile_ids`。
-- V2 `message.send` 支持 `device_id` / `to_device_id` 定向接收设备，同时保留发送方 self-sync 和 audit recipients；应用消息公开规范化的 `sender_device_id`，不再暴露内部 slot 字段。
-
-#### 群管理与 agent.md 事件
-- `GroupFacade` 新增 `block`、`unblock`、`getBlocklist`、`reportStatus` 和 `getMemberStatuses`；屏蔽、禁言和成员状态可通过高层 SDK 直接调用。
-- 远端 agent.md 已有版本的 ETag 或 Last-Modified 变化时，通过应用事件管线发布 `agentmd.changed`。
-
-### 修复
-
-#### Storage / Group FS 上传 Content-Type
-- `writeBytes`、`uploadFile` 和 Group FS 上传在未显式指定类型时按实际字节识别 MIME，并以路径后缀作为回退。
-- 上传会话、HTTP PUT 和 `completeUpload` 使用同一 Content-Type；保留 session 的其它 header 并替换冲突的 Content-Type，修复 OSS 预签名校验不一致导致的 403。
-
-#### 群身份恢复
-- 匿名群创建在 RPC 前持久化群密钥并复用稳定的 `_create_request_id`，响应丢失后的重试不会重复创建群；命名群恢复可复用已保存身份。
-- 新群主收到 `owner_transfer_rekey_pending` 后只自动完成一次转让；重连时即使服务端角色仍为 member，也会按本地 pending 状态续跑 `complete_transfer`。
-
-### 改进
-
-- Message、SendResult、PullResult 和 AckResult 类型补充 volatile 元数据、cursor、ACK 结果及 `sender_device_id`；`status` 接受 `accepted`。
-- SDK、锁文件、运行时版本、V2 E2EE envelope `sdk_version` 和 conformance 期望统一更新为 `0.5.17`。
-
-### 测试
-
-- 增加 volatile Push/Pull/ACK、纯 volatile 分页、cursor 恢复、并发去重、定向设备和公开字段边界测试。
-- 增加群屏蔽/禁言/成员状态、匿名创建幂等、群主转让自动完成与恢复测试，并扩展浏览器 E2E 覆盖。
-- 增加 Storage/Group FS MIME 与 Content-Type 一致性测试及 conformance 版本验证。
-
-## 0.5.16 — 2026-09-16
+---
+
+## 0.5.20 — 未发布
+
+> 基线：2026-10-12 发布的 npm `0.5.19`，发布包已与仓库快照 `ab05792f` 核对；本节整理 2026-10-15 工作区的 SDK 增量。
+
+### 新功能
+
+#### 通用签验与文档多签
+- 新增异步 `AIDStore.sign/verify`，支持 `raw/document`、显式 `text/file` 输入、分离签名、TAG 和追加签名；raw 文件保留二进制，`file://` 文本按字面处理，文件就地签署使用显式可写文件句柄。
+- 文档每一签覆盖此前完整字节前缀，附签必须包含 `signer_aid`；按签名 AID 和精确证书指纹逐签验证，尾签块总量限制为 2048 bytes。`agent.md` 与 Ownership 文件复用通用签验核心。
+
+### 修复
+
+#### 消息同步、已读事件与设备
+- Pull Gate 改为同 namespace 单飞、每客户端最多 4 个 namespace 并发；群事件与群消息使用独立 namespace，保留前台优先和同级 FIFO，超时任务结束前不释放同 namespace。
+- 后台补拉保留目标上界和 `has_more/remaining`，超过默认页预算、小页／空页或暂时失败后继续调度；RPC 响应、前台排空和 gate 空闲触发恢复，关闭后台同步或切换身份、连接时废弃旧代任务。
+- Forward 末页发布并持久化水位后独立发送最终累计 ACK，移除为提交 ACK 而发起的额外空 Pull；分页只捎带已提交水位，volatile 页消费后按最新 cursor 续拉。
+- `message.read_changed`、`group.read_changed` 和 `read_state_sync` 在出队及每个处理器执行前复核身份代次；首次合法 raw 已读事件同时交付应用事件和协议镜像，避免身份切换后交付旧事件或漏发首次更新。
+- 显式定向设备发送遇 bootstrap 缓存缺少目标时仅强制刷新一次；无定向、已强制查询及其他加密错误不额外重试。
+
+#### agent.md 与本地草稿
+- 自有 AID 默认 resolve 优先返回 IndexedDB 中的草稿／正文，读取不依赖联网或仍有效的私钥、证书；显式 refresh 和远端身份继续下载。
+- 候选稿在网络预检前保存，失败稿由显式 upload 重试；下载和连接自动恢复不覆盖、重传失败稿，只有权威确认精确同一候选后才清除，旧上传完成不删除较新草稿或 pending。
+- 损坏草稿元数据返回 `persistence_unavailable`；草稿失败不阻断独立 Ownership 任务和实体生命周期 checkpoint。
+- 历史名片读取兼容缺失 Schema、旧指纹／CN 和旧群单签，按签署时间核验证书并隔离历史兼容缓存；新上传及现代实体多签保持严格校验。
+- group/org 名片改为实体私钥主签、当前 owner 使用本人 token 上传，可选追加 owner 附签；移除实体额外 V2 上传授权，拒绝 owner 直接替代实体主签。
+- 多签上传和重试保留原始字节；普通正文更新保留既有 owner／ownership 材料并使用原 ETag CAS。下载协商 `multi-v1`，兼容响应头大小写，304 缺少本地正文时重新获取。
+
+#### Ownership 2.1 共识与恢复
+- 权威读取核对 NS 原 ETag、owner 当前完整原文、摘要和存在性，使用 head/get/head 并在验签后复读；30 秒观察窗口包含首次网络等待，不再以 Storage `revision/object_id` 作为共识依据。
+- owner.md 改走上传会话、HTTP PUT 和 `complete_upload`，使用 `expected_version` 条件提交；写前复查原件，CAS 冲突保留为 conflict，共识结果移除 `owner_md_revision`。
+- pending 绑定起始完整快照和原始声明，不能因 owner 或数字版本相同复用旧审批；release 保持 base 版本，sub 清理后投影归零，新绑定从 1 开始，未清理的旧 release 不覆盖新关系。
+- released 共识、恢复及清理均复核当前文件和新鲜证书状态；不能仅凭解锁认定完成或补造历史完成证据。损坏任务保留并失败关闭，其他 subject 任务仍可恢复。
+- 补齐 PKI critical extension、BasicConstraints、KeyUsage 和路径长度校验，当前权威证书读取不复用历史兼容缓存或接受重定向。
+
+#### 凭证、组织请求与实体恢复
+- `request_binding` 最长 300 秒，admission 不超过成员 binding 截止时间；完整 verify 返回前重查异步等待后可能过期的凭证、状态证明和请求绑定，复用本轮已解析证书及限流结果。
+- 已有合法 `client_signature` 保留并核对实际请求，冲突直接拒绝；服务事件限制白名单，规范化 AID 大小写并去重目标集合。
+- 组织门面分离本地 `aidStore` 参数时保留显式 null；转让缺少替代成员材料先拒绝，checkpoint 已存在但私钥丢失时不生成替代密钥。
+
+### 兼容性与语言边界
+
+- 显式登记允许 agent 不指定 owner；human 仍禁止 owner，group/org 仍要求 owner，无 owner 的 agent 不创建 Ownership 待续跑意图。
+- 签验和证书解析继续使用异步 WebCrypto；文件输入使用浏览器对象／句柄，持久草稿和 Ownership 任务使用 IndexedDB，不引入 Node.js 路径接口。
+- 包配置、锁文件、运行时 `VERSION`、V2 envelope 的 `sdk_version` 及加密 conformance 期望统一为 `0.5.20`。
+
+### 测试
+
+- 扩展通用签验、多签原文、历史证书、离线草稿、损坏元数据、Ownership 原件 CAS／清理重绑、请求时效及实体恢复测试。
+- 扩展 namespace 并发、后台续拉、末页 ACK、volatile cursor、已读事件逐处理器代次隔离和定向设备 bootstrap 测试，并更新浏览器离线 Ownership 用例。
+- 共享 Ownership 向量和 cross-SDK agent 接入公开 Store 签验；增加四语言签验及 Name Service 多签矩阵入口，测试落点与执行边界见 Python parity 文档。
+
+## 0.5.19 — 2026-10-12
+
+> 基线：`0.5.18` 的仓库快照 `1f03bf2d`；本节整理 2026-10-11 工作区的 SDK 增量。
+
+### 新功能
+
+#### 跨设备已读未读
+- 新增 `MessageFacade.read/readState`、`GroupFacade.read/readState`，分别上报话题的 `last_read_message_id`、查询当前 AID 的跨设备汇总及当前设备 seq 映射；业务已读状态独立于消息 ACK、Pull 游标和群事件游标。
+- 消费 `message.read_changed`、`group.read_changed`，按公共 `last_read_order` 单调更新缓存并抑制重复／倒序事件；切换 AID 或设备时隔离缓存和在途查询结果。
+- 重连后补查已登记的话题并发布本地 `read_state_sync` 完成事件，携带汇总状态及逐项错误；保留 `current_device_seq=null` 和 `mapping_status`；超过安全整数范围的公共顺序和设备 seq 保留为精确十进制字符串。
+
+#### Ownership 2.1 管理
+- 新增 `bindOwneraid`、`bindSubaid`、`releaseSubaid`、`transferSubaid`、`acceptOwnershipRequest`、`rejectOwnershipRequest` 和 `checkOwnershipConsensus`，覆盖双向发起绑定、释放、转移、审批和独立共识检查。
+- 关系依据 sub 的 NS `agent.md` 与 owner 的 `sub_aids/{sub_aid}/owner.md`；使用本人尾签、`relation_version`、owner 锁、NS ETag 和 Storage revision CAS 验证及提交，不依赖旧 Auth owner operation。
+- `aun.ownership.sdk.v1` 控制消息走加密消息通道，由 SDK 消费；审批、inbox/outbox、待提交原始字节和步骤先持久化到 IndexedDB，连接后续跑。任务完成需要重新读取权威文件验证目标共识，不能由通知或发送成功推断。
+- 新增 `ownership.request/action_required/progress/completed/rejected/stopped/error` 应用事件；group/org 使用专属生命周期，通用 Ownership 2.1 返回 `not_applicable`。
+
+#### 凭证与组织服务
+- 增加 `credential` 门面的 `create`、`verifySignature`、`verify`、`verifyRegistrationReceipt` 及登记、撤销、状态／撤销列表 RPC；区分离线签名校验和包含凭证链、实时状态、能力范围、实际请求绑定的完整验证。
+- 增加 `org.lifecycle/member/credential/authz/audit` 门面、组织请求准备、成员双签绑定和转让接受签署；组织请求绑定目标服务、nonce、请求摘要及必要的代表证明，并进入统一客户端签名管线。
+- 组织／群身份由当前 owner 持有；专属转移强制 rekey。实体 `agent.md` 由 owner 使用本人证书和私钥代签、代上传，绑定 `signer_aid`、实体证书指纹及上传授权，失败阶段可恢复。
+- `org.*` 与 `credential.revoked` 事件在进入应用事件队列前验证签发服务、接收身份、证书、时间窗口及签名，并按服务／事件／接收身份去重。
+
+### 修复
+
+- Ownership 控制消息落盘或处理失败时保留有序队列／sender IK 待重试项，避免提前提交交付水位或 ACK；V2 解密保留控制消息原始 JSON，供重复键和严格字段校验。
+- Ownership 证书验证绑定当前证书代际、生命周期状态和可信吊销证据；普通名片上传与关系字段变更分开，实体解散或身份失效后清理相应本地状态。
+- 错误映射优先保留服务端 `data.retryable`，组织请求采用一致 canonical JSON 和请求参数摘要。
+
+### 兼容性与语言边界
+
+- `AIDStore.register(aid, {type, owner?, exttype?})` 登记接口改为显式传入 type；human 禁止 owner，agent/group/org 要求 owner。登记意图持久化后由连接期续跑关系流程，group/org 交给各自生命周期。
+- 旧 `auth.aid_register_*` / `auth.aid_bind_*` 关系编排已移除；`bindAid`、`bindOwner`、`releaseOwnership` 的 legacy 入口返回 `unsupported_protocol`，调用方应迁移到本节的 2.1 管理 API。
+- 浏览器的凭证创建、成员绑定、转让签署及验签 helper 使用异步 WebCrypto；Ownership 任务、revision CAS 和登记意图保存到 IndexedDB。
+- 组织创建、接受转让及解散可通过 `aidStore` 接入实体身份编排；`org.resource/task/host/workflow` 当前通过 `client.call` 使用。
+- 包配置、锁文件、运行时 `VERSION`、V2 envelope 的 `sdk_version` 及加密 conformance 期望统一为 `0.5.19`。
+
+### 测试
+
+- 增加 Ownership 2.1 和组织／凭证协议的跨语言共享向量、严格解析、签名／吊销、CAS、审批与重连恢复测试。
+- 扩展已读状态门面、单调缓存、身份切换、重连补偿、组织实体身份及服务事件验签测试；配套单域、浏览器、cross-SDK 和双域测试入口列于 Python parity 文档。
+
+## 0.5.18 — 2026-10-06
+
+### 新功能
+
+#### Owner relation 与 AID 注册编排
+- 新增 `register({aid, type, owner?, ...})`，由 SDK 编排 `auth.aid_register_prepare` → `auth.aid_register_submit` → 带 `ownerOperationId` 的 agent.md 上传 → `auth.aid_register_activate`；保留 `register(aid)` 的 legacy 兼容语义。
+- 新增 `bindAid`、`getAidBindingStatus`、`resumeAidBinding` 和 `changeOwner`，分别覆盖已有 `legacy_unbound`/`unbound` AID 的绑定、状态查询、operation 恢复和三方换 owner；绑定不重新签发证书。
+- 注册规则明确 human 不得指定 owner，非 human 必须指定 owner，只有 agent 支持 self-owner；外部 owner 需要 subject 与 owner 双签，换 owner 需要旧 owner、subject、新 owner 签名及 `expected_relation_version` CAS。
+- 新增 ownership proof canonical bytes、`factHash`/`statementHash`、UUID v4 `proofId` 和签名封套校验；AID 统一规范化为小写，普通 agent.md 更新保留现有 proof，不能通过普通 PUT 改 owner。
+- owner operation 有效期为 7 天；pending、失败或过期期间证书、登录、连接和基本消息通信保持可用，关系状态可查询并从 operation ID 恢复。
+
+#### Owner relation Storage 与审计门面
+- 补齐 `storage.relation_backup_provision`、`relation_backup_revoke`、`relation_backup_status` 的 SDK 契约和集成验证；关系目录固定为 `.aun/subjects/<lowercase_subject_aid>`，撤销只回收 ACL、保留数据并递增 ACL generation。
+- `MessageFacade` 和 `GroupFacade` 新增 `getAuditStatus`，统一映射对应的审计状态 RPC。
+
+### 修复
+
+#### 证书与签名安全
+- `AID.sign` 拒绝无效、过期或尚未生效证书；新增 `verifyWithContext`，绑定 expected AID、完整证书指纹、签名时间及当前有效性选项。
+- RPC client signature、事件签名和 agent.md 签名路径增加证书有效期检查，并统一处理 `signature_verification_unavailable`、`type_change_blocked`、`aid_binding_required` 等关系错误。
+
+#### V2 消息同步与投递
+- P2P/Group V2 Pull 增加有界生产者消费者流水线、volatile cursor 去重、epoch mismatch 单次重试和后台 gap fill；`background_sync` 关闭时不再隐式启动后台补齐。
+- inline push 在终态解密失败时仍提交连续序号并保留 ACK pending；Push、Pull、sender IK 延迟恢复共用去重和并发占用状态，减少交错投递重复。
+- 当前设备 self-sync 消息只推进本地发布序号而不重复投递，其它设备仍可收到；公开 payload 保留 `sender_device_id` 和 `direction`，继续隐藏内部 slot 字段。
+
+#### 会话、设备与连接生命周期
+- 加强 slot ID/full slot ID 隔离，支持 long/short connection、short TTL 和 `background_sync` 组合；重连任务增加所有权、代际保护和旧连接结果隔离。
+- 连接阶段暂存 Push，待应用监听器注册后排空，降低 `delivery.changed` 丢失和竞态；补齐多设备明文 P2P/Group self-sync 边界。
+
+### 改进
+
+- 四端公开类型和结果继续对齐 volatile cursor、ACK、设备来源及审计状态；当前 CA/Name Service 仅实现 `signing` 与 `group_identity` 证书用途，`org_identity` 不作为已实现能力暴露。
+- SDK、锁文件、运行时版本、V2 E2EE envelope `sdk_version` 和 conformance 期望统一更新为 `0.5.18`。
+
+### 测试
+
+- 新增 ownership proof 四端 golden vector、大小写 AID、非法 UUID/控制字符和跨 SDK 验签测试。
+- 增加 JavaScript owner relation 集成测试，覆盖新注册、self-owner、外部 owner 双签、legacy bind、operation 恢复、换 owner、unbind、Storage ACL/数据保留和重建访问。
+- 扩展证书有效期、上下文验签、审计 facade、V2 Pull/Push、volatile 分页、设备隔离、连接代际和浏览器 E2E/conformance 测试。
+
+## 0.5.17 — 2026-09-19
+
+### 新功能
+
+#### 非持久消息与设备定向
+- 正 `ttl` 的 V2 加密消息会透传到最终发送 RPC；`storage=volatile` 消息使用独立 volatile cursor 拉取和 ACK，不进入持久 `seq`、seq-tracker 或持久水位。
+- Push、Pull 和 sender IK 延迟恢复共用按消息去重及并发占用状态；纯 volatile 页可独立续页，cursor epoch 不匹配时清空旧 cursor 并重试一次，切换 AID、设备或 slot 时重置本地 volatile 状态。
+- `message.v2.pull` / `message.v2.ack` 接入公开调用管线和实例上下文校验；`message.ack` 支持只提交 `volatile_cursor(s)` / `volatile_ids`。
+- V2 `message.send` 支持 `device_id` / `to_device_id` 定向接收设备，同时保留发送方 self-sync 和 audit recipients；应用消息公开规范化的 `sender_device_id`，不再暴露内部 slot 字段。
+
+#### 群管理与 agent.md 事件
+- `GroupFacade` 新增 `block`、`unblock`、`getBlocklist`、`reportStatus` 和 `getMemberStatuses`；屏蔽、禁言和成员状态可通过高层 SDK 直接调用。
+- 远端 agent.md 已有版本的 ETag 或 Last-Modified 变化时，通过应用事件管线发布 `agentmd.changed`。
+
+### 修复
+
+#### Storage / Group FS 上传 Content-Type
+- `writeBytes`、`uploadFile` 和 Group FS 上传在未显式指定类型时按实际字节识别 MIME，并以路径后缀作为回退。
+- 上传会话、HTTP PUT 和 `completeUpload` 使用同一 Content-Type；保留 session 的其它 header 并替换冲突的 Content-Type，修复 OSS 预签名校验不一致导致的 403。
+
+#### 群身份恢复
+- 匿名群创建在 RPC 前持久化群密钥并复用稳定的 `_create_request_id`，响应丢失后的重试不会重复创建群；命名群恢复可复用已保存身份。
+- 新群主收到 `owner_transfer_rekey_pending` 后只自动完成一次转让；重连时即使服务端角色仍为 member，也会按本地 pending 状态续跑 `complete_transfer`。
+
+### 改进
+
+- Message、SendResult、PullResult 和 AckResult 类型补充 volatile 元数据、cursor、ACK 结果及 `sender_device_id`；`status` 接受 `accepted`。
+- SDK、锁文件、运行时版本、V2 E2EE envelope `sdk_version` 和 conformance 期望统一更新为 `0.5.17`。
+
+### 测试
+
+- 增加 volatile Push/Pull/ACK、纯 volatile 分页、cursor 恢复、并发去重、定向设备和公开字段边界测试。
+- 增加群屏蔽/禁言/成员状态、匿名创建幂等、群主转让自动完成与恢复测试，并扩展浏览器 E2E 覆盖。
+- 增加 Storage/Group FS MIME 与 Content-Type 一致性测试及 conformance 版本验证。
+
+## 0.5.16 — 2026-09-16
 
 ### 修复