@agentunion/fastaun-browser 0.5.19 → 0.5.21

package/CHANGELOG.md

@@ -4,9 +4,107 @@
 
 格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)；版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。
 
----
-
-## 0.5.19 — 未发布
+---
+
+## 0.5.21 — 未发布
+
+> 基线：上次发布的 `0.5.20` 对应仓库快照 `08221fbb`；本节整理 2026-10-18 工作区的 SDK 增量。
+
+### 新功能
+
+#### resolve 元数据与 ownership
+- `resolve` 和 `downloadAgentMd` 返回 `agent_md.frontmatter` / `frontmatter`，保留标准字段、扩展字段及嵌套类型；公开 `AgentMdFrontmatter`，历史缺字段不补默认值。
+- `resolve(aid, { ownership: client, ownershipTtlMs? })` 按需复用现有 Ownership 2.1 共识校验，将状态及 owner.md 原文快照存入 IndexedDB 等价记录；默认缓存 60 秒，支持 TTL=0、forceRefresh、名片内容变化失效和失败隔离，缓存不用于授权。
+
+#### 按对端同步与批量投递
+- 新增 `MessageFacade.peers`，按服务端协商的 peer pull 能力查询对端目录；支持按 sender 隔离 P2P Pull、ACK、历史查询、水位和 volatile cursor，重连及 Push 提示驱动目录刷新与补拉。
+- 新增 `message.batch`、`group.message_batch`、`group.event_batch` 应用事件；按页聚合消息及事件，应用处理完成后再提交交付水位、去重记录和 ACK，处理失败保留未提交部分供恢复。
+
+#### 凭证续期与诊断
+- 新增 `credential.current`，保存长效凭证及组织成员续期材料，处理加密续期请求、响应、登记回执和提交确认；断线恢复复用持久 checkpoint，返回当前已验证的凭证，旧输入不绕过撤销状态。
+- 同步并验证撤销列表分页，将已知撤销状态用于凭证及证明链检查；组织成员包按接收身份验证后持久保存，切换身份或连接时废弃旧代异步结果。
+- 新增 `client.debug.diag`，支持全部、命名空间及具体 RPC 的 dry-run 诊断，校验服务端 `dry_run=true/executed=false` 与阶段结果，汇总通过、失败和缺少真实材料的跳过项。
+
+### 修复
+
+#### 消息投递、背压与 ACK
+- Pull 页大小统一为 200，预取最多 4 页；网络预取、解密准备和应用交付分离，并按待交付消息数量施加背压，handler 失败不提前确认消息。
+- peer tail／forward 的连续证明、实际 ACK 与已提交前缀分别校验；tail 跳跃、内联 Push、撤回、volatile 重复和响应丢失恢复不跨 sender 或身份代次推进水位。
+- 批量和逐条订阅使用同页开始时的处理器快照；应用事件、去重状态和消息提交保持顺序，重入、取消或存储失败保留待办。
+
+#### agent.md 与 Ownership 恢复
+- 保持 `agent.md` 与 `owner.md` 双文件、六字段声明和既有 `aun.ownership.sdk.v1` 控制格式；普通名片读写不以前置 Ownership 共识、owner Storage 或关系状态为条件，正文更新仍须原样保留已有关系材料及原 ETag/CAS。
+- 增加 `resetOwnershipTask()`，归档当前身份发起的未完成绑定、释放和转移任务，保留原记录及远端文件；返回成功重置和无法判断的任务 ID，迟到消息、审批及恢复不能复活已重置任务。
+- 恢复 0.5.20、0.5.19 的既有任务，核对原 operation、审批、签名字节及提交条件；旧未发布 Owner 候选缺少原 revision 证据时保留现场，已提交目标需本地原签名候选与新鲜共识匹配才能完成；旧 release 的 wire 目标版本保留，实际释放关系仍按 base 核验。更早 proof 材料保留原兼容边界，不自动伪造 2.1 关系。
+- 绑定先恢复可继续的原任务；确认本地任务损坏时归档后重新发起并重新审批，网络故障、CAS 竞争、有效其他意图及远端关系冲突保持失败分类，不借 reset 覆盖远端关系。
+
+#### 凭证、存储与证书
+- 组织创建、转让和续期恢复保留原身份、密钥、凭证链、固定请求及签名；恢复过期请求绑定时重新核对原上下文，登记结果先验证再提交本地状态。
+- 对组织身份创建／转移及凭证续期的敏感 checkpoint 加密保存；读取兼容旧明文并在写入时升级，损坏或身份不匹配时拒绝继续。
+- 合并相同条件下的并发对端证书请求，保留指纹、历史签署时间和当前验证场景的隔离，失败后允许重试。
+
+### 兼容性与语言边界
+
+- 浏览器 IndexedDB 保存按 AID／device／slot 隔离的交付回执和受保护 checkpoint；异步读写及续期恢复保留身份代次检查，浏览器密钥存储不沿用 Node 文件 seed 轮换实现。
+- 包配置、锁文件、运行时 `VERSION` 和 V2 envelope 的 `sdk_version` 统一为 `0.5.21`。
+
+### 测试
+
+- 扩展 peer 目录与按对端 Pull、tail／forward、批量事件、应用背压、处理失败、水位及 ACK 的定向测试。
+- 扩展凭证续期、撤销分页、成员包、checkpoint 加密、证书并发及 Ownership reset／旧任务／绑定容错测试；测试入口和执行边界见 Python parity 文档，不以用例存在代替全量通过结论。
+
+## 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 增量。
 
@@ -49,82 +147,82 @@
 - 扩展已读状态门面、单调缓存、身份切换、重连补偿、组织实体身份及服务事件验签测试；配套单域、浏览器、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。
+
+### 新功能
+
+#### 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
+- 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,9 +4,107 @@
 
 格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)；版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。
 
----
-
-## 0.5.19 — 未发布
+---
+
+## 0.5.21 — 未发布
+
+> 基线：上次发布的 `0.5.20` 对应仓库快照 `08221fbb`；本节整理 2026-10-18 工作区的 SDK 增量。
+
+### 新功能
+
+#### resolve 元数据与 ownership
+- `resolve` 和 `downloadAgentMd` 返回 `agent_md.frontmatter` / `frontmatter`，保留标准字段、扩展字段及嵌套类型；公开 `AgentMdFrontmatter`，历史缺字段不补默认值。
+- `resolve(aid, { ownership: client, ownershipTtlMs? })` 按需复用现有 Ownership 2.1 共识校验，将状态及 owner.md 原文快照存入 IndexedDB 等价记录；默认缓存 60 秒，支持 TTL=0、forceRefresh、名片内容变化失效和失败隔离，缓存不用于授权。
+
+#### 按对端同步与批量投递
+- 新增 `MessageFacade.peers`，按服务端协商的 peer pull 能力查询对端目录；支持按 sender 隔离 P2P Pull、ACK、历史查询、水位和 volatile cursor，重连及 Push 提示驱动目录刷新与补拉。
+- 新增 `message.batch`、`group.message_batch`、`group.event_batch` 应用事件；按页聚合消息及事件，应用处理完成后再提交交付水位、去重记录和 ACK，处理失败保留未提交部分供恢复。
+
+#### 凭证续期与诊断
+- 新增 `credential.current`，保存长效凭证及组织成员续期材料，处理加密续期请求、响应、登记回执和提交确认；断线恢复复用持久 checkpoint，返回当前已验证的凭证，旧输入不绕过撤销状态。
+- 同步并验证撤销列表分页，将已知撤销状态用于凭证及证明链检查；组织成员包按接收身份验证后持久保存，切换身份或连接时废弃旧代异步结果。
+- 新增 `client.debug.diag`，支持全部、命名空间及具体 RPC 的 dry-run 诊断，校验服务端 `dry_run=true/executed=false` 与阶段结果，汇总通过、失败和缺少真实材料的跳过项。
+
+### 修复
+
+#### 消息投递、背压与 ACK
+- Pull 页大小统一为 200，预取最多 4 页；网络预取、解密准备和应用交付分离，并按待交付消息数量施加背压，handler 失败不提前确认消息。
+- peer tail／forward 的连续证明、实际 ACK 与已提交前缀分别校验；tail 跳跃、内联 Push、撤回、volatile 重复和响应丢失恢复不跨 sender 或身份代次推进水位。
+- 批量和逐条订阅使用同页开始时的处理器快照；应用事件、去重状态和消息提交保持顺序，重入、取消或存储失败保留待办。
+
+#### agent.md 与 Ownership 恢复
+- 保持 `agent.md` 与 `owner.md` 双文件、六字段声明和既有 `aun.ownership.sdk.v1` 控制格式；普通名片读写不以前置 Ownership 共识、owner Storage 或关系状态为条件，正文更新仍须原样保留已有关系材料及原 ETag/CAS。
+- 增加 `resetOwnershipTask()`，归档当前身份发起的未完成绑定、释放和转移任务，保留原记录及远端文件；返回成功重置和无法判断的任务 ID，迟到消息、审批及恢复不能复活已重置任务。
+- 恢复 0.5.20、0.5.19 的既有任务，核对原 operation、审批、签名字节及提交条件；旧未发布 Owner 候选缺少原 revision 证据时保留现场，已提交目标需本地原签名候选与新鲜共识匹配才能完成；旧 release 的 wire 目标版本保留，实际释放关系仍按 base 核验。更早 proof 材料保留原兼容边界，不自动伪造 2.1 关系。
+- 绑定先恢复可继续的原任务；确认本地任务损坏时归档后重新发起并重新审批，网络故障、CAS 竞争、有效其他意图及远端关系冲突保持失败分类，不借 reset 覆盖远端关系。
+
+#### 凭证、存储与证书
+- 组织创建、转让和续期恢复保留原身份、密钥、凭证链、固定请求及签名；恢复过期请求绑定时重新核对原上下文，登记结果先验证再提交本地状态。
+- 对组织身份创建／转移及凭证续期的敏感 checkpoint 加密保存；读取兼容旧明文并在写入时升级，损坏或身份不匹配时拒绝继续。
+- 合并相同条件下的并发对端证书请求，保留指纹、历史签署时间和当前验证场景的隔离，失败后允许重试。
+
+### 兼容性与语言边界
+
+- 浏览器 IndexedDB 保存按 AID／device／slot 隔离的交付回执和受保护 checkpoint；异步读写及续期恢复保留身份代次检查，浏览器密钥存储不沿用 Node 文件 seed 轮换实现。
+- 包配置、锁文件、运行时 `VERSION` 和 V2 envelope 的 `sdk_version` 统一为 `0.5.21`。
+
+### 测试
+
+- 扩展 peer 目录与按对端 Pull、tail／forward、批量事件、应用背压、处理失败、水位及 ACK 的定向测试。
+- 扩展凭证续期、撤销分页、成员包、checkpoint 加密、证书并发及 Ownership reset／旧任务／绑定容错测试；测试入口和执行边界见 Python parity 文档，不以用例存在代替全量通过结论。
+
+## 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 增量。
 
@@ -49,82 +147,82 @@
 - 扩展已读状态门面、单调缓存、身份切换、重连补偿、组织实体身份及服务事件验签测试；配套单域、浏览器、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。
+
+### 新功能
+
+#### 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
+- 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
 
 ### 修复