Repository navigation
fix(cli): retain the qualified public quota default - #9084
loopx-agent wants to merge 4 commits 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 · gpt-6.2-sol · OpenAI (runtime_reported, max)
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
动机 / Motivation
Main 和 Stable 制品构建器会调用真实的 quota JSON writer。普通 CLI 用户和显式声明宿主的调用方也经过这个入口。基线对普通 JSON 构造 Complete Turn v1,超出当前公开制品支持范围。候选恢复普通 quota packet,显式 Complete Turn 和已有宿主继续走签名合约。同一隔离 fixture 的实际制品探针在基线拒绝,在候选接受。两种显式 flag、声明 profile 和 Codex App 的待结算恢复输出保留 v1。本次范围是发布兼容性和当前宿主语义。C1 默认推广、旧路径退役及模型全成本对照沿 RFC 验收。
改动思路 / Approach
在 quota presentation 层按已有 scheduler context 和显式模式决定是否构造签名 Complete Turn。普通成功 JSON 复用现有 quota packet 紧凑投影。运行时代码集中在输出分流、既有 compactor 和参数帮助。验证覆盖预算、分页和制品入口。根据已解析的类型和明确选项分流。披露默认变化,保留不支持的宿主模式拒绝和原捕获的读回身份。
具体改动 / Changes
精确 head 5eab03a8103b4f1d2b44553da25064b3a07abccc,diff base 6a0f8bc17b439f1e5fa1d389ad5a87faf7d73b25,6 个文件 +71/-27。逐项复核 supported-public-default、retained-signed-hosts、real-output-budget、original-capture-recovery。验收约定
关键代码讲解
- 普通 JSON 只有在没有已声明 scheduler context、显式 v1 或 native handoff 选项时采用公开 packet;当前宿主继续构造签名合约。源码
- 成功的普通 packet 沿原有 compactor 保留控制项和按需诊断。未显式指定输出格式时,按原导航命令读回同一 Goal 的 quota packet;原始 capture 保留结算标识。源码
- 预算夹具保留独立的 Complete Turn 模式,新增三个 ordinary JSON 样例。分页夹具按实际字节决定窗口,在两种 provider 都真正经过多页。源码
对主干的风险 / Risks
风险主要是把已声明宿主降为普通 JSON,或在无宿主时绕过拒绝。实测两个显式选项、generic_cli 和 Codex App 待结算恢复仍使用相同 v1 控制。普通捕获的结算标识两版一致,原始 packet 保留读取入口。
语义与 CI 对齐
候选三个普通 packet 预算样例与 File、SQLite 分页恢复均通过。冻结基线和候选的 98 项比较通过。本机用时 16.19 和 18.32 秒。作者记录中的 120 秒预合并超时继续保留。本地显式 Markdown 标题断言、kernel mypy 与全仓 Ruff 的失败在两个提交同样复现,改动文件 Ruff 通过。
我的整体评价 / Verdict
批准当前提交。公开制品的实际探针接受候选,签名宿主调用及原始捕获边界保留。验证限本地精确源代码和隔离数据,原预合并超时及平台验收沿当前状态处理。
English verdict: APPROVE. The actual release probe accepts the supported ordinary JSON packet, with preserved Complete Turn and hosted recovery behavior and passing matched local output checks.
…-release-default-compatibility Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com> (cherry picked from commit 3656ae3) Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com> (cherry picked from commit be17fad) 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.2-sol · OpenAI (runtime_reported, max)
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
动机 / Motivation
Main/Stable 制品构建器与通过 CLI 读取 quota 的调用方共享这个 writer。未声明宿主的普通 JSON 与省略 --format 的入口返回 loopx_turn_envelope_v1。此常规制品探针会拒绝 Main/Stable 制品。实际制品构建器在固定提交的源码归档运行 quota writer。基线观测 v1,发布支持校验拒绝。候选观测 quota_packet 和原 interaction contract,发布支持校验通过。C1 默认采用、匹配成果与完整成本仍沿已接受 RFC 的验收。
改动思路 / Approach
留在 quota presentation 判断输出载荷。使用现有 scheduler context、quota compactor、捕获 reader 与支持校验,无新增持久状态。范围为 CLI 输出显示和既有 release gate,另含两项独立的 Python 静态检查修复。修改原输出选择即可使实际制品符合当前发布合约。保留签名入口与已知历史捕获。预算夹具用显式 v1,普通输出另外使用原限额。当前改动复用已有 owner,后续退休在 C1 资格完成后评估。
具体改动 / Changes
精确 head 35c9b103540bcd5a26e0be6bb1756a57e67ffa2b,diff base b927e20bfbe60817570bceb8654e2bfbc96abadf,8 个文件 +72/-29。逐项复核 public-default-contract、explicit-contract-and-recovery、observed-release-identity。验收约定
关键代码讲解
- 普通和省略 format 的 JSON 回到 release 支持的 quota_packet,已解析宿主与显式 v1 flags 进入原组合。源码
- 普通 JSON 继续使用原 compaction。实际捕获保留原字节和回执,恢复无需另起 guard。源码
- 98 项预算矩阵用相同 fixture 核对 v1,三个普通场景单独使用同一限额。源码
- 分页 fixture 按实际字节选择可分段的窗口,本地静态检查分别处理既有两处问题。源码
对主干的风险 / Risks
主要风险是现有宿主误入普通 JSON、读回身份漂移以及放宽尺寸预算。11 个同输入 CLI 对照、9 项 host capture/Delta 检查、真实发布归档探针及 File/SQLite 恢复覆盖这些条件。错误捕获摘要保持拒绝,当前候选沿用既有预算限额。
语义与 CI 对齐
使用相同生命周期和公开入口,98 项预算基线差分、11 项 CLI 载荷与拒绝对照、9 项宿主捕获与 Delta 检查、两版各 4 项 File/SQLite replan 分段、候选 16 项原捕获结算和两项组合失败恢复通过。Ruff 与 mypy 的实际候选命令通过,基线复现 unused import 与可空 settlement_plan。 扩展同条件测试基线 400 通过、40 失败、11 跳过。候选 405 通过、38 失败、11 跳过。保留 38 个共有失败的精确断言。基线两项分页 fixture 未跨页,候选在 File/SQLite 通过。三个新增普通 JSON 预算用例均通过。 早一版本记录的 120 秒超时依原记录保留,当前固定版本的本地 differential 已通过。
我的整体评价 / Verdict
通过这个精确 head 的兼容性修复。实际归档返回受支持的普通 quota contract,显式 v1、宿主恢复与原回执均有对照证据。本机归档源码、真实 quota CLI 与合成 Goal 的检查已完成。签名桌面安装、实际采用、C1 的匹配成果和完整成本仍待各自验收。
English verdict: APPROVE. The archived release probe accepts the supported ordinary quota packet, and matched CLI checks preserve the explicit Complete Turn, host, and capture recovery paths.
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · Gemini · Google (self_reported)
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
动机 / Motivation
依赖公开默认 JSON 线协议契约的普通 CLI 调用方、Main/Stable 发布制品验证探针以及基于主干运行静态检查的维护者。在主干基准 b927e20bfbe60817570bceb8654e2bfbc96abadf 上,未声明调度宿主且不带开关的普通 JSON loopx quota should-run 默认输出了 loopx_turn_envelope_v1(surface=complete_turn),触发 validate_default_contract 抛出 ValueError 直接阻断发布制品资格校验;同时主干还滞留两处源自待合入切片(#9082)的 Python 静态错误。修复前在精确基线执行默认契约探针和未声明 JSON quota should-run(含 --format json、省略 --format 与 --context-delivery off)会得到 loopx_turn_envelope_v1 并触发 validate_default_contract 报错,且 kernel mypy 与 CI Ruff 失败;修复后上述未声明 JSON 路径稳定返回 schema_version=null 的 quota_packet,已声明宿主(--codex-app、--runtime-profile generic_cli)及 --turn-envelope / --complete-turn 继续返回 loopx_turn_envelope_v1,发布探针与主干静态门禁全部转为通过。普通未声明 JSON quota should-run 恢复输出受支持的 quota_packet 默认契约并通过 release default 探针,声明式宿主与显式开关完整保留 loopx_turn_envelope_v1,CI Ruff 与官方配置的 mypy 检查由基线失败转为全部通过。本 PR 不修改 --format markdown 的标题归属逻辑,不推进尚未完成的 C1 全量默认升级与旧格式退场(deferred 仍由既有 RFC 追踪),也不顺带重写 18 个与本 PR 无关的既有失败测试。
改动思路 / Approach
整体方案遵循 C1 RFC 第 9 节与 public_default_contract.json 的渐进兼容约束,仅在呈现适配边界恢复原有默认出口而不破坏已有受管宿主路径:
- JSON 未声明早退与投影复用:在
compose_quota_work_contract第 19–28 行,当args.format == 'json'、scheduler_context is None且complete_turn、turn_envelope等 7 个显式/原生参数均未传入时,直接原样返回原始payload;随后在_project_quota_cli_payload第 152–163 行复用已有compact_quota_should_run_cli_payload完成紧凑裁剪,产出schema_version=null的quota_packet。 - 显式声明路径与测试边界对齐:在
quota_registration.py将--turn-envelope与--complete-turn帮助说明由误导性的“兼容别名(已默认返回 v1)”校正为“显式选择完整 v1 契约”;同步在cli_output_budget.py为 v1 预算规格表加回--turn-envelope、在test_cli_output_budget.py新增 3 个场景守护未声明quota_packet、修正test_refresh_settle_turn.py分页窗口使file/sqlite均真实测得跨页恢复,并将test_runtime_snapshot_publication.py恢复为正向默认契约断言。 - 并入主干静态阻断修复:本分支同时合并
main(b927e20bfb)并 cherry-pick 了 PR #9082 的两笔单行提交(interaction_contract.py:765参数可空注解与删除test_steward_generic_monitor_todo.py:7死导入),使静态检查与运行时默认契约在同一候选头上共同收口。
改动直接落在现有的 CLI presentation 适配层与预算测试注册表上,完全复用既有的 compact_quota_should_run_cli_payload 与 compose_turn_decision 两个成熟所有者,没有发明新的状态机或平行 CLI 分支。仅限于将未声明 JSON quota should-run 默认行为安全拉回受支持的 quota_packet、保留声明式宿主与显式开关的 Complete Turn 链路、同步对应帮助/预算测试并并入 #9082 静态修复,不代办未认证的 C1 全局切换或主干既有 18 项测试清理。
具体改动 / Changes
本次评审精确目标提交为 35c9b103540bcd5a26e0be6bb1756a57e67ffa2b(基于 b927e20bfbe60817570bceb8654e2bfbc96abadf,共 8 个文件 +72/-29),对照 docs/architecture/rfcs/controller-executor-unified-contract-v0.md 第 9 节与 public_default_contract.json 核验如下:
c1-public-default-quota-packet->implemented:未声明 JSON 路径恢复quota_packet(schema_version=null),发布默认契约探针在基线抛出ValueError、在候选头校验通过。c1-declared-host-complete-turn-preserved->implemented:受管宿主与--turn-envelope/--complete-turn路径保持loopx_turn_envelope_v1,98 行 CLI 差分 smoke 与分页恢复通过。c1-static-checks-main-sync->implemented:并入 #9082 静态修复后,CIRuff与官方mypy全部通过。c1-broader-default-promotion-and-e2e-cost->deferred:更广域的 C1 默认晋升与完整成本对比按原 RFC §9 计划延后推进。
关键代码讲解
compose_quota_work_contract(第 12–28 行):在组合 Complete Turn 前精准检查args.format == 'json'且scheduler_context is None且('complete_turn', 'turn_envelope', 'codex_context_dir', 'codex_context_root', 'prepared_capture_reference', 'defer_context_presentation', 'decision_handoff_socket')全为假值;满足即直接返回原始payload,避免普通脚本触发未认证的v1包装与结算绑定。_project_quota_cli_payload(第 152–163 行):无论上一步产出quota_packet还是loopx_turn_envelope_v1,只要args.quota_command == 'should-run',均按需先从captured_decision_path投影再统一经过compact_quota_should_run_cli_payload裁剪,确保默认quota_packet保持精简与预算边界一致。register_quota_commands&CLI_OUTPUT_BUDGET_SPECS:同步更正--turn-envelope/--complete-turn的帮助说明(“Select the complete v1 work contract...”),并在cli_output_budget.py的quota_should_run与 6 个 detail 规格中显式补回--turn-envelope,使既有 v1 预算检测与 98 行差分门禁持续受测,同时在test_cli_output_budget.py新增test_public_quota_packet_keeps_original_control_keys_and_output_budget(第 1049–1075 行)覆盖 3 组夹具下的普通quota_packet。test_refresh_settle_turn.py&test_runtime_snapshot_publication.py:分页恢复夹具改为min(8000, len(original) // 2),真实保证page_count > 1跨页校验;发布探针测试撤回基线上的临时报错断言,重新严格断言validate_default_contract(observed) == PUBLIC_DEFAULT_CONTRACT。_successor_replan_required_cli_actions:合入 #9082 对第 765 行可空Mapping[str, object] | None的类型对齐及删除test_steward_generic_monitor_todo.py第 7 行未使用导入。
对主干的风险 / Risks
- 10 模式行为矩阵实测对照(BASE
b927e20bfbvs HEAD35c9b10354):--format json、省略--format与--context-delivery off(无宿主无开关):由基线的loopx_turn_envelope_v1恢复为schema_version=null、has_contract_binding=false、has_interaction_contract=true的quota_packet。--context-delivery auto、--turn-envelope、--complete-turn、--codex-app、--runtime-profile generic_cli以及--format markdown:基线与候选头行为完全一致(其中--format markdown无开关因第 20 行限定args.format == 'json'仍输出# LoopX Turn Envelope,属既成基线非新增变化,但值得在后续对齐)。
- 既有基线失败归因透明度(非本 PR 回归):
- 执行扩展回归套共得
486 passed, 18 failed, 1 skipped(test_quota_decision_capture.py、test_turn_envelope.py、test_protocol_packet_history.py、test_quota_settlement_cli.py均全绿;18 项失败分布为test_cli_output_budget.py10 项及test_context_delivery_cli.py8 项);另外单测cli_output_budget.py全文mypy --strict在未改动的第 515 行报markdown_anchor=None类型错误。 - 在精确基线
b927e20bfb上执行同一组 19 项对比与单文件mypy --strict,测得完全相同的 18 failed, 1 passed 及逐字一致的异常签名(KeyError: 'action'/'work_context'/'detail_ref'/'payload_compaction'、startswith('# LoopX Quota Should Run')、60845 <= 59000、todo_fixture_settlement、handoff_decision与第 515 行arg-type),确认为主干既有遗留。
- 执行扩展回归套共得
- 与 PR #9082 的并线提醒:本分支 cherry-pick 了 #9082 的两个提交,内容完全一致但提交 SHA 不同,合入后若另一个 PR 先合入需常规确认 git 合并洁净。
语义与 CI 对齐
- 静态门禁:CI
Ruff全部通过;17 个核心文件mypy通过;2 个 Todo 适配器mypy通过;quota_presentation.py、quota_registration.py、interaction_contract.py严格模式mypy --strict全部通过。 - 发布探针与语义契约:
observe_default_contract/validate_default_contract在基线报错、在候选头通过(surface='quota_packet', schema_version=null);cli-output-base-head-differential-smoke.py98/98 行一致;loopx canary premerge18/18 项全部通过(含check_rfc_bilingual.py、py_compile与semantic-vocabulary-drift-smoke);test_runtime_snapshot_publication.py等 6 个焦点文件138 passed, 10 skipped(跳过项均为os.name == 'nt'Windows 专属用例);新增test_public_quota_packet_keeps_original_control_keys_and_output_budget3 项通过。未依赖或等待远端 GitHub Actions CI。
我的整体评价 / Verdict
PR #9084 精确且克制地修复了未声明普通 JSON quota should-run 默认输出偏离公开契约导致发布验证阻塞的问题,同时守住了已声明宿主和 --turn-envelope / --complete-turn 开关的完整 v1 链路(long_horizon=preserved,user_experience=improved,且未引入或修改 UI 渲染界面)。通过补齐 10 模式基线对比与 18 项主干既有失败同构排查,可确信候选头无新增回归且满足全部本地静态、预合并 canary 与发布契约门禁(未在本机运行的仅限远端跨平台 Windows 矩阵与独立端到端安装包演练)。在代码体量、架构归属与语义规范方面,改动紧贴既有 presentation 边界并复用紧凑投影,未扩大全局词表,批准在当前精确头通过评审(PR 保持 OPEN,不执行合入)。
English verdict: APPROVE at exact head 35c9b10. Restores the qualified quota_packet (schema_version=null) default for undeclared JSON quota should-run callers (unblocking the release default-contract probe) while preserving loopx_turn_envelope_v1 for declared hosts and explicit flags, passes local Ruff/mypy/premerge-canary/differential-smoke checks cleanly, and reproduces all 18 diagnostic pytest failures identically on the origin/main base (b927e20bfb).
Goal And Delivered Outcome
The Main and Stable artifact builders probe the actual ordinary JSON quota writer. On the target baseline the probe observed
loopx_turn_envelope_v1and the supported release contract rejected the artifact. Unhosted JSON calls now use the supported quota packet and its existing compact projection. Declared hosts, native handoff paths and the explicit Complete Turn flags continue to compose the signed v1 contract.The output-budget oracle explicitly exercises Complete Turn with its existing ceilings and control requirements. Three ordinary JSON scenarios have their own tests under the same ceilings. The composition-failure recovery fixture derives its page window from the captured bytes so it exercises a real page boundary on both backends.
Intended base
mainat6a0f8bc17b439f1e5fa1d389ad5a87faf7d73b25. Related #8266 and #9048.Author Declaration
The presentation adapter reuses the parsed scheduler context for host selection and the existing quota packet compactor. The adjacent change makes mode selection explicit in CLI help and the budget fixture.
Scope And Continuation
The compatibility repair is a reversible CLI and validation slice. It keeps the validated public support boundary while preserving the native Complete Turn entrypoints. The remaining C1 default and retirement work stays with the existing RFC.
Validation
Combined candidate
The current head
35c9b103540bcd5a26e0be6bb1756a57e67ffa2bis based onb927e20bfbe60817570bceb8654e2bfbc96abadfonmain. The source now includes both signed-off static-check fixes from #9082. The old #9084 Python workflow stopped on the existing unused import. The #9082 release build stopped on this proposal's default-contract issue. Keeping these fixes together gives CI one candidate on which to run both gates. Python check · Release build · #9082A separate replay applied the exact #9082 and #9090 diffs to the same main baseline. The Python lint command and all four Frontier planning File/SQLite cases passed in that replay. #9090
Earlier candidate
5eab03a8103b4f1d2b44553da25064b3a07abccc.real_entrypointintegrationintegrationintegrationregression_parityregression_parityregression_parityregression_paritystaticstaticSigned Desktop App installation, other native platforms, production activation, live model adoption and matched outcome/cost qualification remain open.
Frontend / Visual Evidence
UI impact none. The change affects the CLI wire and packaging qualification. The exact committed Chat bundle was built and served by the isolated installer.
Type of Change
LoopX Area
Shared-authority RFC fixture impact
The change uses existing state, settlement and workspace authorities.