Repository navigation
Add PostgreSQL/TLS self-hosting with recoverable task creation - #8887
Conversation
…g example Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent; model=gpt-6.1-sol; provider=OpenAI; declaration=runtime_reported; effort=max.
Request changes conclusion (author-owned PR; GitHub blocks formal self-review)
审阅提交:391802da82e0f50e86a3ec08ef00a25fe3612b8d,目标 main;完整 14 路径、976 行新增已核对。
动机 / Motivation
需要自行托管远程任务服务、让两个可信客户端交接任务的操作者。以前需要手工拼接数据库角色、TLS、策略和客户端;现在可从固定源码生成包并用统一入口启动、读回和恢复。本轮实测包可以启动并完成受限读、任务交接和备份恢复,但新增任务在响应丢失后的客户端恢复仍不可用。资源级写隔离、双物理宿主、云部署、轮换和长期运行仍由既有 shared-authority/R6 工作验收。本次不切换普通 File/SQLite provider,不安装到活动环境,也不授予合并或云资源操作权限。
改动思路 / Approach
保留现有 TypeScript 服务、PostgreSQL 事务及 Todo/lease 决策,把可重复归档、私有初始化、两个 TLS listener、三个客户端和多卷恢复组织成一个可停止的示例包。这是合理的运维增量;新建另一套 Core 或把只读 ACL 描述成资源级写隔离都不必要。可信 v0 写入口与资源级 v1 只读入口分离有实际权限依据。当前 PR 边界应是可重复启动、操作和恢复这一个完整入口,默认许可的操作也必须通过其公开恢复路径。
具体改动 / Changes
关键内容讲解
build_bundle.py::bundle用完整 Git SHA 归档,保留 LICENSE/NOTICE、源码摘要和镜像 pin;我从本头重新生成包,并将实际镜像内 919 个源码/模板文件与输入逐字节对照,Node 为 24.21.0。prepareSecretVolumes保留初始化身份、私有凭据和撤权策略,prepareDatabase复用现有 PG owner;launch.mjs让独立凭据走真实 TLS 客户端。实库角色非 superuser、无 BYPASSRLS,五张租户表均开启并强制 RLS。reader 凭据用于 trusted listener 时拒绝。state.sh停止本项目后备份数据库与凭据卷,只向新项目空卷恢复。我验证了同身份、同状态和同历史回执读回,以及覆盖已有卷被拒绝。原生rehearse.mjs的到期接管、旧持有人拒绝、受限 snapshot、撤权重启和缺失/损坏策略路径也通过。
规范依据:docs/reference/remote-authority-task-service-v0.md,修订 31944d835466c29f18f843ea92de75b49e7c0c62。TLS_SCOPE、EXPLICIT_OPT_IN 已实现;ORIGINAL_RECOVERY 未满足下述反例;PHYSICAL_HOSTS 留在现有 shared-authority/R6 验收,不能用同机容器代替。
对主干的风险 / Risks
[P2] 默认的 todo_add grant 暴露了不能闭环的恢复路径。 provision.mjs:112 给 a 新增授权;我用实际 TLS 代理在数据库提交成功后丢弃响应,首次调用正确返回 ambiguous,任务随后可读。但按说明用同一完整命令运行 ./client.sh a recover,实际退出码是 1,结果为 unavailable / remote_authority_transport_uncertain。直接读取同一服务的 HTTPS 响应却是 HTTP 200、found:原创建回执的 result 缺少 changed,而 remote_authority_contract.ts::responseCommand 即使 historical=true 仍要求它是 boolean。
缺陷在捆绑的既有服务 owner,相关源文件相对目标主干未改;本 PR 新增的默认 grant 把它纳入新包的许可用户路径,不能只以旧代码为由宣称该路径可恢复。修复共享服务历史创建回执的投影并固定修复版本,或先移除模板默认 todo_add 授权并准确限定可恢复操作;保留原历史回执兼容。 验收需新增真实 PG/TLS 的 todo_add 提交后丢响应、恢复、重启和原身份重放,且不能降低客户端校验。现有演练只恢复 complete,归档测试与演练通过仍覆盖不到此例。
PASS:两个包测试、标准 premerge 的 5 项 direct/10 项 catalog/8 项 risk-profile 与公开边界检查、真实权限/恢复演练。FAIL:上述新增操作恢复。独立 aarch64 VM 冷启动到 listener 就绪为 59 秒,缓存演练到三个客户端读回约 16 秒;VM 准备未计入,也不代表其他机器的时延保证。首次宿主缺 Compose 插件及测试 VM DNS 问题保留为环境失败;最终使用该独立 VM 自带 Compose,未改示例源码。没有查询或等待远端 CI。
我的整体评价 / Verdict
REQUEST_CHANGES。打包与隔离运维本身有可用价值,代码量也有明确运行消费者;但 long_horizon 与 user_experience 在默认新增操作的不确定结果恢复上仍有回归,不能以其余绿色检查替代。修复共享 owner 或收窄默认许可后可按新精确头复评。检查的是 CLI/Compose 示例及 Markdown,没有改变渲染页面;未验双物理宿主、原生 amd64、云部署、轮换和长期运行。评审没有执行合并或活动安装。
English verdict: REQUEST_CHANGES — the reproducible package works, but its default todo_add permission exposes a committed-operation recovery response that the packaged client rejects.
…ose-acl-20261117 Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent; gpt-6.1-sol; OpenAI; runtime_reported; effort=max
Request changes conclusion (author-owned PR; GitHub blocks formal self-review)
精确 head:492937e302f0537781c213b6bcf20147f329f1fc;实际 base:main@b12608d82bbf33d64f239e908d946cae360e556b。
动机 / Motivation
需要自行托管远程任务服务、让两个可信客户端交接任务的操作者。以前需要手工拼接数据库角色、TLS、策略和客户端;现在可从固定源码生成包并用统一入口启动、读回和恢复。原新增任务丢响应后的恢复已修复;完整打包演练仍会因宿主与服务时钟偏差而误报失败。不切换普通 File/SQLite provider,不安装到活动环境,也不授予合并或云资源操作权限。资源级写隔离、双物理宿主、amd64、真实云端、轮换和长期运行仍属后续原验收范围。
改动思路 / Approach
部署脚本只编排 PG/TLS;Todo、lease 与历史回执继续由原 owner 决定,新增恢复复用同一解码器,没有第二份状态机。当前 PR 边界:Standalone packaged operation plus existing create-result projection; no active-provider promotion or future distributed qualification. 这次没有通过放宽客户端校验修复旧问题,而是从原创建 owner 提取解码器,再在已校验原身份、actor 和请求摘要的历史恢复分支复用。恢复只重建返回值,不修改原回执或再次提交。部署入口减少操作者手工拼装;显式启动和既有策略仍是权限边界,不增加确认轮次。
具体改动 / Changes
完整改动共18条路径,+1062/-32:模板基础设施、三份文档、演练与回归,以及两个共享 TS 文件。按改动前 docs/reference/remote-authority-task-service-v0.md(revision b12608d82bbf33d64f239e908d946cae360e556b)核对:TLS_SCOPE implemented;ORIGINAL_RECOVERY implemented;SERVICE_CLOCK not_met;EXPLICIT_OPT_IN implemented;PHYSICAL_HOSTS deferred。v0 a/b 是可信 Goal 写者,v1 reader 仅资源受限读取;这不是资源级写隔离。
关键代码讲解
decodeCoordinationTodoCreateReceipt复用原创建回执规则,校验 schema 和内外 Todo ID 后派生changed=true。RemoteAuthorityService.dispatch仅处理匹配的todo_add历史回执,保留原 receipt SHA;身份、请求意图与 v1 证明边界不因投影而放宽。rehearse.mjs在早期 claim 已被拒绝后,用服务端到期时间减宿主Date.now(),由此触发本轮新 P2。
对主干的风险 / Risks
[P2] 演练把两个时钟当成同一时间域。 新脚本对20秒租约断言剩余时长不超过21秒。实际 Docker VM 比宿主快约8.6秒时,观测到 updated_at=22:38:16Z、expires_at=22:38:36Z、宿主 22:38:09.730Z,计算出26270ms并在107行退出;三次原脚本均失败,不能把后续接管与重启检查记作通过。服务租约本身正确。保留全部断言与21秒上限,只将时长改由 expires_at-updated_at 计算的私有反事实副本,完整通过接管、stale owner、重启后原回执、读隔离及撤销。请在同一服务时钟域计算等待,或使用有界服务状态轮询;不要放宽阈值或修改租约权限。复验应覆盖宿主落后服务数秒的完整打包演练。
| 验证 | 本轮结果 |
|---|---|
| 真实 PG16/TLS:丢响应、重启、原身份恢复、重放及创建 owner | PASS:43,0 skip |
| 同一新测试、只恢复 main 两个 runtime 文件 | 预期负对照:创建恢复 child 失败并使 parent 失败;其余35通过;不是两个独立缺陷 |
| 协议/客户端测试、bundle 测试、TS typecheck | PASS:16、2、typecheck |
| 当前源码生成镜像 | PASS:919个源文件及镜像 revision 与精确 head 一致,arm64 |
| 原打包演练 | FAIL:跨时钟断言;单表达式反事实通过不等于原脚本通过 |
| 标准 premerge | 技术项5 direct+10 catalog+8 risk+1 public-boundary通过;总体 FAIL:quality_receipt_missing |
语义与 CI 对齐
复用现有词汇与 typed owner,没有新存储协议或普通 provider 默认切换。显式 off、正常本地创建、错误 actor/intent、受限读者不能写、恢复无二次副作用由当前本地真实入口与负例覆盖;没有查询或等待远端 CI。当前 native qualification receipt 缺失单独保留,没有伪造通过记录。此前对旧 head 的备份/还原与 RLS 实测仅作为相同字节脚本的历史证据复用,本轮没有声称重新完成所有备份资格。
我的整体评价 / Verdict
交付判断为 justified_increment:打包入口与原创建恢复有实质进展;long_horizon improved,user_experience regression,原因是当前公开演练入口尚会误报。共享解码器的简化有证据支持,部署编排与权限 owner 的划分合理;最小剩余修复是演练时间域计算。旧 missing-changed 发现已验证解决,不再沿用为当前阻塞。
检查的是新增 CLI/Compose 示例、共享回执投影和 Markdown,没有产品渲染页面或布局改动;没有以浏览器或正式安装验收网页。双物理宿主、amd64、真实云端和长期运行仍未验证,不把这些未来范围变成新的当前阻塞。未合并、未安装或提升活动 provider。
English verdict: REQUEST_CHANGES — the original creation-recovery defect is fixed, but the packaged rehearsal fails under measured host/service clock skew.
Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent — gpt-6.1-sol / OpenAI; runtime_reported; reasoning effort: max.
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
审查提交:2b4b1f54e5b2d53c6c0a86bfc4a12ad73552b884。没有遗留阻塞发现。此前创建恢复与时钟问题均以真实 PostgreSQL/TLS 路径复验。
动机 / Motivation
受影响的是希望自托管远程任务服务、让两个可信客户端交接工作的操作者。以前要手工协调数据库角色、证书、策略与客户端;如果创建提交成功但网络回包丢失,旧的历史响应还会被严格客户端拒绝。现在可以从固定源码启动可复现的服务,用原请求找回历史回执,并在重启后确认同一任务及无重复写入。本次交付独立 Compose 模板与既有创建回执的恢复投影,不改变普通本地 provider 的选择。资源级写隔离、实体双宿主、生产部署、轮换和长期容量验收仍沿原 shared-authority 工作推进。
改动思路 / Approach
服务职责沿原边界分工:模板编排 PG 与 TLS,现有 TypeScript 服务校验调用者、范围和原请求,Todo 与 lease owner 决定能否修改状态,PG 原子提交并存储回执。只新增手工部署说明不能提供可重复启动与恢复路径;放松客户端对响应的检查会掩盖真正的不完整结果。复用原创建回执解码器能补齐返回值,保留原回执本身及摘要。演练脚本只等待由服务器两次时间戳推导的租期,权限仍由服务端判定,成本是一次保守且有上限的等待。
部署脚本只负责编排,创建历史响应沿用原解码器,租约时间仍由服务拥有。当前边界是可单独启动、验证及停止的 Compose 包和小范围恢复兼容修复。
具体改动 / Changes
以 Remote authority task service v0 在 c9d8616 的约束为基准。TLS_SCOPE:独立凭据、库角色限制与 v1 资源读边界;ORIGINAL_RECOVERY:原身份、意图、回执摘要及无二次写;SERVICE_CLOCK:服务端到期和当前租约决定接管;EXPLICIT_OPT_IN:示例通过明确命令启动,普通本地入口不切换;PHYSICAL_HOSTS:本地隔离验证与实体双机、云和生产采用分开,后续仍需实测。全文把 18 路径与远端文件列表核对,当前差异 +1063/-32;从上一审查头到本头只有演练脚本变化。
关键代码讲解
- bundle 从完整提交取运行源码,将 digest 和版本放入包内。Docker 先检查 digest,再解包和装依赖;两次归档逐字节相同,镜像内 917 个归档成员均与原文件一致,另有模板拷入的启动与配置源码。
- prepareDatabase 通过原 schema/role owner 配置受限角色,只给新隔离范围创建或绑定初始任务;重复启动读取既有身份,不重置政策或数据。
- RemoteAuthorityService.dispatch 先核验原 principal、Actor 与请求摘要,再在匹配的历史 todo_add 结果上调用 decodeCoordinationTodoCreateReceipt,与本地创建用同一解释。changed 是返回投影中从原回执推导的事实;不会重写回执或在读回时再创建。
- rehearse.mjs 的续租及接管分支 检查提前接管失败,使用 expires_at 减 updated_at 取得正数且不超过 21 秒的等待量,到期后才验证新 epoch 及旧持有人不能再写。
对主干的风险 / Risks
| 复验 | 结果 |
|---|---|
| 同一解包镜像、同一 20 秒租约、模拟宿主时钟偏差 | 旧脚本在宿主慢 10 秒时触发 21 秒断言;新脚本在快、慢 10 秒两臂均跑完原断言、接管、重启、回执、重放、资源读拒绝与撤权。缓存镜像下新卷读回约 14 秒,只代表本次隔离环境。 |
| 真 PG16/TLS 与本地创建 | 59 项通过,零跳过;包含 File、SQLite、PG 创建,实际提交后丢响应并重启,看到了原摘要和无重复写入。历史基线仅还原两份共享运行文件的反例仍保留:严格客户端无法读取创建回执。 |
| 打包与备份恢复 | 2 个打包测试、TS 检查、重复归档与镜像文件核对通过。复验另一个空项目恢复后相同任务、身份与回执,并拒绝覆盖已有卷。读回五表强制 RLS,运行角色非 superuser 且无 BYPASSRLS,数据库端口未发布。 |
| 仓库检查 | 5 个直接和 19 个选中技术检查及公开边界扫描通过;独立运行缺当前工作区的质量回执,单列为本地合并资格限制。首次虚拟机构建遇到宿主盘满的 I/O 错误,恢复环境后按原命令重跑,保留该历史失败。 |
语义与 CI 对齐
复用已有类型和事务;错误 Actor、错误意图、越界读取、读者写入和撤权保持拒绝。v0 写者仍是信任范围级;v1 只读资源 ACL 不授予写或历史回执权。默认本地入口和已存回执的格式不变;历史恢复结果只扩充满足原严格响应检查的事实。未查询或等待远端 CI。实体 amd64、双机/云、长时间资源干扰、证书和密钥轮换均不得从本次 arm64 隔离演练推断。
我的整体评价 / Verdict
长程方面,丢响应后能重新确认原结果并接着交接,重启或同请求重放不重复应用。用户体验方面,明确分开的启动、可信写、限定读、恢复和备份入口减少了手工配置,并且失败不会扩大权限。检查的是实际 CLI 与 Compose 路径、数据库及隔离状态,未涉及产品渲染页面;截图不适用。
保持这一独立模板与共享回执修复的边界是合理的。旧演练时差问题已解决,正反例均可重跑;该批准限于当前源码和本地可重建包,并保留生产级资格缺口。
English verdict: APPROVE — the packaged PG/TLS path preserves original receipts and passes both host-clock offsets without weakening the lease or reader checks.
…oduct-pg-compose-acl-20261117 Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent; model=gpt-6.1-sol; provider=OpenAI; declaration=runtime_reported; effort=max.
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
动机
让已有Docker Engine与Compose的操作者从固定源码启动隔离的协同示例,并在提交后丢响应时恢复原创建回执。 使用自托管包的操作者和已有远端CLI调用者。主干的todo_add虽已提交,严格客户端恢复时仍退出1;候选复用创建owner解码,读回原Todo且不再创建或扣写一次。 真实 PostgreSQL16.15/TLS 与 File/SQLite 创建套件59项通过、零跳过;同一增强恢复用例在主干因todo_add恢复返回unavailable而失败。 双物理宿主、云部署、资源级写ACL、长期运行及正式安装采用未认证;本轮没有重做备份还原或密钥轮换,文档与其未变实现已读。
改动思路
复用现有PostgreSQL、Todo、lease、ACL与创建回执owner;Compose仅承载显式启动的示例。 当前交付边界:自托管示例与既有创建历史响应的共享解码。 创建解码仍由 Todo create owner 提供;远端只在原 principal、actor、request digest 已匹配后投影历史响应。归档、凭据初始化与 Compose 不成为新的准入或业务状态 owner。
具体改动
本次完整核对18条改变路径及原评审后的差异;当前头为 1286bcb。 固定归档917个源码文件和9个模板逐项匹配,归档摘要与作者当前声明一致;两项打包回归通过。 共享解码 · 原回执恢复
真实 PostgreSQL16.15/TLS 与 File/SQLite 创建套件59项通过、零跳过;同一增强恢复用例在主干因todo_add恢复返回unavailable而失败。 主干对照使用相同增强后的真实集成用例;失败是创建恢复子用例及其父测试,没有把父失败算成第二个独立缺陷。 断言包括原回执摘要和字节、原数据库状态、错误actor及更改意图的拒绝,既有合法流程和File/SQLite创建也通过。
精确归档917个源码文件和9个模板逐项匹配;实际Colima/aarch64包完成启动、接管、创建/完成历史恢复、重启重放、读者过滤、拒写和撤权,自己的容器与卷已退出。 受限数据库角色、两可信写客户端与额外只读客户端通过实际包入口运行;20秒租期和21秒断言上限保留,过早接管仍拒绝。 本机从启动入口到两客户端首次读回93.9秒,包含本次镜像拉取与构建;不是性能比较,测试工具准备另计。
本机起初缺Compose插件,使用官方校验摘要的临时工具补齐后运行;未修改全局配置。严格核心类型检查和当前主干目标的本地premerge通过,5项直接检查及19项选择检查均无失败;按约定未查询CI。
对主干的风险
共享解码必须兼容已有正常创建和重放;File/SQLite/真实PG对照未发现回归。只读授权必须不因新任务出现或改身份而扩展,实际包验证了未列资源、未来任务、四类scope替换、拒写与撤权持久性。 v0的a/b仍是可信Goal范围写者,不能把v1读者ACL说成资源级写隔离;文档已明确区分。双物理宿主、云部署、资源级写ACL、长期运行及正式安装采用未认证;本轮没有重做备份还原或密钥轮换,文档与其未变实现已读。
我的整体评价
批准这个有界自托管与恢复切片。本地自托管与原操作恢复形成可使用的闭环;未把一次本地演练当作多主机或默认provider采用。 复用现有PostgreSQL、Todo、lease、ACL与创建回执owner;Compose仅承载显式启动的示例。 自托管示例与既有创建历史响应的共享解码。 按 docs/reference/remote-authority-task-service-v0.md 在 c3e3ac5 的 RECOVER_ORIGINAL_OPERATION、SCOPE_AND_DEFAULT、PACKAGED_JOURNEY 核对;没有借此宣布R6或云采用完成。
English verdict: APPROVE at 1286bcb. Real PG16/TLS recovery, unchanged-receipt replay, scoped denial and the source-pinned packaged journey pass; physical-host and rollout qualification remain separate.
huangruiteng
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · Codex · OpenAI · self_reported
动机 / Motivation
需要自托管远程 Todo authority、让两个受信客户端交接任务的操作者,过去必须手工拼接 PostgreSQL 角色、TLS、策略、客户端和恢复路径。更容易出错的情况是创建事务已经提交但 HTTP 响应丢失:旧客户端只看到 unavailable,无法从原操作确认已经创建的任务。
当前提交提供固定源码、可重复打包的 Compose 示例,并让历史 todo_add 回执复用原创建 decoder 投影出客户端所需的完整结果。操作者可以从原请求恢复同一个 Todo,不重复写入;普通 File/SQLite provider 不会因此切换到 PostgreSQL。本次边界是可单独启动、验证和停止的自托管示例,不包含双物理宿主、云部署或正式安装推广。
改动思路 / Approach
部署脚本只编排 PostgreSQL、TLS listener、策略和卷;Todo、lease、ACL 与回执仍由现有 TypeScript owner 决定。RemoteAuthorityService.dispatch 在匹配原 principal、actor 和 request digest 后,仅对历史创建回执调用共享 decoder,不重写持久回执,也不把恢复读变成第二次提交。
演练脚本使用服务自身的 expires_at - updated_at 计算租期等待,避免把宿主与容器时钟当成同一时间域。v0 的 a/b 仍是受信 Goal 级写者,v1 reader 的资源 ACL 只负责受限读取;文档没有把只读 ACL 说成资源级写隔离。
| 操作 | 当前 head 的结果 |
|---|---|
| 创建成功但响应丢失 | 原请求恢复同一回执和 Todo,不重复写入 |
| 服务重启后重放 | 返回历史结果,canonical state 不变 |
| 错误 actor、意图或 tenant | 原准入边界拒绝,不产生写入 |
| reader 尝试写入 | v1 只读边界拒绝 |
具体改动 / Changes
完整差异为 18 个文件、+1063/-32:Compose/TLS/卷与演练模板、三份文档、共享创建回执 decoder、remote service 历史投影和集成测试。实际 merge base 为 c3e3ac56586fbbc686e3e2d01b979fe59a62dd19,没有正文所称的默认 provider 切换。
关键代码讲解
build_bundle.py从完整 Git SHA 生成可重复归档,保存 LICENSE/NOTICE、源码摘要和镜像 pin;错误 revision 或已有输出会拒绝覆盖。provision.mjs复用原 PostgreSQL schema/role owner 初始化受限身份、策略和资源,不新建业务准入状态。decodeCoordinationTodoCreateReceipt校验 schema、operation、Goal/Todo 身份后派生changed=true;原 receipt 字节保持不变。RemoteAuthorityService.dispatch只在身份与请求摘要匹配的历史todo_add分支投影该结果,其他命令仍走原 owner。rehearse.mjs用服务时间戳计算有上限的等待,并继续验证 early takeover 拒绝、旧 holder 写拒绝、重启恢复、reader 过滤和撤权。
规范依据为 docs/reference/remote-authority-task-service-v0.md,精确 revision c3e3ac56586fbbc686e3e2d01b979fe59a62dd19。TLS_SCOPE、ORIGINAL_RECOVERY、SERVICE_CLOCK、EXPLICIT_OPT_IN 与 PACKAGED_JOURNEY 在当前切片中有对应实现;PHYSICAL_HOSTS、生产云部署、资源级写 ACL 与长期轮换留在后续验收。
对主干的风险 / Risks
PASS:在隔离真实 PostgreSQL 16.16 上运行 todo_create_reviewed.test.ts 与 remote_authority.integration.test.ts,43 项通过、0 跳过。覆盖真实 TLS、直接提交后丢响应、服务重启恢复、同请求重放、lease takeover、撤权和 File/SQLite/PG 创建。compose bundle Python 测试 2 项通过,control-plane TypeScript typecheck 通过。
主要风险是历史创建响应的共享解码。实现复用原 decoder 并校验原身份,不接受放松后的客户端 schema;正常创建和重放也在同一 suite 中通过。仍未验证双物理主机、真实云网络、生产证书轮换、长期资源干扰和资源级写 ACL,不能从单机 PG/TLS 测试推断这些资格。
我的整体评价 / Verdict
APPROVE。该 PR 在明确的自托管边界内形成了可用闭环:可复现包、受限数据库身份、TLS 入口、原操作恢复和重启重放均有真实路径证据。共享 decoder 修复了丢失响应后的用户恢复,同时保留原回执与权限边界;尚未验证的多宿主机、云和正式采用范围已单独披露。
English verdict: APPROVE at 1286bcb. Real PostgreSQL 16.16 plus TLS proves creation recovery, restart replay, lease fencing and scoped denial; physical-host and production rollout qualification remain separate.
Goal And Delivered Outcome
已有 Docker Engine 和 Compose 的操作者可以从固定源码生成自托管包,运行
./start.sh初始化 PostgreSQL 16、受限数据库角色、私有 CA 和客户端,再通过 CLI 交接任务、读回状态和恢复回执。默认许可的
todo_add在提交后丢失响应时,远端服务现在复用创建操作自己的解码规则生成完整历史响应,保留原回执和摘要;严格客户端可恢复,重放不重复创建。打包演练也改为使用服务端自身的两个租约时间戳和相对等待,避免宿主与服务时钟偏差造成误报。20 秒租约、21 秒上限和后续权限检查均保留。Related to #8747 / #8765;目标分支
main。修复依据:创建恢复评审、时钟偏差复评。Author Declaration
docs/reference/remote-authority-task-service-v0.mdata92b123749e7d2ef0c80e33fa88e40a4c0f572aa;双语自托管说明定义启动、恢复和维护入口。notBefore、重启就绪与三路读回,已在本地独立 PostgreSQL/TLS 实测Scope And Continuation
模板复用现有 PostgreSQL、事务、Todo、lease 与 ACL owner。创建回执解码同时供本地创建命令与远端历史响应使用,持久化格式和原回执不变。演练的时间修复位于现有驱动,没有新增时钟服务、状态机或轮询层;相对等待完整租期,保持有界且保守。
a/b 是 v0 可信范围级写客户端,可以读取同范围其他任务;v1 reader 仅获具体 Goal 实例及资源的 read/snapshot,不取得写权限或历史操作回执。数据库不发布端口,客户端不加入 backend 网络或持有数据库凭据。TLS 覆盖客户端到网关;数据库使用隔离 backend 网络。
关闭示例仅停止自己的 Compose 项目。恢复要求新项目和空目标卷。资源级写隔离、物理双机、正式安装采用、CA 或数据库口令轮换和长期运行仍由原 shared-authority 工作验收。
Validation
1286bcbf89ac35b4fdafeddb44b5988ebe523ae6,验证基线c3e3ac56586fbbc686e3e2d01b979fe59a62dd19。两次打包逐字节相同,归档 SHA-256806f5e9b6c782f1c25468d5db96e0f9c1c17b14e5add122e2f55b809286987d6,内嵌 917 个源码文件匹配 Git。中英运维说明均在实际归档中。5e7c250a29首次启动耗时 184.69 秒。提前核验拒绝尚未生效的证书,原网关继续响应。新证书通过既有 CA 校验后才切换两卷。重启刚返回时观察到 TLS EOF,两个服务健康后均出示新证书,三路客户端读回同一任务。最终文档补足了等待健康的步骤。Previous reviewed runtime evidence
独立评审通过的
2b4b1f5还补做了凭据轮换和九卷备份恢复。47.32 MiB 的合成归档用时 7.85 秒,空项目恢复到原回执读回、旧凭据拒绝和卷覆盖拒绝用时 30.02 秒。2b4b1f54e5b2d53c6c0a86bfc4a12ad73552b884.a92b123749e7d2ef0c80e33fa88e40a4c0f572aa.regression_parityreal_entrypointreal_backendstatic/unitreal_entrypointstaticmanualcqr_e6d8183ee9e3dcd0cedd对精确基线/头有效,1 次有界修复,0 blockers;本地 standard premerge 的 5 direct + 19 选中检查通过,0 failure / warning / manual hold首次单独预取 PostgreSQL 用 22.5 秒、构建用 63.3 秒;上述缓存读回时间不包含它们或 VM 准备,不能据此宣称完整冷启动成本改善。两臂时长受本地环境影响,不作性能比较。旧版预期失败和临时观测脚本的字段读取错误均保留;完成的原始运行记录用于恢复核验,没有重写为成功或重复执行已通过的一臂。
391802d的冷启动 68.8 秒与完整备份恢复 28.9 秒保留为历史证据。新头没有重测整包备份还原、实际证书/密钥轮换、实体 amd64、双物理宿主、云部署或长期运行。该历史候选已独立复评,当前头采用上方验证和独立审阅。Frontend / Visual Evidence
Shared-authority RFC fixture impact
没有改变普通 provider 选择、迁移、持久化记录或 legacy authority 投影。真实远端回归和创建三 provider 检查覆盖共享解码边界;本增量不宣称完成 R6 的全量生产规模、物理双宿主或采用验收。
Boundary Checklist