From 8e946c6e7a115a1ac22101b97df9b3fc6e2862f0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=98=BF=E7=99=BD=E5=8F=94?= <11794527+absfan@user.noreply.gitee.com> Date: Fri, 6 Nov 2026 16:59:58 +0800 Subject: [PATCH] docs: record runtime lifecycle validation and candidate limits --- README.md | 12 +- SOP.md | 10 +- docs/ICDB-MANUAL-REPAIR-AND-UPDATE.md | 2 +- .../2026-11-06-runtime-lifecycle-candidate.md | 39 ++ ...26-11-06-runtime-lifecycle-validation.json | 380 ++++++++++++++++++ .../2026-11-06-runtime-lifecycle-safety.md | 80 ++-- ...6-11-06-runtime-lifecycle-safety-design.md | 4 +- .../runtime_lifecycle_frozen_boundaries.py | 95 +++++ .../runtime_lifecycle_frozen_fixture.py | 43 ++ .../support/runtime_lifecycle_frozen_smoke.py | 82 ++++ 10 files changed, 696 insertions(+), 51 deletions(-) create mode 100644 docs/releases/2026-11-06-runtime-lifecycle-candidate.md create mode 100644 docs/releases/2026-11-06-runtime-lifecycle-validation.json create mode 100644 tests/support/runtime_lifecycle_frozen_boundaries.py create mode 100644 tests/support/runtime_lifecycle_frozen_fixture.py create mode 100644 tests/support/runtime_lifecycle_frozen_smoke.py diff --git a/README.md b/README.md index 7cc39cf..fc9e9c5 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,9 @@ 当前临时分支的备份策略(2026-11-03):应用不再自动备份中心库或 CBB 工程。新增、替换、移除、校验、ICDB 维护和恢复在执行前提示手动备份;请自行保留可用副本。导入暂存、恢复用隔离验证库和轻量操作证据仍会生成,Mentor 原生 Repair 自身的备份行为保持不变。详见[自动备份检查与调整](docs/releases/2026-11-03-manual-backup.md)。此条优先于下方历史版本的备份说明。 -当前开发版本:**[v0.2.4-beta.1](docs/releases/v0.2.4-beta.1.md)(待评审、待现场验收)**。ICDB 批量检查在后台逐项运行,普通校验、管理和恢复可排队;READY 工程在实际执行前再次排除。检查不自动 Repair、Restore 或选择历史版本,也不代表中心库 READY。 +当前开发版本:**[0.2.4b2 生命周期候选](docs/releases/2026-11-06-runtime-lifecycle-candidate.md)(待评审、待现场验收)**。ICDB 批量检查在后台逐项运行,普通校验、管理和恢复可排队;READY 工程在实际执行前再次排除。检查不自动 Repair、Restore 或选择历史版本,也不代表中心库 READY。 + +停止、超时或应用失联只停止后续原生动作,不结束正在 Save/Close 的调用进程。普通停止等待 5 秒,可能正在写入时最多等待 120 秒后交给后台观察;这不是强制结束时限。保存结果、关闭结果和资源释放分别记录。相关库等待释放,独立库可以排队继续;界面、筛选和日志保持可用。重启只核对未完成会话,不重放管理写操作。legacy 状态读取只观察已打开且匹配库的 LM,不启动 LM 或回答弹窗;无法读取保持 UNKNOWN。 历史释放记录会触发实际占用复核,确认释放后归档继续;会话释放不等于历史数据恢复。释放结果逐项保存;记录保存失败会单独显示,不把已确认释放的会话重新标成占用。可查看后台窗口的原生提示;仅对当前可识别的原生取消按钮提供确认操作。 @@ -147,7 +149,7 @@ python -m cbb_refresh_verify - **不注入鼠标或键盘输入,不切换 Windows 桌面,不改写中心库源文件。** 生产路径在本次运行创建的私有桌面内启动中心库目录绑定的 ReusableCircuit PCB,随后用 COM 完成刷新、保存和关闭;只读状态桥在结束后确认 LMC 的 READY。Library Manager 菜单派发仅作为显式诊断路径保留。`tests/test_safety.py` 会在离线测试中阻止真实输入注入 API 重新进入生产代码。 - 所有自动化都跑在本进程创建的**私有 Windows 桌面**上:用户看不到窗口,光标不会被移动。 - 弹窗只认领本次运行的私有桌面/进程,依据已知规则投递 `BM_CLICK`。数据库恢复、会话失联和设计锁接管提示会阻断并保留现场;不会自动选择恢复或接管。未知弹窗也会阻断,Project Integration 进度窗保持观察。动作/错误弹窗和实际控件 ID 写入 `dialogs.jsonl`。 -- 超时或失败时停止自动化客户端,保留可能仍在写库的原生会话并停止批次。内容检查超时也不再强杀整个进程树;监督器核对进程是否退出,记录 `process_exit_confirmed` 或 `process_retained`;无法确认释放时输出 `recovery-required.json`,不以强杀代替数据库安全关闭。已确认身份且原生调用返回的失败文档会通过 32 位助手执行 `Close(False)`,再确认进程和 iCDB 地址释放。 +- 超时或失败时请求合作停止,保留可能正在原生调用的 worker 和保存/关闭助手,并交后台观察。内容检查超时同样不强杀进程树。保存结果未知时不再自动丢弃关闭;无保存助手且身份、空闲状态已确认的启动/集成失败仍可正常收尾。无法确认释放时保留 `recovery-required.json` 和相关库租约。 ## 环境要求 @@ -174,7 +176,7 @@ Windows 版本判断以 Build 为准:`22000` 及以上归为 Win11,`10240– ## 批量策略 -每个 CBB 独立执行并写入自己的 evidence 和结果行。可确认安全的单项失败允许继续;遇到 `ICDB_REPAIR_REQUIRED`、超时、原生会话释放未确认等情况,会停止整批并把后续项目标为 `SKIPPED`。点击“当前项完成后停止”或执行器返回 `QUEUE_STOP` 也会停止队列。 +每个 CBB 独立执行并写入自己的 evidence 和结果行。资源已释放的单项失败允许继续;未释放时跳过后续同库写入,独立库仍可运行。ICDB 错误本身不等于占用。用户取消或执行器明确返回 `QUEUE_STOP` 才停止本批次后续项,不自动恢复或重放该批次。 GUI 中状态为 `绿色 / Ready` 的条目不能勾选、也不会进入批量队列。 @@ -209,9 +211,9 @@ Mentor 桥耗时需在目标机器另行测量。 - `image-status-map.json`:按中心库路径隔离的本机动态 `image_id` 校准快照(当前格式 `schema_version=2`);旧版本或无版本缓存会自动忽略并重新校准,日志会记录当前样本、缓存样本、Ready 主 ID、未映射 ID 和逐项决策原因; - `backup/`:历史版本的辅助文件副本;当前分支不再生成,所有路径记录 `backup_skipped / manual_backup_policy`。已有历史副本不由本轮改动清理。 -超时采用无进展计时:界面和批量请求默认 600 秒无进展超时;它不是整个 CBB 的固定总时限,而是连续 600 秒没有可观察进展时才终止。PCB/COM 阶段切换、Project Integration 状态变化、保存标记变化和弹窗处理都会刷新计时器;重复的状态轮询不算进展。需要更快失败时仍可在界面将单项预算调低,但 30 秒只适合已确认 PCB 启动稳定的环境。 +超时采用无进展计时:界面和批量请求默认 600 秒没有可观察进展时进入停止与观察流程,不强杀正在进行的调用。PCB/COM 阶段切换、Project Integration 状态变化、保存标记变化和弹窗处理都会刷新计时器;重复的状态轮询不算进展。需要更快失败时仍可调低单项预算,但 30 秒只适合已确认 PCB 启动稳定的环境。 -结果不会把“内容检查 PASS”冒充为中心库绿色状态:`library_flag` 只来自对条目状态的只读读取,读不到就是 `UNKNOWN`。Mentor 的树节点 `iImage` 是本机资源列表索引,不能跨安装固定写死为绿色;工具会在日志中为每个 CBB 记录 `image_id`,并从独立的 `Cert/Work` 持久化证据动态校准本机 ID。树 ID 可读时用于交叉核对,冲突不允许标记 Ready;LM 忙导致树 ID 暂时读不到时,完整的持久化证据仍可保留 Ready,缺少持久化证据的条目仍进入待校验。右键菜单文字(包括 `Unverify`)不参与状态判定。 +结果不会把“内容检查 PASS”冒充为中心库绿色状态。默认权威桥读取 READY/raw=1;桥失败保留未知/不可用。显式 legacy 模式只观察已有匹配 LM 的树图标,图标不可读时保持 UNKNOWN,不以 Cert/Work 文件直接推断 READY 或 PENDING,也不自动回答原生提示。右键菜单文字(包括 `Unverify`)不参与状态判定。 ### 状态接口审计 diff --git a/SOP.md b/SOP.md index e99b158..cde34e3 100644 --- a/SOP.md +++ b/SOP.md @@ -1,6 +1,6 @@ # CBB 检查、校验、管理与残留释放操作规程 -适用开发版本:0.2.4b1。未完成现场验收,不自动发布或关闭工单。以下为当前规程,下方旧上传校验检查表保留为历史参考。 +适用开发版本:0.2.4b2。未完成现场验收,不自动发布或关闭工单。以下为当前规程,下方旧上传校验检查表保留为历史参考。 ## 当前操作与队列 @@ -8,7 +8,11 @@ 普通校验完成原生打开、身份确认、Project Integration、保存和关闭后,必须由权威状态 READY/raw=1 确认成功。ICDB 检查仅尝试打开并检查本次错误,不自动 Repair、Restore 或选择版本,CHECKED 不等于 READY。排队期间变成 READY 的工程在执行前跳过。 -原生任务串行排队,检查每项结束后让出机会;缓存筛选保持可用。失败项确认释放后继续独立项目;实际未释放时停止后续原生操作。“停止检查”只取消检查,“取消当前任务并停止队列”同时取消前台任务及后续后台检查,已进行的写入等待安全结束,不强杀代替取消。 +原生任务串行排队,检查每项结束后让出机会;缓存筛选保持可用。失败项确认释放后继续独立项目;未释放会话转后台观察,只保留相关库的写入限制,独立库可继续。“停止检查”只取消检查,“取消当前任务并停止队列”取消当前批次后续动作;正在保存/关闭的调用只等待返回。普通等待 5 秒,可能正在写入时最多再等到 120 秒后交后台,这不是结束进程的期限。 + +保存已返回成功、关闭失败、资源仍占用可以同时出现。查看本轮保存/关闭标记和独立释放结果,不能因进程退出就认定工程已保存。管理更新若已经移除、尚未重新导入就取消,按“需恢复”核对,不自动补做下一次导入。重启发现未完成任务时只核对身份和资源,不自动重放。 + +权威状态桥不可用时保留未知/不可用;legacy 读取只观察已打开且库身份匹配的 Library Manager。没有匹配窗口、存在模态提示或树不可读时返回 UNKNOWN,不自动启动或应答窗口。 新增拒绝同名冲突;更新先原生移除再导入,失败可能需要人工备份恢复;移除后重新读取目录确认。版本回退由操作员在原生界面选择,核对工程内容后单独校验。 @@ -24,7 +28,7 @@ 2. 数据库服务器可能服务同库其他用户。本工具不允许强制结束服务器,命令行指向本库也不构成独占授权;由库管理员核对用户和服务器状态。 3. “强制结束客户端”是另行确认的异常处理,只允许属于当前 Windows 用户和会话、已确认作用域和精确进程身份的 Expedition PCB、Library Manager、viewdraw、iCDB Project Backup 客户端。后台导入器、脚本宿主和归属未知的进程同样不在强制名单。 4. 警告明确告知客户端中其他已打开工程可能一并退出、未保存更改会丢失、写入中的工程可能需要恢复。执行前持久保存库外 `consent.json`,包含目标库、名单、创建身份和排除项;写入失败不执行。派发处核对快照身份和原预览范围,最终句柄处核对创建时间、完整映像、用户 SID、Windows 会话和原生活动;变化时拒绝。 -5. 预览和执行前检查进度与本轮 Output。Backup/Restore/Repair 进行中或状态无法确认时,不强制结束。可查看后台窗口的标题、输出和所在桌面;仅当当前窗口唯一存在已识别的 Cancel/取消按钮时,提供单独确认的原生取消。核对身份、用户会话和按钮快照后发送请求,再重新检查实际结果;没有识别到按钮时不猜菜单参数,不抢占前台。 +5. 预览和执行前检查进度与本轮 Output。本工具登记的 Save/Close/原生调用尚未确认返回,或 Backup/Restore/Repair 进行中、状态无法确认时,不放行普通“强制结束客户端”。可查看后台窗口的标题、输出和所在桌面;仅当当前窗口唯一存在已识别的 Cancel/取消按钮时,提供单独确认的原生取消。核对身份、用户会话和按钮快照后发送请求,再重新检查实际结果;没有识别到按钮时不猜菜单参数,不抢占前台。 6. 每项动作前后持久记录实际结果,异常保留已完成/未执行项。若最终记录保存失败但独立库释放证明已确认,界面明确提示记录失败并接受释放事实,不伪造新的占用。 7. 客户端退出仅证明进程结束,不表示修复成功或 READY。服务器仍活跃或库状态未知时保留 PARTIAL、检查点和映射。只有完整的独立释放证明才解除匹配的历史记录;空进程列表本身不是释放证明。 diff --git a/docs/ICDB-MANUAL-REPAIR-AND-UPDATE.md b/docs/ICDB-MANUAL-REPAIR-AND-UPDATE.md index 5c232c1..83f2d0b 100644 --- a/docs/ICDB-MANUAL-REPAIR-AND-UPDATE.md +++ b/docs/ICDB-MANUAL-REPAIR-AND-UPDATE.md @@ -10,7 +10,7 @@ ## 残留客户端与共享服务器 -0.2.4b1 的默认检查、校验、取消和释放流程不会强杀原生会话。操作员可以在独立确认界面强制结束属于当前 Windows 用户和会话、名单中的受支持客户端;这会影响该客户端内其他已打开工程,未保存更改可能丢失,属于异常退出处理,不能替代 Repair。 +0.2.4b2 的默认检查、校验、取消和释放流程保留正在原生调用中的 worker 和保存/关闭助手。停止只阻止后续动作,必要时转后台观察;保存、关闭、进程退出和资源释放分别记录。独立确认的“强制结束客户端”也不放行本工具尚未返回的 Save/Close。符合其他释放条件的受支持客户端仍可另行确认结束;这会影响其其他工程,属于异常退出处理,不能替代 Repair。 ICDB 数据库服务器即使命令行指向当前中心库,也可能服务其他用户,**本工具不允许强制结束服务器**。归属未知的进程、后台导入器和脚本宿主同样不允许强制结束;由库管理员核对用户和服务器状态后处理。 diff --git a/docs/releases/2026-11-06-runtime-lifecycle-candidate.md b/docs/releases/2026-11-06-runtime-lifecycle-candidate.md new file mode 100644 index 0000000..a7e9bf0 --- /dev/null +++ b/docs/releases/2026-11-06-runtime-lifecycle-candidate.md @@ -0,0 +1,39 @@ +# 0.2.4b2 原生操作生命周期候选 + +本候选处理 PR #12 评论 297 的三条 P1 及直接相关的停止、释放记录问题。ICDB 自动 Repair 仍关闭,现场失联恢复尚未验收。本轮不合并、不发布正式版、不关闭工单。 + +## 行为 + +- 停止、超时、失败收尾和监督器失联只请求停止后续动作,不强杀可能正在 Save/Close 的 worker 或 cscript。保存助手先持久登记精确身份,再通过启动门进入 COM。保存返回、关闭返回和独立资源释放分别记录;进程消失不能把未知保存升级为成功。 +- 普通停止等待 5 秒;可能正在写入时最多等待 120 秒后转后台观察。相关库的租约、映射和精确进程观察继续保留,不占全局队列票据;独立库可以运行。用户取消的批次不自动恢复。 +- 管理 catalog/add/remove 使用统一监督器身份、取消信号、启动门和会话记录。更新在 remove 后停止,记录需恢复,不继续 add。异步 Add 提交前必须成功保存 NATIVE_CALL;提交后记录失败仍保留监督。未知 Add 结果不触发自动 Close/Quit,明确且已应答的原生失败可正常收尾。 +- 重启在后台核对受控记录,不执行记录中的命令或重放写操作。PID 复用只观察替代进程,继续独立资源核对;证明成立才解除对应等待。报告错误、损坏 JSON 本身不生成全局占用。 +- 权威状态桥保持默认;legacy 读取只观察已打开、匹配库且可读取的 LM,不启动程序、不回答提示、不关闭用户窗口。无法观察保持 UNKNOWN。 + +界面保持三个页签。新增说明写在本文和代码中;界面仅呈现当前状态和操作结果。原工作区、用户图标改动和已运行程序未替换。 + +## 实现与审查 + +基线为 `5eb4b2d`,独立分支为 `codex/runtime-lifecycle-safety`。保存与只读接线共用 mentor_adapter,审查顺序为:事实/会话协议 → 保存与停止 → 管理监督 → 界面交接 → 独立审查修正。共享文件的 A/C 接线合并在同一提交,候选仅在三单元联通后生成。 + +独立审查发现并修正:IDENTITY_CHANGED 提前结束观察、异步 Add 阶段不准确、权限 COM 查询后未再次检查取消,以及写入阶段记录失败后仍继续提交 Add。新增回归先复现失败,再验证修正。该审查不等于真实 Mentor 数据恢复验收。 + +## 验证口径 + +可机读结果、源码身份、XML 与候选包哈希见 [验证记录](2026-11-06-runtime-lifecycle-validation.json)。Python 全量回归、实际 32 位 cscript 的 FakeDoc Save/Close、真实 Windows 测试进程的父进程退出,以及冻结入口冒烟分别记录。 + +最终源码提交 `5873b71`:**1,717 passed**,编译与 diff 检查通过。正式候选 GUI 及四类 worker 入口冒烟通过;62 个产品模块的冻结字节码与当前源码一致。独立冻结夹具的保存/管理 × 用户取消/父进程退出共四个场景通过。唯一已知测试警告为 pywinauto 的 STA 模式提示。 + +本地便携 ZIP 为 `CbbRefreshVerify-0.2.4b2-runtime-lifecycle-5873b71.zip`,54,227,147 字节;SHA-256:`5983a4e99884d9551d1dba3d81af88f754ce876c19a780fe82e8ea9fd58a566b`。未上传为正式 Release。构建、XML 和各专项结果文件的实际路径保存在验证 JSON。 + +冻结测试夹具是独立测试程序,使用同一批产品模块并替换外部原生边界;不随候选交付,也不是应用实际按钮操作或真实数据库修复。冻结产品的 GUI、启动前取消、拒绝错误桌面的管理入口、进程探针及仅观察的弹窗代理单独冒烟。 + +可复现脚本在 `tests/support/runtime_lifecycle_frozen_*.py`。它们是实际执行脚本的逐字节副本,最终套件完成后归档,未改变产品源码或 pytest 收集范围。先按现有 spec 构建产品,再以 `runtime_lifecycle_frozen_fixture.py` 为独立 PyInstaller onedir/console 入口、产品 `src` 为搜索路径构建夹具;`runtime_lifecycle_frozen_smoke.py ` 和 `runtime_lifecycle_frozen_boundaries.py ` 分别验证产品与夹具。产物目录结构见验证 JSON,不应将测试夹具放入便携包。 + +本轮没有在生产库执行原生写入、删除地址/锁文件、强杀 Mentor、选择历史版本或重放旧管理任务。下列项仍为 **未验收**: + +- 使用本候选实际按钮完成真实 Mentor 隔离副本的 Save 中停止、延迟 Close、管理失联及独立库继续。 +- Windows 10、共享网络库和跨机器并发。 +- 现场故障一致副本上的 ICDB 失联恢复、数据版本和 READY 验收。 + +原生 COM 调用本身可能不可取消。后台观察提供状态与资源保护,不承诺把任意卡死进程自动安全结束。回退程序不撤销数据库事务;工程恢复仍依靠人工一致备份或明确选择的原生历史版本。 diff --git a/docs/releases/2026-11-06-runtime-lifecycle-validation.json b/docs/releases/2026-11-06-runtime-lifecycle-validation.json new file mode 100644 index 0000000..15af991 --- /dev/null +++ b/docs/releases/2026-11-06-runtime-lifecycle-validation.json @@ -0,0 +1,380 @@ +{ + "date": "2026-11-06T08:53:02.058981+00:00", + "version": "0.2.4b2", + "base_commit": "5eb4b2d7ed09947f19310ba80ba3b9a2a09b6f7d", + "source_commit": "5873b7146b61d0cdd0eb22f6f2941797b02f38fc", + "src_tree": "ef5ef877665fff179dd6d21d8d6f86e8de0a7e5b", + "pytest_tests_tree": "35f5ad42f2c6150bf5762a46cdeb9880d1fc0d0c", + "environment": { + "platform": "Windows-11-10.0.26200-SP0", + "python": "3.12.10", + "mentor_library_manager_file_version": "2012.0.522.442", + "mentor_library_manager_sha256": "a9c4c3d806794dbdc56d2bc4c637a1cf25e87e98644a7d5fd4eb0067ca5845e0", + "mentor_home": "D:\\Mentor\\7.9.5EE\\SDD_HOME", + "matches_validated_mentor_library_manager_binary": true + }, + "tests": { + "final_full": { + "status": "passed", + "tests": 1717, + "failures": 0, + "errors": 0, + "skipped": 0, + "xml": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\runtime-lifecycle-final-1717.xml", + "xml_sha256": "1d427f97dd04afbf8912bbdf787b0b9dfd1ed383d32bfe07f7a94cc24f9c5292" + }, + "known_warning": "pywinauto: Revert to STA COM threading mode", + "compileall": "passed", + "git_diff_check": "passed", + "independent_review": "important findings resolved through 051498b" + }, + "frozen_product": { + "build": "passed", + "smoke": { + "gui": { + "status": "passed", + "exit_code": 0 + }, + "verify-worker": { + "exit_code": 1, + "status": "passed", + "evidence": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\runtime-lifecycle-b2\\smoke-74da6fd5\\verify-worker" + }, + "management-worker": { + "exit_code": 2, + "status": "passed", + "evidence": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\runtime-lifecycle-b2\\smoke-74da6fd5\\management-worker" + }, + "owner-probe": { + "exit_code": 0, + "status": "passed", + "evidence": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\runtime-lifecycle-b2\\smoke-74da6fd5\\owner-probe" + }, + "dialog-agent": { + "status": "passed", + "exit_code": 0, + "scope": "empty PID set, observe only" + }, + "module_origins": { + "status": "passed", + "module_count": 62, + "source_root": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795-review-stack\\src" + }, + "version": "0.2.4b2" + }, + "evidence": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\runtime-lifecycle-b2\\smoke-74da6fd5\\result.json", + "evidence_sha256": "4f354f3700d09e299e6437d36492fd8b380440eae7e5ec859c90645f16004ac2", + "module_bytecode_matches_source": true, + "module_count": 62, + "modules": [ + { + "module": "cbb_refresh_verify", + "source_sha256": "dd960394d88657820dba858792abf0de258e05efceb08ae2f0b39c6ad78bc469" + }, + { + "module": "cbb_refresh_verify.application", + "source_sha256": "433c22b01df8376651c43cc9fe7f9551b531dcd3b3e590b77cb3ec1bfbfd2de6" + }, + { + "module": "cbb_refresh_verify.backup_recovery", + "source_sha256": "ea7bb90151e825efb6163e43ed344b62407565005f0a0459c423ba2205539373" + }, + { + "module": "cbb_refresh_verify.batch_status", + "source_sha256": "918c80dd4f75146baa6b7616ce415ac89ee28f6c1f46b2bfda77bacc998b5b62" + }, + { + "module": "cbb_refresh_verify.com_runtime", + "source_sha256": "f0f3802d16c791a8bf9dfef44a94917072bfbe8fb3a927d76be8ef0341c7ed35" + }, + { + "module": "cbb_refresh_verify.content_check", + "source_sha256": "8239c17b6e2452917ed573a7deb3e4c8583eaef91bf3630eff5f424d2e398aa9" + }, + { + "module": "cbb_refresh_verify.defaults", + "source_sha256": "a1c03192f4a61ad0924b24bb635705b1ee4811d35483a02864200f95edbbebe3" + }, + { + "module": "cbb_refresh_verify.desktop_worker", + "source_sha256": "1dd449e9885b32cb479970ddb9d1e3b580bc6339f9b491be0a414a1de8054efa" + }, + { + "module": "cbb_refresh_verify.diagnostic_open", + "source_sha256": "d6c49ffe5a9969d95edbbc896d47a7e100f248380a287f99ba7bb8b92dbb3072" + }, + { + "module": "cbb_refresh_verify.dialog_agent", + "source_sha256": "6a9b9802912afc4dd670ee9b28845d97bd64fe55fd577815ef729850fcff78db" + }, + { + "module": "cbb_refresh_verify.dialog_models", + "source_sha256": "f68cee01d927b48364276d3c1f79e63ce8af231878db0b907d292780cfbafb56" + }, + { + "module": "cbb_refresh_verify.dialog_probe", + "source_sha256": "d61f0c955c961980c9635940eefb9c7947c1fe90b4b6fd844720df41ddb0aa0e" + }, + { + "module": "cbb_refresh_verify.dialog_rules", + "source_sha256": "3189b476f7ff4678b59212ed7b4081164e038a7cf7662cd895f9019cb3c1edc5" + }, + { + "module": "cbb_refresh_verify.dialog_supervisor", + "source_sha256": "15c415c2d2e916f0b64ba04416164ff3b50996d70b22d3b4ac2226b5547ac247" + }, + { + "module": "cbb_refresh_verify.failed_session", + "source_sha256": "7e6f7fa5ebcf2d49f00c5efc5f5d26412704b68e9122e476ac1f672009a98c09" + }, + { + "module": "cbb_refresh_verify.icdb_maintenance", + "source_sha256": "e81d253d8b4d3e7c1000c45335a392c72b110748675c2c3324ebe524a7252e98" + }, + { + "module": "cbb_refresh_verify.icdb_ownership", + "source_sha256": "7bf2342c1efa34a2ebcbf27964a40a490220f7146fbb6ef957b8d8dd1e511f03" + }, + { + "module": "cbb_refresh_verify.icdb_recovery", + "source_sha256": "358c0e9a004f1e0b2127513286e1dffd94b0180a8b7314aa9655462f570b6360" + }, + { + "module": "cbb_refresh_verify.integration", + "source_sha256": "f188856af69ba25e265988c51db7a6d4263326440d972ca78378b733b891c1ed" + }, + { + "module": "cbb_refresh_verify.library_lock", + "source_sha256": "eea9021300410cc810eaa0e18aac546c94139f89528f5d68784ef3f943b65ce4" + }, + { + "module": "cbb_refresh_verify.library_manager_verify", + "source_sha256": "71e16a8581ad44b646be78b480f9812d596a6d162b3eec03d078bf4ea4503195" + }, + { + "module": "cbb_refresh_verify.library_reader", + "source_sha256": "d4007caa361edd467773e49f721e02671d5a9bcb30741769a57349850b12c438" + }, + { + "module": "cbb_refresh_verify.maintenance_entry", + "source_sha256": "3b93c25f69d7a961facd8004e20e155a84cc18f06d57b741a9055786ed058990" + }, + { + "module": "cbb_refresh_verify.management", + "source_sha256": "3d6e2505ce6e21acdea88d59b920229ba1ce2cee6c914ac1b0b8267cf0d34ffc" + }, + { + "module": "cbb_refresh_verify.management_transaction", + "source_sha256": "32c53caaead05d5db3a31d3e30721e65434e5837095dc0a7812f825603aa37a0" + }, + { + "module": "cbb_refresh_verify.mentor_adapter", + "source_sha256": "15bde6706c6533d839646b894896237921b89a8a3ce3016aa8161c591dab314f" + }, + { + "module": "cbb_refresh_verify.mentor_paths", + "source_sha256": "ba48c0003b3eacc88906497b2e43b299ca4536a9f7dae44bbacf6a6ec694c116" + }, + { + "module": "cbb_refresh_verify.models", + "source_sha256": "9e8209a8b006df923f1d07ccab64bbcfe5d674c4fc5f5426bfbc9b11da4ee105" + }, + { + "module": "cbb_refresh_verify.native_add_failures", + "source_sha256": "192202732423dc624c5548c75e80bb20973e5087c21d4798c9637f25b6de7e94" + }, + { + "module": "cbb_refresh_verify.native_backup", + "source_sha256": "7276fa3d9298e85550151cf0c7191d84bd08a18a72df5d854a3c38f1a88b001d" + }, + { + "module": "cbb_refresh_verify.native_engineering_identity", + "source_sha256": "a241bc3be7dc5a922ce728f1febd3684e79e6e45935589c80a4b1a5933e05df5" + }, + { + "module": "cbb_refresh_verify.native_export_guard", + "source_sha256": "5120c13e4ef1255d4c61316eb40005c4039c23e41edca4437bd0ef28b543a959" + }, + { + "module": "cbb_refresh_verify.native_management", + "source_sha256": "27a835bc31cfe0e1a09d767977e5c348d40e246c58d58ce1ef085411afe6d56e" + }, + { + "module": "cbb_refresh_verify.native_occupancy", + "source_sha256": "7d686079d12217382adace6361cd343d977b91075e3b157cf410ca92d07ffc49" + }, + { + "module": "cbb_refresh_verify.native_repair", + "source_sha256": "9f024dcb5e3a76369191033474fefd30787b6ae350c315f3cf38e92e5a1f3e98" + }, + { + "module": "cbb_refresh_verify.native_repair_ui", + "source_sha256": "3eb2af181befea94af8b3b3131edff09589f340bcba777abbe3b67fd31b80393" + }, + { + "module": "cbb_refresh_verify.network_path", + "source_sha256": "6b5b159502d42a46bf4ee26d5698fd2c6498b359088e2138eae46e9065b13c6f" + }, + { + "module": "cbb_refresh_verify.operation_lifecycle", + "source_sha256": "28b6cdebd22caaf369eeb8b7236e258b8160a8fa7c7d8bfbf0980979e9eba3ae" + }, + { + "module": "cbb_refresh_verify.operation_queue", + "source_sha256": "57ad9da8aeedd9cd75a8c5b5fda44044bcb457670a4a323e9e8bb247198074ab" + }, + { + "module": "cbb_refresh_verify.owner_probe", + "source_sha256": "8dcfd60246cb2979db34d02e0a2d605c334b6f7e2666f22daa2f50c0408bc903" + }, + { + "module": "cbb_refresh_verify.pcb_bridge", + "source_sha256": "745ef117e984021e8a3d9087a2783c1efe19bed97edcfbcfae7703a291cc6eaa" + }, + { + "module": "cbb_refresh_verify.pcb_restore_prompt", + "source_sha256": "5342612ad666e3faf5a9a4ce4710e9af458d357c44037135f2837dad436d5cf7" + }, + { + "module": "cbb_refresh_verify.post_repair_consent", + "source_sha256": "3b1eaff1db58fd311a9dbc5fdcd850911b04cc5afd4e747f70a62b721b8fafa4" + }, + { + "module": "cbb_refresh_verify.post_verify_diagnostics", + "source_sha256": "2442de485bc0d6a34c4b2d9b10bc5f323ea38f9ff66674119a50f5c6043bac63" + }, + { + "module": "cbb_refresh_verify.reimport_recovery", + "source_sha256": "66b2ba8f8c2ec9ae8c386d6b1aa74a1fbb6bfb509c4df0a262f8d7a0ca48469e" + }, + { + "module": "cbb_refresh_verify.residual_sessions", + "source_sha256": "69d39648a2f3c98a297847baf51373632acd881f034a2a011d0c3d27dbec3dfc" + }, + { + "module": "cbb_refresh_verify.runtime_logging", + "source_sha256": "44ac25430a89c5ffc9e48e88c227e88052f4c815365e8556f67918f3edaba39e" + }, + { + "module": "cbb_refresh_verify.runtime_timing", + "source_sha256": "c4ed4057b5000e0b86ccc7dd1fe2004d6e0dae29f397fec77b01ad41a81c6367" + }, + { + "module": "cbb_refresh_verify.scoped_manifest", + "source_sha256": "54cf4288e7850e220b394ae971ea98785eba631f80784a3f9354209e649f6498" + }, + { + "module": "cbb_refresh_verify.session_record", + "source_sha256": "394719d125b91ff124d707229f4599dcca9229d2c6e653840ef7e02f48c642b6" + }, + { + "module": "cbb_refresh_verify.status_bridge", + "source_sha256": "05d627d02934a14f5de409472c291d37565a95b836f9c130111aae80612e9196" + }, + { + "module": "cbb_refresh_verify.ui", + "source_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" + }, + { + "module": "cbb_refresh_verify.ui.backup_notice", + "source_sha256": "1a3fa5ac18a267907faf95f36d61b9f08bcbb939eef4d480dd06af1391a81599" + }, + { + "module": "cbb_refresh_verify.ui.backup_recovery_dialog", + "source_sha256": "621ea2efea85367b0c9bb9790040860a1ac001f40f8834289cb67c96ea0648d1" + }, + { + "module": "cbb_refresh_verify.ui.icdb_check_task", + "source_sha256": "01985644641ec623ed440433248d9445ab5b9f37d27a843ec7f26267895de397" + }, + { + "module": "cbb_refresh_verify.ui.main_window", + "source_sha256": "a625b2934a34c86ff30eaf115e50b0560cbb24f3dccf15bbb51574a9808c660d" + }, + { + "module": "cbb_refresh_verify.ui.management_dialog", + "source_sha256": "93b7a7464161e7448aa78c42ca8742c970e80387f9c6c1b9b4b6a07532da3ebf" + }, + { + "module": "cbb_refresh_verify.ui.pcb_restore_dialog", + "source_sha256": "b7228d828df235ac51502dc68760d28c4896af02c780e9806e11c32dba7f62da" + }, + { + "module": "cbb_refresh_verify.ui.residual_release_dialog", + "source_sha256": "ca0e18886457800cae7b543286395f05db1a74eb41e53fc54cfee57f93294368" + }, + { + "module": "cbb_refresh_verify.ui.workers", + "source_sha256": "4cc9360a4820ded27a7d5ef709fc9f04b1d4804cb1e7a614f6c357ed547da888" + }, + { + "module": "cbb_refresh_verify.verify_diagnostics", + "source_sha256": "041b77d7d49e4c86338ed5e5741d0d27a2c42bc358f4da54b3efe64af847e9b8" + }, + { + "module": "cbb_refresh_verify.verify_runner", + "source_sha256": "2c7c37d2b510ab5735cd4a71cb834768c711e31b0ce5dd28b23acb8dcfe22ffb" + } + ], + "exe": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\runtime-lifecycle-b2\\dist\\CbbRefreshVerify-Background\\CbbRefreshVerify.exe", + "exe_sha256": "9051ab52acb67d0d291ae230e7d55d1ce6f580f653d58a82d463b7c42cebb90f", + "zip": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\runtime-lifecycle-b2\\CbbRefreshVerify-0.2.4b2-runtime-lifecycle-5873b71.zip", + "zip_sha256": "5983a4e99884d9551d1dba3d81af88f754ce876c19a780fe82e8ea9fd58a566b", + "zip_bytes": 54227147 + }, + "frozen_native_boundaries": { + "scope": "separate frozen fixture; fake native COM/management boundary", + "product_native_database_recovery_validated": false, + "results": [ + { + "mode": "save", + "stop_kind": "cancel", + "status": "passed" + }, + { + "mode": "save", + "stop_kind": "supervisor-loss", + "status": "passed" + }, + { + "mode": "management", + "stop_kind": "cancel", + "status": "passed" + }, + { + "mode": "management", + "stop_kind": "supervisor-loss", + "status": "passed" + } + ], + "evidence": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\runtime-lifecycle-b2\\frozen-boundaries-cdb9d884\\result.json", + "evidence_sha256": "9cdc149a6fa545206c361aaba278ef54c9ee2529e9a09b440c5fcf9378fc8529", + "module_bytecode_matches_source": true, + "module_count": 47, + "validation_helpers": [ + { + "file": "tests\\support\\runtime_lifecycle_frozen_fixture.py", + "sha256": "b87761c06a300f0d93bce864d3d31e045f2135324b2a9a42f8682ccbff09ad22" + }, + { + "file": "tests\\support\\runtime_lifecycle_frozen_boundaries.py", + "sha256": "bf98533a1c06ccf4453d20b3804323779719e697141b8dc64fa679960a979cfd" + }, + { + "file": "tests\\support\\runtime_lifecycle_frozen_smoke.py", + "sha256": "b11e0aac71c1079625ac9832dc5c38197bc80110478c4d9e02c2a3bc58a2a2d0" + } + ], + "helpers_copied_after_full_suite": true, + "note": "Tracked helper files are byte-identical copies of the scripts executed from diagnostics. Not shipped; do not replace real application-button acceptance." + }, + "not_run": [ + "Real Mentor isolated-copy application-button Save/Close and management-loss scenarios", + "Windows 10 and cross-machine shared-library concurrency", + "Field ICDB disconnected-session recovery and data-version/READY acceptance" + ], + "auto_repair_enabled": false, + "production_native_writes_performed": false, + "merged_or_published": false, + "issues_closed": false +} diff --git a/docs/superpowers/plans/2026-11-06-runtime-lifecycle-safety.md b/docs/superpowers/plans/2026-11-06-runtime-lifecycle-safety.md index 4d38fff..4a8c7fc 100644 --- a/docs/superpowers/plans/2026-11-06-runtime-lifecycle-safety.md +++ b/docs/superpowers/plans/2026-11-06-runtime-lifecycle-safety.md @@ -102,7 +102,7 @@ resource_state = ("RELEASED" if native_released is True and helper_exited is Tru - `launch_save_helper(command, **kwargs)` 保持原调用兼容;生产调用附加第 4 个 VBS 参数 `start_gate`,helper 未放行时不进入 COM;已有三参数 harness 保留兼容覆盖。 - helper 启动门在 30 秒内未放行或取消时,以明确的启动前取消结果退出。门放行前记录精确 helper 身份,不靠事后按父 PID 猜测。 -- [ ] **Step 1: 扩展真实 cscript harness,先复现保存中取消和保存后关闭失败。** 继续使用 `tests/test_save_helper_runtime.py` 中实际 VBS 源码,仅替换 COM 创建。FakeDoc.Save 内创建取消文件后返回 True;FakeDoc.Close 返回 False 或延迟返回。断言: +- [x] **Step 1: 扩展真实 cscript harness,先复现保存中取消和保存后关闭失败。** 继续使用 `tests/test_save_helper_runtime.py` 中实际 VBS 源码,仅替换 COM 创建。FakeDoc.Save 内创建取消文件后返回 True;FakeDoc.Close 返回 False 或延迟返回。断言: ```python assert "SAVE_OK" in completed.stdout @@ -112,8 +112,8 @@ assert completed.returncode != 0 ``` 另写门未打开的 harness,在 FakeDoc.Save 中写 `save-called.txt`;取消/门超时后该文件必须不存在。 -- [ ] **Step 2: 运行 `python -m pytest -q tests/test_save_helper_runtime.py tests/test_failure_lifecycle.py -k "save or helper"`,确认新行为失败。** 不运行真实 Mentor 保存。 -- [ ] **Step 3: 按调用边界写标记,取消只阻止尚未开始的写入。** 局部错误检查示例: +- [x] **Step 2: 运行 `python -m pytest -q tests/test_save_helper_runtime.py tests/test_failure_lifecycle.py -k "save or helper"`,确认新行为失败。** 不运行真实 Mentor 保存。 +- [x] **Step 3: 按调用边界写标记,取消只阻止尚未开始的写入。** 局部错误检查示例: ```vb CheckCancellationBeforeSave @@ -136,8 +136,8 @@ WScript.Echo "SAVE_OK" ``` 把 `saveError/saveDescription` 加入 Option Explicit 的 Dim。IsSaved/后置同步/Close 使用同样局部检查并写各自原因,不抹掉 SAVE_OK;取消后只在精确文档、已保存且没有未知模态提示时做既有正常关闭,不再次 Save、不自动放弃脏文档。 -- [ ] **Step 4: 保存等待不再因取消文件出现就直接抛错丢弃监督。** 本任务先提供可观察的调用返回事实;Task 4 再统一所有生产停止入口,不能保留“保存脚本启动后随便 terminate”的中间交付。 -- [ ] **Step 5: 重跑真实 cscript harness、身份核对和 runtime_timing 回归,通过后提交。** `git commit -m "fix: preserve native save results across cancellation"`。 +- [x] **Step 4: 保存等待不再因取消文件出现就直接抛错丢弃监督。** 本任务先提供可观察的调用返回事实;Task 4 再统一所有生产停止入口,不能保留“保存脚本启动后随便 terminate”的中间交付。 +- [x] **Step 5: 重跑真实 cscript harness、身份核对和 runtime_timing 回归,通过后提交。** `git commit -m "fix: preserve native save results across cancellation"`。 ### Task 3:受控会话记录和后台观察交接 @@ -157,7 +157,7 @@ WScript.Echo "SAVE_OK" - immutable `session.json`、单写者 `worker-state.json`、watchdog 的 `supervisor-lost.json`、观察者的 `observation-.json` 分开,不互相覆盖。 - 等待循环只使用精确句柄的零等待观察,不持有 `_guard`/全局原生互斥,不循环扫描全库。退出后才尝试独立释放证明;通道忙只延后该观察,不把其他库也设为不可用。 -- [ ] **Step 1: 写协议/重启身份测试。** 使用临时 JSON 和本测试创建的 sleep 子进程;在记录上替换 created 或 executable,确保返回 IDENTITY_CHANGED 而不是结束新进程。损坏 JSON、超过 64 KiB 和越界目录返回 UNCONFIRMED。 +- [x] **Step 1: 写协议/重启身份测试。** 使用临时 JSON 和本测试创建的 sleep 子进程;在记录上替换 created 或 executable,确保返回 IDENTITY_CHANGED 而不是结束新进程。损坏 JSON、超过 64 KiB 和越界目录返回 UNCONFIRMED。 ```python def test_record_outside_controlled_root_is_observation_only(tmp_path): @@ -172,10 +172,10 @@ def test_record_outside_controlled_root_is_observation_only(tmp_path): ``` PID 复用测试在本测试创建的进程身份记录上替换 created/image,再走同一个 reconcile 入口;只模拟外部进程观察边界,不用实现返回值代替被测流程。 -- [ ] **Step 2: 运行 `python -m pytest -q tests/test_session_record.py`,确认 RED。** -- [ ] **Step 3: 实现精确身份、记录路径约束与独立释放证明。** 核对 supervisor/worker/helper/native 的创建时间、映像和当前用户/Windows 会话。PID 不在快照中不能直接生成 RELEASED;复用现有 `release_retained_library` 证明,不删 `.lock`/sAddress.adr。 -- [ ] **Step 4: 增加后台交接测试。** A 库 helper 保持活跃,转观察后释放 NativeQueue action;同库写请求仍等待,B 库请求可运行。映射直到匹配库独立释放证明成立才归还;调用 `process.close()` 不得丢失观察所需的精确句柄。 -- [ ] **Step 5: 验证报告写失败不终止活跃调用、不把记录存在本身当占用。** 内存观察保留,下一次可重新核对。通过后提交 `git commit -m "feat: persist and reconcile owned native sessions"`。 +- [x] **Step 2: 运行 `python -m pytest -q tests/test_session_record.py`,确认 RED。** +- [x] **Step 3: 实现精确身份、记录路径约束与独立释放证明。** 核对 supervisor/worker/helper/native 的创建时间、映像和当前用户/Windows 会话。PID 不在快照中不能直接生成 RELEASED;复用现有 `release_retained_library` 证明,不删 `.lock`/sAddress.adr。 +- [x] **Step 4: 增加后台交接测试。** A 库 helper 保持活跃,转观察后释放 NativeQueue action;同库写请求仍等待,B 库请求可运行。映射直到匹配库独立释放证明成立才归还;调用 `process.close()` 不得丢失观察所需的精确句柄。 +- [x] **Step 5: 验证报告写失败不终止活跃调用、不把记录存在本身当占用。** 内存观察保留,下一次可重新核对。通过后提交 `git commit -m "feat: persist and reconcile owned native sessions"`。 ### Task 4:统一用户停止、超时、finally、kill 和 watchdog @@ -198,7 +198,7 @@ PID 复用测试在本测试创建的进程身份记录上替换 created/image - `attempt_recovery(request, diagnosis, evidence_root, *, progress=None, stop=None)` 只补取消传播,不使其默认启用。 - 保存等待转后台的默认界限为 120 秒,放在 `defaults.py` 的 `NATIVE_WRITE_STOP_WAIT_SECONDS`;普通合作式停止等待保持 5 秒。 -- [ ] **Step 1: 替换冲突的旧期望并增加跨组件失败测试。** `test_stop_cancels_then_stops_automation_client_after_deadline` 不能再锁定保存中会 kill 的行为。用本测试创建的 helper 进程触发 `_stop_worker`,使 `kill` 和 `stop_automation_clients` 在活跃 Save 时被调用即失败: +- [x] **Step 1: 替换冲突的旧期望并增加跨组件失败测试。** `test_stop_cancels_then_stops_automation_client_after_deadline` 不能再锁定保存中会 kill 的行为。用本测试创建的 helper 进程触发 `_stop_worker`,使 `kill` 和 `stop_automation_clients` 在活跃 Save 时被调用即失败: ```python class SavingWorker: @@ -215,10 +215,10 @@ def test_cancel_preserves_pending_save(): ``` 这个 fake 只用于停止分派边界;另用实际 sleep/helper 与真实 VBS harness 验证生命周期,不只断言 mock 被调用。 -- [ ] **Step 2: 覆盖五个触发入口。** 用户停止、活动超时、对话框错误、finally 收尾、父进程退出分别触发;verify 生产配置 `stop_clients=True` 必须在测试中出现,不只测默认参数 False。 -- [ ] **Step 3: 接入同一阶段判据。** 原生调用可能进行中时只写取消意图;短等待后不关闭观察句柄,120 秒后交 Task 3 观察。只有已证明未进入写入的辅助进程允许终止。`DesktopWorker.kill` 及 watchdog 不能绕开此判据;保存 helper 的注册/启动门与 supervisor 失联竞争必须被覆盖。 -- [ ] **Step 4: 清理前采样并保留中断事实。** 更新 session-release/outcome/result/recovery-required 的生成逻辑。后续发现进程退出可以更新 resource_state,但不能把未知保存重写成成功;正常关闭失败保留 COMMITTED。`safe_to_continue=True` 不删除 write_outcome 中的失败。 -- [ ] **Step 5: 跑 `tests/test_operation_lifecycle.py tests/test_session_record.py tests/test_failure_lifecycle.py tests/test_abnormal_shutdown.py tests/test_verify_worker_stability.py tests/test_incident_safety.py`,通过后执行交付单元 A 的完整回归并提交。** `git commit -m "fix: honor native write boundaries on every stop path"`。 +- [x] **Step 2: 覆盖五个触发入口。** 用户停止、活动超时、对话框错误、finally 收尾、父进程退出分别触发;verify 生产配置 `stop_clients=True` 必须在测试中出现,不只测默认参数 False。 +- [x] **Step 3: 接入同一阶段判据。** 原生调用可能进行中时只写取消意图;短等待后不关闭观察句柄,120 秒后交 Task 3 观察。只有已证明未进入写入的辅助进程允许终止。`DesktopWorker.kill` 及 watchdog 不能绕开此判据;保存 helper 的注册/启动门与 supervisor 失联竞争必须被覆盖。 +- [x] **Step 4: 清理前采样并保留中断事实。** 更新 session-release/outcome/result/recovery-required 的生成逻辑。后续发现进程退出可以更新 resource_state,但不能把未知保存重写成成功;正常关闭失败保留 COMMITTED。`safe_to_continue=True` 不删除 write_outcome 中的失败。 +- [x] **Step 5: 跑 `tests/test_operation_lifecycle.py tests/test_session_record.py tests/test_failure_lifecycle.py tests/test_abnormal_shutdown.py tests/test_verify_worker_stability.py tests/test_incident_safety.py`,通过后执行交付单元 A 的完整回归并提交。** `git commit -m "fix: honor native write boundaries on every stop path"`。 ### Task 5:管理 worker 的监督器失联与事务边界取消 @@ -236,7 +236,7 @@ def test_cancel_preserves_pending_save(): - 新增私有 `_require_management_continuation(job, root)`:每次新原生调用前校验当前取消/监督器身份;被取消时抛已有管理错误并明确 native_started,而不是启动下一动作。 - 现有 `_require_add_supervisor(job, root)` 调用共享判据并保留 add deadline 检查,不移除已有安全检查。 -- [ ] **Step 1: 写无监督器和双阶段 update 测试。** 在 catalog 前使 supervisor 退出,确保不创建 LM;remove 调用内部模拟父进程退出但保留 native owner,返回后确保 add 不调用。断言部分完成与资源释放分别记录: +- [x] **Step 1: 写无监督器和双阶段 update 测试。** 在 catalog 前使 supervisor 退出,确保不创建 LM;remove 调用内部模拟父进程退出但保留 native owner,返回后确保 add 不调用。断言部分完成与资源释放分别记录: ```python assert result.status == "RECOVERY_REQUIRED" # remove 已发生,add 未发出 @@ -245,10 +245,10 @@ assert result.safe_to_continue is True # 本例原生 owner 已独立证 assert not any(call[0] == "add" for call in adapter.calls if isinstance(call, tuple)) ``` -- [ ] **Step 2: 对 catalog/add/remove 三条 worker 路由分别触发取消和父进程退出。** 正在 native wait/COM 调用时 helper/worker 存活,返回后不进入下一写动作;同目标不得自动重试。 -- [ ] **Step 3: 启动前持久登记并使用 gate,worker 在身份检查后 armed watchdog。** watchdog 只写自己的失联文件和取消信号,不异步退出正在做原生调用的工作进程。调用返回后执行正常自有会话收尾;未知弹窗记录并交已有提示入口。 -- [ ] **Step 4: 将仅依赖 `_pending_workers/_retained_workers` 的判据补为内存+可核对记录。** 内存列表继续用于同一进程的快速收尾,但不是唯一恢复入口;读不到 result.json 不能永久推断 owner 活着。 -- [ ] **Step 5: 跑管理三个测试文件与 `tests/test_native_management.py tests/test_native_export_guard.py`,通过后提交。** `git commit -m "fix: supervise management workers across cancellation and parent loss"`。 +- [x] **Step 2: 对 catalog/add/remove 三条 worker 路由分别触发取消和父进程退出。** 正在 native wait/COM 调用时 helper/worker 存活,返回后不进入下一写动作;同目标不得自动重试。 +- [x] **Step 3: 启动前持久登记并使用 gate,worker 在身份检查后 armed watchdog。** watchdog 只写自己的失联文件和取消信号,不异步退出正在做原生调用的工作进程。调用返回后执行正常自有会话收尾;未知弹窗记录并交已有提示入口。 +- [x] **Step 4: 将仅依赖 `_pending_workers/_retained_workers` 的判据补为内存+可核对记录。** 内存列表继续用于同一进程的快速收尾,但不是唯一恢复入口;读不到 result.json 不能永久推断 owner 活着。 +- [x] **Step 5: 跑管理三个测试文件与 `tests/test_native_management.py tests/test_native_export_guard.py`,通过后提交。** `git commit -m "fix: supervise management workers across cancellation and parent loss"`。 ### Task 6:重启核对和相关库范围的可操作入口 @@ -267,11 +267,11 @@ assert not any(call[0] == "add" for call in adapter.calls if isinstance(call, tu - GUI 后台核对只显示状态,不自动点击原生提示、不重放新增/更新/移除、不仅按 Cbb 桌面前缀结束进程。 - NativeQueue 使用已有 ready 回调查询已缓存的相关库可执行性;ready 自身不做 WMI、文件读取或 SMB 路径解析。 -- [ ] **Step 1: 写“重启时 active、exited、PID reused、记录损坏”四个场景。** 检查行为结果而不是只检查某函数调用次数:active 可看原生阶段,exited 需独立证明,reused 没有 native 消息,损坏记录不禁用全部 UI。 -- [ ] **Step 2: 写 A 库等待、B 库可执行的队列测试。** 暂停保存的 A 保留关联租约,不占队列 active;B 可完成,A 同库新写操作不会进入。用户取消批次不会在恢复后自动重放。 -- [ ] **Step 3: 接入启动时的后台发现与已有“查看原生提示/处理保存/请求原生取消/重新检查”。** 未知窗口只展示真实原因;记录 helper 正在 Save/Close 时不向普通强制结束路径放行。不为“能释放”而新增任意杀进程按钮。 -- [ ] **Step 4: 证明成立后只解除匹配会话的历史记录和映射。** 关闭自有 desktop 句柄,不能宣称已删除仍有原生引用的桌面。报告保存失败单独展示,不把有效释放反转成真实占用。 -- [ ] **Step 5: 跑上述四个文件与 `tests/test_residual_sessions.py tests/test_residual_release_dialog.py`,再跑 A+B 完整回归后提交。** `git commit -m "fix: reconcile retained sessions without blocking independent libraries"`。 +- [x] **Step 1: 写“重启时 active、exited、PID reused、记录损坏”四个场景。** 检查行为结果而不是只检查某函数调用次数:active 可看原生阶段,exited 需独立证明,reused 没有 native 消息,损坏记录不禁用全部 UI。 +- [x] **Step 2: 写 A 库等待、B 库可执行的队列测试。** 暂停保存的 A 保留关联租约,不占队列 active;B 可完成,A 同库新写操作不会进入。用户取消批次不会在恢复后自动重放。 +- [x] **Step 3: 接入启动时的后台发现与已有“查看原生提示/处理保存/请求原生取消/重新检查”。** 未知窗口只展示真实原因;记录 helper 正在 Save/Close 时不向普通强制结束路径放行。不为“能释放”而新增任意杀进程按钮。 +- [x] **Step 4: 证明成立后只解除匹配会话的历史记录和映射。** 关闭自有 desktop 句柄,不能宣称已删除仍有原生引用的桌面。报告保存失败单独展示,不把有效释放反转成真实占用。 +- [x] **Step 5: 跑上述四个文件与 `tests/test_residual_sessions.py tests/test_residual_release_dialog.py`,再跑 A+B 完整回归后提交。** `git commit -m "fix: reconcile retained sessions without blocking independent libraries"`。 ### Task 7:关闭 legacy 读取的隐式启动和肯定按钮回退 @@ -290,7 +290,7 @@ assert not any(call[0] == "add" for call in adapter.calls if isinstance(call, tu - 无匹配 LM 返回原有 FLAG_UNKNOWN 或 `{name: None}`,并附可读原因,不要求每次搜索/过滤都人工开 LM。 - `handle_known_dialogs` 留给需要的已验证写路径;状态读取不调用它,不修改其他流程的弹窗规则。 -- [ ] **Step 1: 写未知提示和无 LM 的回归。** 把 CreateDesktop/CreateProcess/PostMessage 与 affirmative handler 设为触发即失败,调用两个兼容 reader 和 `scan_open_library_status`: +- [x] **Step 1: 写未知提示和无 LM 的回归。** 把 CreateDesktop/CreateProcess/PostMessage 与 affirmative handler 设为触发即失败,调用两个兼容 reader 和 `scan_open_library_status`: ```python def test_status_read_does_not_launch_or_answer_when_lm_is_absent(monkeypatch): @@ -303,10 +303,10 @@ def test_status_read_does_not_launch_or_answer_when_lm_is_absent(monkeypatch): ``` 再对“修复/覆盖/保存/未知许可提示”的窗口快照参数化,要求没有任何消息发送。 -- [ ] **Step 2: 运行 `python -m pytest -q tests/test_readonly_status_policy.py`,确认 RED。** -- [ ] **Step 3: 去掉读取路径的自动创建和通用肯定应答。** 抽取最小既有 LM 树观察函数,使用 exact library identity,只读树项,不关闭用户打开的窗口;窗口不可读就返回未知。若发现其他调用方仍依赖隐式启动,迁到明确的原生工具打开入口或保留未知,不隐藏恢复原行为。 -- [ ] **Step 4: 跑 reader/bridge/UI 状态回归,并用混合 READY/PENDING/UNAVAILABLE 清单检查数量和筛选。** 默认桥成功时不改变结果;legacy 无 LM 不弹每项确认、不启动 Mentor、不伪造损坏。 -- [ ] **Step 5: 提交。** `git commit -m "fix: keep legacy status reads observational"`。 +- [x] **Step 2: 运行 `python -m pytest -q tests/test_readonly_status_policy.py`,确认 RED。** +- [x] **Step 3: 去掉读取路径的自动创建和通用肯定应答。** 抽取最小既有 LM 树观察函数,使用 exact library identity,只读树项,不关闭用户打开的窗口;窗口不可读就返回未知。若发现其他调用方仍依赖隐式启动,迁到明确的原生工具打开入口或保留未知,不隐藏恢复原行为。 +- [x] **Step 4: 跑 reader/bridge/UI 状态回归,并用混合 READY/PENDING/UNAVAILABLE 清单检查数量和筛选。** 默认桥成功时不改变结果;legacy 无 LM 不弹每项确认、不启动 Mentor、不伪造损坏。 +- [x] **Step 5: 提交。** `git commit -m "fix: keep legacy status reads observational"`。 ### Task 8:GUI/CLI 停止传播和结果展示联调 @@ -326,11 +326,11 @@ def test_status_read_does_not_launch_or_answer_when_lm_is_absent(monkeypatch): - UI 接受 write_outcome 和 session_record_path,但不直接读取/resolve 这些路径;通过现有 ServiceWorker 接收事实。 - 文案分别为“已请求停止,等待当前保存返回”“保存已返回,关闭待确认”“已转后台观察,可查看状态”“当前状态无法确认”,只在对应事实成立时显示。 -- [ ] **Step 1: 写 CLI 默认 verifier 的 stop 传播测试与 GUI 延迟保存测试。** GUI 点击停止后 200ms 定时器仍可触发、搜索仍可编辑;新原生动作没有发出,进度不假称已保存或已释放。 -- [ ] **Step 2: 写 action 抛异常、队列取消和按库 ready 的回归。** 保留已存在的 Event 轮询取消语义;不用无通知无限 wait;一项异常释放队列票据,后续可执行独立项不被遗留票据挡住。 -- [ ] **Step 3: 接入停止来源与事实投影。** `auto_repair=False` 保持默认;兼容修复/复验的 stop 转发使用 Task 4 新签名。Save/Close 尚未确认时不启用本目标自动重试,也不禁用所有只读操作。 -- [ ] **Step 4: 跑队列、后台、界面和 CLI 测试,检查退出/重启后未完成状态仍可见。** GUI 线程中将 Path.resolve、WMI、文件读取替换为失败哨兵,确认事实展示不触发它们。 -- [ ] **Step 5: 提交。** `git commit -m "fix: propagate stop intent and display independent lifecycle facts"`。 +- [x] **Step 1: 写 CLI 默认 verifier 的 stop 传播测试与 GUI 延迟保存测试。** GUI 点击停止后 200ms 定时器仍可触发、搜索仍可编辑;新原生动作没有发出,进度不假称已保存或已释放。 +- [x] **Step 2: 写 action 抛异常、队列取消和按库 ready 的回归。** 保留已存在的 Event 轮询取消语义;不用无通知无限 wait;一项异常释放队列票据,后续可执行独立项不被遗留票据挡住。 +- [x] **Step 3: 接入停止来源与事实投影。** `auto_repair=False` 保持默认;兼容修复/复验的 stop 转发使用 Task 4 新签名。Save/Close 尚未确认时不启用本目标自动重试,也不禁用所有只读操作。 +- [x] **Step 4: 跑队列、后台、界面和 CLI 测试,检查退出/重启后未完成状态仍可见。** GUI 线程中将 Path.resolve、WMI、文件读取替换为失败哨兵,确认事实展示不触发它们。 +- [x] **Step 5: 提交。** `git commit -m "fix: propagate stop intent and display independent lifecycle facts"`。 ### Task 9:完整回归、冻结包和隔离验收 @@ -347,11 +347,11 @@ def test_status_read_does_not_launch_or_answer_when_lm_is_absent(monkeypatch): - 验证记录必须关联最终 source tree SHA、测试 XML 哈希、实际版本、候选包 SHA-256、平台/Mentor 版本;缺少真实包或环境的项使用 not_run/unverified,不能写 passed。 - 旧 `0.2.4b1` / `5eb4b2d` 的 1,631 完整回归和 63 项专项为历史基线,不是本轮验收结果。 -- [ ] **Step 1: 在独立测试互斥/临时恢复目录下串行跑最终完整套件。** `python -m pytest -q` 必须来自新工作树 src,子进程 PYTHONPATH 同步。不要同时在同一 runner 跑另一个使用真实产品互斥或固定恢复根的全量任务。 -- [ ] **Step 2: 跑 `python -m compileall -q src tests` 和 `git diff --check`。** 保持源文件原行尾;记录预期 pywinauto COM 提示,新的警告另查。 -- [ ] **Step 3: 生成候选包前更新为 0.2.4b2,按现有 spec 打包并运行 frozen 入口冒烟。** 验证 verify-worker、management-worker、owner-probe、dialog-agent 的模块/脚本可加载;运行“冻结程序 + fake 保存/管理 native 边界”的父进程退出与停止测试。构建环境缺外部依赖时记录具体缺项,不宣称已产生候选包。 +- [x] **Step 1: 在独立测试互斥/临时恢复目录下串行跑最终完整套件。** `python -m pytest -q` 必须来自新工作树 src,子进程 PYTHONPATH 同步。不要同时在同一 runner 跑另一个使用真实产品互斥或固定恢复根的全量任务。 +- [x] **Step 2: 跑 `python -m compileall -q src tests` 和 `git diff --check`。** 保持源文件原行尾;记录预期 pywinauto COM 提示,新的警告另查。 +- [x] **Step 3: 生成候选包前更新为 0.2.4b2,按现有 spec 打包并运行 frozen 入口冒烟。** 验证 verify-worker、management-worker、owner-probe、dialog-agent 的模块/脚本可加载;运行“冻结程序 + fake 保存/管理 native 边界”的父进程退出与停止测试。构建环境缺外部依赖时记录具体缺项,不宣称已产生候选包。 - [ ] **Step 4: 通过应用实际按钮运行隔离副本。** 单独记录 Save 前停止、Save 中停止、Close 延迟、管理父进程退出、legacy 未打开 LM、未知原生提示、独立库继续。缺实机场景保留未验收;不为验收在生产库保存中杀进程。 -- [ ] **Step 5: 更新文档与审查描述。** 写清默认停止规则、后台观察范围、只读未知状态、真实 COM 无法取消的限制、程序回退与数据恢复的区别。测试用例数量不得替代场景证据。 +- [x] **Step 5: 更新文档与审查描述。** 写清默认停止规则、后台观察范围、只读未知状态、真实 COM 无法取消的限制、程序回退与数据恢复的区别。测试用例数量不得替代场景证据。 - [ ] **Step 6: 提交候选记录,推送本轮差分草稿 PR。** `git commit -m "docs: record runtime lifecycle validation and candidate limits"`;按 A/B/C 提供审查顺序,不自动发布或关闭 ICDB 工单。若 main 已变化,重新整合并验证实际候选树。 ## 验收映射与自查 @@ -367,4 +367,4 @@ def test_status_read_does_not_launch_or_answer_when_lm_is_absent(monkeypatch): 本轮排除项见设计第 13 节。源文件行号以基线供定位,实施时先用 rg 重新定位所有调用方,不直接按旧行号打补丁。 -后续默认在当前会话用 executing-plans 按阶段执行;如用户明确选择并行代理,再使用对应技能。当前草案完成后先整体审阅设计,未取得实施指令前只保留文档。 +实施记录:用户已授权执行。实施在当前会话逐项完成;独立只读审查按 requesting-code-review 技能执行,没有并行修改源码。保存启动门依赖会话协议,故先提交协议 primitive(97a3de2);mentor_adapter 的停止与只读修改共用文件,在 8d3eab1 合并提交 A/C 基础接线。管理接线为 6278091,界面及按库交接为 cb11624,独立审查修正为 d9a79b6、051498b。三单元联通后统一验证、生成候选,未提前交付不完整的 A 单元。真实环境未验收项见候选记录。 diff --git a/docs/superpowers/specs/2026-11-06-runtime-lifecycle-safety-design.md b/docs/superpowers/specs/2026-11-06-runtime-lifecycle-safety-design.md index c80acd1..857aade 100644 --- a/docs/superpowers/specs/2026-11-06-runtime-lifecycle-safety-design.md +++ b/docs/superpowers/specs/2026-11-06-runtime-lifecycle-safety-design.md @@ -1,6 +1,6 @@ # CBB 原生操作生命周期与只读边界设计草案 -状态:设计草案,待用户整体审阅;本轮只规划,不实现运行时代码。 +状态:用户已批准并授权实施。运行时实现与验证见同日计划和候选记录;不代表现场 ICDB 恢复验收。 范围已由用户确认:三条 P1,加上直接相关的停止与状态记录问题。 @@ -198,4 +198,4 @@ GUI、CLI run_batch、ICDB 后台检查将 stop 传入同一请求链。兼容 a - 没有通过新增历史记录硬门禁解决问题;活动写入仍保持真实资源约束。 - 没有依赖“调用 watchdog(stop_clients=False) 就万事解决”的错误假设。 - 只读回退范围与权威桥路径区分;未知状态不伪造 READY/PENDING。 -- 设计为草案;执行前需用户审阅行为与验收条件,尚未视为代码实施授权。 +- 用户已通过“按照当前的优化吧”授权实施;真实环境验收仍单独记录,不以测试计数代替。 diff --git a/tests/support/runtime_lifecycle_frozen_boundaries.py b/tests/support/runtime_lifecycle_frozen_boundaries.py new file mode 100644 index 0000000..3ef55f5 --- /dev/null +++ b/tests/support/runtime_lifecycle_frozen_boundaries.py @@ -0,0 +1,95 @@ +import ast +import json +import os +from pathlib import Path +import subprocess +import sys +import time +from uuid import uuid4 + +workspace = Path(sys.argv[1]).resolve() +bundle_root = Path(sys.argv[2]).resolve() +sys.path.insert(0, str(workspace/'src')) +fixture = bundle_root/'fixture-dist/runtime_lifecycle_frozen_fixture/runtime_lifecycle_frozen_fixture.exe' +native_source = bundle_root/'dist/CbbRefreshVerify-Background/_internal/cbb_refresh_verify/save_verified_block.vbs' +root = bundle_root/('frozen-boundaries-' + uuid4().hex[:8]) +root.mkdir() +test_ast = ast.parse((workspace/'tests/test_save_helper_runtime.py').read_text('utf-8')) +classes = next(node.value for node in ast.walk(test_ast) if isinstance(node, ast.Constant) + and isinstance(node.value, str) and 'Class FakePi' in node.value and 'SAVE_BODY' in node.value) +save_body = '''Dim fso, flag +Set fso = CreateObject("Scripting.FileSystemObject") +Set flag = fso.CreateTextFile(WScript.Arguments(4), True) +flag.Close +WScript.Sleep 2000 +Set flag = fso.CreateTextFile(WScript.Arguments(5), True) +flag.Close +Save = True''' +classes = classes.replace('SAVE_BODY', save_body).replace('CLOSE_BODY', 'Close = True').replace('IS_SAVED_VALUE', 'True') +source = native_source.read_text('utf-8').replace('Option Explicit', 'Option Explicit\nDim closedDoc\n' + classes) +source = source.replace('GetObject(, "MGCPCB.Application")', 'New FakeApp') +source = source.replace('CreateObject("MGCPCBAutomationLicensing.Application")', 'New FakeLic') +script = root/'native-boundary.vbs' +script.write_text(source, 'ascii') + +from cbb_refresh_verify.desktop_worker import DesktopWorker +from cbb_refresh_verify.session_record import process_identity, read_session_record +from cbb_refresh_verify.operation_lifecycle import classify_save_state +from cbb_refresh_verify.verify_runner import _stop_worker +results = [] +for mode in ('save', 'management'): + for stop_kind in ('cancel', 'supervisor-loss'): + evidence = root/(mode+'-'+stop_kind) + evidence.mkdir() + supervisor = subprocess.Popen([sys.executable, '-c', 'import time;time.sleep(30)'], + creationflags=subprocess.CREATE_NO_WINDOW) + job = dict(root=str(evidence), operation_id=uuid4().hex, operation='catalog' if mode=='management' else 'verify', + library=str(evidence/'lib.lmc'), block='Fixture', block_name='Fixture', + desktop=('CbbManagement_' if mode=='management' else 'CbbVerify_')+uuid4().hex[:10], + supervisor_pid=supervisor.pid, supervisor_identity=process_identity(supervisor.pid), + cancel_signal=str(evidence/'cancel.signal'), start_gate=str(evidence/'start.signal'), + session_record_path=str(evidence/'session.json'), script=str(script), + cscript=str(Path(os.environ['WINDIR'])/'SysWOW64/cscript.exe')) + request = evidence/'request.json' + request.write_text(json.dumps(job), 'utf-8') + worker = DesktopWorker([str(fixture), '--'+mode+'-worker', str(request)], job['desktop']) + worker.bind_cancellation(job['cancel_signal']) + worker.bind_session(job) + try: + Path(job['start_gate']).touch() + deadline = time.monotonic()+30 + while not (evidence/'call-started').exists() and time.monotonic()= 2 and isinstance(value[0], str) and value[0].startswith('cbb_refresh_verify') + and isinstance(value[1], str) and value[1].endswith('.py')): + rows.append(value) + else: + stack.extend(value) +assert rows and all(Path(row[1]).is_relative_to(workspace/'src') for row in rows) +results['module_origins'] = {'status': 'passed', 'module_count': len(rows), 'source_root': str(workspace/'src')} +results['version'] = '0.2.4b2' +(root/'result.json').write_text(json.dumps(results, ensure_ascii=False, indent=2), 'utf-8') +print(json.dumps({'evidence': str(root/'result.json'), **results}, ensure_ascii=False), flush=True)