Repository navigation
docs: cite the merged Shared Authority design in the community FAQ - #9006
loopx-agent wants to merge 1 commit into
Conversation
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: Gemini | provider: Google | declaration_source: self_reported (host observation unavailable)
动机 / Motivation
受影响对象与触发任务:查阅 LoopX 社区中英文 FAQ 了解跨主机多人共享权威访问状态的读者与维护者。
变更前后场景:修改前:docs/product/use-cases/community/faq.md 与 faq.zh-CN.md 仍将已在 2026-11-17 合入主干的 PR #8747 写成「Open PR #8747 / 尚未合入的 PR #8747」且链接旧 PR 编号而非已合入 RFC 具体章节。修改后:双语 FAQ 同步更新为「已合入设计」,并分别指向提交 1b18ece 下 Shared Authority RFC 中英文版对应 #cross-person-delivery-under-r6 锚点。
可观测结果:中英文 FAQ 对 #8747 状态表述与已合入历史一致,链接均精确定位到 1b18ece 对应 RFC 锚点(含中文显式锚点 ),且保留原有资源权限、租约与预算前置条件。
边界与非目标(Non-goals):不将 R6 跨主机或跨人交付宣称为已完成运行时发布或默认能力,也不改动其他 FAQ 条目或源码实现。 若不修正,社区文档会持续向用户传递“#8747 仍未合入”的过期状态;作为双语纯文档修正切片,本 PR 完整解决该陈述滞后且不涉及额外未决需求。
改动思路 / Approach
入口为公开社区 FAQ 双语文件 docs/product/use-cases/community/faq.md(L98-L101)及 docs/product/use-cases/community/faq.zh-CN.md(L79-L82)。权威真源方面,通过 gh pr view 8747 核实 #8747 已于 2026-11-17T06:58:22Z 以合并提交 1b18ece5906611eb6dd71941d1e2475443c19009 合入主干。本次直接复用仓库既有 FAQ 固定提交 SHA 外链惯例(同页紧邻的 #L95 与 #L76 即采用固定 SHA 引用),不改变任何架构边界、运行时状态或外部 IO;文档仍严守候选限制声明,未将设计文档合入误写成默认运行时能力。
具体改动 / Changes
关键内容讲解
docs/product/use-cases/community/faq.md(L98-L101):将Open PR #8747更新为已合入说明,并将Shared Authority RFC指向https://github.com/loopx-project/loopx/blob/1b18ece5906611eb6dd71941d1e2475443c19009/docs/architecture/rfcs/shared-goal-authority-state-provider-v0.md#cross-person-delivery-under-r6;原本「proposal」字样调整为「design」,末尾授权交集与资源 ACL/租约/预算限制完整保留。docs/product/use-cases/community/faq.zh-CN.md(L79-L82):同步将「尚未合入的 PR #8747」更新为已将跨人资源访问设计合入对应中文 RFC 锚点(#cross-person-delivery-under-r6),「提案」改为「设计」,保持中英双语一致。- 规范对照:无独立前置书面 RFC 专门规定 FAQ 措辞格式(
no_spec/spec_source: none),但逐行核对合入提交1b18ece590的英中 RFC 原文,正文对四类授权交集与否认条件描述准确一致。
对主干的风险 / Risks
无阻塞性发现(No blocking finding)。
- 锚点与版本负向核对:对英文文件仅看标题易误判中文 RFC 可能缺失
#cross-person-delivery-under-r6锚点;经git show 1b18ece5906611eb6dd71941d1e2475443c19009:docs/architecture/rfcs/shared-goal-authority-state-provider-v0.zh-CN.md实测,第 1460 行明确定义了<a id="cross-person-delivery-under-r6"></a>(位于#### R6 跨人交付上方),英文版第Cross-person delivery under R6标题同样对应#cross-person-delivery-under-r6,双端锚点均有效。 - 本地独立验证结果(精确 Head):
gh pr view 8747&git show 1b18ece590: PASS(确认PR #8747为MERGED且英中 RFC 锚点与描述匹配)python3 examples/docs-governance-smoke.py:PASS (docs-governance-smoke ok)python3 scripts/check_rfc_bilingual.py --base origin/main --head HEAD:PASSloopx check --scan-path docs/product/use-cases/community/faq.md --scan-path docs/product/use-cases/community/faq.zh-CN.md:PASS(0 errors / 0 warnings)loopx canary premerge --tier quick --from-git-diff --git-diff-base origin/main:PASS(merge_gate_passed: true)
我的整体评价 / Verdict
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
- 成果影响(outcome_impact):
long_horizon:not_applicable—— 仅修正两份 FAQ 文档中已合入 PR 状态描述与 RFC 锚点链接,不涉及控制平面持久化、调度或重试路径。user_experience:improved—— 消除社区读者对 PR#8747是否已合入的困惑并直达对应 RFC 合入版本段落;界面视觉方面visual_review为not_applicable(reason: 仅修改中英文 FAQ Markdown 文档链接与状态词,未更改任何前端渲染布局;unverified_scope: none)。
- 体量与兼容性(code_volume):2 个双语文档
+7/-6行;compatibility_assessment为not_applicable(纯 Markdown 文档文案更新)。 - 词汇分类判断:未新增或修改任何共享状态词表。
- 残余风险(Residual Risk):无阻塞性残余风险;固定到提交
1b18ece590的 RFC 链接若将来作为「当前权威进展」随后续 RFC 修订需再同步锚点版本(远端 CI 未等待,ci_policy: not_consulted)。
评审精确提交:9006@10357cbc05731d493ed8d34330b7006787c04fa1。
English Verdict: APPROVE
Goal And Delivered Outcome
The community FAQ from #8842 still described #8747 as open. Both languages now link to the Shared Authority design at its merge revision. Cross-host deployment and product qualification still require the checks in the RFC.
Author Declaration
Written by model_agent, OpenAI GPT-6.
Scope And Continuation
Complete within the bilingual FAQ correction. Cross-computer qualification is tracked by the RFC's R6 criteria. The integration target is
main.Validation
Tested revision
10357cbc05731d493ed8d34330b7006787c04fa1against merge base09d0fa13594235fcd3dc13c5bd63abaf35a2d9aa. Runs finished using public repository inputs.docs/reference/protocols/turn-envelope-v0.mdtobenchmark/runtime/RUNTIME.mdoutside the documentation tree. The inputs to that link check match across both revisions.Hosted checks and independent review are pending.
Frontend / Visual Evidence
UI impact
none. The correction appears within existing FAQ text below the first viewport.Type Of Change And Routing
Documentation update for the community FAQ. The cited design belongs to Shared Goal Authority and cross-host coordination.
Boundary Checklist