Compare commits

..
16 changed files with 350 additions and 14 deletions

No files matched your search

+4 -4
View File
@@ -4,9 +4,9 @@
面向 **Windows + DxDesigner / Expedition Enterprise 7.9.5** 的器件批量替换工具。一个工程对应一个任务,可以只替换同料号下的部分位号;支持直接编辑和 Excel BOM 导入,同批工程按顺序执行。
**最新版本:V1.1.4 Beta 1(预发布)** · [下载便携包](https://git.simgreek.com/simgreek/dxdesigner-part-replacement/releases/download/v1.1.4-beta.1/DxPartReplace-1.1.4-beta.1.zip) · [版本说明与附件](https://git.simgreek.com/simgreek/dxdesigner-part-replacement/releases/tag/v1.1.4-beta.1) · [完整使用说明](docs/user/v1.1.0-project-tasks.md)
**最新版本:V1.1.4 Beta 2(预发布)** · [下载便携包](https://git.simgreek.com/simgreek/dxdesigner-part-replacement/releases/download/v1.1.4-beta.2/DxPartReplace-1.1.4-beta.2.zip) · [版本说明与附件](https://git.simgreek.com/simgreek/dxdesigner-part-replacement/releases/tag/v1.1.4-beta.2) · [完整使用说明](docs/user/v1.1.0-project-tasks.md)
所有发布均标记为 **Beta 预发布**,旧版本标签与下载链接保持可用。
所有发布均标记为 **Beta 预发布**。V1.1.4 Beta 1 因 BOM 导入缺少 `win32timezone` 已撤回,请使用 Beta 2;旧 Git 标签保留供回溯。升级前备份 `data`,完整更新 EXE 与 `_internal`,不要只替换 EXE。
本版提供[目标封装选择](docs/user/target-cell-selection.md):目标封装可留空,此时工具不主动覆写封装,可后续与中心库同步;需要指定时,在料号规则中读取并选择合法封装。BOM 保持原 11 列。
@@ -18,7 +18,7 @@
### 第 1 步:解压并打开应用
[下载 V1.1.4 Beta 1 便携包](https://git.simgreek.com/simgreek/dxdesigner-part-replacement/releases/download/v1.1.4-beta.1/DxPartReplace-1.1.4-beta.1.zip),**完整解压**,双击 `DxPartReplace.exe`。保留它与 `_internal` 的相对位置,无需安装 Python;本机需要可用的 DxDesigner、许可证和中央库。
[下载 V1.1.4 Beta 2 便携包](https://git.simgreek.com/simgreek/dxdesigner-part-replacement/releases/download/v1.1.4-beta.2/DxPartReplace-1.1.4-beta.2.zip),**完整解压**,双击 `DxPartReplace.exe`。保留它与 `_internal` 的相对位置,无需安装 Python;本机需要可用的 DxDesigner、许可证和中央库。
打开后看到下图主窗口。首次使用请准备完整的工程副本,执行前保存并关闭待处理工程。
@@ -194,7 +194,7 @@ DxPartReplace/
## 验证范围与已知限制
V1.1.4 Beta 1 新增批次后台资源管理:一次 BOM 导入或顺序执行共用一个私有桌面,CAD 按需启动并在同批工程间复用,批次结束统一退出。若提示 **资源释放待处理**,已保存核验的结果保留,请点击 **重新清理资源**;该操作只清理后台资源,不会再次替换。旧的工程保护锁仍按“核验并恢复”处理。设计、异常边界与实机结果见[批次运行时验收记录](docs/testing/2026-10-21-batch-private-runtime.md)。
V1.1.4 Beta 2 新增批次后台资源管理:一次 BOM 导入或顺序执行共用一个私有桌面,CAD 按需启动并在同批工程间复用,批次结束统一退出。若提示 **资源释放待处理**,已保存核验的结果保留,请点击 **重新清理资源**;该操作只清理后台资源,不会再次替换。旧的工程保护锁仍按“核验并恢复”处理。设计、异常边界与实机结果见[批次运行时验收记录](docs/testing/2026-10-21-batch-private-runtime.md)。
资源释放会追加日志:在 **替换结果 / 日志 → 完整日志** 查看本批开始释放、释放成功/失败及重新清理的结果。独立文件位于 `data/batch-resources/<批次ID>/resource-release.log`,记录批次、桌面、CAD PID、退出码、释放耗时、句柄关闭和桌面消失的分别确认,以及失败原因;同时保留 `session.json` 的原始释放证明。重启后重新检查也会追加记录,不覆盖原失败日志。
+78
View File
@@ -0,0 +1,78 @@
{
"version": "1.1.4-beta.2",
"release_tag": "v1.1.4-beta.2",
"classification": "beta",
"prerelease": true,
"code_commit": "1ee519e5d25e4052f20b7b32ad18dcd837eb948d",
"application_entry_matches_source": true,
"vbs_match_source": {
"QuickPartReplace.vbs": true,
"NativeSnapshotReader.vbs": true
},
"data_directory_excluded": true,
"gif_recorded_version": "1.1.2",
"build_log": "build/release-1.1.4-beta.2-build.log",
"zip_sha256": "21d242d1c4bd015f3b140d01f08e6779be0b6408f4d0deef09b457ec22a00325",
"zip_bytes": 60682629,
"file_count": 402,
"extracted_zip_smoke": true,
"exe_sha256": "0247347e33389025e9dab61065040a1589ed14876eaa9db5cf8fabd24604c360",
"build_verification": {
"passed": 824,
"warnings": 1,
"seconds": 177.39
},
"packaging_checks_passed": 2,
"acceptance_guard_checks_passed": 15,
"business_module_count": 84,
"business_modules_all_match_source": true,
"frozen_main": {
"passed": true,
"win32timezone_archived": true,
"process_creation_time_read": true,
"resources_released": true,
"windows_numeric_version": "1.1.4.2",
"windows_prerelease_flag": true
},
"ui_acceptance": {
"full_exe_all_program_files_match_zip": true,
"template_columns": 11,
"imports": [
{
"file": "BOM-含错误位号.xlsx",
"seconds": 9.889999999999418,
"title": "本批 BOM 校验未通过 · 通过 2 / 失败 1 / 未检查 0 行 · 详情"
},
{
"file": "BOM-替换RV05.xlsx",
"seconds": 4.734000000011292,
"title": "本批 BOM 校验通过 · 通过 2 / 失败 0 / 未检查 0 行 · 详情"
}
],
"search_preserves_tasks": true,
"execution_seconds": 209.40600000001723,
"completed_tasks": 2,
"cad_starts": 1,
"queue_desktop_generations": 1,
"all_batches_released": true,
"results_window_reopened": true,
"observer_initial_path_mismatch_retained": true,
"read_only_post_verification_passed": true,
"replacement_replayed": false
},
"independent_graphs": {
"passed": true,
"components_each": 57,
"pin_connections_each": 103,
"unchanged_non_targets_each": 56,
"source_hashes_unchanged": true,
"library_lmc_hash_unchanged": true
},
"acceptance_report": "docs/testing/2026-10-23-issue-2-frozen-runtime.md",
"old_release": {
"tag": "v1.1.4-beta.1",
"withdrawn_to_draft": true,
"public_release_api_status": 404,
"git_tag_retained": true
}
}
+25
View File
@@ -0,0 +1,25 @@
# V1.1.4 Beta 2 构建与发布记录
日期:2026-10-23。源快照 `1ee519e5d25e4052f20b7b32ad18dcd837eb948d`;后续提交仅补充本次构建记录。
修复工单 #2 的 pywin32 动态依赖漏打包。版本 `1.1.4-beta.2`,Python 元数据 `1.1.4b2`,Windows 数字版本 `1.1.4.2`,带预发布标志。
| 验证 | 结果 |
| --- | --- |
| 发布门禁 | 824 passed,177.39 秒;1 条既有 pywinauto STA COM 警告 |
| 额外检查 | 打包配置 2 项,验收脚本 15 项通过 |
| 冻结主进程 | 最终 ZIP 解压 EXE 实际读取工作进程创建时间,确认进程退出和桌面释放 |
| 源码一致性 | 84 个业务模块、应用入口编译码、两份 VBS 哈希一致 |
| 完整 EXE 双工程 UI | 创建任务、默认模板导出、错误/正确 BOM 导入、保存计划、实际替换、保存重开、结果日志重开通过 |
| 执行批次 | 209.406 秒;一次 CAD 启动,一个桌面代次;资源最终释放 |
| 独立前后对照 | 每工程 57 组件、103 引脚连接,56 个非目标组件属性/连接不变,目标料号和 Value 正确 |
| 原始数据 | 源工程目录完整哈希、中央库 .lmc 哈希不变 |
| 最终 ZIP | 完整性、解压 smoke、逐文件与已验收 UI 包比对通过;不含运行 data、任务数据库或现场日志 |
旧外部观察器未扫描批次资源目录造成的验收断言保留在原始记录中。已补齐观察器并完成测试,采用只读续验确认已完成的执行和资源释放,没有再次替换。细节见[工单修复与实机记录](../testing/2026-10-23-issue-2-frozen-runtime.md)。
ZIP:`DxPartReplace-1.1.4-beta.2.zip`,60,682,629 字节。SHA256:`21d242d1c4bd015f3b140d01f08e6779be0b6408f4d0deef09b457ec22a00325`。
附件包括便携 ZIP、默认 BOM 模板、GIF、SHA256SUMS 和逐文件 manifest。GIF 沿用 1.1.2 教程,包内说明已标明。
Beta 1 已撤回为草稿,匿名发布 API 返回 404;其 Git 标签和原附件保留用于回溯。Beta 2 先以草稿上传,回下载核对附件哈希后再公开为 Beta。紧凑证据见[构建 JSON](v1.1.4-beta.2-build.json)。本机原始证据为 `build/release-1.1.4-beta.2`。
+43
View File
@@ -0,0 +1,43 @@
# DxPartReplace V1.1.4 Beta 2
发布日期:2026-10-23。**Beta 预发布版**。替代已撤回的 V1.1.4 Beta 1;旧 Git 标签保留供回溯,旧发布不再提供公开下载。
## 下载与升级
完整解压 `DxPartReplace-1.1.4-beta.2.zip`,运行 `DxPartReplace.exe`。无需安装 Python;本机需要可用的 DxDesigner / Expedition Enterprise 7.9.5、许可证和中央库。
升级前关闭旧程序并备份 `data`,保留原数据,配套更新 EXE 与 `_internal`。不要让不同版本同时打开同一数据目录;历史保护锁不会自动解除。
[中文图文教程](https://git.simgreek.com/simgreek/dxdesigner-part-replacement/src/tag/v1.1.4-beta.2/README.md)。包内包含离线图文教程、GIF、默认 11 列 BOM 模板、构建清单和 SHA256 校验。教程图片及 GIF 沿用已验收的旧版录制,新增的“重新清理资源”与释放日志以本版界面为准。
## Beta 2 修复
- 修复工单 #2(DXT-20261023-A1F7FADF):发布包缺失 `win32timezone`,导致 BOM 导入记录采集进程创建时间时失败。显式打包 pywin32 的动态依赖,无需用户安装 Python。
- 发布门禁改为在完整 EXE 主进程中验证私有桌面、子进程启动、创建时间记录及最终释放,防止源码 Python 的完整环境掩盖打包缺失。
- 不改变替换、保存回读、保护锁及资源恢复规则。
## 继承的批次功能
- 每次 BOM 导入和顺序执行分别作为一个批次,共用一个私有桌面;CAD 按需启动,在批内跨工程复用,批末统一退出。
- 工程之间确认上一工程已关闭,重新核验路径、中心库、图页及目标身份;保留保存、关闭、重开回读流程。
- 首次可能写入前持久化保护标记。只有明确证明尚未修改且旧资源已释放时,允许重建重试一次;身份冲突、已修改或结果不确定时不自动重放。
- 释放失败保留已保存并核验的任务结果,阻止新批次,提供“重新清理资源”;清理操作不重复替换,重启后仍检查未收尾批次。
- 释放日志显示开始、成功、失败和重新检查,包含耗时、CAD退出码、句柄关闭与桌面消失的分别确认、失败原因。同批各任务“完整日志”可见,独立文件位于 `data/batch-resources/<批次ID>/resource-release.log`。
- 修复 BOM 错误回报与清理错误同时发生时丢失逐行报告的问题;清理失败只保留诊断,不提供可应用的部分预览。
- 保留原生 CLI 优先采集,减少不必要的 CAD 回退;原生会话重试耗尽时停止整批。
## Beta 2 发布验证
发布门禁 824 项通过;打包配置检查 2 项、外部验收脚本检查 15 项通过。完整 EXE 在两个全新工程副本上完成创建任务、导出默认模板、错误 BOM 报告(2 通过 / 1 失败)、修正后导入(2 通过 / 0 失败)、保存计划、实际替换、保存重开回读及结果日志查看。两工程各 57 个组件、103 个引脚连接,56 个非目标组件不变;源文件与中心库 `.lmc` 哈希不变。执行批次共一次 CAD 启动、一个桌面代次,最终释放已独立确认。
本轮[工单修复与验收记录](https://git.simgreek.com/simgreek/dxdesigner-part-replacement/src/tag/v1.1.4-beta.2/docs/testing/2026-10-23-issue-2-frozen-runtime.md)包含原验证漏检范围及外部观察器修正后的只读续验说明;已完成替换没有重放。
## 继承的历史验证与范围
两个全新工程副本完成 BOM 导入、实际替换、保存重开、独立完整属性/连接回读和资源释放。两版本保存结果一致;各工程 57 个组件、103 个引脚连接,56 个非目标组件属性和连接不变,源工程及中心库 `.lmc` 哈希不变。
相同样例单次对照:BOM 加执行总耗时 170.860 → 151.859 秒,私有桌面创建 6 → 2 次,CAD 启动 2 → 1 次。该结果不代表固定加速比例;BOM 单次测量 2.250 → 3.187 秒。
工单完整库存覆盖的 31 行回放为 20 通过、11 失败,未强行放行不匹配项;其余 406 条替换行、96 个工程未获对应完整库存,不能宣称全部工程已实机通过。用户机器的外部桌面引用残留根因尚未在本机复现。
详见[批次运行时验收](https://git.simgreek.com/simgreek/dxdesigner-part-replacement/src/tag/v1.1.4-beta.2/docs/testing/2026-10-21-batch-private-runtime.md)、[实机对照](https://git.simgreek.com/simgreek/dxdesigner-part-replacement/src/tag/v1.1.4-beta.2/docs/testing/2026-10-21-batch-private-runtime-live.md)和[释放日志验证](https://git.simgreek.com/simgreek/dxdesigner-part-replacement/src/tag/v1.1.4-beta.2/docs/testing/2026-10-21-resource-release-logging.md)。
@@ -0,0 +1,40 @@
# 工单 #2:冻结主进程依赖与实机回归
日期:2026-10-23。对应修正版:V1.1.4 Beta 2。
## 根因与复现
工单:https://git.simgreek.com/simgreek/dxdesigner-part-replacement/issues/2 。附件 `application.log` 的 SHA256 为 `f81f4ee602089e85cf98f6f8c64dcb4f5325885573b1b210d97f43e4ba3d98ef`。
Beta 1 在 `inspect_bom_batch → NativeInventoryReader → _DesktopLease.start_process → BatchCadRuntime._track → process_identity → win32process.GetProcessTimes` 抛出 `ModuleNotFoundError: No module named 'win32timezone'`。pywin32 的 C 扩展在转换进程创建时间时动态导入该模块,PyInstaller 未自动收集。已核对与公开 Beta 1 哈希一致的 EXE(`c0a43c302568206c9bbfc02203daded1df8e19df1d2083c2f0961eddd213a900`),其 PYZ 中确实没有该模块;独立进程阻断该导入后调用 GetProcessTimes 可复现。
附件显示尚未启动 CAD,未进入替换;清理成功,桌面句柄关闭与桌面消失分别确认,耗时 1.281 秒。现有证据不支持归因为 BOM 内容或多工程私有桌面泄漏。
原发布验证用源码 Python 监督打包后的 COM 子进程,GetProcessTimes 实际运行在依赖完整的源码环境,未覆盖冻结主进程,这是本次漏检的边界。
## 修复与门禁
- 在 spec 中显式加入 `win32timezone`。
- 冻结 EXE 的 `--smoke-test` 实际创建批次私有桌面,启动自有短命进程,经生产 `_track` 读取创建时间,再释放工作进程和桌面。不打开 CAD 或工程。
- `tools/verify_packaged_runtime.py` 清除源码 Python 环境变量,以完整 EXE 验证上述链路及持久化释放证明;构建脚本必须通过该门禁。
- 旧版 EXE 在新增门禁中失败:`Missing win32timezone in frozen archive`。新版 EXE 通过,Windows 版本为 1.1.4.2,带预发布标志。
- 回归覆盖模拟缺依赖时仍完成资源释放。验收脚本检查每个原生采集操作的批次归属及最终释放,支持批次保留桌面的正常语义。
- 不改变替换规则、写入前保护标记、人工恢复边界或已有保护锁。
## 自动验证
发布构建门禁:824 passed,177.39 秒;1 条既有 pywinauto STA COM 警告。打包配置检查另有 2 项通过;外部验收脚本防误判检查 15 项通过。新版本在无 PYTHONPATH/PYTHONHOME 的冻结主进程中完成进程创建时间读取和资源释放。
## 实机验证范围
使用 Audio_D2128、Audio_T605A 的全新副本,通过 Windows 界面操作完整 EXE。原始工程和中央库不用于写入。证据目录为 `build/release-1.1.4-beta.2/ui-acceptance`。
工程任务创建、导出默认 11 列模板、填写并导入错误/正确 BOM、保存计划已通过。错误表为通过 2 / 失败 1 / 未检查 0;正确表为通过 2 / 失败 0 / 未检查 0。保存前数据库没有部分计划,保存后每工程仅 RV05 启用,RV11 保留。搜索过滤不改变任务范围。BOM 使用原生 CLI,无 CAD 启动;两个工程共用一个桌面,释放已确认。第二次导入缓存命中,没有新增桌面。
两个工程均已通过完整 EXE 的实际替换、保存关闭及重新打开核验。队列耗时 209.406 秒,同一代桌面、一次 CAD 启动;未重建、未重放。结果窗口可关闭并重新打开,显示 RV05、新料号及已保存核验状态。
旧外部观察器遗漏 `data/batch-resources/*/session.json`,导致任务完成后的验收断言失败。已补齐扫描路径并以回归验证;原失败记录保留。未重新执行替换,而是读取完成事件、队列/批次记录,并用 Windows API 独立确认 CAD 已退出、桌面消失。结合原观察器 943 次采样的前台 PID 和输入桌面窗口记录确认,执行 CAD 未成为前台或进入输入桌面。只读续验结果为 `completed-execution-verification.json`。
独立源属性/连接读取器分别在替换前后打开工程副本:每工程 57 个组件、103 个引脚连接;56 个非目标组件的身份、位置、方向、属性及连接完全相同。目标 RV05 的料号由 4100-CA0000-T7 变为 4100-CA0000-T0;启用 Part Label → Value,回读均为 0R;目标位置、方向和网络连接保持一致。源工程副本来源目录的完整文件哈希及中心库 `.lmc` 哈希不变。完整 EXE 无 ERROR 日志,窗口正常退出。
本次不是全部工单工程实机覆盖,也不据此承诺所有机器上的桌面残留根因均已消除。原始缺依赖故障已在完整 EXE 主进程、双工程原生采集和替换路径上覆盖。
+3
View File
@@ -80,6 +80,9 @@ try {
if (-not (Test-Path -LiteralPath $executable -PathType Leaf)) {
throw "PyInstaller did not produce $executable"
}
$runtimeSmokeRoot = Join-Path $repositoryRoot ("build\frozen-runtime-" + [Guid]::NewGuid().ToString("N"))
& $PythonExecutable tools\verify_packaged_runtime.py $executable $runtimeSmokeRoot
if ($LASTEXITCODE -ne 0) { throw "Frozen supervisor verification failed; build stopped" }
$sourceQuickPartReplace = Join-Path $repositoryRoot "integration\dxdesigner795\QuickPartReplace.vbs"
$packagedQuickPartReplace = Join-Path $repositoryRoot "dist\DxPartReplace\_internal\legacy-runtime\dxdesigner795\QuickPartReplace.vbs"
if (-not (Test-Path -LiteralPath $sourceQuickPartReplace -PathType Leaf)) {
+2
View File
@@ -43,6 +43,8 @@ a = Analysis(
"win32con",
"win32gui",
"win32process",
# GetProcessTimes imports this from pywin32's C extension at runtime.
"win32timezone",
"pywinauto",
"pywinauto.controls.uiawrapper",
],
+4 -4
View File
@@ -1,8 +1,8 @@
# UTF-8
VSVersionInfo(
ffi=FixedFileInfo(
filevers=(1, 1, 4, 1),
prodvers=(1, 1, 4, 1),
filevers=(1, 1, 4, 2),
prodvers=(1, 1, 4, 2),
mask=0x3f,
flags=0x2,
OS=0x40004,
@@ -15,11 +15,11 @@ VSVersionInfo(
StringTable('040904B0', [
StringStruct('CompanyName', 'DxProductivity'),
StringStruct('FileDescription', 'DxDesigner Part Replacement'),
StringStruct('FileVersion', '1.1.4.1'),
StringStruct('FileVersion', '1.1.4.2'),
StringStruct('InternalName', 'DxPartReplace'),
StringStruct('OriginalFilename', 'DxPartReplace.exe'),
StringStruct('ProductName', 'DxDesigner Part Replacement'),
StringStruct('ProductVersion', '1.1.4-beta.1')
StringStruct('ProductVersion', '1.1.4-beta.2')
])
]),
VarFileInfo([VarStruct('Translation', [1033, 1200])])
+1 -1
View File
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
[project]
name = "dx-productivity"
version = "1.1.4b1"
version = "1.1.4b2"
requires-python = ">=3.12,<3.13"
dependencies = ["PySide6>=6.7,<7", "pywin32>=306", "pywinauto>=0.6.9,<1", "openpyxl>=3.1,<4"]
@@ -117,6 +117,24 @@ def _flush(context: LoggingContext) -> None:
handler.flush()
def _smoke_batch_runtime(data_root: Path, context: LoggingContext) -> None:
"""Exercise process tracking inside the frozen supervisor before releasing."""
from dx_productivity.trial_task_center.batch_runtime import BatchCadRuntime
with BatchCadRuntime(data_root, 'packaged_runtime_smoke') as runtime:
runtime.bind_logs(context, ())
with runtime.native_scope(data_root / 'runtime-smoke') as lease:
command = str(Path(os.environ['SystemRoot']) / 'System32/cmd.exe')
process = lease.start_process((command, '/d', '/c', 'exit', '0'))
if not runtime.record['processes'][0]['creation_time']:
raise RuntimeError('Smoke process identity has no creation time')
if process.wait(timeout=15) != 0:
raise RuntimeError('Smoke worker did not exit successfully')
if runtime.record['state'] != 'released':
raise RuntimeError('Smoke resources were not released')
context.logger.info('packaged_runtime_smoke_passed batch_id=%s', runtime.session_id)
def main(argv: Sequence[str] | None = None) -> int:
"""Run the Qt shell, returning a conventional process status code."""
arguments = _parse_arguments(argv)
@@ -149,6 +167,8 @@ def main(argv: Sequence[str] | None = None) -> int:
try:
database_path = data_root / "task-center.db"
_log_startup(logging_context, data_root, database_path)
if arguments.smoke_test and bool(getattr(sys, 'frozen', False)):
_smoke_batch_runtime(data_root, logging_context)
store = TaskStore(database_path)
service = TaskCenterService(store, logging_context)
qt_application = QApplication([sys.executable, *(argv or ())])
@@ -1 +1 @@
VERSION = "1.1.4-beta.1"
VERSION = "1.1.4-beta.2"
@@ -33,6 +33,42 @@ def test_bom_resource_verifier_accepts_cli_only_reads_without_cad(native_bom_evi
assert verifier.verify_bom_resources(root)=={'cad_sessions':0,'ready_native_cli_reads':2}
def test_desktop_observer_discovers_batch_resource_records(tmp_path, monkeypatch):
monkeypatch.syspath_prepend(str(Path(__file__).resolve().parents[2] / 'tools'))
from private_desktop_observer import PrivateDesktopObserver
path = tmp_path / 'data/batch-resources/batch/session.json'
path.parent.mkdir(parents=True)
path.write_text(json.dumps({'desktop': 'dx-observer-test', 'cad_pid': None, 'state': 'ready'}))
observer = PrivateDesktopObserver(tmp_path)
observer._sample()
assert observer.records['dx-observer-test']['evidence_path'] == str(path.relative_to(tmp_path))
@pytest.mark.parametrize('fault', [None, 'pending', 'unbound', 'workers_open'])
def test_bom_resource_verifier_checks_batch_release_and_operation_binding(native_bom_evidence, fault):
verifier, root, rows = native_bom_evidence
operations = {}
for i, row in enumerate(rows):
path = root / f'data/tasks/{i}/quick-run-history/native-inventory-ok/native-inventory.json'
row['cleanup'].update(scope='operation', workers_closed=True, desktop_retained_by_batch=True)
path.write_text(json.dumps(row))
operations[str(path.parent.resolve())] = {'workers_closed': fault != 'workers_open',
'binding': {'session_id': 'batch', 'generation': 1, 'attempt_id': str(i)}}
if fault == 'unbound':
operations.clear()
path = root / 'data/batch-resources/batch/session.json'
path.parent.mkdir(parents=True)
path.write_text(json.dumps(dict(state='blocked' if fault == 'pending' else 'released',
session_id='batch', generation=1, native_operations=operations,
cleanup=dict(desktop_handle_closed=True, desktop_confirmation={'released':True}, errors=[]))))
if fault:
with pytest.raises(AssertionError):
verifier.verify_bom_resources(root)
else:
assert verifier.verify_bom_resources(root)['ready_native_cli_reads'] == 2
@pytest.mark.parametrize('fault',['uncertain','fallback_active_job','fallback_retained_workspace'])
def test_bom_resource_verifier_rejects_bad_earlier_attempt_despite_clean_retries(native_bom_evidence,fault):
verifier,root,rows=native_bom_evidence
@@ -4,6 +4,8 @@ from pathlib import Path
import os
import subprocess
import sys
import json
import pytest
def test_default_data_root_uses_windows_known_folder_without_environment(tmp_path: Path, monkeypatch) -> None:
@@ -189,3 +191,26 @@ def test_icon_uses_package_location_for_frozen_script_entrypoint(tmp_path, monke
assert not qapp.windowIcon().isNull()
assert not qapp.windowIcon().pixmap(32, 32).isNull()
assert qapp.applicationVersion() == application.VERSION
@pytest.mark.parametrize('missing_dependency', [False, True])
def test_runtime_smoke_tracks_real_process_and_releases_on_failure(tmp_path, monkeypatch, missing_dependency):
from dx_productivity.trial_task_center.application import _smoke_batch_runtime
from dx_productivity.trial_task_center.logging_setup import configure_logging
import win32process
if missing_dependency:
def fail(_handle):
raise ModuleNotFoundError("No module named 'win32timezone'")
monkeypatch.setattr(win32process, 'GetProcessTimes', fail)
with pytest.raises(ModuleNotFoundError, match='win32timezone'):
_smoke_batch_runtime(tmp_path, configure_logging(tmp_path))
else:
_smoke_batch_runtime(tmp_path, configure_logging(tmp_path))
paths = list((tmp_path / 'batch-resources').glob('*/session.json'))
assert len(paths) == 1
record = json.loads(paths[0].read_text(encoding='utf-8'))
assert record['state'] == 'released' and record['cad_pid'] is None
assert record['cleanup']['desktop_handle_closed']
assert record['cleanup']['desktop_confirmation']['released']
assert not record['cleanup']['errors']
+20 -4
View File
@@ -99,17 +99,33 @@ def verify_bom_resources(root):
path = root / 'desktop-observation-bom.json'
verify_observation(path, require_sessions=False)
observation = json.loads(path.read_text(encoding='utf-8'))
records = [json.loads(path.read_text(encoding='utf-8')) for path in
(root / 'data/tasks').glob('*/quick-run-history/native-inventory-*/native-inventory.json')]
paths = list((root / 'data/tasks').glob('*/quick-run-history/native-inventory-*/native-inventory.json'))
records = [json.loads(path.read_text(encoding='utf-8')) for path in paths]
batches = [json.loads(path.read_text(encoding='utf-8')) for path in
(root / 'data/batch-resources').glob('*/session.json')]
ready = [row for row in records if row['state'] == 'ready']
for row in records:
for path, row in zip(paths, records):
assert row['state'] in {'ready', 'fallback'} and not row.get('cleanup_error')
assert row['backend'] == 'native_cli'
if row['state'] == 'ready':
assert row['source_hashes_unchanged']
assert not Path(row['workspace']).exists()
cleanup = row['cleanup']
assert cleanup['desktop_handle_closed'] and cleanup['desktop_confirmation']['released']
if cleanup.get('scope') == 'operation':
assert cleanup['workers_closed'] and cleanup['desktop_retained_by_batch']
owners = [(batch, operation) for batch in batches for evidence, operation in
batch.get('native_operations', {}).items() if Path(evidence).resolve() == path.parent.resolve()]
assert len(owners) == 1, 'Native operation must have exactly one batch owner'
batch, operation = owners[0]
assert batch['state'] == 'released' and operation['workers_closed']
assert operation['binding']['session_id'] == batch['session_id']
assert operation['binding']['generation'] == batch['generation']
assert operation['binding']['attempt_id']
final = batch['cleanup']
assert final['desktop_handle_closed'] and final['desktop_confirmation']['released']
assert not final['errors']
else:
assert cleanup['desktop_handle_closed'] and cleanup['desktop_confirmation']['released']
assert not cleanup['errors']
if row['state'] == 'ready':
assert cleanup['processes']
+3
View File
@@ -47,6 +47,7 @@ class PrivateDesktopObserver:
paths += list((self.output / 'data' / 'tasks').glob('*/quick-run-history/sheet-discovery-*/private-desktop.json'))
paths += list((self.output / 'data' / 'tasks').glob('*/quick-run-history/recovery-*/worker/private-desktop.json'))
paths += list((self.output / 'independent-read' / 'quick-run-history').glob('sheet-discovery-*/private-desktop.json'))
paths += list((self.output / 'data' / 'batch-resources').glob('*/session.json'))
for path in paths:
# A Windows atomic replacement can briefly deny a simultaneous
# open. Retry briefly; persistent failures still fail the probe.
@@ -58,6 +59,8 @@ class PrivateDesktopObserver:
if attempt == 3:
raise
time.sleep(0.01)
if not value.get('desktop'):
continue # A resource-free batch has not created a desktop.
self.records[value['desktop']] = dict(value, evidence_path=str(path.relative_to(self.output)))
pid = value.get('cad_pid')
if pid and pid not in self.handles:
+45
View File
@@ -0,0 +1,45 @@
"""Verify the frozen supervisor, not a source-Python substitute for it."""
from __future__ import annotations
import argparse
import json
import os
from pathlib import Path
import subprocess
from PyInstaller.archive.readers import CArchiveReader
def verify(executable: Path, data_root: Path) -> dict:
executable = executable.resolve(strict=True)
if data_root.exists():
raise ValueError('Use a fresh verification data directory')
archive = CArchiveReader(str(executable))
assert 'win32timezone' in archive.open_embedded_archive('PYZ.pyz').toc, 'Missing win32timezone in frozen archive'
environment = dict(os.environ, QT_QPA_PLATFORM='offscreen')
for key in ('PYTHONPATH', 'PYTHONHOME', 'DX_TASK_CENTER_HOME'):
environment.pop(key, None)
result = subprocess.run([str(executable), '--smoke-test', '--data-root', str(data_root.resolve())],
env=environment, cwd=executable.parent, timeout=90,
creationflags=subprocess.CREATE_NO_WINDOW, capture_output=True)
assert result.returncode == 0, (result.returncode, result.stderr)
log = (data_root / 'logs/application.log').read_text(encoding='utf-8')
assert 'packaged_runtime_smoke_passed' in log
assert 'application_clean_shutdown exit_code=0' in log
records = [json.loads(p.read_text(encoding='utf-8'))
for p in (data_root / 'batch-resources').glob('*/session.json')]
assert len(records) == 1 and records[0]['state'] == 'released'
cleanup = records[0]['cleanup']
assert cleanup['desktop_handle_closed'] and cleanup['desktop_confirmation']['released']
assert not cleanup['errors']
return {'passed': True, 'frozen_supervisor': True, 'win32timezone_archived': True,
'process_creation_time_read': True, 'resources_released': True,
'executable': str(executable), 'data_root': str(data_root.resolve())}
if __name__ == '__main__':
parser = argparse.ArgumentParser()
parser.add_argument('executable', type=Path)
parser.add_argument('data_root', type=Path)
args = parser.parse_args()
print(json.dumps(verify(args.executable, args.data_root), ensure_ascii=False, indent=2))