Skip to content

RFC: unify distribution split and small-kernel runtime composition - #7672

Merged
huangruiteng merged 3 commits into
mainfrom
codex/kernel-composition-rfc-20261029
Oct 29, 2026
Merged

huangruiteng merged 3 commits into
mainfrom
codex/kernel-composition-rfc-20261029

Conversation

@cocolord

@cocolord cocolord commented Oct 29, 2026 •

Copy link
Copy Markdown
Collaborator

The monorepo distribution RFC needs to define what executes as well as where code is installed. This change extends that canonical English/Chinese pair into one design for directory ownership, distribution tiers and minimal/standard runtime composition over a single governance implementation.

The existing filename, tracking issue #5072, M0–M5 distribution milestones, D1–D4 decisions, public-import compatibility, host integration seam and historical evidence are retained. The design adds demand loading, explicit activation, context continuity, managed-task recovery, product/benchmark parity and provider-owned external-effect reconciliation. Runtime qualification is connected to the same delivery plan; selected CLI loading and minimal/standard source composition can qualify before packaging work, while split-package delivery must repeat the qualified journeys on a clean install. Full-parser retirement requires every supported command to migrate with help/diagnostic parity; no mandatory daemon is introduced. No runtime, installation default, schema or permission behavior changes in this PR.

Validation: staged and committed bilingual checks, generated RFC index, local links, table/reference consistency, private-material scan and diff whitespace checks passed. The supported host integration and historical ledger were compared against the prior document and remain unchanged. The five-file loopx check public-boundary scan passed; aggregate checking still reports unrelated local registry diagnostics. No benchmark or device operation was run. Generated indexes also refresh an existing controller/executor ledger count.

Future-facing review: consolidates ownership and acceptance into the existing RFC instead of adding another normative entry. Typed authority and extension lifecycle are reused; runtime extraction remains a characterized implementation slice. Host/composition selection and performance budgets remain explicit open decisions.

Signed-off-by: lusendong.6789 <lusendong.6789@bytedance.com>
Co-authored-by: TRAE CLI <traecli@bytedance.com>
Signed-off-by: lusendong.6789 <lusendong.6789@bytedance.com>
Co-authored-by: TRAE CLI <traecli@bytedance.com>
@cocolord cocolord changed the title RFC: small kernel and on-demand runtime composition RFC: unify distribution split and small-kernel runtime composition Oct 29, 2026
Signed-off-by: lusendong.6789 <lusendong.6789@bytedance.com>
Co-authored-by: TRAE CLI <traecli@bytedance.com>

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Reviewer: model_agent | OpenAI gpt-6.1-sol | reasoning_effort=max | runtime_reported

本次重审精确提交 bffb6b5cc52506be4b6fb3f65fb81e5e77ae2f99,完整读取双语 RFC,并重新核对最后一次提交的全部差异;没有发现本提案自身的阻断 finding。

动机 / Motivation

受影响的是维护包边界、CLI 启动和 managed 任务装配的贡献者,以及需要轻量本地使用和原产品路径兼容的用户。 原 RFC 主要约束目录与发行物;本提案把安装、加载、激活和模型上下文分开,并把最小受治理任务及恢复、产品结果返回和冷安装复验纳入同一计划。

一个稳定文件名和 #5072 下已有的设计,现已同时说明职责、装配、未决选择与可验证的阶段出口;本 PR 交付的是双语设计,未交付新的运行时或安装物。 不新增模型 loop、调度器、authority 存储、设备框架或强制 daemon;不批准新默认值、benchmark 运行、设备操作或宿主晋级。

独立依据是变更前已接受的规范:spec_ref=docs/architecture/rfcs/monorepo-distribution-split-v0.md;spec_revision=f2990e3de49d6aa7441e0e0b739f49bfc84aae38。本次核对 I1、I2、I3、I4、I5、I6 的原有单仓库、唯一 authority、公开 import 兼容、off-state、Node 缺失诊断与公开/私有/schema/许可证约束均保留。M0、M1、M2、M3、M4、M5 仍是原发行计划的未来实施;D1、D2、D3、D4 仍未被本提案批准。新增 V/R 条目及 D5–D7 是本次待接受的设计,不能作为自身运行交付已合格的证明。

改动思路 / Approach

安装、加载、激活和模型上下文分别约束,minimal/standard 复用同一治理实现。已有 typed TS owner 保留 work、lease、budget、stop、effect、receipt 与 recovery;宿主保留模型/工具执行;capability 选择策略;前端和 connector 继续使用既有命令及投影。

阶段 可独立交付的价值 保留的边界
R0 一个真实 selected CLI 路由的加载/兼容与开销基线 可以先于目录、打包;不等于内核运行合格
R1 / R2 源码装配的 managed 任务、恢复及一个产品工作流 可以先于 M3;源码验证不替代发行安装资格
M3 干净拆包安装后复验已合格的 R1/R2 旅程 保留 M1/M2、Node 和组合选择门槛
R3 / R4 另行授权的匹配实验或具体外部操作 不阻塞已合格 CLI/managed 切片,不授予运行权限

表格是设计路径说明,不是执行证据。本轮相邻简化已应用:沿用既有 RFC、文件名和 #5072,避免平行“小内核”设计与任务账本;没有要求先完成全部结构迁移才交付有用加载接缝,也没有预建无调用方的框架。

具体改动 / Changes

最终范围是五个 Markdown/索引路径,+551/-32,没有生产源码变更。README 与双语 STATUS 指向同一现行标题;controller/executor 台账计数修正为实际四条,没有因此宣称新 runtime 阶段完成。

关键内容讲解

  • §2 / §5:用户旅程、职责与 preset 分层;一个 minimal 任务必须可执行和恢复,安装 standard 也不自动激活服务或授予权限。
  • §5 / §7 / §8:按需加载与完整上下文,unknown effect 的核对、停机边界、fallback 退役条件,以及切换 binding 前静止/核对;不能让两个 writer 同写一个 binding,也不把模型停止当成设备确认停止。
  • §9 / §11 / §12:V1–V10 分开语义、真实任务、安装、性能和实验资格;候选 p95 数值仍是 D6 建议。R1/R2 可先验证源码,但 M3 前后不能混淆冷安装资格。原 M0–M5 和 D1–D4 的身份、owner 与历史证据继续保留。

固定版本 DSH minimal/standard preset 确为同一 agent-preset 的不同 plugin 列表,SDK minimal 是自包含装配;Pi 的 transformContext / convertToLlm / prepareRequest / finishTurn 接缝也与所引一手源码一致。这些只支持装配设计,不证明 LoopX 宿主、权限或性能已合格。当前 CLI 的 selected dispatcher/fallback 与 performance-diagnosis 所述接缝已核对,未把源码审计写成实测加速。

完整中英文语义对照、committed bilingual check、生成索引检查通过;原生 premerge 的 4 项 direct + 18 项 selected 技术检查及公开/私有边界通过。没有查询、轮询或等待 GitHub CI。

对主干的风险 / Risks

补跑架构两套测试得到 27 passed / 2 failed。不可变 f2990e3de49d6aa7441e0e0b739f49bfc84aae38 和本次精确 head 的失败身份及细节一致:Lark projection 的 request_control_api → extensions.lark.manager_routing,以及 loopx-codex-provider-routing → loopx.runtime_activation。测试及两处实际原因源码逐字节相同,PR 只有五个文档路径;它们属于既有导入债务,未被本提案修复。

CQR 如实保留该 required validation 失败,外层 premerge 为 quality_invalid_receipt。本次设计审阅可以批准,完整验证、merge readiness 和 maintainer authority 仍是独立门槛,不能把技术子项通过或这份评审当成豁免。未来实现最需要防止的是:把 help 加速、源码 smoke 或文件数减少当作有用 managed 任务、恢复或安装已经通过。

我的整体评价 / Verdict

APPROVE,本次设计提案没有阻断 finding。 它给出了统一、可分段验证且可回滚的下一步,保留原兼容与 authority 契约;更大阶段仍由既有 #5072 及相关 owner 验收,不另造平行计划。

本 PR 仅改 RFC 正文与索引,没有改变渲染布局或产品首屏;已检查完整中英文文档、相对链接和实际调用边界。 未验证 minimal/standard 的运行实现、冷安装、真实模型采纳或性能收益;这些是后续资格条件。 没有执行合并、设备操作、付费模型实验或默认值变更。

English verdict: APPROVE

@huangruiteng
huangruiteng merged commit 58205c6 into main Oct 29, 2026
26 checks passed
@huangruiteng
huangruiteng deleted the codex/kernel-composition-rfc-20261029 branch October 29, 2026 15:00
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.

3 participants