Repository navigation
Conversation
Signed-off-by: cicolord <cicolord@outlook.com>
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · gpt-6.2-sol · OpenAI · runtime_reported · reasoning_effort=max
独立评审提交 661e340。本次复现两项需要修复的交互问题。
[P2] 让已就绪的研究命令进入 Core 命令参考
匹配 Research wheel 的两条 --help 均返回 0,两项能力均 ready=true。新装操作者按 Core 顶层提示运行 loopx commands 时,两条命令都缺席。 在 Core 命令参考按已安装判定加入两条现有路由,复用其描述,保持 listing 的按需加载。 安装匹配 wheel 后验证 commands JSON 同时包含两条入口且不导入 research runtime。卸载后两条从可用命令列表退出。 相关代码
[P2] 让安装诊断指出研究 wheel 版本和缺件
在同一隔离实装把 Research 版本改成与 Core 不同,或移开外部证据的 TS 资源。选中命令拒绝而 doctor --installation-only 仍给出 ok=true,输出没有 companion 版本或不可用原因,安装指纹消失。 复用 wheel 元数据/所有权检查在 doctor 中读回 companion 的安装版本及不兼容原因,保证健康 Core 的普通入口继续工作。 在实装中依次检验匹配安装、错版本、缺资源、卸载和重装,验证诊断明确指出原因和恢复状态,并保留原账本。 相关代码
动机 / Motivation
受影响的是用独立 Core 查找现有研究项目、续跑私有证据账本或核验外部材料的操作者。 旧 Core 内含研究实现,但这两个命令要用普通发行版。候选把实现放进可选 wheel,安装后可直接执行原命令并读取现有账本。 独立安装已能继续原账本、产出引用报告并重放外部证据入账。专用帮助与能力目录显示就绪时,Core 命令参考仍漏掉两个入口。 本轮覆盖 macOS arm64 的 Core 与 Research 实装、普通源码发行路径和确定性材料。真实远端来源与模型成本需要对应运行证据。
在同一个安装可用性判定下补齐命令发现和安装诊断,再用实装缺件、错版本和移除场景读回。
改动思路 / Approach
为独立 Core 增加可安装的 Research wheel,支持发现、运行和恢复原有账本流程。 沿原命令参考和安装身份报告消费既有 wheel 可用性,让两条原有工作流保留同一份账本和执行契约。 现有 catalog、选择性 CLI 与 Research 录入/计划 owner 消费同一个已安装判定。 独立 Core 安装同版 wheel,原文件与 TS 资源在 RECORD 中,明确选中研究命令。
卸载或重新安装匹配 wheel 后,通过原 status 恢复,保留现有证据账本。
具体改动 / Changes
远端和本地共 14 个文件,+370/-29。V1、V3、§10 和 V7 对照 docs/architecture/rfcs/monorepo-distribution-split-v0.md,基准 5cfd6ae。 配对验收条款
- prepare_research_source。将六个既有实现文件加入同版 companion,继承文件 staging owner。 当前提交
- builtin_capability_installed。用相同的发行版本、RECORD 和原 TS 文件检查出可用条件。 当前提交
- build_capability_registry。保留原能力条目,按 companion 可用性投影 ready。 当前提交
- _run_command。匹配时进入原 parser 和 handlers,分组命令表仍沿只认识内置路由的旧路径。 当前提交
- _distribution_runtime_fingerprint。已安装 companion 进入实际文件指纹,错版时该指纹缺席。 当前提交
对主干的风险 / Risks
实装两种 wheel,恢复普通 CLI 创建的现有记录并生成引用报告。两组外部证据用例保留来源时钟且每次重放只入账一次。 错版本和缺少原 TS 文件时两个入口均以 2 拒绝,账本字节保持一致。卸载恢复 Core 指纹,重装后可读回原账本。 #9038、#9049、#9058 同时触碰 staging、命令路由或 release identity。本评审核验当前真实分包及共享 owner,其他候选的组合仍需各自集成读回。
19 项普通源码、9 项安装态、2 项确定性外部证据通过。Core only 的安装存在和缺失用例都通过,需 Research 的续账本用例按条件跳过。 Quick premerge 的 6 项直接检查和 4 项选择检查通过。
我的整体评价 / Verdict
独立结论为 REQUEST_CHANGES。让 Core 的命令参考与安装诊断反映同一次安装判定。 打包 README 与双语 RFC 描述 standalone 安装、原入口和卸载,命令参考和 doctor 仍需读回。 在同一个安装可用性判定下补齐命令发现和安装诊断,再用实装缺件、错版本和移除场景读回。
English verdict: REQUEST_CHANGES. The installed research commands run and keep existing ledgers. Make both commands discoverable through the Core command reference and report incompatible or incomplete companion installs in doctor.
|
This pull request has merge conflicts with Choose the remote for the base repository, not an out-of-date fork. git fetch upstream
git rebase upstream/main
# Resolve each conflict, git add the resolved files, then git rebase --continue.
git push --force-with-lease origin HEADFor a same-repository clone whose Keep the DCO |
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · Gemini · Google (self_reported)
独立审核提交 661e34087260050d05e078aa280f0fe4fb6fe60d(基准 5cfd6ae7d571f2f97da40982db23f76540723c89)。在独立构建与隔离安装复现中,现有研究工作流账本延续与外部证据幂等入账路径可以运行,但仍复现两项阻塞级交互与诊断缺口,且当前分支在 loopx/python_install_owner.py 与 main 存在合并冲突。
动机 / Motivation
受影响的是在独立 loopx-core 环境中需要通过 loopx commands 发现命令、运行 deepresearch 续写项目研究账本、使用 external-evidence 准入外部证据,以及通过 loopx doctor 排查安装健康度的操作者与自动化脚本。
改动前,standalone loopx-core 已将研究能力条目展示在 capability catalog 中,但实际运行 deepresearch 或 external-evidence 会因缺少实现被拒绝;改动后,安装同版本 loopx-capability-research wheel 可直接运行原有命令并延续现有 .loopx/deepresearch 账本,但实装已就绪时 loopx commands 仍缺失这两个命令,且版本失配或缺少 external_evidence.ts 时 loopx doctor --installation-only 仍返回 ok=true。
匹配安装时 deepresearch --help、external-evidence --help、capability list 与账本续作均可用,外部证据保留来源时间戳并实现幂等入账;但在独立 Core 命令参考发现及异常安装诊断方面仍未达到一致读回。
本 PR 不修改普通 loopx 发行版的既有命令行为,不引入新的外部网络执行权限或自动证据准入,也不修改现有 research.json 账本存储格式。
改动思路 / Approach
本 PR 通过 packages/loopx-core/prepare.py 的 --distribution loopx-capability-research 从同一源码树打包 6 个既有研究运行时与 TypeScript 资源文件,在运行期通过 builtin_capability_installed 按 loopx-core 同版本、包 RECORD 归属与资源文件存在性做被动检查,使 deepresearch 与 external-evidence 按需加载并继续读写既有项目账本。将深研账本与外部证据实现拆入同版本可选 wheel loopx-capability-research,复用原有入口与文件 staging 所有者是合理的分包边界;但在共享可用性判定与诊断投影处必须由同一事实源驱动命令目录、doctor 健康度与 capability 状态。当前切片边界如下:保留分包 staging、懒加载路由与原有账本契约,补齐已安装研究命令进入 Core 命令参考、doctor 识别 companion 版本/缺件异常,并先与 main 合并解决冲突后再合入。
安装场景(独立 Core 2.4.0) |
deepresearch / external-evidence |
capability list |
commands 参考 |
doctor --installation-only |
实测指纹 |
|---|---|---|---|---|---|
| 仅 Core(未装 Research) | 拒绝(exit 2,提示安装 companion) | installed=false, ready=false |
均未列出 | ok=true |
Core 指纹有效 |
Core + 同版 Research(2.4.0) |
正常帮助与执行(延续账本、幂等入账) | installed=true, ready=true |
仍未列出(P2) | ok=true |
Core+Research 联合指纹 |
缺失 external_evidence.ts |
拒绝(exit 2) | installed=false(未区分已装未就绪) |
未列出 | 仍报 ok=true(P2) |
Python 3.14 下仍产出新指纹(P2) |
版本失配(2.4.1 对 2.4.0) |
拒绝(exit 2) | installed=false(未区分版本失配) |
未列出 | 仍报 ok=true(P2) |
指纹静默缺失且无诊断 |
具体改动 / Changes
对照基线规范 monorepo-distribution-split-v0.md(基线修订 5cfd6ae7d571f2f97da40982db23f76540723c89)评估交付条款:
V1(按需加载):implemented——loopx/capabilities/deep_research/catalog_entry.py与loopx/python_install_owner.py通过find_spec与元数据读取检查可用性,执行capability list后sys.modules未提前导入 5 个研究模块;已通过隔离 wheel 测试。V3(CLI 发现与兼容性):not_met—— 独立 Core 安装并就绪loopx-capability-research后,loopx deepresearch --help与loopx external-evidence --help返回 0,但loopx commands --format json仍遗漏这两条已就绪命令。V7(研究账本延续与外部证据):implemented—— 安装版deepresearch可无损续读普通 CLI 创建的.loopx/deepresearch/research.json并生成报告;external-evidence保留来源时间戳与幂等入账。§7-mixed-version/§10-operational(混合版本与安装诊断 /capability list区分状态):not_met——loopx-capability-research发生版本失配或缺失external_evidence.ts时,loopx doctor --installation-only(含--deep)仍返回ok=true且无 companion 版本与异常原因,且capability list将已安装但损坏/失配的 companion 折叠为installed=false。
关键代码讲解
prepare_research_source(packages/loopx-core/prepare.py:75):将RESEARCH_FILES(5 个 Python 模块与loopx/control_plane/capabilities/external_evidence.ts)从loopx-core排除并打入同版本loopx-capability-research(声明loopx-core==<version>),与原有prepare_core_source共用_stage_source复制路径与校验规则。builtin_capability_installed(loopx/python_install_owner.py:33):在不导入目标模块的前提下检查find_spec位置、loopx-core与 companion 版本一致、implementation.files归属以及resources在磁盘存在;需要注意origin/main已在同文件新增distribution_record_path以修复 Python 3.11 Windows 盘符解析,当前 PR 存在文本冲突且直接调用implementation.locate_file。build_capability_registry(loopx/capabilities/catalog.py:148):当find_spec("loopx.cli") is None时注册loopx-capability-researchprovider 并覆盖deep-research与external-evidence-research的provider_id;因仅将布尔值research_installed传给installed,companion 已安装但版本错配或缺件时无法按installed=True, enabled=False, ready=False呈现。_run_command(loopx/cli_runtime.py:1021):在独立 Core 中拦截deepresearch与external-evidence,校验research_workflows_installed(builtin_cli_present=False)后按需注册子解析器并分派;但同文件第 726 行处理commands子命令时仍固定只传_SELECTED_COMMANDS,导致已安装的命令不可见。_distribution_runtime_fingerprint(loopx/release_manifest.py:325):在loopx-core环境下纳入loopx-capability-research的loopx/文件计算运行期指纹;但在 Python 3.14 中Distribution.files会过滤磁盘缺失文件(即便.dist-info/RECORD仍列有external_evidence.ts),导致删掉 TS 资源后仍得出变更后的有效 SHA-256 指纹而非返回None。
对主干的风险 / Risks
-
[P2] 已就绪的研究命令未进入 Core 命令参考 (
loopx commands)- 触发条件与路径:在安装同版本
loopx-capability-research的独立 Core 环境中运行loopx commands --format json,由loopx/cli_runtime.py:720-731调用build_command_reference_payload(available_commands=_SELECTED_COMMANDS if _standalone_core() else None)。 - 实测证据:
loopx capability list --format json已报告deep-research与external-evidence-research为ready=true且两者的--help均退出 0,但loopx commands --format json的命令列表中均不含deepresearch与external-evidence。 - 最小修复:在
loopx/cli_runtime.py的commands分支复用被动检查research_workflows_installed(builtin_cli_present=False),仅在返回True时将"deepresearch"和"external-evidence"加入available_commands,保持不导入研究运行时;在tests/test_core_research_distribution.py补充安装前/安装后commands --format json对比断言。 - 复验命令:
LOOPX_CORE_TEST_PYTHON=<core-py> LOOPX_RESEARCH_TEST_ENABLED=1 uv run --extra test python -m pytest -q tests/test_core_research_distribution.py
- 触发条件与路径:在安装同版本
-
[P2]
loopx doctor --installation-only与指纹校验未能检出并报告研究 wheel 版本失配与缺件- 触发条件与路径:安装不匹配版本(如
2.4.1对 Core2.4.0)或从已安装环境移除loopx/control_plane/capabilities/external_evidence.ts后,执行loopx doctor --installation-only --format json(含--deep)与release_runtime_identity()。 - 实测证据:两类损坏场景下
loopx deepresearch status与loopx external-evidence discover均以 exit 2 拒绝,但loopx doctor --installation-only及--deep均返回ok=true(exit 0),未输出任何 companion 版本或失败原因;版本失配时package_fingerprint静默消失;移除external_evidence.ts后在 Python 3.14 下因Distribution.files不含缺失文件而.dist-info/RECORD仍包含该条目,_distribution_runtime_fingerprint仍返回非空新指纹而非拒绝计算。同时loopx capability list将两类损坏态都标为installed=false而非区分“已安装未就绪”。 - 最小修复:在
loopx/python_install_owner.py中基于原始RECORD(而非已过滤的Distribution.files)区分未安装、版本不匹配与文件/资源缺失,并由loopx/release_candidate.py(collect_installation_doctor)与loopx/release_manifest.py消费同一诊断结果,在异常时令doctor置ok=false并输出 companion 版本与原因,在loopx/capabilities/catalog.py对已安装但校验未通过的情况标记installed=True, enabled=False, ready=False。 - 复验命令:
LOOPX_CORE_TEST_PYTHON=<core-py> uv run --extra test python -m pytest -q tests/test_core_research_distribution.py
- 触发条件与路径:安装不匹配版本(如
-
与
main的合并冲突与协同提示git merge-tree origin/main 661e34087260050d05e078aa280f0fe4fb6fe60d显示loopx/python_install_owner.py存在内容冲突(main已合入distribution_record_path与verified_distribution_console),建议 rebase 到最新main时直接复用distribution_record_path处理RECORD路径。
语义与 CI 对齐
对照既有的 CapabilityRegistry 状态契约(installed/enabled/ready)、loopx_command_reference_v0 以及 monorepo-distribution-split-v0.md §7/§10 运维契约:本次变更未新增状态枚举(reuse_existing),但在命令参考曝光与 doctor 混合版本/缺件诊断上尚未满足现有契约(violated)。本地验证全部按受管策略执行,未查询或等待远端 GitHub CI:
- 源码回归:
pytest覆盖test_external_evidence_cli.py、test_capability_extension_registry.py、test_deepresearch_command.py、test_core_distribution.py、test_core_research_distribution.py及 4 项架构检查,共 349 passed, 43 skipped(未设LOOPX_CORE_TEST_PYTHON时的装包用例跳过);TypeScriptexternal_evidence_research.test.ts17/17 PASS;双语 RFC 检查 PASS;变更文件ruff与loopx check边界扫描 PASS;canary premerge --tier quick4/4 direct checks、3/3 catalog canaries 与 public_boundary 全部 PASS(注:尝试standard档时install-local-smoke.py于 193.87s 超时而未计作通过)。 - 实装 wheel 复核:独立构建并安装
loopx-core==2.4.0与loopx-capability-research==2.4.0,Core-only 2/2 PASS,Research 启用 2/2 PASS,实装test_external_evidence_cli.py(-k preserves_receipt_clocks_and_idempotent_ledger)2/2 PASS;反事实探针实证上述两项 P2 缺口。
我的整体评价 / Verdict
长程工作影响(long_horizon):preserved(匹配安装时账本续跑与外部证据重放均保持原身份与字节幂等性,异常态未写入脏状态);用户体验(user_experience):regression(已安装研究命令无法在 loopx commands 发现,且版本号失配或资源缺失时 loopx doctor --installation-only 仍误报 ok=true)。本 PR 仅涉及 CLI 分包、命令路由、能力目录和安装诊断,未改动前端或渲染视图(已检查 loopx/cli_runtime.py、loopx/capabilities/catalog.py 与 packages/)。未验证视觉部分:无新增或修改的图形界面渲染。在可观测语义(observable_semantics)上,普通发行版保持基线一致,但独立 Core 的命令目录与 doctor 诊断在 companion 异常态存在缺口;代码规模与兼容性(code_volume)必要且无冗余兼容层(retain),默认关闭隔离(default_off_isolation)在未安装 Research 时通过,authority_semantics 未扩权且保持原有账本所有者,词表复用了现有能力注册与 CLI 契约(reuse_existing),architecture_assessment 的后续修复边界明确。请先 rebase 解决 loopx/python_install_owner.py 与 main 的冲突并修复上述两项 P2 后再复审。
English verdict: REQUEST_CHANGES at 661e340. Rebase onto main to resolve the conflict in loopx/python_install_owner.py, surface ready research commands in loopx commands, and report mismatched or incomplete loopx-capability-research installs in loopx doctor and capability list.
Goal and delivered behavior
Standalone Core currently ships the evidence-ledger and external evidence implementations. Its catalog marks both capabilities ready while their CLI commands require the ordinary distribution. This proposal gives both workflows one matching
loopx-capability-researchwheel. Core keeps the catalog metadata, reports installed availability, and routes the existing commands only when the matching wheel owns the required Python and TypeScript files. The ordinary distribution retains its existing entrypoints.The workflow reopens the original project ledger and uses the same source admission, report and replay rules. The release identity accounts for the research wheel alongside Core. The paired distribution RFC and wheel guide describe installation and removal. Related to #5072. Base
main@5cfd6ae7d571.Verification
Source-built artifacts from
661e34087260050d05e078aa280f0fe4fb6fe60dwere tested on macOS arm64, Python 3.12.9 and Node 26. The removed Core members exactly match the six files owned by the new wheel, totaling 107,831 expanded bytes. The Core wheel changes from 7,721,040 to 7,693,950 bytes.The evidence covers local artifact composition and synthetic recorded sources. Live external provider execution and matched model task costs remain open.