From bac26169eb0110aef52f59f736d23b9ed53ef335 Mon Sep 17 00:00:00 2001 From: wchwawa Date: Wed, 2 Sep 2026 20:52:51 +1000 Subject: [PATCH] docs(rfc): record Stage 4 keepalive and provider-binding decisions Add two open owner decisions to Section 12 in both language mirrors: whether the Stage 4 canary must hold Host lease liveness (renew during Host execution and cancel on fence loss, an effect-owning fenced commit, or a hard Host duration bound) before admission instead of leaving it as a Stage 5 hold, and how a canary Goal's authority provider is bound through a registry record instead of an argv guard selector. Both questions were raised by the review of #3820 and must be settled before that canary is re-cut. Signed-off-by: wchwawa --- ...shared-goal-authority-state-provider-v0.md | 21 +++++++++++++++++++ ...-goal-authority-state-provider-v0.zh-CN.md | 15 +++++++++++++ 2 files changed, 36 insertions(+) diff --git a/docs/architecture/rfcs/shared-goal-authority-state-provider-v0.md b/docs/architecture/rfcs/shared-goal-authority-state-provider-v0.md index 1ac7f3ad16..16c236b6b0 100644 --- a/docs/architecture/rfcs/shared-goal-authority-state-provider-v0.md +++ b/docs/architecture/rfcs/shared-goal-authority-state-provider-v0.md @@ -1404,6 +1404,27 @@ shipped production capability. canary? Provider selection does not change the authority contract. 5. Before production use, what retention and capacity policy replaces or operationalizes `retain_all_v0` without losing historical proof? +6. Does the Stage 4 canary require Host lease liveness before admission, or + is that a Stage 5 promotion hold? Section 11 asks the canary to observe + that no external effect is duplicated, but a Host whose runtime exceeds the + lease TTL can keep producing effects after another Agent reclaims the Todo, + and a settlement rejected afterwards cannot undo them. The review of #3820 + treated this as a Stage 4 precondition; the RFC must say which mechanism + is required and where: renewing the lease while the Host runs plus + cancelling the Host when the fence is lost, an effect-owning fenced commit + inside the recoverable protocol, or a hard Host duration bound below the + TTL. *Proposed answer: any canary that runs a real Host must renew during + Host execution and cancel on fence loss, and its acceptance must include + the long-Host expiry/reclaim negative test; a bounded fake Host is not + evidence for this row.* +7. How is the canary's authority provider bound to a Goal? A CLI argument + that names an arbitrary guard command is a test-harness convenience, not a + product authority selector. *Proposed answer: the binding is a + goal-level registry record published by the same owner as the + authorization projection in question 2, naming the provider kind, the + store identity or lineage, and an explicit TEST ONLY canary marker; a Goal + without that marker cannot be admitted by a shared-authority guard, and + the runtime resolves the provider from the record rather than from argv.* --- diff --git a/docs/architecture/rfcs/shared-goal-authority-state-provider-v0.zh-CN.md b/docs/architecture/rfcs/shared-goal-authority-state-provider-v0.zh-CN.md index 0bb4d1d851..cd8d5ef116 100644 --- a/docs/architecture/rfcs/shared-goal-authority-state-provider-v0.zh-CN.md +++ b/docs/architecture/rfcs/shared-goal-authority-state-provider-v0.zh-CN.md @@ -1124,6 +1124,21 @@ retention 决策,不能用一个会制造第二 writer 的诊断 CLI 代替。 Provider 选择不改变 authority contract。 5. Production 使用前,什么 retention 与 capacity policy 可以替代或落实 `retain_all_v0`,且不丢失历史凭证? +6. Stage 4 canary 在准入前是否要求 Host lease liveness,还是把它留作 Stage 5 + promotion hold?第 11 节要求 canary 观察"外部 effect 不重复",但运行时间超过 + lease TTL 的 Host 会在另一个 Agent reclaim 该 Todo 之后继续产生 effect,事后 + 拒绝 settlement 也无法撤销它们。#3820 的评审把这一点当作 Stage 4 前置条件; + RFC 必须写明要求哪种机制以及落在哪一层:Host 运行期间续约并在 fence 丢失时取 + 消 Host、可恢复协议内的 effect-owning fenced commit,或把 Host 时长硬性限制在 + TTL 之下。*拟议答案:任何运行真实 Host 的 canary 都必须在 Host 执行期间续约并 + 在 fence 丢失时取消,其验收必须包含长 Host 过期/reclaim 负例;有界的 fake Host + 不能作为这一行的证据。* +7. canary 的 authority provider 如何绑定到 Goal?用 CLI 参数指定任意 guard 命令只 + 是测试 harness 的便利,不是产品级 authority selector。*拟议答案:绑定是一条 + goal 级 registry 记录,由问题 2 中发布 authorization projection 的同一 owner 发 + 布,记录 provider 种类、store identity 或 lineage,以及显式的 TEST ONLY canary + 标记;没有该标记的 Goal 不得被 shared-authority guard 准入,runtime 从该记录而 + 非 argv 解析 provider。* ---