AgentSQL v0.6.1

AgentSQL v0.6.1

本维护版本修复 v0.6.0 在 PostgreSQL metadata/audit 分库时的管理审计路由。管理操作和流量操作现在写入 audit 库的 traffic 链；metadata 库仅保存 management_audit_outbox 待投递记录。管理 API 与 agentsqlctl chain --domain management 在分库配置下均查询 audit 库的 traffic 链；合并库继续使用 metadata 库的 management 链。

本版本不新增 migration。PostgreSQL 分库 schema 仍为 metadata 16、audit 6；数据库支持范围和其他功能承诺与 v0.6.0 相同。

升级与回退

从 v0.6.0 升级前，停止全部实例及控制面写入，协调备份 metadata、audit 两库，并保留配对的 AGENTSQL_SECRET 和配置。核对 schema 版本为 16/6 后，成套替换 v0.6.1 服务和 CLI；使用 store.auto_migrate: false 的部署需保持该设置。启动后验证 /readyz、管理审计落入 audit 库，并核对 outbox 投递。

作为后续 v0.7 分库回退基线时，必须同时恢复升级前 metadata 16、audit 6 的数据库备份及配对 AGENTSQL_SECRET，再启动 v0.6.1。仅替换二进制无法读取 v0.7 的 metadata 17 schema；恢复会丢失备份点之后的写入。原版 v0.6.0 的 PostgreSQL 分库服务存在启动时管理审计写错库的问题，不能作为该场景的已验证服务回退目标。

验证与下载

• 源码提交：5f0e2f2cdf444569aa85e3540d6f11849293e639。该提交的 GitHub CI 包含 Go、前端和 govulncheck，均通过。
• 已在隔离 PostgreSQL 18 metadata/audit 双库验证服务启动、管理审计落库、两库备份恢复与 v0.7 升级后回退；在 ACTIVE 审计链下，CLI 和 Admin API 的显式 management 验链均通过。
• 下载发布资产后，先按 VERIFYING-SIGNATURES.md 使用 ed25519-release-public-key.json 分别验证 SPDX SBOM、provenance.json 和 SHA256SUMS 的 Ed25519 签名，再核对归档哈希与适用架构。发布资产的 provenance 应指向上述源码提交。

详细升级步骤见仓库内的 docs/release-notes-v0.6.1.md。