@agentunion/fastaun-browser 0.5.20 → 0.5.21

package/CHANGELOG.md

@@ -6,6 +6,53 @@
 
 ---
 
+## 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 增量。

package/_packed_docs/CHANGELOG.md

@@ -6,6 +6,53 @@
 
 ---
 
+## 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 增量。