Advance Blender 5.2 web parity through M12-03D

docs/status/N-023.md

@@ -3,6 +3,97 @@
 状态：`BLOCKED`（asset catalog、来源/许可证元数据、真实 Main library inventory、库依赖与
 IO 安全门已落地；Append/Link/Override Main、非 GLB 本地导入和跨桌面重导入未实现）
 
+## 完整对标盘点基线
+
+M12-01A 已从 Blender 5.2 DNA、RNA、Blend IO、AssetCatalog/CDF 源码及真实 RNA runtime 盘点
+14 个 `AssetMetaData` DNA 字段、10 个公开 RNA 属性、3 个 `AssetTag` 存储字段和 3 个 catalog
+持久语义字段。M12-01B 随后用锁定 Blender 5.2 生成 3 条 CDF v1 catalog、Object/Material/World
+资产和 canonical JSON，并由独立 Blender 新进程精确重开复验。M12-01C 以 Blender UUID/path
+和 AssetWeakReference 定义 Web schema v2 stable identity，并冻结 UTF-8 文本及条目预算。三项均为
+`enablingTask`。M12-01D 又完成 v1→v2 无损前向迁移，保留 revision、source、preview 与 library
+graph，并输出确定性 ID mapping/hash report。四项只冻结完整对标输入与迁移，不增加本节已验证
+slice。M12-01E 又固定 v2 对 v1 reader 的 read-only/write-block/future-reject 策略。五项仍不改变
+`parityStatus=BLOCKED`。
+
+M12-01F 已补齐 duplicate catalog/asset ID、legacy parent cycle、v2 parentPath drift、UTF-8
+simple-name/tag budget 和 v1/v2 unknown-field 共 9 类稳定负例；该 enabling evidence 不改变 slice。
+
+M12-01G 已让 v1→v2 IndexedDB index migration 在同一 readwrite transaction 中提交 target、
+receipt 和 source delete；写 target 后或删 source 后注入失败均 abort，关闭并重开后旧 v1 index、
+无关 migration 行和数据库版本精确不变。该 enabling evidence 仍不改变 slice。
+
+M12-01H 又证明初始页面、reload 和两个顺序重建的独立 Worker 读取相同 catalog/asset 顺序、
+AssetWeakReference stable identity、revision 和 manifest SHA-256；receipt/hash drift 在发布前阻断。
+该 enabling evidence 仍不改变 slice。
+
+M12-01I 将 A-H 八项任务链、Blender 5.2 desktop fixture、Web v2 fixture、production migration
+report、canonical 双 hash 和 IndexedDB fault/restart artifact 递归绑定为一个 READY evidence。
+M12.1 schema/migration 已收口，但仍是 enabling evidence，不把 catalog mutation/preview 计为完成。
+
+M12-02A 已盘点 PreviewImage 的 ICON/PREVIEW 双槽、持久尺寸/rect/flag、RGBA8 packed pixel、
+premultiplied alpha、runtime deferred/invalid 状态和真正的 null pointer。原生结构/RNA 没有颜色空间
+字段；现有 Web v1/v2 也缺 slot/colorSpace/alpha/generator 语义。本项仍是 inventory evidence。
+
+M12-02B 定义 source/content 各自的 byte length、MIME、SHA-256，并让 content 绑定尺寸、RGBA8、
+sRGB/alpha profile，generator 绑定 Blender version/executable/script/settings。真实 Blender 两次重编码
+确定性相同，source/content 编码不同但解码像素 exact；本项仍是 enabling identity evidence。
+
+M12-02C 在任何图像 decoder 或 decoded allocation 前依次检查 identity、16 MiB encoded bytes、
+content SHA-256、PNG/WebP header、identity-bound dimensions、16,777,216 pixels、64 MiB RGBA8
+decoded bytes 和 100:1 compression ratio。8 类失败均 fail-closed，随后小 preview 可立即恢复；
+本项仍是 enabling budget evidence，不把 preview storage/display 计为完成。
+
+M12-02D 先把 content-addressed preview 写入 OPFS 并回读复验，再用一次 revision/full-row guarded
+IndexedDB transaction 提交 catalog v2 preview reference 和 hash receipt。OPFS 前后及 catalog put
+后的三处 fault 都保持旧 catalog；重开后 revision、receipt 和 payload hash 一致。本项仍不把
+dedupe、损坏隔离或 viewport display 计为完成。
+
+M12-02E 又让两个不同 Blender weak-reference identity 和不同 metadata 的 asset 共享相同 content
+SHA-256；第二次写入只复验并复用 OPFS payload，物理文件计数为 1，两个 catalog entry 的完整
+non-preview metadata 不变，revision 9 重开一致。本项仍不把损坏隔离或 display 计为完成。
+
+M12-02F 将同长度但 SHA-256 漂移的 bytes 从 content-addressed namespace 移入复验后的 quarantine
+文件，并写入与 catalog revision/reference 绑定的 receipt。catalog 本身及另一 asset 均不变；重开后
+仍可读取完整 metadata，只把 preview/data 返回 null。本项仍不把 reference GC/display 计为完成。
+
+M12-02G 在 catalog reference transaction 完成后按 committed manifest 计数：同项目仍有一个引用时
+保留 payload，最后一个引用删除后才回收。OPFS project namespace 保证另一项目的同 hash payload
+和 READY preview 不受影响；revision 11 重开 metadata 不变。本项仍不把 display 计为完成。
+
+M12-02H 已把 Blender 5.2 确定性重编码的 `SRGB/RGBA8/STRAIGHT` preview 固定为逐字节 reference，
+主线程 `HTMLCanvasElement` 与独立 Worker `OffscreenCanvas` 共用生产 decode/display 实现。两条路径
+均先通过 M12-02C 的 identity/header/预算门，再以禁用色彩转换和预乘的 `ImageBitmap` 解码；输出
+256-byte RGBA8 hash 与 desktop reference 完全一致，MAE/RMS/P95/max/bad-pixel/alpha 指标均为零，
+前景 IoU 为 1。该项新增一个已验证 preview display parity slice，但不扩大到任意尺寸、色彩空间、
+asset browser UI 或 Append/Link/Override。
+
+M12-03A 已分别冻结 Append、Link 与 Library Override 的数据块/闭包边界。真实 Blender runtime
+公开 36 类 selectable root，其中 Screen/WorkSpace 为 append-only；Library 是来源/传递依赖元数据，
+Key 等 embedded ID 随 owner 进入闭包。Append 由实际 ID pointer graph 区分 direct、indirect、
+cross-library、override dependency 与 reusable local；Link 保留 `ID.lib`、EXTERN/INDIRECT 和
+`Library.runtime.parent`；Override 另记录 linked reference、local owner、hierarchy root、property/
+operation 与 system dependency。该 inventory 仍不创建 ownership contract 或 Main transaction。
+
+M12-03B 已定义 schema 1 library operation identity。`sourceLibraryId` 同时绑定 canonical source
+locator 与 `.blend` SHA-256；APPEND 只能由 `LOCAL_MAIN` owner 持有且可写，LINK 只能由匹配的
+`SOURCE_LIBRARY` owner 持有且 root/reference 均只读，LIBRARY_OVERRIDE 由 `LOCAL_OVERRIDE`
+持有、local 可写但 linked reference 只读。invalidation token 还绑定 operation、root、owner、
+source generation/revision 与 dependency-closure hash；任一漂移稳定返回 `REVISION_CONFLICT`。
+
+M12-03C 已生成真实 Blender 5.2 desktop 单 Object append fixture。选中的 Object 自动带入 Mesh、
+Material 和 packed Image 依赖，四个 ID 在 target Main 中均无 source library/override 指针并映射为
+可写 `LOCAL_MAIN` owner。新 Blender load 路径重开 target 后，3 条依赖边、4/4/1 geometry、UVMap、
+material slot、2x2 sRGB RGBA image 和 Float32 pixel SHA-256 均与 source canonical report 一致。
+本项只冻结 desktop 权威 fixture，不提前声明 WASM Main append、undo/redo 或完整 append parity。
+该合同没有提前执行 Append 或开放 writer。
+
+M12-03D 已把同一 source-hash-bound closure 送入 WASM Worker 的 authoritative Blender Main。Native
+link/append context 递归导入 Object、Mesh、Material 和 packed Image，Main commit 前核对 source
+locator、root、closure 与 base revision；四个 ID 均无 `ID.lib`/override、映射为可写 `LOCAL_MAIN`，
+并只产生一个新的 SceneIR revision。stale revision 与 local ID collision 在 Main mutation 前阻断，
+失败路径回滚完整 history state。该项只证明单 transaction Main append，undo/redo/save/reopen 与
+desktop canonical report 的联合一致性仍由 M12-03E 验证。
+
 ## 已验证切片
 
 1. N-023-A：版本化 manifest 覆盖 catalog、asset kind/tag、preview、author、license、
@@ -29,11 +120,13 @@ IO 安全门已落地；Append/Link/Override Main、非 GLB 本地导入和跨
    已完成；大 bundle 性能仍未实现。
 9. VDB 独立资源库包含 generated/official/source/derived/report/manifest/license，14 条记录逐项绑定
    byte length 与 SHA-256；官方 sphere 使用 CC-BY-4.0 和 Git LFS 权威 hash，未放入仓库工作树。
+10. N-023-A（preview display）：Blender 5.2 desktop RGBA8 reference、主线程 Canvas2D 与
+    OffscreenCanvas 的像素 SHA-256 精确一致；错误像素返回 `RENDER_REFERENCE_MISMATCH`。
 
 ## 仍然阻断
 
-- N-023-B：Append/Link/Library Override、reload/relocate 和真实 Main transaction；只读 library
-  inventory 已完成。
+- N-023-B：Append undo/redo/save/reopen、Link/Library Override、reload/relocate 和完整真实 Main
+  parity；M12-03D 的单 transaction append 已有独立证据，但不解除本项阻断。
 - N-023-C/D：GLTF/OBJ/PLY/STL、USD/Alembic import/export/save/reopen/desktop reimport。
 - N-023-E：真实 zip decoder/fuzz、OPFS quota/recovery、license/source offer 发布审计和大文件
   流式性能；archive 路径冲突、双向字节预算与确定性 range plan 已完成。
@@ -44,6 +137,23 @@ IO 安全门已落地；Append/Link/Override Main、非 GLB 本地导入和跨
 ```bash
 WEB_TEST_PORT=5323 npm --prefix web run test:e2e -- --grep "N-023 asset"
 npm --prefix web run test:library-main-reader
+npm --prefix web run test:asset-catalog-inventory
+npm --prefix web run test:asset-catalog-v1-fixture
+npm --prefix web run test:asset-catalog-v2
+npm --prefix web run test:asset-catalog-migration
+npm --prefix web run test:asset-catalog-legacy-reader
+npm --prefix web run test:asset-catalog-negatives
+npm --prefix web run test:asset-preview-inventory
+npm --prefix web run test:asset-preview-identity
+npm --prefix web run test:asset-preview-decode-budget
+npm --prefix web run test:asset-preview-opfs-commit
+npm --prefix web run test:asset-preview-dedup
+npm --prefix web run test:asset-preview-quarantine
+npm --prefix web run test:asset-preview-reference-gc
+npm --prefix web run test:asset-preview-display
+npm --prefix web run test:library-operation-inventory
+npm --prefix web run test:library-operation-identity
+npm --prefix web run test:library-main-append
 npm --prefix web run test:vdb
 npm --prefix web run test:vdb-native
 ```