Skip to content

fix: reuse a pinned query operation for peak reports (#221) - #227

Merged
codeasier merged 5 commits into
mainfrom
fix/221-report-reuse
Oct 10, 2026
Merged

codeasier merged 5 commits into
mainfrom
fix/221-report-reuse

Conversation

@codeasier

Copy link
Copy Markdown
Owner

依赖

依赖 #224 与 #226,当前提交保留两者祖先关系。暂以 main 为目标运行完整 CI;建议先合并依赖后复核差异。

变更

  • report 只解析一次 focus、device 和数据集,执行一次 allocator_gap 后投影为原有六个 peak 字段,再进行 attribution。
  • 全过程共享预算、截止时间及数据集代际,保留各指标独立峰值、并列选最早事件和空结果语义。
  • 每阶段结束检查数据集未变化;默认内容哈希守卫,显式 immutable 缓存模式下才用代际检查。
  • 同步中英文 report 行为说明。

验证

  • 最终本地全套 1982 项测试通过;Ruff/Black/diff 通过;basedpyright 0 errors(1189 warnings)。
  • 157 项相关测试通过;独立 report 复核 13 项通过。
  • 原 60k 周期生命周期 report 的 CLI 复现通过;50k active blocks 的真实 attribution 超预算仍原子失败,不返回半份报告。
  • 远端 tree 与最终测试源码一致;远端 CI 待运行。

报告复用不会保证所有 standalone peak 能成功的规模都能完成 attribution;必要的额外工作仍计入预算。默认完整性守卫仍需文件哈希。
未修改 snapshot 源码,无需追加 snapshot provenance。
Closes #221
Related to #217

Copy link
Copy Markdown
Owner Author

验证更新:当前提交 ad9964b36069b8635ae35627e61a9f71ec35d5f0 的完整 CI 已通过。依赖 #224、#226 的对应提交也均已通过各自完整 CI。保持草稿,未执行合并。

@codeasier codeasier left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

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

Cross-review 结论:可以合入,以下两项为非阻塞跟进项。

  1. [Low] 非数据集(standalone)DB 中某个计数列在区间内全为 NULL 时,report peak-memory --metric active(默认)会从 allocator_gap 选出一个 event_id 并执行 attribution,与 memory_peak 的旧语义(峰值为 NULL、提前返回空结果)不一致。位置:src/pt_snap_cli/core/report_service.py:115-117。建议:峰值为 NULL 时提前返回,或补一条“全 NULL + 默认 metric”的回归测试。数据集路径不受影响。

  2. [Low] skills/pt-snap-memory-peak-breakdown/SKILL.md 第 245-259 行仍描述旧的报告组合方式(report 同时调用 memory_peak),与当前实现不符。src/pt_snap_cli/bundled_skills/ 下的副本目前内容一致,建议两份同步更新,以保持 parity 检查通过。

Copy link
Copy Markdown
Owner Author

已更新至 ef641382eb7ea5441408d3055fa437fbfa7183fc,回应本 PR 的两项 Low 检视建议:

两项都已修复:standalone 范围内某指标全为 NULL 时,peak 中对应 event ID 恢复为 NULL;选中该指标会提前返回空 attribution,仍只运行一次 allocator_gap。未选中的 NULL 指标及有效零值也有回归覆盖。

两份 peak-breakdown skill 已同步说明实际的查询复用方式及空结果语义。云端 Python 3.12 全套 1,997 项测试通过,覆盖率 92.60%;Ruff、Black、类型检查、构建、wheel 审计和安装后验收通过。未调用真实模型。

远端新提交 CI 待完成,状态另行补充。

Copy link
Copy Markdown
Owner Author

本轮检视修正的最新提交 ef641382eb7ea5441408d3055fa437fbfa7183fc 已通过完整 CI。已验证新提交本身,不沿用旧 head 的结果。PR 仍保留草稿,未执行合并;评审回复留待复核。

Copy link
Copy Markdown
Owner Author

已追加 ca4b9a8,将最新 main(#225/#226 已合入,fca1212d)整合到本分支,保留原 PR 的 pinned report、NULL peak、技能说明及 #225 的 source/cache/owner 修复。双父提交,无强推;远端树 6893faf9a2155f2e6b490dfe8592963916e0f94f 与复核版本一致。

独立复核 161 项、专项 255 项通过,lint/format/typecheck、构建、wheel 审计和 clean-wheel acceptance 通过。完整覆盖率首轮 2013 passed / 2 failed:两项为构建与测试并行造成的包版本元数据竞争;冻结产物后包测试6/6通过,完整稳定环境重跑及当前 head CI 仍在进行,尚不宣称全量通过。报告文档依据本分支实际 pinned 行为保留,没有机械套用 #226 单独状态下的描述。

Copy link
Copy Markdown
Owner Author

补充最终本地验证:冻结构建产物后,同一源码树的完整重跑 2015/2015 passed(299.63s),包测试6/6通过;先前两项版本元数据竞争未再出现。覆盖率92.65%,关键文件92%/90%/85%门槛均通过。当前远端 head ca4b9a8 的 CI 仍待终态,合入会以该结果为准。

@codeasier
codeasier marked this pull request as ready for review October 10, 2026 13:33
@codeasier
codeasier merged commit 9ff9c65 into main Oct 10, 2026
6 checks passed

Copy link
Copy Markdown
Owner Author

当前修复 head ca4b9a8 的 CI 已全部成功:https://github.com/codeasier/pt-snap-cli/actions/runs/38055723814 。完整本地重跑2015项通过,已按授权 squash 合入 main 9ff9c65。合入后的 main CI 将单独核验。

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.

[H4] peak-memory report 对同一范围扫描两遍并共享预算,且重复 inspect

1 participant