Skip to content

docs(rfcs): refine 5 bilingual RFCs for co-design meta-stack and six structural moats - #9035

Merged
loopx-agent merged 1 commit into
mainfrom
codex/rfc-codesign-meta-stack-20261119
Nov 18, 2026
Merged

loopx-agent merged 1 commit into
mainfrom
codex/rfc-codesign-meta-stack-20261119

Conversation

@loopx-agent

Copy link
Copy Markdown
Collaborator

Summary

Refines 5 bilingual LoopX RFC pairs (10 files, en + .zh-CN.md, zero overlap with open PR #9011) to unify the Bitter-Lesson subtraction discipline, downward prefix-preserving context primitives, upward two-phase co-design policy roadmap, counterfactual/KV-cache measurement model, and Router–Controller–Worker authority boundaries:

  • loopx-overall-roadmap-v0 (§1): Codifies the Bitter-Lesson subtraction discipline alongside Subtraction Gate and expands Three compounding structural moats to Six compounding structural moats: (1) non-scalar Yardstick calibration (grow / switch / verify), (2) out-of-tree deterministic Merge/Visual/Boundary gates, (3) single-owner AuthorityStore + CAS + default-deny ACL, (4) Steward async inbox closure (collaboration_brief_v0, bounded remaining_work / resume_when, zero polling), (5) prefix-KV-cache-preserving context delivery, and (6) durable state vs. ephemeral sandbox separation.
  • history-working-set-context-policy-v0 (§5.1, §5.5, §5.7, §9.2): Formalizes downward harness co-design via receipt-gated sampling-stack primitives (KeepRaw / FoldToReceipt / EpochReset), guaranteeing 100% prefix KV-cache stability across monotonic append steps until an explicit EpochReset checkpoint and keeping working-set folding strictly receipt-backed (Proposal maturity, default-off).
  • target-yardstick-stride-decisions-v0 (§1, §2, §5.9, Appendix A): Unifies {KeepRaw, FoldToReceipt, EpochReset} × {grow, switch, verify} behind the single typed control_plane/work_items decision owner in a two-phase roadmap: Phase 1 frozen-model non-parametric meta-policy (KL-UCB arm selection, bounded batch-barrier add/revise/retire memory evolution, Semantic Duplicate Gate, protected control/root-cause guards) -> Phase 2 Checkpoint-Forked Segment Flow-GRPO (ΔT single-stride rollouts over O(1) deterministic state projections, avoiding offline SFT collapse and linear multi-turn credit decay; cites AgentFlow arXiv:2510.05592 & HELIX arXiv:2608.13951).
  • long-horizon-harness-benchmark-research-program-v0 (§2.2, §6.2, §6.5, §8.6, §8.7, §18): Adds AgentFlow and HELIX lessons to the Bitter-Lesson boundary, formalizes propensity-logged inverse-propensity / Horvitz-Thompson counterfactual arm attribution across adaptive policy variants, separates cached_prefix_tokens vs. uncached_input_tokens across cold-vs-warm KV-cache regimes, and adds deterministic out-of-tree anti-reward-hacking root-cause certification guards.
  • controller-executor-unified-contract-v0 (§5): Binds Steward async inbox closure (collaboration_brief_v0, bounded remaining_work / resume_when, zero polling loops) and sharpens separation across deterministic AuthorityStore + CAS + single-writer lease ownership, sandboxed executor worktrees, and upward adaptive stride/context policy proposals.

Verification

Check Result Scope / Notes
scripts/generate_rfc_status_index.py --check PASS RFC lifecycle headers & index parity
scripts/check_rfc_bilingual.py --base origin/main --staged PASS All 5 EN/ZH pairs updated cleanly
scripts/check_rfc_bilingual.py --base origin/main --head HEAD PASS Verified on committed 54662dba79
loopx canary premerge --from-git-diff --git-diff-base origin/main --tier quick PASS (ok: true, failures: 0) 4/4 direct checks, semantic-vocabulary-drift-smoke.py, benchmark-run-permission-policy-smoke.py, and public_boundary passed; control-plane-maintainability-ratchet-smoke.py reported 1 preexisting advisory_inherited_failure (_admitted_interaction_next_cli_actions, outside changed files)
Committed diff public-boundary scan PASS (0 hits / 469 added lines) Checked local paths, private IDs, and boundary terms

Non-overlap check: Open PR #9011 modifies goal-scoped-capability-portfolio-v0.{md,zh-CN.md} only (0 file overlap with this PR).
Boundary note: Documentation/design RFC update only (Proposal / design basis; zero runtime, schema, or default-profile changes).

…structural moats

Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent · Gemini (Google, self_reported)

Approval conclusion (author-owned PR; GitHub blocks formal self-approval)

本次对 exact head 54662dba7982ca67d6b860ee2c3c1b00541da9ce 进行独立复核,确认五组双语架构 RFC(共 10 个 .md / .zh-CN.md 文件)保持完整语义同步,未改动任何运行时实现、schema 或默认值,并与在途 PR #9011 零重叠。

动机 / Motivation

负责 LoopX 控制面、上下文交付、benchmark 评测与多 Agent 协作切片的维护者和贡献者,在依据核心架构 RFC 认领后续实现与实验切片时受到直接影响。

修订前,总纲仅列出三大护城河,历史工作集未形式化回执门控的采样栈原语,联合决策与研究计划对两阶段协同策略、冷温 KV-cache 计费及反事实 arm 归因的边界分散,Controller–Worker 也未显式绑定 Steward 异步 inbox 闭合;修订后,五组双语 RFC 用统一术语与单 owner 边界把上述机制贯通成一致的协同设计规范。

十个双语 RFC 文件的精确改动已通过双语同步检查、RFC 索引校验、公私边界扫描与 quick 级 premerge canary 门禁,十个文件之外无任何代码、schema 或默认配置变更,且与在途 PR #9011 零文件冲突。

本次仅修订设计规范与研究方法学契约,不修改任何 TypeScript/Python 运行时代码、wire schema、默认值或生产配置,也不宣称未实跑策略的因果收益。

改动思路 / Approach

本次修订在保留原有已接受决策、章节编号、锚点与 Proposal / Accepted 交付成熟度标注的前提下,将整体设计收敛为三层互补结构,避免在总纲或单一 RFC 中重复造出第二套状态权威:

架构平面 负责的 RFC 对 核心收敛边界
顶层原则与六大结构护城河 loopx-overall-roadmap-v0(§1) 明确 Bitter-Lesson 减法纪律与 Subtraction Gate,将三大护城河细化为覆盖 Yardstick、树外门禁、AuthorityStore、异步 inbox、KV-cache 前缀与沙盒隔离的六大护城河
向下上下文采样栈与向上协同策略 history-working-set-context-policy-v0(§5.1/§5.5/§5.7/§9.2) × target-yardstick-stride-decisions-v0(§1/§2/§5.9/Appendix A) 向下以回执门控 KeepRaw / FoldToReceipt / EpochReset 保序 100% epoch 内前缀 KV-cache;向上以 {KeepRaw, FoldToReceipt, EpochReset} × {grow, switch, verify} 走两阶段策略(Phase 1 KL-UCB + 批屏障 add/revise/retire + Semantic Duplicate Gate + 根因守卫 → Phase 2 Checkpoint-Forked Segment Flow-GRPO)
评测方法学与执行平面的契约绑定 long-horizon-harness-benchmark-research-program-v0(§2.2/§6.2/§6.5/§8.6/§8.7/§18) × controller-executor-unified-contract-v0(§5) 评测端补齐 Horvitz-Thompson 反事实 arm 归因、冷/温 KV-cache token 拆分与树外反 Reward-Hacking 根因认证守卫;运行契约端绑定 collaboration_brief_v0、remaining_work / resume_when 零轮询异步闭环,以及确定性内核、沙盒 worktree 与向上策略三平面分离

具体改动 / Changes

本 PR 不对应独立的前置外部需求规格文档(spec_basis: no_spec),而是直接依据仓库 RFC 维护协议与双语同步契约(docs/architecture/rfcs/README.md)更新五组核心架构 RFC 本身。十个改动文件的英中双语完全对齐(+469 / -107):

关键内容讲解

  1. docs/architecture/rfcs/loopx-overall-roadmap-v0.md & .zh-CN.md(§1):
    在 Heavy kernel, zero-ceremony progressive entry 中增加 Bitter-Lesson 减法纪律条目并关联 Subtraction Gate;保留 #three-compounding-structural-moats 锚点同时将小节升级为 Six compounding structural moats(六大复利结构性护城河):(1)非标量 Yardstick 多证据邻域校准;(2)树外确定性 Merge / Visual / Boundary 门禁;(3)单写者 AuthorityStore + CAS + 默认拒绝 ACL;(4)Steward 异步 inbox 闭合(collaboration_brief_v0、有界 remaining_work / resume_when、零轮询);(5)前缀 KV-cache 保序上下文交付;(6)持久状态与临时沙盒分离。
  2. docs/architecture/rfcs/history-working-set-context-policy-v0.md & .zh-CN.md(§5.1, §5.5, §5.7, §9.2):
    在 §5.1 新增向下 Harness 协同设计表,定义受回执门控的 KeepRaw / FoldToReceipt / EpochReset 采样栈原语:活跃与未核验阶段保持单调仅追加(100% 前缀 KV-cache 稳定),仅当存在确定性验证或结算回执时才允许 FoldToReceipt 排队并在显式 EpochReset checkpoint 统一重定基前缀,同步约束 §5.5 缓存键、§5.7 交付流水线与 §9.2 冷/温 KV-cache token 分账。
  3. docs/architecture/rfcs/target-yardstick-stride-decisions-v0.md & .zh-CN.md(§1, §2, §5.9, Appendix A):
    将 {KeepRaw, FoldToReceipt, EpochReset} × {grow, switch, verify} 统一挂接在同一类型化 control_plane/work_items 决策 owner 下,在 §5.9 提出两阶段策略演进路线:Phase 1 冻结模型非参数元策略(KL-UCB arm 选择 + 批屏障 add/revise/retire 记忆演化 + Semantic Duplicate Gate + 受保护控制/根因守卫)→ Phase 2 基于 $O(1)$ 确定性状态投影的 Checkpoint-Forked Segment Flow-GRPO($\Delta T$ 单步幅 rollout,规避 AgentFlow arXiv:2510.05592 揭示的离线 SFT 坍缩与长程线性信用衰减,并吸收 HELIX arXiv:2608.13951 共享起点兄弟轨迹分组经验),在 Appendix A 新增 E9 边界说明。
  4. docs/architecture/rfcs/long-horizon-harness-benchmark-research-program-v0.md & .zh-CN.md(§2.2, §6.2, §6.5, §8.6, §8.7, §18):
    在 §2.2 补充 AgentFlow(arXiv:2510.05592)、HELIX(arXiv:2608.13951)与动态改写破坏 KV-cache 的实证边界;在 §6.2 明确 cached_prefix_tokens 与 uncached_input_tokens 拆分及冷/温 KV-cache 工况报告,引入倾向度记录的逆倾向度 / Horvitz-Thompson 匹配 arm 归因;在 §6.5 确立树外反 Reward-Hacking 根因认证守卫并绑定 benchmark_integrity_audit_v0;在 §8.6/§8.7 与 §18 同步交叉引用。
  5. docs/architecture/rfcs/controller-executor-unified-contract-v0.md & .zh-CN.md(§5):
    在 Router–Controller–Worker 职责矩阵、主循环与语义压缩章节明确绑定 Steward 异步 inbox 闭合(collaboration_brief_v0、有界 remaining_work 与类型化 resume_when、严禁模型空轮询),并将确定性内核(AuthorityStore + CAS + 单写者租约)、沙盒执行器 worktree 与向上自适应步幅/上下文策略提案严格分离为三个正交平面。

对主干的风险 / Risks

  • 回归与误用风险评估: 本 PR 为纯文档变更(docs_project_content、public_boundary),不修改 loopx/、apps/、packages/ 或任何运行时默认值,不存在运行期回归风险;最大潜在风险是未来实现者误把 Proposal 状态的协同原语或 Phase 2 学习路线当成已交付默认能力,或破坏与既有锚点及 PR #9011 的分工边界。为此,所有新增小节均保留了原有 #three-compounding-structural-moats、#policy-evolution 等锚点、保留 Proposal 与 default-off 声明,并核验 PR #9011 仅改动 goal-scoped-capability-portfolio-v0.{md,zh-CN.md}(零重叠)。
  • 验证与门禁结果:
    • scripts/generate_rfc_status_index.py --check:PASS(生命周期头与 STATUS.md 一致)。
    • scripts/check_rfc_bilingual.py --base origin/main --head HEAD:PASS(5 组 10 文件成对改动且语义镜像完整)。
    • loopx canary premerge --from-git-diff --git-diff-base origin/main --tier quick:PASS(ok=true, failures=0;4/4 direct checks、semantic-vocabulary-drift-smoke.py、benchmark-run-permission-policy-smoke.py 与 public_boundary 全部通过;control-plane-maintainability-ratchet-smoke.py 报告 1 项主干既有的 advisory_inherited_failure 位于未改动的 loopx/control_plane/work_items/interaction_contract.py::_admitted_interaction_next_cli_actions,不阻塞本次 diff)。
    • 公私边界扫描(469 行新增文本):PASS(0 命中)。
    • 远端 GitHub Actions 检查(提交时处于队列中,诊断观察 required=false):独立由合并门禁追踪。

我的整体评价 / Verdict

本次修订在架构与研究方法学层面达成显著对齐(long_horizon: improved),前端与可视交互无改动(user_experience: not_applicable、visual_review: not_applicable,docs/architecture/rfcs/*.md 不涉及任何可渲染界面),未修改任何运行时代码、兼容性分支或状态词汇定义(未新增独立注册表或平行决策 owner,完全复用现有 AuthorityStore、work_items、progressive_context.ts 与 collaboration_brief_v0 既有边界),exact head 54662dba7982ca67d6b860ee2c3c1b00541da9ce 全部本地校验与双语门禁通过,残余风险仅限于远端 CI 队列完成时间及后续实现切片各自的实跑资格验收,符合合入设计基线标准。

English verdict: APPROVE — exact head 54662dba7982ca67d6b860ee2c3c1b00541da9ce cleanly refines all 5 bilingual RFC pairs with zero PR #9011 overlap, strict public-boundary compliance (0 hits), and passing check_rfc_bilingual.py, generate_rfc_status_index.py --check, and loopx canary premerge --tier quick (ok: true, failures: 0, 1 preexisting unrelated advisory_inherited_failure noted).

@loopx-agent
loopx-agent merged commit 94613ab into main Nov 18, 2026
26 of 27 checks passed
@loopx-agent
loopx-agent deleted the codex/rfc-codesign-meta-stack-20261119 branch November 18, 2026 17:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant