Repository navigation
fix(release): move release_metadata under control_plane.testing - #8934
Conversation
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
依赖打包发布元信息脚本 scripts/release_artifacts.py、精确发布提交校验 release_commit_qualification.py 以及需要保持顶层 loopx/*.py 模块数量不超过 127 预算门禁的 LoopX 维护者与 CI 检查流水线。
重构前,loopx/release_metadata.py 位于 loopx/ 顶层包目录下,使 loopx/*.py 数量增至 128 个,触发架构守护 test_top_level_module_budget.py 报错并阻塞全局 kernel-static-checks CI;重构后,本 PR 通过 git mv 将其迁入 loopx/control_plane/testing/release_metadata.py 并同步更新包内相对导入、scripts/release_artifacts.py 的隔离 runpy 路径、发布单测及 examples/release-artifacts-smoke.py 的隔离沙箱路径,顶层模块数恢复为精确的 127,在无新增顶层兼容垫片与无惰性包初始化副作用的前提下恢复发布域与顶层预算双门禁绿灯。
在精确头 5c8492db4945 上,本地实跑 pytest tests/test_stage2c_dependency_lock.py tests/architecture/test_top_level_module_budget.py tests/test_release_artifact_publication.py -q(含 -I -S 隔离加载与无副作用验证)全部 27 项通过、examples/release-artifacts-smoke.py --json 返回 release-artifacts-smoke ok、ruff check(5 个相关文件)无报错、control-plane-maintainability-ratchet-smoke.py 全部通过(unreviewed=0, stale_exceptions=0, magnitude_regressions=0)且 git diff --check 零告警;远端 CI 中 34 项已通过,仅 typescript-core (2/3)(及聚合 checks)因基线 348743591f 早于 PR #8932 尚未在 CANONICAL_CONSUMERS 登记 settlement_readback.ts 而报错,本地同命令已确认精确头与基线呈完全一致的非本 PR 既有时隙失败。
本 PR 仅将 release_metadata.py 迁入现有内部测试支撑包 loopx/control_plane/testing/ 并修正 4 处显式引用与 smoke 夹具路径,不改变发布元信息 schema、版本号规则或打包格式,不留下顶层转发兼容模块,也不重复处理属于 PR #8932 的 content_digest_single_owner.test.ts 缺项。
改动思路 / Approach
入口涉及三处消费链路:scripts/release_artifacts.py:40-49 的 load_identity(以 runpy.run_path 直接从源码路径读取而不导入 loopx 包体)、loopx/control_plane/testing/release_commit_qualification.py:9 的包内相对导入,以及两处独立沙箱构建脚本(examples/release-artifacts-smoke.py 与 tests/test_release_artifact_publication.py)。release_metadata.py 原本唯一真正的包内调用方就是 loopx/control_plane/testing/release_commit_qualification.py,因此将其重定位到同目录 loopx/control_plane/testing/release_metadata.py(而非新建包或保留顶层重定向文件)既自然归属单一职责,又满足 tests/architecture/test_top_level_module_budget.py 不得残留顶层文件、只能下移预算计数至 127 的硬约束;scripts/release_artifacts.py 仍维持 runpy.run_path 无副作用读取语义,不改动发布版本号校验或 pyproject.toml 解析逻辑。
架构判断:Reuses the existing internal loopx/control_plane/testing package via git mv instead of adding a new subpackage or leaving a top-level loopx/release_metadata.py compatibility shim, keeping runpy.run_path inert package loading intact and lowering top-level modules back to 127.
当前边界:Moves loopx/release_metadata.py to loopx/control_plane/testing/release_metadata.py and updates release_commit_qualification.py, scripts/release_artifacts.py, examples/release-artifacts-smoke.py, and tests/test_release_artifact_publication.py.
具体改动 / Changes
- 规范来源:
tests/architecture/test_top_level_module_budget.py@348743591f1ee21b733ce97bba2b68e5b83e8866TOP-BUDGET-1->implemented:loopx/顶层模块数量严格回到 pinned 预算127(实跑test_top_level_module_budget.py并通过全局 ratchet 检查)。TOP-BUDGET-2->implemented:所有发布打包、runpy.run_path隔离加载(python -I -S)、沙箱 smoke 及发布制品校验行为均保持完全等价(27 项 pytest +release-artifacts-smoke全绿)。
关键代码讲解
loopx/control_plane/testing/release_metadata.py与loopx/control_plane/testing/release_commit_qualification.py:9:使用git mv迁移原顶层模块并将from ..release_metadata import checkout_release_metadata收敛为同包相对导入from .release_metadata import checkout_release_metadata,消除顶层包内耦合点。load_identity(scripts/release_artifacts.py:40-49):将runpy.run_path目标路径更新为loopx/control_plane/testing/release_metadata.py,完整保留注释中声明的“在检查自身源码树时不触发loopx/__init__.py初始化”的惰性隔离前提。- 沙箱与隔离发布单测同步(
examples/release-artifacts-smoke.py:122-127、tests/test_release_artifact_publication.py:26-30):同步在临时测试工程中创建loopx/control_plane/testing目录并拷贝release_metadata.py,同时验证删除或修改release_metadata.py时的隔离报错与-I -S导入干净性。
对主干的风险 / Risks
对主干回归风险低。已验证所有外部可观测调用点与包边界:全仓查找证实除已更新的 4 处引用外不存在其它残留路径导入;正向链路与负向路径(损坏/缺失 pyproject.toml、隔离 python -I -S 运行、tests/test_stage2c_dependency_lock.py、tests/architecture/test_top_level_module_budget.py 及 tests/test_release_artifact_publication.py 共 27 项 + release-artifacts-smoke)全部在精确头 5c8492db494585e7cd188edc199110f6cbbd3198 实跑通过;不引入任何新兼容垫片、环境变量、opt-in 开关或默认行为漂移。
对远端 CI 诊断失败的基线对比核验:PR #8934 在 GitHub Actions 上通过了 kernel-static-checks 等 34 项任务,仅 typescript-core (2/3)(及聚合 checks)失败、test-shard (1)..(6) 待完成;已在精确头 5c8492db494585e7cd188edc199110f6cbbd3198 实跑 tests/control_plane_ts/content_digest_single_owner.test.ts,失败签名完全是 'control_plane/quota/settlement_readback.ts' 未列入 CANONICAL_CONSUMERS,且 git show 348743591f1ee21b733ce97bba2b68e5b83e8866:tests/control_plane_ts/content_digest_single_owner.test.ts 已证实基线 348743591f1ee21b733ce97bba2b68e5b83e8866 自身即缺少该条目(属于 PR #8932 修复的独立前置 TS 问题,与本次 Python 文件迁移零因果耦合)。另外提醒:本 PR 涉及 loopx/** 与 scripts/**,合并须维护者显式授权且需待合入前置 TS/shard 检查满足后执行。
| 验证项 | 状态 | 实跑结果(exact head 5c8492db494585e7cd188edc199110f6cbbd3198) |
|---|---|---|
pytest tests/test_stage2c_dependency_lock.py tests/architecture/test_top_level_module_budget.py tests/test_release_artifact_publication.py -q |
PASS | 27 passed in 0.60s(含 127 模块预算、Stage2c 锁与发布隔离单测) |
uv run --extra test python examples/release-artifacts-smoke.py --json |
PASS | release-artifacts-smoke ok |
ruff check(5 个关联文件)、control-plane-maintainability-ratchet-smoke.py & git diff --check |
PASS | 全部通过;unreviewed=0, stale_exceptions=0, regressions=0 |
远端 CI typescript-core (2/3) / checks |
FAIL (pre_existing_unrelated) | 基线 348743591f1ee21b733ce97bba2b68e5b83e8866 与精确头 5c8492db494585e7cd188edc199110f6cbbd3198 同源:CANONICAL_CONSUMERS 缺少 settlement_readback.ts(待 #8932) |
我的整体评价 / Verdict
Inspected all 5 modified/moved Python paths across scripts, control_plane/testing, tests, and examples; release metadata module relocation only, with zero rendered frontend or UI surface. unverified_scope: none.
本次迁移紧扣目标且完全遵循最小边界:loopx/ 顶层模块计数已稳定恢复至 127 预算,消除了阻塞全局 kernel-static-checks 的障碍,同时未新增任何词汇表(no_new_vocabulary / not_applicable)、兼容垫片或包初始化副作用;全部相关发布单测(27 项)、release-artifacts-smoke、ruff 及维持性棘轮均在精确头 5c8492db494585e7cd188edc199110f6cbbd3198 验证通过。远端 typescript-core (2/3) 失败已由基线对比证明系与本 PR 无关的既有 TS 注册缺口,test-shard (1)..(6) 尚未完成;按 loopx/** 权责边界,本自审结论为同意(COMMENTED 回退形式,因 GitHub 禁止同作者自批准),合入仍留待维护者授权。
English verdict: APPROVE
Signed-off-by: LoopX Agent <[email protected]>
5c8492d to
290815d
Compare
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent | self_reported | Gemini | Google DeepMind
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
动机 / Motivation
维护 LoopX 顶层模块预算门禁、执行发布制品校验或依赖 control_plane.testing 的开发者与 CI 任务。
此前顶层 helpers 模块 loopx/release_metadata.py 滞留在根目录并占用 1 个 top_level_module_budget 配额;重排并合入多轮削减后,若不将其迁回 control_plane/testing 并同步下调 max_top_level_modules(124 降至 123),则既无法通过预算棘轮收紧,也无法统一发布元数据所有权。
将 loopx/release_metadata.py 迁移至 loopx/control_plane/testing/release_metadata.py,更新 release_commit_qualification、scripts/release_artifacts.py、smoke 与单测引用,并将 tests/architecture/top_level_module_budget.json 上限由 124 严格下调至 123。
非目标边界:本 PR 不修改包发布内容清单与版本号计算规则,也不调整 CI 中的 test_contract_health.py。
该迁移可直接收敛顶层模块数量、消除后续新增子包时的配额挤压,同时保持 scripts/release_artifacts.py 经 runpy.run_path 无包初始化副作用读取版本信息的原有契约。
改动思路 / Approach
将纯发布元数据读取辅助模块归位至既有 control_plane/testing 包内,通过同提交下调预算上限巩固净减法成果,避免额外兼容重导出包装。
当前 PR 边界:仅覆盖 release_metadata.py 搬迁、全仓 4 处引用更新与 top_level_module_budget 124->123 同步下调(6 文件 +16/-8)。
- 正确性不变量(
checkout_release_metadata):经全仓git grep release_metadata核查,唯一生产消费者为release_commit_qualification.py(包内相对导入)与scripts/release_artifacts.py(runpy.run_path隔离加载,避免触发loopx/__init__.py),二者均已指向loopx/control_plane/testing/release_metadata.py。 - 预算棘轮不变量(
top_level_module_budget.json):移出顶层后立即将max_top_level_modules从124降至123并更新baseline_commit,防止后续提交悄然回填顶层配额。 - 失败模式:若遗漏任一静态/动态路径引用,运行时读取或隔离烟测会立即抛出
FileNotFoundError/ImportError,已通过全量回归及孤立路径冒烟实测拦截。
具体改动 / Changes
依据既有规范 docs/architecture/rfcs/monorepo-distribution-split-v0.md(修订 ef099ae3ac3c08054b9d928fff48aefe2615b950)核对两条规则:
MOD-BUDGET-RATCHET:将loopx/release_metadata.py移至loopx/control_plane/testing/release_metadata.py并将max_top_level_modules下调至123,由pytest tests/architecture/test_top_level_module_budget.py实跑验证 PASS。NO-IMPORT-SIDE-EFFECT:scripts/release_artifacts.py继续经runpy.run_path直接加载新路径并在examples/release-artifacts-smoke.py的loopx/__init__.py注入异常陷阱用例下实跑通过 PASS。
关键代码讲解
loopx/control_plane/testing/release_metadata.py:10(checkout_release_metadata):纯git+ 文件读取实现保持零改动搬迁,职责仍为无包初始化读取工作区版本与提交标识。loopx/control_plane/testing/release_commit_qualification.py:9:相对导入从from ...release_metadata收敛为同级from .release_metadata import checkout_release_metadata,去除跨层级顶层依赖。scripts/release_artifacts.py:44(load_identity):将runpy.run_path目标更新为loopx/control_plane/testing/release_metadata.py,保持不导入loopx/__init__.py的隔离语义;缺失路径会转为ReleaseArtifactError。tests/architecture/top_level_module_budget.json:4:max_top_level_modules由124下调至123,锁死顶层目录减法成果。
对主干的风险 / Risks
主干行为回归风险极低(纯路径收口,未改写任何业务逻辑)。公开边界扫描与顶层模块预算单测均在当前精确 head 通过。需要特别说明的是,远端 GitHub Actions 上的 kernel-static-checks 及连锁跳过的 stage2c-correctness-e2e / pytest 失败系基底 origin/main 中 tests/control_plane/test_contract_health.py:10 未清理的 F401 未使用导入所致(本 PR 未触及该文件,且已在独立测试清理分支上单独验证修复),不属于本 PR 引入的回归。
| 验证项 | 级别 | 结果 | 实跑输出(exact head 290815d2de10329ddd60bf664d9ed8e2846dc5a5) |
|---|---|---|---|
pytest -q tests/test_release_artifact_publication.py tests/architecture/test_top_level_module_budget.py |
required | PASS | 26 passed in 0.55s |
python examples/release-artifacts-smoke.py |
required | PASS | release-artifacts-smoke ok |
ruff check loopx/control_plane/testing/release_commit_qualification.py loopx/control_plane/testing/release_metadata.py scripts/release_artifacts.py tests/test_release_artifact_publication.py |
required | PASS | All checks passed! |
loopx canary premerge --from-git-diff --git-diff-base origin/main --tier quick |
required | PASS | selected_checks: 3, executed_checks: 3, failures: 0 (ok: true) |
远端 GitHub Checks(kernel-static-checks 等) |
diagnostic (required=false) |
FAIL (unrelated) | 基线 tests/control_plane/test_contract_health.py:10 F401 导致的预存门禁阻塞 |
我的整体评价 / Verdict
对精确 head 290815d2de10329ddd60bf664d9ed8e2846dc5a5 的评价:用户体验影响为 not_applicable(仅涉及测试包路径迁移与预算 JSON 调整,未改动任何前端 UI、CLI 富文本排版或浏览器可视化视图(inspected: loopx/control_plane/testing/release_metadata.py)。,unverified_scope: none),长程工程维护性 improved。变更保持零兼容垫片(compatibility_assessment=not_applicable),无新增状态/词汇(semantic_alignment=not_applicable),严格复用既有包结构并永久回收 1 个顶层模块配额。在本地精确 head 上,发布制品单测、隔离冒烟、顶层模块预算、ruff 与 premerge canary 全部实测 PASS;待主干 kernel-static-checks 基线恢复并经维护者合入授权后即可并入。
English verdict: APPROVE
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · gpt-6.2-sol · OpenAI · runtime_reported · xhigh
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
动机 / Motivation
执行发行制品校验、历史标签恢复和准确提交资格检查的维护者与工作流。 基线的内部静态读取器占用一个顶层模块,发布脚本与资格检查共用它。 同一候选目录交给基线与当前头两份发布 CLI,八组正常与异常输出逐一相同,候选初始化文件中的抛异常探针始终未运行。 读取器同字节移入 control_plane.testing。顶层实际数量和上限同时从 124 降至 123,三项入口 allowlist 保持原值。 范围为内部读取器、调用路径与架构棘轮。版本计算、制品格式、发布权限和真实发布流程保持原契约。
改动思路 / Approach
保留一个 stdlib 静态读取器。发布 CLI 从工具所在 checkout 用 runpy 加载,准确提交资格检查复用同一个同级函数。 本 PR 的交付边界是两条活跃调用路径、配套隔离检查和顶层计数收紧。 基线与当前头均搜索旧模块路径和读取函数,仓内调用只在发布脚本、资格检查、测试及 smoke。读取器未形成公开导入承诺,移除旧路径使本次实际计数下降一项。现有工作流的 loopx/** 已覆盖新位置,独立 tooling checkout 读取候选源码的模式仍可用。
具体改动 / Changes
准确头 290815d,merge base 421aa77,6 个文件 +16/-8。按修订 421aa77 的架构条款逐项核验 MOD-BUDGET-RATCHET、INTERNAL-CALLERS-MIGRATED 和 INERT-PACKAGE-INSPECTION。源码快照检查确认当前 main 的顶层计数仍为 124。 模块搬迁规范
关键代码讲解
checkout_release_metadata继续读取 TOML、AST 字面量和 Git 身份。100% 重命名,缺失或乱序的元数据仍由既有异常语义处理。 静态读取器load_identity根据工具文件位置载入新路径,再把单独的候选目录传给读取器。候选只需包元数据,原路径和新路径都无需由候选提供。 制品 CLI- 发布资格检查的相对导入改到同级模块,原准确提交、脏 checkout 和版本门继续由现有调用方约束。 资格检查
- 棘轮最大值
123与准确头目录实测相符。smoke 和单测按新布局搭建隔离工具,并保持候选初始化爆炸探针。 预算
对主干的风险 / Risks
四项正常 case 的真实 CLI 退出 0,正确标签、两项制品的清单生成和校验结果逐字一致。 错误标签、篡改字节、版本不一致、损坏的源码各自退出 2。两个 revision 的 stderr 逐字一致,只归一化候选目录前缀。 准确头有 74 项 Python 测试通过,发布制品与版本契约两项 smoke 通过,quick premerge 的六项直接检查、三项目录 canary 与一次公开边界扫描均通过。 广测另有 1 项 facade 合约检查失败。精确基线以同一命令复现完全相同的 17 个缺失既有导出证据,列表只有 status/quota,改动不触及这两处。 当前 main 上的候选 smoke 脚本有独立更新,合入前仍由准确头与平台合入检查读回。
我的整体评价 / Verdict
批准这次路径迁移。保留一个 stdlib 静态读取器。发布 CLI 从工具所在 checkout 用 runpy 加载,准确提交资格检查复用同一个同级函数。 本 PR 的交付边界是两条活跃调用路径、配套隔离检查和顶层计数收紧。 本地对照覆盖发布标签、清单与资格路径。没有用户界面或 CLI 展示布局改动,验证对象为源码 CLI 和隔离发布夹具。真实 GitHub 上传和发布资格留给对应的发布作业,远端 CI 未查询。
English verdict: APPROVE at 290815d. Eight paired release CLI cases preserve the prior behavior and the module ratchet matches the new tree. One identical facade evidence failure is inherited from the merge base.
|
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 |
Signed-off-by: LoopX Agent <[email protected]>
Delivery Brief
kernel-static-checkstop-level module budget gate onorigin/main(348743591f, introduced when#8919/87c9c41658addedloopx/release_metadata.pydirectly atloopx/).tests/architecture/test_top_level_module_budget.pypinsmax_top_level_modulesat127intests/architecture/top_level_module_budget.json, andloopx/release_metadata.pyincreasedloopx/*.pyto128.loopx/release_metadata.pytoloopx/control_plane/testing/release_metadata.pywithout leaving a top-level shim, restoringlen(loopx/*.py) == 127while preserving inert static metadata inspection (zero candidateloopx/__init__.pyexecution whenscripts/release_artifacts.pyrunsrunpy.run_path).loopx/control_plane/testing/release_metadata.py, stdlib-only imports__future__, ast, pathlib, tomllib), consumed byloopx/control_plane/testing/release_commit_qualification.pyvia relative import and byscripts/release_artifacts.pyviarunpy.run_path.Changes
git mv loopx/release_metadata.py loopx/control_plane/testing/release_metadata.pyscripts/release_artifacts.py(load_identity) to loadloopx/control_plane/testing/release_metadata.pyviarunpy.run_path.loopx/control_plane/testing/release_commit_qualification.pyto import.release_metadata.checkout_release_metadata.examples/release-artifacts-smoke.pyandtests/test_release_artifact_publication.py(test_colocated_artifact_cli_never_initializes_the_candidate) to create parent dirsloopx/control_plane/testingand copyrelease_metadata.pythere cleanly.Verification (run on
HEAD5c8492db494585e7cd188edc199110f6cbbd3198)uv run --extra test python -m pytest -q --no-cov tests/test_stage2c_dependency_lock.py tests/architecture/test_top_level_module_budget.py tests/architecture/test_control_plane_import_boundaries.py tests/control_plane/test_release_commit_qualification.py tests/test_release_artifact_publication.py->75 passed in 16.92suv run --extra test python examples/release-artifacts-smoke.py->release-artifacts-smoke okuv run --extra test python examples/release/release-version-contract-smoke.py->release-version-contract-smoke okuv run --extra test ruff check tests loopx/canary loopx/control_plane loopx/domain_packs loopx/presentation scripts/release_artifacts.py->All checks passed!uv run --extra test mypy->Success: no issues found in 17 source filesuv run --extra test python examples/control_plane/control-plane-maintainability-ratchet-smoke.py->control-plane-maintainability-ratchet: ok(unreviewed: 0,stale_exceptions: 0,magnitude_regressions: 0)uv run --extra test loopx canary premerge --from-git-diff --git-diff-base origin/main --tier quick --no-progress->status: passed,ok: true,merge_gate_passed: true,manual_holds: 0,rfc_bilingual_diff: passed,Catalog Canaries: 3/3 passed,Public Boundary: passeduv run --extra test python scripts/check_rfc_bilingual.py --base origin/main --head HEAD->RFC bilingual diff check passed.