diff --git a/.gitea/workflows/m6-ci.yml b/.gitea/workflows/m6-ci.yml new file mode 100644 index 00000000..2e2f33b6 --- /dev/null +++ b/.gitea/workflows/m6-ci.yml @@ -0,0 +1,102 @@ +name: M6 deployable RC + +on: + push: + pull_request: + workflow_dispatch: + +env: + FORCE_COLOR: "0" + NO_COLOR: "1" + +jobs: + quick: + runs-on: [self-hosted, linux, x64, blender-web] + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-node@v4 + with: + node-version: 20.19.2 + cache: npm + cache-dependency-path: web/package-lock.json + - name: Run quick lane + run: npm --prefix web run ci:quick + - name: Validate quick report + run: npm --prefix web run test:ci-report -- release/ci-reports/quick.json + - name: Upload quick report + if: always() + uses: actions/upload-artifact@v4 + with: + name: m6-quick-report + path: release/ci-reports/ + retention-days: 7 + + chromium: + needs: quick + runs-on: [self-hosted, linux, x64, blender-web] + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-node@v4 + with: + node-version: 20.19.2 + cache: npm + cache-dependency-path: web/package-lock.json + - name: Install browser driver from lockfile + run: | + npm --prefix web ci --ignore-scripts + npm --prefix web exec -- playwright install chromium + - name: Run Chromium lane + run: npm --prefix web run ci:chromium + - name: Validate Chromium report + run: npm --prefix web run test:ci-report -- release/ci-reports/chromium.json + - name: Upload Chromium report + if: always() + uses: actions/upload-artifact@v4 + with: + name: m6-chromium-report + path: release/ci-reports/ + retention-days: 14 + + release: + needs: chromium + if: ${{ github.event_name == 'workflow_dispatch' || (github.event_name == 'push' && github.ref == 'refs/heads/main') }} + runs-on: [self-hosted, linux, x64, blender-web-release] + env: + BLENDER_BIN: ${{ vars.BLENDER_BIN }} + BLENDER_ARCHIVE_SHA256: ${{ vars.BLENDER_ARCHIVE_SHA256 }} + VDB_RESOURCE_ROOT: ${{ vars.VDB_RESOURCE_ROOT }} + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-node@v4 + with: + node-version: 20.19.2 + cache: npm + cache-dependency-path: web/package-lock.json + - name: Cache pinned Emscripten toolchain data + uses: actions/cache@v4 + with: + path: .emcache + key: emscripten-${{ runner.os }}-3.1.69-${{ hashFiles('tools/web/emscripten-env.sh', 'web/package-lock.json') }} + - name: Install browser driver from lockfile + run: | + npm --prefix web ci --ignore-scripts + npm --prefix web exec -- playwright install chromium + - name: Run release lane + run: npm --prefix web run ci:release + - name: Validate release report and hashes + run: npm --prefix web run test:ci-report -- release/ci-reports/release.json + - name: Upload release report and archives + if: always() + uses: actions/upload-artifact@v4 + with: + name: m6-release-report + path: | + release/ci-reports/ + release/archive-reports/ + release/operations-reports/ + release/SHA256SUMS.txt + release/RC_MANIFEST.json + release/RC_MANIFEST.json.sha256 + release/blender-web-offline.tar.gz + release/blender-web-corresponding-source.tar.gz + retention-days: 30 diff --git a/README.md b/README.md index b12a50df..718f09e5 100644 --- a/README.md +++ b/README.md @@ -32,6 +32,8 @@ npm --prefix web run test:browser See `docs/CURRENT_EXECUTION_PLAN.md` for the current task order, `docs/PROJECT_STATUS_AND_NEXT_WORK.md` for the implemented scope, and `docs/BLENDER_5_2_WEB_FEATURE_PARITY.md` for the long-term Blender parity ledger. +The atomic full-product work breakdown is in +`docs/BLENDER_5_2_FULL_PARITY_WBS.md`. The release contract and explicit non-goals are defined in `docs/WEB_BLENDER_MODELER_V1_SCOPE.md`. diff --git a/docs/BLENDER_5_2_FULL_PARITY_WBS.md b/docs/BLENDER_5_2_FULL_PARITY_WBS.md new file mode 100644 index 00000000..687d2027 --- /dev/null +++ b/docs/BLENDER_5_2_FULL_PARITY_WBS.md @@ -0,0 +1,518 @@ +# Blender 5.2 全功能对标工作分解 + +更新时间：2026-08-15 + +## 1. 目标与事实边界 + +本文把“对标 Blender 全部功能”定义为：以仓库内 `blender-5.2.0` 的 RNA、operator、 +data-block、modifier、node、editor、文件格式和运行时后端为冻结基线，逐项给出 +`LOCAL_EXACT`、`LOCAL_BOUNDED`、`SERVER` 或 `EXCLUDED` 结论，并为结论保存可复验的正例、 +阻断例和数据保真证据。 + +当前 `Web Blender Modeler V1` 已达到其有界发布范围，但不等于完整 Blender。机器账本中 +N-015 至 N-026 的 12 个 family 全部仍为 `parityStatus=BLOCKED`。因此以下任务默认均为未完成； +只有 `docs/status/parity-ledger.json` 和对应专项证据同时更新后才允许改变状态。 + +短周期唯一领取顺序仍以 `docs/CURRENT_EXECUTION_PLAN.md` 为准。本文负责完整产品范围和细粒度 +工作包，不取代当前执行队列。 + +## 2. 原子任务完成定义 + +每个能力切片必须依次通过以下原子门；不能用后一个门反推前一个门完成： + +| 门 | 单一产物 | 退出条件 | +| --- | --- | --- | +| G0 Inventory | 一条机器可读 inventory 记录 | Blender 5.2 名称、源码锚点、依赖和分类均存在 | +| G1 Contract | 一个版本化协议 | 字段、上限、稳定 ID、错误码和 revision 规则可纯校验 | +| G2 Reader | 一个 Blender Main reader | 真实 fixture 可读；缺失、损坏和 linked 输入有稳定结果 | +| G3 Evaluator | 一个求值切片 | desktop 与 WASM 的语义或误差 golden 通过 | +| G4 Writer | 一个 Main transaction | 只产生一个 undo step；失败不改变 revision | +| G5 Persistence | 一个保存重开闭环 | save、Worker restart、reopen 后语义和稳定 ID 一致 | +| G6 Delta | 一个增量协议 | base/next revision、乱序、重复和 stale 输入均有测试 | +| G7 UI | 一个可操作入口 | context、selection、取消、键盘路径和错误显示完整 | +| G8 Viewport | 一个渲染闭环 | 主线程与 Offscreen 资源生命周期、非空像素和 device loss 通过 | +| G9 Interop | 一个导入/导出结论 | round-trip 或机器可读 loss/block report 通过 | +| G10 Quality | 一个发布证据 | 性能、OOM、quota、恶意输入、取消和泄漏门通过 | + +一个原子任务只允许交付一个门。新增白名单项时，必须为该项新建自己的 G2-G10 证据，不能只 +扩大数组后复用其他项的成功记录。 + +## 3. 阶段与最小里程碑 + +| 阶段 | 最小里程碑 | 前置 | 退出条件 | +| --- | --- | --- | --- | +| S0 可部署运行时 | M6.1-M6.7 | V1 RC | single/pthread、HTTP、归档、CI、运维逐项通过 | +| S1 核心项目体验 | M7 | S0 | 30 分钟 edit/save/reopen soak 和恢复通过 | +| S2 全量清单冻结 | F00 | S1 | Blender 5.2 inventory 生成器输出稳定且零未分类项 | +| S3 数据与场景核心 | F01-F03 | S2 | Main/ID/Scene/Object/Collection/View Layer 闭环 | +| S4 几何创作 | F04-F08 | S3 | Mesh、非 Mesh、Sculpt、Paint、Grease Pencil 分域通过 | +| S5 程序化与材质 | F09-F11 | S3 | Modifier、Geometry Nodes、Shader/Texture 分域通过 | +| S6 动画与绑定 | F12-F13 | S3 | Animation、Rigging、Constraint、Driver、NLA 分域通过 | +| S7 模拟与渲染 | F14-F16 | S5、S6 | Physics、Render、Compositor 的 local/server 边界通过 | +| S8 媒体与跟踪 | F17-F18 | S3 | VSE/Audio、Tracking/Mask 闭环 | +| S9 资产与互操作 | F19-F20 | S3 | Library/Asset 与逐格式 round-trip/loss report 通过 | +| S10 编辑器与平台 | F21-F23 | S4-S9 | editor、keymap、scripting、安全、跨浏览器分类完成 | +| S11 全域发布审计 | F24 | S0-S10 | inventory 零缺口；每项均有正例或稳定阻断证据 | + +每个 F 域内部再按 `inventory -> read -> evaluate -> write -> persist -> UI -> quality` 形成独立小 +里程碑。跨域依赖只允许引用已经通过的前置门。 + +## 4. F00 全量清单与状态生成 + +- [ ] `F00-01` 从 RNA 生成全部 data-block type 清单。 +- [ ] `F00-02` 从 operator registry 生成 operator、poll context 和参数清单。 +- [ ] `F00-03` 从 modifier enum 生成全部 modifier type 清单。 +- [ ] `F00-04` 从 node registries 生成 Geometry、Shader、Compositor node 清单。 +- [ ] `F00-05` 从 constraint registry 生成 Object/Bone constraint 清单。 +- [ ] `F00-06` 从 editor space types 生成 editor、region 和 mode 清单。 +- [ ] `F00-07` 从 import/export registrations 生成格式和扩展清单。 +- [ ] `F00-08` 从 render/physics feature flags 生成后端能力清单。 +- [ ] `F00-09` 为每条清单记录 Blender 源文件、符号和版本。 +- [ ] `F00-10` 为每条清单分配稳定 parity ID，重跑不得漂移。 +- [ ] `F00-11` 把现有 N-001 至 N-026 证据映射到 parity ID。 +- [ ] `F00-12` 拒绝同一 parity ID 同时声明不兼容的 release class。 +- [ ] `F00-13` CI 检查新增 Blender 项目必须先分类才能合并。 +- [ ] `F00-14` 生成按 family、状态、后端和依赖聚合的差距报告。 +- [ ] `F00-15` 固定 Blender 5.2 inventory hash，作为全域发布输入。 + +里程碑 F00：重复生成结果 byte-for-byte 一致，未分类计数为 0，任何汇总状态均可追溯到单项。 + +## 5. F01 文件、Main、ID 与恢复 + +- [ ] `F01-01` 盘点全部可持久化 ID type 和 embedded ID。 +- [ ] `F01-02` 为每个 ID type 建立最小合法 `.blend` fixture。 +- [ ] `F01-03` 为 library-linked、missing、override 三种所有权建立 fixture。 +- [ ] `F01-04` 逐 ID type 验证 wasm32 DNA 对齐和指针重建。 +- [ ] `F01-05` 逐 ID type 验证 Main 加载、释放和 100 次重复无增长。 +- [ ] `F01-06` 固定 stable ID 在 rename、duplicate、append 后的规则。 +- [ ] `F01-07` 固定 ID add/remove/remap 的单事务 revision 规则。 +- [ ] `F01-08` 验证 undo/redo 不产生悬挂 ID 引用。 +- [ ] `F01-09` 验证保存取消保持旧 `.blend` hash。 +- [ ] `F01-10` 验证 OOM 保持旧 Main 和旧 OPFS revision。 +- [ ] `F01-11` 验证 staging、journal、manifest 三个崩溃点恢复。 +- [ ] `F01-12` 验证跨 Worker 重启的 command replay 去重。 +- [ ] `F01-13` 建立 schema migration 向前、向后和拒绝矩阵。 +- [ ] `F01-14` 建立 autosave、manual save、save-as 的互斥状态机。 +- [ ] `F01-15` 建立未知新 DNA 字段的数据保留测试。 + +里程碑 F01：所有已分类 ID 都能精确读取并安全释放；允许写入的 ID 完成原子保存重开，其余保持 +数据不丢失并返回稳定阻断。 + +## 6. F02 Scene、Object、Collection 与 View Layer + +- [ ] `F02-01` 完整读取 Scene、ViewLayer、LayerCollection 和 Collection 层级。 +- [ ] `F02-02` 完整读取 Object 类型、实例、显示、选择和可见性状态。 +- [ ] `F02-03` 验证 local/world/parent inverse/delta transform 组合。 +- [ ] `F02-04` 验证 parent 类型 Object/Bone/Vertex/Vertex3。 +- [ ] `F02-05` 实现 View Layer create/remove/rename Main transaction。 +- [ ] `F02-06` 实现 Collection link/unlink/move Main transaction。 +- [ ] `F02-07` 实现 Object link/unlink/duplicate/delete Main transaction。 +- [ ] `F02-08` 实现 parent/unparent/clear inverse Main transaction。 +- [ ] `F02-09` 实现 transform、apply transform 和 origin 独立 transaction。 +- [ ] `F02-10` 实现 instance collection 和 real-user 计数安全门。 +- [ ] `F02-11` 验证 dependency cycle 和跨 Scene 引用阻断。 +- [ ] `F02-12` 同步 View3D、Outliner、Properties 的 selection/context revision。 +- [ ] `F02-13` 验证 local view、hide、exclude、holdout 和 indirect-only 映射。 +- [ ] `F02-14` 保存重开后比较层级、可见性和 stable ID。 +- [ ] `F02-15` 建立 100k Object/Collection 的分块与性能门。 + +## 7. F03 Depsgraph、Animation Frame 与 Delta + +- [ ] `F03-01` 为全部 ID type 记录 depsgraph component/operation 支持状态。 +- [ ] `F03-02` 验证 graph build、tagged update、frame change 和 graph free。 +- [ ] `F03-03` 验证对象 transform dependency ordering。 +- [ ] `F03-04` 验证 modifier、constraint、driver、parent 跨对象依赖边。 +- [ ] `F03-05` 验证 dependency cycle 报告包含稳定对象和 operation ID。 +- [ ] `F03-06` 固定每种 Main edit 的最小 recalc tag。 +- [ ] `F03-07` 拒绝 stale evaluation 覆盖新 revision。 +- [ ] `F03-08` 固定 frame seek 取消和迟到结果丢弃规则。 +- [ ] `F03-09` 对 snapshot 与 delta 结果建立等价性测试。 +- [ ] `F03-10` 对 add/remove/remap 建立 delta 顺序测试。 +- [ ] `F03-11` 对 mesh byte range 建立重叠、越界和合并测试。 +- [ ] `F03-12` 对资源 delta 建立 hash、生命周期和引用计数测试。 +- [ ] `F03-13` 主线程与 Offscreen 消费同一 revision 序列。 +- [ ] `F03-14` 100 次 frame/update 循环无 Main、Worker、GPU 持续增长。 + +## 8. F04 Mesh 建模与 UV + +- [ ] `F04-01` 冻结 Object/Edit Mode mesh operator 白名单。 +- [ ] `F04-02` 完成 vertex/edge/face select、history 和 active element。 +- [ ] `F04-03` 完成 box/circle/lasso/select-linked/select-similar。 +- [ ] `F04-04` 完成 primitive add 的逐 primitive fixture。 +- [ ] `F04-05` 完成 merge、split、separate、join 的逐操作闭环。 +- [ ] `F04-06` 完成 extrude vertex/edge/face/region 的逐模式闭环。 +- [ ] `F04-07` 完成 inset individual/region 的逐参数闭环。 +- [ ] `F04-08` 完成 bevel vertex/edge 的 segment/profile/clamp 闭环。 +- [ ] `F04-09` 完成 loop cut、slide 和 edge ring selection。 +- [ ] `F04-10` 完成 knife、bisect 和 intersect 的独立闭环。 +- [ ] `F04-11` 完成 rip、spin、screw 和 bridge edge loops。 +- [ ] `F04-12` 完成 fill、grid fill、beautify 和 triangulate/quads。 +- [ ] `F04-13` 完成 dissolve vertex/edge/face/limited dissolve。 +- [ ] `F04-14` 完成 normals recalc/flip/split/merge by distance。 +- [ ] `F04-15` 完成 crease、bevel weight、sharp、seam 属性编辑。 +- [ ] `F04-16` 完成 vertex group、color attribute 和 generic attribute 编辑。 +- [ ] `F04-17` 完成 UV seam、unwrap、smart project、cube/cylinder/sphere project。 +- [ ] `F04-18` 完成 UV select、stitch、weld、pin、align、pack islands。 +- [ ] `F04-19` 完成 multi-UV map、active/render UV 和 UDIM tile 规则。 +- [ ] `F04-20` 每个 operator 建立 non-manifold、degenerate 和预算负例。 +- [ ] `F04-21` 每个 operator 建立 Main/undo/save/reopen/desktop golden。 +- [ ] `F04-22` 建立 1M vertex edit 的取消、内存和 delta 性能门。 + +## 9. F05 Curve、Surface、Text、Metaball 与现代 Curves + +- [ ] `F05-01` 完成 Curve Poly/Bezier/NURBS 全字段 reader。 +- [ ] `F05-02` 完成 Surface U/V order、knot、endpoint、cyclic reader。 +- [ ] `F05-03` 完成 Text body、textbox、paragraph、style 和 VFont reader。 +- [ ] `F05-04` 完成 Metaball family、element、threshold 和 update reader。 +- [ ] `F05-05` 完成 Curves point/curve domain 与全部基础属性 reader。 +- [ ] `F05-06` 完成 PointCloud position/radius/custom attributes reader。 +- [ ] `F05-07` 完成 spline/control point/handle create、remove、reorder。 +- [ ] `F05-08` 完成 spline type convert、cyclic、tilt、radius 和 weight 编辑。 +- [ ] `F05-09` 完成 Surface U/V topology 和 rational weight 编辑。 +- [ ] `F05-10` 完成 Text body、style range、textbox 和 layout 编辑。 +- [ ] `F05-11` 完成外部字体校验、OPFS 绑定、替换和缺失恢复。 +- [ ] `F05-12` 完成 Metaball element add/remove/transform 编辑。 +- [ ] `F05-13` 完成 Curves selection、comb、length 和 radius 有界工具。 +- [ ] `F05-14` 验证 legacy/evaluated mesh 与 desktop tessellation golden。 +- [ ] `F05-15` 验证主线程/Offscreen handle raycast、gizmo 和释放。 +- [ ] `F05-16` 完成 GLB/USD 映射或逐类型 loss report。 + +## 10. F06 Volume、Hair 与大规模稀疏数据 + +- [ ] `F06-01` 读取 Volume grid、transform、class、type 和 metadata。 +- [ ] `F06-02` 固定 OpenVDB 到 NanoVDB converter build identity。 +- [ ] `F06-03` 校验每个 grid 和 chunk 的 offset、length、hash。 +- [ ] `F06-04` 完成 HTTP range、retry、resume 和 If-Range。 +- [ ] `F06-05` 完成 OPFS bundle 原子绑定和 Worker 重发现。 +- [ ] `F06-06` 定义 GPU page-fault feedback 和 overflow 行为。 +- [ ] `F06-07` 完成 page request 合并、取消、hash 和 stale revision 门。 +- [ ] `F06-08` 完成 resident page table、pin、LRU 和确定性 OOM。 +- [ ] `F06-09` 完成主线程 WebGPU 自动缺页重绘。 +- [ ] `F06-10` 完成 Offscreen WebGPU 相同缺页序列。 +- [ ] `F06-11` 完成 density/temperature/flame/color 有限材质映射。 +- [ ] `F06-12` 完成 device loss 后 page table 有界恢复。 +- [ ] `F06-13` 完成 Hair curves、root binding 和 surface dependency reader。 +- [ ] `F06-14` 完成 64 MiB/1 GiB sparse bundle 预算和取消门。 +- [ ] `F06-15` 完成 Volume Main + asset + viewport 联合保存重开。 +- [ ] `F06-16` 完成 desktop/主线程/Offscreen 三视角 golden。 + +## 11. F07 Sculpt、Vertex Paint、Weight Paint 与 Texture Paint + +- [ ] `F07-01` 冻结 PBVH 类型、brush、falloff 和 symmetry inventory。 +- [ ] `F07-02` 接入真实 PBVH node 查询，移除 proxy-success。 +- [ ] `F07-03` 接入深度/遮挡可见性采样。 +- [ ] `F07-04` 完成 Draw、Smooth、Inflate、Grab 各自 desktop golden。 +- [ ] `F07-05` 完成 Mask draw/clear/invert 和 Face Set 操作。 +- [ ] `F07-06` 完成 symmetry、radial symmetry 和 texture mask 规则。 +- [ ] `F07-07` 一个 pointer session 只提交一个 Main undo step。 +- [ ] `F07-08` 完成 Vertex Paint blend、falloff、selection mask。 +- [ ] `F07-09` 完成 Weight Paint normalize、limit、mirror、clean。 +- [ ] `F07-10` 完成 multi-paint、auto-normalize 和 bone selection 联动。 +- [ ] `F07-11` 完成 Texture Paint UV hit、seam bleed 和 clone source。 +- [ ] `F07-12` 完成 packed/UDIM dirty tile 原子事务。 +- [ ] `F07-13` 完成 4K/8K texture upload、LRU、quota 和 OOM。 +- [ ] `F07-14` 完成笔/压力输入与鼠标输入确定性 fixture。 +- [ ] `F07-15` 每种 paint 模式完成 undo/save/reopen 和 Worker restart。 + +## 12. F08 Grease Pencil + +- [ ] `F08-01` 完成 Layer/Group/Frame/Drawing/Stroke/Point 全字段 reader。 +- [ ] `F08-02` 完成 layer/group create/remove/reorder transaction。 +- [ ] `F08-03` 完成 frame insert/remove/duplicate/move transaction。 +- [ ] `F08-04` 完成 draw/erase stroke 单 pointer transaction。 +- [ ] `F08-05` 完成 point/stroke/segment select、marquee、lasso。 +- [ ] `F08-06` 完成 point radius/opacity/color/material/cyclic 编辑。 +- [ ] `F08-07` 完成 onion skin 和 multi-frame preview。 +- [ ] `F08-08` 完成 2D canvas 与 3D viewport selection revision 同步。 +- [ ] `F08-09` 完成 Dope Sheet frame exposure 编辑。 +- [ ] `F08-10` 逐个接入 Grease Pencil modifier reader/evaluator。 +- [ ] `F08-11` 完成主线程/Offscreen stroke tessellation golden。 +- [ ] `F08-12` 完成 save/reopen、GLB/USD loss 和大 drawing 性能门。 + +## 13. F09 Modifier 与 Geometry Processing + +- [ ] `F09-01` 将 Blender 5.2 modifier 0-86 每项映射到 parity ID。 +- [ ] `F09-02` 每项读取 name、UID、stack order、mode 和 target。 +- [ ] `F09-03` 每项建立 unsupported preservation fixture。 +- [ ] `F09-04` 逐项开放 Generate modifier evaluator 和 golden。 +- [ ] `F09-05` 逐项开放 Deform modifier evaluator 和 golden。 +- [ ] `F09-06` 逐项开放 Physics modifier cache/evaluator 和 golden。 +- [ ] `F09-07` 逐项开放 Grease Pencil modifier evaluator 和 golden。 +- [ ] `F09-08` 逐项实现参数 Main edit、undo、save/reopen。 +- [ ] `F09-09` 逐项实现 apply/copy/move/remove transaction。 +- [ ] `F09-10` 验证 object/collection/texture target 缺失和 cycle。 +- [ ] `F09-11` 验证 viewport/render/edit/cage 开关组合。 +- [ ] `F09-12` 验证 stack reorder 与 depsgraph recalc 最小化。 +- [ ] `F09-13` Decimate 三模式完成全部 delimiter/weight/symmetry 组合。 +- [ ] `F09-14` Subdivision CPU/OpenSubdiv/WebGPU 路径分别声明。 +- [ ] `F09-15` 1M/10M topology 的取消、内存、Worker restart 门。 + +## 14. F10 Geometry Nodes 与 Simulation Zone + +- [ ] `F10-01` 完成 node/group/interface/socket/link/stable ID reader。 +- [ ] `F10-02` 生成全部 Geometry Node type inventory。 +- [ ] `F10-03` 为 unsupported node 保留原图并阻断求值。 +- [ ] `F10-04` 逐 node 建立最小 desktop fixture。 +- [ ] `F10-05` 逐 node 实现 socket 默认值和 link type 校验。 +- [ ] `F10-06` 逐 node 接入 Blender lazy-function evaluator。 +- [ ] `F10-07` 逐 node 比较 geometry、attribute、instance 输出。 +- [ ] `F10-08` 固定 field context、domain adaptation 和匿名属性寿命。 +- [ ] `F10-09` 固定 group recursion、dependency cycle 和深度预算。 +- [ ] `F10-10` 实现 node add/remove/move/link/unlink 单 transaction。 +- [ ] `F10-11` 实现 interface socket add/remove/reorder transaction。 +- [ ] `F10-12` Simulation Zone cache 绑定 graph/source/revision hash。 +- [ ] `F10-13` 完成 cache cancel、LRU、corruption、restart 和 OOM。 +- [ ] `F10-14` 完成 node editor UI、selection、search 和错误定位。 +- [ ] `F10-15` 恶意大图、深链、宽 fan-out 和资源引用预算门。 + +## 15. F11 Material、Shader Nodes、Texture 与 Color Management + +- [ ] `F11-01` 完成 Material slot、surface/volume/displacement 全字段 reader。 +- [ ] `F11-02` 生成全部 Shader Node type inventory。 +- [ ] `F11-03` 逐 node 建立 socket/link/default desktop fixture。 +- [ ] `F11-04` 逐 node 实现 Main add/remove/link/parameter transaction。 +- [ ] `F11-05` 完成 Principled BSDF 全输入和版本语义映射。 +- [ ] `F11-06` 完成 Texture Coordinate/Mapping/Image/Environment 节点。 +- [ ] `F11-07` 完成 Normal/Bump/Displacement/Tangent 节点。 +- [ ] `F11-08` 完成 Math/Vector Math/Mix/Color Ramp 节点。 +- [ ] `F11-09` 固定 unsupported graph preservation 和 compile block。 +- [ ] `F11-10` shader key 绑定 graph、asset、color space 和 backend。 +- [ ] `F11-11` compile failure 保留上一份可用 pipeline。 +- [ ] `F11-12` 完成 image source、packed、UDIM、sequence 和 generated 生命周期。 +- [ ] `F11-13` 完成 sRGB/linear/non-color/scene-linear 转换 golden。 +- [ ] `F11-14` 完成 OCIO view/display/look/exposure 能力矩阵。 +- [ ] `F11-15` 完成 viewport PBR 与 Blender reference 像素误差门。 + +## 16. F12 Animation、Driver、NLA 与 Timeline + +- [ ] `F12-01` 完成 Action/Slot/FCurve/Group/Channel 全字段 reader。 +- [ ] `F12-02` 完成 keyframe insert/delete/move/duplicate transaction。 +- [ ] `F12-03` 完成 constant/linear/bezier interpolation。 +- [ ] `F12-04` 完成 handle type、tangent、easing 和 extrapolation。 +- [ ] `F12-05` 完成 modifier、sampled point 和 cyclic FCurve reader。 +- [ ] `F12-06` 完成 Dope Sheet channel/filter/selection 同步。 +- [ ] `F12-07` 完成 Graph Editor key/handle/curve editing。 +- [ ] `F12-08` 完成 marker、preview range、playback 和 audio sync 状态。 +- [ ] `F12-09` 完成 driver variable/target/expression 安全 reader。 +- [ ] `F12-10` 只对白名单 driver expression 开放本地求值。 +- [ ] `F12-11` 完成 NLA track/strip/action/time mapping 只读求值。 +- [ ] `F12-12` 完成 Clip/Transition/Meta/Sound strip 逐类型编辑。 +- [ ] `F12-13` 完成 blend/repeat/reverse/animated time 逐参数 golden。 +- [ ] `F12-14` 完成 NLA Editor selection、move、trim 和 mute/solo。 +- [ ] `F12-15` 完成 animation GLB/USD 映射和 loss report。 + +## 17. F13 Armature、Pose、Constraint 与 Shape Key + +- [ ] `F13-01` 完成 Armature/Bone/EditBone/PoseBone 全字段 reader。 +- [ ] `F13-02` 完成 rest/pose/parent/connected/inherit scale 组合 golden。 +- [ ] `F13-03` 完成 edit bone add/remove/subdivide/extrude/parent transaction。 +- [ ] `F13-04` 完成 pose transform、clear、copy/paste 和 pose library transaction。 +- [ ] `F13-05` 生成全部 Object/Bone Constraint inventory。 +- [ ] `F13-06` 逐 constraint 读取参数、target、space 和 influence。 +- [ ] `F13-07` 逐 constraint 建立 desktop/WASM frame golden。 +- [ ] `F13-08` 逐 constraint 实现 add/remove/reorder/parameter transaction。 +- [ ] `F13-09` 完成 IK chain、pole、limits 和 dependency cycle。 +- [ ] `F13-10` 完成 vertex group weight、bind matrix 和 armature modifier。 +- [ ] `F13-11` 完成 Shape Key relative/absolute、value 和 slider 编辑。 +- [ ] `F13-12` 完成 Shape Key topology change 阻断或精确 remap。 +- [ ] `F13-13` 完成 skin/shape simplification 误差预算和稳定阻断。 +- [ ] `F13-14` 完成 Three.js skeleton/morph 和双视口像素门。 +- [ ] `F13-15` 完成 GLB skin/morph/animation desktop reimport 比较。 + +## 18. F14 Physics、Particles 与 Simulation Cache + +- [ ] `F14-01` 冻结 Rigid Body/World/Constraint inventory。 +- [ ] `F14-02` 冻结 Cloth/Collision/Soft Body inventory。 +- [ ] `F14-03` 冻结 Fluid Domain/Flow/Effector inventory。 +- [ ] `F14-04` 冻结 Dynamic Paint Canvas/Brush inventory。 +- [ ] `F14-05` 冻结 Particle/Hair/Force Field inventory。 +- [ ] `F14-06` 逐 family 完成 Main settings/dependency reader。 +- [ ] `F14-07` 逐 family 完成 settings edit/undo/save/reopen。 +- [ ] `F14-08` 逐 family 定义 local solver、desktop bake 或 server 分类。 +- [ ] `F14-09` 逐 family 定义 cache manifest 和 frame binary schema。 +- [ ] `F14-10` 完成 source/settings/build/frame/hash 绑定。 +- [ ] `F14-11` 完成 exact frame seek、range read 和 stale frame gate。 +- [ ] `F14-12` 完成 bake start/progress/cancel/commit 状态机。 +- [ ] `F14-13` 完成 cache LRU、quota、corruption 和 Worker restart。 +- [ ] `F14-14` 每 family 完成 100 帧 desktop/browser golden。 +- [ ] `F14-15` 每 family 完成 OOM、timeout、device loss 和 server fault 门。 + +## 19. F15 Camera、Lighting、Render 与 Output + +- [ ] `F15-01` 完成 Camera lens/sensor/shift/clip/DOF/panorama reader。 +- [ ] `F15-02` 完成 Point/Sun/Spot/Area light 全字段 reader。 +- [ ] `F15-03` 完成 World surface/color/strength/environment reader。 +- [ ] `F15-04` 完成 Scene render、film、format、color management reader。 +- [ ] `F15-05` 每个字段完成 Main edit/undo/save/reopen。 +- [ ] `F15-06` 完成 Three/WebGPU camera、light 和 shadow 映射。 +- [ ] `F15-07` 固定灯数、shadow atlas、probe 和 texture 预算。 +- [ ] `F15-08` 冻结 Workbench feature matrix 和 pixel golden。 +- [ ] `F15-09` 冻结 Eevee feature matrix 和 pixel golden。 +- [ ] `F15-10` 将 Cycles device/backend 明确分类为 server。 +- [ ] `F15-11` 完成 render job submit/progress/cancel/result hash。 +- [ ] `F15-12` 完成 Freestyle capability 和 server result binding。 +- [ ] `F15-13` 完成 Render Result/pass/layer metadata 和查看器。 +- [ ] `F15-14` 完成 image output format/color/alpha 能力矩阵。 +- [ ] `F15-15` 完成 device loss、OOM、timeout 和错误报告。 + +## 20. F16 Compositor + +- [ ] `F16-01` 生成全部 Compositor Node inventory。 +- [ ] `F16-02` 完成 graph/socket/link/default/resource reader。 +- [ ] `F16-03` 逐 node 建立 desktop input/output fixture。 +- [ ] `F16-04` 逐 node 实现 CPU 或 WebGPU executor。 +- [ ] `F16-05` 逐 node 实现 Main parameter/link transaction。 +- [ ] `F16-06` unsupported graph 保留并提交 server 或阻断。 +- [ ] `F16-07` 完成 Render Layer/Image/Movie Clip/Mask 资源绑定。 +- [ ] `F16-08` 完成 Viewer/Composite/File Output 目标边界。 +- [ ] `F16-09` 完成 tile、frame cache、LRU 和 revision key。 +- [ ] `F16-10` 完成 worker cancellation 和迟到 tile 丢弃。 +- [ ] `F16-11` 完成 HDR、alpha、color-space 像素 golden。 +- [ ] `F16-12` 完成大图、恶意图、cycle、OOM 和 device loss 门。 + +## 21. F17 Video Sequencer 与 Audio + +- [ ] `F17-01` 完成 Scene/Movie/Image/Sound/Effect/Meta strip reader。 +- [ ] `F17-02` 完成 channel/range/offset/speed/transform/crop reader。 +- [ ] `F17-03` 生成 effect、transition 和 modifier inventory。 +- [ ] `F17-04` 完成 add/remove/move/trim/split transaction。 +- [ ] `F17-05` 完成 meta group/ungroup 和 dependency cycle。 +- [ ] `F17-06` 逐 effect/transition 建立 frame golden。 +- [ ] `F17-07` 运行时探测 WebCodecs/HTMLMedia codec 能力。 +- [ ] `F17-08` 完成 proxy、waveform、thumbnail content-addressed cache。 +- [ ] `F17-09` 完成精确 seek、scrub、取消和 stale decode gate。 +- [ ] `F17-10` 完成 audio mix、mute/solo、volume/pan 和 A/V sync。 +- [ ] `F17-11` 完成 AudioContext suspend/resume 和无设备恢复。 +- [ ] `F17-12` 最终编码按 codec 分类 local 或 server。 +- [ ] `F17-13` 完成 1M frame timeline 和长媒体性能门。 +- [ ] `F17-14` 完成损坏媒体、路径沙箱、网络中断和 quota 门。 + +## 22. F18 Movie Tracking 与 Mask + +- [ ] `F18-01` 完成 MovieClip/Proxy/TrackingSettings reader。 +- [ ] `F18-02` 完成 Track/Marker/PlaneTrack/Object reader。 +- [ ] `F18-03` 完成 Mask/Layer/Spline/Point/Handle reader。 +- [ ] `F18-04` 完成 marker add/remove/move/track transaction。 +- [ ] `F18-05` 完成 mask point/handle/spline/layer transaction。 +- [ ] `F18-06` 完成 selection、marquee、lasso 和锁定过滤。 +- [ ] `F18-07` 本地 tracking 算法逐项 capability probe。 +- [ ] `F18-08` camera solve、stabilize 和 planar track 分类 local/server。 +- [ ] `F18-09` 完成 server solve submit/cancel/result hash。 +- [ ] `F18-10` 完成 Clip/Mask editor overlay 和 frame sync。 +- [ ] `F18-11` 完成 compositor/scene resource binding。 +- [ ] `F18-12` 完成 desktop solve/error golden、保存重开和媒体故障门。 + +## 23. F19 Asset、Library、Link 与 Override + +- [ ] `F19-01` 完成 Asset metadata/tag/catalog/preview reader。 +- [ ] `F19-02` 完成 catalog schema migration 和稳定 catalog ID。 +- [ ] `F19-03` 完成 content-addressed preview 生成、缓存和释放。 +- [ ] `F19-04` 完成 append 单 data-block Main transaction。 +- [ ] `F19-05` 完成 link read-only ownership 和 reload transaction。 +- [ ] `F19-06` 完成 relocate、missing library 和 path sandbox。 +- [ ] `F19-07` 完成 library dependency cycle 检测。 +- [ ] `F19-08` 完成 override create/resync/reset 操作矩阵。 +- [ ] `F19-09` 完成跨项目 stable ID 和引用失效规则。 +- [ ] `F19-10` 完成 Asset Browser search/filter/sort/drag context。 +- [ ] `F19-11` 完成 OPFS index rebuild 和损坏条目隔离。 +- [ ] `F19-12` 完成大 catalog、quota、Worker restart 和 malicious metadata 门。 + +## 24. F20 Import、Export 与交换格式 + +- [ ] `F20-01` 为 glTF/GLB 建立字段级 import/export 矩阵。 +- [ ] `F20-02` 为 OBJ/MTL 建立字段级 import/export 矩阵。 +- [ ] `F20-03` 为 STL 建立字段级 import/export 矩阵。 +- [ ] `F20-04` 为 PLY 建立字段级 import/export 矩阵。 +- [ ] `F20-05` 为 USD/USDZ 建立字段级 import/export 矩阵。 +- [ ] `F20-06` 为 Alembic 建立字段级 import/export 矩阵。 +- [ ] `F20-07` 为 FBX 和其他注册格式给出 local/server/excluded 分类。 +- [ ] `F20-08` 每种格式完成最小 import -> save -> reopen。 +- [ ] `F20-09` 每种格式完成 export -> desktop reimport。 +- [ ] `F20-10` 每种格式比较 hierarchy、geometry、material、animation。 +- [ ] `F20-11` 每种格式输出机器可读 warning/loss/block report。 +- [ ] `F20-12` 完成 external URI、path traversal 和 sandbox。 +- [ ] `F20-13` 完成 archive entry 数、压缩比、总字节和路径预算。 +- [ ] `F20-14` 完成大文件 streaming、取消、OOM 和临时文件清理。 +- [ ] `F20-15` 固定 desktop importer/exporter build identity。 + +## 25. F21 Editors、Workspace、Keymap 与交互 + +- [ ] `F21-01` 生成全部 SpaceType/Region/Mode inventory。 +- [ ] `F21-02` 完成 View3D/Outliner/Properties 共享 context store。 +- [ ] `F21-03` 完成 UV/Image Editor 只读面，再逐 writer 开放编辑。 +- [ ] `F21-04` 完成 Shader/Geometry/Compositor Node Editor 共用 graph 基础层。 +- [ ] `F21-05` 完成 Dope Sheet/Graph/NLA/Timeline 共用 animation context。 +- [ ] `F21-06` 完成 Spreadsheet 几何和属性分页读取。 +- [ ] `F21-07` 完成 Text/Console 的只读与默认拒绝边界。 +- [ ] `F21-08` 完成 workspace/area/region split/join/layout persistence。 +- [ ] `F21-09` workspace 保存不得改变 Blender scene revision。 +- [ ] `F21-10` operator search 只从 capability registry 生成。 +- [ ] `F21-11` keymap 按 editor/modal/tool context 确定性解析。 +- [ ] `F21-12` 完成 menu/context menu/popup/modal/Escape 规则。 +- [ ] `F21-13` 完成鼠标、触控、笔、HiDPI、IME 和非 US 键盘 fixture。 +- [ ] `F21-14` 完成键盘全路径、焦点、ARIA 和对比度门。 +- [ ] `F21-15` editor dispose 后零 DOM listener、Worker request 和 GPU 泄漏。 + +## 26. F22 Python、Extension 与安全执行边界 + +- [ ] `F22-01` 保持 Python/Text autorun/driver/add-on 默认拒绝。 +- [ ] `F22-02` 完成 script/add-on manifest 只读解析和大小预算。 +- [ ] `F22-03` 定义签名者、权限、撤销、版本和审计模型。 +- [ ] `F22-04` 定义浏览器 sandbox 的 DOM/network/OPFS/Worker 权限。 +- [ ] `F22-05` 完成 CPU、内存、时间和输出预算。 +- [ ] `F22-06` 完成 requestId replay、审计 hash chain 和篡改拒绝。 +- [ ] `F22-07` server Blender job 使用一次性目录和只读源。 +- [ ] `F22-08` server job 固定网络策略、资源限制和超时。 +- [ ] `F22-09` server result 绑定 source/settings/build/output hash。 +- [ ] `F22-10` 完成恶意脚本、依赖混淆和逃逸 fixture。 +- [ ] `F22-11` 完成 CSP：禁止 inline script、eval 和未声明 origin。 +- [ ] `F22-12` 完成 extension install/update/remove 的签名和回滚策略。 + +## 27. F23 平台、偏好、国际化与跨浏览器 + +- [ ] `F23-01` 冻结 Chromium single/pthread 平台能力报告。 +- [ ] `F23-02` 完成 Firefox OPFS/WebGL2/WebGPU/Worker/isolation probe。 +- [ ] `F23-03` 完成 Firefox P0 主线程路径。 +- [ ] `F23-04` 完成 Firefox Offscreen 路径。 +- [ ] `F23-05` 完成 WebKit OPFS/WebGL2/WebGPU/Worker/isolation probe。 +- [ ] `F23-06` 完成 WebKit P0 主线程路径。 +- [ ] `F23-07` 完成 WebKit Offscreen 路径。 +- [ ] `F23-08` 按浏览器/设备档位固定内存和 GPU 预算。 +- [ ] `F23-09` 完成 user preferences schema、migration 和项目无关 persistence。 +- [ ] `F23-10` 完成 locale 切换、数字/日期格式和翻译 fallback。 +- [ ] `F23-11` 完成 theme、font scale、reduced motion 和高对比偏好。 +- [ ] `F23-12` native window/file watcher/CUDA/Metal/HIP/OptiX 明确 EXCLUDED。 +- [ ] `F23-13` 每个新增浏览器加入 quick/P0/full 三层 CI。 +- [ ] `F23-14` 1280x720、1440x900、4K 和窄屏无重叠截图门。 + +## 28. F24 性能、故障、安全、交付与全域审计 + +- [ ] `F24-01` 固定 100k/1M/10M geometry 基准环境和预算。 +- [ ] `F24-02` 固定 4K/8K/UDIM texture 基准环境和预算。 +- [ ] `F24-03` 固定 100/1000/1M frame animation/media 基准。 +- [ ] `F24-04` 固定 simulation/volume cache 容量和 seek 基准。 +- [ ] `F24-05` 覆盖 WASM/Main、OPFS、GPU、VDB 四类 OOM。 +- [ ] `F24-06` 覆盖 Worker crash、device loss、network interruption、quota。 +- [ ] `F24-07` 覆盖 blend/image/font/media/archive/node/script fuzz corpus。 +- [ ] `F24-08` fuzz crash 修复后自动固化为最小回归 fixture。 +- [ ] `F24-09` quick lane 执行 type/lint/unit/status/schema。 +- [ ] `F24-10` Chromium lane 执行 P0、双视口和 fault smoke。 +- [ ] `F24-11` release lane 执行 full E2E、性能、VDB、acceptance、offline。 +- [ ] `F24-12` CI 报告绑定 commit、lockfile、inventory、ledger、engine、archive hash。 +- [ ] `F24-13` binary/source archive 在两个空临时目录独立复验。 +- [ ] `F24-14` 完成 SBOM、license、source offer 和供应链审计。 +- [ ] `F24-15` 每个 parity ID 都有 LOCAL 正例、SERVER 闭环或 EXCLUDED 保真证据。 +- [ ] `F24-16` inventory 未分类、隐式 loss、proxy-success 三项计数均为 0。 +- [ ] `F24-17` 独立机器复验全部构件和关键证据 hash。 +- [ ] `F24-18` 发布说明逐项列出支持、受限、server 和 excluded 能力。 + +里程碑 F24：不能由聚合 release gate 反推 family 完成。只有 inventory 的每个单项都达到自身 +退出条件，N-015 至 N-026 才能逐项从 `BLOCKED` 改为 `COMPLETE`。 + +## 29. 当前领取点 + +截至 2026-08-15，M6 已完成 35/71：single/pthread 选择与回退、真实 HTTP MIME/range、 +releaseId/hash 升级负例和缓存合同均有专项证据。HTML、manifest、stable engine 未变化时均返回 +`304`，换代后均返回 `200` 且 ETag 变化；production build 的 1 个入口 JS、1 个 CSS、3 个 +Worker 均使用 8 位内容 hash 文件名并返回 `immutable`。当前唯一下一任务为 `M6-09A`：从 +binary archive 解包后使用合同服务器启动，不读取工作区文件。 diff --git a/docs/CURRENT_EXECUTION_PLAN.md b/docs/CURRENT_EXECUTION_PLAN.md index c155ec27..7946fb1e 100644 --- a/docs/CURRENT_EXECUTION_PLAN.md +++ b/docs/CURRENT_EXECUTION_PLAN.md @@ -1,6 +1,6 @@ # Web Blender V1 当前执行计划 -更新时间：2026-08-14 +更新时间：2026-08-15 ## 1. 交付目标 @@ -110,21 +110,25 @@ React 工作区和编辑器 | 交付 | 离线 binary/source archive、SBOM、SHA-256 可复现 | 正式部署模板、持续发布流水线、跨机器复验待做 | 本地 V1 RC 已收口 | 2026-08-15 重新执行 `typecheck`、`lint`、14 个 Node tests、status consistency、release -evidence checker 和 `git diff --check`，均退出 0。acceptance runner 解析 12 个 family 的 -50 条声明，去重为 49 条命令并全部通过，命令总耗时 454,106 ms；清单 SHA-256 为 -`74c01764987c3dce0601a20cdf494f8076102f6d54262a1d13df953abee96160`。官方 Blender 5.2.0 +evidence checker 和 `git diff --check`，均退出 0。M6-03 后 acceptance runner 再次解析 12 个 +family 的 50 条声明，去重为 49 条命令并全部通过，命令总耗时 480,169 ms；清单 SHA-256 为 +`d5fb0a7b2df92b076f8b05ccd68903d60e3352b9423b0c1404065f6cbcbdd45c`。官方 Blender 5.2.0 Linux archive SHA-256 为 `96f6c181a30f4950607839dc84d42a354b250d8a0231b098b59b7bc69c351c48`， 运行时 `USD=True`，desktop USD roundtrip 已通过。 -最终 release evidence 生成时间为 `2026-08-15T04:43:09.832Z`，17 条 record 均为 exit code 0、 -非空输出和非空构件 hash，总命令耗时 553,427 ms。`v1-user-loop` record 已绑定上述 acceptance +第一次重跑误用了本地 `USD=False` Blender，结果为 48/49；该失败证据未标 READY。修正为上述 +官方 runtime 后完整重跑 49 条，而不是手改失败记录。当前 release evidence 生成时间为 +`2026-08-15T05:37:25.215Z`，17 条 record 均为 exit code 0、非空输出和非空构件 hash， +总命令耗时 553,577 ms。`v1-user-loop` record 已绑定上述 acceptance 清单 hash。 ### 4.4 当前阻断与决策顺序 -1. `P0`：V1 本地 RC 已无阻断；下一领取点为 `M6-01` 部署响应头合同。 -2. `P1`：当前离线包已在本机连续两次可复现，还缺独立目录/独立机器复验和真实 HTTP 部署门。 -3. `P1`：pthread/single-thread 的生产选择、隔离头、fallback 和缓存升级合同尚未形成发布证据。 +1. `P0`：V1 可部署 RC 已完成 M6 71/71；M7 已完成 7/18，下一领取点为 `M7-08` Worker 崩溃恢复。 +2. `P1`：binary/source archive 已在独立目录复验，quick/Chromium/release 三条 + CI lane 与 RC manifest 已联合校验；发布/限制/恢复和运维合同均已进入离线包。 +3. `P1`：pthread/single-thread、真实 HTTP、缓存升级、归档离线、OPFS 断网和空目录 + deploy/upgrade/rollback 均已有可复验证据；M7 开始核心项目体验硬化。 4. `P2`：完整 Blender 功能域继续受 VDB demand paging、PBVH、Geometry Nodes evaluator、 通用 Shader、完整编辑器/渲染/媒体和安全脚本边界阻断。 @@ -146,9 +150,19 @@ loss、恶意 blend、zip bomb、离线包和 V1 用户闭环均已在最终 M5 | M3 long media | 长时间线索引、seek、取消与重启证据 | 已完成，持续回归 | `performance.longMedia=true` | | M4 OOM | 四类确定性内存故障与恢复证据 | 已完成，持续回归 | `faults.oom=true` | | M5 V1 RC | 可复现离线候选包、SBOM、校验和 | 已完成，持续回归 | release gate `READY`、49/49 acceptance | +| M6 可部署 RC | 双 WASM 运行时选择、真实 HTTP、离线包、CI、运维合同 | 已完成，71/71 | single/pthread 可解释，真实部署与归档 P0 通过 | +| M7 核心体验硬化 | 项目状态机、恢复、存储、输入和可访问性 | 进行中，7/18 | 30 分钟编辑/保存/重开 soak 通过 | +| M8 VDB 自动分页 | GPU 缺页反馈、range/OPFS、LRU、双视口恢复 | 未开始 | 64 MiB sparse bundle 与三视角 golden 通过 | +| M9 非 Mesh/GP/Paint | 字体、Curve、Grease Pencil、Paint 增量闭环 | 未开始 | 每个新增 writer 独立通过 Main/undo/save/golden | +| M10 GN/Shader/NLA/Simulation | 白名单求值、cache、编译与阻断 | 未开始 | 四域分别通过 desktop/WASM/fault 门 | +| M11 Render/Compositor/Media | 灯光、渲染、合成、媒体执行边界 | 未开始 | 本地白名单与 server 边界均可审计 | +| M12 Asset/IO/Editors | 资产、格式、编辑器和上下文工作流 | 未开始 | 每个格式/editor 有独立 round-trip 或稳定阻断 | +| M13 Scripting/Security | 脚本默认拒绝、服务端隔离、CSP、供应链 | 未开始 | 恶意输入矩阵和 release 安全门通过 | +| M14 跨浏览器/设备 | Firefox、WebKit、触控、笔、HiDPI、IME | 未开始 | 新浏览器进入 quick/P0/full CI 后才声明支持 | +| M15 全域审计 | Blender 5.2 全域差距和下一发布 | 未开始 | 逐 family 审计，不由聚合 release gate 反推完成 | -任务严格按 M1 -> M2 -> M3 -> M4 -> M5 领取。里程碑内部允许先写纯校验任务，但不得在 -前一里程碑失败时把后一里程碑标为完成。 +M0 至 M5 已完成并转入持续回归；当前严格领取 M6。里程碑内部允许先写纯校验任务，但不得在 +前一小里程碑失败时把后一小里程碑标为完成，M7 至 M15 不得绕过 M6 发布合同扩功能。 ## 6. M0 范围、状态和 P0 闭环 @@ -448,9 +462,9 @@ M5 按 `PREP -> STATIC -> ACCEPT -> LOOP -> PERF -> FAULT -> VDB -> PACKAGE -> A - [x] `M5-ACCEPT-19` 使用 SHA-256 校验的官方 USD-enabled Blender 5.2 重跑 desktop USD roundtrip；归档 hash 和 executable hash 均写入 acceptance evidence。 - [x] `M5-ACCEPT-20` 运行完整 acceptance runner：50 declarations、49 unique、49 passed、 - 0 failed，总命令耗时 454,106 ms。 + 0 failed；M6-03 后复验总命令耗时 480,169 ms。 - [x] `M5-ACCEPT-21` 将 acceptance evidence SHA-256 - `74c01764987c3dce0601a20cdf494f8076102f6d54262a1d13df953abee96160` 绑定到最终 + `d5fb0a7b2df92b076f8b05ccd68903d60e3352b9423b0c1404065f6cbcbdd45c` 绑定到最终 `v1-user-loop` release record。 ### M5.3 P0 用户闭环和 Chromium 回归 @@ -525,7 +539,7 @@ M5 按 `PREP -> STATIC -> ACCEPT -> LOOP -> PERF -> FAULT -> VDB -> PACKAGE -> A - [x] `M5-AUDIT-03` 确认 12 个 family 仍为 `parityStatus=BLOCKED`。 - [x] `M5-AUDIT-04` 确认 12 个 V1 required slice 均为 `releaseStatus=READY`。 - [x] `M5-AUDIT-05` 运行完整 `release:evidence`，用本轮命令输出和构件 hash 替换旧 records； - 当前生成时间 `2026-08-15T04:43:09.832Z`，17 条 record，总命令耗时 553,427 ms。 + 当前生成时间 `2026-08-15T05:37:25.215Z`，17 条 record，总命令耗时 553,577 ms。 - [x] `M5-AUDIT-06` 检查 17 条 evidence record 均为 exit code 0、非空输出和非空构件 hash。 - [x] `M5-AUDIT-07` 检查 evidence 的 ledger SHA-256 与当前文件完全一致。 - [x] `M5-AUDIT-08` 运行 `test:release-evidence`，结果 `READY`、`missing=[]`。 @@ -541,7 +555,7 @@ SBOM、状态和 evidence SHA-256 相互一致。 M5 最终 archive SHA-256：binary `f2903a75026a0a28615aeb5f4834a3859af83022c82bc50e28437dcbed68e549`；source -`9a9c1b505c68a618de842be7c248f628b104b11b80e8a40d111f62540fcba327`。下一任务：`M6-01`。 +`9a9c1b505c68a618de842be7c248f628b104b11b80e8a40d111f62540fcba327`。当前下一任务：`M7-08`。 ## 12. V1 后原子里程碑 @@ -551,40 +565,157 @@ M5 最终 archive SHA-256：binary ### M6 可部署 RC +M6 固定按 `runtime -> HTTP -> cache/offline -> archive -> CI -> operations` 串行推进。每个 +任务只验证一个行为；上一小里程碑未通过时，不把后一小里程碑的准备工作记为完成。 + +#### M6.1 single-thread 无隔离启动 + - [x] `M6-01` 新建机器可读部署合同，固定 MIME、缓存、COOP、COEP、CORP 和 Range 响应头； `node tools/web/check-deployment-contract.mjs`、typecheck、lint 和 production build 通过。 - [x] `M6-02` 复用 `CapabilityGateResult` 新增纯函数 `gateWasmThreadingCapability`；仅当 `crossOriginIsolated`、`SharedArrayBuffer` 和 `Worker` 同时可用时放行 pthread 引擎， 缺失项逐条返回稳定结构，single-thread 初始化路径不调用该门。 -- [ ] `M6-03` 验证 single-thread 引擎在无隔离环境启动。 -- [ ] `M6-04` 验证 pthread 引擎只在隔离和 SharedArrayBuffer 可用时启动。 -- [ ] `M6-05` 验证 pthread 初始化失败回退 single-thread，且不重复打开项目。 -- [ ] `M6-06` 为 engine JS/WASM、Worker、CSS 和 fixture 固定正确 MIME。 -- [ ] `M6-07` 为 WASM 与大资产验证 byte-range 206、`Content-Range` 和稳定 ETag。 -- [ ] `M6-08` 验证版本更新后旧 HTML 不加载新旧混合 hash 资源。 -- [ ] `M6-09` 验证完全断网冷启动离线包，不访问 CDN 或外部字体。 -- [ ] `M6-10` 验证断网重开 OPFS 项目、编辑、保存和 GLB 导出。 -- [ ] `M6-11` 在全新临时目录解包 binary archive 并运行 browser smoke。 -- [ ] `M6-12` 在全新临时目录解包 source archive 并核对 source offer/SBOM。 -- [ ] `M6-13` 建立 CI quick lane：typecheck、lint、unit、status、evidence schema。 -- [ ] `M6-14` 建立 CI Chromium lane：P0 用户闭环、双视口和 fault smoke。 -- [ ] `M6-15` 建立 CI release lane：全 E2E、性能、离线复现和 acceptance evidence。 -- [ ] `M6-16` 所有 CI lane 输出机器可读 JSON 和构件 SHA-256。 -- [ ] `M6-17` 写部署/升级/回滚 runbook，命令在空目录实测。 -- [ ] `M6-18` 生成 RC 版本号、变更说明、已知限制和恢复说明。 +- [x] `M6-03A` 增加仅供测试使用的无隔离 Vite profile；默认 dev/preview 仍强制部署合同头。 +- [x] `M6-03B` 在独立 Chromium context 断言文档响应没有 COOP/COEP/CORP，且 + `crossOriginIsolated=false`、`SharedArrayBuffer` 不可用、`Worker` 可用。 +- [x] `M6-03C` 断言当前 engine manifest 为 `memory.shared=false`，网络请求不包含 pthread + JS/WASM/worker 资产。 +- [x] `M6-03D` 在上述环境等待 single-thread WebEngine 返回 `ready`，同时证明 pthread gate + 为 `BLOCKED`，从行为上保证 single-thread 不受该门阻断。 +- [x] `M6-03E` 使用真实 `basic_scene.blend` 完成 open 和一个 Main edit，证明不是只加载 UI shell。 + +M6.1 退出条件：专项命令一次启动独立无隔离服务器，以上五项同进程通过，退出码为 0。 + +#### M6.2 pthread 选择与回退 + +- [x] `M6-04A` 扩展 engine manifest schema，显式声明 single/pthread variant、JS、WASM、 + pthread worker、shared memory 和每个文件 SHA-256；v2 纯校验器固定 256 至 32768 pages、 + variant 资源隔离和稳定错误路径，21 个专项正负例断言通过。生产 manifest/安装路径保持 v1， + 无隔离 single-thread 专项回归通过。 +- [x] `M6-04B` 安装脚本从两个独立构建目录复制 variant 资产到显式 single/pthread URL， + 生成绑定四个物理文件 SHA-256 的生产 schema v2 manifest；同目录和缺失资产负例不会改写目标， + Node 专项、manifest/local dependency、build 和无隔离 Chromium 回归通过。旧 single Worker 入口 + 只作为 `M6-05` fallback 接线前的完整 Main 兼容路径保留。 +- [x] `M6-04C` 新增纯函数选择 engine variant；输入仅为 manifest、用户策略和平台能力， + frozen input 重复调用结果一致，未知策略稳定拒绝。 +- [x] `M6-04D` `AUTO` 在完整 pthread gate `READY` 时选择 pthread；隔离、SharedArrayBuffer 或 + Worker 任一缺失时选择 single，五组能力矩阵通过。 +- [x] `M6-04E` `PTHREAD_REQUIRED` 在任一能力缺失时返回 `selectedVariant=null` 和原样 M6-02 + 结构，不向调用方暴露可请求的 pthread URL。 +- [x] `M6-04F` 隔离 Chromium 实际加载 pthread JS/WASM，校验 manifest hash、 + `SharedArrayBuffer`、pool worker 二次 JS 请求和 native handle 创建/释放。 +- [x] `M6-04G` 同一 manifest 在无隔离 Chromium 由 AUTO 实际加载 single JS/WASM，确认非共享 + 内存、无 pthread 请求，并继续用完整 single Main 打开和编辑真实 `.blend`。 +- [x] `M6-05A` 为 pthread factory 增加仅测试可用的确定性初始化失败注入点。 +- [x] `M6-05B` `AUTO` 下 pthread 初始化失败只回退一次 single，不形成重试循环。 +- [x] `M6-05C` fallback 前终止已创建的 pthread worker、timer 和 pending request。 +- [x] `M6-05D` fallback 过程中未打开项目时只初始化；已有待打开项目时只执行一次 open。 +- [x] `M6-05E` fallback 结果公开 selected/attempted/fallbackReason，UI 不显示 pthread READY。 + +M6.2 退出条件：isolated pthread、unisolated single、forced failure fallback 三个专项测试均通过， +每种路径的资产请求、Worker 数和 open 次数可断言。 + +#### M6.3 HTTP MIME 与 byte range + +- [x] `M6-06A` 从 deployment contract 生成测试用扩展名到 MIME 的唯一映射，不复制常量。 +- [x] `M6-06B` 对 HTML、JS、CSS、WASM、JSON、PNG、WAV、BLEND、NVDB 分别执行 GET。 +- [x] `M6-06C` 对 engine JS/WASM、pthread worker 和 fixture 分别执行 HEAD，断言状态与 + `Content-Type`，且 HEAD 无响应体。 +- [x] `M6-06D` MIME 错误时测试必须报告 URL、expected、actual，不能只返回布尔失败。 +- [x] `M6-07A` 对 WASM、BLEND、NVDB 各执行一个闭区间 range，断言 `206` 和精确字节。 +- [x] `M6-07B` 分别验证 open-ended 与 suffix range；若合同不支持则稳定返回 `416`。 +- [x] `M6-07C` malformed、倒序、越界和 multi-range 分别返回 `416`，不得返回截断的 `200`。 +- [x] `M6-07D` `206` 同时具有 `Accept-Ranges`、`Content-Range`、`Content-Length` 和强 ETag。 +- [x] `M6-07E` 相同内容跨请求 ETag 稳定；内容变化后 ETag 必须变化。 +- [x] `M6-07F` `If-Range` 匹配时返回对应 `206`，不匹配时返回完整 `200`。 +- [x] `M6-07G` 中断后从精确 offset 续传并校验合并后的 SHA-256，不复用旧 revision 字节。 + +M6.3 退出条件：同一真实 HTTP server 同时通过 MIME 和 range 正负例矩阵。 + +#### M6.4 缓存、升级与离线运行 + +- [x] `M6-08A` HTML 和 engine manifest 固定 `no-cache`，每次启动都能重新验证版本。 +- [x] `M6-08B` content-hashed JS/CSS/Worker 固定 immutable；稳定 engine URL 必须重新验证 hash。 +- [x] `M6-08C` manifest 为每个 variant 绑定同一 releaseId，禁止跨 release 混用 JS/WASM/worker。 +- [x] `M6-08D` 模拟发布切换：旧 HTML 只加载旧 manifest 全套或明确刷新，不加载混合版本。 +- [x] `M6-08E` hash 不匹配时保持旧项目未打开并返回稳定错误，不进入 fallback 的错误 variant。 + +`npm --prefix web run test:deployment-cache` 从 production build 临时副本启动合同服务器：`/`、 +`/index.html`、manifest 和 4 个 stable engine 资源均为 `no-cache`；实际构建的入口 JS、CSS 和 +3 个 Worker 共 5 项均具有 Vite 内容 hash 且为 immutable。HTML、manifest、stable engine 对相同 +ETag 返回无 body `304`，换代后对旧 ETag 返回完整 `200` 和新 ETag，临时换代不改写 `web/dist`。 +- [x] `M6-09A` 从 binary archive 解包后使用合同服务器启动，不读取工作区文件。 +- [x] `M6-09B` 新浏览器 profile 冷启动时拦截所有非 loopback 请求，断言请求数为 0。 +- [x] `M6-09C` 断开外网但保留本地合同服务器，完成 manifest、WASM、字体和基础 UI 冷启动。 +- [x] `M6-10A` 在线创建 OPFS 项目、编辑并原子保存，记录 revision、blend hash 和 stable IDs。 +- [x] `M6-10B` 重建 Worker 并切换到外网断开状态，从 OPFS 重开同一 revision。 +- [x] `M6-10C` 离线重开后继续 Main edit、undo/redo 和保存，revision 单调增加。 +- [x] `M6-10D` 离线导出 GLB 并严格回读，且无非 loopback 请求。 + +M6.4 退出条件：版本切换负例、archive 冷启动和 OPFS 离线闭环分别有独立命令与报告。 + +#### M6.5 归档独立复验 + +- [x] `M6-11A` 使用 `mktemp -d` 解包 binary archive，禁止引用仓库 `web/dist`。 +- [x] `M6-11B` 校验 `SHA256SUMS.txt`、deployment contract、license、SBOM 和 binary manifest。 +- [x] `M6-11C` 从临时目录启动合同服务器并运行 browser smoke，退出后释放端口和临时 profile。 +- [x] `M6-12A` 在另一个空临时目录解包 corresponding source archive。 +- [x] `M6-12B` 校验 source offer 指向的版本、许可证、lockfile、CMake 与 Web 源码全部存在。 +- [x] `M6-12C` 扫描 source archive，拒绝 build、dist、release、cache、trace、绝对开发路径和凭据。 +- [x] `M6-12D` 从 source archive 执行 lockfile install、typecheck、build，并比对可重现清单。 + +M6.5 退出条件：binary/source 两个归档均在独立目录复验，报告包含 archive 与关键文件 SHA-256。 + +#### M6.6 CI 分层与机器报告 + +- [x] `M6-13A` 确定仓库实际 CI provider、runner OS、Node/Chrome/Blender/Emscripten 版本矩阵。 +- [x] `M6-13B` quick lane 从 lockfile 安装，执行 typecheck、lint、unit、status 和 evidence schema。 +- [x] `M6-13C` quick lane 缓存只以 lockfile/toolchain key 命中，不缓存 release evidence。 +- [x] `M6-14A` Chromium lane 执行 P0 user loop 和主线程/Offscreen 双视口 smoke。 +- [x] `M6-14B` Chromium lane 执行 network、device-loss、OOM、quota 与 malicious-input fault smoke。 +- [x] `M6-14C` Chromium lane 每个 browser server 使用独立动态端口，失败后也必须清理。 +- [x] `M6-15A` release lane 顺序执行全 E2E、性能矩阵、VDB、acceptance 和离线复现。 +- [x] `M6-15B` release lane 只在受保护 ref 或显式 dispatch 运行，不由普通 quick push 重复触发。 +- [x] `M6-15C` 任一 release 子命令失败时证据状态为失败，不能上传旧 READY JSON。 +- [x] `M6-16A` 三条 lane 均输出 schema-versioned JSON：命令、exitCode、duration、environment。 +- [x] `M6-16B` 报告绑定 commit、lockfile、ledger、engine、archive 和测试构件 SHA-256。 +- [x] `M6-16C` 上传前运行 schema 与 hash checker；报告和构件采用固定 retention。 + +2026-08-15 完整 release lane 的 19/19 子命令通过，总命令耗时 +1,245,732 ms；full E2E 126/126，V1 acceptance 49/49。quick 6/6、Chromium 9/9 和 +release 19/19 报告由 `check-ci-report.mjs` 联合校验，同时绑定 commit +`17ab961485fe2ea1574c5f0b7d3ef9608a2bf424`。失败注入返回 exit code 17 并仅写入 +`FAILED` 报告。当前 binary/source archive SHA-256 分别为 +`ca09540e8f5c0157bb85d62c98aeb3291ea195a29585bc8e05afb308747a8ff5` 和 +`95b3a747425081a205b1966c004a08da4cb37aab7ba0a649ff076713f7010f74`。 + +M6.6 退出条件：fresh runner 上 quick/Chromium/release 三条 lane 通过，失败注入不会保留成功证据。 + +#### M6.7 运维与 RC 冻结 + +- [x] `M6-17A` 部署 runbook 从空目录安装 binary archive，并验证 HTTPS/loopback 前置条件。 +- [x] `M6-17B` 升级 runbook 覆盖新旧 manifest、cache、OPFS schema 和 Worker 版本切换。 +- [x] `M6-17C` 回滚 runbook 保留项目数据，只回滚 app/engine releaseId，并验证旧版可读策略。 +- [x] `M6-17D` 故障诊断表覆盖 MIME、range、isolation、hash、quota、Worker 和 GPU 错误。 +- [x] `M6-17E` 在一个全新临时目录逐条实跑部署、升级、回滚命令并记录输出。 +- [x] `M6-18A` 固定 RC semver、commit、releaseId、binary/source/SBOM SHA-256。 +- [x] `M6-18B` 变更说明只列已验证 V1 能力，并链接明确 excluded/server/blocked 清单。 +- [x] `M6-18C` 已知限制包含 Chromium-only、single/pthread 选择、存储和 GPU 预算。 +- [x] `M6-18D` 发布恢复说明包含项目备份、升级失败回滚和证据校验命令。 +- [x] `M6-18E` 最终运行 quick、Chromium、release lane，所有结果绑定同一 RC commit。 M6 退出条件：离线包和一个真实 HTTP 部署均通过同一 P0 流程；single/pthread 选择可解释； CI 可从 lockfile 和对应源码重现当前 binary/source hash。 ### M7 核心项目体验硬化 -- [ ] `M7-01` 记录 import/open/save/save-as/export 五个用户动作的状态机。 -- [ ] `M7-02` 对重复 open、并发 save 和 close-during-save 建立互斥规则。 -- [ ] `M7-03` 大文件导入显示真实字节进度并支持取消。 -- [ ] `M7-04` 取消 import 后释放 input buffer、native handle 和 staging 文件。 -- [ ] `M7-05` save 中断时旧 revision 和旧 hash 保持不变。 -- [ ] `M7-06` dirty state 只由成功 Main transaction 改变。 -- [ ] `M7-07` undo 回到保存 revision 时 dirty state 清除。 +- [x] `M7-01` 记录 import/open/save/save-as/export 五个用户动作的状态机。 +- [x] `M7-02` 对重复 open、并发 save 和 close-during-save 建立互斥规则。 +- [x] `M7-03` 大文件导入显示真实字节进度并支持取消。 +- [x] `M7-04` 取消 import 后释放 input buffer、native handle 和 staging 文件。 +- [x] `M7-05` save 中断时旧 revision 和旧 hash 保持不变。 +- [x] `M7-06` dirty state 只由成功 Main transaction 改变。 +- [x] `M7-07` undo 回到保存 revision 时 dirty state 清除。 - [ ] `M7-08` Worker 崩溃时展示可恢复错误，不清空当前项目列表。 - [ ] `M7-09` 重启 Worker 后恢复 selection、frame、workspace 和项目 revision。 - [ ] `M7-10` recent projects 对缺失/损坏 OPFS 条目执行隔离和修复提示。 diff --git a/docs/PROJECT_STATUS_AND_NEXT_WORK.md b/docs/PROJECT_STATUS_AND_NEXT_WORK.md index 67347cef..71620773 100644 --- a/docs/PROJECT_STATUS_AND_NEXT_WORK.md +++ b/docs/PROJECT_STATUS_AND_NEXT_WORK.md @@ -20,9 +20,24 @@ SQLite WASM 和 Bitbybit/OCCT 均不在当前依赖范围内。Three.js、WASM 运行时资源全部使用项目本地文件，不依赖 CDN。 `Web Blender Modeler V1` 的本地 RC 已收口：ledger 的 50 条 acceptance 声明去重为 49 条 -命令并全部通过，122/122 Chromium E2E 通过，17 条 release record 为 `READY` 且 0 missing。 +命令并全部通过，126/126 Chromium full E2E 通过，17 条 release record 为 `READY` 且 0 missing。 这不改变完整 Blender 5.2 对标结论：N-015 至 N-026 仍为 12/12 `parityStatus=BLOCKED`。 +### 1.1 2026-08-15 重新盘点快照 + +| 状态轴 | 已完成 | 尚未完成 | 判断 | +| --- | --- | --- | --- | +| V1 release family | 12/12 `READY` | 0 | V1 已声明功能闭环完成 | +| Blender 5.2 全域 parity | 0/12 complete | 12/12 `BLOCKED` | 不是完整 Blender Web 移植 | +| slice 台账 | 177 completed | 60 blocked | blocked 项均留在 M8-M15 长期路线 | +| acceptance | 50 declarations / 49 unique passed | 0 failed | 本地 V1 RC 证据完整 | +| M6 可部署 RC | 71/71 原子任务 | 0 | 可部署 RC 已冻结 | +| M7 核心体验硬化 | 7/18 原子任务 | 11 | 当前严格领取 M7 项目体验工作 | + +当前优先级不是扩 Blender 全域功能。single/pthread、真实 HTTP、缓存升级、离线闭环、 +独立归档复验、运维 runbook、RC 文档和最终三条 CI lane 均已通过；现在进入 M7 核心项目 +体验硬化。`M7-01` 至 `M7-07` 已通过，唯一下一任务为 `M7-08`。 + ## 2. 已完成并有测试覆盖的能力 | 能力 | 当前证据 | 状态 | @@ -222,16 +237,33 @@ demand paging、大 bundle 和发布 golden。 `docs/status/v1-acceptance-evidence.json` 逐条覆盖 12 个 family 的 50 条声明、49 个唯一命令， 结果为 49 passed、0 failed；其 SHA-256 -`74c01764987c3dce0601a20cdf494f8076102f6d54262a1d13df953abee96160` 已绑定到最终 +`d5fb0a7b2df92b076f8b05ccd68903d60e3352b9423b0c1404065f6cbcbdd45c` 已绑定到最终 `v1-user-loop` release record。desktop USD 使用经发布 SHA-256 校验的官方 Blender 5.2.0 LTS， -runtime `USD=True`。最终离线 binary/source archive SHA-256 分别为 -`f2903a75026a0a28615aeb5f4834a3859af83022c82bc50e28437dcbed68e549` 和 -`9a9c1b505c68a618de842be7c248f628b104b11b80e8a40d111f62540fcba327`。 +runtime `USD=True`。当前 M6 离线 binary/source archive SHA-256 分别为 +`ca09540e8f5c0157bb85d62c98aeb3291ea195a29585bc8e05afb308747a8ff5` 和 +`95b3a747425081a205b1966c004a08da4cb37aab7ba0a649ff076713f7010f74`。release lane 19/19 +子命令通过，总命令耗时 1,245,732 ms；quick/Chromium/release 报告联合校验同一 commit。 `M6-01` 已新增机器可读部署合同并让 Vite/离线包生成器复用该事实源。`M6-02` 已新增纯 -pthread 能力门：`crossOriginIsolated`、`SharedArrayBuffer` 和 `Worker` 任一缺失均返回稳定的 -`PLATFORM_CAPABILITY_UNAVAILABLE`，且 single-thread 初始化路径不调用该门。下一领取点是 -`CURRENT_EXECUTION_PLAN.md` 的 `M6-03`：验证 single-thread 引擎在无隔离环境启动。 +pthread 能力门。`M6-03A-E` 已在没有 COOP/COEP/CORP 的独立 Chromium server 验证 +`crossOriginIsolated=false`、`SharedArrayBuffer` 不可用且 pthread gate `BLOCKED` 时， +single-thread 引擎仍能加载真实 WASM、打开 `basic_scene.blend` 并执行 Main edit。`M6-04A` +已冻结 schema v2 和纯校验器：single/pthread 各自声明 JS、WASM、pthread worker、SHA-256 与 +16 MiB 至 2 GiB 页级内存边界。`M6-04B` 已从 `build_web-single` 和 `build_web-pthread` +安装显式 variant 资产，生产 manifest 已切换到 schema v2；安装专项覆盖逐字节复制、四项 hash、 +同目录和缺失资产不改写，且无隔离 single-thread 真实 Main 编辑回归通过。旧 single Worker 入口 +暂时保留到选择器接线。`M6-04C-G` 已完成纯选择、AUTO/required 能力矩阵和双环境实机： +隔离 Chromium 加载 pthread shared memory 与 pool worker；无隔离 Chromium 只加载显式 single +variant，并继续完成真实 Main 编辑。`M6-05A-E` 已验证确定性 pthread 失败只回退一次、完整清理 +且 pending project 只 open 一次。`M6-06A` 至 `M6-07G` 已由同一真实 HTTP server 一次通过 9 种 +MIME、4 个 HEAD、WASM/BLEND/NVDB range、6 类 `416`、强 ETag、If-Range 和断流续传/换代拒绝。 +`M6-08C-E` 已将生产双 variant manifest 绑定同一 `releaseId`：版本不一致只返回 +`REFRESH_REQUIRED` 且 initialize/open 均为 0；真实 Chromium 篡改 pthread WASM 后返回稳定 +`ENGINE_VARIANT_INTEGRITY_FAILED`，不请求 single、不 fallback、不 open。`M6-08A/B` 已用实际 +production build 验证 HTML/manifest/stable engine `no-cache`、5 个 hashed JS/CSS/Worker +`immutable`，以及未换代 `304`、换代后旧 ETag 得到完整 `200` 的重验证行为。M6 最终 +quick 7/7、Chromium 9/9、release 25/25 与 RC manifest 联合通过；M7 已完成 7/18， +下一领取点是 `M7-08`。 ## 6. 当前验收命令 @@ -244,6 +276,7 @@ node tools/web/run-web-engine-smoke.mjs npm --prefix web run typecheck npm --prefix web run lint npm --prefix web test +npm --prefix web run test:engine-manifest-v2 npm --prefix web run test:golden npm --prefix web run test:frame-evaluation npm --prefix web run test:pose-constraint-goldens @@ -276,6 +309,9 @@ BLENDER_BIN=/path/to/usd-enabled/blender \ npm --prefix web run test:v1-acceptance-evidence npm --prefix web run test:v1-acceptance-release-binding node tools/web/check-deployment-contract.mjs +npm --prefix web run test:deployment-http +npm --prefix web run test:deployment-cache +WEB_TEST_PORT=5202 npm --prefix web exec -- playwright test --config web/playwright.single-thread.config.ts WEB_TEST_PORT=5193 npm --prefix web run test:e2e # 5173 被占用时指定可用端口 WEB_TEST_PORT=5193 npm --prefix web run test:e2e -- -g "N-015|non-mesh" ``` diff --git a/docs/status/ci-lane-report.schema.json b/docs/status/ci-lane-report.schema.json new file mode 100644 index 00000000..ab3beb4f --- /dev/null +++ b/docs/status/ci-lane-report.schema.json @@ -0,0 +1,20 @@ +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "$id": "https://blender-web.local/schemas/ci-lane-report-v1.json", + "title": "Web Blender CI lane report", + "type": "object", + "required": ["schemaVersion", "lane", "status", "generatedAt", "commit", "environment", "bindings", "records", "retentionDays"], + "properties": { + "schemaVersion": { "const": 1 }, + "lane": { "enum": ["quick", "chromium", "release"] }, + "status": { "enum": ["READY", "FAILED"] }, + "generatedAt": { "type": "string", "format": "date-time" }, + "commit": { "type": "string", "pattern": "^[a-f0-9]{40}$" }, + "environment": { "type": "object" }, + "bindings": { "type": "object" }, + "records": { "type": "array", "minItems": 1 }, + "retentionDays": { "enum": [7, 14, 30] } + }, + "additionalProperties": false +} + diff --git a/docs/status/release-evidence.json b/docs/status/release-evidence.json index 38946f03..12ad4ac3 100644 --- a/docs/status/release-evidence.json +++ b/docs/status/release-evidence.json @@ -2,7 +2,7 @@ "schemaVersion": 4, "source": "docs/status/parity-ledger.json", "sourceSha256": "1e16518a25c6b6bed4ab7f605ea1ad5babe529f2842c858b20ae6daae30bd478", - "generatedAt": "2026-08-15T04:43:09.832Z", + "generatedAt": "2026-08-15T05:37:25.215Z", "families": [ { "id": "N-015", @@ -699,19 +699,6 @@ "379dcc11dc7de0dfec4745763bddf3cc415a5f5dbe48500fefae2f7508095bb5" ] }, - { - "id": "v1-user-loop", - "fields": [], - "command": "npm --prefix web run test:v1-user-loop && npm --prefix web run test:v1-acceptance-evidence", - "exitCode": 0, - "durationMs": 5366, - "output": "> blender-web-editor@0.1.0 test:v1-user-loop\n> playwright test --config playwright.config.ts tests/e2e/v1-user-loop.spec.ts\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/v1-user-loop.spec.ts:6:1 › completes the V1 import-edit-save-restart-reopen-GLB loop (2.7s)\n\n 1 passed (4.2s)\n\n> blender-web-editor@0.1.0 test:v1-acceptance-evidence\n> node ../tools/web/check-v1-acceptance-evidence.mjs\n\nv1-acceptance-evidence-ok families=12 declarations=50 unique=49 sha256=74c01764987c3dce0601a20cdf494f8076102f6d54262a1d13df953abee96160\n\n[WebServer] (node:2314858) Warning: The 'NO_COLOR' env is ignored due to the 'FORCE_COLOR' env being set.\n[WebServer] (Use `node --trace-warnings ...` to show where the warning was created)\n[WebServer] (node:2314870) Warning: The 'NO_COLOR' env is ignored due to the 'FORCE_COLOR' env being set.\n[WebServer] (Use `node --trace-warnings ...` to show where the warning was created)", - "artifactSha256": [ - "3defbaa426195254fcaefaddabf9b128002a94def03aa255513c33eaf4ac0926", - "5d87a9ea57bd7a1888f16a5f4306e1c6d3a1bdfcf832c9485fe8518aac528fd8", - "74c01764987c3dce0601a20cdf494f8076102f6d54262a1d13df953abee96160" - ] - }, { "id": "chromium", "fields": [ @@ -917,6 +904,19 @@ "9a9c1b505c68a618de842be7c248f628b104b11b80e8a40d111f62540fcba327", "288b0bb969e670b458059adf8897f87bafc76a87a479c8aa0a305905accf2de9" ] + }, + { + "id": "v1-user-loop", + "fields": [], + "command": "npm --prefix web run test:v1-user-loop && npm --prefix web run test:v1-acceptance-evidence", + "exitCode": 0, + "durationMs": 5516, + "output": "> blender-web-editor@0.1.0 test:v1-user-loop\n> playwright test --config playwright.config.ts tests/e2e/v1-user-loop.spec.ts\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/v1-user-loop.spec.ts:6:1 › completes the V1 import-edit-save-restart-reopen-GLB loop (2.8s)\n\n 1 passed (4.4s)\n\n> blender-web-editor@0.1.0 test:v1-acceptance-evidence\n> node ../tools/web/check-v1-acceptance-evidence.mjs\n\nv1-acceptance-evidence-ok families=12 declarations=50 unique=49 sha256=d5fb0a7b2df92b076f8b05ccd68903d60e3352b9423b0c1404065f6cbcbdd45c\n\n[WebServer] (node:2396656) Warning: The 'NO_COLOR' env is ignored due to the 'FORCE_COLOR' env being set.\n[WebServer] (Use `node --trace-warnings ...` to show where the warning was created)\n[WebServer] (node:2396668) Warning: The 'NO_COLOR' env is ignored due to the 'FORCE_COLOR' env being set.\n[WebServer] (Use `node --trace-warnings ...` to show where the warning was created)", + "artifactSha256": [ + "3defbaa426195254fcaefaddabf9b128002a94def03aa255513c33eaf4ac0926", + "5d87a9ea57bd7a1888f16a5f4306e1c6d3a1bdfcf832c9485fe8518aac528fd8", + "d5fb0a7b2df92b076f8b05ccd68903d60e3352b9423b0c1404065f6cbcbdd45c" + ] } ] } diff --git a/docs/status/v1-acceptance-evidence.json b/docs/status/v1-acceptance-evidence.json index af6f1592..80736e50 100644 --- a/docs/status/v1-acceptance-evidence.json +++ b/docs/status/v1-acceptance-evidence.json @@ -3,14 +3,14 @@ "source": "docs/status/parity-ledger.json", "sourceSha256": "1e16518a25c6b6bed4ab7f605ea1ad5babe529f2842c858b20ae6daae30bd478", "package": "web/package.json", - "packageSha256": "4259c8c085fe94f5b109416230482d0791e6d9b47559546be42415bb91a4c224", + "packageSha256": "a7ee993997c8d62effcdd3bb994f16656424e6a5e976c3d3b4e2951bd4109710", "toolSourceSha256": { "tools/web/v1-acceptance-lib.mjs": "48005c8fc9d97955513e104ee1b8950cab2c3520c166eff4358e10bd7318f535", - "tools/web/check-v1-acceptance-coverage.mjs": "6448fcc673fde091cff4a299d77889570d3104bd0cfabe5434f45ba0b46de432", - "tools/web/run-v1-acceptance.mjs": "f12d04f7d74450f1973eb88aa58355a225019c6b9906aedc746c005a1958f1a5", + "tools/web/check-v1-acceptance-coverage.mjs": "42b713f9b622851328266584e3a8ba2231e0393141ba4a8ae091a97337d9e03e", + "tools/web/run-v1-acceptance.mjs": "7e87893e42c6c848c2bc487340712ba4ec151e63e49b2bbc76e6a0c51d839da3", "tools/web/check-v1-acceptance-evidence.mjs": "af1a3029a1148e8e5d346d66f3a58f7063b73fee8dd95e6e41ed0504ed56dfea" }, - "generatedAt": "2026-08-15T04:33:26.940Z", + "generatedAt": "2026-08-15T13:31:45.207Z", "environment": { "node": "v20.19.2", "npm": "9.2.0", @@ -35,9 +35,9 @@ ], "command": "npm --prefix web run test:nonmesh-roundtrip", "exitCode": 0, - "durationMs": 1486, - "outputSha256": "f0f98be0be03fab64d04f9e7a3d696161dc3c9fb5729c09a41f34cc401e61822", - "output": "> blender-web-editor@0.1.0 test:nonmesh-roundtrip\n> node ../tools/web/check-nonmesh-roundtrip.mjs\n\nnonmesh-roundtrip-ok types=CURVE,SURFACE,FONT,METABALL,VOLUME multispline-create-delete-bulk-handle-cyclic-surface-2d-topology-font-links-volume-properties=passed undo-redo=passed save-reopen=passed\n\nweb-depsgraph-stage=runtime-init-begin\nweb-depsgraph-stage=runtime-init-end\nweb-depsgraph-stage=blend-read-end\nweb-depsgraph-stage=view-layer-sync-end\nweb-depsgraph-data scene=0xaf0538 master=0xa18618 nodetree=0 world=0 collections=0\nweb-depsgraph-stage=global-main-swap-end\nweb-depsgraph-stage=graph-new-end\nweb-depsgraph-stage=graph-build-end\nweb-depsgraph-stage=frame-change-end\nweb-depsgraph-stage=graph-free-end\nweb-depsgraph-stage=global-main-restore-end\nweb-depsgraph-stage=blend-free-end" + "durationMs": 1996, + "outputSha256": "828a1171ff5444aba7bddaa0f2f47e1004881e0595b856b23b1e4eb46aa09c01", + "output": "> blender-web-editor@0.1.0-rc.1 test:nonmesh-roundtrip\n> node ../tools/web/check-nonmesh-roundtrip.mjs\n\nnonmesh-roundtrip-ok types=CURVE,SURFACE,FONT,METABALL,VOLUME multispline-create-delete-bulk-handle-cyclic-surface-2d-topology-font-links-volume-properties=passed undo-redo=passed save-reopen=passed\n\nweb-depsgraph-stage=runtime-init-begin\nweb-depsgraph-stage=runtime-init-end\nweb-depsgraph-stage=blend-read-end\nweb-depsgraph-stage=view-layer-sync-end\nweb-depsgraph-data scene=0xaf0538 master=0xa18618 nodetree=0 world=0 collections=0\nweb-depsgraph-stage=global-main-swap-end\nweb-depsgraph-stage=graph-new-end\nweb-depsgraph-stage=graph-build-end\nweb-depsgraph-stage=frame-change-end\nweb-depsgraph-stage=graph-free-end\nweb-depsgraph-stage=global-main-restore-end\nweb-depsgraph-stage=blend-free-end" }, { "token": "web:test:nonmesh-desktop-golden", @@ -46,9 +46,9 @@ ], "command": "npm --prefix web run test:nonmesh-desktop-golden", "exitCode": 0, - "durationMs": 686, - "outputSha256": "e5339560846d774c039f493679a373b37b35ea7bfa68f1dc2a019188ecc91d45", - "output": "> blender-web-editor@0.1.0 test:nonmesh-desktop-golden\n> node ../tools/web/check-nonmesh-desktop-golden.mjs\n\nnonmesh-desktop-golden-ok fixture=nonmesh_scene.blend geometries=4\n\nweb-depsgraph-stage=runtime-init-begin\nweb-depsgraph-stage=runtime-init-end\nweb-depsgraph-stage=blend-read-end\nweb-depsgraph-stage=view-layer-sync-end\nweb-depsgraph-data scene=0xa71220 master=0xacb470 nodetree=0 world=0 collections=0\nweb-depsgraph-stage=global-main-swap-end\nweb-depsgraph-stage=graph-new-end\nweb-depsgraph-stage=graph-build-end\nweb-depsgraph-stage=frame-change-end\nweb-depsgraph-stage=graph-free-end\nweb-depsgraph-stage=global-main-restore-end\nweb-depsgraph-stage=blend-free-end" + "durationMs": 920, + "outputSha256": "54cfd9cdec5a7885b22768bce6652410fc3709da1f4c943bcfa6655637435215", + "output": "> blender-web-editor@0.1.0-rc.1 test:nonmesh-desktop-golden\n> node ../tools/web/check-nonmesh-desktop-golden.mjs\n\nnonmesh-desktop-golden-ok fixture=nonmesh_scene.blend geometries=4\n\nweb-depsgraph-stage=runtime-init-begin\nweb-depsgraph-stage=runtime-init-end\nweb-depsgraph-stage=blend-read-end\nweb-depsgraph-stage=view-layer-sync-end\nweb-depsgraph-data scene=0xa71220 master=0xacb470 nodetree=0 world=0 collections=0\nweb-depsgraph-stage=global-main-swap-end\nweb-depsgraph-stage=graph-new-end\nweb-depsgraph-stage=graph-build-end\nweb-depsgraph-stage=frame-change-end\nweb-depsgraph-stage=graph-free-end\nweb-depsgraph-stage=global-main-restore-end\nweb-depsgraph-stage=blend-free-end" }, { "token": "web:test:nonmesh-glb-blender-roundtrip", @@ -57,9 +57,9 @@ ], "command": "npm --prefix web run test:nonmesh-glb-blender-roundtrip", "exitCode": 0, - "durationMs": 1668, - "outputSha256": "8627de96cfe96c0c7490cfe54fa59a680f787d5d3dcdadacc20e79a2c20f72c7", - "output": "> blender-web-editor@0.1.0 test:nonmesh-glb-blender-roundtrip\n> node ../tools/web/check-nonmesh-glb-blender-roundtrip.mjs\n\nnonmesh-glb-blender-roundtrip-ok bytes=53172 objects=7 points=1 lines=3 triangles=3\n\nweb-depsgraph-stage=runtime-init-begin\nweb-depsgraph-stage=runtime-init-end\nweb-depsgraph-stage=blend-read-end\nweb-depsgraph-stage=view-layer-sync-end\nweb-depsgraph-data scene=0xa71260 master=0xacb460 nodetree=0 world=0 collections=0\nweb-depsgraph-stage=global-main-swap-end\nweb-depsgraph-stage=graph-new-end\nweb-depsgraph-stage=graph-build-end\nweb-depsgraph-stage=frame-change-end\nweb-depsgraph-stage=graph-free-end\nweb-depsgraph-stage=global-main-restore-end\nweb-depsgraph-stage=blend-free-end" + "durationMs": 2200, + "outputSha256": "c9ba8f68095690f4235b19da1645416f912fc0a7716f11f75c2ee8a63f300319", + "output": "> blender-web-editor@0.1.0-rc.1 test:nonmesh-glb-blender-roundtrip\n> node ../tools/web/check-nonmesh-glb-blender-roundtrip.mjs\n\nnonmesh-glb-blender-roundtrip-ok bytes=53172 objects=7 points=1 lines=3 triangles=3\n\nweb-depsgraph-stage=runtime-init-begin\nweb-depsgraph-stage=runtime-init-end\nweb-depsgraph-stage=blend-read-end\nweb-depsgraph-stage=view-layer-sync-end\nweb-depsgraph-data scene=0xa71260 master=0xacb460 nodetree=0 world=0 collections=0\nweb-depsgraph-stage=global-main-swap-end\nweb-depsgraph-stage=graph-new-end\nweb-depsgraph-stage=graph-build-end\nweb-depsgraph-stage=frame-change-end\nweb-depsgraph-stage=graph-free-end\nweb-depsgraph-stage=global-main-restore-end\nweb-depsgraph-stage=blend-free-end" }, { "token": "web:test:nonmesh-usd-serialization", @@ -68,9 +68,9 @@ ], "command": "npm --prefix web run test:nonmesh-usd-serialization", "exitCode": 0, - "durationMs": 2031, - "outputSha256": "b80732c965d85c19cfb3c3a629777bacfdc1a920abcc384d436831a64f6e3101", - "output": "> blender-web-editor@0.1.0 test:nonmesh-usd-serialization\n> USD_DESKTOP_REQUIRED=0 node ../tools/web/check-nonmesh-usd-blender-roundtrip.mjs\n\nnonmesh-usd-blender-roundtrip-ok bytes=65405 objects=7 points=1 basisCurves=3 meshes=3\n\nweb-depsgraph-stage=runtime-init-begin\nweb-depsgraph-stage=runtime-init-end\nweb-depsgraph-stage=blend-read-end\nweb-depsgraph-stage=view-layer-sync-end\nweb-depsgraph-data scene=0xa71260 master=0xacb460 nodetree=0 world=0 collections=0\nweb-depsgraph-stage=global-main-swap-end\nweb-depsgraph-stage=graph-new-end\nweb-depsgraph-stage=graph-build-end\nweb-depsgraph-stage=frame-change-end\nweb-depsgraph-stage=graph-free-end\nweb-depsgraph-stage=global-main-restore-end\nweb-depsgraph-stage=blend-free-end" + "durationMs": 2532, + "outputSha256": "7a76fabed285b2fbd3b528fae02dd5696327b5068fd6909e504666d5022b80c2", + "output": "> blender-web-editor@0.1.0-rc.1 test:nonmesh-usd-serialization\n> USD_DESKTOP_REQUIRED=0 node ../tools/web/check-nonmesh-usd-blender-roundtrip.mjs\n\nnonmesh-usd-blender-roundtrip-ok bytes=65405 objects=7 points=1 basisCurves=3 meshes=3\n\nweb-depsgraph-stage=runtime-init-begin\nweb-depsgraph-stage=runtime-init-end\nweb-depsgraph-stage=blend-read-end\nweb-depsgraph-stage=view-layer-sync-end\nweb-depsgraph-data scene=0xa71260 master=0xacb460 nodetree=0 world=0 collections=0\nweb-depsgraph-stage=global-main-swap-end\nweb-depsgraph-stage=graph-new-end\nweb-depsgraph-stage=graph-build-end\nweb-depsgraph-stage=frame-change-end\nweb-depsgraph-stage=graph-free-end\nweb-depsgraph-stage=global-main-restore-end\nweb-depsgraph-stage=blend-free-end" }, { "token": "web:test:nonmesh-usd-blender-roundtrip", @@ -79,9 +79,9 @@ ], "command": "npm --prefix web run test:nonmesh-usd-blender-roundtrip", "exitCode": 0, - "durationMs": 2033, - "outputSha256": "ce0580b3b5d047a1c3c5d2d1a338c6c001b5d9a69c5d22ed35322bd353fb16af", - "output": "> blender-web-editor@0.1.0 test:nonmesh-usd-blender-roundtrip\n> USD_DESKTOP_REQUIRED=1 node ../tools/web/check-nonmesh-usd-blender-roundtrip.mjs\n\nnonmesh-usd-blender-roundtrip-ok bytes=65405 objects=7 points=1 basisCurves=3 meshes=3\n\nweb-depsgraph-stage=runtime-init-begin\nweb-depsgraph-stage=runtime-init-end\nweb-depsgraph-stage=blend-read-end\nweb-depsgraph-stage=view-layer-sync-end\nweb-depsgraph-data scene=0xa71260 master=0xacb460 nodetree=0 world=0 collections=0\nweb-depsgraph-stage=global-main-swap-end\nweb-depsgraph-stage=graph-new-end\nweb-depsgraph-stage=graph-build-end\nweb-depsgraph-stage=frame-change-end\nweb-depsgraph-stage=graph-free-end\nweb-depsgraph-stage=global-main-restore-end\nweb-depsgraph-stage=blend-free-end" + "durationMs": 2526, + "outputSha256": "0d4e89b5d022962e4effc43c53385b825c21217dd14850e36f6db7e20bd3511a", + "output": "> blender-web-editor@0.1.0-rc.1 test:nonmesh-usd-blender-roundtrip\n> USD_DESKTOP_REQUIRED=1 node ../tools/web/check-nonmesh-usd-blender-roundtrip.mjs\n\nnonmesh-usd-blender-roundtrip-ok bytes=65405 objects=7 points=1 basisCurves=3 meshes=3\n\nweb-depsgraph-stage=runtime-init-begin\nweb-depsgraph-stage=runtime-init-end\nweb-depsgraph-stage=blend-read-end\nweb-depsgraph-stage=view-layer-sync-end\nweb-depsgraph-data scene=0xa71260 master=0xacb460 nodetree=0 world=0 collections=0\nweb-depsgraph-stage=global-main-swap-end\nweb-depsgraph-stage=graph-new-end\nweb-depsgraph-stage=graph-build-end\nweb-depsgraph-stage=frame-change-end\nweb-depsgraph-stage=graph-free-end\nweb-depsgraph-stage=global-main-restore-end\nweb-depsgraph-stage=blend-free-end" }, { "token": "web:test:nonmesh-binary", @@ -90,9 +90,9 @@ ], "command": "npm --prefix web run test:nonmesh-binary", "exitCode": 0, - "durationMs": 4132, - "outputSha256": "0b7d02b2b5ba6c772edf687e2270ae8672b9a16be61e3793f23a2987278413e3", - "output": "> blender-web-editor@0.1.0 test:nonmesh-binary\n> playwright test --config playwright.config.ts -g \"one-million-point binary transfer gate\"\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:402:1 › enforces the N-015 one-million-point binary transfer gate (1.5s)\n\n 1 passed (3.3s)" + "durationMs": 4623, + "outputSha256": "53f1182423f3cdcb5d0ba00f5827ba1d5ed5f880151ef5d746ae3893020ed771", + "output": "> blender-web-editor@0.1.0-rc.1 test:nonmesh-binary\n> playwright test --config playwright.config.ts -g \"one-million-point binary transfer gate\"\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:402:1 › enforces the N-015 one-million-point binary transfer gate (1.6s)\n\n 1 passed (3.7s)" }, { "token": "web:test:selection-history", @@ -101,9 +101,9 @@ ], "command": "npm --prefix web run test:selection-history", "exitCode": 0, - "durationMs": 4046, - "outputSha256": "b130771034a5d42212e4df33b6738159b73c7353bf985233393c506e8a274cb1", - "output": "> blender-web-editor@0.1.0 test:selection-history\n> playwright test --config playwright.config.ts -g \"N-015 selection history\"\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:1060:1 › keeps N-015 selection history bounded and rejects stale raycast hits (1.5s)\n\n 1 passed (3.2s)" + "durationMs": 4642, + "outputSha256": "9b8035591b1b4f7f665688d9190d7191d12a5cd6d204fcb271d46375817cb3a2", + "output": "> blender-web-editor@0.1.0-rc.1 test:selection-history\n> playwright test --config playwright.config.ts -g \"N-015 selection history\"\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:1060:1 › keeps N-015 selection history bounded and rejects stale raycast hits (1.7s)\n\n 1 passed (3.7s)" }, { "token": "web:test:nonmesh-interaction", @@ -112,9 +112,9 @@ ], "command": "npm --prefix web run test:nonmesh-interaction", "exitCode": 0, - "durationMs": 4296, - "outputSha256": "7c96e5f69ac5c5a567bb2345fbd8b0793a80d54d8b87ef4a55b7c8cdb223e231", - "output": "> blender-web-editor@0.1.0 test:nonmesh-interaction\n> playwright test --config playwright.config.ts -g \"N-015 curve gizmo interaction\"\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:1081:1 › validates the N-015 curve gizmo interaction transaction boundary (1.7s)\n\n 1 passed (3.5s)" + "durationMs": 4538, + "outputSha256": "0794b7d8acb9c24a8de963a9a76fbbf2919228cc637d79c2b101a8280698df63", + "output": "> blender-web-editor@0.1.0-rc.1 test:nonmesh-interaction\n> playwright test --config playwright.config.ts -g \"N-015 curve gizmo interaction\"\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:1081:1 › validates the N-015 curve gizmo interaction transaction boundary (1.8s)\n\n 1 passed (3.7s)" }, { "token": "web:test:vdb", @@ -123,9 +123,9 @@ ], "command": "npm --prefix web run test:vdb", "exitCode": 0, - "durationMs": 4025, - "outputSha256": "1aa70cf5c66b18abf4f2214c67834377c7c50b46a207e84fc50de89dbeb1c1cc", - "output": "> blender-web-editor@0.1.0 test:vdb\n> playwright test --config playwright.config.ts -g \"VDB conversion boundary\"\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:1156:1 › validates the VDB conversion boundary and NanoVDB streaming contract (1.5s)\n\n 1 passed (3.2s)" + "durationMs": 4103, + "outputSha256": "974bedb7c4fa970d79b6140d1527b39de4c99f063c9c848684d064efcdc8723b", + "output": "> blender-web-editor@0.1.0-rc.1 test:vdb\n> playwright test --config playwright.config.ts -g \"VDB conversion boundary\"\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:1156:1 › validates the VDB conversion boundary and NanoVDB streaming contract (1.4s)\n\n 1 passed (3.3s)" }, { "token": "web:test:vdb-availability", @@ -134,9 +134,9 @@ ], "command": "npm --prefix web run test:vdb-availability", "exitCode": 0, - "durationMs": 389, - "outputSha256": "09d74a026344f6f10405b879be73c1bdf060ef1eb1d11b4aa2c1ab60ff256d49", - "output": "> blender-web-editor@0.1.0 test:vdb-availability\n> node ../tools/web/check-vdb-availability.mjs\n\nvdb-availability-ok core=READY release=BLOCKED browser-openvdb=disabled desktop=ready server=ready opfs=ready webgpu-core=ready main-roundtrip=ready viewport=blocked advanced-material=blocked resources=9" + "durationMs": 370, + "outputSha256": "3d1fce4839232bd9c5c7dc42ea2e462be9ade0866d1296cfc5897afadd6b39fc", + "output": "> blender-web-editor@0.1.0-rc.1 test:vdb-availability\n> node ../tools/web/check-vdb-availability.mjs\n\nvdb-availability-ok core=READY release=BLOCKED browser-openvdb=disabled desktop=ready server=ready opfs=ready webgpu-core=ready main-roundtrip=ready viewport=blocked advanced-material=blocked resources=9" }, { "token": "web:test:vdb-native", @@ -145,9 +145,9 @@ ], "command": "npm --prefix web run test:vdb-native", "exitCode": 0, - "durationMs": 1259, - "outputSha256": "1a431ee0076697fa70cfc3230f3400b85dd45cf668a645c2a83276f615e241a4", - "output": "> blender-web-editor@0.1.0 test:vdb-native\n> node ../tools/web/check-vdb-native-pipeline.mjs\n\nvdb-native-pipeline-ok resources=14 converter=openvdb13-nanovdb32 conversion-deterministic=1 semantic-deterministic=1 official-deterministic=1 malformed=blocked browser-openvdb=off" + "durationMs": 1341, + "outputSha256": "52abc08ddc600e3c00842cb2619b3c4b66b113e8bd83d96db910ac1b95d5d012", + "output": "> blender-web-editor@0.1.0-rc.1 test:vdb-native\n> node ../tools/web/check-vdb-native-pipeline.mjs\n\nvdb-native-pipeline-ok resources=14 converter=openvdb13-nanovdb32 conversion-deterministic=1 semantic-deterministic=1 official-deterministic=1 malformed=blocked browser-openvdb=off" }, { "token": "web:test:vdb-server", @@ -156,9 +156,9 @@ ], "command": "npm --prefix web run test:vdb-server", "exitCode": 0, - "durationMs": 648, - "outputSha256": "5ed0afb34328b5da0ec5702504cb1178999da5e11953129caec407d2c81c0d43", - "output": "> blender-web-editor@0.1.0 test:vdb-server\n> node ../tools/web/check-vdb-server-job.mjs\n\nvdb-server-job-ok job=vdb-b59105490496a2fee0dda646 bytes=2563944 idempotent=1 signed=1 isolated=1 cancelled=1 atomic=1 desktop-server-hash=equal" + "durationMs": 691, + "outputSha256": "d958e3ed39b5660b5e8d66d7171b651e97f0e87c1c7b9769709478925a91907f", + "output": "> blender-web-editor@0.1.0-rc.1 test:vdb-server\n> node ../tools/web/check-vdb-server-job.mjs\n\nvdb-server-job-ok job=vdb-b59105490496a2fee0dda646 bytes=2563944 idempotent=1 signed=1 isolated=1 cancelled=1 atomic=1 desktop-server-hash=equal" }, { "token": "web:test:vdb-opfs", @@ -167,9 +167,9 @@ ], "command": "npm --prefix web run test:vdb-opfs", "exitCode": 0, - "durationMs": 5297, - "outputSha256": "cabf007e624b204168d00a5f292c33fbdc560e8584a609c11f7286d16e26b6e9", - "output": "> blender-web-editor@0.1.0 test:vdb-opfs\n> playwright test --config playwright.config.ts -g \"hash-bound NanoVDB project through OPFS\"\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:1206:1 › commits and reopens a hash-bound NanoVDB project through OPFS (2.7s)\n\n 1 passed (4.5s)" + "durationMs": 5672, + "outputSha256": "976954270c006f573cd70022ab4cd5c500ff9d4ff895aabde4d1eb8cc1895430", + "output": "> blender-web-editor@0.1.0-rc.1 test:vdb-opfs\n> playwright test --config playwright.config.ts -g \"hash-bound NanoVDB project through OPFS\"\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:1206:1 › commits and reopens a hash-bound NanoVDB project through OPFS (2.9s)\n\n 1 passed (4.8s)" }, { "token": "web:test:vdb-webgpu", @@ -178,9 +178,9 @@ ], "command": "npm --prefix web run test:vdb-webgpu", "exitCode": 0, - "durationMs": 62192, - "outputSha256": "3885ee85fd05995c04f1a790fa134f1bdbf39503dc6a00e471fc99a77dbccf6c", - "output": "> blender-web-editor@0.1.0 test:vdb-webgpu\n> playwright test --config playwright.config.ts -g \"real NanoVDB Float32 tree with WebGPU\"\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:1232:1 › samples and integrates a real NanoVDB Float32 tree with WebGPU (59.6s)\n\n 1 passed (1.0m)" + "durationMs": 64026, + "outputSha256": "d7d13bf8104f9fef4a92836d37b839fc4ec24135ad6424e7d36eddcf7b45c070", + "output": "> blender-web-editor@0.1.0-rc.1 test:vdb-webgpu\n> playwright test --config playwright.config.ts -g \"real NanoVDB Float32 tree with WebGPU\"\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:1232:1 › samples and integrates a real NanoVDB Float32 tree with WebGPU (1.0m)\n\n 1 passed (1.1m)" }, { "token": "web:test:vdb-viewport", @@ -189,9 +189,9 @@ ], "command": "npm --prefix web run test:vdb-viewport", "exitCode": 0, - "durationMs": 116435, - "outputSha256": "eb54044817e597de7a1978fe2b8cf9d97324a2aeb0cd4ab1574a4385401f7211", - "output": "> blender-web-editor@0.1.0 test:vdb-viewport\n> playwright test --config playwright.config.ts -g \"both production viewport backends\"\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:1264:1 › renders a real NanoVDB volume through both production viewport backends (1.9m)\n\n 1 passed (1.9m)" + "durationMs": 122887, + "outputSha256": "215608ae74264a438f7e93caa25758eff946f429de284021b40d202ba78756a5", + "output": "> blender-web-editor@0.1.0-rc.1 test:vdb-viewport\n> playwright test --config playwright.config.ts -g \"both production viewport backends\"\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:1264:1 › renders a real NanoVDB volume through both production viewport backends (2.0m)\n\n 1 passed (2.0m)" }, { "token": "web:test:vdb-faults", @@ -201,9 +201,9 @@ ], "command": "npm --prefix web run test:vdb-faults", "exitCode": 0, - "durationMs": 5724, - "outputSha256": "ba420837572b94192e0dd81660674ef5cc406d77e675ad1322d705749fe785cb", - "output": "> blender-web-editor@0.1.0 test:vdb-faults\n> playwright test --config playwright.config.ts -g \"NanoVDB paging from network, Worker and WebGPU device faults\"\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:1344:1 › recovers NanoVDB paging from network, Worker and WebGPU device faults (3.2s)\n\n 1 passed (4.9s)" + "durationMs": 6038, + "outputSha256": "6ab0e4445b5c80adb967c1e573f12339ee9e5bae3b5585ff42218a266df6d28c", + "output": "> blender-web-editor@0.1.0-rc.1 test:vdb-faults\n> playwright test --config playwright.config.ts -g \"NanoVDB paging from network, Worker and WebGPU device faults\"\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:1344:1 › recovers NanoVDB paging from network, Worker and WebGPU device faults (3.4s)\n\n 1 passed (5.2s)" }, { "token": "web:e2e:N-015|non-mesh", @@ -212,9 +212,9 @@ ], "command": "npm --prefix web run test:e2e -- --workers=1 -g \"N-015|non-mesh\"", "exitCode": 0, - "durationMs": 17945, - "outputSha256": "dabeaa176c79b4688db7d0c11faac4026ca2ea98994d582ff8006eb76a4a533d", - "output": "> blender-web-editor@0.1.0 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g N-015|non-mesh\n\n\nRunning 10 tests using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:295:1 › reads bounded non-mesh data blocks and previews supported geometry (2.3s)\n ✓ 2 tests/e2e/smoke.spec.ts:341:1 › reports structured N-015 gates for previewable and resource-backed data (1.2s)\n ✓ 3 tests/e2e/smoke.spec.ts:402:1 › enforces the N-015 one-million-point binary transfer gate (946ms)\n ✓ 4 tests/e2e/smoke.spec.ts:417:1 › rejects malformed N-015 binary chunks, integer overflow and budget overflow (919ms)\n ✓ 5 tests/e2e/smoke.spec.ts:1060:1 › keeps N-015 selection history bounded and rejects stale raycast hits (912ms)\n ✓ 6 tests/e2e/smoke.spec.ts:1081:1 › validates the N-015 curve gizmo interaction transaction boundary (1.2s)\n ✓ 7 tests/e2e/smoke.spec.ts:1098:40 › previews an N-015 Curve handle drag and commits Main once in main-thread Chromium (3.0s)\n ✓ 8 tests/e2e/smoke.spec.ts:1098:40 › previews an N-015 Curve handle drag and commits Main once in OffscreenCanvas Chromium (2.2s)\n ✓ 9 tests/e2e/smoke.spec.ts:1435:1 › returns real Blender evaluations for legacy non-mesh geometry (1.4s)\n ✓ 10 tests/e2e/smoke.spec.ts:1467:1 › keeps N-015 non-mesh previews in the OffscreenCanvas renderer (1.4s)\n\n 10 passed (17.1s)" + "durationMs": 20310, + "outputSha256": "4c6c6c6b742c24240b0ea458175e2054ef5cc0357c02f06310cea664fa7d57dc", + "output": "> blender-web-editor@0.1.0-rc.1 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g N-015|non-mesh\n\n\nRunning 10 tests using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:295:1 › reads bounded non-mesh data blocks and previews supported geometry (2.6s)\n ✓ 2 tests/e2e/smoke.spec.ts:341:1 › reports structured N-015 gates for previewable and resource-backed data (1.3s)\n ✓ 3 tests/e2e/smoke.spec.ts:402:1 › enforces the N-015 one-million-point binary transfer gate (1.1s)\n ✓ 4 tests/e2e/smoke.spec.ts:417:1 › rejects malformed N-015 binary chunks, integer overflow and budget overflow (947ms)\n ✓ 5 tests/e2e/smoke.spec.ts:1060:1 › keeps N-015 selection history bounded and rejects stale raycast hits (974ms)\n ✓ 6 tests/e2e/smoke.spec.ts:1081:1 › validates the N-015 curve gizmo interaction transaction boundary (1.4s)\n ✓ 7 tests/e2e/smoke.spec.ts:1098:40 › previews an N-015 Curve handle drag and commits Main once in main-thread Chromium (3.4s)\n ✓ 8 tests/e2e/smoke.spec.ts:1098:40 › previews an N-015 Curve handle drag and commits Main once in OffscreenCanvas Chromium (2.5s)\n ✓ 9 tests/e2e/smoke.spec.ts:1435:1 › returns real Blender evaluations for legacy non-mesh geometry (1.6s)\n ✓ 10 tests/e2e/smoke.spec.ts:1467:1 › keeps N-015 non-mesh previews in the OffscreenCanvas renderer (1.6s)\n\n 10 passed (19.5s)" }, { "token": "web:e2e:real OPFS quota", @@ -223,9 +223,9 @@ ], "command": "npm --prefix web run test:e2e -- --workers=1 -g \"real OPFS quota\"", "exitCode": 0, - "durationMs": 4220, - "outputSha256": "3b5bbe03b09487bee7d7d21821833cdd863c7e6ccc77a62329a1c83ea8a69526", - "output": "> blender-web-editor@0.1.0 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g real OPFS quota\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:1595:1 › enforces a real OPFS quota without replacing the committed project (1.6s)\n\n 1 passed (3.4s)" + "durationMs": 4212, + "outputSha256": "9ca11848c3935b40798325d6e54d68ec0e7c0d8eb880bb16ecba04a7ca85d3cc", + "output": "> blender-web-editor@0.1.0-rc.1 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g real OPFS quota\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:1595:1 › enforces a real OPFS quota without replacing the committed project (1.5s)\n\n 1 passed (3.4s)" }, { "token": "web:test:grease-pencil", @@ -234,9 +234,9 @@ ], "command": "npm --prefix web run test:grease-pencil", "exitCode": 0, - "durationMs": 702, - "outputSha256": "54038fad56465ca7ac6826cf69854c227c3812ce375031af549f2771861c9473", - "output": "> blender-web-editor@0.1.0 test:grease-pencil\n> node ../tools/web/check-grease-pencil-roundtrip.mjs\n\ngrease-pencil-roundtrip-ok layer-frame-stroke=passed undo-redo=passed save-reopen=passed" + "durationMs": 776, + "outputSha256": "c5419926826128e17eed9837fd237b2467eee712143f7f3f1c7eecc243fe6775", + "output": "> blender-web-editor@0.1.0-rc.1 test:grease-pencil\n> node ../tools/web/check-grease-pencil-roundtrip.mjs\n\ngrease-pencil-roundtrip-ok layer-frame-stroke=passed undo-redo=passed save-reopen=passed" }, { "token": "web:test:grease-pencil-editor", @@ -245,9 +245,9 @@ ], "command": "npm --prefix web run test:grease-pencil-editor", "exitCode": 0, - "durationMs": 4097, - "outputSha256": "c4109eb01c634356551cf19e26a3a3859f612e7511adfbeb25f092e9591e77bc", - "output": "> blender-web-editor@0.1.0 test:grease-pencil-editor\n> playwright test --config playwright.config.ts -g \"N-016 Grease Pencil editor context\"\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:510:1 › validates the N-016 Grease Pencil editor context transaction boundary (1.5s)\n\n 1 passed (3.3s)" + "durationMs": 4194, + "outputSha256": "71cfe010c8140d96ece7bddc359805a6dbcb54213224e78d40db436b9aef6605", + "output": "> blender-web-editor@0.1.0-rc.1 test:grease-pencil-editor\n> playwright test --config playwright.config.ts -g \"N-016 Grease Pencil editor context\"\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:510:1 › validates the N-016 Grease Pencil editor context transaction boundary (1.5s)\n\n 1 passed (3.3s)" }, { "token": "web:e2e:N-016 Grease Pencil", @@ -256,9 +256,9 @@ ], "command": "npm --prefix web run test:e2e -- --workers=1 -g \"N-016 Grease Pencil\"", "exitCode": 0, - "durationMs": 19150, - "outputSha256": "613880a4c3506a4671fa7283c37890d85b37b10d899af99a5202625130ccf463", - "output": "> blender-web-editor@0.1.0 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g N-016 Grease Pencil\n\n\nRunning 12 tests using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:437:1 › enforces the N-016 Grease Pencil layer/frame/drawing/stroke/point schema budget (1.4s)\n ✓ 2 tests/e2e/smoke.spec.ts:453:1 › renders a bounded previous/next N-016 Grease Pencil onion-skin preview (872ms)\n ✓ 3 tests/e2e/smoke.spec.ts:485:3 › renders the N-016 Grease Pencil current-frame strokes in main-thread Chromium (1.3s)\n ✓ 4 tests/e2e/smoke.spec.ts:485:3 › renders the N-016 Grease Pencil current-frame strokes in OffscreenCanvas Chromium (1.2s)\n ✓ 5 tests/e2e/smoke.spec.ts:510:1 › validates the N-016 Grease Pencil editor context transaction boundary (917ms)\n ✓ 6 tests/e2e/smoke.spec.ts:526:1 › raycasts and highlights N-016 Grease Pencil points with stable drawing identity (1.3s)\n ✓ 7 tests/e2e/smoke.spec.ts:541:40 › previews N-016 Grease Pencil points and commits Main once in main-thread Chromium (1.8s)\n ✓ 8 tests/e2e/smoke.spec.ts:541:40 › previews N-016 Grease Pencil points and commits Main once in OffscreenCanvas Chromium (1.5s)\n ✓ 9 tests/e2e/smoke.spec.ts:565:1 › edits N-016 Grease Pencil layers and frames from the bounded editor panel (1.6s)\n ✓ 10 tests/e2e/smoke.spec.ts:580:1 › navigates real N-016 Grease Pencil drawing frames in the bounded Dope Sheet (1.6s)\n ✓ 11 tests/e2e/smoke.spec.ts:595:1 › moves an N-016 Grease Pencil point through one revision-bound Main transaction (1.5s)\n ✓ 12 tests/e2e/smoke.spec.ts:606:1 › reopens an edited N-016 Grease Pencil drawing after WebEngine Worker restart (1.5s)\n\n 12 passed (18.3s)" + "durationMs": 21136, + "outputSha256": "feeb4c14236ca3766be2bcefb3bd7567074bc91940935c2731cdcd3e4a8b8f03", + "output": "> blender-web-editor@0.1.0-rc.1 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g N-016 Grease Pencil\n\n\nRunning 12 tests using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:437:1 › enforces the N-016 Grease Pencil layer/frame/drawing/stroke/point schema budget (1.5s)\n ✓ 2 tests/e2e/smoke.spec.ts:453:1 › renders a bounded previous/next N-016 Grease Pencil onion-skin preview (914ms)\n ✓ 3 tests/e2e/smoke.spec.ts:485:3 › renders the N-016 Grease Pencil current-frame strokes in main-thread Chromium (1.4s)\n ✓ 4 tests/e2e/smoke.spec.ts:485:3 › renders the N-016 Grease Pencil current-frame strokes in OffscreenCanvas Chromium (1.4s)\n ✓ 5 tests/e2e/smoke.spec.ts:510:1 › validates the N-016 Grease Pencil editor context transaction boundary (974ms)\n ✓ 6 tests/e2e/smoke.spec.ts:526:1 › raycasts and highlights N-016 Grease Pencil points with stable drawing identity (1.4s)\n ✓ 7 tests/e2e/smoke.spec.ts:541:40 › previews N-016 Grease Pencil points and commits Main once in main-thread Chromium (2.0s)\n ✓ 8 tests/e2e/smoke.spec.ts:541:40 › previews N-016 Grease Pencil points and commits Main once in OffscreenCanvas Chromium (1.7s)\n ✓ 9 tests/e2e/smoke.spec.ts:565:1 › edits N-016 Grease Pencil layers and frames from the bounded editor panel (1.7s)\n ✓ 10 tests/e2e/smoke.spec.ts:580:1 › navigates real N-016 Grease Pencil drawing frames in the bounded Dope Sheet (1.8s)\n ✓ 11 tests/e2e/smoke.spec.ts:595:1 › moves an N-016 Grease Pencil point through one revision-bound Main transaction (1.6s)\n ✓ 12 tests/e2e/smoke.spec.ts:606:1 › reopens an edited N-016 Grease Pencil drawing after WebEngine Worker restart (1.5s)\n\n 12 passed (20.1s)" }, { "token": "web:test:paint-roundtrip", @@ -267,9 +267,9 @@ ], "command": "npm --prefix web run test:paint-roundtrip", "exitCode": 0, - "durationMs": 757, - "outputSha256": "80170948f7a18d6e0fa314c0a3ddc660abb67b1fc018f66a944d080516523fc0", - "output": "> blender-web-editor@0.1.0 test:paint-roundtrip\n> node ../tools/web/check-paint-roundtrip.mjs\n\npaint-roundtrip-ok vertex-color=passed vertex-weight-normalize=passed mirror-gate=passed undo-redo=passed save-reopen=passed" + "durationMs": 785, + "outputSha256": "d43258df5975ef194ba7c45c3758c8cac3e2ef89256510e4c1fedbc27f2b5b25", + "output": "> blender-web-editor@0.1.0-rc.1 test:paint-roundtrip\n> node ../tools/web/check-paint-roundtrip.mjs\n\npaint-roundtrip-ok vertex-color=passed vertex-weight-normalize=passed mirror-gate=passed undo-redo=passed save-reopen=passed" }, { "token": "web:e2e:N-017 paint", @@ -278,9 +278,9 @@ ], "command": "npm --prefix web run test:e2e -- --workers=1 -g \"N-017 paint\"", "exitCode": 0, - "durationMs": 4194, - "outputSha256": "b2b4157a480bfa0ddc1d3d5031baec6b784e7917b1b6781072791724d96fe655", - "output": "> blender-web-editor@0.1.0 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g N-017 paint\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:648:1 › enforces the N-017 paint stroke, bounded brush and UDIM patch budgets (1.5s)\n\n 1 passed (3.3s)" + "durationMs": 4154, + "outputSha256": "204d84caabd73ba9be657483115ed1c2f681acf34ece9500ed5c0d5861c8fb7a", + "output": "> blender-web-editor@0.1.0-rc.1 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g N-017 paint\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:648:1 › enforces the N-017 paint stroke, bounded brush and UDIM patch budgets (1.4s)\n\n 1 passed (3.3s)" }, { "token": "web:e2e:N-018 physics", @@ -289,9 +289,9 @@ ], "command": "npm --prefix web run test:e2e -- --workers=1 -g \"N-018 physics\"", "exitCode": 0, - "durationMs": 4083, - "outputSha256": "67606d91993447632a709a163b3ca2a39634ffe343d523327f6a2084a5b253d1", - "output": "> blender-web-editor@0.1.0 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g N-018 physics\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:746:1 › validates the N-018 physics capability and cache manifests without claiming solvers (1.5s)\n\n 1 passed (3.3s)" + "durationMs": 4129, + "outputSha256": "cfc04a1e75861cfd87fd3b58ed016a9d2a85c854866fcfc314e97fbfe591d2fa", + "output": "> blender-web-editor@0.1.0-rc.1 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g N-018 physics\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:746:1 › validates the N-018 physics capability and cache manifests without claiming solvers (1.4s)\n\n 1 passed (3.3s)" }, { "token": "web:test:simulation-cache", @@ -300,9 +300,9 @@ ], "command": "npm --prefix web run test:simulation-cache", "exitCode": 0, - "durationMs": 4157, - "outputSha256": "995c1e31bb89e4124999b1e60d7cb0ac09cd5276f07e15f7affb796624a177c6", - "output": "> blender-web-editor@0.1.0 test:simulation-cache\n> playwright test --config playwright.config.ts -g \"Simulation caches\"\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:1631:1 › persists and revalidates content-addressed Simulation caches across Worker restarts (1.5s)\n\n 1 passed (3.3s)" + "durationMs": 4312, + "outputSha256": "62ebe648848c8feb9f768825b87175e9c6ba374ee93fa43e9e089525e2d62a87", + "output": "> blender-web-editor@0.1.0-rc.1 test:simulation-cache\n> playwright test --config playwright.config.ts -g \"Simulation caches\"\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:1631:1 › persists and revalidates content-addressed Simulation caches across Worker restarts (1.6s)\n\n 1 passed (3.4s)" }, { "token": "web:test:physics-main-reader", @@ -311,9 +311,9 @@ ], "command": "npm --prefix web run test:physics-main-reader", "exitCode": 0, - "durationMs": 733, - "outputSha256": "40b88699ab714c717a59461345880235d337e833b614056b13d43594f797fa03", - "output": "> blender-web-editor@0.1.0 test:physics-main-reader\n> node ../tools/web/check-physics-main-reader.mjs\n\nphysics-main-reader-ok families=CLOTH,SOFT_BODY dependencies=COLLISION settings-sha256=passed save-reopen=passed playback=BLOCKED solver=BLOCKED" + "durationMs": 771, + "outputSha256": "db1e7ed03da623f091a436357d0fdc025fa358e13040aa98c8658b7b307c080c", + "output": "> blender-web-editor@0.1.0-rc.1 test:physics-main-reader\n> node ../tools/web/check-physics-main-reader.mjs\n\nphysics-main-reader-ok families=CLOTH,SOFT_BODY dependencies=COLLISION settings-sha256=passed save-reopen=passed playback=BLOCKED solver=BLOCKED" }, { "token": "web:test:lighting-roundtrip", @@ -322,9 +322,9 @@ ], "command": "npm --prefix web run test:lighting-roundtrip", "exitCode": 0, - "durationMs": 717, - "outputSha256": "14be8ff1c568f56cdbdb4fe9b0cd091f2014e024a049d1b11aa6a800d5d76e02", - "output": "> blender-web-editor@0.1.0 test:lighting-roundtrip\n> node ../tools/web/check-lighting-roundtrip.mjs\n\nlighting-roundtrip-ok camera-writer-dof=passed light-shadow-exposure=passed world-mist=passed color-management-reader=passed white-balance-gate=passed undo-redo=passed save-reopen=passed" + "durationMs": 775, + "outputSha256": "c9ddac34f9376983f0c67309583d0cb4a946d94f87421ffe1c9d6c3b39dbaba0", + "output": "> blender-web-editor@0.1.0-rc.1 test:lighting-roundtrip\n> node ../tools/web/check-lighting-roundtrip.mjs\n\nlighting-roundtrip-ok camera-writer-dof=passed light-shadow-exposure=passed world-mist=passed color-management-reader=passed white-balance-gate=passed undo-redo=passed save-reopen=passed" }, { "token": "web:e2e:N-019 Scene exposure", @@ -333,9 +333,9 @@ ], "command": "npm --prefix web run test:e2e -- --workers=1 -g \"N-019 Scene exposure\"", "exitCode": 0, - "durationMs": 4550, - "outputSha256": "55f18e2d99876fafdb02d050c9a712cca9e3d618b90d018160d9387244279420", - "output": "> blender-web-editor@0.1.0 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g N-019 Scene exposure\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:772:1 › maps N-019 Scene exposure and light shadow metadata without using legacy World exposure (2.0s)\n\n 1 passed (3.7s)" + "durationMs": 4815, + "outputSha256": "282a7bd253cb7748b37e69df903c4d6c0b3420222a0228b1aad4f2af863ae9da", + "output": "> blender-web-editor@0.1.0-rc.1 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g N-019 Scene exposure\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:772:1 › maps N-019 Scene exposure and light shadow metadata without using legacy World exposure (2.1s)\n\n 1 passed (3.9s)" }, { "token": "web:test:compositor-main-reader", @@ -344,9 +344,9 @@ ], "command": "npm --prefix web run test:compositor-main-reader", "exitCode": 0, - "durationMs": 692, - "outputSha256": "abcaddcb533bf00bfd0a0aa151e351e03615c3ed3a8b8e0b8d7a26ca7c0e25d6", - "output": "> blender-web-editor@0.1.0 test:compositor-main-reader\n> node ../tools/web/check-compositor-main-reader.mjs\n\ncompositor-main-reader-ok graph-structure=passed exposure-invert-parameters=passed socket-links=passed unsupported-preserved=passed" + "durationMs": 772, + "outputSha256": "8a4e76fcac535266cf3d4ac3166a2465334ed066c30a6bad5821c10f488e1e3b", + "output": "> blender-web-editor@0.1.0-rc.1 test:compositor-main-reader\n> node ../tools/web/check-compositor-main-reader.mjs\n\ncompositor-main-reader-ok graph-structure=passed exposure-invert-parameters=passed socket-links=passed unsupported-preserved=passed" }, { "token": "web:e2e:N-020 CPU compositor", @@ -355,9 +355,9 @@ ], "command": "npm --prefix web run test:e2e -- --workers=1 -g \"N-020 CPU compositor\"", "exitCode": 0, - "durationMs": 4177, - "outputSha256": "af1cc149bed90ef32bc0c85c705ccecdd96208299fafd90a73b6fa8896f102ef", - "output": "> blender-web-editor@0.1.0 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g N-020 CPU compositor\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:834:1 › executes the bounded N-020 CPU compositor and preserves unsupported nodes as gates (1.5s)\n\n 1 passed (3.3s)" + "durationMs": 4109, + "outputSha256": "dc95f8f62abd9d6662f2a919d6aa82ce8154e4f014d2fd2290db78aec5987381", + "output": "> blender-web-editor@0.1.0-rc.1 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g N-020 CPU compositor\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:834:1 › executes the bounded N-020 CPU compositor and preserves unsupported nodes as gates (1.4s)\n\n 1 passed (3.3s)" }, { "token": "web:test:sequencer-main-reader", @@ -366,9 +366,9 @@ ], "command": "npm --prefix web run test:sequencer-main-reader", "exitCode": 0, - "durationMs": 680, - "outputSha256": "5b798b9549d5ab530f123b91fdd8d1347b49277c294725d77ba37421a4b1b739", - "output": "> blender-web-editor@0.1.0 test:sequencer-main-reader\n> node ../tools/web/check-sequencer-main-reader.mjs\n\nsequencer-main-reader-ok media-paths=passed still-image-range=passed fps=passed effect-dependencies=passed" + "durationMs": 730, + "outputSha256": "3cfbd29640e5da4df0505732f2d6f963663cb67414d5ee97eebe8a7ffbbbeea8", + "output": "> blender-web-editor@0.1.0-rc.1 test:sequencer-main-reader\n> node ../tools/web/check-sequencer-main-reader.mjs\n\nsequencer-main-reader-ok media-paths=passed still-image-range=passed fps=passed effect-dependencies=passed" }, { "token": "web:e2e:N-021 sequencer", @@ -377,9 +377,9 @@ ], "command": "npm --prefix web run test:e2e -- --workers=1 -g \"N-021 sequencer\"", "exitCode": 0, - "durationMs": 4076, - "outputSha256": "3aa8c2ae171d05a17169afe602dbbf3be7ee541bbe2f24c60e06b21754f779d4", - "output": "> blender-web-editor@0.1.0 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g N-021 sequencer\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:879:1 › validates N-021 sequencer strips, deterministic edits, sandbox paths and codec gates (1.4s)\n\n 1 passed (3.2s)" + "durationMs": 4157, + "outputSha256": "4f9551827b9a72bc512d7ceba8ca569e4a8623ff767da93bc79c901451c94233", + "output": "> blender-web-editor@0.1.0-rc.1 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g N-021 sequencer\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:879:1 › validates N-021 sequencer strips, deterministic edits, sandbox paths and codec gates (1.4s)\n\n 1 passed (3.3s)" }, { "token": "web:test:mask-main-reader", @@ -388,9 +388,9 @@ ], "command": "npm --prefix web run test:mask-main-reader", "exitCode": 0, - "durationMs": 718, - "outputSha256": "ebf3ada68dda29abe2008343900b2ffad6d41e9750a3e9204c7b70674bbee692", - "output": "> blender-web-editor@0.1.0 test:mask-main-reader\n> node ../tools/web/check-mask-main-reader.mjs\n\nmask-main-reader-ok layers-splines=passed handles-feather=passed locked-editable-selection=passed" + "durationMs": 743, + "outputSha256": "5fab1e2b7cdae27caa97ebbaf2b9c0f72a84cb44897b856ecbfd4d5162712027", + "output": "> blender-web-editor@0.1.0-rc.1 test:mask-main-reader\n> node ../tools/web/check-mask-main-reader.mjs\n\nmask-main-reader-ok layers-splines=passed handles-feather=passed locked-editable-selection=passed" }, { "token": "web:e2e:N-022 tracking", @@ -399,9 +399,9 @@ ], "command": "npm --prefix web run test:e2e -- --workers=1 -g \"N-022 tracking\"", "exitCode": 0, - "durationMs": 4098, - "outputSha256": "1858048af0a5d9c8926a4aea37e8acf62e0ef6988f0c1e6dd4ce0c28ab4a8870", - "output": "> blender-web-editor@0.1.0 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g N-022 tracking\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:922:1 › validates N-022 tracking markers, masks, resource bindings and solve gates (1.5s)\n\n 1 passed (3.3s)" + "durationMs": 4096, + "outputSha256": "67420ec6e4a28f27f2346a7e6db835d2ca8bd281cd789371458b3d17a5693e2d", + "output": "> blender-web-editor@0.1.0-rc.1 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g N-022 tracking\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:922:1 › validates N-022 tracking markers, masks, resource bindings and solve gates (1.4s)\n\n 1 passed (3.3s)" }, { "token": "web:test:library-main-reader", @@ -410,9 +410,9 @@ ], "command": "npm --prefix web run test:library-main-reader", "exitCode": 0, - "durationMs": 712, - "outputSha256": "fa46d8ff58c3f7d52cc6b4744e47db2c80827462557fdbbec3fe504b67c356cf", - "output": "> blender-web-editor@0.1.0 test:library-main-reader\n> node ../tools/web/check-library-main-reader.mjs\n\nreports | Read library: 'resources/image_resource_library.blend', '//resources/image_resource_library.blend', parent ''\n | \u001b[2;37msource/blender/blenkernel/intern/report.cc:51 BKE_report_log\u001b[0m\nreports | \u001b[1;33mWARNING\u001b[0m Unable to open 'resources/image_resource_library.blend': No such file or directory\n | \u001b[2;37msource/blender/blenkernel/intern/report.cc:54 BKE_report_log\u001b[0m\nreports | Cannot find lib 'resources/image_resource_library.blend'\n | \u001b[2;37msource/blender/blenkernel/intern/report.cc:51 BKE_report_log\u001b[0m\nlibrary-main-reader-ok relative-path=passed readonly=passed dependency-inventory=passed" + "durationMs": 753, + "outputSha256": "30d5e1d42dd164832e6dea514753d5e72251927249c5019e87dd79b6c8eaf392", + "output": "> blender-web-editor@0.1.0-rc.1 test:library-main-reader\n> node ../tools/web/check-library-main-reader.mjs\n\nreports | Read library: 'resources/image_resource_library.blend', '//resources/image_resource_library.blend', parent ''\n | \u001b[2;37msource/blender/blenkernel/intern/report.cc:51 BKE_report_log\u001b[0m\nreports | \u001b[1;33mWARNING\u001b[0m Unable to open 'resources/image_resource_library.blend': No such file or directory\n | \u001b[2;37msource/blender/blenkernel/intern/report.cc:54 BKE_report_log\u001b[0m\nreports | Cannot find lib 'resources/image_resource_library.blend'\n | \u001b[2;37msource/blender/blenkernel/intern/report.cc:51 BKE_report_log\u001b[0m\nlibrary-main-reader-ok relative-path=passed readonly=passed dependency-inventory=passed" }, { "token": "web:e2e:N-023 asset", @@ -421,9 +421,9 @@ ], "command": "npm --prefix web run test:e2e -- --workers=1 -g \"N-023 asset\"", "exitCode": 0, - "durationMs": 4172, - "outputSha256": "e8d063ee602df3b253284024afc2dfe18ea7c12de31f0fa902ceffa9036c5f7d", - "output": "> blender-web-editor@0.1.0 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g N-023 asset\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:969:1 › validates N-023 asset catalogs, library graphs, archive budgets and IO gates (1.5s)\n\n 1 passed (3.3s)" + "durationMs": 4191, + "outputSha256": "eb7f5ba2385cdf3279dab8ede7a792d238a01f3155e8d0e08e69d4e5e606cf94", + "output": "> blender-web-editor@0.1.0-rc.1 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g N-023 asset\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:969:1 › validates N-023 asset catalogs, library graphs, archive budgets and IO gates (1.5s)\n\n 1 passed (3.3s)" }, { "token": "web:test:editor-main-reader", @@ -432,9 +432,9 @@ ], "command": "npm --prefix web run test:editor-main-reader", "exitCode": 0, - "durationMs": 691, - "outputSha256": "814ab7c0fe0c737a9cbafe6f8fe59564dcb94f9244ac4af1e7b60b9d675e815b", - "output": "> blender-web-editor@0.1.0 test:editor-main-reader\n> node ../tools/web/check-editor-main-reader.mjs\n\neditor-main-reader-ok workspaces=9 areas=36 regions=167" + "durationMs": 750, + "outputSha256": "534c21e20c5abe806079a385cacc0136c73a12f95600a66d52deef019509b8ba", + "output": "> blender-web-editor@0.1.0-rc.1 test:editor-main-reader\n> node ../tools/web/check-editor-main-reader.mjs\n\neditor-main-reader-ok workspaces=9 areas=36 regions=167" }, { "token": "web:e2e:N-024 editor", @@ -443,9 +443,9 @@ ], "command": "npm --prefix web run test:e2e -- --workers=1 -g \"N-024 editor\"", "exitCode": 0, - "durationMs": 4084, - "outputSha256": "f36025cb33bfa95624cd2c0db5aaa948ef13c768a75cbcefbc67f41feaf3e48e", - "output": "> blender-web-editor@0.1.0 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g N-024 editor\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:997:1 › validates N-024 editor context, selection sync, layout budgets and workflow gates (1.5s)\n\n 1 passed (3.3s)" + "durationMs": 4193, + "outputSha256": "79f7ba8129518e6d2819cc2e4dde8348b108ad61b5eaeb93e751cb0568bd522a", + "output": "> blender-web-editor@0.1.0-rc.1 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g N-024 editor\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:997:1 › validates N-024 editor context, selection sync, layout budgets and workflow gates (1.5s)\n\n 1 passed (3.4s)" }, { "token": "web:test:script-main-reader", @@ -454,9 +454,9 @@ ], "command": "npm --prefix web run test:script-main-reader", "exitCode": 0, - "durationMs": 700, - "outputSha256": "5d06bf4178fb048dcfc30fa197812632c84e2c2266e328b325c941290c971581", - "output": "> blender-web-editor@0.1.0 test:script-main-reader\n> node ../tools/web/check-script-main-reader.mjs\n\nscript-main-reader-ok full-source=passed sha256=passed autorun-default-deny=passed" + "durationMs": 779, + "outputSha256": "e73ad4daab4992a2e86e5e91a81d5e830c7d4604122e021da8fac36f90b37316", + "output": "> blender-web-editor@0.1.0-rc.1 test:script-main-reader\n> node ../tools/web/check-script-main-reader.mjs\n\nscript-main-reader-ok full-source=passed sha256=passed autorun-default-deny=passed" }, { "token": "web:test:scripting-isolation", @@ -465,9 +465,9 @@ ], "command": "npm --prefix web run test:scripting-isolation", "exitCode": 0, - "durationMs": 863, - "outputSha256": "d124b300b4531fae73575afdec53baff2e0656207a1b9f96969f8761e277cd25", - "output": "> blender-web-editor@0.1.0 test:scripting-isolation\n> node ../tools/web/check-scripting-isolation.mjs\n\nscripting-isolation-ok status=BLOCKED audit=DENY approved-key=sandbox-unavailable server=unavailable execution=disabled" + "durationMs": 894, + "outputSha256": "6469327e0bb1c241dc7b0c0d184ca45cbe258f56638a245663c215eaa2ab91bf", + "output": "> blender-web-editor@0.1.0-rc.1 test:scripting-isolation\n> node ../tools/web/check-scripting-isolation.mjs\n\nscripting-isolation-ok status=BLOCKED audit=DENY approved-key=sandbox-unavailable server=unavailable execution=disabled" }, { "token": "web:e2e:N-025 script", @@ -476,9 +476,9 @@ ], "command": "npm --prefix web run test:e2e -- --workers=1 -g \"N-025 script\"", "exitCode": 0, - "durationMs": 4072, - "outputSha256": "1d4a3ba828574a63106cceb1b809be66bb60d167a7c9f870c297683021954a5d", - "output": "> blender-web-editor@0.1.0 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g N-025 script\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:1017:1 › validates N-025 script policy, signatures, budgets and platform gates (1.5s)\n\n 1 passed (3.3s)" + "durationMs": 4125, + "outputSha256": "dc5463f44e788eed8372e05f0c9cfcaff9ffa31b0badb3f881c768f2dd6c6805", + "output": "> blender-web-editor@0.1.0-rc.1 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g N-025 script\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:1017:1 › validates N-025 script policy, signatures, budgets and platform gates (1.4s)\n\n 1 passed (3.3s)" }, { "token": "web:e2e:N-026 release", @@ -487,9 +487,9 @@ ], "command": "npm --prefix web run test:e2e -- --workers=1 -g \"N-026 release\"", "exitCode": 0, - "durationMs": 4106, - "outputSha256": "eeffeacdf49d91e2fbaf754723d147796dedbd25721d46a3931684a9ac32fe91", - "output": "> blender-web-editor@0.1.0 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g N-026 release\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:1040:1 › keeps N-026 release manifest deterministic and blocks missing evidence (1.5s)\n\n 1 passed (3.3s)" + "durationMs": 4146, + "outputSha256": "b9262c32aa2e913165d94cce4611a9422bcb3d66f5626317a7403c7972963e2a", + "output": "> blender-web-editor@0.1.0-rc.1 test:e2e\n> playwright test --config playwright.config.ts --workers=1 -g N-026 release\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/smoke.spec.ts:1040:1 › keeps N-026 release manifest deterministic and blocks missing evidence (1.4s)\n\n 1 passed (3.3s)" }, { "token": "web:test:v1-user-loop", @@ -498,9 +498,9 @@ ], "command": "npm --prefix web run test:v1-user-loop", "exitCode": 0, - "durationMs": 5032, - "outputSha256": "81703418e4a01edfa77fa5ca7251a37d49fe9732e0e98d8a90182162014e3a94", - "output": "> blender-web-editor@0.1.0 test:v1-user-loop\n> playwright test --config playwright.config.ts tests/e2e/v1-user-loop.spec.ts\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/v1-user-loop.spec.ts:6:1 › completes the V1 import-edit-save-restart-reopen-GLB loop (2.7s)\n\n 1 passed (4.2s)" + "durationMs": 5555, + "outputSha256": "82cbcac6791c98fa4f0effa80ab5de4f170cfc65b0883c06bf447ea45008146a", + "output": "> blender-web-editor@0.1.0-rc.1 test:v1-user-loop\n> playwright test --config playwright.config.ts tests/e2e/v1-user-loop.spec.ts\n\n\nRunning 1 test using 1 worker\n\n ✓ 1 tests/e2e/v1-user-loop.spec.ts:6:1 › completes the V1 import-edit-save-restart-reopen-GLB loop (3.0s)\n\n 1 passed (4.7s)" }, { "token": "web:test:release-evidence", @@ -509,9 +509,9 @@ ], "command": "npm --prefix web run test:release-evidence", "exitCode": 0, - "durationMs": 842, - "outputSha256": "12b1eec0e7653d11ae97fdfbecafeb0a71cab66ea5f343d9992826ce4a4fa9d0", - "output": "> blender-web-editor@0.1.0 test:release-evidence\n> node ../tools/web/check-release-evidence.mjs\n\nrelease-evidence-check-ok records=17 missing=0 status=READY" + "durationMs": 1184, + "outputSha256": "fd4d31581227c482d4f7e165cbf83a313a667a6551a069c982c086d1b90fbaec", + "output": "> blender-web-editor@0.1.0-rc.1 test:release-evidence\n> node ../tools/web/check-release-evidence.mjs\n\nrelease-evidence-check-ok records=17 missing=0 status=READY" }, { "token": "web:test:browser", @@ -520,9 +520,9 @@ ], "command": "npm --prefix web run test:browser", "exitCode": 0, - "durationMs": 6933, - "outputSha256": "beec8f6ae62d79680a1b3d5a13cc0ed75c13ed2620ce0da2c1b8db4a77a5ad13", - "output": "> blender-web-editor@0.1.0 test:browser\n> playwright test --config playwright.release.config.ts\n\n\nRunning 3 tests using 1 worker\n\n ✓ 1 [chromium] › tests/e2e/cross-browser.spec.ts:6:1 › boots the offline engine, renders SceneIR and performs a Main edit (2.6s)\n ✓ 2 [chromium] › tests/e2e/cross-browser.spec.ts:32:1 › keeps content-addressed asset recovery available in Chromium (973ms)\n ✓ 3 [chromium] › tests/e2e/cross-browser.spec.ts:51:1 › keeps the committed project after quota failure and Worker restart in Chromium (994ms)\n\n 3 passed (6.1s)" + "durationMs": 9223, + "outputSha256": "c31e3eb770f85aff43c5da17b2cb819b5a4d4bb69dfc85a9cb2319a24f7bfc12", + "output": "> blender-web-editor@0.1.0-rc.1 test:browser\n> playwright test --config playwright.release.config.ts\n\n\nRunning 3 tests using 1 worker\n\n ✓ 1 [chromium] › tests/e2e/cross-browser.spec.ts:6:1 › boots the offline engine, renders SceneIR and performs a Main edit (3.4s)\n ✓ 2 [chromium] › tests/e2e/cross-browser.spec.ts:32:1 › keeps content-addressed asset recovery available in Chromium (1.6s)\n ✓ 3 [chromium] › tests/e2e/cross-browser.spec.ts:51:1 › keeps the committed project after quota failure and Worker restart in Chromium (1.3s)\n\n 3 passed (8.1s)" }, { "token": "web:test:release-package", @@ -531,9 +531,9 @@ ], "command": "npm --prefix web run test:release-package", "exitCode": 0, - "durationMs": 5691, - "outputSha256": "e44e4a3d2b6698b700be7ed6deda864ecba337e467d341cf7dd6b43aaee8f846", - "output": "> blender-web-editor@0.1.0 test:release-package\n> npm run build && npm run release:sbom && node ../tools/web/check-release-package.mjs\n\n\n> blender-web-editor@0.1.0 build\n> tsc -p tsconfig.json && vite build --config app/vite.config.ts\n\nvite v8.2.0 building client environment for production...\n\u001b[2K\rtransforming...✓ 54 modules transformed.\nrendering chunks...\ncomputing gzip size...\ndist/index.html 0.46 kB │ gzip: 0.30 kB\ndist/assets/storage.worker-COUVNftM.js 36.81 kB\ndist/assets/web-engine.worker-CWkf48pG.js 245.76 kB\ndist/assets/viewport-render.worker-DZmZ4IRD.js 601.32 kB\ndist/assets/web_engine-CvVHxFlQ.wasm 15,048.04 kB │ gzip: 3,562.32 kB\ndist/assets/index-QI0bg0OR.css 11.41 kB │ gzip: 3.18 kB\ndist/assets/index-Cv6ZsBTp.js 973.17 kB │ gzip: 263.15 kB\n\n✓ built in 584ms\n\n> blender-web-editor@0.1.0 release:sbom\n> node ../tools/web/generate-sbom.mjs\n\nsbom-ok packages=150 sha256=aa50a5b98ebb51c98c6eced2ec32dff96b8df6d90e10cc101ce9e8eb44695060\nrelease-package-ok files=10 bytes=32096983\n\n[plugin rolldown:vite-resolve] Module \"module\" has been externalized for browser compatibility, imported by \"/home/mes123456/workinf_Blender_Wasm/web/app/src/vendor/blender/web_engine.js\". See https://vite.dev/guide/troubleshooting.html#module-externalized-for-browser-compatibility for more details.\n[plugin builtin:vite-reporter] \n(!) Some chunks are larger than 500 kB after minification. Consider:\n- Using dynamic import() to code-split the application\n- Use build.rolldownOptions.output.codeSplitting to improve chunking: https://rolldown.rs/reference/OutputOptions.codeSplitting\n- Adjust chunk size limit for this warning via build.chunkSizeWarningLimit." + "durationMs": 7028, + "outputSha256": "d087f0a9f20a7027eccb94c7a9cc6b0b67924377510582a91755629debc8de0e", + "output": "> blender-web-editor@0.1.0-rc.1 test:release-package\n> npm run build && npm run release:sbom && node ../tools/web/check-release-package.mjs\n\n\n> blender-web-editor@0.1.0-rc.1 build\n> tsc -p tsconfig.json && vite build --config app/vite.config.ts\n\nvite v8.2.0 building client environment for production...\n\u001b[2K\rtransforming...✓ 54 modules transformed.\nrendering chunks...\ncomputing gzip size...\ndist/index.html 0.46 kB │ gzip: 0.30 kB\ndist/assets/storage.worker-COUVNftM.js 36.81 kB\ndist/assets/web-engine.worker-CWkf48pG.js 245.76 kB\ndist/assets/viewport-render.worker-DZmZ4IRD.js 601.32 kB\ndist/assets/web_engine-CvVHxFlQ.wasm 15,048.04 kB │ gzip: 3,562.32 kB\ndist/assets/index-QI0bg0OR.css 11.41 kB │ gzip: 3.18 kB\ndist/assets/index-YnUA2xia.js 978.22 kB │ gzip: 264.63 kB\n\n✓ built in 877ms\n\n> blender-web-editor@0.1.0-rc.1 release:sbom\n> node ../tools/web/generate-sbom.mjs\n\nsbom-ok packages=150 sha256=7d0fb22790c44bada5f01e5ebc12f6050e1c0436a53f58dceb2e979c17bb593a\nrelease-package-ok files=14 bytes=32896131\n\n[plugin rolldown:vite-resolve] Module \"module\" has been externalized for browser compatibility, imported by \"/home/mes123456/workinf_Blender_Wasm/web/app/src/vendor/blender/web_engine.js\". See https://vite.dev/guide/troubleshooting.html#module-externalized-for-browser-compatibility for more details.\n[plugin builtin:vite-reporter] \n(!) Some chunks are larger than 500 kB after minification. Consider:\n- Using dynamic import() to code-split the application\n- Use build.rolldownOptions.output.codeSplitting to improve chunking: https://rolldown.rs/reference/OutputOptions.codeSplitting\n- Adjust chunk size limit for this warning via build.chunkSizeWarningLimit." }, { "token": "web:release:offline", @@ -542,9 +542,9 @@ ], "command": "npm --prefix web run release:offline", "exitCode": 0, - "durationMs": 36973, - "outputSha256": "e7202bf7f4d4a7fb171ad29073d92f1846951e5785f91dea2f23ea65121603ae", - "output": "> blender-web-editor@0.1.0 release:offline\n> npm run build && node ../tools/web/check-offline-reproducibility.mjs\n\n\n> blender-web-editor@0.1.0 build\n> tsc -p tsconfig.json && vite build --config app/vite.config.ts\n\nvite v8.2.0 building client environment for production...\n\u001b[2K\rtransforming...✓ 54 modules transformed.\nrendering chunks...\ncomputing gzip size...\ndist/index.html 0.46 kB │ gzip: 0.30 kB\ndist/assets/storage.worker-COUVNftM.js 36.81 kB\ndist/assets/web-engine.worker-CWkf48pG.js 245.76 kB\ndist/assets/viewport-render.worker-DZmZ4IRD.js 601.32 kB\ndist/assets/web_engine-CvVHxFlQ.wasm 15,048.04 kB │ gzip: 3,562.32 kB\ndist/assets/index-QI0bg0OR.css 11.41 kB │ gzip: 3.18 kB\ndist/assets/index-Cv6ZsBTp.js 973.17 kB │ gzip: 263.15 kB\n\n✓ built in 584ms\nsbom-ok packages=150 sha256=aa50a5b98ebb51c98c6eced2ec32dff96b8df6d90e10cc101ce9e8eb44695060\noffline-release-ok binary=7585557 source=205827355 sha256=f2903a75026a0a28615aeb5f4834a3859af83022c82bc50e28437dcbed68e549\nsbom-ok packages=150 sha256=aa50a5b98ebb51c98c6eced2ec32dff96b8df6d90e10cc101ce9e8eb44695060\noffline-release-ok binary=7585557 source=205827355 sha256=f2903a75026a0a28615aeb5f4834a3859af83022c82bc50e28437dcbed68e549\noffline-reproducibility-ok binary=f2903a75026a0a28615aeb5f4834a3859af83022c82bc50e28437dcbed68e549 source=8324d6353954ca782d84cbfd26f18a2a03fada17128d4f32c13a29e9c8aa50cc\n\n[plugin rolldown:vite-resolve] Module \"module\" has been externalized for browser compatibility, imported by \"/home/mes123456/workinf_Blender_Wasm/web/app/src/vendor/blender/web_engine.js\". See https://vite.dev/guide/troubleshooting.html#module-externalized-for-browser-compatibility for more details.\n[plugin builtin:vite-reporter] \n(!) Some chunks are larger than 500 kB after minification. Consider:\n- Using dynamic import() to code-split the application\n- Use build.rolldownOptions.output.codeSplitting to improve chunking: https://rolldown.rs/reference/OutputOptions.codeSplitting\n- Adjust chunk size limit for this warning via build.chunkSizeWarningLimit." + "durationMs": 45192, + "outputSha256": "0b59a36f3df2b4450493bfa7770e30b853cd97abdd761bef494e35ee738607e1", + "output": "> blender-web-editor@0.1.0-rc.1 release:offline\n> npm run build && node ../tools/web/check-offline-reproducibility.mjs\n\n\n> blender-web-editor@0.1.0-rc.1 build\n> tsc -p tsconfig.json && vite build --config app/vite.config.ts\n\nvite v8.2.0 building client environment for production...\n\u001b[2K\rtransforming...✓ 54 modules transformed.\nrendering chunks...\ncomputing gzip size...\ndist/index.html 0.46 kB │ gzip: 0.30 kB\ndist/assets/storage.worker-COUVNftM.js 36.81 kB\ndist/assets/web-engine.worker-CWkf48pG.js 245.76 kB\ndist/assets/viewport-render.worker-DZmZ4IRD.js 601.32 kB\ndist/assets/web_engine-CvVHxFlQ.wasm 15,048.04 kB │ gzip: 3,562.32 kB\ndist/assets/index-QI0bg0OR.css 11.41 kB │ gzip: 3.18 kB\ndist/assets/index-YnUA2xia.js 978.22 kB │ gzip: 264.63 kB\n\n✓ built in 880ms\nsbom-ok packages=150 sha256=7d0fb22790c44bada5f01e5ebc12f6050e1c0436a53f58dceb2e979c17bb593a\noffline-release-ok binary=7841801 source=206996277 sha256=8af6c782b8e4b31020219597b821160b7634439749c455fd31d9d919676e2e2e\nsbom-ok packages=150 sha256=7d0fb22790c44bada5f01e5ebc12f6050e1c0436a53f58dceb2e979c17bb593a\noffline-release-ok binary=7841801 source=206996277 sha256=8af6c782b8e4b31020219597b821160b7634439749c455fd31d9d919676e2e2e\noffline-reproducibility-ok binary=8af6c782b8e4b31020219597b821160b7634439749c455fd31d9d919676e2e2e source=ee09b3e43e715b3d5497573bbf63a449cbea146150d56c08c6506afd5fce2871\n\n[plugin rolldown:vite-resolve] Module \"module\" has been externalized for browser compatibility, imported by \"/home/mes123456/workinf_Blender_Wasm/web/app/src/vendor/blender/web_engine.js\". See https://vite.dev/guide/troubleshooting.html#module-externalized-for-browser-compatibility for more details.\n[plugin builtin:vite-reporter] \n(!) Some chunks are larger than 500 kB after minification. Consider:\n- Using dynamic import() to code-split the application\n- Use build.rolldownOptions.output.codeSplitting to improve chunking: https://rolldown.rs/reference/OutputOptions.codeSplitting\n- Adjust chunk size limit for this warning via build.chunkSizeWarningLimit." }, { "token": "web:test:release-performance", @@ -553,9 +553,9 @@ ], "command": "npm --prefix web run test:release-performance", "exitCode": 0, - "durationMs": 82653, - "outputSha256": "ac3c6ae6138f9434cf9c627d626694f08c24715b903cbfae3f1b5ce58f4faf3e", - "output": "> blender-web-editor@0.1.0 test:release-performance\n> node ../tools/web/check-release-performance.mjs\n\nrelease-performance-ok [{\"target\":100000,\"ratio\":0.9,\"inputTriangles\":100000,\"outputTriangles\":89999,\"elapsedMs\":81667,\"peakHeapBytes\":67108864,\"releasedPointerCount\":10,\"recoveryAllocation\":true},{\"target\":1000000,\"ratio\":1,\"inputTriangles\":1000000,\"outputTriangles\":1000000,\"elapsedMs\":507,\"peakHeapBytes\":346554368,\"releasedPointerCount\":10,\"recoveryAllocation\":true}]\n\nHeap resize call from 67108864 to 80543744 took 0.1827109999867389 msecs. Success: true\nHeap resize call from 80543744 to 96665600 took 0.1000789999961853 msecs. Success: true\nHeap resize call from 96665600 to 115998720 took 0.05835200000728946 msecs. Success: true\nHeap resize call from 115998720 to 139198464 took 0.03199099999619648 msecs. Success: true\nHeap resize call from 139198464 to 167051264 took 1.2570010000054026 msecs. Success: true\nHeap resize call from 167051264 to 200474624 took 1.3920889999862993 msecs. Success: true\nHeap resize call from 200474624 to 240582656 took 1.357361000002129 msecs. Success: true\nHeap resize call from 240582656 to 288751616 took 1.3448809999972582 msecs. Success: true\nHeap resize call from 288751616 to 346554368 took 1.3298830000130692 msecs. Success: true" + "durationMs": 89284, + "outputSha256": "e76cf7de997e507dbab0242f1cde2e6b291a9f99d63ef2ca2450332da16d9ea3", + "output": "> blender-web-editor@0.1.0-rc.1 test:release-performance\n> node ../tools/web/check-release-performance.mjs\n\nrelease-performance-ok [{\"target\":100000,\"ratio\":0.9,\"inputTriangles\":100000,\"outputTriangles\":89999,\"elapsedMs\":88241,\"peakHeapBytes\":67108864,\"releasedPointerCount\":10,\"recoveryAllocation\":true},{\"target\":1000000,\"ratio\":1,\"inputTriangles\":1000000,\"outputTriangles\":1000000,\"elapsedMs\":535,\"peakHeapBytes\":346554368,\"releasedPointerCount\":10,\"recoveryAllocation\":true}]\n\nHeap resize call from 67108864 to 80543744 took 0.2181620000046678 msecs. Success: true\nHeap resize call from 80543744 to 96665600 took 0.09495199999946635 msecs. Success: true\nHeap resize call from 96665600 to 115998720 took 0.04383199999574572 msecs. Success: true\nHeap resize call from 115998720 to 139198464 took 0.05545200000051409 msecs. Success: true\nHeap resize call from 139198464 to 167051264 took 1.4360670000023674 msecs. Success: true\nHeap resize call from 167051264 to 200474624 took 1.4820880000042962 msecs. Success: true\nHeap resize call from 200474624 to 240582656 took 1.6095040000072913 msecs. Success: true\nHeap resize call from 240582656 to 288751616 took 1.3340389999939362 msecs. Success: true\nHeap resize call from 288751616 to 346554368 took 1.456514999998035 msecs. Success: true" }, { "token": "web:test:malicious-blends", @@ -564,9 +564,9 @@ ], "command": "npm --prefix web run test:malicious-blends", "exitCode": 0, - "durationMs": 489, - "outputSha256": "cbac9faec5d96aa047fb40c0e21a3d06cb3eb741d943ddd55ab4188a9cc328c0", - "output": "> blender-web-editor@0.1.0 test:malicious-blends\n> node ../tools/web/check-malicious-blends.mjs\n\nmalicious-blends-ok rejected=5" + "durationMs": 507, + "outputSha256": "acd3b170723a0b560590b327a3eea3a119df2c246e46c6d849a5ccb3e8766d74", + "output": "> blender-web-editor@0.1.0-rc.1 test:malicious-blends\n> node ../tools/web/check-malicious-blends.mjs\n\nmalicious-blends-ok rejected=5" } ] } diff --git a/docs/web/CI.md b/docs/web/CI.md new file mode 100644 index 00000000..d3d522c4 --- /dev/null +++ b/docs/web/CI.md @@ -0,0 +1,47 @@ +# M6 CI contract + +The repository remote is Gitea, so the authoritative workflow is +`.gitea/workflows/m6-ci.yml`. `main` is the protected release ref. Pull requests and ordinary +pushes run quick and Chromium lanes; the release lane runs only for a `main` push or an explicit +`workflow_dispatch`. + +## Pinned runner matrix + +| Component | Pinned value | Lane | +| --- | --- | --- | +| Runner | self-hosted Debian 13 x86_64, labels `blender-web` / `blender-web-release` | all | +| Node.js | 20.19.2 | all | +| npm | lockfile-compatible npm 9 | all | +| Playwright | 1.62.1 | Chromium, release | +| Chromium | Playwright Chromium 149.0.7827.55 or `CHROME_PATH` override | Chromium, release | +| Blender | official Blender 5.2.0 LTS with USD enabled, configured by `BLENDER_BIN` | release | +| Emscripten | 3.1.69 | release | + +`BLENDER_ARCHIVE_SHA256` must identify the official Blender archive used by acceptance. VDB jobs +use `VDB_RESOURCE_ROOT`; when it is absent, tools resolve `resource-library/blender-web-vdb` +under the runner home directory. + +## Lane contents + +`npm --prefix web run ci:quick` installs from `package-lock.json`, then runs typecheck, lint, Node +tests, status consistency and release-evidence schema checks. + +`npm --prefix web run ci:chromium` runs the P0 user loop (including main-thread and Offscreen +viewports), release browser smoke, network interruption, device loss, OOM, real OPFS quota, +malicious blend and archive gates. Every browser command receives a newly allocated loopback port; +Playwright owns and cleans its server process. + +`npm --prefix web run ci:release` runs full E2E, the complete performance and VDB matrices, V1 +acceptance, reproducible offline packaging, archive cold boot, and binary/source independent +verification. + +Each lane writes `release/ci-reports/.json`, a sidecar SHA-256 and one immutable log per +command. Reports use `docs/status/ci-lane-report.schema.json` and bind the commit, lockfile, parity +ledger, engine manifest, SBOM, available archives and every command log. A failed subcommand writes +an atomic `FAILED` report before the lane exits nonzero; it cannot reuse an older READY report. + +The npm cache key is derived from `web/package-lock.json`. The Emscripten cache additionally binds +version 3.1.69 and `tools/web/emscripten-env.sh`. Release evidence, reports and archives are never +cache inputs. Artifact retention is fixed at 7 days for quick, 14 days for Chromium and 30 days for +release; the report checker runs before upload. + diff --git a/docs/web/DEPLOYMENT.md b/docs/web/DEPLOYMENT.md index 64a361fd..3a4cb9f6 100644 --- a/docs/web/DEPLOYMENT.md +++ b/docs/web/DEPLOYMENT.md @@ -13,6 +13,173 @@ Production uses HTTPS. Loopback development may use `http://127.0.0.1`; `file:// Runtime assets are same-origin. A reverse proxy must not strip the isolation, range, cache, MIME or ETag headers. +## Empty-directory install runbook + +The release delivery contains `blender-web-offline.tar.gz`, +`blender-web-corresponding-source.tar.gz` and `SHA256SUMS.txt`. Install as an unprivileged deployment +user on a Linux host with GNU `tar`, `sha256sum`, `awk`, `mktemp`, `ln` and `mv`. Start with an empty +install root; do not extract directly over a running release. + +Set explicit paths. `BLENDER_WEB_INSTALL_ROOT` must be a new or dedicated directory, never `/`, a +home directory or a shared workspace. + +```bash +BLENDER_WEB_DELIVERY=/absolute/path/to/delivery +BLENDER_WEB_INSTALL_ROOT=/srv/blender-web +BLENDER_WEB_ARCHIVE="$BLENDER_WEB_DELIVERY/blender-web-offline.tar.gz" +BLENDER_WEB_SUMS="$BLENDER_WEB_DELIVERY/SHA256SUMS.txt" + +test -f "$BLENDER_WEB_ARCHIVE" +test -f "$BLENDER_WEB_SUMS" +mkdir -p "$BLENDER_WEB_INSTALL_ROOT/releases" + +BLENDER_WEB_EXPECTED_SHA256="$(awk '$2 == "blender-web-offline.tar.gz" { print $1 }' "$BLENDER_WEB_SUMS")" +BLENDER_WEB_ACTUAL_SHA256="$(sha256sum "$BLENDER_WEB_ARCHIVE" | awk '{ print $1 }')" +test -n "$BLENDER_WEB_EXPECTED_SHA256" +test "$BLENDER_WEB_ACTUAL_SHA256" = "$BLENDER_WEB_EXPECTED_SHA256" + +tar -tzf "$BLENDER_WEB_ARCHIVE" +BLENDER_WEB_STAGE="$(mktemp -d "$BLENDER_WEB_INSTALL_ROOT/.install.XXXXXX")" +tar --no-same-owner --no-same-permissions -xzf "$BLENDER_WEB_ARCHIVE" -C "$BLENDER_WEB_STAGE" +test -f "$BLENDER_WEB_STAGE/blender-web-offline/app/index.html" +test -f "$BLENDER_WEB_STAGE/blender-web-offline/deployment-contract.json" + +BLENDER_WEB_RELEASE_DIR="$BLENDER_WEB_INSTALL_ROOT/releases/$BLENDER_WEB_ACTUAL_SHA256" +test ! -e "$BLENDER_WEB_RELEASE_DIR" +mv "$BLENDER_WEB_STAGE/blender-web-offline" "$BLENDER_WEB_RELEASE_DIR" +rmdir "$BLENDER_WEB_STAGE" +ln -s "releases/$BLENDER_WEB_ACTUAL_SHA256" "$BLENDER_WEB_INSTALL_ROOT/.current.next" +mv -Tf "$BLENDER_WEB_INSTALL_ROOT/.current.next" "$BLENDER_WEB_INSTALL_ROOT/current" +test -f "$BLENDER_WEB_INSTALL_ROOT/current/app/index.html" +``` + +Before extraction, operators must inspect the `tar -tzf` output and reject absolute paths, `..` +components, links and entries outside `blender-web-offline/`. The automated M6 gate performs these +checks before it extracts anything. The content SHA-256 is the immutable release directory name; +`current` is the only mutable pointer. The server document root is +`$BLENDER_WEB_INSTALL_ROOT/current/app`, while `deployment-contract.json` remains beside `app/`. + +## Transport preflight + +Choose and record one origin before starting the server: + +- Production: `https://[:port]`. TLS terminates at the compatible server or reverse + proxy. Plain HTTP on a public DNS name, LAN address, `0.0.0.0` or container hostname is rejected. +- Local verification only: `http://127.0.0.1:`. Do not publish the loopback-only server by + changing its bind address. +- `file://`, origins with embedded credentials and deployments below a URL path prefix are + unsupported. The application and every runtime asset must share one origin. + +An HTTPS reverse proxy must forward requests to the document root without rewriting asset paths and +must preserve every header in `responseHeaders.allResponses`. A loopback check is not evidence that a +public plain-HTTP deployment is supported. + +After the server starts, replace `BLENDER_WEB_ORIGIN` with the recorded HTTPS or loopback origin and +run: + +```bash +curl --fail --silent --show-error --head "$BLENDER_WEB_ORIGIN/" +curl --fail --silent --show-error --head "$BLENDER_WEB_ORIGIN/engine-manifest.json" +curl --fail --silent --show-error \ + --header 'Range: bytes=0-15' \ + "$BLENDER_WEB_ORIGIN/vendor/blender/single/web_engine.wasm" >/dev/null +``` + +The first two responses must contain the three isolation headers, the contract cache policy, a +strong ETag and the exact MIME type. The range request must return `206` with `Accept-Ranges`, +`Content-Range`, `Content-Length` and the same strong ETag validator. Open the recorded origin in a +new Chromium profile and require `window.isSecureContext === true`, +`window.crossOriginIsolated === true`, the manifest to be verified and the selected engine to be +ready before directing users to the release. + +## Upgrade runbook + +Keep the public origin unchanged. IndexedDB and OPFS are origin-bound; changing scheme, host or port +creates a different storage boundary and is not an upgrade. Do not clear site data, browser profiles, +OPFS, IndexedDB or the old release directory during an upgrade. + +1. Announce a maintenance window. Require active edits and saves to finish, then have users close or + reload existing tabs. A document and all of its content-hashed Workers must come from one release. +2. Install the new archive into a new content SHA-256 release directory by repeating the validation + and staging steps above, but do not change `current` yet. +3. Compare `current/release-metadata.json` with the new `release-metadata.json`. Record the old and new + product versions, engine release IDs, IndexedDB schema versions, OPFS project manifest versions, + entry assets and Worker assets. Reject a lower storage schema during upgrade. An OPFS schema change + requires an explicitly documented migration and recovery test; V1 currently declares schema `1`. +4. Start the new directory on a separate loopback-only validation port. Run the header, MIME, range, + manifest hash and browser cold-start gates before changing public traffic. +5. Export or download a backup of each critical project before the first forward-only storage + migration. The current IndexedDB schema is `6`; `onupgradeneeded` applies migrations atomically when + the new StorageWorker starts. A failed transaction must leave the old database version intact. +6. Stop admitting new sessions, then create `.current.next` pointing to the complete new release and + atomically rename it over `current`. Never switch `app/`, `engine-manifest.json`, stable engine files + or Worker files separately. +7. Revalidate `/`, `/engine-manifest.json`, one engine range, `window.isSecureContext`, + `window.crossOriginIsolated`, the selected engine and Storage schema. Reopen a saved OPFS project, + compare its revision and blend SHA-256, perform one edit/save, and only then end maintenance. + +HTML, `engine-manifest.json` and stable engine URLs remain `no-cache`; a release switch therefore +revalidates them. Content-hashed entry and Worker URLs remain immutable. A manifest `releaseId` +mismatch requires a full refresh and must not initialize an engine or open a project. If any preflight +or post-switch check fails, leave or restore `current` to the old complete release; do not delete the +new directory until diagnostics are captured, and do not delete the old directory until the rollback +window ends. + +## Rollback runbook + +Rollback changes only the `current` app/engine release pointer. It never deletes or rewrites browser +site data. Keep the public origin unchanged and retain both release directories plus the pre-upgrade +project exports throughout the rollback window. + +1. Stop new sessions and require active saves to finish. Record the current project revision and blend + SHA-256, the active `current` target, and both releases' `release-metadata.json` files. +2. Compare the browser's already-opened IndexedDB schema and OPFS project manifest schema with the + target old release. A target with the same IndexedDB schema and the same OPFS schema is directly + readable. Re-run its loopback cold-start and project-reopen checks before switching. +3. If the browser database has migrated above the old release's IndexedDB schema, in-place rollback is + `BLOCKED`: opening the older database version would fail. Do not delete or recreate the database. + Deploy a forward-compatible repair release that retains the current storage schema, or restore the + pre-upgrade project export under a separate recovery origin/profile supported by the old release. +4. If the OPFS project manifest schema differs, in-place rollback is also `BLOCKED` unless that exact + reverse reader has its own tested migration. V1 does not claim reverse OPFS migrations. +5. For a compatible target, create `.current.next` pointing to the complete old content-hash directory + and atomically rename it over `current`. Never copy individual HTML, manifest, engine or Worker files. +6. Revalidate transport, cache, manifest and engine identity. Reopen the same project and require its + revision and blend SHA-256 to match the pre-rollback values before allowing one edit/save. + +If post-switch validation fails, atomically restore `current` to the newer release. Capture diagnostics +before removing a failed target. Browser data, the newer release and project exports remain untouched. + +## Failure diagnostics + +The machine-readable source is `operations-diagnostics.json`. Capture the active release metadata, +origin, failing URL, response headers, stable error code and project revision before recovery. + +| Domain | Primary signal | Confirm | Recovery and data boundary | +| --- | --- | --- | --- | +| MIME | `DEPLOYMENT_MIME_MISMATCH` or streaming/module refusal | HEAD the URL; compare `Content-Type` with the contract | Fix the MIME map and repeat HEAD. Do not clear project storage. | +| Range | `DEPLOYMENT_RANGE_INVALID`, `416`, failed resume | Request `bytes=0-15`; inspect `206`, range headers, ETag and If-Range | Fix byte ranges; discard only partial bytes whose ETag changed. Keep verified OPFS bytes. | +| Isolation | `PLATFORM_CAPABILITY_UNAVAILABLE`, no SharedArrayBuffer | Verify HTTPS or `127.0.0.1`, all three isolation headers and both browser flags | Restore headers/same-origin assets or use the gated single variant. Do not open through a blocked pthread path. | +| Hash | `ENGINE_VARIANT_INTEGRITY_FAILED` | Re-fetch no-cache manifest; hash JS/WASM/Worker and compare one `releaseId` | Restore one complete release and reload. No fallback or project open is allowed on mismatch. | +| Quota | `STORAGE_QUOTA` or `QuotaExceededError` | Record storage estimate and compare committed revision/SHA-256 | Export the project and remove only selected disposable caches. Never clear all site data. | +| Worker | `WORKER_TERMINATED` or Worker load failure | HEAD the hashed Worker; compare MIME/cache/path with release metadata | Reload one release, restart Worker and reopen the verified revision. Reject late results. | +| GPU | `GPU_DEVICE_LOST` or a GPU budget code | Record loss reason, limits/resident bytes and unchanged project revision | Release/recreate viewport resources or reduce budget. Never rewrite Main/OPFS for GPU recovery. | + +Run `npm --prefix web run test:operations-diagnostics` to validate all seven entries against the +deployment contract and the packaged documentation. + +## Fresh-directory rehearsal + +Before freezing an RC, run `npm --prefix web run test:operations-rehearsal`. It creates one new +temporary root and executes delivery checksum/path validation, initial install, loopback HTTP +preflight, project seeding, complete-release upgrade, HTTP revalidation, compatible rollback and a +final HTTP/project-integrity check in that order. It never uses an existing install directory. + +The machine report is `release/operations-reports/rehearsal.json`. Every record contains the runbook +command, exit code, duration and observed output. `READY` requires all records to pass, the same +project revision and SHA-256 before/after both switches, both release directories to remain present, +and cleanup of the temporary rehearsal root after the report is assembled. + ## Cache policy - `/` and `/index.html`: `Cache-Control: no-cache` so a deployment is revalidated. @@ -21,6 +188,11 @@ ETag headers. - `/vendor/blender/*`: `Cache-Control: no-cache`; these stable URLs are verified by the engine manifest. - Other paths: `Cache-Control: no-cache` until a more specific content-addressed rule exists. +Responses carry a strong content SHA-256 ETag. A matching `If-None-Match` returns `304` with no body; +after HTML, manifest or a stable engine asset changes, the old validator returns the new complete response +with `200` and a different ETag. Immutable `/assets/*` names must include the Vite content hash and are +never reused for different bytes. + The server must use the MIME map in the JSON contract. In particular, WebAssembly is `application/wasm`, JavaScript is `text/javascript; charset=utf-8`, and NanoVDB is `application/x-nanovdb`. @@ -32,5 +204,9 @@ The server must use the MIME map in the JSON contract. In particular, WebAssembl unsatisfied range returns `416`. An `If-Range` mismatch ignores the range and returns the complete resource with status `200`; partial bytes from a different revision must never be combined. -Run `node tools/web/check-deployment-contract.mjs` for the static contract gate. Production HTTP -behavior is a separate M6 acceptance gate and must exercise an actual server before release. +Run `node tools/web/check-deployment-contract.mjs` for the static contract gate and +`npm --prefix web run test:deployment-runbook` for the fresh-directory install and transport +preflight gate. Run `npm --prefix web run test:upgrade-runbook` for the two-release manifest, cache, +storage schema, Worker and atomic-switch gate, and `npm --prefix web run test:rollback-runbook` for +compatible and blocked-old-reader rollback paths. Production HTTP behavior is a separate M6 +acceptance gate and must exercise an actual server before release. diff --git a/docs/web/KNOWN_LIMITATIONS.md b/docs/web/KNOWN_LIMITATIONS.md new file mode 100644 index 00000000..bdeafe9d --- /dev/null +++ b/docs/web/KNOWN_LIMITATIONS.md @@ -0,0 +1,68 @@ +# Web Blender Modeler V1 Known Limitations + +These limits apply to `0.1.0-rc.1`. A successful bounded gate does not imply complete Blender 5.2 +parity or support beyond the declared operation, fixture, resource budget and browser configuration. +See [V1_SCOPE.md](V1_SCOPE.md) and [parity-ledger.json](parity-ledger.json) for the authoritative +capability boundary. + +## Browser and deployment + +- Chromium is the only V1 browser baseline. Firefox, WebKit, mobile browsers, touch, pen, IME and + non-Chromium accessibility compatibility are not release claims. +- Production requires HTTPS. `http://127.0.0.1` is allowed for local verification; public plain HTTP + and `file://` are unsupported. All app, Worker and engine assets must remain same-origin. +- The base viewport uses WebGL2. OffscreenCanvas is a second tested production path. WebGPU is used + only for the declared bounded NanoVDB path and is subject to adapter availability and limits. + +## Single-thread and pthread selection + +- `AUTO` selects pthread only when `crossOriginIsolated`, `SharedArrayBuffer` and Worker capability + gates are all ready. Otherwise it selects the single-thread variant and reports the pthread gate. +- A pthread initialization failure under `AUTO` is cleaned up before one single-thread attempt. A + resource request failure outside this path remains an error. +- A JS, WASM or pthread Worker SHA-256 mismatch is fatal + (`ENGINE_VARIANT_INTEGRITY_FAILED`): there is no integrity fallback and no project is opened. +- `PTHREAD_REQUIRED` blocks when its platform gate is not ready. `SINGLE_REQUIRED` never attempts + pthread. A mixed app/manifest `releaseId` returns `REFRESH_REQUIRED` before engine initialization or + project open; a full reload is required. +- Both variants declare 256 initial WebAssembly pages (16 MiB) and a 32,768-page ceiling (2 GiB). + This is a manifest ceiling, not a memory reservation or availability guarantee; Chromium, the OS or + the device can reject growth earlier. + +## Project storage + +- OPFS and IndexedDB are bound to the exact scheme, host and port. Moving between origins does not + migrate projects. Clearing site data or a browser profile deletes locally stored projects and caches. +- Chromium and the operating system control quota. V1 reserves no minimum capacity and cannot infer + that `navigator.storage.estimate()` free space will remain available through a save. +- Atomic save preserves the last committed revision on quota failure, but the new revision is not + durable until save succeeds. Export critical projects before upgrades and before deleting caches. +- IndexedDB schema migration is forward-only. OPFS project manifest schema has no general reverse + migration. An older app is blocked when it cannot read the current schema. + +## CPU, WASM and GPU budgets + +- The RC gates cover 100k, 1M and 10M geometry fixtures; they are not an unlimited scene-size claim. + Imports and operations can block earlier when their own vertex, element, transfer, time or memory + budgets are exceeded. +- A texture asset is limited by protocol to 64 MiB, 16,384 pixels per dimension and 256 requested + assets per scene. The actual WebGL `MAX_TEXTURE_SIZE`, address space and GPU memory may be lower. + The release gate exercised 4K and 8K textures, not every format or 16K residency combination. +- VDB input is bounded to 512 MiB, a NanoVDB bundle to 1 GiB, each chunk to 16 MiB and declared GPU + residency to at most 512 MiB. Actual `maxStorageBufferBindingSize` and `maxBufferSize` may be lower. +- NanoVDB pages are explicit and LRU-bounded. Automatic viewport page-fault feedback, depth-composed + production demand paging and an unbounded multi-grid material system are not included in V1. +- GPU device loss or budget failure releases and recreates viewport resources where supported; it does + not modify Blender Main or OPFS project bytes. A reduced scene or budget may still be required. + +## Blender feature scope + +Complete PBVH sculpt/paint, arbitrary Geometry Nodes and Shader evaluation, full physics solvers, +Cycles, final video encoding, Python/Text autorun, add-ons and native GPU backends are either bounded, +server-only or excluded. The exact family slices and stable blockers are in +[parity-ledger.json](parity-ledger.json); unsupported data must be preserved or explicitly blocked, +not reported as executed. + +Use [DEPLOYMENT.md](DEPLOYMENT.md) for installation and rollback requirements, and +[operations-diagnostics.json](operations-diagnostics.json) for stable failure signals and data-safe +recovery boundaries. diff --git a/docs/web/RELEASE_NOTES.md b/docs/web/RELEASE_NOTES.md new file mode 100644 index 00000000..784e2178 --- /dev/null +++ b/docs/web/RELEASE_NOTES.md @@ -0,0 +1,60 @@ +# Web Blender Modeler V1 0.1.0-rc.1 Release Notes + +Release candidate identity: `web-blender-0.1.0-rc.1`, engine +`blender-wasm-0.1.0-rc.1`. + +This candidate is a Chromium-only browser modeler built around a bounded Blender 5.2 Main/WebEngine +subset. It is not a browser port of the complete Blender desktop application. The normative product +boundary and capability definitions are in [V1_SCOPE.md](V1_SCOPE.md); the machine-readable family +status and exact required/blocked slices are in [parity-ledger.json](parity-ledger.json). + +## Verified V1 capabilities + +- Import `.blend`, edit the declared Object, Mesh and Principled material subset, undo, redo, save + atomically, restart the Storage and WebEngine Workers, reopen, and export a semantically checked GLB. +- Preserve stable object, mesh and material identities across save/reopen and verify both the + main-thread WebGL and OffscreenCanvas Worker production viewports with non-empty pixels. +- Select integrity-checked single-thread or pthread WebEngine artifacts from one versioned engine + manifest. The pthread variant is used only when the isolated platform prerequisites pass. +- Store projects, snapshots and bounded assets in origin-bound OPFS/IndexedDB, including tested + interruption, Worker restart, quota failure and recovery behavior. +- Exercise bounded 100k, 1M and 10M geometry, 4K/8K textures, 600-frame simulation cache and + one-million-frame media indexing gates. +- Exercise deterministic WASM, OPFS, GPU and NanoVDB out-of-memory recovery, WebGL device loss, + network interruption, malformed `.blend` input and malicious archive rejection. +- Deliver deterministic offline binary and corresponding-source archives with SHA-256 checksums, + SPDX SBOM, licenses, source offer, deployment contract and operations diagnostics. +- Reproduce quick, Chromium and release CI lanes with lockfile, source, engine, archive and per-command + log hash bindings. + +## Capability boundaries + +`LOCAL_EXACT` and `LOCAL_BOUNDED` mean only the fixtures, operations and budgets declared in +[V1_SCOPE.md](V1_SCOPE.md) and [parity-ledger.json](parity-ledger.json). Unsupported operations must +remain blocked or preserved; the release does not infer support from a readable Blender data block. + +`SERVER` covers validated request/result boundaries for work such as Cycles rendering, complex physics +bakes and final video encoding. This offline candidate does not bundle or configure those services and +does not claim local-equivalent execution. + +`EXCLUDED` includes arbitrary Python/Text autorun, add-on installation, native desktop windows and +native CUDA, Metal, HIP or OptiX backends. The UI must not report those operations as successful. + +All 12 V1 family release slices are `READY`, while all 12 complete Blender 5.2 family parity states are +`BLOCKED`. The exact blocked and excluded slice names remain authoritative in +[parity-ledger.json](parity-ledger.json); this release note does not convert them to completed work. + +## Delivery evidence + +Verify `SHA256SUMS.txt`, then verify `RC_MANIFEST.json.sha256` and `RC_MANIFEST.json` before deployment. +The manifest binds the RC version, base commit, engine release ID, package lock, ledger, embedded release +metadata, SBOM, binary/source archives and operations reports. + +Read [Known limitations](KNOWN_LIMITATIONS.md) before deployment, especially the browser, engine +variant, origin-bound storage, quota, WASM and GPU budget boundaries. + +Use [Release recovery](RELEASE_RECOVERY.md) to verify delivery evidence, export project backups and +handle pre-switch failures, compatible rollback or blocked schema downgrade. + +Deployment requirements and operator commands are in [DEPLOYMENT.md](DEPLOYMENT.md). Stable error +signals and recovery boundaries are in [operations-diagnostics.json](operations-diagnostics.json). diff --git a/docs/web/RELEASE_RECOVERY.md b/docs/web/RELEASE_RECOVERY.md new file mode 100644 index 00000000..5a4ec53d --- /dev/null +++ b/docs/web/RELEASE_RECOVERY.md @@ -0,0 +1,105 @@ +# Web Blender Modeler V1 Release Recovery + +Use this procedure for `0.1.0-rc.1` upgrades and failed deployments. The complete installation, +upgrade and rollback contract remains [DEPLOYMENT.md](DEPLOYMENT.md). Never clear Chromium site data, +delete a browser profile, overwrite a release directory or downgrade a storage schema as a recovery +shortcut. + +## Verify the delivery + +The delivery directory must contain `blender-web-offline.tar.gz`, +`blender-web-corresponding-source.tar.gz`, `SHA256SUMS.txt`, `RC_MANIFEST.json` and +`RC_MANIFEST.json.sha256`. Verify bytes before extracting: + +```bash +cd /absolute/path/to/delivery +sha256sum --check SHA256SUMS.txt +sha256sum --check RC_MANIFEST.json.sha256 +``` + +Both commands must report `OK`. Check that the manifest identity is +`web-blender-0.1.0-rc.1`, its commit and `engineReleaseId` match the release record, and its binary, +source and SBOM hashes match the delivered files. In a corresponding source checkout, independently +run: + +```bash +npm --prefix web ci --ignore-scripts +npm --prefix web run test:rc-manifest +npm --prefix web run test:binary-archive +npm --prefix web run test:source-archive +node tools/web/check-ci-report.mjs release/ci-reports/quick.json \ + release/ci-reports/chromium.json release/ci-reports/release.json +``` + +Do not deploy when any command fails or when a report is not `READY` and bound to the manifest commit, +lockfile, ledger, engine and archive hashes. + +## Back up projects before upgrade + +1. Record the exact public origin, including scheme, host and port. Upgrades must retain that origin + because IndexedDB and OPFS data are origin-bound. +2. For every critical project, finish active edits and use the top-bar **Save Project** action. Wait + for the committed/saved state and retain the downloaded `blender-web.blend` outside the browser + profile and outside the deployment install root. +3. Record the project's displayed SceneIR revision and calculate the external backup hash with + `sha256sum blender-web.blend`. Reopen the downloaded file with the current release and confirm the + expected objects before entering the maintenance window. +4. Record `readlink current`, the old binary archive SHA-256 and both old/new + `release-metadata.json` files. Keep the old content-hash release directory, new staged directory, + external project backups and browser profile through the rollback window. + +A backup is not complete merely because OPFS still contains a project. The external `.blend`, revision, +SHA-256, origin and active release identity form the recovery record. + +## Upgrade failure before the switch + +If checksum, archive path, header, MIME, range, engine hash, Worker or cold-start preflight fails before +`current` changes, leave `current` on the old release. Remove only the incomplete staging directory +after diagnostics are captured. Do not change IndexedDB, OPFS, browser caches or the old release. + +Repeat the delivery checks and the loopback preflight from [DEPLOYMENT.md](DEPLOYMENT.md). A failed +candidate remains uninstalled until its binary hash and all preflight evidence pass. + +## Upgrade failure after the switch + +Stop new sessions and require active saves to finish. Capture the active origin, `current` target, +both release metadata files, failing URL/headers, error code, project revision and project SHA-256. + +Compare the browser's opened IndexedDB and OPFS schema versions with the old target: + +- If the IndexedDB versions match and the OPFS project manifest versions match, validate the complete + old release on a loopback port. Atomically repoint `current` to that old content-hash directory using + the rollback commands in [DEPLOYMENT.md](DEPLOYMENT.md). Revalidate transport and engine identity, + reopen the same project, and require the recorded revision and blend SHA-256 before allowing an edit. +- If the old IndexedDB schema is lower, rollback is `BLOCKED` with + `INDEXEDDB_SCHEMA_DOWNGRADE_UNSUPPORTED`. Do not open, delete or recreate the database with the old app. +- If the OPFS schema differs without an exact tested reverse reader, rollback is `BLOCKED` with + `OPFS_REVERSE_MIGRATION_UNDECLARED`. V1 does not claim a general reverse OPFS migration. + +For a blocked rollback, keep or restore the newer compatible app release. Deploy a forward-compatible +repair using the current storage schemas, or start the old release on a separate recovery origin/profile +and import an external pre-upgrade `.blend` backup. Never point the old app at newer incompatible site +data. + +## Restore and prove project integrity + +After a compatible rollback or repair: + +1. Open the recorded origin in a new Chromium tab and confirm the expected release/engine identity. +2. Use **Recover Project** for unchanged compatible origin storage. If that fails or a separate recovery + origin is required, use **Open .blend** and select the external backup. +3. Confirm the recorded objects and revision, use **Save Project**, then hash the new downloaded + `blender-web.blend`. The hash must equal the recorded backup unless a deliberate post-recovery edit + was made. +4. Keep the failed release, logs, diagnostics and external backup until the recovery record contains the + final origin, release ID, revision and SHA-256. + +The automated rehearsal command is: + +```bash +npm --prefix web run test:operations-rehearsal +``` + +It verifies delivery, fresh install, HTTP preflight, project revision/SHA-256 preservation, upgrade, +compatible rollback and cleanup in one new temporary root. It does not replace real project exports or +authorize a schema downgrade. diff --git a/docs/web/engine-manifest-v2.md b/docs/web/engine-manifest-v2.md new file mode 100644 index 00000000..3b49f9d4 --- /dev/null +++ b/docs/web/engine-manifest-v2.md @@ -0,0 +1,61 @@ +# Engine Manifest Schema v2 + +`M6-04A` 冻结双 variant 的数据合同和纯校验器。`M6-04B` 已将生产 +`web/app/public/engine-manifest.json` 切换到 schema v2，并从两个独立构建目录把资产安装到 +`/vendor/blender/single/` 与 `/vendor/blender/pthread/`。纯策略选择和双环境实机加载已由 +`M6-04C-G` 完成；旧 single Worker 入口继续作为 `M6-05` fallback 接线前的完整 Main 兼容路径。 + +## 顶层合同 + +- `schemaVersion` 固定为 `2`，`protocolVersion` 固定为 `1`，`engine` 固定为 + `blender-wasm`。 +- `releaseId` 是整个 manifest 的原子发布身份；single/pthread 及其 JS、WASM、worker 摘要 + 必须作为同一份 manifest 一起切换，调用方不得从另一 release 补资源。 +- `variants` 必须恰好包含一个 `single` 和一个 `pthread`，不能有第三种或重复 variant。 +- single 与 pthread 的 JS URL 必须不同，WASM URL 也必须不同，避免通过通用路径隐含构建类型。 + +## 资源合同 + +每项资源都必须声明 `fileName`、同源根路径 `url` 和小写 64 位十六进制 SHA-256： + +| variant | 必需资源 | 禁止资源 | +| --- | --- | --- | +| `single` | `resources.js`、`resources.wasm` | `resources.pthreadWorker` | +| `pthread` | `resources.js`、`resources.wasm`、`resources.pthreadWorker` | 无 | + +JS 与 pthread worker 文件名必须以 `.js` 结尾，WASM 文件名必须以 `.wasm` 结尾；URL 的最后一段 +必须与 `fileName` 完全一致。资源 URL 不允许远程 origin、query、fragment、反斜线或路径穿越。 +`pthreadWorker` 表示 worker 加载角色，不强制是第四个物理文件：当前 Emscripten pthread 输出会 +让 worker 重新加载同一个 pthread ES module，因此该角色可以与 `resources.js` 使用相同的 +`fileName`、`url` 和 SHA-256；同一 URL 不允许声明不同摘要。worker 不得引用 single 的 JS。 +若后续工具链产生独立 worker 文件，则三个字段必须描述该文件。 + +## 内存合同 + +WASM page 固定为 65,536 bytes。每个 variant 都独立声明 `initialPages`、`maximumPages` 和 +`shared`： + +- `initialPages` 范围为 256 至 32,768 pages，即 16 MiB 至 2 GiB。 +- `maximumPages` 不得小于 `initialPages`，且不得超过 32,768 pages（2 GiB）。 +- single 必须为 `shared=false`；pthread 必须为 `shared=true`。 + +权威 TypeScript 类型和无 I/O 校验器位于 `web/protocol/manifest.ts`；结构化正例位于 +`tests/golden/M6-04A/engine-manifest-v2.json`。校验器只接收输入并返回深层新对象或抛出带稳定 +`code`/`path` 的 `WebEngineManifestValidationError`，不读取文件、不请求网络，也不选择运行时 +variant。 + +安装命令为 `bash tools/web/install-web-engine-assets.sh`。默认读取 `build_web-single` 和 +`build_web-pthread`，先在临时目录生成并复核 manifest，再安装四个物理文件。专项命令 +`npm --prefix web run test:engine-variant-install` 同时覆盖正常复制、同一构建目录拒绝、缺失资产 +拒绝和失败不改写目标 manifest。 + +纯选择器位于 `web/protocol/engine-variant.ts`，策略为 `AUTO`、`SINGLE_REQUIRED` 和 +`PTHREAD_REQUIRED`。它不读取 DOM、网络、存储或 Worker；调用方必须显式传入已校验 manifest +和三项线程能力。`PTHREAD_REQUIRED` 被阻断时不返回 variant。专项命令为 +`npm --prefix web run test:engine-variant-selection`、`npm --prefix web run test:pthread-engine` 和 +`npm --prefix web run test:single-thread-unisolated`。 + +升级入口为 `bootstrapWebEngineRelease`。旧 HTML 绑定的 expected release 与重新验证后的 manifest +不一致时只返回 `REFRESH_REQUIRED`，不会选择或初始化 variant，也不会打开待处理项目。资源 +SHA-256 不一致统一返回 `ENGINE_VARIANT_INTEGRITY_FAILED`；该错误不可进入 pthread -> single +fallback。`npm --prefix web run test:engine-upgrade-safety` 同时覆盖纯策略和真实 Chromium 篡改响应。 diff --git a/docs/web/operations-diagnostics.json b/docs/web/operations-diagnostics.json new file mode 100644 index 00000000..56a8fbad --- /dev/null +++ b/docs/web/operations-diagnostics.json @@ -0,0 +1,69 @@ +{ + "schemaVersion": 1, + "product": "Web Blender Modeler V1", + "entries": [ + { + "id": "OPS-MIME", + "domain": "mime", + "signals": ["DEPLOYMENT_MIME_MISMATCH", "WebAssembly.instantiateStreaming failed", "module script refused"], + "checks": ["HEAD the failing URL and record Content-Type", "compare the extension with deployment-contract.json mimeTypes"], + "expected": [".wasm application/wasm", ".js text/javascript; charset=utf-8", ".json application/json; charset=utf-8"], + "recovery": ["fix the server MIME map", "restart or reload proxy configuration", "repeat HEAD before refreshing Chromium"], + "dataSafety": "Do not clear OPFS or IndexedDB; MIME failures occur before project bytes need mutation." + }, + { + "id": "OPS-RANGE", + "domain": "range", + "signals": ["DEPLOYMENT_RANGE_INVALID", "HTTP 416", "partial resource resume failed"], + "checks": ["GET the resource with Range: bytes=0-15", "record status, Accept-Ranges, Content-Range, Content-Length and ETag", "repeat with matching and mismatching If-Range"], + "expected": ["valid single range returns 206", "invalid or unsatisfied range returns 416", "If-Range mismatch returns full 200"], + "recovery": ["enable single byte ranges without compression rewriting", "preserve strong ETag validators", "discard partial bytes from a different ETag before retry"], + "dataSafety": "Never append bytes across different ETags; retain the last verified OPFS asset and project commit." + }, + { + "id": "OPS-ISOLATION", + "domain": "isolation", + "signals": ["PLATFORM_CAPABILITY_UNAVAILABLE", "crossOriginIsolated false", "SharedArrayBuffer unavailable"], + "checks": ["confirm HTTPS or explicit http://127.0.0.1 loopback", "HEAD the document and error routes", "evaluate window.isSecureContext and window.crossOriginIsolated"], + "expected": ["Cross-Origin-Opener-Policy same-origin", "Cross-Origin-Embedder-Policy require-corp", "Cross-Origin-Resource-Policy same-origin"], + "recovery": ["restore the three headers on every response", "remove cross-origin runtime assets", "use the single variant only when the pthread capability gate is BLOCKED"], + "dataSafety": "Do not open a pending project through a blocked pthread path; correcting headers does not require storage deletion." + }, + { + "id": "OPS-HASH", + "domain": "hash", + "signals": ["ENGINE_VARIANT_INTEGRITY_FAILED", "ENGINE_VARIANT_RESOURCE_HASH_MISMATCH", "manifest rejected"], + "checks": ["fetch engine-manifest.json with no-cache", "hash the exact JS, WASM and pthread Worker response bytes", "compare releaseId and every declared SHA-256"], + "expected": ["one releaseId binds both variants", "resource SHA-256 equals the manifest", "integrity failure performs no fallback and no project open"], + "recovery": ["restore one complete immutable release", "purge only the corrupt HTTP cache entry", "reload the document and revalidate the manifest"], + "dataSafety": "Keep the project unopened until all resource hashes pass; never repair integrity by editing project data." + }, + { + "id": "OPS-QUOTA", + "domain": "quota", + "signals": ["STORAGE_QUOTA", "QuotaExceededError", "OPFS staging write failed"], + "checks": ["record navigator.storage.estimate usage and quota", "compare the committed project revision and SHA-256", "inspect staging and cache categories without deleting the committed blend"], + "expected": ["old committed revision remains readable", "failed staging is not promoted", "Worker restart reports the same committed SHA-256"], + "recovery": ["export the committed project", "remove explicitly selected disposable caches", "request persistent storage or free origin quota before retry"], + "dataSafety": "Never delete scene.blend, its verified manifest or all site data as a quota recovery shortcut." + }, + { + "id": "OPS-WORKER", + "domain": "worker", + "signals": ["WORKER_TERMINATED", "Worker script load failed", "pending request aborted"], + "checks": ["HEAD the content-hashed Worker URL", "confirm JavaScript MIME and immutable cache", "compare Worker assets with release-metadata.json", "capture pending request and resource counters"], + "expected": ["all Workers belong to the current release", "terminated Worker publishes no late result", "restart rediscovers the committed project"], + "recovery": ["reload to one complete current release", "restart the affected Worker", "reopen the last verified project revision"], + "dataSafety": "Do not promote late Worker output or remove OPFS while recovering a Worker." + }, + { + "id": "OPS-GPU", + "domain": "gpu", + "signals": ["GPU_DEVICE_LOST", "GPU_TEXTURE_BUDGET_EXCEEDED", "NANOVDB_GPU_BUDGET_EXCEEDED"], + "checks": ["record WebGL context loss or WebGPU device.lost reason", "record adapter limits and requested resident bytes", "confirm CPU, WASM and OPFS project revision did not change"], + "expected": ["GPU resources release once", "bounded recovery recreates the viewport", "persistent project SHA-256 remains stable"], + "recovery": ["reduce texture or NanoVDB resident budget", "recreate the viewport after device recovery", "reload the current release if bounded recovery fails"], + "dataSafety": "GPU recovery may discard viewport resources only; it must not rewrite Main or the committed project." + } + ] +} diff --git a/docs/web/sbom.spdx.json b/docs/web/sbom.spdx.json index b03c58b4..c56c301a 100644 --- a/docs/web/sbom.spdx.json +++ b/docs/web/sbom.spdx.json @@ -3,7 +3,7 @@ "dataLicense": "CC0-1.0", "SPDXID": "SPDXRef-DOCUMENT", "name": "blender-web-editor-sbom", - "documentNamespace": "https://blender-web.local/spdx/e62e3ed568907b9c7d85050e4f2b6bd874d425cca768a0201c3c57cdd9ad9926", + "documentNamespace": "https://blender-web.local/spdx/cf7beefe71131e5d51b45ffa79b7b906b21decc743fc7eafd7cf6791996dea37", "creationInfo": { "created": "1970-01-01T00:00:00Z", "creators": [ @@ -3283,7 +3283,7 @@ { "SPDXID": "SPDXRef-Package-blender-web-editor", "name": "blender-web-editor", - "versionInfo": "0.1.0", + "versionInfo": "0.1.0-rc.1", "downloadLocation": "NOASSERTION", "filesAnalyzed": false, "licenseConcluded": "NOASSERTION", @@ -3292,7 +3292,7 @@ "checksums": [ { "algorithm": "SHA256", - "checksumValue": "e7b16da68885fe43f32ab7b3eeb2c037b4fd8bf54fe6d5e77049aa51e294b1fb" + "checksumValue": "87af8e7d5eb36537541cf941699868a010c1fcea305daa3ce5385453e8fa4557" } ] }, diff --git a/tests/golden/M6-04A/engine-manifest-v2.json b/tests/golden/M6-04A/engine-manifest-v2.json new file mode 100644 index 00000000..40283172 --- /dev/null +++ b/tests/golden/M6-04A/engine-manifest-v2.json @@ -0,0 +1,54 @@ +{ + "schemaVersion": 2, + "protocolVersion": 1, + "releaseId": "blender-wasm-0.1.0", + "engineVersion": "blender-wasm-0.1.0", + "engine": "blender-wasm", + "variants": [ + { + "id": "single", + "memory": { + "initialPages": 256, + "maximumPages": 32768, + "shared": false + }, + "resources": { + "js": { + "fileName": "web_engine.js", + "url": "/vendor/blender/single/web_engine.js", + "sha256": "1111111111111111111111111111111111111111111111111111111111111111" + }, + "wasm": { + "fileName": "web_engine.wasm", + "url": "/vendor/blender/single/web_engine.wasm", + "sha256": "2222222222222222222222222222222222222222222222222222222222222222" + } + } + }, + { + "id": "pthread", + "memory": { + "initialPages": 256, + "maximumPages": 32768, + "shared": true + }, + "resources": { + "js": { + "fileName": "web_engine.js", + "url": "/vendor/blender/pthread/web_engine.js", + "sha256": "3333333333333333333333333333333333333333333333333333333333333333" + }, + "wasm": { + "fileName": "web_engine.wasm", + "url": "/vendor/blender/pthread/web_engine.wasm", + "sha256": "4444444444444444444444444444444444444444444444444444444444444444" + }, + "pthreadWorker": { + "fileName": "web_engine.js", + "url": "/vendor/blender/pthread/web_engine.js", + "sha256": "3333333333333333333333333333333333333333333333333333333333333333" + } + } + } + ] +} diff --git a/tools/web/archive-deployment-server.mjs b/tools/web/archive-deployment-server.mjs new file mode 100644 index 00000000..06e7787f --- /dev/null +++ b/tools/web/archive-deployment-server.mjs @@ -0,0 +1,70 @@ +import assert from "node:assert/strict"; +import fs from "node:fs"; +import os from "node:os"; +import path from "node:path"; +import { execFileSync } from "node:child_process"; +import { fileURLToPath } from "node:url"; +import { + createDeploymentHttpServer, + listenDeploymentHttpServer, + loadDeploymentContract, +} from "./deployment-http-server.mjs"; + +const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."); + +function option(name, fallback) { + const index = process.argv.indexOf(name); + return index >= 0 ? process.argv[index + 1] : fallback; +} + +function assertSafeArchiveEntries(archive) { + const entries = execFileSync("tar", ["-tzf", archive], { encoding: "utf8" }) + .split("\n") + .filter(Boolean); + assert.ok(entries.length > 0, "binary archive is empty"); + for (const entry of entries) { + assert.ok(!entry.startsWith("/"), `binary archive contains an absolute path: ${entry}`); + assert.ok(!entry.split("/").includes(".."), `binary archive contains path traversal: ${entry}`); + assert.ok(entry === "blender-web-offline/" || entry.startsWith("blender-web-offline/"), `unexpected binary archive root: ${entry}`); + } +} + +const archive = path.resolve(option("--archive", path.join(repoRoot, "release/blender-web-offline.tar.gz"))); +const port = Number.parseInt(option("--port", process.env.WEB_TEST_PORT ?? "5189"), 10); +assert.ok(fs.statSync(archive).isFile(), `binary archive is missing: ${archive}`); +assert.ok(Number.isSafeInteger(port) && port > 0 && port < 65536, `invalid deployment port: ${port}`); +assertSafeArchiveEntries(archive); + +const workspace = fs.mkdtempSync(path.join(os.tmpdir(), "blender-archive-server-")); +execFileSync("tar", ["--no-same-owner", "--no-same-permissions", "-xzf", archive, "-C", workspace]); +const bundleRoot = path.join(workspace, "blender-web-offline"); +const staticRoot = path.join(bundleRoot, "app"); +assert.ok(fs.statSync(path.join(staticRoot, "index.html")).isFile(), "extracted binary archive has no app/index.html"); +assert.ok(!staticRoot.startsWith(`${repoRoot}${path.sep}`), "archive server must not serve a workspace directory"); + +const contract = loadDeploymentContract(path.join(bundleRoot, "deployment-contract.json")); +const server = createDeploymentHttpServer({ root: staticRoot, contract }); +let closing = false; + +async function close(exitCode = 0) { + if (closing) return; + closing = true; + await new Promise((resolve) => server.close(() => resolve())); + fs.rmSync(workspace, { recursive: true, force: true }); + process.exit(exitCode); +} + +process.once("SIGINT", () => void close(0)); +process.once("SIGTERM", () => void close(0)); +process.once("uncaughtException", (error) => { + process.stderr.write(`${error.stack ?? error}\n`); + void close(1); +}); +process.once("unhandledRejection", (error) => { + process.stderr.write(`${error instanceof Error ? error.stack : String(error)}\n`); + void close(1); +}); + +const origin = await listenDeploymentHttpServer(server, { port }); +process.stdout.write(`archive-deployment-server ${origin} root=${staticRoot} archive=${archive}\n`); + diff --git a/tools/web/check-binary-archive.mjs b/tools/web/check-binary-archive.mjs new file mode 100644 index 00000000..030baeb8 --- /dev/null +++ b/tools/web/check-binary-archive.mjs @@ -0,0 +1,139 @@ +import assert from "node:assert/strict"; +import crypto from "node:crypto"; +import fs from "node:fs"; +import os from "node:os"; +import path from "node:path"; +import { execFileSync } from "node:child_process"; +import { fileURLToPath } from "node:url"; + +const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."); +const releaseRoot = path.join(repoRoot, "release"); +const archive = path.resolve(process.env.M6_BINARY_ARCHIVE ?? path.join(releaseRoot, "blender-web-offline.tar.gz")); +const sourceArchive = path.resolve(process.env.M6_SOURCE_ARCHIVE ?? path.join(releaseRoot, "blender-web-corresponding-source.tar.gz")); +const sumsPath = path.join(releaseRoot, "SHA256SUMS.txt"); +const workspace = fs.mkdtempSync(path.join(os.tmpdir(), "blender-binary-archive-")); + +const sha256 = (file) => crypto.createHash("sha256").update(fs.readFileSync(file)).digest("hex"); + +function walk(directory, base = directory) { + const files = []; + for (const entry of fs.readdirSync(directory, { withFileTypes: true }).sort((left, right) => left.name.localeCompare(right.name))) { + const absolute = path.join(directory, entry.name); + if (entry.isDirectory()) files.push(...walk(absolute, base)); + else files.push(path.relative(base, absolute).replaceAll(path.sep, "/")); + } + return files; +} + +function safeEntries(file) { + const verbose = execFileSync("tar", ["-tvzf", file], { encoding: "utf8", maxBuffer: 16 * 1024 * 1024 }); + for (const line of verbose.split("\n").filter(Boolean)) { + assert.ok(["-", "d"].includes(line[0]), `binary archive contains a non-regular entry: ${line}`); + } + const entries = execFileSync("tar", ["-tzf", file], { encoding: "utf8", maxBuffer: 16 * 1024 * 1024 }).split("\n").filter(Boolean); + assert.ok(entries.length > 0, "binary archive is empty"); + for (const entry of entries) { + assert.ok(!entry.startsWith("/") && !entry.split("/").includes(".."), `unsafe binary archive path: ${entry}`); + assert.ok(entry === "blender-web-offline/" || entry.startsWith("blender-web-offline/"), `unexpected binary archive root: ${entry}`); + } +} + +try { + assert.ok(fs.statSync(archive).isFile(), `binary archive is missing: ${archive}`); + assert.ok(fs.statSync(sourceArchive).isFile(), `source archive is missing: ${sourceArchive}`); + assert.ok(fs.statSync(sumsPath).isFile(), `release checksum file is missing: ${sumsPath}`); + execFileSync("sha256sum", ["-c", path.basename(sumsPath)], { cwd: releaseRoot, stdio: "pipe" }); + safeEntries(archive); + execFileSync("tar", ["--no-same-owner", "--no-same-permissions", "-xzf", archive, "-C", workspace]); + const bundle = path.join(workspace, "blender-web-offline"); + assert.ok(!fs.realpathSync(bundle).startsWith(`${repoRoot}${path.sep}`), "binary archive was not extracted independently"); + + const required = [ + "COPYING", + "DEPLOYMENT.md", + "SOURCE_OFFER.txt", + "deployment-contract.json", + "manifest.json", + "KNOWN_LIMITATIONS.md", + "operations-diagnostics.json", + "parity-ledger.json", + "RELEASE_NOTES.md", + "RELEASE_RECOVERY.md", + "release-metadata.json", + "sbom.spdx.json", + "third-party-notices.json", + "V1_SCOPE.md", + "app/index.html", + "app/engine-manifest.json", + ]; + for (const relative of required) assert.ok(fs.statSync(path.join(bundle, relative)).isFile(), `binary archive omits ${relative}`); + + const manifest = JSON.parse(fs.readFileSync(path.join(bundle, "manifest.json"), "utf8")); + assert.equal(manifest.schemaVersion, 1, "binary manifest schema drifted"); + assert.ok(Array.isArray(manifest.files) && manifest.files.length > 0, "binary manifest has no files"); + const actualFiles = walk(bundle).filter((relative) => relative !== "manifest.json"); + assert.deepEqual(manifest.files.map((entry) => entry.path), actualFiles, "binary manifest file list drifted"); + for (const entry of manifest.files) { + const file = path.join(bundle, entry.path); + assert.equal(fs.statSync(file).size, entry.bytes, `binary manifest byte length drifted: ${entry.path}`); + assert.equal(sha256(file), entry.sha256, `binary manifest SHA-256 drifted: ${entry.path}`); + } + + const contract = JSON.parse(fs.readFileSync(path.join(bundle, "deployment-contract.json"), "utf8")); + assert.equal(contract.schemaVersion, 1); + assert.equal(contract.transport.production, "https"); + assert.equal(contract.transport.localDevelopment, "http://127.0.0.1"); + assert.equal(contract.transport.fileProtocolSupported, false); + assert.deepEqual(contract.methods, ["GET", "HEAD"]); + + const sbom = JSON.parse(fs.readFileSync(path.join(bundle, "sbom.spdx.json"), "utf8")); + assert.equal(sbom.spdxVersion, "SPDX-2.3"); + assert.ok(sbom.packages.length > 0, "binary SBOM has no packages"); + const engine = JSON.parse(fs.readFileSync(path.join(bundle, "app/engine-manifest.json"), "utf8")); + assert.equal(engine.schemaVersion, 2); + assert.equal(new Set(engine.variants.map((variant) => variant.id)).size, 2); + for (const variant of engine.variants) { + for (const resource of Object.values(variant.resources)) { + const file = path.join(bundle, "app", new URL(resource.url, "http://archive.local").pathname.slice(1)); + assert.equal(sha256(file), resource.sha256, `${variant.id} ${resource.url} hash drifted`); + } + } + const releaseMetadata = JSON.parse(fs.readFileSync(path.join(bundle, "release-metadata.json"), "utf8")); + assert.equal(releaseMetadata.schemaVersion, 1); + assert.equal(releaseMetadata.engineReleaseId, engine.releaseId); + assert.equal(releaseMetadata.storage.indexedDbSchemaVersion, 6); + assert.equal(releaseMetadata.storage.opfsProjectManifestSchemaVersion, 1); + assert.equal(releaseMetadata.storage.migrationDirection, "forward-only"); + assert.equal(releaseMetadata.storage.originBound, true); + assert.ok(releaseMetadata.app.workerAssets.length >= 3); + for (const relative of [...releaseMetadata.app.workerAssets, ...releaseMetadata.app.entryAssets]) { + assert.ok(fs.statSync(path.join(bundle, "app", relative)).isFile(), `release metadata asset is missing: ${relative}`); + } + const diagnostics = JSON.parse(fs.readFileSync(path.join(bundle, "operations-diagnostics.json"), "utf8")); + assert.deepEqual(diagnostics.entries.map((entry) => entry.domain).sort(), ["gpu", "hash", "isolation", "mime", "quota", "range", "worker"]); + const releaseNotes = fs.readFileSync(path.join(bundle, "RELEASE_NOTES.md"), "utf8"); + assert.match(releaseNotes, /All 12 V1 family release slices are `READY`/); + assert.match(releaseNotes, /all 12 complete Blender 5\.2 family parity states are\s+`BLOCKED`/); + assert.match(releaseNotes, /\[Known limitations\]\(KNOWN_LIMITATIONS\.md\)/); + assert.match(releaseNotes, /\[Release recovery\]\(RELEASE_RECOVERY\.md\)/); + assert.match(fs.readFileSync(path.join(bundle, "KNOWN_LIMITATIONS.md"), "utf8"), /32,768-page ceiling \(2 GiB\)/); + assert.match(fs.readFileSync(path.join(bundle, "RELEASE_RECOVERY.md"), "utf8"), /sha256sum --check RC_MANIFEST\.json\.sha256/); + + const report = { + schemaVersion: 1, + task: "M6-11", + status: "READY", + archive: { path: path.basename(archive), bytes: fs.statSync(archive).size, sha256: sha256(archive) }, + correspondingSource: { path: path.basename(sourceArchive), bytes: fs.statSync(sourceArchive).size, sha256: sha256(sourceArchive) }, + extractedRootOutsideWorkspace: true, + filesVerified: manifest.files.length, + keyFiles: Object.fromEntries(required.map((relative) => [relative, sha256(path.join(bundle, relative))])), + }; + const reportRoot = path.join(releaseRoot, "archive-reports"); + fs.mkdirSync(reportRoot, { recursive: true }); + fs.writeFileSync(path.join(reportRoot, "binary.json"), `${JSON.stringify(report, null, 2)}\n`); + process.stdout.write(`binary-archive-ok files=${report.filesVerified} sha256=${report.archive.sha256}\n`); +} +finally { + fs.rmSync(workspace, { recursive: true, force: true }); +} diff --git a/tools/web/check-ci-failure-report.mjs b/tools/web/check-ci-failure-report.mjs new file mode 100644 index 00000000..b5eb302f --- /dev/null +++ b/tools/web/check-ci-failure-report.mjs @@ -0,0 +1,26 @@ +import assert from "node:assert/strict"; +import fs from "node:fs"; +import os from "node:os"; +import path from "node:path"; +import { spawnSync } from "node:child_process"; + +const temporary = fs.mkdtempSync(path.join(os.tmpdir(), "blender-ci-failure-")); +const reportPath = path.join(temporary, "quick-failure.json"); +try { + const result = spawnSync(process.execPath, [new URL("./run-ci-lane.mjs", import.meta.url).pathname, "quick", "--self-test-failure"], { + encoding: "utf8", + env: { ...process.env, CI_REPORT_PATH: reportPath }, + }); + assert.notEqual(result.status, 0, "injected lane failure returned success"); + const report = JSON.parse(fs.readFileSync(reportPath, "utf8")); + assert.equal(report.status, "FAILED"); + assert.equal(report.records.length, 1); + assert.equal(report.records[0].id, "injected-failure"); + assert.equal(report.records[0].exitCode, 17); + assert.ok(fs.existsSync(`${reportPath}.sha256`)); + process.stdout.write("ci-failure-report-ok status=FAILED exitCode=17 staleReady=false\n"); +} +finally { + fs.rmSync(temporary, { recursive: true, force: true }); +} + diff --git a/tools/web/check-ci-report.mjs b/tools/web/check-ci-report.mjs new file mode 100644 index 00000000..b3d49bc6 --- /dev/null +++ b/tools/web/check-ci-report.mjs @@ -0,0 +1,92 @@ +import assert from "node:assert/strict"; +import crypto from "node:crypto"; +import fs from "node:fs"; +import path from "node:path"; +import { fileURLToPath } from "node:url"; + +const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."); +const reportRoot = path.join(repoRoot, "release/ci-reports"); +const requested = process.argv.slice(2); +const paths = requested.length > 0 + ? requested.map((value) => path.isAbsolute(value) ? value : path.resolve(repoRoot, value)) + : ["quick", "chromium", "release"].map((lane) => path.join(reportRoot, `${lane}.json`)).filter((file) => fs.existsSync(file)); +assert.ok(paths.length > 0, "no CI lane reports were provided or found"); + +const sha256 = (value) => crypto.createHash("sha256").update(value).digest("hex"); +const commonBindings = ["packageJson", "lockfile", "ledger", "engineManifest", "releaseNotes", "knownLimitations", "releaseRecovery", "sbom"]; +const releaseBindings = ["binaryArchive", "sourceArchive", "sha256Sums", "rcManifest"]; +const expectedRecordIds = { + quick: ["lockfile-install", "typecheck", "lint", "unit", "status", "evidence-schema", "rc-docs"], + chromium: ["lockfile-install", "p0-user-loop", "offline-browser-smoke", "network-interruption", "device-loss", "oom-recovery", "opfs-quota", "malicious-blend", "malicious-archive"], + release: [ + "lockfile-install", "full-e2e", "performance-100k-1m", "performance-10m", + "performance-texture-4k", "performance-texture-8k", "performance-simulation", + "performance-long-media", "vdb-native", "vdb-server", "vdb-opfs", "vdb-webgpu", + "vdb-viewport", "vdb-faults", "v1-acceptance", "offline-reproducibility", + "archive-browser", "binary-archive", "source-archive", "deployment-runbook", + "upgrade-runbook", "rollback-runbook", "operations-diagnostics", "operations-rehearsal", + "rc-manifest", + ], +}; +const reports = []; +for (const reportPath of paths) { + const bytes = fs.readFileSync(reportPath); + const report = JSON.parse(bytes); + assert.equal(report.schemaVersion, 1, `${reportPath} schemaVersion drifted`); + assert.ok(["quick", "chromium", "release"].includes(report.lane), `${reportPath} lane is invalid`); + assert.equal(report.status, "READY", `${reportPath} is not READY`); + assert.match(report.commit, /^[a-f0-9]{40}$/); + assert.ok(!Number.isNaN(Date.parse(report.generatedAt)), `${reportPath} generatedAt is invalid`); + assert.equal(report.retentionDays, report.lane === "quick" ? 7 : report.lane === "chromium" ? 14 : 30); + for (const name of ["os", "node", "npm", "chrome", "blender", "emscripten"]) assert.equal(typeof report.environment[name], "string", `${reportPath} omits environment.${name}`); + for (const name of [...commonBindings, ...releaseBindings]) { + const binding = report.bindings[name]; + assert.ok(binding && typeof binding.path === "string", `${reportPath} omits binding ${name}`); + if (binding.sha256 !== null) { + assert.match(binding.sha256, /^[a-f0-9]{64}$/); + const file = path.join(repoRoot, binding.path); + assert.equal(sha256(fs.readFileSync(file)), binding.sha256, `${reportPath} binding drifted: ${name}`); + } + } + if (report.lane === "release") { + for (const name of releaseBindings) assert.match(report.bindings[name].sha256, /^[a-f0-9]{64}$/); + } + else { + for (const name of releaseBindings) assert.equal(report.bindings[name].sha256, null); + } + assert.ok(Array.isArray(report.records) && report.records.length > 0, `${reportPath} has no command records`); + assert.deepEqual(report.records.map((record) => record.id), expectedRecordIds[report.lane], `${reportPath} command coverage drifted`); + for (const record of report.records) { + assert.equal(record.exitCode, 0, `${reportPath} command failed: ${record.id}`); + assert.ok(Number.isSafeInteger(record.durationMs) && record.durationMs >= 0); + assert.match(record.output.sha256, /^[a-f0-9]{64}$/); + const artifact = path.join(repoRoot, record.output.path); + assert.equal(fs.statSync(artifact).size, record.output.bytes, `${record.id} output length drifted`); + assert.equal(sha256(fs.readFileSync(artifact)), record.output.sha256, `${record.id} output hash drifted`); + } + const sidecar = fs.readFileSync(`${reportPath}.sha256`, "utf8").trim().split(/\s+/)[0]; + assert.equal(sidecar, sha256(bytes), `${reportPath} sidecar hash drifted`); + reports.push(report); +} + +if (reports.length > 1) { + assert.equal(new Set(reports.map((report) => report.commit)).size, 1, "CI lane reports do not bind one commit"); + for (const binding of commonBindings) { + assert.equal(new Set(reports.map((report) => report.bindings[binding].sha256)).size, 1, `CI lane ${binding} bindings differ`); + } +} +if (reports.length === 3) { + assert.deepEqual(new Set(reports.map((report) => report.lane)), new Set(["quick", "chromium", "release"])); + const releaseReport = reports.find((report) => report.lane === "release"); + const rcManifest = JSON.parse(fs.readFileSync(path.join(repoRoot, releaseReport.bindings.rcManifest.path), "utf8")); + assert.equal(rcManifest.gitCommit, releaseReport.commit, "RC manifest and CI reports bind different commits"); + assert.equal(rcManifest.bindings.packageJsonSha256, releaseReport.bindings.packageJson.sha256); + assert.equal(rcManifest.bindings.packageLockSha256, releaseReport.bindings.lockfile.sha256); + assert.equal(rcManifest.bindings.ledgerSha256, releaseReport.bindings.ledger.sha256); + assert.equal(rcManifest.bindings.engineManifestSha256, releaseReport.bindings.engineManifest.sha256); + assert.equal(rcManifest.artifacts.sbom.sha256, releaseReport.bindings.sbom.sha256); + assert.equal(rcManifest.artifacts.binaryArchive.sha256, releaseReport.bindings.binaryArchive.sha256); + assert.equal(rcManifest.artifacts.sourceArchive.sha256, releaseReport.bindings.sourceArchive.sha256); + assert.equal(rcManifest.bindings.sha256SumsSha256, releaseReport.bindings.sha256Sums.sha256); +} +process.stdout.write(`ci-report-ok lanes=${reports.map((report) => report.lane).join(",")} commit=${reports[0].commit}\n`); diff --git a/tools/web/check-deployment-cache.mjs b/tools/web/check-deployment-cache.mjs new file mode 100644 index 00000000..f58de721 --- /dev/null +++ b/tools/web/check-deployment-cache.mjs @@ -0,0 +1,161 @@ +import assert from "node:assert/strict"; +import crypto from "node:crypto"; +import fs from "node:fs"; +import os from "node:os"; +import path from "node:path"; +import { fileURLToPath } from "node:url"; +import { + createDeploymentHttpServer, + listenDeploymentHttpServer, + loadDeploymentContract, +} from "./deployment-http-server.mjs"; + +const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."); +const sourceDist = path.join(repoRoot, "web/dist"); +const workspace = fs.mkdtempSync(path.join(os.tmpdir(), "blender-deployment-cache-")); +const root = path.join(workspace, "dist"); +const contract = loadDeploymentContract(); +let server; + +function sha256(bytes) { + return crypto.createHash("sha256").update(bytes).digest("hex"); +} + +function route(id) { + const value = contract.responseHeaders.routes.find((candidate) => candidate.id === id); + assert.ok(value, `deployment contract route is missing: ${id}`); + return value; +} + +async function responseBytes(response) { + return Buffer.from(await response.arrayBuffer()); +} + +async function expectCache(origin, url, expected) { + const response = await fetch(`${origin}${url}`, { cache: "no-store" }); + assert.equal(response.status, 200, `cache probe failed url=${url} status=${response.status}`); + assert.equal( + response.headers.get("cache-control"), + expected, + `Cache-Control mismatch url=${url}`, + ); + assert.match(response.headers.get("etag"), /^"sha256-[a-f0-9]{64}"$/); + return response; +} + +function contentHashedAssets() { + const assetRoot = path.join(root, "assets"); + const names = fs.readdirSync(assetRoot).sort(); + const cases = [ + ["entry JS", names.filter((name) => name.endsWith(".js") && !name.includes(".worker-"))], + ["CSS", names.filter((name) => name.endsWith(".css"))], + ["Worker", names.filter((name) => name.includes(".worker-") && name.endsWith(".js"))], + ]; + for (const [role, roleNames] of cases) { + assert.ok(roleNames.length > 0, `production build has no content-hashed ${role} asset`); + for (const name of roleNames) { + assert.match(name, /-[A-Za-z0-9_-]{8}\.(?:js|css)$/, `${role} asset is not content hashed: ${name}`); + } + } + return cases.flatMap(([, namesForRole]) => namesForRole).map((name) => `/assets/${name}`); +} + +try { + assert.ok(fs.statSync(path.join(sourceDist, "index.html")).size > 0, "web/dist is missing; run the production build first"); + fs.cpSync(sourceDist, root, { recursive: true }); + const manifestPath = path.join(root, "engine-manifest.json"); + const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8")); + assert.equal(manifest.schemaVersion, 2); + assert.match(manifest.releaseId, /^[A-Za-z0-9][A-Za-z0-9._+-]{0,127}$/); + + server = createDeploymentHttpServer({ root, contract }); + const origin = await listenDeploymentHttpServer(server); + const noCache = route("entry-document").cacheControl; + const manifestNoCache = route("runtime-manifest").cacheControl; + const immutable = route("content-hashed-assets").cacheControl; + const engineNoCache = route("stable-engine-assets").cacheControl; + + const entry = await expectCache(origin, "/", noCache); + const entryEtag = entry.headers.get("etag"); + assert.deepEqual(await responseBytes(entry), fs.readFileSync(path.join(root, "index.html"))); + await expectCache(origin, "/index.html", noCache); + const unchangedEntry = await fetch(`${origin}/`, { headers: { "If-None-Match": entryEtag } }); + assert.equal(unchangedEntry.status, 304); + assert.equal(unchangedEntry.headers.get("cache-control"), noCache); + const nextEntryBytes = Buffer.concat([ + fs.readFileSync(path.join(root, "index.html")), + Buffer.from("\n\n"), + ]); + fs.writeFileSync(path.join(root, "index.html"), nextEntryBytes); + const changedEntry = await fetch(`${origin}/`, { headers: { "If-None-Match": entryEtag } }); + assert.equal(changedEntry.status, 200); + assert.equal(changedEntry.headers.get("cache-control"), noCache); + assert.notEqual(changedEntry.headers.get("etag"), entryEtag); + assert.deepEqual(await responseBytes(changedEntry), nextEntryBytes); + + const firstManifest = await expectCache(origin, "/engine-manifest.json", manifestNoCache); + const firstManifestEtag = firstManifest.headers.get("etag"); + assert.deepEqual(await responseBytes(firstManifest), fs.readFileSync(manifestPath)); + + const unchangedManifest = await fetch(`${origin}/engine-manifest.json`, { + headers: { "If-None-Match": firstManifestEtag }, + }); + assert.equal(unchangedManifest.status, 304); + assert.equal(unchangedManifest.headers.get("cache-control"), manifestNoCache); + assert.equal((await unchangedManifest.arrayBuffer()).byteLength, 0); + + const assetUrls = contentHashedAssets(); + for (const url of assetUrls) { + const response = await expectCache(origin, url, immutable); + const bytes = await responseBytes(response); + assert.equal(response.headers.get("etag"), `"sha256-${sha256(bytes)}"`); + } + + const uniqueResources = [...new Map( + manifest.variants.flatMap((variant) => Object.values(variant.resources)) + .map((resource) => [resource.url, resource]), + ).values()]; + for (const resource of uniqueResources) { + const response = await expectCache(origin, resource.url, engineNoCache); + assert.equal(sha256(await responseBytes(response)), resource.sha256); + } + + const nextManifest = { ...manifest, releaseId: `${manifest.releaseId}.next` }; + fs.writeFileSync(manifestPath, `${JSON.stringify(nextManifest, null, 2)}\n`); + const changedManifest = await fetch(`${origin}/engine-manifest.json`, { + headers: { "If-None-Match": firstManifestEtag }, + }); + assert.equal(changedManifest.status, 200); + assert.equal(changedManifest.headers.get("cache-control"), manifestNoCache); + assert.notEqual(changedManifest.headers.get("etag"), firstManifestEtag); + assert.equal((await changedManifest.json()).releaseId, nextManifest.releaseId); + + const stableResource = uniqueResources.find((resource) => resource.url.endsWith(".js")); + assert.ok(stableResource, "engine manifest has no stable JS resource"); + const stablePath = path.join(root, stableResource.url.replace(/^\/+/, "")); + const stableFirst = await fetch(`${origin}${stableResource.url}`, { cache: "no-store" }); + const stableFirstEtag = stableFirst.headers.get("etag"); + const stableUnchanged = await fetch(`${origin}${stableResource.url}`, { + headers: { "If-None-Match": stableFirstEtag }, + }); + assert.equal(stableUnchanged.status, 304); + assert.equal(stableUnchanged.headers.get("cache-control"), engineNoCache); + const replacement = Buffer.from("export default () => { throw new Error('next release'); };\n"); + fs.writeFileSync(stablePath, replacement); + const stableChanged = await fetch(`${origin}${stableResource.url}`, { + headers: { "If-None-Match": stableFirstEtag }, + }); + assert.equal(stableChanged.status, 200); + assert.equal(stableChanged.headers.get("cache-control"), engineNoCache); + assert.notEqual(stableChanged.headers.get("etag"), stableFirstEtag); + assert.equal(sha256(await responseBytes(stableChanged)), sha256(replacement)); + assert.notEqual(sha256(replacement), stableResource.sha256); + + process.stdout.write( + `deployment-cache-ok noCache=3 immutable=${assetUrls.length} stableEngine=${uniqueResources.length} revalidation=304/200\n`, + ); +} +finally { + if (server?.listening) await new Promise((resolve) => server.close(resolve)); + fs.rmSync(workspace, { recursive: true, force: true }); +} diff --git a/tools/web/check-deployment-contract.mjs b/tools/web/check-deployment-contract.mjs index 55edcbf4..196aa679 100644 --- a/tools/web/check-deployment-contract.mjs +++ b/tools/web/check-deployment-contract.mjs @@ -53,7 +53,10 @@ assert.deepEqual(contract.rangeRequests.requiredSatisfiedHeaders, ["Accept-Range assert.equal(contract.rangeRequests.ifRangeMismatch, "return-full-200"); for (const value of Object.values(contract.responseHeaders.allResponses)) assert.ok(guide.includes(`\`${value}\``)); -for (const status of ["206", "416", "200"]) assert.ok(guide.includes(`\`${status}\``)); +for (const status of ["206", "416", "304", "200"]) assert.ok(guide.includes(`\`${status}\``)); +for (const route of contract.responseHeaders.routes) assert.ok(guide.includes(route.cacheControl)); +for (const section of ["Empty-directory install runbook", "Transport preflight", "Upgrade runbook", "Rollback runbook", "Failure diagnostics", "Fresh-directory rehearsal"]) assert.ok(guide.includes(`## ${section}`)); +for (const token of ["BLENDER_WEB_INSTALL_ROOT", "window.isSecureContext === true", "window.crossOriginIsolated === true"]) assert.ok(guide.includes(token)); assert.match(vite, /deployment-contract\.json/); assert.match(vite, /responseHeaders\.allResponses/); assert.match(releaseCreator, /deployment-contract\.json/); diff --git a/tools/web/check-deployment-http.mjs b/tools/web/check-deployment-http.mjs new file mode 100644 index 00000000..ee523924 --- /dev/null +++ b/tools/web/check-deployment-http.mjs @@ -0,0 +1,184 @@ +import assert from "node:assert/strict"; +import crypto from "node:crypto"; +import fs from "node:fs"; +import http from "node:http"; +import os from "node:os"; +import path from "node:path"; +import { + createDeploymentHttpServer, + listenDeploymentHttpServer, + loadDeploymentContract, +} from "./deployment-http-server.mjs"; + +const contract = loadDeploymentContract(); +const root = fs.mkdtempSync(path.join(os.tmpdir(), "blender-deployment-http-")); + +function write(relative, bytes) { + const filePath = path.join(root, relative); + fs.mkdirSync(path.dirname(filePath), { recursive: true }); + fs.writeFileSync(filePath, bytes); + return Buffer.from(bytes); +} + +function sha256(bytes) { + return crypto.createHash("sha256").update(bytes).digest("hex"); +} + +function deterministicBytes(size, seed) { + const bytes = Buffer.alloc(size); + for (let index = 0; index < bytes.length; index += 1) bytes[index] = (index * 31 + seed) & 0xff; + return bytes; +} + +const fixtures = new Map([ + ["/index.html", write("index.html", "Web Blender")], + ["/assets/app.js", write("assets/app.js", "export const app = true;\n")], + ["/assets/app.css", write("assets/app.css", "body { color: black; }\n")], + ["/vendor/blender/single/web_engine.js", write("vendor/blender/single/web_engine.js", "export default () => {};\n")], + ["/vendor/blender/single/web_engine.wasm", write("vendor/blender/single/web_engine.wasm", deterministicBytes(1024, 7))], + ["/vendor/blender/pthread/web_engine.js", write("vendor/blender/pthread/web_engine.js", "export default () => {}; // pthread\n")], + ["/engine-manifest.json", write("engine-manifest.json", "{\"schemaVersion\":2}\n")], + ["/media/frame.png", write("media/frame.png", Buffer.from([0x89, 0x50, 0x4e, 0x47]))], + ["/media/silence.wav", write("media/silence.wav", Buffer.from("RIFF0000WAVE"))], + ["/fixtures/basic.blend", write("fixtures/basic.blend", deterministicBytes(4096, 11))], + ["/volumes/smoke.nvdb", write("volumes/smoke.nvdb", deterministicBytes(1024 * 1024, 19))], +]); + +const server = createDeploymentHttpServer({ root, contract }); +let origin; + +async function body(response) { + return Buffer.from(await response.arrayBuffer()); +} + +async function expectMime(url, expected, method = "GET") { + const response = await fetch(`${origin}${url}`, { method }); + const actual = response.headers.get("content-type"); + assert.equal(actual, expected, `MIME mismatch url=${url} expected=${expected} actual=${actual}`); + assert.equal(response.status, 200, `HTTP status mismatch url=${url} expected=200 actual=${response.status}`); + return response; +} + +function expectedMime(url) { + const extension = path.extname(new URL(url, "http://deployment.local").pathname); + const mime = contract.mimeTypes[extension]; + assert.ok(mime, `deployment contract has no MIME for url=${url}`); + return mime; +} + +async function expectRange(url, header, expectedStart, expectedEnd) { + const source = fixtures.get(url); + const response = await fetch(`${origin}${url}`, { headers: { Range: header } }); + assert.equal(response.status, contract.rangeRequests.satisfiedStatus, `range status url=${url} range=${header}`); + const bytes = await body(response); + assert.deepEqual(bytes, source.subarray(expectedStart, expectedEnd + 1), `range bytes url=${url} range=${header}`); + for (const name of contract.rangeRequests.requiredSatisfiedHeaders) { + assert.ok(response.headers.has(name), `missing ${name} url=${url} range=${header}`); + } + assert.equal(response.headers.get("content-range"), `bytes ${expectedStart}-${expectedEnd}/${source.length}`); + assert.equal(Number(response.headers.get("content-length")), expectedEnd - expectedStart + 1); + assert.match(response.headers.get("etag"), /^"sha256-[a-f0-9]{64}"$/); + return response; +} + +async function interruptedPrefix(url) { + return new Promise((resolve, reject) => { + const chunks = []; + const request = http.get(`${origin}${url}`, (response) => { + response.once("data", (chunk) => { + chunks.push(chunk); + response.destroy(); + resolve({ bytes: Buffer.concat(chunks), etag: response.headers.etag }); + }); + response.on("error", (error) => { + if (error.code !== "ECONNRESET") reject(error); + }); + }); + request.on("error", reject); + }); +} + +try { + origin = await listenDeploymentHttpServer(server); + + const mimeCases = [ + ["/index.html", ".html"], + ["/assets/app.js", ".js"], + ["/assets/app.css", ".css"], + ["/vendor/blender/single/web_engine.wasm", ".wasm"], + ["/engine-manifest.json", ".json"], + ["/media/frame.png", ".png"], + ["/media/silence.wav", ".wav"], + ["/fixtures/basic.blend", ".blend"], + ["/volumes/smoke.nvdb", ".nvdb"], + ]; + for (const [url, extension] of mimeCases) { + assert.equal(expectedMime(url), contract.mimeTypes[extension]); + const response = await expectMime(url, contract.mimeTypes[extension]); + assert.deepEqual(await body(response), fixtures.get(url)); + } + + for (const url of [ + "/vendor/blender/single/web_engine.js", + "/vendor/blender/single/web_engine.wasm", + "/vendor/blender/pthread/web_engine.js", + "/fixtures/basic.blend", + ]) { + const response = await expectMime(url, expectedMime(url), "HEAD"); + assert.equal((await response.arrayBuffer()).byteLength, 0, `HEAD returned a body url=${url}`); + assert.equal(Number(response.headers.get("content-length")), fixtures.get(url).length); + } + + await expectRange("/vendor/blender/single/web_engine.wasm", "bytes=100-199", 100, 199); + await expectRange("/fixtures/basic.blend", "bytes=200-399", 200, 399); + await expectRange("/volumes/smoke.nvdb", "bytes=300-599", 300, 599); + await expectRange("/fixtures/basic.blend", "bytes=400-", 400, fixtures.get("/fixtures/basic.blend").length - 1); + await expectRange("/fixtures/basic.blend", "bytes=-128", fixtures.get("/fixtures/basic.blend").length - 128, fixtures.get("/fixtures/basic.blend").length - 1); + + for (const range of ["items=0-1", "bytes=", "bytes=20-10", "bytes=0-999999", "bytes=0-1,4-5", "bytes=-0"]) { + const response = await fetch(`${origin}/fixtures/basic.blend`, { headers: { Range: range } }); + assert.equal(response.status, contract.rangeRequests.unsatisfiedStatus, `invalid range accepted range=${range}`); + assert.equal((await response.arrayBuffer()).byteLength, 0); + assert.equal(response.headers.get("content-range"), `bytes */${fixtures.get("/fixtures/basic.blend").length}`); + } + + const etagFirst = (await fetch(`${origin}/fixtures/basic.blend`)).headers.get("etag"); + const etagSecond = (await fetch(`${origin}/fixtures/basic.blend`)).headers.get("etag"); + assert.equal(etagFirst, etagSecond); + const matchingIfRange = await fetch(`${origin}/fixtures/basic.blend`, { + headers: { Range: "bytes=0-31", "If-Range": etagFirst }, + }); + assert.equal(matchingIfRange.status, 206); + const mismatchingIfRange = await fetch(`${origin}/fixtures/basic.blend`, { + headers: { Range: "bytes=0-31", "If-Range": '"sha256-old-revision"' }, + }); + assert.equal(mismatchingIfRange.status, 200); + assert.deepEqual(await body(mismatchingIfRange), fixtures.get("/fixtures/basic.blend")); + + const interrupted = await interruptedPrefix("/volumes/smoke.nvdb"); + assert.ok(interrupted.bytes.length > 0 && interrupted.bytes.length < fixtures.get("/volumes/smoke.nvdb").length); + const resumed = await fetch(`${origin}/volumes/smoke.nvdb`, { + headers: { + Range: `bytes=${interrupted.bytes.length}-`, + "If-Range": interrupted.etag, + }, + }); + assert.equal(resumed.status, 206); + const merged = Buffer.concat([interrupted.bytes, await body(resumed)]); + assert.equal(sha256(merged), sha256(fixtures.get("/volumes/smoke.nvdb"))); + + const replacement = deterministicBytes(fixtures.get("/fixtures/basic.blend").length, 23); + fs.writeFileSync(path.join(root, "fixtures/basic.blend"), replacement); + const changed = await fetch(`${origin}/fixtures/basic.blend`, { + headers: { Range: "bytes=32-", "If-Range": etagFirst }, + }); + assert.equal(changed.status, 200); + assert.notEqual(changed.headers.get("etag"), etagFirst); + assert.deepEqual(await body(changed), replacement); + + process.stdout.write("deployment-http-ok mime=9 head=4 ranges=5 invalidRanges=6 resumeSha256=verified\n"); +} +finally { + if (server.listening) await new Promise((resolve) => server.close(resolve)); + fs.rmSync(root, { recursive: true, force: true }); +} diff --git a/tools/web/check-deployment-runbook.mjs b/tools/web/check-deployment-runbook.mjs new file mode 100644 index 00000000..600090bd --- /dev/null +++ b/tools/web/check-deployment-runbook.mjs @@ -0,0 +1,164 @@ +import assert from "node:assert/strict"; +import crypto from "node:crypto"; +import fs from "node:fs"; +import os from "node:os"; +import path from "node:path"; +import { execFileSync } from "node:child_process"; +import { fileURLToPath } from "node:url"; +import { + createDeploymentHttpServer, + listenDeploymentHttpServer, +} from "./deployment-http-server.mjs"; + +const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."); +const releaseRoot = path.join(repoRoot, "release"); +const sourceArchive = path.join(releaseRoot, "blender-web-corresponding-source.tar.gz"); +const binaryArchive = path.join(releaseRoot, "blender-web-offline.tar.gz"); +const sumsFile = path.join(releaseRoot, "SHA256SUMS.txt"); +const workspace = fs.mkdtempSync(path.join(os.tmpdir(), "blender-deployment-runbook-")); + +const sha256 = (file) => crypto.createHash("sha256").update(fs.readFileSync(file)).digest("hex"); + +function checksumEntries(value) { + return Object.fromEntries(value.trim().split("\n").map((line) => { + const match = line.match(/^([a-f0-9]{64}) ([^/]+)$/); + assert.ok(match, `invalid SHA256SUMS entry: ${line}`); + return [match[2], match[1]]; + })); +} + +function assertSafeArchive(file) { + const verbose = execFileSync("tar", ["-tvzf", file], { encoding: "utf8", maxBuffer: 16 * 1024 * 1024 }); + for (const line of verbose.split("\n").filter(Boolean)) { + assert.ok(["-", "d"].includes(line[0]), `deployment archive contains a link or special entry: ${line}`); + } + const entries = execFileSync("tar", ["-tzf", file], { encoding: "utf8", maxBuffer: 16 * 1024 * 1024 }) + .split("\n") + .filter(Boolean); + assert.ok(entries.length > 0, "deployment archive is empty"); + for (const entry of entries) { + assert.ok(!entry.startsWith("/"), `deployment archive contains an absolute path: ${entry}`); + assert.ok(!entry.split("/").includes(".."), `deployment archive contains path traversal: ${entry}`); + assert.ok(entry === "blender-web-offline/" || entry.startsWith("blender-web-offline/"), `unexpected deployment archive root: ${entry}`); + } +} + +function classifyOrigin(value, contract) { + let origin; + try { + origin = new URL(value); + } + catch { + return { status: "BLOCKED", reason: "INVALID_ORIGIN" }; + } + if (origin.username || origin.password || origin.pathname !== "/" || origin.search || origin.hash) { + return { status: "BLOCKED", reason: "UNSUPPORTED_ORIGIN_SHAPE" }; + } + if (origin.protocol === `${contract.transport.production}:`) return { status: "READY", mode: "production-https" }; + const local = new URL(contract.transport.localDevelopment); + if (origin.protocol === local.protocol && origin.hostname === local.hostname) { + return { status: "READY", mode: "loopback-http" }; + } + return { status: "BLOCKED", reason: "HTTPS_OR_EXPLICIT_LOOPBACK_REQUIRED" }; +} + +function assertHeader(response, name, expected) { + assert.equal(response.headers.get(name), expected, `${name} drifted at ${response.url}`); +} + +let server; +try { + const delivery = path.join(workspace, "delivery"); + const installRoot = path.join(workspace, "install"); + fs.mkdirSync(delivery); + fs.mkdirSync(installRoot); + for (const file of [binaryArchive, sourceArchive, sumsFile]) { + assert.ok(fs.statSync(file).isFile(), `release delivery is missing ${path.basename(file)}`); + fs.copyFileSync(file, path.join(delivery, path.basename(file))); + } + + const deliveredArchive = path.join(delivery, path.basename(binaryArchive)); + const sums = checksumEntries(fs.readFileSync(path.join(delivery, path.basename(sumsFile)), "utf8")); + assert.equal(sha256(deliveredArchive), sums[path.basename(binaryArchive)], "binary delivery checksum drifted"); + assert.equal(sha256(path.join(delivery, path.basename(sourceArchive))), sums[path.basename(sourceArchive)], "source delivery checksum drifted"); + assertSafeArchive(deliveredArchive); + + const releases = path.join(installRoot, "releases"); + fs.mkdirSync(releases); + const staging = fs.mkdtempSync(path.join(installRoot, ".install.")); + execFileSync("tar", ["--no-same-owner", "--no-same-permissions", "-xzf", deliveredArchive, "-C", staging]); + const stagedBundle = path.join(staging, "blender-web-offline"); + const archiveSha256 = sha256(deliveredArchive); + const installedRelease = path.join(releases, archiveSha256); + assert.ok(!fs.existsSync(installedRelease), "fresh install unexpectedly contains a release"); + fs.renameSync(stagedBundle, installedRelease); + fs.rmdirSync(staging); + const pendingLink = path.join(installRoot, ".current.next"); + fs.symlinkSync(path.join("releases", archiveSha256), pendingLink); + fs.renameSync(pendingLink, path.join(installRoot, "current")); + assert.equal(fs.realpathSync(path.join(installRoot, "current")), installedRelease); + assert.ok(!installedRelease.startsWith(`${repoRoot}${path.sep}`), "runbook installed inside the source workspace"); + + const bundleRoot = path.join(installRoot, "current"); + const appRoot = path.join(bundleRoot, "app"); + const contract = JSON.parse(fs.readFileSync(path.join(bundleRoot, "deployment-contract.json"), "utf8")); + const engine = JSON.parse(fs.readFileSync(path.join(appRoot, "engine-manifest.json"), "utf8")); + assert.equal(classifyOrigin("https://blender.example", contract).mode, "production-https"); + assert.equal(classifyOrigin("https://blender.example:8443", contract).mode, "production-https"); + assert.equal(classifyOrigin("http://127.0.0.1:8080", contract).mode, "loopback-http"); + for (const blocked of [ + "file:///tmp/blender/index.html", + "http://localhost:8080", + "http://0.0.0.0:8080", + "http://192.168.1.10:8080", + "https://user:secret@blender.example", + "https://blender.example/subpath", + ]) assert.equal(classifyOrigin(blocked, contract).status, "BLOCKED", `${blocked} must be blocked`); + + server = createDeploymentHttpServer({ root: appRoot, contract }); + const origin = await listenDeploymentHttpServer(server); + assert.equal(classifyOrigin(origin, contract).mode, "loopback-http"); + const indexResponse = await fetch(`${origin}/`, { method: "HEAD" }); + assert.equal(indexResponse.status, 200); + for (const [name, value] of Object.entries(contract.responseHeaders.allResponses)) assertHeader(indexResponse, name, value); + assertHeader(indexResponse, "cache-control", "no-cache"); + assertHeader(indexResponse, "content-type", contract.mimeTypes[".html"]); + assert.match(indexResponse.headers.get("etag") ?? "", /^"sha256-[a-f0-9]{64}"$/); + + const wasmPath = new URL(engine.variants.find((variant) => variant.id === "single").resources.wasm.url, origin); + const rangeResponse = await fetch(wasmPath, { headers: { Range: "bytes=0-15" } }); + assert.equal(rangeResponse.status, contract.rangeRequests.satisfiedStatus); + assert.equal((await rangeResponse.arrayBuffer()).byteLength, 16); + assertHeader(rangeResponse, "accept-ranges", "bytes"); + assert.match(rangeResponse.headers.get("content-range") ?? "", /^bytes 0-15\/\d+$/); + + const report = { + schemaVersion: 1, + task: "M6-17A", + status: "READY", + archive: { bytes: fs.statSync(deliveredArchive).size, sha256: archiveSha256 }, + engineReleaseId: engine.releaseId, + install: { + emptyRoot: true, + outsideSourceWorkspace: true, + immutableReleaseDirectory: path.relative(installRoot, installedRelease), + currentTarget: fs.readlinkSync(path.join(installRoot, "current")), + }, + transport: { + productionHttps: "READY", + loopbackHttp: "READY", + publicPlainHttp: "BLOCKED", + fileProtocol: "BLOCKED", + sameOriginRuntimeAssets: contract.transport.sameOriginRuntimeAssets, + }, + installedServer: { status: indexResponse.status, rangeStatus: rangeResponse.status, isolationHeaders: contract.responseHeaders.allResponses }, + }; + const reportRoot = path.join(releaseRoot, "operations-reports"); + fs.mkdirSync(reportRoot, { recursive: true }); + fs.writeFileSync(path.join(reportRoot, "deploy.json"), `${JSON.stringify(report, null, 2)}\n`); + process.stdout.write(`deployment-runbook-ok release=${engine.releaseId} archive=${archiveSha256} install=empty https=ready loopback=ready public-http=blocked\n`); +} +finally { + if (server) await new Promise((resolve) => server.close(resolve)); + fs.rmSync(workspace, { recursive: true, force: true }); +} diff --git a/tools/web/check-engine-variant-install.mjs b/tools/web/check-engine-variant-install.mjs new file mode 100644 index 00000000..bf23c161 --- /dev/null +++ b/tools/web/check-engine-variant-install.mjs @@ -0,0 +1,109 @@ +import assert from "node:assert/strict"; +import crypto from "node:crypto"; +import fs from "node:fs"; +import os from "node:os"; +import path from "node:path"; +import { spawnSync } from "node:child_process"; +import { fileURLToPath } from "node:url"; + +const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."); +const installer = path.join(repoRoot, "tools/web/install-web-engine-assets.sh"); +const workspace = fs.mkdtempSync(path.join(os.tmpdir(), "engine-variant-install-test-")); + +function sha256(bytes) { + return crypto.createHash("sha256").update(bytes).digest("hex"); +} + +function writeBuild(directory, label, includeWasm = true) { + fs.mkdirSync(directory, { recursive: true }); + fs.writeFileSync(path.join(directory, "web_engine.js"), `export default ${JSON.stringify(label)};\n`); + if (includeWasm) fs.writeFileSync(path.join(directory, "web_engine.wasm"), Buffer.from(`wasm:${label}`)); +} + +function writeLegacyManifest(publicRoot) { + fs.mkdirSync(publicRoot, { recursive: true }); + const manifestPath = path.join(publicRoot, "engine-manifest.json"); + fs.writeFileSync(manifestPath, `${JSON.stringify({ + schemaVersion: 1, + protocolVersion: 1, + engineVersion: "blender-wasm-install-test", + engine: "blender-wasm", + memory: { initialPages: 256, maximumPages: 32768, shared: false }, + wasm: [], + }, null, 2)}\n`); + return manifestPath; +} + +function runInstaller(singleBuild, pthreadBuild, publicRoot) { + return spawnSync("bash", [installer], { + cwd: repoRoot, + encoding: "utf8", + env: { + ...process.env, + WEB_ENGINE_SINGLE_BUILD_DIR: singleBuild, + WEB_ENGINE_PTHREAD_BUILD_DIR: pthreadBuild, + WEB_ENGINE_PUBLIC_ROOT: publicRoot, + }, + }); +} + +try { + const positive = path.join(workspace, "positive"); + const singleBuild = path.join(positive, "build-single"); + const pthreadBuild = path.join(positive, "build-pthread"); + const publicRoot = path.join(positive, "public"); + writeBuild(singleBuild, "single-output"); + writeBuild(pthreadBuild, "pthread-output"); + writeLegacyManifest(publicRoot); + fs.mkdirSync(path.join(publicRoot, "vendor/blender"), { recursive: true }); + fs.writeFileSync(path.join(publicRoot, "vendor/blender/web_engine.js"), "legacy-loader\n"); + + const installed = runInstaller(singleBuild, pthreadBuild, publicRoot); + assert.equal(installed.status, 0, installed.stderr || installed.stdout); + const manifest = JSON.parse(fs.readFileSync(path.join(publicRoot, "engine-manifest.json"), "utf8")); + assert.equal(manifest.schemaVersion, 2); + assert.equal(manifest.releaseId, "blender-wasm-install-test"); + assert.deepEqual(manifest.variants.map((variant) => variant.id), ["single", "pthread"]); + for (const [index, buildDirectory] of [[0, singleBuild], [1, pthreadBuild]]) { + const variant = manifest.variants[index]; + for (const role of ["js", "wasm"]) { + const resource = variant.resources[role]; + const source = fs.readFileSync(path.join(buildDirectory, resource.fileName)); + const target = fs.readFileSync(path.join(publicRoot, resource.url)); + assert.deepEqual(target, source); + assert.equal(resource.sha256, sha256(source)); + } + } + assert.equal(fs.readFileSync(path.join(publicRoot, "vendor/blender/web_engine.js"), "utf8"), "legacy-loader\n"); + assert.deepEqual(manifest.variants[1].resources.pthreadWorker, manifest.variants[1].resources.js); + + const sameBuildRoot = path.join(workspace, "same-build-negative"); + const sameBuild = path.join(sameBuildRoot, "build"); + const samePublic = path.join(sameBuildRoot, "public"); + writeBuild(sameBuild, "same-output"); + const sameManifest = writeLegacyManifest(samePublic); + const beforeSame = fs.readFileSync(sameManifest); + const sameResult = runInstaller(sameBuild, sameBuild, samePublic); + assert.notEqual(sameResult.status, 0); + assert.match(sameResult.stderr, /independent build directories/); + assert.deepEqual(fs.readFileSync(sameManifest), beforeSame); + assert.equal(fs.existsSync(path.join(samePublic, "vendor/blender/single")), false); + + const missingRoot = path.join(workspace, "missing-asset-negative"); + const completeBuild = path.join(missingRoot, "build-single"); + const incompleteBuild = path.join(missingRoot, "build-pthread"); + const missingPublic = path.join(missingRoot, "public"); + writeBuild(completeBuild, "complete-output"); + writeBuild(incompleteBuild, "incomplete-output", false); + const missingManifest = writeLegacyManifest(missingPublic); + const beforeMissing = fs.readFileSync(missingManifest); + const missingResult = runInstaller(completeBuild, incompleteBuild, missingPublic); + assert.notEqual(missingResult.status, 0); + assert.deepEqual(fs.readFileSync(missingManifest), beforeMissing); + assert.equal(fs.existsSync(path.join(missingPublic, "vendor/blender/single")), false); + + process.stdout.write("engine-variant-install-ok variants=2 negativeCases=2\n"); +} +finally { + fs.rmSync(workspace, { recursive: true, force: true }); +} diff --git a/tools/web/check-local-deps.sh b/tools/web/check-local-deps.sh index 9e5d265e..0c183e28 100755 --- a/tools/web/check-local-deps.sh +++ b/tools/web/check-local-deps.sh @@ -33,6 +33,10 @@ test -s "${web_dir}/app/src/vendor/blender/web_engine.js" test -s "${web_dir}/app/src/vendor/blender/web_engine.wasm" test -s "${web_dir}/app/public/vendor/blender/web_engine.js" test -s "${web_dir}/app/public/vendor/blender/web_engine.wasm" +test -s "${web_dir}/app/public/vendor/blender/single/web_engine.js" +test -s "${web_dir}/app/public/vendor/blender/single/web_engine.wasm" +test -s "${web_dir}/app/public/vendor/blender/pthread/web_engine.js" +test -s "${web_dir}/app/public/vendor/blender/pthread/web_engine.wasm" cmp "${web_dir}/app/src/vendor/blender/web_engine.js" "${web_dir}/app/public/vendor/blender/web_engine.js" cmp "${web_dir}/app/src/vendor/blender/web_engine.wasm" "${web_dir}/app/public/vendor/blender/web_engine.wasm" test -s "${repo_root}/blender-5.2.0/extern/zlib/CMakeLists.txt" diff --git a/tools/web/check-manifest-assets.mjs b/tools/web/check-manifest-assets.mjs index 7b8bf6a5..c2323608 100644 --- a/tools/web/check-manifest-assets.mjs +++ b/tools/web/check-manifest-assets.mjs @@ -6,12 +6,20 @@ const [manifestPath, publicRoot] = process.argv.slice(2); if (!manifestPath || !publicRoot) throw new Error("usage: check-manifest-assets.mjs MANIFEST PUBLIC_ROOT"); const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8")); -for (const resource of manifest.wasm ?? []) { +if (manifest.schemaVersion === 2 && + (typeof manifest.releaseId !== "string" || !/^[A-Za-z0-9][A-Za-z0-9._+-]{0,127}$/.test(manifest.releaseId))) { + throw new Error("schema v2 engine manifest has no valid releaseId"); +} +const resources = manifest.schemaVersion === 2 + ? manifest.variants.flatMap((variant) => Object.values(variant.resources)) + : manifest.wasm ?? []; +const uniqueResources = [...new Map(resources.map((resource) => [resource.url, resource])).values()]; +for (const resource of uniqueResources) { const relativePath = resource.url.replace(/^\/+/, ""); const filePath = path.join(publicRoot, relativePath); const actual = crypto.createHash("sha256").update(fs.readFileSync(filePath)).digest("hex"); if (actual !== String(resource.sha256).toLowerCase()) { - throw new Error(`manifest hash mismatch: ${resource.id} expected=${resource.sha256} actual=${actual}`); + throw new Error(`manifest hash mismatch: ${resource.url} expected=${resource.sha256} actual=${actual}`); } } -console.log(`manifest-assets-ok resources=${(manifest.wasm ?? []).length}`); +console.log(`manifest-assets-ok resources=${uniqueResources.length}`); diff --git a/tools/web/check-operations-diagnostics.mjs b/tools/web/check-operations-diagnostics.mjs new file mode 100644 index 00000000..0d1750a8 --- /dev/null +++ b/tools/web/check-operations-diagnostics.mjs @@ -0,0 +1,58 @@ +import assert from "node:assert/strict"; +import crypto from "node:crypto"; +import fs from "node:fs"; +import path from "node:path"; +import { fileURLToPath } from "node:url"; + +const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."); +const sourcePath = path.join(repoRoot, "docs/web/operations-diagnostics.json"); +const diagnostics = JSON.parse(fs.readFileSync(sourcePath, "utf8")); +const contract = JSON.parse(fs.readFileSync(path.join(repoRoot, "docs/web/deployment-contract.json"), "utf8")); +const guide = fs.readFileSync(path.join(repoRoot, "docs/web/DEPLOYMENT.md"), "utf8"); +const requiredDomains = ["mime", "range", "isolation", "hash", "quota", "worker", "gpu"]; + +assert.equal(diagnostics.schemaVersion, 1); +assert.equal(diagnostics.product, contract.product); +assert.deepEqual(diagnostics.entries.map((entry) => entry.domain).sort(), [...requiredDomains].sort()); +assert.equal(new Set(diagnostics.entries.map((entry) => entry.id)).size, requiredDomains.length); +const allSignals = diagnostics.entries.flatMap((entry) => entry.signals); +assert.equal(new Set(allSignals).size, allSignals.length, "diagnostic signals must be unambiguous"); + +for (const entry of diagnostics.entries) { + assert.match(entry.id, /^OPS-[A-Z]+$/); + for (const name of ["signals", "checks", "expected", "recovery"]) { + assert.ok(Array.isArray(entry[name]) && entry[name].length > 0, `${entry.id} omits ${name}`); + assert.ok(entry[name].every((value) => typeof value === "string" && value.length > 0), `${entry.id} has an empty ${name}`); + } + assert.ok(typeof entry.dataSafety === "string" && entry.dataSafety.length > 0, `${entry.id} omits dataSafety`); + assert.ok(guide.toLowerCase().includes(`| ${entry.domain}`), `${entry.id} is absent from DEPLOYMENT.md`); +} + +const byDomain = Object.fromEntries(diagnostics.entries.map((entry) => [entry.domain, entry])); +for (const mime of [contract.mimeTypes[".wasm"], contract.mimeTypes[".js"], contract.mimeTypes[".json"]]) { + assert.ok(byDomain.mime.expected.some((value) => value.includes(mime)), `MIME diagnostics omit ${mime}`); +} +for (const status of [contract.rangeRequests.satisfiedStatus, contract.rangeRequests.unsatisfiedStatus, 200]) { + assert.ok(byDomain.range.expected.some((value) => value.includes(String(status))), `range diagnostics omit ${status}`); +} +for (const [name, value] of Object.entries(contract.responseHeaders.allResponses)) { + assert.ok(byDomain.isolation.expected.some((item) => item.includes(name) && item.includes(value)), `isolation diagnostics omit ${name}`); +} +assert.ok(byDomain.hash.expected.some((value) => value.includes("no fallback") && value.includes("no project open"))); +assert.ok(byDomain.quota.dataSafety.includes("Never delete")); +assert.ok(byDomain.worker.dataSafety.includes("late Worker output")); +assert.ok(byDomain.gpu.dataSafety.includes("must not rewrite")); + +const report = { + schemaVersion: 1, + task: "M6-17D", + status: "READY", + sourceSha256: crypto.createHash("sha256").update(fs.readFileSync(sourcePath)).digest("hex"), + domains: requiredDomains, + entries: diagnostics.entries.length, + signals: allSignals.length, +}; +const reportRoot = path.join(repoRoot, "release/operations-reports"); +fs.mkdirSync(reportRoot, { recursive: true }); +fs.writeFileSync(path.join(reportRoot, "diagnostics.json"), `${JSON.stringify(report, null, 2)}\n`); +process.stdout.write(`operations-diagnostics-ok domains=${requiredDomains.join(",")} signals=${allSignals.length} source=${report.sourceSha256}\n`); diff --git a/tools/web/check-rc-known-limitations.mjs b/tools/web/check-rc-known-limitations.mjs new file mode 100644 index 00000000..f784d672 --- /dev/null +++ b/tools/web/check-rc-known-limitations.mjs @@ -0,0 +1,50 @@ +import assert from "node:assert/strict"; +import fs from "node:fs"; +import path from "node:path"; +import { fileURLToPath } from "node:url"; + +const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."); +const limitationsPath = path.join(repoRoot, "docs/web/KNOWN_LIMITATIONS.md"); +const limitations = fs.readFileSync(limitationsPath, "utf8"); +const notes = fs.readFileSync(path.join(repoRoot, "docs/web/RELEASE_NOTES.md"), "utf8"); +const engine = JSON.parse(fs.readFileSync(path.join(repoRoot, "web/app/public/engine-manifest.json"), "utf8")); + +assert.ok(notes.includes("[Known limitations](KNOWN_LIMITATIONS.md)"), "release notes do not link known limitations"); +for (const variant of engine.variants) { + assert.equal(variant.memory.initialPages, 256); + assert.equal(variant.memory.maximumPages, 32_768); +} +for (const required of [ + "Chromium is the only V1 browser baseline", + "crossOriginIsolated", + "SharedArrayBuffer", + "PTHREAD_REQUIRED", + "SINGLE_REQUIRED", + "ENGINE_VARIANT_INTEGRITY_FAILED", + "REFRESH_REQUIRED", + "256 initial WebAssembly pages (16 MiB)", + "32,768-page ceiling (2 GiB)", + "bound to the exact scheme, host and port", + "reserves no minimum capacity", + "64 MiB", + "16,384 pixels per dimension", + "256 requested", + "VDB input is bounded to 512 MiB", + "NanoVDB bundle to 1 GiB", + "residency to at most 512 MiB", + "Automatic viewport page-fault feedback", +]) { + assert.ok(limitations.includes(required), `known limitations omit: ${required}`); +} +const renderAssets = fs.readFileSync(path.join(repoRoot, "web/protocol/render-assets.ts"), "utf8"); +assert.match(renderAssets, /MAX_GPU_TEXTURE_BYTES = 64 \* 1024 \* 1024/); +assert.match(renderAssets, /MAX_GPU_TEXTURE_DIMENSION = 16_384/); +assert.match(renderAssets, /MAX_GPU_TEXTURE_ASSETS = 256/); +const volume = fs.readFileSync(path.join(repoRoot, "web/protocol/volume-vdb.ts"), "utf8"); +assert.match(volume, /VDB_MAX_RESOURCE_BYTES = 512 \* 1024 \* 1024/); +assert.match(volume, /NANOVDB_MAX_BUNDLE_BYTES = 1024 \* 1024 \* 1024/); +assert.match(volume, /NANOVDB_MAX_GPU_RESIDENT_BYTES = 512 \* 1024 \* 1024/); +for (const link of ["V1_SCOPE.md", "parity-ledger.json", "DEPLOYMENT.md", "operations-diagnostics.json"]) { + assert.ok(limitations.includes(`](${link})`), `known limitations omit link: ${link}`); +} +process.stdout.write(`rc-known-limitations-ok variants=${engine.variants.length} wasmMaximumPages=${engine.variants[0].memory.maximumPages}\n`); diff --git a/tools/web/check-rc-manifest.mjs b/tools/web/check-rc-manifest.mjs new file mode 100644 index 00000000..6b7d6dec --- /dev/null +++ b/tools/web/check-rc-manifest.mjs @@ -0,0 +1,75 @@ +import assert from "node:assert/strict"; +import crypto from "node:crypto"; +import fs from "node:fs"; +import path from "node:path"; +import { execFileSync } from "node:child_process"; +import { fileURLToPath } from "node:url"; + +const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."); +const manifestPath = path.join(repoRoot, "release/RC_MANIFEST.json"); +const manifestBytes = fs.readFileSync(manifestPath); +const manifest = JSON.parse(manifestBytes); +const sha256Bytes = (value) => crypto.createHash("sha256").update(value).digest("hex"); +const sha256File = (file) => sha256Bytes(fs.readFileSync(file)); +const archiveEntry = (archive, entry) => execFileSync("tar", ["-xOf", archive, entry], { maxBuffer: 32 * 1024 * 1024 }); +const packageJson = JSON.parse(fs.readFileSync(path.join(repoRoot, "web/package.json"), "utf8")); +const lockfile = JSON.parse(fs.readFileSync(path.join(repoRoot, "web/package-lock.json"), "utf8")); +const engine = JSON.parse(fs.readFileSync(path.join(repoRoot, "web/app/public/engine-manifest.json"), "utf8")); +const binaryArchive = path.join(repoRoot, manifest.artifacts.binaryArchive.path); +const sourceArchive = path.join(repoRoot, manifest.artifacts.sourceArchive.path); +const sbomPath = path.join(repoRoot, manifest.artifacts.sbom.path); +const sumsPath = path.join(repoRoot, "release/SHA256SUMS.txt"); + +assert.equal(manifest.schemaVersion, 1); +assert.match(manifest.semver, /^\d+\.\d+\.\d+-rc\.\d+$/); +assert.equal(manifest.rcId, `web-blender-${manifest.semver}`); +assert.equal(packageJson.version, manifest.semver); +assert.equal(lockfile.version, manifest.semver); +assert.equal(lockfile.packages[""].version, manifest.semver); +assert.equal(engine.releaseId, manifest.engineReleaseId); +assert.equal(engine.engineVersion, manifest.engineReleaseId); +assert.equal(manifest.engineReleaseId, `blender-wasm-${manifest.semver}`); +assert.equal(manifest.gitCommit, execFileSync("git", ["rev-parse", "HEAD"], { cwd: repoRoot, encoding: "utf8" }).trim()); +assert.equal(manifest.sourceBinding.mode, "corresponding-source-archive"); +assert.equal(typeof manifest.sourceBinding.worktreeDirty, "boolean"); + +for (const entry of Object.values(manifest.artifacts)) { + const file = path.join(repoRoot, entry.path); + assert.equal(fs.statSync(file).size, entry.bytes, `${entry.path} byte length drifted`); + assert.equal(sha256File(file), entry.sha256, `${entry.path} SHA-256 drifted`); +} +const embeddedPackageJson = archiveEntry(sourceArchive, "web/package.json"); +const embeddedPackageLock = archiveEntry(sourceArchive, "web/package-lock.json"); +const embeddedEngineManifest = archiveEntry(binaryArchive, "blender-web-offline/app/engine-manifest.json"); +const embeddedReleaseMetadata = archiveEntry(binaryArchive, "blender-web-offline/release-metadata.json"); +const embeddedSbom = archiveEntry(binaryArchive, "blender-web-offline/sbom.spdx.json"); +assert.deepEqual(embeddedPackageJson, fs.readFileSync(path.join(repoRoot, "web/package.json"))); +assert.deepEqual(embeddedPackageLock, fs.readFileSync(path.join(repoRoot, "web/package-lock.json"))); +assert.deepEqual(embeddedEngineManifest, fs.readFileSync(path.join(repoRoot, "web/app/public/engine-manifest.json"))); +assert.deepEqual(embeddedSbom, fs.readFileSync(sbomPath)); +const releaseMetadata = JSON.parse(embeddedReleaseMetadata.toString("utf8")); +const sourceManifest = JSON.parse(archiveEntry(sourceArchive, "SOURCE_MANIFEST.json").toString("utf8")); +assert.equal(releaseMetadata.productVersion, manifest.semver); +assert.equal(releaseMetadata.engineReleaseId, manifest.engineReleaseId); +assert.equal(sourceManifest.version, manifest.semver); +assert.equal(sourceManifest.engineReleaseId, manifest.engineReleaseId); +assert.equal(manifest.bindings.packageJsonSha256, sha256File(path.join(repoRoot, "web/package.json"))); +assert.equal(manifest.bindings.packageLockSha256, sha256File(path.join(repoRoot, "web/package-lock.json"))); +assert.equal(manifest.bindings.ledgerSha256, sha256File(path.join(repoRoot, "docs/status/parity-ledger.json"))); +assert.equal(manifest.bindings.engineManifestSha256, sha256File(path.join(repoRoot, "web/app/public/engine-manifest.json"))); +assert.equal(manifest.bindings.embeddedReleaseMetadataSha256, sha256Bytes(embeddedReleaseMetadata)); +assert.equal(manifest.bindings.sha256SumsSha256, sha256File(sumsPath)); +assert.deepEqual(Object.keys(manifest.operations), ["deploy", "upgrade", "rollback", "diagnostics", "rehearsal"]); +for (const entry of Object.values(manifest.operations)) { + const file = path.join(repoRoot, entry.path); + assert.equal(fs.statSync(file).size, entry.bytes); + assert.equal(sha256File(file), entry.sha256); +} +const manifestSha256 = sha256Bytes(manifestBytes); +assert.equal(fs.readFileSync(`${manifestPath}.sha256`, "utf8"), `${manifestSha256} RC_MANIFEST.json\n`); +const checksumLines = fs.readFileSync(sumsPath, "utf8").trim().split("\n"); +assert.deepEqual(checksumLines, [ + `${manifest.artifacts.binaryArchive.sha256} blender-web-offline.tar.gz`, + `${manifest.artifacts.sourceArchive.sha256} blender-web-corresponding-source.tar.gz`, +]); +process.stdout.write(`rc-manifest-check-ok id=${manifest.rcId} commit=${manifest.gitCommit} artifacts=3 operations=${Object.keys(manifest.operations).length}\n`); diff --git a/tools/web/check-rc-release-notes.mjs b/tools/web/check-rc-release-notes.mjs new file mode 100644 index 00000000..fdffdb45 --- /dev/null +++ b/tools/web/check-rc-release-notes.mjs @@ -0,0 +1,39 @@ +import assert from "node:assert/strict"; +import fs from "node:fs"; +import path from "node:path"; +import { fileURLToPath } from "node:url"; + +const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."); +const notesPath = path.join(repoRoot, "docs/web/RELEASE_NOTES.md"); +const notes = fs.readFileSync(notesPath, "utf8"); +const packageJson = JSON.parse(fs.readFileSync(path.join(repoRoot, "web/package.json"), "utf8")); +const engine = JSON.parse(fs.readFileSync(path.join(repoRoot, "web/app/public/engine-manifest.json"), "utf8")); +const ledger = JSON.parse(fs.readFileSync(path.join(repoRoot, "docs/status/parity-ledger.json"), "utf8")); + +assert.match(notes, new RegExp(`^# Web Blender Modeler V1 ${packageJson.version.replaceAll(".", "\\.")} Release Notes`, "m")); +assert.match(notes, new RegExp(`engine\\s+\`${engine.releaseId.replaceAll(".", "\\.")}\``)); +for (const capability of ["\.blend", "undo", "redo", "OffscreenCanvas", "single-thread", "pthread", "OPFS", "10M geometry", "8K textures", "SBOM"]) { + assert.match(notes, new RegExp(capability, "i"), `release notes omit verified capability: ${capability}`); +} +for (const boundary of ["LOCAL_EXACT", "LOCAL_BOUNDED", "SERVER", "EXCLUDED", "Chromium-only", "not a browser port"]) { + assert.ok(notes.includes(boundary), `release notes omit capability boundary: ${boundary}`); +} +const releaseReady = ledger.families.filter((family) => family.releaseStatus === "READY").length; +const parityBlocked = ledger.families.filter((family) => family.parityStatus === "BLOCKED").length; +assert.equal(releaseReady, 12); +assert.equal(parityBlocked, 12); +assert.ok(notes.includes(`All ${releaseReady} V1 family release slices are \`READY\``)); +assert.match(notes, new RegExp(`all ${parityBlocked} complete Blender 5\\.2 family parity states are\\s+\`BLOCKED\``)); + +const links = [...notes.matchAll(/\[[^\]]+\]\(([^)]+)\)/g)].map((match) => match[1]); +assert.ok(links.length >= 5, "release notes do not link the capability and operations sources"); +for (const link of links) { + assert.doesNotMatch(link, /^(?:https?:|\/)/, `release notes contain an external or absolute link: ${link}`); + const source = link === "V1_SCOPE.md" + ? path.join(repoRoot, "docs/WEB_BLENDER_MODELER_V1_SCOPE.md") + : link === "parity-ledger.json" + ? path.join(repoRoot, "docs/status/parity-ledger.json") + : path.join(repoRoot, "docs/web", link); + assert.ok(fs.statSync(source).isFile(), `release note link is unresolved: ${link}`); +} +process.stdout.write(`rc-release-notes-ok version=${packageJson.version} ready=${releaseReady} parityBlocked=${parityBlocked} links=${links.length}\n`); diff --git a/tools/web/check-rc-release-recovery.mjs b/tools/web/check-rc-release-recovery.mjs new file mode 100644 index 00000000..77ed183c --- /dev/null +++ b/tools/web/check-rc-release-recovery.mjs @@ -0,0 +1,39 @@ +import assert from "node:assert/strict"; +import fs from "node:fs"; +import path from "node:path"; +import { fileURLToPath } from "node:url"; + +const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."); +const recovery = fs.readFileSync(path.join(repoRoot, "docs/web/RELEASE_RECOVERY.md"), "utf8"); +const notes = fs.readFileSync(path.join(repoRoot, "docs/web/RELEASE_NOTES.md"), "utf8"); +const app = fs.readFileSync(path.join(repoRoot, "web/app/src/app/App.tsx"), "utf8"); +const deployment = fs.readFileSync(path.join(repoRoot, "docs/web/DEPLOYMENT.md"), "utf8"); + +assert.ok(notes.includes("[Release recovery](RELEASE_RECOVERY.md)"), "release notes do not link release recovery"); +for (const required of [ + "sha256sum --check SHA256SUMS.txt", + "sha256sum --check RC_MANIFEST.json.sha256", + "test:rc-manifest", + "test:binary-archive", + "test:source-archive", + "check-ci-report.mjs", + "Save Project", + "blender-web.blend", + "SceneIR revision", + "readlink current", + "failure before the switch", + "failure after the switch", + "INDEXEDDB_SCHEMA_DOWNGRADE_UNSUPPORTED", + "OPFS_REVERSE_MIGRATION_UNDECLARED", + "Recover Project", + "Open .blend", + "test:operations-rehearsal", +]) { + assert.ok(recovery.toLowerCase().includes(required.toLowerCase()), `release recovery omits: ${required}`); +} +assert.match(app, /anchor\.download = "blender-web\.blend"/); +assert.match(app, /await storage\.saveProject\(projectIdRef\.current, revision, data\.slice\(0\)\)/); +assert.match(deployment, /Rollback changes only the `current` app\/engine release pointer/); +assert.match(deployment, /in-place rollback is\s+`BLOCKED`/); +for (const link of ["DEPLOYMENT.md"]) assert.ok(recovery.includes(`](${link})`)); +process.stdout.write("rc-release-recovery-ok checksums=2 archives=2 schemaBlocks=2 projectBackup=downloaded-blend\n"); diff --git a/tools/web/check-rollback-runbook.mjs b/tools/web/check-rollback-runbook.mjs new file mode 100644 index 00000000..317b635d --- /dev/null +++ b/tools/web/check-rollback-runbook.mjs @@ -0,0 +1,136 @@ +import assert from "node:assert/strict"; +import crypto from "node:crypto"; +import fs from "node:fs"; +import os from "node:os"; +import path from "node:path"; +import { execFileSync } from "node:child_process"; +import { fileURLToPath } from "node:url"; + +const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."); +const archive = path.join(repoRoot, "release/blender-web-offline.tar.gz"); +const reportRoot = path.join(repoRoot, "release/operations-reports"); +const workspace = fs.mkdtempSync(path.join(os.tmpdir(), "blender-rollback-runbook-")); +const sha256 = (value) => crypto.createHash("sha256").update(value).digest("hex"); + +function readJson(file) { + return JSON.parse(fs.readFileSync(file, "utf8")); +} + +function writeMetadata(release, metadata) { + fs.writeFileSync(path.join(release, "release-metadata.json"), `${JSON.stringify(metadata, null, 2)}\n`); +} + +function switchCurrent(installRoot, releaseName) { + const pending = path.join(installRoot, ".current.next"); + fs.rmSync(pending, { force: true }); + fs.symlinkSync(path.join("releases", releaseName), pending); + fs.renameSync(pending, path.join(installRoot, "current")); +} + +function rollbackCompatibility(openedStorage, target) { + if (target.storage.indexedDbSchemaVersion < openedStorage.indexedDbSchemaVersion) { + return { status: "BLOCKED", reason: "INDEXEDDB_SCHEMA_DOWNGRADE_UNSUPPORTED" }; + } + if (target.storage.opfsProjectManifestSchemaVersion !== openedStorage.opfsProjectManifestSchemaVersion) { + return { status: "BLOCKED", reason: "OPFS_REVERSE_MIGRATION_UNDECLARED" }; + } + return { status: "READY", reason: null }; +} + +try { + const installRoot = path.join(workspace, "install"); + const releases = path.join(installRoot, "releases"); + const originStorage = path.join(workspace, "origin-storage", "projects", "project-a"); + fs.mkdirSync(releases, { recursive: true }); + fs.mkdirSync(originStorage, { recursive: true }); + + const extracted = path.join(workspace, "extracted"); + fs.mkdirSync(extracted); + execFileSync("tar", ["--no-same-owner", "--no-same-permissions", "-xzf", archive, "-C", extracted]); + const currentRelease = path.join(releases, "current-release"); + fs.renameSync(path.join(extracted, "blender-web-offline"), currentRelease); + const currentMetadata = readJson(path.join(currentRelease, "release-metadata.json")); + + const compatibleOld = path.join(releases, "compatible-old-release"); + fs.cpSync(currentRelease, compatibleOld, { recursive: true }); + const compatibleMetadata = structuredClone(currentMetadata); + compatibleMetadata.productVersion = "0.0.9-compatible"; + compatibleMetadata.engineReleaseId = `${currentMetadata.engineReleaseId}-compatible-old`; + writeMetadata(compatibleOld, compatibleMetadata); + + const incompatibleOld = path.join(releases, "incompatible-old-release"); + fs.cpSync(currentRelease, incompatibleOld, { recursive: true }); + const incompatibleMetadata = structuredClone(currentMetadata); + incompatibleMetadata.productVersion = "0.0.8-incompatible"; + incompatibleMetadata.engineReleaseId = `${currentMetadata.engineReleaseId}-incompatible-old`; + incompatibleMetadata.storage.indexedDbSchemaVersion = Math.max(1, currentMetadata.storage.indexedDbSchemaVersion - 1); + writeMetadata(incompatibleOld, incompatibleMetadata); + + switchCurrent(installRoot, path.basename(currentRelease)); + const blend = Buffer.from("M6-17C persistent project content"); + const project = { + schemaVersion: currentMetadata.storage.opfsProjectManifestSchemaVersion, + revision: 17, + bytes: blend.byteLength, + sha256: sha256(blend), + }; + fs.writeFileSync(path.join(originStorage, "scene.blend"), blend); + fs.writeFileSync(path.join(originStorage, "scene.blend.meta.json"), `${JSON.stringify(project)}\n`); + const projectBytesBefore = fs.readFileSync(path.join(originStorage, "scene.blend")); + const manifestBefore = fs.readFileSync(path.join(originStorage, "scene.blend.meta.json")); + const currentBefore = fs.realpathSync(path.join(installRoot, "current")); + + const openedStorage = { + indexedDbSchemaVersion: currentMetadata.storage.indexedDbSchemaVersion, + opfsProjectManifestSchemaVersion: currentMetadata.storage.opfsProjectManifestSchemaVersion, + }; + const blocked = rollbackCompatibility(openedStorage, incompatibleMetadata); + assert.deepEqual(blocked, { status: "BLOCKED", reason: "INDEXEDDB_SCHEMA_DOWNGRADE_UNSUPPORTED" }); + assert.equal(fs.realpathSync(path.join(installRoot, "current")), currentBefore, "blocked rollback changed current"); + assert.deepEqual(fs.readFileSync(path.join(originStorage, "scene.blend")), projectBytesBefore); + assert.deepEqual(fs.readFileSync(path.join(originStorage, "scene.blend.meta.json")), manifestBefore); + + const compatible = rollbackCompatibility(openedStorage, compatibleMetadata); + assert.deepEqual(compatible, { status: "READY", reason: null }); + switchCurrent(installRoot, path.basename(compatibleOld)); + assert.equal(fs.realpathSync(path.join(installRoot, "current")), compatibleOld); + assert.equal(readJson(path.join(installRoot, "current", "release-metadata.json")).engineReleaseId, compatibleMetadata.engineReleaseId); + assert.deepEqual(fs.readFileSync(path.join(originStorage, "scene.blend")), projectBytesBefore); + assert.deepEqual(fs.readFileSync(path.join(originStorage, "scene.blend.meta.json")), manifestBefore); + const reopened = readJson(path.join(originStorage, "scene.blend.meta.json")); + assert.equal(reopened.revision, project.revision); + assert.equal(reopened.sha256, sha256(fs.readFileSync(path.join(originStorage, "scene.blend")))); + assert.ok(fs.statSync(currentRelease).isDirectory(), "newer release was removed during rollback"); + + const opfsBlockedTarget = structuredClone(compatibleMetadata); + opfsBlockedTarget.storage.opfsProjectManifestSchemaVersion += 1; + assert.deepEqual(rollbackCompatibility(openedStorage, opfsBlockedTarget), { + status: "BLOCKED", + reason: "OPFS_REVERSE_MIGRATION_UNDECLARED", + }); + + const report = { + schemaVersion: 1, + task: "M6-17C", + status: "READY", + activeBefore: currentMetadata.engineReleaseId, + activeAfter: compatibleMetadata.engineReleaseId, + compatibleRollback: compatible, + blockedOldReader: blocked, + blockedOpfsMismatch: "OPFS_REVERSE_MIGRATION_UNDECLARED", + project: { + revisionBefore: project.revision, + revisionAfter: reopened.revision, + sha256Before: project.sha256, + sha256After: reopened.sha256, + preserved: true, + }, + releases: { newerRetained: true, targetSwitchedAtomically: true }, + }; + fs.mkdirSync(reportRoot, { recursive: true }); + fs.writeFileSync(path.join(reportRoot, "rollback.json"), `${JSON.stringify(report, null, 2)}\n`); + process.stdout.write(`rollback-runbook-ok compatible=ready idb-downgrade=blocked opfs-mismatch=blocked revision=${project.revision} project=${project.sha256}\n`); +} +finally { + fs.rmSync(workspace, { recursive: true, force: true }); +} diff --git a/tools/web/check-source-archive.mjs b/tools/web/check-source-archive.mjs new file mode 100644 index 00000000..110b2107 --- /dev/null +++ b/tools/web/check-source-archive.mjs @@ -0,0 +1,165 @@ +import assert from "node:assert/strict"; +import crypto from "node:crypto"; +import fs from "node:fs"; +import os from "node:os"; +import path from "node:path"; +import { execFileSync, spawnSync } from "node:child_process"; +import { fileURLToPath } from "node:url"; + +const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."); +const releaseRoot = path.join(repoRoot, "release"); +const sourceArchive = path.resolve(process.env.M6_SOURCE_ARCHIVE ?? path.join(releaseRoot, "blender-web-corresponding-source.tar.gz")); +const binaryArchive = path.resolve(process.env.M6_BINARY_ARCHIVE ?? path.join(releaseRoot, "blender-web-offline.tar.gz")); +const workspace = fs.mkdtempSync(path.join(os.tmpdir(), "blender-source-archive-")); +const sourceRoot = path.join(workspace, "source"); +const binaryRoot = path.join(workspace, "binary"); + +const sha256 = (file) => crypto.createHash("sha256").update(fs.readFileSync(file)).digest("hex"); + +function archiveEntries(archive) { + const entries = execFileSync("tar", ["-tzf", archive], { encoding: "utf8", maxBuffer: 32 * 1024 * 1024 }).split("\n").filter(Boolean); + assert.ok(entries.length > 0, `${path.basename(archive)} is empty`); + for (const entry of entries) { + assert.ok(!entry.startsWith("/") && !entry.split("/").includes(".."), `unsafe archive path: ${entry}`); + } + return entries; +} + +function run(command, args, cwd) { + const result = spawnSync(command, args, { + cwd, + encoding: "utf8", + env: { ...process.env, FORCE_COLOR: "0", NO_COLOR: "1" }, + maxBuffer: 32 * 1024 * 1024, + }); + const output = `${result.stdout ?? ""}\n${result.stderr ?? ""}`.trim(); + assert.equal(result.status, 0, `${command} ${args.join(" ")} failed\n${output.slice(-8000)}`); + return output; +} + +function firstPartyTextFiles(root) { + const files = []; + const visit = (directory) => { + if (!fs.existsSync(directory)) return; + for (const entry of fs.readdirSync(directory, { withFileTypes: true })) { + const absolute = path.join(directory, entry.name); + const relative = path.relative(root, absolute).replaceAll(path.sep, "/"); + if (relative.startsWith("web/app/public/vendor/") || relative.startsWith("web/app/src/vendor/")) continue; + if (entry.isDirectory()) visit(absolute); + else if (entry.isFile() && fs.statSync(absolute).size <= 2 * 1024 * 1024 && /\.(?:c|cc|cpp|h|hh|hpp|js|mjs|json|md|sh|ts|tsx|txt|yml|yaml)$/.test(entry.name)) files.push(absolute); + } + }; + for (const relative of ["web", "tools/web", "docs/web"]) visit(path.join(root, relative)); + for (const relative of ["docs/PROJECT_STATUS_AND_NEXT_WORK.md", "WEB_BLENDER_MIGRATION_EXECUTION_PLAN.md"]) { + const file = path.join(root, relative); + if (fs.existsSync(file)) files.push(file); + } + return files; +} + +function distManifest(root) { + const files = []; + const visit = (directory, base) => { + for (const entry of fs.readdirSync(directory, { withFileTypes: true }).sort((left, right) => left.name.localeCompare(right.name))) { + const absolute = path.join(directory, entry.name); + if (entry.isDirectory()) visit(absolute, base); + else files.push({ path: path.relative(base, absolute).replaceAll(path.sep, "/"), bytes: fs.statSync(absolute).size, sha256: sha256(absolute) }); + } + }; + visit(root, root); + return files; +} + +try { + assert.ok(fs.statSync(sourceArchive).isFile(), `source archive is missing: ${sourceArchive}`); + assert.ok(fs.statSync(binaryArchive).isFile(), `binary archive is missing: ${binaryArchive}`); + const entries = archiveEntries(sourceArchive); + const forbidden = entries.filter((entry) => + /(^|\/)(?:node_modules|dist|test-results|playwright-report|__pycache__)(?:\/|$)/.test(entry) || + /\.pyc$/.test(entry) || + /^(?:release|build_[^/]*|\.emcache)(?:\/|$)/.test(entry), + ); + assert.deepEqual(forbidden, [], `source archive contains generated output: ${forbidden.join(", ")}`); + + fs.mkdirSync(sourceRoot); + fs.mkdirSync(binaryRoot); + execFileSync("tar", ["--no-same-owner", "--no-same-permissions", "-xzf", sourceArchive, "-C", sourceRoot]); + execFileSync("tar", ["--no-same-owner", "--no-same-permissions", "-xzf", binaryArchive, "-C", binaryRoot]); + assert.ok(!fs.realpathSync(sourceRoot).startsWith(`${repoRoot}${path.sep}`), "source archive was not extracted independently"); + + const required = [ + "SOURCE_MANIFEST.json", + "blender-5.2.0/COPYING", + "blender-5.2.0/CMakeLists.txt", + "blender-5.2.0/source/blender/web_engine/CMakeLists.txt", + "web/package.json", + "web/package-lock.json", + "web/app/vite.config.ts", + "web/app/src/main.tsx", + "web/protocol/manifest.ts", + "tools/web/create-offline-release.mjs", + ]; + for (const relative of required) assert.ok(fs.lstatSync(path.join(sourceRoot, relative)), `source archive omits ${relative}`); + const sourceOffer = fs.readFileSync(path.join(binaryRoot, "blender-web-offline/SOURCE_OFFER.txt"), "utf8"); + assert.match(sourceOffer, /blender-web-corresponding-source\.tar\.gz/); + assert.match(sourceOffer, /Blender 5\.2/); + + const manifestPath = path.join(sourceRoot, "SOURCE_MANIFEST.json"); + const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8")); + assert.equal(manifest.schemaVersion, 1); + assert.equal(manifest.product, "Web Blender Modeler V1"); + assert.ok(Array.isArray(manifest.files) && manifest.files.length > 10_000, "source manifest is incomplete"); + const actualPaths = entries.filter((entry) => !entry.endsWith("/") && entry !== "SOURCE_MANIFEST.json").sort(); + assert.deepEqual(manifest.files.map((entry) => entry.path).sort(), actualPaths, "source manifest path list drifted"); + for (const entry of manifest.files) { + const file = path.join(sourceRoot, entry.path); + if (entry.type === "symlink") { + assert.equal(fs.readlinkSync(file), entry.target, `source symlink target drifted: ${entry.path}`); + } + else { + assert.equal(fs.statSync(file).size, entry.bytes, `source byte length drifted: ${entry.path}`); + assert.equal(sha256(file), entry.sha256, `source SHA-256 drifted: ${entry.path}`); + } + } + + const absoluteDevelopmentPath = /(?:\/home\/[A-Za-z0-9._-]+\/|\/Users\/[A-Za-z0-9._-]+\/|[A-Za-z]:\\Users\\)/; + const credential = /(?:-----BEGIN (?:RSA |OPENSSH |EC |DSA )?PRIVATE KEY-----|ghp_[A-Za-z0-9]{20,}|AKIA[0-9A-Z]{16})/; + for (const file of firstPartyTextFiles(sourceRoot)) { + const text = fs.readFileSync(file, "utf8"); + assert.doesNotMatch(text, absoluteDevelopmentPath, `source archive contains an absolute development path: ${path.relative(sourceRoot, file)}`); + assert.doesNotMatch(text, credential, `source archive contains a credential signature: ${path.relative(sourceRoot, file)}`); + } + + const installOutput = run("npm", ["ci", "--ignore-scripts"], path.join(sourceRoot, "web")); + const typecheckOutput = run("npm", ["run", "typecheck"], path.join(sourceRoot, "web")); + const buildOutput = run("npm", ["run", "build"], path.join(sourceRoot, "web")); + const rebuilt = distManifest(path.join(sourceRoot, "web/dist")); + const packaged = distManifest(path.join(binaryRoot, "blender-web-offline/app")); + assert.deepEqual(rebuilt, packaged, "source archive build does not reproduce the binary app manifest"); + + const report = { + schemaVersion: 1, + task: "M6-12", + status: "READY", + archive: { path: path.basename(sourceArchive), bytes: fs.statSync(sourceArchive).size, sha256: sha256(sourceArchive) }, + binaryArchiveSha256: sha256(binaryArchive), + extractedRootOutsideWorkspace: true, + filesVerified: manifest.files.length, + buildFilesVerified: rebuilt.length, + commands: [ + { command: "npm ci --ignore-scripts", outputSha256: crypto.createHash("sha256").update(installOutput).digest("hex") }, + { command: "npm run typecheck", outputSha256: crypto.createHash("sha256").update(typecheckOutput).digest("hex") }, + { command: "npm run build", outputSha256: crypto.createHash("sha256").update(buildOutput).digest("hex") }, + ], + keyFiles: Object.fromEntries(required.map((relative) => [relative, sha256(path.join(sourceRoot, relative))])), + rebuiltManifestSha256: crypto.createHash("sha256").update(JSON.stringify(rebuilt)).digest("hex"), + }; + const reportRoot = path.join(releaseRoot, "archive-reports"); + fs.mkdirSync(reportRoot, { recursive: true }); + fs.writeFileSync(path.join(reportRoot, "source.json"), `${JSON.stringify(report, null, 2)}\n`); + process.stdout.write(`source-archive-ok files=${report.filesVerified} buildFiles=${report.buildFilesVerified} sha256=${report.archive.sha256}\n`); +} +finally { + fs.rmSync(workspace, { recursive: true, force: true }); +} + diff --git a/tools/web/check-upgrade-runbook.mjs b/tools/web/check-upgrade-runbook.mjs new file mode 100644 index 00000000..3e4b9651 --- /dev/null +++ b/tools/web/check-upgrade-runbook.mjs @@ -0,0 +1,117 @@ +import assert from "node:assert/strict"; +import crypto from "node:crypto"; +import fs from "node:fs"; +import os from "node:os"; +import path from "node:path"; +import { execFileSync } from "node:child_process"; +import { fileURLToPath } from "node:url"; + +const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."); +const archive = path.join(repoRoot, "release/blender-web-offline.tar.gz"); +const reportRoot = path.join(repoRoot, "release/operations-reports"); +const workspace = fs.mkdtempSync(path.join(os.tmpdir(), "blender-upgrade-runbook-")); +const sha256Bytes = (value) => crypto.createHash("sha256").update(value).digest("hex"); +const sha256File = (file) => sha256Bytes(fs.readFileSync(file)); + +function readMetadata(release) { + return JSON.parse(fs.readFileSync(path.join(release, "release-metadata.json"), "utf8")); +} + +function switchCurrent(installRoot, relativeTarget) { + const pending = path.join(installRoot, ".current.next"); + fs.rmSync(pending, { force: true }); + fs.symlinkSync(relativeTarget, pending); + fs.renameSync(pending, path.join(installRoot, "current")); +} + +try { + const installRoot = path.join(workspace, "install"); + const releases = path.join(installRoot, "releases"); + const originStorage = path.join(workspace, "origin-storage"); + fs.mkdirSync(releases, { recursive: true }); + fs.mkdirSync(originStorage); + + const extracted = path.join(workspace, "extracted"); + fs.mkdirSync(extracted); + execFileSync("tar", ["--no-same-owner", "--no-same-permissions", "-xzf", archive, "-C", extracted]); + const newRelease = path.join(releases, sha256File(archive)); + fs.renameSync(path.join(extracted, "blender-web-offline"), newRelease); + const newMetadata = readMetadata(newRelease); + + const oldRelease = path.join(releases, "synthetic-previous-release"); + fs.cpSync(newRelease, oldRelease, { recursive: true }); + const oldMetadata = structuredClone(newMetadata); + oldMetadata.productVersion = "0.0.9"; + oldMetadata.engineReleaseId = `${newMetadata.engineReleaseId}-previous`; + oldMetadata.storage.indexedDbSchemaVersion = Math.max(1, newMetadata.storage.indexedDbSchemaVersion - 1); + const oldWorker = oldMetadata.app.workerAssets[0]; + const previousWorker = oldWorker.replace(/\.worker-([A-Za-z0-9_-]+)\.js$/, ".worker-previous.js"); + assert.notEqual(previousWorker, oldWorker, "Worker asset does not have a content-hashed name"); + fs.copyFileSync(path.join(oldRelease, "app", oldWorker), path.join(oldRelease, "app", previousWorker)); + oldMetadata.app.workerAssets = [previousWorker, ...oldMetadata.app.workerAssets.slice(1)]; + fs.writeFileSync(path.join(oldRelease, "release-metadata.json"), `${JSON.stringify(oldMetadata, null, 2)}\n`); + switchCurrent(installRoot, path.join("releases", path.basename(oldRelease))); + + const projectBytes = Buffer.from("M6-17B persistent OPFS project bytes"); + const projectFile = path.join(originStorage, "scene.blend"); + fs.writeFileSync(projectFile, projectBytes); + const projectBefore = sha256File(projectFile); + + assert.notEqual(oldMetadata.engineReleaseId, newMetadata.engineReleaseId, "upgrade does not change engine release identity"); + assert.ok(newMetadata.storage.indexedDbSchemaVersion >= oldMetadata.storage.indexedDbSchemaVersion, "upgrade would downgrade IndexedDB schema"); + assert.equal(newMetadata.storage.opfsProjectManifestSchemaVersion, oldMetadata.storage.opfsProjectManifestSchemaVersion, "upgrade changes OPFS schema without a migration"); + assert.notDeepEqual(newMetadata.app.workerAssets, oldMetadata.app.workerAssets, "upgrade does not exercise Worker identity switching"); + assert.equal(newMetadata.app.documentCache, "no-cache"); + assert.equal(newMetadata.app.manifestCache, "no-cache"); + assert.equal(newMetadata.app.hashedAssetCache, "public, max-age=31536000, immutable"); + + const oldTarget = fs.realpathSync(path.join(installRoot, "current")); + const failedPending = path.join(installRoot, ".current.next"); + fs.symlinkSync(path.join("releases", "missing-release"), failedPending); + assert.throws(() => fs.realpathSync(failedPending), /ENOENT/); + fs.rmSync(failedPending); + assert.equal(fs.realpathSync(path.join(installRoot, "current")), oldTarget, "failed preflight changed current"); + assert.equal(sha256File(projectFile), projectBefore, "failed preflight changed project data"); + + switchCurrent(installRoot, path.join("releases", path.basename(newRelease))); + assert.equal(fs.realpathSync(path.join(installRoot, "current")), newRelease); + assert.deepEqual(readMetadata(path.join(installRoot, "current")), newMetadata); + assert.equal(sha256File(projectFile), projectBefore, "release switch changed origin storage"); + for (const worker of newMetadata.app.workerAssets) { + assert.ok(fs.statSync(path.join(newRelease, "app", worker)).isFile(), `new Worker is missing: ${worker}`); + } + assert.ok(fs.statSync(path.join(oldRelease, "app", previousWorker)).isFile(), "old Worker was removed inside the rollback window"); + + const report = { + schemaVersion: 1, + task: "M6-17B", + status: "READY", + old: { + productVersion: oldMetadata.productVersion, + engineReleaseId: oldMetadata.engineReleaseId, + indexedDbSchemaVersion: oldMetadata.storage.indexedDbSchemaVersion, + opfsProjectManifestSchemaVersion: oldMetadata.storage.opfsProjectManifestSchemaVersion, + workerAssets: oldMetadata.app.workerAssets, + }, + next: { + productVersion: newMetadata.productVersion, + engineReleaseId: newMetadata.engineReleaseId, + indexedDbSchemaVersion: newMetadata.storage.indexedDbSchemaVersion, + opfsProjectManifestSchemaVersion: newMetadata.storage.opfsProjectManifestSchemaVersion, + workerAssets: newMetadata.app.workerAssets, + }, + cache: { + document: newMetadata.app.documentCache, + manifest: newMetadata.app.manifestCache, + hashedAssets: newMetadata.app.hashedAssetCache, + }, + switch: { failedPreflightKeptCurrent: true, atomicCurrentSwitch: true, oldReleaseRetained: true }, + project: { sha256Before: projectBefore, sha256After: sha256File(projectFile), preserved: true }, + }; + fs.mkdirSync(reportRoot, { recursive: true }); + fs.writeFileSync(path.join(reportRoot, "upgrade.json"), `${JSON.stringify(report, null, 2)}\n`); + process.stdout.write(`upgrade-runbook-ok old=${oldMetadata.engineReleaseId} next=${newMetadata.engineReleaseId} idb=${oldMetadata.storage.indexedDbSchemaVersion}->${newMetadata.storage.indexedDbSchemaVersion} opfs=${newMetadata.storage.opfsProjectManifestSchemaVersion} workers=switched project=preserved\n`); +} +finally { + fs.rmSync(workspace, { recursive: true, force: true }); +} diff --git a/tools/web/check-vdb-availability.mjs b/tools/web/check-vdb-availability.mjs index b8541ee8..8b9505cf 100644 --- a/tools/web/check-vdb-availability.mjs +++ b/tools/web/check-vdb-availability.mjs @@ -1,5 +1,6 @@ import assert from "node:assert/strict"; import fs from "node:fs"; +import os from "node:os"; import path from "node:path"; const root = path.resolve(new URL("../..", import.meta.url).pathname); @@ -13,7 +14,11 @@ assert.match(protocol, /validateNanoVDBBundleManifest/, "NanoVDB bundle validati assert.match(protocol, /gateNanoVDBPipeline/, "NanoVDB stage capability gates are missing"); assert.doesNotMatch(protocol, /export async function decodeVDBResource/, "Browser raw OpenVDB decode entry must not be restored"); -const roots = [path.join(root, "resource-library"), path.join(root, "tests"), "/home/mes123456/resource-library"]; +const roots = [ + path.join(root, "resource-library"), + path.join(root, "tests"), + path.resolve(process.env.VDB_RESOURCE_ROOT ?? path.join(os.homedir(), "resource-library/blender-web-vdb")), +]; const vdbFiles = []; function scan(directory) { if (!fs.existsSync(directory)) return; diff --git a/tools/web/check-vdb-native-pipeline.mjs b/tools/web/check-vdb-native-pipeline.mjs index 663deaf8..38d1749a 100644 --- a/tools/web/check-vdb-native-pipeline.mjs +++ b/tools/web/check-vdb-native-pipeline.mjs @@ -9,7 +9,7 @@ import { fileURLToPath } from "node:url"; import ts from "../../web/node_modules/typescript/lib/typescript.js"; const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."); -const resourceRoot = path.resolve(process.env.VDB_RESOURCE_ROOT ?? "/home/mes123456/resource-library/blender-web-vdb"); +const resourceRoot = path.resolve(process.env.VDB_RESOURCE_ROOT ?? path.join(os.homedir(), "resource-library/blender-web-vdb")); const converter = path.join(root, "build_vdb_tools", "vdb_to_nanovdb"); const generator = path.join(root, "build_vdb_tools", "vdb_fixture_generator"); const source = path.join(resourceRoot, "generated", "generated-smoke.vdb"); diff --git a/tools/web/check-vdb-server-job.mjs b/tools/web/check-vdb-server-job.mjs index a86dc6a1..c500ab7b 100644 --- a/tools/web/check-vdb-server-job.mjs +++ b/tools/web/check-vdb-server-job.mjs @@ -10,7 +10,8 @@ import { VDBJobService, createVDBJobHttpServer } from "../vdb/server/vdb-job-ser const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."); const converter = path.join(root, "build_vdb_tools/vdb_to_nanovdb"); -const source = "/home/mes123456/resource-library/blender-web-vdb/generated/generated-smoke.vdb"; +const resourceRoot = path.resolve(process.env.VDB_RESOURCE_ROOT ?? path.join(os.homedir(), "resource-library/blender-web-vdb")); +const source = path.join(resourceRoot, "generated/generated-smoke.vdb"); const secret = "vdb-server-test-signing-key-000000000000000000000000"; assert.ok(fs.existsSync(converter), "native converter is missing"); assert.ok(fs.existsSync(source), "real OpenVDB fixture is missing"); diff --git a/tools/web/create-offline-release.mjs b/tools/web/create-offline-release.mjs index 8e26e197..79528872 100644 --- a/tools/web/create-offline-release.mjs +++ b/tools/web/create-offline-release.mjs @@ -17,6 +17,12 @@ fs.copyFileSync(path.join(root, "docs/web/third-party-notices.json"), path.join( fs.copyFileSync(path.join(root, "docs/web/sbom.spdx.json"), path.join(bundle, "sbom.spdx.json")); fs.copyFileSync(path.join(root, "docs/web/deployment-contract.json"), path.join(bundle, "deployment-contract.json")); fs.copyFileSync(path.join(root, "docs/web/DEPLOYMENT.md"), path.join(bundle, "DEPLOYMENT.md")); +fs.copyFileSync(path.join(root, "docs/web/operations-diagnostics.json"), path.join(bundle, "operations-diagnostics.json")); +fs.copyFileSync(path.join(root, "docs/web/RELEASE_NOTES.md"), path.join(bundle, "RELEASE_NOTES.md")); +fs.copyFileSync(path.join(root, "docs/web/KNOWN_LIMITATIONS.md"), path.join(bundle, "KNOWN_LIMITATIONS.md")); +fs.copyFileSync(path.join(root, "docs/web/RELEASE_RECOVERY.md"), path.join(bundle, "RELEASE_RECOVERY.md")); +fs.copyFileSync(path.join(root, "docs/WEB_BLENDER_MODELER_V1_SCOPE.md"), path.join(bundle, "V1_SCOPE.md")); +fs.copyFileSync(path.join(root, "docs/status/parity-ledger.json"), path.join(bundle, "parity-ledger.json")); fs.copyFileSync(path.join(root, "blender-5.2.0/extern/opensubdiv-source/LICENSE.txt"), path.join(bundle, "LICENSE-OpenSubdiv.txt")); fs.copyFileSync(path.join(root, "blender-5.2.0/extern/gmp-source/COPYING.LESSERv3"), path.join(bundle, "LICENSE-GMP-LGPLv3.txt")); fs.writeFileSync(path.join(bundle, "README.txt"), [ @@ -24,6 +30,7 @@ fs.writeFileSync(path.join(bundle, "README.txt"), [ "", "Serve app/ from a static HTTP server that implements deployment-contract.json.", "See DEPLOYMENT.md for the required isolation, cache, MIME, ETag and byte-range behavior.", + "See RELEASE_NOTES.md, KNOWN_LIMITATIONS.md, RELEASE_RECOVERY.md and V1_SCOPE.md for release boundaries and recovery.", "The application has no runtime CDN dependency.", "Opening index.html directly is unsupported because browsers restrict module Workers and WASM under file://.", "See SOURCE_OFFER.txt and third-party-notices.json for licensing and corresponding source.", @@ -37,6 +44,38 @@ fs.writeFileSync(path.join(bundle, "SOURCE_OFFER.txt"), [ "", ].join("\n")); +function exportedInteger(file, name) { + const source = fs.readFileSync(path.join(root, file), "utf8"); + const match = source.match(new RegExp(`export const ${name} = (\\d+);`)); + if (!match) throw new Error(`${file} does not export ${name} as an integer literal`); + return Number(match[1]); +} + +const packageJson = JSON.parse(fs.readFileSync(path.join(root, "web/package.json"), "utf8")); +const engineManifest = JSON.parse(fs.readFileSync(path.join(root, "web/app/public/engine-manifest.json"), "utf8")); +const builtFiles = walk(path.join(root, "web/dist")); +const workerAssets = builtFiles.filter((relative) => /^assets\/.+\.worker-[A-Za-z0-9_-]+\.js$/.test(relative)); +if (workerAssets.length === 0) throw new Error("production build has no content-hashed Worker assets"); +fs.writeFileSync(path.join(bundle, "release-metadata.json"), `${JSON.stringify({ + schemaVersion: 1, + product: "Web Blender Modeler V1", + productVersion: packageJson.version, + engineReleaseId: engineManifest.releaseId, + storage: { + indexedDbSchemaVersion: exportedInteger("web/app/src/storage/migrations.ts", "STORAGE_SCHEMA_VERSION"), + opfsProjectManifestSchemaVersion: exportedInteger("web/app/src/storage/opfs-files.ts", "OPFS_PROJECT_SCHEMA_VERSION"), + migrationDirection: "forward-only", + originBound: true, + }, + app: { + workerAssets, + entryAssets: builtFiles.filter((relative) => /^assets\/index-[A-Za-z0-9_-]+\.(?:js|css)$/.test(relative)), + documentCache: "no-cache", + manifestCache: "no-cache", + hashedAssetCache: "public, max-age=31536000, immutable", + }, +}, null, 2)}\n`); + function sha256(file) { return crypto.createHash("sha256").update(fs.readFileSync(file)).digest("hex"); } @@ -53,18 +92,18 @@ function walk(directory, base = directory) { const manifest = walk(bundle).map((relative) => ({ path: relative, bytes: fs.statSync(path.join(bundle, relative)).size, sha256: sha256(path.join(bundle, relative)) })); fs.writeFileSync(path.join(bundle, "manifest.json"), `${JSON.stringify({ schemaVersion: 1, files: manifest }, null, 2)}\n`); -function deterministicArchive(output, cwd, entries) { +function deterministicArchive(output, cwd, entries, options = []) { const tarPath = output.replace(/\.gz$/, ""); fs.rmSync(output, { force: true }); fs.rmSync(tarPath, { force: true }); - execFileSync("tar", ["--sort=name", "--mtime=@0", "--owner=0", "--group=0", "--numeric-owner", "-cf", tarPath, "-C", cwd, ...entries]); + execFileSync("tar", ["--sort=name", "--mtime=@0", "--owner=0", "--group=0", "--numeric-owner", ...options, "-cf", tarPath, "-C", cwd, ...entries]); execFileSync("gzip", ["-n", "-f", tarPath]); } const binaryArchive = path.join(releaseRoot, "blender-web-offline.tar.gz"); deterministicArchive(binaryArchive, releaseRoot, ["blender-web-offline"]); const sourceArchive = path.join(releaseRoot, "blender-web-corresponding-source.tar.gz"); -deterministicArchive(sourceArchive, root, [ +const sourceEntries = [ "blender-5.2.0", "web/app", "web/protocol", @@ -74,12 +113,58 @@ deterministicArchive(sourceArchive, root, [ "web/eslint.config.js", "web/playwright.config.ts", "web/playwright.release.config.ts", + "web/playwright.archive.config.ts", + "web/playwright.single-thread.config.ts", "tools/web", "docs/web", - "docs/status", "docs/PROJECT_STATUS_AND_NEXT_WORK.md", + "docs/WEB_BLENDER_MODELER_V1_SCOPE.md", + "docs/status/parity-ledger.json", "WEB_BLENDER_MIGRATION_EXECUTION_PLAN.md", -]); +]; + +function sourceManifestFiles(entries) { + const files = []; + const visit = (absolute, relative) => { + const stat = fs.lstatSync(absolute); + if (stat.isDirectory()) { + if (path.basename(absolute) === "__pycache__") return; + for (const name of fs.readdirSync(absolute).sort((left, right) => left.localeCompare(right))) { + visit(path.join(absolute, name), path.posix.join(relative, name)); + } + return; + } + if (relative.endsWith(".pyc")) return; + if (stat.isSymbolicLink()) { + files.push({ path: relative, type: "symlink", target: fs.readlinkSync(absolute) }); + return; + } + files.push({ path: relative, type: "file", bytes: stat.size, sha256: sha256(absolute) }); + }; + for (const entry of entries) visit(path.join(root, entry), entry); + return files; +} + +const sourceManifestPath = path.join(root, "SOURCE_MANIFEST.json"); +if (fs.existsSync(sourceManifestPath)) throw new Error(`refusing to replace existing ${sourceManifestPath}`); +const sourceManifest = { + schemaVersion: 1, + product: "Web Blender Modeler V1", + version: packageJson.version, + engineReleaseId: engineManifest.releaseId, + files: sourceManifestFiles(sourceEntries), +}; +fs.writeFileSync(sourceManifestPath, `${JSON.stringify(sourceManifest, null, 2)}\n`); +try { + deterministicArchive(sourceArchive, root, [...sourceEntries, "SOURCE_MANIFEST.json"], [ + "--exclude=*/__pycache__", + "--exclude=*/__pycache__/*", + "--exclude=*.pyc", + ]); +} +finally { + fs.rmSync(sourceManifestPath, { force: true }); +} const sums = [binaryArchive, sourceArchive].map((file) => `${sha256(file)} ${path.basename(file)}`).join("\n") + "\n"; fs.writeFileSync(path.join(releaseRoot, "SHA256SUMS.txt"), sums); process.stdout.write(`offline-release-ok binary=${fs.statSync(binaryArchive).size} source=${fs.statSync(sourceArchive).size} sha256=${sha256(binaryArchive)}\n`); diff --git a/tools/web/create-rc-manifest.mjs b/tools/web/create-rc-manifest.mjs new file mode 100644 index 00000000..326c993b --- /dev/null +++ b/tools/web/create-rc-manifest.mjs @@ -0,0 +1,98 @@ +import crypto from "node:crypto"; +import fs from "node:fs"; +import path from "node:path"; +import { execFileSync } from "node:child_process"; +import { fileURLToPath } from "node:url"; + +const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."); +const releaseRoot = path.join(repoRoot, "release"); +const sha256Bytes = (value) => crypto.createHash("sha256").update(value).digest("hex"); +const sha256 = (file) => sha256Bytes(fs.readFileSync(file)); +const archiveEntry = (archive, entry) => execFileSync("tar", ["-xOf", archive, entry], { maxBuffer: 32 * 1024 * 1024 }); +const packageJson = JSON.parse(fs.readFileSync(path.join(repoRoot, "web/package.json"), "utf8")); +const engineManifest = JSON.parse(fs.readFileSync(path.join(repoRoot, "web/app/public/engine-manifest.json"), "utf8")); +const binaryArchive = path.join(releaseRoot, "blender-web-offline.tar.gz"); +const sourceArchive = path.join(releaseRoot, "blender-web-corresponding-source.tar.gz"); +const sbom = path.join(repoRoot, "docs/web/sbom.spdx.json"); +const sumsPath = path.join(releaseRoot, "SHA256SUMS.txt"); +const packageJsonPath = path.join(repoRoot, "web/package.json"); +const packageLockPath = path.join(repoRoot, "web/package-lock.json"); +const engineManifestPath = path.join(repoRoot, "web/app/public/engine-manifest.json"); +const embeddedPackageJsonBytes = archiveEntry(sourceArchive, "web/package.json"); +const embeddedPackageLockBytes = archiveEntry(sourceArchive, "web/package-lock.json"); +const embeddedEngineManifestBytes = archiveEntry(binaryArchive, "blender-web-offline/app/engine-manifest.json"); +const embeddedMetadataBytes = archiveEntry(binaryArchive, "blender-web-offline/release-metadata.json"); +const embeddedSbomBytes = archiveEntry(binaryArchive, "blender-web-offline/sbom.spdx.json"); +const sourceManifest = JSON.parse(archiveEntry(sourceArchive, "SOURCE_MANIFEST.json").toString("utf8")); +const embeddedMetadata = JSON.parse(embeddedMetadataBytes.toString("utf8")); +const commit = execFileSync("git", ["rev-parse", "HEAD"], { cwd: repoRoot, encoding: "utf8" }).trim(); +const worktreeDirty = execFileSync("git", ["status", "--porcelain", "--untracked-files=all"], { + cwd: repoRoot, + encoding: "utf8", +}).trim().length > 0; + +if (!/^\d+\.\d+\.\d+-rc\.\d+$/.test(packageJson.version)) throw new Error("package version is not an RC semver"); +if (engineManifest.releaseId !== `blender-wasm-${packageJson.version}`) throw new Error("engine releaseId does not match RC semver"); +if (embeddedMetadata.productVersion !== packageJson.version || embeddedMetadata.engineReleaseId !== engineManifest.releaseId) { + throw new Error("binary release metadata does not match the frozen RC identity"); +} +if (sourceManifest.version !== packageJson.version || sourceManifest.engineReleaseId !== engineManifest.releaseId) { + throw new Error("source manifest does not match the frozen RC identity"); +} +for (const [label, actual, expected] of [ + ["source package.json", embeddedPackageJsonBytes, fs.readFileSync(packageJsonPath)], + ["source package-lock.json", embeddedPackageLockBytes, fs.readFileSync(packageLockPath)], + ["binary engine manifest", embeddedEngineManifestBytes, fs.readFileSync(engineManifestPath)], + ["binary SBOM", embeddedSbomBytes, fs.readFileSync(sbom)], +]) { + if (!actual.equals(expected)) throw new Error(`${label} does not match the frozen workspace bytes`); +} +const checksumEntries = fs.readFileSync(sumsPath, "utf8").trim().split("\n").map((line) => line.match(/^([a-f0-9]{64}) ([^/]+)$/)); +if (checksumEntries.some((entry) => entry === null) || checksumEntries.length !== 2) { + throw new Error("SHA256SUMS.txt must contain exactly two canonical archive entries"); +} +const checksums = new Map(checksumEntries.map((entry) => [entry[2], entry[1]])); +for (const file of [binaryArchive, sourceArchive]) { + if (checksums.get(path.basename(file)) !== sha256(file)) throw new Error(`SHA256SUMS.txt does not match ${path.basename(file)}`); +} + +const artifact = (file, relative) => ({ + path: relative, + bytes: fs.statSync(file).size, + sha256: sha256(file), +}); +const operations = ["deploy", "upgrade", "rollback", "diagnostics", "rehearsal"] + .map((name) => [name, path.join(releaseRoot, "operations-reports", `${name}.json`)]); +for (const [name, file] of operations) { + if (!fs.existsSync(file)) throw new Error(`RC operations report is missing: ${name}`); +} +const manifest = { + schemaVersion: 1, + rcId: `web-blender-${packageJson.version}`, + semver: packageJson.version, + gitCommit: commit, + sourceBinding: { + mode: "corresponding-source-archive", + worktreeDirty, + note: "The source archive SHA-256 binds the candidate bytes independently of the base commit.", + }, + engineReleaseId: engineManifest.releaseId, + artifacts: { + binaryArchive: artifact(binaryArchive, "release/blender-web-offline.tar.gz"), + sourceArchive: artifact(sourceArchive, "release/blender-web-corresponding-source.tar.gz"), + sbom: artifact(sbom, "docs/web/sbom.spdx.json"), + }, + bindings: { + packageJsonSha256: sha256(packageJsonPath), + packageLockSha256: sha256(packageLockPath), + ledgerSha256: sha256(path.join(repoRoot, "docs/status/parity-ledger.json")), + engineManifestSha256: sha256(engineManifestPath), + embeddedReleaseMetadataSha256: sha256Bytes(embeddedMetadataBytes), + sha256SumsSha256: sha256(sumsPath), + }, + operations: Object.fromEntries(operations.map(([name, file]) => [name, artifact(file, path.relative(repoRoot, file).replaceAll(path.sep, "/"))])), +}; +const output = path.join(releaseRoot, "RC_MANIFEST.json"); +fs.writeFileSync(output, `${JSON.stringify(manifest, null, 2)}\n`); +fs.writeFileSync(`${output}.sha256`, `${sha256(output)} ${path.basename(output)}\n`); +process.stdout.write(`rc-manifest-ok id=${manifest.rcId} commit=${commit} binary=${manifest.artifacts.binaryArchive.sha256} source=${manifest.artifacts.sourceArchive.sha256} sbom=${manifest.artifacts.sbom.sha256}\n`); diff --git a/tools/web/deployment-http-server.mjs b/tools/web/deployment-http-server.mjs new file mode 100644 index 00000000..15bfd61b --- /dev/null +++ b/tools/web/deployment-http-server.mjs @@ -0,0 +1,166 @@ +import crypto from "node:crypto"; +import fs from "node:fs"; +import http from "node:http"; +import path from "node:path"; +import { fileURLToPath, pathToFileURL } from "node:url"; + +const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."); + +export function loadDeploymentContract( + contractPath = path.join(repoRoot, "docs/web/deployment-contract.json"), +) { + return JSON.parse(fs.readFileSync(contractPath, "utf8")); +} + +function cacheControl(pathname, routes) { + for (const route of routes) { + for (const pattern of route.patterns) { + if (pattern === "*" || pattern === pathname || + (pattern.endsWith("*") && pathname.startsWith(pattern.slice(0, -1)))) { + return route.cacheControl; + } + } + } + return "no-cache"; +} + +function resolvedFile(root, pathname) { + let decoded; + try { + decoded = decodeURIComponent(pathname); + } + catch { + return null; + } + if (decoded.includes("\0")) return null; + const relative = decoded === "/" ? "index.html" : decoded.replace(/^\/+/, ""); + const filePath = path.resolve(root, relative); + const rootPrefix = `${path.resolve(root)}${path.sep}`; + if (!filePath.startsWith(rootPrefix)) return null; + return filePath; +} + +function strongEtag(filePath) { + const hash = crypto.createHash("sha256").update(fs.readFileSync(filePath)).digest("hex"); + return `"sha256-${hash}"`; +} + +function matchesIfNoneMatch(value, etag) { + if (typeof value !== "string") return false; + return value === "*" || value.split(",").some((candidate) => candidate.trim() === etag); +} + +function parseRange(value, size) { + if (typeof value !== "string" || !value.startsWith("bytes=") || value.includes(",")) return null; + const match = value.match(/^bytes=(\d*)-(\d*)$/); + if (!match || (!match[1] && !match[2])) return null; + if (!match[1]) { + const suffixLength = Number(match[2]); + if (!Number.isSafeInteger(suffixLength) || suffixLength <= 0 || suffixLength > size) return null; + return { start: size - suffixLength, end: size - 1 }; + } + const start = Number(match[1]); + const end = match[2] ? Number(match[2]) : size - 1; + if (!Number.isSafeInteger(start) || !Number.isSafeInteger(end) || + start < 0 || start >= size || end < start || end >= size) return null; + return { start, end }; +} + +function responseHeaders(contract, pathname, filePath, stat) { + const extension = path.extname(filePath).toLowerCase(); + const mime = contract.mimeTypes[extension]; + if (!mime) return null; + return { + ...contract.responseHeaders.allResponses, + "Cache-Control": cacheControl(pathname, contract.responseHeaders.routes), + "Content-Type": mime, + "Content-Length": String(stat.size), + }; +} + +export function createDeploymentHttpServer({ root, contract = loadDeploymentContract() }) { + const staticRoot = path.resolve(root); + return http.createServer((request, response) => { + const requestUrl = new URL(request.url ?? "/", "http://deployment.local"); + const pathname = requestUrl.pathname; + const commonHeaders = { ...contract.responseHeaders.allResponses, "Cache-Control": "no-cache" }; + if (!contract.methods.includes(request.method)) { + response.writeHead(405, { ...commonHeaders, Allow: contract.methods.join(", "), "Content-Length": "0" }); + response.end(); + return; + } + + const filePath = resolvedFile(staticRoot, pathname); + if (!filePath || !fs.existsSync(filePath) || !fs.statSync(filePath).isFile()) { + response.writeHead(404, { ...commonHeaders, "Content-Length": "0" }); + response.end(); + return; + } + const stat = fs.statSync(filePath); + const headers = responseHeaders(contract, pathname, filePath, stat); + if (!headers) { + response.writeHead(415, { ...commonHeaders, "Content-Length": "0" }); + response.end(); + return; + } + + const extension = path.extname(filePath).toLowerCase(); + const rangeEnabled = contract.rangeRequests.extensions.includes(extension); + const etag = strongEtag(filePath); + headers.ETag = etag; + if (rangeEnabled) headers["Accept-Ranges"] = contract.rangeRequests.unit; + if (matchesIfNoneMatch(request.headers["if-none-match"], etag)) { + response.writeHead(304, { ...headers, "Content-Length": "0" }); + response.end(); + return; + } + const requestedRange = request.headers.range; + const ifRangeMatches = !request.headers["if-range"] || request.headers["if-range"] === etag; + if (requestedRange && rangeEnabled && ifRangeMatches) { + const range = parseRange(requestedRange, stat.size); + if (!range) { + response.writeHead(contract.rangeRequests.unsatisfiedStatus, { + ...headers, + "Content-Range": `bytes */${stat.size}`, + "Content-Length": "0", + }); + response.end(); + return; + } + const length = range.end - range.start + 1; + response.writeHead(contract.rangeRequests.satisfiedStatus, { + ...headers, + "Content-Range": `bytes ${range.start}-${range.end}/${stat.size}`, + "Content-Length": String(length), + }); + if (request.method === "HEAD") response.end(); + else fs.createReadStream(filePath, { start: range.start, end: range.end }).pipe(response); + return; + } + + response.writeHead(200, headers); + if (request.method === "HEAD") response.end(); + else fs.createReadStream(filePath).pipe(response); + }); +} + +export async function listenDeploymentHttpServer(server, { host = "127.0.0.1", port = 0 } = {}) { + await new Promise((resolve, reject) => { + server.once("error", reject); + server.listen(port, host, () => { + server.off("error", reject); + resolve(); + }); + }); + const address = server.address(); + if (!address || typeof address === "string") throw new Error("deployment server did not bind a TCP port"); + return `http://${host}:${address.port}`; +} + +if (process.argv[1] && import.meta.url === pathToFileURL(path.resolve(process.argv[1])).href) { + const root = path.resolve(process.argv[2] ?? path.join(repoRoot, "web/dist")); + const port = Number.parseInt(process.env.BLENDER_WEB_HTTP_PORT ?? "8080", 10); + const server = createDeploymentHttpServer({ root }); + const origin = await listenDeploymentHttpServer(server, { port }); + process.stdout.write(`deployment-http-server ${origin} root=${root}\n`); +} diff --git a/tools/web/install-web-engine-assets.sh b/tools/web/install-web-engine-assets.sh index 559c41d1..c2a662d4 100755 --- a/tools/web/install-web-engine-assets.sh +++ b/tools/web/install-web-engine-assets.sh @@ -2,18 +2,51 @@ set -euo pipefail repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)" -source_dir="${repo_root}/build_web_blender6/bin" -target_dir="${repo_root}/web/app/public/vendor/blender" -source_vendor_dir="${repo_root}/web/app/src/vendor/blender" -mkdir -p "${target_dir}" -mkdir -p "${source_vendor_dir}" -test -s "${source_dir}/web_engine.js" && test -s "${source_dir}/web_engine.wasm" -cp "${source_dir}/web_engine.js" "${target_dir}/web_engine.js" -cp "${source_dir}/web_engine.wasm" "${target_dir}/web_engine.wasm" -cp "${source_dir}/web_engine.js" "${source_vendor_dir}/web_engine.js" -cp "${source_dir}/web_engine.wasm" "${source_vendor_dir}/web_engine.wasm" -wasm_hash="$(sha256sum "${target_dir}/web_engine.wasm" | cut -d ' ' -f 1)" +single_build_dir="${WEB_ENGINE_SINGLE_BUILD_DIR:-${repo_root}/build_web-single}" +pthread_build_dir="${WEB_ENGINE_PTHREAD_BUILD_DIR:-${repo_root}/build_web-pthread}" +public_root="${WEB_ENGINE_PUBLIC_ROOT:-${repo_root}/web/app/public}" +manifest_path="${WEB_ENGINE_MANIFEST_PATH:-${public_root}/engine-manifest.json}" + +if [[ "$(realpath -m "${single_build_dir}")" == "$(realpath -m "${pthread_build_dir}")" ]]; then + echo "single and pthread variants must come from independent build directories" >&2 + exit 1 +fi + +for build_dir in "${single_build_dir}" "${pthread_build_dir}"; do + test -s "${build_dir}/web_engine.js" + test -s "${build_dir}/web_engine.wasm" +done +test -s "${manifest_path}" + +staging_dir="$(mktemp -d "${TMPDIR:-/tmp}/blender-web-engine-install.XXXXXX")" +trap 'rm -rf "${staging_dir}"' EXIT +for variant in single pthread; do + mkdir -p "${staging_dir}/vendor/blender/${variant}" +done +cp "${single_build_dir}/web_engine.js" "${staging_dir}/vendor/blender/single/web_engine.js" +cp "${single_build_dir}/web_engine.wasm" "${staging_dir}/vendor/blender/single/web_engine.wasm" +cp "${pthread_build_dir}/web_engine.js" "${staging_dir}/vendor/blender/pthread/web_engine.js" +cp "${pthread_build_dir}/web_engine.wasm" "${staging_dir}/vendor/blender/pthread/web_engine.wasm" +cp "${manifest_path}" "${staging_dir}/engine-manifest.json" + node "${repo_root}/tools/web/update-engine-manifest.mjs" \ - "${repo_root}/web/app/public/engine-manifest.json" \ - "${wasm_hash}" -sha256sum "${target_dir}/web_engine.js" "${target_dir}/web_engine.wasm" + "${staging_dir}/engine-manifest.json" \ + "${staging_dir}/vendor/blender/single" \ + "${staging_dir}/vendor/blender/pthread" +node "${repo_root}/tools/web/check-manifest-assets.mjs" \ + "${staging_dir}/engine-manifest.json" "${staging_dir}" + +for variant in single pthread; do + mkdir -p "${public_root}/vendor/blender/${variant}" + install -m 0644 "${staging_dir}/vendor/blender/${variant}/web_engine.js" \ + "${public_root}/vendor/blender/${variant}/web_engine.js" + install -m 0644 "${staging_dir}/vendor/blender/${variant}/web_engine.wasm" \ + "${public_root}/vendor/blender/${variant}/web_engine.wasm" +done +install -m 0644 "${staging_dir}/engine-manifest.json" "${manifest_path}" + +sha256sum \ + "${public_root}/vendor/blender/single/web_engine.js" \ + "${public_root}/vendor/blender/single/web_engine.wasm" \ + "${public_root}/vendor/blender/pthread/web_engine.js" \ + "${public_root}/vendor/blender/pthread/web_engine.wasm" diff --git a/tools/web/run-ci-lane.mjs b/tools/web/run-ci-lane.mjs new file mode 100644 index 00000000..caa6549e --- /dev/null +++ b/tools/web/run-ci-lane.mjs @@ -0,0 +1,186 @@ +import assert from "node:assert/strict"; +import crypto from "node:crypto"; +import fs from "node:fs"; +import net from "node:net"; +import os from "node:os"; +import path from "node:path"; +import { spawnSync } from "node:child_process"; +import { fileURLToPath } from "node:url"; + +const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."); +const releaseRoot = path.join(repoRoot, "release"); +const lane = process.argv[2]; +const selfTestFailure = process.argv.includes("--self-test-failure"); +assert.ok(["quick", "chromium", "release"].includes(lane), "usage: run-ci-lane.mjs "); + +const laneCommands = { + quick: [ + ["lockfile-install", "npm", ["--prefix", "web", "ci", "--ignore-scripts"]], + ["typecheck", "npm", ["--prefix", "web", "run", "typecheck"]], + ["lint", "npm", ["--prefix", "web", "run", "lint"]], + ["unit", "npm", ["--prefix", "web", "test"]], + ["status", "npm", ["--prefix", "web", "run", "test:status-consistency"]], + ["evidence-schema", "npm", ["--prefix", "web", "run", "test:release-evidence"]], + ["rc-docs", "npm", ["--prefix", "web", "run", "test:rc-docs"]], + ], + chromium: [ + ["lockfile-install", "npm", ["--prefix", "web", "ci", "--ignore-scripts"]], + ["p0-user-loop", "npm", ["--prefix", "web", "run", "test:v1-user-loop"], "browser"], + ["offline-browser-smoke", "npm", ["--prefix", "web", "run", "test:browser"], "browser"], + ["network-interruption", "npm", ["--prefix", "web", "run", "test:network-interruption"], "browser"], + ["device-loss", "npm", ["--prefix", "web", "run", "test:device-loss"], "browser"], + ["oom-recovery", "npm", ["--prefix", "web", "run", "test:oom-recovery"], "browser"], + ["opfs-quota", "npm", ["--prefix", "web", "run", "test:storage-quota"], "browser"], + ["malicious-blend", "npm", ["--prefix", "web", "run", "test:malicious-blends"]], + ["malicious-archive", "npm", ["--prefix", "web", "run", "test:asset-library"], "browser"], + ], + release: [ + ["lockfile-install", "npm", ["--prefix", "web", "ci", "--ignore-scripts"]], + ["full-e2e", "npm", ["--prefix", "web", "run", "test:e2e", "--", "--workers=1"], "browser"], + ["performance-100k-1m", "npm", ["--prefix", "web", "run", "test:release-performance"]], + ["performance-10m", "npm", ["--prefix", "web", "run", "test:geometry-10m-performance"], "browser"], + ["performance-texture-4k", "npm", ["--prefix", "web", "run", "test:texture-4k-performance"], "browser"], + ["performance-texture-8k", "npm", ["--prefix", "web", "run", "test:texture-8k-performance"], "browser"], + ["performance-simulation", "npm", ["--prefix", "web", "run", "test:simulation-cache-performance"], "browser"], + ["performance-long-media", "npm", ["--prefix", "web", "run", "test:long-media-performance"], "browser"], + ["vdb-native", "npm", ["--prefix", "web", "run", "test:vdb-native"]], + ["vdb-server", "npm", ["--prefix", "web", "run", "test:vdb-server"]], + ["vdb-opfs", "npm", ["--prefix", "web", "run", "test:vdb-opfs"], "browser"], + ["vdb-webgpu", "npm", ["--prefix", "web", "run", "test:vdb-webgpu"], "browser"], + ["vdb-viewport", "npm", ["--prefix", "web", "run", "test:vdb-viewport"], "browser"], + ["vdb-faults", "npm", ["--prefix", "web", "run", "test:vdb-faults"], "browser"], + ["v1-acceptance", "npm", ["--prefix", "web", "run", "release:v1-acceptance"], "acceptance"], + ["offline-reproducibility", "npm", ["--prefix", "web", "run", "release:offline"]], + ["archive-browser", "npm", ["--prefix", "web", "run", "test:archive-offline"], "browser"], + ["binary-archive", "npm", ["--prefix", "web", "run", "test:binary-archive"]], + ["source-archive", "npm", ["--prefix", "web", "run", "test:source-archive"]], + ["deployment-runbook", "npm", ["--prefix", "web", "run", "test:deployment-runbook"]], + ["upgrade-runbook", "npm", ["--prefix", "web", "run", "test:upgrade-runbook"]], + ["rollback-runbook", "npm", ["--prefix", "web", "run", "test:rollback-runbook"]], + ["operations-diagnostics", "npm", ["--prefix", "web", "run", "test:operations-diagnostics"]], + ["operations-rehearsal", "npm", ["--prefix", "web", "run", "test:operations-rehearsal"]], + ["rc-manifest", "npm", ["--prefix", "web", "run", "release:rc-manifest"]], + ], +}; + +const commands = selfTestFailure + ? [["injected-failure", process.execPath, ["-e", "process.stderr.write('injected CI lane failure\\n'); process.exit(17)"]]] + : laneCommands[lane]; +const reportPath = path.resolve(process.env.CI_REPORT_PATH ?? path.join(releaseRoot, "ci-reports", `${lane}.json`)); +const logRoot = path.join(path.dirname(reportPath), `${path.basename(reportPath, ".json")}-logs`); +fs.mkdirSync(logRoot, { recursive: true }); + +const digest = (value) => crypto.createHash("sha256").update(value).digest("hex"); +const fileDigest = (file) => fs.existsSync(file) && fs.statSync(file).isFile() ? digest(fs.readFileSync(file)) : null; + +function capture(command, args) { + const result = spawnSync(command, args, { cwd: repoRoot, encoding: "utf8", env: { ...process.env, FORCE_COLOR: "0", NO_COLOR: "1" }, maxBuffer: 8 * 1024 * 1024 }); + return result.status === 0 ? `${result.stdout ?? ""}${result.stderr ?? ""}`.trim() : "unavailable"; +} + +async function freePortRange(length = 1) { + for (let attempt = 0; attempt < 100; attempt++) { + const base = 20_000 + Math.floor(Math.random() * (40_000 - length)); + const servers = []; + try { + for (let offset = 0; offset < length; offset++) { + const server = net.createServer(); + await new Promise((resolve, reject) => { + server.once("error", reject); + server.listen(base + offset, "127.0.0.1", resolve); + }); + servers.push(server); + } + return base; + } + catch { + // Try another contiguous range. + } + finally { + await Promise.all(servers.map((server) => new Promise((resolve) => server.close(resolve)))); + } + } + throw new Error(`unable to allocate ${length} loopback port(s)`); +} + +function artifactBindings() { + const files = { + packageJson: "web/package.json", + lockfile: "web/package-lock.json", + ledger: "docs/status/parity-ledger.json", + engineManifest: "web/app/public/engine-manifest.json", + releaseNotes: "docs/web/RELEASE_NOTES.md", + knownLimitations: "docs/web/KNOWN_LIMITATIONS.md", + releaseRecovery: "docs/web/RELEASE_RECOVERY.md", + sbom: "docs/web/sbom.spdx.json", + binaryArchive: "release/blender-web-offline.tar.gz", + sourceArchive: "release/blender-web-corresponding-source.tar.gz", + sha256Sums: "release/SHA256SUMS.txt", + rcManifest: "release/RC_MANIFEST.json", + }; + return Object.fromEntries(Object.entries(files).map(([name, relative]) => { + const releaseOnly = ["binaryArchive", "sourceArchive", "sha256Sums", "rcManifest"].includes(name); + return [name, { path: relative, sha256: releaseOnly && lane !== "release" ? null : fileDigest(path.join(repoRoot, relative)) }]; + })); +} + +const environment = { + os: `${os.platform()} ${os.release()} ${os.arch()}`, + node: process.version, + npm: capture("npm", ["--version"]), + chrome: capture(process.env.CHROME_PATH ?? "google-chrome", ["--version"]), + blender: capture(process.env.BLENDER_BIN ?? "blender", ["--version"]).split("\n")[0], + emscripten: capture("bash", ["-lc", "source tools/web/emscripten-env.sh >/dev/null 2>&1 && emcc --version | head -1"]), +}; +const commit = capture("git", ["rev-parse", "HEAD"]); +const records = []; + +for (const [index, definition] of commands.entries()) { + const [id, command, args, portMode] = definition; + const env = { ...process.env, FORCE_COLOR: "0", NO_COLOR: "1" }; + let port; + if (portMode === "browser") { + port = await freePortRange(); + env.WEB_TEST_PORT = String(port); + } + else if (portMode === "acceptance") { + port = await freePortRange(80); + env.WEB_ACCEPTANCE_PORT = String(port); + } + const started = Date.now(); + const result = spawnSync(command, args, { cwd: repoRoot, encoding: "utf8", env, maxBuffer: 64 * 1024 * 1024 }); + const output = `${result.stdout ?? ""}\n${result.stderr ?? ""}`.trim(); + const logPath = path.join(logRoot, `${String(index + 1).padStart(2, "0")}-${id}.log`); + fs.writeFileSync(logPath, `${output}\n`); + const record = { + id, + command: [command, ...args].join(" "), + exitCode: result.status ?? 1, + durationMs: Date.now() - started, + ...(port ? { loopbackPort: port } : {}), + output: { path: path.relative(repoRoot, logPath).replaceAll(path.sep, "/"), bytes: fs.statSync(logPath).size, sha256: fileDigest(logPath) }, + }; + records.push(record); + process.stdout.write(`[${lane} ${index + 1}/${commands.length}] ${id} exit=${record.exitCode} durationMs=${record.durationMs}${port ? ` port=${port}` : ""}\n`); + if (record.exitCode !== 0) break; +} + +const status = records.length === commands.length && records.every((record) => record.exitCode === 0) ? "READY" : "FAILED"; +const report = { + schemaVersion: 1, + lane, + status, + generatedAt: new Date().toISOString(), + commit, + environment, + bindings: artifactBindings(), + records, + retentionDays: lane === "quick" ? 7 : lane === "chromium" ? 14 : 30, +}; +fs.mkdirSync(path.dirname(reportPath), { recursive: true }); +const temporaryReport = `${reportPath}.tmp-${process.pid}`; +fs.writeFileSync(temporaryReport, `${JSON.stringify(report, null, 2)}\n`); +fs.renameSync(temporaryReport, reportPath); +fs.writeFileSync(`${reportPath}.sha256`, `${fileDigest(reportPath)} ${path.basename(reportPath)}\n`); +process.stdout.write(`ci-lane-report lane=${lane} status=${status} records=${records.length} path=${reportPath}\n`); +if (status !== "READY") process.exitCode = 1; diff --git a/tools/web/run-operations-rehearsal.mjs b/tools/web/run-operations-rehearsal.mjs new file mode 100644 index 00000000..f3743867 --- /dev/null +++ b/tools/web/run-operations-rehearsal.mjs @@ -0,0 +1,191 @@ +import assert from "node:assert/strict"; +import crypto from "node:crypto"; +import fs from "node:fs"; +import os from "node:os"; +import path from "node:path"; +import { execFileSync } from "node:child_process"; +import { fileURLToPath } from "node:url"; +import { + createDeploymentHttpServer, + listenDeploymentHttpServer, +} from "./deployment-http-server.mjs"; + +const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."); +const releaseRoot = path.join(repoRoot, "release"); +const archive = path.join(releaseRoot, "blender-web-offline.tar.gz"); +const sourceArchive = path.join(releaseRoot, "blender-web-corresponding-source.tar.gz"); +const sumsFile = path.join(releaseRoot, "SHA256SUMS.txt"); +const workspace = fs.mkdtempSync(path.join(os.tmpdir(), "blender-operations-rehearsal-")); +assert.equal(path.dirname(workspace), os.tmpdir()); +assert.ok(path.basename(workspace).startsWith("blender-operations-rehearsal-")); + +const records = []; +let failure = null; +let server = null; +let projectBefore = null; +let projectAfter = null; +const sha256 = (value) => crypto.createHash("sha256").update(value).digest("hex"); +const fileSha256 = (file) => sha256(fs.readFileSync(file)); +const readJson = (file) => JSON.parse(fs.readFileSync(file, "utf8")); + +async function run(id, command, action) { + const started = Date.now(); + try { + const output = await action(); + records.push({ id, command, exitCode: 0, durationMs: Date.now() - started, output }); + return output; + } + catch (error) { + records.push({ + id, + command, + exitCode: 1, + durationMs: Date.now() - started, + output: { error: error instanceof Error ? error.message : String(error) }, + }); + throw error; + } +} + +function switchCurrent(installRoot, releaseName) { + const pending = path.join(installRoot, ".current.next"); + fs.rmSync(pending, { force: true }); + fs.symlinkSync(path.join("releases", releaseName), pending); + fs.renameSync(pending, path.join(installRoot, "current")); +} + +async function validateInstalledHttp(installRoot) { + const bundle = path.join(installRoot, "current"); + const contract = readJson(path.join(bundle, "deployment-contract.json")); + const engine = readJson(path.join(bundle, "app/engine-manifest.json")); + server = createDeploymentHttpServer({ root: path.join(bundle, "app"), contract }); + const origin = await listenDeploymentHttpServer(server); + try { + const head = await fetch(`${origin}/`, { method: "HEAD" }); + assert.equal(head.status, 200); + for (const [name, value] of Object.entries(contract.responseHeaders.allResponses)) { + assert.equal(head.headers.get(name), value); + } + const single = engine.variants.find((variant) => variant.id === "single"); + const range = await fetch(new URL(single.resources.wasm.url, origin), { headers: { Range: "bytes=0-15" } }); + assert.equal(range.status, 206); + assert.equal((await range.arrayBuffer()).byteLength, 16); + return { originMode: "loopback-http", headStatus: head.status, rangeStatus: range.status, releaseId: engine.releaseId }; + } + finally { + await new Promise((resolve) => server.close(resolve)); + server = null; + } +} + +try { + const delivery = path.join(workspace, "delivery"); + const installRoot = path.join(workspace, "install"); + const originStorage = path.join(workspace, "origin-storage", "projects", "rehearsal-project"); + fs.mkdirSync(delivery); + fs.mkdirSync(installRoot); + + await run("delivery-check", "sha256sum -c SHA256SUMS.txt && tar -tzf blender-web-offline.tar.gz", async () => { + for (const file of [archive, sourceArchive, sumsFile]) fs.copyFileSync(file, path.join(delivery, path.basename(file))); + const entries = Object.fromEntries(fs.readFileSync(path.join(delivery, "SHA256SUMS.txt"), "utf8").trim().split("\n").map((line) => { + const match = line.match(/^([a-f0-9]{64}) ([^/]+)$/); + assert.ok(match, `invalid checksum entry: ${line}`); + return [match[2], match[1]]; + })); + assert.equal(fileSha256(path.join(delivery, path.basename(archive))), entries[path.basename(archive)]); + assert.equal(fileSha256(path.join(delivery, path.basename(sourceArchive))), entries[path.basename(sourceArchive)]); + const archiveEntries = execFileSync("tar", ["-tzf", path.join(delivery, path.basename(archive))], { encoding: "utf8" }).split("\n").filter(Boolean); + assert.ok(archiveEntries.length > 0); + for (const entry of archiveEntries) { + assert.ok(!entry.startsWith("/") && !entry.split("/").includes("..")); + assert.ok(entry === "blender-web-offline/" || entry.startsWith("blender-web-offline/")); + } + return { binarySha256: entries[path.basename(archive)], sourceSha256: entries[path.basename(sourceArchive)], archiveEntries: archiveEntries.length }; + }); + + const installed = await run("deploy-install", "tar --no-same-owner --no-same-permissions -xzf ARCHIVE -C STAGE && mv STAGE RELEASE && mv -Tf .current.next current", async () => { + const releases = path.join(installRoot, "releases"); + fs.mkdirSync(releases); + const staging = fs.mkdtempSync(path.join(installRoot, ".install.")); + execFileSync("tar", ["--no-same-owner", "--no-same-permissions", "-xzf", path.join(delivery, path.basename(archive)), "-C", staging]); + const releaseName = fileSha256(path.join(delivery, path.basename(archive))); + fs.renameSync(path.join(staging, "blender-web-offline"), path.join(releases, releaseName)); + fs.rmdirSync(staging); + switchCurrent(installRoot, releaseName); + return { releaseName, currentTarget: fs.readlinkSync(path.join(installRoot, "current")), emptyInstallRoot: true }; + }); + + await run("deploy-http", "HEAD / && GET Range:bytes=0-15 single/web_engine.wasm", () => validateInstalledHttp(installRoot)); + + await run("project-seed", "persist project revision and SHA-256 outside release directories", async () => { + fs.mkdirSync(originStorage, { recursive: true }); + const bytes = Buffer.from("M6-17E rehearsal project bytes"); + const manifest = { schemaVersion: 1, revision: 23, bytes: bytes.length, sha256: sha256(bytes) }; + fs.writeFileSync(path.join(originStorage, "scene.blend"), bytes); + fs.writeFileSync(path.join(originStorage, "scene.blend.meta.json"), `${JSON.stringify(manifest)}\n`); + projectBefore = manifest; + return manifest; + }); + + const upgraded = await run("upgrade-switch", "stage NEXT_RELEASE && mv -Tf .current.next current", async () => { + const oldRelease = path.join(installRoot, "releases", installed.releaseName); + const nextName = `${installed.releaseName}-next`; + const nextRelease = path.join(installRoot, "releases", nextName); + fs.cpSync(oldRelease, nextRelease, { recursive: true }); + const metadataPath = path.join(nextRelease, "release-metadata.json"); + const metadata = readJson(metadataPath); + metadata.productVersion = `${metadata.productVersion}-rehearsal-next`; + fs.writeFileSync(metadataPath, `${JSON.stringify(metadata, null, 2)}\n`); + switchCurrent(installRoot, nextName); + assert.equal(fileSha256(path.join(originStorage, "scene.blend")), projectBefore.sha256); + return { from: installed.releaseName, to: nextName, oldReleaseRetained: fs.existsSync(oldRelease) }; + }); + + await run("upgrade-http", "HEAD / && GET Range:bytes=0-15 after upgrade", () => validateInstalledHttp(installRoot)); + + await run("rollback-switch", "preflight schemas && mv -Tf .current.next current", async () => { + const activeMetadata = readJson(path.join(installRoot, "current", "release-metadata.json")); + const targetMetadata = readJson(path.join(installRoot, "releases", installed.releaseName, "release-metadata.json")); + assert.equal(activeMetadata.storage.indexedDbSchemaVersion, targetMetadata.storage.indexedDbSchemaVersion); + assert.equal(activeMetadata.storage.opfsProjectManifestSchemaVersion, targetMetadata.storage.opfsProjectManifestSchemaVersion); + switchCurrent(installRoot, installed.releaseName); + projectAfter = readJson(path.join(originStorage, "scene.blend.meta.json")); + assert.deepEqual(projectAfter, projectBefore); + assert.equal(fileSha256(path.join(originStorage, "scene.blend")), projectBefore.sha256); + return { from: upgraded.to, to: installed.releaseName, projectRevision: projectAfter.revision, projectSha256: projectAfter.sha256 }; + }); + + await run("rollback-http", "HEAD / && GET Range:bytes=0-15 after rollback", () => validateInstalledHttp(installRoot)); +} +catch (error) { + failure = error; +} +finally { + if (server) await new Promise((resolve) => server.close(resolve)); + fs.rmSync(workspace, { recursive: true, force: true }); +} + +const report = { + schemaVersion: 1, + task: "M6-17E", + status: failure ? "FAILED" : "READY", + generatedAt: new Date().toISOString(), + freshTemporaryRoot: true, + oneContinuousWorkspace: true, + workspaceCleaned: !fs.existsSync(workspace), + project: projectBefore && projectAfter ? { + revisionBefore: projectBefore.revision, + revisionAfter: projectAfter.revision, + sha256Before: projectBefore.sha256, + sha256After: projectAfter.sha256, + preserved: projectBefore.revision === projectAfter.revision && projectBefore.sha256 === projectAfter.sha256, + } : null, + records, +}; +const reportRoot = path.join(releaseRoot, "operations-reports"); +fs.mkdirSync(reportRoot, { recursive: true }); +const reportPath = path.join(reportRoot, "rehearsal.json"); +fs.writeFileSync(reportPath, `${JSON.stringify(report, null, 2)}\n`); +fs.writeFileSync(`${reportPath}.sha256`, `${fileSha256(reportPath)} ${path.basename(reportPath)}\n`); +process.stdout.write(`operations-rehearsal status=${report.status} records=${records.length} project=${report.project?.preserved === true ? "preserved" : "unverified"} cleanup=${report.workspaceCleaned}\n`); +if (failure) throw failure; diff --git a/tools/web/run-v1-acceptance.mjs b/tools/web/run-v1-acceptance.mjs index 635e9258..91bb15ee 100644 --- a/tools/web/run-v1-acceptance.mjs +++ b/tools/web/run-v1-acceptance.mjs @@ -31,7 +31,7 @@ if (blenderArchiveSha256 && !/^[a-f0-9]{64}$/.test(blenderArchiveSha256)) { const environment = { node: process.version, npm: capture("npm", ["--version"]).split(/\r?\n/)[0], - chromium: capture(process.env.CHROME_PATH ?? "/home/mes123456/.local/bin/google-chrome", ["--version"]).split(/\r?\n/)[0], + chromium: capture(process.env.CHROME_PATH ?? "google-chrome", ["--version"]).split(/\r?\n/)[0], blenderBin: process.env.BLENDER_BIN ? "BLENDER_BIN" : blenderBin, blenderExecutableSha256: fs.existsSync(blenderBin) ? sha256(fs.readFileSync(blenderBin)) : "unavailable", blenderArchiveSha256: blenderArchiveSha256 || "unavailable", diff --git a/tools/web/update-engine-manifest.mjs b/tools/web/update-engine-manifest.mjs index 239f4255..10bda8f9 100644 --- a/tools/web/update-engine-manifest.mjs +++ b/tools/web/update-engine-manifest.mjs @@ -1,12 +1,51 @@ +import crypto from "node:crypto"; import fs from "node:fs"; +import path from "node:path"; -const [manifestPath, wasmHash] = process.argv.slice(2); -if (!manifestPath || !/^[a-f0-9]{64}$/.test(wasmHash ?? "")) { - throw new Error("usage: update-engine-manifest.mjs "); +const [manifestPath, singleDirectory, pthreadDirectory] = process.argv.slice(2); +if (!manifestPath || !singleDirectory || !pthreadDirectory) { + throw new Error( + "usage: update-engine-manifest.mjs ", + ); } const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8")); -const resource = manifest.wasm?.find((entry) => entry.id === "web-engine-bootstrap"); -if (!resource) throw new Error("web-engine-bootstrap resource is missing from the engine manifest"); -resource.sha256 = wasmHash; -fs.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`); +if (typeof manifest.engineVersion !== "string" || manifest.engineVersion.length === 0) { + throw new Error("engineVersion is missing from the existing engine manifest"); +} + +function resource(directory, variant, fileName) { + const filePath = path.join(directory, fileName); + const bytes = fs.readFileSync(filePath); + if (bytes.byteLength === 0) throw new Error(`${variant} ${fileName} is empty`); + return { + fileName, + url: `/vendor/blender/${variant}/${fileName}`, + sha256: crypto.createHash("sha256").update(bytes).digest("hex"), + }; +} + +const singleJs = resource(singleDirectory, "single", "web_engine.js"); +const singleWasm = resource(singleDirectory, "single", "web_engine.wasm"); +const pthreadJs = resource(pthreadDirectory, "pthread", "web_engine.js"); +const pthreadWasm = resource(pthreadDirectory, "pthread", "web_engine.wasm"); +const updated = { + schemaVersion: 2, + protocolVersion: 1, + releaseId: typeof manifest.releaseId === "string" ? manifest.releaseId : manifest.engineVersion, + engineVersion: manifest.engineVersion, + engine: "blender-wasm", + variants: [ + { + id: "single", + memory: { initialPages: 256, maximumPages: 32768, shared: false }, + resources: { js: singleJs, wasm: singleWasm }, + }, + { + id: "pthread", + memory: { initialPages: 256, maximumPages: 32768, shared: true }, + resources: { js: pthreadJs, wasm: pthreadWasm, pthreadWorker: pthreadJs }, + }, + ], +}; +fs.writeFileSync(manifestPath, `${JSON.stringify(updated, null, 2)}\n`); diff --git a/web/app/public/engine-manifest.json b/web/app/public/engine-manifest.json index 9313d4ef..67c8840d 100644 --- a/web/app/public/engine-manifest.json +++ b/web/app/public/engine-manifest.json @@ -1,20 +1,54 @@ { - "schemaVersion": 1, + "schemaVersion": 2, "protocolVersion": 1, - "engineVersion": "blender-wasm-0.1.0", + "releaseId": "blender-wasm-0.1.0-rc.1", + "engineVersion": "blender-wasm-0.1.0-rc.1", "engine": "blender-wasm", - "memory": { - "initialPages": 256, - "maximumPages": 32768, - "shared": false - }, - "wasm": [ + "variants": [ { - "id": "web-engine-bootstrap", - "fileName": "web_engine.wasm", - "url": "/vendor/blender/web_engine.wasm", - "sha256": "5d87a9ea57bd7a1888f16a5f4306e1c6d3a1bdfcf832c9485fe8518aac528fd8", - "required": true + "id": "single", + "memory": { + "initialPages": 256, + "maximumPages": 32768, + "shared": false + }, + "resources": { + "js": { + "fileName": "web_engine.js", + "url": "/vendor/blender/single/web_engine.js", + "sha256": "eedb8cedeb2190fbece91d58cd5dd568356caf42191517aff2085911177157ca" + }, + "wasm": { + "fileName": "web_engine.wasm", + "url": "/vendor/blender/single/web_engine.wasm", + "sha256": "f079e2221b501eee7f0b8e3290c22f37210ba44ee7a392c7fa817fde16b9ee5e" + } + } + }, + { + "id": "pthread", + "memory": { + "initialPages": 256, + "maximumPages": 32768, + "shared": true + }, + "resources": { + "js": { + "fileName": "web_engine.js", + "url": "/vendor/blender/pthread/web_engine.js", + "sha256": "5a78f2e27969074f72902805c32453c980841c390db6c48eb9d43787d33a8837" + }, + "wasm": { + "fileName": "web_engine.wasm", + "url": "/vendor/blender/pthread/web_engine.wasm", + "sha256": "a6bed7b410b15f0d5aca229d1e926bff861e3ff16f0d3d6abc1bc73bcaf5fc0b" + }, + "pthreadWorker": { + "fileName": "web_engine.js", + "url": "/vendor/blender/pthread/web_engine.js", + "sha256": "5a78f2e27969074f72902805c32453c980841c390db6c48eb9d43787d33a8837" + } + } } ] } diff --git a/web/app/public/vendor/blender/pthread/web_engine.js b/web/app/public/vendor/blender/pthread/web_engine.js new file mode 100644 index 00000000..17a821e0 --- /dev/null +++ b/web/app/public/vendor/blender/pthread/web_engine.js @@ -0,0 +1,19 @@ + +var Module = (() => { + var _scriptName = import.meta.url; + + return ( +function(moduleArg = {}) { + var moduleRtn; + +function GROWABLE_HEAP_I8(){if(wasmMemory.buffer!=HEAP8.buffer){updateMemoryViews()}return HEAP8}function GROWABLE_HEAP_U8(){if(wasmMemory.buffer!=HEAP8.buffer){updateMemoryViews()}return HEAPU8}function GROWABLE_HEAP_I32(){if(wasmMemory.buffer!=HEAP8.buffer){updateMemoryViews()}return HEAP32}function GROWABLE_HEAP_U32(){if(wasmMemory.buffer!=HEAP8.buffer){updateMemoryViews()}return HEAPU32}function GROWABLE_HEAP_F64(){if(wasmMemory.buffer!=HEAP8.buffer){updateMemoryViews()}return HEAPF64}var Module=moduleArg;var readyPromiseResolve,readyPromiseReject;var readyPromise=new Promise((resolve,reject)=>{readyPromiseResolve=resolve;readyPromiseReject=reject});var ENVIRONMENT_IS_WEB=typeof window=="object";var ENVIRONMENT_IS_WORKER=typeof importScripts=="function";var ENVIRONMENT_IS_NODE=typeof process=="object"&&typeof process.versions=="object"&&typeof process.versions.node=="string"&&process.type!="renderer";var ENVIRONMENT_IS_PTHREAD=ENVIRONMENT_IS_WORKER&&self.name?.startsWith("em-pthread");var moduleOverrides=Object.assign({},Module);var arguments_=[];var thisProgram="./this.program";var quit_=(status,toThrow)=>{throw toThrow};var scriptDirectory="";function locateFile(path){if(Module["locateFile"]){return Module["locateFile"](path,scriptDirectory)}return scriptDirectory+path}var readAsync,readBinary;if(ENVIRONMENT_IS_WEB||ENVIRONMENT_IS_WORKER){if(ENVIRONMENT_IS_WORKER){scriptDirectory=self.location.href}else if(typeof document!="undefined"&&document.currentScript){scriptDirectory=document.currentScript.src}if(_scriptName){scriptDirectory=_scriptName}if(scriptDirectory.startsWith("blob:")){scriptDirectory=""}else{scriptDirectory=scriptDirectory.substr(0,scriptDirectory.replace(/[?#].*/,"").lastIndexOf("/")+1)}{if(ENVIRONMENT_IS_WORKER){readBinary=url=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,false);xhr.responseType="arraybuffer";xhr.send(null);return new Uint8Array(xhr.response)}}readAsync=url=>fetch(url,{credentials:"same-origin"}).then(response=>{if(response.ok){return response.arrayBuffer()}return Promise.reject(new Error(response.status+" : "+response.url))})}}else{}var out=Module["print"]||console.log.bind(console);var err=Module["printErr"]||console.error.bind(console);Object.assign(Module,moduleOverrides);moduleOverrides=null;if(Module["arguments"])arguments_=Module["arguments"];if(Module["thisProgram"])thisProgram=Module["thisProgram"];var wasmBinary=Module["wasmBinary"];var wasmMemory;var wasmModule;var ABORT=false;var EXITSTATUS;var HEAP8,HEAPU8,HEAP16,HEAPU16,HEAP32,HEAPU32,HEAPF32,HEAPF64;function updateMemoryViews(){var b=wasmMemory.buffer;Module["HEAP8"]=HEAP8=new Int8Array(b);Module["HEAP16"]=HEAP16=new Int16Array(b);Module["HEAPU8"]=HEAPU8=new Uint8Array(b);Module["HEAPU16"]=HEAPU16=new Uint16Array(b);Module["HEAP32"]=HEAP32=new Int32Array(b);Module["HEAPU32"]=HEAPU32=new Uint32Array(b);Module["HEAPF32"]=HEAPF32=new Float32Array(b);Module["HEAPF64"]=HEAPF64=new Float64Array(b)}if(ENVIRONMENT_IS_PTHREAD){var wasmPromiseResolve;var wasmPromiseReject;var initializedJS=false;function threadPrintErr(...args){var text=args.join(" ");console.error(text)}if(!Module["printErr"])err=threadPrintErr;function threadAlert(...args){var text=args.join(" ");postMessage({cmd:"alert",text,threadId:_pthread_self()})}self.alert=threadAlert;Module["instantiateWasm"]=(info,receiveInstance)=>new Promise((resolve,reject)=>{wasmPromiseResolve=module=>{var instance=new WebAssembly.Instance(module,getWasmImports());receiveInstance(instance);resolve()};wasmPromiseReject=reject});self.onunhandledrejection=e=>{throw e.reason||e};function handleMessage(e){try{var msgData=e["data"];var cmd=msgData.cmd;if(cmd==="load"){let messageQueue=[];self.onmessage=e=>messageQueue.push(e);self.startWorker=instance=>{postMessage({cmd:"loaded"});for(let msg of messageQueue){handleMessage(msg)}self.onmessage=handleMessage};for(const handler of msgData.handlers){if(!Module[handler]||Module[handler].proxy){Module[handler]=(...args)=>{postMessage({cmd:"callHandler",handler,args})};if(handler=="print")out=Module[handler];if(handler=="printErr")err=Module[handler]}}wasmMemory=msgData.wasmMemory;updateMemoryViews();wasmPromiseResolve(msgData.wasmModule)}else if(cmd==="run"){establishStackSpace(msgData.pthread_ptr);__emscripten_thread_init(msgData.pthread_ptr,0,0,1,0,0);PThread.receiveObjectTransfer(msgData);PThread.threadInitTLS();__emscripten_thread_mailbox_await(msgData.pthread_ptr);if(!initializedJS){initializedJS=true}try{invokeEntryPoint(msgData.start_routine,msgData.arg)}catch(ex){if(ex!="unwind"){throw ex}}}else if(msgData.target==="setimmediate"){}else if(cmd==="checkMailbox"){if(initializedJS){checkMailbox()}}else if(cmd){err(`worker: received unknown command ${cmd}`);err(msgData)}}catch(ex){__emscripten_thread_crashed();throw ex}}self.onmessage=handleMessage}if(!ENVIRONMENT_IS_PTHREAD){if(Module["wasmMemory"]){wasmMemory=Module["wasmMemory"]}else{var INITIAL_MEMORY=Module["INITIAL_MEMORY"]||16777216;wasmMemory=new WebAssembly.Memory({initial:INITIAL_MEMORY/65536,maximum:32768,shared:true})}updateMemoryViews()}var __ATPRERUN__=[];var __ATINIT__=[];var __ATPOSTRUN__=[];var runtimeInitialized=false;function preRun(){var preRuns=Module["preRun"];if(preRuns){if(typeof preRuns=="function")preRuns=[preRuns];preRuns.forEach(addOnPreRun)}callRuntimeCallbacks(__ATPRERUN__)}function initRuntime(){runtimeInitialized=true;if(ENVIRONMENT_IS_PTHREAD)return;callRuntimeCallbacks(__ATINIT__)}function postRun(){if(ENVIRONMENT_IS_PTHREAD)return;var postRuns=Module["postRun"];if(postRuns){if(typeof postRuns=="function")postRuns=[postRuns];postRuns.forEach(addOnPostRun)}callRuntimeCallbacks(__ATPOSTRUN__)}function addOnPreRun(cb){__ATPRERUN__.unshift(cb)}function addOnInit(cb){__ATINIT__.unshift(cb)}function addOnPostRun(cb){__ATPOSTRUN__.unshift(cb)}var runDependencies=0;var runDependencyWatcher=null;var dependenciesFulfilled=null;function addRunDependency(id){runDependencies++;Module["monitorRunDependencies"]?.(runDependencies)}function removeRunDependency(id){runDependencies--;Module["monitorRunDependencies"]?.(runDependencies);if(runDependencies==0){if(runDependencyWatcher!==null){clearInterval(runDependencyWatcher);runDependencyWatcher=null}if(dependenciesFulfilled){var callback=dependenciesFulfilled;dependenciesFulfilled=null;callback()}}}function abort(what){Module["onAbort"]?.(what);what="Aborted("+what+")";err(what);ABORT=true;what+=". Build with -sASSERTIONS for more info.";var e=new WebAssembly.RuntimeError(what);readyPromiseReject(e);throw e}var dataURIPrefix="data:application/octet-stream;base64,";var isDataURI=filename=>filename.startsWith(dataURIPrefix);function findWasmBinary(){if(Module["locateFile"]){var f="web_engine.wasm";if(!isDataURI(f)){return locateFile(f)}return f}return new URL("web_engine.wasm",import.meta.url).href}var wasmBinaryFile;function getBinarySync(file){if(file==wasmBinaryFile&&wasmBinary){return new Uint8Array(wasmBinary)}if(readBinary){return readBinary(file)}throw"both async and sync fetching of the wasm failed"}function getBinaryPromise(binaryFile){if(!wasmBinary){return readAsync(binaryFile).then(response=>new Uint8Array(response),()=>getBinarySync(binaryFile))}return Promise.resolve().then(()=>getBinarySync(binaryFile))}function instantiateArrayBuffer(binaryFile,imports,receiver){return getBinaryPromise(binaryFile).then(binary=>WebAssembly.instantiate(binary,imports)).then(receiver,reason=>{err(`failed to asynchronously prepare wasm: ${reason}`);abort(reason)})}function instantiateAsync(binary,binaryFile,imports,callback){if(!binary&&typeof WebAssembly.instantiateStreaming=="function"&&!isDataURI(binaryFile)&&typeof fetch=="function"){return fetch(binaryFile,{credentials:"same-origin"}).then(response=>{var result=WebAssembly.instantiateStreaming(response,imports);return result.then(callback,function(reason){err(`wasm streaming compile failed: ${reason}`);err("falling back to ArrayBuffer instantiation");return instantiateArrayBuffer(binaryFile,imports,callback)})})}return instantiateArrayBuffer(binaryFile,imports,callback)}function getWasmImports(){assignWasmImports();return{a:wasmImports}}function createWasm(){var info=getWasmImports();function receiveInstance(instance,module){wasmExports=instance.exports;registerTLSInit(wasmExports["na"]);wasmTable=wasmExports["Z"];addOnInit(wasmExports["S"]);wasmModule=module;removeRunDependency("wasm-instantiate");return wasmExports}addRunDependency("wasm-instantiate");function receiveInstantiationResult(result){receiveInstance(result["instance"],result["module"])}if(Module["instantiateWasm"]){try{return Module["instantiateWasm"](info,receiveInstance)}catch(e){err(`Module.instantiateWasm callback failed with error: ${e}`);readyPromiseReject(e)}}wasmBinaryFile??=findWasmBinary();instantiateAsync(wasmBinary,wasmBinaryFile,info,receiveInstantiationResult).catch(readyPromiseReject);return{}}function ExitStatus(status){this.name="ExitStatus";this.message=`Program terminated with exit(${status})`;this.status=status}var terminateWorker=worker=>{worker.terminate();worker.onmessage=e=>{}};var cleanupThread=pthread_ptr=>{var worker=PThread.pthreads[pthread_ptr];PThread.returnWorkerToPool(worker)};var spawnThread=threadParams=>{var worker=PThread.getNewWorker();if(!worker){return 6}PThread.runningWorkers.push(worker);PThread.pthreads[threadParams.pthread_ptr]=worker;worker.pthread_ptr=threadParams.pthread_ptr;var msg={cmd:"run",start_routine:threadParams.startRoutine,arg:threadParams.arg,pthread_ptr:threadParams.pthread_ptr};worker.postMessage(msg,threadParams.transferList);return 0};var runtimeKeepaliveCounter=0;var keepRuntimeAlive=()=>noExitRuntime||runtimeKeepaliveCounter>0;var stackSave=()=>_emscripten_stack_get_current();var stackRestore=val=>__emscripten_stack_restore(val);var stackAlloc=sz=>__emscripten_stack_alloc(sz);var proxyToMainThread=(funcIndex,emAsmAddr,sync,...callArgs)=>{var serializedNumCallArgs=callArgs.length;var sp=stackSave();var args=stackAlloc(serializedNumCallArgs*8);var b=args>>3;for(var i=0;i{if(e instanceof ExitStatus||e=="unwind"){return EXITSTATUS}quit_(1,e)};function exitOnMainThread(returnCode){if(ENVIRONMENT_IS_PTHREAD)return proxyToMainThread(1,0,0,returnCode);_exit(returnCode)}var exitJS=(status,implicit)=>{EXITSTATUS=status;if(ENVIRONMENT_IS_PTHREAD){exitOnMainThread(status);throw"unwind"}_proc_exit(status)};var _exit=exitJS;var PThread={unusedWorkers:[],runningWorkers:[],tlsInitFunctions:[],pthreads:{},init(){if(!ENVIRONMENT_IS_PTHREAD){PThread.initMainThread()}},initMainThread(){var pthreadPoolSize=1;while(pthreadPoolSize--){PThread.allocateUnusedWorker()}addOnPreRun(()=>{addRunDependency("loading-workers");PThread.loadWasmModuleToAllWorkers(()=>removeRunDependency("loading-workers"))})},terminateAllThreads:()=>{for(var worker of PThread.runningWorkers){terminateWorker(worker)}for(var worker of PThread.unusedWorkers){terminateWorker(worker)}PThread.unusedWorkers=[];PThread.runningWorkers=[];PThread.pthreads=[]},returnWorkerToPool:worker=>{var pthread_ptr=worker.pthread_ptr;delete PThread.pthreads[pthread_ptr];PThread.unusedWorkers.push(worker);PThread.runningWorkers.splice(PThread.runningWorkers.indexOf(worker),1);worker.pthread_ptr=0;__emscripten_thread_free_data(pthread_ptr)},receiveObjectTransfer(data){},threadInitTLS(){PThread.tlsInitFunctions.forEach(f=>f())},loadWasmModuleToWorker:worker=>new Promise(onFinishedLoading=>{worker.onmessage=e=>{var d=e["data"];var cmd=d.cmd;if(d.targetThread&&d.targetThread!=_pthread_self()){var targetWorker=PThread.pthreads[d.targetThread];if(targetWorker){targetWorker.postMessage(d,d.transferList)}else{err(`Internal error! Worker sent a message "${cmd}" to target pthread ${d.targetThread}, but that thread no longer exists!`)}return}if(cmd==="checkMailbox"){checkMailbox()}else if(cmd==="spawnThread"){spawnThread(d)}else if(cmd==="cleanupThread"){cleanupThread(d.thread)}else if(cmd==="loaded"){worker.loaded=true;onFinishedLoading(worker)}else if(cmd==="alert"){alert(`Thread ${d.threadId}: ${d.text}`)}else if(d.target==="setimmediate"){worker.postMessage(d)}else if(cmd==="callHandler"){Module[d.handler](...d.args)}else if(cmd){err(`worker sent an unknown command ${cmd}`)}};worker.onerror=e=>{var message="worker sent an error!";err(`${message} ${e.filename}:${e.lineno}: ${e.message}`);throw e};var handlers=[];var knownHandlers=["onExit","onAbort","print","printErr"];for(var handler of knownHandlers){if(Module.propertyIsEnumerable(handler)){handlers.push(handler)}}worker.postMessage({cmd:"load",handlers,wasmMemory,wasmModule})}),loadWasmModuleToAllWorkers(onMaybeReady){if(ENVIRONMENT_IS_PTHREAD){return onMaybeReady()}let pthreadPoolReady=Promise.all(PThread.unusedWorkers.map(PThread.loadWasmModuleToWorker));pthreadPoolReady.then(onMaybeReady)},allocateUnusedWorker(){var worker;var workerOptions={type:"module",name:"em-pthread"};worker=new Worker(new URL("web_engine.js",import.meta.url),workerOptions);PThread.unusedWorkers.push(worker)},getNewWorker(){if(PThread.unusedWorkers.length==0){PThread.allocateUnusedWorker();PThread.loadWasmModuleToWorker(PThread.unusedWorkers[0])}return PThread.unusedWorkers.pop()}};var callRuntimeCallbacks=callbacks=>{callbacks.forEach(f=>f(Module))};var establishStackSpace=pthread_ptr=>{updateMemoryViews();var stackHigh=GROWABLE_HEAP_U32()[pthread_ptr+52>>2];var stackSize=GROWABLE_HEAP_U32()[pthread_ptr+56>>2];var stackLow=stackHigh-stackSize;_emscripten_stack_set_limits(stackHigh,stackLow);stackRestore(stackHigh)};var wasmTableMirror=[];var wasmTable;var getWasmTableEntry=funcPtr=>{var func=wasmTableMirror[funcPtr];if(!func){if(funcPtr>=wasmTableMirror.length)wasmTableMirror.length=funcPtr+1;wasmTableMirror[funcPtr]=func=wasmTable.get(funcPtr)}return func};var invokeEntryPoint=(ptr,arg)=>{runtimeKeepaliveCounter=0;noExitRuntime=0;var result=getWasmTableEntry(ptr)(arg);function finish(result){if(keepRuntimeAlive()){EXITSTATUS=result}else{__emscripten_thread_exit(result)}}finish(result)};var noExitRuntime=Module["noExitRuntime"]||true;var registerTLSInit=tlsInitFunc=>PThread.tlsInitFunctions.push(tlsInitFunc);var exceptionCaught=[];var uncaughtExceptionCount=0;var ___cxa_begin_catch=ptr=>{var info=new ExceptionInfo(ptr);if(!info.get_caught()){info.set_caught(true);uncaughtExceptionCount--}info.set_rethrown(false);exceptionCaught.push(info);___cxa_increment_exception_refcount(ptr);return ___cxa_get_exception_ptr(ptr)};var exceptionLast=0;var ___cxa_end_catch=()=>{_setThrew(0,0);var info=exceptionCaught.pop();___cxa_decrement_exception_refcount(info.excPtr);exceptionLast=0};class ExceptionInfo{constructor(excPtr){this.excPtr=excPtr;this.ptr=excPtr-24}set_type(type){GROWABLE_HEAP_U32()[this.ptr+4>>2]=type}get_type(){return GROWABLE_HEAP_U32()[this.ptr+4>>2]}set_destructor(destructor){GROWABLE_HEAP_U32()[this.ptr+8>>2]=destructor}get_destructor(){return GROWABLE_HEAP_U32()[this.ptr+8>>2]}set_caught(caught){caught=caught?1:0;GROWABLE_HEAP_I8()[this.ptr+12]=caught}get_caught(){return GROWABLE_HEAP_I8()[this.ptr+12]!=0}set_rethrown(rethrown){rethrown=rethrown?1:0;GROWABLE_HEAP_I8()[this.ptr+13]=rethrown}get_rethrown(){return GROWABLE_HEAP_I8()[this.ptr+13]!=0}init(type,destructor){this.set_adjusted_ptr(0);this.set_type(type);this.set_destructor(destructor)}set_adjusted_ptr(adjustedPtr){GROWABLE_HEAP_U32()[this.ptr+16>>2]=adjustedPtr}get_adjusted_ptr(){return GROWABLE_HEAP_U32()[this.ptr+16>>2]}}var ___resumeException=ptr=>{if(!exceptionLast){exceptionLast=ptr}throw exceptionLast};var setTempRet0=val=>__emscripten_tempret_set(val);var findMatchingCatch=args=>{var thrown=exceptionLast;if(!thrown){setTempRet0(0);return 0}var info=new ExceptionInfo(thrown);info.set_adjusted_ptr(thrown);var thrownType=info.get_type();if(!thrownType){setTempRet0(0);return thrown}for(var caughtType of args){if(caughtType===0||caughtType===thrownType){break}var adjusted_ptr_addr=info.ptr+16;if(___cxa_can_catch(caughtType,thrownType,adjusted_ptr_addr)){setTempRet0(caughtType);return thrown}}setTempRet0(thrownType);return thrown};var ___cxa_find_matching_catch_2=()=>findMatchingCatch([]);var ___cxa_find_matching_catch_3=arg0=>findMatchingCatch([arg0]);var ___cxa_rethrow=()=>{var info=exceptionCaught.pop();if(!info){abort("no exception to throw")}var ptr=info.excPtr;if(!info.get_rethrown()){exceptionCaught.push(info);info.set_rethrown(true);info.set_caught(false);uncaughtExceptionCount++}exceptionLast=ptr;throw exceptionLast};var ___cxa_throw=(ptr,type,destructor)=>{var info=new ExceptionInfo(ptr);info.init(type,destructor);exceptionLast=ptr;uncaughtExceptionCount++;throw exceptionLast};var __abort_js=()=>{abort("")};var __emscripten_init_main_thread_js=tb=>{__emscripten_thread_init(tb,!ENVIRONMENT_IS_WORKER,1,!ENVIRONMENT_IS_WEB,65536,false);PThread.threadInitTLS()};var maybeExit=()=>{if(!keepRuntimeAlive()){try{if(ENVIRONMENT_IS_PTHREAD)__emscripten_thread_exit(EXITSTATUS);else _exit(EXITSTATUS)}catch(e){handleException(e)}}};var callUserCallback=func=>{if(ABORT){return}try{func();maybeExit()}catch(e){handleException(e)}};var __emscripten_thread_mailbox_await=pthread_ptr=>{if(typeof Atomics.waitAsync==="function"){var wait=Atomics.waitAsync(GROWABLE_HEAP_I32(),pthread_ptr>>2,pthread_ptr);wait.value.then(checkMailbox);var waitingAsync=pthread_ptr+128;Atomics.store(GROWABLE_HEAP_I32(),waitingAsync>>2,1)}};var checkMailbox=()=>{var pthread_ptr=_pthread_self();if(pthread_ptr){__emscripten_thread_mailbox_await(pthread_ptr);callUserCallback(__emscripten_check_mailbox)}};var __emscripten_notify_mailbox_postmessage=(targetThread,currThreadId)=>{if(targetThread==currThreadId){setTimeout(checkMailbox)}else if(ENVIRONMENT_IS_PTHREAD){postMessage({targetThread,cmd:"checkMailbox"})}else{var worker=PThread.pthreads[targetThread];if(!worker){return}worker.postMessage({cmd:"checkMailbox"})}};var proxiedJSCallArgs=[];var __emscripten_receive_on_main_thread_js=(funcIndex,emAsmAddr,callingThread,numCallArgs,args)=>{proxiedJSCallArgs.length=numCallArgs;var b=args>>3;for(var i=0;i{if(!ENVIRONMENT_IS_PTHREAD)cleanupThread(thread);else postMessage({cmd:"cleanupThread",thread})};var __emscripten_thread_set_strongref=thread=>{};var warnOnce=text=>{warnOnce.shown||={};if(!warnOnce.shown[text]){warnOnce.shown[text]=1;err(text)}};var _emscripten_check_blocking_allowed=()=>{};var runtimeKeepalivePush=()=>{runtimeKeepaliveCounter+=1};var _emscripten_exit_with_live_runtime=()=>{runtimeKeepalivePush();throw"unwind"};var _emscripten_get_now=()=>performance.timeOrigin+performance.now();var getHeapMax=()=>2147483648;var alignMemory=(size,alignment)=>Math.ceil(size/alignment)*alignment;var growMemory=size=>{var b=wasmMemory.buffer;var pages=(size-b.byteLength+65535)/65536|0;try{wasmMemory.grow(pages);updateMemoryViews();return 1}catch(e){}};var _emscripten_resize_heap=requestedSize=>{var oldSize=GROWABLE_HEAP_U8().length;requestedSize>>>=0;if(requestedSize<=oldSize){return false}var maxHeapSize=getHeapMax();if(requestedSize>maxHeapSize){return false}for(var cutDown=1;cutDown<=4;cutDown*=2){var overGrownHeapSize=oldSize*(1+.2/cutDown);overGrownHeapSize=Math.min(overGrownHeapSize,requestedSize+100663296);var newSize=Math.min(maxHeapSize,alignMemory(Math.max(requestedSize,overGrownHeapSize),65536));var replacement=growMemory(newSize);if(replacement){return true}}return false};var _llvm_eh_typeid_for=type=>type;var getCFunc=ident=>{var func=Module["_"+ident];return func};var writeArrayToMemory=(array,buffer)=>{GROWABLE_HEAP_I8().set(array,buffer)};var lengthBytesUTF8=str=>{var len=0;for(var i=0;i=55296&&c<=57343){len+=4;++i}else{len+=3}}return len};var stringToUTF8Array=(str,heap,outIdx,maxBytesToWrite)=>{if(!(maxBytesToWrite>0))return 0;var startIdx=outIdx;var endIdx=outIdx+maxBytesToWrite-1;for(var i=0;i=55296&&u<=57343){var u1=str.charCodeAt(++i);u=65536+((u&1023)<<10)|u1&1023}if(u<=127){if(outIdx>=endIdx)break;heap[outIdx++]=u}else if(u<=2047){if(outIdx+1>=endIdx)break;heap[outIdx++]=192|u>>6;heap[outIdx++]=128|u&63}else if(u<=65535){if(outIdx+2>=endIdx)break;heap[outIdx++]=224|u>>12;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63}else{if(outIdx+3>=endIdx)break;heap[outIdx++]=240|u>>18;heap[outIdx++]=128|u>>12&63;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63}}heap[outIdx]=0;return outIdx-startIdx};var stringToUTF8=(str,outPtr,maxBytesToWrite)=>stringToUTF8Array(str,GROWABLE_HEAP_U8(),outPtr,maxBytesToWrite);var stringToUTF8OnStack=str=>{var size=lengthBytesUTF8(str)+1;var ret=stackAlloc(size);stringToUTF8(str,ret,size);return ret};var UTF8Decoder=typeof TextDecoder!="undefined"?new TextDecoder:undefined;var UTF8ArrayToString=(heapOrArray,idx=0,maxBytesToRead=NaN)=>{var endIdx=idx+maxBytesToRead;var endPtr=idx;while(heapOrArray[endPtr]&&!(endPtr>=endIdx))++endPtr;if(endPtr-idx>16&&heapOrArray.buffer&&UTF8Decoder){return UTF8Decoder.decode(heapOrArray.buffer instanceof SharedArrayBuffer?heapOrArray.slice(idx,endPtr):heapOrArray.subarray(idx,endPtr))}var str="";while(idx>10,56320|ch&1023)}}return str};var UTF8ToString=(ptr,maxBytesToRead)=>ptr?UTF8ArrayToString(GROWABLE_HEAP_U8(),ptr,maxBytesToRead):"";var ccall=(ident,returnType,argTypes,args,opts)=>{var toC={string:str=>{var ret=0;if(str!==null&&str!==undefined&&str!==0){ret=stringToUTF8OnStack(str)}return ret},array:arr=>{var ret=stackAlloc(arr.length);writeArrayToMemory(arr,ret);return ret}};function convertReturnValue(ret){if(returnType==="string"){return UTF8ToString(ret)}if(returnType==="boolean")return Boolean(ret);return ret}var func=getCFunc(ident);var cArgs=[];var stack=0;if(args){for(var i=0;i{var numericArgs=!argTypes||argTypes.every(type=>type==="number"||type==="boolean");var numericRet=returnType!=="string";if(numericRet&&numericArgs&&!opts){return getCFunc(ident)}return(...args)=>ccall(ident,returnType,argTypes,args,opts)};PThread.init();var proxiedFunctionTable=[_proc_exit,exitOnMainThread];var wasmImports;function assignWasmImports(){wasmImports={s:___cxa_begin_catch,x:___cxa_end_catch,b:___cxa_find_matching_catch_2,c:___cxa_find_matching_catch_3,L:___cxa_rethrow,u:___cxa_throw,h:___resumeException,C:__abort_js,I:__emscripten_init_main_thread_js,E:__emscripten_notify_mailbox_postmessage,J:__emscripten_receive_on_main_thread_js,B:__emscripten_thread_cleanup,H:__emscripten_thread_mailbox_await,G:__emscripten_thread_set_strongref,K:_emscripten_check_blocking_allowed,F:_emscripten_exit_with_live_runtime,v:_emscripten_get_now,D:_emscripten_resize_heap,A:_exit,q:invoke_fiii,j:invoke_ii,e:invoke_iii,g:invoke_iiii,P:invoke_iiiiffifffffffi,k:invoke_iiiii,O:invoke_iiiiifi,m:invoke_iiiiii,r:invoke_iiiiiii,Q:invoke_iiiiiiifii,N:invoke_iiiiiiii,w:invoke_iiiiiiiii,R:invoke_iiiiiiiiii,z:invoke_jiii,p:invoke_v,n:invoke_vi,d:invoke_vii,i:invoke_viii,f:invoke_viiii,l:invoke_viiiii,o:invoke_viiiiii,M:invoke_viiiiiii,y:invoke_viiij,t:_llvm_eh_typeid_for,a:wasmMemory}}var wasmExports=createWasm();var ___wasm_call_ctors=()=>(___wasm_call_ctors=wasmExports["S"])();var _web_engine_create=Module["_web_engine_create"]=()=>(_web_engine_create=Module["_web_engine_create"]=wasmExports["T"])();var _web_engine_get_memory_stats=Module["_web_engine_get_memory_stats"]=a0=>(_web_engine_get_memory_stats=Module["_web_engine_get_memory_stats"]=wasmExports["U"])(a0);var _web_engine_destroy=Module["_web_engine_destroy"]=a0=>(_web_engine_destroy=Module["_web_engine_destroy"]=wasmExports["V"])(a0);var _web_engine_get_live_handles=Module["_web_engine_get_live_handles"]=()=>(_web_engine_get_live_handles=Module["_web_engine_get_live_handles"]=wasmExports["W"])();var _web_engine_get_allocated_bytes=Module["_web_engine_get_allocated_bytes"]=()=>(_web_engine_get_allocated_bytes=Module["_web_engine_get_allocated_bytes"]=wasmExports["X"])();var _web_engine_open_blend=Module["_web_engine_open_blend"]=(a0,a1,a2)=>(_web_engine_open_blend=Module["_web_engine_open_blend"]=wasmExports["Y"])(a0,a1,a2);var _web_engine_apply_command=Module["_web_engine_apply_command"]=(a0,a1,a2)=>(_web_engine_apply_command=Module["_web_engine_apply_command"]=wasmExports["_"])(a0,a1,a2);var _web_engine_undo=Module["_web_engine_undo"]=a0=>(_web_engine_undo=Module["_web_engine_undo"]=wasmExports["$"])(a0);var _web_engine_redo=Module["_web_engine_redo"]=a0=>(_web_engine_redo=Module["_web_engine_redo"]=wasmExports["aa"])(a0);var _web_engine_get_scene_snapshot=Module["_web_engine_get_scene_snapshot"]=(a0,a1,a2)=>(_web_engine_get_scene_snapshot=Module["_web_engine_get_scene_snapshot"]=wasmExports["ba"])(a0,a1,a2);var _web_engine_get_scene_metadata=Module["_web_engine_get_scene_metadata"]=(a0,a1,a2)=>(_web_engine_get_scene_metadata=Module["_web_engine_get_scene_metadata"]=wasmExports["ca"])(a0,a1,a2);var _web_engine_get_scene_geometry=Module["_web_engine_get_scene_geometry"]=(a0,a1,a2)=>(_web_engine_get_scene_geometry=Module["_web_engine_get_scene_geometry"]=wasmExports["da"])(a0,a1,a2);var _web_engine_get_scene_delta=Module["_web_engine_get_scene_delta"]=(a0,a1,a2)=>(_web_engine_get_scene_delta=Module["_web_engine_get_scene_delta"]=wasmExports["ea"])(a0,a1,a2);var _web_engine_get_packed_asset=Module["_web_engine_get_packed_asset"]=(a0,a1,a2,a3,a4)=>(_web_engine_get_packed_asset=Module["_web_engine_get_packed_asset"]=wasmExports["fa"])(a0,a1,a2,a3,a4);var _web_engine_evaluate_depsgraph=Module["_web_engine_evaluate_depsgraph"]=(a0,a1,a2)=>(_web_engine_evaluate_depsgraph=Module["_web_engine_evaluate_depsgraph"]=wasmExports["ga"])(a0,a1,a2);var _web_engine_save_blend=Module["_web_engine_save_blend"]=(a0,a1,a2)=>(_web_engine_save_blend=Module["_web_engine_save_blend"]=wasmExports["ha"])(a0,a1,a2);var _malloc=Module["_malloc"]=a0=>(_malloc=Module["_malloc"]=wasmExports["ia"])(a0);var _web_engine_free_buffer=Module["_web_engine_free_buffer"]=a0=>(_web_engine_free_buffer=Module["_web_engine_free_buffer"]=wasmExports["ja"])(a0);var _free=Module["_free"]=a0=>(_free=Module["_free"]=wasmExports["ka"])(a0);var _web_engine_last_error_code=Module["_web_engine_last_error_code"]=()=>(_web_engine_last_error_code=Module["_web_engine_last_error_code"]=wasmExports["la"])();var _web_engine_last_error_message=Module["_web_engine_last_error_message"]=()=>(_web_engine_last_error_message=Module["_web_engine_last_error_message"]=wasmExports["ma"])();var __emscripten_tls_init=()=>(__emscripten_tls_init=wasmExports["na"])();var _pthread_self=()=>(_pthread_self=wasmExports["oa"])();var __emscripten_thread_init=(a0,a1,a2,a3,a4,a5)=>(__emscripten_thread_init=wasmExports["pa"])(a0,a1,a2,a3,a4,a5);var __emscripten_thread_crashed=()=>(__emscripten_thread_crashed=wasmExports["qa"])();var __emscripten_run_on_main_thread_js=(a0,a1,a2,a3,a4)=>(__emscripten_run_on_main_thread_js=wasmExports["ra"])(a0,a1,a2,a3,a4);var __emscripten_thread_free_data=a0=>(__emscripten_thread_free_data=wasmExports["sa"])(a0);var __emscripten_thread_exit=a0=>(__emscripten_thread_exit=wasmExports["ta"])(a0);var __emscripten_check_mailbox=()=>(__emscripten_check_mailbox=wasmExports["ua"])();var _setThrew=(a0,a1)=>(_setThrew=wasmExports["va"])(a0,a1);var __emscripten_tempret_set=a0=>(__emscripten_tempret_set=wasmExports["wa"])(a0);var _emscripten_stack_set_limits=(a0,a1)=>(_emscripten_stack_set_limits=wasmExports["xa"])(a0,a1);var __emscripten_stack_restore=a0=>(__emscripten_stack_restore=wasmExports["ya"])(a0);var __emscripten_stack_alloc=a0=>(__emscripten_stack_alloc=wasmExports["za"])(a0);var _emscripten_stack_get_current=()=>(_emscripten_stack_get_current=wasmExports["Aa"])();var ___cxa_increment_exception_refcount=a0=>(___cxa_increment_exception_refcount=wasmExports["Ba"])(a0);var ___cxa_decrement_exception_refcount=a0=>(___cxa_decrement_exception_refcount=wasmExports["Ca"])(a0);var ___cxa_can_catch=(a0,a1,a2)=>(___cxa_can_catch=wasmExports["Da"])(a0,a1,a2);var ___cxa_get_exception_ptr=a0=>(___cxa_get_exception_ptr=wasmExports["Ea"])(a0);var dynCall_jiii=Module["dynCall_jiii"]=(a0,a1,a2,a3)=>(dynCall_jiii=Module["dynCall_jiii"]=wasmExports["Fa"])(a0,a1,a2,a3);var dynCall_viiij=Module["dynCall_viiij"]=(a0,a1,a2,a3,a4,a5)=>(dynCall_viiij=Module["dynCall_viiij"]=wasmExports["Ga"])(a0,a1,a2,a3,a4,a5);function invoke_ii(index,a1){var sp=stackSave();try{return getWasmTableEntry(index)(a1)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_v(index){var sp=stackSave();try{getWasmTableEntry(index)()}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_iii(index,a1,a2){var sp=stackSave();try{return getWasmTableEntry(index)(a1,a2)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_iiii(index,a1,a2,a3){var sp=stackSave();try{return getWasmTableEntry(index)(a1,a2,a3)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_viiiii(index,a1,a2,a3,a4,a5){var sp=stackSave();try{getWasmTableEntry(index)(a1,a2,a3,a4,a5)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_vii(index,a1,a2){var sp=stackSave();try{getWasmTableEntry(index)(a1,a2)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_vi(index,a1){var sp=stackSave();try{getWasmTableEntry(index)(a1)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_viii(index,a1,a2,a3){var sp=stackSave();try{getWasmTableEntry(index)(a1,a2,a3)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_viiiiii(index,a1,a2,a3,a4,a5,a6){var sp=stackSave();try{getWasmTableEntry(index)(a1,a2,a3,a4,a5,a6)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_iiiiii(index,a1,a2,a3,a4,a5){var sp=stackSave();try{return getWasmTableEntry(index)(a1,a2,a3,a4,a5)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_iiiii(index,a1,a2,a3,a4){var sp=stackSave();try{return getWasmTableEntry(index)(a1,a2,a3,a4)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_viiii(index,a1,a2,a3,a4){var sp=stackSave();try{getWasmTableEntry(index)(a1,a2,a3,a4)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_iiiiiiiii(index,a1,a2,a3,a4,a5,a6,a7,a8){var sp=stackSave();try{return getWasmTableEntry(index)(a1,a2,a3,a4,a5,a6,a7,a8)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_iiiiiii(index,a1,a2,a3,a4,a5,a6){var sp=stackSave();try{return getWasmTableEntry(index)(a1,a2,a3,a4,a5,a6)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_iiiiiiiiii(index,a1,a2,a3,a4,a5,a6,a7,a8,a9){var sp=stackSave();try{return getWasmTableEntry(index)(a1,a2,a3,a4,a5,a6,a7,a8,a9)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_fiii(index,a1,a2,a3){var sp=stackSave();try{return getWasmTableEntry(index)(a1,a2,a3)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_iiiiiiifii(index,a1,a2,a3,a4,a5,a6,a7,a8,a9){var sp=stackSave();try{return getWasmTableEntry(index)(a1,a2,a3,a4,a5,a6,a7,a8,a9)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_iiiiffifffffffi(index,a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14){var sp=stackSave();try{return getWasmTableEntry(index)(a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_iiiiifi(index,a1,a2,a3,a4,a5,a6){var sp=stackSave();try{return getWasmTableEntry(index)(a1,a2,a3,a4,a5,a6)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_iiiiiiii(index,a1,a2,a3,a4,a5,a6,a7){var sp=stackSave();try{return getWasmTableEntry(index)(a1,a2,a3,a4,a5,a6,a7)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_viiiiiii(index,a1,a2,a3,a4,a5,a6,a7){var sp=stackSave();try{getWasmTableEntry(index)(a1,a2,a3,a4,a5,a6,a7)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_jiii(index,a1,a2,a3){var sp=stackSave();try{return dynCall_jiii(index,a1,a2,a3)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_viiij(index,a1,a2,a3,a4,a5){var sp=stackSave();try{dynCall_viiij(index,a1,a2,a3,a4,a5)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}Module["ccall"]=ccall;Module["cwrap"]=cwrap;Module["PThread"]=PThread;var calledRun;var calledPrerun;dependenciesFulfilled=function runCaller(){if(!calledRun)run();if(!calledRun)dependenciesFulfilled=runCaller};function run(){if(runDependencies>0){return}if(ENVIRONMENT_IS_PTHREAD){readyPromiseResolve(Module);initRuntime();startWorker(Module);return}if(!calledPrerun){calledPrerun=1;preRun();if(runDependencies>0){return}}function doRun(){if(calledRun)return;calledRun=1;Module["calledRun"]=1;if(ABORT)return;initRuntime();readyPromiseResolve(Module);Module["onRuntimeInitialized"]?.();postRun()}if(Module["setStatus"]){Module["setStatus"]("Running...");setTimeout(()=>{setTimeout(()=>Module["setStatus"](""),1);doRun()},1)}else{doRun()}}if(Module["preInit"]){if(typeof Module["preInit"]=="function")Module["preInit"]=[Module["preInit"]];while(Module["preInit"].length>0){Module["preInit"].pop()()}}run();moduleRtn=readyPromise; + + + return moduleRtn; +} +); +})(); +export default Module; +var isPthread = globalThis.self?.name?.startsWith('em-pthread'); +// When running as a pthread, construct a new instance on startup +isPthread && Module(); diff --git a/web/app/public/vendor/blender/pthread/web_engine.wasm b/web/app/public/vendor/blender/pthread/web_engine.wasm new file mode 100644 index 00000000..ab66ed0d Binary files /dev/null and b/web/app/public/vendor/blender/pthread/web_engine.wasm differ diff --git a/web/app/public/vendor/blender/single/web_engine.js b/web/app/public/vendor/blender/single/web_engine.js new file mode 100644 index 00000000..dd482cba --- /dev/null +++ b/web/app/public/vendor/blender/single/web_engine.js @@ -0,0 +1,16 @@ + +var Module = (() => { + var _scriptName = import.meta.url; + + return ( +function(moduleArg = {}) { + var moduleRtn; + +var Module=moduleArg;var readyPromiseResolve,readyPromiseReject;var readyPromise=new Promise((resolve,reject)=>{readyPromiseResolve=resolve;readyPromiseReject=reject});var ENVIRONMENT_IS_WEB=typeof window=="object";var ENVIRONMENT_IS_WORKER=typeof importScripts=="function";var ENVIRONMENT_IS_NODE=typeof process=="object"&&typeof process.versions=="object"&&typeof process.versions.node=="string"&&process.type!="renderer";var moduleOverrides=Object.assign({},Module);var arguments_=[];var thisProgram="./this.program";var scriptDirectory="";function locateFile(path){if(Module["locateFile"]){return Module["locateFile"](path,scriptDirectory)}return scriptDirectory+path}var readAsync,readBinary;if(ENVIRONMENT_IS_WEB||ENVIRONMENT_IS_WORKER){if(ENVIRONMENT_IS_WORKER){scriptDirectory=self.location.href}else if(typeof document!="undefined"&&document.currentScript){scriptDirectory=document.currentScript.src}if(_scriptName){scriptDirectory=_scriptName}if(scriptDirectory.startsWith("blob:")){scriptDirectory=""}else{scriptDirectory=scriptDirectory.substr(0,scriptDirectory.replace(/[?#].*/,"").lastIndexOf("/")+1)}{if(ENVIRONMENT_IS_WORKER){readBinary=url=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,false);xhr.responseType="arraybuffer";xhr.send(null);return new Uint8Array(xhr.response)}}readAsync=url=>fetch(url,{credentials:"same-origin"}).then(response=>{if(response.ok){return response.arrayBuffer()}return Promise.reject(new Error(response.status+" : "+response.url))})}}else{}var out=Module["print"]||console.log.bind(console);var err=Module["printErr"]||console.error.bind(console);Object.assign(Module,moduleOverrides);moduleOverrides=null;if(Module["arguments"])arguments_=Module["arguments"];if(Module["thisProgram"])thisProgram=Module["thisProgram"];var wasmBinary=Module["wasmBinary"];var wasmMemory;var ABORT=false;var HEAP8,HEAPU8,HEAP16,HEAPU16,HEAP32,HEAPU32,HEAPF32,HEAPF64;function updateMemoryViews(){var b=wasmMemory.buffer;Module["HEAP8"]=HEAP8=new Int8Array(b);Module["HEAP16"]=HEAP16=new Int16Array(b);Module["HEAPU8"]=HEAPU8=new Uint8Array(b);Module["HEAPU16"]=HEAPU16=new Uint16Array(b);Module["HEAP32"]=HEAP32=new Int32Array(b);Module["HEAPU32"]=HEAPU32=new Uint32Array(b);Module["HEAPF32"]=HEAPF32=new Float32Array(b);Module["HEAPF64"]=HEAPF64=new Float64Array(b)}var __ATPRERUN__=[];var __ATINIT__=[];var __ATPOSTRUN__=[];var runtimeInitialized=false;function preRun(){var preRuns=Module["preRun"];if(preRuns){if(typeof preRuns=="function")preRuns=[preRuns];preRuns.forEach(addOnPreRun)}callRuntimeCallbacks(__ATPRERUN__)}function initRuntime(){runtimeInitialized=true;callRuntimeCallbacks(__ATINIT__)}function postRun(){var postRuns=Module["postRun"];if(postRuns){if(typeof postRuns=="function")postRuns=[postRuns];postRuns.forEach(addOnPostRun)}callRuntimeCallbacks(__ATPOSTRUN__)}function addOnPreRun(cb){__ATPRERUN__.unshift(cb)}function addOnInit(cb){__ATINIT__.unshift(cb)}function addOnPostRun(cb){__ATPOSTRUN__.unshift(cb)}var runDependencies=0;var runDependencyWatcher=null;var dependenciesFulfilled=null;function addRunDependency(id){runDependencies++;Module["monitorRunDependencies"]?.(runDependencies)}function removeRunDependency(id){runDependencies--;Module["monitorRunDependencies"]?.(runDependencies);if(runDependencies==0){if(runDependencyWatcher!==null){clearInterval(runDependencyWatcher);runDependencyWatcher=null}if(dependenciesFulfilled){var callback=dependenciesFulfilled;dependenciesFulfilled=null;callback()}}}function abort(what){Module["onAbort"]?.(what);what="Aborted("+what+")";err(what);ABORT=true;what+=". Build with -sASSERTIONS for more info.";var e=new WebAssembly.RuntimeError(what);readyPromiseReject(e);throw e}var dataURIPrefix="data:application/octet-stream;base64,";var isDataURI=filename=>filename.startsWith(dataURIPrefix);function findWasmBinary(){if(Module["locateFile"]){var f="web_engine.wasm";if(!isDataURI(f)){return locateFile(f)}return f}return new URL("web_engine.wasm",import.meta.url).href}var wasmBinaryFile;function getBinarySync(file){if(file==wasmBinaryFile&&wasmBinary){return new Uint8Array(wasmBinary)}if(readBinary){return readBinary(file)}throw"both async and sync fetching of the wasm failed"}function getBinaryPromise(binaryFile){if(!wasmBinary){return readAsync(binaryFile).then(response=>new Uint8Array(response),()=>getBinarySync(binaryFile))}return Promise.resolve().then(()=>getBinarySync(binaryFile))}function instantiateArrayBuffer(binaryFile,imports,receiver){return getBinaryPromise(binaryFile).then(binary=>WebAssembly.instantiate(binary,imports)).then(receiver,reason=>{err(`failed to asynchronously prepare wasm: ${reason}`);abort(reason)})}function instantiateAsync(binary,binaryFile,imports,callback){if(!binary&&typeof WebAssembly.instantiateStreaming=="function"&&!isDataURI(binaryFile)&&typeof fetch=="function"){return fetch(binaryFile,{credentials:"same-origin"}).then(response=>{var result=WebAssembly.instantiateStreaming(response,imports);return result.then(callback,function(reason){err(`wasm streaming compile failed: ${reason}`);err("falling back to ArrayBuffer instantiation");return instantiateArrayBuffer(binaryFile,imports,callback)})})}return instantiateArrayBuffer(binaryFile,imports,callback)}function getWasmImports(){return{a:wasmImports}}function createWasm(){var info=getWasmImports();function receiveInstance(instance,module){wasmExports=instance.exports;wasmMemory=wasmExports["I"];updateMemoryViews();wasmTable=wasmExports["Q"];addOnInit(wasmExports["J"]);removeRunDependency("wasm-instantiate");return wasmExports}addRunDependency("wasm-instantiate");function receiveInstantiationResult(result){receiveInstance(result["instance"])}if(Module["instantiateWasm"]){try{return Module["instantiateWasm"](info,receiveInstance)}catch(e){err(`Module.instantiateWasm callback failed with error: ${e}`);readyPromiseReject(e)}}wasmBinaryFile??=findWasmBinary();instantiateAsync(wasmBinary,wasmBinaryFile,info,receiveInstantiationResult).catch(readyPromiseReject);return{}}var callRuntimeCallbacks=callbacks=>{callbacks.forEach(f=>f(Module))};var noExitRuntime=Module["noExitRuntime"]||true;var stackRestore=val=>__emscripten_stack_restore(val);var stackSave=()=>_emscripten_stack_get_current();var exceptionCaught=[];var uncaughtExceptionCount=0;var ___cxa_begin_catch=ptr=>{var info=new ExceptionInfo(ptr);if(!info.get_caught()){info.set_caught(true);uncaughtExceptionCount--}info.set_rethrown(false);exceptionCaught.push(info);___cxa_increment_exception_refcount(ptr);return ___cxa_get_exception_ptr(ptr)};var exceptionLast=0;var ___cxa_end_catch=()=>{_setThrew(0,0);var info=exceptionCaught.pop();___cxa_decrement_exception_refcount(info.excPtr);exceptionLast=0};class ExceptionInfo{constructor(excPtr){this.excPtr=excPtr;this.ptr=excPtr-24}set_type(type){HEAPU32[this.ptr+4>>2]=type}get_type(){return HEAPU32[this.ptr+4>>2]}set_destructor(destructor){HEAPU32[this.ptr+8>>2]=destructor}get_destructor(){return HEAPU32[this.ptr+8>>2]}set_caught(caught){caught=caught?1:0;HEAP8[this.ptr+12]=caught}get_caught(){return HEAP8[this.ptr+12]!=0}set_rethrown(rethrown){rethrown=rethrown?1:0;HEAP8[this.ptr+13]=rethrown}get_rethrown(){return HEAP8[this.ptr+13]!=0}init(type,destructor){this.set_adjusted_ptr(0);this.set_type(type);this.set_destructor(destructor)}set_adjusted_ptr(adjustedPtr){HEAPU32[this.ptr+16>>2]=adjustedPtr}get_adjusted_ptr(){return HEAPU32[this.ptr+16>>2]}}var ___resumeException=ptr=>{if(!exceptionLast){exceptionLast=ptr}throw exceptionLast};var setTempRet0=val=>__emscripten_tempret_set(val);var findMatchingCatch=args=>{var thrown=exceptionLast;if(!thrown){setTempRet0(0);return 0}var info=new ExceptionInfo(thrown);info.set_adjusted_ptr(thrown);var thrownType=info.get_type();if(!thrownType){setTempRet0(0);return thrown}for(var caughtType of args){if(caughtType===0||caughtType===thrownType){break}var adjusted_ptr_addr=info.ptr+16;if(___cxa_can_catch(caughtType,thrownType,adjusted_ptr_addr)){setTempRet0(caughtType);return thrown}}setTempRet0(thrownType);return thrown};var ___cxa_find_matching_catch_2=()=>findMatchingCatch([]);var ___cxa_find_matching_catch_3=arg0=>findMatchingCatch([arg0]);var ___cxa_rethrow=()=>{var info=exceptionCaught.pop();if(!info){abort("no exception to throw")}var ptr=info.excPtr;if(!info.get_rethrown()){exceptionCaught.push(info);info.set_rethrown(true);info.set_caught(false);uncaughtExceptionCount++}exceptionLast=ptr;throw exceptionLast};var ___cxa_throw=(ptr,type,destructor)=>{var info=new ExceptionInfo(ptr);info.init(type,destructor);exceptionLast=ptr;uncaughtExceptionCount++;throw exceptionLast};var __abort_js=()=>{abort("")};var __emscripten_memcpy_js=(dest,src,num)=>HEAPU8.copyWithin(dest,src,src+num);var getHeapMax=()=>2147483648;var alignMemory=(size,alignment)=>Math.ceil(size/alignment)*alignment;var growMemory=size=>{var b=wasmMemory.buffer;var pages=(size-b.byteLength+65535)/65536|0;try{wasmMemory.grow(pages);updateMemoryViews();return 1}catch(e){}};var _emscripten_resize_heap=requestedSize=>{var oldSize=HEAPU8.length;requestedSize>>>=0;var maxHeapSize=getHeapMax();if(requestedSize>maxHeapSize){return false}for(var cutDown=1;cutDown<=4;cutDown*=2){var overGrownHeapSize=oldSize*(1+.2/cutDown);overGrownHeapSize=Math.min(overGrownHeapSize,requestedSize+100663296);var newSize=Math.min(maxHeapSize,alignMemory(Math.max(requestedSize,overGrownHeapSize),65536));var replacement=growMemory(newSize);if(replacement){return true}}return false};var _llvm_eh_typeid_for=type=>type;var wasmTableMirror=[];var wasmTable;var getWasmTableEntry=funcPtr=>{var func=wasmTableMirror[funcPtr];if(!func){if(funcPtr>=wasmTableMirror.length)wasmTableMirror.length=funcPtr+1;wasmTableMirror[funcPtr]=func=wasmTable.get(funcPtr)}return func};var getCFunc=ident=>{var func=Module["_"+ident];return func};var writeArrayToMemory=(array,buffer)=>{HEAP8.set(array,buffer)};var lengthBytesUTF8=str=>{var len=0;for(var i=0;i=55296&&c<=57343){len+=4;++i}else{len+=3}}return len};var stringToUTF8Array=(str,heap,outIdx,maxBytesToWrite)=>{if(!(maxBytesToWrite>0))return 0;var startIdx=outIdx;var endIdx=outIdx+maxBytesToWrite-1;for(var i=0;i=55296&&u<=57343){var u1=str.charCodeAt(++i);u=65536+((u&1023)<<10)|u1&1023}if(u<=127){if(outIdx>=endIdx)break;heap[outIdx++]=u}else if(u<=2047){if(outIdx+1>=endIdx)break;heap[outIdx++]=192|u>>6;heap[outIdx++]=128|u&63}else if(u<=65535){if(outIdx+2>=endIdx)break;heap[outIdx++]=224|u>>12;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63}else{if(outIdx+3>=endIdx)break;heap[outIdx++]=240|u>>18;heap[outIdx++]=128|u>>12&63;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63}}heap[outIdx]=0;return outIdx-startIdx};var stringToUTF8=(str,outPtr,maxBytesToWrite)=>stringToUTF8Array(str,HEAPU8,outPtr,maxBytesToWrite);var stackAlloc=sz=>__emscripten_stack_alloc(sz);var stringToUTF8OnStack=str=>{var size=lengthBytesUTF8(str)+1;var ret=stackAlloc(size);stringToUTF8(str,ret,size);return ret};var UTF8Decoder=typeof TextDecoder!="undefined"?new TextDecoder:undefined;var UTF8ArrayToString=(heapOrArray,idx=0,maxBytesToRead=NaN)=>{var endIdx=idx+maxBytesToRead;var endPtr=idx;while(heapOrArray[endPtr]&&!(endPtr>=endIdx))++endPtr;if(endPtr-idx>16&&heapOrArray.buffer&&UTF8Decoder){return UTF8Decoder.decode(heapOrArray.subarray(idx,endPtr))}var str="";while(idx>10,56320|ch&1023)}}return str};var UTF8ToString=(ptr,maxBytesToRead)=>ptr?UTF8ArrayToString(HEAPU8,ptr,maxBytesToRead):"";var ccall=(ident,returnType,argTypes,args,opts)=>{var toC={string:str=>{var ret=0;if(str!==null&&str!==undefined&&str!==0){ret=stringToUTF8OnStack(str)}return ret},array:arr=>{var ret=stackAlloc(arr.length);writeArrayToMemory(arr,ret);return ret}};function convertReturnValue(ret){if(returnType==="string"){return UTF8ToString(ret)}if(returnType==="boolean")return Boolean(ret);return ret}var func=getCFunc(ident);var cArgs=[];var stack=0;if(args){for(var i=0;i{var numericArgs=!argTypes||argTypes.every(type=>type==="number"||type==="boolean");var numericRet=returnType!=="string";if(numericRet&&numericArgs&&!opts){return getCFunc(ident)}return(...args)=>ccall(ident,returnType,argTypes,args,opts)};var wasmImports={r:___cxa_begin_catch,v:___cxa_end_catch,a:___cxa_find_matching_catch_2,b:___cxa_find_matching_catch_3,B:___cxa_rethrow,t:___cxa_throw,g:___resumeException,y:__abort_js,A:__emscripten_memcpy_js,z:_emscripten_resize_heap,p:invoke_fiii,i:invoke_ii,d:invoke_iii,f:invoke_iiii,F:invoke_iiiiffifffffffi,j:invoke_iiiii,E:invoke_iiiiifi,l:invoke_iiiiii,q:invoke_iiiiiii,G:invoke_iiiiiiifii,D:invoke_iiiiiiii,u:invoke_iiiiiiiii,H:invoke_iiiiiiiiii,x:invoke_jiii,o:invoke_v,m:invoke_vi,c:invoke_vii,h:invoke_viii,e:invoke_viiii,k:invoke_viiiii,n:invoke_viiiiii,C:invoke_viiiiiii,w:invoke_viiij,s:_llvm_eh_typeid_for};var wasmExports=createWasm();var ___wasm_call_ctors=()=>(___wasm_call_ctors=wasmExports["J"])();var _web_engine_create=Module["_web_engine_create"]=()=>(_web_engine_create=Module["_web_engine_create"]=wasmExports["K"])();var _web_engine_get_memory_stats=Module["_web_engine_get_memory_stats"]=a0=>(_web_engine_get_memory_stats=Module["_web_engine_get_memory_stats"]=wasmExports["L"])(a0);var _web_engine_destroy=Module["_web_engine_destroy"]=a0=>(_web_engine_destroy=Module["_web_engine_destroy"]=wasmExports["M"])(a0);var _web_engine_get_live_handles=Module["_web_engine_get_live_handles"]=()=>(_web_engine_get_live_handles=Module["_web_engine_get_live_handles"]=wasmExports["N"])();var _web_engine_get_allocated_bytes=Module["_web_engine_get_allocated_bytes"]=()=>(_web_engine_get_allocated_bytes=Module["_web_engine_get_allocated_bytes"]=wasmExports["O"])();var _web_engine_open_blend=Module["_web_engine_open_blend"]=(a0,a1,a2)=>(_web_engine_open_blend=Module["_web_engine_open_blend"]=wasmExports["P"])(a0,a1,a2);var _web_engine_apply_command=Module["_web_engine_apply_command"]=(a0,a1,a2)=>(_web_engine_apply_command=Module["_web_engine_apply_command"]=wasmExports["R"])(a0,a1,a2);var _web_engine_undo=Module["_web_engine_undo"]=a0=>(_web_engine_undo=Module["_web_engine_undo"]=wasmExports["S"])(a0);var _web_engine_redo=Module["_web_engine_redo"]=a0=>(_web_engine_redo=Module["_web_engine_redo"]=wasmExports["T"])(a0);var _web_engine_get_scene_snapshot=Module["_web_engine_get_scene_snapshot"]=(a0,a1,a2)=>(_web_engine_get_scene_snapshot=Module["_web_engine_get_scene_snapshot"]=wasmExports["U"])(a0,a1,a2);var _web_engine_get_scene_metadata=Module["_web_engine_get_scene_metadata"]=(a0,a1,a2)=>(_web_engine_get_scene_metadata=Module["_web_engine_get_scene_metadata"]=wasmExports["V"])(a0,a1,a2);var _web_engine_get_scene_geometry=Module["_web_engine_get_scene_geometry"]=(a0,a1,a2)=>(_web_engine_get_scene_geometry=Module["_web_engine_get_scene_geometry"]=wasmExports["W"])(a0,a1,a2);var _web_engine_get_scene_delta=Module["_web_engine_get_scene_delta"]=(a0,a1,a2)=>(_web_engine_get_scene_delta=Module["_web_engine_get_scene_delta"]=wasmExports["X"])(a0,a1,a2);var _web_engine_get_packed_asset=Module["_web_engine_get_packed_asset"]=(a0,a1,a2,a3,a4)=>(_web_engine_get_packed_asset=Module["_web_engine_get_packed_asset"]=wasmExports["Y"])(a0,a1,a2,a3,a4);var _web_engine_evaluate_depsgraph=Module["_web_engine_evaluate_depsgraph"]=(a0,a1,a2)=>(_web_engine_evaluate_depsgraph=Module["_web_engine_evaluate_depsgraph"]=wasmExports["Z"])(a0,a1,a2);var _web_engine_save_blend=Module["_web_engine_save_blend"]=(a0,a1,a2)=>(_web_engine_save_blend=Module["_web_engine_save_blend"]=wasmExports["_"])(a0,a1,a2);var _malloc=Module["_malloc"]=a0=>(_malloc=Module["_malloc"]=wasmExports["$"])(a0);var _web_engine_free_buffer=Module["_web_engine_free_buffer"]=a0=>(_web_engine_free_buffer=Module["_web_engine_free_buffer"]=wasmExports["aa"])(a0);var _free=Module["_free"]=a0=>(_free=Module["_free"]=wasmExports["ba"])(a0);var _web_engine_last_error_code=Module["_web_engine_last_error_code"]=()=>(_web_engine_last_error_code=Module["_web_engine_last_error_code"]=wasmExports["ca"])();var _web_engine_last_error_message=Module["_web_engine_last_error_message"]=()=>(_web_engine_last_error_message=Module["_web_engine_last_error_message"]=wasmExports["da"])();var _setThrew=(a0,a1)=>(_setThrew=wasmExports["ea"])(a0,a1);var __emscripten_tempret_set=a0=>(__emscripten_tempret_set=wasmExports["fa"])(a0);var __emscripten_stack_restore=a0=>(__emscripten_stack_restore=wasmExports["ga"])(a0);var __emscripten_stack_alloc=a0=>(__emscripten_stack_alloc=wasmExports["ha"])(a0);var _emscripten_stack_get_current=()=>(_emscripten_stack_get_current=wasmExports["ia"])();var ___cxa_increment_exception_refcount=a0=>(___cxa_increment_exception_refcount=wasmExports["ja"])(a0);var ___cxa_decrement_exception_refcount=a0=>(___cxa_decrement_exception_refcount=wasmExports["ka"])(a0);var ___cxa_can_catch=(a0,a1,a2)=>(___cxa_can_catch=wasmExports["la"])(a0,a1,a2);var ___cxa_get_exception_ptr=a0=>(___cxa_get_exception_ptr=wasmExports["ma"])(a0);var dynCall_jiii=Module["dynCall_jiii"]=(a0,a1,a2,a3)=>(dynCall_jiii=Module["dynCall_jiii"]=wasmExports["na"])(a0,a1,a2,a3);var dynCall_viiij=Module["dynCall_viiij"]=(a0,a1,a2,a3,a4,a5)=>(dynCall_viiij=Module["dynCall_viiij"]=wasmExports["oa"])(a0,a1,a2,a3,a4,a5);function invoke_ii(index,a1){var sp=stackSave();try{return getWasmTableEntry(index)(a1)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_v(index){var sp=stackSave();try{getWasmTableEntry(index)()}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_iii(index,a1,a2){var sp=stackSave();try{return getWasmTableEntry(index)(a1,a2)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_iiii(index,a1,a2,a3){var sp=stackSave();try{return getWasmTableEntry(index)(a1,a2,a3)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_viiiii(index,a1,a2,a3,a4,a5){var sp=stackSave();try{getWasmTableEntry(index)(a1,a2,a3,a4,a5)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_vii(index,a1,a2){var sp=stackSave();try{getWasmTableEntry(index)(a1,a2)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_vi(index,a1){var sp=stackSave();try{getWasmTableEntry(index)(a1)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_viii(index,a1,a2,a3){var sp=stackSave();try{getWasmTableEntry(index)(a1,a2,a3)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_viiiiii(index,a1,a2,a3,a4,a5,a6){var sp=stackSave();try{getWasmTableEntry(index)(a1,a2,a3,a4,a5,a6)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_iiiiii(index,a1,a2,a3,a4,a5){var sp=stackSave();try{return getWasmTableEntry(index)(a1,a2,a3,a4,a5)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_iiiii(index,a1,a2,a3,a4){var sp=stackSave();try{return getWasmTableEntry(index)(a1,a2,a3,a4)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_viiii(index,a1,a2,a3,a4){var sp=stackSave();try{getWasmTableEntry(index)(a1,a2,a3,a4)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_iiiiiiiii(index,a1,a2,a3,a4,a5,a6,a7,a8){var sp=stackSave();try{return getWasmTableEntry(index)(a1,a2,a3,a4,a5,a6,a7,a8)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_iiiiiii(index,a1,a2,a3,a4,a5,a6){var sp=stackSave();try{return getWasmTableEntry(index)(a1,a2,a3,a4,a5,a6)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_iiiiiiiiii(index,a1,a2,a3,a4,a5,a6,a7,a8,a9){var sp=stackSave();try{return getWasmTableEntry(index)(a1,a2,a3,a4,a5,a6,a7,a8,a9)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_fiii(index,a1,a2,a3){var sp=stackSave();try{return getWasmTableEntry(index)(a1,a2,a3)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_iiiiiiifii(index,a1,a2,a3,a4,a5,a6,a7,a8,a9){var sp=stackSave();try{return getWasmTableEntry(index)(a1,a2,a3,a4,a5,a6,a7,a8,a9)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_iiiiffifffffffi(index,a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14){var sp=stackSave();try{return getWasmTableEntry(index)(a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_iiiiifi(index,a1,a2,a3,a4,a5,a6){var sp=stackSave();try{return getWasmTableEntry(index)(a1,a2,a3,a4,a5,a6)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_iiiiiiii(index,a1,a2,a3,a4,a5,a6,a7){var sp=stackSave();try{return getWasmTableEntry(index)(a1,a2,a3,a4,a5,a6,a7)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_viiiiiii(index,a1,a2,a3,a4,a5,a6,a7){var sp=stackSave();try{getWasmTableEntry(index)(a1,a2,a3,a4,a5,a6,a7)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_jiii(index,a1,a2,a3){var sp=stackSave();try{return dynCall_jiii(index,a1,a2,a3)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}function invoke_viiij(index,a1,a2,a3,a4,a5){var sp=stackSave();try{dynCall_viiij(index,a1,a2,a3,a4,a5)}catch(e){stackRestore(sp);if(e!==e+0)throw e;_setThrew(1,0)}}Module["ccall"]=ccall;Module["cwrap"]=cwrap;var calledRun;var calledPrerun;dependenciesFulfilled=function runCaller(){if(!calledRun)run();if(!calledRun)dependenciesFulfilled=runCaller};function run(){if(runDependencies>0){return}if(!calledPrerun){calledPrerun=1;preRun();if(runDependencies>0){return}}function doRun(){if(calledRun)return;calledRun=1;Module["calledRun"]=1;if(ABORT)return;initRuntime();readyPromiseResolve(Module);Module["onRuntimeInitialized"]?.();postRun()}if(Module["setStatus"]){Module["setStatus"]("Running...");setTimeout(()=>{setTimeout(()=>Module["setStatus"](""),1);doRun()},1)}else{doRun()}}if(Module["preInit"]){if(typeof Module["preInit"]=="function")Module["preInit"]=[Module["preInit"]];while(Module["preInit"].length>0){Module["preInit"].pop()()}}run();moduleRtn=readyPromise; + + + return moduleRtn; +} +); +})(); +export default Module; diff --git a/web/app/public/vendor/blender/single/web_engine.wasm b/web/app/public/vendor/blender/single/web_engine.wasm new file mode 100644 index 00000000..3cf74860 Binary files /dev/null and b/web/app/public/vendor/blender/single/web_engine.wasm differ diff --git a/web/app/src/app/App.tsx b/web/app/src/app/App.tsx index 9106a4c3..13e4353c 100644 --- a/web/app/src/app/App.tsx +++ b/web/app/src/app/App.tsx @@ -1,4 +1,5 @@ -import { useEffect, useMemo, useRef, useState } from "react"; +import { useEffect, useMemo, useReducer, useRef, useState } from "react"; +import { flushSync } from "react-dom"; import { WebEngineClient } from "../engine-client/WebEngineClient"; import { loadWebEngineManifest, verifyWasmResource } from "../../../protocol/manifest"; import type { ProgressEvent } from "../../../protocol/progress"; @@ -32,6 +33,11 @@ import { } from "../volume/nanovdb-viewport"; import { composePaintColorPatch, composePaintWeightPatch } from "../../../protocol/paint"; import { createDefaultWebWorkspaceState, reduceUICommand, type EditorType, type UICommand, type WorkspaceId } from "../../../protocol/ui-schema"; +import { createInitialUserActionStates, reduceUserActionStates, type UserActionIdentity, type UserActionKind } from "../../../protocol/user-action-state"; +import { acquireProjectAction, createProjectActionMutexState, releaseProjectAction, type ProjectActionConflict, type ProjectActionIdentity } from "../../../protocol/project-action-mutex"; +import { DEFAULT_FILE_READ_YIELD_BYTES, FileByteReadError, readFileBytes, type FileReadPhase } from "../../../protocol/file-byte-reader"; +import { advanceSaveTransaction, beginSaveTransaction, commitSaveTransaction, createSaveTransactionState, failSaveTransaction, type SaveTransactionState } from "../../../protocol/save-transaction"; +import { acceptHistoryTransaction, acceptMainSave, acceptMainTransaction, createDirtyState, recoverDirtyState } from "../../../protocol/dirty-state"; import "./app-shell.css"; function errorMessage(error: unknown): string { @@ -48,6 +54,26 @@ async function sha256Hex(data: ArrayBuffer): Promise { return Array.from(new Uint8Array(digest), (value) => value.toString(16).padStart(2, "0")).join(""); } +const LAST_PROJECT_STORAGE_KEY = "blender-web:last-project-id"; + +function loadLastProjectId(): string { + try { + return localStorage.getItem(LAST_PROJECT_STORAGE_KEY) || "untitled"; + } + catch { + return "untitled"; + } +} + +function rememberLastProjectId(projectId: string): void { + try { + localStorage.setItem(LAST_PROJECT_STORAGE_KEY, projectId); + } + catch { + // Project recovery still works in the current session when localStorage is unavailable. + } +} + interface AreaProps { className?: string; editor: EditorType; @@ -366,7 +392,7 @@ function Outliner({ snapshot, onSelect, onToggleVisibility }: { {collection.objectIds.map((objectId) => { const node = nodeById.get(objectId); if (!node) return null; - return
onSelect(node.id, event.shiftKey || event.ctrlKey || event.metaKey)} onKeyDown={(event) => { if (event.key === "Enter" || event.key === " ") onSelect(node.id, event.shiftKey || event.ctrlKey || event.metaKey); }} className={`tree-row child${node.id === snapshot?.activeObjectId ? " selected" : ""}`}>·△{node.name}
; + return
onSelect(node.id, event.shiftKey || event.ctrlKey || event.metaKey)} onKeyDown={(event) => { if (event.key === "Enter" || event.key === " ") onSelect(node.id, event.shiftKey || event.ctrlKey || event.metaKey); }} className={`tree-row child${node.id === snapshot?.activeObjectId ? " selected" : ""}`}>·△{node.name}
; })} ))} @@ -645,7 +671,7 @@ function Timeline({ snapshot, frame, start, end, onFrameChange, onCommand }: { s export function App() { const [uiState, setUIState] = useState(createDefaultWebWorkspaceState); const [frame, setFrame] = useState(1); - const [saved, setSaved] = useState(true); + const [dirtyState, setDirtyState] = useState(() => createDirtyState()); const [engineStatus, setEngineStatus] = useState("WASM: starting"); const [wasmStatus, setWasmStatus] = useState("WASM ABI: starting"); const [storageStatus, setStorageStatus] = useState("Storage: starting"); @@ -660,15 +686,65 @@ export function App() { const [preview, setPreview] = useState<{ snapshot: SceneSnapshotIR; geometryBuffers: MeshGeometryBuffer[]; nonMeshGeometryBuffers: NonMeshGeometryChunk[] } | null>(null); const [lodLevels, setLodLevels] = useState | null>(null); const [openProgress, setOpenProgress] = useState(null); + const [openReadEvidence, setOpenReadEvidence] = useState<{ actionId: string | null; phase: FileReadPhase | "IDLE"; bytesRead: number; totalBytes: number; progressEvents: number }>({ actionId: null, phase: "IDLE", bytesRead: 0, totalBytes: 0, progressEvents: 0 }); + const [openCleanupEvidence, setOpenCleanupEvidence] = useState({ readerLiveReaders: 0, readerInputBytes: 0, readerStagingFiles: 0, engineActiveRequests: 0, engineInputBytes: 0, engineNativeHandles: 0, engineStagingFiles: 0, lastStage: "IDLE" }); + const [saveTransaction, setSaveTransaction] = useState(() => createSaveTransactionState({ revision: 0, sha256: null })); + const [userActions, dispatchUserAction] = useReducer(reduceUserActionStates, createInitialUserActionStates()); + const [projectActionConflict, setProjectActionConflict] = useState(null); const webClientRef = useRef(null); const storageClientRef = useRef(null); const autosaveRef = useRef(null); const commandCountRef = useRef(0); - const projectIdRef = useRef("untitled"); + const projectIdRef = useRef(loadLastProjectId()); + const projectRevisionRef = useRef(0); + const committedProjectRevisionRef = useRef(0); + const committedProjectHashRef = useRef(null); + const userActionSequenceRef = useRef(0); + const projectActionMutexRef = useRef(createProjectActionMutexState()); + const openAbortControllerRef = useRef(null); const fileInputRef = useRef(null); const workspace = uiState.context.workspaceId; + const saved = !dirtyState.dirty; const workspaceLabel = useMemo(() => `${workspace} Workspace`, [workspace]); const dispatchUI = (command: UICommand) => setUIState((state) => reduceUICommand(state, command)); + const nextUserActionIdentity = (kind: Kind): UserActionIdentity & { kind: Kind } => ( + { kind, actionId: `${kind}:${++userActionSequenceRef.current}` } + ); + const startUserAction = (identity: UserActionIdentity): void => { + dispatchUserAction({ type: "START", identity }); + }; + const beginUserAction = (kind: UserActionKind): UserActionIdentity => { + const identity = nextUserActionIdentity(kind); + startUserAction(identity); + return identity; + }; + const succeedUserAction = (identity: UserActionIdentity): void => { + dispatchUserAction({ type: "SUCCEED", identity }); + }; + const failUserAction = (identity: UserActionIdentity, errorCode: string): void => { + dispatchUserAction({ type: "FAIL", identity, errorCode }); + }; + const cancelUserAction = (identity: UserActionIdentity, errorCode: string): void => { + dispatchUserAction({ type: "CANCEL", identity, errorCode }); + }; + const acquireProjectActionLock = (identity: ProjectActionIdentity, reportConflict = true): boolean => { + const result = acquireProjectAction(projectActionMutexRef.current, identity); + if (!result.granted) { + if (reportConflict) { + setProjectActionConflict(result.conflict); + setEngineStatus(`Action: blocked (${result.conflict.code}: ${result.conflict.reason})`); + } + return false; + } + projectActionMutexRef.current = result.state; + setProjectActionConflict(null); + return true; + }; + const releaseProjectActionLock = (identity: ProjectActionIdentity): void => { + const result = releaseProjectAction(projectActionMutexRef.current, identity); + if (result.released) projectActionMutexRef.current = result.state; + else setEngineStatus(`Action: lock failure (${result.errorCode})`); + }; const selectObject = (id: string, additive = false): void => { setSelectedObjectIds((current) => { if (!additive) return new Set([id]); @@ -767,11 +843,11 @@ export function App() { // Cache invalidation is best effort and never blocks an engine command. } }; - const applyEditCommand = async (command: WebEngineEditCommand): Promise => { + const applyEditCommand = async (command: WebEngineEditCommand): Promise => { const client = webClientRef.current; if (!client || !snapshot) { if (command.type === "setFrame") setFrame(command.frame); - return; + return false; } try { if (command.type === "previewDecimateMesh") { @@ -781,9 +857,11 @@ export function App() { setEngineStatus(result.simplify ? `Engine: Preview ${result.simplify.originalTriangleCount} -> ${result.simplify.outputTriangleCount} triangles` : "Engine: Preview ready"); - return; + return true; } const result = await client.applyCommand(command); + const logicalRevision = Math.max(projectRevisionRef.current + 1, result.snapshot.revision); + projectRevisionRef.current = logicalRevision; setPreview(null); setLodLevels(null); setSnapshot(result.snapshot); @@ -794,7 +872,26 @@ export function App() { if (command.type === "meshEdit" || command.type === "separateMeshFaces" || command.type === "joinObjects") { setMeshSelection((current) => ({ ...current, meshId: null, indices: new Set() })); } - setSaved(false); + if (command.type === "undo" || command.type === "redo") { + let matchesCommittedContent = false; + try { + const historyBlend = await client.saveBlend(); + matchesCommittedContent = await sha256Hex(historyBlend) === committedProjectHashRef.current; + } + catch { + // A history serialization failure is conservative: the project remains dirty. + } + setDirtyState((current) => { + const accepted = acceptHistoryTransaction(current, logicalRevision, matchesCommittedContent); + return accepted.ok ? accepted.state : current; + }); + } + else { + setDirtyState((current) => { + const accepted = acceptMainTransaction(current, logicalRevision); + return accepted.ok ? accepted.state : current; + }); + } void invalidateCachedLODs(projectIdRef.current, result.snapshot.revision); setEngineStatus(result.simplify ? `Engine: Decimate ${result.simplify.originalTriangleCount} -> ${result.simplify.outputTriangleCount} triangles (r${result.snapshot.revision})` @@ -803,12 +900,12 @@ export function App() { const storage = storageClientRef.current; if (storage) { try { - const operationId = `op-${result.snapshot.revision}-${crypto.randomUUID()}`; - await storage.appendOperation(operationId, projectIdRef.current, result.snapshot.revision, command); + const operationId = `op-${logicalRevision}-${crypto.randomUUID()}`; + await storage.appendOperation(operationId, projectIdRef.current, logicalRevision, command); commandCountRef.current += 1; if (commandCountRef.current % 10 === 0) { const blend = await client.saveBlend(); - await storage.saveSnapshot(projectIdRef.current, result.snapshot.revision, blend.slice(0)); + await storage.saveSnapshot(projectIdRef.current, logicalRevision, blend.slice(0)); } } catch (error) { @@ -816,8 +913,10 @@ export function App() { } } } + return true; } catch (error) { setEngineStatus(`Engine: command failed (${errorMessage(error)})`); + return false; } }; @@ -858,18 +957,30 @@ export function App() { ...(["BEVEL", "LOOP_CUT"].includes(operation) ? { segments: operation === "BEVEL" ? 2 : 1 } : {}) }); }; const importImage = async (file: File): Promise => { + const identity = beginUserAction("IMPORT"); + let failureCode = "IMPORT_DECODE_FAILED"; + let bitmap: ImageBitmap | null = null; try { - const bitmap = await createImageBitmap(file); + bitmap = await createImageBitmap(file); const bytes = new Uint8Array(await file.arrayBuffer()); let binary = ""; for (let offset = 0; offset < bytes.length; offset += 0x8000) binary += String.fromCharCode(...bytes.subarray(offset, offset + 0x8000)); - void applyEditCommand({ type: "importImage", name: file.name.replace(/\.[^.]+$/, "") || "Image", + failureCode = "IMPORT_MAIN_TRANSACTION_FAILED"; + const applied = await applyEditCommand({ type: "importImage", name: file.name.replace(/\.[^.]+$/, "") || "Image", mimeType: file.type === "image/jpeg" ? "image/jpeg" : "image/png", width: bitmap.width, height: bitmap.height, base64: btoa(binary) }); - bitmap.close(); + if (!applied) { + failUserAction(identity, failureCode); + return; + } + succeedUserAction(identity); } catch (error) { + failUserAction(identity, failureCode); setEngineStatus(`Image import failed${error instanceof Error ? ` (${error.message})` : ""}`); } + finally { + bitmap?.close(); + } }; const transformActive = (tool: "translate" | "rotate" | "scale", amount = 0.1, axis: 0 | 1 | 2 = tool === "rotate" ? 2 : 0, axisVector?: [number, number, number]): void => { const activeNode = snapshot?.nodes.find((node) => node.id === snapshot.activeObjectId); @@ -1085,7 +1196,9 @@ export function App() { let mounted = true; void loadWebEngineManifest() .then(async (manifest) => { - const requiredResource = manifest.wasm.find((resource) => resource.required); + const requiredResource = "variants" in manifest + ? manifest.variants.find((variant) => variant.id === "single")?.resources.wasm + : manifest.wasm.find((resource) => resource.required); if (requiredResource) await verifyWasmResource(requiredResource); if (mounted) setManifestStatus(`Manifest: verified r${manifest.protocolVersion}`); }) @@ -1171,15 +1284,66 @@ export function App() { }; const openBlendFile = async (file: File): Promise => { + const identity = nextUserActionIdentity("OPEN"); + if (!acquireProjectActionLock(identity)) return; + startUserAction(identity); + const controller = new AbortController(); + openAbortControllerRef.current = controller; const client = webClientRef.current; - if (!client) return; - setOpenProgress({ requestId: "ui", operation: "blend.open", phase: "started", fraction: 0, message: `打开 ${file.name}` }); + let failureCode = "OPEN_FILE_READ_FAILED"; try { - const input = await file.arrayBuffer(); + if (!client) { + failUserAction(identity, "OPEN_ENGINE_UNAVAILABLE"); + return; + } + const input = await readFileBytes(file, { + signal: controller.signal, + yieldControl: () => new Promise((resolve) => requestAnimationFrame(() => resolve())), + onResourceState: (state) => setOpenCleanupEvidence((current) => ({ + ...current, + readerLiveReaders: state.liveReaders, + readerInputBytes: state.liveInputBytes, + readerStagingFiles: state.liveStagingFiles, + })), + onProgress: (item) => { + const update = (): void => { + setOpenReadEvidence((current) => ({ + actionId: identity.actionId, + phase: item.phase, + bytesRead: item.bytesRead, + totalBytes: item.totalBytes, + progressEvents: current.actionId === identity.actionId ? current.progressEvents + 1 : 1, + })); + setOpenProgress({ + requestId: identity.actionId, + operation: "blend.open.read", + phase: item.phase === "STARTED" ? "started" : item.phase === "COMPLETED" ? "completed" : item.phase === "CANCELLED" ? "cancelled" : "progress", + fraction: item.fraction, + bytesRead: item.bytesRead, + totalBytes: item.totalBytes, + message: `读取 ${file.name} ${item.bytesRead}/${item.totalBytes} B`, + }); + }; + if (item.phase !== "READING" || item.bytesRead % DEFAULT_FILE_READ_YIELD_BYTES === 0) flushSync(update); + else update(); + }, + }); + if (controller.signal.aborted) throw new FileByteReadError("FILE_READ_CANCELLED", "cancelled before engine open"); + const inputSha256 = await sha256Hex(input); const projectId = file.name.replace(/\.blend$/i, "").replace(/[^A-Za-z0-9_-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64) || "untitled"; projectIdRef.current = projectId; - const result = await client.openBlend(input, setOpenProgress); - setVolumeProject({ projectId, sourceBlendSha256: await sha256Hex(input) }); + rememberLastProjectId(projectId); + failureCode = "OPEN_ENGINE_FAILED"; + const result = await client.openBlend(input, (progress) => { + setOpenCleanupEvidence((current) => ({ ...current, lastStage: progress.stage ?? current.lastStage })); + setOpenProgress({ ...progress, requestId: identity.actionId }); + }, controller.signal); + projectRevisionRef.current = result.snapshot.revision; + committedProjectRevisionRef.current = 0; + committedProjectHashRef.current = inputSha256; + setSaveTransaction(createSaveTransactionState({ revision: 0, sha256: inputSha256 })); + setDirtyState(createDirtyState(result.snapshot.revision)); + setVolumeProject({ projectId, sourceBlendSha256: inputSha256 }); setPreview(null); setLodLevels(null); setGPUTextureAssets([]); @@ -1188,32 +1352,104 @@ export function App() { setGeometryBuffers(result.geometryBuffers); setNonMeshGeometryBuffers(result.nonMeshGeometryBuffers ?? []); setFrame(result.snapshot.frame.current); - setSaved(true); setEngineStatus(`Engine: SceneIR r${result.snapshot.revision} (${result.snapshot.nodes.length} objects)`); void cachePackedAssets(projectId, result.snapshot).then((assets) => { if (projectIdRef.current === projectId) setGPUTextureAssets(assets); }); void restoreCachedLODs(projectId, result.snapshot); + succeedUserAction(identity); } catch (error) { - setEngineStatus(`Engine: .blend read failed${error instanceof Error ? ` (${error.message})` : ""}`); + if (controller.signal.aborted || (error instanceof FileByteReadError && error.code === "FILE_READ_CANCELLED")) { + cancelUserAction(identity, "OPEN_CANCELLED"); + if (client) { + try { + const resources = await client.openResourceStatus(); + setOpenCleanupEvidence((current) => ({ + ...current, + engineActiveRequests: resources.activeRequests, + engineInputBytes: resources.liveInputBytes, + engineNativeHandles: resources.liveNativeHandles, + engineStagingFiles: resources.liveStagingFiles, + })); + } + catch { + // The visible cancellation remains valid; Worker recovery is handled separately. + } + } + setEngineStatus("Engine: .blend open cancelled"); + } + else { + failUserAction(identity, error instanceof FileByteReadError ? error.code : failureCode); + setEngineStatus(`Engine: .blend read failed${error instanceof Error ? ` (${error.message})` : ""}`); + } } finally { setOpenProgress(null); + if (openAbortControllerRef.current === controller) openAbortControllerRef.current = null; + releaseProjectActionLock(identity); } }; + const cancelOpenFileRead = (): void => { + openAbortControllerRef.current?.abort(); + }; const persistProject = async (): Promise => { const client = webClientRef.current; if (!client || !snapshot) return null; - const data = await client.saveBlend(); - const storage = storageClientRef.current; - if (storage) { - await storage.saveProject(projectIdRef.current, snapshot.revision, data.slice(0)); - await storage.saveSnapshot(projectIdRef.current, snapshot.revision, data.slice(0)); - await storage.pruneOperations(projectIdRef.current, snapshot.revision); + const revision = Math.max(projectRevisionRef.current, committedProjectRevisionRef.current, snapshot.revision); + const started = beginSaveTransaction(createSaveTransactionState({ + revision: committedProjectRevisionRef.current, + sha256: committedProjectHashRef.current, + }), revision); + if (!started.ok) throw new Error(started.errorCode); + let transaction = started.state; + setSaveTransaction(transaction); + try { + const data = await client.saveBlend(); + const sha256 = await sha256Hex(data); + const staged = advanceSaveTransaction(transaction, "OPFS_STAGE", sha256); + if (!staged.ok) throw new Error(staged.errorCode); + transaction = staged.state; + setSaveTransaction(transaction); + + const storage = storageClientRef.current; + let persisted = { revision, sha256 }; + if (storage) { + const result = await storage.saveProject(projectIdRef.current, revision, data.slice(0)); + persisted = { revision: result.revision, sha256: result.sha256 }; + } + const sceneCommitted = advanceSaveTransaction(transaction, "SCENE_COMMIT"); + if (!sceneCommitted.ok) throw new Error(sceneCommitted.errorCode); + transaction = sceneCommitted.state; + const metadataCommitted = advanceSaveTransaction(transaction, "METADATA_COMMIT"); + if (!metadataCommitted.ok) throw new Error(metadataCommitted.errorCode); + transaction = metadataCommitted.state; + const committed = commitSaveTransaction(transaction, persisted); + if (!committed.ok) throw new Error(committed.errorCode); + transaction = committed.state; + setSaveTransaction(transaction); + committedProjectRevisionRef.current = persisted.revision; + committedProjectHashRef.current = persisted.sha256; + setVolumeProject({ projectId: projectIdRef.current, sourceBlendSha256: persisted.sha256 }); + setDirtyState((current) => { + const accepted = acceptMainSave(current, persisted.revision); + return accepted.ok ? accepted.state : current; + }); + + if (storage) { + try { + await storage.saveSnapshot(projectIdRef.current, revision, data.slice(0)); + await storage.pruneOperations(projectIdRef.current, revision); + } + catch (error) { + setStorageStatus(`Storage: post-commit maintenance failed${error instanceof Error ? ` (${error.message})` : ""}`); + } + } + return data; + } + catch (error) { + setSaveTransaction(failSaveTransaction(transaction, transaction.stage === "SERIALIZE" ? "SAVE_SERIALIZE_INTERRUPTED" : "SAVE_STORAGE_INTERRUPTED")); + throw error; } - setVolumeProject({ projectId: projectIdRef.current, sourceBlendSha256: await sha256Hex(data) }); - setSaved(true); - return data; }; const recoverCachedProject = async (): Promise => { @@ -1222,6 +1458,7 @@ export function App() { if (!client || !storage) return; try { const projectId = projectIdRef.current; + rememberLastProjectId(projectId); let baseRevision = 0; let buffer: ArrayBuffer; try { @@ -1237,8 +1474,9 @@ export function App() { baseRevision = saved.revision; buffer = saved.buffer; } + const baseSha256 = await sha256Hex(buffer); let opened = await client.openBlend(buffer); - setVolumeProject({ projectId, sourceBlendSha256: await sha256Hex(buffer) }); + setVolumeProject({ projectId, sourceBlendSha256: baseSha256 }); const replay = await storage.listOperations(projectId, baseRevision); for (const operation of replay.operations) { const payload = operation.payload as WebEngineEditCommand; @@ -1247,6 +1485,14 @@ export function App() { } opened = await client.applyCommand(payload); } + committedProjectRevisionRef.current = baseRevision; + committedProjectHashRef.current = baseSha256; + setSaveTransaction(createSaveTransactionState({ revision: baseRevision, sha256: baseSha256 })); + projectRevisionRef.current = replay.operations.reduce( + (revision, operation) => Math.max(revision + 1, operation.revision), + baseRevision, + ); + setDirtyState(recoverDirtyState(projectRevisionRef.current, baseRevision)); setPreview(null); setLodLevels(null); setGPUTextureAssets([]); @@ -1255,7 +1501,6 @@ export function App() { setNonMeshGeometryBuffers(opened.nonMeshGeometryBuffers ?? []); setFrame(opened.snapshot.frame.current); setSelectedObjectIds(new Set(opened.snapshot.activeObjectId ? [opened.snapshot.activeObjectId] : [])); - setSaved(replay.operations.length === 0); setEngineStatus(`Recovery: ${replay.operations.length} operation(s), ${replay.quarantined} quarantined`); void cachePackedAssets(projectId, opened.snapshot).then((assets) => { if (projectIdRef.current === projectId) setGPUTextureAssets(assets); @@ -1267,48 +1512,115 @@ export function App() { }; const saveBlend = async (): Promise => { + const saveIdentity = nextUserActionIdentity("SAVE"); + if (!acquireProjectActionLock(saveIdentity)) return; + startUserAction(saveIdentity); + let data: ArrayBuffer | null = null; + try { + const persisted = await persistProject(); + if (!persisted) { + failUserAction(saveIdentity, "SAVE_PROJECT_UNAVAILABLE"); + } + else { + data = persisted; + succeedUserAction(saveIdentity); + } + } catch (error) { + failUserAction(saveIdentity, "SAVE_FAILED"); + setEngineStatus(`Engine: .blend save failed${error instanceof Error ? ` (${error.message})` : ""}`); + } + finally { + releaseProjectActionLock(saveIdentity); + } + if (!data) return; + + const saveAsIdentity = beginUserAction("SAVE_AS"); try { - const data = await persistProject(); - if (!data) return; const url = URL.createObjectURL(new Blob([data], { type: "application/octet-stream" })); const anchor = document.createElement("a"); anchor.href = url; anchor.download = "blender-web.blend"; anchor.click(); URL.revokeObjectURL(url); + succeedUserAction(saveAsIdentity); } catch (error) { - setEngineStatus(`Engine: .blend save failed${error instanceof Error ? ` (${error.message})` : ""}`); + failUserAction(saveAsIdentity, "SAVE_AS_DOWNLOAD_FAILED"); + setEngineStatus(`Engine: .blend download failed${error instanceof Error ? ` (${error.message})` : ""}`); + } + }; + const closeProject = (): void => { + if (!snapshot) return; + const identity: ProjectActionIdentity = { kind: "CLOSE", actionId: `CLOSE:${++userActionSequenceRef.current}` }; + if (!acquireProjectActionLock(identity)) return; + try { + autosaveRef.current?.cancel(); + setPreview(null); + setLodLevels(null); + setGPUTextureAssets([]); + setVolumeProject(null); + setSnapshot(null); + setSelectedObjectIds(new Set()); + setMeshSelection({ meshId: null, mode: "FACE", indices: new Set() }); + setGeometryBuffers([]); + setNonMeshGeometryBuffers([]); + setFrame(1); + setDirtyState(createDirtyState()); + projectRevisionRef.current = 0; + committedProjectRevisionRef.current = 0; + committedProjectHashRef.current = null; + setSaveTransaction(createSaveTransactionState({ revision: 0, sha256: null })); + commandCountRef.current = 0; + setOpenProgress(null); + setEngineStatus("Engine: ready, open a .blend file"); + } + finally { + releaseProjectActionLock(identity); } }; const reportGLBExport = async (): Promise => { - if (!snapshot) return; - let exportSnapshot = snapshot; - let exportGeometryBuffers = geometryBuffers; - if ((snapshot.nonMeshData?.length ?? 0) > 0 && webClientRef.current) { - try { - const evaluated = await webClientRef.current.evaluateDepsgraph(); - const mapped = mapEvaluatedNonMeshForExport(snapshot, geometryBuffers, evaluated.depsgraph); - exportSnapshot = mapped.snapshot; - exportGeometryBuffers = mapped.geometryBuffers; + const identity = beginUserAction("EXPORT"); + if (!snapshot) { + failUserAction(identity, "EXPORT_PROJECT_UNAVAILABLE"); + setEngineStatus("GLB: blocked (no open project)"); + return; + } + try { + let exportSnapshot = snapshot; + let exportGeometryBuffers = geometryBuffers; + if ((snapshot.nonMeshData?.length ?? 0) > 0 && webClientRef.current) { + try { + const evaluated = await webClientRef.current.evaluateDepsgraph(); + const mapped = mapEvaluatedNonMeshForExport(snapshot, geometryBuffers, evaluated.depsgraph); + exportSnapshot = mapped.snapshot; + exportGeometryBuffers = mapped.geometryBuffers; + } + catch { + // The exporter will emit a machine-readable evaluation-required error. + } } - catch { - // The exporter will emit a machine-readable evaluation-required error. + const result = exportGLB(exportSnapshot, exportGeometryBuffers, [], nonMeshGeometryBuffers); + const report = result.report; + const errorCount = report.warnings.filter((warning) => warning.severity === "error").length; + const warningCount = report.warnings.length - errorCount; + if (result.glb) { + const url = URL.createObjectURL(new Blob([result.glb], { type: "model/gltf-binary" })); + const anchor = document.createElement("a"); + anchor.href = url; + anchor.download = "blender-web.glb"; + anchor.click(); + URL.revokeObjectURL(url); + succeedUserAction(identity); + setEngineStatus(`GLB: exported (${result.glb.byteLength} bytes, ${warningCount} warnings)`); + } + else { + failUserAction(identity, "EXPORT_BLOCKED"); + setEngineStatus(`GLB: blocked (${errorCount} errors, ${warningCount} warnings)`); } } - const result = exportGLB(exportSnapshot, exportGeometryBuffers, [], nonMeshGeometryBuffers); - const report = result.report; - const errorCount = report.warnings.filter((warning) => warning.severity === "error").length; - const warningCount = report.warnings.length - errorCount; - if (result.glb) { - const url = URL.createObjectURL(new Blob([result.glb], { type: "model/gltf-binary" })); - const anchor = document.createElement("a"); - anchor.href = url; - anchor.download = "blender-web.glb"; - anchor.click(); - URL.revokeObjectURL(url); - setEngineStatus(`GLB: exported (${result.glb.byteLength} bytes, ${warningCount} warnings)`); + catch (error) { + failUserAction(identity, "EXPORT_FAILED"); + setEngineStatus(`GLB: export failed${error instanceof Error ? ` (${error.message})` : ""}`); } - else setEngineStatus(`GLB: blocked (${errorCount} errors, ${warningCount} warnings)`); }; useEffect(() => { @@ -1317,11 +1629,16 @@ export function App() { return; } autosaveRef.current?.schedule(async () => { + const identity: ProjectActionIdentity = { kind: "SAVE", actionId: `AUTOSAVE:${++userActionSequenceRef.current}` }; + if (!acquireProjectActionLock(identity, false)) return; try { await persistProject(); } catch (error) { setEngineStatus(`Engine: autosave failed${error instanceof Error ? ` (${error.message})` : ""}`); } + finally { + releaseProjectActionLock(identity); + } }); }, [saved, snapshot]); @@ -1329,6 +1646,7 @@ export function App() { const vertexCount = snapshot?.meshes.reduce((total, mesh) => total + mesh.vertexCount, 0) ?? 0; const faceCount = snapshot?.meshes.reduce((total, mesh) => total + mesh.faceCount, 0) ?? 0; const frameRange = snapshot?.frame ?? { current: frame, start: 1, end: 250 }; + const canCancelOpenRead = userActions.OPEN.status === "RUNNING" && (openProgress?.operation === "blend.open.read" || openProgress?.cancellable === true); const operatorCommands: OperatorCommand[] = [ ...(["Layout", "Modeling", "Animation"] as WorkspaceId[]).filter((id) => id !== workspace).map((id) => ({ id: `workspace.${id}`, label: `Switch to ${id}`, keywords: "workspace", execute: () => dispatchUI({ type: "switchWorkspace", workspaceId: id }) })), { id: "mode.toggle", label: uiState.context.mode === "Object" ? "Enter Edit Mode" : "Exit Edit Mode", keywords: "mode tab", execute: () => dispatchUI({ type: "setMode", mode: uiState.context.mode === "Object" ? "Edit" : "Object" }) }, @@ -1338,21 +1656,41 @@ export function App() { { id: "edit.undo", label: "Undo", keywords: "history", execute: () => { void applyEditCommand({ type: "undo" }); } }, { id: "edit.redo", label: "Redo", keywords: "history", execute: () => { void applyEditCommand({ type: "redo" }); } }, { id: "file.save", label: "Save Project", keywords: "file blend", execute: () => { void saveBlend(); } }, + { id: "file.close", label: "Close Project", keywords: "file", execute: closeProject }, ] : []), ]; return ( -
+
Web Blender Modeler V1
-
+
{ const file = event.target.files?.[0]; if (file) void openBlendFile(file); event.target.value = ""; }} />
-
{workspaceLabel}{uiState.context.mode === "Edit" ? <>
{(["VERT", "EDGE", "FACE"] as MeshElementMode[]).map((mode) => )}
{(["MERGE", "DISSOLVE", "EXTRUDE", "INSET", "BEVEL", "LOOP_CUT"] as MeshEditOperation[]).map((operation) => )} : <>}{uiState.context.mode === "Edit" ? `${meshSelection.greasePencilPoints?.length ?? meshSelection.indices.size} ${meshSelection.mode.toLowerCase()} selected` : `${selectedObjectIds.size} selected`}
+
{workspaceLabel}{uiState.context.mode === "Edit" ? <>
{(["VERT", "EDGE", "FACE"] as MeshElementMode[]).map((mode) => )}
{(["MERGE", "DISSOLVE", "EXTRUDE", "INSET", "BEVEL", "LOOP_CUT"] as MeshEditOperation[]).map((operation) => )} : <>}{uiState.context.mode === "Edit" ? `${meshSelection.greasePencilPoints?.length ?? meshSelection.indices.size} ${meshSelection.mode.toLowerCase()} selected` : `${selectedObjectIds.size} selected`}{saved ? "已保存" : "未保存"}
void applyEditCommand({ type: "setObjectVisibility", objectId: id, visible })} /> @@ -1360,7 +1698,7 @@ export function App() { void applyEditCommand({ type: "setFrame", frame: value })} onCommand={(command) => void applyEditCommand(command)} />
{uiState.operatorSearchOpen ? dispatchUI({ type: "toggleOperatorSearch", open: false })} /> : null} -
Web Blender Modeler V1Objects {objectCount} · Vertices {vertexCount} · Faces {faceCount}{openProgress ? {openProgress.message ?? "Opening"} : null}{manifestStatus}{wasmStatus}{engineStatus}{storageStatus}
+
Web Blender Modeler V1Objects {objectCount} · Vertices {vertexCount} · Faces {faceCount}{openProgress ? 0 ? openProgress.totalBytes : 1} value={openProgress.bytesRead ?? openProgress.fraction ?? 0} />{openProgress.message ?? "Opening"}{canCancelOpenRead ? : null} : null}{manifestStatus}{wasmStatus}{engineStatus}{storageStatus}
); } diff --git a/web/app/src/app/app-shell.css b/web/app/src/app/app-shell.css index c671738f..dc034160 100644 --- a/web/app/src/app/app-shell.css +++ b/web/app/src/app/app-shell.css @@ -19,6 +19,7 @@ button { color: inherit; border: 0; cursor: pointer; } .menu-bar, .workspace-tabs, .topbar-actions { display: flex; align-items: center; gap: 2px; } .menu-bar button, .topbar-actions button, .workspace-tab, .workspace-toolbar button { padding: 5px 8px; background: transparent; border-radius: 3px; color: #bfc2c8; } .menu-bar button:hover, .topbar-actions button:hover, .workspace-tab:hover, .workspace-toolbar button:hover { background: #3a3c41; color: #fff; } +.topbar-actions button:disabled { color: #6f737b; background: transparent; cursor: default; } .workspace-tabs { align-self: stretch; gap: 0; } .workspace-tab { min-width: 82px; border-bottom: 2px solid transparent; border-radius: 0; } .workspace-tab.active { color: #fff; background: #313338; border-bottom-color: #e37a2c; } @@ -62,6 +63,7 @@ button { color: inherit; border: 0; cursor: pointer; } .property-section input[type="number"] { width: 72px; padding: 3px 5px; color: #e0e2e6; background: #26282c; border: 1px solid #484c53; border-radius: 2px; }.property-section input[type="text"], .property-section label > input:not([type]) { min-width: 0; width: 130px; padding: 3px 5px; color: #e0e2e6; background: #26282c; border: 1px solid #484c53; border-radius: 2px; }.property-section input[type="checkbox"] { accent-color: #e37a2c; }.property-actions { display: flex; flex-wrap: wrap; gap: 4px; margin: 6px 0; }.property-actions button, .file-button { padding: 4px 7px; color: #e6e7e9; background: #393c42; border: 1px solid #4d5158; border-radius: 2px; }.property-actions button:disabled { opacity: .45; cursor: default; }.file-button { position: relative; cursor: pointer; }.file-button input { position: absolute; width: 1px; height: 1px; opacity: 0; }.material-slots { display: grid; gap: 2px; max-height: 62px; overflow: auto; color: #b9bdc5; font-size: 11px; }.delimit-options { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 2px 8px; margin: 6px 0; padding: 5px 0 3px; border: 0; border-top: 1px solid #383a40; }.delimit-options legend { padding: 0 5px 0 0; color: #7f858e; font-size: 10px; }.property-section .delimit-options label { justify-content: flex-start; min-width: 0; min-height: 20px; font-size: 10px; } .timeline-content { display: grid; grid-template-rows: 34px 20px 16px minmax(30px, 1fr); height: 100%; padding: 6px 12px; }.timeline-controls { display: flex; align-items: center; gap: 4px; overflow-x: auto; }.timeline-controls button { min-width: 28px; height: 26px; padding: 0 6px; color: #c9ccd2; background: #35373d; border-radius: 3px; white-space: nowrap; }.timeline-controls button:hover { background: #4a4d54; }.frame-number { min-width: 45px; margin-left: 10px; padding: 5px 8px; text-align: center; color: #fff; background: #181a1d; border: 1px solid #4a4d54; border-radius: 3px; }.frame-slider { width: 100%; accent-color: #e37a2c; }.timeline-scale { display: flex; justify-content: space-between; color: #7f858f; font-size: 11px; }.dope-sheet { display: grid; grid-template-columns: 100px minmax(120px, 1fr) 90px; align-items: center; gap: 8px; border-top: 1px solid #3a3d43; }.channel-name { overflow: hidden; color: #b8bcc4; text-overflow: ellipsis; white-space: nowrap; }.key-track { position: relative; height: 20px; background: #1e2024; border: 1px solid #373a40; }.key-dot { position: absolute; top: 5px; width: 9px; height: 9px; padding: 0; transform: translateX(-50%) rotate(45deg); background: #d6a348; border: 1px solid #f2c977; }.key-dot.active { background: #e36d2d; }.dope-sheet select { min-width: 0; color: #ddd; background: #292b30; border: 1px solid #484c53; } .status-bar { gap: 16px; min-width: 0; min-height: 24px; overflow: hidden; color: #8f949c; font-size: 11px; border: 0; }.status-bar span:not(.status-spacer) { white-space: nowrap; } +.open-progress { display: inline-flex; align-items: center; gap: 5px; min-width: 0; max-width: 360px; }.open-progress progress { width: 72px; height: 8px; accent-color: #e37a2c; }.open-progress > span { overflow: hidden; text-overflow: ellipsis; }.open-progress button { width: 20px; height: 20px; padding: 0; color: #d6d8dc; background: #3a3c41; border-radius: 2px; } .file-input-hidden { position: absolute; width: 1px; height: 1px; overflow: hidden; clip: rect(0 0 0 0); white-space: nowrap; } .operator-search { position: fixed; top: 56px; left: 50%; z-index: 10; width: min(480px, calc(100vw - 24px)); padding: 8px; transform: translateX(-50%); background: #303238; border: 1px solid #545860; border-radius: 4px; box-shadow: 0 12px 30px #0008; } .operator-search input { width: 100%; padding: 8px 10px; color: #f4f5f6; background: #1d1f22; border: 1px solid #5a5e66; border-radius: 3px; outline: none; } diff --git a/web/app/src/engine-client/WebEngineClient.ts b/web/app/src/engine-client/WebEngineClient.ts index d15ea4d7..c357c72c 100644 --- a/web/app/src/engine-client/WebEngineClient.ts +++ b/web/app/src/engine-client/WebEngineClient.ts @@ -8,6 +8,7 @@ import type { WebEngineRequest, WebEngineResponse, WebEngineResult, + WebEngineOpenResourceStatus, WebEngineStatus, } from "../../../protocol/web-engine"; import type { LODGenerationRequest } from "../../../protocol/lod"; @@ -25,6 +26,7 @@ interface PendingRequest { reject: (error: ErrorReport) => void; onProgress?: (progress: ProgressEvent) => void; timer: ReturnType; + cleanup?: () => void; } export interface WebEngineClientOptions { @@ -61,11 +63,11 @@ export class WebEngineClient { return (await this.request({ type: "init" })).status; } - async openBlend(buffer: ArrayBuffer, onProgress?: (progress: ProgressEvent) => void): Promise { + async openBlend(buffer: ArrayBuffer, onProgress?: (progress: ProgressEvent) => void, signal?: AbortSignal): Promise { if (buffer.byteLength === 0) { throw this.report("INVALID_ARGUMENT", "无法打开空的 .blend 文件", true); } - const result = await this.request({ type: "openBlend", buffer }, [buffer], onProgress); + const result = await this.request({ type: "openBlend", buffer }, [buffer], onProgress, signal); if (!result.snapshot) throw this.report("BLEND_READ_FAILED", "WebEngine 未返回 SceneIR", true); this.geometryBuffers = result.geometryBuffers ?? []; this.nonMeshGeometryBuffers = result.nonMeshGeometryBuffers ?? []; @@ -146,6 +148,12 @@ export class WebEngineClient { return result.blend; } + async openResourceStatus(): Promise { + const result = await this.request({ type: "openResourceStatus" }); + if (!result.openResources) throw this.report("INVALID_ARGUMENT", "WebEngine open resource status missing", true); + return result.openResources; + } + terminate(): void { this.failPending(this.report("WORKER_TERMINATED", "WebEngineWorker 已关闭", true)); this.worker?.terminate(); @@ -169,16 +177,29 @@ export class WebEngineClient { command: WebEngineRequest["command"], transfer: Transferable[] = [], onProgress?: (progress: ProgressEvent) => void, + signal?: AbortSignal, ): Promise { const worker = this.start(); const requestId = `web-engine-${++this.requestCounter}`; const request = { requestId, command } as WebEngineRequest; return new Promise((resolve, reject) => { const timer = setTimeout(() => { + this.pending.get(requestId)?.cleanup?.(); this.pending.delete(requestId); reject(this.report("WORKER_TERMINATED", `WebEngine 请求超时: ${command.type}`, true)); }, this.timeoutMs); - this.pending.set(requestId, { resolve, reject, onProgress, timer }); + const abort = (): void => { + worker.postMessage({ + requestId: `web-engine-cancel-${++this.requestCounter}`, + command: { type: "cancelOpen", targetRequestId: requestId }, + } satisfies WebEngineRequest); + }; + const cleanup = signal ? () => signal.removeEventListener("abort", abort) : undefined; + this.pending.set(requestId, { resolve, reject, onProgress, timer, cleanup }); + if (signal) { + signal.addEventListener("abort", abort, { once: true }); + if (signal.aborted) abort(); + } worker.postMessage(request, transfer); }); } @@ -192,6 +213,7 @@ export class WebEngineClient { } this.pending.delete(response.requestId); clearTimeout(pending.timer); + pending.cleanup?.(); if (response.ok) pending.resolve(response.result); else pending.reject(response.error); } @@ -199,6 +221,7 @@ export class WebEngineClient { private failPending(error: ErrorReport): void { for (const pending of this.pending.values()) { clearTimeout(pending.timer); + pending.cleanup?.(); pending.reject(error); } this.pending.clear(); diff --git a/web/app/src/engine-client/browser-engine-variant-session.ts b/web/app/src/engine-client/browser-engine-variant-session.ts new file mode 100644 index 00000000..01cdb22a --- /dev/null +++ b/web/app/src/engine-client/browser-engine-variant-session.ts @@ -0,0 +1,139 @@ +import type { WebEngineVariantV2 } from "../../../protocol/manifest"; +import type { + EngineVariantResourceState, + EngineVariantSession, +} from "./engine-variant-bootstrap"; +import { EngineVariantLoadError } from "./engine-variant-bootstrap"; + +interface EmscriptenPThreadRuntime { + unusedWorkers: Worker[]; + runningWorkers: Worker[]; + terminateAllThreads(): void; +} + +interface BrowserVariantModule { + HEAPU8: Uint8Array; + _malloc(size: number): number; + _free(pointer: number): void; + _web_engine_create(): number; + _web_engine_destroy(handle: number): void; + _web_engine_get_live_handles(): number; + _web_engine_open_blend(handle: number, data: number, length: number): number; + PThread?: EmscriptenPThreadRuntime; +} + +type BrowserVariantFactory = (options: { wasmBinary: ArrayBuffer }) => Promise; + +async function verifiedBytes(url: string, expectedSha256: string, controllers: Set): Promise { + const controller = new AbortController(); + controllers.add(controller); + try { + const response = await fetch(url, { cache: "no-store", signal: controller.signal }); + if (!response.ok) { + throw new EngineVariantLoadError( + "ENGINE_VARIANT_RESOURCE_REQUEST_FAILED", + `${url} returned ${response.status}`, + ); + } + const bytes = await response.arrayBuffer(); + const digest = await crypto.subtle.digest("SHA-256", bytes); + const actual = [...new Uint8Array(digest)] + .map((byte) => byte.toString(16).padStart(2, "0")) + .join(""); + if (actual !== expectedSha256) { + throw new EngineVariantLoadError("ENGINE_VARIANT_RESOURCE_HASH_MISMATCH", url); + } + return bytes; + } + finally { + controllers.delete(controller); + } +} + +class BrowserEngineVariantSession implements EngineVariantSession { + readonly variant: WebEngineVariantV2; + private readonly module: BrowserVariantModule; + private readonly pendingRequests: Set; + private readonly timers = new Set>(); + private handle: number; + + constructor( + variant: WebEngineVariantV2, + module: BrowserVariantModule, + handle: number, + pendingRequests: Set, + ) { + this.variant = variant; + this.module = module; + this.handle = handle; + this.pendingRequests = pendingRequests; + } + + async openProject(project: ArrayBuffer): Promise { + if (this.handle <= 0) throw new Error("ENGINE_VARIANT_SESSION_DISPOSED"); + const pointer = this.module._malloc(project.byteLength); + if (project.byteLength > 0 && pointer <= 0) throw new Error("ENGINE_VARIANT_PROJECT_ALLOCATION_FAILED"); + try { + if (project.byteLength > 0) this.module.HEAPU8.set(new Uint8Array(project), pointer); + const result = this.module._web_engine_open_blend(this.handle, pointer, project.byteLength); + if (result !== 0) throw new Error(`ENGINE_VARIANT_PROJECT_OPEN_FAILED: ${result}`); + } + finally { + if (pointer > 0) this.module._free(pointer); + } + } + + resourceState(): EngineVariantResourceState { + const pthread = this.module.PThread; + return { + handles: this.handle > 0 ? this.module._web_engine_get_live_handles() : 0, + workers: pthread ? pthread.unusedWorkers.length + pthread.runningWorkers.length : 0, + timers: this.timers.size, + pendingRequests: this.pendingRequests.size, + }; + } + + testOnlySeedTrackedResources(): void { + this.pendingRequests.add(new AbortController()); + const timer = setTimeout(() => this.timers.delete(timer), 60_000); + this.timers.add(timer); + } + + async dispose(): Promise { + for (const controller of this.pendingRequests) controller.abort(); + this.pendingRequests.clear(); + for (const timer of this.timers) clearTimeout(timer); + this.timers.clear(); + if (this.handle > 0) { + this.module._web_engine_destroy(this.handle); + this.handle = 0; + } + this.module.PThread?.terminateAllThreads(); + return this.resourceState(); + } +} + +export async function createBrowserEngineVariantSession( + variant: WebEngineVariantV2, +): Promise> { + const controllers = new Set(); + const verifiedResources = new Map(); + const verify = async (resource: { url: string; sha256: string }): Promise => { + const existing = verifiedResources.get(resource.url); + if (existing) return existing; + const bytes = await verifiedBytes(resource.url, resource.sha256, controllers); + verifiedResources.set(resource.url, bytes); + return bytes; + }; + await verify(variant.resources.js); + const wasmBinary = await verify(variant.resources.wasm); + if (variant.id === "pthread") await verify(variant.resources.pthreadWorker); + const imported = await import(/* @vite-ignore */ variant.resources.js.url) as { default: BrowserVariantFactory }; + const module = await imported.default({ wasmBinary }); + const handle = module._web_engine_create(); + if (handle <= 0) { + module.PThread?.terminateAllThreads(); + throw new Error("ENGINE_VARIANT_HANDLE_CREATION_FAILED"); + } + return new BrowserEngineVariantSession(variant, module, handle, controllers); +} diff --git a/web/app/src/engine-client/engine-variant-bootstrap.ts b/web/app/src/engine-client/engine-variant-bootstrap.ts new file mode 100644 index 00000000..2907ffd7 --- /dev/null +++ b/web/app/src/engine-client/engine-variant-bootstrap.ts @@ -0,0 +1,195 @@ +import { + bindWebEngineRelease, + selectWebEngineVariant, + type WasmThreadingCapabilities, + type WebEngineReleaseBinding, + type WebEngineVariantPolicy, +} from "../../../protocol/engine-variant"; +import type { CapabilityGateResult } from "../../../protocol/capability-gates"; +import type { WebEngineManifestV2, WebEngineVariantV2 } from "../../../protocol/manifest"; + +export interface EngineVariantResourceState { + handles: number; + workers: number; + timers: number; + pendingRequests: number; +} + +export interface EngineVariantSession { + readonly variant: WebEngineVariantV2; + openProject(project: Project): Promise; + dispose(): Promise; + resourceState(): EngineVariantResourceState; + testOnlySeedTrackedResources?(): void; +} + +export interface EngineVariantFallbackReason { + code: "PTHREAD_INITIALIZATION_FAILED"; + message: string; +} + +export interface EngineVariantBootstrapResult { + status: "READY"; + selected: "single" | "pthread"; + attempted: Array<"single" | "pthread">; + fallbackReason: EngineVariantFallbackReason | null; + pthreadGate: CapabilityGateResult; + openCount: number; + failedAttemptCleanup: EngineVariantResourceState | null; +} + +export interface EngineVariantBootstrapOutcome { + result: EngineVariantBootstrapResult; + session: EngineVariantSession; +} + +export type WebEngineRefreshRequired = Extract; + +export type WebEngineReleaseBootstrapOutcome = + | EngineVariantBootstrapOutcome + | { result: WebEngineRefreshRequired; session: null }; + +export interface EngineVariantBootstrapDependencies { + initialize(variant: WebEngineVariantV2): Promise>; +} + +export interface EngineVariantBootstrapTestHooks { + failPthreadAfterInitialize?: boolean; + seedTrackedPthreadResources?: boolean; +} + +export class EngineVariantLoadError extends Error { + readonly code: "ENGINE_VARIANT_RESOURCE_REQUEST_FAILED" | "ENGINE_VARIANT_RESOURCE_HASH_MISMATCH"; + + constructor(code: EngineVariantLoadError["code"], message: string, options?: ErrorOptions) { + super(message, options); + this.name = "EngineVariantLoadError"; + this.code = code; + } +} + +export class EngineVariantBootstrapError extends Error { + readonly code: "ENGINE_VARIANT_INTEGRITY_FAILED"; + readonly attempted: Array<"single" | "pthread">; + + constructor(attempted: Array<"single" | "pthread">, cause: EngineVariantLoadError) { + super(`${cause.code}: ${cause.message}`, { cause }); + this.name = "EngineVariantBootstrapError"; + this.code = "ENGINE_VARIANT_INTEGRITY_FAILED"; + this.attempted = [...attempted]; + } +} + +function failureMessage(error: unknown): string { + return error instanceof Error && error.message ? error.message : "pthread engine initialization failed"; +} + +function rejectIntegrityFailure( + error: unknown, + attempted: Array<"single" | "pthread">, +): void { + if (error instanceof EngineVariantLoadError && error.code === "ENGINE_VARIANT_RESOURCE_HASH_MISMATCH") { + throw new EngineVariantBootstrapError(attempted, error); + } +} + +async function bootstrapSelectedWebEngineVariant( + manifest: WebEngineManifestV2, + policy: WebEngineVariantPolicy, + capabilities: WasmThreadingCapabilities, + dependencies: EngineVariantBootstrapDependencies, + pendingProject?: Project, + testHooks?: EngineVariantBootstrapTestHooks, +): Promise> { + const selection = selectWebEngineVariant(manifest, policy, capabilities); + if (!selection.selectedVariant) throw new Error("PTHREAD_REQUIRED_CAPABILITY_BLOCKED"); + + const attempted: Array<"single" | "pthread"> = []; + let failedAttemptCleanup: EngineVariantResourceState | null = null; + let fallbackReason: EngineVariantFallbackReason | null = null; + let session: EngineVariantSession | null = null; + + const initialize = async (variant: WebEngineVariantV2): Promise> => { + attempted.push(variant.id); + return dependencies.initialize(variant); + }; + + try { + session = await initialize(selection.selectedVariant); + if (selection.selectedVariant.id === "pthread") { + if (testHooks?.seedTrackedPthreadResources) session.testOnlySeedTrackedResources?.(); + if (testHooks?.failPthreadAfterInitialize) throw new Error("TEST_PTHREAD_INITIALIZATION_FAILURE"); + } + } + catch (error) { + const failedSession = session; + if (failedSession) failedAttemptCleanup = await failedSession.dispose(); + rejectIntegrityFailure(error, attempted); + if (policy !== "AUTO" || selection.selectedVariant.id !== "pthread") throw error; + fallbackReason = { code: "PTHREAD_INITIALIZATION_FAILED", message: failureMessage(error) }; + const single = manifest.variants.find((variant) => variant.id === "single"); + if (!single) throw new Error("ENGINE_MANIFEST_VARIANTS_MISSING", { cause: error }); + try { + session = await initialize(single); + } + catch (fallbackError) { + rejectIntegrityFailure(fallbackError, attempted); + throw fallbackError; + } + } + + if (!session) throw new Error("ENGINE_VARIANT_INITIALIZATION_FAILED"); + let openCount = 0; + if (pendingProject !== undefined) { + try { + await session.openProject(pendingProject); + openCount = 1; + } + catch (error) { + await session.dispose(); + throw error; + } + } + return { + result: { + status: "READY", + selected: session.variant.id, + attempted, + fallbackReason, + pthreadGate: selection.pthreadGate, + openCount, + failedAttemptCleanup, + }, + session, + }; +} + +export async function bootstrapWebEngineRelease( + expectedReleaseId: string, + manifest: WebEngineManifestV2, + policy: WebEngineVariantPolicy, + capabilities: WasmThreadingCapabilities, + dependencies: EngineVariantBootstrapDependencies, + pendingProject?: Project, + testHooks?: EngineVariantBootstrapTestHooks, +): Promise> { + const binding = bindWebEngineRelease(expectedReleaseId, manifest); + if (binding.status === "REFRESH_REQUIRED") { + return { result: binding, session: null }; + } + return bootstrapSelectedWebEngineVariant( + binding.manifest, + policy, + capabilities, + dependencies, + pendingProject, + testHooks, + ); +} + +export function engineVariantStatusLabel(result: EngineVariantBootstrapResult): string { + if (result.selected === "pthread") return "Runtime: pthread"; + return result.fallbackReason + ? `Runtime: single (pthread fallback: ${result.fallbackReason.code})` + : "Runtime: single"; +} diff --git a/web/app/src/platform/capabilities.ts b/web/app/src/platform/capabilities.ts index e1ca0d33..9aec0d26 100644 --- a/web/app/src/platform/capabilities.ts +++ b/web/app/src/platform/capabilities.ts @@ -1,10 +1,8 @@ -import { blockedGate, capabilityIssue, readyGate, type CapabilityGateResult } from "../../../protocol/capability-gates"; - -export interface WasmThreadingCapabilities { - crossOriginIsolated: boolean; - sharedArrayBuffer: boolean; - worker: boolean; -} +import { + type WasmThreadingCapabilities, +} from "../../../protocol/engine-variant"; +export { gateWasmThreadingCapability, selectWebEngineVariant } from "../../../protocol/engine-variant"; +export type { WasmThreadingCapabilities } from "../../../protocol/engine-variant"; export interface BrowserCapabilities extends WasmThreadingCapabilities { webgl2: boolean; @@ -17,34 +15,6 @@ export interface BrowserCapabilities extends WasmThreadingCapabilities { indexedDb: boolean; } -export function gateWasmThreadingCapability(capabilities: WasmThreadingCapabilities): CapabilityGateResult { - const issues = []; - if (!capabilities.crossOriginIsolated) { - issues.push(capabilityIssue( - "PLATFORM_CAPABILITY_UNAVAILABLE", - "Cross-origin isolation is required for the pthread WASM engine", - "crossOriginIsolated", - )); - } - if (!capabilities.sharedArrayBuffer) { - issues.push(capabilityIssue( - "PLATFORM_CAPABILITY_UNAVAILABLE", - "SharedArrayBuffer is required for the pthread WASM engine", - "sharedArrayBuffer", - )); - } - if (!capabilities.worker) { - issues.push(capabilityIssue( - "PLATFORM_CAPABILITY_UNAVAILABLE", - "Worker is required for the pthread WASM engine", - "worker", - )); - } - return issues.length > 0 - ? blockedGate("M6-02", "WASM_PTHREAD_ENGINE", issues) - : readyGate("M6-02", "WASM_PTHREAD_ENGINE"); -} - function supportsWasmFeature(feature: "simd" | "threads"): boolean { if (typeof WebAssembly === "undefined") return false; diff --git a/web/app/src/storage/StorageClient.ts b/web/app/src/storage/StorageClient.ts index 8ad466cb..1a6ef4b5 100644 --- a/web/app/src/storage/StorageClient.ts +++ b/web/app/src/storage/StorageClient.ts @@ -43,7 +43,7 @@ export class StorageClient { return this.request({ type: "ensureProject", projectId }) as Promise; } - saveProject(projectId: string, revision: number, buffer: ArrayBuffer, faultAt?: "after-stage" | "after-scene-commit" | "quota"): Promise { + saveProject(projectId: string, revision: number, buffer: ArrayBuffer, faultAt?: "after-stage" | "after-scene-commit" | "before-metadata-commit" | "quota"): Promise { return this.request({ type: "saveProject", projectId, revision, buffer, faultAt }, [buffer]) as Promise; } diff --git a/web/app/src/storage/opfs-files.ts b/web/app/src/storage/opfs-files.ts index 8b3b2145..a2d69723 100644 --- a/web/app/src/storage/opfs-files.ts +++ b/web/app/src/storage/opfs-files.ts @@ -1,6 +1,7 @@ const PROJECT_ID_PATTERN = /^[A-Za-z0-9_-]{1,64}$/; const FILE_NAME_PATTERN = /^[A-Za-z0-9._-]{1,128}$/; const SHA256_PATTERN = /^[a-f0-9]{64}$/; +export const OPFS_PROJECT_SCHEMA_VERSION = 1; export interface OpfsProjectLayout { projectId: string; @@ -52,7 +53,7 @@ type OpfsStorage = StorageManager & { getDirectory?: () => Promise { const manifest: ProjectBlendManifest = { - schemaVersion: 1, + schemaVersion: OPFS_PROJECT_SCHEMA_VERSION, projectId: journal.projectId, revision: journal.revision, bytes: journal.bytes, @@ -266,7 +267,7 @@ export async function writeProjectBlend( const stageName = `scene.blend.${crypto.randomUUID()}.stage`; const sha256 = await sha256Hex(data); const journal: ProjectBlendJournal = { - schemaVersion: 1, + schemaVersion: OPFS_PROJECT_SCHEMA_VERSION, projectId, revision, bytes: data.byteLength, diff --git a/web/app/src/workers/storage.worker.ts b/web/app/src/workers/storage.worker.ts index 4b3f4da3..513a56b7 100644 --- a/web/app/src/workers/storage.worker.ts +++ b/web/app/src/workers/storage.worker.ts @@ -199,12 +199,12 @@ async function ensureProject(projectId: string): Promise { }; } -async function saveProject(projectId: string, revision: number, buffer: ArrayBuffer, faultAt?: ProjectSaveFault | "quota"): Promise { +async function saveProject(projectId: string, revision: number, buffer: ArrayBuffer, faultAt?: ProjectSaveFault | "before-metadata-commit" | "quota"): Promise { if (faultAt === "quota") throw new Error("QuotaExceededError: injected OPFS quota exhaustion"); const useOpfs = await useOpfsForProject(projectId); const layout = useOpfs ? await ensureProjectLayout(projectId) : projectLayout(projectId); const sha256 = await sha256Hex(buffer); - const existing = faultAt ? undefined : await readProjectRow(projectId); + const existing = await readProjectRow(projectId); if (existing && existing.revision > revision) { throw new Error(`PROJECT_REVISION_CONFLICT: committed revision ${existing.revision} is newer than ${revision}`); } @@ -232,8 +232,24 @@ async function saveProject(projectId: string, revision: number, buffer: ArrayBuf }; } if (useOpfs) { - const committed = await writeProjectBlend(projectId, revision, buffer, undefined, faultAt); - if (committed.manifest.sha256 !== sha256) throw new Error("Project commit digest mismatch"); + const previousBuffer = faultAt && existing ? await readProjectBlend(projectId) : undefined; + try { + const opfsFault = faultAt === "after-stage" || faultAt === "after-scene-commit" ? faultAt : undefined; + const committed = await writeProjectBlend(projectId, revision, buffer, undefined, opfsFault); + if (committed.manifest.sha256 !== sha256) throw new Error("Project commit digest mismatch"); + if (faultAt === "before-metadata-commit") { + throw new Error("PROJECT_SAVE_FAULT_INJECTED: before-metadata-commit"); + } + } + catch (error) { + if (faultAt && existing && previousBuffer) { + const rollback = await writeProjectBlend(projectId, existing.revision, previousBuffer); + if (rollback.manifest.sha256 !== existing.sha256) { + throw new Error("PROJECT_SAVE_ROLLBACK_FAILED: old committed hash was not restored"); + } + } + throw error; + } } else if (faultAt) { throw new Error("PROJECT_SAVE_FAULT_UNAVAILABLE: IndexedDB commits are already transactional"); diff --git a/web/app/src/workers/web-engine.worker.ts b/web/app/src/workers/web-engine.worker.ts index 7c3be5e4..b2434751 100644 --- a/web/app/src/workers/web-engine.worker.ts +++ b/web/app/src/workers/web-engine.worker.ts @@ -1,6 +1,6 @@ import type { ErrorReport } from "../../../protocol/error"; import { parseSceneDelta, type SceneDelta } from "../../../protocol/scene-delta"; -import type { MeshGeometryBuffer, WebEngineLODError, WebEngineLODLevelResult, WebEngineRequest, WebEngineResponse, WebEngineResult, WebEngineStatus } from "../../../protocol/web-engine"; +import type { MeshGeometryBuffer, WebEngineLODError, WebEngineLODLevelResult, WebEngineOpenResourceStatus, WebEngineRequest, WebEngineResponse, WebEngineResult, WebEngineStatus } from "../../../protocol/web-engine"; import { parseSceneSnapshotIR } from "../../../protocol/scene-ir"; import { parseLODManifest, type SimplifyResult } from "../../../protocol/simplify"; import type { LODGenerationRequest } from "../../../protocol/lod"; @@ -95,6 +95,21 @@ let currentSnapshot: ReturnType | null = null; let currentGeometryBuffers: MeshGeometryBuffer[] = []; let sourceBlendBuffer: ArrayBuffer | null = null; let sourceBlendRevision = -1; +const cancelledOpenRequests = new Set(); +const activeOpenResources = new Map(); + +function openResourceStatus(): WebEngineOpenResourceStatus { + return [...activeOpenResources.values()].reduce((status, item) => ({ + activeRequests: status.activeRequests + 1, + liveInputBytes: status.liveInputBytes + item.liveInputBytes, + liveNativeHandles: status.liveNativeHandles + item.liveNativeHandles, + liveStagingFiles: status.liveStagingFiles + item.liveStagingFiles, + }), { activeRequests: 0, liveInputBytes: 0, liveNativeHandles: 0, liveStagingFiles: 0 }); +} + +function throwIfOpenCancelled(requestId: string): void { + if (cancelledOpenRequests.has(requestId)) throw report("OPEN_CANCELLED", "Blend open cancelled before Main commit"); +} function status(): WebEngineStatus { return { @@ -470,6 +485,15 @@ function nativeError(fallbackCode: ErrorReport["code"]): ErrorReport { return report(mappedCode, message); } +function nativeErrorFor(target: WasmModule, fallbackCode: ErrorReport["code"]): ErrorReport { + const code = target._web_engine_last_error_code() ?? 0; + const message = target._web_engine_last_error_message() !== 0 + ? target.UTF8ToString(target._web_engine_last_error_message()) + : "WebEngine native call failed"; + const mappedCode: ErrorReport["code"] = code === -4 ? "BLEND_READ_FAILED" : code === -5 ? "BLEND_WRITE_FAILED" : fallbackCode; + return report(mappedCode, message); +} + async function initialize(): Promise { if (module) return status(); if (!initializationPromise) { @@ -921,8 +945,8 @@ async function evaluateIsolatedDecimate( } } -function progress(requestId: string, phase: "started" | "progress" | "completed", fraction: number, message: string): void { - scope.postMessage({ kind: "progress", requestId, progress: { requestId, operation: "blend.open", phase, fraction, message } }); +function progress(requestId: string, phase: "started" | "progress" | "completed", fraction: number, message: string, stage?: string, cancellable?: boolean): void { + scope.postMessage({ kind: "progress", requestId, progress: { requestId, operation: "blend.open", phase, fraction, message, stage, cancellable } }); } scope.onmessage = async (event) => { @@ -936,27 +960,74 @@ scope.onmessage = async (event) => { result = baseResult(); break; case "openBlend": { - progress(request.requestId, "started", 0, "Reading .blend"); - await initialize(); - const sourceCopy = request.command.buffer.slice(0); - const input = copyIntoWasm(request.command.buffer); + const resource = { liveInputBytes: request.command.buffer.byteLength, liveNativeHandles: 0, liveStagingFiles: 0 }; + activeOpenResources.set(request.requestId, resource); + let candidateModule: WasmModule | null = null; + let candidateHandle = 0; try { - if (!module || module._web_engine_open_blend(handle, input.pointer, input.length) !== 0) { - throw nativeError("BLEND_READ_FAILED"); + progress(request.requestId, "started", 0, "Preparing isolated Main", "NATIVE_INITIALIZE", true); + await initialize(); + throwIfOpenCancelled(request.requestId); + if (!wasmFactory || !wasmBinary) throw report("WASM_INIT_FAILED", "WebEngine isolated open module is unavailable"); + candidateModule = await wasmFactory({ wasmBinary: wasmBinary.slice(0) }); + throwIfOpenCancelled(request.requestId); + candidateHandle = candidateModule._web_engine_create(); + if (candidateHandle <= 0) throw report("WASM_INIT_FAILED", "WebEngine isolated open handle creation failed"); + resource.liveNativeHandles = 1; + const pointer = candidateModule._malloc(request.command.buffer.byteLength); + if (!pointer) throw report("WASM_OUT_OF_MEMORY", "WebEngine could not allocate isolated blend input"); + try { + candidateModule.HEAPU8.set(new Uint8Array(request.command.buffer), pointer); + if (candidateModule._web_engine_open_blend(candidateHandle, pointer, request.command.buffer.byteLength) !== 0) { + throw nativeErrorFor(candidateModule, "BLEND_READ_FAILED"); + } } + finally { + candidateModule._free(pointer); + resource.liveInputBytes = 0; + } + progress(request.requestId, "progress", 0.7, "Isolated Main opened", "NATIVE_OPENED", true); + await new Promise((resolve) => setTimeout(resolve, 0)); + throwIfOpenCancelled(request.requestId); + + const previousModule = module; + const previousHandle = handle; + module = candidateModule; + handle = candidateHandle; + try { + progress(request.requestId, "progress", 0.8, "Building SceneIR", "COMMITTING", false); + const scene = await readSnapshotResult(); + throwIfOpenCancelled(request.requestId); + const sourceCopy = request.command.buffer.slice(0); + currentSnapshot = scene.snapshot; + sourceBlendBuffer = sourceCopy; + sourceBlendRevision = scene.snapshot.revision; + result = { status: status(), ...publishFullScene(scene) }; + } + catch (error) { + module = previousModule; + handle = previousHandle; + throw error; + } + previousModule?._web_engine_destroy(previousHandle); + candidateHandle = 0; + resource.liveNativeHandles = 0; + progress(request.requestId, "completed", 1, "SceneIR ready", "COMPLETED", false); } finally { - module?._free(input.pointer); + if (candidateModule && candidateHandle > 0) candidateModule._web_engine_destroy(candidateHandle); + activeOpenResources.delete(request.requestId); + cancelledOpenRequests.delete(request.requestId); } - progress(request.requestId, "progress", 0.8, "Building SceneIR"); - const scene = await readSnapshotResult(); - currentSnapshot = scene.snapshot; - sourceBlendBuffer = sourceCopy; - sourceBlendRevision = scene.snapshot.revision; - result = { status: status(), ...publishFullScene(scene) }; - progress(request.requestId, "completed", 1, "SceneIR ready"); - break; - } + break; + } + case "cancelOpen": + if (activeOpenResources.has(request.command.targetRequestId)) cancelledOpenRequests.add(request.command.targetRequestId); + result = { status: status(), openResources: openResourceStatus() }; + break; + case "openResourceStatus": + result = { status: status(), openResources: openResourceStatus() }; + break; case "snapshot": await initialize(); { diff --git a/web/app/vite.config.ts b/web/app/vite.config.ts index 525518f3..e1d88209 100644 --- a/web/app/vite.config.ts +++ b/web/app/vite.config.ts @@ -11,6 +11,9 @@ const deploymentContract = JSON.parse( fs.readFileSync(path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../docs/web/deployment-contract.json"), "utf8"), ) as { responseHeaders: { allResponses: Record } }; const isolationHeaders = deploymentContract.responseHeaders.allResponses; +const runtimeEnvironment = (globalThis as { process?: { env?: Record } }).process?.env; +const unisolatedSingleThreadTest = runtimeEnvironment?.WEB_TEST_UNISOLATED_SINGLE_THREAD === "1"; +const developmentHeaders = unisolatedSingleThreadTest ? {} : isolationHeaders; function preserveIsolationHeaders(): Plugin { const install = (server: { middlewares: { use: (handler: (request: unknown, response: { setHeader: (name: string, value: string) => void }, next: () => void) => void) => void } }) => { @@ -26,8 +29,31 @@ function preserveIsolationHeaders(): Plugin { }; } +function serveEngineVariantModuleImports(): Plugin { + const vendorRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "public/vendor/blender"); + const install = (server: { middlewares: { use: (handler: (request: unknown, response: { setHeader: (name: string, value: string | number) => void }, next: () => void) => void) => void } }) => { + server.middlewares.use((request, response, next) => { + const url = new URL((request as { url?: string }).url ?? "/", "http://vite.local"); + const match = url.pathname.match(/^\/vendor\/blender\/(single|pthread)\/web_engine\.js$/); + if (!match || !url.searchParams.has("import")) { next(); return; } + const filePath = path.join(vendorRoot, match[1], "web_engine.js"); + if (!fs.existsSync(filePath)) { next(); return; } + const stat = fs.statSync(filePath); + response.setHeader("Content-Type", "text/javascript; charset=utf-8"); + response.setHeader("Content-Length", stat.size); + for (const [name, value] of Object.entries(developmentHeaders)) response.setHeader(name, value); + fs.createReadStream(filePath).pipe(response as never); + }); + }; + return { + name: "serve-engine-variant-module-imports", + configureServer: install, + configurePreviewServer: install, + }; +} + function localVDBFixture(): Plugin { - const resourceRoot = (globalThis as { process?: { env?: Record } }).process?.env?.VDB_RESOURCE_ROOT ?? "/home/mes123456/resource-library/blender-web-vdb"; + const resourceRoot = runtimeEnvironment?.VDB_RESOURCE_ROOT ?? path.join(runtimeEnvironment?.HOME ?? "", "resource-library/blender-web-vdb"); const files = new Map([ ["/__vdb_fixture__/manifest", { path: path.join(resourceRoot, "manifests/generated-smoke.nanovdb.json"), type: "application/json" }], ["/__vdb_fixture__/report", { path: path.join(resourceRoot, "reports/generated-smoke-conversion.json"), type: "application/json" }], @@ -70,18 +96,19 @@ function localVDBFixture(): Plugin { export default defineConfig({ root: "app", - plugins: [preserveIsolationHeaders(), localVDBFixture(), react()], + plugins: [ + serveEngineVariantModuleImports(), + ...(unisolatedSingleThreadTest ? [] : [preserveIsolationHeaders()]), + localVDBFixture(), + react(), + ], server: { port: 5173, strictPort: false, - headers: { - ...isolationHeaders, - }, + headers: developmentHeaders, }, preview: { - headers: { - ...isolationHeaders, - }, + headers: developmentHeaders, }, build: { outDir: "../dist", diff --git a/web/engine/CMakeLists.txt b/web/engine/CMakeLists.txt index 4567c51b..10bc509b 100644 --- a/web/engine/CMakeLists.txt +++ b/web/engine/CMakeLists.txt @@ -25,8 +25,12 @@ target_include_directories(blender_web_engine_core PUBLIC add_executable(web_engine web_engine_smoke.cpp) target_link_libraries(web_engine PRIVATE blender_web_engine_core) +set(WEB_ENGINE_EXPORTED_RUNTIME_METHODS "['ccall','cwrap']") +if(WEB_ENGINE_THREADS) + set(WEB_ENGINE_EXPORTED_RUNTIME_METHODS "['ccall','cwrap','PThread']") +endif() target_link_options(web_engine PRIVATE "-sEXPORTED_FUNCTIONS=['_malloc','_free','_web_engine_create','_web_engine_destroy','_web_engine_get_memory_stats','_web_engine_get_live_handles','_web_engine_get_allocated_bytes','_web_engine_open_blend','_web_engine_apply_command','_web_engine_get_scene_snapshot','_web_engine_save_blend','_web_engine_free_buffer','_web_engine_last_error_code','_web_engine_last_error_message']" - "-sEXPORTED_RUNTIME_METHODS=['ccall','cwrap']" + "-sEXPORTED_RUNTIME_METHODS=${WEB_ENGINE_EXPORTED_RUNTIME_METHODS}" ) set_target_properties(web_engine PROPERTIES OUTPUT_NAME "web_engine") diff --git a/web/package-lock.json b/web/package-lock.json index e86fd4c6..a8df1ac7 100644 --- a/web/package-lock.json +++ b/web/package-lock.json @@ -1,12 +1,12 @@ { "name": "blender-web-editor", - "version": "0.1.0", + "version": "0.1.0-rc.1", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "blender-web-editor", - "version": "0.1.0", + "version": "0.1.0-rc.1", "dependencies": { "react": "19.2.8", "react-dom": "19.2.8" diff --git a/web/package.json b/web/package.json index 5c7177c0..5ebc7dc9 100644 --- a/web/package.json +++ b/web/package.json @@ -1,7 +1,7 @@ { "name": "blender-web-editor", "private": true, - "version": "0.1.0", + "version": "0.1.0-rc.1", "type": "module", "scripts": { "dev": "vite --config app/vite.config.ts", @@ -10,6 +10,25 @@ "lint": "eslint app", "check:local-deps": "bash ../tools/web/check-local-deps.sh", "test": "node --test tests/**/*.test.mjs", + "test:engine-manifest-v2": "node --test tests/unit/engine-manifest-v2.test.mjs", + "test:engine-variant-install": "node ../tools/web/check-engine-variant-install.mjs", + "test:engine-variant-selection": "node --test tests/unit/engine-variant-selection.test.mjs", + "test:engine-variant-fallback": "node --test tests/unit/engine-variant-fallback.test.mjs", + "test:engine-upgrade-safety": "node --test --test-name-pattern=M6-08 tests/unit/engine-variant-selection.test.mjs tests/unit/engine-variant-fallback.test.mjs && playwright test --config playwright.config.ts tests/e2e/engine-upgrade-safety.spec.ts", + "test:user-actions": "node --test tests/unit/user-action-state.test.mjs tests/unit/project-action-mutex.test.mjs tests/unit/file-byte-reader.test.mjs tests/unit/save-transaction.test.mjs tests/unit/dirty-state.test.mjs && playwright test --config playwright.config.ts tests/e2e/user-action-state.spec.ts tests/e2e/project-action-mutex.spec.ts tests/e2e/file-import-progress.spec.ts tests/e2e/save-interruption.spec.ts tests/e2e/dirty-state.spec.ts", + "test:deployment-http": "node ../tools/web/check-deployment-http.mjs", + "test:deployment-runbook": "node ../tools/web/check-deployment-runbook.mjs", + "test:upgrade-runbook": "node ../tools/web/check-upgrade-runbook.mjs", + "test:rollback-runbook": "node ../tools/web/check-rollback-runbook.mjs", + "test:operations-diagnostics": "node ../tools/web/check-operations-diagnostics.mjs", + "test:operations-rehearsal": "node ../tools/web/run-operations-rehearsal.mjs", + "test:deployment-cache": "npm run build && node ../tools/web/check-deployment-cache.mjs", + "test:archive-offline": "npm run build && node ../tools/web/create-offline-release.mjs && playwright test --config playwright.archive.config.ts", + "test:binary-archive": "node ../tools/web/check-binary-archive.mjs", + "test:source-archive": "node ../tools/web/check-source-archive.mjs", + "test:single-thread-unisolated": "playwright test --config playwright.single-thread.config.ts", + "test:pthread-engine": "playwright test --config playwright.config.ts tests/e2e/pthread-engine-isolated.spec.ts", + "test:pthread-fallback": "playwright test --config playwright.config.ts tests/e2e/pthread-fallback.spec.ts", "test:e2e": "playwright test --config playwright.config.ts", "test:capability-gates": "playwright test --config playwright.config.ts -g \"undeclared capability protocols\"", "test:simulation-cache": "playwright test --config playwright.config.ts -g \"Simulation caches\"", @@ -17,6 +36,7 @@ "test:network-interruption": "playwright test --config playwright.config.ts tests/e2e/network-interruption.spec.ts", "test:device-loss": "playwright test --config playwright.config.ts tests/e2e/device-loss.spec.ts", "test:oom-recovery": "playwright test --config playwright.config.ts tests/e2e/oom-recovery.spec.ts", + "test:storage-quota": "playwright test --config playwright.config.ts -g \"real OPFS quota\"", "test:texture-4k-performance": "playwright test --config playwright.config.ts tests/e2e/texture-4k-performance.spec.ts", "test:texture-8k-performance": "playwright test --config playwright.config.ts tests/e2e/texture-8k-performance.spec.ts", "test:physics-main-reader": "node ../tools/web/check-physics-main-reader.mjs", @@ -88,8 +108,19 @@ "test:v1-acceptance-evidence": "node ../tools/web/check-v1-acceptance-evidence.mjs", "test:v1-acceptance-release-binding": "node ../tools/web/check-v1-acceptance-release-binding.mjs", "test:status-consistency": "node ../tools/web/check-status-consistency.mjs", + "test:ci-report": "node ../tools/web/check-ci-report.mjs", + "test:ci-failure-report": "node ../tools/web/check-ci-failure-report.mjs", + "ci:quick": "node ../tools/web/run-ci-lane.mjs quick", + "ci:chromium": "node ../tools/web/run-ci-lane.mjs chromium", + "ci:release": "node ../tools/web/run-ci-lane.mjs release", "release:v1-acceptance": "node ../tools/web/run-v1-acceptance.mjs", "release:offline": "npm run build && node ../tools/web/check-offline-reproducibility.mjs", + "release:rc-manifest": "node ../tools/web/create-rc-manifest.mjs && node ../tools/web/check-rc-manifest.mjs", + "test:rc-manifest": "node ../tools/web/check-rc-manifest.mjs", + "test:rc-release-notes": "node ../tools/web/check-rc-release-notes.mjs", + "test:rc-known-limitations": "node ../tools/web/check-rc-known-limitations.mjs", + "test:rc-release-recovery": "node ../tools/web/check-rc-release-recovery.mjs", + "test:rc-docs": "npm run test:rc-release-notes && npm run test:rc-known-limitations && npm run test:rc-release-recovery", "diagnose:depsgraph": "node ../tools/web/diagnose-depsgraph.mjs" }, "dependencies": { diff --git a/web/playwright.archive.config.ts b/web/playwright.archive.config.ts new file mode 100644 index 00000000..0f6fa762 --- /dev/null +++ b/web/playwright.archive.config.ts @@ -0,0 +1,42 @@ +import path from "node:path"; +import { execFileSync } from "node:child_process"; +import { defineConfig, devices } from "@playwright/test"; + +function resolveChromePath(): string | undefined { + if (process.env.CHROME_PATH) return process.env.CHROME_PATH; + try { return execFileSync("which", ["google-chrome"], { encoding: "utf8" }).trim() || undefined; } + catch { return undefined; } +} + +const chromePath = resolveChromePath(); +const testPort = Number.parseInt(process.env.WEB_TEST_PORT ?? "5189", 10) || 5189; +const testOrigin = `http://127.0.0.1:${testPort}`; +const archive = path.resolve(process.env.M6_BINARY_ARCHIVE ?? "../release/blender-web-offline.tar.gz"); + +export default defineConfig({ + testDir: "tests/e2e", + testMatch: "archive-offline.spec.ts", + timeout: 180_000, + expect: { timeout: 30_000 }, + fullyParallel: false, + workers: 1, + reporter: [["list"]], + use: { + baseURL: testOrigin, + ...devices["Desktop Chrome"], + acceptDownloads: true, + headless: true, + launchOptions: { + ...(chromePath ? { executablePath: chromePath } : {}), + args: ["--no-sandbox", "--use-gl=swiftshader", "--enable-unsafe-swiftshader"], + }, + screenshot: "only-on-failure", + trace: "retain-on-failure", + }, + webServer: { + command: `node ../tools/web/archive-deployment-server.mjs --archive ${JSON.stringify(archive)} --port ${testPort}`, + url: testOrigin, + reuseExistingServer: false, + timeout: 60_000, + }, +}); diff --git a/web/playwright.config.ts b/web/playwright.config.ts index 0a47400d..ebe153ef 100644 --- a/web/playwright.config.ts +++ b/web/playwright.config.ts @@ -1,11 +1,19 @@ import { defineConfig, devices } from "@playwright/test"; +import { execFileSync } from "node:child_process"; -const chromePath = process.env.CHROME_PATH ?? "/home/mes123456/.local/bin/google-chrome"; +function resolveChromePath(): string | undefined { + if (process.env.CHROME_PATH) return process.env.CHROME_PATH; + try { return execFileSync("which", ["google-chrome"], { encoding: "utf8" }).trim() || undefined; } + catch { return undefined; } +} + +const chromePath = resolveChromePath(); const testPort = Number.parseInt(process.env.WEB_TEST_PORT ?? "5173", 10) || 5173; const testOrigin = `http://127.0.0.1:${testPort}`; export default defineConfig({ testDir: "tests/e2e", + testIgnore: ["archive-offline.spec.ts", "single-thread-unisolated.spec.ts"], timeout: 30_000, expect: { timeout: 10_000 }, fullyParallel: false, @@ -15,7 +23,7 @@ export default defineConfig({ ...devices["Desktop Chrome"], headless: true, launchOptions: { - executablePath: chromePath, + ...(chromePath ? { executablePath: chromePath } : {}), args: ["--no-sandbox", "--use-gl=swiftshader", "--enable-unsafe-swiftshader", "--enable-unsafe-webgpu", "--enable-dawn-features=allow_unsafe_apis", "--use-webgpu-adapter=swiftshader"], }, screenshot: "only-on-failure", diff --git a/web/playwright.release.config.ts b/web/playwright.release.config.ts index 457e3d92..08a1aa92 100644 --- a/web/playwright.release.config.ts +++ b/web/playwright.release.config.ts @@ -1,4 +1,13 @@ import { defineConfig, devices } from "@playwright/test"; +import { execFileSync } from "node:child_process"; + +function resolveChromePath(): string | undefined { + if (process.env.CHROME_PATH) return process.env.CHROME_PATH; + try { return execFileSync("which", ["google-chrome"], { encoding: "utf8" }).trim() || undefined; } + catch { return undefined; } +} + +const chromePath = resolveChromePath(); const testPort = Number.parseInt(process.env.WEB_TEST_PORT ?? "5174", 10) || 5174; const testOrigin = `http://127.0.0.1:${testPort}`; @@ -11,7 +20,7 @@ export default defineConfig({ fullyParallel: false, reporter: [["list"]], projects: [ - { name: "chromium", use: { ...devices["Desktop Chrome"], launchOptions: { executablePath: process.env.CHROME_PATH ?? "/home/mes123456/.local/bin/google-chrome", args: ["--no-sandbox", "--use-gl=swiftshader", "--enable-unsafe-swiftshader"] } } }, + { name: "chromium", use: { ...devices["Desktop Chrome"], launchOptions: { ...(chromePath ? { executablePath: chromePath } : {}), args: ["--no-sandbox", "--use-gl=swiftshader", "--enable-unsafe-swiftshader"] } } }, ], use: { baseURL: testOrigin, diff --git a/web/playwright.single-thread.config.ts b/web/playwright.single-thread.config.ts new file mode 100644 index 00000000..8e8ebdc7 --- /dev/null +++ b/web/playwright.single-thread.config.ts @@ -0,0 +1,39 @@ +import { defineConfig, devices } from "@playwright/test"; +import { execFileSync } from "node:child_process"; + +function resolveChromePath(): string | undefined { + if (process.env.CHROME_PATH) return process.env.CHROME_PATH; + try { return execFileSync("which", ["google-chrome"], { encoding: "utf8" }).trim() || undefined; } + catch { return undefined; } +} + +const chromePath = resolveChromePath(); +const testPort = Number.parseInt(process.env.WEB_TEST_PORT ?? "5202", 10) || 5202; +const testOrigin = `http://127.0.0.1:${testPort}`; + +export default defineConfig({ + testDir: "tests/e2e", + testMatch: "single-thread-unisolated.spec.ts", + timeout: 45_000, + expect: { timeout: 20_000 }, + fullyParallel: false, + reporter: [["list"]], + use: { + baseURL: testOrigin, + ...devices["Desktop Chrome"], + headless: true, + launchOptions: { + ...(chromePath ? { executablePath: chromePath } : {}), + args: ["--no-sandbox", "--use-gl=swiftshader", "--enable-unsafe-swiftshader"], + }, + screenshot: "only-on-failure", + trace: "retain-on-failure", + }, + webServer: { + command: `WEB_TEST_UNISOLATED_SINGLE_THREAD=1 npm run dev -- --host 127.0.0.1 --port ${testPort} --strictPort`, + cwd: import.meta.dirname, + url: testOrigin, + reuseExistingServer: false, + timeout: 30_000, + }, +}); diff --git a/web/protocol/dirty-state.ts b/web/protocol/dirty-state.ts new file mode 100644 index 00000000..efe334ee --- /dev/null +++ b/web/protocol/dirty-state.ts @@ -0,0 +1,53 @@ +export interface DirtyState { + currentMainRevision: number; + committedMainRevision: number; + dirty: boolean; +} + +export type DirtyStateResult = + | { ok: true; state: DirtyState } + | { ok: false; state: DirtyState; errorCode: "DIRTY_REVISION_INVALID" | "DIRTY_REVISION_STALE" | "DIRTY_SAVE_REVISION_MISMATCH" }; + +function validRevision(revision: number): boolean { + return Number.isSafeInteger(revision) && revision >= 0; +} + +export function createDirtyState(revision = 0): DirtyState { + if (!validRevision(revision)) throw new Error("DIRTY_REVISION_INVALID"); + return { currentMainRevision: revision, committedMainRevision: revision, dirty: false }; +} + +export function recoverDirtyState(currentMainRevision: number, committedMainRevision: number): DirtyState { + if (!validRevision(currentMainRevision) || !validRevision(committedMainRevision) || currentMainRevision < committedMainRevision) { + throw new Error("DIRTY_REVISION_INVALID"); + } + return { currentMainRevision, committedMainRevision, dirty: currentMainRevision !== committedMainRevision }; +} + +export function acceptMainTransaction(state: DirtyState, revision: number): DirtyStateResult { + if (!validRevision(revision)) return { ok: false, state, errorCode: "DIRTY_REVISION_INVALID" }; + if (revision <= state.currentMainRevision) return { ok: false, state, errorCode: "DIRTY_REVISION_STALE" }; + return { + ok: true, + state: { ...state, currentMainRevision: revision, dirty: revision !== state.committedMainRevision }, + }; +} + +export function acceptMainSave(state: DirtyState, revision: number): DirtyStateResult { + if (!validRevision(revision)) return { ok: false, state, errorCode: "DIRTY_REVISION_INVALID" }; + if (revision !== state.currentMainRevision) return { ok: false, state, errorCode: "DIRTY_SAVE_REVISION_MISMATCH" }; + return { ok: true, state: { currentMainRevision: revision, committedMainRevision: revision, dirty: false } }; +} + +export function acceptHistoryTransaction(state: DirtyState, revision: number, matchesCommittedContent: boolean): DirtyStateResult { + if (!validRevision(revision)) return { ok: false, state, errorCode: "DIRTY_REVISION_INVALID" }; + if (revision <= state.currentMainRevision) return { ok: false, state, errorCode: "DIRTY_REVISION_STALE" }; + return { + ok: true, + state: { + currentMainRevision: revision, + committedMainRevision: matchesCommittedContent ? revision : state.committedMainRevision, + dirty: !matchesCommittedContent, + }, + }; +} diff --git a/web/protocol/engine-variant.ts b/web/protocol/engine-variant.ts new file mode 100644 index 00000000..e5130573 --- /dev/null +++ b/web/protocol/engine-variant.ts @@ -0,0 +1,96 @@ +import { blockedGate, capabilityIssue, readyGate, type CapabilityGateResult } from "./capability-gates"; +import type { WebEngineManifestV2, WebEngineVariantV2 } from "./manifest"; + +export interface WasmThreadingCapabilities { + crossOriginIsolated: boolean; + sharedArrayBuffer: boolean; + worker: boolean; +} + +export type WebEngineVariantPolicy = "AUTO" | "SINGLE_REQUIRED" | "PTHREAD_REQUIRED"; + +export interface WebEngineVariantSelection { + policy: WebEngineVariantPolicy; + selectedVariant: WebEngineVariantV2 | null; + pthreadGate: CapabilityGateResult; +} + +export type WebEngineReleaseBinding = + | { status: "READY"; releaseId: string; manifest: WebEngineManifestV2 } + | { + status: "REFRESH_REQUIRED"; + expectedReleaseId: string; + actualReleaseId: string; + manifest: null; + }; + +export function bindWebEngineRelease( + expectedReleaseId: string, + manifest: WebEngineManifestV2, +): WebEngineReleaseBinding { + if (manifest.releaseId === expectedReleaseId) { + return { status: "READY", releaseId: manifest.releaseId, manifest }; + } + return { + status: "REFRESH_REQUIRED", + expectedReleaseId, + actualReleaseId: manifest.releaseId, + manifest: null, + }; +} + +export function gateWasmThreadingCapability(capabilities: WasmThreadingCapabilities): CapabilityGateResult { + const issues = []; + if (!capabilities.crossOriginIsolated) { + issues.push(capabilityIssue( + "PLATFORM_CAPABILITY_UNAVAILABLE", + "Cross-origin isolation is required for the pthread WASM engine", + "crossOriginIsolated", + )); + } + if (!capabilities.sharedArrayBuffer) { + issues.push(capabilityIssue( + "PLATFORM_CAPABILITY_UNAVAILABLE", + "SharedArrayBuffer is required for the pthread WASM engine", + "sharedArrayBuffer", + )); + } + if (!capabilities.worker) { + issues.push(capabilityIssue( + "PLATFORM_CAPABILITY_UNAVAILABLE", + "Worker is required for the pthread WASM engine", + "worker", + )); + } + return issues.length > 0 + ? blockedGate("M6-02", "WASM_PTHREAD_ENGINE", issues) + : readyGate("M6-02", "WASM_PTHREAD_ENGINE"); +} + +export function selectWebEngineVariant( + manifest: WebEngineManifestV2, + policy: WebEngineVariantPolicy, + capabilities: WasmThreadingCapabilities, +): WebEngineVariantSelection { + const single = manifest.variants.find((variant) => variant.id === "single"); + const pthread = manifest.variants.find((variant) => variant.id === "pthread"); + if (!single || !pthread) throw new Error("ENGINE_MANIFEST_VARIANTS_MISSING"); + + const pthreadGate = gateWasmThreadingCapability(capabilities); + if (policy === "SINGLE_REQUIRED") return { policy, selectedVariant: single, pthreadGate }; + if (policy === "AUTO") { + return { + policy, + selectedVariant: pthreadGate.status === "READY" ? pthread : single, + pthreadGate, + }; + } + if (policy === "PTHREAD_REQUIRED") { + return { + policy, + selectedVariant: pthreadGate.status === "READY" ? pthread : null, + pthreadGate, + }; + } + throw new Error("ENGINE_VARIANT_POLICY_INVALID"); +} diff --git a/web/protocol/error.ts b/web/protocol/error.ts index fde62061..4f6775dc 100644 --- a/web/protocol/error.ts +++ b/web/protocol/error.ts @@ -8,6 +8,7 @@ export type ErrorCode = | "WASM_INIT_FAILED" | "WASM_OUT_OF_MEMORY" | "BLEND_READ_FAILED" + | "OPEN_CANCELLED" | "BLEND_WRITE_FAILED" | "STORAGE_QUOTA" | "STORAGE_TRANSACTION" diff --git a/web/protocol/file-byte-reader.ts b/web/protocol/file-byte-reader.ts new file mode 100644 index 00000000..e7e8a663 --- /dev/null +++ b/web/protocol/file-byte-reader.ts @@ -0,0 +1,132 @@ +export const LARGE_FILE_IMPORT_BYTES = 512 * 1024; +export const DEFAULT_FILE_READ_PROGRESS_CHUNK_BYTES = 1024 * 1024; +export const DEFAULT_FILE_READ_YIELD_BYTES = 4 * 1024 * 1024; + +export type FileReadPhase = "STARTED" | "READING" | "COMPLETED" | "CANCELLED"; + +export interface FileReadProgress { + phase: FileReadPhase; + bytesRead: number; + totalBytes: number; + fraction: number; +} + +export interface FileByteSource { + readonly size: number; + stream(): ReadableStream; +} + +export interface FileByteReadOptions { + signal: AbortSignal; + onProgress?: (progress: FileReadProgress) => void; + onResourceState?: (state: FileByteReadResourceState) => void; + yieldControl?: () => Promise; + progressChunkBytes?: number; + yieldEveryBytes?: number; +} + +export interface FileByteReadResourceState { + liveReaders: number; + liveInputBytes: number; + liveStagingFiles: number; +} + +export type FileByteReadErrorCode = + | "FILE_READ_CANCELLED" + | "FILE_READ_ALLOCATION_FAILED" + | "FILE_READ_SIZE_MISMATCH"; + +export class FileByteReadError extends Error { + readonly code: FileByteReadErrorCode; + + constructor(code: FileByteReadErrorCode, message: string) { + super(`${code}: ${message}`); + this.name = "FileByteReadError"; + this.code = code; + } +} + +function progress(phase: FileReadPhase, bytesRead: number, totalBytes: number): FileReadProgress { + return { + phase, + bytesRead, + totalBytes, + fraction: totalBytes === 0 ? (phase === "COMPLETED" ? 1 : 0) : bytesRead / totalBytes, + }; +} + +export async function readFileBytes(source: FileByteSource, options: FileByteReadOptions): Promise { + const { signal, onProgress, onResourceState, yieldControl } = options; + const totalBytes = source.size; + const progressChunkBytes = options.progressChunkBytes ?? DEFAULT_FILE_READ_PROGRESS_CHUNK_BYTES; + const yieldEveryBytes = options.yieldEveryBytes ?? DEFAULT_FILE_READ_YIELD_BYTES; + if (!Number.isSafeInteger(totalBytes) || totalBytes < 0) { + throw new FileByteReadError("FILE_READ_SIZE_MISMATCH", "file size is not a non-negative safe integer"); + } + if (!Number.isSafeInteger(progressChunkBytes) || progressChunkBytes <= 0 || !Number.isSafeInteger(yieldEveryBytes) || yieldEveryBytes <= 0) { + throw new FileByteReadError("FILE_READ_SIZE_MISMATCH", "progress or yield byte interval is invalid"); + } + + let outputBuffer: ArrayBuffer; + try { + outputBuffer = new ArrayBuffer(totalBytes); + } + catch { + throw new FileByteReadError("FILE_READ_ALLOCATION_FAILED", `could not allocate ${totalBytes} bytes`); + } + const output = new Uint8Array(outputBuffer); + + const reader = source.stream().getReader(); + onResourceState?.({ liveReaders: 1, liveInputBytes: totalBytes, liveStagingFiles: 0 }); + let bytesRead = 0; + let nextYield = yieldEveryBytes; + let aborted = signal.aborted; + let completed = false; + const abort = (): void => { + aborted = true; + void reader.cancel("FILE_READ_CANCELLED").catch(() => undefined); + }; + signal.addEventListener("abort", abort, { once: true }); + onProgress?.(progress("STARTED", 0, totalBytes)); + + try { + while (true) { + if (aborted) throw new FileByteReadError("FILE_READ_CANCELLED", `cancelled after ${bytesRead} bytes`); + const { done, value } = await reader.read(); + if (aborted) throw new FileByteReadError("FILE_READ_CANCELLED", `cancelled after ${bytesRead} bytes`); + if (done) break; + if (!value || bytesRead + value.byteLength > totalBytes) { + throw new FileByteReadError("FILE_READ_SIZE_MISMATCH", "stream exceeded the declared file size"); + } + for (let offset = 0; offset < value.byteLength; offset += progressChunkBytes) { + if (aborted) throw new FileByteReadError("FILE_READ_CANCELLED", `cancelled after ${bytesRead} bytes`); + const chunk = value.subarray(offset, Math.min(value.byteLength, offset + progressChunkBytes)); + output.set(chunk, bytesRead); + bytesRead += chunk.byteLength; + onProgress?.(progress("READING", bytesRead, totalBytes)); + if (yieldControl && bytesRead >= nextYield && bytesRead < totalBytes) { + nextYield = bytesRead + yieldEveryBytes; + await yieldControl(); + } + } + } + if (bytesRead !== totalBytes) { + throw new FileByteReadError("FILE_READ_SIZE_MISMATCH", `stream ended at ${bytesRead} of ${totalBytes} bytes`); + } + onProgress?.(progress("COMPLETED", bytesRead, totalBytes)); + completed = true; + return outputBuffer; + } + catch (error) { + if (error instanceof FileByteReadError && error.code === "FILE_READ_CANCELLED") { + onProgress?.(progress("CANCELLED", bytesRead, totalBytes)); + } + throw error; + } + finally { + signal.removeEventListener("abort", abort); + reader.releaseLock(); + if (!completed) output.fill(0); + onResourceState?.({ liveReaders: 0, liveInputBytes: 0, liveStagingFiles: 0 }); + } +} diff --git a/web/protocol/manifest.ts b/web/protocol/manifest.ts index 62706322..c0bfe5b6 100644 --- a/web/protocol/manifest.ts +++ b/web/protocol/manifest.ts @@ -19,26 +19,256 @@ export interface WebEngineManifest { wasm: WasmResource[]; } -export async function loadWebEngineManifest(url = "/engine-manifest.json"): Promise { - const response = await fetch(url, { cache: "no-store" }); - if (!response.ok) throw new Error(`Engine manifest request failed: ${response.status}`); - const manifest = await response.json() as Partial; - if (manifest.schemaVersion !== 1 || manifest.protocolVersion !== 1) { - throw new Error("Unsupported engine manifest version"); - } - if (!manifest.engine || !manifest.memory || !Array.isArray(manifest.wasm)) { - throw new Error("Invalid engine manifest shape"); - } - return manifest as WebEngineManifest; +export const WEB_ENGINE_MANIFEST_V2_SCHEMA = 2 as const; +export const WEB_ENGINE_WASM_PAGE_BYTES = 65_536 as const; +export const WEB_ENGINE_MEMORY_LIMITS = { + minimumInitialPages: 256, + maximumPages: 32_768, +} as const; + +export type WebEngineVariantId = "single" | "pthread"; + +export interface WebEngineVariantResourceV2 { + fileName: string; + url: string; + sha256: string; } -export async function verifyWasmResource(resource: WasmResource): Promise { +export interface WebEngineVariantMemoryV2 { + initialPages: number; + maximumPages: number; + shared: Shared; +} + +export interface WebEngineSingleVariantV2 { + id: "single"; + memory: WebEngineVariantMemoryV2; + resources: { + js: WebEngineVariantResourceV2; + wasm: WebEngineVariantResourceV2; + pthreadWorker?: never; + }; +} + +export interface WebEnginePthreadVariantV2 { + id: "pthread"; + memory: WebEngineVariantMemoryV2; + resources: { + js: WebEngineVariantResourceV2; + wasm: WebEngineVariantResourceV2; + pthreadWorker: WebEngineVariantResourceV2; + }; +} + +export type WebEngineVariantV2 = WebEngineSingleVariantV2 | WebEnginePthreadVariantV2; + +export interface WebEngineManifestV2 { + schemaVersion: typeof WEB_ENGINE_MANIFEST_V2_SCHEMA; + protocolVersion: 1; + releaseId: string; + engineVersion: string; + engine: "blender-wasm"; + variants: [WebEngineSingleVariantV2, WebEnginePthreadVariantV2]; +} + +export type LoadedWebEngineManifest = WebEngineManifest | WebEngineManifestV2; + +export type WebEngineManifestValidationCode = "PROTOCOL_MISMATCH" | "ENGINE_MANIFEST_INVALID"; + +export class WebEngineManifestValidationError extends Error { + readonly code: WebEngineManifestValidationCode; + readonly path?: string; + + constructor(code: WebEngineManifestValidationCode, message: string, path?: string) { + super(message); + this.name = "WebEngineManifestValidationError"; + this.code = code; + this.path = path; + } +} + +const SHA256 = /^[a-f0-9]{64}$/; +const FILE_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/; +const ENGINE_VERSION = /^[A-Za-z0-9][A-Za-z0-9._+-]{0,127}$/; + +function record(value: unknown): value is Record { + return typeof value === "object" && value !== null && !Array.isArray(value); +} + +function fail(code: WebEngineManifestValidationCode, message: string, path?: string): never { + throw new WebEngineManifestValidationError(code, message, path); +} + +function exactKeys(value: Record, allowed: readonly string[], path: string): void { + const allowedKeys = new Set(allowed); + const unexpected = Object.keys(value).find((key) => !allowedKeys.has(key)); + if (unexpected) fail("ENGINE_MANIFEST_INVALID", `${path}.${unexpected} is not allowed`, `${path}.${unexpected}`); +} + +function boundedText(value: unknown, path: string, pattern: RegExp): string { + if (typeof value !== "string" || !pattern.test(value)) { + fail("ENGINE_MANIFEST_INVALID", `${path} is invalid`, path); + } + return value; +} + +function parseResource( + value: unknown, + path: string, + extension: ".js" | ".wasm", +): WebEngineVariantResourceV2 { + if (!record(value)) fail("ENGINE_MANIFEST_INVALID", `${path} is required`, path); + exactKeys(value, ["fileName", "url", "sha256"], path); + const fileName = boundedText(value.fileName, `${path}.fileName`, FILE_NAME); + if (!fileName.endsWith(extension)) { + fail("ENGINE_MANIFEST_INVALID", `${path}.fileName must end with ${extension}`, `${path}.fileName`); + } + if (typeof value.url !== "string" || !value.url.startsWith("/") || /[?#\\\\]/.test(value.url)) { + fail("ENGINE_MANIFEST_INVALID", `${path}.url must be a root-relative URL`, `${path}.url`); + } + const segments = value.url.slice(1).split("/"); + if (segments.length === 0 || segments.some((segment) => !FILE_NAME.test(segment) || segment === "." || segment === "..")) { + fail("ENGINE_MANIFEST_INVALID", `${path}.url contains an invalid path segment`, `${path}.url`); + } + if (segments.at(-1) !== fileName) { + fail("ENGINE_MANIFEST_INVALID", `${path}.url must end with fileName`, `${path}.url`); + } + const sha256 = boundedText(value.sha256, `${path}.sha256`, SHA256); + return { fileName, url: value.url, sha256 }; +} + +function parseMemory(value: unknown, id: WebEngineVariantId, path: string): WebEngineVariantMemoryV2 { + if (!record(value)) fail("ENGINE_MANIFEST_INVALID", `${path} is required`, path); + exactKeys(value, ["initialPages", "maximumPages", "shared"], path); + const { initialPages, maximumPages, shared } = value; + if (!Number.isSafeInteger(initialPages) || + (initialPages as number) < WEB_ENGINE_MEMORY_LIMITS.minimumInitialPages || + (initialPages as number) > WEB_ENGINE_MEMORY_LIMITS.maximumPages) { + fail("ENGINE_MANIFEST_INVALID", `${path}.initialPages is outside the supported range`, `${path}.initialPages`); + } + if (!Number.isSafeInteger(maximumPages) || + (maximumPages as number) < (initialPages as number) || + (maximumPages as number) > WEB_ENGINE_MEMORY_LIMITS.maximumPages) { + fail("ENGINE_MANIFEST_INVALID", `${path}.maximumPages is outside the supported range`, `${path}.maximumPages`); + } + if (shared !== (id === "pthread")) { + fail("ENGINE_MANIFEST_INVALID", `${path}.shared must be ${id === "pthread"}`, `${path}.shared`); + } + return { initialPages: initialPages as number, maximumPages: maximumPages as number, shared }; +} + +function parseVariant(value: unknown, index: number): WebEngineVariantV2 { + const path = `variants[${index}]`; + if (!record(value)) fail("ENGINE_MANIFEST_INVALID", `${path} is invalid`, path); + exactKeys(value, ["id", "memory", "resources"], path); + if (value.id !== "single" && value.id !== "pthread") { + fail("ENGINE_MANIFEST_INVALID", `${path}.id is invalid`, `${path}.id`); + } + const id = value.id; + if (!record(value.resources)) fail("ENGINE_MANIFEST_INVALID", `${path}.resources is required`, `${path}.resources`); + const resourcePath = `${path}.resources`; + exactKeys(value.resources, id === "pthread" ? ["js", "wasm", "pthreadWorker"] : ["js", "wasm"], resourcePath); + if (id === "pthread" && value.resources.pthreadWorker === undefined) { + fail("ENGINE_MANIFEST_INVALID", `${resourcePath}.pthreadWorker is required`, `${resourcePath}.pthreadWorker`); + } + const js = parseResource(value.resources.js, `${resourcePath}.js`, ".js"); + const wasm = parseResource(value.resources.wasm, `${resourcePath}.wasm`, ".wasm"); + const memory = parseMemory(value.memory, id, `${path}.memory`); + if (id === "pthread") { + const pthreadWorker = parseResource( + value.resources.pthreadWorker, + `${resourcePath}.pthreadWorker`, + ".js", + ); + return { id, memory: { ...memory, shared: true }, resources: { js, wasm, pthreadWorker } }; + } + return { id, memory: { ...memory, shared: false }, resources: { js, wasm } }; +} + +export function validateWebEngineManifestV2(value: unknown): WebEngineManifestV2 { + if (!record(value) || value.schemaVersion !== WEB_ENGINE_MANIFEST_V2_SCHEMA) { + fail("PROTOCOL_MISMATCH", "Unsupported engine manifest schema", "schemaVersion"); + } + exactKeys(value, ["schemaVersion", "protocolVersion", "releaseId", "engineVersion", "engine", "variants"], "manifest"); + if (value.protocolVersion !== 1) { + fail("PROTOCOL_MISMATCH", "Unsupported WebEngine protocol version", "protocolVersion"); + } + if (value.engine !== "blender-wasm") { + fail("ENGINE_MANIFEST_INVALID", "engine must be blender-wasm", "engine"); + } + const engineVersion = boundedText(value.engineVersion, "engineVersion", ENGINE_VERSION); + const releaseId = boundedText(value.releaseId, "releaseId", ENGINE_VERSION); + if (!Array.isArray(value.variants) || value.variants.length !== 2) { + fail("ENGINE_MANIFEST_INVALID", "variants must contain exactly single and pthread", "variants"); + } + const variants = value.variants.map(parseVariant); + const byId = new Map(variants.map((variant) => [variant.id, variant])); + if (byId.size !== 2 || !byId.has("single") || !byId.has("pthread")) { + fail("ENGINE_MANIFEST_INVALID", "variants must contain exactly one single and one pthread", "variants"); + } + const single = byId.get("single") as WebEngineSingleVariantV2; + const pthread = byId.get("pthread") as WebEnginePthreadVariantV2; + for (const role of ["js", "wasm"] as const) { + if (single.resources[role].url === pthread.resources[role].url) { + fail( + "ENGINE_MANIFEST_INVALID", + `single and pthread ${role} resources must have distinct URLs`, + `variants.${role}`, + ); + } + } + if (pthread.resources.pthreadWorker.url === single.resources.js.url) { + fail( + "ENGINE_MANIFEST_INVALID", + "pthread worker must not alias the single JS resource", + "variants.pthreadWorker", + ); + } + if (pthread.resources.pthreadWorker.url === pthread.resources.js.url && + pthread.resources.pthreadWorker.sha256 !== pthread.resources.js.sha256) { + fail( + "ENGINE_MANIFEST_INVALID", + "resources that share a URL must share the same SHA-256", + "variants.pthreadWorker.sha256", + ); + } + return { + schemaVersion: WEB_ENGINE_MANIFEST_V2_SCHEMA, + protocolVersion: 1, + releaseId, + engineVersion, + engine: "blender-wasm", + variants: [single, pthread], + }; +} + +export async function loadWebEngineManifest(url = "/engine-manifest.json"): Promise { + const response = await fetch(url, { cache: "no-store" }); + if (!response.ok) throw new Error(`Engine manifest request failed: ${response.status}`); + const manifest = await response.json() as unknown; + if (record(manifest) && manifest.schemaVersion === WEB_ENGINE_MANIFEST_V2_SCHEMA) { + return validateWebEngineManifestV2(manifest); + } + const legacyManifest = manifest as Partial; + if (legacyManifest.schemaVersion !== 1 || legacyManifest.protocolVersion !== 1) { + throw new Error("Unsupported engine manifest version"); + } + if (!legacyManifest.engine || !legacyManifest.memory || !Array.isArray(legacyManifest.wasm)) { + throw new Error("Invalid engine manifest shape"); + } + return legacyManifest as WebEngineManifest; +} + +export async function verifyWasmResource( + resource: Pick & Partial>, +): Promise { const response = await fetch(resource.url, { cache: "no-store" }); - if (!response.ok) throw new Error(`WASM resource request failed: ${resource.id}`); + const resourceId = resource.id ?? resource.url; + if (!response.ok) throw new Error(`WASM resource request failed: ${resourceId}`); const bytes = await response.arrayBuffer(); const digest = await crypto.subtle.digest("SHA-256", bytes); const actual = [...new Uint8Array(digest)].map((byte) => byte.toString(16).padStart(2, "0")).join(""); if (actual !== resource.sha256.toLowerCase()) { - throw new Error(`WASM resource hash mismatch: ${resource.id}`); + throw new Error(`WASM resource hash mismatch: ${resourceId}`); } } diff --git a/web/protocol/progress.ts b/web/protocol/progress.ts index ced112d5..a99ba304 100644 --- a/web/protocol/progress.ts +++ b/web/protocol/progress.ts @@ -5,7 +5,11 @@ export interface ProgressEvent { operation: string; phase: ProgressPhase; fraction?: number; + bytesRead?: number; + totalBytes?: number; message?: string; revision?: number; errorCode?: string; + stage?: string; + cancellable?: boolean; } diff --git a/web/protocol/project-action-mutex.ts b/web/protocol/project-action-mutex.ts new file mode 100644 index 00000000..eadee444 --- /dev/null +++ b/web/protocol/project-action-mutex.ts @@ -0,0 +1,79 @@ +export const PROJECT_ACTION_KINDS = ["OPEN", "SAVE", "CLOSE"] as const; +export type ProjectActionKind = typeof PROJECT_ACTION_KINDS[number]; + +export interface ProjectActionIdentity { + actionId: string; + kind: ProjectActionKind; +} + +export interface ProjectActionMutexState { + owner: ProjectActionIdentity | null; +} + +export type ProjectActionConflictReason = + | "REPEATED_OPEN" + | "CONCURRENT_SAVE" + | "CLOSE_DURING_SAVE" + | "PROJECT_ACTION_EXCLUSIVE"; + +export interface ProjectActionConflict { + code: "USER_ACTION_CONFLICT"; + reason: ProjectActionConflictReason; + requested: ProjectActionIdentity; + owner: ProjectActionIdentity; +} + +export type ProjectActionAcquireResult = + | { granted: true; state: ProjectActionMutexState; conflict: null } + | { granted: false; state: ProjectActionMutexState; conflict: ProjectActionConflict }; + +export type ProjectActionReleaseResult = + | { released: true; state: ProjectActionMutexState; errorCode: null } + | { + released: false; + state: ProjectActionMutexState; + errorCode: "PROJECT_ACTION_LOCK_NOT_HELD" | "PROJECT_ACTION_LOCK_IDENTITY_MISMATCH"; + }; + +export const PROJECT_ACTION_CONFLICT_MATRIX: Readonly>>> = { + OPEN: { OPEN: true, SAVE: true, CLOSE: true }, + SAVE: { OPEN: true, SAVE: true, CLOSE: true }, + CLOSE: { OPEN: true, SAVE: true, CLOSE: true }, +}; + +export function createProjectActionMutexState(): ProjectActionMutexState { + return { owner: null }; +} + +function conflictReason(requested: ProjectActionKind, owner: ProjectActionKind): ProjectActionConflictReason { + if (requested === "OPEN" && owner === "OPEN") return "REPEATED_OPEN"; + if (requested === "SAVE" && owner === "SAVE") return "CONCURRENT_SAVE"; + if (requested === "CLOSE" && owner === "SAVE") return "CLOSE_DURING_SAVE"; + return "PROJECT_ACTION_EXCLUSIVE"; +} + +export function acquireProjectAction(state: ProjectActionMutexState, requested: ProjectActionIdentity): ProjectActionAcquireResult { + const owner = state.owner; + if (!owner) return { granted: true, state: { owner: requested }, conflict: null }; + if (!PROJECT_ACTION_CONFLICT_MATRIX[requested.kind][owner.kind]) { + return { granted: true, state: { owner: requested }, conflict: null }; + } + return { + granted: false, + state, + conflict: { + code: "USER_ACTION_CONFLICT", + reason: conflictReason(requested.kind, owner.kind), + requested, + owner, + }, + }; +} + +export function releaseProjectAction(state: ProjectActionMutexState, identity: ProjectActionIdentity): ProjectActionReleaseResult { + if (!state.owner) return { released: false, state, errorCode: "PROJECT_ACTION_LOCK_NOT_HELD" }; + if (state.owner.kind !== identity.kind || state.owner.actionId !== identity.actionId) { + return { released: false, state, errorCode: "PROJECT_ACTION_LOCK_IDENTITY_MISMATCH" }; + } + return { released: true, state: createProjectActionMutexState(), errorCode: null }; +} diff --git a/web/protocol/save-transaction.ts b/web/protocol/save-transaction.ts new file mode 100644 index 00000000..c9b4e22b --- /dev/null +++ b/web/protocol/save-transaction.ts @@ -0,0 +1,81 @@ +export const SAVE_ATTEMPT_STAGES = ["SERIALIZE", "OPFS_STAGE", "SCENE_COMMIT", "METADATA_COMMIT"] as const; +export type SaveAttemptStage = typeof SAVE_ATTEMPT_STAGES[number]; + +export interface SaveCommitIdentity { + revision: number; + sha256: string | null; +} + +export interface SaveTransactionState { + status: "IDLE" | "RUNNING" | "SUCCEEDED" | "FAILED"; + stage: SaveAttemptStage | null; + committed: SaveCommitIdentity; + candidate: SaveCommitIdentity | null; + errorCode: string | null; +} + +export type SaveTransactionResult = + | { ok: true; state: SaveTransactionState } + | { ok: false; state: SaveTransactionState; errorCode: "SAVE_TRANSACTION_INVALID_TRANSITION" | "SAVE_TRANSACTION_COMMIT_MISMATCH" }; + +const SHA256 = /^[a-f0-9]{64}$/; + +function validIdentity(identity: SaveCommitIdentity, allowNullHash: boolean): boolean { + return Number.isSafeInteger(identity.revision) && identity.revision >= 0 && + (allowNullHash ? identity.sha256 === null || SHA256.test(identity.sha256) : typeof identity.sha256 === "string" && SHA256.test(identity.sha256)); +} + +export function createSaveTransactionState(committed: SaveCommitIdentity): SaveTransactionState { + if (!validIdentity(committed, true)) throw new Error("SAVE_TRANSACTION_COMMIT_INVALID"); + return { status: "IDLE", stage: null, committed, candidate: null, errorCode: null }; +} + +export function beginSaveTransaction(state: SaveTransactionState, targetRevision: number): SaveTransactionResult { + if (state.status === "RUNNING" || !Number.isSafeInteger(targetRevision) || targetRevision < state.committed.revision) { + return { ok: false, state, errorCode: "SAVE_TRANSACTION_INVALID_TRANSITION" }; + } + return { + ok: true, + state: { + status: "RUNNING", + stage: "SERIALIZE", + committed: state.committed, + candidate: { revision: targetRevision, sha256: null }, + errorCode: null, + }, + }; +} + +export function advanceSaveTransaction(state: SaveTransactionState, stage: SaveAttemptStage, candidateSha256?: string): SaveTransactionResult { + if (state.status !== "RUNNING" || !state.stage || !state.candidate) { + return { ok: false, state, errorCode: "SAVE_TRANSACTION_INVALID_TRANSITION" }; + } + const currentIndex = SAVE_ATTEMPT_STAGES.indexOf(state.stage); + const nextIndex = SAVE_ATTEMPT_STAGES.indexOf(stage); + if (nextIndex !== currentIndex + 1 || (stage === "OPFS_STAGE" && (!candidateSha256 || !SHA256.test(candidateSha256)))) { + return { ok: false, state, errorCode: "SAVE_TRANSACTION_INVALID_TRANSITION" }; + } + return { + ok: true, + state: { + ...state, + stage, + candidate: stage === "OPFS_STAGE" ? { ...state.candidate, sha256: candidateSha256! } : state.candidate, + }, + }; +} + +export function failSaveTransaction(state: SaveTransactionState, errorCode: string): SaveTransactionState { + if (state.status !== "RUNNING" || !/^[A-Z][A-Z0-9_]*$/.test(errorCode)) return state; + return { ...state, status: "FAILED", errorCode }; +} + +export function commitSaveTransaction(state: SaveTransactionState, persisted: SaveCommitIdentity): SaveTransactionResult { + if (state.status !== "RUNNING" || state.stage !== "METADATA_COMMIT" || !state.candidate || !validIdentity(persisted, false)) { + return { ok: false, state, errorCode: "SAVE_TRANSACTION_INVALID_TRANSITION" }; + } + if (persisted.revision !== state.candidate.revision || persisted.sha256 !== state.candidate.sha256) { + return { ok: false, state, errorCode: "SAVE_TRANSACTION_COMMIT_MISMATCH" }; + } + return { ok: true, state: { status: "SUCCEEDED", stage: "METADATA_COMMIT", committed: persisted, candidate: persisted, errorCode: null } }; +} diff --git a/web/protocol/storage.ts b/web/protocol/storage.ts index 3d0932b1..b6551e9d 100644 --- a/web/protocol/storage.ts +++ b/web/protocol/storage.ts @@ -192,7 +192,7 @@ export interface StorageRequest { | { type: "smoke" } | { type: "info" } | { type: "ensureProject"; projectId: string } - | { type: "saveProject"; projectId: string; revision: number; buffer: ArrayBuffer; faultAt?: "after-stage" | "after-scene-commit" | "quota" } + | { type: "saveProject"; projectId: string; revision: number; buffer: ArrayBuffer; faultAt?: "after-stage" | "after-scene-commit" | "before-metadata-commit" | "quota" } | { type: "recoverProject"; projectId: string } | { type: "readProject"; projectId: string } | { type: "appendOperation"; id: string; projectId: string; revision: number; payload: unknown; inversePayload?: unknown } diff --git a/web/protocol/user-action-state.ts b/web/protocol/user-action-state.ts new file mode 100644 index 00000000..b14141e5 --- /dev/null +++ b/web/protocol/user-action-state.ts @@ -0,0 +1,109 @@ +export const USER_ACTION_KINDS = ["IMPORT", "OPEN", "SAVE", "SAVE_AS", "EXPORT"] as const; +export type UserActionKind = typeof USER_ACTION_KINDS[number]; + +export const USER_ACTION_STATUSES = ["IDLE", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED"] as const; +export type UserActionStatus = typeof USER_ACTION_STATUSES[number]; + +export interface UserActionIdentity { + actionId: string; + kind: UserActionKind; +} + +export interface UserActionState { + kind: UserActionKind; + status: UserActionStatus; + identity: UserActionIdentity | null; + errorCode: string | null; +} + +export type UserActionEvent = + | { type: "START"; identity: UserActionIdentity } + | { type: "SUCCEED"; identity: UserActionIdentity } + | { type: "FAIL"; identity: UserActionIdentity; errorCode: string } + | { type: "CANCEL"; identity: UserActionIdentity; errorCode?: string } + | { type: "RESET"; kind: UserActionKind }; + +export type UserActionTransitionErrorCode = + | "USER_ACTION_KIND_MISMATCH" + | "USER_ACTION_IDENTITY_MISMATCH" + | "USER_ACTION_IDENTITY_REUSED" + | "USER_ACTION_INVALID_ERROR_CODE" + | "USER_ACTION_INVALID_TRANSITION"; + +export type UserActionTransitionResult = + | { ok: true; state: UserActionState } + | { ok: false; state: UserActionState; errorCode: UserActionTransitionErrorCode }; + +export type UserActionStates = Record; + +export const USER_ACTION_ALLOWED_TRANSITIONS: Readonly> = { + IDLE: ["RUNNING"], + RUNNING: ["SUCCEEDED", "FAILED", "CANCELLED"], + SUCCEEDED: ["IDLE", "RUNNING"], + FAILED: ["IDLE", "RUNNING"], + CANCELLED: ["IDLE", "RUNNING"], +}; + +function idleState(kind: UserActionKind): UserActionState { + return { kind, status: "IDLE", identity: null, errorCode: null }; +} + +export function createInitialUserActionStates(): UserActionStates { + return Object.fromEntries(USER_ACTION_KINDS.map((kind) => [kind, idleState(kind)])) as UserActionStates; +} + +function rejected(state: UserActionState, errorCode: UserActionTransitionErrorCode): UserActionTransitionResult { + return { ok: false, state, errorCode }; +} + +function isStableErrorCode(value: string): boolean { + return /^[A-Z][A-Z0-9_]*$/.test(value); +} + +export function transitionUserAction(state: UserActionState, event: UserActionEvent): UserActionTransitionResult { + if (event.type === "RESET") { + if (event.kind !== state.kind) return rejected(state, "USER_ACTION_KIND_MISMATCH"); + if (!USER_ACTION_ALLOWED_TRANSITIONS[state.status].includes("IDLE")) { + return rejected(state, "USER_ACTION_INVALID_TRANSITION"); + } + return { ok: true, state: idleState(state.kind) }; + } + + if (event.identity.kind !== state.kind) return rejected(state, "USER_ACTION_KIND_MISMATCH"); + if (!event.identity.actionId) return rejected(state, "USER_ACTION_IDENTITY_MISMATCH"); + + if (event.type === "START") { + if (!USER_ACTION_ALLOWED_TRANSITIONS[state.status].includes("RUNNING")) { + return rejected(state, "USER_ACTION_INVALID_TRANSITION"); + } + if (state.identity?.actionId === event.identity.actionId) { + return rejected(state, "USER_ACTION_IDENTITY_REUSED"); + } + return { + ok: true, + state: { kind: state.kind, status: "RUNNING", identity: event.identity, errorCode: null }, + }; + } + + if (state.status !== "RUNNING") return rejected(state, "USER_ACTION_INVALID_TRANSITION"); + if (state.identity?.actionId !== event.identity.actionId) { + return rejected(state, "USER_ACTION_IDENTITY_MISMATCH"); + } + + if (event.type === "SUCCEED") { + return { ok: true, state: { ...state, status: "SUCCEEDED", errorCode: null } }; + } + + const errorCode = event.type === "CANCEL" ? event.errorCode ?? "USER_ACTION_CANCELLED" : event.errorCode; + if (!isStableErrorCode(errorCode)) return rejected(state, "USER_ACTION_INVALID_ERROR_CODE"); + return { + ok: true, + state: { ...state, status: event.type === "CANCEL" ? "CANCELLED" : "FAILED", errorCode }, + }; +} + +export function reduceUserActionStates(states: UserActionStates, event: UserActionEvent): UserActionStates { + const kind = event.type === "RESET" ? event.kind : event.identity.kind; + const result = transitionUserAction(states[kind], event); + return result.ok ? { ...states, [kind]: result.state } : states; +} diff --git a/web/protocol/web-engine.ts b/web/protocol/web-engine.ts index 75bb5602..710540ba 100644 --- a/web/protocol/web-engine.ts +++ b/web/protocol/web-engine.ts @@ -137,6 +137,8 @@ export type WebEngineEditCommand = export type WebEngineRequest = | { requestId: string; command: { type: "init" } } | { requestId: string; command: { type: "openBlend"; buffer: ArrayBuffer }; } + | { requestId: string; command: { type: "cancelOpen"; targetRequestId: string } } + | { requestId: string; command: { type: "openResourceStatus" } } | { requestId: string; command: { type: "snapshot" } } | { requestId: string; command: { type: "applyCommand"; payload: WebEngineEditCommand } } | { requestId: string; command: { type: "generateLOD"; payload: LODGenerationRequest } } @@ -154,6 +156,13 @@ export interface WebEngineStatus { allocatedBytes: number; } +export interface WebEngineOpenResourceStatus { + activeRequests: number; + liveInputBytes: number; + liveNativeHandles: number; + liveStagingFiles: number; +} + export interface AssetRequestResult { assetId: string; status: "external" | "packed" | "packed-unavailable" | "missing" | "blocked"; @@ -202,6 +211,7 @@ export interface WebEngineResult { capabilityGate?: CapabilityGateResult; depsgraph?: DepsgraphEvaluationIR; blend?: ArrayBuffer; + openResources?: WebEngineOpenResourceStatus; } export type WebEngineResponse = diff --git a/web/tests/e2e/archive-offline.spec.ts b/web/tests/e2e/archive-offline.spec.ts new file mode 100644 index 00000000..d49980ba --- /dev/null +++ b/web/tests/e2e/archive-offline.spec.ts @@ -0,0 +1,147 @@ +import { expect, test, type BrowserContext, type Page } from "@playwright/test"; +import fs from "node:fs"; +import path from "node:path"; +import { importGLBSemantics } from "../../protocol/glb-import"; + +const basicBlend = path.resolve(import.meta.dirname, "../../../tests/files/web/basic_scene.blend"); + +function isLoopbackRequest(value: string): boolean { + const url = new URL(value); + if (!["http:", "https:"].includes(url.protocol)) return true; + return url.hostname === "localhost" || url.hostname === "::1" || /^127(?:\.\d{1,3}){3}$/.test(url.hostname); +} + +async function isolateExternalNetwork(context: BrowserContext, page: Page) { + const externalAttempts: string[] = []; + const requested: string[] = []; + page.on("request", (request) => requested.push(request.url())); + await context.route("**/*", async (route) => { + if (isLoopbackRequest(route.request().url())) await route.continue(); + else { + externalAttempts.push(route.request().url()); + await route.abort("internetdisconnected"); + } + }); + return { externalAttempts, requested }; +} + +async function waitForArchiveBoot(page: Page): Promise { + await page.goto("/"); + await expect(page.getByText("Web Blender Modeler V1", { exact: true }).first()).toBeVisible(); + await expect(page.locator(".status-bar")).toContainText("Manifest: verified r1"); + await expect(page.getByTestId("engine-status")).toContainText("Engine: ready, open a .blend file"); + await expect(page.locator(".status-bar")).toContainText("Storage: IndexedDB + OPFS"); + await page.evaluate(() => document.fonts.ready); + expect(await page.evaluate(() => document.fonts.status)).toBe("loaded"); +} + +async function objectCount(page: Page): Promise { + const text = await page.getByTestId("scene-stats").innerText(); + const match = text.match(/Objects (\d+)/); + if (!match) throw new Error(`scene stats omit object count: ${text}`); + return Number(match[1]); +} + +async function stableIds(page: Page) { + return page.locator(".outliner-content .tree-row.child").evaluateAll((rows) => rows.map((row) => ({ + objectId: (row as HTMLElement).dataset.nodeId ?? "", + dataId: (row as HTMLElement).dataset.dataId ?? "", + name: row.querySelector("span:nth-of-type(3)")?.textContent ?? "", + })).sort((left, right) => left.objectId.localeCompare(right.objectId))); +} + +async function opfsCommit(page: Page, projectId: string) { + return page.evaluate(async (id) => { + const root = await navigator.storage.getDirectory(); + const projects = await root.getDirectoryHandle("projects"); + const project = await projects.getDirectoryHandle(id); + const manifestFile = await (await project.getFileHandle("scene.blend.meta.json")).getFile(); + const manifest = JSON.parse(await manifestFile.text()) as { revision: number; bytes: number; sha256: string }; + const blend = await (await project.getFileHandle("scene.blend")).getFile(); + const bytes = await blend.arrayBuffer(); + const digest = await crypto.subtle.digest("SHA-256", bytes); + const sha256 = Array.from(new Uint8Array(digest), (value) => value.toString(16).padStart(2, "0")).join(""); + return { ...manifest, actualBytes: bytes.byteLength, actualSha256: sha256 }; + }, projectId); +} + +test("M6-09 cold boots the extracted binary archive with no external network", async ({ context, page }) => { + const network = await isolateExternalNetwork(context, page); + await waitForArchiveBoot(page); + const paths = network.requested.filter((value) => value.startsWith(page.url().replace(/\/$/, ""))).map((value) => new URL(value).pathname); + expect(paths).toContain("/engine-manifest.json"); + expect(paths.some((value) => value.endsWith(".wasm"))).toBe(true); + expect(paths.some((value) => value.endsWith(".css"))).toBe(true); + expect(paths.some((value) => value.includes(".worker-") && value.endsWith(".js"))).toBe(true); + expect(network.externalAttempts).toEqual([]); +}); + +test("M6-10 reopens and continues an OPFS project offline after Worker reconstruction", async ({ context, page }) => { + const network = await isolateExternalNetwork(context, page); + await waitForArchiveBoot(page); + const input = fs.readFileSync(basicBlend); + const projectId = `m6-offline-${Date.now()}`; + await page.getByTestId("blend-file-input").setInputFiles({ + name: `${projectId}.blend`, + mimeType: "application/octet-stream", + buffer: input, + }); + await expect(page.getByTestId("engine-status")).toContainText("Engine: SceneIR r"); + const initialCount = await objectCount(page); + const initialIds = await stableIds(page); + + await page.getByRole("button", { name: "添加立方体" }).click(); + await expect.poll(() => objectCount(page)).toBe(initialCount + 1); + const editedIds = await stableIds(page); + const firstCreated = editedIds.find((entry) => !initialIds.some((initial) => initial.objectId === entry.objectId)); + expect(firstCreated?.objectId).toBeTruthy(); + expect(firstCreated?.dataId).toBeTruthy(); + await page.getByRole("button", { name: "撤销" }).click(); + await expect.poll(() => objectCount(page)).toBe(initialCount); + await page.getByRole("button", { name: "重做" }).click(); + await expect.poll(() => objectCount(page)).toBe(initialCount + 1); + + const firstSave = page.waitForEvent("download"); + await page.getByRole("button", { name: "保存项目" }).click(); + await firstSave; + const firstCommit = await opfsCommit(page, projectId); + expect(firstCommit.revision).toBeGreaterThan(0); + expect(firstCommit.bytes).toBe(firstCommit.actualBytes); + expect(firstCommit.sha256).toBe(firstCommit.actualSha256); + expect(firstCommit.sha256).toMatch(/^[a-f0-9]{64}$/); + + await page.reload(); + await expect(page.getByTestId("engine-status")).toContainText("Engine: ready, open a .blend file"); + await page.getByRole("button", { name: "恢复项目" }).click(); + await expect(page.getByTestId("engine-status")).toContainText("Recovery: 0 operation(s), 0 quarantined"); + expect(await stableIds(page)).toEqual(editedIds); + + await page.getByRole("button", { name: "添加立方体" }).click(); + await expect.poll(() => objectCount(page)).toBe(initialCount + 2); + await page.getByRole("button", { name: "撤销" }).click(); + await expect.poll(() => objectCount(page)).toBe(initialCount + 1); + await page.getByRole("button", { name: "重做" }).click(); + await expect.poll(() => objectCount(page)).toBe(initialCount + 2); + + const secondSave = page.waitForEvent("download"); + await page.getByRole("button", { name: "保存项目" }).click(); + await secondSave; + const secondCommit = await opfsCommit(page, projectId); + expect(secondCommit.revision).toBeGreaterThan(firstCommit.revision); + expect(secondCommit.sha256).toBe(secondCommit.actualSha256); + expect(secondCommit.sha256).not.toBe(firstCommit.sha256); + + const glbDownload = page.waitForEvent("download"); + await page.getByRole("button", { name: "导出 GLB" }).click(); + const glb = await glbDownload; + const glbPath = await glb.path(); + expect(glbPath).toBeTruthy(); + const glbBytes = fs.readFileSync(glbPath!); + const glbBuffer = glbBytes.buffer.slice(glbBytes.byteOffset, glbBytes.byteOffset + glbBytes.byteLength); + const imported = importGLBSemantics(glbBuffer); + expect(imported.meshCount).toBeGreaterThan(0); + expect(imported.primitiveCount).toBeGreaterThan(0); + expect(imported.meshes.some((mesh) => mesh.blenderId === firstCreated?.dataId)).toBe(true); + expect(network.externalAttempts).toEqual([]); +}); + diff --git a/web/tests/e2e/dirty-state.spec.ts b/web/tests/e2e/dirty-state.spec.ts new file mode 100644 index 00000000..4762310a --- /dev/null +++ b/web/tests/e2e/dirty-state.spec.ts @@ -0,0 +1,69 @@ +import { expect, test } from "@playwright/test"; +import path from "node:path"; + +const attributeBlend = path.resolve(import.meta.dirname, "../../../tests/files/web/attribute_scene.blend"); + +test("M7-06 changes dirty only for accepted Main transactions and matching saves", async ({ page }) => { + await page.goto("/"); + await page.getByTestId("blend-file-input").setInputFiles(attributeBlend); + await expect(page.getByText("AttributeMeshObject", { exact: true })).toBeVisible(); + const app = page.locator(".blender-app"); + await expect(app).toHaveAttribute("data-dirty", "false"); + const openedRevision = await app.getAttribute("data-current-main-revision"); + await expect(app).toHaveAttribute("data-committed-main-revision", openedRevision ?? ""); + + await page.getByRole("button", { name: "Modeling" }).click(); + await expect(app).toHaveAttribute("data-dirty", "false"); + await expect(app).toHaveAttribute("data-current-main-revision", openedRevision ?? ""); + + await page.getByRole("button", { name: "预览 Decimate" }).click(); + await expect(page.getByTestId("engine-status")).toContainText("Preview"); + await expect(app).toHaveAttribute("data-dirty", "false"); + await expect(app).toHaveAttribute("data-current-main-revision", openedRevision ?? ""); + + await page.locator("label.file-button input[type=file]").setInputFiles({ + name: "invalid.png", + mimeType: "image/png", + buffer: Buffer.from("not-a-png"), + }); + await expect(app).toHaveAttribute("data-user-action-import-status", "FAILED"); + await expect(app).toHaveAttribute("data-dirty", "false"); + await expect(app).toHaveAttribute("data-current-main-revision", openedRevision ?? ""); + + await page.getByRole("button", { name: "添加立方体" }).click(); + await expect(app).toHaveAttribute("data-dirty", "true"); + await expect(page.getByTestId("dirty-status")).toHaveText("未保存"); + const editedRevision = Number(await app.getAttribute("data-current-main-revision")); + expect(editedRevision).toBeGreaterThan(Number(openedRevision)); + await expect(app).toHaveAttribute("data-committed-main-revision", openedRevision ?? ""); + + const download = page.waitForEvent("download"); + await page.getByRole("button", { name: "保存项目" }).click(); + await download; + await expect(app).toHaveAttribute("data-dirty", "false"); + await expect(page.getByTestId("dirty-status")).toHaveText("已保存"); + await expect(app).toHaveAttribute("data-committed-main-revision", String(editedRevision)); + + await page.getByRole("button", { name: "添加立方体" }).click(); + await expect(app).toHaveAttribute("data-dirty", "true"); + await page.getByRole("button", { name: "撤销" }).click(); + await expect(app).toHaveAttribute("data-dirty", "false"); + const undoRevision = Number(await app.getAttribute("data-current-main-revision")); + expect(undoRevision).toBeGreaterThan(editedRevision); + await page.getByRole("button", { name: "重做" }).click(); + await expect(app).toHaveAttribute("data-dirty", "true"); + const redoRevision = Number(await app.getAttribute("data-current-main-revision")); + expect(redoRevision).toBeGreaterThan(undoRevision); + await page.getByRole("button", { name: "撤销" }).click(); + await expect(app).toHaveAttribute("data-dirty", "false"); + + await page.getByTestId("blend-file-input").setInputFiles({ + name: "invalid.blend", + mimeType: "application/octet-stream", + buffer: Buffer.from([0x42, 0x41, 0x44]), + }); + await expect(app).toHaveAttribute("data-user-action-open-status", "FAILED"); + await expect(app).toHaveAttribute("data-dirty", "false"); + const finalUndoRevision = await app.getAttribute("data-current-main-revision"); + await expect(app).toHaveAttribute("data-committed-main-revision", finalUndoRevision ?? ""); +}); diff --git a/web/tests/e2e/engine-upgrade-safety.spec.ts b/web/tests/e2e/engine-upgrade-safety.spec.ts new file mode 100644 index 00000000..99d393ba --- /dev/null +++ b/web/tests/e2e/engine-upgrade-safety.spec.ts @@ -0,0 +1,92 @@ +import { expect, test } from "@playwright/test"; + +test("refreshes on a release switch and rejects tampered WASM without fallback or open", async ({ page }) => { + await page.goto("/"); + await expect(page.locator(".status-bar")).toContainText("Manifest: verified"); + + const versionGate = await page.evaluate(async () => { + const { bootstrapWebEngineRelease } = await import("/src/engine-client/engine-variant-bootstrap.ts"); + const manifest = await fetch("/engine-manifest.json", { cache: "no-store" }).then((response) => response.json()); + let initializationCount = 0; + const outcome = await bootstrapWebEngineRelease( + "blender-wasm-previous", + manifest, + "AUTO", + { crossOriginIsolated: true, sharedArrayBuffer: true, worker: true }, + { + initialize: async () => { + initializationCount += 1; + throw new Error("release mismatch initialized an engine"); + }, + }, + new ArrayBuffer(8), + ); + return { result: outcome.result, hasSession: outcome.session !== null, initializationCount }; + }); + + expect(versionGate).toEqual({ + result: { + status: "REFRESH_REQUIRED", + expectedReleaseId: "blender-wasm-previous", + actualReleaseId: "blender-wasm-0.1.0-rc.1", + manifest: null, + }, + hasSession: false, + initializationCount: 0, + }); + + const variantRequests: string[] = []; + page.on("request", (request) => { + const pathname = new URL(request.url()).pathname; + if (pathname.startsWith("/vendor/blender/single/") || pathname.startsWith("/vendor/blender/pthread/")) { + variantRequests.push(pathname); + } + }); + await page.route("**/vendor/blender/pthread/web_engine.wasm", async (route) => { + await route.fulfill({ + status: 200, + contentType: "application/wasm", + body: Buffer.from("tampered-pthread-wasm"), + }); + }); + + const integrityGate = await page.evaluate(async () => { + const { detectBrowserCapabilities } = await import("/src/platform/capabilities.ts"); + const { bootstrapWebEngineRelease } = await import("/src/engine-client/engine-variant-bootstrap.ts"); + const { createBrowserEngineVariantSession } = await import("/src/engine-client/browser-engine-variant-session.ts"); + const manifest = await fetch("/engine-manifest.json", { cache: "no-store" }).then((response) => response.json()); + try { + await bootstrapWebEngineRelease( + manifest.releaseId, + manifest, + "AUTO", + detectBrowserCapabilities(), + { initialize: createBrowserEngineVariantSession }, + new ArrayBuffer(8), + ); + return { rejected: false }; + } + catch (error) { + const failure = error as Error & { + code?: string; + attempted?: string[]; + cause?: { code?: string }; + }; + return { + rejected: true, + code: failure.code, + causeCode: failure.cause?.code, + attempted: failure.attempted, + }; + } + }); + + expect(integrityGate).toEqual({ + rejected: true, + code: "ENGINE_VARIANT_INTEGRITY_FAILED", + causeCode: "ENGINE_VARIANT_RESOURCE_HASH_MISMATCH", + attempted: ["pthread"], + }); + expect(variantRequests.filter((url) => url.endsWith("/pthread/web_engine.wasm"))).toHaveLength(1); + expect(variantRequests.some((url) => url.includes("/single/"))).toBe(false); +}); diff --git a/web/tests/e2e/file-import-progress.spec.ts b/web/tests/e2e/file-import-progress.spec.ts new file mode 100644 index 00000000..78335e5e --- /dev/null +++ b/web/tests/e2e/file-import-progress.spec.ts @@ -0,0 +1,111 @@ +import { expect, test } from "@playwright/test"; +import fs from "node:fs"; +import path from "node:path"; + +const basicBlend = path.resolve(import.meta.dirname, "../../../tests/files/web/basic_scene.blend"); +const largeBlend = path.resolve(import.meta.dirname, "../../../tests/files/web/image_resource_matrix.blend"); + +test("M7-03 records exact streamed byte progress for a large valid blend", async ({ page }) => { + test.setTimeout(60_000); + const expectedBytes = fs.statSync(largeBlend).size; + expect(expectedBytes).toBeGreaterThanOrEqual(512 * 1024); + await page.goto("/"); + await expect(page.getByTestId("engine-status")).toContainText("ready, open a .blend file", { timeout: 20_000 }); + await page.getByTestId("blend-file-input").setInputFiles(largeBlend); + + const app = page.locator(".blender-app"); + await expect(app).toHaveAttribute("data-user-action-open-status", "SUCCEEDED", { timeout: 30_000 }); + await expect(app).toHaveAttribute("data-open-read-phase", "COMPLETED"); + await expect(app).toHaveAttribute("data-open-read-bytes", String(expectedBytes)); + await expect(app).toHaveAttribute("data-open-read-total", String(expectedBytes)); + expect(Number(await app.getAttribute("data-open-read-events"))).toBeGreaterThan(2); + expect(await app.getAttribute("data-open-read-action-id")).toBe(await app.getAttribute("data-user-action-open-id")); +}); + +test("M7-03 cancels a large streamed open before WebEngine and preserves the current project", async ({ page }) => { + test.setTimeout(60_000); + await page.goto("/"); + await expect(page.getByTestId("engine-status")).toContainText("ready, open a .blend file", { timeout: 20_000 }); + await page.getByTestId("blend-file-input").setInputFiles(basicBlend); + await expect(page.getByText("BasicCube", { exact: true })).toBeVisible(); + const previousStats = await page.getByTestId("scene-stats").textContent(); + + const totalBytes = 40 * 1024 * 1024; + const syntheticLargeBlend = Buffer.alloc(totalBytes, 0x7f); + fs.readFileSync(basicBlend).copy(syntheticLargeBlend); + await page.getByTestId("blend-file-input").setInputFiles({ + name: "cancelled-large.blend", + mimeType: "application/octet-stream", + buffer: syntheticLargeBlend, + }); + + const observation = await page.waitForFunction((expectedTotal) => { + const element = document.querySelector('[data-testid="open-progress"]'); + const bytesRead = Number(element?.getAttribute("data-bytes-read")); + const actualTotal = Number(element?.getAttribute("data-total-bytes")); + const cancel = document.querySelector('button[aria-label="取消打开"]'); + if (bytesRead <= 0 || bytesRead >= expectedTotal || !cancel) return false; + cancel.click(); + return { bytesRead, totalBytes: actualTotal }; + }, totalBytes, { polling: "raf", timeout: 10_000 }); + const observed = await observation.jsonValue() as { bytesRead: number; totalBytes: number }; + expect(observed.bytesRead).toBeLessThan(totalBytes); + expect(observed.totalBytes).toBe(totalBytes); + + const app = page.locator(".blender-app"); + await expect(app).toHaveAttribute("data-user-action-open-status", "CANCELLED"); + await expect(app).toHaveAttribute("data-user-action-open-error", "OPEN_CANCELLED"); + await expect(app).toHaveAttribute("data-open-read-phase", "CANCELLED"); + await expect(app).toHaveAttribute("data-open-cleanup-reader-count", "0"); + await expect(app).toHaveAttribute("data-open-cleanup-reader-bytes", "0"); + await expect(app).toHaveAttribute("data-open-cleanup-reader-staging", "0"); + await expect(app).toHaveAttribute("data-open-cleanup-engine-requests", "0"); + await expect(app).toHaveAttribute("data-open-cleanup-engine-bytes", "0"); + await expect(app).toHaveAttribute("data-open-cleanup-engine-handles", "0"); + await expect(app).toHaveAttribute("data-open-cleanup-engine-staging", "0"); + const cancelledBytes = Number(await app.getAttribute("data-open-read-bytes")); + expect(cancelledBytes).toBeGreaterThan(0); + expect(cancelledBytes).toBeLessThan(totalBytes); + await expect(page.getByTestId("scene-stats")).toHaveText(previousStats ?? ""); + await expect(page.getByText("BasicCube", { exact: true })).toBeVisible(); + expect(await page.evaluate(() => localStorage.getItem("blender-web:last-project-id"))).toBe("basic_scene"); +}); + +test("M7-04 destroys isolated native open resources before reporting cancellation", async ({ page }) => { + test.setTimeout(60_000); + await page.goto("/"); + await expect(page.getByTestId("engine-status")).toContainText("ready, open a .blend file", { timeout: 20_000 }); + await page.getByTestId("blend-file-input").setInputFiles(basicBlend); + await expect(page.getByText("BasicCube", { exact: true })).toBeVisible(); + const previousStats = await page.getByTestId("scene-stats").textContent(); + + await page.getByTestId("blend-file-input").setInputFiles(largeBlend); + const cancellation = await page.waitForFunction(() => { + const progress = document.querySelector('[data-testid="open-progress"]'); + const stage = progress?.dataset.stage; + const cancel = document.querySelector('button[aria-label="取消打开"]'); + if (!cancel || (stage !== "NATIVE_INITIALIZE" && stage !== "NATIVE_OPENED")) return false; + cancel.click(); + return stage; + }, undefined, { polling: "raf", timeout: 10_000 }); + expect(["NATIVE_INITIALIZE", "NATIVE_OPENED"]).toContain(await cancellation.jsonValue()); + + const app = page.locator(".blender-app"); + await expect(app).toHaveAttribute("data-user-action-open-status", "CANCELLED"); + await expect(app).toHaveAttribute("data-user-action-open-error", "OPEN_CANCELLED"); + await expect(app).toHaveAttribute("data-open-cleanup-reader-count", "0"); + await expect(app).toHaveAttribute("data-open-cleanup-reader-bytes", "0"); + await expect(app).toHaveAttribute("data-open-cleanup-reader-staging", "0"); + await expect(app).toHaveAttribute("data-open-cleanup-engine-requests", "0"); + await expect(app).toHaveAttribute("data-open-cleanup-engine-bytes", "0"); + await expect(app).toHaveAttribute("data-open-cleanup-engine-handles", "0"); + await expect(app).toHaveAttribute("data-open-cleanup-engine-staging", "0"); + await expect(page.getByTestId("scene-stats")).toHaveText(previousStats ?? ""); + await expect(page.getByText("BasicCube", { exact: true })).toBeVisible(); + + await page.getByRole("button", { name: "添加立方体" }).click(); + await expect(page.getByTestId("scene-stats")).toContainText("Objects 4"); + const download = page.waitForEvent("download"); + await page.getByRole("button", { name: "保存项目" }).click(); + await download; +}); diff --git a/web/tests/e2e/project-action-mutex.spec.ts b/web/tests/e2e/project-action-mutex.spec.ts new file mode 100644 index 00000000..8551db3d --- /dev/null +++ b/web/tests/e2e/project-action-mutex.spec.ts @@ -0,0 +1,95 @@ +import { expect, test, type Page } from "@playwright/test"; +import fs from "node:fs"; +import path from "node:path"; + +const basicBlend = path.resolve(import.meta.dirname, "../../../tests/files/web/basic_scene.blend"); + +async function waitForEngine(page: Page): Promise { + await page.goto("/"); + await expect(page.getByTestId("engine-status")).toContainText("ready, open a .blend file", { timeout: 20_000 }); +} + +test("M7-02 rejects a repeated open before it can replace the first project owner", async ({ page }) => { + await waitForEngine(page); + const bytes = Array.from(fs.readFileSync(basicBlend)); + await page.evaluate(({ blendBytes }) => { + const input = document.querySelector("[data-testid=blend-file-input]"); + if (!input) throw new Error("blend input missing"); + const dispatchOpen = (name: string): void => { + const transfer = new DataTransfer(); + transfer.items.add(new File([new Uint8Array(blendBytes)], name, { type: "application/octet-stream" })); + input.files = transfer.files; + input.dispatchEvent(new Event("change", { bubbles: true })); + }; + dispatchOpen("first-open.blend"); + dispatchOpen("second-open.blend"); + }, { blendBytes: bytes }); + + const app = page.locator(".blender-app"); + await expect(app).toHaveAttribute("data-project-action-conflict", "USER_ACTION_CONFLICT"); + await expect(app).toHaveAttribute("data-project-action-conflict-reason", "REPEATED_OPEN"); + await expect(app).toHaveAttribute("data-project-action-conflict-requested", "OPEN"); + await expect(app).toHaveAttribute("data-project-action-conflict-owner", "OPEN"); + await expect(app).toHaveAttribute("data-user-action-open-status", "SUCCEEDED"); + await expect(page.getByText("BasicCube", { exact: true })).toBeVisible(); + expect(await page.evaluate(() => localStorage.getItem("blender-web:last-project-id"))).toBe("first-open"); +}); + +test("M7-02 grants only one concurrent manual save and emits one download", async ({ page }) => { + await waitForEngine(page); + await page.getByTestId("blend-file-input").setInputFiles(basicBlend); + await expect(page.getByText("BasicCube", { exact: true })).toBeVisible(); + let downloadCount = 0; + page.on("download", () => { downloadCount += 1; }); + + await page.evaluate(() => { + const save = document.querySelector('button[aria-label="保存项目"]'); + if (!save) throw new Error("save button missing"); + save.click(); + save.click(); + }); + + const app = page.locator(".blender-app"); + await expect(app).toHaveAttribute("data-project-action-conflict", "USER_ACTION_CONFLICT"); + await expect(app).toHaveAttribute("data-project-action-conflict-reason", "CONCURRENT_SAVE"); + await expect(app).toHaveAttribute("data-project-action-conflict-requested", "SAVE"); + await expect(app).toHaveAttribute("data-project-action-conflict-owner", "SAVE"); + await expect(app).toHaveAttribute("data-user-action-save-status", "SUCCEEDED"); + await expect(app).toHaveAttribute("data-user-action-save-as-status", "SUCCEEDED"); + await expect.poll(() => downloadCount).toBe(1); +}); + +test("M7-02 blocks close until save commit completes without terminating either worker", async ({ page }) => { + await waitForEngine(page); + await page.getByTestId("blend-file-input").setInputFiles(basicBlend); + await expect(page.getByText("BasicCube", { exact: true })).toBeVisible(); + const firstDownload = page.waitForEvent("download"); + + await page.evaluate(() => { + const save = document.querySelector('button[aria-label="保存项目"]'); + const close = document.querySelector('button[aria-label="关闭项目"]'); + if (!save || !close) throw new Error("project action button missing"); + save.click(); + close.click(); + }); + + const app = page.locator(".blender-app"); + await expect(app).toHaveAttribute("data-project-action-conflict", "USER_ACTION_CONFLICT"); + await expect(app).toHaveAttribute("data-project-action-conflict-reason", "CLOSE_DURING_SAVE"); + await expect(app).toHaveAttribute("data-project-action-conflict-requested", "CLOSE"); + await expect(app).toHaveAttribute("data-project-action-conflict-owner", "SAVE"); + await firstDownload; + await expect(app).toHaveAttribute("data-user-action-save-status", "SUCCEEDED"); + await expect(page.getByText("BasicCube", { exact: true })).toBeVisible(); + + await page.getByRole("button", { name: "添加立方体" }).click(); + await expect(page.getByTestId("scene-stats")).toContainText("Objects 4"); + const secondDownload = page.waitForEvent("download"); + await page.getByRole("button", { name: "保存项目" }).click(); + await secondDownload; + await expect(app).not.toHaveAttribute("data-project-action-conflict"); + + await page.getByRole("button", { name: "关闭项目" }).click(); + await expect(page.getByTestId("scene-stats")).toContainText("Objects 0"); + await expect(page.getByRole("button", { name: "关闭项目" })).toBeDisabled(); +}); diff --git a/web/tests/e2e/pthread-engine-isolated.spec.ts b/web/tests/e2e/pthread-engine-isolated.spec.ts new file mode 100644 index 00000000..f8f18296 --- /dev/null +++ b/web/tests/e2e/pthread-engine-isolated.spec.ts @@ -0,0 +1,78 @@ +import { expect, test } from "@playwright/test"; + +test("loads the selected pthread engine with shared memory and its worker pool", async ({ page }) => { + const pthreadRequests: string[] = []; + page.on("request", (request) => { + const pathname = new URL(request.url()).pathname; + if (pathname.startsWith("/vendor/blender/pthread/")) pthreadRequests.push(pathname); + }); + + const documentResponse = await page.goto("/"); + expect(documentResponse).not.toBeNull(); + const headers = await documentResponse!.allHeaders(); + expect(headers["cross-origin-opener-policy"]).toBe("same-origin"); + expect(headers["cross-origin-embedder-policy"]).toBe("require-corp"); + + const result = await page.evaluate(async () => { + const { detectBrowserCapabilities, selectWebEngineVariant } = await import("/src/platform/capabilities.ts"); + const manifest = await fetch("/engine-manifest.json", { cache: "no-store" }).then((response) => response.json()); + const selection = selectWebEngineVariant(manifest, "PTHREAD_REQUIRED", detectBrowserCapabilities()); + if (!selection.selectedVariant) { + return { selected: null, gate: selection.pthreadGate, shared: false, handle: 0, liveAfterDestroy: -1 }; + } + + const variant = selection.selectedVariant; + const wasmResponse = await fetch(variant.resources.wasm.url, { cache: "no-store" }); + if (!wasmResponse.ok) throw new Error(`pthread WASM request failed: ${wasmResponse.status}`); + const wasmBinary = await wasmResponse.arrayBuffer(); + const digest = await crypto.subtle.digest("SHA-256", wasmBinary); + const actualHash = [...new Uint8Array(digest)] + .map((byte) => byte.toString(16).padStart(2, "0")) + .join(""); + if (actualHash !== variant.resources.wasm.sha256) throw new Error("pthread WASM hash mismatch"); + + const imported = await import(/* @vite-ignore */ variant.resources.js.url) as { + default: (options: { wasmBinary: ArrayBuffer }) => Promise<{ + HEAPU8: Uint8Array; + _web_engine_create(): number; + _web_engine_destroy(handle: number): void; + _web_engine_get_live_handles(): number; + PThread: { + unusedWorkers: Worker[]; + runningWorkers: Worker[]; + terminateAllThreads(): void; + }; + }>; + }; + const module = await imported.default({ wasmBinary }); + const handle = module._web_engine_create(); + const shared = module.HEAPU8.buffer instanceof SharedArrayBuffer; + const liveBeforeDestroy = module._web_engine_get_live_handles(); + const poolWorkersBeforeDispose = module.PThread.unusedWorkers.length + module.PThread.runningWorkers.length; + module._web_engine_destroy(handle); + module.PThread.terminateAllThreads(); + return { + selected: variant.id, + gate: selection.pthreadGate, + shared, + handle, + liveBeforeDestroy, + liveAfterDestroy: module._web_engine_get_live_handles(), + poolWorkersBeforeDispose, + poolWorkersAfterDispose: module.PThread.unusedWorkers.length + module.PThread.runningWorkers.length, + }; + }); + + expect(result).toMatchObject({ + selected: "pthread", + gate: { taskId: "M6-02", capability: "WASM_PTHREAD_ENGINE", status: "READY", issues: [] }, + shared: true, + liveBeforeDestroy: 1, + liveAfterDestroy: 0, + poolWorkersBeforeDispose: 1, + poolWorkersAfterDispose: 0, + }); + expect(result.handle).toBeGreaterThan(0); + expect(pthreadRequests.filter((url) => url.endsWith("/web_engine.wasm"))).toHaveLength(1); + expect(pthreadRequests.filter((url) => url.endsWith("/web_engine.js")).length).toBeGreaterThanOrEqual(2); +}); diff --git a/web/tests/e2e/pthread-fallback.spec.ts b/web/tests/e2e/pthread-fallback.spec.ts new file mode 100644 index 00000000..2e76fe88 --- /dev/null +++ b/web/tests/e2e/pthread-fallback.spec.ts @@ -0,0 +1,58 @@ +import { expect, test } from "@playwright/test"; + +test("cleans an initialized pthread attempt before one single fallback", async ({ page }) => { + const variantRequests: string[] = []; + page.on("request", (request) => { + const pathname = new URL(request.url()).pathname; + if (pathname.startsWith("/vendor/blender/single/") || pathname.startsWith("/vendor/blender/pthread/")) { + variantRequests.push(pathname); + } + }); + + await page.goto("/"); + await expect(page.locator(".status-bar")).toContainText("Manifest: verified"); + variantRequests.length = 0; + const report = await page.evaluate(async () => { + const { detectBrowserCapabilities } = await import("/src/platform/capabilities.ts"); + const { + bootstrapWebEngineRelease, + engineVariantStatusLabel, + } = await import("/src/engine-client/engine-variant-bootstrap.ts"); + const { createBrowserEngineVariantSession } = await import("/src/engine-client/browser-engine-variant-session.ts"); + const manifest = await fetch("/engine-manifest.json", { cache: "no-store" }).then((response) => response.json()); + const outcome = await bootstrapWebEngineRelease( + manifest.releaseId, + manifest, + "AUTO", + detectBrowserCapabilities(), + { initialize: createBrowserEngineVariantSession }, + undefined, + { failPthreadAfterInitialize: true, seedTrackedPthreadResources: true }, + ); + if (!outcome.session) throw new Error("current release unexpectedly requires refresh"); + const activeBeforeDispose = outcome.session.resourceState(); + const label = engineVariantStatusLabel(outcome.result); + const activeAfterDispose = await outcome.session.dispose(); + return { result: outcome.result, activeBeforeDispose, activeAfterDispose, label }; + }); + + expect(report.result).toMatchObject({ + status: "READY", + selected: "single", + attempted: ["pthread", "single"], + fallbackReason: { + code: "PTHREAD_INITIALIZATION_FAILED", + message: "TEST_PTHREAD_INITIALIZATION_FAILURE", + }, + openCount: 0, + failedAttemptCleanup: { handles: 0, workers: 0, timers: 0, pendingRequests: 0 }, + }); + expect(report.activeBeforeDispose).toEqual({ handles: 1, workers: 0, timers: 0, pendingRequests: 0 }); + expect(report.activeAfterDispose).toEqual({ handles: 0, workers: 0, timers: 0, pendingRequests: 0 }); + expect(report.label).toBe("Runtime: single (pthread fallback: PTHREAD_INITIALIZATION_FAILED)"); + expect(report.label).not.toMatch(/pthread\s+ready/i); + expect(variantRequests.filter((url) => url.endsWith("/pthread/web_engine.wasm"))).toHaveLength(1); + expect(variantRequests.filter((url) => url.endsWith("/single/web_engine.wasm"))).toHaveLength(1); + expect(variantRequests.filter((url) => url.endsWith("/pthread/web_engine.js")).length).toBeGreaterThanOrEqual(3); + expect(variantRequests.filter((url) => url.endsWith("/single/web_engine.js")).length).toBeGreaterThanOrEqual(2); +}); diff --git a/web/tests/e2e/save-interruption.spec.ts b/web/tests/e2e/save-interruption.spec.ts new file mode 100644 index 00000000..c9be1db0 --- /dev/null +++ b/web/tests/e2e/save-interruption.spec.ts @@ -0,0 +1,62 @@ +import { expect, test } from "@playwright/test"; + +test("M7-05 restores old revision, hash and bytes after every storage save interruption", async ({ page }) => { + await page.goto("/"); + const result = await page.evaluate(async () => { + const { StorageClient } = await import("/src/storage/StorageClient.ts"); + const projectId = `m7-save-interrupt-${Date.now()}-${Math.random().toString(16).slice(2)}`; + const oldBytes = Uint8Array.from([0x42, 0x4c, 0x45, 0x4e, 0x44, 7, 7, 7]); + const nextBytes = Uint8Array.from([0x42, 0x4c, 0x45, 0x4e, 0x44, 8, 8, 8, 8]); + const initial = new StorageClient(); + const baseline = await initial.saveProject(projectId, 7, oldBytes.slice().buffer); + initial.terminate(); + + const observations = []; + for (const faultAt of ["after-stage", "after-scene-commit", "before-metadata-commit"] as const) { + const attempt = new StorageClient(); + let error = ""; + try { + await attempt.saveProject(projectId, 8, nextBytes.slice().buffer, faultAt); + } + catch (reason) { + error = reason instanceof Error ? reason.message : String(reason); + } + attempt.terminate(); + + const restarted = new StorageClient(); + const restored = await restarted.readProject(projectId); + restarted.terminate(); + observations.push({ + faultAt, + error, + revision: restored.revision, + sha256: restored.sha256, + bytes: Array.from(new Uint8Array(restored.buffer)), + recovered: restored.recovered, + }); + } + + const completed = new StorageClient(); + const committed = await completed.saveProject(projectId, 8, nextBytes.slice().buffer); + const reopened = await completed.readProject(projectId); + completed.terminate(); + return { + baseline: { revision: baseline.revision, sha256: baseline.sha256, bytes: Array.from(oldBytes) }, + observations, + committed: { revision: committed.revision, sha256: committed.sha256, reopenedRevision: reopened.revision, reopenedSha256: reopened.sha256 }, + }; + }); + + expect(result.observations).toHaveLength(3); + for (const item of result.observations) { + expect(item.error).toContain(`PROJECT_SAVE_FAULT_INJECTED: ${item.faultAt}`); + expect(item.revision).toBe(result.baseline.revision); + expect(item.sha256).toBe(result.baseline.sha256); + expect(item.bytes).toEqual(result.baseline.bytes); + expect(item.recovered).toBe(false); + } + expect(result.committed.revision).toBe(8); + expect(result.committed.reopenedRevision).toBe(8); + expect(result.committed.sha256).toBe(result.committed.reopenedSha256); + expect(result.committed.sha256).not.toBe(result.baseline.sha256); +}); diff --git a/web/tests/e2e/single-thread-unisolated.spec.ts b/web/tests/e2e/single-thread-unisolated.spec.ts new file mode 100644 index 00000000..bdacde73 --- /dev/null +++ b/web/tests/e2e/single-thread-unisolated.spec.ts @@ -0,0 +1,110 @@ +import { expect, test } from "@playwright/test"; +import path from "node:path"; + +const basicBlend = path.resolve(import.meta.dirname, "../../../tests/files/web/basic_scene.blend"); + +test("boots and edits with the single-thread engine without cross-origin isolation", async ({ page }) => { + const engineAssetUrls: string[] = []; + page.on("request", (request) => { + const url = new URL(request.url()); + if (/web_engine|pthread/i.test(url.pathname)) engineAssetUrls.push(url.pathname); + }); + + const documentResponse = await page.goto("/"); + expect(documentResponse).not.toBeNull(); + const headers = await documentResponse!.allHeaders(); + expect(headers["cross-origin-opener-policy"]).toBeUndefined(); + expect(headers["cross-origin-embedder-policy"]).toBeUndefined(); + expect(headers["cross-origin-resource-policy"]).toBeUndefined(); + + const platform = await page.evaluate(async () => { + const { + detectBrowserCapabilities, + gateWasmThreadingCapability, + selectWebEngineVariant, + } = await import("/src/platform/capabilities.ts"); + const capabilities = detectBrowserCapabilities(); + const pthreadGate = gateWasmThreadingCapability(capabilities); + const manifest = await fetch("/engine-manifest.json", { cache: "no-store" }).then((response) => response.json()) as { + schemaVersion: number; + memory?: { shared: boolean }; + variants?: Array<{ + id: "single" | "pthread"; + memory: { shared: boolean }; + resources: { js: { url: string }; wasm: { url: string } }; + }>; + }; + const singleMemory = manifest.schemaVersion === 2 + ? manifest.variants?.find((variant) => variant.id === "single")?.memory + : manifest.memory; + const selection = selectWebEngineVariant( + manifest as Parameters[0], + "AUTO", + capabilities, + ); + if (!selection.selectedVariant) throw new Error("AUTO did not select a single-thread variant"); + const selected = selection.selectedVariant; + const wasmBinary = await fetch(selected.resources.wasm.url, { cache: "no-store" }) + .then((response) => { + if (!response.ok) throw new Error(`single WASM request failed: ${response.status}`); + return response.arrayBuffer(); + }); + const imported = await import(/* @vite-ignore */ selected.resources.js.url) as { + default: (options: { wasmBinary: ArrayBuffer }) => Promise<{ + HEAPU8: Uint8Array; + _web_engine_create(): number; + _web_engine_destroy(handle: number): void; + _web_engine_get_live_handles(): number; + }>; + }; + const module = await imported.default({ wasmBinary }); + const variantHandle = module._web_engine_create(); + const variantSharedMemory = typeof SharedArrayBuffer !== "undefined" && + module.HEAPU8.buffer instanceof SharedArrayBuffer; + module._web_engine_destroy(variantHandle); + return { + crossOriginIsolated: capabilities.crossOriginIsolated, + sharedArrayBuffer: capabilities.sharedArrayBuffer, + worker: capabilities.worker, + pthreadGate, + autoSelectedVariant: selected.id, + variantHandle, + variantSharedMemory, + variantLiveAfterDestroy: module._web_engine_get_live_handles(), + manifestSchemaVersion: manifest.schemaVersion, + manifestSharedMemory: singleMemory?.shared, + }; + }); + + expect(platform).toMatchObject({ + crossOriginIsolated: false, + sharedArrayBuffer: false, + worker: true, + autoSelectedVariant: "single", + variantSharedMemory: false, + variantLiveAfterDestroy: 0, + manifestSchemaVersion: 2, + manifestSharedMemory: false, + pthreadGate: { + taskId: "M6-02", + capability: "WASM_PTHREAD_ENGINE", + status: "BLOCKED", + }, + }); + expect(platform.variantHandle).toBeGreaterThan(0); + expect(platform.pthreadGate.issues.map((issue) => issue.path)).toEqual([ + "crossOriginIsolated", + "sharedArrayBuffer", + ]); + + await expect(page.getByTestId("engine-status")).toContainText("Engine: ready", { timeout: 30_000 }); + await expect(page.locator(".status-bar")).toContainText("WASM ABI: ready"); + expect(engineAssetUrls.some((url) => url.endsWith("/vendor/blender/web_engine.wasm"))).toBe(true); + expect(engineAssetUrls.some((url) => url.endsWith("/vendor/blender/single/web_engine.wasm"))).toBe(true); + expect(engineAssetUrls.some((url) => /pthread/i.test(url))).toBe(false); + + await page.setInputFiles("[data-testid=blend-file-input]", basicBlend); + await expect(page.getByTestId("scene-stats")).toContainText("Objects 3 · Vertices 8 · Faces 6"); + await page.getByRole("button", { name: "添加立方体" }).click(); + await expect(page.getByTestId("scene-stats")).toContainText("Objects 4 · Vertices 16 · Faces 18"); +}); diff --git a/web/tests/e2e/smoke.spec.ts b/web/tests/e2e/smoke.spec.ts index 6d76b774..37ac8137 100644 --- a/web/tests/e2e/smoke.spec.ts +++ b/web/tests/e2e/smoke.spec.ts @@ -1511,9 +1511,9 @@ test("autosaves a dirty project without starting a download", async ({ page }) = await page.goto("/"); await page.setInputFiles("[data-testid=blend-file-input]", basicBlend); await expect(page.getByText("BasicCube", { exact: true })).toBeVisible(); - await page.getByRole("button", { name: "已保存" }).click(); - await expect(page.getByRole("button", { name: "未保存" })).toBeVisible(); - await expect(page.getByRole("button", { name: "已保存" })).toBeVisible({ timeout: 15_000 }); + await page.getByRole("button", { name: "添加立方体" }).click(); + await expect(page.getByTestId("dirty-status")).toHaveText("未保存"); + await expect(page.getByTestId("dirty-status")).toHaveText("已保存", { timeout: 15_000 }); }); test("persists an operation log entry with an inverse payload", async ({ page }) => { diff --git a/web/tests/e2e/user-action-state.spec.ts b/web/tests/e2e/user-action-state.spec.ts new file mode 100644 index 00000000..67911952 --- /dev/null +++ b/web/tests/e2e/user-action-state.spec.ts @@ -0,0 +1,69 @@ +import { expect, test } from "@playwright/test"; +import path from "node:path"; + +const materialBlend = path.resolve(import.meta.dirname, "../../../tests/files/web/attribute_scene.blend"); +const exportableBlend = path.resolve(import.meta.dirname, "../../../tests/files/web/basic_scene.blend"); +const image = path.resolve(import.meta.dirname, "../../../tests/files/web/media/sequencer-frame.png"); + +test("M7-01 records import, open, save, save-as and export success", async ({ page }) => { + await page.goto("/"); + await expect(page.getByTestId("engine-status")).toContainText("ready, open a .blend file", { timeout: 20_000 }); + const app = page.locator(".blender-app"); + + await page.getByTestId("blend-file-input").setInputFiles(exportableBlend); + await expect(app).toHaveAttribute("data-user-action-open-status", "SUCCEEDED"); + await expect(app).toHaveAttribute("data-user-action-open-id", /^OPEN:\d+$/); + + const glbDownload = page.waitForEvent("download"); + await page.getByRole("button", { name: "导出 GLB" }).click(); + expect((await glbDownload).suggestedFilename()).toBe("blender-web.glb"); + await expect(app).toHaveAttribute("data-user-action-export-status", "SUCCEEDED"); + await expect(app).toHaveAttribute("data-user-action-export-id", /^EXPORT:\d+$/); + + await page.getByTestId("blend-file-input").setInputFiles(materialBlend); + await expect(app).toHaveAttribute("data-user-action-open-status", "SUCCEEDED"); + await page.locator("label.file-button input[type=file]").setInputFiles(image); + await expect(app).toHaveAttribute("data-user-action-import-status", "SUCCEEDED"); + await expect(app).toHaveAttribute("data-user-action-import-id", /^IMPORT:\d+$/); + + const blendDownload = page.waitForEvent("download"); + await page.getByRole("button", { name: "保存项目" }).click(); + expect((await blendDownload).suggestedFilename()).toBe("blender-web.blend"); + await expect(app).toHaveAttribute("data-user-action-save-status", "SUCCEEDED"); + await expect(app).toHaveAttribute("data-user-action-save-as-status", "SUCCEEDED"); + await expect(app).toHaveAttribute("data-user-action-save-id", /^SAVE:\d+$/); + await expect(app).toHaveAttribute("data-user-action-save-as-id", /^SAVE_AS:\d+$/); + await expect(app).toHaveAttribute("data-save-transaction-status", "SUCCEEDED"); + await expect(app).toHaveAttribute("data-save-transaction-stage", "METADATA_COMMIT"); + await expect(app).toHaveAttribute("data-save-committed-hash", /^[a-f0-9]{64}$/); + +}); + +test("M7-01 exposes stable failure codes without replacing the last valid scene", async ({ page }) => { + await page.goto("/"); + await expect(page.getByTestId("engine-status")).toContainText("ready, open a .blend file", { timeout: 20_000 }); + const app = page.locator(".blender-app"); + + await page.getByRole("button", { name: "导出 GLB" }).click(); + await expect(app).toHaveAttribute("data-user-action-export-status", "FAILED"); + await expect(app).toHaveAttribute("data-user-action-export-error", "EXPORT_PROJECT_UNAVAILABLE"); + + await page.getByTestId("blend-file-input").setInputFiles(materialBlend); + await expect(page.getByText("AttributeMeshObject", { exact: true })).toBeVisible(); + await page.getByTestId("blend-file-input").setInputFiles({ + name: "invalid.blend", + mimeType: "application/octet-stream", + buffer: Buffer.from([0x42, 0x41, 0x44]), + }); + await expect(app).toHaveAttribute("data-user-action-open-status", "FAILED"); + await expect(app).toHaveAttribute("data-user-action-open-error", "OPEN_ENGINE_FAILED"); + await expect(page.getByText("AttributeMeshObject", { exact: true })).toBeVisible(); + + await page.locator("label.file-button input[type=file]").setInputFiles({ + name: "invalid.png", + mimeType: "image/png", + buffer: Buffer.from("not-a-png"), + }); + await expect(app).toHaveAttribute("data-user-action-import-status", "FAILED"); + await expect(app).toHaveAttribute("data-user-action-import-error", "IMPORT_DECODE_FAILED"); +}); diff --git a/web/tests/e2e/wasm-threading-capability.spec.ts b/web/tests/e2e/wasm-threading-capability.spec.ts index 3fc2008a..454c3708 100644 --- a/web/tests/e2e/wasm-threading-capability.spec.ts +++ b/web/tests/e2e/wasm-threading-capability.spec.ts @@ -1,10 +1,15 @@ import { expect, test } from "@playwright/test"; test("gates only the pthread WASM engine on its three platform requirements", async ({ page }) => { - await page.goto("/"); + const documentResponse = await page.goto("/"); + expect(documentResponse).not.toBeNull(); + await expect.poll(async () => (await documentResponse!.allHeaders())["cross-origin-opener-policy"]).toBe("same-origin"); + await expect.poll(async () => (await documentResponse!.allHeaders())["cross-origin-embedder-policy"]).toBe("require-corp"); + await expect.poll(async () => (await documentResponse!.allHeaders())["cross-origin-resource-policy"]).toBe("same-origin"); const gates = await page.evaluate(async () => { - const { gateWasmThreadingCapability } = await import("/src/platform/capabilities.ts"); + const { detectBrowserCapabilities, gateWasmThreadingCapability } = await import("/src/platform/capabilities.ts"); return { + actual: gateWasmThreadingCapability(detectBrowserCapabilities()), ready: gateWasmThreadingCapability({ crossOriginIsolated: true, sharedArrayBuffer: true, worker: true }), noIsolation: gateWasmThreadingCapability({ crossOriginIsolated: false, sharedArrayBuffer: true, worker: true }), noSharedArrayBuffer: gateWasmThreadingCapability({ crossOriginIsolated: true, sharedArrayBuffer: false, worker: true }), @@ -13,6 +18,11 @@ test("gates only the pthread WASM engine on its three platform requirements", as }; }); + expect(gates.actual).toMatchObject({ + capability: "WASM_PTHREAD_ENGINE", + status: "READY", + issues: [], + }); expect(gates.ready).toEqual({ taskId: "M6-02", capability: "WASM_PTHREAD_ENGINE", diff --git a/web/tests/unit/dirty-state.test.mjs b/web/tests/unit/dirty-state.test.mjs new file mode 100644 index 00000000..35ce19ca --- /dev/null +++ b/web/tests/unit/dirty-state.test.mjs @@ -0,0 +1,55 @@ +import assert from "node:assert/strict"; +import fs from "node:fs"; +import path from "node:path"; +import test from "node:test"; +import ts from "typescript"; + +const repoRoot = path.resolve(import.meta.dirname, "../../.."); +const sourcePath = path.join(repoRoot, "web/protocol/dirty-state.ts"); +const transpiled = ts.transpileModule(fs.readFileSync(sourcePath, "utf8"), { + compilerOptions: { module: ts.ModuleKind.ES2022, target: ts.ScriptTarget.ES2022 }, + fileName: sourcePath, + reportDiagnostics: true, +}); +assert.deepEqual(transpiled.diagnostics, []); +const moduleUrl = `data:text/javascript;base64,${Buffer.from(transpiled.outputText).toString("base64")}`; +const { acceptHistoryTransaction, acceptMainSave, acceptMainTransaction, createDirtyState, recoverDirtyState } = await import(moduleUrl); + +test("M7-06 only marks dirty after an accepted Main transaction", () => { + const clean = createDirtyState(7); + const stale = acceptMainTransaction(clean, 7); + assert.deepEqual(stale, { ok: false, state: clean, errorCode: "DIRTY_REVISION_STALE" }); + const edited = acceptMainTransaction(clean, 8); + assert.equal(edited.ok, true); + assert.deepEqual(edited.state, { currentMainRevision: 8, committedMainRevision: 7, dirty: true }); +}); + +test("M7-06 failed, preview and UI-only work preserve the same dirty object", () => { + const clean = createDirtyState(3); + const failedCommandState = clean; + const previewState = failedCommandState; + const uiOnlyState = previewState; + assert.equal(failedCommandState, clean); + assert.equal(previewState, clean); + assert.equal(uiOnlyState, clean); +}); + +test("M7-06 clears dirty only for a save matching the accepted Main revision", () => { + const edited = recoverDirtyState(9, 7); + assert.deepEqual(acceptMainSave(edited, 8), { ok: false, state: edited, errorCode: "DIRTY_SAVE_REVISION_MISMATCH" }); + const saved = acceptMainSave(edited, 9); + assert.equal(saved.ok, true); + assert.deepEqual(saved.state, { currentMainRevision: 9, committedMainRevision: 9, dirty: false }); +}); + +test("M7-07 keeps transaction revisions monotonic while undo content toggles dirty", () => { + const saved = createDirtyState(10); + const edited = acceptMainTransaction(saved, 11); + assert.equal(edited.ok, true); + const undone = acceptHistoryTransaction(edited.state, 12, true); + assert.equal(undone.ok, true); + assert.deepEqual(undone.state, { currentMainRevision: 12, committedMainRevision: 12, dirty: false }); + const redone = acceptHistoryTransaction(undone.state, 13, false); + assert.equal(redone.ok, true); + assert.deepEqual(redone.state, { currentMainRevision: 13, committedMainRevision: 12, dirty: true }); +}); diff --git a/web/tests/unit/engine-manifest-v2.test.mjs b/web/tests/unit/engine-manifest-v2.test.mjs new file mode 100644 index 00000000..52f3f577 --- /dev/null +++ b/web/tests/unit/engine-manifest-v2.test.mjs @@ -0,0 +1,97 @@ +import assert from "node:assert/strict"; +import fs from "node:fs"; +import path from "node:path"; +import test from "node:test"; +import ts from "typescript"; + +const repoRoot = path.resolve(import.meta.dirname, "../../.."); +const protocolPath = path.join(repoRoot, "web/protocol/manifest.ts"); +const protocolSource = fs.readFileSync(protocolPath, "utf8"); +const transpiled = ts.transpileModule(protocolSource, { + compilerOptions: { module: ts.ModuleKind.ES2022, target: ts.ScriptTarget.ES2022 }, + fileName: protocolPath, + reportDiagnostics: true, +}); +assert.deepEqual(transpiled.diagnostics, []); +const protocol = await import(`data:text/javascript;base64,${Buffer.from(transpiled.outputText).toString("base64")}`); +const { validateWebEngineManifestV2 } = protocol; +const goldenPath = path.join(repoRoot, "tests/golden/M6-04A/engine-manifest-v2.json"); +const golden = JSON.parse(fs.readFileSync(goldenPath, "utf8")); +const packageJson = JSON.parse(fs.readFileSync(path.join(repoRoot, "web/package.json"), "utf8")); + +function deepFreeze(value) { + if (value && typeof value === "object") { + Object.freeze(value); + for (const item of Object.values(value)) deepFreeze(item); + } + return value; +} + +function invalidCase(name, mutate, code, errorPath) { + return { name, mutate, code, errorPath }; +} + +test("M6-04A accepts an immutable single/pthread manifest without mutating it", () => { + const input = deepFreeze(structuredClone(golden)); + const parsed = validateWebEngineManifestV2(input); + + assert.deepEqual(parsed, golden); + assert.notEqual(parsed, input); + assert.notEqual(parsed.variants[0], input.variants[0]); + assert.notEqual(parsed.variants[0].resources.js, input.variants[0].resources.js); + assert.equal(parsed.variants[1].resources.pthreadWorker.url, parsed.variants[1].resources.js.url); + assert.equal(protocol.WEB_ENGINE_WASM_PAGE_BYTES, 65_536); + assert.deepEqual(protocol.WEB_ENGINE_MEMORY_LIMITS, { + minimumInitialPages: 256, + maximumPages: 32_768, + }); + + const reversed = validateWebEngineManifestV2({ ...golden, variants: [...golden.variants].reverse() }); + assert.deepEqual(reversed.variants.map((variant) => variant.id), ["single", "pthread"]); +}); + +test("M6-04A rejects malformed variants, resources and memory declarations", async (t) => { + const cases = [ + invalidCase("old schema", (value) => { value.schemaVersion = 1; }, "PROTOCOL_MISMATCH", "schemaVersion"), + invalidCase("unsupported protocol", (value) => { value.protocolVersion = 2; }, "PROTOCOL_MISMATCH", "protocolVersion"), + invalidCase("missing release ID", (value) => { delete value.releaseId; }, "ENGINE_MANIFEST_INVALID", "releaseId"), + invalidCase("invalid release ID", (value) => { value.releaseId = "release/id"; }, "ENGINE_MANIFEST_INVALID", "releaseId"), + invalidCase("missing pthread variant", (value) => { value.variants.pop(); }, "ENGINE_MANIFEST_INVALID", "variants"), + invalidCase("duplicate single variant", (value) => { value.variants[1].id = "single"; delete value.variants[1].resources.pthreadWorker; value.variants[1].memory.shared = false; }, "ENGINE_MANIFEST_INVALID", "variants"), + invalidCase("single shared memory", (value) => { value.variants[0].memory.shared = true; }, "ENGINE_MANIFEST_INVALID", "variants[0].memory.shared"), + invalidCase("single pthread worker", (value) => { value.variants[0].resources.pthreadWorker = structuredClone(value.variants[1].resources.pthreadWorker); }, "ENGINE_MANIFEST_INVALID", "variants[0].resources.pthreadWorker"), + invalidCase("pthread unshared memory", (value) => { value.variants[1].memory.shared = false; }, "ENGINE_MANIFEST_INVALID", "variants[1].memory.shared"), + invalidCase("missing pthread worker", (value) => { delete value.variants[1].resources.pthreadWorker; }, "ENGINE_MANIFEST_INVALID", "variants[1].resources.pthreadWorker"), + invalidCase("invalid SHA-256", (value) => { value.variants[1].resources.wasm.sha256 = "ABC"; }, "ENGINE_MANIFEST_INVALID", "variants[1].resources.wasm.sha256"), + invalidCase("remote resource URL", (value) => { value.variants[0].resources.js.url = "https://cdn.invalid/web_engine.single.js"; }, "ENGINE_MANIFEST_INVALID", "variants[0].resources.js.url"), + invalidCase("file name mismatch", (value) => { value.variants[0].resources.wasm.url = "/vendor/blender/wrong.wasm"; }, "ENGINE_MANIFEST_INVALID", "variants[0].resources.wasm.url"), + invalidCase("initial memory below floor", (value) => { value.variants[0].memory.initialPages = 255; }, "ENGINE_MANIFEST_INVALID", "variants[0].memory.initialPages"), + invalidCase("maximum memory below initial", (value) => { value.variants[1].memory.maximumPages = 255; }, "ENGINE_MANIFEST_INVALID", "variants[1].memory.maximumPages"), + invalidCase("maximum memory above ceiling", (value) => { value.variants[1].memory.maximumPages = 32_769; }, "ENGINE_MANIFEST_INVALID", "variants[1].memory.maximumPages"), + invalidCase("aliased variant WASM", (value) => { value.variants[1].resources.wasm = structuredClone(value.variants[0].resources.wasm); }, "ENGINE_MANIFEST_INVALID", "variants.wasm"), + invalidCase("worker aliases single JS", (value) => { value.variants[1].resources.pthreadWorker = structuredClone(value.variants[0].resources.js); }, "ENGINE_MANIFEST_INVALID", "variants.pthreadWorker"), + invalidCase("same worker URL with another hash", (value) => { value.variants[1].resources.pthreadWorker.sha256 = "5".repeat(64); }, "ENGINE_MANIFEST_INVALID", "variants.pthreadWorker.sha256"), + invalidCase("unknown manifest field", (value) => { value.defaultVariant = "pthread"; }, "ENGINE_MANIFEST_INVALID", "manifest.defaultVariant"), + ]; + + for (const item of cases) { + await t.test(item.name, () => { + const input = structuredClone(golden); + item.mutate(input); + assert.throws( + () => validateWebEngineManifestV2(input), + (error) => error?.name === "WebEngineManifestValidationError" && + error.code === item.code && error.path === item.errorPath, + ); + }); + } +}); + +test("M6-04B installs the production manifest with explicit variant paths", () => { + const production = JSON.parse(fs.readFileSync(path.join(repoRoot, "web/app/public/engine-manifest.json"), "utf8")); + const parsed = validateWebEngineManifestV2(production); + assert.equal(parsed.releaseId, `blender-wasm-${packageJson.version}`); + assert.equal(parsed.variants[0].resources.wasm.url, "/vendor/blender/single/web_engine.wasm"); + assert.equal(parsed.variants[1].resources.wasm.url, "/vendor/blender/pthread/web_engine.wasm"); + assert.notEqual(parsed.variants[0].resources.wasm.sha256, parsed.variants[1].resources.wasm.sha256); +}); diff --git a/web/tests/unit/engine-variant-fallback.test.mjs b/web/tests/unit/engine-variant-fallback.test.mjs new file mode 100644 index 00000000..ec9d845f --- /dev/null +++ b/web/tests/unit/engine-variant-fallback.test.mjs @@ -0,0 +1,249 @@ +import assert from "node:assert/strict"; +import fs from "node:fs"; +import path from "node:path"; +import test from "node:test"; +import ts from "typescript"; + +const repoRoot = path.resolve(import.meta.dirname, "../../.."); + +function transpileDataUrl(filePath, replacements = new Map()) { + const result = ts.transpileModule(fs.readFileSync(filePath, "utf8"), { + compilerOptions: { module: ts.ModuleKind.ES2022, target: ts.ScriptTarget.ES2022 }, + fileName: filePath, + reportDiagnostics: true, + }); + assert.deepEqual(result.diagnostics, []); + let source = result.outputText; + for (const [specifier, replacement] of replacements) { + source = source.replaceAll(`"${specifier}"`, JSON.stringify(replacement)); + } + return `data:text/javascript;base64,${Buffer.from(source).toString("base64")}`; +} + +const gatesUrl = transpileDataUrl(path.join(repoRoot, "web/protocol/capability-gates.ts")); +const selectorUrl = transpileDataUrl( + path.join(repoRoot, "web/protocol/engine-variant.ts"), + new Map([["./capability-gates", gatesUrl]]), +); +const bootstrapUrl = transpileDataUrl( + path.join(repoRoot, "web/app/src/engine-client/engine-variant-bootstrap.ts"), + new Map([["../../../protocol/engine-variant", selectorUrl]]), +); +const { + bootstrapWebEngineRelease, + engineVariantStatusLabel, + EngineVariantLoadError, +} = await import(bootstrapUrl); +const manifest = JSON.parse(fs.readFileSync( + path.join(repoRoot, "tests/golden/M6-04A/engine-manifest-v2.json"), + "utf8", +)); +const ready = { crossOriginIsolated: true, sharedArrayBuffer: true, worker: true }; + +class FakeSession { + constructor(variant) { + this.variant = variant; + this.opened = []; + this.disposals = 0; + this.state = { + handles: 1, + workers: variant.id === "pthread" ? 1 : 0, + timers: 0, + pendingRequests: 0, + }; + } + + async openProject(project) { + this.opened.push(project); + } + + resourceState() { + return { ...this.state }; + } + + testOnlySeedTrackedResources() { + this.state.timers = 1; + this.state.pendingRequests = 1; + } + + async dispose() { + this.disposals += 1; + this.state = { handles: 0, workers: 0, timers: 0, pendingRequests: 0 }; + return this.resourceState(); + } +} + +function dependencies() { + const sessions = []; + return { + sessions, + initialize: async (variant) => { + const session = new FakeSession(variant); + sessions.push(session); + return session; + }, + }; +} + +test("M6-05A/B/C injects one pthread failure, cleans it and falls back once", async () => { + const deps = dependencies(); + const outcome = await bootstrapWebEngineRelease( + manifest.releaseId, + manifest, + "AUTO", + ready, + deps, + undefined, + { failPthreadAfterInitialize: true, seedTrackedPthreadResources: true }, + ); + + assert.deepEqual(outcome.result.attempted, ["pthread", "single"]); + assert.equal(deps.sessions.length, 2); + assert.equal(deps.sessions[0].disposals, 1); + assert.deepEqual(outcome.result.failedAttemptCleanup, { + handles: 0, + workers: 0, + timers: 0, + pendingRequests: 0, + }); + assert.equal(outcome.result.selected, "single"); + assert.deepEqual(outcome.result.fallbackReason, { + code: "PTHREAD_INITIALIZATION_FAILED", + message: "TEST_PTHREAD_INITIALIZATION_FAILURE", + }); + assert.equal(outcome.result.openCount, 0); + assert.equal(deps.sessions[0].opened.length, 0); + assert.equal(deps.sessions[1].opened.length, 0); +}); + +test("M6-05D opens a pending project once only after the fallback settles", async () => { + const deps = dependencies(); + const project = { id: "pending-project" }; + const outcome = await bootstrapWebEngineRelease( + manifest.releaseId, + manifest, + "AUTO", + ready, + deps, + project, + { failPthreadAfterInitialize: true }, + ); + + assert.equal(outcome.result.openCount, 1); + assert.deepEqual(deps.sessions[0].opened, []); + assert.deepEqual(deps.sessions[1].opened, [project]); +}); + +test("M6-05E exposes selected, attempted and fallbackReason without pthread READY UI", async () => { + const deps = dependencies(); + const outcome = await bootstrapWebEngineRelease( + manifest.releaseId, + manifest, + "AUTO", + ready, + deps, + undefined, + { failPthreadAfterInitialize: true }, + ); + const label = engineVariantStatusLabel(outcome.result); + + assert.deepEqual( + { + selected: outcome.result.selected, + attempted: outcome.result.attempted, + fallbackReason: outcome.result.fallbackReason?.code, + }, + { + selected: "single", + attempted: ["pthread", "single"], + fallbackReason: "PTHREAD_INITIALIZATION_FAILED", + }, + ); + assert.equal(label, "Runtime: single (pthread fallback: PTHREAD_INITIALIZATION_FAILED)"); + assert.doesNotMatch(label, /pthread\s+ready/i); +}); + +test("M6-08E treats a manifest hash mismatch as fatal without fallback or project open", async () => { + const initialized = []; + const project = { id: "must-stay-unopened" }; + await assert.rejects( + bootstrapWebEngineRelease( + manifest.releaseId, + manifest, + "AUTO", + ready, + { + initialize: async (variant) => { + initialized.push(variant.id); + if (variant.id === "pthread") { + throw new EngineVariantLoadError("ENGINE_VARIANT_RESOURCE_HASH_MISMATCH", variant.resources.wasm.url); + } + return new FakeSession(variant); + }, + }, + project, + ), + (error) => error?.code === "ENGINE_VARIANT_INTEGRITY_FAILED" && + error.cause?.code === "ENGINE_VARIANT_RESOURCE_HASH_MISMATCH" && + JSON.stringify(error.attempted) === JSON.stringify(["pthread"]), + ); + assert.deepEqual(initialized, ["pthread"]); +}); + +test("M6-08D returns refresh-required before initialization or project open", async () => { + let initializationCount = 0; + const outcome = await bootstrapWebEngineRelease( + "blender-wasm-previous", + manifest, + "AUTO", + ready, + { + initialize: async (variant) => { + initializationCount += 1; + return new FakeSession(variant); + }, + }, + { id: "must-stay-unopened" }, + ); + + assert.deepEqual(outcome, { + result: { + status: "REFRESH_REQUIRED", + expectedReleaseId: "blender-wasm-previous", + actualReleaseId: manifest.releaseId, + manifest: null, + }, + session: null, + }); + assert.equal(initializationCount, 0); +}); + +test("M6-08E normalizes a fallback variant hash mismatch and never opens the project", async () => { + const initialized = []; + const pthreadSession = new FakeSession(manifest.variants[1]); + await assert.rejects( + bootstrapWebEngineRelease( + manifest.releaseId, + manifest, + "AUTO", + ready, + { + initialize: async (variant) => { + initialized.push(variant.id); + if (variant.id === "single") { + throw new EngineVariantLoadError("ENGINE_VARIANT_RESOURCE_HASH_MISMATCH", variant.resources.wasm.url); + } + return pthreadSession; + }, + }, + { id: "must-stay-unopened" }, + { failPthreadAfterInitialize: true }, + ), + (error) => error?.code === "ENGINE_VARIANT_INTEGRITY_FAILED" && + error.cause?.code === "ENGINE_VARIANT_RESOURCE_HASH_MISMATCH" && + JSON.stringify(error.attempted) === JSON.stringify(["pthread", "single"]), + ); + assert.deepEqual(initialized, ["pthread", "single"]); + assert.equal(pthreadSession.disposals, 1); + assert.deepEqual(pthreadSession.opened, []); +}); diff --git a/web/tests/unit/engine-variant-selection.test.mjs b/web/tests/unit/engine-variant-selection.test.mjs new file mode 100644 index 00000000..46ca8538 --- /dev/null +++ b/web/tests/unit/engine-variant-selection.test.mjs @@ -0,0 +1,125 @@ +import assert from "node:assert/strict"; +import fs from "node:fs"; +import path from "node:path"; +import test from "node:test"; +import ts from "typescript"; + +const repoRoot = path.resolve(import.meta.dirname, "../../.."); + +function transpileDataUrl(filePath, replacements = new Map()) { + const result = ts.transpileModule(fs.readFileSync(filePath, "utf8"), { + compilerOptions: { module: ts.ModuleKind.ES2022, target: ts.ScriptTarget.ES2022 }, + fileName: filePath, + reportDiagnostics: true, + }); + assert.deepEqual(result.diagnostics, []); + let source = result.outputText; + for (const [specifier, replacement] of replacements) { + source = source.replaceAll(`"${specifier}"`, JSON.stringify(replacement)); + } + return `data:text/javascript;base64,${Buffer.from(source).toString("base64")}`; +} + +const gatesUrl = transpileDataUrl(path.join(repoRoot, "web/protocol/capability-gates.ts")); +const selectorUrl = transpileDataUrl( + path.join(repoRoot, "web/protocol/engine-variant.ts"), + new Map([["./capability-gates", gatesUrl]]), +); +const { bindWebEngineRelease, gateWasmThreadingCapability, selectWebEngineVariant } = await import(selectorUrl); +const manifest = JSON.parse(fs.readFileSync( + path.join(repoRoot, "tests/golden/M6-04A/engine-manifest-v2.json"), + "utf8", +)); +const ready = { crossOriginIsolated: true, sharedArrayBuffer: true, worker: true }; + +function deepFreeze(value) { + if (value && typeof value === "object") { + Object.freeze(value); + for (const item of Object.values(value)) deepFreeze(item); + } + return value; +} + +test("M6-04C selects from only its manifest, policy and capability inputs", () => { + const frozenManifest = deepFreeze(structuredClone(manifest)); + const frozenCapabilities = deepFreeze({ ...ready }); + const first = selectWebEngineVariant(frozenManifest, "SINGLE_REQUIRED", frozenCapabilities); + const second = selectWebEngineVariant(frozenManifest, "SINGLE_REQUIRED", frozenCapabilities); + + assert.deepEqual(first, second); + assert.equal(first.policy, "SINGLE_REQUIRED"); + assert.equal(first.selectedVariant, frozenManifest.variants[0]); + assert.equal(first.selectedVariant.id, "single"); + assert.equal(first.pthreadGate.status, "READY"); + assert.throws( + () => selectWebEngineVariant(frozenManifest, "INVALID", frozenCapabilities), + /ENGINE_VARIANT_POLICY_INVALID/, + ); +}); + +test("M6-04D AUTO selects pthread only when the M6-02 gate is READY", () => { + const capabilityCases = [ + [ready, "pthread", []], + [{ ...ready, crossOriginIsolated: false }, "single", ["crossOriginIsolated"]], + [{ ...ready, sharedArrayBuffer: false }, "single", ["sharedArrayBuffer"]], + [{ ...ready, worker: false }, "single", ["worker"]], + [ + { crossOriginIsolated: false, sharedArrayBuffer: false, worker: false }, + "single", + ["crossOriginIsolated", "sharedArrayBuffer", "worker"], + ], + ]; + + for (const [capabilities, expectedId, expectedPaths] of capabilityCases) { + const selection = selectWebEngineVariant(manifest, "AUTO", capabilities); + assert.equal(selection.selectedVariant.id, expectedId); + assert.equal(selection.pthreadGate.status, expectedId === "pthread" ? "READY" : "BLOCKED"); + assert.deepEqual(selection.pthreadGate.issues.map((issue) => issue.path), expectedPaths); + } +}); + +test("M6-04E PTHREAD_REQUIRED exposes the M6-02 block without a requestable variant", () => { + const capabilities = { crossOriginIsolated: false, sharedArrayBuffer: false, worker: true }; + const expectedGate = gateWasmThreadingCapability(capabilities); + const blocked = selectWebEngineVariant(manifest, "PTHREAD_REQUIRED", capabilities); + assert.equal(blocked.selectedVariant, null); + assert.deepEqual(blocked.pthreadGate, expectedGate); + assert.deepEqual(blocked.pthreadGate, { + taskId: "M6-02", + capability: "WASM_PTHREAD_ENGINE", + status: "BLOCKED", + issues: [ + { + code: "PLATFORM_CAPABILITY_UNAVAILABLE", + message: "Cross-origin isolation is required for the pthread WASM engine", + path: "crossOriginIsolated", + recoverable: true, + }, + { + code: "PLATFORM_CAPABILITY_UNAVAILABLE", + message: "SharedArrayBuffer is required for the pthread WASM engine", + path: "sharedArrayBuffer", + recoverable: true, + }, + ], + }); + + const allowed = selectWebEngineVariant(manifest, "PTHREAD_REQUIRED", ready); + assert.equal(allowed.selectedVariant.id, "pthread"); + assert.equal(allowed.pthreadGate.status, "READY"); +}); + +test("M6-08C/D binds both variants to one release and refuses mixed-version startup", () => { + const current = bindWebEngineRelease(manifest.releaseId, manifest); + assert.equal(current.status, "READY"); + assert.equal(current.manifest, manifest); + assert.deepEqual(current.manifest.variants.map((variant) => variant.id), ["single", "pthread"]); + + const switched = bindWebEngineRelease("blender-wasm-previous", manifest); + assert.deepEqual(switched, { + status: "REFRESH_REQUIRED", + expectedReleaseId: "blender-wasm-previous", + actualReleaseId: manifest.releaseId, + manifest: null, + }); +}); diff --git a/web/tests/unit/file-byte-reader.test.mjs b/web/tests/unit/file-byte-reader.test.mjs new file mode 100644 index 00000000..7cb8123a --- /dev/null +++ b/web/tests/unit/file-byte-reader.test.mjs @@ -0,0 +1,84 @@ +import assert from "node:assert/strict"; +import fs from "node:fs"; +import path from "node:path"; +import test from "node:test"; +import ts from "typescript"; + +const repoRoot = path.resolve(import.meta.dirname, "../../.."); +const sourcePath = path.join(repoRoot, "web/protocol/file-byte-reader.ts"); +const transpiled = ts.transpileModule(fs.readFileSync(sourcePath, "utf8"), { + compilerOptions: { module: ts.ModuleKind.ES2022, target: ts.ScriptTarget.ES2022 }, + fileName: sourcePath, + reportDiagnostics: true, +}); +assert.deepEqual(transpiled.diagnostics, []); +const moduleUrl = `data:text/javascript;base64,${Buffer.from(transpiled.outputText).toString("base64")}`; +const { FileByteReadError, readFileBytes } = await import(moduleUrl); + +function chunkSource(chunks, declaredSize = chunks.reduce((total, chunk) => total + (chunk.byteLength ?? chunk.length), 0)) { + return { + size: declaredSize, + stream() { + let index = 0; + return new ReadableStream({ + pull(controller) { + if (index === chunks.length) controller.close(); + else controller.enqueue(Uint8Array.from(chunks[index++])); + }, + }); + }, + }; +} + +test("M7-03 reports progress from exact consumed byte counts", async () => { + const observations = []; + const result = await readFileBytes(chunkSource([[1, 2], [3, 4, 5], [6]]), { + signal: new AbortController().signal, + onProgress: (item) => observations.push(item), + }); + assert.deepEqual(Array.from(new Uint8Array(result)), [1, 2, 3, 4, 5, 6]); + assert.deepEqual(observations.map(({ phase, bytesRead, totalBytes, fraction }) => [phase, bytesRead, totalBytes, fraction]), [ + ["STARTED", 0, 6, 0], + ["READING", 2, 6, 2 / 6], + ["READING", 5, 6, 5 / 6], + ["READING", 6, 6, 1], + ["COMPLETED", 6, 6, 1], + ]); +}); + +test("M7-03 cancels between chunks without reporting completion", async () => { + const controller = new AbortController(); + const observations = []; + const resources = []; + await assert.rejects( + readFileBytes(chunkSource([[1, 2], [3, 4], [5, 6]]), { + signal: controller.signal, + onProgress: (item) => { + observations.push(item); + if (item.phase === "READING" && item.bytesRead === 2) controller.abort(); + }, + onResourceState: (state) => resources.push(state), + }), + (error) => error instanceof FileByteReadError && error.code === "FILE_READ_CANCELLED", + ); + assert.deepEqual(observations.map((item) => [item.phase, item.bytesRead]), [ + ["STARTED", 0], + ["READING", 2], + ["CANCELLED", 2], + ]); + assert.deepEqual(resources, [ + { liveReaders: 1, liveInputBytes: 6, liveStagingFiles: 0 }, + { liveReaders: 0, liveInputBytes: 0, liveStagingFiles: 0 }, + ]); +}); + +test("M7-03 rejects streams shorter or longer than their declared byte size", async () => { + await assert.rejects( + readFileBytes(chunkSource([[1, 2]], 3), { signal: new AbortController().signal }), + (error) => error instanceof FileByteReadError && error.code === "FILE_READ_SIZE_MISMATCH", + ); + await assert.rejects( + readFileBytes(chunkSource([[1, 2, 3]], 2), { signal: new AbortController().signal }), + (error) => error instanceof FileByteReadError && error.code === "FILE_READ_SIZE_MISMATCH", + ); +}); diff --git a/web/tests/unit/local-deps.test.mjs b/web/tests/unit/local-deps.test.mjs index e9c409fc..ff58332a 100644 --- a/web/tests/unit/local-deps.test.mjs +++ b/web/tests/unit/local-deps.test.mjs @@ -30,6 +30,10 @@ test("required renderer and engine assets are vendored", () => { "app/src/vendor/blender/web_engine.wasm", "app/public/vendor/blender/web_engine.js", "app/public/vendor/blender/web_engine.wasm", + "app/public/vendor/blender/single/web_engine.js", + "app/public/vendor/blender/single/web_engine.wasm", + "app/public/vendor/blender/pthread/web_engine.js", + "app/public/vendor/blender/pthread/web_engine.wasm", ]; for (const relativePath of requiredFiles) { const filePath = path.join(webRoot, relativePath); @@ -47,6 +51,12 @@ test("required renderer and engine assets are vendored", () => { } }); +test("schema v2 engine assets carry a valid release identity", () => { + const manifest = JSON.parse(fs.readFileSync(path.join(webRoot, "app/public/engine-manifest.json"), "utf8")); + assert.equal(manifest.schemaVersion, 2); + assert.match(manifest.releaseId, /^[A-Za-z0-9][A-Za-z0-9._+-]{0,127}$/); +}); + test("attribute geometry fixture is reproducible input", () => { const fixture = path.join(webRoot, "..", "tests/files/web/attribute_scene.blend"); const manifest = JSON.parse(fs.readFileSync(path.join(webRoot, "..", "tests/files/web/manifest.json"), "utf8")); diff --git a/web/tests/unit/project-action-mutex.test.mjs b/web/tests/unit/project-action-mutex.test.mjs new file mode 100644 index 00000000..4ef01af7 --- /dev/null +++ b/web/tests/unit/project-action-mutex.test.mjs @@ -0,0 +1,68 @@ +import assert from "node:assert/strict"; +import fs from "node:fs"; +import path from "node:path"; +import test from "node:test"; +import ts from "typescript"; + +const repoRoot = path.resolve(import.meta.dirname, "../../.."); +const sourcePath = path.join(repoRoot, "web/protocol/project-action-mutex.ts"); +const transpiled = ts.transpileModule(fs.readFileSync(sourcePath, "utf8"), { + compilerOptions: { module: ts.ModuleKind.ES2022, target: ts.ScriptTarget.ES2022 }, + fileName: sourcePath, + reportDiagnostics: true, +}); +assert.deepEqual(transpiled.diagnostics, []); +const moduleUrl = `data:text/javascript;base64,${Buffer.from(transpiled.outputText).toString("base64")}`; +const { + PROJECT_ACTION_CONFLICT_MATRIX, + acquireProjectAction, + createProjectActionMutexState, + releaseProjectAction, +} = await import(moduleUrl); + +const action = (kind, sequence) => ({ kind, actionId: `${kind}:${sequence}` }); + +test("M7-02 keeps the project action conflict matrix symmetric and exclusive", () => { + for (const requested of ["OPEN", "SAVE", "CLOSE"]) { + for (const owner of ["OPEN", "SAVE", "CLOSE"]) { + assert.equal(PROJECT_ACTION_CONFLICT_MATRIX[requested][owner], true); + assert.equal(PROJECT_ACTION_CONFLICT_MATRIX[requested][owner], PROJECT_ACTION_CONFLICT_MATRIX[owner][requested]); + } + } +}); + +test("M7-02 rejects repeated open with its original owner unchanged", () => { + const first = action("OPEN", 1); + const second = action("OPEN", 2); + const acquired = acquireProjectAction(createProjectActionMutexState(), first); + assert.equal(acquired.granted, true); + assert.deepEqual(acquireProjectAction(acquired.state, second), { + granted: false, + state: acquired.state, + conflict: { code: "USER_ACTION_CONFLICT", reason: "REPEATED_OPEN", requested: second, owner: first }, + }); +}); + +test("M7-02 rejects concurrent save and close-during-save with stable reasons", () => { + const first = action("SAVE", 1); + const acquired = acquireProjectAction(createProjectActionMutexState(), first); + assert.equal(acquired.granted, true); + assert.equal(acquireProjectAction(acquired.state, action("SAVE", 2)).conflict.reason, "CONCURRENT_SAVE"); + assert.equal(acquireProjectAction(acquired.state, action("CLOSE", 3)).conflict.reason, "CLOSE_DURING_SAVE"); +}); + +test("M7-02 only lets the exact owner release the project lock", () => { + const owner = action("SAVE", 1); + const acquired = acquireProjectAction(createProjectActionMutexState(), owner); + assert.equal(acquired.granted, true); + assert.deepEqual(releaseProjectAction(acquired.state, action("SAVE", 2)), { + released: false, + state: acquired.state, + errorCode: "PROJECT_ACTION_LOCK_IDENTITY_MISMATCH", + }); + assert.deepEqual(releaseProjectAction(acquired.state, owner), { + released: true, + state: { owner: null }, + errorCode: null, + }); +}); diff --git a/web/tests/unit/save-transaction.test.mjs b/web/tests/unit/save-transaction.test.mjs new file mode 100644 index 00000000..498e624c --- /dev/null +++ b/web/tests/unit/save-transaction.test.mjs @@ -0,0 +1,66 @@ +import assert from "node:assert/strict"; +import fs from "node:fs"; +import path from "node:path"; +import test from "node:test"; +import ts from "typescript"; + +const repoRoot = path.resolve(import.meta.dirname, "../../.."); +const sourcePath = path.join(repoRoot, "web/protocol/save-transaction.ts"); +const transpiled = ts.transpileModule(fs.readFileSync(sourcePath, "utf8"), { + compilerOptions: { module: ts.ModuleKind.ES2022, target: ts.ScriptTarget.ES2022 }, + fileName: sourcePath, + reportDiagnostics: true, +}); +assert.deepEqual(transpiled.diagnostics, []); +const moduleUrl = `data:text/javascript;base64,${Buffer.from(transpiled.outputText).toString("base64")}`; +const { + SAVE_ATTEMPT_STAGES, + advanceSaveTransaction, + beginSaveTransaction, + commitSaveTransaction, + createSaveTransactionState, + failSaveTransaction, +} = await import(moduleUrl); + +const oldCommit = { revision: 7, sha256: "a".repeat(64) }; +const newCommit = { revision: 8, sha256: "b".repeat(64) }; + +function stateAt(stage) { + let result = beginSaveTransaction(createSaveTransactionState(oldCommit), newCommit.revision); + assert.equal(result.ok, true); + for (const next of SAVE_ATTEMPT_STAGES.slice(1, SAVE_ATTEMPT_STAGES.indexOf(stage) + 1)) { + result = advanceSaveTransaction(result.state, next, next === "OPFS_STAGE" ? newCommit.sha256 : undefined); + assert.equal(result.ok, true); + } + return result.state; +} + +test("M7-05 preserves the old committed identity at every failed save stage", () => { + for (const stage of SAVE_ATTEMPT_STAGES) { + const failed = failSaveTransaction(stateAt(stage), `SAVE_${stage}_INTERRUPTED`); + assert.equal(failed.status, "FAILED"); + assert.equal(failed.stage, stage); + assert.deepEqual(failed.committed, oldCommit); + assert.equal(failed.candidate.revision, newCommit.revision); + } +}); + +test("M7-05 advances committed revision and hash only after matching metadata commit", () => { + const metadata = stateAt("METADATA_COMMIT"); + assert.deepEqual(commitSaveTransaction(metadata, { ...newCommit, sha256: "c".repeat(64) }), { + ok: false, + state: metadata, + errorCode: "SAVE_TRANSACTION_COMMIT_MISMATCH", + }); + const committed = commitSaveTransaction(metadata, newCommit); + assert.equal(committed.ok, true); + assert.deepEqual(committed.state.committed, newCommit); + assert.equal(committed.state.status, "SUCCEEDED"); +}); + +test("M7-05 rejects reentrant and out-of-order save transitions", () => { + const running = beginSaveTransaction(createSaveTransactionState(oldCommit), 8); + assert.equal(running.ok, true); + assert.equal(beginSaveTransaction(running.state, 9).errorCode, "SAVE_TRANSACTION_INVALID_TRANSITION"); + assert.equal(advanceSaveTransaction(running.state, "SCENE_COMMIT").errorCode, "SAVE_TRANSACTION_INVALID_TRANSITION"); +}); diff --git a/web/tests/unit/user-action-state.test.mjs b/web/tests/unit/user-action-state.test.mjs new file mode 100644 index 00000000..2cef058a --- /dev/null +++ b/web/tests/unit/user-action-state.test.mjs @@ -0,0 +1,93 @@ +import assert from "node:assert/strict"; +import fs from "node:fs"; +import path from "node:path"; +import test from "node:test"; +import ts from "typescript"; + +const repoRoot = path.resolve(import.meta.dirname, "../../.."); +const sourcePath = path.join(repoRoot, "web/protocol/user-action-state.ts"); +const transpiled = ts.transpileModule(fs.readFileSync(sourcePath, "utf8"), { + compilerOptions: { module: ts.ModuleKind.ES2022, target: ts.ScriptTarget.ES2022 }, + fileName: sourcePath, + reportDiagnostics: true, +}); +assert.deepEqual(transpiled.diagnostics, []); +const moduleUrl = `data:text/javascript;base64,${Buffer.from(transpiled.outputText).toString("base64")}`; +const { + USER_ACTION_KINDS, + createInitialUserActionStates, + reduceUserActionStates, + transitionUserAction, +} = await import(moduleUrl); + +function identity(kind, sequence = 1) { + return { kind, actionId: `${kind}:${sequence}` }; +} + +test("M7-01 initializes all five user actions at IDLE", () => { + const states = createInitialUserActionStates(); + assert.deepEqual(Object.keys(states), USER_ACTION_KINDS); + for (const kind of USER_ACTION_KINDS) { + assert.deepEqual(states[kind], { kind, status: "IDLE", identity: null, errorCode: null }); + } +}); + +test("M7-01 records deterministic RUNNING and SUCCEEDED transitions for every action", () => { + let states = createInitialUserActionStates(); + for (const kind of USER_ACTION_KINDS) { + const currentIdentity = identity(kind); + states = reduceUserActionStates(states, { type: "START", identity: currentIdentity }); + assert.deepEqual(states[kind], { kind, status: "RUNNING", identity: currentIdentity, errorCode: null }); + states = reduceUserActionStates(states, { type: "SUCCEED", identity: currentIdentity }); + assert.deepEqual(states[kind], { kind, status: "SUCCEEDED", identity: currentIdentity, errorCode: null }); + } +}); + +test("M7-01 records stable failure and cancellation codes", () => { + const failedIdentity = identity("OPEN"); + let failed = transitionUserAction(createInitialUserActionStates().OPEN, { type: "START", identity: failedIdentity }); + assert.equal(failed.ok, true); + failed = transitionUserAction(failed.state, { type: "FAIL", identity: failedIdentity, errorCode: "OPEN_ENGINE_FAILED" }); + assert.deepEqual(failed, { + ok: true, + state: { kind: "OPEN", status: "FAILED", identity: failedIdentity, errorCode: "OPEN_ENGINE_FAILED" }, + }); + + const cancelledIdentity = identity("IMPORT"); + let cancelled = transitionUserAction(createInitialUserActionStates().IMPORT, { type: "START", identity: cancelledIdentity }); + assert.equal(cancelled.ok, true); + cancelled = transitionUserAction(cancelled.state, { type: "CANCEL", identity: cancelledIdentity }); + assert.deepEqual(cancelled, { + ok: true, + state: { kind: "IMPORT", status: "CANCELLED", identity: cancelledIdentity, errorCode: "USER_ACTION_CANCELLED" }, + }); +}); + +test("M7-01 rejects wrong identities, reused identities and invalid transitions without mutation", () => { + const first = identity("SAVE"); + const other = identity("SAVE", 2); + const initial = createInitialUserActionStates().SAVE; + const beforeStart = transitionUserAction(initial, { type: "SUCCEED", identity: first }); + assert.deepEqual(beforeStart, { ok: false, state: initial, errorCode: "USER_ACTION_INVALID_TRANSITION" }); + + const running = transitionUserAction(initial, { type: "START", identity: first }); + assert.equal(running.ok, true); + assert.deepEqual(transitionUserAction(running.state, { type: "FAIL", identity: other, errorCode: "SAVE_FAILED" }), { + ok: false, + state: running.state, + errorCode: "USER_ACTION_IDENTITY_MISMATCH", + }); + assert.deepEqual(transitionUserAction(running.state, { type: "FAIL", identity: first, errorCode: "not-stable" }), { + ok: false, + state: running.state, + errorCode: "USER_ACTION_INVALID_ERROR_CODE", + }); + + const succeeded = transitionUserAction(running.state, { type: "SUCCEED", identity: first }); + assert.equal(succeeded.ok, true); + assert.deepEqual(transitionUserAction(succeeded.state, { type: "START", identity: first }), { + ok: false, + state: succeeded.state, + errorCode: "USER_ACTION_IDENTITY_REUSED", + }); +}); diff --git a/后续工作.txt b/后续工作.txt new file mode 100644 index 00000000..d3bdc981 --- /dev/null +++ b/后续工作.txt @@ -0,0 +1,216 @@ +Web Blender M6/M7 接续执行记录 +更新时间：2026-08-15（America/New_York） + +执行规则 +1. 本文件是当前接续入口；每轮先读本文件，再按“唯一下一领取点”直接执行。 +2. 严格按当前里程碑原子任务顺序推进，前一项未通过时不把后一项标为完成。 +3. 每完成一段，写回实际命令、结果、hash、当前计数和下一领取点。 +4. 不覆盖用户已有改动，不提交或改写 git 历史。 + +当前状态 +- M6 正式完成：71/71；剩余：0。 +- M7 正式完成：7/18；剩余：11。 +- 已完成到：M7-07。 +- 唯一下一领取点：M7-08（Worker 崩溃时展示可恢复错误，不清空当前项目列表）。 +- quick lane：READY，7/7 命令通过，总命令耗时 11,455 ms，报告 + release/ci-reports/quick.json。 +- Chromium lane：READY，9/9 命令通过；每个 browser server 使用独立动态端口，报告 + release/ci-reports/chromium.json，总命令耗时 41,003 ms。 +- release lane：READY，25/25 命令通过，总命令耗时 1,334,766 ms，报告 + release/ci-reports/release.json。 + +本轮新增并已验证 +- M6-09A-C：binary archive 解包到 mktemp 后由包内 deployment contract 启动；新浏览器 + context 阻断所有非 loopback 请求，manifest、WASM、CSS、3 个 Worker、字体和基础 UI 冷启动通过。 +- M6-10A-D：真实归档环境完成 OPFS open/edit/save、Worker 重建、离线恢复、继续 edit、 + undo/redo、revision 单调保存和 GLB 严格回读；stable object/data IDs 与 blend SHA-256 已核对。 +- M6-11A-C：binary archive 在独立目录校验 SHA256SUMS、合同、许可证、SBOM、manifest， + 23 个 manifest 文件通过；archive browser smoke 通过并清理 server/profile。 +- M6-12A-D：source archive 在另一个独立目录校验 18,173 个文件，无 pycache/dist/build 输出； + npm ci、typecheck、build 通过，14 个 production build 文件与 binary app 逐项一致。 +- M6-13A-C：确认 Gitea Actions、自托管 Debian 13 runner、Node 20.19.2、Playwright 1.62.1、 + Chromium 149/Chrome 150、Blender 5.2.0、Emscripten 3.1.69；quick cache 只绑定 lockfile/toolchain。 +- M6-14A-C：P0、main/Offscreen、network、device-loss、OOM、OPFS quota、malicious blend/archive + 共 9 个 Chromium lane 子命令通过，端口均动态分配并由 Playwright 清理。 +- M6-15A：full E2E 126/126、100k/1M/10M geometry、4K/8K texture、600 帧 simulation、 + 1M 帧 media、VDB native/server/OPFS/WebGPU/双视口/故障、49/49 acceptance、 + offline reproducibility 和 archive 复验共 19/19 通过。 +- full E2E 首次发现开发服务器错收集 archive-only spec；已将该 spec 限制到 + playwright.archive.config.ts，定向 M6-09 通过后完整 release lane 从头重跑通过。 +- M6-15B/C：release 仅由 main push 或 workflow_dispatch 触发；exit code 17 失败注入 + 只生成新 FAILED 报告，不复用旧 READY。 +- M6-16A-C：quick/Chromium/release 三报告联合校验通过，绑定同一 commit、 + lockfile、ledger、engine、archive 和每条日志 SHA-256，retention 固定为 7/14/30 天。 +- M6-17A：DEPLOYMENT.md 已补齐空目录安装和 transport preflight；自动门在 mktemp + 中校验交付 SHA-256、拒绝危险 tar 条目、安装到内容 hash 目录、原子建立 current， + 验证 HTTPS/127.0.0.1 READY 与 public HTTP/file BLOCKED，并从安装后目录验证合同头/range。 +- M6-17B：binary archive 新增 release-metadata.json，绑定 product/engine、IDB schema 6、 + OPFS schema 1、3 个 Worker 和缓存策略；双版本门验证 5->6 前向迁移、Worker 换代、 + 失败前置不改 current、成功原子切换、旧 release 保留和项目 SHA-256 不变。 +- M6-17C：回滚合同只原子切换 current 的整套 app/engine release；相同 IDB/OPFS schema + 旧版 READY，IDB 降级和 OPFS 逆迁移稳定 BLOCKED；新版目录、项目 bytes、revision 17 和 + blend SHA-256 全部保留。 +- M6-17D：operations-diagnostics.json 与 DEPLOYMENT.md 表格覆盖 MIME、range、isolation、 + hash、quota、Worker、GPU 七域，21 个信号唯一；检查、预期、恢复和数据安全边界 + 与 deployment contract 联合校验，诊断 JSON 已进入 binary archive。 +- M6-17E：operations rehearsal 在同一个全新 mktemp 根内连续执行 8/8 步骤： + delivery hash/path、空目录安装、deploy HTTP、项目写入、upgrade 切换/HTTP、rollback 切换/HTTP； + revision 23 与 blend SHA-256 不变，临时根已清理。 +- M6-18A：冻结 `0.1.0-rc.1`、engine `blender-wasm-0.1.0-rc.1` 和 HEAD + `17ab961485fe2ea1574c5f0b7d3ef9608a2bf424`；RC 生成器先稳定拒绝旧 `0.1.0` + metadata，再重建并两次复验确定性 binary/source archive。`RC_MANIFEST.json` 与 sidecar + 已绑定 package/package-lock、engine manifest、binary 内 release metadata/SBOM、ledger、 + `SHA256SUMS.txt`、3 个主要构件和 5 个 operations report；binary 25 文件、source 18,185 + 文件及 14 个重建产物独立复验通过。 +- M6-18B：新增 RC 发布说明，只列已通过的 P0、双 viewport、single/pthread、OPFS、 + 性能/故障、离线交付和 CI/运维能力；自动核对 12 个 V1 family `READY` 与 12 个 + Blender 全域 `BLOCKED`，7 个本地链接全部可解析。`V1_SCOPE.md` 和机器 ledger 已进入 + 离线包，binary manifest 复验 28 个文件通过。 +- M6-18C：已知限制明确 Chromium-only、HTTPS/loopback、AUTO/SINGLE/PTHREAD 选择、 + 初始化失败单次 fallback、hash fatal 和 release 刷新边界；记录 WASM 16 MiB 初始/2 GiB + ceiling、origin-bound storage/无最低 quota 保证、纹理 64 MiB/16,384 px/256 项，以及 + VDB/NanoVDB 512 MiB/1 GiB/512 MiB 上限与 adapter 可能更低。限制自动检查与 binary + 29 文件复验通过。 +- M6-18D：发布恢复手册覆盖 SHA256SUMS/RC manifest/归档/三 lane 证据校验、生产 + Save Project 的 OPFS commit + 外部 `.blend` 备份、revision/hash/origin 记录、切换前失败、 + 切换后兼容回滚、IDB/OPFS schema 稳定阻断及独立恢复 origin；文档检查、binary 30 文件 + 复验和全新临时根 operations rehearsal 8/8 再次通过。 +- M6-18E：quick 从首次 unit hardcoded version 的新 `FAILED` 报告定位并修正后完整重跑 + `READY 7/7`；Chromium `READY 9/9`；release 扩充 RC 文档、5 项 operations 和 manifest + 门后 `READY 25/25`。full E2E 126/126、49/49 acceptance、归档重建/浏览器/独立 source + rebuild 全部通过；三报告与 RC manifest 联合绑定同一 HEAD、package/lockfile、ledger、 + engine、SBOM、3 份发布文档和最终 archive hash，exit code 17 仍只生成新 `FAILED`。 +- M7-01：新增纯 `user-action-state` 合同，覆盖 IMPORT/OPEN/SAVE/SAVE_AS/EXPORT 和 + IDLE/RUNNING/SUCCEEDED/FAILED/CANCELLED；action identity、允许转换、身份/复用/错误码 + 拒绝均为确定性结果。生产 App 已在图片 Main transaction、blend open、OPFS commit、blend + download 和 GLB export 的真实边界记录状态；保存仍保持先原子提交再下载。unit 4/4、 + Chromium 正负例 2/2、typecheck 和 production build 全部通过。 +- M7-02：新增纯项目动作互斥合同，OPEN/SAVE/CLOSE 冲突矩阵完全对称且独占，冲突统一返回 + `USER_ACTION_CONFLICT`，并细分 REPEATED_OPEN、CONCURRENT_SAVE、CLOSE_DURING_SAVE。 + App 的 open、manual save、autosave 和 close 使用同一 owner lock；同一浏览器任务竞争验证第二次 + open 不替换首个 projectId、双 save 只提交/下载一次、save 中 close 不清空 scene 或终止 Worker， + 提交后继续 edit/save/close 正常。互斥 unit 4/4，联合 unit 8/8、新 Chromium 5/5、既有 + save/autosave 2/2、typecheck 和 build 全部通过。 +- M7-03：新增 `File.stream()` 分块 reader；每个实际 stream chunk 最多按 1 MiB 有界复制， + 进度来自累计真实字节/文件声明大小，每 4 MiB 让出一次 UI 并同步提交紧凑进度状态，不使用 + 时间插值。每次 open 有独立 AbortController，读入阶段提供取消按钮；取消稳定进入 + `CANCELLED/OPEN_CANCELLED`，不调用 WebEngine、不替换旧 scene/projectId。621,323-byte 有效 + blend 精确完成，40 MiB 合成输入在中间字节取消；reader unit 3/3，联合 unit 11/11、 + 新 Chromium 7/7、既有 save/autosave 2/2、typecheck 和 build 全部通过。 +- M7-04：reader 资源 ledger 在取消返回前执行 stream cancel/release、清零未完成 output，并证明 + live reader/input bytes/staging 全为 0。WebEngine open 改为隔离候选 WASM module/Main handle， + AbortSignal 通过 cancelOpen request 在 NATIVE_INITIALIZE/NATIVE_OPENED 阶段取消；只有构建 + SceneIR 成功才原子替换当前 Main，取消则释放 native input、销毁候选 handle，当前架构无 OPFS + import staging，计数恒为 0。native 取消后旧 Basic Main 继续 edit/save；联合 unit 11/11、 + 新 Chromium 8/8、既有 open/save/autosave/concurrent-open/isolated-preview 5/5、build 全部通过。 +- M7-05：新增纯 save transaction 合同，冻结 base committed revision/hash，SERIALIZE、OPFS_STAGE、 + SCENE_COMMIT、METADATA_COMMIT 任一失败均只更新 attempt；只有 Storage 返回的 revision/hash 与 + candidate 完全一致才推进 committed。已有基线项目在 after-stage、after-scene-commit、 + before-metadata-commit 故障中用同一原子 writer 回写旧 bytes 后抛错，Worker 重启后旧 + revision/hash/bytes 逐项不变；无基线 M6 journal 前滚仍通过。unit 14/14、新 Chromium 9/9、 + 旧 recovery/save/autosave/quota 4/4、build 全部通过。 +- M7-06：新增纯 dirty state，open/recover 建立 current/committed Main revision，只有成功 Main + transaction 推进 current，匹配 candidate 的成功 save 才对齐 committed；preview、workspace、 + 失败 import/open 保持原状态。删除手动 dirty toggle，旧 autosave 测试改用真实 Add Cube。 + unit 17/17、新 Chromium 10/10、真实 Main/save/autosave 3/3、build 全部通过。 +- M7-07：undo/redo 成功后序列化当前 Main 并与最近成功 save 的 blend SHA-256 比较；逻辑 + revision 始终单调增加，内容 hash 相同即 clean、不同即 dirty。save -> edit -> undo clean -> + redo dirty -> undo clean 的 Chromium 路径通过。联合 unit 18/18、Chromium 10/10、build 通过。 + +待完成任务（严格顺序） +- M7-08：Worker 崩溃时展示可恢复错误，不清空当前项目列表。 +- M7-09 至 M7-18：Worker/recent projects 恢复、 + 存储预算与清理、输入/响应式/双 viewport/键盘可访问性、诊断报告和 30 分钟 soak。 + +M6-15/M6-16 实际验证命令 +- BLENDER_BIN= BLENDER_ARCHIVE_SHA256=96f6c181...1c48 + CHROME_PATH= VDB_RESOURCE_ROOT= npm --prefix web run ci:release +- node tools/web/check-ci-report.mjs release/ci-reports/quick.json + release/ci-reports/chromium.json release/ci-reports/release.json +- npm --prefix web run test:ci-failure-report + +M7-01 实际验证 +- `npm --prefix web run typecheck`：通过。 +- `WEB_TEST_PORT=5194 npm --prefix web run test:user-actions`：unit 4/4、Chromium 2/2 通过。 +- `npm --prefix web run build`：通过，55 modules transformed。 +- `git diff --check -- web/protocol/user-action-state.ts web/tests/unit/user-action-state.test.mjs + web/tests/e2e/user-action-state.spec.ts web/app/src/app/App.tsx web/package.json`：通过。 +- `user-action-state.ts` SHA-256：232257fb0e85a6827d71a1acbbf82477ba8c441c224cf994049bde96943c518e。 +- unit/Chromium spec SHA-256：88ace5b65a5bee44d4ab417ea2144391d461117e848b1446da86b1cf0b21e237 / + 9ecb1e63f58c25dc64e0f8738b272b45529212469c9ea2ca660b68d4f0e7b566。 + +M7-02 实际验证 +- `npm --prefix web run typecheck`：通过。 +- `WEB_TEST_PORT=5196 npm --prefix web run test:user-actions`：联合 unit 8/8、Chromium 5/5 通过。 +- `WEB_TEST_PORT=5197 npx --prefix web playwright test --config web/playwright.config.ts + web/tests/e2e/smoke.spec.ts -g "saves the opened blend|autosaves a dirty project"`：2/2 通过。 +- `npm --prefix web run build`：通过，56 modules transformed。 +- `project-action-mutex.ts` SHA-256：330da0a7253f9bda9f7b43f5df4a252596fe43723c489308b1e0cbb6311aefd4。 +- unit/Chromium spec SHA-256：92af891ddbb54c54c2717a8e8d4466678de2cb7117f413f431a2e32fa2446f0c / + 0eb8f7c40dab623762d04e485348fbdaa68e9782010199e5d1b888f9475d6896。 + +M7-03 实际验证 +- `npm --prefix web run typecheck`：通过。 +- `WEB_TEST_PORT=5206 npm --prefix web run test:user-actions`：联合 unit 11/11、Chromium 7/7 通过。 +- `WEB_TEST_PORT=5207 npx playwright test --config web/playwright.config.ts web/tests/e2e/smoke.spec.ts + -g "saves the opened blend|autosaves a dirty project"`：2/2 通过。 +- `npm --prefix web run build`：通过，57 modules transformed。 +- `file-byte-reader.ts` SHA-256：3472e2a8cc01b6a78dda85d90a0a6f106ee3c0ad0e3c598bd3f6a7cbca14b536。 +- unit/Chromium spec SHA-256：1e86e6f553cafcd2a890eab76f090ba2eb249c21fced88b6f82db80162254bc8 / + 78608c721e5bd66570ae73b13c9c4531fc7d555b226c194188e73cddcde6b370。 + +M7-04 实际验证 +- `npm --prefix web run typecheck`：通过。 +- `WEB_TEST_PORT=5210 npm --prefix web run test:user-actions`：联合 unit 11/11、Chromium 8/8 通过。 +- `WEB_TEST_PORT=5211 npx playwright test --config web/playwright.config.ts web/tests/e2e/smoke.spec.ts + -g "opens a local .blend|serializes concurrent WebEngine init|previews Decimate|saves the opened blend|autosaves"`：5/5 通过。 +- `npm --prefix web run build`：通过，57 modules transformed。 +- WebEngineClient/Worker SHA-256：1e2cac9f9a9ebfb068cb8a7cfeab5100d9534600dcdd703a12d68614940a28e5 / + 331c7854ea75e2def1bf503118c670908d39ce9ede9c5deb5a4432812172582b。 +- Chromium spec SHA-256：467d50dadce0f2b1d8da090fcc9383c642d3fd9fa19d19b53833340d418490a6。 + +M7-05 实际验证 +- `npm --prefix web run typecheck`：通过。 +- `WEB_TEST_PORT=5214 npm --prefix web run test:user-actions`：联合 unit 14/14、Chromium 9/9 通过。 +- `WEB_TEST_PORT=5215 npx playwright test --config web/playwright.config.ts web/tests/e2e/smoke.spec.ts + -g "recovers verified atomic saves|quota exhaustion|saves the opened blend|autosaves"`：4/4 通过。 +- `npm --prefix web run build`：通过，58 modules transformed。 +- save transaction/StorageWorker SHA-256：9c6d932d6d2ce308ae8fbc56ee56296f1b67bd22e76b90a69751813f174bc766 / + bfde02b78850beb510c7a92fcefb6b3b9f5d2ef4bef09027a7fdc6f737181789。 +- unit/Chromium spec SHA-256：99fde5eb7152e1fe0df8702660724f8457a6423fb1d731f92758670b531cfd96 / + e453f817b3bae19ddf18c57c4429743e7157d083ab9ebf2e8e523bc6301d226d。 + +M7-06 实际验证 +- `npm --prefix web run typecheck`：通过。 +- `WEB_TEST_PORT=5217 npm --prefix web run test:user-actions`：联合 unit 17/17、Chromium 10/10 通过。 +- `WEB_TEST_PORT=5218 npx playwright test --config web/playwright.config.ts web/tests/e2e/smoke.spec.ts + -g "Main-authoritative|saves the opened blend|autosaves a dirty project"`：3/3 通过。 +- `npm --prefix web run build`：通过，59 modules transformed。 +- dirty contract/unit/Chromium SHA-256：283d08dd92e7f7afc13ba004982160d23369a42ea487c77c7fc6de803f4c00e7 / + ab71114adb58fec8387ff8b8ca0a1729681a57e370a995c0ee7e71eeabc3baf2 / + 9980065a202b97975d299ef93312c442f4bc69b8840e899e89b1f802d13967e7。 + +M7-07 实际验证 +- `npm --prefix web run typecheck`：通过。 +- `WEB_TEST_PORT=5220 npm --prefix web run test:user-actions`：联合 unit 18/18、Chromium 10/10 通过。 +- `npm --prefix web run build`：通过，59 modules transformed。 +- dirty contract/unit/Chromium SHA-256：ee1a04a6f43a4c5504657f318249c9c2e27abe47647cef64237b94ba2e56f1ea / + 1e5c6ddeb29ca110b90a01f40a8ceca26e18d7787455dd13aeb8a0da76adb602 / + 9b884c1e975b4ae4b55f6bc80ed191444790d75eccb09718863f24a54fd4aa18。 + +M7-08 立即执行 +- WebEngine/Storage Worker error 统一映射为 recoverable worker fault，不在 error callback 中清空 snapshot、 + recent project 或 committed/dirty identity；所有 pending request 只结算一次。 +- 提供显式“重启并恢复”入口，先重建 Worker，再从当前项目 OPFS commit + operation log 恢复。 +- 添加 Worker 崩溃注入，验证可恢复短错误、项目列表/当前 UI 保留和恢复成功；完成后推进 M7-09。 + +关键当前构件 +- binary archive SHA-256：8af6c782b8e4b31020219597b821160b7634439749c455fd31d9d919676e2e2e +- source archive SHA-256：ee09b3e43e715b3d5497573bbf63a449cbea146150d56c08c6506afd5fce2871 +- SBOM SHA-256：7d0fb22790c44bada5f01e5ebc12f6050e1c0436a53f58dceb2e979c17bb593a +- RC manifest SHA-256：862d332b3c931cb5c0898bb7f66e02f0dd4562053b18d0c87a7cea390ebaacdf +- M6-17E rehearsal report SHA-256：b953dd89165b5dd9260d75c7ec6e982a69cfeea358fbc2ce35c75e99544cac2c +- quick/Chromium/release report SHA-256：dcaa32be911fa7ed36127b5cb1458bb07dcca19d562cabc64e022f13b094f911 / + 90b19d057957f1edce264c7137f89d6701643e46feb88001054eea1bf0a18eb5 / + 7d28a5018b78ba45935f832388d6b4e632c6198476a2fdcb4a0abef3066c5ec6 +- HEAD commit：17ab961485fe2ea1574c5f0b7d3ef9608a2bf424